Headless.Core 0.4.15

.NET 10.0

dotnet add package Headless.Core --version 0.4.15

NuGet\Install-Package Headless.Core -Version 0.4.15

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="Headless.Core" Version="0.4.15" />

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

<PackageVersion Include="Headless.Core" Version="0.4.15" />
                    

                            Directory.Packages.props

<PackageReference Include="Headless.Core" />
                    

                            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 Headless.Core --version 0.4.15

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

#r "nuget: Headless.Core, 0.4.15"

#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 Headless.Core@0.4.15

#: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=Headless.Core&version=0.4.15
                    

                            Install as a Cake Addin

#tool nuget:?package=Headless.Core&version=0.4.15
                    

                            Install as a Cake Tool

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

Headless.Core

Core abstractions and utilities for building applications with multi-tenancy, user context, and cross-cutting concerns.

Problem Solved

Provides standardized interfaces for common cross-cutting concerns (clock, user, tenant, locale, timezone conversion) and utilities (retry logic, compression, structured logging) enabling consistent patterns across all application layers.

Key Features

Abstractions:
- IClock - Testable time abstraction (wraps TimeProvider)
- ICurrentUser - Current authenticated user context with roles and claims
- ICurrentTenant - Multi-tenancy support with scoped tenant switching
- ITenantWriteGuardBypass - Explicit bypass scope for audited host/admin tenant writes
- CrossTenantWriteException - Non-transient exception for blocked tenant-owned writes
- ICurrentLocale - Localization context (language, locale, culture)
- ICurrentTimeZone - Timezone handling
- ICurrentPrincipalAccessor - Scoped ClaimsPrincipal access with temporary switching
- IPasswordGenerator - Configurable secure password generation
- ICancellationTokenProvider - Cancellation token access with fallback logic
- ITimezoneProvider - Windows/IANA timezone conversion and listing
- IApplicationInformationAccessor / IBuildInformationAccessor - Application metadata and build info
- IEnumLocaleAccessor - Localized enum display values
- IHaveLogger / IHaveTimeProvider - Mixin interfaces for logger and time provider access
Utilities:
- Run - Retry helper with exponential backoff (WithRetriesAsync, DelayedAsync)
- SnappyCompressor - Snappy compression/decompression with JSON serialization (AOT-compatible)
- LogState / LoggerExtensions - Structured logging with fluent state builder, tags, and scoped properties

Installation

dotnet add package Headless.Core

Quick Start

public sealed class OrderService(IClock clock, ICurrentUser user, ICurrentTenant tenant)
{
    public Order CreateOrder(CreateOrderRequest request)
    {
        return new Order
        {
            Id = Guid.NewGuid(),
            UserId = user.UserId!.Value,
            TenantId = tenant.Id,
            CreatedAt = clock.UtcNow,
            Total = new Money(request.Amount, request.Currency)
        };
    }
}

Structured Logging

logger.LogInformation(
    s => s.Tag("orders").Property("orderId", orderId),
    "Order {OrderId} created",
    orderId
);

Retry with Backoff

var result = await Run.WithRetriesAsync(
    async ct => await httpClient.GetAsync(url, ct),
    maxAttempts: 3,
    logger: logger
);

Configuration

No configuration required. Implementations are registered by Headless.Api or other host packages.

Dependencies

Headless.Checks
Headless.Extensions
Headless.Serializer.Json
Microsoft.Extensions.Logging.Abstractions
Snappier

Side Effects

None.

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
- CommunityToolkit.HighPerformance (>= 8.4.2)
- Headless.Checks (>= 0.4.15)
- Headless.Extensions (>= 0.4.15)
- Headless.Serializer.Json (>= 0.4.15)
- Humanizer.Core (>= 3.0.10)
- IdGen (>= 3.0.7)
- JetBrains.Annotations (>= 2025.2.4)
- libphonenumber-csharp (>= 9.0.30)
- Microsoft.Bcl.TimeProvider (>= 10.0.8)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.8)
- morelinq (>= 4.4.0)
- Nito.AsyncEx (>= 5.1.2)
- Nito.Disposables (>= 2.5.0)
- Polly.Core (>= 8.6.6)
- Snappier (>= 1.3.1)
- System.Reactive (>= 6.1.0)
- TimeZoneConverter (>= 7.2.0)

NuGet packages (7)

Showing the top 5 NuGet packages that depend on Headless.Core:

Package	Downloads
Headless.Api.Abstractions Package Description	65
Headless.Blobs.Azure Package Description	64
Headless.Features.Core Package Description	63
Headless.Api.Core Package Description	61
Headless.Blobs.Aws Package Description	61