Modrich.Web 0.1.0

Modrich.Web

Host-side web helpers for Modrich on .NET 10. Sits between the Tier 1 abstractions and the concrete host. Modules do not reference this package.

What's in the box

• GlobalExceptionHandlingMiddleware — catches unhandled exceptions and writes a JSON envelope ({ StatusCode, Message }). Maps common exception types:
  • ArgumentException → 400
  • KeyNotFoundException → 404
  • UnauthorizedAccessException → 401
  • anything else → 500 with a generic message
• CultureEndpoints.MapCultureEndpoints(endpoints) — registers GET /Culture/Set?culture=fr&redirectUri=/ which writes the ASP.NET Core localization cookie and local-redirects back.

Install

dotnet add package Modrich.Web

Usage — JSON exception middleware on /api only

The middleware emits JSON, so wire it on the API branch only — HTML routes should keep the standard exception handler so Blazor can render its own error page.

using Modrich.Web.Middleware;

var app = builder.Build();

app.UseExceptionHandler("/error");          // HTML routes
app.UseHsts();

app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/api"), branch =>
{
    branch.UseMiddleware<GlobalExceptionHandlingMiddleware>();
});

app.Run();

Response shape on failure:

{ "StatusCode": 404, "Message": "Order 42 not found." }

Usage — culture switcher

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Options;
using Modrich.Web.Endpoints;

var supported = new[] { "en", "fr", "de" };
builder.Services.Configure<RequestLocalizationOptions>(o =>
{
    o.SetDefaultCulture("en")
     .AddSupportedCultures(supported)
     .AddSupportedUICultures(supported);
});

var app = builder.Build();

app.UseRequestLocalization(app.Services.GetRequiredService<IOptions<RequestLocalizationOptions>>().Value);

app.MapCultureEndpoints();   // GET /Culture/Set?culture=fr&redirectUri=/

app.Run();

A language switcher link:

<a href="/Culture/Set?culture=fr&redirectUri=@Uri.EscapeDataString(currentPath)">Français</a>

The endpoint writes a one-year IsEssential = true, SameSite = Lax cookie via CookieRequestCultureProvider.MakeCookieValue(...), then issues a LocalRedirect back to redirectUri (defaults to /).

Related packages

• Modrich.Abstractions / Modrich.Modularity — the host you're configuring most likely uses these.

Versioning

Strict semver. EnablePackageValidation is on.

License

MIT.