expo-callkit-telecom 0.3.9 → 0.4.0

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.3.9"
+  ".": "0.4.0"
 }

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to `expo-callkit-telecom` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0](https://github.com/mfairley/expo-callkit-telecom/compare/v0.3.9...v0.4.0) (2026-06-16)
+
+
+### Features
+
+* **android:** broadcast call-ended when no JS observer can receive it ([a98b6ee](https://github.com/mfairley/expo-callkit-telecom/commit/a98b6ee20cd4ddd06cb0d520e0604328a33312a3))
+* **android:** embed session in call events and broadcast undelivered events ([24dd9e0](https://github.com/mfairley/expo-callkit-telecom/commit/24dd9e00f16b746d2aa71591ec98b4d607bf0726))
+* **example:** demonstrate the call-ended broadcast receiver ([a032691](https://github.com/mfairley/expo-callkit-telecom/commit/a032691b5d804f7e6d3b9ba18448bd3637a4353c))
+
 ## [0.3.9](https://github.com/mfairley/expo-callkit-telecom/compare/v0.3.8...v0.3.9) (2026-06-04)
 
 

package/android/src/main/java/expo/modules/callkittelecom/events/CallEventEmitter.kt

@@ -1,8 +1,11 @@
 package expo.modules.callkittelecom.events
 
+import android.content.Context
+import android.content.Intent
 import expo.modules.callkittelecom.utils.CallKitTelecomLog
 import java.time.Instant
 import java.time.format.DateTimeFormatter
+import org.json.JSONObject
 
 private data class QueuedEvent(val body: Map<String, Any?>, val timestamp: Instant)
 
@@ -13,12 +16,21 @@ private data class QueuedEvent(val body: Map<String, Any?>, val timestamp: Insta
  * - Tracks which individual events are being observed by JS
  * - Queues events that arrive before observers mount
  * - Flushes queued events with `{ meta: { flushed: true } }`
+ * - Broadcasts events that can't reach JS at all (dropped, not queued) when a broadcast context is
+ *   set, so a JS-less process can still react (see [setBroadcastContext])
  *
  * All mutable state is guarded by [lock] for thread safety.
  */
 object CallEventEmitter {
     private const val TAG = "ExpoCallKitTelecom.Emitter"
 
+    /**
+     * Package-internal broadcast action for call events that couldn't reach a live JS observer.
+     * Apps receive it with a manifest receiver, registered via the `androidEventReceiver`
+     * config-plugin prop.
+     */
+    const val ACTION_CALL_EVENT = "expo.modules.callkittelecom.ACTION_CALL_EVENT"
+
     private val lock = Any()
     private val observingEvents = mutableSetOf<String>()
     private val eventQueues = mutableMapOf<String, MutableList<QueuedEvent>>()
@@ -28,11 +40,30 @@ object CallEventEmitter {
 
     @Volatile private var sender: ((String, Map<String, Any?>) -> Unit)? = null
 
+    @Volatile private var broadcastContext: Context? = null
+
     /** Sets or clears the active event sender provided by the Expo module. */
     fun setSender(eventSender: ((String, Map<String, Any?>) -> Unit)?) {
         sender = eventSender
     }
 
+    /**
+     * Enables (or disables, with `null`) the broadcast path by providing an application context.
+     *
+     * When set, any event that [send] *drops* — i.e. one that can't reach a live JS observer and
+     * isn't queued for cold-start replay (queue limit 0) — is emitted as a package-internal
+     * [ACTION_CALL_EVENT] broadcast, so a process started by a push or Telecom with no React
+     * context can still react (e.g. notify a backend of a killed-app decline). Queued events are
+     * not broadcast: they flush to JS once observed, so the queue already covers them.
+     *
+     * Broadcasting sits next to the queue — the emitter's existing handling for events JS can't
+     * receive yet — rather than behind an injected hook, since the actual consumer (the app's
+     * manifest receiver) is already decoupled by the OS and there is nothing to inject.
+     */
+    fun setBroadcastContext(context: Context?) {
+        broadcastContext = context?.applicationContext
+    }
+
     /**
      * Configures queue size for a specific event.
      *
@@ -47,8 +78,15 @@ object CallEventEmitter {
      *
      * All delivered events are augmented with a `meta` object containing timestamp and flush
      * status.
+     *
+     * @return true when the event was delivered to a live JS observer, false when it was queued (or
+     *   dropped by the event's queue limit). When the event was *dropped* (it will never reach JS)
+     *   and a broadcast context is set (see [setBroadcastContext]), it is also broadcast so native
+     *   code can deliver out-of-band — e.g. the app process was started by a push or Telecom with
+     *   no React context. Events that were queued are not broadcast: they flush to JS once
+     *   observed, so broadcasting them too would double-deliver.
      */
-    fun send(eventName: String, body: Map<String, Any?>) {
+    fun send(eventName: String, body: Map<String, Any?>): Boolean {
         val timestamp = Instant.now()
         val senderRef = sender
         val isObserving = synchronized(lock) { observingEvents.contains(eventName) }
@@ -56,9 +94,43 @@ object CallEventEmitter {
         if (senderRef != null && isObserving) {
             CallKitTelecomLog.d(TAG) { "Sending event to JS - name: $eventName" }
             senderRef(eventName, buildEventBody(body, flushed = false, timestamp = timestamp))
-            return
+            return true
+        }
+        val queued = queueEvent(eventName, body, timestamp)
+        if (!queued) {
+            broadcastContext?.let { context ->
+                broadcastUndelivered(
+                    context,
+                    eventName,
+                    buildEventBody(body, flushed = false, timestamp = timestamp),
+                )
+            }
+        }
+        return false
+    }
+
+    /**
+     * Broadcasts an undelivered event so a JS-less process can still react.
+     *
+     * Fires a package-internal ([Intent.setPackage]) [ACTION_CALL_EVENT] broadcast carrying the
+     * event name and the JS-shaped body (the same one JS would have received) as a JSON `payload`.
+     * Receivers discriminate on the `eventName` extra. Failures are swallowed (warn-logged): a
+     * dropped broadcast must never break event emission.
+     */
+    private fun broadcastUndelivered(context: Context, eventName: String, body: Map<String, Any?>) {
+        try {
+            val intent =
+                Intent(ACTION_CALL_EVENT)
+                    .setPackage(context.packageName)
+                    .putExtra("eventName", eventName)
+                    .putExtra("payload", JSONObject(body).toString())
+            context.sendBroadcast(intent)
+            CallKitTelecomLog.d(TAG) {
+                "Broadcast undelivered event (no live JS observer) - name: $eventName"
+            }
+        } catch (e: Exception) {
+            CallKitTelecomLog.w(TAG) { "Event broadcast failed - name: $eventName: ${e.message}" }
         }
-        queueEvent(eventName, body, timestamp)
     }
 
     /** Marks an event as observed and flushes any pending queue for that event. */
@@ -95,13 +167,18 @@ object CallEventEmitter {
         return result
     }
 
-    /** Queues an event and enforces per-event queue limits (drop oldest first). */
-    private fun queueEvent(name: String, body: Map<String, Any?>, timestamp: Instant) {
+    /**
+     * Queues an event and enforces per-event queue limits (drop oldest first).
+     *
+     * @return true when the event was queued (and will flush to JS once observed), false when
+     *   queueing is disabled for it (limit 0) so it was dropped and will never reach JS.
+     */
+    private fun queueEvent(name: String, body: Map<String, Any?>, timestamp: Instant): Boolean =
         synchronized(lock) {
             val limit = queueLimits[name] ?: defaultQueueLimit
             if (limit == 0) {
                 CallKitTelecomLog.d(TAG) { "Dropping event (queueing disabled) - name: $name" }
-                return
+                return@synchronized false
             }
 
             val queue = eventQueues.getOrPut(name) { mutableListOf() }
@@ -118,8 +195,8 @@ object CallEventEmitter {
                     "Queueing event (JS not listening) - name: $name, queueSize: ${queue.size}"
                 }
             }
+            true
         }
-    }
 
     /** Flushes all queued events for a single event name. */
     private fun flushQueue(eventName: String) {

package/android/src/main/java/expo/modules/callkittelecom/managers/CallManager.kt

@@ -114,6 +114,10 @@ class CallManager private constructor() {
         CallEventEmitter.setQueueLimit(CALL_ANSWERED, 1)
         CallEventEmitter.setQueueLimit(VOIP_PUSH_TOKEN_UPDATED, 1)
 
+        // Broadcast any event that can't reach a live JS observer (e.g. killed-app decline),
+        // so a JS-less process can still react via a manifest BroadcastReceiver.
+        CallEventEmitter.setBroadcastContext(context)
+
         callsManager = CallsManager(context)
         callsManager.registerAppWithTelecom(
             CallsManager.CAPABILITY_BASELINE or CallsManager.CAPABILITY_SUPPORTS_VIDEO_CALLING
@@ -496,14 +500,18 @@ class CallManager private constructor() {
             CallStore.updateStatus(id, CallSessionStatus.ENDED)
         }
 
+        // Read the just-updated session back from the store (the source of truth) so the
+        // embedded session reflects the terminal state. Read before remove().
+        val endedSession = CallStore.session(id) ?: existingSession
+
         if (emitEnded) {
-            CallEventEmitter.send(CallEvents.CALL_ENDED, mapOf("id" to id.toString()))
+            CallEventEmitter.send(CallEvents.CALL_ENDED, sessionEventBody(endedSession))
         }
 
         if (reportedReason != null) {
             CallEventEmitter.send(
                 CallEvents.CALL_REPORTED_ENDED,
-                mapOf("id" to id.toString(), "reason" to reportedReason.value),
+                sessionEventBody(endedSession, "reason" to reportedReason.value),
             )
         }
 
@@ -519,6 +527,22 @@ class CallManager private constructor() {
         }
     }
 
+    /**
+     * Builds an event body carrying the call id plus a full session snapshot.
+     *
+     * Terminal events embed the session so JS consumers — and the [CallEventEmitter] broadcast for
+     * a JS-less process — get full context (e.g. `serverCallId`/`metadata` via `incomingCallEvent`)
+     * without a separate lookup.
+     */
+    private fun sessionEventBody(
+        session: CallSession,
+        vararg extra: Pair<String, Any?>,
+    ): Map<String, Any?> = buildMap {
+        put("id", session.id.toString())
+        put("session", session.toMap())
+        putAll(extra)
+    }
+
     /**
      * Safety-net cleanup called from the addCall finally block.
      *
@@ -540,7 +564,9 @@ class CallManager private constructor() {
         if (session.status != CallSessionStatus.ENDED) {
             CallStore.updateStatus(id, CallSessionStatus.ENDED)
         }
-        CallEventEmitter.send(CallEvents.CALL_ENDED, mapOf("id" to id.toString()))
+        // Read the just-updated session back from the store (the source of truth). Before remove().
+        val endedSession = CallStore.session(id) ?: session
+        CallEventEmitter.send(CallEvents.CALL_ENDED, sessionEventBody(endedSession))
         CallStore.remove(id)
 
         if (CallStore.allSessions().isEmpty()) {

package/build/Calls.types.d.ts

@@ -244,6 +244,21 @@ export interface CaptureSession {
 export interface CallActionEvent extends NativeEvent {
     id: string;
 }
+/**
+ * Mixin for events that carry a full {@link CallSession} snapshot alongside the
+ * event-specific fields.
+ *
+ * Terminal events embed the session so consumers without access to the session
+ * store still get full context. On Android this is also what makes the
+ * package-internal call-event broadcast self-contained when no JS observer is
+ * alive (see "Call ended while the app is killed" in the docs) — the broadcast
+ * payload is exactly this event body.
+ *
+ * @category Call Events
+ */
+export interface WithSession {
+    session: CallSession;
+}
 /**
  * Fired after `startOutgoingCall`, once the OS has accepted the call request.
  *
@@ -301,7 +316,7 @@ export interface CallAnsweredEvent extends CallActionEvent {
  *
  * @category Call Events
  */
-export interface CallEndedEvent extends CallActionEvent {
+export interface CallEndedEvent extends CallActionEvent, WithSession {
 }
 /**
  * Reason a call was ended, reported on {@link CallReportedEnded}.
@@ -315,7 +330,7 @@ export type CallEndedReason = "failed" | "remoteEnded" | "unanswered" | "answere
  *
  * @category Call Events
  */
-export interface CallReportedEnded extends CallActionEvent {
+export interface CallReportedEnded extends CallActionEvent, WithSession {
     reason: CallEndedReason;
 }
 /**

package/build/Calls.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Calls.types.d.ts","sourceRoot":"","sources":["../src/Calls.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Calls.types.d.ts","sourceRoot":"","sources":["../src/Calls.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,KAAK,CAAC;AAMhD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;CACvB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,kBAAkB,EAAE,eAAe,EAAE,CAAC;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;2EACuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,WAAW,GACX,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,SAAS,CAAC;AAMd;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,gBAAgB,CAAC;IACvC,YAAY,EAAE,UAAU,CAAC;IACzB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,aAAa,GACb,cAAc,GACd,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA6B,SAAQ,WAAW;IAC/D,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,YAAY,EAAE,UAAU,CAAC;IACzB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;CAC/B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,wEAAwE;IACxE,mCAAmC,CAAC,EAAE,OAAO,CAAC;CAC/C;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;CAAG;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB;;yEAEqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,eAAe;CAAG;AAErE;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe,EAAE,WAAW;CAAG;AAEvE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,mBAAmB,GACnB,mBAAmB,GACnB,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe,EAAE,WAAW;IACrE,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,eAAe;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,oBAAoB,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,aAAa,CAAC;CACrB"}

package/build/Calls.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Calls.types.js","sourceRoot":"","sources":["../src/Calls.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Type of VoIP push token reported by `getVoIPPushToken`.\n *\n * - `\"APNS_VOIP\"` — Apple Push Notification service VoIP channel (iOS)\n * - `\"FCM\"` — Firebase Cloud Messaging (Android)\n *\n * @category VoIP Push\n */\nexport type PushTokenType = \"APNS_VOIP\" | \"FCM\";\n\n// ============================================================================\n// Native event infrastructure\n// ============================================================================\n\n/**\n * Metadata attached to every native event.\n *\n * @category Core\n */\nexport interface NativeEventMeta {\n  /** Whether the event was flushed from queue (true) or sent in real-time (false) */\n  flushed: boolean;\n  /** ISO8601 timestamp of when the event was created */\n  timestamp: string;\n}\n\n/**\n * Base shape extended by every native event — carries a {@link NativeEventMeta} envelope.\n *\n * @category Core\n */\nexport interface NativeEvent {\n  meta: NativeEventMeta;\n}\n\n// ============================================================================\n// Call sessions\n// ============================================================================\n\n/**\n * Active call as tracked by the module.\n *\n * Represents one in-flight call. Mirrors the OS-side `CXCall` (iOS) /\n * `CallControlScope` (Android) plus app-level state (origin, participants,\n * incoming-call payload, mute/hold).\n *\n * @category Sessions\n */\nexport interface CallSession {\n  id: string;\n  options: CallOptions;\n  origin: CallSessionOrigin;\n  remoteParticipants: CallParticipant[];\n  incomingCallEvent?: IncomingCallEvent;\n  status: CallSessionStatus;\n  connectedAt?: string;\n  isMuted: boolean;\n  isOnHold: boolean;\n  dtmfDigits?: string;\n}\n\n/**\n * Per-call options set at session start.\n *\n * @category Sessions\n */\nexport interface CallOptions {\n  hasVideo: boolean;\n}\n\n/**\n * Where a call session originated.\n *\n * - `incoming` — Reported from a VoIP push (or directly via `reportIncomingCall`).\n * - `outgoingApp` — Started by your app via `startOutgoingCall`.\n * - `outgoingSystem` — Started by the OS via a call intent (Recents, Siri).\n *\n * @category Sessions\n */\nexport type CallSessionOrigin = \"incoming\" | \"outgoingApp\" | \"outgoingSystem\";\n\n/**\n * Identity for a remote party on a call.\n *\n * @category Sessions\n */\nexport interface CallParticipant {\n  /** Opaque, stable app identifier for this participant. */\n  id: string;\n  /** Display name. */\n  displayName?: string;\n  /** Avatar URL. */\n  avatarUrl?: string;\n  /** Phone number in E.164 (e.g. \"+14155551234\"). When present on iOS, the\n   *  CallKit handle is set to this number, enabling Recents and Siri. */\n  phoneNumber?: string;\n  /** Email address. */\n  email?: string;\n}\n\n/**\n * Call session status representing the lifecycle of a call.\n *\n * Outgoing call flow: requesting → connecting → connected → ended\n * Incoming call flow: ringing → connecting → connected → ended\n *\n * - `requesting` — Outgoing only. The call request has been submitted to\n *   CallKit/Telecom and is awaiting system acceptance.\n * - `ringing` — Incoming only. The call has been reported to CallKit/Telecom\n *   and the user sees the native incoming call UI or notification.\n * - `connecting` — Both directions. For outgoing calls, the system accepted the\n *   call and the dialtone is playing while waiting for the remote party to answer.\n *   For incoming calls, the user answered and media is being established.\n * - `connected` — Both directions. Media is flowing and the call is active.\n * - `ended` — Both directions. Transient state during teardown before the\n *   session is removed from the store.\n *\n * @category Sessions\n */\nexport type CallSessionStatus =\n  | \"requesting\"\n  | \"connecting\"\n  | \"ringing\"\n  | \"connected\"\n  | \"ended\";\n\n/**\n * Fired when a new {@link CallSession} is created (outgoing request or incoming report).\n *\n * @category Sessions\n */\nexport interface CallSessionAddedEvent extends NativeEvent {\n  session: CallSession;\n}\n\n/**\n * Fired when an existing {@link CallSession}'s state changes (status, mute, hold, etc.).\n *\n * @category Sessions\n */\nexport interface CallSessionUpdatedEvent extends NativeEvent {\n  session: CallSession;\n}\n\n/**\n * Fired when a {@link CallSession} is removed after the call has ended and been cleaned up.\n *\n * @category Sessions\n */\nexport interface CallSessionRemovedEvent extends NativeEvent {\n  id: string;\n}\n\n// ============================================================================\n// Permissions\n// ============================================================================\n\n/**\n * Permission status for microphone and camera, reported on {@link AudioSession}\n * and {@link CaptureSession}.\n *\n * @category Permissions\n */\nexport type PermissionStatus =\n  | \"granted\"\n  | \"denied\"\n  | \"undetermined\"\n  | \"restricted\"\n  | \"unknown\";\n\n// ============================================================================\n// Audio session\n// ============================================================================\n\n/**\n * Snapshot of the current audio session, including activation state, route,\n * and (on iOS) the WebRTC `RTCAudioSession` coordination flags.\n *\n * @category Audio\n */\nexport interface AudioSession {\n  isActive: boolean;\n  /** iOS only: whether the WebRTC RTCAudioSession is active. */\n  rtcSessionIsActive?: boolean;\n  /** iOS only: whether the AVAudioSession is active. */\n  avSessionIsActive?: boolean;\n  /** iOS only: whether the RTCAudioSession audio track is enabled. */\n  isAudioEnabled?: boolean;\n  /** iOS only: whether manual audio mode is enabled on RTCAudioSession. */\n  useManualAudio?: boolean;\n  isOtherAudioPlaying: boolean;\n  category: string;\n  mode: string;\n  /** iOS only: AVAudioSession category options. */\n  categoryOptions?: string[];\n  sampleRate: number;\n  ioBufferDuration: number;\n  inputNumberOfChannels: number;\n  outputNumberOfChannels: number;\n  microphonePermission: PermissionStatus;\n  currentRoute: AudioRoute;\n  /** Available audio output devices. Populated on Android; undefined on iOS. */\n  availableRoutes?: AudioPort[];\n}\n\n/**\n * Currently-selected audio inputs and outputs.\n *\n * @category Audio\n */\nexport interface AudioRoute {\n  inputs: AudioPort[];\n  outputs: AudioPort[];\n}\n\n/**\n * A single audio input or output (earpiece, speaker, headphones, Bluetooth device, etc.).\n *\n * @category Audio\n */\nexport interface AudioPort {\n  portType: AudioOutputPortType;\n  portName: string;\n  uid: string;\n}\n\n/**\n * Cross-platform audio output port type identifiers.\n * Both iOS and Android map their native audio device types to these shared values.\n *\n * @category Audio\n */\nexport type AudioOutputPortType =\n  | \"builtInReceiver\" // Earpiece\n  | \"builtInSpeaker\" // Speaker\n  | \"headphones\" // Wired headphones\n  | \"bluetoothA2DP\" // Bluetooth A2DP audio\n  | \"bluetoothLE\" // Bluetooth Low Energy audio\n  | \"bluetoothHFP\" // Bluetooth Hands-Free Profile\n  | \"airPlay\" // AirPlay\n  | \"hdmi\" // HDMI output\n  | \"carAudio\" // CarPlay\n  | \"usbAudio\" // USB audio\n  | \"lineOut\" // Line out\n  | (string & {}); // Allow other unknown port types\n\n/**\n * Brief summary of one call associated with an audio-session activation event.\n *\n * @category Audio Events\n */\nexport interface AudioSessionCallInfo {\n  id: string;\n  status: CallSessionStatus;\n}\n\n/**\n * Fired when the system activates the audio session for a call.\n *\n * @category Audio Events\n */\nexport interface AudioSessionActivatedEvent extends NativeEvent {\n  calls: AudioSessionCallInfo[];\n}\n\n/**\n * Fired when the system deactivates the audio session after a call.\n *\n * @category Audio Events\n */\nexport interface AudioSessionDeactivatedEvent extends NativeEvent {\n  calls: AudioSessionCallInfo[];\n}\n\n/**\n * Fired when the active audio route changes (e.g. AirPods connected, speaker toggled).\n *\n * @category Audio Events\n */\nexport interface AudioRouteChangedEvent extends NativeEvent {\n  currentRoute: AudioRoute;\n  /** Available audio output devices. Populated on Android; undefined on iOS. */\n  availableRoutes?: AudioPort[];\n}\n\n// ============================================================================\n// Capture session (camera)\n// ============================================================================\n\n/**\n * Snapshot of camera-related state, including permission and (on iOS 16+)\n * multitasking-camera availability.\n *\n * @category Capture\n */\nexport interface CaptureSession {\n  cameraPermission: PermissionStatus;\n  /** Whether the device supports multitasking camera access (iOS 16+). */\n  isMultitaskingCameraAccessSupported?: boolean;\n}\n\n// ============================================================================\n// Call action events\n// ============================================================================\n\n/**\n * Base shape for any event carrying a {@link CallSession.id}.\n *\n * @category Call Events\n */\nexport interface CallActionEvent extends NativeEvent {\n  id: string;\n}\n\n/**\n * Fired after `startOutgoingCall`, once the OS has accepted the call request.\n *\n * @category Call Events\n */\nexport interface OutgoingCallStartedEvent extends CallActionEvent {}\n\n/**\n * Payload describing one incoming call.\n *\n * Delivered both inside a VoIP push (parsed natively by the module) and on\n * {@link CallSession.incomingCallEvent} for any incoming-origin session.\n *\n * @category VoIP Push\n */\nexport interface IncomingCallEvent {\n  /** Unique event identifier (UUID). Used for dedup. */\n  eventId: string;\n  /** Your backend's id for this call. Distinct from {@link CallSession.id},\n   *  which is the OS-assigned native call UUID. Use this id to talk to your\n   *  server about the call (e.g. POST /calls/:serverCallId/answer). */\n  serverCallId: string;\n  /** True for video calls, false for audio. */\n  hasVideo: boolean;\n  /** RFC 3339 timestamp of when the call was placed. Optional; defaults to now. */\n  startedAt?: string;\n  /** Caller identity and addressing. */\n  caller: CallParticipant;\n  /**\n   * App-defined extra fields, forwarded verbatim from the push payload.\n   *\n   * The library treats this as opaque — put whatever your app needs here\n   * (chatId, tenantId, room name, etc.). Cast to your own type at the\n   * read site.\n   */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Fired after `reportIncomingCall`, once the OS has accepted the incoming-call report.\n *\n * @category Call Events\n */\nexport interface IncomingCallReportedEvent extends CallActionEvent {}\n\n/**\n * Fired when the user answers an incoming call from the system UI.\n *\n * @category Call Events\n */\nexport interface CallAnsweredEvent extends CallActionEvent {\n  requestId: string;\n}\n\n/**\n * Fired when the user ends a call from the system UI, or the OS ends the call for any reason.\n *\n * @category Call Events\n */\nexport interface CallEndedEvent extends CallActionEvent {}\n\n/**\n * Reason a call was ended, reported on {@link CallReportedEnded}.\n *\n * @category Call Events\n */\nexport type CallEndedReason =\n  | \"failed\"\n  | \"remoteEnded\"\n  | \"unanswered\"\n  | \"answeredElsewhere\"\n  | \"declinedElsewhere\"\n  | \"unknown\";\n\n/**\n * Fired when the app calls `reportCallEnded` to inform the OS the call has ended\n * externally (e.g. remote hang-up).\n *\n * @category Call Events\n */\nexport interface CallReportedEnded extends CallActionEvent {\n  reason: CallEndedReason;\n}\n\n/**\n * Fired when the system requests a mute-state change (e.g. user pressed the\n * mute button in the CallKit UI). Apply the change to your media connection.\n *\n * @category Call Events\n */\nexport interface SetMutedActionEvent extends CallActionEvent {\n  isMuted: boolean;\n}\n\n/**\n * Fired when video state changes on a call.\n *\n * @category Call Events\n */\nexport interface VideoChangedEvent extends CallActionEvent {\n  hasVideo: boolean;\n}\n\n/**\n * Fired when the system requests a hold-state change. Apply the change to your media connection.\n *\n * @category Call Events\n */\nexport interface SetHeldActionEvent extends CallActionEvent {\n  isOnHold: boolean;\n}\n\n/**\n * Fired when the system requests DTMF tones be played on the call.\n *\n * @category Call Events\n */\nexport interface DTMFEvent extends CallActionEvent {\n  digits: string;\n}\n\n// ============================================================================\n// Call intents (iOS Recents, Siri \"call X\")\n// ============================================================================\n\n/**\n * Kind of handle attached to a call intent (Recents tap, Siri).\n *\n * @category Call Events\n */\nexport type CallIntentHandleType = \"phoneNumber\" | \"email\" | \"unknown\";\n\n/**\n * Fired when the OS routes a \"start call\" intent to the app — e.g. the user\n * tapped a Recents entry or said \"call Jane\" to Siri.\n *\n * @category Call Events\n */\nexport interface CallIntentReceivedEvent extends NativeEvent {\n  handle: string;\n  handleType: CallIntentHandleType;\n  hasVideo: boolean;\n}\n\n// ============================================================================\n// VoIP push\n// ============================================================================\n\n/**\n * A VoIP push token bundled with its transport type.\n *\n * @category VoIP Push\n */\nexport interface VoIPPushToken {\n  /** The VoIP push token string. */\n  token: string;\n  /** The type of token this platform provides. */\n  type: PushTokenType;\n}\n\n/**\n * Fired when the VoIP push token is received, refreshed, or invalidated.\n *\n * @category VoIP Push\n */\nexport interface VoIPPushTokenUpdatedEvent extends NativeEvent {\n  /** The VoIP push token string, or undefined if invalidated */\n  token?: string;\n  /** The type of VoIP push token (e.g. \"APNS_VOIP\", \"FCM\"). */\n  type: PushTokenType;\n}\n"]}
+{"version":3,"file":"Calls.types.js","sourceRoot":"","sources":["../src/Calls.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Type of VoIP push token reported by `getVoIPPushToken`.\n *\n * - `\"APNS_VOIP\"` — Apple Push Notification service VoIP channel (iOS)\n * - `\"FCM\"` — Firebase Cloud Messaging (Android)\n *\n * @category VoIP Push\n */\nexport type PushTokenType = \"APNS_VOIP\" | \"FCM\";\n\n// ============================================================================\n// Native event infrastructure\n// ============================================================================\n\n/**\n * Metadata attached to every native event.\n *\n * @category Core\n */\nexport interface NativeEventMeta {\n  /** Whether the event was flushed from queue (true) or sent in real-time (false) */\n  flushed: boolean;\n  /** ISO8601 timestamp of when the event was created */\n  timestamp: string;\n}\n\n/**\n * Base shape extended by every native event — carries a {@link NativeEventMeta} envelope.\n *\n * @category Core\n */\nexport interface NativeEvent {\n  meta: NativeEventMeta;\n}\n\n// ============================================================================\n// Call sessions\n// ============================================================================\n\n/**\n * Active call as tracked by the module.\n *\n * Represents one in-flight call. Mirrors the OS-side `CXCall` (iOS) /\n * `CallControlScope` (Android) plus app-level state (origin, participants,\n * incoming-call payload, mute/hold).\n *\n * @category Sessions\n */\nexport interface CallSession {\n  id: string;\n  options: CallOptions;\n  origin: CallSessionOrigin;\n  remoteParticipants: CallParticipant[];\n  incomingCallEvent?: IncomingCallEvent;\n  status: CallSessionStatus;\n  connectedAt?: string;\n  isMuted: boolean;\n  isOnHold: boolean;\n  dtmfDigits?: string;\n}\n\n/**\n * Per-call options set at session start.\n *\n * @category Sessions\n */\nexport interface CallOptions {\n  hasVideo: boolean;\n}\n\n/**\n * Where a call session originated.\n *\n * - `incoming` — Reported from a VoIP push (or directly via `reportIncomingCall`).\n * - `outgoingApp` — Started by your app via `startOutgoingCall`.\n * - `outgoingSystem` — Started by the OS via a call intent (Recents, Siri).\n *\n * @category Sessions\n */\nexport type CallSessionOrigin = \"incoming\" | \"outgoingApp\" | \"outgoingSystem\";\n\n/**\n * Identity for a remote party on a call.\n *\n * @category Sessions\n */\nexport interface CallParticipant {\n  /** Opaque, stable app identifier for this participant. */\n  id: string;\n  /** Display name. */\n  displayName?: string;\n  /** Avatar URL. */\n  avatarUrl?: string;\n  /** Phone number in E.164 (e.g. \"+14155551234\"). When present on iOS, the\n   *  CallKit handle is set to this number, enabling Recents and Siri. */\n  phoneNumber?: string;\n  /** Email address. */\n  email?: string;\n}\n\n/**\n * Call session status representing the lifecycle of a call.\n *\n * Outgoing call flow: requesting → connecting → connected → ended\n * Incoming call flow: ringing → connecting → connected → ended\n *\n * - `requesting` — Outgoing only. The call request has been submitted to\n *   CallKit/Telecom and is awaiting system acceptance.\n * - `ringing` — Incoming only. The call has been reported to CallKit/Telecom\n *   and the user sees the native incoming call UI or notification.\n * - `connecting` — Both directions. For outgoing calls, the system accepted the\n *   call and the dialtone is playing while waiting for the remote party to answer.\n *   For incoming calls, the user answered and media is being established.\n * - `connected` — Both directions. Media is flowing and the call is active.\n * - `ended` — Both directions. Transient state during teardown before the\n *   session is removed from the store.\n *\n * @category Sessions\n */\nexport type CallSessionStatus =\n  | \"requesting\"\n  | \"connecting\"\n  | \"ringing\"\n  | \"connected\"\n  | \"ended\";\n\n/**\n * Fired when a new {@link CallSession} is created (outgoing request or incoming report).\n *\n * @category Sessions\n */\nexport interface CallSessionAddedEvent extends NativeEvent {\n  session: CallSession;\n}\n\n/**\n * Fired when an existing {@link CallSession}'s state changes (status, mute, hold, etc.).\n *\n * @category Sessions\n */\nexport interface CallSessionUpdatedEvent extends NativeEvent {\n  session: CallSession;\n}\n\n/**\n * Fired when a {@link CallSession} is removed after the call has ended and been cleaned up.\n *\n * @category Sessions\n */\nexport interface CallSessionRemovedEvent extends NativeEvent {\n  id: string;\n}\n\n// ============================================================================\n// Permissions\n// ============================================================================\n\n/**\n * Permission status for microphone and camera, reported on {@link AudioSession}\n * and {@link CaptureSession}.\n *\n * @category Permissions\n */\nexport type PermissionStatus =\n  | \"granted\"\n  | \"denied\"\n  | \"undetermined\"\n  | \"restricted\"\n  | \"unknown\";\n\n// ============================================================================\n// Audio session\n// ============================================================================\n\n/**\n * Snapshot of the current audio session, including activation state, route,\n * and (on iOS) the WebRTC `RTCAudioSession` coordination flags.\n *\n * @category Audio\n */\nexport interface AudioSession {\n  isActive: boolean;\n  /** iOS only: whether the WebRTC RTCAudioSession is active. */\n  rtcSessionIsActive?: boolean;\n  /** iOS only: whether the AVAudioSession is active. */\n  avSessionIsActive?: boolean;\n  /** iOS only: whether the RTCAudioSession audio track is enabled. */\n  isAudioEnabled?: boolean;\n  /** iOS only: whether manual audio mode is enabled on RTCAudioSession. */\n  useManualAudio?: boolean;\n  isOtherAudioPlaying: boolean;\n  category: string;\n  mode: string;\n  /** iOS only: AVAudioSession category options. */\n  categoryOptions?: string[];\n  sampleRate: number;\n  ioBufferDuration: number;\n  inputNumberOfChannels: number;\n  outputNumberOfChannels: number;\n  microphonePermission: PermissionStatus;\n  currentRoute: AudioRoute;\n  /** Available audio output devices. Populated on Android; undefined on iOS. */\n  availableRoutes?: AudioPort[];\n}\n\n/**\n * Currently-selected audio inputs and outputs.\n *\n * @category Audio\n */\nexport interface AudioRoute {\n  inputs: AudioPort[];\n  outputs: AudioPort[];\n}\n\n/**\n * A single audio input or output (earpiece, speaker, headphones, Bluetooth device, etc.).\n *\n * @category Audio\n */\nexport interface AudioPort {\n  portType: AudioOutputPortType;\n  portName: string;\n  uid: string;\n}\n\n/**\n * Cross-platform audio output port type identifiers.\n * Both iOS and Android map their native audio device types to these shared values.\n *\n * @category Audio\n */\nexport type AudioOutputPortType =\n  | \"builtInReceiver\" // Earpiece\n  | \"builtInSpeaker\" // Speaker\n  | \"headphones\" // Wired headphones\n  | \"bluetoothA2DP\" // Bluetooth A2DP audio\n  | \"bluetoothLE\" // Bluetooth Low Energy audio\n  | \"bluetoothHFP\" // Bluetooth Hands-Free Profile\n  | \"airPlay\" // AirPlay\n  | \"hdmi\" // HDMI output\n  | \"carAudio\" // CarPlay\n  | \"usbAudio\" // USB audio\n  | \"lineOut\" // Line out\n  | (string & {}); // Allow other unknown port types\n\n/**\n * Brief summary of one call associated with an audio-session activation event.\n *\n * @category Audio Events\n */\nexport interface AudioSessionCallInfo {\n  id: string;\n  status: CallSessionStatus;\n}\n\n/**\n * Fired when the system activates the audio session for a call.\n *\n * @category Audio Events\n */\nexport interface AudioSessionActivatedEvent extends NativeEvent {\n  calls: AudioSessionCallInfo[];\n}\n\n/**\n * Fired when the system deactivates the audio session after a call.\n *\n * @category Audio Events\n */\nexport interface AudioSessionDeactivatedEvent extends NativeEvent {\n  calls: AudioSessionCallInfo[];\n}\n\n/**\n * Fired when the active audio route changes (e.g. AirPods connected, speaker toggled).\n *\n * @category Audio Events\n */\nexport interface AudioRouteChangedEvent extends NativeEvent {\n  currentRoute: AudioRoute;\n  /** Available audio output devices. Populated on Android; undefined on iOS. */\n  availableRoutes?: AudioPort[];\n}\n\n// ============================================================================\n// Capture session (camera)\n// ============================================================================\n\n/**\n * Snapshot of camera-related state, including permission and (on iOS 16+)\n * multitasking-camera availability.\n *\n * @category Capture\n */\nexport interface CaptureSession {\n  cameraPermission: PermissionStatus;\n  /** Whether the device supports multitasking camera access (iOS 16+). */\n  isMultitaskingCameraAccessSupported?: boolean;\n}\n\n// ============================================================================\n// Call action events\n// ============================================================================\n\n/**\n * Base shape for any event carrying a {@link CallSession.id}.\n *\n * @category Call Events\n */\nexport interface CallActionEvent extends NativeEvent {\n  id: string;\n}\n\n/**\n * Mixin for events that carry a full {@link CallSession} snapshot alongside the\n * event-specific fields.\n *\n * Terminal events embed the session so consumers without access to the session\n * store still get full context. On Android this is also what makes the\n * package-internal call-event broadcast self-contained when no JS observer is\n * alive (see \"Call ended while the app is killed\" in the docs) — the broadcast\n * payload is exactly this event body.\n *\n * @category Call Events\n */\nexport interface WithSession {\n  session: CallSession;\n}\n\n/**\n * Fired after `startOutgoingCall`, once the OS has accepted the call request.\n *\n * @category Call Events\n */\nexport interface OutgoingCallStartedEvent extends CallActionEvent {}\n\n/**\n * Payload describing one incoming call.\n *\n * Delivered both inside a VoIP push (parsed natively by the module) and on\n * {@link CallSession.incomingCallEvent} for any incoming-origin session.\n *\n * @category VoIP Push\n */\nexport interface IncomingCallEvent {\n  /** Unique event identifier (UUID). Used for dedup. */\n  eventId: string;\n  /** Your backend's id for this call. Distinct from {@link CallSession.id},\n   *  which is the OS-assigned native call UUID. Use this id to talk to your\n   *  server about the call (e.g. POST /calls/:serverCallId/answer). */\n  serverCallId: string;\n  /** True for video calls, false for audio. */\n  hasVideo: boolean;\n  /** RFC 3339 timestamp of when the call was placed. Optional; defaults to now. */\n  startedAt?: string;\n  /** Caller identity and addressing. */\n  caller: CallParticipant;\n  /**\n   * App-defined extra fields, forwarded verbatim from the push payload.\n   *\n   * The library treats this as opaque — put whatever your app needs here\n   * (chatId, tenantId, room name, etc.). Cast to your own type at the\n   * read site.\n   */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Fired after `reportIncomingCall`, once the OS has accepted the incoming-call report.\n *\n * @category Call Events\n */\nexport interface IncomingCallReportedEvent extends CallActionEvent {}\n\n/**\n * Fired when the user answers an incoming call from the system UI.\n *\n * @category Call Events\n */\nexport interface CallAnsweredEvent extends CallActionEvent {\n  requestId: string;\n}\n\n/**\n * Fired when the user ends a call from the system UI, or the OS ends the call for any reason.\n *\n * @category Call Events\n */\nexport interface CallEndedEvent extends CallActionEvent, WithSession {}\n\n/**\n * Reason a call was ended, reported on {@link CallReportedEnded}.\n *\n * @category Call Events\n */\nexport type CallEndedReason =\n  | \"failed\"\n  | \"remoteEnded\"\n  | \"unanswered\"\n  | \"answeredElsewhere\"\n  | \"declinedElsewhere\"\n  | \"unknown\";\n\n/**\n * Fired when the app calls `reportCallEnded` to inform the OS the call has ended\n * externally (e.g. remote hang-up).\n *\n * @category Call Events\n */\nexport interface CallReportedEnded extends CallActionEvent, WithSession {\n  reason: CallEndedReason;\n}\n\n/**\n * Fired when the system requests a mute-state change (e.g. user pressed the\n * mute button in the CallKit UI). Apply the change to your media connection.\n *\n * @category Call Events\n */\nexport interface SetMutedActionEvent extends CallActionEvent {\n  isMuted: boolean;\n}\n\n/**\n * Fired when video state changes on a call.\n *\n * @category Call Events\n */\nexport interface VideoChangedEvent extends CallActionEvent {\n  hasVideo: boolean;\n}\n\n/**\n * Fired when the system requests a hold-state change. Apply the change to your media connection.\n *\n * @category Call Events\n */\nexport interface SetHeldActionEvent extends CallActionEvent {\n  isOnHold: boolean;\n}\n\n/**\n * Fired when the system requests DTMF tones be played on the call.\n *\n * @category Call Events\n */\nexport interface DTMFEvent extends CallActionEvent {\n  digits: string;\n}\n\n// ============================================================================\n// Call intents (iOS Recents, Siri \"call X\")\n// ============================================================================\n\n/**\n * Kind of handle attached to a call intent (Recents tap, Siri).\n *\n * @category Call Events\n */\nexport type CallIntentHandleType = \"phoneNumber\" | \"email\" | \"unknown\";\n\n/**\n * Fired when the OS routes a \"start call\" intent to the app — e.g. the user\n * tapped a Recents entry or said \"call Jane\" to Siri.\n *\n * @category Call Events\n */\nexport interface CallIntentReceivedEvent extends NativeEvent {\n  handle: string;\n  handleType: CallIntentHandleType;\n  hasVideo: boolean;\n}\n\n// ============================================================================\n// VoIP push\n// ============================================================================\n\n/**\n * A VoIP push token bundled with its transport type.\n *\n * @category VoIP Push\n */\nexport interface VoIPPushToken {\n  /** The VoIP push token string. */\n  token: string;\n  /** The type of token this platform provides. */\n  type: PushTokenType;\n}\n\n/**\n * Fired when the VoIP push token is received, refreshed, or invalidated.\n *\n * @category VoIP Push\n */\nexport interface VoIPPushTokenUpdatedEvent extends NativeEvent {\n  /** The VoIP push token string, or undefined if invalidated */\n  token?: string;\n  /** The type of VoIP push token (e.g. \"APNS_VOIP\", \"FCM\"). */\n  type: PushTokenType;\n}\n"]}

package/ios/Managers/CallManager+CXProviderDelegate.swift

@@ -104,8 +104,13 @@ extension CallManager: CXProviderDelegate {
     cancelCallTimeout(for: action.callUUID)
 
     Task {
-      await MainActor.run {
-        CallEventEmitter.shared.send(CallEndedEvent(id: action.callUUID))
+      // Snapshot the session as ended so the embedded session reflects the terminal state.
+      if var session = await store.session(for: action.callUUID) {
+        session.status = .ended
+        await MainActor.run {
+          CallEventEmitter.shared.send(
+            CallEndedEvent(id: action.callUUID, session: session))
+        }
       }
 
       await store.remove(for: action.callUUID)

package/ios/Managers/CallManager.swift

@@ -566,8 +566,13 @@ class CallManager: NSObject {
 
     provider.reportCall(with: id, endedAt: Date(), reason: reason)
 
-    await MainActor.run {
-      CallEventEmitter.shared.send(CallReportedEnded(id: id, reason: reason))
+    // Snapshot the session as ended so the embedded session reflects the terminal state.
+    if var session = await store.session(for: id) {
+      session.status = .ended
+      await MainActor.run {
+        CallEventEmitter.shared.send(
+          CallReportedEnded(id: id, reason: reason, session: session))
+      }
     }
 
     await store.remove(for: id)

package/ios/Models/CallEvents.swift

@@ -159,9 +159,13 @@ struct CallEndedEvent: CallEvent {
   static let name = "onCallEnded"
 
   let id: UUID
+  let session: CallSession
 
   var body: [String: Any] {
-    [CallEventKeys.id: id.uuidString]
+    [
+      CallEventKeys.id: id.uuidString,
+      "session": session.toDictionary(),
+    ]
   }
 }
 
@@ -170,11 +174,13 @@ struct CallReportedEnded: CallEvent {
 
   let id: UUID
   let reason: CXCallEndedReason
+  let session: CallSession
 
   var body: [String: Any] {
     [
       CallEventKeys.id: id.uuidString,
       "reason": Self.reasonString(for: reason),
+      "session": session.toDictionary(),
     ]
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-callkit-telecom",
-  "version": "0.3.9",
+  "version": "0.4.0",
   "description": "CallKit + Jetpack Core-Telecom for Expo / React Native — native call UI, VoIP push, LiveKit-friendly audio. A modern react-native-callkeep alternative.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -15,6 +15,7 @@
   },
   "scripts": {
     "build": "expo-module build && expo-module build plugin",
+    "build:plugin": "expo-module build plugin",
     "clean": "expo-module clean",
     "lint": "expo-module lint",
     "test": "expo-module test",

package/plugin/build/constants.d.ts

@@ -1,3 +1,8 @@
 export declare const DEFAULT_INCOMING_CALL_TIMEOUT = 45;
 export declare const DEFAULT_OUTGOING_CALL_TIMEOUT = 60;
 export declare const DEFAULT_FULFILL_ANSWER_CALL_TIMEOUT = 30;
+/**
+ * Action for the package-internal call-event broadcast (Android). The
+ * `androidEventReceiver` plugin prop registers the manifest receiver for it.
+ */
+export declare const ANDROID_CALL_EVENT_ACTION = "expo.modules.callkittelecom.ACTION_CALL_EVENT";

package/plugin/build/constants.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_FULFILL_ANSWER_CALL_TIMEOUT = exports.DEFAULT_OUTGOING_CALL_TIMEOUT = exports.DEFAULT_INCOMING_CALL_TIMEOUT = void 0;
+exports.ANDROID_CALL_EVENT_ACTION = exports.DEFAULT_FULFILL_ANSWER_CALL_TIMEOUT = exports.DEFAULT_OUTGOING_CALL_TIMEOUT = exports.DEFAULT_INCOMING_CALL_TIMEOUT = void 0;
 // Default timeout values in seconds
 exports.DEFAULT_INCOMING_CALL_TIMEOUT = 45;
 exports.DEFAULT_OUTGOING_CALL_TIMEOUT = 60;
 exports.DEFAULT_FULFILL_ANSWER_CALL_TIMEOUT = 30;
+/**
+ * Action for the package-internal call-event broadcast (Android). The
+ * `androidEventReceiver` plugin prop registers the manifest receiver for it.
+ */
+exports.ANDROID_CALL_EVENT_ACTION = "expo.modules.callkittelecom.ACTION_CALL_EVENT";

package/plugin/build/withExpoCallKitTelecom.d.ts

@@ -62,6 +62,19 @@ export type ExpoCallKitTelecomPluginProps = {
      * @platform android
      */
     defaultDialtone?: string;
+    /**
+     * Class name of a `BroadcastReceiver` to register for the module's call-event
+     * broadcast, fired when a call event can't reach a live JS observer (e.g. the
+     * user declines an incoming call while the app is killed). The plugin writes
+     * the manifest `<receiver>` + `<intent-filter>`. You supply the receiver class
+     * (e.g. via a local Expo module); the plugin does not generate it.
+     *
+     * Accepts a manifest-relative name (`.CallEventReceiver`) or a fully-qualified
+     * one (`com.acme.app.CallEventReceiver`). See "Call ended while the app is
+     * killed" in the docs.
+     * @platform android
+     */
+    androidEventReceiver?: string;
 };
 declare const _default: ConfigPlugin<void | ExpoCallKitTelecomPluginProps>;
 export default _default;

package/plugin/build/withExpoCallKitTelecomAndroid.js

@@ -163,6 +163,35 @@ const withFirebaseMessagingService = (config) => {
         return config;
     });
 };
+/**
+ * Registers a manifest BroadcastReceiver for the module's call-event broadcast.
+ *
+ * Fired when a call event can't reach a live JS observer (e.g. a killed-app
+ * decline). The receiver entry uses {@link ANDROID_CALL_EVENT_ACTION}. The app
+ * supplies the receiver class itself (the plugin does not generate it).
+ */
+const withEventReceiver = (config, { androidEventReceiver }) => {
+    if (!androidEventReceiver) {
+        return config;
+    }
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const app = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+        // Remove any existing entry first (idempotent across repeated prebuilds).
+        app.receiver = (app.receiver ?? []).filter((receiver) => receiver.$["android:name"] !== androidEventReceiver);
+        app.receiver.push({
+            $: {
+                "android:name": androidEventReceiver,
+                "android:exported": "false",
+            },
+            "intent-filter": [
+                {
+                    action: [{ $: { "android:name": constants_1.ANDROID_CALL_EVENT_ACTION } }],
+                },
+            ],
+        });
+        return config;
+    });
+};
 const withExpoCallKitTelecomAndroid = (config, props) => {
     config = withTimeouts(config, props);
     config = withSounds(config, props);
@@ -172,6 +201,7 @@ const withExpoCallKitTelecomAndroid = (config, props) => {
     });
     config = withDefaultDialtone(config, props);
     config = withFirebaseMessagingService(config, props);
+    config = withEventReceiver(config, props);
     return config;
 };
 exports.withExpoCallKitTelecomAndroid = withExpoCallKitTelecomAndroid;

package/plugin/src/constants.ts

@@ -2,3 +2,10 @@
 export const DEFAULT_INCOMING_CALL_TIMEOUT = 45;
 export const DEFAULT_OUTGOING_CALL_TIMEOUT = 60;
 export const DEFAULT_FULFILL_ANSWER_CALL_TIMEOUT = 30;
+
+/**
+ * Action for the package-internal call-event broadcast (Android). The
+ * `androidEventReceiver` plugin prop registers the manifest receiver for it.
+ */
+export const ANDROID_CALL_EVENT_ACTION =
+  "expo.modules.callkittelecom.ACTION_CALL_EVENT";

package/plugin/src/withExpoCallKitTelecom.ts

@@ -67,6 +67,19 @@ export type ExpoCallKitTelecomPluginProps = {
    * @platform android
    */
   defaultDialtone?: string;
+  /**
+   * Class name of a `BroadcastReceiver` to register for the module's call-event
+   * broadcast, fired when a call event can't reach a live JS observer (e.g. the
+   * user declines an incoming call while the app is killed). The plugin writes
+   * the manifest `<receiver>` + `<intent-filter>`. You supply the receiver class
+   * (e.g. via a local Expo module); the plugin does not generate it.
+   *
+   * Accepts a manifest-relative name (`.CallEventReceiver`) or a fully-qualified
+   * one (`com.acme.app.CallEventReceiver`). See "Call ended while the app is
+   * killed" in the docs.
+   * @platform android
+   */
+  androidEventReceiver?: string;
 };
 
 const withExpoCallKitTelecom: ConfigPlugin<ExpoCallKitTelecomPluginProps | void> = (

package/plugin/src/withExpoCallKitTelecomAndroid.ts

@@ -8,6 +8,7 @@ import { copyFileSync, existsSync, mkdirSync } from "fs";
 import { basename, resolve } from "path";
 
 import {
+  ANDROID_CALL_EVENT_ACTION,
   DEFAULT_FULFILL_ANSWER_CALL_TIMEOUT,
   DEFAULT_INCOMING_CALL_TIMEOUT,
   DEFAULT_OUTGOING_CALL_TIMEOUT,
@@ -277,6 +278,47 @@ const withFirebaseMessagingService: ConfigPlugin<ExpoCallKitTelecomPluginProps>
   });
 };
 
+/**
+ * Registers a manifest BroadcastReceiver for the module's call-event broadcast.
+ *
+ * Fired when a call event can't reach a live JS observer (e.g. a killed-app
+ * decline). The receiver entry uses {@link ANDROID_CALL_EVENT_ACTION}. The app
+ * supplies the receiver class itself (the plugin does not generate it).
+ */
+const withEventReceiver: ConfigPlugin<{ androidEventReceiver?: string }> = (
+  config,
+  { androidEventReceiver },
+) => {
+  if (!androidEventReceiver) {
+    return config;
+  }
+
+  return withAndroidManifest(config, (config) => {
+    const app = AndroidConfig.Manifest.getMainApplicationOrThrow(
+      config.modResults,
+    );
+
+    // Remove any existing entry first (idempotent across repeated prebuilds).
+    app.receiver = (app.receiver ?? []).filter(
+      (receiver) => receiver.$["android:name"] !== androidEventReceiver,
+    );
+
+    app.receiver.push({
+      $: {
+        "android:name": androidEventReceiver,
+        "android:exported": "false",
+      },
+      "intent-filter": [
+        {
+          action: [{ $: { "android:name": ANDROID_CALL_EVENT_ACTION } }],
+        },
+      ],
+    });
+
+    return config;
+  });
+};
+
 export const withExpoCallKitTelecomAndroid: ConfigPlugin<ExpoCallKitTelecomPluginProps> = (
   config,
   props,
@@ -289,5 +331,6 @@ export const withExpoCallKitTelecomAndroid: ConfigPlugin<ExpoCallKitTelecomPlugi
   });
   config = withDefaultDialtone(config, props);
   config = withFirebaseMessagingService(config, props);
+  config = withEventReceiver(config, props);
   return config;
 };

package/src/Calls.types.ts

@@ -312,6 +312,22 @@ export interface CallActionEvent extends NativeEvent {
   id: string;
 }
 
+/**
+ * Mixin for events that carry a full {@link CallSession} snapshot alongside the
+ * event-specific fields.
+ *
+ * Terminal events embed the session so consumers without access to the session
+ * store still get full context. On Android this is also what makes the
+ * package-internal call-event broadcast self-contained when no JS observer is
+ * alive (see "Call ended while the app is killed" in the docs) — the broadcast
+ * payload is exactly this event body.
+ *
+ * @category Call Events
+ */
+export interface WithSession {
+  session: CallSession;
+}
+
 /**
  * Fired after `startOutgoingCall`, once the OS has accepted the call request.
  *
@@ -371,7 +387,7 @@ export interface CallAnsweredEvent extends CallActionEvent {
  *
  * @category Call Events
  */
-export interface CallEndedEvent extends CallActionEvent {}
+export interface CallEndedEvent extends CallActionEvent, WithSession {}
 
 /**
  * Reason a call was ended, reported on {@link CallReportedEnded}.
@@ -392,7 +408,7 @@ export type CallEndedReason =
  *
  * @category Call Events
  */
-export interface CallReportedEnded extends CallActionEvent {
+export interface CallReportedEnded extends CallActionEvent, WithSession {
   reason: CallEndedReason;
 }