@arbidocs/react 0.5.111 → 0.5.112

package/dist/document-tools/markup-download.js

@@ -0,0 +1,51 @@
+const SIGNED_LOCKED_REASON = "Signed documents can't be changed \u2014 download the signed file instead";
+function isSignedVersion(doc, version) {
+  const n = version ?? doc.current_version ?? 1;
+  return (doc.versions ?? []).some((v) => v.n === n && v.reason === "signed");
+}
+class MarkupDownloadError extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "MarkupDownloadError";
+  }
+  status;
+}
+function currentHasMarkup(doc) {
+  const n = doc.current_version ?? 1;
+  return (doc.versions ?? []).some((v) => v.n === n && (v.markup_count ?? 0) > 0);
+}
+async function fetchMarkupPdf(client, documentId, version, workspaceExtId) {
+  const { data, response } = await client.GET("/v1/document/{document_ext_id}/markup/pdf", {
+    params: {
+      path: { document_ext_id: documentId },
+      query: {
+        ...version ? { version } : {},
+        ...workspaceExtId ? { workspace_ext_id: workspaceExtId } : {}
+      }
+    },
+    parseAs: "blob"
+  });
+  if (!response.ok || !data) {
+    throw new MarkupDownloadError(
+      response.status === 404 ? "This document has no markup yet" : (
+        // The server refuses a signed version: its PDF takes no more changes.
+        response.status === 409 ? SIGNED_LOCKED_REASON : "The markup could not be downloaded"
+      ),
+      response.status
+    );
+  }
+  const disposition = response.headers.get("content-disposition") ?? "";
+  const utf8 = /filename\*=UTF-8''([^;]+)/i.exec(disposition)?.[1];
+  const plain = /filename="([^"]+)"/i.exec(disposition)?.[1];
+  const fileName = utf8 ? decodeURIComponent(utf8) : plain ?? "markup.pdf";
+  return { blob: data, fileName };
+}
+export {
+  MarkupDownloadError,
+  SIGNED_LOCKED_REASON,
+  currentHasMarkup,
+  fetchMarkupPdf,
+  isSignedVersion
+};
+//# sourceMappingURL=markup-download.js.map

package/dist/document-tools/markup-download.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/document-tools/markup-download.ts"],
+  "sourcesContent": ["/**\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 \u2014 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  workspaceExtId?: string\n): Promise<{ blob: Blob; fileName: string }> {\n  const { data, response } = await client.GET('/v1/document/{document_ext_id}/markup/pdf', {\n    params: {\n      path: { document_ext_id: documentId },\n      query: {\n        ...(version ? { version } : {}),\n        ...(workspaceExtId ? { workspace_ext_id: workspaceExtId } : {}),\n      },\n    },\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"],
+  "mappings": "AAmBO,MAAM,uBACX;AAGK,SAAS,gBAAgB,KAAuB,SAA2B;AAChF,QAAM,IAAI,WAAW,IAAI,mBAAmB;AAC5C,UAAQ,IAAI,YAAY,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,KAAK,EAAE,WAAW,QAAQ;AAC5E;AAEO,MAAM,4BAA4B,MAAM;AAAA,EAC7C,YACE,SACS,QACT;AACA,UAAM,OAAO;AAFJ;AAGT,SAAK,OAAO;AAAA,EACd;AAAA,EAJW;AAKb;AAGO,SAAS,iBAAiB,KAAgC;AAC/D,QAAM,IAAI,IAAI,mBAAmB;AACjC,UAAQ,IAAI,YAAY,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,MAAM,EAAE,gBAAgB,KAAK,CAAC;AAChF;AAGA,eAAsB,eACpB,QACA,YACA,SACA,gBAC2C;AAC3C,QAAM,EAAE,MAAM,SAAS,IAAI,MAAM,OAAO,IAAI,6CAA6C;AAAA,IACvF,QAAQ;AAAA,MACN,MAAM,EAAE,iBAAiB,WAAW;AAAA,MACpC,OAAO;AAAA,QACL,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,QAC7B,GAAI,iBAAiB,EAAE,kBAAkB,eAAe,IAAI,CAAC;AAAA,MAC/D;AAAA,IACF;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AACD,MAAI,CAAC,SAAS,MAAM,CAAC,MAAM;AACzB,UAAM,IAAI;AAAA,MACR,SAAS,WAAW,MAChB;AAAA;AAAA,QAEA,SAAS,WAAW,MAClB,uBACA;AAAA;AAAA,MACN,SAAS;AAAA,IACX;AAAA,EACF;AACA,QAAM,cAAc,SAAS,QAAQ,IAAI,qBAAqB,KAAK;AACnE,QAAM,OAAO,6BAA6B,KAAK,WAAW,IAAI,CAAC;AAC/D,QAAM,QAAQ,sBAAsB,KAAK,WAAW,IAAI,CAAC;AACzD,QAAM,WAAW,OAAO,mBAAmB,IAAI,IAAK,SAAS;AAC7D,SAAO,EAAE,MAAM,MAAc,SAAS;AACxC;",
+  "names": []
+}

package/dist/document-tools/markup-store.js

@@ -0,0 +1,138 @@
+import {
+  AnnotationStoreOfflineError,
+  LAYER_SCHEMA_VERSION,
+  mergeLayers,
+  parseLayer
+} from "../annotations/index.js";
+const MAX_MERGE_ATTEMPTS = 5;
+const KEEPALIVE_LIMIT = 6e4;
+class MarkupStoreError extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "MarkupStoreError";
+  }
+  status;
+}
+const detailOf = (error, fallback) => {
+  const detail = error?.detail;
+  return typeof detail === "string" ? detail : fallback;
+};
+async function call(request) {
+  try {
+    return await request();
+  } catch (e) {
+    if (e instanceof TypeError || typeof navigator !== "undefined" && !navigator.onLine) {
+      throw new AnnotationStoreOfflineError();
+    }
+    throw e;
+  }
+}
+function createMarkupStore({ version, client, onSaved }) {
+  let revision = 0;
+  let count = 0;
+  let canEdit = false;
+  let base = null;
+  const seen = /* @__PURE__ */ new Set();
+  const remember = (layer) => {
+    for (const a of layer.annotations) seen.add(a.id);
+  };
+  const query = version ? { version } : {};
+  async function read(documentId, ifNoneMatch) {
+    const { data, error, response } = await call(
+      () => client.GET("/v1/document/{document_ext_id}/markup", {
+        params: { path: { document_ext_id: documentId }, query },
+        headers: ifNoneMatch === void 0 ? void 0 : { "If-None-Match": `"${ifNoneMatch}"` }
+      })
+    );
+    if (response.status === 304) return null;
+    if (error || !data) {
+      throw new MarkupStoreError(
+        detailOf(error, `The markup could not be loaded (${response.status})`),
+        response.status
+      );
+    }
+    const layer = parseLayer({
+      schema: LAYER_SCHEMA_VERSION,
+      documentId,
+      annotations: data.annotations ?? [],
+      updatedAt: data.updated_at ?? (/* @__PURE__ */ new Date()).toISOString()
+    });
+    return { revision: data.revision ?? 0, layer, canEdit: !!data.can_edit };
+  }
+  function adopt(server) {
+    revision = server.revision;
+    canEdit = server.canEdit;
+    base = server.layer;
+    count = server.layer.annotations.length;
+    remember(server.layer);
+  }
+  async function put(layer, from) {
+    return call(
+      () => client.PUT("/v1/document/{document_ext_id}/markup", {
+        params: { path: { document_ext_id: layer.documentId }, query },
+        headers: { "If-Match": `"${from}"` },
+        body: { annotations: layer.annotations, base_revision: from },
+        // A save started as the page closes must outlive it; browsers cap such bodies at 64 KB.
+        keepalive: JSON.stringify(layer.annotations).length < KEEPALIVE_LIMIT
+      })
+    );
+  }
+  return {
+    snapshot: () => ({ revision, count, canEdit }),
+    canEdit: () => canEdit,
+    async load(documentId) {
+      const server = await read(documentId);
+      if (!server) throw new MarkupStoreError("The markup could not be loaded");
+      adopt(server);
+      return server.layer;
+    },
+    async save(layer) {
+      remember(layer);
+      let mine = layer;
+      for (let attempt = 0; attempt < MAX_MERGE_ATTEMPTS; attempt++) {
+        const { data, error, response } = await put(mine, revision);
+        if (response.ok && data) {
+          revision = data.revision;
+          count = data.count;
+          base = mine;
+          remember(mine);
+          onSaved?.({ revision, count, canEdit });
+          return mine;
+        }
+        if (response.status === 409) {
+          const latest = await read(layer.documentId);
+          if (!latest) throw new MarkupStoreError("The markup could not be re-read");
+          const deleted = new Set(
+            [...seen].filter((id) => !mine.annotations.some((a) => a.id === id))
+          );
+          const merged = mergeLayers({ base, mine, theirs: latest.layer, deleted });
+          revision = latest.revision;
+          canEdit = latest.canEdit;
+          base = latest.layer;
+          remember(latest.layer);
+          mine = merged;
+          continue;
+        }
+        if (response.status === 403) canEdit = false;
+        throw new MarkupStoreError(
+          detailOf(error, `The markup could not be saved (${response.status})`),
+          response.status
+        );
+      }
+      throw new MarkupStoreError("The markup keeps changing; it will be saved on the next edit");
+    },
+    async pull(documentId) {
+      const server = await read(documentId, revision);
+      if (!server || server.revision === revision) return null;
+      adopt(server);
+      return server.layer;
+    }
+  };
+}
+export {
+  MAX_MERGE_ATTEMPTS,
+  MarkupStoreError,
+  createMarkupStore
+};
+//# sourceMappingURL=markup-store.js.map

package/dist/document-tools/markup-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/document-tools/markup-store.ts"],
+  "sourcesContent": ["/**\n * The annotation store for a document version's MARKUP on the server: `GET`/`PUT\n * /v1/document/{id}/markup`. The server keeps the marks as native PDF annotations in an encrypted\n * `{doc}-markup.pdf` next to the version (same document id, the document's own privacy); this store\n * only moves the layer and its revision.\n *\n * Optimistic concurrency: every save names the revision it started from. When someone else saved\n * first the server answers 409; the store then re-reads the latest layer, merges it with ours by\n * annotation id (`mergeLayers`: union, last edit wins per mark, replies unioned, our deletions\n * stay deleted) and saves again. The merged layer is returned so the viewer shows their marks too.\n *\n * Deletions are tracked as tombstones for the session: an id this session has seen that is no\n * longer in the layer it saves was deleted here, and a concurrent edit elsewhere cannot bring it\n * back.\n */\n\nimport {\n  AnnotationStoreOfflineError,\n  LAYER_SCHEMA_VERSION,\n  mergeLayers,\n  parseLayer,\n  type AnnotationLayer,\n  type AnnotationStore,\n} from '../annotations'\nimport type { DocumentToolsClient } from './environment'\n\n/** How many times a save re-reads and merges after a 409 before giving up (each is a real race). */\nexport const MAX_MERGE_ATTEMPTS = 5\n/** Below this many bytes a save uses `keepalive`, so it completes even if the page unloads. */\nconst KEEPALIVE_LIMIT = 60_000\n\nexport interface MarkupSnapshot {\n  revision: number\n  count: number\n  canEdit: boolean\n}\n\nexport interface MarkupStoreOptions {\n  /** The version the markup belongs to; omitted = the document's current version. */\n  version?: number\n  /** The ARBI API client (see `DocumentToolsEnvironment.client`). */\n  client: DocumentToolsClient\n  /** After every successful save: the new revision and how many marks the markup holds. */\n  onSaved?: (snapshot: MarkupSnapshot) => void\n}\n\nexport interface MarkupStore extends AnnotationStore {\n  snapshot(): MarkupSnapshot\n}\n\ninterface ServerLayer {\n  revision: number\n  layer: AnnotationLayer\n  canEdit: boolean\n}\n\nexport class MarkupStoreError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number\n  ) {\n    super(message)\n    this.name = 'MarkupStoreError'\n  }\n}\n\nconst detailOf = (error: unknown, fallback: string) => {\n  const detail = (error as { detail?: unknown } | undefined)?.detail\n  return typeof detail === 'string' ? detail : fallback\n}\n\n/** A request that never reached the server (no network, DNS, CORS) is \"offline\", not a failure. */\nasync function call<T>(request: () => Promise<T>): Promise<T> {\n  try {\n    return await request()\n  } catch (e) {\n    if (e instanceof TypeError || (typeof navigator !== 'undefined' && !navigator.onLine)) {\n      throw new AnnotationStoreOfflineError()\n    }\n    throw e\n  }\n}\n\nexport function createMarkupStore({ version, client, onSaved }: MarkupStoreOptions): MarkupStore {\n  let revision = 0\n  let count = 0\n  let canEdit = false\n  /** The layer as last read from or written to the server: the base of a merge. */\n  let base: AnnotationLayer | null = null\n  /** Every mark id this session has held: one missing from a save was deleted here. */\n  const seen = new Set<string>()\n  const remember = (layer: AnnotationLayer) => {\n    for (const a of layer.annotations) seen.add(a.id)\n  }\n  const query = version ? { version } : {}\n\n  async function read(documentId: string, ifNoneMatch?: number): Promise<ServerLayer | null> {\n    const { data, error, response } = await call(() =>\n      client.GET('/v1/document/{document_ext_id}/markup', {\n        params: { path: { document_ext_id: documentId }, query },\n        headers: ifNoneMatch === undefined ? undefined : { 'If-None-Match': `\"${ifNoneMatch}\"` },\n      })\n    )\n    if (response.status === 304) return null\n    if (error || !data) {\n      throw new MarkupStoreError(\n        detailOf(error, `The markup could not be loaded (${response.status})`),\n        response.status\n      )\n    }\n    const layer = parseLayer({\n      schema: LAYER_SCHEMA_VERSION,\n      documentId,\n      annotations: data.annotations ?? [],\n      updatedAt: data.updated_at ?? new Date().toISOString(),\n    })\n    return { revision: data.revision ?? 0, layer, canEdit: !!data.can_edit }\n  }\n\n  function adopt(server: ServerLayer) {\n    revision = server.revision\n    canEdit = server.canEdit\n    base = server.layer\n    count = server.layer.annotations.length\n    remember(server.layer)\n  }\n\n  async function put(layer: AnnotationLayer, from: number) {\n    return call(() =>\n      client.PUT('/v1/document/{document_ext_id}/markup', {\n        params: { path: { document_ext_id: layer.documentId }, query },\n        headers: { 'If-Match': `\"${from}\"` },\n        body: { annotations: layer.annotations as never, base_revision: from },\n        // A save started as the page closes must outlive it; browsers cap such bodies at 64 KB.\n        keepalive: JSON.stringify(layer.annotations).length < KEEPALIVE_LIMIT,\n      })\n    )\n  }\n\n  return {\n    snapshot: () => ({ revision, count, canEdit }),\n    canEdit: () => canEdit,\n\n    async load(documentId) {\n      const server = await read(documentId)\n      if (!server) throw new MarkupStoreError('The markup could not be loaded')\n      adopt(server)\n      return server.layer\n    },\n\n    async save(layer) {\n      remember(layer)\n      let mine = layer\n      for (let attempt = 0; attempt < MAX_MERGE_ATTEMPTS; attempt++) {\n        const { data, error, response } = await put(mine, revision)\n        if (response.ok && data) {\n          revision = data.revision\n          count = data.count\n          base = mine\n          remember(mine)\n          onSaved?.({ revision, count, canEdit })\n          return mine\n        }\n        if (response.status === 409) {\n          // Someone saved first: their layer, merged with ours, is what we save next.\n          const latest = await read(layer.documentId)\n          if (!latest) throw new MarkupStoreError('The markup could not be re-read')\n          const deleted = new Set(\n            [...seen].filter((id) => !mine.annotations.some((a) => a.id === id))\n          )\n          const merged = mergeLayers({ base, mine, theirs: latest.layer, deleted })\n          revision = latest.revision\n          canEdit = latest.canEdit\n          base = latest.layer\n          remember(latest.layer)\n          mine = merged\n          continue\n        }\n        if (response.status === 403) canEdit = false\n        throw new MarkupStoreError(\n          detailOf(error, `The markup could not be saved (${response.status})`),\n          response.status\n        )\n      }\n      throw new MarkupStoreError('The markup keeps changing; it will be saved on the next edit')\n    },\n\n    async pull(documentId) {\n      const server = await read(documentId, revision)\n      if (!server || server.revision === revision) return null\n      adopt(server)\n      return server.layer\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/document-tools/markup-transfer.js

@@ -0,0 +1,88 @@
+import {
+  LAYER_SCHEMA_VERSION,
+  emptyLayer,
+  mergeLayers,
+  parseLayer
+} from "../annotations/index.js";
+import { createMarkupStore } from "./markup-store.js";
+const LEGACY_LAYER_PREFIX = "arbi:annotations:";
+function storage() {
+  try {
+    return typeof localStorage === "undefined" ? void 0 : localStorage;
+  } catch {
+    return void 0;
+  }
+}
+function readLegacyLayer(documentId) {
+  try {
+    const raw = storage()?.getItem(LEGACY_LAYER_PREFIX + documentId);
+    if (!raw) return null;
+    return parseLayer(JSON.parse(raw));
+  } catch {
+    return null;
+  }
+}
+function forgetLegacyLayer(documentId) {
+  try {
+    storage()?.removeItem(LEGACY_LAYER_PREFIX + documentId);
+  } catch {
+  }
+}
+function marksByVersion(layer, versions) {
+  const sorted = [...versions].sort((a, b) => a.n - b.n);
+  const out = /* @__PURE__ */ new Map();
+  for (const mark of layer.annotations) {
+    const at = Date.parse(mark.createdAt);
+    let target = sorted[0]?.n ?? 1;
+    for (const v of sorted) {
+      const created = v.created_at ? Date.parse(v.created_at) : Number.NaN;
+      if (!Number.isNaN(created) && !Number.isNaN(at) && created <= at) target = v.n;
+    }
+    out.set(target, [...out.get(target) ?? [], mark]);
+  }
+  return out;
+}
+async function addToMarkup(documentId, version, marks, client) {
+  const store = createMarkupStore({ version, client });
+  const current = await store.load(documentId);
+  const incoming = {
+    ...emptyLayer(documentId, (/* @__PURE__ */ new Date()).toISOString()),
+    annotations: marks
+  };
+  const merged = mergeLayers({ base: null, mine: current, theirs: incoming });
+  const added = merged.annotations.length - current.annotations.length;
+  if (added > 0) await store.save(parseLayer({ ...merged, schema: LAYER_SCHEMA_VERSION }));
+  return added;
+}
+async function migrateLegacyLayer(documentId, layer, versions, currentVersion, client) {
+  let added = 0;
+  for (const [n, marks] of marksByVersion(layer, versions.length ? versions : [{ n: 1 }])) {
+    added += await addToMarkup(documentId, n === currentVersion ? void 0 : n, marks, client);
+  }
+  forgetLegacyLayer(documentId);
+  return added;
+}
+async function openThreadsOf(documentId, version, client) {
+  const layer = await createMarkupStore({ version, client }).load(documentId);
+  return layer.annotations.filter((a) => a.kind === "comment" && !a.resolved);
+}
+async function copyOpenThreads(documentId, fromVersion, client) {
+  const threads = await openThreadsOf(documentId, fromVersion, client);
+  if (!threads.length) return 0;
+  return addToMarkup(documentId, void 0, threads, client);
+}
+function versionsWithMarkup(versions) {
+  return (versions ?? []).filter((v) => (v.markup_count ?? 0) > 0);
+}
+export {
+  LEGACY_LAYER_PREFIX,
+  addToMarkup,
+  copyOpenThreads,
+  forgetLegacyLayer,
+  marksByVersion,
+  migrateLegacyLayer,
+  openThreadsOf,
+  readLegacyLayer,
+  versionsWithMarkup
+};
+//# sourceMappingURL=markup-transfer.js.map

package/dist/document-tools/markup-transfer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/document-tools/markup-transfer.ts"],
+  "sourcesContent": ["/**\n * Moving marks INTO a version's markup without the viewer: the one-time migration of layers kept in\n * this browser before markup lived on the server, and \"copy open comments\" from an older version's\n * markup onto the current one (a new version \u2014 signed, synced from Drive, saved from Word \u2014 starts\n * with an empty markup; redactions never carry over).\n *\n * Both are unions by annotation id, so running them twice adds nothing twice.\n */\n\nimport {\n  LAYER_SCHEMA_VERSION,\n  emptyLayer,\n  mergeLayers,\n  parseLayer,\n  type Annotation,\n  type AnnotationLayer,\n} from '../annotations'\nimport type { DocumentToolsClient } from './environment'\nimport { createMarkupStore } from './markup-store'\n\nexport const LEGACY_LAYER_PREFIX = 'arbi:annotations:'\n\nexport interface VersionInfo {\n  n: number\n  created_at?: string | null\n  markup_count?: number | null\n}\n\nfunction storage(): Storage | undefined {\n  try {\n    return typeof localStorage === 'undefined' ? undefined : localStorage\n  } catch {\n    return undefined\n  }\n}\n\n/** The layer this browser kept for a document before markup moved to the server, if any. */\nexport function readLegacyLayer(documentId: string): AnnotationLayer | null {\n  try {\n    const raw = storage()?.getItem(LEGACY_LAYER_PREFIX + documentId)\n    if (!raw) return null\n    return parseLayer(JSON.parse(raw))\n  } catch {\n    return null // unreadable: nothing worth migrating\n  }\n}\n\nexport function forgetLegacyLayer(documentId: string): void {\n  try {\n    storage()?.removeItem(LEGACY_LAYER_PREFIX + documentId)\n  } catch {\n    // storage blocked: nothing to forget\n  }\n}\n\n/**\n * Which version each legacy mark belongs to: the version that was current when it was made. A\n * document's id is the id of its first version (older layers were made on it); a layer made after\n * the versions moved inside the document was made on whatever version was then current.\n */\nexport function marksByVersion(\n  layer: AnnotationLayer,\n  versions: VersionInfo[]\n): Map<number, Annotation[]> {\n  const sorted = [...versions].sort((a, b) => a.n - b.n)\n  const out = new Map<number, Annotation[]>()\n  for (const mark of layer.annotations) {\n    const at = Date.parse(mark.createdAt)\n    let target = sorted[0]?.n ?? 1\n    for (const v of sorted) {\n      const created = v.created_at ? Date.parse(v.created_at) : Number.NaN\n      if (!Number.isNaN(created) && !Number.isNaN(at) && created <= at) target = v.n\n    }\n    out.set(target, [...(out.get(target) ?? []), mark])\n  }\n  return out\n}\n\n/** Add marks to one version's markup (union by id); returns how many were new. */\nexport async function addToMarkup(\n  documentId: string,\n  version: number | undefined,\n  marks: Annotation[],\n  client: DocumentToolsClient\n): Promise<number> {\n  const store = createMarkupStore({ version, client })\n  const current = await store.load(documentId)\n  const incoming: AnnotationLayer = {\n    ...emptyLayer(documentId, new Date().toISOString()),\n    annotations: marks,\n  }\n  // Theirs (the server) wins any tie: a mark already in the markup is never overwritten by an\n  // older browser copy of it.\n  const merged = mergeLayers({ base: null, mine: current, theirs: incoming })\n  const added = merged.annotations.length - current.annotations.length\n  if (added > 0) await store.save(parseLayer({ ...merged, schema: LAYER_SCHEMA_VERSION }))\n  return added\n}\n\n/**\n * Migrate this browser's layer for a document into its markup, version by version, then forget\n * the browser copy. Throws (and keeps the browser copy) if any version could not be saved.\n */\nexport async function migrateLegacyLayer(\n  documentId: string,\n  layer: AnnotationLayer,\n  versions: VersionInfo[],\n  currentVersion: number,\n  client: DocumentToolsClient\n): Promise<number> {\n  let added = 0\n  for (const [n, marks] of marksByVersion(layer, versions.length ? versions : [{ n: 1 }])) {\n    added += await addToMarkup(documentId, n === currentVersion ? undefined : n, marks, client)\n  }\n  forgetLegacyLayer(documentId)\n  return added\n}\n\n/** The unresolved comment threads (with replies) of a version's markup. */\nexport async function openThreadsOf(\n  documentId: string,\n  version: number,\n  client: DocumentToolsClient\n): Promise<Annotation[]> {\n  const layer = await createMarkupStore({ version, client }).load(documentId)\n  return layer.annotations.filter((a) => a.kind === 'comment' && !a.resolved)\n}\n\n/** Copy the open comment threads of an older version onto the current version's markup. */\nexport async function copyOpenThreads(\n  documentId: string,\n  fromVersion: number,\n  client: DocumentToolsClient\n): Promise<number> {\n  const threads = await openThreadsOf(documentId, fromVersion, client)\n  if (!threads.length) return 0\n  return addToMarkup(documentId, undefined, threads, client)\n}\n\n/** Version entries of a document as the API returns them (`DocResponse.versions`). */\nexport function versionsWithMarkup(versions: VersionInfo[] | null | undefined): VersionInfo[] {\n  return (versions ?? []).filter((v) => (v.markup_count ?? 0) > 0)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/document-tools/production.js

@@ -0,0 +1,147 @@
+import { DocumentFetchError, fetchDocumentFile, fetchDocumentPdf } from "./document-pdf.js";
+const PRODUCTIONS_FOLDER = "Productions";
+const extensionOf = (fileName) => {
+  const name = (fileName ?? "").toLowerCase();
+  const dot = name.lastIndexOf(".");
+  return dot < 0 ? "" : name.slice(dot + 1);
+};
+const NO_RENDITION_EXTENSIONS = new Set(
+  [
+    // images
+    "jpg jpeg png gif bmp tiff tif webp heic",
+    // video and audio
+    "mp4 mpeg mpg webm mov avi mkv mp3 wav m4a aac ogg flac",
+    // archives, binaries, design files
+    "zip rar 7z tar gz exe bin dmg iso apk msi dll so psd ai sketch"
+  ].join(" ").split(" ")
+);
+const isPdfDocument = (doc) => /pdf/i.test(doc.file_type ?? "") || extensionOf(doc.file_name) === "pdf";
+const hasNoRendition = (doc) => !isPdfDocument(doc) && NO_RENDITION_EXTENSIONS.has(extensionOf(doc.file_name));
+const productionDocumentName = (doc) => doc.doc_metadata?.title || doc.file_name || doc.external_id;
+const isPdfBytes = (bytes) => bytes.length > 4 && String.fromCharCode(...bytes.subarray(0, 5)) === "%PDF-";
+async function fetchProductionPdf(client, doc) {
+  const pdf = isPdfDocument(doc);
+  let blob;
+  try {
+    blob = await (pdf ? fetchDocumentFile : fetchDocumentPdf)(client, doc.external_id);
+  } catch (e) {
+    if (!pdf && e instanceof DocumentFetchError) return null;
+    throw e;
+  }
+  const bytes = new Uint8Array(await blob.arrayBuffer());
+  return pdf || isPdfBytes(bytes) ? bytes : null;
+}
+const safeName = (name) => name.replace(/[\\/:*?"<>|]+/g, "_").trim();
+function productionTitle(firstLabel, lastLabel) {
+  return safeName(`Production ${firstLabel}-${lastLabel}`);
+}
+function productionFolder(title, merged) {
+  return merged ? PRODUCTIONS_FOLDER : `${PRODUCTIONS_FOLDER}/${title}`;
+}
+function productionFileName(file, title) {
+  if (!file.firstLabel) return `${title} index.pdf`;
+  return `${file.name.replace(/\.pdf$/i, "")} (${file.firstLabel}-${file.lastLabel}).pdf`;
+}
+const csvCell = (value) => `"${String(value).replace(/"/g, '""')}"`;
+function productionIndexCsv(index) {
+  const rows = index.map(
+    (e) => [e.documentId, e.name, e.file, e.pages, e.firstLabel, e.lastLabel].map(csvCell).join(",")
+  );
+  return ["document_id,name,file,pages,first_label,last_label", ...rows].join("\n");
+}
+async function saveProductionFiles(upload, files, folder) {
+  const ids = [];
+  for (const file of files) {
+    const query = {
+      derived_from: file.sources.map((doc) => doc.external_id),
+      derived_role: "production",
+      shared: file.sources.every((doc) => doc.shared),
+      folder
+    };
+    const workspaces = new Set(file.sources.map((doc) => doc.workspace_ext_id).filter(Boolean));
+    if (workspaces.size === 1) query.workspace_ext_id = [...workspaces][0];
+    const response = await upload({
+      file: new File([file.bytes], file.name, { type: "application/pdf" }),
+      query
+    });
+    ids.push(...response?.doc_ext_ids ?? []);
+  }
+  return ids;
+}
+async function buildProduction(client, documents, choices, options) {
+  const byId = new Map(documents.map((doc) => [doc.external_id, doc]));
+  const included = [];
+  const noRendition = [];
+  const items = [];
+  for (const doc of choices.order.flatMap((id) => byId.get(id) ?? [])) {
+    const bytes = await fetchProductionPdf(client, doc);
+    if (!bytes) {
+      noRendition.push(doc);
+      continue;
+    }
+    included.push(doc);
+    items.push({
+      name: productionDocumentName(doc),
+      documentId: doc.external_id,
+      bytes,
+      qrUrl: options.documentUrl(doc.external_id)
+    });
+  }
+  if (items.length === 0) {
+    throw new Error("None of these documents has a PDF version to number yet.");
+  }
+  const { buildBundle } = await import("../annotations/freeze/bundle.js");
+  const result = await buildBundle(items, {
+    layout: choices.layout,
+    bates: {
+      prefix: choices.prefix,
+      start: choices.start,
+      digits: choices.digits,
+      corner: choices.corner
+    },
+    qr: choices.qr,
+    // The QR code sits in the bottom corner the label is not in.
+    qrCorner: choices.corner.endsWith("left") ? "bottom-right" : "bottom-left",
+    indexPage: choices.indexPage,
+    author: options.author,
+    onProgress: options.onProgress
+  });
+  const title = productionTitle(
+    result.index[0].firstLabel,
+    result.index[result.index.length - 1].lastLabel
+  );
+  const merged = choices.layout === "merged";
+  const files = merged ? [{ ...result.files[0], name: `${title}.pdf` }] : result.files;
+  const sourceOf = new Map(result.index.map((e) => [e.file, byId.get(e.documentId)]));
+  const uploads = files.map((file) => ({
+    name: merged ? file.name : productionFileName(file, title),
+    bytes: file.bytes,
+    // The merged file (and a separate index) is made from every document; each per-document
+    // file from its own.
+    sources: merged || !sourceOf.has(file.name) ? included : [sourceOf.get(file.name)]
+  }));
+  return {
+    title,
+    merged,
+    files,
+    index: result.index,
+    included,
+    noRendition,
+    uploads,
+    folder: productionFolder(title, merged)
+  };
+}
+export {
+  PRODUCTIONS_FOLDER,
+  buildProduction,
+  fetchProductionPdf,
+  hasNoRendition,
+  isPdfDocument,
+  productionDocumentName,
+  productionFileName,
+  productionFolder,
+  productionIndexCsv,
+  productionTitle,
+  saveProductionFiles
+};
+//# sourceMappingURL=production.js.map

package/dist/document-tools/production.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/document-tools/production.ts"],
+  "sourcesContent": ["/**\n * Production sets: number the selected documents with Bates labels (optionally a QR code back to\n * each document and an index page) and save the result back to the workspace. The dialog is\n * `ProductionSetDialog` in `@arbidocs/blocks/document-tools`; this is its data side.\n *\n * A PDF is numbered as stored (`/download`). Any other document is numbered through its PDF\n * rendition (`/view`, what the viewer shows for a Word or text file); one without a rendition is\n * left out. Saved results are new documents derived from their sources (role `production`) in a\n * Productions folder, shared with the workspace only if every source is. The originals never\n * change.\n *\n * pdf-lib (the numbering) is loaded only when a production is built, so importing this module\n * stays as light as the rest of the document tools.\n */\n\nimport type { components } from '@arbidocs/client'\nimport type { ProductionChoices } from '../annotations/ProductionDialog'\nimport type { BundleFile, BundleIndexEntry, BundleItem } from '../annotations/freeze/bundle'\nimport { DocumentFetchError, fetchDocumentFile, fetchDocumentPdf } from './document-pdf'\nimport type {\n  DocumentToolsClient,\n  DocumentToolsEnvironment,\n  DocumentUploadQuery,\n} from './environment'\n\n/** The fields of a document record (`DocResponse`) a production uses. */\nexport type ProductionSource = Pick<\n  components['schemas']['DocResponse'],\n  'external_id' | 'file_name' | 'file_type' | 'shared'\n> & {\n  doc_metadata?: { title?: string | null } | null\n  /** The document's workspace: the produced files are saved there, named on the upload. */\n  workspace_ext_id?: string | null\n}\n\nexport const PRODUCTIONS_FOLDER = 'Productions'\n\nconst extensionOf = (fileName: string | null | undefined) => {\n  const name = (fileName ?? '').toLowerCase()\n  const dot = name.lastIndexOf('.')\n  return dot < 0 ? '' : name.slice(dot + 1)\n}\n\n/** Media, archives and design files: no PDF version to number. */\nconst NO_RENDITION_EXTENSIONS = new Set(\n  [\n    // images\n    'jpg jpeg png gif bmp tiff tif webp heic',\n    // video and audio\n    'mp4 mpeg mpg webm mov avi mkv mp3 wav m4a aac ogg flac',\n    // archives, binaries, design files\n    'zip rar 7z tar gz exe bin dmg iso apk msi dll so psd ai sketch',\n  ]\n    .join(' ')\n    .split(' ')\n)\n\nexport const isPdfDocument = (doc: ProductionSource) =>\n  /pdf/i.test(doc.file_type ?? '') || extensionOf(doc.file_name) === 'pdf'\n\n/** True for a document with no PDF version to number (media, archives and the like). */\nexport const hasNoRendition = (doc: ProductionSource) =>\n  !isPdfDocument(doc) && NO_RENDITION_EXTENSIONS.has(extensionOf(doc.file_name))\n\n/** The name a document goes by in the dialog and the index: its title, else its file name. */\nexport const productionDocumentName = (doc: ProductionSource) =>\n  doc.doc_metadata?.title || doc.file_name || doc.external_id\n\nconst isPdfBytes = (bytes: Uint8Array) =>\n  bytes.length > 4 && String.fromCharCode(...bytes.subarray(0, 5)) === '%PDF-'\n\n/**\n * The PDF to number for `doc`: the file itself, or the PDF version of anything else. `null` when a\n * non-PDF has no PDF version (yet), so it is left out; a PDF that cannot be downloaded throws.\n */\nexport async function fetchProductionPdf(\n  client: DocumentToolsClient,\n  doc: ProductionSource\n): Promise<Uint8Array | null> {\n  const pdf = isPdfDocument(doc)\n  let blob: Blob\n  try {\n    blob = await (pdf ? fetchDocumentFile : fetchDocumentPdf)(client, doc.external_id)\n  } catch (e) {\n    if (!pdf && e instanceof DocumentFetchError) return null\n    throw e\n  }\n  const bytes = new Uint8Array(await blob.arrayBuffer())\n  return pdf || isPdfBytes(bytes) ? bytes : null\n}\n\nconst safeName = (name: string) => name.replace(/[\\\\/:*?\"<>|]+/g, '_').trim()\n\n/** \"Production ACME-000001-ACME-000042\": names the files and folder of one production. */\nexport function productionTitle(firstLabel: string, lastLabel: string): string {\n  return safeName(`Production ${firstLabel}-${lastLabel}`)\n}\n\n/** Where a production is saved: the Productions folder, or a folder of its own per document. */\nexport function productionFolder(title: string, merged: boolean): string {\n  return merged ? PRODUCTIONS_FOLDER : `${PRODUCTIONS_FOLDER}/${title}`\n}\n\n/** In the workspace a per-document file says which range it holds, beside its original. */\nexport function productionFileName(file: BundleFile, title: string): string {\n  if (!file.firstLabel) return `${title} index.pdf`\n  return `${file.name.replace(/\\.pdf$/i, '')} (${file.firstLabel}-${file.lastLabel}).pdf`\n}\n\nconst csvCell = (value: string | number) => `\"${String(value).replace(/\"/g, '\"\"')}\"`\n\n/** The `index.csv` of a per-document production: every document with its file and range. */\nexport function productionIndexCsv(index: readonly BundleIndexEntry[]): string {\n  const rows = index.map((e) =>\n    [e.documentId, e.name, e.file, e.pages, e.firstLabel, e.lastLabel].map(csvCell).join(',')\n  )\n  return ['document_id,name,file,pages,first_label,last_label', ...rows].join('\\n')\n}\n\nexport interface ProductionUpload {\n  name: string\n  bytes: Uint8Array\n  /** The documents this file was made from. */\n  sources: ProductionSource[]\n}\n\n/** Save each file as a new workspace document derived from its sources; returns the new ids. */\nexport async function saveProductionFiles(\n  upload: NonNullable<DocumentToolsEnvironment['uploadDocument']>,\n  files: readonly ProductionUpload[],\n  folder: string\n): Promise<string[]> {\n  const ids: string[] = []\n  for (const file of files) {\n    const query: DocumentUploadQuery = {\n      derived_from: file.sources.map((doc) => doc.external_id),\n      derived_role: 'production',\n      shared: file.sources.every((doc) => doc.shared),\n      folder,\n    }\n    // Saved in the sources' workspace, named on the upload (never whichever one is open now).\n    const workspaces = new Set(file.sources.map((doc) => doc.workspace_ext_id).filter(Boolean))\n    if (workspaces.size === 1) query.workspace_ext_id = [...workspaces][0]\n    const response = await upload({\n      file: new File([file.bytes as BlobPart], file.name, { type: 'application/pdf' }),\n      query,\n    })\n    ids.push(...(response?.doc_ext_ids ?? []))\n  }\n  return ids\n}\n\nexport interface BuildProductionOptions {\n  /** The link a document's QR code opens (the document in the host app). */\n  documentUrl: (documentId: string) => string\n  /** Who produced the set; recorded in a merged file's metadata. */\n  author?: string\n  onProgress?: (done: number, total: number) => void\n}\n\nexport interface BuiltProduction {\n  title: string\n  merged: boolean\n  /** The numbered files: one merged PDF (named after its range), or one per document (+ index). */\n  files: BundleFile[]\n  index: BundleIndexEntry[]\n  /** The documents numbered, in order. */\n  included: ProductionSource[]\n  /** Documents left out because they have no PDF version yet. */\n  noRendition: ProductionSource[]\n  /** The files as they are saved to the workspace, each with the documents it was made from. */\n  uploads: ProductionUpload[]\n  folder: string\n}\n\n/**\n * Fetch each document's PDF (in `choices.order`) and number the set. Throws when none of the\n * documents has a PDF version, or when a PDF cannot be fetched.\n */\nexport async function buildProduction(\n  client: DocumentToolsClient,\n  documents: readonly ProductionSource[],\n  choices: ProductionChoices,\n  options: BuildProductionOptions\n): Promise<BuiltProduction> {\n  const byId = new Map(documents.map((doc) => [doc.external_id, doc]))\n  const included: ProductionSource[] = []\n  const noRendition: ProductionSource[] = []\n  const items: BundleItem[] = []\n  for (const doc of choices.order.flatMap((id) => byId.get(id) ?? [])) {\n    const bytes = await fetchProductionPdf(client, doc)\n    if (!bytes) {\n      noRendition.push(doc)\n      continue\n    }\n    included.push(doc)\n    items.push({\n      name: productionDocumentName(doc),\n      documentId: doc.external_id,\n      bytes,\n      qrUrl: options.documentUrl(doc.external_id),\n    })\n  }\n  if (items.length === 0) {\n    throw new Error('None of these documents has a PDF version to number yet.')\n  }\n\n  const { buildBundle } = await import('../annotations/freeze/bundle')\n  const result = await buildBundle(items, {\n    layout: choices.layout,\n    bates: {\n      prefix: choices.prefix,\n      start: choices.start,\n      digits: choices.digits,\n      corner: choices.corner,\n    },\n    qr: choices.qr,\n    // The QR code sits in the bottom corner the label is not in.\n    qrCorner: choices.corner.endsWith('left') ? 'bottom-right' : 'bottom-left',\n    indexPage: choices.indexPage,\n    author: options.author,\n    onProgress: options.onProgress,\n  })\n\n  const title = productionTitle(\n    result.index[0].firstLabel,\n    result.index[result.index.length - 1].lastLabel\n  )\n  const merged = choices.layout === 'merged'\n  // A merged file is named after its range; per-document files keep their document names.\n  const files = merged ? [{ ...result.files[0], name: `${title}.pdf` }] : result.files\n  const sourceOf = new Map(result.index.map((e) => [e.file, byId.get(e.documentId)!]))\n  const uploads = files.map((file) => ({\n    name: merged ? file.name : productionFileName(file, title),\n    bytes: file.bytes,\n    // The merged file (and a separate index) is made from every document; each per-document\n    // file from its own.\n    sources: merged || !sourceOf.has(file.name) ? included : [sourceOf.get(file.name)!],\n  }))\n  return {\n    title,\n    merged,\n    files,\n    index: result.index,\n    included,\n    noRendition,\n    uploads,\n    folder: productionFolder(title, merged),\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/document-tools/saved-signature.js

@@ -0,0 +1,90 @@
+import {
+  getUserEncryptionKeypair,
+  initSodium,
+  sealedBoxDecrypt,
+  sealedBoxEncrypt
+} from "@arbidocs/client";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useDocumentTools } from "./environment.js";
+import { arbiQueryKeys } from "../query-keys.js";
+const INFORMAL_SIGNATURE_NOTE = "Your saved signature or initials are placed as an image on the document.";
+async function keypair(source = getUserEncryptionKeypair) {
+  await initSodium();
+  const pair = await source();
+  if (!pair) throw new Error("Sign in again to use your saved signature.");
+  return pair;
+}
+function detail(error, fallback) {
+  const d = error?.detail;
+  return typeof d === "string" ? d : fallback;
+}
+async function fetchSavedSignature(client, source) {
+  const { data, error } = await client.GET("/v1/user/signature");
+  if (!data) throw new Error(detail(error, "Your saved signature could not be read"));
+  if (!data.sealed) return null;
+  const pair = await keypair(source);
+  const json = new TextDecoder().decode(sealedBoxDecrypt(data.sealed, pair.secretKey));
+  return JSON.parse(json);
+}
+async function storeSavedSignature(client, signature, source) {
+  const pair = await keypair(source);
+  const sealed = sealedBoxEncrypt(
+    Uint8Array.from(new TextEncoder().encode(JSON.stringify(signature))),
+    pair.publicKey
+  );
+  const { error, response } = await client.PUT("/v1/user/signature", { body: { sealed } });
+  if (!response.ok) throw new Error(detail(error, "Your signature could not be saved"));
+}
+async function deleteSavedSignature(client) {
+  const { error, response } = await client.DELETE("/v1/user/signature");
+  if (!response.ok) throw new Error(detail(error, "Your saved signature could not be deleted"));
+}
+function useSavedSignature(enabled = true) {
+  const { client } = useDocumentTools();
+  return useQuery({
+    queryKey: arbiQueryKeys.savedSignature(),
+    queryFn: () => fetchSavedSignature(client),
+    enabled,
+    staleTime: 6e4,
+    retry: false
+  });
+}
+function useStoreSavedSignature() {
+  const { client } = useDocumentTools();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (signature) => storeSavedSignature(client, signature),
+    onSuccess: (_, signature) => queryClient.setQueryData(arbiQueryKeys.savedSignature(), signature)
+  });
+}
+function useDeleteSavedSignature() {
+  const { client } = useDocumentTools();
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: () => deleteSavedSignature(client),
+    onSuccess: () => queryClient.setQueryData(arbiQueryKeys.savedSignature(), null)
+  });
+}
+function pngBytes(base64) {
+  const raw = atob(base64);
+  const out = new Uint8Array(raw.length);
+  for (let i = 0; i < raw.length; i++) out[i] = raw.charCodeAt(i);
+  return out;
+}
+function pngSize(base64) {
+  const bytes = pngBytes(base64.slice(0, 64));
+  const view = new DataView(bytes.buffer);
+  return { width: view.getUint32(16), height: view.getUint32(20) };
+}
+export {
+  INFORMAL_SIGNATURE_NOTE,
+  deleteSavedSignature,
+  fetchSavedSignature,
+  pngBytes,
+  pngSize,
+  storeSavedSignature,
+  useDeleteSavedSignature,
+  useSavedSignature,
+  useStoreSavedSignature
+};
+//# sourceMappingURL=saved-signature.js.map

package/dist/document-tools/saved-signature.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/document-tools/saved-signature.ts"],
+  "sourcesContent": ["/**\n * A signature saved to one's account, for informal use: inserted into a Word document as a picture,\n * or placed on a PDF as a stamp, and offered again the next time one adopts a signature to sign.\n *\n * It is sealed HERE, in the browser, to the user's own X25519 key (a SealedBox to the public half of\n * the keypair their signing key derives): the server keeps the sealed bytes (`/v1/user/signature`)\n * and can never read them. Only with the user's explicit consent (\"Save to my account for future\n * use\"); Delete removes it from the account completely. A typed mark is saved as its picture too,\n * so every use has an image to place.\n */\n\nimport {\n  getUserEncryptionKeypair,\n  initSodium,\n  sealedBoxDecrypt,\n  sealedBoxEncrypt,\n  type KeyPair,\n} from '@arbidocs/client'\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport { useDocumentTools, type DocumentToolsClient } from './environment'\nimport { arbiQueryKeys } from '../query-keys'\n\nexport interface SavedSignature {\n  name: string\n  initials: string\n  /** How the signature was adopted (a typed one is saved as its picture as well). */\n  style: 'typed' | 'drawn' | 'uploaded'\n  initials_style: 'typed' | 'drawn'\n  /** Base64 PNGs, transparent around the ink. */\n  signature_png: string\n  initials_png: string\n}\n\n/** The one line shown wherever a saved signature is placed by hand. */\nexport const INFORMAL_SIGNATURE_NOTE =\n  'Your saved signature or initials are placed as an image on the document.'\n\n/** The user's own keypair (the session's); a host or a test may pass another. */\nexport type KeypairSource = () => Promise<KeyPair | null>\n\nasync function keypair(source: KeypairSource = getUserEncryptionKeypair): Promise<KeyPair> {\n  await initSodium()\n  const pair = await source()\n  if (!pair) throw new Error('Sign in again to use your saved signature.')\n  return pair\n}\n\nfunction detail(error: unknown, fallback: string): string {\n  const d = (error as { detail?: unknown } | undefined)?.detail\n  return typeof d === 'string' ? d : fallback\n}\n\n/** The saved signature, opened with the user's own key; null when none is saved. */\nexport async function fetchSavedSignature(\n  client: DocumentToolsClient,\n  source?: KeypairSource\n): Promise<SavedSignature | null> {\n  const { data, error } = await client.GET('/v1/user/signature')\n  if (!data) throw new Error(detail(error, 'Your saved signature could not be read'))\n  if (!data.sealed) return null\n  const pair = await keypair(source)\n  const json = new TextDecoder().decode(sealedBoxDecrypt(data.sealed, pair.secretKey))\n  return JSON.parse(json) as SavedSignature\n}\n\n/** Seal it to the user's own key and save it (replacing any saved before). */\nexport async function storeSavedSignature(\n  client: DocumentToolsClient,\n  signature: SavedSignature,\n  source?: KeypairSource\n): Promise<void> {\n  const pair = await keypair(source)\n  const sealed = sealedBoxEncrypt(\n    Uint8Array.from(new TextEncoder().encode(JSON.stringify(signature))),\n    pair.publicKey\n  )\n  const { error, response } = await client.PUT('/v1/user/signature', { body: { sealed } })\n  if (!response.ok) throw new Error(detail(error, 'Your signature could not be saved'))\n}\n\n/** Remove it from the account completely. */\nexport async function deleteSavedSignature(client: DocumentToolsClient): Promise<void> {\n  const { error, response } = await client.DELETE('/v1/user/signature')\n  if (!response.ok) throw new Error(detail(error, 'Your saved signature could not be deleted'))\n}\n\nexport function useSavedSignature(enabled = true) {\n  const { client } = useDocumentTools()\n  return useQuery({\n    queryKey: arbiQueryKeys.savedSignature(),\n    queryFn: () => fetchSavedSignature(client),\n    enabled,\n    staleTime: 60_000,\n    retry: false,\n  })\n}\n\nexport function useStoreSavedSignature() {\n  const { client } = useDocumentTools()\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: (signature: SavedSignature) => storeSavedSignature(client, signature),\n    onSuccess: (_, signature) =>\n      queryClient.setQueryData(arbiQueryKeys.savedSignature(), signature),\n  })\n}\n\nexport function useDeleteSavedSignature() {\n  const { client } = useDocumentTools()\n  const queryClient = useQueryClient()\n  return useMutation({\n    mutationFn: () => deleteSavedSignature(client),\n    onSuccess: () => queryClient.setQueryData(arbiQueryKeys.savedSignature(), null),\n  })\n}\n\n/** Base64 PNG bytes, decoded (for an inline picture or an upload). */\nexport function pngBytes(base64: string): Uint8Array {\n  const raw = atob(base64)\n  const out = new Uint8Array(raw.length)\n  for (let i = 0; i < raw.length; i++) out[i] = raw.charCodeAt(i)\n  return out\n}\n\n/** A PNG's pixel size, read from its header (IHDR). */\nexport function pngSize(base64: string): { width: number; height: number } {\n  const bytes = pngBytes(base64.slice(0, 64))\n  const view = new DataView(bytes.buffer)\n  return { width: view.getUint32(16), height: view.getUint32(20) }\n}\n"],
+  "mappings": "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",
+  "names": []
+}