Stratara.EventSourcing.WorkerDefaults
3.2.1
dotnet add package Stratara.EventSourcing.WorkerDefaults --version 3.2.1
NuGet\Install-Package Stratara.EventSourcing.WorkerDefaults -Version 3.2.1
<PackageReference Include="Stratara.EventSourcing.WorkerDefaults" Version="3.2.1" />
<PackageVersion Include="Stratara.EventSourcing.WorkerDefaults" Version="3.2.1" />
<PackageReference Include="Stratara.EventSourcing.WorkerDefaults" />
paket add Stratara.EventSourcing.WorkerDefaults --version 3.2.1
#r "nuget: Stratara.EventSourcing.WorkerDefaults, 3.2.1"
#:package Stratara.EventSourcing.WorkerDefaults@3.2.1
#addin nuget:?package=Stratara.EventSourcing.WorkerDefaults&version=3.2.1
#tool nuget:?package=Stratara.EventSourcing.WorkerDefaults&version=3.2.1
Stratara.EventSourcing.WorkerDefaults
License: MIT.
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.2.1)
- Stratara.Infrastructure (>= 3.2.1)
- Stratara.Outbox.RabbitMQ (>= 3.2.1)
- Stratara.Projections (>= 3.2.1)
- Stratara.Sagas (>= 3.2.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
### Fixed
- **Snapshot loads are now scoped to the aggregate type.** The snapshot read previously filtered
only by stream id, so when two aggregate types shared a stream id, rehydrating one type could
pick up the other type's (higher-versioned) snapshot and deserialize it into the requested type —
silently returning an aggregate with default/empty fields. Snapshot reads now match the aggregate
type (version-independently, so an assembly rev-bump does not invalidate existing snapshots), and
snapshot writes are grouped per `(stream, aggregate type)` so a stream carrying more than one type
snapshots each type independently. A snapshot of type X may now only ever rehydrate type X.
### Changed
- **`ISnapshotRepository` gained type-scoped read overloads.** `GetAsync(streamId,
aggregateTypeName, toVersion, ct)` and `GetLatestVersionOrDefaultAsync(streamId,
aggregateTypeName, ct)` are the correct lookups; the previous type-less overloads are now
`[Obsolete]` because they can return a foreign aggregate type's snapshot on a shared stream.
Custom `ISnapshotRepository` implementers should add the new overloads.