LinKit.Tenancy 1.0.0

LinKit.Tenancy

LinKit.Tenancy provides high-performance, Zero-Reflection, and Native AOT compatible multi-tenancy context management and propagation across requests, background tasks, and distributed messaging for LinKit.

🚀 Key Features

• Zero Reflection & Native AOT Ready: 100% Native AOT & Trimming safe with zero dynamic code generation or reflection scanning.
• AsyncLocal Tenant Context: Thread-safe, asynchronous context propagation across async calls via ITenantAccessor and ITenantContext.
• Cross-Service Propagation: Built-in message header injection (TenantPropagation.Inject) and extraction (TenantPropagation.Extract) for event-driven systems (RabbitMQ, Kafka).
• Extensible Context Items: Thread-safe contextual metadata dictionary per tenant context.

📦 Installation

dotnet add package LinKit.Tenancy

🛠️ Usage Guide

1. Register Tenancy Services in Program.cs

using LinKit.Tenancy;

var builder = WebApplication.CreateBuilder(args);

// Register Tenancy services (Singleton TenantAccessor + Scoped TenantContext)
builder.Services.AddLinKitTenancy();

2. Access Tenant in Handlers & Services

using LinKit.Tenancy;

public class GetOrdersByTenantHandler : IQueryHandler<GetOrdersQuery, List<OrderDto>>
{
    private readonly ITenantContext _tenantContext;
    private readonly IOrderRepository _repository;

    public GetOrdersByTenantHandler(ITenantContext tenantContext, IOrderRepository repository)
    {
        _tenantContext = tenantContext;
        _repository = repository;
    }

    public async Task<List<OrderDto>> HandleAsync(GetOrdersQuery query, CancellationToken ct)
    {
        string? currentTenantId = _tenantContext.TenantId;
        return await _repository.GetOrdersForTenantAsync(currentTenantId, ct);
    }
}

3. Propagate Tenant ID into Distributed Messages

using LinKit.Core.Messaging;
using LinKit.Tenancy;

// When publishing integration messages:
var headers = new MessageHeaders();
TenantPropagation.Inject(headers, tenantContext.TenantId);

// When consuming incoming messages:
string? incomingTenantId = TenantPropagation.Extract(headers);
tenantAccessor.Context.TenantId = incomingTenantId;

📄 License

Licensed under the MIT License.