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

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
    */
@@ -231,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
@@ -245,6 +258,8 @@ class SessionManager {
           const { createTokenConfig } = require('../../models/config');
           this._currentConfig = createTokenConfig(storedCredentialToken, {
             pushNotificationDeviceToken: storedPushToken,
+            useTrickleIce,
+            enableMissedCallNotifications,
           });
         }
         if (this._currentConfig) {
@@ -358,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,
@@ -376,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');
@@ -441,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);
       }
@@ -463,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.3",
+  "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.5",
+    "@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';