NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist
A lightweight but also all-inclusive event sourcing library with a focus on developer experience
Latest stable
3.22.1
Last release 1 months ago
07 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
97 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Total pull requests resolved: 1
3.22.x bugfix release (patch)
Total pull requests resolved: 1
Feature release (minor)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Total pull requests resolved: 4
3.21.x bugfix release (patch)
Total pull requests resolved: 1
3.21.x bugfix release (patch)
Total pull requests resolved: 1
3.21.x bugfix release (patch)
keep_index used and exact 7281 messages saved thanks to @DanielBaduraTotal pull requests resolved: 1
3.21.x bugfix release (patch)
Total pull requests resolved: 1
3.21.x bugfix release (patch)
Total pull requests resolved: 6
Feature release (minor)
883: export docs directory thanks to @DavidBadura
881: Add some missing docs pieces thanks to @DanielBadura
875: Add frontmatter support for docs formatting, format docs thanks to @DanielBadura
880: Use xdebug instead of pcov as coverage provider thanks to @DanielBadura
Throwable to CommandBus::dispatch @throws thanks to @tuxes3Total pull requests resolved: 8
Feature release (minor)
MissingHeaders if no header found thanks to @DanielBadura--force param to skip the prompt thanks to @BrammmTotal pull requests resolved: 1
3.19..x bugfix release (patch)
Total pull requests resolved: 2
bugfix release (patch)
Total pull requests resolved: 4
Feature release (minor)
Pdo\Pgsql::getNotify if PHP version is >= 8.4 instead of PDO::pgsqlGetNotify. thanks to @DanielBaduraClosure support to testing documentation thanks to @wikando-ckTotal pull requests resolved: 3
Feature release (minor)
Total pull requests resolved: 3
Feature release (minor)
Total pull requests resolved: 2
Feature release (minor)
802: Deprecate `SubscriberHelper` and `SubscriberUtil` and update docs to use a CONST instead thanks to @DanielBadura
Feature release (minor)
SubscriberHelper and SubscriberUtil and update docs to use a CONST instead thanks to @DanielBaduraStoreMigrateCommand from integration repos to ease maintainance thanks to @DanielBaduraTotal pull requests resolved: 0
3.14.x bugfix release (patch)
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 1
3.13.x bugfix release (patch)
Total pull requests resolved: 2
Feature release (minor)
Total pull requests resolved: 1
3.12.x bugfix release (patch)
Total issues resolved: 0
Total pull requests resolved: 1
Total contributors: 1
779: add first previous exception in error detected exception for better stack trace thanks to @DavidBadura
767: do not use deprecated features in getting started thanks to @DavidBadura
Feature release (minor)
767: do not use deprecated features in getting started thanks to @DavidBadura
752: remove RetryOutdatedAggregateCommandBus thanks to @DavidBadura
Total pull requests resolved: 11
Feature release (minor)
event-sourcing:debug thanks to @llavilleTotal pull requests resolved: 3
3.10.x bugfix release (patch)
Total pull requests resolved: 1
3.10.x bugfix release (patch)
### Release Notes for 3.10.2 3.10.x bugfix release (patch) ### 3.10.2 nothing changed
Total pull requests resolved: 1
3.10.x bugfix release (patch)
698: deprecate aggregate id argument resolver thanks to @DavidBadura
Feature release (minor)
700: add retry strategy repository & make it configurable thanks to @DavidBadura
699: add on failed hook in subscription engine thanks to @DavidBadura
628: add php84 support thanks to @DavidBadura
698: deprecate aggregate id argument resolver thanks to @DavidBadura
Total pull requests resolved: 2
Feature release (minor)
Total pull requests resolved: 1
3.8.x bugfix release (patch)
Total pull requests resolved: 8
Feature release (minor)
Total pull requests resolved: 3
Feature release (minor)
Total pull requests resolved: 1
3.6.x bugfix release (patch)
Total pull requests resolved: 1
3.6.x bugfix release (patch)
only retry relevant subscriptions by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/662
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.6.0...3.6.1
648: Remove trace feature which was experimental, deprecate subscriber accessor interface thanks to @DavidBadura
Feature release (minor)
This release has changes that would be classified as BC breaks in our experimental components. Since these features are experimental, we can change the API or remove them completely even in a major release. See our documentation: https://event-sourcing.patchlevel.io/latest/our-backward-compatibility-promise/
The following has changed:
StreamDoctrineDbalStore:
A new required database field called event_id has been added and the fields event have been renamed event_name and payload have been renamed event_payload. Make sure to adjust the migration generation accordingly! In addition, the StreamHeader has been split into the following headers: StreamNameHeader, PlayheadHeader and RecordedOnHeader.
Tracing: This feature has been completely removed.
656: [Experimental] split stream header into 3 separate headers thanks to @DavidBadura
648: Remove trace feature which was experimental, deprecate subscriber accessor interface thanks to @DavidBadura
Total pull requests resolved: 1
3.5.x bugfix release (patch)
Total pull requests resolved: 4
Feature release (minor)
Total pull requests resolved: 7
Feature release (minor)
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 1
Feature release (minor)
602: deprecate doctrine subscriber and add doctrine listener thanks to @DavidBadura
Feature release (minor)
Backwards incompatible release (major)
Upgrade path from 2.x to 3.0.0: https://patchlevel.github.io/event-sourcing-docs/latest/UPGRADE-3.0/ Migrate from MultiTableStore to SingleTableStore (pre-requirement): https://patchlevel.github.io/event-sourcing-docs/2.3/migrate-multi-table-store-to-single-table-store/
Backwards incompatible release (major)
581: make aggregate id type configurable between uuid and string thanks to @DavidBadura
578: improve store criteria thanks to @DavidBadura
547: make the event bus optional thanks to @DavidBadura
540: replace pipeline with subscription engine thanks to @DavidBadura
531: split boot method into boot and setup in subscription engine thanks to @DavidBadura
526: rename projection into subscription thanks to @DavidBadura
514: projector accessor & experimental trace feature thanks to @DavidBadura
511: allow to pause projections thanks to @DavidBadura
508: remove watch server & use event store for watching thanks to @DavidBadura
504: overhaul error handling in projectionist thanks to @DavidBadura
503: overhaul projectionist thanks to @DavidBadura
500: "from now" mode for projections thanks to @DavidBadura
499: add consumer target and replace old projector targets thanks to @DavidBadura
498: allow "subscribe all" in projectors thanks to @DavidBadura
496: Add Message header interface for more decoupling and type safety thanks to @DanielBadura
494: Update Message with headers thanks to @DanielBadura
493: Update OutboxStore schema, extract MessageSerializer from WatchServer thanks to @DavidBadura
491: extract consumer logic and rename outbox consumer into processor thanks to @DavidBadura
487: use aggregate name in message to decouple components thanks to @DavidBadura
475: change listener provider api thanks to @DavidBadura
467: decouple consume and publish in outbox thanks to @DavidBadura
465: refactor default event bus & drop symfony event bus thanks to @DavidBadura
458: add new exceptions for repository & store thanks to @DavidBadura
445: use variadic syntax in pipeline to allow bulk save thanks to @DavidBadura
443: aggregate root id thanks to @DavidBadura
413: add limit and offset support thanks to @DavidBadura
409: Add new show command thanks to @DavidBadura
407: replace event system by throw by error flag in projectionist thanks to @DavidBadura
351: AggregateRoot is now an interface, add behaviour trait, replace hydrator thanks to @DavidBadura
566: improve github php actions thanks to @DavidBadura
537: rename outdated into detached in subscription engine thanks to @DavidBadura
518: use postgres in benchmarks thanks to @DavidBadura
516: add projectionist benchmark thanks to @DavidBadura
402: add dev runner for projectionist thanks to @DavidBadura
throw stream close exception in array stream implementation by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/556
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc8...3.0.0-rc9
allow to pause projections by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/511
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc7...3.0.0-rc8
Update OutboxStore schema, extract MessageSerializer from WatchServer by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/493
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc6...3.0.0-rc7
improve projection errors and traces by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/485
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc5...3.0.0-rc6
Update dependency mkdocs-material to v9.5.6 by @renovate in https://github.com/patchlevel/event-sourcing/pull/471
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc4...3.0.0-rc5
fix show command & add 'end'/'next' method in stream interface by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/468
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc3...3.0.0-rc4
execute archive logic only once by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/460
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc2...3.0.0-rc3
transfrom projector throwable into an array by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/456
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc1...3.0.0-rc2
Add links to external sites in the navigation by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/593
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc16...3.0.0-rc17
refactor uuid implementation & add a test uuid factory by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/584
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc15...3.0.0-rc16
Adjust Aggregate docs by @DanielBadura in https://github.com/patchlevel/event-sourcing/pull/583
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc14...3.0.0-rc15
Typo: fix immutable typo by @ttomdewit in https://github.com/patchlevel/event-sourcing/pull/580
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc13...3.0.0-rc14
Lock file maintenance by @renovate in https://github.com/patchlevel/event-sourcing/pull/469
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc12...3.0.0-rc13
improve aggregate id argument resolver by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/575
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc11...3.0.0-rc12
move cryptography into hydrator by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/572
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc10...3.0.0-rc11
Add more DoctrineDbalStore tests by @DanielBadura in https://github.com/patchlevel/event-sourcing/pull/559
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-rc9...3.0.0-rc10
change attributes into readonly public objects by @DavidBadura in https://github.com/patchlevel/event-sourcing/pull/453
Full Changelog: https://github.com/patchlevel/event-sourcing/compare/3.0.0-beta7...3.0.0-rc1
One column per quarter.