phattarachai/watchtower-core

Framework-agnostic core for Watchtower: Sentry envelope parsing, event fingerprinting and shared value helpers.

v1.0.1 2026-08-30 03:28 UTC

Requires

• php: ^8.4
• ext-json: *
• ext-zlib: *

Requires (Dev)

• laravel/pint: ^1.24
• pestphp/pest: ^4.0

MIT

• Phattarachai Chaimongkol

• sentry
• envelope
• Fingerprint
• watchtower
• error-tracking
• exception-tracking

Published on Packagist.org on 2026-08-30 03:28 UTC

README

Framework-agnostic building blocks shared by the Watchtower server and its client packages. Pure PHP — no Laravel container, no service provider, nothing to register.

Install

composer require phattarachai/watchtower-core

What's inside

Class	Purpose
Sentry\AuthHeader	Parses the X-Sentry-Auth header into version / key / client / secret.
Sentry\EnvelopeParser	Parses a Sentry envelope v7 body into a header plus EnvelopeItems.
Sentry\EnvelopeItem	One envelope item: raw headers plus a decoded array or raw string payload.
Ingest\MessageNormalizer	Collapses the variable parts of exception, PHP engine error and SQL messages.
Ingest\Fingerprinter	Computes the stable issue-group fingerprint and title for an event payload.
Alerts\LevelRanker	Compares Sentry severity levels against a minimum threshold.
Support\Gzip	Decodes a request body that may carry Content-Encoding: gzip.
Support\DsnParser	Parses scheme://public_key@host[:port]/<project id> into its parts plus a relay URL.

Testing

composer test

License

MIT