@arbidocs/react 0.5.111 → 0.5.113

package/dist/workspaces/switch.js

@@ -0,0 +1,234 @@
+import { useEffect, useMemo, useRef } from "react";
+import { onlineManager, useQueryClient } from "@tanstack/react-query";
+import {
+  ArbiWorkspaceSupersededError
+} from "@arbidocs/sdk/browser";
+import { isAbortError } from "@arbidocs/client";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys, useWorkspaces } from "../hooks.js";
+import { useArbiSessionState, useArbiSessionStore } from "../session/index.js";
+import { notify } from "../notifications/notify-store.js";
+import { getEntityLabel } from "../entities/registry.js";
+const WORKSPACE_SCOPED_PACKAGE_KEYS = [
+  arbiQueryKeys.allDocuments(),
+  arbiQueryKeys.allSimilarDocuments(),
+  arbiQueryKeys.allWorkspaceUsers(),
+  arbiQueryKeys.documentSignatures(),
+  arbiQueryKeys.signatureRequests(),
+  arbiQueryKeys.databases()
+];
+function drainWorkspaceQueries(queryClient) {
+  for (const queryKey of WORKSPACE_SCOPED_PACKAGE_KEYS) {
+    void queryClient.cancelQueries({ queryKey });
+    queryClient.removeQueries({ queryKey });
+  }
+}
+function seedOpenedWorkspace(queryClient, workspaceId, opened) {
+  if (opened.conversations)
+    queryClient.setQueryData(arbiQueryKeys.conversations(workspaceId), opened.conversations);
+  if (opened.tags) queryClient.setQueryData(arbiQueryKeys.tags(workspaceId), opened.tags);
+}
+function isWorkspaceArchivedError(error) {
+  const body = error?.apiError ?? error;
+  const detail = body?.detail;
+  return !!detail && typeof detail === "object" && detail.code === "workspace_archived";
+}
+const archivedWorkspaceMessage = (name) => `"${name}" is archived. Its owner can unarchive it from the workspace list.`;
+const listedWorkspace = (queryClient, workspaceId) => queryClient.getQueryData(arbiQueryKeys.workspaces())?.find((w) => w.external_id === workspaceId);
+let switchEpoch = 0;
+const switching = /* @__PURE__ */ new Set();
+const resetSwitchEpochForTests = () => {
+  switchEpoch = 0;
+  switching.clear();
+};
+const SIGNED_IN_WAIT_MS = 1e4;
+const SIGNED_IN_POLL_MS = 50;
+async function signedIn(arbi, timeoutMs = SIGNED_IN_WAIT_MS) {
+  const deadline = Date.now() + timeoutMs;
+  while (!arbi().isLoggedIn && arbi().session?.getState().signedIn === true && Date.now() < deadline) {
+    await new Promise((resolve) => setTimeout(resolve, SIGNED_IN_POLL_MS));
+  }
+}
+async function switchesSettled() {
+  while (switching.size > 0) await Promise.allSettled([...switching]);
+}
+function createWorkspaceSwitch({
+  arbi,
+  session,
+  queryClient
+}) {
+  const switchWorkspace = (target) => {
+    const run = runSwitch(target);
+    switching.add(run);
+    void run.finally(() => switching.delete(run));
+    return run;
+  };
+  const runSwitch = async (target) => {
+    const { workspaceId: previousId, workspaceStatus } = session.getState();
+    const isSame = previousId === target.id;
+    if (isSame && workspaceStatus === "open") return true;
+    const listed = listedWorkspace(queryClient, target.id);
+    const name = target.name || listed?.name || "";
+    const noun = getEntityLabel("WORKSPACE");
+    if (listed?.archive) {
+      notify.info(archivedWorkspaceMessage(name));
+      return false;
+    }
+    if (!isSame && !onlineManager.isOnline()) {
+      notify.info(
+        `You're offline \u2014 you can only use the ${noun} you're already in. Reconnect to switch.`
+      );
+      return false;
+    }
+    const epoch = ++switchEpoch;
+    notify.info(`Opening "${name}" ${noun}\u2026`, { workspaceId: target.id, duration: 2e3 });
+    await signedIn(arbi);
+    if (epoch !== switchEpoch) return false;
+    if (!isSame) {
+      session.leaveWorkspace();
+      drainWorkspaceQueries(queryClient);
+      session.setWorkspaceId(null);
+    }
+    session.setWorkspaceStatus("opening");
+    performance.mark("arbi:workspace-open:start");
+    let opened;
+    try {
+      opened = await arbi().selectWorkspace(target.id);
+    } catch (error) {
+      if (isAbortError(error)) return false;
+      const superseded = error instanceof ArbiWorkspaceSupersededError;
+      if (!superseded) console.error("[switchWorkspace] /open failed:", error);
+      if (superseded && epoch === switchEpoch) {
+        if (previousId) session.setWorkspaceId(previousId);
+        session.setWorkspaceStatus("closed");
+      } else if (epoch === switchEpoch) {
+        if (previousId) session.setWorkspaceId(previousId);
+        session.setWorkspaceStatus("closed");
+        if (isWorkspaceArchivedError(error)) {
+          notify.info(archivedWorkspaceMessage(name));
+          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() });
+        } else {
+          notify.error(`Failed to open "${name}" ${noun}`);
+        }
+      }
+      return false;
+    }
+    if (epoch !== switchEpoch) return false;
+    seedOpenedWorkspace(queryClient, target.id, opened);
+    performance.mark("arbi:workspace-open:response");
+    session.setWorkspaceId(target.id);
+    session.setWorkspaceStatus("open");
+    return true;
+  };
+  const clearWorkspace = () => {
+    ++switchEpoch;
+    session.leaveWorkspace();
+    drainWorkspaceQueries(queryClient);
+    session.setWorkspaceId(null);
+  };
+  const openSelectedWorkspace = async () => {
+    const workspaceId = session.getState().workspaceId;
+    if (!workspaceId) return false;
+    const epoch = switchEpoch;
+    await signedIn(arbi);
+    if (epoch !== switchEpoch || session.getState().workspaceId !== workspaceId) return false;
+    performance.mark("arbi:workspace-open:start");
+    let opened;
+    try {
+      opened = await arbi().selectWorkspace(workspaceId);
+    } catch (error) {
+      if (!(error instanceof ArbiWorkspaceSupersededError) && !isAbortError(error)) {
+        console.error("[openSelectedWorkspace] /open failed:", error);
+      }
+      return false;
+    }
+    if (epoch !== switchEpoch || session.getState().workspaceId !== workspaceId) return false;
+    seedOpenedWorkspace(queryClient, workspaceId, opened);
+    performance.mark("arbi:workspace-open:response");
+    session.setWorkspaceStatus("open");
+    return true;
+  };
+  return { switchWorkspace, clearWorkspace, openSelectedWorkspace, settled: switchesSettled };
+}
+function useSwitchWorkspace() {
+  const arbi = useArbi();
+  const arbiRef = useRef(arbi);
+  arbiRef.current = arbi;
+  const session = useArbiSessionStore();
+  const queryClient = useQueryClient();
+  useEffect(
+    () => arbi.onSigningOut?.(() => {
+      ++switchEpoch;
+      void queryClient.cancelQueries();
+    }),
+    [arbi, queryClient]
+  );
+  return useMemo(
+    () => createWorkspaceSwitch({ arbi: () => arbiRef.current, session, queryClient }),
+    [session, queryClient]
+  );
+}
+function useOpenSelectedWorkspace() {
+  const arbi = useArbi();
+  const { clearWorkspace, openSelectedWorkspace } = useSwitchWorkspace();
+  const workspaceId = useArbiSessionState((s) => s.workspaceId);
+  const status = useArbiSessionState((s) => s.workspaceStatus);
+  const session = useArbiSessionStore();
+  const queryClient = useQueryClient();
+  const { data: workspaces, isLoading: listing, isFetching } = useWorkspaces();
+  const listed = workspaces;
+  const archived = listed?.find((w) => w.external_id === workspaceId && w.archive);
+  const reads = queryClient.getQueryState(arbiQueryKeys.workspaces())?.dataUpdateCount ?? 0;
+  const opened = useRef({ id: null, reads: 0 });
+  const openId = status === "open" ? workspaceId : null;
+  if (opened.current.id !== openId) opened.current = { id: openId, reads };
+  const gone = !!openId && !!listed && !isFetching && reads > opened.current.reads && !listed.some((w) => w.external_id === openId);
+  useEffect(() => {
+    if (!archived) return;
+    notify.info(archivedWorkspaceMessage(archived.name));
+    clearWorkspace();
+  }, [archived, clearWorkspace]);
+  useEffect(() => {
+    if (gone) clearWorkspace();
+  }, [gone, clearWorkspace]);
+  const opening = useRef(false);
+  const signedIn2 = arbi.isLoggedIn;
+  useEffect(() => {
+    if (!workspaceId || archived || gone || listing || status !== "closed" || !signedIn2 || opening.current)
+      return;
+    opening.current = true;
+    void openSelectedWorkspace().then(async (ok) => {
+      if (ok) return;
+      const fresh = await queryClient.fetchQuery({
+        queryKey: arbiQueryKeys.workspaces(),
+        queryFn: () => arbi.workspaces.list(),
+        staleTime: 0
+      }).catch(() => null);
+      if (fresh && session.getState().workspaceId === workspaceId && !fresh.some((w) => w.external_id === workspaceId))
+        clearWorkspace();
+    }).finally(() => {
+      opening.current = false;
+    });
+  }, [
+    arbi,
+    session,
+    clearWorkspace,
+    openSelectedWorkspace,
+    queryClient,
+    workspaceId,
+    archived,
+    gone,
+    listing,
+    status,
+    signedIn2
+  ]);
+}
+export {
+  archivedWorkspaceMessage,
+  createWorkspaceSwitch,
+  isWorkspaceArchivedError,
+  resetSwitchEpochForTests,
+  useOpenSelectedWorkspace,
+  useSwitchWorkspace
+};
+//# sourceMappingURL=switch.js.map

package/dist/workspaces/switch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workspaces/switch.ts"],
+  "sourcesContent": ["/**\n * Switching the workspace the app is in: the one coordinator for \"the user is now in workspace X\".\n *\n * The server keeps the active workspace in the session, so every workspace-scoped GET reads the\n * workspace currently open for the session. A naive switch (set the id, `/open` in the background)\n * races every observer that refetches when the id changes: those requests reach a server still in\n * the previous workspace and seed the cache with its data. `switchWorkspace` keeps the order:\n *\n *   1. leave the workspace: its session state (`leaveWorkspace`) and its cached queries go, so\n *      nothing shows or refetches the old workspace's data;\n *   2. the selection is cleared, so queries gated on it stop during the round trip;\n *   3. `arbi.selectWorkspace(target)`: the server session is now in the target;\n *   4. the conversations and tags `/open` returned seed their lists, then the selection is\n *      committed (`workspaceId`, `workspaceStatus: 'open'`).\n *\n * Concurrent switches (A, then B, then C in quick succession): only the last one commits, and the\n * SDK runs the opens one at a time with the latest request winning, so the server session ends in\n * the last one too. `settled` waits out the switches in flight.\n *\n * A sign-out (`arbi.onSigningOut`, before the server revokes the token) overtakes every switch and\n * open in flight and cancels the queries in flight: the SDK has already stopped new requests and\n * aborts the ones in flight, so none comes back 401 or is reported as a failure.\n */\n\nimport { useEffect, useMemo, useRef } from 'react'\nimport { onlineManager, useQueryClient, type QueryClient } from '@tanstack/react-query'\nimport {\n  ArbiWorkspaceSupersededError,\n  type Arbi,\n  type WorkspaceOpenResponse,\n} from '@arbidocs/sdk/browser'\nimport { isAbortError } from '@arbidocs/client'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys, useWorkspaces } from '../hooks'\nimport { useArbiSessionState, useArbiSessionStore, type ArbiSessionStore } from '../session'\nimport { notify } from '../notifications/notify-store'\nimport { getEntityLabel } from '../entities/registry'\n\n/**\n * What depends on the session's open workspace: dropped on a switch, so nothing of the workspace\n * left shows in the next, and a return reads it afresh.\n */\nconst WORKSPACE_SCOPED_PACKAGE_KEYS = [\n  arbiQueryKeys.allDocuments(),\n  arbiQueryKeys.allSimilarDocuments(),\n  arbiQueryKeys.allWorkspaceUsers(),\n  arbiQueryKeys.documentSignatures(),\n  arbiQueryKeys.signatureRequests(),\n  arbiQueryKeys.databases(),\n]\n\n/** Cancel (so nothing in flight lands afterwards) and drop every workspace-scoped query. */\nfunction drainWorkspaceQueries(queryClient: QueryClient): void {\n  for (const queryKey of WORKSPACE_SCOPED_PACKAGE_KEYS) {\n    void queryClient.cancelQueries({ queryKey })\n    queryClient.removeQueries({ queryKey })\n  }\n}\n\n/** The conversations and tags `/open` returned seed their lists (patched in place from then on). */\nfunction seedOpenedWorkspace(\n  queryClient: QueryClient,\n  workspaceId: string,\n  opened: WorkspaceOpenResponse\n): void {\n  if (opened.conversations)\n    queryClient.setQueryData(arbiQueryKeys.conversations(workspaceId), opened.conversations)\n  if (opened.tags) queryClient.setQueryData(arbiQueryKeys.tags(workspaceId), opened.tags)\n}\n\n/** The server refused to open an archived workspace (423 `workspace_archived`). */\nexport function isWorkspaceArchivedError(error: unknown): boolean {\n  const body = (error as { apiError?: unknown } | null | undefined)?.apiError ?? error\n  const detail = (body as { detail?: unknown } | null | undefined)?.detail\n  return (\n    !!detail &&\n    typeof detail === 'object' &&\n    (detail as { code?: unknown }).code === 'workspace_archived'\n  )\n}\n\n/** What to tell someone who tried to open an archived workspace. */\nexport const archivedWorkspaceMessage = (name: string) =>\n  `\"${name}\" is archived. Its owner can unarchive it from the workspace list.`\n\ninterface ListedWorkspace {\n  external_id: string\n  name: string\n  archive?: unknown\n}\n\nconst listedWorkspace = (queryClient: QueryClient, workspaceId: string) =>\n  queryClient\n    .getQueryData<ListedWorkspace[]>(arbiQueryKeys.workspaces())\n    ?.find((w) => w.external_id === workspaceId)\n\n// One sequence for every hook instance, so a newer switch anywhere wins.\nlet switchEpoch = 0\n// The switches not yet settled (opened, refused or overtaken).\nconst switching = new Set<Promise<boolean>>()\n\n/** Exported for tests. */\nexport const resetSwitchEpochForTests = () => {\n  switchEpoch = 0\n  switching.clear()\n}\n\n/** How long a switch waits for the signed-in session to reach its `Arbi` (see `signedIn`). */\nconst SIGNED_IN_WAIT_MS = 10_000\nconst SIGNED_IN_POLL_MS = 50\n\n/**\n * Wait until the `Arbi` in scope holds the login. Right after a sign-in (or a reload) the session\n * is signed in before the host's `Arbi` has its keys (a host reads them from the device and then\n * renews its `Arbi`): an open asked for in that window would fail with \"Not logged in\". Resolves\n * at once when it holds them, or when the session is not signed in at all (nothing to wait for).\n */\nasync function signedIn(arbi: () => Arbi, timeoutMs = SIGNED_IN_WAIT_MS): Promise<void> {\n  const deadline = Date.now() + timeoutMs\n  while (\n    !arbi().isLoggedIn &&\n    arbi().session?.getState().signedIn === true &&\n    Date.now() < deadline\n  ) {\n    await new Promise((resolve) => setTimeout(resolve, SIGNED_IN_POLL_MS))\n  }\n}\n\n/** Resolves once no workspace switch is in flight (including any started while waiting). */\nasync function switchesSettled(): Promise<void> {\n  while (switching.size > 0) await Promise.allSettled([...switching])\n}\n\nexport interface SwitchWorkspaceTarget {\n  id: string\n  /** For the notices; default: the name in the workspace list. */\n  name?: string\n}\n\nexport interface UseSwitchWorkspaceResult {\n  /**\n   * Make `target` the workspace the app is in. True once it is open (at once when it already\n   * is); false when it could not be (archived, offline, refused: the user was told), or when a\n   * newer switch overtook it.\n   */\n  switchWorkspace: (target: SwitchWorkspaceTarget) => Promise<boolean>\n  /** Leave the workspace for none (after deleting or leaving it), with the same clean-up. */\n  clearWorkspace: () => void\n  /**\n   * Open the selected workspace on the server session as it is, without leaving anything or a\n   * notice: after a sign-in or a reload (a new server session), or to re-assert it before a write.\n   * False when there is none, it could not be opened, or a switch overtook it.\n   */\n  openSelectedWorkspace: () => Promise<boolean>\n  /**\n   * Resolves once no switch is in flight: the selection is then committed (or back to where it\n   * was), so reading it says which workspace the session is in.\n   */\n  settled: () => Promise<void>\n}\n\n/** What a workspace switch runs on. */\nexport interface WorkspaceSwitchContext {\n  /** The `Arbi` on the signed-in session, as of the switch. */\n  arbi: () => Arbi\n  session: ArbiSessionStore\n  queryClient: QueryClient\n}\n\n/**\n * The workspace switch over a host's session, for code that runs outside `<ArbiHost>` (a host's\n * own environment, built before its host). Inside, use `useSwitchWorkspace`.\n */\nexport function createWorkspaceSwitch({\n  arbi,\n  session,\n  queryClient,\n}: WorkspaceSwitchContext): UseSwitchWorkspaceResult {\n  const switchWorkspace = (target: SwitchWorkspaceTarget): Promise<boolean> => {\n    const run = runSwitch(target)\n    switching.add(run)\n    void run.finally(() => switching.delete(run))\n    return run\n  }\n\n  const runSwitch = async (target: SwitchWorkspaceTarget): Promise<boolean> => {\n    const { workspaceId: previousId, workspaceStatus } = session.getState()\n    const isSame = previousId === target.id\n    if (isSame && workspaceStatus === 'open') return true\n\n    const listed = listedWorkspace(queryClient, target.id)\n    const name = target.name || listed?.name || ''\n    const noun = getEntityLabel('WORKSPACE')\n    // An archived workspace cannot be opened: say so before leaving the current one.\n    if (listed?.archive) {\n      notify.info(archivedWorkspaceMessage(name))\n      return false\n    }\n    // Offline, the user stays in the workspace they are in: another one's lists cannot load.\n    if (!isSame && !onlineManager.isOnline()) {\n      notify.info(\n        `You're offline \u2014 you can only use the ${noun} you're already in. Reconnect to switch.`\n      )\n      return false\n    }\n\n    const epoch = ++switchEpoch\n    notify.info(`Opening \"${name}\" ${noun}\u2026`, { workspaceId: target.id, duration: 2000 })\n    // Signed in, but the keys not on this `Arbi` yet: the open waits for them, not fails.\n    await signedIn(arbi)\n    if (epoch !== switchEpoch) return false\n    // Not yet open (a reload): nothing to leave, it only needs `/open`.\n    if (!isSame) {\n      session.leaveWorkspace()\n      drainWorkspaceQueries(queryClient)\n      session.setWorkspaceId(null)\n    }\n    session.setWorkspaceStatus('opening')\n\n    performance.mark('arbi:workspace-open:start')\n    let opened: WorkspaceOpenResponse\n    try {\n      opened = await arbi().selectWorkspace(target.id)\n    } catch (error) {\n      // A sign-out stopped it: the session is going, nothing to restore or report.\n      if (isAbortError(error)) return false\n      const superseded = error instanceof ArbiWorkspaceSupersededError\n      if (!superseded) console.error('[switchWorkspace] /open failed:', error)\n      // Overtaken before its turn by a newer switch: that one commits. By an open from elsewhere\n      // (no newer switch): back to the previous selection, closed, as for a failure.\n      if (superseded && epoch === switchEpoch) {\n        if (previousId) session.setWorkspaceId(previousId)\n        session.setWorkspaceStatus('closed')\n      } else if (epoch === switchEpoch) {\n        // Back to the previous selection, closed: `useOpenSelectedWorkspace` opens it again.\n        if (previousId) session.setWorkspaceId(previousId)\n        session.setWorkspaceStatus('closed')\n        if (isWorkspaceArchivedError(error)) {\n          // Archived since the list was read: refresh it so it shows as archived.\n          notify.info(archivedWorkspaceMessage(name))\n          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() })\n        } else {\n          notify.error(`Failed to open \"${name}\" ${noun}`)\n        }\n      }\n      return false\n    }\n    // A newer switch started meanwhile: it commits, not this one.\n    if (epoch !== switchEpoch) return false\n\n    seedOpenedWorkspace(queryClient, target.id, opened)\n    performance.mark('arbi:workspace-open:response')\n    session.setWorkspaceId(target.id)\n    session.setWorkspaceStatus('open')\n    return true\n  }\n\n  const clearWorkspace = () => {\n    ++switchEpoch\n    session.leaveWorkspace()\n    drainWorkspaceQueries(queryClient)\n    session.setWorkspaceId(null)\n  }\n\n  const openSelectedWorkspace = async (): Promise<boolean> => {\n    const workspaceId = session.getState().workspaceId\n    if (!workspaceId) return false\n    const epoch = switchEpoch\n    await signedIn(arbi)\n    if (epoch !== switchEpoch || session.getState().workspaceId !== workspaceId) return false\n    performance.mark('arbi:workspace-open:start')\n    let opened: WorkspaceOpenResponse\n    try {\n      opened = await arbi().selectWorkspace(workspaceId)\n    } catch (error) {\n      // Overtaken by a newer open, or stopped by a sign-out: nothing to report.\n      if (!(error instanceof ArbiWorkspaceSupersededError) && !isAbortError(error)) {\n        console.error('[openSelectedWorkspace] /open failed:', error)\n      }\n      return false\n    }\n    // A switch started meanwhile: it commits its own workspace.\n    if (epoch !== switchEpoch || session.getState().workspaceId !== workspaceId) return false\n    seedOpenedWorkspace(queryClient, workspaceId, opened)\n    performance.mark('arbi:workspace-open:response')\n    session.setWorkspaceStatus('open')\n    return true\n  }\n\n  return { switchWorkspace, clearWorkspace, openSelectedWorkspace, settled: switchesSettled }\n}\n\n/** The workspace switch of the `<ArbiHost>` in scope (its `Arbi`, its session state). */\nexport function useSwitchWorkspace(): UseSwitchWorkspaceResult {\n  const arbi = useArbi()\n  const arbiRef = useRef(arbi)\n  arbiRef.current = arbi\n  const session = useArbiSessionStore()\n  const queryClient = useQueryClient()\n  // Signing out: the switches and opens in flight are overtaken, the queries in flight cancelled.\n  useEffect(\n    () =>\n      arbi.onSigningOut?.(() => {\n        ++switchEpoch\n        void queryClient.cancelQueries()\n      }),\n    [arbi, queryClient]\n  )\n  return useMemo(\n    () => createWorkspaceSwitch({ arbi: () => arbiRef.current, session, queryClient }),\n    [session, queryClient]\n  )\n}\n\n/**\n * Keep the selected workspace open on the server session: open it once signed in (after a\n * sign-in or a reload, when the selection was kept but the server session is new), and drop it\n * when the workspace list says it was archived since (by its owner, perhaps on another device),\n * or that it is gone (deleted, or the person left or was removed): the app is then on the\n * workspace list. Mounted once, by the signed-in app.\n */\nexport function useOpenSelectedWorkspace(): void {\n  const arbi = useArbi()\n  const { clearWorkspace, openSelectedWorkspace } = useSwitchWorkspace()\n  const workspaceId = useArbiSessionState((s) => s.workspaceId)\n  const status = useArbiSessionState((s) => s.workspaceStatus)\n  const session = useArbiSessionStore()\n  const queryClient = useQueryClient()\n  const { data: workspaces, isLoading: listing, isFetching } = useWorkspaces()\n  const listed = workspaces as ListedWorkspace[] | undefined\n  const archived = listed?.find((w) => w.external_id === workspaceId && w.archive)\n  // The open workspace is gone (deleted, or the person left or was removed) once a list read after\n  // it was opened no longer has it: one read before (access granted since) may not have it yet.\n  // (Counted, not timed: a read can land in the same millisecond.)\n  const reads = queryClient.getQueryState(arbiQueryKeys.workspaces())?.dataUpdateCount ?? 0\n  const opened = useRef<{ id: string | null; reads: number }>({ id: null, reads: 0 })\n  const openId = status === 'open' ? workspaceId : null\n  if (opened.current.id !== openId) opened.current = { id: openId, reads }\n  const gone =\n    !!openId &&\n    !!listed &&\n    !isFetching &&\n    reads > opened.current.reads &&\n    !listed.some((w) => w.external_id === openId)\n\n  useEffect(() => {\n    if (!archived) return\n    notify.info(archivedWorkspaceMessage(archived.name))\n    clearWorkspace()\n  }, [archived, clearWorkspace])\n\n  useEffect(() => {\n    if (gone) clearWorkspace()\n  }, [gone, clearWorkspace])\n\n  // One open at a time; a failed one is tried again when the session or selection changes.\n  const opening = useRef(false)\n  const signedIn = arbi.isLoggedIn\n  useEffect(() => {\n    // After the workspace list: it says whether the workspace was archived, and it holds the key\n    // the open needs (no list of the open's own).\n    if (\n      !workspaceId ||\n      archived ||\n      gone ||\n      listing ||\n      status !== 'closed' ||\n      !signedIn ||\n      opening.current\n    )\n      return\n    opening.current = true\n    void openSelectedWorkspace()\n      .then(async (ok) => {\n        if (ok) return\n        // Refused: deleted, or left, since (the kept selection of a reload)? The list read now\n        // says. (Not the list a reload restores: it may predate a workspace created since.)\n        const fresh = await queryClient\n          .fetchQuery({\n            queryKey: arbiQueryKeys.workspaces(),\n            queryFn: () => arbi.workspaces.list(),\n            staleTime: 0,\n          })\n          .catch(() => null)\n        if (\n          fresh &&\n          session.getState().workspaceId === workspaceId &&\n          !(fresh as ListedWorkspace[]).some((w) => w.external_id === workspaceId)\n        )\n          clearWorkspace()\n      })\n      .finally(() => {\n        opening.current = false\n      })\n  }, [\n    arbi,\n    session,\n    clearWorkspace,\n    openSelectedWorkspace,\n    queryClient,\n    workspaceId,\n    archived,\n    gone,\n    listing,\n    status,\n    signedIn,\n  ])\n}\n"],
+  "mappings": "AAwBA,SAAS,WAAW,SAAS,cAAc;AAC3C,SAAS,eAAe,sBAAwC;AAChE;AAAA,EACE;AAAA,OAGK;AACP,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,eAAe,qBAAqB;AAC7C,SAAS,qBAAqB,2BAAkD;AAChF,SAAS,cAAc;AACvB,SAAS,sBAAsB;AAM/B,MAAM,gCAAgC;AAAA,EACpC,cAAc,aAAa;AAAA,EAC3B,cAAc,oBAAoB;AAAA,EAClC,cAAc,kBAAkB;AAAA,EAChC,cAAc,mBAAmB;AAAA,EACjC,cAAc,kBAAkB;AAAA,EAChC,cAAc,UAAU;AAC1B;AAGA,SAAS,sBAAsB,aAAgC;AAC7D,aAAW,YAAY,+BAA+B;AACpD,SAAK,YAAY,cAAc,EAAE,SAAS,CAAC;AAC3C,gBAAY,cAAc,EAAE,SAAS,CAAC;AAAA,EACxC;AACF;AAGA,SAAS,oBACP,aACA,aACA,QACM;AACN,MAAI,OAAO;AACT,gBAAY,aAAa,cAAc,cAAc,WAAW,GAAG,OAAO,aAAa;AACzF,MAAI,OAAO,KAAM,aAAY,aAAa,cAAc,KAAK,WAAW,GAAG,OAAO,IAAI;AACxF;AAGO,SAAS,yBAAyB,OAAyB;AAChE,QAAM,OAAQ,OAAqD,YAAY;AAC/E,QAAM,SAAU,MAAkD;AAClE,SACE,CAAC,CAAC,UACF,OAAO,WAAW,YACjB,OAA8B,SAAS;AAE5C;AAGO,MAAM,2BAA2B,CAAC,SACvC,IAAI,IAAI;AAQV,MAAM,kBAAkB,CAAC,aAA0B,gBACjD,YACG,aAAgC,cAAc,WAAW,CAAC,GACzD,KAAK,CAAC,MAAM,EAAE,gBAAgB,WAAW;AAG/C,IAAI,cAAc;AAElB,MAAM,YAAY,oBAAI,IAAsB;AAGrC,MAAM,2BAA2B,MAAM;AAC5C,gBAAc;AACd,YAAU,MAAM;AAClB;AAGA,MAAM,oBAAoB;AAC1B,MAAM,oBAAoB;AAQ1B,eAAe,SAAS,MAAkB,YAAY,mBAAkC;AACtF,QAAM,WAAW,KAAK,IAAI,IAAI;AAC9B,SACE,CAAC,KAAK,EAAE,cACR,KAAK,EAAE,SAAS,SAAS,EAAE,aAAa,QACxC,KAAK,IAAI,IAAI,UACb;AACA,UAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,iBAAiB,CAAC;AAAA,EACvE;AACF;AAGA,eAAe,kBAAiC;AAC9C,SAAO,UAAU,OAAO,EAAG,OAAM,QAAQ,WAAW,CAAC,GAAG,SAAS,CAAC;AACpE;AA0CO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AACF,GAAqD;AACnD,QAAM,kBAAkB,CAAC,WAAoD;AAC3E,UAAM,MAAM,UAAU,MAAM;AAC5B,cAAU,IAAI,GAAG;AACjB,SAAK,IAAI,QAAQ,MAAM,UAAU,OAAO,GAAG,CAAC;AAC5C,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,WAAoD;AAC3E,UAAM,EAAE,aAAa,YAAY,gBAAgB,IAAI,QAAQ,SAAS;AACtE,UAAM,SAAS,eAAe,OAAO;AACrC,QAAI,UAAU,oBAAoB,OAAQ,QAAO;AAEjD,UAAM,SAAS,gBAAgB,aAAa,OAAO,EAAE;AACrD,UAAM,OAAO,OAAO,QAAQ,QAAQ,QAAQ;AAC5C,UAAM,OAAO,eAAe,WAAW;AAEvC,QAAI,QAAQ,SAAS;AACnB,aAAO,KAAK,yBAAyB,IAAI,CAAC;AAC1C,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,UAAU,CAAC,cAAc,SAAS,GAAG;AACxC,aAAO;AAAA,QACL,8CAAyC,IAAI;AAAA,MAC/C;AACA,aAAO;AAAA,IACT;AAEA,UAAM,QAAQ,EAAE;AAChB,WAAO,KAAK,YAAY,IAAI,KAAK,IAAI,UAAK,EAAE,aAAa,OAAO,IAAI,UAAU,IAAK,CAAC;AAEpF,UAAM,SAAS,IAAI;AACnB,QAAI,UAAU,YAAa,QAAO;AAElC,QAAI,CAAC,QAAQ;AACX,cAAQ,eAAe;AACvB,4BAAsB,WAAW;AACjC,cAAQ,eAAe,IAAI;AAAA,IAC7B;AACA,YAAQ,mBAAmB,SAAS;AAEpC,gBAAY,KAAK,2BAA2B;AAC5C,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,KAAK,EAAE,gBAAgB,OAAO,EAAE;AAAA,IACjD,SAAS,OAAO;AAEd,UAAI,aAAa,KAAK,EAAG,QAAO;AAChC,YAAM,aAAa,iBAAiB;AACpC,UAAI,CAAC,WAAY,SAAQ,MAAM,mCAAmC,KAAK;AAGvE,UAAI,cAAc,UAAU,aAAa;AACvC,YAAI,WAAY,SAAQ,eAAe,UAAU;AACjD,gBAAQ,mBAAmB,QAAQ;AAAA,MACrC,WAAW,UAAU,aAAa;AAEhC,YAAI,WAAY,SAAQ,eAAe,UAAU;AACjD,gBAAQ,mBAAmB,QAAQ;AACnC,YAAI,yBAAyB,KAAK,GAAG;AAEnC,iBAAO,KAAK,yBAAyB,IAAI,CAAC;AAC1C,eAAK,YAAY,kBAAkB,EAAE,UAAU,cAAc,WAAW,EAAE,CAAC;AAAA,QAC7E,OAAO;AACL,iBAAO,MAAM,mBAAmB,IAAI,KAAK,IAAI,EAAE;AAAA,QACjD;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAEA,QAAI,UAAU,YAAa,QAAO;AAElC,wBAAoB,aAAa,OAAO,IAAI,MAAM;AAClD,gBAAY,KAAK,8BAA8B;AAC/C,YAAQ,eAAe,OAAO,EAAE;AAChC,YAAQ,mBAAmB,MAAM;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB,MAAM;AAC3B,MAAE;AACF,YAAQ,eAAe;AACvB,0BAAsB,WAAW;AACjC,YAAQ,eAAe,IAAI;AAAA,EAC7B;AAEA,QAAM,wBAAwB,YAA8B;AAC1D,UAAM,cAAc,QAAQ,SAAS,EAAE;AACvC,QAAI,CAAC,YAAa,QAAO;AACzB,UAAM,QAAQ;AACd,UAAM,SAAS,IAAI;AACnB,QAAI,UAAU,eAAe,QAAQ,SAAS,EAAE,gBAAgB,YAAa,QAAO;AACpF,gBAAY,KAAK,2BAA2B;AAC5C,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,KAAK,EAAE,gBAAgB,WAAW;AAAA,IACnD,SAAS,OAAO;AAEd,UAAI,EAAE,iBAAiB,iCAAiC,CAAC,aAAa,KAAK,GAAG;AAC5E,gBAAQ,MAAM,yCAAyC,KAAK;AAAA,MAC9D;AACA,aAAO;AAAA,IACT;AAEA,QAAI,UAAU,eAAe,QAAQ,SAAS,EAAE,gBAAgB,YAAa,QAAO;AACpF,wBAAoB,aAAa,aAAa,MAAM;AACpD,gBAAY,KAAK,8BAA8B;AAC/C,YAAQ,mBAAmB,MAAM;AACjC,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,iBAAiB,gBAAgB,uBAAuB,SAAS,gBAAgB;AAC5F;AAGO,SAAS,qBAA+C;AAC7D,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,OAAO,IAAI;AAC3B,UAAQ,UAAU;AAClB,QAAM,UAAU,oBAAoB;AACpC,QAAM,cAAc,eAAe;AAEnC;AAAA,IACE,MACE,KAAK,eAAe,MAAM;AACxB,QAAE;AACF,WAAK,YAAY,cAAc;AAAA,IACjC,CAAC;AAAA,IACH,CAAC,MAAM,WAAW;AAAA,EACpB;AACA,SAAO;AAAA,IACL,MAAM,sBAAsB,EAAE,MAAM,MAAM,QAAQ,SAAS,SAAS,YAAY,CAAC;AAAA,IACjF,CAAC,SAAS,WAAW;AAAA,EACvB;AACF;AASO,SAAS,2BAAiC;AAC/C,QAAM,OAAO,QAAQ;AACrB,QAAM,EAAE,gBAAgB,sBAAsB,IAAI,mBAAmB;AACrE,QAAM,cAAc,oBAAoB,CAAC,MAAM,EAAE,WAAW;AAC5D,QAAM,SAAS,oBAAoB,CAAC,MAAM,EAAE,eAAe;AAC3D,QAAM,UAAU,oBAAoB;AACpC,QAAM,cAAc,eAAe;AACnC,QAAM,EAAE,MAAM,YAAY,WAAW,SAAS,WAAW,IAAI,cAAc;AAC3E,QAAM,SAAS;AACf,QAAM,WAAW,QAAQ,KAAK,CAAC,MAAM,EAAE,gBAAgB,eAAe,EAAE,OAAO;AAI/E,QAAM,QAAQ,YAAY,cAAc,cAAc,WAAW,CAAC,GAAG,mBAAmB;AACxF,QAAM,SAAS,OAA6C,EAAE,IAAI,MAAM,OAAO,EAAE,CAAC;AAClF,QAAM,SAAS,WAAW,SAAS,cAAc;AACjD,MAAI,OAAO,QAAQ,OAAO,OAAQ,QAAO,UAAU,EAAE,IAAI,QAAQ,MAAM;AACvE,QAAM,OACJ,CAAC,CAAC,UACF,CAAC,CAAC,UACF,CAAC,cACD,QAAQ,OAAO,QAAQ,SACvB,CAAC,OAAO,KAAK,CAAC,MAAM,EAAE,gBAAgB,MAAM;AAE9C,YAAU,MAAM;AACd,QAAI,CAAC,SAAU;AACf,WAAO,KAAK,yBAAyB,SAAS,IAAI,CAAC;AACnD,mBAAe;AAAA,EACjB,GAAG,CAAC,UAAU,cAAc,CAAC;AAE7B,YAAU,MAAM;AACd,QAAI,KAAM,gBAAe;AAAA,EAC3B,GAAG,CAAC,MAAM,cAAc,CAAC;AAGzB,QAAM,UAAU,OAAO,KAAK;AAC5B,QAAMA,YAAW,KAAK;AACtB,YAAU,MAAM;AAGd,QACE,CAAC,eACD,YACA,QACA,WACA,WAAW,YACX,CAACA,aACD,QAAQ;AAER;AACF,YAAQ,UAAU;AAClB,SAAK,sBAAsB,EACxB,KAAK,OAAO,OAAO;AAClB,UAAI,GAAI;AAGR,YAAM,QAAQ,MAAM,YACjB,WAAW;AAAA,QACV,UAAU,cAAc,WAAW;AAAA,QACnC,SAAS,MAAM,KAAK,WAAW,KAAK;AAAA,QACpC,WAAW;AAAA,MACb,CAAC,EACA,MAAM,MAAM,IAAI;AACnB,UACE,SACA,QAAQ,SAAS,EAAE,gBAAgB,eACnC,CAAE,MAA4B,KAAK,CAAC,MAAM,EAAE,gBAAgB,WAAW;AAEvE,uBAAe;AAAA,IACnB,CAAC,EACA,QAAQ,MAAM;AACb,cAAQ,UAAU;AAAA,IACpB,CAAC;AAAA,EACL,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACAA;AAAA,EACF,CAAC;AACH;",
+  "names": ["signedIn"]
+}

package/dist/workspaces/transfer.js

@@ -0,0 +1,170 @@
+import { useCallback, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys } from "../hooks.js";
+import { notify } from "../notifications/notify-store.js";
+import { downloadBlob } from "../document-tools/environment.js";
+import { fetchDocumentFile } from "../document-tools/document-pdf.js";
+import { fetchMarkupPdf } from "../document-tools/markup-download.js";
+import { archiveName, buildDocumentMetadataRows } from "../documents/document-download.js";
+import { buildWorkspaceArchive } from "./export-archive.js";
+const TRANSFER_POLL_MS = 1500;
+function isTransferResumable(status) {
+  if (status.status === "interrupted" || status.status === "cancelled" || status.status === "failed")
+    return true;
+  return status.status === "completed" && Number(status.counts?.failed ?? 0) > 0;
+}
+function isTransferFinished(status) {
+  return !!status && status.status !== "running" && status.status !== "queued";
+}
+function openWorkspaceId(arbi) {
+  return arbi.hasWorkspace ? arbi.getWorkspaceId() : "";
+}
+function usePlanWorkspaceTransfer(scope, mode, options = {}) {
+  const arbi = useArbi();
+  const workspaceId = openWorkspaceId(arbi);
+  return useQuery({
+    queryKey: arbiQueryKeys.workspaceTransferPlan(workspaceId, JSON.stringify(scope), mode),
+    // The plan is of the workspace open on the server: kept only if it stayed `workspaceId`.
+    queryFn: () => arbi.readInWorkspace(
+      workspaceId,
+      () => arbi.workspaces.transfer.plan(scope, mode)
+    ),
+    enabled: !!workspaceId && (options.enabled ?? true),
+    staleTime: 1e4,
+    // The previous plan stays while the next loads, never another workspace's.
+    // ['arbi', 'workspaceTransfers', 'plan', workspaceId, scope, mode]
+    placeholderData: (previous, previousQuery) => previousQuery?.queryKey[3] === workspaceId ? previous : void 0
+  });
+}
+function useStartWorkspaceTransfer() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: (params) => arbi.workspaces.transfer.start(params)
+  });
+}
+function useResumeWorkspaceTransfer() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: ({
+      transferId,
+      targetWorkspaceId
+    }) => arbi.workspaces.transfer.resume(transferId, targetWorkspaceId)
+  });
+}
+function useCancelWorkspaceTransfer() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: (transferId) => arbi.workspaces.transfer.cancel(transferId)
+  });
+}
+function useWorkspaceTransfer(transferId) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.workspaceTransfer(transferId ?? ""),
+    queryFn: () => arbi.workspaces.transfer.get(transferId ?? ""),
+    enabled: !!transferId && arbi.isLoggedIn,
+    staleTime: 0,
+    refetchInterval: (query) => isTransferFinished(query.state.data) ? false : TRANSFER_POLL_MS
+  });
+}
+function useWorkspaceTransfers(options = {}) {
+  const arbi = useArbi();
+  const workspaceId = openWorkspaceId(arbi);
+  return useQuery({
+    queryKey: arbiQueryKeys.workspaceTransfers(workspaceId),
+    queryFn: () => arbi.readInWorkspace(
+      workspaceId,
+      () => arbi.workspaces.transfer.list()
+    ),
+    enabled: !!workspaceId && (options.enabled ?? true)
+  });
+}
+function useInvalidateAfterTransfer() {
+  const queryClient = useQueryClient();
+  return useCallback(
+    (mode) => {
+      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() });
+      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allWorkspaceTransfers() });
+      if (mode !== "move") return;
+      for (const queryKey of [
+        arbiQueryKeys.workflows(),
+        arbiQueryKeys.allFacts(),
+        arbiQueryKeys.allTags(),
+        arbiQueryKeys.allDocuments(),
+        arbiQueryKeys.allConversations()
+      ])
+        void queryClient.invalidateQueries({ queryKey });
+    },
+    [queryClient]
+  );
+}
+function useWorkspaceExportDownload({
+  workspaceName,
+  workspaceId
+} = {}) {
+  const arbi = useArbi();
+  const [progress, setProgress] = useState(null);
+  const download = useCallback(
+    async ({ scope, documents = [], csvColumns }) => {
+      setProgress({ done: 0, total: 0 });
+      try {
+        const data = await arbi.workspaces.transfer.exportData(
+          scope,
+          workspaceId ? { workspaceId } : void 0
+        );
+        let metadataCsv = null;
+        if (csvColumns === void 0 || csvColumns.length > 0) {
+          const exported = new Set(
+            (data.files ?? []).filter((f) => !f.markup).map((f) => f.doc_ext_id)
+          );
+          const rows = documents.filter((d) => exported.has(d.external_id));
+          if (rows.length > 0) {
+            const Papa = (await import("papaparse")).default;
+            metadataCsv = Papa.unparse(buildDocumentMetadataRows(rows, csvColumns));
+          }
+        }
+        const client = arbi.getClient().fetch;
+        const archive = await buildWorkspaceArchive({
+          exportData: data,
+          fetchFile: async (docExtId, version, kind) => kind === "markup" ? (await fetchMarkupPdf(client, docExtId, version, workspaceId)).blob : fetchDocumentFile(client, docExtId, { version, workspaceExtId: workspaceId }),
+          metadataCsv,
+          onProgress: (done, total) => setProgress({ done, total })
+        });
+        const fileName = archiveName(workspaceName, "export");
+        downloadBlob(archive.blob, fileName);
+        const files = `${archive.fileCount} file${archive.fileCount !== 1 ? "s" : ""}`;
+        if (archive.failed.length === 0) {
+          notify.success(`Successfully downloaded ${files} and data in ${fileName}`);
+        } else {
+          notify.warning(
+            `Downloaded ${files} in ${fileName}; ${archive.failed.length} could not be fetched (listed in manifest.json)`
+          );
+        }
+        return true;
+      } catch (error) {
+        console.error("Workspace export failed:", error);
+        notify.error("Failed to download. Please try again.");
+        return false;
+      } finally {
+        setProgress(null);
+      }
+    },
+    [arbi, workspaceName, workspaceId]
+  );
+  return { download, isDownloading: progress !== null, progress };
+}
+export {
+  TRANSFER_POLL_MS,
+  isTransferFinished,
+  isTransferResumable,
+  useCancelWorkspaceTransfer,
+  useInvalidateAfterTransfer,
+  usePlanWorkspaceTransfer,
+  useResumeWorkspaceTransfer,
+  useStartWorkspaceTransfer,
+  useWorkspaceExportDownload,
+  useWorkspaceTransfer,
+  useWorkspaceTransfers
+};
+//# sourceMappingURL=transfer.js.map

package/dist/workspaces/transfer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workspaces/transfer.ts"],
+  "sourcesContent": ["/**\n * Download, copy or move a scope of the open workspace (`/v1/workspace/transfer*`,\n * `/v1/workspace/export`). One scope shape (`TransferScope`) feeds them all: the preview\n * (`usePlanWorkspaceTransfer`), the background copy or move (`useStartWorkspaceTransfer`, followed\n * with `useWorkspaceTransfer`) and the download (`useWorkspaceExportDownload`). The target\n * workspace's key is sealed by the SDK (`arbi.workspaces.transfer`).\n */\n\nimport { useCallback, useState } from 'react'\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport type { components } from '@arbidocs/client'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys } from '../hooks'\nimport { notify } from '../notifications/notify-store'\nimport { downloadBlob } from '../document-tools/environment'\nimport { fetchDocumentFile } from '../document-tools/document-pdf'\nimport { fetchMarkupPdf } from '../document-tools/markup-download'\nimport { archiveName, buildDocumentMetadataRows } from '../documents/document-download'\nimport type { WorkspaceDocument } from '../documents/documents-cache'\nimport { buildWorkspaceArchive } from './export-archive'\n\nexport type TransferScope = components['schemas']['TransferScope']\nexport type TransferKind = components['schemas']['TransferKind']\nexport type TransferMode = components['schemas']['TransferMode']\nexport type TransferPlan = components['schemas']['TransferPlanResponse']\nexport type TransferStatus = components['schemas']['TransferStatusResponse']\nexport type TransferConflictPolicy = components['schemas']['ConflictPolicy']\nexport type WorkspaceExport = components['schemas']['WorkspaceExportResponse']\n\n/** Polling cadence while a job runs; it goes idle once the job has finished. */\nexport const TRANSFER_POLL_MS = 1500\n\n/** A job no worker runs any more (interrupted, cancelled, failed, or done with failures). */\nexport function isTransferResumable(status: TransferStatus): boolean {\n  if (\n    status.status === 'interrupted' ||\n    status.status === 'cancelled' ||\n    status.status === 'failed'\n  )\n    return true\n  return status.status === 'completed' && Number(status.counts?.failed ?? 0) > 0\n}\n\n/** The job has stopped (it is neither queued nor running). */\nexport function isTransferFinished(status: TransferStatus | null | undefined): boolean {\n  return !!status && status.status !== 'running' && status.status !== 'queued'\n}\n\nfunction openWorkspaceId(arbi: ReturnType<typeof useArbi>): string {\n  return arbi.hasWorkspace ? arbi.getWorkspaceId() : ''\n}\n\n/** What a scope would take in the open workspace; re-read when the scope or the mode changes. */\nexport function usePlanWorkspaceTransfer(\n  scope: TransferScope,\n  mode: TransferMode,\n  options: { enabled?: boolean } = {}\n) {\n  const arbi = useArbi()\n  const workspaceId = openWorkspaceId(arbi)\n  return useQuery({\n    queryKey: arbiQueryKeys.workspaceTransferPlan(workspaceId, JSON.stringify(scope), mode),\n    // The plan is of the workspace open on the server: kept only if it stayed `workspaceId`.\n    queryFn: () =>\n      arbi.readInWorkspace(\n        workspaceId,\n        () => arbi.workspaces.transfer.plan(scope, mode) as Promise<TransferPlan>\n      ),\n    enabled: !!workspaceId && (options.enabled ?? true),\n    staleTime: 10_000,\n    // The previous plan stays while the next loads, never another workspace's.\n    // ['arbi', 'workspaceTransfers', 'plan', workspaceId, scope, mode]\n    placeholderData: (previous, previousQuery) =>\n      previousQuery?.queryKey[3] === workspaceId ? previous : undefined,\n  })\n}\n\n/** Start copying or moving into another workspace (a background job). */\nexport function useStartWorkspaceTransfer() {\n  const arbi = useArbi()\n  return useMutation({\n    mutationFn: (params: {\n      scope: TransferScope\n      mode: TransferMode\n      targetWorkspaceId: string\n      onConflict?: TransferConflictPolicy\n    }) => arbi.workspaces.transfer.start(params) as Promise<TransferStatus>,\n  })\n}\n\n/** Resume a stopped job (nothing is copied twice). */\nexport function useResumeWorkspaceTransfer() {\n  const arbi = useArbi()\n  return useMutation({\n    mutationFn: ({\n      transferId,\n      targetWorkspaceId,\n    }: {\n      transferId: string\n      targetWorkspaceId: string\n    }) => arbi.workspaces.transfer.resume(transferId, targetWorkspaceId) as Promise<TransferStatus>,\n  })\n}\n\nexport function useCancelWorkspaceTransfer() {\n  const arbi = useArbi()\n  return useMutation({\n    mutationFn: (transferId: string) => arbi.workspaces.transfer.cancel(transferId),\n  })\n}\n\n/** One job's progress, polled while it runs. */\nexport function useWorkspaceTransfer(transferId: string | null) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.workspaceTransfer(transferId ?? ''),\n    queryFn: () => arbi.workspaces.transfer.get(transferId ?? '') as Promise<TransferStatus>,\n    enabled: !!transferId && arbi.isLoggedIn,\n    staleTime: 0,\n    refetchInterval: (query) =>\n      isTransferFinished(query.state.data as TransferStatus | undefined) ? false : TRANSFER_POLL_MS,\n  })\n}\n\n/** The caller's recent jobs out of the open workspace (to offer a resume). */\nexport function useWorkspaceTransfers(options: { enabled?: boolean } = {}) {\n  const arbi = useArbi()\n  const workspaceId = openWorkspaceId(arbi)\n  return useQuery({\n    queryKey: arbiQueryKeys.workspaceTransfers(workspaceId),\n    queryFn: () =>\n      arbi.readInWorkspace(\n        workspaceId,\n        () => arbi.workspaces.transfer.list() as Promise<TransferStatus[]>\n      ),\n    enabled: !!workspaceId && (options.enabled ?? true),\n  })\n}\n\n/** What to refresh once a job has finished: the workspaces' counts always, this one's lists after a move. */\nexport function useInvalidateAfterTransfer() {\n  const queryClient = useQueryClient()\n  return useCallback(\n    (mode: TransferMode) => {\n      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() })\n      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allWorkspaceTransfers() })\n      if (mode !== 'move') return\n      for (const queryKey of [\n        arbiQueryKeys.workflows(),\n        arbiQueryKeys.allFacts(),\n        arbiQueryKeys.allTags(),\n        arbiQueryKeys.allDocuments(),\n        arbiQueryKeys.allConversations(),\n      ])\n        void queryClient.invalidateQueries({ queryKey })\n    },\n    [queryClient]\n  )\n}\n\nexport interface ExportDownloadRequest {\n  scope: TransferScope\n  /** Documents known to the page, for `index.csv` (only those in the export are listed). */\n  documents?: WorkspaceDocument[]\n  /** CSV columns: undefined = all standard columns, [] = no index.csv. */\n  csvColumns?: string[]\n}\n\n/**\n * Download a scope of the open workspace as files: its documents (every version, and each\n * version's markup PDF), one JSON file per entity type and a manifest (`buildWorkspaceArchive`).\n */\nexport function useWorkspaceExportDownload({\n  workspaceName,\n  workspaceId,\n}: { workspaceName?: string; workspaceId?: string } = {}) {\n  const arbi = useArbi()\n  const [progress, setProgress] = useState<{ done: number; total: number } | null>(null)\n\n  const download = useCallback(\n    async ({ scope, documents = [], csvColumns }: ExportDownloadRequest) => {\n      setProgress({ done: 0, total: 0 })\n      try {\n        const data = (await arbi.workspaces.transfer.exportData(\n          scope,\n          workspaceId ? { workspaceId } : undefined\n        )) as WorkspaceExport\n        let metadataCsv: string | null = null\n        if (csvColumns === undefined || csvColumns.length > 0) {\n          const exported = new Set(\n            (data.files ?? []).filter((f) => !f.markup).map((f) => f.doc_ext_id)\n          )\n          const rows = documents.filter((d) => exported.has(d.external_id))\n          if (rows.length > 0) {\n            const Papa = (await import('papaparse')).default\n            metadataCsv = Papa.unparse(buildDocumentMetadataRows(rows, csvColumns))\n          }\n        }\n        const client = arbi.getClient().fetch\n        const archive = await buildWorkspaceArchive({\n          exportData: data,\n          fetchFile: async (docExtId, version, kind) =>\n            kind === 'markup'\n              ? (await fetchMarkupPdf(client, docExtId, version, workspaceId)).blob\n              : fetchDocumentFile(client, docExtId, { version, workspaceExtId: workspaceId }),\n          metadataCsv,\n          onProgress: (done, total) => setProgress({ done, total }),\n        })\n        const fileName = archiveName(workspaceName, 'export')\n        downloadBlob(archive.blob, fileName)\n        const files = `${archive.fileCount} file${archive.fileCount !== 1 ? 's' : ''}`\n        if (archive.failed.length === 0) {\n          notify.success(`Successfully downloaded ${files} and data in ${fileName}`)\n        } else {\n          notify.warning(\n            `Downloaded ${files} in ${fileName}; ${archive.failed.length} could not be fetched (listed in manifest.json)`\n          )\n        }\n        return true\n      } catch (error) {\n        console.error('Workspace export failed:', error)\n        notify.error('Failed to download. Please try again.')\n        return false\n      } finally {\n        setProgress(null)\n      }\n    },\n    [arbi, workspaceName, workspaceId]\n  )\n\n  return { download, isDownloading: progress !== null, progress }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/workspaces/useShellWorkspaces.js

@@ -0,0 +1,86 @@
+import { useCallback, useMemo, useRef, useState } from "react";
+import {
+  pickRecentWorkspaces,
+  resolveActiveWorkspace,
+  toShellWorkspace
+} from "./shell-workspaces.js";
+function useShellWorkspaces(options) {
+  const {
+    workspaces,
+    isLoading = false,
+    loadError,
+    selectedId,
+    seed,
+    decorate,
+    recentLimit,
+    lastOpened,
+    formatLastSeen
+  } = options;
+  const live = useMemo(
+    () => (workspaces ?? []).map((source) => {
+      const item = toShellWorkspace(source);
+      return decorate ? { ...item, ...decorate(item, source) } : item;
+    }),
+    [workspaces, decorate]
+  );
+  const isLive = live.length > 0;
+  const isSeed = !isLive && !isLoading && !!seed;
+  const items = useMemo(
+    () => isLive ? live : isSeed ? [...seed.workspaces] : [],
+    [isLive, live, isSeed, seed]
+  );
+  const active = useMemo(
+    () => resolveActiveWorkspace(items, selectedId, { isSeed, seedActiveId: seed?.activeId }),
+    [items, selectedId, isSeed, seed?.activeId]
+  );
+  const recent = useMemo(
+    () => pickRecentWorkspaces(items, active?.id, { limit: recentLimit, lastOpened, formatLastSeen }),
+    [items, active?.id, recentLimit, lastOpened, formatLastSeen]
+  );
+  const [openingId, setOpeningId] = useState(null);
+  const [openError, setOpenError] = useState(void 0);
+  const callbacks = useRef({
+    select: options.select,
+    onOpened: options.onOpened,
+    onOpenError: options.onOpenError
+  });
+  callbacks.current = {
+    select: options.select,
+    onOpened: options.onOpened,
+    onOpenError: options.onOpenError
+  };
+  const itemsRef = useRef(items);
+  itemsRef.current = items;
+  const open = useCallback(async (target) => {
+    const id = typeof target === "string" ? target : target.id;
+    const workspace = itemsRef.current.find((w) => w.id === id);
+    if (!workspace) return false;
+    setOpenError(void 0);
+    setOpeningId(id);
+    try {
+      await callbacks.current.select(workspace);
+    } catch (err) {
+      setOpenError(err);
+      setOpeningId(null);
+      callbacks.current.onOpenError?.(err, workspace);
+      return false;
+    }
+    setOpeningId(null);
+    callbacks.current.onOpened?.(workspace);
+    return true;
+  }, []);
+  return {
+    items,
+    active,
+    recent,
+    isLive,
+    isLoading,
+    error: openError ?? loadError ?? null,
+    openingId,
+    open
+  };
+}
+export {
+  useShellWorkspaces
+};
+//# sourceMappingURL=useShellWorkspaces.js.map

package/dist/workspaces/useShellWorkspaces.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workspaces/useShellWorkspaces.ts"],
+  "sourcesContent": ["/**\n * `useShellWorkspaces`: the user's workspaces as the shell's switcher and the workspaces gallery\n * show them, the one the app is in, and `open(workspace)`.\n *\n * Source-agnostic on purpose: the host hands in the list and the selection mechanism it already\n * has (ARBI-frontend its React Query hook and workspace store, a connected app `useWorkspaces`\n * plus the connection's `setWorkspace`).\n */\n\nimport { useCallback, useMemo, useRef, useState } from 'react'\nimport {\n  pickRecentWorkspaces,\n  resolveActiveWorkspace,\n  toShellWorkspace,\n  type ShellRecentWorkspaceItem,\n  type ShellWorkspaceItem,\n  type ShellWorkspaceSource,\n} from './shell-workspaces'\n\n/** Workspaces to show while the account has none (a demo); the host owns the data. */\nexport interface ShellWorkspaceSeed {\n  workspaces: readonly ShellWorkspaceItem[]\n  /** The seed workspace that counts as the current one when nothing is selected. */\n  activeId?: string\n}\n\nexport interface UseShellWorkspacesOptions<S extends ShellWorkspaceSource = ShellWorkspaceSource> {\n  /** The account's workspaces (SDK shape). `undefined` while loading. */\n  workspaces: readonly S[] | undefined\n  isLoading?: boolean\n  /** The list query's error, passed through as `error`. */\n  loadError?: unknown\n  /** The workspace the host says the app is in (the connection's selection). */\n  selectedId?: string | null\n  /**\n   * Make the workspace the app's current one: open it on the server and record the selection.\n   * Throw (reject) to report failure. Called for EVERY open, including the current workspace, so\n   * a click on the current card still re-opens it and then navigates.\n   */\n  select: (workspace: ShellWorkspaceItem) => Promise<unknown> | unknown\n  /** After a successful select: navigate, toast, close a menu. The \"switch, then navigate\" hook. */\n  onOpened?: (workspace: ShellWorkspaceItem) => void\n  /** When select rejects. The active workspace is unchanged. Without it the error is in `error`. */\n  onOpenError?: (error: unknown, workspace: ShellWorkspaceItem) => void\n  /** Demo list for an account that has no workspaces (never while loading). */\n  seed?: ShellWorkspaceSeed\n  /** Host decoration per workspace, e.g. a rendered project pill. Merged over the adapter. */\n  decorate?: (item: ShellWorkspaceItem, source: S) => Partial<ShellWorkspaceItem>\n  /** How many recent workspaces the switcher offers. Default 4. */\n  recentLimit?: number\n  /** `workspace id -> epoch ms` last opened here; orders `recent`, falling back to `updatedAt`. */\n  lastOpened?: Readonly<Record<string, number>>\n  /** Format a recency timestamp into `recent[].lastSeen`. */\n  formatLastSeen?: (timestamp: number) => string\n}\n\nexport interface UseShellWorkspacesResult {\n  /** All workspaces: the account's, or the seed when it has none. */\n  items: ShellWorkspaceItem[]\n  /** The single current workspace; undefined only when there are no workspaces at all. */\n  active: ShellWorkspaceItem | undefined\n  /** The other workspaces, most recently opened first, for the quick-switch menu. */\n  recent: ShellRecentWorkspaceItem[]\n  /** The account's own workspaces: false while `items` is the seed. */\n  isLive: boolean\n  isLoading: boolean\n  /** The list query's error or the last failed open; cleared by the next open. */\n  error: unknown\n  /** Id of the workspace being opened, else null (for a spinner on its card). */\n  openingId: string | null\n  /** Select the workspace (always, even the current one), then `onOpened`. False if select threw. */\n  open: (workspace: Pick<ShellWorkspaceItem, 'id'> | string) => Promise<boolean>\n}\n\nexport function useShellWorkspaces<S extends ShellWorkspaceSource = ShellWorkspaceSource>(\n  options: UseShellWorkspacesOptions<S>\n): UseShellWorkspacesResult {\n  const {\n    workspaces,\n    isLoading = false,\n    loadError,\n    selectedId,\n    seed,\n    decorate,\n    recentLimit,\n    lastOpened,\n    formatLastSeen,\n  } = options\n\n  const live = useMemo(\n    () =>\n      (workspaces ?? []).map((source) => {\n        const item = toShellWorkspace(source)\n        return decorate ? { ...item, ...decorate(item, source) } : item\n      }),\n    [workspaces, decorate]\n  )\n  const isLive = live.length > 0\n  const isSeed = !isLive && !isLoading && !!seed\n  const items = useMemo(\n    () => (isLive ? live : isSeed ? [...seed.workspaces] : []),\n    [isLive, live, isSeed, seed]\n  )\n  const active = useMemo(\n    () => resolveActiveWorkspace(items, selectedId, { isSeed, seedActiveId: seed?.activeId }),\n    [items, selectedId, isSeed, seed?.activeId]\n  )\n  const recent = useMemo(\n    () =>\n      pickRecentWorkspaces(items, active?.id, { limit: recentLimit, lastOpened, formatLastSeen }),\n    [items, active?.id, recentLimit, lastOpened, formatLastSeen]\n  )\n\n  const [openingId, setOpeningId] = useState<string | null>(null)\n  const [openError, setOpenError] = useState<unknown>(undefined)\n  // Latest callbacks without re-creating `open` on every render.\n  const callbacks = useRef({\n    select: options.select,\n    onOpened: options.onOpened,\n    onOpenError: options.onOpenError,\n  })\n  callbacks.current = {\n    select: options.select,\n    onOpened: options.onOpened,\n    onOpenError: options.onOpenError,\n  }\n  const itemsRef = useRef(items)\n  itemsRef.current = items\n\n  const open = useCallback(async (target: Pick<ShellWorkspaceItem, 'id'> | string) => {\n    const id = typeof target === 'string' ? target : target.id\n    const workspace = itemsRef.current.find((w) => w.id === id)\n    if (!workspace) return false\n    setOpenError(undefined)\n    setOpeningId(id)\n    try {\n      await callbacks.current.select(workspace)\n    } catch (err) {\n      setOpenError(err)\n      setOpeningId(null)\n      callbacks.current.onOpenError?.(err, workspace)\n      return false\n    }\n    setOpeningId(null)\n    callbacks.current.onOpened?.(workspace)\n    return true\n  }, [])\n\n  return {\n    items,\n    active,\n    recent,\n    isLive,\n    isLoading,\n    error: openError ?? loadError ?? null,\n    openingId,\n    open,\n  }\n}\n"],
+  "mappings": "AASA,SAAS,aAAa,SAAS,QAAQ,gBAAgB;AACvD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAyDA,SAAS,mBACd,SAC0B;AAC1B,QAAM;AAAA,IACJ;AAAA,IACA,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,OAAO;AAAA,IACX,OACG,cAAc,CAAC,GAAG,IAAI,CAAC,WAAW;AACjC,YAAM,OAAO,iBAAiB,MAAM;AACpC,aAAO,WAAW,EAAE,GAAG,MAAM,GAAG,SAAS,MAAM,MAAM,EAAE,IAAI;AAAA,IAC7D,CAAC;AAAA,IACH,CAAC,YAAY,QAAQ;AAAA,EACvB;AACA,QAAM,SAAS,KAAK,SAAS;AAC7B,QAAM,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAC1C,QAAM,QAAQ;AAAA,IACZ,MAAO,SAAS,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,IAAI,CAAC;AAAA,IACxD,CAAC,QAAQ,MAAM,QAAQ,IAAI;AAAA,EAC7B;AACA,QAAM,SAAS;AAAA,IACb,MAAM,uBAAuB,OAAO,YAAY,EAAE,QAAQ,cAAc,MAAM,SAAS,CAAC;AAAA,IACxF,CAAC,OAAO,YAAY,QAAQ,MAAM,QAAQ;AAAA,EAC5C;AACA,QAAM,SAAS;AAAA,IACb,MACE,qBAAqB,OAAO,QAAQ,IAAI,EAAE,OAAO,aAAa,YAAY,eAAe,CAAC;AAAA,IAC5F,CAAC,OAAO,QAAQ,IAAI,aAAa,YAAY,cAAc;AAAA,EAC7D;AAEA,QAAM,CAAC,WAAW,YAAY,IAAI,SAAwB,IAAI;AAC9D,QAAM,CAAC,WAAW,YAAY,IAAI,SAAkB,MAAS;AAE7D,QAAM,YAAY,OAAO;AAAA,IACvB,QAAQ,QAAQ;AAAA,IAChB,UAAU,QAAQ;AAAA,IAClB,aAAa,QAAQ;AAAA,EACvB,CAAC;AACD,YAAU,UAAU;AAAA,IAClB,QAAQ,QAAQ;AAAA,IAChB,UAAU,QAAQ;AAAA,IAClB,aAAa,QAAQ;AAAA,EACvB;AACA,QAAM,WAAW,OAAO,KAAK;AAC7B,WAAS,UAAU;AAEnB,QAAM,OAAO,YAAY,OAAO,WAAoD;AAClF,UAAM,KAAK,OAAO,WAAW,WAAW,SAAS,OAAO;AACxD,UAAM,YAAY,SAAS,QAAQ,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;AAC1D,QAAI,CAAC,UAAW,QAAO;AACvB,iBAAa,MAAS;AACtB,iBAAa,EAAE;AACf,QAAI;AACF,YAAM,UAAU,QAAQ,OAAO,SAAS;AAAA,IAC1C,SAAS,KAAK;AACZ,mBAAa,GAAG;AAChB,mBAAa,IAAI;AACjB,gBAAU,QAAQ,cAAc,KAAK,SAAS;AAC9C,aAAO;AAAA,IACT;AACA,iBAAa,IAAI;AACjB,cAAU,QAAQ,WAAW,SAAS;AACtC,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO,aAAa,aAAa;AAAA,IACjC;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}