DotEmilu.AspNetCore 10.0.0

DotEmilu.AspNetCore

ASP.NET Core integration for DotEmilu — bridges use-case handlers to Minimal API endpoints, formats errors as RFC 7807 Problem Details, and provides AsDelegate for zero-boilerplate endpoint wiring.

Install

dotnet add package DotEmilu.AspNetCore

This transitively installs DotEmilu and DotEmilu.Abstractions.

What's included

HTTP handlers

Delegate helpers

Presenter

Configuration

DI registration

Endpoint wiring with AsDelegate

The cleanest way to define endpoints — no handler variable, no manual HandleAsync call:

var invoices = app.MapGroup("/invoices");

// POST /invoices → 201 Created
invoices.MapPost("", AsDelegate.ForAsync<CreateInvoiceRequest>(TypedResults.Created));

// GET /invoices → 200 OK with PaginatedList<Invoice>
invoices.MapGet("", AsDelegate.ForAsync<GetInvoicesRequest, PaginatedList<Invoice>>());

// GET /invoices/{id} → 200 OK or 404 Not Found
invoices.MapGet("{id:int}", AsDelegate.ForAsync<GetInvoiceByIdRequest, InvoiceResponse>(
    response => response is null ? TypedResults.NotFound() : TypedResults.Ok(response)));

// PUT /invoices/{id} → 204 No Content
invoices.MapPut("{id:int}", AsDelegate.ForAsync<UpdateInvoiceRequest>(TypedResults.NoContent));

// DELETE /invoices/{id} → 204 No Content
invoices.MapDelete("{id:int}", AsDelegate.ForAsync<DeleteInvoiceRequest>(TypedResults.NoContent));

Manual HttpHandler usage

If you need more control, inject HttpHandler directly:

app.MapPost("/invoices", async (
    CreateInvoiceRequest request,
    HttpHandler<CreateInvoiceRequest> handler,
    CancellationToken ct) =>
        await handler.HandleAsync(request, ct, () => TypedResults.Created()));

Configuration

Add to appsettings.json:

{
  "ResultMessage": {
    "ValidationError": {
      "Title": "Bad Request",
      "Detail": "One or more validation errors occurred."
    },
    "ServerError": {
      "Title": "Internal Server Error",
      "Detail": "An unexpected error occurred. Please contact the administrator."
    }
  }
}

Full registration

builder.Services
    .AddDotEmilu()                                           // HttpHandler + Presenter + Verifier
    .AddHandlers(Assembly.GetExecutingAssembly())            // scan handlers
    .AddChainHandlers(Assembly.GetExecutingAssembly())       // scan chain handlers
    .AddValidatorsFromAssembly(Assembly.GetExecutingAssembly()); // FluentValidation validators

Additional documentation

• Getting started
• Handler patterns
• Entity Framework Core patterns

Part of the DotEmilu ecosystem

Feedback

File bugs, feature requests, or questions on GitHub Issues.

Full documentation & source