@tearleads/client-sdk 0.1.69 → 0.1.71

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { reportAndRethrowKeyingVerificationError } from \"../../../../data/keyingProjectionVerification/error\";\nimport {\n  type DocumentRecord,\n  type DocumentSyncLane,\n  isDatabaseUnavailableError,\n  type PendingUpdateRecord,\n  registerDocumentSyncLane,\n  resolveDocumentCreateAuthor,\n} from \"../../../../workflows/documents\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport { awaitInitializationForSync } from \"../initialization\";\nimport { listPendingUpdates } from \"../persistence\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  type DocumentSyncAttempt,\n  type EncapsulationKeyPair,\n  setDocumentSyncing,\n} from \"../state\";\nimport { logRevalidationUnavailable as logUnavailable } from \"./remoteRevalidationTelemetry\";\nimport {\n  getActiveDocumentRemoteWork,\n  runDocumentRemoteWork,\n} from \"./remoteWork\";\nimport {\n  cleanupPreRegisteredUpdateIdsOnFailure,\n  discardPreRegisteredUpdateIds,\n  preRegisterMaterializedDocumentSyncUpdateIds,\n} from \"./syncAcceptedUpdateIds\";\nimport { syncPendingAttachments } from \"./syncAttachments\";\nimport { syncDetachedAttachmentBindings } from \"./syncDetachedAttachments\";\nimport { finalizeDocumentSync } from \"./syncFinalize\";\nimport {\n  captureDocumentStoreAttachmentSyncGeneration,\n  captureDocumentStoreRemoteSyncGeneration,\n  captureDocumentStoreSyncGeneration,\n  type DocumentStoreSyncGeneration,\n  type DocumentStoreSyncLaneGeneration,\n  isDocumentStoreRemoteSyncBlocked,\n  isDocumentStoreSyncGenerationCurrent,\n  isDocumentStoreSyncLaneGenerationCurrent,\n} from \"./syncGeneration\";\nimport { prepareDocumentOutgoingCoverage } from \"./syncOutgoingCoverage\";\nimport { requestRemoteDocumentSync } from \"./syncRequest\";\nimport {\n  ensureRemoteDocument,\n  isContainerAwaitingRemoteCreate,\n  shouldSkipCleanScheduledDocumentSync,\n} from \"./syncShared\";\n\nfunction canRunScheduledSync(state: DocumentStoreState): boolean {\n  return (\n    // A deferred birth waits for its attach to carry it (see\n    // deferredInitialUpdate.ts); a pass now would ship it on its own.\n    state.deferInitialUpdate !== true &&\n    state.doc !== null &&\n    state.snapshot.ready &&\n    state.runtime.state.online &&\n    state.runtime.auth.isAuthenticated &&\n    state.runtime.crypto.encapsulationKeyPair !== null &&\n    resolveDocumentCreateAuthor(state.runtime) !== null\n  );\n}\n\nasync function requestOutgoingDocumentBatch(input: {\n  readonly currentDoc: DocumentState;\n  readonly encapsulationKeyPair: EncapsulationKeyPair;\n  readonly generation: DocumentStoreSyncGeneration;\n  readonly pendingUpdates: PendingUpdateRecord[];\n  readonly record: DocumentRecord;\n  readonly state: DocumentStoreState;\n}): Promise<{\n  sentUpdateIds: string[];\n  syncAttempt: DocumentSyncAttempt | null;\n}> {\n  const { planningUpdates, queuedUpdateCount } = prepareDocumentStoreSyncQueue(\n    input.pendingUpdates,\n  );\n  const sentUpdateIds: string[] = [];\n  const syncAttempt = await cleanupPreRegisteredUpdateIdsOnFailure(\n    input.state,\n    sentUpdateIds,\n    () =>\n      requestRemoteDocumentSync({\n        currentDoc: input.currentDoc,\n        currentRecord: input.record,\n        encapsulationKeyPair: input.encapsulationKeyPair,\n        generation: input.generation,\n        onOutgoingUpdatesMaterialized: (updateIds) =>\n          preRegisterMaterializedDocumentSyncUpdateIds(\n            input.state,\n            sentUpdateIds,\n            updateIds,\n          ),\n        pendingUpdates: planningUpdates,\n        queuedUpdateCount,\n        state: input.state,\n        unavailableWriterLogMessage:\n          \"Documents: skipped sync because the writer context is unavailable.\",\n      }),\n  );\n  return { sentUpdateIds, syncAttempt };\n}\n\n/**\n * Keep the full durable queue visible to stale-heal/checkpoint classification.\n * The workflow planner owns the final count and byte bounds, and the exact\n * materialized batch is pre-registered immediately before each submit.\n */\nexport function prepareDocumentStoreSyncQueue(\n  pendingUpdates: PendingUpdateRecord[],\n): {\n  planningUpdates: PendingUpdateRecord[];\n  queuedUpdateCount: number;\n} {\n  return {\n    planningUpdates: pendingUpdates,\n    queuedUpdateCount: pendingUpdates.length,\n  };\n}\n\nexport function canSyncDetachedAttachmentBindings(\n  record: DocumentRecord,\n  pendingUpdateCount: number,\n): boolean {\n  return (\n    pendingUpdateCount === 0 &&\n    (record.pullContinuation ?? null) === null &&\n    !record.pullContinuationRecoveryRequired\n  );\n}\n\nasync function syncDocumentState(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  nextRecord: DocumentRecord,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  generation: DocumentStoreSyncGeneration,\n): Promise<DocumentRecord> {\n  // Snapshot the remote-update signal sequence before any await. The GET below\n  // fetches server state as of its own snapshot; any remote event delivered\n  // after this point describes an update that may not be in that response, so\n  // finalizeDocumentSync must not clear the signal if this sequence has moved.\n  const consumedRemoteUpdateSignalSeq = state.remoteUpdateSignalSeq;\n  const wasRemoteProbe = state.remoteUpdatePending;\n  let pendingUpdates = await listPendingUpdates(state);\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRecord;\n  }\n  if (pendingUpdates.length === 0 && isDocumentStoreRemoteSyncBlocked(state)) {\n    return nextRecord;\n  }\n  // Create the remote document even when nothing is queued to send: a note\n  // created and never edited enqueues no updates, but its local row is still a\n  // pending create the write queue reports — it must flush, not sit. Defer\n  // while the container itself still awaits its remote create — with OR\n  // without queued edits, since the create cannot succeed before its parent\n  // exists and attempting it just records a spurious failure. The structural\n  // lane primes this store again as soon as the container create lands.\n  if (!nextRecord.documentId) {\n    const containerAwaitsCreate = await isContainerAwaitingRemoteCreate(state);\n    if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n      requestDocumentStoreSync(state);\n      return state.record ?? nextRecord;\n    }\n    if (containerAwaitsCreate) return nextRecord;\n  }\n  let nextRemoteRecord = await ensureRemoteDocument(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    generation,\n  );\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRecord;\n  }\n  if (!nextRemoteRecord?.documentId) return nextRecord;\n\n  const preparedCoverage = await prepareDocumentOutgoingCoverage({\n    currentDoc,\n    generation,\n    pendingUpdates,\n    state,\n  });\n  if (!preparedCoverage) {\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRemoteRecord;\n  }\n  nextRemoteRecord = preparedCoverage.record;\n  pendingUpdates = preparedCoverage.pendingUpdates;\n\n  if (\n    shouldSkipCleanScheduledDocumentSync({\n      currentRecord: nextRemoteRecord,\n      pendingUpdates,\n      state,\n    })\n  ) {\n    return nextRemoteRecord;\n  }\n\n  // Pre-register the IDs we are about to send so the author's OWN\n  // `document_update_created` echo (fanned back over redis) is classified as\n  // self-authored and never re-arms a redundant sync. Registering BEFORE the\n  // network await closes the race where the echo lands before\n  // finalizeDocumentSync records the accepted IDs — the gap that turned every\n  // fast keystroke into an extra self-triggered sync.\n  const { sentUpdateIds, syncAttempt } = await requestOutgoingDocumentBatch({\n    currentDoc,\n    encapsulationKeyPair,\n    generation,\n    pendingUpdates,\n    record: nextRemoteRecord,\n    state,\n  });\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRemoteRecord;\n  }\n  if (!syncAttempt) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    logUnavailable(state, wasRemoteProbe);\n    return nextRemoteRecord;\n  }\n\n  return cleanupPreRegisteredUpdateIdsOnFailure(state, sentUpdateIds, () =>\n    finalizeDocumentSync(\n      state,\n      currentDoc,\n      nextRemoteRecord,\n      syncAttempt,\n      consumedRemoteUpdateSignalSeq,\n      generation,\n      sentUpdateIds,\n      wasRemoteProbe,\n    ),\n  );\n}\n\nasync function revalidateRemoteDocumentBeforeAttachments(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  nextRecord: DocumentRecord,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  generation: DocumentStoreSyncGeneration,\n): Promise<{ canSyncAttachments: boolean; nextRecord: DocumentRecord }> {\n  if (state.pendingAttachments.length === 0 || !nextRecord.documentId) {\n    return { canSyncAttachments: true, nextRecord };\n  }\n\n  const consumedRemoteUpdateSignalSeq = state.remoteUpdateSignalSeq;\n  const wasRemoteProbe = state.remoteUpdatePending;\n  const syncAttempt = await requestRemoteDocumentSync({\n    state,\n    currentDoc,\n    currentRecord: nextRecord,\n    encapsulationKeyPair,\n    generation,\n    pendingUpdates: [],\n    unavailableWriterLogMessage:\n      \"Documents: skipped pre-attachment revalidation because the writer context is unavailable.\",\n  });\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return { canSyncAttachments: false, nextRecord };\n  }\n  if (!syncAttempt) {\n    logUnavailable(state, wasRemoteProbe);\n    return { canSyncAttachments: false, nextRecord };\n  }\n\n  const refreshedRecord = await finalizeDocumentSync(\n    state,\n    currentDoc,\n    nextRecord,\n    syncAttempt,\n    consumedRemoteUpdateSignalSeq,\n    generation,\n    [],\n    wasRemoteProbe,\n  );\n  return {\n    canSyncAttachments:\n      !syncAttempt.synced.hasIncompletePull &&\n      refreshedRecord.pullContinuation == null &&\n      refreshedRecord.pullContinuationRecoveryRequired !== true &&\n      isDocumentStoreSyncGenerationCurrent(state, generation),\n    nextRecord: refreshedRecord,\n  };\n}\n\nasync function runDocumentSyncPass(\n  state: DocumentStoreState,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n) {\n  const currentDoc = state.doc;\n  const encapsulationKeyPair = state.runtime.crypto.encapsulationKeyPair;\n  let nextRecord = state.record;\n\n  if (!currentDoc || !nextRecord || !encapsulationKeyPair) {\n    return;\n  }\n\n  const generation = captureDocumentStoreRemoteSyncGeneration(\n    state,\n    currentDoc,\n    syncLaneGeneration,\n  );\n  const attachmentGeneration = captureDocumentStoreAttachmentSyncGeneration(\n    state,\n    currentDoc,\n    syncLaneGeneration,\n  );\n  if (!generation || !attachmentGeneration) {\n    requestDocumentStoreSync(state);\n    return;\n  }\n\n  const revalidation = await revalidateRemoteDocumentBeforeAttachments(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    generation,\n  );\n  nextRecord = revalidation.nextRecord;\n  if (!revalidation.canSyncAttachments) {\n    return;\n  }\n\n  const attachmentResult = await syncPendingAttachments(\n    state,\n    nextRecord,\n    encapsulationKeyPair,\n    attachmentGeneration,\n  );\n  nextRecord = attachmentResult.nextRecord;\n  if (state.pendingAttachments.length > 0) {\n    return;\n  }\n  // A settled bind and the content update carrying its digest are two server\n  // writes. Push the content in this same pass rather than re-arming a later\n  // one, so a device lost between them is the only remaining window: peers\n  // otherwise see the old digest against the new binding.\n\n  nextRecord = await syncDocumentState(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    generation,\n  );\n\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return;\n  }\n\n  if (!state.doc || !state.record) return;\n\n  const pendingUpdates = await listPendingUpdates(state);\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return;\n  }\n  if (!canSyncDetachedAttachmentBindings(nextRecord, pendingUpdates.length)) {\n    return;\n  }\n\n  await syncDetachedAttachmentBindings(state, nextRecord, generation);\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n  }\n}\n\nasync function runScheduledSyncIteration(\n  state: DocumentStoreState,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n) {\n  if (!(await awaitInitializationForSync(state))) {\n    return false;\n  }\n  if (!isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)) {\n    return true;\n  }\n\n  if (!canRunScheduledSync(state)) {\n    return true;\n  }\n\n  try {\n    await runDocumentSyncPass(state, syncLaneGeneration);\n    return true;\n  } catch (error) {\n    if (isDatabaseUnavailableError(error)) {\n      return false;\n    }\n\n    await reportAndRethrowKeyingVerificationError(\n      error,\n      state.runtime.util.reportSecurityIncident,\n      {\n        objectId: state.record?.documentId ?? state.localId,\n        objectKind: \"document\",\n        operation: \"document.sync\",\n      },\n    );\n\n    throw error;\n  }\n}\n\nasync function runScheduledSyncLoop(\n  state: DocumentStoreState,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n) {\n  const syncingGeneration = captureDocumentStoreSyncGeneration(\n    state,\n    state.doc,\n  );\n  setDocumentSyncing(state, true);\n\n  try {\n    await runScheduledSyncIteration(state, syncLaneGeneration);\n  } finally {\n    if (\n      syncingGeneration &&\n      isDocumentStoreSyncGenerationCurrent(state, syncingGeneration) &&\n      isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n    ) {\n      setDocumentSyncing(state, false);\n    }\n  }\n}\n\nexport function registerDocumentStoreSyncLane(\n  state: DocumentStoreState,\n  getSyncLaneGeneration: () => DocumentStoreSyncLaneGeneration | null,\n): DocumentSyncLane {\n  return registerDocumentSyncLane({\n    domainScope: state.runtime.state.domainScope,\n    localId: state.localId,\n    priority: () =>\n      state.remoteUpdatePending || state.record?.snapshotEndVersion === \"\"\n        ? -1\n        : 0,\n    logError: (message, error) => {\n      // Read the runtime lazily: a store's runtime is replaced in place, and a\n      // reference captured here would report into a torn-down host.\n      const { log, logError } = state.runtime.util;\n      // Return the host's result: both callbacks are declared `=> void` but may\n      // be async, and the lane reporter only catches a rejection it is handed.\n      return logError ? logError(message, error) : log(message);\n    },\n    run: () => {\n      const syncLaneGeneration = getSyncLaneGeneration();\n      if (!syncLaneGeneration) return Promise.resolve();\n      const activeWork = getActiveDocumentRemoteWork(state);\n      if (activeWork) {\n        // Re-arm on settlement, not immediately: immediate re-requests would\n        // spin this lane and starve other work while the HTTP request is held.\n        void activeWork.then(() => {\n          if (\n            isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n          ) {\n            requestDocumentStoreSync(state);\n          }\n        });\n        return Promise.resolve();\n      }\n      return runDocumentRemoteWork(state, () =>\n        isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n          ? runScheduledSyncLoop(state, syncLaneGeneration)\n          : Promise.resolve(),\n      );\n    },\n  });\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { reportAndRethrowKeyingVerificationError } from \"../../../../data/keyingProjectionVerification/error\";\nimport {\n  type DocumentRecord,\n  type DocumentSyncLane,\n  isDatabaseUnavailableError,\n  type PendingUpdateRecord,\n  registerDocumentSyncLane,\n  resolveDocumentCreateAuthor,\n} from \"../../../../workflows/documents\";\nimport { requestDocumentStoreSync } from \"../../registry\";\nimport { awaitInitializationForSync } from \"../initialization\";\nimport { listPendingUpdates } from \"../persistence\";\nimport {\n  type DocumentState,\n  type DocumentStoreState,\n  type DocumentSyncAttempt,\n  type EncapsulationKeyPair,\n  setDocumentSyncing,\n} from \"../state\";\nimport { logRevalidationUnavailable as logUnavailable } from \"./remoteRevalidationTelemetry\";\nimport {\n  getActiveDocumentRemoteWork,\n  runDocumentRemoteWork,\n} from \"./remoteWork\";\nimport {\n  cleanupPreRegisteredUpdateIdsOnFailure,\n  discardPreRegisteredUpdateIds,\n  preRegisterMaterializedDocumentSyncUpdateIds,\n} from \"./syncAcceptedUpdateIds\";\nimport { syncPendingAttachments } from \"./syncAttachments\";\nimport { syncDetachedAttachmentBindings } from \"./syncDetachedAttachments\";\nimport { finalizeDocumentSync } from \"./syncFinalize\";\nimport {\n  captureDocumentStoreAttachmentSyncGeneration,\n  captureDocumentStoreRemoteSyncGeneration,\n  captureDocumentStoreSyncGeneration,\n  type DocumentStoreSyncGeneration,\n  type DocumentStoreSyncLaneGeneration,\n  isDocumentStoreRemoteSyncBlocked,\n  isDocumentStoreSyncGenerationCurrent,\n  isDocumentStoreSyncLaneGenerationCurrent,\n} from \"./syncGeneration\";\nimport { prepareDocumentOutgoingCoverage } from \"./syncOutgoingCoverage\";\nimport { requestRemoteDocumentSync } from \"./syncRequest\";\nimport { ensureSeededRemoteDocument } from \"./syncSeededCreate\";\nimport {\n  isContainerAwaitingRemoteCreate,\n  shouldSkipCleanScheduledDocumentSync,\n} from \"./syncShared\";\n\nfunction canRunScheduledSync(state: DocumentStoreState): boolean {\n  return (\n    // A deferred birth waits for its attach to carry it (see\n    // deferredInitialUpdate.ts); a pass now would ship it on its own.\n    state.deferInitialUpdate !== true &&\n    state.doc !== null &&\n    state.snapshot.ready &&\n    state.runtime.state.online &&\n    state.runtime.auth.isAuthenticated &&\n    state.runtime.crypto.encapsulationKeyPair !== null &&\n    resolveDocumentCreateAuthor(state.runtime) !== null\n  );\n}\n\nasync function requestOutgoingDocumentBatch(input: {\n  readonly currentDoc: DocumentState;\n  readonly encapsulationKeyPair: EncapsulationKeyPair;\n  readonly generation: DocumentStoreSyncGeneration;\n  readonly pendingUpdates: PendingUpdateRecord[];\n  readonly record: DocumentRecord;\n  readonly state: DocumentStoreState;\n}): Promise<{\n  sentUpdateIds: string[];\n  syncAttempt: DocumentSyncAttempt | null;\n}> {\n  const { planningUpdates, queuedUpdateCount } = prepareDocumentStoreSyncQueue(\n    input.pendingUpdates,\n  );\n  const sentUpdateIds: string[] = [];\n  const syncAttempt = await cleanupPreRegisteredUpdateIdsOnFailure(\n    input.state,\n    sentUpdateIds,\n    () =>\n      requestRemoteDocumentSync({\n        currentDoc: input.currentDoc,\n        currentRecord: input.record,\n        encapsulationKeyPair: input.encapsulationKeyPair,\n        generation: input.generation,\n        onOutgoingUpdatesMaterialized: (updateIds) =>\n          preRegisterMaterializedDocumentSyncUpdateIds(\n            input.state,\n            sentUpdateIds,\n            updateIds,\n          ),\n        pendingUpdates: planningUpdates,\n        queuedUpdateCount,\n        state: input.state,\n        unavailableWriterLogMessage:\n          \"Documents: skipped sync because the writer context is unavailable.\",\n      }),\n  );\n  return { sentUpdateIds, syncAttempt };\n}\n\n/**\n * Keep the full durable queue visible to stale-heal/checkpoint classification.\n * The workflow planner owns the final count and byte bounds, and the exact\n * materialized batch is pre-registered immediately before each submit.\n */\nexport function prepareDocumentStoreSyncQueue(\n  pendingUpdates: PendingUpdateRecord[],\n): {\n  planningUpdates: PendingUpdateRecord[];\n  queuedUpdateCount: number;\n} {\n  return {\n    planningUpdates: pendingUpdates,\n    queuedUpdateCount: pendingUpdates.length,\n  };\n}\n\nexport function canSyncDetachedAttachmentBindings(\n  record: DocumentRecord,\n  pendingUpdateCount: number,\n): boolean {\n  return (\n    pendingUpdateCount === 0 &&\n    (record.pullContinuation ?? null) === null &&\n    !record.pullContinuationRecoveryRequired\n  );\n}\n\nasync function syncDocumentState(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  nextRecord: DocumentRecord,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  generation: DocumentStoreSyncGeneration,\n): Promise<DocumentRecord> {\n  // Snapshot the remote-update signal sequence before any await. The GET below\n  // fetches server state as of its own snapshot; any remote event delivered\n  // after this point describes an update that may not be in that response, so\n  // finalizeDocumentSync must not clear the signal if this sequence has moved.\n  const consumedRemoteUpdateSignalSeq = state.remoteUpdateSignalSeq;\n  const wasRemoteProbe = state.remoteUpdatePending;\n  let pendingUpdates = await listPendingUpdates(state);\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRecord;\n  }\n  if (pendingUpdates.length === 0 && isDocumentStoreRemoteSyncBlocked(state)) {\n    return nextRecord;\n  }\n  // Create the remote document even when nothing is queued to send: a note\n  // created and never edited enqueues no updates, but its local row is still a\n  // pending create the write queue reports — it must flush, not sit. Defer\n  // while the container itself still awaits its remote create — with OR\n  // without queued edits, since the create cannot succeed before its parent\n  // exists and attempting it just records a spurious failure. The structural\n  // lane primes this store again as soon as the container create lands.\n  if (!nextRecord.documentId) {\n    const containerAwaitsCreate = await isContainerAwaitingRemoteCreate(state);\n    if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n      requestDocumentStoreSync(state);\n      return state.record ?? nextRecord;\n    }\n    if (containerAwaitsCreate) return nextRecord;\n  }\n  const created = await ensureSeededRemoteDocument({\n    consumedRemoteUpdateSignalSeq,\n    currentDoc,\n    encapsulationKeyPair,\n    generation,\n    nextRecord,\n    pendingUpdates,\n    state,\n  });\n  let nextRemoteRecord = created.record;\n  pendingUpdates = created.pendingUpdates;\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRecord;\n  }\n  if (!nextRemoteRecord?.documentId) return nextRecord;\n\n  const preparedCoverage = await prepareDocumentOutgoingCoverage({\n    currentDoc,\n    generation,\n    pendingUpdates,\n    state,\n  });\n  if (!preparedCoverage) {\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRemoteRecord;\n  }\n  nextRemoteRecord = preparedCoverage.record;\n  pendingUpdates = preparedCoverage.pendingUpdates;\n\n  if (\n    shouldSkipCleanScheduledDocumentSync({\n      currentRecord: nextRemoteRecord,\n      pendingUpdates,\n      state,\n    })\n  ) {\n    return nextRemoteRecord;\n  }\n\n  // Pre-register the IDs we are about to send so the author's OWN\n  // `document_update_created` echo (fanned back over redis) is classified as\n  // self-authored and never re-arms a redundant sync. Registering BEFORE the\n  // network await closes the race where the echo lands before\n  // finalizeDocumentSync records the accepted IDs — the gap that turned every\n  // fast keystroke into an extra self-triggered sync.\n  const { sentUpdateIds, syncAttempt } = await requestOutgoingDocumentBatch({\n    currentDoc,\n    encapsulationKeyPair,\n    generation,\n    pendingUpdates,\n    record: nextRemoteRecord,\n    state,\n  });\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    requestDocumentStoreSync(state);\n    return state.record ?? nextRemoteRecord;\n  }\n  if (!syncAttempt) {\n    discardPreRegisteredUpdateIds(state, sentUpdateIds);\n    logUnavailable(state, wasRemoteProbe);\n    return nextRemoteRecord;\n  }\n\n  return cleanupPreRegisteredUpdateIdsOnFailure(state, sentUpdateIds, () =>\n    finalizeDocumentSync(\n      state,\n      currentDoc,\n      nextRemoteRecord,\n      syncAttempt,\n      consumedRemoteUpdateSignalSeq,\n      generation,\n      sentUpdateIds,\n      wasRemoteProbe,\n    ),\n  );\n}\n\nasync function revalidateRemoteDocumentBeforeAttachments(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  nextRecord: DocumentRecord,\n  encapsulationKeyPair: EncapsulationKeyPair,\n  generation: DocumentStoreSyncGeneration,\n): Promise<{ canSyncAttachments: boolean; nextRecord: DocumentRecord }> {\n  if (state.pendingAttachments.length === 0 || !nextRecord.documentId) {\n    return { canSyncAttachments: true, nextRecord };\n  }\n\n  const consumedRemoteUpdateSignalSeq = state.remoteUpdateSignalSeq;\n  const wasRemoteProbe = state.remoteUpdatePending;\n  const syncAttempt = await requestRemoteDocumentSync({\n    state,\n    currentDoc,\n    currentRecord: nextRecord,\n    encapsulationKeyPair,\n    generation,\n    pendingUpdates: [],\n    unavailableWriterLogMessage:\n      \"Documents: skipped pre-attachment revalidation because the writer context is unavailable.\",\n  });\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return { canSyncAttachments: false, nextRecord };\n  }\n  if (!syncAttempt) {\n    logUnavailable(state, wasRemoteProbe);\n    return { canSyncAttachments: false, nextRecord };\n  }\n\n  const refreshedRecord = await finalizeDocumentSync(\n    state,\n    currentDoc,\n    nextRecord,\n    syncAttempt,\n    consumedRemoteUpdateSignalSeq,\n    generation,\n    [],\n    wasRemoteProbe,\n  );\n  return {\n    canSyncAttachments:\n      !syncAttempt.synced.hasIncompletePull &&\n      refreshedRecord.pullContinuation == null &&\n      refreshedRecord.pullContinuationRecoveryRequired !== true &&\n      isDocumentStoreSyncGenerationCurrent(state, generation),\n    nextRecord: refreshedRecord,\n  };\n}\n\nasync function runDocumentSyncPass(\n  state: DocumentStoreState,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n) {\n  const currentDoc = state.doc;\n  const encapsulationKeyPair = state.runtime.crypto.encapsulationKeyPair;\n  let nextRecord = state.record;\n\n  if (!currentDoc || !nextRecord || !encapsulationKeyPair) {\n    return;\n  }\n\n  const generation = captureDocumentStoreRemoteSyncGeneration(\n    state,\n    currentDoc,\n    syncLaneGeneration,\n  );\n  const attachmentGeneration = captureDocumentStoreAttachmentSyncGeneration(\n    state,\n    currentDoc,\n    syncLaneGeneration,\n  );\n  if (!generation || !attachmentGeneration) {\n    requestDocumentStoreSync(state);\n    return;\n  }\n\n  const revalidation = await revalidateRemoteDocumentBeforeAttachments(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    generation,\n  );\n  nextRecord = revalidation.nextRecord;\n  if (!revalidation.canSyncAttachments) {\n    return;\n  }\n\n  const attachmentResult = await syncPendingAttachments(\n    state,\n    nextRecord,\n    encapsulationKeyPair,\n    attachmentGeneration,\n  );\n  nextRecord = attachmentResult.nextRecord;\n  if (state.pendingAttachments.length > 0) {\n    return;\n  }\n  // A settled bind and the content update carrying its digest are two server\n  // writes. Push the content in this same pass rather than re-arming a later\n  // one, so a device lost between them is the only remaining window: peers\n  // otherwise see the old digest against the new binding.\n\n  nextRecord = await syncDocumentState(\n    state,\n    currentDoc,\n    nextRecord,\n    encapsulationKeyPair,\n    generation,\n  );\n\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return;\n  }\n\n  if (!state.doc || !state.record) return;\n\n  const pendingUpdates = await listPendingUpdates(state);\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n    return;\n  }\n  if (!canSyncDetachedAttachmentBindings(nextRecord, pendingUpdates.length)) {\n    return;\n  }\n\n  await syncDetachedAttachmentBindings(state, nextRecord, generation);\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    requestDocumentStoreSync(state);\n  }\n}\n\nasync function runScheduledSyncIteration(\n  state: DocumentStoreState,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n) {\n  if (!(await awaitInitializationForSync(state))) {\n    return false;\n  }\n  if (!isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)) {\n    return true;\n  }\n\n  if (!canRunScheduledSync(state)) {\n    return true;\n  }\n\n  try {\n    await runDocumentSyncPass(state, syncLaneGeneration);\n    return true;\n  } catch (error) {\n    if (isDatabaseUnavailableError(error)) {\n      return false;\n    }\n\n    await reportAndRethrowKeyingVerificationError(\n      error,\n      state.runtime.util.reportSecurityIncident,\n      {\n        objectId: state.record?.documentId ?? state.localId,\n        objectKind: \"document\",\n        operation: \"document.sync\",\n      },\n    );\n\n    throw error;\n  }\n}\n\nasync function runScheduledSyncLoop(\n  state: DocumentStoreState,\n  syncLaneGeneration: DocumentStoreSyncLaneGeneration,\n) {\n  const syncingGeneration = captureDocumentStoreSyncGeneration(\n    state,\n    state.doc,\n  );\n  setDocumentSyncing(state, true);\n\n  try {\n    await runScheduledSyncIteration(state, syncLaneGeneration);\n  } finally {\n    if (\n      syncingGeneration &&\n      isDocumentStoreSyncGenerationCurrent(state, syncingGeneration) &&\n      isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n    ) {\n      setDocumentSyncing(state, false);\n    }\n  }\n}\n\nexport function registerDocumentStoreSyncLane(\n  state: DocumentStoreState,\n  getSyncLaneGeneration: () => DocumentStoreSyncLaneGeneration | null,\n): DocumentSyncLane {\n  return registerDocumentSyncLane({\n    domainScope: state.runtime.state.domainScope,\n    localId: state.localId,\n    priority: () =>\n      state.remoteUpdatePending || state.record?.snapshotEndVersion === \"\"\n        ? -1\n        : 0,\n    logError: (message, error) => {\n      // Read the runtime lazily: a store's runtime is replaced in place, and a\n      // reference captured here would report into a torn-down host.\n      const { log, logError } = state.runtime.util;\n      // Return the host's result: both callbacks are declared `=> void` but may\n      // be async, and the lane reporter only catches a rejection it is handed.\n      return logError ? logError(message, error) : log(message);\n    },\n    run: () => {\n      const syncLaneGeneration = getSyncLaneGeneration();\n      if (!syncLaneGeneration) return Promise.resolve();\n      const activeWork = getActiveDocumentRemoteWork(state);\n      if (activeWork) {\n        // Re-arm on settlement, not immediately: immediate re-requests would\n        // spin this lane and starve other work while the HTTP request is held.\n        void activeWork.then(() => {\n          if (\n            isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n          ) {\n            requestDocumentStoreSync(state);\n          }\n        });\n        return Promise.resolve();\n      }\n      return runDocumentRemoteWork(state, () =>\n        isDocumentStoreSyncLaneGenerationCurrent(state, syncLaneGeneration)\n          ? runScheduledSyncLoop(state, syncLaneGeneration)\n          : Promise.resolve(),\n      );\n    },\n  });\n}\n"]}

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

@@ -3,11 +3,27 @@ import { sequenceUnchanged } from "../../../../workflows/documents/sync/syncLane
 import { resumeAfterAncestorRepairHint } from "../ancestorRepairPark.js";
 import { invalidateDocumentWriterProjection } from "../writerProjectionGeneration.js";
 import { allowDocumentStoreRemoteSync, markDocumentStoreRemoteSyncPending, } from "./syncGeneration.js";
+/**
+ * The client-chosen id each store last submitted a remote create under. A peer
+ * can edit the document between the create's commit and the creator
+ * installing the id, and a seeded create answers the pass's earlier signal
+ * without a pull, so that edit's hint must still mark the store pending.
+ */
+const plannedRemoteDocumentIds = new WeakMap();
+export function recordPlannedRemoteDocumentId(state, documentId) {
+    plannedRemoteDocumentIds.set(state, documentId);
+}
+function remoteUpdateHintDocumentId(state) {
+    if (!state.record)
+        return null;
+    return state.record.documentId ?? plannedRemoteDocumentIds.get(state) ?? null;
+}
 export function hasRemoteDocumentUpdateEvent(state, events) {
+    const documentId = remoteUpdateHintDocumentId(state);
     let remoteUpdateFound = false;
     for (const event of events) {
         if (!isDocumentUpdateCreatedEvent(event) ||
-            event.documentId !== state.record?.documentId) {
+            event.documentId !== documentId) {
             continue;
         }
         if (event.updateIds && event.updateIds.length > 0) {
@@ -48,12 +64,14 @@ export function handleDocumentRemoteEvents(state, scheduleSync) {
     const projectionInvalidated = nextEvents.some(isContainerProjectionInvalidationHint);
     if (projectionInvalidated)
         invalidateDocumentWriterProjection(state);
-    if (!state.record?.documentId)
+    if (!remoteUpdateHintDocumentId(state))
         return;
     // Writes parked behind an ancestor another member must re-key: this hint is
     // the only signal that the repair may have landed. It names no ancestor, so
     // any one re-runs the pass, which parks again if the path is still stale.
-    if (projectionInvalidated && resumeAfterAncestorRepairHint(state)) {
+    if (state.record?.documentId &&
+        projectionInvalidated &&
+        resumeAfterAncestorRepairHint(state)) {
         scheduleSync();
     }
     if (hasRemoteDocumentUpdateEvent(state, nextEvents)) {

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

@@ -1 +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"]}
+{"version":3,"file":"syncRemoteSignals.js","sourceRoot":"","sources":["syncRemoteSignals.ts"],"names":[],"mappings":"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","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\n/**\n * The client-chosen id each store last submitted a remote create under. A peer\n * can edit the document between the create's commit and the creator\n * installing the id, and a seeded create answers the pass's earlier signal\n * without a pull, so that edit's hint must still mark the store pending.\n */\nconst plannedRemoteDocumentIds = new WeakMap<DocumentStoreState, string>();\n\nexport function recordPlannedRemoteDocumentId(\n  state: DocumentStoreState,\n  documentId: string,\n): void {\n  plannedRemoteDocumentIds.set(state, documentId);\n}\n\nfunction remoteUpdateHintDocumentId(state: DocumentStoreState): string | null {\n  if (!state.record) return null;\n  return state.record.documentId ?? plannedRemoteDocumentIds.get(state) ?? null;\n}\n\nexport function hasRemoteDocumentUpdateEvent(\n  state: DocumentStoreState,\n  events: ReadonlyArray<unknown>,\n): boolean {\n  const documentId = remoteUpdateHintDocumentId(state);\n  let remoteUpdateFound = false;\n\n  for (const event of events) {\n    if (\n      !isDocumentUpdateCreatedEvent(event) ||\n      event.documentId !== 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 (!remoteUpdateHintDocumentId(state)) 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 (\n    state.record?.documentId &&\n    projectionInvalidated &&\n    resumeAfterAncestorRepairHint(state)\n  ) {\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/sync/syncSeededCreate.js

@@ -0,0 +1,50 @@
+import { encodeVersionVector } from "../../../../internal/loro/index.js";
+import { documentCreateSeedCandidate, } from "../../../../workflows/documents/index.js";
+import { listPendingUpdates } from "../persistence.js";
+import { cleanupPreRegisteredUpdateIdsOnFailure, discardPreRegisteredUpdateIds, preRegisterMaterializedDocumentSyncUpdateIds, } from "./syncAcceptedUpdateIds.js";
+import { clearConsumedRemoteUpdateSignal } from "./syncRemoteSignals.js";
+import { ensureRemoteDocument } from "./syncShared.js";
+/**
+ * Creates a document that does not exist remotely yet. When its whole content
+ * is one queued row (see `documentCreateSeedCandidate`), the create commits
+ * that row as its seed and stands in for this pass's sync: the row settles and
+ * a signal raised before the pass is answered, since no remote content can
+ * predate the create. A deferred birth with nothing queued keeps the ordinary
+ * path, where the coverage pass materializes it.
+ */
+export async function ensureSeededRemoteDocument(input) {
+    const { state } = input;
+    const seedUpdate = input.nextRecord.documentId
+        ? null
+        : documentCreateSeedCandidate({
+            documentVersion: encodeVersionVector(input.currentDoc),
+            pendingUpdates: input.pendingUpdates,
+        });
+    const ensure = (seed) => ensureRemoteDocument(state, input.currentDoc, input.nextRecord, input.encapsulationKeyPair, input.generation, seed);
+    if (!seedUpdate) {
+        return {
+            pendingUpdates: input.pendingUpdates,
+            record: await ensure(undefined),
+        };
+    }
+    // Registered before the network await, as a sync registers its sent ids, so
+    // the create's own update echo is classified as self-authored.
+    const seedUpdateIds = [];
+    preRegisterMaterializedDocumentSyncUpdateIds(state, seedUpdateIds, [
+        seedUpdate.id,
+    ]);
+    let committed = false;
+    const record = await cleanupPreRegisteredUpdateIdsOnFailure(state, seedUpdateIds, () => ensure({
+        onCommitted: () => {
+            committed = true;
+        },
+        update: seedUpdate,
+    }));
+    if (!committed) {
+        discardPreRegisteredUpdateIds(state, seedUpdateIds);
+        return { pendingUpdates: input.pendingUpdates, record };
+    }
+    clearConsumedRemoteUpdateSignal(state, input.consumedRemoteUpdateSignalSeq);
+    return { pendingUpdates: await listPendingUpdates(state), record };
+}
+//# sourceMappingURL=syncSeededCreate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncSeededCreate.js","sourceRoot":"","sources":["syncSeededCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAEL,2BAA2B,GAE5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMpD,OAAO,EACL,sCAAsC,EACtC,6BAA6B,EAC7B,4CAA4C,GAC7C,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAQhD;IAIC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU;QAC5C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,2BAA2B,CAAC;YAC1B,eAAe,EAAE,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC;YACtD,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;IACP,MAAM,MAAM,GAAG,CAAC,IAAgD,EAAE,EAAE,CAClE,oBAAoB,CAClB,KAAK,EACL,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,oBAAoB,EAC1B,KAAK,CAAC,UAAU,EAChB,IAAI,CACL,CAAC;IACJ,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,MAAM,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC;SAChC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,4CAA4C,CAAC,KAAK,EAAE,aAAa,EAAE;QACjE,UAAU,CAAC,EAAE;KACd,CAAC,CAAC;IACH,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,MAAM,GAAG,MAAM,sCAAsC,CACzD,KAAK,EACL,aAAa,EACb,GAAG,EAAE,CACH,MAAM,CAAC;QACL,WAAW,EAAE,GAAG,EAAE;YAChB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,UAAU;KACnB,CAAC,CACL,CAAC;IACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,6BAA6B,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACpD,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IACD,+BAA+B,CAAC,KAAK,EAAE,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AACrE,CAAC","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport {\n  type DocumentRecord,\n  documentCreateSeedCandidate,\n  type PendingUpdateRecord,\n} from \"../../../../workflows/documents\";\nimport { listPendingUpdates } from \"../persistence\";\nimport type {\n  DocumentState,\n  DocumentStoreState,\n  EncapsulationKeyPair,\n} from \"../state\";\nimport {\n  cleanupPreRegisteredUpdateIdsOnFailure,\n  discardPreRegisteredUpdateIds,\n  preRegisterMaterializedDocumentSyncUpdateIds,\n} from \"./syncAcceptedUpdateIds\";\nimport type { DocumentStoreSyncGeneration } from \"./syncGeneration\";\nimport { clearConsumedRemoteUpdateSignal } from \"./syncRemoteSignals\";\nimport { ensureRemoteDocument } from \"./syncShared\";\n\n/**\n * Creates a document that does not exist remotely yet. When its whole content\n * is one queued row (see `documentCreateSeedCandidate`), the create commits\n * that row as its seed and stands in for this pass's sync: the row settles and\n * a signal raised before the pass is answered, since no remote content can\n * predate the create. A deferred birth with nothing queued keeps the ordinary\n * path, where the coverage pass materializes it.\n */\nexport async function ensureSeededRemoteDocument(input: {\n  readonly consumedRemoteUpdateSignalSeq: number;\n  readonly currentDoc: DocumentState;\n  readonly encapsulationKeyPair: EncapsulationKeyPair;\n  readonly generation: DocumentStoreSyncGeneration;\n  readonly nextRecord: DocumentRecord;\n  readonly pendingUpdates: PendingUpdateRecord[];\n  readonly state: DocumentStoreState;\n}): Promise<{\n  readonly pendingUpdates: PendingUpdateRecord[];\n  readonly record: DocumentRecord | null;\n}> {\n  const { state } = input;\n  const seedUpdate = input.nextRecord.documentId\n    ? null\n    : documentCreateSeedCandidate({\n        documentVersion: encodeVersionVector(input.currentDoc),\n        pendingUpdates: input.pendingUpdates,\n      });\n  const ensure = (seed: Parameters<typeof ensureRemoteDocument>[5]) =>\n    ensureRemoteDocument(\n      state,\n      input.currentDoc,\n      input.nextRecord,\n      input.encapsulationKeyPair,\n      input.generation,\n      seed,\n    );\n  if (!seedUpdate) {\n    return {\n      pendingUpdates: input.pendingUpdates,\n      record: await ensure(undefined),\n    };\n  }\n\n  // Registered before the network await, as a sync registers its sent ids, so\n  // the create's own update echo is classified as self-authored.\n  const seedUpdateIds: string[] = [];\n  preRegisterMaterializedDocumentSyncUpdateIds(state, seedUpdateIds, [\n    seedUpdate.id,\n  ]);\n  let committed = false;\n  const record = await cleanupPreRegisteredUpdateIdsOnFailure(\n    state,\n    seedUpdateIds,\n    () =>\n      ensure({\n        onCommitted: () => {\n          committed = true;\n        },\n        update: seedUpdate,\n      }),\n  );\n  if (!committed) {\n    discardPreRegisteredUpdateIds(state, seedUpdateIds);\n    return { pendingUpdates: input.pendingUpdates, record };\n  }\n  clearConsumedRemoteUpdateSignal(state, input.consumedRemoteUpdateSignalSeq);\n  return { pendingUpdates: await listPendingUpdates(state), record };\n}\n"]}

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

@@ -3,10 +3,11 @@ import { createRemoteDocument, DOCUMENTS_APP_KIND, describeDocumentRevalidationF
 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 { persistCreatedRemoteDocument, } from "./createdDocumentPersistence.js";
 import { isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
+import { recordPlannedRemoteDocumentId } from "./syncRemoteSignals.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
@@ -123,7 +124,7 @@ async function hasDurableDocumentForCreate(state, isCurrent) {
     markDocumentStoreRemoved(state);
     return false;
 }
-export async function ensureRemoteDocument(state, currentDoc, nextRecord, encapsulationKeyPair, generation) {
+export async function ensureRemoteDocument(state, currentDoc, nextRecord, encapsulationKeyPair, generation, seed) {
     const generationIsCurrent = () => !generation || isDocumentStoreSyncGenerationCurrent(state, generation);
     if (!generationIsCurrent())
         return state.record ?? nextRecord;
@@ -152,6 +153,9 @@ export async function ensureRemoteDocument(state, currentDoc, nextRecord, encaps
         (await deriveStableDocumentId(state.localId));
     if (!generationIsCurrent())
         return state.record ?? nextRecord;
+    // Hints for the document can arrive before the create's response installs
+    // its id; see recordPlannedRemoteDocumentId.
+    recordPlannedRemoteDocumentId(state, documentId);
     if (!(await hasDurableDocumentForCreate(state, generationIsCurrent)))
         return state.record;
     const writerProjectionGeneration = state.writerProjectionGeneration;
@@ -167,6 +171,7 @@ export async function ensureRemoteDocument(state, currentDoc, nextRecord, encaps
         isRemoteSyncBlocked: runtime.util.isRemoteSyncBlocked,
         onTerminalSubmitFailure: documentTerminalSubmitFailureHandler(state, generation),
         resolveProjectionUserKey: state.resolveProjectionUserKey,
+        seedUpdate: seed?.update,
         stillCurrent: generationIsCurrent,
         targetSecretKey: encapsulationKeyPair.secretKey,
         warmReferencedPrincipalPolicies: createRuntimePrincipalPolicyWarmer(runtime),
@@ -199,12 +204,15 @@ export async function ensureRemoteDocument(state, currentDoc, nextRecord, encaps
         // (the new-note "type immediately" race). Preserve the optimistic snapshot —
         // documentId/keys still propagate via state.record, independent of the
         // snapshot text — matching finalizeDocumentSync and the keystroke writes.
-        const persistPatch = { ...created.persistedState };
-        const persistOptions = {
-            preserveSnapshotStructuredFields: true,
-            preserveSnapshotText: true,
-        };
-        const persisted = await persistDocument(state, currentDoc, persistPatch, persistOptions, generation);
+        // A committed seed settles its row in this persist, so the pass needs no
+        // sync request.
+        const persisted = await persistCreatedRemoteDocument({
+            created,
+            currentDoc,
+            generation,
+            seed,
+            state,
+        });
         return persisted?.record ?? state.record ?? nextRecord;
     });
 }

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

@@ -1 +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"]}
+{"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 {\n  type DocumentState,\n  type DocumentStoreState,\n  type EncapsulationKeyPair,\n  markDocumentStoreRemoved,\n} from \"../state\";\nimport { installDocumentWriterProjection } from \"../writerProjectionGeneration\";\nimport {\n  type CreateSeed,\n  persistCreatedRemoteDocument,\n} from \"./createdDocumentPersistence\";\nimport {\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { recordPlannedRemoteDocumentId } from \"./syncRemoteSignals\";\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  seed?: CreateSeed,\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  // Hints for the document can arrive before the create's response installs\n  // its id; see recordPlannedRemoteDocumentId.\n  recordPlannedRemoteDocumentId(state, documentId);\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    seedUpdate: seed?.update,\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    // A committed seed settles its row in this persist, so the pass needs no\n    // sync request.\n    const persisted = await persistCreatedRemoteDocument({\n      created,\n      currentDoc,\n      generation,\n      seed,\n      state,\n    });\n    return persisted?.record ?? state.record ?? nextRecord;\n  });\n}\n"]}

package/workflows/container-contents/container-state/create/createIntentSeed.js

@@ -0,0 +1,60 @@
+import { encodeVersionVector } from "../../../../internal/loro/index.js";
+import { documentCreateSeedCandidate } from "../../../documents/sync/initialSync.js";
+import { discardUnacceptedContainerMetadataUpdateIds, preRegisterMaterializedContainerMetadataUpdateIds, } from "../../metadata/metadataSyncRegistrations.js";
+import { plannedContainerMetadataDocumentId } from "./createWithMetadataPlan.js";
+/**
+ * The queued first metadata update, when it holds the whole document, commits
+ * with the create instead of a following metadata sync. A seed only saves that
+ * sync, so a queue that cannot be read means no seed rather than a failed pass.
+ */
+export async function loadMetadataSeedUpdate(state, containerState) {
+    try {
+        return documentCreateSeedCandidate({
+            documentVersion: encodeVersionVector(containerState.doc),
+            pendingUpdates: await state.persistence.listPendingUpdates(state.runtime.infra.execSql, containerState.container.id),
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Runs a seeded create with the seed's id registered as self-authored first,
+ * as a metadata sync registers the ids it sends, so the create's own update
+ * echo cannot arm the metadata sync the seed replaces. An id the create did
+ * not commit is discarded.
+ */
+export async function withRegisteredMetadataSeed(locallyAcceptedUpdateIds, seed, create) {
+    const registered = [];
+    if (seed) {
+        preRegisterMaterializedContainerMetadataUpdateIds(locallyAcceptedUpdateIds, registered, [seed.id]);
+    }
+    let accepted = [];
+    try {
+        const created = await create();
+        if (created && typeof created !== "symbol" && created.metadataSeed) {
+            accepted = [created.metadataSeed.updateId];
+        }
+        return created;
+    }
+    finally {
+        discardUnacceptedContainerMetadataUpdateIds(locallyAcceptedUpdateIds, registered, accepted);
+    }
+}
+/**
+ * Runs a folder's create with its planned metadata document id registered, so
+ * a peer's metadata hint that arrives before the response installs the id
+ * still queues the folder's first read (see
+ * `listContainerMetadataDocumentUpdateIds`).
+ */
+export async function withPlannedMetadataDocumentId(plannedDocumentIds, containerId, create) {
+    const documentId = plannedContainerMetadataDocumentId(containerId);
+    plannedDocumentIds?.add(documentId);
+    try {
+        return await create();
+    }
+    finally {
+        plannedDocumentIds?.delete(documentId);
+    }
+}
+//# sourceMappingURL=createIntentSeed.js.map

package/workflows/container-contents/container-state/create/createIntentSeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIntentSeed.js","sourceRoot":"","sources":["createIntentSeed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EACL,2CAA2C,EAC3C,iDAAiD,GAClD,MAAM,0CAA0C,CAAC;AAIlD,OAAO,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAqC,EACrC,cAA8B;IAE9B,IAAI,CAAC;QACH,OAAO,2BAA2B,CAAC;YACjC,eAAe,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC;YACxD,cAAc,EAAE,MAAM,KAAK,CAAC,WAAW,CAAC,kBAAkB,CACxD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAC3B,cAAc,CAAC,SAAS,CAAC,EAAE,CAC5B;SACF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,wBAAiD,EACjD,IAAgC,EAChC,MAAsD;IAEtD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,EAAE,CAAC;QACT,iDAAiD,CAC/C,wBAAwB,EACxB,UAAU,EACV,CAAC,IAAI,CAAC,EAAE,CAAC,CACV,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;QAC/B,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACnE,QAAQ,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,2CAA2C,CACzC,wBAAwB,EACxB,UAAU,EACV,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,kBAA2C,EAC3C,WAAmB,EACnB,MAAwB;IAExB,MAAM,UAAU,GAAG,kCAAkC,CAAC,WAAW,CAAC,CAAC;IACnE,kBAAkB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,kBAAkB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;AACH,CAAC","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport type { PendingUpdateRecord } from \"../../../../data/sqlite/documentPersistence\";\nimport { documentCreateSeedCandidate } from \"../../../documents/sync/initialSync\";\nimport {\n  discardUnacceptedContainerMetadataUpdateIds,\n  preRegisterMaterializedContainerMetadataUpdateIds,\n} from \"../../metadata/metadataSyncRegistrations\";\nimport type { ContainerState } from \"../../remoteHydration\";\nimport type { createRemoteContainer } from \"../remote\";\nimport type { ContainerCreateIntentSyncState } from \"../types\";\nimport { plannedContainerMetadataDocumentId } from \"./createWithMetadataPlan\";\n\n/**\n * The queued first metadata update, when it holds the whole document, commits\n * with the create instead of a following metadata sync. A seed only saves that\n * sync, so a queue that cannot be read means no seed rather than a failed pass.\n */\nexport async function loadMetadataSeedUpdate(\n  state: ContainerCreateIntentSyncState,\n  containerState: ContainerState,\n) {\n  try {\n    return documentCreateSeedCandidate({\n      documentVersion: encodeVersionVector(containerState.doc),\n      pendingUpdates: await state.persistence.listPendingUpdates(\n        state.runtime.infra.execSql,\n        containerState.container.id,\n      ),\n    });\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Runs a seeded create with the seed's id registered as self-authored first,\n * as a metadata sync registers the ids it sends, so the create's own update\n * echo cannot arm the metadata sync the seed replaces. An id the create did\n * not commit is discarded.\n */\nexport async function withRegisteredMetadataSeed(\n  locallyAcceptedUpdateIds: Set<string> | undefined,\n  seed: PendingUpdateRecord | null,\n  create: () => ReturnType<typeof createRemoteContainer>,\n): ReturnType<typeof createRemoteContainer> {\n  const registered: string[] = [];\n  if (seed) {\n    preRegisterMaterializedContainerMetadataUpdateIds(\n      locallyAcceptedUpdateIds,\n      registered,\n      [seed.id],\n    );\n  }\n  let accepted: string[] = [];\n  try {\n    const created = await create();\n    if (created && typeof created !== \"symbol\" && created.metadataSeed) {\n      accepted = [created.metadataSeed.updateId];\n    }\n    return created;\n  } finally {\n    discardUnacceptedContainerMetadataUpdateIds(\n      locallyAcceptedUpdateIds,\n      registered,\n      accepted,\n    );\n  }\n}\n\n/**\n * Runs a folder's create with its planned metadata document id registered, so\n * a peer's metadata hint that arrives before the response installs the id\n * still queues the folder's first read (see\n * `listContainerMetadataDocumentUpdateIds`).\n */\nexport async function withPlannedMetadataDocumentId<T>(\n  plannedDocumentIds: Set<string> | undefined,\n  containerId: string,\n  create: () => Promise<T>,\n): Promise<T> {\n  const documentId = plannedContainerMetadataDocumentId(containerId);\n  plannedDocumentIds?.add(documentId);\n  try {\n    return await create();\n  } finally {\n    plannedDocumentIds?.delete(documentId);\n  }\n}\n"]}

package/workflows/container-contents/container-state/create/createIntentSync.js

@@ -4,9 +4,10 @@ import { ContainerCreateIntentSupersededError } from "../../../../data/persisten
 import { errorMessage } from "../../../../data/shared/errorMessage.js";
 import { createDetachedContainerMetadataState, installDetachedContainerMetadataState, } from "../../metadata/metadataStateIsolation.js";
 import { hasRemoteContainerMetadataState } from "../../remoteHydration/reconciliation.js";
-import { createRemoteContainer, deleteRemoteContainer } from "../remote.js";
+import { createRemoteContainer, discardOrphanedRemoteContainer, } from "../remote.js";
 import { syncListedContainerCreate } from "./createAdoption.js";
 import { deferTooDeepCreate, recordRefusedTooDeepCreate, } from "./createIntentDepth.js";
+import { loadMetadataSeedUpdate, withPlannedMetadataDocumentId, withRegisteredMetadataSeed, } from "./createIntentSeed.js";
 import { CONTAINER_ALREADY_COMMITTED } from "./createWithMetadata.js";
 class IncompleteContainerCreateSettlementError extends Error {
 }
@@ -62,7 +63,8 @@ async function persistCreatedRemoteContainerStateFromIntent(input) {
         persistenceResult = await host.persistContainerState(persistenceCandidate, {
             accessEpoch: 1,
             accessStateHash: created.accessManifestHash,
-            lastCommitLsn: null,
+            // A committed seed stands in for the first metadata sync.
+            lastCommitLsn: created.metadataSeed?.commitLsn ?? null,
             metadataDocumentId: created.metadataDocumentId,
             systemSlot: created.systemSlot,
             organizationId: created.organizationId,
@@ -74,6 +76,12 @@ async function persistCreatedRemoteContainerStateFromIntent(input) {
                 updatedAt: created.updatedAt,
             },
         }, {
+            ...(created.metadataSeed
+                ? {
+                    acceptedPendingUpdateIds: [created.metadataSeed.updateId],
+                    clearSyncFailure: true,
+                }
+                : {}),
             createIntentSettlement: {
                 containerId: intent.containerId,
                 expectedIntentId: intent.id,
@@ -127,19 +135,6 @@ async function persistCreatedRemoteContainerStateFromIntent(input) {
     };
     return "persisted";
 }
-async function discardOrphanedRemoteContainer(input) {
-    if (!input.isCurrent()) {
-        return;
-    }
-    const discardFailure = await deleteRemoteContainer({
-        containerId: input.created.containerId,
-        organizationId: input.created.organizationId,
-        runtime: input.state.runtime,
-    }).then((deleted) => (deleted ? null : "the server rejected the delete"), (error) => errorMessage(error));
-    if (input.isCurrent() && discardFailure !== null) {
-        input.state.runtime.util.log(`Container contents: failed to discard orphaned remote container ${input.created.containerId} after local delete: ${discardFailure}`);
-    }
-}
 async function settleRemoteContainerCreate(input) {
     const { containerState, created, syncInput } = input;
     const { host, intent, state } = syncInput;
@@ -205,16 +200,20 @@ async function settleRemoteContainerCreate(input) {
 async function createPendingRemoteContainer(input) {
     const { containerState, parentState, syncInput } = input;
     const { intent, state } = syncInput;
+    const metadataSeedUpdate = await loadMetadataSeedUpdate(syncInput.state, containerState);
+    if (!syncInput.isCurrent())
+        return "abandoned";
     let created;
     try {
-        created = await createRemoteContainer({
+        created = await withRegisteredMetadataSeed(state.locallyAcceptedMetadataUpdateIds, metadataSeedUpdate, () => createRemoteContainer({
             systemSlot: containerState.container.systemSlot,
             containerId: containerState.container.id,
+            ...(metadataSeedUpdate ? { metadataSeedUpdate } : {}),
             parentContainerId: parentState.container.id,
             resolveProjectionUserKey: state.resolveProjectionUserKey,
             runtime: state.runtime,
             stillCurrent: syncInput.isCurrent,
-        });
+        }));
     }
     catch (error) {
         if (error instanceof ContainerPathTooDeepError)
@@ -297,11 +296,11 @@ async function trySyncPendingContainerContentsContainerCreateIntent(input) {
     if (await deferTooDeepCreate(input)) {
         return currentCreateResult(input.isCurrent, "blocked");
     }
-    return createPendingRemoteContainer({
+    return withPlannedMetadataDocumentId(state.plannedMetadataDocumentIds, containerState.container.id, () => createPendingRemoteContainer({
         containerState,
         parentState,
         syncInput: input,
-    });
+    }));
 }
 export async function syncPendingContainerCreateIntents(input) {
     if (!input.isCurrent()) {