Mediator

Appearance

Foundatio MediatorBuild Loosely Coupled .NET Apps — Without the Tradeoffs

Easy to maintain, easy to test, and blazingly fast — a convention-based mediator powered by source generators and interceptors

Get Started
View on GitHub
Foundatio Mediator
🧩

Loosely Coupled by Default

Every interaction flows through messages, so components never call each other directly. Change, replace, or remove any handler without ripple effects across your codebase.

🔗

Compose with Events

Publish an event and any number of handlers react — without knowing about each other. Add new behavior to your app without modifying existing code.

🧪

Easy to Test

Handlers are plain classes with no framework base types. Unit test them like any other object — no mediator mocking, no DI container, no ceremony.

⚡

No Performance Tax

Source generators and C# interceptors compile your mediator calls into near-direct method calls. You get the architecture benefits without the runtime overhead.

🎯

Convention-Based, Zero Boilerplate

No interfaces, no base classes, no manual registration. Just name your classes and methods following simple conventions — the source generator handles all the wiring.

🌐

Auto-Generated API Endpoints

Full Minimal API endpoints generated from your handlers — routes, methods, parameter binding, OpenAPI metadata, and authorization all inferred automatically.

📡

Real-Time Streaming

Add Server-Sent Events to your API by returning IAsyncEnumerable from a handler. Real-time push with zero infrastructure plumbing.

🎯

Rich Result Types

Built-in Result for success, validation errors, and failure states — auto-mapped to HTTP status codes on endpoints.

🔧

Full Dependency Injection

Built-in support for Microsoft.Extensions.DependencyInjection with constructor and method injection.

🎪

Middleware Pipeline

Before/After/Finally/Execute hooks with state passing and short-circuiting capabilities.

🔄

Automatic Message Cascading

Return tuples to automatically publish additional messages in sequence — ideal for event-driven workflows.

🔒

Compile-Time Safety & Debugging

Comprehensive diagnostics catch errors early. Short, simple call stacks with minimal indirection make debugging straightforward.

Quick Example ​

Create a simple handler by following naming conventions:

csharp
public record Ping(string Text);

public class PingHandler
{
    public string Handle(Ping msg) => $"Pong: {msg.Text}";
}

Register the mediator and use it:

csharp
// Program.cs
services.AddMediator();

// Usage
var reply = await mediator.InvokeAsync<string>(new Ping("Hello"));
// Output: "Pong: Hello"

Turn your message handlers into API endpoints automatically:

csharp
app.MapMediatorEndpoints();
// That's it — routes, methods, and parameter binding are all generated for you.

Released under the MIT License.

Copyright © 2026 Foundatio