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

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # CHANGELOG.md
 
+## [0.1.9](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.9) (2026-03-19)
+
+### Enhancement
+
+- Upgraded low-level SDK dependency from `@telnyx/react-native-voice-sdk@0.3.0` to `@telnyx/react-native-voice-sdk@0.4.0`
+- Commons SDK version now propagates to the low-level SDK User-Agent via `sdkVersion` option
+- Added hidden long-press button on status text to disable push notifications for debugging
+- Disabled debug logging and call reports by default for production readiness
+
+### Bug Fixing
+
+- Fixed stale push notification state by clearing pending VoIP push data on call end
+- Fixed User-Agent inconsistency — all WebSocket messages now use `ReactNative-{version}` format
+- Fixed unnecessary JSON-RPC ACK messages (invite, answer, ringing) that were causing issues
+- Fixed `telnyxCallControlId` ReferenceError on inbound calls in the low-level SDK
+
+## [0.1.8](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.8) (2026-03-09)
+
+### Bug Fixing
+
+• Fixed duplicate CXProvider overwrite causing `CXEndCallAction` error 4 (unknownCallUUID) — guard `setupCallKit()` to prevent async `setupAutomatically()` from overwriting the provider created by `setupSynchronously()` during VoIP push handling
+• Fixed intermittent audio loss on push notification calls — defer `CXAnswerCallAction.fulfill()` until `reportCallConnected()` when the WebRTC peer connection is ready
+• Aligned iOS audio session handling with native Telnyx iOS SDK pattern (`RTCAudioSessionConfiguration.webRTC()` with `lockForConfiguration`/`unlockForConfiguration`)
+• Fixed endCall not dismissing CallKit UI — check `endCall()` return value and fallback to `reportCallEnded()` when CXEndCallAction fails
+• Fixed push notification answer crash when voipClient is not yet initialized — defer to `checkForInitialPushNotification()` instead of failing the call
+• Added `voipClient.queueAnswerFromCallKit()` call when handling push notification answer for auto-answer on INVITE arrival
+• Fixed call ENDED state not received by subscribers
+• Added platform guards for iOS-only VoIP bridge methods on Android
+• Fixed push data race condition in Expo apps
+
 ## [0.1.8-beta.1](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.8-beta.1) (2026-03-04)
 
 ### Bug Fixing
@@ -11,6 +41,12 @@
 • Fixed push notification answer crash when voipClient is not yet initialized — defer to `checkForInitialPushNotification()` instead of failing the call
 • Added `voipClient.queueAnswerFromCallKit()` call when handling push notification answer for auto-answer on INVITE arrival
 
+## [0.1.8-beta.0](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.8-beta.0) (2026-02-28)
+
+### Bug Fixing
+
+• Fixed push data race condition in Expo apps
+
 ## [0.1.7](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.7) (2026-02-20)
 
 ### Enhancement

package/README.md

@@ -84,7 +84,7 @@ destroyTelnyxVoipClient(); // Disposes the singleton; next createTelnyxVoipClien
 **Configuration Options Explained:**
 
 - **`enableAppStateManagement: true`** - **Optional (default: true)**: Enables automatic background/foreground app state management. When enabled, the library automatically disconnects when the app goes to background (unless there's an active call) and handles reconnection logic. Set to `false` if you want to handle app lifecycle manually.
-- **`debug: true`** - **Optional**: Enables detailed logging for connection states, call transitions, and push notification processing. Useful for development and troubleshooting.
+- **`debug: true`** - **Optional (default: false)**: Enables detailed logging for connection states, call transitions, and push notification processing. Useful for development and troubleshooting.
 
 ### 2. TelnyxVoiceApp Wrapper
 

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

@@ -6,6 +6,7 @@ const operators_1 = require('rxjs/operators');
 const call_1 = require('../../models/call');
 const call_state_1 = require('../../models/call-state');
 const callkit_coordinator_1 = require('../../callkit/callkit-coordinator');
+const voice_pn_bridge_1 = require('../voice-pn-bridge');
 /**
  * Central state machine for call management.
  *
@@ -343,12 +344,17 @@ class CallStateController {
     call.callState$.subscribe((state) => {
       // CallKitCoordinator automatically updates CallKit via setupWebRTCCallListeners
       console.log('CallStateController: Call state changed to:', state);
-      // Clean up when call ends
+      // Clean up when call ends - delay to next tick so external subscribers
+      // receive the ENDED/FAILED state before the call is disposed
       if (
         state === call_state_1.TelnyxCallState.ENDED ||
         state === call_state_1.TelnyxCallState.FAILED
       ) {
-        this._removeCall(call.callId);
+        // Clear pending push data so the next app launch isn't mistaken for a push launch
+        voice_pn_bridge_1.VoicePnBridge.clearPendingVoipPush().catch((e) =>
+          console.warn('CallStateController: Failed to clear pending voip push:', e)
+        );
+        setTimeout(() => this._removeCall(call.callId), 0);
       }
     });
   }

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

@@ -56,6 +56,7 @@ 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 connection_state_1 = require('../../models/connection-state');
 const config_1 = require('../../models/config');
 /**
@@ -313,7 +314,13 @@ class SessionManager {
           login: this._currentConfig.sipUser,
           password: this._currentConfig.sipPassword,
           logLevel: this._currentConfig.debug ? 'debug' : 'warn',
+          debug: this._currentConfig.debug ?? false,
           pushNotificationDeviceToken: this._currentConfig.pushNotificationDeviceToken,
+          enableCallReports: this._currentConfig.enableCallReports,
+          callReportInterval: this._currentConfig.callReportInterval,
+          callReportLogLevel: this._currentConfig.callReportLogLevel,
+          callReportMaxLogEntries: this._currentConfig.callReportMaxLogEntries,
+          sdkVersion: pkg.version,
         };
         console.log(
           '🔧 SessionManager: Creating TelnyxRTC with credential config, logLevel:',
@@ -325,7 +332,13 @@ class SessionManager {
         clientOptions = {
           login_token: this._currentConfig.token,
           logLevel: this._currentConfig.debug ? 'debug' : 'warn',
+          debug: this._currentConfig.debug ?? false,
           pushNotificationDeviceToken: this._currentConfig.pushNotificationDeviceToken,
+          enableCallReports: this._currentConfig.enableCallReports,
+          callReportInterval: this._currentConfig.callReportInterval,
+          callReportLogLevel: this._currentConfig.callReportLogLevel,
+          callReportMaxLogEntries: this._currentConfig.callReportMaxLogEntries,
+          sdkVersion: pkg.version,
         };
         console.log(
           '🔧 SessionManager: Creating TelnyxRTC with token config, logLevel:',

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

@@ -92,19 +92,19 @@ export declare class VoicePnBridge {
    */
   static getVoipToken(): Promise<string | null>;
   /**
-   * Get pending VoIP push from native storage
+   * Get pending VoIP push from native storage (iOS only)
    */
   static getPendingVoipPush(): Promise<string | null>;
   /**
-   * Clear pending VoIP push from native storage
+   * Clear pending VoIP push from native storage (iOS only)
    */
   static clearPendingVoipPush(): Promise<boolean>;
   /**
-   * Get pending VoIP action from native storage
+   * Get pending VoIP action from native storage (iOS only)
    */
   static getPendingVoipAction(): Promise<string | null>;
   /**
-   * Clear pending VoIP action from native storage
+   * Clear pending VoIP action from native storage (iOS only)
    */
   static clearPendingVoipAction(): Promise<boolean>;
   /**

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

@@ -128,6 +128,7 @@ class VoicePnBridge {
    * Get VoIP token from native storage
    */
   static async getVoipToken() {
+    if (react_native_1.Platform.OS !== 'ios') return null;
     try {
       return await NativeBridge.getVoipToken();
     } catch (error) {
@@ -136,9 +137,10 @@ class VoicePnBridge {
     }
   }
   /**
-   * Get pending VoIP push from native storage
+   * Get pending VoIP push from native storage (iOS only)
    */
   static async getPendingVoipPush() {
+    if (react_native_1.Platform.OS !== 'ios') return null;
     try {
       return await NativeBridge.getPendingVoipPush();
     } catch (error) {
@@ -147,9 +149,10 @@ class VoicePnBridge {
     }
   }
   /**
-   * Clear pending VoIP push from native storage
+   * Clear pending VoIP push from native storage (iOS only)
    */
   static async clearPendingVoipPush() {
+    if (react_native_1.Platform.OS !== 'ios') return true;
     try {
       return await NativeBridge.clearPendingVoipPush();
     } catch (error) {
@@ -158,9 +161,10 @@ class VoicePnBridge {
     }
   }
   /**
-   * Get pending VoIP action from native storage
+   * Get pending VoIP action from native storage (iOS only)
    */
   static async getPendingVoipAction() {
+    if (react_native_1.Platform.OS !== 'ios') return null;
     try {
       return await NativeBridge.getPendingVoipAction();
     } catch (error) {
@@ -169,9 +173,10 @@ class VoicePnBridge {
     }
   }
   /**
-   * Clear pending VoIP action from native storage
+   * Clear pending VoIP action from native storage (iOS only)
    */
   static async clearPendingVoipAction() {
+    if (react_native_1.Platform.OS !== 'ios') return true;
     try {
       return await NativeBridge.clearPendingVoipAction();
     } catch (error) {

package/lib/models/config.d.ts

@@ -7,6 +7,14 @@ export interface CredentialConfig {
   sipPassword: string;
   debug?: boolean;
   pushNotificationDeviceToken?: string;
+  /** Enable automatic call quality reporting. Default: true */
+  enableCallReports?: 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;
 }
 /**
  * Configuration for token-based authentication
@@ -16,6 +24,14 @@ export interface TokenConfig {
   token: string;
   debug?: boolean;
   pushNotificationDeviceToken?: string;
+  /** Enable automatic call quality reporting. Default: true */
+  enableCallReports?: 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;
 }
 /**
  * Union type for all supported authentication configurations

package/lib/telnyx-voice-app.js

@@ -612,7 +612,7 @@ const handleBackgroundPush = async (message) => {
     // TODO: Initialize push notification service in isolate if needed
     // Use singleton pattern for background client to prevent multiple instances
     let backgroundClient = (0, telnyx_voip_client_1.createBackgroundTelnyxVoipClient)({
-      debug: true,
+      debug: false,
     });
     await backgroundClient.handlePushNotification(message);
     console.log('[TelnyxVoiceApp] Background push processed successfully');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/react-voice-commons-sdk",
-  "version": "0.1.8-beta.1",
+  "version": "0.1.9",
   "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",
@@ -39,7 +39,7 @@
     "android": "expo run:android",
     "ios": "expo run:ios",
     "dev:local": "npm pkg set dependencies.@telnyx/react-native-voice-sdk=file:../package",
-    "dev:published": "npm pkg set dependencies.@telnyx/react-native-voice-sdk=^0.3.0",
+    "dev:published": "npm pkg set dependencies.@telnyx/react-native-voice-sdk=^0.4.0",
     "prepublishOnly": "npm run dev:published && npm install --legacy-peer-deps",
     "postpublish": "npm run dev:local && npm install --legacy-peer-deps"
   },
@@ -90,7 +90,7 @@
   },
   "dependencies": {
     "@react-native-community/eslint-config": "^3.2.0",
-    "@telnyx/react-native-voice-sdk": "^0.3.0",
+    "@telnyx/react-native-voice-sdk": "^0.4.0",
     "eventemitter3": "^5.0.1",
     "expo": "~53.0.22",
     "react-native-voip-push-notification": "^3.3.3",

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

@@ -5,6 +5,7 @@ import { Call } from '../../models/call';
 import { TelnyxCallState } from '../../models/call-state';
 import { SessionManager } from '../session/session-manager';
 import { callKitCoordinator } from '../../callkit/callkit-coordinator';
+import { VoicePnBridge } from '../voice-pn-bridge';
 
 /**
  * Central state machine for call management.
@@ -405,9 +406,14 @@ export class CallStateController {
       // CallKitCoordinator automatically updates CallKit via setupWebRTCCallListeners
       console.log('CallStateController: Call state changed to:', state);
 
-      // Clean up when call ends
+      // Clean up when call ends - delay to next tick so external subscribers
+      // receive the ENDED/FAILED state before the call is disposed
       if (state === TelnyxCallState.ENDED || state === TelnyxCallState.FAILED) {
-        this._removeCall(call.callId);
+        // Clear pending push data so the next app launch isn't mistaken for a push launch
+        VoicePnBridge.clearPendingVoipPush().catch((e) =>
+          console.warn('CallStateController: Failed to clear pending voip push:', e)
+        );
+        setTimeout(() => this._removeCall(call.callId), 0);
       }
     });
   }

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

@@ -1,6 +1,7 @@
 import { BehaviorSubject, Observable } from 'rxjs';
 import { distinctUntilChanged } from 'rxjs/operators';
 import * as TelnyxSDK from '@telnyx/react-native-voice-sdk';
+import * as pkg from '../../../package.json';
 import { TelnyxConnectionState } from '../../models/connection-state';
 import {
   Config,
@@ -302,7 +303,13 @@ export class SessionManager {
           login: this._currentConfig.sipUser,
           password: this._currentConfig.sipPassword,
           logLevel: this._currentConfig.debug ? 'debug' : 'warn',
+          debug: this._currentConfig.debug ?? false,
           pushNotificationDeviceToken: this._currentConfig.pushNotificationDeviceToken,
+          enableCallReports: this._currentConfig.enableCallReports,
+          callReportInterval: this._currentConfig.callReportInterval,
+          callReportLogLevel: this._currentConfig.callReportLogLevel,
+          callReportMaxLogEntries: this._currentConfig.callReportMaxLogEntries,
+          sdkVersion: pkg.version,
         };
         console.log(
           '🔧 SessionManager: Creating TelnyxRTC with credential config, logLevel:',
@@ -314,7 +321,13 @@ export class SessionManager {
         clientOptions = {
           login_token: this._currentConfig.token,
           logLevel: this._currentConfig.debug ? 'debug' : 'warn',
+          debug: this._currentConfig.debug ?? false,
           pushNotificationDeviceToken: this._currentConfig.pushNotificationDeviceToken,
+          enableCallReports: this._currentConfig.enableCallReports,
+          callReportInterval: this._currentConfig.callReportInterval,
+          callReportLogLevel: this._currentConfig.callReportLogLevel,
+          callReportMaxLogEntries: this._currentConfig.callReportMaxLogEntries,
+          sdkVersion: pkg.version,
         };
         console.log(
           '🔧 SessionManager: Creating TelnyxRTC with token config, logLevel:',

package/src/internal/voice-pn-bridge.ts

@@ -1,4 +1,4 @@
-import { NativeModules, DeviceEventEmitter, EmitterSubscription } from 'react-native';
+import { NativeModules, DeviceEventEmitter, EmitterSubscription, Platform } from 'react-native';
 
 export interface CallActionEvent {
   action: string;
@@ -183,6 +183,7 @@ export class VoicePnBridge {
    * Get VoIP token from native storage
    */
   static async getVoipToken(): Promise<string | null> {
+    if (Platform.OS !== 'ios') return null;
     try {
       return await NativeBridge.getVoipToken();
     } catch (error) {
@@ -192,9 +193,10 @@ export class VoicePnBridge {
   }
 
   /**
-   * Get pending VoIP push from native storage
+   * Get pending VoIP push from native storage (iOS only)
    */
   static async getPendingVoipPush(): Promise<string | null> {
+    if (Platform.OS !== 'ios') return null;
     try {
       return await NativeBridge.getPendingVoipPush();
     } catch (error) {
@@ -204,9 +206,10 @@ export class VoicePnBridge {
   }
 
   /**
-   * Clear pending VoIP push from native storage
+   * Clear pending VoIP push from native storage (iOS only)
    */
   static async clearPendingVoipPush(): Promise<boolean> {
+    if (Platform.OS !== 'ios') return true;
     try {
       return await NativeBridge.clearPendingVoipPush();
     } catch (error) {
@@ -216,9 +219,10 @@ export class VoicePnBridge {
   }
 
   /**
-   * Get pending VoIP action from native storage
+   * Get pending VoIP action from native storage (iOS only)
    */
   static async getPendingVoipAction(): Promise<string | null> {
+    if (Platform.OS !== 'ios') return null;
     try {
       return await NativeBridge.getPendingVoipAction();
     } catch (error) {
@@ -228,9 +232,10 @@ export class VoicePnBridge {
   }
 
   /**
-   * Clear pending VoIP action from native storage
+   * Clear pending VoIP action from native storage (iOS only)
    */
   static async clearPendingVoipAction(): Promise<boolean> {
+    if (Platform.OS !== 'ios') return true;
     try {
       return await NativeBridge.clearPendingVoipAction();
     } catch (error) {

package/src/models/config.ts

@@ -7,6 +7,14 @@ export interface CredentialConfig {
   sipPassword: string;
   debug?: boolean;
   pushNotificationDeviceToken?: string;
+  /** Enable automatic call quality reporting. Default: true */
+  enableCallReports?: 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;
 }
 
 /**
@@ -17,6 +25,14 @@ export interface TokenConfig {
   token: string;
   debug?: boolean;
   pushNotificationDeviceToken?: string;
+  /** Enable automatic call quality reporting. Default: true */
+  enableCallReports?: 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;
 }
 
 /**

package/src/telnyx-voice-app.tsx

@@ -437,7 +437,9 @@ const TelnyxVoiceAppComponent: React.FC<TelnyxVoiceAppProps> = ({
           voipClient.currentConnectionState === TelnyxConnectionState.CONNECTED ||
           voipClient.currentConnectionState === TelnyxConnectionState.CONNECTING
         ) {
-          log(`SKIPPING - Already ${voipClient.currentConnectionState}, preventing duplicate processing`);
+          log(
+            `SKIPPING - Already ${voipClient.currentConnectionState}, preventing duplicate processing`
+          );
           return;
         }
 
@@ -773,7 +775,7 @@ const handleBackgroundPush = async (message: any): Promise<void> => {
 
     // Use singleton pattern for background client to prevent multiple instances
     let backgroundClient = createBackgroundTelnyxVoipClient({
-      debug: true,
+      debug: false,
     });
 
     await backgroundClient.handlePushNotification(message);

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

@@ -26,6 +26,11 @@ declare module '@telnyx/react-native-voice-sdk' {
     debug?: boolean;
     logLevel?: string;
     pushNotificationDeviceToken?: string;
+    enableCallReports?: boolean;
+    callReportInterval?: number;
+    callReportLogLevel?: string;
+    callReportMaxLogEntries?: number;
+    sdkVersion?: string;
   }
 
   export enum CallState {