Interlink - Lightweight Mediator Library for .NET

Designed for Simplicity and Performance

Interlink gives you the core benefits of a mediator pattern without the boilerplate bloat.

Ultra Lightweight

Minimal footprint with zero unnecessary dependencies. Built to stay out of your way and run blazing fast on .NET Standard 2.0+ through .NET 10.

Request & Response

Clean request/response pattern with strong typing. Encapsulate queries and commands using IRequest<T> and dedicated handlers.

Notifications (Pub/Sub)

Broadcast domain events to multiple handlers with zero friction using the simple INotification + IPublisher model.

Pipeline Behaviors

Add cross-cutting concerns (logging, validation, timing, etc.) with ordered pipeline behaviors. Control execution order via attributes or configuration.

Pre & Post Processors

Run logic before the pipeline and after a successful handler execution. Automatically discovered and registered by AddInterlink().

Easy DI Registration

One-line setup with assembly scanning. Optional custom service factory and full control over pipeline behavior ordering.

Optional Extensions

Keep the core package minimal. Add only the features you need.

Logging

Built-in LoggingBehavior that logs request start, duration, and exceptions.

Interlink.Extensions.Logging

FluentValidation

Automatic validation pipeline. Throws ValidationException on failure.

Interlink.Extensions.Validation

ASP.NET Core

Exception filter that maps HandlerNotFoundException → 404 and validation errors → 400.

Interlink.AspNetCore

Analyzers

Roslyn analyzer that warns (ILINK001) when a request has no matching handler.

Interlink.Analyzers

Clean Code Examples

See how straightforward it is to define a query and handle it with Interlink.

1. Define a Request & Handler

public record GetUserQuery(int Id) : IRequest<UserDto>;

public class GetUserQueryHandler 
    : IRequestHandler<GetUserQuery, UserDto>
{
    public async Task<UserDto> Handle(
        GetUserQuery request, 
        CancellationToken cancellationToken)
    {
        // Fetch user logic here...
        return new UserDto(request.Id, "John Doe");
    }
}

2. Send via Interlink

[ApiController]
[Route("api/users")]
public class UsersController(ISender sender) : ControllerBase
{
    [HttpGet("{id}")]
    public async Task<IActionResult> Get(int id)
    {
        var query = new GetUserQuery(id);
        var result = await sender.Send(query);
        
        return Ok(result);
    }
}

Decouple your .NET application with Interlink