@telnyx/react-voice-commons-sdk 1.1.1 → 1.2.1

package/lib/internal/session/session-manager.js

@@ -56,12 +56,15 @@ exports.SessionManager = void 0;
 const rxjs_1 = require('rxjs');
 const operators_1 = require('rxjs/operators');
 const TelnyxSDK = __importStar(require('@telnyx/react-native-voice-sdk'));
-const pkg = __importStar(require('../../../package.json'));
+const sdk_identity_1 = require('../sdk-identity');
+const ice_servers_storage_1 = require('../ice-servers-storage');
+const signaling_environment_1 = require('../signaling-environment');
 const connection_state_1 = require('../../models/connection-state');
 const config_1 = require('../../models/config');
 const USE_TRICKLE_ICE_STORAGE_KEY = '@use_trickle_ice';
 const PUSH_WHEN_ACTIVE_STORAGE_KEY = '@push_when_active';
 const MISSED_CALL_NOTIFICATIONS_STORAGE_KEY = '@enable_missed_call_notifications';
+const QUALITY_METRICS_STORAGE_KEY = '@enable_quality_metrics';
 /**
  * Manages the connection lifecycle to the Telnyx platform.
  *
@@ -69,7 +72,7 @@ const MISSED_CALL_NOTIFICATIONS_STORAGE_KEY = '@enable_missed_call_notifications
  * and automatic reconnection logic.
  */
 class SessionManager {
-  constructor() {
+  constructor(options = {}) {
     this._connectionState = new rxjs_1.BehaviorSubject(
       connection_state_1.TelnyxConnectionState.DISCONNECTED
     );
@@ -77,6 +80,7 @@ class SessionManager {
     this._disposing = false;
     this._connectionGeneration = 0;
     this._sessionId = this._generateSessionId();
+    this._defaultEnvironment = options.defaultEnvironment ?? 'production';
   }
   /**
    * Observable stream of connection state changes
@@ -254,9 +258,22 @@ class SessionManager {
         const storedMissedCallNotifications = await AsyncStorage.getItem(
           MISSED_CALL_NOTIFICATIONS_STORAGE_KEY
         );
+        const storedEnvironment = await AsyncStorage.getItem(
+          signaling_environment_1.SIGNALING_ENVIRONMENT_STORAGE_KEY
+        );
+        const storedQualityMetrics = await AsyncStorage.getItem(QUALITY_METRICS_STORAGE_KEY);
+        const storedIceServers = await AsyncStorage.getItem(
+          ice_servers_storage_1.ICE_SERVERS_STORAGE_KEY
+        );
+        const iceServers = (0, ice_servers_storage_1.parseStoredIceServers)(storedIceServers);
         const useTrickleIce = storedUseTrickleIce === 'true';
         const pushWhenActive = storedPushWhenActive === 'true';
         const enableMissedCallNotifications = storedMissedCallNotifications === 'true';
+        const enableQualityMetrics = storedQualityMetrics === 'true';
+        const environment = (0, signaling_environment_1.resolveStoredEnvironment)(
+          storedEnvironment,
+          this._defaultEnvironment
+        );
         if (this._isTeardownActive()) {
           return;
         }
@@ -269,6 +286,9 @@ class SessionManager {
             useTrickleIce,
             pushWhenActive,
             enableMissedCallNotifications,
+            enableQualityMetrics,
+            environment,
+            iceServers,
           });
         }
         // Check if we have token-based authentication data
@@ -280,6 +300,9 @@ class SessionManager {
             useTrickleIce,
             pushWhenActive,
             enableMissedCallNotifications,
+            enableQualityMetrics,
+            environment,
+            iceServers,
           });
         }
         if (this._currentConfig) {
@@ -463,11 +486,15 @@ class SessionManager {
           pushWhenActive: config.pushWhenActive,
           enableMissedCallNotifications: config.enableMissedCallNotifications ?? false,
           useTrickleIce: config.useTrickleIce,
+          environment: config.environment ?? this._defaultEnvironment,
           enableCallReports: config.enableCallReports,
+          enableQualityMetrics: config.enableQualityMetrics,
           callReportInterval: config.callReportInterval,
           callReportLogLevel: config.callReportLogLevel,
           callReportMaxLogEntries: config.callReportMaxLogEntries,
-          sdkVersion: pkg.version,
+          iceServers: config.iceServers,
+          sdkName: sdk_identity_1.REACT_NATIVE_COMMONS_SDK_IDENTITY.name,
+          sdkVersion: sdk_identity_1.REACT_NATIVE_COMMONS_SDK_IDENTITY.version,
         };
         console.log(
           '🔧 SessionManager: Creating TelnyxRTC with credential config, logLevel:',
@@ -484,11 +511,15 @@ class SessionManager {
           pushWhenActive: config.pushWhenActive,
           enableMissedCallNotifications: config.enableMissedCallNotifications ?? false,
           useTrickleIce: config.useTrickleIce,
+          environment: config.environment ?? this._defaultEnvironment,
           enableCallReports: config.enableCallReports,
+          enableQualityMetrics: config.enableQualityMetrics,
           callReportInterval: config.callReportInterval,
           callReportLogLevel: config.callReportLogLevel,
           callReportMaxLogEntries: config.callReportMaxLogEntries,
-          sdkVersion: pkg.version,
+          iceServers: config.iceServers,
+          sdkName: sdk_identity_1.REACT_NATIVE_COMMONS_SDK_IDENTITY.name,
+          sdkVersion: sdk_identity_1.REACT_NATIVE_COMMONS_SDK_IDENTITY.version,
         };
         console.log(
           '🔧 SessionManager: Creating TelnyxRTC with token config, logLevel:',

package/lib/internal/signaling-environment.d.ts

@@ -0,0 +1,13 @@
+import { TelnyxEnvironment } from '../models/config';
+export declare const SIGNALING_ENVIRONMENT_STORAGE_KEY = '@telnyx_signaling_environment';
+/**
+ * Resolves the signaling environment for a stored-config restore.
+ *
+ * An explicit stored selection always wins. A missing or invalid stored value
+ * (e.g. credentials persisted by an older Commons version) falls back to the
+ * client's configured default, and only then to production.
+ */
+export declare function resolveStoredEnvironment(
+  storedEnvironment: string | null | undefined,
+  defaultEnvironment?: TelnyxEnvironment
+): TelnyxEnvironment;

package/lib/internal/signaling-environment.js

@@ -0,0 +1,18 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.SIGNALING_ENVIRONMENT_STORAGE_KEY = void 0;
+exports.resolveStoredEnvironment = resolveStoredEnvironment;
+exports.SIGNALING_ENVIRONMENT_STORAGE_KEY = '@telnyx_signaling_environment';
+/**
+ * Resolves the signaling environment for a stored-config restore.
+ *
+ * An explicit stored selection always wins. A missing or invalid stored value
+ * (e.g. credentials persisted by an older Commons version) falls back to the
+ * client's configured default, and only then to production.
+ */
+function resolveStoredEnvironment(storedEnvironment, defaultEnvironment) {
+  if (storedEnvironment === 'development' || storedEnvironment === 'production') {
+    return storedEnvironment;
+  }
+  return defaultEnvironment ?? 'production';
+}

package/lib/models/call.d.ts

@@ -1,6 +1,7 @@
 import { Observable } from 'rxjs';
 import { TelnyxCallState } from './call-state';
 import { Call as TelnyxCall } from '@telnyx/react-native-voice-sdk';
+import type { CallQualityMetrics } from '@telnyx/react-native-voice-sdk';
 /**
  * Represents a call with reactive state streams.
  *
@@ -19,6 +20,8 @@ export declare class Call {
   private readonly _isMuted;
   private readonly _isHeld;
   private readonly _duration;
+  private readonly _qualityMetrics;
+  private readonly _onQualityMetrics;
   private _durationTimer?;
   private _startTime?;
   constructor(
@@ -75,7 +78,7 @@ export declare class Call {
   /**
    * Custom headers received from the WebRTC INVITE message.
    * These headers are passed during call initiation and can contain application-specific information.
-   * Format should be [{"name": "X-Header-Name", "value": "Value"}] where header names must start with "X-".
+   * Format: `[{"name": "X-Header-Name", "value": "Value"}]`; header names must start with `X-`.
    */
   get inviteCustomHeaders():
     | {
@@ -86,7 +89,7 @@ export declare class Call {
   /**
    * Custom headers received from the WebRTC ANSWER message.
    * These headers are passed during call acceptance and can contain application-specific information.
-   * Format should be [{"name": "X-Header-Name", "value": "Value"}] where header names must start with "X-".
+   * Format: `[{"name": "X-Header-Name", "value": "Value"}]`; header names must start with `X-`.
    */
   get answerCustomHeaders():
     | {
@@ -99,6 +102,13 @@ export declare class Call {
    * @internal
    */
   get telnyxCall(): TelnyxCall;
+  /**
+   * Inject an ICE failure into the underlying SDK recovery flow for manual
+   * testing. The underlying SDK accepts this only when debug mode is enabled.
+   *
+   * @returns true when a recovery episode was started.
+   */
+  simulateIceFailureForTesting(): boolean;
   /**
    * Observable stream of call state changes
    */
@@ -115,6 +125,17 @@ export declare class Call {
    * Observable stream of call duration changes (in seconds)
    */
   get duration$(): Observable<number>;
+  /**
+   * Observable stream of call quality metrics updates.
+   * Emits `null` initially, then a {@link CallQualityMetrics} object
+   * each time the underlying SDK collects a new sample.
+   */
+  get qualityMetrics$(): Observable<CallQualityMetrics | null>;
+  /**
+   * Current call quality metrics (synchronous access).
+   * Returns `null` until the first metrics sample is collected.
+   */
+  get currentQualityMetrics(): CallQualityMetrics | null;
   /**
    * Observable that emits true when the call can be answered
    */

package/lib/models/call.js

@@ -84,6 +84,10 @@ class Call {
     this._isMuted = new rxjs_1.BehaviorSubject(false);
     this._isHeld = new rxjs_1.BehaviorSubject(false);
     this._duration = new rxjs_1.BehaviorSubject(0);
+    this._qualityMetrics = new rxjs_1.BehaviorSubject(null);
+    this._onQualityMetrics = (metrics) => {
+      this._qualityMetrics.next(metrics);
+    };
     // Set initial state based on whether this is a reattached call
     if (isReattached) {
       console.log('Call: Setting initial state to ACTIVE for reattached call');
@@ -156,7 +160,7 @@ class Call {
   /**
    * Custom headers received from the WebRTC INVITE message.
    * These headers are passed during call initiation and can contain application-specific information.
-   * Format should be [{"name": "X-Header-Name", "value": "Value"}] where header names must start with "X-".
+   * Format: `[{"name": "X-Header-Name", "value": "Value"}]`; header names must start with `X-`.
    */
   get inviteCustomHeaders() {
     return this._telnyxCall.inviteCustomHeaders;
@@ -164,7 +168,7 @@ class Call {
   /**
    * Custom headers received from the WebRTC ANSWER message.
    * These headers are passed during call acceptance and can contain application-specific information.
-   * Format should be [{"name": "X-Header-Name", "value": "Value"}] where header names must start with "X-".
+   * Format: `[{"name": "X-Header-Name", "value": "Value"}]`; header names must start with `X-`.
    */
   get answerCustomHeaders() {
     return this._telnyxCall.answerCustomHeaders;
@@ -176,6 +180,16 @@ class Call {
   get telnyxCall() {
     return this._telnyxCall;
   }
+  /**
+   * Inject an ICE failure into the underlying SDK recovery flow for manual
+   * testing. The underlying SDK accepts this only when debug mode is enabled.
+   *
+   * @returns true when a recovery episode was started.
+   */
+  simulateIceFailureForTesting() {
+    const testableCall = this._telnyxCall;
+    return testableCall.simulateIceFailureForTesting?.() ?? false;
+  }
   /**
    * Observable stream of call state changes
    */
@@ -200,6 +214,21 @@ class Call {
   get duration$() {
     return this._duration.asObservable().pipe((0, operators_1.distinctUntilChanged)());
   }
+  /**
+   * Observable stream of call quality metrics updates.
+   * Emits `null` initially, then a {@link CallQualityMetrics} object
+   * each time the underlying SDK collects a new sample.
+   */
+  get qualityMetrics$() {
+    return this._qualityMetrics.asObservable().pipe((0, operators_1.distinctUntilChanged)());
+  }
+  /**
+   * Current call quality metrics (synchronous access).
+   * Returns `null` until the first metrics sample is collected.
+   */
+  get currentQualityMetrics() {
+    return this._qualityMetrics.value;
+  }
   /**
    * Observable that emits true when the call can be answered
    */
@@ -252,7 +281,10 @@ class Call {
         );
         if (callKitCoordinator.isAvailable()) {
           console.log('Call: Using CallKit coordinator to answer call (iOS)');
-          await callKitCoordinator.answerCallFromUI(this._telnyxCall);
+          const answered = await callKitCoordinator.answerCallFromUI(this._telnyxCall);
+          if (!answered) {
+            throw new Error('CallKit failed to answer call');
+          }
           return;
         }
       }
@@ -433,10 +465,12 @@ class Call {
    */
   dispose() {
     this._stopDurationTimer();
+    this._telnyxCall.off?.('telnyx.call.qualityMetrics', this._onQualityMetrics);
     this._callState.complete();
     this._isMuted.complete();
     this._isHeld.complete();
     this._duration.complete();
+    this._qualityMetrics.complete();
   }
   /**
    * Set up listeners for the underlying Telnyx call
@@ -531,6 +565,10 @@ class Call {
         }
       }
     });
+    // Forward quality metrics from the underlying SDK
+    // Subscribe to the event rather than the single onQualityMetrics slot, so
+    // an app can still set that callback on the underlying call.
+    this._telnyxCall.on('telnyx.call.qualityMetrics', this._onQualityMetrics);
   }
   /**
    * Map Telnyx SDK call states to our simplified call states

package/lib/models/config.d.ts

@@ -1,6 +1,8 @@
+import type { TelnyxIceServer } from '@telnyx/react-native-voice-sdk';
 /**
  * Configuration for credential-based authentication
  */
+export type TelnyxEnvironment = 'production' | 'development';
 export interface CredentialConfig {
   type: 'credential';
   sipUser: string;
@@ -15,14 +17,27 @@ export interface CredentialConfig {
   incomingCallRingtone?: string;
   /** Enable Trickle ICE. Default: false */
   useTrickleIce?: boolean;
+  /** Signaling environment. Default: production */
+  environment?: TelnyxEnvironment;
   /** Enable automatic call quality reporting. Default: true */
   enableCallReports?: boolean;
+  /**
+   * Deliver real-time call quality metrics on `Call.qualityMetrics$` while a
+   * call is active. Also enabled by `debug`. Default: false
+   */
+  enableQualityMetrics?: boolean;
   /** Stats collection interval in seconds. Default: 5 */
   callReportInterval?: number;
   /** Minimum log level for call reports: 'debug' | 'info' | 'warn' | 'error'. Default: 'debug' */
   callReportLogLevel?: string;
   /** Max log entries per call. Default: 1000 */
   callReportMaxLogEntries?: number;
+  /**
+   * Custom ICE servers (STUN/TURN) for WebRTC peer connections.
+   * When provided, overrides the Telnyx production defaults.
+   * When omitted, the SDK uses Telnyx defaults (STUN → TURN UDP → TURN TCP → TURNS 443).
+   */
+  iceServers?: TelnyxIceServer[];
 }
 /**
  * Configuration for token-based authentication
@@ -40,14 +55,27 @@ export interface TokenConfig {
   incomingCallRingtone?: string;
   /** Enable Trickle ICE. Default: false */
   useTrickleIce?: boolean;
+  /** Signaling environment. Default: production */
+  environment?: TelnyxEnvironment;
   /** Enable automatic call quality reporting. Default: true */
   enableCallReports?: boolean;
+  /**
+   * Deliver real-time call quality metrics on `Call.qualityMetrics$` while a
+   * call is active. Also enabled by `debug`. Default: false
+   */
+  enableQualityMetrics?: boolean;
   /** Stats collection interval in seconds. Default: 5 */
   callReportInterval?: number;
   /** Minimum log level for call reports: 'debug' | 'info' | 'warn' | 'error'. Default: 'debug' */
   callReportLogLevel?: string;
   /** Max log entries per call. Default: 1000 */
   callReportMaxLogEntries?: number;
+  /**
+   * Custom ICE servers (STUN/TURN) for WebRTC peer connections.
+   * When provided, overrides the Telnyx production defaults.
+   * When omitted, the SDK uses Telnyx defaults (STUN → TURN UDP → TURN TCP → TURNS 443).
+   */
+  iceServers?: TelnyxIceServer[];
 }
 /**
  * Union type for all supported authentication configurations

package/lib/telnyx-voip-client.d.ts

@@ -1,7 +1,7 @@
 import { Observable } from 'rxjs';
 import { TelnyxConnectionState } from './models/connection-state';
 import { Call } from './models/call';
-import { CredentialConfig, TokenConfig } from './models/config';
+import { CredentialConfig, TelnyxEnvironment, TokenConfig } from './models/config';
 import { type CustomHeaders } from './internal/calls/call-state-controller';
 /**
  * Configuration options for TelnyxVoipClient
@@ -13,6 +13,8 @@ export interface TelnyxVoipClientOptions {
   debug?: boolean;
   /** Enable Trickle ICE for calls created by this client */
   useTrickleIce?: boolean;
+  /** Signaling environment used for connections - default: production */
+  environment?: TelnyxEnvironment;
 }
 /**
  * The main public interface for the react-voice-commons module.
@@ -162,7 +164,7 @@ export declare class TelnyxVoipClient {
    * This method is used for auto-reconnection scenarios where the app
    * comes back to the foreground and needs to restore the connection.
    *
-   * @returns Promise<boolean> - true if reconnection was successful, false otherwise
+   * @returns Whether reconnection was successful.
    */
   loginFromStoredConfig(): Promise<boolean>;
   /**

package/lib/telnyx-voip-client.js

@@ -61,11 +61,14 @@ const connection_state_1 = require('./models/connection-state');
 const call_state_1 = require('./models/call-state');
 const config_1 = require('./models/config');
 const session_manager_1 = require('./internal/session/session-manager');
+const signaling_environment_1 = require('./internal/signaling-environment');
 const call_state_controller_1 = require('./internal/calls/call-state-controller');
 const voice_pn_bridge_1 = require('./internal/voice-pn-bridge');
+const ice_servers_storage_1 = require('./internal/ice-servers-storage');
 const USE_TRICKLE_ICE_STORAGE_KEY = '@use_trickle_ice';
 const PUSH_WHEN_ACTIVE_STORAGE_KEY = '@push_when_active';
 const MISSED_CALL_NOTIFICATIONS_STORAGE_KEY = '@enable_missed_call_notifications';
+const QUALITY_METRICS_STORAGE_KEY = '@enable_quality_metrics';
 const LEGACY_CALLKIT_ANSWER_KEY = '__legacy_callkit_answer__';
 /**
  * The main public interface for the react-voice-commons module.
@@ -111,10 +114,13 @@ class TelnyxVoipClient {
       enableAppStateManagement: true,
       debug: false,
       useTrickleIce: false,
+      environment: 'production',
       ...options,
     };
     // Initialize core components
-    this._sessionManager = new session_manager_1.SessionManager();
+    this._sessionManager = new session_manager_1.SessionManager({
+      defaultEnvironment: this._options.environment,
+    });
     this._callStateController = new call_state_controller_1.CallStateController(
       this._sessionManager
     );
@@ -308,6 +314,7 @@ class TelnyxVoipClient {
     const loginConfig = await this._withNativeVoipPushToken({
       ...config,
       useTrickleIce: config.useTrickleIce ?? this._options.useTrickleIce,
+      environment: config.environment ?? this._options.environment,
     });
     await voice_pn_bridge_1.VoicePnBridge.setIncomingCallRingtone(loginConfig.incomingCallRingtone);
     // Store credentials for future reconnection
@@ -335,6 +342,7 @@ class TelnyxVoipClient {
     const loginConfig = await this._withNativeVoipPushToken({
       ...config,
       useTrickleIce: config.useTrickleIce ?? this._options.useTrickleIce,
+      environment: config.environment ?? this._options.environment,
     });
     await voice_pn_bridge_1.VoicePnBridge.setIncomingCallRingtone(loginConfig.incomingCallRingtone);
     // Store token for future reconnection
@@ -362,7 +370,7 @@ class TelnyxVoipClient {
    * This method is used for auto-reconnection scenarios where the app
    * comes back to the foreground and needs to restore the connection.
    *
-   * @returns Promise<boolean> - true if reconnection was successful, false otherwise
+   * @returns Whether reconnection was successful.
    */
   async loginFromStoredConfig() {
     this._throwIfDisposed();
@@ -381,10 +389,22 @@ class TelnyxVoipClient {
       const storedMissedCallNotifications = await AsyncStorage.getItem(
         MISSED_CALL_NOTIFICATIONS_STORAGE_KEY
       );
+      const storedEnvironment = await AsyncStorage.getItem(
+        signaling_environment_1.SIGNALING_ENVIRONMENT_STORAGE_KEY
+      );
+      const storedQualityMetrics = await AsyncStorage.getItem(QUALITY_METRICS_STORAGE_KEY);
+      const iceServers = (0, ice_servers_storage_1.parseStoredIceServers)(
+        await AsyncStorage.getItem(ice_servers_storage_1.ICE_SERVERS_STORAGE_KEY)
+      );
       const useTrickleIce =
         storedUseTrickleIce === null ? this._options.useTrickleIce : storedUseTrickleIce === 'true';
       const pushWhenActive = storedPushWhenActive === 'true';
       const enableMissedCallNotifications = storedMissedCallNotifications === 'true';
+      const enableQualityMetrics = storedQualityMetrics === 'true';
+      const environment = (0, signaling_environment_1.resolveStoredEnvironment)(
+        storedEnvironment,
+        this._options.environment
+      );
       const nativePushToken =
         react_native_1.Platform.OS === 'ios'
           ? (await voice_pn_bridge_1.VoicePnBridge.getVoipToken())?.trim()
@@ -402,6 +422,9 @@ class TelnyxVoipClient {
           useTrickleIce,
           pushWhenActive,
           enableMissedCallNotifications,
+          enableQualityMetrics,
+          environment,
+          iceServers,
         });
         if (this._options.debug) {
           console.log(
@@ -421,6 +444,9 @@ class TelnyxVoipClient {
           useTrickleIce,
           pushWhenActive,
           enableMissedCallNotifications,
+          enableQualityMetrics,
+          environment,
+          iceServers,
         });
         if (this._options.debug) {
           console.log('TelnyxVoipClient: Reconnecting with stored token');
@@ -682,6 +708,22 @@ class TelnyxVoipClient {
         MISSED_CALL_NOTIFICATIONS_STORAGE_KEY,
         String(config.enableMissedCallNotifications ?? false)
       );
+      await AsyncStorage.setItem(
+        QUALITY_METRICS_STORAGE_KEY,
+        String(config.enableQualityMetrics ?? false)
+      );
+      await AsyncStorage.setItem(
+        signaling_environment_1.SIGNALING_ENVIRONMENT_STORAGE_KEY,
+        config.environment ?? this._options.environment ?? 'production'
+      );
+      if (config.iceServers) {
+        await AsyncStorage.setItem(
+          ice_servers_storage_1.ICE_SERVERS_STORAGE_KEY,
+          JSON.stringify(config.iceServers)
+        );
+      } else {
+        await AsyncStorage.removeItem(ice_servers_storage_1.ICE_SERVERS_STORAGE_KEY);
+      }
       if (config.pushNotificationDeviceToken) {
         await AsyncStorage.setItem('@push_token', config.pushNotificationDeviceToken);
       }
@@ -716,6 +758,22 @@ class TelnyxVoipClient {
         MISSED_CALL_NOTIFICATIONS_STORAGE_KEY,
         String(config.enableMissedCallNotifications ?? false)
       );
+      await AsyncStorage.setItem(
+        QUALITY_METRICS_STORAGE_KEY,
+        String(config.enableQualityMetrics ?? false)
+      );
+      await AsyncStorage.setItem(
+        signaling_environment_1.SIGNALING_ENVIRONMENT_STORAGE_KEY,
+        config.environment ?? this._options.environment ?? 'production'
+      );
+      if (config.iceServers) {
+        await AsyncStorage.setItem(
+          ice_servers_storage_1.ICE_SERVERS_STORAGE_KEY,
+          JSON.stringify(config.iceServers)
+        );
+      } else {
+        await AsyncStorage.removeItem(ice_servers_storage_1.ICE_SERVERS_STORAGE_KEY);
+      }
       if (config.pushNotificationDeviceToken) {
         await AsyncStorage.setItem('@push_token', config.pushNotificationDeviceToken);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/react-voice-commons-sdk",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "A high-level, state-agnostic, drop-in module for the Telnyx React Native SDK that simplifies WebRTC voice calling integration",
   "main": "lib/index.js",
   "module": "lib/index.js",
@@ -68,7 +68,7 @@
     "@react-native-async-storage/async-storage": "^2.1.0",
     "react": ">=19.0.0 <20.0.0",
     "react-native": ">=0.79.0 <1.0.0",
-    "react-native-webrtc": "^124.0.5"
+    "react-native-webrtc": "^155.0.1"
   },
   "peerDependenciesMeta": {
     "@react-native-async-storage/async-storage": {
@@ -86,9 +86,8 @@
   },
   "dependencies": {
     "@react-native-community/eslint-config": "^3.2.0",
-    "@telnyx/react-native-voice-sdk": ">=1.1.0",
+    "@telnyx/react-native-voice-sdk": "^1.2.0",
     "eventemitter3": "^5.0.1",
-    "expo": "~53.0.22",
     "react-native-url-polyfill": "^3.0.0",
     "react-native-voip-push-notification": "^3.3.3",
     "rxjs": "^7.8.2"

package/src/callkit/callkit-coordinator.ts

@@ -4,6 +4,14 @@ import { Call } from '@telnyx/react-native-voice-sdk';
 import { VoicePnBridge } from '../internal/voice-pn-bridge';
 import type { TelnyxVoipClient } from '../telnyx-voip-client';
 
+export type RemoteCallEndedReason = {
+  cause?: string;
+  causeCode?: number;
+  sipCode?: number;
+  sipReason?: string;
+  sipCallId?: string;
+};
+
 type PendingSwap = {
   mode: 'swap' | 'restoring' | 'rollback';
   originalActiveCallKitUUID: string;
@@ -37,6 +45,8 @@ class CallKitCoordinator {
   // Tracks action+UUID pairs so an end action is not dropped merely because
   // an answer or held action for the same call is still completing.
   private processingCalls = new Set<string>();
+  // CallKit/the app owns cross-call hold and swap policy. Only serialize
+  // duplicate actions for the same UUID; held calls must not block a new answer.
 
   // Tracks calls that have already been ended in CallKit to prevent duplicate reports
   private endedCalls = new Set<string>();
@@ -744,11 +754,44 @@ class CallKitCoordinator {
     }
   }
 
+  /** End a still-pending PushKit CallKit call after a remote hangup. */
+  async handlePendingPushCallRemoteEnded(
+    callKitUUID: string,
+    reason?: RemoteCallEndedReason
+  ): Promise<boolean> {
+    callKitUUID = this.normalizeUUID(callKitUUID);
+
+    // Do not let an unrelated/stale socket BYE terminate another CallKit call.
+    // The UUID is added here only after native CallKit registration succeeds.
+    if (!this.pendingPushCallUUIDs.has(callKitUUID)) {
+      console.log('CallKitCoordinator: Ignoring remote-ended event for unknown push UUID', {
+        callKitUUID,
+        reason,
+      });
+      return false;
+    }
+
+    console.log('CallKitCoordinator: Ending pending push call after remote hangup', {
+      callKitUUID,
+      reason,
+    });
+
+    if (!this.endedCalls.has(callKitUUID)) {
+      await CallKit.reportCallEnded(callKitUUID, CallEndReason.RemoteEnded);
+      this.endedCalls.add(callKitUUID);
+    }
+
+    this.cleanupCall(callKitUUID);
+    await this.clearMatchingPendingVoipPush(callKitUUID);
+    await this.checkBackgroundDisconnection();
+    return true;
+  }
+
   /**
    * Handle push notification answer - when user answers from CallKit but we don't have a WebRTC call yet
    * This is the iOS equivalent of the Android FCM handler
    */
-  private async handlePushNotificationAnswer(callKitUUID: string, event?: any) {
+  private async handlePushNotificationAnswer(callKitUUID: string, event?: any): Promise<boolean> {
     try {
       console.log(
         'CallKitCoordinator: Handling push notification answer for CallKit UUID:',
@@ -770,7 +813,7 @@ class CallKitCoordinator {
           // checkForInitialPushNotification() will run after setVoipClient()
           // and will find the push data still intact, call handleCallKitPushReceived()
           // which queues the matching auto-answer.
-          return;
+          return false;
         }
 
         // Queue one UUID-targeted answer. If the push is already being
@@ -779,22 +822,22 @@ class CallKitCoordinator {
         voipClient.queueAnswerFromCallKit(callKitUUID);
         if (this.pendingPushCallUUIDs.has(callKitUUID)) {
           this.autoAnswerCallUUIDs.delete(callKitUUID);
-          return;
+          return true;
         }
 
-        await this.handleCallKitPushReceived(callKitUUID, event);
-
-        return;
+        return await this.handleCallKitPushReceived(callKitUUID, event);
       }
 
       // For other platforms (shouldn't happen on iOS)
       console.error('CallKitCoordinator: ❌ Unsupported platform for push notification handling');
       await CallKit.reportCallEnded(callKitUUID, CallEndReason.Failed);
+      return false;
     } catch (error) {
       console.error('CallKitCoordinator: ❌ Error handling push notification answer:', error);
       // Report the call as failed to CallKit
       await CallKit.reportCallEnded(callKitUUID, CallEndReason.Failed);
       this.cleanupCall(callKitUUID);
+      return false;
     }
   }