@talkif/webrtc-react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Talkif
+
+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/dist/index.cjs

@@ -0,0 +1,132 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  useTalkifCall: () => useTalkifCall
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/use-talkif-call.ts
+var import_react = require("react");
+var import_webrtc = require("@talkif/webrtc");
+function useTalkifCall(options) {
+  const { config, onAppMessage, onCallEvent, onTranscript, onTtsWord, onTtsChunk, onEnded, onError } = options;
+  const callRef = (0, import_react.useRef)(null);
+  const [state, setState] = (0, import_react.useState)("idle");
+  const [callId, setCallId] = (0, import_react.useState)(null);
+  const [botId, setBotId] = (0, import_react.useState)(null);
+  const [error, setError] = (0, import_react.useState)(null);
+  const [durationSecs, setDurationSecs] = (0, import_react.useState)(0);
+  const [muted, setMuted] = (0, import_react.useState)(false);
+  const callbacksRef = (0, import_react.useRef)({
+    onAppMessage,
+    onCallEvent,
+    onTranscript,
+    onTtsWord,
+    onTtsChunk,
+    onEnded,
+    onError
+  });
+  callbacksRef.current = {
+    onAppMessage,
+    onCallEvent,
+    onTranscript,
+    onTtsWord,
+    onTtsChunk,
+    onEnded,
+    onError
+  };
+  const identity = (0, import_webrtc.isPublicConfig)(config) ? [config.baseUrl, config.publishableKey, config.turnstileToken, config.fetch] : [config.baseUrl, config.accountId, config.auth, config.fetch];
+  const stableConfig = (0, import_react.useMemo)(
+    () => config,
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    identity
+  );
+  (0, import_react.useEffect)(() => {
+    return () => {
+      callRef.current?.dispose();
+      callRef.current = null;
+    };
+  }, []);
+  const start = (0, import_react.useCallback)(
+    async (startOptions) => {
+      callRef.current?.dispose();
+      const call = new import_webrtc.TalkifCall(stableConfig);
+      callRef.current = call;
+      setError(null);
+      setCallId(null);
+      setBotId(null);
+      setDurationSecs(0);
+      setMuted(false);
+      call.on("statechange", ({ state: next }) => setState(next));
+      call.on("connected", ({ callId: id, botId: bot }) => {
+        setCallId(id);
+        setBotId(bot);
+      });
+      call.on("tick", ({ durationSecs: secs }) => setDurationSecs(secs));
+      call.on("mutechange", ({ muted: m }) => setMuted(m));
+      call.on("appmessage", ({ message }) => callbacksRef.current.onAppMessage?.(message));
+      call.on("callevent", ({ event }) => callbacksRef.current.onCallEvent?.(event));
+      call.on(
+        "transcript",
+        ({ role, content }) => callbacksRef.current.onTranscript?.({ role, content })
+      );
+      call.on("ttsword", (payload) => callbacksRef.current.onTtsWord?.(payload));
+      call.on("ttschunk", (payload) => callbacksRef.current.onTtsChunk?.(payload));
+      call.on("ended", ({ reason }) => callbacksRef.current.onEnded?.(reason));
+      call.on("error", ({ error: err }) => {
+        setError(err);
+        callbacksRef.current.onError?.(err);
+      });
+      await call.start(startOptions);
+    },
+    [stableConfig]
+  );
+  const hangup = (0, import_react.useCallback)(() => {
+    callRef.current?.hangup();
+  }, []);
+  const toggleMute = (0, import_react.useCallback)(() => {
+    const call = callRef.current;
+    if (!call) return;
+    call.setMuted(!call.muted);
+  }, []);
+  const sendAppMessage = (0, import_react.useCallback)((message) => {
+    return callRef.current?.sendAppMessage(message) ?? false;
+  }, []);
+  return {
+    state,
+    callId,
+    botId,
+    error,
+    durationSecs,
+    muted,
+    call: callRef.current,
+    start,
+    hangup,
+    toggleMute,
+    sendAppMessage
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTalkifCall
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/use-talkif-call.ts"],"sourcesContent":["export { useTalkifCall } from './use-talkif-call.js';\nexport type { UseTalkifCallOptions, UseTalkifCallResult } from './use-talkif-call.js';\n","import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { isPublicConfig, TalkifCall } from '@talkif/webrtc';\nimport type {\n\tAppMessage,\n\tCallEndReason,\n\tCallEventEnvelope,\n\tCallState,\n\tStartCallOptions,\n\tTalkifCallError,\n\tTalkifConfig,\n\tTtsChunkEvent,\n\tTtsWordEvent,\n} from '@talkif/webrtc';\n\nexport interface UseTalkifCallOptions {\n\t/**\n\t * Authenticated (`accountId` + `auth`) or public (`publishableKey`)\n\t * configuration — public mode also streams realtime call events.\n\t */\n\tconfig: TalkifConfig;\n\t/** Fired for every JSON app message from the bot (e.g. transcripts). */\n\tonAppMessage?: (message: AppMessage) => void;\n\t/** Public mode: every realtime event for this call (transcript, status…). */\n\tonCallEvent?: (event: CallEventEnvelope) => void;\n\t/** Public mode: final transcript lines. */\n\tonTranscript?: (payload: { role: string; content: string }) => void;\n\t/** Public mode: word-level TTS timing (karaoke). May be dropped under backpressure. */\n\tonTtsWord?: (payload: TtsWordEvent) => void;\n\t/**\n\t * Public mode: sentence-level chunk of the agent's reply, ahead of audio\n\t * playback (chat-style streaming). Reconcile with the final transcript.\n\t */\n\tonTtsChunk?: (payload: TtsChunkEvent) => void;\n\tonEnded?: (reason: CallEndReason) => void;\n\tonError?: (error: TalkifCallError) => void;\n}\n\nexport interface UseTalkifCallResult {\n\tstate: CallState;\n\tcallId: string | null;\n\tbotId: string | null;\n\terror: TalkifCallError | null;\n\tdurationSecs: number;\n\tmuted: boolean;\n\t/** Live call handle for advanced use (sendAppMessage, confirmPipelineHealthy…). */\n\tcall: TalkifCall | null;\n\tstart: (options: StartCallOptions) => Promise<void>;\n\thangup: () => void;\n\ttoggleMute: () => void;\n\tsendAppMessage: (message: AppMessage) => boolean;\n}\n\n/**\n * Headless React binding for TalkifCall. One active call at a time; starting\n * a new call disposes the previous instance. All teardown (mic, peer\n * connection, timers) happens automatically on unmount.\n */\nexport function useTalkifCall(options: UseTalkifCallOptions): UseTalkifCallResult {\n\tconst { config, onAppMessage, onCallEvent, onTranscript, onTtsWord, onTtsChunk, onEnded, onError } =\n\t\toptions;\n\n\tconst callRef = useRef<TalkifCall | null>(null);\n\tconst [state, setState] = useState<CallState>('idle');\n\tconst [callId, setCallId] = useState<string | null>(null);\n\tconst [botId, setBotId] = useState<string | null>(null);\n\tconst [error, setError] = useState<TalkifCallError | null>(null);\n\tconst [durationSecs, setDurationSecs] = useState(0);\n\tconst [muted, setMuted] = useState(false);\n\n\t// Keep callbacks in refs so subscriptions survive re-renders without\n\t// re-wiring the emitter.\n\tconst callbacksRef = useRef({\n\t\tonAppMessage,\n\t\tonCallEvent,\n\t\tonTranscript,\n\t\tonTtsWord,\n\t\tonTtsChunk,\n\t\tonEnded,\n\t\tonError,\n\t});\n\tcallbacksRef.current = {\n\t\tonAppMessage,\n\t\tonCallEvent,\n\t\tonTranscript,\n\t\tonTtsWord,\n\t\tonTtsChunk,\n\t\tonEnded,\n\t\tonError,\n\t};\n\n\t// The config object identity is the session identity — memoize on fields.\n\tconst identity = isPublicConfig(config)\n\t\t? [config.baseUrl, config.publishableKey, config.turnstileToken, config.fetch]\n\t\t: [config.baseUrl, config.accountId, config.auth, config.fetch];\n\tconst stableConfig = useMemo(\n\t\t() => config,\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps\n\t\tidentity\n\t);\n\n\tuseEffect(() => {\n\t\treturn () => {\n\t\t\tcallRef.current?.dispose();\n\t\t\tcallRef.current = null;\n\t\t};\n\t}, []);\n\n\tconst start = useCallback(\n\t\tasync (startOptions: StartCallOptions) => {\n\t\t\t// Single-use instances: replace any prior call.\n\t\t\tcallRef.current?.dispose();\n\n\t\t\tconst call = new TalkifCall(stableConfig);\n\t\t\tcallRef.current = call;\n\t\t\tsetError(null);\n\t\t\tsetCallId(null);\n\t\t\tsetBotId(null);\n\t\t\tsetDurationSecs(0);\n\t\t\tsetMuted(false);\n\n\t\t\tcall.on('statechange', ({ state: next }) => setState(next));\n\t\t\tcall.on('connected', ({ callId: id, botId: bot }) => {\n\t\t\t\tsetCallId(id);\n\t\t\t\tsetBotId(bot);\n\t\t\t});\n\t\t\tcall.on('tick', ({ durationSecs: secs }) => setDurationSecs(secs));\n\t\t\tcall.on('mutechange', ({ muted: m }) => setMuted(m));\n\t\t\tcall.on('appmessage', ({ message }) => callbacksRef.current.onAppMessage?.(message));\n\t\t\tcall.on('callevent', ({ event }) => callbacksRef.current.onCallEvent?.(event));\n\t\t\tcall.on('transcript', ({ role, content }) =>\n\t\t\t\tcallbacksRef.current.onTranscript?.({ role, content })\n\t\t\t);\n\t\t\tcall.on('ttsword', (payload) => callbacksRef.current.onTtsWord?.(payload));\n\t\t\tcall.on('ttschunk', (payload) => callbacksRef.current.onTtsChunk?.(payload));\n\t\t\tcall.on('ended', ({ reason }) => callbacksRef.current.onEnded?.(reason));\n\t\t\tcall.on('error', ({ error: err }) => {\n\t\t\t\tsetError(err);\n\t\t\t\tcallbacksRef.current.onError?.(err);\n\t\t\t});\n\n\t\t\tawait call.start(startOptions);\n\t\t},\n\t\t[stableConfig]\n\t);\n\n\tconst hangup = useCallback(() => {\n\t\tcallRef.current?.hangup();\n\t}, []);\n\n\tconst toggleMute = useCallback(() => {\n\t\tconst call = callRef.current;\n\t\tif (!call) return;\n\t\tcall.setMuted(!call.muted);\n\t}, []);\n\n\tconst sendAppMessage = useCallback((message: AppMessage): boolean => {\n\t\treturn callRef.current?.sendAppMessage(message) ?? false;\n\t}, []);\n\n\treturn {\n\t\tstate,\n\t\tcallId,\n\t\tbotId,\n\t\terror,\n\t\tdurationSecs,\n\t\tmuted,\n\t\tcall: callRef.current,\n\t\tstart,\n\t\thangup,\n\t\ttoggleMute,\n\t\tsendAppMessage,\n\t};\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+import { TalkifConfig, AppMessage, CallEventEnvelope, TtsWordEvent, TtsChunkEvent, CallEndReason, TalkifCallError, CallState, TalkifCall, StartCallOptions } from '@talkif/webrtc';
+
+interface UseTalkifCallOptions {
+    /**
+     * Authenticated (`accountId` + `auth`) or public (`publishableKey`)
+     * configuration — public mode also streams realtime call events.
+     */
+    config: TalkifConfig;
+    /** Fired for every JSON app message from the bot (e.g. transcripts). */
+    onAppMessage?: (message: AppMessage) => void;
+    /** Public mode: every realtime event for this call (transcript, status…). */
+    onCallEvent?: (event: CallEventEnvelope) => void;
+    /** Public mode: final transcript lines. */
+    onTranscript?: (payload: {
+        role: string;
+        content: string;
+    }) => void;
+    /** Public mode: word-level TTS timing (karaoke). May be dropped under backpressure. */
+    onTtsWord?: (payload: TtsWordEvent) => void;
+    /**
+     * Public mode: sentence-level chunk of the agent's reply, ahead of audio
+     * playback (chat-style streaming). Reconcile with the final transcript.
+     */
+    onTtsChunk?: (payload: TtsChunkEvent) => void;
+    onEnded?: (reason: CallEndReason) => void;
+    onError?: (error: TalkifCallError) => void;
+}
+interface UseTalkifCallResult {
+    state: CallState;
+    callId: string | null;
+    botId: string | null;
+    error: TalkifCallError | null;
+    durationSecs: number;
+    muted: boolean;
+    /** Live call handle for advanced use (sendAppMessage, confirmPipelineHealthy…). */
+    call: TalkifCall | null;
+    start: (options: StartCallOptions) => Promise<void>;
+    hangup: () => void;
+    toggleMute: () => void;
+    sendAppMessage: (message: AppMessage) => boolean;
+}
+/**
+ * Headless React binding for TalkifCall. One active call at a time; starting
+ * a new call disposes the previous instance. All teardown (mic, peer
+ * connection, timers) happens automatically on unmount.
+ */
+declare function useTalkifCall(options: UseTalkifCallOptions): UseTalkifCallResult;
+
+export { type UseTalkifCallOptions, type UseTalkifCallResult, useTalkifCall };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { TalkifConfig, AppMessage, CallEventEnvelope, TtsWordEvent, TtsChunkEvent, CallEndReason, TalkifCallError, CallState, TalkifCall, StartCallOptions } from '@talkif/webrtc';
+
+interface UseTalkifCallOptions {
+    /**
+     * Authenticated (`accountId` + `auth`) or public (`publishableKey`)
+     * configuration — public mode also streams realtime call events.
+     */
+    config: TalkifConfig;
+    /** Fired for every JSON app message from the bot (e.g. transcripts). */
+    onAppMessage?: (message: AppMessage) => void;
+    /** Public mode: every realtime event for this call (transcript, status…). */
+    onCallEvent?: (event: CallEventEnvelope) => void;
+    /** Public mode: final transcript lines. */
+    onTranscript?: (payload: {
+        role: string;
+        content: string;
+    }) => void;
+    /** Public mode: word-level TTS timing (karaoke). May be dropped under backpressure. */
+    onTtsWord?: (payload: TtsWordEvent) => void;
+    /**
+     * Public mode: sentence-level chunk of the agent's reply, ahead of audio
+     * playback (chat-style streaming). Reconcile with the final transcript.
+     */
+    onTtsChunk?: (payload: TtsChunkEvent) => void;
+    onEnded?: (reason: CallEndReason) => void;
+    onError?: (error: TalkifCallError) => void;
+}
+interface UseTalkifCallResult {
+    state: CallState;
+    callId: string | null;
+    botId: string | null;
+    error: TalkifCallError | null;
+    durationSecs: number;
+    muted: boolean;
+    /** Live call handle for advanced use (sendAppMessage, confirmPipelineHealthy…). */
+    call: TalkifCall | null;
+    start: (options: StartCallOptions) => Promise<void>;
+    hangup: () => void;
+    toggleMute: () => void;
+    sendAppMessage: (message: AppMessage) => boolean;
+}
+/**
+ * Headless React binding for TalkifCall. One active call at a time; starting
+ * a new call disposes the previous instance. All teardown (mic, peer
+ * connection, timers) happens automatically on unmount.
+ */
+declare function useTalkifCall(options: UseTalkifCallOptions): UseTalkifCallResult;
+
+export { type UseTalkifCallOptions, type UseTalkifCallResult, useTalkifCall };

package/dist/index.js

@@ -0,0 +1,105 @@
+// src/use-talkif-call.ts
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { isPublicConfig, TalkifCall } from "@talkif/webrtc";
+function useTalkifCall(options) {
+  const { config, onAppMessage, onCallEvent, onTranscript, onTtsWord, onTtsChunk, onEnded, onError } = options;
+  const callRef = useRef(null);
+  const [state, setState] = useState("idle");
+  const [callId, setCallId] = useState(null);
+  const [botId, setBotId] = useState(null);
+  const [error, setError] = useState(null);
+  const [durationSecs, setDurationSecs] = useState(0);
+  const [muted, setMuted] = useState(false);
+  const callbacksRef = useRef({
+    onAppMessage,
+    onCallEvent,
+    onTranscript,
+    onTtsWord,
+    onTtsChunk,
+    onEnded,
+    onError
+  });
+  callbacksRef.current = {
+    onAppMessage,
+    onCallEvent,
+    onTranscript,
+    onTtsWord,
+    onTtsChunk,
+    onEnded,
+    onError
+  };
+  const identity = isPublicConfig(config) ? [config.baseUrl, config.publishableKey, config.turnstileToken, config.fetch] : [config.baseUrl, config.accountId, config.auth, config.fetch];
+  const stableConfig = useMemo(
+    () => config,
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    identity
+  );
+  useEffect(() => {
+    return () => {
+      callRef.current?.dispose();
+      callRef.current = null;
+    };
+  }, []);
+  const start = useCallback(
+    async (startOptions) => {
+      callRef.current?.dispose();
+      const call = new TalkifCall(stableConfig);
+      callRef.current = call;
+      setError(null);
+      setCallId(null);
+      setBotId(null);
+      setDurationSecs(0);
+      setMuted(false);
+      call.on("statechange", ({ state: next }) => setState(next));
+      call.on("connected", ({ callId: id, botId: bot }) => {
+        setCallId(id);
+        setBotId(bot);
+      });
+      call.on("tick", ({ durationSecs: secs }) => setDurationSecs(secs));
+      call.on("mutechange", ({ muted: m }) => setMuted(m));
+      call.on("appmessage", ({ message }) => callbacksRef.current.onAppMessage?.(message));
+      call.on("callevent", ({ event }) => callbacksRef.current.onCallEvent?.(event));
+      call.on(
+        "transcript",
+        ({ role, content }) => callbacksRef.current.onTranscript?.({ role, content })
+      );
+      call.on("ttsword", (payload) => callbacksRef.current.onTtsWord?.(payload));
+      call.on("ttschunk", (payload) => callbacksRef.current.onTtsChunk?.(payload));
+      call.on("ended", ({ reason }) => callbacksRef.current.onEnded?.(reason));
+      call.on("error", ({ error: err }) => {
+        setError(err);
+        callbacksRef.current.onError?.(err);
+      });
+      await call.start(startOptions);
+    },
+    [stableConfig]
+  );
+  const hangup = useCallback(() => {
+    callRef.current?.hangup();
+  }, []);
+  const toggleMute = useCallback(() => {
+    const call = callRef.current;
+    if (!call) return;
+    call.setMuted(!call.muted);
+  }, []);
+  const sendAppMessage = useCallback((message) => {
+    return callRef.current?.sendAppMessage(message) ?? false;
+  }, []);
+  return {
+    state,
+    callId,
+    botId,
+    error,
+    durationSecs,
+    muted,
+    call: callRef.current,
+    start,
+    hangup,
+    toggleMute,
+    sendAppMessage
+  };
+}
+export {
+  useTalkifCall
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-talkif-call.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { isPublicConfig, TalkifCall } from '@talkif/webrtc';\nimport type {\n\tAppMessage,\n\tCallEndReason,\n\tCallEventEnvelope,\n\tCallState,\n\tStartCallOptions,\n\tTalkifCallError,\n\tTalkifConfig,\n\tTtsChunkEvent,\n\tTtsWordEvent,\n} from '@talkif/webrtc';\n\nexport interface UseTalkifCallOptions {\n\t/**\n\t * Authenticated (`accountId` + `auth`) or public (`publishableKey`)\n\t * configuration — public mode also streams realtime call events.\n\t */\n\tconfig: TalkifConfig;\n\t/** Fired for every JSON app message from the bot (e.g. transcripts). */\n\tonAppMessage?: (message: AppMessage) => void;\n\t/** Public mode: every realtime event for this call (transcript, status…). */\n\tonCallEvent?: (event: CallEventEnvelope) => void;\n\t/** Public mode: final transcript lines. */\n\tonTranscript?: (payload: { role: string; content: string }) => void;\n\t/** Public mode: word-level TTS timing (karaoke). May be dropped under backpressure. */\n\tonTtsWord?: (payload: TtsWordEvent) => void;\n\t/**\n\t * Public mode: sentence-level chunk of the agent's reply, ahead of audio\n\t * playback (chat-style streaming). Reconcile with the final transcript.\n\t */\n\tonTtsChunk?: (payload: TtsChunkEvent) => void;\n\tonEnded?: (reason: CallEndReason) => void;\n\tonError?: (error: TalkifCallError) => void;\n}\n\nexport interface UseTalkifCallResult {\n\tstate: CallState;\n\tcallId: string | null;\n\tbotId: string | null;\n\terror: TalkifCallError | null;\n\tdurationSecs: number;\n\tmuted: boolean;\n\t/** Live call handle for advanced use (sendAppMessage, confirmPipelineHealthy…). */\n\tcall: TalkifCall | null;\n\tstart: (options: StartCallOptions) => Promise<void>;\n\thangup: () => void;\n\ttoggleMute: () => void;\n\tsendAppMessage: (message: AppMessage) => boolean;\n}\n\n/**\n * Headless React binding for TalkifCall. One active call at a time; starting\n * a new call disposes the previous instance. All teardown (mic, peer\n * connection, timers) happens automatically on unmount.\n */\nexport function useTalkifCall(options: UseTalkifCallOptions): UseTalkifCallResult {\n\tconst { config, onAppMessage, onCallEvent, onTranscript, onTtsWord, onTtsChunk, onEnded, onError } =\n\t\toptions;\n\n\tconst callRef = useRef<TalkifCall | null>(null);\n\tconst [state, setState] = useState<CallState>('idle');\n\tconst [callId, setCallId] = useState<string | null>(null);\n\tconst [botId, setBotId] = useState<string | null>(null);\n\tconst [error, setError] = useState<TalkifCallError | null>(null);\n\tconst [durationSecs, setDurationSecs] = useState(0);\n\tconst [muted, setMuted] = useState(false);\n\n\t// Keep callbacks in refs so subscriptions survive re-renders without\n\t// re-wiring the emitter.\n\tconst callbacksRef = useRef({\n\t\tonAppMessage,\n\t\tonCallEvent,\n\t\tonTranscript,\n\t\tonTtsWord,\n\t\tonTtsChunk,\n\t\tonEnded,\n\t\tonError,\n\t});\n\tcallbacksRef.current = {\n\t\tonAppMessage,\n\t\tonCallEvent,\n\t\tonTranscript,\n\t\tonTtsWord,\n\t\tonTtsChunk,\n\t\tonEnded,\n\t\tonError,\n\t};\n\n\t// The config object identity is the session identity — memoize on fields.\n\tconst identity = isPublicConfig(config)\n\t\t? [config.baseUrl, config.publishableKey, config.turnstileToken, config.fetch]\n\t\t: [config.baseUrl, config.accountId, config.auth, config.fetch];\n\tconst stableConfig = useMemo(\n\t\t() => config,\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps\n\t\tidentity\n\t);\n\n\tuseEffect(() => {\n\t\treturn () => {\n\t\t\tcallRef.current?.dispose();\n\t\t\tcallRef.current = null;\n\t\t};\n\t}, []);\n\n\tconst start = useCallback(\n\t\tasync (startOptions: StartCallOptions) => {\n\t\t\t// Single-use instances: replace any prior call.\n\t\t\tcallRef.current?.dispose();\n\n\t\t\tconst call = new TalkifCall(stableConfig);\n\t\t\tcallRef.current = call;\n\t\t\tsetError(null);\n\t\t\tsetCallId(null);\n\t\t\tsetBotId(null);\n\t\t\tsetDurationSecs(0);\n\t\t\tsetMuted(false);\n\n\t\t\tcall.on('statechange', ({ state: next }) => setState(next));\n\t\t\tcall.on('connected', ({ callId: id, botId: bot }) => {\n\t\t\t\tsetCallId(id);\n\t\t\t\tsetBotId(bot);\n\t\t\t});\n\t\t\tcall.on('tick', ({ durationSecs: secs }) => setDurationSecs(secs));\n\t\t\tcall.on('mutechange', ({ muted: m }) => setMuted(m));\n\t\t\tcall.on('appmessage', ({ message }) => callbacksRef.current.onAppMessage?.(message));\n\t\t\tcall.on('callevent', ({ event }) => callbacksRef.current.onCallEvent?.(event));\n\t\t\tcall.on('transcript', ({ role, content }) =>\n\t\t\t\tcallbacksRef.current.onTranscript?.({ role, content })\n\t\t\t);\n\t\t\tcall.on('ttsword', (payload) => callbacksRef.current.onTtsWord?.(payload));\n\t\t\tcall.on('ttschunk', (payload) => callbacksRef.current.onTtsChunk?.(payload));\n\t\t\tcall.on('ended', ({ reason }) => callbacksRef.current.onEnded?.(reason));\n\t\t\tcall.on('error', ({ error: err }) => {\n\t\t\t\tsetError(err);\n\t\t\t\tcallbacksRef.current.onError?.(err);\n\t\t\t});\n\n\t\t\tawait call.start(startOptions);\n\t\t},\n\t\t[stableConfig]\n\t);\n\n\tconst hangup = useCallback(() => {\n\t\tcallRef.current?.hangup();\n\t}, []);\n\n\tconst toggleMute = useCallback(() => {\n\t\tconst call = callRef.current;\n\t\tif (!call) return;\n\t\tcall.setMuted(!call.muted);\n\t}, []);\n\n\tconst sendAppMessage = useCallback((message: AppMessage): boolean => {\n\t\treturn callRef.current?.sendAppMessage(message) ?? false;\n\t}, []);\n\n\treturn {\n\t\tstate,\n\t\tcallId,\n\t\tbotId,\n\t\terror,\n\t\tdurationSecs,\n\t\tmuted,\n\t\tcall: callRef.current,\n\t\tstart,\n\t\thangup,\n\t\ttoggleMute,\n\t\tsendAppMessage,\n\t};\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@talkif/webrtc-react",
+  "version": "0.1.0",
+  "description": "React bindings for @talkif/webrtc — headless hook for Talkif voice sessions",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Talkif-ai/webrtc-js.git",
+    "directory": "packages/react"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=18",
+    "@talkif/webrtc": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.0",
+    "react": "^19.1.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "@talkif/webrtc": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --sourcemap --clean --external react,@talkif/webrtc",
+    "dev": "tsup src/index.ts --format esm --dts --watch --external react,@talkif/webrtc",
+    "type-check": "tsc --noEmit"
+  }
+}