@tearleads/client-sdk 0.1.63 → 0.1.64

package/stores/documents/documentStore/attachmentUpload/attachmentUploadResume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentUploadResume.js","sourceRoot":"","sources":["attachmentUploadResume.ts"],"names":[],"mappings":"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","sourcesContent":["import { createAesGcmIv } from \"@tearleads/crypto\";\nimport { base64ToBytes, bytesToBase64 } from \"@tearleads/encoding\";\nimport type { MultipartStageResolvedListener } from \"../../../../workflows/blobs\";\nimport type {\n  PendingAttachmentRecord,\n  PendingAttachmentUploadIdentity,\n} from \"../../../../workflows/documents\";\nimport { savePendingAttachmentUpload } from \"../attachments/attachmentPersistence\";\nimport type { DocumentStoreState } from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\n\nfunction createPendingUploadIdentity(\n  plaintextSha256: string,\n): PendingAttachmentUploadIdentity {\n  // Generated once and persisted before the first upload attempt. The source\n  // digest derives an envelope IV from this seed, then each chunk derives its\n  // IV. Reusing the material for unchanged bytes makes retries byte-identical.\n  return {\n    blobId: crypto.randomUUID(),\n    contentKey: bytesToBase64(crypto.getRandomValues(new Uint8Array(32))),\n    contentKeyEpoch: 1,\n    nonceSeed: bytesToBase64(createAesGcmIv()),\n    partSize: null,\n    plaintextSha256,\n    stageId: null,\n  };\n}\n\nexport interface AttachmentUploadResume {\n  readonly blobId: string;\n  readonly contentKey: Uint8Array;\n  readonly contentKeyEpoch: number;\n  readonly nonceSeed: Uint8Array;\n  readonly multipart: { partSize: number; resumeStageId: string } | undefined;\n  readonly onStageResolved: MultipartStageResolvedListener;\n  readonly onStageUnavailable: (\n    stageId: string,\n    documentId: string,\n  ) => Promise<void>;\n}\n\n/**\n * Resolve and persist stable encryption and multipart inputs across retries.\n *\n * Every persist here is an UPSERT of the pending-attachment row, so each one\n * is generation-gated: a store teardown (reset/discard) deletes that row on\n * purpose, and a stale resume racing it would otherwise re-insert the row it\n * just removed. Skipping the persist only costs retry resumability.\n */\nexport async function resolveAttachmentUploadResume(\n  state: DocumentStoreState,\n  pendingAttachment: PendingAttachmentRecord,\n  plaintextSha256: string,\n  attachmentGeneration: DocumentStoreSyncGeneration,\n): Promise<AttachmentUploadResume> {\n  let uploadIdentity =\n    pendingAttachment.upload?.plaintextSha256 === plaintextSha256\n      ? pendingAttachment.upload\n      : createPendingUploadIdentity(plaintextSha256);\n  if (\n    pendingAttachment.upload !== uploadIdentity &&\n    isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)\n  ) {\n    await savePendingAttachmentUpload(\n      state,\n      { ...pendingAttachment, upload: uploadIdentity },\n      attachmentGeneration,\n    );\n    if (isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)) {\n      pendingAttachment.upload = uploadIdentity;\n    }\n  }\n\n  const multipart =\n    uploadIdentity.stageId !== null && uploadIdentity.partSize !== null\n      ? {\n          partSize: uploadIdentity.partSize,\n          resumeStageId: uploadIdentity.stageId,\n        }\n      : undefined;\n  const onStageResolved: MultipartStageResolvedListener = async ({\n    partSize,\n    stageId,\n  }) => {\n    if (\n      uploadIdentity.stageId === stageId &&\n      uploadIdentity.partSize === partSize\n    ) {\n      return;\n    }\n    if (!isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)) {\n      return;\n    }\n    const nextUploadIdentity = { ...uploadIdentity, partSize, stageId };\n    await savePendingAttachmentUpload(\n      state,\n      { ...pendingAttachment, upload: nextUploadIdentity },\n      attachmentGeneration,\n    );\n    if (isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)) {\n      // Publish only after persistence succeeds: a failed save must leave the\n      // next attempt responsible for making this identity durable.\n      uploadIdentity = nextUploadIdentity;\n      pendingAttachment.upload = nextUploadIdentity;\n    }\n  };\n\n  return {\n    blobId: uploadIdentity.blobId,\n    contentKey: base64ToBytes(uploadIdentity.contentKey),\n    contentKeyEpoch: uploadIdentity.contentKeyEpoch,\n    nonceSeed: base64ToBytes(uploadIdentity.nonceSeed),\n    multipart,\n    onStageResolved,\n    onStageUnavailable: async (stageId, documentId) => {\n      if (\n        !isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration) ||\n        pendingAttachment.upload?.stageId !== stageId\n      )\n        return;\n      // Recheck after the ambiguous bind, including an immediate projection\n      // retry in this pass. A still-active commit must retain its identity for\n      // normal adoption on the next pass; a failed read proves nothing.\n      const bindings = await state.runtime.apiClient.listDocumentAttachments(\n        documentId,\n        { refresh: true },\n      );\n      if (!bindings) throw new Error(\"Attachment recovery lookup failed.\");\n      if (\n        !isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration) ||\n        pendingAttachment.upload?.stageId !== stageId ||\n        bindings.some(\n          (binding) =>\n            binding.slotId === pendingAttachment.slotId &&\n            binding.blobId === uploadIdentity.blobId,\n        )\n      )\n        return;\n      // A missing stage may have been consumed by a committed bind whose\n      // response was lost and whose slot was subsequently replaced/detached.\n      // That blob id is permanently reserved, so a replacement stage must use\n      // fresh crypto material and an id persisted before any bytes are sent.\n      const nextUploadIdentity = createPendingUploadIdentity(plaintextSha256);\n      await savePendingAttachmentUpload(\n        state,\n        { ...pendingAttachment, upload: nextUploadIdentity },\n        attachmentGeneration,\n      );\n      if (isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)) {\n        pendingAttachment.upload = nextUploadIdentity;\n      }\n    },\n  };\n}\n"]}

package/stores/documents/documentStore/{attachmentDetachState.js → attachments/attachmentDetachState.js}

@@ -11,7 +11,7 @@
  * the attachment list before an unlink and writes it back after. Both read the
  * slot list, await, then save — so the slot they save may already be gone.
  */
-import { getDocumentAttachments } from "../../../data/documents/documentContent.js";
+import { getDocumentAttachments } from "../../../../data/documents/documentContent.js";
 function getLiveSlotIds(doc) {
     return new Set(getDocumentAttachments(doc).map((attachment) => attachment.slotId));
 }

package/stores/documents/documentStore/attachments/attachmentDetachState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentDetachState.js","sourceRoot":"","sources":["attachmentDetachState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAIpF,SAAS,cAAc,CAAC,GAAkB;IACxC,OAAO,IAAI,GAAG,CACZ,sBAAsB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CACnE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,WAAiD,EACjD,GAAyB;IAEzB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACpC,UAAU,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QACnE,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE;QAC/B,CAAC,CAAC,UAAU,CACf,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mCAAmC,CACjD,WAAiD,EACjD,GAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACxC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,UAAU,KAAK,CAAC,UAAU,CAAC,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Keeps a local attachment row's detach marker consistent with the document.\n *\n * The invariant is one line: a local blob row is marked detached exactly when\n * its slot is no longer in the document. The read models trust that marker to\n * decide whether a blob is still referenced, so anything that writes these rows\n * has to preserve it rather than restate what it believed the slots were.\n *\n * Two writers can otherwise clear a marker they never meant to touch: an upload\n * that settles after the user removed its slot, and a hydration that captured\n * the attachment list before an unlink and writes it back after. Both read the\n * slot list, await, then save — so the slot they save may already be gone.\n */\nimport { getDocumentAttachments } from \"../../../../data/documents/documentContent\";\nimport type { LocalAttachmentRecord } from \"../../../../workflows/documents\";\nimport type { DocumentState } from \"../state\";\n\nfunction getLiveSlotIds(doc: DocumentState): ReadonlySet<string> {\n  return new Set(\n    getDocumentAttachments(doc).map((attachment) => attachment.slotId),\n  );\n}\n\n/**\n * Stamp records being written for slots the document no longer has as detached.\n *\n * The document is read here, at write time, rather than trusted from the\n * caller's earlier snapshot — the Loro document is mutated in place, so this\n * sees any unlink that landed while the caller was awaiting.\n */\nexport function withLocalAttachmentDetachState(\n  attachments: ReadonlyArray<LocalAttachmentRecord>,\n  doc: DocumentState | null,\n): LocalAttachmentRecord[] {\n  if (!doc) {\n    return [...attachments];\n  }\n\n  const detachedAt = new Date().toISOString();\n  const liveSlotIds = getLiveSlotIds(doc);\n  return attachments.map((attachment) =>\n    attachment.detachedAt === null && !liveSlotIds.has(attachment.slotId)\n      ? { ...attachment, detachedAt }\n      : attachment,\n  );\n}\n\n/**\n * Report the loaded rows whose marker disagrees with the loaded document.\n *\n * A write can only be interrupted between marking the row and persisting the\n * document, so a restart can find either half applied. Reconciling against the\n * durable document at load makes the marker mean what it claims again: a slot\n * the document still has is live, and a slot it dropped is detached.\n */\nexport function reconcileLocalAttachmentDetachState(\n  attachments: ReadonlyArray<LocalAttachmentRecord>,\n  doc: DocumentState,\n): LocalAttachmentRecord[] {\n  const detachedAt = new Date().toISOString();\n  const liveSlotIds = getLiveSlotIds(doc);\n  return attachments.flatMap((attachment) => {\n    const slotIsLive = liveSlotIds.has(attachment.slotId);\n    if (slotIsLive === (attachment.detachedAt === null)) {\n      return [];\n    }\n\n    return [{ ...attachment, detachedAt: slotIsLive ? null : detachedAt }];\n  });\n}\n"]}

package/stores/documents/documentStore/{attachmentHydration.js → attachments/attachmentHydration.js}

@@ -1,10 +1,10 @@
 /** Hydrate only bytes matching the current document's authenticated attachment intent. */
-import { getDocumentAttachments } from "../../../data/documents/documentContent.js";
-import { hydrateDocumentAttachmentBlobs } from "../../../workflows/blobs/index.js";
-import { createRuntimePrincipalPolicyWarmer } from "../../../workflows/principals/runtimePolicyWarmer.js";
+import { getDocumentAttachments } from "../../../../data/documents/documentContent.js";
+import { hydrateDocumentAttachmentBlobs } from "../../../../workflows/blobs/index.js";
+import { createRuntimePrincipalPolicyWarmer } from "../../../../workflows/principals/runtimePolicyWarmer.js";
+import { runDocumentOrphanMaintenance } from "../orphanMaintenance.js";
+import { isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent, } from "../sync/syncGeneration.js";
 import { commitHydratedAttachment } from "./attachmentHydrationCommit.js";
-import { runDocumentOrphanMaintenance } from "./orphanMaintenance.js";
-import { isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent, } from "./syncGeneration.js";
 // A remote probe is evidence that bindings may have moved independently of
 // content. Capture its sequence before I/O so a hint arriving during hydration
 // survives for the trailing pass. Missing or changed local bytes always retry.

package/stores/documents/documentStore/attachments/attachmentHydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentHydration.js","sourceRoot":"","sources":["attachmentHydration.ts"],"names":[],"mappings":"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","sourcesContent":["/** Hydrate only bytes matching the current document's authenticated attachment intent. */\n\nimport { getDocumentAttachments } from \"../../../../data/documents/documentContent\";\nimport { hydrateDocumentAttachmentBlobs } from \"../../../../workflows/blobs\";\nimport type { DocumentRecord } from \"../../../../workflows/documents\";\nimport { createRuntimePrincipalPolicyWarmer } from \"../../../../workflows/principals/runtimePolicyWarmer\";\nimport { runDocumentOrphanMaintenance } from \"../orphanMaintenance\";\nimport type { DocumentState, DocumentStoreState } from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\nimport { commitHydratedAttachment } from \"./attachmentHydrationCommit\";\n\n// A remote probe is evidence that bindings may have moved independently of\n// content. Capture its sequence before I/O so a hint arriving during hydration\n// survives for the trailing pass. Missing or changed local bytes always retry.\nconst checkedSignals = new WeakMap<\n  DocumentStoreState,\n  { documentId: string; document: WeakRef<DocumentState>; sequence: number }\n>();\n\nexport async function hydrateAttachmentBlobs(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  currentRecord: DocumentRecord | null,\n  expectedGeneration?: DocumentStoreSyncGeneration,\n) {\n  const generationIsCurrent = () =>\n    !expectedGeneration || isSyncGenerationCurrent(state, expectedGeneration);\n  if (!generationIsCurrent()) return;\n\n  const runtime = state.runtime;\n  const encapsulationKeyPair = runtime.crypto.encapsulationKeyPair;\n  if (\n    !encapsulationKeyPair ||\n    !runtime.auth.isAuthenticated ||\n    !runtime.state.online ||\n    !currentRecord?.documentId\n  ) {\n    return;\n  }\n\n  const attachments = getDocumentAttachments(currentDoc);\n  if (attachments.length === 0) {\n    return;\n  }\n\n  const signalSequence = state.remoteUpdateSignalSeq;\n  if (\n    bindingsAlreadyChecked(\n      state,\n      currentDoc,\n      currentRecord.documentId,\n      attachments,\n      signalSequence,\n    )\n  )\n    return;\n\n  const expectedStorageKeys = { ...state.attachmentStorageKeyBySlotId };\n  let bindingsChecked = false;\n  const hydratedBlobs = await hydrateDocumentAttachmentBlobs({\n    apiClient: runtime.apiClient,\n    onBindingsChecked: () => {\n      bindingsChecked = true;\n    },\n    attachments,\n    documentId: currentRecord.documentId,\n    execSql: runtime.infra.execSql,\n    localBlobIdBySlotId: state.attachmentBlobIdBySlotId,\n    localStorageKeyBySlotId: state.attachmentStorageKeyBySlotId,\n    log: runtime.util.log,\n    rejectedServedBindings: state.rejectedServedAttachmentBindings,\n    reportSecurityIncident: runtime.util.reportSecurityIncident,\n    resolveProjectionUserKey:\n      expectedGeneration?.resolveProjectionUserKey ??\n      state.resolveProjectionUserKey,\n    targetSecretKey: encapsulationKeyPair.secretKey,\n    stillCurrent: generationIsCurrent,\n    warmReferencedPrincipalPolicies:\n      createRuntimePrincipalPolicyWarmer(runtime),\n  });\n  if (!generationIsCurrent()) return;\n  if (!hydratedBlobs) {\n    return;\n  }\n\n  for (const hydratedBlob of hydratedBlobs) {\n    await commitHydratedAttachment({\n      state,\n      currentDoc,\n      hydratedBlob,\n      generationIsCurrent,\n      expectedStorageKey:\n        expectedStorageKeys[hydratedBlob.attachment.slotId] ?? null,\n    });\n  }\n  if (\n    bindingsChecked &&\n    generationIsCurrent() &&\n    hydratedBlobs.every(\n      (blob) =>\n        state.attachmentBlobIdBySlotId[blob.attachment.slotId] ===\n        blob.binding.blobId,\n    )\n  ) {\n    checkedSignals.set(state, {\n      documentId: currentRecord.documentId,\n      document: new WeakRef(currentDoc),\n      sequence: signalSequence,\n    });\n  }\n  void runDocumentOrphanMaintenance(state);\n}\n\nfunction bindingsAlreadyChecked(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  documentId: string,\n  attachments: ReturnType<typeof getDocumentAttachments>,\n  signalSequence: number,\n): boolean {\n  const checked = checkedSignals.get(state);\n  const needsBindingProbe =\n    signalSequence >\n    (checked?.documentId === documentId &&\n    checked.document.deref() === currentDoc\n      ? checked.sequence\n      : 0);\n  return (\n    !needsBindingProbe &&\n    attachments.every(\n      (attachment) =>\n        state.attachmentStorageKeyBySlotId[attachment.slotId] &&\n        state.attachmentContentSha256BySlotId[attachment.slotId] ===\n          attachment.contentSha256,\n    )\n  );\n}\n"]}

package/stores/documents/documentStore/{attachmentHydrationCommit.js → attachments/attachmentHydrationCommit.js}

@@ -1,6 +1,6 @@
-import { getDocumentAttachments } from "../../../data/documents/documentContent.js";
-import { runSerializedDocumentBlobMutation, } from "../../../workflows/documents/index.js";
-import { saveHydratedDocumentAttachment } from "../../../workflows/documents/attachments/attachmentPersistence.js";
+import { getDocumentAttachments } from "../../../../data/documents/documentContent.js";
+import { runSerializedDocumentBlobMutation, } from "../../../../workflows/documents/index.js";
+import { saveHydratedDocumentAttachment } from "../../../../workflows/documents/attachments/attachmentPersistence.js";
 import { installLocalAttachmentRecords, removeLocalAttachmentSlot, } from "./attachmentPersistence.js";
 export async function commitHydratedAttachment(input) {
     const { state, currentDoc, hydratedBlob, expectedStorageKey, generationIsCurrent, } = input;

package/stores/documents/documentStore/attachments/attachmentHydrationCommit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentHydrationCommit.js","sourceRoot":"","sources":["attachmentHydrationCommit.ts"],"names":[],"mappings":"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","sourcesContent":["import { getDocumentAttachments } from \"../../../../data/documents/documentContent\";\nimport type { hydrateDocumentAttachmentBlobs } from \"../../../../workflows/blobs\";\nimport {\n  type LocalAttachmentRecord,\n  runSerializedDocumentBlobMutation,\n} from \"../../../../workflows/documents\";\nimport { saveHydratedDocumentAttachment } from \"../../../../workflows/documents/attachments/attachmentPersistence\";\nimport type { DocumentState, DocumentStoreState } from \"../state\";\nimport {\n  installLocalAttachmentRecords,\n  removeLocalAttachmentSlot,\n} from \"./attachmentPersistence\";\n\ntype HydratedBlob = NonNullable<\n  Awaited<ReturnType<typeof hydrateDocumentAttachmentBlobs>>\n>[number];\n\nexport async function commitHydratedAttachment(input: {\n  state: DocumentStoreState;\n  currentDoc: DocumentState;\n  hydratedBlob: Pick<\n    HydratedBlob,\n    \"attachment\" | \"bytes\" | \"contentSha256\" | \"storageKey\"\n  > & {\n    binding: Pick<HydratedBlob[\"binding\"], \"blobId\">;\n  };\n  expectedStorageKey: string | null;\n  generationIsCurrent: () => boolean;\n}): Promise<void> {\n  const {\n    state,\n    currentDoc,\n    hydratedBlob,\n    expectedStorageKey,\n    generationIsCurrent,\n  } = input;\n  const runtime = state.runtime;\n  const expectedSnapshotEndVersion = state.record?.snapshotEndVersion ?? null;\n  const stillCurrent = () =>\n    generationIsCurrent() &&\n    state.doc === currentDoc &&\n    getDocumentAttachments(currentDoc).some(\n      (attachment) =>\n        attachment.slotId === hydratedBlob.attachment.slotId &&\n        attachment.contentSha256 === hydratedBlob.attachment.contentSha256,\n    );\n  await runSerializedDocumentBlobMutation(\n    runtime.infra.execSql,\n    hydratedBlob.storageKey,\n    async () => {\n      if (!stillCurrent()) return;\n      await runtime.infra.blobStore.writeBytes(\n        hydratedBlob.storageKey,\n        hydratedBlob.bytes,\n      );\n      const attachment: LocalAttachmentRecord = {\n        blobId: hydratedBlob.binding.blobId,\n        // The held bytes' own size, not the document intent's: a served\n        // binding the intent has not recorded yet may differ in length, and\n        // preview gating reads the local record.\n        byteLength: hydratedBlob.bytes.byteLength,\n        contentSha256: hydratedBlob.contentSha256,\n        detachedAt: null,\n        localId: state.localId,\n        mimeType: hydratedBlob.attachment.mimeType,\n        slotId: hydratedBlob.attachment.slotId,\n        storageKey: hydratedBlob.storageKey,\n      };\n      const committed = await saveHydratedDocumentAttachment({\n        execSql: runtime.infra.execSql,\n        persistence: state.persistence,\n        attachment,\n        expectedStorageKey,\n        expectedSnapshotEndVersion,\n        stillCurrent,\n      });\n      if (committed && stillCurrent())\n        installLocalAttachmentRecords(state, [attachment], currentDoc);\n      else if (!committed && stillCurrent())\n        await refreshRefusedAttachmentSlot(input, stillCurrent);\n    },\n  );\n}\n\nasync function refreshRefusedAttachmentSlot(\n  input: Parameters<typeof commitHydratedAttachment>[0],\n  stillCurrent: () => boolean,\n): Promise<void> {\n  const { state, currentDoc, hydratedBlob } = input;\n  const rows = await state.persistence.listLocalAttachments(\n    state.runtime.infra.execSql,\n    state.localId,\n  );\n  if (!stillCurrent()) return;\n  const slotId = hydratedBlob.attachment.slotId;\n  removeLocalAttachmentSlot(state, slotId);\n  installLocalAttachmentRecords(\n    state,\n    rows.filter((row) => row.slotId === slotId),\n    currentDoc,\n  );\n}\n"]}

package/stores/documents/documentStore/{attachmentIntents.js → attachments/attachmentIntents.js}

@@ -1,5 +1,5 @@
-import { attachmentContentSha256 } from "../../../data/documents/attachmentContentIdentity.js";
-import { blobByteSourceInputLength } from "../../../workflows/blobs/index.js";
+import { attachmentContentSha256 } from "../../../../data/documents/attachmentContentIdentity.js";
+import { blobByteSourceInputLength } from "../../../../workflows/blobs/index.js";
 export async function buildPendingAttachments(localId, files) {
     const nextPendingAttachments = [];
     const nextAttachments = [];

package/stores/documents/documentStore/attachments/attachmentIntents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentIntents.js","sourceRoot":"","sources":["attachmentIntents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAE/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAe,EACf,KAA8C;IAK9C,MAAM,sBAAsB,GAA8B,EAAE,CAAC;IAC7D,MAAM,eAAe,GAAyB,EAAE,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChE,sBAAsB,CAAC,IAAI,CAAC;YAC1B,UAAU;YACV,aAAa;YACb,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM;YACN,UAAU;SACX,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC;YACnB,aAAa;YACb,UAAU;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,IAA8B;IAE9B,OAAO;QACL,aAAa,EAAE,MAAM,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC;QACxD,UAAU,EAAE,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM;KACP,CAAC;AACJ,CAAC","sourcesContent":["import { attachmentContentSha256 } from \"../../../../data/documents/attachmentContentIdentity\";\nimport type { DocumentAttachment } from \"../../../../data/documents/documentContent\";\nimport { blobByteSourceInputLength } from \"../../../../workflows/blobs\";\nimport type { PendingAttachmentRecord } from \"../../../../workflows/documents\";\nimport type { DocumentAttachmentUpload } from \"../../types\";\n\nexport async function buildPendingAttachments(\n  localId: string,\n  files: ReadonlyArray<DocumentAttachmentUpload>,\n): Promise<{\n  nextAttachments: DocumentAttachment[];\n  nextPendingAttachments: PendingAttachmentRecord[];\n}> {\n  const nextPendingAttachments: PendingAttachmentRecord[] = [];\n  const nextAttachments: DocumentAttachment[] = [];\n\n  for (const file of files) {\n    const slotId = crypto.randomUUID();\n    const storageKey = `${localId}-${slotId}`;\n    const byteLength = blobByteSourceInputLength(file.bytes);\n    const contentSha256 = await attachmentContentSha256(file.bytes);\n    nextPendingAttachments.push({\n      byteLength,\n      contentSha256,\n      localId,\n      mimeType: file.mimeType,\n      name: file.name,\n      slotId,\n      storageKey,\n    });\n    nextAttachments.push({\n      contentSha256,\n      byteLength,\n      mimeType: file.mimeType,\n      name: file.name,\n      slotId,\n    });\n  }\n\n  return { nextAttachments, nextPendingAttachments };\n}\n\nexport async function buildAttachmentIntent(\n  slotId: string,\n  file: DocumentAttachmentUpload,\n): Promise<DocumentAttachment> {\n  return {\n    contentSha256: await attachmentContentSha256(file.bytes),\n    byteLength: blobByteSourceInputLength(file.bytes),\n    mimeType: file.mimeType,\n    name: file.name,\n    slotId,\n  };\n}\n"]}

package/stores/documents/documentStore/{attachmentMutationPersistence.js → attachments/attachmentMutationPersistence.js}

@@ -1,7 +1,7 @@
-import { createPendingUpdateFields } from "../../../data/documents/documentSync.js";
-import { deleteUnreferencedStagedAttachmentBytes, } from "./attachmentStaging.js";
-import { reloadDocumentFromDurableHistory } from "./durableDocumentReload.js";
-import { persistDocument } from "./persistence.js";
+import { createPendingUpdateFields } from "../../../../data/documents/documentSync.js";
+import { deleteUnreferencedStagedAttachmentBytes, } from "../attachmentUpload/attachmentStaging.js";
+import { reloadDocumentFromDurableHistory } from "../history/durableDocumentReload.js";
+import { persistDocument } from "../persistence.js";
 export async function restoreFailedAttachmentMutation(input) {
     await reloadDocumentFromDurableHistory({
         expectedGeneration: input.generation,

package/stores/documents/documentStore/attachments/attachmentMutationPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentMutationPersistence.js","sourceRoot":"","sources":["attachmentMutationPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EACL,uCAAuC,GAExC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIjD,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,KAMrD;IACC,MAAM,gCAAgC,CAAC;QACrC,kBAAkB,EAAE,KAAK,CAAC,UAAU;QACpC,uCAAuC,EAAE,IAAI;QAC7C,oBAAoB,EAAE,KAAK,CAAC,gBAAgB;QAC5C,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,KAUrD;IACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,MAAM,eAAe,CAC1B,KAAK,EACL,KAAK,CAAC,UAAU,EAChB,EAAE,kBAAkB,EAAE,KAAK,CAAC,cAAc,EAAE,EAC5C;YACE,iBAAiB,EAAE,MAAM;YACzB,aAAa,EACX,yBAAyB,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,SAAS;YAChE,gCAAgC,EAAE,IAAI;YACtC,oBAAoB,EAAE,IAAI;SAC3B,EACD,KAAK,CAAC,UAAU,CACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,uCAAuC,CAAC;YAC5C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,KAAK;SACN,CAAC,CAAC;QACH,MAAM,+BAA+B,CAAC;YACpC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,KAAK;SACN,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import { createPendingUpdateFields } from \"../../../../data/documents/documentSync\";\nimport {\n  deleteUnreferencedStagedAttachmentBytes,\n  type stagePendingAttachments,\n} from \"../attachmentUpload/attachmentStaging\";\nimport { reloadDocumentFromDurableHistory } from \"../history/durableDocumentReload\";\nimport { persistDocument } from \"../persistence\";\nimport type { DocumentStoreState } from \"../state\";\nimport type { captureDocumentStoreSyncGeneration } from \"../sync/syncGeneration\";\n\nexport async function restoreFailedAttachmentMutation(input: {\n  generation: NonNullable<\n    ReturnType<typeof captureDocumentStoreSyncGeneration>\n  >;\n  rollbackSnapshot: Uint8Array;\n  state: DocumentStoreState;\n}): Promise<void> {\n  await reloadDocumentFromDurableHistory({\n    expectedGeneration: input.generation,\n    preserveQueuedWritesWhenIdentityMatches: true,\n    sameIdentitySnapshot: input.rollbackSnapshot,\n    state: input.state,\n  });\n}\n\nexport async function persistStagedAttachmentMutation(input: {\n  attachmentUpdate: Uint8Array;\n  coveredVersion: string;\n  currentDoc: NonNullable<DocumentStoreState[\"doc\"]>;\n  generation: NonNullable<\n    ReturnType<typeof captureDocumentStoreSyncGeneration>\n  >;\n  rollbackSnapshot: Uint8Array;\n  staged: NonNullable<Awaited<ReturnType<typeof stagePendingAttachments>>>;\n  state: DocumentStoreState;\n}) {\n  const { staged, state } = input;\n  try {\n    return await persistDocument(\n      state,\n      input.currentDoc,\n      { snapshotEndVersion: input.coveredVersion },\n      {\n        attachmentStaging: staged,\n        pendingUpdate:\n          createPendingUpdateFields(input.attachmentUpdate) ?? undefined,\n        preserveSnapshotStructuredFields: true,\n        preserveSnapshotText: true,\n      },\n      input.generation,\n    );\n  } catch (error) {\n    await deleteUnreferencedStagedAttachmentBytes({\n      generation: input.generation,\n      pendingAttachments: staged.pendingAttachments,\n      state,\n    });\n    await restoreFailedAttachmentMutation({\n      generation: input.generation,\n      rollbackSnapshot: input.rollbackSnapshot,\n      state,\n    });\n    throw error;\n  }\n}\n"]}

package/stores/documents/documentStore/attachments/attachmentPersistFollowup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentPersistFollowup.js","sourceRoot":"","sources":["attachmentPersistFollowup.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,KAMlD;IACC,IACE,KAAK,CAAC,2BAA2B,KAAK,KAAK,CAAC,4BAA4B;QACxE,KAAK,CAAC,iBAAiB,KAAK,KAAK,CAAC,kBAAkB,EACpD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,CACL,KAAK,CAAC,SAAS,CAAC,0BAA0B,KAAK,IAAI;QACnD,KAAK,CAAC,SAAS,CAAC,sBAAsB,KAAK,IAAI,CAChD,CAAC;AACJ,CAAC","sourcesContent":["import type { PersistedDocumentRecord } from \"../state\";\n\n/**\n * A same-identity conflict may still leave newer durable work for the current\n * lane to submit. Identity replacement and local teardown deliberately do not\n * schedule the losing document against the replacement generation.\n */\nexport function attachmentPersistNeedsFollowupSync(input: {\n  currentDocumentId: string | null | undefined;\n  currentLocalWriteGeneration: number;\n  expectedDocumentId: string | null;\n  expectedLocalWriteGeneration: number;\n  persisted: PersistedDocumentRecord | null;\n}): boolean {\n  if (\n    input.currentLocalWriteGeneration !== input.expectedLocalWriteGeneration ||\n    input.currentDocumentId !== input.expectedDocumentId\n  ) {\n    return false;\n  }\n  if (!input.persisted) return true;\n  return (\n    input.persisted.pullContinuationSuperseded === true &&\n    input.persisted.syncIdentitySuperseded !== true\n  );\n}\n"]}

package/stores/documents/documentStore/{attachmentPersistence.js → attachments/attachmentPersistence.js}

@@ -1,8 +1,8 @@
-import { deleteLocalDocumentAttachment, deletePendingDocumentAttachment, saveLocalDocumentAttachments, savePendingDocumentAttachment, } from "../../../workflows/documents/index.js";
+import { deleteLocalDocumentAttachment, deletePendingDocumentAttachment, saveLocalDocumentAttachments, savePendingDocumentAttachment, } from "../../../../workflows/documents/index.js";
+import { withGenerationGuardedMutation } from "../persistence.js";
+import { setReadySnapshot, } from "../state.js";
+import { isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent, } from "../sync/syncGeneration.js";
 import { withLocalAttachmentDetachState } from "./attachmentDetachState.js";
-import { withGenerationGuardedMutation } from "./persistence.js";
-import { setReadySnapshot, } from "./state.js";
-import { isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent, } from "./syncGeneration.js";
 export async function deletePendingAttachment(state, slotId, storageKey, expectedGeneration) {
     // After a REFUSED discard the reset store keeps its rows, and a stale pass
     // racing that reset must not delete state the refusal deliberately

package/stores/documents/documentStore/attachments/attachmentPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentPersistence.js","sourceRoot":"","sources":["attachmentPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  deleteLocalDocumentAttachment,\n  deletePendingDocumentAttachment,\n  type LocalAttachmentRecord,\n  type PendingAttachmentRecord,\n  saveLocalDocumentAttachments,\n  savePendingDocumentAttachment,\n} from \"../../../../workflows/documents\";\nimport { withGenerationGuardedMutation } from \"../persistence\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  setReadySnapshot,\n} from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\nimport { withLocalAttachmentDetachState } from \"./attachmentDetachState\";\n\nexport async function deletePendingAttachment(\n  state: DocumentStoreState,\n  slotId: string,\n  storageKey: string,\n  expectedGeneration?: DocumentStoreSyncGeneration,\n) {\n  // After a REFUSED discard the reset store keeps its rows, and a stale pass\n  // racing that reset must not delete state the refusal deliberately\n  // preserved.\n  await withGenerationGuardedMutation(state, expectedGeneration, (execSql) =>\n    deletePendingDocumentAttachment({\n      execSql,\n      localId: state.localId,\n      persistence: state.persistence,\n      slotId,\n      storageKey,\n    }),\n  );\n}\n\nexport async function deleteLocalAttachmentRecord(\n  state: DocumentStoreState,\n  slotId: string,\n  storageKey: string,\n  currentDoc: DocumentState | null = state.doc,\n) {\n  await deleteLocalDocumentAttachment({\n    execSql: state.runtime.infra.execSql,\n    localId: state.localId,\n    persistence: state.persistence,\n    slotId,\n    storageKey,\n  });\n\n  if (state.attachmentStorageKeyBySlotId[slotId] === storageKey) {\n    removeLocalAttachmentSlot(state, slotId);\n  }\n\n  if (currentDoc && currentDoc === state.doc) {\n    setReadySnapshot(\n      state,\n      currentDoc,\n      state.snapshot.syncing,\n      state.snapshot.text,\n      state.snapshot.structuredFields,\n    );\n  }\n}\n\nexport async function saveLocalAttachmentRecord(\n  state: DocumentStoreState,\n  attachment: LocalAttachmentRecord,\n  currentDoc: DocumentState | null = state.doc,\n  expectedGeneration?: DocumentStoreSyncGeneration,\n) {\n  await saveLocalAttachmentRecords(\n    state,\n    [attachment],\n    currentDoc,\n    expectedGeneration,\n  );\n}\n\nexport async function saveLocalAttachmentRecords(\n  state: DocumentStoreState,\n  attachments: ReadonlyArray<LocalAttachmentRecord>,\n  currentDoc: DocumentState | null = state.doc,\n  expectedGeneration?: DocumentStoreSyncGeneration,\n) {\n  if (attachments.length === 0) {\n    return;\n  }\n\n  // These rows are upserts, and a stale writer racing a teardown must never\n  // re-insert what the teardown just removed.\n  const saved = await withGenerationGuardedMutation(\n    state,\n    expectedGeneration,\n    (execSql) =>\n      saveLocalDocumentAttachments({\n        attachments: withLocalAttachmentDetachState(attachments, currentDoc),\n        execSql,\n        persistence: state.persistence,\n      }),\n  );\n  if (\n    !saved ||\n    (expectedGeneration && !isSyncGenerationCurrent(state, expectedGeneration))\n  ) {\n    return;\n  }\n\n  installLocalAttachmentRecords(state, attachments, currentDoc);\n}\n\ntype AttachmentSlot = Pick<\n  LocalAttachmentRecord,\n  \"slotId\" | \"blobId\" | \"contentSha256\" | \"storageKey\"\n>;\n\n/** Publish the held copy of each record's slot to the store's slot maps. */\nexport function assignLocalAttachmentSlots(\n  state: DocumentStoreState,\n  attachments: ReadonlyArray<AttachmentSlot>,\n): void {\n  const entries = <T>(pick: (attachment: AttachmentSlot) => T) =>\n    Object.fromEntries(\n      attachments.map((attachment) => [attachment.slotId, pick(attachment)]),\n    );\n  state.attachmentBlobIdBySlotId = {\n    ...state.attachmentBlobIdBySlotId,\n    ...entries((attachment) => attachment.blobId),\n  };\n  state.attachmentContentSha256BySlotId = {\n    ...state.attachmentContentSha256BySlotId,\n    ...entries((attachment) => attachment.contentSha256),\n  };\n  state.attachmentStorageKeyBySlotId = {\n    ...state.attachmentStorageKeyBySlotId,\n    ...entries((attachment) => attachment.storageKey),\n  };\n}\n\n/** Forget the held copy of one slot without touching its durable row. */\nexport function removeLocalAttachmentSlot(\n  state: DocumentStoreState,\n  slotId: string,\n): void {\n  const { [slotId]: _blobId, ...blobIds } = state.attachmentBlobIdBySlotId;\n  const { [slotId]: _contentSha256, ...contentSha256s } =\n    state.attachmentContentSha256BySlotId;\n  const { [slotId]: _storageKey, ...storageKeys } =\n    state.attachmentStorageKeyBySlotId;\n  state.attachmentBlobIdBySlotId = blobIds;\n  state.attachmentContentSha256BySlotId = contentSha256s;\n  state.attachmentStorageKeyBySlotId = storageKeys;\n}\n\nexport function installLocalAttachmentRecords(\n  state: DocumentStoreState,\n  attachments: ReadonlyArray<LocalAttachmentRecord>,\n  currentDoc: DocumentState | null,\n) {\n  assignLocalAttachmentSlots(state, attachments);\n\n  if (currentDoc && currentDoc === state.doc) {\n    setReadySnapshot(\n      state,\n      currentDoc,\n      state.snapshot.syncing,\n      state.snapshot.text,\n      state.snapshot.structuredFields,\n    );\n  }\n}\n\nexport function upsertPendingAttachments(\n  state: DocumentStoreState,\n  nextPendingAttachments: ReadonlyArray<PendingAttachmentRecord>,\n) {\n  const nextSlotIds = new Set(\n    nextPendingAttachments.map((pendingAttachment) => pendingAttachment.slotId),\n  );\n  state.pendingAttachments = [\n    ...state.pendingAttachments.filter(\n      (pendingAttachment) => !nextSlotIds.has(pendingAttachment.slotId),\n    ),\n    ...nextPendingAttachments,\n  ];\n}\n\n/**\n * Persist a pending attachment's upload-resume identity (blob id, content key,\n * IV, and — once staged — the multipart stage id/part size) so a later attempt\n * reuses it instead of orphaning the stage. The caller publishes the saved\n * identity on the live pending record only after this write succeeds.\n */\nexport async function savePendingAttachmentUpload(\n  state: DocumentStoreState,\n  pendingAttachment: PendingAttachmentRecord,\n  expectedGeneration?: DocumentStoreSyncGeneration,\n): Promise<void> {\n  // This row is an upsert, and a stale resume racing a teardown must never\n  // re-insert the pending row the teardown just removed.\n  await withGenerationGuardedMutation(state, expectedGeneration, (execSql) =>\n    savePendingDocumentAttachment({\n      attachment: pendingAttachment,\n      execSql,\n      persistence: state.persistence,\n    }),\n  );\n}\n"]}

package/stores/documents/documentStore/{attachmentRemoval.js → attachments/attachmentRemoval.js}

@@ -1,17 +1,17 @@
-import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../internal/loro/index.js";
-import { getDocumentAttachments, removeDocumentAttachment, } from "../../../data/documents/documentContent.js";
-import { createPendingUpdateFields } from "../../../data/documents/documentSync.js";
-import { requestDocumentStoreSync } from "../registry.js";
+import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../../internal/loro/index.js";
+import { getDocumentAttachments, removeDocumentAttachment, } from "../../../../data/documents/documentContent.js";
+import { createPendingUpdateFields } from "../../../../data/documents/documentSync.js";
+import { requestDocumentStoreSync } from "../../registry.js";
+import { ensureDocumentStoreReady } from "../initialization/index.js";
+import { runDocumentOrphanMaintenance } from "../orphanMaintenance.js";
+import { advancePendingBaseVersion, pendingDeltaSinceBase, persistDocument, } from "../persistence.js";
+import { reportDocumentStoreWriteFailure } from "../reportWriteFailure.js";
+import { canWriteDocument, setReadySnapshot, } from "../state.js";
+import { captureDocumentStoreSyncGeneration } from "../sync/syncGeneration.js";
 import { restoreFailedAttachmentMutation } from "./attachmentMutationPersistence.js";
 import { assignLocalAttachmentSlots, removeLocalAttachmentSlot, } from "./attachmentPersistence.js";
-import { ATTACHMENT_FAILURE_MESSAGE } from "./attachments.js";
 import { captureAttachmentWriteGeneration, isAttachmentWriteGenerationCurrent, shouldAbortAttachmentPersistFollowup, } from "./attachmentWriteGeneration.js";
-import { ensureDocumentStoreReady } from "./initialization.js";
-import { runDocumentOrphanMaintenance } from "./orphanMaintenance.js";
-import { advancePendingBaseVersion, pendingDeltaSinceBase, persistDocument, } from "./persistence.js";
-import { reportDocumentStoreWriteFailure } from "./reportWriteFailure.js";
-import { canWriteDocument, setReadySnapshot, } from "./state.js";
-import { captureDocumentStoreSyncGeneration } from "./syncGeneration.js";
+import { ATTACHMENT_FAILURE_MESSAGE } from "./index.js";
 function installCommittedAttachmentRemoval(input) {
     const { slotId, state, storageKey } = input;
     if (!storageKey)

package/stores/documents/documentStore/attachments/attachmentRemoval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentRemoval.js","sourceRoot":"","sources":["attachmentRemoval.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  encodeVersionVector,\n  exportFullHistorySnapshot,\n} from \"@tearleads/loro\";\nimport {\n  getDocumentAttachments,\n  removeDocumentAttachment,\n} from \"../../../../data/documents/documentContent\";\nimport { createPendingUpdateFields } from \"../../../../data/documents/documentSync\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport { ensureDocumentStoreReady } from \"../initialization\";\nimport { runDocumentOrphanMaintenance } from \"../orphanMaintenance\";\nimport {\n  advancePendingBaseVersion,\n  pendingDeltaSinceBase,\n  persistDocument,\n} from \"../persistence\";\nimport { reportDocumentStoreWriteFailure } from \"../reportWriteFailure\";\nimport {\n  canWriteDocument,\n  type DocumentStoreState,\n  setReadySnapshot,\n} from \"../state\";\nimport { captureDocumentStoreSyncGeneration } from \"../sync/syncGeneration\";\nimport { restoreFailedAttachmentMutation } from \"./attachmentMutationPersistence\";\nimport {\n  assignLocalAttachmentSlots,\n  removeLocalAttachmentSlot,\n} from \"./attachmentPersistence\";\nimport {\n  type AttachmentWriteGeneration,\n  captureAttachmentWriteGeneration,\n  isAttachmentWriteGenerationCurrent,\n  shouldAbortAttachmentPersistFollowup,\n} from \"./attachmentWriteGeneration\";\nimport { ATTACHMENT_FAILURE_MESSAGE } from \"./index\";\n\nfunction installCommittedAttachmentRemoval(input: {\n  currentDoc: NonNullable<DocumentStoreState[\"doc\"]>;\n  slotId: string;\n  state: DocumentStoreState;\n  storageKey: string | undefined;\n  syncedAttachment: boolean;\n}): void {\n  const { slotId, state, storageKey } = input;\n  if (!storageKey) return;\n  const pending = state.pendingAttachments.find(\n    (attachment) =>\n      attachment.slotId === slotId && attachment.storageKey === storageKey,\n  );\n  if (input.syncedAttachment && pending?.upload) {\n    assignLocalAttachmentSlots(state, [\n      {\n        slotId,\n        storageKey,\n        blobId: pending.upload.blobId,\n        contentSha256: pending.contentSha256,\n      },\n    ]);\n  }\n  state.pendingAttachments = state.pendingAttachments.filter(\n    (attachment) =>\n      attachment.slotId !== slotId || attachment.storageKey !== storageKey,\n  );\n  // The committed removal queued this key. A reset can leave another document\n  // uploading from the same copy; a detached marker keeps it until sync.\n  void runDocumentOrphanMaintenance(state);\n  if (\n    input.syncedAttachment ||\n    state.attachmentStorageKeyBySlotId[slotId] !== storageKey\n  ) {\n    return;\n  }\n  removeLocalAttachmentSlot(state, slotId);\n  setReadySnapshot(\n    state,\n    input.currentDoc,\n    state.snapshot.syncing,\n    state.snapshot.text,\n    state.snapshot.structuredFields,\n  );\n}\n\nasync function persistRemovedAttachment(\n  state: DocumentStoreState,\n  slotId: string,\n  writeGeneration: AttachmentWriteGeneration,\n) {\n  if (!isAttachmentWriteGenerationCurrent(state, writeGeneration)) return;\n  const currentDoc = state.doc;\n  if (!currentDoc) {\n    return;\n  }\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation) {\n    return;\n  }\n\n  const existingAttachment = getDocumentAttachments(currentDoc).find(\n    (attachment) => attachment.slotId === slotId,\n  );\n  if (!existingAttachment) {\n    return;\n  }\n\n  // After a reset, a store opened cold holds the slot only as a pending upload.\n  const storageKey =\n    state.attachmentStorageKeyBySlotId[slotId] ??\n    state.pendingAttachments.find((attachment) => attachment.slotId === slotId)\n      ?.storageKey;\n  if (\n    !isAttachmentWriteGenerationCurrent(state, writeGeneration) ||\n    state.doc !== currentDoc\n  )\n    return;\n  const rollbackSnapshot = exportFullHistorySnapshot(currentDoc).slice();\n  removeDocumentAttachment(currentDoc, slotId);\n  const attachmentUpdate = pendingDeltaSinceBase(state, currentDoc);\n  const coveredVersion = encodeVersionVector(currentDoc);\n  const pendingUpdate = createPendingUpdateFields(attachmentUpdate);\n  const syncedAttachment = Boolean(state.record?.documentId);\n\n  // Preserve the optimistic text/structured fields (see persistAttachedFiles):\n  // removing an attachment while typing must not regress the editor.\n  let persisted: Awaited<ReturnType<typeof persistDocument>>;\n  try {\n    persisted = await persistDocument(\n      state,\n      currentDoc,\n      { snapshotEndVersion: coveredVersion },\n      {\n        ...(storageKey\n          ? {\n              attachmentRemoval: {\n                mode: syncedAttachment\n                  ? (\"detach\" as const)\n                  : (\"delete\" as const),\n                slotId,\n                storageKey,\n              },\n            }\n          : {}),\n        ...(pendingUpdate ? { pendingUpdate } : {}),\n        preserveSnapshotStructuredFields: true,\n        preserveSnapshotText: true,\n      },\n      generation,\n    );\n  } catch (error) {\n    await restoreFailedAttachmentMutation({\n      generation,\n      rollbackSnapshot,\n      state,\n    });\n    throw error;\n  }\n  if (\n    shouldAbortAttachmentPersistFollowup(\n      state,\n      writeGeneration,\n      generation,\n      persisted,\n    )\n  ) {\n    // See persistAttachedFiles: only durable same-identity work re-arms sync.\n    return;\n  }\n  installCommittedAttachmentRemoval({\n    currentDoc,\n    slotId,\n    state,\n    storageKey,\n    syncedAttachment,\n  });\n  advancePendingBaseVersion(state, currentDoc);\n  state.runtime.util.log(\n    `Removed attachment ${existingAttachment.name} from document ${state.localId}.`,\n  );\n  requestDocumentStoreSync(state);\n}\n\nexport async function removeAttachmentFromDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  slotId: string,\n) {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);\n    return;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return;\n  }\n\n  const writeGeneration = captureAttachmentWriteGeneration(state);\n  if (!writeGeneration) return;\n  state.writeChain = state.writeChain\n    .catch(() => undefined)\n    .then(async () => persistRemovedAttachment(state, slotId, writeGeneration))\n    .catch((error: unknown) => {\n      reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);\n    });\n  return state.writeChain;\n}\n"]}

package/stores/documents/documentStore/attachments/attachmentSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentSnapshot.js","sourceRoot":"","sources":["attachmentSnapshot.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CACtC,kBAAoD,EACpD,WAA8C;IAE9C,MAAM,eAAe,GAA2B,EAAE,CAAC;IAEnD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,UAAU,EAAE,CAAC;YACf,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAIrC;IACC,MAAM,YAAY,GAA6C,EAAE,CAAC;IAElE,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChD,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,MAAM,iBAAiB,GAAG,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACzE,IACE,iBAAiB,KAAK,SAAS;YAC/B,iBAAiB,KAAK,UAAU,CAAC,aAAa,EAC9C,CAAC;YACD,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["import type { DocumentAttachment } from \"../../../../data/documents/documentContent\";\nimport type { DocumentAttachmentStatus } from \"../../types\";\n\nexport function getAttachmentStorageKeys(\n  storageKeyBySlotId: Readonly<Record<string, string>>,\n  attachments: ReadonlyArray<DocumentAttachment>,\n): Record<string, string> {\n  const nextStorageKeys: Record<string, string> = {};\n\n  for (const attachment of attachments) {\n    const storageKey = storageKeyBySlotId[attachment.slotId];\n    if (storageKey) {\n      nextStorageKeys[attachment.slotId] = storageKey;\n    }\n  }\n\n  return nextStorageKeys;\n}\n\n/**\n * A slot is `syncing` while its upload is queued. Otherwise it is\n * `intent-mismatch` when the held bytes' digest differs from the digest the\n * document content records: a validly signed served binding the document has\n * not (yet) recorded. The status clears by itself once the content update\n * carrying the digest arrives or a matching binding is hydrated.\n */\nexport function getAttachmentStatuses(input: {\n  attachments: ReadonlyArray<DocumentAttachment>;\n  contentSha256BySlotId: Readonly<Record<string, string>>;\n  pendingSlotIds: ReadonlySet<string>;\n}): Record<string, DocumentAttachmentStatus> {\n  const nextStatuses: Record<string, DocumentAttachmentStatus> = {};\n\n  for (const attachment of input.attachments) {\n    if (input.pendingSlotIds.has(attachment.slotId)) {\n      nextStatuses[attachment.slotId] = \"syncing\";\n      continue;\n    }\n    const heldContentSha256 = input.contentSha256BySlotId[attachment.slotId];\n    if (\n      heldContentSha256 !== undefined &&\n      heldContentSha256 !== attachment.contentSha256\n    ) {\n      nextStatuses[attachment.slotId] = \"intent-mismatch\";\n    }\n  }\n\n  return nextStatuses;\n}\n"]}

package/stores/documents/documentStore/{attachmentWriteGeneration.js → attachments/attachmentWriteGeneration.js}

@@ -1,6 +1,6 @@
-import { requestDocumentStoreSync } from "../registry.js";
+import { requestDocumentStoreSync } from "../../registry.js";
+import { isDocumentStoreSyncGenerationCurrent, } from "../sync/syncGeneration.js";
 import { attachmentPersistNeedsFollowupSync } from "./attachmentPersistFollowup.js";
-import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 export function captureAttachmentWriteGeneration(state) {
     if (!state.record)
         return null;

package/stores/documents/documentStore/attachments/attachmentWriteGeneration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentWriteGeneration.js","sourceRoot":"","sources":["attachmentWriteGeneration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAEL,oCAAoC,GACrC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kCAAkC,EAAE,MAAM,6BAA6B,CAAC;AAOjF,MAAM,UAAU,gCAAgC,CAC9C,KAAyB;IAEzB,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU;QACnC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAAyB,EACzB,UAAqC;IAErC,OAAO,CACL,KAAK,CAAC,oBAAoB,KAAK,UAAU,CAAC,oBAAoB;QAC9D,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,CAAC,UAAU,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAyB,EACzB,eAA0C,EAC1C,cAA2C,EAC3C,SAAyC;IAEzC,IACE,kCAAkC,CAAC;QACjC,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;QAC3C,2BAA2B,EAAE,KAAK,CAAC,oBAAoB;QACvD,kBAAkB,EAAE,eAAe,CAAC,UAAU;QAC9C,4BAA4B,EAAE,eAAe,CAAC,oBAAoB;QAClE,SAAS;KACV,CAAC,EACF,CAAC;QACD,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,OAAO,CACL,SAAS,CAAC,0BAA0B,KAAK,IAAI;QAC7C,SAAS,CAAC,sBAAsB,KAAK,IAAI;QACzC,CAAC,oCAAoC,CAAC,KAAK,EAAE,cAAc,CAAC,CAC7D,CAAC;AACJ,CAAC","sourcesContent":["import { requestDocumentStoreSync } from \"../../registry\";\nimport type { DocumentStoreState, PersistedDocumentRecord } from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\nimport { attachmentPersistNeedsFollowupSync } from \"./attachmentPersistFollowup\";\n\nexport interface AttachmentWriteGeneration {\n  documentId: string | null;\n  localWriteGeneration: number;\n}\n\nexport function captureAttachmentWriteGeneration(\n  state: DocumentStoreState,\n): AttachmentWriteGeneration | null {\n  if (!state.record) return null;\n  return {\n    documentId: state.record.documentId,\n    localWriteGeneration: state.localWriteGeneration,\n  };\n}\n\nexport function isAttachmentWriteGenerationCurrent(\n  state: DocumentStoreState,\n  generation: AttachmentWriteGeneration,\n): boolean {\n  return (\n    state.localWriteGeneration === generation.localWriteGeneration &&\n    state.record?.documentId === generation.documentId\n  );\n}\n\nexport function shouldAbortAttachmentPersistFollowup(\n  state: DocumentStoreState,\n  writeGeneration: AttachmentWriteGeneration,\n  syncGeneration: DocumentStoreSyncGeneration,\n  persisted: PersistedDocumentRecord | null,\n): boolean {\n  if (\n    attachmentPersistNeedsFollowupSync({\n      currentDocumentId: state.record?.documentId,\n      currentLocalWriteGeneration: state.localWriteGeneration,\n      expectedDocumentId: writeGeneration.documentId,\n      expectedLocalWriteGeneration: writeGeneration.localWriteGeneration,\n      persisted,\n    })\n  ) {\n    requestDocumentStoreSync(state);\n  }\n  if (!persisted) return true;\n\n  return (\n    persisted.pullContinuationSuperseded === true ||\n    persisted.syncIdentitySuperseded === true ||\n    !isDocumentStoreSyncGenerationCurrent(state, syncGeneration)\n  );\n}\n"]}

package/stores/documents/documentStore/{attachments.js → attachments/index.js}

@@ -1,16 +1,16 @@
-import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../internal/loro/index.js";
-import { addDocumentAttachments } from "../../../data/documents/documentContent.js";
-import { requestDocumentStoreSync } from "../registry.js";
+import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../../internal/loro/index.js";
+import { addDocumentAttachments } from "../../../../data/documents/documentContent.js";
+import { requestDocumentStoreSync } from "../../registry.js";
+import { deleteUnreferencedStagedAttachmentBytes, installPendingAttachmentRows, stagePendingAttachments, } from "../attachmentUpload/attachmentStaging.js";
+import { ensureDocumentStoreReady } from "../initialization/index.js";
+import { settleDeferredInitialUpdate } from "../initialization/deferredInitialUpdate.js";
+import { advancePendingBaseVersion, pendingDeltaSinceBase, } from "../persistence.js";
+import { reportDocumentStoreWriteFailure } from "../reportWriteFailure.js";
+import { canAttachFiles, canWriteDocument, } from "../state.js";
+import { captureDocumentStoreSyncGeneration } from "../sync/syncGeneration.js";
 import { buildAttachmentIntent, buildPendingAttachments, } from "./attachmentIntents.js";
 import { persistStagedAttachmentMutation, restoreFailedAttachmentMutation, } from "./attachmentMutationPersistence.js";
-import { deleteUnreferencedStagedAttachmentBytes, installPendingAttachmentRows, stagePendingAttachments, } from "./attachmentStaging.js";
 import { captureAttachmentWriteGeneration, isAttachmentWriteGenerationCurrent, shouldAbortAttachmentPersistFollowup, } from "./attachmentWriteGeneration.js";
-import { settleDeferredInitialUpdate } from "./deferredInitialUpdate.js";
-import { ensureDocumentStoreReady } from "./initialization.js";
-import { advancePendingBaseVersion, pendingDeltaSinceBase, } from "./persistence.js";
-import { reportDocumentStoreWriteFailure } from "./reportWriteFailure.js";
-import { canAttachFiles, canWriteDocument, } from "./state.js";
-import { captureDocumentStoreSyncGeneration } from "./syncGeneration.js";
 // Fixed literal: a reported message must never carry file names or slot ids.
 export const ATTACHMENT_FAILURE_MESSAGE = "Documents: attachment mutation failed";
 function logAttachedFiles(state, count) {
@@ -238,4 +238,4 @@ export async function replaceAttachmentInDocumentStore(state, scheduleSync, slot
     });
     return state.writeChain;
 }
-//# sourceMappingURL=attachments.js.map
+//# sourceMappingURL=index.js.map

package/stores/documents/documentStore/attachments/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  encodeVersionVector,\n  exportFullHistorySnapshot,\n} from \"@tearleads/loro\";\nimport { addDocumentAttachments } from \"../../../../data/documents/documentContent\";\nimport type { PendingAttachmentRecord } from \"../../../../workflows/documents\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport type { DocumentAttachmentUpload } from \"../../types\";\nimport {\n  deleteUnreferencedStagedAttachmentBytes,\n  installPendingAttachmentRows,\n  stagePendingAttachments,\n} from \"../attachmentUpload/attachmentStaging\";\nimport { ensureDocumentStoreReady } from \"../initialization\";\nimport { settleDeferredInitialUpdate } from \"../initialization/deferredInitialUpdate\";\nimport {\n  advancePendingBaseVersion,\n  pendingDeltaSinceBase,\n} from \"../persistence\";\nimport { reportDocumentStoreWriteFailure } from \"../reportWriteFailure\";\nimport {\n  canAttachFiles,\n  canWriteDocument,\n  type DocumentStoreState,\n} from \"../state\";\nimport { captureDocumentStoreSyncGeneration } from \"../sync/syncGeneration\";\nimport {\n  buildAttachmentIntent,\n  buildPendingAttachments,\n} from \"./attachmentIntents\";\nimport {\n  persistStagedAttachmentMutation,\n  restoreFailedAttachmentMutation,\n} from \"./attachmentMutationPersistence\";\nimport {\n  type AttachmentWriteGeneration,\n  captureAttachmentWriteGeneration,\n  isAttachmentWriteGenerationCurrent,\n  shouldAbortAttachmentPersistFollowup,\n} from \"./attachmentWriteGeneration\";\n\n// Fixed literal: a reported message must never carry file names or slot ids.\nexport const ATTACHMENT_FAILURE_MESSAGE =\n  \"Documents: attachment mutation failed\";\n\nfunction logAttachedFiles(state: DocumentStoreState, count: number) {\n  state.runtime.util.log(\n    state.runtime.state.online && state.runtime.auth.isAuthenticated\n      ? `Attached ${count} file${count === 1 ? \"\" : \"s\"} to document ${state.localId}.`\n      : `Stored ${count} attachment${count === 1 ? \"\" : \"s\"} locally for document ${state.localId}.`,\n  );\n}\n\nasync function persistAttachedFiles(\n  state: DocumentStoreState,\n  files: ReadonlyArray<DocumentAttachmentUpload>,\n  writeGeneration: AttachmentWriteGeneration,\n) {\n  if (!isAttachmentWriteGenerationCurrent(state, writeGeneration)) return;\n  const currentDoc = state.doc;\n\n  if (!currentDoc || !canAttachFiles(state)) {\n    state.runtime.util.log(\n      \"Documents: attachments require a local key package.\",\n    );\n    return;\n  }\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation) {\n    return;\n  }\n\n  const { nextAttachments, nextPendingAttachments } =\n    await buildPendingAttachments(state.localId, files);\n  if (\n    !isAttachmentWriteGenerationCurrent(state, writeGeneration) ||\n    state.doc !== currentDoc\n  )\n    return;\n  const rollbackSnapshot = exportFullHistorySnapshot(currentDoc).slice();\n  addDocumentAttachments(currentDoc, nextAttachments);\n  const attachmentUpdate = pendingDeltaSinceBase(state, currentDoc);\n  // Captured at delta time: the enqueued row proves coverage up to exactly\n  // this version, so it is the frontier the persist below may publish.\n  const coveredVersion = encodeVersionVector(currentDoc);\n\n  let staged: Awaited<ReturnType<typeof stagePendingAttachments>>;\n  try {\n    staged = await stagePendingAttachments({\n      files,\n      generation,\n      pendingAttachments: nextPendingAttachments,\n      state,\n    });\n  } catch (error) {\n    await restoreFailedAttachmentMutation({\n      generation,\n      rollbackSnapshot,\n      state,\n    });\n    throw error;\n  }\n  if (!staged) {\n    await restoreFailedAttachmentMutation({\n      generation,\n      rollbackSnapshot,\n      state,\n    });\n    return;\n  }\n  // This persist changes attachments, not prose. setReadySnapshot always\n  // re-derives attachments from the doc, but preserve the text/structured\n  // fields so an attach that overlaps an in-flight keystroke does not republish\n  // a stale doc read over the live optimistic editor value.\n  const persisted = await persistStagedAttachmentMutation({\n    attachmentUpdate,\n    coveredVersion,\n    currentDoc,\n    generation,\n    rollbackSnapshot,\n    staged,\n    state,\n  });\n  if (\n    shouldAbortAttachmentPersistFollowup(\n      state,\n      writeGeneration,\n      generation,\n      persisted,\n    )\n  ) {\n    await deleteUnreferencedStagedAttachmentBytes({\n      generation,\n      pendingAttachments: staged.pendingAttachments,\n      state,\n    });\n    return;\n  }\n  installPendingAttachmentRows({ ...staged, state });\n  advancePendingBaseVersion(state, currentDoc);\n  logAttachedFiles(state, files.length);\n  requestDocumentStoreSync(state);\n}\n\nasync function persistSlotAttachmentFile(\n  state: DocumentStoreState,\n  slotId: string,\n  file: DocumentAttachmentUpload,\n  writeGeneration: AttachmentWriteGeneration,\n) {\n  if (!isAttachmentWriteGenerationCurrent(state, writeGeneration)) return;\n  const currentDoc = state.doc;\n\n  if (!currentDoc || !canAttachFiles(state)) {\n    state.runtime.util.log(\n      \"Documents: slot attachments require a local key package.\",\n    );\n    return;\n  }\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation) {\n    return;\n  }\n\n  const replacementAttachment = await buildAttachmentIntent(slotId, file);\n  if (\n    !isAttachmentWriteGenerationCurrent(state, writeGeneration) ||\n    state.doc !== currentDoc\n  )\n    return;\n  const rollbackSnapshot = exportFullHistorySnapshot(currentDoc).slice();\n  addDocumentAttachments(currentDoc, [replacementAttachment]);\n  const attachmentUpdate = pendingDeltaSinceBase(state, currentDoc);\n  const coveredVersion = encodeVersionVector(currentDoc);\n\n  const storageKey = `${state.localId}-${slotId}-${crypto.randomUUID()}`;\n  const pendingAttachment: PendingAttachmentRecord = {\n    byteLength: replacementAttachment.byteLength,\n    contentSha256: replacementAttachment.contentSha256,\n    localId: state.localId,\n    mimeType: replacementAttachment.mimeType,\n    name: replacementAttachment.name,\n    slotId,\n    storageKey,\n  };\n  let staged: Awaited<ReturnType<typeof stagePendingAttachments>>;\n  try {\n    staged = await stagePendingAttachments({\n      files: [file],\n      generation,\n      pendingAttachments: [pendingAttachment],\n      state,\n    });\n  } catch (error) {\n    await restoreFailedAttachmentMutation({\n      generation,\n      rollbackSnapshot,\n      state,\n    });\n    throw error;\n  }\n  if (!staged) {\n    await restoreFailedAttachmentMutation({\n      generation,\n      rollbackSnapshot,\n      state,\n    });\n    return;\n  }\n  // Preserve the optimistic text/structured fields (see persistAttachedFiles):\n  // a slot replacement overlapping a keystroke must not regress the editor.\n  const persisted = await persistStagedAttachmentMutation({\n    attachmentUpdate,\n    coveredVersion,\n    currentDoc,\n    generation,\n    rollbackSnapshot,\n    staged,\n    state,\n  });\n  if (\n    shouldAbortAttachmentPersistFollowup(\n      state,\n      writeGeneration,\n      generation,\n      persisted,\n    )\n  ) {\n    await deleteUnreferencedStagedAttachmentBytes({\n      generation,\n      pendingAttachments: staged.pendingAttachments,\n      state,\n    });\n    return;\n  }\n  installPendingAttachmentRows({ ...staged, state });\n  advancePendingBaseVersion(state, currentDoc);\n  state.runtime.util.log(`Queued attachment ${file.name} for slot ${slotId}.`);\n  requestDocumentStoreSync(state);\n}\n\nasync function captureReadyAttachWrite(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  callGeneration: AttachmentWriteGeneration | null,\n) {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);\n    return null;\n  }\n  if (!ready || !state.doc || !canWriteDocument(state)) return null;\n  // A reset or relink while this call waited owns the replacement document.\n  if (\n    callGeneration &&\n    !isAttachmentWriteGenerationCurrent(state, callGeneration)\n  ) {\n    return null;\n  }\n  return captureAttachmentWriteGeneration(state);\n}\n\nasync function attachThenSettle(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  files: ReadonlyArray<DocumentAttachmentUpload>,\n  callGeneration: AttachmentWriteGeneration | null,\n) {\n  const writeGeneration =\n    files.length === 0\n      ? null\n      : await captureReadyAttachWrite(state, scheduleSync, callGeneration);\n  try {\n    if (writeGeneration) {\n      await persistAttachedFiles(state, files, writeGeneration);\n    }\n  } finally {\n    await settleDeferredInitialUpdate(state, writeGeneration);\n  }\n}\n\nexport async function attachFilesToDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  files: ReadonlyArray<DocumentAttachmentUpload>,\n) {\n  // Join the chain before awaiting readiness so settlements keep call order,\n  // and settle even when nothing attaches: a deferred birth's sync hold lifts\n  // only behind every earlier attach, never while one is still staging. The\n  // caller's document is captured now (a cold store captures once ready).\n  const callGeneration = captureAttachmentWriteGeneration(state);\n  state.writeChain = state.writeChain\n    .catch(() => undefined)\n    .then(async () =>\n      attachThenSettle(state, scheduleSync, files, callGeneration),\n    )\n    .catch((error: unknown) => {\n      reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);\n    });\n  return state.writeChain;\n}\n\nexport async function replaceAttachmentInDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  slotId: string,\n  file: DocumentAttachmentUpload,\n) {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);\n    return;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return;\n  }\n\n  const writeGeneration = captureAttachmentWriteGeneration(state);\n  if (!writeGeneration) return;\n  state.writeChain = state.writeChain\n    .catch(() => undefined)\n    .then(async () =>\n      persistSlotAttachmentFile(state, slotId, file, writeGeneration),\n    )\n    .catch((error: unknown) => {\n      reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);\n    });\n  return state.writeChain;\n}\n"]}

package/stores/documents/documentStore/{documentHistoryCompaction.js → history/documentHistoryCompaction.js}

@@ -1,7 +1,7 @@
-import { base64ToBytes, bytesToBase64 } from "../../../internal/encoding/index.js";
-import { encodeVersionVector, exportFullHistorySnapshot, updateMatchesDocumentHistory, } from "../../../internal/loro/index.js";
-import { DOCUMENT_HISTORY_COMPACTION_MAX_BYTES, DOCUMENT_HISTORY_COMPACTION_MAX_ROWS, } from "../../../workflows/documents/index.js";
-import { captureDocumentStoreSyncGeneration, isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent, } from "./syncGeneration.js";
+import { base64ToBytes, bytesToBase64 } from "../../../../internal/encoding/index.js";
+import { encodeVersionVector, exportFullHistorySnapshot, updateMatchesDocumentHistory, } from "../../../../internal/loro/index.js";
+import { DOCUMENT_HISTORY_COMPACTION_MAX_BYTES, DOCUMENT_HISTORY_COMPACTION_MAX_ROWS, } from "../../../../workflows/documents/index.js";
+import { captureDocumentStoreSyncGeneration, isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent, } from "../sync/syncGeneration.js";
 /**
  * Refresh the durable full-history checkpoint when the tail has grown past
  * the compaction thresholds, or seed the first checkpoint as soon as the

package/stores/documents/documentStore/history/documentHistoryCompaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentHistoryCompaction.js","sourceRoot":"","sources":["documentHistoryCompaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qCAAqC,EACrC,oCAAoC,GACrC,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,kCAAkC,EAClC,oCAAoC,IAAI,uBAAuB,GAChE,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAAyB,EACzB,UAAyB,EACzB,YAA0C;IAE1C,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC9B,sEAAsE;IACtE,uEAAuE;IACvE,0EAA0E;IAC1E,4BAA4B;IAC5B,MAAM,UAAU,GAAG,kCAAkC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,CAAC,UAAU,IAAI,YAAY,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3E,IACE,IAAI,CAAC,aAAa;QAClB,IAAI,CAAC,QAAQ,GAAG,oCAAoC;QACpD,IAAI,CAAC,UAAU,GAAG,qCAAqC,EACvD,CAAC;QACD,OAAO;IACT,CAAC;IAED,0EAA0E;IAC1E,sEAAsE;IACtE,0EAA0E;IAC1E,wDAAwD;IACxD,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,sBAAsB,CAC1D,OAAO,EACP,KAAK,CAAC,OAAO,CACd,CAAC;IACF,MAAM,QAAQ,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IACvD,IACE,CAAC,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3C,YAAY,EAAE,EAAE,KAAK,KAAK,EAC1B,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,WAAW,CAAC,wBAAwB,CAAC,OAAO,EAAE;QAClD,cAAc,EAAE,qBAAqB,CAAC,WAAW,EAAE,UAAU,CAAC;QAC9D,gBAAgB;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;QACjC,YAAY,EAAE,GAAG,EAAE,CACjB,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,YAAY,EAAE,EAAE,KAAK,KAAK;KAC3E,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,qBAAqB,CAC5B,WAA0D,EAC1D,QAAuB;IAEvB,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,OAAO,4BAA4B,CACjC,QAAQ,EACR,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAChC;gBACC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACZ,CAAC,CAAC,EAAE,CAAC;QACT,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { base64ToBytes, bytesToBase64 } from \"@tearleads/encoding\";\nimport {\n  encodeVersionVector,\n  exportFullHistorySnapshot,\n  updateMatchesDocumentHistory,\n} from \"@tearleads/loro\";\nimport {\n  DOCUMENT_HISTORY_COMPACTION_MAX_BYTES,\n  DOCUMENT_HISTORY_COMPACTION_MAX_ROWS,\n} from \"../../../../workflows/documents\";\nimport type { DocumentState, DocumentStoreState } from \"../state\";\nimport {\n  captureDocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent as isSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\n\n/**\n * Refresh the durable full-history checkpoint when the tail has grown past\n * the compaction thresholds, or seed the first checkpoint as soon as the\n * document can export full history (a freshly created or rebuilt document is\n * cheap to export; waiting for the threshold would leave restarts without\n * history until then). The snapshot comes from the LIVE document, which has\n * every tail update imported, so clearing the tail loses nothing.\n */\nexport async function maybeCompactDocumentHistory(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  stillCurrent?: (() => boolean) | undefined,\n): Promise<void> {\n  const { persistence } = state;\n  // Bind this compaction to the store context it started under: a store\n  // reset or runtime swap mid-compaction must not let the OLD document's\n  // checkpoint overwrite the replacement generation's history (or land in a\n  // newly selected database).\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation || stillCurrent?.() === false) {\n    return;\n  }\n  const execSql = state.runtime.infra.execSql;\n  const tail = await persistence.readHistoryTailSize(execSql, state.localId);\n  if (\n    tail.hasCheckpoint &&\n    tail.rowCount < DOCUMENT_HISTORY_COMPACTION_MAX_ROWS &&\n    tail.byteLength < DOCUMENT_HISTORY_COMPACTION_MAX_BYTES\n  ) {\n    return;\n  }\n\n  // Capture the tail BEFORE exporting, then prove coverage per row: another\n  // pane can append ops this pane's document has not merged, so blanket\n  // deletion would discard the only durable copy. Unproven rows survive for\n  // a later compaction by whichever pane holds their ops.\n  const tailEntries = await persistence.listHistoryTailEntries(\n    execSql,\n    state.localId,\n  );\n  const snapshot = exportFullHistorySnapshot(currentDoc);\n  if (\n    !isSyncGenerationCurrent(state, generation) ||\n    stillCurrent?.() === false\n  ) {\n    return;\n  }\n  const endVersionVector = encodeVersionVector(currentDoc);\n  await persistence.replaceHistoryCheckpoint(execSql, {\n    coveredTailIds: coveredHistoryTailIds(tailEntries, currentDoc),\n    endVersionVector,\n    localId: state.localId,\n    snapshot: bytesToBase64(snapshot),\n    stillCurrent: () =>\n      isSyncGenerationCurrent(state, generation) && stillCurrent?.() !== false,\n  });\n}\n\n/**\n * Tail rows whose exact operations already belong to the checkpoint document.\n * Version-vector dominance is insufficient: a same-frontier fork has the same\n * declared range, and malformed rows must survive so recovery fails closed\n * instead of compaction deleting the evidence before provenance validation.\n */\nfunction coveredHistoryTailIds(\n  tailEntries: readonly { id: string; updateData: string }[],\n  document: DocumentState,\n): string[] {\n  return tailEntries.flatMap((entry) => {\n    try {\n      return updateMatchesDocumentHistory(\n        document,\n        base64ToBytes(entry.updateData),\n      )\n        ? [entry.id]\n        : [];\n    } catch {\n      return [];\n    }\n  });\n}\n"]}

package/stores/documents/documentStore/{durableDocumentReload.js → history/durableDocumentReload.js}

@@ -1,9 +1,9 @@
-import { base64ToBytes } from "../../../internal/encoding/index.js";
-import { importSnapshot } from "../../../internal/loro/index.js";
-import { importDocumentHistoryTailUpdates, runSerializedSqlMutation, } from "../../../workflows/documents/index.js";
-import { markDocumentStoreRemoved, setReadySnapshot, } from "./state.js";
-import { createFreshPeerStoredDocument } from "./storedDocument.js";
-import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
+import { base64ToBytes } from "../../../../internal/encoding/index.js";
+import { importSnapshot } from "../../../../internal/loro/index.js";
+import { importDocumentHistoryTailUpdates, runSerializedSqlMutation, } from "../../../../workflows/documents/index.js";
+import { markDocumentStoreRemoved, setReadySnapshot, } from "../state.js";
+import { createFreshPeerStoredDocument } from "../storedDocument.js";
+import { isDocumentStoreSyncGenerationCurrent, } from "../sync/syncGeneration.js";
 export function importDurableDocumentHistory(replacementDoc, history) {
     if (history?.snapshot) {
         importSnapshot(replacementDoc, base64ToBytes(history.snapshot));

package/stores/documents/documentStore/history/durableDocumentReload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durableDocumentReload.js","sourceRoot":"","sources":["durableDocumentReload.ts"],"names":[],"mappings":"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","sourcesContent":["import { base64ToBytes } from \"@tearleads/encoding\";\nimport { importSnapshot } from \"@tearleads/loro\";\nimport {\n  importDocumentHistoryTailUpdates,\n  runSerializedSqlMutation,\n} from \"../../../../workflows/documents\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  markDocumentStoreRemoved,\n  setReadySnapshot,\n} from \"../state\";\nimport { createFreshPeerStoredDocument } from \"../storedDocument\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\n\ntype DurableDocumentRecord = NonNullable<\n  Awaited<ReturnType<DocumentStoreState[\"persistence\"][\"loadDocument\"]>>\n>;\ntype DurableHistory = Awaited<\n  ReturnType<DocumentStoreState[\"persistence\"][\"loadHistoryRestoreState\"]>\n>;\n\nexport function importDurableDocumentHistory(\n  replacementDoc: DocumentState,\n  history: DurableHistory,\n): void {\n  if (history?.snapshot) {\n    importSnapshot(replacementDoc, base64ToBytes(history.snapshot));\n  }\n  if (history) {\n    importDocumentHistoryTailUpdates(\n      replacementDoc,\n      history.tailUpdates.map((update) => update.updateData),\n    );\n  }\n}\n\nexport function installDurableDocumentReload(input: {\n  durableRecord: DurableDocumentRecord;\n  previousDocumentId?: string | null | undefined;\n  preserveQueuedWritesWhenIdentityMatches: boolean;\n  registerIdentityChange?: boolean | undefined;\n  replacementDoc: DocumentState;\n  state: DocumentStoreState;\n}): void {\n  const { durableRecord, replacementDoc, state } = input;\n  const previousDocumentId =\n    input.previousDocumentId === undefined\n      ? (state.record?.documentId ?? null)\n      : input.previousDocumentId;\n  const identityChanged = previousDocumentId !== durableRecord.documentId;\n  const preserveQueuedWrites =\n    input.preserveQueuedWritesWhenIdentityMatches && !identityChanged;\n  if (!preserveQueuedWrites) {\n    state.localWriteGeneration += 1;\n    state.pendingLocalWrites = 0;\n  }\n  state.record = durableRecord;\n  state.pullContinuation = durableRecord.pullContinuation ?? null;\n  state.pendingBaseVersion =\n    durableRecord.pendingBaseVersion ??\n    (durableRecord.snapshotEndVersion.length > 0\n      ? durableRecord.snapshotEndVersion\n      : null);\n  state.doc = replacementDoc;\n  state.writerProjection = null;\n  if (identityChanged && input.registerIdentityChange !== false) {\n    state.effects.registerDocumentIdentity(\n      state.runtime.state.domainScope,\n      durableRecord.id,\n      durableRecord.documentId,\n    );\n  }\n  const preserveOptimisticProjection =\n    preserveQueuedWrites && state.pendingLocalWrites > 0;\n  setReadySnapshot(\n    state,\n    replacementDoc,\n    state.snapshot.syncing,\n    preserveOptimisticProjection ? state.snapshot.text : undefined,\n    preserveOptimisticProjection ? state.snapshot.structuredFields : undefined,\n  );\n}\n\nexport async function reloadDocumentFromDurableHistory(input: {\n  expectedGeneration: DocumentStoreSyncGeneration;\n  preserveQueuedWritesWhenIdentityMatches: boolean;\n  sameIdentitySnapshot?: Uint8Array | undefined;\n  state: DocumentStoreState;\n}): Promise<boolean> {\n  const { expectedGeneration, state } = input;\n  if (!isDocumentStoreSyncGenerationCurrent(state, expectedGeneration)) {\n    return false;\n  }\n\n  const replacementDoc = await createFreshPeerStoredDocument();\n  return runSerializedSqlMutation(\n    state.runtime.infra.execSql,\n    async (lockedExecSql) => {\n      if (!isDocumentStoreSyncGenerationCurrent(state, expectedGeneration)) {\n        return false;\n      }\n      const { document: durableRecord, historyRestoreState } =\n        await state.persistence.loadDocumentWithHistoryRestoreState(\n          lockedExecSql,\n          state.localId,\n        );\n      if (!durableRecord) {\n        markDocumentStoreRemoved(state);\n        return false;\n      }\n      const canRestoreCapturedSnapshot = Boolean(\n        input.sameIdentitySnapshot &&\n          (state.record?.documentId ?? null) === durableRecord.documentId,\n      );\n      if (canRestoreCapturedSnapshot && input.sameIdentitySnapshot) {\n        importSnapshot(replacementDoc, input.sameIdentitySnapshot);\n      }\n      // The captured snapshot removes the failed in-memory mutation, but it\n      // cannot replace the durable source of truth: another pane may have\n      // advanced history and the record frontier while attachment staging was\n      // in flight. Merge the latest checkpoint and tail in both paths before\n      // installing that record/frontier beside the rebuilt CRDT.\n      importDurableDocumentHistory(replacementDoc, historyRestoreState);\n      if (!isDocumentStoreSyncGenerationCurrent(state, expectedGeneration)) {\n        return false;\n      }\n\n      installDurableDocumentReload({\n        durableRecord,\n        preserveQueuedWritesWhenIdentityMatches:\n          input.preserveQueuedWritesWhenIdentityMatches,\n        replacementDoc,\n        state,\n      });\n      return true;\n    },\n  );\n}\n"]}

package/stores/documents/documentStore/{historyRebuild.js → history/historyRebuild.js}

@@ -1,9 +1,9 @@
-import { bytesToBase64 } from "../../../internal/encoding/index.js";
-import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../internal/loro/index.js";
-import { readPullContinuation } from "../../../data/documents/shared/syncPagination.js";
-import { persistDocument } from "./persistence.js";
-import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
-import { installDocumentWriterProjection } from "./writerProjectionGeneration.js";
+import { bytesToBase64 } from "../../../../internal/encoding/index.js";
+import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../../internal/loro/index.js";
+import { readPullContinuation } from "../../../../data/documents/shared/syncPagination.js";
+import { persistDocument } from "../persistence.js";
+import { isDocumentStoreSyncGenerationCurrent, } from "../sync/syncGeneration.js";
+import { installDocumentWriterProjection } from "../writerProjectionGeneration.js";
 /**
  * Machinery for reconstructing a full-history document from a verified remote
  * pull. Used by the rotation preflight (rotation.ts): it pulls the remote op

package/stores/documents/documentStore/history/historyRebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyRebuild.js","sourceRoot":"","sources":["historyRebuild.ts"],"names":[],"mappings":"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","sourcesContent":["import { bytesToBase64 } from \"@tearleads/encoding\";\nimport {\n  encodeVersionVector,\n  exportFullHistorySnapshot,\n} from \"@tearleads/loro\";\nimport { readPullContinuation } from \"../../../../data/documents/shared/syncPagination\";\nimport type {\n  DocumentSyncPullContinuation,\n  syncRemoteDocument,\n} from \"../../../../workflows/documents\";\nimport { persistDocument } from \"../persistence\";\nimport type { DocumentState, DocumentStoreState } from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\nimport { installDocumentWriterProjection } from \"../writerProjectionGeneration\";\n\n/**\n * Machinery for reconstructing a full-history document from a verified remote\n * pull. Used by the rotation preflight (rotation.ts): it pulls the remote op\n * log, replays it into a fresh document alongside the durable local queue,\n * and installs the rebuilt document — preserving op identity end to end.\n */\n\nexport async function installRebuiltDocument(input: {\n  consumedPullContinuation: DocumentSyncPullContinuation | null;\n  currentRecord: NonNullable<DocumentStoreState[\"record\"]>;\n  generation: DocumentStoreSyncGeneration;\n  rebuiltDoc: DocumentState;\n  state: DocumentStoreState;\n  synced: NonNullable<Awaited<ReturnType<typeof syncRemoteDocument>>>;\n  /** `state.writerProjectionGeneration` when the recovery pull started. */\n  writerProjectionGeneration: number;\n}): Promise<{\n  fullHistorySnapshot: Uint8Array;\n  settlementRequiresRetry: boolean;\n}> {\n  // The guarded persist makes the recovered history durable BEFORE publishing\n  // the newer record. Checkpoint-ahead is the safe crash direction: restore\n  // reads the checkpoint and the record catches up on the next persist.\n  const fullHistorySnapshot = exportFullHistorySnapshot(input.rebuiltDoc);\n  const rebuiltEndVersion = encodeVersionVector(input.rebuiltDoc);\n  const persisted = await persistDocument(\n    input.state,\n    input.rebuiltDoc,\n    {\n      ...input.synced.persistedState,\n      lastCommitLsn:\n        input.synced.response.commitLsn ??\n        input.currentRecord.lastCommitLsn ??\n        null,\n      pullContinuation: readPullContinuation(input.synced.response),\n      recoveryGeneration: (input.currentRecord.recoveryGeneration ?? 0) + 1,\n      // The guarded checkpoint below covers exactly this frontier.\n      snapshotEndVersion: rebuiltEndVersion,\n    },\n    {\n      acceptedPendingUpdateIds: input.synced.settledPendingUpdateIds,\n      expectedSyncState: {\n        pullContinuation: input.consumedPullContinuation,\n        record: input.currentRecord,\n      },\n      historyCheckpoint: {\n        coveredTailIds: [],\n        endVersionVector: rebuiltEndVersion,\n        pruneCoveredLocalState: true,\n        snapshot: bytesToBase64(fullHistorySnapshot),\n      },\n      pendingBaseVersionOverride: rebuiltEndVersion,\n      preserveSnapshotStructuredFields: input.state.pendingLocalWrites > 0,\n      preserveSnapshotText: input.state.pendingLocalWrites > 0,\n    },\n    input.generation,\n  );\n  if (!persisted) {\n    if (!isDocumentStoreSyncGenerationCurrent(input.state, input.generation)) {\n      throw new Error(\n        \"Document changed during rotation recovery; retry key rotation\",\n      );\n    }\n    // The resurrect guard refused: another subsystem deleted this document\n    // while the rebuild was in flight, and saveDocumentRecord cleared the\n    // zombie store — pendingBaseVersion included. Restoring the rebuilt doc,\n    // projection, or the captured base version here would resurrect state\n    // over that clearing.\n    throw new Error(\n      \"Document was deleted while its history rebuild was in flight\",\n    );\n  }\n  if (\n    !persisted.pullContinuationSuperseded &&\n    !persisted.syncIdentitySuperseded\n  ) {\n    input.state.pendingBaseVersion = rebuiltEndVersion;\n    input.state.doc = input.rebuiltDoc;\n  }\n  if (persisted.pullContinuationSuperseded) input.state.writerProjection = null;\n  else\n    installDocumentWriterProjection(\n      input.state,\n      input.synced.writerProjection ?? input.state.writerProjection,\n      input.writerProjectionGeneration,\n    );\n  const installedDoc = input.state.doc ?? input.rebuiltDoc;\n  return {\n    fullHistorySnapshot: persisted.pullContinuationSuperseded\n      ? exportFullHistorySnapshot(installedDoc)\n      : fullHistorySnapshot,\n    settlementRequiresRetry:\n      persisted.pullContinuationSuperseded === true ||\n      persisted.syncIdentitySuperseded === true ||\n      persisted.record.pullContinuation != null ||\n      persisted.record.pullContinuationRecoveryRequired === true,\n  };\n}\n"]}

package/stores/documents/{documentStore.d.ts → documentStore/index.d.ts}

@@ -1,8 +1,8 @@
-import type { StoredDocumentKind } from "../../data/documents/documentKinds.js";
-import type { DomainScope } from "../../data/shared/domainScope.js";
-import { type DocumentsPersistence } from "../../workflows/documents/index.js";
-import type { DocumentStore, DocumentStoreFacade, DocumentStoreOpenOptions, DocumentsRuntime } from "./types.js";
-export { discardRegisteredDocumentLocalState, requestDomainDocumentSync, subscribeToPersistedDocuments, } from "./registry.js";
+import type { StoredDocumentKind } from "../../../data/documents/documentKinds.js";
+import type { DomainScope } from "../../../data/shared/domainScope.js";
+import { type DocumentsPersistence } from "../../../workflows/documents/index.js";
+import type { DocumentStore, DocumentStoreFacade, DocumentStoreOpenOptions, DocumentsRuntime } from "../types.js";
+export { discardRegisteredDocumentLocalState, requestDomainDocumentSync, subscribeToPersistedDocuments, } from "../registry.js";
 export declare function createDocumentStore(localId: string, initialRuntime: DocumentsRuntime, persistence?: DocumentsPersistence, initialDocumentId?: string | null, initialText?: string, initialDocumentKind?: StoredDocumentKind, options?: DocumentStoreOpenOptions): DocumentStoreFacade;
 export declare function getOrCreateDocumentStore(domainScope: DomainScope, localId: string, runtime: DocumentsRuntime, initialDocumentId?: string | null, initialText?: string, initialDocumentKind?: StoredDocumentKind, options?: DocumentStoreOpenOptions): DocumentStore;
 export declare function openDocumentStore(domainScope: DomainScope, localId: string, runtime: DocumentsRuntime, initialDocumentId?: string | null, initialText?: string, initialDocumentKind?: StoredDocumentKind, options?: DocumentStoreOpenOptions): DocumentStore;

package/stores/documents/{documentStore.js → documentStore/index.js}

@@ -1,20 +1,20 @@
-import { DEFAULT_DOCUMENT_KIND } from "../../data/documents/documentConstants.js";
-import { createDocumentProjectionUserKeyResolver, defaultDocumentsPersistence, didDocumentProjectionKeyRuntimeChange, didRegainSyncPrerequisites, requestDocumentSyncLaneAndWait, } from "../../workflows/documents/index.js";
-import { removeAttachmentFromDocumentStore } from "./documentStore/attachmentRemoval.js";
-import { attachFilesToDocumentStore, replaceAttachmentInDocumentStore, } from "./documentStore/attachments.js";
-import { discardDocumentStoreLocalState } from "./documentStore/discard.js";
-import { ensureDocumentStoreInitialized, ensureDocumentStoreReady, relinkDocumentStore, } from "./documentStore/initialization.js";
-import { registerInternalDocumentRelink } from "./documentStore/internalRelink.js";
-import { setDocumentStructuredFields, setDocumentText, } from "./documentStore/mutations.js";
-import { logRevalidationScheduled } from "./documentStore/remoteRevalidationTelemetry.js";
-import { assertDocumentStoreCanRotateContentKey } from "./documentStore/rotation.js";
-import { addRowToDocumentStore, removeRowFromDocumentStore, updateRowInDocumentStore, } from "./documentStore/rows.js";
-import { createDocumentStoreState, refreshAttachabilitySnapshot, resetDocumentStore, subscribeToDocumentStore, } from "./documentStore/state.js";
-import { registerDocumentStoreSyncLane } from "./documentStore/sync.js";
-import { allowDocumentStoreRemoteSync, captureDocumentStoreRemoteSyncRequestGeneration, captureDocumentStoreSyncLaneGeneration, didDocumentStoreRemoteSyncRequestComplete, hasPendingIndependentDocumentStoreRemoteSync, invalidateDocumentStoreRemoteSync, invalidateDocumentStoreSyncLane, isDocumentStoreRemoteSyncBlocked, isDocumentStoreRemoteSyncRequestGenerationCurrent, markDocumentStoreRemoteSyncPending, registerDocumentStoreRemoteSyncWaiter, } from "./documentStore/syncGeneration.js";
-import { handleDocumentRemoteEvents } from "./documentStore/syncRemoteSignals.js";
-import { createDocumentStoreFacade, emitPersistedDocument, getOrCreateDocumentStoreRegistry, registerDocumentStore, registerDocumentStoreIdentity, requestDocumentStoreSync, resolveDocumentStoreKey, } from "./registry.js";
-export { discardRegisteredDocumentLocalState, requestDomainDocumentSync, subscribeToPersistedDocuments, } from "./registry.js";
+import { DEFAULT_DOCUMENT_KIND } from "../../../data/documents/documentConstants.js";
+import { createDocumentProjectionUserKeyResolver, defaultDocumentsPersistence, didDocumentProjectionKeyRuntimeChange, didRegainSyncPrerequisites, requestDocumentSyncLaneAndWait, } from "../../../workflows/documents/index.js";
+import { createDocumentStoreFacade, emitPersistedDocument, getOrCreateDocumentStoreRegistry, registerDocumentStore, registerDocumentStoreIdentity, requestDocumentStoreSync, resolveDocumentStoreKey, } from "../registry.js";
+import { attachFilesToDocumentStore, replaceAttachmentInDocumentStore, } from "./attachments/index.js";
+import { removeAttachmentFromDocumentStore } from "./attachments/attachmentRemoval.js";
+import { discardDocumentStoreLocalState } from "./discard.js";
+import { ensureDocumentStoreInitialized, ensureDocumentStoreReady, relinkDocumentStore, } from "./initialization/index.js";
+import { registerInternalDocumentRelink } from "./internalRelink.js";
+import { setDocumentStructuredFields, setDocumentText } from "./mutations.js";
+import { assertDocumentStoreCanRotateContentKey } from "./rotation/index.js";
+import { addRowToDocumentStore, removeRowFromDocumentStore, updateRowInDocumentStore, } from "./rows.js";
+import { createDocumentStoreState, refreshAttachabilitySnapshot, resetDocumentStore, subscribeToDocumentStore, } from "./state.js";
+import { registerDocumentStoreSyncLane } from "./sync/index.js";
+import { logRevalidationScheduled } from "./sync/remoteRevalidationTelemetry.js";
+import { allowDocumentStoreRemoteSync, captureDocumentStoreRemoteSyncRequestGeneration, captureDocumentStoreSyncLaneGeneration, didDocumentStoreRemoteSyncRequestComplete, hasPendingIndependentDocumentStoreRemoteSync, invalidateDocumentStoreRemoteSync, invalidateDocumentStoreSyncLane, isDocumentStoreRemoteSyncBlocked, isDocumentStoreRemoteSyncRequestGenerationCurrent, markDocumentStoreRemoteSyncPending, registerDocumentStoreRemoteSyncWaiter, } from "./sync/syncGeneration.js";
+import { handleDocumentRemoteEvents } from "./sync/syncRemoteSignals.js";
+export { discardRegisteredDocumentLocalState, requestDomainDocumentSync, subscribeToPersistedDocuments, } from "../registry.js";
 function refreshDocumentStoreSyncLane(state, force = false) {
     if (!force && state.syncLane && !state.syncLane.isDisposed?.()) {
         return;
@@ -212,4 +212,4 @@ export function openDocumentStore(domainScope, localId, runtime, initialDocument
     store.updateRuntime(runtime);
     return store;
 }
-//# sourceMappingURL=documentStore.js.map
+//# sourceMappingURL=index.js.map