@talqing/sdk 0.1.0 → 0.2.0

package/README.md

@@ -15,7 +15,8 @@ Two entrypoints:
 npm install @talqing/sdk
 ```
 
-Node 20 or newer. `react` and `react-dom` are peer dependencies of the
+Node 20 or newer. Both entrypoints ship ESM and CommonJS, so `import` and
+`require` both work. `react` and `react-dom` are peer dependencies of the
 `/browser` entrypoint only — a server-side consumer never installs them.
 
 ## Authentication

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

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

package/dist/cjs/browser.js

@@ -0,0 +1,463 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TALQING_SCREEN_SHARE_PUBLISH = exports.TALQING_SCREEN_SHARE_CAPTURE = exports.TALQING_IMAGE_MAX_EDGE_PX = exports.TALQING_IMAGE_MAX_BYTES = exports.TALQING_IMAGE_TOPIC = exports.TALQING_AUDIO_CAPTURE_DEFAULTS = exports.TalqingRpcError = void 0;
+exports.createTalqingTokenSource = createTalqingTokenSource;
+exports.useTalqingSession = useTalqingSession;
+exports.TalqingSessionProvider = TalqingSessionProvider;
+exports.useTalqingConnection = useTalqingConnection;
+exports.setTalqingUserdata = setTalqingUserdata;
+exports.getTalqingUserdata = getTalqingUserdata;
+exports.useTalqingUserdata = useTalqingUserdata;
+exports.talqingImageRejection = talqingImageRejection;
+exports.talqingDownscaleImage = talqingDownscaleImage;
+exports.talqingImageDataUrl = talqingImageDataUrl;
+exports.useTalqingImages = useTalqingImages;
+exports.useTalqingAgent = useTalqingAgent;
+exports.useTalqingMessages = useTalqingMessages;
+exports.useTalqingScreenShare = useTalqingScreenShare;
+exports.useTalqingAvatarTrack = useTalqingAvatarTrack;
+exports.TalqingVideoTrack = TalqingVideoTrack;
+exports.useTalqingRpcHandlers = useTalqingRpcHandlers;
+exports.useTalqingFrontendRpcs = useTalqingFrontendRpcs;
+exports.setTalqingBrowserLogLevel = setTalqingBrowserLogLevel;
+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");
+class TalqingRpcError extends Error {
+    constructor(code, message, data) {
+        super(message);
+        this.name = "TalqingRpcError";
+        this.code = code;
+        this.data = data;
+    }
+}
+exports.TalqingRpcError = TalqingRpcError;
+function createTalqingTokenSource(client, agentId, options = {}, onTokenDetails) {
+    // Carry the contact across reconnects. POST /v1/calls/token mints a key when
+    // none is supplied, so re-running this without pinning it would file every
+    // reconnect as a different person.
+    let resolvedContactKey = options.contact_key ?? null;
+    // `useSession` fetches a token twice off one click — once to warm the
+    // connection, once to connect. Unserialised they race: both go out before
+    // either resolves, so neither carries a key, the API mints one per request,
+    // and a single call is filed against two different contacts. Concurrent
+    // callers share one request.
+    //
+    // This coalesces, it does not cache: the promise is dropped once it settles,
+    // so every later connect still mints a fresh token. That matters — a token
+    // bakes in {agent version, room}, so a reused one silently runs a stale
+    // version after a republish, and reconnects into a dead room.
+    let inFlight = null;
+    return livekit_client_1.TokenSource.literal(async () => {
+        if (inFlight)
+            return inFlight;
+        const request = (async () => {
+            const details = await client.calls.token({
+                tokenRequest: { ...options, agent_id: agentId, contact_key: resolvedContactKey },
+            });
+            resolvedContactKey = details.contact_key;
+            onTokenDetails?.(details);
+            return {
+                serverUrl: details.server_url,
+                participantToken: details.participant_token,
+            };
+        })();
+        inFlight = request;
+        try {
+            return await request;
+        }
+        finally {
+            inFlight = null;
+        }
+    });
+}
+/* Echo cancellation is what stops the agent hearing its own speech through the
+ * caller's microphone and interrupting itself. It is a default rather than
+ * something each app remembers, because a call without it is broken in a way
+ * that sounds like a bad model. Pass `roomOptions.audioCaptureDefaults` to
+ * override. */
+exports.TALQING_AUDIO_CAPTURE_DEFAULTS = {
+    echoCancellation: true,
+    noiseSuppression: true,
+    autoGainControl: true,
+};
+function useTalqingSession({ client, agentId, roomOptions, callOptions, onTokenDetails, }) {
+    const tokenSource = (0, react_1.useMemo)(() => createTalqingTokenSource(client, agentId, callOptions, onTokenDetails), [client, agentId, callOptions, onTokenDetails]);
+    const room = (0, react_1.useMemo)(() => new livekit_client_1.Room({ audioCaptureDefaults: exports.TALQING_AUDIO_CAPTURE_DEFAULTS, ...roomOptions }), [roomOptions]);
+    return (0, components_react_1.useSession)(tokenSource, { room });
+}
+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] }));
+}
+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,
+    };
+}
+async function setTalqingUserdata(room, patch, responseTimeout = 3) {
+    const agent = [...room.remoteParticipants.values()].find((participant) => participant.kind === livekit_client_1.ParticipantKind.AGENT);
+    if (!agent)
+        return { ok: false, error: "agent participant is not connected" };
+    const response = await room.localParticipant.performRpc({
+        destinationIdentity: agent.identity,
+        method: "talqing.client.userdata_set",
+        payload: JSON.stringify(patch),
+        responseTimeout,
+    });
+    return JSON.parse(response || "{}");
+}
+async function getTalqingUserdata(room, keys, responseTimeout = 3) {
+    const agent = [...room.remoteParticipants.values()].find((participant) => participant.kind === livekit_client_1.ParticipantKind.AGENT);
+    if (!agent)
+        throw new Error("agent participant is not connected");
+    const response = await room.localParticipant.performRpc({
+        destinationIdentity: agent.identity,
+        method: "talqing.client.userdata_get",
+        payload: JSON.stringify(keys ? { keys } : {}),
+        responseTimeout,
+    });
+    const parsed = JSON.parse(response || "{}");
+    if (parsed.ok === false) {
+        throw new Error(String(parsed.error || "userdata RPC failed"));
+    }
+    return parsed;
+}
+function useTalqingUserdata() {
+    const { room } = useTalqingConnection();
+    return (0, react_1.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]);
+}
+/* ── images ───────────────────────────────────────────────────────────────
+ *
+ * A caller attaches a photo on a web voice or video call and the agent sees
+ * it. The bytes go over a LiveKit byte stream on the `talqing.images` topic,
+ * addressed to the agent; the agent answers on an RPC back, and the id
+ * `sendFile` returns is the id that ack carries, so there is nothing to
+ * correlate by hand.
+ *
+ * The agent deliberately does NOT speak when a photo lands — the caller is
+ * mid-conversation and about to say what it is for. The image is in the
+ * model's view for their next turn.
+ */
+exports.TALQING_IMAGE_TOPIC = "talqing.images";
+/** Decoded size the server refuses above. The downscale below keeps a phone
+ *  photo far under it; this is the belt for a file that is not a photo. */
+exports.TALQING_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+/** Longest side the server stores. Downscaling to it before sending is a
+ *  courtesy to the data channel, which is ordered and reliable and will
+ *  happily spend a minute pushing 10 MB past a call's audio. */
+exports.TALQING_IMAGE_MAX_EDGE_PX = 1568;
+const TALQING_IMAGE_TYPES = ["image/jpeg", "image/png", "image/webp"];
+/** How long to wait for the agent's ack before saying we do not know. Without
+ *  it a thumbnail sits on "sending" for the rest of the call when the worker
+ *  dies mid-upload. */
+const TALQING_IMAGE_ACK_TIMEOUT_MS = 30000;
+/** Refuse what the browser can see is wrong, instantly and with no round trip.
+ *  Returns the sentence to show, or null when the file is fine. The server
+ *  re-validates everything regardless — this exists so the common mistakes cost
+ *  nothing to catch. */
+function talqingImageRejection(file) {
+    if (!TALQING_IMAGE_TYPES.includes(file.type)) {
+        return "that file is not a JPEG, PNG or WebP";
+    }
+    if (file.size > exports.TALQING_IMAGE_MAX_BYTES)
+        return "images are 10 MB or smaller";
+    return null;
+}
+/** Downscale to the longest edge the server keeps, re-encoding as JPEG or PNG.
+ *
+ *  Also what normalizes whatever the OS handed the file input — this is how a
+ *  Safari HEIC becomes a JPEG. Throws if the image cannot be decoded, which is
+ *  the third dropzone check. */
+async function talqingDownscaleImage(file) {
+    const bitmap = await createImageBitmap(file);
+    try {
+        const longest = Math.max(bitmap.width, bitmap.height);
+        const scale = longest > exports.TALQING_IMAGE_MAX_EDGE_PX ? exports.TALQING_IMAGE_MAX_EDGE_PX / longest : 1;
+        const canvas = document.createElement("canvas");
+        canvas.width = Math.max(1, Math.round(bitmap.width * scale));
+        canvas.height = Math.max(1, Math.round(bitmap.height * scale));
+        const context = canvas.getContext("2d");
+        if (!context)
+            throw new Error("this browser cannot resize images");
+        context.drawImage(bitmap, 0, 0, canvas.width, canvas.height);
+        // PNG keeps transparency; everything else becomes a JPEG, including the
+        // HEIC the OS decoded for us.
+        const type = file.type === "image/png" ? "image/png" : "image/jpeg";
+        const blob = await new Promise((resolve) => canvas.toBlob(resolve, type, 0.85));
+        if (!blob)
+            throw new Error("that image could not be read");
+        return blob;
+    }
+    finally {
+        bitmap.close();
+    }
+}
+/** Validate and downscale a file into the `data:` URL a text message carries.
+ *
+ *  `createTextMessage` takes `images: [{data_url, filename}]`; this produces the
+ *  `data_url`. It doubles as the thumbnail's `src`, so there is no object URL to
+ *  create and revoke. Throws the sentence to show if the file is refused. */
+async function talqingImageDataUrl(file) {
+    const rejection = talqingImageRejection(file);
+    if (rejection)
+        throw new Error(rejection);
+    const blob = await talqingDownscaleImage(file);
+    return await new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onerror = () => reject(new Error("that image could not be read"));
+        reader.onload = () => resolve(String(reader.result));
+        reader.readAsDataURL(blob);
+    });
+}
+/** 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. */
+function useTalqingImages(room) {
+    const [sent, setSent] = (0, react_1.useState)([]);
+    const timers = (0, react_1.useRef)(new Map());
+    const settle = (0, react_1.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)));
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (!room)
+            return;
+        room.registerRpcMethod("talqing.image_result", async (data) => {
+            const { stream_id, ok, error } = JSON.parse(data.payload || "{}");
+            settle(stream_id, {
+                status: ok ? "sent" : "failed",
+                error: ok ? undefined : error || "that image was not accepted",
+            });
+            return "{}";
+        });
+        return () => room.unregisterRpcMethod("talqing.image_result");
+    }, [room, settle]);
+    const pending = timers.current;
+    (0, react_1.useEffect)(() => () => {
+        pending.forEach(clearTimeout);
+        pending.clear();
+    }, [pending]);
+    const send = (0, react_1.useCallback)(async (file) => {
+        if (!room)
+            throw new Error("the call is not connected");
+        const agent = [...room.remoteParticipants.values()].find((participant) => participant.kind === livekit_client_1.ParticipantKind.AGENT);
+        if (!agent)
+            throw new Error("agent participant is not connected");
+        const rejection = talqingImageRejection(file);
+        if (rejection)
+            throw new Error(rejection);
+        const blob = await talqingDownscaleImage(file);
+        // Addressed to the agent, never broadcast: on video the avatar worker is
+        // a participant too, and a broadcast sends the bytes twice.
+        const { id } = await room.localParticipant.sendFile(new File([blob], file.name, { type: blob.type }), {
+            topic: exports.TALQING_IMAGE_TOPIC,
+            mimeType: blob.type,
+            destinationIdentities: [agent.identity],
+        });
+        const image = {
+            streamId: id,
+            name: file.name,
+            previewUrl: URL.createObjectURL(blob),
+            status: "sending",
+        };
+        setSent((images) => [...images, image]);
+        timers.current.set(id, setTimeout(() => settle(id, {
+            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 = (0, react_1.useCallback)(() => {
+        setSent((images) => {
+            images.forEach((image) => URL.revokeObjectURL(image.previewUrl));
+            return [];
+        });
+    }, []);
+    return { send, sent, clear };
+}
+function useTalqingAgent() {
+    const agent = (0, components_react_1.useAgent)();
+    return {
+        state: agent.state,
+        isFinished: agent.isFinished,
+    };
+}
+function useTalqingMessages() {
+    const messages = (0, components_react_1.useSessionMessages)();
+    return {
+        messages: messages.messages,
+        send: messages.send,
+        isSending: messages.isSending,
+    };
+}
+/* Screen share, with the four settings that decide whether the agent can read
+ * what is on it.
+ *
+ * Only the first is obvious, and every one of them is upstream of anything we
+ * could do on our side:
+ *
+ *  - `contentHint: "text"` tells the encoder to preserve spatial detail. The
+ *    default for a screen share on an SVC codec is `motion`, which trades
+ *    exactly that away — the wrong trade for reading code, and no JPEG quality
+ *    setting downstream recovers it.
+ *  - `videoCodec: "h264"` is what keeps that hint. `livekit-client` forces
+ *    `contentHint = "motion"` on screen shares published as vp9 or av1,
+ *    together with `scalabilityMode: "L1T3"`. **Publishing on an SVC codec will
+ *    cost you legibility**, and it is the first thing to check if the agent
+ *    starts misreading identifiers.
+ *  - `screenShareEncoding.maxFramerate: 1` is the frame-rate cap that actually
+ *    binds. `resolution.frameRate` reaches `getDisplayMedia` as a bare number,
+ *    which WebRTC reads as `ideal` — a wish, not a limit. The default publish
+ *    ceiling is 15 fps, and every delivered frame is copied into the agent's
+ *    process before it can be dropped, so this is the single biggest lever on
+ *    what a call costs the worker. One frame a second is ample: the agent is
+ *    handed the newest frame at the end of each turn, and turns are seconds
+ *    apart.
+ *  - `resolution` is set explicitly rather than inherited. The default is 1080p
+ *    by `ideal`, which is a strong hint and not a guarantee.
+ *
+ * The picker cannot be opened for the person — `getDisplayMedia` requires a
+ * transient user activation — so `start()` must be called from a click. The
+ * agent asking out loud is what prompts it; there is no version of this where
+ * the agent turns sharing on.
+ */
+exports.TALQING_SCREEN_SHARE_CAPTURE = {
+    resolution: { width: 1920, height: 1080, frameRate: 1 },
+    contentHint: "text",
+};
+exports.TALQING_SCREEN_SHARE_PUBLISH = {
+    videoCodec: "h264",
+    screenShareEncoding: { maxBitrate: 1000000, maxFramerate: 1 },
+};
+function useTalqingScreenShare() {
+    const { toggle, enabled, pending } = (0, components_react_1.useTrackToggle)({
+        source: livekit_client_1.Track.Source.ScreenShare,
+        captureOptions: exports.TALQING_SCREEN_SHARE_CAPTURE,
+        publishOptions: exports.TALQING_SCREEN_SHARE_PUBLISH,
+    });
+    return (0, react_1.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]);
+}
+function useTalqingAvatarTrack() {
+    const { agent } = (0, components_react_1.useVoiceAssistant)();
+    const remoteParticipants = (0, components_react_1.useRemoteParticipants)();
+    const worker = remoteParticipants.find((participant) => participant.kind === livekit_client_1.ParticipantKind.AGENT &&
+        participant.attributes["lk.publish_on_behalf"] === agent?.identity);
+    const agentTracks = (0, components_react_1.useParticipantTracks)([livekit_client_1.Track.Source.Camera, livekit_client_1.Track.Source.ScreenShare], agent?.identity);
+    const workerTracks = (0, components_react_1.useParticipantTracks)([livekit_client_1.Track.Source.Camera, livekit_client_1.Track.Source.ScreenShare], worker?.identity);
+    return (workerTracks.find((track) => track.source === livekit_client_1.Track.Source.Camera) ??
+        workerTracks.find((track) => track.source === livekit_client_1.Track.Source.ScreenShare) ??
+        agentTracks.find((track) => track.source === livekit_client_1.Track.Source.Camera) ??
+        agentTracks.find((track) => track.source === livekit_client_1.Track.Source.ScreenShare));
+}
+function TalqingVideoTrack({ track, className, }) {
+    return ((0, jsx_runtime_1.jsx)(components_react_1.VideoTrack, { trackRef: track, width: track.publication.dimensions?.width ?? 0, height: track.publication.dimensions?.height ?? 0, className: className }));
+}
+function useTalqingRpcHandlers(handlers, enabled = true) {
+    const { room, isConnected } = useTalqingConnection();
+    (0, react_1.useEffect)(() => {
+        if (!enabled || !room || !isConnected)
+            return;
+        room.registerRpcMethod("talqing.frontend_rpc", async (data) => {
+            try {
+                const envelope = JSON.parse(data.payload || "{}");
+                const isWildcard = handlers[envelope.method] === undefined;
+                const handler = handlers[envelope.method] ?? handlers["*"];
+                if (!handler) {
+                    throw new TalqingRpcError(1404, `No frontend RPC handler registered for ${envelope.method}`);
+                }
+                return await handler({
+                    payload: isWildcard
+                        ? JSON.stringify(envelope)
+                        : envelope.payload === undefined
+                            ? "{}"
+                            : JSON.stringify(envelope.payload),
+                    responseTimeout: data.responseTimeout,
+                    callerIdentity: data.callerIdentity,
+                });
+            }
+            catch (error) {
+                if (error instanceof TalqingRpcError) {
+                    throw new livekit_client_1.RpcError(error.code, error.message, error.data);
+                }
+                throw new livekit_client_1.RpcError(1500, error instanceof Error ? error.message : "RPC handler failed");
+            }
+        });
+        return () => {
+            room.unregisterRpcMethod("talqing.frontend_rpc");
+        };
+    }, [enabled, handlers, isConnected, room]);
+}
+function useTalqingFrontendRpcs(enabled = true) {
+    const [actions, setActions] = (0, react_1.useState)({});
+    const handlers = (0, react_1.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({}),
+    };
+}
+function setTalqingBrowserLogLevel(level) {
+    const levels = {
+        debug: livekit_client_1.LogLevel.debug,
+        info: livekit_client_1.LogLevel.info,
+        warn: livekit_client_1.LogLevel.warn,
+        error: livekit_client_1.LogLevel.error,
+        silent: livekit_client_1.LogLevel.silent,
+    };
+    (0, livekit_client_1.setLogLevel)(levels[level]);
+}
+//# sourceMappingURL=browser.js.map

package/dist/cjs/browser.js.map

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

package/dist/{client.d.ts → cjs/client.d.ts}

@@ -43,6 +43,7 @@ export interface Page<T> {
 type Throwing<T> = {
     [K in keyof T]: T[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => Promise<Exclude<R, undefined>> : Throwing<T[K]>;
 };
+declare const TALQING_API_ERROR: unique symbol;
 /** Every error this API returns, in the one shape it returns them in. */
 export declare class TalqingApiError extends Error {
     readonly name = "TalqingApiError";
@@ -50,6 +51,8 @@ export declare class TalqingApiError extends Error {
     /** Per-field problems, when the failure had more than one. Always present. */
     readonly errors: string[];
     readonly response: Response;
+    readonly [TALQING_API_ERROR] = true;
+    static [Symbol.hasInstance](value: unknown): value is TalqingApiError;
     constructor(body: ErrorResponse, response: Response);
 }
 export interface TalqingClientOptions {

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYxD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEpD,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AACnC,KAAK,aAAa,GAAG,MAAM,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;AAE3E;;wEAEwE;AACxE,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,KAAK,QAAQ,CAAC,CAAC,IAAI;KAChB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAC/D,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAC9C,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnB,CAAC;AAYF,QAAA,MAAM,iBAAiB,EAAE,OAAO,MAA8C,CAAC;AAE/E,yEAAyE;AACzE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,CAAC,iBAAiB,CAAC,QAAQ;IAEpC,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe;gBAIzD,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ;CAMpD;AAED,MAAM,WAAW,oBAAoB;IACnC;;4EAEwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,sDAAsD;IACtD,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACnD;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,cAAc,IAAI,MAAM,CAAC;IACzB,6DAA6D;IAC7D,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjE;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB;CAAG;AAwDnF,eAAO,MAAM,aAAa,EAAmC,KAC3D,OAAO,EAAE,oBAAoB,KAC1B,aAAa,CAAC;AAOnB;;;;;;;GAOG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,IAAI,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EACpE,EAAE,KAAW,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,cAAc,CAAC,CAAC,CAAC,CAMnB"}

package/dist/cjs/client.js

@@ -0,0 +1,109 @@
+"use strict";
+/** The hand-written half of the SDK: everything the OpenAPI document cannot say.
+ *
+ * The API surface itself is generated into `./gen` from `openapi/openapi.json`
+ * and is never edited here. What is left is the client object that carries
+ * credentials, the error type, the two browser-redirect URLs that are
+ * deliberately absent from the document, and a pagination helper.
+ */
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TalqingClient = exports.TalqingApiError = void 0;
+exports.paginate = paginate;
+const index_js_1 = require("./gen/index.js");
+const index_js_2 = require("./gen/client/index.js");
+/* This package publishes an ESM build and a CommonJS build, and an application
+ * whose dependency graph reaches both gets two distinct copies of the class
+ * below. `instanceof` compares class identity, so an error thrown by one copy
+ * would fall straight through `catch (e) { if (e instanceof TalqingApiError) }`
+ * against the other — the exact pattern the README tells callers to write, and a
+ * silent one, because the error just keeps propagating.
+ *
+ * A key from the global symbol registry is the one thing both copies agree on.
+ * `Symbol.hasInstance` below makes `instanceof` ask for the brand instead of the
+ * prototype, so the check holds no matter which copy raised it. */
+const TALQING_API_ERROR = Symbol.for("talqing.TalqingApiError");
+/** Every error this API returns, in the one shape it returns them in. */
+class TalqingApiError extends Error {
+    static [(_a = TALQING_API_ERROR, Symbol.hasInstance)](value) {
+        return typeof value === "object" && value !== null && TALQING_API_ERROR in value;
+    }
+    constructor(body, response) {
+        super(body.detail.message);
+        this.name = "TalqingApiError";
+        this[_a] = true;
+        this.status = response.status;
+        this.errors = body.detail.errors;
+        this.response = response;
+    }
+}
+exports.TalqingApiError = TalqingApiError;
+class TalqingClientImpl extends index_js_1.TalqingApi {
+    constructor(options) {
+        // Types do not reach a JavaScript caller, or a value that is `string` but empty.
+        if (!options?.baseUrl?.trim()) {
+            throw new Error("TalqingClient requires a baseUrl (e.g. https://api.in.talqing.com)");
+        }
+        const baseUrl = options.baseUrl.replace(/\/+$/, "");
+        const http = (0, index_js_2.createClient)((0, index_js_2.createConfig)({
+            baseUrl,
+            throwOnError: true,
+            responseStyle: "data",
+            credentials: options.credentials,
+            headers: options.headers,
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+            ...(options.token ? { auth: () => resolveToken(options.token) } : {}),
+        }));
+        // The transport throws the parsed error body — a plain object with no
+        // status and no stack. Replacing it here is what makes `catch (e)` see a
+        // real Error everywhere, including inside the generated methods.
+        http.interceptors.error.use((error, response) => {
+            // No response means the request never completed — a DNS failure, an
+            // abort, an offline tab. There is no status to carry, so the transport's
+            // own error is already the truthful one.
+            if (!response)
+                return error;
+            const failure = new TalqingApiError(error, response);
+            if (failure.status === 401)
+                options.onUnauthorized?.(failure);
+            return failure;
+        });
+        super({ client: http });
+        this.baseUrl = baseUrl;
+        this.http = http;
+    }
+    googleLoginUrl() {
+        return `${this.baseUrl}/v1/auth/google/start`;
+    }
+    oauthStartUrl(provider, integrationId) {
+        const url = new URL(`${this.baseUrl}/v1/integrations/oauth/${encodeURIComponent(provider)}/start`);
+        if (integrationId)
+            url.searchParams.set("integration_id", integrationId);
+        return url.toString();
+    }
+}
+/* `Throwing` is a type-level narrowing of the same object — the runtime value
+ * is the generated class, unchanged — so the constructor is re-typed rather
+ * than the 155 methods being re-declared. */
+exports.TalqingClient = TalqingClientImpl;
+async function resolveToken(token) {
+    const value = typeof token === "function" ? await token() : token;
+    return value ?? undefined;
+}
+/**
+ * Walk every page of a list endpoint.
+ *
+ *     for await (const agent of paginate((q) => talqing.agents.list(q))) { … }
+ *
+ * Replaces the one-off `listAllAgents` the previous client carried: the page
+ * shape is the same on all 28 list endpoints, so the helper is too.
+ */
+async function* paginate(page, { limit = 200 } = {}) {
+    for (let offset = 0;; offset += limit) {
+        const result = await page({ limit, offset });
+        yield* result.items;
+        if (!result.has_more)
+            return;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/gen/apiVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiVersion.d.ts","sourceRoot":"","sources":["../../../src/gen/apiVersion.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,eAAO,MAAM,WAAW,UAAU,CAAC"}