Add iOS Live Activity push support

[rwarner]

Summary

Adds iOS Live Activity push support using FCM's native liveActivityToken field (Firebase Admin SDK v13.5.0+).

When HA core sends a notification with live_activity_token in the request body, the relay server's ios.js payload builder detects it and constructs an FCM message with apns.liveActivityToken. FCM then automatically sets apns-push-type: liveactivity and routes the notification to Apple's push servers — no custom APNs client, JWT signing, or HTTP/2 session management needed.

Changes:

• ios.js: createPayload detects live_activity_token in the request body and delegates to buildLiveActivityPayload(), which sets the FCM apns.liveActivityToken field with the correct aps structure for start/update/end events
• package.json: Bumps firebase-admin from ^12.1.0 to ^13.5.0 (minimum version with liveActivityToken support) and firebase-functions from ^5.0.1 to ^6.1.1 (required peer dependency for firebase-admin v13)
• index.js: Updated import from firebase-functions to firebase-functions/v1 — firebase-functions v6 changes the default export to v2 APIs, but the v1 import retains functions.config(), functions.region(), and functions.runWith() used by existing Cloud Function definitions
• 20 tests covering fixture-driven payload validation, FCM integration via handleRequest, and backward compatibility with normal notifications

No new files, no new endpoints — Live Activity notifications flow through the existing /api/sendPush/iOS/v1 endpoint alongside normal iOS notifications. The APNS_TEAM_ID, APNS_KEY_ID, and APNS_PRIVATE_KEY environment variables are not needed.

Test plan

• All 20 Live Activity tests pass
• All 129 non-Live-Activity tests pass (2 pre-existing timezone failures in valkey-rate-limiter unrelated to this PR)
• Fixture-driven tests validate payload structure for start, update, end, and full-field scenarios
• Integration tests verify messaging.send() receives correct liveActivityToken

for: home-assistant/iOS#4444
for: home-assistant/core#166072

[Copilot]

Pull request overview

Adds first-class iOS Live Activity push support by introducing a dedicated endpoint that sends directly to APNs (HTTP/2 + JWT), along with an iOS payload builder and tests/fixtures to validate live-activity payload generation and handler behavior.

Changes:

• Introduces a new iOSLiveActivityV1 endpoint (Cloud Functions export + local Fastify route) backed by a new handleLiveActivityRequest handler.
• Adds APNs sender module (apns.js) implementing ES256 JWT generation and HTTP/2 session reuse.
• Extends ios.js with createLiveActivityPayload and adds fixture-driven + integration tests for Live Activity pushes.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
functions/webapp.js	Adds local Fastify route for the new live-activity endpoint.
functions/index.js	Exposes iOSLiveActivityV1 Cloud Function and exports the new handler for tests.
functions/handlers.js	Implements handleLiveActivityRequest with APNs token validation + rate limiting + APNs send/error mapping.
functions/ios.js	Adds createLiveActivityPayload (APS liveactivity structure + headers/environment).
functions/apns.js	New APNs HTTP/2 client module with JWT auth + session caching.
functions/test/ios.test.js	Adds fixtures + integration/unit coverage for live-activity payload creation and handler behavior.
functions/test/fixtures/live-activity/*.json	Adds fixture inputs/expectations for start/update/end live-activity payload generation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.