EricksonLopez.SharedKernel 2.0.0

EricksonLopez.SharedKernel

A minimal, high-performance Shared Kernel for DDD-based .NET applications. Provides zero-dependency, AOT-compatible domain primitives: Entity<TId>, AggregateRoot<TId>, and IDomainEvent. Designed for Clean Architecture and CQRS.

⚡ Performance

BenchmarkDotNet v0.14.0 · .NET 10.0 · X64 RyuJIT AVX-512F+CD+BW+DQ+VL+VBMI

Focus: Extreme low allocation for domain event sourcing.

Event Sourcing — Lazy Allocation

Key takeaways:

• Zero-allocation domain events collection until the first event is raised.
• Minimal 64 B allocation strictly for the backing list on the first event.
• O(1) clearing of events with absolutely zero allocations.

→ Performance Guide

Key Features

• Zero Dependencies: Keep your core domain pure. No third-party dependencies.
• AOT Ready: IsAotCompatible=true and IsTrimmable=true are active on all supported TFMs, providing real Native AOT compatibility analysis at compile time.
• Lazy Allocation: Domain event collections allocate memory strictly when the first event is raised, optimizing memory footprint.
• Identity Equality: Pre-optimized GetHashCode() and equality operators (==, !=) out of the box for Domain Entities.

What's Included

.NET Framework Support Policy

All library packages target net8.0, net9.0, and net10.0.

Support Policy: This library supports only .NET frameworks with active official support from Microsoft. A framework version is included in TargetFrameworks as long as it appears on the Microsoft .NET Support Policy page under Active or Maintenance status. Framework versions are removed from TargetFrameworks when they reach their official end-of-life date as defined by Microsoft — not before, and not after.

Framework	Type	Microsoft Support End Date	Status
.NET 8	LTS	November 10, 2026	✅ Supported
.NET 9	STS	November 10, 2026	✅ Supported
.NET 10	LTS	November 2028	✅ Supported

Quick Start

1. Install the package:

   dotnet add package EricksonLopez.SharedKernel
   

2. Start using the domain primitives:

   using EricksonLopez.SharedKernel;
   
   // 1. Define a domain event
   public sealed record OrderPlacedEvent(Guid OrderId) : IDomainEvent;
   
   // 2. Define an Aggregate Root
   public sealed class Order : AggregateRoot<Guid>
   {
       private Order() { }
   
       public static Order Place(Guid id)
       {
           var order = new Order { Id = id };
           order.RaiseDomainEvent(new OrderPlacedEvent(id));
           return order;
       }
   }
   
   // 3. Use it
   var order = Order.Place(Guid.NewGuid());
   Console.WriteLine(order.DomainEvents.Count); // 1
   order.ClearDomainEvents();
   

Showcase

The repository includes a runnable reference project at samples/EricksonLopez.SharedKernel.Sample/. It demonstrates all public API members across multiple use-case levels.

dotnet run --project samples/EricksonLopez.SharedKernel.Sample/EricksonLopez.SharedKernel.Sample.csproj

Documentation

Contributing

See CONTRIBUTING.md for information on building the project, running tests, and contributing guidelines.

Security

Please review SECURITY.md for details on our security policies and how to report vulnerabilities.

Code of Conduct

We follow the Contributor Covenant. See CODE_OF_CONDUCT.md for details.

License

This project is licensed under the MIT License — see the LICENSE file for details.