@oneinbox/web-sdk-react 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OneInbox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @oneinbox/web-sdk-react
+
+React bindings for [`@oneinbox/web-sdk`](https://www.npmjs.com/package/@oneinbox/web-sdk) — a `<OneInboxProvider>` and a `useOneInbox()` hook for browser voice calls to a [OneInbox](https://oneinbox.ai) agent over WebRTC.
+
+## Install
+
+```bash
+npm install @oneinbox/web-sdk-react @oneinbox/web-sdk livekit-client react
+```
+
+## Usage
+
+```tsx
+import { OneInboxProvider, useOneInbox } from "@oneinbox/web-sdk-react";
+
+function App() {
+  return (
+    <OneInboxProvider publishableKey="oi_pk_live_…">
+      <CallButton agentId="agt_…" />
+    </OneInboxProvider>
+  );
+}
+
+function CallButton({ agentId }: { agentId: string }) {
+  const { start, stop, status, transcripts, isAgentSpeaking, isMuted, setMuted } = useOneInbox();
+  const active = status === "active";
+  return (
+    <div>
+      <button onClick={() => (active ? stop() : start(agentId))}>
+        {active ? "Hang up" : "Call"}
+      </button>
+      {active && <button onClick={() => setMuted(!isMuted)}>{isMuted ? "Unmute" : "Mute"}</button>}
+      <p>{isAgentSpeaking ? "🗣 agent speaking" : status}</p>
+      <ul>{transcripts.map((t, i) => <li key={i}><b>{t.role}:</b> {t.text}</li>)}</ul>
+    </div>
+  );
+}
+```
+
+`useOneInbox()` returns `{ start, stop, setMuted, status, isMuted, isAgentSpeaking, volume, transcripts, error, client }`. Auth, events, and error codes are documented in [`@oneinbox/web-sdk`](https://www.npmjs.com/package/@oneinbox/web-sdk).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,89 @@
+'use strict';
+
+var webSdk = require('@oneinbox/web-sdk');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/index.tsx
+var OneInboxContext = react.createContext(null);
+function OneInboxProvider({
+  publishableKey,
+  children,
+  ...config
+}) {
+  const baseUrl = config.baseUrl;
+  const client = react.useMemo(
+    () => new webSdk.OneInbox(publishableKey, { baseUrl }),
+    [publishableKey, baseUrl]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(OneInboxContext.Provider, { value: client, children });
+}
+function useOneInboxClient() {
+  const client = react.useContext(OneInboxContext);
+  if (!client) {
+    throw new Error("useOneInbox must be used within an <OneInboxProvider>.");
+  }
+  return client;
+}
+function useOneInbox() {
+  const client = useOneInboxClient();
+  const [status, setStatus] = react.useState(client.status);
+  const [isMuted, setIsMuted] = react.useState(client.isMuted());
+  const [isAgentSpeaking, setIsAgentSpeaking] = react.useState(false);
+  const [volume, setVolume] = react.useState(0);
+  const [transcripts, setTranscripts] = react.useState([]);
+  const [error, setError] = react.useState(null);
+  const clientRef = react.useRef(client);
+  clientRef.current = client;
+  react.useEffect(() => {
+    const offs = [
+      client.on("status", setStatus),
+      client.on("volume-level", setVolume),
+      client.on("error", setError),
+      client.on("transcript", (t) => setTranscripts((prev) => [...prev, t])),
+      client.on("speech-start", (who) => {
+        if (who === "agent") setIsAgentSpeaking(true);
+      }),
+      client.on("speech-end", (who) => {
+        if (who === "agent") setIsAgentSpeaking(false);
+      }),
+      client.on("call-start", () => {
+        setTranscripts([]);
+        setError(null);
+        setIsMuted(client.isMuted());
+      }),
+      client.on("call-end", () => {
+        setIsAgentSpeaking(false);
+        setVolume(0);
+      })
+    ];
+    return () => offs.forEach((off) => off());
+  }, [client]);
+  const start = react.useCallback(
+    (agentId, opts) => clientRef.current.start(agentId, opts),
+    []
+  );
+  const stop = react.useCallback(() => clientRef.current.stop(), []);
+  const setMuted = react.useCallback((muted) => {
+    clientRef.current.setMuted(muted);
+    setIsMuted(muted);
+  }, []);
+  return {
+    start,
+    stop,
+    setMuted,
+    status,
+    isMuted,
+    isAgentSpeaking,
+    volume,
+    transcripts,
+    error,
+    client
+  };
+}
+
+exports.OneInboxProvider = OneInboxProvider;
+exports.useOneInbox = useOneInbox;
+exports.useOneInboxClient = useOneInboxClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["createContext","useMemo","OneInbox","useContext","useState","useRef","useEffect","useCallback"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n  type CallStatus,\n  OneInbox,\n  type OneInboxConfig,\n  type OneInboxError,\n  type StartOptions,\n  type TranscriptEvent,\n} from \"@oneinbox/web-sdk\";\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\n\nexport type { CallStatus, OneInboxError, StartOptions, TranscriptEvent };\n\nconst OneInboxContext = createContext<OneInbox | null>(null);\n\nexport interface OneInboxProviderProps extends OneInboxConfig {\n  /** Publishable key (`oi_pk_…`). */\n  publishableKey: string;\n  children: ReactNode;\n}\n\n/**\n * Provides a single `OneInbox` instance to the tree. Place near the root.\n *\n * ```tsx\n * <OneInboxProvider publishableKey=\"oi_pk_…\">\n *   <App />\n * </OneInboxProvider>\n * ```\n */\nexport function OneInboxProvider({\n  publishableKey,\n  children,\n  ...config\n}: OneInboxProviderProps) {\n  // baseUrl is the only config field today; spread keeps it forward-compatible.\n  const baseUrl = config.baseUrl;\n  const client = useMemo(\n    () => new OneInbox(publishableKey, { baseUrl }),\n    [publishableKey, baseUrl],\n  );\n  return <OneInboxContext.Provider value={client}>{children}</OneInboxContext.Provider>;\n}\n\n/** Access the raw `OneInbox` client from context. Throws outside a provider. */\nexport function useOneInboxClient(): OneInbox {\n  const client = useContext(OneInboxContext);\n  if (!client) {\n    throw new Error(\"useOneInbox must be used within an <OneInboxProvider>.\");\n  }\n  return client;\n}\n\nexport interface UseOneInbox {\n  /** Start a call by agent id (publishable-key path). */\n  start: (agentId: string, opts?: StartOptions) => Promise<void>;\n  /** End the active call. */\n  stop: () => Promise<void>;\n  /** Mute/unmute the local microphone. */\n  setMuted: (muted: boolean) => void;\n  status: CallStatus;\n  isMuted: boolean;\n  /** Whether the agent is currently speaking (best-effort). */\n  isAgentSpeaking: boolean;\n  /** Local mic level 0..1 (sampled while active). */\n  volume: number;\n  /** Accumulated transcript chunks (interim + final), in arrival order. */\n  transcripts: TranscriptEvent[];\n  /** Last error, if any. */\n  error: OneInboxError | null;\n  /** Escape hatch to the underlying client. */\n  client: OneInbox;\n}\n\n/**\n * Subscribes to the client's events and exposes them as React state.\n *\n * ```tsx\n * const { start, stop, status, transcripts, isAgentSpeaking } = useOneInbox();\n * ```\n */\nexport function useOneInbox(): UseOneInbox {\n  const client = useOneInboxClient();\n\n  const [status, setStatus] = useState<CallStatus>(client.status);\n  const [isMuted, setIsMuted] = useState<boolean>(client.isMuted());\n  const [isAgentSpeaking, setIsAgentSpeaking] = useState(false);\n  const [volume, setVolume] = useState(0);\n  const [transcripts, setTranscripts] = useState<TranscriptEvent[]>([]);\n  const [error, setError] = useState<OneInboxError | null>(null);\n  // Keep a ref so the imperative callbacks below don't re-create per render.\n  const clientRef = useRef(client);\n  clientRef.current = client;\n\n  useEffect(() => {\n    const offs = [\n      client.on(\"status\", setStatus),\n      client.on(\"volume-level\", setVolume),\n      client.on(\"error\", setError),\n      client.on(\"transcript\", (t) => setTranscripts((prev) => [...prev, t])),\n      client.on(\"speech-start\", (who) => {\n        if (who === \"agent\") setIsAgentSpeaking(true);\n      }),\n      client.on(\"speech-end\", (who) => {\n        if (who === \"agent\") setIsAgentSpeaking(false);\n      }),\n      client.on(\"call-start\", () => {\n        setTranscripts([]);\n        setError(null);\n        setIsMuted(client.isMuted());\n      }),\n      client.on(\"call-end\", () => {\n        setIsAgentSpeaking(false);\n        setVolume(0);\n      }),\n    ];\n    return () => offs.forEach((off) => off());\n  }, [client]);\n\n  const start = useCallback(\n    (agentId: string, opts?: StartOptions) => clientRef.current.start(agentId, opts),\n    [],\n  );\n  const stop = useCallback(() => clientRef.current.stop(), []);\n  const setMuted = useCallback((muted: boolean) => {\n    clientRef.current.setMuted(muted);\n    setIsMuted(muted);\n  }, []);\n\n  return {\n    start,\n    stop,\n    setMuted,\n    status,\n    isMuted,\n    isAgentSpeaking,\n    volume,\n    transcripts,\n    error,\n    client,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { OneInboxConfig, StartOptions, CallStatus, TranscriptEvent, OneInboxError, OneInbox } from '@oneinbox/web-sdk';
+export { CallStatus, OneInboxError, StartOptions, TranscriptEvent } from '@oneinbox/web-sdk';
+
+interface OneInboxProviderProps extends OneInboxConfig {
+    /** Publishable key (`oi_pk_…`). */
+    publishableKey: string;
+    children: ReactNode;
+}
+/**
+ * Provides a single `OneInbox` instance to the tree. Place near the root.
+ *
+ * ```tsx
+ * <OneInboxProvider publishableKey="oi_pk_…">
+ *   <App />
+ * </OneInboxProvider>
+ * ```
+ */
+declare function OneInboxProvider({ publishableKey, children, ...config }: OneInboxProviderProps): react.JSX.Element;
+/** Access the raw `OneInbox` client from context. Throws outside a provider. */
+declare function useOneInboxClient(): OneInbox;
+interface UseOneInbox {
+    /** Start a call by agent id (publishable-key path). */
+    start: (agentId: string, opts?: StartOptions) => Promise<void>;
+    /** End the active call. */
+    stop: () => Promise<void>;
+    /** Mute/unmute the local microphone. */
+    setMuted: (muted: boolean) => void;
+    status: CallStatus;
+    isMuted: boolean;
+    /** Whether the agent is currently speaking (best-effort). */
+    isAgentSpeaking: boolean;
+    /** Local mic level 0..1 (sampled while active). */
+    volume: number;
+    /** Accumulated transcript chunks (interim + final), in arrival order. */
+    transcripts: TranscriptEvent[];
+    /** Last error, if any. */
+    error: OneInboxError | null;
+    /** Escape hatch to the underlying client. */
+    client: OneInbox;
+}
+/**
+ * Subscribes to the client's events and exposes them as React state.
+ *
+ * ```tsx
+ * const { start, stop, status, transcripts, isAgentSpeaking } = useOneInbox();
+ * ```
+ */
+declare function useOneInbox(): UseOneInbox;
+
+export { OneInboxProvider, type OneInboxProviderProps, type UseOneInbox, useOneInbox, useOneInboxClient };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { OneInboxConfig, StartOptions, CallStatus, TranscriptEvent, OneInboxError, OneInbox } from '@oneinbox/web-sdk';
+export { CallStatus, OneInboxError, StartOptions, TranscriptEvent } from '@oneinbox/web-sdk';
+
+interface OneInboxProviderProps extends OneInboxConfig {
+    /** Publishable key (`oi_pk_…`). */
+    publishableKey: string;
+    children: ReactNode;
+}
+/**
+ * Provides a single `OneInbox` instance to the tree. Place near the root.
+ *
+ * ```tsx
+ * <OneInboxProvider publishableKey="oi_pk_…">
+ *   <App />
+ * </OneInboxProvider>
+ * ```
+ */
+declare function OneInboxProvider({ publishableKey, children, ...config }: OneInboxProviderProps): react.JSX.Element;
+/** Access the raw `OneInbox` client from context. Throws outside a provider. */
+declare function useOneInboxClient(): OneInbox;
+interface UseOneInbox {
+    /** Start a call by agent id (publishable-key path). */
+    start: (agentId: string, opts?: StartOptions) => Promise<void>;
+    /** End the active call. */
+    stop: () => Promise<void>;
+    /** Mute/unmute the local microphone. */
+    setMuted: (muted: boolean) => void;
+    status: CallStatus;
+    isMuted: boolean;
+    /** Whether the agent is currently speaking (best-effort). */
+    isAgentSpeaking: boolean;
+    /** Local mic level 0..1 (sampled while active). */
+    volume: number;
+    /** Accumulated transcript chunks (interim + final), in arrival order. */
+    transcripts: TranscriptEvent[];
+    /** Last error, if any. */
+    error: OneInboxError | null;
+    /** Escape hatch to the underlying client. */
+    client: OneInbox;
+}
+/**
+ * Subscribes to the client's events and exposes them as React state.
+ *
+ * ```tsx
+ * const { start, stop, status, transcripts, isAgentSpeaking } = useOneInbox();
+ * ```
+ */
+declare function useOneInbox(): UseOneInbox;
+
+export { OneInboxProvider, type OneInboxProviderProps, type UseOneInbox, useOneInbox, useOneInboxClient };

package/dist/index.js

@@ -0,0 +1,85 @@
+import { OneInbox } from '@oneinbox/web-sdk';
+import { createContext, useMemo, useContext, useState, useRef, useEffect, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var OneInboxContext = createContext(null);
+function OneInboxProvider({
+  publishableKey,
+  children,
+  ...config
+}) {
+  const baseUrl = config.baseUrl;
+  const client = useMemo(
+    () => new OneInbox(publishableKey, { baseUrl }),
+    [publishableKey, baseUrl]
+  );
+  return /* @__PURE__ */ jsx(OneInboxContext.Provider, { value: client, children });
+}
+function useOneInboxClient() {
+  const client = useContext(OneInboxContext);
+  if (!client) {
+    throw new Error("useOneInbox must be used within an <OneInboxProvider>.");
+  }
+  return client;
+}
+function useOneInbox() {
+  const client = useOneInboxClient();
+  const [status, setStatus] = useState(client.status);
+  const [isMuted, setIsMuted] = useState(client.isMuted());
+  const [isAgentSpeaking, setIsAgentSpeaking] = useState(false);
+  const [volume, setVolume] = useState(0);
+  const [transcripts, setTranscripts] = useState([]);
+  const [error, setError] = useState(null);
+  const clientRef = useRef(client);
+  clientRef.current = client;
+  useEffect(() => {
+    const offs = [
+      client.on("status", setStatus),
+      client.on("volume-level", setVolume),
+      client.on("error", setError),
+      client.on("transcript", (t) => setTranscripts((prev) => [...prev, t])),
+      client.on("speech-start", (who) => {
+        if (who === "agent") setIsAgentSpeaking(true);
+      }),
+      client.on("speech-end", (who) => {
+        if (who === "agent") setIsAgentSpeaking(false);
+      }),
+      client.on("call-start", () => {
+        setTranscripts([]);
+        setError(null);
+        setIsMuted(client.isMuted());
+      }),
+      client.on("call-end", () => {
+        setIsAgentSpeaking(false);
+        setVolume(0);
+      })
+    ];
+    return () => offs.forEach((off) => off());
+  }, [client]);
+  const start = useCallback(
+    (agentId, opts) => clientRef.current.start(agentId, opts),
+    []
+  );
+  const stop = useCallback(() => clientRef.current.stop(), []);
+  const setMuted = useCallback((muted) => {
+    clientRef.current.setMuted(muted);
+    setIsMuted(muted);
+  }, []);
+  return {
+    start,
+    stop,
+    setMuted,
+    status,
+    isMuted,
+    isAgentSpeaking,
+    volume,
+    transcripts,
+    error,
+    client
+  };
+}
+
+export { OneInboxProvider, useOneInbox, useOneInboxClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  type CallStatus,\n  OneInbox,\n  type OneInboxConfig,\n  type OneInboxError,\n  type StartOptions,\n  type TranscriptEvent,\n} from \"@oneinbox/web-sdk\";\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\n\nexport type { CallStatus, OneInboxError, StartOptions, TranscriptEvent };\n\nconst OneInboxContext = createContext<OneInbox | null>(null);\n\nexport interface OneInboxProviderProps extends OneInboxConfig {\n  /** Publishable key (`oi_pk_…`). */\n  publishableKey: string;\n  children: ReactNode;\n}\n\n/**\n * Provides a single `OneInbox` instance to the tree. Place near the root.\n *\n * ```tsx\n * <OneInboxProvider publishableKey=\"oi_pk_…\">\n *   <App />\n * </OneInboxProvider>\n * ```\n */\nexport function OneInboxProvider({\n  publishableKey,\n  children,\n  ...config\n}: OneInboxProviderProps) {\n  // baseUrl is the only config field today; spread keeps it forward-compatible.\n  const baseUrl = config.baseUrl;\n  const client = useMemo(\n    () => new OneInbox(publishableKey, { baseUrl }),\n    [publishableKey, baseUrl],\n  );\n  return <OneInboxContext.Provider value={client}>{children}</OneInboxContext.Provider>;\n}\n\n/** Access the raw `OneInbox` client from context. Throws outside a provider. */\nexport function useOneInboxClient(): OneInbox {\n  const client = useContext(OneInboxContext);\n  if (!client) {\n    throw new Error(\"useOneInbox must be used within an <OneInboxProvider>.\");\n  }\n  return client;\n}\n\nexport interface UseOneInbox {\n  /** Start a call by agent id (publishable-key path). */\n  start: (agentId: string, opts?: StartOptions) => Promise<void>;\n  /** End the active call. */\n  stop: () => Promise<void>;\n  /** Mute/unmute the local microphone. */\n  setMuted: (muted: boolean) => void;\n  status: CallStatus;\n  isMuted: boolean;\n  /** Whether the agent is currently speaking (best-effort). */\n  isAgentSpeaking: boolean;\n  /** Local mic level 0..1 (sampled while active). */\n  volume: number;\n  /** Accumulated transcript chunks (interim + final), in arrival order. */\n  transcripts: TranscriptEvent[];\n  /** Last error, if any. */\n  error: OneInboxError | null;\n  /** Escape hatch to the underlying client. */\n  client: OneInbox;\n}\n\n/**\n * Subscribes to the client's events and exposes them as React state.\n *\n * ```tsx\n * const { start, stop, status, transcripts, isAgentSpeaking } = useOneInbox();\n * ```\n */\nexport function useOneInbox(): UseOneInbox {\n  const client = useOneInboxClient();\n\n  const [status, setStatus] = useState<CallStatus>(client.status);\n  const [isMuted, setIsMuted] = useState<boolean>(client.isMuted());\n  const [isAgentSpeaking, setIsAgentSpeaking] = useState(false);\n  const [volume, setVolume] = useState(0);\n  const [transcripts, setTranscripts] = useState<TranscriptEvent[]>([]);\n  const [error, setError] = useState<OneInboxError | null>(null);\n  // Keep a ref so the imperative callbacks below don't re-create per render.\n  const clientRef = useRef(client);\n  clientRef.current = client;\n\n  useEffect(() => {\n    const offs = [\n      client.on(\"status\", setStatus),\n      client.on(\"volume-level\", setVolume),\n      client.on(\"error\", setError),\n      client.on(\"transcript\", (t) => setTranscripts((prev) => [...prev, t])),\n      client.on(\"speech-start\", (who) => {\n        if (who === \"agent\") setIsAgentSpeaking(true);\n      }),\n      client.on(\"speech-end\", (who) => {\n        if (who === \"agent\") setIsAgentSpeaking(false);\n      }),\n      client.on(\"call-start\", () => {\n        setTranscripts([]);\n        setError(null);\n        setIsMuted(client.isMuted());\n      }),\n      client.on(\"call-end\", () => {\n        setIsAgentSpeaking(false);\n        setVolume(0);\n      }),\n    ];\n    return () => offs.forEach((off) => off());\n  }, [client]);\n\n  const start = useCallback(\n    (agentId: string, opts?: StartOptions) => clientRef.current.start(agentId, opts),\n    [],\n  );\n  const stop = useCallback(() => clientRef.current.stop(), []);\n  const setMuted = useCallback((muted: boolean) => {\n    clientRef.current.setMuted(muted);\n    setIsMuted(muted);\n  }, []);\n\n  return {\n    start,\n    stop,\n    setMuted,\n    status,\n    isMuted,\n    isAgentSpeaking,\n    volume,\n    transcripts,\n    error,\n    client,\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@oneinbox/web-sdk-react",
+  "version": "0.1.0-beta.1",
+  "description": "React bindings for @oneinbox/web-sdk — <OneInboxProvider> + useOneInbox().",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsup"
+  },
+  "peerDependencies": {
+    "@oneinbox/web-sdk": "^0.1.0-beta.1",
+    "livekit-client": "^2.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@oneinbox/web-sdk": "^0.1.0-beta.1",
+    "@types/react": "^19.0.0",
+    "livekit-client": "^2.5.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "keywords": ["voice", "ai", "agents", "webrtc", "livekit", "react", "hooks"],
+  "author": "OneInbox",
+  "homepage": "https://www.npmjs.com/package/@oneinbox/web-sdk-react",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}