PrimusSaaS.MultiTenancy 1.1.0

PrimusSaaS.MultiTenancy

Release status: stable.

Core package for tenant context, resolution contracts, and multi-tenancy options.

The core runtime and package integrations are validated in the current workspace. Remaining work is ecosystem expansion and broader repo hygiene, not a current code-path release blocker.

Validation

• Current workspace validation: 242/242 tests passed on net8.0, net9.0, and net10.0
• Current workspace validation: smoke tests 5/5 passed on net8.0, net9.0, and net10.0
• Current workspace validation: coverage stayed above the configured threshold on all three frameworks (95.45% line / 87.22% branch on net8.0; 95.38% line / 87.22% branch on net9.0 and net10.0)
• Scope boundary: core resolution/isolation/runtime only; tenant provisioning and platform workflows stay outside the core package

Telemetry

• Emits ActivitySource spans for tenant resolution, isolation, propagation, diagnostics, and feature-flag bridge flows.
• Consumers still need to wire their own exporter if they want those spans collected outside the process.
• The package intentionally stays exporter-agnostic and does not force a telemetry backend.

For a verified new-app onboarding path that combines Identity Validator + Multi-Tenancy + RBAC in one ASP.NET Core host, use the Docusaurus guide at /docs/modules/combined-dotnet-integration.

Quick start

builder.Services.AddPrimusMultiTenancy(options =>
{
    options.TenantClaimType = "tid";
    options.TenantHeaderName = "X-Tenant-Id";
    options.TenantRouteKey = "tenantId";
    options.EnableSubdomainResolution = false;
    options.RequireTenantOnAuthenticatedRequests = true;
    options.EnableTenantRateLimiting = true;
    options.RateLimitMaxRequests = 100;
    options.RateLimitWindow = TimeSpan.FromMinutes(1);
});

Options reference

Default resolver precedence

1. Claims (TenantClaimType)
2. Header (TenantHeaderName)
3. Route value (TenantRouteKey)
4. Subdomain — opt-in via EnableSubdomainResolution
5. Active membership via ITenantMembershipStore

Related packages

• PrimusSaaS.MultiTenancy.AspNetCore — middleware pipeline extensions (UsePrimusTenantResolution, UsePrimusTenantIsolation, UsePrimusTenantRateLimiting)
• PrimusSaaS.MultiTenancy.EFCore — write interceptor and ModelBuilder schema enforcement
• PrimusSaaS.MultiTenancy.InMemory — in-memory ITenantMembershipStore for development and tests

New extension points

• TenantContextSnapshot — preferred unified snapshot API for capturing, transporting, and restoring tenant state across request and background execution scopes.
• ITenantRateLimiter — plug in a distributed limiter implementation (for example Redis-backed) to enforce tenant limits across instances.
• ITenantStore helper extensions: SuspendTenantAsync(...), ActivateTenantAsync(...), SoftDeleteTenantAsync(...)
• ITenantMembershipStore helper extension: GetAccessibleTenantsAsync(...) for tenant switcher scenarios
• AddPrimusMultiTenancyMembershipCaching(...) — wraps the registered membership store with IMemoryCache.
• ITenantDataRetentionService — contract for deleting all tenant-owned data during offboarding.
• ITenantFeatureFlagBridge — default bridge to PrimusSaaS.FeatureFlags that fail-closes when no flag service is registered.