@telnyx/react-voice-commons-sdk 0.1.5 → 0.1.7-beta.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG.md
 
+## [0.1.6](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.6) (2025-12-09)
+
+### Enhancement
+
+• Added Android native components to npm package for proper distribution
+• Complete Android native integration support for Firebase messaging and call management
+
+### Bug Fixing
+
+• Fixed missing Android directory in npm package files array
+• Resolved native component availability issues for Android integrations
+
 ## [0.1.5](https://github.com/team-telnyx/react-native-voice-commons/releases/tag/0.1.5) (2025-12-08)
 
 ### Enhancement

package/README.md

@@ -51,7 +51,7 @@ export default function App() {
 
 ### Core Components
 
-#### 1. VoIP Client Configuration
+### 1. VoIP Client Configuration
 
 ```tsx
 const voipClient = createTelnyxVoipClient({
@@ -65,7 +65,7 @@ const voipClient = createTelnyxVoipClient({
 - **`enableAppStateManagement: true`** - **Optional (default: true)**: Enables automatic background/foreground app state management. When enabled, the library automatically disconnects when the app goes to background (unless there's an active call) and handles reconnection logic. Set to `false` if you want to handle app lifecycle manually.
 - **`debug: true`** - **Optional**: Enables detailed logging for connection states, call transitions, and push notification processing. Useful for development and troubleshooting.
 
-#### 2. TelnyxVoiceApp Wrapper
+### 2. TelnyxVoiceApp Wrapper
 
 The `TelnyxVoiceApp` component handles:
 
@@ -74,7 +74,7 @@ The `TelnyxVoiceApp` component handles:
 - Login state management with automatic reconnection
 - Background client management for push notifications
 
-#### 3. Reactive State Management
+### 3. Reactive State Management
 
 ```tsx
 // Listen to connection state
@@ -93,7 +93,7 @@ call.callState$.subscribe((state) => {
 });
 ```
 
-#### 4. Call Management
+### 4. Call Management
 
 ```tsx
 // Make a call
@@ -112,9 +112,9 @@ await call.hangup();
 
 The library supports both credential-based and token-based authentication with automatic persistence for seamless reconnection.
 
-#### Authentication Methods
+### Authentication Methods
 
-##### 1. Credential-Based Authentication
+### 1. Credential-Based Authentication
 
 ```tsx
 import { createCredentialConfig } from '@telnyx/react-voice-commons-sdk';
@@ -127,7 +127,7 @@ const config = createCredentialConfig('your_sip_username', 'your_sip_password',
 await voipClient.login(config);
 ```
 
-##### 2. Token-Based Authentication
+### 2. Token-Based Authentication
 
 ```tsx
 import { createTokenConfig } from '@telnyx/react-voice-commons-sdk';
@@ -140,11 +140,11 @@ const config = createTokenConfig('your_jwt_token', {
 await voipClient.loginWithToken(config);
 ```
 
-#### Automatic Storage & Reconnection
+### Automatic Storage & Reconnection
 
 The library automatically stores authentication data securely for seamless reconnection. **You don't need to manually manage these storage keys** - the library handles everything internally.
 
-##### Internal Storage (Managed Automatically)
+### Internal Storage (Managed Automatically)
 
 The library uses these AsyncStorage keys internally:
 
@@ -155,7 +155,7 @@ The library uses these AsyncStorage keys internally:
 
 **Note**: These are managed automatically by the library. You only need to call `login()` once, and the library will handle storage and future reconnections.
 
-##### Auto-Reconnection
+### Auto-Reconnection
 
 ```tsx
 // Automatically reconnects using internally stored credentials or token
@@ -176,7 +176,7 @@ if (!success) {
 
 **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)
+### Manual Storage Management (Advanced Use Only)
 
 If you need to clear stored authentication data manually:
 
@@ -198,9 +198,9 @@ await AsyncStorage.multiRemove([
 
 The library provides complete native integration for both platforms. These integrations are required for production apps using the library.
 
-#### Android Integration
+### Android Integration
 
-##### 1. MainActivity Setup
+### 1. MainActivity Setup
 
 Your app's MainActivity should extend `TelnyxMainActivity` for automatic push notification handling:
 
@@ -225,7 +225,7 @@ The `TelnyxMainActivity` provides:
 - Proper lifecycle management for VoIP functionality
 - Integration with `VoicePnManager` for push notification state
 
-##### 2. Push Notification Setup
+### 2. Push Notification Setup
 
 1. Place `google-services.json` in the project root
 2. Register background message handler:
@@ -239,9 +239,9 @@ messaging().setBackgroundMessageHandler(async (remoteMessage) => {
 });
 ```
 
-#### iOS Integration
+### iOS Integration
 
-##### 1. AppDelegate Setup
+### 1. AppDelegate Setup
 
 Your AppDelegate only needs to implement `PKPushRegistryDelegate` for VoIP push notifications. CallKit integration is automatically handled by CallBridge:
 
@@ -277,13 +277,13 @@ public class AppDelegate: ExpoAppDelegate, PKPushRegistryDelegate {
 
 **Note**: CallKit integration (CXProvider, CXProviderDelegate, audio session management) is automatically handled by the internal CallBridge component. You don't need to implement any CallKit delegate methods manually.
 
-##### 2. VoIP Push Certificate Setup
+### 2. VoIP Push Certificate Setup
 
 - Configure VoIP push certificates in your Apple Developer account
 - The `TelnyxVoipPushHandler` automatically handles token registration and push processing
 - CallKit integration is automatically managed by CallBridge - no manual setup required
 
-#### Key Native Features Integrated
+### Key Native Features Integrated
 
 1. **Push Notification Handling**: Both platforms handle background push notifications properly
 2. **Native Call UI**: CallKit (iOS, managed by CallBridge) and ConnectionService (Android) integration
@@ -416,15 +416,15 @@ npx expo run:ios
 
 ### Common Integration Issues
 
-#### Double Login
+### Double Login
 
 Ensure you're not calling login methods manually when using `TelnyxVoiceApp` with auto-reconnection enabled.
 
-#### Background Disconnection
+### Background Disconnection
 
 Check if `enableAutoReconnect` is set appropriately for your use case in the `TelnyxVoiceApp` configuration.
 
-#### Push Notifications Not Working
+### Push Notifications Not Working
 
 - **Android**:
   - Verify `google-services.json` is in the correct location and Firebase is properly configured
@@ -436,19 +436,19 @@ Check if `enableAutoReconnect` is set appropriately for your use case in the `Te
   - Check that `TelnyxVoipPushHandler.initializeVoipRegistration()` is called in `didFinishLaunchingWithOptions`
 - **Both**: Check that background message handlers are properly registered
 
-#### Native Integration Issues
+### Native Integration Issues
 
 - **Android**: Ensure MainActivity extends `TelnyxMainActivity` for proper intent handling
 - **iOS**: Verify AppDelegate implements `PKPushRegistryDelegate` and delegates to `TelnyxVoipPushHandler`
 - **CallKit**: On iOS, CallKit integration is automatically handled by CallBridge - no manual setup required
 
-#### Audio Issues
+### Audio Issues
 
 - **iOS**: Audio session management is automatically handled by CallBridge
 - **Android**: Verify ConnectionService is properly configured for audio routing
 - **Both**: Ensure proper audio permissions are granted
 
-#### Memory Leaks
+### Memory Leaks
 
 Ensure you're unsubscribing from RxJS observables in your React components:
 

package/android/build.gradle

@@ -0,0 +1,45 @@
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace 'com.telnyx.react_voice_commons'
+    compileSdk 34
+
+    defaultConfig {
+        minSdk 21
+        targetSdk 34
+        versionCode 1
+        versionName "1.0"
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = "17"
+    }
+
+    sourceSets {
+        main {
+            java.srcDirs += 'voice-pn-module/src/main/java'
+        }
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    implementation "com.google.firebase:firebase-messaging:23.1.2"
+    implementation "androidx.core:core-ktx:1.8.0"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.8.21"
+    
+    // React Native dependencies
+    implementation "com.facebook.react:react-native:+"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <!-- Basic permissions that this module needs -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.WAKE_LOCK" />
+    <uses-permission android:name="android.permission.VIBRATE" />
+    
+    <!-- WebRTC and voice call permissions -->
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
+    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    
+    <!-- Background execution permissions for call handling -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE" />
+    
+    <!-- Call management permissions -->
+    <uses-permission android:name="android.permission.MANAGE_OWN_CALLS" />
+    <uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+    
+    <!-- Hardware features -->
+    <uses-feature
+        android:name="android.hardware.microphone"
+        android:required="true" />
+
+    <application>
+        <!-- Foreground service for keeping WebRTC connections alive during calls -->
+        <service 
+            android:name=".CallForegroundService"
+            android:enabled="true"
+            android:exported="false"
+            android:foregroundServiceType="phoneCall|microphone" />
+    </application>
+
+</manifest>

package/android/src/main/java/com/telnyx/react_voice_commons/CallForegroundService.kt

@@ -0,0 +1,83 @@
+package com.telnyx.react_voice_commons
+
+import android.app.Service
+import android.content.Intent
+import android.os.IBinder
+import android.util.Log
+
+/**
+ * Foreground service to keep WebRTC connections alive during calls
+ * This service prevents the system from killing the app during active calls
+ */
+class CallForegroundService : Service() {
+    companion object {
+        private const val TAG = "CallForegroundService"
+        const val ACTION_START_FOREGROUND_SERVICE = "START_FOREGROUND_SERVICE"
+        const val ACTION_STOP_FOREGROUND_SERVICE = "STOP_FOREGROUND_SERVICE"
+        
+        const val EXTRA_CALLER_NAME = "caller_name"
+        const val EXTRA_CALLER_NUMBER = "caller_number"
+        const val EXTRA_CALL_ID = "call_id"
+    }
+
+    override fun onBind(intent: Intent?): IBinder? {
+        return null
+    }
+
+    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
+        when (intent?.action) {
+            ACTION_START_FOREGROUND_SERVICE -> {
+                Log.d(TAG, "Starting foreground service for call")
+                startAsForegroundService(intent)
+            }
+            ACTION_STOP_FOREGROUND_SERVICE -> {
+                Log.d(TAG, "Stopping foreground service")
+                stopAsForegroundService()
+            }
+        }
+        
+        // Restart the service if it's killed by the system
+        return START_STICKY
+    }
+
+    private fun startAsForegroundService(intent: Intent) {
+        val callerName = intent.getStringExtra(EXTRA_CALLER_NAME) ?: "Unknown Caller"
+        val callerNumber = intent.getStringExtra(EXTRA_CALLER_NUMBER) ?: ""
+        val callId = intent.getStringExtra(EXTRA_CALL_ID) ?: "unknown"
+
+        try {
+            // Create ongoing call notification
+            val notificationHelper = TelnyxNotificationHelper(this)
+            val notification = notificationHelper.createOngoingCallNotification(callerName, callerNumber, callId)
+            
+            // Start foreground service with the notification
+            startForeground(TelnyxNotificationHelper.ONGOING_CALL_NOTIFICATION_ID, notification)
+            
+            Log.d(TAG, "Foreground service started with ongoing call notification")
+        } catch (e: Exception) {
+            Log.e(TAG, "Error starting foreground service", e)
+            // Stop the service if we can't create the notification
+            stopSelf()
+        }
+    }
+
+    private fun stopAsForegroundService() {
+        try {
+            // Hide the ongoing call notification
+            TelnyxNotificationHelper.hideOngoingCallNotificationFromContext(this)
+            
+            // Stop foreground service
+            stopForeground(true)
+            stopSelf()
+            
+            Log.d(TAG, "Foreground service stopped")
+        } catch (e: Exception) {
+            Log.e(TAG, "Error stopping foreground service", e)
+        }
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        Log.d(TAG, "CallForegroundService destroyed")
+    }
+}

package/android/src/main/java/com/telnyx/react_voice_commons/TelnyxFirebaseMessagingService.kt

@@ -0,0 +1,179 @@
+package com.telnyx.react_voice_commons
+
+import android.util.Log
+import com.google.firebase.messaging.FirebaseMessagingService
+import com.google.firebase.messaging.RemoteMessage
+
+/**
+ * FCM Service for handling Telnyx voice push notifications
+ * This service should be extended by the main app's FCM service
+ */
+open class TelnyxFirebaseMessagingService : FirebaseMessagingService() {
+    private val tag = "TelnyxFCMService"
+
+    override fun onMessageReceived(remoteMessage: RemoteMessage) {
+        super.onMessageReceived(remoteMessage)
+        
+        Log.d(tag, "FCM message received from: ${remoteMessage.from}")
+        Log.d(tag, "FCM message data: ${remoteMessage.data}")
+
+        // Check if this is a Telnyx voice push notification
+        val isTelnyxVoiceMessage = remoteMessage.data.containsKey("metadata") ||
+                                  remoteMessage.data.containsKey("caller_id_name") ||
+                                  remoteMessage.data.containsKey("caller_name") ||
+                                  remoteMessage.data.containsKey("call_id") ||
+                                  remoteMessage.data.containsKey("telnyx_call_id") ||
+                                  remoteMessage.data.get("message_type") == "voice" ||
+                                  remoteMessage.data.get("message") == "Incoming call!" ||
+                                  remoteMessage.data.get("message") == "Missed call!"
+
+        if (isTelnyxVoiceMessage) {
+            Log.d(tag, "Handling as Telnyx voice push notification")
+            
+            // Check if this is a missed call notification
+            val isMissedCall = remoteMessage.data.get("message") == "Missed call!"
+            if (isMissedCall) {
+                handleTelnyxMissedCall(remoteMessage)
+            } else {
+                handleTelnyxVoicePush(remoteMessage)
+            }
+        } else {
+            Log.d(tag, "Non-Telnyx message, delegating to handleNonTelnyxMessage")
+            handleNonTelnyxMessage(remoteMessage)
+        }
+    }
+
+    override fun onNewToken(token: String) {
+        super.onNewToken(token)
+        Log.d(tag, "FCM token refreshed: $token")
+        handleTokenRefresh(token)
+    }
+
+    /**
+     * Handle Telnyx missed call notifications
+     */
+    protected open fun handleTelnyxMissedCall(remoteMessage: RemoteMessage) {
+        try {
+            Log.d(tag, "Processing Telnyx missed call notification")
+            
+            // Extract caller information from metadata or top-level data
+            var callId = "unknown"
+            var callerName = "Unknown Caller"
+            var callerNumber = ""
+            
+            // First try to parse metadata JSON if it exists
+            val metadataJson = remoteMessage.data["metadata"]
+            if (metadataJson != null) {
+                try {
+                    Log.d(tag, "Parsing missed call metadata JSON: $metadataJson")
+                    val metadata = org.json.JSONObject(metadataJson)
+                    callId = metadata.optString("call_id", "unknown")
+                    callerName = metadata.optString("caller_name", "Unknown Caller")
+                    callerNumber = metadata.optString("caller_number", "")
+                    Log.d(tag, "Extracted from metadata - callId: $callId, callerName: $callerName, callerNumber: $callerNumber")
+                } catch (e: Exception) {
+                    Log.e(tag, "Error parsing missed call metadata JSON", e)
+                }
+            }
+            
+            // Fallback to top-level data if metadata parsing failed or doesn't exist
+            if (callId == "unknown") {
+                callId = remoteMessage.data["call_id"] ?: remoteMessage.data["telnyx_call_id"] ?: "unknown"
+                callerName = remoteMessage.data["caller_id_name"] ?: remoteMessage.data["caller_name"] ?: "Unknown Caller"
+                callerNumber = remoteMessage.data["caller_id_number"] ?: remoteMessage.data["caller_number"] ?: ""
+                Log.d(tag, "Using top-level data for missed call - callId: $callId, callerName: $callerName, callerNumber: $callerNumber")
+            }
+            
+            // Show missed call notification (this will hide any existing incoming call notification)
+            val notificationHelper = TelnyxNotificationHelper(this)
+            notificationHelper.showMissedCallNotification(callerName, callerNumber, callId)
+            
+            Log.d(tag, "Telnyx missed call notification processed successfully")
+        } catch (e: Exception) {
+            Log.e(tag, "Error handling Telnyx missed call notification", e)
+        }
+    }
+
+    /**
+     * Handle Telnyx voice push notifications
+     */
+    protected open fun handleTelnyxVoicePush(remoteMessage: RemoteMessage) {
+        try {
+            Log.d(tag, "Processing Telnyx voice push using VoicePnManager")
+            
+            // Extract caller information from metadata or top-level data
+            var callId = "unknown"
+            var callerName = "Unknown Caller"
+            var callerNumber = ""
+            
+            // First try to parse metadata JSON if it exists
+            val metadataJson = remoteMessage.data["metadata"]
+            if (metadataJson != null) {
+                try {
+                    Log.d(tag, "Parsing metadata JSON: $metadataJson")
+                    val metadata = org.json.JSONObject(metadataJson)
+                    callId = metadata.optString("call_id", "unknown")
+                    callerName = metadata.optString("caller_name", "Unknown Caller")
+                    callerNumber = metadata.optString("caller_number", "")
+                    Log.d(tag, "Extracted from metadata - callId: $callId, callerName: $callerName, callerNumber: $callerNumber")
+                } catch (e: Exception) {
+                    Log.e(tag, "Error parsing metadata JSON", e)
+                    // Fall back to top-level data if metadata parsing fails
+                }
+            }
+            
+            // Fallback to top-level data if metadata parsing failed or doesn't exist
+            if (callId == "unknown") {
+                callId = remoteMessage.data["call_id"] ?: remoteMessage.data["telnyx_call_id"] ?: "unknown"
+                callerName = remoteMessage.data["caller_id_name"] ?: remoteMessage.data["caller_name"] ?: "Unknown Caller"
+                callerNumber = remoteMessage.data["caller_id_number"] ?: remoteMessage.data["caller_number"] ?: ""
+                Log.d(tag, "Using top-level data - callId: $callId, callerName: $callerName, callerNumber: $callerNumber")
+            }
+            
+
+            var metadata = ""
+            
+            // Extract metadata using the same approach as official Telnyx service
+            try {
+                val params = remoteMessage.data
+                val objects = org.json.JSONObject(params as Map<*, *>)
+                metadata = objects.getString( "metadata")
+                
+                Log.d(tag, "Extracted FCM metadata string: $metadata")
+            } catch (e: Exception) {
+                Log.e(tag, "Error extracting metadata from FCM data: ${e.message}")
+
+                // Fallback to simple JSON if metadata extraction fails
+                metadata = org.json.JSONObject().apply {
+                    put("call_id", callId)
+                    put("caller_name", callerName)
+                    put("caller_number", callerNumber)
+                }.toString()
+                
+                Log.d(tag, "Using fallback metadata: $metadata")
+            }
+            //VoicePnManager.setPendingPushAction(this, "incoming_call", metadata)
+
+            // Show notification using dynamic class resolution
+            val notificationHelper = TelnyxNotificationHelper(this)
+            notificationHelper.showIncomingCallNotification(callerName, callerNumber, callId, metadata)
+            Log.d(tag, "Telnyx voice push processed successfully")
+        } catch (e: Exception) {
+            Log.e(tag, "Error handling Telnyx voice push notification", e)
+        }
+    }
+
+    /**
+     * Handle non-Telnyx messages - override this in your app's FCM service if needed
+     */
+    protected open fun handleNonTelnyxMessage(remoteMessage: RemoteMessage) {
+        Log.d(tag, "Default non-Telnyx message handler - override this method if needed")
+    }
+
+    /**
+     * Handle FCM token refresh - override this in your app's FCM service if needed
+     */
+    protected open fun handleTokenRefresh(token: String) {
+        Log.d(tag, "Default token refresh handler - override this method if needed")
+    }
+}