@qusaieilouti99/call-manager 0.1.36 → 0.1.38

package/android/src/main/java/com/margelo/nitro/qusaieilouti99/callmanager/CallEngine.kt

@@ -12,16 +12,16 @@ import android.media.MediaPlayer
 import android.media.RingtoneManager
 import android.net.Uri
 import android.os.Build
-import android.os.Bundle // Explicit import
+import android.os.Bundle
 import android.os.PowerManager
-import android.telecom.CallAudioState // Explicit import
-import android.telecom.Connection // Explicit import
-import android.telecom.DisconnectCause // Explicit import
-import android.telecom.PhoneAccount // Explicit import
-import android.telecom.PhoneAccountHandle // Explicit import
-import android.telecom.TelecomManager // Explicit import
-import android.telecom.VideoProfile // Explicit import
-import android.util.Log // Explicit import
+import android.telecom.CallAudioState
+import android.telecom.Connection
+import android.telecom.DisconnectCause
+import android.telecom.PhoneAccount
+import android.telecom.PhoneAccountHandle
+import android.telecom.TelecomManager
+import android.telecom.VideoProfile
+import android.util.Log
 import android.graphics.Color
 import android.app.Person
 import org.json.JSONArray
@@ -38,15 +38,15 @@ object CallEngine {
     private const val FOREGROUND_NOTIF_ID = 1001
 
     private var ringtone: android.media.Ringtone? = null
-    private var ringbackPlayer: MediaPlayer? = null // For outgoing call ringback
+    private var ringbackPlayer: MediaPlayer? = null
     private var audioManager: AudioManager? = null
     private var wakeLock: PowerManager.WakeLock? = null
     private var appContext: Context? = null
 
     // --- Multi-call state ---
-    private val activeCalls = ConcurrentHashMap<String, CallInfo>() // callId -> CallInfo
-    private val telecomConnections = ConcurrentHashMap<String, Connection>() // callId -> Telecom Connection
-    private var currentCallId: String? = null // The call currently in foreground (active/ringing/dialing)
+    private val activeCalls = ConcurrentHashMap<String, CallInfo>()
+    private val telecomConnections = ConcurrentHashMap<String, Connection>()
+    private var currentCallId: String? = null
     private var canMakeMultipleCalls: Boolean = true
 
     data class CallInfo(
@@ -61,14 +61,12 @@ object CallEngine {
     }
 
     // --- Event handler for JS ---
-    // Changed listener type to generated Func_void_CallEventType_std__string
     private var eventHandler: ((CallEventType, String) -> Unit)? = null
-    private val cachedEvents = mutableListOf<Pair<CallEventType, String>>() // For caching events
+    private val cachedEvents = mutableListOf<Pair<CallEventType, String>>()
 
     fun setEventHandler(handler: ((CallEventType, String) -> Unit)?) {
         Log.d(TAG, "setEventHandler called. Handler present: ${handler != null}")
         eventHandler = handler
-        // Emit cached events if a handler is now available
         handler?.let { h ->
             if (cachedEvents.isNotEmpty()) {
                 Log.d(TAG, "Emitting ${cachedEvents.size} cached events.")
@@ -78,7 +76,6 @@ object CallEngine {
         }
     }
 
-    // Emit event uses the generated CallEventType enum directly
     fun emitEvent(type: CallEventType, data: JSONObject) {
         Log.d(TAG, "Emitting event: $type, data: $data")
         val dataString = data.toString()
@@ -126,7 +123,7 @@ object CallEngine {
         return result
     }
 
-    // Removed callType param, now extracted from callData
+    // This is for INCOMING calls using TelecomManager.addNewIncomingCall
     fun reportIncomingCall(context: Context, callId: String, callData: String) {
         appContext = context.applicationContext
         Log.d(TAG, "reportIncomingCall: $callId, $callData")
@@ -136,12 +133,12 @@ object CallEngine {
             json.optString("name", "Unknown")
         } catch (e: Exception) { "Unknown" }
 
-        val parsedCallType = try { // Extract callType from callData
+        val parsedCallType = try {
             val json = JSONObject(callData)
             json.optString("callType", "Audio")
         } catch (e: Exception) { "Audio" }
 
-        val isVideoCallBoolean = parsedCallType == "Video" // Convert to boolean for Telecom API
+        val isVideoCallBoolean = parsedCallType == "Video"
 
         if (!canMakeMultipleCalls && activeCalls.isNotEmpty()) {
             Log.d(TAG, "Can't make multiple calls, holding existing calls.")
@@ -153,14 +150,15 @@ object CallEngine {
         Log.d(TAG, "Call $callId added to activeCalls. State: INCOMING, callType: $parsedCallType")
 
         showIncomingCallUI(context, callId, callerName, parsedCallType)
-        registerPhoneAccount(context)
+        registerPhoneAccount(context) // Register phone account so Telecom can handle incoming
         val telecomManager = context.getSystemService(Context.TELECOM_SERVICE) as TelecomManager
         val phoneAccountHandle = getPhoneAccountHandle(context)
         val extras = Bundle().apply {
-            putString(MyConnectionService.EXTRA_CALL_DATA, callData) // Pass raw callData
-            putBoolean(MyConnectionService.EXTRA_IS_VIDEO_CALL_BOOLEAN, isVideoCallBoolean) // Pass boolean for Telecom
+            putString(MyConnectionService.EXTRA_CALL_DATA, callData)
+            putBoolean(MyConnectionService.EXTRA_IS_VIDEO_CALL_BOOLEAN, isVideoCallBoolean)
         }
         try {
+            // This API is fundamental for INCOMING call integration with Telecom.
             telecomManager.addNewIncomingCall(phoneAccountHandle, extras)
             startForegroundService(context)
             Log.d(TAG, "Successfully reported incoming call to TelecomManager for $callId")
@@ -174,7 +172,7 @@ object CallEngine {
         notifyCallStateChanged(context)
     }
 
-    // Removed callType param, now extracted from callData
+    // CORRECTED: Uses TelecomManager.placeCall for outgoing calls.
     fun startOutgoingCall(context: Context, callId: String, callData: String) {
         appContext = context.applicationContext
         Log.d(TAG, "startOutgoingCall: $callId, $callData")
@@ -184,12 +182,12 @@ object CallEngine {
             json.optString("name", "Unknown")
         } catch (e: Exception) { "Unknown" }
 
-        val parsedCallType = try { // Extract callType from callData
+        val parsedCallType = try {
             val json = JSONObject(callData)
             json.optString("callType", "Audio")
         } catch (e: Exception) { "Audio" }
 
-        val isVideoCallBoolean = parsedCallType == "Video" // Convert to boolean for Telecom API
+        val isVideoCallBoolean = parsedCallType == "Video"
 
         if (!canMakeMultipleCalls && activeCalls.isNotEmpty()) {
             Log.d(TAG, "Can't make multiple calls, holding existing calls before outgoing.")
@@ -200,33 +198,41 @@ object CallEngine {
         currentCallId = callId
         Log.d(TAG, "Call $callId added to activeCalls. State: DIALING, callType: $parsedCallType")
 
-        registerPhoneAccount(context)
+        registerPhoneAccount(context) // Ensure PhoneAccount is registered for Telecom to recognize it
         val telecomManager = context.getSystemService(Context.TELECOM_SERVICE) as TelecomManager
         val phoneAccountHandle = getPhoneAccountHandle(context)
+
+        // For `placeCall`, the address URI is usually required. Use a generic "tel:" scheme with callId or number.
+        val addressUri = Uri.fromParts(PhoneAccount.SCHEME_TEL, callId, null) // Using callId as a unique identifier for URI
+
         val extras = Bundle().apply {
-            putString(MyConnectionService.EXTRA_CALL_DATA, callData) // Pass raw callData
-            putBoolean(MyConnectionService.EXTRA_IS_VIDEO_CALL_BOOLEAN, isVideoCallBoolean) // Pass boolean for Telecom
-            // Set speaker for video calls initially in Telecom's extras
+            // Essential for self-managed apps using placeCall
+            putParcelable(TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE, phoneAccountHandle)
+            // Pass additional data for your ConnectionService to retrieve
+            putString(MyConnectionService.EXTRA_CALL_DATA, callData)
+            putBoolean(MyConnectionService.EXTRA_IS_VIDEO_CALL_BOOLEAN, isVideoCallBoolean)
+            // Hint for initial speakerphone state
             putBoolean(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, isVideoCallBoolean)
         }
 
         try {
-            telecomManager.addNewOutgoingCall(phoneAccountHandle, extras)
+            // CORRECT API for self-managed outgoing calls that interact with Telecom
+            telecomManager.placeCall(addressUri, extras)
             startForegroundService(context)
-            Log.d(TAG, "Successfully reported outgoing call to TelecomManager for $callId")
+            Log.d(TAG, "Successfully reported outgoing call to TelecomManager via placeCall for $callId")
             startRingback()
             bringAppToForeground(context)
             keepScreenAwake(context, true)
-            if (parsedCallType == "Video") { // Initial audio route for video calls
+            if (parsedCallType == "Video") {
                 setAudioRoute(context, "Speaker")
             } else {
-                setAudioRoute(context, "Earpiece") // Initial audio route for audio calls
+                setAudioRoute(context, "Earpiece")
             }
         } catch (e: SecurityException) {
-            Log.e(TAG, "SecurityException: Failed to start outgoing call. Check MANAGE_OWN_CALLS permission: ${e.message}", e)
+            Log.e(TAG, "SecurityException: Failed to start outgoing call via placeCall. Check MANAGE_OWN_CALLS permission: ${e.message}", e)
             endCall(context, callId)
         } catch (e: Exception) {
-            Log.e(TAG, "Failed to start outgoing call: ${e.message}", e)
+            Log.e(TAG, "Failed to start outgoing call via placeCall: ${e.message}", e)
             endCall(context, callId)
         }
         notifyCallStateChanged(context)
@@ -263,7 +269,7 @@ object CallEngine {
 
     fun holdCall(context: Context, callId: String) {
         Log.d(TAG, "holdCall: $callId")
-        activeCalls[callId]?.state = CallState.HELD
+        // Always attempt to inform Telecom if a Connection object exists for this callId
         val connection = telecomConnections[callId]
         connection?.setOnHold()
         emitEvent(CallEventType.CALL_HELD, JSONObject().put("callId", callId))
@@ -273,6 +279,7 @@ object CallEngine {
     fun unholdCall(context: Context, callId: String) {
         Log.d(TAG, "unholdCall: $callId")
         activeCalls[callId]?.state = CallState.ACTIVE
+        // Always attempt to inform Telecom if a Connection object exists for this callId
         val connection = telecomConnections[callId]
         connection?.setActive()
         emitEvent(CallEventType.CALL_UNHELD, JSONObject().put("callId", callId))
@@ -310,6 +317,7 @@ object CallEngine {
 
         cancelIncomingCallUI(context)
 
+        // Only disconnect from Telecom if a Connection object exists for this callId
         val connection = telecomConnections[callId]
         if (connection != null) {
             connection.setDisconnected(DisconnectCause(DisconnectCause.LOCAL))
@@ -317,7 +325,7 @@ object CallEngine {
             removeTelecomConnection(callId)
             Log.d(TAG, "Telecom Connection for $callId disconnected and destroyed.")
         } else {
-            Log.w(TAG, "No Telecom Connection found for callId=$callId. It might have already been handled by Telecom.")
+            Log.d(TAG, "No Telecom Connection found for callId=$callId. Likely an outgoing call not initially handled by Telecom.")
         }
 
         if (activeCalls.isEmpty()) {
@@ -446,11 +454,10 @@ object CallEngine {
 
     // --- Audio Device Management ---
 
-    // Returns the generated AudioRoutesInfo data class
     fun getAudioDevices(): AudioRoutesInfo {
-        audioManager = audioManager ?: appContext?.getSystemService(Context.AUDIO_SERVICE) as? AudioManager ?: run {
+        audioManager = appContext?.getSystemService(Context.AUDIO_SERVICE) as? AudioManager ?: run {
             Log.e(TAG, "getAudioDevices: AudioManager is null or appContext is not set. Returning default.")
-            return AudioRoutesInfo(emptyArray(), "Unknown") // Return default empty info
+            return AudioRoutesInfo(emptyArray(), "Unknown")
         }
         val devices = mutableListOf<String>()
         var currentRoute: String = "Unknown"
@@ -461,7 +468,7 @@ object CallEngine {
                 when (device.type) {
                     AudioDeviceInfo.TYPE_BLUETOOTH_A2DP, AudioDeviceInfo.TYPE_BLUETOOTH_SCO -> {
                         devices.add("Bluetooth")
-                        if (audioManager?.isBluetoothScoOn == true && !device.isSource) currentRoute = "Bluetooth" // check if output device
+                        if (audioManager?.isBluetoothScoOn == true && !device.isSource) currentRoute = "Bluetooth"
                     }
                     AudioDeviceInfo.TYPE_WIRED_HEADPHONES, AudioDeviceInfo.TYPE_WIRED_HEADSET -> {
                         devices.add("Headset")
@@ -473,10 +480,7 @@ object CallEngine {
                     }
                     AudioDeviceInfo.TYPE_BUILTIN_EARPIECE -> {
                         devices.add("Earpiece")
-                        // Earpiece is active if speaker, bluetooth, and headset are off
-                        // This heuristic is tricky, relies on other routes being off
                         if (audioManager?.isSpeakerphoneOn == false && audioManager?.isWiredHeadsetOn == false && audioManager?.isBluetoothScoOn == false && !device.isSource) {
-                             // This heuristic is tricky, relies on other routes being off
                             currentRoute = "Earpiece"
                         }
                     }
@@ -484,17 +488,15 @@ object CallEngine {
                 }
             }
         } else {
-            // Fallback for older APIs. Detection is less reliable.
             devices.add("Speaker")
             devices.add("Earpiece")
             if (audioManager?.isSpeakerphoneOn == true) currentRoute = "Speaker"
-            else currentRoute = "Earpiece" // Best guess for older API
+            else currentRoute = "Earpiece"
         }
 
         val distinctDevices = devices.distinct().toTypedArray()
 
-        // Final check/refinement for currentRoute based on AudioManager flags
-        if (currentRoute == "Unknown" || currentRoute == "Earpiece") { // If still unknown or defaulted to earpiece
+        if (currentRoute == "Unknown" || currentRoute == "Earpiece") {
             if (audioManager?.isBluetoothScoOn == true) {
                 currentRoute = "Bluetooth"
             } else if (audioManager?.isSpeakerphoneOn == true) {
@@ -502,7 +504,7 @@ object CallEngine {
             } else if (audioManager?.isWiredHeadsetOn == true) {
                 currentRoute = "Headset"
             } else {
-                currentRoute = "Earpiece" // Assume earpiece as last resort
+                currentRoute = "Earpiece"
             }
         }
 
@@ -544,8 +546,6 @@ object CallEngine {
                 Log.w(TAG, "Unknown audio route: $route. No action taken.")
             }
         }
-        // Emit event immediately with the requested route.
-        // The actual route change will be confirmed by onCallAudioStateChanged callback.
         emitEvent(CallEventType.AUDIO_ROUTE_CHANGED, JSONObject().put("route", route))
     }
 
@@ -617,12 +617,12 @@ object CallEngine {
             Log.w(TAG, "Cannot emit AudioDevicesChanged: appContext is null.")
             return
         }
-        val audioInfo = getAudioDevices() // Get AudioRoutesInfo data class
-        val jsonPayload = JSONObject().apply { // Convert to JSONObject for emitEvent
+        val audioInfo = getAudioDevices()
+        val jsonPayload = JSONObject().apply {
             put("devices", JSONArray(audioInfo.devices.toList()))
             put("currentRoute", audioInfo.currentRoute)
         }
-        emitEvent(CallEventType.AUDIO_DEVICES_CHANGED, jsonPayload) // Emit the full JSON object
+        emitEvent(CallEventType.AUDIO_DEVICES_CHANGED, jsonPayload)
     }
 
     // --- Call State Change Notification ---
@@ -671,6 +671,7 @@ object CallEngine {
         }
     }
 
+    // PhoneAccount registration is used for both INCOMING and OUTGOING calls when interacting with Telecom
     private fun registerPhoneAccount(context: Context) {
         val telecomManager = context.getSystemService(Context.TELECOM_SERVICE) as TelecomManager
         val phoneAccountHandle = getPhoneAccountHandle(context)
@@ -699,7 +700,6 @@ object CallEngine {
     }
 
     // --- Ringtone Management (for incoming calls, pre-Android S) ---
-    // Can rely on default ringtone without adding custom file for incoming calls.
     fun playRingtone(context: Context) {
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
             Log.d(TAG, "playRingtone: Android S+ detected, system will handle ringtone via Telecom.")
@@ -732,15 +732,12 @@ object CallEngine {
     }
 
     // --- Ringback Tone Management (for outgoing calls) ---
-    // Requires `res/raw/ringback_tone.mp3` for custom outgoing ringback.
     private fun startRingback() {
         if (ringbackPlayer != null && ringbackPlayer!!.isPlaying) {
             Log.d(TAG, "Ringback tone already playing.")
             return
         }
         try {
-            // Ensure you have `res/raw/ringback_tone.mp3` in your project for this to work.
-            // If you don't want a custom ringback, you can play a silent audio file or do nothing here.
             val ringbackUri = Uri.parse("android.resource://${appContext?.packageName}/raw/ringback_tone")
             ringbackPlayer = MediaPlayer.create(appContext, ringbackUri)
             if (ringbackPlayer == null) {

package/android/src/main/java/com/margelo/nitro/qusaieilouti99/callmanager/CallForegroundService.kt

@@ -6,9 +6,9 @@ import android.app.Service
 import android.content.Context
 import android.content.Intent
 import android.os.Build
-import android.util.Log // Explicit import
+import android.util.Log
 import android.os.IBinder
-import android.app.NotificationManager // Explicit import
+import android.app.NotificationManager
 
 class CallForegroundService : Service() {
 
@@ -61,7 +61,7 @@ class CallForegroundService : Service() {
                 NotificationManager.IMPORTANCE_LOW
             )
             channel.description = "Notification for ongoing calls"
-            val manager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager // Corrected usage
+            val manager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
             manager.createNotificationChannel(channel)
             Log.d(TAG, "Foreground notification channel '$CHANNEL_ID' created/updated.")
         }

package/android/src/main/java/com/margelo/nitro/qusaieilouti99/callmanager/CallManager.kt

@@ -1,7 +1,7 @@
 package com.margelo.nitro.qusaieilouti99.callmanager
 
 import com.facebook.proguard.annotations.DoNotStrip
-import android.util.Log // Explicit import
+import android.util.Log
 import org.json.JSONArray
 import org.json.JSONObject
 
@@ -10,8 +10,6 @@ class CallManager : HybridCallManagerSpec() {
 
     private val TAG = "CallManager"
 
-    // Listener type now directly matches the generated Func_void_CallEventType_std__string
-    // This is the correct type from your Nitro codegen output.
     private var currentListener: Func_void_CallEventType_std__string? = null
 
     override fun endCall(callId: String) {
@@ -28,14 +26,13 @@ class CallManager : HybridCallManagerSpec() {
         } ?: Log.e(TAG, "App context not set for silenceRingtone.")
     }
 
-    // Return type changed to AudioRoutesInfo from String
     override fun getAudioDevices(): AudioRoutesInfo {
         Log.d(TAG, "getAudioDevices requested.")
         return CallEngine.getAppContext()?.let {
-            CallEngine.getAudioDevices() // This now directly returns AudioRoutesInfo
+            CallEngine.getAudioDevices()
         } ?: run {
             Log.e(TAG, "App context not set for getAudioDevices. Returning empty AudioRoutesInfo.")
-            AudioRoutesInfo(emptyArray(), "Unknown") // Return default empty data class
+            AudioRoutesInfo(emptyArray(), "Unknown")
         }
     }
 
@@ -50,23 +47,18 @@ class CallManager : HybridCallManagerSpec() {
         Log.d(TAG, "keepScreenAwake requested: $keepAwake")
         CallEngine.getAppContext()?.let {
             CallEngine.keepScreenAwake(it, keepAwake)
-        } ?: Log.e(TAG, "App context not set for keepScreenAwake.")
+        } ?: Log.e(TAG, "App context not set for keepAwake.")
     }
 
-    // Corrected addListener signature to match generated HybridCallManagerSpec
-    // This is the primary fix for the `addListener overrides nothing` error.
     override fun addListener(
-        listener: Func_void_CallEventType_std__string // Use generated type directly
-    ): Func_void { // Return generated type
+        listener: Func_void_CallEventType_std__string
+    ): Func_void {
         Log.d(TAG, "addListener called with listener: $listener")
-        // Store the incoming Nitro-generated listener.
-        // It already implements the (CallEventType, String) -> Unit interface.
         currentListener = listener
-        CallEngine.setEventHandler(listener) // Pass it directly to CallEngine
+        CallEngine.setEventHandler(listener)
 
-        // Return a Nitro-generated Func_void for the remove function
         return Func_void_java {
-            if (currentListener === listener) { // Compare against the original listener passed
+            if (currentListener === listener) {
                 CallEngine.setEventHandler(null)
                 currentListener = null
                 Log.d(TAG, "Listener removed.")
@@ -76,7 +68,6 @@ class CallManager : HybridCallManagerSpec() {
         }
     }
 
-    // Removed callType param, now extracted from callData
     override fun startOutgoingCall(callId: String, callData: String) {
         Log.d(TAG, "startOutgoingCall requested: callId=$callId, callData=$callData")
         CallEngine.getAppContext()?.let {

package/android/src/main/java/com/margelo/nitro/qusaieilouti99/callmanager/MyConnection.kt

@@ -121,8 +121,8 @@ class MyConnection(
         Log.d(TAG, "Stopping DTMF tone for callId: $callId")
     }
 
-    override fun onConnectionEvent(event: String, extras: Bundle?) { // Resolved - signature is correct
-        super.onConnectionEvent(event, extras)
+    override fun onConnectionEvent(event: String, extras: Bundle?) { // Resolved
+        super.onConnectionEvent(event, extras) // Correct super call
         Log.d(TAG, "Connection event: $event, extras: $extras for callId: $callId")
     }
 

package/android/src/main/java/com/margelo/nitro/qusaieilouti99/callmanager/MyConnectionService.kt

@@ -31,7 +31,7 @@ class MyConnectionService : ConnectionService() {
         val videoState = if (isVideoCallBoolean) VideoProfile.STATE_BIDIRECTIONAL else VideoProfile.STATE_AUDIO_ONLY
         connection.setVideoState(videoState)
         connection.setRinging()
-        Log.d(TAG, "Created incoming connection for callId: ${connection.callId}. Status: RINGING, VideoState: $videoState")
+        Log.d(TAG, "Created incoming connection for callId: ${connection.callId}. Status: RINGING, VideoState: $videoState") // Accesses internal callId
         return connection
     }
 
@@ -49,7 +49,7 @@ class MyConnectionService : ConnectionService() {
         val videoState = if (isVideoCallBoolean) VideoProfile.STATE_BIDIRECTIONAL else VideoProfile.STATE_AUDIO_ONLY
         connection.setVideoState(videoState)
         connection.setDialing()
-        Log.d(TAG, "Created outgoing connection for callId: ${connection.callId}. Status: DIALING, VideoState: $videoState")
+        Log.d(TAG, "Created outgoing connection for callId: ${connection.callId}. Status: DIALING, VideoState: $videoState") // Accesses internal callId
 
         if (request.extras?.getBoolean(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, false) == true) {
             Log.d(TAG, "Hinting Telecom to start outgoing call with speakerphone as per request extras.")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qusaieilouti99/call-manager",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Call manager",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",