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

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -0,0 +1,82 @@
+-- Merging decision tree log ---
+manifest
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:2:1-38:12
+INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:2:1-38:12
+	package
+		INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml
+	xmlns:android
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:2:11-69
+uses-permission#android.permission.INTERNET
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:5:5-67
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:5:22-64
+uses-permission#android.permission.WAKE_LOCK
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:6:5-68
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:6:22-65
+uses-permission#android.permission.VIBRATE
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:7:5-66
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:7:22-63
+uses-permission#android.permission.RECORD_AUDIO
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:10:5-71
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:10:22-68
+uses-permission#android.permission.MODIFY_AUDIO_SETTINGS
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:11:5-80
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:11:22-77
+uses-permission#android.permission.ACCESS_NETWORK_STATE
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:12:5-79
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:12:22-76
+uses-permission#android.permission.FOREGROUND_SERVICE
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:15:5-77
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:15:22-74
+uses-permission#android.permission.FOREGROUND_SERVICE_PHONE_CALL
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:16:5-88
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:16:22-85
+uses-permission#android.permission.FOREGROUND_SERVICE_MICROPHONE
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:17:5-88
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:17:22-85
+uses-permission#android.permission.MANAGE_OWN_CALLS
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:20:5-75
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:20:22-72
+uses-permission#android.permission.USE_FULL_SCREEN_INTENT
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:21:5-81
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:21:22-78
+uses-permission#android.permission.POST_NOTIFICATIONS
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:22:5-77
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:22:22-74
+uses-feature#android.hardware.microphone
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:25:5-27:35
+	android:required
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:27:9-32
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:26:9-51
+application
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:29:5-36:19
+service#com.telnyx.react_voice_commons.CallForegroundService
+ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:31:9-35:68
+	android:enabled
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:33:13-35
+	android:exported
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:34:13-37
+	android:foregroundServiceType
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:35:13-65
+	android:name
+		ADDED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml:32:13-50
+uses-sdk
+INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml reason: use-sdk injection requested
+INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml
+INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml
+	android:targetSdkVersion
+		INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml
+	android:minSdkVersion
+		INJECTED from /Users/isaacakakpo/Documents/rtc_prod/react-voice-commons/node_modules/@telnyx/react-voice-commons-sdk/android/src/main/AndroidManifest.xml

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/local.properties

@@ -0,0 +1,8 @@
+## This file must *NOT* be checked into Version Control Systems,
+# as it contains information specific to your local configuration.
+#
+# Location of the SDK. This is only used by Gradle.
+# For customization when using a Version Control System, please read the
+# header note.
+#Fri Oct 10 13:08:40 CEST 2025
+sdk.dir=/Users/isaacakakpo/Library/Android/sdk

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")
+    }
+}