EventStorage 0.0.0-beta.13

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(eventstorage =>
{
    eventstorage.Schema = "es";
    eventstorage.AddEventSource(source =>
    {
        eventsource.Select(EventStore.PostgresSql, connectionString)
        .Project<OrderProjection>(ProjectionMode.Consistent)
        .Project<OrderDocumentProjection>(ProjectionMode.Async, source => source.Redis(conn));
    });
});

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

Define your aggregate

Add your aggregate with EventSource<TId>

public class OrderBooking : EventSource<long> // or Guid
{
    public OrderStatus OrderStatus { get; private set; }
    public void Apply(OrderPlaced e)
    {
        OrderStatus = OrderStatus.Placed;
    }
    public void PlaceOrder(PlaceOrder command)
    {
        if(OrderStatus == OrderStatus.Placed)
            return;
        RaiseEvent(new OrderPlaced(command));
    }
}

EventSource<TId> 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.