@telnyx/react-voice-commons-sdk 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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

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.
  *
@@ -349,6 +350,10 @@ class CallStateController {
         state === call_state_1.TelnyxCallState.ENDED ||
         state === call_state_1.TelnyxCallState.FAILED
       ) {
+        // 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/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",
+  "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.
@@ -408,6 +409,10 @@ export class CallStateController {
       // 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) {
+        // 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/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

@@ -775,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 {