Mehedi.Core.SharedKernel.Net10 2.0.1

Mehedi.Core.SharedKernel

Reusable base classes and interfaces for Domain-Driven Design (DDD) in .NET. Published as two packages — one per target framework.

Installation

.NET 8:

dotnet add package Mehedi.Core.SharedKernel

.NET 10:

dotnet add package Mehedi.Core.SharedKernel.Net10

What's included

Quick start

1. Define an entity

public class Order : BaseEntity<Guid>, IAggregateRoot
{
    public string CustomerName { get; private set; } = string.Empty;

    private Order() { }

    public static Order Place(string customerName)
    {
        var order = new Order { CustomerName = customerName };
        order.AddDomainEvent(new OrderPlacedEvent(order.Id, customerName));
        return order;
    }

    protected override Guid GenerateNewId() => Guid.NewGuid();
}

2. Define a domain event

// AggregateId is string — works with Guid, long, or any key type
public record OrderPlacedEvent(Guid OrderId, string CustomerName)
    : BaseDomainEvent(nameof(OrderPlacedEvent), OrderId.ToString());

3. Define a value object

public sealed class Money : ValueObject
{
    public decimal Amount { get; }
    public string Currency { get; }

    public Money(decimal amount, string currency)
    {
        Amount = amount;
        Currency = currency;
    }

    protected override IEnumerable<object> GetEqualityComponents()
    {
        yield return Amount;
        yield return Currency;
    }
}

4. Define a rich enumeration

public sealed class OrderStatus : Enumerations
{
    public static readonly OrderStatus Pending   = new(1, "Pending");
    public static readonly OrderStatus Confirmed = new(2, "Confirmed");
    public static readonly OrderStatus Shipped   = new(3, "Shipped");

    private OrderStatus(int id, string name) : base(id, name) { }
}

// Usage
var all    = Enumerations.GetAll<OrderStatus>();
var status = Enumerations.FromValue<OrderStatus>(2);       // Confirmed
var same   = Enumerations.FromDisplayName<OrderStatus>("Shipped");

5. Implement a repository

public class OrderRepository : ICommandRepository<Order, Guid>
{
    private readonly AppDbContext _db;
    public OrderRepository(AppDbContext db) => _db = db;

    public async Task<Order?> GetByIdAsync(Guid id, CancellationToken ct = default)
        => await _db.Orders.FindAsync([id], ct);

    public async Task<Order> AddAsync(Order entity, CancellationToken ct = default)
    {
        await _db.Orders.AddAsync(entity, ct);
        return entity;
    }

    // ... other interface members
}

6. Dispatch domain events

// After SaveChangesAsync, dispatch and clear events:
foreach (var evt in order.DomainEvents)
    await mediator.Publish(evt, cancellationToken);

order.ClearDomainEvents();

.NET version matrix

Releasing a new version

git tag v1.0.0 && git push --tags        # stable release
git tag v1.0.0-rc.1 && git push --tags   # pre-release

A single tag publishes both packages. The Net10 package version is always (major+1).minor.patch:

References

• Ardalis.SharedKernel
• Clean Architecture Solution Template
• ASP.NET Core Clean Architecture CQRS