@tearleads/client-sdk 0.0.0-stage → 0.1.13

package/data/persistence/documents/internal/documentMutationPersistence.js

@@ -0,0 +1,228 @@
+import { base64ToBytes } from "../../../../internal/encoding/index.js";
+import { createDocument, importSnapshot, updateMatchesDocumentHistory, } from "../../../../internal/loro/index.js";
+import { and, eq, inArray } from "drizzle-orm";
+import { documentSyncPullContinuationsEqual } from "../../../documents/shared/pullContinuation.js";
+import { appendDocumentHistoryUpdates, replaceDocumentHistoryCheckpoint, } from "../../../sqlite/documentHistoryPersistence.js";
+import { insertDocumentPendingUpdateWithHistoryInTransaction } from "../../../sqlite/documentPendingUpdatePersistence.js";
+import { documentHistoryUpdates, documentPendingUpdates, documentSyncFailures, } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { runSerializedSqlMutation } from "../../../sqlite/sqlSchema.js";
+import { applyStoredAttachmentRemoval, upsertStoredAttachmentStagingRows, } from "./attachmentStagingPersistence.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+import { sameDocumentSecurityIdentity, sameNullableDocumentValue, } from "./documentRecordIdentity.js";
+import { resolveDocumentSaveTimestamp, saveDocumentRows } from "./documentRows.js";
+function sameRecoveryGeneration(current, expected) {
+    return ((current.recoveryGeneration ?? 0) === (expected.recoveryGeneration ?? 0));
+}
+function sameExpectedDocumentRecord(current, expected) {
+    return (sameDocumentSecurityIdentity(current, expected) &&
+        sameRecoveryGeneration(current, expected) &&
+        sameNullableDocumentValue(current.lastCommitLsn, expected.lastCommitLsn) &&
+        current.snapshotEndVersion === expected.snapshotEndVersion &&
+        sameNullableDocumentValue(current.pendingBaseVersion, expected.pendingBaseVersion) &&
+        documentSyncPullContinuationsEqual(current.pullContinuation, expected.pullContinuation) &&
+        Boolean(current.pullContinuationRecoveryRequired) ===
+            Boolean(expected.pullContinuationRecoveryRequired) &&
+        (current.documentKind ?? null) === (expected.documentKind ?? null) &&
+        current.text === expected.text &&
+        (current.title ?? null) === (expected.title ?? null));
+}
+async function deleteAcceptedPendingUpdates(tx, localId, ids) {
+    const uniqueIds = [...new Set(ids)];
+    if (uniqueIds.length === 0)
+        return;
+    await tx
+        .delete(documentPendingUpdates)
+        .where(and(eq(documentPendingUpdates.appKind, DOCUMENTS_APP_KIND), eq(documentPendingUpdates.localId, localId), inArray(documentPendingUpdates.id, uniqueIds)))
+        .run();
+}
+async function clearSyncFailure(tx, localId) {
+    await tx
+        .delete(documentSyncFailures)
+        .where(and(eq(documentSyncFailures.appKind, DOCUMENTS_APP_KIND), eq(documentSyncFailures.localId, localId)))
+        .run();
+}
+async function insertPendingUpdate(tx, documentId, pendingUpdate) {
+    if (!pendingUpdate)
+        return;
+    await insertDocumentPendingUpdateWithHistoryInTransaction({
+        createdAt: new Date().toISOString(),
+        pendingUpdate,
+        scope: { appKind: DOCUMENTS_APP_KIND, localId: documentId },
+        tx,
+    });
+}
+async function settleMutationConflict(input) {
+    if (input.currentRecord &&
+        input.mutation.settleAcceptedPendingOnConflict &&
+        sameDocumentSecurityIdentity(input.currentRecord, input.mutation.expectedRecord) &&
+        sameRecoveryGeneration(input.currentRecord, input.mutation.expectedRecord)) {
+        await deleteAcceptedPendingUpdates(input.tx, input.mutation.document.id, input.mutation.acceptedPendingUpdateIds);
+    }
+}
+async function appendMutationHistory(execSql, input, tx) {
+    if (input.historyCheckpoint) {
+        const coveredLocalState = input.historyCheckpoint.pruneCoveredLocalState
+            ? await findCoveredRecoveryLocalState(tx, input.document.id, input.historyCheckpoint.snapshot)
+            : {
+                checkpointIds: [],
+                hasOrdinaryPendingUpdates: false,
+                hasUnprunablePendingUpdates: false,
+                hasUnverifiedHistoryTail: false,
+                tailIds: [],
+            };
+        if (input.historyCheckpoint.pruneCoveredLocalState &&
+            (coveredLocalState.hasOrdinaryPendingUpdates ||
+                coveredLocalState.hasUnprunablePendingUpdates)) {
+            throw new Error("Document recovery found unproven pending updates before installation");
+        }
+        if (input.historyCheckpoint.pruneCoveredLocalState &&
+            coveredLocalState.hasUnverifiedHistoryTail) {
+            throw new Error("Document recovery found unverified history tail before installation");
+        }
+        const checkpointReplaced = await replaceDocumentHistoryCheckpoint(execSql, { appKind: DOCUMENTS_APP_KIND, localId: input.document.id }, {
+            ...input.historyCheckpoint,
+            coveredTailIds: input.historyCheckpoint.pruneCoveredLocalState
+                ? coveredLocalState.tailIds
+                : input.historyCheckpoint.coveredTailIds,
+        });
+        if (input.historyCheckpoint.pruneCoveredLocalState && !checkpointReplaced) {
+            throw new Error("Document recovery checkpoint was superseded before installation");
+        }
+        await deleteAcceptedPendingUpdates(tx, input.document.id, coveredLocalState.checkpointIds);
+    }
+    if (input.historyUpdates && input.historyUpdates.length > 0) {
+        await appendDocumentHistoryUpdates(execSql, { appKind: DOCUMENTS_APP_KIND, localId: input.document.id }, input.historyUpdates, input.historyUpdateOrigin ?? "local");
+    }
+}
+async function findCoveredRecoveryLocalState(tx, localId, recoverySnapshot) {
+    const recoveredDocument = await createDocument(`recovery-tail-verification:${localId}`);
+    try {
+        importSnapshot(recoveredDocument, base64ToBytes(recoverySnapshot));
+        const scope = and(eq(documentPendingUpdates.appKind, DOCUMENTS_APP_KIND), eq(documentPendingUpdates.localId, localId));
+        const pendingUpdates = await tx
+            .select({
+            id: documentPendingUpdates.id,
+            sourceVersionVector: documentPendingUpdates.sourceVersionVector,
+            updateData: documentPendingUpdates.updateData,
+        })
+            .from(documentPendingUpdates)
+            .where(scope);
+        const tail = await tx
+            .select({
+            id: documentHistoryUpdates.id,
+            updateData: documentHistoryUpdates.updateData,
+        })
+            .from(documentHistoryUpdates)
+            .where(and(eq(documentHistoryUpdates.appKind, DOCUMENTS_APP_KIND), eq(documentHistoryUpdates.localId, localId)));
+        const checkpointUpdateData = new Set(pendingUpdates.flatMap((row) => row.id === null || row.sourceVersionVector === null
+            ? []
+            : [row.updateData]));
+        let hasUnverifiedHistoryTail = false;
+        const tailIds = tail.flatMap((row) => {
+            if (row.id === null) {
+                // An unverifiable row identity cannot participate in the guarded
+                // delete, so accepting it would leave a stale recovery redirect.
+                hasUnverifiedHistoryTail = true;
+                return [];
+            }
+            if (checkpointUpdateData.has(row.updateData))
+                return [row.id];
+            try {
+                if (updateMatchesDocumentHistory(recoveredDocument, base64ToBytes(row.updateData))) {
+                    return [row.id];
+                }
+            }
+            catch {
+                // Fall through: malformed history is not proven by the rebuild.
+            }
+            hasUnverifiedHistoryTail = true;
+            return [];
+        });
+        return {
+            checkpointIds: pendingUpdates.flatMap((row) => row.id !== null && row.sourceVersionVector !== null ? [row.id] : []),
+            hasOrdinaryPendingUpdates: pendingUpdates.some((row) => row.sourceVersionVector === null),
+            hasUnprunablePendingUpdates: pendingUpdates.some((row) => row.id === null),
+            hasUnverifiedHistoryTail,
+            tailIds,
+        };
+    }
+    finally {
+        recoveredDocument.free();
+    }
+}
+async function applyStoredDocumentMutation(input) {
+    const { lockedExecSql, mutation, tx } = input;
+    const currentRecord = await input.loadDocument(lockedExecSql, mutation.document.id);
+    if (mutation.stillCurrent && !mutation.stillCurrent()) {
+        return { committed: false, currentRecord };
+    }
+    if (!currentRecord ||
+        !sameExpectedDocumentRecord(currentRecord, mutation.expectedRecord)) {
+        await settleMutationConflict({ currentRecord, mutation, tx });
+        return { committed: false, currentRecord };
+    }
+    if (mutation.attachmentRemoval) {
+        await applyStoredAttachmentRemoval({
+            localId: mutation.document.id,
+            removal: mutation.attachmentRemoval,
+            tx,
+        });
+    }
+    if (mutation.attachmentStaging) {
+        await upsertStoredAttachmentStagingRows({
+            createdAt: new Date().toISOString(),
+            localId: mutation.document.id,
+            staging: mutation.attachmentStaging,
+            tx,
+        });
+    }
+    await appendMutationHistory(lockedExecSql, mutation, tx);
+    await insertPendingUpdate(tx, mutation.document.id, mutation.pendingUpdate);
+    await deleteAcceptedPendingUpdates(tx, mutation.document.id, mutation.acceptedPendingUpdateIds);
+    if (mutation.clearSyncFailure) {
+        await clearSyncFailure(tx, mutation.document.id);
+    }
+    const updatedAt = await resolveDocumentSaveTimestamp({
+        document: mutation.document,
+        options: mutation.updatedAt === undefined
+            ? undefined
+            : { updatedAt: mutation.updatedAt },
+        tx,
+    });
+    if (!(await saveDocumentRows({ document: mutation.document, tx, updatedAt }))) {
+        throw new Error("Document recovery generation changed before mutation save");
+    }
+    await input.saveClientProjection(lockedExecSql, updatedAt);
+    return { committed: true, updatedAt };
+}
+async function runStoredDocumentMutationTransaction(input) {
+    const outcome = await getClientSQLitePersistenceRuntime(input.lockedExecSql).guardedTransaction((tx) => applyStoredDocumentMutation({ ...input, tx }), () => !input.mutation.stillCurrent || input.mutation.stillCurrent(), { behavior: "immediate" });
+    if (outcome.committed && outcome.result) {
+        return outcome.result;
+    }
+    return {
+        committed: false,
+        currentRecord: await input.loadDocument(input.lockedExecSql, input.mutation.document.id),
+    };
+}
+export async function commitStoredDocumentMutation(execSql, input, saveClientProjection, loadDocument) {
+    return runSerializedSqlMutation(execSql, (lockedExecSql) => runStoredDocumentMutationTransaction({
+        lockedExecSql,
+        loadDocument,
+        mutation: input,
+        saveClientProjection,
+    }));
+}
+export async function settleStoredDocumentPendingUpdates(execSql, input, loadDocument) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async (tx) => {
+        const currentRecord = await loadDocument(lockedExecSql, input.expectedRecord.id);
+        if (currentRecord &&
+            sameDocumentSecurityIdentity(currentRecord, input.expectedRecord) &&
+            sameRecoveryGeneration(currentRecord, input.expectedRecord)) {
+            await deleteAcceptedPendingUpdates(tx, input.expectedRecord.id, input.pendingUpdateIds);
+        }
+        return currentRecord;
+    }, { behavior: "immediate" }));
+}
+//# sourceMappingURL=documentMutationPersistence.js.map

package/data/persistence/documents/internal/documentMutationPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentMutationPersistence.js","sourceRoot":"","sources":["documentMutationPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { base64ToBytes } from \"@tearleads/encoding\";\nimport {\n  createDocument,\n  importSnapshot,\n  updateMatchesDocumentHistory,\n} from \"@tearleads/loro\";\nimport { and, eq, inArray } from \"drizzle-orm\";\nimport { documentSyncPullContinuationsEqual } from \"../../../documents/shared/pullContinuation\";\nimport {\n  appendDocumentHistoryUpdates,\n  replaceDocumentHistoryCheckpoint,\n} from \"../../../sqlite/documentHistoryPersistence\";\nimport { insertDocumentPendingUpdateWithHistoryInTransaction } from \"../../../sqlite/documentPendingUpdatePersistence\";\nimport {\n  documentHistoryUpdates,\n  documentPendingUpdates,\n  documentSyncFailures,\n} from \"../../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport { runSerializedSqlMutation } from \"../../../sqlite/sqlSchema\";\nimport type { DocumentsPersistence, StoredDocumentRecord } from \"../types\";\nimport {\n  applyStoredAttachmentRemoval,\n  upsertStoredAttachmentStagingRows,\n} from \"./attachmentStagingPersistence\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\nimport {\n  sameDocumentSecurityIdentity,\n  sameNullableDocumentValue,\n} from \"./documentRecordIdentity\";\nimport { resolveDocumentSaveTimestamp, saveDocumentRows } from \"./documentRows\";\n\nfunction sameRecoveryGeneration(\n  current: StoredDocumentRecord,\n  expected: StoredDocumentRecord,\n): boolean {\n  return (\n    (current.recoveryGeneration ?? 0) === (expected.recoveryGeneration ?? 0)\n  );\n}\n\nfunction sameExpectedDocumentRecord(\n  current: StoredDocumentRecord,\n  expected: StoredDocumentRecord,\n): boolean {\n  return (\n    sameDocumentSecurityIdentity(current, expected) &&\n    sameRecoveryGeneration(current, expected) &&\n    sameNullableDocumentValue(current.lastCommitLsn, expected.lastCommitLsn) &&\n    current.snapshotEndVersion === expected.snapshotEndVersion &&\n    sameNullableDocumentValue(\n      current.pendingBaseVersion,\n      expected.pendingBaseVersion,\n    ) &&\n    documentSyncPullContinuationsEqual(\n      current.pullContinuation,\n      expected.pullContinuation,\n    ) &&\n    Boolean(current.pullContinuationRecoveryRequired) ===\n      Boolean(expected.pullContinuationRecoveryRequired) &&\n    (current.documentKind ?? null) === (expected.documentKind ?? null) &&\n    current.text === expected.text &&\n    (current.title ?? null) === (expected.title ?? null)\n  );\n}\n\nasync function deleteAcceptedPendingUpdates(\n  tx: ClientSQLiteTransactionScope,\n  localId: string,\n  ids: readonly string[],\n): Promise<void> {\n  const uniqueIds = [...new Set(ids)];\n  if (uniqueIds.length === 0) return;\n  await tx\n    .delete(documentPendingUpdates)\n    .where(\n      and(\n        eq(documentPendingUpdates.appKind, DOCUMENTS_APP_KIND),\n        eq(documentPendingUpdates.localId, localId),\n        inArray(documentPendingUpdates.id, uniqueIds),\n      ),\n    )\n    .run();\n}\n\nasync function clearSyncFailure(\n  tx: ClientSQLiteTransactionScope,\n  localId: string,\n): Promise<void> {\n  await tx\n    .delete(documentSyncFailures)\n    .where(\n      and(\n        eq(documentSyncFailures.appKind, DOCUMENTS_APP_KIND),\n        eq(documentSyncFailures.localId, localId),\n      ),\n    )\n    .run();\n}\n\nasync function insertPendingUpdate(\n  tx: ClientSQLiteTransactionScope,\n  documentId: string,\n  pendingUpdate: Parameters<\n    DocumentsPersistence[\"commitDocumentMutation\"]\n  >[1][\"pendingUpdate\"],\n): Promise<void> {\n  if (!pendingUpdate) return;\n  await insertDocumentPendingUpdateWithHistoryInTransaction({\n    createdAt: new Date().toISOString(),\n    pendingUpdate,\n    scope: { appKind: DOCUMENTS_APP_KIND, localId: documentId },\n    tx,\n  });\n}\n\nasync function settleMutationConflict(input: {\n  currentRecord: StoredDocumentRecord | null;\n  mutation: Parameters<DocumentsPersistence[\"commitDocumentMutation\"]>[1];\n  tx: ClientSQLiteTransactionScope;\n}): Promise<void> {\n  if (\n    input.currentRecord &&\n    input.mutation.settleAcceptedPendingOnConflict &&\n    sameDocumentSecurityIdentity(\n      input.currentRecord,\n      input.mutation.expectedRecord,\n    ) &&\n    sameRecoveryGeneration(input.currentRecord, input.mutation.expectedRecord)\n  ) {\n    await deleteAcceptedPendingUpdates(\n      input.tx,\n      input.mutation.document.id,\n      input.mutation.acceptedPendingUpdateIds,\n    );\n  }\n}\n\nasync function appendMutationHistory(\n  execSql: Parameters<DocumentsPersistence[\"commitDocumentMutation\"]>[0],\n  input: Parameters<DocumentsPersistence[\"commitDocumentMutation\"]>[1],\n  tx: ClientSQLiteTransactionScope,\n): Promise<void> {\n  if (input.historyCheckpoint) {\n    const coveredLocalState = input.historyCheckpoint.pruneCoveredLocalState\n      ? await findCoveredRecoveryLocalState(\n          tx,\n          input.document.id,\n          input.historyCheckpoint.snapshot,\n        )\n      : {\n          checkpointIds: [],\n          hasOrdinaryPendingUpdates: false,\n          hasUnprunablePendingUpdates: false,\n          hasUnverifiedHistoryTail: false,\n          tailIds: [],\n        };\n    if (\n      input.historyCheckpoint.pruneCoveredLocalState &&\n      (coveredLocalState.hasOrdinaryPendingUpdates ||\n        coveredLocalState.hasUnprunablePendingUpdates)\n    ) {\n      throw new Error(\n        \"Document recovery found unproven pending updates before installation\",\n      );\n    }\n    if (\n      input.historyCheckpoint.pruneCoveredLocalState &&\n      coveredLocalState.hasUnverifiedHistoryTail\n    ) {\n      throw new Error(\n        \"Document recovery found unverified history tail before installation\",\n      );\n    }\n    const checkpointReplaced = await replaceDocumentHistoryCheckpoint(\n      execSql,\n      { appKind: DOCUMENTS_APP_KIND, localId: input.document.id },\n      {\n        ...input.historyCheckpoint,\n        coveredTailIds: input.historyCheckpoint.pruneCoveredLocalState\n          ? coveredLocalState.tailIds\n          : input.historyCheckpoint.coveredTailIds,\n      },\n    );\n    if (input.historyCheckpoint.pruneCoveredLocalState && !checkpointReplaced) {\n      throw new Error(\n        \"Document recovery checkpoint was superseded before installation\",\n      );\n    }\n    await deleteAcceptedPendingUpdates(\n      tx,\n      input.document.id,\n      coveredLocalState.checkpointIds,\n    );\n  }\n  if (input.historyUpdates && input.historyUpdates.length > 0) {\n    await appendDocumentHistoryUpdates(\n      execSql,\n      { appKind: DOCUMENTS_APP_KIND, localId: input.document.id },\n      input.historyUpdates,\n      input.historyUpdateOrigin ?? \"local\",\n    );\n  }\n}\n\nasync function findCoveredRecoveryLocalState(\n  tx: ClientSQLiteTransactionScope,\n  localId: string,\n  recoverySnapshot: string,\n): Promise<{\n  checkpointIds: string[];\n  hasOrdinaryPendingUpdates: boolean;\n  hasUnprunablePendingUpdates: boolean;\n  hasUnverifiedHistoryTail: boolean;\n  tailIds: string[];\n}> {\n  const recoveredDocument = await createDocument(\n    `recovery-tail-verification:${localId}`,\n  );\n  try {\n    importSnapshot(recoveredDocument, base64ToBytes(recoverySnapshot));\n    const scope = and(\n      eq(documentPendingUpdates.appKind, DOCUMENTS_APP_KIND),\n      eq(documentPendingUpdates.localId, localId),\n    );\n    const pendingUpdates = await tx\n      .select({\n        id: documentPendingUpdates.id,\n        sourceVersionVector: documentPendingUpdates.sourceVersionVector,\n        updateData: documentPendingUpdates.updateData,\n      })\n      .from(documentPendingUpdates)\n      .where(scope);\n    const tail = await tx\n      .select({\n        id: documentHistoryUpdates.id,\n        updateData: documentHistoryUpdates.updateData,\n      })\n      .from(documentHistoryUpdates)\n      .where(\n        and(\n          eq(documentHistoryUpdates.appKind, DOCUMENTS_APP_KIND),\n          eq(documentHistoryUpdates.localId, localId),\n        ),\n      );\n    const checkpointUpdateData = new Set(\n      pendingUpdates.flatMap((row) =>\n        row.id === null || row.sourceVersionVector === null\n          ? []\n          : [row.updateData],\n      ),\n    );\n    let hasUnverifiedHistoryTail = false;\n    const tailIds = tail.flatMap((row) => {\n      if (row.id === null) {\n        // An unverifiable row identity cannot participate in the guarded\n        // delete, so accepting it would leave a stale recovery redirect.\n        hasUnverifiedHistoryTail = true;\n        return [];\n      }\n      if (checkpointUpdateData.has(row.updateData)) return [row.id];\n      try {\n        if (\n          updateMatchesDocumentHistory(\n            recoveredDocument,\n            base64ToBytes(row.updateData),\n          )\n        ) {\n          return [row.id];\n        }\n      } catch {\n        // Fall through: malformed history is not proven by the rebuild.\n      }\n      hasUnverifiedHistoryTail = true;\n      return [];\n    });\n    return {\n      checkpointIds: pendingUpdates.flatMap((row) =>\n        row.id !== null && row.sourceVersionVector !== null ? [row.id] : [],\n      ),\n      hasOrdinaryPendingUpdates: pendingUpdates.some(\n        (row) => row.sourceVersionVector === null,\n      ),\n      hasUnprunablePendingUpdates: pendingUpdates.some(\n        (row) => row.id === null,\n      ),\n      hasUnverifiedHistoryTail,\n      tailIds,\n    };\n  } finally {\n    recoveredDocument.free();\n  }\n}\n\ntype CommitDocumentMutationInput = Parameters<\n  DocumentsPersistence[\"commitDocumentMutation\"]\n>[1];\ntype SaveClientProjection = Parameters<\n  DocumentsPersistence[\"commitDocumentMutation\"]\n>[2];\n\nasync function applyStoredDocumentMutation(input: {\n  lockedExecSql: Parameters<DocumentsPersistence[\"commitDocumentMutation\"]>[0];\n  mutation: CommitDocumentMutationInput;\n  saveClientProjection: SaveClientProjection;\n  tx: ClientSQLiteTransactionScope;\n  loadDocument: DocumentsPersistence[\"loadDocument\"];\n}) {\n  const { lockedExecSql, mutation, tx } = input;\n  const currentRecord = await input.loadDocument(\n    lockedExecSql,\n    mutation.document.id,\n  );\n  if (mutation.stillCurrent && !mutation.stillCurrent()) {\n    return { committed: false as const, currentRecord };\n  }\n  if (\n    !currentRecord ||\n    !sameExpectedDocumentRecord(currentRecord, mutation.expectedRecord)\n  ) {\n    await settleMutationConflict({ currentRecord, mutation, tx });\n    return { committed: false as const, currentRecord };\n  }\n\n  if (mutation.attachmentRemoval) {\n    await applyStoredAttachmentRemoval({\n      localId: mutation.document.id,\n      removal: mutation.attachmentRemoval,\n      tx,\n    });\n  }\n  if (mutation.attachmentStaging) {\n    await upsertStoredAttachmentStagingRows({\n      createdAt: new Date().toISOString(),\n      localId: mutation.document.id,\n      staging: mutation.attachmentStaging,\n      tx,\n    });\n  }\n  await appendMutationHistory(lockedExecSql, mutation, tx);\n  await insertPendingUpdate(tx, mutation.document.id, mutation.pendingUpdate);\n  await deleteAcceptedPendingUpdates(\n    tx,\n    mutation.document.id,\n    mutation.acceptedPendingUpdateIds,\n  );\n  if (mutation.clearSyncFailure) {\n    await clearSyncFailure(tx, mutation.document.id);\n  }\n  const updatedAt = await resolveDocumentSaveTimestamp({\n    document: mutation.document,\n    options:\n      mutation.updatedAt === undefined\n        ? undefined\n        : { updatedAt: mutation.updatedAt },\n    tx,\n  });\n  if (\n    !(await saveDocumentRows({ document: mutation.document, tx, updatedAt }))\n  ) {\n    throw new Error(\n      \"Document recovery generation changed before mutation save\",\n    );\n  }\n  await input.saveClientProjection(lockedExecSql, updatedAt);\n  return { committed: true as const, updatedAt };\n}\n\nasync function runStoredDocumentMutationTransaction(input: {\n  lockedExecSql: Parameters<DocumentsPersistence[\"commitDocumentMutation\"]>[0];\n  mutation: CommitDocumentMutationInput;\n  saveClientProjection: SaveClientProjection;\n  loadDocument: DocumentsPersistence[\"loadDocument\"];\n}) {\n  const outcome = await getClientSQLitePersistenceRuntime(\n    input.lockedExecSql,\n  ).guardedTransaction(\n    (tx) => applyStoredDocumentMutation({ ...input, tx }),\n    () => !input.mutation.stillCurrent || input.mutation.stillCurrent(),\n    { behavior: \"immediate\" },\n  );\n  if (outcome.committed && outcome.result) {\n    return outcome.result;\n  }\n  return {\n    committed: false as const,\n    currentRecord: await input.loadDocument(\n      input.lockedExecSql,\n      input.mutation.document.id,\n    ),\n  };\n}\n\nexport async function commitStoredDocumentMutation(\n  execSql: Parameters<DocumentsPersistence[\"commitDocumentMutation\"]>[0],\n  input: CommitDocumentMutationInput,\n  saveClientProjection: SaveClientProjection,\n  loadDocument: DocumentsPersistence[\"loadDocument\"],\n) {\n  return runSerializedSqlMutation(execSql, (lockedExecSql) =>\n    runStoredDocumentMutationTransaction({\n      lockedExecSql,\n      loadDocument,\n      mutation: input,\n      saveClientProjection,\n    }),\n  );\n}\n\nexport async function settleStoredDocumentPendingUpdates(\n  execSql: Parameters<DocumentsPersistence[\"settleAcceptedPendingUpdates\"]>[0],\n  input: Parameters<DocumentsPersistence[\"settleAcceptedPendingUpdates\"]>[1],\n  loadDocument: DocumentsPersistence[\"loadDocument\"],\n) {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n    getClientSQLitePersistenceRuntime(lockedExecSql).transaction(\n      async (tx) => {\n        const currentRecord = await loadDocument(\n          lockedExecSql,\n          input.expectedRecord.id,\n        );\n        if (\n          currentRecord &&\n          sameDocumentSecurityIdentity(currentRecord, input.expectedRecord) &&\n          sameRecoveryGeneration(currentRecord, input.expectedRecord)\n        ) {\n          await deleteAcceptedPendingUpdates(\n            tx,\n            input.expectedRecord.id,\n            input.pendingUpdateIds,\n          );\n        }\n        return currentRecord;\n      },\n      { behavior: \"immediate\" },\n    ),\n  );\n}\n"]}

package/data/persistence/documents/internal/documentProjectionRows.js

@@ -0,0 +1,65 @@
+import { and, eq } from "drizzle-orm";
+import { normalizeEffectiveAccessLevel } from "../../../accessLevel.js";
+import { DEFAULT_DOCUMENT_KIND } from "../../../documents/documentConstants.js";
+import { deriveStoredDocumentTitle, getUntitledDocumentTitle, } from "../../../documents/documentKinds.js";
+import { documentProjection, documents } from "../../../sqlite/schema.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+// Deliberately excludes the projected text (`documentProjectionText`): the
+// title fallback is derived at write time, so summary listings never need to
+// haul content-sized values through the worker.
+export const documentSummarySelection = {
+    localId: documentProjection.localId,
+    documentId: documentProjection.documentId,
+    containerId: documentProjection.containerId,
+    documentKind: documentProjection.documentKind,
+    title: documentProjection.title,
+    updatedAt: documentProjection.updatedAt,
+    accessStateHash: documents.accessStateHash,
+    effectiveAccessLevel: documents.effectiveAccessLevel,
+};
+export const documentSummaryJoin = and(eq(documents.appKind, DOCUMENTS_APP_KIND), eq(documents.localId, documentProjection.localId));
+export function mapDocumentSummary(row) {
+    return {
+        accessStateHash: row.accessStateHash,
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(row.effectiveAccessLevel),
+        id: row.localId ?? "",
+        containerId: row.containerId,
+        documentKind: row.documentKind,
+        documentId: row.documentId,
+        title: getProjectionTitle(row),
+        updatedAt: row.updatedAt,
+    };
+}
+export function toDocumentSummary(record, updatedAt) {
+    return {
+        accessStateHash: record.accessStateHash ?? null,
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(record.effectiveAccessLevel),
+        id: record.id,
+        containerId: record.containerId,
+        documentKind: record.documentKind ?? DEFAULT_DOCUMENT_KIND,
+        documentId: record.documentId,
+        title: record.title ?? deriveStoredDocumentTitle(record.text),
+        updatedAt,
+    };
+}
+export function getProjectionText(row) {
+    return row?.text ?? "";
+}
+export function getProjectionContainerId(row) {
+    return row?.containerId ?? null;
+}
+export function getProjectionDocumentKind(row) {
+    return row?.documentKind ?? DEFAULT_DOCUMENT_KIND;
+}
+export function getProjectionTitle(row) {
+    const title = row?.title ?? "";
+    if (title.length > 0 &&
+        title !== getUntitledDocumentTitle(DEFAULT_DOCUMENT_KIND)) {
+        return title;
+    }
+    return deriveStoredDocumentTitle(row?.text ?? "");
+}
+export function getProjectionUpdatedAt(row) {
+    return row?.updatedAt ?? "";
+}
+//# sourceMappingURL=documentProjectionRows.js.map

package/data/persistence/documents/internal/documentProjectionRows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentProjectionRows.js","sourceRoot":"","sources":["documentProjectionRows.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq } from \"drizzle-orm\";\nimport { normalizeEffectiveAccessLevel } from \"../../../accessLevel\";\nimport { DEFAULT_DOCUMENT_KIND } from \"../../../documents/documentConstants\";\nimport {\n  deriveStoredDocumentTitle,\n  getUntitledDocumentTitle,\n  type StoredDocumentKind,\n} from \"../../../documents/documentKinds\";\nimport type { DocumentSummary } from \"../../../documents/documentSummary\";\nimport { documentProjection, documents } from \"../../../sqlite/schema\";\nimport type { StoredDocumentRecord } from \"../types\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\n\ninterface SelectedDocumentProjection {\n  localId: string | null;\n  documentId: string | null;\n  containerId: string | null;\n  documentKind: StoredDocumentKind;\n  title: string;\n  updatedAt: string;\n  accessStateHash: string | null;\n  effectiveAccessLevel: string | null;\n}\n\ninterface SelectedDocumentProjectionDetail {\n  text: string | null;\n  containerId: string | null;\n  documentKind: StoredDocumentKind;\n  title: string;\n}\n\ninterface SelectedDocumentProjectionTimestamp {\n  documentKind?: StoredDocumentKind;\n  text?: string | null;\n  title?: string;\n  updatedAt: string;\n}\n\n// Deliberately excludes the projected text (`documentProjectionText`): the\n// title fallback is derived at write time, so summary listings never need to\n// haul content-sized values through the worker.\nexport const documentSummarySelection = {\n  localId: documentProjection.localId,\n  documentId: documentProjection.documentId,\n  containerId: documentProjection.containerId,\n  documentKind: documentProjection.documentKind,\n  title: documentProjection.title,\n  updatedAt: documentProjection.updatedAt,\n  accessStateHash: documents.accessStateHash,\n  effectiveAccessLevel: documents.effectiveAccessLevel,\n};\n\nexport const documentSummaryJoin = and(\n  eq(documents.appKind, DOCUMENTS_APP_KIND),\n  eq(documents.localId, documentProjection.localId),\n);\n\nexport function mapDocumentSummary(\n  row: SelectedDocumentProjection,\n): DocumentSummary {\n  return {\n    accessStateHash: row.accessStateHash,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      row.effectiveAccessLevel,\n    ),\n    id: row.localId ?? \"\",\n    containerId: row.containerId,\n    documentKind: row.documentKind,\n    documentId: row.documentId,\n    title: getProjectionTitle(row),\n    updatedAt: row.updatedAt,\n  };\n}\n\nexport function toDocumentSummary(\n  record: StoredDocumentRecord,\n  updatedAt: string,\n): DocumentSummary {\n  return {\n    accessStateHash: record.accessStateHash ?? null,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      record.effectiveAccessLevel,\n    ),\n    id: record.id,\n    containerId: record.containerId,\n    documentKind: record.documentKind ?? DEFAULT_DOCUMENT_KIND,\n    documentId: record.documentId,\n    title: record.title ?? deriveStoredDocumentTitle(record.text),\n    updatedAt,\n  };\n}\n\nexport function getProjectionText(\n  row:\n    | SelectedDocumentProjectionDetail\n    | SelectedDocumentProjectionTimestamp\n    | undefined,\n): string {\n  return row?.text ?? \"\";\n}\n\nexport function getProjectionContainerId(\n  row: SelectedDocumentProjectionDetail | undefined,\n): string | null {\n  return row?.containerId ?? null;\n}\n\nexport function getProjectionDocumentKind(\n  row:\n    | SelectedDocumentProjectionDetail\n    | SelectedDocumentProjectionTimestamp\n    | undefined,\n): StoredDocumentKind {\n  return row?.documentKind ?? DEFAULT_DOCUMENT_KIND;\n}\n\nexport function getProjectionTitle(\n  row:\n    | SelectedDocumentProjectionDetail\n    | SelectedDocumentProjectionTimestamp\n    | undefined,\n): string {\n  const title = row?.title ?? \"\";\n  if (\n    title.length > 0 &&\n    title !== getUntitledDocumentTitle(DEFAULT_DOCUMENT_KIND)\n  ) {\n    return title;\n  }\n\n  return deriveStoredDocumentTitle(row?.text ?? \"\");\n}\n\nexport function getProjectionUpdatedAt(\n  row: SelectedDocumentProjectionTimestamp | undefined,\n): string {\n  return row?.updatedAt ?? \"\";\n}\n"]}

package/data/persistence/documents/internal/documentPullContinuationPersistence.js

@@ -0,0 +1,20 @@
+import { invalidateDocumentSyncPullContinuation } from "../../../sqlite/documentPersistence.js";
+import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { runSerializedSqlMutation } from "../../../sqlite/sqlSchema.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+export async function invalidateStoredDocumentPullContinuation(execSql, input, loadDocument, loadHistoryRestoreState) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async () => {
+        const invalidated = await invalidateDocumentSyncPullContinuation(lockedExecSql, {
+            ...input,
+            appKind: DOCUMENTS_APP_KIND,
+        });
+        if (!invalidated)
+            return null;
+        const record = await loadDocument(lockedExecSql, input.localId);
+        if (!record)
+            return null;
+        const historyRestoreState = await loadHistoryRestoreState(lockedExecSql, input.localId);
+        return { historyRestoreState, record };
+    }, { behavior: "immediate" }));
+}
+//# sourceMappingURL=documentPullContinuationPersistence.js.map

package/data/persistence/documents/internal/documentPullContinuationPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentPullContinuationPersistence.js","sourceRoot":"","sources":["documentPullContinuationPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,OAA0E,EAC1E,KAAwE,EACxE,YAAkD,EAClD,uBAAwE;IAExE,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAC/D,iCAAiC,CAAC,aAAa,CAAC,CAAC,WAAW,CAC1D,KAAK,IAAI,EAAE;QACT,MAAM,WAAW,GAAG,MAAM,sCAAsC,CAC9D,aAAa,EACb;YACE,GAAG,KAAK;YACR,OAAO,EAAE,kBAAkB;SAC5B,CACF,CAAC;QACF,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,mBAAmB,GAAG,MAAM,uBAAuB,CACvD,aAAa,EACb,KAAK,CAAC,OAAO,CACd,CAAC;QACF,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC,EACD,EAAE,QAAQ,EAAE,WAAW,EAAE,CAC1B,CACF,CAAC;AACJ,CAAC","sourcesContent":["import { invalidateDocumentSyncPullContinuation } from \"../../../sqlite/documentPersistence\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport { runSerializedSqlMutation } from \"../../../sqlite/sqlSchema\";\nimport type { DocumentsPersistence } from \"../types\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\n\nexport async function invalidateStoredDocumentPullContinuation(\n  execSql: Parameters<DocumentsPersistence[\"invalidatePullContinuation\"]>[0],\n  input: Parameters<DocumentsPersistence[\"invalidatePullContinuation\"]>[1],\n  loadDocument: DocumentsPersistence[\"loadDocument\"],\n  loadHistoryRestoreState: DocumentsPersistence[\"loadHistoryRestoreState\"],\n) {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n    getClientSQLitePersistenceRuntime(lockedExecSql).transaction(\n      async () => {\n        const invalidated = await invalidateDocumentSyncPullContinuation(\n          lockedExecSql,\n          {\n            ...input,\n            appKind: DOCUMENTS_APP_KIND,\n          },\n        );\n        if (!invalidated) return null;\n        const record = await loadDocument(lockedExecSql, input.localId);\n        if (!record) return null;\n        const historyRestoreState = await loadHistoryRestoreState(\n          lockedExecSql,\n          input.localId,\n        );\n        return { historyRestoreState, record };\n      },\n      { behavior: \"immediate\" },\n    ),\n  );\n}\n"]}

package/data/persistence/documents/internal/documentRecordIdentity.js

@@ -0,0 +1,20 @@
+export function sameNullableDocumentValue(left, right) {
+    return (left ?? null) === (right ?? null);
+}
+export function sameCanonicalDocumentSecurityIdentity(current, expected) {
+    return (current.id === expected.id &&
+        current.documentId === expected.documentId &&
+        sameNullableDocumentValue(current.recoveryDocumentId, expected.recoveryDocumentId) &&
+        current.accessEpoch === expected.accessEpoch &&
+        sameNullableDocumentValue(current.accessStateHash, expected.accessStateHash) &&
+        (current.effectiveAccessLevel ?? null) ===
+            (expected.effectiveAccessLevel ?? null) &&
+        sameNullableDocumentValue(current.contentKeyBundle, expected.contentKeyBundle) &&
+        sameNullableDocumentValue(current.documentKekTargets, expected.documentKekTargets) &&
+        sameNullableDocumentValue(current.documentManifestBundle, expected.documentManifestBundle));
+}
+export function sameDocumentSecurityIdentity(current, expected) {
+    return (sameCanonicalDocumentSecurityIdentity(current, expected) &&
+        current.containerId === expected.containerId);
+}
+//# sourceMappingURL=documentRecordIdentity.js.map

package/data/persistence/documents/internal/documentRecordIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRecordIdentity.js","sourceRoot":"","sources":["documentRecordIdentity.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,yBAAyB,CACvC,IAA+B,EAC/B,KAAgC;IAEhC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,OAAuB,EACvB,QAAwB;IAExB,OAAO,CACL,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE;QAC1B,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;QAC1C,yBAAyB,CACvB,OAAO,CAAC,kBAAkB,EAC1B,QAAQ,CAAC,kBAAkB,CAC5B;QACD,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;QAC5C,yBAAyB,CACvB,OAAO,CAAC,eAAe,EACvB,QAAQ,CAAC,eAAe,CACzB;QACD,CAAC,OAAO,CAAC,oBAAoB,IAAI,IAAI,CAAC;YACpC,CAAC,QAAQ,CAAC,oBAAoB,IAAI,IAAI,CAAC;QACzC,yBAAyB,CACvB,OAAO,CAAC,gBAAgB,EACxB,QAAQ,CAAC,gBAAgB,CAC1B;QACD,yBAAyB,CACvB,OAAO,CAAC,kBAAkB,EAC1B,QAAQ,CAAC,kBAAkB,CAC5B;QACD,yBAAyB,CACvB,OAAO,CAAC,sBAAsB,EAC9B,QAAQ,CAAC,sBAAsB,CAChC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA6B,EAC7B,QAA8B;IAE9B,OAAO,CACL,qCAAqC,CAAC,OAAO,EAAE,QAAQ,CAAC;QACxD,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,CAC7C,CAAC;AACJ,CAAC","sourcesContent":["import type { DocumentRecord } from \"../../../sqlite/documentPersistence\";\nimport type { StoredDocumentRecord } from \"../types\";\n\nexport function sameNullableDocumentValue(\n  left: string | null | undefined,\n  right: string | null | undefined,\n): boolean {\n  return (left ?? null) === (right ?? null);\n}\n\nexport function sameCanonicalDocumentSecurityIdentity(\n  current: DocumentRecord,\n  expected: DocumentRecord,\n): boolean {\n  return (\n    current.id === expected.id &&\n    current.documentId === expected.documentId &&\n    sameNullableDocumentValue(\n      current.recoveryDocumentId,\n      expected.recoveryDocumentId,\n    ) &&\n    current.accessEpoch === expected.accessEpoch &&\n    sameNullableDocumentValue(\n      current.accessStateHash,\n      expected.accessStateHash,\n    ) &&\n    (current.effectiveAccessLevel ?? null) ===\n      (expected.effectiveAccessLevel ?? null) &&\n    sameNullableDocumentValue(\n      current.contentKeyBundle,\n      expected.contentKeyBundle,\n    ) &&\n    sameNullableDocumentValue(\n      current.documentKekTargets,\n      expected.documentKekTargets,\n    ) &&\n    sameNullableDocumentValue(\n      current.documentManifestBundle,\n      expected.documentManifestBundle,\n    )\n  );\n}\n\nexport function sameDocumentSecurityIdentity(\n  current: StoredDocumentRecord,\n  expected: StoredDocumentRecord,\n): boolean {\n  return (\n    sameCanonicalDocumentSecurityIdentity(current, expected) &&\n    current.containerId === expected.containerId\n  );\n}\n"]}

package/data/persistence/documents/internal/documentRows.js

@@ -0,0 +1,178 @@
+import { and, eq } from "drizzle-orm";
+import { normalizeEffectiveAccessLevel } from "../../../accessLevel.js";
+import { DEFAULT_DOCUMENT_KIND } from "../../../documents/documentConstants.js";
+import { deriveStoredDocumentTitle } from "../../../documents/documentKinds.js";
+import { serializeDocumentSyncPullContinuation } from "../../../documents/shared/pullContinuation.js";
+import { documentRecordSelection, mapSelectedDocumentRecord, } from "../../../sqlite/documentPersistence.js";
+import { documentProjection, documentProjectionText, documents, } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+import { getProjectionDocumentKind, getProjectionText, getProjectionTitle, getProjectionUpdatedAt, } from "./documentProjectionRows.js";
+export function getDocumentScope(localId) {
+    return {
+        appKind: DOCUMENTS_APP_KIND,
+        localId,
+    };
+}
+export async function hasDocumentRow(execSql, localId) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select({ localId: documents.localId })
+        .from(documents)
+        .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), eq(documents.localId, localId)))
+        .limit(1);
+    return rows.length > 0;
+}
+async function loadDocumentRecordInTransaction(input) {
+    const { localId, tx } = input;
+    const rows = await tx
+        .select(documentRecordSelection)
+        .from(documents)
+        .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), eq(documents.localId, localId)))
+        .limit(1);
+    return rows[0] ? mapSelectedDocumentRecord(rows[0]) : null;
+}
+function toDocumentRecordRow(input) {
+    const { document, updatedAt } = input;
+    return {
+        appKind: DOCUMENTS_APP_KIND,
+        localId: document.id,
+        documentId: document.documentId,
+        recoveryGeneration: document.recoveryGeneration ?? 0,
+        recoveryDocumentId: document.documentId
+            ? null
+            : (document.recoveryDocumentId ?? null),
+        snapshotEndVersion: document.snapshotEndVersion,
+        accessEpoch: document.accessEpoch,
+        accessStateHash: document.accessStateHash ?? null,
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(document.effectiveAccessLevel),
+        lastCommitLsn: document.lastCommitLsn ?? null,
+        documentManifestBundle: document.documentManifestBundle ?? null,
+        contentKeyBundle: document.contentKeyBundle ?? null,
+        documentKekTargets: document.documentKekTargets ?? null,
+        // Only touch the outgoing-delta marker when the caller manages it. Callers
+        // that leave it undefined (e.g. discovery upserts, registration bootstrap)
+        // must not clobber a marker a device-first deferRemoteSync write persisted.
+        ...(document.pendingBaseVersion === undefined
+            ? {}
+            : { pendingBaseVersion: document.pendingBaseVersion }),
+        ...(document.pullContinuation === undefined
+            ? {}
+            : {
+                pullContinuation: serializeDocumentSyncPullContinuation(document.pullContinuation),
+            }),
+        updatedAt,
+    };
+}
+async function saveDocumentProjectionRows(input) {
+    const { document, tx, updatedAt } = input;
+    const projectionRow = {
+        localId: document.id,
+        documentId: document.documentId,
+        containerId: document.containerId,
+        documentKind: document.documentKind ?? DEFAULT_DOCUMENT_KIND,
+        title: document.title ?? deriveStoredDocumentTitle(document.text),
+        updatedAt,
+    };
+    await tx
+        .insert(documentProjection)
+        .values(projectionRow)
+        .onConflictDoUpdate({
+        target: documentProjection.localId,
+        set: projectionRow,
+    })
+        .run();
+    const projectionTextRow = {
+        localId: document.id,
+        text: document.text,
+    };
+    await tx
+        .insert(documentProjectionText)
+        .values(projectionTextRow)
+        .onConflictDoUpdate({
+        target: documentProjectionText.localId,
+        set: projectionTextRow,
+    })
+        .run();
+}
+export async function createDocumentRowsIfAbsent(input) {
+    const { document, tx, updatedAt } = input;
+    const documentRow = toDocumentRecordRow({ document, updatedAt });
+    const inserted = await tx
+        .insert(documents)
+        .values(documentRow)
+        .onConflictDoNothing({
+        target: [documents.appKind, documents.localId],
+    })
+        .returning({ localId: documents.localId });
+    if (inserted.length === 0) {
+        return false;
+    }
+    await saveDocumentProjectionRows(input);
+    return true;
+}
+export async function saveDocumentRows(input) {
+    const { document, tx, updatedAt } = input;
+    const existing = await loadDocumentRecordInTransaction({
+        localId: document.id,
+        tx,
+    });
+    if (existing &&
+        (existing.recoveryGeneration ?? 0) > (document.recoveryGeneration ?? 0)) {
+        return false;
+    }
+    const documentRow = toDocumentRecordRow({ document, updatedAt });
+    await tx
+        .insert(documents)
+        .values(documentRow)
+        .onConflictDoUpdate({
+        target: [documents.appKind, documents.localId],
+        set: documentRow,
+    })
+        .run();
+    await saveDocumentProjectionRows(input);
+    return true;
+}
+function didStoredDocumentContentChange(existing, next) {
+    return (existing === null ||
+        existing.documentKind !== (next.documentKind ?? DEFAULT_DOCUMENT_KIND) ||
+        existing.snapshotEndVersion !== next.snapshotEndVersion ||
+        existing.text !== next.text ||
+        existing.title !== (next.title ?? deriveStoredDocumentTitle(next.text)));
+}
+export async function resolveDocumentSaveTimestamp(input) {
+    const { document, options, tx } = input;
+    if (options?.updatedAt) {
+        return options.updatedAt;
+    }
+    const [existingRecord, projectionRows] = await Promise.all([
+        loadDocumentRecordInTransaction({
+            localId: document.id,
+            tx,
+        }),
+        tx
+            .select({
+            documentKind: documentProjection.documentKind,
+            text: documentProjectionText.text,
+            title: documentProjection.title,
+            updatedAt: documentProjection.updatedAt,
+        })
+            .from(documentProjection)
+            .leftJoin(documentProjectionText, eq(documentProjectionText.localId, documentProjection.localId))
+            .where(eq(documentProjection.localId, document.id))
+            .limit(1),
+    ]);
+    const existingProjection = projectionRows[0];
+    const now = new Date().toISOString();
+    return didStoredDocumentContentChange(existingRecord
+        ? {
+            documentKind: getProjectionDocumentKind(existingProjection),
+            snapshotEndVersion: existingRecord.snapshotEndVersion,
+            text: getProjectionText(existingProjection),
+            title: getProjectionTitle(existingProjection),
+        }
+        : null, document)
+        ? now
+        : getProjectionUpdatedAt(existingProjection) || now;
+}
+//# sourceMappingURL=documentRows.js.map

package/data/persistence/documents/internal/documentRows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRows.js","sourceRoot":"","sources":["documentRows.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq } from \"drizzle-orm\";\nimport { normalizeEffectiveAccessLevel } from \"../../../accessLevel\";\nimport { DEFAULT_DOCUMENT_KIND } from \"../../../documents/documentConstants\";\nimport { deriveStoredDocumentTitle } from \"../../../documents/documentKinds\";\nimport { serializeDocumentSyncPullContinuation } from \"../../../documents/shared/pullContinuation\";\nimport {\n  type DocumentRecord as BaseDocumentRecord,\n  type DocumentScope,\n  documentRecordSelection,\n  mapSelectedDocumentRecord,\n} from \"../../../sqlite/documentPersistence\";\nimport {\n  documentProjection,\n  documentProjectionText,\n  documents,\n} from \"../../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../../sqlite/sqlSchema\";\nimport type { StoredDocumentRecord } from \"../types\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\nimport {\n  getProjectionDocumentKind,\n  getProjectionText,\n  getProjectionTitle,\n  getProjectionUpdatedAt,\n} from \"./documentProjectionRows\";\n\nexport function getDocumentScope(localId: string): DocumentScope {\n  return {\n    appKind: DOCUMENTS_APP_KIND,\n    localId,\n  };\n}\n\nexport async function hasDocumentRow(\n  execSql: ExecSql,\n  localId: string,\n): Promise<boolean> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select({ localId: documents.localId })\n    .from(documents)\n    .where(\n      and(\n        eq(documents.appKind, DOCUMENTS_APP_KIND),\n        eq(documents.localId, localId),\n      ),\n    )\n    .limit(1);\n  return rows.length > 0;\n}\n\nasync function loadDocumentRecordInTransaction(input: {\n  localId: string;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<BaseDocumentRecord | null> {\n  const { localId, tx } = input;\n  const rows = await tx\n    .select(documentRecordSelection)\n    .from(documents)\n    .where(\n      and(\n        eq(documents.appKind, DOCUMENTS_APP_KIND),\n        eq(documents.localId, localId),\n      ),\n    )\n    .limit(1);\n\n  return rows[0] ? mapSelectedDocumentRecord(rows[0]) : null;\n}\n\nfunction toDocumentRecordRow(input: {\n  document: StoredDocumentRecord;\n  updatedAt: string;\n}) {\n  const { document, updatedAt } = input;\n  return {\n    appKind: DOCUMENTS_APP_KIND,\n    localId: document.id,\n    documentId: document.documentId,\n    recoveryGeneration: document.recoveryGeneration ?? 0,\n    recoveryDocumentId: document.documentId\n      ? null\n      : (document.recoveryDocumentId ?? null),\n    snapshotEndVersion: document.snapshotEndVersion,\n    accessEpoch: document.accessEpoch,\n    accessStateHash: document.accessStateHash ?? null,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      document.effectiveAccessLevel,\n    ),\n    lastCommitLsn: document.lastCommitLsn ?? null,\n    documentManifestBundle: document.documentManifestBundle ?? null,\n    contentKeyBundle: document.contentKeyBundle ?? null,\n    documentKekTargets: document.documentKekTargets ?? null,\n    // Only touch the outgoing-delta marker when the caller manages it. Callers\n    // that leave it undefined (e.g. discovery upserts, registration bootstrap)\n    // must not clobber a marker a device-first deferRemoteSync write persisted.\n    ...(document.pendingBaseVersion === undefined\n      ? {}\n      : { pendingBaseVersion: document.pendingBaseVersion }),\n    ...(document.pullContinuation === undefined\n      ? {}\n      : {\n          pullContinuation: serializeDocumentSyncPullContinuation(\n            document.pullContinuation,\n          ),\n        }),\n    updatedAt,\n  };\n}\n\nasync function saveDocumentProjectionRows(input: {\n  document: StoredDocumentRecord;\n  tx: ClientSQLiteTransactionScope;\n  updatedAt: string;\n}): Promise<void> {\n  const { document, tx, updatedAt } = input;\n  const projectionRow = {\n    localId: document.id,\n    documentId: document.documentId,\n    containerId: document.containerId,\n    documentKind: document.documentKind ?? DEFAULT_DOCUMENT_KIND,\n    title: document.title ?? deriveStoredDocumentTitle(document.text),\n    updatedAt,\n  };\n  await tx\n    .insert(documentProjection)\n    .values(projectionRow)\n    .onConflictDoUpdate({\n      target: documentProjection.localId,\n      set: projectionRow,\n    })\n    .run();\n\n  const projectionTextRow = {\n    localId: document.id,\n    text: document.text,\n  };\n  await tx\n    .insert(documentProjectionText)\n    .values(projectionTextRow)\n    .onConflictDoUpdate({\n      target: documentProjectionText.localId,\n      set: projectionTextRow,\n    })\n    .run();\n}\n\nexport async function createDocumentRowsIfAbsent(input: {\n  document: StoredDocumentRecord;\n  tx: ClientSQLiteTransactionScope;\n  updatedAt: string;\n}): Promise<boolean> {\n  const { document, tx, updatedAt } = input;\n  const documentRow = toDocumentRecordRow({ document, updatedAt });\n  const inserted = await tx\n    .insert(documents)\n    .values(documentRow)\n    .onConflictDoNothing({\n      target: [documents.appKind, documents.localId],\n    })\n    .returning({ localId: documents.localId });\n  if (inserted.length === 0) {\n    return false;\n  }\n\n  await saveDocumentProjectionRows(input);\n  return true;\n}\n\nexport async function saveDocumentRows(input: {\n  document: StoredDocumentRecord;\n  tx: ClientSQLiteTransactionScope;\n  updatedAt: string;\n}): Promise<boolean> {\n  const { document, tx, updatedAt } = input;\n  const existing = await loadDocumentRecordInTransaction({\n    localId: document.id,\n    tx,\n  });\n  if (\n    existing &&\n    (existing.recoveryGeneration ?? 0) > (document.recoveryGeneration ?? 0)\n  ) {\n    return false;\n  }\n  const documentRow = toDocumentRecordRow({ document, updatedAt });\n  await tx\n    .insert(documents)\n    .values(documentRow)\n    .onConflictDoUpdate({\n      target: [documents.appKind, documents.localId],\n      set: documentRow,\n    })\n    .run();\n  await saveDocumentProjectionRows(input);\n  return true;\n}\n\nfunction didStoredDocumentContentChange(\n  existing: Pick<\n    StoredDocumentRecord,\n    \"documentKind\" | \"snapshotEndVersion\" | \"text\" | \"title\"\n  > | null,\n  next: Pick<\n    StoredDocumentRecord,\n    \"documentKind\" | \"snapshotEndVersion\" | \"text\" | \"title\"\n  >,\n): boolean {\n  return (\n    existing === null ||\n    existing.documentKind !== (next.documentKind ?? DEFAULT_DOCUMENT_KIND) ||\n    existing.snapshotEndVersion !== next.snapshotEndVersion ||\n    existing.text !== next.text ||\n    existing.title !== (next.title ?? deriveStoredDocumentTitle(next.text))\n  );\n}\n\nexport async function resolveDocumentSaveTimestamp(input: {\n  document: StoredDocumentRecord;\n  options?: { updatedAt?: string } | undefined;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<string> {\n  const { document, options, tx } = input;\n  if (options?.updatedAt) {\n    return options.updatedAt;\n  }\n\n  const [existingRecord, projectionRows] = await Promise.all([\n    loadDocumentRecordInTransaction({\n      localId: document.id,\n      tx,\n    }),\n    tx\n      .select({\n        documentKind: documentProjection.documentKind,\n        text: documentProjectionText.text,\n        title: documentProjection.title,\n        updatedAt: documentProjection.updatedAt,\n      })\n      .from(documentProjection)\n      .leftJoin(\n        documentProjectionText,\n        eq(documentProjectionText.localId, documentProjection.localId),\n      )\n      .where(eq(documentProjection.localId, document.id))\n      .limit(1),\n  ]);\n  const existingProjection = projectionRows[0];\n  const now = new Date().toISOString();\n  return didStoredDocumentContentChange(\n    existingRecord\n      ? {\n          documentKind: getProjectionDocumentKind(existingProjection),\n          snapshotEndVersion: existingRecord.snapshotEndVersion,\n          text: getProjectionText(existingProjection),\n          title: getProjectionTitle(existingProjection),\n        }\n      : null,\n    document,\n  )\n    ? now\n    : getProjectionUpdatedAt(existingProjection) || now;\n}\n"]}