KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

maestro

★ 122 Open GitHub ↗

an event store + cqrs

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Maestro

Maestro is an event sourcing _library_. It is inspired by CQRS and re-uses
terminology where appropriate. The divergence from being a CQRS framework is
intentional as Maestro focuses on processing commands in a consistent manner and
replaying events in a consistent order.

Currently, the only storage adapter suited to a multi-node environment is the
`Maestro.Store.Postgres` adapter. The `Maestro.Store.InMemory` adapter exists
for testing purposes only.

## Status
[![Hex](http://img.shields.io/hexpm/v/maestro.svg?style=flat)](https://hex.pm/packages/maestro)
[![Elixir CI](https://github.com/elixir-toniq/maestro/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/elixir-toniq/maestro/actions/workflows/elixir.yml)

Documentation is available [here](https://hexdocs.pm/maestro/).

## Installation

```elixir
def deps do
  [{:maestro, "~> 1.0"}]
end
```

## Database Configuration

Maestro is intended to be used alongside an existing database/ecto repo.

```elixir
config :maestro,
  storage_adapter: Maestro.Store.Postgres,
  repo: MyApp.Repo
```

To generate the migrations for the snapshot and event logs, do:

```bash
mix maestro.create.event_store_migration
```

## Clock Configuration

Maestro derives aggregate and event identifiers from an `HLClock`. By default
the clock's node ID is computed via `HLClock.NodeId.hash/0`. To override it,
configure `:node_id` with either a 64-bit integer or a zero-arity function
returning one:

```elixir
config :maestro,
  node_id: 1

# or

config :maestro,
  node_id: &MyApp.node_id/0
```

## Example

There are three behaviours that make the command/event lifecycle flow:
`Maestro.Aggregate.CommandHandler`, `Maestro.Aggregate.EventHandler`, and
`Maestro.Aggregate.ProjectionHandler`. Modules implementing the command and
event handler behaviours are looked up via a configurable `:command_prefix` and
`:event_prefix` respectively. Projections are reserved for maintaining other
models/representations within the event's transaction.

```elixir
defmodule MyApp.Aggregate do
  use Maestro.Aggregate.Root,
    command_prefix: MyApp.Aggregate.Commands,
    event_prefix: MyApp.Aggregate.Events

def initial_state, do: %{"value" => 0}

def prepare_snapshot(state), do: state

def use_snapshot(_curr, %Maestro.Types.Snapshot{body: state}), do: state
end

defmodule MyApp.Aggregate.Commands.IncrementCounter do

@behaviour Maestro.Aggregate.CommandHandler

alias Maestro.Types.Event

def eval(aggregate, _command) do
    {:ok,
     [
       %Event{
         aggregate_id: aggregate.id,
         type: "counter_incremented",
         body: %{}
       }
     ]}
  end
end

defmodule MyApp.Aggregate.Events.CounterIncremented do

@behaviour Maestro.Aggregate.EventHandler

def apply(state, _event), do: Map.update!(state, "value", &(&1 + 1))
end
```

```elixir
iex(1)> {:ok, id} = MyApp.Aggregate.new()
iex(2)> :ok = MyApp.Aggregate.evaluate(%Maestro.Types.Command{aggregate_id: id, type: "increment_counter", data: %{}})
iex(3)> {:ok, %{"value" => 1}} = MyApp.Aggregate.get(id)
```

maestro

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README