Changelog
Changelog
All notable changes to this project are documented in this file.
The format follows Keep a Changelog.
[Unreleased]
Nothing in this list has been exercised against the real APNs or FCM services yet: everything is verified against fixtures, a local HTTP/2 mock server and the published API descriptions. See “Project status” in the README for the list of unverified points.
Added
Sending
- Direct APNs HTTP/2 provider API: token (
.p8, ES256), certificate (mTLS) or external signer (KMS/HSM through theSignerinterface) authentication, all push types with their topic suffixes, priorities, interruption levels, collapse id, logical expiry, per-type payload limits. - Direct FCM HTTP v1: targets
fid,token,topicandcondition;androidorandroidV2(mutually exclusive);validate_only; service-account OAuth exchange, withgoogle/authas an optional provider for Application Default Credentials, Workload Identity Federation and impersonation. - Unified
PushMessagewith->apns()/->fcm()overlays, nativeApnsMessage/FcmMessagebuilders, rich-content helpers, a capability matrix enforced at validation time, and opt-in truncation of title/subtitle/body only. MobilePushfacade,mobile_push()andmobile_push_to_token()helpers, typed destinations, named connections, scopes for multi-tenancy.- HTTP/2 transport on a persistent
curl_multipool keyed by TLS/authorization identity, with request bodies streamed so that libcurl cannot silently re-send a request.
Outcomes
- One explicit result per destination:
Accepted,Rejected,Failed,Deferred,OutcomeUnknown,Expired,Skipped,Simulated,Validated, each with aReasonCode, the provider’s raw reason and a hint. - An unknown outcome is never treated as a failure: no automatic retry of non-replaceable pushes, no invalidation, no fallback.
- A single retry planner with one budget per destination, message-counted rate limits, and separate breakers for authentication, quota and destination quality. When the cache behind them is unreachable they fail open; when it is contended the destinations are deferred; a send never throws for it.
- Streaming
SendReportwith bounded memory.
Safe mode
mode = auto | live | simulate: outside production nothing reaches the network unless a connection allows it and the destination is on its allow-list. Official provider hosts only.
Delivery profiles
- Light profile (default, no tables, best effort) and durable profile (effects and deliveries ledger, outbox written in the caller’s transaction, leases, relay job and sweeper, idempotency keys with a deduplication window, attempts marked per transport window, follow-up relays folded when many effects are deferred at once).
- Migrations are published by
mobile-push:install(or the module tags) and are idempotent;migrations.autoloadmakes enabled modules register them withmigrateinstead.
Live Activities
- Push-to-start, update and end with typed tokens, serialized transitions, local expiry, high-priority budget; broadcast channels (create, list, delete, sync, publish).
Optional modules (all off by default)
- Device registry with quarantine, invalidation, generations and an explicit operator probe for the APNs environment.
- Eligibility checks right before the network; frequency cap and badge counter per logical effect.
- Notification channels (
push,apns,fcm) with strict fallback rules to another channel. - Client-reported receipts (received / opened) with signed markers.
- Campaigns on the durable profile: resumable planner, pause / resume / cancel, reconciliation.
- Send log sinks (
log,database,otel), health checks and metrics, credential expiry alerts, Pulse card, Telescope entries. - Privacy tooling: encrypted tokens with an HMAC lookup index, redaction before every sink,
forgetandexport.
Tooling
- 38 Artisan commands under
mobile-push:*(install, doctor, send, preview, explain, simulator, connections, circuit, relay, sweep, prune commands, health, credentials check, forget, export, environment probe, topic subscriptions, Live Activities, channels, campaigns). Seedocs/commands.md. - The package schedules its own housekeeping (sweeper, alert evaluation, Live Activity flush, campaign sweep, daily prune commands and credential check), each behind a config switch; the application only runs Laravel’s scheduler.
- FCM topic subscriptions from code (
MobilePush::topicSubscriptions()) and from the command line. - Testing fakes:
MobilePush::fake()(intent) andMobilePush::fakeTransport()(bytes on the wire). docs/configuration.mdgenerated from the configuration schema; documentation examples executed by the test suite.- Reproducible benchmarks in
benchmarks/, and a runtime compatibility page (docs/runtimes.md) that separates what was measured (queue worker loop, forks, many tenants, cache coordination across processes) from what was not run (Octane, Swoole, RoadRunner, FrankenPHP, Horizon, Vapor). - Documentation site sources in
docs-site/(docmd).
This page is generated from CHANGELOG.md. To change it, edit that file in the repository, not this site.