v1.0.0

First stable release. 🎉

The library is now considered stable and follows semantic versioning from this point on.

Highlights

• Targets Meta Graph API v25.0 — facebook/php-business-sdk upgraded to ^25.0, so events are posted to https://graph.facebook.com/v25.0/{pixel}/events.
• Richer error reporting — ClientException now surfaces Meta's error_subcode and the user-facing error_user_title / error_user_msg (when present), alongside the message, code, trace id and raw response.
• Developer-friendly README — runnable examples for server-side events, browser-side fbq() generation with server/browser deduplication, custom events, fbc/fbp value objects, bringing your own HTTP client, logging and extending events.

Under the hood

• Static analysis migrated from Psalm to PHPStan (level: max).
• Dev tooling modernized and kept installable on PHP 8.1.
• Verified on PHP 8.1, 8.2, 8.3 and 8.4.

Requirements

• PHP 8.1+
• A PSR-18 HTTP client and PSR-17 factories

Backwards compatibility

• Removed Client::setResponseFactory() — the client never creates responses, so the method had no effect. If you were calling it (e.g. when upgrading from 0.2.x), just drop the call.

Full changelog: v0.2.4...v1.0.0

v0.2.4

What's Changed

• Allow psr/http-message 2.0 by @formatz in #7

New Contributors

• @formatz made their first contribution in #7

Full Changelog: v0.2.3...v0.2.4

v0.2.3

This releases affects the Pixel value object. If you provide an empty string as the access token it is now considered the same as null

v0.2.2

Fixes bug in Fbc class

v0.2.1

Full Changelog: v0.2.0...v0.2.1

v0.2.0

This release contains a BC break in the FbqGeneratorInterface that will make the generator more versatile in your application :)

v0.1.1

This release adds context to the event payload so that request properties that are available client side will not be outputted in the user data array sent to meta/facebook

v0.1.0

This is the first release and should be considered more or less stable ;) I will release a v1.0 when the library has been battle tested in production :)