hseeberger/eventsourced
65.5
Adequate · 8 November 2026
3.2k
lines of production code
Rust
primary language
7
measurements over time
What this system is
Features
Add Postgres-backed event projection capability
The \eventsourced-projection\ crate now provides a new module for projecting events to a Postgres database. This includes a \Projection\ struct that manages the lifecycle (run, stop, state retrieval) of a projection via an internal async task, persisting its sequence number (\seq\_no\) in a dedicated \projection\ table. It introduces an \EventHandler\ trait for custom event processing logic within database transactions and handles error strategies and state synchronization.
eventsourced-projection/src · high confidence
Initial release of NATS-backed event log and snapshot store
This change introduces the \eventsourced-nats\ crate, providing \NatsEventLog\ and \NatsSnapshotStore\ implementations for the \eventsourced\ framework. The event log persists events to a NATS JetStream stream, supporting authentication via user/password or credentials files, and verifies sequence numbers on persistence. The snapshot store uses a NATS Key-Value bucket to save and load entity states, serialized using Protocol Buffers. Configuration allows specifying the server address, authentication details, bucket/stream names, and automatic setup of resources on initialization.
eventsourced-nats/src · high confidence
Initial release of eventsourced-nats crate
This entry introduces the \eventsourced-nats\ crate, providing a NATS-based implementation of the \EventLog\ and \SnapshotStore\ traits for the \eventsourced\ library. The release includes the core library code, a \build.rs\ script to compile Protocol Buffers definitions from the \proto\ directory, and documentation files (\README.md\ and \CHANGELOG.md\).
eventsourced-nats · high confidence
New counter example demonstrating event-sourced entity lifecycle
The examples/counter directory now contains a complete, runnable example that showcases the core event-sourcing capabilities. It defines a Counter entity that handles IncreaseCounter and DecreaseCounter commands, emitting corresponding events and managing overflow/underflow errors. The example includes a run function that spawns multiple entities, executes a configurable number of commands against them using an event log and snapshot store, and measures performance, providing a concrete reference for integrating the library's EventSourced trait, Command handling, and persistence mechanisms.
examples/counter · high confidence
New counter examples with JSON logging and snapshot stores
Added new counter examples for NATS and Postgres that initialize JSON-formatted tracing and support snapshot stores alongside event logs. The NATS example uses NatsEventLog and NatsSnapshotStore, while the Postgres example uses PostgresEventLog and PostgresSnapshotStore, both loading configuration via kebab-case and running the shared counter logic.
examples/counter-nats, examples/counter-postgres · high confidence
PostgreSQL backend for event sourcing
Added PostgreSQL implementations for the EventLog and SnapshotStore, allowing users to persist event-sourced state in a Postgres database. The change introduces \PostgresEventLog\ and \PostgresSnapshotStore\ components, along with SQL schema definitions (\create\_event\_log.sql\, \create\_snapshot\_store.sql\) and configuration structs for connection details and table names.
eventsourced-postgres/src · high confidence
Standardized project scaffolding and tooling configuration
The project now includes standardized configuration files to improve developer experience and consistency. A new docker-compose.yaml file provides pre-configured, secure services for NATS and PostgreSQL with health checks, simplifying local environment setup. The justfile introduces consistent commands for checking, formatting, linting, testing, and documentation generation. The .gitignore has been updated to exclude common IDE and environment files. Additionally, the Rust toolchain has been switched from nightly to stable version 1.98.1, and rustfmt.toml has been updated to use edition 2024 with improved import ordering and formatting settings.
(repo-wide) · high confidence
Removals
Event sourcing core library removed
The \src/lib.rs\ file containing the core event sourcing implementation, including the \EventSourced\ trait, \Entity\ struct, and \EntityRef\ proxy, has been deleted from the source tree.
src · high confidence
Removal of NATS-based event log implementation
The NATS-specific event log implementation, including the \NatsEvtLog\ struct, its configuration, and the associated error types, has been removed from the codebase. The \src/event\_log/mod.rs\ module, which previously defined the \EvtLog\ trait and re-exported the NATS module, has also been deleted. This change eliminates the ability to persist and retrieve events via a NATS JetStream backend.
_src/event\log · high confidence
Behavioural changes
New configuration files for NATS and Postgres example applications
Added default configuration files for the counter-nats and counter-postgres examples, defining connection details for event logs and snapshot stores (NATS on localhost:4222 and Postgres on localhost:5432 with specific credentials). The previous standalone nats.rs integration test file has been removed, as its functionality is now covered by the structured example configurations.
examples · high confidence
New pluggable serialization and persistence traits
The library introduces a new modular architecture for event sourcing, defining core traits for persistence and serialization. The \EventLog\ trait handles event persistence and retrieval (by ID or type), while the \SnapshotStore\ trait manages state snapshots, including a \NoopSnapshotStore\ for disabling snapshots. Serialization is abstracted via the \Binarize\ trait, with built-in implementations for \prost\ (Protocol Buffers) and \serde\_json\ provided in the new \binarize\ module. These changes replace previous ad-hoc persistence logic with a unified, feature-gated interface for storing and loading events and snapshots.
eventsourced/src · high confidence
Dependencies
Rust workspace restructured with dependency upgrades and edition 2024
The project has been reorganized into a Cargo workspace containing the core \eventsourced\ library, \eventsourced-nats\ and \eventsourced-postgres\ storage implementations, \eventsourced-projection\, and example applications. The workspace now targets the Rust 2024 edition and centralizes dependency management, introducing significant version upgrades including \async-nats\ to 0.50, \sqlx\ to 0.9, \thiserror\ to 2.0, and \uuid\ to 1.23.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 62 → 66 (+3.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 99 → 99 (-0.0)
- Architecture 100 → 100 (+0.0)
- Maturity 50 → 50 (+0.0)
- Readiness 50 → 69 (+18.2)
- Security 83 → 77 (-6.3)
- Performance 100 → 100 (+0.0)
Resolved (2)
- Medium IaC: WD-COMPOSE-0002 (docker-compose.yaml)
- Medium IaC: WD-COMPOSE-0002 (docker-compose.yaml)
New (3)
- Medium advisory (unmaintained): RUSTSEC-2026-0440 (Cargo.lock)
- Medium vulnerability: [GHSA redacted] (Cargo.lock)
- Outdated: uuid
Changes since last survey
- 10 commits — 8 feature/other, 2 fixes
By area
- (repo) — 5 commits
- (root) — 3 commits
- .github/workflows — 2 commits
Notable commits
- fix: Merge pull request #483 from hseeberger/fix/rustsec-ctutils
- fix: fix(deps): update ctutils for RUSTSEC-2026-0385
- change: Merge pull request #485 from hseeberger/dependabot/github_actions/ci-patch-617f46a057
- change: Merge pull request #486 from hseeberger/build/pin-image-digests
- change: Merge pull request #488 from hseeberger/chore/compose-yaml
- change: Merge pull request #490 from hseeberger/dependabot/github_actions/ci-patch-429fb9bf92
- change: build: pin images by digest
- change: chore: rename docker-compose.yaml to compose.yaml
- change: ci(deps): bump MarcoIeni/release-plz-action
- change: ci(deps): bump the ci-patch group with 3 updates
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
hseeberger/eventsourced was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 8 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 6a824a50e43f4e2d38b429945dbb087a15c4326e — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-45ab2cab63de.