expo-callkit-telecom 0.2.7 → 0.3.0

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.3.0"
+}

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.3.0](https://github.com/mfairley/expo-callkit-telecom/compare/v0.2.8...v0.3.0) (2026-05-17)
+
+
+### Features
+
+* **docs:** branded icon, demo gallery, social cards, SEO outlinks ([33f8bc3](https://github.com/mfairley/expo-callkit-telecom/commit/33f8bc3d6329fe04ca6f76eca452b481941fef64))
+
+
+### Documentation
+
+* **readme:** swap <video> for clickable poster <img> ([584dd1f](https://github.com/mfairley/expo-callkit-telecom/commit/584dd1f717766536e87c3b4cef3196412e606045))
+
+## [0.2.8](https://github.com/mfairley/expo-callkit-telecom/compare/v0.2.7...v0.2.8) (2026-05-16)
+
+
+### Documentation
+
+* cross-link related functions and add per-page SEO descriptions ([c03b2d4](https://github.com/mfairley/expo-callkit-telecom/commit/c03b2d4420bd15f2fd40c1ad1f20112bedc9a122))
+
 ## [0.2.7] — 2026-05-16
 
 ### Added

package/README.md

@@ -14,6 +14,39 @@ The module is opinionated about *system integration* and unopinionated about *me
   <img alt="license" src="https://img.shields.io/npm/l/expo-callkit-telecom">
 </p>
 
+<h2 align="center">📱 See it in action</h2>
+
+<table align="center">
+  <tr>
+    <th></th>
+    <th align="center">Outgoing call</th>
+    <th align="center">Incoming (banner)</th>
+    <th align="center">Incoming (full screen)</th>
+  </tr>
+  <tr>
+    <td align="center"><strong>iOS</strong></td>
+    <td align="center">
+      <a href="https://github.com/mfairley/expo-callkit-telecom/raw/main/docs/public/outgoing-call-ios.mp4" title="Click to watch — outgoing call on iOS">
+        <img src="docs/public/outgoing-call-ios-poster.jpg" alt="Outgoing call on iOS (click to watch)" width="200">
+      </a>
+    </td>
+    <td align="center"><img src="docs/public/incoming-call-banner-ios.png" alt="Incoming call banner on iOS" width="200"></td>
+    <td align="center"><img src="docs/public/incoming-call-fullscreen-ios.png" alt="Incoming call full screen on iOS" width="200"></td>
+  </tr>
+  <tr>
+    <td align="center"><strong>Android</strong></td>
+    <td align="center">
+      <a href="https://github.com/mfairley/expo-callkit-telecom/raw/main/docs/public/outgoing-call-android.mp4" title="Click to watch — outgoing call on Android">
+        <img src="docs/public/outgoing-call-android-poster.jpg" alt="Outgoing call on Android (click to watch)" width="200">
+      </a>
+    </td>
+    <td align="center"><img src="docs/public/incoming-call-banner-android.png" alt="Incoming call banner on Android" width="200"></td>
+    <td align="center"><img src="docs/public/incoming-call-fullscreen-android.png" alt="Incoming call full screen on Android" width="200"></td>
+  </tr>
+</table>
+
+<p align="center"><sub>▶︎ Click an outgoing-call thumbnail above to watch the video. Or see the full demo on the <a href="https://mfairley.github.io/expo-callkit-telecom/">docs site</a>.</sub></p>
+
 ## ✨ Features
 
 - 📱 **Native calling UI** — CallKit on iOS, Telecom incoming-call notification + full-screen intent on Android

package/build/Calls.d.ts

@@ -154,6 +154,9 @@ export declare function setRTCAudioSessionConfiguration(hasVideo: boolean): void
  * @param hasVideo - Whether to configure for video calls (uses speaker by default)
  *   or audio-only calls (uses earpiece by default).
  *
+ * @see {@link restoreAudioSession} — call this after the call ends to revert the session configuration.
+ * @see {@link getAudioSession} — inspect the resulting audio session state.
+ *
  * @category Audio
  */
 export declare function prepareAudioSessionForCall(hasVideo: boolean): void;
@@ -164,6 +167,8 @@ export declare function prepareAudioSessionForCall(hasVideo: boolean): void;
  * or to manually restore the audio session. This is called automatically when
  * the audio session is deactivated after a call ends.
  *
+ * @see {@link prepareAudioSessionForCall} — the matching setup call.
+ *
  * @category Audio
  */
 export declare function restoreAudioSession(): void;
@@ -248,6 +253,10 @@ export declare function addCallIntentReceivedListener(listener: (event: CallInte
  * );
  * ```
  *
+ * @see {@link addOutgoingCallStartedListener} for the event fired once the OS accepts the call.
+ * @see {@link reportOutgoingCallConnected} to call after the remote media stream is established.
+ * @see {@link endCall} to terminate the call from the app.
+ *
  * @category Requests
  */
 export declare function startOutgoingCall(recipient: CallParticipant, options: CallOptions): Promise<string>;
@@ -261,6 +270,9 @@ export declare function startOutgoingCall(recipient: CallParticipant, options: C
  * @param listener - Callback invoked when an outgoing call starts.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link startOutgoingCall} — the request that triggers this event.
+ * @see {@link reportOutgoingCallConnected} — the next step in the outgoing-call flow.
+ *
  * @category Call Events
  */
 export declare function addOutgoingCallStartedListener(listener: (event: OutgoingCallStartedEvent) => void): EventSubscription;
@@ -286,6 +298,10 @@ export declare function addOutgoingCallStartedListener(listener: (event: Outgoin
  * });
  * ```
  *
+ * @see {@link addIncomingCallReportedListener} — fires once the OS accepts the report.
+ * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.
+ * @see [VoIP push payload shape](https://mfairley.github.io/expo-callkit-telecom/voip-push) — the payload that drives this when called from a native push handler.
+ *
  * @category Reporters
  */
 export declare function reportIncomingCall(event: IncomingCallEvent): Promise<void>;
@@ -299,6 +315,9 @@ export declare function reportIncomingCall(event: IncomingCallEvent): Promise<vo
  * @param listener - Callback invoked when an incoming call is reported.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportIncomingCall} — the report that triggers this event.
+ * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.
+ *
  * @category Call Events
  */
 export declare function addIncomingCallReportedListener(listener: (event: IncomingCallReportedEvent) => void): EventSubscription;
@@ -310,6 +329,10 @@ export declare function addIncomingCallReportedListener(listener: (event: Incomi
  *
  * @param id - The call session ID to answer.
  *
+ * @see {@link addCallAnsweredListener} — react to user-initiated answers from the system UI; most apps listen here rather than calling this directly.
+ * @see {@link fulfillIncomingCallConnected} — call after media is established.
+ * @see {@link failIncomingCallConnected} — call if media setup fails.
+ *
  * @category Requests
  */
 export declare function answerCall(id: string): Promise<void>;
@@ -322,6 +345,10 @@ export declare function answerCall(id: string): Promise<void>;
  * @param listener - Callback invoked when a call is answered.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link answerCall} — the programmatic equivalent (rarely needed; usually the OS UI triggers answering).
+ * @see {@link fulfillIncomingCallConnected} — call after media setup completes.
+ * @see {@link failIncomingCallConnected} — call if media setup fails.
+ *
  * @category Call Events
  */
 export declare function addCallAnsweredListener(listener: (event: CallAnsweredEvent) => void): EventSubscription;
@@ -333,6 +360,9 @@ export declare function addCallAnsweredListener(listener: (event: CallAnsweredEv
  *
  * @param requestId - The request ID from the CallAnsweredEvent.
  *
+ * @see {@link addCallAnsweredListener} — the event you typically respond to before calling this.
+ * @see {@link failIncomingCallConnected} — call this instead if media setup fails.
+ *
  * @category Fulfillers
  */
 export declare function fulfillIncomingCallConnected(requestId: string): Promise<void>;
@@ -348,6 +378,9 @@ export declare function fulfillIncomingCallConnected(requestId: string): Promise
  * @param id - The call session ID.
  * @param requestId - The request ID from the CallAnsweredEvent.
  *
+ * @see {@link fulfillIncomingCallConnected} — call this on the success path.
+ * @see {@link addCallAnsweredListener} — the event you typically respond to before calling either fulfiller.
+ *
  * @category Fulfillers
  */
 export declare function failIncomingCallConnected(id: string, requestId: string): Promise<void>;
@@ -359,6 +392,9 @@ export declare function failIncomingCallConnected(id: string, requestId: string)
  *
  * @param id - The call session ID.
  *
+ * @see {@link startOutgoingCall} — the call that initiated this outgoing flow.
+ * @see {@link addOutgoingCallStartedListener} — fires when the OS accepts the request.
+ *
  * @category Reporters
  */
 export declare function reportOutgoingCallConnected(id: string): Promise<void>;
@@ -371,6 +407,9 @@ export declare function reportOutgoingCallConnected(id: string): Promise<void>;
  *
  * @param id - The call session ID to end.
  *
+ * @see {@link addCallEndedListener} — confirms the call ended.
+ * @see {@link reportCallEnded} — call this instead when the remote party hung up (a server-side signal), so the OS records the right reason.
+ *
  * @category Requests
  */
 export declare function endCall(id: string): Promise<void>;
@@ -383,6 +422,9 @@ export declare function endCall(id: string): Promise<void>;
  * @param listener - Callback invoked when a call ends.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link endCall} — the app-side request that fires this when the user ends from your UI.
+ * @see {@link reportCallEnded} — for remote-initiated ends (server tells you the other party hung up).
+ *
  * @category Call Events
  */
 export declare function addCallEndedListener(listener: (event: CallEndedEvent) => void): EventSubscription;
@@ -404,6 +446,9 @@ export declare function addCallEndedListener(listener: (event: CallEndedEvent) =
  * await reportCallEnded(callId, 'failed');
  * ```
  *
+ * @see {@link endCall} — the app-initiated path (your user ended the call).
+ * @see {@link addReportedCallEndedListener} — confirms the OS accepted the report.
+ *
  * @category Reporters
  */
 export declare function reportCallEnded(id: string, reason: CallEndedReason): Promise<void>;
@@ -416,6 +461,8 @@ export declare function reportCallEnded(id: string, reason: CallEndedReason): Pr
  * @param listener - Callback invoked when a call end is reported.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportCallEnded} — the report that triggers this event.
+ *
  * @category Call Events
  */
 export declare function addReportedCallEndedListener(listener: (event: CallReportedEnded) => void): EventSubscription;
@@ -428,6 +475,8 @@ export declare function addReportedCallEndedListener(listener: (event: CallRepor
  * @param id - The call session ID.
  * @param muted - Whether the microphone should be muted.
  *
+ * @see {@link addSetMutedActionListener} — fires when the system requests a mute change (e.g. the user pressed mute in the CallKit UI); apply the change to your media stream from there.
+ *
  * @category Requests
  */
 export declare function setMuted(id: string, muted: boolean): Promise<void>;
@@ -440,6 +489,8 @@ export declare function setMuted(id: string, muted: boolean): Promise<void>;
  * @param listener - Callback invoked when set muted action is requested.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link setMuted} — for the app-initiated direction (programmatic mute toggle).
+ *
  * @category Call Events
  */
 export declare function addSetMutedActionListener(listener: (event: SetMutedActionEvent) => void): EventSubscription;
@@ -451,6 +502,8 @@ export declare function addSetMutedActionListener(listener: (event: SetMutedActi
  * @param id - The call session ID.
  * @param enabled - Whether video is enabled.
  *
+ * @see {@link addVideoChangedListener} — the inverse direction (system-side video state changes).
+ *
  * @category Reporters
  */
 export declare function reportVideo(id: string, enabled: boolean): Promise<void>;
@@ -462,6 +515,8 @@ export declare function reportVideo(id: string, enabled: boolean): Promise<void>
  * @param listener - Callback invoked when video state changes.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportVideo} — for reporting your app's video state changes back to the system.
+ *
  * @category Call Events
  */
 export declare function addVideoChangedListener(listener: (event: VideoChangedEvent) => void): EventSubscription;
@@ -474,6 +529,8 @@ export declare function addVideoChangedListener(listener: (event: VideoChangedEv
  * @param id - The call session ID.
  * @param onHold - Whether the call should be on hold.
  *
+ * @see {@link addSetHeldActionListener} — fires when the system requests a hold-state change.
+ *
  * @category Requests
  */
 export declare function setHeld(id: string, onHold: boolean): Promise<void>;
@@ -486,6 +543,8 @@ export declare function setHeld(id: string, onHold: boolean): Promise<void>;
  * @param listener - Callback invoked when set held action is requested.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link setHeld} — for the app-initiated direction.
+ *
  * @category Call Events
  */
 export declare function addSetHeldActionListener(listener: (event: SetHeldActionEvent) => void): EventSubscription;
@@ -498,6 +557,8 @@ export declare function addSetHeldActionListener(listener: (event: SetHeldAction
  * @param id - The call session ID.
  * @param digits - The DTMF digits to play (0-9, *, #).
  *
+ * @see {@link addDTMFListener} — fires when the system requests DTMF tones (e.g. from the in-call keypad).
+ *
  * @category Requests
  */
 export declare function playDTMF(id: string, digits: string): Promise<void>;
@@ -510,6 +571,8 @@ export declare function playDTMF(id: string, digits: string): Promise<void>;
  * @param listener - Callback invoked when DTMF tones should be played.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link playDTMF} — for the app-initiated direction (programmatically play tones).
+ *
  * @category Call Events
  */
 export declare function addDTMFListener(listener: (event: DTMFEvent) => void): EventSubscription;
@@ -535,6 +598,10 @@ export declare function addDTMFListener(listener: (event: DTMFEvent) => void): E
  * });
  * ```
  *
+ * @see {@link getVoIPPushToken} — read the current token synchronously after registration.
+ * @see {@link useVoIPPushToken} — React hook that reads the token and subscribes to updates.
+ * @see {@link addVoIPPushTokenUpdatedListener} — non-React subscription to token updates.
+ *
  * @category VoIP Push
  */
 export declare function registerVoIPPush(): void;
@@ -554,6 +621,9 @@ export declare function registerVoIPPush(): void;
  * }
  * ```
  *
+ * @see {@link registerVoIPPush} — must be called once before a token is available.
+ * @see {@link useVoIPPushToken} — React hook wrapper around this + the update listener.
+ *
  * @category VoIP Push
  */
 export declare function getVoIPPushToken(): VoIPPushToken | null;
@@ -579,6 +649,9 @@ export declare function getVoIPPushToken(): VoIPPushToken | null;
  * });
  * ```
  *
+ * @see {@link useVoIPPushToken} — React hook that uses this internally; prefer it in components.
+ * @see {@link registerVoIPPush} — must be called once before any token updates fire.
+ *
  * @category VoIP Push
  */
 export declare function addVoIPPushTokenUpdatedListener(listener: (event: VoIPPushTokenUpdatedEvent) => void): EventSubscription;

package/build/Calls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Calls.d.ts","sourceRoot":"","sources":["../src/Calls.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Calls.d.ts","sourceRoot":"","sources":["../src/Calls.ts"],"names":[],"mappings":"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"}

package/build/Calls.js

@@ -183,6 +183,9 @@ export function setRTCAudioSessionConfiguration(hasVideo) {
  * @param hasVideo - Whether to configure for video calls (uses speaker by default)
  *   or audio-only calls (uses earpiece by default).
  *
+ * @see {@link restoreAudioSession} — call this after the call ends to revert the session configuration.
+ * @see {@link getAudioSession} — inspect the resulting audio session state.
+ *
  * @category Audio
  */
 export function prepareAudioSessionForCall(hasVideo) {
@@ -195,6 +198,8 @@ export function prepareAudioSessionForCall(hasVideo) {
  * or to manually restore the audio session. This is called automatically when
  * the audio session is deactivated after a call ends.
  *
+ * @see {@link prepareAudioSessionForCall} — the matching setup call.
+ *
  * @category Audio
  */
 export function restoreAudioSession() {
@@ -297,6 +302,10 @@ export function addCallIntentReceivedListener(listener) {
  * );
  * ```
  *
+ * @see {@link addOutgoingCallStartedListener} for the event fired once the OS accepts the call.
+ * @see {@link reportOutgoingCallConnected} to call after the remote media stream is established.
+ * @see {@link endCall} to terminate the call from the app.
+ *
  * @category Requests
  */
 export async function startOutgoingCall(recipient, options) {
@@ -312,6 +321,9 @@ export async function startOutgoingCall(recipient, options) {
  * @param listener - Callback invoked when an outgoing call starts.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link startOutgoingCall} — the request that triggers this event.
+ * @see {@link reportOutgoingCallConnected} — the next step in the outgoing-call flow.
+ *
  * @category Call Events
  */
 export function addOutgoingCallStartedListener(listener) {
@@ -342,6 +354,10 @@ export function addOutgoingCallStartedListener(listener) {
  * });
  * ```
  *
+ * @see {@link addIncomingCallReportedListener} — fires once the OS accepts the report.
+ * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.
+ * @see [VoIP push payload shape](https://mfairley.github.io/expo-callkit-telecom/voip-push) — the payload that drives this when called from a native push handler.
+ *
  * @category Reporters
  */
 export async function reportIncomingCall(event) {
@@ -357,6 +373,9 @@ export async function reportIncomingCall(event) {
  * @param listener - Callback invoked when an incoming call is reported.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportIncomingCall} — the report that triggers this event.
+ * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.
+ *
  * @category Call Events
  */
 export function addIncomingCallReportedListener(listener) {
@@ -373,6 +392,10 @@ export function addIncomingCallReportedListener(listener) {
  *
  * @param id - The call session ID to answer.
  *
+ * @see {@link addCallAnsweredListener} — react to user-initiated answers from the system UI; most apps listen here rather than calling this directly.
+ * @see {@link fulfillIncomingCallConnected} — call after media is established.
+ * @see {@link failIncomingCallConnected} — call if media setup fails.
+ *
  * @category Requests
  */
 export async function answerCall(id) {
@@ -387,6 +410,10 @@ export async function answerCall(id) {
  * @param listener - Callback invoked when a call is answered.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link answerCall} — the programmatic equivalent (rarely needed; usually the OS UI triggers answering).
+ * @see {@link fulfillIncomingCallConnected} — call after media setup completes.
+ * @see {@link failIncomingCallConnected} — call if media setup fails.
+ *
  * @category Call Events
  */
 export function addCallAnsweredListener(listener) {
@@ -403,6 +430,9 @@ export function addCallAnsweredListener(listener) {
  *
  * @param requestId - The request ID from the CallAnsweredEvent.
  *
+ * @see {@link addCallAnsweredListener} — the event you typically respond to before calling this.
+ * @see {@link failIncomingCallConnected} — call this instead if media setup fails.
+ *
  * @category Fulfillers
  */
 export async function fulfillIncomingCallConnected(requestId) {
@@ -420,6 +450,9 @@ export async function fulfillIncomingCallConnected(requestId) {
  * @param id - The call session ID.
  * @param requestId - The request ID from the CallAnsweredEvent.
  *
+ * @see {@link fulfillIncomingCallConnected} — call this on the success path.
+ * @see {@link addCallAnsweredListener} — the event you typically respond to before calling either fulfiller.
+ *
  * @category Fulfillers
  */
 export async function failIncomingCallConnected(id, requestId) {
@@ -441,6 +474,9 @@ export async function failIncomingCallConnected(id, requestId) {
  *
  * @param id - The call session ID.
  *
+ * @see {@link startOutgoingCall} — the call that initiated this outgoing flow.
+ * @see {@link addOutgoingCallStartedListener} — fires when the OS accepts the request.
+ *
  * @category Reporters
  */
 export async function reportOutgoingCallConnected(id) {
@@ -458,6 +494,9 @@ export async function reportOutgoingCallConnected(id) {
  *
  * @param id - The call session ID to end.
  *
+ * @see {@link addCallEndedListener} — confirms the call ended.
+ * @see {@link reportCallEnded} — call this instead when the remote party hung up (a server-side signal), so the OS records the right reason.
+ *
  * @category Requests
  */
 export async function endCall(id) {
@@ -472,6 +511,9 @@ export async function endCall(id) {
  * @param listener - Callback invoked when a call ends.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link endCall} — the app-side request that fires this when the user ends from your UI.
+ * @see {@link reportCallEnded} — for remote-initiated ends (server tells you the other party hung up).
+ *
  * @category Call Events
  */
 export function addCallEndedListener(listener) {
@@ -495,6 +537,9 @@ export function addCallEndedListener(listener) {
  * await reportCallEnded(callId, 'failed');
  * ```
  *
+ * @see {@link endCall} — the app-initiated path (your user ended the call).
+ * @see {@link addReportedCallEndedListener} — confirms the OS accepted the report.
+ *
  * @category Reporters
  */
 export async function reportCallEnded(id, reason) {
@@ -509,6 +554,8 @@ export async function reportCallEnded(id, reason) {
  * @param listener - Callback invoked when a call end is reported.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportCallEnded} — the report that triggers this event.
+ *
  * @category Call Events
  */
 export function addReportedCallEndedListener(listener) {
@@ -526,6 +573,8 @@ export function addReportedCallEndedListener(listener) {
  * @param id - The call session ID.
  * @param muted - Whether the microphone should be muted.
  *
+ * @see {@link addSetMutedActionListener} — fires when the system requests a mute change (e.g. the user pressed mute in the CallKit UI); apply the change to your media stream from there.
+ *
  * @category Requests
  */
 export async function setMuted(id, muted) {
@@ -540,6 +589,8 @@ export async function setMuted(id, muted) {
  * @param listener - Callback invoked when set muted action is requested.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link setMuted} — for the app-initiated direction (programmatic mute toggle).
+ *
  * @category Call Events
  */
 export function addSetMutedActionListener(listener) {
@@ -556,6 +607,8 @@ export function addSetMutedActionListener(listener) {
  * @param id - The call session ID.
  * @param enabled - Whether video is enabled.
  *
+ * @see {@link addVideoChangedListener} — the inverse direction (system-side video state changes).
+ *
  * @category Reporters
  */
 export async function reportVideo(id, enabled) {
@@ -569,6 +622,8 @@ export async function reportVideo(id, enabled) {
  * @param listener - Callback invoked when video state changes.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportVideo} — for reporting your app's video state changes back to the system.
+ *
  * @category Call Events
  */
 export function addVideoChangedListener(listener) {
@@ -586,6 +641,8 @@ export function addVideoChangedListener(listener) {
  * @param id - The call session ID.
  * @param onHold - Whether the call should be on hold.
  *
+ * @see {@link addSetHeldActionListener} — fires when the system requests a hold-state change.
+ *
  * @category Requests
  */
 export async function setHeld(id, onHold) {
@@ -600,6 +657,8 @@ export async function setHeld(id, onHold) {
  * @param listener - Callback invoked when set held action is requested.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link setHeld} — for the app-initiated direction.
+ *
  * @category Call Events
  */
 export function addSetHeldActionListener(listener) {
@@ -617,6 +676,8 @@ export function addSetHeldActionListener(listener) {
  * @param id - The call session ID.
  * @param digits - The DTMF digits to play (0-9, *, #).
  *
+ * @see {@link addDTMFListener} — fires when the system requests DTMF tones (e.g. from the in-call keypad).
+ *
  * @category Requests
  */
 export async function playDTMF(id, digits) {
@@ -631,6 +692,8 @@ export async function playDTMF(id, digits) {
  * @param listener - Callback invoked when DTMF tones should be played.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link playDTMF} — for the app-initiated direction (programmatically play tones).
+ *
  * @category Call Events
  */
 export function addDTMFListener(listener) {
@@ -661,6 +724,10 @@ export function addDTMFListener(listener) {
  * });
  * ```
  *
+ * @see {@link getVoIPPushToken} — read the current token synchronously after registration.
+ * @see {@link useVoIPPushToken} — React hook that reads the token and subscribes to updates.
+ * @see {@link addVoIPPushTokenUpdatedListener} — non-React subscription to token updates.
+ *
  * @category VoIP Push
  */
 export function registerVoIPPush() {
@@ -682,6 +749,9 @@ export function registerVoIPPush() {
  * }
  * ```
  *
+ * @see {@link registerVoIPPush} — must be called once before a token is available.
+ * @see {@link useVoIPPushToken} — React hook wrapper around this + the update listener.
+ *
  * @category VoIP Push
  */
 export function getVoIPPushToken() {
@@ -715,6 +785,9 @@ export function getVoIPPushToken() {
  * });
  * ```
  *
+ * @see {@link useVoIPPushToken} — React hook that uses this internally; prefer it in components.
+ * @see {@link registerVoIPPush} — must be called once before any token updates fire.
+ *
  * @category VoIP Push
  */
 export function addVoIPPushTokenUpdatedListener(listener) {

package/build/Calls.js.map

@@ -1 +1 @@
-{"version":3,"file":"Calls.js","sourceRoot":"","sources":["../src/Calls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA8BxC,OAAO,wBAAwB,MAAM,4BAA4B,CAAC;AAElE,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,oBAAoB,EAAE,CAAC;IACtE,IAAI,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAgD;IAEhD,OAAO,wBAAwB,CAAC,WAAW,CACzC,oBAAoB,EACpB,CAAC,KAA4B,EAAE,EAAE;QAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAAkD;IAElD,OAAO,wBAAwB,CAAC,WAAW,CACzC,sBAAsB,EACtB,CAAC,KAA8B,EAAE,EAAE;QACjC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAAkD;IAElD,OAAO,wBAAwB,CAAC,WAAW,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,wBAAwB,CAAC,oBAAoB,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,wBAAwB,CAAC,sBAAsB,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAAC,QAAiB;IAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,wBAAwB,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAiB;IAC1D,wBAAwB,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,wBAAwB,CAAC,mBAAmB,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAAqD;IAErD,OAAO,wBAAwB,CAAC,WAAW,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAuD;IAEvD,OAAO,wBAAwB,CAAC,WAAW,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;AACrF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAiD;IAEjD,OAAO,wBAAwB,CAAC,WAAW,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAC3C,QAAkD;IAElD,OAAO,wBAAwB,CAAC,WAAW,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA0B,EAC1B,OAAoB;IAEpB,OAAO,MAAM,wBAAwB,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAAmD;IAEnD,OAAO,wBAAwB,CAAC,WAAW,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB;IAExB,MAAM,wBAAwB,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAoD;IAEpD,OAAO,wBAAwB,CAAC,WAAW,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU;IACzC,MAAM,wBAAwB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA4C;IAE5C,OAAO,wBAAwB,CAAC,WAAW,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,SAAiB;IAEjB,MAAM,wBAAwB,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,EAAU,EACV,SAAiB;IAEjB,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,wBAAwB,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,MAAM,wBAAwB,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,EAAU;IAC1D,MAAM,wBAAwB,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAU;IACtC,MAAM,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAyC;IAEzC,OAAO,wBAAwB,CAAC,WAAW,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAU,EACV,MAAuB;IAEvB,MAAM,wBAAwB,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAA4C;IAE5C,OAAO,wBAAwB,CAAC,WAAW,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,KAAc;IACvD,MAAM,wBAAwB,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA8C;IAE9C,OAAO,wBAAwB,CAAC,WAAW,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU,EAAE,OAAgB;IAC5D,MAAM,wBAAwB,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA4C;IAE5C,OAAO,wBAAwB,CAAC,WAAW,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAU,EAAE,MAAe;IACvD,MAAM,wBAAwB,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA6C;IAE7C,OAAO,wBAAwB,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,MAAc;IACvD,MAAM,wBAAwB,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAoC;IAEpC,OAAO,wBAAwB,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAqB;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAoD;IAEpD,OAAO,wBAAwB,CAAC,WAAW,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AAClF,CAAC","sourcesContent":["/**\n * @module Calls\n *\n * This module provides APIs for managing VoIP calls with native system integration.\n * Functions are organized into three categories:\n *\n * ## Requests (Imperative)\n * Functions that initiate actions from the app. These request the system to perform\n * an operation on behalf of the user:\n * - {@link startOutgoingCall} - Start a new outgoing call\n * - {@link answerCall} - Answer an incoming call\n * - {@link endCall} - End or decline an active call\n * - {@link setMuted} - Mute/unmute the call\n * - {@link setHeld} - Hold/unhold the call\n * - {@link playDTMF} - Play DTMF tones\n *\n * ## Reporters\n * Functions that report state changes to the system. Use these to inform the system\n * about events that occurred outside of its control (e.g., from your backend or\n * media connection):\n * - {@link reportIncomingCall} - Report a new incoming call (e.g., from push notification)\n * - {@link reportOutgoingCallConnected} - Report that an outgoing call's media is connected\n * - {@link reportCallEnded} - Report that a call ended externally (e.g., remote hangup)\n * - {@link reportVideo} - Report video state changes\n *\n * ## Fulfillers\n * Functions that complete pending system requests. When the system requests an action\n * (via event listeners), your app must perform the action and then call the corresponding\n * fulfiller to confirm completion:\n * - {@link fulfillIncomingCallConnected} - Confirm that incoming call media is connected\n *\n * ## Typical Flow\n *\n * **Outgoing Call:**\n * 1. Call {@link startOutgoingCall} to initiate\n * 2. Listen for {@link addCallStartedListener} to know when to connect media\n * 3. Connect your media (e.g., WebRTC)\n * 4. Call {@link reportOutgoingCallConnected} when media is ready\n *\n * **Incoming Call:**\n * 1. Receive push notification with call data\n * 2. Call {@link reportIncomingCall} to show the incoming call UI\n * 3. Listen for {@link addCallAnsweredListener} to know when user answered\n * 4. Connect your media (e.g., WebRTC)\n * 5. Call {@link fulfillIncomingCallConnected} when media is ready\n *\n * **Ending a Call:**\n * - If user ends: Call {@link endCall} and clean up media\n * - If remote ends: Clean up media, then call {@link reportCallEnded}\n */\n\nimport type { EventSubscription } from \"expo-modules-core\";\nimport { Platform } from \"react-native\";\n\nimport type {\n  AudioRouteChangedEvent,\n  AudioSession,\n  AudioSessionActivatedEvent,\n  AudioSessionDeactivatedEvent,\n  CallAnsweredEvent,\n  CallEndedEvent,\n  CallEndedReason,\n  CallIntentReceivedEvent,\n  CallOptions,\n  CallParticipant,\n  CallReportedEnded,\n  CallSession,\n  CallSessionAddedEvent,\n  CallSessionRemovedEvent,\n  CallSessionUpdatedEvent,\n  CaptureSession,\n  DTMFEvent,\n  IncomingCallEvent,\n  IncomingCallReportedEvent,\n  OutgoingCallStartedEvent,\n  SetHeldActionEvent,\n  SetMutedActionEvent,\n  VideoChangedEvent,\n  VoIPPushToken,\n  VoIPPushTokenUpdatedEvent,\n} from \"./Calls.types\";\nimport type { PushTokenType } from \"./Calls.types\";\nimport ExpoCallKitTelecomModule from \"./ExpoCallKitTelecomModule\";\n\n// ============================================================================\n// Call Session\n// ============================================================================\n\n/**\n * Gets the currently active call session, if any.\n *\n * @returns The active call session, or `null` if no call is in progress.\n *\n * @example\n * ```typescript\n * const session = await getActiveCallSession();\n * if (session) {\n *   console.log('Active call with:', session.remoteParticipants[0]?.displayName);\n * }\n * ```\n *\n * @category Sessions\n */\nexport async function getActiveCallSession(): Promise<CallSession | null> {\n  const session = await ExpoCallKitTelecomModule.getActiveCallSession();\n  if (session) {\n  }\n  return session;\n}\n\n/**\n * Subscribes to call session added events.\n *\n * Fired when a new call session is created, either from an outgoing call request\n * or an incoming call report.\n *\n * @param listener - Callback invoked when a session is added.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @example\n * ```typescript\n * const subscription = addCallSessionAddedListener((event) => {\n *   console.log('New call session:', event.session.id);\n * });\n *\n * // Later, to unsubscribe:\n * subscription.remove();\n * ```\n *\n * @category Sessions\n */\nexport function addCallSessionAddedListener(\n  listener: (event: CallSessionAddedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\n    \"onCallSessionAdded\",\n    (event: CallSessionAddedEvent) => {\n      listener(event);\n    },\n  );\n}\n\n/**\n * Subscribes to call session updated events.\n *\n * Fired when an existing call session's state changes (e.g., status, mute state).\n *\n * @param listener - Callback invoked when a session is updated.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Sessions\n */\nexport function addCallSessionUpdatedListener(\n  listener: (event: CallSessionUpdatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\n    \"onCallSessionUpdated\",\n    (event: CallSessionUpdatedEvent) => {\n      listener(event);\n    },\n  );\n}\n\n/**\n * Subscribes to call session removed events.\n *\n * Fired when a call session is removed after the call has ended and been cleaned up.\n *\n * @param listener - Callback invoked when a session is removed.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Sessions\n */\nexport function addCallSessionRemovedListener(\n  listener: (event: CallSessionRemovedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallSessionRemoved\", listener);\n}\n\n// ============================================================================\n// Audio Session\n// ============================================================================\n\n/**\n * Gets the current audio session state.\n *\n * Returns information about the audio session including whether it's active,\n * the current category/mode, and the audio route (speaker, earpiece, etc.).\n *\n * @returns The current audio session state.\n *\n * @category Audio\n */\nexport function getAudioSession(): AudioSession {\n  return ExpoCallKitTelecomModule.getAudioSessionState();\n}\n\n/**\n * Gets the current capture session state.\n *\n * Returns information about the capture session including camera permission status.\n *\n * @returns The current capture session state.\n *\n * @category Capture\n */\nexport function getCaptureSession(): CaptureSession {\n  return ExpoCallKitTelecomModule.getCaptureSessionState();\n}\n\n/**\n * Sets the RTC audio session configuration (iOS only).\n *\n * This sets up WebRTC's RTCAudioSession default configuration and enables manual\n * audio management. On Android this is a no-op — audio configuration is handled\n * by {@link prepareAudioSessionForCall}.\n *\n * @param hasVideo - Whether to configure for video calls (uses speaker by default)\n *   or audio-only calls (uses earpiece by default).\n *\n * @category Audio\n */\nexport function setRTCAudioSessionConfiguration(hasVideo: boolean): void {\n  if (Platform.OS === \"ios\") {\n    ExpoCallKitTelecomModule.setRTCAudioSessionConfiguration(hasVideo);\n  }\n}\n\n/**\n * Prepares the audio session for an upcoming call.\n *\n * This snapshots the current audio configuration (for later restoration) and\n * pre-configures the audio session for the call. Called automatically when\n * reporting/starting a call, but can be called manually for early preparation.\n *\n * @param hasVideo - Whether to configure for video calls (uses speaker by default)\n *   or audio-only calls (uses earpiece by default).\n *\n * @category Audio\n */\nexport function prepareAudioSessionForCall(hasVideo: boolean): void {\n  ExpoCallKitTelecomModule.prepareAudioSessionForCall(hasVideo);\n}\n\n/**\n * Restores the audio session to its pre-call configuration.\n *\n * Call this if a call fails to start after prepareAudioSessionForCall was called,\n * or to manually restore the audio session. This is called automatically when\n * the audio session is deactivated after a call ends.\n *\n * @category Audio\n */\nexport function restoreAudioSession(): void {\n  ExpoCallKitTelecomModule.restoreAudioSession();\n}\n\n/**\n * Sets the audio session port override.\n *\n * Use this to route audio to the speaker instead of the earpiece, or vice versa.\n *\n * @param enabled - If `true`, routes audio to the speaker. If `false`, uses\n *   the default route (typically earpiece for voice calls).\n *\n * @category Audio\n */\nexport function setAudioSessionPortOverride(enabled: boolean): void {\n  ExpoCallKitTelecomModule.setAudioSessionPortOverride(enabled);\n}\n\n/**\n * Subscribes to audio session activated events.\n *\n * Fired when the audio session is activated for a call. This is when your\n * app gains exclusive access to audio hardware.\n *\n * @param listener - Callback invoked when audio session activates.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Audio Events\n */\nexport function addAudioSessionActivatedListener(\n  listener: (event: AudioSessionActivatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onAudioSessionActivated\", listener);\n}\n\n/**\n * Subscribes to audio session deactivated events.\n *\n * Fired when the audio session is deactivated after a call ends.\n *\n * @param listener - Callback invoked when audio session deactivates.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Audio Events\n */\nexport function addAudioSessionDeactivatedListener(\n  listener: (event: AudioSessionDeactivatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onAudioSessionDeactivated\", listener);\n}\n\n/**\n * Subscribes to audio route changed events.\n *\n * Fired when the audio route changes (e.g., user connects Bluetooth headphones,\n * toggles speaker mode).\n *\n * @param listener - Callback invoked when audio route changes.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Audio Events\n */\nexport function addAudioRouteChangedListener(\n  listener: (event: AudioRouteChangedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onAudioRouteChanged\", listener);\n}\n\n// ============================================================================\n// Call Intent Event Listeners\n// ============================================================================\n\n/**\n * Subscribes to call intent received events.\n *\n * Fired when the user initiates a call from outside the app, such as tapping\n * a contact in the iOS Recents list or via Siri. The event contains the handle\n * (phone number/email) and whether video is requested.\n *\n * The app should resolve the handle to a known recipient and call\n * {@link startOutgoingCall} to fulfill the intent.\n *\n * @param listener - Callback invoked when a call intent is received.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addCallIntentReceivedListener(\n  listener: (event: CallIntentReceivedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallIntentReceived\", listener);\n}\n\n// ============================================================================\n// Start Outgoing Call\n// ============================================================================\n\n/**\n * Starts an outgoing call to the specified recipient.\n *\n * This requests the system to initiate a call. The system will display the\n * appropriate call UI and emit an {@link OutgoingCallStartedEvent} when you should\n * begin connecting your media.\n *\n * @param recipient - The participant to call.\n * @param options - Call configuration options (e.g., video enabled).\n * @returns The unique identifier for this call session.\n *\n * @example\n * ```typescript\n * const callId = await startOutgoingCall(\n *   { id: 'user-123', displayName: 'John Doe' },\n *   { hasVideo: true }\n * );\n * ```\n *\n * @category Requests\n */\nexport async function startOutgoingCall(\n  recipient: CallParticipant,\n  options: CallOptions,\n): Promise<string> {\n  return await ExpoCallKitTelecomModule.startOutgoingCall(recipient, options);\n}\n\n/**\n * Subscribes to outgoing call started events.\n *\n * Fired when an outgoing call (initiated via {@link startOutgoingCall}) has\n * been accepted by the system. You should provision your media connection\n * and begin connecting.\n *\n * @param listener - Callback invoked when an outgoing call starts.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addOutgoingCallStartedListener(\n  listener: (event: OutgoingCallStartedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onOutgoingCallStarted\", listener);\n}\n\n// ============================================================================\n// Report Incoming Call\n// ============================================================================\n\n/**\n * Reports an incoming call to the system.\n *\n * Call this when you receive a push notification or other signal indicating\n * an incoming call. The system will display the incoming call UI.\n *\n * @param event - The incoming call event containing caller information.\n *\n * @example\n * ```typescript\n * await reportIncomingCall({\n *   callId: '550e8400-e29b-41d4-a716-446655440000',\n *   caller: {\n *     id: 'user-456',\n *     displayName: 'Jane Smith',\n *     phoneNumber: '+1234567890',\n *   },\n *   hasVideo: false,\n *   startedAt: new Date(),\n * });\n * ```\n *\n * @category Reporters\n */\nexport async function reportIncomingCall(\n  event: IncomingCallEvent,\n): Promise<void> {\n  await ExpoCallKitTelecomModule.reportIncomingCall(event);\n}\n\n/**\n * Subscribes to incoming call reported events.\n *\n * Fired after an incoming call has been successfully reported to the system\n * and the call session has been added to the store. Use this to set up\n * early subscriptions (e.g., call signaling) before the call is answered.\n *\n * @param listener - Callback invoked when an incoming call is reported.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addIncomingCallReportedListener(\n  listener: (event: IncomingCallReportedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onIncomingCallReported\", listener);\n}\n\n// ============================================================================\n// Answer Call\n// ============================================================================\n\n/**\n * Answers an incoming call.\n *\n * Use this when the user taps an answer button in your app's custom UI.\n * The system will emit a {@link CallAnsweredEvent} to confirm the answer.\n *\n * @param id - The call session ID to answer.\n *\n * @category Requests\n */\nexport async function answerCall(id: string): Promise<void> {\n  await ExpoCallKitTelecomModule.answerCall(id);\n}\n\n/**\n * Subscribes to call answered events.\n *\n * Fired when the user answers an incoming call (either from the system UI or\n * via {@link answerCall}). You should begin connecting your media.\n *\n * @param listener - Callback invoked when a call is answered.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addCallAnsweredListener(\n  listener: (event: CallAnsweredEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallAnswered\", listener);\n}\n\n// ============================================================================\n// Fulfill Incoming Call\n// ============================================================================\n\n/**\n * Fulfills an incoming call by confirming the media connection is established.\n *\n * Call this after the user answers an incoming call and your media connection\n * (e.g., WebRTC) is fully connected and ready for audio/video.\n *\n * @param requestId - The request ID from the CallAnsweredEvent.\n *\n * @category Fulfillers\n */\nexport async function fulfillIncomingCallConnected(\n  requestId: string,\n): Promise<void> {\n  await ExpoCallKitTelecomModule.fulfillIncomingCallAnswered(requestId);\n}\n\n/**\n * Fails a pending incoming call connection request.\n *\n * Call this when the answer flow fails before media is connected\n * (e.g., API error). On iOS, causes CXAnswerCallAction to fail, which\n * triggers CallKit to end the call via CXEndCallAction. On Android,\n * ends the call via {@link reportCallEnded} which also cancels any\n * pending fulfill request.\n *\n * @param id - The call session ID.\n * @param requestId - The request ID from the CallAnsweredEvent.\n *\n * @category Fulfillers\n */\nexport async function failIncomingCallConnected(\n  id: string,\n  requestId: string,\n): Promise<void> {\n  if (Platform.OS === \"ios\") {\n    await ExpoCallKitTelecomModule.failIncomingCallConnected(requestId);\n  } else {\n    await ExpoCallKitTelecomModule.reportCallEnded(id, \"failed\");\n  }\n}\n\n// ============================================================================\n// Report Outgoing Call Connected\n// ============================================================================\n\n/**\n * Reports that an outgoing call's media connection is established.\n *\n * Call this after starting an outgoing call and your media connection\n * (e.g., WebRTC) is fully connected and the remote party has answered.\n *\n * @param id - The call session ID.\n *\n * @category Reporters\n */\nexport async function reportOutgoingCallConnected(id: string): Promise<void> {\n  await ExpoCallKitTelecomModule.reportOutgoingCallConnected(id);\n}\n\n// ============================================================================\n// End Call\n// ============================================================================\n\n/**\n * Ends an active call.\n *\n * Requests the system to end the call. The system will emit a {@link CallEndedEvent}\n * to notify that the call has ended. Clean up your media connection when you receive\n * this event.\n *\n * @param id - The call session ID to end.\n *\n * @category Requests\n */\nexport async function endCall(id: string): Promise<void> {\n  await ExpoCallKitTelecomModule.endCall(id);\n}\n\n/**\n * Subscribes to call ended events.\n *\n * Fired when a call has ended (e.g., user pressed end button).\n * Clean up your media connection when you receive this event.\n *\n * @param listener - Callback invoked when a call ends.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addCallEndedListener(\n  listener: (event: CallEndedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallEnded\", listener);\n}\n\n/**\n * Reports that a call has ended for an external reason.\n *\n * Use this when a call ends due to reasons outside the local user's control,\n * such as: remote party hung up, network failure, call declined elsewhere, etc.\n *\n * @param id - The call session ID.\n * @param reason - The reason the call ended.\n *\n * @example\n * ```typescript\n * // Remote party hung up\n * await reportCallEnded(callId, 'remoteEnded');\n *\n * // Call failed due to network error\n * await reportCallEnded(callId, 'failed');\n * ```\n *\n * @category Reporters\n */\nexport async function reportCallEnded(\n  id: string,\n  reason: CallEndedReason,\n): Promise<void> {\n  await ExpoCallKitTelecomModule.reportCallEnded(id, reason);\n}\n\n/**\n * Subscribes to reported call ended events.\n *\n * Fired after {@link reportCallEnded} is called, confirming the system has\n * been notified of the externally-ended call.\n *\n * @param listener - Callback invoked when a call end is reported.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addReportedCallEndedListener(\n  listener: (event: CallReportedEnded) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallReportedEnded\", listener);\n}\n\n// ============================================================================\n// Mute Support\n// ============================================================================\n\n/**\n * Changes the mute state of a call.\n *\n * The system will emit a {@link SetMutedActionEvent}. Apply the mute state to\n * your media connection when you receive this event.\n *\n * @param id - The call session ID.\n * @param muted - Whether the microphone should be muted.\n *\n * @category Requests\n */\nexport async function setMuted(id: string, muted: boolean): Promise<void> {\n  await ExpoCallKitTelecomModule.setMuted(id, muted);\n}\n\n/**\n * Subscribes to set muted action events.\n *\n * Fired when the system requests to set the mute state (e.g., user pressed mute button).\n * Apply the change to your media connection when you receive this event.\n *\n * @param listener - Callback invoked when set muted action is requested.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addSetMutedActionListener(\n  listener: (event: SetMutedActionEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onSetMutedAction\", listener);\n}\n\n// ============================================================================\n// Video Support\n// ============================================================================\n\n/**\n * Reports a video state change for a call.\n *\n * Use this to inform the system when video is enabled or disabled.\n *\n * @param id - The call session ID.\n * @param enabled - Whether video is enabled.\n *\n * @category Reporters\n */\nexport async function reportVideo(id: string, enabled: boolean): Promise<void> {\n  await ExpoCallKitTelecomModule.reportVideo(id, enabled);\n}\n\n/**\n * Subscribes to video state change events.\n *\n * Fired when the video state changes for a call.\n *\n * @param listener - Callback invoked when video state changes.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addVideoChangedListener(\n  listener: (event: VideoChangedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onVideoChanged\", listener);\n}\n\n// ============================================================================\n// Hold Support\n// ============================================================================\n\n/**\n * Changes the hold state of a call.\n *\n * The system will emit a {@link SetHeldActionEvent}. Apply the hold state to\n * your media connection when you receive this event.\n *\n * @param id - The call session ID.\n * @param onHold - Whether the call should be on hold.\n *\n * @category Requests\n */\nexport async function setHeld(id: string, onHold: boolean): Promise<void> {\n  await ExpoCallKitTelecomModule.setHeld(id, onHold);\n}\n\n/**\n * Subscribes to set held action events.\n *\n * Fired when the system requests to set the hold state. Apply the change to\n * your media connection when you receive this event.\n *\n * @param listener - Callback invoked when set held action is requested.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addSetHeldActionListener(\n  listener: (event: SetHeldActionEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onSetHeldAction\", listener);\n}\n\n// ============================================================================\n// DTMF Support\n// ============================================================================\n\n/**\n * Plays DTMF tones during a call.\n *\n * The system will emit a {@link DTMFEvent}. Send the tones through your media\n * connection when you receive this event.\n *\n * @param id - The call session ID.\n * @param digits - The DTMF digits to play (0-9, *, #).\n *\n * @category Requests\n */\nexport async function playDTMF(id: string, digits: string): Promise<void> {\n  await ExpoCallKitTelecomModule.playDTMF(id, digits);\n}\n\n/**\n * Subscribes to DTMF events.\n *\n * Fired when DTMF tones should be played. Send the tones through your media\n * connection when you receive this event.\n *\n * @param listener - Callback invoked when DTMF tones should be played.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addDTMFListener(\n  listener: (event: DTMFEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onDTMF\", listener);\n}\n\n// ============================================================================\n// VoIP Push\n// ============================================================================\n\n/**\n * Registers for VoIP push notifications.\n *\n * Call this early in your app lifecycle to receive VoIP push notifications\n * for incoming calls. Once registered, the device token will be available\n * via {@link getVoIPPushToken} and token updates will be emitted via\n * {@link addVoIPPushTokenUpdatedListener}.\n *\n * @example\n * ```typescript\n * // Register early in app initialization\n * registerVoIPPush();\n *\n * // Listen for token updates\n * addVoIPPushTokenUpdatedListener((event) => {\n *   if (event.token) {\n *     // Send token to your backend\n *     sendTokenToBackend(event.token);\n *   }\n * });\n * ```\n *\n * @category VoIP Push\n */\nexport function registerVoIPPush(): void {\n  ExpoCallKitTelecomModule.registerVoIPPush();\n}\n\n/**\n * Gets the current VoIP push token and its type.\n *\n * The token should be sent to your backend along with the token type\n * so the server knows how to deliver incoming call pushes.\n *\n * @returns The VoIP push token bundled with its type, or null if not yet registered.\n *\n * @example\n * ```typescript\n * const voip = getVoIPPushToken();\n * if (voip) {\n *   await sendTokenToBackend(voip.token, voip.type);\n * }\n * ```\n *\n * @category VoIP Push\n */\nexport function getVoIPPushToken(): VoIPPushToken | null {\n  const result = ExpoCallKitTelecomModule.getVoIPPushToken();\n  if (!result.token) return null;\n  return {\n    token: result.token,\n    type: result.type as PushTokenType,\n  };\n}\n\n/**\n * Subscribes to VoIP token updated events.\n *\n * Fired when the VoIP push token is received or updated after calling\n * {@link registerVoIPPush}. Also fired if the token is invalidated (with\n * `token` being `undefined`).\n *\n * @param listener - Callback invoked when the VoIP token updates.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @example\n * ```typescript\n * const subscription = addVoIPPushTokenUpdatedListener((event) => {\n *   if (event.token) {\n *     console.log('New VoIP token:', event.token);\n *     sendTokenToBackend(event.token);\n *   } else {\n *     console.log('VoIP token invalidated');\n *   }\n * });\n * ```\n *\n * @category VoIP Push\n */\nexport function addVoIPPushTokenUpdatedListener(\n  listener: (event: VoIPPushTokenUpdatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onVoIPPushTokenUpdated\", listener);\n}\n"]}
+{"version":3,"file":"Calls.js","sourceRoot":"","sources":["../src/Calls.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @module Calls\n *\n * This module provides APIs for managing VoIP calls with native system integration.\n * Functions are organized into three categories:\n *\n * ## Requests (Imperative)\n * Functions that initiate actions from the app. These request the system to perform\n * an operation on behalf of the user:\n * - {@link startOutgoingCall} - Start a new outgoing call\n * - {@link answerCall} - Answer an incoming call\n * - {@link endCall} - End or decline an active call\n * - {@link setMuted} - Mute/unmute the call\n * - {@link setHeld} - Hold/unhold the call\n * - {@link playDTMF} - Play DTMF tones\n *\n * ## Reporters\n * Functions that report state changes to the system. Use these to inform the system\n * about events that occurred outside of its control (e.g., from your backend or\n * media connection):\n * - {@link reportIncomingCall} - Report a new incoming call (e.g., from push notification)\n * - {@link reportOutgoingCallConnected} - Report that an outgoing call's media is connected\n * - {@link reportCallEnded} - Report that a call ended externally (e.g., remote hangup)\n * - {@link reportVideo} - Report video state changes\n *\n * ## Fulfillers\n * Functions that complete pending system requests. When the system requests an action\n * (via event listeners), your app must perform the action and then call the corresponding\n * fulfiller to confirm completion:\n * - {@link fulfillIncomingCallConnected} - Confirm that incoming call media is connected\n *\n * ## Typical Flow\n *\n * **Outgoing Call:**\n * 1. Call {@link startOutgoingCall} to initiate\n * 2. Listen for {@link addCallStartedListener} to know when to connect media\n * 3. Connect your media (e.g., WebRTC)\n * 4. Call {@link reportOutgoingCallConnected} when media is ready\n *\n * **Incoming Call:**\n * 1. Receive push notification with call data\n * 2. Call {@link reportIncomingCall} to show the incoming call UI\n * 3. Listen for {@link addCallAnsweredListener} to know when user answered\n * 4. Connect your media (e.g., WebRTC)\n * 5. Call {@link fulfillIncomingCallConnected} when media is ready\n *\n * **Ending a Call:**\n * - If user ends: Call {@link endCall} and clean up media\n * - If remote ends: Clean up media, then call {@link reportCallEnded}\n */\n\nimport type { EventSubscription } from \"expo-modules-core\";\nimport { Platform } from \"react-native\";\n\nimport type {\n  AudioRouteChangedEvent,\n  AudioSession,\n  AudioSessionActivatedEvent,\n  AudioSessionDeactivatedEvent,\n  CallAnsweredEvent,\n  CallEndedEvent,\n  CallEndedReason,\n  CallIntentReceivedEvent,\n  CallOptions,\n  CallParticipant,\n  CallReportedEnded,\n  CallSession,\n  CallSessionAddedEvent,\n  CallSessionRemovedEvent,\n  CallSessionUpdatedEvent,\n  CaptureSession,\n  DTMFEvent,\n  IncomingCallEvent,\n  IncomingCallReportedEvent,\n  OutgoingCallStartedEvent,\n  SetHeldActionEvent,\n  SetMutedActionEvent,\n  VideoChangedEvent,\n  VoIPPushToken,\n  VoIPPushTokenUpdatedEvent,\n} from \"./Calls.types\";\nimport type { PushTokenType } from \"./Calls.types\";\nimport ExpoCallKitTelecomModule from \"./ExpoCallKitTelecomModule\";\n\n// ============================================================================\n// Call Session\n// ============================================================================\n\n/**\n * Gets the currently active call session, if any.\n *\n * @returns The active call session, or `null` if no call is in progress.\n *\n * @example\n * ```typescript\n * const session = await getActiveCallSession();\n * if (session) {\n *   console.log('Active call with:', session.remoteParticipants[0]?.displayName);\n * }\n * ```\n *\n * @category Sessions\n */\nexport async function getActiveCallSession(): Promise<CallSession | null> {\n  const session = await ExpoCallKitTelecomModule.getActiveCallSession();\n  if (session) {\n  }\n  return session;\n}\n\n/**\n * Subscribes to call session added events.\n *\n * Fired when a new call session is created, either from an outgoing call request\n * or an incoming call report.\n *\n * @param listener - Callback invoked when a session is added.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @example\n * ```typescript\n * const subscription = addCallSessionAddedListener((event) => {\n *   console.log('New call session:', event.session.id);\n * });\n *\n * // Later, to unsubscribe:\n * subscription.remove();\n * ```\n *\n * @category Sessions\n */\nexport function addCallSessionAddedListener(\n  listener: (event: CallSessionAddedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\n    \"onCallSessionAdded\",\n    (event: CallSessionAddedEvent) => {\n      listener(event);\n    },\n  );\n}\n\n/**\n * Subscribes to call session updated events.\n *\n * Fired when an existing call session's state changes (e.g., status, mute state).\n *\n * @param listener - Callback invoked when a session is updated.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Sessions\n */\nexport function addCallSessionUpdatedListener(\n  listener: (event: CallSessionUpdatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\n    \"onCallSessionUpdated\",\n    (event: CallSessionUpdatedEvent) => {\n      listener(event);\n    },\n  );\n}\n\n/**\n * Subscribes to call session removed events.\n *\n * Fired when a call session is removed after the call has ended and been cleaned up.\n *\n * @param listener - Callback invoked when a session is removed.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Sessions\n */\nexport function addCallSessionRemovedListener(\n  listener: (event: CallSessionRemovedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallSessionRemoved\", listener);\n}\n\n// ============================================================================\n// Audio Session\n// ============================================================================\n\n/**\n * Gets the current audio session state.\n *\n * Returns information about the audio session including whether it's active,\n * the current category/mode, and the audio route (speaker, earpiece, etc.).\n *\n * @returns The current audio session state.\n *\n * @category Audio\n */\nexport function getAudioSession(): AudioSession {\n  return ExpoCallKitTelecomModule.getAudioSessionState();\n}\n\n/**\n * Gets the current capture session state.\n *\n * Returns information about the capture session including camera permission status.\n *\n * @returns The current capture session state.\n *\n * @category Capture\n */\nexport function getCaptureSession(): CaptureSession {\n  return ExpoCallKitTelecomModule.getCaptureSessionState();\n}\n\n/**\n * Sets the RTC audio session configuration (iOS only).\n *\n * This sets up WebRTC's RTCAudioSession default configuration and enables manual\n * audio management. On Android this is a no-op — audio configuration is handled\n * by {@link prepareAudioSessionForCall}.\n *\n * @param hasVideo - Whether to configure for video calls (uses speaker by default)\n *   or audio-only calls (uses earpiece by default).\n *\n * @category Audio\n */\nexport function setRTCAudioSessionConfiguration(hasVideo: boolean): void {\n  if (Platform.OS === \"ios\") {\n    ExpoCallKitTelecomModule.setRTCAudioSessionConfiguration(hasVideo);\n  }\n}\n\n/**\n * Prepares the audio session for an upcoming call.\n *\n * This snapshots the current audio configuration (for later restoration) and\n * pre-configures the audio session for the call. Called automatically when\n * reporting/starting a call, but can be called manually for early preparation.\n *\n * @param hasVideo - Whether to configure for video calls (uses speaker by default)\n *   or audio-only calls (uses earpiece by default).\n *\n * @see {@link restoreAudioSession} — call this after the call ends to revert the session configuration.\n * @see {@link getAudioSession} — inspect the resulting audio session state.\n *\n * @category Audio\n */\nexport function prepareAudioSessionForCall(hasVideo: boolean): void {\n  ExpoCallKitTelecomModule.prepareAudioSessionForCall(hasVideo);\n}\n\n/**\n * Restores the audio session to its pre-call configuration.\n *\n * Call this if a call fails to start after prepareAudioSessionForCall was called,\n * or to manually restore the audio session. This is called automatically when\n * the audio session is deactivated after a call ends.\n *\n * @see {@link prepareAudioSessionForCall} — the matching setup call.\n *\n * @category Audio\n */\nexport function restoreAudioSession(): void {\n  ExpoCallKitTelecomModule.restoreAudioSession();\n}\n\n/**\n * Sets the audio session port override.\n *\n * Use this to route audio to the speaker instead of the earpiece, or vice versa.\n *\n * @param enabled - If `true`, routes audio to the speaker. If `false`, uses\n *   the default route (typically earpiece for voice calls).\n *\n * @category Audio\n */\nexport function setAudioSessionPortOverride(enabled: boolean): void {\n  ExpoCallKitTelecomModule.setAudioSessionPortOverride(enabled);\n}\n\n/**\n * Subscribes to audio session activated events.\n *\n * Fired when the audio session is activated for a call. This is when your\n * app gains exclusive access to audio hardware.\n *\n * @param listener - Callback invoked when audio session activates.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Audio Events\n */\nexport function addAudioSessionActivatedListener(\n  listener: (event: AudioSessionActivatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onAudioSessionActivated\", listener);\n}\n\n/**\n * Subscribes to audio session deactivated events.\n *\n * Fired when the audio session is deactivated after a call ends.\n *\n * @param listener - Callback invoked when audio session deactivates.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Audio Events\n */\nexport function addAudioSessionDeactivatedListener(\n  listener: (event: AudioSessionDeactivatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onAudioSessionDeactivated\", listener);\n}\n\n/**\n * Subscribes to audio route changed events.\n *\n * Fired when the audio route changes (e.g., user connects Bluetooth headphones,\n * toggles speaker mode).\n *\n * @param listener - Callback invoked when audio route changes.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Audio Events\n */\nexport function addAudioRouteChangedListener(\n  listener: (event: AudioRouteChangedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onAudioRouteChanged\", listener);\n}\n\n// ============================================================================\n// Call Intent Event Listeners\n// ============================================================================\n\n/**\n * Subscribes to call intent received events.\n *\n * Fired when the user initiates a call from outside the app, such as tapping\n * a contact in the iOS Recents list or via Siri. The event contains the handle\n * (phone number/email) and whether video is requested.\n *\n * The app should resolve the handle to a known recipient and call\n * {@link startOutgoingCall} to fulfill the intent.\n *\n * @param listener - Callback invoked when a call intent is received.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @category Call Events\n */\nexport function addCallIntentReceivedListener(\n  listener: (event: CallIntentReceivedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallIntentReceived\", listener);\n}\n\n// ============================================================================\n// Start Outgoing Call\n// ============================================================================\n\n/**\n * Starts an outgoing call to the specified recipient.\n *\n * This requests the system to initiate a call. The system will display the\n * appropriate call UI and emit an {@link OutgoingCallStartedEvent} when you should\n * begin connecting your media.\n *\n * @param recipient - The participant to call.\n * @param options - Call configuration options (e.g., video enabled).\n * @returns The unique identifier for this call session.\n *\n * @example\n * ```typescript\n * const callId = await startOutgoingCall(\n *   { id: 'user-123', displayName: 'John Doe' },\n *   { hasVideo: true }\n * );\n * ```\n *\n * @see {@link addOutgoingCallStartedListener} for the event fired once the OS accepts the call.\n * @see {@link reportOutgoingCallConnected} to call after the remote media stream is established.\n * @see {@link endCall} to terminate the call from the app.\n *\n * @category Requests\n */\nexport async function startOutgoingCall(\n  recipient: CallParticipant,\n  options: CallOptions,\n): Promise<string> {\n  return await ExpoCallKitTelecomModule.startOutgoingCall(recipient, options);\n}\n\n/**\n * Subscribes to outgoing call started events.\n *\n * Fired when an outgoing call (initiated via {@link startOutgoingCall}) has\n * been accepted by the system. You should provision your media connection\n * and begin connecting.\n *\n * @param listener - Callback invoked when an outgoing call starts.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link startOutgoingCall} — the request that triggers this event.\n * @see {@link reportOutgoingCallConnected} — the next step in the outgoing-call flow.\n *\n * @category Call Events\n */\nexport function addOutgoingCallStartedListener(\n  listener: (event: OutgoingCallStartedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onOutgoingCallStarted\", listener);\n}\n\n// ============================================================================\n// Report Incoming Call\n// ============================================================================\n\n/**\n * Reports an incoming call to the system.\n *\n * Call this when you receive a push notification or other signal indicating\n * an incoming call. The system will display the incoming call UI.\n *\n * @param event - The incoming call event containing caller information.\n *\n * @example\n * ```typescript\n * await reportIncomingCall({\n *   callId: '550e8400-e29b-41d4-a716-446655440000',\n *   caller: {\n *     id: 'user-456',\n *     displayName: 'Jane Smith',\n *     phoneNumber: '+1234567890',\n *   },\n *   hasVideo: false,\n *   startedAt: new Date(),\n * });\n * ```\n *\n * @see {@link addIncomingCallReportedListener} — fires once the OS accepts the report.\n * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.\n * @see [VoIP push payload shape](https://mfairley.github.io/expo-callkit-telecom/voip-push) — the payload that drives this when called from a native push handler.\n *\n * @category Reporters\n */\nexport async function reportIncomingCall(\n  event: IncomingCallEvent,\n): Promise<void> {\n  await ExpoCallKitTelecomModule.reportIncomingCall(event);\n}\n\n/**\n * Subscribes to incoming call reported events.\n *\n * Fired after an incoming call has been successfully reported to the system\n * and the call session has been added to the store. Use this to set up\n * early subscriptions (e.g., call signaling) before the call is answered.\n *\n * @param listener - Callback invoked when an incoming call is reported.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link reportIncomingCall} — the report that triggers this event.\n * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.\n *\n * @category Call Events\n */\nexport function addIncomingCallReportedListener(\n  listener: (event: IncomingCallReportedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onIncomingCallReported\", listener);\n}\n\n// ============================================================================\n// Answer Call\n// ============================================================================\n\n/**\n * Answers an incoming call.\n *\n * Use this when the user taps an answer button in your app's custom UI.\n * The system will emit a {@link CallAnsweredEvent} to confirm the answer.\n *\n * @param id - The call session ID to answer.\n *\n * @see {@link addCallAnsweredListener} — react to user-initiated answers from the system UI; most apps listen here rather than calling this directly.\n * @see {@link fulfillIncomingCallConnected} — call after media is established.\n * @see {@link failIncomingCallConnected} — call if media setup fails.\n *\n * @category Requests\n */\nexport async function answerCall(id: string): Promise<void> {\n  await ExpoCallKitTelecomModule.answerCall(id);\n}\n\n/**\n * Subscribes to call answered events.\n *\n * Fired when the user answers an incoming call (either from the system UI or\n * via {@link answerCall}). You should begin connecting your media.\n *\n * @param listener - Callback invoked when a call is answered.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link answerCall} — the programmatic equivalent (rarely needed; usually the OS UI triggers answering).\n * @see {@link fulfillIncomingCallConnected} — call after media setup completes.\n * @see {@link failIncomingCallConnected} — call if media setup fails.\n *\n * @category Call Events\n */\nexport function addCallAnsweredListener(\n  listener: (event: CallAnsweredEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallAnswered\", listener);\n}\n\n// ============================================================================\n// Fulfill Incoming Call\n// ============================================================================\n\n/**\n * Fulfills an incoming call by confirming the media connection is established.\n *\n * Call this after the user answers an incoming call and your media connection\n * (e.g., WebRTC) is fully connected and ready for audio/video.\n *\n * @param requestId - The request ID from the CallAnsweredEvent.\n *\n * @see {@link addCallAnsweredListener} — the event you typically respond to before calling this.\n * @see {@link failIncomingCallConnected} — call this instead if media setup fails.\n *\n * @category Fulfillers\n */\nexport async function fulfillIncomingCallConnected(\n  requestId: string,\n): Promise<void> {\n  await ExpoCallKitTelecomModule.fulfillIncomingCallAnswered(requestId);\n}\n\n/**\n * Fails a pending incoming call connection request.\n *\n * Call this when the answer flow fails before media is connected\n * (e.g., API error). On iOS, causes CXAnswerCallAction to fail, which\n * triggers CallKit to end the call via CXEndCallAction. On Android,\n * ends the call via {@link reportCallEnded} which also cancels any\n * pending fulfill request.\n *\n * @param id - The call session ID.\n * @param requestId - The request ID from the CallAnsweredEvent.\n *\n * @see {@link fulfillIncomingCallConnected} — call this on the success path.\n * @see {@link addCallAnsweredListener} — the event you typically respond to before calling either fulfiller.\n *\n * @category Fulfillers\n */\nexport async function failIncomingCallConnected(\n  id: string,\n  requestId: string,\n): Promise<void> {\n  if (Platform.OS === \"ios\") {\n    await ExpoCallKitTelecomModule.failIncomingCallConnected(requestId);\n  } else {\n    await ExpoCallKitTelecomModule.reportCallEnded(id, \"failed\");\n  }\n}\n\n// ============================================================================\n// Report Outgoing Call Connected\n// ============================================================================\n\n/**\n * Reports that an outgoing call's media connection is established.\n *\n * Call this after starting an outgoing call and your media connection\n * (e.g., WebRTC) is fully connected and the remote party has answered.\n *\n * @param id - The call session ID.\n *\n * @see {@link startOutgoingCall} — the call that initiated this outgoing flow.\n * @see {@link addOutgoingCallStartedListener} — fires when the OS accepts the request.\n *\n * @category Reporters\n */\nexport async function reportOutgoingCallConnected(id: string): Promise<void> {\n  await ExpoCallKitTelecomModule.reportOutgoingCallConnected(id);\n}\n\n// ============================================================================\n// End Call\n// ============================================================================\n\n/**\n * Ends an active call.\n *\n * Requests the system to end the call. The system will emit a {@link CallEndedEvent}\n * to notify that the call has ended. Clean up your media connection when you receive\n * this event.\n *\n * @param id - The call session ID to end.\n *\n * @see {@link addCallEndedListener} — confirms the call ended.\n * @see {@link reportCallEnded} — call this instead when the remote party hung up (a server-side signal), so the OS records the right reason.\n *\n * @category Requests\n */\nexport async function endCall(id: string): Promise<void> {\n  await ExpoCallKitTelecomModule.endCall(id);\n}\n\n/**\n * Subscribes to call ended events.\n *\n * Fired when a call has ended (e.g., user pressed end button).\n * Clean up your media connection when you receive this event.\n *\n * @param listener - Callback invoked when a call ends.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link endCall} — the app-side request that fires this when the user ends from your UI.\n * @see {@link reportCallEnded} — for remote-initiated ends (server tells you the other party hung up).\n *\n * @category Call Events\n */\nexport function addCallEndedListener(\n  listener: (event: CallEndedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallEnded\", listener);\n}\n\n/**\n * Reports that a call has ended for an external reason.\n *\n * Use this when a call ends due to reasons outside the local user's control,\n * such as: remote party hung up, network failure, call declined elsewhere, etc.\n *\n * @param id - The call session ID.\n * @param reason - The reason the call ended.\n *\n * @example\n * ```typescript\n * // Remote party hung up\n * await reportCallEnded(callId, 'remoteEnded');\n *\n * // Call failed due to network error\n * await reportCallEnded(callId, 'failed');\n * ```\n *\n * @see {@link endCall} — the app-initiated path (your user ended the call).\n * @see {@link addReportedCallEndedListener} — confirms the OS accepted the report.\n *\n * @category Reporters\n */\nexport async function reportCallEnded(\n  id: string,\n  reason: CallEndedReason,\n): Promise<void> {\n  await ExpoCallKitTelecomModule.reportCallEnded(id, reason);\n}\n\n/**\n * Subscribes to reported call ended events.\n *\n * Fired after {@link reportCallEnded} is called, confirming the system has\n * been notified of the externally-ended call.\n *\n * @param listener - Callback invoked when a call end is reported.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link reportCallEnded} — the report that triggers this event.\n *\n * @category Call Events\n */\nexport function addReportedCallEndedListener(\n  listener: (event: CallReportedEnded) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onCallReportedEnded\", listener);\n}\n\n// ============================================================================\n// Mute Support\n// ============================================================================\n\n/**\n * Changes the mute state of a call.\n *\n * The system will emit a {@link SetMutedActionEvent}. Apply the mute state to\n * your media connection when you receive this event.\n *\n * @param id - The call session ID.\n * @param muted - Whether the microphone should be muted.\n *\n * @see {@link addSetMutedActionListener} — fires when the system requests a mute change (e.g. the user pressed mute in the CallKit UI); apply the change to your media stream from there.\n *\n * @category Requests\n */\nexport async function setMuted(id: string, muted: boolean): Promise<void> {\n  await ExpoCallKitTelecomModule.setMuted(id, muted);\n}\n\n/**\n * Subscribes to set muted action events.\n *\n * Fired when the system requests to set the mute state (e.g., user pressed mute button).\n * Apply the change to your media connection when you receive this event.\n *\n * @param listener - Callback invoked when set muted action is requested.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link setMuted} — for the app-initiated direction (programmatic mute toggle).\n *\n * @category Call Events\n */\nexport function addSetMutedActionListener(\n  listener: (event: SetMutedActionEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onSetMutedAction\", listener);\n}\n\n// ============================================================================\n// Video Support\n// ============================================================================\n\n/**\n * Reports a video state change for a call.\n *\n * Use this to inform the system when video is enabled or disabled.\n *\n * @param id - The call session ID.\n * @param enabled - Whether video is enabled.\n *\n * @see {@link addVideoChangedListener} — the inverse direction (system-side video state changes).\n *\n * @category Reporters\n */\nexport async function reportVideo(id: string, enabled: boolean): Promise<void> {\n  await ExpoCallKitTelecomModule.reportVideo(id, enabled);\n}\n\n/**\n * Subscribes to video state change events.\n *\n * Fired when the video state changes for a call.\n *\n * @param listener - Callback invoked when video state changes.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link reportVideo} — for reporting your app's video state changes back to the system.\n *\n * @category Call Events\n */\nexport function addVideoChangedListener(\n  listener: (event: VideoChangedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onVideoChanged\", listener);\n}\n\n// ============================================================================\n// Hold Support\n// ============================================================================\n\n/**\n * Changes the hold state of a call.\n *\n * The system will emit a {@link SetHeldActionEvent}. Apply the hold state to\n * your media connection when you receive this event.\n *\n * @param id - The call session ID.\n * @param onHold - Whether the call should be on hold.\n *\n * @see {@link addSetHeldActionListener} — fires when the system requests a hold-state change.\n *\n * @category Requests\n */\nexport async function setHeld(id: string, onHold: boolean): Promise<void> {\n  await ExpoCallKitTelecomModule.setHeld(id, onHold);\n}\n\n/**\n * Subscribes to set held action events.\n *\n * Fired when the system requests to set the hold state. Apply the change to\n * your media connection when you receive this event.\n *\n * @param listener - Callback invoked when set held action is requested.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link setHeld} — for the app-initiated direction.\n *\n * @category Call Events\n */\nexport function addSetHeldActionListener(\n  listener: (event: SetHeldActionEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onSetHeldAction\", listener);\n}\n\n// ============================================================================\n// DTMF Support\n// ============================================================================\n\n/**\n * Plays DTMF tones during a call.\n *\n * The system will emit a {@link DTMFEvent}. Send the tones through your media\n * connection when you receive this event.\n *\n * @param id - The call session ID.\n * @param digits - The DTMF digits to play (0-9, *, #).\n *\n * @see {@link addDTMFListener} — fires when the system requests DTMF tones (e.g. from the in-call keypad).\n *\n * @category Requests\n */\nexport async function playDTMF(id: string, digits: string): Promise<void> {\n  await ExpoCallKitTelecomModule.playDTMF(id, digits);\n}\n\n/**\n * Subscribes to DTMF events.\n *\n * Fired when DTMF tones should be played. Send the tones through your media\n * connection when you receive this event.\n *\n * @param listener - Callback invoked when DTMF tones should be played.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @see {@link playDTMF} — for the app-initiated direction (programmatically play tones).\n *\n * @category Call Events\n */\nexport function addDTMFListener(\n  listener: (event: DTMFEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onDTMF\", listener);\n}\n\n// ============================================================================\n// VoIP Push\n// ============================================================================\n\n/**\n * Registers for VoIP push notifications.\n *\n * Call this early in your app lifecycle to receive VoIP push notifications\n * for incoming calls. Once registered, the device token will be available\n * via {@link getVoIPPushToken} and token updates will be emitted via\n * {@link addVoIPPushTokenUpdatedListener}.\n *\n * @example\n * ```typescript\n * // Register early in app initialization\n * registerVoIPPush();\n *\n * // Listen for token updates\n * addVoIPPushTokenUpdatedListener((event) => {\n *   if (event.token) {\n *     // Send token to your backend\n *     sendTokenToBackend(event.token);\n *   }\n * });\n * ```\n *\n * @see {@link getVoIPPushToken} — read the current token synchronously after registration.\n * @see {@link useVoIPPushToken} — React hook that reads the token and subscribes to updates.\n * @see {@link addVoIPPushTokenUpdatedListener} — non-React subscription to token updates.\n *\n * @category VoIP Push\n */\nexport function registerVoIPPush(): void {\n  ExpoCallKitTelecomModule.registerVoIPPush();\n}\n\n/**\n * Gets the current VoIP push token and its type.\n *\n * The token should be sent to your backend along with the token type\n * so the server knows how to deliver incoming call pushes.\n *\n * @returns The VoIP push token bundled with its type, or null if not yet registered.\n *\n * @example\n * ```typescript\n * const voip = getVoIPPushToken();\n * if (voip) {\n *   await sendTokenToBackend(voip.token, voip.type);\n * }\n * ```\n *\n * @see {@link registerVoIPPush} — must be called once before a token is available.\n * @see {@link useVoIPPushToken} — React hook wrapper around this + the update listener.\n *\n * @category VoIP Push\n */\nexport function getVoIPPushToken(): VoIPPushToken | null {\n  const result = ExpoCallKitTelecomModule.getVoIPPushToken();\n  if (!result.token) return null;\n  return {\n    token: result.token,\n    type: result.type as PushTokenType,\n  };\n}\n\n/**\n * Subscribes to VoIP token updated events.\n *\n * Fired when the VoIP push token is received or updated after calling\n * {@link registerVoIPPush}. Also fired if the token is invalidated (with\n * `token` being `undefined`).\n *\n * @param listener - Callback invoked when the VoIP token updates.\n * @returns A subscription that can be removed by calling `.remove()`.\n *\n * @example\n * ```typescript\n * const subscription = addVoIPPushTokenUpdatedListener((event) => {\n *   if (event.token) {\n *     console.log('New VoIP token:', event.token);\n *     sendTokenToBackend(event.token);\n *   } else {\n *     console.log('VoIP token invalidated');\n *   }\n * });\n * ```\n *\n * @see {@link useVoIPPushToken} — React hook that uses this internally; prefer it in components.\n * @see {@link registerVoIPPush} — must be called once before any token updates fire.\n *\n * @category VoIP Push\n */\nexport function addVoIPPushTokenUpdatedListener(\n  listener: (event: VoIPPushTokenUpdatedEvent) => void,\n): EventSubscription {\n  return ExpoCallKitTelecomModule.addListener(\"onVoIPPushTokenUpdated\", listener);\n}\n"]}

package/build/hooks/useVoIPPushToken.d.ts

@@ -10,6 +10,10 @@ import type { VoIPPushToken } from "../Calls.types";
  *
  * @returns The current token, or `null` if not yet available.
  *
+ * @see {@link registerVoIPPush} — must be called once before any token will be available.
+ * @see {@link getVoIPPushToken} — non-hook accessor for the same token.
+ * @see {@link addVoIPPushTokenUpdatedListener} — the underlying subscription.
+ *
  * @category Hooks
  */
 export declare function useVoIPPushToken(): VoIPPushToken | null;

package/build/hooks/useVoIPPushToken.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVoIPPushToken.d.ts","sourceRoot":"","sources":["../../src/hooks/useVoIPPushToken.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAiBvD"}
+{"version":3,"file":"useVoIPPushToken.d.ts","sourceRoot":"","sources":["../../src/hooks/useVoIPPushToken.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAiBvD"}

package/build/hooks/useVoIPPushToken.js

@@ -11,6 +11,10 @@ import { addVoIPPushTokenUpdatedListener, getVoIPPushToken } from "../Calls";
  *
  * @returns The current token, or `null` if not yet available.
  *
+ * @see {@link registerVoIPPush} — must be called once before any token will be available.
+ * @see {@link getVoIPPushToken} — non-hook accessor for the same token.
+ * @see {@link addVoIPPushTokenUpdatedListener} — the underlying subscription.
+ *
  * @category Hooks
  */
 export function useVoIPPushToken() {

package/build/hooks/useVoIPPushToken.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVoIPPushToken.js","sourceRoot":"","sources":["../../src/hooks/useVoIPPushToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAuB,GAAG,EAAE,CAC5D,gBAAgB,EAAE,CACnB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,+BAA+B,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7D,QAAQ,CACN,KAAK,CAAC,KAAK;gBACT,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAqB,EAAE;gBAC3D,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport { addVoIPPushTokenUpdatedListener, getVoIPPushToken } from \"../Calls\";\nimport type { PushTokenType, VoIPPushToken } from \"../Calls.types\";\n\n/**\n * Hook that returns the current VoIP push token and subscribes to updates.\n *\n * Reads the initial token synchronously and re-renders whenever the native\n * `onVoIPPushTokenUpdated` event fires (e.g. when the OS provides a new token\n * or invalidates the existing one).\n *\n * On iOS this returns an APNs VoIP token; on Android it returns an FCM token.\n *\n * @returns The current token, or `null` if not yet available.\n *\n * @category Hooks\n */\nexport function useVoIPPushToken(): VoIPPushToken | null {\n  const [token, setToken] = useState<VoIPPushToken | null>(() =>\n    getVoIPPushToken(),\n  );\n\n  useEffect(() => {\n    const subscription = addVoIPPushTokenUpdatedListener((event) => {\n      setToken(\n        event.token\n          ? { token: event.token, type: event.type as PushTokenType }\n          : null,\n      );\n    });\n    return () => subscription.remove();\n  }, []);\n\n  return token;\n}\n"]}
+{"version":3,"file":"useVoIPPushToken.js","sourceRoot":"","sources":["../../src/hooks/useVoIPPushToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG7E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAuB,GAAG,EAAE,CAC5D,gBAAgB,EAAE,CACnB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,+BAA+B,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7D,QAAQ,CACN,KAAK,CAAC,KAAK;gBACT,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAqB,EAAE;gBAC3D,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport { addVoIPPushTokenUpdatedListener, getVoIPPushToken } from \"../Calls\";\nimport type { PushTokenType, VoIPPushToken } from \"../Calls.types\";\n\n/**\n * Hook that returns the current VoIP push token and subscribes to updates.\n *\n * Reads the initial token synchronously and re-renders whenever the native\n * `onVoIPPushTokenUpdated` event fires (e.g. when the OS provides a new token\n * or invalidates the existing one).\n *\n * On iOS this returns an APNs VoIP token; on Android it returns an FCM token.\n *\n * @returns The current token, or `null` if not yet available.\n *\n * @see {@link registerVoIPPush} — must be called once before any token will be available.\n * @see {@link getVoIPPushToken} — non-hook accessor for the same token.\n * @see {@link addVoIPPushTokenUpdatedListener} — the underlying subscription.\n *\n * @category Hooks\n */\nexport function useVoIPPushToken(): VoIPPushToken | null {\n  const [token, setToken] = useState<VoIPPushToken | null>(() =>\n    getVoIPPushToken(),\n  );\n\n  useEffect(() => {\n    const subscription = addVoIPPushTokenUpdatedListener((event) => {\n      setToken(\n        event.token\n          ? { token: event.token, type: event.type as PushTokenType }\n          : null,\n      );\n    });\n    return () => subscription.remove();\n  }, []);\n\n  return token;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-callkit-telecom",
-  "version": "0.2.7",
+  "version": "0.3.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",

package/release-please-config.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "packages": {
+    ".": {
+      "release-type": "node",
+      "package-name": "expo-callkit-telecom",
+      "changelog-path": "CHANGELOG.md",
+      "include-component-in-tag": false,
+      "include-v-in-tag": true,
+      "draft": false,
+      "prerelease": false,
+      "changelog-sections": [
+        { "type": "feat", "section": "Features", "hidden": false },
+        { "type": "fix", "section": "Bug Fixes", "hidden": false },
+        { "type": "perf", "section": "Performance", "hidden": false },
+        { "type": "deps", "section": "Dependencies", "hidden": false },
+        { "type": "revert", "section": "Reverts", "hidden": false },
+        { "type": "docs", "section": "Documentation", "hidden": false },
+        { "type": "refactor", "section": "Code Refactoring", "hidden": true },
+        { "type": "test", "section": "Tests", "hidden": true },
+        { "type": "build", "section": "Build", "hidden": true },
+        { "type": "ci", "section": "CI/CD", "hidden": true },
+        { "type": "chore", "section": "Chores", "hidden": true },
+        { "type": "style", "section": "Styles", "hidden": true }
+      ]
+    }
+  }
+}

package/src/Calls.ts

@@ -236,6 +236,9 @@ export function setRTCAudioSessionConfiguration(hasVideo: boolean): void {
  * @param hasVideo - Whether to configure for video calls (uses speaker by default)
  *   or audio-only calls (uses earpiece by default).
  *
+ * @see {@link restoreAudioSession} — call this after the call ends to revert the session configuration.
+ * @see {@link getAudioSession} — inspect the resulting audio session state.
+ *
  * @category Audio
  */
 export function prepareAudioSessionForCall(hasVideo: boolean): void {
@@ -249,6 +252,8 @@ export function prepareAudioSessionForCall(hasVideo: boolean): void {
  * or to manually restore the audio session. This is called automatically when
  * the audio session is deactivated after a call ends.
  *
+ * @see {@link prepareAudioSessionForCall} — the matching setup call.
+ *
  * @category Audio
  */
 export function restoreAudioSession(): void {
@@ -367,6 +372,10 @@ export function addCallIntentReceivedListener(
  * );
  * ```
  *
+ * @see {@link addOutgoingCallStartedListener} for the event fired once the OS accepts the call.
+ * @see {@link reportOutgoingCallConnected} to call after the remote media stream is established.
+ * @see {@link endCall} to terminate the call from the app.
+ *
  * @category Requests
  */
 export async function startOutgoingCall(
@@ -386,6 +395,9 @@ export async function startOutgoingCall(
  * @param listener - Callback invoked when an outgoing call starts.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link startOutgoingCall} — the request that triggers this event.
+ * @see {@link reportOutgoingCallConnected} — the next step in the outgoing-call flow.
+ *
  * @category Call Events
  */
 export function addOutgoingCallStartedListener(
@@ -420,6 +432,10 @@ export function addOutgoingCallStartedListener(
  * });
  * ```
  *
+ * @see {@link addIncomingCallReportedListener} — fires once the OS accepts the report.
+ * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.
+ * @see [VoIP push payload shape](https://mfairley.github.io/expo-callkit-telecom/voip-push) — the payload that drives this when called from a native push handler.
+ *
  * @category Reporters
  */
 export async function reportIncomingCall(
@@ -438,6 +454,9 @@ export async function reportIncomingCall(
  * @param listener - Callback invoked when an incoming call is reported.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportIncomingCall} — the report that triggers this event.
+ * @see {@link addCallAnsweredListener} — fires when the user answers from the system UI.
+ *
  * @category Call Events
  */
 export function addIncomingCallReportedListener(
@@ -458,6 +477,10 @@ export function addIncomingCallReportedListener(
  *
  * @param id - The call session ID to answer.
  *
+ * @see {@link addCallAnsweredListener} — react to user-initiated answers from the system UI; most apps listen here rather than calling this directly.
+ * @see {@link fulfillIncomingCallConnected} — call after media is established.
+ * @see {@link failIncomingCallConnected} — call if media setup fails.
+ *
  * @category Requests
  */
 export async function answerCall(id: string): Promise<void> {
@@ -473,6 +496,10 @@ export async function answerCall(id: string): Promise<void> {
  * @param listener - Callback invoked when a call is answered.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link answerCall} — the programmatic equivalent (rarely needed; usually the OS UI triggers answering).
+ * @see {@link fulfillIncomingCallConnected} — call after media setup completes.
+ * @see {@link failIncomingCallConnected} — call if media setup fails.
+ *
  * @category Call Events
  */
 export function addCallAnsweredListener(
@@ -493,6 +520,9 @@ export function addCallAnsweredListener(
  *
  * @param requestId - The request ID from the CallAnsweredEvent.
  *
+ * @see {@link addCallAnsweredListener} — the event you typically respond to before calling this.
+ * @see {@link failIncomingCallConnected} — call this instead if media setup fails.
+ *
  * @category Fulfillers
  */
 export async function fulfillIncomingCallConnected(
@@ -513,6 +543,9 @@ export async function fulfillIncomingCallConnected(
  * @param id - The call session ID.
  * @param requestId - The request ID from the CallAnsweredEvent.
  *
+ * @see {@link fulfillIncomingCallConnected} — call this on the success path.
+ * @see {@link addCallAnsweredListener} — the event you typically respond to before calling either fulfiller.
+ *
  * @category Fulfillers
  */
 export async function failIncomingCallConnected(
@@ -538,6 +571,9 @@ export async function failIncomingCallConnected(
  *
  * @param id - The call session ID.
  *
+ * @see {@link startOutgoingCall} — the call that initiated this outgoing flow.
+ * @see {@link addOutgoingCallStartedListener} — fires when the OS accepts the request.
+ *
  * @category Reporters
  */
 export async function reportOutgoingCallConnected(id: string): Promise<void> {
@@ -557,6 +593,9 @@ export async function reportOutgoingCallConnected(id: string): Promise<void> {
  *
  * @param id - The call session ID to end.
  *
+ * @see {@link addCallEndedListener} — confirms the call ended.
+ * @see {@link reportCallEnded} — call this instead when the remote party hung up (a server-side signal), so the OS records the right reason.
+ *
  * @category Requests
  */
 export async function endCall(id: string): Promise<void> {
@@ -572,6 +611,9 @@ export async function endCall(id: string): Promise<void> {
  * @param listener - Callback invoked when a call ends.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link endCall} — the app-side request that fires this when the user ends from your UI.
+ * @see {@link reportCallEnded} — for remote-initiated ends (server tells you the other party hung up).
+ *
  * @category Call Events
  */
 export function addCallEndedListener(
@@ -598,6 +640,9 @@ export function addCallEndedListener(
  * await reportCallEnded(callId, 'failed');
  * ```
  *
+ * @see {@link endCall} — the app-initiated path (your user ended the call).
+ * @see {@link addReportedCallEndedListener} — confirms the OS accepted the report.
+ *
  * @category Reporters
  */
 export async function reportCallEnded(
@@ -616,6 +661,8 @@ export async function reportCallEnded(
  * @param listener - Callback invoked when a call end is reported.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportCallEnded} — the report that triggers this event.
+ *
  * @category Call Events
  */
 export function addReportedCallEndedListener(
@@ -637,6 +684,8 @@ export function addReportedCallEndedListener(
  * @param id - The call session ID.
  * @param muted - Whether the microphone should be muted.
  *
+ * @see {@link addSetMutedActionListener} — fires when the system requests a mute change (e.g. the user pressed mute in the CallKit UI); apply the change to your media stream from there.
+ *
  * @category Requests
  */
 export async function setMuted(id: string, muted: boolean): Promise<void> {
@@ -652,6 +701,8 @@ export async function setMuted(id: string, muted: boolean): Promise<void> {
  * @param listener - Callback invoked when set muted action is requested.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link setMuted} — for the app-initiated direction (programmatic mute toggle).
+ *
  * @category Call Events
  */
 export function addSetMutedActionListener(
@@ -672,6 +723,8 @@ export function addSetMutedActionListener(
  * @param id - The call session ID.
  * @param enabled - Whether video is enabled.
  *
+ * @see {@link addVideoChangedListener} — the inverse direction (system-side video state changes).
+ *
  * @category Reporters
  */
 export async function reportVideo(id: string, enabled: boolean): Promise<void> {
@@ -686,6 +739,8 @@ export async function reportVideo(id: string, enabled: boolean): Promise<void> {
  * @param listener - Callback invoked when video state changes.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link reportVideo} — for reporting your app's video state changes back to the system.
+ *
  * @category Call Events
  */
 export function addVideoChangedListener(
@@ -707,6 +762,8 @@ export function addVideoChangedListener(
  * @param id - The call session ID.
  * @param onHold - Whether the call should be on hold.
  *
+ * @see {@link addSetHeldActionListener} — fires when the system requests a hold-state change.
+ *
  * @category Requests
  */
 export async function setHeld(id: string, onHold: boolean): Promise<void> {
@@ -722,6 +779,8 @@ export async function setHeld(id: string, onHold: boolean): Promise<void> {
  * @param listener - Callback invoked when set held action is requested.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link setHeld} — for the app-initiated direction.
+ *
  * @category Call Events
  */
 export function addSetHeldActionListener(
@@ -743,6 +802,8 @@ export function addSetHeldActionListener(
  * @param id - The call session ID.
  * @param digits - The DTMF digits to play (0-9, *, #).
  *
+ * @see {@link addDTMFListener} — fires when the system requests DTMF tones (e.g. from the in-call keypad).
+ *
  * @category Requests
  */
 export async function playDTMF(id: string, digits: string): Promise<void> {
@@ -758,6 +819,8 @@ export async function playDTMF(id: string, digits: string): Promise<void> {
  * @param listener - Callback invoked when DTMF tones should be played.
  * @returns A subscription that can be removed by calling `.remove()`.
  *
+ * @see {@link playDTMF} — for the app-initiated direction (programmatically play tones).
+ *
  * @category Call Events
  */
 export function addDTMFListener(
@@ -792,6 +855,10 @@ export function addDTMFListener(
  * });
  * ```
  *
+ * @see {@link getVoIPPushToken} — read the current token synchronously after registration.
+ * @see {@link useVoIPPushToken} — React hook that reads the token and subscribes to updates.
+ * @see {@link addVoIPPushTokenUpdatedListener} — non-React subscription to token updates.
+ *
  * @category VoIP Push
  */
 export function registerVoIPPush(): void {
@@ -814,6 +881,9 @@ export function registerVoIPPush(): void {
  * }
  * ```
  *
+ * @see {@link registerVoIPPush} — must be called once before a token is available.
+ * @see {@link useVoIPPushToken} — React hook wrapper around this + the update listener.
+ *
  * @category VoIP Push
  */
 export function getVoIPPushToken(): VoIPPushToken | null {
@@ -847,6 +917,9 @@ export function getVoIPPushToken(): VoIPPushToken | null {
  * });
  * ```
  *
+ * @see {@link useVoIPPushToken} — React hook that uses this internally; prefer it in components.
+ * @see {@link registerVoIPPush} — must be called once before any token updates fire.
+ *
  * @category VoIP Push
  */
 export function addVoIPPushTokenUpdatedListener(

package/src/hooks/useVoIPPushToken.ts

@@ -14,6 +14,10 @@ import type { PushTokenType, VoIPPushToken } from "../Calls.types";
  *
  * @returns The current token, or `null` if not yet available.
  *
+ * @see {@link registerVoIPPush} — must be called once before any token will be available.
+ * @see {@link getVoIPPushToken} — non-hook accessor for the same token.
+ * @see {@link addVoIPPushTokenUpdatedListener} — the underlying subscription.
+ *
  * @category Hooks
  */
 export function useVoIPPushToken(): VoIPPushToken | null {