@telnyx/react-voice-commons-sdk 0.1.7-beta.1 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # CHANGELOG.md
 
+## [0.1.7](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.7) (2026-02-20)
+
+### Enhancement
+
+• Added `TelnyxVoipClient.isLaunchedFromPushNotification()` static method to check if the app was cold-started from a push notification, allowing consumers to skip auto-login and avoid double-login races
+• `createTelnyxVoipClient()` now returns a singleton — safe to call inside React component bodies without creating a new instance on every render
+• Added `destroyTelnyxVoipClient()` to tear down the singleton when a fresh instance is needed
+• `TelnyxVoiceApp` now automatically wires the `voipClient` on the CallKit coordinator on mount — consumers no longer need to manually call `setVoipClient()` at the correct component level
+
+### Bug Fixing
+
+• Fixed cold-start push notification failures caused by double-login race between user auto-login and SDK internal push login
+• Fixed CallKit coordinator having no `voipClient` reference when user answered a call via CallKit before navigating to the correct screen
+• Fixed `call_id` extraction in `checkForInitialPushNotification` — the double-nested path `pushData.metadata?.metadata?.call_id` never resolved, so the CallKit coordinator was bypassed on iOS
+• Refactored `checkForInitialPushNotification` into `getAndroidPushData` and `getIOSPushData` helpers to reduce nesting and improve readability
+
+### Deprecation
+
+• `setVoipClient()` on `CallKitCoordinator` and `useCallKitCoordinator()` hook is now deprecated — `TelnyxVoiceApp` handles this automatically
+
+## [0.1.7-beta.0](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.7-beta.0) (2026-02-18)
+
+### Bug Fixing
+
+• Fixed `call_id` extraction in `checkForInitialPushNotification` — the double-nested path `pushData.metadata?.metadata?.call_id` never resolved, so the CallKit coordinator was bypassed and all iOS push calls fell through to direct handling
+• Refactored `checkForInitialPushNotification` into `getAndroidPushData` and `getIOSPushData` helpers to reduce nesting and improve readability
+
 ## [0.1.6](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.6) (2025-12-09)
 
 ### Enhancement

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

@@ -326,8 +326,8 @@ class CallStateController {
         console.log('CallStateController: Reporting incoming call to CallKitCoordinator');
         callkit_coordinator_1.callKitCoordinator.reportIncomingCall(
           telnyxCall,
-          call.destination,
-          call.destination
+          call.callerName,
+          call.callerNumber
         );
       } else {
         // Handle outgoing call with CallKit

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

@@ -49,7 +49,9 @@ export declare class SessionManager {
    */
   disconnect(): Promise<void>;
   /**
-   * Disable push notifications for the current session
+   * Disable push notifications for the current session.
+   * Delegates to the TelnyxRTC client's disablePushNotification() method
+   * which sends a 'telnyx_rtc.disable_push_notification' message via the socket.
    */
   disablePushNotifications(): void;
   /**

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

@@ -140,16 +140,19 @@ class SessionManager {
     this._connectionState.next(connection_state_1.TelnyxConnectionState.DISCONNECTED);
   }
   /**
-   * Disable push notifications for the current session
+   * Disable push notifications for the current session.
+   * Delegates to the TelnyxRTC client's disablePushNotification() method
+   * which sends a 'telnyx_rtc.disable_push_notification' message via the socket.
    */
   disablePushNotifications() {
     if (
       this._telnyxClient &&
       this.currentState === connection_state_1.TelnyxConnectionState.CONNECTED
     ) {
-      // Implementation depends on the actual Telnyx SDK API
-      // This is a placeholder for the actual implementation
-      console.log('Disabling push notifications for session:', this._sessionId);
+      console.log('SessionManager: Disabling push notifications for session:', this._sessionId);
+      this._telnyxClient.disablePushNotification();
+    } else {
+      console.warn('SessionManager: Cannot disable push - client not connected');
     }
   }
   /**

package/lib/models/call.d.ts

@@ -46,6 +46,16 @@ export declare class Call {
    * Whether this is an outgoing call
    */
   get isOutgoing(): boolean;
+  /**
+   * The original caller name (from_display_name) received in the INVITE message.
+   * Falls back to destination if not available.
+   */
+  get callerName(): string;
+  /**
+   * The original caller number received in the INVITE message.
+   * Falls back to destination if not available.
+   */
+  get callerNumber(): string;
   /**
    * Current call state (synchronous access)
    */

package/lib/models/call.js

@@ -115,6 +115,20 @@ class Call {
   get isOutgoing() {
     return !this._isIncoming;
   }
+  /**
+   * The original caller name (from_display_name) received in the INVITE message.
+   * Falls back to destination if not available.
+   */
+  get callerName() {
+    return this._originalCallerName || this._destination;
+  }
+  /**
+   * The original caller number received in the INVITE message.
+   * Falls back to destination if not available.
+   */
+  get callerNumber() {
+    return this._originalCallerNumber || this._destination;
+  }
   /**
    * Current call state (synchronous access)
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/react-voice-commons-sdk",
-  "version": "0.1.7-beta.1",
+  "version": "0.1.7",
   "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",

package/src/internal/calls/call-state-controller.ts

@@ -392,7 +392,7 @@ export class CallStateController {
       } else if (call.isIncoming) {
         // Handle incoming call with CallKit (only if not already integrated)
         console.log('CallStateController: Reporting incoming call to CallKitCoordinator');
-        callKitCoordinator.reportIncomingCall(telnyxCall, call.destination, call.destination);
+        callKitCoordinator.reportIncomingCall(telnyxCall, call.callerName, call.callerNumber);
       } else {
         // Handle outgoing call with CallKit
         console.log('CallStateController: Starting outgoing call with CallKitCoordinator');

package/src/internal/session/session-manager.ts

@@ -111,13 +111,16 @@ export class SessionManager {
   }
 
   /**
-   * Disable push notifications for the current session
+   * Disable push notifications for the current session.
+   * Delegates to the TelnyxRTC client's disablePushNotification() method
+   * which sends a 'telnyx_rtc.disable_push_notification' message via the socket.
    */
   disablePushNotifications(): void {
     if (this._telnyxClient && this.currentState === TelnyxConnectionState.CONNECTED) {
-      // Implementation depends on the actual Telnyx SDK API
-      // This is a placeholder for the actual implementation
-      console.log('Disabling push notifications for session:', this._sessionId);
+      console.log('SessionManager: Disabling push notifications for session:', this._sessionId);
+      this._telnyxClient.disablePushNotification();
+    } else {
+      console.warn('SessionManager: Cannot disable push - client not connected');
     }
   }
 

package/src/models/call.ts

@@ -66,6 +66,22 @@ export class Call {
     return !this._isIncoming;
   }
 
+  /**
+   * The original caller name (from_display_name) received in the INVITE message.
+   * Falls back to destination if not available.
+   */
+  get callerName(): string {
+    return this._originalCallerName || this._destination;
+  }
+
+  /**
+   * The original caller number received in the INVITE message.
+   * Falls back to destination if not available.
+   */
+  get callerNumber(): string {
+    return this._originalCallerNumber || this._destination;
+  }
+
   /**
    * Current call state (synchronous access)
    */

package/src/types/telnyx-sdk.d.ts

@@ -83,6 +83,7 @@ declare module '@telnyx/react-native-voice-sdk' {
     connect(): Promise<void>;
     disconnect(): void;
     newCall(options: CallOptions): Promise<Call>;
+    disablePushNotification(): void;
 
     on(event: string, listener: (...args: any[]) => void): this;
     off(event: string, listener: (...args: any[]) => void): this;