@poolse/react-native-calls 0.1.2 → 0.2.0

package/dist/index.cjs

@@ -28,18 +28,28 @@ var hangUp = () => native?.hangUp();
 var setMuted = (muted) => native?.setMuted(muted);
 var setCamera = (on) => native?.setCamera(on);
 var switchCamera = () => native?.switchCamera();
+var setSpeaker = (on) => native?.setSpeaker(on);
+var onRingEnded = (callId, reason) => native?.onRingEnded(callId, reason);
+var onCallFinished = (callId, reason) => native?.onCallFinished(callId, reason ?? null);
+var canUseFullScreenIntent = () => native?.canUseFullScreenIntent() ?? true;
+var openFullScreenIntentSettings = () => native?.openFullScreenIntentSettings();
 
 exports.answer = answer;
+exports.canUseFullScreenIntent = canUseFullScreenIntent;
 exports.configure = configure;
 exports.decline = decline;
 exports.getCallState = getCallState;
 exports.hangUp = hangUp;
 exports.join = join;
 exports.nativeCallsAvailable = nativeCallsAvailable;
+exports.onCallFinished = onCallFinished;
 exports.onCallState = onCallState;
+exports.onRingEnded = onRingEnded;
+exports.openFullScreenIntentSettings = openFullScreenIntentSettings;
 exports.place = place;
 exports.setCamera = setCamera;
 exports.setMuted = setMuted;
+exports.setSpeaker = setSpeaker;
 exports.switchCamera = switchCamera;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/index.ts"],"names":["requireOptionalNativeModule"],"mappings":";;;;;AA+EA,IAAM,MAAA,GAASA,4CAA+C,aAAa,CAAA;AAGpE,IAAM,uBAAuB,MAAA,IAAU;AAG9C,eAAsB,SAAA,CAAU,YAAoB,OAAA,EAA2C;AAC7F,EAAA,MAAM,MAAA,EAAQ,SAAA,CAAU,UAAA,EAAY,OAAA,IAAW,IAAI,CAAA;AACrD;AAGO,SAAS,YAAA,GAAgC;AAC9C,EAAA,OAAO,MAAA,EAAQ,YAAA,EAAa,CAAE,QAAA,IAAY,IAAA;AAC5C;AAKO,SAAS,YAAY,EAAA,EAAsD;AAChF,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,MAAM,MAAA;AAC1B,EAAA,MAAM,GAAA,GAAM,OAAO,WAAA,CAAY,aAAA,EAAe,CAAC,OAAA,KAAY,EAAA,CAAG,OAAA,CAAQ,QAAQ,CAAC,CAAA;AAC/E,EAAA,OAAO,MAAM,IAAI,MAAA,EAAO;AAC1B;AAEO,SAAS,KAAA,CAAM,gBAAwB,OAAA,EAAsC;AAClF,EAAA,OAAO,MAAA,EAAQ,MAAM,cAAA,EAAgB,OAAA,CAAQ,OAAO,OAAA,CAAQ,YAAY,CAAA,IAAK,OAAA,CAAQ,OAAA,EAAQ;AAC/F;AAEO,SAAS,IAAA,CACd,MAAA,EACA,cAAA,EACA,YAAA,EACe;AACf,EAAA,OAAO,QAAQ,IAAA,CAAK,MAAA,EAAQ,gBAAgB,YAAY,CAAA,IAAK,QAAQ,OAAA,EAAQ;AAC/E;AAEO,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,OAAA,GAAU,MAAY,MAAA,EAAQ,OAAA;AACpC,IAAM,MAAA,GAAS,MAAY,MAAA,EAAQ,MAAA;AACnC,IAAM,QAAA,GAAW,CAAC,KAAA,KAAyB,MAAA,EAAQ,SAAS,KAAK;AACjE,IAAM,SAAA,GAAY,CAAC,EAAA,KAAsB,MAAA,EAAQ,UAAU,EAAE;AAC7D,IAAM,YAAA,GAAe,MAAY,MAAA,EAAQ,YAAA;AAEzC,IAAM,UAAA,GAAa,CAAC,EAAA,KAAsB,MAAA,EAAQ,WAAW,EAAE;AAM/D,IAAM,cAAc,CAAC,MAAA,EAAgB,WAC1C,MAAA,EAAQ,WAAA,CAAY,QAAQ,MAAM;AAQ7B,IAAM,cAAA,GAAiB,CAAC,MAAA,EAAgB,MAAA,KAC7C,QAAQ,cAAA,CAAe,MAAA,EAAQ,UAAU,IAAI;AAMxC,IAAM,sBAAA,GAAyB,MAAe,MAAA,EAAQ,sBAAA,EAAuB,IAAK;AAGlF,IAAM,4BAAA,GAA+B,MAAY,MAAA,EAAQ,4BAAA","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/**\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    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  setSpeaker(on: boolean): void;\n  onRingEnded(callId: string, reason: string): void;\n  onCallFinished(callId: string, reason: string | null): void;\n  canUseFullScreenIntent(): boolean;\n  openFullScreenIntentSettings(): void;\n  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 and before configure. */\nexport function getCallState(): Snapshot | null {\n  return native?.getCallState().snapshot ?? null;\n}\n\nexport type Unsubscribe = () => void;\n\n/** Subscribe to call state. Fires a full snapshot on every change. */\nexport function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe {\n  if (!native) return () => undefined;\n  const sub = native.addListener('onCallState', (payload) => cb(payload.snapshot));\n  return () => sub.remove();\n}\n\nexport function place(conversationId: string, options: PlaceOptions): Promise<void> {\n  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();\n}\n\nexport function join(\n  callId: string,\n  conversationId: string | null,\n  sessionToken: string,\n): Promise<void> {\n  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();\n}\n\nexport const answer = (): void => native?.answer();\nexport const decline = (): void => native?.decline();\nexport const hangUp = (): void => native?.hangUp();\nexport const setMuted = (muted: boolean): void => native?.setMuted(muted);\nexport const setCamera = (on: boolean): void => native?.setCamera(on);\nexport const switchCamera = (): void => native?.switchCamera();\n/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */\nexport const setSpeaker = (on: boolean): void => native?.setSpeaker(on);\n\n/**\n * Socket forwarding for an open app: a `call:ring_ended` seen on the\n * socket. Idempotent with the push path — the core dedupes.\n */\nexport const onRingEnded = (callId: string, reason: string): void =>\n  native?.onRingEnded(callId, reason);\n\n/**\n * Socket forwarding: `call:finished`. Pass the payload's `reason`\n * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an\n * unanswered caller sees \"Declined\"/\"No answer\", not \"Call ended\".\n * Idempotent with the `finished` push.\n */\nexport const onCallFinished = (callId: string, reason?: string): void =>\n  native?.onCallFinished(callId, reason ?? null);\n\n/**\n * Android 14+: whether the app may show the full-screen ring over the\n * lock screen. `true` on older Android and where the module is absent.\n */\nexport const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenIntent() ?? true;\n\n/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */\nexport const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();\n"]}

package/dist/index.d.cts

@@ -1,4 +1,8 @@
-/** A call's complete state. `null` means idle — no call. */
+/**
+ * A call's complete state. `null` means idle — no call. After a call
+ * ends the snapshot stays `phase: 'ended'` (with `reason`) for ~2.5 s,
+ * then becomes `null`.
+ */
 interface Snapshot {
     cv: 1;
     callId: string;
@@ -8,6 +12,7 @@ interface Snapshot {
     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';
+    /** REMOTE participants only; `userId` is the LiveKit identity. */
     participants: Array<{
         userId: string;
         externalId: string;
@@ -34,7 +39,7 @@ interface PlaceOptions {
 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. */
+/** The current snapshot — safe to read at any moment, including cold answer and before configure. */
 declare function getCallState(): Snapshot | null;
 type Unsubscribe = () => void;
 /** Subscribe to call state. Fires a full snapshot on every change. */
@@ -47,5 +52,26 @@ declare const hangUp: () => void;
 declare const setMuted: (muted: boolean) => void;
 declare const setCamera: (on: boolean) => void;
 declare const switchCamera: () => void;
+/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */
+declare const setSpeaker: (on: boolean) => void;
+/**
+ * Socket forwarding for an open app: a `call:ring_ended` seen on the
+ * socket. Idempotent with the push path — the core dedupes.
+ */
+declare const onRingEnded: (callId: string, reason: string) => void;
+/**
+ * Socket forwarding: `call:finished`. Pass the payload's `reason`
+ * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an
+ * unanswered caller sees "Declined"/"No answer", not "Call ended".
+ * Idempotent with the `finished` push.
+ */
+declare const onCallFinished: (callId: string, reason?: string) => void;
+/**
+ * Android 14+: whether the app may show the full-screen ring over the
+ * lock screen. `true` on older Android and where the module is absent.
+ */
+declare const canUseFullScreenIntent: () => boolean;
+/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */
+declare const openFullScreenIntentSettings: () => void;
 
-export { type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, answer, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallState, place, setCamera, setMuted, switchCamera };
+export { type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, answer, canUseFullScreenIntent, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, openFullScreenIntentSettings, place, setCamera, setMuted, setSpeaker, switchCamera };

package/dist/index.d.ts

@@ -1,4 +1,8 @@
-/** A call's complete state. `null` means idle — no call. */
+/**
+ * A call's complete state. `null` means idle — no call. After a call
+ * ends the snapshot stays `phase: 'ended'` (with `reason`) for ~2.5 s,
+ * then becomes `null`.
+ */
 interface Snapshot {
     cv: 1;
     callId: string;
@@ -8,6 +12,7 @@ interface Snapshot {
     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';
+    /** REMOTE participants only; `userId` is the LiveKit identity. */
     participants: Array<{
         userId: string;
         externalId: string;
@@ -34,7 +39,7 @@ interface PlaceOptions {
 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. */
+/** The current snapshot — safe to read at any moment, including cold answer and before configure. */
 declare function getCallState(): Snapshot | null;
 type Unsubscribe = () => void;
 /** Subscribe to call state. Fires a full snapshot on every change. */
@@ -47,5 +52,26 @@ declare const hangUp: () => void;
 declare const setMuted: (muted: boolean) => void;
 declare const setCamera: (on: boolean) => void;
 declare const switchCamera: () => void;
+/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */
+declare const setSpeaker: (on: boolean) => void;
+/**
+ * Socket forwarding for an open app: a `call:ring_ended` seen on the
+ * socket. Idempotent with the push path — the core dedupes.
+ */
+declare const onRingEnded: (callId: string, reason: string) => void;
+/**
+ * Socket forwarding: `call:finished`. Pass the payload's `reason`
+ * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an
+ * unanswered caller sees "Declined"/"No answer", not "Call ended".
+ * Idempotent with the `finished` push.
+ */
+declare const onCallFinished: (callId: string, reason?: string) => void;
+/**
+ * Android 14+: whether the app may show the full-screen ring over the
+ * lock screen. `true` on older Android and where the module is absent.
+ */
+declare const canUseFullScreenIntent: () => boolean;
+/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */
+declare const openFullScreenIntentSettings: () => void;
 
-export { type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, answer, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallState, place, setCamera, setMuted, switchCamera };
+export { type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, answer, canUseFullScreenIntent, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, openFullScreenIntentSettings, place, setCamera, setMuted, setSpeaker, switchCamera };

package/dist/index.js

@@ -26,7 +26,12 @@ var hangUp = () => native?.hangUp();
 var setMuted = (muted) => native?.setMuted(muted);
 var setCamera = (on) => native?.setCamera(on);
 var switchCamera = () => native?.switchCamera();
+var setSpeaker = (on) => native?.setSpeaker(on);
+var onRingEnded = (callId, reason) => native?.onRingEnded(callId, reason);
+var onCallFinished = (callId, reason) => native?.onCallFinished(callId, reason ?? null);
+var canUseFullScreenIntent = () => native?.canUseFullScreenIntent() ?? true;
+var openFullScreenIntentSettings = () => native?.openFullScreenIntentSettings();
 
-export { answer, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallState, place, setCamera, setMuted, switchCamera };
+export { answer, canUseFullScreenIntent, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, openFullScreenIntentSettings, place, setCamera, setMuted, setSpeaker, switchCamera };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA+EA,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;AAEzC,IAAM,UAAA,GAAa,CAAC,EAAA,KAAsB,MAAA,EAAQ,WAAW,EAAE;AAM/D,IAAM,cAAc,CAAC,MAAA,EAAgB,WAC1C,MAAA,EAAQ,WAAA,CAAY,QAAQ,MAAM;AAQ7B,IAAM,cAAA,GAAiB,CAAC,MAAA,EAAgB,MAAA,KAC7C,QAAQ,cAAA,CAAe,MAAA,EAAQ,UAAU,IAAI;AAMxC,IAAM,sBAAA,GAAyB,MAAe,MAAA,EAAQ,sBAAA,EAAuB,IAAK;AAGlF,IAAM,4BAAA,GAA+B,MAAY,MAAA,EAAQ,4BAAA","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/**\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    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  setSpeaker(on: boolean): void;\n  onRingEnded(callId: string, reason: string): void;\n  onCallFinished(callId: string, reason: string | null): void;\n  canUseFullScreenIntent(): boolean;\n  openFullScreenIntentSettings(): void;\n  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 and before configure. */\nexport function getCallState(): Snapshot | null {\n  return native?.getCallState().snapshot ?? null;\n}\n\nexport type Unsubscribe = () => void;\n\n/** Subscribe to call state. Fires a full snapshot on every change. */\nexport function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe {\n  if (!native) return () => undefined;\n  const sub = native.addListener('onCallState', (payload) => cb(payload.snapshot));\n  return () => sub.remove();\n}\n\nexport function place(conversationId: string, options: PlaceOptions): Promise<void> {\n  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();\n}\n\nexport function join(\n  callId: string,\n  conversationId: string | null,\n  sessionToken: string,\n): Promise<void> {\n  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();\n}\n\nexport const answer = (): void => native?.answer();\nexport const decline = (): void => native?.decline();\nexport const hangUp = (): void => native?.hangUp();\nexport const setMuted = (muted: boolean): void => native?.setMuted(muted);\nexport const setCamera = (on: boolean): void => native?.setCamera(on);\nexport const switchCamera = (): void => native?.switchCamera();\n/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */\nexport const setSpeaker = (on: boolean): void => native?.setSpeaker(on);\n\n/**\n * Socket forwarding for an open app: a `call:ring_ended` seen on the\n * socket. Idempotent with the push path — the core dedupes.\n */\nexport const onRingEnded = (callId: string, reason: string): void =>\n  native?.onRingEnded(callId, reason);\n\n/**\n * Socket forwarding: `call:finished`. Pass the payload's `reason`\n * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an\n * unanswered caller sees \"Declined\"/\"No answer\", not \"Call ended\".\n * Idempotent with the `finished` push.\n */\nexport const onCallFinished = (callId: string, reason?: string): void =>\n  native?.onCallFinished(callId, reason ?? null);\n\n/**\n * Android 14+: whether the app may show the full-screen ring over the\n * lock screen. `true` on older Android and where the module is absent.\n */\nexport const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenIntent() ?? true;\n\n/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */\nexport const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolse/react-native-calls",
-  "version": "0.1.2",
+  "version": "0.2.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",
@@ -20,6 +20,7 @@
     "src",
     "dist",
     "android/build.gradle",
+    "android/consumer-rules.pro",
     "android/src",
     "expo-module.config.json",
     "README.md"

package/src/index.ts

@@ -8,7 +8,11 @@
 // so a host can render against this unconditionally.
 import { requireOptionalNativeModule } from 'expo-modules-core';
 
-/** A call's complete state. `null` means idle — no call. */
+/**
+ * A call's complete state. `null` means idle — no call. After a call
+ * ends the snapshot stays `phase: 'ended'` (with `reason`) for ~2.5 s,
+ * then becomes `null`.
+ */
 export interface Snapshot {
   cv: 1;
   callId: string;
@@ -26,6 +30,7 @@ export interface Snapshot {
     | 'cancelled'
     | 'connection_lost'
     | 'failed';
+  /** REMOTE participants only; `userId` is the LiveKit identity. */
   participants: Array<{
     userId: string;
     externalId: string;
@@ -64,6 +69,11 @@ interface PoolseCallsNative {
   setMuted(muted: boolean): void;
   setCamera(on: boolean): void;
   switchCamera(): void;
+  setSpeaker(on: boolean): void;
+  onRingEnded(callId: string, reason: string): void;
+  onCallFinished(callId: string, reason: string | null): void;
+  canUseFullScreenIntent(): boolean;
+  openFullScreenIntentSettings(): void;
   addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => void): { remove(): void };
 }
 
@@ -77,7 +87,7 @@ export async function configure(apiBaseUrl: string, options?: ConfigureOptions):
   await native?.configure(apiBaseUrl, options ?? null);
 }
 
-/** The current snapshot — safe to read at any moment, including cold answer. */
+/** The current snapshot — safe to read at any moment, including cold answer and before configure. */
 export function getCallState(): Snapshot | null {
   return native?.getCallState().snapshot ?? null;
 }
@@ -109,3 +119,30 @@ 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();
+/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */
+export const setSpeaker = (on: boolean): void => native?.setSpeaker(on);
+
+/**
+ * Socket forwarding for an open app: a `call:ring_ended` seen on the
+ * socket. Idempotent with the push path — the core dedupes.
+ */
+export const onRingEnded = (callId: string, reason: string): void =>
+  native?.onRingEnded(callId, reason);
+
+/**
+ * Socket forwarding: `call:finished`. Pass the payload's `reason`
+ * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an
+ * unanswered caller sees "Declined"/"No answer", not "Call ended".
+ * Idempotent with the `finished` push.
+ */
+export const onCallFinished = (callId: string, reason?: string): void =>
+  native?.onCallFinished(callId, reason ?? null);
+
+/**
+ * Android 14+: whether the app may show the full-screen ring over the
+ * lock screen. `true` on older Android and where the module is absent.
+ */
+export const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenIntent() ?? true;
+
+/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */
+export const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();