Cosmos.MultiTenancy.CritterStack 3.0.0

Cosmos.MultiTenancy.CritterStack

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

Descripcion

Cosmos.MultiTenancy.AspNetCore provee TrustedHeadersTenantContext, que lee la identidad de headers 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:

• WolverineMessageTenantContext lee el TenantId desde IMessageContext.TenantId, hidratado automaticamente por Wolverine a partir del envelope entrante. El UserId y el OrganizationMembershipId se leen de los headers user_id y organization_membership_id del envelope, adjuntados por los senders de Cosmos.EventDriven.CritterStack (Wolverine no los propaga de forma nativa como al TenantId).
• CompositeTenantContext prueba un contexto primario (HTTP) y, si tira InvalidOperationException, cae al de message context.
• La extension method AgregarTenantContextHibrido() 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.AgregarTenantContextHibrido();

Los headers HTTP usados son X-Tenant-Id, X-User-Id y X-Organization-Membership-Id (decision de diseño del equipo, no son configurables).

Comportamiento del composite

CompositeTenantContext itera factories en orden:

1. Primer factory: TrustedHeadersTenantContext (HTTP). Si el scope tiene HttpContext con el header configurado, retorna el valor.
2. Si el primer factory tira InvalidOperationException, prueba el segundo: WolverineMessageTenantContext. 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 TrustedHeadersTenantContext.
• WolverineFx — provee IMessageContext y la propagacion automatica del TenantId via envelope.

Paquetes relacionados

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

Requisitos

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

Licencia

Copyright © Cosmos. Todos los derechos reservados.