Stratara.Infrastructure
4.6.1
Prefix Reserved
See the version list below for details.
dotnet add package Stratara.Infrastructure --version 4.6.1
NuGet\Install-Package Stratara.Infrastructure -Version 4.6.1
<PackageReference Include="Stratara.Infrastructure" Version="4.6.1" />
<PackageVersion Include="Stratara.Infrastructure" Version="4.6.1" />
<PackageReference Include="Stratara.Infrastructure" />
paket add Stratara.Infrastructure --version 4.6.1
#r "nuget: Stratara.Infrastructure, 4.6.1"
#:package Stratara.Infrastructure@4.6.1
#addin nuget:?package=Stratara.Infrastructure&version=4.6.1
#tool nuget:?package=Stratara.Infrastructure&version=4.6.1
Stratara.Infrastructure
Derived. The behaviour described here is specified under
openspec/specs/. Those specifications are the source; this page explains and illustrates them.
License: MIT.
Cross-cutting infrastructure plumbing for the Stratara framework — the Tier-C glue that lets downstream apps wire authorization, DI composition, and worker-stack configuration with a single reference.
Contents
- Authorization decorators over command-outbox dispatch (
AuthorizingCommandOutboxDispatcher) — enforces[RequireRole]and[RequirePermission]on the command's runtime type before it reaches the outbox. - DI composition helpers that wire Mediator, Outbox, Identity, and EFCore into a hosted app.
- Configuration providers and option binders used by the worker stack.
Dependencies
Transitively depends on Stratara.Contracts, Stratara.EventSourcing.EntityFrameworkCore, Stratara.Mediator, Stratara.Outbox.RabbitMQ, Stratara.Sessions, Stratara.Shared.
Behavioural notes
AddSecurity() — IKeyStore registration (since 3.0.11)
AddSecurity() registers Stratara's security stack including the IKeyStore abstraction. The default is a TryAddSingleton<IKeyStore, DummyKeyStore> fallback — but DummyKeyStore since 3.0.11 throws InvalidOperationException in any environment other than Development (whitelist guard to prevent production data exposure from the demo encryption key). Hosts on Staging, QA, UAT, Preview, or any custom environment must register a real IKeyStore implementation before calling AddSecurity():
// Recommended composition root
if (builder.Environment.IsDevelopment())
{
builder.Services.AddSecurity(); // DummyKeyStore fallback is fine
}
else
{
// The production key store Stratara ships (Stratara.Security): KEK-wrapped, versioned
// per-scope DEKs. Register it before AddSecurity() so it wins the TryAdd race.
builder.Services.AddStrataraFileKeyStore(builder.Configuration);
builder.Services.AddSecurity();
}
Stratara ships one production IKeyStore — EnvelopeFileKeyStore, via AddStrataraFileKeyStore.
There is no built-in Azure Key Vault / AWS KMS / HSM store; if you need one, implement IKeyStore
against your provider and register it in place of the file store. Implement ListScopesAsync as
well: an erasure asks the key store for every key naming the subject, and a store that cannot list
leaves it with only the keys the directory names.
KeyStoreStartupProbe logs a Warning (event id LogEvents.KeyManagement.DummyKeyStoreActive = 112_001) at host start when the resolved IKeyStore is DummyKeyStore — even in Development — so an accidental dependency on the dummy is loud rather than silent.
Why the change: Before 3.0.11 the guard only blocked IsProduction(). Hosts in any other environment silently encrypted with the world-known constant pass-phrase "StrataraTestKey" baked into the shipping NuGet — a Staging or QA copy of production data could be decrypted by anyone reading the source. The whitelist guard makes this configuration crash-fast at host build instead of allowing silent data exposure.
AddCaching() — Redis registration
AddCaching() used to delegate to builder.AddRedisClient("redis") from Aspire.StackExchange.Redis. After the Aspire-wrapper removal it registers IConnectionMultiplexer directly via ConnectionMultiplexer.Connect(...) from StackExchange.Redis. The method signature is unchanged, but the Aspire-only side-effects are gone:
- No automatic Redis health check. Add one explicitly with
AddHealthChecks().AddRedis(connectionString)(fromAspNetCore.HealthChecks.Redis) if your host exposes/healthand you want Redis covered. - No automatic OpenTelemetry Redis instrumentation. Add
OpenTelemetry.Instrumentation.StackExchangeRedisand.AddRedisInstrumentation()to yourTracerProviderBuilderif you want Redis spans in your traces.
The connection-string lookup (ConnectionStrings:redis in configuration) is identical to the pre-cleanup behaviour.
| 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
- Azure.Identity (>= 1.21.0)
- Microsoft.AspNetCore.Http.Abstractions (>= 2.3.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- StackExchange.Redis (>= 3.4.5)
- Stratara.Contracts (>= 4.6.1)
- Stratara.EventSourcing.EntityFrameworkCore (>= 4.6.1)
- Stratara.Mediator (>= 4.6.1)
- Stratara.Outbox.RabbitMQ (>= 4.6.1)
- Stratara.Security (>= 4.6.1)
- Stratara.Sessions (>= 4.6.1)
- Stratara.Shared (>= 4.6.1)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Stratara.Infrastructure:
| Package | Downloads |
|---|---|
|
Stratara.EventSourcing.WorkerDefaults
Worker-host wiring composites for the Stratara event-sourced stack. IHostApplicationBuilder extensions (AddBackendServices, AddCommandWorkerServices, AddHeavyCommandWorkerServices, AddEventProjectionWorkerServices, AddEventStreamHashWorkerServices, AddSagaWorkerServices, AddOutboxWorkerServices, and AddCommandServices, AddEventProjectionServices and AddSagaServices without the bus-fed workers) bundle the per-concern DI calls so each worker host opts in with one line. |
|
|
Stratara.Testing.EntityFrameworkCore
Spin up the real Stratara event-sourcing write stack (EventSource, aggregation, snapshots, the EF Core write store) against a shared in-memory SQLite database in one call — production code paths, no Postgres, no Docker. Builds on Stratara.Testing's in-memory doubles. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 4.8.0 | 101 | 11/6/2026 |
| 4.7.1 | 98 | 11/5/2026 |
| 4.7.0 | 458 | 10/30/2026 |
| 4.6.1 | 128 | 10/29/2026 |
| 4.6.0 | 195 | 10/28/2026 |
| 4.5.0 | 282 | 10/28/2026 |
| 4.4.10 | 230 | 10/26/2026 |
| 4.4.9 | 131 | 10/26/2026 |
| 4.4.8 | 280 | 10/24/2026 |
| 4.4.7 | 140 | 10/23/2026 |
| 4.4.6 | 244 | 10/22/2026 |
| 4.4.5 | 319 | 10/14/2026 |
| 4.4.4 | 316 | 10/10/2026 |
| 4.4.3 | 152 | 10/10/2026 |
| 4.4.2 | 418 | 10/2/2026 |
| 4.4.1 | 404 | 9/29/2026 |
| 4.4.0 | 161 | 9/27/2026 |
| 4.3.1 | 160 | 9/25/2026 |
| 4.3.0 | 325 | 9/23/2026 |
| 4.2.0 | 203 | 9/18/2026 |
A release about two costs of the Orleans execution model that grew with the deployment rather than with the work.
A commit woke every projection and saga reader of each partition it touched, whatever it had committed. Every one of
them read the new entries and wrote its checkpoint, also when it applied nothing, and every reader polled the store on
its own: every single-event command cost a checkpoint write per projection and saga, and an idle silo with many
consumers kept the store busy with hundreds of reads a second. A commit now costs work only for the readers it
concerns, and an idle silo asks the store a few questions per partition and poll interval.
A recorded command whose handler met a concurrency conflict waited for its hand-over to lapse, 30 seconds by default,
before the drain ran it again; on the bus a conflicting message is redelivered at once. It now runs again within
moments.
### Added
- **`ProjectionGrainOptions.IdleCheckpointInterval`** (default 30 seconds) bounds how long a projection's reader may
hold its checkpoint back past entries it applied nothing for. `TimeSpan.Zero` writes the checkpoint after every
batch, as before.
- **`ICommandIntentStore.CountConflictAsync`** counts a conflict and records it without giving the attempt back, and
answers how many conflicts the command has met. The default records through `RecordConflictAsync` and answers
`null`, so an intent store of your own compiles and behaves as before; the framework's store implements it.
### Changed
- **A commit wakes only the readers whose projection or saga applies one of its event types.** This holds for the
wake-up on a silo with a store-reading role and for `AddStrataraStoreWakeUps()`. Woken by every commit as before:
a stateful saga process, which decides from the event itself, and every reader when the commit holds an event type
the silo cannot resolve or whose upcaster refuses an empty payload, or when the host's upcaster pipeline is its own.
A multi-stream commit wakes, in each partition, the readers of the events it wrote there. In a test host with six
projections of which one applied the commit, ten commits cost 59 store reads before and only the applying
projection's reads now, and a commit nobody applies costs no read when it is made. A reader whose partition moved
past it still reads once at its next poll, and then waits again.
- **A projection's reader writes its checkpoint past entries it applied nothing for later**: with the next batch that
applies something, once `IdleCheckpointInterval` has passed, or when it deactivates. It answers waits for its
projection from the position it holds. A reader whose silo dies before the write reads those entries again and
applies nothing for them. A rebuild or a replay discards a position held back. A saga's reader writes its checkpoint
after every batch as before, because a saga added to a running deployment starts where the host's sagas have
written they read.
- **A poll reads the store only when its partition holds something past the reader's position.** Each silo asks the
store for a partition's head at most once per half poll interval, for all its readers. In the test host, 96 idle
readers polling every 500 ms read the store about 960 times in five seconds before and not at all now. A lost
wake-up is applied within about one and a half poll intervals rather than one. A committed position reader that
does not override `ICommittedPositionReader.HeadAsync` keeps polling as before.
- **A conflicting recorded command runs again at once.** The silo that ran it runs it again in a unit of work of its
own while it still holds the hand-over, pausing as the `ResilienceNames.ConcurrencyConflict` pipeline does (five
retries from 50 ms), on the aggregate activation's scheduler. A heavy command keeps its permit. Every conflict is
still recorded and counted, and the command runs again only while its conflicts stay within
`MessageRetryOptions.MaxConflictRequeues`, so a command that conflicts on every attempt runs as often as before and
is kept. The hand-over's attempt is given back once when the command leaves on a conflict, however often it ran.
After the pipeline's retries the drain resumes it as before.
- **`ExecutionModelTestHost.WaitForReadersAsync` waits for the readers' positions**, not their stored checkpoints,
so it returns once every reader has read to the head, whether or not it has written its checkpoint there yet.
**Upgrading:** nothing to do. Hosts and silos of 4.6.0 and of this release mix in a rolling deployment: the cluster
wake-up keeps its form, an earlier host's wake-up wakes every reader, and an earlier silo wakes every reader of a newer
host's wake-up. Checkpoints keep their form. An intent store of your own keeps the old timing after a conflict until
it implements `CountConflictAsync`.