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

package/src/context/TelnyxVoiceContext.tsx

@@ -1,33 +1,33 @@
-import React, { createContext, useContext } from 'react';
-import { TelnyxVoipClient } from '../telnyx-voip-client';
-import { TelnyxConnectionState } from '../models/connection-state';
-
-interface TelnyxVoiceContextValue {
-  voipClient: TelnyxVoipClient;
-  // Add methods that CallKitHandler expects (these can be no-ops for now)
-  connectionState?: TelnyxConnectionState;
-  setConnectionState?: (state: TelnyxConnectionState) => void;
-  connect?: (payload: any) => Promise<any>;
-  client?: any;
-  setClient?: (client: any) => void;
-  enableAutoReconnect?: (enabled: boolean) => void;
-}
-
-const TelnyxVoiceContext = createContext<TelnyxVoiceContextValue | null>(null);
-
-export const TelnyxVoiceProvider: React.FC<{
-  voipClient: TelnyxVoipClient;
-  children: React.ReactNode;
-}> = ({ voipClient, children }) => {
-  return (
-    <TelnyxVoiceContext.Provider value={{ voipClient }}>{children}</TelnyxVoiceContext.Provider>
-  );
-};
-
-export const useTelnyxVoice = (): TelnyxVoiceContextValue => {
-  const context = useContext(TelnyxVoiceContext);
-  if (!context) {
-    throw new Error('useTelnyxVoice must be used within a TelnyxVoiceProvider');
-  }
-  return context;
-};
+import React, { createContext, useContext } from 'react';
+import { TelnyxVoipClient } from '../telnyx-voip-client';
+import { TelnyxConnectionState } from '../models/connection-state';
+
+interface TelnyxVoiceContextValue {
+  voipClient: TelnyxVoipClient;
+  // Add methods that CallKitHandler expects (these can be no-ops for now)
+  connectionState?: TelnyxConnectionState;
+  setConnectionState?: (state: TelnyxConnectionState) => void;
+  connect?: (payload: any) => Promise<any>;
+  client?: any;
+  setClient?: (client: any) => void;
+  enableAutoReconnect?: (enabled: boolean) => void;
+}
+
+const TelnyxVoiceContext = createContext<TelnyxVoiceContextValue | null>(null);
+
+export const TelnyxVoiceProvider: React.FC<{
+  voipClient: TelnyxVoipClient;
+  children: React.ReactNode;
+}> = ({ voipClient, children }) => {
+  return (
+    <TelnyxVoiceContext.Provider value={{ voipClient }}>{children}</TelnyxVoiceContext.Provider>
+  );
+};
+
+export const useTelnyxVoice = (): TelnyxVoiceContextValue => {
+  const context = useContext(TelnyxVoiceContext);
+  if (!context) {
+    throw new Error('useTelnyxVoice must be used within a TelnyxVoiceProvider');
+  }
+  return context;
+};

package/src/hooks/use-callkit-coordinator.ts

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

package/src/hooks/useAppReadyNotifier.ts

@@ -1,25 +1,25 @@
-import { useEffect } from 'react';
-import { Platform } from '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
- * This is automatically called by TelnyxVoiceApp, but can be used manually if needed
- *
- * Note: With the native VoicePnManager integration, this notification is now
- * handled automatically by the native Android services, so this hook is simplified.
- */
-export const useAppReadyNotifier = () => {
-  useEffect(() => {
-    // Only notify on Android since this is Android-specific functionality
-    if (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.
-    }
-  }, []);
-};
+import { useEffect } from 'react';
+import { Platform } from '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
+ * This is automatically called by TelnyxVoiceApp, but can be used manually if needed
+ *
+ * Note: With the native VoicePnManager integration, this notification is now
+ * handled automatically by the native Android services, so this hook is simplified.
+ */
+export const useAppReadyNotifier = () => {
+  useEffect(() => {
+    // Only notify on Android since this is Android-specific functionality
+    if (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.
+    }
+  }, []);
+};

package/src/hooks/useAppStateHandler.ts

@@ -1,134 +1,134 @@
-import { useEffect, useRef } from 'react';
-import { AppState, AppStateStatus } from 'react-native';
-import { router } from 'expo-router';
-import AsyncStorage from '@react-native-async-storage/async-storage';
-import { TelnyxVoipClient } from '../telnyx-voip-client';
-import { TelnyxConnectionState } from '../models/connection-state';
-import { TelnyxCallState, CallStateHelpers } from '../models/call-state';
-
-interface UseAppStateHandlerOptions {
-  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 const useAppStateHandler = ({
-  voipClient,
-  disconnectOnBackground = true,
-  navigateToLoginOnDisconnect = true,
-  debug = false,
-}: UseAppStateHandlerOptions) => {
-  const appState = useRef(AppState.currentState);
-  const log = debug ? console.log : () => {};
-
-  useEffect(() => {
-    const handleAppStateChange = async (nextAppState: AppStateStatus) => {
-      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 !== 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) =>
-              CallStateHelpers.isActive(call.currentState) ||
-              call.currentState === 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 AsyncStorage.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 AsyncStorage.getItem('@push_notification_payload');
-              if (!stillInProgress) {
-                log('AppStateHandler: Push notification call completed, now disconnecting socket');
-                await voipClient.logout();
-                if (navigateToLoginOnDisconnect) {
-                  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');
-                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 = AppState.addEventListener('change', handleAppStateChange);
-
-    return () => {
-      subscription?.remove();
-    };
-  }, [voipClient, disconnectOnBackground, navigateToLoginOnDisconnect, log]);
-
-  return {
-    currentAppState: appState.current,
-  };
-};
+import { useEffect, useRef } from 'react';
+import { AppState, AppStateStatus } from 'react-native';
+import { router } from 'expo-router';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { TelnyxVoipClient } from '../telnyx-voip-client';
+import { TelnyxConnectionState } from '../models/connection-state';
+import { TelnyxCallState, CallStateHelpers } from '../models/call-state';
+
+interface UseAppStateHandlerOptions {
+  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 const useAppStateHandler = ({
+  voipClient,
+  disconnectOnBackground = true,
+  navigateToLoginOnDisconnect = true,
+  debug = false,
+}: UseAppStateHandlerOptions) => {
+  const appState = useRef(AppState.currentState);
+  const log = debug ? console.log : () => {};
+
+  useEffect(() => {
+    const handleAppStateChange = async (nextAppState: AppStateStatus) => {
+      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 !== 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) =>
+              CallStateHelpers.isActive(call.currentState) ||
+              call.currentState === 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 AsyncStorage.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 AsyncStorage.getItem('@push_notification_payload');
+              if (!stillInProgress) {
+                log('AppStateHandler: Push notification call completed, now disconnecting socket');
+                await voipClient.logout();
+                if (navigateToLoginOnDisconnect) {
+                  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');
+                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 = AppState.addEventListener('change', handleAppStateChange);
+
+    return () => {
+      subscription?.remove();
+    };
+  }, [voipClient, disconnectOnBackground, navigateToLoginOnDisconnect, log]);
+
+  return {
+    currentAppState: appState.current,
+  };
+};

package/src/index.ts

@@ -1,56 +1,56 @@
-/**
- * @telnyx/react-voice-commons-sdk
- *
- * A high-level, state-agnostic, drop-in module for the Telnyx React Native SDK.
- *
- * This library provides a simplified interface for integrating Telnyx WebRTC
- * capabilities into React Native applications. It handles session management,
- * call state transitions, push notification processing, and native call UI
- * integration.
- */
-
-// Main client
-export {
-  TelnyxVoipClient,
-  createTelnyxVoipClient,
-  createBackgroundTelnyxVoipClient,
-} from './telnyx-voip-client';
-export type { TelnyxVoipClientOptions } from './telnyx-voip-client';
-
-// TelnyxVoiceApp component
-export { TelnyxVoiceApp } from './telnyx-voice-app';
-export type { TelnyxVoiceAppOptions, TelnyxVoiceAppProps } from './telnyx-voice-app';
-
-// Hooks
-export { useAppStateHandler } from './hooks/useAppStateHandler';
-export { useTelnyxVoice } from './context/TelnyxVoiceContext';
-
-// Models
-export { Call } from './models/call';
-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 type { Config, CredentialConfig, TokenConfig } from './models/config';
-
-// Re-export useful types from the underlying SDK
-export type { Call as TelnyxCall } from '@telnyx/react-native-voice-sdk';
-
-// Export CallKit functionality
-export * from './callkit';
-
-// Export hooks
-export { useAppReadyNotifier } from './hooks/useAppReadyNotifier';
+/**
+ * @telnyx/react-voice-commons-sdk
+ *
+ * A high-level, state-agnostic, drop-in module for the Telnyx React Native SDK.
+ *
+ * This library provides a simplified interface for integrating Telnyx WebRTC
+ * capabilities into React Native applications. It handles session management,
+ * call state transitions, push notification processing, and native call UI
+ * integration.
+ */
+
+// Main client
+export {
+  TelnyxVoipClient,
+  createTelnyxVoipClient,
+  createBackgroundTelnyxVoipClient,
+} from './telnyx-voip-client';
+export type { TelnyxVoipClientOptions } from './telnyx-voip-client';
+
+// TelnyxVoiceApp component
+export { TelnyxVoiceApp } from './telnyx-voice-app';
+export type { TelnyxVoiceAppOptions, TelnyxVoiceAppProps } from './telnyx-voice-app';
+
+// Hooks
+export { useAppStateHandler } from './hooks/useAppStateHandler';
+export { useTelnyxVoice } from './context/TelnyxVoiceContext';
+
+// Models
+export { Call } from './models/call';
+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 type { Config, CredentialConfig, TokenConfig } from './models/config';
+
+// Re-export useful types from the underlying SDK
+export type { Call as TelnyxCall } from '@telnyx/react-native-voice-sdk';
+
+// Export CallKit functionality
+export * from './callkit';
+
+// Export hooks
+export { useAppReadyNotifier } from './hooks/useAppReadyNotifier';