Stratara.Shared
3.1.5
See the version list below for details.
dotnet add package Stratara.Shared --version 3.1.5
NuGet\Install-Package Stratara.Shared -Version 3.1.5
<PackageReference Include="Stratara.Shared" Version="3.1.5" />
<PackageVersion Include="Stratara.Shared" Version="3.1.5" />
<PackageReference Include="Stratara.Shared" />
paket add Stratara.Shared --version 3.1.5
#r "nuget: Stratara.Shared, 3.1.5"
#:package Stratara.Shared@3.1.5
#addin nuget:?package=Stratara.Shared&version=3.1.5
#tool nuget:?package=Stratara.Shared&version=3.1.5
Stratara.Shared
License: FSL-1.1-MIT (Functional Source License — source-available; converts to MIT after 2 years). Not OSI-approved OSS.
Umbrella of shared utilities for the Stratara framework. Re-exports the Tier-A/B stack (Abstractions, Contracts, Diagnostics, Domain, Resilience, SessionContext) so consumers can pull one package and reach every common type.
Contents
- Source-generated
Logger*Extensionsfor outbox, saga, projection, messaging, and command flows (kept in Shared until each subdomain extracts to its own Tier-C package). - Domain-event helpers + merge primitives used across the framework.
- Re-export of every Tier-A/B Stratara public type via project-reference fan-out.
Quick reference
// One package reference reaches every Tier-A/B public type
using Stratara.Abstractions.Mediator; // ICommand, IQuery, IMediator
using Stratara.Contracts.Session; // SessionContext
using Stratara.Diagnostics; // ApplicationDiagnostics
// Source-generated logger extensions provided by Shared
logger.LogCommandWorkerStarted();
Dependencies
Transitively depends on every Tier-A/B package: Stratara.Abstractions, Stratara.Contracts, Stratara.Diagnostics, Stratara.Domain, Stratara.Resilience, Stratara.Sessions.
| 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
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Options (>= 10.0.8)
- Microsoft.Extensions.Resilience (>= 10.6.0)
- OpenTelemetry.Api (>= 1.15.3)
- Stratara.Abstractions (>= 3.1.5)
- Stratara.Contracts (>= 3.1.5)
- Stratara.Diagnostics (>= 3.1.5)
- Stratara.Domain (>= 3.1.5)
- Stratara.Resilience (>= 3.1.5)
- Stratara.Sessions (>= 3.1.5)
NuGet packages (11)
Showing the top 5 NuGet packages that depend on Stratara.Shared:
| Package | Downloads |
|---|---|
|
Stratara.Projections
Projection runtime for the Stratara event-sourced stack — projection-handler discovery, change-set creation, update application, and projection manager. Sits between read-model repositories and the event-bundle dispatcher. |
|
|
Stratara.EventSourcing.EntityFrameworkCore
EF Core persistence for the Stratara event-sourced stack on PostgreSQL — write-store, read-store, ASP.NET Identity store, shared conventions, value generators, and UnitOfWork primitives. Targets Npgsql with pgvector. |
|
|
Stratara.Outbox.RabbitMQ
Outbox-pattern command and event dispatch for the Stratara event-sourced stack — RabbitMQ IMessageBus implementation, retry worker, mediator command worker, and Redis-coordinated projection-replay state. Azure Service Bus support ships as the sibling Stratara.Outbox.AzureServiceBus package. |
|
|
Stratara.Infrastructure
Infrastructure glue for the Stratara framework — authorization decorators, configuration providers, and DI composition helpers that wire Mediator, Outbox, Identity, and EF Core into a hosted app. |
|
|
Stratara.Sagas
Saga runtime for the Stratara event-sourced stack — ISaga discovery, manager / handler dispatch, cached method invoker, and a hosted SagaWorker that routes incoming event bundles to matching sagas. |
GitHub repositories
This package is not used by any popular GitHub repositories.
### Added
- **Configurable snapshot strategy** (`Stratara.Abstractions`, `Stratara.Infrastructure`) — the
snapshot cadence is no longer hard-coded. A new `Stratara.Abstractions.EventSourcing.ISnapshotStrategy`
decides, per stream, whether the event-sourcing runtime should write a snapshot:
`bool ShouldSnapshot(Type aggregateType, long currentVersion, long lastSnapshotVersion)`.
`AddEventSourcing()` registers the default `VersionThresholdSnapshotStrategy` (snapshot every 50
versions — identical to the previous behaviour) via `TryAddSingleton`, so existing consumers see no
change. To take over the policy, register your own singleton `ISnapshotStrategy` (it overrides the
default whether registered before or after `AddEventSourcing()`): vary the threshold per aggregate
type, construct `new VersionThresholdSnapshotStrategy(threshold)` for a different uniform cadence, or
register `NoSnapshotStrategy` to disable snapshotting entirely. This replaces the previously
hard-coded `UseSnapshots`/`SnapshotRange` constants in the default snapshot service, which were not
actually configurable despite the documentation implying they were.
- **`AddDomainEventTypesFromAssemblyContaining<T>()`** (`Stratara.Abstractions`) — registers *only* the
domain event types consumed by an assembly's aggregate `Apply(TEvent)` methods in the trusted-type
resolver, without registering the aggregate types themselves and without pulling any projection / saga
/ command-handler classes into DI. Use it in a host that only needs to deserialize event payloads off
the message bus or event stream — typically a dedicated projection or saga worker — but must not wire
the handler classes (and their runtime dependencies) that `AddProjectionsFromAssemblyContaining<T>`
would register. Complements the existing `AddAggregatesFromAssemblyContaining<T>` (which additionally
registers the aggregate types) and `AddTrustedType<T>` (single type).