@agent-native/core 0.43.0 → 0.44.1

package/dist/client/rich-markdown-editor/useCollabReconcile.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCollabReconcile.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/useCollabReconcile.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState, type MutableRefObject } from \"react\";\nimport type { Editor } from \"@tiptap/react\";\nimport type { Transaction } from \"@tiptap/pm/state\";\nimport { isChangeOrigin } from \"@tiptap/extension-collaboration\";\nimport type { Doc as YDoc } from \"yjs\";\nimport type { Awareness } from \"y-protocols/awareness\";\nimport { isReconcileLeadClient } from \"../../collab/client.js\";\nimport { AGENT_CLIENT_ID } from \"../../collab/agent-identity.js\";\n\nexport const RICH_MARKDOWN_PROGRAMMATIC_TRANSACTION =\n  \"an-rich-md-programmatic-transaction\";\n\n/** Reads the current markdown out of the tiptap-markdown storage. */\nexport function getEditorMarkdown(editor: Editor): string {\n  const markdownStorage = editor.storage as unknown as {\n    markdown?: { getMarkdown?: () => string };\n  };\n  return markdownStorage.markdown?.getMarkdown?.() ?? \"\";\n}\n\n/**\n * Push a value onto the bounded ring of recently-emitted markdown (most recent\n * last, deduped, capped). The reconcile uses this to recognize a stale-but-recent\n * echo of OUR OWN edits: a debounced autosave can persist a PARTIAL burst, and\n * the next poll re-supplies that partial value with a newer timestamp — applying\n * it would clobber the freshly-typed tail. An external change (agent/peer) never\n * byte-matches one of our own recent emissions, and if it somehow did the content\n * is identical, so skipping it is safe by construction.\n */\nconst EMITTED_RING_MAX = 16;\nfunction pushEmittedRing(ring: string[], value: string): void {\n  if (!value) return;\n  if (ring[ring.length - 1] === value) return;\n  const dupe = ring.indexOf(value);\n  if (dupe !== -1) ring.splice(dupe, 1);\n  ring.push(value);\n  if (ring.length > EMITTED_RING_MAX) ring.shift();\n}\n\nexport interface UseCollabReconcileOptions {\n  /** The live editor, or null until it mounts. */\n  editor: Editor | null;\n  /** Shared Y.Doc when collaborating; null disables all collab paths. */\n  ydoc?: YDoc | null;\n  /** Shared awareness; null keeps the sole-client lead path. */\n  awareness?: Awareness | null;\n  /** Authoritative markdown value (SQL source of truth). */\n  value: string;\n  /** Timestamp of the authoritative value; gates newer-than reconcile. */\n  contentUpdatedAt?: string | null;\n  /** Whether the editor accepts edits. Reconcile/seed only run for the live editor. */\n  editable: boolean;\n  /**\n   * Reads the current markdown from the editor. Injected so a dialect could\n   * swap serializers; defaults to the tiptap-markdown storage reader. For an app\n   * with a custom serializer (e.g. Content's `docToNfm(editor.getJSON())`), pass\n   * it here so the seed/reconcile equality checks compare like-for-like.\n   */\n  getMarkdown?: (editor: Editor) => string;\n  /**\n   * Applies the authoritative `value` into the editor. Defaults to passing the\n   * raw markdown string to `editor.commands.setContent`. Apps whose serializer\n   * is NOT tiptap-markdown (Content parses `nfmToDoc(value)` into a PM doc)\n   * override this so seed + reconcile write the correct content shape. The\n   * supplied `options` carry the history/whitespace flags the default path uses;\n   * a custom implementation should forward them when relevant.\n   */\n  setContent?: (\n    editor: Editor,\n    value: string,\n    options: { emitUpdate?: boolean; addToHistory?: boolean },\n  ) => void;\n  /**\n   * Normalizes the authoritative `value` to the canonical markdown the editor\n   * would emit, so the \"already in sync / our own echo\" equality checks match a\n   * serializer that re-canonicalizes (Content's `canonicalizeNfm`). Defaults to\n   * identity (GFM already round-trips byte-stably).\n   */\n  normalizeValue?: (value: string) => string;\n  /**\n   * Decides whether the empty-doc seed should run for the current shared\n   * fragment. Defaults to \"fragment has no nodes, or the editor holds no\n   * semantic markdown\". Apps with sentinel-empty content (Content's\n   * `<empty-block/>` filler) override this. Receives the live fragment length\n   * and the editor's current markdown.\n   */\n  shouldSeed?: (info: {\n    value: string;\n    currentMarkdown: string;\n    fragmentLength: number;\n  }) => boolean;\n  /**\n   * The initial \"applied\" watermark. Default mirrors `contentUpdatedAt`, so a\n   * fresh mount whose Y.Doc already matches SQL doesn't re-apply. Pass `null`\n   * to force the first reconcile pass to adopt authoritative SQL even at the\n   * same timestamp — Content does this so a stale persisted Y.Doc (an agent that\n   * edited the CLOSED doc) is corrected on open. The editor is keyed per\n   * document upstream, so this only affects the first mount of each doc.\n   */\n  initialAppliedUpdatedAt?: string | null;\n}\n\nexport interface UseCollabReconcileResult {\n  /** True when a Y.Doc is bound (collaborative editing active). */\n  collab: boolean;\n  /**\n   * Set true around any programmatic `setContent` so the editor's `onUpdate`\n   * can ignore the resulting transaction (it isn't a user edit).\n   */\n  isSettingContentRef: MutableRefObject<boolean>;\n  /**\n   * Call from `onUpdate` BEFORE serializing. Returns true when the update must\n   * be ignored: editor not editable, mid-programmatic-setContent, or (in collab\n   * mode) a remote-origin transaction. Also records the local typing time.\n   */\n  shouldIgnoreUpdate: (transaction: Transaction) => boolean;\n  /**\n   * Call from `onUpdate` AFTER computing the markdown to emit. Returns false\n   * when the value must NOT be persisted yet (an empty collab doc before the\n   * seed has run); records it as the last-emitted value otherwise.\n   */\n  registerEmitted: (markdown: string) => boolean;\n}\n\n/**\n * The subtle seed / reconcile / lead-client logic for the shared markdown\n * editor, extracted once so it can never be duplicated across embedders.\n *\n * Responsibilities (reproducing the Plan editor's behavior exactly):\n *  - Track whether THIS client is the reconcile lead (sole client always leads;\n *    otherwise elected via {@link isReconcileLeadClient}) and how many other\n *    visible human peers are present.\n *  - Seed an empty shared Y.Doc once from `value` — lead client only — so two\n *    clients opening a brand-new block don't both insert the content.\n *  - Reconcile authoritative external markdown (agent edit, source patch, peer\n *    edit mirrored to SQL) into the editor: in collab mode only the lead client\n *    applies it through `setContent` and Yjs propagates; in non-collab mode this\n *    is the original controlled-value reconcile.\n *  - Provide the `onUpdate` guards (`shouldIgnoreUpdate`, `registerEmitted`) so\n *    the component never persists remote-origin or pre-seed empty content.\n */\n/** Default seed predicate: seed only when the shared doc is genuinely empty. */\nfunction defaultShouldSeed({\n  currentMarkdown,\n  fragmentLength,\n}: {\n  value: string;\n  currentMarkdown: string;\n  fragmentLength: number;\n}): boolean {\n  return fragmentLength === 0 || !currentMarkdown.trim();\n}\n\n/**\n * Default content writer: hand the raw markdown string to `setContent`, which\n * tiptap-markdown overrides to parse the markdown into a ProseMirror doc.\n *\n * IMPORTANT: do NOT pass `parseOptions: { preserveWhitespace: \"full\" }` here.\n * In tiptap v3 the core `setContent` command routes `preserveWhitespace: \"full\"`\n * through `insertContentAt`, which tiptap-markdown ALSO overrides to re-run its\n * markdown parser. That double-parse stringifies the already-parsed PM doc and\n * re-parses it as HTML, so a clean heading/list/code block comes back as the\n * escaped, non-idempotent `&lt;h1&gt;…` — which then escalates every reconcile\n * cycle (`<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` …). Letting the markdown\n * override parse the string directly (no `parseOptions`) round-trips byte-stably\n * for the GFM corpus, including code-block and empty-line whitespace. Content's\n * NFM path supplies its own `setContent` (it passes a pre-parsed PM doc) and is\n * unaffected by this default.\n */\nfunction defaultSetContent(\n  editor: Editor,\n  value: string,\n  options: { emitUpdate?: boolean; addToHistory?: boolean },\n): void {\n  if (options.addToHistory === false) {\n    editor\n      .chain()\n      .command(({ tr }) => {\n        // addToHistory:false so cmd+z (or Yjs undo) doesn't erase\n        // externally-loaded content.\n        tr.setMeta(\"addToHistory\", false);\n        return true;\n      })\n      .setContent(value, { emitUpdate: options.emitUpdate })\n      .run();\n    return;\n  }\n  editor.commands.setContent(value);\n}\n\nexport function useCollabReconcile({\n  editor,\n  ydoc = null,\n  awareness = null,\n  value,\n  contentUpdatedAt,\n  editable,\n  getMarkdown = getEditorMarkdown,\n  setContent = defaultSetContent,\n  normalizeValue = (v) => v,\n  shouldSeed = defaultShouldSeed,\n  initialAppliedUpdatedAt,\n}: UseCollabReconcileOptions): UseCollabReconcileResult {\n  const collab = !!ydoc;\n  const isSettingContentRef = useRef(false);\n  const lastEmittedRef = useRef(\"\");\n  // Ring of recent local emissions (see pushEmittedRing). Lets the reconcile\n  // recognize a stale-but-recent echo of our OWN (possibly partial, debounced)\n  // save so a lagging poll never clobbers freshly-typed text.\n  const recentEmittedRef = useRef<string[]>([]);\n  const lastTypedAtRef = useRef(0);\n  // The raw authoritative `value` string the reconcile last applied. When the\n  // SAME raw string is re-fetched (a lagging poll, or a source-sync that keeps\n  // re-supplying the same stored markdown), applying it again would only\n  // reproduce the doc we already hold — and if `value` is NON-idempotent\n  // (serialize(parse(value)) !== value) re-applying compounds the divergence\n  // every cycle (`<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` …). Tracked so the\n  // identical re-fetch is recognized and skipped.\n  const lastAppliedValueRef = useRef<string | null>(null);\n  // The editor's SERIALIZED output captured right AFTER the last reconcile/seed\n  // apply (`getMarkdown(editor)` once the content settled). For non-idempotent\n  // input this is what autosave actually persists, so the NEXT poll hands it\n  // back as the new `value`. Comparing the incoming value against this lets the\n  // reconcile recognize its own echo even when the raw string changed once, so\n  // it never re-parses content the editor already represents. This is the\n  // doc-equivalence guard that breaks the escalation loop.\n  const lastAppliedSerializedRef = useRef<string | null>(null);\n  const lastAppliedUpdatedAtRef = useRef<string | null>(\n    initialAppliedUpdatedAt !== undefined\n      ? initialAppliedUpdatedAt\n      : (contentUpdatedAt ?? null),\n  );\n\n  // Whether THIS client is the one that seeds the empty shared doc / applies an\n  // authoritative external snapshot into it. Exactly one client does, so the\n  // content isn't inserted once per open editor. A sole client always leads.\n  const [isLeadClient, setIsLeadClient] = useState(true);\n  // Count of OTHER visible human collaborators. When >0, a peer's edit also\n  // arrives via Yjs, so external markdown reconcile must defer (avoid applying\n  // the same change through both Yjs and setContent).\n  const peerCountRef = useRef(0);\n  useEffect(() => {\n    if (!collab || !awareness || !ydoc) {\n      setIsLeadClient(true);\n      peerCountRef.current = 0;\n      return;\n    }\n    const update = () => {\n      setIsLeadClient(isReconcileLeadClient(awareness, ydoc.clientID));\n      let peers = 0;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc.clientID) return; // self\n        if (clientId === AGENT_CLIENT_ID) return; // agent isn't a Yjs editor\n        const s = state as { user?: unknown; visible?: boolean };\n        if (s && s.user && s.visible !== false) peers += 1;\n      });\n      peerCountRef.current = peers;\n    };\n    update();\n    awareness.on(\"change\", update);\n    document.addEventListener(\"visibilitychange\", update);\n    return () => {\n      awareness.off(\"change\", update);\n      document.removeEventListener(\"visibilitychange\", update);\n    };\n  }, [collab, awareness, ydoc]);\n\n  // Collab seed: populate an empty shared Y.Doc from the markdown `value` once.\n  // The Collaboration extension does NOT auto-seed; only the lead client does,\n  // so two clients opening a brand-new block at once don't both seed (which\n  // would duplicate the content via concurrent inserts at the same position).\n  const seededRef = useRef(false);\n  useEffect(() => {\n    if (!collab || !editor || editor.isDestroyed || !ydoc) return;\n    if (seededRef.current) return;\n    if (!isLeadClient) return;\n    if (!value.trim()) return;\n    const fragment = ydoc.getXmlFragment(\"default\");\n    const currentMarkdown = getMarkdown(editor);\n    // Seed only when the shared doc is genuinely empty — either the fragment has\n    // no nodes yet, or it holds no semantic markdown (an empty paragraph, or an\n    // app's sentinel-empty filler via a custom `shouldSeed`).\n    if (\n      shouldSeed({ value, currentMarkdown, fragmentLength: fragment.length })\n    ) {\n      isSettingContentRef.current = true;\n      setContent(editor, value, {});\n      isSettingContentRef.current = false;\n      const serialized = getMarkdown(editor);\n      lastEmittedRef.current = serialized;\n      pushEmittedRing(recentEmittedRef.current, serialized);\n      lastAppliedValueRef.current = value;\n      lastAppliedSerializedRef.current = serialized;\n      if (contentUpdatedAt) lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n    }\n    seededRef.current = true;\n  }, [\n    collab,\n    editor,\n    ydoc,\n    value,\n    isLeadClient,\n    contentUpdatedAt,\n    getMarkdown,\n    setContent,\n    shouldSeed,\n  ]);\n\n  // Reconcile authoritative external markdown (agent edit, source patch, or a\n  // peer edit mirrored to SQL) into the live editor. In collab mode only the\n  // lead client applies it through setContent; Yjs propagates the result to\n  // every other client. In non-collab mode this is the original controlled-value\n  // reconcile, unchanged.\n  useEffect(() => {\n    if (!editor || editor.isDestroyed) return;\n\n    let cancelled = false;\n    let retry: ReturnType<typeof setTimeout> | null = null;\n    // With peers present, a peer's edit also arrives via Yjs. Defer one poll\n    // cycle (+margin) and re-check before applying via setContent so the same\n    // change isn't inserted twice (Yjs + setContent → duplicated region).\n    const PEER_SETTLE_MS = 2500;\n\n    const apply = (deferred = false) => {\n      if (cancelled || editor.isDestroyed) return;\n      // In collab mode, defer all reconcile until the shared doc is seeded so we\n      // never setContent over an unseeded fragment.\n      if (collab && !seededRef.current) {\n        retry = setTimeout(() => apply(deferred), 300);\n        return;\n      }\n      const currentMarkdown = getMarkdown(editor);\n      // Compare against the canonical form the editor would emit so a serializer\n      // that re-normalizes (Content's NFM) still recognizes \"already in sync\".\n      const normalizedValue = normalizeValue(value);\n      // Whether the editor still holds exactly what THIS hook last applied (the\n      // user hasn't edited since). Only then are the round-trip echo guards\n      // below safe: if the user has since edited away from the applied content,\n      // an external snapshot equal to a previously-applied value is a real\n      // revert and must NOT be swallowed as an echo.\n      const editorUnchangedSinceApply =\n        lastAppliedSerializedRef.current !== null &&\n        currentMarkdown === lastAppliedSerializedRef.current;\n\n      // Doc-equivalence skip. Never re-apply content the editor already\n      // represents — comparing by DOC EQUIVALENCE, not raw strings/timestamps:\n      //   1. `currentMarkdown === normalizedValue` — the editor's CURRENT\n      //      serialized doc already equals the (normalized) incoming value.\n      //   2. `value === lastEmittedRef.current` — the incoming value is our own\n      //      just-emitted markdown echoing back.\n      //   3. `value === lastAppliedValueRef.current` — the SAME raw value we\n      //      already applied is being re-supplied (a lagging poll or a\n      //      source-sync re-handing the same stored markdown). Applying it again\n      //      would only reproduce the doc we hold; for NON-idempotent input it\n      //      would compound divergence. Guarded by `editorUnchangedSinceApply`\n      //      so a deliberate revert-to-previous after a local edit still lands.\n      //   4. `normalizedValue === lastAppliedSerializedRef.current` — the\n      //      incoming value round-trips to the serialized output we last\n      //      produced (our own autosaved echo coming back from SQL). For\n      //      non-idempotent input the raw string differs from what we were\n      //      handed, but it is doc-equivalent to what the editor already shows,\n      //      so re-parsing it must be skipped. This is the guard that stops the\n      //      `<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` escalation.\n      if (\n        currentMarkdown === normalizedValue ||\n        value === lastEmittedRef.current ||\n        // A stale-but-recent echo of our own (possibly partial) save — applying\n        // it would clobber the freshly-typed tail. External edits never match.\n        recentEmittedRef.current.includes(value) ||\n        recentEmittedRef.current.includes(normalizedValue) ||\n        (editorUnchangedSinceApply &&\n          (value === lastAppliedValueRef.current ||\n            normalizedValue === lastAppliedSerializedRef.current))\n      ) {\n        if (contentUpdatedAt) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n        return;\n      }\n\n      const externalNewer =\n        !lastAppliedUpdatedAtRef.current ||\n        !contentUpdatedAt ||\n        contentUpdatedAt > lastAppliedUpdatedAtRef.current;\n\n      // Only the lead client applies an authoritative snapshot into the shared\n      // Y.Doc; peers receive it through Yjs sync.\n      if (collab && !isLeadClient) {\n        if (contentUpdatedAt && !externalNewer) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n        return;\n      }\n\n      // Never clobber an in-progress edit. While the user is actively typing\n      // (focused and a keystroke landed within the window) defer and re-check —\n      // applying external content now would yank text out from under them and,\n      // for non-idempotent input, fight every keystroke. Newer external content\n      // retries so it still lands once they pause; older-or-equal content is a\n      // stale poll and is dropped outright while focused.\n      const typingRecently =\n        editor.isFocused && Date.now() - lastTypedAtRef.current < 1500;\n      if (typingRecently) {\n        if (externalNewer) {\n          retry = setTimeout(() => apply(deferred), 700);\n        }\n        return;\n      }\n      if (!externalNewer && editor.isFocused) return;\n\n      // Race guard: with peers present, let Yjs deliver a peer's edit first.\n      // Defer once and re-check — a peer edit makes the equality check above\n      // no-op next pass; an agent/source edit still differs and applies.\n      if (collab && externalNewer && !deferred && peerCountRef.current > 0) {\n        retry = setTimeout(() => apply(true), PEER_SETTLE_MS);\n        return;\n      }\n\n      queueMicrotask(() => {\n        if (cancelled || editor.isDestroyed) return;\n        // Re-check doc-equivalence at apply time. Between the decision above and\n        // this microtask a peer/Yjs edit (or our own prior apply) may have made\n        // the editor already represent this value — re-applying would be a\n        // wasted setContent that, for non-idempotent input, re-triggers the\n        // loop. Skip when the editor's current serialization already matches the\n        // normalized value, or the value round-trips to what we last produced.\n        const beforeMarkdown = getMarkdown(editor);\n        const normalized = normalizeValue(value);\n        const unchangedSinceApply =\n          lastAppliedSerializedRef.current !== null &&\n          beforeMarkdown === lastAppliedSerializedRef.current;\n        if (\n          beforeMarkdown === normalized ||\n          (unchangedSinceApply &&\n            normalized === lastAppliedSerializedRef.current)\n        ) {\n          lastAppliedValueRef.current = value;\n          if (contentUpdatedAt) {\n            lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n          }\n          return;\n        }\n        isSettingContentRef.current = true;\n        setContent(editor, value, { emitUpdate: false, addToHistory: false });\n        isSettingContentRef.current = false;\n        // Capture the SERIALIZED result, not the raw value. For non-idempotent\n        // input these differ; recording the serialized output is what lets the\n        // next poll (which returns this serialized form) be recognized as our\n        // own echo and skipped — stabilizing the doc after exactly one apply.\n        const serialized = getMarkdown(editor);\n        lastEmittedRef.current = serialized;\n        pushEmittedRing(recentEmittedRef.current, serialized);\n        lastAppliedValueRef.current = value;\n        lastAppliedSerializedRef.current = serialized;\n        if (contentUpdatedAt) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n      });\n    };\n\n    apply();\n    return () => {\n      cancelled = true;\n      if (retry) clearTimeout(retry);\n    };\n  }, [\n    contentUpdatedAt,\n    editor,\n    value,\n    collab,\n    isLeadClient,\n    getMarkdown,\n    setContent,\n    normalizeValue,\n  ]);\n\n  const shouldIgnoreUpdate = (transaction: Transaction): boolean => {\n    if (!editable || isSettingContentRef.current) return true;\n    if (transaction.getMeta(RICH_MARKDOWN_PROGRAMMATIC_TRANSACTION)) {\n      return true;\n    }\n    // In collab mode, never persist remote-originated changes (the initial Yjs\n    // state load or a peer's edit arriving via sync). Each client saves only its\n    // OWN local edits; a peer's edit is saved by that peer. Without this, a\n    // lagging Y.Doc load would write stale markdown over newer SQL.\n    if (collab && transaction && isChangeOrigin(transaction)) return true;\n    lastTypedAtRef.current = Date.now();\n    return false;\n  };\n\n  const registerEmitted = (markdown: string): boolean => {\n    // Don't persist an empty doc before Collaboration has seeded — that would\n    // clobber the saved block content with an empty string.\n    if (collab && !markdown.trim()) return false;\n    lastEmittedRef.current = markdown;\n    pushEmittedRing(recentEmittedRef.current, markdown);\n    return true;\n  };\n\n  return {\n    collab,\n    isSettingContentRef,\n    shouldIgnoreUpdate,\n    registerEmitted,\n  };\n}\n"]}
+{"version":3,"file":"useCollabReconcile.js","sourceRoot":"","sources":["../../../src/client/rich-markdown-editor/useCollabReconcile.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState, type MutableRefObject } from \"react\";\nimport type { Editor } from \"@tiptap/react\";\nimport type { Transaction } from \"@tiptap/pm/state\";\nimport { isChangeOrigin } from \"@tiptap/extension-collaboration\";\nimport type { Doc as YDoc } from \"yjs\";\nimport type { Awareness } from \"y-protocols/awareness\";\nimport { isReconcileLeadClient } from \"../../collab/client.js\";\nimport { AGENT_CLIENT_ID } from \"../../collab/agent-identity.js\";\n\nexport const RICH_MARKDOWN_PROGRAMMATIC_TRANSACTION =\n  \"an-rich-md-programmatic-transaction\";\n\n/** Reads the current markdown out of the tiptap-markdown storage. */\nexport function getEditorMarkdown(editor: Editor): string {\n  const markdownStorage = editor.storage as unknown as {\n    markdown?: { getMarkdown?: () => string };\n  };\n  return markdownStorage.markdown?.getMarkdown?.() ?? \"\";\n}\n\n/**\n * Push a value onto the bounded ring of recently-emitted markdown (most recent\n * last, deduped, capped). The reconcile uses this to recognize a stale-but-recent\n * echo of OUR OWN edits: a debounced autosave can persist a PARTIAL burst, and\n * the next poll re-supplies that partial value with a newer timestamp — applying\n * it would clobber the freshly-typed tail. An external change (agent/peer) never\n * byte-matches one of our own recent emissions, and if it somehow did the content\n * is identical, so skipping it is safe by construction.\n */\nconst EMITTED_RING_MAX = 16;\nfunction pushEmittedRing(ring: string[], value: string): void {\n  if (!value) return;\n  if (ring[ring.length - 1] === value) return;\n  const dupe = ring.indexOf(value);\n  if (dupe !== -1) ring.splice(dupe, 1);\n  ring.push(value);\n  if (ring.length > EMITTED_RING_MAX) ring.shift();\n}\n\nexport interface UseCollabReconcileOptions {\n  /** The live editor, or null until it mounts. */\n  editor: Editor | null;\n  /** Shared Y.Doc when collaborating; null disables all collab paths. */\n  ydoc?: YDoc | null;\n  /** Shared awareness; null keeps the sole-client lead path. */\n  awareness?: Awareness | null;\n  /** Authoritative markdown value (SQL source of truth). */\n  value: string;\n  /** Timestamp of the authoritative value; gates newer-than reconcile. */\n  contentUpdatedAt?: string | null;\n  /** Whether the editor accepts edits. Reconcile/seed only run for the live editor. */\n  editable: boolean;\n  /**\n   * Reads the current markdown from the editor. Injected so a dialect could\n   * swap serializers; defaults to the tiptap-markdown storage reader. For an app\n   * with a custom serializer (e.g. Content's `docToNfm(editor.getJSON())`), pass\n   * it here so the seed/reconcile equality checks compare like-for-like.\n   */\n  getMarkdown?: (editor: Editor) => string;\n  /**\n   * Applies the authoritative `value` into the editor. Defaults to passing the\n   * raw markdown string to `editor.commands.setContent`. Apps whose serializer\n   * is NOT tiptap-markdown (Content parses `nfmToDoc(value)` into a PM doc)\n   * override this so seed + reconcile write the correct content shape. The\n   * supplied `options` carry the history/whitespace flags the default path uses;\n   * a custom implementation should forward them when relevant.\n   */\n  setContent?: (\n    editor: Editor,\n    value: string,\n    options: { emitUpdate?: boolean; addToHistory?: boolean },\n  ) => void;\n  /**\n   * Normalizes the authoritative `value` to the canonical markdown the editor\n   * would emit, so the \"already in sync / our own echo\" equality checks match a\n   * serializer that re-canonicalizes (Content's `canonicalizeNfm`). Defaults to\n   * identity (GFM already round-trips byte-stably).\n   */\n  normalizeValue?: (value: string) => string;\n  /**\n   * Decides whether the empty-doc seed should run for the current shared\n   * fragment. Defaults to \"fragment has no nodes, or the editor holds no\n   * semantic markdown\". Apps with sentinel-empty content (Content's\n   * `<empty-block/>` filler) override this. Receives the live fragment length\n   * and the editor's current markdown.\n   */\n  shouldSeed?: (info: {\n    value: string;\n    currentMarkdown: string;\n    fragmentLength: number;\n  }) => boolean;\n  /**\n   * The initial \"applied\" watermark. Default mirrors `contentUpdatedAt`, so a\n   * fresh mount whose Y.Doc already matches SQL doesn't re-apply. Pass `null`\n   * to force the first reconcile pass to adopt authoritative SQL even at the\n   * same timestamp — Content does this so a stale persisted Y.Doc (an agent that\n   * edited the CLOSED doc) is corrected on open. The editor is keyed per\n   * document upstream, so this only affects the first mount of each doc.\n   */\n  initialAppliedUpdatedAt?: string | null;\n}\n\nexport interface UseCollabReconcileResult {\n  /** True when a Y.Doc is bound (collaborative editing active). */\n  collab: boolean;\n  /**\n   * Set true around any programmatic `setContent` so the editor's `onUpdate`\n   * can ignore the resulting transaction (it isn't a user edit).\n   */\n  isSettingContentRef: MutableRefObject<boolean>;\n  /**\n   * Call from `onUpdate` BEFORE serializing. Returns true when the update must\n   * be ignored: editor not editable, mid-programmatic-setContent, or (in collab\n   * mode) a remote-origin transaction. Also records the local typing time.\n   */\n  shouldIgnoreUpdate: (transaction: Transaction) => boolean;\n  /**\n   * Call from `onUpdate` AFTER computing the markdown to emit. Returns false\n   * when the value must NOT be persisted yet (an empty collab doc before the\n   * seed has run); records it as the last-emitted value otherwise.\n   */\n  registerEmitted: (markdown: string) => boolean;\n}\n\n/**\n * The subtle seed / reconcile / lead-client logic for the shared markdown\n * editor, extracted once so it can never be duplicated across embedders.\n *\n * Responsibilities (reproducing the Plan editor's behavior exactly):\n *  - Track whether THIS client is the reconcile lead (sole client always leads;\n *    otherwise elected via {@link isReconcileLeadClient}) and how many other\n *    visible human peers are present.\n *  - Seed an empty shared Y.Doc once from `value` — lead client only — so two\n *    clients opening a brand-new block don't both insert the content.\n *  - Reconcile authoritative external markdown (agent edit, source patch, peer\n *    edit mirrored to SQL) into the editor: in collab mode only the lead client\n *    applies it through `setContent` and Yjs propagates; in non-collab mode this\n *    is the original controlled-value reconcile.\n *  - Provide the `onUpdate` guards (`shouldIgnoreUpdate`, `registerEmitted`) so\n *    the component never persists remote-origin or pre-seed empty content.\n */\n/** Default seed predicate: seed only when the shared doc is genuinely empty. */\nfunction defaultShouldSeed({\n  currentMarkdown,\n  fragmentLength,\n}: {\n  value: string;\n  currentMarkdown: string;\n  fragmentLength: number;\n}): boolean {\n  return fragmentLength === 0 || !currentMarkdown.trim();\n}\n\n/**\n * Default content writer: hand the raw markdown string to `setContent`, which\n * tiptap-markdown overrides to parse the markdown into a ProseMirror doc.\n *\n * IMPORTANT: do NOT pass `parseOptions: { preserveWhitespace: \"full\" }` here.\n * In tiptap v3 the core `setContent` command routes `preserveWhitespace: \"full\"`\n * through `insertContentAt`, which tiptap-markdown ALSO overrides to re-run its\n * markdown parser. That double-parse stringifies the already-parsed PM doc and\n * re-parses it as HTML, so a clean heading/list/code block comes back as the\n * escaped, non-idempotent `&lt;h1&gt;…` — which then escalates every reconcile\n * cycle (`<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` …). Letting the markdown\n * override parse the string directly (no `parseOptions`) round-trips byte-stably\n * for the GFM corpus, including code-block and empty-line whitespace. Content's\n * NFM path supplies its own `setContent` (it passes a pre-parsed PM doc) and is\n * unaffected by this default.\n */\nfunction defaultSetContent(\n  editor: Editor,\n  value: string,\n  options: { emitUpdate?: boolean; addToHistory?: boolean },\n): void {\n  if (options.addToHistory === false) {\n    editor\n      .chain()\n      .command(({ tr }) => {\n        // addToHistory:false so cmd+z (or Yjs undo) doesn't erase\n        // externally-loaded content.\n        tr.setMeta(\"addToHistory\", false);\n        return true;\n      })\n      .setContent(value, { emitUpdate: options.emitUpdate })\n      .run();\n    return;\n  }\n  editor.commands.setContent(value);\n}\n\nexport function useCollabReconcile({\n  editor,\n  ydoc = null,\n  awareness = null,\n  value,\n  contentUpdatedAt,\n  editable,\n  getMarkdown = getEditorMarkdown,\n  setContent = defaultSetContent,\n  normalizeValue = (v) => v,\n  shouldSeed = defaultShouldSeed,\n  initialAppliedUpdatedAt,\n}: UseCollabReconcileOptions): UseCollabReconcileResult {\n  const collab = !!ydoc;\n  const isSettingContentRef = useRef(false);\n  const lastEmittedRef = useRef(\"\");\n  // Ring of recent local emissions (see pushEmittedRing). Lets the reconcile\n  // recognize a stale-but-recent echo of our OWN (possibly partial, debounced)\n  // save so a lagging poll never clobbers freshly-typed text.\n  const recentEmittedRef = useRef<string[]>([]);\n  const lastTypedAtRef = useRef(0);\n  // The raw authoritative `value` string the reconcile last applied. When the\n  // SAME raw string is re-fetched (a lagging poll, or a source-sync that keeps\n  // re-supplying the same stored markdown), applying it again would only\n  // reproduce the doc we already hold — and if `value` is NON-idempotent\n  // (serialize(parse(value)) !== value) re-applying compounds the divergence\n  // every cycle (`<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` …). Tracked so the\n  // identical re-fetch is recognized and skipped.\n  const lastAppliedValueRef = useRef<string | null>(null);\n  // The editor's SERIALIZED output captured right AFTER the last reconcile/seed\n  // apply (`getMarkdown(editor)` once the content settled). For non-idempotent\n  // input this is what autosave actually persists, so the NEXT poll hands it\n  // back as the new `value`. Comparing the incoming value against this lets the\n  // reconcile recognize its own echo even when the raw string changed once, so\n  // it never re-parses content the editor already represents. This is the\n  // doc-equivalence guard that breaks the escalation loop.\n  const lastAppliedSerializedRef = useRef<string | null>(null);\n  const lastAppliedUpdatedAtRef = useRef<string | null>(\n    initialAppliedUpdatedAt !== undefined\n      ? initialAppliedUpdatedAt\n      : (contentUpdatedAt ?? null),\n  );\n\n  // Whether THIS client is the one that seeds the empty shared doc / applies an\n  // authoritative external snapshot into it. Exactly one client does, so the\n  // content isn't inserted once per open editor. A sole client always leads.\n  const [isLeadClient, setIsLeadClient] = useState(true);\n  // Count of OTHER visible human collaborators. When >0, a peer's edit also\n  // arrives via Yjs, so external markdown reconcile must defer (avoid applying\n  // the same change through both Yjs and setContent).\n  const peerCountRef = useRef(0);\n  useEffect(() => {\n    if (!collab || !awareness || !ydoc) {\n      setIsLeadClient(true);\n      peerCountRef.current = 0;\n      return;\n    }\n    const update = () => {\n      setIsLeadClient(isReconcileLeadClient(awareness, ydoc.clientID));\n      let peers = 0;\n      awareness.getStates().forEach((state, clientId) => {\n        if (clientId === ydoc.clientID) return; // self\n        if (clientId === AGENT_CLIENT_ID) return; // agent isn't a Yjs editor\n        const s = state as { user?: unknown; visible?: boolean };\n        if (s && s.user && s.visible !== false) peers += 1;\n      });\n      peerCountRef.current = peers;\n    };\n    update();\n    awareness.on(\"change\", update);\n    document.addEventListener(\"visibilitychange\", update);\n    return () => {\n      awareness.off(\"change\", update);\n      document.removeEventListener(\"visibilitychange\", update);\n    };\n  }, [collab, awareness, ydoc]);\n\n  // Collab seed: populate an empty shared Y.Doc from the markdown `value` once.\n  // The Collaboration extension does NOT auto-seed; only the lead client does,\n  // so two clients opening a brand-new block at once don't both seed (which\n  // would duplicate the content via concurrent inserts at the same position).\n  const seededRef = useRef(false);\n  useEffect(() => {\n    if (!collab || !editor || editor.isDestroyed || !ydoc) return;\n    if (seededRef.current) return;\n    if (!isLeadClient) return;\n    if (!value.trim()) return;\n    const fragment = ydoc.getXmlFragment(\"default\");\n    const currentMarkdown = getMarkdown(editor);\n    // Seed only when the shared doc is genuinely empty — either the fragment has\n    // no nodes yet, or it holds no semantic markdown (an empty paragraph, or an\n    // app's sentinel-empty filler via a custom `shouldSeed`).\n    if (\n      shouldSeed({ value, currentMarkdown, fragmentLength: fragment.length })\n    ) {\n      isSettingContentRef.current = true;\n      setContent(editor, value, {});\n      isSettingContentRef.current = false;\n      const serialized = getMarkdown(editor);\n      lastEmittedRef.current = serialized;\n      pushEmittedRing(recentEmittedRef.current, serialized);\n      lastAppliedValueRef.current = value;\n      lastAppliedSerializedRef.current = serialized;\n      if (contentUpdatedAt) lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n    }\n    seededRef.current = true;\n  }, [\n    collab,\n    editor,\n    ydoc,\n    value,\n    isLeadClient,\n    contentUpdatedAt,\n    getMarkdown,\n    setContent,\n    shouldSeed,\n  ]);\n\n  // Reconcile authoritative external markdown (agent edit, source patch, or a\n  // peer edit mirrored to SQL) into the live editor. In collab mode only the\n  // lead client applies it through setContent; Yjs propagates the result to\n  // every other client. In non-collab mode this is the original controlled-value\n  // reconcile, unchanged.\n  useEffect(() => {\n    if (!editor || editor.isDestroyed) return;\n\n    let cancelled = false;\n    let retry: ReturnType<typeof setTimeout> | null = null;\n    // With peers present, a peer's edit also arrives via Yjs. Defer one poll\n    // cycle (+margin) and re-check before applying via setContent so the same\n    // change isn't inserted twice (Yjs + setContent → duplicated region).\n    const PEER_SETTLE_MS = 2500;\n\n    const apply = (deferred = false) => {\n      if (cancelled || editor.isDestroyed) return;\n      // In collab mode, defer all reconcile until the shared doc is seeded so we\n      // never setContent over an unseeded fragment.\n      if (collab && !seededRef.current) {\n        retry = setTimeout(() => apply(deferred), 300);\n        return;\n      }\n      const currentMarkdown = getMarkdown(editor);\n      // Compare against the canonical form the editor would emit so a serializer\n      // that re-normalizes (Content's NFM) still recognizes \"already in sync\".\n      const normalizedValue = normalizeValue(value);\n      // Whether the editor still holds exactly what THIS hook last applied (the\n      // user hasn't edited since). Only then are the round-trip echo guards\n      // below safe: if the user has since edited away from the applied content,\n      // an external snapshot equal to a previously-applied value is a real\n      // revert and must NOT be swallowed as an echo.\n      const editorUnchangedSinceApply =\n        lastAppliedSerializedRef.current !== null &&\n        currentMarkdown === lastAppliedSerializedRef.current;\n\n      // Doc-equivalence skip. Never re-apply content the editor already\n      // represents — comparing by DOC EQUIVALENCE, not raw strings/timestamps:\n      //   1. `currentMarkdown === normalizedValue` — the editor's CURRENT\n      //      serialized doc already equals the (normalized) incoming value.\n      //   2. `value === lastEmittedRef.current` — the incoming value is our own\n      //      just-emitted markdown echoing back.\n      //   3. `value === lastAppliedValueRef.current` — the SAME raw value we\n      //      already applied is being re-supplied (a lagging poll or a\n      //      source-sync re-handing the same stored markdown). Applying it again\n      //      would only reproduce the doc we hold; for NON-idempotent input it\n      //      would compound divergence. Guarded by `editorUnchangedSinceApply`\n      //      so a deliberate revert-to-previous after a local edit still lands.\n      //   4. `normalizedValue === lastAppliedSerializedRef.current` — the\n      //      incoming value round-trips to the serialized output we last\n      //      produced (our own autosaved echo coming back from SQL). For\n      //      non-idempotent input the raw string differs from what we were\n      //      handed, but it is doc-equivalent to what the editor already shows,\n      //      so re-parsing it must be skipped. This is the guard that stops the\n      //      `<p>` → `&lt;p&gt;` → `&amp;lt;p&amp;gt;` escalation.\n      if (\n        currentMarkdown === normalizedValue ||\n        value === lastEmittedRef.current ||\n        // A stale-but-recent echo of our own (possibly partial) save — applying\n        // it would clobber the freshly-typed tail. External edits never match.\n        recentEmittedRef.current.includes(value) ||\n        recentEmittedRef.current.includes(normalizedValue) ||\n        (editorUnchangedSinceApply &&\n          (value === lastAppliedValueRef.current ||\n            normalizedValue === lastAppliedSerializedRef.current))\n      ) {\n        if (contentUpdatedAt) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n        return;\n      }\n\n      const externalNewer =\n        !lastAppliedUpdatedAtRef.current ||\n        !contentUpdatedAt ||\n        contentUpdatedAt > lastAppliedUpdatedAtRef.current;\n\n      // Only the lead client applies an authoritative snapshot into the shared\n      // Y.Doc; peers receive it through Yjs sync.\n      if (collab && !isLeadClient) {\n        if (contentUpdatedAt && !externalNewer) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n        return;\n      }\n\n      // Never clobber an in-progress edit. While the user is actively typing\n      // (focused and a keystroke landed within the window) defer and re-check —\n      // applying external content now would yank text out from under them and,\n      // for non-idempotent input, fight every keystroke. Newer external content\n      // retries so it still lands once they pause; older-or-equal content is a\n      // stale poll and is dropped outright while focused.\n      const typingRecently =\n        editor.isFocused && Date.now() - lastTypedAtRef.current < 1500;\n      if (typingRecently) {\n        if (externalNewer) {\n          retry = setTimeout(() => apply(deferred), 700);\n        }\n        return;\n      }\n      // Older-or-equal content is a stale poll / lagging echo. Drop it while\n      // focused (a peer/agent edit would be NEWER and retries above). In\n      // NON-COLLAB mode there is no peer, so older-or-equal external content is\n      // ALWAYS stale — dropping it regardless of focus stops a lagging\n      // `get-visual-plan` poll from reverting a just-applied local structural\n      // change (drag-to-columns) while the editor is blurred (the drag grips the\n      // handle, not the prose, so `isFocused` is false at drop time). Gated on\n      // `lastAppliedSerializedRef` so the very first seed (nothing applied yet,\n      // also not-newer) still lands.\n      const seeded = lastAppliedSerializedRef.current !== null;\n      if (!externalNewer && (editor.isFocused || (!collab && seeded))) return;\n\n      // Race guard: with peers present, let Yjs deliver a peer's edit first.\n      // Defer once and re-check — a peer edit makes the equality check above\n      // no-op next pass; an agent/source edit still differs and applies.\n      if (collab && externalNewer && !deferred && peerCountRef.current > 0) {\n        retry = setTimeout(() => apply(true), PEER_SETTLE_MS);\n        return;\n      }\n\n      queueMicrotask(() => {\n        if (cancelled || editor.isDestroyed) return;\n        // Re-check doc-equivalence at apply time. Between the decision above and\n        // this microtask a peer/Yjs edit (or our own prior apply) may have made\n        // the editor already represent this value — re-applying would be a\n        // wasted setContent that, for non-idempotent input, re-triggers the\n        // loop. Skip when the editor's current serialization already matches the\n        // normalized value, or the value round-trips to what we last produced.\n        const beforeMarkdown = getMarkdown(editor);\n        const normalized = normalizeValue(value);\n        const unchangedSinceApply =\n          lastAppliedSerializedRef.current !== null &&\n          beforeMarkdown === lastAppliedSerializedRef.current;\n        if (\n          beforeMarkdown === normalized ||\n          (unchangedSinceApply &&\n            normalized === lastAppliedSerializedRef.current)\n        ) {\n          lastAppliedValueRef.current = value;\n          if (contentUpdatedAt) {\n            lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n          }\n          return;\n        }\n        isSettingContentRef.current = true;\n        setContent(editor, value, { emitUpdate: false, addToHistory: false });\n        isSettingContentRef.current = false;\n        // Capture the SERIALIZED result, not the raw value. For non-idempotent\n        // input these differ; recording the serialized output is what lets the\n        // next poll (which returns this serialized form) be recognized as our\n        // own echo and skipped — stabilizing the doc after exactly one apply.\n        const serialized = getMarkdown(editor);\n        lastEmittedRef.current = serialized;\n        pushEmittedRing(recentEmittedRef.current, serialized);\n        lastAppliedValueRef.current = value;\n        lastAppliedSerializedRef.current = serialized;\n        if (contentUpdatedAt) {\n          lastAppliedUpdatedAtRef.current = contentUpdatedAt;\n        }\n      });\n    };\n\n    apply();\n    return () => {\n      cancelled = true;\n      if (retry) clearTimeout(retry);\n    };\n  }, [\n    contentUpdatedAt,\n    editor,\n    value,\n    collab,\n    isLeadClient,\n    getMarkdown,\n    setContent,\n    normalizeValue,\n  ]);\n\n  const shouldIgnoreUpdate = (transaction: Transaction): boolean => {\n    if (!editable || isSettingContentRef.current) return true;\n    if (transaction.getMeta(RICH_MARKDOWN_PROGRAMMATIC_TRANSACTION)) {\n      return true;\n    }\n    // In collab mode, never persist remote-originated changes (the initial Yjs\n    // state load or a peer's edit arriving via sync). Each client saves only its\n    // OWN local edits; a peer's edit is saved by that peer. Without this, a\n    // lagging Y.Doc load would write stale markdown over newer SQL.\n    if (collab && transaction && isChangeOrigin(transaction)) return true;\n    lastTypedAtRef.current = Date.now();\n    return false;\n  };\n\n  const registerEmitted = (markdown: string): boolean => {\n    // Don't persist an empty doc before Collaboration has seeded — that would\n    // clobber the saved block content with an empty string.\n    if (collab && !markdown.trim()) return false;\n    lastEmittedRef.current = markdown;\n    pushEmittedRing(recentEmittedRef.current, markdown);\n    return true;\n  };\n\n  return {\n    collab,\n    isSettingContentRef,\n    shouldIgnoreUpdate,\n    registerEmitted,\n  };\n}\n"]}

package/dist/db/migrations.d.ts

@@ -8,6 +8,16 @@ type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
  * regex with subtly different shapes.
  */
 export declare function isDuplicateColumnError(err: unknown): boolean;
+/**
+ * True when a migration statement failed because the connected DB ROLE lacks
+ * privilege — e.g. a permission-limited dev/replica role that doesn't own the
+ * table. Postgres raises SQLSTATE 42501 ("insufficient_privilege", routine
+ * aclcheck_error, message "must be owner of table …"). We treat these as
+ * NON-FATAL so a perms-limited database can't crash-loop the whole server: the
+ * migration is skipped (left unrecorded) and a properly-privileged role applies
+ * it later. Production, where the role owns its tables, never hits this path.
+ */
+export declare function isPermissionError(err: unknown): boolean;
 export interface RunMigrationsOptions {
     /**
      * Name of the migrations bookkeeping table. REQUIRED — there is intentionally

package/dist/db/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAOA,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA4B9D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK5D;AAmDD,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,YAAY,CAAC;CACnB;AAQD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,EACjC,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CAuLhB"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAOA,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA4B9D;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAK5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CASvD;AAmDD,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;OAYG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,YAAY,CAAC;CACnB;AAQD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,EACjC,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CAyMhB"}

package/dist/db/migrations.js

@@ -34,6 +34,24 @@ export function isDuplicateColumnError(err) {
     const msg = err?.message ?? "";
     return (/duplicate column name/i.test(msg) || /column .* already exists/i.test(msg));
 }
+/**
+ * True when a migration statement failed because the connected DB ROLE lacks
+ * privilege — e.g. a permission-limited dev/replica role that doesn't own the
+ * table. Postgres raises SQLSTATE 42501 ("insufficient_privilege", routine
+ * aclcheck_error, message "must be owner of table …"). We treat these as
+ * NON-FATAL so a perms-limited database can't crash-loop the whole server: the
+ * migration is skipped (left unrecorded) and a properly-privileged role applies
+ * it later. Production, where the role owns its tables, never hits this path.
+ */
+export function isPermissionError(err) {
+    const e = err;
+    if (e?.code === "42501")
+        return true;
+    const msg = e?.message ?? "";
+    return (/must be owner of/i.test(msg) ||
+        /permission denied/i.test(msg) ||
+        /insufficient privilege/i.test(msg));
+}
 /**
  * Split a multi-statement SQL blob into individual statements.
  *
@@ -221,6 +239,20 @@ export function runMigrations(migrations, options) {
                     console.log(`[db] Applied migration v${m.version} (${statements.length} statement${statements.length === 1 ? "" : "s"})`);
                 }
                 catch (err) {
+                    if (pg && isPermissionError(err)) {
+                        // The connected role lacks privilege for this migration (e.g. a
+                        // permission-limited dev/replica role that doesn't own the table).
+                        // Don't crash-loop the whole server over it — warn and STOP here.
+                        // We must NOT continue to later migrations: pending work is computed
+                        // as `version > MAX(recorded version)`, so applying a later migration
+                        // would advance MAX past this unrecorded one and orphan it forever.
+                        // Stopping leaves MAX at the last recorded version, so a properly-
+                        // privileged role resumes from this exact migration, in order.
+                        console.warn(`[db] Migration v${m.version} skipped — insufficient privilege: ${err.message}. ` +
+                            `Apply it with a DB role that owns the table. ` +
+                            `Halting further migrations so this one isn't orphaned.`, "\nStatement:", currentStmt);
+                        break;
+                    }
                     console.error(`[db] Migration v${m.version} FAILED:`, err.message, "\nStatement:", currentStmt);
                     throw err;
                 }

package/dist/db/migrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getDbExec,\n  isPostgres,\n  getDialect,\n  retrySqliteBusy,\n} from \"./client.js\";\n\ntype NitroPluginDef = (nitroApp: any) => void | Promise<void>;\n\n/**\n * Rewrite SQLite-specific SQL to Postgres-compatible equivalents.\n * Handles: datetime('now') → CURRENT_TIMESTAMP, AUTOINCREMENT → GENERATED, etc.\n */\nfunction adaptSqlForPostgres(sql: string): string {\n  return sql\n    .replace(/datetime\\s*\\(\\s*'now'\\s*\\)/gi, \"CURRENT_TIMESTAMP\")\n    .replace(/\\bAUTOINCREMENT\\b/gi, \"\")\n    .replace(/\\bINTEGER\\b/gi, \"BIGINT\");\n}\n\nconst IF_NOT_EXISTS_ADD_COLUMN_RE = /ADD\\s+COLUMN\\s+IF\\s+NOT\\s+EXISTS/i;\n\n/**\n * Strip Postgres-only syntax that SQLite doesn't support.\n * Handles: ALTER TABLE ... ADD COLUMN IF NOT EXISTS → ADD COLUMN\n *\n * Note: SQLite does not have a native equivalent, so the idempotent\n * semantic is emulated at the executor level by swallowing the\n * \"duplicate column name\" error for statements that originally carried\n * the clause. See `hadIfNotExists` tracking in the run loop.\n */\nfunction adaptSqlForSqlite(sql: string): string {\n  return sql.replace(/ADD\\s+COLUMN\\s+IF\\s+NOT\\s+EXISTS/gi, \"ADD COLUMN\");\n}\n\n/**\n * True when an error from `ALTER TABLE ... ADD COLUMN` indicates the\n * column already existed. Recognizes both SQLite (\"duplicate column\n * name\") and Postgres (\"column ... already exists\" — exact text varies\n * by error code 42701, but the substring is stable). Exported so other\n * idempotent column-upgrade loops in the codebase don't reinvent this\n * regex with subtly different shapes.\n */\nexport function isDuplicateColumnError(err: unknown): boolean {\n  const msg = (err as Error | undefined)?.message ?? \"\";\n  return (\n    /duplicate column name/i.test(msg) || /column .* already exists/i.test(msg)\n  );\n}\n\n/**\n * Split a multi-statement SQL blob into individual statements.\n *\n * libsql's `execute(sql)` only runs the first statement in a multi-statement\n * string. This splitter is intentionally simple: it respects single-quoted\n * string literals (with `''` escaping) and `--` line comments, and splits on\n * top-level `;`. It does NOT attempt to parse `$$`-quoted Postgres function\n * bodies — migrations that define functions/triggers with `;` inside bodies\n * should pass a single-statement migration per entry instead.\n */\nfunction splitSqlStatements(sql: string): string[] {\n  const out: string[] = [];\n  let buf = \"\";\n  let i = 0;\n  let inSingle = false;\n  while (i < sql.length) {\n    const ch = sql[i];\n    const next = sql[i + 1];\n    if (!inSingle && ch === \"-\" && next === \"-\") {\n      // Skip to end of line\n      while (i < sql.length && sql[i] !== \"\\n\") i++;\n      continue;\n    }\n    if (ch === \"'\") {\n      buf += ch;\n      if (inSingle && next === \"'\") {\n        buf += next;\n        i += 2;\n        continue;\n      }\n      inSingle = !inSingle;\n      i++;\n      continue;\n    }\n    if (ch === \";\" && !inSingle) {\n      const trimmed = buf.trim();\n      if (trimmed) out.push(trimmed);\n      buf = \"\";\n      i++;\n      continue;\n    }\n    buf += ch;\n    i++;\n  }\n  const tail = buf.trim();\n  if (tail) out.push(tail);\n  return out;\n}\n\nexport interface RunMigrationsOptions {\n  /**\n   * Name of the migrations bookkeeping table. REQUIRED — there is intentionally\n   * no default. Two templates that share a database (e.g. via the same Neon URL)\n   * each have their own version space starting at v1, and a single shared\n   * `_migrations` table will silently skip the second template's migrations if\n   * the first has already advanced past those version numbers. This caused the\n   * design template's migrations to be skipped entirely on a Neon DB that\n   * slides had already populated up to v15 (PR #320 era).\n   *\n   * Use one bookkeeping table per template, e.g. `slides_migrations`. Core\n   * feature plugins (e.g. the org module) follow the same convention with\n   * their own prefix, e.g. `_org_migrations`.\n   */\n  table: string;\n}\n\n/**\n * A single migration entry.\n *\n * `sql` can be a string (runs on every dialect) or an object with dialect\n * keys for dialect-gated SQL. Useful when Postgres needs an ALTER that\n * SQLite can't parse.\n *\n *   { version: 14, sql: { postgres: \"ALTER TABLE …\" } }  // no-op on sqlite\n *   { version: 15, sql: { sqlite: \"…\", postgres: \"…\" } } // both dialects\n */\nexport type MigrationSql = string | { postgres?: string; sqlite?: string };\n\nexport interface MigrationEntry {\n  version: number;\n  sql: MigrationSql;\n}\n\nfunction resolveMigrationSql(sql: MigrationSql, pg: boolean): string | null {\n  if (typeof sql === \"string\") return sql;\n  const raw = pg ? sql.postgres : sql.sqlite;\n  return raw ?? null;\n}\n\nexport function runMigrations(\n  migrations: Array<MigrationEntry>,\n  options: RunMigrationsOptions,\n): NitroPluginDef {\n  const table = options?.table;\n  if (\n    !table ||\n    typeof table !== \"string\" ||\n    !/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)\n  ) {\n    throw new Error(\n      \"runMigrations: `table` option is required and must be a valid SQL identifier \" +\n        '(e.g. `{ table: \"slides_migrations\" }`). See packages/core/src/db/migrations.ts ' +\n        \"for why this is required (shared-DB version-collision bug).\",\n    );\n  }\n  return async () => {\n    try {\n      // Check for Cloudflare D1 binding (only if DATABASE_URL not set)\n      const d1 = getDialect() === \"d1\" ? globalThis.__cf_env?.DB : null;\n      if (d1) {\n        await d1\n          .prepare(\n            `CREATE TABLE IF NOT EXISTS ${table} (version INTEGER PRIMARY KEY)`,\n          )\n          .run();\n        const firstRow = await d1\n          .prepare(`SELECT MAX(version) as v FROM ${table}`)\n          .first<{ v?: number }>();\n        const current = (firstRow?.v as number) ?? 0;\n\n        for (const m of migrations.filter((m) => m.version > current)) {\n          try {\n            // D1 is SQLite-compatible\n            const raw = resolveMigrationSql(m.sql, false);\n            if (raw == null) {\n              await d1\n                .prepare(`INSERT OR IGNORE INTO ${table} VALUES (?)`)\n                .bind(m.version)\n                .run();\n              continue;\n            }\n            const originalStatements = splitSqlStatements(raw);\n            const statements = originalStatements.map((orig) => ({\n              sql: adaptSqlForSqlite(orig),\n              hadIfNotExists: IF_NOT_EXISTS_ADD_COLUMN_RE.test(orig),\n            }));\n            const hasIfNotExists = statements.some((s) => s.hadIfNotExists);\n            if (hasIfNotExists) {\n              // Per-statement path: we need to swallow \"duplicate column\"\n              // errors for statements that originally carried\n              // `ADD COLUMN IF NOT EXISTS`, which a batch() can't express.\n              // Loses atomicity, but the idempotent-ADD-COLUMN semantic\n              // means a partial re-run resolves cleanly on retry.\n              for (const { sql: stmt, hadIfNotExists } of statements) {\n                try {\n                  await d1.prepare(stmt).run();\n                } catch (err) {\n                  if (hadIfNotExists && isDuplicateColumnError(err)) continue;\n                  throw err;\n                }\n              }\n              await d1\n                .prepare(`INSERT OR IGNORE INTO ${table} VALUES (?)`)\n                .bind(m.version)\n                .run();\n            } else {\n              // Atomic batch: all statements + version-row insert land in\n              // the same transaction. A failing statement rolls the whole\n              // migration back, so we never record a half-applied version.\n              await d1.batch([\n                ...statements.map((s) => d1.prepare(s.sql)),\n                d1\n                  .prepare(`INSERT OR IGNORE INTO ${table} VALUES (?)`)\n                  .bind(m.version),\n              ]);\n            }\n            console.log(\n              `[db] Applied migration v${m.version} (${statements.length} statement${statements.length === 1 ? \"\" : \"s\"})`,\n            );\n          } catch (err) {\n            console.error(\n              `[db] Migration v${m.version} FAILED:`,\n              (err as Error).message,\n              \"\\nSQL:\",\n              JSON.stringify(m.sql),\n            );\n            throw err;\n          }\n        }\n        return;\n      }\n\n      // Generic path — works for libsql and Postgres\n      const exec = getDbExec();\n      const pg = isPostgres();\n\n      // Retry initial table creation — SQLITE_BUSY_RECOVERY can occur on HMR\n      // restarts when WAL files from the previous process haven't been released yet.\n      await retrySqliteBusy(\n        () =>\n          exec.execute(\n            `CREATE TABLE IF NOT EXISTS ${table} (version INTEGER PRIMARY KEY)`,\n          ),\n        { maxAttempts: 6, baseDelayMs: 1000, rethrow: true },\n      );\n\n      const { rows } = await exec.execute(\n        `SELECT MAX(version) as v FROM ${table}`,\n      );\n      const current = (rows[0]?.v as number) ?? 0;\n\n      const insertSql = pg\n        ? `INSERT INTO ${table} VALUES (?) ON CONFLICT DO NOTHING`\n        : `INSERT OR IGNORE INTO ${table} VALUES (?)`;\n\n      const pending = migrations.filter((m) => m.version > current);\n      if (pending.length > 0) {\n        console.log(\n          `[db] Applying ${pending.length} migration(s) on ${pg ? \"Postgres\" : \"SQLite/libsql\"}…`,\n        );\n      }\n\n      for (const m of pending) {\n        const raw = resolveMigrationSql(m.sql, pg);\n        if (raw == null) {\n          // Dialect-gated migration with no SQL for this dialect; still mark\n          // as applied so we don't retry forever.\n          await exec.execute({ sql: insertSql, args: [m.version] });\n          continue;\n        }\n        // Split BEFORE adapting so we can remember which original statements\n        // carried `ADD COLUMN IF NOT EXISTS` — SQLite drops the clause, so we\n        // emulate the idempotent semantic by swallowing duplicate-column\n        // errors only for those statements.\n        const originalStatements = splitSqlStatements(raw);\n        const statements = originalStatements.map((orig) => ({\n          sql: pg ? adaptSqlForPostgres(orig) : adaptSqlForSqlite(orig),\n          hadIfNotExists: IF_NOT_EXISTS_ADD_COLUMN_RE.test(orig),\n        }));\n        let currentStmt = \"\";\n        try {\n          for (const { sql: stmt, hadIfNotExists } of statements) {\n            currentStmt = stmt;\n            try {\n              await exec.execute(stmt);\n            } catch (err) {\n              if (!pg && hadIfNotExists && isDuplicateColumnError(err)) {\n                // IF NOT EXISTS semantic: column already present, skip.\n                continue;\n              }\n              throw err;\n            }\n          }\n          await exec.execute({ sql: insertSql, args: [m.version] });\n          console.log(\n            `[db] Applied migration v${m.version} (${statements.length} statement${statements.length === 1 ? \"\" : \"s\"})`,\n          );\n        } catch (err) {\n          console.error(\n            `[db] Migration v${m.version} FAILED:`,\n            (err as Error).message,\n            \"\\nStatement:\",\n            currentStmt,\n          );\n          throw err;\n        }\n      }\n    } catch (err) {\n      console.error(\"[db] Migration failed:\", (err as Error).message);\n      // In local dev, hard-fail so the developer catches errors immediately.\n      // On serverless runtimes (Netlify Functions, Vercel, CF Workers) we\n      // keep the process alive — the app will return 500s for routes that\n      // depend on the missing tables, but at least other routes still work.\n      // Note: Node.js 21+ defines globalThis.navigator, so we check for\n      // serverless env vars instead of navigator presence.\n      const isServerless =\n        !!globalThis.process?.env?.NETLIFY ||\n        !!globalThis.process?.env?.AWS_LAMBDA_FUNCTION_NAME ||\n        !!globalThis.process?.env?.VERCEL ||\n        \"__cf_env\" in globalThis;\n      if (typeof globalThis.process?.exit === \"function\" && !isServerless) {\n        process.exit(1);\n      }\n    }\n  };\n}\n"]}
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getDbExec,\n  isPostgres,\n  getDialect,\n  retrySqliteBusy,\n} from \"./client.js\";\n\ntype NitroPluginDef = (nitroApp: any) => void | Promise<void>;\n\n/**\n * Rewrite SQLite-specific SQL to Postgres-compatible equivalents.\n * Handles: datetime('now') → CURRENT_TIMESTAMP, AUTOINCREMENT → GENERATED, etc.\n */\nfunction adaptSqlForPostgres(sql: string): string {\n  return sql\n    .replace(/datetime\\s*\\(\\s*'now'\\s*\\)/gi, \"CURRENT_TIMESTAMP\")\n    .replace(/\\bAUTOINCREMENT\\b/gi, \"\")\n    .replace(/\\bINTEGER\\b/gi, \"BIGINT\");\n}\n\nconst IF_NOT_EXISTS_ADD_COLUMN_RE = /ADD\\s+COLUMN\\s+IF\\s+NOT\\s+EXISTS/i;\n\n/**\n * Strip Postgres-only syntax that SQLite doesn't support.\n * Handles: ALTER TABLE ... ADD COLUMN IF NOT EXISTS → ADD COLUMN\n *\n * Note: SQLite does not have a native equivalent, so the idempotent\n * semantic is emulated at the executor level by swallowing the\n * \"duplicate column name\" error for statements that originally carried\n * the clause. See `hadIfNotExists` tracking in the run loop.\n */\nfunction adaptSqlForSqlite(sql: string): string {\n  return sql.replace(/ADD\\s+COLUMN\\s+IF\\s+NOT\\s+EXISTS/gi, \"ADD COLUMN\");\n}\n\n/**\n * True when an error from `ALTER TABLE ... ADD COLUMN` indicates the\n * column already existed. Recognizes both SQLite (\"duplicate column\n * name\") and Postgres (\"column ... already exists\" — exact text varies\n * by error code 42701, but the substring is stable). Exported so other\n * idempotent column-upgrade loops in the codebase don't reinvent this\n * regex with subtly different shapes.\n */\nexport function isDuplicateColumnError(err: unknown): boolean {\n  const msg = (err as Error | undefined)?.message ?? \"\";\n  return (\n    /duplicate column name/i.test(msg) || /column .* already exists/i.test(msg)\n  );\n}\n\n/**\n * True when a migration statement failed because the connected DB ROLE lacks\n * privilege — e.g. a permission-limited dev/replica role that doesn't own the\n * table. Postgres raises SQLSTATE 42501 (\"insufficient_privilege\", routine\n * aclcheck_error, message \"must be owner of table …\"). We treat these as\n * NON-FATAL so a perms-limited database can't crash-loop the whole server: the\n * migration is skipped (left unrecorded) and a properly-privileged role applies\n * it later. Production, where the role owns its tables, never hits this path.\n */\nexport function isPermissionError(err: unknown): boolean {\n  const e = err as { code?: string; message?: string } | undefined;\n  if (e?.code === \"42501\") return true;\n  const msg = e?.message ?? \"\";\n  return (\n    /must be owner of/i.test(msg) ||\n    /permission denied/i.test(msg) ||\n    /insufficient privilege/i.test(msg)\n  );\n}\n\n/**\n * Split a multi-statement SQL blob into individual statements.\n *\n * libsql's `execute(sql)` only runs the first statement in a multi-statement\n * string. This splitter is intentionally simple: it respects single-quoted\n * string literals (with `''` escaping) and `--` line comments, and splits on\n * top-level `;`. It does NOT attempt to parse `$$`-quoted Postgres function\n * bodies — migrations that define functions/triggers with `;` inside bodies\n * should pass a single-statement migration per entry instead.\n */\nfunction splitSqlStatements(sql: string): string[] {\n  const out: string[] = [];\n  let buf = \"\";\n  let i = 0;\n  let inSingle = false;\n  while (i < sql.length) {\n    const ch = sql[i];\n    const next = sql[i + 1];\n    if (!inSingle && ch === \"-\" && next === \"-\") {\n      // Skip to end of line\n      while (i < sql.length && sql[i] !== \"\\n\") i++;\n      continue;\n    }\n    if (ch === \"'\") {\n      buf += ch;\n      if (inSingle && next === \"'\") {\n        buf += next;\n        i += 2;\n        continue;\n      }\n      inSingle = !inSingle;\n      i++;\n      continue;\n    }\n    if (ch === \";\" && !inSingle) {\n      const trimmed = buf.trim();\n      if (trimmed) out.push(trimmed);\n      buf = \"\";\n      i++;\n      continue;\n    }\n    buf += ch;\n    i++;\n  }\n  const tail = buf.trim();\n  if (tail) out.push(tail);\n  return out;\n}\n\nexport interface RunMigrationsOptions {\n  /**\n   * Name of the migrations bookkeeping table. REQUIRED — there is intentionally\n   * no default. Two templates that share a database (e.g. via the same Neon URL)\n   * each have their own version space starting at v1, and a single shared\n   * `_migrations` table will silently skip the second template's migrations if\n   * the first has already advanced past those version numbers. This caused the\n   * design template's migrations to be skipped entirely on a Neon DB that\n   * slides had already populated up to v15 (PR #320 era).\n   *\n   * Use one bookkeeping table per template, e.g. `slides_migrations`. Core\n   * feature plugins (e.g. the org module) follow the same convention with\n   * their own prefix, e.g. `_org_migrations`.\n   */\n  table: string;\n}\n\n/**\n * A single migration entry.\n *\n * `sql` can be a string (runs on every dialect) or an object with dialect\n * keys for dialect-gated SQL. Useful when Postgres needs an ALTER that\n * SQLite can't parse.\n *\n *   { version: 14, sql: { postgres: \"ALTER TABLE …\" } }  // no-op on sqlite\n *   { version: 15, sql: { sqlite: \"…\", postgres: \"…\" } } // both dialects\n */\nexport type MigrationSql = string | { postgres?: string; sqlite?: string };\n\nexport interface MigrationEntry {\n  version: number;\n  sql: MigrationSql;\n}\n\nfunction resolveMigrationSql(sql: MigrationSql, pg: boolean): string | null {\n  if (typeof sql === \"string\") return sql;\n  const raw = pg ? sql.postgres : sql.sqlite;\n  return raw ?? null;\n}\n\nexport function runMigrations(\n  migrations: Array<MigrationEntry>,\n  options: RunMigrationsOptions,\n): NitroPluginDef {\n  const table = options?.table;\n  if (\n    !table ||\n    typeof table !== \"string\" ||\n    !/^[A-Za-z_][A-Za-z0-9_]*$/.test(table)\n  ) {\n    throw new Error(\n      \"runMigrations: `table` option is required and must be a valid SQL identifier \" +\n        '(e.g. `{ table: \"slides_migrations\" }`). See packages/core/src/db/migrations.ts ' +\n        \"for why this is required (shared-DB version-collision bug).\",\n    );\n  }\n  return async () => {\n    try {\n      // Check for Cloudflare D1 binding (only if DATABASE_URL not set)\n      const d1 = getDialect() === \"d1\" ? globalThis.__cf_env?.DB : null;\n      if (d1) {\n        await d1\n          .prepare(\n            `CREATE TABLE IF NOT EXISTS ${table} (version INTEGER PRIMARY KEY)`,\n          )\n          .run();\n        const firstRow = await d1\n          .prepare(`SELECT MAX(version) as v FROM ${table}`)\n          .first<{ v?: number }>();\n        const current = (firstRow?.v as number) ?? 0;\n\n        for (const m of migrations.filter((m) => m.version > current)) {\n          try {\n            // D1 is SQLite-compatible\n            const raw = resolveMigrationSql(m.sql, false);\n            if (raw == null) {\n              await d1\n                .prepare(`INSERT OR IGNORE INTO ${table} VALUES (?)`)\n                .bind(m.version)\n                .run();\n              continue;\n            }\n            const originalStatements = splitSqlStatements(raw);\n            const statements = originalStatements.map((orig) => ({\n              sql: adaptSqlForSqlite(orig),\n              hadIfNotExists: IF_NOT_EXISTS_ADD_COLUMN_RE.test(orig),\n            }));\n            const hasIfNotExists = statements.some((s) => s.hadIfNotExists);\n            if (hasIfNotExists) {\n              // Per-statement path: we need to swallow \"duplicate column\"\n              // errors for statements that originally carried\n              // `ADD COLUMN IF NOT EXISTS`, which a batch() can't express.\n              // Loses atomicity, but the idempotent-ADD-COLUMN semantic\n              // means a partial re-run resolves cleanly on retry.\n              for (const { sql: stmt, hadIfNotExists } of statements) {\n                try {\n                  await d1.prepare(stmt).run();\n                } catch (err) {\n                  if (hadIfNotExists && isDuplicateColumnError(err)) continue;\n                  throw err;\n                }\n              }\n              await d1\n                .prepare(`INSERT OR IGNORE INTO ${table} VALUES (?)`)\n                .bind(m.version)\n                .run();\n            } else {\n              // Atomic batch: all statements + version-row insert land in\n              // the same transaction. A failing statement rolls the whole\n              // migration back, so we never record a half-applied version.\n              await d1.batch([\n                ...statements.map((s) => d1.prepare(s.sql)),\n                d1\n                  .prepare(`INSERT OR IGNORE INTO ${table} VALUES (?)`)\n                  .bind(m.version),\n              ]);\n            }\n            console.log(\n              `[db] Applied migration v${m.version} (${statements.length} statement${statements.length === 1 ? \"\" : \"s\"})`,\n            );\n          } catch (err) {\n            console.error(\n              `[db] Migration v${m.version} FAILED:`,\n              (err as Error).message,\n              \"\\nSQL:\",\n              JSON.stringify(m.sql),\n            );\n            throw err;\n          }\n        }\n        return;\n      }\n\n      // Generic path — works for libsql and Postgres\n      const exec = getDbExec();\n      const pg = isPostgres();\n\n      // Retry initial table creation — SQLITE_BUSY_RECOVERY can occur on HMR\n      // restarts when WAL files from the previous process haven't been released yet.\n      await retrySqliteBusy(\n        () =>\n          exec.execute(\n            `CREATE TABLE IF NOT EXISTS ${table} (version INTEGER PRIMARY KEY)`,\n          ),\n        { maxAttempts: 6, baseDelayMs: 1000, rethrow: true },\n      );\n\n      const { rows } = await exec.execute(\n        `SELECT MAX(version) as v FROM ${table}`,\n      );\n      const current = (rows[0]?.v as number) ?? 0;\n\n      const insertSql = pg\n        ? `INSERT INTO ${table} VALUES (?) ON CONFLICT DO NOTHING`\n        : `INSERT OR IGNORE INTO ${table} VALUES (?)`;\n\n      const pending = migrations.filter((m) => m.version > current);\n      if (pending.length > 0) {\n        console.log(\n          `[db] Applying ${pending.length} migration(s) on ${pg ? \"Postgres\" : \"SQLite/libsql\"}…`,\n        );\n      }\n\n      for (const m of pending) {\n        const raw = resolveMigrationSql(m.sql, pg);\n        if (raw == null) {\n          // Dialect-gated migration with no SQL for this dialect; still mark\n          // as applied so we don't retry forever.\n          await exec.execute({ sql: insertSql, args: [m.version] });\n          continue;\n        }\n        // Split BEFORE adapting so we can remember which original statements\n        // carried `ADD COLUMN IF NOT EXISTS` — SQLite drops the clause, so we\n        // emulate the idempotent semantic by swallowing duplicate-column\n        // errors only for those statements.\n        const originalStatements = splitSqlStatements(raw);\n        const statements = originalStatements.map((orig) => ({\n          sql: pg ? adaptSqlForPostgres(orig) : adaptSqlForSqlite(orig),\n          hadIfNotExists: IF_NOT_EXISTS_ADD_COLUMN_RE.test(orig),\n        }));\n        let currentStmt = \"\";\n        try {\n          for (const { sql: stmt, hadIfNotExists } of statements) {\n            currentStmt = stmt;\n            try {\n              await exec.execute(stmt);\n            } catch (err) {\n              if (!pg && hadIfNotExists && isDuplicateColumnError(err)) {\n                // IF NOT EXISTS semantic: column already present, skip.\n                continue;\n              }\n              throw err;\n            }\n          }\n          await exec.execute({ sql: insertSql, args: [m.version] });\n          console.log(\n            `[db] Applied migration v${m.version} (${statements.length} statement${statements.length === 1 ? \"\" : \"s\"})`,\n          );\n        } catch (err) {\n          if (pg && isPermissionError(err)) {\n            // The connected role lacks privilege for this migration (e.g. a\n            // permission-limited dev/replica role that doesn't own the table).\n            // Don't crash-loop the whole server over it — warn and STOP here.\n            // We must NOT continue to later migrations: pending work is computed\n            // as `version > MAX(recorded version)`, so applying a later migration\n            // would advance MAX past this unrecorded one and orphan it forever.\n            // Stopping leaves MAX at the last recorded version, so a properly-\n            // privileged role resumes from this exact migration, in order.\n            console.warn(\n              `[db] Migration v${m.version} skipped — insufficient privilege: ${(err as Error).message}. ` +\n                `Apply it with a DB role that owns the table. ` +\n                `Halting further migrations so this one isn't orphaned.`,\n              \"\\nStatement:\",\n              currentStmt,\n            );\n            break;\n          }\n          console.error(\n            `[db] Migration v${m.version} FAILED:`,\n            (err as Error).message,\n            \"\\nStatement:\",\n            currentStmt,\n          );\n          throw err;\n        }\n      }\n    } catch (err) {\n      console.error(\"[db] Migration failed:\", (err as Error).message);\n      // In local dev, hard-fail so the developer catches errors immediately.\n      // On serverless runtimes (Netlify Functions, Vercel, CF Workers) we\n      // keep the process alive — the app will return 500s for routes that\n      // depend on the missing tables, but at least other routes still work.\n      // Note: Node.js 21+ defines globalThis.navigator, so we check for\n      // serverless env vars instead of navigator presence.\n      const isServerless =\n        !!globalThis.process?.env?.NETLIFY ||\n        !!globalThis.process?.env?.AWS_LAMBDA_FUNCTION_NAME ||\n        !!globalThis.process?.env?.VERCEL ||\n        \"__cf_env\" in globalThis;\n      if (typeof globalThis.process?.exit === \"function\" && !isServerless) {\n        process.exit(1);\n      }\n    }\n  };\n}\n"]}