Flux.Mediator 2.2.0

Flux.Mediator

Flux.Mediator is a lightweight, high‑performance mediator library for .NET focused on clean architecture, explicit contracts, and zero magic.

It provides in‑process request/response dispatching with strong typing, DI integration --- designed to be predictable, testable, and framework‑agnostic.

Features

• Request / Response model
• Notification model
• Strongly typed handlers
• Thread-safe & stateless mediator
• Clean separation of Abstractions and Core
• Designed for testability

Packages

Installation

dotnet add package Flux.Mediator

Basic Concepts

Request

public record PingRequest : IRequest<string>;

Notification

public record Notification(string Message) : INotification;

Handlers

public sealed class PingRequestHandler : IRequestHandler<PingRequest, string>
{
    public Task<string> HandleAsync(PingRequest request, CancellationToken ct)
        => Task.FromResult("pong");
}

public sealed class NotificationHandler : INotificationHandler<Notification>
{
    public async Task HandleAsync(Notification notification, CancellationToken ct)
        => Console.WriteLine($"A notification received - {notification.Message}");
}

Registering Handlers

services.AddTransient<IRequestHandler<PingRequest, string>, PingRequestHandler>();
services.AddTransient<INotificationHandler<Notification>, NotificationHandler>();

Registering the Mediator

services.AddFluxMediator();

Using the Mediator

Request

var result = await mediator.SendAsync(new PingRequest());

Notification

await mediator.PublishAsync(new Notification("You have a message."));

Architecture Goals

Flux.Mediator is built around:

• Explicit contracts
• No hidden service locators
• Predictable execution flow
• High performance without sacrificing readability
• Compatibility with Clean Architecture, DDD and CQRS patterns

Benchmarks

BenchmarkDotNet v0.15.8, Linux Debian GNU/Linux 13 (trixie)
Intel Xeon CPU E5-2680 v4 2.40GHz, 1 CPU, 28 logical and 14 physical cores
.NET SDK 10.0.201
  [Host]     : .NET 10.0.5 (10.0.5, 10.0.526.15411), X64 RyuJIT x86-64-v3
  DefaultJob : .NET 10.0.5 (10.0.5, 10.0.526.15411), X64 RyuJIT x86-64-v3

Testing

The mediator is designed to be tested in isolation:

var result = await mediator.SendAsync(new PingRequest());
Assert.Equal("pong", result);

Versioning

Flux.Mediator follows Semantic Versioning:

• MAJOR → breaking changes
• MINOR → new features without breaking
• PATCH → fixes

NuGet

NuGet Package - Flux.Mediator

Author

Miguel Magno