Swap Files

What's Changed

Behaviour changes

• Services registered with Registry::register() under a core name now take effect. Creating a Registry (which every Builder/Factory does) used to re-register the core services and silently overwrite such a registration. If you have an old Registry::register() call for a core identifier, it now replaces the core service. (#162)

Improvements

• Requires florianv/exchanger ^2.11, which brings its provider fixes: CurrencyConverter no longer leaks the API key into error messages, responses without a rate date are reported as service errors, and zero currency units no longer cause a division by zero. (#158)
• Swap::latest() and Swap::historical() document the exceptions they throw. (#161)
• PSR-18 ClientInterface is the documented primary HTTP client type. HTTPlug's HttpClient is still accepted for backward compatibility. The HTTP caching example now uses PSR-18 and PSR-17 classes. (#161)
• Provider tables updated: UniRateAPI and the National Bank of Denmark are listed, and a test keeps the tables in sync with exchanger's registry. (#155, [#158])
• README and documentation reworked, with fastFOREX as the project sponsor and recommended provider, and corrected examples for exceptions, query options, HTTP caching and custom services. (#153, [#154], [#156], [#163])

Infrastructure & Tooling

• php-cs-fixer 3 with the PER-CS 3.0 rule set, and a Coding Standards workflow. (#159)
• Hardened CI: read-only permissions, cancelled superseded runs, timeouts, Composer caching, and PHPUnit failing on warnings and deprecations. (#159)
• Psalm analyses the tests with psalm/plugin-phpunit at level 1, and the baseline is gone. Type coverage is published to Shepherd. (#160)
• New CONTRIBUTING.md with a policy for AI-assisted contributions, and a pull request template. (#157)

Full Changelog: https://github.com/florianv/swap/compare/4.5.0...4.6.0