MinimalCleanArch.Messaging 0.1.18-preview

MinimalCleanArch.Messaging

Messaging and domain event helpers for MinimalCleanArch (Wolverine integration).

Version

• Current preview: 0.1.18-preview (net9.0, net10.0). Latest stable: 0.1.17.

Why Use It

• publish and handle domain events through Wolverine without building the integration layer from scratch
• add outbox-capable messaging and background processing to an MCA application
• carry execution-context data such as correlation and tenant information into message handlers

When to Use It

• use it when the application has domain events, asynchronous workflows, integration messages, or background jobs and Wolverine is an acceptable host-side dependency
• keep it in infrastructure or host composition code where transports and message handlers are wired
• skip it for synchronous CRUD-style applications that do not need messaging yet

Dependency Direction

• Depends on: MinimalCleanArch
• Typically referenced by: infrastructure projects or the application host
• Do not reference from: pure domain projects
• Guidance: application code can define events and handlers, but the transport and Wolverine wiring should stay outside the domain layer

What's included

• Domain event contracts and helpers.
• Wolverine integration extensions.
• DI extensions to wire messaging into your MinimalCleanArch app.

Usage

dotnet add package MinimalCleanArch.Messaging --version 0.1.18-preview

Recommended bootstrap:

builder.AddMinimalCleanArchMessaging(options =>
{
    options.IncludeAssembly(typeof(AssemblyReference).Assembly);
    options.ServiceName = "MyApp";
    options.QueuePrefix = "myapp-";
});

Durable transports:

builder.AddMinimalCleanArchMessagingWithPostgres(connectionString, options =>
{
    options.IncludeAssembly(typeof(AssemblyReference).Assembly);
    options.ServiceName = "MyApp";
    options.SchemaName = "messaging";
    options.DeadLetterQueueExpirationEnabled = true;
    options.DeadLetterQueueExpiration = TimeSpan.FromDays(7);
});

Failure policies:

builder.AddMinimalCleanArchMessaging(options =>
{
    options.ConfigureFailurePolicies = policies =>
    {
        policies.OnException<TimeoutException>().RetryWithCooldown(
            TimeSpan.FromSeconds(1),
            TimeSpan.FromSeconds(5));
    };
});

Use this package when:

• handlers and domain events are part of the application model
• you want domain event publishing wired through EF Core save operations
• you want an app-level entry point over raw Wolverine setup

Preferred guidance:

• use the AddMinimalCleanArchMessaging... extensions as the entry point
• use QueuePrefix, LocalQueueName, dead-letter expiration settings, and failure-policy hooks for the common cases
• keep transport-specific edge cases in the provided raw Wolverine callback when needed
• avoid duplicating domain event publishing logic in application DbContexts
• rely on IExecutionContext for correlation and tenant data inside message handlers

Claim resolution for the built-in execution-context implementations can be customized with ExecutionContextOptions:

builder.Services.Configure<ExecutionContextOptions>(options =>
{
    options.UserNameClaimTypes.Clear();
    options.UserNameClaimTypes.Add("preferred_username");
});

When using a local feed, add a nuget.config pointing to your local packages folder and keep nuget.org available unless your feed mirrors all external dependencies.