IronAlpine.Kernel 0.2.3

IronAlpine.Kernel

IronAlpine.Kernel provides reusable domain and application primitives for .NET microservices and modular systems.

Install

dotnet add package IronAlpine.Kernel

Target Frameworks

• net9.0
• net10.0

What Is Included

• Result / Result<T> and Error
• ValidationError and ErrorType
• Entity<TId> and Entity (Guid specialization)
• ProjectionEntity<TId> and ProjectionEntity
• IDomainEvent / DomainEvent
• ValueObject
• Enumeration<TEnum>
• Specification<T> and evaluator helpers
• PagedResult<T> and PagedRequest
• Base exception hierarchy (BaseException, DomainException, ApplicationException, InfrastructureException, PersistenceException)
• StronglyTypedId<TValue>
• IClock and SystemClock

Result Pattern

using IronAlpine.Kernel.Results;

public static Result<int> Divide(int left, int right)
{
    if (right == 0)
    {
        return Result.Failure<int>(
            Error.Validation(
                code: "Math.DivideByZero",
                message: "Right operand cannot be zero.",
                validationErrors: [new ValidationError("right", "Must be non-zero")]
            ));
    }

    return Result.Success(left / right);
}

Result Conversions

Result<string> ok = "payload";      // implicit: payload -> Result<string>
Result<string> fail = (string?)null; // implicit: null -> Failure(Error.NullValue)

var value = (string)ok; // explicit: Result<string> -> string (throws on failure)

ValueObject

using IronAlpine.Kernel.Primitives;

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;
    }
}

Enumeration

using IronAlpine.Kernel.Primitives;

public sealed class UserStatus : Enumeration<UserStatus>
{
    public static readonly UserStatus Active = new(1, "Active");
    public static readonly UserStatus Passive = new(2, "Passive");

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

var strict = UserStatus.FromValue(1);               // throws if not found
var softById = UserStatus.FromValueOrDefault(999);  // null if not found
var softByName = UserStatus.FromNameOrDefault("x");

Exceptions

using IronAlpine.Kernel.Exceptions;

throw new DomainException(
    message: "Business rule violated.",
    code: "Domain.RuleViolation");

Important Serialization Note

Result and Result<T> are not designed as a JSON roundtrip contract.

Recommended approach:

• serialize the payload (T) to cache/message
• recreate wrapper on read (Result.Success(payload) or Result.Failure(...))

Avoid serializing Result<T> wrapper instances directly.

License

MIT