@arbidocs/react 0.5.60 → 0.5.62

package/dist/{chunk-M2SZQBCO.js.map → chunk-SI7DJWBT.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/document-tools/environment.tsx","../src/document-tools/document-pdf.ts","../src/document-tools/markup-download.ts"],"names":[],"mappings":"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","file":"chunk-M2SZQBCO.js","sourcesContent":["/**\n * The host app's side of the document tools (markup, freeze, e-signing, versions): the one place\n * the tools reach the app. They never import a store, a router, a toast library or app API code;\n * the host passes what it has to `<DocumentToolsProvider>` and every optional field has a default.\n *\n * `client` is an openapi-fetch client for the ARBI API (`ArbiClient['fetch']` from\n * `@arbidocs/client`, or `arbi.getClient().fetch` from an `@arbidocs/sdk` `Arbi`), signed in with the\n * user's session; it carries the auth.\n */\n\nimport { createContext, useCallback, useContext, useMemo, useRef, type ReactNode } from 'react'\nimport type { ArbiClient, operations } from '@arbidocs/client'\nimport { useDeploymentDomain } from '../useArbi'\n\nexport type DocumentToolsClient = ArbiClient['fetch']\n\nexport type DocumentToolsNoticeKind = 'success' | 'error' | 'info' | 'warning'\n\nexport interface DocumentToolsNoticeOptions {\n  /** A second line under the message. */\n  description?: string\n  /** One action button on the notice (\"Email it\"). */\n  action?: { label: string; onClick: () => void }\n}\n\nexport type DocumentToolsNotify = (\n  message: string,\n  kind: DocumentToolsNoticeKind,\n  options?: DocumentToolsNoticeOptions\n) => void\n\nexport interface DocumentToolsUser {\n  /** The name marks are authored as and the signer's name is prefilled with. */\n  name: string\n  /** The sign-in email: signing re-derives the user's key from it and the password. */\n  email?: string | null\n  /** The user's id (usr-*): which fields of a signature request are theirs. */\n  externalId?: string | null\n}\n\n/** What changed about a document, so the host can refresh its own lists and caches. */\nexport type DocumentChange =\n  /** A version's markup got its first mark or lost its last one. */\n  | 'markup'\n  /** A signature was added: the document has a new current version. */\n  | 'signed'\n  /** A new document was made from it (a frozen copy). The ids are the NEW documents. */\n  | 'copy'\n  /** A new version was saved (the Word editor's Save version): the document's current version. */\n  | 'version'\n\n/**\n * The `/v1/document/upload` query, typed from the API schema: `derived_from` is a list (a\n * production set is derived from every document in it), `shared` a boolean.\n */\nexport type DocumentUploadQuery = NonNullable<operations['upload_documents']['parameters']['query']>\n\nexport interface DocumentUploadRequest {\n  file: File\n  /** `/v1/document/upload` query: `derived_from`, `derived_role`, `shared`, `folder`. */\n  query: DocumentUploadQuery\n}\n\n/**\n * The upload query as a URL query string, for a host that posts the upload itself (an XHR with\n * progress): a list repeats its key (`derived_from=a&derived_from=b`), empty values are left out.\n */\nexport function uploadQueryString(query: DocumentUploadQuery): string {\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query)) {\n    if (value === null || value === undefined) continue\n    for (const item of Array.isArray(value) ? value : [value]) params.append(key, String(item))\n  }\n  return params.toString()\n}\n\nexport interface DocumentToolsEnvironment {\n  client: DocumentToolsClient\n  /**\n   * The deployment domain the user's keys are derived for. Needed for signing. Default: the one\n   * the host's `Arbi` computes (`arbi.getDeploymentDomain()`), if any.\n   */\n  deploymentDomain?: string\n  /** The signed-in user; marks are authored as \"You\" without one, and signing is unavailable. */\n  user?: DocumentToolsUser | null\n  /** Surface a transient message. Default: none (errors still show inline where they can). */\n  notify?: DocumentToolsNotify\n  /** Open a document or a version reference (`doc-…@v2`): the copy just made, the signed copy. */\n  openDocument?: (documentRef: string) => void\n  /**\n   * Documents changed on the server (see {@link DocumentChange}); refresh the host's lists. The\n   * tools wait for it before opening the document, so a copy is listed when it opens.\n   */\n  onDocumentsChanged?: (documentIds: string[], change: DocumentChange) => void | Promise<void>\n  /** Upload a derived copy. Default: `POST /v1/document/upload` through `client`. */\n  uploadDocument?: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n  /** Save a file to the user's computer. Default: a temporary download link. */\n  saveFile?: (blob: Blob, fileName: string) => void\n  /** Email a document (offered once it is signed). Omitted: no \"Email it\". */\n  emailDocument?: (documentRef: string) => void\n  /**\n   * The public page that checks a signature (the certificate) in this app. When given, \"View\n   * certificate\" opens it in preference to the backend's `certificate_url` (which is on the\n   * deployment domain, like the link embedded in the signed PDF). Without it: the backend's\n   * `certificate_url`, else `/verify/{reference}` on this origin.\n   */\n  certificateUrl?: (reference: string) => string\n}\n\n/** The environment with every default filled in. */\nexport interface ResolvedDocumentToolsEnvironment extends DocumentToolsEnvironment {\n  prepareFileShare: (documentId: string) => Promise<void>\n  registerBeforeFileShare: (documentId: string, flush: () => Promise<void>) => () => void\n  notify: DocumentToolsNotify\n  saveFile: (blob: Blob, fileName: string) => void\n  uploadDocument: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n}\n\n/**\n * Save a blob through a temporary `<a download>`. The object URL is revoked a minute later, not at\n * once: revoking straight after `click()` can cancel the download (Safari, and large files\n * elsewhere) before the browser has read the blob.\n */\nexport function downloadBlob(blob: Blob, fileName: string): void {\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = fileName\n  document.body.appendChild(a)\n  a.click()\n  a.remove()\n  setTimeout(() => URL.revokeObjectURL(url), 60_000)\n}\n\n/** The default upload: multipart `files` to `/v1/document/upload` through the API client. */\nexport function clientUpload(client: DocumentToolsClient) {\n  return async ({ file, query }: DocumentUploadRequest) => {\n    const formData = new FormData()\n    formData.append('files', file)\n    const { data, response } = await client.POST('/v1/document/upload', {\n      params: { query },\n      // The schema types the multipart body as `{ files: string[] }`; the FormData is sent as is.\n      body: formData as unknown as { files: string[] },\n      bodySerializer: () => formData,\n    })\n    if (!response.ok) throw new Error(`Upload failed with status ${response.status}`)\n    return data\n  }\n}\n\nexport function defaultCertificateUrl(reference: string): string {\n  const origin = typeof location === 'undefined' ? '' : location.origin\n  return `${origin}/verify/${encodeURIComponent(reference)}`\n}\n\n/**\n * Where \"View certificate\" goes for a signature: the host's `certificateUrl(reference)` when it\n * gives one, else the `certificate_url` the backend returned, else `/verify/{reference}` here.\n */\nexport function certificateLink(\n  signature: { reference: string; certificate_url?: string | null },\n  certificateUrl?: (reference: string) => string\n): string {\n  if (certificateUrl) return certificateUrl(signature.reference)\n  return signature.certificate_url || defaultCertificateUrl(signature.reference)\n}\n\nconst DocumentToolsContext = createContext<ResolvedDocumentToolsEnvironment | null>(null)\n\nexport interface DocumentToolsProviderProps extends DocumentToolsEnvironment {\n  children: ReactNode\n}\n\nexport function DocumentToolsProvider({ children, ...env }: DocumentToolsProviderProps) {\n  const arbiDeploymentDomain = useDeploymentDomain()\n  const guards = useRef(new Map<string, () => Promise<void>>())\n  const pendingFlushes = useRef(new Map<string, Promise<void>>())\n  const registerBeforeFileShare = useCallback((id: string, flush: () => Promise<void>) => {\n    guards.current.set(id, flush)\n    return () => {\n      if (guards.current.get(id) !== flush) return\n      guards.current.delete(id)\n      const pending = flush()\n      pendingFlushes.current.set(id, pending)\n      void pending.then(\n        () => {\n          if (pendingFlushes.current.get(id) === pending) pendingFlushes.current.delete(id)\n        },\n        () => {}\n      )\n    }\n  }, [])\n  const prepareFileShare = useCallback(async (id: string) => {\n    const guard = guards.current.get(id)\n    if (guard) {\n      await guard()\n      pendingFlushes.current.delete(id)\n    } else await pendingFlushes.current.get(id)\n  }, [])\n  const {\n    client,\n    deploymentDomain,\n    user,\n    notify,\n    openDocument,\n    onDocumentsChanged,\n    uploadDocument,\n    saveFile,\n    emailDocument,\n    certificateUrl,\n  } = env\n  const value = useMemo<ResolvedDocumentToolsEnvironment>(\n    () => ({\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain: deploymentDomain ?? arbiDeploymentDomain,\n      user,\n      openDocument,\n      onDocumentsChanged,\n      emailDocument,\n      notify: notify ?? (() => {}),\n      saveFile: saveFile ?? downloadBlob,\n      uploadDocument: uploadDocument ?? clientUpload(client),\n      certificateUrl,\n    }),\n    [\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain,\n      arbiDeploymentDomain,\n      user,\n      notify,\n      openDocument,\n      onDocumentsChanged,\n      uploadDocument,\n      saveFile,\n      emailDocument,\n      certificateUrl,\n    ]\n  )\n  return <DocumentToolsContext.Provider value={value}>{children}</DocumentToolsContext.Provider>\n}\n\n/** The host's environment, or `null` outside a `<DocumentToolsProvider>`. */\nexport function useOptionalDocumentTools(): ResolvedDocumentToolsEnvironment | null {\n  return useContext(DocumentToolsContext)\n}\n\n/** The host's environment; throws outside a `<DocumentToolsProvider>`. */\nexport function useDocumentTools(): ResolvedDocumentToolsEnvironment {\n  const env = useContext(DocumentToolsContext)\n  if (!env) throw new Error('The document tools must be used within a <DocumentToolsProvider>')\n  return env\n}\n","/**\n * A document's bytes, through the host's API client: the PDF the viewer and the tools draw on\n * (`/view`: the file itself for a PDF, its PDF rendering for a Word or text file) and the stored\n * file (`/download`). Either takes a document id or a version reference `doc-…@v{n}`.\n */\n\nimport { parseVersionRef } from '../artifacts/versions'\nimport type { DocumentToolsClient } from './environment'\n\nexport interface DocumentFetchOptions {\n  /** The version to fetch. Default: the one `documentRef` names, else the current version. */\n  version?: number | null\n  signal?: AbortSignal\n}\n\n/** A document's bytes could not be fetched; `status` is the HTTP status. */\nexport class DocumentFetchError extends Error {\n  readonly status: number\n  constructor(message: string, status: number) {\n    super(message)\n    this.name = 'DocumentFetchError'\n    this.status = status\n  }\n}\n\nasync function fetchDocumentBytes(\n  client: DocumentToolsClient,\n  endpoint: '/v1/document/{document_ext_id}/view' | '/v1/document/{document_ext_id}/download',\n  documentRef: string,\n  options: DocumentFetchOptions,\n  headers: Record<string, string>,\n  what: string\n): Promise<{ blob: Blob; response: Response }> {\n  const ref = parseVersionRef(documentRef)\n  const version = options.version ?? ref.version\n  const { data, response } = await client.GET(endpoint, {\n    params: { path: { document_ext_id: ref.docId }, query: version ? { version } : {} },\n    headers,\n    parseAs: 'blob',\n    signal: options.signal,\n  })\n  if (!response.ok || !(data instanceof Blob)) {\n    throw new DocumentFetchError(\n      `${what} could not be loaded (${response.status})`,\n      response.status\n    )\n  }\n  return { blob: data, response }\n}\n\n/**\n * The file name a `Content-Disposition` header gives, or `undefined`. Prefers the RFC 5987\n * `filename*=UTF-8''…` form (percent-encoded, any script) over the plain `filename=`.\n */\nexport function contentDispositionFileName(header: string | null | undefined): string | undefined {\n  if (!header) return undefined\n  const extended = /filename\\*\\s*=\\s*(?:[\\w-]+)?'[^']*'([^;]+)/i.exec(header)\n  if (extended) {\n    try {\n      return decodeURIComponent(extended[1].trim().replace(/^\"|\"$/g, '')) || undefined\n    } catch {\n      // A malformed escape: fall back to the plain parameter.\n    }\n  }\n  const plain = /filename\\s*=\\s*(\"((?:[^\"\\\\]|\\\\.)*)\"|[^;]+)/i.exec(header)\n  if (!plain) return undefined\n  const name = plain[2] !== undefined ? plain[2].replace(/\\\\(.)/g, '$1') : plain[1].trim()\n  return name || undefined\n}\n\n/**\n * The PDF of a document version: `GET /v1/document/{id}/view?version=` with\n * `Accept: application/pdf`. Throws a {@link DocumentFetchError} when there is none (yet).\n */\nexport async function fetchDocumentPdf(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob> {\n  const { blob } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/view',\n    documentRef,\n    options,\n    { Accept: 'application/pdf' },\n    'The PDF'\n  )\n  return blob\n}\n\n/**\n * The stored file of a document version, as uploaded: `GET /v1/document/{id}/download`. When the\n * server names the file (`Content-Disposition`), the result is a `File` carrying that name.\n */\nexport async function fetchDocumentFile(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob | File> {\n  const { blob, response } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/download',\n    documentRef,\n    options,\n    {},\n    'The file'\n  )\n  const name = contentDispositionFileName(response.headers.get('Content-Disposition'))\n  return name ? new File([blob], name, { type: blob.type }) : blob\n}\n","/**\n * \"Download with markup\": a document version's markup PDF, the PDF with its annotations as native\n * PDF annotations (comments, highlights, stamps, unapplied redactions), which Acrobat and Preview\n * show. The plain Download serves the original. Kept apart from the annotation layer code so a\n * documents list can offer it without loading the annotation tools.\n *\n * A SIGNED version is locked: nothing but a further signature changes it. Its markup stays in the\n * separate markup layer (a title beside the signature, say) and is never written into its PDF, so\n * it has no \"Download with markup\"; the plain Download is the signed file as it is.\n */\n\nimport type { DocumentToolsClient } from './environment'\n\ninterface DocumentVersions {\n  current_version?: number | null\n  versions?: Array<{ n: number; markup_count?: number | null; reason?: string | null }> | null\n}\n\n/** Why \"Download with markup\" is off for a signed version. */\nexport const SIGNED_LOCKED_REASON =\n  \"Signed documents can't be changed — download the signed file instead\"\n\n/** Whether a version (default: the current one) is a signed copy, per its version entry. */\nexport function isSignedVersion(doc: DocumentVersions, version?: number): boolean {\n  const n = version ?? doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && v.reason === 'signed')\n}\n\nexport class MarkupDownloadError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number\n  ) {\n    super(message)\n    this.name = 'MarkupDownloadError'\n  }\n}\n\n/** Whether a document's current version has markup (per its version entries). */\nexport function currentHasMarkup(doc: DocumentVersions): boolean {\n  const n = doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && (v.markup_count ?? 0) > 0)\n}\n\n/** Fetch a version's markup PDF (default: the current version's). */\nexport async function fetchMarkupPdf(\n  client: DocumentToolsClient,\n  documentId: string,\n  version?: number\n): Promise<{ blob: Blob; fileName: string }> {\n  const { data, response } = await client.GET('/v1/document/{document_ext_id}/markup/pdf', {\n    params: { path: { document_ext_id: documentId }, query: version ? { version } : {} },\n    parseAs: 'blob',\n  })\n  if (!response.ok || !data) {\n    throw new MarkupDownloadError(\n      response.status === 404\n        ? 'This document has no markup yet'\n        : // The server refuses a signed version: its PDF takes no more changes.\n          response.status === 409\n          ? SIGNED_LOCKED_REASON\n          : 'The markup could not be downloaded',\n      response.status\n    )\n  }\n  const disposition = response.headers.get('content-disposition') ?? ''\n  const utf8 = /filename\\*=UTF-8''([^;]+)/i.exec(disposition)?.[1]\n  const plain = /filename=\"([^\"]+)\"/i.exec(disposition)?.[1]\n  const fileName = utf8 ? decodeURIComponent(utf8) : (plain ?? 'markup.pdf')\n  return { blob: data as Blob, fileName }\n}\n"]}
+{"version":3,"sources":["../src/document-tools/environment.tsx","../src/document-tools/document-pdf.ts","../src/document-tools/markup-download.ts"],"names":[],"mappings":"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","file":"chunk-SI7DJWBT.js","sourcesContent":["/**\n * The host app's side of the document tools (markup, freeze, e-signing, versions): the one place\n * the tools reach the app. They never import a store, a router, a toast library or app API code;\n * the host passes what it has to `<DocumentToolsProvider>` and every optional field has a default.\n *\n * `client` is an openapi-fetch client for the ARBI API (`ArbiClient['fetch']` from\n * `@arbidocs/client`, or `arbi.getClient().fetch` from an `@arbidocs/sdk` `Arbi`), signed in with the\n * user's session; it carries the auth.\n */\n\nimport { createContext, useCallback, useContext, useMemo, useRef, type ReactNode } from 'react'\nimport type { ArbiClient, operations } from '@arbidocs/client'\nimport { useDeploymentDomain } from '../useArbi'\n\nexport type DocumentToolsClient = ArbiClient['fetch']\n\nexport type DocumentToolsNoticeKind = 'success' | 'error' | 'info' | 'warning'\n\nexport interface DocumentToolsNoticeOptions {\n  /** A second line under the message. */\n  description?: string\n  /** One action button on the notice (\"Email it\"). */\n  action?: { label: string; onClick: () => void }\n}\n\nexport type DocumentToolsNotify = (\n  message: string,\n  kind: DocumentToolsNoticeKind,\n  options?: DocumentToolsNoticeOptions\n) => void\n\nexport interface DocumentToolsUser {\n  /** The name marks are authored as and the signer's name is prefilled with. */\n  name: string\n  /** The sign-in email: signing re-derives the user's key from it and the password. */\n  email?: string | null\n  /** The user's id (usr-*): which fields of a signature request are theirs. */\n  externalId?: string | null\n}\n\n/** What changed about a document, so the host can refresh its own lists and caches. */\nexport type DocumentChange =\n  /** A version's markup got its first mark or lost its last one. */\n  | 'markup'\n  /** A signature was added: the document has a new current version. */\n  | 'signed'\n  /** A new document was made from it (a frozen copy). The ids are the NEW documents. */\n  | 'copy'\n  /** A new version was saved (the Word editor's Save version): the document's current version. */\n  | 'version'\n\n/**\n * The `/v1/document/upload` query, typed from the API schema: `derived_from` is a list (a\n * production set is derived from every document in it), `shared` a boolean.\n */\nexport type DocumentUploadQuery = NonNullable<operations['upload_documents']['parameters']['query']>\n\nexport interface DocumentUploadRequest {\n  file: File\n  /** `/v1/document/upload` query: `derived_from`, `derived_role`, `shared`, `folder`. */\n  query: DocumentUploadQuery\n}\n\n/**\n * The upload query as a URL query string, for a host that posts the upload itself (an XHR with\n * progress): a list repeats its key (`derived_from=a&derived_from=b`), empty values are left out.\n */\nexport function uploadQueryString(query: DocumentUploadQuery): string {\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query)) {\n    if (value === null || value === undefined) continue\n    for (const item of Array.isArray(value) ? value : [value]) params.append(key, String(item))\n  }\n  return params.toString()\n}\n\nexport interface DocumentToolsEnvironment {\n  client: DocumentToolsClient\n  /**\n   * The deployment domain the user's keys are derived for. Needed for signing. Default: the one\n   * the host's `Arbi` computes (`arbi.getDeploymentDomain()`), if any.\n   */\n  deploymentDomain?: string\n  /** The signed-in user; marks are authored as \"You\" without one, and signing is unavailable. */\n  user?: DocumentToolsUser | null\n  /** Surface a transient message. Default: none (errors still show inline where they can). */\n  notify?: DocumentToolsNotify\n  /** Open a document or a version reference (`doc-…@v2`): the copy just made, the signed copy. */\n  openDocument?: (documentRef: string) => void\n  /**\n   * Documents changed on the server (see {@link DocumentChange}); refresh the host's lists. The\n   * tools wait for it before opening the document, so a copy is listed when it opens.\n   */\n  onDocumentsChanged?: (documentIds: string[], change: DocumentChange) => void | Promise<void>\n  /** Upload a derived copy. Default: `POST /v1/document/upload` through `client`. */\n  uploadDocument?: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n  /** Save a file to the user's computer. Default: a temporary download link. */\n  saveFile?: (blob: Blob, fileName: string) => void\n  /** Email a document (offered once it is signed). Omitted: no \"Email it\". */\n  emailDocument?: (documentRef: string) => void\n  /**\n   * The public page that checks a signature (the certificate) in this app. When given, \"View\n   * certificate\" opens it in preference to the backend's `certificate_url` (which is on the\n   * deployment domain, like the link embedded in the signed PDF). Without it: the backend's\n   * `certificate_url`, else `/verify/{reference}` on this origin.\n   */\n  certificateUrl?: (reference: string) => string\n}\n\n/** The environment with every default filled in. */\nexport interface ResolvedDocumentToolsEnvironment extends DocumentToolsEnvironment {\n  prepareFileShare: (documentId: string) => Promise<void>\n  registerBeforeFileShare: (documentId: string, flush: () => Promise<void>) => () => void\n  notify: DocumentToolsNotify\n  saveFile: (blob: Blob, fileName: string) => void\n  uploadDocument: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n}\n\n/**\n * Save a blob through a temporary `<a download>`. The object URL is revoked a minute later, not at\n * once: revoking straight after `click()` can cancel the download (Safari, and large files\n * elsewhere) before the browser has read the blob.\n */\nexport function downloadBlob(blob: Blob, fileName: string): void {\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = fileName\n  document.body.appendChild(a)\n  a.click()\n  a.remove()\n  setTimeout(() => URL.revokeObjectURL(url), 60_000)\n}\n\n/** The default upload: multipart `files` to `/v1/document/upload` through the API client. */\nexport function clientUpload(client: DocumentToolsClient) {\n  return async ({ file, query }: DocumentUploadRequest) => {\n    const formData = new FormData()\n    formData.append('files', file)\n    const { data, response } = await client.POST('/v1/document/upload', {\n      params: { query },\n      // The schema types the multipart body as `{ files: string[] }`; the FormData is sent as is.\n      body: formData as unknown as { files: string[] },\n      bodySerializer: () => formData,\n    })\n    if (!response.ok) throw new Error(`Upload failed with status ${response.status}`)\n    return data\n  }\n}\n\nexport function defaultCertificateUrl(reference: string): string {\n  const origin = typeof location === 'undefined' ? '' : location.origin\n  return `${origin}/verify/${encodeURIComponent(reference)}`\n}\n\n/**\n * Where \"View certificate\" goes for a signature: the host's `certificateUrl(reference)` when it\n * gives one, else the `certificate_url` the backend returned, else `/verify/{reference}` here.\n */\nexport function certificateLink(\n  signature: { reference: string; certificate_url?: string | null },\n  certificateUrl?: (reference: string) => string\n): string {\n  if (certificateUrl) return certificateUrl(signature.reference)\n  return signature.certificate_url || defaultCertificateUrl(signature.reference)\n}\n\nconst DocumentToolsContext = createContext<ResolvedDocumentToolsEnvironment | null>(null)\n\nexport interface DocumentToolsProviderProps extends DocumentToolsEnvironment {\n  children: ReactNode\n}\n\nexport function DocumentToolsProvider({ children, ...env }: DocumentToolsProviderProps) {\n  const arbiDeploymentDomain = useDeploymentDomain()\n  const guards = useRef(new Map<string, () => Promise<void>>())\n  const pendingFlushes = useRef(new Map<string, Promise<void>>())\n  const registerBeforeFileShare = useCallback((id: string, flush: () => Promise<void>) => {\n    guards.current.set(id, flush)\n    return () => {\n      if (guards.current.get(id) !== flush) return\n      guards.current.delete(id)\n      const pending = flush()\n      pendingFlushes.current.set(id, pending)\n      void pending.then(\n        () => {\n          if (pendingFlushes.current.get(id) === pending) pendingFlushes.current.delete(id)\n        },\n        () => {}\n      )\n    }\n  }, [])\n  const prepareFileShare = useCallback(async (id: string) => {\n    const guard = guards.current.get(id)\n    if (guard) {\n      await guard()\n      pendingFlushes.current.delete(id)\n    } else await pendingFlushes.current.get(id)\n  }, [])\n  const {\n    client,\n    deploymentDomain,\n    user,\n    notify,\n    openDocument,\n    onDocumentsChanged,\n    uploadDocument,\n    saveFile,\n    emailDocument,\n    certificateUrl,\n  } = env\n  const value = useMemo<ResolvedDocumentToolsEnvironment>(\n    () => ({\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain: deploymentDomain ?? arbiDeploymentDomain,\n      user,\n      openDocument,\n      onDocumentsChanged,\n      emailDocument,\n      notify: notify ?? (() => {}),\n      saveFile: saveFile ?? downloadBlob,\n      uploadDocument: uploadDocument ?? clientUpload(client),\n      certificateUrl,\n    }),\n    [\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain,\n      arbiDeploymentDomain,\n      user,\n      notify,\n      openDocument,\n      onDocumentsChanged,\n      uploadDocument,\n      saveFile,\n      emailDocument,\n      certificateUrl,\n    ]\n  )\n  return <DocumentToolsContext.Provider value={value}>{children}</DocumentToolsContext.Provider>\n}\n\n/** The host's environment, or `null` outside a `<DocumentToolsProvider>`. */\nexport function useOptionalDocumentTools(): ResolvedDocumentToolsEnvironment | null {\n  return useContext(DocumentToolsContext)\n}\n\n/** The host's environment; throws outside a `<DocumentToolsProvider>`. */\nexport function useDocumentTools(): ResolvedDocumentToolsEnvironment {\n  const env = useContext(DocumentToolsContext)\n  if (!env) throw new Error('The document tools must be used within a <DocumentToolsProvider>')\n  return env\n}\n","/**\n * A document's bytes, through the host's API client: the PDF the viewer and the tools draw on\n * (`/view`: the file itself for a PDF, its PDF rendering for a Word or text file) and the stored\n * file (`/download`). Either takes a document id or a version reference `doc-…@v{n}`.\n */\n\nimport { parseVersionRef } from '../artifacts/versions'\nimport type { DocumentToolsClient } from './environment'\n\nexport interface DocumentFetchOptions {\n  /** The version to fetch. Default: the one `documentRef` names, else the current version. */\n  version?: number | null\n  signal?: AbortSignal\n}\n\n/** A document's bytes could not be fetched; `status` is the HTTP status. */\nexport class DocumentFetchError extends Error {\n  readonly status: number\n  constructor(message: string, status: number) {\n    super(message)\n    this.name = 'DocumentFetchError'\n    this.status = status\n  }\n}\n\nasync function fetchDocumentBytes(\n  client: DocumentToolsClient,\n  endpoint: '/v1/document/{document_ext_id}/view' | '/v1/document/{document_ext_id}/download',\n  documentRef: string,\n  options: DocumentFetchOptions,\n  headers: Record<string, string>,\n  what: string\n): Promise<{ blob: Blob; response: Response }> {\n  const ref = parseVersionRef(documentRef)\n  const version = options.version ?? ref.version\n  const { data, response } = await client.GET(endpoint, {\n    params: { path: { document_ext_id: ref.docId }, query: version ? { version } : {} },\n    headers,\n    parseAs: 'blob',\n    signal: options.signal,\n  })\n  if (!response.ok || !(data instanceof Blob)) {\n    throw new DocumentFetchError(\n      `${what} could not be loaded (${response.status})`,\n      response.status\n    )\n  }\n  return { blob: data, response }\n}\n\n/**\n * The file name a `Content-Disposition` header gives, or `undefined`. Prefers the RFC 5987\n * `filename*=UTF-8''…` form (percent-encoded, any script) over the plain `filename=`.\n */\nexport function contentDispositionFileName(header: string | null | undefined): string | undefined {\n  if (!header) return undefined\n  const extended = /filename\\*\\s*=\\s*(?:[\\w-]+)?'[^']*'([^;]+)/i.exec(header)\n  if (extended) {\n    try {\n      return decodeURIComponent(extended[1].trim().replace(/^\"|\"$/g, '')) || undefined\n    } catch {\n      // A malformed escape: fall back to the plain parameter.\n    }\n  }\n  const plain = /filename\\s*=\\s*(\"((?:[^\"\\\\]|\\\\.)*)\"|[^;]+)/i.exec(header)\n  if (!plain) return undefined\n  const name = plain[2] !== undefined ? plain[2].replace(/\\\\(.)/g, '$1') : plain[1].trim()\n  return name || undefined\n}\n\n/**\n * The PDF of a document version: `GET /v1/document/{id}/view?version=` with\n * `Accept: application/pdf`. Throws a {@link DocumentFetchError} when there is none (yet).\n */\nexport async function fetchDocumentPdf(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob> {\n  const { blob } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/view',\n    documentRef,\n    options,\n    { Accept: 'application/pdf' },\n    'The PDF'\n  )\n  return blob\n}\n\n/**\n * The stored file of a document version, as uploaded: `GET /v1/document/{id}/download`. When the\n * server names the file (`Content-Disposition`), the result is a `File` carrying that name.\n */\nexport async function fetchDocumentFile(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob | File> {\n  const { blob, response } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/download',\n    documentRef,\n    options,\n    {},\n    'The file'\n  )\n  const name = contentDispositionFileName(response.headers.get('Content-Disposition'))\n  return name ? new File([blob], name, { type: blob.type }) : blob\n}\n","/**\n * \"Download with markup\": a document version's markup PDF, the PDF with its annotations as native\n * PDF annotations (comments, highlights, stamps, unapplied redactions), which Acrobat and Preview\n * show. The plain Download serves the original. Kept apart from the annotation layer code so a\n * documents list can offer it without loading the annotation tools.\n *\n * A SIGNED version is locked: nothing but a further signature changes it. Its markup stays in the\n * separate markup layer (a title beside the signature, say) and is never written into its PDF, so\n * it has no \"Download with markup\"; the plain Download is the signed file as it is.\n */\n\nimport type { DocumentToolsClient } from './environment'\n\ninterface DocumentVersions {\n  current_version?: number | null\n  versions?: Array<{ n: number; markup_count?: number | null; reason?: string | null }> | null\n}\n\n/** Why \"Download with markup\" is off for a signed version. */\nexport const SIGNED_LOCKED_REASON =\n  \"Signed documents can't be changed — download the signed file instead\"\n\n/** Whether a version (default: the current one) is a signed copy, per its version entry. */\nexport function isSignedVersion(doc: DocumentVersions, version?: number): boolean {\n  const n = version ?? doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && v.reason === 'signed')\n}\n\nexport class MarkupDownloadError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number\n  ) {\n    super(message)\n    this.name = 'MarkupDownloadError'\n  }\n}\n\n/** Whether a document's current version has markup (per its version entries). */\nexport function currentHasMarkup(doc: DocumentVersions): boolean {\n  const n = doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && (v.markup_count ?? 0) > 0)\n}\n\n/** Fetch a version's markup PDF (default: the current version's). */\nexport async function fetchMarkupPdf(\n  client: DocumentToolsClient,\n  documentId: string,\n  version?: number\n): Promise<{ blob: Blob; fileName: string }> {\n  const { data, response } = await client.GET('/v1/document/{document_ext_id}/markup/pdf', {\n    params: { path: { document_ext_id: documentId }, query: version ? { version } : {} },\n    parseAs: 'blob',\n  })\n  if (!response.ok || !data) {\n    throw new MarkupDownloadError(\n      response.status === 404\n        ? 'This document has no markup yet'\n        : // The server refuses a signed version: its PDF takes no more changes.\n          response.status === 409\n          ? SIGNED_LOCKED_REASON\n          : 'The markup could not be downloaded',\n      response.status\n    )\n  }\n  const disposition = response.headers.get('content-disposition') ?? ''\n  const utf8 = /filename\\*=UTF-8''([^;]+)/i.exec(disposition)?.[1]\n  const plain = /filename=\"([^\"]+)\"/i.exec(disposition)?.[1]\n  const fileName = utf8 ? decodeURIComponent(utf8) : (plain ?? 'markup.pdf')\n  return { blob: data as Blob, fileName }\n}\n"]}

package/dist/{chunk-3QK4VVPG.cjs → chunk-TGSEQGM3.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkZWFMFOGP_cjs = require('./chunk-ZWFMFOGP.cjs');
 var chunkY7S2SQH3_cjs = require('./chunk-Y7S2SQH3.cjs');
+var chunkZWFMFOGP_cjs = require('./chunk-ZWFMFOGP.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -248,5 +248,5 @@ exports.isSignedVersion = isSignedVersion;
 exports.uploadQueryString = uploadQueryString;
 exports.useDocumentTools = useDocumentTools;
 exports.useOptionalDocumentTools = useOptionalDocumentTools;
-//# sourceMappingURL=chunk-3QK4VVPG.cjs.map
-//# sourceMappingURL=chunk-3QK4VVPG.cjs.map
+//# sourceMappingURL=chunk-TGSEQGM3.cjs.map
+//# sourceMappingURL=chunk-TGSEQGM3.cjs.map

package/dist/{chunk-3QK4VVPG.cjs.map → chunk-TGSEQGM3.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/document-tools/environment.tsx","../src/document-tools/document-pdf.ts","../src/document-tools/markup-download.ts"],"names":["createContext","useDeploymentDomain","useRef","useCallback","useMemo","jsx","useContext","parseVersionRef"],"mappings":"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","file":"chunk-3QK4VVPG.cjs","sourcesContent":["/**\n * The host app's side of the document tools (markup, freeze, e-signing, versions): the one place\n * the tools reach the app. They never import a store, a router, a toast library or app API code;\n * the host passes what it has to `<DocumentToolsProvider>` and every optional field has a default.\n *\n * `client` is an openapi-fetch client for the ARBI API (`ArbiClient['fetch']` from\n * `@arbidocs/client`, or `arbi.getClient().fetch` from an `@arbidocs/sdk` `Arbi`), signed in with the\n * user's session; it carries the auth.\n */\n\nimport { createContext, useCallback, useContext, useMemo, useRef, type ReactNode } from 'react'\nimport type { ArbiClient, operations } from '@arbidocs/client'\nimport { useDeploymentDomain } from '../useArbi'\n\nexport type DocumentToolsClient = ArbiClient['fetch']\n\nexport type DocumentToolsNoticeKind = 'success' | 'error' | 'info' | 'warning'\n\nexport interface DocumentToolsNoticeOptions {\n  /** A second line under the message. */\n  description?: string\n  /** One action button on the notice (\"Email it\"). */\n  action?: { label: string; onClick: () => void }\n}\n\nexport type DocumentToolsNotify = (\n  message: string,\n  kind: DocumentToolsNoticeKind,\n  options?: DocumentToolsNoticeOptions\n) => void\n\nexport interface DocumentToolsUser {\n  /** The name marks are authored as and the signer's name is prefilled with. */\n  name: string\n  /** The sign-in email: signing re-derives the user's key from it and the password. */\n  email?: string | null\n  /** The user's id (usr-*): which fields of a signature request are theirs. */\n  externalId?: string | null\n}\n\n/** What changed about a document, so the host can refresh its own lists and caches. */\nexport type DocumentChange =\n  /** A version's markup got its first mark or lost its last one. */\n  | 'markup'\n  /** A signature was added: the document has a new current version. */\n  | 'signed'\n  /** A new document was made from it (a frozen copy). The ids are the NEW documents. */\n  | 'copy'\n  /** A new version was saved (the Word editor's Save version): the document's current version. */\n  | 'version'\n\n/**\n * The `/v1/document/upload` query, typed from the API schema: `derived_from` is a list (a\n * production set is derived from every document in it), `shared` a boolean.\n */\nexport type DocumentUploadQuery = NonNullable<operations['upload_documents']['parameters']['query']>\n\nexport interface DocumentUploadRequest {\n  file: File\n  /** `/v1/document/upload` query: `derived_from`, `derived_role`, `shared`, `folder`. */\n  query: DocumentUploadQuery\n}\n\n/**\n * The upload query as a URL query string, for a host that posts the upload itself (an XHR with\n * progress): a list repeats its key (`derived_from=a&derived_from=b`), empty values are left out.\n */\nexport function uploadQueryString(query: DocumentUploadQuery): string {\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query)) {\n    if (value === null || value === undefined) continue\n    for (const item of Array.isArray(value) ? value : [value]) params.append(key, String(item))\n  }\n  return params.toString()\n}\n\nexport interface DocumentToolsEnvironment {\n  client: DocumentToolsClient\n  /**\n   * The deployment domain the user's keys are derived for. Needed for signing. Default: the one\n   * the host's `Arbi` computes (`arbi.getDeploymentDomain()`), if any.\n   */\n  deploymentDomain?: string\n  /** The signed-in user; marks are authored as \"You\" without one, and signing is unavailable. */\n  user?: DocumentToolsUser | null\n  /** Surface a transient message. Default: none (errors still show inline where they can). */\n  notify?: DocumentToolsNotify\n  /** Open a document or a version reference (`doc-…@v2`): the copy just made, the signed copy. */\n  openDocument?: (documentRef: string) => void\n  /**\n   * Documents changed on the server (see {@link DocumentChange}); refresh the host's lists. The\n   * tools wait for it before opening the document, so a copy is listed when it opens.\n   */\n  onDocumentsChanged?: (documentIds: string[], change: DocumentChange) => void | Promise<void>\n  /** Upload a derived copy. Default: `POST /v1/document/upload` through `client`. */\n  uploadDocument?: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n  /** Save a file to the user's computer. Default: a temporary download link. */\n  saveFile?: (blob: Blob, fileName: string) => void\n  /** Email a document (offered once it is signed). Omitted: no \"Email it\". */\n  emailDocument?: (documentRef: string) => void\n  /**\n   * The public page that checks a signature (the certificate) in this app. When given, \"View\n   * certificate\" opens it in preference to the backend's `certificate_url` (which is on the\n   * deployment domain, like the link embedded in the signed PDF). Without it: the backend's\n   * `certificate_url`, else `/verify/{reference}` on this origin.\n   */\n  certificateUrl?: (reference: string) => string\n}\n\n/** The environment with every default filled in. */\nexport interface ResolvedDocumentToolsEnvironment extends DocumentToolsEnvironment {\n  prepareFileShare: (documentId: string) => Promise<void>\n  registerBeforeFileShare: (documentId: string, flush: () => Promise<void>) => () => void\n  notify: DocumentToolsNotify\n  saveFile: (blob: Blob, fileName: string) => void\n  uploadDocument: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n}\n\n/**\n * Save a blob through a temporary `<a download>`. The object URL is revoked a minute later, not at\n * once: revoking straight after `click()` can cancel the download (Safari, and large files\n * elsewhere) before the browser has read the blob.\n */\nexport function downloadBlob(blob: Blob, fileName: string): void {\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = fileName\n  document.body.appendChild(a)\n  a.click()\n  a.remove()\n  setTimeout(() => URL.revokeObjectURL(url), 60_000)\n}\n\n/** The default upload: multipart `files` to `/v1/document/upload` through the API client. */\nexport function clientUpload(client: DocumentToolsClient) {\n  return async ({ file, query }: DocumentUploadRequest) => {\n    const formData = new FormData()\n    formData.append('files', file)\n    const { data, response } = await client.POST('/v1/document/upload', {\n      params: { query },\n      // The schema types the multipart body as `{ files: string[] }`; the FormData is sent as is.\n      body: formData as unknown as { files: string[] },\n      bodySerializer: () => formData,\n    })\n    if (!response.ok) throw new Error(`Upload failed with status ${response.status}`)\n    return data\n  }\n}\n\nexport function defaultCertificateUrl(reference: string): string {\n  const origin = typeof location === 'undefined' ? '' : location.origin\n  return `${origin}/verify/${encodeURIComponent(reference)}`\n}\n\n/**\n * Where \"View certificate\" goes for a signature: the host's `certificateUrl(reference)` when it\n * gives one, else the `certificate_url` the backend returned, else `/verify/{reference}` here.\n */\nexport function certificateLink(\n  signature: { reference: string; certificate_url?: string | null },\n  certificateUrl?: (reference: string) => string\n): string {\n  if (certificateUrl) return certificateUrl(signature.reference)\n  return signature.certificate_url || defaultCertificateUrl(signature.reference)\n}\n\nconst DocumentToolsContext = createContext<ResolvedDocumentToolsEnvironment | null>(null)\n\nexport interface DocumentToolsProviderProps extends DocumentToolsEnvironment {\n  children: ReactNode\n}\n\nexport function DocumentToolsProvider({ children, ...env }: DocumentToolsProviderProps) {\n  const arbiDeploymentDomain = useDeploymentDomain()\n  const guards = useRef(new Map<string, () => Promise<void>>())\n  const pendingFlushes = useRef(new Map<string, Promise<void>>())\n  const registerBeforeFileShare = useCallback((id: string, flush: () => Promise<void>) => {\n    guards.current.set(id, flush)\n    return () => {\n      if (guards.current.get(id) !== flush) return\n      guards.current.delete(id)\n      const pending = flush()\n      pendingFlushes.current.set(id, pending)\n      void pending.then(\n        () => {\n          if (pendingFlushes.current.get(id) === pending) pendingFlushes.current.delete(id)\n        },\n        () => {}\n      )\n    }\n  }, [])\n  const prepareFileShare = useCallback(async (id: string) => {\n    const guard = guards.current.get(id)\n    if (guard) {\n      await guard()\n      pendingFlushes.current.delete(id)\n    } else await pendingFlushes.current.get(id)\n  }, [])\n  const {\n    client,\n    deploymentDomain,\n    user,\n    notify,\n    openDocument,\n    onDocumentsChanged,\n    uploadDocument,\n    saveFile,\n    emailDocument,\n    certificateUrl,\n  } = env\n  const value = useMemo<ResolvedDocumentToolsEnvironment>(\n    () => ({\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain: deploymentDomain ?? arbiDeploymentDomain,\n      user,\n      openDocument,\n      onDocumentsChanged,\n      emailDocument,\n      notify: notify ?? (() => {}),\n      saveFile: saveFile ?? downloadBlob,\n      uploadDocument: uploadDocument ?? clientUpload(client),\n      certificateUrl,\n    }),\n    [\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain,\n      arbiDeploymentDomain,\n      user,\n      notify,\n      openDocument,\n      onDocumentsChanged,\n      uploadDocument,\n      saveFile,\n      emailDocument,\n      certificateUrl,\n    ]\n  )\n  return <DocumentToolsContext.Provider value={value}>{children}</DocumentToolsContext.Provider>\n}\n\n/** The host's environment, or `null` outside a `<DocumentToolsProvider>`. */\nexport function useOptionalDocumentTools(): ResolvedDocumentToolsEnvironment | null {\n  return useContext(DocumentToolsContext)\n}\n\n/** The host's environment; throws outside a `<DocumentToolsProvider>`. */\nexport function useDocumentTools(): ResolvedDocumentToolsEnvironment {\n  const env = useContext(DocumentToolsContext)\n  if (!env) throw new Error('The document tools must be used within a <DocumentToolsProvider>')\n  return env\n}\n","/**\n * A document's bytes, through the host's API client: the PDF the viewer and the tools draw on\n * (`/view`: the file itself for a PDF, its PDF rendering for a Word or text file) and the stored\n * file (`/download`). Either takes a document id or a version reference `doc-…@v{n}`.\n */\n\nimport { parseVersionRef } from '../artifacts/versions'\nimport type { DocumentToolsClient } from './environment'\n\nexport interface DocumentFetchOptions {\n  /** The version to fetch. Default: the one `documentRef` names, else the current version. */\n  version?: number | null\n  signal?: AbortSignal\n}\n\n/** A document's bytes could not be fetched; `status` is the HTTP status. */\nexport class DocumentFetchError extends Error {\n  readonly status: number\n  constructor(message: string, status: number) {\n    super(message)\n    this.name = 'DocumentFetchError'\n    this.status = status\n  }\n}\n\nasync function fetchDocumentBytes(\n  client: DocumentToolsClient,\n  endpoint: '/v1/document/{document_ext_id}/view' | '/v1/document/{document_ext_id}/download',\n  documentRef: string,\n  options: DocumentFetchOptions,\n  headers: Record<string, string>,\n  what: string\n): Promise<{ blob: Blob; response: Response }> {\n  const ref = parseVersionRef(documentRef)\n  const version = options.version ?? ref.version\n  const { data, response } = await client.GET(endpoint, {\n    params: { path: { document_ext_id: ref.docId }, query: version ? { version } : {} },\n    headers,\n    parseAs: 'blob',\n    signal: options.signal,\n  })\n  if (!response.ok || !(data instanceof Blob)) {\n    throw new DocumentFetchError(\n      `${what} could not be loaded (${response.status})`,\n      response.status\n    )\n  }\n  return { blob: data, response }\n}\n\n/**\n * The file name a `Content-Disposition` header gives, or `undefined`. Prefers the RFC 5987\n * `filename*=UTF-8''…` form (percent-encoded, any script) over the plain `filename=`.\n */\nexport function contentDispositionFileName(header: string | null | undefined): string | undefined {\n  if (!header) return undefined\n  const extended = /filename\\*\\s*=\\s*(?:[\\w-]+)?'[^']*'([^;]+)/i.exec(header)\n  if (extended) {\n    try {\n      return decodeURIComponent(extended[1].trim().replace(/^\"|\"$/g, '')) || undefined\n    } catch {\n      // A malformed escape: fall back to the plain parameter.\n    }\n  }\n  const plain = /filename\\s*=\\s*(\"((?:[^\"\\\\]|\\\\.)*)\"|[^;]+)/i.exec(header)\n  if (!plain) return undefined\n  const name = plain[2] !== undefined ? plain[2].replace(/\\\\(.)/g, '$1') : plain[1].trim()\n  return name || undefined\n}\n\n/**\n * The PDF of a document version: `GET /v1/document/{id}/view?version=` with\n * `Accept: application/pdf`. Throws a {@link DocumentFetchError} when there is none (yet).\n */\nexport async function fetchDocumentPdf(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob> {\n  const { blob } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/view',\n    documentRef,\n    options,\n    { Accept: 'application/pdf' },\n    'The PDF'\n  )\n  return blob\n}\n\n/**\n * The stored file of a document version, as uploaded: `GET /v1/document/{id}/download`. When the\n * server names the file (`Content-Disposition`), the result is a `File` carrying that name.\n */\nexport async function fetchDocumentFile(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob | File> {\n  const { blob, response } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/download',\n    documentRef,\n    options,\n    {},\n    'The file'\n  )\n  const name = contentDispositionFileName(response.headers.get('Content-Disposition'))\n  return name ? new File([blob], name, { type: blob.type }) : blob\n}\n","/**\n * \"Download with markup\": a document version's markup PDF, the PDF with its annotations as native\n * PDF annotations (comments, highlights, stamps, unapplied redactions), which Acrobat and Preview\n * show. The plain Download serves the original. Kept apart from the annotation layer code so a\n * documents list can offer it without loading the annotation tools.\n *\n * A SIGNED version is locked: nothing but a further signature changes it. Its markup stays in the\n * separate markup layer (a title beside the signature, say) and is never written into its PDF, so\n * it has no \"Download with markup\"; the plain Download is the signed file as it is.\n */\n\nimport type { DocumentToolsClient } from './environment'\n\ninterface DocumentVersions {\n  current_version?: number | null\n  versions?: Array<{ n: number; markup_count?: number | null; reason?: string | null }> | null\n}\n\n/** Why \"Download with markup\" is off for a signed version. */\nexport const SIGNED_LOCKED_REASON =\n  \"Signed documents can't be changed — download the signed file instead\"\n\n/** Whether a version (default: the current one) is a signed copy, per its version entry. */\nexport function isSignedVersion(doc: DocumentVersions, version?: number): boolean {\n  const n = version ?? doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && v.reason === 'signed')\n}\n\nexport class MarkupDownloadError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number\n  ) {\n    super(message)\n    this.name = 'MarkupDownloadError'\n  }\n}\n\n/** Whether a document's current version has markup (per its version entries). */\nexport function currentHasMarkup(doc: DocumentVersions): boolean {\n  const n = doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && (v.markup_count ?? 0) > 0)\n}\n\n/** Fetch a version's markup PDF (default: the current version's). */\nexport async function fetchMarkupPdf(\n  client: DocumentToolsClient,\n  documentId: string,\n  version?: number\n): Promise<{ blob: Blob; fileName: string }> {\n  const { data, response } = await client.GET('/v1/document/{document_ext_id}/markup/pdf', {\n    params: { path: { document_ext_id: documentId }, query: version ? { version } : {} },\n    parseAs: 'blob',\n  })\n  if (!response.ok || !data) {\n    throw new MarkupDownloadError(\n      response.status === 404\n        ? 'This document has no markup yet'\n        : // The server refuses a signed version: its PDF takes no more changes.\n          response.status === 409\n          ? SIGNED_LOCKED_REASON\n          : 'The markup could not be downloaded',\n      response.status\n    )\n  }\n  const disposition = response.headers.get('content-disposition') ?? ''\n  const utf8 = /filename\\*=UTF-8''([^;]+)/i.exec(disposition)?.[1]\n  const plain = /filename=\"([^\"]+)\"/i.exec(disposition)?.[1]\n  const fileName = utf8 ? decodeURIComponent(utf8) : (plain ?? 'markup.pdf')\n  return { blob: data as Blob, fileName }\n}\n"]}
+{"version":3,"sources":["../src/document-tools/environment.tsx","../src/document-tools/document-pdf.ts","../src/document-tools/markup-download.ts"],"names":["createContext","useDeploymentDomain","useRef","useCallback","useMemo","jsx","useContext","parseVersionRef"],"mappings":"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","file":"chunk-TGSEQGM3.cjs","sourcesContent":["/**\n * The host app's side of the document tools (markup, freeze, e-signing, versions): the one place\n * the tools reach the app. They never import a store, a router, a toast library or app API code;\n * the host passes what it has to `<DocumentToolsProvider>` and every optional field has a default.\n *\n * `client` is an openapi-fetch client for the ARBI API (`ArbiClient['fetch']` from\n * `@arbidocs/client`, or `arbi.getClient().fetch` from an `@arbidocs/sdk` `Arbi`), signed in with the\n * user's session; it carries the auth.\n */\n\nimport { createContext, useCallback, useContext, useMemo, useRef, type ReactNode } from 'react'\nimport type { ArbiClient, operations } from '@arbidocs/client'\nimport { useDeploymentDomain } from '../useArbi'\n\nexport type DocumentToolsClient = ArbiClient['fetch']\n\nexport type DocumentToolsNoticeKind = 'success' | 'error' | 'info' | 'warning'\n\nexport interface DocumentToolsNoticeOptions {\n  /** A second line under the message. */\n  description?: string\n  /** One action button on the notice (\"Email it\"). */\n  action?: { label: string; onClick: () => void }\n}\n\nexport type DocumentToolsNotify = (\n  message: string,\n  kind: DocumentToolsNoticeKind,\n  options?: DocumentToolsNoticeOptions\n) => void\n\nexport interface DocumentToolsUser {\n  /** The name marks are authored as and the signer's name is prefilled with. */\n  name: string\n  /** The sign-in email: signing re-derives the user's key from it and the password. */\n  email?: string | null\n  /** The user's id (usr-*): which fields of a signature request are theirs. */\n  externalId?: string | null\n}\n\n/** What changed about a document, so the host can refresh its own lists and caches. */\nexport type DocumentChange =\n  /** A version's markup got its first mark or lost its last one. */\n  | 'markup'\n  /** A signature was added: the document has a new current version. */\n  | 'signed'\n  /** A new document was made from it (a frozen copy). The ids are the NEW documents. */\n  | 'copy'\n  /** A new version was saved (the Word editor's Save version): the document's current version. */\n  | 'version'\n\n/**\n * The `/v1/document/upload` query, typed from the API schema: `derived_from` is a list (a\n * production set is derived from every document in it), `shared` a boolean.\n */\nexport type DocumentUploadQuery = NonNullable<operations['upload_documents']['parameters']['query']>\n\nexport interface DocumentUploadRequest {\n  file: File\n  /** `/v1/document/upload` query: `derived_from`, `derived_role`, `shared`, `folder`. */\n  query: DocumentUploadQuery\n}\n\n/**\n * The upload query as a URL query string, for a host that posts the upload itself (an XHR with\n * progress): a list repeats its key (`derived_from=a&derived_from=b`), empty values are left out.\n */\nexport function uploadQueryString(query: DocumentUploadQuery): string {\n  const params = new URLSearchParams()\n  for (const [key, value] of Object.entries(query)) {\n    if (value === null || value === undefined) continue\n    for (const item of Array.isArray(value) ? value : [value]) params.append(key, String(item))\n  }\n  return params.toString()\n}\n\nexport interface DocumentToolsEnvironment {\n  client: DocumentToolsClient\n  /**\n   * The deployment domain the user's keys are derived for. Needed for signing. Default: the one\n   * the host's `Arbi` computes (`arbi.getDeploymentDomain()`), if any.\n   */\n  deploymentDomain?: string\n  /** The signed-in user; marks are authored as \"You\" without one, and signing is unavailable. */\n  user?: DocumentToolsUser | null\n  /** Surface a transient message. Default: none (errors still show inline where they can). */\n  notify?: DocumentToolsNotify\n  /** Open a document or a version reference (`doc-…@v2`): the copy just made, the signed copy. */\n  openDocument?: (documentRef: string) => void\n  /**\n   * Documents changed on the server (see {@link DocumentChange}); refresh the host's lists. The\n   * tools wait for it before opening the document, so a copy is listed when it opens.\n   */\n  onDocumentsChanged?: (documentIds: string[], change: DocumentChange) => void | Promise<void>\n  /** Upload a derived copy. Default: `POST /v1/document/upload` through `client`. */\n  uploadDocument?: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n  /** Save a file to the user's computer. Default: a temporary download link. */\n  saveFile?: (blob: Blob, fileName: string) => void\n  /** Email a document (offered once it is signed). Omitted: no \"Email it\". */\n  emailDocument?: (documentRef: string) => void\n  /**\n   * The public page that checks a signature (the certificate) in this app. When given, \"View\n   * certificate\" opens it in preference to the backend's `certificate_url` (which is on the\n   * deployment domain, like the link embedded in the signed PDF). Without it: the backend's\n   * `certificate_url`, else `/verify/{reference}` on this origin.\n   */\n  certificateUrl?: (reference: string) => string\n}\n\n/** The environment with every default filled in. */\nexport interface ResolvedDocumentToolsEnvironment extends DocumentToolsEnvironment {\n  prepareFileShare: (documentId: string) => Promise<void>\n  registerBeforeFileShare: (documentId: string, flush: () => Promise<void>) => () => void\n  notify: DocumentToolsNotify\n  saveFile: (blob: Blob, fileName: string) => void\n  uploadDocument: (\n    request: DocumentUploadRequest\n  ) => Promise<{ doc_ext_ids?: string[] } | undefined>\n}\n\n/**\n * Save a blob through a temporary `<a download>`. The object URL is revoked a minute later, not at\n * once: revoking straight after `click()` can cancel the download (Safari, and large files\n * elsewhere) before the browser has read the blob.\n */\nexport function downloadBlob(blob: Blob, fileName: string): void {\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = fileName\n  document.body.appendChild(a)\n  a.click()\n  a.remove()\n  setTimeout(() => URL.revokeObjectURL(url), 60_000)\n}\n\n/** The default upload: multipart `files` to `/v1/document/upload` through the API client. */\nexport function clientUpload(client: DocumentToolsClient) {\n  return async ({ file, query }: DocumentUploadRequest) => {\n    const formData = new FormData()\n    formData.append('files', file)\n    const { data, response } = await client.POST('/v1/document/upload', {\n      params: { query },\n      // The schema types the multipart body as `{ files: string[] }`; the FormData is sent as is.\n      body: formData as unknown as { files: string[] },\n      bodySerializer: () => formData,\n    })\n    if (!response.ok) throw new Error(`Upload failed with status ${response.status}`)\n    return data\n  }\n}\n\nexport function defaultCertificateUrl(reference: string): string {\n  const origin = typeof location === 'undefined' ? '' : location.origin\n  return `${origin}/verify/${encodeURIComponent(reference)}`\n}\n\n/**\n * Where \"View certificate\" goes for a signature: the host's `certificateUrl(reference)` when it\n * gives one, else the `certificate_url` the backend returned, else `/verify/{reference}` here.\n */\nexport function certificateLink(\n  signature: { reference: string; certificate_url?: string | null },\n  certificateUrl?: (reference: string) => string\n): string {\n  if (certificateUrl) return certificateUrl(signature.reference)\n  return signature.certificate_url || defaultCertificateUrl(signature.reference)\n}\n\nconst DocumentToolsContext = createContext<ResolvedDocumentToolsEnvironment | null>(null)\n\nexport interface DocumentToolsProviderProps extends DocumentToolsEnvironment {\n  children: ReactNode\n}\n\nexport function DocumentToolsProvider({ children, ...env }: DocumentToolsProviderProps) {\n  const arbiDeploymentDomain = useDeploymentDomain()\n  const guards = useRef(new Map<string, () => Promise<void>>())\n  const pendingFlushes = useRef(new Map<string, Promise<void>>())\n  const registerBeforeFileShare = useCallback((id: string, flush: () => Promise<void>) => {\n    guards.current.set(id, flush)\n    return () => {\n      if (guards.current.get(id) !== flush) return\n      guards.current.delete(id)\n      const pending = flush()\n      pendingFlushes.current.set(id, pending)\n      void pending.then(\n        () => {\n          if (pendingFlushes.current.get(id) === pending) pendingFlushes.current.delete(id)\n        },\n        () => {}\n      )\n    }\n  }, [])\n  const prepareFileShare = useCallback(async (id: string) => {\n    const guard = guards.current.get(id)\n    if (guard) {\n      await guard()\n      pendingFlushes.current.delete(id)\n    } else await pendingFlushes.current.get(id)\n  }, [])\n  const {\n    client,\n    deploymentDomain,\n    user,\n    notify,\n    openDocument,\n    onDocumentsChanged,\n    uploadDocument,\n    saveFile,\n    emailDocument,\n    certificateUrl,\n  } = env\n  const value = useMemo<ResolvedDocumentToolsEnvironment>(\n    () => ({\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain: deploymentDomain ?? arbiDeploymentDomain,\n      user,\n      openDocument,\n      onDocumentsChanged,\n      emailDocument,\n      notify: notify ?? (() => {}),\n      saveFile: saveFile ?? downloadBlob,\n      uploadDocument: uploadDocument ?? clientUpload(client),\n      certificateUrl,\n    }),\n    [\n      client,\n      prepareFileShare,\n      registerBeforeFileShare,\n      deploymentDomain,\n      arbiDeploymentDomain,\n      user,\n      notify,\n      openDocument,\n      onDocumentsChanged,\n      uploadDocument,\n      saveFile,\n      emailDocument,\n      certificateUrl,\n    ]\n  )\n  return <DocumentToolsContext.Provider value={value}>{children}</DocumentToolsContext.Provider>\n}\n\n/** The host's environment, or `null` outside a `<DocumentToolsProvider>`. */\nexport function useOptionalDocumentTools(): ResolvedDocumentToolsEnvironment | null {\n  return useContext(DocumentToolsContext)\n}\n\n/** The host's environment; throws outside a `<DocumentToolsProvider>`. */\nexport function useDocumentTools(): ResolvedDocumentToolsEnvironment {\n  const env = useContext(DocumentToolsContext)\n  if (!env) throw new Error('The document tools must be used within a <DocumentToolsProvider>')\n  return env\n}\n","/**\n * A document's bytes, through the host's API client: the PDF the viewer and the tools draw on\n * (`/view`: the file itself for a PDF, its PDF rendering for a Word or text file) and the stored\n * file (`/download`). Either takes a document id or a version reference `doc-…@v{n}`.\n */\n\nimport { parseVersionRef } from '../artifacts/versions'\nimport type { DocumentToolsClient } from './environment'\n\nexport interface DocumentFetchOptions {\n  /** The version to fetch. Default: the one `documentRef` names, else the current version. */\n  version?: number | null\n  signal?: AbortSignal\n}\n\n/** A document's bytes could not be fetched; `status` is the HTTP status. */\nexport class DocumentFetchError extends Error {\n  readonly status: number\n  constructor(message: string, status: number) {\n    super(message)\n    this.name = 'DocumentFetchError'\n    this.status = status\n  }\n}\n\nasync function fetchDocumentBytes(\n  client: DocumentToolsClient,\n  endpoint: '/v1/document/{document_ext_id}/view' | '/v1/document/{document_ext_id}/download',\n  documentRef: string,\n  options: DocumentFetchOptions,\n  headers: Record<string, string>,\n  what: string\n): Promise<{ blob: Blob; response: Response }> {\n  const ref = parseVersionRef(documentRef)\n  const version = options.version ?? ref.version\n  const { data, response } = await client.GET(endpoint, {\n    params: { path: { document_ext_id: ref.docId }, query: version ? { version } : {} },\n    headers,\n    parseAs: 'blob',\n    signal: options.signal,\n  })\n  if (!response.ok || !(data instanceof Blob)) {\n    throw new DocumentFetchError(\n      `${what} could not be loaded (${response.status})`,\n      response.status\n    )\n  }\n  return { blob: data, response }\n}\n\n/**\n * The file name a `Content-Disposition` header gives, or `undefined`. Prefers the RFC 5987\n * `filename*=UTF-8''…` form (percent-encoded, any script) over the plain `filename=`.\n */\nexport function contentDispositionFileName(header: string | null | undefined): string | undefined {\n  if (!header) return undefined\n  const extended = /filename\\*\\s*=\\s*(?:[\\w-]+)?'[^']*'([^;]+)/i.exec(header)\n  if (extended) {\n    try {\n      return decodeURIComponent(extended[1].trim().replace(/^\"|\"$/g, '')) || undefined\n    } catch {\n      // A malformed escape: fall back to the plain parameter.\n    }\n  }\n  const plain = /filename\\s*=\\s*(\"((?:[^\"\\\\]|\\\\.)*)\"|[^;]+)/i.exec(header)\n  if (!plain) return undefined\n  const name = plain[2] !== undefined ? plain[2].replace(/\\\\(.)/g, '$1') : plain[1].trim()\n  return name || undefined\n}\n\n/**\n * The PDF of a document version: `GET /v1/document/{id}/view?version=` with\n * `Accept: application/pdf`. Throws a {@link DocumentFetchError} when there is none (yet).\n */\nexport async function fetchDocumentPdf(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob> {\n  const { blob } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/view',\n    documentRef,\n    options,\n    { Accept: 'application/pdf' },\n    'The PDF'\n  )\n  return blob\n}\n\n/**\n * The stored file of a document version, as uploaded: `GET /v1/document/{id}/download`. When the\n * server names the file (`Content-Disposition`), the result is a `File` carrying that name.\n */\nexport async function fetchDocumentFile(\n  client: DocumentToolsClient,\n  documentRef: string,\n  options: DocumentFetchOptions = {}\n): Promise<Blob | File> {\n  const { blob, response } = await fetchDocumentBytes(\n    client,\n    '/v1/document/{document_ext_id}/download',\n    documentRef,\n    options,\n    {},\n    'The file'\n  )\n  const name = contentDispositionFileName(response.headers.get('Content-Disposition'))\n  return name ? new File([blob], name, { type: blob.type }) : blob\n}\n","/**\n * \"Download with markup\": a document version's markup PDF, the PDF with its annotations as native\n * PDF annotations (comments, highlights, stamps, unapplied redactions), which Acrobat and Preview\n * show. The plain Download serves the original. Kept apart from the annotation layer code so a\n * documents list can offer it without loading the annotation tools.\n *\n * A SIGNED version is locked: nothing but a further signature changes it. Its markup stays in the\n * separate markup layer (a title beside the signature, say) and is never written into its PDF, so\n * it has no \"Download with markup\"; the plain Download is the signed file as it is.\n */\n\nimport type { DocumentToolsClient } from './environment'\n\ninterface DocumentVersions {\n  current_version?: number | null\n  versions?: Array<{ n: number; markup_count?: number | null; reason?: string | null }> | null\n}\n\n/** Why \"Download with markup\" is off for a signed version. */\nexport const SIGNED_LOCKED_REASON =\n  \"Signed documents can't be changed — download the signed file instead\"\n\n/** Whether a version (default: the current one) is a signed copy, per its version entry. */\nexport function isSignedVersion(doc: DocumentVersions, version?: number): boolean {\n  const n = version ?? doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && v.reason === 'signed')\n}\n\nexport class MarkupDownloadError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number\n  ) {\n    super(message)\n    this.name = 'MarkupDownloadError'\n  }\n}\n\n/** Whether a document's current version has markup (per its version entries). */\nexport function currentHasMarkup(doc: DocumentVersions): boolean {\n  const n = doc.current_version ?? 1\n  return (doc.versions ?? []).some((v) => v.n === n && (v.markup_count ?? 0) > 0)\n}\n\n/** Fetch a version's markup PDF (default: the current version's). */\nexport async function fetchMarkupPdf(\n  client: DocumentToolsClient,\n  documentId: string,\n  version?: number\n): Promise<{ blob: Blob; fileName: string }> {\n  const { data, response } = await client.GET('/v1/document/{document_ext_id}/markup/pdf', {\n    params: { path: { document_ext_id: documentId }, query: version ? { version } : {} },\n    parseAs: 'blob',\n  })\n  if (!response.ok || !data) {\n    throw new MarkupDownloadError(\n      response.status === 404\n        ? 'This document has no markup yet'\n        : // The server refuses a signed version: its PDF takes no more changes.\n          response.status === 409\n          ? SIGNED_LOCKED_REASON\n          : 'The markup could not be downloaded',\n      response.status\n    )\n  }\n  const disposition = response.headers.get('content-disposition') ?? ''\n  const utf8 = /filename\\*=UTF-8''([^;]+)/i.exec(disposition)?.[1]\n  const plain = /filename=\"([^\"]+)\"/i.exec(disposition)?.[1]\n  const fileName = utf8 ? decodeURIComponent(utf8) : (plain ?? 'markup.pdf')\n  return { blob: data as Blob, fileName }\n}\n"]}

package/dist/{chunk-LCSUCZVX.cjs → chunk-ZNQPUPX6.cjs}

@@ -1,11 +1,12 @@
 'use strict';
 
-var chunkG76ASVVH_cjs = require('./chunk-G76ASVVH.cjs');
+var chunkGQAXAZN7_cjs = require('./chunk-GQAXAZN7.cjs');
 var chunkY7S2SQH3_cjs = require('./chunk-Y7S2SQH3.cjs');
 var zustand = require('zustand');
 var react = require('react');
 var reactQuery = require('@tanstack/react-query');
 var browser = require('@arbidocs/sdk/browser');
+var client = require('@arbidocs/client');
 
 // src/documents/documents-cache.ts
 var rowListeners = /* @__PURE__ */ new Set();
@@ -17,10 +18,10 @@ function subscribeDocumentRows(listener) {
 }
 function getCachedDocuments(qc, workspaceId) {
   if (!workspaceId) return void 0;
-  return qc.getQueryData(chunkG76ASVVH_cjs.arbiQueryKeys.documents(workspaceId));
+  return qc.getQueryData(chunkGQAXAZN7_cjs.arbiQueryKeys.documents(workspaceId));
 }
 function cachedLists(qc) {
-  return qc.getQueriesData({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.allDocuments() }).flatMap(
+  return qc.getQueriesData({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.allDocuments() }).flatMap(
     ([key, data]) => typeof key[2] === "string" && Array.isArray(data) ? [[key[2], data]] : []
   );
 }
@@ -46,13 +47,13 @@ function patchDocuments(qc, reducer, workspaceId) {
   for (const [id, before] of lists) {
     const after = reducer(before);
     if (after === before) continue;
-    qc.setQueryData(chunkG76ASVVH_cjs.arbiQueryKeys.documents(id), after);
+    qc.setQueryData(chunkGQAXAZN7_cjs.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: chunkG76ASVVH_cjs.arbiQueryKeys.allDocumentVersions() });
+      void qc.invalidateQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.allDocumentVersions() });
     if (change.add.length || change.update.length || change.remove.length)
       for (const listener of rowListeners) listener(change);
   }
@@ -80,11 +81,11 @@ function upsertDocuments(qc, documents, workspaceId) {
   }
 }
 function setCachedDocument(qc, doc) {
-  qc.setQueryData(chunkG76ASVVH_cjs.arbiQueryKeys.document(doc.external_id), doc);
+  qc.setQueryData(chunkGQAXAZN7_cjs.arbiQueryKeys.document(doc.external_id), doc);
 }
 function patchCachedDocument(qc, docId, reducer) {
-  const current = qc.getQueryData(chunkG76ASVVH_cjs.arbiQueryKeys.document(docId));
-  if (current) qc.setQueryData(chunkG76ASVVH_cjs.arbiQueryKeys.document(docId), reducer(current));
+  const current = qc.getQueryData(chunkGQAXAZN7_cjs.arbiQueryKeys.document(docId));
+  if (current) qc.setQueryData(chunkGQAXAZN7_cjs.arbiQueryKeys.document(docId), reducer(current));
 }
 function dropTagFromCachedDocuments(qc, tagId) {
   const strip = (doc) => {
@@ -101,9 +102,9 @@ function dropTagFromCachedDocuments(qc, tagId) {
 }
 function forgetDocuments(qc, docIds) {
   for (const id of docIds) {
-    qc.removeQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.document(id) });
-    qc.removeQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.documentVersions(id) });
-    qc.removeQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.parsedDocument(id) });
+    qc.removeQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.document(id) });
+    qc.removeQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.documentVersions(id) });
+    qc.removeQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.parsedDocument(id) });
   }
 }
 var useEntityExtractionStore = zustand.create(() => ({ docIds: [] }));
@@ -124,23 +125,79 @@ function finishEntityExtraction(docIds) {
 function useEntityExtractionDocIds() {
   return useEntityExtractionStore((state) => state.docIds);
 }
+var QUEUED_WRITE_BLOCKED_MESSAGE = "This change belongs to a workspace that can't be opened right now, so it was not sent. It is kept here until it can be.";
+function primeOnClient(client) {
+  return (workspaceId) => workspaceId === client.session.getState().selectedWorkspaceId ? void 0 : client.workspaceKeys.prime(workspaceId);
+}
+function primeOnArbi(arbi) {
+  return (workspaceId) => arbi.hasWorkspace && workspaceId === arbi.getWorkspaceId() ? void 0 : arbi.workspaces.open(workspaceId);
+}
+async function inWorkspace(prime, workspaceId, write) {
+  if (workspaceId) {
+    try {
+      await prime(workspaceId);
+    } catch (error) {
+      if (client.isAbortError(error)) throw error;
+      throw new browser.ArbiWorkspaceUnavailableError(workspaceId, error, QUEUED_WRITE_BLOCKED_MESSAGE);
+    }
+  }
+  return write();
+}
+function isWorkspaceUnavailable(error) {
+  return error instanceof browser.ArbiWorkspaceUnavailableError;
+}
+var QUEUED_WRITE_RETRY = {
+  retry: (failureCount, error) => isWorkspaceUnavailable(error) && failureCount < 8,
+  retryDelay: (attempt) => Math.min(1e3 * 2 ** attempt, 3e4)
+};
+function isBlockedOnWorkspace(mutation) {
+  return isWorkspaceUnavailable(mutation.state.error ?? mutation.state.failureReason);
+}
+function useCapturingWorkspace(mutation, capture) {
+  const captureRef = react.useRef(capture);
+  captureRef.current = capture;
+  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;
+  const mutate = react.useCallback(
+    (variables, ...rest) => rawMutate(captureRef.current(variables), ...rest),
+    [rawMutate]
+  );
+  const mutateAsync = react.useCallback(
+    (variables, ...rest) => rawMutateAsync(
+      captureRef.current(variables),
+      ...rest
+    ),
+    [rawMutateAsync]
+  );
+  return { ...mutation, mutate, mutateAsync };
+}
+
+// src/tags.ts
+function workspaceOfTag(qc, tagId) {
+  for (const [key, tags] of qc.getQueriesData({
+    queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.allTags()
+  })) {
+    if (Array.isArray(tags) && tags.some((t) => t.external_id === tagId))
+      return key[2] ?? null;
+  }
+  return null;
+}
 function openWorkspaceId(arbi) {
   return arbi.hasWorkspace ? arbi.getWorkspaceId() : null;
 }
 function patchWorkspaceTags(qc, workspaceId, reducer) {
-  const key = chunkG76ASVVH_cjs.arbiQueryKeys.tags(workspaceId);
+  const key = chunkGQAXAZN7_cjs.arbiQueryKeys.tags(workspaceId);
   const current = qc.getQueryData(key);
   if (!current) return;
   const next = reducer(current);
   if (next !== current) qc.setQueryData(key, next);
 }
 function invalidateTagTables(qc, workspaceId) {
-  return qc.invalidateQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.tagLists(workspaceId) });
+  return qc.invalidateQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.tagLists(workspaceId) });
 }
 function invalidateTagData(qc, workspaceId) {
   return Promise.all([
-    qc.invalidateQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.tags(workspaceId) }),
-    qc.invalidateQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.facts(workspaceId) })
+    qc.invalidateQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.tags(workspaceId) }),
+    qc.invalidateQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.facts(workspaceId) })
   ]);
 }
 function useInvalidateTagData() {
@@ -171,19 +228,25 @@ function settleChangedTag(qc, tag) {
 }
 var replayableTagMutations = [
   {
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.createTag(),
-    run: (client, input) => browser.tags.createTag(client, input),
+    mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.createTag(),
+    // In the workspace it was made in (named on the request), opened for this session first.
+    run: (client, input) => inWorkspace(primeOnClient(client), input.workspaceId, () => browser.tags.createTag(client, input)),
     settle: (qc, created) => settleCreatedTag(qc, created)
   }
 ];
 function useCreateTag() {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const qc = reactQuery.useQueryClient();
-  return reactQuery.useMutation({
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.createTag(),
-    mutationFn: (input) => arbi.tags.create(input),
-    onSuccess: (created) => settleCreatedTag(qc, created)
-  });
+  const capture = (input) => input.workspaceId || !arbi.hasWorkspace ? input : { ...input, workspaceId: arbi.getWorkspaceId() };
+  return useCapturingWorkspace(
+    reactQuery.useMutation({
+      mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.createTag(),
+      mutationFn: (input) => inWorkspace(primeOnArbi(arbi), input.workspaceId, () => arbi.tags.create(input)),
+      onSuccess: (created) => settleCreatedTag(qc, created),
+      ...QUEUED_WRITE_RETRY
+    }),
+    capture
+  );
 }
 function useIsCreatingTag() {
   const qc = reactQuery.useQueryClient();
@@ -191,7 +254,7 @@ function useIsCreatingTag() {
     (name) => {
       const wanted = name.trim().toLowerCase();
       return qc.getMutationCache().findAll({
-        mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.createTag(),
+        mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.createTag(),
         predicate: (m) => m.state.status === "pending" && m.state.variables?.name.trim().toLowerCase() === wanted
       }).length > 0;
     },
@@ -202,7 +265,7 @@ function useUpdateTag() {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const qc = reactQuery.useQueryClient();
   return reactQuery.useMutation({
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.updateTag(),
+    mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.updateTag(),
     mutationFn: ({ tagId, change }) => arbi.tags.update(tagId, change),
     onSuccess: (tag) => settleChangedTag(qc, tag)
   });
@@ -211,7 +274,7 @@ function useSetTagValues() {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const qc = reactQuery.useQueryClient();
   return reactQuery.useMutation({
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.updateTag(),
+    mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.updateTag(),
     mutationFn: ({
       tagId,
       values
@@ -223,11 +286,14 @@ function useDeleteTag() {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const qc = reactQuery.useQueryClient();
   return reactQuery.useMutation({
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.deleteTag(),
+    mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.deleteTag(),
     mutationFn: (tagId) => arbi.tags.delete(tagId),
-    onSuccess: (_data, tagId) => {
+    // The tag's own workspace (the cached list holding it), else the one open when it is sent: a
+    // switch while the delete runs must not patch the next workspace's list.
+    onMutate: (tagId) => ({ workspaceId: workspaceOfTag(qc, tagId) ?? openWorkspaceId(arbi) }),
+    onSuccess: (_data, tagId, context) => {
       dropTagFromCachedDocuments(qc, tagId);
-      const workspaceId = openWorkspaceId(arbi);
+      const workspaceId = context?.workspaceId;
       if (!workspaceId) return;
       patchWorkspaceTags(
         qc,
@@ -236,7 +302,7 @@ function useDeleteTag() {
       );
       return Promise.all([
         invalidateTagTables(qc, workspaceId),
-        qc.invalidateQueries({ queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.facts(workspaceId) })
+        qc.invalidateQueries({ queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.facts(workspaceId) })
       ]);
     }
   });
@@ -244,7 +310,7 @@ function useDeleteTag() {
 function useExtractEntities() {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   return reactQuery.useMutation({
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.extractEntities(),
+    mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.extractEntities(),
     mutationFn: (docIds) => arbi.tags.extractEntities(docIds),
     onSuccess: (data) => startEntityExtraction(data.doc_ext_ids)
   });
@@ -253,7 +319,7 @@ function useTagKindSchema(kind, options) {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const workspaceId = openWorkspaceId(arbi) ?? "";
   return reactQuery.useQuery({
-    queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.tagKind(workspaceId, kind ?? ""),
+    queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.tagKind(workspaceId, kind ?? ""),
     queryFn: () => arbi.readInWorkspace(workspaceId, () => arbi.tagKinds.get(kind)),
     enabled: (options?.enabled ?? true) && !!kind && !!workspaceId
   });
@@ -262,15 +328,18 @@ function useUpdateTagKindSchema() {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const qc = reactQuery.useQueryClient();
   return reactQuery.useMutation({
-    mutationKey: chunkG76ASVVH_cjs.arbiMutationKeys.updateTagKindSchema(),
+    mutationKey: chunkGQAXAZN7_cjs.arbiMutationKeys.updateTagKindSchema(),
     mutationFn: ({
       kind,
       fields
     }) => arbi.tagKinds.update(kind, fields),
-    onSuccess: (schema) => {
-      const workspaceId = openWorkspaceId(arbi);
+    // The workspace open when it is sent (the server writes the open workspace's schema until
+    // the request can name it): a switch meanwhile must not rewrite the next workspace's columns.
+    onMutate: () => ({ workspaceId: openWorkspaceId(arbi) }),
+    onSuccess: (schema, _input, context) => {
+      const workspaceId = context?.workspaceId;
       if (!workspaceId) return;
-      qc.setQueryData(chunkG76ASVVH_cjs.arbiQueryKeys.tagKind(workspaceId, schema.kind), schema);
+      qc.setQueryData(chunkGQAXAZN7_cjs.arbiQueryKeys.tagKind(workspaceId, schema.kind), schema);
       return invalidateTagData(qc, workspaceId);
     }
   });
@@ -477,7 +546,7 @@ function useDocuments(workspaceId, options) {
   const qc = reactQuery.useQueryClient();
   const workspace = workspaceId ?? openWorkspaceId2(arbi) ?? "";
   return reactQuery.useQuery({
-    queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.documents(workspace),
+    queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.documents(workspace),
     queryFn: ({ signal }) => {
       if (openWorkspaceId2(arbi) !== workspace)
         return Promise.reject(new Error("The selected workspace changed."));
@@ -497,7 +566,7 @@ function processingInterval(doc) {
 function useDocument(docId, options) {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   return reactQuery.useQuery({
-    queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.document(docId ?? ""),
+    queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.document(docId ?? ""),
     queryFn: async () => (await arbi.documents.get([docId]))[0] ?? null,
     enabled: (options?.enabled ?? true) && !!docId && arbi.isLoggedIn,
     refetchInterval: options?.pollWhileProcessing ? (query) => processingInterval(query.state.data) : false
@@ -506,7 +575,7 @@ function useDocument(docId, options) {
 function useDocumentsById(docIds, options) {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   return reactQuery.useQuery({
-    queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.documentsById(docIds),
+    queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.documentsById(docIds),
     queryFn: () => arbi.documents.get(docIds),
     enabled: (options?.enabled ?? true) && docIds.length > 0 && arbi.isLoggedIn
   });
@@ -516,7 +585,7 @@ function useSimilarDocuments(options) {
   const arbi = chunkY7S2SQH3_cjs.useArbi();
   const workspace = openWorkspaceId2(arbi) ?? "";
   return reactQuery.useQuery({
-    queryKey: chunkG76ASVVH_cjs.arbiQueryKeys.similarDocuments(workspace, SIMILARITY_THRESHOLD),
+    queryKey: chunkGQAXAZN7_cjs.arbiQueryKeys.similarDocuments(workspace, SIMILARITY_THRESHOLD),
     queryFn: () => arbi.readInWorkspace(
       workspace,
       () => arbi.documents.similar({ threshold: SIMILARITY_THRESHOLD })
@@ -587,20 +656,27 @@ exports.DOCUMENTS_FIRST_PAGE_SIZE = DOCUMENTS_FIRST_PAGE_SIZE;
 exports.DOCUMENTS_PAGE_SIZE = DOCUMENTS_PAGE_SIZE;
 exports.FINISHED_DOCUMENT_STATUSES = FINISHED_DOCUMENT_STATUSES;
 exports.IN_FLIGHT_DOCUMENT_STATUSES = IN_FLIGHT_DOCUMENT_STATUSES;
+exports.QUEUED_WRITE_BLOCKED_MESSAGE = QUEUED_WRITE_BLOCKED_MESSAGE;
+exports.QUEUED_WRITE_RETRY = QUEUED_WRITE_RETRY;
 exports.SIMILARITY_THRESHOLD = SIMILARITY_THRESHOLD;
 exports.adjustTagCounts = adjustTagCounts;
 exports.dropTagFromCachedDocuments = dropTagFromCachedDocuments;
 exports.finishEntityExtraction = finishEntityExtraction;
 exports.forgetDocuments = forgetDocuments;
 exports.getCachedDocuments = getCachedDocuments;
+exports.inWorkspace = inWorkspace;
 exports.invalidateTagData = invalidateTagData;
 exports.invalidateTagTables = invalidateTagTables;
+exports.isBlockedOnWorkspace = isBlockedOnWorkspace;
 exports.isDocumentsLoading = isDocumentsLoading;
 exports.isRowNewer = isRowNewer;
 exports.isStaleTaskUpdate = isStaleTaskUpdate;
+exports.isWorkspaceUnavailable = isWorkspaceUnavailable;
 exports.patchCachedDocument = patchCachedDocument;
 exports.patchDocuments = patchDocuments;
 exports.patchWorkspaceTags = patchWorkspaceTags;
+exports.primeOnArbi = primeOnArbi;
+exports.primeOnClient = primeOnClient;
 exports.refreshDocuments = refreshDocuments;
 exports.replayableTagMutations = replayableTagMutations;
 exports.resolveDocumentStatus = resolveDocumentStatus;
@@ -611,6 +687,7 @@ exports.stopDocumentsLoading = stopDocumentsLoading;
 exports.subscribeDocumentRows = subscribeDocumentRows;
 exports.upsertDocuments = upsertDocuments;
 exports.useArbiWsStore = useArbiWsStore;
+exports.useCapturingWorkspace = useCapturingWorkspace;
 exports.useCreateTag = useCreateTag;
 exports.useDeleteTag = useDeleteTag;
 exports.useDocument = useDocument;
@@ -627,5 +704,5 @@ exports.useSimilarDocuments = useSimilarDocuments;
 exports.useTagKindSchema = useTagKindSchema;
 exports.useUpdateTag = useUpdateTag;
 exports.useUpdateTagKindSchema = useUpdateTagKindSchema;
-//# sourceMappingURL=chunk-LCSUCZVX.cjs.map
-//# sourceMappingURL=chunk-LCSUCZVX.cjs.map
+//# sourceMappingURL=chunk-ZNQPUPX6.cjs.map
+//# sourceMappingURL=chunk-ZNQPUPX6.cjs.map