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

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

@@ -1,13 +1,21 @@
 import { Call } from '@telnyx/react-native-voice-sdk';
 import { TelnyxVoipClient } from '../telnyx-voip-client';
 export declare function useCallKitCoordinator(): {
-    reportIncomingCall: (call: Call, callerName: string, callerNumber: string) => Promise<string | null>;
-    startOutgoingCall: (call: Call, destinationNumber: string, displayName?: string) => Promise<string | null>;
-    answerCallFromUI: (call: Call) => Promise<boolean>;
-    endCallFromUI: (call: Call) => Promise<boolean>;
-    getCallKitUUID: (call: Call) => string | null;
-    getWebRTCCall: (callKitUUID: string) => Call | null;
-    linkExistingCallKitCall: (call: Call, callKitUUID: string) => void;
-    isAvailable: () => boolean;
-    setVoipClient: (voipClient: TelnyxVoipClient) => void;
+  reportIncomingCall: (
+    call: Call,
+    callerName: string,
+    callerNumber: string
+  ) => Promise<string | null>;
+  startOutgoingCall: (
+    call: Call,
+    destinationNumber: string,
+    displayName?: string
+  ) => Promise<string | null>;
+  answerCallFromUI: (call: Call) => Promise<boolean>;
+  endCallFromUI: (call: Call) => Promise<boolean>;
+  getCallKitUUID: (call: Call) => string | null;
+  getWebRTCCall: (callKitUUID: string) => Call | null;
+  linkExistingCallKitCall: (call: Call, callKitUUID: string) => void;
+  isAvailable: () => boolean;
+  setVoipClient: (voipClient: TelnyxVoipClient) => void;
 };

package/lib/hooks/use-callkit-coordinator.js

@@ -1,48 +1,53 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.useCallKitCoordinator = useCallKitCoordinator;
-const react_1 = require("react");
-const callkit_coordinator_1 = __importDefault(require("../callkit/callkit-coordinator"));
+const react_1 = require('react');
+const callkit_coordinator_1 = __importDefault(require('../callkit/callkit-coordinator'));
 function useCallKitCoordinator() {
-    const reportIncomingCall = (0, react_1.useCallback)(async (call, callerName, callerNumber) => {
-        return callkit_coordinator_1.default.reportIncomingCall(call, callerName, callerNumber);
-    }, []);
-    const startOutgoingCall = (0, react_1.useCallback)(async (call, destinationNumber, displayName) => {
-        return callkit_coordinator_1.default.startOutgoingCall(call, destinationNumber, displayName);
-    }, []);
-    const answerCallFromUI = (0, react_1.useCallback)(async (call) => {
-        return callkit_coordinator_1.default.answerCallFromUI(call);
-    }, []);
-    const endCallFromUI = (0, react_1.useCallback)(async (call) => {
-        return callkit_coordinator_1.default.endCallFromUI(call);
-    }, []);
-    const getCallKitUUID = (0, react_1.useCallback)((call) => {
-        return callkit_coordinator_1.default.getCallKitUUID(call);
-    }, []);
-    const getWebRTCCall = (0, react_1.useCallback)((callKitUUID) => {
-        return callkit_coordinator_1.default.getWebRTCCall(callKitUUID);
-    }, []);
-    const linkExistingCallKitCall = (0, react_1.useCallback)((call, callKitUUID) => {
-        callkit_coordinator_1.default.linkExistingCallKitCall(call, callKitUUID);
-    }, []);
-    const isAvailable = (0, react_1.useCallback)(() => {
-        return callkit_coordinator_1.default.isAvailable();
-    }, []);
-    const setVoipClient = (0, react_1.useCallback)((voipClient) => {
-        callkit_coordinator_1.default.setVoipClient(voipClient);
-    }, []);
-    return {
-        reportIncomingCall,
-        startOutgoingCall,
-        answerCallFromUI,
-        endCallFromUI,
-        getCallKitUUID,
-        getWebRTCCall,
-        linkExistingCallKitCall,
-        isAvailable,
-        setVoipClient,
-    };
+  const reportIncomingCall = (0, react_1.useCallback)(async (call, callerName, callerNumber) => {
+    return callkit_coordinator_1.default.reportIncomingCall(call, callerName, callerNumber);
+  }, []);
+  const startOutgoingCall = (0, react_1.useCallback)(
+    async (call, destinationNumber, displayName) => {
+      return callkit_coordinator_1.default.startOutgoingCall(call, destinationNumber, displayName);
+    },
+    []
+  );
+  const answerCallFromUI = (0, react_1.useCallback)(async (call) => {
+    return callkit_coordinator_1.default.answerCallFromUI(call);
+  }, []);
+  const endCallFromUI = (0, react_1.useCallback)(async (call) => {
+    return callkit_coordinator_1.default.endCallFromUI(call);
+  }, []);
+  const getCallKitUUID = (0, react_1.useCallback)((call) => {
+    return callkit_coordinator_1.default.getCallKitUUID(call);
+  }, []);
+  const getWebRTCCall = (0, react_1.useCallback)((callKitUUID) => {
+    return callkit_coordinator_1.default.getWebRTCCall(callKitUUID);
+  }, []);
+  const linkExistingCallKitCall = (0, react_1.useCallback)((call, callKitUUID) => {
+    callkit_coordinator_1.default.linkExistingCallKitCall(call, callKitUUID);
+  }, []);
+  const isAvailable = (0, react_1.useCallback)(() => {
+    return callkit_coordinator_1.default.isAvailable();
+  }, []);
+  const setVoipClient = (0, react_1.useCallback)((voipClient) => {
+    callkit_coordinator_1.default.setVoipClient(voipClient);
+  }, []);
+  return {
+    reportIncomingCall,
+    startOutgoingCall,
+    answerCallFromUI,
+    endCallFromUI,
+    getCallKitUUID,
+    getWebRTCCall,
+    linkExistingCallKitCall,
+    isAvailable,
+    setVoipClient,
+  };
 }

package/lib/hooks/useAppReadyNotifier.js

@@ -1,8 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.useAppReadyNotifier = void 0;
-const react_1 = require("react");
-const react_native_1 = require("react-native");
+const react_1 = require('react');
+const react_native_1 = require('react-native');
 /**
  * Hook to notify the native side when React Native is ready
  * Call this hook when your main screen/login screen is visible and ready
@@ -12,14 +12,16 @@ const react_native_1 = require("react-native");
  * handled automatically by the native Android services, so this hook is simplified.
  */
 const useAppReadyNotifier = () => {
-    (0, react_1.useEffect)(() => {
-        // Only notify on Android since this is Android-specific functionality
-        if (react_native_1.Platform.OS === 'android') {
-            console.log('useAppReadyNotifier: React Native is ready (native services handle FCM automatically)');
-            // Note: The VoicePnManager in the native Android code automatically handles
-            // push notification state when the Firebase messaging service receives notifications.
-            // No JavaScript module communication is needed anymore.
-        }
-    }, []);
+  (0, react_1.useEffect)(() => {
+    // Only notify on Android since this is Android-specific functionality
+    if (react_native_1.Platform.OS === 'android') {
+      console.log(
+        'useAppReadyNotifier: React Native is ready (native services handle FCM automatically)'
+      );
+      // Note: The VoicePnManager in the native Android code automatically handles
+      // push notification state when the Firebase messaging service receives notifications.
+      // No JavaScript module communication is needed anymore.
+    }
+  }, []);
 };
 exports.useAppReadyNotifier = useAppReadyNotifier;

package/lib/hooks/useAppStateHandler.d.ts

@@ -1,16 +1,21 @@
 import { AppStateStatus } from 'react-native';
 import { TelnyxVoipClient } from '../telnyx-voip-client';
 interface UseAppStateHandlerOptions {
-    voipClient: TelnyxVoipClient;
-    disconnectOnBackground?: boolean;
-    navigateToLoginOnDisconnect?: boolean;
-    debug?: boolean;
+  voipClient: TelnyxVoipClient;
+  disconnectOnBackground?: boolean;
+  navigateToLoginOnDisconnect?: boolean;
+  debug?: boolean;
 }
 /**
  * Hook to handle app state changes for VoIP behavior
  * When app goes to background without an active call, disconnect socket and redirect to login
  */
-export declare const useAppStateHandler: ({ voipClient, disconnectOnBackground, navigateToLoginOnDisconnect, debug, }: UseAppStateHandlerOptions) => {
-    currentAppState: AppStateStatus;
+export declare const useAppStateHandler: ({
+  voipClient,
+  disconnectOnBackground,
+  navigateToLoginOnDisconnect,
+  debug,
+}: UseAppStateHandlerOptions) => {
+  currentAppState: AppStateStatus;
 };
 export {};

package/lib/hooks/useAppStateHandler.js

@@ -1,105 +1,120 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
 exports.useAppStateHandler = void 0;
-const react_1 = require("react");
-const react_native_1 = require("react-native");
-const expo_router_1 = require("expo-router");
-const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
-const connection_state_1 = require("../models/connection-state");
-const call_state_1 = require("../models/call-state");
+const react_1 = require('react');
+const react_native_1 = require('react-native');
+const expo_router_1 = require('expo-router');
+const async_storage_1 = __importDefault(require('@react-native-async-storage/async-storage'));
+const connection_state_1 = require('../models/connection-state');
+const call_state_1 = require('../models/call-state');
 /**
  * Hook to handle app state changes for VoIP behavior
  * When app goes to background without an active call, disconnect socket and redirect to login
  */
-const useAppStateHandler = ({ voipClient, disconnectOnBackground = true, navigateToLoginOnDisconnect = true, debug = false, }) => {
-    const appState = (0, react_1.useRef)(react_native_1.AppState.currentState);
-    const log = debug ? console.log : () => { };
-    (0, react_1.useEffect)(() => {
-        const handleAppStateChange = async (nextAppState) => {
-            log('AppStateHandler: App state changed from', appState.current, 'to', nextAppState);
-            // When app goes to background
-            if (appState.current.match(/active/) && nextAppState === 'background') {
-                log('AppStateHandler: App went to background, checking for active calls...');
-                const connectionState = voipClient.currentConnectionState;
-                if (connectionState !== connection_state_1.TelnyxConnectionState.CONNECTED) {
-                    log('AppStateHandler: Not connected, skipping background handling');
-                    appState.current = nextAppState;
-                    return;
-                }
-                // Check if there's an active call (including ringing calls)
-                const activeCalls = voipClient.currentCalls;
-                const hasActiveCall = activeCalls.length > 0 &&
-                    activeCalls.some((call) => call_state_1.CallStateHelpers.isActive(call.currentState) ||
-                        call.currentState === call_state_1.TelnyxCallState.RINGING);
-                log('AppStateHandler: Active call check:', {
-                    callCount: activeCalls.length,
-                    hasActiveCall,
-                    callStates: activeCalls.map((call) => ({
-                        callId: call.callId,
-                        currentState: call.currentState,
-                        destination: call.destination,
-                        isIncoming: call.isIncoming,
-                    })),
-                });
-                if (!hasActiveCall && disconnectOnBackground) {
-                    // Check if there's a push notification call in progress
-                    const isPushNotificationInProgress = await async_storage_1.default.getItem('@push_notification_payload');
-                    if (isPushNotificationInProgress) {
-                        log('AppStateHandler: Push notification call in progress, keeping socket connected');
-                        // Wait a bit longer before allowing disconnection to give time for WebRTC call to establish
-                        setTimeout(async () => {
-                            const stillInProgress = await async_storage_1.default.getItem('@push_notification_payload');
-                            if (!stillInProgress) {
-                                log('AppStateHandler: Push notification call completed, now disconnecting socket');
-                                await voipClient.logout();
-                                if (navigateToLoginOnDisconnect) {
-                                    expo_router_1.router.replace('/');
-                                }
-                            }
-                        }, 5000); // Wait 5 seconds
-                        appState.current = nextAppState;
-                        return;
-                    }
-                    log('AppStateHandler: No active call detected, disconnecting socket...');
-                    try {
-                        // Disconnect the socket with background reason
-                        await voipClient.logout();
-                        log('AppStateHandler: Socket disconnected successfully');
-                        // Navigate to login screen
-                        if (navigateToLoginOnDisconnect) {
-                            // Use a small delay to ensure the disconnect completes
-                            setTimeout(() => {
-                                log('AppStateHandler: Navigating to login screen');
-                                expo_router_1.router.replace('/');
-                            }, 100);
-                        }
-                    }
-                    catch (error) {
-                        console.error('AppStateHandler: Error during background disconnect:', error);
-                    }
+const useAppStateHandler = ({
+  voipClient,
+  disconnectOnBackground = true,
+  navigateToLoginOnDisconnect = true,
+  debug = false,
+}) => {
+  const appState = (0, react_1.useRef)(react_native_1.AppState.currentState);
+  const log = debug ? console.log : () => {};
+  (0, react_1.useEffect)(() => {
+    const handleAppStateChange = async (nextAppState) => {
+      log('AppStateHandler: App state changed from', appState.current, 'to', nextAppState);
+      // When app goes to background
+      if (appState.current.match(/active/) && nextAppState === 'background') {
+        log('AppStateHandler: App went to background, checking for active calls...');
+        const connectionState = voipClient.currentConnectionState;
+        if (connectionState !== connection_state_1.TelnyxConnectionState.CONNECTED) {
+          log('AppStateHandler: Not connected, skipping background handling');
+          appState.current = nextAppState;
+          return;
+        }
+        // Check if there's an active call (including ringing calls)
+        const activeCalls = voipClient.currentCalls;
+        const hasActiveCall =
+          activeCalls.length > 0 &&
+          activeCalls.some(
+            (call) =>
+              call_state_1.CallStateHelpers.isActive(call.currentState) ||
+              call.currentState === call_state_1.TelnyxCallState.RINGING
+          );
+        log('AppStateHandler: Active call check:', {
+          callCount: activeCalls.length,
+          hasActiveCall,
+          callStates: activeCalls.map((call) => ({
+            callId: call.callId,
+            currentState: call.currentState,
+            destination: call.destination,
+            isIncoming: call.isIncoming,
+          })),
+        });
+        if (!hasActiveCall && disconnectOnBackground) {
+          // Check if there's a push notification call in progress
+          const isPushNotificationInProgress = await async_storage_1.default.getItem(
+            '@push_notification_payload'
+          );
+          if (isPushNotificationInProgress) {
+            log('AppStateHandler: Push notification call in progress, keeping socket connected');
+            // Wait a bit longer before allowing disconnection to give time for WebRTC call to establish
+            setTimeout(async () => {
+              const stillInProgress = await async_storage_1.default.getItem(
+                '@push_notification_payload'
+              );
+              if (!stillInProgress) {
+                log('AppStateHandler: Push notification call completed, now disconnecting socket');
+                await voipClient.logout();
+                if (navigateToLoginOnDisconnect) {
+                  expo_router_1.router.replace('/');
                 }
-                else {
-                    log('AppStateHandler: Active call detected or disconnect disabled, keeping socket connected');
-                }
-            }
-            // When app comes to foreground
-            if (appState.current.match(/background/) && nextAppState === 'active') {
-                log('AppStateHandler: App came to foreground');
-                // User will need to manually login again when returning from background
-                // Auto-login only happens for push notification calls
-            }
+              }
+            }, 5000); // Wait 5 seconds
             appState.current = nextAppState;
-        };
-        const subscription = react_native_1.AppState.addEventListener('change', handleAppStateChange);
-        return () => {
-            subscription?.remove();
-        };
-    }, [voipClient, disconnectOnBackground, navigateToLoginOnDisconnect, log]);
-    return {
-        currentAppState: appState.current,
+            return;
+          }
+          log('AppStateHandler: No active call detected, disconnecting socket...');
+          try {
+            // Disconnect the socket with background reason
+            await voipClient.logout();
+            log('AppStateHandler: Socket disconnected successfully');
+            // Navigate to login screen
+            if (navigateToLoginOnDisconnect) {
+              // Use a small delay to ensure the disconnect completes
+              setTimeout(() => {
+                log('AppStateHandler: Navigating to login screen');
+                expo_router_1.router.replace('/');
+              }, 100);
+            }
+          } catch (error) {
+            console.error('AppStateHandler: Error during background disconnect:', error);
+          }
+        } else {
+          log(
+            'AppStateHandler: Active call detected or disconnect disabled, keeping socket connected'
+          );
+        }
+      }
+      // When app comes to foreground
+      if (appState.current.match(/background/) && nextAppState === 'active') {
+        log('AppStateHandler: App came to foreground');
+        // User will need to manually login again when returning from background
+        // Auto-login only happens for push notification calls
+      }
+      appState.current = nextAppState;
+    };
+    const subscription = react_native_1.AppState.addEventListener('change', handleAppStateChange);
+    return () => {
+      subscription?.remove();
     };
+  }, [voipClient, disconnectOnBackground, navigateToLoginOnDisconnect, log]);
+  return {
+    currentAppState: appState.current,
+  };
 };
 exports.useAppStateHandler = useAppStateHandler;

package/lib/index.d.ts

@@ -8,16 +8,34 @@
  * call state transitions, push notification processing, and native call UI
  * integration.
  */
-export { TelnyxVoipClient, createTelnyxVoipClient, createBackgroundTelnyxVoipClient, } from './telnyx-voip-client';
+export {
+  TelnyxVoipClient,
+  createTelnyxVoipClient,
+  createBackgroundTelnyxVoipClient,
+} from './telnyx-voip-client';
 export type { TelnyxVoipClientOptions } from './telnyx-voip-client';
 export { TelnyxVoiceApp } from './telnyx-voice-app';
 export type { TelnyxVoiceAppOptions, TelnyxVoiceAppProps } from './telnyx-voice-app';
 export { useAppStateHandler } from './hooks/useAppStateHandler';
 export { useTelnyxVoice } from './context/TelnyxVoiceContext';
 export { Call } from './models/call';
-export { TelnyxConnectionState, isTelnyxConnectionState, canMakeCalls, isConnected, isTransitioning, } from './models/connection-state';
+export {
+  TelnyxConnectionState,
+  isTelnyxConnectionState,
+  canMakeCalls,
+  isConnected,
+  isTransitioning,
+} from './models/connection-state';
 export { TelnyxCallState, isTelnyxCallState, CallStateHelpers } from './models/call-state';
-export { isCredentialConfig, isTokenConfig, validateConfig, validateCredentialConfig, validateTokenConfig, createCredentialConfig, createTokenConfig, } from './models/config';
+export {
+  isCredentialConfig,
+  isTokenConfig,
+  validateConfig,
+  validateCredentialConfig,
+  validateTokenConfig,
+  createCredentialConfig,
+  createTokenConfig,
+} from './models/config';
 export type { Config, CredentialConfig, TokenConfig } from './models/config';
 export type { Call as TelnyxCall } from '@telnyx/react-native-voice-sdk';
 export * from './callkit';