CleanArch.DevKit.Domain 0.1.0-preview.1

CleanArch.DevKit.Domain

Domain primitives for DDD-style modeling: Entity<TId>, AggregateRoot<TId>, IAggregateRoot, IDomainEvent. Standalone — no dispatcher dependency.

Part of the CleanArch.DevKit toolkit.

Install

dotnet add package CleanArch.DevKit.Domain

Entity

public sealed class User : Entity<Guid>
{
    public string Email { get; private set; }

    private User(Guid id, string email) : base(id) => Email = email;

    public static User Create(string email) => new(Guid.NewGuid(), email);
}

Equality is by runtime type + non-default Id. Transient entities (default Id) are equal only to themselves by reference — the Vaughn-Vernon pattern. GetHashCode falls back to RuntimeHelpers.GetHashCode for transients so they don't collide in dictionaries before persistence.

Id is protected init so persistence frameworks can hydrate via parameterless constructor + property init, while domain code goes through the parameterised constructor.

AggregateRoot + IDomainEvent

public sealed record UserRegistered(Guid UserId, string Email) : IDomainEvent;

public sealed class User : AggregateRoot<Guid>
{
    public string Email { get; private set; }

    private User(Guid id, string email) : base(id)
    {
        Email = email;
        Raise(new UserRegistered(id, email));
    }

    public static User Register(string email) => new(Guid.NewGuid(), email);
}

Raise(IDomainEvent) is protected, DomainEvents is public read-only, ClearDomainEvents() is public for the dispatcher to drain after commit.

IAggregateRoot is a non-generic marker so a UoW can scan DbContext.ChangeTracker (or your persistence equivalent) without needing to know TId.

IDomainEvent is a pure marker with no base interfaces — it does not couple your domain to any dispatcher.

Dispatching events

This package only buffers events on the aggregate. Publishing is the responsibility of your infrastructure layer.

• If you use CleanArch.DevKit.Mediator, install the CleanArch.DevKit.Mediator.Domain bridge — it ships IDomainEventNotification (combines IDomainEvent + INotification) and a typed mediator.PublishDomainEventsAsync(aggregate) extension.
• If you use another dispatcher, write a 15-line helper that iterates aggregate.DomainEvents and feeds your bus.

ValueObject

This package does not ship a ValueObject base. Use C# 14 records — structural equality is native and free.

public sealed record Address(string Street, string City, string ZipCode);

License

MIT — see LICENSE.