EventStorage 0.0.0-alpha.3

eventstorage

A lightweight event sourcing framework for .Net with event storage of choice.

Overview

eventstorage is a high-performance event sourcing framework built for .Net that allows selecting event storage of choice. Combining consistency with schema flexibility, es aims to make event sourcing simplified for everyone. Currently supports Azure Sql, Postgres and Sql Server.

Prerequisites

eventstorage runs on the stable release of .Net 8 and requires the SDK installed.

https://dotnet.microsoft.com/en-us/download/dotnet/8.0

Use docker to run sqlserver or postgres databases, execute docker-compose.

docker compose --project-name eventstorage up -d

Usage

Simply install EventStorage package.

dotnet add package EventStorage --prerelease

Use AddEventStorage service collection extension.

var connectionString = builder.Configuration["postgresqlsecret"]??
    throw new Exception("No connection defined");

builder.Services.AddEventStorage(asynchandler =>
{
    asynchandler.Schema = "es";
    asynchandler.AddEventSourcing(source =>
    {
        source.SelectEventSource(EventSources.PostgresSql, connectionString);
    });
});

Select your event source of choice from SelectEventSource. Make sure you have defined your connection string.

Define your aggregate

Add your aggregate with AggregateRoot

public class OrderBookingAggregate : AggregateRoot<long> // or Guid
{
    public OrderStatus OrderStatus { get; private set; }
    protected override void Apply(SourcedEvent e)
    {
        this.InvokeApply(e);
    }
    public void Apply(OrderPlaced e)
    {
        OrderStatus = OrderStatus.Placed;
    }
    public void PlaceOrder(PlaceOrder command)
    {
        if(OrderStatus == OrderStatus.Placed)
            return;
        RaiseEvent(new OrderPlaced(command));
    }
}

AggregateRoot allows selecting long or Guid for sourceId, selecting long offers lightnening-fast queries.

To continue please visit our GitHub handle.

Give us a star ⭐

If you are an event sourcer and love OSS, give eventstorage a star. 💜

License

This project is licensed under the terms of MIT license.