Druvino.BuildingBlocks.Localization
0.1.0-preview.6
See the version list below for details.
dotnet add package Druvino.BuildingBlocks.Localization --version 0.1.0-preview.6
NuGet\Install-Package Druvino.BuildingBlocks.Localization -Version 0.1.0-preview.6
<PackageReference Include="Druvino.BuildingBlocks.Localization" Version="0.1.0-preview.6" />
<PackageVersion Include="Druvino.BuildingBlocks.Localization" Version="0.1.0-preview.6" />
<PackageReference Include="Druvino.BuildingBlocks.Localization" />
paket add Druvino.BuildingBlocks.Localization --version 0.1.0-preview.6
#r "nuget: Druvino.BuildingBlocks.Localization, 0.1.0-preview.6"
#:package Druvino.BuildingBlocks.Localization@0.1.0-preview.6
#addin nuget:?package=Druvino.BuildingBlocks.Localization&version=0.1.0-preview.6&prerelease
#tool nuget:?package=Druvino.BuildingBlocks.Localization&version=0.1.0-preview.6&prerelease
Druvino Building Blocks
Modular, battle-tested architectural primitives and infrastructure components for building high-throughput, multi-tenant enterprise applications on .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 │
└──────────────────────────────────────────────────────────────┘
- Dependency Inversion: Core domain and abstractions have zero external dependencies on transport, database, or web technologies.
- Explicit Contracts: Cross-boundary operations communicate via message envelopes and well-typed contracts.
- Resilience by Design: Reliable delivery guaranteed through transactional outbox and idempotent inbox pipelines.
- 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.WhatsAppis 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 isscripts/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
- Prerelease:
- 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 | Versions 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. |
-
net10.0
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Druvino.BuildingBlocks.Localization:
| Package | Downloads |
|---|---|
|
Druvino.BuildingBlocks.Persistence.EntityFrameworkCore
EF Core PostgreSQL persistence building blocks for Druvino. |
|
|
Druvino.BuildingBlocks.Web
Web building blocks (controllers, middleware, problem details, auth cookies, security auditing) for Druvino. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0-preview.8 | 73 | 10/29/2026 |
| 0.1.0-preview.7 | 70 | 10/29/2026 |
| 0.1.0-preview.6 | 124 | 10/28/2026 |
| 0.1.0-preview.5 | 137 | 10/25/2026 |
| 0.1.0-preview.4 | 231 | 10/21/2026 |
| 0.1.0-preview.3 | 82 | 10/20/2026 |
| 0.1.0-preview.2 | 230 | 9/29/2026 |
| 0.1.0-preview.1 | 502 | 9/27/2026 |