@telnyx/react-voice-commons-sdk 0.1.0 → 0.1.2

package/ios/VoicePnBridge.m

@@ -1,31 +1,31 @@
-#import <React/RCTBridgeModule.h>
-
-@interface RCT_EXTERN_MODULE(VoicePnBridge, NSObject)
-
-RCT_EXTERN_METHOD(getPendingPushAction:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(setPendingPushAction:(NSString *)action
-                  metadata:(NSString *)metadata
-                  resolver:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(clearPendingPushAction:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(getVoipToken:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(getPendingVoipPush:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(clearPendingVoipPush:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(getPendingVoipAction:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(clearPendingVoipAction:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(VoicePnBridge, NSObject)
+
+RCT_EXTERN_METHOD(getPendingPushAction:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setPendingPushAction:(NSString *)action
+                  metadata:(NSString *)metadata
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearPendingPushAction:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getVoipToken:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getPendingVoipPush:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearPendingVoipPush:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getPendingVoipAction:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(clearPendingVoipAction:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 @end

package/ios/VoicePnBridge.swift

@@ -1,87 +1,87 @@
-import Foundation
-import React
-
-@objc(VoicePnBridge)
-class VoicePnBridge: NSObject {
-    
-    @objc
-    static func requiresMainQueueSetup() -> Bool {
-        return false
-    }
-    
-    // MARK: - UserDefaults-based methods for VoIP push handling
-    
-    @objc
-    func getPendingPushAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        let action = UserDefaults.standard.string(forKey: "pending_push_action")
-        let metadata = UserDefaults.standard.string(forKey: "pending_push_metadata")
-        
-        NSLog("[VoicePnBridge] getPendingPushAction - action: \(action ?? "nil"), metadata: \(metadata ?? "nil")")
-        
-        let result: [String: Any?] = [
-            "action": action,
-            "metadata": metadata
-        ]
-        
-        resolve(result)
-    }
-    
-    @objc
-    func setPendingPushAction(_ action: String, metadata: String, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        UserDefaults.standard.set(action, forKey: "pending_push_action")
-        UserDefaults.standard.set(metadata, forKey: "pending_push_metadata")
-        UserDefaults.standard.synchronize()
-        
-        NSLog("[VoicePnBridge] setPendingPushAction - action: \(action), metadata: \(metadata)")
-        resolve(true)
-    }
-    
-    @objc
-    func clearPendingPushAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        UserDefaults.standard.removeObject(forKey: "pending_push_action")
-        UserDefaults.standard.removeObject(forKey: "pending_push_metadata")
-        UserDefaults.standard.synchronize()
-        
-        NSLog("[VoicePnBridge] clearPendingPushAction - cleared pending push data")
-        resolve(true)
-    }
-    
-    // MARK: - Additional UserDefaults methods from UserDefaultsModule
-    
-    @objc
-    func getVoipToken(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        let token = UserDefaults.standard.string(forKey: "voip_push_token")
-        NSLog("[VoicePnBridge] getVoipToken called. token=\(token ?? "(nil)")")
-        resolve(token)
-    }
-    
-    @objc
-    func getPendingVoipPush(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        let pending = UserDefaults.standard.string(forKey: "pending_voip_push")
-        NSLog("[VoicePnBridge] getPendingVoipPush called. pending=\(pending ?? "(nil)")")
-        resolve(pending)
-    }
-    
-    @objc
-    func clearPendingVoipPush(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        UserDefaults.standard.removeObject(forKey: "pending_voip_push")
-        UserDefaults.standard.synchronize()
-        NSLog("[VoicePnBridge] clearPendingVoipPush called. Cleared key pending_voip_push")
-        resolve(true)
-    }
-    
-    @objc
-    func getPendingVoipAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        let pending = UserDefaults.standard.string(forKey: "pending_voip_action")
-        NSLog("[VoicePnBridge] getPendingVoipAction called. pending=\(pending ?? "(nil)")")
-        resolve(pending)
-    }
-    
-    @objc
-    func clearPendingVoipAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-        UserDefaults.standard.removeObject(forKey: "pending_voip_action")
-        UserDefaults.standard.synchronize()
-        NSLog("[VoicePnBridge] clearPendingVoipAction called. Cleared key pending_voip_action")
-        resolve(true)
-    }
+import Foundation
+import React
+
+@objc(VoicePnBridge)
+class VoicePnBridge: NSObject {
+    
+    @objc
+    static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+    
+    // MARK: - UserDefaults-based methods for VoIP push handling
+    
+    @objc
+    func getPendingPushAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let action = UserDefaults.standard.string(forKey: "pending_push_action")
+        let metadata = UserDefaults.standard.string(forKey: "pending_push_metadata")
+        
+        NSLog("[VoicePnBridge] getPendingPushAction - action: \(action ?? "nil"), metadata: \(metadata ?? "nil")")
+        
+        let result: [String: Any?] = [
+            "action": action,
+            "metadata": metadata
+        ]
+        
+        resolve(result)
+    }
+    
+    @objc
+    func setPendingPushAction(_ action: String, metadata: String, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.set(action, forKey: "pending_push_action")
+        UserDefaults.standard.set(metadata, forKey: "pending_push_metadata")
+        UserDefaults.standard.synchronize()
+        
+        NSLog("[VoicePnBridge] setPendingPushAction - action: \(action), metadata: \(metadata)")
+        resolve(true)
+    }
+    
+    @objc
+    func clearPendingPushAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.removeObject(forKey: "pending_push_action")
+        UserDefaults.standard.removeObject(forKey: "pending_push_metadata")
+        UserDefaults.standard.synchronize()
+        
+        NSLog("[VoicePnBridge] clearPendingPushAction - cleared pending push data")
+        resolve(true)
+    }
+    
+    // MARK: - Additional UserDefaults methods from UserDefaultsModule
+    
+    @objc
+    func getVoipToken(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let token = UserDefaults.standard.string(forKey: "voip_push_token")
+        NSLog("[VoicePnBridge] getVoipToken called. token=\(token ?? "(nil)")")
+        resolve(token)
+    }
+    
+    @objc
+    func getPendingVoipPush(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let pending = UserDefaults.standard.string(forKey: "pending_voip_push")
+        NSLog("[VoicePnBridge] getPendingVoipPush called. pending=\(pending ?? "(nil)")")
+        resolve(pending)
+    }
+    
+    @objc
+    func clearPendingVoipPush(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.removeObject(forKey: "pending_voip_push")
+        UserDefaults.standard.synchronize()
+        NSLog("[VoicePnBridge] clearPendingVoipPush called. Cleared key pending_voip_push")
+        resolve(true)
+    }
+    
+    @objc
+    func getPendingVoipAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        let pending = UserDefaults.standard.string(forKey: "pending_voip_action")
+        NSLog("[VoicePnBridge] getPendingVoipAction called. pending=\(pending ?? "(nil)")")
+        resolve(pending)
+    }
+    
+    @objc
+    func clearPendingVoipAction(_ resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+        UserDefaults.standard.removeObject(forKey: "pending_voip_action")
+        UserDefaults.standard.synchronize()
+        NSLog("[VoicePnBridge] clearPendingVoipAction called. Cleared key pending_voip_action")
+        resolve(true)
+    }
 }

package/lib/callkit/callkit-coordinator.d.ts

@@ -8,119 +8,123 @@ import { TelnyxVoipClient } from '../telnyx-voip-client';
  * guidelines for proper CallKit integration.
  */
 declare class CallKitCoordinator {
-    private static instance;
-    private callMap;
-    private processingCalls;
-    private endedCalls;
-    private connectedCalls;
-    private isCallFromPush;
-    private voipClient;
-    static getInstance(): CallKitCoordinator;
-    private constructor();
-    private setupCallKitListeners;
-    /**
-     * Report an incoming call to CallKit (from push notification or socket)
-     * For push notifications, the call is already reported - we just need to map it
-     */
-    reportIncomingCall(call: Call, callerName: string, callerNumber: string): Promise<string | null>;
-    /**
-     * Start an outgoing call through CallKit
-     */
-    startOutgoingCall(call: Call, destinationNumber: string, displayName?: string): Promise<string | null>;
-    /**
-     * Answer a call from the app UI (CallKit-first approach)
-     */
-    answerCallFromUI(call: Call): Promise<boolean>;
-    /**
-     * End a call from the app UI (CallKit-first approach)
-     */
-    endCallFromUI(call: Call): Promise<boolean>;
-    /**
-     * Handle CallKit answer action (triggered by CallKit)
-     */
-    handleCallKitAnswer(callKitUUID: string, event?: any): Promise<void>;
-    /**
-     * Handle CallKit end action (triggered by CallKit)
-     */
-    private handleCallKitEnd;
-    /**
-     * Handle CallKit start action (triggered by CallKit for outgoing calls)
-     */
-    private handleCallKitStart;
-    /**
-     * Handle CallKit push received event - when a VoIP push notification has been processed
-     * This allows us to coordinate between the push notification and any subsequent WebRTC calls
-     */
-    handleCallKitPushReceived(callKitUUID: string, event?: any): Promise<void>;
-    /**
-     * 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
-     */
-    private handlePushNotificationAnswer;
-    /**
-     * Handle push notification reject - when user rejects from CallKit but we don't have a WebRTC call yet
-     * This is the iOS equivalent of the Android FCM handler reject
-     */
-    private handlePushNotificationReject;
-    /**
-     * Set up listeners for WebRTC call state changes
-     */
-    private setupWebRTCCallListeners;
-    /**
-     * Clean up call mappings and listeners
-     */
-    private cleanupCall;
-    /**
-     * Get CallKit UUID for a WebRTC call
-     */
-    getCallKitUUID(call: Call): string | null;
-    /**
-     * Get WebRTC call for a CallKit UUID
-     */
-    getWebRTCCall(callKitUUID: string): Call | null;
-    /**
-     * Link an existing CallKit call (from push notification) with a WebRTC call
-     * This should be called when a WebRTC call arrives that corresponds to an existing CallKit call
-     */
-    linkExistingCallKitCall(call: Call, callKitUUID: string): void;
-    /**
-     * Set the VoIP client reference for triggering reconnection
-     */
-    setVoipClient(voipClient: TelnyxVoipClient): void;
-    /**
-     * Helper method to handle auto-answer logic for push notification calls
-     */
-    private handleAutoAnswer;
-    /**
-     * Helper method to clean up push notification state
-     */
-    private cleanupPushNotificationState;
-    /**
-     * Get reference to the SDK client (for queuing actions when call doesn't exist yet)
-     */
-    private getSDKClient;
-    /**
-     * Check if app is in background and disconnect client if no active calls
-     */
-    private checkBackgroundDisconnection;
-    /**
-     * Reset only flags (keeping active call mappings intact)
-     */
-    resetFlags(): void;
-    /**
-     * Check if there are any calls currently being processed by CallKit
-     * This helps prevent premature flag resets during CallKit operations
-     */
-    hasProcessingCalls(): boolean;
-    /**
-     * Check if there's currently a call from push notification being processed
-     * This helps prevent disconnection during push call handling
-     */
-    getIsCallFromPush(): boolean;
-    /**
-     * Check if CallKit is available and coordinator is active
-     */
-    isAvailable(): boolean;
+  private static instance;
+  private callMap;
+  private processingCalls;
+  private endedCalls;
+  private connectedCalls;
+  private isCallFromPush;
+  private voipClient;
+  static getInstance(): CallKitCoordinator;
+  private constructor();
+  private setupCallKitListeners;
+  /**
+   * Report an incoming call to CallKit (from push notification or socket)
+   * For push notifications, the call is already reported - we just need to map it
+   */
+  reportIncomingCall(call: Call, callerName: string, callerNumber: string): Promise<string | null>;
+  /**
+   * Start an outgoing call through CallKit
+   */
+  startOutgoingCall(
+    call: Call,
+    destinationNumber: string,
+    displayName?: string
+  ): Promise<string | null>;
+  /**
+   * Answer a call from the app UI (CallKit-first approach)
+   */
+  answerCallFromUI(call: Call): Promise<boolean>;
+  /**
+   * End a call from the app UI (CallKit-first approach)
+   */
+  endCallFromUI(call: Call): Promise<boolean>;
+  /**
+   * Handle CallKit answer action (triggered by CallKit)
+   */
+  handleCallKitAnswer(callKitUUID: string, event?: any): Promise<void>;
+  /**
+   * Handle CallKit end action (triggered by CallKit)
+   */
+  private handleCallKitEnd;
+  /**
+   * Handle CallKit start action (triggered by CallKit for outgoing calls)
+   */
+  private handleCallKitStart;
+  /**
+   * Handle CallKit push received event - when a VoIP push notification has been processed
+   * This allows us to coordinate between the push notification and any subsequent WebRTC calls
+   */
+  handleCallKitPushReceived(callKitUUID: string, event?: any): Promise<void>;
+  /**
+   * 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
+   */
+  private handlePushNotificationAnswer;
+  /**
+   * Handle push notification reject - when user rejects from CallKit but we don't have a WebRTC call yet
+   * This is the iOS equivalent of the Android FCM handler reject
+   */
+  private handlePushNotificationReject;
+  /**
+   * Set up listeners for WebRTC call state changes
+   */
+  private setupWebRTCCallListeners;
+  /**
+   * Clean up call mappings and listeners
+   */
+  private cleanupCall;
+  /**
+   * Get CallKit UUID for a WebRTC call
+   */
+  getCallKitUUID(call: Call): string | null;
+  /**
+   * Get WebRTC call for a CallKit UUID
+   */
+  getWebRTCCall(callKitUUID: string): Call | null;
+  /**
+   * Link an existing CallKit call (from push notification) with a WebRTC call
+   * This should be called when a WebRTC call arrives that corresponds to an existing CallKit call
+   */
+  linkExistingCallKitCall(call: Call, callKitUUID: string): void;
+  /**
+   * Set the VoIP client reference for triggering reconnection
+   */
+  setVoipClient(voipClient: TelnyxVoipClient): void;
+  /**
+   * Helper method to handle auto-answer logic for push notification calls
+   */
+  private handleAutoAnswer;
+  /**
+   * Helper method to clean up push notification state
+   */
+  private cleanupPushNotificationState;
+  /**
+   * Get reference to the SDK client (for queuing actions when call doesn't exist yet)
+   */
+  private getSDKClient;
+  /**
+   * Check if app is in background and disconnect client if no active calls
+   */
+  private checkBackgroundDisconnection;
+  /**
+   * Reset only flags (keeping active call mappings intact)
+   */
+  resetFlags(): void;
+  /**
+   * Check if there are any calls currently being processed by CallKit
+   * This helps prevent premature flag resets during CallKit operations
+   */
+  hasProcessingCalls(): boolean;
+  /**
+   * Check if there's currently a call from push notification being processed
+   * This helps prevent disconnection during push call handling
+   */
+  getIsCallFromPush(): boolean;
+  /**
+   * Check if CallKit is available and coordinator is active
+   */
+  isAvailable(): boolean;
 }
 export declare const callKitCoordinator: CallKitCoordinator;
 export default callKitCoordinator;