@ai-matrx/office 0.8.17 → 0.8.18

package/CHANGELOG.md

@@ -1,9 +1,18 @@
 # Changelog
 
+## 0.8.18
+### C7a restore hash, stale checkpoints, collaborator colours
+
+- **Docs co-editing: one canonical state hash, before and after Univer loads it (C7a follow-up).** `canonicalDocsSnapshot` now first brings a snapshot to the form every seat holds after loading it (`asLoadedDocsSnapshot`: deterministic ids, `sanitizeUniverDocSnapshot`, Univer's own `DocumentDataModel` defaults) and drops `sectionId` like `paragraphId`. A History restore of a document not open in this tab hashed the raw row while every open seat hashed what Univer held, so both seats refused it (`checkpoint_hash at rev 10`) and kept the old text; now the two agree (corpus + real History versions, through a real Univer load and save). Docs rooms: a keystroke the session refused while reloading puts the seat back on the room's document instead of staying on that seat alone; collaborator colours by join order (`claimCollaboratorColor` from data). `sanitizeUniverDocSnapshot` takes `{ quiet }`. Consumer action: none (no live room predates this hash; every existing room is on a trashed test document).
+
 ## 0.8.17
 
-UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
-Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/office/src`.
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff f8e2208b71 1241f62146 -- apps/shared/office/src`
+
+Changed shipped source files (1):
+- `apps/shared/office/src/univer/collab/sheets-ot/univer-port.ts`
 
 ## 0.8.16
 
@@ -43,7 +52,7 @@ Changed shipped source files (8):
 
 ### Unreleased
 
-- **Sheets co-editing on the ordered log (C6).** `@ai-matrx/office/univer/collab` adds the Sheets room: `openSheetsOtRoom` (the C2 session over the C5a/C5b group transform, saves at a quiet point with a matching hash, restore through `collab_replace`, undo items rebased over every remote op), `univerSheetsOtPort` (capture: onlyLocal/fromCollab filtered, grouped by outermost command with a try/finally depth guard on both execute paths, params allowlist, completeCellContent, exact merge removals, style objects never ids, whole-style overrides restated as merges, annotateFormulas, inverses from the applied params against a pre-state copy; a barrier or unknown id is `not_shared` and rolls the seat back), `sheetsStateHash` / `canonicalSheet` (merges as a set, defined names by id; the transform fuzz now hashes through it), and `startWorkbookOtRoom` / `workbookUsesOrderedRoom` (the `udt_workbook_snapshots` store, the C1 doors, presence). A remote row/column insert, remove or move carries this seat's selection along and never leaves it past the sheet's edge (the port's `selections` option; a stale whole-row selection after a peer's column delete crashed the editor in the live run). Flip is per room exactly like Docs. Consumer action: matrx-frontend's WorkbookEditor opens it when the workbook's room exists or `collab.ot_rooms` says so (shipped with this release); every other consumer: none.
+- **Sheets co-editing on the ordered log (C6).** `@ai-matrx/office/univer/collab` adds the Sheets room: `openSheetsOtRoom` (the C2 session over the C5a/C5b group transform, saves at a quiet point with a matching hash, restore through `collab_replace`, undo items rebased over every remote op), `univerSheetsOtPort` (capture: onlyLocal/fromCollab filtered, grouped by outermost command with a try/finally depth guard on both execute paths, params allowlist, completeCellContent, exact merge removals, style objects never ids, whole-style overrides restated as merges, annotateFormulas, inverses from the applied params against a pre-state copy; a barrier or unknown id is `not_shared` and rolls the seat back), `sheetsStateHash` / `canonicalSheet` (merges as a set, defined names by id; the transform fuzz now hashes through it), and `startWorkbookOtRoom` / `workbookUsesOrderedRoom` (the `udt_workbook_snapshots` store, the C1 doors, presence). A remote row/column insert, remove or move carries this seat's selection along and never leaves it past the sheet's edge (the port's `selections` option; a stale whole-row selection after a peer's column delete crashed the editor in the live run). Remote applies run with `{ fromCollab: true }` only (not `onlyLocal`): Univer's formula engine skips onlyLocal value writes, so a peer's formula showed blank on every other seat in the live run. Flip is per room exactly like Docs. Consumer action: matrx-frontend's WorkbookEditor opens it when the workbook's room exists or `collab.ot_rooms` says so (shipped with this release); every other consumer: none.
 
 - **`Workbook` and `DocumentRow` carry `test_expires_at` / `test_run_id`** — the `workbench.udt_workbooks` / `udt_documents` rows gained these test-fixture columns; the hand-written types now match the generated row again (matrx-frontend `features/data-tables/office-types-agree.ts`). Consumer action: none (a literal building one of these rows must add the two fields, `null` for real records).
 

package/dist/{chunk-HX5TXQIX.cjs → chunk-JMVPAJJA.cjs}

@@ -198,8 +198,8 @@ var _core = require('@univerjs/core');
 var NAMED_STYLE_STRING_TO_NUMBER = Object.fromEntries(
   Object.entries(_core.NamedStyleType).filter(([key, val]) => typeof val === "number" && isNaN(Number(key))).map(([key, val]) => [key, val])
 );
-function sanitizeUniverDocSnapshot(snapshot, docId) {
-  restorePageStyle(snapshot, docId);
+function sanitizeUniverDocSnapshot(snapshot, docId, opts = {}) {
+  restorePageStyle(snapshot, docId, opts.quiet === true);
   ensureTextRuns(snapshot);
   const paragraphs = _optionalChain([snapshot, 'optionalAccess', _5 => _5.body, 'optionalAccess', _6 => _6.paragraphs]);
   if (!Array.isArray(paragraphs)) return snapshot;
@@ -218,14 +218,14 @@ function sanitizeUniverDocSnapshot(snapshot, docId) {
       }
     }
   }
-  if (fixed > 0) {
+  if (fixed > 0 && opts.quiet !== true) {
     console.warn(
       `[data-tables] RECOVERY: sanitized ${fixed} string namedStyleType value(s) to numeric NamedStyleType in document snapshot${docId ? ` ${docId}` : ""}. The snapshot was written with the wrong enum encoding (string instead of number) and would have crashed Univer's <ParagraphMenu>. Fix the snapshot writer to emit numeric NamedStyleType values.`
     );
   }
   return snapshot;
 }
-function restorePageStyle(snapshot, docId) {
+function restorePageStyle(snapshot, docId, quiet = false) {
   if (!snapshot || typeof snapshot !== "object") return;
   const style = snapshot.documentStyle;
   if (_optionalChain([style, 'optionalAccess', _9 => _9.pageSize, 'optionalAccess', _10 => _10.width]) && _chunkXAIKXHHJcjs.isLegacySqueezedPageStyle.call(void 0, style)) {
@@ -246,6 +246,7 @@ function restorePageStyle(snapshot, docId) {
     ..._nullishCoalesce(snapshot.documentStyle, () => ( {})),
     pageSize: _chunkXAIKXHHJcjs.defaultDocumentPageStyle.call(void 0, ).pageSize
   };
+  if (quiet) return;
   console.warn(
     `[data-tables] RECOVERY: document snapshot${docId ? ` ${docId}` : ""} had no documentStyle.pageSize \u2014 restored the default Letter page geometry. Without a page box Univer lays the body out unbounded: text does not wrap and the viewport has no scrollable extent, so the document appears frozen. Fix the snapshot writer (agent/markdown converters must stamp DEFAULT_DOCUMENT_PAGE_STYLE).`
   );
@@ -274,4 +275,4 @@ function ensureTextRuns(snapshot) {
 
 
 exports.configureDocsHost = configureDocsHost; exports.getDocsHost = getDocsHost; exports.createDocument = createDocument; exports.listAccessibleDocuments = listAccessibleDocuments; exports.getDocument = getDocument; exports.renameDocument = renameDocument; exports.moveDocument = moveDocument; exports.updateDocumentDescription = updateDocumentDescription; exports.restoreDocument = restoreDocument; exports.discardFailedDocument = discardFailedDocument; exports.deleteDocument = deleteDocument; exports.getLatestDocumentSnapshot = getLatestDocumentSnapshot; exports.saveDocumentSnapshot = saveDocumentSnapshot; exports.copyDocument = copyDocument; exports.listTrashedDocuments = listTrashedDocuments; exports.listDocumentSnapshots = listDocumentSnapshots; exports.sanitizeUniverDocSnapshot = sanitizeUniverDocSnapshot;
-//# sourceMappingURL=chunk-HX5TXQIX.cjs.map
+//# sourceMappingURL=chunk-JMVPAJJA.cjs.map

package/dist/chunk-JMVPAJJA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/aidream/aidream/apps/shared/office/dist/chunk-JMVPAJJA.cjs","../src/docs/ports.ts","../src/docs/document-service.ts","../src/docs/sanitize-univer-doc-snapshot.ts"],"names":["error"],"mappings":"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","file":"/home/runner/work/aidream/aidream/apps/shared/office/dist/chunk-JMVPAJJA.cjs","sourcesContent":[null,"/**\n * The host ports of the Docs model and io.\n *\n * The package owns the document service, the open-document model and the converters, but two things\n * belong to the app that mounts them: the database client (a package owns no client) and the server\n * request that converts a .docx to .odt / .rtf (the app owns the server URL, auth and error capture).\n * The host states them once at start-up with `configureDocsHost`. State sits on a `globalThis` slot\n * so a dual-bundled copy of the package still sees one host. An unconfigured port THROWS naming\n * itself (nothing fails silently).\n */\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\n\n/** A Supabase client over any schema: the package cannot import the app's generated database types. */\nexport type DocsSupabase = SupabaseClient<any, any, any>;\n\nexport interface DocsHostPorts {\n  /** The app's database client (signed in as the person). */\n  getSupabase(): DocsSupabase;\n  /** An authenticated request to the Matrx server returning the raw `Response` (the open-format converter). */\n  requestRaw(path: string, init: { method: \"POST\"; body: FormData }): Promise<Response>;\n}\n\nconst SLOT = Symbol.for(\"ai-matrx.office.docs-host\");\ntype Slot = { ports?: DocsHostPorts };\nconst slot = (): Slot => {\n  const g = globalThis as Record<symbol, Slot | undefined>;\n  return (g[SLOT] ??= {});\n};\n\nexport function configureDocsHost(ports: DocsHostPorts): void {\n  slot().ports = ports;\n}\n\nexport function getDocsHost(): DocsHostPorts {\n  const ports = slot().ports;\n  if (!ports) throw new Error(\"@ai-matrx/office/docs: configureDocsHost(ports) was not called before the document service ran.\");\n  return ports;\n}\n","/**\n * Document service — typed wrappers for `udt_documents` + `udt_document_snapshots`.\n *\n * Cloud document editor backed by Univer's preset-docs-core. Same shape as\n * `workbook-service.ts` — metadata in `udt_documents`, content state in\n * append-only `udt_document_snapshots`. The editor hydrates from the LATEST\n * snapshot and writes a new snapshot per save (debounced on the client —\n * see DocumentEditor).\n *\n * What lives elsewhere:\n *   - Sharing / permissions: features/sharing/ + `has_permission(...)` RLS\n *   - The open document (one model per id per tab: load, one save, realtime,\n *     collab): features/documents/document-model/\n *   - Component (a view of that model): features/documents/components/DocumentEditor\n *\n * Mirrors `workbook-service.ts`. If you're changing the shape of one, change\n * the other at the same time — see `features/data-tables/FEATURE.md`.\n */\nimport { requireOrganizationContext } from \"@ai-matrx/api\";\nimport { getClaimsUser } from \"@ai-matrx/auth\";\nimport { readAllRows, tryWriteOne, writeOneRow } from \"@ai-matrx/data/db\";\nimport type { ServiceResult } from \"@ai-matrx/records/core\";\n\nimport type { DocumentRow, DocumentSnapshot, DocumentSnapshotOrigin } from \"../core\";\nimport { getDocsHost } from \"./ports\";\n\n/** The app's database client, read through the host port at call time. */\nconst db = () => getDocsHost().getSupabase();\n// ─── documents ───────────────────────────────────────────────────────────────\n\nexport type CreateDocumentArgs = {\n  name: string;\n  description?: string | null;\n  /** Origin label for the document itself, mirrors `udt_documents.source`. */\n  source?: \"created\" | \"imported_docx\" | \"imported_md\" | \"imported_txt\" | \"linked_gdoc\";\n  organizationId: string;\n  projectId?: string | null;\n  taskId?: string | null;\n  isPublic?: boolean;\n  /**\n   * cld_files.id of the source upload (DOCX / MD / TXT blob). Set on the\n   * import flow so the lossless original is recoverable; FK is ON DELETE SET\n   * NULL, so deleting the file just nulls the link — the document survives.\n   */\n  originalFileId?: string | null;\n};\n\nexport async function createDocument(\n  args: CreateDocumentArgs,\n): Promise<ServiceResult<DocumentRow>> {\n  let organizationId: string;\n  try {\n    organizationId = requireOrganizationContext(undefined, args.organizationId);\n  } catch (error) {\n    return {\n      success: false,\n      error:\n        error instanceof Error\n          ? error.message\n          : \"Select an organization before creating a document.\",\n    };\n  }\n\n  const { data: userData, error: userErr } = await getClaimsUser(db());\n  if (userErr || !userData?.user) {\n    return {\n      success: false,\n      error: userErr?.message ?? \"not authenticated\",\n    };\n  }\n\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .insert({\n      document_name: args.name,\n      description: args.description ?? null,\n      source: args.source ?? \"created\",\n      organization_id: organizationId,\n      project_id: args.projectId ?? null,\n      task_id: args.taskId ?? null,\n      original_file_id: args.originalFileId ?? null,\n      // CANONICAL columns (workbench_udt_canonical_step1). `visibility` is the\n      // source of truth; the legacy `is_public` boolean is derived from it by\n      // the workbench._bridge_legacy_owner trigger, so writing both here would\n      // be two authorities for one fact. A new document defaults to `internal`\n      // — it is org work product, not an individual person's private thing\n      // (db-rules §6) — unless the caller explicitly asked for public.\n      created_by: userData.user.id,\n      visibility: args.isPublic ? \"public\" : \"internal\",\n    })\n    .select(\"*\")\n    .single();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\nexport async function listAccessibleDocuments(): Promise<\n  ServiceResult<DocumentRow[]>\n> {\n  // RLS handles owner / published-to-the-web / shared access. The library and\n  // the pickers treat this list as COMPLETE (\"you have no such document\"), so\n  // it pages past PostgREST's silent 1000-row cap (D190).\n  try {\n    const rows = await readAllRows<DocumentRow>(\n      ({ from, to }) =>\n        db()\n          .schema(\"workbench\")\n          .from(\"udt_documents\")\n          .select(\"*\", { count: \"exact\" })\n          .is(\"deleted_at\", null)\n          .order(\"updated_at\", { ascending: false })\n          .order(\"id\", { ascending: true })\n          .range(from, to)\n          .returns<DocumentRow[]>(),\n      { label: \"workbench.udt_documents accessible documents\" },\n    );\n    return { success: true, data: rows };\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nexport async function getDocument(\n  documentId: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .select(\"*\")\n    .eq(\"id\", documentId)\n    .is(\"deleted_at\", null)\n    .maybeSingle();\n  if (error) return { success: false, error: error.message };\n  if (!data) {\n    // A trashed or unreachable document is a state the person can act on,\n    // never PostgREST's \"Cannot coerce the result to a single JSON object\".\n    return {\n      success: false,\n      error:\n        \"This document is in the trash or you no longer have access to it. Restore it from Trash, or ask its owner to share it again.\",\n    };\n  }\n  return { success: true, data: data as DocumentRow };\n}\n\nexport async function renameDocument(\n  documentId: string,\n  name: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ document_name: name, updated_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Move the document into a project (or out of one with `null`). Sibling of\n * `renameDocument`: the one named setter for `project_id`.\n */\nexport async function moveDocument(\n  documentId: string,\n  projectId: string | null,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ project_id: projectId, updated_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Rewrite the document's description. Sibling of `renameDocument` — the two\n * human-authored fields on `udt_documents` each get a named setter so callers\n * never hand-roll a `.from(\"udt_documents\").update(...)`. Pass `null` (or an\n * empty string) to clear it.\n *\n * Added when the documents surface became agent-writable: the\n * `document_description` write target on `/documents/[id]` is its caller, the\n * same way `updateWorkbookDescription` serves `workbook_description`. Keeping\n * the pair symmetric is this file's standing contract with `workbook-service`\n * (see the module header).\n */\nexport async function updateDocumentDescription(\n  documentId: string,\n  description: string | null,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({\n        description: description && description.length > 0 ? description : null,\n        updated_at: new Date().toISOString(),\n      })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Soft delete — the document is tombstoned, not destroyed, and its snapshots stay\n * with it. Every read path filters `deleted_at is null`. Pair with\n * restoreDocument for undo. (aidream migration 0458.)\n */\nexport async function restoreDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: null })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"restore\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\n/**\n * Archive (delete means archive: never a hard delete) — only for rolling back a document this very flow just created and\n * failed to populate. Never use for a user-initiated delete: that is\n * deleteDocument, which tombstones and stays recoverable.\n */\nexport async function discardFailedDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"archive\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\nexport async function deleteDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"delete\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\n// ─── snapshots (document content) ────────────────────────────────────────────\n\n/**\n * Latest-snapshot fetch — what an opened document hydrates from. Returns\n * `data: null` (success path) when the document has no snapshots yet (newly\n * created, never saved). Distinguish \"no snapshot\" from \"load error\" by\n * checking `result.data === null`.\n */\nexport async function getLatestDocumentSnapshot(\n  documentId: string,\n): Promise<ServiceResult<DocumentSnapshot | null>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    .select(\"*\")\n    .eq(\"document_id\", documentId)\n    .order(\"created_at\", { ascending: false })\n    .limit(1)\n    .maybeSingle();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? null) as DocumentSnapshot | null };\n}\n\nexport type SaveDocumentSnapshotArgs = {\n  documentId: string;\n  snapshot: unknown; // opaque to us — Univer IDocumentData decides the shape\n  label?: string | null;\n  origin?: DocumentSnapshotOrigin;\n};\n\nexport async function saveDocumentSnapshot(\n  args: SaveDocumentSnapshotArgs,\n): Promise<ServiceResult<DocumentSnapshot>> {\n  const { data: userData } = await getClaimsUser(db());\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    .insert({\n      document_id: args.documentId,\n      snapshot: args.snapshot as never,\n      label: args.label ?? null,\n      origin: args.origin ?? \"autosave\",\n      created_by: userData?.user?.id ?? null,\n    })\n    .select(\"*\")\n    .single();\n  if (error) return { success: false, error: error.message };\n\n  // Touch the parent document's updated_at so list views can sort by recency\n  // without scanning snapshots. Best-effort — failure here is harmless.\n  // write-lands-exempt: best-effort recency stamp on the parent document; the snapshot insert above is the real write\n  await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .update({ updated_at: new Date().toISOString() })\n    .eq(\"id\", args.documentId);\n\n  return { success: true, data: data as DocumentSnapshot };\n}\n\n/**\n * An independent copy of a document: its own row, with the latest snapshot copied over, so editing the copy never\n * touches the original. The copy lives in the original's organization and project. Used by a board-template use.\n */\nexport async function copyDocument(\n  documentId: string,\n  name?: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const original = await getDocument(documentId);\n  if (!original.success) return original;\n  const row = original.data;\n  if (!row.organization_id) {\n    return { success: false, error: \"This document has no organization and cannot be copied.\" };\n  }\n  const created = await createDocument({\n    name: name ?? row.document_name,\n    description: row.description ?? null,\n    organizationId: row.organization_id,\n    projectId: row.project_id ?? null,\n    isPublic: row.visibility === \"public\",\n  });\n  if (!created.success) return created;\n  const latest = await getLatestDocumentSnapshot(documentId);\n  if (!latest.success) return latest;\n  if (latest.data) {\n    const saved = await saveDocumentSnapshot({\n      documentId: created.data.id,\n      snapshot: latest.data.snapshot,\n      label: latest.data.label,\n      origin: \"autosave\",\n    });\n    if (!saved.success) return saved;\n  }\n  return created;\n}\n\n/** Trash view: the caller's own archived documents (RLS decides what is readable). */\nexport async function listTrashedDocuments(): Promise<\n  ServiceResult<DocumentRow[]>\n> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .select(\"*\")\n    .not(\"deleted_at\", \"is\", null)\n    .order(\"deleted_at\", { ascending: false });\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? []) as DocumentRow[] };\n}\n\nexport async function listDocumentSnapshots(\n  documentId: string,\n  limit = 50,\n): Promise<ServiceResult<DocumentSnapshot[]>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    // component-created-by-ok: append-only snapshot with NO updated_by column and NO parent-rewrite trigger — created_by is the author the client wrote at insert (the only person field this table has)\n    .select(\"id, document_id, label, origin, created_by, created_at\")\n    .eq(\"document_id\", documentId)\n    .order(\"created_at\", { ascending: false })\n    .limit(limit);\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? []) as DocumentSnapshot[] };\n}\n","/**\n * sanitizeUniverDocSnapshot — defensive normalizer for Univer document\n * snapshots loaded from storage.\n *\n * WHY THIS EXISTS (loud recovery layer):\n * Univer's `NamedStyleType` is a NUMERIC enum (`HEADING_1 = 4`, `HEADING_2 = 5`,\n * …). Some snapshots in storage were produced by an external markdown→Univer\n * converter that wrote the *string* name (`\"HEADING_1\"`) into\n * `paragraphStyle.namedStyleType` instead of the numeric value. At render time\n * Univer does `HEADING_ICON_MAP[namedStyleType]` → `undefined` →\n * `icon.key` throws `Cannot read properties of undefined (reading 'key')` inside\n * the `<ParagraphMenu>` component the moment the cursor lands in a heading. That\n * uncaught error tears down Univer's React root, so the document loads and then\n * vanishes. See `features/data-tables/FEATURE.md`.\n *\n * This normalizer converts those string enum values back to numbers BEFORE the\n * snapshot reaches `createUniverDoc`. It is a recovery layer: when it fires it\n * means malformed data slipped past the writer, so it SCREAMS (console.warn)\n * with a count and the document id. The proper long-term fix is to make the\n * writer emit numeric enum values; until then this keeps the editor alive.\n *\n * Returns the SAME object (mutated in place) for ergonomic call sites, plus a\n * `fixed` count via the second return slot is intentionally avoided — callers\n * only need the sanitized snapshot; the warning is the signal.\n */\nimport { NamedStyleType } from \"@univerjs/core\";\nimport type { IDocumentData } from \"@univerjs/core\";\n\nimport {\n  defaultDocumentPageStyle,\n  isLegacySqueezedPageStyle,\n} from \"../core\";\n\n/**\n * Map of every string name that could appear in a legacy snapshot to its\n * canonical numeric `NamedStyleType`. Built from the enum itself so it stays in\n * lockstep with Univer (numeric enums expose name→value on string keys).\n */\nconst NAMED_STYLE_STRING_TO_NUMBER: Record<string, number> = Object.fromEntries(\n  Object.entries(NamedStyleType)\n    .filter(([key, val]) => typeof val === \"number\" && isNaN(Number(key)))\n    .map(([key, val]) => [key, val as number]),\n);\n\n/**\n * Normalize a Univer document snapshot in place. Currently fixes string-valued\n * `paragraphStyle.namedStyleType` (the confirmed `<ParagraphMenu>` crash). New\n * classes of string-vs-enum corruption should be added here, not patched at the\n * call site.\n *\n * @param snapshot  The snapshot about to be passed to `createUniverDoc`.\n * @param docId     Document id, for the loud warning only.\n * @param opts.quiet The co-editing state hash applies the same repair to compare what a seat will hold\n *                   (`asLoadedDocsSnapshot`); the warning belongs to the load, not to every hash.\n * @returns the same snapshot reference (mutated).\n */\nexport function sanitizeUniverDocSnapshot(\n  snapshot: Partial<IDocumentData>,\n  docId?: string,\n  opts: { quiet?: boolean } = {},\n): Partial<IDocumentData> {\n  restorePageStyle(snapshot, docId, opts.quiet === true);\n  ensureTextRuns(snapshot);\n\n  const paragraphs = snapshot?.body?.paragraphs;\n  if (!Array.isArray(paragraphs)) return snapshot;\n\n  let fixed = 0;\n  for (const paragraph of paragraphs) {\n    const style = paragraph?.paragraphStyle as\n      { namedStyleType?: unknown } | undefined;\n    const value = style?.namedStyleType;\n    if (typeof value === \"string\") {\n      const numeric = NAMED_STYLE_STRING_TO_NUMBER[value];\n      if (numeric !== undefined) {\n        (style as { namedStyleType?: number }).namedStyleType = numeric;\n        fixed += 1;\n      } else {\n        // Unknown string we can't map — drop it so Univer falls back to\n        // NORMAL_TEXT rather than crashing on the lookup.\n        delete (style as { namedStyleType?: unknown }).namedStyleType;\n        fixed += 1;\n      }\n    }\n  }\n\n  if (fixed > 0 && opts.quiet !== true) {\n    console.warn(\n      `[data-tables] RECOVERY: sanitized ${fixed} string namedStyleType value(s) ` +\n        `to numeric NamedStyleType in document snapshot${docId ? ` ${docId}` : \"\"}. ` +\n        `The snapshot was written with the wrong enum encoding (string instead of ` +\n        `number) and would have crashed Univer's <ParagraphMenu>. Fix the snapshot ` +\n        `writer to emit numeric NamedStyleType values.`,\n    );\n  }\n\n  return snapshot;\n}\n\n/**\n * Second recovery: a snapshot with no `documentStyle.pageSize` has no page box,\n * so Univer lays the body out unbounded — text never wraps and the docs\n * viewport reports no scrollable extent, which reads to the user as \"the\n * document won't scroll\". Snapshots written by agents (`origin='agent'`) and by\n * older converters reach storage with `documentStyle: {}`. Stamp the canonical\n * page geometry back on and SCREAM: the writer is the real bug.\n */\nfunction restorePageStyle(snapshot: Partial<IDocumentData>, docId?: string, quiet = false) {\n  if (!snapshot || typeof snapshot !== \"object\") return;\n\n  // THE SQUEEZED PAGE (2026-10-15): documents carried A4-at-72dpi geometry in Univer's pageless\n  // flavour — a 415px text column with no paper. Move them to a real Letter page, unchanged text.\n  // A document with no flavour at all is a paginated page too (Univer would otherwise pick pageless).\n  const style = snapshot.documentStyle;\n  if (style?.pageSize?.width && isLegacySqueezedPageStyle(style)) {\n    const page = defaultDocumentPageStyle();\n    snapshot.documentStyle = { ...style, ...page, defaultParagraphStyle: style.defaultParagraphStyle ?? page.defaultParagraphStyle } as typeof style;\n    return;\n  }\n  if (style?.pageSize?.width) {\n    if (!style.documentFlavor) {\n      const page = defaultDocumentPageStyle();\n      Object.assign(style, { documentFlavor: page.documentFlavor });\n      if (page.defaultParagraphStyle) style.defaultParagraphStyle ??= page.defaultParagraphStyle;\n    }\n    return;\n  }\n\n  snapshot.documentStyle = {\n    ...defaultDocumentPageStyle(),\n    ...(snapshot.documentStyle ?? {}),\n    pageSize: defaultDocumentPageStyle().pageSize,\n  } as NonNullable<typeof snapshot.documentStyle>;\n\n  if (quiet) return;\n  console.warn(\n    `[data-tables] RECOVERY: document snapshot${docId ? ` ${docId}` : \"\"} had no ` +\n      `documentStyle.pageSize — restored the default Letter page geometry. Without a ` +\n      `page box Univer lays the body out unbounded: text does not wrap and the ` +\n      `viewport has no scrollable extent, so the document appears frozen. Fix the ` +\n      `snapshot writer (agent/markdown converters must stamp ` +\n      `DEFAULT_DOCUMENT_PAGE_STYLE).`,\n  );\n}\n\n/**\n * A body with no `textRuns` array is a body Univer silently refuses styled text for: its text\n * insert (`insertTextRuns`) returns early when the target has none, so every bold, italic, code\n * and size run of pasted or agent-written markdown vanished (found 2026-10-16: `**notes**` pasted\n * into a blank document stayed plain). An empty array is the same document and accepts the runs.\n */\nfunction ensureTextRuns(snapshot: Partial<IDocumentData>) {\n  const body = snapshot?.body;\n  if (body && typeof body === \"object\" && !Array.isArray(body.textRuns)) body.textRuns = [];\n}\n"]}

package/dist/{chunk-2X3KR6Y4.js → chunk-TRA2BTPL.js}

@@ -198,8 +198,8 @@ import { NamedStyleType } from "@univerjs/core";
 var NAMED_STYLE_STRING_TO_NUMBER = Object.fromEntries(
   Object.entries(NamedStyleType).filter(([key, val]) => typeof val === "number" && isNaN(Number(key))).map(([key, val]) => [key, val])
 );
-function sanitizeUniverDocSnapshot(snapshot, docId) {
-  restorePageStyle(snapshot, docId);
+function sanitizeUniverDocSnapshot(snapshot, docId, opts = {}) {
+  restorePageStyle(snapshot, docId, opts.quiet === true);
   ensureTextRuns(snapshot);
   const paragraphs = snapshot?.body?.paragraphs;
   if (!Array.isArray(paragraphs)) return snapshot;
@@ -218,14 +218,14 @@ function sanitizeUniverDocSnapshot(snapshot, docId) {
       }
     }
   }
-  if (fixed > 0) {
+  if (fixed > 0 && opts.quiet !== true) {
     console.warn(
       `[data-tables] RECOVERY: sanitized ${fixed} string namedStyleType value(s) to numeric NamedStyleType in document snapshot${docId ? ` ${docId}` : ""}. The snapshot was written with the wrong enum encoding (string instead of number) and would have crashed Univer's <ParagraphMenu>. Fix the snapshot writer to emit numeric NamedStyleType values.`
     );
   }
   return snapshot;
 }
-function restorePageStyle(snapshot, docId) {
+function restorePageStyle(snapshot, docId, quiet = false) {
   if (!snapshot || typeof snapshot !== "object") return;
   const style = snapshot.documentStyle;
   if (style?.pageSize?.width && isLegacySqueezedPageStyle(style)) {
@@ -246,6 +246,7 @@ function restorePageStyle(snapshot, docId) {
     ...snapshot.documentStyle ?? {},
     pageSize: defaultDocumentPageStyle().pageSize
   };
+  if (quiet) return;
   console.warn(
     `[data-tables] RECOVERY: document snapshot${docId ? ` ${docId}` : ""} had no documentStyle.pageSize \u2014 restored the default Letter page geometry. Without a page box Univer lays the body out unbounded: text does not wrap and the viewport has no scrollable extent, so the document appears frozen. Fix the snapshot writer (agent/markdown converters must stamp DEFAULT_DOCUMENT_PAGE_STYLE).`
   );
@@ -274,4 +275,4 @@ export {
   listDocumentSnapshots,
   sanitizeUniverDocSnapshot
 };
-//# sourceMappingURL=chunk-2X3KR6Y4.js.map
+//# sourceMappingURL=chunk-TRA2BTPL.js.map

package/dist/{chunk-2X3KR6Y4.js.map → chunk-TRA2BTPL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/docs/ports.ts","../src/docs/document-service.ts","../src/docs/sanitize-univer-doc-snapshot.ts"],"sourcesContent":["/**\n * The host ports of the Docs model and io.\n *\n * The package owns the document service, the open-document model and the converters, but two things\n * belong to the app that mounts them: the database client (a package owns no client) and the server\n * request that converts a .docx to .odt / .rtf (the app owns the server URL, auth and error capture).\n * The host states them once at start-up with `configureDocsHost`. State sits on a `globalThis` slot\n * so a dual-bundled copy of the package still sees one host. An unconfigured port THROWS naming\n * itself (nothing fails silently).\n */\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\n\n/** A Supabase client over any schema: the package cannot import the app's generated database types. */\nexport type DocsSupabase = SupabaseClient<any, any, any>;\n\nexport interface DocsHostPorts {\n  /** The app's database client (signed in as the person). */\n  getSupabase(): DocsSupabase;\n  /** An authenticated request to the Matrx server returning the raw `Response` (the open-format converter). */\n  requestRaw(path: string, init: { method: \"POST\"; body: FormData }): Promise<Response>;\n}\n\nconst SLOT = Symbol.for(\"ai-matrx.office.docs-host\");\ntype Slot = { ports?: DocsHostPorts };\nconst slot = (): Slot => {\n  const g = globalThis as Record<symbol, Slot | undefined>;\n  return (g[SLOT] ??= {});\n};\n\nexport function configureDocsHost(ports: DocsHostPorts): void {\n  slot().ports = ports;\n}\n\nexport function getDocsHost(): DocsHostPorts {\n  const ports = slot().ports;\n  if (!ports) throw new Error(\"@ai-matrx/office/docs: configureDocsHost(ports) was not called before the document service ran.\");\n  return ports;\n}\n","/**\n * Document service — typed wrappers for `udt_documents` + `udt_document_snapshots`.\n *\n * Cloud document editor backed by Univer's preset-docs-core. Same shape as\n * `workbook-service.ts` — metadata in `udt_documents`, content state in\n * append-only `udt_document_snapshots`. The editor hydrates from the LATEST\n * snapshot and writes a new snapshot per save (debounced on the client —\n * see DocumentEditor).\n *\n * What lives elsewhere:\n *   - Sharing / permissions: features/sharing/ + `has_permission(...)` RLS\n *   - The open document (one model per id per tab: load, one save, realtime,\n *     collab): features/documents/document-model/\n *   - Component (a view of that model): features/documents/components/DocumentEditor\n *\n * Mirrors `workbook-service.ts`. If you're changing the shape of one, change\n * the other at the same time — see `features/data-tables/FEATURE.md`.\n */\nimport { requireOrganizationContext } from \"@ai-matrx/api\";\nimport { getClaimsUser } from \"@ai-matrx/auth\";\nimport { readAllRows, tryWriteOne, writeOneRow } from \"@ai-matrx/data/db\";\nimport type { ServiceResult } from \"@ai-matrx/records/core\";\n\nimport type { DocumentRow, DocumentSnapshot, DocumentSnapshotOrigin } from \"../core\";\nimport { getDocsHost } from \"./ports\";\n\n/** The app's database client, read through the host port at call time. */\nconst db = () => getDocsHost().getSupabase();\n// ─── documents ───────────────────────────────────────────────────────────────\n\nexport type CreateDocumentArgs = {\n  name: string;\n  description?: string | null;\n  /** Origin label for the document itself, mirrors `udt_documents.source`. */\n  source?: \"created\" | \"imported_docx\" | \"imported_md\" | \"imported_txt\" | \"linked_gdoc\";\n  organizationId: string;\n  projectId?: string | null;\n  taskId?: string | null;\n  isPublic?: boolean;\n  /**\n   * cld_files.id of the source upload (DOCX / MD / TXT blob). Set on the\n   * import flow so the lossless original is recoverable; FK is ON DELETE SET\n   * NULL, so deleting the file just nulls the link — the document survives.\n   */\n  originalFileId?: string | null;\n};\n\nexport async function createDocument(\n  args: CreateDocumentArgs,\n): Promise<ServiceResult<DocumentRow>> {\n  let organizationId: string;\n  try {\n    organizationId = requireOrganizationContext(undefined, args.organizationId);\n  } catch (error) {\n    return {\n      success: false,\n      error:\n        error instanceof Error\n          ? error.message\n          : \"Select an organization before creating a document.\",\n    };\n  }\n\n  const { data: userData, error: userErr } = await getClaimsUser(db());\n  if (userErr || !userData?.user) {\n    return {\n      success: false,\n      error: userErr?.message ?? \"not authenticated\",\n    };\n  }\n\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .insert({\n      document_name: args.name,\n      description: args.description ?? null,\n      source: args.source ?? \"created\",\n      organization_id: organizationId,\n      project_id: args.projectId ?? null,\n      task_id: args.taskId ?? null,\n      original_file_id: args.originalFileId ?? null,\n      // CANONICAL columns (workbench_udt_canonical_step1). `visibility` is the\n      // source of truth; the legacy `is_public` boolean is derived from it by\n      // the workbench._bridge_legacy_owner trigger, so writing both here would\n      // be two authorities for one fact. A new document defaults to `internal`\n      // — it is org work product, not an individual person's private thing\n      // (db-rules §6) — unless the caller explicitly asked for public.\n      created_by: userData.user.id,\n      visibility: args.isPublic ? \"public\" : \"internal\",\n    })\n    .select(\"*\")\n    .single();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\nexport async function listAccessibleDocuments(): Promise<\n  ServiceResult<DocumentRow[]>\n> {\n  // RLS handles owner / published-to-the-web / shared access. The library and\n  // the pickers treat this list as COMPLETE (\"you have no such document\"), so\n  // it pages past PostgREST's silent 1000-row cap (D190).\n  try {\n    const rows = await readAllRows<DocumentRow>(\n      ({ from, to }) =>\n        db()\n          .schema(\"workbench\")\n          .from(\"udt_documents\")\n          .select(\"*\", { count: \"exact\" })\n          .is(\"deleted_at\", null)\n          .order(\"updated_at\", { ascending: false })\n          .order(\"id\", { ascending: true })\n          .range(from, to)\n          .returns<DocumentRow[]>(),\n      { label: \"workbench.udt_documents accessible documents\" },\n    );\n    return { success: true, data: rows };\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nexport async function getDocument(\n  documentId: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .select(\"*\")\n    .eq(\"id\", documentId)\n    .is(\"deleted_at\", null)\n    .maybeSingle();\n  if (error) return { success: false, error: error.message };\n  if (!data) {\n    // A trashed or unreachable document is a state the person can act on,\n    // never PostgREST's \"Cannot coerce the result to a single JSON object\".\n    return {\n      success: false,\n      error:\n        \"This document is in the trash or you no longer have access to it. Restore it from Trash, or ask its owner to share it again.\",\n    };\n  }\n  return { success: true, data: data as DocumentRow };\n}\n\nexport async function renameDocument(\n  documentId: string,\n  name: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ document_name: name, updated_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Move the document into a project (or out of one with `null`). Sibling of\n * `renameDocument`: the one named setter for `project_id`.\n */\nexport async function moveDocument(\n  documentId: string,\n  projectId: string | null,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ project_id: projectId, updated_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Rewrite the document's description. Sibling of `renameDocument` — the two\n * human-authored fields on `udt_documents` each get a named setter so callers\n * never hand-roll a `.from(\"udt_documents\").update(...)`. Pass `null` (or an\n * empty string) to clear it.\n *\n * Added when the documents surface became agent-writable: the\n * `document_description` write target on `/documents/[id]` is its caller, the\n * same way `updateWorkbookDescription` serves `workbook_description`. Keeping\n * the pair symmetric is this file's standing contract with `workbook-service`\n * (see the module header).\n */\nexport async function updateDocumentDescription(\n  documentId: string,\n  description: string | null,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({\n        description: description && description.length > 0 ? description : null,\n        updated_at: new Date().toISOString(),\n      })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Soft delete — the document is tombstoned, not destroyed, and its snapshots stay\n * with it. Every read path filters `deleted_at is null`. Pair with\n * restoreDocument for undo. (aidream migration 0458.)\n */\nexport async function restoreDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: null })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"restore\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\n/**\n * Archive (delete means archive: never a hard delete) — only for rolling back a document this very flow just created and\n * failed to populate. Never use for a user-initiated delete: that is\n * deleteDocument, which tombstones and stays recoverable.\n */\nexport async function discardFailedDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"archive\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\nexport async function deleteDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"delete\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\n// ─── snapshots (document content) ────────────────────────────────────────────\n\n/**\n * Latest-snapshot fetch — what an opened document hydrates from. Returns\n * `data: null` (success path) when the document has no snapshots yet (newly\n * created, never saved). Distinguish \"no snapshot\" from \"load error\" by\n * checking `result.data === null`.\n */\nexport async function getLatestDocumentSnapshot(\n  documentId: string,\n): Promise<ServiceResult<DocumentSnapshot | null>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    .select(\"*\")\n    .eq(\"document_id\", documentId)\n    .order(\"created_at\", { ascending: false })\n    .limit(1)\n    .maybeSingle();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? null) as DocumentSnapshot | null };\n}\n\nexport type SaveDocumentSnapshotArgs = {\n  documentId: string;\n  snapshot: unknown; // opaque to us — Univer IDocumentData decides the shape\n  label?: string | null;\n  origin?: DocumentSnapshotOrigin;\n};\n\nexport async function saveDocumentSnapshot(\n  args: SaveDocumentSnapshotArgs,\n): Promise<ServiceResult<DocumentSnapshot>> {\n  const { data: userData } = await getClaimsUser(db());\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    .insert({\n      document_id: args.documentId,\n      snapshot: args.snapshot as never,\n      label: args.label ?? null,\n      origin: args.origin ?? \"autosave\",\n      created_by: userData?.user?.id ?? null,\n    })\n    .select(\"*\")\n    .single();\n  if (error) return { success: false, error: error.message };\n\n  // Touch the parent document's updated_at so list views can sort by recency\n  // without scanning snapshots. Best-effort — failure here is harmless.\n  // write-lands-exempt: best-effort recency stamp on the parent document; the snapshot insert above is the real write\n  await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .update({ updated_at: new Date().toISOString() })\n    .eq(\"id\", args.documentId);\n\n  return { success: true, data: data as DocumentSnapshot };\n}\n\n/**\n * An independent copy of a document: its own row, with the latest snapshot copied over, so editing the copy never\n * touches the original. The copy lives in the original's organization and project. Used by a board-template use.\n */\nexport async function copyDocument(\n  documentId: string,\n  name?: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const original = await getDocument(documentId);\n  if (!original.success) return original;\n  const row = original.data;\n  if (!row.organization_id) {\n    return { success: false, error: \"This document has no organization and cannot be copied.\" };\n  }\n  const created = await createDocument({\n    name: name ?? row.document_name,\n    description: row.description ?? null,\n    organizationId: row.organization_id,\n    projectId: row.project_id ?? null,\n    isPublic: row.visibility === \"public\",\n  });\n  if (!created.success) return created;\n  const latest = await getLatestDocumentSnapshot(documentId);\n  if (!latest.success) return latest;\n  if (latest.data) {\n    const saved = await saveDocumentSnapshot({\n      documentId: created.data.id,\n      snapshot: latest.data.snapshot,\n      label: latest.data.label,\n      origin: \"autosave\",\n    });\n    if (!saved.success) return saved;\n  }\n  return created;\n}\n\n/** Trash view: the caller's own archived documents (RLS decides what is readable). */\nexport async function listTrashedDocuments(): Promise<\n  ServiceResult<DocumentRow[]>\n> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .select(\"*\")\n    .not(\"deleted_at\", \"is\", null)\n    .order(\"deleted_at\", { ascending: false });\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? []) as DocumentRow[] };\n}\n\nexport async function listDocumentSnapshots(\n  documentId: string,\n  limit = 50,\n): Promise<ServiceResult<DocumentSnapshot[]>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    // component-created-by-ok: append-only snapshot with NO updated_by column and NO parent-rewrite trigger — created_by is the author the client wrote at insert (the only person field this table has)\n    .select(\"id, document_id, label, origin, created_by, created_at\")\n    .eq(\"document_id\", documentId)\n    .order(\"created_at\", { ascending: false })\n    .limit(limit);\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? []) as DocumentSnapshot[] };\n}\n","/**\n * sanitizeUniverDocSnapshot — defensive normalizer for Univer document\n * snapshots loaded from storage.\n *\n * WHY THIS EXISTS (loud recovery layer):\n * Univer's `NamedStyleType` is a NUMERIC enum (`HEADING_1 = 4`, `HEADING_2 = 5`,\n * …). Some snapshots in storage were produced by an external markdown→Univer\n * converter that wrote the *string* name (`\"HEADING_1\"`) into\n * `paragraphStyle.namedStyleType` instead of the numeric value. At render time\n * Univer does `HEADING_ICON_MAP[namedStyleType]` → `undefined` →\n * `icon.key` throws `Cannot read properties of undefined (reading 'key')` inside\n * the `<ParagraphMenu>` component the moment the cursor lands in a heading. That\n * uncaught error tears down Univer's React root, so the document loads and then\n * vanishes. See `features/data-tables/FEATURE.md`.\n *\n * This normalizer converts those string enum values back to numbers BEFORE the\n * snapshot reaches `createUniverDoc`. It is a recovery layer: when it fires it\n * means malformed data slipped past the writer, so it SCREAMS (console.warn)\n * with a count and the document id. The proper long-term fix is to make the\n * writer emit numeric enum values; until then this keeps the editor alive.\n *\n * Returns the SAME object (mutated in place) for ergonomic call sites, plus a\n * `fixed` count via the second return slot is intentionally avoided — callers\n * only need the sanitized snapshot; the warning is the signal.\n */\nimport { NamedStyleType } from \"@univerjs/core\";\nimport type { IDocumentData } from \"@univerjs/core\";\n\nimport {\n  defaultDocumentPageStyle,\n  isLegacySqueezedPageStyle,\n} from \"../core\";\n\n/**\n * Map of every string name that could appear in a legacy snapshot to its\n * canonical numeric `NamedStyleType`. Built from the enum itself so it stays in\n * lockstep with Univer (numeric enums expose name→value on string keys).\n */\nconst NAMED_STYLE_STRING_TO_NUMBER: Record<string, number> = Object.fromEntries(\n  Object.entries(NamedStyleType)\n    .filter(([key, val]) => typeof val === \"number\" && isNaN(Number(key)))\n    .map(([key, val]) => [key, val as number]),\n);\n\n/**\n * Normalize a Univer document snapshot in place. Currently fixes string-valued\n * `paragraphStyle.namedStyleType` (the confirmed `<ParagraphMenu>` crash). New\n * classes of string-vs-enum corruption should be added here, not patched at the\n * call site.\n *\n * @param snapshot  The snapshot about to be passed to `createUniverDoc`.\n * @param docId     Document id, for the loud warning only.\n * @returns the same snapshot reference (mutated).\n */\nexport function sanitizeUniverDocSnapshot(\n  snapshot: Partial<IDocumentData>,\n  docId?: string,\n): Partial<IDocumentData> {\n  restorePageStyle(snapshot, docId);\n  ensureTextRuns(snapshot);\n\n  const paragraphs = snapshot?.body?.paragraphs;\n  if (!Array.isArray(paragraphs)) return snapshot;\n\n  let fixed = 0;\n  for (const paragraph of paragraphs) {\n    const style = paragraph?.paragraphStyle as\n      { namedStyleType?: unknown } | undefined;\n    const value = style?.namedStyleType;\n    if (typeof value === \"string\") {\n      const numeric = NAMED_STYLE_STRING_TO_NUMBER[value];\n      if (numeric !== undefined) {\n        (style as { namedStyleType?: number }).namedStyleType = numeric;\n        fixed += 1;\n      } else {\n        // Unknown string we can't map — drop it so Univer falls back to\n        // NORMAL_TEXT rather than crashing on the lookup.\n        delete (style as { namedStyleType?: unknown }).namedStyleType;\n        fixed += 1;\n      }\n    }\n  }\n\n  if (fixed > 0) {\n    console.warn(\n      `[data-tables] RECOVERY: sanitized ${fixed} string namedStyleType value(s) ` +\n        `to numeric NamedStyleType in document snapshot${docId ? ` ${docId}` : \"\"}. ` +\n        `The snapshot was written with the wrong enum encoding (string instead of ` +\n        `number) and would have crashed Univer's <ParagraphMenu>. Fix the snapshot ` +\n        `writer to emit numeric NamedStyleType values.`,\n    );\n  }\n\n  return snapshot;\n}\n\n/**\n * Second recovery: a snapshot with no `documentStyle.pageSize` has no page box,\n * so Univer lays the body out unbounded — text never wraps and the docs\n * viewport reports no scrollable extent, which reads to the user as \"the\n * document won't scroll\". Snapshots written by agents (`origin='agent'`) and by\n * older converters reach storage with `documentStyle: {}`. Stamp the canonical\n * page geometry back on and SCREAM: the writer is the real bug.\n */\nfunction restorePageStyle(snapshot: Partial<IDocumentData>, docId?: string) {\n  if (!snapshot || typeof snapshot !== \"object\") return;\n\n  // THE SQUEEZED PAGE (2026-10-15): documents carried A4-at-72dpi geometry in Univer's pageless\n  // flavour — a 415px text column with no paper. Move them to a real Letter page, unchanged text.\n  // A document with no flavour at all is a paginated page too (Univer would otherwise pick pageless).\n  const style = snapshot.documentStyle;\n  if (style?.pageSize?.width && isLegacySqueezedPageStyle(style)) {\n    const page = defaultDocumentPageStyle();\n    snapshot.documentStyle = { ...style, ...page, defaultParagraphStyle: style.defaultParagraphStyle ?? page.defaultParagraphStyle } as typeof style;\n    return;\n  }\n  if (style?.pageSize?.width) {\n    if (!style.documentFlavor) {\n      const page = defaultDocumentPageStyle();\n      Object.assign(style, { documentFlavor: page.documentFlavor });\n      if (page.defaultParagraphStyle) style.defaultParagraphStyle ??= page.defaultParagraphStyle;\n    }\n    return;\n  }\n\n  snapshot.documentStyle = {\n    ...defaultDocumentPageStyle(),\n    ...(snapshot.documentStyle ?? {}),\n    pageSize: defaultDocumentPageStyle().pageSize,\n  } as NonNullable<typeof snapshot.documentStyle>;\n\n  console.warn(\n    `[data-tables] RECOVERY: document snapshot${docId ? ` ${docId}` : \"\"} had no ` +\n      `documentStyle.pageSize — restored the default Letter page geometry. Without a ` +\n      `page box Univer lays the body out unbounded: text does not wrap and the ` +\n      `viewport has no scrollable extent, so the document appears frozen. Fix the ` +\n      `snapshot writer (agent/markdown converters must stamp ` +\n      `DEFAULT_DOCUMENT_PAGE_STYLE).`,\n  );\n}\n\n/**\n * A body with no `textRuns` array is a body Univer silently refuses styled text for: its text\n * insert (`insertTextRuns`) returns early when the target has none, so every bold, italic, code\n * and size run of pasted or agent-written markdown vanished (found 2026-10-16: `**notes**` pasted\n * into a blank document stayed plain). An empty array is the same document and accepts the runs.\n */\nfunction ensureTextRuns(snapshot: Partial<IDocumentData>) {\n  const body = snapshot?.body;\n  if (body && typeof body === \"object\" && !Array.isArray(body.textRuns)) body.textRuns = [];\n}\n"],"mappings":"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","names":["error"]}
+{"version":3,"sources":["../src/docs/ports.ts","../src/docs/document-service.ts","../src/docs/sanitize-univer-doc-snapshot.ts"],"sourcesContent":["/**\n * The host ports of the Docs model and io.\n *\n * The package owns the document service, the open-document model and the converters, but two things\n * belong to the app that mounts them: the database client (a package owns no client) and the server\n * request that converts a .docx to .odt / .rtf (the app owns the server URL, auth and error capture).\n * The host states them once at start-up with `configureDocsHost`. State sits on a `globalThis` slot\n * so a dual-bundled copy of the package still sees one host. An unconfigured port THROWS naming\n * itself (nothing fails silently).\n */\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\n\n/** A Supabase client over any schema: the package cannot import the app's generated database types. */\nexport type DocsSupabase = SupabaseClient<any, any, any>;\n\nexport interface DocsHostPorts {\n  /** The app's database client (signed in as the person). */\n  getSupabase(): DocsSupabase;\n  /** An authenticated request to the Matrx server returning the raw `Response` (the open-format converter). */\n  requestRaw(path: string, init: { method: \"POST\"; body: FormData }): Promise<Response>;\n}\n\nconst SLOT = Symbol.for(\"ai-matrx.office.docs-host\");\ntype Slot = { ports?: DocsHostPorts };\nconst slot = (): Slot => {\n  const g = globalThis as Record<symbol, Slot | undefined>;\n  return (g[SLOT] ??= {});\n};\n\nexport function configureDocsHost(ports: DocsHostPorts): void {\n  slot().ports = ports;\n}\n\nexport function getDocsHost(): DocsHostPorts {\n  const ports = slot().ports;\n  if (!ports) throw new Error(\"@ai-matrx/office/docs: configureDocsHost(ports) was not called before the document service ran.\");\n  return ports;\n}\n","/**\n * Document service — typed wrappers for `udt_documents` + `udt_document_snapshots`.\n *\n * Cloud document editor backed by Univer's preset-docs-core. Same shape as\n * `workbook-service.ts` — metadata in `udt_documents`, content state in\n * append-only `udt_document_snapshots`. The editor hydrates from the LATEST\n * snapshot and writes a new snapshot per save (debounced on the client —\n * see DocumentEditor).\n *\n * What lives elsewhere:\n *   - Sharing / permissions: features/sharing/ + `has_permission(...)` RLS\n *   - The open document (one model per id per tab: load, one save, realtime,\n *     collab): features/documents/document-model/\n *   - Component (a view of that model): features/documents/components/DocumentEditor\n *\n * Mirrors `workbook-service.ts`. If you're changing the shape of one, change\n * the other at the same time — see `features/data-tables/FEATURE.md`.\n */\nimport { requireOrganizationContext } from \"@ai-matrx/api\";\nimport { getClaimsUser } from \"@ai-matrx/auth\";\nimport { readAllRows, tryWriteOne, writeOneRow } from \"@ai-matrx/data/db\";\nimport type { ServiceResult } from \"@ai-matrx/records/core\";\n\nimport type { DocumentRow, DocumentSnapshot, DocumentSnapshotOrigin } from \"../core\";\nimport { getDocsHost } from \"./ports\";\n\n/** The app's database client, read through the host port at call time. */\nconst db = () => getDocsHost().getSupabase();\n// ─── documents ───────────────────────────────────────────────────────────────\n\nexport type CreateDocumentArgs = {\n  name: string;\n  description?: string | null;\n  /** Origin label for the document itself, mirrors `udt_documents.source`. */\n  source?: \"created\" | \"imported_docx\" | \"imported_md\" | \"imported_txt\" | \"linked_gdoc\";\n  organizationId: string;\n  projectId?: string | null;\n  taskId?: string | null;\n  isPublic?: boolean;\n  /**\n   * cld_files.id of the source upload (DOCX / MD / TXT blob). Set on the\n   * import flow so the lossless original is recoverable; FK is ON DELETE SET\n   * NULL, so deleting the file just nulls the link — the document survives.\n   */\n  originalFileId?: string | null;\n};\n\nexport async function createDocument(\n  args: CreateDocumentArgs,\n): Promise<ServiceResult<DocumentRow>> {\n  let organizationId: string;\n  try {\n    organizationId = requireOrganizationContext(undefined, args.organizationId);\n  } catch (error) {\n    return {\n      success: false,\n      error:\n        error instanceof Error\n          ? error.message\n          : \"Select an organization before creating a document.\",\n    };\n  }\n\n  const { data: userData, error: userErr } = await getClaimsUser(db());\n  if (userErr || !userData?.user) {\n    return {\n      success: false,\n      error: userErr?.message ?? \"not authenticated\",\n    };\n  }\n\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .insert({\n      document_name: args.name,\n      description: args.description ?? null,\n      source: args.source ?? \"created\",\n      organization_id: organizationId,\n      project_id: args.projectId ?? null,\n      task_id: args.taskId ?? null,\n      original_file_id: args.originalFileId ?? null,\n      // CANONICAL columns (workbench_udt_canonical_step1). `visibility` is the\n      // source of truth; the legacy `is_public` boolean is derived from it by\n      // the workbench._bridge_legacy_owner trigger, so writing both here would\n      // be two authorities for one fact. A new document defaults to `internal`\n      // — it is org work product, not an individual person's private thing\n      // (db-rules §6) — unless the caller explicitly asked for public.\n      created_by: userData.user.id,\n      visibility: args.isPublic ? \"public\" : \"internal\",\n    })\n    .select(\"*\")\n    .single();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\nexport async function listAccessibleDocuments(): Promise<\n  ServiceResult<DocumentRow[]>\n> {\n  // RLS handles owner / published-to-the-web / shared access. The library and\n  // the pickers treat this list as COMPLETE (\"you have no such document\"), so\n  // it pages past PostgREST's silent 1000-row cap (D190).\n  try {\n    const rows = await readAllRows<DocumentRow>(\n      ({ from, to }) =>\n        db()\n          .schema(\"workbench\")\n          .from(\"udt_documents\")\n          .select(\"*\", { count: \"exact\" })\n          .is(\"deleted_at\", null)\n          .order(\"updated_at\", { ascending: false })\n          .order(\"id\", { ascending: true })\n          .range(from, to)\n          .returns<DocumentRow[]>(),\n      { label: \"workbench.udt_documents accessible documents\" },\n    );\n    return { success: true, data: rows };\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\nexport async function getDocument(\n  documentId: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .select(\"*\")\n    .eq(\"id\", documentId)\n    .is(\"deleted_at\", null)\n    .maybeSingle();\n  if (error) return { success: false, error: error.message };\n  if (!data) {\n    // A trashed or unreachable document is a state the person can act on,\n    // never PostgREST's \"Cannot coerce the result to a single JSON object\".\n    return {\n      success: false,\n      error:\n        \"This document is in the trash or you no longer have access to it. Restore it from Trash, or ask its owner to share it again.\",\n    };\n  }\n  return { success: true, data: data as DocumentRow };\n}\n\nexport async function renameDocument(\n  documentId: string,\n  name: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ document_name: name, updated_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Move the document into a project (or out of one with `null`). Sibling of\n * `renameDocument`: the one named setter for `project_id`.\n */\nexport async function moveDocument(\n  documentId: string,\n  projectId: string | null,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ project_id: projectId, updated_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Rewrite the document's description. Sibling of `renameDocument` — the two\n * human-authored fields on `udt_documents` each get a named setter so callers\n * never hand-roll a `.from(\"udt_documents\").update(...)`. Pass `null` (or an\n * empty string) to clear it.\n *\n * Added when the documents surface became agent-writable: the\n * `document_description` write target on `/documents/[id]` is its caller, the\n * same way `updateWorkbookDescription` serves `workbook_description`. Keeping\n * the pair symmetric is this file's standing contract with `workbook-service`\n * (see the module header).\n */\nexport async function updateDocumentDescription(\n  documentId: string,\n  description: string | null,\n): Promise<ServiceResult<DocumentRow>> {\n  const { data, error } = await writeOneRow(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({\n        description: description && description.length > 0 ? description : null,\n        updated_at: new Date().toISOString(),\n      })\n      .eq(\"id\", documentId)\n      .select(\"*\"),\n    { action: \"update\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: data as DocumentRow };\n}\n\n/**\n * Soft delete — the document is tombstoned, not destroyed, and its snapshots stay\n * with it. Every read path filters `deleted_at is null`. Pair with\n * restoreDocument for undo. (aidream migration 0458.)\n */\nexport async function restoreDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: null })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"restore\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\n/**\n * Archive (delete means archive: never a hard delete) — only for rolling back a document this very flow just created and\n * failed to populate. Never use for a user-initiated delete: that is\n * deleteDocument, which tombstones and stays recoverable.\n */\nexport async function discardFailedDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"archive\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\nexport async function deleteDocument(\n  documentId: string,\n): Promise<ServiceResult<true>> {\n  const { error } = await tryWriteOne(\n    db()\n      .schema(\"workbench\")\n      .from(\"udt_documents\")\n      .update({ deleted_at: new Date().toISOString() })\n      .eq(\"id\", documentId)\n      .select(\"id\"),\n    { action: \"delete\", noun: \"document\" },\n  );\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: true };\n}\n\n// ─── snapshots (document content) ────────────────────────────────────────────\n\n/**\n * Latest-snapshot fetch — what an opened document hydrates from. Returns\n * `data: null` (success path) when the document has no snapshots yet (newly\n * created, never saved). Distinguish \"no snapshot\" from \"load error\" by\n * checking `result.data === null`.\n */\nexport async function getLatestDocumentSnapshot(\n  documentId: string,\n): Promise<ServiceResult<DocumentSnapshot | null>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    .select(\"*\")\n    .eq(\"document_id\", documentId)\n    .order(\"created_at\", { ascending: false })\n    .limit(1)\n    .maybeSingle();\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? null) as DocumentSnapshot | null };\n}\n\nexport type SaveDocumentSnapshotArgs = {\n  documentId: string;\n  snapshot: unknown; // opaque to us — Univer IDocumentData decides the shape\n  label?: string | null;\n  origin?: DocumentSnapshotOrigin;\n};\n\nexport async function saveDocumentSnapshot(\n  args: SaveDocumentSnapshotArgs,\n): Promise<ServiceResult<DocumentSnapshot>> {\n  const { data: userData } = await getClaimsUser(db());\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    .insert({\n      document_id: args.documentId,\n      snapshot: args.snapshot as never,\n      label: args.label ?? null,\n      origin: args.origin ?? \"autosave\",\n      created_by: userData?.user?.id ?? null,\n    })\n    .select(\"*\")\n    .single();\n  if (error) return { success: false, error: error.message };\n\n  // Touch the parent document's updated_at so list views can sort by recency\n  // without scanning snapshots. Best-effort — failure here is harmless.\n  // write-lands-exempt: best-effort recency stamp on the parent document; the snapshot insert above is the real write\n  await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .update({ updated_at: new Date().toISOString() })\n    .eq(\"id\", args.documentId);\n\n  return { success: true, data: data as DocumentSnapshot };\n}\n\n/**\n * An independent copy of a document: its own row, with the latest snapshot copied over, so editing the copy never\n * touches the original. The copy lives in the original's organization and project. Used by a board-template use.\n */\nexport async function copyDocument(\n  documentId: string,\n  name?: string,\n): Promise<ServiceResult<DocumentRow>> {\n  const original = await getDocument(documentId);\n  if (!original.success) return original;\n  const row = original.data;\n  if (!row.organization_id) {\n    return { success: false, error: \"This document has no organization and cannot be copied.\" };\n  }\n  const created = await createDocument({\n    name: name ?? row.document_name,\n    description: row.description ?? null,\n    organizationId: row.organization_id,\n    projectId: row.project_id ?? null,\n    isPublic: row.visibility === \"public\",\n  });\n  if (!created.success) return created;\n  const latest = await getLatestDocumentSnapshot(documentId);\n  if (!latest.success) return latest;\n  if (latest.data) {\n    const saved = await saveDocumentSnapshot({\n      documentId: created.data.id,\n      snapshot: latest.data.snapshot,\n      label: latest.data.label,\n      origin: \"autosave\",\n    });\n    if (!saved.success) return saved;\n  }\n  return created;\n}\n\n/** Trash view: the caller's own archived documents (RLS decides what is readable). */\nexport async function listTrashedDocuments(): Promise<\n  ServiceResult<DocumentRow[]>\n> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_documents\")\n    .select(\"*\")\n    .not(\"deleted_at\", \"is\", null)\n    .order(\"deleted_at\", { ascending: false });\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? []) as DocumentRow[] };\n}\n\nexport async function listDocumentSnapshots(\n  documentId: string,\n  limit = 50,\n): Promise<ServiceResult<DocumentSnapshot[]>> {\n  const { data, error } = await db()\n    .schema(\"workbench\")\n    .from(\"udt_document_snapshots\")\n    // component-created-by-ok: append-only snapshot with NO updated_by column and NO parent-rewrite trigger — created_by is the author the client wrote at insert (the only person field this table has)\n    .select(\"id, document_id, label, origin, created_by, created_at\")\n    .eq(\"document_id\", documentId)\n    .order(\"created_at\", { ascending: false })\n    .limit(limit);\n  if (error) return { success: false, error: error.message };\n  return { success: true, data: (data ?? []) as DocumentSnapshot[] };\n}\n","/**\n * sanitizeUniverDocSnapshot — defensive normalizer for Univer document\n * snapshots loaded from storage.\n *\n * WHY THIS EXISTS (loud recovery layer):\n * Univer's `NamedStyleType` is a NUMERIC enum (`HEADING_1 = 4`, `HEADING_2 = 5`,\n * …). Some snapshots in storage were produced by an external markdown→Univer\n * converter that wrote the *string* name (`\"HEADING_1\"`) into\n * `paragraphStyle.namedStyleType` instead of the numeric value. At render time\n * Univer does `HEADING_ICON_MAP[namedStyleType]` → `undefined` →\n * `icon.key` throws `Cannot read properties of undefined (reading 'key')` inside\n * the `<ParagraphMenu>` component the moment the cursor lands in a heading. That\n * uncaught error tears down Univer's React root, so the document loads and then\n * vanishes. See `features/data-tables/FEATURE.md`.\n *\n * This normalizer converts those string enum values back to numbers BEFORE the\n * snapshot reaches `createUniverDoc`. It is a recovery layer: when it fires it\n * means malformed data slipped past the writer, so it SCREAMS (console.warn)\n * with a count and the document id. The proper long-term fix is to make the\n * writer emit numeric enum values; until then this keeps the editor alive.\n *\n * Returns the SAME object (mutated in place) for ergonomic call sites, plus a\n * `fixed` count via the second return slot is intentionally avoided — callers\n * only need the sanitized snapshot; the warning is the signal.\n */\nimport { NamedStyleType } from \"@univerjs/core\";\nimport type { IDocumentData } from \"@univerjs/core\";\n\nimport {\n  defaultDocumentPageStyle,\n  isLegacySqueezedPageStyle,\n} from \"../core\";\n\n/**\n * Map of every string name that could appear in a legacy snapshot to its\n * canonical numeric `NamedStyleType`. Built from the enum itself so it stays in\n * lockstep with Univer (numeric enums expose name→value on string keys).\n */\nconst NAMED_STYLE_STRING_TO_NUMBER: Record<string, number> = Object.fromEntries(\n  Object.entries(NamedStyleType)\n    .filter(([key, val]) => typeof val === \"number\" && isNaN(Number(key)))\n    .map(([key, val]) => [key, val as number]),\n);\n\n/**\n * Normalize a Univer document snapshot in place. Currently fixes string-valued\n * `paragraphStyle.namedStyleType` (the confirmed `<ParagraphMenu>` crash). New\n * classes of string-vs-enum corruption should be added here, not patched at the\n * call site.\n *\n * @param snapshot  The snapshot about to be passed to `createUniverDoc`.\n * @param docId     Document id, for the loud warning only.\n * @param opts.quiet The co-editing state hash applies the same repair to compare what a seat will hold\n *                   (`asLoadedDocsSnapshot`); the warning belongs to the load, not to every hash.\n * @returns the same snapshot reference (mutated).\n */\nexport function sanitizeUniverDocSnapshot(\n  snapshot: Partial<IDocumentData>,\n  docId?: string,\n  opts: { quiet?: boolean } = {},\n): Partial<IDocumentData> {\n  restorePageStyle(snapshot, docId, opts.quiet === true);\n  ensureTextRuns(snapshot);\n\n  const paragraphs = snapshot?.body?.paragraphs;\n  if (!Array.isArray(paragraphs)) return snapshot;\n\n  let fixed = 0;\n  for (const paragraph of paragraphs) {\n    const style = paragraph?.paragraphStyle as\n      { namedStyleType?: unknown } | undefined;\n    const value = style?.namedStyleType;\n    if (typeof value === \"string\") {\n      const numeric = NAMED_STYLE_STRING_TO_NUMBER[value];\n      if (numeric !== undefined) {\n        (style as { namedStyleType?: number }).namedStyleType = numeric;\n        fixed += 1;\n      } else {\n        // Unknown string we can't map — drop it so Univer falls back to\n        // NORMAL_TEXT rather than crashing on the lookup.\n        delete (style as { namedStyleType?: unknown }).namedStyleType;\n        fixed += 1;\n      }\n    }\n  }\n\n  if (fixed > 0 && opts.quiet !== true) {\n    console.warn(\n      `[data-tables] RECOVERY: sanitized ${fixed} string namedStyleType value(s) ` +\n        `to numeric NamedStyleType in document snapshot${docId ? ` ${docId}` : \"\"}. ` +\n        `The snapshot was written with the wrong enum encoding (string instead of ` +\n        `number) and would have crashed Univer's <ParagraphMenu>. Fix the snapshot ` +\n        `writer to emit numeric NamedStyleType values.`,\n    );\n  }\n\n  return snapshot;\n}\n\n/**\n * Second recovery: a snapshot with no `documentStyle.pageSize` has no page box,\n * so Univer lays the body out unbounded — text never wraps and the docs\n * viewport reports no scrollable extent, which reads to the user as \"the\n * document won't scroll\". Snapshots written by agents (`origin='agent'`) and by\n * older converters reach storage with `documentStyle: {}`. Stamp the canonical\n * page geometry back on and SCREAM: the writer is the real bug.\n */\nfunction restorePageStyle(snapshot: Partial<IDocumentData>, docId?: string, quiet = false) {\n  if (!snapshot || typeof snapshot !== \"object\") return;\n\n  // THE SQUEEZED PAGE (2026-10-15): documents carried A4-at-72dpi geometry in Univer's pageless\n  // flavour — a 415px text column with no paper. Move them to a real Letter page, unchanged text.\n  // A document with no flavour at all is a paginated page too (Univer would otherwise pick pageless).\n  const style = snapshot.documentStyle;\n  if (style?.pageSize?.width && isLegacySqueezedPageStyle(style)) {\n    const page = defaultDocumentPageStyle();\n    snapshot.documentStyle = { ...style, ...page, defaultParagraphStyle: style.defaultParagraphStyle ?? page.defaultParagraphStyle } as typeof style;\n    return;\n  }\n  if (style?.pageSize?.width) {\n    if (!style.documentFlavor) {\n      const page = defaultDocumentPageStyle();\n      Object.assign(style, { documentFlavor: page.documentFlavor });\n      if (page.defaultParagraphStyle) style.defaultParagraphStyle ??= page.defaultParagraphStyle;\n    }\n    return;\n  }\n\n  snapshot.documentStyle = {\n    ...defaultDocumentPageStyle(),\n    ...(snapshot.documentStyle ?? {}),\n    pageSize: defaultDocumentPageStyle().pageSize,\n  } as NonNullable<typeof snapshot.documentStyle>;\n\n  if (quiet) return;\n  console.warn(\n    `[data-tables] RECOVERY: document snapshot${docId ? ` ${docId}` : \"\"} had no ` +\n      `documentStyle.pageSize — restored the default Letter page geometry. Without a ` +\n      `page box Univer lays the body out unbounded: text does not wrap and the ` +\n      `viewport has no scrollable extent, so the document appears frozen. Fix the ` +\n      `snapshot writer (agent/markdown converters must stamp ` +\n      `DEFAULT_DOCUMENT_PAGE_STYLE).`,\n  );\n}\n\n/**\n * A body with no `textRuns` array is a body Univer silently refuses styled text for: its text\n * insert (`insertTextRuns`) returns early when the target has none, so every bold, italic, code\n * and size run of pasted or agent-written markdown vanished (found 2026-10-16: `**notes**` pasted\n * into a blank document stayed plain). An empty array is the same document and accepts the runs.\n */\nfunction ensureTextRuns(snapshot: Partial<IDocumentData>) {\n  const body = snapshot?.body;\n  if (body && typeof body === \"object\" && !Array.isArray(body.textRuns)) body.textRuns = [];\n}\n"],"mappings":"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","names":["error"]}

package/dist/docs-io.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunkHX5TXQIXcjs = require('./chunk-HX5TXQIX.cjs');
+var _chunkJMVPAJJAcjs = require('./chunk-JMVPAJJA.cjs');
 
 
 
@@ -419,13 +419,13 @@ async function documentFileToMarkdown(file) {
 async function importDocumentFile(file, organizationId) {
   const { markdown, source } = await documentFileToMarkdown(file);
   const name = file.name.replace(/\.[^.]+$/, "").trim() || _chunkXAIKXHHJcjs.deriveDocumentName.call(void 0, markdown);
-  const created = await _chunkHX5TXQIXcjs.createDocument.call(void 0, { name, source, organizationId, description: `Imported from ${file.name}` });
+  const created = await _chunkJMVPAJJAcjs.createDocument.call(void 0, { name, source, organizationId, description: `Imported from ${file.name}` });
   if (!created.success) throw new Error(`Could not create the document: ${created.error}`);
   const id = created.data.id;
-  const snapshot = _chunkHX5TXQIXcjs.sanitizeUniverDocSnapshot.call(void 0, _chunkXAIKXHHJcjs.markdownToUniverDoc.call(void 0, markdown, name), id);
-  const saved = await _chunkHX5TXQIXcjs.saveDocumentSnapshot.call(void 0, { documentId: id, snapshot, origin: "imported", label: `Imported from ${file.name}` });
+  const snapshot = _chunkJMVPAJJAcjs.sanitizeUniverDocSnapshot.call(void 0, _chunkXAIKXHHJcjs.markdownToUniverDoc.call(void 0, markdown, name), id);
+  const saved = await _chunkJMVPAJJAcjs.saveDocumentSnapshot.call(void 0, { documentId: id, snapshot, origin: "imported", label: `Imported from ${file.name}` });
   if (!saved.success) {
-    await _chunkHX5TXQIXcjs.deleteDocument.call(void 0, id);
+    await _chunkJMVPAJJAcjs.deleteDocument.call(void 0, id);
     throw new Error(`Could not save the imported content: ${saved.error}`);
   }
   return { id, name };
@@ -467,7 +467,7 @@ async function downloadOpenFormat(markdown, format, title) {
       const form = new FormData();
       form.append("file", new Blob([docx]), fileName.endsWith(".docx") ? fileName : `${fileName}.docx`);
       form.append("target", target);
-      const res = await _chunkHX5TXQIXcjs.getDocsHost.call(void 0, ).requestRaw("/office/convert-document", { method: "POST", body: form });
+      const res = await _chunkJMVPAJJAcjs.getDocsHost.call(void 0, ).requestRaw("/office/convert-document", { method: "POST", body: form });
       return new Uint8Array(await res.arrayBuffer());
     },
     save: (fileName, bytes, mime) => {

package/dist/docs-io.js

@@ -4,7 +4,7 @@ import {
   getDocsHost,
   sanitizeUniverDocSnapshot,
   saveDocumentSnapshot
-} from "./chunk-2X3KR6Y4.js";
+} from "./chunk-TRA2BTPL.js";
 import {
   deriveDocumentName,
   markdownToUniverDoc

package/dist/docs.cjs

@@ -16,7 +16,7 @@
 
 
 
-var _chunkHX5TXQIXcjs = require('./chunk-HX5TXQIX.cjs');
+var _chunkJMVPAJJAcjs = require('./chunk-JMVPAJJA.cjs');
 
 
 var _chunkNSU6EVJKcjs = require('./chunk-NSU6EVJK.cjs');
@@ -1002,5 +1002,5 @@ var RemoteCaretBook = (_class2 = class {
 
 
 
-exports.CARET_HEARTBEAT_MS = CARET_HEARTBEAT_MS; exports.CARET_MAX_RANGES = CARET_MAX_RANGES; exports.CARET_STALE_MS = CARET_STALE_MS; exports.DOCUMENT_BODY_MAX_LENGTH = DOCUMENT_BODY_MAX_LENGTH; exports.DOCUMENT_DESCRIPTION_MAX_LENGTH = DOCUMENT_DESCRIPTION_MAX_LENGTH; exports.DOCUMENT_NAME_MAX_LENGTH = DOCUMENT_NAME_MAX_LENGTH; exports.DOCUMENT_SAVE_DELAY_MS = DOCUMENT_SAVE_DELAY_MS; exports.DocumentModel = DocumentModel; exports.EMOJI_GROUPS = EMOJI_GROUPS; exports.MIN_FIT_ZOOM = MIN_FIT_ZOOM; exports.RemoteCaretBook = RemoteCaretBook; exports.SPECIAL_GROUPS = SPECIAL_GROUPS; exports.bodyTextOf = bodyTextOf; exports.configureDocsHost = _chunkHX5TXQIXcjs.configureDocsHost; exports.copyDocument = _chunkHX5TXQIXcjs.copyDocument; exports.createDocument = _chunkHX5TXQIXcjs.createDocument; exports.deleteDocument = _chunkHX5TXQIXcjs.deleteDocument; exports.discardFailedDocument = _chunkHX5TXQIXcjs.discardFailedDocument; exports.documentBodyWriteHandler = documentBodyWriteHandler; exports.documentSourceLabel = documentSourceLabel; exports.fitZoomRatio = fitZoomRatio; exports.getDocsHost = _chunkHX5TXQIXcjs.getDocsHost; exports.getDocument = _chunkHX5TXQIXcjs.getDocument; exports.getLatestDocumentSnapshot = _chunkHX5TXQIXcjs.getLatestDocumentSnapshot; exports.listAccessibleDocuments = _chunkHX5TXQIXcjs.listAccessibleDocuments; exports.listDocumentSnapshots = _chunkHX5TXQIXcjs.listDocumentSnapshots; exports.listTrashedDocuments = _chunkHX5TXQIXcjs.listTrashedDocuments; exports.moveDocument = _chunkHX5TXQIXcjs.moveDocument; exports.movePeerRangesThroughBodyEdit = movePeerRangesThroughBodyEdit; exports.moveRangesThroughBodyEdit = moveRangesThroughBodyEdit; exports.planBodyEdit = planBodyEdit; exports.publishedCaretFromSelection = publishedCaretFromSelection; exports.renameDocument = _chunkHX5TXQIXcjs.renameDocument; exports.restoreDocument = _chunkHX5TXQIXcjs.restoreDocument; exports.sanitizeUniverDocSnapshot = _chunkHX5TXQIXcjs.sanitizeUniverDocSnapshot; exports.saveDocumentSnapshot = _chunkHX5TXQIXcjs.saveDocumentSnapshot; exports.searchSymbols = searchSymbols; exports.updateDocumentDescription = _chunkHX5TXQIXcjs.updateDocumentDescription; exports.validateDocumentBody = validateDocumentBody; exports.validateDocumentDescription = validateDocumentDescription; exports.validateDocumentName = validateDocumentName; exports.writeBodyText = writeBodyText;
+exports.CARET_HEARTBEAT_MS = CARET_HEARTBEAT_MS; exports.CARET_MAX_RANGES = CARET_MAX_RANGES; exports.CARET_STALE_MS = CARET_STALE_MS; exports.DOCUMENT_BODY_MAX_LENGTH = DOCUMENT_BODY_MAX_LENGTH; exports.DOCUMENT_DESCRIPTION_MAX_LENGTH = DOCUMENT_DESCRIPTION_MAX_LENGTH; exports.DOCUMENT_NAME_MAX_LENGTH = DOCUMENT_NAME_MAX_LENGTH; exports.DOCUMENT_SAVE_DELAY_MS = DOCUMENT_SAVE_DELAY_MS; exports.DocumentModel = DocumentModel; exports.EMOJI_GROUPS = EMOJI_GROUPS; exports.MIN_FIT_ZOOM = MIN_FIT_ZOOM; exports.RemoteCaretBook = RemoteCaretBook; exports.SPECIAL_GROUPS = SPECIAL_GROUPS; exports.bodyTextOf = bodyTextOf; exports.configureDocsHost = _chunkJMVPAJJAcjs.configureDocsHost; exports.copyDocument = _chunkJMVPAJJAcjs.copyDocument; exports.createDocument = _chunkJMVPAJJAcjs.createDocument; exports.deleteDocument = _chunkJMVPAJJAcjs.deleteDocument; exports.discardFailedDocument = _chunkJMVPAJJAcjs.discardFailedDocument; exports.documentBodyWriteHandler = documentBodyWriteHandler; exports.documentSourceLabel = documentSourceLabel; exports.fitZoomRatio = fitZoomRatio; exports.getDocsHost = _chunkJMVPAJJAcjs.getDocsHost; exports.getDocument = _chunkJMVPAJJAcjs.getDocument; exports.getLatestDocumentSnapshot = _chunkJMVPAJJAcjs.getLatestDocumentSnapshot; exports.listAccessibleDocuments = _chunkJMVPAJJAcjs.listAccessibleDocuments; exports.listDocumentSnapshots = _chunkJMVPAJJAcjs.listDocumentSnapshots; exports.listTrashedDocuments = _chunkJMVPAJJAcjs.listTrashedDocuments; exports.moveDocument = _chunkJMVPAJJAcjs.moveDocument; exports.movePeerRangesThroughBodyEdit = movePeerRangesThroughBodyEdit; exports.moveRangesThroughBodyEdit = moveRangesThroughBodyEdit; exports.planBodyEdit = planBodyEdit; exports.publishedCaretFromSelection = publishedCaretFromSelection; exports.renameDocument = _chunkJMVPAJJAcjs.renameDocument; exports.restoreDocument = _chunkJMVPAJJAcjs.restoreDocument; exports.sanitizeUniverDocSnapshot = _chunkJMVPAJJAcjs.sanitizeUniverDocSnapshot; exports.saveDocumentSnapshot = _chunkJMVPAJJAcjs.saveDocumentSnapshot; exports.searchSymbols = searchSymbols; exports.updateDocumentDescription = _chunkJMVPAJJAcjs.updateDocumentDescription; exports.validateDocumentBody = validateDocumentBody; exports.validateDocumentDescription = validateDocumentDescription; exports.validateDocumentName = validateDocumentName; exports.writeBodyText = writeBodyText;
 //# sourceMappingURL=docs.cjs.map

package/dist/docs.d.cts

@@ -657,9 +657,13 @@ declare function validateDocumentDescription(value: unknown): string | null;
  *
  * @param snapshot  The snapshot about to be passed to `createUniverDoc`.
  * @param docId     Document id, for the loud warning only.
+ * @param opts.quiet The co-editing state hash applies the same repair to compare what a seat will hold
+ *                   (`asLoadedDocsSnapshot`); the warning belongs to the load, not to every hash.
  * @returns the same snapshot reference (mutated).
  */
-declare function sanitizeUniverDocSnapshot(snapshot: Partial<IDocumentData>, docId?: string): Partial<IDocumentData>;
+declare function sanitizeUniverDocSnapshot(snapshot: Partial<IDocumentData>, docId?: string, opts?: {
+    quiet?: boolean;
+}): Partial<IDocumentData>;
 
 /**
  * The zoom that fits a document page inside a narrow editor (a phone), so the

package/dist/docs.d.ts

@@ -657,9 +657,13 @@ declare function validateDocumentDescription(value: unknown): string | null;
  *
  * @param snapshot  The snapshot about to be passed to `createUniverDoc`.
  * @param docId     Document id, for the loud warning only.
+ * @param opts.quiet The co-editing state hash applies the same repair to compare what a seat will hold
+ *                   (`asLoadedDocsSnapshot`); the warning belongs to the load, not to every hash.
  * @returns the same snapshot reference (mutated).
  */
-declare function sanitizeUniverDocSnapshot(snapshot: Partial<IDocumentData>, docId?: string): Partial<IDocumentData>;
+declare function sanitizeUniverDocSnapshot(snapshot: Partial<IDocumentData>, docId?: string, opts?: {
+    quiet?: boolean;
+}): Partial<IDocumentData>;
 
 /**
  * The zoom that fits a document page inside a narrow editor (a phone), so the

package/dist/docs.js

@@ -16,7 +16,7 @@ import {
   sanitizeUniverDocSnapshot,
   saveDocumentSnapshot,
   updateDocumentDescription
-} from "./chunk-2X3KR6Y4.js";
+} from "./chunk-TRA2BTPL.js";
 import {
   looksLikeMarkdown
 } from "./chunk-DY5TGHBI.js";