skills/docs/networking/events/event-sourcing

@suaveplan/event-sourcing - Event sourcing patterns: aggregate root, typed event store, snapshot support, projections, upcasting, and OTel instrumentation

Summary

Event sourcing patterns for Suaveplan: typed aggregate root, in-memory event store with optimistic concurrency, snapshot support, projections, upcasting, and OTel instrumentation.

Documentation tree

• aggregate — (no submodules)
  • aggregate — (no submodules)
• aggregate-repository — (no submodules)
  • aggregate-repository — (no submodules)
• event-store — (no submodules)
  • memory-event-store — (no submodules)
• errors — (no submodules)
  • event-sourcing-error — (no submodules)
• builder — (no submodules)
  • builder — (no submodules)
• schemas — (no submodules)
  • event-sourcing.schemas — (no submodules)
• upcaster — (no submodules)
  • upcaster — (no submodules)

- [aggregate](./src/core/aggregate/aggregate.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [memory-event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [errors](./src/errors/event-sourcing-error.md) — _(no submodules)_- [event-sourcing-error](./src/errors/event-sourcing-error.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_- [schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [event-sourcing.schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_- [aggregate](./src/core/aggregate/aggregate.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [memory-event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [errors](./src/errors/event-sourcing-error.md) — _(no submodules)_- [event-sourcing-error](./src/errors/event-sourcing-error.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_- [schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [event-sourcing.schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_- [aggregate](./src/core/aggregate/aggregate.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [memory-event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [errors](./src/errors/event-sourcing-error.md) — _(no submodules)_- [event-sourcing-error](./src/errors/event-sourcing-error.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_- [schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [event-sourcing.schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_- [aggregate](./src/core/aggregate/aggregate.md) — _(no submodules)_- [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_ - [aggregate-repository](./src/core/aggregate-repository/aggregate-repository.md) — _(no submodules)_- [event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_ - [memory-event-store](./src/core/event-store/memory-event-store.md) — _(no submodules)_- [errors](./src/errors/event-sourcing-error.md) — _(no submodules)_ - [event-sourcing-error](./src/errors/event-sourcing-error.md) — _(no submodules)_- [builder](./src/projection/builder/builder.md) — _(no submodules)_ - [builder](./src/projection/builder/builder.md) — _(no submodules)_- [schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_ - [event-sourcing.schemas](./src/schemas/event-sourcing.schemas.md) — _(no submodules)_- [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_ - [upcaster](./src/upcasting/upcaster/upcaster.md) — _(no submodules)_

Modules

• Aggregate — abstract base class for event-sourced aggregates
• MemoryEventStore — in-memory EventStore with concurrency control
• AggregateRepository — load/save orchestrator with snapshot support
• ProjectionBuilder — declarative read-model projections
• Upcaster — event schema migration registry
• EventSourcingError — structured errors with stable codes
• Schemas — Zod schemas for all wire types
• Types — shared TypeScript interfaces

Quick Start

import {
  Aggregate,
  createMemoryEventStore,
  createAggregateRepository,
  createProjection,
} from "@suaveplan/event-sourcing";
import type { DomainEvent } from "@suaveplan/event-sourcing";

class OrderAggregate extends Aggregate<{ total: number }> {
  constructor(id: string) { super(id, { total: 0 }); }
  place(total: number) { this.raise("OrderPlaced", { total }); }
  protected applyEvent(e: DomainEvent) {
    if (e.type === "OrderPlaced") {
      this.state = { total: (e.payload as { total: number }).total };
    }
  }
  get total() { return this.state.total; }
}

const store = createMemoryEventStore();
const repo = createAggregateRepository({ store, factory: (id) => new OrderAggregate(id) });

const order = new OrderAggregate("order-1");
order.place(250);
await repo.save(order);

const loaded = await repo.load("order-1");
console.log(loaded.total); // 250