Stratara.Resilience 3.1.7

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Stratara.Resilience --version 3.1.7
                    


                    

                
NuGet\Install-Package Stratara.Resilience -Version 3.1.7
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="Stratara.Resilience" Version="3.1.7" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Stratara.Resilience" Version="3.1.7" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Stratara.Resilience" />
                    


                            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 Stratara.Resilience --version 3.1.7
                    


                    

                
#r "nuget: Stratara.Resilience, 3.1.7"
#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 Stratara.Resilience@3.1.7
#: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=Stratara.Resilience&version=3.1.7
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Stratara.Resilience&version=3.1.7
                    


                            Install as a Cake Tool

Stratara.Resilience

License: MIT.

Polly-based named resilience pipelines pre-wired for Stratara's messaging + outbox dispatch paths.

Quick start

services.AddResiliencePipelines();

// Resolve a specific named pipeline at the call site:
var pipeline = sp.GetRequiredService<ResiliencePipelineProvider<string>>()
    .GetPipeline(ResilienceNames.CommandDispatcher);

await pipeline.ExecuteAsync(async ct => {
    await DoFlakyWorkAsync(ct);
}, cancellationToken);

Named pipelines

Name Constant Strategy
Message bus ResilienceNames.MessageBus Exponential retry up to int.MaxValue, 10s → 60s, jitter
Command dispatcher ResilienceNames.CommandDispatcher 3 retries, exponential, 200ms, jitter
Event bundle dispatcher ResilienceNames.EventBundleDispatcher 3 retries, exponential, 200ms, jitter
Concurrency conflict ResilienceNames.ConcurrencyConflict Retry only on ConcurrencyConflictException, 5 attempts, short exponential, jitter

The ResilienceFactory that builds these is internal — interact via DI and ResilienceNames only.

Mediator resilience behavior

Hook a named pipeline into the in-process mediator pipeline per request — no manual ExecuteAsync plumbing:

services.AddResiliencePipelines();
services.AddStrataraResilienceBehavior();   // after AddStrataraValidation() / AddStrataraTenantIsolation()

public sealed record ReserveStock(Guid Id, int Qty) : ICommand<bool>, IResilientRequest
{
    public string ResiliencePipelineName => ResilienceNames.ConcurrencyConflict;
}

Any request implementing Stratara.Abstractions.Resilience.IResilientRequest is dispatched inside the named pipeline it selects; unmarked requests pass straight through. Only mark handlers that are safe to re-run — naturally idempotent work, or operations guarded by optimistic concurrency (point at the ConcurrencyConflict pipeline). Register the behavior after the validation / tenant-isolation behaviors so a retry re-runs the handler, not the guards.

Dependencies

  • Stratara.Abstractions — for IPipelineBehavior, IResilientRequest, and ConcurrencyConflictException.
  • Microsoft.Extensions.DependencyInjection.Abstractions
  • Microsoft.Extensions.Resilience (Polly).
Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Stratara.Resilience:

Package Downloads
Stratara.Shared

Umbrella package for the Stratara framework — source-generated logger extensions for outbox / saga / projection / messaging, domain-event helpers, merge primitives, and the Tier-A/B abstractions surface re-exported as one transitive bundle.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.1.7 189 7/1/2026
3.1.6 574 6/22/2026
3.1.5 238 6/22/2026
3.1.4 253 6/15/2026
3.1.3 248 6/10/2026
3.1.2 257 6/5/2026
3.1.1 313 6/1/2026
3.1.0 229 5/30/2026
3.0.23 221 5/28/2026

### Added

- **Event upcasting (`IEventUpcaster`).** Persisted events can now be transformed from an older
 on-disk schema into the shape the current event record expects, applied on read before the payload
 is deserialized. Register upcasters with `AddEventUpcaster<TUpcaster>()`; each implements
 `IEventUpcaster` (`SourceEventTypeName` / `TargetEventTypeName` plus `JsonNode Upcast(JsonNode)`) and
 they chain across successive schema versions (v1→v2→v3), including event-type renames — the source
 type no longer needs to exist in the assembly. Matching ignores the assembly `Version` segment, and
 a cyclic or duplicate-source chain is rejected. Hosts that register no upcasters are unaffected
 (transparent pass-through). Snapshots are not upcasted — change an aggregate's shape and rebuild its
 snapshots.

### Changed

- **Copyright holder corrected to the full legal name "Norbert Heinz Rosenwinkel"** in the `LICENSE`
 file and in the `Authors` / `Copyright` package metadata. No code or licensing-terms change — the
 license remains MIT.