Repository navigation

Add firefly/eventsourcing: event store, snapshots, projections and event-sourced orchestration - #18

Merged

ancongui merged 34 commits into

mainfrom

feat/eventsourcing

Oct 13, 2026

Merged

Add firefly/eventsourcing: event store, snapshots, projections and event-sourced orchestration#18
ancongui merged 34 commits into
mainfrom
feat/eventsourcing

Commits on Oct 13, 2026
- feat(eventsourcing): add the firefly/eventsourcing package and register it in every package list
  Andres Contreras
  committed
  944e504
- feat(eventsourcing): read firefly.eventsourcing.* once and refuse what the package cannot honour
  Andres Contreras
  committed
  d6727f2
- feat(eventsourcing): define the EventStore port, the event envelope with its metadata and the eventsourcing exceptions
  Andres Contreras
  committed
  e9bf70e
- feat(eventsourcing): upcast stored events through a type-and-version chain with priorities
  Andres Contreras
  committed
  b87a7e0
- feat(eventsourcing): add the memory event store and the contract every event store passes
  Andres Contreras
  committed
  42e477b
- fix(eventsourcing): match the readAll filter against the stored event before upcasting
  Andres Contreras
  committed
  8804e0a
- feat(eventsourcing): add the database event store, numbered in commit order and translating racing appends into ConcurrencyException
  Andres Contreras
  committed
  011f742
- fix(eventsourcing): take the SQLite write lock before the head check so concurrent appenders wait instead of failing with SQLITE_BUSY
  Andres Contreras
  committed
  c749a9b
- test(eventsourcing): prove the event store, racing appenders and late committers on PostgreSQL, MySQL, MariaDB, SQL Server and SQLite
  Andres Contreras
  committed
  4ddb008
- feat(eventsourcing): compile #[EventType] events into a registry and map them to stored events without reflection
  Andres Contreras
  committed
  fa99716
- fix(eventsourcing): refuse a convention-mapped event whose constructor parameters and public properties differ, so nothing is stored that cannot be read back
  Andres Contreras
  committed
  e130046
- fix(eventsourcing): read a pure enum back by its case name and refuse at scan time a convention-mapped parameter type the mapper cannot rebuild
  Andres Contreras
  committed
  dc4784a
- fix(eventsourcing): refuse at scan time a convention-mapped union with a class member or an intersection, which the mapper would hand the raw stored value
  Andres Contreras
  committed
  c5b1270
- feat(cli): compile the event-sourcing manifest in firefly:cache and recount the sixteen artifacts it writes
  Andres Contreras
  committed
  d06b954
- feat(eventsourcing): add the event-sourced aggregate base with convention handlers, versions and history replay
  Andres Contreras
  committed
  5bfa852
- feat(eventsourcing): add memory and database snapshot stores with keep-count retention and an every-N policy
  Andres Contreras
  committed
  19bdc45
- feat(eventsourcing): add the snapshot-aware repository, metadata contributors and tenant-scoped streams
  Andres Contreras
  committed
  559f20a
- feat(eventsourcing): publish appended events through the outbox in the same transaction, or after commit
  Andres Contreras
  committed
  15b535d
- feat(eventsourcing): auto-configure the stores, the repository support and the migrations, proven through the real pipeline
  Andres Contreras
  committed
  e72663d
- test(eventsourcing): prove same-transaction outbox publishing and after-commit publishing through the real pipeline and on every server
  Andres Contreras
  committed
  4677728
- feat(eventsourcing): add the projection port, function projections and fenced memory and database checkpoint stores
  Andres Contreras
  committed
  c94512b
- fix(eventsourcing): fence a late checkpoint advance on MariaDB snapshot isolation as a checkpoint conflict
  Andres Contreras
  committed
  269932c
- feat(eventsourcing): run projections under a DistributedLock lease with fenced checkpoints, catch-up, live mode and rebuild
  Andres Contreras
  committed
  f3d00fc
- feat(eventsourcing): auto-configure the projection runner, report projection lag in an eventsourcing health component and add the projection commands
  Andres Contreras
  committed
  d26f383
- feat(eventsourcing): model an orchestration execution as an event-sourced aggregate that replays its checkpoints exactly
  Andres Contreras
  committed
  e796468
- feat(eventsourcing): add the event-sourced orchestration execution store with an inline, rebuildable read model
  Andres Contreras
  committed
  f927164
- feat(eventsourcing): supply firefly.orchestration.persistence.provider=event-sourced, proven by W2's capstones and contract on every server
  Andres Contreras
  committed
  ade779e
- test(eventsourcing): prove event-sourced orchestration runs across tenants and with none when tenancy is enabled
  Andres Contreras
  committed
  9827e1f
- docs(eventsourcing): document event sourcing, its database support and the event-sourced orchestration provider
  Andres Contreras
  committed
  3865e76
- docs(eventsourcing): state the at-most-once guarantee of after-commit publishing
  Andres Contreras
  committed
  5ef593c
- docs(eventsourcing): stop calling event sourcing future work in the README roadmap
  Andres Contreras
  committed
  a5d9e76
- docs(cqrs): link the shipped event-sourcing projections instead of a future package
  Andres Contreras
  committed
  43ee4fd
- docs(cqrs): point the package README at the shipped eventsourcing projections
  Andres Contreras
  committed
  8266f98
- Merge remote-tracking branch 'origin/main' into feat/eventsourcing
  Andres Contreras
  committed
  dff83a2

Commits

Commits on Oct 13, 2026