Stratara.EventSourcing.WorkerDefaults
3.1.2
See the version list below for details.
dotnet add package Stratara.EventSourcing.WorkerDefaults --version 3.1.2
NuGet\Install-Package Stratara.EventSourcing.WorkerDefaults -Version 3.1.2
<PackageReference Include="Stratara.EventSourcing.WorkerDefaults" Version="3.1.2" />
<PackageVersion Include="Stratara.EventSourcing.WorkerDefaults" Version="3.1.2" />
<PackageReference Include="Stratara.EventSourcing.WorkerDefaults" />
paket add Stratara.EventSourcing.WorkerDefaults --version 3.1.2
#r "nuget: Stratara.EventSourcing.WorkerDefaults, 3.1.2"
#:package Stratara.EventSourcing.WorkerDefaults@3.1.2
#addin nuget:?package=Stratara.EventSourcing.WorkerDefaults&version=3.1.2
#tool nuget:?package=Stratara.EventSourcing.WorkerDefaults&version=3.1.2
Stratara.EventSourcing.WorkerDefaults
License: FSL-1.1-MIT (Functional Source License — source-available; converts to MIT after 2 years). Not OSI-approved OSS.
One-stop IHostApplicationBuilder composites that wire together the Stratara event-sourced stack for each host shape (API, command worker, event-projection worker, saga worker, event-stream-hash worker, outbox worker). Reference this package from each host instead of repeating the per-concern DI call chain.
What's in the box
| Composite | Wires |
|---|---|
AddBackendServices |
Common framework services (messaging, identity, session, security, mapping, resilience) + mediator + write store + outbox dispatcher. For API hosts that dispatch commands but don't process them. |
AddCommandWorkerServices |
Common + mediator + mediator-worker (hosted service that consumes the command topic into the in-process mediator) + write store + event sourcing + outbox dispatcher. |
AddEventProjectionWorkerServices |
Common + write store + projection-replay state + projection worker. |
AddSagaWorkerServices |
Common + write store + event sourcing + outbox dispatcher + saga worker. |
AddEventStreamHashWorkerServices |
Common + write store + event-stream-hashing worker. |
AddOutboxWorkerServices |
Common + write store + outbox dispatcher + outbox-retry worker. |
The composites live in the Microsoft.Extensions.Hosting namespace so call sites read naturally:
// Command-handling worker host:
builder.AddCommandWorkerServices();
// API host that only dispatches commands:
builder.AddBackendServices();
Dependencies
This package pulls the framework's Tier-C pieces (Stratara.Infrastructure, Stratara.Outbox.RabbitMQ, Stratara.Projections, Stratara.Sagas, Stratara.EventSourcing.EntityFrameworkCore) so a single PackageReference is enough for a worker host. The lean Stratara.ServiceDefaults (OTel + Serilog) and Stratara.ServiceDefaults.AspNetCore (health-check endpoints + ASP.NET OTel) stay separate so non-worker hosts don't drag the Tier-C runtime in.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. 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. |
-
net10.0
- Stratara.EventSourcing.EntityFrameworkCore (>= 3.1.2)
- Stratara.Infrastructure (>= 3.1.2)
- Stratara.Outbox.RabbitMQ (>= 3.1.2)
- Stratara.Projections (>= 3.1.2)
- Stratara.Sagas (>= 3.1.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
### Added
- **New package `Stratara.Testing`** — test doubles and assertion helpers so consumers can
unit-test Stratara-based code without Postgres or RabbitMQ testcontainers. Reference it from
test projects only.
- `AggregateTestHarness<T>` + `Aggregate.Rehydrate<T>(...)` — given/when/then rehydration of an
aggregate from events using the same reflection-based `Apply(...)` dispatch as the production
aggregation service. It throws on an event with no matching `Apply` overload so a forgotten or
mistyped overload fails the test; opt back into the production-lenient skip with
`IgnoringUnmappedEvents()`.
- `InMemoryKeyStore` — an `IKeyStore` that mints random 256-bit DEKs per `KeyScope` and supports
rotation / revocation / scope-erasure without a master KEK or key file.
- `TestBlobEncryptor.CreateAesGcm()` — the real AES-GCM `ISecureBlobEncryptor` over an
`InMemoryKeyStore`, so blob round-trips exercise production encryption.
- `InMemoryMessageBus` — an `IMessageBus` with synchronous in-process dispatch and a `Published`
list for assertions.
- `TestSessionContext` / `TestSessionContextProvider` — preset Actor/Subject `SessionContext`
values and an `ISessionContextProvider` double.
- `TestTenants.Of("acme")` — stable, deterministic tenant/user ids from readable slugs.
`TestSessionContext` sets both correlation and causation ids so the context can drive
event-store writes.
- `TestEvent.Create(payload, ...)` — wrap an event payload in `IEvent<T>` with realistic
metadata; `ProjectionTester.HandleAsync(projection, event)` — invoke a projection's private
`HandleAsync` handler directly to unit-test it against mocked repositories.
- **New package `Stratara.Testing.EntityFrameworkCore`** — spins up the **real** event-sourcing
write stack (`IEventSource`, `IAggregationService`, snapshots, the EF Core write store) against a
shared in-memory SQLite database in one call, so tests exercise production code paths without
Postgres or Docker. Reference it from test projects only.
- `EventStoreTestHost.Create(...)` — owns the SQLite connection + service provider; exposes
`ExecuteAsync(IEventSource)`, `AggregateAsync<T>(streamId)`, the preset `Session`, and the
recording `Outbox`.
- `AddStrataraTestingEventStore<TWriteDbContext>(connection, tenantId)` — the lower-level DI
extension; `StrataraTestWriteDbContext` — a ready-made concrete write context;
`RecordingEventBundleOutboxDispatcher` — captures emitted bundles for assertions.
- The lockstep family grows from 22 to 24 packable packages.