@poolse/react-native-calls 0.3.0 → 0.4.1

package/dist/index.cjs

@@ -35,6 +35,14 @@ var onRingEnded = (callId, reason) => native?.onRingEnded(callId, reason);
 var onCallFinished = (callId, reason) => native?.onCallFinished(callId, reason ?? null);
 var canUseFullScreenIntent = () => native?.canUseFullScreenIntent() ?? true;
 var openFullScreenIntentSettings = () => native?.openFullScreenIntentSettings();
+function getVoipToken() {
+  return native?.getVoipToken?.() ?? null;
+}
+function onVoipToken(cb) {
+  if (!native || !native.getVoipToken) return () => void 0;
+  const sub = native.addListener("onVoipToken", cb);
+  return () => sub.remove();
+}
 var nativeVideo;
 function nativeVideoView() {
   if (nativeVideo !== void 0) return nativeVideo;
@@ -63,12 +71,14 @@ exports.canUseFullScreenIntent = canUseFullScreenIntent;
 exports.configure = configure;
 exports.decline = decline;
 exports.getCallState = getCallState;
+exports.getVoipToken = getVoipToken;
 exports.hangUp = hangUp;
 exports.join = join;
 exports.nativeCallsAvailable = nativeCallsAvailable;
 exports.onCallFinished = onCallFinished;
 exports.onCallState = onCallState;
 exports.onRingEnded = onRingEnded;
+exports.onVoipToken = onVoipToken;
 exports.openFullScreenIntentSettings = openFullScreenIntentSettings;
 exports.place = place;
 exports.setCamera = setCamera;

package/dist/index.cjs.map

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

package/dist/index.d.cts

@@ -34,8 +34,20 @@ interface Snapshot {
 interface ConfigureOptions {
     /** Drawable resource NAME for the call notification's small icon. */
     smallIcon?: string;
-    /** Raw resource NAME of the ringback tone (Android). */
+    /** Ringback tone: raw resource NAME (Android); main-bundle sound name, mp3/caf/wav (iOS). */
     ringback?: string;
+    /**
+     * iOS: the APNs environment of this build's `aps-environment`
+     * entitlement. Echoed back with the VoIP token so the server pushes to
+     * the right gateway. Ignored on Android.
+     */
+    apnsEnvironment?: 'production' | 'sandbox';
+}
+/** The iOS PushKit (VoIP) token and the APNs environment it belongs to. */
+interface VoipToken {
+    /** Hex-encoded PushKit token. */
+    token: string;
+    environment: 'production' | 'sandbox' | string;
 }
 interface PlaceOptions {
     media: 'audio' | 'video';
@@ -80,6 +92,13 @@ declare const onCallFinished: (callId: string, reason?: string) => void;
 declare const canUseFullScreenIntent: () => boolean;
 /** Open the system screen where the user grants full-screen intents (falls back to notification settings). */
 declare const openFullScreenIntentSettings: () => void;
+/**
+ * iOS: the current PushKit VoIP token, registered natively at launch.
+ * `null` until iOS issues one, and always on Android (FCM carries rings).
+ */
+declare function getVoipToken(): VoipToken | null;
+/** iOS: fires whenever PushKit issues (or rotates) the VoIP token. No-op on Android. */
+declare function onVoipToken(cb: (token: VoipToken) => void): Unsubscribe;
 interface CallVideoViewProps extends ViewProps {
     /** Remote participant's userId (LiveKit identity). Omit with local=true for self view. */
     participantId?: string;
@@ -97,4 +116,4 @@ interface CallVideoViewProps extends ViewProps {
  */
 declare function CallVideoView(props: CallVideoViewProps): ReactElement | null;
 
-export { CallVideoView, type CallVideoViewProps, 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 };
+export { CallVideoView, type CallVideoViewProps, type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, type VoipToken, answer, canUseFullScreenIntent, configure, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setCamera, setMuted, setSpeaker, switchCamera };

package/dist/index.d.ts

@@ -34,8 +34,20 @@ interface Snapshot {
 interface ConfigureOptions {
     /** Drawable resource NAME for the call notification's small icon. */
     smallIcon?: string;
-    /** Raw resource NAME of the ringback tone (Android). */
+    /** Ringback tone: raw resource NAME (Android); main-bundle sound name, mp3/caf/wav (iOS). */
     ringback?: string;
+    /**
+     * iOS: the APNs environment of this build's `aps-environment`
+     * entitlement. Echoed back with the VoIP token so the server pushes to
+     * the right gateway. Ignored on Android.
+     */
+    apnsEnvironment?: 'production' | 'sandbox';
+}
+/** The iOS PushKit (VoIP) token and the APNs environment it belongs to. */
+interface VoipToken {
+    /** Hex-encoded PushKit token. */
+    token: string;
+    environment: 'production' | 'sandbox' | string;
 }
 interface PlaceOptions {
     media: 'audio' | 'video';
@@ -80,6 +92,13 @@ declare const onCallFinished: (callId: string, reason?: string) => void;
 declare const canUseFullScreenIntent: () => boolean;
 /** Open the system screen where the user grants full-screen intents (falls back to notification settings). */
 declare const openFullScreenIntentSettings: () => void;
+/**
+ * iOS: the current PushKit VoIP token, registered natively at launch.
+ * `null` until iOS issues one, and always on Android (FCM carries rings).
+ */
+declare function getVoipToken(): VoipToken | null;
+/** iOS: fires whenever PushKit issues (or rotates) the VoIP token. No-op on Android. */
+declare function onVoipToken(cb: (token: VoipToken) => void): Unsubscribe;
 interface CallVideoViewProps extends ViewProps {
     /** Remote participant's userId (LiveKit identity). Omit with local=true for self view. */
     participantId?: string;
@@ -97,4 +116,4 @@ interface CallVideoViewProps extends ViewProps {
  */
 declare function CallVideoView(props: CallVideoViewProps): ReactElement | null;
 
-export { CallVideoView, type CallVideoViewProps, 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 };
+export { CallVideoView, type CallVideoViewProps, type ConfigureOptions, type PlaceOptions, type Snapshot, type Unsubscribe, type VoipToken, answer, canUseFullScreenIntent, configure, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, onVoipToken, openFullScreenIntentSettings, place, setCamera, setMuted, setSpeaker, switchCamera };

package/dist/index.js

@@ -33,6 +33,14 @@ var onRingEnded = (callId, reason) => native?.onRingEnded(callId, reason);
 var onCallFinished = (callId, reason) => native?.onCallFinished(callId, reason ?? null);
 var canUseFullScreenIntent = () => native?.canUseFullScreenIntent() ?? true;
 var openFullScreenIntentSettings = () => native?.openFullScreenIntentSettings();
+function getVoipToken() {
+  return native?.getVoipToken?.() ?? null;
+}
+function onVoipToken(cb) {
+  if (!native || !native.getVoipToken) return () => void 0;
+  const sub = native.addListener("onVoipToken", cb);
+  return () => sub.remove();
+}
 var nativeVideo;
 function nativeVideoView() {
   if (nativeVideo !== void 0) return nativeVideo;
@@ -55,6 +63,6 @@ function CallVideoView(props) {
   return createElement(Native, props);
 }
 
-export { CallVideoView, answer, canUseFullScreenIntent, configure, decline, getCallState, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, openFullScreenIntentSettings, place, setCamera, setMuted, setSpeaker, switchCamera };
+export { CallVideoView, answer, canUseFullScreenIntent, configure, decline, getCallState, getVoipToken, hangUp, join, nativeCallsAvailable, onCallFinished, onCallState, onRingEnded, onVoipToken, 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":";;;;;AAqFA,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;AAgBhE,IAAI,WAAA;AAGJ,SAAS,eAAA,GAA0D;AACjE,EAAA,IAAI,WAAA,KAAgB,QAAW,OAAO,WAAA;AACtC,EAAA,WAAA,GAAc,IAAA;AACd,EAAA,IAAI,MAAA,EAAQ;AACV,IAAA,IAAI;AACF,MAAA,WAAA,GAAc,wBAAA,CAA2C,eAAe,iBAAiB,CAAA;AAAA,IAC3F,CAAA,CAAA,MAAQ;AACN,MAAA,WAAA,GAAc,IAAA;AAAA,IAChB;AAAA,EACF;AACA,EAAA,OAAO,WAAA;AACT;AAQO,SAAS,cAAc,KAAA,EAAgD;AAC5E,EAAA,MAAM,SAAS,eAAA,EAAgB;AAC/B,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,EAAE,aAAA,EAAe,EAAA,EAAI,KAAA,EAAO,EAAA,EAAI,MAAA,EAAQ,EAAA,EAAI,GAAA,EAAK,EAAA,EAAI,GAAG,IAAA,EAAK,GAAI,KAAA;AACvE,IAAA,OAAO,aAAA,CAAc,MAAM,IAAI,CAAA;AAAA,EACjC;AACA,EAAA,OAAO,aAAA,CAAc,QAAQ,KAAK,CAAA;AACpC","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  audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';\n  mutedSelf: boolean;\n  /** True only while the local camera track is actually published and enabled. */\n  cameraOn: boolean;\n  /** Facing of the published local camera; absent when the camera is off. */\n  cameraFacing?: 'front' | 'back';\n}\n\nexport interface ConfigureOptions {\n  /** Drawable resource NAME for the call notification's small icon. */\n  smallIcon?: string;\n  /** 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\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  audioRoute: 'earpiece' | 'speaker' | 'bluetooth' | 'headset';\n  mutedSelf: boolean;\n  /** True only while the local camera track is actually published and enabled. */\n  cameraOn: boolean;\n  /** Facing of the published local camera; absent when the camera is off. */\n  cameraFacing?: 'front' | 'back';\n}\n\nexport interface ConfigureOptions {\n  /** Drawable resource NAME for the call notification's small icon. */\n  smallIcon?: string;\n  /** Ringback tone: raw resource NAME (Android); main-bundle sound name, mp3/caf/wav (iOS). */\n  ringback?: string;\n  /**\n   * iOS: the APNs environment of this build's `aps-environment`\n   * entitlement. Echoed back with the VoIP token so the server pushes to\n   * the right gateway. Ignored on Android.\n   */\n  apnsEnvironment?: 'production' | 'sandbox';\n}\n\n/** The iOS PushKit (VoIP) token and the APNs environment it belongs to. */\nexport interface VoipToken {\n  /** Hex-encoded PushKit token. */\n  token: string;\n  environment: 'production' | 'sandbox' | string;\n}\n\nexport interface PlaceOptions {\n  media: 'audio' | 'video';\n  /** The user's session token — authorizes placing/joining (CONTRACT.md §3.2). */\n  sessionToken: string;\n}\n\ntype NativeSnapshot = { snapshot: Snapshot | null };\n\ninterface PoolseCallsNative {\n  configure(apiBaseUrl: string, options: ConfigureOptions | null): Promise<void>;\n  getCallState(): NativeSnapshot;\n  place(conversationId: string, media: string, sessionToken: string): Promise<void>;\n  join(callId: string, conversationId: string | null, sessionToken: string): Promise<void>;\n  answer(): void;\n  decline(): void;\n  hangUp(): void;\n  setMuted(muted: boolean): void;\n  setCamera(on: boolean): void;\n  switchCamera(): void;\n  setSpeaker(on: boolean): void;\n  onRingEnded(callId: string, reason: string): void;\n  onCallFinished(callId: string, reason: string | null): void;\n  canUseFullScreenIntent(): boolean;\n  openFullScreenIntentSettings(): void;\n  getVoipToken?(): VoipToken | null;\n  addListener(event: 'onCallState', cb: (payload: NativeSnapshot) => void): { remove(): void };\n  addListener(event: 'onVoipToken', cb: (payload: VoipToken) => void): { remove(): void };\n}\n\nconst native = requireOptionalNativeModule<PoolseCallsNative>('PoolseCalls');\n\n/** True when the native call core is present in this build. */\nexport const nativeCallsAvailable = native != null;\n\n/** Configure once, before any call can arrive. No secrets — just the API origin. */\nexport async function configure(apiBaseUrl: string, options?: ConfigureOptions): Promise<void> {\n  await native?.configure(apiBaseUrl, options ?? null);\n}\n\n/** The current snapshot — safe to read at any moment, including cold answer and before configure. */\nexport function getCallState(): Snapshot | null {\n  return native?.getCallState().snapshot ?? null;\n}\n\nexport type Unsubscribe = () => void;\n\n/** Subscribe to call state. Fires a full snapshot on every change. */\nexport function onCallState(cb: (snapshot: Snapshot | null) => void): Unsubscribe {\n  if (!native) return () => undefined;\n  const sub = native.addListener('onCallState', (payload) => cb(payload.snapshot));\n  return () => sub.remove();\n}\n\nexport function place(conversationId: string, options: PlaceOptions): Promise<void> {\n  return native?.place(conversationId, options.media, options.sessionToken) ?? Promise.resolve();\n}\n\nexport function join(\n  callId: string,\n  conversationId: string | null,\n  sessionToken: string,\n): Promise<void> {\n  return native?.join(callId, conversationId, sessionToken) ?? Promise.resolve();\n}\n\nexport const answer = (): void => native?.answer();\nexport const decline = (): void => native?.decline();\nexport const hangUp = (): void => native?.hangUp();\nexport const setMuted = (muted: boolean): void => native?.setMuted(muted);\nexport const setCamera = (on: boolean): void => native?.setCamera(on);\nexport const switchCamera = (): void => native?.switchCamera();\n/** Route call audio to the loudspeaker (`true`) or back to earpiece / headset (`false`). */\nexport const setSpeaker = (on: boolean): void => native?.setSpeaker(on);\n\n/**\n * Socket forwarding for an open app: a `call:ring_ended` seen on the\n * socket. Idempotent with the push path — the core dedupes.\n */\nexport const onRingEnded = (callId: string, reason: string): void =>\n  native?.onRingEnded(callId, reason);\n\n/**\n * Socket forwarding: `call:finished`. Pass the payload's `reason`\n * (`finished` | `declined_all` | `no_answer` | `cancelled`) so an\n * unanswered caller sees \"Declined\"/\"No answer\", not \"Call ended\".\n * Idempotent with the `finished` push.\n */\nexport const onCallFinished = (callId: string, reason?: string): void =>\n  native?.onCallFinished(callId, reason ?? null);\n\n/**\n * Android 14+: whether the app may show the full-screen ring over the\n * lock screen. `true` on older Android and where the module is absent.\n */\nexport const canUseFullScreenIntent = (): boolean => native?.canUseFullScreenIntent() ?? true;\n\n/** Open the system screen where the user grants full-screen intents (falls back to notification settings). */\nexport const openFullScreenIntentSettings = (): void => native?.openFullScreenIntentSettings();\n\n// ── VoIP push (iOS) ───────────────────────────────────────────────────\n\n/**\n * iOS: the current PushKit VoIP token, registered natively at launch.\n * `null` until iOS issues one, and always on Android (FCM carries rings).\n */\nexport function getVoipToken(): VoipToken | null {\n  return native?.getVoipToken?.() ?? null;\n}\n\n/** iOS: fires whenever PushKit issues (or rotates) the VoIP token. No-op on Android. */\nexport function onVoipToken(cb: (token: VoipToken) => void): Unsubscribe {\n  if (!native || !native.getVoipToken) return () => undefined;\n  const sub = native.addListener('onVoipToken', cb);\n  return () => sub.remove();\n}\n\n// ── video ─────────────────────────────────────────────────────────────\n\nexport interface CallVideoViewProps extends ViewProps {\n  /** Remote participant's userId (LiveKit identity). Omit with local=true for self view. */\n  participantId?: string;\n  local?: boolean;\n  /** default: true for local front camera, false otherwise */\n  mirror?: boolean;\n  /** default 'cover' */\n  fit?: 'cover' | 'contain';\n}\n\ntype NativeVideoProps = CallVideoViewProps;\n\nlet nativeVideo: ComponentType<NativeVideoProps> | null | undefined;\n\n/** Resolved lazily (first render) and only when the native module exists. */\nfunction nativeVideoView(): ComponentType<NativeVideoProps> | null {\n  if (nativeVideo !== undefined) return nativeVideo;\n  nativeVideo = null;\n  if (native) {\n    try {\n      nativeVideo = requireNativeViewManager<NativeVideoProps>('PoolseCalls', 'PoolseCallVideo');\n    } catch {\n      nativeVideo = null; // an older native build without the view\n    }\n  }\n  return nativeVideo;\n}\n\n/**\n * A participant's camera (or, with `local`, your own), rendered natively\n * by the call core. Shows nothing (stays transparent) while that camera\n * is off — draw the avatar from the snapshot's `cameraOn` underneath.\n * Without the native module it renders an empty View.\n */\nexport function CallVideoView(props: CallVideoViewProps): ReactElement | null {\n  const Native = nativeVideoView();\n  if (!Native) {\n    const { participantId: _p, local: _l, mirror: _m, fit: _f, ...rest } = props;\n    return createElement(View, rest);\n  }\n  return createElement(Native, props);\n}\n"]}

package/expo-module.config.json

@@ -1,6 +1,11 @@
 {
-  "platforms": ["android"],
+  "platforms": ["android", "ios"],
   "android": {
     "modules": ["expo.modules.poolsecalls.PoolseCallsModule"]
+  },
+  "ios": {
+    "podspecPath": "ios/PoolseCalls.podspec",
+    "modules": ["PoolseCallsModule"],
+    "appDelegateSubscribers": ["PoolseCallsAppDelegateSubscriber"]
   }
 }

package/ios/Core/CallCoreRuntime.swift

@@ -0,0 +1,393 @@
+import Foundation
+
+/// The engine around the machine: owns the state, serializes events,
+/// executes effects through the ports, runs the timers, and emits a
+/// snapshot after every change. Direct port of CallCoreRuntime.kt.
+///
+/// The machine decides; this class merely obeys. If behavior is wrong,
+/// the fix is in CallMachine + vectors, not here.
+///
+/// Threading: ONE serial queue (the main thread), no lock. Every input —
+/// PushKit, CallKit actions, URLSession callbacks, SFU events, timers, JS
+/// commands — is `post`ed through `executor` (default: hop to
+/// DispatchQueue.main). A result produced while effects execute is QUEUED
+/// behind the current dispatch, never run inside it, and each dispatch
+/// emits its snapshot only after its last effect. Tests pass a direct
+/// executor; the internal trampoline gives them the same ordering.
+public final class CallCoreRuntime {
+
+  public static let ENDED_LINGER_MS: Int64 = 2_500
+  public static let RECONNECT_BUDGET_MS: Int64 = 25_000
+  /// CONNECTING watchdog: two HTTP attempts plus an SFU connect fit inside.
+  public static let CONNECT_WATCHDOG_MS: Int64 = 20_000
+  /// Caller-side backstop if the server's finish/no-answer never arrives.
+  public static let RING_OUT_BACKSTOP_MS: Int64 = 75_000
+  /// Device clocks drift; the deadline is server epoch.
+  public static let CLOCK_SLACK_MS: Int64 = 10_000
+  public static let RESOLVED_LRU = 32
+
+  private static let T_DEADLINE = "ring_deadline"
+  private static let T_LINGER = "linger"
+  private static let T_RECONNECT = "reconnect_budget"
+  private static let T_CONNECT = "connect_watchdog"
+  private static let T_RING_OUT = "ring_out_backstop"
+
+  private let http: HttpPort
+  private let media: MediaPort
+  private let surface: RingSurfacePort
+  private let session: CallSessionPort
+  private let timers: TimerPort
+  private let sink: SnapshotSink
+  private let executor: (@escaping () -> Void) -> Void
+
+  private var state: MachineState = .IDLE
+  /// The ring being shown (its grant answers/declines it).
+  private var ring: RingContext?
+  /// Grants of rings auto-declined busy, kept until the decline fires.
+  private var busyRings: [String: RingContext] = [:]
+  /// The session bundle of the current call, once the server accepted.
+  private var bundle: CallSessionBundle?
+  /// The session token place/join were called with, for one retry.
+  private var sessionToken: String?
+  /// Call generation: bumped when a call starts CONNECTING and when one ends.
+  private var gen = 0
+  /// callIds already resolved on this device; bounded LRU (insertion/refresh order).
+  private var resolved: [String] = []
+
+  private var queue: [() -> Void] = []
+  private var draining = false
+
+  /// `executor` runs a task on the single runtime thread; must be serial.
+  /// Default: inline when already on the main thread, else DispatchQueue.main.async.
+  public init(http: HttpPort, media: MediaPort, surface: RingSurfacePort, session: CallSessionPort,
+              timers: TimerPort, sink: SnapshotSink,
+              executor: ((@escaping () -> Void) -> Void)? = nil) {
+    self.http = http
+    self.media = media
+    self.surface = surface
+    self.session = session
+    self.timers = timers
+    self.sink = sink
+    self.executor = executor ?? { block in
+      if Thread.isMainThread { block() } else { DispatchQueue.main.async(execute: block) }
+    }
+  }
+
+  // MARK: serial queue
+
+  /// Run `block` on the runtime thread, after anything already queued.
+  public func post(_ block: @escaping () -> Void) {
+    executor { [weak self] in self?.enqueue(block) }
+  }
+
+  private func enqueue(_ block: @escaping () -> Void) {
+    queue.append(block)
+    if draining { return } // a dispatch is executing: run after it, not inside it
+    draining = true
+    defer { draining = false }
+    while !queue.isEmpty {
+      let next = queue.removeFirst()
+      next()
+    }
+  }
+
+  // MARK: inputs from adapters
+
+  public func currentState() -> MachineState { state }
+
+  /// Best name for the current call: the server's bundle, else the ring's. Runtime thread only.
+  public var conversationName: String? { bundle?.conversationName ?? ring?.conversationName }
+
+  /// True if `callId` was already resolved here — its ring must never surface again.
+  public func isResolved(_ callId: String) -> Bool { resolved.contains(callId) }
+
+  private func markResolved(_ callId: String?) {
+    guard let callId = callId, !callId.hasPrefix("pending:") else { return }
+    resolved.removeAll { $0 == callId }
+    resolved.append(callId)
+    if resolved.count > CallCoreRuntime.RESOLVED_LRU { resolved.removeFirst(resolved.count - CallCoreRuntime.RESOLVED_LRU) }
+  }
+
+  /// A ring arrived — push or socket, the machine treats them alike.
+  public func onRing(_ ctx: RingContext) {
+    post { [self] in
+      if isResolved(ctx.callId) { return }
+      // A late duplicate of the ring for the call we are already IN must
+      // not read as "another call while busy".
+      let s = state
+      if s.callId == ctx.callId && s.phase != .idle && s.phase != .ringingIn { return }
+      let stale = ctx.ringDeadlineEpochMs + CallCoreRuntime.CLOCK_SLACK_MS <= timers.nowMs()
+      if !stale { busyRings[ctx.callId] = ctx }
+      dispatch(.ring(callId: ctx.callId, conversationId: ctx.conversationId, media: ctx.media, stale: stale),
+               ringCtx: ctx)
+      busyRings.removeValue(forKey: ctx.callId)
+    }
+  }
+
+  public func onRingEnded(callId: String, reason: String) {
+    post { [self] in
+      dispatch(.ringEnded(callId: callId, reason: reason))
+      markResolved(callId)
+    }
+  }
+
+  public func onCallFinished(callId: String, reason: String? = nil) {
+    post { [self] in
+      dispatch(.callFinished(callId: callId, reason: reason))
+      markResolved(callId)
+    }
+  }
+
+  public func answer() { post { [self] in dispatch(.userAnswer) } }
+  public func decline() { post { [self] in dispatch(.userDecline) } }
+  public func hangUp() { post { [self] in dispatch(.userHangup) } }
+
+  public func place(conversationId: String, media: String, sessionToken: String) {
+    post { [self] in
+      if state.phase != .idle && state.phase != .ended { return }
+      self.sessionToken = sessionToken
+      // call_id is server-minted on place; a placeholder keys the state until the bundle arrives.
+      dispatch(.userPlace(callId: "pending:\(conversationId)", conversationId: conversationId, media: media))
+    }
+  }
+
+  public func join(callId: String, conversationId: String?, sessionToken: String) {
+    post { [self] in
+      if state.phase != .idle && state.phase != .ended { return }
+      self.sessionToken = sessionToken
+      dispatch(.userJoin(callId: callId, conversationId: conversationId))
+    }
+  }
+
+  /// Caller-side: the bridge resolved every ring from `ring_states`.
+  public func allRingsResolved(_ outcome: String) { post { [self] in dispatch(.allRingsResolved(outcome: outcome)) } }
+
+  public func onMediaConnected() { post { [self] in dispatch(.mediaConnected) } }
+  public func onMediaFailed() { post { [self] in dispatch(.mediaFailed) } }
+  public func onMediaLost() { post { [self] in dispatch(.mediaLost) } }
+  public func onMediaReconnecting() { post { [self] in dispatch(.mediaReconnecting) } }
+  public func onMediaRecovered() { post { [self] in dispatch(.mediaRecovered) } }
+  public func onRemoteJoined() { post { [self] in dispatch(.remoteJoined) } }
+
+  public func setMuted(_ muted: Bool) { post { [self] in media.setMuted(muted) } }
+  public func setCamera(_ on: Bool) { post { [self] in media.setCamera(on) } }
+  public func switchCamera() { post { [self] in media.switchCamera() } }
+  public func setSpeaker(_ on: Bool) { post { [self] in media.setSpeaker(on) } }
+
+  /// Re-emit the current state (the bridge's roster/route changed).
+  public func reemit() { post { [self] in if state.phase != .idle { sink.emit(state: state) } } }
+
+  // MARK: dispatch
+
+  private func isTerminal(_ p: Phase) -> Bool { p == .idle || p == .ended }
+
+  private func dispatch(_ event: Event, ringCtx: RingContext? = nil) {
+    let before = state
+    let t = CallMachine.transition(before, event)
+    let next = t.state
+    state = next
+    // A new call attempt, or the end of one: old callbacks go stale.
+    if next.phase == .connecting && before.phase != .connecting { gen += 1 }
+    if isTerminal(next.phase) && !isTerminal(before.phase) {
+      gen += 1
+      markResolved(before.callId)
+    }
+    for effect in t.effects { execute(effect, ringCtx: ringCtx) }
+    // Retire the ring grant / bundle only after EVERY effect had its chance.
+    if isTerminal(next.phase) {
+      ring = nil
+      bundle = nil
+      sessionToken = nil
+    }
+    runTimers(before, next)
+    if next != before || !t.effects.isEmpty { sink.emit(state: next) }
+  }
+
+  private func execute(_ effect: Effect, ringCtx: RingContext?) {
+    let g = gen
+    switch effect {
+    case .showRing:
+      ring = ringCtx
+      if let r = ringCtx { surface.show(ring: r) }
+    case .dismissRing:
+      // The grant is NOT retired here: HTTP_DECLINE may follow in this list.
+      if let r = ring ?? ringCtx { surface.dismiss(callId: r.callId) }
+    case .ringtoneStart: surface.ringtoneStart()
+    case .ringtoneStop: surface.ringtoneStop()
+    case .ringbackStart: surface.ringbackStart()
+    case .ringbackStop: surface.ringbackStop()
+
+    case .httpAnswer:
+      if let r = ring {
+        http.answer(callId: r.callId, grant: r.grant) { [weak self] res in
+          self?.post { self?.onHttpResult(g, res) }
+        }
+      } else {
+        post { [weak self] in self?.onHttpResult(g, .authFailed(code: "no_grant")) }
+      }
+    case .httpJoin:
+      if let callId = state.callId, let token = sessionToken {
+        http.join(callId: callId, sessionToken: token) { [weak self] res in
+          self?.post { self?.onHttpResult(g, res) }
+        }
+      } else {
+        post { [weak self] in self?.onHttpResult(g, .authFailed(code: "no_session")) }
+      }
+    case .httpPlace:
+      if let conversationId = state.conversationId, let token = sessionToken {
+        http.place(conversationId: conversationId, media: state.media, sessionToken: token) { [weak self] res in
+          self?.post { self?.onHttpResult(g, res) }
+        }
+      } else {
+        post { [weak self] in self?.onHttpResult(g, .authFailed(code: "no_session")) }
+      }
+    case .httpDecline:
+      if let r = ring { http.decline(callId: r.callId, auth: r.grant, busy: false) }
+    case let .httpDeclineBusy(callId):
+      if let r = busyRings[callId] { http.decline(callId: r.callId, auth: r.grant, busy: true) }
+      markResolved(callId)
+    case .httpHangup:
+      if let b = bundle {
+        http.hangup(callId: b.callId, controlToken: b.controlToken)
+      } else if let r = ring {
+        // Hanging up a connecting answer with no bundle yet: resolve the ring instead.
+        http.decline(callId: r.callId, auth: r.grant, busy: false)
+      }
+    case .httpReconnect:
+      if let b = bundle {
+        http.reconnect(current: b) { [weak self] res in
+          self?.post { self?.onReconnectResult(g, res) }
+        }
+      } else {
+        post { [weak self] in
+          guard let self = self else { return }
+          if g == self.gen { self.dispatch(.httpGone) }
+        }
+      }
+
+    case .mediaJoin:
+      if let b = bundle { media.join(bundle: b) }
+    case .mediaLeave:
+      media.leave()
+
+    case .callSessionStart:
+      session.start(callId: state.callId ?? "", media: state.media)
+    case .callSessionStop:
+      session.stop()
+      bundle = nil
+      ring = nil
+      sessionToken = nil
+    }
+  }
+
+  private func onHttpResult(_ requestGen: Int, _ result: HttpResult) {
+    if requestGen != gen {
+      // The call this request belonged to is over. The server may still have
+      // let us in: leave with the token it just gave us, and keep nothing.
+      if case let .ok(b) = result { http.hangup(callId: b.callId, controlToken: b.controlToken) }
+      return
+    }
+    switch result {
+    case let .ok(b):
+      if let existing = bundle {
+        // The timeout retry's twin answered too. Same call: ignore; different: leave it.
+        if existing.callId != b.callId { http.hangup(callId: b.callId, controlToken: b.controlToken) }
+        return
+      }
+      if state.phase != .connecting {
+        http.hangup(callId: b.callId, controlToken: b.controlToken)
+        return
+      }
+      bundle = b
+      // The server is the authority on the call's identity, conversation and media.
+      state.callId = b.callId
+      state.conversationId = b.conversationId
+      state.media = b.media
+      dispatch(.httpOk(created: b.created))
+    case .gone: dispatch(.httpGone)
+    case .timeout: dispatch(.httpTimeout)
+    case let .authFailed(code): dispatch(.httpFailed(code: code))
+    case let .failed(code): dispatch(.httpFailed(code: code))
+    }
+  }
+
+  private func onReconnectResult(_ requestGen: Int, _ result: HttpResult) {
+    if requestGen != gen || state.phase != .reconnecting { return }
+    switch result {
+    case let .ok(b):
+      // Fresh token (and possibly URL): rejoin. MEDIA_CONNECTED returns us to ACTIVE.
+      bundle = b
+      media.join(bundle: b)
+    case .gone: dispatch(.httpGone)
+    case let .authFailed(code): dispatch(.httpFailed(code: code))
+    case .timeout, .failed: break // transient: the reconnect budget timer is the backstop
+    }
+  }
+
+  // MARK: timers
+
+  private func schedule(_ key: String, _ delayMs: Int64, _ event: Event) {
+    let g = gen
+    timers.schedule(key: key, delayMs: delayMs) { [weak self] in
+      self?.post {
+        guard let self = self else { return }
+        if g == self.gen { self.dispatch(event) }
+      }
+    }
+  }
+
+  private func runTimers(_ before: MachineState, _ after: MachineState) {
+    if before.phase == after.phase { return }
+    switch before.phase {
+    case .ringingIn: timers.cancel(key: CallCoreRuntime.T_DEADLINE)
+    case .ended: timers.cancel(key: CallCoreRuntime.T_LINGER)
+    case .reconnecting: timers.cancel(key: CallCoreRuntime.T_RECONNECT)
+    case .connecting: timers.cancel(key: CallCoreRuntime.T_CONNECT)
+    case .ringingOut: timers.cancel(key: CallCoreRuntime.T_RING_OUT)
+    default: break
+    }
+    switch after.phase {
+    case .ringingIn:
+      guard let deadline = ring?.ringDeadlineEpochMs else { return }
+      // Floor at the clock slack: a non-stale ring still gets a moment on screen.
+      let delay = max(deadline - timers.nowMs(), CallCoreRuntime.CLOCK_SLACK_MS)
+      schedule(CallCoreRuntime.T_DEADLINE, delay, .ringDeadline)
+    case .ended:
+      schedule(CallCoreRuntime.T_LINGER, CallCoreRuntime.ENDED_LINGER_MS, .lingerElapsed)
+    case .reconnecting:
+      schedule(CallCoreRuntime.T_RECONNECT, CallCoreRuntime.RECONNECT_BUDGET_MS, .reconnectBudgetElapsed)
+    case .connecting:
+      schedule(CallCoreRuntime.T_CONNECT, CallCoreRuntime.CONNECT_WATCHDOG_MS, .connectTimeout)
+    case .ringingOut:
+      schedule(CallCoreRuntime.T_RING_OUT, CallCoreRuntime.RING_OUT_BACKSTOP_MS, .allRingsResolved(outcome: "no_answer"))
+    default: break
+    }
+  }
+}
+
+/// The real TimerPort: DispatchQueue.main work items keyed by token.
+/// `nowMs` is wall-clock epoch (compared against the server's ring_deadline);
+/// the delay itself counts down monotonically.
+public final class MainQueueTimerPort: TimerPort {
+  private var pending: [String: DispatchWorkItem] = [:]
+  private let queue: DispatchQueue
+
+  public init(queue: DispatchQueue = .main) { self.queue = queue }
+
+  public func nowMs() -> Int64 { Int64((Date().timeIntervalSince1970 * 1000).rounded()) }
+
+  public func schedule(key: String, delayMs: Int64, fire: @escaping () -> Void) {
+    cancel(key: key)
+    var item: DispatchWorkItem!
+    item = DispatchWorkItem { [weak self] in
+      if let self = self, self.pending[key] === item { self.pending.removeValue(forKey: key) }
+      fire()
+    }
+    pending[key] = item
+    queue.asyncAfter(deadline: .now() + .milliseconds(Int(max(0, delayMs))), execute: item)
+  }
+
+  public func cancel(key: String) {
+    pending.removeValue(forKey: key)?.cancel()
+  }
+}