TL.MiddlewareLibrary 0.5.0

🚀 TL.MiddlewareLibrary

Suíte modular de middlewares para ASP.NET Core (.NET 8 e .NET 9): diagnóstico de latência com zero alocação, controle de taxa por IP, cache em memória com pooling e respostas estruturadas de erro no padrão RFC 7807 (ProblemDetails) integradas a TL.BaseContracts.

O TL.MiddlewareLibrary é uma biblioteca de infraestrutura transversal para o pipeline HTTP do ASP.NET Core, concebida para simplificar o desenvolvimento de APIs modernas, eliminar código defensivo repetitivo em controllers/endpoints e padronizar o tratamento de exceções de negócio e falhas não tratadas.

📦 Instalação

Adicione o pacote via .NET CLI:

dotnet add package TL.MiddlewareLibrary

🚀 Métodos de Extensão do Pipeline

💡 Exemplo Rápido de Uso

using TL.MiddlewareLibrary.Exceptions;
using TL.MiddlewareLibrary.Extensions;
using TL.MiddlewareLibrary.Middlewares;
using TL.BaseContracts;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddMemoryCache();

var app = builder.Build();

app.UseRequestTiming();
app.UseRequestResponseLogging();
app.UseRateLimiting(new RateLimitingOptions
{
    PermitLimit = 100,
    Period = TimeSpan.FromMinutes(1),
    WhiteListIps = { "127.0.0.1", "10.0.0.0/8" }
});
app.UseIdempotency();
app.UseCachingMiddleware(TimeSpan.FromMinutes(2));
app.UseExceptionHandling();
app.UseStatusCodeMiddleware();

app.MapGet("/api/clientes/{id}", (int id) =>
{
    if (id <= 0)
        throw new BadRequestException("O ID informado é inválido.");

    return Results.Ok(new { id, nome = "Cliente Exemplo" });
});

app.Run();

🎯 Ergonomia Minimal APIs (ToHttpResult())

Elimine o código defensivo repetitivo de pattern matching nas Minimal APIs com a bridge ToHttpResult():

using TL.BaseContracts.Http;

app.MapGet("/api/pedidos/{id:guid}", (Guid id, PedidoService service) =>
{
    return service.ObterPorId(id).ToHttpResult();
});

app.MapPost("/api/pedidos", async (NovoPedidoRequest request, PedidoService service) =>
{
    var result = await service.CriarPedidoAsync(request);
    return result.ToHttpResult(pedido => Results.Created($"/api/pedidos/{pedido.Id}", pedido));
});

Erros são mapeados automaticamente para RFC 7807 (ProblemDetails e ValidationProblemDetails).

👤 Injeção de Identidade e Tenant (ICurrentUser e ICurrentTenant)

Registre as implementações integradas ao IHttpContextAccessor:

using TL.MiddlewareLibrary.Context;

builder.Services.AddCurrentUser();
builder.Services.AddCurrentTenant(headerName: "X-Tenant-Id");

Permite injetar ICurrentUser e ICurrentTenant diretamente nos serviços de aplicação.

📄 Licença

Distribuído sob a licença MIT.