chore(messaging): absorb utopia-php/messaging

[loks0n]

Absorbs utopia-php/messaging with full history via bin/monorepo absorb.

Changes on the way in

• QA hoisted: pint/phpstan/phpunit deps, QA scripts, library CI workflows removed; mirror.yml PR-redirect + README banner added; mirror ruleset normalised (classic-protection app bypass already applied).
• Test contract: composer test = network-free unit tier (41 tests); composer test:e2e = host-run against compose services — mailcatcher (11025/11080) and request-catcher (15000). The in-container test runner (Dockerfile + tests compose service) and the 15 provider tests requiring org secrets are deleted, per the storage precedent. The Email Mock adapter gains backward-compatible host/port constructor params so tests can target host-mapped ports.
• composer.json: unit/e2e script split, prefer-stable, and a direct utopia-php/pools ^1.0 dependency (src uses Utopia\Pools\Adapter\Swoole directly but previously only received pools transitively via client).
• Bug fix: Discord webhook query string built with http_build_query — multiple params were previously concatenated without &.
• Rector/pint sweep applied; expectation-less PHPUnit mocks converted to stubs.

Net −3,425 LoC.

⚠️ Merge with a merge commit, never squash — the subtree annotation lives in the import commit.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR absorbs the utopia-php/messaging repository into the monorepo with full git history. The absorb process correctly hoists QA tooling, splits unit/e2e test suites, fixes the Discord webhook query-string bug, and brings the HTTP layer to PSR-18 with Swoole-based concurrent request dispatch.

• Most adapters are well-implemented: FCM, APNS, SES, SMTP, and Resend all guard against file_get_contents/filesize returning false and support in-memory attachments.
• Sendgrid (Sendgrid.php): filesize() and file_get_contents() return values are not checked, in-memory content attachments are not handled, and passing false to base64_encode() causes a TypeError on PHP 8.5+.
• Mailgun (Mailgun.php): the same filesize() omission silently allows oversized attachments to bypass the size guard; in-memory content attachments are not handled; the truncated exception message is missing the limit value.

Confidence Score: 4/5

Safe to merge pending fixes to Sendgrid and Mailgun attachment handling.

The Sendgrid adapter passes the raw false return of file_get_contents() directly into base64_encode(), which is a TypeError on PHP 8.5 (the minimum required version). The Mailgun adapter silently treats an unreadable file as 0 bytes and truncates its own error message. Every other adapter in the PR handles these cases correctly, making these two outliers clearly unintentional gaps.

Sendgrid.php and Mailgun.php: both attachment-handling paths need filesize() false-return guards, in-memory content checks, and (for Sendgrid) a file_get_contents() false-return guard.

Important Files Changed

Filename	Overview
packages/messaging/src/Utopia/Messaging/Adapter/Email/Sendgrid.php	Does not handle in-memory attachments and does not check whether filesize() or file_get_contents() return false, causing a TypeError on PHP 8.5+ when an attachment file is unreadable
packages/messaging/src/Utopia/Messaging/Adapter/Email/Mailgun.php	Attachment handling has two bugs: filesize() return value not checked (false coerces to 0, silently breaking the size guard), and the exception message for oversized attachments is incomplete
packages/messaging/src/Utopia/Messaging/Adapter/Push/FCM.php	Token response is now properly guarded before access; looks correct
packages/messaging/src/Utopia/Messaging/Adapter/Push/APNS.php	process() correctly declared protected; JWT and requestMulti usage look correct
packages/messaging/src/Utopia/Messaging/Adapter.php	Core adapter with PSR-18 HTTP, Swoole requestMulti, telemetry; $bodyCount > 0 guard prevents empty-bodies padding crash
packages/messaging/src/Utopia/Messaging/Adapter/Email/SES.php	Hand-rolled SigV4 signing, template-based bulk send, proper attachment size checks with false-return guards
packages/messaging/src/Utopia/Messaging/Adapter/Email/SMTP.php	Correctly checks file_get_contents and filesize return values for false; handles in-memory content attachments
packages/messaging/src/Utopia/Messaging/Adapter/Chat/Discord.php	Query-string construction fixed to use http_build_query; URL validation is thorough
packages/messaging/src/Utopia/Messaging/Adapter/Email/Resend.php	Properly handles both in-memory and file-path attachments; batch vs. individual send routing is clear
packages/messaging/composer.json	Unit/e2e test split, PHP 8.5+, direct utopia-php/pools dependency added

_{Reviews (2): Last reviewed commit: "fix(messaging): address review findings" | Re-trigger Greptile}