@telnyx/react-voice-commons-sdk 0.4.2 → 1.0.0

package/ios/VoicePnBridge.swift

@@ -1,5 +1,6 @@
 import Foundation
 import React
+import AVFoundation
 
 @objc(VoicePnBridge)
 class VoicePnBridge: NSObject {
@@ -84,4 +85,49 @@ class VoicePnBridge: NSObject {
         NSLog("[VoicePnBridge] clearPendingVoipAction called. Cleared key pending_voip_action")
         resolve(true)
     }
-}
+
+    @objc
+    func setMissedCallNotificationsEnabled(_ enabled: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.set(enabled, forKey: TelnyxVoiceUserDefaultsKey.missedCallNotificationsEnabled)
+        UserDefaults.standard.synchronize()
+        NSLog("[VoicePnBridge] setMissedCallNotificationsEnabled called. enabled=\(enabled)")
+        resolve(true)
+    }
+
+    @objc
+    func getMissedCallNotificationsEnabled(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        if UserDefaults.standard.object(forKey: TelnyxVoiceUserDefaultsKey.missedCallNotificationsEnabled) == nil {
+            resolve(true)
+            return
+        }
+
+        resolve(UserDefaults.standard.bool(forKey: TelnyxVoiceUserDefaultsKey.missedCallNotificationsEnabled))
+    }
+
+    @objc
+    func setSpeakerEnabled(_ enabled: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        do {
+            let audioSession = AVAudioSession.sharedInstance()
+            // The Telnyx/WebRTC call setup is expected to configure a .playAndRecord-compatible
+            // session. Passing .none clears only the speaker override; accessories/session options
+            // can still decide the resulting output route.
+            try audioSession.overrideOutputAudioPort(enabled ? .speaker : .none)
+            let actualEnabled = audioSession.currentRoute.outputs.contains { output in
+                output.portType == .builtInSpeaker
+            }
+            NSLog("[VoicePnBridge] setSpeakerEnabled called. requested=\(enabled), actual=\(actualEnabled)")
+            resolve(actualEnabled)
+        } catch {
+            NSLog("[VoicePnBridge] setSpeakerEnabled failed. enabled=\(enabled), error=\(error)")
+            reject("SET_SPEAKER_ENABLED_ERROR", error.localizedDescription, error)
+        }
+    }
+
+    @objc
+    func isSpeakerEnabled(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let isEnabled = AVAudioSession.sharedInstance().currentRoute.outputs.contains { output in
+            output.portType == .builtInSpeaker
+        }
+        resolve(isEnabled)
+    }
+}

package/lib/index.d.ts

@@ -41,4 +41,5 @@ export {
 export type { Config, CredentialConfig, TokenConfig } from './models/config';
 export type { Call as TelnyxCall } from '@telnyx/react-native-voice-sdk';
 export * from './callkit';
+export { VoicePnBridge } from './internal/voice-pn-bridge';
 export { useAppReadyNotifier } from './hooks/useAppReadyNotifier';

package/lib/index.js

@@ -38,6 +38,7 @@ var __exportStar =
   };
 Object.defineProperty(exports, '__esModule', { value: true });
 exports.useAppReadyNotifier =
+  exports.VoicePnBridge =
   exports.createTokenConfig =
   exports.createCredentialConfig =
   exports.validateTokenConfig =
@@ -215,6 +216,14 @@ Object.defineProperty(exports, 'createTokenConfig', {
 });
 // Export CallKit functionality
 __exportStar(require('./callkit'), exports);
+// Native push notification helpers
+var voice_pn_bridge_1 = require('./internal/voice-pn-bridge');
+Object.defineProperty(exports, 'VoicePnBridge', {
+  enumerable: true,
+  get: function () {
+    return voice_pn_bridge_1.VoicePnBridge;
+  },
+});
 // Export hooks
 var useAppReadyNotifier_1 = require('./hooks/useAppReadyNotifier');
 Object.defineProperty(exports, 'useAppReadyNotifier', {

package/lib/internal/calls/call-state-controller.d.ts

@@ -12,6 +12,7 @@ export declare class CallStateController {
   private readonly _calls;
   private readonly _callMap;
   private _disposed;
+  private _listenerClient?;
   private _isWaitingForInvite?;
   private _onInviteAutoAccepted?;
   constructor(_sessionManager: SessionManager);
@@ -86,6 +87,11 @@ export declare class CallStateController {
    * Set up event listeners for the Telnyx client
    */
   private _setupClientListeners;
+  private _removeClientListeners;
+  private _handleTelnyxIncomingCall;
+  private _handleTelnyxReattachedCall;
+  private _handleTelnyxCallStateChanged;
+  private _handleTelnyxCallRemoved;
   /**
    * Handle incoming call or reattached call
    */

package/lib/internal/calls/call-state-controller.js

@@ -19,6 +19,33 @@ class CallStateController {
     this._calls = new rxjs_1.BehaviorSubject([]);
     this._callMap = new Map();
     this._disposed = false;
+    this._handleTelnyxIncomingCall = (telnyxCall, msg) => {
+      console.log('CallStateController: Incoming call received:', telnyxCall.callId);
+      this._handleIncomingCall(telnyxCall, msg, false);
+    };
+    this._handleTelnyxReattachedCall = (telnyxCall, msg) => {
+      console.log('CallStateController: Reattached call received:', telnyxCall.callId);
+      this._handleIncomingCall(telnyxCall, msg, true);
+    };
+    this._handleTelnyxCallStateChanged = (telnyxCall, state) => {
+      console.log(
+        'CallStateController: Call state changed from TelnyxRTC:',
+        telnyxCall.callId,
+        state
+      );
+      // Find our wrapper call and update if needed
+      const call = this.findCallByTelnyxCall(telnyxCall);
+      if (call) {
+        console.log(
+          'CallStateController: Found wrapper call, state sync handled by Call subscription'
+        );
+      }
+    };
+    this._handleTelnyxCallRemoved = (callId) => {
+      console.log('CallStateController: Call removed from TelnyxRTC:', callId);
+      // The call cleanup is already handled by our call state subscription.
+      // This event is informational for logging/debugging.
+    };
     console.log('CallStateController: Constructor called - instance created');
     // Don't set up client listeners here - client doesn't exist yet
     // Will be called when client is available
@@ -134,6 +161,9 @@ class CallStateController {
         callerIdName: callerName,
         callerIdNumber: callerNumber,
         customHeaders,
+        peerConnectionOptions: {
+          useTrickleIce: this._sessionManager.useTrickleIce,
+        },
       };
       const telnyxCall = await this._sessionManager.telnyxClient.newCall(callOptions);
       // Create our wrapper Call object
@@ -192,6 +222,7 @@ class CallStateController {
       return;
     }
     this._disposed = true;
+    this._removeClientListeners();
     // Dispose of all calls
     this.currentCalls.forEach((call) => call.dispose());
     this._callMap.clear();
@@ -203,30 +234,22 @@ class CallStateController {
    */
   _setupClientListeners() {
     console.log('CallStateController: Setting up client listeners...');
-    if (!this._sessionManager.telnyxClient) {
+    const telnyxClient = this._sessionManager.telnyxClient;
+    if (!telnyxClient) {
       console.log('CallStateController: No telnyxClient available yet, skipping listener setup');
       return;
     }
+    this._removeClientListeners();
+    this._listenerClient = telnyxClient;
     console.log('CallStateController: TelnyxClient found, setting up incoming call listener');
-    console.log(
-      'CallStateController: Client instance:',
-      this._sessionManager.telnyxClient.constructor.name
-    );
+    console.log('CallStateController: Client instance:', telnyxClient.constructor.name);
     // Listen for incoming calls
-    this._sessionManager.telnyxClient.on('telnyx.call.incoming', (telnyxCall, msg) => {
-      console.log('CallStateController: Incoming call received:', telnyxCall.callId);
-      this._handleIncomingCall(telnyxCall, msg, false);
-    });
+    telnyxClient.on('telnyx.call.incoming', this._handleTelnyxIncomingCall);
     // Listen for reattached calls (after network reconnection)
-    this._sessionManager.telnyxClient.on('telnyx.call.reattached', (telnyxCall, msg) => {
-      console.log('CallStateController: Reattached call received:', telnyxCall.callId);
-      this._handleIncomingCall(telnyxCall, msg, true);
-    });
+    telnyxClient.on('telnyx.call.reattached', this._handleTelnyxReattachedCall);
     // Verify listeners are set up
-    const incomingListeners =
-      this._sessionManager.telnyxClient.listenerCount('telnyx.call.incoming');
-    const reattachedListeners =
-      this._sessionManager.telnyxClient.listenerCount('telnyx.call.reattached');
+    const incomingListeners = telnyxClient.listenerCount('telnyx.call.incoming');
+    const reattachedListeners = telnyxClient.listenerCount('telnyx.call.reattached');
     console.log(
       'CallStateController: Listeners registered - incoming:',
       incomingListeners,
@@ -234,28 +257,21 @@ class CallStateController {
       reattachedListeners
     );
     // Listen for call state changes from the TelnyxRTC client (multi-call support)
-    this._sessionManager.telnyxClient.on('telnyx.call.stateChanged', (telnyxCall, state) => {
-      console.log(
-        'CallStateController: Call state changed from TelnyxRTC:',
-        telnyxCall.callId,
-        state
-      );
-      // Find our wrapper call and update if needed
-      const call = this.findCallByTelnyxCall(telnyxCall);
-      if (call) {
-        console.log(
-          'CallStateController: Found wrapper call, state sync handled by Call subscription'
-        );
-      }
-    });
+    telnyxClient.on('telnyx.call.stateChanged', this._handleTelnyxCallStateChanged);
     // Listen for call removal events from TelnyxRTC (multi-call support)
-    this._sessionManager.telnyxClient.on('telnyx.call.removed', (callId) => {
-      console.log('CallStateController: Call removed from TelnyxRTC:', callId);
-      // The call cleanup is already handled by our call state subscription
-      // This event is informational for logging/debugging
-    });
+    telnyxClient.on('telnyx.call.removed', this._handleTelnyxCallRemoved);
     console.log('CallStateController: Client listeners set up successfully');
   }
+  _removeClientListeners() {
+    if (!this._listenerClient) {
+      return;
+    }
+    this._listenerClient.off('telnyx.call.incoming', this._handleTelnyxIncomingCall);
+    this._listenerClient.off('telnyx.call.reattached', this._handleTelnyxReattachedCall);
+    this._listenerClient.off('telnyx.call.stateChanged', this._handleTelnyxCallStateChanged);
+    this._listenerClient.off('telnyx.call.removed', this._handleTelnyxCallRemoved);
+    this._listenerClient = undefined;
+  }
   /**
    * Handle incoming call or reattached call
    */

package/lib/internal/session/session-manager.d.ts

@@ -42,6 +42,7 @@ export declare class SessionManager {
    * Get the underlying Telnyx client instance
    */
   get telnyxClient(): TelnyxSDK.TelnyxRTC | undefined;
+  get useTrickleIce(): boolean;
   /**
    * Connect using credential authentication
    */

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

@@ -59,6 +59,8 @@ const TelnyxSDK = __importStar(require('@telnyx/react-native-voice-sdk'));
 const pkg = __importStar(require('../../../package.json'));
 const connection_state_1 = require('../../models/connection-state');
 const config_1 = require('../../models/config');
+const USE_TRICKLE_ICE_STORAGE_KEY = '@use_trickle_ice';
+const MISSED_CALL_NOTIFICATIONS_STORAGE_KEY = '@enable_missed_call_notifications';
 /**
  * Manages the connection lifecycle to the Telnyx platform.
  *
@@ -110,6 +112,9 @@ class SessionManager {
   get telnyxClient() {
     return this._telnyxClient;
   }
+  get useTrickleIce() {
+    return Boolean(this._currentConfig?.useTrickleIce);
+  }
   /**
    * Connect using credential authentication
    */
@@ -202,39 +207,22 @@ class SessionManager {
     );
     // Store the push notification payload for when the client is created
     this._pendingPushPayload = payload;
-    // If we have a TelnyxRTC instance but its socket isn't fresh — either not
-    // connected at all, or connected but with no traffic for longer than the
-    // threshold — dispose it so we go through the full _connect() path below
-    // instead of calling processVoIPNotification on a stale client.
-    //
-    // This handles two cases iOS gives us with the same code path:
-    //   1. Terminated-then-cold-launched: a client exists (constructed at
-    //      app boot) but its connection was never opened (idleMs=Infinity).
-    //   2. Suspended-then-thawed: a client exists with `connected=true`,
-    //      but the kernel killed the TLS session during freeze without
-    //      notifying the JS WebSocket wrapper, so no error event fired.
-    //
-    // 30s threshold matches the server's keep-alive ping cadence (~20s),
-    // so a live session always remains fresh.
-    const STALE_THRESHOLD_MS = 30000;
+    // Each push always rebuilds the TelnyxRTC client. The voice_sdk_id is
+    // baked into the WebSocket URL at socket-open time and can't be mutated
+    // mid-flight; reusing a connection from a previous push means the
+    // gateway routes THIS push's INVITE to a different (correctly-stamped)
+    // client and we sit on the wrong socket forever.
     if (this._telnyxClient) {
-      const client = this._telnyxClient;
-      const isFresh =
-        typeof client.isFresh === 'function'
-          ? client.isFresh(STALE_THRESHOLD_MS)
-          : !!client.connected;
-      if (!isFresh) {
-        try {
-          await this._telnyxClient.disconnect();
-        } catch (err) {
-          console.warn('SessionManager: disconnect of stale client threw:', err);
-        }
-        this._telnyxClient = undefined;
-        if (this.currentState !== connection_state_1.TelnyxConnectionState.DISCONNECTED) {
-          this._connectionState.next(connection_state_1.TelnyxConnectionState.DISCONNECTED);
-        }
+      try {
+        await this._telnyxClient.disconnect();
+      } catch (err) {
+        console.warn('SessionManager: disconnect of prior client threw:', err);
       }
     }
+    this._telnyxClient = undefined;
+    if (this.currentState !== connection_state_1.TelnyxConnectionState.DISCONNECTED) {
+      this._connectionState.next(connection_state_1.TelnyxConnectionState.DISCONNECTED);
+    }
     // If we don't have a config yet but we're processing a push notification,
     // attempt to load stored config first (for terminated app startup)
     if (!this._currentConfig && !this._telnyxClient) {
@@ -248,12 +236,20 @@ class SessionManager {
         const storedPassword = await AsyncStorage.getItem('@telnyx_password');
         const storedCredentialToken = await AsyncStorage.getItem('@credential_token');
         const storedPushToken = await AsyncStorage.getItem('@push_token');
+        const storedUseTrickleIce = await AsyncStorage.getItem(USE_TRICKLE_ICE_STORAGE_KEY);
+        const storedMissedCallNotifications = await AsyncStorage.getItem(
+          MISSED_CALL_NOTIFICATIONS_STORAGE_KEY
+        );
+        const useTrickleIce = storedUseTrickleIce === 'true';
+        const enableMissedCallNotifications = storedMissedCallNotifications === 'true';
         // Check if we have credential-based authentication data
         if (storedUsername && storedPassword) {
           console.log('SessionManager: RELEASE DEBUG - Found stored credentials, creating config');
           const { createCredentialConfig } = require('../../models/config');
           this._currentConfig = createCredentialConfig(storedUsername, storedPassword, {
             pushNotificationDeviceToken: storedPushToken,
+            useTrickleIce,
+            enableMissedCallNotifications,
           });
         }
         // Check if we have token-based authentication data
@@ -262,6 +258,8 @@ class SessionManager {
           const { createTokenConfig } = require('../../models/config');
           this._currentConfig = createTokenConfig(storedCredentialToken, {
             pushNotificationDeviceToken: storedPushToken,
+            useTrickleIce,
+            enableMissedCallNotifications,
           });
         }
         if (this._currentConfig) {
@@ -375,6 +373,8 @@ class SessionManager {
           logLevel: this._currentConfig.debug ? 'debug' : 'warn',
           debug: this._currentConfig.debug ?? false,
           pushNotificationDeviceToken: this._currentConfig.pushNotificationDeviceToken,
+          enableMissedCallNotifications: this._currentConfig.enableMissedCallNotifications ?? false,
+          useTrickleIce: this._currentConfig.useTrickleIce,
           enableCallReports: this._currentConfig.enableCallReports,
           callReportInterval: this._currentConfig.callReportInterval,
           callReportLogLevel: this._currentConfig.callReportLogLevel,
@@ -393,6 +393,8 @@ class SessionManager {
           logLevel: this._currentConfig.debug ? 'debug' : 'warn',
           debug: this._currentConfig.debug ?? false,
           pushNotificationDeviceToken: this._currentConfig.pushNotificationDeviceToken,
+          enableMissedCallNotifications: this._currentConfig.enableMissedCallNotifications ?? false,
+          useTrickleIce: this._currentConfig.useTrickleIce,
           enableCallReports: this._currentConfig.enableCallReports,
           callReportInterval: this._currentConfig.callReportInterval,
           callReportLogLevel: this._currentConfig.callReportLogLevel,

package/lib/internal/voice-pn-bridge.d.ts

@@ -30,6 +30,10 @@ export interface VoicePnBridgeInterface {
   clearPendingVoipPush(): Promise<boolean>;
   getPendingVoipAction(): Promise<string | null>;
   clearPendingVoipAction(): Promise<boolean>;
+  setMissedCallNotificationsEnabled(enabled: boolean): Promise<boolean>;
+  getMissedCallNotificationsEnabled(): Promise<boolean>;
+  setSpeakerEnabled(enabled: boolean): Promise<boolean>;
+  isSpeakerEnabled(): Promise<boolean>;
 }
 declare const NativeBridge: VoicePnBridgeInterface;
 /**
@@ -107,6 +111,28 @@ export declare class VoicePnBridge {
    * Clear pending VoIP action from native storage (iOS only)
    */
   static clearPendingVoipAction(): Promise<boolean>;
+  /**
+   * Enable or disable local missed call notifications on iOS.
+   * Missed-call VoIP pushes are still handled through CallKit either way.
+   */
+  static setMissedCallNotificationsEnabled(enabled: boolean): Promise<boolean>;
+  /**
+   * Returns true by default, matching the sample-app behavior for missed calls.
+   */
+  static getMissedCallNotificationsEnabled(): Promise<boolean>;
+  /**
+   * Route call audio through the loudspeaker when enabled, or back to the
+   * platform default voice route when disabled.
+   */
+  static setSpeakerEnabled(enabled: boolean): Promise<boolean>;
+  /**
+   * Returns whether the current audio route is using the loudspeaker.
+   */
+  static isSpeakerEnabled(): Promise<boolean>;
+  /**
+   * Toggle between loudspeaker and the platform default voice route.
+   */
+  static toggleSpeaker(): Promise<boolean>;
   /**
    * Android → React Native: Listen for immediate call action events from notification buttons
    * Use this for active calls where immediate response is needed (e.g., ending ongoing calls)

package/lib/internal/voice-pn-bridge.js

@@ -184,6 +184,61 @@ class VoicePnBridge {
       return false;
     }
   }
+  /**
+   * Enable or disable local missed call notifications on iOS.
+   * Missed-call VoIP pushes are still handled through CallKit either way.
+   */
+  static async setMissedCallNotificationsEnabled(enabled) {
+    try {
+      return await NativeBridge.setMissedCallNotificationsEnabled(enabled);
+    } catch (error) {
+      console.error('VoicePnBridge: Error setting missed call notifications:', error);
+      return false;
+    }
+  }
+  /**
+   * Returns true by default, matching the sample-app behavior for missed calls.
+   */
+  static async getMissedCallNotificationsEnabled() {
+    try {
+      return await NativeBridge.getMissedCallNotificationsEnabled();
+    } catch (error) {
+      console.error('VoicePnBridge: Error getting missed call notifications setting:', error);
+      return true;
+    }
+  }
+  /**
+   * Route call audio through the loudspeaker when enabled, or back to the
+   * platform default voice route when disabled.
+   */
+  static async setSpeakerEnabled(enabled) {
+    try {
+      return await NativeBridge.setSpeakerEnabled(enabled);
+    } catch (error) {
+      console.error('VoicePnBridge: Error setting speaker route:', error);
+      throw error;
+    }
+  }
+  /**
+   * Returns whether the current audio route is using the loudspeaker.
+   */
+  static async isSpeakerEnabled() {
+    try {
+      return await NativeBridge.isSpeakerEnabled();
+    } catch (error) {
+      console.error('VoicePnBridge: Error getting speaker route:', error);
+      throw error;
+    }
+  }
+  /**
+   * Toggle between loudspeaker and the platform default voice route.
+   */
+  static async toggleSpeaker() {
+    // This is intentionally read-then-write because route changes can also come from
+    // the OS, Bluetooth, wired accessories, or the active call session.
+    const enabled = await VoicePnBridge.isSpeakerEnabled();
+    return VoicePnBridge.setSpeakerEnabled(!enabled);
+  }
   /**
    * Android → React Native: Listen for immediate call action events from notification buttons
    * Use this for active calls where immediate response is needed (e.g., ending ongoing calls)

package/lib/models/config.d.ts

@@ -7,6 +7,10 @@ export interface CredentialConfig {
   sipPassword: string;
   debug?: boolean;
   pushNotificationDeviceToken?: string;
+  /** Enable native missed call push notifications. Default: false */
+  enableMissedCallNotifications?: boolean;
+  /** Enable Trickle ICE. Default: false */
+  useTrickleIce?: boolean;
   /** Enable automatic call quality reporting. Default: true */
   enableCallReports?: boolean;
   /** Stats collection interval in seconds. Default: 5 */
@@ -24,6 +28,10 @@ export interface TokenConfig {
   token: string;
   debug?: boolean;
   pushNotificationDeviceToken?: string;
+  /** Enable native missed call push notifications. Default: false */
+  enableMissedCallNotifications?: boolean;
+  /** Enable Trickle ICE. Default: false */
+  useTrickleIce?: boolean;
   /** Enable automatic call quality reporting. Default: true */
   enableCallReports?: boolean;
   /** Stats collection interval in seconds. Default: 5 */

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

@@ -10,6 +10,8 @@ export interface TelnyxVoipClientOptions {
   enableAppStateManagement?: boolean;
   /** Enable debug logging */
   debug?: boolean;
+  /** Enable Trickle ICE for calls created by this client */
+  useTrickleIce?: boolean;
 }
 /**
  * The main public interface for the react-voice-commons module.

package/lib/telnyx-voip-client.js

@@ -10,6 +10,8 @@ const config_1 = require('./models/config');
 const session_manager_1 = require('./internal/session/session-manager');
 const call_state_controller_1 = require('./internal/calls/call-state-controller');
 const voice_pn_bridge_1 = require('./internal/voice-pn-bridge');
+const USE_TRICKLE_ICE_STORAGE_KEY = '@use_trickle_ice';
+const MISSED_CALL_NOTIFICATIONS_STORAGE_KEY = '@enable_missed_call_notifications';
 /**
  * The main public interface for the react-voice-commons module.
  *
@@ -52,6 +54,7 @@ class TelnyxVoipClient {
     this._options = {
       enableAppStateManagement: true,
       debug: false,
+      useTrickleIce: false,
       ...options,
     };
     // Initialize core components
@@ -185,9 +188,13 @@ class TelnyxVoipClient {
     if (this._options.debug) {
       console.log('TelnyxVoipClient: Logging in with credentials for user:', config.sipUser);
     }
+    const loginConfig = {
+      ...config,
+      useTrickleIce: config.useTrickleIce ?? this._options.useTrickleIce,
+    };
     // Store credentials for future reconnection
-    await this._storeCredentials(config);
-    await this._sessionManager.connectWithCredential(config);
+    await this._storeCredentials(loginConfig);
+    await this._sessionManager.connectWithCredential(loginConfig);
   }
   /**
    * Connects to the Telnyx platform using token authentication.
@@ -207,9 +214,13 @@ class TelnyxVoipClient {
     if (this._options.debug) {
       console.log('TelnyxVoipClient: Logging in with token');
     }
+    const loginConfig = {
+      ...config,
+      useTrickleIce: config.useTrickleIce ?? this._options.useTrickleIce,
+    };
     // Store token for future reconnection
-    await this._storeToken(config);
-    await this._sessionManager.connectWithToken(config);
+    await this._storeToken(loginConfig);
+    await this._sessionManager.connectWithToken(loginConfig);
   }
   /**
    * Disconnects from the Telnyx platform.
@@ -246,12 +257,21 @@ class TelnyxVoipClient {
       const storedPassword = await AsyncStorage.getItem('@telnyx_password');
       const storedCredentialToken = await AsyncStorage.getItem('@credential_token');
       const storedPushToken = await AsyncStorage.getItem('@push_token');
+      const storedUseTrickleIce = await AsyncStorage.getItem(USE_TRICKLE_ICE_STORAGE_KEY);
+      const storedMissedCallNotifications = await AsyncStorage.getItem(
+        MISSED_CALL_NOTIFICATIONS_STORAGE_KEY
+      );
+      const useTrickleIce =
+        storedUseTrickleIce === null ? this._options.useTrickleIce : storedUseTrickleIce === 'true';
+      const enableMissedCallNotifications = storedMissedCallNotifications === 'true';
       // Check if we have credential-based authentication data
       if (storedUsername && storedPassword) {
         // Create credential config from stored data
         const { createCredentialConfig } = require('./models/config');
         const config = createCredentialConfig(storedUsername, storedPassword, {
           pushNotificationDeviceToken: storedPushToken,
+          useTrickleIce,
+          enableMissedCallNotifications,
         });
         if (this._options.debug) {
           console.log(
@@ -268,6 +288,8 @@ class TelnyxVoipClient {
         const { createTokenConfig } = require('./models/config');
         const config = createTokenConfig(storedCredentialToken, {
           pushNotificationDeviceToken: storedPushToken,
+          useTrickleIce,
+          enableMissedCallNotifications,
         });
         if (this._options.debug) {
           console.log('TelnyxVoipClient: Reconnecting with stored token');
@@ -333,21 +355,14 @@ class TelnyxVoipClient {
       console.log('TelnyxVoipClient: Handling push notification:', payload);
     }
     try {
-      // First, pass the push notification to the session manager for processing
-      // This will set the isCallFromPush flag on the TelnyxRTC client
+      // SessionManager owns the entire push lifecycle: it disposes any prior
+      // client, loads stored credentials if needed, and rebuilds the
+      // TelnyxRTC bound to THIS push's voice_sdk_id. We deliberately do not
+      // fall back to a generic loginFromStoredConfig() here — that would
+      // create a parallel client with no voice_sdk_id awareness, which the
+      // gateway then has to `punt` once the SessionManager-driven session
+      // also registers, dropping the active call.
       await this._sessionManager.handlePushNotification(payload);
-      // Connect if not already connected
-      const currentState = this.currentConnectionState;
-      if (currentState !== connection_state_1.TelnyxConnectionState.CONNECTED) {
-        // Try to login from stored config - now the push flags should be set
-        const loginSuccess = await this.loginFromStoredConfig();
-        if (!loginSuccess) {
-          console.warn(
-            'TelnyxVoipClient: Could not login from stored config for push notification'
-          );
-          return;
-        }
-      }
     } catch (error) {
       console.error('TelnyxVoipClient: Error handling push notification:', error);
       throw error;
@@ -448,6 +463,14 @@ class TelnyxVoipClient {
       const AsyncStorage = require('@react-native-async-storage/async-storage').default;
       await AsyncStorage.setItem('@telnyx_username', config.sipUser);
       await AsyncStorage.setItem('@telnyx_password', config.sipPassword);
+      await AsyncStorage.setItem(
+        USE_TRICKLE_ICE_STORAGE_KEY,
+        String(config.useTrickleIce ?? false)
+      );
+      await AsyncStorage.setItem(
+        MISSED_CALL_NOTIFICATIONS_STORAGE_KEY,
+        String(config.enableMissedCallNotifications ?? false)
+      );
       if (config.pushNotificationDeviceToken) {
         await AsyncStorage.setItem('@push_token', config.pushNotificationDeviceToken);
       }
@@ -470,6 +493,14 @@ class TelnyxVoipClient {
     try {
       const AsyncStorage = require('@react-native-async-storage/async-storage').default;
       await AsyncStorage.setItem('@credential_token', config.token);
+      await AsyncStorage.setItem(
+        USE_TRICKLE_ICE_STORAGE_KEY,
+        String(config.useTrickleIce ?? false)
+      );
+      await AsyncStorage.setItem(
+        MISSED_CALL_NOTIFICATIONS_STORAGE_KEY,
+        String(config.enableMissedCallNotifications ?? false)
+      );
       if (config.pushNotificationDeviceToken) {
         await AsyncStorage.setItem('@push_token', config.pushNotificationDeviceToken);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/react-voice-commons-sdk",
-  "version": "0.4.2",
+  "version": "1.0.0",
   "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",
@@ -86,7 +86,7 @@
   },
   "dependencies": {
     "@react-native-community/eslint-config": "^3.2.0",
-    "@telnyx/react-native-voice-sdk": ">=0.4.4",
+    "@telnyx/react-native-voice-sdk": ">=1.0.0",
     "eventemitter3": "^5.0.1",
     "expo": "~53.0.22",
     "react-native-url-polyfill": "^3.0.0",

package/src/index.ts

@@ -55,5 +55,8 @@ export type { Call as TelnyxCall } from '@telnyx/react-native-voice-sdk';
 // Export CallKit functionality
 export * from './callkit';
 
+// Native push notification helpers
+export { VoicePnBridge } from './internal/voice-pn-bridge';
+
 // Export hooks
 export { useAppReadyNotifier } from './hooks/useAppReadyNotifier';