@telnyx/react-voice-commons-sdk 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # CHANGELOG.md
 
+## [0.1.5](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.5) (2025-12-08)
+
+### Enhancement
+
+• Updated to use @telnyx/react-native-voice-sdk@0.3.0 with advanced media events support
+
+## [0.1.4](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.4) (2025-11-25)
+
+### Enhancement
+
+• Enhanced 4G/WiFi reconnection mechanism for better network handling
+• iOS version integration improvements
+
+## [0.1.3](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.3) (2025-11-20)
+
+### Enhancement
+
+• Fixed background answer functionality for iOS
+• Added connecting state to Telnyx client
+• Improved reconnection logic for Android using foreground service implementation
+
 ## [0.1.2](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.2) (2025-11-04)
 
 ### Enhancement

package/README.md

@@ -1,20 +1,16 @@
-# Telnyx React Native Voice SDK Demo
+# Telnyx React Voice Commons SDK
 
-A comprehensive demo application showcasing the **@telnyx/react-voice-commons-sdk** library - a high-level, state-agnostic, drop-in module for the Telnyx React Native SDK that simplifies WebRTC voice calling integration.
+A high-level, state-agnostic, drop-in module for the Telnyx React Native SDK that simplifies WebRTC voice calling integration. This library provides a comprehensive solution for building VoIP applications with native call UI support, push notifications, and seamless background handling.
 
-## Overview
-
-This demo app demonstrates how to integrate the `@telnyx/react-voice-commons-sdk` library to create a fully functional VoIP calling application with native call UI support, push notifications, and background handling.
-
-### Key Features Demonstrated
+### Key Features
 
 - **TelnyxVoiceApp Integration**: Automatic lifecycle management and push notification handling
 - **Native Call UI**: CallKit (iOS) and ConnectionService (Android) integration
 - **Background Handling**: Seamless app state transitions and background call processing
 - **Push Notifications**: Firebase (Android) and APNs (iOS) integration
 - **Reactive State Management**: RxJS-based state streams for real-time UI updates
-- **Modern UI Components**: Built with NativeWind v4 and react-native-reusables
-- **Dark/Light Mode**: Persistent theme support with system navigation bar matching
+- **TypeScript Support**: Full TypeScript definitions for better developer experience
+- **Cross-Platform**: Built for both iOS and Android with React Native
 
 ## About @telnyx/react-voice-commons-sdk
 
@@ -33,7 +29,7 @@ The `@telnyx/react-voice-commons-sdk` library provides:
 
 ### Basic Setup
 
-The demo shows how to integrate the library using the `TelnyxVoiceApp` component for automatic lifecycle management:
+Integrate the library using the `TelnyxVoiceApp` component for automatic lifecycle management:
 
 ```tsx
 import { TelnyxVoiceApp, createTelnyxVoipClient } from '@telnyx/react-voice-commons-sdk';
@@ -53,7 +49,7 @@ export default function App() {
 }
 ```
 
-### Core Components Used in Demo
+### Core Components
 
 #### 1. VoIP Client Configuration
 
@@ -178,7 +174,7 @@ if (!success) {
 - Network reconnection after connectivity loss
 - App state changes (foreground/background transitions)
 
-**Demo App Note**: The demo app's `TelnyxLoginForm` component does additional storage for UI convenience (pre-filling the login form). This is separate from the library's internal authentication storage and is not required for production apps.
+**Demo App Note**: When using the library in a demo application, the `TelnyxLoginForm` component may do additional storage for UI convenience (pre-filling login forms). This is separate from the library's internal authentication storage and is not required for production apps.
 
 ##### Manual Storage Management (Advanced Use Only)
 
@@ -200,7 +196,7 @@ await AsyncStorage.multiRemove([
 
 ### Native Integration
 
-The demo app shows complete native integration for both platforms. These integrations are required for production apps using the library.
+The library provides complete native integration for both platforms. These integrations are required for production apps using the library.
 
 #### Android Integration
 
@@ -468,16 +464,6 @@ useEffect(() => {
 
 For complete API documentation and advanced usage patterns, see the [TelnyxVoiceApp Documentation](./react-voice-commons-sdk/TELNYX_VOICE_APP.md).
 
-## Contributing
-
-When contributing to this demo or the underlying library:
-
-1. Maintain compatibility with both iOS and Android platforms
-2. Add comprehensive tests for new features
-3. Update documentation for any API changes
-4. Follow the existing code style and patterns
-5. Test with both foreground and background scenarios
-
 ## License
 
 MIT License - see LICENSE file for details.

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

@@ -8,116 +8,120 @@ 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 shouldAutoAnswerNextCall;
-    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
-     * 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 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 shouldAutoAnswerNextCall;
+  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
+   * 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 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;