Olve.MinimalApi 0.37.2

Olve.MinimalApi

ASP.NET Core Minimal API extensions for Olve.Results. Maps Result and Result<T> to HTTP responses, adds endpoint validation filters, and provides JSON conversion for IPath.

Installation

dotnet add package Olve.MinimalApi

Overview

Usage

Result mapping

Use WithResultMapping() on a RouteHandlerBuilder to automatically convert Result and Result<T> return values into HTTP responses:

app.MapGet("/users/{id}", (int id, UserHandler handler, CancellationToken ct)
        => handler.HandleAsync(new GetUser(id), ct))
    .WithResultMapping<UserDto>();

The non-generic WithResultMapping() is used when the handler returns Result (no value):

app.MapDelete("/users/{id}", (int id, DeleteHandler handler, CancellationToken ct)
        => handler.RunAsync(new DeleteUser(id), ct))
    .WithResultMapping();

You can also convert results manually with the ToHttpResult() extension:

app.MapGet("/manual", () =>
{
    Result<string> result = Result.Success("hello");
    return result.ToHttpResult();
});

Validation

Use WithValidation<TRequest, TValidator>() on a RouteHandlerBuilder to validate requests before the handler runs. If validation fails, a 400 Bad Request with the validation problems is returned immediately:

app.MapPost("/users", (CreateUserRequest request, UserHandler handler, CancellationToken ct)
        => handler.HandleAsync(request, ct))
    .WithResultMapping<UserDto>()
    .WithValidation<CreateUserRequest, CreateUserValidator>();

The validator must implement IValidator<TRequest> from Olve.Validation. A new instance is created per endpoint by default, or you can pass an existing instance:

var validator = new CreateUserValidator();
app.MapPost("/users", ...)
    .WithValidation<CreateUserRequest, CreateUserValidator>(validator);

Handler interfaces

Two handler interfaces standardize the request/response pattern:

// For operations that return no value (e.g. delete, update)
public interface IHandler<in TRequest>
{
    Task<Result> RunAsync(TRequest request, CancellationToken cancellationToken);
}

// For operations that return a value (e.g. get, create)
public interface IHandler<in TRequest, TResponse>
{
    Task<Result<TResponse>> HandleAsync(TRequest request, CancellationToken cancellationToken);
}

Path JSON conversion

Register PathJsonConverter to enable JSON round-trip serialization of IPath values:

builder.Services.WithPathJsonConversion();

This adds the converter to the default JsonSerializerOptions, allowing IPath to be used in request/response models. Null JSON values deserialize to null.

Documentation

Full API reference: https://olivervea.github.io/Olve.Utilities/api/Olve.MinimalApi.html

License

MIT License © OliverVea