@lorikeetai/react-native-sdk 2.1.0 → 2.2.0-beta.1

package/README.md

@@ -397,6 +397,165 @@ WebView component that handles the widget content.
 - `webviewProps` (optional): Passed through to the webview component. The SDK
   adds external-link handling on `onNavigationStateChange` and then calls yours
 
+## Voice calls (beta)
+
+`@lorikeetai/react-native-sdk/voice` runs a Lorikeet voice call inside your
+app with native audio, so the customer can keep talking while the app is in
+the background. It is a beta. Install it from the `beta` tag, and expect its
+API to change before it is stable.
+
+Nothing here touches the chat widget. Only the `voice` entry point loads
+LiveKit, so an app that never imports it installs nothing new and needs no
+native rebuild.
+
+### Install
+
+The LiveKit packages are optional peer dependencies, so install them yourself:
+
+```bash
+pnpm add @lorikeetai/react-native-sdk@beta \
+  @livekit/react-native@^3.1.0 \
+  @livekit/react-native-webrtc@^150.1.0 \
+  livekit-client@^2.20.0
+```
+
+`@livekit/react-native` depends on `@livekit/components-react`, which needs
+`react-dom`. Install the `react-dom` version that matches your `react`, or the
+package manager may pick a newer one that your `react` does not satisfy.
+
+Do not install `@livekit/krisp-noise-filter`. The call does not use it, and
+its license is not open source.
+
+Voice requires React Native 0.79 or later, though the chat widget's peer range
+is unchanged. The `voice` subpath is in the package's `exports` map, and 0.79
+ships the first Metro (0.82) that reads that map by default. TypeScript reads
+it with `moduleResolution` set to `bundler` or `node16`, and Expo's base
+`tsconfig` uses `bundler`.
+
+### Native setup
+
+These are native modules. Expo Go does not include them, so use a
+[development build](https://docs.expo.dev/develop/development-builds/introduction/)
+on Expo, and rebuild native code after installing.
+
+With Expo SDK 56 or later, add the two config plugins, the iOS microphone
+string and audio background mode, and the Android audio permissions to
+`app.json`, then run `expo prebuild`:
+
+```bash
+npx expo install @livekit/react-native-expo-plugin @config-plugins/react-native-webrtc
+```
+
+```json
+{
+  "expo": {
+    "platforms": ["ios", "android"],
+    "plugins": [
+      "@livekit/react-native-expo-plugin",
+      "@config-plugins/react-native-webrtc"
+    ],
+    "ios": {
+      "infoPlist": {
+        "NSMicrophoneUsageDescription": "Talk to our support team.",
+        "UIBackgroundModes": ["audio"]
+      }
+    },
+    "android": {
+      "permissions": [
+        "android.permission.RECORD_AUDIO",
+        "android.permission.MODIFY_AUDIO_SETTINGS"
+      ]
+    }
+  }
+}
+```
+
+Set `platforms` to iOS and Android. Expo treats an app with `react-dom`
+installed as web-capable, so `expo export` would also try a web bundle, which
+LiveKit's native modules cannot build.
+
+Use version 1.1.0 or later of `@livekit/react-native-expo-plugin`. It adds the
+`livekit/podspecs` CocoaPods source, which LiveKit's iOS pods need once
+CocoaPods trunk stops accepting new pods on 2 December 2026.
+
+Without Expo, follow LiveKit's
+[installation steps](https://github.com/livekit/client-sdk-react-native#installation).
+Add the `livekit/podspecs` source to your `Podfile`, call
+`LiveKitReactNative.setup` in `MainApplication` and `LivekitReactNative.setup`
+in `AppDelegate`, and add the same permissions and background mode as above.
+
+On Android, the microphone keeps working in the background only while your
+app runs a foreground service of type `microphone`, which the SDK does not
+start for you. Without one, the agent can still be heard, but the customer's
+microphone goes silent when the app leaves the foreground.
+
+### Usage
+
+Your backend creates the session with
+`POST /v1/conversation/voice/web/create`, using your API credentials, and
+returns its `{ conversationId, wsUrl, token }` to the app. Never put your API
+credentials in the app.
+
+```tsx
+import { Button, Text, View } from 'react-native'
+
+import { useLorikeetCall } from '@lorikeetai/react-native-sdk/voice'
+
+export function SupportCall() {
+  const call = useLorikeetCall({
+    getSession: async () => {
+      const response = await fetch('https://api.example.com/support/call', {
+        method: 'POST',
+      })
+      if (response.status === 404) return null
+      if (!response.ok) throw new Error(`Call session: ${response.status}`)
+      return response.json()
+    },
+    onError: (cause) => console.warn('Support call failed', cause),
+  })
+
+  return (
+    <View>
+      <Text>{call.state}</Text>
+      {call.state === 'idle' || call.state === 'error' ? (
+        <Button title="Start call" onPress={() => void call.start()} />
+      ) : (
+        <Button title="End call" onPress={call.end} />
+      )}
+    </View>
+  )
+}
+```
+
+`useLorikeetCall({ getSession, onError })` returns:
+
+- `state`: `idle`, `starting`, `connecting`, `active` or `error`, as in the web
+  Voice Widget. `starting` covers asking for the microphone and fetching the
+  session, and `connecting` covers joining the call.
+- `error`: why the call is in `error`. `microphone_denied` means the customer
+  refused the microphone, or it is off for the app in the device's settings.
+  `not_available` means `getSession` returned `null`. `failed` is anything
+  else, and `onError` receives its cause. `microphone_system_denied` is the web
+  Voice Widget's code for a browser blocked by the operating system, and a
+  mobile device never reports it.
+- `start()`: start a call from `idle` or `error`. The hook asks for microphone
+  access before it calls `getSession`, so a refusal starts no conversation.
+- `end()`: hang up, or abandon a call still starting. The call also ends, and
+  returns to `idle`, when the agent leaves.
+- `ended`: whether the last call ended after it began connecting.
+- `microphoneMuted` and `setMicrophoneMuted(muted)`: mute the customer.
+- `speakerMuted` and `setSpeakerMuted(muted)`: mute the agent.
+
+The call has no live transcript. The conversation is in Lorikeet under its
+`conversationId`.
+
+If your app already calls LiveKit's `registerGlobals()`, the hook leaves your
+configuration alone. Otherwise the hook calls it when the first call starts.
+
+The hook owns the native audio session for the length of a call and stops it
+when the call ends. An app that runs its own LiveKit call at the same time
+should not use the hook.
+
 ## Development
 
 This package is outside the root pnpm workspace, on its own lockfile, so run these from `packages/react-native-widget` after `pnpm install` there.

package/dist/voice.cjs

@@ -0,0 +1,175 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let react = require("react");
+let _livekit_react_native = require("@livekit/react-native");
+let livekit_client = require("livekit-client");
+
+// src/voice/use-lorikeet-call.ts
+/** The server's `LORIKEET_AGENT_IDENTITY`. The call ends when it leaves. */
+const LORIKEET_AGENT_IDENTITY = "lorikeet-agent";
+const errorFor = (error) => {
+	if (typeof error !== "object" || error === null || !("name" in error)) return "failed";
+	return error.name === "SecurityError" || error.name === "NotAllowedError" ? "microphone_denied" : "failed";
+};
+const isSession = (value) => typeof value === "object" && value !== null && "conversationId" in value && typeof value.conversationId === "string" && "token" in value && typeof value.token === "string" && "wsUrl" in value && typeof value.wsUrl === "string";
+/**
+* Runs a Lorikeet voice call over LiveKit's native audio, with the web Voice
+* Widget's states and errors.
+*/
+function useLorikeetCall({ getSession, onError }) {
+	const [state, setState] = (0, react.useState)("idle");
+	const [error, setError] = (0, react.useState)();
+	const [ended, setEnded] = (0, react.useState)(false);
+	const [microphoneMuted, setMicrophoneMutedState] = (0, react.useState)(false);
+	const [speakerMuted, setSpeakerMutedState] = (0, react.useState)(false);
+	const stateRef = (0, react.useRef)(state);
+	const generationRef = (0, react.useRef)(0);
+	const localTrackRef = (0, react.useRef)(null);
+	const roomRef = (0, react.useRef)(null);
+	const speakerMutedRef = (0, react.useRef)(false);
+	const audioSessionActiveRef = (0, react.useRef)(false);
+	const audioSessionStoppedRef = (0, react.useRef)(Promise.resolve());
+	const optionsRef = (0, react.useRef)({
+		getSession,
+		onError
+	});
+	optionsRef.current = {
+		getSession,
+		onError
+	};
+	const transitionTo = (0, react.useCallback)((next) => {
+		stateRef.current = next;
+		setState(next);
+	}, []);
+	const cleanup = (0, react.useCallback)(() => {
+		var _localTrackRef$curren;
+		(_localTrackRef$curren = localTrackRef.current) === null || _localTrackRef$curren === void 0 || _localTrackRef$curren.stop();
+		localTrackRef.current = null;
+		const room = roomRef.current;
+		roomRef.current = null;
+		const disconnected = (room ? room.disconnect() : Promise.resolve()).catch(() => void 0);
+		if (audioSessionActiveRef.current) {
+			audioSessionActiveRef.current = false;
+			audioSessionStoppedRef.current = disconnected.then(() => _livekit_react_native.AudioSession.stopAudioSession()).catch(() => void 0);
+		}
+	}, []);
+	const resetMutes = (0, react.useCallback)(() => {
+		setMicrophoneMutedState(false);
+		setSpeakerMutedState(false);
+		speakerMutedRef.current = false;
+	}, []);
+	const end = (0, react.useCallback)(() => {
+		generationRef.current += 1;
+		cleanup();
+		setEnded(stateRef.current === "connecting" || stateRef.current === "active");
+		setError(void 0);
+		resetMutes();
+		transitionTo("idle");
+	}, [
+		cleanup,
+		resetMutes,
+		transitionTo
+	]);
+	const fail = (0, react.useCallback)((callError) => {
+		generationRef.current += 1;
+		cleanup();
+		setEnded(false);
+		setError(callError);
+		transitionTo("error");
+	}, [cleanup, transitionTo]);
+	(0, react.useEffect)(() => {
+		return () => {
+			generationRef.current += 1;
+			cleanup();
+		};
+	}, [cleanup]);
+	const start = (0, react.useCallback)(async () => {
+		if (stateRef.current !== "idle" && stateRef.current !== "error") return;
+		setError(void 0);
+		setEnded(false);
+		resetMutes();
+		transitionTo("starting");
+		const generation = ++generationRef.current;
+		const isStale = () => generationRef.current !== generation;
+		try {
+			if (!("LiveKitReactNativeGlobal" in globalThis)) (0, _livekit_react_native.registerGlobals)();
+			await audioSessionStoppedRef.current;
+			if (isStale()) return;
+			audioSessionActiveRef.current = true;
+			await _livekit_react_native.AudioSession.startAudioSession();
+			if (isStale()) return;
+			const localTrack = await (0, livekit_client.createLocalAudioTrack)();
+			if (isStale()) {
+				localTrack.stop();
+				return;
+			}
+			localTrackRef.current = localTrack;
+			const session = await optionsRef.current.getSession();
+			if (isStale()) return;
+			if (session === null) {
+				fail("not_available");
+				return;
+			}
+			if (!isSession(session)) throw new TypeError("getSession must resolve to { conversationId, wsUrl, token } or null");
+			transitionTo("connecting");
+			const room = new livekit_client.Room();
+			roomRef.current = room;
+			const isCurrentRoom = () => roomRef.current === room;
+			room.on(livekit_client.RoomEvent.ParticipantDisconnected, (participant) => {
+				if (isCurrentRoom() && participant.identity === "lorikeet-agent") end();
+			});
+			room.on(livekit_client.RoomEvent.TrackSubscribed, (track) => {
+				if (isCurrentRoom() && track instanceof livekit_client.RemoteAudioTrack) track.setVolume(speakerMutedRef.current ? 0 : 1);
+			});
+			let joined = false;
+			room.on(livekit_client.RoomEvent.Disconnected, () => {
+				if (isCurrentRoom() && joined) end();
+			});
+			await room.connect(session.wsUrl, session.token, { autoSubscribe: true });
+			if (isStale()) return;
+			joined = true;
+			await room.localParticipant.publishTrack(localTrack, { source: livekit_client.Track.Source.Microphone });
+			if (isStale()) return;
+			transitionTo("active");
+		} catch (caught) {
+			if (isStale()) return;
+			const callError = errorFor(caught);
+			fail(callError);
+			if (callError === "failed") try {
+				var _optionsRef$current$o, _optionsRef$current;
+				(_optionsRef$current$o = (_optionsRef$current = optionsRef.current).onError) === null || _optionsRef$current$o === void 0 || _optionsRef$current$o.call(_optionsRef$current, caught);
+			} catch {}
+		}
+	}, [
+		end,
+		fail,
+		resetMutes,
+		transitionTo
+	]);
+	return {
+		end,
+		ended,
+		error,
+		microphoneMuted,
+		setMicrophoneMuted: (0, react.useCallback)((muted) => {
+			const track = localTrackRef.current;
+			if (!track) return;
+			const reconcile = () => {
+				if (localTrackRef.current === track) setMicrophoneMutedState(track.isMuted);
+			};
+			(muted ? track.mute() : track.unmute()).then(reconcile, reconcile);
+		}, []),
+		setSpeakerMuted: (0, react.useCallback)((muted) => {
+			var _roomRef$current$remo, _roomRef$current;
+			speakerMutedRef.current = muted;
+			const participants = (_roomRef$current$remo = (_roomRef$current = roomRef.current) === null || _roomRef$current === void 0 ? void 0 : _roomRef$current.remoteParticipants.values()) !== null && _roomRef$current$remo !== void 0 ? _roomRef$current$remo : [];
+			for (const participant of participants) for (const { track } of participant.audioTrackPublications.values()) if (track instanceof livekit_client.RemoteAudioTrack) track.setVolume(muted ? 0 : 1);
+			setSpeakerMutedState(muted);
+		}, []),
+		speakerMuted,
+		start,
+		state
+	};
+}
+
+exports.useLorikeetCall = useLorikeetCall;
+//# sourceMappingURL=voice.cjs.map

package/dist/voice.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.cjs","names":["useState","useRef","useCallback","AudioSession","createLocalAudioTrack","Room","RoomEvent","RemoteAudioTrack","Track"],"sources":["../src/voice/use-lorikeet-call.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\nimport { AudioSession, registerGlobals } from '@livekit/react-native'\nimport {\n  createLocalAudioTrack,\n  type LocalAudioTrack,\n  RemoteAudioTrack,\n  Room,\n  RoomEvent,\n  Track,\n} from 'livekit-client'\n\nimport type {\n  LorikeetCall,\n  LorikeetCallError,\n  LorikeetCallSession,\n  LorikeetCallState,\n  UseLorikeetCallOptions,\n} from './types'\n\n/** The server's `LORIKEET_AGENT_IDENTITY`. The call ends when it leaves. */\nexport const LORIKEET_AGENT_IDENTITY = 'lorikeet-agent'\n\n// react-native-webrtc rejects a refused permission with a plain object named\n// `SecurityError`, not a DOMException, so match on the name alone.\nconst errorFor = (error: unknown): LorikeetCallError => {\n  if (typeof error !== 'object' || error === null || !('name' in error)) {\n    return 'failed'\n  }\n  return error.name === 'SecurityError' || error.name === 'NotAllowedError'\n    ? 'microphone_denied'\n    : 'failed'\n}\n\nconst isSession = (value: unknown): value is LorikeetCallSession =>\n  typeof value === 'object' &&\n  value !== null &&\n  'conversationId' in value &&\n  typeof value.conversationId === 'string' &&\n  'token' in value &&\n  typeof value.token === 'string' &&\n  'wsUrl' in value &&\n  typeof value.wsUrl === 'string'\n\n/**\n * Runs a Lorikeet voice call over LiveKit's native audio, with the web Voice\n * Widget's states and errors.\n */\nexport function useLorikeetCall({\n  getSession,\n  onError,\n}: UseLorikeetCallOptions): LorikeetCall {\n  const [state, setState] = useState<LorikeetCallState>('idle')\n  const [error, setError] = useState<LorikeetCallError | undefined>()\n  const [ended, setEnded] = useState(false)\n  const [microphoneMuted, setMicrophoneMutedState] = useState(false)\n  const [speakerMuted, setSpeakerMutedState] = useState(false)\n\n  const stateRef = useRef(state)\n  const generationRef = useRef(0)\n  const localTrackRef = useRef<LocalAudioTrack | null>(null)\n  const roomRef = useRef<Room | null>(null)\n  const speakerMutedRef = useRef(false)\n  const audioSessionActiveRef = useRef(false)\n  // The previous call's teardown, so the next call cannot start its audio\n  // session only to have that teardown stop it.\n  const audioSessionStoppedRef = useRef<Promise<void>>(Promise.resolve())\n  // Read at call time, so a host passing inline functions keeps `start` stable.\n  const optionsRef = useRef({ getSession, onError })\n  optionsRef.current = { getSession, onError }\n\n  const transitionTo = useCallback((next: LorikeetCallState) => {\n    stateRef.current = next\n    setState(next)\n  }, [])\n\n  const cleanup = useCallback(() => {\n    localTrackRef.current?.stop()\n    localTrackRef.current = null\n    const room = roomRef.current\n    roomRef.current = null\n    // Nothing is left to report a teardown failure to, and a failed disconnect\n    // must not leave the native audio session running.\n    const disconnected = (room ? room.disconnect() : Promise.resolve()).catch(\n      () => undefined,\n    )\n    if (audioSessionActiveRef.current) {\n      audioSessionActiveRef.current = false\n      audioSessionStoppedRef.current = disconnected\n        .then(() => AudioSession.stopAudioSession())\n        .catch(() => undefined)\n    }\n  }, [])\n\n  const resetMutes = useCallback(() => {\n    setMicrophoneMutedState(false)\n    setSpeakerMutedState(false)\n    speakerMutedRef.current = false\n  }, [])\n\n  const end = useCallback(() => {\n    generationRef.current += 1\n    cleanup()\n    setEnded(stateRef.current === 'connecting' || stateRef.current === 'active')\n    setError(undefined)\n    resetMutes()\n    transitionTo('idle')\n  }, [cleanup, resetMutes, transitionTo])\n\n  const fail = useCallback(\n    (callError: LorikeetCallError) => {\n      generationRef.current += 1\n      cleanup()\n      setEnded(false)\n      setError(callError)\n      transitionTo('error')\n    },\n    [cleanup, transitionTo],\n  )\n\n  useEffect(() => {\n    return () => {\n      generationRef.current += 1\n      cleanup()\n    }\n  }, [cleanup])\n\n  const start = useCallback(async () => {\n    if (stateRef.current !== 'idle' && stateRef.current !== 'error') {\n      return\n    }\n\n    setError(undefined)\n    setEnded(false)\n    resetMutes()\n    transitionTo('starting')\n    const generation = ++generationRef.current\n    const isStale = () => generationRef.current !== generation\n\n    try {\n      // `registerGlobals` sets this. Calling it again would replace any iOS\n      // audio setup a host that already uses LiveKit configured itself.\n      if (!('LiveKitReactNativeGlobal' in globalThis)) {\n        registerGlobals()\n      }\n      await audioSessionStoppedRef.current\n      if (isStale()) {\n        return\n      }\n      audioSessionActiveRef.current = true\n      await AudioSession.startAudioSession()\n      if (isStale()) {\n        return\n      }\n\n      const localTrack = await createLocalAudioTrack()\n      if (isStale()) {\n        localTrack.stop()\n        return\n      }\n      localTrackRef.current = localTrack\n\n      const session = await optionsRef.current.getSession()\n      if (isStale()) {\n        return\n      }\n      if (session === null) {\n        fail('not_available')\n        return\n      }\n      if (!isSession(session)) {\n        throw new TypeError(\n          'getSession must resolve to { conversationId, wsUrl, token } or null',\n        )\n      }\n      transitionTo('connecting')\n\n      const room = new Room()\n      roomRef.current = room\n      const isCurrentRoom = () => roomRef.current === room\n      room.on(RoomEvent.ParticipantDisconnected, (participant) => {\n        if (\n          isCurrentRoom() &&\n          participant.identity === LORIKEET_AGENT_IDENTITY\n        ) {\n          end()\n        }\n      })\n      room.on(RoomEvent.TrackSubscribed, (track) => {\n        if (isCurrentRoom() && track instanceof RemoteAudioTrack) {\n          track.setVolume(speakerMutedRef.current ? 0 : 1)\n        }\n      })\n      // A failed join also emits Disconnected, just before `connect` rejects,\n      // and has to surface as `failed` rather than as a hang-up.\n      let joined = false\n      room.on(RoomEvent.Disconnected, () => {\n        if (isCurrentRoom() && joined) {\n          end()\n        }\n      })\n\n      await room.connect(session.wsUrl, session.token, { autoSubscribe: true })\n      if (isStale()) {\n        return\n      }\n      joined = true\n      await room.localParticipant.publishTrack(localTrack, {\n        source: Track.Source.Microphone,\n      })\n      if (isStale()) {\n        return\n      }\n      transitionTo('active')\n    } catch (caught) {\n      if (isStale()) {\n        return\n      }\n      const callError = errorFor(caught)\n      fail(callError)\n      if (callError === 'failed') {\n        try {\n          optionsRef.current.onError?.(caught)\n        } catch {\n          // A host's failing error handler must not turn into an unhandled\n          // rejection from a `start()` that callers fire and forget.\n        }\n      }\n    }\n  }, [end, fail, resetMutes, transitionTo])\n\n  const setMicrophoneMuted = useCallback((muted: boolean) => {\n    const track = localTrackRef.current\n    if (!track) {\n      return\n    }\n    // Report what the track did rather than what was asked, so a mute that\n    // fails is not shown as muted while the customer is still heard.\n    const reconcile = () => {\n      if (localTrackRef.current === track) {\n        setMicrophoneMutedState(track.isMuted)\n      }\n    }\n    void (muted ? track.mute() : track.unmute()).then(reconcile, reconcile)\n  }, [])\n\n  const setSpeakerMuted = useCallback((muted: boolean) => {\n    speakerMutedRef.current = muted\n    const participants = roomRef.current?.remoteParticipants.values() ?? []\n    for (const participant of participants) {\n      for (const { track } of participant.audioTrackPublications.values()) {\n        if (track instanceof RemoteAudioTrack) {\n          track.setVolume(muted ? 0 : 1)\n        }\n      }\n    }\n    setSpeakerMutedState(muted)\n  }, [])\n\n  return {\n    end,\n    ended,\n    error,\n    microphoneMuted,\n    setMicrophoneMuted,\n    setSpeakerMuted,\n    speakerMuted,\n    start,\n    state,\n  }\n}\n"],"mappings":"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"}

package/dist/voice.d.cts

@@ -0,0 +1,74 @@
+/**
+ * What `POST /v1/conversation/voice/web/create` returns. Your backend calls it
+ * with your API credentials and hands the result to the app, which must never
+ * hold those credentials itself.
+ */
+interface LorikeetCallSession {
+  /** The conversation the call belongs to. */
+  conversationId: string;
+  /** The token that admits this customer to the call's room. */
+  token: string;
+  /** The voice server to connect to. */
+  wsUrl: string;
+}
+/** The web Voice Widget's call states. */
+type LorikeetCallState = 'idle' | 'starting' | 'connecting' | 'active' | 'error';
+/**
+ * Why a call is in `error`, from the web Voice Widget's set.
+ *
+ * - `not_available`: `getSession` returned `null`.
+ * - `microphone_denied`: the customer refused microphone access, or it is off
+ *   for the app in the device's settings.
+ * - `microphone_system_denied`: the web Voice Widget's code for a browser
+ *   blocked by the operating system. Kept so one handler covers both
+ *   platforms. A mobile device reports `microphone_denied` instead.
+ * - `failed`: anything else. `onError` receives the cause.
+ */
+type LorikeetCallError = 'not_available' | 'microphone_denied' | 'microphone_system_denied' | 'failed';
+interface UseLorikeetCallOptions {
+  /**
+   * Fetches a session from your backend for a new call. Called each time the
+   * customer starts one, after microphone access is granted, so a refused
+   * microphone starts no conversation.
+   *
+   * Return `null` when calling is not available to this customer, which puts
+   * the call in `error` with `not_available`. Throw, or return anything that
+   * is not a session, for `failed`.
+   */
+  getSession: () => Promise<LorikeetCallSession | null>;
+  /**
+   * Receives the cause whenever a call fails with `failed`. Anything it throws
+   * is ignored.
+   */
+  onError?: (cause: unknown) => void;
+}
+interface LorikeetCall {
+  /** End the call, or abandon one still starting. The state returns to `idle`. */
+  end: () => void;
+  /**
+   * Whether the last call ended, by either side, after it began connecting.
+   * Reset when the next call starts.
+   */
+  ended: boolean;
+  /** Set while `state` is `error`. */
+  error: LorikeetCallError | undefined;
+  microphoneMuted: boolean;
+  /** Mute or unmute the customer's microphone. Only applies to a call in progress. */
+  setMicrophoneMuted: (muted: boolean) => void;
+  /** Mute or unmute the agent's audio. */
+  setSpeakerMuted: (muted: boolean) => void;
+  speakerMuted: boolean;
+  /**
+   * Start a call from `idle` or `error`. Does nothing in any other state.
+   * Never rejects: a failure is reported through `state` and `error`.
+   */
+  start: () => Promise<void>;
+  state: LorikeetCallState;
+}
+/**
+ * Runs a Lorikeet voice call over LiveKit's native audio, with the web Voice
+ * Widget's states and errors.
+ */
+declare function useLorikeetCall({ getSession, onError }: UseLorikeetCallOptions): LorikeetCall;
+export { type LorikeetCall, type LorikeetCallError, type LorikeetCallSession, type LorikeetCallState, type UseLorikeetCallOptions, useLorikeetCall };
+//# sourceMappingURL=voice.d.cts.map

package/dist/voice.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.cts","names":[],"sources":["../src/voice/types.ts","../src/voice/use-lorikeet-call.ts"],"mappings":";;;;;UAKiB;;EAEf;;EAEA;;EAEA;;;KAIU;;;;;;;;;;;;KAkBA;UAMK;;;;;;;;;;EAUf,kBAAkB,QAAQ;;;;;EAK1B,WAAW;;UAGI;;EAEf;;;;;EAKA;;EAEA,OAAO;EACP;;EAEA,qBAAqB;;EAErB,kBAAkB;EAClB;;;;;EAKA,aAAa;EACb,OAAO;;;;;;iBC9BO,kBACd,YACA,WACC,yBAAyB"}

package/dist/voice.d.ts

@@ -0,0 +1,74 @@
+/**
+ * What `POST /v1/conversation/voice/web/create` returns. Your backend calls it
+ * with your API credentials and hands the result to the app, which must never
+ * hold those credentials itself.
+ */
+interface LorikeetCallSession {
+  /** The conversation the call belongs to. */
+  conversationId: string;
+  /** The token that admits this customer to the call's room. */
+  token: string;
+  /** The voice server to connect to. */
+  wsUrl: string;
+}
+/** The web Voice Widget's call states. */
+type LorikeetCallState = 'idle' | 'starting' | 'connecting' | 'active' | 'error';
+/**
+ * Why a call is in `error`, from the web Voice Widget's set.
+ *
+ * - `not_available`: `getSession` returned `null`.
+ * - `microphone_denied`: the customer refused microphone access, or it is off
+ *   for the app in the device's settings.
+ * - `microphone_system_denied`: the web Voice Widget's code for a browser
+ *   blocked by the operating system. Kept so one handler covers both
+ *   platforms. A mobile device reports `microphone_denied` instead.
+ * - `failed`: anything else. `onError` receives the cause.
+ */
+type LorikeetCallError = 'not_available' | 'microphone_denied' | 'microphone_system_denied' | 'failed';
+interface UseLorikeetCallOptions {
+  /**
+   * Fetches a session from your backend for a new call. Called each time the
+   * customer starts one, after microphone access is granted, so a refused
+   * microphone starts no conversation.
+   *
+   * Return `null` when calling is not available to this customer, which puts
+   * the call in `error` with `not_available`. Throw, or return anything that
+   * is not a session, for `failed`.
+   */
+  getSession: () => Promise<LorikeetCallSession | null>;
+  /**
+   * Receives the cause whenever a call fails with `failed`. Anything it throws
+   * is ignored.
+   */
+  onError?: (cause: unknown) => void;
+}
+interface LorikeetCall {
+  /** End the call, or abandon one still starting. The state returns to `idle`. */
+  end: () => void;
+  /**
+   * Whether the last call ended, by either side, after it began connecting.
+   * Reset when the next call starts.
+   */
+  ended: boolean;
+  /** Set while `state` is `error`. */
+  error: LorikeetCallError | undefined;
+  microphoneMuted: boolean;
+  /** Mute or unmute the customer's microphone. Only applies to a call in progress. */
+  setMicrophoneMuted: (muted: boolean) => void;
+  /** Mute or unmute the agent's audio. */
+  setSpeakerMuted: (muted: boolean) => void;
+  speakerMuted: boolean;
+  /**
+   * Start a call from `idle` or `error`. Does nothing in any other state.
+   * Never rejects: a failure is reported through `state` and `error`.
+   */
+  start: () => Promise<void>;
+  state: LorikeetCallState;
+}
+/**
+ * Runs a Lorikeet voice call over LiveKit's native audio, with the web Voice
+ * Widget's states and errors.
+ */
+declare function useLorikeetCall({ getSession, onError }: UseLorikeetCallOptions): LorikeetCall;
+export { type LorikeetCall, type LorikeetCallError, type LorikeetCallSession, type LorikeetCallState, type UseLorikeetCallOptions, useLorikeetCall };
+//# sourceMappingURL=voice.d.ts.map

package/dist/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","names":[],"sources":["../src/voice/types.ts","../src/voice/use-lorikeet-call.ts"],"mappings":";;;;;UAKiB;;EAEf;;EAEA;;EAEA;;;KAIU;;;;;;;;;;;;KAkBA;UAMK;;;;;;;;;;EAUf,kBAAkB,QAAQ;;;;;EAK1B,WAAW;;UAGI;;EAEf;;;;;EAKA;;EAEA,OAAO;EACP;;EAEA,qBAAqB;;EAErB,kBAAkB;EAClB;;;;;EAKA,aAAa;EACb,OAAO;;;;;;iBC9BO,kBACd,YACA,WACC,yBAAyB"}

package/dist/voice.js

@@ -0,0 +1,174 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { AudioSession, registerGlobals } from "@livekit/react-native";
+import { RemoteAudioTrack, Room, RoomEvent, Track, createLocalAudioTrack } from "livekit-client";
+
+// src/voice/use-lorikeet-call.ts
+/** The server's `LORIKEET_AGENT_IDENTITY`. The call ends when it leaves. */
+const LORIKEET_AGENT_IDENTITY = "lorikeet-agent";
+const errorFor = (error) => {
+	if (typeof error !== "object" || error === null || !("name" in error)) return "failed";
+	return error.name === "SecurityError" || error.name === "NotAllowedError" ? "microphone_denied" : "failed";
+};
+const isSession = (value) => typeof value === "object" && value !== null && "conversationId" in value && typeof value.conversationId === "string" && "token" in value && typeof value.token === "string" && "wsUrl" in value && typeof value.wsUrl === "string";
+/**
+* Runs a Lorikeet voice call over LiveKit's native audio, with the web Voice
+* Widget's states and errors.
+*/
+function useLorikeetCall({ getSession, onError }) {
+	const [state, setState] = useState("idle");
+	const [error, setError] = useState();
+	const [ended, setEnded] = useState(false);
+	const [microphoneMuted, setMicrophoneMutedState] = useState(false);
+	const [speakerMuted, setSpeakerMutedState] = useState(false);
+	const stateRef = useRef(state);
+	const generationRef = useRef(0);
+	const localTrackRef = useRef(null);
+	const roomRef = useRef(null);
+	const speakerMutedRef = useRef(false);
+	const audioSessionActiveRef = useRef(false);
+	const audioSessionStoppedRef = useRef(Promise.resolve());
+	const optionsRef = useRef({
+		getSession,
+		onError
+	});
+	optionsRef.current = {
+		getSession,
+		onError
+	};
+	const transitionTo = useCallback((next) => {
+		stateRef.current = next;
+		setState(next);
+	}, []);
+	const cleanup = useCallback(() => {
+		var _localTrackRef$curren;
+		(_localTrackRef$curren = localTrackRef.current) === null || _localTrackRef$curren === void 0 || _localTrackRef$curren.stop();
+		localTrackRef.current = null;
+		const room = roomRef.current;
+		roomRef.current = null;
+		const disconnected = (room ? room.disconnect() : Promise.resolve()).catch(() => void 0);
+		if (audioSessionActiveRef.current) {
+			audioSessionActiveRef.current = false;
+			audioSessionStoppedRef.current = disconnected.then(() => AudioSession.stopAudioSession()).catch(() => void 0);
+		}
+	}, []);
+	const resetMutes = useCallback(() => {
+		setMicrophoneMutedState(false);
+		setSpeakerMutedState(false);
+		speakerMutedRef.current = false;
+	}, []);
+	const end = useCallback(() => {
+		generationRef.current += 1;
+		cleanup();
+		setEnded(stateRef.current === "connecting" || stateRef.current === "active");
+		setError(void 0);
+		resetMutes();
+		transitionTo("idle");
+	}, [
+		cleanup,
+		resetMutes,
+		transitionTo
+	]);
+	const fail = useCallback((callError) => {
+		generationRef.current += 1;
+		cleanup();
+		setEnded(false);
+		setError(callError);
+		transitionTo("error");
+	}, [cleanup, transitionTo]);
+	useEffect(() => {
+		return () => {
+			generationRef.current += 1;
+			cleanup();
+		};
+	}, [cleanup]);
+	const start = useCallback(async () => {
+		if (stateRef.current !== "idle" && stateRef.current !== "error") return;
+		setError(void 0);
+		setEnded(false);
+		resetMutes();
+		transitionTo("starting");
+		const generation = ++generationRef.current;
+		const isStale = () => generationRef.current !== generation;
+		try {
+			if (!("LiveKitReactNativeGlobal" in globalThis)) registerGlobals();
+			await audioSessionStoppedRef.current;
+			if (isStale()) return;
+			audioSessionActiveRef.current = true;
+			await AudioSession.startAudioSession();
+			if (isStale()) return;
+			const localTrack = await createLocalAudioTrack();
+			if (isStale()) {
+				localTrack.stop();
+				return;
+			}
+			localTrackRef.current = localTrack;
+			const session = await optionsRef.current.getSession();
+			if (isStale()) return;
+			if (session === null) {
+				fail("not_available");
+				return;
+			}
+			if (!isSession(session)) throw new TypeError("getSession must resolve to { conversationId, wsUrl, token } or null");
+			transitionTo("connecting");
+			const room = new Room();
+			roomRef.current = room;
+			const isCurrentRoom = () => roomRef.current === room;
+			room.on(RoomEvent.ParticipantDisconnected, (participant) => {
+				if (isCurrentRoom() && participant.identity === "lorikeet-agent") end();
+			});
+			room.on(RoomEvent.TrackSubscribed, (track) => {
+				if (isCurrentRoom() && track instanceof RemoteAudioTrack) track.setVolume(speakerMutedRef.current ? 0 : 1);
+			});
+			let joined = false;
+			room.on(RoomEvent.Disconnected, () => {
+				if (isCurrentRoom() && joined) end();
+			});
+			await room.connect(session.wsUrl, session.token, { autoSubscribe: true });
+			if (isStale()) return;
+			joined = true;
+			await room.localParticipant.publishTrack(localTrack, { source: Track.Source.Microphone });
+			if (isStale()) return;
+			transitionTo("active");
+		} catch (caught) {
+			if (isStale()) return;
+			const callError = errorFor(caught);
+			fail(callError);
+			if (callError === "failed") try {
+				var _optionsRef$current$o, _optionsRef$current;
+				(_optionsRef$current$o = (_optionsRef$current = optionsRef.current).onError) === null || _optionsRef$current$o === void 0 || _optionsRef$current$o.call(_optionsRef$current, caught);
+			} catch {}
+		}
+	}, [
+		end,
+		fail,
+		resetMutes,
+		transitionTo
+	]);
+	return {
+		end,
+		ended,
+		error,
+		microphoneMuted,
+		setMicrophoneMuted: useCallback((muted) => {
+			const track = localTrackRef.current;
+			if (!track) return;
+			const reconcile = () => {
+				if (localTrackRef.current === track) setMicrophoneMutedState(track.isMuted);
+			};
+			(muted ? track.mute() : track.unmute()).then(reconcile, reconcile);
+		}, []),
+		setSpeakerMuted: useCallback((muted) => {
+			var _roomRef$current$remo, _roomRef$current;
+			speakerMutedRef.current = muted;
+			const participants = (_roomRef$current$remo = (_roomRef$current = roomRef.current) === null || _roomRef$current === void 0 ? void 0 : _roomRef$current.remoteParticipants.values()) !== null && _roomRef$current$remo !== void 0 ? _roomRef$current$remo : [];
+			for (const participant of participants) for (const { track } of participant.audioTrackPublications.values()) if (track instanceof RemoteAudioTrack) track.setVolume(muted ? 0 : 1);
+			setSpeakerMutedState(muted);
+		}, []),
+		speakerMuted,
+		start,
+		state
+	};
+}
+
+export { useLorikeetCall };
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","names":[],"sources":["../src/voice/use-lorikeet-call.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\nimport { AudioSession, registerGlobals } from '@livekit/react-native'\nimport {\n  createLocalAudioTrack,\n  type LocalAudioTrack,\n  RemoteAudioTrack,\n  Room,\n  RoomEvent,\n  Track,\n} from 'livekit-client'\n\nimport type {\n  LorikeetCall,\n  LorikeetCallError,\n  LorikeetCallSession,\n  LorikeetCallState,\n  UseLorikeetCallOptions,\n} from './types'\n\n/** The server's `LORIKEET_AGENT_IDENTITY`. The call ends when it leaves. */\nexport const LORIKEET_AGENT_IDENTITY = 'lorikeet-agent'\n\n// react-native-webrtc rejects a refused permission with a plain object named\n// `SecurityError`, not a DOMException, so match on the name alone.\nconst errorFor = (error: unknown): LorikeetCallError => {\n  if (typeof error !== 'object' || error === null || !('name' in error)) {\n    return 'failed'\n  }\n  return error.name === 'SecurityError' || error.name === 'NotAllowedError'\n    ? 'microphone_denied'\n    : 'failed'\n}\n\nconst isSession = (value: unknown): value is LorikeetCallSession =>\n  typeof value === 'object' &&\n  value !== null &&\n  'conversationId' in value &&\n  typeof value.conversationId === 'string' &&\n  'token' in value &&\n  typeof value.token === 'string' &&\n  'wsUrl' in value &&\n  typeof value.wsUrl === 'string'\n\n/**\n * Runs a Lorikeet voice call over LiveKit's native audio, with the web Voice\n * Widget's states and errors.\n */\nexport function useLorikeetCall({\n  getSession,\n  onError,\n}: UseLorikeetCallOptions): LorikeetCall {\n  const [state, setState] = useState<LorikeetCallState>('idle')\n  const [error, setError] = useState<LorikeetCallError | undefined>()\n  const [ended, setEnded] = useState(false)\n  const [microphoneMuted, setMicrophoneMutedState] = useState(false)\n  const [speakerMuted, setSpeakerMutedState] = useState(false)\n\n  const stateRef = useRef(state)\n  const generationRef = useRef(0)\n  const localTrackRef = useRef<LocalAudioTrack | null>(null)\n  const roomRef = useRef<Room | null>(null)\n  const speakerMutedRef = useRef(false)\n  const audioSessionActiveRef = useRef(false)\n  // The previous call's teardown, so the next call cannot start its audio\n  // session only to have that teardown stop it.\n  const audioSessionStoppedRef = useRef<Promise<void>>(Promise.resolve())\n  // Read at call time, so a host passing inline functions keeps `start` stable.\n  const optionsRef = useRef({ getSession, onError })\n  optionsRef.current = { getSession, onError }\n\n  const transitionTo = useCallback((next: LorikeetCallState) => {\n    stateRef.current = next\n    setState(next)\n  }, [])\n\n  const cleanup = useCallback(() => {\n    localTrackRef.current?.stop()\n    localTrackRef.current = null\n    const room = roomRef.current\n    roomRef.current = null\n    // Nothing is left to report a teardown failure to, and a failed disconnect\n    // must not leave the native audio session running.\n    const disconnected = (room ? room.disconnect() : Promise.resolve()).catch(\n      () => undefined,\n    )\n    if (audioSessionActiveRef.current) {\n      audioSessionActiveRef.current = false\n      audioSessionStoppedRef.current = disconnected\n        .then(() => AudioSession.stopAudioSession())\n        .catch(() => undefined)\n    }\n  }, [])\n\n  const resetMutes = useCallback(() => {\n    setMicrophoneMutedState(false)\n    setSpeakerMutedState(false)\n    speakerMutedRef.current = false\n  }, [])\n\n  const end = useCallback(() => {\n    generationRef.current += 1\n    cleanup()\n    setEnded(stateRef.current === 'connecting' || stateRef.current === 'active')\n    setError(undefined)\n    resetMutes()\n    transitionTo('idle')\n  }, [cleanup, resetMutes, transitionTo])\n\n  const fail = useCallback(\n    (callError: LorikeetCallError) => {\n      generationRef.current += 1\n      cleanup()\n      setEnded(false)\n      setError(callError)\n      transitionTo('error')\n    },\n    [cleanup, transitionTo],\n  )\n\n  useEffect(() => {\n    return () => {\n      generationRef.current += 1\n      cleanup()\n    }\n  }, [cleanup])\n\n  const start = useCallback(async () => {\n    if (stateRef.current !== 'idle' && stateRef.current !== 'error') {\n      return\n    }\n\n    setError(undefined)\n    setEnded(false)\n    resetMutes()\n    transitionTo('starting')\n    const generation = ++generationRef.current\n    const isStale = () => generationRef.current !== generation\n\n    try {\n      // `registerGlobals` sets this. Calling it again would replace any iOS\n      // audio setup a host that already uses LiveKit configured itself.\n      if (!('LiveKitReactNativeGlobal' in globalThis)) {\n        registerGlobals()\n      }\n      await audioSessionStoppedRef.current\n      if (isStale()) {\n        return\n      }\n      audioSessionActiveRef.current = true\n      await AudioSession.startAudioSession()\n      if (isStale()) {\n        return\n      }\n\n      const localTrack = await createLocalAudioTrack()\n      if (isStale()) {\n        localTrack.stop()\n        return\n      }\n      localTrackRef.current = localTrack\n\n      const session = await optionsRef.current.getSession()\n      if (isStale()) {\n        return\n      }\n      if (session === null) {\n        fail('not_available')\n        return\n      }\n      if (!isSession(session)) {\n        throw new TypeError(\n          'getSession must resolve to { conversationId, wsUrl, token } or null',\n        )\n      }\n      transitionTo('connecting')\n\n      const room = new Room()\n      roomRef.current = room\n      const isCurrentRoom = () => roomRef.current === room\n      room.on(RoomEvent.ParticipantDisconnected, (participant) => {\n        if (\n          isCurrentRoom() &&\n          participant.identity === LORIKEET_AGENT_IDENTITY\n        ) {\n          end()\n        }\n      })\n      room.on(RoomEvent.TrackSubscribed, (track) => {\n        if (isCurrentRoom() && track instanceof RemoteAudioTrack) {\n          track.setVolume(speakerMutedRef.current ? 0 : 1)\n        }\n      })\n      // A failed join also emits Disconnected, just before `connect` rejects,\n      // and has to surface as `failed` rather than as a hang-up.\n      let joined = false\n      room.on(RoomEvent.Disconnected, () => {\n        if (isCurrentRoom() && joined) {\n          end()\n        }\n      })\n\n      await room.connect(session.wsUrl, session.token, { autoSubscribe: true })\n      if (isStale()) {\n        return\n      }\n      joined = true\n      await room.localParticipant.publishTrack(localTrack, {\n        source: Track.Source.Microphone,\n      })\n      if (isStale()) {\n        return\n      }\n      transitionTo('active')\n    } catch (caught) {\n      if (isStale()) {\n        return\n      }\n      const callError = errorFor(caught)\n      fail(callError)\n      if (callError === 'failed') {\n        try {\n          optionsRef.current.onError?.(caught)\n        } catch {\n          // A host's failing error handler must not turn into an unhandled\n          // rejection from a `start()` that callers fire and forget.\n        }\n      }\n    }\n  }, [end, fail, resetMutes, transitionTo])\n\n  const setMicrophoneMuted = useCallback((muted: boolean) => {\n    const track = localTrackRef.current\n    if (!track) {\n      return\n    }\n    // Report what the track did rather than what was asked, so a mute that\n    // fails is not shown as muted while the customer is still heard.\n    const reconcile = () => {\n      if (localTrackRef.current === track) {\n        setMicrophoneMutedState(track.isMuted)\n      }\n    }\n    void (muted ? track.mute() : track.unmute()).then(reconcile, reconcile)\n  }, [])\n\n  const setSpeakerMuted = useCallback((muted: boolean) => {\n    speakerMutedRef.current = muted\n    const participants = roomRef.current?.remoteParticipants.values() ?? []\n    for (const participant of participants) {\n      for (const { track } of participant.audioTrackPublications.values()) {\n        if (track instanceof RemoteAudioTrack) {\n          track.setVolume(muted ? 0 : 1)\n        }\n      }\n    }\n    setSpeakerMutedState(muted)\n  }, [])\n\n  return {\n    end,\n    ended,\n    error,\n    microphoneMuted,\n    setMicrophoneMuted,\n    setSpeakerMuted,\n    speakerMuted,\n    start,\n    state,\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@lorikeetai/react-native-sdk",
-  "version": "2.1.0",
+  "version": "2.2.0-beta.1",
   "type": "module",
   "private": false,
-  "description": "LorikeetCX React Native widget for embedding the chat widget via WebView",
+  "description": "LorikeetCX React Native SDK: the chat widget in a WebView, and in-app voice calls",
   "keywords": [
     "lorikeet",
     "react-native",
     "webview",
-    "widget"
+    "widget",
+    "voice"
   ],
   "author": "LorikeetCX.ai",
   "license": "MIT",
@@ -27,20 +28,48 @@
       "react-native": "./dist/index.js",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./voice": {
+      "react-native": "./dist/voice.js",
+      "import": {
+        "types": "./dist/voice.d.ts",
+        "default": "./dist/voice.js"
+      },
+      "require": {
+        "types": "./dist/voice.d.cts",
+        "default": "./dist/voice.cjs"
+      }
     }
   },
   "peerDependencies": {
+    "@livekit/react-native": "^3.1.0",
+    "@livekit/react-native-webrtc": "^150.1.0",
+    "livekit-client": "^2.20.0",
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
     "react-native-safe-area-context": ">=4.0.0 <6.0.0",
     "react-native-svg": ">=13.0.0 <16.0.0",
     "react-native-webview": ">=13.0.0 <14.0.0"
   },
+  "peerDependenciesMeta": {
+    "@livekit/react-native": {
+      "optional": true
+    },
+    "@livekit/react-native-webrtc": {
+      "optional": true
+    },
+    "livekit-client": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@livekit/react-native": "3.1.0",
+    "@livekit/react-native-webrtc": "150.1.1",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^19.0.0",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "happy-dom": "^21.0.4",
+    "livekit-client": "^2.23.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-native": "0.81.4",