Cosmos.MultiTenancy.CritterStack 0.2.0

Cosmos.MultiTenancy.CritterStack

Resolver de tenant compuesto para servicios que combinan HTTP y daemon de Wolverine (inbox/outbox) en el mismo proceso.

Descripcion

Cosmos.MultiTenancy.AspNetCore provee TrustedHeadersTenantResolver, que lee el TenantId de un header HTTP. Funciona perfecto en el flujo HTTP, pero falla en handlers ejecutados por el daemon de Wolverine porque ahi no existe HttpContext.

Este paquete completa el cuadro:

• WolverineMessageContextTenantResolver lee el TenantId desde IMessageContext.TenantId, hidratado automaticamente por Wolverine a partir del envelope entrante.
• CompositeTenantResolver prueba un resolver primario (HTTP) y, si tira InvalidOperationException, cae al de message context.
• La extension method AgregarTenantResolverHibrido() registra todo lo necesario para apps que combinan ambos modos.

Instalacion

dotnet add package Cosmos.MultiTenancy.CritterStack

Uso

Apps hibridas (HTTP + daemon Wolverine)

var builder = WebApplication.CreateBuilder(args);

builder.Services.AgregarTenantResolverHibrido();

El header HTTP usado es X-Tenant-Id (decision de diseño del equipo, no es configurable).

Comportamiento del composite

CompositeTenantResolver itera factories en orden:

1. Primer factory: TrustedHeadersTenantResolver (HTTP). Si el scope tiene HttpContext con el header configurado, retorna el valor.
2. Si el primer factory tira InvalidOperationException, prueba el segundo: WolverineMessageContextTenantResolver. Si el scope es un handler de Wolverine con TenantId en el envelope, retorna el valor.
3. Si ninguno resuelve, lanza InvalidOperationException con un AggregateException que detalla las fallas.

Solo InvalidOperationException triggerea el fallback. Cualquier otra excepcion se propaga, evitando enmascarar bugs reales (NRE, errores de config, etc.).

Dependencias

• Cosmos.MultiTenancy.AspNetCore — provee TrustedHeadersTenantResolver.
• WolverineFx — provee IMessageContext y la propagacion automatica del TenantId via envelope.

Paquetes relacionados

• Cosmos.MultiTenancy: contrato ITenantResolver.
• Cosmos.MultiTenancy.AspNetCore: resolver HTTP estricto (sin fallback).
• Cosmos.EventDriven.CritterStack: senders de eventos que consumen ITenantResolver.
• Cosmos.EventSourcing.CritterStack: routers de comandos y queries que consumen ITenantResolver.

Requisitos

• .NET 10.0 o superior
• App ASP.NET Core (requiere Microsoft.AspNetCore.App via dependencia transitiva)

Licencia

Copyright © Cosmos. Todos los derechos reservados.