@bitbaum/chatkit 0.17.0 → 0.18.0

package/dist/react/use-chat-app.js

@@ -0,0 +1,380 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+import { deriveTitle, newId, pickRestored, } from "../conversations.js";
+const TEMP = "tmp";
+export const isTemporaryId = (id) => !!id && id.startsWith(`${TEMP}-`);
+function messageAttachments(list) {
+    if (list.length === 0)
+        return undefined;
+    return list.map((a) => a.kind === "image"
+        ? { kind: "image", name: a.name, previewUrl: `data:${a.mimeType};base64,${a.dataBase64}` }
+        : { kind: "text", name: a.name });
+}
+function readRemembered(key) {
+    if (!key)
+        return null;
+    try {
+        return globalThis.localStorage?.getItem(key) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeRemembered(key, id) {
+    if (!key)
+        return;
+    try {
+        if (id)
+            globalThis.localStorage?.setItem(key, id);
+        else
+            globalThis.localStorage?.removeItem(key);
+    }
+    catch {
+        /* private mode: the chat simply does not reopen after a reload */
+    }
+}
+/**
+ * Everything ChatApp does that is not drawing: the list, the open chat, new
+ * and temporary chats, turns (one per conversation, each running on when the
+ * person opens another chat), the queue, titles and the reopen-on-reload.
+ */
+export function useChatApp({ store, transport, makeTitle, conversationId, onConversationChange, rememberKey, }) {
+    const [list, setList] = useState([]);
+    const [listState, setListState] = useState("loading");
+    const [activeId, setActiveId] = useState(null);
+    const [temporary, setTemporary] = useState(false);
+    const [threads, setThreads] = useState({});
+    const [loadingId, setLoadingId] = useState(null);
+    const [live, setLive] = useState({});
+    const [stopped, setStopped] = useState({});
+    const [queue, setQueue] = useState([]);
+    const [problem, setProblem] = useState(null);
+    const [reload, setReload] = useState(0);
+    // Async work reads the CURRENT state through these, never a stale closure.
+    const threadsRef = useRef(threads);
+    const queueRef = useRef(queue);
+    const activeRef = useRef(activeId);
+    const temporaryRef = useRef(temporary);
+    const controllers = useRef(new Map());
+    const restored = useRef(false);
+    const transportRef = useRef(transport);
+    const titleRef = useRef(makeTitle);
+    useEffect(() => {
+        transportRef.current = transport;
+        titleRef.current = makeTitle;
+    });
+    const setThreadsNow = (fn) => {
+        threadsRef.current = fn(threadsRef.current);
+        setThreads(threadsRef.current);
+    };
+    const setQueueNow = (fn) => {
+        queueRef.current = fn(queueRef.current);
+        setQueue(queueRef.current);
+    };
+    const select = (id, temp) => {
+        activeRef.current = id;
+        temporaryRef.current = temp;
+        setActiveId(id);
+        setTemporary(temp);
+    };
+    /** Leaving a temporary chat ends it: its turn stops, its words are gone. */
+    const leaveTemporary = () => {
+        const id = activeRef.current;
+        if (!isTemporaryId(id))
+            return;
+        controllers.current.get(id)?.abort();
+        setThreadsNow((t) => {
+            const next = { ...t };
+            delete next[id];
+            return next;
+        });
+        setQueueNow((q) => q.filter((item) => item.conversation !== id));
+    };
+    const open = (id) => {
+        if (id === activeRef.current)
+            return;
+        leaveTemporary();
+        select(id, false);
+        if (threadsRef.current[id])
+            return;
+        setLoadingId(id);
+        store
+            .get(id)
+            .then((c) => {
+            if (c) {
+                setThreadsNow((t) => ({ ...t, [id]: c.messages }));
+            }
+            else {
+                // Deleted elsewhere: drop the row and land on a new chat.
+                setList((l) => l.filter((row) => row.id !== id));
+                if (activeRef.current === id)
+                    select(null, false);
+            }
+        })
+            .catch(() => setProblem("open"))
+            .finally(() => setLoadingId((cur) => (cur === id ? null : cur)));
+    };
+    // The list, and on the first load the chat that was open before the reload.
+    useEffect(() => {
+        let alive = true;
+        setListState("loading");
+        store
+            .list()
+            .then((rows) => {
+            if (!alive)
+                return;
+            setList(rows);
+            setListState("ready");
+            if (!restored.current) {
+                restored.current = true;
+                const id = pickRestored(rows, conversationId, readRemembered(rememberKey));
+                if (id)
+                    open(id);
+            }
+        })
+            .catch(() => {
+            if (!alive)
+                return;
+            restored.current = true;
+            setListState("error");
+        });
+        return () => {
+            alive = false;
+        };
+        // `open` and the ids are read once, at load; a store change reloads.
+    }, [store, reload]);
+    // A product that keeps the open chat in its URL drives it from there.
+    useEffect(() => {
+        if (conversationId === undefined || !restored.current)
+            return;
+        if (conversationId === null) {
+            if (activeRef.current && !isTemporaryId(activeRef.current))
+                select(null, false);
+        }
+        else if (conversationId !== activeRef.current)
+            open(conversationId);
+    }, [conversationId]);
+    // Remember the open chat (never a temporary one) and tell the product.
+    const stored = isTemporaryId(activeId) ? null : activeId;
+    useEffect(() => {
+        if (!restored.current)
+            return;
+        writeRemembered(rememberKey, stored);
+        onConversationChange?.(stored);
+    }, [stored]);
+    const save = (id, message) => {
+        if (isTemporaryId(id))
+            return;
+        store.append(id, message).catch(() => setProblem("save"));
+        const at = new Date().toISOString();
+        setList((l) => {
+            const row = l.find((c) => c.id === id);
+            return row ? [{ ...row, updatedAt: at }, ...l.filter((c) => c.id !== id)] : l;
+        });
+    };
+    const push = (id, message) => setThreadsNow((t) => ({ ...t, [id]: [...(t[id] ?? []), message] }));
+    const runTurn = async (id, text, attachments, history) => {
+        const temp = isTemporaryId(id);
+        const controller = new AbortController();
+        controllers.current.set(id, controller);
+        setStopped((s) => ({ ...s, [id]: false }));
+        setLive((l) => ({ ...l, [id]: {} }));
+        let soFar = {};
+        let ok = false;
+        try {
+            const result = await transportRef.current({
+                conversationId: temp ? null : id,
+                temporary: temp,
+                text,
+                attachments,
+                history,
+                signal: controller.signal,
+                update: (next) => {
+                    soFar = { ...soFar, ...next };
+                    if (!controller.signal.aborted)
+                        setLive((l) => (id in l ? { ...l, [id]: soFar } : l));
+                },
+            });
+            if (controller.signal.aborted)
+                throw new DOMException("stopped", "AbortError");
+            const answer = typeof result === "string" ? { content: result } : result;
+            const message = { ...answer, id: newId("m"), role: "assistant" };
+            push(id, message);
+            save(id, message);
+            ok = true;
+            if (!temp && history.length === 0 && titleRef.current) {
+                void Promise.resolve(titleRef.current({ text, answer: answer.content }))
+                    .then((title) => (title?.trim() ? rename(id, title.trim()) : undefined))
+                    .catch(() => {
+                    /* the derived title stays */
+                });
+            }
+        }
+        catch {
+            if (controller.signal.aborted) {
+                // Stopped: what had arrived is kept, as the apps keep a half answer.
+                if (soFar.text?.trim()) {
+                    const message = {
+                        id: newId("m"),
+                        role: "assistant",
+                        content: soFar.text,
+                    };
+                    push(id, message);
+                    save(id, message);
+                }
+                else
+                    setStopped((s) => ({ ...s, [id]: true }));
+            }
+            else {
+                push(id, { id: newId("m"), role: "assistant", content: "", failed: true });
+            }
+        }
+        finally {
+            controllers.current.delete(id);
+            setLive((l) => {
+                const next = { ...l };
+                delete next[id];
+                return next;
+            });
+        }
+        // The next queued message goes once a turn lands; a failed or stopped
+        // turn leaves the queue standing behind it, to be sent or removed.
+        if (ok) {
+            const next = queueRef.current.find((q) => q.conversation === id);
+            if (next) {
+                setQueueNow((q) => q.filter((item) => item.id !== next.id));
+                void sendIn(id, next.text, next.attachments);
+            }
+        }
+    };
+    const sendIn = async (id, text, attachments) => {
+        const history = (threadsRef.current[id] ?? []).filter((m) => !m.failed);
+        const message = {
+            id: newId("m"),
+            role: "user",
+            content: text,
+            ...(attachments.length ? { attachments: messageAttachments(attachments) } : {}),
+        };
+        push(id, message);
+        save(id, message);
+        await runTurn(id, text, attachments, history);
+    };
+    /** Composer's onSend. Resolves false to keep the draft (nothing was sent). */
+    const send = async (text, attachments = []) => {
+        let id = activeRef.current;
+        if (id && controllers.current.has(id)) {
+            setQueueNow((q) => [...q, { id: newId("q"), conversation: id, text, attachments }]);
+            return true;
+        }
+        if (!id) {
+            if (temporaryRef.current) {
+                id = newId(TEMP);
+            }
+            else {
+                try {
+                    const created = await store.create({ title: deriveTitle(text) ?? "" });
+                    id = created.id;
+                    setList((l) => [created, ...l.filter((c) => c.id !== created.id)]);
+                }
+                catch {
+                    setProblem("save");
+                    return false;
+                }
+            }
+            setThreadsNow((t) => ({ ...t, [id]: [] }));
+            select(id, temporaryRef.current);
+        }
+        void sendIn(id, text, attachments);
+        return true;
+    };
+    const stop = () => {
+        const id = activeRef.current;
+        if (id)
+            controllers.current.get(id)?.abort();
+    };
+    /** Retry after a failed or stopped turn: the last message goes again. */
+    const retry = () => {
+        const id = activeRef.current;
+        if (!id || controllers.current.has(id))
+            return;
+        const thread = threadsRef.current[id] ?? [];
+        const kept = thread.filter((m) => !m.failed);
+        const lastUser = [...kept].reverse().find((m) => m.role === "user");
+        if (!lastUser)
+            return;
+        setThreadsNow((t) => ({ ...t, [id]: kept }));
+        const history = kept.slice(0, kept.indexOf(lastUser));
+        void runTurn(id, lastUser.content, [], history);
+    };
+    const newChat = () => {
+        leaveTemporary();
+        select(null, false);
+    };
+    /** In an empty new chat, switch it to temporary and back; in a chat with
+     *  words in it, start a new temporary one. */
+    const toggleTemporary = () => {
+        const id = activeRef.current;
+        if (!id) {
+            select(null, !temporaryRef.current);
+            return;
+        }
+        leaveTemporary();
+        select(null, !isTemporaryId(id));
+    };
+    const rename = async (id, title) => {
+        setList((l) => l.map((c) => (c.id === id ? { ...c, title } : c)));
+        try {
+            await store.rename(id, title);
+        }
+        catch {
+            setProblem("save");
+        }
+    };
+    const remove = async (id) => {
+        controllers.current.get(id)?.abort();
+        setList((l) => l.filter((c) => c.id !== id));
+        setThreadsNow((t) => {
+            const next = { ...t };
+            delete next[id];
+            return next;
+        });
+        setQueueNow((q) => q.filter((item) => item.conversation !== id));
+        if (activeRef.current === id)
+            select(null, false);
+        try {
+            await store.remove(id);
+        }
+        catch {
+            setProblem("save");
+            setReload((n) => n + 1);
+        }
+    };
+    const key = activeId ?? "";
+    return {
+        list,
+        listState,
+        reloadList: () => setReload((n) => n + 1),
+        activeId,
+        stored,
+        temporary,
+        messages: threads[key] ?? [],
+        loading: loadingId !== null && loadingId === activeId,
+        live: live[key] ?? null,
+        busy: key in live,
+        busyIds: new Set(Object.keys(live)),
+        stopped: !!stopped[key],
+        queued: queue.filter((q) => q.conversation === activeId),
+        unqueue: (qid) => setQueueNow((q) => q.filter((item) => item.id !== qid)),
+        problem,
+        clearProblem: () => setProblem(null),
+        send,
+        stop,
+        retry,
+        open,
+        newChat,
+        toggleTemporary,
+        rename,
+        remove,
+    };
+}
+//# sourceMappingURL=use-chat-app.js.map

package/dist/react/use-chat-app.js.map

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

package/dist/stores.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Where a ChatApp keeps its conversations. Storage is an ADAPTER: the screen
+ * reads and writes through `ConversationStore` and never knows whether the
+ * chats are on the device or on a server. Two reference adapters:
+ *
+ *   localConversationStore({ key })     the device — signed-out chats
+ *   httpConversationStore({ baseUrl })  the product's server — signed-in chats
+ */
+import { type ConversationStore } from "./conversations.js";
+type KeyValue = Pick<Storage, "getItem" | "setItem" | "removeItem">;
+/** Bumped when the stored shape changes; an older shape is read as empty
+ *  rather than misread. */
+export declare const LOCAL_STORE_VERSION = 1;
+/** A store in memory: a temporary chat, a test, a page with no storage. */
+export declare function memoryConversationStore(): ConversationStore;
+/**
+ * Conversations on the device. Never throws: storage that is missing, full,
+ * blocked or holding something unreadable degrades to memory for this page,
+ * so the chat still works and simply is not there after a reload.
+ *
+ * Layout (versioned): `<key>:v1` holds the list, `<key>:v1:<id>` each chat's
+ * messages — so one long chat can be evicted without losing the others. When
+ * the quota is reached the OLDEST chats are dropped until the write fits.
+ */
+export declare function localConversationStore({ key, storage, limit, }?: {
+    /** Namespace on the device. One per product (and per signed-out person, if
+     *  the device is shared and the product can tell them apart). */
+    key?: string;
+    /** Defaults to localStorage. `null` keeps everything in memory. */
+    storage?: KeyValue | null;
+    /** Most chats kept; the oldest go first. */
+    limit?: number;
+}): ConversationStore;
+export type HttpConversationStoreOptions = {
+    /** The collection, e.g. "/api/conversations". */
+    baseUrl: string;
+    /** Headers on every request (an auth token), or a function returning them. */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** Defaults to the global fetch. */
+    fetch?: typeof fetch;
+    /**
+     * The product's own chat route already writes every turn (Heidi's
+     * `/messages`, Loki's `/api/loki`): then `append` sends nothing, so a turn
+     * is never stored twice.
+     */
+    serverWritesTurns?: boolean;
+};
+/**
+ * Conversations on the product's server, over this REST shape (Heidi's
+ * `/api/conversations`, generalised):
+ *
+ *   GET    {base}                 → { conversations: [{ id, title, updatedAt }] }
+ *   POST   {base}       { title } → { conversation: { id, title, updatedAt } }
+ *   GET    {base}/{id}            → { conversation, messages: [...] }   404 = gone
+ *   POST   {base}/{id}/messages { message } → 2xx
+ *   PATCH  {base}/{id}  { title } → 2xx
+ *   DELETE {base}/{id}            → 2xx
+ *
+ * A failed request throws an Error naming the call; ChatApp shows it in words.
+ */
+export declare function httpConversationStore({ baseUrl, headers, fetch: fetchImpl, serverWritesTurns, }: HttpConversationStoreOptions): ConversationStore;
+export {};
+//# sourceMappingURL=stores.d.ts.map

package/dist/stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../src/stores.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,KAAK,iBAAiB,EAGvB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;AAEpE;2BAC2B;AAC3B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,2EAA2E;AAC3E,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,GAAe,EACf,OAAO,EACP,KAAW,GACZ,GAAE;IACD;qEACiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,iBAAiB,CAkJzB;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,OAAO,EACP,KAAK,EAAE,SAAS,EAChB,iBAAyB,GAC1B,EAAE,4BAA4B,GAAG,iBAAiB,CA0ElD"}