@tearleads/client-sdk 0.1.86 → 0.1.88

package/stores/container-contents/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ContainerAccessLevel,\n  ReferencedPrincipalHead,\n} from \"@tearleads/crypto\";\nimport type { ContainerSystemSlot } from \"@tearleads/validators/containerSystemSlot\";\nimport type { ContainerWriterProjectionResponse } from \"@tearleads/validators/response\";\nimport type { PurgeOptions } from \"../../workflows/container-contents/container-state/purge/purgeProgress\";\nimport type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport type { ContainerDocumentObjectSyncState } from \"../../workflows/container-contents/syncState\";\nimport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncState,\n  RefreshRootLaneOptions,\n} from \"./syncAgent/syncAgentTypes\";\n\n// Reuse the canonical access-level union from the crypto layer (the same source\n// `ContainerShareAccessLevel` chains to) rather than re-spelling the literals,\n// so the two can't drift.\nexport type ContainerContentsShareAccessLevel = ContainerAccessLevel;\n\nexport interface ContainerContentsStoreOptions {\n  logLabel?: string | undefined;\n  persistence?: ContainerContentsPersistence | undefined;\n}\n\nexport interface ContainerNode {\n  systemSlot?: ContainerSystemSlot | null;\n  createdAt?: string | null;\n  effectiveAccessLevel?: ContainerAccessLevel | undefined;\n  id: string;\n  icon?: string | null;\n  metadataDocumentId?: string | null;\n  /** False while a discovered remote folder has no local metadata content. */\n  metadataReady?: boolean;\n  organizationId: string;\n  name: string;\n  parentId: string | null;\n  syncState: ContainerDocumentObjectSyncState;\n  kind: \"container\";\n  updatedAt?: string | null;\n}\n\n// The store surface exposed through context: the snapshot fields plus the\n// store's mutation/refresh methods, spelled as a Pick so the two can't drift.\nexport type ContainerContentsContextValue = ContainerContentsSnapshot &\n  Pick<\n    ContainerContentsStore,\n    | \"createChild\"\n    | \"deleteContainer\"\n    | \"emptyTrash\"\n    | \"ensureSystemContainer\"\n    | \"moveContainer\"\n    | \"purgeContainer\"\n    | \"refresh\"\n    | \"refreshRootLane\"\n    | \"renameContainer\"\n    | \"requestSync\"\n    | \"setContainerIcon\"\n    | \"shareWithGroup\"\n    | \"shareWithUser\"\n  >;\n\nexport interface ContainerContentsSnapshot {\n  nodes: ReadonlyArray<ContainerNode>;\n  ready: boolean;\n}\n\nexport type ContainerGroupRewrapPreparation =\n  | {\n      status: \"not-granted\";\n    }\n  | {\n      isCurrent(\n        expectedGroupHead: ReferencedPrincipalHead,\n        expectedContainerId: string,\n        expectedOrganizationId: string,\n      ): Promise<boolean>;\n      rewrap(): Promise<boolean>;\n      status: \"prepared\";\n    };\n\n/**\n * Shared per-scope container tree and mutation store.\n *\n * Ordinary metadata/topology writes (`createChild`, `moveContainer`,\n * `renameContainer`, and `setContainerIcon`) commit to local persistence and\n * update subscribers before their queued remote sync converges. Destructive\n * and access-control operations retain their explicit remote-authority gates.\n */\nexport interface ContainerContentsStore {\n  createChild: (\n    parentId: string,\n    name: string,\n  ) => Promise<ContainerNode | null>;\n  deleteContainer: (containerId: string) => Promise<boolean>;\n  ensureSystemContainer: (\n    systemSlot: ContainerSystemSlot,\n    name: string,\n    options?: EnsureSystemContainerOptions | undefined,\n  ) => Promise<ContainerNode | null>;\n  moveContainer: (\n    containerId: string,\n    parentId: string,\n  ) => Promise<ContainerNode | null>;\n  purgeContainer: (\n    containerId: string,\n    options?: PurgeOptions,\n  ) => Promise<boolean>;\n  emptyTrash: (\n    trashContainerId: string,\n    options?: PurgeOptions,\n  ) => Promise<boolean>;\n  // `options.requireExistingGrant` gates the preparation check only. The\n  // prepared `rewrap` is always grant-preserving: it re-wraps a signed grant\n  // and never mints one, so it carries no chosen group name, and it throws\n  // (rather than healing through a policy mutation) when the container\n  // manifest grants the group but the verified policy has no matching grant.\n  prepareGroupRewrap: (\n    containerId: string,\n    groupId: string,\n    accessLevel: ContainerContentsShareAccessLevel,\n    options?: { requireExistingGrant?: boolean } | undefined,\n  ) => Promise<ContainerGroupRewrapPreparation | null>;\n  refresh: () => Promise<boolean>;\n  refreshRootLane: (options?: RefreshRootLaneOptions) => Promise<boolean>;\n  // Re-read root-lane containers from local SQLite into the snapshot with NO\n  // server round-trip. Surfaces a just-persisted container — e.g. the Trash bin\n  // that registration/org-creation provisioned server-side and wrote to SQLite\n  // via persistRegistrationBootstrap — instantly, instead of waiting for the\n  // remote root-lane pull. Idempotent with a later remote pull: the merge is\n  // keyed by container id, so the pull reconciles in place rather than duplicating.\n  refreshLocalContainers: () => Promise<void>;\n  requestSync: () => void;\n  renameContainer: (\n    containerId: string,\n    name: string,\n  ) => Promise<ContainerNode | null>;\n  setContainerIcon: (\n    containerId: string,\n    icon: string | null,\n  ) => Promise<ContainerNode | null>;\n  shareWithGroup: (\n    containerId: string,\n    groupId: string,\n    accessLevel: ContainerContentsShareAccessLevel,\n    options: {\n      /**\n       * The display name the group was chosen by. Required: the share fails\n       * closed if the verified group policy commits a different name. Signed\n       * names are unique within an organization by construction (enforced at\n       * group creation), so the target's own name identifies it.\n       */\n      expectedGroupName: string;\n    },\n  ) => Promise<boolean>;\n  shareWithUser: (containerId: string, userId: string) => Promise<boolean>;\n  getCachedContainerWriterProjection: (\n    containerId: string,\n  ) => ContainerWriterProjectionResponse | null;\n  getSnapshot: () => ContainerContentsSnapshot;\n  subscribe: (listener: () => void) => () => void;\n  updateRuntime: (runtime: ContainerContentsStoreRuntime) => void;\n}\n\nexport interface EnsureSystemContainerOptions {\n  icon?: string | null | undefined;\n  skipAdvancedManagedRoot?: boolean | undefined;\n  // For local-first bootstrap paths where slow remote I/O must not block the\n  // caller from creating the deterministic local system container.\n  deferRemoteBootstrap?: boolean | undefined;\n  // Create the deterministic local system container without queuing the remote\n  // create. A later ensureSystemContainer call without this flag promotes the\n  // local slot into the sync queue.\n  deferRemoteSync?: boolean | undefined;\n}\n\nexport interface ContainerContentsStoreState\n  extends ContainerContentsStoreSyncState {\n  listeners: Set<() => void>;\n  snapshot: ContainerContentsSnapshot;\n  writeChain: Promise<ContainerNode | null>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ContainerAccessLevel,\n  ReferencedPrincipalHead,\n} from \"@tearleads/crypto\";\nimport type { ContainerSystemSlot } from \"@tearleads/validators/containerSystemSlot\";\nimport type { ContainerWriterProjectionResponse } from \"@tearleads/validators/response\";\nimport type { PurgeOptions } from \"../../workflows/container-contents/container-state/purge/purgeProgress\";\nimport type { ContainerContentsPersistence } from \"../../workflows/container-contents/containerPersistence\";\nimport type { ContainerDocumentObjectSyncState } from \"../../workflows/container-contents/syncState\";\nimport type {\n  ContainerContentsStoreRuntime,\n  ContainerContentsStoreSyncState,\n  RefreshRootLaneOptions,\n} from \"./syncAgent/syncAgentTypes\";\n\n// Reuse the canonical access-level union from the crypto layer (the same source\n// `ContainerShareAccessLevel` chains to) rather than re-spelling the literals,\n// so the two can't drift.\nexport type ContainerContentsShareAccessLevel = ContainerAccessLevel;\n\nexport interface ContainerContentsStoreOptions {\n  logLabel?: string | undefined;\n  persistence?: ContainerContentsPersistence | undefined;\n}\n\nexport interface ContainerNode {\n  systemSlot?: ContainerSystemSlot | null;\n  createdAt?: string | null;\n  effectiveAccessLevel?: ContainerAccessLevel | undefined;\n  id: string;\n  icon?: string | null;\n  metadataDocumentId?: string | null;\n  /** False while a discovered remote folder has no local metadata content. */\n  metadataReady?: boolean;\n  organizationId: string;\n  name: string;\n  parentId: string | null;\n  syncState: ContainerDocumentObjectSyncState;\n  kind: \"container\";\n  updatedAt?: string | null;\n}\n\n// The store surface exposed through context: the snapshot fields plus the\n// store's mutation/refresh methods, spelled as a Pick so the two can't drift.\nexport type ContainerContentsContextValue = ContainerContentsSnapshot &\n  Pick<\n    ContainerContentsStore,\n    | \"createChild\"\n    | \"deleteContainer\"\n    | \"emptyTrash\"\n    | \"ensureSystemContainer\"\n    | \"moveContainer\"\n    | \"purgeContainer\"\n    | \"refresh\"\n    | \"refreshRootLane\"\n    | \"renameContainer\"\n    | \"requestSync\"\n    | \"setContainerIcon\"\n    | \"shareWithGroup\"\n    | \"shareWithUser\"\n  >;\n\nexport interface ContainerContentsSnapshot {\n  nodes: ReadonlyArray<ContainerNode>;\n  ready: boolean;\n}\n\nexport type ContainerGroupRewrapPreparation =\n  | {\n      status: \"not-granted\";\n    }\n  | {\n      isCurrent(\n        expectedGroupHead: ReferencedPrincipalHead,\n        expectedContainerId: string,\n        expectedOrganizationId: string,\n      ): Promise<boolean>;\n      rewrap(): Promise<boolean>;\n      status: \"prepared\";\n    };\n\n/**\n * Shared per-scope container tree and mutation store.\n *\n * Ordinary metadata/topology writes (`createChild`, `moveContainer`,\n * `renameContainer`, and `setContainerIcon`) commit to local persistence and\n * update subscribers before their queued remote sync converges. Destructive\n * and access-control operations retain their explicit remote-authority gates.\n */\nexport interface ContainerContentsStore {\n  createChild: (\n    parentId: string,\n    name: string,\n  ) => Promise<ContainerNode | null>;\n  deleteContainer: (containerId: string) => Promise<boolean>;\n  ensureSystemContainer: (\n    systemSlot: ContainerSystemSlot,\n    name: string,\n    options?: EnsureSystemContainerOptions | undefined,\n  ) => Promise<ContainerNode | null>;\n  moveContainer: (\n    containerId: string,\n    parentId: string,\n  ) => Promise<ContainerNode | null>;\n  purgeContainer: (\n    containerId: string,\n    options?: PurgeOptions,\n  ) => Promise<boolean>;\n  emptyTrash: (\n    trashContainerId: string,\n    options?: PurgeOptions,\n  ) => Promise<boolean>;\n  /**\n   * Removes a paused organization's content from this device: every container\n   * except its metadata root, and every document placed only in them. Local\n   * only; the caller first confirms the organization has no unsynced writes.\n   */\n  forgetOrganizationContent: (organizationId: string) => Promise<boolean>;\n  // `options.requireExistingGrant` gates the preparation check only. The\n  // prepared `rewrap` is always grant-preserving: it re-wraps a signed grant\n  // and never mints one, so it carries no chosen group name, and it throws\n  // (rather than healing through a policy mutation) when the container\n  // manifest grants the group but the verified policy has no matching grant.\n  prepareGroupRewrap: (\n    containerId: string,\n    groupId: string,\n    accessLevel: ContainerContentsShareAccessLevel,\n    options?: { requireExistingGrant?: boolean } | undefined,\n  ) => Promise<ContainerGroupRewrapPreparation | null>;\n  refresh: () => Promise<boolean>;\n  refreshRootLane: (options?: RefreshRootLaneOptions) => Promise<boolean>;\n  // Re-read root-lane containers from local SQLite into the snapshot with NO\n  // server round-trip. Surfaces a just-persisted container — e.g. the Trash bin\n  // that registration/org-creation provisioned server-side and wrote to SQLite\n  // via persistRegistrationBootstrap — instantly, instead of waiting for the\n  // remote root-lane pull. Idempotent with a later remote pull: the merge is\n  // keyed by container id, so the pull reconciles in place rather than duplicating.\n  refreshLocalContainers: () => Promise<void>;\n  requestSync: () => void;\n  renameContainer: (\n    containerId: string,\n    name: string,\n  ) => Promise<ContainerNode | null>;\n  setContainerIcon: (\n    containerId: string,\n    icon: string | null,\n  ) => Promise<ContainerNode | null>;\n  shareWithGroup: (\n    containerId: string,\n    groupId: string,\n    accessLevel: ContainerContentsShareAccessLevel,\n    options: {\n      /**\n       * The display name the group was chosen by. Required: the share fails\n       * closed if the verified group policy commits a different name. Signed\n       * names are unique within an organization by construction (enforced at\n       * group creation), so the target's own name identifies it.\n       */\n      expectedGroupName: string;\n    },\n  ) => Promise<boolean>;\n  shareWithUser: (containerId: string, userId: string) => Promise<boolean>;\n  getCachedContainerWriterProjection: (\n    containerId: string,\n  ) => ContainerWriterProjectionResponse | null;\n  getSnapshot: () => ContainerContentsSnapshot;\n  subscribe: (listener: () => void) => () => void;\n  updateRuntime: (runtime: ContainerContentsStoreRuntime) => void;\n}\n\nexport interface EnsureSystemContainerOptions {\n  icon?: string | null | undefined;\n  skipAdvancedManagedRoot?: boolean | undefined;\n  // For local-first bootstrap paths where slow remote I/O must not block the\n  // caller from creating the deterministic local system container.\n  deferRemoteBootstrap?: boolean | undefined;\n  // Create the deterministic local system container without queuing the remote\n  // create. A later ensureSystemContainer call without this flag promotes the\n  // local slot into the sync queue.\n  deferRemoteSync?: boolean | undefined;\n}\n\nexport interface ContainerContentsStoreState\n  extends ContainerContentsStoreSyncState {\n  listeners: Set<() => void>;\n  snapshot: ContainerContentsSnapshot;\n  writeChain: Promise<ContainerNode | null>;\n}\n"]}

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

@@ -6,7 +6,7 @@ import { ensureDocumentStoreReady } from "../initialization/index.js";
 import { runDocumentOrphanMaintenance } from "../orphanMaintenance.js";
 import { advancePendingBaseVersion, pendingDeltaSinceBase, persistDocument, } from "../persistence.js";
 import { reportDocumentStoreWriteFailure } from "../reportWriteFailure.js";
-import { canWriteDocument, setReadySnapshot, } from "../state.js";
+import { canWriteDocument, chainQueuedWrite, setReadySnapshot, } from "../state.js";
 import { captureDocumentStoreSyncGeneration } from "../sync/syncGeneration.js";
 import { restoreFailedAttachmentMutation } from "./attachmentMutationPersistence.js";
 import { assignLocalAttachmentSlots, removeLocalAttachmentSlot, } from "./attachmentPersistence.js";
@@ -125,12 +125,11 @@ export async function removeAttachmentFromDocumentStore(state, scheduleSync, slo
     const writeGeneration = captureAttachmentWriteGeneration(state);
     if (!writeGeneration)
         return;
-    state.writeChain = state.writeChain
+    return chainQueuedWrite(state, state.writeChain
         .catch(() => undefined)
         .then(async () => persistRemovedAttachment(state, slotId, writeGeneration))
         .catch((error) => {
         reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);
-    });
-    return state.writeChain;
+    }));
 }
 //# sourceMappingURL=attachmentRemoval.js.map

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

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

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

@@ -6,7 +6,7 @@ import { ensureDocumentStoreReady } from "../initialization/index.js";
 import { settleDeferredInitialUpdate } from "../initialization/deferredInitialUpdate.js";
 import { advancePendingBaseVersion, pendingDeltaSinceBase, } from "../persistence.js";
 import { reportDocumentStoreWriteFailure } from "../reportWriteFailure.js";
-import { canAttachFiles, canWriteDocument, } from "../state.js";
+import { canAttachFiles, canWriteDocument, chainQueuedWrite, } from "../state.js";
 import { captureDocumentStoreSyncGeneration } from "../sync/syncGeneration.js";
 import { buildAttachmentIntent, buildPendingAttachments, } from "./attachmentIntents.js";
 import { persistStagedAttachmentMutation, restoreFailedAttachmentMutation, } from "./attachmentMutationPersistence.js";
@@ -207,13 +207,12 @@ export async function attachFilesToDocumentStore(state, scheduleSync, files) {
     // only behind every earlier attach, never while one is still staging. The
     // caller's document is captured now (a cold store captures once ready).
     const callGeneration = captureAttachmentWriteGeneration(state);
-    state.writeChain = state.writeChain
+    return chainQueuedWrite(state, state.writeChain
         .catch(() => undefined)
         .then(async () => attachThenSettle(state, scheduleSync, files, callGeneration))
         .catch((error) => {
         reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);
-    });
-    return state.writeChain;
+    }));
 }
 export async function replaceAttachmentInDocumentStore(state, scheduleSync, slotId, file) {
     let ready;
@@ -230,12 +229,11 @@ export async function replaceAttachmentInDocumentStore(state, scheduleSync, slot
     const writeGeneration = captureAttachmentWriteGeneration(state);
     if (!writeGeneration)
         return;
-    state.writeChain = state.writeChain
+    return chainQueuedWrite(state, state.writeChain
         .catch(() => undefined)
         .then(async () => persistSlotAttachmentFile(state, slotId, file, writeGeneration))
         .catch((error) => {
         reportDocumentStoreWriteFailure(state, ATTACHMENT_FAILURE_MESSAGE, error);
-    });
-    return state.writeChain;
+    }));
 }
 //# sourceMappingURL=index.js.map

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

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

package/stores/documents/documentStore/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_DOCUMENT_KIND } from "../../../data/documents/documentConstants.js";
 import { createDocumentProjectionUserKeyResolver, defaultDocumentsPersistence, didDocumentProjectionKeyRuntimeChange, didRegainSyncPrerequisites, requestDocumentSyncLaneAndWait, } from "../../../workflows/documents/index.js";
-import { createDocumentStoreFacade, emitPersistedDocument, getOrCreateDocumentStoreRegistry, registerDocumentStore, registerDocumentStoreIdentity, requestDocumentStoreSync, resolveDocumentStoreKey, } from "../registry.js";
+import { createDocumentStoreFacade, emitPersistedDocument, getOrCreateDocumentStoreRegistry, registerDocumentStore, registerDocumentStoreIdentity, requestDocumentStoreSync, resolveDocumentStoreKey, takeRegisteredDocumentStore, } from "../registry.js";
 import { attachFilesToDocumentStore, replaceAttachmentInDocumentStore, } from "./attachments/index.js";
 import { removeAttachmentFromDocumentStore } from "./attachments/attachmentRemoval.js";
 import { discardDocumentStoreLocalState } from "./discard.js";
@@ -10,7 +10,7 @@ import { registerInternalDocumentRelink } from "./internalRelink.js";
 import { setDocumentStructuredFields, setDocumentText } from "./mutations.js";
 import { assertDocumentStoreCanRotateContentKey } from "./rotation/index.js";
 import { addRowToDocumentStore, removeRowFromDocumentStore, updateRowInDocumentStore, } from "./rows/index.js";
-import { createDocumentStoreState, refreshAttachabilitySnapshot, resetDocumentStore, subscribeToDocumentStore, } from "./state.js";
+import { countQueuedWrite, createDocumentStoreState, refreshAttachabilitySnapshot, resetDocumentStore, subscribeToDocumentStore, } from "./state.js";
 import { registerDocumentStoreSyncLane } from "./sync/index.js";
 import { logRevalidationScheduled } from "./sync/remoteRevalidationTelemetry.js";
 import { allowDocumentStoreRemoteSync, captureDocumentStoreRemoteSyncRequestGeneration, captureDocumentStoreSyncLaneGeneration, didDocumentStoreRemoteSyncRequestComplete, hasPendingIndependentDocumentStoreRemoteSync, invalidateDocumentStoreRemoteSync, invalidateDocumentStoreSyncLane, isDocumentStoreRemoteSyncBlocked, isDocumentStoreRemoteSyncRequestGenerationCurrent, markDocumentStoreRemoteSyncPending, registerDocumentStoreRemoteSyncWaiter, } from "./sync/syncGeneration.js";
@@ -170,24 +170,27 @@ function createBackingStoreContext(localId, runtime, persistence, documentId, te
 }
 function createBackingDocumentStore(localId, initialRuntime, persistence = defaultDocumentsPersistence, initialDocumentId = null, initialText = "", initialDocumentKind = DEFAULT_DOCUMENT_KIND, openOptions = {}) {
     const { scheduleSync, state, withLiveSyncLane } = createBackingStoreContext(localId, initialRuntime, persistence, initialDocumentId, initialText, initialDocumentKind, openOptions);
+    // Local writes count as queued from the call, readiness wait included.
+    const liveWrite = (write) => withLiveSyncLane(() => countQueuedWrite(state, write()));
     const store = {
-        addRow: (fields) => withLiveSyncLane(() => addRowToDocumentStore(state, scheduleSync, fields)),
+        addRow: (fields) => liveWrite(() => addRowToDocumentStore(state, scheduleSync, fields)),
         assertCanRotateContentKey: () => withLiveSyncLane(() => assertBackingDocumentStoreCanRotate(state, scheduleSync)),
-        attachFiles: (files) => withLiveSyncLane(() => attachFilesToDocumentStore(state, scheduleSync, files)),
+        attachFiles: (files) => liveWrite(() => attachFilesToDocumentStore(state, scheduleSync, files)),
         discardLocalState: (expectedDocumentId) => withLiveSyncLane(() => discardBackingDocumentStoreLocalState(state, scheduleSync, expectedDocumentId)),
         ensureInitialized: () => withLiveSyncLane(() => ensureDocumentStoreReady(state, scheduleSync)),
         getSnapshot: () => state.snapshot,
-        removeAttachment: (slotId) => withLiveSyncLane(() => removeAttachmentFromDocumentStore(state, scheduleSync, slotId)),
-        removeRow: (id) => withLiveSyncLane(() => removeRowFromDocumentStore(state, scheduleSync, id)),
-        replaceAttachment: (slotId, file) => withLiveSyncLane(() => replaceAttachmentInDocumentStore(state, scheduleSync, slotId, file)),
+        hasQueuedWrites: () => state.queuedWrites > 0,
+        removeAttachment: (slotId) => liveWrite(() => removeAttachmentFromDocumentStore(state, scheduleSync, slotId)),
+        removeRow: (id) => liveWrite(() => removeRowFromDocumentStore(state, scheduleSync, id)),
+        replaceAttachment: (slotId, file) => liveWrite(() => replaceAttachmentInDocumentStore(state, scheduleSync, slotId, file)),
         requestRemoteSync: () => withLiveSyncLane(() => requestRemoteDocumentStoreSync(state, scheduleSync)),
         requestRemoteSyncAndWait: (signal) => requestRemoteDocumentStoreSyncAndWait(state, scheduleSync, signal),
         requestSync: () => withLiveSyncLane(() => requestOrdinaryDocumentStoreSync(state, scheduleSync)),
         relink: (input) => withLiveSyncLane(() => relinkDocumentStore(state, input, scheduleSync)),
-        setStructuredFields: (kind, patch, options) => withLiveSyncLane(() => setDocumentStructuredFields(state, scheduleSync, kind, patch, options)),
-        setText: (value) => withLiveSyncLane(() => setDocumentText(state, scheduleSync, value)),
+        setStructuredFields: (kind, patch, options) => liveWrite(() => setDocumentStructuredFields(state, scheduleSync, kind, patch, options)),
+        setText: (value) => liveWrite(() => setDocumentText(state, scheduleSync, value)),
         subscribe: (listener) => subscribeToDocumentStore(state, listener),
-        updateRowFields: (id, patch) => withLiveSyncLane(() => updateRowInDocumentStore(state, scheduleSync, id, patch)),
+        updateRowFields: (id, patch) => liveWrite(() => updateRowInDocumentStore(state, scheduleSync, id, patch)),
         updateRuntime: (runtime) => updateDocumentStoreRuntime(state, runtime, scheduleSync),
     };
     return registerBackingStoreInternalRelink({
@@ -202,12 +205,13 @@ export function createDocumentStore(localId, initialRuntime, persistence = defau
 }
 export function getOrCreateDocumentStore(domainScope, localId, runtime, initialDocumentId = null, initialText = "", initialDocumentKind = DEFAULT_DOCUMENT_KIND, options = {}) {
     const registry = getOrCreateDocumentStoreRegistry(domainScope);
-    const existingStore = registry.storesByKey.get(resolveDocumentStoreKey(registry, localId, initialDocumentId));
+    const createBacking = () => createBackingDocumentStore(localId, runtime, defaultDocumentsPersistence, initialDocumentId, initialText, initialDocumentKind, options);
+    const existingStore = takeRegisteredDocumentStore(registry, resolveDocumentStoreKey(registry, localId, initialDocumentId), createBacking);
     if (existingStore) {
         registerDocumentStore(domainScope, localId, existingStore, initialDocumentId);
         return existingStore;
     }
-    const nextStore = createDocumentStore(localId, runtime, defaultDocumentsPersistence, initialDocumentId, initialText, initialDocumentKind, options);
+    const nextStore = createDocumentStoreFacade(createBacking());
     registerDocumentStore(domainScope, localId, nextStore, initialDocumentId);
     return nextStore;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_DOCUMENT_KIND } from \"../../../data/documents/documentConstants\";\nimport type { StoredDocumentKind } from \"../../../data/documents/documentKinds\";\nimport type { DomainScope } from \"../../../data/shared/domainScope\";\nimport {\n  createDocumentProjectionUserKeyResolver,\n  type DocumentsPersistence,\n  defaultDocumentsPersistence,\n  didDocumentProjectionKeyRuntimeChange,\n  didRegainSyncPrerequisites,\n  requestDocumentSyncLaneAndWait,\n} from \"../../../workflows/documents\";\nimport {\n  createDocumentStoreFacade,\n  emitPersistedDocument,\n  getOrCreateDocumentStoreRegistry,\n  registerDocumentStore,\n  registerDocumentStoreIdentity,\n  requestDocumentStoreSync,\n  resolveDocumentStoreKey,\n} from \"../registry\";\nimport type {\n  DocumentAttachmentUpload,\n  DocumentStore,\n  DocumentStoreFacade,\n  DocumentStoreOpenOptions,\n  DocumentsRuntime,\n} from \"../types\";\nimport {\n  attachFilesToDocumentStore,\n  replaceAttachmentInDocumentStore,\n} from \"./attachments\";\nimport { removeAttachmentFromDocumentStore } from \"./attachments/attachmentRemoval\";\nimport { discardDocumentStoreLocalState } from \"./discard\";\nimport {\n  ensureDocumentStoreInitialized,\n  ensureDocumentStoreReady,\n  relinkDocumentStore,\n} from \"./initialization\";\nimport { assertInitialContentFitsKind } from \"./initialization/initialContent\";\nimport { registerInternalDocumentRelink } from \"./internalRelink\";\nimport { setDocumentStructuredFields, setDocumentText } from \"./mutations\";\nimport { assertDocumentStoreCanRotateContentKey } from \"./rotation\";\nimport {\n  addRowToDocumentStore,\n  removeRowFromDocumentStore,\n  updateRowInDocumentStore,\n} from \"./rows\";\nimport {\n  createDocumentStoreState,\n  type DocumentStoreState,\n  refreshAttachabilitySnapshot,\n  resetDocumentStore,\n  subscribeToDocumentStore,\n} from \"./state\";\nimport { registerDocumentStoreSyncLane } from \"./sync\";\nimport { logRevalidationScheduled } from \"./sync/remoteRevalidationTelemetry\";\nimport {\n  allowDocumentStoreRemoteSync,\n  captureDocumentStoreRemoteSyncRequestGeneration,\n  captureDocumentStoreSyncLaneGeneration,\n  type DocumentStoreRemoteSyncRequestGeneration,\n  type DocumentStoreSyncLaneGeneration,\n  didDocumentStoreRemoteSyncRequestComplete,\n  hasPendingIndependentDocumentStoreRemoteSync,\n  invalidateDocumentStoreRemoteSync,\n  invalidateDocumentStoreSyncLane,\n  isDocumentStoreRemoteSyncBlocked,\n  isDocumentStoreRemoteSyncRequestGenerationCurrent,\n  markDocumentStoreRemoteSyncPending,\n  registerDocumentStoreRemoteSyncWaiter,\n} from \"./sync/syncGeneration\";\nimport { handleDocumentRemoteEvents } from \"./sync/syncRemoteSignals\";\n\nexport {\n  discardRegisteredDocumentLocalState,\n  requestDomainDocumentSync,\n  subscribeToPersistedDocuments,\n} from \"../registry\";\n\nfunction refreshDocumentStoreSyncLane(\n  state: DocumentStoreState,\n  force = false,\n): void {\n  if (!force && state.syncLane && !state.syncLane.isDisposed?.()) {\n    return;\n  }\n  if (state.syncLane) {\n    invalidateDocumentStoreSyncLane(state);\n  }\n  let syncLaneGeneration: DocumentStoreSyncLaneGeneration | null = null;\n  state.syncLane = registerDocumentStoreSyncLane(\n    state,\n    () => syncLaneGeneration,\n  );\n  syncLaneGeneration = captureDocumentStoreSyncLaneGeneration(state);\n}\n\nfunction updateDocumentStoreRuntime(\n  state: DocumentStoreState,\n  nextRuntime: DocumentsRuntime,\n  scheduleSync: () => void,\n) {\n  const previousRuntime = state.runtime;\n  const serverEventsReconnected =\n    (nextRuntime.state.serverEventsConnectionGeneration ?? 0) >\n    (previousRuntime.state.serverEventsConnectionGeneration ?? 0);\n  const domainScopeChanged =\n    previousRuntime.state.domainScope !== nextRuntime.state.domainScope;\n  const projectionKeyRuntimeChanged = didDocumentProjectionKeyRuntimeChange(\n    previousRuntime,\n    nextRuntime,\n  );\n  if (projectionKeyRuntimeChanged) {\n    state.resolveProjectionUserKey =\n      createDocumentProjectionUserKeyResolver(nextRuntime);\n    state.writerProjection = null;\n  }\n  state.runtime = nextRuntime;\n  refreshDocumentStoreSyncLane(state, domainScopeChanged);\n  if (domainScopeChanged) {\n    state.locallyAcceptedUpdateIds = new Set();\n    state.remoteUpdatePending = false;\n    state.writerProjection = null;\n  }\n\n  if (nextRuntime.infra.dbStatus !== \"ready\") {\n    if (state.snapshot.ready || state.initialized || state.initializePromise) {\n      resetDocumentStore(state);\n    }\n    state.lastEventCount = nextRuntime.state.events.length;\n    return;\n  }\n\n  refreshAttachabilitySnapshot(state);\n  ensureDocumentStoreInitialized(state, scheduleSync);\n  handleDocumentRemoteEvents(state, scheduleSync);\n\n  if (state.snapshot.ready) {\n    if (serverEventsReconnected) {\n      // The invalidation stream is lossy while disconnected. Once the server\n      // has acknowledged this socket's authoritative interest declaration,\n      // every already-open remote document needs one HTTP probe to cover peer\n      // writes made during the gap. This also closes iOS background/resume reconnects where the\n      // native network source remained online throughout.\n      requestRemoteDocumentStoreSync(state, scheduleSync);\n      logRevalidationScheduled(state.runtime, \"reconnect\");\n    } else if (didRegainSyncPrerequisites(previousRuntime, state.runtime)) {\n      scheduleSync();\n    }\n  }\n}\n\nfunction requestRemoteDocumentStoreSync(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  owner: \"independent\" | \"waiter\" = \"independent\",\n): number {\n  allowDocumentStoreRemoteSync(state);\n  const signalSequence = markDocumentStoreRemoteSyncPending(state, owner);\n  scheduleSync();\n  return signalSequence;\n}\n\nfunction requestOrdinaryDocumentStoreSync(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n): void {\n  // A normal UI reopen is a fresh owner for remote-only work. It may recover\n  // a probe that an earlier, now-unmounted owner aborted.\n  if (isDocumentStoreRemoteSyncBlocked(state)) {\n    requestRemoteDocumentStoreSync(state, scheduleSync);\n    return;\n  }\n  scheduleSync();\n}\n\nfunction requestRemoteDocumentStoreSyncAndWait(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  signal?: AbortSignal,\n): Promise<boolean> {\n  let requestGeneration: DocumentStoreRemoteSyncRequestGeneration | null = null;\n  let requestedSignalSequence = 0;\n  let releaseWaiter: (() => boolean) | null = null;\n  const releaseRemoteSyncWaiter = (invalidate: boolean) => {\n    const releasedLastWaiter = releaseWaiter?.() ?? false;\n    if (\n      invalidate &&\n      releasedLastWaiter &&\n      requestGeneration !== null &&\n      isDocumentStoreRemoteSyncRequestGenerationCurrent(\n        state,\n        requestGeneration,\n      ) &&\n      !hasPendingIndependentDocumentStoreRemoteSync(state)\n    ) {\n      invalidateDocumentStoreRemoteSync(state);\n    }\n  };\n  // A coordinator can be disposed and recreated while this same-scope store\n  // remains registered. Refresh its handle before requesting work.\n  refreshDocumentStoreSyncLane(state);\n  return requestDocumentSyncLaneAndWait({\n    didCompleteRequest: () =>\n      requestGeneration !== null &&\n      didDocumentStoreRemoteSyncRequestComplete(\n        state,\n        requestGeneration,\n        requestedSignalSequence,\n      ),\n    domainScope: state.runtime.state.domainScope,\n    localId: state.localId,\n    request: () => {\n      requestGeneration =\n        captureDocumentStoreRemoteSyncRequestGeneration(state);\n      releaseWaiter = registerDocumentStoreRemoteSyncWaiter(\n        state,\n        requestGeneration,\n      );\n      requestedSignalSequence = requestRemoteDocumentStoreSync(\n        state,\n        scheduleSync,\n        \"waiter\",\n      );\n    },\n    onInvalidated: () => releaseRemoteSyncWaiter(true),\n    signal,\n  }).then(\n    (completed) => {\n      releaseRemoteSyncWaiter(!completed);\n      return completed;\n    },\n    (error: unknown) => {\n      releaseRemoteSyncWaiter(true);\n      throw error;\n    },\n  );\n}\n\nasync function assertBackingDocumentStoreCanRotate(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n) {\n  if (!(await ensureDocumentStoreReady(state, scheduleSync)) || !state.doc) {\n    throw new Error(\n      \"Document must finish loading before its content key can rotate\",\n    );\n  }\n  return assertDocumentStoreCanRotateContentKey(state);\n}\n\nasync function discardBackingDocumentStoreLocalState(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  expectedDocumentId: string,\n) {\n  try {\n    return await discardDocumentStoreLocalState(state, expectedDocumentId);\n  } finally {\n    // Restart hydration whenever the attempt reset the store. This runs outside\n    // its identity-chained task because initialization also chains writes.\n    ensureDocumentStoreInitialized(state, scheduleSync);\n    scheduleSync();\n  }\n}\n\nfunction createLiveSyncLaneRequest(state: DocumentStoreState) {\n  return <Result>(request: () => Result): Result => {\n    refreshDocumentStoreSyncLane(state);\n    return request();\n  };\n}\n\nfunction registerBackingStoreInternalRelink(input: {\n  scheduleSync: () => void;\n  state: DocumentStoreState;\n  store: DocumentStore;\n  withLiveSyncLane: ReturnType<typeof createLiveSyncLaneRequest>;\n}): DocumentStore {\n  registerInternalDocumentRelink(input.store, (relinkInput, commitSideEffect) =>\n    input.withLiveSyncLane(() =>\n      relinkDocumentStore(\n        input.state,\n        relinkInput,\n        input.scheduleSync,\n        commitSideEffect,\n      ),\n    ),\n  );\n  return input.store;\n}\n\nfunction createBackingStoreContext(\n  localId: string,\n  runtime: DocumentsRuntime,\n  persistence: DocumentsPersistence,\n  documentId: string | null,\n  text: string,\n  documentKind: StoredDocumentKind,\n  options: DocumentStoreOpenOptions,\n) {\n  const state = createDocumentStoreState(\n    localId,\n    runtime,\n    persistence,\n    {\n      emitPersistedDocument,\n      registerDocumentIdentity: registerDocumentStoreIdentity,\n    },\n    documentId,\n    text,\n    documentKind,\n    (options.remoteSyncMode ?? \"startup\") === \"startup\",\n  );\n  if (options.deferInitialUpdate) state.deferInitialUpdate = true;\n  const { initialRows, initialStructuredFields } = options;\n  assertInitialContentFitsKind({ initialStructuredFields }, documentKind);\n  state.initialContent = { initialRows, initialStructuredFields };\n  refreshDocumentStoreSyncLane(state);\n  const scheduleSync = () => requestDocumentStoreSync(state);\n  return {\n    scheduleSync,\n    state,\n    withLiveSyncLane: createLiveSyncLaneRequest(state),\n  };\n}\n\nfunction createBackingDocumentStore(\n  localId: string,\n  initialRuntime: DocumentsRuntime,\n  persistence: DocumentsPersistence = defaultDocumentsPersistence,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  openOptions: DocumentStoreOpenOptions = {},\n): DocumentStore {\n  const { scheduleSync, state, withLiveSyncLane } = createBackingStoreContext(\n    localId,\n    initialRuntime,\n    persistence,\n    initialDocumentId,\n    initialText,\n    initialDocumentKind,\n    openOptions,\n  );\n\n  const store: DocumentStore = {\n    addRow: (fields) =>\n      withLiveSyncLane(() =>\n        addRowToDocumentStore(state, scheduleSync, fields),\n      ),\n    assertCanRotateContentKey: () =>\n      withLiveSyncLane(() =>\n        assertBackingDocumentStoreCanRotate(state, scheduleSync),\n      ),\n    attachFiles: (files: ReadonlyArray<DocumentAttachmentUpload>) =>\n      withLiveSyncLane(() =>\n        attachFilesToDocumentStore(state, scheduleSync, files),\n      ),\n    discardLocalState: (expectedDocumentId: string) =>\n      withLiveSyncLane(() =>\n        discardBackingDocumentStoreLocalState(\n          state,\n          scheduleSync,\n          expectedDocumentId,\n        ),\n      ),\n    ensureInitialized: () =>\n      withLiveSyncLane(() => ensureDocumentStoreReady(state, scheduleSync)),\n    getSnapshot: () => state.snapshot,\n    removeAttachment: (slotId: string) =>\n      withLiveSyncLane(() =>\n        removeAttachmentFromDocumentStore(state, scheduleSync, slotId),\n      ),\n    removeRow: (id) =>\n      withLiveSyncLane(() =>\n        removeRowFromDocumentStore(state, scheduleSync, id),\n      ),\n    replaceAttachment: (slotId: string, file: DocumentAttachmentUpload) =>\n      withLiveSyncLane(() =>\n        replaceAttachmentInDocumentStore(state, scheduleSync, slotId, file),\n      ),\n    requestRemoteSync: () =>\n      withLiveSyncLane(() =>\n        requestRemoteDocumentStoreSync(state, scheduleSync),\n      ),\n    requestRemoteSyncAndWait: (signal) =>\n      requestRemoteDocumentStoreSyncAndWait(state, scheduleSync, signal),\n    requestSync: () =>\n      withLiveSyncLane(() =>\n        requestOrdinaryDocumentStoreSync(state, scheduleSync),\n      ),\n    relink: (input) =>\n      withLiveSyncLane(() => relinkDocumentStore(state, input, scheduleSync)),\n    setStructuredFields: (kind, patch, options) =>\n      withLiveSyncLane(() =>\n        setDocumentStructuredFields(state, scheduleSync, kind, patch, options),\n      ),\n    setText: (value: string) =>\n      withLiveSyncLane(() => setDocumentText(state, scheduleSync, value)),\n    subscribe: (listener) => subscribeToDocumentStore(state, listener),\n    updateRowFields: (id, patch) =>\n      withLiveSyncLane(() =>\n        updateRowInDocumentStore(state, scheduleSync, id, patch),\n      ),\n    updateRuntime: (runtime: DocumentsRuntime) =>\n      updateDocumentStoreRuntime(state, runtime, scheduleSync),\n  };\n  return registerBackingStoreInternalRelink({\n    scheduleSync,\n    state,\n    store,\n    withLiveSyncLane,\n  });\n}\n\nexport function createDocumentStore(\n  localId: string,\n  initialRuntime: DocumentsRuntime,\n  persistence: DocumentsPersistence = defaultDocumentsPersistence,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  options: DocumentStoreOpenOptions = {},\n): DocumentStoreFacade {\n  return createDocumentStoreFacade(\n    createBackingDocumentStore(\n      localId,\n      initialRuntime,\n      persistence,\n      initialDocumentId,\n      initialText,\n      initialDocumentKind,\n      options,\n    ),\n  );\n}\n\nexport function getOrCreateDocumentStore(\n  domainScope: DomainScope,\n  localId: string,\n  runtime: DocumentsRuntime,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  options: DocumentStoreOpenOptions = {},\n): DocumentStore {\n  const registry = getOrCreateDocumentStoreRegistry(domainScope);\n  const existingStore = registry.storesByKey.get(\n    resolveDocumentStoreKey(registry, localId, initialDocumentId),\n  );\n  if (existingStore) {\n    registerDocumentStore(\n      domainScope,\n      localId,\n      existingStore,\n      initialDocumentId,\n    );\n    return existingStore;\n  }\n\n  const nextStore = createDocumentStore(\n    localId,\n    runtime,\n    defaultDocumentsPersistence,\n    initialDocumentId,\n    initialText,\n    initialDocumentKind,\n    options,\n  );\n  registerDocumentStore(domainScope, localId, nextStore, initialDocumentId);\n  return nextStore;\n}\n\nexport function openDocumentStore(\n  domainScope: DomainScope,\n  localId: string,\n  runtime: DocumentsRuntime,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  options: DocumentStoreOpenOptions = {},\n): DocumentStore {\n  const store = getOrCreateDocumentStore(\n    domainScope,\n    localId,\n    runtime,\n    initialDocumentId,\n    initialText,\n    initialDocumentKind,\n    options,\n  );\n  store.updateRuntime(runtime);\n  return store;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEFAULT_DOCUMENT_KIND } from \"../../../data/documents/documentConstants\";\nimport type { StoredDocumentKind } from \"../../../data/documents/documentKinds\";\nimport type { DomainScope } from \"../../../data/shared/domainScope\";\nimport {\n  createDocumentProjectionUserKeyResolver,\n  type DocumentsPersistence,\n  defaultDocumentsPersistence,\n  didDocumentProjectionKeyRuntimeChange,\n  didRegainSyncPrerequisites,\n  requestDocumentSyncLaneAndWait,\n} from \"../../../workflows/documents\";\nimport {\n  createDocumentStoreFacade,\n  emitPersistedDocument,\n  getOrCreateDocumentStoreRegistry,\n  registerDocumentStore,\n  registerDocumentStoreIdentity,\n  requestDocumentStoreSync,\n  resolveDocumentStoreKey,\n  takeRegisteredDocumentStore,\n} from \"../registry\";\nimport type {\n  DocumentAttachmentUpload,\n  DocumentStore,\n  DocumentStoreFacade,\n  DocumentStoreOpenOptions,\n  DocumentsRuntime,\n} from \"../types\";\nimport {\n  attachFilesToDocumentStore,\n  replaceAttachmentInDocumentStore,\n} from \"./attachments\";\nimport { removeAttachmentFromDocumentStore } from \"./attachments/attachmentRemoval\";\nimport { discardDocumentStoreLocalState } from \"./discard\";\nimport {\n  ensureDocumentStoreInitialized,\n  ensureDocumentStoreReady,\n  relinkDocumentStore,\n} from \"./initialization\";\nimport { assertInitialContentFitsKind } from \"./initialization/initialContent\";\nimport { registerInternalDocumentRelink } from \"./internalRelink\";\nimport { setDocumentStructuredFields, setDocumentText } from \"./mutations\";\nimport { assertDocumentStoreCanRotateContentKey } from \"./rotation\";\nimport {\n  addRowToDocumentStore,\n  removeRowFromDocumentStore,\n  updateRowInDocumentStore,\n} from \"./rows\";\nimport {\n  countQueuedWrite,\n  createDocumentStoreState,\n  type DocumentStoreState,\n  refreshAttachabilitySnapshot,\n  resetDocumentStore,\n  subscribeToDocumentStore,\n} from \"./state\";\nimport { registerDocumentStoreSyncLane } from \"./sync\";\nimport { logRevalidationScheduled } from \"./sync/remoteRevalidationTelemetry\";\nimport {\n  allowDocumentStoreRemoteSync,\n  captureDocumentStoreRemoteSyncRequestGeneration,\n  captureDocumentStoreSyncLaneGeneration,\n  type DocumentStoreRemoteSyncRequestGeneration,\n  type DocumentStoreSyncLaneGeneration,\n  didDocumentStoreRemoteSyncRequestComplete,\n  hasPendingIndependentDocumentStoreRemoteSync,\n  invalidateDocumentStoreRemoteSync,\n  invalidateDocumentStoreSyncLane,\n  isDocumentStoreRemoteSyncBlocked,\n  isDocumentStoreRemoteSyncRequestGenerationCurrent,\n  markDocumentStoreRemoteSyncPending,\n  registerDocumentStoreRemoteSyncWaiter,\n} from \"./sync/syncGeneration\";\nimport { handleDocumentRemoteEvents } from \"./sync/syncRemoteSignals\";\n\nexport {\n  discardRegisteredDocumentLocalState,\n  requestDomainDocumentSync,\n  subscribeToPersistedDocuments,\n} from \"../registry\";\n\nfunction refreshDocumentStoreSyncLane(\n  state: DocumentStoreState,\n  force = false,\n): void {\n  if (!force && state.syncLane && !state.syncLane.isDisposed?.()) {\n    return;\n  }\n  if (state.syncLane) {\n    invalidateDocumentStoreSyncLane(state);\n  }\n  let syncLaneGeneration: DocumentStoreSyncLaneGeneration | null = null;\n  state.syncLane = registerDocumentStoreSyncLane(\n    state,\n    () => syncLaneGeneration,\n  );\n  syncLaneGeneration = captureDocumentStoreSyncLaneGeneration(state);\n}\n\nfunction updateDocumentStoreRuntime(\n  state: DocumentStoreState,\n  nextRuntime: DocumentsRuntime,\n  scheduleSync: () => void,\n) {\n  const previousRuntime = state.runtime;\n  const serverEventsReconnected =\n    (nextRuntime.state.serverEventsConnectionGeneration ?? 0) >\n    (previousRuntime.state.serverEventsConnectionGeneration ?? 0);\n  const domainScopeChanged =\n    previousRuntime.state.domainScope !== nextRuntime.state.domainScope;\n  const projectionKeyRuntimeChanged = didDocumentProjectionKeyRuntimeChange(\n    previousRuntime,\n    nextRuntime,\n  );\n  if (projectionKeyRuntimeChanged) {\n    state.resolveProjectionUserKey =\n      createDocumentProjectionUserKeyResolver(nextRuntime);\n    state.writerProjection = null;\n  }\n  state.runtime = nextRuntime;\n  refreshDocumentStoreSyncLane(state, domainScopeChanged);\n  if (domainScopeChanged) {\n    state.locallyAcceptedUpdateIds = new Set();\n    state.remoteUpdatePending = false;\n    state.writerProjection = null;\n  }\n\n  if (nextRuntime.infra.dbStatus !== \"ready\") {\n    if (state.snapshot.ready || state.initialized || state.initializePromise) {\n      resetDocumentStore(state);\n    }\n    state.lastEventCount = nextRuntime.state.events.length;\n    return;\n  }\n\n  refreshAttachabilitySnapshot(state);\n  ensureDocumentStoreInitialized(state, scheduleSync);\n  handleDocumentRemoteEvents(state, scheduleSync);\n\n  if (state.snapshot.ready) {\n    if (serverEventsReconnected) {\n      // The invalidation stream is lossy while disconnected. Once the server\n      // has acknowledged this socket's authoritative interest declaration,\n      // every already-open remote document needs one HTTP probe to cover peer\n      // writes made during the gap. This also closes iOS background/resume reconnects where the\n      // native network source remained online throughout.\n      requestRemoteDocumentStoreSync(state, scheduleSync);\n      logRevalidationScheduled(state.runtime, \"reconnect\");\n    } else if (didRegainSyncPrerequisites(previousRuntime, state.runtime)) {\n      scheduleSync();\n    }\n  }\n}\n\nfunction requestRemoteDocumentStoreSync(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  owner: \"independent\" | \"waiter\" = \"independent\",\n): number {\n  allowDocumentStoreRemoteSync(state);\n  const signalSequence = markDocumentStoreRemoteSyncPending(state, owner);\n  scheduleSync();\n  return signalSequence;\n}\n\nfunction requestOrdinaryDocumentStoreSync(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n): void {\n  // A normal UI reopen is a fresh owner for remote-only work. It may recover\n  // a probe that an earlier, now-unmounted owner aborted.\n  if (isDocumentStoreRemoteSyncBlocked(state)) {\n    requestRemoteDocumentStoreSync(state, scheduleSync);\n    return;\n  }\n  scheduleSync();\n}\n\nfunction requestRemoteDocumentStoreSyncAndWait(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  signal?: AbortSignal,\n): Promise<boolean> {\n  let requestGeneration: DocumentStoreRemoteSyncRequestGeneration | null = null;\n  let requestedSignalSequence = 0;\n  let releaseWaiter: (() => boolean) | null = null;\n  const releaseRemoteSyncWaiter = (invalidate: boolean) => {\n    const releasedLastWaiter = releaseWaiter?.() ?? false;\n    if (\n      invalidate &&\n      releasedLastWaiter &&\n      requestGeneration !== null &&\n      isDocumentStoreRemoteSyncRequestGenerationCurrent(\n        state,\n        requestGeneration,\n      ) &&\n      !hasPendingIndependentDocumentStoreRemoteSync(state)\n    ) {\n      invalidateDocumentStoreRemoteSync(state);\n    }\n  };\n  // A coordinator can be disposed and recreated while this same-scope store\n  // remains registered. Refresh its handle before requesting work.\n  refreshDocumentStoreSyncLane(state);\n  return requestDocumentSyncLaneAndWait({\n    didCompleteRequest: () =>\n      requestGeneration !== null &&\n      didDocumentStoreRemoteSyncRequestComplete(\n        state,\n        requestGeneration,\n        requestedSignalSequence,\n      ),\n    domainScope: state.runtime.state.domainScope,\n    localId: state.localId,\n    request: () => {\n      requestGeneration =\n        captureDocumentStoreRemoteSyncRequestGeneration(state);\n      releaseWaiter = registerDocumentStoreRemoteSyncWaiter(\n        state,\n        requestGeneration,\n      );\n      requestedSignalSequence = requestRemoteDocumentStoreSync(\n        state,\n        scheduleSync,\n        \"waiter\",\n      );\n    },\n    onInvalidated: () => releaseRemoteSyncWaiter(true),\n    signal,\n  }).then(\n    (completed) => {\n      releaseRemoteSyncWaiter(!completed);\n      return completed;\n    },\n    (error: unknown) => {\n      releaseRemoteSyncWaiter(true);\n      throw error;\n    },\n  );\n}\n\nasync function assertBackingDocumentStoreCanRotate(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n) {\n  if (!(await ensureDocumentStoreReady(state, scheduleSync)) || !state.doc) {\n    throw new Error(\n      \"Document must finish loading before its content key can rotate\",\n    );\n  }\n  return assertDocumentStoreCanRotateContentKey(state);\n}\n\nasync function discardBackingDocumentStoreLocalState(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  expectedDocumentId: string,\n) {\n  try {\n    return await discardDocumentStoreLocalState(state, expectedDocumentId);\n  } finally {\n    // Restart hydration whenever the attempt reset the store. This runs outside\n    // its identity-chained task because initialization also chains writes.\n    ensureDocumentStoreInitialized(state, scheduleSync);\n    scheduleSync();\n  }\n}\n\nfunction createLiveSyncLaneRequest(state: DocumentStoreState) {\n  return <Result>(request: () => Result): Result => {\n    refreshDocumentStoreSyncLane(state);\n    return request();\n  };\n}\n\nfunction registerBackingStoreInternalRelink(input: {\n  scheduleSync: () => void;\n  state: DocumentStoreState;\n  store: DocumentStore;\n  withLiveSyncLane: ReturnType<typeof createLiveSyncLaneRequest>;\n}): DocumentStore {\n  registerInternalDocumentRelink(input.store, (relinkInput, commitSideEffect) =>\n    input.withLiveSyncLane(() =>\n      relinkDocumentStore(\n        input.state,\n        relinkInput,\n        input.scheduleSync,\n        commitSideEffect,\n      ),\n    ),\n  );\n  return input.store;\n}\n\nfunction createBackingStoreContext(\n  localId: string,\n  runtime: DocumentsRuntime,\n  persistence: DocumentsPersistence,\n  documentId: string | null,\n  text: string,\n  documentKind: StoredDocumentKind,\n  options: DocumentStoreOpenOptions,\n) {\n  const state = createDocumentStoreState(\n    localId,\n    runtime,\n    persistence,\n    {\n      emitPersistedDocument,\n      registerDocumentIdentity: registerDocumentStoreIdentity,\n    },\n    documentId,\n    text,\n    documentKind,\n    (options.remoteSyncMode ?? \"startup\") === \"startup\",\n  );\n  if (options.deferInitialUpdate) state.deferInitialUpdate = true;\n  const { initialRows, initialStructuredFields } = options;\n  assertInitialContentFitsKind({ initialStructuredFields }, documentKind);\n  state.initialContent = { initialRows, initialStructuredFields };\n  refreshDocumentStoreSyncLane(state);\n  const scheduleSync = () => requestDocumentStoreSync(state);\n  return {\n    scheduleSync,\n    state,\n    withLiveSyncLane: createLiveSyncLaneRequest(state),\n  };\n}\n\nfunction createBackingDocumentStore(\n  localId: string,\n  initialRuntime: DocumentsRuntime,\n  persistence: DocumentsPersistence = defaultDocumentsPersistence,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  openOptions: DocumentStoreOpenOptions = {},\n): DocumentStore {\n  const { scheduleSync, state, withLiveSyncLane } = createBackingStoreContext(\n    localId,\n    initialRuntime,\n    persistence,\n    initialDocumentId,\n    initialText,\n    initialDocumentKind,\n    openOptions,\n  );\n\n  // Local writes count as queued from the call, readiness wait included.\n  const liveWrite = <Result>(write: () => Promise<Result>) =>\n    withLiveSyncLane(() => countQueuedWrite(state, write()));\n  const store: DocumentStore = {\n    addRow: (fields) =>\n      liveWrite(() => addRowToDocumentStore(state, scheduleSync, fields)),\n    assertCanRotateContentKey: () =>\n      withLiveSyncLane(() =>\n        assertBackingDocumentStoreCanRotate(state, scheduleSync),\n      ),\n    attachFiles: (files: ReadonlyArray<DocumentAttachmentUpload>) =>\n      liveWrite(() => attachFilesToDocumentStore(state, scheduleSync, files)),\n    discardLocalState: (expectedDocumentId: string) =>\n      withLiveSyncLane(() =>\n        discardBackingDocumentStoreLocalState(\n          state,\n          scheduleSync,\n          expectedDocumentId,\n        ),\n      ),\n    ensureInitialized: () =>\n      withLiveSyncLane(() => ensureDocumentStoreReady(state, scheduleSync)),\n    getSnapshot: () => state.snapshot,\n    hasQueuedWrites: () => state.queuedWrites > 0,\n    removeAttachment: (slotId: string) =>\n      liveWrite(() =>\n        removeAttachmentFromDocumentStore(state, scheduleSync, slotId),\n      ),\n    removeRow: (id) =>\n      liveWrite(() => removeRowFromDocumentStore(state, scheduleSync, id)),\n    replaceAttachment: (slotId: string, file: DocumentAttachmentUpload) =>\n      liveWrite(() =>\n        replaceAttachmentInDocumentStore(state, scheduleSync, slotId, file),\n      ),\n    requestRemoteSync: () =>\n      withLiveSyncLane(() =>\n        requestRemoteDocumentStoreSync(state, scheduleSync),\n      ),\n    requestRemoteSyncAndWait: (signal) =>\n      requestRemoteDocumentStoreSyncAndWait(state, scheduleSync, signal),\n    requestSync: () =>\n      withLiveSyncLane(() =>\n        requestOrdinaryDocumentStoreSync(state, scheduleSync),\n      ),\n    relink: (input) =>\n      withLiveSyncLane(() => relinkDocumentStore(state, input, scheduleSync)),\n    setStructuredFields: (kind, patch, options) =>\n      liveWrite(() =>\n        setDocumentStructuredFields(state, scheduleSync, kind, patch, options),\n      ),\n    setText: (value: string) =>\n      liveWrite(() => setDocumentText(state, scheduleSync, value)),\n    subscribe: (listener) => subscribeToDocumentStore(state, listener),\n    updateRowFields: (id, patch) =>\n      liveWrite(() => updateRowInDocumentStore(state, scheduleSync, id, patch)),\n    updateRuntime: (runtime: DocumentsRuntime) =>\n      updateDocumentStoreRuntime(state, runtime, scheduleSync),\n  };\n  return registerBackingStoreInternalRelink({\n    scheduleSync,\n    state,\n    store,\n    withLiveSyncLane,\n  });\n}\n\nexport function createDocumentStore(\n  localId: string,\n  initialRuntime: DocumentsRuntime,\n  persistence: DocumentsPersistence = defaultDocumentsPersistence,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  options: DocumentStoreOpenOptions = {},\n): DocumentStoreFacade {\n  return createDocumentStoreFacade(\n    createBackingDocumentStore(\n      localId,\n      initialRuntime,\n      persistence,\n      initialDocumentId,\n      initialText,\n      initialDocumentKind,\n      options,\n    ),\n  );\n}\n\nexport function getOrCreateDocumentStore(\n  domainScope: DomainScope,\n  localId: string,\n  runtime: DocumentsRuntime,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  options: DocumentStoreOpenOptions = {},\n): DocumentStore {\n  const registry = getOrCreateDocumentStoreRegistry(domainScope);\n  const createBacking = () =>\n    createBackingDocumentStore(\n      localId,\n      runtime,\n      defaultDocumentsPersistence,\n      initialDocumentId,\n      initialText,\n      initialDocumentKind,\n      options,\n    );\n  const existingStore = takeRegisteredDocumentStore(\n    registry,\n    resolveDocumentStoreKey(registry, localId, initialDocumentId),\n    createBacking,\n  );\n  if (existingStore) {\n    registerDocumentStore(\n      domainScope,\n      localId,\n      existingStore,\n      initialDocumentId,\n    );\n    return existingStore;\n  }\n\n  const nextStore = createDocumentStoreFacade(createBacking());\n  registerDocumentStore(domainScope, localId, nextStore, initialDocumentId);\n  return nextStore;\n}\n\nexport function openDocumentStore(\n  domainScope: DomainScope,\n  localId: string,\n  runtime: DocumentsRuntime,\n  initialDocumentId: string | null = null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  options: DocumentStoreOpenOptions = {},\n): DocumentStore {\n  const store = getOrCreateDocumentStore(\n    domainScope,\n    localId,\n    runtime,\n    initialDocumentId,\n    initialText,\n    initialDocumentKind,\n    options,\n  );\n  store.updateRuntime(runtime);\n  return store;\n}\n"]}

package/stores/documents/documentStore/initialization/index.js

@@ -4,6 +4,7 @@ import { DEFAULT_DOCUMENT_ACCESS_EPOCH, DEFAULT_DOCUMENT_KIND, } from "../../../
 import { initializeStoredDocumentKind, readStoredDocumentState, } from "../../../../data/documents/documentKinds.js";
 import { createPendingUpdateFields } from "../../../../data/documents/documentSync.js";
 import { isDatabaseUnavailableError, loadPersistedDocumentStoreState, } from "../../../../workflows/documents/index.js";
+import { isPauseRemovedDocument } from "../../../../workflows/sync/index.js";
 import { chainIdentityWrite } from "../identityWriteChain.js";
 import { runDocumentOrphanMaintenance } from "../orphanMaintenance.js";
 import { advancePendingBaseVersion, documentSummaryFromRecord, persistDocument, saveDocumentRecord, } from "../persistence.js";
@@ -152,6 +153,14 @@ async function initializeDocumentStore(state, scheduleSync) {
     if (state.localWriteGeneration !== initializeGeneration) {
         return;
     }
+    // A paused organization's cleanup removed it; creating it again would
+    // download the organization's content while the pause lasts. A later open
+    // retries, so it loads once the organization resumes.
+    if (!persistedState.document &&
+        (await isPauseRemovedDocument(state.runtime.infra.execSql, state.localId))) {
+        state.initializePromise = null;
+        return;
+    }
     const restored = await restoreOrCreateInitialDocument({
         initializeGeneration,
         nextDoc,