@poolse/react-native-calls 0.4.6 → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Poolse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -17,6 +17,11 @@ await calls.configure('https://api.poolse.dev', { smallIcon: 'ic_call', ringback
 const stop = calls.onCallState((s) => render(s));   // s: Snapshot | null
 await calls.place(conversationId, { media: 'audio', sessionToken });
 calls.answer(); calls.decline(); calls.hangUp();
+
+// Audio output: s.audioOutputs lists the phone, the speaker and every
+// connected headset/Bluetooth device by name; s.audioOutputId is the live one.
+calls.setAudioOutput(s.audioOutputs[0].id);
+calls.setSpeaker(true); // the one-tap toggle, still there
 ```
 
 ## Layout

package/android/src/main/java/dev/poolse/callcore/CallCoreRuntime.kt

@@ -194,6 +194,7 @@ class CallCoreRuntime(
   fun setCamera(on: Boolean) = post { media.setCamera(on) }
   fun switchCamera() = post { media.switchCamera() }
   fun setSpeaker(on: Boolean) = post { media.setSpeaker(on) }
+  fun setAudioOutput(id: String) = post { media.setAudioOutput(id) }
 
   /** Re-emit the current state (the bridge's roster/route changed). */
   fun reemit() = post { if (state.phase != Phase.IDLE) sink.emit(state) }

package/android/src/main/java/dev/poolse/callcore/Ports.kt

@@ -67,6 +67,13 @@ interface MediaPort {
    * route — earpiece, or a connected headset/Bluetooth device (`false`).
    */
   fun setSpeaker(on: Boolean)
+
+  /**
+   * Play through one specific output — an id from the snapshot's
+   * `audioOutputs`. Engines without device selection fall back to the
+   * speaker toggle.
+   */
+  fun setAudioOutput(id: String) = setSpeaker(id == "speaker")
 }
 
 /** The ring UX: CallStyle notification + full-screen activity + tones. */

package/android/src/main/java/dev/poolse/callcore/android/CallCore.kt

@@ -69,6 +69,8 @@ class CallCore private constructor(context: Context) {
   private var cameraOn = false
   private var cameraFacing: String? = null
   private var audioRoute: String? = null
+  private var audioOutputs: List<AudioOutput> = emptyList()
+  private var audioOutputId: String? = null
 
   /** Last snapshot emitted; read by the bridge's getCallState from any thread. */
   @Volatile private var lastSnapshot: Map<String, Any?>? = null
@@ -170,6 +172,12 @@ class CallCore private constructor(context: Context) {
     runtime.reemit()
   }
 
+  /**
+   * Play through one output from the snapshot's `audioOutputs`. Not
+   * optimistic: the adapter reports the route once the OS has moved it.
+   */
+  fun setAudioOutput(id: String) = runtime.setAudioOutput(id)
+
   fun allRingsResolved(outcome: String) = runtime.allRingsResolved(outcome)
 
   fun state(): MachineState = runtime.currentState()
@@ -216,6 +224,8 @@ class CallCore private constructor(context: Context) {
         )
       },
       audioRoute = audioRoute ?: if (state.media == "video") "speaker" else "earpiece",
+      audioOutputs = audioOutputs.map { mapOf("id" to it.id, "kind" to it.kind, "name" to it.name) },
+      audioOutputId = audioOutputId,
       mutedSelf = mutedSelf,
       cameraOn = cameraOn,
       cameraFacing = cameraFacing,
@@ -235,6 +245,8 @@ class CallCore private constructor(context: Context) {
     cameraOn = false
     cameraFacing = null
     audioRoute = null
+    audioOutputs = emptyList()
+    audioOutputId = null
   }
 
   /**
@@ -300,6 +312,10 @@ class CallCore private constructor(context: Context) {
       runtime.post { cameraOn = on; cameraFacing = facing }
       runtime.reemit()
     }
+    override fun onAudioOutputs(outputs: List<AudioOutput>, selectedId: String?) {
+      runtime.post { audioOutputs = outputs; audioOutputId = selectedId }
+      runtime.reemit()
+    }
   }
 
   private fun bringAppToFront(callId: String, from: Context?): Boolean {
@@ -368,6 +384,12 @@ class CallCore private constructor(context: Context) {
     /** The live core if one exists — never creates (cheap reads, e.g. getCallState). */
     fun peek(): CallCore? = instance
 
+    /** The configured notification icon (restored from disk on a cold start). */
+    fun smallIcon(context: Context): Int {
+      if (config == null) restoreConfig(context.applicationContext)
+      return config?.smallIcon ?: context.applicationInfo.icon
+    }
+
     internal fun peekConfig(): CallCoreConfig? = config
 
     internal fun requireConfig(): CallCoreConfig =
@@ -466,8 +488,20 @@ interface MediaEvents {
   fun onAudioRoute(route: String)
   /** The local camera track is (not) published + enabled; [facing] `front` | `back`. */
   fun onLocalCamera(on: Boolean, facing: String?) {}
+  /** Every output call audio can play through right now, and the one it does. */
+  fun onAudioOutputs(outputs: List<AudioOutput>, selectedId: String?) {}
 }
 
+/** One place call audio can play — a snapshot `audioOutputs[]` entry. */
+data class AudioOutput(
+  /** Passed back to `setAudioOutput`; stable while the device stays connected. */
+  val id: String,
+  /** `earpiece` | `speaker` | `bluetooth` | `headset`. */
+  val kind: String,
+  /** What the device calls itself ("Galaxy Buds2"), or a plain default for built-ins. */
+  val name: String,
+)
+
 data class MediaParticipant(
   /** The SFU identity — the poolse user id. */
   val identity: String,

package/android/src/main/java/dev/poolse/callcore/android/CallMessagingService.kt

@@ -13,8 +13,8 @@ import dev.poolse.callcore.RingContext
  * everything else keep working unchanged.
  *
  * Contract: data-only messages — rings with `type: "call"`, control
- * pushes (`ring_ended`, `finished`) with `type: "call_event"`
- * (CONTRACT.md §5).
+ * pushes (`ring_ended`, `finished`) and the missed-call notification
+ * (`missed`) with `type: "call_event"` (CONTRACT.md §5).
  */
 class CallMessagingService : FirebaseMessagingService() {
 
@@ -43,6 +43,11 @@ class CallMessagingService : FirebaseMessagingService() {
     // Never configured on this install: nothing can answer a call, and
     // throwing here would crash the messaging process.
     val core = CallCore.getOrNull(this) ?: return
+    if (data["event"] == "missed") {
+      // A notification, not call state: the call is already over.
+      MissedCallNotification.show(this, data, CallCore.smallIcon(this))
+      return
+    }
     // A type=call push without an event is a legacy-shaped ring.
     val event = data["event"]?.ifEmpty { null } ?: if (type == "call") "ring" else return
     when (event) {

package/android/src/main/java/dev/poolse/callcore/android/MissedCallNotification.kt

@@ -0,0 +1,103 @@
+package dev.poolse.callcore.android
+
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.app.PendingIntent
+import android.content.Context
+import android.content.Intent
+import android.os.Build
+import android.util.Log
+import androidx.core.app.NotificationCompat
+import androidx.core.app.NotificationManagerCompat
+
+/**
+ * "Jasir — Missed voice call  [Call back]", posted natively from the
+ * missed-call push (`event: "missed"`) so it shows with the app closed.
+ *
+ * Both the tap and Call back open the app through its launch activity,
+ * carrying the action in extras ([EXTRA_ACTION] …). The bridge reads
+ * them — `takeCallAction()` on a cold start, `onCallAction` while
+ * running — and the host opens the conversation or places the call.
+ * Placing needs the user's session, which only the app has; that is
+ * why Call back does not dial from here.
+ */
+object MissedCallNotification {
+  const val CHANNEL_ID = "poolse_missed_calls"
+  const val EXTRA_ACTION = "poolse_call_action"
+  const val EXTRA_CONVERSATION_ID = "poolse_call_action_conversation"
+  const val EXTRA_CALL_ID = "poolse_call_action_call"
+  const val EXTRA_MEDIA = "poolse_call_action_media"
+  const val ACTION_OPEN = "open"
+  const val ACTION_CALL_BACK = "call_back"
+  private const val TAG = "PoolseMissedCall"
+
+  // A missed call FCM held while the phone was off for days is history.
+  private const val STALE_MS = 24 * 60 * 60 * 1000L
+
+  fun show(context: Context, data: Map<String, String>, smallIcon: Int) {
+    val callId = data["call_id"] ?: return
+    val conversationId = data["conversation_id"] ?: return
+    val sentAt = data["sent_at"]?.toLongOrNull()
+    if (sentAt != null && System.currentTimeMillis() - sentAt > STALE_MS) return
+    val media = if (data["media"] == "video") "video" else "audio"
+    val title = data["title"]?.ifBlank { null }
+      ?: data["caller_name"]?.ifBlank { null }
+      ?: "Missed call"
+    val body = data["body"]?.ifBlank { null }
+      ?: if (media == "video") "Missed video call" else "Missed voice call"
+
+    ensureChannel(context)
+    val id = notificationId(callId)
+
+    fun launch(action: String, requestOffset: Int): PendingIntent? {
+      val intent = context.packageManager.getLaunchIntentForPackage(context.packageName) ?: return null
+      intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_SINGLE_TOP)
+        .putExtra(EXTRA_ACTION, action)
+        .putExtra(EXTRA_CONVERSATION_ID, conversationId)
+        .putExtra(EXTRA_CALL_ID, callId)
+        .putExtra(EXTRA_MEDIA, media)
+      return PendingIntent.getActivity(
+        context,
+        id + requestOffset,
+        intent,
+        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE,
+      )
+    }
+
+    val builder = NotificationCompat.Builder(context, CHANNEL_ID)
+      .setSmallIcon(smallIcon)
+      .setContentTitle(title)
+      .setContentText(body)
+      .setCategory(NotificationCompat.CATEGORY_MISSED_CALL)
+      .setPriority(NotificationCompat.PRIORITY_DEFAULT)
+      .setAutoCancel(true)
+      .setWhen(sentAt ?: System.currentTimeMillis())
+      .setShowWhen(true)
+    launch(ACTION_OPEN, 0)?.let(builder::setContentIntent)
+    launch(ACTION_CALL_BACK, 1)?.let { builder.addAction(0, "Call back", it) }
+
+    try {
+      NotificationManagerCompat.from(context).notify(id, builder.build())
+    } catch (e: SecurityException) {
+      Log.w(TAG, "missed-call notification refused (POST_NOTIFICATIONS?)", e)
+    }
+  }
+
+  /** Clear it once the user acted on it from the app (its buttons do not auto-cancel). */
+  fun cancel(context: Context, callId: String) {
+    runCatching { NotificationManagerCompat.from(context).cancel(notificationId(callId)) }
+  }
+
+  private fun notificationId(callId: String) = ("missed:$callId").hashCode()
+
+  private fun ensureChannel(context: Context) {
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.O) return
+    val manager = context.getSystemService(NotificationManager::class.java)
+    if (manager.getNotificationChannel(CHANNEL_ID) != null) return
+    manager.createNotificationChannel(
+      NotificationChannel(CHANNEL_ID, "Missed calls", NotificationManager.IMPORTANCE_DEFAULT).apply {
+        lockscreenVisibility = NotificationCompat.VISIBILITY_PRIVATE
+      },
+    )
+  }
+}

package/android/src/main/java/dev/poolse/callcore/android/SnapshotJson.kt

@@ -18,6 +18,8 @@ internal fun MachineState.toSnapshot(
   conversationName: String? = null,
   participants: List<Map<String, Any>> = emptyList(),
   audioRoute: String = "earpiece",
+  audioOutputs: List<Map<String, Any>> = emptyList(),
+  audioOutputId: String? = null,
   mutedSelf: Boolean = false,
   cameraOn: Boolean = false,
   cameraFacing: String? = null,
@@ -25,6 +27,8 @@ internal fun MachineState.toSnapshot(
   if (phase == Phase.IDLE) return null
   return buildMap {
     putAll(snapshotCore(conversationName, participants, audioRoute, mutedSelf, cameraOn))
+    put("audioOutputs", audioOutputs)
+    put("audioOutputId", audioOutputId)
     // Optional in the contract: present only while a camera is published.
     if (cameraFacing != null) put("cameraFacing", cameraFacing)
   }

package/android/src/main/java/expo/modules/poolsecalls/PoolseCallsModule.kt

@@ -8,6 +8,7 @@ import android.os.Build
 import android.provider.Settings
 import android.util.Log
 import dev.poolse.callcore.android.CallCore
+import dev.poolse.callcore.android.MissedCallNotification
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 
@@ -30,7 +31,7 @@ class PoolseCallsModule : Module() {
   override fun definition() = ModuleDefinition {
     Name("PoolseCalls")
 
-    Events("onCallState")
+    Events("onCallState", "onCallAction")
 
     // <CallVideoView>: renders a participant's (or our own) camera.
     View(PoolseCallVideoView::class) {
@@ -85,6 +86,7 @@ class PoolseCallsModule : Module() {
     Function("setCamera") { on: Boolean -> core()?.setCamera(on) }
     Function("switchCamera") { core()?.switchCamera() }
     Function("setSpeaker") { on: Boolean -> core()?.setSpeaker(on) }
+    Function("setAudioOutput") { id: String -> core()?.setAudioOutput(id) }
 
     // Socket forwarding (open app): idempotent with the FCM path.
     Function("onRingEnded") { callId: String, reason: String -> core()?.onRingEnded(callId, reason) }
@@ -92,6 +94,14 @@ class PoolseCallsModule : Module() {
       core()?.onCallFinished(callId, reason?.ifEmpty { null })
     }
 
+    // A missed-call notification's tap / Call back. Cold start: the
+    // launch intent still carries it — the host reads it once on mount.
+    // Running app: the tap arrives as a new intent.
+    Function("takeCallAction") { appContext.currentActivity?.intent?.let(::consumeCallAction) }
+    OnNewIntent { intent ->
+      consumeCallAction(intent)?.let { sendEvent("onCallAction", it) }
+    }
+
     // Android 14+: full-screen intents need a user grant for non-dialer apps.
     Function("canUseFullScreenIntent") {
       val ctx = context ?: return@Function true
@@ -129,6 +139,31 @@ class PoolseCallsModule : Module() {
 
   private fun core(): CallCore? = context?.let(CallCore::getOrNull)
 
+  /**
+   * The call action an intent carries, removed from it so a later read
+   * (rotation, re-mount) cannot replay it. Acting on it from the app
+   * clears its notification too: action buttons do not auto-cancel.
+   */
+  private fun consumeCallAction(intent: Intent): Map<String, Any?>? {
+    val action = intent.getStringExtra(MissedCallNotification.EXTRA_ACTION) ?: return null
+    val conversationId = intent.getStringExtra(MissedCallNotification.EXTRA_CONVERSATION_ID) ?: return null
+    val callId = intent.getStringExtra(MissedCallNotification.EXTRA_CALL_ID)
+    val media = intent.getStringExtra(MissedCallNotification.EXTRA_MEDIA) ?: "audio"
+    for (key in listOf(
+      MissedCallNotification.EXTRA_ACTION,
+      MissedCallNotification.EXTRA_CONVERSATION_ID,
+      MissedCallNotification.EXTRA_CALL_ID,
+      MissedCallNotification.EXTRA_MEDIA,
+    )) intent.removeExtra(key)
+    if (callId != null) context?.let { MissedCallNotification.cancel(it, callId) }
+    return mapOf(
+      "type" to action,
+      "conversationId" to conversationId,
+      "callId" to callId,
+      "media" to media,
+    )
+  }
+
   private companion object {
     const val TAG = "PoolseCalls"
   }

package/android/src/main/livekit/java/dev/poolse/callcore/livekit/LiveKitMediaPort.kt

@@ -8,6 +8,7 @@ import androidx.core.content.ContextCompat
 import com.twilio.audioswitch.AudioDevice
 import dev.poolse.callcore.CallSessionBundle
 import dev.poolse.callcore.MediaPort
+import dev.poolse.callcore.android.AudioOutput
 import dev.poolse.callcore.android.CallVideoSource
 import dev.poolse.callcore.android.CallVideoSurface
 import dev.poolse.callcore.android.MediaEvents
@@ -61,8 +62,15 @@ class LiveKitMediaPort(
   private var eventJob: Job? = null
   private var media: String = "audio"
 
-  /** Speaker forced by the user; null = the media-type default. */
-  private var speakerWanted: Boolean? = null
+  /**
+   * The user's output choice for the CURRENT call: an output id
+   * (`speaker`, `earpiece`, `wired`, `bluetooth`) or [PRIVATE] — the
+   * best private route. null = automatic (see [resolve]).
+   */
+  private var outputWanted: String? = null
+
+  /** The current room's last device list; a newcomer in it takes the call. */
+  private var knownDevices: List<AudioDevice>? = null
 
   /**
    * The user's mute / camera choices for the CURRENT call. They survive
@@ -149,7 +157,7 @@ class LiveKitMediaPort(
   private fun resetWanted() {
     mutedWanted = false
     cameraWanted = null
-    speakerWanted = null
+    outputWanted = null
   }
 
   /** Drop the current room only (a rejoin replaces it). */
@@ -256,7 +264,13 @@ class LiveKitMediaPort(
   }
 
   override fun setSpeaker(on: Boolean) {
-    speakerWanted = on
+    outputWanted = if (on) SPEAKER else PRIVATE
+    val handler = room?.audioHandler as? AudioSwitchHandler ?: return
+    applyRoute(handler)
+  }
+
+  override fun setAudioOutput(id: String) {
+    outputWanted = id
     val handler = room?.audioHandler as? AudioSwitchHandler ?: return
     applyRoute(handler)
   }
@@ -264,12 +278,13 @@ class LiveKitMediaPort(
   // ── audio routing ───────────────────────────────────────────────────
 
   /**
-   * A voice call is held to the ear: earpiece by default (a connected
-   * headset or Bluetooth device first); video defaults to the speaker.
-   * Set before connect — the handler starts during connect.
+   * Seed AudioSwitch's own order (it starts during connect, before any
+   * choice is applied): a connected headset or Bluetooth device first,
+   * then the earpiece for voice or the speaker for video.
    */
   private fun configureAudio(r: Room, video: Boolean) {
     val handler = r.audioHandler as? AudioSwitchHandler ?: return
+    knownDevices = null
     handler.preferredDeviceList = if (video) {
       listOf(
         AudioDevice.BluetoothHeadset::class.java,
@@ -285,31 +300,78 @@ class LiveKitMediaPort(
         AudioDevice.Speakerphone::class.java,
       )
     }
-    handler.audioDeviceChangeListener = { devices, selected ->
-      // A user's speaker choice survives device-list changes, except
-      // that plugging in a headset always wins (as the dialer does).
-      val wanted = speakerWanted
-      if (wanted != null && selected != null && room?.audioHandler === handler) {
-        val external = selected is AudioDevice.BluetoothHeadset || selected is AudioDevice.WiredHeadset
-        val isSpeaker = selected is AudioDevice.Speakerphone
-        if (!external && isSpeaker != wanted) devices.pick(wanted)?.let(handler::selectDevice)
-      }
-      events.onAudioRoute(routeOf(handler.selectedAudioDevice ?: selected))
+    handler.audioDeviceChangeListener = listener@{ devices, selected ->
+      if (room?.audioHandler !== handler) return@listener
+      // Putting on a headset or connecting Bluetooth mid-call moves the
+      // call to it, whatever was picked before — as the dialer does. The
+      // first list of a room is not "new": a choice made while
+      // connecting must survive it.
+      val known = knownDevices
+      if (known != null && devices.any { it.isExternal() && it !in known }) outputWanted = null
+      knownDevices = devices
+      val target = resolve(devices)
+      if (target != null && target != selected) handler.selectDevice(target)
+      report(handler, devices, handler.selectedAudioDevice ?: selected)
     }
   }
 
   private fun applyRoute(handler: AudioSwitchHandler) {
-    val want = speakerWanted ?: (media == "video")
-    handler.availableAudioDevices.pick(want)?.let(handler::selectDevice)
-    events.onAudioRoute(routeOf(handler.selectedAudioDevice))
+    val devices = handler.availableAudioDevices
+    resolve(devices)?.let { if (it != handler.selectedAudioDevice) handler.selectDevice(it) }
+    report(handler, devices, handler.selectedAudioDevice)
   }
 
-  /** Speaker, or the best private route: Bluetooth → wired → earpiece. */
-  private fun List<AudioDevice>.pick(speaker: Boolean): AudioDevice? =
-    if (speaker) firstOrNull { it is AudioDevice.Speakerphone }
-    else firstOrNull { it is AudioDevice.BluetoothHeadset }
-      ?: firstOrNull { it is AudioDevice.WiredHeadset }
-      ?: firstOrNull { it is AudioDevice.Earpiece }
+  /**
+   * Where the call should play. A chosen device while it is connected
+   * (it is forgotten once it goes); otherwise a connected headset or
+   * Bluetooth device, then the speaker for video or the earpiece for
+   * voice — never the speaker over earbuds the user put on.
+   */
+  private fun resolve(devices: List<AudioDevice>): AudioDevice? {
+    val wanted = outputWanted
+    if (wanted != null && wanted != PRIVATE) {
+      devices.firstOrNull { idOf(it) == wanted }?.let { return it }
+      outputWanted = null
+    }
+    val external = devices.firstOrNull { it is AudioDevice.BluetoothHeadset }
+      ?: devices.firstOrNull { it is AudioDevice.WiredHeadset }
+    val earpiece = devices.firstOrNull { it is AudioDevice.Earpiece }
+    val speaker = devices.firstOrNull { it is AudioDevice.Speakerphone }
+    return when {
+      external != null -> external
+      outputWanted == PRIVATE -> earpiece ?: speaker
+      media == "video" -> speaker ?: earpiece
+      else -> earpiece ?: speaker
+    }
+  }
+
+  private fun report(handler: AudioSwitchHandler, devices: List<AudioDevice>, selected: AudioDevice?) {
+    if (room?.audioHandler !== handler) return
+    events.onAudioRoute(routeOf(selected))
+    events.onAudioOutputs(
+      devices.map { AudioOutput(id = idOf(it), kind = routeOf(it), name = nameOf(it)) },
+      selected?.let(::idOf),
+    )
+  }
+
+  private fun AudioDevice.isExternal() =
+    this is AudioDevice.BluetoothHeadset || this is AudioDevice.WiredHeadset
+
+  private fun idOf(d: AudioDevice): String = when (d) {
+    is AudioDevice.Speakerphone -> SPEAKER
+    is AudioDevice.Earpiece -> "earpiece"
+    is AudioDevice.WiredHeadset -> "wired"
+    // AudioSwitch carries one Bluetooth device: the active headset.
+    is AudioDevice.BluetoothHeadset -> "bluetooth"
+  }
+
+  /** The Bluetooth device's own name; plain defaults for the rest. */
+  private fun nameOf(d: AudioDevice): String = when (d) {
+    is AudioDevice.Speakerphone -> "Speaker"
+    is AudioDevice.Earpiece -> "Phone"
+    is AudioDevice.WiredHeadset -> "Headphones"
+    is AudioDevice.BluetoothHeadset -> d.name.ifBlank { "Bluetooth" }
+  }
 
   private fun routeOf(d: AudioDevice?): String = when (d) {
     is AudioDevice.Speakerphone -> "speaker"
@@ -326,7 +388,7 @@ class LiveKitMediaPort(
       if (this.room !== room) return@collect
       when (event) {
         is RoomEvent.Connected -> {
-          (room.audioHandler as? AudioSwitchHandler)?.let { if (speakerWanted != null) applyRoute(it) }
+          (room.audioHandler as? AudioSwitchHandler)?.let(::applyRoute)
           events.onConnected()
           // Somebody may already be in (a late join, or a callee who
           // answered before our media came up): they will not "connect".
@@ -403,6 +465,8 @@ class LiveKitMediaPort(
   companion object {
     private const val TAG = "PoolseLiveKit"
     private const val SWITCH_SETTLE_MS = 600L
+    private const val SPEAKER = "speaker"
+    private const val PRIVATE = "private"
 
     /** Pass as `mediaFactory` in CallCoreConfig. */
     val factory: (Context, MediaEvents) -> MediaPort = { ctx, ev -> LiveKitMediaPort(ctx, ev) }

package/dist/index.cjs

@@ -31,10 +31,22 @@ var setMuted = (muted) => native?.setMuted(muted);
 var setCamera = (on) => native?.setCamera(on);
 var switchCamera = () => native?.switchCamera();
 var setSpeaker = (on) => native?.setSpeaker(on);
+function setAudioOutput(id) {
+  if (native?.setAudioOutput) native.setAudioOutput(id);
+  else native?.setSpeaker(id === "speaker");
+}
 var onRingEnded = (callId, reason) => native?.onRingEnded(callId, reason);
 var onCallFinished = (callId, reason) => native?.onCallFinished(callId, reason ?? null);
 var canUseFullScreenIntent = () => native?.canUseFullScreenIntent() ?? true;
 var openFullScreenIntentSettings = () => native?.openFullScreenIntentSettings();
+function takeCallAction() {
+  return native?.takeCallAction?.() ?? null;
+}
+function onCallAction(cb) {
+  if (!native || !native.takeCallAction) return () => void 0;
+  const sub = native.addListener("onCallAction", cb);
+  return () => sub.remove();
+}
 function getVoipToken() {
   return native?.getVoipToken?.() ?? null;
 }
@@ -75,15 +87,18 @@ exports.getVoipToken = getVoipToken;
 exports.hangUp = hangUp;
 exports.join = join;
 exports.nativeCallsAvailable = nativeCallsAvailable;
+exports.onCallAction = onCallAction;
 exports.onCallFinished = onCallFinished;
 exports.onCallState = onCallState;
 exports.onRingEnded = onRingEnded;
 exports.onVoipToken = onVoipToken;
 exports.openFullScreenIntentSettings = openFullScreenIntentSettings;
 exports.place = place;
+exports.setAudioOutput = setAudioOutput;
 exports.setCamera = setCamera;
 exports.setMuted = setMuted;
 exports.setSpeaker = setSpeaker;
 exports.switchCamera = switchCamera;
+exports.takeCallAction = takeCallAction;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["requireOptionalNativeModule","requireNativeViewManager","createElement","View"],"mappings":";;;;;;;AAoGA,IAAM,MAAA,GAASA,4CAA+C,aAAa,CAAA;AAGpE,IAAM,uBAAuB,MAAA,IAAU;AAG9C,eAAsB,SAAA,CAAU,YAAoB,OAAA,EAA2C;AAC7F,EAAA,MAAM,MAAA,EAAQ,SAAA,CAAU,UAAA,EAAY,OAAA,IAAW,IAAI,CAAA;AACrD;AAGO,SAAS,YAAA,GAAgC;AAC9C,EAAA,OAAO,MAAA,EAAQ,YAAA,EAAa,CAAE,QAAA,IAAY,IAAA;AAC5C;AAKO,SAAS,YAAY,EAAA,EAAsD;AAChF,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,MAAM,MAAA;AAC1B,EAAA,MAAM,GAAA,GAAM,OAAO,WAAA,CAAY,aAAA,EAAe,CAAC,OAAA,KAAY,EAAA,CAAG,OAAA,CAAQ,QAAQ,CAAC,CAAA;AAC/E,EAAA,OAAO,MAAM,IAAI,MAAA,EAAO;AAC1B;AAEO,SAAS,KAAA,CAAM,gBAAwB,OAAA,EAAsC;AAClF,EAAA,OAAO,MAAA,EAAQ,MAAM,cAAA,EAAgB,OAAA,CAAQ,OAAO,OAAA,CAAQ,YAAY,CAAA,IAAK,OAAA,CAAQ,OAAA,EAAQ;AAC/F;AAEO,SAAS,IAAA,CACd,MAAA,EACA,cAAA,EACA,YAAA,EACe;AACf,EAAA,OAAO,QAAQ,IAAA,CAAK,MAAA,EAAQ,gBAAgB,YAAY,CAAA,IAAK,QAAQ,OAAA,EAAQ;AAC/E;AAEO,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,OAAA,GAAU,MAAY,MAAA,EAAQ,OAAA;AACpC,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,QAAA,GAAW,CAAC,KAAA,KAAyB,MAAA,EAAQ,SAAS,KAAK;AACjE,IAAM,SAAA,GAAY,CAAC,EAAA,KAAsB,MAAA,EAAQ,UAAU,EAAE;AAC7D,IAAM,YAAA,GAAe,MAAY,MAAA,EAAQ,YAAA;AAEzC,IAAM,UAAA,GAAa,CAAC,EAAA,KAAsB,MAAA,EAAQ,WAAW,EAAE;AAM/D,IAAM,cAAc,CAAC,MAAA,EAAgB,WAC1C,MAAA,EAAQ,WAAA,CAAY,QAAQ,MAAM;AAQ7B,IAAM,cAAA,GAAiB,CAAC,MAAA,EAAgB,MAAA,KAC7C,QAAQ,cAAA,CAAe,MAAA,EAAQ,UAAU,IAAI;AAMxC,IAAM,sBAAA,GAAyB,MAAe,MAAA,EAAQ,sBAAA,EAAuB,IAAK;AAGlF,IAAM,4BAAA,GAA+B,MAAY,MAAA,EAAQ,4BAAA;AAQzD,SAAS,YAAA,GAAiC;AAC/C,EAAA,OAAO,MAAA,EAAQ,gBAAe,IAAK,IAAA;AACrC;AAGO,SAAS,YAAY,EAAA,EAA6C;AACvE,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,MAAA,CAAO,YAAA,SAAqB,MAAM,MAAA;AAClD,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,WAAA,CAAY,aAAA,EAAe,EAAE,CAAA;AAChD,EAAA,OAAO,MAAM,IAAI,MAAA,EAAO;AAC1B;AAgBA,IAAI,WAAA;AAGJ,SAAS,eAAA,GAA0D;AACjE,EAAA,IAAI,WAAA,KAAgB,QAAW,OAAO,WAAA;AACtC,EAAA,WAAA,GAAc,IAAA;AACd,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,IAAI;AACF,MAAA,WAAA,GAAcC,wCAAA,CAA2C,eAAe,iBAAiB,CAAA;AAAA,IAC3F,CAAA,CAAA,MAAQ;AACN,MAAA,WAAA,GAAc,IAAA;AAAA,IAChB;AAAA,EACF;AACA,EAAA,OAAO,WAAA;AACT;AAQO,SAAS,cAAc,KAAA,EAAgD;AAC5E,EAAA,MAAM,SAAS,eAAA,EAAgB;AAC/B,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,EAAE,aAAA,EAAe,EAAA,EAAI,KAAA,EAAO,EAAA,EAAI,MAAA,EAAQ,EAAA,EAAI,GAAA,EAAK,EAAA,EAAI,GAAG,IAAA,EAAK,GAAI,KAAA;AACvE,IAAA,OAAOC,mBAAA,CAAcC,kBAAM,IAAI,CAAA;AAAA,EACjC;AACA,EAAA,OAAOD,mBAAA,CAAc,QAAQ,KAAK,CAAA;AACpC","file":"index.cjs","sourcesContent":["// @poolse/react-native-calls — the React Native face of the native\n// call core (CONTRACT.md §8). A thin, typed surface over the native\n// module: commands in, one snapshot event out. All call logic lives in\n// the native cores; nothing here decides anything about a call.\n//\n// On a platform or build without the native module (Expo Go, web,\n// unlinked), every command is a safe no-op and the state stays idle —\n// so a host can render against this unconditionally.\nimport { createElement, type ComponentType, type ReactElement } from 'react';\nimport { View, type ViewProps } from 'react-native';\nimport { requireNativeViewManager, requireOptionalNativeModule } from 'expo-modules-core';\n\n/**\n * A call's complete state. `null` means idle — no call. After a call\n * ends the snapshot stays `phase: 'ended'` (with `reason`) for ~2.5 s,\n * then becomes `null`.\n */\nexport interface Snapshot {\n  cv: 1;\n  callId: string;\n  conversationId: string;\n  conversationName: string | null;\n  direction: 'incoming' | 'outgoing' | 'joined';\n  media: 'audio' | 'video';\n  phase: 'ringing_in' | 'ringing_out' | 'connecting' | 'active' | 'reconnecting' | 'ended';\n  reason?:\n    | 'left'\n    | 'finished'\n    | 'declined_all'\n    | 'busy_all'\n    | 'no_answer'\n    | 'cancelled'\n    | 'connection_lost'\n    | 'failed';\n  /** REMOTE participants only; `userId` is the LiveKit identity. */\n  participants: Array<{\n    userId: string;\n    externalId: string;\n    speaking: boolean;\n    muted: boolean;\n    /** True only with a published, subscribed, unmuted camera track (show video, not avatar). */\n    cameraOn: boolean;\n  }>;\n  audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';\n  mutedSelf: boolean;\n  /** True only while the local camera track is actually published and enabled. */\n  cameraOn: boolean;\n  /** Facing of the published local camera; absent when the camera is off. */\n  cameraFacing?: 'front' | 'back';\n}\n\nexport interface ConfigureOptions {\n  /** Drawable resource NAME for the call notification's small icon. */\n  smallIcon?: string;\n  /** Ringback tone: raw resource NAME (Android); main-bundle sound name, mp3/caf/wav (iOS). */\n  ringback?: string;\n  /**\n   * iOS: the APNs environment of this build's `aps-environment`\n   * entitlement. Echoed back with the VoIP token so the server pushes to\n   * the right gateway. Ignored on Android.\n   */\n  apnsEnvironment?: 'production' | 'sandbox';\n}\n\n/** The iOS PushKit (VoIP) token and the APNs environment it belongs to. */\nexport interface VoipToken {\n  /** Hex-encoded PushKit token. */\n  token: string;\n  environment: 'production' | 'sandbox' | string;\n}\n\nexport interface PlaceOptions {\n  media: 'audio' | 'video';\n  /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */\n  sessionToken: string;\n}\n\ntype NativeSnapshot = { snapshot: Snapshot | null };\n\ninterface PoolseCallsNative {\n  configure(apiBaseUrl: string, options: ConfigureOptions | null): Promise<void>;\n  getCallState(): NativeSnapshot;\n  place(conversationId: string, media: string, sessionToken: string): Promise<void>;\n  join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;\n  answer(): void;\n  decline(): void;\n  hangUp(): void;\n  setMuted(muted: boolean): void;\n  setCamera(on: boolean): void;\n  switchCamera(): void;\n  setSpeaker(on: boolean): void;\n  onRingEnded(callId: string, reason: string): void;\n  onCallFinished(callId: string, reason: string | null): void;\n  canUseFullScreenIntent(): boolean;\n  openFullScreenIntentSettings(): void;\n  getVoipToken?(): VoipToken | null;\n  addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => void): { remove(): void };\n  addListener(event: 'onVoipToken', cb: (payload: VoipToken) => void): { remove(): void };\n}\n\nconst native = requireOptionalNativeModule<PoolseCallsNative>('PoolseCalls');\n\n/** True when the native call core is present in this build. */\nexport const nativeCallsAvailable = native != null;\n\n/** Configure once, before any call can arrive. No secrets — just the API origin. */\nexport async function configure(apiBaseUrl: string, options?: ConfigureOptions): Promise<void> {\n  await native?.configure(apiBaseUrl, options ?? null);\n}\n\n/** The current snapshot — safe to read at any moment, including cold answer and before configure. */\nexport function getCallState(): Snapshot | null {\n  return native?.getCallState().snapshot ?? null;\n}\n\nexport type Unsubscribe = () => void;\n\n/** Subscribe to call state. Fires a full snapshot on every change. */\nexport function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe {\n  if (!native) return () => undefined;\n  const sub = native.addListener('onCallState', (payload) => cb(payload.snapshot));\n  return () => sub.remove();\n}\n\nexport function place(conversationId: string, options: PlaceOptions): Promise<void> {\n  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();\n}\n\nexport function join(\n  callId: string,\n  conversationId: string | null,\n  sessionToken: string,\n): Promise<void> {\n  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();\n}\n\nexport const answer = (): void => native?.answer();\nexport const decline = (): void => native?.decline();\nexport const hangUp = (): void => native?.hangUp();\nexport const setMuted = (muted: boolean): void => native?.setMuted(muted);\nexport const setCamera = (on: boolean): void => native?.setCamera(on);\nexport const switchCamera = (): void => native?.switchCamera();\n/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */\nexport const setSpeaker = (on: boolean): void => native?.setSpeaker(on);\n\n/**\n * Socket forwarding for an open app: a `call:ring_ended` seen on the\n * socket. Idempotent with the push path — the core dedupes.\n */\nexport const onRingEnded = (callId: string, reason: string): void =>\n  native?.onRingEnded(callId, reason);\n\n/**\n * Socket forwarding: `call:finished`. Pass the payload's `reason`\n * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an\n * unanswered caller sees \"Declined\"/\"No answer\", not \"Call ended\".\n * Idempotent with the `finished` push.\n */\nexport const onCallFinished = (callId: string, reason?: string): void =>\n  native?.onCallFinished(callId, reason ?? null);\n\n/**\n * Android 14+: whether the app may show the full-screen ring over the\n * lock screen. `true` on older Android and where the module is absent.\n */\nexport const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenIntent() ?? true;\n\n/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */\nexport const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();\n\n// ── VoIP push (iOS) ───────────────────────────────────────────────────\n\n/**\n * iOS: the current PushKit VoIP token, registered natively at launch.\n * `null` until iOS issues one, and always on Android (FCM carries rings).\n */\nexport function getVoipToken(): VoipToken | null {\n  return native?.getVoipToken?.() ?? null;\n}\n\n/** iOS: fires whenever PushKit issues (or rotates) the VoIP token. No-op on Android. */\nexport function onVoipToken(cb: (token: VoipToken) => void): Unsubscribe {\n  if (!native || !native.getVoipToken) return () => undefined;\n  const sub = native.addListener('onVoipToken', cb);\n  return () => sub.remove();\n}\n\n// ── video ─────────────────────────────────────────────────────────────\n\nexport interface CallVideoViewProps extends ViewProps {\n  /** Remote participant's userId (LiveKit identity). Omit with local=true for self view. */\n  participantId?: string;\n  local?: boolean;\n  /** default: true for local front camera, false otherwise */\n  mirror?: boolean;\n  /** default 'cover' */\n  fit?: 'cover' | 'contain';\n}\n\ntype NativeVideoProps = CallVideoViewProps;\n\nlet nativeVideo: ComponentType<NativeVideoProps> | null | undefined;\n\n/** Resolved lazily (first render) and only when the native module exists. */\nfunction nativeVideoView(): ComponentType<NativeVideoProps> | null {\n  if (nativeVideo !== undefined) return nativeVideo;\n  nativeVideo = null;\n  if (native) {\n    try {\n      nativeVideo = requireNativeViewManager<NativeVideoProps>('PoolseCalls', 'PoolseCallVideo');\n    } catch {\n      nativeVideo = null; // an older native build without the view\n    }\n  }\n  return nativeVideo;\n}\n\n/**\n * A participant's camera (or, with `local`, your own), rendered natively\n * by the call core. Shows nothing (stays transparent) while that camera\n * is off — draw the avatar from the snapshot's `cameraOn` underneath.\n * Without the native module it renders an empty View.\n */\nexport function CallVideoView(props: CallVideoViewProps): ReactElement | null {\n  const Native = nativeVideoView();\n  if (!Native) {\n    const { participantId: _p, local: _l, mirror: _m, fit: _f, ...rest } = props;\n    return createElement(View, rest);\n  }\n  return createElement(Native, props);\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["requireOptionalNativeModule","requireNativeViewManager","createElement","View"],"mappings":"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","file":"index.cjs","sourcesContent":["// @poolse/react-native-calls — the React Native face of the native\n// call core (CONTRACT.md §8). A thin, typed surface over the native\n// module: commands in, one snapshot event out. All call logic lives in\n// the native cores; nothing here decides anything about a call.\n//\n// On a platform or build without the native module (Expo Go, web,\n// unlinked), every command is a safe no-op and the state stays idle —\n// so a host can render against this unconditionally.\nimport { createElement, type ComponentType, type ReactElement } from 'react';\nimport { View, type ViewProps } from 'react-native';\nimport { requireNativeViewManager, requireOptionalNativeModule } from 'expo-modules-core';\n\n/**\n * A call's complete state. `null` means idle — no call. After a call\n * ends the snapshot stays `phase: 'ended'` (with `reason`) for ~2.5 s,\n * then becomes `null`.\n */\nexport interface Snapshot {\n  cv: 1;\n  callId: string;\n  conversationId: string;\n  conversationName: string | null;\n  direction: 'incoming' | 'outgoing' | 'joined';\n  media: 'audio' | 'video';\n  phase: 'ringing_in' | 'ringing_out' | 'connecting' | 'active' | 'reconnecting' | 'ended';\n  reason?:\n    | 'left'\n    | 'finished'\n    | 'declined_all'\n    | 'busy_all'\n    | 'no_answer'\n    | 'cancelled'\n    | 'connection_lost'\n    | 'failed';\n  /** REMOTE participants only; `userId` is the LiveKit identity. */\n  participants: Array<{\n    userId: string;\n    externalId: string;\n    speaking: boolean;\n    muted: boolean;\n    /** True only with a published, subscribed, unmuted camera track (show video, not avatar). */\n    cameraOn: boolean;\n  }>;\n  /** The kind of output playing now — the short answer to \"where is the audio\". */\n  audioRoute: AudioOutputKind;\n  /**\n   * Every output the call can play through right now: always the phone\n   * (earpiece, or wired headphones in its place) and the speaker, plus\n   * each connected Bluetooth / USB device by its own name. Empty until\n   * the call's audio is up. Pass an `id` to `setAudioOutput`.\n   */\n  audioOutputs: AudioOutput[];\n  /** The `audioOutputs` entry playing now; null before audio is up. */\n  audioOutputId: string | null;\n  mutedSelf: boolean;\n  /** True only while the local camera track is actually published and enabled. */\n  cameraOn: boolean;\n  /** Facing of the published local camera; absent when the camera is off. */\n  cameraFacing?: 'front' | 'back';\n}\n\nexport type AudioOutputKind = 'earpiece' | 'speaker' | 'bluetooth' | 'headset';\n\n/** One place call audio can play. */\nexport interface AudioOutput {\n  /** Opaque; stable while the device stays connected. */\n  id: string;\n  kind: AudioOutputKind;\n  /**\n   * The device's own name for Bluetooth/USB (\"AirPods Pro\"); a plain\n   * English default for built-ins (\"iPhone\"/\"Phone\", \"Speaker\",\n   * \"Headphones\") — relabel those by `kind` to localise.\n   */\n  name: string;\n}\n\nexport interface ConfigureOptions {\n  /** Drawable resource NAME for the call notification's small icon. */\n  smallIcon?: string;\n  /** Ringback tone: raw resource NAME (Android); main-bundle sound name, mp3/caf/wav (iOS). */\n  ringback?: string;\n  /**\n   * iOS: the APNs environment of this build's `aps-environment`\n   * entitlement. Echoed back with the VoIP token so the server pushes to\n   * the right gateway. Ignored on Android.\n   */\n  apnsEnvironment?: 'production' | 'sandbox';\n}\n\n/** The iOS PushKit (VoIP) token and the APNs environment it belongs to. */\nexport interface VoipToken {\n  /** Hex-encoded PushKit token. */\n  token: string;\n  environment: 'production' | 'sandbox' | string;\n}\n\nexport interface PlaceOptions {\n  media: 'audio' | 'video';\n  /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */\n  sessionToken: string;\n}\n\n/**\n * What the user tapped on a missed-call notification: the notification\n * itself (`open` the conversation) or its Call back button (`call_back`\n * — place a call on the conversation with `media`).\n */\nexport interface CallAction {\n  type: 'open' | 'call_back';\n  conversationId: string;\n  callId: string | null;\n  media: 'audio' | 'video';\n}\n\ntype NativeSnapshot = { snapshot: Snapshot | null };\n\ninterface PoolseCallsNative {\n  configure(apiBaseUrl: string, options: ConfigureOptions | null): Promise<void>;\n  getCallState(): NativeSnapshot;\n  place(conversationId: string, media: string, sessionToken: string): Promise<void>;\n  join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;\n  answer(): void;\n  decline(): void;\n  hangUp(): void;\n  setMuted(muted: boolean): void;\n  setCamera(on: boolean): void;\n  switchCamera(): void;\n  setSpeaker(on: boolean): void;\n  setAudioOutput?(id: string): void;\n  onRingEnded(callId: string, reason: string): void;\n  onCallFinished(callId: string, reason: string | null): void;\n  canUseFullScreenIntent(): boolean;\n  openFullScreenIntentSettings(): void;\n  getVoipToken?(): VoipToken | null;\n  takeCallAction?(): CallAction | null;\n  addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => void): { remove(): void };\n  addListener(event: 'onVoipToken', cb: (payload: VoipToken) => void): { remove(): void };\n  addListener(event: 'onCallAction', cb: (payload: CallAction) => void): { remove(): void };\n}\n\nconst native = requireOptionalNativeModule<PoolseCallsNative>('PoolseCalls');\n\n/** True when the native call core is present in this build. */\nexport const nativeCallsAvailable = native != null;\n\n/** Configure once, before any call can arrive. No secrets — just the API origin. */\nexport async function configure(apiBaseUrl: string, options?: ConfigureOptions): Promise<void> {\n  await native?.configure(apiBaseUrl, options ?? null);\n}\n\n/** The current snapshot — safe to read at any moment, including cold answer and before configure. */\nexport function getCallState(): Snapshot | null {\n  return native?.getCallState().snapshot ?? null;\n}\n\nexport type Unsubscribe = () => void;\n\n/** Subscribe to call state. Fires a full snapshot on every change. */\nexport function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe {\n  if (!native) return () => undefined;\n  const sub = native.addListener('onCallState', (payload) => cb(payload.snapshot));\n  return () => sub.remove();\n}\n\nexport function place(conversationId: string, options: PlaceOptions): Promise<void> {\n  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();\n}\n\nexport function join(\n  callId: string,\n  conversationId: string | null,\n  sessionToken: string,\n): Promise<void> {\n  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();\n}\n\nexport const answer = (): void => native?.answer();\nexport const decline = (): void => native?.decline();\nexport const hangUp = (): void => native?.hangUp();\nexport const setMuted = (muted: boolean): void => native?.setMuted(muted);\nexport const setCamera = (on: boolean): void => native?.setCamera(on);\nexport const switchCamera = (): void => native?.switchCamera();\n/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */\nexport const setSpeaker = (on: boolean): void => native?.setSpeaker(on);\n\n/**\n * Play call audio through one of `snapshot.audioOutputs`. The choice\n * holds for the rest of the call, until that device disconnects or a new\n * headset / Bluetooth device connects (which takes over, as in the\n * phone's own dialer). Without a choice a connected headset wins, then\n * the earpiece for voice calls or the speaker for video.\n */\nexport function setAudioOutput(id: string): void {\n  if (native?.setAudioOutput) native.setAudioOutput(id);\n  else native?.setSpeaker(id === 'speaker'); // an older native build\n}\n\n/**\n * Socket forwarding for an open app: a `call:ring_ended` seen on the\n * socket. Idempotent with the push path — the core dedupes.\n */\nexport const onRingEnded = (callId: string, reason: string): void =>\n  native?.onRingEnded(callId, reason);\n\n/**\n * Socket forwarding: `call:finished`. Pass the payload's `reason`\n * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an\n * unanswered caller sees \"Declined\"/\"No answer\", not \"Call ended\".\n * Idempotent with the `finished` push.\n */\nexport const onCallFinished = (callId: string, reason?: string): void =>\n  native?.onCallFinished(callId, reason ?? null);\n\n/**\n * Android 14+: whether the app may show the full-screen ring over the\n * lock screen. `true` on older Android and where the module is absent.\n */\nexport const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenIntent() ?? true;\n\n/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */\nexport const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();\n\n// ── missed-call notifications (Android) ─────────────────────────────────\n\n/**\n * Android: the missed-call notification action the app was LAUNCHED\n * with, once — read it on mount. `null` when the app opened any other\n * way. The native core posts that notification itself from the push,\n * so it works with the app closed.\n *\n * iOS shows missed calls as an ordinary alert push (to the token you\n * register with `kind: 'alert'`); read its taps with your notification\n * library — its `type` is `call_missed`, the category\n * `poolse_missed_call`, the Call back action `call_back`.\n */\nexport function takeCallAction(): CallAction | null {\n  return native?.takeCallAction?.() ?? null;\n}\n\n/** Android: a missed-call notification tapped while the app is running. */\nexport function onCallAction(cb: (action: CallAction) => void): Unsubscribe {\n  if (!native || !native.takeCallAction) return () => undefined;\n  const sub = native.addListener('onCallAction', cb);\n  return () => sub.remove();\n}\n\n// ── VoIP push (iOS) ───────────────────────────────────────────────────\n\n/**\n * iOS: the current PushKit VoIP token, registered natively at launch.\n * `null` until iOS issues one, and always on Android (FCM carries rings).\n */\nexport function getVoipToken(): VoipToken | null {\n  return native?.getVoipToken?.() ?? null;\n}\n\n/** iOS: fires whenever PushKit issues (or rotates) the VoIP token. No-op on Android. */\nexport function onVoipToken(cb: (token: VoipToken) => void): Unsubscribe {\n  if (!native || !native.getVoipToken) return () => undefined;\n  const sub = native.addListener('onVoipToken', cb);\n  return () => sub.remove();\n}\n\n// ── video ─────────────────────────────────────────────────────────────\n\nexport interface CallVideoViewProps extends ViewProps {\n  /** Remote participant's userId (LiveKit identity). Omit with local=true for self view. */\n  participantId?: string;\n  local?: boolean;\n  /** default: true for local front camera, false otherwise */\n  mirror?: boolean;\n  /** default 'cover' */\n  fit?: 'cover' | 'contain';\n}\n\ntype NativeVideoProps = CallVideoViewProps;\n\nlet nativeVideo: ComponentType<NativeVideoProps> | null | undefined;\n\n/** Resolved lazily (first render) and only when the native module exists. */\nfunction nativeVideoView(): ComponentType<NativeVideoProps> | null {\n  if (nativeVideo !== undefined) return nativeVideo;\n  nativeVideo = null;\n  if (native) {\n    try {\n      nativeVideo = requireNativeViewManager<NativeVideoProps>('PoolseCalls', 'PoolseCallVideo');\n    } catch {\n      nativeVideo = null; // an older native build without the view\n    }\n  }\n  return nativeVideo;\n}\n\n/**\n * A participant's camera (or, with `local`, your own), rendered natively\n * by the call core. Shows nothing (stays transparent) while that camera\n * is off — draw the avatar from the snapshot's `cameraOn` underneath.\n * Without the native module it renders an empty View.\n */\nexport function CallVideoView(props: CallVideoViewProps): ReactElement | null {\n  const Native = nativeVideoView();\n  if (!Native) {\n    const { participantId: _p, local: _l, mirror: _m, fit: _f, ...rest } = props;\n    return createElement(View, rest);\n  }\n  return createElement(Native, props);\n}\n"]}