@tearleads/client-sdk 0.0.0-stage → 0.1.11

package/stores/documents/documentStore/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 { invalidateDocumentStorePullContinuation } from \"./pullContinuationInvalidation\";\nimport type {\n  DocumentState,\n  DocumentStoreState,\n  DocumentSyncAttempt,\n} from \"./state\";\nimport {\n  cleanupPreRegisteredUpdateIdsOnFailure,\n  discardUnacceptedPreRegisteredUpdateIds,\n  preRegisterMaterializedDocumentSyncUpdateIds,\n} from \"./syncAcceptedUpdateIds\";\nimport {\n  captureDocumentStoreSyncGeneration,\n  type DocumentStoreSyncGeneration,\n  isDocumentStoreSyncGenerationCurrent,\n} from \"./syncGeneration\";\nimport { prepareDocumentOutgoingCoverage } from \"./syncOutgoingCoverage\";\nimport { requestRemoteDocumentSync } from \"./syncRequest\";\nimport { extendDocumentVersionCoverage } from \"./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

@@ -0,0 +1,133 @@
+import { encodeVersionVector } from "../../../internal/loro/index.js";
+import { addDocumentRow, createDocumentRowId, removeDocumentRow, setDocumentRowFields, } from "../../../data/documents/documentRowList.js";
+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 { 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";
+// 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
+// unauthenticated) and an ISO timestamp, matching the keys the edit-attribution
+// layer resolves against.
+function resolveRowAttribution(state) {
+    return {
+        at: new Date().toISOString(),
+        userId: resolveDocumentCreateAuthor(state.runtime)?.signerUserId ?? "",
+    };
+}
+async function persistRowMutation(state, expectedLocalWriteGeneration, mutate) {
+    if (state.localWriteGeneration !== expectedLocalWriteGeneration) {
+        return;
+    }
+    const currentDoc = state.doc;
+    if (!currentDoc || !canWriteDocument(state)) {
+        return;
+    }
+    const generation = captureDocumentStoreSyncGeneration(state, currentDoc);
+    if (!generation) {
+        return;
+    }
+    if (!mutate(currentDoc)) {
+        await revalidateDocumentMutationIdentity({ currentDoc, generation, state });
+        return;
+    }
+    const update = pendingDeltaSinceBase(state, currentDoc);
+    if (update.byteLength === 0) {
+        await revalidateDocumentMutationIdentity({ currentDoc, generation, state });
+        return;
+    }
+    // Captured at delta time: the enqueued row proves coverage up to exactly
+    // this version, so it is the frontier the persist below may publish.
+    const coveredVersion = encodeVersionVector(currentDoc);
+    const pendingUpdate = createPendingUpdateFields(update);
+    if (!pendingUpdate) {
+        await revalidateDocumentMutationIdentity({ currentDoc, generation, state });
+        return;
+    }
+    // Row writes change neither prose nor structured fields; setReadySnapshot
+    // always re-derives rows from the doc, so preserve the text/structured fields
+    // in case this write overlaps an in-flight keystroke elsewhere.
+    const persisted = await persistDocument(state, currentDoc, { snapshotEndVersion: coveredVersion }, {
+        pendingUpdate,
+        preserveSnapshotStructuredFields: true,
+        preserveSnapshotText: true,
+    }, generation);
+    if (!persisted ||
+        persisted.pullContinuationSuperseded ||
+        persisted.syncIdentitySuperseded ||
+        !isDocumentStoreSyncGenerationCurrent(state, generation)) {
+        // Refused: the document was deleted while this persist was queued
+        // and the store is cleared — no state advance, no sync request.
+        return;
+    }
+    advancePendingBaseVersion(state, currentDoc);
+    requestDocumentStoreSync(state);
+}
+function queueRowMutation(state, mutate) {
+    const writeGeneration = state.localWriteGeneration;
+    // Unlike text/structured-field writes, row writes intentionally do NOT bump
+    // `state.pendingLocalWrites`: rows are never in the optimistic-preserve set —
+    // `setReadySnapshot` always re-derives them from the doc — so there is no
+    // optimistic snapshot for a concurrent sync pass to clobber. Input smoothness
+    // during rapid edits is handled in the app layer (useDocumentRowEditing).
+    state.writeChain = state.writeChain
+        .catch(() => undefined)
+        .then(async () => persistRowMutation(state, writeGeneration, mutate))
+        .catch((error) => {
+        reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);
+    });
+    return state.writeChain;
+}
+export async function addRowToDocumentStore(state, scheduleSync, fields) {
+    const id = createDocumentRowId();
+    let ready;
+    try {
+        ready = await ensureDocumentStoreReady(state, scheduleSync);
+    }
+    catch (error) {
+        reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);
+        return id;
+    }
+    if (!ready || !state.doc || !canWriteDocument(state)) {
+        return id;
+    }
+    await queueRowMutation(state, (doc) => {
+        addDocumentRow(doc, id, fields, resolveRowAttribution(state));
+        return true;
+    });
+    return id;
+}
+export async function updateRowInDocumentStore(state, scheduleSync, id, patch) {
+    let ready;
+    try {
+        ready = await ensureDocumentStoreReady(state, scheduleSync);
+    }
+    catch (error) {
+        reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);
+        return;
+    }
+    if (!ready || !state.doc || !canWriteDocument(state)) {
+        return;
+    }
+    await queueRowMutation(state, (doc) => setDocumentRowFields(doc, id, patch, resolveRowAttribution(state)));
+}
+export async function removeRowFromDocumentStore(state, scheduleSync, id) {
+    let ready;
+    try {
+        ready = await ensureDocumentStoreReady(state, scheduleSync);
+    }
+    catch (error) {
+        reportDocumentStoreWriteFailure(state, ROW_FAILURE_MESSAGE, error);
+        return;
+    }
+    if (!ready || !state.doc || !canWriteDocument(state)) {
+        return;
+    }
+    await queueRowMutation(state, (doc) => removeDocumentRow(doc, id));
+}
+//# sourceMappingURL=rows.js.map

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

@@ -0,0 +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"]}

package/stores/documents/documentStore/state.js

@@ -0,0 +1,223 @@
+import { canWriteEffectiveAccessLevel, normalizeEffectiveAccessLevel, } from "../../../data/accessLevel.js";
+import { DEFAULT_DOCUMENT_KIND } from "../../../data/documents/documentConstants.js";
+import { getDocumentAttachments, sameDocumentAttachments, } from "../../../data/documents/documentContent.js";
+import { projectStoredDocumentState, readStoredDocumentState, } from "../../../data/documents/documentKinds.js";
+import { listDocumentRows, sameDocumentRows, } from "../../../data/documents/documentRowList.js";
+import { createDocumentProjectionUserKeyResolver, resolveDocumentCreateAuthor, } from "../../../workflows/documents/index.js";
+import { getAttachmentStatuses, getAttachmentStorageKeys, } from "./attachmentSnapshot.js";
+const EMPTY_DOCUMENT_SNAPSHOT = {
+    attachments: [],
+    attachmentStatusBySlotId: {},
+    attachmentStorageKeyBySlotId: {},
+    canAttach: false,
+    canWrite: true,
+    currentAuthorId: null,
+    documentId: null,
+    documentKind: DEFAULT_DOCUMENT_KIND,
+    effectiveAccessLevel: "admin",
+    fieldValidationIssues: [],
+    ready: false,
+    rows: [],
+    structuredFields: {},
+    text: "",
+    title: "",
+    syncing: false,
+};
+function shallowEqualRecord(left, right) {
+    let leftKeyCount = 0;
+    for (const key in left) {
+        if (!Object.hasOwn(left, key))
+            continue;
+        leftKeyCount += 1;
+        if (!Object.hasOwn(right, key) || !Object.is(left[key], right[key])) {
+            return false;
+        }
+    }
+    let rightKeyCount = 0;
+    for (const key in right) {
+        if (Object.hasOwn(right, key)) {
+            rightKeyCount += 1;
+        }
+    }
+    return leftKeyCount === rightKeyCount;
+}
+function sameValidationIssues(left, right) {
+    return (left.length === right.length &&
+        left.every((issue, index) => {
+            const nextIssue = right[index];
+            return (nextIssue !== undefined &&
+                issue.field === nextIssue.field &&
+                issue.message === nextIssue.message &&
+                Object.is(issue.value, nextIssue.value));
+        }));
+}
+export function createDocumentStoreState(localId, initialRuntime, persistence, effects, initialDocumentId, initialText = "", initialDocumentKind = DEFAULT_DOCUMENT_KIND, scheduleStartupRemoteSync = true) {
+    return {
+        attachmentBlobIdBySlotId: {},
+        attachmentContentSha256BySlotId: {},
+        attachmentStorageKeyBySlotId: {},
+        doc: null,
+        effects,
+        initialDocumentId,
+        initialDocumentKind,
+        initialText,
+        initializePromise: null,
+        initialized: false,
+        lastEventCount: 0,
+        localWriteGeneration: 0,
+        locallyAcceptedUpdateIds: new Set(),
+        localId,
+        listeners: new Set(),
+        pendingAttachments: [],
+        pendingBaseVersion: null,
+        pendingLocalWrites: 0,
+        persistence,
+        pullContinuation: null,
+        record: null,
+        rejectedServedAttachmentBindings: new Set(),
+        rekeyOnlyPassCount: 0,
+        resolveProjectionUserKey: createDocumentProjectionUserKeyResolver(initialRuntime),
+        remoteUpdateCompletedSignalSeq: 0,
+        remoteSyncBlocked: !scheduleStartupRemoteSync,
+        scheduleStartupRemoteSync,
+        awaitingAncestorRepair: false,
+        remoteUpdatePending: false,
+        remoteUpdateSignalSeq: 0,
+        runtime: initialRuntime,
+        snapshot: { ...EMPTY_DOCUMENT_SNAPSHOT },
+        syncLane: null,
+        writeChain: Promise.resolve(),
+        writerProjection: null,
+        writerProjectionGeneration: 0,
+    };
+}
+function emitDocumentStore(state) {
+    for (const listener of state.listeners) {
+        listener();
+    }
+}
+export function setDocumentSnapshot(state, next) {
+    if (sameDocumentAttachments(state.snapshot.attachments, next.attachments) &&
+        shallowEqualRecord(state.snapshot.attachmentStatusBySlotId, next.attachmentStatusBySlotId) &&
+        shallowEqualRecord(state.snapshot.attachmentStorageKeyBySlotId, next.attachmentStorageKeyBySlotId) &&
+        state.snapshot.canAttach === next.canAttach &&
+        state.snapshot.canWrite === next.canWrite &&
+        state.snapshot.currentAuthorId === next.currentAuthorId &&
+        state.snapshot.documentId === next.documentId &&
+        state.snapshot.documentKind === next.documentKind &&
+        state.snapshot.effectiveAccessLevel === next.effectiveAccessLevel &&
+        sameValidationIssues(state.snapshot.fieldValidationIssues, next.fieldValidationIssues) &&
+        state.snapshot.ready === next.ready &&
+        sameDocumentRows(state.snapshot.rows, next.rows) &&
+        shallowEqualRecord(state.snapshot.structuredFields, next.structuredFields) &&
+        state.snapshot.text === next.text &&
+        state.snapshot.title === next.title &&
+        state.snapshot.syncing === next.syncing) {
+        return;
+    }
+    state.snapshot = next;
+    emitDocumentStore(state);
+}
+function clearDocumentStoreState(state, { initialized }) {
+    state.doc = null;
+    state.localWriteGeneration += 1;
+    state.record = null;
+    state.pendingAttachments = [];
+    state.pendingBaseVersion = null;
+    state.pendingLocalWrites = 0;
+    state.pullContinuation = null;
+    state.attachmentBlobIdBySlotId = {};
+    state.attachmentContentSha256BySlotId = {};
+    state.attachmentStorageKeyBySlotId = {};
+    state.locallyAcceptedUpdateIds = new Set();
+    state.rejectedServedAttachmentBindings = new Set();
+    state.remoteUpdateCompletedSignalSeq = 0;
+    state.remoteSyncBlocked = !state.scheduleStartupRemoteSync;
+    state.awaitingAncestorRepair = false;
+    state.remoteUpdatePending = false;
+    state.remoteUpdateSignalSeq = 0;
+    state.writerProjection = null;
+    state.initialized = initialized;
+    state.initializePromise = null;
+    state.writeChain = Promise.resolve();
+    setDocumentSnapshot(state, { ...EMPTY_DOCUMENT_SNAPSHOT });
+}
+export function resetDocumentStore(state) {
+    clearDocumentStoreState(state, { initialized: false });
+}
+export function markDocumentStoreRemoved(state) {
+    clearDocumentStoreState(state, { initialized: true });
+}
+export function canAttachFiles(state) {
+    return (canWriteDocument(state) &&
+        state.runtime.infra.dbStatus === "ready" &&
+        !!state.runtime.crypto.encapsulationKeyPair);
+}
+export function canWriteDocument(state) {
+    return canWriteEffectiveAccessLevel(state.record?.effectiveAccessLevel);
+}
+function getSnapshotAttachments(state, currentDoc = state.doc) {
+    return currentDoc ? getDocumentAttachments(currentDoc) : [];
+}
+function getSnapshotRows(state, currentDoc = state.doc) {
+    return currentDoc ? listDocumentRows(currentDoc) : [];
+}
+function resolveCurrentAuthorId(state) {
+    return resolveDocumentCreateAuthor(state.runtime)?.signerUserId ?? null;
+}
+export function setReadySnapshot(state, currentDoc, syncing, textOverride, structuredFieldsOverride) {
+    const attachments = getSnapshotAttachments(state, currentDoc);
+    const rows = getSnapshotRows(state, currentDoc);
+    const documentState = readStoredDocumentState(currentDoc, state.runtime.infra.documentProjectors);
+    const text = textOverride ?? documentState.text;
+    const structuredFields = structuredFieldsOverride ?? documentState.structuredFields;
+    const projectedState = textOverride === undefined && structuredFieldsOverride === undefined
+        ? documentState
+        : projectStoredDocumentState({
+            documentKind: documentState.documentKind,
+            structuredFields,
+            text,
+            rows: rows.map((row) => ({ id: row.id, fields: row.fields })),
+        }, state.runtime.infra.documentProjectors);
+    setDocumentSnapshot(state, {
+        attachments,
+        attachmentStatusBySlotId: getAttachmentStatuses({
+            attachments,
+            contentSha256BySlotId: state.attachmentContentSha256BySlotId,
+            pendingSlotIds: new Set(state.pendingAttachments.map((attachment) => attachment.slotId)),
+        }),
+        attachmentStorageKeyBySlotId: getAttachmentStorageKeys(state.attachmentStorageKeyBySlotId, attachments),
+        canAttach: canAttachFiles(state),
+        canWrite: canWriteDocument(state),
+        currentAuthorId: resolveCurrentAuthorId(state),
+        documentId: state.record?.documentId ?? null,
+        documentKind: projectedState.documentKind,
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(state.record?.effectiveAccessLevel),
+        fieldValidationIssues: projectedState.fieldValidationIssues,
+        ready: true,
+        rows,
+        structuredFields: projectedState.structuredFields,
+        text,
+        title: projectedState.title,
+        syncing,
+    });
+}
+export function setDocumentSyncing(state, syncing) {
+    setDocumentSnapshot(state, { ...state.snapshot, syncing });
+}
+export function refreshAttachabilitySnapshot(state) {
+    if (!state.snapshot.ready) {
+        return;
+    }
+    setDocumentSnapshot(state, {
+        ...state.snapshot,
+        canAttach: canAttachFiles(state),
+        canWrite: canWriteDocument(state),
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(state.record?.effectiveAccessLevel),
+    });
+}
+export function subscribeToDocumentStore(state, listener) {
+    state.listeners.add(listener);
+    return () => void state.listeners.delete(listener);
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +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 {\n  canWriteEffectiveAccessLevel,\n  normalizeEffectiveAccessLevel,\n} from \"../../../data/accessLevel\";\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 type { DomainScope } from \"../../../data/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  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.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"]}

package/stores/documents/documentStore/storedDocument.js

@@ -0,0 +1,29 @@
+import { createDocument } from "../../../internal/loro/index.js";
+import { getRuntimePeerSeed } from "../../../data/crdtPeerSeed.js";
+import { ensureDocumentAttachmentStructure } from "../../../data/documents/documentContent.js";
+import { ensureDocumentRowsStructure } from "../../../data/documents/documentRowList.js";
+import { DOCUMENTS_APP_KIND } from "../../../workflows/documents/index.js";
+async function createStoredDocumentWithSeed(peerSeed) {
+    const createdDoc = await createDocument(peerSeed);
+    ensureDocumentAttachmentStructure(createdDoc);
+    ensureDocumentRowsStructure(createdDoc);
+    return createdDoc;
+}
+export async function createStoredDocument(state) {
+    // Persistent pane namespaces retain stable seeds. Concurrent runtimes in one
+    // namespace receive distinct memory-only seeds after the first owner, while
+    // the usual single runtime can reuse its device seed after a page reload.
+    const peerScope = state.runtime.state.peerScope;
+    const scope = peerScope
+        ? `${DOCUMENTS_APP_KIND}:${peerScope}`
+        : DOCUMENTS_APP_KIND;
+    return createStoredDocumentWithSeed(await getRuntimePeerSeed(scope, state.runtime.state.domainScope));
+}
+/**
+ * Rebuild after discarding non-durable local ops under a new peer. Reusing the
+ * normal peer would reuse the discarded counters and corrupt the next edit.
+ */
+export function createFreshPeerStoredDocument() {
+    return createStoredDocumentWithSeed(crypto.randomUUID());
+}
+//# sourceMappingURL=storedDocument.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storedDocument.js","sourceRoot":"","sources":["storedDocument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iCAAiC,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,KAAK,UAAU,4BAA4B,CACzC,QAAgB;IAEhB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClD,iCAAiC,CAAC,UAAU,CAAC,CAAC;IAC9C,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAyB;IAEzB,6EAA6E;IAC7E,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,SAAS;QACrB,CAAC,CAAC,GAAG,kBAAkB,IAAI,SAAS,EAAE;QACtC,CAAC,CAAC,kBAAkB,CAAC;IACvB,OAAO,4BAA4B,CACjC,MAAM,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CACjE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,4BAA4B,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { createDocument } from \"@tearleads/loro\";\nimport { getRuntimePeerSeed } from \"../../../data/crdtPeerSeed\";\nimport { ensureDocumentAttachmentStructure } from \"../../../data/documents/documentContent\";\nimport { ensureDocumentRowsStructure } from \"../../../data/documents/documentRowList\";\nimport { DOCUMENTS_APP_KIND } from \"../../../workflows/documents\";\nimport type { DocumentState, DocumentStoreState } from \"./state\";\n\nasync function createStoredDocumentWithSeed(\n  peerSeed: string,\n): Promise<DocumentState> {\n  const createdDoc = await createDocument(peerSeed);\n  ensureDocumentAttachmentStructure(createdDoc);\n  ensureDocumentRowsStructure(createdDoc);\n  return createdDoc;\n}\n\nexport async function createStoredDocument(\n  state: DocumentStoreState,\n): Promise<DocumentState> {\n  // Persistent pane namespaces retain stable seeds. Concurrent runtimes in one\n  // namespace receive distinct memory-only seeds after the first owner, while\n  // the usual single runtime can reuse its device seed after a page reload.\n  const peerScope = state.runtime.state.peerScope;\n  const scope = peerScope\n    ? `${DOCUMENTS_APP_KIND}:${peerScope}`\n    : DOCUMENTS_APP_KIND;\n  return createStoredDocumentWithSeed(\n    await getRuntimePeerSeed(scope, state.runtime.state.domainScope),\n  );\n}\n\n/**\n * Rebuild after discarding non-durable local ops under a new peer. Reusing the\n * normal peer would reuse the discarded counters and corrupt the next edit.\n */\nexport function createFreshPeerStoredDocument(): Promise<DocumentState> {\n  return createStoredDocumentWithSeed(crypto.randomUUID());\n}\n"]}