Compatibility, upgrades, and checks
Requirements for 2.0.1
triangle/events 2.0.1 requires PHP ^8.1, triangle/engine ^9.0, and psr/log ^2.0 || ^3.0. Engine 8 is outside the supported dependency range. If an application still uses Engine 8, plan the Engine upgrade first; do not bypass the constraint with a forced install.
Install this release with:
composer require triangle/events:^2.0
composer show triangle/events triangle/engine
Changes in 2.0.1
Version 2.0.0 could access the event logger before safe initialization when a listener threw. Version 2.0.1 fixes logger initialization and extends tests/engine_compatibility.php to verify that a listener exception is returned and does not escape emit().
Integration changes
The 2.x branch uses the Engine 9 bootstrap contract and hooks for registering application and plugin configuration. Review config/event.php in the application and its plugins, then verify startup against the exact Engine version in the lock file. Do not copy examples from older branches without checking them; APIs and bootstrap behavior may differ.
Source checks
composer install
composer test
The v2.0.1 source check is tests/engine_compatibility.php. It covers the bootstrap interface, plugin hooks, configured-listener payload delivery, and a throwing listener whose exception must be returned without escaping emit(). It is not a load test and does not establish cross-process delivery, durable storage, retries, or production metrics.
Sources: v2.0.1 release, Composer manifest, compatibility check.

