Headless.Domain 0.4.15

Headless.Domain

Core domain-driven design abstractions including entities, aggregate roots, value objects, auditing, and messaging interfaces.

Problem Solved

Provides building blocks for implementing DDD patterns: entities with identity, aggregate roots with domain events, value objects, auditing interfaces, and messaging contracts.

Key Features

• Entity Abstractions: IEntity, IEntity<T>, base Entity class
• Aggregate Roots: IAggregateRoot, AggregateRoot with built-in message emission
• Value Objects: ValueObject base class with equality
• Auditing: ICreateAudit, IUpdateAudit, IDeleteAudit, ISuspendAudit
• Concurrency: IHasConcurrencyStamp, IHasETag
• Multi-tenancy: IMultiTenant
• Local Messaging: ILocalMessage, ILocalMessagePublisher, ILocalMessageHandler
• Distributed Messaging: IDistributedMessage, IDistributedMessageEmitter
• Entity Events: EntityCreatedEventData, EntityUpdatedEventData, EntityDeletedEventData

Installation

dotnet add package Headless.Domain

Quick Start

public sealed class Order : AggregateRoot<Guid>, ICreateAudit
{
    public required string CustomerName { get; init; }
    public decimal Total { get; private set; }
    public DateTimeOffset CreatedAt { get; set; }
    public string? CreatedBy { get; set; }

    public void Complete()
    {
        Status = OrderStatus.Completed;
        AddMessage(new OrderCompletedEvent(Id));
    }
}

public sealed record OrderCompletedEvent(Guid OrderId) : ILocalMessage;

Auditing

Implement audit interfaces for automatic tracking:

public sealed class Product : Entity<int>, ICreateAudit, IUpdateAudit
{
    public required string Name { get; set; }
    public DateTimeOffset CreatedAt { get; set; }
    public string? CreatedBy { get; set; }
    public DateTimeOffset? UpdatedAt { get; set; }
    public string? UpdatedBy { get; set; }
}

Value Objects

public sealed class Address : ValueObject
{
    public required string Street { get; init; }
    public required string City { get; init; }

    protected override IEnumerable<object?> GetEqualityComponents()
    {
        yield return Street;
        yield return City;
    }
}

Configuration

No configuration required. This is an abstractions package.

Dependencies

None.

Side Effects

None.