@tearleads/client-sdk 0.1.63 → 0.1.64

package/stores/documents/documentStore/sync/syncAttachmentSettlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncAttachmentSettlement.js","sourceRoot":"","sources":["syncAttachmentSettlement.ts"],"names":[],"mappings":"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","sourcesContent":["import type { uploadPreparedDocumentAttachment as uploadDocumentAttachment } from \"../../../../workflows/blobs/upload\";\nimport type { PendingAttachmentRecord } from \"../../../../workflows/documents\";\nimport {\n  deletePendingAttachment,\n  saveLocalAttachmentRecord,\n} from \"../attachments/attachmentPersistence\";\nimport type { AttachmentUploadLaneReporter } from \"../attachmentUpload/attachmentUploadLane\";\nimport {\n  type DocumentAttachmentBinding,\n  type DocumentState,\n  type DocumentStoreState,\n  setReadySnapshot,\n} from \"../state\";\nimport { installDocumentWriterProjection } from \"../writerProjectionGeneration\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\n\nexport function removeSettledPendingAttachment(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  pendingAttachment: PendingAttachmentRecord,\n): void {\n  // Every non-retry outcome removed the durable row: uploaded now, recovered\n  // after an ambiguous response, or discarded because local bytes vanished.\n  state.pendingAttachments = state.pendingAttachments.filter(\n    (attachment) => attachment !== pendingAttachment,\n  );\n  if (currentDoc !== state.doc) {\n    return;\n  }\n\n  // Republish progressively so the attachment drops its syncing badge even if\n  // a later attachment returns retry before the loop finishes.\n  setReadySnapshot(\n    state,\n    currentDoc,\n    state.snapshot.syncing,\n    state.snapshot.text,\n    state.snapshot.structuredFields,\n  );\n}\n\nexport async function settleUploadedAttachment(input: {\n  activeBindingBySlotId: Map<string, DocumentAttachmentBinding>;\n  attachmentGeneration: DocumentStoreSyncGeneration;\n  pendingAttachment: PendingAttachmentRecord;\n  remoteDocumentId: string;\n  state: DocumentStoreState;\n  uploaded: NonNullable<Awaited<ReturnType<typeof uploadDocumentAttachment>>>;\n  uploadLane: AttachmentUploadLaneReporter;\n  /** `state.writerProjectionGeneration` when the upload started. */\n  writerProjectionGeneration: number;\n}): Promise<void> {\n  const { pendingAttachment, state, uploaded } = input;\n  // A teardown (reset/discard) during the upload's awaits deleted the rows\n  // this settle would rewrite; the remote commit stands, and the re-pull owns\n  // reconciling it. Complete the lane so no phantom upload stays running.\n  if (\n    !isDocumentStoreSyncGenerationCurrent(state, input.attachmentGeneration)\n  ) {\n    input.uploadLane.complete();\n    return;\n  }\n  await persistSettledAttachment(\n    state,\n    pendingAttachment,\n    uploaded.blobId,\n    input.attachmentGeneration,\n  );\n  input.activeBindingBySlotId.set(pendingAttachment.slotId, {\n    bindingEvent: uploaded.response.bindingEvent,\n    bindingId: uploaded.bindingId,\n    blobId: uploaded.blobId,\n    blobKekTargets: uploaded.response.blobKekTargets,\n    contentKeyBundle: uploaded.response.contentKeyBundle,\n    documentManifestHash: uploaded.response.documentManifestHash,\n    previousBindingId: uploaded.response.previousBindingId,\n    slotId: pendingAttachment.slotId,\n    writeAuthorization: uploaded.response.writeAuthorization,\n    writeHeader: uploaded.response.writeHeader,\n  });\n  installDocumentWriterProjection(\n    state,\n    uploaded.writerProjection,\n    input.writerProjectionGeneration,\n  );\n  input.uploadLane.complete();\n  state.runtime.util.log(\n    `Uploaded attachment ${pendingAttachment.name} for document ${input.remoteDocumentId}.`,\n  );\n}\n\nexport async function settleRecoveredAttachment(input: {\n  attachmentGeneration: DocumentStoreSyncGeneration;\n  binding: DocumentAttachmentBinding;\n  pendingAttachment: PendingAttachmentRecord;\n  remoteDocumentId: string;\n  state: DocumentStoreState;\n  uploadLane: AttachmentUploadLaneReporter;\n}): Promise<void> {\n  // See settleUploadedAttachment: never rewrite rows a teardown just removed.\n  if (\n    !isDocumentStoreSyncGenerationCurrent(\n      input.state,\n      input.attachmentGeneration,\n    )\n  ) {\n    input.uploadLane.complete();\n    return;\n  }\n  await persistSettledAttachment(\n    input.state,\n    input.pendingAttachment,\n    input.binding.blobId,\n    input.attachmentGeneration,\n  );\n  input.uploadLane.complete();\n  input.state.runtime.util.log(\n    `Recovered uploaded attachment ${input.pendingAttachment.name} for document ${input.remoteDocumentId}.`,\n  );\n}\n\nasync function persistSettledAttachment(\n  state: DocumentStoreState,\n  pendingAttachment: PendingAttachmentRecord,\n  blobId: string,\n  attachmentGeneration: DocumentStoreSyncGeneration,\n): Promise<void> {\n  // The save validates the generation inside its serialized mutation, so a\n  // teardown racing this settle can never see its rows re-inserted.\n  await saveLocalAttachmentRecord(\n    state,\n    {\n      blobId,\n      byteLength: pendingAttachment.byteLength,\n      contentSha256: pendingAttachment.contentSha256,\n      detachedAt: null,\n      localId: state.localId,\n      mimeType: pendingAttachment.mimeType,\n      slotId: pendingAttachment.slotId,\n      storageKey: pendingAttachment.storageKey,\n    },\n    state.doc,\n    attachmentGeneration,\n  );\n  await deletePendingAttachment(\n    state,\n    pendingAttachment.slotId,\n    pendingAttachment.storageKey,\n    attachmentGeneration,\n  );\n}\n\nexport function isNewPendingAttachmentSlot(\n  state: DocumentStoreState,\n  pendingAttachment: PendingAttachmentRecord,\n): boolean {\n  // Fresh slots use a deterministic key; replacements append a UUID.\n  return (\n    pendingAttachment.storageKey ===\n    `${state.localId}-${pendingAttachment.slotId}`\n  );\n}\n"]}

package/stores/documents/documentStore/{syncAttachments.js → sync/syncAttachments.js}

@@ -1,10 +1,10 @@
-import { clearDocumentSyncFailure, DOCUMENTS_APP_KIND, recordDocumentSyncFailure, resolveDocumentCreateAuthor, runSerializedSqlMutation, } from "../../../workflows/documents/index.js";
-import { createRuntimePrincipalPolicyWarmer } from "../../../workflows/principals/runtimePolicyWarmer.js";
-import { markOriginatedDocuments } from "../../../workflows/sync/index.js";
-import { requestDocumentStoreSync } from "../registry.js";
-import { dropUnavailablePendingAttachment, pendingAttachmentMatchesIntent, resolveAttachmentSourceUpload, } from "./attachmentSourceUpload.js";
-import { uploadAttachmentWithWriterProjectionRetry } from "./attachmentUploadAttempt.js";
-import { createAttachmentUploadFailedError, createAttachmentUploadLaneReporter, } from "./attachmentUploadLane.js";
+import { clearDocumentSyncFailure, DOCUMENTS_APP_KIND, recordDocumentSyncFailure, resolveDocumentCreateAuthor, runSerializedSqlMutation, } from "../../../../workflows/documents/index.js";
+import { createRuntimePrincipalPolicyWarmer } from "../../../../workflows/principals/runtimePolicyWarmer.js";
+import { markOriginatedDocuments } from "../../../../workflows/sync/index.js";
+import { requestDocumentStoreSync } from "../../registry.js";
+import { dropUnavailablePendingAttachment, pendingAttachmentMatchesIntent, resolveAttachmentSourceUpload, } from "../attachmentUpload/attachmentSourceUpload.js";
+import { uploadAttachmentWithWriterProjectionRetry } from "../attachmentUpload/attachmentUploadAttempt.js";
+import { createAttachmentUploadFailedError, createAttachmentUploadLaneReporter, } from "../attachmentUpload/attachmentUploadLane.js";
 import { isNewPendingAttachmentSlot, removeSettledPendingAttachment, settleRecoveredAttachment, settleUploadedAttachment, } from "./syncAttachmentSettlement.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 import { ensureRemoteDocument } from "./syncShared.js";

package/stores/documents/documentStore/sync/syncAttachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncAttachments.js","sourceRoot":"","sources":["syncAttachments.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BlobSourceSnapshot } from \"../../../../data/documents/blob/shared/blobSourceSnapshot\";\nimport type { BlobByteSource } from \"../../../../workflows/blobs\";\nimport type { uploadPreparedDocumentAttachment as uploadDocumentAttachment } from \"../../../../workflows/blobs/upload\";\nimport {\n  clearDocumentSyncFailure,\n  DOCUMENTS_APP_KIND,\n  type DocumentRecord,\n  type PendingAttachmentRecord,\n  recordDocumentSyncFailure,\n  resolveDocumentCreateAuthor,\n  runSerializedSqlMutation,\n} from \"../../../../workflows/documents\";\nimport { createRuntimePrincipalPolicyWarmer } from \"../../../../workflows/principals/runtimePolicyWarmer\";\nimport { markOriginatedDocuments } from \"../../../../workflows/sync\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport {\n  dropUnavailablePendingAttachment,\n  pendingAttachmentMatchesIntent,\n  resolveAttachmentSourceUpload,\n} from \"../attachmentUpload/attachmentSourceUpload\";\nimport { uploadAttachmentWithWriterProjectionRetry } from \"../attachmentUpload/attachmentUploadAttempt\";\nimport {\n  type AttachmentUploadLaneReporter,\n  createAttachmentUploadFailedError,\n  createAttachmentUploadLaneReporter,\n} from \"../attachmentUpload/attachmentUploadLane\";\nimport type { AttachmentUploadResume } from \"../attachmentUpload/attachmentUploadResume\";\nimport type {\n  DocumentAttachmentBinding,\n  DocumentState,\n  DocumentStoreState,\n  EncapsulationKeyPair,\n  PendingMutationSyncResult,\n} from \"../state\";\nimport {\n  isNewPendingAttachmentSlot,\n  removeSettledPendingAttachment,\n  settleRecoveredAttachment,\n  settleUploadedAttachment,\n} from \"./syncAttachmentSettlement\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { ensureRemoteDocument } from \"./syncShared\";\n\n// Preserve transient failures for retry. Drop irrecoverable missing bytes so a\n// pending attachment cannot wedge the document sync lane across restarts.\ntype PendingAttachmentUploadOutcome =\n  | \"uploaded\"\n  | \"recovered\"\n  | \"retry\"\n  | \"dropped\";\n\ninterface AttachmentSyncProgress {\n  activeBindingBySlotId: Map<string, DocumentAttachmentBinding>;\n  fetchedRemoteBindings: boolean;\n  settledAttachment: boolean;\n  uploadedAttachment: boolean;\n}\n\nfunction rearmStaleAttachmentSync(\n  state: DocumentStoreState,\n  generation: DocumentStoreSyncGeneration,\n): void {\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n  }\n}\n\nexport async function syncPendingAttachments(\n  state: DocumentStoreState,\n  nextRecord: DocumentRecord,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  attachmentGeneration: DocumentStoreSyncGeneration,\n): Promise<PendingMutationSyncResult> {\n  if (state.pendingAttachments.length === 0) {\n    return { completed: false, nextRecord };\n  }\n\n  const currentDoc = state.doc;\n  if (!currentDoc) {\n    return { completed: false, nextRecord };\n  }\n\n  const currentRecord = await ensureRemoteDocumentForAttachmentSync(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    attachmentGeneration,\n  );\n  if (!currentRecord?.documentId) {\n    return { completed: false, nextRecord };\n  }\n  const remoteDocumentId = currentRecord.documentId;\n\n  const progress: AttachmentSyncProgress = {\n    activeBindingBySlotId: new Map(),\n    fetchedRemoteBindings: false,\n    settledAttachment: false,\n    uploadedAttachment: false,\n  };\n\n  for (const pendingAttachment of [...state.pendingAttachments]) {\n    if (!isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)) {\n      requestDocumentStoreSync(state);\n      return {\n        completed: progress.settledAttachment,\n        nextRecord: currentRecord,\n      };\n    }\n    const bindingsReady = await loadRemoteAttachmentBindings({\n      pendingAttachment,\n      progress,\n      remoteDocumentId,\n      state,\n    });\n    if (!bindingsReady) {\n      return {\n        completed: progress.settledAttachment,\n        nextRecord: currentRecord,\n      };\n    }\n\n    const outcome = await syncPendingAttachmentUpload({\n      activeBindingBySlotId: progress.activeBindingBySlotId,\n      attachmentGeneration,\n      encapsulationKeyPair,\n      pendingAttachment,\n      remoteDocumentId,\n      state,\n    });\n    if (outcome === \"retry\") {\n      rearmStaleAttachmentSync(state, attachmentGeneration);\n      return {\n        completed: progress.settledAttachment,\n        nextRecord: currentRecord,\n      };\n    }\n\n    // Re-check after the upload's awaits: settling writes local rows, which a\n    // teardown that happened mid-upload has just deleted on purpose.\n    if (!isDocumentStoreSyncGenerationCurrent(state, attachmentGeneration)) {\n      requestDocumentStoreSync(state);\n      return {\n        completed: progress.settledAttachment,\n        nextRecord: currentRecord,\n      };\n    }\n    removeSettledPendingAttachment(state, currentDoc, pendingAttachment);\n    if (outcome === \"uploaded\" || outcome === \"recovered\") {\n      progress.settledAttachment = true;\n    }\n    if (outcome === \"uploaded\") {\n      progress.uploadedAttachment = true;\n    }\n  }\n\n  if (!progress.settledAttachment) {\n    return { completed: false, nextRecord: currentRecord };\n  }\n\n  // Only record the origination once a write landed: the server echoes a\n  // document_update_created for it, and this lets the reconciler skip\n  // rediscovering a delta we already have locally rather than cycling its lane\n  // per uploaded file. Marking here (not before the loop) avoids a dangling id\n  // that would suppress the next genuine remote update if every upload failed.\n  if (progress.uploadedAttachment) {\n    markOriginatedDocuments(state.runtime.state.domainScope, [\n      remoteDocumentId,\n    ]);\n  }\n\n  // A settled attachment pass invalidates any recorded failure itself: a\n  // retried upload with no pending CRDT update never reaches the document\n  // submission that would otherwise clear it, and the stale row would flag the\n  // next unrelated edit as failed before it was attempted.\n  await clearDocumentSyncFailure(state.runtime.infra.execSql, {\n    appKind: DOCUMENTS_APP_KIND,\n    localId: state.localId,\n  });\n\n  // The snapshot was already republished progressively inside the loop as each\n  // attachment settled, so there is nothing left to publish here.\n  return { completed: true, nextRecord: currentRecord };\n}\n\nasync function loadRemoteAttachmentBindings(input: {\n  pendingAttachment: PendingAttachmentRecord;\n  progress: AttachmentSyncProgress;\n  remoteDocumentId: string;\n  state: DocumentStoreState;\n}): Promise<boolean> {\n  const { pendingAttachment, progress, state } = input;\n  const freshUpload =\n    pendingAttachment.upload == null &&\n    isNewPendingAttachmentSlot(state, pendingAttachment);\n  if (progress.fetchedRemoteBindings || freshUpload) {\n    return true;\n  }\n\n  const remoteBindings = await state.runtime.apiClient.listDocumentAttachments(\n    input.remoteDocumentId,\n  );\n  if (!remoteBindings) {\n    return false;\n  }\n\n  progress.fetchedRemoteBindings = true;\n  for (const binding of remoteBindings) {\n    progress.activeBindingBySlotId.set(binding.slotId, binding);\n  }\n  return true;\n}\n\nasync function ensureRemoteDocumentForAttachmentSync(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  nextRecord: DocumentRecord,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  generation?: DocumentStoreSyncGeneration,\n): Promise<DocumentRecord | null> {\n  if (nextRecord.documentId) {\n    return nextRecord;\n  }\n\n  return ensureRemoteDocument(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    generation,\n  );\n}\n\ninterface PendingAttachmentUploadInput {\n  activeBindingBySlotId: Map<string, DocumentAttachmentBinding>;\n  attachmentGeneration: DocumentStoreSyncGeneration;\n  encapsulationKeyPair: EncapsulationKeyPair;\n  pendingAttachment: PendingAttachmentRecord;\n  remoteDocumentId: string;\n  state: DocumentStoreState;\n}\n\nasync function recoverCommittedAttachment(\n  input: PendingAttachmentUploadInput,\n): Promise<boolean> {\n  const { pendingAttachment, state } = input;\n  const persistedUpload = pendingAttachment.upload;\n  const activeBinding = input.activeBindingBySlotId.get(\n    pendingAttachment.slotId,\n  );\n  if (!persistedUpload || activeBinding?.blobId !== persistedUpload.blobId) {\n    return false;\n  }\n\n  const uploadLane = createAttachmentUploadLaneReporter({\n    blobId: persistedUpload.blobId,\n    domainScope: state.runtime.state.domainScope,\n    pendingAttachment,\n  });\n  try {\n    await settleRecoveredAttachment({\n      attachmentGeneration: input.attachmentGeneration,\n      binding: activeBinding,\n      pendingAttachment,\n      remoteDocumentId: input.remoteDocumentId,\n      state,\n      uploadLane,\n    });\n    return true;\n  } catch (error) {\n    reportAttachmentUploadFailure({\n      attachmentGeneration: input.attachmentGeneration,\n      error,\n      pendingAttachment,\n      state,\n      uploadLane,\n    });\n    throw error;\n  }\n}\n\nfunction createAttachmentBaseUploadInput(input: {\n  author: Parameters<typeof uploadDocumentAttachment>[0][\"author\"];\n  pendingUpload: PendingAttachmentUploadInput;\n  resume: AttachmentUploadResume;\n  source: BlobByteSource;\n  sourceSnapshot: BlobSourceSnapshot;\n  uploadLane: AttachmentUploadLaneReporter;\n}): Parameters<typeof uploadDocumentAttachment>[0] {\n  const { pendingAttachment, state } = input.pendingUpload;\n  return {\n    apiClient: state.runtime.apiClient,\n    author: input.author,\n    blobId: input.resume.blobId,\n    bytes: input.source,\n    contentKey: input.resume.contentKey,\n    contentKeyEpoch: input.resume.contentKeyEpoch,\n    documentId: input.pendingUpload.remoteDocumentId,\n    execSql: state.runtime.infra.execSql,\n    expectedBindingId:\n      input.pendingUpload.activeBindingBySlotId.get(pendingAttachment.slotId)\n        ?.bindingId ?? null,\n    nonceSeed: input.resume.nonceSeed,\n    multipart: input.resume.multipart,\n    onMultipartProgress: input.uploadLane.onMultipartProgress,\n    onStageResolved: input.resume.onStageResolved,\n    onStageUnavailable: async (stageId) => {\n      await input.resume.onStageUnavailable(\n        stageId,\n        input.pendingUpload.remoteDocumentId,\n      );\n      requestDocumentStoreSync(state);\n    },\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n    slotId: pendingAttachment.slotId,\n    sourceSnapshot: input.sourceSnapshot,\n    targetSecretKey: input.pendingUpload.encapsulationKeyPair.secretKey,\n    warmReferencedPrincipalPolicies: createRuntimePrincipalPolicyWarmer(\n      state.runtime,\n    ),\n  };\n}\n\nasync function uploadPendingAttachmentBytes(input: {\n  baseUploadInput: Parameters<typeof uploadDocumentAttachment>[0];\n  pendingUpload: PendingAttachmentUploadInput;\n  uploadLane: AttachmentUploadLaneReporter;\n}): Promise<PendingAttachmentUploadOutcome> {\n  const { pendingAttachment, state } = input.pendingUpload;\n  const writerProjection =\n    state.writerProjection?.documentId === input.pendingUpload.remoteDocumentId\n      ? state.writerProjection\n      : null;\n  const writerProjectionGeneration = state.writerProjectionGeneration;\n\n  try {\n    const uploadAttempt = await uploadAttachmentWithWriterProjectionRetry({\n      baseUploadInput: input.baseUploadInput,\n      state,\n      writerProjection,\n    });\n    const { error: uploadError, remoteSyncBlocked, uploaded } = uploadAttempt;\n    if (!uploaded) {\n      if (remoteSyncBlocked) {\n        input.uploadLane.failIfStarted(\n          new Error(\"Attachment upload paused because remote sync is blocked.\"),\n        );\n        return \"retry\";\n      }\n      reportAttachmentUploadFailure({\n        attachmentGeneration: input.pendingUpload.attachmentGeneration,\n        error: uploadError,\n        pendingAttachment,\n        state,\n        uploadLane: input.uploadLane,\n      });\n      return \"retry\";\n    }\n\n    await settleUploadedAttachment({\n      activeBindingBySlotId: input.pendingUpload.activeBindingBySlotId,\n      attachmentGeneration: input.pendingUpload.attachmentGeneration,\n      pendingAttachment,\n      remoteDocumentId: input.pendingUpload.remoteDocumentId,\n      state,\n      uploadLane: input.uploadLane,\n      uploaded,\n      writerProjectionGeneration,\n    });\n    return \"uploaded\";\n  } catch (error) {\n    reportAttachmentUploadFailure({\n      attachmentGeneration: input.pendingUpload.attachmentGeneration,\n      error,\n      pendingAttachment,\n      state,\n      uploadLane: input.uploadLane,\n    });\n    throw error;\n  }\n}\n\nasync function syncPendingAttachmentUpload(\n  input: PendingAttachmentUploadInput,\n): Promise<PendingAttachmentUploadOutcome> {\n  const { pendingAttachment, state } = input;\n  // The binding fetch before this call awaits; a teardown during it must not\n  // let a brand-new upload start against rows that no longer exist.\n  if (\n    !isDocumentStoreSyncGenerationCurrent(state, input.attachmentGeneration)\n  ) {\n    return \"retry\";\n  }\n  if (!pendingAttachmentMatchesIntent(input)) {\n    return dropUnavailablePendingAttachment(input);\n  }\n  if (await recoverCommittedAttachment(input)) {\n    return \"recovered\";\n  }\n\n  const source = await state.runtime.infra.blobStore.openByteSource(\n    pendingAttachment.storageKey,\n  );\n  if (!source) {\n    return dropUnavailablePendingAttachment(input);\n  }\n\n  const author = resolveDocumentCreateAuthor(state.runtime);\n  if (!author) {\n    state.runtime.util.log(\n      \"Documents: skipped attachment upload because the writer context is unavailable.\",\n    );\n    return \"retry\";\n  }\n\n  const prepared = await resolveAttachmentSourceUpload({\n    attachmentGeneration: input.attachmentGeneration,\n    pendingAttachment,\n    source,\n    state,\n  });\n  // Preparation awaited (byte-source open plus resume resolution); a teardown\n  // during those awaits must not let the upload itself start — its remote\n  // commit could not be recalled once sent.\n  if (\n    !isDocumentStoreSyncGenerationCurrent(state, input.attachmentGeneration)\n  ) {\n    return \"retry\";\n  }\n  if (!prepared) return dropUnavailablePendingAttachment(input);\n  const { resume, snapshot } = prepared;\n  const uploadLane = createAttachmentUploadLaneReporter({\n    blobId: resume.blobId,\n    domainScope: state.runtime.state.domainScope,\n    pendingAttachment,\n  });\n  const baseUploadInput = createAttachmentBaseUploadInput({\n    author,\n    pendingUpload: input,\n    resume,\n    source,\n    sourceSnapshot: snapshot,\n    uploadLane,\n  });\n  return uploadPendingAttachmentBytes({\n    baseUploadInput,\n    pendingUpload: input,\n    uploadLane,\n  });\n}\n\nfunction reportAttachmentUploadFailure(input: {\n  attachmentGeneration: DocumentStoreSyncGeneration;\n  error: unknown;\n  pendingAttachment: PendingAttachmentRecord;\n  state: DocumentStoreState;\n  uploadLane: AttachmentUploadLaneReporter;\n}): void {\n  const error = createAttachmentUploadFailedError(\n    input.pendingAttachment,\n    input.error,\n  );\n  input.uploadLane.fail(error);\n  input.state.runtime.util.log(`Documents: ${error.message}`);\n  // Surface the stuck upload in the write queue; a later successful sync pass\n  // for the document clears the record. Validated inside the serialized\n  // mutation: a teardown (reset/discard) racing this pass just cleared the\n  // failure row, and re-recording it would resurrect a phantom queue entry\n  // for work that no longer exists.\n  void runSerializedSqlMutation(\n    input.state.runtime.infra.execSql,\n    async (lockedExecSql) => {\n      if (\n        !isDocumentStoreSyncGenerationCurrent(\n          input.state,\n          input.attachmentGeneration,\n        )\n      ) {\n        return;\n      }\n      await recordDocumentSyncFailure(\n        lockedExecSql,\n        { appKind: DOCUMENTS_APP_KIND, localId: input.state.localId },\n        {\n          attemptedAt: new Date().toISOString(),\n          message: error.message,\n          status: null,\n        },\n      );\n    },\n  ).catch(() => undefined);\n}\n"]}

package/stores/documents/documentStore/{syncDetachedAttachments.js → sync/syncDetachedAttachments.js}

@@ -1,12 +1,12 @@
-import { getDocumentAttachments } from "../../../data/documents/documentContent.js";
-import { detachDocumentAttachment } from "../../../workflows/blobs/detach.js";
-import { resolveDocumentCreateAuthor, } from "../../../workflows/documents/index.js";
-import { createRuntimePrincipalPolicyWarmer } from "../../../workflows/principals/runtimePolicyWarmer.js";
-import { deleteLocalAttachmentRecord } from "./attachmentPersistence.js";
-import { runDocumentOrphanMaintenance } from "./orphanMaintenance.js";
+import { getDocumentAttachments } from "../../../../data/documents/documentContent.js";
+import { detachDocumentAttachment } from "../../../../workflows/blobs/detach.js";
+import { resolveDocumentCreateAuthor, } from "../../../../workflows/documents/index.js";
+import { createRuntimePrincipalPolicyWarmer } from "../../../../workflows/principals/runtimePolicyWarmer.js";
+import { deleteLocalAttachmentRecord } from "../attachments/attachmentPersistence.js";
+import { runDocumentOrphanMaintenance } from "../orphanMaintenance.js";
+import { installDocumentWriterProjection } from "../writerProjectionGeneration.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 import { documentSyncContextMatches } from "./syncUpdateImport.js";
-import { installDocumentWriterProjection } from "./writerProjectionGeneration.js";
 export async function syncDetachedAttachmentBindings(state, nextRecord, generation) {
     const currentDoc = generation.currentDoc;
     if (!currentDoc ||

package/stores/documents/documentStore/sync/syncDetachedAttachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncDetachedAttachments.js","sourceRoot":"","sources":["syncDetachedAttachments.ts"],"names":[],"mappings":"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","sourcesContent":["import { getDocumentAttachments } from \"../../../../data/documents/documentContent\";\nimport { detachDocumentAttachment } from \"../../../../workflows/blobs/detach\";\nimport {\n  type DocumentRecord,\n  resolveDocumentCreateAuthor,\n} from \"../../../../workflows/documents\";\nimport { createRuntimePrincipalPolicyWarmer } from \"../../../../workflows/principals/runtimePolicyWarmer\";\nimport { deleteLocalAttachmentRecord } from \"../attachments/attachmentPersistence\";\nimport { runDocumentOrphanMaintenance } from \"../orphanMaintenance\";\nimport type {\n  DocumentAttachmentBinding,\n  DocumentState,\n  DocumentStoreState,\n} from \"../state\";\nimport { installDocumentWriterProjection } from \"../writerProjectionGeneration\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { documentSyncContextMatches } from \"./syncUpdateImport\";\n\ninterface DetachedAttachmentMarker {\n  slotId: string;\n  storageKey: string;\n}\n\nexport async function syncDetachedAttachmentBindings(\n  state: DocumentStoreState,\n  nextRecord: DocumentRecord,\n  generation: DocumentStoreSyncGeneration,\n): Promise<void> {\n  const currentDoc = generation.currentDoc;\n  if (\n    !currentDoc ||\n    !detachedSyncContextIsCurrent(state, generation, nextRecord)\n  ) {\n    return;\n  }\n\n  const detachedMarkers = listDetachedAttachmentMarkers(state, currentDoc);\n  if (detachedMarkers.length === 0) {\n    return;\n  }\n\n  if (!nextRecord.documentId) {\n    await cleanupDetachedAttachmentMarkers(\n      state,\n      currentDoc,\n      nextRecord,\n      detachedMarkers,\n      generation,\n    );\n    return;\n  }\n\n  const remoteDocumentId = nextRecord.documentId;\n  const remoteBindings =\n    await state.runtime.apiClient.listDocumentAttachments(remoteDocumentId);\n  if (\n    !remoteBindings ||\n    !detachedSyncContextIsCurrent(state, generation, nextRecord)\n  ) {\n    return;\n  }\n\n  const activeBindingBySlotId = new Map(\n    remoteBindings.map((binding) => [binding.slotId, binding]),\n  );\n\n  for (const marker of detachedMarkers) {\n    if (!detachedSyncContextIsCurrent(state, generation, nextRecord)) {\n      return;\n    }\n    const activeBinding = activeBindingBySlotId.get(marker.slotId);\n    if (activeBinding) {\n      const detached = await syncDetachedAttachmentBinding({\n        binding: activeBinding,\n        generation,\n        remoteDocumentId,\n        requestRecord: nextRecord,\n        state,\n      });\n      if (!detached) {\n        return;\n      }\n    }\n\n    const cleaned = await cleanupDetachedAttachmentMarker(\n      state,\n      currentDoc,\n      nextRecord,\n      marker,\n      generation,\n    );\n    if (!cleaned) {\n      return;\n    }\n  }\n}\n\nfunction detachedSyncContextIsCurrent(\n  state: DocumentStoreState,\n  generation: DocumentStoreSyncGeneration,\n  requestRecord: DocumentRecord,\n): boolean {\n  return (\n    isDocumentStoreSyncGenerationCurrent(state, generation) &&\n    documentSyncContextMatches(\n      state.record,\n      requestRecord,\n      requestRecord.documentId,\n    )\n  );\n}\n\nfunction listDetachedAttachmentMarkers(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n): DetachedAttachmentMarker[] {\n  const currentSlotIds = new Set(\n    getDocumentAttachments(currentDoc).map((attachment) => attachment.slotId),\n  );\n\n  return Object.entries(state.attachmentStorageKeyBySlotId).flatMap(\n    ([slotId, storageKey]) =>\n      currentSlotIds.has(slotId) ? [] : [{ slotId, storageKey }],\n  );\n}\n\nasync function cleanupDetachedAttachmentMarkers(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  requestRecord: DocumentRecord,\n  markers: readonly DetachedAttachmentMarker[],\n  generation: DocumentStoreSyncGeneration,\n): Promise<void> {\n  for (const marker of markers) {\n    if (\n      !(await cleanupDetachedAttachmentMarker(\n        state,\n        currentDoc,\n        requestRecord,\n        marker,\n        generation,\n      ))\n    ) {\n      return;\n    }\n  }\n}\n\nasync function cleanupDetachedAttachmentMarker(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  requestRecord: DocumentRecord,\n  marker: DetachedAttachmentMarker,\n  generation: DocumentStoreSyncGeneration,\n): Promise<boolean> {\n  if (!detachedSyncContextIsCurrent(state, generation, requestRecord)) {\n    return false;\n  }\n  await deleteLocalAttachmentRecord(\n    state,\n    marker.slotId,\n    marker.storageKey,\n    currentDoc,\n  );\n  // Deleting the row queued its bytes for the reference-checked reclaim.\n  void runDocumentOrphanMaintenance(state);\n  return detachedSyncContextIsCurrent(state, generation, requestRecord);\n}\n\nasync function syncDetachedAttachmentBinding(input: {\n  binding: DocumentAttachmentBinding;\n  generation: DocumentStoreSyncGeneration;\n  remoteDocumentId: string;\n  requestRecord: DocumentRecord;\n  state: DocumentStoreState;\n}): Promise<boolean> {\n  const { binding, generation, requestRecord, state } = input;\n  const contextIsCurrent = () =>\n    detachedSyncContextIsCurrent(state, generation, requestRecord);\n  if (!contextIsCurrent()) return false;\n\n  const author = resolveDocumentCreateAuthor(state.runtime);\n  if (!author) {\n    state.runtime.util.log(\n      \"Documents: skipped attachment detach because the writer context is unavailable.\",\n    );\n    return false;\n  }\n\n  const writerProjection =\n    state.writerProjection?.documentId === input.remoteDocumentId\n      ? state.writerProjection\n      : null;\n  const writerProjectionGeneration = state.writerProjectionGeneration;\n  let remoteSyncBlocked = false;\n  const baseDetachInput = {\n    apiClient: state.runtime.apiClient,\n    author,\n    bindingId: binding.bindingId,\n    blobId: binding.blobId,\n    documentId: input.remoteDocumentId,\n    execSql: generation.execSql,\n    isRemoteSyncBlocked: (organizationId: string) => {\n      remoteSyncBlocked =\n        state.runtime.util.isRemoteSyncBlocked?.(organizationId) ?? false;\n      return remoteSyncBlocked;\n    },\n    resolveProjectionUserKey: generation.resolveProjectionUserKey,\n    slotId: binding.slotId,\n    stillCurrent: contextIsCurrent,\n    warmReferencedPrincipalPolicies: createRuntimePrincipalPolicyWarmer(\n      state.runtime,\n    ),\n  };\n  let detached = await detachDocumentAttachment({\n    ...baseDetachInput,\n    writerProjection: writerProjection ?? undefined,\n  });\n  if (!contextIsCurrent()) return false;\n  if (!detached && writerProjection && !remoteSyncBlocked) {\n    state.writerProjection = null;\n    detached = await detachDocumentAttachment(baseDetachInput);\n    if (!contextIsCurrent()) return false;\n  }\n  if (!detached) {\n    return false;\n  }\n\n  installDocumentWriterProjection(\n    state,\n    detached.writerProjection,\n    writerProjectionGeneration,\n  );\n  state.runtime.util.log(\n    `Detached attachment ${binding.slotId} from document ${input.remoteDocumentId}.`,\n  );\n  return true;\n}\n"]}

package/stores/documents/documentStore/{syncFinalize.js → sync/syncFinalize.js}

@@ -1,18 +1,18 @@
-import { bytesToBase64 } from "../../../internal/encoding/index.js";
-import { emptyVersionVector, encodeVersionVector, getImportBlobMetadata, mergeVersionVectors, } from "../../../internal/loro/index.js";
-import { readPullContinuation } from "../../../data/documents/shared/syncPagination.js";
-import { settleOutgoingPassAndDecideReArm, shouldClearDocumentSyncFailureAfterPass, } from "../../../workflows/documents/index.js";
-import { requestDocumentStoreSync } from "../registry.js";
-import { hydrateAttachmentBlobs } from "./attachmentHydration.js";
-import { chainIdentityWrite } from "./identityWriteChain.js";
-import { publishPersistedDocument, saveDocumentRecord } from "./persistence.js";
+import { bytesToBase64 } from "../../../../internal/encoding/index.js";
+import { emptyVersionVector, encodeVersionVector, getImportBlobMetadata, mergeVersionVectors, } from "../../../../internal/loro/index.js";
+import { readPullContinuation } from "../../../../data/documents/shared/syncPagination.js";
+import { settleOutgoingPassAndDecideReArm, shouldClearDocumentSyncFailureAfterPass, } from "../../../../workflows/documents/index.js";
+import { requestDocumentStoreSync } from "../../registry.js";
+import { hydrateAttachmentBlobs } from "../attachments/attachmentHydration.js";
+import { chainIdentityWrite } from "../identityWriteChain.js";
+import { publishPersistedDocument, saveDocumentRecord } from "../persistence.js";
+import { installDocumentWriterProjection } from "../writerProjectionGeneration.js";
 import { logRevalidationApplied as logApplied } from "./remoteRevalidationTelemetry.js";
 import { discardPreRegisteredUpdateIds, discardUnacceptedPreRegisteredUpdateIds, } from "./syncAcceptedUpdateIds.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 import { clearConsumedRemoteUpdateSignal } from "./syncRemoteSignals.js";
 import { applyIncomingSyncedUpdates, documentSyncContextMatches, importSyncedDocumentUpdates, } from "./syncUpdateImport.js";
 import { extendDocumentVersionCoverage } from "./versionCoverage.js";
-import { installDocumentWriterProjection } from "./writerProjectionGeneration.js";
 function documentWriterProjectionMatchesSyncResponse(writerProjection, synced) {
     return (writerProjection.contentKeyBundle.contentKeyEpoch ===
         synced.response.contentKeyBundle.contentKeyEpoch &&

package/stores/documents/documentStore/sync/syncFinalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncFinalize.js","sourceRoot":"","sources":["syncFinalize.ts"],"names":[],"mappings":"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","sourcesContent":["import { bytesToBase64 } from \"@tearleads/encoding\";\nimport {\n  emptyVersionVector,\n  encodeVersionVector,\n  getImportBlobMetadata,\n  mergeVersionVectors,\n} from \"@tearleads/loro\";\nimport { readPullContinuation } from \"../../../../data/documents/shared/syncPagination\";\nimport {\n  type DocumentRecord,\n  settleOutgoingPassAndDecideReArm,\n  shouldClearDocumentSyncFailureAfterPass,\n} from \"../../../../workflows/documents\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport { hydrateAttachmentBlobs } from \"../attachments/attachmentHydration\";\nimport { chainIdentityWrite } from \"../identityWriteChain\";\nimport { publishPersistedDocument, saveDocumentRecord } from \"../persistence\";\nimport type {\n  DocumentState,\n  DocumentStoreState,\n  DocumentSyncAttempt,\n  SaveDocumentRecordOptions,\n} from \"../state\";\nimport { installDocumentWriterProjection } from \"../writerProjectionGeneration\";\nimport { logRevalidationApplied as logApplied } from \"./remoteRevalidationTelemetry\";\nimport {\n  discardPreRegisteredUpdateIds,\n  discardUnacceptedPreRegisteredUpdateIds,\n} from \"./syncAcceptedUpdateIds\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { clearConsumedRemoteUpdateSignal } from \"./syncRemoteSignals\";\nimport {\n  applyIncomingSyncedUpdates,\n  documentSyncContextMatches,\n  importSyncedDocumentUpdates,\n} from \"./syncUpdateImport\";\nimport { extendDocumentVersionCoverage } from \"./versionCoverage\";\n\nfunction documentWriterProjectionMatchesSyncResponse(\n  writerProjection: NonNullable<\n    DocumentSyncAttempt[\"synced\"][\"writerProjection\"]\n  >,\n  synced: DocumentSyncAttempt[\"synced\"],\n): boolean {\n  return (\n    writerProjection.contentKeyBundle.contentKeyEpoch ===\n      synced.response.contentKeyBundle.contentKeyEpoch &&\n    writerProjection.contentKeyBundle.linkSetManifestHash ===\n      synced.response.contentKeyBundle.linkSetManifestHash &&\n    writerProjection.contentKeyBundle.targetHash ===\n      synced.response.contentKeyBundle.targetHash &&\n    writerProjection.documentKekTargets.linkSetManifestHash ===\n      synced.response.documentKekTargets.linkSetManifestHash &&\n    writerProjection.documentKekTargets.documentKeyTargetHash ===\n      synced.response.documentKekTargets.documentKeyTargetHash\n  );\n}\n\nfunction resolveSyncedDocumentWriterProjection(\n  state: DocumentStoreState,\n  synced: DocumentSyncAttempt[\"synced\"],\n) {\n  const writerProjection =\n    synced.writerProjection ??\n    (state.writerProjection?.documentId === synced.plan.documentId\n      ? state.writerProjection\n      : null);\n  return writerProjection &&\n    documentWriterProjectionMatchesSyncResponse(writerProjection, synced)\n    ? writerProjection\n    : null;\n}\n\n/**\n * Durable-history tail: append pulled updates BEFORE the record persist so\n * the tail stays a superset of what the snapshot covers (duplicates are\n * idempotent by op identity; a crash between the writes can only leave the\n * safe superset).\n */\nfunction pulledHistoryUpdates(synced: DocumentSyncAttempt[\"synced\"]): string[] {\n  return synced.decryptedUpdates.map((update) =>\n    bytesToBase64(update.updateData),\n  );\n}\n\n/**\n * The frontier a finalize persist may publish: the stored frontier advanced\n * by exactly the pulled updates just appended to the durable tail — never the\n * live document's version, which can transiently include an in-flight local\n * edit whose durable row has not landed yet.\n */\nfunction coveredSyncFrontier(\n  state: DocumentStoreState,\n  currentRecord: DocumentRecord,\n  synced: DocumentSyncAttempt[\"synced\"],\n): { snapshotEndVersion: string } | Record<string, never> {\n  const liveFrontier = (state.record ?? currentRecord).snapshotEndVersion;\n  if (synced.decryptedUpdates.length === 0) {\n    // A completed empty pull distinguishes a real blank note from discovery.\n    // An intermediate page cannot establish that no content exists yet.\n    return liveFrontier === \"\" && !synced.hasIncompletePull\n      ? { snapshotEndVersion: emptyVersionVector() }\n      : {};\n  }\n  return {\n    snapshotEndVersion: mergeVersionVectors([\n      ...(liveFrontier.length > 0 ? [liveFrontier] : []),\n      ...synced.decryptedUpdates.map(\n        (update) =>\n          getImportBlobMetadata(update.updateData).partialEndVersionVector,\n      ),\n    ]),\n  };\n}\n\nfunction documentSyncSaveOptions(\n  syncAttempt: DocumentSyncAttempt,\n): SaveDocumentRecordOptions {\n  return {\n    acceptedPendingUpdateIds: syncAttempt.synced.settledPendingUpdateIds,\n    clearSyncFailure: shouldClearDocumentSyncFailureAfterPass(\n      syncAttempt.synced,\n      syncAttempt.outgoingUpdateCount,\n    ),\n    expectedSyncState: {\n      pullContinuation: syncAttempt.consumedPullContinuation,\n      record: syncAttempt.requestRecord,\n    },\n    historyUpdateOrigin: \"remote\",\n    historyUpdates: pulledHistoryUpdates(syncAttempt.synced),\n    preserveSnapshotStructuredFields: true,\n    preserveSnapshotText: true,\n  };\n}\n\nasync function persistSyncedDocument(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  currentRecord: DocumentRecord,\n  syncAttempt: DocumentSyncAttempt,\n  generation: DocumentStoreSyncGeneration,\n) {\n  const { synced } = syncAttempt;\n  const updates = synced.decryptedUpdates;\n  const candidate = currentDoc.fork();\n  const previousDocumentId = state.record?.documentId ?? null;\n  const options = documentSyncSaveOptions(syncAttempt);\n  const isCurrent = () =>\n    isDocumentStoreSyncGenerationCurrent(state, generation);\n  try {\n    importSyncedDocumentUpdates(candidate, updates);\n    if (state.pendingBaseVersion === null) {\n      throw new Error(\"Document sync requires an initialized pending base\");\n    }\n    const persisted = await saveDocumentRecord(\n      state,\n      candidate,\n      {\n        ...synced.persistedState,\n        lastCommitLsn:\n          synced.response.commitLsn ?? currentRecord.lastCommitLsn ?? null,\n        pullContinuation: readPullContinuation(synced.response),\n        ...coveredSyncFrontier(state, currentRecord, synced),\n      },\n      {\n        ...options,\n        pendingBaseVersionOverride: extendDocumentVersionCoverage({\n          baseVersion: state.pendingBaseVersion,\n          documentVersion: encodeVersionVector(candidate),\n          spans: updates,\n        }),\n      },\n      generation,\n    );\n    if (\n      persisted &&\n      isCurrent() &&\n      !persisted.pullContinuationSuperseded &&\n      !persisted.syncIdentitySuperseded\n    ) {\n      // Publish a remote edit only once its history and continuation commit.\n      // Importing earlier lets a losing CAS expose text that the next local\n      // write authors against an older, reloaded CRDT history.\n      // The durable CAS already checked the request's complete context. The\n      // successful row is now live, so publication uses that committed context\n      // (which may contain refreshed keying metadata) and the same generation.\n      applyIncomingSyncedUpdates(\n        state,\n        currentDoc,\n        persisted.record,\n        syncAttempt,\n        generation,\n      );\n    }\n    return await publishPersistedDocument(\n      state,\n      currentDoc,\n      persisted,\n      previousDocumentId,\n      options,\n      isCurrent,\n    );\n  } finally {\n    candidate.free();\n  }\n}\n\nexport function shouldReArmDocumentSync(\n  state: DocumentStoreState,\n  syncAttempt: DocumentSyncAttempt,\n): boolean {\n  const { synced } = syncAttempt;\n  const shouldReArmOutgoing = settleOutgoingPassAndDecideReArm(state, {\n    exhaustedPendingUpdateCount: synced.exhaustedPendingUpdateCount,\n    outgoingUpdateCount: syncAttempt.outgoingUpdateCount,\n    rekeyedUpdateCount: synced.rekeyedPendingUpdateIds.length,\n    settledUpdateCount: synced.settledPendingUpdateIds.length,\n    acceptedRecoveryBaseline: synced.acceptedRecoveryBaseline,\n  });\n  return (\n    synced.hasDeferredPendingUpdates ||\n    synced.hasIncompletePull ||\n    shouldReArmOutgoing\n  );\n}\n\nexport async function finalizeDocumentSync(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  currentRecord: DocumentRecord,\n  syncAttempt: DocumentSyncAttempt,\n  consumedRemoteUpdateSignalSeq: number,\n  generation: DocumentStoreSyncGeneration,\n  sentUpdateIds: readonly string[],\n  wasRemoteProbe: boolean,\n): Promise<DocumentRecord> {\n  const { synced } = syncAttempt;\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    requestDocumentStoreSync(state);\n    return state.record ?? currentRecord;\n  }\n\n  // The sent IDs were pre-registered as self-authored before the network call so\n  // the redis echo can never beat us. Reconcile against what the server actually\n  // accepted: an ID we sent but the server did not accept will never be echoed,\n  // so drop it to keep locallyAcceptedUpdateIds from leaking. Accepted IDs (a\n  // subset of what we sent) stay registered until their echo consumes them.\n  discardUnacceptedPreRegisteredUpdateIds(\n    state,\n    sentUpdateIds,\n    synced.response.acceptedOutgoingUpdateIds,\n  );\n  // Persist on the identity-write chain: synced.persistedState carries this\n  // pass's documentId, so it would clobber a relink that landed mid-pass. If\n  // the identity moved, the response describes the OLD document — skip every\n  // response-derived in-memory mutation and let the new identity's own sync\n  // pass take over.\n  let responseApplied = false;\n  const { record: nextRecord } = await chainIdentityWrite(state, async () => {\n    const liveRecord = state.record;\n    if (\n      !isDocumentStoreSyncGenerationCurrent(state, generation) ||\n      !documentSyncContextMatches(\n        liveRecord,\n        currentRecord,\n        synced.plan.documentId,\n      )\n    ) {\n      return { record: liveRecord ?? currentRecord };\n    }\n\n    installDocumentWriterProjection(\n      state,\n      resolveSyncedDocumentWriterProjection(state, synced),\n      syncAttempt.writerProjectionGeneration,\n    );\n    const persisted = await persistSyncedDocument(\n      state,\n      currentDoc,\n      currentRecord,\n      syncAttempt,\n      generation,\n    );\n    if (\n      !persisted ||\n      !isDocumentStoreSyncGenerationCurrent(state, generation)\n    ) {\n      return { record: state.record ?? currentRecord };\n    }\n\n    state.pullContinuation = persisted.record.pullContinuation ?? null;\n    if (persisted.pullContinuationSuperseded) {\n      state.writerProjection = null;\n    }\n    // A CAS loss means neither this response's acknowledgements nor its\n    // continuation were committed. Keep the pass unapplied so its signals and\n    // accepted-id registrations cannot be cleared without a follow-up.\n    responseApplied = !persisted.pullContinuationSuperseded;\n    return persisted;\n  });\n  if (!responseApplied) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    requestDocumentStoreSync(state);\n    return nextRecord;\n  }\n\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRecord;\n  }\n\n  // A bounded pull request owns the whole page chain. Completing the signal on\n  // an intermediate page would let a failed/null continuation pass report the\n  // original request as successful even though the server frontier was never\n  // drained.\n  if (!synced.hasIncompletePull) {\n    clearConsumedRemoteUpdateSignal(state, consumedRemoteUpdateSignalSeq);\n  }\n\n  if (shouldReArmDocumentSync(state, syncAttempt)) {\n    requestDocumentStoreSync(state);\n  }\n\n  await hydrateAttachmentBlobs(state, currentDoc, nextRecord, generation);\n  logApplied(state, currentDoc, synced.decryptedUpdates.length, wasRemoteProbe);\n  return nextRecord;\n}\n"]}

package/stores/documents/documentStore/sync/syncGeneration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncGeneration.js","sourceRoot":"","sources":["syncGeneration.ts"],"names":[],"mappings":"AAGA,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAA8B,CAAC;AACxE,MAAM,mBAAmB,GAAG,IAAI,OAAO,EAA8B,CAAC;AAMtE,MAAM,2BAA2B,GAAG,IAAI,OAAO,EAG5C,CAAC;AACJ,MAAM,4BAA4B,GAAG,IAAI,OAAO,EAM7C,CAAC;AAEJ,SAAS,uBAAuB,CAAC,KAAyB;IACxD,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAuBD,SAAS,gCAAgC,CACvC,UAA2C;IAG3C,OAAO,CACL,oBAAoB,IAAI,UAAU,IAAI,oBAAoB,IAAI,UAAU,CACzE,CAAC;AACJ,CAAC;AAsBD,MAAM,UAAU,sCAAsC,CACpD,KAAyB;IAEzB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS;QAClC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS;QACxC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW;QAC5C,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB;QAC1D,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO;QACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc;QAClD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS;QACxC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,oCAAoC,CAC3C,KAAyB;IAEzB,OAAO;QACL,kBAAkB,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QACvD,kBAAkB,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,IAAI,IAAI;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,KAAyB;IAEzB,OAAO,oCAAoC,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,+BAA+B,CAC7C,KAAyB;IAEzB,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,KAAyB;IAEzB,OAAO;QACL,GAAG,sCAAsC,CAAC,KAAK,CAAC;QAChD,GAAG,oCAAoC,CAAC,KAAK,CAAC;QAC9C,oBAAoB,EAAE,uBAAuB,CAAC,KAAK,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAAyB,EACzB,UAAgC;IAEhC,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAE1C,OAAO;QACL,UAAU;QACV,GAAG,sCAAsC,CAAC,KAAK,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,KAAyB,EACzB,UAAgC,EAChC,kBAAmD;IAEnD,MAAM,UAAU,GAAG,kCAAkC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,IACE,CAAC,UAAU;QACX,CAAC,wCAAwC,CAAC,KAAK,EAAE,kBAAkB,CAAC,EACpE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,GAAG,UAAU;QACb,GAAG,kBAAkB;QACrB,oBAAoB,EAAE,uBAAuB,CAAC,KAAK,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4CAA4C,CAC1D,KAAyB,EACzB,UAAgC,EAChC,kBAAmD;IAEnD,MAAM,UAAU,GAAG,kCAAkC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,IACE,CAAC,UAAU;QACX,CAAC,wCAAwC,CAAC,KAAK,EAAE,kBAAkB,CAAC,EACpE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,kBAAkB,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAC/C,KAAyB;IAEzB,qBAAqB,CAAC,GAAG,CAAC,KAAK,EAAE,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAyB;IACpE,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAAyB,EACzB,KAA+B;IAE/B,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,4BAA4B,CAAC,GAAG,CAAC,KAAK,EAAE;YACtC,UAAU,EAAE,+CAA+C,CAAC,KAAK,CAAC;YAClE,cAAc,EAAE,KAAK,CAAC,qBAAqB;SAC5C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,qBAAqB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,4CAA4C,CAC1D,KAAyB;IAEzB,MAAM,MAAM,GAAG,4BAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,CACL,MAAM,KAAK,SAAS;QACpB,iDAAiD,CAC/C,KAAK,EACL,MAAM,CAAC,UAAU,CAClB;QACD,CAAC,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,8BAA8B;YAC3D,KAAK,CAAC,gBAAgB,KAAK,IAAI;YAC/B,KAAK,CAAC,MAAM,EAAE,gCAAgC,KAAK,IAAI,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAyB,EACzB,UAAoD;IAEpD,MAAM,WAAW,GAAG,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CACzC,8CAA8C,CAC5C,SAAS,CAAC,UAAU,EACpB,UAAU,CACX,CACF,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;QACjC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,2BAA2B,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IACjB,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,GAAG,KAAK,CAAC;QACf,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACjB,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACtB,uEAAuE;YACvE,wEAAwE;YACxE,iEAAiE;YACjE,MAAM,SAAS,GAAG,CAAC,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CACrE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CACnC,CAAC;YACF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,2BAA2B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,2BAA2B,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,8CAA8C,CACrD,IAA8C,EAC9C,KAA+C;IAE/C,OAAO,CACL,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB;QACpD,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;QAC9B,IAAI,CAAC,oBAAoB,KAAK,KAAK,CAAC,oBAAoB;QACxD,IAAI,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;QAC5C,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;QAClC,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,oBAAoB,KAAK,KAAK,CAAC,oBAAoB;QACxD,IAAI,CAAC,wBAAwB,KAAK,KAAK,CAAC,wBAAwB;QAChE,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB;QACpD,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB,CACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,KAAyB;IAEzB,OAAO,KAAK,CAAC,iBAAiB,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iDAAiD,CAC/D,KAAyB,EACzB,UAAoD;IAEpD,OAAO,CACL,wCAAwC,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3D,uBAAuB,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,oBAAoB,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yCAAyC,CACvD,KAAyB,EACzB,UAAoD,EACpD,uBAA+B;IAE/B,OAAO,CACL,iDAAiD,CAAC,KAAK,EAAE,UAAU,CAAC;QACpE,KAAK,CAAC,8BAA8B,IAAI,uBAAuB,CAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAyB,EACzB,UAAuC;IAEvC,OAAO,CACL,KAAK,CAAC,GAAG,KAAK,UAAU,CAAC,UAAU;QACnC,wCAAwC,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3D,CAAC,CAAC,CAAC,sBAAsB,IAAI,UAAU,CAAC;YACtC,uBAAuB,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,oBAAoB,CAAC,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,KAAyB,EACzB,UAA2C;IAE3C,OAAO,CACL,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,UAAU,CAAC,kBAAkB;QACvE,CAAC,UAAU,CAAC,kBAAkB,EAAE,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,KAAyB,EACzB,UAA2C;IAE3C,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS;QAChD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS;QACtD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU,CAAC,WAAW;QAC1D,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,KAAK,UAAU,CAAC,kBAAkB;QACxE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU,CAAC,WAAW;QAC1D,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO;QAClD,KAAK,CAAC,oBAAoB,KAAK,UAAU,CAAC,oBAAoB;QAC9D,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,KAAK,UAAU,CAAC,cAAc;QAChE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS;QACtD,KAAK,CAAC,WAAW,KAAK,UAAU,CAAC,WAAW;QAC5C,KAAK,CAAC,wBAAwB,KAAK,UAAU,CAAC,wBAAwB;QACtE,CAAC,CAAC,gCAAgC,CAAC,UAAU,CAAC;YAC5C,wCAAwC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC","sourcesContent":["import type { DocumentProjectionUserKeyResolver } from \"../../../../workflows/documents\";\nimport type { DocumentState, DocumentStoreState } from \"../state\";\n\nconst remoteSyncGenerations = new WeakMap<DocumentStoreState, number>();\nconst syncLaneGenerations = new WeakMap<DocumentStoreState, number>();\ninterface RemoteSyncWaiterGeneration {\n  count: number;\n  readonly generation: DocumentStoreRemoteSyncRequestGeneration;\n}\n\nconst remoteSyncWaiterGenerations = new WeakMap<\n  DocumentStoreState,\n  RemoteSyncWaiterGeneration[]\n>();\nconst independentRemoteSyncSignals = new WeakMap<\n  DocumentStoreState,\n  {\n    readonly generation: DocumentStoreRemoteSyncRequestGeneration;\n    readonly signalSequence: number;\n  }\n>();\n\nfunction getRemoteSyncGeneration(state: DocumentStoreState): number {\n  return remoteSyncGenerations.get(state) ?? 0;\n}\n\ninterface DocumentStoreGenerationIdentity {\n  readonly apiClient: DocumentStoreState[\"runtime\"][\"apiClient\"];\n  readonly blobStore: DocumentStoreState[\"runtime\"][\"infra\"][\"blobStore\"];\n  readonly containerId: DocumentStoreState[\"runtime\"][\"state\"][\"containerId\"];\n  readonly documentProjectors: DocumentStoreState[\"runtime\"][\"infra\"][\"documentProjectors\"];\n  readonly domainScope: DocumentStoreState[\"runtime\"][\"state\"][\"domainScope\"];\n  readonly execSql: DocumentStoreState[\"runtime\"][\"infra\"][\"execSql\"];\n  readonly localWriteGeneration: number;\n  readonly organizationId: DocumentStoreState[\"runtime\"][\"auth\"][\"organizationId\"];\n  readonly peerScope: DocumentStoreState[\"runtime\"][\"state\"][\"peerScope\"];\n  readonly persistence: DocumentStoreState[\"persistence\"];\n  readonly resolveProjectionUserKey: DocumentProjectionUserKeyResolver;\n}\n\ninterface DocumentStoreSyncLaneIdentity {\n  readonly syncLaneGeneration: number;\n  readonly syncLaneIsDisposed: (() => boolean) | null;\n}\n\nexport type DocumentStoreSyncLaneGeneration = DocumentStoreSyncLaneIdentity;\n\nfunction hasDocumentStoreSyncLaneIdentity(\n  generation: DocumentStoreGenerationIdentity,\n): generation is DocumentStoreGenerationIdentity &\n  DocumentStoreSyncLaneIdentity {\n  return (\n    \"syncLaneGeneration\" in generation && \"syncLaneIsDisposed\" in generation\n  );\n}\n\n/** Immutable identities that define one remote-sync request generation. */\nexport interface DocumentStoreRemoteSyncRequestGeneration\n  extends DocumentStoreGenerationIdentity,\n    DocumentStoreSyncLaneIdentity {\n  readonly remoteSyncGeneration: number;\n}\n\n/** Immutable identities that define one live document-store generation. */\nexport interface DocumentStoreSyncGeneration\n  extends DocumentStoreGenerationIdentity {\n  readonly currentDoc: DocumentState | null;\n}\n\n/** A live store generation that is also cancelled with a remote-only probe. */\ninterface DocumentStoreRemoteSyncGeneration\n  extends DocumentStoreSyncGeneration,\n    DocumentStoreSyncLaneIdentity {\n  readonly remoteSyncGeneration: number;\n}\n\nexport function captureDocumentStoreGenerationIdentity(\n  state: DocumentStoreState,\n): DocumentStoreGenerationIdentity {\n  return {\n    apiClient: state.runtime.apiClient,\n    blobStore: state.runtime.infra.blobStore,\n    containerId: state.runtime.state.containerId,\n    documentProjectors: state.runtime.infra.documentProjectors,\n    domainScope: state.runtime.state.domainScope,\n    execSql: state.runtime.infra.execSql,\n    localWriteGeneration: state.localWriteGeneration,\n    organizationId: state.runtime.auth?.organizationId,\n    peerScope: state.runtime.state.peerScope,\n    persistence: state.persistence,\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n  };\n}\n\nfunction captureDocumentStoreSyncLaneIdentity(\n  state: DocumentStoreState,\n): DocumentStoreSyncLaneIdentity {\n  return {\n    syncLaneGeneration: syncLaneGenerations.get(state) ?? 0,\n    syncLaneIsDisposed: state.syncLane?.isDisposed ?? null,\n  };\n}\n\nexport function captureDocumentStoreSyncLaneGeneration(\n  state: DocumentStoreState,\n): DocumentStoreSyncLaneGeneration {\n  return captureDocumentStoreSyncLaneIdentity(state);\n}\n\n/** Invalidate passes owned by a coordinator that has been replaced. */\nexport function invalidateDocumentStoreSyncLane(\n  state: DocumentStoreState,\n): void {\n  syncLaneGenerations.set(state, (syncLaneGenerations.get(state) ?? 0) + 1);\n}\n\nexport function captureDocumentStoreRemoteSyncRequestGeneration(\n  state: DocumentStoreState,\n): DocumentStoreRemoteSyncRequestGeneration {\n  return {\n    ...captureDocumentStoreGenerationIdentity(state),\n    ...captureDocumentStoreSyncLaneIdentity(state),\n    remoteSyncGeneration: getRemoteSyncGeneration(state),\n  };\n}\n\nexport function captureDocumentStoreSyncGeneration(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null,\n): DocumentStoreSyncGeneration | null {\n  if (state.doc !== currentDoc) return null;\n\n  return {\n    currentDoc,\n    ...captureDocumentStoreGenerationIdentity(state),\n  };\n}\n\nexport function captureDocumentStoreRemoteSyncGeneration(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n): DocumentStoreRemoteSyncGeneration | null {\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (\n    !generation ||\n    !isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n  ) {\n    return null;\n  }\n  return {\n    ...generation,\n    ...syncLaneGeneration,\n    remoteSyncGeneration: getRemoteSyncGeneration(state),\n  };\n}\n\nexport function captureDocumentStoreAttachmentSyncGeneration(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n): DocumentStoreSyncGeneration | null {\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (\n    !generation ||\n    !isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n  ) {\n    return null;\n  }\n  return { ...generation, ...syncLaneGeneration };\n}\n\n/**\n * Revoke every remote-only pass already in flight for this store. The next\n * ordinary sync captures a fresh generation, so queued local writes still\n * recover while a late response from a cancelled read probe cannot persist.\n */\nexport function invalidateDocumentStoreRemoteSync(\n  state: DocumentStoreState,\n): void {\n  remoteSyncGenerations.set(state, getRemoteSyncGeneration(state) + 1);\n  state.remoteSyncBlocked = true;\n  state.remoteUpdatePending = false;\n}\n\nexport function allowDocumentStoreRemoteSync(state: DocumentStoreState): void {\n  state.remoteSyncBlocked = false;\n}\n\nexport function markDocumentStoreRemoteSyncPending(\n  state: DocumentStoreState,\n  owner: \"independent\" | \"waiter\",\n): number {\n  state.remoteUpdatePending = true;\n  state.remoteUpdateSignalSeq += 1;\n  if (owner === \"independent\") {\n    independentRemoteSyncSignals.set(state, {\n      generation: captureDocumentStoreRemoteSyncRequestGeneration(state),\n      signalSequence: state.remoteUpdateSignalSeq,\n    });\n  }\n  return state.remoteUpdateSignalSeq;\n}\n\nexport function hasPendingIndependentDocumentStoreRemoteSync(\n  state: DocumentStoreState,\n): boolean {\n  const signal = independentRemoteSyncSignals.get(state);\n  return (\n    signal !== undefined &&\n    isDocumentStoreRemoteSyncRequestGenerationCurrent(\n      state,\n      signal.generation,\n    ) &&\n    (signal.signalSequence > state.remoteUpdateCompletedSignalSeq ||\n      state.pullContinuation !== null ||\n      state.record?.pullContinuationRecoveryRequired === true)\n  );\n}\n\n/**\n * Register one live owner of a shared remote probe. The returned release\n * function reports whether that owner was the last one still waiting.\n */\nexport function registerDocumentStoreRemoteSyncWaiter(\n  state: DocumentStoreState,\n  generation: DocumentStoreRemoteSyncRequestGeneration,\n): () => boolean {\n  const generations = remoteSyncWaiterGenerations.get(state) ?? [];\n  let entry = generations.find((candidate) =>\n    documentStoreRemoteSyncRequestGenerationsMatch(\n      candidate.generation,\n      generation,\n    ),\n  );\n  if (!entry) {\n    entry = { count: 0, generation };\n    generations.push(entry);\n    remoteSyncWaiterGenerations.set(state, generations);\n  }\n  entry.count += 1;\n  let active = true;\n  return () => {\n    if (!active) return false;\n    active = false;\n    entry.count -= 1;\n    if (entry.count === 0) {\n      // Another generation can remove an entry and replace the WeakMap array\n      // before this release runs. Filter the live registry so a stale closure\n      // cannot overwrite waiters registered on that replacement array.\n      const remaining = (remoteSyncWaiterGenerations.get(state) ?? []).filter(\n        (candidate) => candidate !== entry,\n      );\n      if (remaining.length === 0) {\n        remoteSyncWaiterGenerations.delete(state);\n      } else {\n        remoteSyncWaiterGenerations.set(state, remaining);\n      }\n      return true;\n    }\n    return false;\n  };\n}\n\nfunction documentStoreRemoteSyncRequestGenerationsMatch(\n  left: DocumentStoreRemoteSyncRequestGeneration,\n  right: DocumentStoreRemoteSyncRequestGeneration,\n): boolean {\n  return (\n    left.apiClient === right.apiClient &&\n    left.blobStore === right.blobStore &&\n    left.containerId === right.containerId &&\n    left.documentProjectors === right.documentProjectors &&\n    left.domainScope === right.domainScope &&\n    left.execSql === right.execSql &&\n    left.localWriteGeneration === right.localWriteGeneration &&\n    left.organizationId === right.organizationId &&\n    left.peerScope === right.peerScope &&\n    left.persistence === right.persistence &&\n    left.remoteSyncGeneration === right.remoteSyncGeneration &&\n    left.resolveProjectionUserKey === right.resolveProjectionUserKey &&\n    left.syncLaneGeneration === right.syncLaneGeneration &&\n    left.syncLaneIsDisposed === right.syncLaneIsDisposed\n  );\n}\n\nexport function isDocumentStoreRemoteSyncBlocked(\n  state: DocumentStoreState,\n): boolean {\n  return state.remoteSyncBlocked;\n}\n\nexport function isDocumentStoreRemoteSyncRequestGenerationCurrent(\n  state: DocumentStoreState,\n  generation: DocumentStoreRemoteSyncRequestGeneration,\n): boolean {\n  return (\n    isDocumentStoreGenerationIdentityCurrent(state, generation) &&\n    getRemoteSyncGeneration(state) === generation.remoteSyncGeneration\n  );\n}\n\nexport function didDocumentStoreRemoteSyncRequestComplete(\n  state: DocumentStoreState,\n  generation: DocumentStoreRemoteSyncRequestGeneration,\n  requestedSignalSequence: number,\n): boolean {\n  return (\n    isDocumentStoreRemoteSyncRequestGenerationCurrent(state, generation) &&\n    state.remoteUpdateCompletedSignalSeq >= requestedSignalSequence\n  );\n}\n\nexport function isDocumentStoreSyncGenerationCurrent(\n  state: DocumentStoreState,\n  generation: DocumentStoreSyncGeneration,\n): boolean {\n  return (\n    state.doc === generation.currentDoc &&\n    isDocumentStoreGenerationIdentityCurrent(state, generation) &&\n    (!(\"remoteSyncGeneration\" in generation) ||\n      getRemoteSyncGeneration(state) === generation.remoteSyncGeneration)\n  );\n}\n\nexport function isDocumentStoreSyncLaneGenerationCurrent(\n  state: DocumentStoreState,\n  generation: DocumentStoreSyncLaneGeneration,\n): boolean {\n  return (\n    (syncLaneGenerations.get(state) ?? 0) === generation.syncLaneGeneration &&\n    !generation.syncLaneIsDisposed?.()\n  );\n}\n\nexport function isDocumentStoreGenerationIdentityCurrent(\n  state: DocumentStoreState,\n  generation: DocumentStoreGenerationIdentity,\n): boolean {\n  return (\n    state.runtime.apiClient === generation.apiClient &&\n    state.runtime.infra.blobStore === generation.blobStore &&\n    state.runtime.state.containerId === generation.containerId &&\n    state.runtime.infra.documentProjectors === generation.documentProjectors &&\n    state.runtime.state.domainScope === generation.domainScope &&\n    state.runtime.infra.execSql === generation.execSql &&\n    state.localWriteGeneration === generation.localWriteGeneration &&\n    state.runtime.auth?.organizationId === generation.organizationId &&\n    state.runtime.state.peerScope === generation.peerScope &&\n    state.persistence === generation.persistence &&\n    state.resolveProjectionUserKey === generation.resolveProjectionUserKey &&\n    (!hasDocumentStoreSyncLaneIdentity(generation) ||\n      isDocumentStoreSyncLaneGenerationCurrent(state, generation))\n  );\n}\n"]}

package/stores/documents/documentStore/{syncOutgoingCoverage.js → sync/syncOutgoingCoverage.js}

@@ -1,7 +1,7 @@
-import { encodeVersionVector, exportUpdatesSince, mergeVersionVectors, satisfiesVersionVector, } from "../../../internal/loro/index.js";
-import { chainIdentityWrite } from "./identityWriteChain.js";
-import { rebaseDocumentAfterPendingUpdateRefusal } from "./pendingUpdateRefusal.js";
-import { enqueuePendingUpdate, listPendingUpdates, persistDocument, } from "./persistence.js";
+import { encodeVersionVector, exportUpdatesSince, mergeVersionVectors, satisfiesVersionVector, } from "../../../../internal/loro/index.js";
+import { chainIdentityWrite } from "../identityWriteChain.js";
+import { rebaseDocumentAfterPendingUpdateRefusal } from "../pendingUpdateRefusal.js";
+import { enqueuePendingUpdate, listPendingUpdates, persistDocument, } from "../persistence.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 import { extendDocumentVersionCoverage } from "./versionCoverage.js";
 /**

package/stores/documents/documentStore/sync/syncOutgoingCoverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncOutgoingCoverage.js","sourceRoot":"","sources":["syncOutgoingCoverage.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  encodeVersionVector,\n  exportUpdatesSince,\n  mergeVersionVectors,\n  satisfiesVersionVector,\n} from \"@tearleads/loro\";\nimport type {\n  DocumentRecord,\n  PendingUpdateRecord,\n} from \"../../../../workflows/documents\";\nimport { chainIdentityWrite } from \"../identityWriteChain\";\nimport { rebaseDocumentAfterPendingUpdateRefusal } from \"../pendingUpdateRefusal\";\nimport {\n  enqueuePendingUpdate,\n  listPendingUpdates,\n  persistDocument,\n} from \"../persistence\";\nimport type { DocumentState, DocumentStoreState } from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { extendDocumentVersionCoverage } from \"./versionCoverage\";\n\ninterface PreparedOutgoingCoverage {\n  readonly pendingUpdates: PendingUpdateRecord[];\n  readonly record: DocumentRecord;\n}\n\n/**\n * Rebuild the durable outgoing frontier before a sync can clean-skip or delete\n * accepted queue rows. Existing rows promote the marker only through connected\n * spans. Any remaining snapshot tail is exported and enqueued before the marker\n * advances, so a restart at every await remains lossless.\n */\nexport async function prepareDocumentOutgoingCoverage(input: {\n  /** A separately verified frontier used only to prove outgoing coverage. */\n  readonly coverageBaseVersion?: string | undefined;\n  readonly currentDoc: DocumentState;\n  readonly generation: DocumentStoreSyncGeneration;\n  readonly pendingUpdates: PendingUpdateRecord[];\n  readonly state: DocumentStoreState;\n}): Promise<PreparedOutgoingCoverage | null> {\n  const { currentDoc, generation, state } = input;\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return null;\n\n  const baseVersion = input.coverageBaseVersion ?? state.pendingBaseVersion;\n  if (baseVersion === null) {\n    throw new Error(\"Document sync requires an initialized pending base\");\n  }\n\n  const documentVersion = encodeVersionVector(currentDoc);\n  const queuedCoverage = extendDocumentVersionCoverage({\n    baseVersion,\n    documentVersion,\n    spans: input.pendingUpdates,\n  });\n  let pendingUpdates = input.pendingUpdates;\n  let preparedCoverage = queuedCoverage;\n\n  if (!satisfiesVersionVector(queuedCoverage, documentVersion)) {\n    const deferredUpdate = exportUpdatesSince(currentDoc, queuedCoverage);\n    const enqueued = await enqueuePendingUpdate(\n      state,\n      deferredUpdate,\n      undefined,\n      generation,\n    );\n    if (!enqueued) {\n      await rebaseDocumentAfterPendingUpdateRefusal(state, generation);\n      return null;\n    }\n    if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return null;\n\n    pendingUpdates = await listPendingUpdates(state);\n    if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return null;\n\n    preparedCoverage = documentVersion;\n    state.runtime.util.log(\n      \"Documents: materialized a deferred outgoing update before sync.\",\n    );\n  }\n\n  // A local write may have advanced the in-memory frontier while the enqueue\n  // awaited. Merge instead of assigning so this background repair can never\n  // move the marker backwards.\n  const liveBaseVersion = state.pendingBaseVersion;\n  if (liveBaseVersion === null) {\n    throw new Error(\"Document sync lost its pending base\");\n  }\n  const nextBaseVersion = mergeVersionVectors([\n    liveBaseVersion,\n    preparedCoverage,\n  ]);\n\n  const liveRecord = state.record;\n  if (!liveRecord) {\n    throw new Error(\"Document sync lost its persisted record\");\n  }\n  if (liveRecord.pendingBaseVersion === nextBaseVersion) {\n    state.pendingBaseVersion = nextBaseVersion;\n    return { pendingUpdates, record: liveRecord };\n  }\n\n  const persisted = await chainIdentityWrite(state, async () => {\n    if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return null;\n\n    return persistDocument(\n      state,\n      currentDoc,\n      {\n        // Every op in nextBaseVersion is durably enqueued — the marker's\n        // definition, plus the deferred delta enqueued above — so the\n        // frontier advances with the marker. Left behind, the settled\n        // document would stay listed (and primed) as a deferred tail\n        // forever.\n        snapshotEndVersion: mergeVersionVectors([\n          ...(liveRecord.snapshotEndVersion.length > 0\n            ? [liveRecord.snapshotEndVersion]\n            : []),\n          nextBaseVersion,\n        ]),\n      },\n      {\n        pendingBaseVersionOverride: nextBaseVersion,\n        preserveSnapshotStructuredFields: true,\n        preserveSnapshotText: true,\n      },\n      generation,\n    );\n  });\n  if (!persisted || !isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    return null;\n  }\n\n  const currentBaseVersion = state.pendingBaseVersion;\n  if (currentBaseVersion === null) return null;\n  state.pendingBaseVersion = mergeVersionVectors([\n    currentBaseVersion,\n    nextBaseVersion,\n  ]);\n  return { pendingUpdates, record: persisted.record };\n}\n"]}

package/stores/documents/documentStore/{syncRemoteSignals.js → sync/syncRemoteSignals.js}

@@ -1,8 +1,8 @@
-import { isContainerProjectionInvalidationHint, isDocumentUpdateCreatedEvent, } from "../../../data/documents/documentSync.js";
-import { sequenceUnchanged } from "../../../workflows/documents/sync/syncLane.js";
-import { resumeAfterAncestorRepairHint } from "./ancestorRepairPark.js";
+import { isContainerProjectionInvalidationHint, isDocumentUpdateCreatedEvent, } from "../../../../data/documents/documentSync.js";
+import { sequenceUnchanged } from "../../../../workflows/documents/sync/syncLane.js";
+import { resumeAfterAncestorRepairHint } from "../ancestorRepairPark.js";
+import { invalidateDocumentWriterProjection } from "../writerProjectionGeneration.js";
 import { allowDocumentStoreRemoteSync, markDocumentStoreRemoteSyncPending, } from "./syncGeneration.js";
-import { invalidateDocumentWriterProjection } from "./writerProjectionGeneration.js";
 export function hasRemoteDocumentUpdateEvent(state, events) {
     let remoteUpdateFound = false;
     for (const event of events) {

package/stores/documents/documentStore/sync/syncRemoteSignals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncRemoteSignals.js","sourceRoot":"","sources":["syncRemoteSignals.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,4BAA4B,GAC7B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EACL,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAE1B,MAAM,UAAU,4BAA4B,CAC1C,KAAyB,EACzB,MAA8B;IAE9B,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,CAAC,4BAA4B,CAAC,KAAK,CAAC;YACpC,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,MAAM,EAAE,UAAU,EAC7C,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClD,iBAAiB,GAAG,IAAI,CAAC;oBACzB,SAAS;gBACX,CAAC;gBAED,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClD,CAAC;YACD,SAAS;QACX,CAAC;QAED,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,iBAAiB,CAAC;AAErE,MAAM,UAAU,+BAA+B,CAC7C,KAAyB,EACzB,sBAA8B;IAE9B,0EAA0E;IAC1E,4EAA4E;IAC5E,IACE,mCAAmC,CACjC,KAAK,CAAC,qBAAqB,EAC3B,sBAAsB,CACvB,EACD,CAAC;QACD,KAAK,CAAC,8BAA8B,GAAG,sBAAsB,CAAC;QAC9D,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAyB,EACzB,YAAwB;IAExB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1E,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAEzD,yEAAyE;IACzE,2EAA2E;IAC3E,4EAA4E;IAC5E,uEAAuE;IACvE,2EAA2E;IAC3E,MAAM,qBAAqB,GAAG,UAAU,CAAC,IAAI,CAC3C,qCAAqC,CACtC,CAAC;IACF,IAAI,qBAAqB;QAAE,kCAAkC,CAAC,KAAK,CAAC,CAAC;IAErE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU;QAAE,OAAO;IAEtC,4EAA4E;IAC5E,4EAA4E;IAC5E,0EAA0E;IAC1E,IAAI,qBAAqB,IAAI,6BAA6B,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,IAAI,4BAA4B,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QACpD,4BAA4B,CAAC,KAAK,CAAC,CAAC;QACpC,oEAAoE;QACpE,uCAAuC;QACvC,kCAAkC,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACzD,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC","sourcesContent":["import {\n  isContainerProjectionInvalidationHint,\n  isDocumentUpdateCreatedEvent,\n} from \"../../../../data/documents/documentSync\";\nimport { sequenceUnchanged } from \"../../../../workflows/documents/sync/syncLane\";\nimport { resumeAfterAncestorRepairHint } from \"../ancestorRepairPark\";\nimport type { DocumentStoreState } from \"../state\";\nimport { invalidateDocumentWriterProjection } from \"../writerProjectionGeneration\";\nimport {\n  allowDocumentStoreRemoteSync,\n  markDocumentStoreRemoteSyncPending,\n} from \"./syncGeneration\";\n\nexport function hasRemoteDocumentUpdateEvent(\n  state: DocumentStoreState,\n  events: ReadonlyArray<unknown>,\n): boolean {\n  let remoteUpdateFound = false;\n\n  for (const event of events) {\n    if (\n      !isDocumentUpdateCreatedEvent(event) ||\n      event.documentId !== state.record?.documentId\n    ) {\n      continue;\n    }\n\n    if (event.updateIds && event.updateIds.length > 0) {\n      for (const updateId of event.updateIds) {\n        if (!state.locallyAcceptedUpdateIds.has(updateId)) {\n          remoteUpdateFound = true;\n          continue;\n        }\n\n        state.locallyAcceptedUpdateIds.delete(updateId);\n      }\n      continue;\n    }\n\n    remoteUpdateFound = true;\n  }\n\n  return remoteUpdateFound;\n}\n\n/** Clear the remote-update signal only when its consumed sequence is unchanged.\n * A moved sequence means a newer remote event arrived mid-pass and must survive\n * for the coalesced re-run to avoid the convergence-stall race.\n */\nexport const canClearRemoteUpdateSignalAfterSync = sequenceUnchanged;\n\nexport function clearConsumedRemoteUpdateSignal(\n  state: DocumentStoreState,\n  consumedSignalSequence: number,\n): void {\n  // A peer event can arrive while the HTTP request is in flight. Clear only\n  // the sequence this pass consumed so the newer event survives for a re-run.\n  if (\n    canClearRemoteUpdateSignalAfterSync(\n      state.remoteUpdateSignalSeq,\n      consumedSignalSequence,\n    )\n  ) {\n    state.remoteUpdateCompletedSignalSeq = consumedSignalSequence;\n    state.remoteUpdatePending = false;\n  }\n}\n\nexport function handleDocumentRemoteEvents(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n): void {\n  const nextEvents = state.runtime.state.events.slice(state.lastEventCount);\n  state.lastEventCount = state.runtime.state.events.length;\n\n  // A container the document's path cites may have moved its manifest; the\n  // store cannot tell which containers this document links into, so the held\n  // projection goes and the next mutation fetches a fresh one. This runs even\n  // before the document has a remote id: a create in flight captured the\n  // generation when it started and must not install its pre-hint projection.\n  const projectionInvalidated = nextEvents.some(\n    isContainerProjectionInvalidationHint,\n  );\n  if (projectionInvalidated) invalidateDocumentWriterProjection(state);\n\n  if (!state.record?.documentId) return;\n\n  // Writes parked behind an ancestor another member must re-key: this hint is\n  // the only signal that the repair may have landed. It names no ancestor, so\n  // any one re-runs the pass, which parks again if the path is still stale.\n  if (projectionInvalidated && resumeAfterAncestorRepairHint(state)) {\n    scheduleSync();\n  }\n\n  if (hasRemoteDocumentUpdateEvent(state, nextEvents)) {\n    allowDocumentStoreRemoteSync(state);\n    // Let an in-flight pass distinguish this new signal from the one it\n    // consumed before its network request.\n    markDocumentStoreRemoteSyncPending(state, \"independent\");\n    scheduleSync();\n  }\n}\n"]}

package/stores/documents/documentStore/{syncRequest.js → sync/syncRequest.js}

@@ -1,12 +1,12 @@
-import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../internal/loro/index.js";
-import { createDocumentWriterPublicKeyResolver, deletePersistedDocument, resolveDocumentCreateAuthor, syncRemoteDocument, validateDocumentSyncUpdateImports, } from "../../../workflows/documents/index.js";
-import { createRuntimePrincipalPolicyWarmer } from "../../../workflows/principals/runtimePolicyWarmer.js";
-import { requestDocumentStoreSync } from "../registry.js";
-import { parkForAncestorRepair } from "./ancestorRepairPark.js";
-import { chainIdentityWrite } from "./identityWriteChain.js";
-import { runDocumentOrphanMaintenance } from "./orphanMaintenance.js";
+import { encodeVersionVector, exportFullHistorySnapshot, } from "../../../../internal/loro/index.js";
+import { createDocumentWriterPublicKeyResolver, deletePersistedDocument, resolveDocumentCreateAuthor, syncRemoteDocument, validateDocumentSyncUpdateImports, } from "../../../../workflows/documents/index.js";
+import { createRuntimePrincipalPolicyWarmer } from "../../../../workflows/principals/runtimePolicyWarmer.js";
+import { requestDocumentStoreSync } from "../../registry.js";
+import { parkForAncestorRepair } from "../ancestorRepairPark.js";
+import { chainIdentityWrite } from "../identityWriteChain.js";
+import { runDocumentOrphanMaintenance } from "../orphanMaintenance.js";
+import { markDocumentStoreRemoved, } from "../state.js";
 import { invalidateDocumentStorePullContinuation } from "./pullContinuationInvalidation.js";
-import { markDocumentStoreRemoved, } from "./state.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 import { documentIncomingUpdateIsolationFailureHandler, documentRevalidationFailureHandler, documentTerminalSubmitFailureHandler, } from "./syncShared.js";
 import { documentSyncContextMatches } from "./syncUpdateImport.js";

package/stores/documents/documentStore/sync/syncRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncRequest.js","sourceRoot":"","sources":["syncRequest.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  encodeVersionVector,\n  exportFullHistorySnapshot,\n} from \"@tearleads/loro\";\nimport {\n  createDocumentWriterPublicKeyResolver,\n  type DocumentRecord,\n  deletePersistedDocument,\n  type ExecSql,\n  type PendingUpdateRecord,\n  resolveDocumentCreateAuthor,\n  syncRemoteDocument,\n  validateDocumentSyncUpdateImports,\n} from \"../../../../workflows/documents\";\nimport { createRuntimePrincipalPolicyWarmer } from \"../../../../workflows/principals/runtimePolicyWarmer\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport { parkForAncestorRepair } from \"../ancestorRepairPark\";\nimport { chainIdentityWrite } from \"../identityWriteChain\";\nimport { runDocumentOrphanMaintenance } from \"../orphanMaintenance\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  type DocumentSyncAttempt,\n  type EncapsulationKeyPair,\n  markDocumentStoreRemoved,\n} from \"../state\";\nimport { invalidateDocumentStorePullContinuation } from \"./pullContinuationInvalidation\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport {\n  documentIncomingUpdateIsolationFailureHandler,\n  documentRevalidationFailureHandler,\n  documentTerminalSubmitFailureHandler,\n} from \"./syncShared\";\nimport { documentSyncContextMatches } from \"./syncUpdateImport\";\n\n/**\n * Destroying queued local edits here is settled policy, not an oversight\n * (docs/sync-edge-cases.md row 1): deletion is a privacy operation, so an\n * authoritative remote delete removes the document and its unsynced edits\n * everywhere with no preservation copy. Quarantine/export were rejected —\n * they retain or re-upload content the user deliberately destroyed.\n */\nexport async function deleteUpstreamDeletedDocument(\n  state: DocumentStoreState,\n  generation: DocumentStoreSyncGeneration,\n  requestRecord: DocumentRecord,\n  remoteDocumentId: string,\n  commitPurgeProof?: (transactionExecSql: ExecSql) => Promise<void>,\n) {\n  await chainIdentityWrite(state, async () => {\n    if (\n      !isDocumentStoreSyncGenerationCurrent(state, generation) ||\n      !documentSyncContextMatches(state.record, requestRecord, remoteDocumentId)\n    ) {\n      return;\n    }\n\n    const canDeleteCapturedDocument = () =>\n      isDocumentStoreSyncGenerationCurrent(state, generation) &&\n      documentSyncContextMatches(state.record, requestRecord, remoteDocumentId);\n    let removedInMutation = false;\n    const deletionStarted = await deletePersistedDocument({\n      beforeDeleteInTransaction: commitPurgeProof,\n      canStartDurableMutation: canDeleteCapturedDocument,\n      documentProjectors: state.runtime.infra.documentProjectors,\n      execSql: generation.execSql,\n      expectedRecord: requestRecord,\n      localId: requestRecord.id,\n      // Invalidate the store generation INSIDE the deletion mutation: a\n      // terminal failure handler queued behind it then observes the stale\n      // generation and cannot resurrect a failure row the deletes removed.\n      onDeletedInMutation: () => {\n        if (canDeleteCapturedDocument()) {\n          markDocumentStoreRemoved(state);\n          removedInMutation = true;\n        }\n      },\n      persistence: state.persistence,\n    });\n    if (!deletionStarted || !removedInMutation) {\n      return;\n    }\n    void runDocumentOrphanMaintenance(state);\n    state.runtime.util.log(\n      `Documents: removed local document ${state.localId} after remote deletion.`,\n    );\n  });\n}\n\nfunction createDocumentSyncAttempt(input: {\n  currentRecord: DocumentRecord;\n  outgoingUpdateCount: number;\n  requestedPullContinuation: DocumentStoreState[\"pullContinuation\"];\n  synced: DocumentSyncAttempt[\"synced\"];\n  writerProjectionGeneration: number;\n}): DocumentSyncAttempt {\n  return {\n    consumedPullContinuation:\n      input.synced.plan.request.pullCursor === undefined\n        ? null\n        : input.requestedPullContinuation,\n    outgoingUpdateCount: input.outgoingUpdateCount,\n    requestRecord: input.currentRecord,\n    synced: input.synced,\n    writerProjectionGeneration: input.writerProjectionGeneration,\n  };\n}\n\ninterface RequestRemoteDocumentSyncInput {\n  allowRecoveryBaseline?: boolean | undefined;\n  currentDoc: DocumentState;\n  currentRecord: DocumentRecord;\n  encapsulationKeyPair: EncapsulationKeyPair;\n  generation: DocumentStoreSyncGeneration;\n  onOutgoingUpdatesMaterialized?:\n    | ((updateIds: readonly string[]) => void)\n    | undefined;\n  pendingUpdates: PendingUpdateRecord[];\n  queuedUpdateCount?: number | undefined;\n  state: DocumentStoreState;\n  unavailableWriterLogMessage: string;\n}\n\nfunction runRemoteDocumentSync(\n  input: RequestRemoteDocumentSyncInput,\n  author: NonNullable<ReturnType<typeof resolveDocumentCreateAuthor>>,\n  documentId: string,\n  requestedPullContinuation: DocumentStoreState[\"pullContinuation\"],\n) {\n  const { currentDoc, currentRecord, generation, pendingUpdates, state } =\n    input;\n  const runtime = state.runtime;\n  const writerProjectionGenerationAtStart = state.writerProjectionGeneration;\n  state.awaitingAncestorRepair = false;\n  return syncRemoteDocument({\n    apiClient: runtime.apiClient,\n    author,\n    // Heal a stale content-key bundle from this full-history snapshot. Rotation\n    // settlement disables this: it may submit only the ordinary local stream.\n    ...(input.allowRecoveryBaseline === false\n      ? {}\n      : {\n          buildRotationSnapshot: async () =>\n            exportFullHistorySnapshot(currentDoc),\n        }),\n    documentId,\n    execSql: runtime.infra.execSql,\n    isRemoteSyncBlocked: runtime.util.isRemoteSyncBlocked,\n    localVersionVector: encodeVersionVector(currentDoc),\n    minLsn: currentRecord.lastCommitLsn ?? undefined,\n    onRemoteDocumentDeleted: ({ commitPurgeProof, documentId }) =>\n      deleteUpstreamDeletedDocument(\n        state,\n        generation,\n        currentRecord,\n        documentId,\n        commitPurgeProof,\n      ),\n    onSyncAbandoned: (reason) => {\n      if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return;\n      const hintLandedMidPass = parkForAncestorRepair(\n        state,\n        reason,\n        writerProjectionGenerationAtStart,\n      );\n      if (hintLandedMidPass) requestDocumentStoreSync(state);\n    },\n    onSyncTrace: (line) => runtime.util.log(`Documents: ${line}`),\n    onReadOnlyProjectionFailure: documentRevalidationFailureHandler(\n      state,\n      generation,\n    ),\n    onIncomingUpdateIsolationFailure:\n      documentIncomingUpdateIsolationFailureHandler(state, generation),\n    onOutgoingUpdatesMaterialized: input.onOutgoingUpdatesMaterialized,\n    onPullContinuationInvalidated: (continuation) =>\n      invalidateDocumentStorePullContinuation({\n        continuation,\n        currentRecord,\n        generation,\n        state,\n      }),\n    onTerminalSubmitFailure: documentTerminalSubmitFailureHandler(\n      state,\n      generation,\n    ),\n    pendingUpdates,\n    persistedState: currentRecord,\n    pullContinuation: requestedPullContinuation ?? undefined,\n    rekeyPendingUpdate: state.persistence.rekeyPendingUpdate,\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n    resolveWriterPublicKey: createDocumentWriterPublicKeyResolver({\n      logPrefix: \"Documents\",\n      runtime,\n      writerKeyLabel: \"writer key\",\n    }),\n    stillCurrent: () => isDocumentStoreSyncGenerationCurrent(state, generation),\n    targetSecretKey: input.encapsulationKeyPair.secretKey,\n    validateIncomingUpdates: (result) =>\n      validateDocumentSyncUpdateImports({\n        currentDocument: currentDoc,\n        decryptedUpdates: result.decryptedUpdates,\n        responseUpdates: result.response.updates,\n      }),\n    warmReferencedPrincipalPolicies:\n      createRuntimePrincipalPolicyWarmer(runtime),\n    writerProjection:\n      state.writerProjection?.documentId === currentRecord.documentId\n        ? state.writerProjection\n        : undefined,\n  });\n}\n\nexport async function requestRemoteDocumentSync(\n  input: RequestRemoteDocumentSyncInput,\n): Promise<DocumentSyncAttempt | null> {\n  const {\n    currentRecord,\n    generation,\n    pendingUpdates,\n    state,\n    unavailableWriterLogMessage,\n  } = input;\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return null;\n  // Captured before the network round trip: a hint that lands meanwhile\n  // must keep the response's projection out of the cache.\n  const writerProjectionGeneration = state.writerProjectionGeneration;\n\n  const runtime = state.runtime;\n  if (!currentRecord.documentId) return null;\n\n  const requestedPullContinuation = state.pullContinuation;\n\n  const author = resolveDocumentCreateAuthor(runtime);\n  if (!author) {\n    runtime.util.log(unavailableWriterLogMessage);\n    return null;\n  }\n\n  const synced = await runRemoteDocumentSync(\n    input,\n    author,\n    currentRecord.documentId,\n    requestedPullContinuation,\n  );\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) return null;\n  if (!synced) return null;\n\n  const outgoingUpdateCount = input.queuedUpdateCount ?? pendingUpdates.length;\n  return createDocumentSyncAttempt({\n    currentRecord,\n    outgoingUpdateCount,\n    requestedPullContinuation,\n    synced,\n    writerProjectionGeneration,\n  });\n}\n"]}

package/stores/documents/documentStore/{syncShared.js → sync/syncShared.js}

@@ -1,12 +1,12 @@
-import { deriveStableDocumentId } from "../../../data/documents/shared/stableDocumentId.js";
-import { createRemoteDocument, DOCUMENTS_APP_KIND, describeDocumentRevalidationFailure, describeDocumentSyncSubmitFailure, recordDocumentSyncFailure, resolveDocumentCreateAuthor, runSerializedSqlMutation, } from "../../../workflows/documents/index.js";
-import { reportDocumentSyncQuarantine } from "../../../workflows/documents/sync/reportDocumentSyncQuarantine.js";
-import { createRuntimePrincipalPolicyWarmer } from "../../../workflows/principals/runtimePolicyWarmer.js";
-import { chainIdentityWrite } from "./identityWriteChain.js";
-import { persistDocument } from "./persistence.js";
-import { markDocumentStoreRemoved, } from "./state.js";
+import { deriveStableDocumentId } from "../../../../data/documents/shared/stableDocumentId.js";
+import { createRemoteDocument, DOCUMENTS_APP_KIND, describeDocumentRevalidationFailure, describeDocumentSyncSubmitFailure, recordDocumentSyncFailure, resolveDocumentCreateAuthor, runSerializedSqlMutation, } from "../../../../workflows/documents/index.js";
+import { reportDocumentSyncQuarantine } from "../../../../workflows/documents/sync/reportDocumentSyncQuarantine.js";
+import { createRuntimePrincipalPolicyWarmer } from "../../../../workflows/principals/runtimePolicyWarmer.js";
+import { chainIdentityWrite } from "../identityWriteChain.js";
+import { persistDocument } from "../persistence.js";
+import { markDocumentStoreRemoved, } from "../state.js";
+import { installDocumentWriterProjection } from "../writerProjectionGeneration.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
-import { installDocumentWriterProjection } from "./writerProjectionGeneration.js";
 /**
  * Record a refused read-only revalidation on this document's failure row, so
  * a document that can never refresh stops failing silently (edge-case row

package/stores/documents/documentStore/sync/syncShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncShared.js","sourceRoot":"","sources":["syncShared.ts"],"names":[],"mappings":"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","sourcesContent":["import { deriveStableDocumentId } from \"../../../../data/documents/shared/stableDocumentId\";\nimport {\n  createRemoteDocument,\n  DOCUMENTS_APP_KIND,\n  type DocumentRecord,\n  type DocumentSyncUpdateIsolationError,\n  describeDocumentRevalidationFailure,\n  describeDocumentSyncSubmitFailure,\n  type PendingUpdateRecord,\n  recordDocumentSyncFailure,\n  resolveDocumentCreateAuthor,\n  runSerializedSqlMutation,\n} from \"../../../../workflows/documents\";\nimport { reportDocumentSyncQuarantine } from \"../../../../workflows/documents/sync/reportDocumentSyncQuarantine\";\nimport { createRuntimePrincipalPolicyWarmer } from \"../../../../workflows/principals/runtimePolicyWarmer\";\nimport { chainIdentityWrite } from \"../identityWriteChain\";\nimport { persistDocument } from \"../persistence\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  type EncapsulationKeyPair,\n  markDocumentStoreRemoved,\n} from \"../state\";\nimport { installDocumentWriterProjection } from \"../writerProjectionGeneration\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\n\n/**\n * Record a refused read-only revalidation on this document's failure row, so\n * a document that can never refresh stops failing silently (edge-case row\n * 13). 403s stay suppressed on purpose — a read-only 403 must never flag\n * unattempted local edits (row 9) — and the row clears on the next clean\n * pass like every other sync failure.\n */\nexport function documentRevalidationFailureHandler(\n  state: DocumentStoreState,\n  generation?: DocumentStoreSyncGeneration,\n) {\n  return documentSyncFailureHandler({\n    describeFailure: describeDocumentRevalidationFailure,\n    generation,\n    state,\n    suppressForbidden: true,\n  });\n}\n\n/**\n * Record a terminal submit failure on this document's write-queue row. Shared\n * by every store pass that can submit queued writes (create and sync), so\n * re-key exhaustion and denial failures surface no matter which pass hits\n * them first.\n */\nexport function documentTerminalSubmitFailureHandler(\n  state: DocumentStoreState,\n  generation?: DocumentStoreSyncGeneration,\n) {\n  return documentSyncFailureHandler({\n    describeFailure: describeDocumentSyncSubmitFailure,\n    generation,\n    state,\n  });\n}\n\n/** Persist quarantine and report its Error through the host's diagnostics. */\nexport function documentIncomingUpdateIsolationFailureHandler(\n  state: DocumentStoreState,\n  generation?: DocumentStoreSyncGeneration,\n) {\n  const recordFailure = documentSyncFailureHandler({\n    describeFailure: (failure) => failure.message,\n    generation,\n    state,\n  });\n  return async (failure: DocumentSyncUpdateIsolationError) => {\n    await recordFailure({ message: failure.message, status: null });\n    if (generation && !isDocumentStoreSyncGenerationCurrent(state, generation))\n      return;\n    reportDocumentSyncQuarantine(\n      generation?.currentDoc ?? state.doc ?? state,\n      state.runtime.util.logError,\n      failure,\n    );\n  };\n}\n\n/**\n * The generation recheck runs INSIDE the serialized mutation (like the\n * attachment failure path): a teardown (discard/reset) that wins the ordering\n * deletes this document's rows first and invalidates the generation, so a\n * stale handler can never resurrect a deleted or orphan failure row\n * afterwards.\n */\nfunction documentSyncFailureHandler(input: {\n  describeFailure: (failure: {\n    readonly message: string;\n    readonly status: number | null;\n  }) => string;\n  generation: DocumentStoreSyncGeneration | undefined;\n  state: DocumentStoreState;\n  suppressForbidden?: boolean;\n}) {\n  const { generation, state } = input;\n  return async (failure: {\n    readonly message: string;\n    readonly status: number | null;\n  }) => {\n    if (input.suppressForbidden && failure.status === 403) {\n      return;\n    }\n\n    await runSerializedSqlMutation(\n      generation?.execSql ?? state.runtime.infra.execSql,\n      async (lockedExecSql) => {\n        if (\n          generation &&\n          !isDocumentStoreSyncGenerationCurrent(state, generation)\n        ) {\n          return;\n        }\n        await recordDocumentSyncFailure(\n          lockedExecSql,\n          { appKind: DOCUMENTS_APP_KIND, localId: state.localId },\n          {\n            attemptedAt: new Date().toISOString(),\n            message: input.describeFailure(failure),\n            status: failure.status,\n          },\n        );\n      },\n    );\n  };\n}\n\nfunction hasPersistedRemoteDocumentSyncState(record: DocumentRecord): boolean {\n  return (\n    record.lastCommitLsn !== null &&\n    record.contentKeyBundle !== null &&\n    record.documentKekTargets !== null &&\n    record.documentManifestBundle !== null\n  );\n}\n\nexport function shouldSkipCleanScheduledDocumentSync(input: {\n  currentRecord: DocumentRecord;\n  pendingUpdates: readonly PendingUpdateRecord[];\n  state: DocumentStoreState;\n}): boolean {\n  return (\n    input.pendingUpdates.length === 0 &&\n    input.state.pendingAttachments.length === 0 &&\n    input.state.pullContinuation === null &&\n    !input.currentRecord.pullContinuationRecoveryRequired &&\n    !input.state.remoteUpdatePending &&\n    hasPersistedRemoteDocumentSyncState(input.currentRecord)\n  );\n}\n\n/**\n * True when the store's container exists locally but has not been created on\n * the server yet (its own create intent is still pending). Creating a document\n * inside it would 404 on the container writer projection and surface a\n * spurious sync error; the container-contents lane re-arms document sync once\n * the container lands. An unknown or unqueryable container resolves false so\n * store-level consumers without container persistence keep creating eagerly.\n */\nexport async function isContainerAwaitingRemoteCreate(\n  state: DocumentStoreState,\n): Promise<boolean> {\n  const containerId = state.runtime.state.containerId;\n  if (!containerId) {\n    return false;\n  }\n\n  try {\n    const rows = await state.runtime.infra.execSql(\n      \"SELECT server_created_at FROM containers WHERE id = :containerId\",\n      { \":containerId\": containerId },\n    );\n    const row = rows[0];\n    return row !== undefined && Reflect.get(row, \"server_created_at\") == null;\n  } catch {\n    return false;\n  }\n}\n\nasync function hasDurableDocumentForCreate(\n  state: DocumentStoreState,\n  isCurrent: () => boolean,\n): Promise<boolean> {\n  // A bulk import can leave this store queued long after trash purged its\n  // durable row. The persistence guard runs too late to prevent an orphaned\n  // remote create, so check existence before beginning the network work.\n  const record = await state.persistence.loadDocument(\n    state.runtime.infra.execSql,\n    state.localId,\n  );\n  if (!isCurrent()) return false;\n  if (record) return true;\n  markDocumentStoreRemoved(state);\n  return false;\n}\n\nexport async function ensureRemoteDocument(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  nextRecord: DocumentRecord | null,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  generation?: DocumentStoreSyncGeneration,\n): Promise<DocumentRecord | null> {\n  const generationIsCurrent = () =>\n    !generation || isDocumentStoreSyncGenerationCurrent(state, generation);\n  if (!generationIsCurrent()) return state.record ?? nextRecord;\n\n  if (nextRecord?.documentId) {\n    return nextRecord;\n  }\n\n  const runtime = state.runtime;\n  if (!runtime.state.containerId) {\n    runtime.util.log(\n      \"Documents: cannot create a remote document without a container.\",\n    );\n    // A local-only document with no container scope (e.g. a last-link orphan\n    // from a tombstone cascade, docs/sync-edge-cases.md row 3) can never\n    // create; record the stuck state durably so the write queue surfaces it\n    // instead of this lane going silent on every trigger.\n    await documentTerminalSubmitFailureHandler(\n      state,\n      generation,\n    )({\n      message: \"Local document has no container for its remote create\",\n      status: null,\n    });\n    return nextRecord;\n  }\n\n  const author = resolveDocumentCreateAuthor(runtime);\n  if (!author) {\n    runtime.util.log(\n      \"Documents: skipped remote create because the writer context is unavailable.\",\n    );\n    return nextRecord;\n  }\n\n  const documentId =\n    nextRecord?.recoveryDocumentId ??\n    (await deriveStableDocumentId(state.localId));\n  if (!generationIsCurrent()) return state.record ?? nextRecord;\n\n  if (!(await hasDurableDocumentForCreate(state, generationIsCurrent)))\n    return state.record;\n\n  const writerProjectionGeneration = state.writerProjectionGeneration;\n  const created = await createRemoteDocument({\n    apiClient: runtime.apiClient,\n    author,\n    containerId: runtime.state.containerId,\n    // Derive the remote id from the stable local id so a retry after a lost\n    // create response re-sends the same id and adopts the existing remote\n    // document instead of creating a duplicate.\n    documentId,\n    execSql: runtime.infra.execSql,\n    isRemoteSyncBlocked: runtime.util.isRemoteSyncBlocked,\n    onTerminalSubmitFailure: documentTerminalSubmitFailureHandler(\n      state,\n      generation,\n    ),\n    resolveProjectionUserKey: state.resolveProjectionUserKey,\n    stillCurrent: generationIsCurrent,\n    targetSecretKey: encapsulationKeyPair.secretKey,\n    warmReferencedPrincipalPolicies:\n      createRuntimePrincipalPolicyWarmer(runtime),\n  });\n  if (!generationIsCurrent()) return state.record ?? nextRecord;\n  if (!created) {\n    return nextRecord;\n  }\n\n  return chainIdentityWrite(state, async () => {\n    if (!generationIsCurrent()) return state.record ?? nextRecord;\n\n    // A concurrent relink (e.g. live duplicate-facade resolution) may have\n    // assigned this store a different remote identity while the create round\n    // trip was in flight. That identity wins: persisting the created one here\n    // would clobber the relink. The just-created remote document is left an\n    // orphan, the same benign outcome as a lost create response.\n    const liveDocumentId = state.record?.documentId;\n    if (liveDocumentId && liveDocumentId !== created.documentId) {\n      return state.record;\n    }\n\n    runtime.util.log(`Created document: ${created.documentId}`);\n    installDocumentWriterProjection(\n      state,\n      created.writerProjection,\n      writerProjectionGeneration,\n    );\n\n    // This persist is a remote-identity write (documentId + content keys), not a\n    // content change. It runs after a network round trip, during which the user\n    // may have kept typing into a brand-new note. The Loro doc is mutated\n    // asynchronously on the write chain, so it can lag the optimistic snapshot;\n    // re-deriving text/structured fields from the doc here would republish that\n    // stale read over the live editor value and drop the just-typed characters\n    // (the new-note \"type immediately\" race). Preserve the optimistic snapshot —\n    // documentId/keys still propagate via state.record, independent of the\n    // snapshot text — matching finalizeDocumentSync and the keystroke writes.\n    const persistPatch = { ...created.persistedState };\n    const persistOptions = {\n      preserveSnapshotStructuredFields: true,\n      preserveSnapshotText: true,\n    };\n    const persisted = await persistDocument(\n      state,\n      currentDoc,\n      persistPatch,\n      persistOptions,\n      generation,\n    );\n    return persisted?.record ?? state.record ?? nextRecord;\n  });\n}\n"]}

package/stores/documents/documentStore/{syncUpdateImport.js → sync/syncUpdateImport.js}

@@ -1,6 +1,6 @@
-import { encodeVersionVector } from "../../../internal/loro/index.js";
-import { importDecryptedDocumentSyncUpdates } from "../../../data/documents/shared/documentSyncUpdateIsolation.js";
-import { setReadySnapshot, } from "./state.js";
+import { encodeVersionVector } from "../../../../internal/loro/index.js";
+import { importDecryptedDocumentSyncUpdates } from "../../../../data/documents/shared/documentSyncUpdateIsolation.js";
+import { setReadySnapshot, } from "../state.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
 import { extendDocumentVersionCoverage } from "./versionCoverage.js";
 function sameNullableValue(left, right) {

package/stores/documents/documentStore/sync/syncUpdateImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncUpdateImport.js","sourceRoot":"","sources":["syncUpdateImport.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport { importDecryptedDocumentSyncUpdates } from \"../../../../data/documents/shared/documentSyncUpdateIsolation\";\nimport type { DecryptedDocumentSyncUpdate } from \"../../../../data/documents/shared/types\";\nimport type { DocumentRecord } from \"../../../../workflows/documents\";\nimport type { DocumentSyncAttempt } from \"../state\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  setReadySnapshot,\n} from \"../state\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { extendDocumentVersionCoverage } from \"./versionCoverage\";\n\nfunction sameNullableValue(\n  left: string | null | undefined,\n  right: string | null | undefined,\n): boolean {\n  return (left ?? null) === (right ?? null);\n}\n\n/**\n * A response may mutate document content only while the identity and access\n * context used to create its request are still live. Local content fields and\n * the pending marker are deliberately excluded because edits may advance them\n * while the request is in flight.\n */\nexport function documentSyncContextMatches(\n  liveRecord: DocumentRecord | null,\n  requestRecord: DocumentRecord,\n  responseDocumentId: string | null,\n): boolean {\n  return (\n    liveRecord !== null &&\n    liveRecord.id === requestRecord.id &&\n    liveRecord.documentId === requestRecord.documentId &&\n    liveRecord.documentId === responseDocumentId &&\n    liveRecord.containerId === requestRecord.containerId &&\n    liveRecord.accessEpoch === requestRecord.accessEpoch &&\n    sameNullableValue(\n      liveRecord.accessStateHash,\n      requestRecord.accessStateHash,\n    ) &&\n    (liveRecord.effectiveAccessLevel ?? null) ===\n      (requestRecord.effectiveAccessLevel ?? null) &&\n    sameNullableValue(\n      liveRecord.contentKeyBundle,\n      requestRecord.contentKeyBundle,\n    ) &&\n    sameNullableValue(\n      liveRecord.documentKekTargets,\n      requestRecord.documentKekTargets,\n    ) &&\n    sameNullableValue(\n      liveRecord.documentManifestBundle,\n      requestRecord.documentManifestBundle,\n    )\n  );\n}\n\nexport function importSyncedDocumentUpdates(\n  currentDoc: DocumentState,\n  updates: readonly DecryptedDocumentSyncUpdate[],\n): DocumentState {\n  importDecryptedDocumentSyncUpdates(currentDoc, updates);\n  return currentDoc;\n}\n\nexport function applyIncomingSyncedUpdates(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  requestRecord: DocumentRecord,\n  syncAttempt: DocumentSyncAttempt,\n  expectedGeneration?: DocumentStoreSyncGeneration,\n): DocumentState {\n  if (\n    (expectedGeneration &&\n      !isDocumentStoreSyncGenerationCurrent(state, expectedGeneration)) ||\n    !documentSyncContextMatches(\n      state.record,\n      requestRecord,\n      syncAttempt.synced.plan.documentId,\n    )\n  ) {\n    return currentDoc;\n  }\n\n  const updates = syncAttempt.synced.decryptedUpdates;\n  if (updates.length === 0) return currentDoc;\n\n  const mergedDoc = importSyncedDocumentUpdates(currentDoc, updates);\n  const baseVersion = state.pendingBaseVersion;\n  if (baseVersion === null) {\n    throw new Error(\"Document sync requires an initialized pending base\");\n  }\n  // Promote only through update spans proven to be remote. Advancing to the\n  // whole merged document would also cross a concurrent deferRemoteSync edit\n  // and could permanently classify that local-only operation as synced.\n  state.pendingBaseVersion = extendDocumentVersionCoverage({\n    baseVersion,\n    documentVersion: encodeVersionVector(mergedDoc),\n    spans: updates,\n  });\n\n  if (state.pendingLocalWrites > 0) {\n    setReadySnapshot(\n      state,\n      mergedDoc,\n      true,\n      state.snapshot.text,\n      state.snapshot.structuredFields,\n    );\n    return mergedDoc;\n  }\n\n  setReadySnapshot(state, mergedDoc, true);\n  return mergedDoc;\n}\n"]}

package/stores/documents/documentStore/{versionCoverage.js → sync/versionCoverage.js}

@@ -1,4 +1,4 @@
-import { mergeVersionVectors, satisfiesVersionVector } from "../../../internal/loro/index.js";
+import { mergeVersionVectors, satisfiesVersionVector } from "../../../../internal/loro/index.js";
 /**
  * Extend a trusted coverage frontier through durable or remotely accepted
  * update spans. A span is usable only when its start is already covered and

package/stores/documents/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./documentStore.js";
+export * from "./documentStore/index.js";
 export * from "./types.js";

package/stores/documents/index.js

@@ -1,3 +1,3 @@
-export * from "./documentStore.js";
+export * from "./documentStore/index.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/stores/local-projection/localProjectionStore.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentSummary } from "../../data/documents/documentSummary.js";
-import type { ContainerContentsStoreRuntime } from "../container-contents/syncAgent.js";
+import type { ContainerContentsStoreRuntime } from "../container-contents/syncAgent/index.js";
 import type { ContainerContentsStore } from "../container-contents/types.js";
 import type { LocalProjectionReconciledDelta, LocalProjectionSnapshot } from "./types.js";
 /**

package/stores/local-projection/localProjectionStore.js

@@ -1,6 +1,6 @@
 import { loadLocalContainerProjectionDocumentsFromRuntime } from "../../workflows/container-contents/projectionView.js";
 import { didRegainSyncPrerequisites } from "../../workflows/container-contents/syncLane.js";
-import { isReconcilableContainerNode, isRemoteBackedContainerNode, } from "../container-contents/reconcilableContainer.js";
+import { isReconcilableContainerNode, isRemoteBackedContainerNode, } from "../container-contents/containerState/reconcilableContainer.js";
 import { applyContainerSummaries, createSummaryCache, removeDocumentSummary, resetSummaryCache, snapshotLinkedContainerIdsByDocumentId, snapshotSummariesByContainerId, } from "./summaryCache.js";
 const EMPTY_SNAPSHOT = {
     ready: false,