@athenaintel/react 0.18.0 → 0.20.0

package/dist/chat-ui/thread/statewire-history-edge.js

@@ -0,0 +1,134 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useAuiState } from "@assistant-ui/react";
+import "../../packages/agent-runtime/src/generated/runconfig-contract.js";
+import { useState, useRef, useEffect, useLayoutEffect } from "react";
+import "@assistant-ui/tap";
+import "statewire";
+import { isStatewireChannelTeardown } from "../../packages/agent-runtime/src/errors.js";
+import "../../packages/agent-runtime/src/statewire-suspended.js";
+import "@tanstack/react-query";
+import "../../packages/agent-runtime/src/statewire-state.js";
+import "../../packages/agent-runtime/src/messages.js";
+import { useDeepAgentWindowSync } from "../../packages/agent-runtime/src/use-deep-agent-window-sync.js";
+import "@assistant-ui/store";
+import "@assistant-ui/react-statewire/local-storage";
+import "../../packages/agent-runtime/src/statewire-attach-observer.js";
+import "../../packages/agent-runtime/src/thread-status.js";
+import "@assistant-ui/react-statewire";
+import "@assistant-ui/core";
+import { useStatewireToolOutputs } from "../../provider/statewire-window-context.js";
+import { cn } from "cnfast";
+const THREAD_VIEWPORT_ATTR = "data-aui-thread-viewport";
+const HISTORY_EDGE_NEAR_MARGIN_PX = 1500;
+const HistoryEdgeRow = ({
+  olderCount,
+  loading,
+  onLoadOlder,
+  className,
+  rowRef
+}) => {
+  if (olderCount <= 0) return null;
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref: rowRef,
+      "data-testid": "thread-history-edge",
+      className: cn(
+        "flex w-full max-w-(--thread-max-width) items-center justify-center py-1 text-xs text-muted-foreground",
+        className
+      ),
+      children: loading ? /* @__PURE__ */ jsx("span", { "data-testid": "thread-history-edge-loading", children: "Loading earlier messages…" }) : /* @__PURE__ */ jsxs(
+        "button",
+        {
+          type: "button",
+          "data-testid": "thread-history-edge-load",
+          onClick: onLoadOlder,
+          className: "rounded-lg px-2.5 py-1 text-xs font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground",
+          children: [
+            olderCount.toLocaleString(),
+            " earlier ",
+            olderCount === 1 ? "message" : "messages"
+          ]
+        }
+      )
+    }
+  );
+};
+const StatewireHistoryEdge = ({
+  toolOutputs: toolOutputsProp,
+  className,
+  onHistoryLoad
+}) => {
+  var _a;
+  const providerToolOutputs = useStatewireToolOutputs();
+  const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? void 0;
+  const messages = useAuiState((s) => s.thread.messages);
+  const [nearTop, setNearTop] = useState(false);
+  const [nearTopEpoch, setNearTopEpoch] = useState(0);
+  const nearTopRef = useRef(false);
+  const [rowEl, setRowEl] = useState(null);
+  const { olderCount, loading, loadOlder } = useDeepAgentWindowSync({
+    messages,
+    toolOutputs,
+    nearTop,
+    nearTopEpoch,
+    onHistoryLoad,
+    onError: (error, command) => {
+      if (error instanceof Error && isStatewireChannelTeardown(error)) return;
+      console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);
+    }
+  });
+  useEffect(() => {
+    if (!rowEl || olderCount <= 0 || typeof IntersectionObserver === "undefined") return;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          const near = entry.isIntersecting;
+          if (nearTopRef.current === near) continue;
+          nearTopRef.current = near;
+          setNearTop(near);
+          if (near) setNearTopEpoch((epoch) => epoch + 1);
+        }
+      },
+      {
+        root: rowEl.closest(`[${THREAD_VIEWPORT_ATTR}]`),
+        rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px`
+      }
+    );
+    observer.observe(rowEl);
+    return () => {
+      observer.disconnect();
+      nearTopRef.current = false;
+      setNearTop(false);
+    };
+  }, [rowEl, olderCount]);
+  const shapeRef = useRef(
+    null
+  );
+  const firstId = (_a = messages[0]) == null ? void 0 : _a.id;
+  const length = messages.length;
+  useLayoutEffect(() => {
+    const viewport = (rowEl == null ? void 0 : rowEl.closest(`[${THREAD_VIEWPORT_ATTR}]`)) ?? null;
+    const prev = shapeRef.current;
+    const prepended = viewport !== null && prev !== null && prev.firstId !== void 0 && firstId !== prev.firstId && length > prev.length;
+    if (prepended) viewport.scrollTop += viewport.scrollHeight - prev.scrollHeight;
+    shapeRef.current = loading || prepended || prev === null ? { firstId, length, scrollHeight: (viewport == null ? void 0 : viewport.scrollHeight) ?? 0 } : { firstId, length, scrollHeight: prev.scrollHeight };
+  });
+  return /* @__PURE__ */ jsx(
+    HistoryEdgeRow,
+    {
+      rowRef: setRowEl,
+      olderCount,
+      loading,
+      onLoadOlder: loadOlder,
+      className
+    }
+  );
+};
+export {
+  HISTORY_EDGE_NEAR_MARGIN_PX,
+  HistoryEdgeRow,
+  StatewireHistoryEdge,
+  THREAD_VIEWPORT_ATTR
+};
+//# sourceMappingURL=statewire-history-edge.js.map

package/dist/chat-ui/thread/statewire-history-edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-history-edge.js","sources":["../../../src/chat-ui/thread/statewire-history-edge.tsx"],"sourcesContent":["import { useAuiState } from \"@assistant-ui/react\";\nimport {\n  type DeepAgentHistoryLoadEvent,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  useDeepAgentWindowSync,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport { cn } from \"../../lib/utils\";\nimport { useStatewireToolOutputs } from \"../../provider/statewire-window-context\";\n\n/** The attribute `ChatThreadShell` stamps on the scroll viewport. */\nexport const THREAD_VIEWPORT_ATTR = \"data-aui-thread-viewport\";\n\n/**\n * How far above the viewport the edge row counts as near: the row sits above\n * the first loaded message, so reaching it means the user has scrolled past\n * everything loaded and the next page should already be on its way.\n */\nexport const HISTORY_EDGE_NEAR_MARGIN_PX = 1500;\n\nexport interface HistoryEdgeRowProps {\n  /** Messages older than the loaded window the server still holds. */\n  olderCount: number;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  onLoadOlder: () => void;\n  className?: string;\n  /** The row element, for the viewport observer. */\n  rowRef?: (element: HTMLElement | null) => void;\n}\n\n/**\n * The top edge of the LOADED history on a windowed wire: how many older\n * messages the server still holds, a manual way to load the next page, and\n * the in-flight state. Renders nothing when the whole transcript is loaded\n * (or the wire is not windowed).\n */\nexport const HistoryEdgeRow: FC<HistoryEdgeRowProps> = ({\n  olderCount,\n  loading,\n  onLoadOlder,\n  className,\n  rowRef,\n}) => {\n  if (olderCount <= 0) return null;\n  return (\n    <div\n      ref={rowRef}\n      data-testid=\"thread-history-edge\"\n      className={cn(\n        \"flex w-full max-w-(--thread-max-width) items-center justify-center py-1 text-xs text-muted-foreground\",\n        className,\n      )}\n    >\n      {loading ? (\n        <span data-testid=\"thread-history-edge-loading\">Loading earlier messages…</span>\n      ) : (\n        <button\n          type=\"button\"\n          data-testid=\"thread-history-edge-load\"\n          onClick={onLoadOlder}\n          className=\"rounded-lg px-2.5 py-1 text-xs font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground\"\n        >\n          {olderCount.toLocaleString()} earlier {olderCount === 1 ? \"message\" : \"messages\"}\n        </button>\n      )}\n    </div>\n  );\n};\n\nexport interface StatewireHistoryEdgeProps {\n  /**\n   * The thread's tool-output store (the one its converter substitutes from).\n   * Defaults to `AthenaProvider`'s; hosts mounting the runtime themselves pass\n   * the store they gave `useDeepAgentRuntime({ toolOutputs })`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  className?: string;\n  /** A `history/load` settled (telemetry). */\n  onHistoryLoad?: (event: DeepAgentHistoryLoadEvent) => void;\n}\n\n/**\n * The client half of the windowed wire for a DOM thread — mounted once per\n * thread, inside the scroll viewport above the messages (`ChatThreadShell`'s\n * `beforeMessages` slot):\n *\n * - renders the \"N earlier messages\" edge row and loads the next page when\n *   the row comes near the viewport (scrolling up) or on its button, keeping\n *   the reading position when the page lands above the view;\n * - fetches cut tool outputs whole for the rendered cards, so they re-render\n *   complete through the converter (`toolOutputs`).\n *\n * Inert on a wire that is not windowed: no row, no reads.\n */\nexport const StatewireHistoryEdge: FC<StatewireHistoryEdgeProps> = ({\n  toolOutputs: toolOutputsProp,\n  className,\n  onHistoryLoad,\n}) => {\n  const providerToolOutputs = useStatewireToolOutputs();\n  const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? undefined;\n  const messages = useAuiState((s) => s.thread.messages);\n  const [nearTop, setNearTop] = useState(false);\n  const [nearTopEpoch, setNearTopEpoch] = useState(0);\n  const nearTopRef = useRef(false);\n  const [rowEl, setRowEl] = useState<HTMLElement | null>(null);\n  const { olderCount, loading, loadOlder } = useDeepAgentWindowSync({\n    messages,\n    toolOutputs,\n    nearTop,\n    nearTopEpoch,\n    onHistoryLoad,\n    onError: (error, command) => {\n      // Leaving the thread settles an in-flight read as lost: lifecycle, not a failure.\n      if (error instanceof Error && isStatewireChannelTeardown(error)) return;\n      console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);\n    },\n  });\n\n  // The row's own visibility is the near-top level: a level, not an edge, so\n  // pages chain while the user stays at the top and stop once the prepended\n  // content has pushed the row away again.\n  useEffect(() => {\n    if (!rowEl || olderCount <= 0 || typeof IntersectionObserver === \"undefined\") return;\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          const near = entry.isIntersecting;\n          if (nearTopRef.current === near) continue;\n          nearTopRef.current = near;\n          setNearTop(near);\n          if (near) setNearTopEpoch((epoch) => epoch + 1);\n        }\n      },\n      {\n        root: rowEl.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`),\n        rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px`,\n      },\n    );\n    observer.observe(rowEl);\n    return () => {\n      observer.disconnect();\n      nearTopRef.current = false;\n      setNearTop(false);\n    };\n  }, [rowEl, olderCount]);\n\n  // A prepend (older history landing) keeps the reading position: the\n  // viewport scrolls by the height the page added above the view, so the\n  // message the user was on stays put. The pre-prepend height is measured\n  // only while a page is in flight (a layout read per render would force a\n  // reflow on every streamed token otherwise).\n  const shapeRef = useRef<{ firstId: string | undefined; length: number; scrollHeight: number } | null>(\n    null,\n  );\n  const firstId = messages[0]?.id;\n  const length = messages.length;\n  useLayoutEffect(() => {\n    const viewport = rowEl?.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ?? null;\n    const prev = shapeRef.current;\n    const prepended =\n      viewport !== null &&\n      prev !== null &&\n      prev.firstId !== undefined &&\n      firstId !== prev.firstId &&\n      length > prev.length;\n    if (prepended) viewport.scrollTop += viewport.scrollHeight - prev.scrollHeight;\n    shapeRef.current =\n      loading || prepended || prev === null\n        ? { firstId, length, scrollHeight: viewport?.scrollHeight ?? 0 }\n        : { firstId, length, scrollHeight: prev.scrollHeight };\n  });\n\n  return (\n    <HistoryEdgeRow\n      rowRef={setRowEl}\n      olderCount={olderCount}\n      loading={loading}\n      onLoadOlder={loadOlder}\n      className={className}\n    />\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/{collab.cjs → collab/client.cjs}

@@ -1,12 +1,9 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const websocket = require("@y/websocket");
 const Y = require("@y/y");
-const React = require("react");
-const AthenaContext = require("./AthenaContext-B1QMhIP-.cjs");
+const closePolicy = require("./close-policy.cjs");
+const mint = require("./mint.cjs");
 function _interopNamespaceDefault(e) {
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
   if (e) {
@@ -24,64 +21,6 @@ function _interopNamespaceDefault(e) {
   return Object.freeze(n);
 }
 const Y__namespace = /* @__PURE__ */ _interopNamespaceDefault(Y);
-const WS_CLOSE_AUTH_REVOKED = 4401;
-const WS_CLOSE_DOC_DELETED = 4404;
-function classifyClose(code) {
-  if (code === void 0) return "retry";
-  if (code === WS_CLOSE_AUTH_REVOKED) return "remint";
-  if (code >= 4400 && code < 4500) return "stop";
-  return "retry";
-}
-class CollabTokenError extends Error {
-  constructor(status, message) {
-    super(message);
-    __publicField(this, "status");
-    this.name = "CollabTokenError";
-    this.status = status;
-  }
-}
-function getAuthHeaders(auth) {
-  if (auth.token) {
-    return { Authorization: `Bearer ${auth.token}` };
-  }
-  if (auth.apiKey) {
-    return { "X-API-KEY": auth.apiKey };
-  }
-  return {};
-}
-function getAthenaApiBaseUrl(backendUrl) {
-  return backendUrl.replace(/\/api\/assistant-ui\/?$/, "").replace(/\/api\/v0\/?$/, "").replace(/\/$/, "");
-}
-async function mintCollabToken(args) {
-  const base = getAthenaApiBaseUrl(args.auth.backendUrl);
-  const response = await fetch(
-    `${base}/api/v0/assets/${encodeURIComponent(args.assetId)}/collab-token`,
-    {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getAuthHeaders(args.auth)
-      },
-      body: JSON.stringify({ access: args.access }),
-      signal: args.signal
-    }
-  );
-  if (!response.ok) {
-    let detail = "";
-    try {
-      const body = await response.json();
-      if (body && typeof body === "object" && "detail" in body) {
-        detail = String(body.detail);
-      }
-    } catch {
-    }
-    throw new CollabTokenError(
-      response.status,
-      detail || `Collab token mint failed with status ${response.status}`
-    );
-  }
-  return await response.json();
-}
 const REFRESH_HEADROOM_MS = 5 * 60 * 1e3;
 const MIN_REFRESH_DELAY_MS = 30 * 1e3;
 const MAX_CONSECUTIVE_REMINTS = 2;
@@ -146,7 +85,7 @@ function connectGenericDoc(args) {
     }
     let grant;
     try {
-      grant = await mintCollabToken({ auth: args.auth, assetId: args.assetId, access });
+      grant = await mint.mintCollabToken({ auth: args.auth, assetId: args.assetId, access });
     } catch (err) {
       if (scheduledRefresh && !destroyed) {
         refreshTimer = setTimeout(() => {
@@ -193,7 +132,7 @@ function connectGenericDoc(args) {
     });
     nextProvider.on("connection-close", (event) => {
       if (provider !== nextProvider) return;
-      const action = classifyClose(event == null ? void 0 : event.code);
+      const action = closePolicy.classifyClose(event == null ? void 0 : event.code);
       if (action === "remint") {
         consecutiveRemints += 1;
         teardownProvider();
@@ -307,105 +246,6 @@ function connectGenericDoc(args) {
     }
   };
 }
-function useGenericDoc(assetId, options) {
-  const config = AthenaContext.useAthenaConfig();
-  const access = (options == null ? void 0 : options.access) ?? "view";
-  const [handle, setHandle] = React.useState(null);
-  const handleRef = React.useRef(null);
-  React.useEffect(() => {
-    const next = connectGenericDoc({
-      assetId,
-      access,
-      auth: {
-        backendUrl: config.backendUrl,
-        apiKey: config.apiKey,
-        token: config.token
-      }
-    });
-    handleRef.current = next;
-    setHandle(next);
-    return () => {
-      handleRef.current = null;
-      next.destroy();
-    };
-  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);
-  const subscribe = React.useMemo(() => {
-    return (onStoreChange) => {
-      if (!handle) return () => {
-      };
-      return handle.onChange(onStoreChange);
-    };
-  }, [handle]);
-  React.useSyncExternalStore(
-    subscribe,
-    () => {
-      if (!handle) return EMPTY_SNAPSHOT;
-      return `${handle.status}|${handle.synced}|${handle.accessType ?? ""}|${handle.version}`;
-    },
-    () => EMPTY_SNAPSHOT
-  );
-  return {
-    doc: (handle == null ? void 0 : handle.doc) ?? null,
-    status: (handle == null ? void 0 : handle.status) ?? "connecting",
-    synced: (handle == null ? void 0 : handle.synced) ?? false,
-    accessType: (handle == null ? void 0 : handle.accessType) ?? null,
-    error: (handle == null ? void 0 : handle.error) ?? null,
-    presence: (handle == null ? void 0 : handle.getPresence()) ?? [],
-    setPresence: (state) => {
-      var _a;
-      return (_a = handleRef.current) == null ? void 0 : _a.setPresence(state);
-    }
-  };
-}
-const EMPTY_SNAPSHOT = "init|false||0";
-function defineDocShape(shape) {
-  const keys = Object.keys(shape);
-  return {
-    shape,
-    bind(doc) {
-      const toJSON = () => {
-        const out = {};
-        for (const key of keys) {
-          out[key] = doc.get(key).toJSON();
-        }
-        return out;
-      };
-      return {
-        get: (key) => doc.get(key),
-        toJSON,
-        subscribe: (listener) => {
-          let scheduled = false;
-          const emit = () => {
-            scheduled = false;
-            listener(toJSON());
-          };
-          const onDeepChange = () => {
-            if (scheduled) return;
-            scheduled = true;
-            queueMicrotask(emit);
-          };
-          const roots = keys.map((key) => doc.get(key));
-          for (const root of roots) {
-            root.observeDeep(onDeepChange);
-          }
-          listener(toJSON());
-          return () => {
-            for (const root of roots) {
-              root.unobserveDeep(onDeepChange);
-            }
-          };
-        }
-      };
-    }
-  };
-}
-exports.CollabTokenError = CollabTokenError;
-exports.WS_CLOSE_AUTH_REVOKED = WS_CLOSE_AUTH_REVOKED;
-exports.WS_CLOSE_DOC_DELETED = WS_CLOSE_DOC_DELETED;
-exports.classifyClose = classifyClose;
+exports.CollabTokenError = mint.CollabTokenError;
 exports.connectGenericDoc = connectGenericDoc;
-exports.defineDocShape = defineDocShape;
-exports.getAthenaApiBaseUrl = getAthenaApiBaseUrl;
-exports.mintCollabToken = mintCollabToken;
-exports.useGenericDoc = useGenericDoc;
-//# sourceMappingURL=collab.cjs.map
+//# sourceMappingURL=client.cjs.map

package/dist/collab/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","sources":["../../src/collab/client.ts"],"sourcesContent":["/**\n * Vanilla (framework-agnostic) live client for Generic Doc assets.\n *\n * `connectGenericDoc` owns the full connection lifecycle: mint a room-bound\n * token via the public API, open the Keryx WebSocket with the v14 provider\n * (`@y/websocket` + `@y/y`), re-mint before expiry, apply the close-code\n * policy (4401 → one fresh mint, other 44xx → permanent stop, everything\n * else → provider backoff), and expose presence from awareness. React apps\n * use `useGenericDoc` from `@athenaintel/react/collab` instead of calling\n * this directly.\n */\n\nimport { WebsocketProvider } from '@y/websocket';\nimport * as Y from '@y/y';\nimport { classifyClose } from './close-policy';\nimport {\n  type CollabAuth,\n  type CollabTokenResponse,\n  CollabTokenError,\n  mintCollabToken,\n} from './mint';\n\nexport type GenericDocStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'closed'\n  | 'error';\n\nexport interface PresenceEntry {\n  clientId: number;\n  state: Record<string, unknown>;\n}\n\nexport interface GenericDocHandle {\n  /** The live shared document. Owned by the handle; destroyed with it. */\n  readonly doc: Y.Doc;\n  readonly status: GenericDocStatus;\n  /**\n   * Whether the initial server sync has completed for the current connection.\n   * `status === 'connected'` fires before the server state arrives, so a doc\n   * read immediately after connect can still be empty — gate first reads on\n   * this (or `waitForSync`).\n   */\n  readonly synced: boolean;\n  /** Granted access from the last successful mint. */\n  readonly accessType: 'r' | 'rw' | null;\n  /** Terminal error, when status is 'error' or 'closed'. */\n  readonly error: Error | null;\n  /** Monotonic change counter — bumps on every status/presence notification. */\n  readonly version: number;\n  /**\n   * Resolve once the initial server sync completes; reject on timeout, on a\n   * terminal connection state, or if the handle is destroyed first.\n   */\n  waitForSync: (timeoutMs?: number) => Promise<void>;\n  getPresence: () => PresenceEntry[];\n  /** Broadcast this client's presence state (requires a live connection). */\n  setPresence: (state: Record<string, unknown> | null) => void;\n  /**\n   * Force an early token refresh. Session-preserving: the live connection\n   * stays up until the fresh token is minted; a failed mint retries on a\n   * short timer instead of dropping the session.\n   */\n  refreshNow: () => Promise<void>;\n  onChange: (listener: () => void) => () => void;\n  destroy: () => void;\n}\n\n/** Re-mint this long before token expiry (clamped to a floor for short TTLs). */\nconst REFRESH_HEADROOM_MS = 5 * 60 * 1000;\nconst MIN_REFRESH_DELAY_MS = 30 * 1000;\n\n/** Consecutive 4401→mint cycles allowed without a successful connect between. */\nconst MAX_CONSECUTIVE_REMINTS = 2;\n\nexport function connectGenericDoc(args: {\n  assetId: string;\n  auth: CollabAuth;\n  access?: 'view' | 'edit';\n}): GenericDocHandle {\n  const access = args.access ?? 'view';\n  const doc = new Y.Doc();\n  const listeners = new Set<() => void>();\n\n  let provider: WebsocketProvider | null = null;\n  let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n  let destroyed = false;\n  let status: GenericDocStatus = 'connecting';\n  let synced = false;\n  let accessType: 'r' | 'rw' | null = null;\n  let error: Error | null = null;\n  let lastPresence: Record<string, unknown> | null = null;\n  let version = 0;\n  let consecutiveRemints = 0;\n\n  const notify = () => {\n    version += 1;\n    for (const listener of listeners) listener();\n  };\n\n  const setStatus = (next: GenericDocStatus, err: Error | null = null) => {\n    if (destroyed && next !== 'closed') return;\n    status = next;\n    error = err;\n    notify();\n  };\n\n  const clearRefreshTimer = () => {\n    if (refreshTimer !== null) {\n      clearTimeout(refreshTimer);\n      refreshTimer = null;\n    }\n  };\n\n  const teardownProvider = () => {\n    clearRefreshTimer();\n    // A future provider must complete its own initial sync; the doc keeps its\n    // content either way. Subscribers must observe the flip immediately —\n    // waiting for the next provider event would let them act on synced=true\n    // across the replacement gap.\n    if (synced) {\n      synced = false;\n      notify();\n    }\n    if (provider) {\n      provider.destroy();\n      provider = null;\n    }\n  };\n\n  const scheduleRefresh = (grant: CollabTokenResponse) => {\n    clearRefreshTimer();\n    const delay = Math.max(\n      grant.expires_at_ms - Date.now() - REFRESH_HEADROOM_MS,\n      MIN_REFRESH_DELAY_MS\n    );\n    refreshTimer = setTimeout(() => {\n      void connect({ scheduledRefresh: true });\n    }, delay);\n  };\n\n  const connect = async (opts?: { scheduledRefresh?: boolean }): Promise<void> => {\n    if (destroyed) return;\n    const scheduledRefresh = opts?.scheduledRefresh === true;\n    // A scheduled refresh mints FIRST and keeps the live session up: the old\n    // token has ~5 minutes of headroom, so a transient mint failure retries\n    // on a short timer instead of dropping a healthy connection.\n    if (!scheduledRefresh) {\n      teardownProvider();\n    } else {\n      clearRefreshTimer();\n    }\n    let grant: CollabTokenResponse;\n    try {\n      grant = await mintCollabToken({ auth: args.auth, assetId: args.assetId, access });\n    } catch (err) {\n      if (scheduledRefresh && !destroyed) {\n        refreshTimer = setTimeout(() => {\n          void connect({ scheduledRefresh: true });\n        }, MIN_REFRESH_DELAY_MS);\n        return;\n      }\n      // A denied mint is authoritative (revoked / not shared / not eligible);\n      // anything else (network) is worth telling the caller about too — the\n      // handle stays usable via a later explicit reconnect-by-recreate.\n      setStatus('error', err instanceof Error ? err : new Error(String(err)));\n      return;\n    }\n    if (destroyed) return;\n    if (scheduledRefresh) {\n      teardownProvider();\n    }\n    accessType = grant.access_type;\n\n    const nextProvider = new WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {\n      params: {\n        yauth: grant.token,\n        branch: grant.branch,\n        gc: 'true',\n      },\n      // BroadcastChannel would sync same-origin clients locally, bypassing the\n      // server's permission enforcement (a read-only tab could write into an\n      // editor tab's doc). Permissioned docs must round-trip the server.\n      disableBc: true,\n    });\n    provider = nextProvider;\n\n    nextProvider.on('status', (event: { status: 'connecting' | 'connected' | 'disconnected' }) => {\n      if (provider !== nextProvider) return;\n      if (event.status === 'connected') {\n        consecutiveRemints = 0;\n      }\n      setStatus(event.status);\n      if (event.status === 'connected' && lastPresence !== null) {\n        nextProvider.awareness.setLocalState(lastPresence);\n      }\n    });\n\n    nextProvider.on('sync', (state: boolean) => {\n      if (provider !== nextProvider) return;\n      if (synced !== state) {\n        synced = state;\n        notify();\n      }\n    });\n\n    nextProvider.on('connection-close', (event: CloseEvent | null) => {\n      if (provider !== nextProvider) return;\n      const action = classifyClose(event?.code);\n      if (action === 'remint') {\n        // Revoked mid-session: a fresh mint re-runs the server-side permission\n        // check. If access is truly gone the mint 403s and we land in 'error'.\n        // Bounded: repeated 4401s without an intervening successful connect\n        // mean the server keeps rejecting freshly minted tokens — stop rather\n        // than loop mint→connect→kick.\n        consecutiveRemints += 1;\n        teardownProvider();\n        if (consecutiveRemints > MAX_CONSECUTIVE_REMINTS) {\n          setStatus(\n            'closed',\n            new Error('Access repeatedly revoked mid-session (4401); giving up.')\n          );\n          return;\n        }\n        void connect();\n      } else if (action === 'stop') {\n        teardownProvider();\n        setStatus(\n          'closed',\n          new Error(`Connection closed permanently (code ${event?.code ?? 'unknown'})`)\n        );\n      }\n      // 'retry': the provider's exponential backoff handles it.\n    });\n\n    nextProvider.awareness.on('change', () => {\n      if (provider !== nextProvider) return;\n      notify();\n    });\n\n    scheduleRefresh(grant);\n  };\n\n  void connect();\n\n  const waitForSync = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const terminal = (): Error | null => {\n        if (destroyed) return new Error('Handle destroyed before initial sync');\n        if (status === 'closed' || status === 'error') {\n          return error ?? new Error(`Connection ${status} before initial sync`);\n        }\n        return null;\n      };\n      if (synced) {\n        resolve();\n        return;\n      }\n      const immediate = terminal();\n      if (immediate) {\n        reject(immediate);\n        return;\n      }\n      const cleanup = () => {\n        clearTimeout(timer);\n        listeners.delete(listener);\n      };\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(new Error(`Timed out after ${timeoutMs}ms waiting for initial sync`));\n      }, timeoutMs);\n      const listener = () => {\n        if (synced) {\n          cleanup();\n          resolve();\n          return;\n        }\n        const err = terminal();\n        if (err) {\n          cleanup();\n          reject(err);\n        }\n      };\n      listeners.add(listener);\n    });\n\n  return {\n    doc,\n    get status() {\n      return status;\n    },\n    get synced() {\n      return synced;\n    },\n    get accessType() {\n      return accessType;\n    },\n    get error() {\n      return error;\n    },\n    get version() {\n      return version;\n    },\n    waitForSync,\n    getPresence: () => {\n      if (!provider) return [];\n      const entries: PresenceEntry[] = [];\n      provider.awareness.getStates().forEach((state, clientId) => {\n        entries.push({ clientId, state: state as Record<string, unknown> });\n      });\n      return entries;\n    },\n    setPresence: (state) => {\n      lastPresence = state;\n      provider?.awareness.setLocalState(state);\n    },\n    refreshNow: () => connect({ scheduledRefresh: true }),\n    onChange: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      teardownProvider();\n      status = 'closed';\n      // Final notification so pending waitForSync callers reject instead of\n      // hanging on listeners that are about to be dropped.\n      for (const listener of [...listeners]) listener();\n      listeners.clear();\n      doc.destroy();\n    },\n  };\n}\n\nexport { CollabTokenError };\nexport type { CollabAuth, CollabTokenResponse };\n"],"names":["Y","mintCollabToken","WebsocketProvider","classifyClose"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsEA,MAAM,sBAAsB,IAAI,KAAK;AACrC,MAAM,uBAAuB,KAAK;AAGlC,MAAM,0BAA0B;AAEzB,SAAS,kBAAkB,MAIb;AACnB,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,MAAM,IAAIA,aAAE,IAAA;AAClB,QAAM,gCAAgB,IAAA;AAEtB,MAAI,WAAqC;AACzC,MAAI,eAAqD;AACzD,MAAI,YAAY;AAChB,MAAI,SAA2B;AAC/B,MAAI,SAAS;AACb,MAAI,aAAgC;AACpC,MAAI,QAAsB;AAC1B,MAAI,eAA+C;AACnD,MAAI,UAAU;AACd,MAAI,qBAAqB;AAEzB,QAAM,SAAS,MAAM;AACnB,eAAW;AACX,eAAW,YAAY,UAAW,UAAA;AAAA,EACpC;AAEA,QAAM,YAAY,CAAC,MAAwB,MAAoB,SAAS;AACtE,QAAI,aAAa,SAAS,SAAU;AACpC,aAAS;AACT,YAAQ;AACR,WAAA;AAAA,EACF;AAEA,QAAM,oBAAoB,MAAM;AAC9B,QAAI,iBAAiB,MAAM;AACzB,mBAAa,YAAY;AACzB,qBAAe;AAAA,IACjB;AAAA,EACF;AAEA,QAAM,mBAAmB,MAAM;AAC7B,sBAAA;AAKA,QAAI,QAAQ;AACV,eAAS;AACT,aAAA;AAAA,IACF;AACA,QAAI,UAAU;AACZ,eAAS,QAAA;AACT,iBAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,kBAAkB,CAAC,UAA+B;AACtD,sBAAA;AACA,UAAM,QAAQ,KAAK;AAAA,MACjB,MAAM,gBAAgB,KAAK,IAAA,IAAQ;AAAA,MACnC;AAAA,IAAA;AAEF,mBAAe,WAAW,MAAM;AAC9B,WAAK,QAAQ,EAAE,kBAAkB,MAAM;AAAA,IACzC,GAAG,KAAK;AAAA,EACV;AAEA,QAAM,UAAU,OAAO,SAAyD;AAC9E,QAAI,UAAW;AACf,UAAM,oBAAmB,6BAAM,sBAAqB;AAIpD,QAAI,CAAC,kBAAkB;AACrB,uBAAA;AAAA,IACF,OAAO;AACL,wBAAA;AAAA,IACF;AACA,QAAI;AACJ,QAAI;AACF,cAAQ,MAAMC,KAAAA,gBAAgB,EAAE,MAAM,KAAK,MAAM,SAAS,KAAK,SAAS,QAAQ;AAAA,IAClF,SAAS,KAAK;AACZ,UAAI,oBAAoB,CAAC,WAAW;AAClC,uBAAe,WAAW,MAAM;AAC9B,eAAK,QAAQ,EAAE,kBAAkB,MAAM;AAAA,QACzC,GAAG,oBAAoB;AACvB;AAAA,MACF;AAIA,gBAAU,SAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AACtE;AAAA,IACF;AACA,QAAI,UAAW;AACf,QAAI,kBAAkB;AACpB,uBAAA;AAAA,IACF;AACA,iBAAa,MAAM;AAEnB,UAAM,eAAe,IAAIC,UAAAA,kBAAkB,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,MAAM,MAAM,IAAI,KAAK;AAAA,MAC5F,QAAQ;AAAA,QACN,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,QACd,IAAI;AAAA,MAAA;AAAA;AAAA;AAAA;AAAA,MAKN,WAAW;AAAA,IAAA,CACZ;AACD,eAAW;AAEX,iBAAa,GAAG,UAAU,CAAC,UAAmE;AAC5F,UAAI,aAAa,aAAc;AAC/B,UAAI,MAAM,WAAW,aAAa;AAChC,6BAAqB;AAAA,MACvB;AACA,gBAAU,MAAM,MAAM;AACtB,UAAI,MAAM,WAAW,eAAe,iBAAiB,MAAM;AACzD,qBAAa,UAAU,cAAc,YAAY;AAAA,MACnD;AAAA,IACF,CAAC;AAED,iBAAa,GAAG,QAAQ,CAAC,UAAmB;AAC1C,UAAI,aAAa,aAAc;AAC/B,UAAI,WAAW,OAAO;AACpB,iBAAS;AACT,eAAA;AAAA,MACF;AAAA,IACF,CAAC;AAED,iBAAa,GAAG,oBAAoB,CAAC,UAA6B;AAChE,UAAI,aAAa,aAAc;AAC/B,YAAM,SAASC,YAAAA,cAAc,+BAAO,IAAI;AACxC,UAAI,WAAW,UAAU;AAMvB,8BAAsB;AACtB,yBAAA;AACA,YAAI,qBAAqB,yBAAyB;AAChD;AAAA,YACE;AAAA,YACA,IAAI,MAAM,0DAA0D;AAAA,UAAA;AAEtE;AAAA,QACF;AACA,aAAK,QAAA;AAAA,MACP,WAAW,WAAW,QAAQ;AAC5B,yBAAA;AACA;AAAA,UACE;AAAA,UACA,IAAI,MAAM,wCAAuC,+BAAO,SAAQ,SAAS,GAAG;AAAA,QAAA;AAAA,MAEhF;AAAA,IAEF,CAAC;AAED,iBAAa,UAAU,GAAG,UAAU,MAAM;AACxC,UAAI,aAAa,aAAc;AAC/B,aAAA;AAAA,IACF,CAAC;AAED,oBAAgB,KAAK;AAAA,EACvB;AAEA,OAAK,QAAA;AAEL,QAAM,cAAc,CAAC,YAAY,SAC/B,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,UAAM,WAAW,MAAoB;AACnC,UAAI,UAAW,QAAO,IAAI,MAAM,sCAAsC;AACtE,UAAI,WAAW,YAAY,WAAW,SAAS;AAC7C,eAAO,SAAS,IAAI,MAAM,cAAc,MAAM,sBAAsB;AAAA,MACtE;AACA,aAAO;AAAA,IACT;AACA,QAAI,QAAQ;AACV,cAAA;AACA;AAAA,IACF;AACA,UAAM,YAAY,SAAA;AAClB,QAAI,WAAW;AACb,aAAO,SAAS;AAChB;AAAA,IACF;AACA,UAAM,UAAU,MAAM;AACpB,mBAAa,KAAK;AAClB,gBAAU,OAAO,QAAQ;AAAA,IAC3B;AACA,UAAM,QAAQ,WAAW,MAAM;AAC7B,cAAA;AACA,aAAO,IAAI,MAAM,mBAAmB,SAAS,6BAA6B,CAAC;AAAA,IAC7E,GAAG,SAAS;AACZ,UAAM,WAAW,MAAM;AACrB,UAAI,QAAQ;AACV,gBAAA;AACA,gBAAA;AACA;AAAA,MACF;AACA,YAAM,MAAM,SAAA;AACZ,UAAI,KAAK;AACP,gBAAA;AACA,eAAO,GAAG;AAAA,MACZ;AAAA,IACF;AACA,cAAU,IAAI,QAAQ;AAAA,EACxB,CAAC;AAEH,SAAO;AAAA,IACL;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,aAAa;AACf,aAAO;AAAA,IACT;AAAA,IACA,IAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAAA,IACA,IAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAAA,IACA;AAAA,IACA,aAAa,MAAM;AACjB,UAAI,CAAC,SAAU,QAAO,CAAA;AACtB,YAAM,UAA2B,CAAA;AACjC,eAAS,UAAU,UAAA,EAAY,QAAQ,CAAC,OAAO,aAAa;AAC1D,gBAAQ,KAAK,EAAE,UAAU,MAAA,CAAyC;AAAA,MACpE,CAAC;AACD,aAAO;AAAA,IACT;AAAA,IACA,aAAa,CAAC,UAAU;AACtB,qBAAe;AACf,2CAAU,UAAU,cAAc;AAAA,IACpC;AAAA,IACA,YAAY,MAAM,QAAQ,EAAE,kBAAkB,MAAM;AAAA,IACpD,UAAU,CAAC,aAAa;AACtB,gBAAU,IAAI,QAAQ;AACtB,aAAO,MAAM;AACX,kBAAU,OAAO,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,IACA,SAAS,MAAM;AACb,UAAI,UAAW;AACf,kBAAY;AACZ,uBAAA;AACA,eAAS;AAGT,iBAAW,YAAY,CAAC,GAAG,SAAS,EAAG,UAAA;AACvC,gBAAU,MAAA;AACV,UAAI,QAAA;AAAA,IACN;AAAA,EAAA;AAEJ;;;"}

package/dist/{collab.js → collab/client.js}

@@ -1,68 +1,8 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { WebsocketProvider } from "@y/websocket";
 import * as Y from "@y/y";
-import { useState, useRef, useEffect, useMemo, useSyncExternalStore } from "react";
-import { u as useAthenaConfig } from "./AthenaContext-MOslgOmE.js";
-const WS_CLOSE_AUTH_REVOKED = 4401;
-const WS_CLOSE_DOC_DELETED = 4404;
-function classifyClose(code) {
-  if (code === void 0) return "retry";
-  if (code === WS_CLOSE_AUTH_REVOKED) return "remint";
-  if (code >= 4400 && code < 4500) return "stop";
-  return "retry";
-}
-class CollabTokenError extends Error {
-  constructor(status, message) {
-    super(message);
-    __publicField(this, "status");
-    this.name = "CollabTokenError";
-    this.status = status;
-  }
-}
-function getAuthHeaders(auth) {
-  if (auth.token) {
-    return { Authorization: `Bearer ${auth.token}` };
-  }
-  if (auth.apiKey) {
-    return { "X-API-KEY": auth.apiKey };
-  }
-  return {};
-}
-function getAthenaApiBaseUrl(backendUrl) {
-  return backendUrl.replace(/\/api\/assistant-ui\/?$/, "").replace(/\/api\/v0\/?$/, "").replace(/\/$/, "");
-}
-async function mintCollabToken(args) {
-  const base = getAthenaApiBaseUrl(args.auth.backendUrl);
-  const response = await fetch(
-    `${base}/api/v0/assets/${encodeURIComponent(args.assetId)}/collab-token`,
-    {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...getAuthHeaders(args.auth)
-      },
-      body: JSON.stringify({ access: args.access }),
-      signal: args.signal
-    }
-  );
-  if (!response.ok) {
-    let detail = "";
-    try {
-      const body = await response.json();
-      if (body && typeof body === "object" && "detail" in body) {
-        detail = String(body.detail);
-      }
-    } catch {
-    }
-    throw new CollabTokenError(
-      response.status,
-      detail || `Collab token mint failed with status ${response.status}`
-    );
-  }
-  return await response.json();
-}
+import { classifyClose } from "./close-policy.js";
+import { mintCollabToken } from "./mint.js";
+import { CollabTokenError } from "./mint.js";
 const REFRESH_HEADROOM_MS = 5 * 60 * 1e3;
 const MIN_REFRESH_DELAY_MS = 30 * 1e3;
 const MAX_CONSECUTIVE_REMINTS = 2;
@@ -288,107 +228,8 @@ function connectGenericDoc(args) {
     }
   };
 }
-function useGenericDoc(assetId, options) {
-  const config = useAthenaConfig();
-  const access = (options == null ? void 0 : options.access) ?? "view";
-  const [handle, setHandle] = useState(null);
-  const handleRef = useRef(null);
-  useEffect(() => {
-    const next = connectGenericDoc({
-      assetId,
-      access,
-      auth: {
-        backendUrl: config.backendUrl,
-        apiKey: config.apiKey,
-        token: config.token
-      }
-    });
-    handleRef.current = next;
-    setHandle(next);
-    return () => {
-      handleRef.current = null;
-      next.destroy();
-    };
-  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);
-  const subscribe = useMemo(() => {
-    return (onStoreChange) => {
-      if (!handle) return () => {
-      };
-      return handle.onChange(onStoreChange);
-    };
-  }, [handle]);
-  useSyncExternalStore(
-    subscribe,
-    () => {
-      if (!handle) return EMPTY_SNAPSHOT;
-      return `${handle.status}|${handle.synced}|${handle.accessType ?? ""}|${handle.version}`;
-    },
-    () => EMPTY_SNAPSHOT
-  );
-  return {
-    doc: (handle == null ? void 0 : handle.doc) ?? null,
-    status: (handle == null ? void 0 : handle.status) ?? "connecting",
-    synced: (handle == null ? void 0 : handle.synced) ?? false,
-    accessType: (handle == null ? void 0 : handle.accessType) ?? null,
-    error: (handle == null ? void 0 : handle.error) ?? null,
-    presence: (handle == null ? void 0 : handle.getPresence()) ?? [],
-    setPresence: (state) => {
-      var _a;
-      return (_a = handleRef.current) == null ? void 0 : _a.setPresence(state);
-    }
-  };
-}
-const EMPTY_SNAPSHOT = "init|false||0";
-function defineDocShape(shape) {
-  const keys = Object.keys(shape);
-  return {
-    shape,
-    bind(doc) {
-      const toJSON = () => {
-        const out = {};
-        for (const key of keys) {
-          out[key] = doc.get(key).toJSON();
-        }
-        return out;
-      };
-      return {
-        get: (key) => doc.get(key),
-        toJSON,
-        subscribe: (listener) => {
-          let scheduled = false;
-          const emit = () => {
-            scheduled = false;
-            listener(toJSON());
-          };
-          const onDeepChange = () => {
-            if (scheduled) return;
-            scheduled = true;
-            queueMicrotask(emit);
-          };
-          const roots = keys.map((key) => doc.get(key));
-          for (const root of roots) {
-            root.observeDeep(onDeepChange);
-          }
-          listener(toJSON());
-          return () => {
-            for (const root of roots) {
-              root.unobserveDeep(onDeepChange);
-            }
-          };
-        }
-      };
-    }
-  };
-}
 export {
   CollabTokenError,
-  WS_CLOSE_AUTH_REVOKED,
-  WS_CLOSE_DOC_DELETED,
-  classifyClose,
-  connectGenericDoc,
-  defineDocShape,
-  getAthenaApiBaseUrl,
-  mintCollabToken,
-  useGenericDoc
+  connectGenericDoc
 };
-//# sourceMappingURL=collab.js.map
+//# sourceMappingURL=client.js.map

package/dist/collab/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../../src/collab/client.ts"],"sourcesContent":["/**\n * Vanilla (framework-agnostic) live client for Generic Doc assets.\n *\n * `connectGenericDoc` owns the full connection lifecycle: mint a room-bound\n * token via the public API, open the Keryx WebSocket with the v14 provider\n * (`@y/websocket` + `@y/y`), re-mint before expiry, apply the close-code\n * policy (4401 → one fresh mint, other 44xx → permanent stop, everything\n * else → provider backoff), and expose presence from awareness. React apps\n * use `useGenericDoc` from `@athenaintel/react/collab` instead of calling\n * this directly.\n */\n\nimport { WebsocketProvider } from '@y/websocket';\nimport * as Y from '@y/y';\nimport { classifyClose } from './close-policy';\nimport {\n  type CollabAuth,\n  type CollabTokenResponse,\n  CollabTokenError,\n  mintCollabToken,\n} from './mint';\n\nexport type GenericDocStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'closed'\n  | 'error';\n\nexport interface PresenceEntry {\n  clientId: number;\n  state: Record<string, unknown>;\n}\n\nexport interface GenericDocHandle {\n  /** The live shared document. Owned by the handle; destroyed with it. */\n  readonly doc: Y.Doc;\n  readonly status: GenericDocStatus;\n  /**\n   * Whether the initial server sync has completed for the current connection.\n   * `status === 'connected'` fires before the server state arrives, so a doc\n   * read immediately after connect can still be empty — gate first reads on\n   * this (or `waitForSync`).\n   */\n  readonly synced: boolean;\n  /** Granted access from the last successful mint. */\n  readonly accessType: 'r' | 'rw' | null;\n  /** Terminal error, when status is 'error' or 'closed'. */\n  readonly error: Error | null;\n  /** Monotonic change counter — bumps on every status/presence notification. */\n  readonly version: number;\n  /**\n   * Resolve once the initial server sync completes; reject on timeout, on a\n   * terminal connection state, or if the handle is destroyed first.\n   */\n  waitForSync: (timeoutMs?: number) => Promise<void>;\n  getPresence: () => PresenceEntry[];\n  /** Broadcast this client's presence state (requires a live connection). */\n  setPresence: (state: Record<string, unknown> | null) => void;\n  /**\n   * Force an early token refresh. Session-preserving: the live connection\n   * stays up until the fresh token is minted; a failed mint retries on a\n   * short timer instead of dropping the session.\n   */\n  refreshNow: () => Promise<void>;\n  onChange: (listener: () => void) => () => void;\n  destroy: () => void;\n}\n\n/** Re-mint this long before token expiry (clamped to a floor for short TTLs). */\nconst REFRESH_HEADROOM_MS = 5 * 60 * 1000;\nconst MIN_REFRESH_DELAY_MS = 30 * 1000;\n\n/** Consecutive 4401→mint cycles allowed without a successful connect between. */\nconst MAX_CONSECUTIVE_REMINTS = 2;\n\nexport function connectGenericDoc(args: {\n  assetId: string;\n  auth: CollabAuth;\n  access?: 'view' | 'edit';\n}): GenericDocHandle {\n  const access = args.access ?? 'view';\n  const doc = new Y.Doc();\n  const listeners = new Set<() => void>();\n\n  let provider: WebsocketProvider | null = null;\n  let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n  let destroyed = false;\n  let status: GenericDocStatus = 'connecting';\n  let synced = false;\n  let accessType: 'r' | 'rw' | null = null;\n  let error: Error | null = null;\n  let lastPresence: Record<string, unknown> | null = null;\n  let version = 0;\n  let consecutiveRemints = 0;\n\n  const notify = () => {\n    version += 1;\n    for (const listener of listeners) listener();\n  };\n\n  const setStatus = (next: GenericDocStatus, err: Error | null = null) => {\n    if (destroyed && next !== 'closed') return;\n    status = next;\n    error = err;\n    notify();\n  };\n\n  const clearRefreshTimer = () => {\n    if (refreshTimer !== null) {\n      clearTimeout(refreshTimer);\n      refreshTimer = null;\n    }\n  };\n\n  const teardownProvider = () => {\n    clearRefreshTimer();\n    // A future provider must complete its own initial sync; the doc keeps its\n    // content either way. Subscribers must observe the flip immediately —\n    // waiting for the next provider event would let them act on synced=true\n    // across the replacement gap.\n    if (synced) {\n      synced = false;\n      notify();\n    }\n    if (provider) {\n      provider.destroy();\n      provider = null;\n    }\n  };\n\n  const scheduleRefresh = (grant: CollabTokenResponse) => {\n    clearRefreshTimer();\n    const delay = Math.max(\n      grant.expires_at_ms - Date.now() - REFRESH_HEADROOM_MS,\n      MIN_REFRESH_DELAY_MS\n    );\n    refreshTimer = setTimeout(() => {\n      void connect({ scheduledRefresh: true });\n    }, delay);\n  };\n\n  const connect = async (opts?: { scheduledRefresh?: boolean }): Promise<void> => {\n    if (destroyed) return;\n    const scheduledRefresh = opts?.scheduledRefresh === true;\n    // A scheduled refresh mints FIRST and keeps the live session up: the old\n    // token has ~5 minutes of headroom, so a transient mint failure retries\n    // on a short timer instead of dropping a healthy connection.\n    if (!scheduledRefresh) {\n      teardownProvider();\n    } else {\n      clearRefreshTimer();\n    }\n    let grant: CollabTokenResponse;\n    try {\n      grant = await mintCollabToken({ auth: args.auth, assetId: args.assetId, access });\n    } catch (err) {\n      if (scheduledRefresh && !destroyed) {\n        refreshTimer = setTimeout(() => {\n          void connect({ scheduledRefresh: true });\n        }, MIN_REFRESH_DELAY_MS);\n        return;\n      }\n      // A denied mint is authoritative (revoked / not shared / not eligible);\n      // anything else (network) is worth telling the caller about too — the\n      // handle stays usable via a later explicit reconnect-by-recreate.\n      setStatus('error', err instanceof Error ? err : new Error(String(err)));\n      return;\n    }\n    if (destroyed) return;\n    if (scheduledRefresh) {\n      teardownProvider();\n    }\n    accessType = grant.access_type;\n\n    const nextProvider = new WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {\n      params: {\n        yauth: grant.token,\n        branch: grant.branch,\n        gc: 'true',\n      },\n      // BroadcastChannel would sync same-origin clients locally, bypassing the\n      // server's permission enforcement (a read-only tab could write into an\n      // editor tab's doc). Permissioned docs must round-trip the server.\n      disableBc: true,\n    });\n    provider = nextProvider;\n\n    nextProvider.on('status', (event: { status: 'connecting' | 'connected' | 'disconnected' }) => {\n      if (provider !== nextProvider) return;\n      if (event.status === 'connected') {\n        consecutiveRemints = 0;\n      }\n      setStatus(event.status);\n      if (event.status === 'connected' && lastPresence !== null) {\n        nextProvider.awareness.setLocalState(lastPresence);\n      }\n    });\n\n    nextProvider.on('sync', (state: boolean) => {\n      if (provider !== nextProvider) return;\n      if (synced !== state) {\n        synced = state;\n        notify();\n      }\n    });\n\n    nextProvider.on('connection-close', (event: CloseEvent | null) => {\n      if (provider !== nextProvider) return;\n      const action = classifyClose(event?.code);\n      if (action === 'remint') {\n        // Revoked mid-session: a fresh mint re-runs the server-side permission\n        // check. If access is truly gone the mint 403s and we land in 'error'.\n        // Bounded: repeated 4401s without an intervening successful connect\n        // mean the server keeps rejecting freshly minted tokens — stop rather\n        // than loop mint→connect→kick.\n        consecutiveRemints += 1;\n        teardownProvider();\n        if (consecutiveRemints > MAX_CONSECUTIVE_REMINTS) {\n          setStatus(\n            'closed',\n            new Error('Access repeatedly revoked mid-session (4401); giving up.')\n          );\n          return;\n        }\n        void connect();\n      } else if (action === 'stop') {\n        teardownProvider();\n        setStatus(\n          'closed',\n          new Error(`Connection closed permanently (code ${event?.code ?? 'unknown'})`)\n        );\n      }\n      // 'retry': the provider's exponential backoff handles it.\n    });\n\n    nextProvider.awareness.on('change', () => {\n      if (provider !== nextProvider) return;\n      notify();\n    });\n\n    scheduleRefresh(grant);\n  };\n\n  void connect();\n\n  const waitForSync = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const terminal = (): Error | null => {\n        if (destroyed) return new Error('Handle destroyed before initial sync');\n        if (status === 'closed' || status === 'error') {\n          return error ?? new Error(`Connection ${status} before initial sync`);\n        }\n        return null;\n      };\n      if (synced) {\n        resolve();\n        return;\n      }\n      const immediate = terminal();\n      if (immediate) {\n        reject(immediate);\n        return;\n      }\n      const cleanup = () => {\n        clearTimeout(timer);\n        listeners.delete(listener);\n      };\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(new Error(`Timed out after ${timeoutMs}ms waiting for initial sync`));\n      }, timeoutMs);\n      const listener = () => {\n        if (synced) {\n          cleanup();\n          resolve();\n          return;\n        }\n        const err = terminal();\n        if (err) {\n          cleanup();\n          reject(err);\n        }\n      };\n      listeners.add(listener);\n    });\n\n  return {\n    doc,\n    get status() {\n      return status;\n    },\n    get synced() {\n      return synced;\n    },\n    get accessType() {\n      return accessType;\n    },\n    get error() {\n      return error;\n    },\n    get version() {\n      return version;\n    },\n    waitForSync,\n    getPresence: () => {\n      if (!provider) return [];\n      const entries: PresenceEntry[] = [];\n      provider.awareness.getStates().forEach((state, clientId) => {\n        entries.push({ clientId, state: state as Record<string, unknown> });\n      });\n      return entries;\n    },\n    setPresence: (state) => {\n      lastPresence = state;\n      provider?.awareness.setLocalState(state);\n    },\n    refreshNow: () => connect({ scheduledRefresh: true }),\n    onChange: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      teardownProvider();\n      status = 'closed';\n      // Final notification so pending waitForSync callers reject instead of\n      // hanging on listeners that are about to be dropped.\n      for (const listener of [...listeners]) listener();\n      listeners.clear();\n      doc.destroy();\n    },\n  };\n}\n\nexport { CollabTokenError };\nexport type { CollabAuth, CollabTokenResponse };\n"],"names":[],"mappings":";;;;;AAsEA,MAAM,sBAAsB,IAAI,KAAK;AACrC,MAAM,uBAAuB,KAAK;AAGlC,MAAM,0BAA0B;AAEzB,SAAS,kBAAkB,MAIb;AACnB,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,MAAM,IAAI,EAAE,IAAA;AAClB,QAAM,gCAAgB,IAAA;AAEtB,MAAI,WAAqC;AACzC,MAAI,eAAqD;AACzD,MAAI,YAAY;AAChB,MAAI,SAA2B;AAC/B,MAAI,SAAS;AACb,MAAI,aAAgC;AACpC,MAAI,QAAsB;AAC1B,MAAI,eAA+C;AACnD,MAAI,UAAU;AACd,MAAI,qBAAqB;AAEzB,QAAM,SAAS,MAAM;AACnB,eAAW;AACX,eAAW,YAAY,UAAW,UAAA;AAAA,EACpC;AAEA,QAAM,YAAY,CAAC,MAAwB,MAAoB,SAAS;AACtE,QAAI,aAAa,SAAS,SAAU;AACpC,aAAS;AACT,YAAQ;AACR,WAAA;AAAA,EACF;AAEA,QAAM,oBAAoB,MAAM;AAC9B,QAAI,iBAAiB,MAAM;AACzB,mBAAa,YAAY;AACzB,qBAAe;AAAA,IACjB;AAAA,EACF;AAEA,QAAM,mBAAmB,MAAM;AAC7B,sBAAA;AAKA,QAAI,QAAQ;AACV,eAAS;AACT,aAAA;AAAA,IACF;AACA,QAAI,UAAU;AACZ,eAAS,QAAA;AACT,iBAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,kBAAkB,CAAC,UAA+B;AACtD,sBAAA;AACA,UAAM,QAAQ,KAAK;AAAA,MACjB,MAAM,gBAAgB,KAAK,IAAA,IAAQ;AAAA,MACnC;AAAA,IAAA;AAEF,mBAAe,WAAW,MAAM;AAC9B,WAAK,QAAQ,EAAE,kBAAkB,MAAM;AAAA,IACzC,GAAG,KAAK;AAAA,EACV;AAEA,QAAM,UAAU,OAAO,SAAyD;AAC9E,QAAI,UAAW;AACf,UAAM,oBAAmB,6BAAM,sBAAqB;AAIpD,QAAI,CAAC,kBAAkB;AACrB,uBAAA;AAAA,IACF,OAAO;AACL,wBAAA;AAAA,IACF;AACA,QAAI;AACJ,QAAI;AACF,cAAQ,MAAM,gBAAgB,EAAE,MAAM,KAAK,MAAM,SAAS,KAAK,SAAS,QAAQ;AAAA,IAClF,SAAS,KAAK;AACZ,UAAI,oBAAoB,CAAC,WAAW;AAClC,uBAAe,WAAW,MAAM;AAC9B,eAAK,QAAQ,EAAE,kBAAkB,MAAM;AAAA,QACzC,GAAG,oBAAoB;AACvB;AAAA,MACF;AAIA,gBAAU,SAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AACtE;AAAA,IACF;AACA,QAAI,UAAW;AACf,QAAI,kBAAkB;AACpB,uBAAA;AAAA,IACF;AACA,iBAAa,MAAM;AAEnB,UAAM,eAAe,IAAI,kBAAkB,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,MAAM,MAAM,IAAI,KAAK;AAAA,MAC5F,QAAQ;AAAA,QACN,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,QACd,IAAI;AAAA,MAAA;AAAA;AAAA;AAAA;AAAA,MAKN,WAAW;AAAA,IAAA,CACZ;AACD,eAAW;AAEX,iBAAa,GAAG,UAAU,CAAC,UAAmE;AAC5F,UAAI,aAAa,aAAc;AAC/B,UAAI,MAAM,WAAW,aAAa;AAChC,6BAAqB;AAAA,MACvB;AACA,gBAAU,MAAM,MAAM;AACtB,UAAI,MAAM,WAAW,eAAe,iBAAiB,MAAM;AACzD,qBAAa,UAAU,cAAc,YAAY;AAAA,MACnD;AAAA,IACF,CAAC;AAED,iBAAa,GAAG,QAAQ,CAAC,UAAmB;AAC1C,UAAI,aAAa,aAAc;AAC/B,UAAI,WAAW,OAAO;AACpB,iBAAS;AACT,eAAA;AAAA,MACF;AAAA,IACF,CAAC;AAED,iBAAa,GAAG,oBAAoB,CAAC,UAA6B;AAChE,UAAI,aAAa,aAAc;AAC/B,YAAM,SAAS,cAAc,+BAAO,IAAI;AACxC,UAAI,WAAW,UAAU;AAMvB,8BAAsB;AACtB,yBAAA;AACA,YAAI,qBAAqB,yBAAyB;AAChD;AAAA,YACE;AAAA,YACA,IAAI,MAAM,0DAA0D;AAAA,UAAA;AAEtE;AAAA,QACF;AACA,aAAK,QAAA;AAAA,MACP,WAAW,WAAW,QAAQ;AAC5B,yBAAA;AACA;AAAA,UACE;AAAA,UACA,IAAI,MAAM,wCAAuC,+BAAO,SAAQ,SAAS,GAAG;AAAA,QAAA;AAAA,MAEhF;AAAA,IAEF,CAAC;AAED,iBAAa,UAAU,GAAG,UAAU,MAAM;AACxC,UAAI,aAAa,aAAc;AAC/B,aAAA;AAAA,IACF,CAAC;AAED,oBAAgB,KAAK;AAAA,EACvB;AAEA,OAAK,QAAA;AAEL,QAAM,cAAc,CAAC,YAAY,SAC/B,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,UAAM,WAAW,MAAoB;AACnC,UAAI,UAAW,QAAO,IAAI,MAAM,sCAAsC;AACtE,UAAI,WAAW,YAAY,WAAW,SAAS;AAC7C,eAAO,SAAS,IAAI,MAAM,cAAc,MAAM,sBAAsB;AAAA,MACtE;AACA,aAAO;AAAA,IACT;AACA,QAAI,QAAQ;AACV,cAAA;AACA;AAAA,IACF;AACA,UAAM,YAAY,SAAA;AAClB,QAAI,WAAW;AACb,aAAO,SAAS;AAChB;AAAA,IACF;AACA,UAAM,UAAU,MAAM;AACpB,mBAAa,KAAK;AAClB,gBAAU,OAAO,QAAQ;AAAA,IAC3B;AACA,UAAM,QAAQ,WAAW,MAAM;AAC7B,cAAA;AACA,aAAO,IAAI,MAAM,mBAAmB,SAAS,6BAA6B,CAAC;AAAA,IAC7E,GAAG,SAAS;AACZ,UAAM,WAAW,MAAM;AACrB,UAAI,QAAQ;AACV,gBAAA;AACA,gBAAA;AACA;AAAA,MACF;AACA,YAAM,MAAM,SAAA;AACZ,UAAI,KAAK;AACP,gBAAA;AACA,eAAO,GAAG;AAAA,MACZ;AAAA,IACF;AACA,cAAU,IAAI,QAAQ;AAAA,EACxB,CAAC;AAEH,SAAO;AAAA,IACL;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,aAAa;AACf,aAAO;AAAA,IACT;AAAA,IACA,IAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAAA,IACA,IAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAAA,IACA;AAAA,IACA,aAAa,MAAM;AACjB,UAAI,CAAC,SAAU,QAAO,CAAA;AACtB,YAAM,UAA2B,CAAA;AACjC,eAAS,UAAU,UAAA,EAAY,QAAQ,CAAC,OAAO,aAAa;AAC1D,gBAAQ,KAAK,EAAE,UAAU,MAAA,CAAyC;AAAA,MACpE,CAAC;AACD,aAAO;AAAA,IACT;AAAA,IACA,aAAa,CAAC,UAAU;AACtB,qBAAe;AACf,2CAAU,UAAU,cAAc;AAAA,IACpC;AAAA,IACA,YAAY,MAAM,QAAQ,EAAE,kBAAkB,MAAM;AAAA,IACpD,UAAU,CAAC,aAAa;AACtB,gBAAU,IAAI,QAAQ;AACtB,aAAO,MAAM;AACX,kBAAU,OAAO,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,IACA,SAAS,MAAM;AACb,UAAI,UAAW;AACf,kBAAY;AACZ,uBAAA;AACA,eAAS;AAGT,iBAAW,YAAY,CAAC,GAAG,SAAS,EAAG,UAAA;AACvC,gBAAU,MAAA;AACV,UAAI,QAAA;AAAA,IACN;AAAA,EAAA;AAEJ;"}

package/dist/collab/close-policy.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const WS_CLOSE_AUTH_REVOKED = 4401;
+const WS_CLOSE_DOC_DELETED = 4404;
+function classifyClose(code) {
+  if (code === void 0) return "retry";
+  if (code === WS_CLOSE_AUTH_REVOKED) return "remint";
+  if (code >= 4400 && code < 4500) return "stop";
+  return "retry";
+}
+exports.WS_CLOSE_AUTH_REVOKED = WS_CLOSE_AUTH_REVOKED;
+exports.WS_CLOSE_DOC_DELETED = WS_CLOSE_DOC_DELETED;
+exports.classifyClose = classifyClose;
+//# sourceMappingURL=close-policy.cjs.map

package/dist/collab/close-policy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-policy.cjs","sources":["../../src/collab/close-policy.ts"],"sourcesContent":["/**\n * Keryx WebSocket close-code policy.\n *\n * Keryx (@y/hub) encodes retry semantics in close codes: 4400–4499 are\n * permanent application errors — the client must stop reconnecting until the\n * app acts — while everything else is transient and left to the provider's\n * exponential backoff. Two permanent codes carry specific meaning:\n *\n * - 4401 \"permission revoked\": the token was rejected mid-session (access\n *   revoked, permissions changed, or the token aged out server-side). The\n *   right response is one fresh mint — which re-runs the server-side\n *   permission check — and a reconnect only if the mint succeeds.\n * - 4404 \"document deleted\": permanent; the document is not coming back.\n */\n\nexport const WS_CLOSE_AUTH_REVOKED = 4401;\nexport const WS_CLOSE_DOC_DELETED = 4404;\n\nexport type CloseAction = 'remint' | 'stop' | 'retry';\n\nexport function classifyClose(code: number | undefined): CloseAction {\n  if (code === undefined) return 'retry';\n  if (code === WS_CLOSE_AUTH_REVOKED) return 'remint';\n  if (code >= 4400 && code < 4500) return 'stop';\n  return 'retry';\n}\n"],"names":[],"mappings":";;AAeO,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAI7B,SAAS,cAAc,MAAuC;AACnE,MAAI,SAAS,OAAW,QAAO;AAC/B,MAAI,SAAS,sBAAuB,QAAO;AAC3C,MAAI,QAAQ,QAAQ,OAAO,KAAM,QAAO;AACxC,SAAO;AACT;;;;"}

package/dist/collab/close-policy.js

@@ -0,0 +1,14 @@
+const WS_CLOSE_AUTH_REVOKED = 4401;
+const WS_CLOSE_DOC_DELETED = 4404;
+function classifyClose(code) {
+  if (code === void 0) return "retry";
+  if (code === WS_CLOSE_AUTH_REVOKED) return "remint";
+  if (code >= 4400 && code < 4500) return "stop";
+  return "retry";
+}
+export {
+  WS_CLOSE_AUTH_REVOKED,
+  WS_CLOSE_DOC_DELETED,
+  classifyClose
+};
+//# sourceMappingURL=close-policy.js.map

package/dist/collab/close-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-policy.js","sources":["../../src/collab/close-policy.ts"],"sourcesContent":["/**\n * Keryx WebSocket close-code policy.\n *\n * Keryx (@y/hub) encodes retry semantics in close codes: 4400–4499 are\n * permanent application errors — the client must stop reconnecting until the\n * app acts — while everything else is transient and left to the provider's\n * exponential backoff. Two permanent codes carry specific meaning:\n *\n * - 4401 \"permission revoked\": the token was rejected mid-session (access\n *   revoked, permissions changed, or the token aged out server-side). The\n *   right response is one fresh mint — which re-runs the server-side\n *   permission check — and a reconnect only if the mint succeeds.\n * - 4404 \"document deleted\": permanent; the document is not coming back.\n */\n\nexport const WS_CLOSE_AUTH_REVOKED = 4401;\nexport const WS_CLOSE_DOC_DELETED = 4404;\n\nexport type CloseAction = 'remint' | 'stop' | 'retry';\n\nexport function classifyClose(code: number | undefined): CloseAction {\n  if (code === undefined) return 'retry';\n  if (code === WS_CLOSE_AUTH_REVOKED) return 'remint';\n  if (code >= 4400 && code < 4500) return 'stop';\n  return 'retry';\n}\n"],"names":[],"mappings":"AAeO,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAI7B,SAAS,cAAc,MAAuC;AACnE,MAAI,SAAS,OAAW,QAAO;AAC/B,MAAI,SAAS,sBAAuB,QAAO;AAC3C,MAAI,QAAQ,QAAQ,OAAO,KAAM,QAAO;AACxC,SAAO;AACT;"}