@athenaintel/react 0.22.4 → 0.23.0

package/dist/threads/use-thread-favorite.d.ts

@@ -0,0 +1,49 @@
+import type { RestConversationAuth } from './use-rest-conversation-history';
+import { resetThreadFieldUnavailableWarnings } from './use-thread-field-override';
+export interface ThreadFavoriteTarget {
+    threadId: string;
+    isFavorited: boolean;
+}
+/** The two fields the override layer reads and writes on a list row. */
+export interface FavoriteRow {
+    threadId: string;
+    isFavorited?: boolean;
+}
+export interface UseThreadFavoriteOptions {
+    backendUrl: string;
+    /** Non-secret identity in the mutation key (as the read-state mutation keys). */
+    principalId: string;
+    getAuth: () => RestConversationAuth | Promise<RestConversationAuth>;
+    /**
+     * The rows as the list sources currently report them, BEFORE overrides. An
+     * override is dropped once its row reports the same value.
+     */
+    rows: readonly FavoriteRow[];
+    /** Write the server's answer into the list caches (`patchConversation`). */
+    onServerTruth?: (result: ThreadFavoriteTarget) => void;
+}
+export interface ThreadFavoriteToggle {
+    /** Optimistic, then server-confirmed, values layered over the list sources, keyed by thread id. */
+    overrides: Readonly<Record<string, boolean>>;
+    /**
+     * Pin or unpin a thread. Flips the row at once; while that thread's write
+     * is in flight the call only records the desired value (see module doc).
+     */
+    setFavorited: (target: ThreadFavoriteTarget) => void;
+    /** True while any toggle is in flight. */
+    isPending: boolean;
+    /** The threads whose toggle is in flight — a pin control disables itself for these. */
+    pendingThreadIds: ReadonlySet<string>;
+    /**
+     * `false` once the backend answered 404 / 405: the route is not deployed
+     * there, and the UI shows the read-only pin instead of a toggle.
+     */
+    isAvailable: boolean;
+}
+/** Test seam: forget which backends were warned about (shared with the other field writes). */
+export declare const resetThreadFavoriteUnavailableWarnings: typeof resetThreadFieldUnavailableWarnings;
+export declare function useThreadFavorite({ backendUrl, principalId, getAuth, rows, onServerTruth, }: UseThreadFavoriteOptions): ThreadFavoriteToggle;
+/** The row with its override applied, or the row itself when it has none. */
+export declare function withFavoriteOverride<T extends FavoriteRow>(row: T, overrides: Readonly<Record<string, boolean>>): T;
+/** Every row with its override applied. */
+export declare function withFavoriteOverrides<T extends FavoriteRow>(rows: readonly T[], overrides: Readonly<Record<string, boolean>>): T[];

package/dist/threads/use-thread-favorite.js

@@ -0,0 +1,53 @@
+import { useCallback } from "react";
+import { setThreadFavorite, isThreadFavoriteUnavailableError } from "./api.js";
+import { useThreadFieldOverride } from "./use-thread-field-override.js";
+const FAVORITE_UNAVAILABLE_WARNING = "[AthenaSDK] This backend has no POST /api/conversations/threads/favorite route yet; session pins stay read-only until it deploys.";
+const readFavorite = (row) => row.isFavorited ?? false;
+function useThreadFavorite({
+  backendUrl,
+  principalId,
+  getAuth,
+  rows,
+  onServerTruth
+}) {
+  const field = useThreadFieldOverride({
+    field: "favorite",
+    backendUrl,
+    principalId,
+    getAuth,
+    rows,
+    readRow: readFavorite,
+    write: async (auth, { threadId, value }) => {
+      const result = await setThreadFavorite(backendUrl, auth, { threadId, isFavorited: value });
+      return { threadId: result.thread_id, value: result.is_favorited };
+    },
+    isUnavailableError: isThreadFavoriteUnavailableError,
+    unavailableWarning: FAVORITE_UNAVAILABLE_WARNING,
+    onServerTruth: onServerTruth ? ({ threadId, value }) => onServerTruth({ threadId, isFavorited: value }) : void 0
+  });
+  const set = field.set;
+  const setFavorited = useCallback(
+    ({ threadId, isFavorited }) => set({ threadId, value: isFavorited }),
+    [set]
+  );
+  return {
+    overrides: field.overrides,
+    setFavorited,
+    isPending: field.isPending,
+    pendingThreadIds: field.pendingThreadIds,
+    isAvailable: field.isAvailable
+  };
+}
+function withFavoriteOverride(row, overrides) {
+  const override = overrides[row.threadId];
+  return override === void 0 || override === row.isFavorited ? row : { ...row, isFavorited: override };
+}
+function withFavoriteOverrides(rows, overrides) {
+  return rows.map((row) => withFavoriteOverride(row, overrides));
+}
+export {
+  useThreadFavorite,
+  withFavoriteOverride,
+  withFavoriteOverrides
+};
+//# sourceMappingURL=use-thread-favorite.js.map

package/dist/threads/use-thread-favorite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-thread-favorite.js","sources":["../../src/threads/use-thread-favorite.ts"],"sourcesContent":["/**\n * The pin toggle behind `SessionList` and the conversation-history hooks:\n * `useThreadFieldOverride` over `POST /api/conversations/threads/favorite`\n * (see that module for the optimistic-override, rollback, serialization and\n * identity-scoping contract). A 404 / 405 marks the toggle unavailable — the\n * backend predates the route — so the UI falls back to the read-only pin\n * instead of failing on every click.\n */\nimport { useCallback } from 'react';\nimport { isThreadFavoriteUnavailableError, setThreadFavorite } from './api';\nimport type { RestConversationAuth } from './use-rest-conversation-history';\nimport {\n  resetThreadFieldUnavailableWarnings,\n  type ThreadFieldTarget,\n  useThreadFieldOverride,\n} from './use-thread-field-override';\n\nexport interface ThreadFavoriteTarget {\n  threadId: string;\n  isFavorited: boolean;\n}\n\n/** The two fields the override layer reads and writes on a list row. */\nexport interface FavoriteRow {\n  threadId: string;\n  isFavorited?: boolean;\n}\n\nexport interface UseThreadFavoriteOptions {\n  backendUrl: string;\n  /** Non-secret identity in the mutation key (as the read-state mutation keys). */\n  principalId: string;\n  getAuth: () => RestConversationAuth | Promise<RestConversationAuth>;\n  /**\n   * The rows as the list sources currently report them, BEFORE overrides. An\n   * override is dropped once its row reports the same value.\n   */\n  rows: readonly FavoriteRow[];\n  /** Write the server's answer into the list caches (`patchConversation`). */\n  onServerTruth?: (result: ThreadFavoriteTarget) => void;\n}\n\nexport interface ThreadFavoriteToggle {\n  /** Optimistic, then server-confirmed, values layered over the list sources, keyed by thread id. */\n  overrides: Readonly<Record<string, boolean>>;\n  /**\n   * Pin or unpin a thread. Flips the row at once; while that thread's write\n   * is in flight the call only records the desired value (see module doc).\n   */\n  setFavorited: (target: ThreadFavoriteTarget) => void;\n  /** True while any toggle is in flight. */\n  isPending: boolean;\n  /** The threads whose toggle is in flight — a pin control disables itself for these. */\n  pendingThreadIds: ReadonlySet<string>;\n  /**\n   * `false` once the backend answered 404 / 405: the route is not deployed\n   * there, and the UI shows the read-only pin instead of a toggle.\n   */\n  isAvailable: boolean;\n}\n\n/** Test seam: forget which backends were warned about (shared with the other field writes). */\nexport const resetThreadFavoriteUnavailableWarnings = resetThreadFieldUnavailableWarnings;\n\nconst FAVORITE_UNAVAILABLE_WARNING =\n  '[AthenaSDK] This backend has no POST /api/conversations/threads/favorite route yet; session pins stay read-only until it deploys.';\n\nconst readFavorite = (row: FavoriteRow): boolean => row.isFavorited ?? false;\n\nexport function useThreadFavorite({\n  backendUrl,\n  principalId,\n  getAuth,\n  rows,\n  onServerTruth,\n}: UseThreadFavoriteOptions): ThreadFavoriteToggle {\n  const field = useThreadFieldOverride<boolean, FavoriteRow>({\n    field: 'favorite',\n    backendUrl,\n    principalId,\n    getAuth,\n    rows,\n    readRow: readFavorite,\n    write: async (auth, { threadId, value }) => {\n      const result = await setThreadFavorite(backendUrl, auth, { threadId, isFavorited: value });\n      return { threadId: result.thread_id, value: result.is_favorited };\n    },\n    isUnavailableError: isThreadFavoriteUnavailableError,\n    unavailableWarning: FAVORITE_UNAVAILABLE_WARNING,\n    onServerTruth: onServerTruth\n      ? ({ threadId, value }: ThreadFieldTarget<boolean>) =>\n          onServerTruth({ threadId, isFavorited: value })\n      : undefined,\n  });\n  const set = field.set;\n  const setFavorited = useCallback(\n    ({ threadId, isFavorited }: ThreadFavoriteTarget) => set({ threadId, value: isFavorited }),\n    [set],\n  );\n  return {\n    overrides: field.overrides,\n    setFavorited,\n    isPending: field.isPending,\n    pendingThreadIds: field.pendingThreadIds,\n    isAvailable: field.isAvailable,\n  };\n}\n\n/** The row with its override applied, or the row itself when it has none. */\nexport function withFavoriteOverride<T extends FavoriteRow>(\n  row: T,\n  overrides: Readonly<Record<string, boolean>>,\n): T {\n  const override = overrides[row.threadId];\n  return override === undefined || override === row.isFavorited\n    ? row\n    : { ...row, isFavorited: override };\n}\n\n/** Every row with its override applied. */\nexport function withFavoriteOverrides<T extends FavoriteRow>(\n  rows: readonly T[],\n  overrides: Readonly<Record<string, boolean>>,\n): T[] {\n  return rows.map((row) => withFavoriteOverride(row, overrides));\n}\n"],"names":[],"mappings":";;;AAgEA,MAAM,+BACJ;AAEF,MAAM,eAAe,CAAC,QAA8B,IAAI,eAAe;AAEhE,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAmD;AACjD,QAAM,QAAQ,uBAA6C;AAAA,IACzD,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,OAAO,OAAO,MAAM,EAAE,UAAU,YAAY;AAC1C,YAAM,SAAS,MAAM,kBAAkB,YAAY,MAAM,EAAE,UAAU,aAAa,OAAO;AACzF,aAAO,EAAE,UAAU,OAAO,WAAW,OAAO,OAAO,aAAA;AAAA,IACrD;AAAA,IACA,oBAAoB;AAAA,IACpB,oBAAoB;AAAA,IACpB,eAAe,gBACX,CAAC,EAAE,UAAU,MAAA,MACX,cAAc,EAAE,UAAU,aAAa,MAAA,CAAO,IAChD;AAAA,EAAA,CACL;AACD,QAAM,MAAM,MAAM;AAClB,QAAM,eAAe;AAAA,IACnB,CAAC,EAAE,UAAU,kBAAwC,IAAI,EAAE,UAAU,OAAO,aAAa;AAAA,IACzF,CAAC,GAAG;AAAA,EAAA;AAEN,SAAO;AAAA,IACL,WAAW,MAAM;AAAA,IACjB;AAAA,IACA,WAAW,MAAM;AAAA,IACjB,kBAAkB,MAAM;AAAA,IACxB,aAAa,MAAM;AAAA,EAAA;AAEvB;AAGO,SAAS,qBACd,KACA,WACG;AACH,QAAM,WAAW,UAAU,IAAI,QAAQ;AACvC,SAAO,aAAa,UAAa,aAAa,IAAI,cAC9C,MACA,EAAE,GAAG,KAAK,aAAa,SAAA;AAC7B;AAGO,SAAS,sBACd,MACA,WACK;AACL,SAAO,KAAK,IAAI,CAAC,QAAQ,qBAAqB,KAAK,SAAS,CAAC;AAC/D;"}

package/dist/threads/use-thread-field-override.cjs

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactQuery = require("@tanstack/react-query");
+const react = require("react");
+const EMPTY_PENDING = /* @__PURE__ */ new Set();
+function fieldScope(backendUrl, principalId) {
+  return `${backendUrl}::${principalId}`;
+}
+function withPending(pending, threadId, isPending) {
+  if (pending.has(threadId) === isPending) return pending;
+  const next = new Set(pending);
+  if (isPending) next.add(threadId);
+  else next.delete(threadId);
+  return next;
+}
+const strictEquals = (a, b) => a === b;
+const warnedUnavailableBackends = /* @__PURE__ */ new Set();
+function useThreadFieldOverride({
+  field,
+  backendUrl,
+  principalId,
+  getAuth,
+  rows,
+  readRow,
+  write,
+  isUnavailableError,
+  unavailableWarning,
+  onServerTruth,
+  equals = strictEquals
+}) {
+  const scope = fieldScope(backendUrl, principalId);
+  const [state, setState] = react.useState(() => ({
+    scope,
+    overrides: {},
+    pending: EMPTY_PENDING
+  }));
+  if (state.scope !== scope) {
+    setState({ scope, overrides: {}, pending: EMPTY_PENDING });
+  }
+  const emptyOverridesRef = react.useRef(Object.freeze({}));
+  const overrides = state.scope === scope ? state.overrides : emptyOverridesRef.current;
+  const pendingThreadIds = state.scope === scope ? state.pending : EMPTY_PENDING;
+  const [unavailableBackend, setUnavailableBackend] = react.useState(null);
+  const scopeRef = react.useRef(scope);
+  scopeRef.current = scope;
+  const overridesRef = react.useRef(overrides);
+  overridesRef.current = overrides;
+  const readRowRef = react.useRef(readRow);
+  readRowRef.current = readRow;
+  const writeRef = react.useRef(write);
+  writeRef.current = write;
+  const isUnavailableErrorRef = react.useRef(isUnavailableError);
+  isUnavailableErrorRef.current = isUnavailableError;
+  const unavailableWarningRef = react.useRef(unavailableWarning);
+  unavailableWarningRef.current = unavailableWarning;
+  const onServerTruthRef = react.useRef(onServerTruth);
+  onServerTruthRef.current = onServerTruth;
+  const equalsRef = react.useRef(equals);
+  equalsRef.current = equals;
+  const inFlightRef = react.useRef(/* @__PURE__ */ new Map());
+  const queuedRef = react.useRef(/* @__PURE__ */ new Map());
+  const seqRef = react.useRef(0);
+  const bookkeepingScopeRef = react.useRef(scope);
+  if (bookkeepingScopeRef.current !== scope) {
+    bookkeepingScopeRef.current = scope;
+    inFlightRef.current = /* @__PURE__ */ new Map();
+    queuedRef.current = /* @__PURE__ */ new Map();
+  }
+  const update = react.useCallback(
+    (forScope, patch) => {
+      setState((current) => {
+        const base = current.scope === forScope ? current : { scope: forScope, overrides: {}, pending: EMPTY_PENDING };
+        const next = patch(base);
+        return next === base && current.scope === forScope ? current : next;
+      });
+    },
+    []
+  );
+  react.useEffect(() => {
+    const caughtUp = Object.keys(overrides).filter((threadId) => {
+      if (pendingThreadIds.has(threadId)) return false;
+      const row = rows.find((candidate) => candidate.threadId === threadId);
+      if (row === void 0) return false;
+      const reported = readRowRef.current(row);
+      const override = overrides[threadId];
+      return reported !== void 0 && override !== void 0 && equalsRef.current(reported, override);
+    });
+    if (caughtUp.length === 0) return;
+    update(scope, (current) => {
+      const next = { ...current.overrides };
+      for (const threadId of caughtUp) delete next[threadId];
+      return { ...current, overrides: next };
+    });
+  }, [overrides, pendingThreadIds, rows, scope, update]);
+  const mutation = reactQuery.useMutation({
+    mutationKey: ["conversation-history", field, backendUrl, principalId],
+    mutationFn: async ({ threadId, value }) => writeRef.current(await getAuth(), { threadId, value }),
+    onError: (error, write2) => {
+      if (isUnavailableErrorRef.current(error)) {
+        setUnavailableBackend(backendUrl);
+        const warnKey = `${field}::${backendUrl}`;
+        if (!warnedUnavailableBackends.has(warnKey)) {
+          warnedUnavailableBackends.add(warnKey);
+          console.warn(unavailableWarningRef.current);
+        }
+      }
+      if (!isCurrentWrite(write2)) return;
+      inFlightRef.current.delete(write2.threadId);
+      queuedRef.current.delete(write2.threadId);
+      update(write2.scope, (current) => {
+        const overridesNext = { ...current.overrides };
+        if (write2.previous === void 0) delete overridesNext[write2.threadId];
+        else overridesNext[write2.threadId] = write2.previous;
+        return {
+          ...current,
+          overrides: overridesNext,
+          pending: withPending(current.pending, write2.threadId, false)
+        };
+      });
+    },
+    onSuccess: (truth, write2) => {
+      var _a;
+      if (!isCurrentWrite(write2)) return;
+      inFlightRef.current.delete(write2.threadId);
+      const queued = queuedRef.current.get(write2.threadId);
+      const hadQueued = queuedRef.current.has(write2.threadId);
+      queuedRef.current.delete(write2.threadId);
+      (_a = onServerTruthRef.current) == null ? void 0 : _a.call(onServerTruthRef, truth);
+      if (hadQueued && queued !== void 0 && !equalsRef.current(queued, truth.value)) {
+        startWrite(write2.scope, {
+          threadId: write2.threadId,
+          value: queued,
+          previous: truth.value
+        });
+        return;
+      }
+      update(write2.scope, (current) => ({
+        ...current,
+        overrides: { ...current.overrides, [truth.threadId]: truth.value },
+        pending: withPending(current.pending, truth.threadId, false)
+      }));
+    }
+  });
+  const mutate = mutation.mutate;
+  function isCurrentWrite(write2) {
+    return scopeRef.current === write2.scope && inFlightRef.current.get(write2.threadId) === write2.seq;
+  }
+  function startWrite(forScope, write2) {
+    const seq = ++seqRef.current;
+    inFlightRef.current.set(write2.threadId, seq);
+    update(forScope, (current) => ({
+      ...current,
+      pending: withPending(current.pending, write2.threadId, true)
+    }));
+    mutate({ ...write2, scope: forScope, seq });
+  }
+  const startWriteRef = react.useRef(startWrite);
+  startWriteRef.current = startWrite;
+  const set = react.useCallback(
+    ({ threadId, value }) => {
+      const forScope = scopeRef.current;
+      const previous = overridesRef.current[threadId];
+      update(forScope, (current) => ({
+        ...current,
+        overrides: { ...current.overrides, [threadId]: value }
+      }));
+      if (inFlightRef.current.has(threadId)) {
+        queuedRef.current.set(threadId, value);
+        return;
+      }
+      startWriteRef.current(forScope, { threadId, value, previous });
+    },
+    [update]
+  );
+  return {
+    overrides,
+    set,
+    isPending: pendingThreadIds.size > 0,
+    pendingThreadIds,
+    isAvailable: unavailableBackend !== backendUrl
+  };
+}
+exports.useThreadFieldOverride = useThreadFieldOverride;
+//# sourceMappingURL=use-thread-field-override.cjs.map

package/dist/threads/use-thread-field-override.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-thread-field-override.cjs","sources":["../../src/threads/use-thread-field-override.ts"],"sourcesContent":["/**\n * The optimistic per-thread field write behind the pin (`useThreadFavorite`)\n * and the rename (`useThreadRename`): one TanStack mutation over a REST\n * route with an override map layered over the list rows.\n *\n * Why overrides rather than a cache patch alone: a row's field is folded from\n * two sources — the fetched page and the pushed conversation index — and a\n * push that predates the write would clobber a patched page. The override\n * sits over both until the sources report the same value, then drops away so\n * they own the field again (a later write from another client is never\n * masked). A failure restores the previous value; a 404 / 405 marks the\n * write unavailable — the backend predates the route — so the UI withdraws\n * the control instead of failing on every use.\n *\n * Same-thread writes are serialized: while one is in flight, a further write\n * for that thread flips the row at once but only records the desired value,\n * and at most one follow-up write is sent — with that value — once the\n * in-flight one has answered. Two independent writes for one thread never\n * race, so the server cannot end on an earlier request's value.\n *\n * Everything the hook holds is scoped to `(backendUrl, principalId)`: a\n * credential swap under the same list reads an empty override map, and a\n * write that was in flight for the previous identity is ignored when it\n * answers, so a same-id row under the new identity never inherits the old\n * one's value.\n */\nimport { useMutation } from '@tanstack/react-query';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type { RestConversationAuth } from './use-rest-conversation-history';\n\nexport interface ThreadFieldTarget<T> {\n  threadId: string;\n  value: T;\n}\n\n/** The one field every row must carry: its identity. */\nexport interface ThreadFieldRow {\n  threadId: string;\n}\n\nexport interface UseThreadFieldOverrideOptions<T, R extends ThreadFieldRow> {\n  /** Names the field: part of the mutation key and of the one-per-backend warning. */\n  field: string;\n  backendUrl: string;\n  /** Non-secret identity in the mutation key (as the read-state mutation keys). */\n  principalId: string;\n  getAuth: () => RestConversationAuth | Promise<RestConversationAuth>;\n  /**\n   * The rows as the list sources currently report them, BEFORE overrides. An\n   * override is dropped once its row reports the same value.\n   */\n  rows: readonly R[];\n  /** The field as a source row reports it; `undefined` when the row does not carry it. */\n  readRow: (row: R) => T | undefined;\n  /** The write; resolves to the server's truth after it. */\n  write: (auth: RestConversationAuth, target: ThreadFieldTarget<T>) => Promise<ThreadFieldTarget<T>>;\n  /** True for the rejection that means the backend has no such route (404 / 405). */\n  isUnavailableError: (error: unknown) => boolean;\n  /** Logged once per backend when the route is found missing. */\n  unavailableWarning: string;\n  /** Write the server's answer into the list caches (`patchConversation`). */\n  onServerTruth?: (truth: ThreadFieldTarget<T>) => void;\n  /** Value equality (default `===`). */\n  equals?: (a: T, b: T) => boolean;\n}\n\nexport interface ThreadFieldOverride<T> {\n  /** Optimistic, then server-confirmed, values layered over the list sources, keyed by thread id. */\n  overrides: Readonly<Record<string, T>>;\n  /**\n   * Write the field. Flips the row at once; while that thread's write is in\n   * flight the call only records the desired value (see module doc).\n   */\n  set: (target: ThreadFieldTarget<T>) => void;\n  /** True while any write is in flight. */\n  isPending: boolean;\n  /** The threads whose write is in flight — a control disables itself for these. */\n  pendingThreadIds: ReadonlySet<string>;\n  /**\n   * `false` once the backend answered 404 / 405: the route is not deployed\n   * there, and the UI withdraws the control.\n   */\n  isAvailable: boolean;\n}\n\n/** The hook's state, tagged with the identity it belongs to. */\ninterface ScopedFieldState<T> {\n  scope: string;\n  overrides: Record<string, T>;\n  pending: ReadonlySet<string>;\n}\n\ninterface FieldWrite<T> extends ThreadFieldTarget<T> {\n  /** The override before this chain of writes began; `undefined` restores the source value. */\n  previous: T | undefined;\n  /** The identity the write was issued for; an answer for another one is ignored. */\n  scope: string;\n  /** This thread's write generation; an answer for an older one is ignored. */\n  seq: number;\n}\n\nconst EMPTY_PENDING: ReadonlySet<string> = new Set();\n\nfunction fieldScope(backendUrl: string, principalId: string): string {\n  return `${backendUrl}::${principalId}`;\n}\n\nfunction withPending(pending: ReadonlySet<string>, threadId: string, isPending: boolean): ReadonlySet<string> {\n  if (pending.has(threadId) === isPending) return pending;\n  const next = new Set(pending);\n  if (isPending) next.add(threadId);\n  else next.delete(threadId);\n  return next;\n}\n\nconst strictEquals = <T,>(a: T, b: T): boolean => a === b;\n\n/** `(field, backend)` pairs already warned about, so an older agora logs one line per page load, not one per use. */\nconst warnedUnavailableBackends = new Set<string>();\n\n/** Test seam: forget which backends were warned about. */\nexport function resetThreadFieldUnavailableWarnings(): void {\n  warnedUnavailableBackends.clear();\n}\n\nexport function useThreadFieldOverride<T, R extends ThreadFieldRow>({\n  field,\n  backendUrl,\n  principalId,\n  getAuth,\n  rows,\n  readRow,\n  write,\n  isUnavailableError,\n  unavailableWarning,\n  onServerTruth,\n  equals = strictEquals,\n}: UseThreadFieldOverrideOptions<T, R>): ThreadFieldOverride<T> {\n  const scope = fieldScope(backendUrl, principalId);\n  const [state, setState] = useState<ScopedFieldState<T>>(() => ({\n    scope,\n    overrides: {},\n    pending: EMPTY_PENDING,\n  }));\n  // An identity swap discards everything held for the previous identity —\n  // overrides AND pending rows — rather than merely hiding it: a round trip\n  // back to that identity must not revive a row pinned for a write whose\n  // answer has since been dropped (it would stay disabled for good). Setting\n  // state during render is React's derived-state reset; the render re-runs\n  // with the empty state before anything is committed.\n  if (state.scope !== scope) {\n    setState({ scope, overrides: {}, pending: EMPTY_PENDING });\n  }\n  const emptyOverridesRef = useRef<Readonly<Record<string, T>>>(Object.freeze({}) as Record<string, T>);\n  const overrides = state.scope === scope ? state.overrides : emptyOverridesRef.current;\n  const pendingThreadIds = state.scope === scope ? state.pending : EMPTY_PENDING;\n  // The backend the route was found missing on. The route is a property of\n  // the backend, not of who is asking, so this is keyed by backend alone; a\n  // different backend is presumed to have it until it says otherwise.\n  const [unavailableBackend, setUnavailableBackend] = useState<string | null>(null);\n\n  const scopeRef = useRef(scope);\n  scopeRef.current = scope;\n  const overridesRef = useRef(overrides);\n  overridesRef.current = overrides;\n  // The per-render option closures ride refs so a consumer's fresh functions\n  // never re-key the mutation or the caught-up effect.\n  const readRowRef = useRef(readRow);\n  readRowRef.current = readRow;\n  const writeRef = useRef(write);\n  writeRef.current = write;\n  const isUnavailableErrorRef = useRef(isUnavailableError);\n  isUnavailableErrorRef.current = isUnavailableError;\n  const unavailableWarningRef = useRef(unavailableWarning);\n  unavailableWarningRef.current = unavailableWarning;\n  const onServerTruthRef = useRef(onServerTruth);\n  onServerTruthRef.current = onServerTruth;\n  const equalsRef = useRef(equals);\n  equalsRef.current = equals;\n  // Per-thread write bookkeeping for the CURRENT identity: the generation of\n  // the write in flight, and the value a further write asked for meanwhile.\n  const inFlightRef = useRef<Map<string, number>>(new Map());\n  const queuedRef = useRef<Map<string, T>>(new Map());\n  const seqRef = useRef(0);\n  const bookkeepingScopeRef = useRef(scope);\n  if (bookkeepingScopeRef.current !== scope) {\n    // The previous identity's writes are abandoned with its state: their\n    // answers are dropped by the scope guard below, and nothing queued\n    // behind them is sent.\n    bookkeepingScopeRef.current = scope;\n    inFlightRef.current = new Map();\n    queuedRef.current = new Map();\n  }\n\n  const update = useCallback(\n    (forScope: string, patch: (current: ScopedFieldState<T>) => ScopedFieldState<T>) => {\n      setState((current) => {\n        const base: ScopedFieldState<T> =\n          current.scope === forScope\n            ? current\n            : { scope: forScope, overrides: {}, pending: EMPTY_PENDING };\n        const next = patch(base);\n        return next === base && current.scope === forScope ? current : next;\n      });\n    },\n    [],\n  );\n\n  useEffect(() => {\n    const caughtUp = Object.keys(overrides).filter((threadId) => {\n      // A row with a write in flight keeps its override whatever the sources\n      // say: the first write of a chain patches the page with a value the\n      // user has since moved away from, and the row must not flash it.\n      if (pendingThreadIds.has(threadId)) return false;\n      const row = rows.find((candidate) => candidate.threadId === threadId);\n      if (row === undefined) return false;\n      const reported = readRowRef.current(row);\n      const override = overrides[threadId];\n      return reported !== undefined && override !== undefined && equalsRef.current(reported, override);\n    });\n    if (caughtUp.length === 0) return;\n    update(scope, (current) => {\n      const next = { ...current.overrides };\n      for (const threadId of caughtUp) delete next[threadId];\n      return { ...current, overrides: next };\n    });\n  }, [overrides, pendingThreadIds, rows, scope, update]);\n\n  const mutation = useMutation({\n    mutationKey: ['conversation-history', field, backendUrl, principalId],\n    mutationFn: async ({ threadId, value }: FieldWrite<T>) =>\n      writeRef.current(await getAuth(), { threadId, value }),\n    onError: (error, write) => {\n      if (isUnavailableErrorRef.current(error)) {\n        setUnavailableBackend(backendUrl);\n        const warnKey = `${field}::${backendUrl}`;\n        if (!warnedUnavailableBackends.has(warnKey)) {\n          warnedUnavailableBackends.add(warnKey);\n          console.warn(unavailableWarningRef.current);\n        }\n      }\n      if (!isCurrentWrite(write)) return;\n      inFlightRef.current.delete(write.threadId);\n      // Whatever was asked for meanwhile is dropped with the failure: the row\n      // goes back to what it showed before the chain began.\n      queuedRef.current.delete(write.threadId);\n      update(write.scope, (current) => {\n        const overridesNext = { ...current.overrides };\n        if (write.previous === undefined) delete overridesNext[write.threadId];\n        else overridesNext[write.threadId] = write.previous;\n        return {\n          ...current,\n          overrides: overridesNext,\n          pending: withPending(current.pending, write.threadId, false),\n        };\n      });\n    },\n    onSuccess: (truth, write) => {\n      if (!isCurrentWrite(write)) return;\n      inFlightRef.current.delete(write.threadId);\n      const queued = queuedRef.current.get(write.threadId);\n      const hadQueued = queuedRef.current.has(write.threadId);\n      queuedRef.current.delete(write.threadId);\n      onServerTruthRef.current?.(truth);\n      if (hadQueued && queued !== undefined && !equalsRef.current(queued, truth.value)) {\n        // The row already shows the value asked for meanwhile; the server\n        // does not have it yet, so send it now — one write, the latest value.\n        startWrite(write.scope, {\n          threadId: write.threadId,\n          value: queued,\n          previous: truth.value,\n        });\n        return;\n      }\n      update(write.scope, (current) => ({\n        ...current,\n        overrides: { ...current.overrides, [truth.threadId]: truth.value },\n        pending: withPending(current.pending, truth.threadId, false),\n      }));\n    },\n  });\n  const mutate = mutation.mutate;\n\n  /** True when the answer belongs to the current identity and to this thread's latest write. */\n  function isCurrentWrite(write: FieldWrite<T>): boolean {\n    return (\n      scopeRef.current === write.scope && inFlightRef.current.get(write.threadId) === write.seq\n    );\n  }\n\n  function startWrite(forScope: string, write: Omit<FieldWrite<T>, 'scope' | 'seq'>): void {\n    const seq = ++seqRef.current;\n    inFlightRef.current.set(write.threadId, seq);\n    update(forScope, (current) => ({\n      ...current,\n      pending: withPending(current.pending, write.threadId, true),\n    }));\n    mutate({ ...write, scope: forScope, seq });\n  }\n\n  const startWriteRef = useRef(startWrite);\n  startWriteRef.current = startWrite;\n\n  const set = useCallback(\n    ({ threadId, value }: ThreadFieldTarget<T>) => {\n      const forScope = scopeRef.current;\n      const previous = overridesRef.current[threadId];\n      // The row flips at once whether the write goes out now or after the\n      // one in flight.\n      update(forScope, (current) => ({\n        ...current,\n        overrides: { ...current.overrides, [threadId]: value },\n      }));\n      if (inFlightRef.current.has(threadId)) {\n        queuedRef.current.set(threadId, value);\n        return;\n      }\n      startWriteRef.current(forScope, { threadId, value, previous });\n    },\n    [update],\n  );\n\n  return {\n    overrides,\n    set,\n    isPending: pendingThreadIds.size > 0,\n    pendingThreadIds,\n    isAvailable: unavailableBackend !== backendUrl,\n  };\n}\n"],"names":["useState","useRef","useCallback","useEffect","useMutation","write"],"mappings":"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"}

package/dist/threads/use-thread-field-override.d.ts

@@ -0,0 +1,55 @@
+import type { RestConversationAuth } from './use-rest-conversation-history';
+export interface ThreadFieldTarget<T> {
+    threadId: string;
+    value: T;
+}
+/** The one field every row must carry: its identity. */
+export interface ThreadFieldRow {
+    threadId: string;
+}
+export interface UseThreadFieldOverrideOptions<T, R extends ThreadFieldRow> {
+    /** Names the field: part of the mutation key and of the one-per-backend warning. */
+    field: string;
+    backendUrl: string;
+    /** Non-secret identity in the mutation key (as the read-state mutation keys). */
+    principalId: string;
+    getAuth: () => RestConversationAuth | Promise<RestConversationAuth>;
+    /**
+     * The rows as the list sources currently report them, BEFORE overrides. An
+     * override is dropped once its row reports the same value.
+     */
+    rows: readonly R[];
+    /** The field as a source row reports it; `undefined` when the row does not carry it. */
+    readRow: (row: R) => T | undefined;
+    /** The write; resolves to the server's truth after it. */
+    write: (auth: RestConversationAuth, target: ThreadFieldTarget<T>) => Promise<ThreadFieldTarget<T>>;
+    /** True for the rejection that means the backend has no such route (404 / 405). */
+    isUnavailableError: (error: unknown) => boolean;
+    /** Logged once per backend when the route is found missing. */
+    unavailableWarning: string;
+    /** Write the server's answer into the list caches (`patchConversation`). */
+    onServerTruth?: (truth: ThreadFieldTarget<T>) => void;
+    /** Value equality (default `===`). */
+    equals?: (a: T, b: T) => boolean;
+}
+export interface ThreadFieldOverride<T> {
+    /** Optimistic, then server-confirmed, values layered over the list sources, keyed by thread id. */
+    overrides: Readonly<Record<string, T>>;
+    /**
+     * Write the field. Flips the row at once; while that thread's write is in
+     * flight the call only records the desired value (see module doc).
+     */
+    set: (target: ThreadFieldTarget<T>) => void;
+    /** True while any write is in flight. */
+    isPending: boolean;
+    /** The threads whose write is in flight — a control disables itself for these. */
+    pendingThreadIds: ReadonlySet<string>;
+    /**
+     * `false` once the backend answered 404 / 405: the route is not deployed
+     * there, and the UI withdraws the control.
+     */
+    isAvailable: boolean;
+}
+/** Test seam: forget which backends were warned about. */
+export declare function resetThreadFieldUnavailableWarnings(): void;
+export declare function useThreadFieldOverride<T, R extends ThreadFieldRow>({ field, backendUrl, principalId, getAuth, rows, readRow, write, isUnavailableError, unavailableWarning, onServerTruth, equals, }: UseThreadFieldOverrideOptions<T, R>): ThreadFieldOverride<T>;

package/dist/threads/use-thread-field-override.js

@@ -0,0 +1,184 @@
+import { useMutation } from "@tanstack/react-query";
+import { useState, useRef, useCallback, useEffect } from "react";
+const EMPTY_PENDING = /* @__PURE__ */ new Set();
+function fieldScope(backendUrl, principalId) {
+  return `${backendUrl}::${principalId}`;
+}
+function withPending(pending, threadId, isPending) {
+  if (pending.has(threadId) === isPending) return pending;
+  const next = new Set(pending);
+  if (isPending) next.add(threadId);
+  else next.delete(threadId);
+  return next;
+}
+const strictEquals = (a, b) => a === b;
+const warnedUnavailableBackends = /* @__PURE__ */ new Set();
+function useThreadFieldOverride({
+  field,
+  backendUrl,
+  principalId,
+  getAuth,
+  rows,
+  readRow,
+  write,
+  isUnavailableError,
+  unavailableWarning,
+  onServerTruth,
+  equals = strictEquals
+}) {
+  const scope = fieldScope(backendUrl, principalId);
+  const [state, setState] = useState(() => ({
+    scope,
+    overrides: {},
+    pending: EMPTY_PENDING
+  }));
+  if (state.scope !== scope) {
+    setState({ scope, overrides: {}, pending: EMPTY_PENDING });
+  }
+  const emptyOverridesRef = useRef(Object.freeze({}));
+  const overrides = state.scope === scope ? state.overrides : emptyOverridesRef.current;
+  const pendingThreadIds = state.scope === scope ? state.pending : EMPTY_PENDING;
+  const [unavailableBackend, setUnavailableBackend] = useState(null);
+  const scopeRef = useRef(scope);
+  scopeRef.current = scope;
+  const overridesRef = useRef(overrides);
+  overridesRef.current = overrides;
+  const readRowRef = useRef(readRow);
+  readRowRef.current = readRow;
+  const writeRef = useRef(write);
+  writeRef.current = write;
+  const isUnavailableErrorRef = useRef(isUnavailableError);
+  isUnavailableErrorRef.current = isUnavailableError;
+  const unavailableWarningRef = useRef(unavailableWarning);
+  unavailableWarningRef.current = unavailableWarning;
+  const onServerTruthRef = useRef(onServerTruth);
+  onServerTruthRef.current = onServerTruth;
+  const equalsRef = useRef(equals);
+  equalsRef.current = equals;
+  const inFlightRef = useRef(/* @__PURE__ */ new Map());
+  const queuedRef = useRef(/* @__PURE__ */ new Map());
+  const seqRef = useRef(0);
+  const bookkeepingScopeRef = useRef(scope);
+  if (bookkeepingScopeRef.current !== scope) {
+    bookkeepingScopeRef.current = scope;
+    inFlightRef.current = /* @__PURE__ */ new Map();
+    queuedRef.current = /* @__PURE__ */ new Map();
+  }
+  const update = useCallback(
+    (forScope, patch) => {
+      setState((current) => {
+        const base = current.scope === forScope ? current : { scope: forScope, overrides: {}, pending: EMPTY_PENDING };
+        const next = patch(base);
+        return next === base && current.scope === forScope ? current : next;
+      });
+    },
+    []
+  );
+  useEffect(() => {
+    const caughtUp = Object.keys(overrides).filter((threadId) => {
+      if (pendingThreadIds.has(threadId)) return false;
+      const row = rows.find((candidate) => candidate.threadId === threadId);
+      if (row === void 0) return false;
+      const reported = readRowRef.current(row);
+      const override = overrides[threadId];
+      return reported !== void 0 && override !== void 0 && equalsRef.current(reported, override);
+    });
+    if (caughtUp.length === 0) return;
+    update(scope, (current) => {
+      const next = { ...current.overrides };
+      for (const threadId of caughtUp) delete next[threadId];
+      return { ...current, overrides: next };
+    });
+  }, [overrides, pendingThreadIds, rows, scope, update]);
+  const mutation = useMutation({
+    mutationKey: ["conversation-history", field, backendUrl, principalId],
+    mutationFn: async ({ threadId, value }) => writeRef.current(await getAuth(), { threadId, value }),
+    onError: (error, write2) => {
+      if (isUnavailableErrorRef.current(error)) {
+        setUnavailableBackend(backendUrl);
+        const warnKey = `${field}::${backendUrl}`;
+        if (!warnedUnavailableBackends.has(warnKey)) {
+          warnedUnavailableBackends.add(warnKey);
+          console.warn(unavailableWarningRef.current);
+        }
+      }
+      if (!isCurrentWrite(write2)) return;
+      inFlightRef.current.delete(write2.threadId);
+      queuedRef.current.delete(write2.threadId);
+      update(write2.scope, (current) => {
+        const overridesNext = { ...current.overrides };
+        if (write2.previous === void 0) delete overridesNext[write2.threadId];
+        else overridesNext[write2.threadId] = write2.previous;
+        return {
+          ...current,
+          overrides: overridesNext,
+          pending: withPending(current.pending, write2.threadId, false)
+        };
+      });
+    },
+    onSuccess: (truth, write2) => {
+      var _a;
+      if (!isCurrentWrite(write2)) return;
+      inFlightRef.current.delete(write2.threadId);
+      const queued = queuedRef.current.get(write2.threadId);
+      const hadQueued = queuedRef.current.has(write2.threadId);
+      queuedRef.current.delete(write2.threadId);
+      (_a = onServerTruthRef.current) == null ? void 0 : _a.call(onServerTruthRef, truth);
+      if (hadQueued && queued !== void 0 && !equalsRef.current(queued, truth.value)) {
+        startWrite(write2.scope, {
+          threadId: write2.threadId,
+          value: queued,
+          previous: truth.value
+        });
+        return;
+      }
+      update(write2.scope, (current) => ({
+        ...current,
+        overrides: { ...current.overrides, [truth.threadId]: truth.value },
+        pending: withPending(current.pending, truth.threadId, false)
+      }));
+    }
+  });
+  const mutate = mutation.mutate;
+  function isCurrentWrite(write2) {
+    return scopeRef.current === write2.scope && inFlightRef.current.get(write2.threadId) === write2.seq;
+  }
+  function startWrite(forScope, write2) {
+    const seq = ++seqRef.current;
+    inFlightRef.current.set(write2.threadId, seq);
+    update(forScope, (current) => ({
+      ...current,
+      pending: withPending(current.pending, write2.threadId, true)
+    }));
+    mutate({ ...write2, scope: forScope, seq });
+  }
+  const startWriteRef = useRef(startWrite);
+  startWriteRef.current = startWrite;
+  const set = useCallback(
+    ({ threadId, value }) => {
+      const forScope = scopeRef.current;
+      const previous = overridesRef.current[threadId];
+      update(forScope, (current) => ({
+        ...current,
+        overrides: { ...current.overrides, [threadId]: value }
+      }));
+      if (inFlightRef.current.has(threadId)) {
+        queuedRef.current.set(threadId, value);
+        return;
+      }
+      startWriteRef.current(forScope, { threadId, value, previous });
+    },
+    [update]
+  );
+  return {
+    overrides,
+    set,
+    isPending: pendingThreadIds.size > 0,
+    pendingThreadIds,
+    isAvailable: unavailableBackend !== backendUrl
+  };
+}
+export {
+  useThreadFieldOverride
+};
+//# sourceMappingURL=use-thread-field-override.js.map

package/dist/threads/use-thread-field-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-thread-field-override.js","sources":["../../src/threads/use-thread-field-override.ts"],"sourcesContent":["/**\n * The optimistic per-thread field write behind the pin (`useThreadFavorite`)\n * and the rename (`useThreadRename`): one TanStack mutation over a REST\n * route with an override map layered over the list rows.\n *\n * Why overrides rather than a cache patch alone: a row's field is folded from\n * two sources — the fetched page and the pushed conversation index — and a\n * push that predates the write would clobber a patched page. The override\n * sits over both until the sources report the same value, then drops away so\n * they own the field again (a later write from another client is never\n * masked). A failure restores the previous value; a 404 / 405 marks the\n * write unavailable — the backend predates the route — so the UI withdraws\n * the control instead of failing on every use.\n *\n * Same-thread writes are serialized: while one is in flight, a further write\n * for that thread flips the row at once but only records the desired value,\n * and at most one follow-up write is sent — with that value — once the\n * in-flight one has answered. Two independent writes for one thread never\n * race, so the server cannot end on an earlier request's value.\n *\n * Everything the hook holds is scoped to `(backendUrl, principalId)`: a\n * credential swap under the same list reads an empty override map, and a\n * write that was in flight for the previous identity is ignored when it\n * answers, so a same-id row under the new identity never inherits the old\n * one's value.\n */\nimport { useMutation } from '@tanstack/react-query';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type { RestConversationAuth } from './use-rest-conversation-history';\n\nexport interface ThreadFieldTarget<T> {\n  threadId: string;\n  value: T;\n}\n\n/** The one field every row must carry: its identity. */\nexport interface ThreadFieldRow {\n  threadId: string;\n}\n\nexport interface UseThreadFieldOverrideOptions<T, R extends ThreadFieldRow> {\n  /** Names the field: part of the mutation key and of the one-per-backend warning. */\n  field: string;\n  backendUrl: string;\n  /** Non-secret identity in the mutation key (as the read-state mutation keys). */\n  principalId: string;\n  getAuth: () => RestConversationAuth | Promise<RestConversationAuth>;\n  /**\n   * The rows as the list sources currently report them, BEFORE overrides. An\n   * override is dropped once its row reports the same value.\n   */\n  rows: readonly R[];\n  /** The field as a source row reports it; `undefined` when the row does not carry it. */\n  readRow: (row: R) => T | undefined;\n  /** The write; resolves to the server's truth after it. */\n  write: (auth: RestConversationAuth, target: ThreadFieldTarget<T>) => Promise<ThreadFieldTarget<T>>;\n  /** True for the rejection that means the backend has no such route (404 / 405). */\n  isUnavailableError: (error: unknown) => boolean;\n  /** Logged once per backend when the route is found missing. */\n  unavailableWarning: string;\n  /** Write the server's answer into the list caches (`patchConversation`). */\n  onServerTruth?: (truth: ThreadFieldTarget<T>) => void;\n  /** Value equality (default `===`). */\n  equals?: (a: T, b: T) => boolean;\n}\n\nexport interface ThreadFieldOverride<T> {\n  /** Optimistic, then server-confirmed, values layered over the list sources, keyed by thread id. */\n  overrides: Readonly<Record<string, T>>;\n  /**\n   * Write the field. Flips the row at once; while that thread's write is in\n   * flight the call only records the desired value (see module doc).\n   */\n  set: (target: ThreadFieldTarget<T>) => void;\n  /** True while any write is in flight. */\n  isPending: boolean;\n  /** The threads whose write is in flight — a control disables itself for these. */\n  pendingThreadIds: ReadonlySet<string>;\n  /**\n   * `false` once the backend answered 404 / 405: the route is not deployed\n   * there, and the UI withdraws the control.\n   */\n  isAvailable: boolean;\n}\n\n/** The hook's state, tagged with the identity it belongs to. */\ninterface ScopedFieldState<T> {\n  scope: string;\n  overrides: Record<string, T>;\n  pending: ReadonlySet<string>;\n}\n\ninterface FieldWrite<T> extends ThreadFieldTarget<T> {\n  /** The override before this chain of writes began; `undefined` restores the source value. */\n  previous: T | undefined;\n  /** The identity the write was issued for; an answer for another one is ignored. */\n  scope: string;\n  /** This thread's write generation; an answer for an older one is ignored. */\n  seq: number;\n}\n\nconst EMPTY_PENDING: ReadonlySet<string> = new Set();\n\nfunction fieldScope(backendUrl: string, principalId: string): string {\n  return `${backendUrl}::${principalId}`;\n}\n\nfunction withPending(pending: ReadonlySet<string>, threadId: string, isPending: boolean): ReadonlySet<string> {\n  if (pending.has(threadId) === isPending) return pending;\n  const next = new Set(pending);\n  if (isPending) next.add(threadId);\n  else next.delete(threadId);\n  return next;\n}\n\nconst strictEquals = <T,>(a: T, b: T): boolean => a === b;\n\n/** `(field, backend)` pairs already warned about, so an older agora logs one line per page load, not one per use. */\nconst warnedUnavailableBackends = new Set<string>();\n\n/** Test seam: forget which backends were warned about. */\nexport function resetThreadFieldUnavailableWarnings(): void {\n  warnedUnavailableBackends.clear();\n}\n\nexport function useThreadFieldOverride<T, R extends ThreadFieldRow>({\n  field,\n  backendUrl,\n  principalId,\n  getAuth,\n  rows,\n  readRow,\n  write,\n  isUnavailableError,\n  unavailableWarning,\n  onServerTruth,\n  equals = strictEquals,\n}: UseThreadFieldOverrideOptions<T, R>): ThreadFieldOverride<T> {\n  const scope = fieldScope(backendUrl, principalId);\n  const [state, setState] = useState<ScopedFieldState<T>>(() => ({\n    scope,\n    overrides: {},\n    pending: EMPTY_PENDING,\n  }));\n  // An identity swap discards everything held for the previous identity —\n  // overrides AND pending rows — rather than merely hiding it: a round trip\n  // back to that identity must not revive a row pinned for a write whose\n  // answer has since been dropped (it would stay disabled for good). Setting\n  // state during render is React's derived-state reset; the render re-runs\n  // with the empty state before anything is committed.\n  if (state.scope !== scope) {\n    setState({ scope, overrides: {}, pending: EMPTY_PENDING });\n  }\n  const emptyOverridesRef = useRef<Readonly<Record<string, T>>>(Object.freeze({}) as Record<string, T>);\n  const overrides = state.scope === scope ? state.overrides : emptyOverridesRef.current;\n  const pendingThreadIds = state.scope === scope ? state.pending : EMPTY_PENDING;\n  // The backend the route was found missing on. The route is a property of\n  // the backend, not of who is asking, so this is keyed by backend alone; a\n  // different backend is presumed to have it until it says otherwise.\n  const [unavailableBackend, setUnavailableBackend] = useState<string | null>(null);\n\n  const scopeRef = useRef(scope);\n  scopeRef.current = scope;\n  const overridesRef = useRef(overrides);\n  overridesRef.current = overrides;\n  // The per-render option closures ride refs so a consumer's fresh functions\n  // never re-key the mutation or the caught-up effect.\n  const readRowRef = useRef(readRow);\n  readRowRef.current = readRow;\n  const writeRef = useRef(write);\n  writeRef.current = write;\n  const isUnavailableErrorRef = useRef(isUnavailableError);\n  isUnavailableErrorRef.current = isUnavailableError;\n  const unavailableWarningRef = useRef(unavailableWarning);\n  unavailableWarningRef.current = unavailableWarning;\n  const onServerTruthRef = useRef(onServerTruth);\n  onServerTruthRef.current = onServerTruth;\n  const equalsRef = useRef(equals);\n  equalsRef.current = equals;\n  // Per-thread write bookkeeping for the CURRENT identity: the generation of\n  // the write in flight, and the value a further write asked for meanwhile.\n  const inFlightRef = useRef<Map<string, number>>(new Map());\n  const queuedRef = useRef<Map<string, T>>(new Map());\n  const seqRef = useRef(0);\n  const bookkeepingScopeRef = useRef(scope);\n  if (bookkeepingScopeRef.current !== scope) {\n    // The previous identity's writes are abandoned with its state: their\n    // answers are dropped by the scope guard below, and nothing queued\n    // behind them is sent.\n    bookkeepingScopeRef.current = scope;\n    inFlightRef.current = new Map();\n    queuedRef.current = new Map();\n  }\n\n  const update = useCallback(\n    (forScope: string, patch: (current: ScopedFieldState<T>) => ScopedFieldState<T>) => {\n      setState((current) => {\n        const base: ScopedFieldState<T> =\n          current.scope === forScope\n            ? current\n            : { scope: forScope, overrides: {}, pending: EMPTY_PENDING };\n        const next = patch(base);\n        return next === base && current.scope === forScope ? current : next;\n      });\n    },\n    [],\n  );\n\n  useEffect(() => {\n    const caughtUp = Object.keys(overrides).filter((threadId) => {\n      // A row with a write in flight keeps its override whatever the sources\n      // say: the first write of a chain patches the page with a value the\n      // user has since moved away from, and the row must not flash it.\n      if (pendingThreadIds.has(threadId)) return false;\n      const row = rows.find((candidate) => candidate.threadId === threadId);\n      if (row === undefined) return false;\n      const reported = readRowRef.current(row);\n      const override = overrides[threadId];\n      return reported !== undefined && override !== undefined && equalsRef.current(reported, override);\n    });\n    if (caughtUp.length === 0) return;\n    update(scope, (current) => {\n      const next = { ...current.overrides };\n      for (const threadId of caughtUp) delete next[threadId];\n      return { ...current, overrides: next };\n    });\n  }, [overrides, pendingThreadIds, rows, scope, update]);\n\n  const mutation = useMutation({\n    mutationKey: ['conversation-history', field, backendUrl, principalId],\n    mutationFn: async ({ threadId, value }: FieldWrite<T>) =>\n      writeRef.current(await getAuth(), { threadId, value }),\n    onError: (error, write) => {\n      if (isUnavailableErrorRef.current(error)) {\n        setUnavailableBackend(backendUrl);\n        const warnKey = `${field}::${backendUrl}`;\n        if (!warnedUnavailableBackends.has(warnKey)) {\n          warnedUnavailableBackends.add(warnKey);\n          console.warn(unavailableWarningRef.current);\n        }\n      }\n      if (!isCurrentWrite(write)) return;\n      inFlightRef.current.delete(write.threadId);\n      // Whatever was asked for meanwhile is dropped with the failure: the row\n      // goes back to what it showed before the chain began.\n      queuedRef.current.delete(write.threadId);\n      update(write.scope, (current) => {\n        const overridesNext = { ...current.overrides };\n        if (write.previous === undefined) delete overridesNext[write.threadId];\n        else overridesNext[write.threadId] = write.previous;\n        return {\n          ...current,\n          overrides: overridesNext,\n          pending: withPending(current.pending, write.threadId, false),\n        };\n      });\n    },\n    onSuccess: (truth, write) => {\n      if (!isCurrentWrite(write)) return;\n      inFlightRef.current.delete(write.threadId);\n      const queued = queuedRef.current.get(write.threadId);\n      const hadQueued = queuedRef.current.has(write.threadId);\n      queuedRef.current.delete(write.threadId);\n      onServerTruthRef.current?.(truth);\n      if (hadQueued && queued !== undefined && !equalsRef.current(queued, truth.value)) {\n        // The row already shows the value asked for meanwhile; the server\n        // does not have it yet, so send it now — one write, the latest value.\n        startWrite(write.scope, {\n          threadId: write.threadId,\n          value: queued,\n          previous: truth.value,\n        });\n        return;\n      }\n      update(write.scope, (current) => ({\n        ...current,\n        overrides: { ...current.overrides, [truth.threadId]: truth.value },\n        pending: withPending(current.pending, truth.threadId, false),\n      }));\n    },\n  });\n  const mutate = mutation.mutate;\n\n  /** True when the answer belongs to the current identity and to this thread's latest write. */\n  function isCurrentWrite(write: FieldWrite<T>): boolean {\n    return (\n      scopeRef.current === write.scope && inFlightRef.current.get(write.threadId) === write.seq\n    );\n  }\n\n  function startWrite(forScope: string, write: Omit<FieldWrite<T>, 'scope' | 'seq'>): void {\n    const seq = ++seqRef.current;\n    inFlightRef.current.set(write.threadId, seq);\n    update(forScope, (current) => ({\n      ...current,\n      pending: withPending(current.pending, write.threadId, true),\n    }));\n    mutate({ ...write, scope: forScope, seq });\n  }\n\n  const startWriteRef = useRef(startWrite);\n  startWriteRef.current = startWrite;\n\n  const set = useCallback(\n    ({ threadId, value }: ThreadFieldTarget<T>) => {\n      const forScope = scopeRef.current;\n      const previous = overridesRef.current[threadId];\n      // The row flips at once whether the write goes out now or after the\n      // one in flight.\n      update(forScope, (current) => ({\n        ...current,\n        overrides: { ...current.overrides, [threadId]: value },\n      }));\n      if (inFlightRef.current.has(threadId)) {\n        queuedRef.current.set(threadId, value);\n        return;\n      }\n      startWriteRef.current(forScope, { threadId, value, previous });\n    },\n    [update],\n  );\n\n  return {\n    overrides,\n    set,\n    isPending: pendingThreadIds.size > 0,\n    pendingThreadIds,\n    isAvailable: unavailableBackend !== backendUrl,\n  };\n}\n"],"names":["write"],"mappings":"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"}