@arbidocs/react 0.5.111 → 0.5.113

package/dist/viewers/usePageIntersectionObserver.js

@@ -0,0 +1,68 @@
+import { useEffect, useRef } from "react";
+import { measureVisiblePages } from "./page-scroll.js";
+const PAGE_UPDATE_DEBOUNCE_MS = 10;
+const MIN_VISIBILITY_THRESHOLD = 0.15;
+const INTERSECTION_THRESHOLDS = [0, 0.25, 0.5, 0.75, 1];
+function usePageIntersectionObserver({
+  containerRef,
+  scrollCompleteRef,
+  isEnabled,
+  getPageElements,
+  getPageNumber,
+  onPageChange,
+  onVisibilityUpdate,
+  observeKey
+}) {
+  const latest = useRef({ getPageElements, getPageNumber, onPageChange, onVisibilityUpdate });
+  latest.current = { getPageElements, getPageNumber, onPageChange, onVisibilityUpdate };
+  useEffect(() => {
+    if (!isEnabled || !containerRef.current) return;
+    const container = containerRef.current;
+    let lastReportedPage = null;
+    let updateTimeout = null;
+    let frame = 0;
+    const evaluate = () => {
+      const root = container.getBoundingClientRect();
+      const pages = [];
+      for (const el of latest.current.getPageElements()) {
+        const n = latest.current.getPageNumber(el);
+        if (n <= 0) continue;
+        const r = el.getBoundingClientRect();
+        pages.push({ n, top: r.top, bottom: r.bottom });
+      }
+      const { page, score, visibility } = measureVisiblePages(pages, root.top, root.bottom);
+      if (scrollCompleteRef.current && page !== null && page !== lastReportedPage && score > MIN_VISIBILITY_THRESHOLD) {
+        lastReportedPage = page;
+        latest.current.onPageChange(page);
+      }
+      latest.current.onVisibilityUpdate?.(visibility);
+    };
+    const observer = new IntersectionObserver(
+      () => {
+        if (updateTimeout) clearTimeout(updateTimeout);
+        updateTimeout = setTimeout(evaluate, PAGE_UPDATE_DEBOUNCE_MS);
+      },
+      { root: container, threshold: INTERSECTION_THRESHOLDS }
+    );
+    const onScroll = () => {
+      if (!frame) {
+        frame = requestAnimationFrame(() => {
+          frame = 0;
+          evaluate();
+        });
+      }
+    };
+    container.addEventListener("scroll", onScroll, { passive: true });
+    latest.current.getPageElements().forEach((element) => observer.observe(element));
+    return () => {
+      observer.disconnect();
+      container.removeEventListener("scroll", onScroll);
+      if (updateTimeout) clearTimeout(updateTimeout);
+      if (frame) cancelAnimationFrame(frame);
+    };
+  }, [containerRef, scrollCompleteRef, isEnabled, observeKey]);
+}
+export {
+  usePageIntersectionObserver
+};
+//# sourceMappingURL=usePageIntersectionObserver.js.map

package/dist/viewers/usePageIntersectionObserver.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/viewers/usePageIntersectionObserver.ts"],
+  "sourcesContent": ["import { useEffect, useRef, RefObject } from 'react'\nimport { measureVisiblePages, type PageBox } from './page-scroll'\n\n// Page synchronization constants\nconst PAGE_UPDATE_DEBOUNCE_MS = 10 // Delay before updating page number after scroll (10ms)\nconst MIN_VISIBILITY_THRESHOLD = 0.15 // Minimum visibility (15%) to consider page \"visible\"\nconst INTERSECTION_THRESHOLDS = [0, 0.25, 0.5, 0.75, 1.0] // IntersectionObserver thresholds\n\ninterface UsePageIntersectionObserverOptions {\n  /** Container element that scrolls */\n  containerRef: RefObject<HTMLElement | null>\n  /** Ref tracking whether initial scroll has completed */\n  scrollCompleteRef: RefObject<boolean>\n  /** Whether the observer should be active */\n  isEnabled: boolean\n  /** Function to get page elements to observe */\n  getPageElements: () => Element[]\n  /** Function to extract page number from element */\n  getPageNumber: (element: Element) => number\n  /** Callback when page number changes */\n  onPageChange: (pageNumber: number) => void\n  /** Optional callback with visibility data for custom logic (e.g., lazy loading) */\n  onVisibilityUpdate?: (visibilityMap: Map<number, number>) => void\n  /**\n   * Re-subscribe when this changes (the set of page elements: page count, first layout). Callers\n   * may pass fresh inline callbacks every render: they are read through refs and never cause a\n   * re-subscribe (a re-subscribe re-delivers every page and, with a state-setting callback, loops).\n   */\n  observeKey?: unknown\n}\n\n/**\n * Custom hook to track the visible page of a page-stacked viewer.\n * Used for bidirectional page synchronization in document viewers.\n *\n * IntersectionObserver wakes it when pages enter or leave the viewport; a passive scroll listener\n * (at most one measurement per frame) keeps it current in between. The page itself is chosen from\n * live geometry (see `measureVisiblePages`).\n */\nexport function usePageIntersectionObserver({\n  containerRef,\n  scrollCompleteRef,\n  isEnabled,\n  getPageElements,\n  getPageNumber,\n  onPageChange,\n  onVisibilityUpdate,\n  observeKey,\n}: UsePageIntersectionObserverOptions) {\n  const latest = useRef({ getPageElements, getPageNumber, onPageChange, onVisibilityUpdate })\n  latest.current = { getPageElements, getPageNumber, onPageChange, onVisibilityUpdate }\n\n  useEffect(() => {\n    if (!isEnabled || !containerRef.current) return\n\n    const container = containerRef.current\n    let lastReportedPage: number | null = null\n    let updateTimeout: ReturnType<typeof setTimeout> | null = null\n    let frame = 0\n\n    // Read the live geometry rather than IntersectionObserver ratios: a ratio is relative to the\n    // page's own height, so a zoomed page much taller than the screen never reaches the threshold\n    // (and ratios only update on a few crossings, which is too coarse for tall pages).\n    const evaluate = () => {\n      const root = container.getBoundingClientRect()\n      const pages: PageBox[] = []\n      for (const el of latest.current.getPageElements()) {\n        const n = latest.current.getPageNumber(el)\n        if (n <= 0) continue\n        const r = el.getBoundingClientRect()\n        pages.push({ n, top: r.top, bottom: r.bottom })\n      }\n      const { page, score, visibility } = measureVisiblePages(pages, root.top, root.bottom)\n\n      // Only report when the scroll is complete and the page changed\n      if (\n        scrollCompleteRef.current &&\n        page !== null &&\n        page !== lastReportedPage &&\n        score > MIN_VISIBILITY_THRESHOLD\n      ) {\n        lastReportedPage = page\n        latest.current.onPageChange(page)\n      }\n\n      // Call optional visibility update callback (e.g., for lazy loading)\n      latest.current.onVisibilityUpdate?.(visibility)\n    }\n\n    const observer = new IntersectionObserver(\n      () => {\n        // Debounce updates\n        if (updateTimeout) clearTimeout(updateTimeout)\n        updateTimeout = setTimeout(evaluate, PAGE_UPDATE_DEBOUNCE_MS)\n      },\n      { root: container, threshold: INTERSECTION_THRESHOLDS }\n    )\n    // At most one measurement per frame while scrolling; nothing is stored in React state here.\n    const onScroll = () => {\n      if (!frame) {\n        frame = requestAnimationFrame(() => {\n          frame = 0\n          evaluate()\n        })\n      }\n    }\n    container.addEventListener('scroll', onScroll, { passive: true })\n\n    // Observe all page elements\n    latest.current.getPageElements().forEach((element) => observer.observe(element))\n\n    return () => {\n      observer.disconnect()\n      container.removeEventListener('scroll', onScroll)\n      if (updateTimeout) clearTimeout(updateTimeout)\n      if (frame) cancelAnimationFrame(frame)\n    }\n  }, [containerRef, scrollCompleteRef, isEnabled, observeKey])\n}\n"],
+  "mappings": "AAAA,SAAS,WAAW,cAAyB;AAC7C,SAAS,2BAAyC;AAGlD,MAAM,0BAA0B;AAChC,MAAM,2BAA2B;AACjC,MAAM,0BAA0B,CAAC,GAAG,MAAM,KAAK,MAAM,CAAG;AAiCjD,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AACrC,QAAM,SAAS,OAAO,EAAE,iBAAiB,eAAe,cAAc,mBAAmB,CAAC;AAC1F,SAAO,UAAU,EAAE,iBAAiB,eAAe,cAAc,mBAAmB;AAEpF,YAAU,MAAM;AACd,QAAI,CAAC,aAAa,CAAC,aAAa,QAAS;AAEzC,UAAM,YAAY,aAAa;AAC/B,QAAI,mBAAkC;AACtC,QAAI,gBAAsD;AAC1D,QAAI,QAAQ;AAKZ,UAAM,WAAW,MAAM;AACrB,YAAM,OAAO,UAAU,sBAAsB;AAC7C,YAAM,QAAmB,CAAC;AAC1B,iBAAW,MAAM,OAAO,QAAQ,gBAAgB,GAAG;AACjD,cAAM,IAAI,OAAO,QAAQ,cAAc,EAAE;AACzC,YAAI,KAAK,EAAG;AACZ,cAAM,IAAI,GAAG,sBAAsB;AACnC,cAAM,KAAK,EAAE,GAAG,KAAK,EAAE,KAAK,QAAQ,EAAE,OAAO,CAAC;AAAA,MAChD;AACA,YAAM,EAAE,MAAM,OAAO,WAAW,IAAI,oBAAoB,OAAO,KAAK,KAAK,KAAK,MAAM;AAGpF,UACE,kBAAkB,WAClB,SAAS,QACT,SAAS,oBACT,QAAQ,0BACR;AACA,2BAAmB;AACnB,eAAO,QAAQ,aAAa,IAAI;AAAA,MAClC;AAGA,aAAO,QAAQ,qBAAqB,UAAU;AAAA,IAChD;AAEA,UAAM,WAAW,IAAI;AAAA,MACnB,MAAM;AAEJ,YAAI,cAAe,cAAa,aAAa;AAC7C,wBAAgB,WAAW,UAAU,uBAAuB;AAAA,MAC9D;AAAA,MACA,EAAE,MAAM,WAAW,WAAW,wBAAwB;AAAA,IACxD;AAEA,UAAM,WAAW,MAAM;AACrB,UAAI,CAAC,OAAO;AACV,gBAAQ,sBAAsB,MAAM;AAClC,kBAAQ;AACR,mBAAS;AAAA,QACX,CAAC;AAAA,MACH;AAAA,IACF;AACA,cAAU,iBAAiB,UAAU,UAAU,EAAE,SAAS,KAAK,CAAC;AAGhE,WAAO,QAAQ,gBAAgB,EAAE,QAAQ,CAAC,YAAY,SAAS,QAAQ,OAAO,CAAC;AAE/E,WAAO,MAAM;AACX,eAAS,WAAW;AACpB,gBAAU,oBAAoB,UAAU,QAAQ;AAChD,UAAI,cAAe,cAAa,aAAa;AAC7C,UAAI,MAAO,sBAAqB,KAAK;AAAA,IACvC;AAAA,EACF,GAAG,CAAC,cAAc,mBAAmB,WAAW,UAAU,CAAC;AAC7D;",
+  "names": []
+}

package/dist/viewers/useProcessedChunks.js

@@ -0,0 +1,58 @@
+import { useMemo } from "react";
+function inlineFootnotes(content, footnotes) {
+  if (!footnotes || Object.keys(footnotes).length === 0) return content;
+  let result = content;
+  result = result.replace(/^\[\^[^\]]+\]:[ \t]+.*(?:\n(?:[ \t]+.+)?)*/gm, "");
+  result = result.replace(/\[\^([^\]]+)\]/g, (_match, key) => {
+    const fnContent = footnotes[key];
+    if (!fnContent) return `<sup class="fn-ref">${key}</sup>`;
+    const escaped = fnContent.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+    return `<sup class="fn-ref">${key}</sup><span class="fn-inline" title="${escaped}">[${escaped}]</span>`;
+  });
+  return result.trim();
+}
+function useProcessedChunks(chunks, footnotes) {
+  return useMemo(() => {
+    if (!chunks || chunks.length === 0) {
+      return { processedChunks: [], maxPageNumber: 0 };
+    }
+    const hasFootnotes = footnotes && Object.keys(footnotes).length > 0;
+    const chunksByPage = [];
+    let currentPageNumber = -1;
+    let currentPageChunks = [];
+    let maxPageNumber = 0;
+    chunks.forEach((chunk) => {
+      const pageNum = chunk.metadata?.page_number;
+      if (pageNum && pageNum > maxPageNumber) {
+        maxPageNumber = pageNum;
+      }
+      if (pageNum !== currentPageNumber) {
+        if (currentPageChunks.length > 0) {
+          chunksByPage.push({
+            pageNumber: currentPageNumber > 0 ? currentPageNumber : null,
+            chunks: currentPageChunks
+          });
+        }
+        currentPageNumber = pageNum ?? -1;
+        currentPageChunks = [];
+      }
+      currentPageChunks.push({
+        content: hasFootnotes ? inlineFootnotes(chunk.content, footnotes) : chunk.content,
+        chunkIndex: chunk.metadata?.chunk_doc_idx,
+        chunkExtId: chunk.metadata?.chunk_ext_id,
+        docTitle: chunk.metadata?.doc_title ?? void 0
+      });
+    });
+    if (currentPageChunks.length > 0) {
+      chunksByPage.push({
+        pageNumber: currentPageNumber > 0 ? currentPageNumber : null,
+        chunks: currentPageChunks
+      });
+    }
+    return { processedChunks: chunksByPage, maxPageNumber };
+  }, [chunks, footnotes]);
+}
+export {
+  useProcessedChunks
+};
+//# sourceMappingURL=useProcessedChunks.js.map

package/dist/viewers/useProcessedChunks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/viewers/useProcessedChunks.ts"],
+  "sourcesContent": ["/**\n * Processed Chunks Hook\n *\n * Processes raw document chunks into page-grouped structure.\n * Pre-computes footnote inlining so it runs once during processing, not on every render.\n */\n\nimport { useMemo } from 'react'\n\nexport interface RawChunk {\n  content: string\n  metadata?: {\n    page_number?: number\n    chunk_doc_idx?: number\n    chunk_ext_id?: string\n    doc_title?: string | null\n  }\n}\n\nexport interface ProcessedChunk {\n  content: string\n  chunkIndex: number | undefined\n  chunkExtId: string | undefined\n  docTitle: string | undefined\n}\n\nexport interface ProcessedPage {\n  pageNumber: number | null\n  chunks: ProcessedChunk[]\n}\n\nexport interface UseProcessedChunksResult {\n  processedChunks: ProcessedPage[]\n  maxPageNumber: number\n}\n\n/**\n * Replace GFM footnote references [^key] with inline footnote content\n * and strip footnote definition blocks from the chunk text.\n * Uses the pre-parsed footnotes map from the backend.\n */\nfunction inlineFootnotes(content: string, footnotes: Record<string, string>): string {\n  if (!footnotes || Object.keys(footnotes).length === 0) return content\n\n  let result = content\n\n  // Strip GFM footnote definition blocks: [^key]: content (and continuation lines)\n  result = result.replace(/^\\[\\^[^\\]]+\\]:[ \\t]+.*(?:\\n(?:[ \\t]+.+)?)*/gm, '')\n\n  // Replace footnote references [^key] with superscript + inline content\n  result = result.replace(/\\[\\^([^\\]]+)\\]/g, (_match, key) => {\n    const fnContent = footnotes[key]\n    if (!fnContent) return `<sup class=\"fn-ref\">${key}</sup>`\n    const escaped = fnContent\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')\n      .replace(/>/g, '&gt;')\n      .replace(/\"/g, '&quot;')\n    return `<sup class=\"fn-ref\">${key}</sup><span class=\"fn-inline\" title=\"${escaped}\">[${escaped}]</span>`\n  })\n\n  return result.trim()\n}\n\nexport function useProcessedChunks(\n  chunks: RawChunk[] | undefined,\n  footnotes?: Record<string, string>\n): UseProcessedChunksResult {\n  return useMemo(() => {\n    if (!chunks || chunks.length === 0) {\n      return { processedChunks: [], maxPageNumber: 0 }\n    }\n\n    const hasFootnotes = footnotes && Object.keys(footnotes).length > 0\n    const chunksByPage: ProcessedPage[] = []\n    let currentPageNumber = -1\n    let currentPageChunks: ProcessedChunk[] = []\n    let maxPageNumber = 0\n\n    chunks.forEach((chunk) => {\n      const pageNum = chunk.metadata?.page_number\n\n      // Track max page number\n      if (pageNum && pageNum > maxPageNumber) {\n        maxPageNumber = pageNum\n      }\n\n      // If page changed, save previous page and start new one\n      if (pageNum !== currentPageNumber) {\n        if (currentPageChunks.length > 0) {\n          chunksByPage.push({\n            pageNumber: currentPageNumber > 0 ? currentPageNumber : null,\n            chunks: currentPageChunks,\n          })\n        }\n        currentPageNumber = pageNum ?? -1\n        currentPageChunks = []\n      }\n\n      currentPageChunks.push({\n        content: hasFootnotes ? inlineFootnotes(chunk.content, footnotes) : chunk.content,\n        chunkIndex: chunk.metadata?.chunk_doc_idx,\n        chunkExtId: chunk.metadata?.chunk_ext_id,\n        docTitle: chunk.metadata?.doc_title ?? undefined,\n      })\n    })\n\n    // Add the last page\n    if (currentPageChunks.length > 0) {\n      chunksByPage.push({\n        pageNumber: currentPageNumber > 0 ? currentPageNumber : null,\n        chunks: currentPageChunks,\n      })\n    }\n\n    return { processedChunks: chunksByPage, maxPageNumber }\n  }, [chunks, footnotes])\n}\n"],
+  "mappings": "AAOA,SAAS,eAAe;AAkCxB,SAAS,gBAAgB,SAAiB,WAA2C;AACnF,MAAI,CAAC,aAAa,OAAO,KAAK,SAAS,EAAE,WAAW,EAAG,QAAO;AAE9D,MAAI,SAAS;AAGb,WAAS,OAAO,QAAQ,gDAAgD,EAAE;AAG1E,WAAS,OAAO,QAAQ,mBAAmB,CAAC,QAAQ,QAAQ;AAC1D,UAAM,YAAY,UAAU,GAAG;AAC/B,QAAI,CAAC,UAAW,QAAO,uBAAuB,GAAG;AACjD,UAAM,UAAU,UACb,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ;AACzB,WAAO,uBAAuB,GAAG,wCAAwC,OAAO,MAAM,OAAO;AAAA,EAC/F,CAAC;AAED,SAAO,OAAO,KAAK;AACrB;AAEO,SAAS,mBACd,QACA,WAC0B;AAC1B,SAAO,QAAQ,MAAM;AACnB,QAAI,CAAC,UAAU,OAAO,WAAW,GAAG;AAClC,aAAO,EAAE,iBAAiB,CAAC,GAAG,eAAe,EAAE;AAAA,IACjD;AAEA,UAAM,eAAe,aAAa,OAAO,KAAK,SAAS,EAAE,SAAS;AAClE,UAAM,eAAgC,CAAC;AACvC,QAAI,oBAAoB;AACxB,QAAI,oBAAsC,CAAC;AAC3C,QAAI,gBAAgB;AAEpB,WAAO,QAAQ,CAAC,UAAU;AACxB,YAAM,UAAU,MAAM,UAAU;AAGhC,UAAI,WAAW,UAAU,eAAe;AACtC,wBAAgB;AAAA,MAClB;AAGA,UAAI,YAAY,mBAAmB;AACjC,YAAI,kBAAkB,SAAS,GAAG;AAChC,uBAAa,KAAK;AAAA,YAChB,YAAY,oBAAoB,IAAI,oBAAoB;AAAA,YACxD,QAAQ;AAAA,UACV,CAAC;AAAA,QACH;AACA,4BAAoB,WAAW;AAC/B,4BAAoB,CAAC;AAAA,MACvB;AAEA,wBAAkB,KAAK;AAAA,QACrB,SAAS,eAAe,gBAAgB,MAAM,SAAS,SAAS,IAAI,MAAM;AAAA,QAC1E,YAAY,MAAM,UAAU;AAAA,QAC5B,YAAY,MAAM,UAAU;AAAA,QAC5B,UAAU,MAAM,UAAU,aAAa;AAAA,MACzC,CAAC;AAAA,IACH,CAAC;AAGD,QAAI,kBAAkB,SAAS,GAAG;AAChC,mBAAa,KAAK;AAAA,QAChB,YAAY,oBAAoB,IAAI,oBAAoB;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAEA,WAAO,EAAE,iBAAiB,cAAc,cAAc;AAAA,EACxD,GAAG,CAAC,QAAQ,SAAS,CAAC;AACxB;",
+  "names": []
+}

package/dist/viewers/viewer-zoom.js

@@ -0,0 +1,163 @@
+import { useCallback, useEffect, useLayoutEffect, useRef } from "react";
+const MIN_ZOOM = 0.5;
+const MAX_ZOOM = 4;
+const DOUBLE_TAP_ZOOM = 2;
+const MAX_CANVAS_PIXELS = 8e6;
+const MAX_RENDER_DPR = 2;
+function clampZoom(zoom) {
+  if (!Number.isFinite(zoom)) return 1;
+  return Math.round(Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, zoom)) * 100) / 100;
+}
+const ZOOM_PRESETS = [1.5, 2, 3];
+function cycleZoom(zoom) {
+  return ZOOM_PRESETS.find((preset) => preset > zoom + 0.05) ?? 1;
+}
+function doubleTapZoom(zoom) {
+  return zoom > 1.05 ? 1 : DOUBLE_TAP_ZOOM;
+}
+function zoomLabel(zoom) {
+  return `${Math.round(zoom * 100)}%`;
+}
+function pinchZoom(startZoom, startDistance, distance2) {
+  if (startDistance <= 0) return startZoom;
+  return clampZoom(startZoom * distance2 / startDistance);
+}
+function anchoredScroll(scroll, focal, oldZoom, newZoom) {
+  if (oldZoom <= 0) return scroll;
+  return (scroll + focal) * newZoom / oldZoom - focal;
+}
+function renderDpr(cssWidth, cssHeight, devicePixelRatio, maxPixels = MAX_CANVAS_PIXELS) {
+  const wanted = Math.min(Math.max(devicePixelRatio || 1, 1), MAX_RENDER_DPR);
+  const area = cssWidth * cssHeight;
+  if (area <= 0) return wanted;
+  const fits = Math.sqrt(maxPixels / area);
+  return Math.max(1, Math.min(wanted, fits));
+}
+function fitPageWidth(contentWidth, pageBorder) {
+  if (!Number.isFinite(contentWidth)) return 0;
+  return Math.max(0, Math.floor(contentWidth) - pageBorder);
+}
+function contentBoxWidth(el) {
+  const style = getComputedStyle(el);
+  const padding = (parseFloat(style.paddingLeft) || 0) + (parseFloat(style.paddingRight) || 0);
+  return Math.max(0, el.clientWidth - padding);
+}
+const distance = (a, b) => Math.hypot(a.clientX - b.clientX, a.clientY - b.clientY);
+const INTERACTIVE = 'button, a, input, textarea, select, [role="button"]';
+const DOUBLE_TAP_MS = 300;
+const DOUBLE_TAP_SLOP_PX = 30;
+function usePinchZoom({ containerRef, zoom, onZoomChange }) {
+  const zoomRef = useRef(zoom);
+  const onChangeRef = useRef(onZoomChange);
+  onChangeRef.current = onZoomChange;
+  const focalRef = useRef(null);
+  const appliedZoomRef = useRef(zoom);
+  const request = useCallback((next, focal) => {
+    const clamped = clampZoom(next);
+    if (clamped === zoomRef.current) return;
+    focalRef.current = focal;
+    zoomRef.current = clamped;
+    onChangeRef.current?.(clamped);
+  }, []);
+  useLayoutEffect(() => {
+    zoomRef.current = zoom;
+    const container = containerRef.current;
+    const previous = appliedZoomRef.current;
+    appliedZoomRef.current = zoom;
+    if (!container || previous === zoom) return;
+    const rect = container.getBoundingClientRect();
+    const focal = focalRef.current ?? { x: rect.width / 2, y: rect.height / 2 };
+    focalRef.current = null;
+    container.dataset.zooming = "true";
+    container.scrollLeft = anchoredScroll(container.scrollLeft, focal.x, previous, zoom);
+    container.scrollTop = anchoredScroll(container.scrollTop, focal.y, previous, zoom);
+    requestAnimationFrame(
+      () => requestAnimationFrame(() => {
+        delete container.dataset.zooming;
+      })
+    );
+  }, [zoom, containerRef]);
+  useEffect(() => {
+    const el = containerRef.current;
+    if (!el) return;
+    let pinch = null;
+    let lastTap = null;
+    let frame = 0;
+    let pending = null;
+    const focalOf = (a, b) => {
+      const rect = el.getBoundingClientRect();
+      return {
+        x: (a.clientX + b.clientX) / 2 - rect.left,
+        y: (a.clientY + b.clientY) / 2 - rect.top
+      };
+    };
+    const flush = () => {
+      frame = 0;
+      if (pending) request(pending.zoom, pending.focal);
+      pending = null;
+    };
+    const onStart = (e) => {
+      if (e.touches.length === 2) {
+        pinch = { startDistance: distance(e.touches[0], e.touches[1]), startZoom: zoomRef.current };
+        lastTap = null;
+      }
+    };
+    const onMove = (e) => {
+      if (!pinch || e.touches.length !== 2) return;
+      e.preventDefault();
+      pending = {
+        zoom: pinchZoom(pinch.startZoom, pinch.startDistance, distance(e.touches[0], e.touches[1])),
+        focal: focalOf(e.touches[0], e.touches[1])
+      };
+      if (!frame) frame = requestAnimationFrame(flush);
+    };
+    const onEnd = (e) => {
+      if (pinch && e.touches.length < 2) {
+        pinch = null;
+        return;
+      }
+      if (e.touches.length !== 0 || e.changedTouches.length !== 1) return;
+      const t = e.changedTouches[0];
+      if (e.target?.closest?.(INTERACTIVE)) return;
+      const now = e.timeStamp;
+      if (lastTap && now - lastTap.time < DOUBLE_TAP_MS && Math.hypot(t.clientX - lastTap.x, t.clientY - lastTap.y) < DOUBLE_TAP_SLOP_PX) {
+        e.preventDefault();
+        const rect = el.getBoundingClientRect();
+        request(doubleTapZoom(zoomRef.current), {
+          x: t.clientX - rect.left,
+          y: t.clientY - rect.top
+        });
+        lastTap = null;
+      } else {
+        lastTap = { time: now, x: t.clientX, y: t.clientY };
+      }
+    };
+    el.addEventListener("touchstart", onStart, { passive: true });
+    el.addEventListener("touchmove", onMove, { passive: false });
+    el.addEventListener("touchend", onEnd, { passive: false });
+    el.addEventListener("touchcancel", onEnd, { passive: false });
+    return () => {
+      el.removeEventListener("touchstart", onStart);
+      el.removeEventListener("touchmove", onMove);
+      el.removeEventListener("touchend", onEnd);
+      el.removeEventListener("touchcancel", onEnd);
+      if (frame) cancelAnimationFrame(frame);
+    };
+  }, [containerRef, request]);
+}
+export {
+  MAX_CANVAS_PIXELS,
+  MAX_ZOOM,
+  MIN_ZOOM,
+  anchoredScroll,
+  clampZoom,
+  contentBoxWidth,
+  cycleZoom,
+  doubleTapZoom,
+  fitPageWidth,
+  pinchZoom,
+  renderDpr,
+  usePinchZoom,
+  zoomLabel
+};
+//# sourceMappingURL=viewer-zoom.js.map

package/dist/viewers/viewer-zoom.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/viewers/viewer-zoom.ts"],
+  "sourcesContent": ["/**\n * Zoom for page-stacked viewers (PDF + parsed/HTML).\n *\n * Browser pinch-zoom only magnifies the bitmap the page already painted: a PDF canvas rendered at\n * fit-width stays blurry however far you pinch. The viewers therefore own the zoom: `zoom` is a\n * multiplier of the fit-width size (1 = fit width, 2 = twice as wide). The PDF viewer re-renders\n * its canvases at the new scale; the parsed viewer reflows its text. This module holds the pure\n * math and the touch gesture hook (pinch, double-tap) both use.\n */\n\nimport { useCallback, useEffect, useLayoutEffect, useRef } from 'react'\nimport type { RefObject } from 'react'\n\nexport const MIN_ZOOM = 0.5\nexport const MAX_ZOOM = 4\nconst DOUBLE_TAP_ZOOM = 2\n/** Canvas pixel budget per page: iOS Safari fails above ~16.7M pixels in total, so stay well under. */\nexport const MAX_CANVAS_PIXELS = 8_000_000\n/** Device pixel ratio is capped: beyond 2x the extra sharpness is invisible and costs 2-3x memory. */\nconst MAX_RENDER_DPR = 2\n\nexport function clampZoom(zoom: number): number {\n  if (!Number.isFinite(zoom)) return 1\n  return Math.round(Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, zoom)) * 100) / 100\n}\n\n/** The zoom levels the single zoom button steps through before it returns to fit width. */\nconst ZOOM_PRESETS = [1.5, 2, 3]\n\n/** The zoom button: the next preset above the current zoom, or back to fit width after the last. */\nexport function cycleZoom(zoom: number): number {\n  return ZOOM_PRESETS.find((preset) => preset > zoom + 0.05) ?? 1\n}\n\n/** Double-tap toggles between fit width and a comfortable reading zoom. */\nexport function doubleTapZoom(zoom: number): number {\n  return zoom > 1.05 ? 1 : DOUBLE_TAP_ZOOM\n}\n\nexport function zoomLabel(zoom: number): string {\n  return `${Math.round(zoom * 100)}%`\n}\n\n/** The zoom a pinch has reached: the start zoom scaled by how far the fingers moved apart. */\nexport function pinchZoom(startZoom: number, startDistance: number, distance: number): number {\n  if (startDistance <= 0) return startZoom\n  return clampZoom((startZoom * distance) / startDistance)\n}\n\n/**\n * New scroll offset that keeps the content point under `focal` (a viewport coordinate) still while\n * the zoom changes from `oldZoom` to `newZoom`.\n */\nexport function anchoredScroll(\n  scroll: number,\n  focal: number,\n  oldZoom: number,\n  newZoom: number\n): number {\n  if (oldZoom <= 0) return scroll\n  return ((scroll + focal) * newZoom) / oldZoom - focal\n}\n\n/**\n * Device pixel ratio to rasterise a page of `cssWidth` x `cssHeight` at: the device's own, capped,\n * and lowered further when the page would otherwise exceed the canvas pixel budget.\n */\nexport function renderDpr(\n  cssWidth: number,\n  cssHeight: number,\n  devicePixelRatio: number,\n  maxPixels: number = MAX_CANVAS_PIXELS\n): number {\n  const wanted = Math.min(Math.max(devicePixelRatio || 1, 1), MAX_RENDER_DPR)\n  const area = cssWidth * cssHeight\n  if (area <= 0) return wanted\n  const fits = Math.sqrt(maxPixels / area)\n  return Math.max(1, Math.min(wanted, fits))\n}\n\n/**\n * Width a fit-width page's content gets in a scroller whose content box is `contentWidth` wide:\n * that box less the page's own border, floored so sub-pixel layout never rounds the page up past\n * the box into a sideways overflow.\n */\nexport function fitPageWidth(contentWidth: number, pageBorder: number): number {\n  if (!Number.isFinite(contentWidth)) return 0\n  return Math.max(0, Math.floor(contentWidth) - pageBorder)\n}\n\n/**\n * An element's content-box width: `clientWidth` (which, unlike `offsetWidth`, leaves out the\n * vertical scrollbar and the borders) less the horizontal padding.\n */\nexport function contentBoxWidth(el: HTMLElement): number {\n  const style = getComputedStyle(el)\n  const padding = (parseFloat(style.paddingLeft) || 0) + (parseFloat(style.paddingRight) || 0)\n  return Math.max(0, el.clientWidth - padding)\n}\n\nconst distance = (a: Touch, b: Touch) => Math.hypot(a.clientX - b.clientX, a.clientY - b.clientY)\nconst INTERACTIVE = 'button, a, input, textarea, select, [role=\"button\"]'\nconst DOUBLE_TAP_MS = 300\nconst DOUBLE_TAP_SLOP_PX = 30\n\ninterface PinchZoomOptions {\n  containerRef: RefObject<HTMLElement | null>\n  zoom: number\n  onZoomChange?: (zoom: number) => void\n}\n\n/**\n * Pinch and double-tap zoom on a scroller, plus focal-point preservation for EVERY zoom change\n * (gesture, buttons, props): after the new zoom has laid out, the scroll offset is moved so the\n * content under the pinch centre (or the viewport centre) stays where it was.\n *\n * The scroller must carry `touch-action: pan-x pan-y` so the browser leaves two-finger gestures\n * to this hook instead of zooming the whole app.\n */\nexport function usePinchZoom({ containerRef, zoom, onZoomChange }: PinchZoomOptions): void {\n  const zoomRef = useRef(zoom)\n  const onChangeRef = useRef(onZoomChange)\n  onChangeRef.current = onZoomChange\n  const focalRef = useRef<{ x: number; y: number } | null>(null)\n  const appliedZoomRef = useRef(zoom)\n\n  const request = useCallback((next: number, focal: { x: number; y: number } | null) => {\n    const clamped = clampZoom(next)\n    if (clamped === zoomRef.current) return\n    focalRef.current = focal\n    zoomRef.current = clamped\n    onChangeRef.current?.(clamped)\n  }, [])\n\n  // Zoom changed (from here or from outside): keep the focal point still once it has laid out.\n  useLayoutEffect(() => {\n    zoomRef.current = zoom\n    const container = containerRef.current\n    const previous = appliedZoomRef.current\n    appliedZoomRef.current = zoom\n    if (!container || previous === zoom) return\n    const rect = container.getBoundingClientRect()\n    const focal = focalRef.current ?? { x: rect.width / 2, y: rect.height / 2 }\n    focalRef.current = null\n    // The page-anchoring observer must not also react to this resize.\n    container.dataset.zooming = 'true'\n    container.scrollLeft = anchoredScroll(container.scrollLeft, focal.x, previous, zoom)\n    container.scrollTop = anchoredScroll(container.scrollTop, focal.y, previous, zoom)\n    requestAnimationFrame(() =>\n      requestAnimationFrame(() => {\n        delete container.dataset.zooming\n      })\n    )\n  }, [zoom, containerRef])\n\n  useEffect(() => {\n    const el = containerRef.current\n    if (!el) return\n    let pinch: { startDistance: number; startZoom: number } | null = null\n    let lastTap: { time: number; x: number; y: number } | null = null\n    let frame = 0\n    let pending: { zoom: number; focal: { x: number; y: number } } | null = null\n\n    const focalOf = (a: Touch, b: Touch) => {\n      const rect = el.getBoundingClientRect()\n      return {\n        x: (a.clientX + b.clientX) / 2 - rect.left,\n        y: (a.clientY + b.clientY) / 2 - rect.top,\n      }\n    }\n    const flush = () => {\n      frame = 0\n      if (pending) request(pending.zoom, pending.focal)\n      pending = null\n    }\n\n    const onStart = (e: TouchEvent) => {\n      if (e.touches.length === 2) {\n        pinch = { startDistance: distance(e.touches[0], e.touches[1]), startZoom: zoomRef.current }\n        lastTap = null\n      }\n    }\n    const onMove = (e: TouchEvent) => {\n      if (!pinch || e.touches.length !== 2) return\n      e.preventDefault()\n      pending = {\n        zoom: pinchZoom(pinch.startZoom, pinch.startDistance, distance(e.touches[0], e.touches[1])),\n        focal: focalOf(e.touches[0], e.touches[1]),\n      }\n      if (!frame) frame = requestAnimationFrame(flush)\n    }\n    const onEnd = (e: TouchEvent) => {\n      if (pinch && e.touches.length < 2) {\n        pinch = null\n        return\n      }\n      if (e.touches.length !== 0 || e.changedTouches.length !== 1) return\n      const t = e.changedTouches[0]\n      if ((e.target as Element | null)?.closest?.(INTERACTIVE)) return\n      const now = e.timeStamp\n      if (\n        lastTap &&\n        now - lastTap.time < DOUBLE_TAP_MS &&\n        Math.hypot(t.clientX - lastTap.x, t.clientY - lastTap.y) < DOUBLE_TAP_SLOP_PX\n      ) {\n        e.preventDefault()\n        const rect = el.getBoundingClientRect()\n        request(doubleTapZoom(zoomRef.current), {\n          x: t.clientX - rect.left,\n          y: t.clientY - rect.top,\n        })\n        lastTap = null\n      } else {\n        lastTap = { time: now, x: t.clientX, y: t.clientY }\n      }\n    }\n\n    el.addEventListener('touchstart', onStart, { passive: true })\n    el.addEventListener('touchmove', onMove, { passive: false })\n    el.addEventListener('touchend', onEnd, { passive: false })\n    el.addEventListener('touchcancel', onEnd, { passive: false })\n    return () => {\n      el.removeEventListener('touchstart', onStart)\n      el.removeEventListener('touchmove', onMove)\n      el.removeEventListener('touchend', onEnd)\n      el.removeEventListener('touchcancel', onEnd)\n      if (frame) cancelAnimationFrame(frame)\n    }\n  }, [containerRef, request])\n}\n"],
+  "mappings": "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",
+  "names": ["distance"]
+}

package/dist/websocket/ArbiWebSocketProvider.js

@@ -0,0 +1,207 @@
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import { connectWithReconnect } from "@arbidocs/sdk/browser";
+import {
+  isMessageType,
+  logger
+} from "@arbidocs/client";
+import { useArbi } from "../useArbi.js";
+import { finishEntityExtraction } from "../entity-extraction.js";
+import { useArbiWsStore } from "./store.js";
+import { nextReconnectDelay, resolveSocketBaseUrl } from "./reconnect.js";
+import { applyLiveUpdate } from "./live-updates.js";
+import { applyRunFinished } from "../chat/run-finished.js";
+import { useArbiSessionStore } from "../session/session-hooks.js";
+import { applyChatEvent } from "../directmessages/chat-cache.js";
+import { applyCallEvent } from "../calls/events.js";
+import { applyNotificationRow, isNotificationRow } from "../notifications/live.js";
+import { applyTaskEvent } from "../documents/processing-live.js";
+import { refreshDocuments } from "../documents/documents-data.js";
+import { arbiQueryKeys } from "../query-keys.js";
+import { useFeature } from "../host/features.js";
+import { useOnlineSync } from "../connectivity.js";
+import { useArbiHost } from "../host/config.js";
+import { ArbiWsContext } from "./context.js";
+function signedInId(arbi) {
+  return arbi.isLoggedIn ? arbi.user.identity()?.externalId ?? null : null;
+}
+const EVICTED_CLOSE_CODE = 1008;
+function ArbiWebSocketProvider({
+  enabled = true,
+  onAuthenticated,
+  handlers,
+  children
+}) {
+  const arbi = useArbi();
+  const arbiRef = useRef(arbi);
+  arbiRef.current = arbi;
+  const queryClient = useQueryClient();
+  const subscribersRef = useRef(/* @__PURE__ */ new Set());
+  const setStatus = useArbiWsStore((s) => s.setStatus);
+  const applyTaskUpdate = useArbiWsStore((s) => s.applyTaskUpdate);
+  const applyPresence = useArbiWsStore((s) => s.applyPresence);
+  const reset = useArbiWsStore((s) => s.reset);
+  const setEvicted = useArbiWsStore((s) => s.setEvicted);
+  const onAuthenticatedRef = useRef(onAuthenticated);
+  onAuthenticatedRef.current = onAuthenticated;
+  const handlersRef = useRef(handlers);
+  handlersRef.current = handlers;
+  const session = useArbiSessionStore();
+  const sessionRef = useRef(session);
+  sessionRef.current = session;
+  const host = useArbiHost();
+  const hostRef = useRef(host);
+  hostRef.current = host;
+  const acceptRings = useFeature("calls");
+  const acceptRingsRef = useRef(acceptRings);
+  acceptRingsRef.current = acceptRings;
+  useOnlineSync();
+  const context = useMemo(
+    () => ({
+      subscribe: (fn) => {
+        subscribersRef.current.add(fn);
+        return () => {
+          subscribersRef.current.delete(fn);
+        };
+      }
+    }),
+    []
+  );
+  useEffect(() => {
+    if (!enabled) {
+      reset();
+      return;
+    }
+    let conn = null;
+    let cancelled = false;
+    let evicted = false;
+    const me = () => signedInId(arbiRef.current);
+    const onMessage = (msg) => {
+      const type = msg.type;
+      if (type === "connection_closed") {
+        evicted = true;
+        setEvicted(true);
+      } else if (isMessageType(msg, "task_update")) {
+        if (applyTaskUpdate(msg)) applyTaskEvent(queryClient, arbiRef.current, msg, me());
+      } else if (isMessageType(msg, "presence_update")) applyPresence(msg);
+      else if (isMessageType(msg, "response_complete"))
+        applyRunFinished(
+          queryClient,
+          arbiRef.current,
+          sessionRef.current,
+          msg,
+          (quota) => hostRef.current.chat?.onQuotaExceeded?.(quota)
+        );
+      else if (type === "error")
+        logger.error("[WebSocket] Server error:", msg.message);
+      else if (isMessageType(msg, "batch_complete")) {
+        if (msg.batch_type === "entity_extract") {
+          finishEntityExtraction(msg.doc_ext_ids ?? []);
+          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allFacts() });
+        }
+        if (msg.batch_type === "upload" || msg.batch_type === "entity_extract") {
+          if (msg.doc_ext_ids?.length)
+            void refreshDocuments(queryClient, arbiRef.current, msg.doc_ext_ids);
+          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allTags() });
+        }
+      } else if (type.startsWith("chat.") || type === "agent_dm_status")
+        void applyChatEvent(arbiRef.current, queryClient, msg);
+      else if (type.startsWith("call."))
+        applyCallEvent(queryClient, msg, { me: me(), acceptRings: acceptRingsRef.current });
+      else if (isNotificationRow(msg)) applyNotificationRow(queryClient, msg, me());
+      else void applyLiveUpdate(queryClient, msg);
+      try {
+        handlersRef.current?.[type]?.(msg);
+      } catch (error) {
+        logger.error(`[WebSocket] The host's ${type} handler failed:`, error);
+      }
+      for (const fn of subscribersRef.current) {
+        try {
+          fn(msg);
+        } catch {
+        }
+      }
+    };
+    let retryTimer = null;
+    let attempt = 0;
+    const scheduleRestart = () => {
+      if (cancelled || evicted || retryTimer) return;
+      setStatus("disconnected");
+      const delay = nextReconnectDelay(attempt);
+      attempt += 1;
+      retryTimer = setTimeout(() => {
+        retryTimer = null;
+        void start();
+      }, delay);
+    };
+    const start = async () => {
+      if (cancelled) return;
+      const info = arbiRef.current.getConnectionInfo();
+      if (!info) {
+        scheduleRestart();
+        return;
+      }
+      conn?.close();
+      conn = null;
+      setStatus("connecting");
+      try {
+        const c = await connectWithReconnect({
+          baseUrl: resolveSocketBaseUrl(
+            info.baseUrl,
+            typeof window === "undefined" ? void 0 : window.location.origin
+          ),
+          accessToken: info.accessToken,
+          // Resolve the freshest token on every (re)connect so rotation is picked up.
+          getAccessToken: () => arbiRef.current.getConnectionInfo()?.accessToken ?? null,
+          // A reconnect refused for its token re-logs in silently first.
+          refreshAuth: () => arbiRef.current.refreshAccess(),
+          onAuthenticated: (message) => onAuthenticatedRef.current?.(message),
+          // The session's: a sign-out closes the socket before the server revokes the token.
+          signal: info.signal,
+          onMessage,
+          onReconnecting: () => setStatus("reconnecting"),
+          onReconnected: () => {
+            attempt = 0;
+            setStatus("connected");
+          },
+          // Evicted (a newer session of the same user, or the server took this connection over for a
+          // newer one of this session): reconnecting would be evicted again, or evict that one.
+          shouldReconnect: (code) => {
+            if (code !== EVICTED_CLOSE_CODE && !evicted) return true;
+            evicted = true;
+            setEvicted(true);
+            setStatus("disconnected");
+            return false;
+          },
+          onReconnectFailed: scheduleRestart,
+          onClose: () => {
+            if (!cancelled) setStatus(evicted ? "disconnected" : "reconnecting");
+          }
+        });
+        if (cancelled) {
+          c.close();
+          return;
+        }
+        conn = c;
+        attempt = 0;
+        setStatus("connected");
+      } catch {
+        if (!info.signal.aborted) scheduleRestart();
+      }
+    };
+    setEvicted(false);
+    void start();
+    return () => {
+      cancelled = true;
+      if (retryTimer) clearTimeout(retryTimer);
+      conn?.close();
+      reset();
+    };
+  }, [enabled, queryClient, setStatus, setEvicted, applyTaskUpdate, applyPresence, reset]);
+  return /* @__PURE__ */ jsx(ArbiWsContext.Provider, { value: context, children });
+}
+export {
+  ArbiWebSocketProvider
+};
+//# sourceMappingURL=ArbiWebSocketProvider.js.map

package/dist/websocket/ArbiWebSocketProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/ArbiWebSocketProvider.tsx"],
+  "sourcesContent": ["/**\n * ArbiWebSocketProvider \u2014 one shared, reconnecting WebSocket for the whole app.\n *\n * Opens a single authenticated socket (via the SDK transport's\n * `connectWithReconnect`, which handles auth, backoff, and live-token refresh),\n * feeds the canonical WS store, applies what every site applies (tasks, presence,\n * chats, calls, notification rows, finished runs, conversation, mail-draft and skill\n * events), then hands each message to the host's own `handlers` for its type and\n * fans it out to subscribers registered by the `useArbiWebSocket` /\n * `useArbiWsMessage` hooks.\n *\n * Mount it inside an `<ArbiHost>` with an `arbi` (it reads the Arbi instance for the base\n * URL + live access token). Gate it with `enabled` so it connects only once the\n * app is authenticated against a live backend.\n */\n\nimport { useEffect, useMemo, useRef, type ReactNode } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { connectWithReconnect, type ReconnectableWsConnection } from '@arbidocs/sdk/browser'\nimport {\n  isMessageType,\n  type WebSocketServerMessage,\n  type WsTaskUpdateMessage,\n  type WsBatchCompleteMessage,\n  type WsPresenceUpdateMessage,\n  type WsAuthResultMessage,\n  type WsResponseCompleteMessage,\n  logger,\n} from '@arbidocs/client'\nimport { useArbi } from '../useArbi'\nimport { finishEntityExtraction } from '../entity-extraction'\nimport { useArbiWsStore } from './store'\nimport { nextReconnectDelay, resolveSocketBaseUrl } from './reconnect'\nimport { applyLiveUpdate } from './live-updates'\nimport { applyRunFinished } from '../chat/run-finished'\nimport { useArbiSessionStore } from '../session/session-hooks'\nimport { applyChatEvent } from '../directmessages/chat-cache'\nimport { applyCallEvent } from '../calls/events'\nimport { applyNotificationRow, isNotificationRow } from '../notifications/live'\nimport { applyTaskEvent } from '../documents/processing-live'\nimport { refreshDocuments } from '../documents/documents-data'\nimport { arbiQueryKeys } from '../query-keys'\nimport { useFeature } from '../host/features'\nimport { useOnlineSync } from '../connectivity'\nimport { useArbiHost } from '../host/config'\nimport { ArbiWsContext, type ArbiWsContextValue, type ArbiWsSubscriber } from './context'\n\n/** A host's own handling of server messages, by message type (e.g. `remote_control`). */\nexport type ArbiWsHandlers = Partial<Record<string, (message: WebSocketServerMessage) => void>>\n\nexport interface ArbiWebSocketProviderProps {\n  /**\n   * Open the socket only when the app is authenticated against a live backend.\n   * Defaults to `true`; pass the connection status so demo/logged-out sessions\n   * don't try to connect.\n   */\n  enabled?: boolean\n  /** Called each time the server accepts the socket's auth (e.g. to show the unread count). */\n  onAuthenticated?: (message: WsAuthResultMessage) => void\n  /**\n   * The host's own handling of message types the provider does not apply (e.g. `remote_control`),\n   * each called after the provider's own and before the subscribers. Read on each message, so a\n   * new object never reopens the socket.\n   */\n  handlers?: ArbiWsHandlers\n  children: ReactNode\n}\n\n/** The signed-in person's id on `arbi`, or null when nobody is signed in. */\nfunction signedInId(arbi: ReturnType<typeof useArbi>): string | null {\n  return arbi.isLoggedIn ? (arbi.user.identity()?.externalId ?? null) : null\n}\n\n/** The close code of a server-side single-session eviction (a newer session of the same user). */\nconst EVICTED_CLOSE_CODE = 1008\n\nexport function ArbiWebSocketProvider({\n  enabled = true,\n  onAuthenticated,\n  handlers,\n  children,\n}: ArbiWebSocketProviderProps) {\n  // The latest `Arbi`, read on each use: a host renews its instance (another server session, an\n  // opened workspace) without that reopening the socket; the token is read afresh on each connect.\n  const arbi = useArbi()\n  const arbiRef = useRef(arbi)\n  arbiRef.current = arbi\n  const queryClient = useQueryClient()\n  const subscribersRef = useRef<Set<ArbiWsSubscriber>>(new Set())\n  const setStatus = useArbiWsStore((s) => s.setStatus)\n  const applyTaskUpdate = useArbiWsStore((s) => s.applyTaskUpdate)\n  const applyPresence = useArbiWsStore((s) => s.applyPresence)\n  const reset = useArbiWsStore((s) => s.reset)\n  const setEvicted = useArbiWsStore((s) => s.setEvicted)\n  const onAuthenticatedRef = useRef(onAuthenticated)\n  onAuthenticatedRef.current = onAuthenticated\n  const handlersRef = useRef(handlers)\n  handlersRef.current = handlers\n  const session = useArbiSessionStore()\n  const sessionRef = useRef(session)\n  sessionRef.current = session\n  const host = useArbiHost()\n  const hostRef = useRef(host)\n  hostRef.current = host\n  // Calls ring only a person whose `calls` feature is on (ARBI: Settings \u2192 Experimental); unlisted, on.\n  const acceptRings = useFeature('calls')\n  const acceptRingsRef = useRef(acceptRings)\n  acceptRingsRef.current = acceptRings\n  // Online or not follows this connection too (and the network, and \"Work offline\").\n  useOnlineSync()\n\n  // Stable subscribe API \u2014 the subscriber set lives in a ref, so registering a\n  // handler never re-opens the socket.\n  const context = useMemo<ArbiWsContextValue>(\n    () => ({\n      subscribe: (fn) => {\n        subscribersRef.current.add(fn)\n        return () => {\n          subscribersRef.current.delete(fn)\n        }\n      },\n    }),\n    []\n  )\n\n  useEffect(() => {\n    if (!enabled) {\n      reset()\n      return\n    }\n\n    let conn: ReconnectableWsConnection | null = null\n    let cancelled = false\n    // Taken over by another connection of this session (the server says so, then closes):\n    // reconnecting would take it back, and the two would evict each other in turn.\n    let evicted = false\n\n    const me = () => signedInId(arbiRef.current)\n\n    // What every site applies, before the host's own subscribers hear the message.\n    const onMessage = (msg: WebSocketServerMessage) => {\n      const type = msg.type as string\n      if (type === 'connection_closed') {\n        evicted = true\n        setEvicted(true)\n      } else if (isMessageType<WsTaskUpdateMessage>(msg, 'task_update')) {\n        // The live processing row, then the documents list (an upload's row, a finished re-read).\n        if (applyTaskUpdate(msg)) applyTaskEvent(queryClient, arbiRef.current, msg, me())\n      } else if (isMessageType<WsPresenceUpdateMessage>(msg, 'presence_update')) applyPresence(msg)\n      else if (isMessageType<WsResponseCompleteMessage>(msg, 'response_complete'))\n        // A run finished: its conversation stops generating, its follow-up leaves the queue, the\n        // documents it saved are read again, the thread follows, and a run failed for the AI usage\n        // says so the chat host's way.\n        applyRunFinished(queryClient, arbiRef.current, sessionRef.current, msg, (quota) =>\n          hostRef.current.chat?.onQuotaExceeded?.(quota)\n        )\n      else if (type === 'error')\n        logger.error('[WebSocket] Server error:', (msg as { message?: unknown }).message)\n      else if (isMessageType<WsBatchCompleteMessage>(msg, 'batch_complete')) {\n        // An upload or an extraction finished: its documents are read again, and the tags (an\n        // upload may create sender labels; an extraction creates people and organisations and\n        // links facts). AI fields (`doctag_generate`) are the AI review's (blocks).\n        if (msg.batch_type === 'entity_extract') {\n          finishEntityExtraction(msg.doc_ext_ids ?? [])\n          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allFacts() })\n        }\n        if (msg.batch_type === 'upload' || msg.batch_type === 'entity_extract') {\n          if (msg.doc_ext_ids?.length)\n            void refreshDocuments(queryClient, arbiRef.current, msg.doc_ext_ids)\n          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allTags() })\n        }\n      } else if (type.startsWith('chat.') || type === 'agent_dm_status')\n        // Chats (direct messages, agent DM progress).\n        void applyChatEvent(arbiRef.current, queryClient, msg)\n      else if (type.startsWith('call.'))\n        applyCallEvent(queryClient, msg, { me: me(), acceptRings: acceptRingsRef.current })\n      else if (isNotificationRow(msg)) applyNotificationRow(queryClient, msg, me())\n      // Conversation, mail-draft and skill events.\n      else void applyLiveUpdate(queryClient, msg as unknown as { type: string })\n\n      // The host's own handler for this type, then the subscribers. A throwing handler must not\n      // kill the stream.\n      try {\n        handlersRef.current?.[type]?.(msg)\n      } catch (error) {\n        logger.error(`[WebSocket] The host's ${type} handler failed:`, error)\n      }\n      for (const fn of subscribersRef.current) {\n        try {\n          fn(msg)\n        } catch {\n          /* swallow \u2014 one bad handler can't break the socket */\n        }\n      }\n    }\n\n    let retryTimer: ReturnType<typeof setTimeout> | null = null\n    let attempt = 0\n\n    // The socket is best-effort and never gives up: after the transport's own retries (or a failed\n    // connect) a fresh one is opened after a capped backoff, offline meanwhile. It never ends the\n    // session; that is the HTTP layer's job.\n    const scheduleRestart = () => {\n      if (cancelled || evicted || retryTimer) return\n      setStatus('disconnected')\n      const delay = nextReconnectDelay(attempt)\n      attempt += 1\n      retryTimer = setTimeout(() => {\n        retryTimer = null\n        void start()\n      }, delay)\n    }\n\n    const start = async () => {\n      if (cancelled) return\n      const info = arbiRef.current.getConnectionInfo()\n      if (!info) {\n        // Not signed in on this client yet: try again shortly.\n        scheduleRestart()\n        return\n      }\n      conn?.close()\n      conn = null\n      setStatus('connecting')\n      try {\n        const c = await connectWithReconnect({\n          baseUrl: resolveSocketBaseUrl(\n            info.baseUrl,\n            typeof window === 'undefined' ? undefined : window.location.origin\n          ),\n          accessToken: info.accessToken,\n          // Resolve the freshest token on every (re)connect so rotation is picked up.\n          getAccessToken: () => arbiRef.current.getConnectionInfo()?.accessToken ?? null,\n          // A reconnect refused for its token re-logs in silently first.\n          refreshAuth: () => arbiRef.current.refreshAccess(),\n          onAuthenticated: (message) => onAuthenticatedRef.current?.(message),\n          // The session's: a sign-out closes the socket before the server revokes the token.\n          signal: info.signal,\n          onMessage,\n          onReconnecting: () => setStatus('reconnecting'),\n          onReconnected: () => {\n            attempt = 0\n            setStatus('connected')\n          },\n          // Evicted (a newer session of the same user, or the server took this connection over for a\n          // newer one of this session): reconnecting would be evicted again, or evict that one.\n          shouldReconnect: (code) => {\n            if (code !== EVICTED_CLOSE_CODE && !evicted) return true\n            evicted = true\n            setEvicted(true)\n            setStatus('disconnected')\n            return false\n          },\n          onReconnectFailed: scheduleRestart,\n          onClose: () => {\n            if (!cancelled) setStatus(evicted ? 'disconnected' : 'reconnecting')\n          },\n        })\n        if (cancelled) {\n          c.close()\n          return\n        }\n        conn = c\n        attempt = 0\n        setStatus('connected')\n      } catch {\n        // Stopped by a sign-out: the session is gone, nothing to reopen.\n        if (!info.signal.aborted) scheduleRestart()\n      }\n    }\n    setEvicted(false)\n    void start()\n\n    return () => {\n      cancelled = true\n      if (retryTimer) clearTimeout(retryTimer)\n      conn?.close()\n      reset()\n    }\n  }, [enabled, queryClient, setStatus, setEvicted, applyTaskUpdate, applyPresence, reset])\n\n  return <ArbiWsContext.Provider value={context}>{children}</ArbiWsContext.Provider>\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/websocket/context.js

@@ -0,0 +1,14 @@
+import { createContext, useContext } from "react";
+const ArbiWsContext = createContext(null);
+function useArbiWsContext() {
+  const ctx = useContext(ArbiWsContext);
+  if (!ctx) {
+    throw new Error("useArbiWebSocket hooks must be used within an <ArbiWebSocketProvider>");
+  }
+  return ctx;
+}
+export {
+  ArbiWsContext,
+  useArbiWsContext
+};
+//# sourceMappingURL=context.js.map

package/dist/websocket/context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/context.ts"],
+  "sourcesContent": ["/**\n * Context for the shared WebSocket \u2014 the subscribe registry the provider fills\n * and the hooks read. Kept separate from the provider component so both can be\n * imported without tripping react-refresh's component-only-export rule.\n */\n\nimport { createContext, useContext } from 'react'\nimport type { WebSocketServerMessage } from '@arbidocs/client'\n\nexport type ArbiWsSubscriber = (msg: WebSocketServerMessage) => void\n\nexport interface ArbiWsContextValue {\n  subscribe: (fn: ArbiWsSubscriber) => () => void\n}\n\nexport const ArbiWsContext = createContext<ArbiWsContextValue | null>(null)\n\nexport function useArbiWsContext(): ArbiWsContextValue {\n  const ctx = useContext(ArbiWsContext)\n  if (!ctx) {\n    throw new Error('useArbiWebSocket hooks must be used within an <ArbiWebSocketProvider>')\n  }\n  return ctx\n}\n"],
+  "mappings": "AAMA,SAAS,eAAe,kBAAkB;AASnC,MAAM,gBAAgB,cAAyC,IAAI;AAEnE,SAAS,mBAAuC;AACrD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;",
+  "names": []
+}