@poolse/react-native-calls 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,108 @@
+package dev.poolse.callcore.livekit
+
+import android.content.Context
+import dev.poolse.callcore.CallSessionBundle
+import dev.poolse.callcore.MediaPort
+import dev.poolse.callcore.android.MediaEvents
+import dev.poolse.callcore.android.MediaParticipant
+import io.livekit.android.LiveKit
+import io.livekit.android.events.RoomEvent
+import io.livekit.android.events.collect
+import io.livekit.android.room.Room
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.Job
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
+import kotlinx.coroutines.launch
+
+/**
+ * The shipped [MediaPort], over LiveKit's native Android SDK. Wire it
+ * with [factory] in [dev.poolse.callcore.android.CallCoreConfig].
+ *
+ * This is the one adapter that depends on an external SFU SDK, so it
+ * lives in its own source set (`src/main/livekit`) kept off the core
+ * library's classpath. Lifecycle and signaling are not its concern — it
+ * joins a room with the server-minted token, publishes the mic (and
+ * camera for video), and reports room transitions back through
+ * [MediaEvents]. The runtime decides everything else.
+ */
+class LiveKitMediaPort(
+  private val context: Context,
+  private val events: MediaEvents,
+) : MediaPort {
+
+  private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)
+  private var room: Room? = null
+  private var eventJob: Job? = null
+
+  override fun join(bundle: CallSessionBundle) {
+    leave()
+    val wantsVideo = bundle.media == "video"
+    val newRoom = LiveKit.create(appContext = context.applicationContext)
+    room = newRoom
+    eventJob = scope.launch { observe(newRoom) }
+    scope.launch {
+      runCatching {
+        newRoom.connect(bundle.livekitUrl, bundle.livekitToken)
+        newRoom.localParticipant.setMicrophoneEnabled(true)
+        if (wantsVideo) newRoom.localParticipant.setCameraEnabled(true)
+      }.onFailure { events.onFailed() }
+    }
+  }
+
+  override fun leave() {
+    eventJob?.cancel()
+    eventJob = null
+    room?.disconnect()
+    room = null
+  }
+
+  override fun setMuted(muted: Boolean) {
+    scope.launch { room?.localParticipant?.setMicrophoneEnabled(!muted) }
+  }
+
+  override fun setCamera(on: Boolean) {
+    scope.launch { room?.localParticipant?.setCameraEnabled(on) }
+  }
+
+  override fun switchCamera() {
+    // The host's VideoTrackView performs the actual flip; exposing the
+    // control here keeps the port surface complete.
+  }
+
+  private suspend fun observe(room: Room) {
+    room.events.collect { event ->
+      when (event) {
+        is RoomEvent.Connected -> events.onConnected()
+        is RoomEvent.Reconnecting, is RoomEvent.Disconnected -> events.onLost()
+        is RoomEvent.Reconnected -> events.onRecovered()
+        is RoomEvent.ParticipantConnected -> { events.onRemoteJoined(); emit(room) }
+        is RoomEvent.ParticipantDisconnected,
+        is RoomEvent.ActiveSpeakersChanged,
+        is RoomEvent.TrackMuted,
+        is RoomEvent.TrackUnmuted -> emit(room)
+        else -> Unit
+      }
+    }
+  }
+
+  private fun emit(room: Room) {
+    events.onParticipants(
+      room.remoteParticipants.values.map {
+        MediaParticipant(
+          identity = it.identity?.value ?: "",
+          speaking = it.isSpeaking,
+          muted = it.audioTrackPublications.firstOrNull()?.first?.muted ?: true,
+        )
+      },
+    )
+  }
+
+  fun dispose() = scope.cancel()
+
+  companion object {
+    /** Pass as `mediaFactory` in CallCoreConfig. */
+    val factory: (Context, MediaEvents) -> MediaPort = { ctx, ev -> LiveKitMediaPort(ctx, ev) }
+  }
+}

package/dist/index.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var expoModulesCore = require('expo-modules-core');
+
+// src/index.ts
+var native = expoModulesCore.requireOptionalNativeModule("PoolseCalls");
+var nativeCallsAvailable = native != null;
+async function configure(apiBaseUrl, options) {
+  await native?.configure(apiBaseUrl, options ?? null);
+}
+function getCallState() {
+  return native?.getCallState().snapshot ?? null;
+}
+function onCallState(cb) {
+  if (!native) return () => void 0;
+  const sub = native.addListener("onCallState", (payload) => cb(payload.snapshot));
+  return () => sub.remove();
+}
+function place(conversationId, options) {
+  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();
+}
+function join(callId, conversationId, sessionToken) {
+  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();
+}
+var answer = () => native?.answer();
+var decline = () => native?.decline();
+var hangUp = () => native?.hangUp();
+var setMuted = (muted) => native?.setMuted(muted);
+var setCamera = (on) => native?.setCamera(on);
+var switchCamera = () => native?.switchCamera();
+
+exports.answer = answer;
+exports.configure = configure;
+exports.decline = decline;
+exports.getCallState = getCallState;
+exports.hangUp = hangUp;
+exports.join = join;
+exports.nativeCallsAvailable = nativeCallsAvailable;
+exports.onCallState = onCallState;
+exports.place = place;
+exports.setCamera = setCamera;
+exports.setMuted = setMuted;
+exports.switchCamera = switchCamera;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["requireOptionalNativeModule"],"mappings":";;;;;AAqEA,IAAM,MAAA,GAASA,4CAA+C,aAAa,CAAA;AAGpE,IAAM,uBAAuB,MAAA,IAAU;AAG9C,eAAsB,SAAA,CAAU,YAAoB,OAAA,EAA2C;AAC7F,EAAA,MAAM,MAAA,EAAQ,SAAA,CAAU,UAAA,EAAY,OAAA,IAAW,IAAI,CAAA;AACrD;AAGO,SAAS,YAAA,GAAgC;AAC9C,EAAA,OAAO,MAAA,EAAQ,YAAA,EAAa,CAAE,QAAA,IAAY,IAAA;AAC5C;AAKO,SAAS,YAAY,EAAA,EAAsD;AAChF,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,MAAM,MAAA;AAC1B,EAAA,MAAM,GAAA,GAAM,OAAO,WAAA,CAAY,aAAA,EAAe,CAAC,OAAA,KAAY,EAAA,CAAG,OAAA,CAAQ,QAAQ,CAAC,CAAA;AAC/E,EAAA,OAAO,MAAM,IAAI,MAAA,EAAO;AAC1B;AAEO,SAAS,KAAA,CAAM,gBAAwB,OAAA,EAAsC;AAClF,EAAA,OAAO,MAAA,EAAQ,MAAM,cAAA,EAAgB,OAAA,CAAQ,OAAO,OAAA,CAAQ,YAAY,CAAA,IAAK,OAAA,CAAQ,OAAA,EAAQ;AAC/F;AAEO,SAAS,IAAA,CACd,MAAA,EACA,cAAA,EACA,YAAA,EACe;AACf,EAAA,OAAO,QAAQ,IAAA,CAAK,MAAA,EAAQ,gBAAgB,YAAY,CAAA,IAAK,QAAQ,OAAA,EAAQ;AAC/E;AAEO,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,OAAA,GAAU,MAAY,MAAA,EAAQ,OAAA;AACpC,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,QAAA,GAAW,CAAC,KAAA,KAAyB,MAAA,EAAQ,SAAS,KAAK;AACjE,IAAM,SAAA,GAAY,CAAC,EAAA,KAAsB,MAAA,EAAQ,UAAU,EAAE;AAC7D,IAAM,YAAA,GAAe,MAAY,MAAA,EAAQ,YAAA","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 { requireOptionalNativeModule } from 'expo-modules-core';\n\n/** A call's complete state. `null` means idle — no call. */\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  participants: Array<{\n    userId: string;\n    externalId: string;\n    speaking: boolean;\n    muted: boolean;\n    cameraOn: boolean;\n  }>;\n  audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';\n  mutedSelf: boolean;\n  cameraOn: boolean;\n}\n\nexport interface ConfigureOptions {\n  /** Drawable resource NAME for the call notification's small icon. */\n  smallIcon?: string;\n  /** Raw resource NAME of the ringback tone (Android). */\n  ringback?: string;\n}\n\nexport interface PlaceOptions {\n  media: 'audio' | 'video';\n  /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */\n  sessionToken: string;\n}\n\ntype NativeSnapshot = { snapshot: Snapshot | null };\n\ninterface PoolseCallsNative {\n  configure(apiBaseUrl: string, options: ConfigureOptions | null): Promise<void>;\n  getCallState(): NativeSnapshot;\n  place(conversationId: string, media: string, sessionToken: string): Promise<void>;\n  join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;\n  answer(): void;\n  decline(): void;\n  hangUp(): void;\n  setMuted(muted: boolean): void;\n  setCamera(on: boolean): void;\n  switchCamera(): void;\n  addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => 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. */\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"]}

package/dist/index.d.cts

@@ -0,0 +1,51 @@
+/** A call's complete state. `null` means idle — no call. */
+interface Snapshot {
+    cv: 1;
+    callId: string;
+    conversationId: string;
+    conversationName: string | null;
+    direction: 'incoming' | 'outgoing' | 'joined';
+    media: 'audio' | 'video';
+    phase: 'ringing_in' | 'ringing_out' | 'connecting' | 'active' | 'reconnecting' | 'ended';
+    reason?: 'left' | 'finished' | 'declined_all' | 'busy_all' | 'no_answer' | 'cancelled' | 'connection_lost' | 'failed';
+    participants: Array<{
+        userId: string;
+        externalId: string;
+        speaking: boolean;
+        muted: boolean;
+        cameraOn: boolean;
+    }>;
+    audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';
+    mutedSelf: boolean;
+    cameraOn: boolean;
+}
+interface ConfigureOptions {
+    /** Drawable resource NAME for the call notification's small icon. */
+    smallIcon?: string;
+    /** Raw resource NAME of the ringback tone (Android). */
+    ringback?: string;
+}
+interface PlaceOptions {
+    media: 'audio' | 'video';
+    /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */
+    sessionToken: string;
+}
+/** True when the native call core is present in this build. */
+declare const nativeCallsAvailable: boolean;
+/** Configure once, before any call can arrive. No secrets — just the API origin. */
+declare function configure(apiBaseUrl: string, options?: ConfigureOptions): Promise<void>;
+/** The current snapshot — safe to read at any moment, including cold answer. */
+declare function getCallState(): Snapshot | null;
+type Unsubscribe = () => void;
+/** Subscribe to call state. Fires a full snapshot on every change. */
+declare function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe;
+declare function place(conversationId: string, options: PlaceOptions): Promise<void>;
+declare function join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;
+declare const answer: () => void;
+declare const decline: () => void;
+declare const hangUp: () => void;
+declare const setMuted: (muted: boolean) => void;
+declare const setCamera: (on: boolean) => void;
+declare const switchCamera: () => void;
+
+export { type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, answer, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallState, place, setCamera, setMuted, switchCamera };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/** A call's complete state. `null` means idle — no call. */
+interface Snapshot {
+    cv: 1;
+    callId: string;
+    conversationId: string;
+    conversationName: string | null;
+    direction: 'incoming' | 'outgoing' | 'joined';
+    media: 'audio' | 'video';
+    phase: 'ringing_in' | 'ringing_out' | 'connecting' | 'active' | 'reconnecting' | 'ended';
+    reason?: 'left' | 'finished' | 'declined_all' | 'busy_all' | 'no_answer' | 'cancelled' | 'connection_lost' | 'failed';
+    participants: Array<{
+        userId: string;
+        externalId: string;
+        speaking: boolean;
+        muted: boolean;
+        cameraOn: boolean;
+    }>;
+    audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';
+    mutedSelf: boolean;
+    cameraOn: boolean;
+}
+interface ConfigureOptions {
+    /** Drawable resource NAME for the call notification's small icon. */
+    smallIcon?: string;
+    /** Raw resource NAME of the ringback tone (Android). */
+    ringback?: string;
+}
+interface PlaceOptions {
+    media: 'audio' | 'video';
+    /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */
+    sessionToken: string;
+}
+/** True when the native call core is present in this build. */
+declare const nativeCallsAvailable: boolean;
+/** Configure once, before any call can arrive. No secrets — just the API origin. */
+declare function configure(apiBaseUrl: string, options?: ConfigureOptions): Promise<void>;
+/** The current snapshot — safe to read at any moment, including cold answer. */
+declare function getCallState(): Snapshot | null;
+type Unsubscribe = () => void;
+/** Subscribe to call state. Fires a full snapshot on every change. */
+declare function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe;
+declare function place(conversationId: string, options: PlaceOptions): Promise<void>;
+declare function join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;
+declare const answer: () => void;
+declare const decline: () => void;
+declare const hangUp: () => void;
+declare const setMuted: (muted: boolean) => void;
+declare const setCamera: (on: boolean) => void;
+declare const switchCamera: () => void;
+
+export { type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, answer, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallState, place, setCamera, setMuted, switchCamera };

package/dist/index.js

@@ -0,0 +1,32 @@
+import { requireOptionalNativeModule } from 'expo-modules-core';
+
+// src/index.ts
+var native = requireOptionalNativeModule("PoolseCalls");
+var nativeCallsAvailable = native != null;
+async function configure(apiBaseUrl, options) {
+  await native?.configure(apiBaseUrl, options ?? null);
+}
+function getCallState() {
+  return native?.getCallState().snapshot ?? null;
+}
+function onCallState(cb) {
+  if (!native) return () => void 0;
+  const sub = native.addListener("onCallState", (payload) => cb(payload.snapshot));
+  return () => sub.remove();
+}
+function place(conversationId, options) {
+  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();
+}
+function join(callId, conversationId, sessionToken) {
+  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();
+}
+var answer = () => native?.answer();
+var decline = () => native?.decline();
+var hangUp = () => native?.hangUp();
+var setMuted = (muted) => native?.setMuted(muted);
+var setCamera = (on) => native?.setCamera(on);
+var switchCamera = () => native?.switchCamera();
+
+export { answer, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallState, place, setCamera, setMuted, switchCamera };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAqEA,IAAM,MAAA,GAAS,4BAA+C,aAAa,CAAA;AAGpE,IAAM,uBAAuB,MAAA,IAAU;AAG9C,eAAsB,SAAA,CAAU,YAAoB,OAAA,EAA2C;AAC7F,EAAA,MAAM,MAAA,EAAQ,SAAA,CAAU,UAAA,EAAY,OAAA,IAAW,IAAI,CAAA;AACrD;AAGO,SAAS,YAAA,GAAgC;AAC9C,EAAA,OAAO,MAAA,EAAQ,YAAA,EAAa,CAAE,QAAA,IAAY,IAAA;AAC5C;AAKO,SAAS,YAAY,EAAA,EAAsD;AAChF,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,MAAM,MAAA;AAC1B,EAAA,MAAM,GAAA,GAAM,OAAO,WAAA,CAAY,aAAA,EAAe,CAAC,OAAA,KAAY,EAAA,CAAG,OAAA,CAAQ,QAAQ,CAAC,CAAA;AAC/E,EAAA,OAAO,MAAM,IAAI,MAAA,EAAO;AAC1B;AAEO,SAAS,KAAA,CAAM,gBAAwB,OAAA,EAAsC;AAClF,EAAA,OAAO,MAAA,EAAQ,MAAM,cAAA,EAAgB,OAAA,CAAQ,OAAO,OAAA,CAAQ,YAAY,CAAA,IAAK,OAAA,CAAQ,OAAA,EAAQ;AAC/F;AAEO,SAAS,IAAA,CACd,MAAA,EACA,cAAA,EACA,YAAA,EACe;AACf,EAAA,OAAO,QAAQ,IAAA,CAAK,MAAA,EAAQ,gBAAgB,YAAY,CAAA,IAAK,QAAQ,OAAA,EAAQ;AAC/E;AAEO,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,OAAA,GAAU,MAAY,MAAA,EAAQ,OAAA;AACpC,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,QAAA,GAAW,CAAC,KAAA,KAAyB,MAAA,EAAQ,SAAS,KAAK;AACjE,IAAM,SAAA,GAAY,CAAC,EAAA,KAAsB,MAAA,EAAQ,UAAU,EAAE;AAC7D,IAAM,YAAA,GAAe,MAAY,MAAA,EAAQ,YAAA","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 { requireOptionalNativeModule } from 'expo-modules-core';\n\n/** A call's complete state. `null` means idle — no call. */\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  participants: Array<{\n    userId: string;\n    externalId: string;\n    speaking: boolean;\n    muted: boolean;\n    cameraOn: boolean;\n  }>;\n  audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';\n  mutedSelf: boolean;\n  cameraOn: boolean;\n}\n\nexport interface ConfigureOptions {\n  /** Drawable resource NAME for the call notification's small icon. */\n  smallIcon?: string;\n  /** Raw resource NAME of the ringback tone (Android). */\n  ringback?: string;\n}\n\nexport interface PlaceOptions {\n  media: 'audio' | 'video';\n  /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */\n  sessionToken: string;\n}\n\ntype NativeSnapshot = { snapshot: Snapshot | null };\n\ninterface PoolseCallsNative {\n  configure(apiBaseUrl: string, options: ConfigureOptions | null): Promise<void>;\n  getCallState(): NativeSnapshot;\n  place(conversationId: string, media: string, sessionToken: string): Promise<void>;\n  join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;\n  answer(): void;\n  decline(): void;\n  hangUp(): void;\n  setMuted(muted: boolean): void;\n  setCamera(on: boolean): void;\n  switchCamera(): void;\n  addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => 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. */\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"]}

package/expo-module.config.json

@@ -0,0 +1,6 @@
+{
+  "platforms": ["android"],
+  "android": {
+    "modules": ["expo.modules.poolsecalls.PoolseCallsModule"]
+  }
+}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@poolse/react-native-calls",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "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",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "android/build.gradle",
+    "android/src",
+    "expo-module.config.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "expo-modules-core": "*",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.0"
+  }
+}

package/src/expo-modules-core.d.ts

@@ -0,0 +1,11 @@
+// Minimal ambient declaration for the one `expo-modules-core` function
+// this package calls at runtime. It lets the package type-check and emit
+// its own `.d.ts` without `expo-modules-core`'s full types installed in
+// the monorepo — the host app always supplies the real module at runtime.
+//
+// This shim lives only in the package source; consumers read the emitted
+// `dist/index.d.ts`, which never references `expo-modules-core`, so it
+// cannot collide with the app's own copy of the types.
+declare module 'expo-modules-core' {
+  export function requireOptionalNativeModule<T>(name: string): T | null;
+}

package/src/index.ts

@@ -0,0 +1,111 @@
+// @poolse/react-native-calls — the React Native face of the native
+// call core (CONTRACT.md §8). A thin, typed surface over the native
+// module: commands in, one snapshot event out. All call logic lives in
+// the native cores; nothing here decides anything about a call.
+//
+// On a platform or build without the native module (Expo Go, web,
+// unlinked), every command is a safe no-op and the state stays idle —
+// so a host can render against this unconditionally.
+import { requireOptionalNativeModule } from 'expo-modules-core';
+
+/** A call's complete state. `null` means idle — no call. */
+export interface Snapshot {
+  cv: 1;
+  callId: string;
+  conversationId: string;
+  conversationName: string | null;
+  direction: 'incoming' | 'outgoing' | 'joined';
+  media: 'audio' | 'video';
+  phase: 'ringing_in' | 'ringing_out' | 'connecting' | 'active' | 'reconnecting' | 'ended';
+  reason?:
+    | 'left'
+    | 'finished'
+    | 'declined_all'
+    | 'busy_all'
+    | 'no_answer'
+    | 'cancelled'
+    | 'connection_lost'
+    | 'failed';
+  participants: Array<{
+    userId: string;
+    externalId: string;
+    speaking: boolean;
+    muted: boolean;
+    cameraOn: boolean;
+  }>;
+  audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';
+  mutedSelf: boolean;
+  cameraOn: boolean;
+}
+
+export interface ConfigureOptions {
+  /** Drawable resource NAME for the call notification's small icon. */
+  smallIcon?: string;
+  /** Raw resource NAME of the ringback tone (Android). */
+  ringback?: string;
+}
+
+export interface PlaceOptions {
+  media: 'audio' | 'video';
+  /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */
+  sessionToken: string;
+}
+
+type NativeSnapshot = { snapshot: Snapshot | null };
+
+interface PoolseCallsNative {
+  configure(apiBaseUrl: string, options: ConfigureOptions | null): Promise<void>;
+  getCallState(): NativeSnapshot;
+  place(conversationId: string, media: string, sessionToken: string): Promise<void>;
+  join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;
+  answer(): void;
+  decline(): void;
+  hangUp(): void;
+  setMuted(muted: boolean): void;
+  setCamera(on: boolean): void;
+  switchCamera(): void;
+  addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => void): { remove(): void };
+}
+
+const native = requireOptionalNativeModule<PoolseCallsNative>('PoolseCalls');
+
+/** True when the native call core is present in this build. */
+export const nativeCallsAvailable = native != null;
+
+/** Configure once, before any call can arrive. No secrets — just the API origin. */
+export async function configure(apiBaseUrl: string, options?: ConfigureOptions): Promise<void> {
+  await native?.configure(apiBaseUrl, options ?? null);
+}
+
+/** The current snapshot — safe to read at any moment, including cold answer. */
+export function getCallState(): Snapshot | null {
+  return native?.getCallState().snapshot ?? null;
+}
+
+export type Unsubscribe = () => void;
+
+/** Subscribe to call state. Fires a full snapshot on every change. */
+export function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe {
+  if (!native) return () => undefined;
+  const sub = native.addListener('onCallState', (payload) => cb(payload.snapshot));
+  return () => sub.remove();
+}
+
+export function place(conversationId: string, options: PlaceOptions): Promise<void> {
+  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();
+}
+
+export function join(
+  callId: string,
+  conversationId: string | null,
+  sessionToken: string,
+): Promise<void> {
+  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();
+}
+
+export const answer = (): void => native?.answer();
+export const decline = (): void => native?.decline();
+export const hangUp = (): void => native?.hangUp();
+export const setMuted = (muted: boolean): void => native?.setMuted(muted);
+export const setCamera = (on: boolean): void => native?.setCamera(on);
+export const switchCamera = (): void => native?.switchCamera();