@talqing/react 0.4.0

package/dist/cjs/session.js

@@ -0,0 +1,55 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTalqingSession = useTalqingSession;
+exports.TalqingSessionProvider = TalqingSessionProvider;
+exports.useTalqingConnection = useTalqingConnection;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const livekit_client_1 = require("livekit-client");
+const components_react_1 = require("@livekit/components-react");
+const client_1 = require("@talqing/client");
+/** One session, one call — `start()` it when this mounts and `end()` it on the
+ *  way out, the lifecycle LiveKit's own session docs describe. A second call is
+ *  a second mount, so give the component holding this a `key` that changes per
+ *  call. Starting a finished session again would rejoin the room the last call
+ *  used, which the API refuses. */
+function useTalqingSession(options) {
+    const { token, fetchToken, client, agentId, callOptions, roomOptions } = options;
+    const [warnings, setWarnings] = (0, react_1.useState)([]);
+    // Reads every branch's fields so the dependency list is the same length on
+    // each; all but one are `undefined` on any given call.
+    const mint = (0, react_1.useCallback)(async () => {
+        if (token)
+            return token;
+        if (fetchToken)
+            return await fetchToken();
+        if (!client)
+            throw new Error("useTalqingSession needs one of token, fetchToken or client");
+        const minted = await client.calls.token({
+            tokenRequest: { ...callOptions, agent_id: agentId ?? null },
+        });
+        setWarnings(minted.warnings);
+        return { server_url: minted.server_url, participant_token: minted.participant_token };
+    }, [token, fetchToken, client, agentId, callOptions]);
+    const tokenSource = (0, react_1.useMemo)(() => (0, client_1.createTalqingTokenSource)(mint), [mint]);
+    const room = (0, react_1.useMemo)(() => new livekit_client_1.Room({ audioCaptureDefaults: client_1.TALQING_AUDIO_CAPTURE_DEFAULTS, ...roomOptions }), [roomOptions]);
+    const session = (0, components_react_1.useSession)(tokenSource, { room });
+    return (0, react_1.useMemo)(() => ({ ...session, warnings }), [session, warnings]);
+}
+function TalqingSessionProvider({ session, children, audio = true, }) {
+    return ((0, jsx_runtime_1.jsxs)(components_react_1.SessionProvider, { session: session, children: [children, audio ? (0, jsx_runtime_1.jsx)(components_react_1.RoomAudioRenderer, {}) : null] }));
+}
+/** The call itself, read from context — and `room`, which is the supported way
+ *  down to raw `livekit-client` for anything this layer does not cover. */
+function useTalqingConnection() {
+    const ctx = (0, components_react_1.useSessionContext)();
+    return {
+        isConnected: ctx.isConnected,
+        connectionState: ctx.connectionState,
+        room: ctx.room,
+        start: ctx.start,
+        end: ctx.end,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/cjs/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AA4Fb,8CAyBC;AAED,wDAeC;AAID,oDASC;;AAjJD,iCAA8D;AAC9D,mDAAwD;AACxD,gEAMmC;AACnC,4CAIyB;AAwEzB;;;;mCAImC;AACnC,SAAgB,iBAAiB,CAAC,OAA8B;IAC9D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACjF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAW,EAAE,CAAC,CAAC;IAEvD,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,IAAI,GAAG,IAAA,mBAAW,EAAC,KAAK,IAAqC,EAAE;QACnE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,UAAU;YAAE,OAAO,MAAM,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YACtC,YAAY,EAAE,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI,EAAE;SAC5D,CAAC,CAAC;QACH,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACxF,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAEtD,MAAM,WAAW,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,IAAA,iCAAwB,EAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAA,eAAO,EAClB,GAAG,EAAE,CACH,IAAI,qBAAI,CAAC,EAAE,oBAAoB,EAAE,uCAA8B,EAAE,GAAG,WAAW,EAAE,CAAC,EACpF,CAAC,WAAW,CAAC,CACd,CAAC;IACF,MAAM,OAAO,GAAG,IAAA,6BAAU,EAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,SAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,IAAI,GAKb;IACC,OAAO,CACL,wBAAC,kCAAe,IAAC,OAAO,EAAE,OAAO,aAC9B,QAAQ,EACR,KAAK,CAAC,CAAC,CAAC,uBAAC,oCAAiB,KAAG,CAAC,CAAC,CAAC,IAAI,IACrB,CACnB,CAAC;AACJ,CAAC;AAED;2EAC2E;AAC3E,SAAgB,oBAAoB;IAClC,MAAM,GAAG,GAAG,IAAA,oCAAiB,GAAE,CAAC;IAChC,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,EAAE,GAAG,CAAC,GAAG;KACb,CAAC;AACJ,CAAC"}

package/dist/cjs/userdata.d.ts

@@ -0,0 +1,10 @@
+import { type JsonObject } from "@talqing/client";
+/** Read and write the live session's userdata from inside a provider. */
+export declare function useTalqingUserdata(): {
+    get: (keys?: string[], responseTimeout?: number) => Promise<JsonObject>;
+    set: (patch: JsonObject, responseTimeout?: number) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+};
+//# sourceMappingURL=userdata.d.ts.map

package/dist/cjs/userdata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.d.ts","sourceRoot":"","sources":["../../src/userdata.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAGzB,yEAAyE;AACzE,wBAAgB,kBAAkB;iBAIf,MAAM,EAAE,oBAAoB,MAAM;iBAIlC,UAAU,oBAAoB,MAAM;;;;EAOtD"}

package/dist/cjs/userdata.js

@@ -0,0 +1,24 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTalqingUserdata = useTalqingUserdata;
+const react_1 = require("react");
+const client_1 = require("@talqing/client");
+const session_js_1 = require("./session.js");
+/** Read and write the live session's userdata from inside a provider. */
+function useTalqingUserdata() {
+    const { room } = (0, session_js_1.useTalqingConnection)();
+    return (0, react_1.useMemo)(() => ({
+        get: (keys, responseTimeout) => {
+            if (!room)
+                throw new Error("room is not connected");
+            return (0, client_1.getTalqingUserdata)(room, keys, responseTimeout);
+        },
+        set: (patch, responseTimeout) => {
+            if (!room)
+                throw new Error("room is not connected");
+            return (0, client_1.setTalqingUserdata)(room, patch, responseTimeout);
+        },
+    }), [room]);
+}
+//# sourceMappingURL=userdata.js.map

package/dist/cjs/userdata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.js","sourceRoot":"","sources":["../../src/userdata.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AAWb,gDAeC;AAxBD,iCAAgC;AAChC,4CAIyB;AACzB,6CAAoD;AAEpD,yEAAyE;AACzE,SAAgB,kBAAkB;IAChC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,iCAAoB,GAAE,CAAC;IACxC,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,EAAE,CAAC,IAAe,EAAE,eAAwB,EAAE,EAAE;YACjD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACpD,OAAO,IAAA,2BAAkB,EAAC,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACzD,CAAC;QACD,GAAG,EAAE,CAAC,KAAiB,EAAE,eAAwB,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACpD,OAAO,IAAA,2BAAkB,EAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC,EACF,CAAC,IAAI,CAAC,CACP,CAAC;AACJ,CAAC"}

package/dist/esm/images.d.ts

@@ -0,0 +1,17 @@
+import type { Room } from "livekit-client";
+import { type TalqingSentImage } from "@talqing/client";
+/** Send images to the agent on this call, and follow what became of each.
+ *
+ *  `send` resolves once the bytes are on their way; the outcome arrives on the
+ *  returned list, which is what a thumbnail should render.
+ *
+ *  Takes the `Room` rather than reading it from the session context: a byte
+ *  stream and an RPC handler are room-level things, and passing the room keeps
+ *  this usable from a surface that manages its own connection —
+ *  `useTalqingConnection().room` inside a provider, or the Room you built. */
+export declare function useTalqingImages(room: Room | null | undefined): {
+    send: (file: File) => Promise<TalqingSentImage>;
+    sent: TalqingSentImage[];
+    clear: () => void;
+};
+//# sourceMappingURL=images.d.ts.map

package/dist/esm/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/images.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;8EAQ8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS;iBA4C7C,IAAI,KAAG,OAAO,CAAC,gBAAgB,CAAC;;;EAgChD"}

package/dist/esm/images.js

@@ -0,0 +1,65 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { onTalqingImageResult, sendTalqingImage, TALQING_IMAGE_ACK_TIMEOUT_MS, } from "@talqing/client";
+/** Send images to the agent on this call, and follow what became of each.
+ *
+ *  `send` resolves once the bytes are on their way; the outcome arrives on the
+ *  returned list, which is what a thumbnail should render.
+ *
+ *  Takes the `Room` rather than reading it from the session context: a byte
+ *  stream and an RPC handler are room-level things, and passing the room keeps
+ *  this usable from a surface that manages its own connection —
+ *  `useTalqingConnection().room` inside a provider, or the Room you built. */
+export function useTalqingImages(room) {
+    const [sent, setSent] = useState([]);
+    const timers = useRef(new Map());
+    const settle = useCallback((streamId, patch) => {
+        const timer = timers.current.get(streamId);
+        if (timer) {
+            clearTimeout(timer);
+            timers.current.delete(streamId);
+        }
+        setSent((images) => images.map((image) => (image.streamId === streamId ? { ...image, ...patch } : image)));
+    }, []);
+    useEffect(() => {
+        if (!room)
+            return;
+        return onTalqingImageResult(room, ({ streamId, ok, error }) => settle(streamId, { status: ok ? "sent" : "failed", error }));
+    }, [room, settle]);
+    const pending = timers.current;
+    useEffect(() => () => {
+        pending.forEach(clearTimeout);
+        pending.clear();
+    }, [pending]);
+    /* Each thumbnail is an object URL over the downscaled blob, and each pins that
+       blob in memory until it is revoked. This hook is mounted per call, so
+       without this every call's images would be held for the life of the tab. */
+    const previews = useRef([]);
+    useEffect(() => () => {
+        previews.current.forEach(URL.revokeObjectURL);
+        previews.current = [];
+    }, []);
+    const send = useCallback(async (file) => {
+        if (!room)
+            throw new Error("the call is not connected");
+        const image = await sendTalqingImage(room, file);
+        previews.current.push(image.previewUrl);
+        setSent((images) => [...images, image]);
+        timers.current.set(image.streamId, setTimeout(() => settle(image.streamId, {
+            status: "unknown",
+            // Four states, not two: the one people forget is the agent going
+            // away mid-upload, where no ack is ever coming.
+            error: "we did not hear back — the agent may not have received it",
+        }), TALQING_IMAGE_ACK_TIMEOUT_MS));
+        return image;
+    }, [room, settle]);
+    const clear = useCallback(() => {
+        setSent((images) => {
+            images.forEach((image) => URL.revokeObjectURL(image.previewUrl));
+            previews.current = [];
+            return [];
+        });
+    }, []);
+    return { send, sent, clear };
+}
+//# sourceMappingURL=images.js.map

package/dist/esm/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../src/images.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,10 @@
+export { TalqingSessionProvider, useTalqingConnection, useTalqingSession, } from "./session.js";
+export type { TalqingCallOptions, TalqingSession, TalqingSessionOptions, } from "./session.js";
+export { useTalqingUserdata } from "./userdata.js";
+export { useTalqingImages } from "./images.js";
+export { useTalqingFrontendRpcs, useTalqingRpcHandlers } from "./rpc.js";
+export { useTalqingAvatarTrack, useTalqingScreenShare } from "./media.js";
+export * from "@talqing/client";
+export { useAgent, useSessionMessages, VideoTrack, } from "@livekit/components-react";
+export type { AgentState, ReceivedMessage, TrackReference, UseAgentReturn, UseSessionReturn, } from "@livekit/components-react";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ1E,cAAc,iBAAiB,CAAC;AAYhC,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,35 @@
+/* React bindings for the Talqing call protocol.
+ *
+ * Thin by design. Everything here is either the call lifecycle (`useTalqingSession`
+ * and the auth union it takes) or a hook over something `@talqing/client` does to
+ * a `Room`. Nothing here wraps LiveKit to rename it: the layer only ever ADDS, so
+ * anything LiveKit can do you can do — take `useTalqingConnection().room` and use
+ * `livekit-client` directly. We never remove a capability to make our own surface
+ * look tidier, which is also why `livekit-client` and `@livekit/components-react`
+ * are peer dependencies: the `Room` we hand you is the same class your own
+ * imports and `instanceof` resolve to.
+ */
+export { TalqingSessionProvider, useTalqingConnection, useTalqingSession, } from "./session.js";
+export { useTalqingUserdata } from "./userdata.js";
+export { useTalqingImages } from "./images.js";
+export { useTalqingFrontendRpcs, useTalqingRpcHandlers } from "./rpc.js";
+export { useTalqingAvatarTrack, useTalqingScreenShare } from "./media.js";
+/* All of `@talqing/client`, so one install and one import cover a web call.
+ * Everything there works against any `Room`, with or without React — the token
+ * source, the userdata and image and frontend-RPC calls, and the measured
+ * capture constants. Re-exported wholesale rather than as a curated list
+ * because the whole package is meant to be reachable from here, and a list
+ * would quietly fall behind it. */
+export * from "@talqing/client";
+/* LiveKit's own, re-exported UNDER THEIR OWN NAMES so a tenant installs one
+ * package and imports one name.
+ *
+ * Re-exporting is not wrapping: there is no surface of ours here to drift, and
+ * nothing is subtracted — `useAgent` is the ten-state discriminated union
+ * LiveKit ships, with every derived boolean, every action and
+ * `failureReasons` intact. Keeping LiveKit's names is the point: a
+ * `useTalqing`-prefixed alias would claim these as ours and hide where to read
+ * their documentation. Import them from `@livekit/components-react` instead if
+ * you prefer — it is the same module. */
+export { useAgent, useSessionMessages, VideoTrack, } from "@livekit/components-react";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;mCAKmC;AACnC,cAAc,iBAAiB,CAAC;AAEhC;;;;;;;;;yCASyC;AACzC,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,UAAU,GACX,MAAM,2BAA2B,CAAC"}

package/dist/esm/media.d.ts

@@ -0,0 +1,20 @@
+import { type TrackReference } from "@livekit/components-react";
+/** Share the caller's screen with the agent, on the settings that keep it
+ *  legible — see `TALQING_SCREEN_SHARE_CAPTURE` for why each one is what it is. */
+export declare function useTalqingScreenShare(): {
+    /** Whether a screen is being shared right now. */
+    enabled: boolean;
+    /** True while the browser picker is open or the track is publishing. */
+    pending: boolean;
+    /** Opens the browser's share picker. Must be called from a user gesture. */
+    start: () => Promise<boolean | undefined> | Promise<void>;
+    /** Stops sharing. The agent is told it can no longer see on the next turn. */
+    stop: () => Promise<boolean | undefined> | Promise<void>;
+};
+/** The video track to render for a video agent.
+ *
+ *  Prefers the avatar worker's camera — the worker publishes on the agent's
+ *  behalf, which is how it is identified — and falls back through the worker's
+ *  screen share and then the agent's own tracks. */
+export declare function useTalqingAvatarTrack(): TrackReference | undefined;
+//# sourceMappingURL=media.d.ts.map

package/dist/esm/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAMnC;mFACmF;AACnF,wBAAgB,qBAAqB;IAQ/B,kDAAkD;;IAElD,wEAAwE;;IAExE,4EAA4E;;IAE5E,8EAA8E;;EAKnF;AAED;;;;oDAIoD;AACpD,wBAAgB,qBAAqB,IAAI,cAAc,GAAG,SAAS,CAgClE"}

package/dist/esm/media.js

@@ -0,0 +1,42 @@
+"use client";
+import { useMemo } from "react";
+import { ParticipantKind, Track } from "livekit-client";
+import { useParticipantTracks, useRemoteParticipants, useTrackToggle, useVoiceAssistant, } from "@livekit/components-react";
+import { TALQING_SCREEN_SHARE_CAPTURE, TALQING_SCREEN_SHARE_PUBLISH, } from "@talqing/client";
+/** Share the caller's screen with the agent, on the settings that keep it
+ *  legible — see `TALQING_SCREEN_SHARE_CAPTURE` for why each one is what it is. */
+export function useTalqingScreenShare() {
+    const { toggle, enabled, pending } = useTrackToggle({
+        source: Track.Source.ScreenShare,
+        captureOptions: TALQING_SCREEN_SHARE_CAPTURE,
+        publishOptions: TALQING_SCREEN_SHARE_PUBLISH,
+    });
+    return useMemo(() => ({
+        /** Whether a screen is being shared right now. */
+        enabled,
+        /** True while the browser picker is open or the track is publishing. */
+        pending,
+        /** Opens the browser's share picker. Must be called from a user gesture. */
+        start: () => toggle(true),
+        /** Stops sharing. The agent is told it can no longer see on the next turn. */
+        stop: () => toggle(false),
+    }), [enabled, pending, toggle]);
+}
+/** The video track to render for a video agent.
+ *
+ *  Prefers the avatar worker's camera — the worker publishes on the agent's
+ *  behalf, which is how it is identified — and falls back through the worker's
+ *  screen share and then the agent's own tracks. */
+export function useTalqingAvatarTrack() {
+    const { agent } = useVoiceAssistant();
+    const remoteParticipants = useRemoteParticipants();
+    const worker = remoteParticipants.find((participant) => participant.kind === ParticipantKind.AGENT &&
+        participant.attributes["lk.publish_on_behalf"] === agent?.identity);
+    const agentTracks = useParticipantTracks([Track.Source.Camera, Track.Source.ScreenShare], agent?.identity);
+    const workerTracks = useParticipantTracks([Track.Source.Camera, Track.Source.ScreenShare], worker?.identity);
+    return (workerTracks.find((track) => track.source === Track.Source.Camera) ??
+        workerTracks.find((track) => track.source === Track.Source.ScreenShare) ??
+        agentTracks.find((track) => track.source === Track.Source.Camera) ??
+        agentTracks.find((track) => track.source === Track.Source.ScreenShare));
+}
+//# sourceMappingURL=media.js.map

package/dist/esm/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,KAAK,EAA0B,MAAM,gBAAgB,CAAC;AAChF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,GAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAEzB;mFACmF;AACnF,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC;QAClD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;QAChC,cAAc,EAAE,4BAA4B;QAC5C,cAAc,EAAE,4BAA4B;KAC7C,CAAC,CAAC;IACH,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,kDAAkD;QAClD,OAAO;QACP,wEAAwE;QACxE,OAAO;QACP,4EAA4E;QAC5E,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,8EAA8E;QAC9E,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;KAC1B,CAAC,EACF,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;oDAIoD;AACpD,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACtC,MAAM,kBAAkB,GAAG,qBAAqB,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CACpC,CAAC,WAA8B,EAAE,EAAE,CACjC,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC,KAAK;QAC1C,WAAW,CAAC,UAAU,CAAC,sBAAsB,CAAC,KAAK,KAAK,EAAE,QAAQ,CACrE,CAAC;IAEF,MAAM,WAAW,GAAG,oBAAoB,CACtC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAC/C,KAAK,EAAE,QAAQ,CAChB,CAAC;IACF,MAAM,YAAY,GAAG,oBAAoB,CACvC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAC/C,MAAM,EAAE,QAAQ,CACjB,CAAC;IAEF,OAAO,CACL,YAAY,CAAC,IAAI,CACf,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAChE;QACD,YAAY,CAAC,IAAI,CACf,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,WAAW,CACrE;QACD,WAAW,CAAC,IAAI,CACd,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAChE;QACD,WAAW,CAAC,IAAI,CACd,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,WAAW,CACrE,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/rpc.d.ts

@@ -0,0 +1,17 @@
+import { type JsonValue, type TalqingRpcHandlers } from "@talqing/client";
+/** Handle the agent's `frontend_rpc` calls into this page.
+ *
+ *  Registration waits for the room to connect and is undone on unmount. Pass
+ *  `enabled: false` to hold off. */
+export declare function useTalqingRpcHandlers(handlers: TalqingRpcHandlers, enabled?: boolean): void;
+/** The declarative alternative: register nothing, render what arrived.
+ *
+ *  Keeps the latest payload per method name and always answers the agent "ok". */
+export declare function useTalqingFrontendRpcs(enabled?: boolean): {
+    actions: Record<string, {
+        payload?: JsonValue;
+        at: number;
+    }>;
+    clear: () => void;
+};
+//# sourceMappingURL=rpc.d.ts.map

package/dist/esm/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AAGzB;;;oCAGoC;AACpC,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,UAAO,QAOjF;AAED;;kFAEkF;AAClF,wBAAgB,sBAAsB,CAAC,OAAO,UAAO;;kBAEtB,SAAS;YAAM,MAAM;;;EA+BnD"}

package/dist/esm/rpc.js

@@ -0,0 +1,44 @@
+"use client";
+import { useEffect, useMemo, useState } from "react";
+import { registerTalqingRpcHandlers, } from "@talqing/client";
+import { useTalqingConnection } from "./session.js";
+/** Handle the agent's `frontend_rpc` calls into this page.
+ *
+ *  Registration waits for the room to connect and is undone on unmount. Pass
+ *  `enabled: false` to hold off. */
+export function useTalqingRpcHandlers(handlers, enabled = true) {
+    const { room, isConnected } = useTalqingConnection();
+    useEffect(() => {
+        if (!enabled || !room || !isConnected)
+            return;
+        return registerTalqingRpcHandlers(room, handlers);
+    }, [enabled, handlers, isConnected, room]);
+}
+/** The declarative alternative: register nothing, render what arrived.
+ *
+ *  Keeps the latest payload per method name and always answers the agent "ok". */
+export function useTalqingFrontendRpcs(enabled = true) {
+    const [actions, setActions] = useState({});
+    const handlers = useMemo(() => ({
+        "*": async (data) => {
+            const payload = JSON.parse(data.payload || "{}");
+            const method = String(payload.method || "");
+            if (method) {
+                setActions((current) => ({
+                    ...current,
+                    [method]: {
+                        payload: payload.payload,
+                        at: Date.now(),
+                    },
+                }));
+            }
+            return "ok";
+        },
+    }), []);
+    useTalqingRpcHandlers(handlers, enabled);
+    return {
+        actions,
+        clear: () => setActions({}),
+    };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/esm/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EACL,0BAA0B,GAI3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;oCAGoC;AACpC,MAAM,UAAU,qBAAqB,CAAC,QAA4B,EAAE,OAAO,GAAG,IAAI;IAChF,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAErD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9C,OAAO,0BAA0B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;kFAEkF;AAClF,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAG,IAAI;IACnD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAEpC,EAAE,CAAC,CAAC;IAEN,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,EAAE,KAAK,EAAE,IAA0B,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAc,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,CAAE,OAA+B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACrE,IAAI,MAAM,EAAE,CAAC;gBACX,UAAU,CACR,CAAC,OAA4D,EAAE,EAAE,CAAC,CAAC;oBACjE,GAAG,OAAO;oBACV,CAAC,MAAM,CAAC,EAAE;wBACR,OAAO,EAAG,OAAmC,CAAC,OAAO;wBACrD,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;qBACf;iBACF,CAAC,CACH,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,EACF,EAAE,CACH,CAAC;IAEF,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,OAAO;QACP,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/esm/session.d.ts

@@ -0,0 +1,77 @@
+import React from "react";
+import { Room, type RoomOptions } from "livekit-client";
+import { type UseSessionReturn } from "@livekit/components-react";
+import { type TalqingCallCredentials } from "@talqing/client";
+import type { TalqingClient, TokenRequest } from "@talqing/sdk";
+/** Everything about one web call except which agent runs it. Wire-shaped, like
+ *  every other request type in this SDK. */
+export type TalqingCallOptions = Omit<TokenRequest, "agent_id">;
+type TalqingCallAuth = 
+/** Your server called `POST /v1/calls/token` and forwarded these two fields. */
+{
+    token: TalqingCallCredentials;
+    fetchToken?: never;
+    client?: never;
+    agentId?: never;
+    callOptions?: never;
+}
+/** Your endpoint mints one. Called once, when the call starts. */
+ | {
+    fetchToken: () => Promise<TalqingCallCredentials>;
+    token?: never;
+    client?: never;
+    agentId?: never;
+    callOptions?: never;
+}
+/** Mint from the browser with a `TalqingClient` that already holds a
+ *  credential. **Trusted first-party surfaces only** — an app that is
+ *  same-origin with the API and signed in as a real editor, which is what our
+ *  own dashboard is. If you are embedding a call widget for your customers,
+ *  this is not your branch. */
+ | {
+    client: TalqingClient;
+    agentId: string | null;
+    /** `contact_key`, `userdata`, `vars` and the per-call agent selection.
+     *  Only on this branch: on the other two the server passes them when it
+     *  mints, which is what keeps a browser from choosing whose history to
+     *  resume. */
+    callOptions?: TalqingCallOptions;
+    token?: never;
+    fetchToken?: never;
+};
+export type TalqingSessionOptions = TalqingCallAuth & {
+    roomOptions?: RoomOptions;
+};
+/** LiveKit's session, plus what resolving this call's plan complained about. */
+export type TalqingSession = UseSessionReturn & {
+    /** An unreachable team member, a handoff into an agent that records when this
+     *  one does not — resolved against state at CALL time, so it is not the list
+     *  publishing returned. Empty until the token is minted.
+     *
+     *  Populated on the `client` branch, which is the one where this browser is
+     *  what minted. On the two server-minted branches your own server received
+     *  them in the token response and this stays empty. */
+    warnings: string[];
+};
+/** One session, one call — `start()` it when this mounts and `end()` it on the
+ *  way out, the lifecycle LiveKit's own session docs describe. A second call is
+ *  a second mount, so give the component holding this a `key` that changes per
+ *  call. Starting a finished session again would rejoin the room the last call
+ *  used, which the API refuses. */
+export declare function useTalqingSession(options: TalqingSessionOptions): TalqingSession;
+export declare function TalqingSessionProvider({ session, children, audio, }: {
+    session: TalqingSession;
+    children: React.ReactNode;
+    audio?: boolean;
+}): React.JSX.Element;
+/** The call itself, read from context — and `room`, which is the supported way
+ *  down to raw `livekit-client` for anything this layer does not cover. */
+export declare function useTalqingConnection(): {
+    isConnected: boolean;
+    connectionState: import("livekit-client").ConnectionState;
+    room: Room;
+    start: (options?: import("@livekit/components-react").SessionConnectOptions) => Promise<void>;
+    end: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/esm/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE;4CAC4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAmBhE,KAAK,eAAe;AAClB,gFAAgF;AAC9E;IACE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AACH,kEAAkE;GAChE;IACE,UAAU,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AACH;;;;+BAI+B;GAC7B;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;kBAGc;IACd,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEpF,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC9C;;;;;;2DAMuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;mCAImC;AACnC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAyBhF;AAED,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,EACR,KAAY,GACb,EAAE;IACD,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,qBAOA;AAED;2EAC2E;AAC3E,wBAAgB,oBAAoB;;;;;;EASnC"}

package/dist/esm/session.js

@@ -0,0 +1,50 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo, useState } from "react";
+import { Room } from "livekit-client";
+import { RoomAudioRenderer, SessionProvider, useSession, useSessionContext, } from "@livekit/components-react";
+import { createTalqingTokenSource, TALQING_AUDIO_CAPTURE_DEFAULTS, } from "@talqing/client";
+/** One session, one call — `start()` it when this mounts and `end()` it on the
+ *  way out, the lifecycle LiveKit's own session docs describe. A second call is
+ *  a second mount, so give the component holding this a `key` that changes per
+ *  call. Starting a finished session again would rejoin the room the last call
+ *  used, which the API refuses. */
+export function useTalqingSession(options) {
+    const { token, fetchToken, client, agentId, callOptions, roomOptions } = options;
+    const [warnings, setWarnings] = useState([]);
+    // Reads every branch's fields so the dependency list is the same length on
+    // each; all but one are `undefined` on any given call.
+    const mint = useCallback(async () => {
+        if (token)
+            return token;
+        if (fetchToken)
+            return await fetchToken();
+        if (!client)
+            throw new Error("useTalqingSession needs one of token, fetchToken or client");
+        const minted = await client.calls.token({
+            tokenRequest: { ...callOptions, agent_id: agentId ?? null },
+        });
+        setWarnings(minted.warnings);
+        return { server_url: minted.server_url, participant_token: minted.participant_token };
+    }, [token, fetchToken, client, agentId, callOptions]);
+    const tokenSource = useMemo(() => createTalqingTokenSource(mint), [mint]);
+    const room = useMemo(() => new Room({ audioCaptureDefaults: TALQING_AUDIO_CAPTURE_DEFAULTS, ...roomOptions }), [roomOptions]);
+    const session = useSession(tokenSource, { room });
+    return useMemo(() => ({ ...session, warnings }), [session, warnings]);
+}
+export function TalqingSessionProvider({ session, children, audio = true, }) {
+    return (_jsxs(SessionProvider, { session: session, children: [children, audio ? _jsx(RoomAudioRenderer, {}) : null] }));
+}
+/** The call itself, read from context — and `room`, which is the supported way
+ *  down to raw `livekit-client` for anything this layer does not cover. */
+export function useTalqingConnection() {
+    const ctx = useSessionContext();
+    return {
+        isConnected: ctx.isConnected,
+        connectionState: ctx.connectionState,
+        room: ctx.room,
+        start: ctx.start,
+        end: ctx.end,
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/esm/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAoB,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,iBAAiB,GAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAE/B,MAAM,iBAAiB,CAAC;AAwEzB;;;;mCAImC;AACnC,MAAM,UAAU,iBAAiB,CAAC,OAA8B;IAC9D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACjF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IAEvD,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAqC,EAAE;QACnE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,UAAU;YAAE,OAAO,MAAM,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC3F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YACtC,YAAY,EAAE,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI,EAAE;SAC5D,CAAC,CAAC;QACH,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;IACxF,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAEtD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,OAAO,CAClB,GAAG,EAAE,CACH,IAAI,IAAI,CAAC,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,GAAG,WAAW,EAAE,CAAC,EACpF,CAAC,WAAW,CAAC,CACd,CAAC;IACF,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,EACR,KAAK,GAAG,IAAI,GAKb;IACC,OAAO,CACL,MAAC,eAAe,IAAC,OAAO,EAAE,OAAO,aAC9B,QAAQ,EACR,KAAK,CAAC,CAAC,CAAC,KAAC,iBAAiB,KAAG,CAAC,CAAC,CAAC,IAAI,IACrB,CACnB,CAAC;AACJ,CAAC;AAED;2EAC2E;AAC3E,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,EAAE,GAAG,CAAC,GAAG;KACb,CAAC;AACJ,CAAC"}

package/dist/esm/userdata.d.ts

@@ -0,0 +1,10 @@
+import { type JsonObject } from "@talqing/client";
+/** Read and write the live session's userdata from inside a provider. */
+export declare function useTalqingUserdata(): {
+    get: (keys?: string[], responseTimeout?: number) => Promise<JsonObject>;
+    set: (patch: JsonObject, responseTimeout?: number) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+};
+//# sourceMappingURL=userdata.d.ts.map

package/dist/esm/userdata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.d.ts","sourceRoot":"","sources":["../../src/userdata.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAGzB,yEAAyE;AACzE,wBAAgB,kBAAkB;iBAIf,MAAM,EAAE,oBAAoB,MAAM;iBAIlC,UAAU,oBAAoB,MAAM;;;;EAOtD"}

package/dist/esm/userdata.js

@@ -0,0 +1,21 @@
+"use client";
+import { useMemo } from "react";
+import { getTalqingUserdata, setTalqingUserdata, } from "@talqing/client";
+import { useTalqingConnection } from "./session.js";
+/** Read and write the live session's userdata from inside a provider. */
+export function useTalqingUserdata() {
+    const { room } = useTalqingConnection();
+    return useMemo(() => ({
+        get: (keys, responseTimeout) => {
+            if (!room)
+                throw new Error("room is not connected");
+            return getTalqingUserdata(room, keys, responseTimeout);
+        },
+        set: (patch, responseTimeout) => {
+            if (!room)
+                throw new Error("room is not connected");
+            return setTalqingUserdata(room, patch, responseTimeout);
+        },
+    }), [room]);
+}
+//# sourceMappingURL=userdata.js.map

package/dist/esm/userdata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.js","sourceRoot":"","sources":["../../src/userdata.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,yEAAyE;AACzE,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAE,IAAI,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACxC,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,EAAE,CAAC,IAAe,EAAE,eAAwB,EAAE,EAAE;YACjD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACpD,OAAO,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACzD,CAAC;QACD,GAAG,EAAE,CAAC,KAAiB,EAAE,eAAwB,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACpD,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC,EACF,CAAC,IAAI,CAAC,CACP,CAAC;AACJ,CAAC"}