Hexalith.Tenants.Testing 5.4.1

.NET 10.0

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

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

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="5.4.1" />

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

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

                            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 5.4.1

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

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

#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@5.4.1

#: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=5.4.1
                    

                            Install as a Cake Addin

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

                            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

Project Structure

src/
  Hexalith.Tenants.AppHost/          # .NET Aspire AppHost — orchestrates the full topology
  Hexalith.Tenants.Aspire/           # Aspire hosting extensions for consuming AppHosts
  Hexalith.Tenants.Client/           # Client DI registration and event handling
  Hexalith.Tenants/                  # REST API host, auth, validation, DAPR actors
  Hexalith.Tenants.Contracts/        # Commands, events, enums, identities
  Hexalith.Tenants.Server/           # Aggregates, projections, domain logic
  Hexalith.Tenants.ServiceDefaults/  # Shared service config, OpenTelemetry
  Hexalith.Tenants.Testing/          # In-memory fakes and test helpers
  Hexalith.Tenants.UI/               # Blazor InteractiveServer Tenants Admin UI host

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
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); that solution contains all 17 owned projects and no project or file entries under references/.

Test Requirements

All pull requests must pass the relevant existing test projects. Run test projects individually. With the current .NET 10 SDK, dotnet test can hit the Microsoft.Testing.Platform/VSTest incompatibility recorded in the Epic 2 story evidence; when that happens, build the test project and run its generated xUnit v3 executable from bin/Release/net10.0.

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 build tests/Hexalith.Tenants.UI.Tests/Hexalith.Tenants.UI.Tests.csproj -c Release -m:1 --no-restore
tests/Hexalith.Tenants.UI.Tests/bin/Release/net10.0/Hexalith.Tenants.UI.Tests -noLogo -noColor -parallel none

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

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.0)
- Dapr.Actors (>= 1.18.5)
- Dapr.Actors.AspNetCore (>= 1.18.5)
- Dapr.Client (>= 1.18.5)
- FluentValidation (>= 12.1.1)
- Hexalith.Commons.UniqueIds (>= 2.30.0)
- Hexalith.EventStore.Client (>= 3.89.0)
- Hexalith.EventStore.Contracts (>= 3.89.0)
- Hexalith.EventStore.Server (>= 3.89.0)
- Hexalith.Tenants.Contracts (>= 5.4.1)
- Hexalith.Tenants.Server (>= 5.4.1)
- MediatR (>= 14.2.0)
- Microsoft.AspNetCore.DataProtection.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Configuration (>= 10.0.10)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Diagnostics.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Http (>= 10.0.10)
- Microsoft.Extensions.Http.Resilience (>= 10.8.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Options (>= 10.0.10)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.10)
- Microsoft.IdentityModel.Abstractions (>= 8.22.0)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.22.0)
- Microsoft.IdentityModel.Logging (>= 8.22.0)
- Microsoft.IdentityModel.Tokens (>= 8.22.0)
- Shouldly (>= 4.3.0)
- xunit.v3.assert (>= 3.2.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
5.4.1	34	8/4/2026
5.4.0	135	8/1/2026
5.3.0	133	7/30/2026
5.2.0	89	7/30/2026
5.1.0	99	7/29/2026
5.0.0	101	7/28/2026
4.0.0	98	7/28/2026
3.2.18	163	7/18/2026
3.2.17	110	7/18/2026
3.2.16	107	7/17/2026
3.2.15	100	7/17/2026
3.2.14	101	7/17/2026
3.2.13	113	7/16/2026
3.2.12	106	7/16/2026
3.2.11	112	7/16/2026
3.2.10	123	7/15/2026
3.2.9	96	7/14/2026
3.2.8	108	7/14/2026
3.2.7	107	7/14/2026
3.2.6	107	7/14/2026