Cosmos.MultiTenancy 0.2.0

Cosmos.MultiTenancy

Contrato de resolución de tenants para aplicaciones distribuidas .NET 10 del ecosistema Cosmos.

Descripción

Este paquete provee únicamente la abstracción ITenantResolver. No incluye implementaciones concretas — éstas viven en paquetes separados según el origen del TenantId (HTTP headers, JWT claims, etc.):

• Cosmos.MultiTenancy.AspNetCore — TrustedHeadersTenantResolver que lee el TenantId de un header HTTP confiable (default X-Tenant-Id).

La separación entre contrato e implementación permite que las aplicaciones consuman el contrato sin depender de infraestructura concreta (HTTP, DB, JWT, etc.) y que los tests puedan registrar implementaciones in-memory.

Instalación

dotnet add package Cosmos.MultiTenancy

Se instala como dependencia transitiva al usar Cosmos.EventSourcing.CritterStack u otros paquetes del ecosistema que requieran ITenantResolver.

Contrato

namespace Cosmos.MultiTenancy;

public interface ITenantResolver
{
    string TenantId { get; }
}

Una sola propiedad: el identificador del tenant del request o contexto actual.

Uso

El consumidor inyecta ITenantResolver y consulta TenantId:

public class OrderService(ITenantResolver tenantResolver, ICommandRouter commandRouter)
{
    public Task CreateOrderAsync(CreateOrderCommand command, CancellationToken ct)
    {
        var tenantId = tenantResolver.TenantId;
        // ...
        return commandRouter.InvokeAsync(command, ct);
    }
}

Registro en DI

El contrato no se registra automáticamente. El consumidor elige qué implementación usar:

// Para servicios ASP.NET Core con header confiable (default X-Tenant-Id)
builder.Services.AgregarTenantResolverConHeadersConfiables();

// O con header configurable
builder.Services.AgregarTenantResolverConHeadersConfiables(options =>
{
    options.TenantIdHeaderName = "X-Custom-Tenant";
});

Para escenarios sin HTTP (jobs, consoles, tests) hay que implementar ITenantResolver propio y registrarlo manualmente:

public class FixedTenantResolver(string tenantId) : ITenantResolver
{
    public string TenantId { get; } = tenantId;
}

services.AddSingleton<ITenantResolver>(new FixedTenantResolver("dev-tenant"));

Integración con Wolverine

Cosmos.EventSourcing.CritterStack consume ITenantResolver en sus routers (WolverineCommandRouter, WolverineQueryRouter) para invocar Wolverine con el TenantId del request actual:

public class WolverineCommandRouter(IMessageBus messageBus, ITenantResolver tenantResolver)
    : ICommandRouter
{
    public Task InvokeAsync<TCommand>(TCommand command, CancellationToken ct) where TCommand : class
        => messageBus.InvokeForTenantAsync(tenantResolver.TenantId, command, ct);
}

El consumidor debe registrar una implementación de ITenantResolver antes de usar los routers — sin eso, la resolución de DI fallará en runtime.

Casos de uso

• Multi-tenancy en event sourcing: prefijar IDs de agregado con el TenantId para aislar streams.
• Logging con contexto: enriquecer logs con el TenantId del request actual.
• Marten multi-tenant: pasar tenantResolver.TenantId a IDocumentStore.OpenSession(tenantId).

Consideraciones de diseño

• Scope: se recomienda registrar como Scoped para web apps — un resolver por request.
• Aislamiento de datos: este paquete identifica el tenant; el aislamiento real (DB-per-tenant, schema-per-tenant, columna discriminator) lo implementan capas superiores.
• Resolver no encontrado: si IServiceProvider no tiene ITenantResolver registrado, los routers de CritterStack fallarán con InvalidOperationException al inyectar la dependencia.

Requisitos

• .NET 10.0 o superior

Dependencias

Sin dependencias externas.

Paquetes relacionados

• Cosmos.MultiTenancy.AspNetCore — resolver basado en headers HTTP confiables.
• Cosmos.EventSourcing.CritterStack — routers Wolverine que consumen ITenantResolver.

Licencia

Copyright © Cosmos. Todos los derechos reservados.