@tearleads/client-sdk 0.0.0-stage → 0.1.13

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

@@ -0,0 +1,167 @@
+import { and, eq, isNotNull } from "drizzle-orm";
+import { DEFAULT_DOCUMENT_KIND } from "../../../documents/documentConstants.js";
+import { resolveDocumentProjectorRegistry, } from "../../../documents/documentKinds.js";
+import { deleteDocumentHistory } from "../../../sqlite/documentHistoryPersistence.js";
+import { clearDocumentSyncFailure, deleteDocumentPendingUpdates, } from "../../../sqlite/documentPersistence.js";
+import { documentAttachmentBlobProjection, documentMoveIntents, documentMoveIntentTables, documentPendingAttachments, } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { ensureSqlTables, runSerializedSqlMutation, } from "../../../sqlite/sqlSchema.js";
+import { getDocumentScope, resolveDocumentSaveTimestamp, saveDocumentRows, } from "./documentRows.js";
+import { queueDocumentAttachmentStorageKeys } from "./orphanSideRows.js";
+function buildDiscardShellDocument(localId, existingDocument) {
+    return {
+        id: localId,
+        accessEpoch: existingDocument.accessEpoch,
+        accessStateHash: existingDocument.accessStateHash ?? null,
+        containerId: existingDocument.containerId,
+        contentKeyBundle: null,
+        documentId: existingDocument.documentId,
+        documentKekTargets: null,
+        documentManifestBundle: null,
+        effectiveAccessLevel: existingDocument.effectiveAccessLevel ?? null,
+        lastCommitLsn: null,
+        pendingBaseVersion: null,
+        pullContinuation: null,
+        recoveryGeneration: existingDocument.recoveryGeneration ?? 0,
+        snapshotEndVersion: "",
+        text: "",
+        ...(existingDocument.documentKind === undefined
+            ? {}
+            : { documentKind: existingDocument.documentKind }),
+        ...(existingDocument.title === undefined
+            ? {}
+            : { title: existingDocument.title }),
+    };
+}
+async function loadDiscardCandidate(input) {
+    const { expectedDocumentId, localId, lockedExecSql, persistence, tx } = input;
+    const existingDocument = await persistence.loadDocument(lockedExecSql, localId);
+    if (!existingDocument?.documentId ||
+        existingDocument.documentId !== expectedDocumentId ||
+        !existingDocument.containerId) {
+        return null;
+    }
+    const moveIntentRows = await tx
+        .select({ id: documentMoveIntents.id })
+        .from(documentMoveIntents)
+        .where(eq(documentMoveIntents.localId, localId))
+        .limit(1);
+    if (moveIntentRows.length > 0)
+        return null;
+    const pendingAttachments = await persistence.listPendingAttachments(lockedExecSql, localId);
+    const detachedRows = await tx
+        .select({ storageKey: documentAttachmentBlobProjection.storageKey })
+        .from(documentAttachmentBlobProjection)
+        .where(and(eq(documentAttachmentBlobProjection.localId, localId), isNotNull(documentAttachmentBlobProjection.detachedAt)));
+    return {
+        detachedStorageKeys: detachedRows.map((row) => row.storageKey),
+        existingDocument,
+        pendingAttachments,
+    };
+}
+// Staged-upload rows AND detached local-attachment markers both go: a marker
+// for a locally-discarded detach would otherwise keep filtering the slot out
+// after a re-pull restores it, leaving the attachment permanently invisible.
+async function clearDiscardedDocumentRows(input) {
+    const { candidate, localId, lockedExecSql, tx } = input;
+    await deleteDocumentPendingUpdates(lockedExecSql, getDocumentScope(localId));
+    await tx
+        .delete(documentPendingAttachments)
+        .where(eq(documentPendingAttachments.localId, localId))
+        .run();
+    for (const pendingAttachment of candidate.pendingAttachments) {
+        await tx
+            .delete(documentAttachmentBlobProjection)
+            .where(and(eq(documentAttachmentBlobProjection.localId, localId), eq(documentAttachmentBlobProjection.slotId, pendingAttachment.slotId), eq(documentAttachmentBlobProjection.storageKey, pendingAttachment.storageKey)))
+            .run();
+    }
+    await tx
+        .delete(documentAttachmentBlobProjection)
+        .where(and(eq(documentAttachmentBlobProjection.localId, localId), isNotNull(documentAttachmentBlobProjection.detachedAt)))
+        .run();
+    await deleteDocumentHistory(lockedExecSql, getDocumentScope(localId));
+    await clearDocumentSyncFailure(lockedExecSql, getDocumentScope(localId));
+}
+async function saveDiscardShell(input) {
+    const { candidate, documentProjectors, localId, lockedExecSql, tx } = input;
+    const shellDocument = buildDiscardShellDocument(localId, candidate.existingDocument);
+    // The document-kind projection derives from discarded content, so clear it
+    // inside the transaction and let the next pull rebuild it.
+    await documentProjectors.deleteStoredDocumentClientProjection({
+        documentKind: shellDocument.documentKind ?? DEFAULT_DOCUMENT_KIND,
+        execSql: lockedExecSql,
+        localId,
+    });
+    const updatedAt = await resolveDocumentSaveTimestamp({
+        document: shellDocument,
+        tx,
+    });
+    if (!(await saveDocumentRows({ document: shellDocument, tx, updatedAt }))) {
+        throw new Error("Document recovery generation changed during discard");
+    }
+}
+// Eligibility, teardown, client-projection clearing, and shell replacement
+// share one immediate transaction, so a second connection cannot relink the
+// local id between identity validation and destructive writes.
+async function discardDocumentRowsToShell(input) {
+    const clientProjectionTables = input.documentProjectors.getClientProjectionTables();
+    if (clientProjectionTables.length > 0) {
+        await ensureSqlTables(input.lockedExecSql, clientProjectionTables);
+    }
+    return getClientSQLitePersistenceRuntime(input.lockedExecSql).transaction(async (tx) => {
+        const candidate = await loadDiscardCandidate({ ...input, tx });
+        if (!candidate)
+            return { discarded: false };
+        await clearDiscardedDocumentRows({
+            candidate,
+            localId: input.localId,
+            lockedExecSql: input.lockedExecSql,
+            tx,
+        });
+        await saveDiscardShell({ ...input, candidate, tx });
+        // The deleted rows were these bytes' only pointers from this document,
+        // but a hydrated copy is shared by every slot holding the same blob.
+        // Queue them for the reference-checked reclaim instead of deleting.
+        await queueDocumentAttachmentStorageKeys(tx, [
+            ...new Set([
+                ...candidate.pendingAttachments.map((row) => row.storageKey),
+                ...candidate.detachedStorageKeys,
+            ]),
+        ]);
+        return {
+            discarded: true,
+            documentKind: candidate.existingDocument.documentKind ?? DEFAULT_DOCUMENT_KIND,
+        };
+    }, { behavior: "immediate" });
+}
+/**
+ * Atomically convert a stuck document's local state to the
+ * freshly-discovered-share shell: drop its queued updates, staged attachment
+ * rows (and their settled local-attachment halves, which share the staged
+ * storage keys the caller reclaims), detached attachment markers, durable
+ * history, recorded sync failure, and document-kind client projection, then
+ * overwrite the record with an empty snapshot that keeps its identity,
+ * placement, title, and kind. Everything commits in ONE transaction.
+ *
+ * Refused under the serialized mutation when the document is local-only or
+ * unlinked (its rows are the only copy), when its documentId no longer
+ * matches the caller's expectation (a stale caller or racing relink must not
+ * discard a different identity's edits), or when any move intent references
+ * it (the local containerId is then the move's optimistic placement, and
+ * reseeding it as server truth would silently commit the move locally while
+ * discarding the intent that was meant to perform it).
+ */
+export async function discardStoredDocumentToShell(input) {
+    const { expectedDocumentId, localId, persistence } = input;
+    return runSerializedSqlMutation(input.execSql, async (lockedExecSql) => {
+        await ensureSqlTables(lockedExecSql, documentMoveIntentTables);
+        return discardDocumentRowsToShell({
+            documentProjectors: resolveDocumentProjectorRegistry(input.documentProjectors),
+            expectedDocumentId,
+            localId,
+            lockedExecSql,
+            persistence,
+        });
+    });
+}
+//# sourceMappingURL=discardDocument.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discardDocument.js","sourceRoot":"","sources":["discardDocument.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, isNotNull } from \"drizzle-orm\";\nimport { DEFAULT_DOCUMENT_KIND } from \"../../../documents/documentConstants\";\nimport {\n  type DocumentProjectorRegistry,\n  type DocumentProjectorRegistryInput,\n  resolveDocumentProjectorRegistry,\n} from \"../../../documents/documentKinds\";\nimport { deleteDocumentHistory } from \"../../../sqlite/documentHistoryPersistence\";\nimport {\n  clearDocumentSyncFailure,\n  deleteDocumentPendingUpdates,\n} from \"../../../sqlite/documentPersistence\";\nimport {\n  documentAttachmentBlobProjection,\n  documentMoveIntents,\n  documentMoveIntentTables,\n  documentPendingAttachments,\n} from \"../../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  type ExecSql,\n  ensureSqlTables,\n  runSerializedSqlMutation,\n} from \"../../../sqlite/sqlSchema\";\nimport type {\n  DiscardDocumentToShellResult,\n  DocumentsPersistence,\n  StoredDocumentRecord,\n} from \"../types\";\nimport {\n  getDocumentScope,\n  resolveDocumentSaveTimestamp,\n  saveDocumentRows,\n} from \"./documentRows\";\nimport { queueDocumentAttachmentStorageKeys } from \"./orphanSideRows\";\n\nfunction buildDiscardShellDocument(\n  localId: string,\n  existingDocument: StoredDocumentRecord,\n): StoredDocumentRecord {\n  return {\n    id: localId,\n    accessEpoch: existingDocument.accessEpoch,\n    accessStateHash: existingDocument.accessStateHash ?? null,\n    containerId: existingDocument.containerId,\n    contentKeyBundle: null,\n    documentId: existingDocument.documentId,\n    documentKekTargets: null,\n    documentManifestBundle: null,\n    effectiveAccessLevel: existingDocument.effectiveAccessLevel ?? null,\n    lastCommitLsn: null,\n    pendingBaseVersion: null,\n    pullContinuation: null,\n    recoveryGeneration: existingDocument.recoveryGeneration ?? 0,\n    snapshotEndVersion: \"\",\n    text: \"\",\n    ...(existingDocument.documentKind === undefined\n      ? {}\n      : { documentKind: existingDocument.documentKind }),\n    ...(existingDocument.title === undefined\n      ? {}\n      : { title: existingDocument.title }),\n  };\n}\n\ninterface DiscardCandidate {\n  detachedStorageKeys: string[];\n  existingDocument: StoredDocumentRecord;\n  pendingAttachments: ReadonlyArray<{ slotId: string; storageKey: string }>;\n}\n\nasync function loadDiscardCandidate(input: {\n  expectedDocumentId: string;\n  localId: string;\n  lockedExecSql: ExecSql;\n  persistence: Pick<\n    DocumentsPersistence,\n    \"listPendingAttachments\" | \"loadDocument\"\n  >;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<DiscardCandidate | null> {\n  const { expectedDocumentId, localId, lockedExecSql, persistence, tx } = input;\n  const existingDocument = await persistence.loadDocument(\n    lockedExecSql,\n    localId,\n  );\n  if (\n    !existingDocument?.documentId ||\n    existingDocument.documentId !== expectedDocumentId ||\n    !existingDocument.containerId\n  ) {\n    return null;\n  }\n  const moveIntentRows = await tx\n    .select({ id: documentMoveIntents.id })\n    .from(documentMoveIntents)\n    .where(eq(documentMoveIntents.localId, localId))\n    .limit(1);\n  if (moveIntentRows.length > 0) return null;\n\n  const pendingAttachments = await persistence.listPendingAttachments(\n    lockedExecSql,\n    localId,\n  );\n  const detachedRows = await tx\n    .select({ storageKey: documentAttachmentBlobProjection.storageKey })\n    .from(documentAttachmentBlobProjection)\n    .where(\n      and(\n        eq(documentAttachmentBlobProjection.localId, localId),\n        isNotNull(documentAttachmentBlobProjection.detachedAt),\n      ),\n    );\n  return {\n    detachedStorageKeys: detachedRows.map((row) => row.storageKey),\n    existingDocument,\n    pendingAttachments,\n  };\n}\n\n// Staged-upload rows AND detached local-attachment markers both go: a marker\n// for a locally-discarded detach would otherwise keep filtering the slot out\n// after a re-pull restores it, leaving the attachment permanently invisible.\nasync function clearDiscardedDocumentRows(input: {\n  candidate: DiscardCandidate;\n  localId: string;\n  lockedExecSql: ExecSql;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<void> {\n  const { candidate, localId, lockedExecSql, tx } = input;\n  await deleteDocumentPendingUpdates(lockedExecSql, getDocumentScope(localId));\n  await tx\n    .delete(documentPendingAttachments)\n    .where(eq(documentPendingAttachments.localId, localId))\n    .run();\n  for (const pendingAttachment of candidate.pendingAttachments) {\n    await tx\n      .delete(documentAttachmentBlobProjection)\n      .where(\n        and(\n          eq(documentAttachmentBlobProjection.localId, localId),\n          eq(documentAttachmentBlobProjection.slotId, pendingAttachment.slotId),\n          eq(\n            documentAttachmentBlobProjection.storageKey,\n            pendingAttachment.storageKey,\n          ),\n        ),\n      )\n      .run();\n  }\n  await tx\n    .delete(documentAttachmentBlobProjection)\n    .where(\n      and(\n        eq(documentAttachmentBlobProjection.localId, localId),\n        isNotNull(documentAttachmentBlobProjection.detachedAt),\n      ),\n    )\n    .run();\n  await deleteDocumentHistory(lockedExecSql, getDocumentScope(localId));\n  await clearDocumentSyncFailure(lockedExecSql, getDocumentScope(localId));\n}\n\nasync function saveDiscardShell(input: {\n  candidate: DiscardCandidate;\n  documentProjectors: DocumentProjectorRegistry;\n  localId: string;\n  lockedExecSql: ExecSql;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<void> {\n  const { candidate, documentProjectors, localId, lockedExecSql, tx } = input;\n  const shellDocument = buildDiscardShellDocument(\n    localId,\n    candidate.existingDocument,\n  );\n  // The document-kind projection derives from discarded content, so clear it\n  // inside the transaction and let the next pull rebuild it.\n  await documentProjectors.deleteStoredDocumentClientProjection({\n    documentKind: shellDocument.documentKind ?? DEFAULT_DOCUMENT_KIND,\n    execSql: lockedExecSql,\n    localId,\n  });\n  const updatedAt = await resolveDocumentSaveTimestamp({\n    document: shellDocument,\n    tx,\n  });\n  if (!(await saveDocumentRows({ document: shellDocument, tx, updatedAt }))) {\n    throw new Error(\"Document recovery generation changed during discard\");\n  }\n}\n\n// Eligibility, teardown, client-projection clearing, and shell replacement\n// share one immediate transaction, so a second connection cannot relink the\n// local id between identity validation and destructive writes.\nasync function discardDocumentRowsToShell(input: {\n  documentProjectors: DocumentProjectorRegistry;\n  expectedDocumentId: string;\n  localId: string;\n  lockedExecSql: ExecSql;\n  persistence: Pick<\n    DocumentsPersistence,\n    \"listPendingAttachments\" | \"loadDocument\"\n  >;\n}): Promise<DiscardDocumentToShellResult> {\n  const clientProjectionTables =\n    input.documentProjectors.getClientProjectionTables();\n  if (clientProjectionTables.length > 0) {\n    await ensureSqlTables(input.lockedExecSql, clientProjectionTables);\n  }\n  return getClientSQLitePersistenceRuntime(input.lockedExecSql).transaction(\n    async (tx) => {\n      const candidate = await loadDiscardCandidate({ ...input, tx });\n      if (!candidate) return { discarded: false };\n      await clearDiscardedDocumentRows({\n        candidate,\n        localId: input.localId,\n        lockedExecSql: input.lockedExecSql,\n        tx,\n      });\n      await saveDiscardShell({ ...input, candidate, tx });\n      // The deleted rows were these bytes' only pointers from this document,\n      // but a hydrated copy is shared by every slot holding the same blob.\n      // Queue them for the reference-checked reclaim instead of deleting.\n      await queueDocumentAttachmentStorageKeys(tx, [\n        ...new Set([\n          ...candidate.pendingAttachments.map((row) => row.storageKey),\n          ...candidate.detachedStorageKeys,\n        ]),\n      ]);\n      return {\n        discarded: true,\n        documentKind:\n          candidate.existingDocument.documentKind ?? DEFAULT_DOCUMENT_KIND,\n      };\n    },\n    { behavior: \"immediate\" },\n  );\n}\n\n/**\n * Atomically convert a stuck document's local state to the\n * freshly-discovered-share shell: drop its queued updates, staged attachment\n * rows (and their settled local-attachment halves, which share the staged\n * storage keys the caller reclaims), detached attachment markers, durable\n * history, recorded sync failure, and document-kind client projection, then\n * overwrite the record with an empty snapshot that keeps its identity,\n * placement, title, and kind. Everything commits in ONE transaction.\n *\n * Refused under the serialized mutation when the document is local-only or\n * unlinked (its rows are the only copy), when its documentId no longer\n * matches the caller's expectation (a stale caller or racing relink must not\n * discard a different identity's edits), or when any move intent references\n * it (the local containerId is then the move's optimistic placement, and\n * reseeding it as server truth would silently commit the move locally while\n * discarding the intent that was meant to perform it).\n */\nexport async function discardStoredDocumentToShell(input: {\n  documentProjectors: DocumentProjectorRegistryInput;\n  execSql: ExecSql;\n  expectedDocumentId: string;\n  localId: string;\n  persistence: Pick<\n    DocumentsPersistence,\n    \"listPendingAttachments\" | \"loadDocument\"\n  >;\n}): Promise<DiscardDocumentToShellResult> {\n  const { expectedDocumentId, localId, persistence } = input;\n  return runSerializedSqlMutation(input.execSql, async (lockedExecSql) => {\n    await ensureSqlTables(lockedExecSql, documentMoveIntentTables);\n    return discardDocumentRowsToShell({\n      documentProjectors: resolveDocumentProjectorRegistry(\n        input.documentProjectors,\n      ),\n      expectedDocumentId,\n      localId,\n      lockedExecSql,\n      persistence,\n    });\n  });\n}\n"]}

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

@@ -0,0 +1,30 @@
+import { DEFAULT_DOCUMENT_ACCESS_EPOCH } from "../../../documents/documentConstants.js";
+import { loadDocumentMovePlacement } from "../../containers/documentPlacement.js";
+import { resolvePersistedAccessStateHash } from "./documentRuntimeState.js";
+export async function resolveDiscoveredDocumentPlacement(tx, existing, input) {
+    const intent = await loadDocumentMovePlacement(tx, input.documentId);
+    const stale = existing !== null && existing.accessEpoch > input.accessEpoch;
+    const accessEpoch = Math.max(existing?.accessEpoch ?? DEFAULT_DOCUMENT_ACCESS_EPOCH, input.accessEpoch);
+    const pendingContainerId = intent?.intentType === "document.link"
+        ? (existing?.containerId ?? intent.targetContainerId)
+        : intent?.targetContainerId;
+    const containerId = pendingContainerId ??
+        (stale
+            ? existing.containerId
+            : existing?.containerId &&
+                input.linkedContainerIds.includes(existing.containerId)
+                ? existing.containerId
+                : (input.linkedContainerIds.find((id) => id === input.containerId) ??
+                    input.linkedContainerIds[0] ??
+                    input.containerId));
+    return {
+        accessEpoch,
+        containerId,
+        accessStateHash: resolvePersistedAccessStateHash(existing, {
+            accessEpoch,
+            accessStateHash: stale ? existing.accessStateHash : input.accessStateHash,
+            documentId: input.documentId,
+        }),
+    };
+}
+//# sourceMappingURL=discoveredDocumentPlacement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discoveredDocumentPlacement.js","sourceRoot":"","sources":["discoveredDocumentPlacement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAGrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,EAAgC,EAChC,QAAqC,EACrC,KAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC5E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,QAAQ,EAAE,WAAW,IAAI,6BAA6B,EACtD,KAAK,CAAC,WAAW,CAClB,CAAC;IACF,MAAM,kBAAkB,GACtB,MAAM,EAAE,UAAU,KAAK,eAAe;QACpC,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,IAAI,MAAM,CAAC,iBAAiB,CAAC;QACrD,CAAC,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAChC,MAAM,WAAW,GACf,kBAAkB;QAClB,CAAC,KAAK;YACJ,CAAC,CAAC,QAAQ,CAAC,WAAW;YACtB,CAAC,CAAC,QAAQ,EAAE,WAAW;gBACnB,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACzD,CAAC,CAAC,QAAQ,CAAC,WAAW;gBACtB,CAAC,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,CAAC;oBAChE,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;oBAC3B,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5B,OAAO;QACL,WAAW;QACX,WAAW;QACX,eAAe,EAAE,+BAA+B,CAAC,QAAQ,EAAE;YACzD,WAAW;YACX,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe;YACzE,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;KACH,CAAC;AACJ,CAAC","sourcesContent":["import { DEFAULT_DOCUMENT_ACCESS_EPOCH } from \"../../../documents/documentConstants\";\nimport type { DiscoveredDocumentInput } from \"../../../documents/documentSummary\";\nimport type { ClientSQLiteTransactionScope } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport { loadDocumentMovePlacement } from \"../../containers/documentPlacement\";\nimport type { StoredDocumentRecord } from \"../types\";\nimport { resolvePersistedAccessStateHash } from \"./documentRuntimeState\";\n\nexport async function resolveDiscoveredDocumentPlacement(\n  tx: ClientSQLiteTransactionScope,\n  existing: StoredDocumentRecord | null,\n  input: DiscoveredDocumentInput,\n) {\n  const intent = await loadDocumentMovePlacement(tx, input.documentId);\n  const stale = existing !== null && existing.accessEpoch > input.accessEpoch;\n  const accessEpoch = Math.max(\n    existing?.accessEpoch ?? DEFAULT_DOCUMENT_ACCESS_EPOCH,\n    input.accessEpoch,\n  );\n  const pendingContainerId =\n    intent?.intentType === \"document.link\"\n      ? (existing?.containerId ?? intent.targetContainerId)\n      : intent?.targetContainerId;\n  const containerId =\n    pendingContainerId ??\n    (stale\n      ? existing.containerId\n      : existing?.containerId &&\n          input.linkedContainerIds.includes(existing.containerId)\n        ? existing.containerId\n        : (input.linkedContainerIds.find((id) => id === input.containerId) ??\n          input.linkedContainerIds[0] ??\n          input.containerId));\n  return {\n    accessEpoch,\n    containerId,\n    accessStateHash: resolvePersistedAccessStateHash(existing, {\n      accessEpoch,\n      accessStateHash: stale ? existing.accessStateHash : input.accessStateHash,\n      documentId: input.documentId,\n    }),\n  };\n}\n"]}

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

@@ -0,0 +1,152 @@
+import { and, eq, inArray, ne } from "drizzle-orm";
+import { deleteDocumentHistory } from "../../../sqlite/documentHistoryPersistence.js";
+import { clearDocumentSyncFailure, deleteDocumentPendingUpdates, deleteDocumentRecord, loadDocumentRecord, } from "../../../sqlite/documentPersistence.js";
+import { documentIntentLinkTargets } from "../../../sqlite/documentPlacementIntentSchema.js";
+import { documentAttachmentBlobProjection, documentContainerProjection, documentMoveIntents, documentMoveIntentTables, documentPendingAttachments, documentProjection, documentProjectionText, documents, } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { ensureSqlTables, runSerializedSqlMutation, } from "../../../sqlite/sqlSchema.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+import { deleteContainerDocumentTombstoneHoldsForDocuments } from "./containerDocumentTombstoneHolds.js";
+import { sameCanonicalDocumentSecurityIdentity } from "./documentRecordIdentity.js";
+import { getDocumentScope } from "./documentRows.js";
+import { queueDocumentAttachmentBlobReclaims } from "./orphanSideRows.js";
+async function deleteStoredDocumentRows(input) {
+    const { existingDocumentId, localId, lockedExecSql, tx } = input;
+    await queueDocumentAttachmentBlobReclaims({
+        localWhere: eq(documentAttachmentBlobProjection.localId, localId),
+        pendingWhere: eq(documentPendingAttachments.localId, localId),
+        tx,
+    });
+    await tx
+        .delete(documentProjection)
+        .where(eq(documentProjection.localId, localId))
+        .run();
+    await tx
+        .delete(documentProjectionText)
+        .where(eq(documentProjectionText.localId, localId))
+        .run();
+    await tx
+        .delete(documentPendingAttachments)
+        .where(eq(documentPendingAttachments.localId, localId))
+        .run();
+    await tx
+        .delete(documentAttachmentBlobProjection)
+        .where(eq(documentAttachmentBlobProjection.localId, localId))
+        .run();
+    if (existingDocumentId) {
+        await tx
+            .delete(documentContainerProjection)
+            .where(eq(documentContainerProjection.documentId, existingDocumentId))
+            .run();
+        await deleteContainerDocumentTombstoneHoldsForDocuments(tx, [
+            existingDocumentId,
+        ]);
+        await tx
+            .delete(documentIntentLinkTargets)
+            .where(inArray(documentIntentLinkTargets.intentId, tx
+            .select({ id: documentMoveIntents.id })
+            .from(documentMoveIntents)
+            .where(eq(documentMoveIntents.documentId, existingDocumentId))))
+            .run();
+        await tx
+            .delete(documentMoveIntents)
+            .where(eq(documentMoveIntents.documentId, existingDocumentId))
+            .run();
+    }
+    const scope = getDocumentScope(localId);
+    await deleteDocumentPendingUpdates(lockedExecSql, scope);
+    await deleteDocumentHistory(lockedExecSql, scope);
+    await clearDocumentSyncFailure(lockedExecSql, scope);
+    await deleteDocumentRecord(lockedExecSql, scope);
+}
+async function ensureDocumentDeletionTables(execSql) {
+    // Move intents live in the container-contents schema, which document-only
+    // callers may not have initialized yet.
+    await ensureSqlTables(execSql, documentMoveIntentTables);
+}
+async function hasAnotherDocumentAlias(input) {
+    const rows = await input.tx
+        .select({ localId: documents.localId })
+        .from(documents)
+        .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), eq(documents.documentId, input.documentId), ne(documents.localId, input.localId)))
+        .limit(1);
+    return rows.length > 0;
+}
+export async function deleteStoredDocument(execSql, localId) {
+    await runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        await ensureDocumentDeletionTables(lockedExecSql);
+        await getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async (tx) => {
+            const existingDocument = await loadDocumentRecord(lockedExecSql, {
+                appKind: DOCUMENTS_APP_KIND,
+                localId,
+            });
+            await deleteStoredDocumentRows({
+                existingDocumentId: existingDocument?.documentId ?? null,
+                localId,
+                lockedExecSql,
+                tx,
+            });
+        }, { behavior: "immediate" });
+    });
+}
+export async function deleteStoredDocumentIfMatches(execSql, expectedRecord, deleteClientProjection) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        await ensureDocumentDeletionTables(lockedExecSql);
+        return getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async (tx) => {
+            const existingDocument = await loadDocumentRecord(lockedExecSql, {
+                appKind: DOCUMENTS_APP_KIND,
+                localId: expectedRecord.id,
+            });
+            if (!existingDocument ||
+                !sameCanonicalDocumentSecurityIdentity(existingDocument, expectedRecord)) {
+                return false;
+            }
+            if (existingDocument.documentId &&
+                (await hasAnotherDocumentAlias({
+                    documentId: existingDocument.documentId,
+                    localId: expectedRecord.id,
+                    tx,
+                }))) {
+                return false;
+            }
+            await deleteStoredDocumentRows({
+                existingDocumentId: existingDocument.documentId ?? null,
+                localId: expectedRecord.id,
+                lockedExecSql,
+                tx,
+            });
+            await deleteClientProjection(lockedExecSql);
+            return true;
+        }, { behavior: "immediate" });
+    });
+}
+export async function deleteStoredDocumentSideRowsIfAbsent(execSql, localId, expectedDocumentId, deleteClientProjection) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        await ensureDocumentDeletionTables(lockedExecSql);
+        return getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async (tx) => {
+            const existingDocument = await loadDocumentRecord(lockedExecSql, {
+                appKind: DOCUMENTS_APP_KIND,
+                localId,
+            });
+            if (existingDocument)
+                return false;
+            if (expectedDocumentId &&
+                (await hasAnotherDocumentAlias({
+                    documentId: expectedDocumentId,
+                    localId,
+                    tx,
+                }))) {
+                return false;
+            }
+            await deleteStoredDocumentRows({
+                existingDocumentId: expectedDocumentId,
+                localId,
+                lockedExecSql,
+                tx,
+            });
+            await deleteClientProjection(lockedExecSql);
+            return true;
+        }, { behavior: "immediate" });
+    });
+}
+//# sourceMappingURL=documentDeletionPersistence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentDeletionPersistence.js","sourceRoot":"","sources":["documentDeletionPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, inArray, ne } from \"drizzle-orm\";\nimport { deleteDocumentHistory } from \"../../../sqlite/documentHistoryPersistence\";\nimport {\n  clearDocumentSyncFailure,\n  deleteDocumentPendingUpdates,\n  deleteDocumentRecord,\n  loadDocumentRecord,\n} from \"../../../sqlite/documentPersistence\";\nimport { documentIntentLinkTargets } from \"../../../sqlite/documentPlacementIntentSchema\";\nimport {\n  documentAttachmentBlobProjection,\n  documentContainerProjection,\n  documentMoveIntents,\n  documentMoveIntentTables,\n  documentPendingAttachments,\n  documentProjection,\n  documentProjectionText,\n  documents,\n} from \"../../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  type ExecSql,\n  ensureSqlTables,\n  runSerializedSqlMutation,\n} from \"../../../sqlite/sqlSchema\";\nimport type { StoredDocumentRecord } from \"../types\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\nimport { deleteContainerDocumentTombstoneHoldsForDocuments } from \"./containerDocumentTombstoneHolds\";\nimport { sameCanonicalDocumentSecurityIdentity } from \"./documentRecordIdentity\";\nimport { getDocumentScope } from \"./documentRows\";\nimport { queueDocumentAttachmentBlobReclaims } from \"./orphanSideRows\";\n\nasync function deleteStoredDocumentRows(input: {\n  existingDocumentId: string | null;\n  localId: string;\n  lockedExecSql: ExecSql;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<void> {\n  const { existingDocumentId, localId, lockedExecSql, tx } = input;\n  await queueDocumentAttachmentBlobReclaims({\n    localWhere: eq(documentAttachmentBlobProjection.localId, localId),\n    pendingWhere: eq(documentPendingAttachments.localId, localId),\n    tx,\n  });\n  await tx\n    .delete(documentProjection)\n    .where(eq(documentProjection.localId, localId))\n    .run();\n  await tx\n    .delete(documentProjectionText)\n    .where(eq(documentProjectionText.localId, localId))\n    .run();\n  await tx\n    .delete(documentPendingAttachments)\n    .where(eq(documentPendingAttachments.localId, localId))\n    .run();\n  await tx\n    .delete(documentAttachmentBlobProjection)\n    .where(eq(documentAttachmentBlobProjection.localId, localId))\n    .run();\n  if (existingDocumentId) {\n    await tx\n      .delete(documentContainerProjection)\n      .where(eq(documentContainerProjection.documentId, existingDocumentId))\n      .run();\n    await deleteContainerDocumentTombstoneHoldsForDocuments(tx, [\n      existingDocumentId,\n    ]);\n    await tx\n      .delete(documentIntentLinkTargets)\n      .where(\n        inArray(\n          documentIntentLinkTargets.intentId,\n          tx\n            .select({ id: documentMoveIntents.id })\n            .from(documentMoveIntents)\n            .where(eq(documentMoveIntents.documentId, existingDocumentId)),\n        ),\n      )\n      .run();\n    await tx\n      .delete(documentMoveIntents)\n      .where(eq(documentMoveIntents.documentId, existingDocumentId))\n      .run();\n  }\n  const scope = getDocumentScope(localId);\n  await deleteDocumentPendingUpdates(lockedExecSql, scope);\n  await deleteDocumentHistory(lockedExecSql, scope);\n  await clearDocumentSyncFailure(lockedExecSql, scope);\n  await deleteDocumentRecord(lockedExecSql, scope);\n}\n\nasync function ensureDocumentDeletionTables(execSql: ExecSql): Promise<void> {\n  // Move intents live in the container-contents schema, which document-only\n  // callers may not have initialized yet.\n  await ensureSqlTables(execSql, documentMoveIntentTables);\n}\n\nasync function hasAnotherDocumentAlias(input: {\n  documentId: string;\n  localId: string;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<boolean> {\n  const rows = await input.tx\n    .select({ localId: documents.localId })\n    .from(documents)\n    .where(\n      and(\n        eq(documents.appKind, DOCUMENTS_APP_KIND),\n        eq(documents.documentId, input.documentId),\n        ne(documents.localId, input.localId),\n      ),\n    )\n    .limit(1);\n  return rows.length > 0;\n}\n\nexport async function deleteStoredDocument(\n  execSql: ExecSql,\n  localId: string,\n): Promise<void> {\n  await runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    await ensureDocumentDeletionTables(lockedExecSql);\n    await getClientSQLitePersistenceRuntime(lockedExecSql).transaction(\n      async (tx) => {\n        const existingDocument = await loadDocumentRecord(lockedExecSql, {\n          appKind: DOCUMENTS_APP_KIND,\n          localId,\n        });\n        await deleteStoredDocumentRows({\n          existingDocumentId: existingDocument?.documentId ?? null,\n          localId,\n          lockedExecSql,\n          tx,\n        });\n      },\n      { behavior: \"immediate\" },\n    );\n  });\n}\n\nexport async function deleteStoredDocumentIfMatches(\n  execSql: ExecSql,\n  expectedRecord: StoredDocumentRecord,\n  deleteClientProjection: (transactionExecSql: ExecSql) => Promise<void>,\n): Promise<boolean> {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    await ensureDocumentDeletionTables(lockedExecSql);\n    return getClientSQLitePersistenceRuntime(lockedExecSql).transaction(\n      async (tx) => {\n        const existingDocument = await loadDocumentRecord(lockedExecSql, {\n          appKind: DOCUMENTS_APP_KIND,\n          localId: expectedRecord.id,\n        });\n        if (\n          !existingDocument ||\n          !sameCanonicalDocumentSecurityIdentity(\n            existingDocument,\n            expectedRecord,\n          )\n        ) {\n          return false;\n        }\n        if (\n          existingDocument.documentId &&\n          (await hasAnotherDocumentAlias({\n            documentId: existingDocument.documentId,\n            localId: expectedRecord.id,\n            tx,\n          }))\n        ) {\n          return false;\n        }\n        await deleteStoredDocumentRows({\n          existingDocumentId: existingDocument.documentId ?? null,\n          localId: expectedRecord.id,\n          lockedExecSql,\n          tx,\n        });\n        await deleteClientProjection(lockedExecSql);\n        return true;\n      },\n      { behavior: \"immediate\" },\n    );\n  });\n}\n\nexport async function deleteStoredDocumentSideRowsIfAbsent(\n  execSql: ExecSql,\n  localId: string,\n  expectedDocumentId: string | null,\n  deleteClientProjection: (transactionExecSql: ExecSql) => Promise<void>,\n): Promise<boolean> {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    await ensureDocumentDeletionTables(lockedExecSql);\n    return getClientSQLitePersistenceRuntime(lockedExecSql).transaction(\n      async (tx) => {\n        const existingDocument = await loadDocumentRecord(lockedExecSql, {\n          appKind: DOCUMENTS_APP_KIND,\n          localId,\n        });\n        if (existingDocument) return false;\n        if (\n          expectedDocumentId &&\n          (await hasAnotherDocumentAlias({\n            documentId: expectedDocumentId,\n            localId,\n            tx,\n          }))\n        ) {\n          return false;\n        }\n\n        await deleteStoredDocumentRows({\n          existingDocumentId: expectedDocumentId,\n          localId,\n          lockedExecSql,\n          tx,\n        });\n        await deleteClientProjection(lockedExecSql);\n        return true;\n      },\n      { behavior: \"immediate\" },\n    );\n  });\n}\n"]}

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

@@ -0,0 +1,10 @@
+import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { runSerializedSqlMutation } from "../../../sqlite/sqlSchema.js";
+export async function loadStoredDocumentWithHistoryRestoreState(execSql, localId, persistence) {
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async () => {
+        const document = await persistence.loadDocument(lockedExecSql, localId);
+        const historyRestoreState = await persistence.loadHistoryRestoreState(lockedExecSql, localId);
+        return { document, historyRestoreState };
+    }));
+}
+//# sourceMappingURL=documentHistoryStatePersistence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentHistoryStatePersistence.js","sourceRoot":"","sources":["documentHistoryStatePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,MAAM,CAAC,KAAK,UAAU,yCAAyC,CAC7D,OAEI,EACJ,OAAe,EACf,WAGC;IAED,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAC/D,iCAAiC,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;QACtE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,mBAAmB,GAAG,MAAM,WAAW,CAAC,uBAAuB,CACnE,aAAa,EACb,OAAO,CACR,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAC3C,CAAC,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport { runSerializedSqlMutation } from \"../../../sqlite/sqlSchema\";\nimport type { DocumentsPersistence } from \"../types\";\n\nexport async function loadStoredDocumentWithHistoryRestoreState(\n  execSql: Parameters<\n    DocumentsPersistence[\"loadDocumentWithHistoryRestoreState\"]\n  >[0],\n  localId: string,\n  persistence: Pick<\n    DocumentsPersistence,\n    \"loadDocument\" | \"loadHistoryRestoreState\"\n  >,\n): ReturnType<DocumentsPersistence[\"loadDocumentWithHistoryRestoreState\"]> {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n    getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async () => {\n      const document = await persistence.loadDocument(lockedExecSql, localId);\n      const historyRestoreState = await persistence.loadHistoryRestoreState(\n        lockedExecSql,\n        localId,\n      );\n      return { document, historyRestoreState };\n    }),\n  );\n}\n"]}