olve-minimal-api

Olve.MinimalApi

ASP.NET Core Minimal API extensions for Olve.Results. Source: Olve.Utilities/src/Olve.MinimalApi/.

Reference docs: README | Handlers | ResultMapping | Validation | Services

Result Mapping

Map Result / Result<T> return values to HTTP responses automatically:

// Generic — 200 OK with body or 400 Bad Request
app.MapGet("/users/{id}", (int id, UserHandler handler, CancellationToken ct)
        => handler.HandleAsync(new GetUser(id), ct))
    .WithResultMapping<UserDto>();

// Non-generic — 200 OK (empty) or 400 Bad Request
app.MapDelete("/users/{id}", (int id, DeleteHandler handler, CancellationToken ct)
        => handler.RunAsync(new DeleteUser(id), ct))
    .WithResultMapping();

Return value	HTTP response
Result success	200 OK (empty body)
Result<T> success	200 OK with T as body
Any failure	400 Bad Request with ResultProblem[] as body

Validation

Add validation filters using IValidator<T> from Olve.Validation:

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

Handler Interfaces

// No return value (delete, update)
public class MyHandler : IHandler<MyRequest>
{
    public Task<Result> RunAsync(MyRequest request, CancellationToken ct) { ... }
}

// With return value (get, create)
public class MyHandler : IHandler<MyRequest, MyResponse>
{
    public Task<Result<MyResponse>> HandleAsync(MyRequest request, CancellationToken ct) { ... }
}

Path JSON Conversion

builder.Services.WithPathJsonConversion();