Druvino.BuildingBlocks.MultiTenancy 0.1.0-preview.7

This is a prerelease version of Druvino.BuildingBlocks.MultiTenancy.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Druvino.BuildingBlocks.MultiTenancy --version 0.1.0-preview.7
                    
NuGet\Install-Package Druvino.BuildingBlocks.MultiTenancy -Version 0.1.0-preview.7
                    
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="Druvino.BuildingBlocks.MultiTenancy" Version="0.1.0-preview.7" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Druvino.BuildingBlocks.MultiTenancy" Version="0.1.0-preview.7" />
                    
Directory.Packages.props
<PackageReference Include="Druvino.BuildingBlocks.MultiTenancy" />
                    
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 Druvino.BuildingBlocks.MultiTenancy --version 0.1.0-preview.7
                    
#r "nuget: Druvino.BuildingBlocks.MultiTenancy, 0.1.0-preview.7"
                    
#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 Druvino.BuildingBlocks.MultiTenancy@0.1.0-preview.7
                    
#: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=Druvino.BuildingBlocks.MultiTenancy&version=0.1.0-preview.7&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Druvino.BuildingBlocks.MultiTenancy&version=0.1.0-preview.7&prerelease
                    
Install as a Cake Tool

Druvino Building Blocks

Modular, battle-tested architectural primitives and infrastructure components for building high-throughput, multi-tenant enterprise applications on .NET 10.

License: MIT Target: .NET 10


Overview

Druvino Building Blocks provides a decoupled, opinionated foundation for Domain-Driven Design (DDD), Clean Architecture, transactional outbox/inbox messaging, multi-tenancy, and distributed systems.

Each component is designed with strict boundary isolation, zero circular dependencies, and complete independence from application-specific domain models.


Supported Runtime

  • .NET 10.0 (net10.0) and C# 13+
  • Tested on modern Linux, macOS, and Windows environments

Package Catalog

The suite consists of 16 cohesive packages:

Package Description
Druvino.BuildingBlocks.Domain Pure DDD primitives: AggregateRoot, Entity<TId>, DomainEvent, strongly typed IDs, and fluent Result<T> pattern. Free of external transport or persistence dependencies.
Druvino.BuildingBlocks.Domain.ValueObjects Strongly-typed business value objects with validation: Money, Address, Email, PhoneNumber, Percentage, and DateRange.
Druvino.BuildingBlocks.Abstractions Foundational contracts: ICurrentUser, IAuditLogWriter, ICorrelationIdProvider, IGuidGenerator, ITransactionManager, and background execution abstractions.
Druvino.BuildingBlocks.Application CQRS pipeline behaviors (MediatR), automated FluentValidation pipeline, offset & cursor pagination, and domain event dispatching.
Druvino.BuildingBlocks.Localization Multi-lingual culture resolution, tenant-aware culture providers, and localized string resources.
Druvino.BuildingBlocks.MultiTenancy Multi-tenancy infrastructure: ambient ITenantContext, tenant resolution middleware, tenant store abstractions, and tenant caching.
Druvino.BuildingBlocks.Messaging.Abstractions Core messaging contracts: IEventPublisher, IEventConsumer, message envelopes, metadata enrichment, dead-letter store contracts, and inbox store contracts.
Druvino.BuildingBlocks.Inbox Idempotent consumer engine, pessimistic distributed lease management, and dead-letter handling.
Druvino.BuildingBlocks.Inbox.EntityFrameworkCore PostgreSQL EF Core implementation of the inbox store with high-performance concurrency guards.
Druvino.BuildingBlocks.Outbox Reliable transactional outbox pattern engine: PostgreSQL advisory locking, batch runner, exponential backoff retry, and propagation interceptor.
Druvino.BuildingBlocks.Persistence.EntityFrameworkCore Relational EF Core building blocks: BaseDbContext, automated audit trail interceptors, soft-delete query filters, advisory locks, and Npgsql naming conventions.
Druvino.BuildingBlocks.Messaging Messaging transport implementations: RabbitMQ client and in-memory test pipeline, consumer dispatcher, and dead-lettering.
Druvino.BuildingBlocks.Observability Comprehensive OpenTelemetry (traces, metrics) and Serilog structured logging integration for distributed tracing and health monitoring.
Druvino.BuildingBlocks.Web ASP.NET Core web utilities: standardized BaseApiController, RFC 7807 Problem Details, correlation ID middleware, secure auth cookies, and security auditing.
Druvino.BuildingBlocks.BackgroundProcessing Generic background processing infrastructure, background processor shell, and distributed lock processor baseline.
Druvino.BuildingBlocks.WhatsApp (private: GitHub Packages only) Meta WhatsApp Cloud API client: template sends (body values and an image header by media id or link) and text sends with biz_opaque_callback_data, no-retry outcome classification (accepted, rejected, retryable-not-accepted, ambiguous) with error rules, template listing and single-template reads with each template's structure, sendability and fingerprint, image upload and delete per phone number, and client metrics. Credentials are supplied per call, never stored.

Installation

Install individual packages via the .NET CLI:

dotnet add package Druvino.BuildingBlocks.Domain
dotnet add package Druvino.BuildingBlocks.Persistence.EntityFrameworkCore
dotnet add package Druvino.BuildingBlocks.Outbox

Or via PackageReference in your .csproj:

<ItemGroup>
  <PackageReference Include="Druvino.BuildingBlocks.Domain" Version="0.1.0-preview.1" />
  <PackageReference Include="Druvino.BuildingBlocks.Application" Version="0.1.0-preview.1" />
</ItemGroup>

Architecture & Design Principles

  ┌──────────────────────────────────────────────────────────────┐
  │                        Presentation                          │
  │                  Druvino.BuildingBlocks.Web                  │
  └──────────────┬───────────────────────────────┬───────────────┘
                 │                               │
                 ▼                               ▼
  ┌──────────────────────────────┐┌──────────────────────────────┐
  │         Application          ││       MultiTenancy           │
  │Druvino.BuildingBlocks.       ││Druvino.BuildingBlocks.       │
  │Application                   ││MultiTenancy                  │
  └──────────────┬───────────────┘└──────────────┬───────────────┘
                 │                               │
                 ▼                               ▼
  ┌──────────────────────────────┐┌──────────────────────────────┐
  │       Messaging & Outbox     ││      Persistence EF Core     │
  │Druvino.BuildingBlocks.Outbox ││Druvino.BuildingBlocks.       │
  │Druvino.BuildingBlocks.Inbox  ││Persistence.EntityFrameworkCore│
  └──────────────┬───────────────┘└──────────────┬───────────────┘
                 │                               │
                 ▼                               ▼
  ┌──────────────────────────────────────────────────────────────┐
  │                       Domain & Primitives                    │
  │  Druvino.BuildingBlocks.Domain                               │
  │  Druvino.BuildingBlocks.Domain.ValueObjects                  │
  │  Druvino.BuildingBlocks.Abstractions                         │
  └──────────────────────────────────────────────────────────────┘
  1. Dependency Inversion: Core domain and abstractions have zero external dependencies on transport, database, or web technologies.
  2. Explicit Contracts: Cross-boundary operations communicate via message envelopes and well-typed contracts.
  3. Resilience by Design: Reliable delivery guaranteed through transactional outbox and idempotent inbox pipelines.
  4. Observable by Default: Integrated OpenTelemetry activity sources and meters across messaging, database, and background processing.

Basic Usage

Domain Entity

using Druvino.BuildingBlocks.Domain;

public sealed class CustomerId : StronglyTypedId<Guid>
{
    public CustomerId(Guid value) : base(value) { }
    public static CustomerId New() => new(Guid.NewGuid());
}

public sealed class Customer : AggregateRoot<CustomerId>
{
    public string Name { get; private set; }

    private Customer(CustomerId id, string name) : base(id)
    {
        Name = name;
        RaiseDomainEvent(new CustomerCreatedDomainEvent(id.Value, name));
    }

    public static Customer Create(string name) => new(CustomerId.New(), name);
}

Result Pattern

using Druvino.BuildingBlocks.Domain;

public Result<Customer> RegisterCustomer(string name)
{
    if (string.IsNullOrWhiteSpace(name))
    {
        return Result<Customer>.Failure(Error.Validation("Customer.NameRequired", "Customer name cannot be empty."));
    }

    return Result<Customer>.Success(Customer.Create(name));
}

Versioning Policy

  • All 16 packages are synchronized at the same version.
  • Druvino.BuildingBlocks.WhatsApp is private: it is published only to the organisation's GitHub Packages feed (https://nuget.pkg.github.com/druvinosystems/index.json) for Druvino's own applications, never to NuGet.org. The private list is scripts/private-packages.txt; no public package may depend on a private one.
  • Releases follow Semantic Versioning 2.0.0.
  • Git tags are the single source of truth for release builds:
    • Prerelease: v0.1.0-preview.1 → 0.1.0-preview.1
    • Stable: v1.0.0 → 1.0.0
  • Packages published to NuGet.org are immutable. Once published, a version is never overwritten or deleted.

License

This project is licensed under the MIT License.

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.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Druvino.BuildingBlocks.MultiTenancy:

Package Downloads
Druvino.BuildingBlocks.Persistence.EntityFrameworkCore

EF Core PostgreSQL persistence building blocks for Druvino.

Druvino.BuildingBlocks.Observability

OpenTelemetry and Serilog observability infrastructure for Druvino Building Blocks.

Druvino.BuildingBlocks.Web

Web building blocks (controllers, middleware, problem details, auth cookies, security auditing) for Druvino.

Druvino.BuildingBlocks.Messaging

Messaging implementation (RabbitMQ and In-Memory transports, dispatching, consuming) for Druvino.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-preview.8 78 10/29/2026
0.1.0-preview.7 78 10/29/2026
0.1.0-preview.6 132 10/28/2026
0.1.0-preview.5 142 10/25/2026
0.1.0-preview.4 233 10/21/2026
0.1.0-preview.3 85 10/20/2026
0.1.0-preview.2 243 9/29/2026
0.1.0-preview.1 602 9/27/2026