WJb 1.0.0

⚡ WJb

If you can't explain why a job runs, you don't control your system.

Most background job systems eventually become:

Job
 ↓
Retry
 ↓
Pipeline
 ↓
Middleware
 ↓
???

Then somebody asks:

• Why did this run?
• Why was it retried?
• Who scheduled the next step?
• Where is that logic?

And nobody can answer in 30 seconds.

WJb

WJb is an explicit workflow and background job engine for .NET.

Job
 ↓
Action
 ↓
IActionResult
 ↓
JobCommand

Every step is visible.

Every transition is explicit.

Every workflow is defined in code.

Simple by Default

Most job systems expose job states.

WJb exposes execution flow.

Enqueue
 ↓
Dequeue
 ↓
Complete

The action decides what happens next.

The store records what happened.

Example

public sealed class SendEmailAction : JobAction<EmailInput>
{
    public override Task<IActionResult> ExecuteAsync(
        EmailInput input, CancellationToken ct)
    {
        return NextAsync<LogAction>(
            new LogInput
            {
                Message = $"Email sent to {input.To}"
            });
    }
}

public sealed class LogAction : JobAction<LogInput>
{
    public override Task<IActionResult> ExecuteAsync(
        LogInput input, CancellationToken ct)
    {
        Console.WriteLine(input.Message);

        return CompleteAsync();
    }
}

Action Results

return CompleteAsync();

Complete the current job.

return CompleteAsync(customer);

Complete the current job and persist a result.

return NextAsync<SendEmailAction>(
    new EmailInput
    {
        To = "john@example.com"
    });

Schedule the next workflow step.

Failures are represented by exceptions:

throw new InvalidOperationException(
    "SMTP server unavailable.");

Mental Model

Action      = Business Logic

Results     = Outcome

JobCommand  = Next Step

Executor    = Runner

Store       = Persistence

That's it.

Packages

Use WJb If

You want to answer all of these immediately:

• Why did this job run?
• What did it do?
• What will run next?
• Why was it retried?
• When did it start?
• When did it finish?

📃 License

WJb Non-Commercial License

WJb is free for personal, educational, evaluation, research, and other non-commercial use.

Commercial use requires a valid WJb Commercial License.

A commercial license grants perpetual rights to use the licensed version of WJb and includes all commercial WJb store packages.

See the included LICENSE file for complete licensing terms.

For licensing information:

👉 https://wjb.pro/pricing

☕ Support WJb

If WJb helps your projects:

👉 https://ko-fi.com/ukrguru

Background jobs should be explicit.

If a workflow exists, you should be able to read it.