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

package/ios/README.md

@@ -62,7 +62,7 @@ class AppDelegate: ExpoAppDelegate, TelnyxVoiceAppDelegate {
     override func customCallKitConfiguration() -> CXProviderConfiguration {
         let configuration = CXProviderConfiguration(localizedName: "My App Voice")
         configuration.supportsVideo = false
-        configuration.maximumCallGroups = 1
+        configuration.maximumCallGroups = 2
         configuration.maximumCallsPerCallGroup = 1
         configuration.supportedHandleTypes = [.phoneNumber, .generic]
         configuration.includesCallsInRecents = true
@@ -113,7 +113,7 @@ class AppDelegate: ExpoAppDelegate {
     private func setupCallKit() {
         let configuration = CXProviderConfiguration(localizedName: "Voice Call")
         configuration.supportsVideo = false
-        configuration.maximumCallGroups = 1
+        configuration.maximumCallGroups = 2
         configuration.maximumCallsPerCallGroup = 1
         configuration.supportedHandleTypes = [.phoneNumber, .generic]
         configuration.includesCallsInRecents = true

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

@@ -71,6 +71,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.d.ts

@@ -1,5 +1,5 @@
 import { Call } from '@telnyx/react-native-voice-sdk';
-import { TelnyxVoipClient } from '../telnyx-voip-client';
+import type { TelnyxVoipClient } from '../telnyx-voip-client';
 /**
  * CallKit Coordinator - Manages the proper CallKit-first flow for iOS
  *
@@ -14,7 +14,12 @@ declare class CallKitCoordinator {
   private endedCalls;
   private connectedCalls;
   private isCallFromPush;
-  private shouldAutoAnswerNextCall;
+  private pendingPushCallUUIDs;
+  private selectedCallKitUUID;
+  private restoreHeldCallPromise;
+  private pendingSwap;
+  private pendingHeldRequests;
+  private autoAnswerCallUUIDs;
   private voipClient;
   static getInstance(): CallKitCoordinator;
   private constructor();
@@ -36,6 +41,17 @@ declare class CallKitCoordinator {
    * Answer a call from the app UI (CallKit-first approach)
    */
   answerCallFromUI(call: Call): Promise<boolean>;
+  /**
+   * Change held state from app UI through CallKit, then wait for signaling and
+   * the corresponding CXSetHeldCallAction to complete.
+   */
+  setHeldFromUI(call: Call, isOnHold: boolean): Promise<boolean>;
+  /**
+   * Swap an active call with a held call through one CallKit transaction.
+   * The promise settles only after both corresponding WebRTC state changes
+   * have completed and their CallKit actions have been fulfilled.
+   */
+  swapCallsFromUI(activeCall: Call, heldCall: Call): Promise<boolean>;
   /**
    * End a call from the app UI (CallKit-first approach)
    */
@@ -44,6 +60,8 @@ declare class CallKitCoordinator {
    * Handle CallKit answer action (triggered by CallKit)
    */
   handleCallKitAnswer(callKitUUID: string, event?: any): Promise<void>;
+  /** Handle a UUID-targeted CallKit hold or resume action. */
+  handleCallKitHeld(callKitUUID: string, isOnHold: boolean): Promise<void>;
   /**
    * Handle CallKit end action (triggered by CallKit)
    */
@@ -55,8 +73,13 @@ declare class CallKitCoordinator {
   /**
    * Handle CallKit push received event
    * This allows us to coordinate between the push notification and any subsequent WebRTC calls
+   *
+   * Returns `true` when the push was accepted and call processing was started,
+   * or `false` when the push was filtered, rejected, or otherwise ignored so
+   * that callers can clean up any foreground-push lifecycle flags they set
+   * before calling this method.
    */
-  handleCallKitPushReceived(callKitUUID: string, event?: any): Promise<void>;
+  handleCallKitPushReceived(callKitUUID: string, event?: any): Promise<boolean>;
   /**
    * Handle push notification answer - when user answers from CallKit but we don't have a WebRTC call yet
    * This is the iOS equivalent of the Android FCM handler
@@ -99,10 +122,23 @@ declare class CallKitCoordinator {
    * Helper method to clean up push notification state
    */
   private cleanupPushNotificationState;
+  private rejectUnregisteredIncomingCall;
+  private clearMatchingPendingVoipPush;
   /**
    * Get reference to the SDK client (for queuing actions when call doesn't exist yet)
    */
   private getSDKClient;
+  private normalizeUUID;
+  private actionKey;
+  private selectCall;
+  private isSelectedCall;
+  private recordPendingSwapAction;
+  private createPendingSwap;
+  private beginSwapRollback;
+  private restoreOriginalWebRTCStates;
+  private finishPendingSwap;
+  private finishPendingHeldRequest;
+  private restoreRemainingHeldCall;
   /**
    * Check if app is in background and disconnect client if no active calls
    */