Hexalith.Tenants.Testing 6.0.0

.NET 10.0

dotnet add package Hexalith.Tenants.Testing --version 6.0.0

NuGet\Install-Package Hexalith.Tenants.Testing -Version 6.0.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Hexalith.Tenants.Testing" Version="6.0.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Hexalith.Tenants.Testing" Version="6.0.0" />
                    

                            Directory.Packages.props

<PackageReference Include="Hexalith.Tenants.Testing" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Hexalith.Tenants.Testing --version 6.0.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Hexalith.Tenants.Testing, 6.0.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Hexalith.Tenants.Testing@6.0.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Hexalith.Tenants.Testing&version=6.0.0
                    

                            Install as a Cake Addin

#tool nuget:?package=Hexalith.Tenants.Testing&version=6.0.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Hexalith.Tenants

Multi-tenant management for the Hexalith ecosystem. Built on event sourcing, DAPR, and .NET Aspire, this service provides a complete tenant lifecycle — from creation and user-role assignment to configuration and cross-tenant discovery — through a command-driven API that publishes domain events for downstream integration.

Features

Tenant Lifecycle Management — Create, update, enable, and disable tenants through commands that produce auditable domain events
User-Role Management — Add and remove users from tenants with role-based access (Owner, Contributor, Reader) and role behavior enforcement
Global Administration — Bootstrap a global administrator to authorize initial tenant operations
Tenant Configuration — Set and manage per-tenant key-value configuration with domain events for every change
Tenant Query and Audit APIs — Query tenant lists, tenant details, user memberships, and tenant audit history through protected cursor-paginated endpoints
Tenants Admin UI Foundation — Blazor InteractiveServer UI host composed through FrontComposer for read-only tenant triage, detail, memberships, configuration, and support-safe copy
Event-Driven Integration — Subscribe to tenant domain events (TenantCreated, UserAddedToTenant, etc.) in consuming services via DAPR pub/sub
In-Memory Testing Fakes — Production-parity domain logic with in-memory stores for fast, reliable tests without infrastructure dependencies

Quickstart

Get from clone to your first tenant command after local prerequisites are installed:

Quickstart Guide — prerequisite-validated path for .NET 10, Docker, full DAPR local runtime, AppHost startup, local auth, and the first EventStore command submission.

Deployment Readiness — consolidated operator checklist and evidence template for production-like Tenants deployments, covering auth, DAPR, service invocation, health, command/query paths, and pub/sub recovery boundaries.

Sample Consuming Service Walkthrough — source-backed guide for copying the sample service's event subscription, local projection, access-check, and configuration-read patterns.

Cross-Aggregate Timing — timing-window and eventual-consistency guidance for command status, event publication, subscriber delivery, local projections, stale reads, diagnostics, and fail-closed consumers.

Compensating Commands — explicit correction patterns for mistaken access, role, configuration, and lifecycle changes without hidden undo or event mutation.

See It In Action

Watch reactive cross-service access revocation in action: add a user to a tenant, then remove them — and see the consuming service automatically revoke access via DAPR pub/sub events, with zero custom integration code.

"Aha Moment" Demo — Step-by-step walkthrough with automated scripts in scripts/.

NuGet Packages

Package	Description
`Hexalith.Tenants.Contracts`	Commands, events, enums, and identity types — the shared API surface
`Hexalith.Tenants.Client`	DI registration, event handlers, and client abstractions for consuming services
`Hexalith.Tenants.Server`	Aggregates, projections, and domain processing
`Hexalith.Tenants.Testing`	In-memory fakes and test helpers with production-parity domain logic
`Hexalith.Tenants.Aspire`	.NET Aspire hosting extensions for consuming AppHosts

Normal package builds use EventStore 3.129.0; the compatible 3.129.1 patch and same-binary metadata variants are qualified separately. Contracts includes its compiled route and operation declarations; Server includes its existing declared intent adapter enrollment. These are offline catalog inputs: the composition owner must still activate the catalog through the SDK before traffic is admitted. An activated trusted generation and matching host identity are mandatory for runtime readiness and generated requests. Unconfigured Production returns 503 from /ready and refuses generated requests. The composition owner supplies Production trust through the SDK's existing extension seams; this module does not install a Production trust policy or auto-activate declarations.

This is a runtime migration requirement for the next major release. Upgrade the Contracts and Server packages together, retain their exact catalog inputs and complete trusted activation before directing traffic to the upgraded hosts. When private Development bootstrap is enabled, the composition owner supplies the API host's actual Dapr app ID through EventStore:DomainService:AppId; the host records that exact value in its observation.

Project Structure

src/
  Hexalith.Tenants.AppHost/          # .NET Aspire AppHost — orchestrates the full topology
  Hexalith.Tenants.Api/              # External-facing generated Tenants REST API host
  Hexalith.Tenants.Aspire/           # Aspire hosting extensions for consuming AppHosts
  Hexalith.Tenants.Client/           # Client DI registration and event handling
  Hexalith.Tenants/                  # Domain service host: DAPR-invoked endpoints, EventStore command controllers, auth, validation, bootstrap
  Hexalith.Tenants.Contracts/        # Commands, events, enums, identities
  Hexalith.Tenants.Server/           # Aggregates, projections, domain logic
  Hexalith.Tenants.Testing/          # In-memory fakes and test helpers
  Hexalith.Tenants.UI/               # Blazor InteractiveServer Tenants Admin UI host

tests/
  Hexalith.Tenants.AppHost.Tests/
  Hexalith.Tenants.Client.Tests/
  Hexalith.Tenants.Contracts.Tests/
  Hexalith.Tenants.IntegrationTests/
  Hexalith.Tenants.Server.Tests/
  Hexalith.Tenants.Testing.Tests/
  Hexalith.Tenants.UI.Tests/

samples/
  Hexalith.Tenants.Sample/           # Example consuming service with event subscription
  Hexalith.Tenants.Sample.Tests/

docs/
  quickstart.md                      # Getting started guide
  deployment-readiness.md            # Deployment checklist and evidence template
  production-auth-claim-contract.md  # Production IdP claim mapping contract
  production-auth-readiness.md       # Deployment auth checklist and smoke-test evidence
  demo.md                            # "Aha Moment" demo walkthrough
  event-contract-reference.md        # Event schemas and audit patterns
  compensating-commands.md           # Explicit correction command patterns
  cross-aggregate-timing.md          # Timing windows and eventual consistency
  idempotent-event-processing.md     # Event handling patterns
  sample-consuming-service-walkthrough.md # Sample service adoption walkthrough
  tenants-ui-*.md                    # Phase 2 Admin UI planning, dependency, and evidence specs

scripts/
  demo.ps1                           # PowerShell demo automation
  demo.sh                            # Bash demo automation

Contributing

Branch Naming

feat/<description> — Features and enhancements
fix/<description> — Bug fixes
docs/<description> — Documentation changes

Development Workflow

Fork and clone, then initialize root-declared submodules under references/: git submodule update --init references/Hexalith.EventStore references/Hexalith.Commons references/Hexalith.AI.Tools references/Hexalith.Builds references/Hexalith.FrontComposer references/Hexalith.PolymorphicSerializations references/Hexalith.Memories references/Hexalith.McpCli references/Hexalith.Platform
Create a feature branch from main
Make changes following the code style defined in .editorconfig
Build the solution with dotnet build Hexalith.Tenants.slnx -c Release -warnaserror
Run test projects individually; do not use solution-level dotnet test
Submit a pull request against main

Hexalith.Tenants.slnx remains the canonical development and topology solution. Dependency governance builds Hexalith.Tenants.Standalone.slnx in Release package mode (-p:UseNuGetDeps=true -p:HexalithFrontComposerFromSource=false). That solution contains every owned project and no project or file entries under references/.

Test Requirements

All pull requests must pass the relevant existing test projects. Run test projects individually; the repository selects Microsoft.Testing.Platform for its xUnit 4 projects.

dotnet test tests/Hexalith.Tenants.Contracts.Tests/Hexalith.Tenants.Contracts.Tests.csproj -c Release
dotnet test tests/Hexalith.Tenants.Client.Tests/Hexalith.Tenants.Client.Tests.csproj -c Release
dotnet test tests/Hexalith.Tenants.Testing.Tests/Hexalith.Tenants.Testing.Tests.csproj -c Release
dotnet test tests/Hexalith.Tenants.UI.Tests/Hexalith.Tenants.UI.Tests.csproj -c Release
dotnet test samples/Hexalith.Tenants.Sample.Tests/Hexalith.Tenants.Sample.Tests.csproj -c Release
dotnet test tests/Hexalith.Tenants.AppHost.Tests/Hexalith.Tenants.AppHost.Tests.csproj -c Release
dotnet test tests/Hexalith.Tenants.Server.Tests/Hexalith.Tenants.Server.Tests.csproj -c Release

Integration and server tests require DAPR initialization (dapr init) and the local runtime prerequisites documented in the quickstart.

Hexalith.Tenants.IntegrationTests is the frozen bootstrap compatibility lane and uses the published EventStore Testing.Integration 3.128.4 harness in both package and source builds. Runtime libraries still use source references in the source-reference lane. The newer EventStore source harness consumes Platform environment descriptors exclusively; new suites for that API must declare runner bindings and run through hexalith-module test with HEXALITH_TEST_ENVIRONMENT_PATH. Existing fixture-owned failure injection and cold-bootstrap checks remain in the compatibility lane. Its disposable CI jobs also select EventStore host source 717a06e16c3afd81b904eaf4de646b74b13262d2, the repository revision recorded by the published 3.128.4 packages. These non-packaged executable hosts therefore match the fixture/runtime baseline. The helper also exports SDK 3.128.4 to every subsequent domain/runtime/test build in those jobs. This legacy compatibility profile cannot pack publishable Tenants artifacts. The tracked submodule pin and the source-reference workflow continue to exercise current source.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- ByteAether.Ulid (>= 1.4.2)
- Dapr.Actors (>= 1.19.0)
- Dapr.Actors.AspNetCore (>= 1.19.0)
- Dapr.AspNetCore (>= 1.19.0)
- Dapr.Client (>= 1.19.0)
- FluentValidation (>= 12.2.0)
- Hexalith.Commons.UniqueIds (>= 2.30.7)
- Hexalith.EventStore.Client (>= 3.129.0)
- Hexalith.EventStore.Contracts (>= 3.129.0)
- Hexalith.EventStore.DomainService (>= 3.129.0)
- Hexalith.EventStore.Server (>= 3.129.0)
- Hexalith.McpCli.Abstractions (>= 1.1.0)
- Hexalith.Tenants.Contracts (>= 6.0.0)
- Hexalith.Tenants.Server (>= 6.0.0)
- MediatR (>= 14.2.0)
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 10.0.14)
- Microsoft.AspNetCore.DataProtection.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Configuration (>= 10.0.14)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Diagnostics.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Http (>= 10.0.14)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options (>= 10.0.14)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.14)
- Microsoft.Extensions.ServiceDiscovery (>= 10.11.0)
- Microsoft.IdentityModel.Abstractions (>= 8.23.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.23.0)
- Microsoft.IdentityModel.Logging (>= 8.23.0)
- Microsoft.IdentityModel.Protocols (>= 8.23.0)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.23.0)
- Microsoft.IdentityModel.Tokens (>= 8.23.0)
- OpenTelemetry (>= 1.20.1)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.20.1)
- OpenTelemetry.Extensions.Hosting (>= 1.20.1)
- OpenTelemetry.Instrumentation.AspNetCore (>= 1.20.1)
- OpenTelemetry.Instrumentation.Http (>= 1.20.1)
- OpenTelemetry.Instrumentation.Runtime (>= 1.20.1)
- Shouldly (>= 4.3.0)
- System.IdentityModel.Tokens.Jwt (>= 8.23.0)
- xunit.v3.assert (>= 4.0.2)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
6.0.0	118	10/31/2026
5.11.2	90	10/31/2026
5.11.1	148	10/28/2026
5.11.0	76	10/28/2026
5.10.1	327	10/22/2026
5.10.0	97	10/21/2026
5.9.0	305	10/18/2026
5.8.0	432	10/8/2026
5.7.0	435	9/5/2026
5.6.0	187	8/30/2026
5.5.0	169	8/25/2026
5.4.1	243	8/4/2026
5.4.0	185	8/1/2026
5.3.0	178	7/30/2026
5.2.0	129	7/30/2026
5.1.0	138	7/29/2026
5.0.0	133	7/28/2026
4.0.0	136	7/28/2026
3.2.18	200	7/18/2026
3.2.17	145	7/18/2026