Druvino.BuildingBlocks.Inbox.EntityFrameworkCore 0.1.0-preview.5

This is a prerelease version of Druvino.BuildingBlocks.Inbox.EntityFrameworkCore.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Druvino.BuildingBlocks.Inbox.EntityFrameworkCore --version 0.1.0-preview.5
                    
NuGet\Install-Package Druvino.BuildingBlocks.Inbox.EntityFrameworkCore -Version 0.1.0-preview.5
                    
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.Inbox.EntityFrameworkCore" Version="0.1.0-preview.5" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Druvino.BuildingBlocks.Inbox.EntityFrameworkCore" Version="0.1.0-preview.5" />
                    
Directory.Packages.props
<PackageReference Include="Druvino.BuildingBlocks.Inbox.EntityFrameworkCore" />
                    
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.Inbox.EntityFrameworkCore --version 0.1.0-preview.5
                    
#r "nuget: Druvino.BuildingBlocks.Inbox.EntityFrameworkCore, 0.1.0-preview.5"
                    
#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.Inbox.EntityFrameworkCore@0.1.0-preview.5
                    
#: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.Inbox.EntityFrameworkCore&version=0.1.0-preview.5&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Druvino.BuildingBlocks.Inbox.EntityFrameworkCore&version=0.1.0-preview.5&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 and text sends with biz_opaque_callback_data, no-retry outcome classification (accepted, rejected, retryable-not-accepted, ambiguous) with error rules, template listing, 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 (1)

Showing the top 1 NuGet packages that depend on Druvino.BuildingBlocks.Inbox.EntityFrameworkCore:

Package Downloads
Druvino.BuildingBlocks.Persistence.EntityFrameworkCore

EF Core PostgreSQL persistence building blocks for Druvino.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-preview.8 66 10/29/2026
0.1.0-preview.7 67 10/29/2026
0.1.0-preview.6 112 10/28/2026
0.1.0-preview.5 126 10/25/2026
0.1.0-preview.4 217 10/21/2026
0.1.0-preview.3 75 10/20/2026
0.1.0-preview.2 229 9/29/2026
0.1.0-preview.1 495 9/27/2026