@arbidocs/react 0.5.110 → 0.5.112

package/dist/documents/chunked-recorder.js

@@ -0,0 +1,190 @@
+const AUDIO_MIME_PREFERENCE = [
+  "audio/webm;codecs=opus",
+  "audio/ogg;codecs=opus",
+  "audio/mp4;codecs=mp4a.40.2",
+  "audio/mp4"
+];
+const VIDEO_MIME_PREFERENCE = [
+  "video/webm;codecs=av01,opus",
+  "video/webm;codecs=av1,opus",
+  "video/webm;codecs=vp9,opus",
+  "video/webm;codecs=vp8,opus",
+  "video/webm",
+  "video/mp4"
+];
+function pickRecorderMimeType(kind, isTypeSupported = (t) => typeof MediaRecorder !== "undefined" && MediaRecorder.isTypeSupported(t)) {
+  const list = kind === "audio" ? AUDIO_MIME_PREFERENCE : VIDEO_MIME_PREFERENCE;
+  for (const type of list) {
+    try {
+      if (isTypeSupported(type)) return type;
+    } catch {
+    }
+  }
+  return list[list.length - 1];
+}
+function createChunkedRecorder(options) {
+  const now = options.now ?? (() => Date.now());
+  const mode = options.mode ?? "restart";
+  let running = false;
+  let index = 0;
+  let timer = null;
+  let tail = Promise.resolve();
+  const recorderInit = () => ({
+    mimeType: options.mimeType,
+    ...options.audioBitsPerSecond ? { audioBitsPerSecond: options.audioBitsPerSecond } : {},
+    ...options.videoBitsPerSecond ? { videoBitsPerSecond: options.videoBitsPerSecond } : {}
+  });
+  const fail = (err) => {
+    running = false;
+    if (timer !== null) clearTimeout(timer);
+    timer = null;
+    options.onError?.(err);
+  };
+  const beginPart = () => {
+    let recorder;
+    try {
+      recorder = new MediaRecorder(options.stream, recorderInit());
+    } catch (err) {
+      fail(err);
+      return void 0;
+    }
+    const chunks = [];
+    const part = { recorder, startedAt: now(), chunks };
+    recorder.ondataavailable = (e) => {
+      if (e.data.size > 0) chunks.push(e.data);
+    };
+    recorder.onstart = () => {
+      part.startedAt = now();
+    };
+    try {
+      recorder.start();
+    } catch (err) {
+      fail(err);
+      return void 0;
+    }
+    return part;
+  };
+  const endPart = (part) => new Promise((resolve) => {
+    const { recorder, startedAt, chunks } = part;
+    const durationMs = Math.max(0, now() - startedAt);
+    const partIndex = index++;
+    const emit = () => {
+      if (chunks.length) {
+        const type = recorder.mimeType || options.mimeType;
+        options.onChunk({
+          blob: new Blob(chunks, { type }),
+          mimeType: type,
+          index: partIndex,
+          startedAt,
+          durationMs,
+          standalone: true
+        });
+      }
+      resolve();
+    };
+    if (recorder.state === "inactive") {
+      emit();
+      return;
+    }
+    recorder.onstop = emit;
+    recorder.stop();
+  });
+  let open;
+  const rotate = () => {
+    if (!running || !open) return;
+    const finished = open;
+    open = beginPart();
+    tail = tail.then(() => endPart(finished));
+    if (running) timer = setTimeout(rotate, options.chunkMs);
+  };
+  let sliceStartedAt = 0;
+  let sliceRecorder = null;
+  let stopResolve = null;
+  const startTimeslice = () => {
+    let recorder;
+    try {
+      recorder = new MediaRecorder(options.stream, recorderInit());
+    } catch (err) {
+      fail(err);
+      return;
+    }
+    sliceRecorder = recorder;
+    sliceStartedAt = now();
+    recorder.ondataavailable = (e) => {
+      const at = now();
+      const startedAt = sliceStartedAt;
+      sliceStartedAt = at;
+      if (!e.data.size) return;
+      const type = recorder.mimeType || options.mimeType;
+      const partIndex = index++;
+      options.onChunk({
+        blob: e.data,
+        mimeType: type,
+        index: partIndex,
+        startedAt,
+        durationMs: Math.max(0, at - startedAt),
+        standalone: partIndex === 0
+      });
+    };
+    recorder.onstop = () => {
+      stopResolve?.();
+      stopResolve = null;
+    };
+    try {
+      recorder.start();
+    } catch (err) {
+      sliceRecorder = null;
+      fail(err);
+      return;
+    }
+    timer = setInterval(() => {
+      if (recorder.state === "recording") recorder.requestData();
+    }, options.chunkMs);
+  };
+  return {
+    get running() {
+      return running;
+    },
+    start() {
+      if (running) return;
+      running = true;
+      index = 0;
+      if (mode === "timeslice") {
+        startTimeslice();
+        return;
+      }
+      open = beginPart();
+      if (running) timer = setTimeout(rotate, options.chunkMs);
+    },
+    stop() {
+      if (!running && !open && !sliceRecorder) return tail;
+      running = false;
+      if (timer !== null) {
+        clearTimeout(timer);
+        clearInterval(timer);
+      }
+      timer = null;
+      if (mode === "timeslice") {
+        const recorder = sliceRecorder;
+        sliceRecorder = null;
+        if (!recorder || recorder.state === "inactive") return tail;
+        tail = new Promise((resolve) => {
+          stopResolve = resolve;
+          recorder.stop();
+        });
+        return tail;
+      }
+      const finished = open;
+      open = void 0;
+      if (finished) tail = tail.then(() => endPart(finished));
+      return tail;
+    }
+  };
+}
+export {
+  AUDIO_MIME_PREFERENCE,
+  VIDEO_MIME_PREFERENCE,
+  createChunkedRecorder,
+  pickRecorderMimeType
+};
+//# sourceMappingURL=chunked-recorder.js.map

package/dist/documents/chunked-recorder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/chunked-recorder.ts"],
+  "sourcesContent": ["/**\n * Chunked MediaRecorder engine \u2014 records a stream in fixed-length parts for a\n * long-running recording that is uploaded as it goes (call recording).\n *\n * Two ways to cut the parts:\n *   - `restart` (default): every `chunkMs` the recorder is stopped and a new\n *     one started on the same stream, so EVERY part is a standalone file with\n *     its own container header (playable, decodable and transcribable on its\n *     own). The gap between two parts is the few ms between stop and start.\n *   - `timeslice`: one recorder, `requestData()` every `chunkMs` \u2014 the parts\n *     are consecutive byte ranges of ONE file (only the first carries the\n *     header), so concatenating them in order gives the whole recording with\n *     no gap. Used where the parts are only ever played back as one file.\n *\n * Framework-free (no React) so it can be driven by `useAudioRecorder`'s\n * chunk mode and directly by a host that records a composed stream.\n */\n\n/** One part of a chunked recording. */\nexport interface RecordedChunk {\n  blob: Blob\n  mimeType: string\n  /** 0, 1, 2\u2026 in recording order (per recorder instance). */\n  index: number\n  /** Wall-clock start of the part, ms since epoch. */\n  startedAt: number\n  durationMs: number\n  /** `restart`: always true. `timeslice`: only the first part starts a file. */\n  standalone: boolean\n}\n\nexport interface ChunkedRecorderOptions {\n  stream: MediaStream\n  /** MediaRecorder MIME type (pick it with {@link pickRecorderMimeType}). */\n  mimeType: string\n  /** Part length, ms (~30 s for call recording). */\n  chunkMs: number\n  mode?: 'restart' | 'timeslice'\n  audioBitsPerSecond?: number\n  videoBitsPerSecond?: number\n  onChunk(chunk: RecordedChunk): void\n  /** Called when a MediaRecorder fails; the recorder stops. */\n  onError?(error: unknown): void\n  /** Wall clock (tests). */\n  now?: () => number\n}\n\nexport interface ChunkedRecorder {\n  readonly running: boolean\n  start(): void\n  /** Stop and flush the tail part; resolves once it was handed to `onChunk`. */\n  stop(): Promise<void>\n}\n\n/** Audio MIME types in preference order: Opus/WebM, then AAC/MP4 (Safari). */\nexport const AUDIO_MIME_PREFERENCE = [\n  'audio/webm;codecs=opus',\n  'audio/ogg;codecs=opus',\n  'audio/mp4;codecs=mp4a.40.2',\n  'audio/mp4',\n] as const\n\n/** Video MIME types in preference order: AV1, VP9, VP8 (with Opus), then MP4. */\nexport const VIDEO_MIME_PREFERENCE = [\n  'video/webm;codecs=av01,opus',\n  'video/webm;codecs=av1,opus',\n  'video/webm;codecs=vp9,opus',\n  'video/webm;codecs=vp8,opus',\n  'video/webm',\n  'video/mp4',\n] as const\n\n/**\n * The first MIME type `isTypeSupported` accepts, or the last of the list (the\n * broadest container) when it accepts none.\n */\nexport function pickRecorderMimeType(\n  kind: 'audio' | 'video',\n  isTypeSupported: (type: string) => boolean = (t) =>\n    typeof MediaRecorder !== 'undefined' && MediaRecorder.isTypeSupported(t)\n): string {\n  const list: readonly string[] = kind === 'audio' ? AUDIO_MIME_PREFERENCE : VIDEO_MIME_PREFERENCE\n  for (const type of list) {\n    try {\n      if (isTypeSupported(type)) return type\n    } catch {\n      // A browser that throws on an unknown type: try the next one.\n    }\n  }\n  return list[list.length - 1]\n}\n\nexport function createChunkedRecorder(options: ChunkedRecorderOptions): ChunkedRecorder {\n  const now = options.now ?? (() => Date.now())\n  const mode = options.mode ?? 'restart'\n  let running = false\n  let index = 0\n  let timer: ReturnType<typeof setInterval> | ReturnType<typeof setTimeout> | null = null\n  let tail: Promise<void> = Promise.resolve()\n\n  const recorderInit = (): MediaRecorderOptions => ({\n    mimeType: options.mimeType,\n    ...(options.audioBitsPerSecond ? { audioBitsPerSecond: options.audioBitsPerSecond } : {}),\n    ...(options.videoBitsPerSecond ? { videoBitsPerSecond: options.videoBitsPerSecond } : {}),\n  })\n\n  const fail = (err: unknown) => {\n    running = false\n    if (timer !== null) clearTimeout(timer as ReturnType<typeof setTimeout>)\n    timer = null\n    options.onError?.(err)\n  }\n\n  /** `restart`: one recorder per part; resolves when that part was emitted. */\n  const beginPart = ():\n    { recorder: MediaRecorder; startedAt: number; chunks: Blob[] } | undefined => {\n    let recorder: MediaRecorder\n    try {\n      recorder = new MediaRecorder(options.stream, recorderInit())\n    } catch (err) {\n      fail(err)\n      return undefined\n    }\n    const chunks: Blob[] = []\n    const part = { recorder, startedAt: now(), chunks }\n    recorder.ondataavailable = (e) => {\n      if (e.data.size > 0) chunks.push(e.data)\n    }\n    // Capture begins at the recorder's `start` event, which can come a second or more after\n    // start() while the encoder spins up. Time the part from there: a part timed from start()\n    // carries that latency as phantom silence at its start, and a transcript cut there splits a\n    // sentence spoken across the part boundary.\n    recorder.onstart = () => {\n      part.startedAt = now()\n    }\n    try {\n      recorder.start()\n    } catch (err) {\n      fail(err)\n      return undefined\n    }\n    return part\n  }\n\n  const endPart = (part: { recorder: MediaRecorder; startedAt: number; chunks: Blob[] }) =>\n    new Promise<void>((resolve) => {\n      const { recorder, startedAt, chunks } = part\n      const durationMs = Math.max(0, now() - startedAt)\n      const partIndex = index++\n      const emit = () => {\n        if (chunks.length) {\n          const type = recorder.mimeType || options.mimeType\n          options.onChunk({\n            blob: new Blob(chunks, { type }),\n            mimeType: type,\n            index: partIndex,\n            startedAt,\n            durationMs,\n            standalone: true,\n          })\n        }\n        resolve()\n      }\n      if (recorder.state === 'inactive') {\n        emit()\n        return\n      }\n      recorder.onstop = emit\n      recorder.stop()\n    })\n\n  let open: { recorder: MediaRecorder; startedAt: number; chunks: Blob[] } | undefined\n\n  const rotate = () => {\n    if (!running || !open) return\n    const finished = open\n    // Start the next part before the previous one flushes: no gap but the start latency.\n    open = beginPart()\n    tail = tail.then(() => endPart(finished))\n    if (running) timer = setTimeout(rotate, options.chunkMs)\n  }\n\n  // `timeslice`: one recorder; each dataavailable is a part.\n  let sliceStartedAt = 0\n  let sliceRecorder: MediaRecorder | null = null\n  let stopResolve: (() => void) | null = null\n\n  const startTimeslice = () => {\n    let recorder: MediaRecorder\n    try {\n      recorder = new MediaRecorder(options.stream, recorderInit())\n    } catch (err) {\n      fail(err)\n      return\n    }\n    sliceRecorder = recorder\n    sliceStartedAt = now()\n    recorder.ondataavailable = (e) => {\n      const at = now()\n      const startedAt = sliceStartedAt\n      sliceStartedAt = at\n      if (!e.data.size) return\n      const type = recorder.mimeType || options.mimeType\n      const partIndex = index++\n      options.onChunk({\n        blob: e.data,\n        mimeType: type,\n        index: partIndex,\n        startedAt,\n        durationMs: Math.max(0, at - startedAt),\n        standalone: partIndex === 0,\n      })\n    }\n    recorder.onstop = () => {\n      stopResolve?.()\n      stopResolve = null\n    }\n    try {\n      recorder.start()\n    } catch (err) {\n      sliceRecorder = null\n      fail(err)\n      return\n    }\n    timer = setInterval(() => {\n      if (recorder.state === 'recording') recorder.requestData()\n    }, options.chunkMs)\n  }\n\n  return {\n    get running() {\n      return running\n    },\n    start() {\n      if (running) return\n      running = true\n      index = 0\n      if (mode === 'timeslice') {\n        startTimeslice()\n        return\n      }\n      open = beginPart()\n      if (running) timer = setTimeout(rotate, options.chunkMs)\n    },\n    stop() {\n      if (!running && !open && !sliceRecorder) return tail\n      running = false\n      if (timer !== null) {\n        clearTimeout(timer as ReturnType<typeof setTimeout>)\n        clearInterval(timer as ReturnType<typeof setInterval>)\n      }\n      timer = null\n      if (mode === 'timeslice') {\n        const recorder = sliceRecorder\n        sliceRecorder = null\n        if (!recorder || recorder.state === 'inactive') return tail\n        tail = new Promise<void>((resolve) => {\n          stopResolve = resolve\n          // stop() fires a final dataavailable (the tail), then stop.\n          recorder.stop()\n        })\n        return tail\n      }\n      const finished = open\n      open = undefined\n      if (finished) tail = tail.then(() => endPart(finished))\n      return tail\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/documents/document-download.js

@@ -0,0 +1,53 @@
+import { getDocumentDate } from "./document-fields.js";
+import { getDocumentTitle } from "../entities/DocumentEntity.js";
+function fallbackFileName(doc) {
+  if (doc.file_name) return doc.file_name;
+  const title = getDocumentTitle(doc, `document-${doc.external_id}`);
+  const extension = doc.file_type || "pdf";
+  const ext = extension.startsWith(".") ? extension : `.${extension}`;
+  return title.toLowerCase().endsWith(ext.toLowerCase()) ? title : `${title}${ext}`;
+}
+const COLUMN_MAPPING = {
+  file_name: {
+    header: "File Name",
+    getValue: (d) => d.file_name || getDocumentTitle(d, `document-${d.external_id}.pdf`)
+  },
+  title: { header: "Title", getValue: (d) => getDocumentTitle(d) },
+  n_pages: { header: "Pages", getValue: (d) => d.n_pages || "" },
+  doc_date: { header: "Document Date", getValue: (d) => getDocumentDate(d) || "" },
+  doc_id: { header: "Document ID", getValue: (d) => d.external_id },
+  status: { header: "Status", getValue: (d) => d.status || "" },
+  uploaded: { header: "Upload Date", getValue: (d) => d.created_at || "" },
+  updated_at: { header: "Last Modified", getValue: (d) => d.updated_at || "" },
+  file_type: { header: "File Type", getValue: (d) => d.file_type || "" },
+  file_size: { header: "File Size", getValue: (d) => d.file_size || "" },
+  shared: { header: "Shared", getValue: (d) => d.shared ? "Yes" : "No" }
+};
+function buildDocumentMetadataRows(documents, selectedColumns) {
+  const columns = selectedColumns || Object.keys(COLUMN_MAPPING);
+  return documents.map((doc) => {
+    const row = {};
+    for (const colId of columns) {
+      const standard = COLUMN_MAPPING[colId];
+      if (standard) {
+        row[standard.header] = standard.getValue(doc);
+      } else if (colId.startsWith("tag-")) {
+        const bare = colId.replace(/^tag-/, "");
+        const doctag = doc.doctags?.find((dt) => dt.tag_ext_id === colId || dt.tag_ext_id === bare);
+        if (doctag) row[colId] = doctag.note || "Yes";
+      }
+    }
+    return row;
+  });
+}
+function archiveName(workspaceName, suffix) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const sanitizedName = (workspaceName || "workspace").replace(/[^a-z0-9-_]/gi, "_");
+  return `${date}_${sanitizedName}_${suffix}.zip`;
+}
+export {
+  archiveName,
+  buildDocumentMetadataRows,
+  fallbackFileName
+};
+//# sourceMappingURL=document-download.js.map

package/dist/documents/document-download.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/document-download.ts"],
+  "sourcesContent": ["/**\n * Document download building blocks shared by the documents ZIP (`useDownloadDocuments`) and a\n * workspace export archive: name a file and the archive, and build the metadata rows of\n * `index.csv`. Fetching and saving are the document tools' `fetchDocumentFile` and `downloadBlob`.\n */\n\nimport type { WorkspaceDocument as Doc } from './documents-cache'\nimport { getDocumentDate } from './document-fields'\nimport { getDocumentTitle } from '../entities/DocumentEntity'\n\n/** The ZIP entry name for a document when the server did not name it. */\nexport function fallbackFileName(doc: Doc): string {\n  if (doc.file_name) return doc.file_name\n  const title = getDocumentTitle(doc, `document-${doc.external_id}`)\n  const extension = doc.file_type || 'pdf'\n  const ext = extension.startsWith('.') ? extension : `.${extension}`\n  return title.toLowerCase().endsWith(ext.toLowerCase()) ? title : `${title}${ext}`\n}\n\nconst COLUMN_MAPPING: Record<string, { header: string; getValue: (d: Doc) => string | number }> = {\n  file_name: {\n    header: 'File Name',\n    getValue: (d) => d.file_name || getDocumentTitle(d, `document-${d.external_id}.pdf`),\n  },\n  title: { header: 'Title', getValue: (d) => getDocumentTitle(d) },\n  n_pages: { header: 'Pages', getValue: (d) => d.n_pages || '' },\n  doc_date: { header: 'Document Date', getValue: (d) => getDocumentDate(d) || '' },\n  doc_id: { header: 'Document ID', getValue: (d) => d.external_id },\n  status: { header: 'Status', getValue: (d) => d.status || '' },\n  uploaded: { header: 'Upload Date', getValue: (d) => d.created_at || '' },\n  updated_at: { header: 'Last Modified', getValue: (d) => d.updated_at || '' },\n  file_type: { header: 'File Type', getValue: (d) => d.file_type || '' },\n  file_size: { header: 'File Size', getValue: (d) => d.file_size || '' },\n  shared: { header: 'Shared', getValue: (d) => (d.shared ? 'Yes' : 'No') },\n}\n\n/**\n * One `index.csv` row per document for the chosen columns (`undefined` = every\n * standard column). A `tag-\u2026` column holds that tag's value, or \"Yes\" for a\n * label without one.\n */\nexport function buildDocumentMetadataRows(\n  documents: Doc[],\n  selectedColumns?: string[]\n): Record<string, string | number>[] {\n  const columns = selectedColumns || Object.keys(COLUMN_MAPPING)\n  return documents.map((doc) => {\n    const row: Record<string, string | number> = {}\n    for (const colId of columns) {\n      const standard = COLUMN_MAPPING[colId]\n      if (standard) {\n        row[standard.header] = standard.getValue(doc)\n      } else if (colId.startsWith('tag-')) {\n        // Column ids are tag ext ids; older callers passed them without the prefix.\n        const bare = colId.replace(/^tag-/, '')\n        const doctag = doc.doctags?.find((dt) => dt.tag_ext_id === colId || dt.tag_ext_id === bare)\n        if (doctag) row[colId] = doctag.note || 'Yes'\n      }\n    }\n    return row\n  })\n}\n\n/** `2026-10-15_My_Workspace_<suffix>.zip` */\nexport function archiveName(workspaceName: string | undefined, suffix: string): string {\n  const date = new Date().toISOString().split('T')[0]\n  const sanitizedName = (workspaceName || 'workspace').replace(/[^a-z0-9-_]/gi, '_')\n  return `${date}_${sanitizedName}_${suffix}.zip`\n}\n"],
+  "mappings": "AAOA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAG1B,SAAS,iBAAiB,KAAkB;AACjD,MAAI,IAAI,UAAW,QAAO,IAAI;AAC9B,QAAM,QAAQ,iBAAiB,KAAK,YAAY,IAAI,WAAW,EAAE;AACjE,QAAM,YAAY,IAAI,aAAa;AACnC,QAAM,MAAM,UAAU,WAAW,GAAG,IAAI,YAAY,IAAI,SAAS;AACjE,SAAO,MAAM,YAAY,EAAE,SAAS,IAAI,YAAY,CAAC,IAAI,QAAQ,GAAG,KAAK,GAAG,GAAG;AACjF;AAEA,MAAM,iBAA4F;AAAA,EAChG,WAAW;AAAA,IACT,QAAQ;AAAA,IACR,UAAU,CAAC,MAAM,EAAE,aAAa,iBAAiB,GAAG,YAAY,EAAE,WAAW,MAAM;AAAA,EACrF;AAAA,EACA,OAAO,EAAE,QAAQ,SAAS,UAAU,CAAC,MAAM,iBAAiB,CAAC,EAAE;AAAA,EAC/D,SAAS,EAAE,QAAQ,SAAS,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG;AAAA,EAC7D,UAAU,EAAE,QAAQ,iBAAiB,UAAU,CAAC,MAAM,gBAAgB,CAAC,KAAK,GAAG;AAAA,EAC/E,QAAQ,EAAE,QAAQ,eAAe,UAAU,CAAC,MAAM,EAAE,YAAY;AAAA,EAChE,QAAQ,EAAE,QAAQ,UAAU,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG;AAAA,EAC5D,UAAU,EAAE,QAAQ,eAAe,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG;AAAA,EACvE,YAAY,EAAE,QAAQ,iBAAiB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG;AAAA,EAC3E,WAAW,EAAE,QAAQ,aAAa,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG;AAAA,EACrE,WAAW,EAAE,QAAQ,aAAa,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG;AAAA,EACrE,QAAQ,EAAE,QAAQ,UAAU,UAAU,CAAC,MAAO,EAAE,SAAS,QAAQ,KAAM;AACzE;AAOO,SAAS,0BACd,WACA,iBACmC;AACnC,QAAM,UAAU,mBAAmB,OAAO,KAAK,cAAc;AAC7D,SAAO,UAAU,IAAI,CAAC,QAAQ;AAC5B,UAAM,MAAuC,CAAC;AAC9C,eAAW,SAAS,SAAS;AAC3B,YAAM,WAAW,eAAe,KAAK;AACrC,UAAI,UAAU;AACZ,YAAI,SAAS,MAAM,IAAI,SAAS,SAAS,GAAG;AAAA,MAC9C,WAAW,MAAM,WAAW,MAAM,GAAG;AAEnC,cAAM,OAAO,MAAM,QAAQ,SAAS,EAAE;AACtC,cAAM,SAAS,IAAI,SAAS,KAAK,CAAC,OAAO,GAAG,eAAe,SAAS,GAAG,eAAe,IAAI;AAC1F,YAAI,OAAQ,KAAI,KAAK,IAAI,OAAO,QAAQ;AAAA,MAC1C;AAAA,IACF;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAGO,SAAS,YAAY,eAAmC,QAAwB;AACrF,QAAM,QAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAClD,QAAM,iBAAiB,iBAAiB,aAAa,QAAQ,iBAAiB,GAAG;AACjF,SAAO,GAAG,IAAI,IAAI,aAAa,IAAI,MAAM;AAC3C;",
+  "names": []
+}

package/dist/documents/document-fields.js

@@ -0,0 +1,109 @@
+const ADDABLE_STATUSES = /* @__PURE__ */ new Set(["completed", "empty", "low-content"]);
+const isDocumentAddableToConversation = (document) => {
+  if (!document) return false;
+  if (!document.status) return true;
+  return ADDABLE_STATUSES.has(document.status.toLowerCase());
+};
+const getDocumentDate = (document) => {
+  if (!document) return void 0;
+  return document.doc_metadata?.doc_date;
+};
+const formatDocDate = (value) => {
+  if (!value) return "";
+  if (value.includes("T")) {
+    const d = new Date(value);
+    if (!Number.isNaN(d.getTime())) {
+      const pad = (n) => String(n).padStart(2, "0");
+      return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+    }
+  }
+  return value;
+};
+const getDocumentNature = (document) => {
+  if (!document) return void 0;
+  return document.doc_metadata?.doc_nature;
+};
+const getDocumentAuthor = (document) => {
+  if (!document) return void 0;
+  return document.doc_metadata?.doc_author;
+};
+const getDocumentSubject = (document) => {
+  if (!document) return void 0;
+  return document.doc_metadata?.doc_subject;
+};
+const DEFAULT_METADATA_TAGS = [
+  { name: "doc_date", label: "Date" },
+  { name: "doc_nature", label: "Type" },
+  { name: "doc_author", label: "Author" },
+  { name: "doc_subject", label: "Abstract" }
+];
+const canonicalFolderPath = (folder) => {
+  if (!folder) return null;
+  const segments = folder.split("/").map((segment) => segment.trim()).filter(Boolean);
+  return segments.length > 0 ? segments.join("/") : null;
+};
+const buildFolderTree = (docs) => {
+  const counts = /* @__PURE__ */ new Map();
+  let unfiledCount = 0;
+  for (const doc of docs) {
+    const folder = canonicalFolderPath(doc.folder);
+    if (!folder) {
+      unfiledCount++;
+      continue;
+    }
+    const parts = folder.split("/");
+    for (let i = 1; i <= parts.length; i++) {
+      const path = parts.slice(0, i).join("/");
+      counts.set(path, (counts.get(path) ?? 0) + 1);
+    }
+  }
+  const nodes = [...counts.keys()].sort((a, b) => a.localeCompare(b)).map((path) => ({
+    path,
+    label: path.split("/").pop() ?? path,
+    depth: path.split("/").length - 1,
+    count: counts.get(path) ?? 0
+  }));
+  return { nodes, unfiledCount };
+};
+const formatFolderLabel = (path) => {
+  if (!path) return "";
+  const parts = path.split("/");
+  const name = parts[parts.length - 1] || path;
+  const depth = parts.length - 1;
+  if (depth === 0) return name;
+  return "../".repeat(depth) + name;
+};
+const COLUMN_LABEL_FALLBACKS = {
+  title: "Document Name",
+  doc_nature: "Type",
+  doc_author: "Author",
+  doc_subject: "Abstract",
+  doc_date: "Date",
+  n_pages: "Pages",
+  created_at: "Uploaded",
+  updated_at: "Last modified",
+  file_name: "File name",
+  file_size: "Size",
+  file_type: "File type",
+  shared: "Shared",
+  inConversation: "In chat",
+  created_by: "By",
+  sender: "From",
+  all_tags: "Labels",
+  doc_id: "DocID",
+  related: "Related"
+};
+export {
+  COLUMN_LABEL_FALLBACKS,
+  DEFAULT_METADATA_TAGS,
+  buildFolderTree,
+  canonicalFolderPath,
+  formatDocDate,
+  formatFolderLabel,
+  getDocumentAuthor,
+  getDocumentDate,
+  getDocumentNature,
+  getDocumentSubject,
+  isDocumentAddableToConversation
+};
+//# sourceMappingURL=document-fields.js.map

package/dist/documents/document-fields.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/document-fields.ts"],
+  "sourcesContent": ["/**\n * A document's fields as the lists show them: the metadata the pipeline extracts (date, type,\n * author, abstract), whether it can join a conversation, and its folder path in canonical form\n * (the form folder filters and the explorer navigate by).\n */\n\n/** What these read of a document (a workspace document has them all). */\ninterface Doc {\n  status?: string | null\n  doc_metadata?: {\n    doc_date?: string | null\n    doc_nature?: string | null\n    doc_author?: string | null\n    doc_subject?: string | null\n  } | null\n}\n\n/**\n * Statuses for which a document carries usable content and can be attached to a\n * conversation. A document with no status yet is treated as addable (optimistic).\n * Terminal-but-unusable states ('failed', 'skipped') and in-progress states\n * ('processing', 'queued') are NOT addable.\n */\nconst ADDABLE_STATUSES = new Set(['completed', 'empty', 'low-content'])\n\n/**\n * Whether a document can be added to a conversation. This is the single source\n * of truth shared by the add flow (`useAddToConversation`) and any UI that\n * counts/enables an \"Add\" affordance \u2014 so a badge never advertises a document\n * that the add flow will silently refuse (e.g. a 'skipped' document).\n */\nexport const isDocumentAddableToConversation = (document: Doc | null | undefined): boolean => {\n  if (!document) return false\n  if (!document.status) return true\n  return ADDABLE_STATUSES.has(document.status.toLowerCase())\n}\n\n/**\n * Gets the date of a document from doc_metadata.\n * @param document Document to get date from\n * @returns Document date string or undefined\n */\nexport const getDocumentDate = (document: Doc | null | undefined): string | null | undefined => {\n  if (!document) return undefined\n  return document.doc_metadata?.doc_date\n}\n\n/**\n * Format a doc_date for display. Date-only values (\"YYYY-MM-DD\") are shown as-is;\n * full datetimes (e.g. emails, \"...T14:30:00Z\") are shown as \"YYYY-MM-DD HH:MM\"\n * in local time. Invalid/empty values return an empty string.\n */\nexport const formatDocDate = (value?: string | null): string => {\n  if (!value) return ''\n  if (value.includes('T')) {\n    const d = new Date(value)\n    if (!Number.isNaN(d.getTime())) {\n      const pad = (n: number) => String(n).padStart(2, '0')\n      return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`\n    }\n  }\n  return value\n}\n\n/**\n * Gets the document nature (type) from doc_metadata.\n * @param document Document to get nature from\n * @returns Document nature (e.g., email, contract, memorandum) or undefined\n */\nexport const getDocumentNature = (document: Doc | null | undefined): string | null | undefined => {\n  if (!document) return undefined\n  return document.doc_metadata?.doc_nature\n}\n\n/**\n * Gets the document author from doc_metadata.\n * @param document Document to get author from\n * @returns Document author or undefined\n */\nexport const getDocumentAuthor = (document: Doc | null | undefined): string | null | undefined => {\n  if (!document) return undefined\n  return document.doc_metadata?.doc_author\n}\n\n/**\n * Gets the document subject from doc_metadata.\n * @param document Document to get subject from\n * @returns Document subject or undefined\n */\nexport const getDocumentSubject = (document: Doc | null | undefined): string | null | undefined => {\n  if (!document) return undefined\n  return document.doc_metadata?.doc_subject\n}\n\n/**\n * Default metadata tags that are automatically applied to all documents during indexing.\n * These are generated by AI during document processing and cannot be disabled.\n * Keep in sync with backend DocTagLLMConfig.DEFAULT_METADATA_TAGS\n */\nexport const DEFAULT_METADATA_TAGS = [\n  { name: 'doc_date', label: 'Date' },\n  { name: 'doc_nature', label: 'Type' },\n  { name: 'doc_author', label: 'Author' },\n  { name: 'doc_subject', label: 'Abstract' },\n] as const\n\n/**\n * Canonicalizes a `Doc.folder` path: trims each segment and drops empty ones,\n * returning null for a blank path. Drive-synced folders use provider names\n * verbatim, which can carry stray whitespace (\"Google Drive (u)/Reports \");\n * the explorer navigates via trimmed segments, so folder filter IDs and\n * navigation keys must agree on this canonical form.\n */\nexport const canonicalFolderPath = (folder: string | null | undefined): string | null => {\n  if (!folder) return null\n  const segments = folder\n    .split('/')\n    .map((segment) => segment.trim())\n    .filter(Boolean)\n  return segments.length > 0 ? segments.join('/') : null\n}\n\n/** One row of a folder picker: the folder itself plus every ancestor above it. */\nexport interface FolderTreeNode {\n  /** Canonical path \u2014 the same form folder filter IDs are built from. */\n  path: string\n  /** Last segment, for display. */\n  label: string\n  /** How far down the tree, for indentation. */\n  depth: number\n  /** Documents at or below this folder. */\n  count: number\n}\n\n/**\n * Builds the folder rows a picker shows, from the documents themselves.\n *\n * Every path here is canonical, and that is the point: a folder filter ID is\n * `folder:${canonicalFolderPath(doc.folder)}`, and an ID outside that set is\n * dropped as invalid \u2014 so a picker that emitted the raw path (\" Reports / Q1 \",\n * or \"/Inbox\" with its phantom blank root) would send the view back to \"All\"\n * instead of into the folder the user clicked.\n */\nexport const buildFolderTree = (\n  docs: { folder?: string | null }[]\n): { nodes: FolderTreeNode[]; unfiledCount: number } => {\n  const counts = new Map<string, number>()\n  let unfiledCount = 0\n\n  for (const doc of docs) {\n    const folder = canonicalFolderPath(doc.folder)\n    if (!folder) {\n      unfiledCount++\n      continue\n    }\n    const parts = folder.split('/')\n    for (let i = 1; i <= parts.length; i++) {\n      const path = parts.slice(0, i).join('/')\n      counts.set(path, (counts.get(path) ?? 0) + 1)\n    }\n  }\n\n  const nodes = [...counts.keys()]\n    .sort((a, b) => a.localeCompare(b))\n    .map((path) => ({\n      path,\n      label: path.split('/').pop() ?? path,\n      depth: path.split('/').length - 1,\n      count: counts.get(path) ?? 0,\n    }))\n\n  return { nodes, unfiledCount }\n}\n\n/**\n * Formats a folder path for display: \"Reports/Q1/January\" \u2192 \"../../January\"\n * Shows depth via `../` prefixes and only the last segment name.\n * @param path Folder path string (slash-separated)\n * @returns Formatted display label\n */\nexport const formatFolderLabel = (path: string | null | undefined): string => {\n  if (!path) return ''\n  const parts = path.split('/')\n  const name = parts[parts.length - 1] || path\n  const depth = parts.length - 1\n  if (depth === 0) return name\n  return '../'.repeat(depth) + name\n}\n\n/**\n * Fallback labels for standard document columns when grid isn't ready yet.\n * These match the headerName values in createDocumentColumns.tsx.\n */\nexport const COLUMN_LABEL_FALLBACKS: Record<string, string> = {\n  title: 'Document Name',\n  doc_nature: 'Type',\n  doc_author: 'Author',\n  doc_subject: 'Abstract',\n  doc_date: 'Date',\n  n_pages: 'Pages',\n  created_at: 'Uploaded',\n  updated_at: 'Last modified',\n  file_name: 'File name',\n  file_size: 'Size',\n  file_type: 'File type',\n  shared: 'Shared',\n  inConversation: 'In chat',\n  created_by: 'By',\n  sender: 'From',\n  all_tags: 'Labels',\n  doc_id: 'DocID',\n  related: 'Related',\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/documents/documents-cache.js

@@ -0,0 +1,110 @@
+import { arbiQueryKeys } from "../hooks.js";
+const rowListeners = /* @__PURE__ */ new Set();
+function subscribeDocumentRows(listener) {
+  rowListeners.add(listener);
+  return () => {
+    rowListeners.delete(listener);
+  };
+}
+function getCachedDocuments(qc, workspaceId) {
+  if (!workspaceId) return void 0;
+  return qc.getQueryData(arbiQueryKeys.documents(workspaceId));
+}
+function cachedLists(qc) {
+  return qc.getQueriesData({ queryKey: arbiQueryKeys.allDocuments() }).flatMap(
+    ([key, data]) => typeof key[2] === "string" && Array.isArray(data) ? [[key[2], data]] : []
+  );
+}
+function diffRows(workspaceId, before, after) {
+  const beforeById = new Map(before.map((doc) => [doc.external_id, doc]));
+  const add = [];
+  const update = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const doc of after) {
+    seen.add(doc.external_id);
+    const previous = beforeById.get(doc.external_id);
+    if (!previous) add.push(doc);
+    else if (previous !== doc) update.push(doc);
+  }
+  const remove = [...beforeById.keys()].filter((id) => !seen.has(id));
+  return { workspaceId, add, update, remove };
+}
+function patchDocuments(qc, reducer, workspaceId) {
+  const lists = workspaceId ? (() => {
+    const current = getCachedDocuments(qc, workspaceId);
+    return current ? [[workspaceId, current]] : [];
+  })() : cachedLists(qc);
+  for (const [id, before] of lists) {
+    const after = reducer(before);
+    if (after === before) continue;
+    qc.setQueryData(arbiQueryKeys.documents(id), after);
+    const change = diffRows(id, before, after);
+    const beforeById = new Map(before.map((doc) => [doc.external_id, doc]));
+    if (change.update.some(
+      (doc) => doc.current_version !== beforeById.get(doc.external_id)?.current_version
+    ))
+      void qc.invalidateQueries({ queryKey: arbiQueryKeys.allDocumentVersions() });
+    if (change.add.length || change.update.length || change.remove.length)
+      for (const listener of rowListeners) listener(change);
+  }
+}
+function upsertDocuments(qc, documents, workspaceId) {
+  if (!documents.length) return;
+  const byId = new Map(documents.map((doc) => [doc.external_id, doc]));
+  const byWorkspace = /* @__PURE__ */ new Map();
+  for (const doc of documents) {
+    const ws = workspaceId ?? doc.workspace_ext_id;
+    byWorkspace.set(ws, [...byWorkspace.get(ws) ?? [], doc]);
+  }
+  for (const [ws, incoming] of byWorkspace) {
+    patchDocuments(
+      qc,
+      (old) => {
+        const known = new Set(old.map((doc) => doc.external_id));
+        return [
+          ...old.map((doc) => byId.get(doc.external_id) ?? doc),
+          ...incoming.filter((doc) => !known.has(doc.external_id))
+        ];
+      },
+      ws
+    );
+  }
+}
+function setCachedDocument(qc, doc) {
+  qc.setQueryData(arbiQueryKeys.document(doc.external_id), doc);
+}
+function patchCachedDocument(qc, docId, reducer) {
+  const current = qc.getQueryData(arbiQueryKeys.document(docId));
+  if (current) qc.setQueryData(arbiQueryKeys.document(docId), reducer(current));
+}
+function dropTagFromCachedDocuments(qc, tagId) {
+  const strip = (doc) => {
+    const doctags = doc.doctags?.filter((dt) => dt.tag_ext_id !== tagId);
+    return doctags && doctags.length !== doc.doctags?.length ? { ...doc, doctags } : doc;
+  };
+  const carriers = [];
+  patchDocuments(qc, (docs) => {
+    const next = docs.map(strip);
+    next.forEach((doc, i) => doc !== docs[i] && carriers.push(doc.external_id));
+    return carriers.length ? next : docs;
+  });
+  for (const id of carriers) patchCachedDocument(qc, id, strip);
+}
+function forgetDocuments(qc, docIds) {
+  for (const id of docIds) {
+    qc.removeQueries({ queryKey: arbiQueryKeys.document(id) });
+    qc.removeQueries({ queryKey: arbiQueryKeys.documentVersions(id) });
+    qc.removeQueries({ queryKey: arbiQueryKeys.parsedDocument(id) });
+  }
+}
+export {
+  dropTagFromCachedDocuments,
+  forgetDocuments,
+  getCachedDocuments,
+  patchCachedDocument,
+  patchDocuments,
+  setCachedDocument,
+  subscribeDocumentRows,
+  upsertDocuments
+};
+//# sourceMappingURL=documents-cache.js.map

package/dist/documents/documents-cache.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/documents-cache.ts"],
+  "sourcesContent": ["/**\n * The workspace documents list in the query cache: one entry per workspace\n * (`arbiQueryKeys.documents(workspaceId)`), read once (progressively, see `documents-loader.ts`)\n * and then kept current in place. Every write goes through {@link patchDocuments}, which also\n * tells row listeners (a grid that applies row transactions instead of re-diffing the whole list)\n * exactly which rows were added, changed or removed.\n *\n * A single document's own entry (`arbiQueryKeys.document(id)`, read by a viewer) is patched next to\n * the list by {@link setCachedDocument}, so a viewer never blanks while a write settles.\n */\n\nimport type { QueryClient } from '@tanstack/react-query'\nimport type { components } from '@arbidocs/client'\nimport { arbiQueryKeys } from '../hooks'\n\n/** A document as the server lists it. */\nexport type WorkspaceDocument = components['schemas']['DocResponse']\n\n/** The rows one write added, changed and removed (removed: by id). */\nexport interface DocumentRowChange {\n  workspaceId: string\n  add: WorkspaceDocument[]\n  update: WorkspaceDocument[]\n  remove: string[]\n}\n\ntype RowListener = (change: DocumentRowChange) => void\n\nconst rowListeners = new Set<RowListener>()\n\n/**\n * Follow the row-level changes of every write to a workspace documents list (a grid applying them\n * as transactions). Returns the unsubscribe.\n */\nexport function subscribeDocumentRows(listener: RowListener): () => void {\n  rowListeners.add(listener)\n  return () => {\n    rowListeners.delete(listener)\n  }\n}\n\n/** The cached documents of a workspace (`undefined` before its list has been read). */\nexport function getCachedDocuments(\n  qc: QueryClient,\n  workspaceId: string | null | undefined\n): WorkspaceDocument[] | undefined {\n  if (!workspaceId) return undefined\n  return qc.getQueryData<WorkspaceDocument[]>(arbiQueryKeys.documents(workspaceId))\n}\n\n/** Every cached workspace documents list, with its workspace. */\nfunction cachedLists(qc: QueryClient): Array<[string, WorkspaceDocument[]]> {\n  return qc\n    .getQueriesData<WorkspaceDocument[]>({ queryKey: arbiQueryKeys.allDocuments() })\n    .flatMap(([key, data]) =>\n      typeof key[2] === 'string' && Array.isArray(data) ? [[key[2], data]] : []\n    )\n}\n\n/** Diff two versions of a list by id. */\nfunction diffRows(\n  workspaceId: string,\n  before: WorkspaceDocument[],\n  after: WorkspaceDocument[]\n): DocumentRowChange {\n  const beforeById = new Map(before.map((doc) => [doc.external_id, doc]))\n  const add: WorkspaceDocument[] = []\n  const update: WorkspaceDocument[] = []\n  const seen = new Set<string>()\n  for (const doc of after) {\n    seen.add(doc.external_id)\n    const previous = beforeById.get(doc.external_id)\n    if (!previous) add.push(doc)\n    else if (previous !== doc) update.push(doc)\n  }\n  const remove = [...beforeById.keys()].filter((id) => !seen.has(id))\n  return { workspaceId, add, update, remove }\n}\n\n/**\n * Apply `reducer` to a workspace's documents list, or (no `workspaceId`) to every cached one: the\n * one place a list is written after it was read. Returning the same array is a no-op. Row\n * listeners get the diff; a document that moved to a new version makes the open version lists\n * re-read. A workspace whose list has not been read is left alone (its first read brings it).\n */\nexport function patchDocuments(\n  qc: QueryClient,\n  reducer: (documents: WorkspaceDocument[]) => WorkspaceDocument[],\n  workspaceId?: string | null\n): void {\n  const lists: Array<[string, WorkspaceDocument[]]> = workspaceId\n    ? (() => {\n        const current = getCachedDocuments(qc, workspaceId)\n        return current ? [[workspaceId, current] as [string, WorkspaceDocument[]]] : []\n      })()\n    : cachedLists(qc)\n  for (const [id, before] of lists) {\n    const after = reducer(before)\n    if (after === before) continue\n    qc.setQueryData(arbiQueryKeys.documents(id), after)\n    const change = diffRows(id, before, after)\n    const beforeById = new Map(before.map((doc) => [doc.external_id, doc]))\n    if (\n      change.update.some(\n        (doc) => doc.current_version !== beforeById.get(doc.external_id)?.current_version\n      )\n    )\n      void qc.invalidateQueries({ queryKey: arbiQueryKeys.allDocumentVersions() })\n    if (change.add.length || change.update.length || change.remove.length)\n      for (const listener of rowListeners) listener(change)\n  }\n}\n\n/** Put `doc` in its list in place, or at the end when the list does not hold it yet. */\nexport function upsertDocuments(\n  qc: QueryClient,\n  documents: WorkspaceDocument[],\n  workspaceId?: string | null\n): void {\n  if (!documents.length) return\n  const byId = new Map(documents.map((doc) => [doc.external_id, doc]))\n  const byWorkspace = new Map<string, WorkspaceDocument[]>()\n  for (const doc of documents) {\n    const ws = workspaceId ?? doc.workspace_ext_id\n    byWorkspace.set(ws, [...(byWorkspace.get(ws) ?? []), doc])\n  }\n  for (const [ws, incoming] of byWorkspace) {\n    patchDocuments(\n      qc,\n      (old) => {\n        const known = new Set(old.map((doc) => doc.external_id))\n        return [\n          ...old.map((doc) => byId.get(doc.external_id) ?? doc),\n          ...incoming.filter((doc) => !known.has(doc.external_id)),\n        ]\n      },\n      ws\n    )\n  }\n}\n\n/** Write a document's own entry (what `useDocument` reads), keeping a viewer current. */\nexport function setCachedDocument(qc: QueryClient, doc: WorkspaceDocument): void {\n  qc.setQueryData(arbiQueryKeys.document(doc.external_id), doc)\n}\n\n/** Apply `reducer` to a document's own entry, when one is cached. */\nexport function patchCachedDocument(\n  qc: QueryClient,\n  docId: string,\n  reducer: (doc: WorkspaceDocument) => WorkspaceDocument\n): void {\n  const current = qc.getQueryData<WorkspaceDocument | null>(arbiQueryKeys.document(docId))\n  if (current) qc.setQueryData(arbiQueryKeys.document(docId), reducer(current))\n}\n\n/** A deleted tag leaves every cached document that carried it: the lists' rows and their entries. */\nexport function dropTagFromCachedDocuments(qc: QueryClient, tagId: string): void {\n  const strip = (doc: WorkspaceDocument): WorkspaceDocument => {\n    const doctags = doc.doctags?.filter((dt) => dt.tag_ext_id !== tagId)\n    return doctags && doctags.length !== doc.doctags?.length ? { ...doc, doctags } : doc\n  }\n  const carriers: string[] = []\n  patchDocuments(qc, (docs) => {\n    const next = docs.map(strip)\n    next.forEach((doc, i) => doc !== docs[i] && carriers.push(doc.external_id))\n    return carriers.length ? next : docs\n  })\n  for (const id of carriers) patchCachedDocument(qc, id, strip)\n}\n\n/** Forget everything cached about deleted documents, so nothing re-reads them into a 404. */\nexport function forgetDocuments(qc: QueryClient, docIds: string[]): void {\n  for (const id of docIds) {\n    qc.removeQueries({ queryKey: arbiQueryKeys.document(id) })\n    qc.removeQueries({ queryKey: arbiQueryKeys.documentVersions(id) })\n    qc.removeQueries({ queryKey: arbiQueryKeys.parsedDocument(id) })\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}