@tearleads/client-sdk 0.1.63 → 0.1.65

package/stores/documents/documentStore/rotation/rotationProvenance.js

@@ -0,0 +1,52 @@
+import { base64ToBytes } from "../../../../internal/encoding/index.js";
+import { encodeVersionVector, exportFullHistoryIdentity, getImportBlobMetadata, importUpdates, satisfiesVersionVector, updateMatchesDocumentHistory, versionVectorsEqual, } from "../../../../internal/loro/index.js";
+function unverifiedLocalHistory(cause) {
+    return new Error("Rotation raw-history recovery found unverified local history; key rotation was not started", cause === undefined ? undefined : { cause });
+}
+function ordinaryPendingUpdateBytes(input) {
+    return input.pendingUpdates.flatMap((update) => {
+        if (update.sourceVersionVector != null)
+            return [];
+        const bytes = base64ToBytes(update.updateData);
+        const metadata = getImportBlobMetadata(bytes);
+        if (metadata.mode !== "update" ||
+            !versionVectorsEqual(metadata.partialStartVersionVector, update.partialStartVersionVector) ||
+            !versionVectorsEqual(metadata.partialEndVersionVector, update.partialEndVersionVector) ||
+            !updateMatchesDocumentHistory(input.currentDocument, bytes)) {
+            throw new Error("Ordinary pending-update provenance is inconsistent");
+        }
+        return [bytes];
+    });
+}
+export function assertExactDocumentHistory(input) {
+    const currentVersion = encodeVersionVector(input.currentDocument);
+    if (!satisfiesVersionVector(encodeVersionVector(input.rebuiltDocument), currentVersion) ||
+        exportFullHistoryIdentity(input.currentDocument) !==
+            exportFullHistoryIdentity(input.rebuiltDocument, currentVersion)) {
+        throw unverifiedLocalHistory();
+    }
+}
+/**
+ * Prove that the live history is exactly raw remote history plus queued local
+ * ordinary deltas. Deterministic operation-log comparison detects checkpoint
+ * substitutions that reuse the genuine operations' version-vector identities.
+ */
+export function importProvenOrdinaryPendingHistory(input) {
+    try {
+        const updates = ordinaryPendingUpdateBytes({
+            currentDocument: input.currentDocument,
+            pendingUpdates: input.pendingUpdates,
+        });
+        if (updates.length > 0)
+            importUpdates(input.rebuiltDocument, updates);
+        assertExactDocumentHistory(input);
+        return encodeVersionVector(input.currentDocument);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes("unverified local")) {
+            throw error;
+        }
+        throw unverifiedLocalHistory(error);
+    }
+}
+//# sourceMappingURL=rotationProvenance.js.map

package/stores/documents/documentStore/rotation/rotationProvenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotationProvenance.js","sourceRoot":"","sources":["rotationProvenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAIzB,SAAS,sBAAsB,CAAC,KAAe;IAC7C,OAAO,IAAI,KAAK,CACd,4FAA4F,EAC5F,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,KAGnC;IACC,OAAO,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7C,IAAI,MAAM,CAAC,mBAAmB,IAAI,IAAI;YAAE,OAAO,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC9C,IACE,QAAQ,CAAC,IAAI,KAAK,QAAQ;YAC1B,CAAC,mBAAmB,CAClB,QAAQ,CAAC,yBAAyB,EAClC,MAAM,CAAC,yBAAyB,CACjC;YACD,CAAC,mBAAmB,CAClB,QAAQ,CAAC,uBAAuB,EAChC,MAAM,CAAC,uBAAuB,CAC/B;YACD,CAAC,4BAA4B,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,EAC3D,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAG1C;IACC,MAAM,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClE,IACE,CAAC,sBAAsB,CACrB,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,EAC1C,cAAc,CACf;QACD,yBAAyB,CAAC,KAAK,CAAC,eAAe,CAAC;YAC9C,yBAAyB,CAAC,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,EAClE,CAAC;QACD,MAAM,sBAAsB,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAAC,KAIlD;IACC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,0BAA0B,CAAC;YACzC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,aAAa,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACtE,0BAA0B,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;AACH,CAAC","sourcesContent":["import { base64ToBytes } from \"@tearleads/encoding\";\nimport {\n  encodeVersionVector,\n  exportFullHistoryIdentity,\n  getImportBlobMetadata,\n  importUpdates,\n  satisfiesVersionVector,\n  updateMatchesDocumentHistory,\n  versionVectorsEqual,\n} from \"@tearleads/loro\";\nimport type { PendingUpdateRecord } from \"../../../../workflows/documents\";\nimport type { DocumentState } from \"../state\";\n\nfunction unverifiedLocalHistory(cause?: unknown): Error {\n  return new Error(\n    \"Rotation raw-history recovery found unverified local history; key rotation was not started\",\n    cause === undefined ? undefined : { cause },\n  );\n}\n\nfunction ordinaryPendingUpdateBytes(input: {\n  currentDocument: DocumentState;\n  pendingUpdates: readonly PendingUpdateRecord[];\n}): Uint8Array[] {\n  return input.pendingUpdates.flatMap((update) => {\n    if (update.sourceVersionVector != null) return [];\n    const bytes = base64ToBytes(update.updateData);\n    const metadata = getImportBlobMetadata(bytes);\n    if (\n      metadata.mode !== \"update\" ||\n      !versionVectorsEqual(\n        metadata.partialStartVersionVector,\n        update.partialStartVersionVector,\n      ) ||\n      !versionVectorsEqual(\n        metadata.partialEndVersionVector,\n        update.partialEndVersionVector,\n      ) ||\n      !updateMatchesDocumentHistory(input.currentDocument, bytes)\n    ) {\n      throw new Error(\"Ordinary pending-update provenance is inconsistent\");\n    }\n    return [bytes];\n  });\n}\n\nexport function assertExactDocumentHistory(input: {\n  currentDocument: DocumentState;\n  rebuiltDocument: DocumentState;\n}): void {\n  const currentVersion = encodeVersionVector(input.currentDocument);\n  if (\n    !satisfiesVersionVector(\n      encodeVersionVector(input.rebuiltDocument),\n      currentVersion,\n    ) ||\n    exportFullHistoryIdentity(input.currentDocument) !==\n      exportFullHistoryIdentity(input.rebuiltDocument, currentVersion)\n  ) {\n    throw unverifiedLocalHistory();\n  }\n}\n\n/**\n * Prove that the live history is exactly raw remote history plus queued local\n * ordinary deltas. Deterministic operation-log comparison detects checkpoint\n * substitutions that reuse the genuine operations' version-vector identities.\n */\nexport function importProvenOrdinaryPendingHistory(input: {\n  currentDocument: DocumentState;\n  pendingUpdates: readonly PendingUpdateRecord[];\n  rebuiltDocument: DocumentState;\n}): string {\n  try {\n    const updates = ordinaryPendingUpdateBytes({\n      currentDocument: input.currentDocument,\n      pendingUpdates: input.pendingUpdates,\n    });\n    if (updates.length > 0) importUpdates(input.rebuiltDocument, updates);\n    assertExactDocumentHistory(input);\n    return encodeVersionVector(input.currentDocument);\n  } catch (error) {\n    if (error instanceof Error && error.message.includes(\"unverified local\")) {\n      throw error;\n    }\n    throw unverifiedLocalHistory(error);\n  }\n}\n"]}

package/stores/documents/documentStore/rotation/rotationSettlement.js

@@ -0,0 +1,222 @@
+import { encodeVersionVector, satisfiesVersionVector } from "../../../../internal/loro/index.js";
+import { chainIdentityWrite } from "../identityWriteChain.js";
+import { listPendingUpdates, persistDocument } from "../persistence.js";
+import { invalidateDocumentStorePullContinuation } from "../sync/pullContinuationInvalidation.js";
+import { cleanupPreRegisteredUpdateIdsOnFailure, discardUnacceptedPreRegisteredUpdateIds, preRegisterMaterializedDocumentSyncUpdateIds, } from "../sync/syncAcceptedUpdateIds.js";
+import { captureDocumentStoreSyncGeneration, isDocumentStoreSyncGenerationCurrent, } from "../sync/syncGeneration.js";
+import { prepareDocumentOutgoingCoverage } from "../sync/syncOutgoingCoverage.js";
+import { requestRemoteDocumentSync } from "../sync/syncRequest.js";
+import { extendDocumentVersionCoverage } from "../sync/versionCoverage.js";
+export class RotationPendingUpdatesChangedError extends Error {
+}
+function ordinaryPendingUpdates(pendingUpdates) {
+    return pendingUpdates.filter((pendingUpdate) => pendingUpdate.sourceVersionVector == null);
+}
+function pendingUpdateSetKey(pendingUpdates) {
+    return pendingUpdates
+        .map((pendingUpdate) => pendingUpdate.id)
+        .sort()
+        .join("\n");
+}
+function pendingUpdateMatchesProvenRow(pendingUpdate, provenUpdate) {
+    return (pendingUpdate.id === provenUpdate.id &&
+        pendingUpdate.updateData === provenUpdate.updateData &&
+        pendingUpdate.partialStartVersionVector ===
+            provenUpdate.partialStartVersionVector &&
+        pendingUpdate.partialEndVersionVector ===
+            provenUpdate.partialEndVersionVector &&
+        pendingUpdate.sourceVersionVector === provenUpdate.sourceVersionVector);
+}
+function assertOrdinaryRowsWereProven(input) {
+    for (const pendingUpdate of ordinaryPendingUpdates(input.pendingUpdates)) {
+        const provenUpdate = input.provenUpdatesById.get(pendingUpdate.id);
+        if (!provenUpdate ||
+            !pendingUpdateMatchesProvenRow(pendingUpdate, provenUpdate)) {
+            throw new RotationPendingUpdatesChangedError("Document local updates changed after rotation provenance verification");
+        }
+    }
+}
+function ordinaryPendingUpdatesWithProvenCoverage(input) {
+    const ordinaryUpdates = ordinaryPendingUpdates(input.pendingUpdates);
+    const documentVersion = encodeVersionVector(input.currentDocument);
+    const ordinaryCoverage = extendDocumentVersionCoverage({
+        baseVersion: input.verifiedBaseVersion,
+        documentVersion,
+        spans: ordinaryUpdates,
+    });
+    if (!satisfiesVersionVector(ordinaryCoverage, documentVersion)) {
+        throw new Error("Document rotation cannot settle uncovered local history because it may be checkpoint-derived");
+    }
+    return { coverage: ordinaryCoverage, pendingUpdates: ordinaryUpdates };
+}
+export async function invalidatePullContinuationBeforeRotation(state) {
+    const continuation = state.pullContinuation;
+    if (!continuation)
+        return;
+    const currentDoc = state.doc;
+    const currentRecord = state.record;
+    if (!currentDoc || !currentRecord) {
+        throw new Error("Document changed while its pull continuation was invalidated for key rotation");
+    }
+    const generation = captureDocumentStoreSyncGeneration(state, currentDoc);
+    if (!generation) {
+        throw new Error("Document changed while its pull continuation was invalidated for key rotation");
+    }
+    await invalidateDocumentStorePullContinuation({
+        continuation,
+        currentRecord,
+        generation,
+        state,
+    });
+    if (state.pullContinuation !== null ||
+        !isDocumentStoreSyncGenerationCurrent(state, generation)) {
+        throw new Error("Document pull continuation could not be invalidated before key rotation");
+    }
+}
+async function persistStagedSettlement(input) {
+    const { state, syncAttempt } = input;
+    discardUnacceptedPreRegisteredUpdateIds(state, input.sentUpdateIds, syncAttempt.synced.response.acceptedOutgoingUpdateIds);
+    const persisted = await persistDocument(state, input.currentDocument, {
+        lastCommitLsn: syncAttempt.synced.response.commitLsn ??
+            input.preparedRecord.lastCommitLsn ??
+            null,
+        pullContinuation: null,
+    }, {
+        acceptedPendingUpdateIds: syncAttempt.synced.settledPendingUpdateIds,
+        expectedSyncState: {
+            pullContinuation: syncAttempt.consumedPullContinuation,
+            record: syncAttempt.requestRecord,
+        },
+        preserveSnapshotStructuredFields: true,
+        preserveSnapshotText: true,
+    }, input.generation);
+    if (!persisted ||
+        persisted.pullContinuationSuperseded ||
+        persisted.syncIdentitySuperseded ||
+        !isDocumentStoreSyncGenerationCurrent(state, input.generation)) {
+        throw new Error("Document changed while local updates were settling for key rotation");
+    }
+}
+function settledOrdinaryCoverage(input) {
+    const settled = new Set(input.settledUpdateIds);
+    return extendDocumentVersionCoverage({
+        baseVersion: input.verifiedBaseVersion,
+        documentVersion: encodeVersionVector(input.currentDocument),
+        spans: input.pendingUpdates.filter((update) => settled.has(update.id)),
+    });
+}
+async function persistStagedSettlementOnIdentityChain(input) {
+    return chainIdentityWrite(input.state, async () => {
+        if (!isDocumentStoreSyncGenerationCurrent(input.state, input.generation)) {
+            throw new Error("Document changed while local updates were settling for key rotation");
+        }
+        await persistStagedSettlement(input);
+        return settledOrdinaryCoverage({
+            currentDocument: input.currentDocument,
+            pendingUpdates: input.pendingUpdates,
+            settledUpdateIds: input.syncAttempt.synced.settledPendingUpdateIds,
+            verifiedBaseVersion: input.verifiedBaseVersion,
+        });
+    });
+}
+async function settleOrdinaryUpdatePass(input) {
+    const { state } = input;
+    const currentDoc = state.doc;
+    const currentRecord = state.record;
+    const encapsulationKeyPair = state.runtime.crypto.encapsulationKeyPair;
+    if (!currentDoc || !currentRecord || !encapsulationKeyPair) {
+        throw new Error("Document changed while local updates were settling for key rotation");
+    }
+    const generation = input.generation;
+    if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {
+        throw new Error("Document changed while local updates were settling for key rotation");
+    }
+    const proven = ordinaryPendingUpdatesWithProvenCoverage({
+        currentDocument: currentDoc,
+        pendingUpdates: input.pendingUpdates,
+        verifiedBaseVersion: input.verifiedBaseVersion,
+    });
+    const prepared = await prepareDocumentOutgoingCoverage({
+        coverageBaseVersion: input.verifiedBaseVersion,
+        currentDoc,
+        generation,
+        pendingUpdates: proven.pendingUpdates,
+        state,
+    });
+    if (!prepared || !isDocumentStoreSyncGenerationCurrent(state, generation)) {
+        throw new Error("Document changed while local updates were settling for key rotation");
+    }
+    const preparedPendingUpdates = ordinaryPendingUpdates(prepared.pendingUpdates);
+    if (preparedPendingUpdates.length === 0)
+        return proven.coverage;
+    const sentUpdateIds = [];
+    return cleanupPreRegisteredUpdateIdsOnFailure(state, sentUpdateIds, async () => {
+        const syncAttempt = await requestRemoteDocumentSync({
+            allowRecoveryBaseline: false,
+            currentDoc,
+            currentRecord: prepared.record,
+            encapsulationKeyPair,
+            generation,
+            onOutgoingUpdatesMaterialized: (updateIds) => preRegisterMaterializedDocumentSyncUpdateIds(state, sentUpdateIds, updateIds),
+            pendingUpdates: preparedPendingUpdates,
+            queuedUpdateCount: preparedPendingUpdates.length,
+            state,
+            unavailableWriterLogMessage: "Documents: rotation could not settle local updates because the writer context is unavailable.",
+        });
+        if (!syncAttempt ||
+            !isDocumentStoreSyncGenerationCurrent(state, generation)) {
+            throw new Error("Document local updates could not be committed before key rotation");
+        }
+        return persistStagedSettlementOnIdentityChain({
+            currentDocument: currentDoc,
+            generation,
+            pendingUpdates: preparedPendingUpdates,
+            preparedRecord: prepared.record,
+            sentUpdateIds,
+            state,
+            syncAttempt,
+            verifiedBaseVersion: input.verifiedBaseVersion,
+        });
+    });
+}
+/**
+ * Commit only ordinary local rows before rotation. Server-returned updates are
+ * authenticated and decrypted by the workflow but deliberately not imported
+ * or persisted; the subsequent raw rebuild owns that all-or-nothing install.
+ */
+export async function settleOrdinaryDocumentUpdatesBeforeRotation(state, verifiedBaseVersion, provenPendingUpdates, generation) {
+    const stalledQueueStates = new Set();
+    let verifiedCoverage = verifiedBaseVersion;
+    const provenUpdatesById = new Map(ordinaryPendingUpdates(provenPendingUpdates).map((update) => [
+        update.id,
+        update,
+    ]));
+    while (true) {
+        const currentDoc = state.doc;
+        if (!currentDoc) {
+            throw new Error("Document rotation requires an initialized document");
+        }
+        const allPendingUpdates = await listPendingUpdates(state);
+        assertOrdinaryRowsWereProven({
+            pendingUpdates: allPendingUpdates,
+            provenUpdatesById,
+        });
+        const pendingUpdates = ordinaryPendingUpdates(allPendingUpdates);
+        if (pendingUpdates.length === 0 &&
+            satisfiesVersionVector(verifiedCoverage, encodeVersionVector(currentDoc))) {
+            return;
+        }
+        const queueState = `${verifiedCoverage}\n${pendingUpdateSetKey(pendingUpdates)}`;
+        if (stalledQueueStates.has(queueState)) {
+            throw new Error("Document local updates could not be committed before key rotation");
+        }
+        stalledQueueStates.add(queueState);
+        verifiedCoverage = await settleOrdinaryUpdatePass({
+            generation,
+            pendingUpdates: allPendingUpdates,
+            state,
+            verifiedBaseVersion: verifiedCoverage,
+        });
+    }
+}
+//# sourceMappingURL=rotationSettlement.js.map

package/stores/documents/documentStore/rotation/rotationSettlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotationSettlement.js","sourceRoot":"","sources":["rotationSettlement.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector, satisfiesVersionVector } from \"@tearleads/loro\";\nimport type { PendingUpdateRecord } from \"../../../../workflows/documents\";\nimport { chainIdentityWrite } from \"../identityWriteChain\";\nimport { listPendingUpdates, persistDocument } from \"../persistence\";\nimport type {\n  DocumentState,\n  DocumentStoreState,\n  DocumentSyncAttempt,\n} from \"../state\";\nimport { invalidateDocumentStorePullContinuation } from \"../sync/pullContinuationInvalidation\";\nimport {\n  cleanupPreRegisteredUpdateIdsOnFailure,\n  discardUnacceptedPreRegisteredUpdateIds,\n  preRegisterMaterializedDocumentSyncUpdateIds,\n} from \"../sync/syncAcceptedUpdateIds\";\nimport {\n  captureDocumentStoreSyncGeneration,\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"../sync/syncGeneration\";\nimport { prepareDocumentOutgoingCoverage } from \"../sync/syncOutgoingCoverage\";\nimport { requestRemoteDocumentSync } from \"../sync/syncRequest\";\nimport { extendDocumentVersionCoverage } from \"../sync/versionCoverage\";\n\nexport class RotationPendingUpdatesChangedError extends Error {}\n\nfunction ordinaryPendingUpdates(\n  pendingUpdates: readonly PendingUpdateRecord[],\n): PendingUpdateRecord[] {\n  return pendingUpdates.filter(\n    (pendingUpdate) => pendingUpdate.sourceVersionVector == null,\n  );\n}\n\nfunction pendingUpdateSetKey(pendingUpdates: readonly PendingUpdateRecord[]) {\n  return pendingUpdates\n    .map((pendingUpdate) => pendingUpdate.id)\n    .sort()\n    .join(\"\\n\");\n}\n\nfunction pendingUpdateMatchesProvenRow(\n  pendingUpdate: PendingUpdateRecord,\n  provenUpdate: PendingUpdateRecord,\n): boolean {\n  return (\n    pendingUpdate.id === provenUpdate.id &&\n    pendingUpdate.updateData === provenUpdate.updateData &&\n    pendingUpdate.partialStartVersionVector ===\n      provenUpdate.partialStartVersionVector &&\n    pendingUpdate.partialEndVersionVector ===\n      provenUpdate.partialEndVersionVector &&\n    pendingUpdate.sourceVersionVector === provenUpdate.sourceVersionVector\n  );\n}\n\nfunction assertOrdinaryRowsWereProven(input: {\n  pendingUpdates: readonly PendingUpdateRecord[];\n  provenUpdatesById: ReadonlyMap<string, PendingUpdateRecord>;\n}): void {\n  for (const pendingUpdate of ordinaryPendingUpdates(input.pendingUpdates)) {\n    const provenUpdate = input.provenUpdatesById.get(pendingUpdate.id);\n    if (\n      !provenUpdate ||\n      !pendingUpdateMatchesProvenRow(pendingUpdate, provenUpdate)\n    ) {\n      throw new RotationPendingUpdatesChangedError(\n        \"Document local updates changed after rotation provenance verification\",\n      );\n    }\n  }\n}\n\nfunction ordinaryPendingUpdatesWithProvenCoverage(input: {\n  currentDocument: DocumentState;\n  pendingUpdates: PendingUpdateRecord[];\n  verifiedBaseVersion: string;\n}): { coverage: string; pendingUpdates: PendingUpdateRecord[] } {\n  const ordinaryUpdates = ordinaryPendingUpdates(input.pendingUpdates);\n  const documentVersion = encodeVersionVector(input.currentDocument);\n  const ordinaryCoverage = extendDocumentVersionCoverage({\n    baseVersion: input.verifiedBaseVersion,\n    documentVersion,\n    spans: ordinaryUpdates,\n  });\n  if (!satisfiesVersionVector(ordinaryCoverage, documentVersion)) {\n    throw new Error(\n      \"Document rotation cannot settle uncovered local history because it may be checkpoint-derived\",\n    );\n  }\n  return { coverage: ordinaryCoverage, pendingUpdates: ordinaryUpdates };\n}\n\nexport async function invalidatePullContinuationBeforeRotation(\n  state: DocumentStoreState,\n): Promise<void> {\n  const continuation = state.pullContinuation;\n  if (!continuation) return;\n  const currentDoc = state.doc;\n  const currentRecord = state.record;\n  if (!currentDoc || !currentRecord) {\n    throw new Error(\n      \"Document changed while its pull continuation was invalidated for key rotation\",\n    );\n  }\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation) {\n    throw new Error(\n      \"Document changed while its pull continuation was invalidated for key rotation\",\n    );\n  }\n  await invalidateDocumentStorePullContinuation({\n    continuation,\n    currentRecord,\n    generation,\n    state,\n  });\n  if (\n    state.pullContinuation !== null ||\n    !isDocumentStoreSyncGenerationCurrent(state, generation)\n  ) {\n    throw new Error(\n      \"Document pull continuation could not be invalidated before key rotation\",\n    );\n  }\n}\n\nasync function persistStagedSettlement(input: {\n  currentDocument: DocumentState;\n  generation: DocumentStoreSyncGeneration;\n  preparedRecord: NonNullable<DocumentStoreState[\"record\"]>;\n  sentUpdateIds: string[];\n  state: DocumentStoreState;\n  syncAttempt: DocumentSyncAttempt;\n}): Promise<void> {\n  const { state, syncAttempt } = input;\n  discardUnacceptedPreRegisteredUpdateIds(\n    state,\n    input.sentUpdateIds,\n    syncAttempt.synced.response.acceptedOutgoingUpdateIds,\n  );\n  const persisted = await persistDocument(\n    state,\n    input.currentDocument,\n    {\n      lastCommitLsn:\n        syncAttempt.synced.response.commitLsn ??\n        input.preparedRecord.lastCommitLsn ??\n        null,\n      pullContinuation: null,\n    },\n    {\n      acceptedPendingUpdateIds: syncAttempt.synced.settledPendingUpdateIds,\n      expectedSyncState: {\n        pullContinuation: syncAttempt.consumedPullContinuation,\n        record: syncAttempt.requestRecord,\n      },\n      preserveSnapshotStructuredFields: true,\n      preserveSnapshotText: true,\n    },\n    input.generation,\n  );\n  if (\n    !persisted ||\n    persisted.pullContinuationSuperseded ||\n    persisted.syncIdentitySuperseded ||\n    !isDocumentStoreSyncGenerationCurrent(state, input.generation)\n  ) {\n    throw new Error(\n      \"Document changed while local updates were settling for key rotation\",\n    );\n  }\n}\n\nfunction settledOrdinaryCoverage(input: {\n  currentDocument: DocumentState;\n  pendingUpdates: PendingUpdateRecord[];\n  settledUpdateIds: readonly string[];\n  verifiedBaseVersion: string;\n}): string {\n  const settled = new Set(input.settledUpdateIds);\n  return extendDocumentVersionCoverage({\n    baseVersion: input.verifiedBaseVersion,\n    documentVersion: encodeVersionVector(input.currentDocument),\n    spans: input.pendingUpdates.filter((update) => settled.has(update.id)),\n  });\n}\n\nasync function persistStagedSettlementOnIdentityChain(input: {\n  currentDocument: DocumentState;\n  generation: DocumentStoreSyncGeneration;\n  pendingUpdates: PendingUpdateRecord[];\n  preparedRecord: NonNullable<DocumentStoreState[\"record\"]>;\n  sentUpdateIds: string[];\n  state: DocumentStoreState;\n  syncAttempt: DocumentSyncAttempt;\n  verifiedBaseVersion: string;\n}): Promise<string> {\n  return chainIdentityWrite(input.state, async () => {\n    if (!isDocumentStoreSyncGenerationCurrent(input.state, input.generation)) {\n      throw new Error(\n        \"Document changed while local updates were settling for key rotation\",\n      );\n    }\n    await persistStagedSettlement(input);\n    return settledOrdinaryCoverage({\n      currentDocument: input.currentDocument,\n      pendingUpdates: input.pendingUpdates,\n      settledUpdateIds: input.syncAttempt.synced.settledPendingUpdateIds,\n      verifiedBaseVersion: input.verifiedBaseVersion,\n    });\n  });\n}\n\nasync function settleOrdinaryUpdatePass(input: {\n  generation: DocumentStoreSyncGeneration;\n  pendingUpdates: PendingUpdateRecord[];\n  state: DocumentStoreState;\n  verifiedBaseVersion: string;\n}): Promise<string> {\n  const { state } = input;\n  const currentDoc = state.doc;\n  const currentRecord = state.record;\n  const encapsulationKeyPair = state.runtime.crypto.encapsulationKeyPair;\n  if (!currentDoc || !currentRecord || !encapsulationKeyPair) {\n    throw new Error(\n      \"Document changed while local updates were settling for key rotation\",\n    );\n  }\n  const generation = input.generation;\n  if (!isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    throw new Error(\n      \"Document changed while local updates were settling for key rotation\",\n    );\n  }\n  const proven = ordinaryPendingUpdatesWithProvenCoverage({\n    currentDocument: currentDoc,\n    pendingUpdates: input.pendingUpdates,\n    verifiedBaseVersion: input.verifiedBaseVersion,\n  });\n  const prepared = await prepareDocumentOutgoingCoverage({\n    coverageBaseVersion: input.verifiedBaseVersion,\n    currentDoc,\n    generation,\n    pendingUpdates: proven.pendingUpdates,\n    state,\n  });\n  if (!prepared || !isDocumentStoreSyncGenerationCurrent(state, generation)) {\n    throw new Error(\n      \"Document changed while local updates were settling for key rotation\",\n    );\n  }\n  const preparedPendingUpdates = ordinaryPendingUpdates(\n    prepared.pendingUpdates,\n  );\n  if (preparedPendingUpdates.length === 0) return proven.coverage;\n\n  const sentUpdateIds: string[] = [];\n  return cleanupPreRegisteredUpdateIdsOnFailure(\n    state,\n    sentUpdateIds,\n    async () => {\n      const syncAttempt = await requestRemoteDocumentSync({\n        allowRecoveryBaseline: false,\n        currentDoc,\n        currentRecord: prepared.record,\n        encapsulationKeyPair,\n        generation,\n        onOutgoingUpdatesMaterialized: (updateIds) =>\n          preRegisterMaterializedDocumentSyncUpdateIds(\n            state,\n            sentUpdateIds,\n            updateIds,\n          ),\n        pendingUpdates: preparedPendingUpdates,\n        queuedUpdateCount: preparedPendingUpdates.length,\n        state,\n        unavailableWriterLogMessage:\n          \"Documents: rotation could not settle local updates because the writer context is unavailable.\",\n      });\n      if (\n        !syncAttempt ||\n        !isDocumentStoreSyncGenerationCurrent(state, generation)\n      ) {\n        throw new Error(\n          \"Document local updates could not be committed before key rotation\",\n        );\n      }\n\n      return persistStagedSettlementOnIdentityChain({\n        currentDocument: currentDoc,\n        generation,\n        pendingUpdates: preparedPendingUpdates,\n        preparedRecord: prepared.record,\n        sentUpdateIds,\n        state,\n        syncAttempt,\n        verifiedBaseVersion: input.verifiedBaseVersion,\n      });\n    },\n  );\n}\n\n/**\n * Commit only ordinary local rows before rotation. Server-returned updates are\n * authenticated and decrypted by the workflow but deliberately not imported\n * or persisted; the subsequent raw rebuild owns that all-or-nothing install.\n */\nexport async function settleOrdinaryDocumentUpdatesBeforeRotation(\n  state: DocumentStoreState,\n  verifiedBaseVersion: string,\n  provenPendingUpdates: readonly PendingUpdateRecord[],\n  generation: DocumentStoreSyncGeneration,\n): Promise<void> {\n  const stalledQueueStates = new Set<string>();\n  let verifiedCoverage = verifiedBaseVersion;\n  const provenUpdatesById = new Map(\n    ordinaryPendingUpdates(provenPendingUpdates).map((update) => [\n      update.id,\n      update,\n    ]),\n  );\n\n  while (true) {\n    const currentDoc = state.doc;\n    if (!currentDoc) {\n      throw new Error(\"Document rotation requires an initialized document\");\n    }\n    const allPendingUpdates = await listPendingUpdates(state);\n    assertOrdinaryRowsWereProven({\n      pendingUpdates: allPendingUpdates,\n      provenUpdatesById,\n    });\n    const pendingUpdates = ordinaryPendingUpdates(allPendingUpdates);\n    if (\n      pendingUpdates.length === 0 &&\n      satisfiesVersionVector(verifiedCoverage, encodeVersionVector(currentDoc))\n    ) {\n      return;\n    }\n\n    const queueState = `${verifiedCoverage}\\n${pendingUpdateSetKey(pendingUpdates)}`;\n    if (stalledQueueStates.has(queueState)) {\n      throw new Error(\n        \"Document local updates could not be committed before key rotation\",\n      );\n    }\n    stalledQueueStates.add(queueState);\n    verifiedCoverage = await settleOrdinaryUpdatePass({\n      generation,\n      pendingUpdates: allPendingUpdates,\n      state,\n      verifiedBaseVersion: verifiedCoverage,\n    });\n  }\n}\n"]}

package/stores/documents/documentStore/rows.js

@@ -3,12 +3,12 @@ import { addDocumentRow, createDocumentRowId, removeDocumentRow, setDocumentRowF
 import { createPendingUpdateFields } from "../../../data/documents/documentSync.js";
 import { resolveDocumentCreateAuthor } from "../../../workflows/documents/index.js";
 import { requestDocumentStoreSync } from "../registry.js";
-import { ensureDocumentStoreReady } from "./initialization.js";
+import { ensureDocumentStoreReady } from "./initialization/index.js";
 import { revalidateDocumentMutationIdentity } from "./mutationIdentityRevalidation.js";
 import { advancePendingBaseVersion, pendingDeltaSinceBase, persistDocument, } from "./persistence.js";
 import { reportDocumentStoreWriteFailure } from "./reportWriteFailure.js";
 import { canWriteDocument, } from "./state.js";
-import { captureDocumentStoreSyncGeneration, isDocumentStoreSyncGenerationCurrent, } from "./syncGeneration.js";
+import { captureDocumentStoreSyncGeneration, isDocumentStoreSyncGenerationCurrent, } from "./sync/syncGeneration.js";
 // Fixed literal: a reported message must never carry row ids or field values.
 const ROW_FAILURE_MESSAGE = "Documents: row mutation failed";
 // Stamp each row write with the local signing identity (or "" when

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

@@ -1 +1 @@
-{"version":3,"file":"rows.js","sourceRoot":"","sources":["rows.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport {\n  addDocumentRow,\n  createDocumentRowId,\n  type DocumentRowAttribution,\n  removeDocumentRow,\n  setDocumentRowFields,\n} from \"../../../data/documents/documentRowList\";\nimport { createPendingUpdateFields } from \"../../../data/documents/documentSync\";\nimport { resolveDocumentCreateAuthor } from \"../../../workflows/documents\";\nimport { requestDocumentStoreSync } from \"../registry\";\nimport { ensureDocumentStoreReady } from \"./initialization\";\nimport { revalidateDocumentMutationIdentity } from \"./mutationIdentityRevalidation\";\nimport {\n  advancePendingBaseVersion,\n  pendingDeltaSinceBase,\n  persistDocument,\n} from \"./persistence\";\nimport { reportDocumentStoreWriteFailure } from \"./reportWriteFailure\";\nimport {\n  canWriteDocument,\n  type DocumentState,\n  type DocumentStoreState,\n} from \"./state\";\nimport {\n  captureDocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\n\n// Fixed literal: a reported message must never carry row ids or field values.\nconst ROW_FAILURE_MESSAGE = \"Documents: row mutation failed\";\n\n// Stamp each row write with the local signing identity (or \"\" when\n// unauthenticated) and an ISO timestamp, matching the keys the edit-attribution\n// layer resolves against.\nfunction resolveRowAttribution(\n  state: DocumentStoreState,\n): DocumentRowAttribution {\n  return {\n    at: new Date().toISOString(),\n    userId: resolveDocumentCreateAuthor(state.runtime)?.signerUserId ?? \"\",\n  };\n}\n\nasync function persistRowMutation(\n  state: DocumentStoreState,\n  expectedLocalWriteGeneration: number,\n  mutate: (doc: DocumentState) => boolean,\n): Promise<void> {\n  if (state.localWriteGeneration !== expectedLocalWriteGeneration) {\n    return;\n  }\n  const currentDoc = state.doc;\n  if (!currentDoc || !canWriteDocument(state)) {\n    return;\n  }\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation) {\n    return;\n  }\n\n  if (!mutate(currentDoc)) {\n    await revalidateDocumentMutationIdentity({ currentDoc, generation, state });\n    return;\n  }\n\n  const update = pendingDeltaSinceBase(state, currentDoc);\n  if (update.byteLength === 0) {\n    await revalidateDocumentMutationIdentity({ currentDoc, generation, state });\n    return;\n  }\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  const pendingUpdate = createPendingUpdateFields(update);\n  if (!pendingUpdate) {\n    await revalidateDocumentMutationIdentity({ currentDoc, generation, state });\n    return;\n  }\n  // Row writes change neither prose nor structured fields; setReadySnapshot\n  // always re-derives rows from the doc, so preserve the text/structured fields\n  // in case this write overlaps an in-flight keystroke elsewhere.\n  const persisted = await persistDocument(\n    state,\n    currentDoc,\n    { snapshotEndVersion: coveredVersion },\n    {\n      pendingUpdate,\n      preserveSnapshotStructuredFields: true,\n      preserveSnapshotText: true,\n    },\n    generation,\n  );\n  if (\n    !persisted ||\n    persisted.pullContinuationSuperseded ||\n    persisted.syncIdentitySuperseded ||\n    !isDocumentStoreSyncGenerationCurrent(state, generation)\n  ) {\n    // Refused: the document was deleted while this persist was queued\n    // and the store is cleared — no state advance, no sync request.\n    return;\n  }\n  advancePendingBaseVersion(state, currentDoc);\n  requestDocumentStoreSync(state);\n}\n\nfunction queueRowMutation(\n  state: DocumentStoreState,\n  mutate: (doc: DocumentState) => boolean,\n): Promise<void> {\n  const writeGeneration = state.localWriteGeneration;\n  // Unlike text/structured-field writes, row writes intentionally do NOT bump\n  // `state.pendingLocalWrites`: rows are never in the optimistic-preserve set —\n  // `setReadySnapshot` always re-derives them from the doc — so there is no\n  // optimistic snapshot for a concurrent sync pass to clobber. Input smoothness\n  // during rapid edits is handled in the app layer (useDocumentRowEditing).\n  state.writeChain = state.writeChain\n    .catch(() => undefined)\n    .then(async () => persistRowMutation(state, writeGeneration, mutate))\n    .catch((error: unknown) => {\n      reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    });\n  return state.writeChain;\n}\n\nexport async function addRowToDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  fields: Readonly<Record<string, string>>,\n): Promise<string> {\n  const id = createDocumentRowId();\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    return id;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return id;\n  }\n\n  await queueRowMutation(state, (doc) => {\n    addDocumentRow(doc, id, fields, resolveRowAttribution(state));\n    return true;\n  });\n  return id;\n}\n\nexport async function updateRowInDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  id: string,\n  patch: Readonly<Record<string, string>>,\n): Promise<void> {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    return;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return;\n  }\n\n  await queueRowMutation(state, (doc) =>\n    setDocumentRowFields(doc, id, patch, resolveRowAttribution(state)),\n  );\n}\n\nexport async function removeRowFromDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  id: string,\n): Promise<void> {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    return;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return;\n  }\n\n  await queueRowMutation(state, (doc) => removeDocumentRow(doc, id));\n}\n"]}
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["rows.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeVersionVector } from \"@tearleads/loro\";\nimport {\n  addDocumentRow,\n  createDocumentRowId,\n  type DocumentRowAttribution,\n  removeDocumentRow,\n  setDocumentRowFields,\n} from \"../../../data/documents/documentRowList\";\nimport { createPendingUpdateFields } from \"../../../data/documents/documentSync\";\nimport { resolveDocumentCreateAuthor } from \"../../../workflows/documents\";\nimport { requestDocumentStoreSync } from \"../registry\";\nimport { ensureDocumentStoreReady } from \"./initialization\";\nimport { revalidateDocumentMutationIdentity } from \"./mutationIdentityRevalidation\";\nimport {\n  advancePendingBaseVersion,\n  pendingDeltaSinceBase,\n  persistDocument,\n} from \"./persistence\";\nimport { reportDocumentStoreWriteFailure } from \"./reportWriteFailure\";\nimport {\n  canWriteDocument,\n  type DocumentState,\n  type DocumentStoreState,\n} from \"./state\";\nimport {\n  captureDocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./sync/syncGeneration\";\n\n// Fixed literal: a reported message must never carry row ids or field values.\nconst ROW_FAILURE_MESSAGE = \"Documents: row mutation failed\";\n\n// Stamp each row write with the local signing identity (or \"\" when\n// unauthenticated) and an ISO timestamp, matching the keys the edit-attribution\n// layer resolves against.\nfunction resolveRowAttribution(\n  state: DocumentStoreState,\n): DocumentRowAttribution {\n  return {\n    at: new Date().toISOString(),\n    userId: resolveDocumentCreateAuthor(state.runtime)?.signerUserId ?? \"\",\n  };\n}\n\nasync function persistRowMutation(\n  state: DocumentStoreState,\n  expectedLocalWriteGeneration: number,\n  mutate: (doc: DocumentState) => boolean,\n): Promise<void> {\n  if (state.localWriteGeneration !== expectedLocalWriteGeneration) {\n    return;\n  }\n  const currentDoc = state.doc;\n  if (!currentDoc || !canWriteDocument(state)) {\n    return;\n  }\n  const generation = captureDocumentStoreSyncGeneration(state, currentDoc);\n  if (!generation) {\n    return;\n  }\n\n  if (!mutate(currentDoc)) {\n    await revalidateDocumentMutationIdentity({ currentDoc, generation, state });\n    return;\n  }\n\n  const update = pendingDeltaSinceBase(state, currentDoc);\n  if (update.byteLength === 0) {\n    await revalidateDocumentMutationIdentity({ currentDoc, generation, state });\n    return;\n  }\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  const pendingUpdate = createPendingUpdateFields(update);\n  if (!pendingUpdate) {\n    await revalidateDocumentMutationIdentity({ currentDoc, generation, state });\n    return;\n  }\n  // Row writes change neither prose nor structured fields; setReadySnapshot\n  // always re-derives rows from the doc, so preserve the text/structured fields\n  // in case this write overlaps an in-flight keystroke elsewhere.\n  const persisted = await persistDocument(\n    state,\n    currentDoc,\n    { snapshotEndVersion: coveredVersion },\n    {\n      pendingUpdate,\n      preserveSnapshotStructuredFields: true,\n      preserveSnapshotText: true,\n    },\n    generation,\n  );\n  if (\n    !persisted ||\n    persisted.pullContinuationSuperseded ||\n    persisted.syncIdentitySuperseded ||\n    !isDocumentStoreSyncGenerationCurrent(state, generation)\n  ) {\n    // Refused: the document was deleted while this persist was queued\n    // and the store is cleared — no state advance, no sync request.\n    return;\n  }\n  advancePendingBaseVersion(state, currentDoc);\n  requestDocumentStoreSync(state);\n}\n\nfunction queueRowMutation(\n  state: DocumentStoreState,\n  mutate: (doc: DocumentState) => boolean,\n): Promise<void> {\n  const writeGeneration = state.localWriteGeneration;\n  // Unlike text/structured-field writes, row writes intentionally do NOT bump\n  // `state.pendingLocalWrites`: rows are never in the optimistic-preserve set —\n  // `setReadySnapshot` always re-derives them from the doc — so there is no\n  // optimistic snapshot for a concurrent sync pass to clobber. Input smoothness\n  // during rapid edits is handled in the app layer (useDocumentRowEditing).\n  state.writeChain = state.writeChain\n    .catch(() => undefined)\n    .then(async () => persistRowMutation(state, writeGeneration, mutate))\n    .catch((error: unknown) => {\n      reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    });\n  return state.writeChain;\n}\n\nexport async function addRowToDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  fields: Readonly<Record<string, string>>,\n): Promise<string> {\n  const id = createDocumentRowId();\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    return id;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return id;\n  }\n\n  await queueRowMutation(state, (doc) => {\n    addDocumentRow(doc, id, fields, resolveRowAttribution(state));\n    return true;\n  });\n  return id;\n}\n\nexport async function updateRowInDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  id: string,\n  patch: Readonly<Record<string, string>>,\n): Promise<void> {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    return;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return;\n  }\n\n  await queueRowMutation(state, (doc) =>\n    setDocumentRowFields(doc, id, patch, resolveRowAttribution(state)),\n  );\n}\n\nexport async function removeRowFromDocumentStore(\n  state: DocumentStoreState,\n  scheduleSync: () => void,\n  id: string,\n): Promise<void> {\n  let ready: boolean;\n  try {\n    ready = await ensureDocumentStoreReady(state, scheduleSync);\n  } catch (error) {\n    reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);\n    return;\n  }\n\n  if (!ready || !state.doc || !canWriteDocument(state)) {\n    return;\n  }\n\n  await queueRowMutation(state, (doc) => removeDocumentRow(doc, id));\n}\n"]}

package/stores/documents/documentStore/state.js

@@ -4,7 +4,7 @@ import { projectStoredDocumentState, readStoredDocumentState, } from "../../../d
 import { listDocumentRows, sameDocumentRows, } from "../../../data/documents/documentRowList.js";
 import { canWriteEffectiveAccessLevel, normalizeEffectiveAccessLevel, } from "../../../data/keying/accessLevel.js";
 import { createDocumentProjectionUserKeyResolver, resolveDocumentCreateAuthor, } from "../../../workflows/documents/index.js";
-import { getAttachmentStatuses, getAttachmentStorageKeys, } from "./attachmentSnapshot.js";
+import { getAttachmentStatuses, getAttachmentStorageKeys, } from "./attachments/attachmentSnapshot.js";
 const EMPTY_DOCUMENT_SNAPSHOT = {
     attachments: [],
     attachmentStatusBySlotId: {},

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

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { createDocument } from \"@tearleads/loro\";\nimport type { DocumentWriterProjectionResponse } from \"@tearleads/validators/response\";\nimport { DEFAULT_DOCUMENT_KIND } from \"../../../data/documents/documentConstants\";\nimport {\n  type DocumentAttachment,\n  getDocumentAttachments,\n  sameDocumentAttachments,\n} from \"../../../data/documents/documentContent\";\nimport {\n  projectStoredDocumentState,\n  readStoredDocumentState,\n  type StoredDocumentKind,\n} from \"../../../data/documents/documentKinds\";\nimport {\n  type DocumentRow,\n  listDocumentRows,\n  sameDocumentRows,\n} from \"../../../data/documents/documentRowList\";\nimport type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport type { DocumentSyncPullContinuation } from \"../../../data/documents/shared/syncPagination\";\nimport type { SyncRemoteDocumentResult } from \"../../../data/documents/shared/types\";\nimport {\n  canWriteEffectiveAccessLevel,\n  normalizeEffectiveAccessLevel,\n} from \"../../../data/keying/accessLevel\";\nimport type { DomainScope } from \"../../../data/shared/domainScope\";\nimport {\n  type AttachmentRemovalRows,\n  type AttachmentStagingRows,\n  createDocumentProjectionUserKeyResolver,\n  type DocumentProjectionUserKeyResolver,\n  type DocumentRecord,\n  type DocumentSyncLane,\n  type DocumentsPersistence,\n  type PendingAttachmentRecord,\n  type PendingUpdateInsert,\n  resolveDocumentCreateAuthor,\n} from \"../../../workflows/documents\";\nimport type { DocumentSnapshot, DocumentsRuntime } from \"../types\";\nimport {\n  getAttachmentStatuses,\n  getAttachmentStorageKeys,\n} from \"./attachmentSnapshot\";\nexport type DocumentState = Awaited<ReturnType<typeof createDocument>>;\nexport type EncapsulationKeyPair = NonNullable<\n  DocumentsRuntime[\"crypto\"][\"encapsulationKeyPair\"]\n>;\nexport type DocumentAttachmentBinding = NonNullable<\n  Awaited<ReturnType<DocumentsRuntime[\"apiClient\"][\"listDocumentAttachments\"]>>\n>[number];\nexport type PendingMutationSyncResult = {\n  completed: boolean;\n  nextRecord: DocumentRecord;\n};\nexport interface PersistedDocumentRecord {\n  creationSuperseded?: true;\n  historyRestoreState?:\n    | Awaited<ReturnType<DocumentsPersistence[\"loadHistoryRestoreState\"]>>\n    | undefined;\n  pullContinuationSuperseded?: true;\n  record: DocumentRecord;\n  syncIdentitySuperseded?: true;\n  updatedAt?: string | undefined;\n}\nexport interface SaveDocumentRecordOptions {\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  attachmentRemoval?: AttachmentRemovalRows | undefined;\n  attachmentStaging?: AttachmentStagingRows | undefined;\n  clearSyncFailure?: boolean | undefined;\n  expectedSyncState?:\n    | {\n        pullContinuation: DocumentSyncPullContinuation | null;\n        record: DocumentRecord;\n      }\n    | undefined;\n  historyCheckpoint?:\n    | {\n        coveredTailIds: readonly string[];\n        endVersionVector: string;\n        pruneCoveredLocalState: boolean;\n        snapshot: string;\n      }\n    | undefined;\n  historyUpdateOrigin?: \"local\" | \"remote\" | undefined;\n  historyUpdates?: readonly string[] | undefined;\n  pendingUpdate?: Omit<PendingUpdateInsert, \"localId\"> | undefined;\n  pendingBaseVersionOverride?: string | null | undefined;\n  preserveSnapshotStructuredFields?: boolean | undefined;\n  preserveSnapshotText?: boolean | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n}\nexport interface DocumentSyncAttempt {\n  consumedPullContinuation: DocumentSyncPullContinuation | null;\n  outgoingUpdateCount: number;\n  requestRecord: DocumentRecord;\n  synced: SyncRemoteDocumentResult;\n  /** `writerProjectionGeneration` when the request left; gates the install. */\n  writerProjectionGeneration: number;\n}\nexport interface DocumentStorePersistenceEffects {\n  emitPersistedDocument: (\n    domainScope: DomainScope,\n    persistedDocument: DocumentSummary,\n    placementChanged?: boolean | undefined,\n  ) => void;\n  registerDocumentIdentity: (\n    domainScope: DomainScope,\n    localId: string,\n    documentId: string | null,\n  ) => void;\n}\nexport interface DocumentStoreState {\n  attachmentBlobIdBySlotId: Record<string, string | null>;\n  /** Plaintext digest of the held bytes per slot; see `getAttachmentStatuses`. */\n  attachmentContentSha256BySlotId: Record<string, string>;\n  attachmentStorageKeyBySlotId: Record<string, string>;\n  /** Creation's birth rides the first attach; see `deferredInitialUpdate.ts`. */\n  deferInitialUpdate?: boolean;\n  doc: DocumentState | null;\n  effects: DocumentStorePersistenceEffects;\n  initialDocumentId: string | null;\n  initialDocumentKind: StoredDocumentKind;\n  initialText: string;\n  initializePromise: Promise<void> | null;\n  initialized: boolean;\n  lastEventCount: number;\n  /** Invalidates queued local-write closures when this store is cleared. */\n  localWriteGeneration: number;\n  locallyAcceptedUpdateIds: Set<string>;\n  localId: string;\n  listeners: Set<() => void>;\n  pendingAttachments: PendingAttachmentRecord[];\n  /**\n   * Oplog version through which every op in `doc` is already durably enqueued as\n   * a pending update or synced from a remote peer. It advances only after an\n   * edit's enqueue+persist succeeds, so a later edit can recover any orphaned\n   * delta left by a failed write instead of silently dropping it from sync.\n   * `null` only before initialization sets it to the loaded doc's version.\n   */\n  pendingBaseVersion: string | null;\n  /**\n   * Local text/structured writes queued on `writeChain` but not yet drained.\n   * While positive, sync MUST preserve the optimistic text/fields because `doc`\n   * can lag the latest keystroke. Remote merges remain in `doc` and publish when\n   * the final write settles.\n   */\n  pendingLocalWrites: number;\n  persistence: DocumentsPersistence;\n  /**\n   * Durable continuation for a bounded remote pull, mirrored from the document\n   * record so the live lane can advance it without re-reading SQLite.\n   */\n  pullContinuation: DocumentSyncPullContinuation | null;\n  record: DocumentRecord | null;\n  /** Served bindings hydration refused for a held copy; see `hydrate.ts`. */\n  rejectedServedAttachmentBindings: Set<string>;\n  /**\n   * Consecutive completed sync passes that re-keyed conflicted pending updates\n   * without settling anything. Bounds the rekey-driven self re-arm so a server\n   * that keeps conflicting fresh ids cannot drive a network-speed loop; see\n   * shouldReArmAfterOutgoingSettlement.\n   */\n  rekeyOnlyPassCount: number;\n  resolveProjectionUserKey: DocumentProjectionUserKeyResolver;\n  /** Latest remote-update sequence durably applied by a completed probe. */\n  remoteUpdateCompletedSignalSeq: number;\n  /** A cancelled remote-only owner blocks late responses until fresh work. */\n  remoteSyncBlocked: boolean;\n  scheduleStartupRemoteSync: boolean;\n  remoteUpdatePending: boolean;\n  /** Sequence used to keep an older pass from clearing a newer remote event. */\n  remoteUpdateSignalSeq: number;\n  runtime: DocumentsRuntime;\n  snapshot: DocumentSnapshot;\n  syncLane: DocumentSyncLane | null;\n  /** Parked behind another member's ancestor repair; a path hint re-runs. */\n  awaitingAncestorRepair: boolean;\n  writeChain: Promise<void>;\n  writerProjection: DocumentWriterProjectionResponse | null;\n  /**\n   * Bumped whenever a realtime hint drops `writerProjection`; an operation that\n   * fetched or was handed a projection installs it only if this is unchanged\n   * since it started, so a pre-hint answer never lands after the hint.\n   */\n  writerProjectionGeneration: number;\n}\nconst EMPTY_DOCUMENT_SNAPSHOT: DocumentSnapshot = {\n  attachments: [],\n  attachmentStatusBySlotId: {},\n  attachmentStorageKeyBySlotId: {},\n  canAttach: false,\n  canWrite: true,\n  currentAuthorId: null,\n  documentId: null,\n  documentKind: DEFAULT_DOCUMENT_KIND,\n  effectiveAccessLevel: \"admin\",\n  fieldValidationIssues: [],\n  ready: false,\n  rows: [],\n  structuredFields: {},\n  text: \"\",\n  title: \"\",\n  syncing: false,\n};\nfunction shallowEqualRecord<Value>(\n  left: Readonly<Record<string, Value>>,\n  right: Readonly<Record<string, Value>>,\n): boolean {\n  let leftKeyCount = 0;\n  for (const key in left) {\n    if (!Object.hasOwn(left, key)) continue;\n\n    leftKeyCount += 1;\n    if (!Object.hasOwn(right, key) || !Object.is(left[key], right[key])) {\n      return false;\n    }\n  }\n\n  let rightKeyCount = 0;\n  for (const key in right) {\n    if (Object.hasOwn(right, key)) {\n      rightKeyCount += 1;\n    }\n  }\n\n  return leftKeyCount === rightKeyCount;\n}\n\nfunction sameValidationIssues(\n  left: DocumentSnapshot[\"fieldValidationIssues\"],\n  right: DocumentSnapshot[\"fieldValidationIssues\"],\n): boolean {\n  return (\n    left.length === right.length &&\n    left.every((issue, index) => {\n      const nextIssue = right[index];\n      return (\n        nextIssue !== undefined &&\n        issue.field === nextIssue.field &&\n        issue.message === nextIssue.message &&\n        Object.is(issue.value, nextIssue.value)\n      );\n    })\n  );\n}\n\nexport function createDocumentStoreState(\n  localId: string,\n  initialRuntime: DocumentsRuntime,\n  persistence: DocumentsPersistence,\n  effects: DocumentStorePersistenceEffects,\n  initialDocumentId: string | null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  scheduleStartupRemoteSync = true,\n): DocumentStoreState {\n  return {\n    attachmentBlobIdBySlotId: {},\n    attachmentContentSha256BySlotId: {},\n    attachmentStorageKeyBySlotId: {},\n    doc: null,\n    effects,\n    initialDocumentId,\n    initialDocumentKind,\n    initialText,\n    initializePromise: null,\n    initialized: false,\n    lastEventCount: 0,\n    localWriteGeneration: 0,\n    locallyAcceptedUpdateIds: new Set(),\n    localId,\n    listeners: new Set(),\n    pendingAttachments: [],\n    pendingBaseVersion: null,\n    pendingLocalWrites: 0,\n    persistence,\n    pullContinuation: null,\n    record: null,\n    rejectedServedAttachmentBindings: new Set(),\n    rekeyOnlyPassCount: 0,\n    resolveProjectionUserKey:\n      createDocumentProjectionUserKeyResolver(initialRuntime),\n    remoteUpdateCompletedSignalSeq: 0,\n    remoteSyncBlocked: !scheduleStartupRemoteSync,\n    scheduleStartupRemoteSync,\n    awaitingAncestorRepair: false,\n    remoteUpdatePending: false,\n    remoteUpdateSignalSeq: 0,\n    runtime: initialRuntime,\n    snapshot: { ...EMPTY_DOCUMENT_SNAPSHOT },\n    syncLane: null,\n    writeChain: Promise.resolve(),\n    writerProjection: null,\n    writerProjectionGeneration: 0,\n  };\n}\n\nfunction emitDocumentStore(state: DocumentStoreState) {\n  for (const listener of state.listeners) {\n    listener();\n  }\n}\n\nexport function setDocumentSnapshot(\n  state: DocumentStoreState,\n  next: DocumentSnapshot,\n) {\n  if (\n    sameDocumentAttachments(state.snapshot.attachments, next.attachments) &&\n    shallowEqualRecord(\n      state.snapshot.attachmentStatusBySlotId,\n      next.attachmentStatusBySlotId,\n    ) &&\n    shallowEqualRecord(\n      state.snapshot.attachmentStorageKeyBySlotId,\n      next.attachmentStorageKeyBySlotId,\n    ) &&\n    state.snapshot.canAttach === next.canAttach &&\n    state.snapshot.canWrite === next.canWrite &&\n    state.snapshot.currentAuthorId === next.currentAuthorId &&\n    state.snapshot.documentId === next.documentId &&\n    state.snapshot.documentKind === next.documentKind &&\n    state.snapshot.effectiveAccessLevel === next.effectiveAccessLevel &&\n    sameValidationIssues(\n      state.snapshot.fieldValidationIssues,\n      next.fieldValidationIssues,\n    ) &&\n    state.snapshot.ready === next.ready &&\n    sameDocumentRows(state.snapshot.rows, next.rows) &&\n    shallowEqualRecord(\n      state.snapshot.structuredFields,\n      next.structuredFields,\n    ) &&\n    state.snapshot.text === next.text &&\n    state.snapshot.title === next.title &&\n    state.snapshot.syncing === next.syncing\n  ) {\n    return;\n  }\n\n  state.snapshot = next;\n  emitDocumentStore(state);\n}\n\nfunction clearDocumentStoreState(\n  state: DocumentStoreState,\n  { initialized }: { initialized: boolean },\n) {\n  state.deferInitialUpdate = false;\n  state.doc = null;\n  state.localWriteGeneration += 1;\n  state.record = null;\n  state.pendingAttachments = [];\n  state.pendingBaseVersion = null;\n  state.pendingLocalWrites = 0;\n  state.pullContinuation = null;\n  state.attachmentBlobIdBySlotId = {};\n  state.attachmentContentSha256BySlotId = {};\n  state.attachmentStorageKeyBySlotId = {};\n  state.locallyAcceptedUpdateIds = new Set();\n  state.rejectedServedAttachmentBindings = new Set();\n  state.remoteUpdateCompletedSignalSeq = 0;\n  state.remoteSyncBlocked = !state.scheduleStartupRemoteSync;\n  state.awaitingAncestorRepair = false;\n  state.remoteUpdatePending = false;\n  state.remoteUpdateSignalSeq = 0;\n  state.writerProjection = null;\n  state.initialized = initialized;\n  state.initializePromise = null;\n  state.writeChain = Promise.resolve();\n  setDocumentSnapshot(state, { ...EMPTY_DOCUMENT_SNAPSHOT });\n}\n\nexport function resetDocumentStore(state: DocumentStoreState) {\n  clearDocumentStoreState(state, { initialized: false });\n}\n\nexport function markDocumentStoreRemoved(state: DocumentStoreState) {\n  clearDocumentStoreState(state, { initialized: true });\n}\n\nexport function canAttachFiles(state: DocumentStoreState): boolean {\n  return (\n    canWriteDocument(state) &&\n    state.runtime.infra.dbStatus === \"ready\" &&\n    !!state.runtime.crypto.encapsulationKeyPair\n  );\n}\n\nexport function canWriteDocument(state: DocumentStoreState): boolean {\n  return canWriteEffectiveAccessLevel(state.record?.effectiveAccessLevel);\n}\n\nfunction getSnapshotAttachments(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null = state.doc,\n): DocumentAttachment[] {\n  return currentDoc ? getDocumentAttachments(currentDoc) : [];\n}\n\nfunction getSnapshotRows(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null = state.doc,\n): DocumentRow[] {\n  return currentDoc ? listDocumentRows(currentDoc) : [];\n}\n\nfunction resolveCurrentAuthorId(state: DocumentStoreState): string | null {\n  return resolveDocumentCreateAuthor(state.runtime)?.signerUserId ?? null;\n}\n\nexport function setReadySnapshot(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  syncing: boolean,\n  textOverride?: string,\n  structuredFieldsOverride?: DocumentSnapshot[\"structuredFields\"],\n) {\n  const attachments = getSnapshotAttachments(state, currentDoc);\n  const rows = getSnapshotRows(state, currentDoc);\n  const documentState = readStoredDocumentState(\n    currentDoc,\n    state.runtime.infra.documentProjectors,\n  );\n  const text = textOverride ?? documentState.text;\n  const structuredFields =\n    structuredFieldsOverride ?? documentState.structuredFields;\n  const projectedState =\n    textOverride === undefined && structuredFieldsOverride === undefined\n      ? documentState\n      : projectStoredDocumentState(\n          {\n            documentKind: documentState.documentKind,\n            structuredFields,\n            text,\n            rows: rows.map((row) => ({ id: row.id, fields: row.fields })),\n          },\n          state.runtime.infra.documentProjectors,\n        );\n\n  setDocumentSnapshot(state, {\n    attachments,\n    attachmentStatusBySlotId: getAttachmentStatuses({\n      attachments,\n      contentSha256BySlotId: state.attachmentContentSha256BySlotId,\n      pendingSlotIds: new Set(\n        state.pendingAttachments.map((attachment) => attachment.slotId),\n      ),\n    }),\n    attachmentStorageKeyBySlotId: getAttachmentStorageKeys(\n      state.attachmentStorageKeyBySlotId,\n      attachments,\n    ),\n    canAttach: canAttachFiles(state),\n    canWrite: canWriteDocument(state),\n    currentAuthorId: resolveCurrentAuthorId(state),\n    documentId: state.record?.documentId ?? null,\n    documentKind: projectedState.documentKind,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      state.record?.effectiveAccessLevel,\n    ),\n    fieldValidationIssues: projectedState.fieldValidationIssues,\n    ready: true,\n    rows,\n    structuredFields: projectedState.structuredFields,\n    text,\n    title: projectedState.title,\n    syncing,\n  });\n}\n\nexport function setDocumentSyncing(\n  state: DocumentStoreState,\n  syncing: boolean,\n) {\n  setDocumentSnapshot(state, { ...state.snapshot, syncing });\n}\n\nexport function refreshAttachabilitySnapshot(state: DocumentStoreState) {\n  if (!state.snapshot.ready) {\n    return;\n  }\n\n  setDocumentSnapshot(state, {\n    ...state.snapshot,\n    canAttach: canAttachFiles(state),\n    canWrite: canWriteDocument(state),\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      state.record?.effectiveAccessLevel,\n    ),\n  });\n}\n\nexport function subscribeToDocumentStore(\n  state: DocumentStoreState,\n  listener: () => void,\n) {\n  state.listeners.add(listener);\n  return () => void state.listeners.delete(listener);\n}\n"]}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["state.ts"],"names":[],"mappings":"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","sourcesContent":["import type { createDocument } from \"@tearleads/loro\";\nimport type { DocumentWriterProjectionResponse } from \"@tearleads/validators/response\";\nimport { DEFAULT_DOCUMENT_KIND } from \"../../../data/documents/documentConstants\";\nimport {\n  type DocumentAttachment,\n  getDocumentAttachments,\n  sameDocumentAttachments,\n} from \"../../../data/documents/documentContent\";\nimport {\n  projectStoredDocumentState,\n  readStoredDocumentState,\n  type StoredDocumentKind,\n} from \"../../../data/documents/documentKinds\";\nimport {\n  type DocumentRow,\n  listDocumentRows,\n  sameDocumentRows,\n} from \"../../../data/documents/documentRowList\";\nimport type { DocumentSummary } from \"../../../data/documents/documentSummary\";\nimport type { DocumentSyncPullContinuation } from \"../../../data/documents/shared/sync/syncPagination\";\nimport type { SyncRemoteDocumentResult } from \"../../../data/documents/shared/types\";\nimport {\n  canWriteEffectiveAccessLevel,\n  normalizeEffectiveAccessLevel,\n} from \"../../../data/keying/accessLevel\";\nimport type { DomainScope } from \"../../../data/shared/domainScope\";\nimport {\n  type AttachmentRemovalRows,\n  type AttachmentStagingRows,\n  createDocumentProjectionUserKeyResolver,\n  type DocumentProjectionUserKeyResolver,\n  type DocumentRecord,\n  type DocumentSyncLane,\n  type DocumentsPersistence,\n  type PendingAttachmentRecord,\n  type PendingUpdateInsert,\n  resolveDocumentCreateAuthor,\n} from \"../../../workflows/documents\";\nimport type { DocumentSnapshot, DocumentsRuntime } from \"../types\";\nimport {\n  getAttachmentStatuses,\n  getAttachmentStorageKeys,\n} from \"./attachments/attachmentSnapshot\";\nexport type DocumentState = Awaited<ReturnType<typeof createDocument>>;\nexport type EncapsulationKeyPair = NonNullable<\n  DocumentsRuntime[\"crypto\"][\"encapsulationKeyPair\"]\n>;\nexport type DocumentAttachmentBinding = NonNullable<\n  Awaited<ReturnType<DocumentsRuntime[\"apiClient\"][\"listDocumentAttachments\"]>>\n>[number];\nexport type PendingMutationSyncResult = {\n  completed: boolean;\n  nextRecord: DocumentRecord;\n};\nexport interface PersistedDocumentRecord {\n  creationSuperseded?: true;\n  historyRestoreState?:\n    | Awaited<ReturnType<DocumentsPersistence[\"loadHistoryRestoreState\"]>>\n    | undefined;\n  pullContinuationSuperseded?: true;\n  record: DocumentRecord;\n  syncIdentitySuperseded?: true;\n  updatedAt?: string | undefined;\n}\nexport interface SaveDocumentRecordOptions {\n  acceptedPendingUpdateIds?: readonly string[] | undefined;\n  attachmentRemoval?: AttachmentRemovalRows | undefined;\n  attachmentStaging?: AttachmentStagingRows | undefined;\n  clearSyncFailure?: boolean | undefined;\n  expectedSyncState?:\n    | {\n        pullContinuation: DocumentSyncPullContinuation | null;\n        record: DocumentRecord;\n      }\n    | undefined;\n  historyCheckpoint?:\n    | {\n        coveredTailIds: readonly string[];\n        endVersionVector: string;\n        pruneCoveredLocalState: boolean;\n        snapshot: string;\n      }\n    | undefined;\n  historyUpdateOrigin?: \"local\" | \"remote\" | undefined;\n  historyUpdates?: readonly string[] | undefined;\n  pendingUpdate?: Omit<PendingUpdateInsert, \"localId\"> | undefined;\n  pendingBaseVersionOverride?: string | null | undefined;\n  preserveSnapshotStructuredFields?: boolean | undefined;\n  preserveSnapshotText?: boolean | undefined;\n  stillCurrent?: (() => boolean) | undefined;\n}\nexport interface DocumentSyncAttempt {\n  consumedPullContinuation: DocumentSyncPullContinuation | null;\n  outgoingUpdateCount: number;\n  requestRecord: DocumentRecord;\n  synced: SyncRemoteDocumentResult;\n  /** `writerProjectionGeneration` when the request left; gates the install. */\n  writerProjectionGeneration: number;\n}\nexport interface DocumentStorePersistenceEffects {\n  emitPersistedDocument: (\n    domainScope: DomainScope,\n    persistedDocument: DocumentSummary,\n    placementChanged?: boolean | undefined,\n  ) => void;\n  registerDocumentIdentity: (\n    domainScope: DomainScope,\n    localId: string,\n    documentId: string | null,\n  ) => void;\n}\nexport interface DocumentStoreState {\n  attachmentBlobIdBySlotId: Record<string, string | null>;\n  /** Plaintext digest of the held bytes per slot; see `getAttachmentStatuses`. */\n  attachmentContentSha256BySlotId: Record<string, string>;\n  attachmentStorageKeyBySlotId: Record<string, string>;\n  /** Creation's birth rides the first attach; see `deferredInitialUpdate.ts`. */\n  deferInitialUpdate?: boolean;\n  doc: DocumentState | null;\n  effects: DocumentStorePersistenceEffects;\n  initialDocumentId: string | null;\n  initialDocumentKind: StoredDocumentKind;\n  initialText: string;\n  initializePromise: Promise<void> | null;\n  initialized: boolean;\n  lastEventCount: number;\n  /** Invalidates queued local-write closures when this store is cleared. */\n  localWriteGeneration: number;\n  locallyAcceptedUpdateIds: Set<string>;\n  localId: string;\n  listeners: Set<() => void>;\n  pendingAttachments: PendingAttachmentRecord[];\n  /**\n   * Oplog version through which every op in `doc` is already durably enqueued as\n   * a pending update or synced from a remote peer. It advances only after an\n   * edit's enqueue+persist succeeds, so a later edit can recover any orphaned\n   * delta left by a failed write instead of silently dropping it from sync.\n   * `null` only before initialization sets it to the loaded doc's version.\n   */\n  pendingBaseVersion: string | null;\n  /**\n   * Local text/structured writes queued on `writeChain` but not yet drained.\n   * While positive, sync MUST preserve the optimistic text/fields because `doc`\n   * can lag the latest keystroke. Remote merges remain in `doc` and publish when\n   * the final write settles.\n   */\n  pendingLocalWrites: number;\n  persistence: DocumentsPersistence;\n  /**\n   * Durable continuation for a bounded remote pull, mirrored from the document\n   * record so the live lane can advance it without re-reading SQLite.\n   */\n  pullContinuation: DocumentSyncPullContinuation | null;\n  record: DocumentRecord | null;\n  /** Served bindings hydration refused for a held copy; see `hydrate.ts`. */\n  rejectedServedAttachmentBindings: Set<string>;\n  /**\n   * Consecutive completed sync passes that re-keyed conflicted pending updates\n   * without settling anything. Bounds the rekey-driven self re-arm so a server\n   * that keeps conflicting fresh ids cannot drive a network-speed loop; see\n   * shouldReArmAfterOutgoingSettlement.\n   */\n  rekeyOnlyPassCount: number;\n  resolveProjectionUserKey: DocumentProjectionUserKeyResolver;\n  /** Latest remote-update sequence durably applied by a completed probe. */\n  remoteUpdateCompletedSignalSeq: number;\n  /** A cancelled remote-only owner blocks late responses until fresh work. */\n  remoteSyncBlocked: boolean;\n  scheduleStartupRemoteSync: boolean;\n  remoteUpdatePending: boolean;\n  /** Sequence used to keep an older pass from clearing a newer remote event. */\n  remoteUpdateSignalSeq: number;\n  runtime: DocumentsRuntime;\n  snapshot: DocumentSnapshot;\n  syncLane: DocumentSyncLane | null;\n  /** Parked behind another member's ancestor repair; a path hint re-runs. */\n  awaitingAncestorRepair: boolean;\n  writeChain: Promise<void>;\n  writerProjection: DocumentWriterProjectionResponse | null;\n  /**\n   * Bumped whenever a realtime hint drops `writerProjection`; an operation that\n   * fetched or was handed a projection installs it only if this is unchanged\n   * since it started, so a pre-hint answer never lands after the hint.\n   */\n  writerProjectionGeneration: number;\n}\nconst EMPTY_DOCUMENT_SNAPSHOT: DocumentSnapshot = {\n  attachments: [],\n  attachmentStatusBySlotId: {},\n  attachmentStorageKeyBySlotId: {},\n  canAttach: false,\n  canWrite: true,\n  currentAuthorId: null,\n  documentId: null,\n  documentKind: DEFAULT_DOCUMENT_KIND,\n  effectiveAccessLevel: \"admin\",\n  fieldValidationIssues: [],\n  ready: false,\n  rows: [],\n  structuredFields: {},\n  text: \"\",\n  title: \"\",\n  syncing: false,\n};\nfunction shallowEqualRecord<Value>(\n  left: Readonly<Record<string, Value>>,\n  right: Readonly<Record<string, Value>>,\n): boolean {\n  let leftKeyCount = 0;\n  for (const key in left) {\n    if (!Object.hasOwn(left, key)) continue;\n\n    leftKeyCount += 1;\n    if (!Object.hasOwn(right, key) || !Object.is(left[key], right[key])) {\n      return false;\n    }\n  }\n\n  let rightKeyCount = 0;\n  for (const key in right) {\n    if (Object.hasOwn(right, key)) {\n      rightKeyCount += 1;\n    }\n  }\n\n  return leftKeyCount === rightKeyCount;\n}\n\nfunction sameValidationIssues(\n  left: DocumentSnapshot[\"fieldValidationIssues\"],\n  right: DocumentSnapshot[\"fieldValidationIssues\"],\n): boolean {\n  return (\n    left.length === right.length &&\n    left.every((issue, index) => {\n      const nextIssue = right[index];\n      return (\n        nextIssue !== undefined &&\n        issue.field === nextIssue.field &&\n        issue.message === nextIssue.message &&\n        Object.is(issue.value, nextIssue.value)\n      );\n    })\n  );\n}\n\nexport function createDocumentStoreState(\n  localId: string,\n  initialRuntime: DocumentsRuntime,\n  persistence: DocumentsPersistence,\n  effects: DocumentStorePersistenceEffects,\n  initialDocumentId: string | null,\n  initialText = \"\",\n  initialDocumentKind: StoredDocumentKind = DEFAULT_DOCUMENT_KIND,\n  scheduleStartupRemoteSync = true,\n): DocumentStoreState {\n  return {\n    attachmentBlobIdBySlotId: {},\n    attachmentContentSha256BySlotId: {},\n    attachmentStorageKeyBySlotId: {},\n    doc: null,\n    effects,\n    initialDocumentId,\n    initialDocumentKind,\n    initialText,\n    initializePromise: null,\n    initialized: false,\n    lastEventCount: 0,\n    localWriteGeneration: 0,\n    locallyAcceptedUpdateIds: new Set(),\n    localId,\n    listeners: new Set(),\n    pendingAttachments: [],\n    pendingBaseVersion: null,\n    pendingLocalWrites: 0,\n    persistence,\n    pullContinuation: null,\n    record: null,\n    rejectedServedAttachmentBindings: new Set(),\n    rekeyOnlyPassCount: 0,\n    resolveProjectionUserKey:\n      createDocumentProjectionUserKeyResolver(initialRuntime),\n    remoteUpdateCompletedSignalSeq: 0,\n    remoteSyncBlocked: !scheduleStartupRemoteSync,\n    scheduleStartupRemoteSync,\n    awaitingAncestorRepair: false,\n    remoteUpdatePending: false,\n    remoteUpdateSignalSeq: 0,\n    runtime: initialRuntime,\n    snapshot: { ...EMPTY_DOCUMENT_SNAPSHOT },\n    syncLane: null,\n    writeChain: Promise.resolve(),\n    writerProjection: null,\n    writerProjectionGeneration: 0,\n  };\n}\n\nfunction emitDocumentStore(state: DocumentStoreState) {\n  for (const listener of state.listeners) {\n    listener();\n  }\n}\n\nexport function setDocumentSnapshot(\n  state: DocumentStoreState,\n  next: DocumentSnapshot,\n) {\n  if (\n    sameDocumentAttachments(state.snapshot.attachments, next.attachments) &&\n    shallowEqualRecord(\n      state.snapshot.attachmentStatusBySlotId,\n      next.attachmentStatusBySlotId,\n    ) &&\n    shallowEqualRecord(\n      state.snapshot.attachmentStorageKeyBySlotId,\n      next.attachmentStorageKeyBySlotId,\n    ) &&\n    state.snapshot.canAttach === next.canAttach &&\n    state.snapshot.canWrite === next.canWrite &&\n    state.snapshot.currentAuthorId === next.currentAuthorId &&\n    state.snapshot.documentId === next.documentId &&\n    state.snapshot.documentKind === next.documentKind &&\n    state.snapshot.effectiveAccessLevel === next.effectiveAccessLevel &&\n    sameValidationIssues(\n      state.snapshot.fieldValidationIssues,\n      next.fieldValidationIssues,\n    ) &&\n    state.snapshot.ready === next.ready &&\n    sameDocumentRows(state.snapshot.rows, next.rows) &&\n    shallowEqualRecord(\n      state.snapshot.structuredFields,\n      next.structuredFields,\n    ) &&\n    state.snapshot.text === next.text &&\n    state.snapshot.title === next.title &&\n    state.snapshot.syncing === next.syncing\n  ) {\n    return;\n  }\n\n  state.snapshot = next;\n  emitDocumentStore(state);\n}\n\nfunction clearDocumentStoreState(\n  state: DocumentStoreState,\n  { initialized }: { initialized: boolean },\n) {\n  state.deferInitialUpdate = false;\n  state.doc = null;\n  state.localWriteGeneration += 1;\n  state.record = null;\n  state.pendingAttachments = [];\n  state.pendingBaseVersion = null;\n  state.pendingLocalWrites = 0;\n  state.pullContinuation = null;\n  state.attachmentBlobIdBySlotId = {};\n  state.attachmentContentSha256BySlotId = {};\n  state.attachmentStorageKeyBySlotId = {};\n  state.locallyAcceptedUpdateIds = new Set();\n  state.rejectedServedAttachmentBindings = new Set();\n  state.remoteUpdateCompletedSignalSeq = 0;\n  state.remoteSyncBlocked = !state.scheduleStartupRemoteSync;\n  state.awaitingAncestorRepair = false;\n  state.remoteUpdatePending = false;\n  state.remoteUpdateSignalSeq = 0;\n  state.writerProjection = null;\n  state.initialized = initialized;\n  state.initializePromise = null;\n  state.writeChain = Promise.resolve();\n  setDocumentSnapshot(state, { ...EMPTY_DOCUMENT_SNAPSHOT });\n}\n\nexport function resetDocumentStore(state: DocumentStoreState) {\n  clearDocumentStoreState(state, { initialized: false });\n}\n\nexport function markDocumentStoreRemoved(state: DocumentStoreState) {\n  clearDocumentStoreState(state, { initialized: true });\n}\n\nexport function canAttachFiles(state: DocumentStoreState): boolean {\n  return (\n    canWriteDocument(state) &&\n    state.runtime.infra.dbStatus === \"ready\" &&\n    !!state.runtime.crypto.encapsulationKeyPair\n  );\n}\n\nexport function canWriteDocument(state: DocumentStoreState): boolean {\n  return canWriteEffectiveAccessLevel(state.record?.effectiveAccessLevel);\n}\n\nfunction getSnapshotAttachments(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null = state.doc,\n): DocumentAttachment[] {\n  return currentDoc ? getDocumentAttachments(currentDoc) : [];\n}\n\nfunction getSnapshotRows(\n  state: DocumentStoreState,\n  currentDoc: DocumentState | null = state.doc,\n): DocumentRow[] {\n  return currentDoc ? listDocumentRows(currentDoc) : [];\n}\n\nfunction resolveCurrentAuthorId(state: DocumentStoreState): string | null {\n  return resolveDocumentCreateAuthor(state.runtime)?.signerUserId ?? null;\n}\n\nexport function setReadySnapshot(\n  state: DocumentStoreState,\n  currentDoc: DocumentState,\n  syncing: boolean,\n  textOverride?: string,\n  structuredFieldsOverride?: DocumentSnapshot[\"structuredFields\"],\n) {\n  const attachments = getSnapshotAttachments(state, currentDoc);\n  const rows = getSnapshotRows(state, currentDoc);\n  const documentState = readStoredDocumentState(\n    currentDoc,\n    state.runtime.infra.documentProjectors,\n  );\n  const text = textOverride ?? documentState.text;\n  const structuredFields =\n    structuredFieldsOverride ?? documentState.structuredFields;\n  const projectedState =\n    textOverride === undefined && structuredFieldsOverride === undefined\n      ? documentState\n      : projectStoredDocumentState(\n          {\n            documentKind: documentState.documentKind,\n            structuredFields,\n            text,\n            rows: rows.map((row) => ({ id: row.id, fields: row.fields })),\n          },\n          state.runtime.infra.documentProjectors,\n        );\n\n  setDocumentSnapshot(state, {\n    attachments,\n    attachmentStatusBySlotId: getAttachmentStatuses({\n      attachments,\n      contentSha256BySlotId: state.attachmentContentSha256BySlotId,\n      pendingSlotIds: new Set(\n        state.pendingAttachments.map((attachment) => attachment.slotId),\n      ),\n    }),\n    attachmentStorageKeyBySlotId: getAttachmentStorageKeys(\n      state.attachmentStorageKeyBySlotId,\n      attachments,\n    ),\n    canAttach: canAttachFiles(state),\n    canWrite: canWriteDocument(state),\n    currentAuthorId: resolveCurrentAuthorId(state),\n    documentId: state.record?.documentId ?? null,\n    documentKind: projectedState.documentKind,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      state.record?.effectiveAccessLevel,\n    ),\n    fieldValidationIssues: projectedState.fieldValidationIssues,\n    ready: true,\n    rows,\n    structuredFields: projectedState.structuredFields,\n    text,\n    title: projectedState.title,\n    syncing,\n  });\n}\n\nexport function setDocumentSyncing(\n  state: DocumentStoreState,\n  syncing: boolean,\n) {\n  setDocumentSnapshot(state, { ...state.snapshot, syncing });\n}\n\nexport function refreshAttachabilitySnapshot(state: DocumentStoreState) {\n  if (!state.snapshot.ready) {\n    return;\n  }\n\n  setDocumentSnapshot(state, {\n    ...state.snapshot,\n    canAttach: canAttachFiles(state),\n    canWrite: canWriteDocument(state),\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      state.record?.effectiveAccessLevel,\n    ),\n  });\n}\n\nexport function subscribeToDocumentStore(\n  state: DocumentStoreState,\n  listener: () => void,\n) {\n  state.listeners.add(listener);\n  return () => void state.listeners.delete(listener);\n}\n"]}