HoneyDrunk.Web.Rest.AspNetCore 0.2.0

HoneyDrunk.Web.Rest.AspNetCore

Middleware, filters, and endpoint helpers that enforce HoneyDrunk REST conventions for ASP.NET Core services.

Quick Start

var builder = WebApplication.CreateBuilder(args);

// Add REST services
builder.Services.AddRest(options =>
{
    options.IncludeExceptionDetails = builder.Environment.IsDevelopment();
    options.EnableRequestLoggingScope = true;
});

var app = builder.Build();

// Use REST middleware (call early, before routing)
app.UseRest();

app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();
app.Run();

Features

Correlation ID Propagation

• Prefers Kernel IOperationContext.CorrelationId if available (via IOperationContextAccessor)
• Falls back to X-Correlation-Id header from incoming requests
• Generates a new correlation ID if not present
• Returns correlation ID in response headers
• Makes correlation ID available via ICorrelationIdAccessor
• Logs a warning when both Kernel and header correlation IDs are present but differ

Kernel Integration

When HoneyDrunk.Kernel is registered, the middleware automatically:

• Uses IOperationContextAccessor.Current.CorrelationId as the preferred correlation source
• Enriches logging scopes with Kernel context values:
  • OperationId, OperationName, CausationId
  • TenantId, ProjectId
  • NodeId, StudioId, Environment (from IGridContext)

Auth Integration

When HoneyDrunk.Auth.AspNetCore is registered:

• Uses IAuthenticatedIdentityAccessor to provide context-aware error messages
• Shapes 401/403 responses as ApiErrorResponse via IAuthorizationMiddlewareResultHandler
• Falls back to HttpContext.User.Identity.IsAuthenticated when IAuthenticatedIdentityAccessor is not registered

Transport Integration

Extension methods for mapping ITransportEnvelope to ApiResult:

// From envelope
ApiResult result = envelope.ToApiResult();
ApiResult<T> result = envelope.ToApiResult(data);

// From outcome
ApiResult result = TransportResultExtensions.FromOutcome(isSuccess, errorMessage, correlationId);

Exception Mapping

All unhandled exceptions are mapped to ApiErrorResponse:

Note: Kernel exceptions use safe static messages. The HasStarted guard prevents errors when response streaming has begun.

Model Validation

Invalid model state is automatically converted to ApiErrorResponse with validation errors:

{
  "correlationId": "abc-123",
  "timestamp": "2026-01-10T00:00:00Z",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "One or more validation errors occurred."
  },
  "validationErrors": [
    { "field": "email", "message": "Email is required." }
  ]
}

Minimal API Support

app.MapGet("/api/items/{id}", GetItemAsync)
   .WithRest<ItemDto>();

app.MapPost("/api/items", CreateItemAsync)
   .WithRestCreate<ItemDto>();

app.MapDelete("/api/items/{id}", DeleteItemAsync)
   .WithRestDelete();

Configuration Options

Dependencies

• HoneyDrunk.Web.Rest.Abstractions (contracts)
• HoneyDrunk.Kernel.Abstractions 0.4.0 (optional, for Grid context and typed exceptions)
• HoneyDrunk.Auth.AspNetCore 0.2.0 (optional, for identity context)
• HoneyDrunk.Transport 0.4.0 (optional, for envelope mapping)
• Microsoft.AspNetCore.App (framework reference)