@telnyx/react-voice-commons-sdk 0.4.3 → 1.1.0

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,10 +22,30 @@ 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)
 
 RCT_EXTERN_METHOD(clearPendingVoipAction:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
-@end
+RCT_EXTERN_METHOD(setMissedCallNotificationsEnabled:(BOOL)enabled
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getMissedCallNotificationsEnabled:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setSpeakerEnabled:(BOOL)enabled
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(isSpeakerEnabled:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/VoicePnBridge.swift

@@ -1,5 +1,6 @@
 import Foundation
 import React
+import AVFoundation
 
 @objc(VoicePnBridge)
 class VoicePnBridge: NSObject {
@@ -70,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")
@@ -84,4 +100,49 @@ class VoicePnBridge: NSObject {
         NSLog("[VoicePnBridge] clearPendingVoipAction called. Cleared key pending_voip_action")
         resolve(true)
     }
-}
+
+    @objc
+    func setMissedCallNotificationsEnabled(_ enabled: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.set(enabled, forKey: TelnyxVoiceUserDefaultsKey.missedCallNotificationsEnabled)
+        UserDefaults.standard.synchronize()
+        NSLog("[VoicePnBridge] setMissedCallNotificationsEnabled called. enabled=\(enabled)")
+        resolve(true)
+    }
+
+    @objc
+    func getMissedCallNotificationsEnabled(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        if UserDefaults.standard.object(forKey: TelnyxVoiceUserDefaultsKey.missedCallNotificationsEnabled) == nil {
+            resolve(true)
+            return
+        }
+
+        resolve(UserDefaults.standard.bool(forKey: TelnyxVoiceUserDefaultsKey.missedCallNotificationsEnabled))
+    }
+
+    @objc
+    func setSpeakerEnabled(_ enabled: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        do {
+            let audioSession = AVAudioSession.sharedInstance()
+            // The Telnyx/WebRTC call setup is expected to configure a .playAndRecord-compatible
+            // session. Passing .none clears only the speaker override; accessories/session options
+            // can still decide the resulting output route.
+            try audioSession.overrideOutputAudioPort(enabled ? .speaker : .none)
+            let actualEnabled = audioSession.currentRoute.outputs.contains { output in
+                output.portType == .builtInSpeaker
+            }
+            NSLog("[VoicePnBridge] setSpeakerEnabled called. requested=\(enabled), actual=\(actualEnabled)")
+            resolve(actualEnabled)
+        } catch {
+            NSLog("[VoicePnBridge] setSpeakerEnabled failed. enabled=\(enabled), error=\(error)")
+            reject("SET_SPEAKER_ENABLED_ERROR", error.localizedDescription, error)
+        }
+    }
+
+    @objc
+    func isSpeakerEnabled(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let isEnabled = AVAudioSession.sharedInstance().currentRoute.outputs.contains { output in
+            output.portType == .builtInSpeaker
+        }
+        resolve(isEnabled)
+    }
+}

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
    */