@poolse/react-native-calls 0.5.0 → 0.7.0

package/src/index.ts

@@ -100,6 +100,18 @@ export interface PlaceOptions {
   sessionToken: string;
 }
 
+/**
+ * What the user tapped on a missed-call notification: the notification
+ * itself (`open` the conversation) or its Call back button (`call_back`
+ * — place a call on the conversation with `media`).
+ */
+export interface CallAction {
+  type: 'open' | 'call_back';
+  conversationId: string;
+  callId: string | null;
+  media: 'audio' | 'video';
+}
+
 type NativeSnapshot = { snapshot: Snapshot | null };
 
 interface PoolseCallsNative {
@@ -120,8 +132,11 @@ interface PoolseCallsNative {
   canUseFullScreenIntent(): boolean;
   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 };
 }
 
 const native = requireOptionalNativeModule<PoolseCallsNative>('PoolseCalls');
@@ -206,6 +221,71 @@ export const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenInt
 /** Open the system screen where the user grants full-screen intents (falls back to notification settings). */
 export const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();
 
+// ── missed-call notifications (Android) ─────────────────────────────────
+
+/**
+ * Android: the missed-call notification action the app was LAUNCHED
+ * with, once — read it on mount. `null` when the app opened any other
+ * way. The native core posts that notification itself from the push,
+ * so it works with the app closed.
+ *
+ * iOS shows missed calls as an ordinary alert push (to the token you
+ * register with `kind: 'alert'`); read its taps with your notification
+ * library — its `type` is `call_missed`, the category
+ * `poolse_missed_call`, the Call back action `call_back`.
+ */
+export function takeCallAction(): CallAction | null {
+  return native?.takeCallAction?.() ?? null;
+}
+
+/** Android: a missed-call notification tapped while the app is running. */
+export function onCallAction(cb: (action: CallAction) => void): Unsubscribe {
+  if (!native || !native.takeCallAction) return () => undefined;
+  const sub = native.addListener('onCallAction', cb);
+  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) ───────────────────────────────────────────────────
 
 /**