Trellis.EntityFrameworkCore.Outbox 3.0.0-alpha.527

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of Trellis.EntityFrameworkCore.Outbox. 
dotnet add package Trellis.EntityFrameworkCore.Outbox --version 3.0.0-alpha.527
                    


                    

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


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Trellis.EntityFrameworkCore.Outbox" />
                    


                            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 Trellis.EntityFrameworkCore.Outbox --version 3.0.0-alpha.527
                    


                    

                
#r "nuget: Trellis.EntityFrameworkCore.Outbox, 3.0.0-alpha.527"
#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 Trellis.EntityFrameworkCore.Outbox@3.0.0-alpha.527
#: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=Trellis.EntityFrameworkCore.Outbox&version=3.0.0-alpha.527&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Trellis.EntityFrameworkCore.Outbox&version=3.0.0-alpha.527&prerelease
                    


                            Install as a Cake Tool

Trellis.EntityFrameworkCore.Outbox

NuGet Package

Transactional outbox and post-commit domain-event dispatch for EF Core applications built with Trellis.

It captures domain events in the aggregate transaction and relays them after commit. Translators can then stage integration events for reliable publication.

This package opts out of NativeAOT and trimming because it builds on EF Core and discovers integration-event types at runtime.

Installation

dotnet add package Trellis.EntityFrameworkCore.Outbox

Quick Example

protected override void OnModelCreating(ModelBuilder modelBuilder) =>
    modelBuilder.AddTrellisOutbox();

builder.Services.AddDbContext<AppDbContext>(options =>
    options.UseNpgsql(connectionString)
        .AddTrellisInterceptors()
        .AddTrellisOutboxInterceptor());

builder.Services.AddTrellis(trellis => trellis
    .UseDomainEvents(typeof(Program).Assembly)
    .UseIntegrationEvents(typeof(Program).Assembly)
    .UseEntityFrameworkUnitOfWork<AppDbContext>()
    .UseOutbox<AppDbContext>());

Translate domain events into integration events by adding them to IIntegrationEventCollector from a domain-event handler.

Key Features

  • Captures domain-event rows in the same transaction as aggregate changes.
  • Persists optional W3C trace context and business lineage on domain rows and translated integration rows.
  • Dispatches domain events only after a successful commit.
  • Publishes pending integration events through a resilient background service.
  • Supports configurable batching, locking, lease recovery, retry scheduling, and dead-lettering.
  • Exposes an explicit retryability contract for publisher failures.
  • Requires no broker dependency; transport packages implement IIntegrationEventPublisher.

All three wiring steps are required: map the table, register AddTrellisOutboxInterceptor() for capture, and register the relay. Let the unit-of-work pipeline own SaveChangesAsync(). Carry OutboundIntegrationMessage.MessageId unchanged as the transport message ID so inbox consumers can deduplicate end to end.

The alpha outbox schema includes nullable MessageSource, CausationId, CorrelationId, TraceParent, and TraceState columns; no migration or backfill is provided. Use IntegrationMessageContext.BeginCorrelation("workflow-id") to supply an application-owned business correlation id; one is never inferred from the trace.

Documentation

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 Trellis.EntityFrameworkCore.Outbox:

Package Downloads
Trellis.ServiceDefaults

Opinionated service composition defaults for Trellis web services. Provides a tiered builder that wires ASP integration, Mediator behaviors, FluentValidation, resource authorization, actor providers, and EF Core Unit of Work in canonical order.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.0.0-alpha.527 0 10/1/2026
3.0.0-alpha.526 26 9/30/2026
3.0.0-alpha.524 55 9/27/2026
3.0.0-alpha.520 59 9/25/2026
3.0.0-alpha.516 89 9/22/2026
3.0.0-alpha.513 58 9/22/2026
3.0.0-alpha.505 59 9/13/2026
3.0.0-alpha.495 135 8/24/2026
3.0.0-alpha.458 106 8/19/2026
3.0.0-alpha.455 128 8/19/2026
3.0.0-alpha.449 76 8/18/2026
3.0.0-alpha.447 81 8/18/2026
3.0.0-alpha.432 107 7/6/2026
3.0.0-alpha.428 101 7/3/2026
3.0.0-alpha.425 116 6/27/2026
3.0.0-alpha.419 88 6/24/2026
3.0.0-alpha.418 100 6/23/2026
3.0.0-alpha.417 88 6/23/2026
3.0.0-alpha.397 82 6/18/2026
3.0.0-alpha.396 84 6/18/2026
Loading failed