WJb 0.30.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package WJb --version 0.30.0
                    


                    

                
NuGet\Install-Package WJb -Version 0.30.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="WJb" Version="0.30.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="WJb" Version="0.30.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="WJb" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add WJb --version 0.30.0
                    


                    

                
#r "nuget: WJb, 0.30.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package WJb@0.30.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=WJb&version=0.30.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=WJb&version=0.30.0
                    


                            Install as a Cake Tool

WJb — Background Job Architecture for .NET

NuGet

Overview

WJb is a lightweight, deterministic background job execution library for .NET.

It provides a minimal execution core for applications where background processing is part of explicit domain logic, not an infrastructural side effect.

WJb prioritizes explicit execution, predictable behavior, and long‑term API stability over convenience features or implicit orchestration.

Scope of the Base Edition

This package represents the Base (free) edition of WJb.

It is intentionally limited to job execution primitives and does not include advanced runtime features available in the commercial edition.

The Base edition is suitable for:

  • Open‑source projects
  • Learning and evaluation
  • Small or embedded workers
  • Deterministic background execution

Key Characteristics

  • Explicit job payloads (no ambient state)
  • Queue‑first execution model
  • Deterministic, single‑step processing
  • Immutable action metadata snapshots
  • Explicit workflow routing
  • Stable, contract‑based public API

Base vs Commercial Comparison

Area WJb Base WJb Commercial (WJb.Pro)
Product name WJb WJb
Package WJb WJb.Pro
License Apache License 2.0 WJb — Commercial Capability License (Solo / Team)
Intended use Open‑source, learning, evaluation Commercial, SaaS, production, closed‑source
Job execution ✅ Explicit, deterministic ✅ Explicit, deterministic
Job payloads ✅ JSON, explicit ✅ JSON, explicit
Execution model ✅ Queue‑first ✅ Queue‑first
Action model ✅ IAction, explicit routing ✅ Same, extended capabilities
Workflow routing ✅ Explicit (IWorkflowAction) ✅ Same, plus extensions
Scheduling (cron) ✅ Basic ✅ Extended
Settings registry ❌ Not available ✅ Available
Runtime reload ❌ Not supported ✅ Supported
Persistence ❌ In‑memory only ✅ Optional implementations
Delivery guarantees ❌ None ✅ Optional / configurable
Advanced orchestration ❌ Not provided ✅ Available
Production hardening features ❌ Minimal ✅ Included
Author support ❌ Community only ✅ Direct author support
Commercial redistribution ❌ Not permitted ✅ Permitted under license

Notes

  • WJb Base is intentionally minimal and deterministic.
    If a feature is not listed, it does not exist.
  • WJb.Pro does not change the execution philosophy — it extends it.
  • Both editions share the same core concepts and API shape.
  • Migration from Base to Commercial does not require rewriting domain logic.

Design Philosophy

WJb is built around a small set of strict principles:

  • Actions control their own execution lifecycle
  • Routing is explicit and action‑owned
  • Infrastructure executes — domain logic orchestrates
  • Metadata is configuration, not state
  • Nothing happens implicitly

If a job runs, it was explicitly enqueued.
If a workflow continues, an action explicitly decided so.

What WJb Is Not

WJb intentionally does not provide:

  • Automatic retries
  • Background pipelines
  • Implicit chaining
  • Distributed locks
  • Persistence guarantees
  • Workflow engines
  • Runtime reload or mutation
  • Settings registry (Base edition)

These omissions are deliberate design decisions.

Documentation

  • Architecture & execution model
    → README.architecture.md

  • Design decisions & trade‑offs
    → README.design.md

  • Commercial edition & licensing
    → README.commercial.md

  • About the author
    → README.author.md

Status

  • Target framework: .NET 8+
  • API contract version: v0.30
  • Edition: Base
  • Commercial edition: WJb.Pro

Licensing

The Base edition of WJb is available under the Apache License 2.0.

Commercial, SaaS, and closed‑source usage requires a separate commercial license available as WJb.Pro.

See README.commercial.md for details.

Philosophy in One Sentence

WJb treats background execution as explicit domain code — predictable, traceable, and debuggable.

❤️ Support

If this project helps you, you can support its development:
👉 https://ko-fi.com/ukrguru

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.30.0 11,372 5/4/2026
Loading failed