@poolse/react-native-calls 0.6.0 → 0.7.0

package/README.md

@@ -14,9 +14,11 @@ can render against it unconditionally.
 import * as calls from '@poolse/react-native-calls';
 
 await calls.configure('https://api.poolse.dev', { smallIcon: 'ic_call', ringback: 'ringback' });
-const stop = calls.onCallState((s) => render(s));   // s: Snapshot | null
+const stop = calls.onCallState((s) => render(s)); // s: Snapshot | null
 await calls.place(conversationId, { media: 'audio', sessionToken });
-calls.answer(); calls.decline(); calls.hangUp();
+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.
@@ -24,7 +26,38 @@ calls.setAudioOutput(s.audioOutputs[0].id);
 calls.setSpeaker(true); // the one-tap toggle, still there
 ```
 
+### Chat notifications
+
+poolse sends message notifications itself, with the push credentials you
+set up for calls. Register the devices (Android: the FCM token; iOS: the
+regular APNs token with `kind: 'alert'`, beside the VoIP one), and the
+core does the rest — one notification per conversation with every
+message a line in it, Reply and Mark as read straight from the
+notification (no app, no session), cleared when the chat is read on
+another device. Requires `expo-notifications` (a peer dependency).
+
+```ts
+calls.setActiveConversation(conversationId); // on screen: don't notify it
+calls.setActiveConversation(null); // left it, or app backgrounded
+
+// iOS, in your expo-notifications handler:
+Notifications.setNotificationHandler({
+  handleNotification: async (n) => {
+    const show = calls.shouldPresentMessage(n.request.content.data);
+    return {
+      shouldShowBanner: show,
+      shouldShowList: show,
+      shouldPlaySound: show,
+      shouldSetBadge: true,
+    };
+  },
+});
+// A tap opens the app: calls.conversationOfNotification(data) (iOS), or
+// takeCallAction()/onCallAction() with type 'open' (Android).
+```
+
 ## Layout
+
 - `src/` — the TypeScript API (this is what apps import).
 - `android/src/main/java/dev/poolse/callcore/` — the pure state machine
   and ports (contract cv 1).

package/android/src/main/AndroidManifest.xml

@@ -26,6 +26,10 @@
       android:name="dev.poolse.callcore.android.CallActionReceiver"
       android:exported="false" />
 
+    <receiver
+      android:name="dev.poolse.callcore.android.MessageActionReceiver"
+      android:exported="false" />
+
     <service
       android:name="dev.poolse.callcore.android.CallForegroundService"
       android:exported="false"

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

@@ -384,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 API origin (restored from disk on a cold start), or null. */
+    fun apiBaseUrl(context: Context): String? {
+      if (config == null) restoreConfig(context.applicationContext)
+      return config?.apiBaseUrl?.ifEmpty { null }
+    }
+
     /** The configured notification icon (restored from disk on a cold start). */
     fun smallIcon(context: Context): Int {
       if (config == null) restoreConfig(context.applicationContext)

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

@@ -35,6 +35,17 @@ class CallMessagingService : FirebaseMessagingService() {
     // type=call_event so old JS Android builds — which ring on ANY
     // type=call — ignore them. Everything else belongs to the host.
     val type = data["type"]
+    if (type == "message") {
+      // Chat notifications (§5.5): posted here so they appear with the
+      // app killed, grouped per conversation.
+      if (CallCore.getOrNull(this) == null) return
+      val conversationId = data["conversation_id"] ?: return
+      when (data["event"]) {
+        "new" -> MessageNotifications.onNew(this, data, CallCore.smallIcon(this))
+        "read" -> MessageNotifications.clear(this, conversationId)
+      }
+      return
+    }
     if (type != "call" && type != "call_event") {
       forwardToHost { it.onMessageReceived(message) }
       return

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

@@ -0,0 +1,340 @@
+package dev.poolse.callcore.android
+
+import android.app.NotificationChannel
+import android.app.NotificationManager
+import android.app.PendingIntent
+import android.content.BroadcastReceiver
+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
+import androidx.core.app.Person
+import androidx.core.app.RemoteInput
+import okhttp3.MediaType.Companion.toMediaType
+import okhttp3.Request
+import okhttp3.RequestBody.Companion.toRequestBody
+import org.json.JSONArray
+import org.json.JSONObject
+import java.util.UUID
+
+/**
+ * Chat notifications on Android (CONTRACT.md §5.5), WhatsApp-style.
+ *
+ * One notification per conversation, in MessagingStyle: each new message
+ * becomes a line in it ("Ana: on my way") rather than a new card, and a
+ * group summary collects every chat. Reply (inline text) and Mark as
+ * read run natively, authorized by the reply grant the push carried, so
+ * they work with the app killed and the phone locked.
+ *
+ * Android cannot read back the lines of a posted notification, so the
+ * last few lines per conversation are kept in a small preferences file
+ * and the notification is rebuilt from them on every message. They are
+ * dropped the moment the conversation is read, here or elsewhere.
+ */
+object MessageNotifications {
+  const val CHANNEL_ID = "poolse_messages"
+  private const val GROUP_KEY = "dev.poolse.messages"
+  private const val SUMMARY_ID = 0x504F4F4C // "POOL"
+  private const val PREFS = "dev.poolse.messages"
+  private const val MAX_LINES = 7
+  internal const val KEY_REPLY = "poolse_reply_text"
+  internal const val ACTION_REPLY = "dev.poolse.callcore.message.REPLY"
+  internal const val ACTION_READ = "dev.poolse.callcore.message.READ"
+  internal const val EXTRA_CONVERSATION = "poolse_message_conversation"
+  private const val TAG = "PoolseMessages"
+
+  // A message notification that waited this long for the phone to come
+  // online is history.
+  private const val STALE_MS = 24 * 60 * 60 * 1000L
+
+  /**
+   * The conversation on screen in the app, set by the host. Its messages
+   * are not notified — the user is reading them.
+   */
+  @Volatile var activeConversationId: String? = null
+
+  /** A `type: "message", event: "new"` push. */
+  fun onNew(context: Context, data: Map<String, String>, smallIcon: Int) {
+    val conversationId = data["conversation_id"] ?: return
+    if (conversationId == activeConversationId) return
+    val sentAt = data["sent_at"]?.toLongOrNull() ?: System.currentTimeMillis()
+    if (System.currentTimeMillis() - sentAt > STALE_MS) return
+
+    val state = load(context, conversationId) ?: Conversation(conversationId)
+    state.title = data["conversation_name"]?.ifBlank { null } ?: state.title
+    state.group = data["group"] == "1"
+    data["reply_grant"]?.ifBlank { null }?.let { state.grant = it }
+    val messageId = data["message_id"]
+    if (messageId == null || state.lines.none { it.id == messageId }) {
+      state.lines += Line(
+        id = messageId,
+        sender = data["sender_name"]?.ifBlank { null } ?: "Someone",
+        senderKey = data["sender_user_id"],
+        text = data["text"] ?: "",
+        at = sentAt,
+        self = false,
+      )
+      while (state.lines.size > MAX_LINES) state.lines.removeAt(0)
+    }
+    save(context, state)
+    post(context, state, smallIcon, alert = true)
+  }
+
+  /** The conversation was read (here, or on another device): clear it. */
+  fun clear(context: Context, conversationId: String) {
+    prefs(context).edit().remove(key(conversationId)).apply()
+    runCatching { NotificationManagerCompat.from(context).cancel(notificationId(conversationId)) }
+    refreshSummary(context, CallCore.smallIcon(context))
+  }
+
+  /** The reply went through: show it as the user's line and stop the spinner. */
+  internal fun onReplied(context: Context, conversationId: String, text: String, ok: Boolean) {
+    val state = load(context, conversationId) ?: return
+    state.lines += Line(
+      id = null,
+      sender = "You",
+      senderKey = null,
+      text = if (ok) text else "Not sent: $text",
+      at = System.currentTimeMillis(),
+      self = true,
+    )
+    while (state.lines.size > MAX_LINES) state.lines.removeAt(0)
+    save(context, state)
+    post(context, state, CallCore.smallIcon(context), alert = false)
+  }
+
+  internal fun grantFor(context: Context, conversationId: String): String? =
+    load(context, conversationId)?.grant
+
+  // ── building ────────────────────────────────────────────────────────
+
+  private fun post(context: Context, state: Conversation, smallIcon: Int, alert: Boolean) {
+    ensureChannel(context)
+    val me = Person.Builder().setName("You").build()
+    val style = NotificationCompat.MessagingStyle(me)
+      .setGroupConversation(state.group)
+    if (state.group) style.conversationTitle = state.title
+    for (line in state.lines) {
+      val person = if (line.self) null else Person.Builder().setName(line.sender).setKey(line.senderKey).build()
+      style.addMessage(NotificationCompat.MessagingStyle.Message(line.text, line.at, person))
+    }
+
+    val id = notificationId(state.id)
+    val builder = NotificationCompat.Builder(context, CHANNEL_ID)
+      .setSmallIcon(smallIcon)
+      .setStyle(style)
+      .setCategory(NotificationCompat.CATEGORY_MESSAGE)
+      .setPriority(NotificationCompat.PRIORITY_HIGH)
+      .setGroup(GROUP_KEY)
+      .setAutoCancel(true)
+      .setOnlyAlertOnce(!alert)
+      .setWhen(state.lines.lastOrNull()?.at ?: System.currentTimeMillis())
+      .setNumber(state.lines.count { !it.self })
+    openIntent(context, state.id, id)?.let(builder::setContentIntent)
+
+    if (state.grant != null) {
+      val remoteInput = RemoteInput.Builder(KEY_REPLY).setLabel("Message").build()
+      val reply = NotificationCompat.Action.Builder(0, "Reply", actionIntent(context, ACTION_REPLY, state.id, id + 1, mutable = true))
+        .addRemoteInput(remoteInput)
+        .setAllowGeneratedReplies(true)
+        .setSemanticAction(NotificationCompat.Action.SEMANTIC_ACTION_REPLY)
+        .setShowsUserInterface(false)
+        .build()
+      val read = NotificationCompat.Action.Builder(0, "Mark as read", actionIntent(context, ACTION_READ, state.id, id + 2, mutable = false))
+        .setSemanticAction(NotificationCompat.Action.SEMANTIC_ACTION_MARK_AS_READ)
+        .setShowsUserInterface(false)
+        .build()
+      builder.addAction(reply).addAction(read)
+    }
+
+    try {
+      NotificationManagerCompat.from(context).notify(id, builder.build())
+    } catch (e: SecurityException) {
+      Log.w(TAG, "message notification refused (POST_NOTIFICATIONS?)", e)
+      return
+    }
+    refreshSummary(context, smallIcon)
+  }
+
+  /** The group's summary: "5 messages from 2 chats". Gone with the last chat. */
+  private fun refreshSummary(context: Context, smallIcon: Int) {
+    val all = prefs(context).all.keys.filter { it.startsWith("conv:") }
+      .mapNotNull { load(context, it.removePrefix("conv:")) }
+    val manager = NotificationManagerCompat.from(context)
+    if (all.isEmpty()) {
+      runCatching { manager.cancel(SUMMARY_ID) }
+      return
+    }
+    val messages = all.sumOf { c -> c.lines.count { !it.self } }
+    val text = if (all.size == 1) "$messages new messages" else "$messages messages from ${all.size} chats"
+    val summary = NotificationCompat.Builder(context, CHANNEL_ID)
+      .setSmallIcon(smallIcon)
+      .setContentTitle(text)
+      .setStyle(NotificationCompat.InboxStyle().setSummaryText(text))
+      .setGroup(GROUP_KEY)
+      .setGroupSummary(true)
+      .setGroupAlertBehavior(NotificationCompat.GROUP_ALERT_CHILDREN)
+      .setAutoCancel(true)
+      .build()
+    runCatching { manager.notify(SUMMARY_ID, summary) }
+  }
+
+  private fun openIntent(context: Context, conversationId: String, requestCode: 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(MissedCallNotification.EXTRA_ACTION, MissedCallNotification.ACTION_OPEN)
+      .putExtra(MissedCallNotification.EXTRA_CONVERSATION_ID, conversationId)
+    return PendingIntent.getActivity(
+      context,
+      requestCode,
+      intent,
+      PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE,
+    )
+  }
+
+  private fun actionIntent(context: Context, action: String, conversationId: String, requestCode: Int, mutable: Boolean): PendingIntent {
+    val intent = Intent(context, MessageActionReceiver::class.java)
+      .setAction(action)
+      .putExtra(EXTRA_CONVERSATION, conversationId)
+    // RemoteInput writes the typed text into the intent: it must be mutable.
+    val mutability = if (mutable && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+      PendingIntent.FLAG_MUTABLE
+    } else {
+      PendingIntent.FLAG_IMMUTABLE
+    }
+    return PendingIntent.getBroadcast(context, requestCode, intent, PendingIntent.FLAG_UPDATE_CURRENT or mutability)
+  }
+
+  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, "Messages", NotificationManager.IMPORTANCE_HIGH).apply {
+        lockscreenVisibility = NotificationCompat.VISIBILITY_PRIVATE
+      },
+    )
+  }
+
+  private fun notificationId(conversationId: String) = ("msg:$conversationId").hashCode()
+
+  // ── storage ─────────────────────────────────────────────────────────
+
+  internal data class Line(
+    val id: String?,
+    val sender: String,
+    val senderKey: String?,
+    val text: String,
+    val at: Long,
+    val self: Boolean,
+  )
+
+  internal class Conversation(
+    val id: String,
+    var title: String? = null,
+    var group: Boolean = false,
+    var grant: String? = null,
+    val lines: MutableList<Line> = mutableListOf(),
+  )
+
+  private fun prefs(context: Context) =
+    context.applicationContext.getSharedPreferences(PREFS, Context.MODE_PRIVATE)
+
+  private fun key(conversationId: String) = "conv:$conversationId"
+
+  private fun load(context: Context, conversationId: String): Conversation? {
+    val raw = prefs(context).getString(key(conversationId), null) ?: return null
+    return runCatching {
+      val o = JSONObject(raw)
+      val lines = o.optJSONArray("lines") ?: JSONArray()
+      Conversation(
+        id = conversationId,
+        title = o.optString("title").ifBlank { null },
+        group = o.optBoolean("group"),
+        grant = o.optString("grant").ifBlank { null },
+        lines = MutableList(lines.length()) { i ->
+          val l = lines.getJSONObject(i)
+          Line(
+            id = l.optString("id").ifBlank { null },
+            sender = l.optString("sender"),
+            senderKey = l.optString("key").ifBlank { null },
+            text = l.optString("text"),
+            at = l.optLong("at"),
+            self = l.optBoolean("self"),
+          )
+        },
+      )
+    }.getOrNull()
+  }
+
+  private fun save(context: Context, c: Conversation) {
+    val lines = JSONArray()
+    for (l in c.lines) {
+      lines.put(
+        JSONObject()
+          .put("id", l.id ?: "")
+          .put("sender", l.sender)
+          .put("key", l.senderKey ?: "")
+          .put("text", l.text)
+          .put("at", l.at)
+          .put("self", l.self),
+      )
+    }
+    val o = JSONObject()
+      .put("title", c.title ?: "")
+      .put("group", c.group)
+      .put("grant", c.grant ?: "")
+      .put("lines", lines)
+    prefs(context).edit().putString(key(c.id), o.toString()).apply()
+  }
+}
+
+/**
+ * Reply / Mark as read, tapped on a message notification. Posts to the
+ * notification-action endpoints with the conversation's reply grant —
+ * no app, no session — on a background thread kept alive by goAsync().
+ */
+class MessageActionReceiver : BroadcastReceiver() {
+  override fun onReceive(context: Context, intent: Intent) {
+    val conversationId = intent.getStringExtra(MessageNotifications.EXTRA_CONVERSATION) ?: return
+    val app = context.applicationContext
+    val grant = MessageNotifications.grantFor(app, conversationId)
+    val base = CallCore.apiBaseUrl(app)
+
+    when (intent.action) {
+      MessageNotifications.ACTION_REPLY -> {
+        val text = RemoteInput.getResultsFromIntent(intent)
+          ?.getCharSequence(MessageNotifications.KEY_REPLY)?.toString()?.trim().orEmpty()
+        if (text.isEmpty() || grant == null || base == null) return
+        val pending = goAsync()
+        Thread {
+          val body = JSONObject().put("body", text).put("id", UUID.randomUUID().toString())
+          val ok = post("$base/v1/notifications/reply", grant, body)
+          MessageNotifications.onReplied(app, conversationId, text, ok)
+          pending.finish()
+        }.start()
+      }
+      MessageNotifications.ACTION_READ -> {
+        // Optimistic: the notification goes now; the server catches up.
+        MessageNotifications.clear(app, conversationId)
+        if (grant == null || base == null) return
+        val pending = goAsync()
+        Thread {
+          post("$base/v1/notifications/read", grant, JSONObject())
+          pending.finish()
+        }.start()
+      }
+    }
+  }
+
+  private fun post(url: String, grant: String, body: JSONObject): Boolean = runCatching {
+    val request = Request.Builder()
+      .url(url)
+      .header("Authorization", "Bearer $grant")
+      .post(body.toString().toRequestBody("application/json".toMediaType()))
+      .build()
+    CallHttpClient.defaultClient().newCall(request).execute().use { it.isSuccessful }
+  }.onFailure { Log.w("PoolseMessages", "notification action failed", it) }.getOrDefault(false)
+}

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.MessageNotifications
 import dev.poolse.callcore.android.MissedCallNotification
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
@@ -102,6 +103,13 @@ class PoolseCallsModule : Module() {
       consumeCallAction(intent)?.let { sendEvent("onCallAction", it) }
     }
 
+    // The chat on screen: its messages are not notified, and opening it
+    // clears what was already shown for it.
+    Function("setActiveConversation") { conversationId: String? ->
+      MessageNotifications.activeConversationId = conversationId
+      if (conversationId != null) context?.let { MessageNotifications.clear(it, conversationId) }
+    }
+
     // Android 14+: full-screen intents need a user grant for non-dialer apps.
     Function("canUseFullScreenIntent") {
       val ctx = context ?: return@Function true

package/dist/index.cjs

@@ -47,6 +47,21 @@ function onCallAction(cb) {
   const sub = native.addListener("onCallAction", cb);
   return () => sub.remove();
 }
+var activeConversation = null;
+function setActiveConversation(conversationId) {
+  activeConversation = conversationId;
+  native?.setActiveConversation?.(conversationId);
+}
+function shouldPresentMessage(data) {
+  if (!data || data["type"] !== "message") return true;
+  return data["conversation_id"] !== activeConversation;
+}
+function conversationOfNotification(data) {
+  if (!data) return null;
+  const type = data["type"];
+  if (type !== "message" && type !== "call_missed") return null;
+  return typeof data["conversation_id"] === "string" ? data["conversation_id"] : null;
+}
 function getVoipToken() {
   return native?.getVoipToken?.() ?? null;
 }
@@ -81,6 +96,7 @@ exports.CallVideoView = CallVideoView;
 exports.answer = answer;
 exports.canUseFullScreenIntent = canUseFullScreenIntent;
 exports.configure = configure;
+exports.conversationOfNotification = conversationOfNotification;
 exports.decline = decline;
 exports.getCallState = getCallState;
 exports.getVoipToken = getVoipToken;
@@ -94,10 +110,12 @@ exports.onRingEnded = onRingEnded;
 exports.onVoipToken = onVoipToken;
 exports.openFullScreenIntentSettings = openFullScreenIntentSettings;
 exports.place = place;
+exports.setActiveConversation = setActiveConversation;
 exports.setAudioOutput = setAudioOutput;
 exports.setCamera = setCamera;
 exports.setMuted = setMuted;
 exports.setSpeaker = setSpeaker;
+exports.shouldPresentMessage = shouldPresentMessage;
 exports.switchCamera = switchCamera;
 exports.takeCallAction = takeCallAction;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"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  setActiveConversation?(conversationId: string | null): void;\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// ── chat notifications ─────────────────────────────────────────────────\n\nlet activeConversation: string | null = null;\n\n/**\n * Tell the core which conversation is on screen (`null` when none, and\n * when the app goes to the background). Its messages are not notified —\n * the user is reading them — and opening it clears the notifications\n * already shown for it.\n */\nexport function setActiveConversation(conversationId: string | null): void {\n  activeConversation = conversationId;\n  native?.setActiveConversation?.(conversationId);\n}\n\n/**\n * For the app's notification handler (expo-notifications'\n * `setNotificationHandler`): `false` for a chat notification of the\n * conversation on screen, which must not pop over the chat itself.\n * Android never asks — the core skips those natively.\n */\nexport function shouldPresentMessage(data: Record<string, unknown> | undefined | null): boolean {\n  if (!data || data['type'] !== 'message') return true;\n  return data['conversation_id'] !== activeConversation;\n}\n\n/**\n * The conversation a tapped notification belongs to — a chat message\n * (`type: 'message'`) or a missed call (`call_missed`) — from its data.\n * iOS hands the tap to your notification library; Android delivers it\n * through `takeCallAction` / `onCallAction` (type `open`).\n */\nexport function conversationOfNotification(\n  data: Record<string, unknown> | undefined | null,\n): string | null {\n  if (!data) return null;\n  const type = data['type'];\n  if (type !== 'message' && type !== 'call_missed') return null;\n  return typeof data['conversation_id'] === 'string' ? data['conversation_id'] : null;\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"]}

package/dist/index.d.cts

@@ -148,6 +148,27 @@ declare const openFullScreenIntentSettings: () => void;
 declare function takeCallAction(): CallAction | null;
 /** Android: a missed-call notification tapped while the app is running. */
 declare function onCallAction(cb: (action: CallAction) => void): Unsubscribe;
+/**
+ * Tell the core which conversation is on screen (`null` when none, and
+ * when the app goes to the background). Its messages are not notified —
+ * the user is reading them — and opening it clears the notifications
+ * already shown for it.
+ */
+declare function setActiveConversation(conversationId: string | null): void;
+/**
+ * For the app's notification handler (expo-notifications'
+ * `setNotificationHandler`): `false` for a chat notification of the
+ * conversation on screen, which must not pop over the chat itself.
+ * Android never asks — the core skips those natively.
+ */
+declare function shouldPresentMessage(data: Record<string, unknown> | undefined | null): boolean;
+/**
+ * The conversation a tapped notification belongs to — a chat message
+ * (`type: 'message'`) or a missed call (`call_missed`) — from its data.
+ * iOS hands the tap to your notification library; Android delivers it
+ * through `takeCallAction` / `onCallAction` (type `open`).
+ */
+declare function conversationOfNotification(data: Record<string, unknown> | undefined | null): string | null;
 /**
  * iOS: the current PushKit VoIP token, registered natively at launch.
  * `null` until iOS issues one, and always on Android (FCM carries rings).
@@ -172,4 +193,4 @@ interface CallVideoViewProps extends ViewProps {
  */
 declare function CallVideoView(props: CallVideoViewProps): ReactElement | null;
 
-export { type AudioOutput, type AudioOutputKind, type CallAction, CallVideoView, type CallVideoViewProps, type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, type VoipToken, answer, canUseFullScreenIntent, configure, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallAction, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setAudioOutput, setCamera, setMuted, setSpeaker, switchCamera, takeCallAction };
+export { type AudioOutput, type AudioOutputKind, type CallAction, CallVideoView, type CallVideoViewProps, type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, type VoipToken, answer, canUseFullScreenIntent, configure, conversationOfNotification, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallAction, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setActiveConversation, setAudioOutput, setCamera, setMuted, setSpeaker, shouldPresentMessage, switchCamera, takeCallAction };

package/dist/index.d.ts

@@ -148,6 +148,27 @@ declare const openFullScreenIntentSettings: () => void;
 declare function takeCallAction(): CallAction | null;
 /** Android: a missed-call notification tapped while the app is running. */
 declare function onCallAction(cb: (action: CallAction) => void): Unsubscribe;
+/**
+ * Tell the core which conversation is on screen (`null` when none, and
+ * when the app goes to the background). Its messages are not notified —
+ * the user is reading them — and opening it clears the notifications
+ * already shown for it.
+ */
+declare function setActiveConversation(conversationId: string | null): void;
+/**
+ * For the app's notification handler (expo-notifications'
+ * `setNotificationHandler`): `false` for a chat notification of the
+ * conversation on screen, which must not pop over the chat itself.
+ * Android never asks — the core skips those natively.
+ */
+declare function shouldPresentMessage(data: Record<string, unknown> | undefined | null): boolean;
+/**
+ * The conversation a tapped notification belongs to — a chat message
+ * (`type: 'message'`) or a missed call (`call_missed`) — from its data.
+ * iOS hands the tap to your notification library; Android delivers it
+ * through `takeCallAction` / `onCallAction` (type `open`).
+ */
+declare function conversationOfNotification(data: Record<string, unknown> | undefined | null): string | null;
 /**
  * iOS: the current PushKit VoIP token, registered natively at launch.
  * `null` until iOS issues one, and always on Android (FCM carries rings).
@@ -172,4 +193,4 @@ interface CallVideoViewProps extends ViewProps {
  */
 declare function CallVideoView(props: CallVideoViewProps): ReactElement | null;
 
-export { type AudioOutput, type AudioOutputKind, type CallAction, CallVideoView, type CallVideoViewProps, type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, type VoipToken, answer, canUseFullScreenIntent, configure, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallAction, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setAudioOutput, setCamera, setMuted, setSpeaker, switchCamera, takeCallAction };
+export { type AudioOutput, type AudioOutputKind, type CallAction, CallVideoView, type CallVideoViewProps, type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, type VoipToken, answer, canUseFullScreenIntent, configure, conversationOfNotification, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallAction, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setActiveConversation, setAudioOutput, setCamera, setMuted, setSpeaker, shouldPresentMessage, switchCamera, takeCallAction };

package/dist/index.js

@@ -45,6 +45,21 @@ function onCallAction(cb) {
   const sub = native.addListener("onCallAction", cb);
   return () => sub.remove();
 }
+var activeConversation = null;
+function setActiveConversation(conversationId) {
+  activeConversation = conversationId;
+  native?.setActiveConversation?.(conversationId);
+}
+function shouldPresentMessage(data) {
+  if (!data || data["type"] !== "message") return true;
+  return data["conversation_id"] !== activeConversation;
+}
+function conversationOfNotification(data) {
+  if (!data) return null;
+  const type = data["type"];
+  if (type !== "message" && type !== "call_missed") return null;
+  return typeof data["conversation_id"] === "string" ? data["conversation_id"] : null;
+}
 function getVoipToken() {
   return native?.getVoipToken?.() ?? null;
 }
@@ -75,6 +90,6 @@ function CallVideoView(props) {
   return createElement(Native, props);
 }
 
-export { CallVideoView, answer, canUseFullScreenIntent, configure, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallAction, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setAudioOutput, setCamera, setMuted, setSpeaker, switchCamera, takeCallAction };
+export { CallVideoView, answer, canUseFullScreenIntent, configure, conversationOfNotification, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallAction, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setActiveConversation, setAudioOutput, setCamera, setMuted, setSpeaker, shouldPresentMessage, switchCamera, takeCallAction };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","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"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","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  setActiveConversation?(conversationId: string | null): void;\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// ── chat notifications ─────────────────────────────────────────────────\n\nlet activeConversation: string | null = null;\n\n/**\n * Tell the core which conversation is on screen (`null` when none, and\n * when the app goes to the background). Its messages are not notified —\n * the user is reading them — and opening it clears the notifications\n * already shown for it.\n */\nexport function setActiveConversation(conversationId: string | null): void {\n  activeConversation = conversationId;\n  native?.setActiveConversation?.(conversationId);\n}\n\n/**\n * For the app's notification handler (expo-notifications'\n * `setNotificationHandler`): `false` for a chat notification of the\n * conversation on screen, which must not pop over the chat itself.\n * Android never asks — the core skips those natively.\n */\nexport function shouldPresentMessage(data: Record<string, unknown> | undefined | null): boolean {\n  if (!data || data['type'] !== 'message') return true;\n  return data['conversation_id'] !== activeConversation;\n}\n\n/**\n * The conversation a tapped notification belongs to — a chat message\n * (`type: 'message'`) or a missed call (`call_missed`) — from its data.\n * iOS hands the tap to your notification library; Android delivers it\n * through `takeCallAction` / `onCallAction` (type `open`).\n */\nexport function conversationOfNotification(\n  data: Record<string, unknown> | undefined | null,\n): string | null {\n  if (!data) return null;\n  const type = data['type'];\n  if (type !== 'message' && type !== 'call_missed') return null;\n  return typeof data['conversation_id'] === 'string' ? data['conversation_id'] : null;\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"]}

package/ios/Module/PoolseCallsModule.swift

@@ -72,6 +72,13 @@ public class PoolseCallsModule: Module {
     Function("setSpeaker") { (on: Bool) in onCore { $0.setSpeaker(on) } }
     Function("setAudioOutput") { (id: String) in onCore { $0.setAudioOutput(id) } }
 
+    // The chat on screen: opening it clears what was already shown for it.
+    // (Suppressing new ones while it is open happens in the app's
+    // notification handler — see shouldPresentMessage in src/index.ts.)
+    Function("setActiveConversation") { (conversationId: String?) in
+      if let conversationId = conversationId { MessageNotifications.clear(conversationId: conversationId) }
+    }
+
     // Socket forwarding (open app): idempotent with the push path.
     Function("onRingEnded") { (callId: String, reason: String) in
       onCore { $0.onRingEnded(callId: callId, reason: reason) }

package/ios/Platform/CallCore.swift

@@ -531,5 +531,6 @@ public final class PoolseCallsSetup: NSObject {
     _ = CallKitController.shared
     _ = CallCore.getOrNull()
     VoipPush.shared.register()
+    MessageNotifications.shared.install()
   }
 }

package/ios/Platform/MessageNotifications.swift

@@ -0,0 +1,163 @@
+import EXNotifications
+import Foundation
+import UIKit
+import UserNotifications
+
+/// Chat notifications on iOS (CONTRACT.md §5.5) — the parts that must work
+/// with the app not running: Reply and Mark as read from the notification,
+/// and clearing a conversation's notifications once it was read elsewhere.
+///
+/// iOS itself shows the message (an alert push with `thread-id` =
+/// conversation, so a chat's messages stack together). This class only
+/// acts on them. It plugs into expo-notifications rather than taking over
+/// the notification-center delegate: expo-notifications owns that delegate
+/// in an Expo app, and fanning out to registered delegates is its
+/// supported extension point — taking it would break every other
+/// notification feature in the app.
+///
+/// Reply and Mark as read run natively, authorized by the reply grant the
+/// push carried, so they work from the lock screen with the app killed.
+final class MessageNotifications: NSObject, NotificationDelegate {
+  static let shared = MessageNotifications()
+
+  static let category = "poolse_message"
+  static let replyAction = "reply"
+  static let markReadAction = "mark_read"
+
+  private var installed = false
+
+  /// Main thread, at launch (PoolseCallsSetup.registerVoipEarly).
+  func install() {
+    guard !installed else { return }
+    installed = true
+    registerCategory()
+    NotificationCenterManager.shared.addDelegate(self)
+  }
+
+  /// Add the message category beside whatever the app (or expo) declared:
+  /// setNotificationCategories REPLACES the whole set.
+  private func registerCategory() {
+    let reply = UNTextInputNotificationAction(
+      identifier: Self.replyAction,
+      title: "Reply",
+      options: [],
+      textInputButtonTitle: "Send",
+      textInputPlaceholder: "Message"
+    )
+    let markRead = UNNotificationAction(identifier: Self.markReadAction, title: "Mark as read", options: [])
+    let category = UNNotificationCategory(
+      identifier: Self.category,
+      actions: [reply, markRead],
+      intentIdentifiers: [],
+      hiddenPreviewsBodyPlaceholder: "New message",
+      categorySummaryFormat: "%u more messages from %@",
+      options: []
+    )
+    let center = UNUserNotificationCenter.current()
+    center.getNotificationCategories { existing in
+      var all = existing.filter { $0.identifier != Self.category }
+      all.insert(category)
+      center.setNotificationCategories(all)
+    }
+  }
+
+  // MARK: - NotificationDelegate (expo-notifications)
+
+  func didReceive(_ response: UNNotificationResponse, completionHandler: @escaping () -> Void) -> Bool {
+    let content = response.notification.request.content
+    guard content.categoryIdentifier == Self.category,
+          let grant = content.userInfo["reply_grant"] as? String, !grant.isEmpty else { return false }
+    let conversationId = content.userInfo["conversation_id"] as? String
+
+    switch response.actionIdentifier {
+    case Self.replyAction:
+      let text = (response as? UNTextInputNotificationResponse)?.userText
+        .trimmingCharacters(in: .whitespacesAndNewlines) ?? ""
+      guard !text.isEmpty else { return true }
+      post(path: "/v1/notifications/reply", grant: grant,
+           body: ["body": text, "id": UUID().uuidString.lowercased()]) { ok in
+        if ok, let conversationId = conversationId { Self.clear(conversationId: conversationId) }
+      }
+      return true
+    case Self.markReadAction:
+      if let conversationId = conversationId { Self.clear(conversationId: conversationId) }
+      post(path: "/v1/notifications/read", grant: grant, body: [:]) { _ in }
+      return true
+    default:
+      // A plain tap opens the app; the host routes it to the conversation.
+      return false
+    }
+  }
+
+  /// A background push: the conversation was read on another device.
+  func didReceive(_ userInfo: [AnyHashable: Any],
+                  completionHandler: @escaping (UIBackgroundFetchResult) -> Void) -> Bool {
+    guard userInfo["type"] as? String == "message_read",
+          let conversationId = userInfo["conversation_id"] as? String else { return false }
+    Self.clear(conversationId: conversationId)
+    if let unread = (userInfo["unread_total"] as? NSNumber)?.intValue ?? Int(userInfo["unread_total"] as? String ?? "") {
+      Self.setBadge(unread)
+    }
+    completionHandler(.newData)
+    return true
+  }
+
+  // MARK: - helpers
+
+  /// Remove every delivered notification of one conversation.
+  static func clear(conversationId: String) {
+    let center = UNUserNotificationCenter.current()
+    center.getDeliveredNotifications { delivered in
+      let ids = delivered
+        .filter { $0.request.content.threadIdentifier == conversationId ||
+                  ($0.request.content.userInfo["conversation_id"] as? String) == conversationId }
+        .map { $0.request.identifier }
+      if !ids.isEmpty { center.removeDeliveredNotifications(withIdentifiers: ids) }
+    }
+  }
+
+  static func setBadge(_ count: Int) {
+    if #available(iOS 16.0, *) {
+      UNUserNotificationCenter.current().setBadgeCount(max(count, 0))
+    } else {
+      DispatchQueue.main.async { UIApplication.shared.applicationIconBadgeNumber = max(count, 0) }
+    }
+  }
+
+  /// A grant-authorized POST that survives the app being suspended: the
+  /// action may have launched the app in the background just for this.
+  private func post(path: String, grant: String, body: [String: Any], done: @escaping (Bool) -> Void) {
+    guard let base = CallCore.config?.apiBaseUrl, let url = URL(string: base + path) else {
+      done(false)
+      return
+    }
+    var request = URLRequest(url: url)
+    request.httpMethod = "POST"
+    request.setValue("Bearer \(grant)", forHTTPHeaderField: "Authorization")
+    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+    request.httpBody = try? JSONSerialization.data(withJSONObject: body)
+    request.timeoutInterval = 20
+
+    var task: UIBackgroundTaskIdentifier = .invalid
+    let finish: (Bool) -> Void = { ok in
+      done(ok)
+      DispatchQueue.main.async {
+        if task != .invalid { UIApplication.shared.endBackgroundTask(task) }
+        task = .invalid
+      }
+    }
+    DispatchQueue.main.async {
+      task = UIApplication.shared.beginBackgroundTask(withName: "poolse-notification-action") {
+        if task != .invalid { UIApplication.shared.endBackgroundTask(task) }
+        task = .invalid
+      }
+      URLSession.shared.dataTask(with: request) { _, response, error in
+        let status = (response as? HTTPURLResponse)?.statusCode ?? 0
+        if error != nil || !(200..<300).contains(status) {
+          pcTrace("notification action \(path) failed status=\(status) error=\(String(describing: error))")
+        }
+        finish(error == nil && (200..<300).contains(status))
+      }.resume()
+    }
+  }
+}

package/ios/PoolseCalls.podspec

@@ -53,12 +53,16 @@ Pod::Spec.new do |s|
   # nanopb headers use <pb.h> angled includes that do not resolve when
   # CocoaPods builds the pod as a static library (Expo's default).
   s.dependency 'LiveKitClient', '= 2.15.1'
+  # Chat notifications plug into expo-notifications' notification-center
+  # delegate fan-out (MessageNotifications.swift) instead of replacing the
+  # delegate, which would break the app's own notifications.
+  s.dependency 'EXNotifications'
 
   s.pod_target_xcconfig = {
     'DEFINES_MODULE' => 'YES',
     'SWIFT_COMPILATION_MODE' => 'wholemodule',
   }
 
-  s.frameworks = 'CallKit', 'PushKit', 'AVFoundation', 'UIKit'
+  s.frameworks = 'CallKit', 'PushKit', 'AVFoundation', 'UIKit', 'UserNotifications'
   s.source_files = 'Core/**/*.swift', 'Platform/**/*.swift', 'Module/**/*.swift'
 end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolse/react-native-calls",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Native call core for poolse — Kotlin/Swift calling engine with a thin React Native bridge. Ring, answer and carry audio with the app killed and the phone locked.",
   "license": "MIT",
   "type": "module",
@@ -33,6 +33,7 @@
   ],
   "peerDependencies": {
     "expo": "*",
+    "expo-notifications": "*",
     "react-native": "*"
   },
   "devDependencies": {

package/src/index.ts

@@ -133,6 +133,7 @@ interface PoolseCallsNative {
   openFullScreenIntentSettings(): void;
   getVoipToken?(): VoipToken | null;
   takeCallAction?(): CallAction | null;
+  setActiveConversation?(conversationId: string | null): void;
   addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => void): { remove(): void };
   addListener(event: 'onVoipToken', cb: (payload: VoipToken) => void): { remove(): void };
   addListener(event: 'onCallAction', cb: (payload: CallAction) => void): { remove(): void };
@@ -244,6 +245,47 @@ export function onCallAction(cb: (action: CallAction) => void): Unsubscribe {
   return () => sub.remove();
 }
 
+// ── chat notifications ─────────────────────────────────────────────────
+
+let activeConversation: string | null = null;
+
+/**
+ * Tell the core which conversation is on screen (`null` when none, and
+ * when the app goes to the background). Its messages are not notified —
+ * the user is reading them — and opening it clears the notifications
+ * already shown for it.
+ */
+export function setActiveConversation(conversationId: string | null): void {
+  activeConversation = conversationId;
+  native?.setActiveConversation?.(conversationId);
+}
+
+/**
+ * For the app's notification handler (expo-notifications'
+ * `setNotificationHandler`): `false` for a chat notification of the
+ * conversation on screen, which must not pop over the chat itself.
+ * Android never asks — the core skips those natively.
+ */
+export function shouldPresentMessage(data: Record<string, unknown> | undefined | null): boolean {
+  if (!data || data['type'] !== 'message') return true;
+  return data['conversation_id'] !== activeConversation;
+}
+
+/**
+ * The conversation a tapped notification belongs to — a chat message
+ * (`type: 'message'`) or a missed call (`call_missed`) — from its data.
+ * iOS hands the tap to your notification library; Android delivers it
+ * through `takeCallAction` / `onCallAction` (type `open`).
+ */
+export function conversationOfNotification(
+  data: Record<string, unknown> | undefined | null,
+): string | null {
+  if (!data) return null;
+  const type = data['type'];
+  if (type !== 'message' && type !== 'call_missed') return null;
+  return typeof data['conversation_id'] === 'string' ? data['conversation_id'] : null;
+}
+
 // ── VoIP push (iOS) ───────────────────────────────────────────────────
 
 /**