@telnyx/react-voice-commons-sdk 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # CHANGELOG.md
 
+## [0.2.1](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/commons-sdk-v0.2.1) (2026-04-02)
+
+### Bug Fixing
+
+- Fixed CallKit auto-answer not working on iOS when user answers from CallKit UI during app cold launch from VoIP push. The native `CXAnswerCallAction` event was silently dropped because JS listeners weren't registered yet. Now persists the answer action in UserDefaults so the JS side can detect and honor it.
+
 ## [0.2.0](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/commons-sdk-v0.2.0) (2026-04-01)
 
 ### Enhancement

package/ios/CallKitBridge.swift

@@ -533,6 +533,12 @@ import React
             NSLog("📞 TelnyxVoice: CALLKIT ANSWER ACTION - Provider: \(provider), Action: \(action)")
             NSLog("TelnyxVoice: User answered call with UUID: \(action.callUUID)")
 
+            // Always persist the answer action in UserDefaults so the JS side can detect it
+            // even when the RCTEventEmitter bridge is not yet ready (app cold-launched from push).
+            UserDefaults.standard.set(action.callUUID.uuidString, forKey: "pending_callkit_answer")
+            UserDefaults.standard.synchronize()
+            NSLog("TelnyxVoice: Stored pending CallKit answer for UUID: \(action.callUUID)")
+
             // Check if this is a programmatic answer (call already answered in WebRTC)
             // vs a user answer from CallKit UI
             if let callData = activeCalls[action.callUUID],
@@ -555,6 +561,10 @@ import React
         public func provider(_ provider: CXProvider, perform action: CXEndCallAction) {
             NSLog("TelnyxVoice: User ended call with UUID: \(action.callUUID)")
 
+            // Clear any pending CallKit answer (prevents stale auto-answer on next call)
+            UserDefaults.standard.removeObject(forKey: "pending_callkit_answer")
+            UserDefaults.standard.synchronize()
+
             // Notify React Native via CallKit bridge
             CallKitBridge.shared?.emitCallEvent(
                 "CallKitDidPerformEndCallAction", callUUID: action.callUUID,

package/ios/VoicePnBridge.m

@@ -22,6 +22,12 @@ RCT_EXTERN_METHOD(getPendingVoipPush:(RCTPromiseResolveBlock)resolve
 RCT_EXTERN_METHOD(clearPendingVoipPush:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(getPendingCallKitAnswer:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearPendingCallKitAnswer:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(getPendingVoipAction:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 

package/ios/VoicePnBridge.swift

@@ -70,6 +70,21 @@ class VoicePnBridge: NSObject {
         resolve(true)
     }
     
+    @objc
+    func getPendingCallKitAnswer(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let answer = UserDefaults.standard.string(forKey: "pending_callkit_answer")
+        NSLog("[VoicePnBridge] getPendingCallKitAnswer - answer: \(answer ?? "nil")")
+        resolve(answer)
+    }
+
+    @objc
+    func clearPendingCallKitAnswer(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.removeObject(forKey: "pending_callkit_answer")
+        UserDefaults.standard.synchronize()
+        NSLog("[VoicePnBridge] clearPendingCallKitAnswer - cleared")
+        resolve(true)
+    }
+
     @objc
     func getPendingVoipAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
         let pending = UserDefaults.standard.string(forKey: "pending_voip_action")

package/lib/callkit/callkit-coordinator.js

@@ -258,6 +258,10 @@ class CallKitCoordinator {
       console.log('CallKitCoordinator: Answer action already being processed, skipping duplicate');
       return;
     }
+    // Clear native-side pending answer since JS received the event normally
+    try {
+      await voice_pn_bridge_1.VoicePnBridge.clearPendingCallKitAnswer();
+    } catch (_) {}
     const call = this.callMap.get(callKitUUID);
     if (!call) {
       console.warn('CallKitCoordinator: No WebRTC call found for CallKit answer action', {
@@ -440,6 +444,21 @@ class CallKitCoordinator {
         ...realPushData.metadata,
         from_callkit: true,
       };
+      // Check if the user answered from CallKit before JS listeners were ready.
+      // The native CXAnswerCallAction handler persists the answer UUID in UserDefaults
+      // so we can detect it here even when the JS event was dropped.
+      try {
+        const pendingAnswer = await voice_pn_bridge_1.VoicePnBridge.getPendingCallKitAnswer();
+        if (pendingAnswer) {
+          console.log(
+            'CallKitCoordinator: Found pending CallKit answer from native (JS event was missed), setting auto-answer flag'
+          );
+          this.shouldAutoAnswerNextCall = true;
+          await voice_pn_bridge_1.VoicePnBridge.clearPendingCallKitAnswer();
+        }
+      } catch (e) {
+        // Ignore - method may not exist on older native versions
+      }
       // Check if auto-answer is set and add from_notification flag
       const shouldAddFromNotification = this.shouldAutoAnswerNextCall;
       let pushData;
@@ -717,6 +736,10 @@ class CallKitCoordinator {
   async cleanupPushNotificationState() {
     console.log('CallKitCoordinator: ✅ Cleared auto-answer flag');
     this.shouldAutoAnswerNextCall = false;
+    // Also clear native-side pending answer to prevent stale auto-answer
+    try {
+      await voice_pn_bridge_1.VoicePnBridge.clearPendingCallKitAnswer();
+    } catch (_) {}
   }
   /**
    * Get reference to the SDK client (for queuing actions when call doesn't exist yet)

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

@@ -25,6 +25,8 @@ export interface VoicePnBridgeInterface {
   ): Promise<boolean>;
   hideOngoingCallNotification(): Promise<boolean>;
   hideIncomingCallNotification(): Promise<boolean>;
+  getPendingCallKitAnswer(): Promise<string | null>;
+  clearPendingCallKitAnswer(): Promise<boolean>;
   getVoipToken(): Promise<string | null>;
   getPendingVoipPush(): Promise<string | null>;
   clearPendingVoipPush(): Promise<boolean>;
@@ -87,6 +89,16 @@ export declare class VoicePnBridge {
    * Useful for dismissing notifications when call is answered/rejected in app
    */
   static hideIncomingCallNotification(): Promise<boolean>;
+  /**
+   * Get pending CallKit answer UUID from native storage (iOS only).
+   * When the user answers a CallKit call before JS listeners are ready,
+   * the native side persists the answer UUID in UserDefaults so JS can detect it.
+   */
+  static getPendingCallKitAnswer(): Promise<string | null>;
+  /**
+   * Clear pending CallKit answer from native storage (iOS only)
+   */
+  static clearPendingCallKitAnswer(): Promise<boolean>;
   /**
    * Get VoIP token from native storage
    */

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

@@ -124,6 +124,32 @@ class VoicePnBridge {
       return false;
     }
   }
+  /**
+   * Get pending CallKit answer UUID from native storage (iOS only).
+   * When the user answers a CallKit call before JS listeners are ready,
+   * the native side persists the answer UUID in UserDefaults so JS can detect it.
+   */
+  static async getPendingCallKitAnswer() {
+    if (react_native_1.Platform.OS !== 'ios') return null;
+    try {
+      return await NativeBridge.getPendingCallKitAnswer();
+    } catch (error) {
+      console.error('VoicePnBridge: Error getting pending CallKit answer:', error);
+      return null;
+    }
+  }
+  /**
+   * Clear pending CallKit answer from native storage (iOS only)
+   */
+  static async clearPendingCallKitAnswer() {
+    if (react_native_1.Platform.OS !== 'ios') return true;
+    try {
+      return await NativeBridge.clearPendingCallKitAnswer();
+    } catch (error) {
+      console.error('VoicePnBridge: Error clearing pending CallKit answer:', error);
+      return false;
+    }
+  }
   /**
    * Get VoIP token from native storage
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telnyx/react-voice-commons-sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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/callkit/callkit-coordinator.ts

@@ -5,7 +5,6 @@ import { VoicePnBridge } from '../internal/voice-pn-bridge';
 import { router } from 'expo-router';
 import { TelnyxVoipClient } from '../telnyx-voip-client';
 import { TelnyxConnectionState } from '../models/connection-state';
-import { act } from 'react';
 
 /**
  * CallKit Coordinator - Manages the proper CallKit-first flow for iOS
@@ -254,6 +253,11 @@ class CallKitCoordinator {
       return;
     }
 
+    // Clear native-side pending answer since JS received the event normally
+    try {
+      await VoicePnBridge.clearPendingCallKitAnswer();
+    } catch (_) {}
+
     const call = this.callMap.get(callKitUUID);
 
     if (!call) {
@@ -469,6 +473,22 @@ class CallKitCoordinator {
         from_callkit: true,
       };
 
+      // Check if the user answered from CallKit before JS listeners were ready.
+      // The native CXAnswerCallAction handler persists the answer UUID in UserDefaults
+      // so we can detect it here even when the JS event was dropped.
+      try {
+        const pendingAnswer = await VoicePnBridge.getPendingCallKitAnswer();
+        if (pendingAnswer) {
+          console.log(
+            'CallKitCoordinator: Found pending CallKit answer from native (JS event was missed), setting auto-answer flag'
+          );
+          this.shouldAutoAnswerNextCall = true;
+          await VoicePnBridge.clearPendingCallKitAnswer();
+        }
+      } catch (e) {
+        // Ignore - method may not exist on older native versions
+      }
+
       // Check if auto-answer is set and add from_notification flag
       const shouldAddFromNotification = this.shouldAutoAnswerNextCall;
 
@@ -789,6 +809,10 @@ class CallKitCoordinator {
   private async cleanupPushNotificationState(): Promise<void> {
     console.log('CallKitCoordinator: ✅ Cleared auto-answer flag');
     this.shouldAutoAnswerNextCall = false;
+    // Also clear native-side pending answer to prevent stale auto-answer
+    try {
+      await VoicePnBridge.clearPendingCallKitAnswer();
+    } catch (_) {}
   }
 
   /**

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

@@ -32,6 +32,10 @@ export interface VoicePnBridgeInterface {
   hideOngoingCallNotification(): Promise<boolean>;
   hideIncomingCallNotification(): Promise<boolean>;
 
+  // CallKit answer persistence (iOS only)
+  getPendingCallKitAnswer(): Promise<string | null>;
+  clearPendingCallKitAnswer(): Promise<boolean>;
+
   // Additional UserDefaults methods
   getVoipToken(): Promise<string | null>;
   getPendingVoipPush(): Promise<string | null>;
@@ -179,6 +183,34 @@ export class VoicePnBridge {
     }
   }
 
+  /**
+   * Get pending CallKit answer UUID from native storage (iOS only).
+   * When the user answers a CallKit call before JS listeners are ready,
+   * the native side persists the answer UUID in UserDefaults so JS can detect it.
+   */
+  static async getPendingCallKitAnswer(): Promise<string | null> {
+    if (Platform.OS !== 'ios') return null;
+    try {
+      return await NativeBridge.getPendingCallKitAnswer();
+    } catch (error) {
+      console.error('VoicePnBridge: Error getting pending CallKit answer:', error);
+      return null;
+    }
+  }
+
+  /**
+   * Clear pending CallKit answer from native storage (iOS only)
+   */
+  static async clearPendingCallKitAnswer(): Promise<boolean> {
+    if (Platform.OS !== 'ios') return true;
+    try {
+      return await NativeBridge.clearPendingCallKitAnswer();
+    } catch (error) {
+      console.error('VoicePnBridge: Error clearing pending CallKit answer:', error);
+      return false;
+    }
+  }
+
   /**
    * Get VoIP token from native storage
    */