XForge.MediatR.Generator 0.21.0

XForge.MediatR

<p align="center"> <img src="icon.png" alt="XForge.MediatR" width="128" height="128" /> </p>

Simple, fluent, in-process mediator for .NET with CQRS, pipeline behaviors, and local events.

Quick Start

using XForge.MediatR.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddXForgeMediator(cfg =>
{
    cfg.RegisterHandlersFrom<Program>();
    cfg.UseValidation();
    cfg.UseLogging();
    cfg.UsePerformanceMetrics();
});

var app = builder.Build();

app.MapGet("/orders/{id}", async (int id, IXForgeMediator mediator) =>
{
    var order = await mediator.Send(new GetOrder(id));
    return Results.Ok(order);
});

app.Run();

Features

• CQRS — IRequest<T>, ICommand<T>, IQuery<T>, ICommand, IQuery, ICommandHandler, IQueryHandler
• Events — IEvent with sequential or parallel publish, custom publishers, IDomainEvent, event filters
• Streaming — IStreamRequest<T> with IAsyncEnumerable and stream behaviors
• Pipeline — IRequestBehavior<TReq, TRes> with ordering, filtering, short-circuit
• Built-in behaviors — Validation, Logging, Performance Metrics, Diagnostics
• Resilience — Retry (exponential/linear/constant backoff), Circuit Breaker, Rate Limiter, Concurrency Limiter
• Enterprise — Authorization, Idempotency, Caching, Audit, Transaction behaviors
• Exception Handling — IRequestExceptionHandler<TReq, TRes, TEx> with fallback responses
• Pre/Post Processors — IPreProcessor<T>, IPostProcessor<T, TRes>
• Result<T> — Native success/failure pattern without exceptions
• Cascading Messages — ICascadeHandler<TReq, TRes> with automatic recursive dispatch
• POCO Handlers — Convention-based handler detection (opt-in via UsePocoHandlers())
• Handler Delegates — Inline handlers via Handle<TReq,TRes>(), HandleVoid<TReq>(), HandleEvent<TEvent>()
• Fluent DI — Assembly scanning, per-request behavior filters, flat API
• Testable — TestableMediator for unit tests without DI container
• Source Generator — Zero-reflection handler registration at compile-time
• Roslyn Analyzer — Duplicate handler detection at compile-time
• OpenTelemetry — Dedicated package for traces and metrics
• Zero magic — Explicit, predictable, debuggable

Packages

Package	NuGet	Description
XForge.MediatR.Abstractions		Contracts and interfaces
XForge.MediatR		Core mediator with pipeline and behaviors
XForge.MediatR.DependencyInjection		DI extensions and fluent API
XForge.MediatR.Testing		Test helpers (TestableMediator)
XForge.MediatR.Generator		Source generator + Roslyn analyzer
XForge.MediatR.OpenTelemetry		OpenTelemetry traces + metrics

Installation

dotnet add package XForge.MediatR.DependencyInjection

Optional packages:

dotnet add package XForge.MediatR.Testing
dotnet add package XForge.MediatR.Generator
dotnet add package XForge.MediatR.OpenTelemetry

Documentation

Complete enterprise-grade manual with examples from basic to advanced:

• Manual Completo (pt-br)
• Full Manual (en-us)

License

MIT