@tearleads/client-sdk 0.1.114 → 0.1.115

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

@@ -1,10 +1,12 @@
-import { and, eq, lte } from "drizzle-orm";
+import { and, eq, getTableColumns, lte } from "drizzle-orm";
 import { DEFAULT_DOCUMENT_KIND, DOCUMENTS_APP_KIND, } from "../../../documents/documentConstants.js";
 import { deriveStoredDocumentTitle, } from "../../../documents/documentKinds.js";
 import { serializeDocumentSyncPullContinuation } from "../../../documents/shared/sync/pullContinuation.js";
 import { normalizeEffectiveAccessLevel } from "../../../keying/accessLevel.js";
 import { documentProjection, documentProjectionText, documents, } from "../../../sqlite/schema/index.js";
+import { sqliteInsertBatchSize } from "../../../sqlite/sqliteBindBudget.js";
 import { getClientSQLitePersistenceRuntime, } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { excludedValue } from "../../../sqlite/sqliteUpsert.js";
 import { CLEARED_DOCUMENT_SYNC_FAILURE } from "../records/documentSyncFailurePersistence.js";
 import { getProjectionDocumentKind, getProjectionText, getProjectionTitle, getProjectionUpdatedAt, } from "./documentProjectionRows.js";
 export function getDocumentScope(localId) {
@@ -125,6 +127,99 @@ export async function saveDocumentRows(input) {
     await saveDocumentProjectionRows(input);
     return true;
 }
+/** A `set` clause that applies each conflicting row's own proposed values. */
+function excludedSet(columns, row) {
+    const set = {};
+    for (const key of Object.keys(row)) {
+        const column = columns[key];
+        if (!column)
+            throw new Error(`Unknown upsert column ${key}`);
+        set[key] = excludedValue(column);
+    }
+    return set;
+}
+function chunks(values, size) {
+    const result = [];
+    for (let offset = 0; offset < values.length; offset += size) {
+        result.push(values.slice(offset, offset + size));
+    }
+    return result;
+}
+/**
+ * `saveDocumentRows` for documents with DISTINCT local ids, as multi-row
+ * statements: one fenced documents upsert per chunk and row shape, then the
+ * projection and text upserts for the rows the fence let through. Returns
+ * those local ids; a row the recovery-generation fence skips returns no row,
+ * exactly as the single-row upsert does.
+ */
+export async function saveDocumentRowsBatch(input) {
+    const { entries, tx } = input;
+    const documentColumns = getTableColumns(documents);
+    // A row that omits an optional column leaves it untouched on update, so
+    // rows are grouped by their column shape and each shape gets its own set.
+    const shapes = new Map();
+    for (const entry of entries) {
+        const row = toDocumentRecordRow(entry);
+        const shape = Object.keys(row).join(",");
+        shapes.set(shape, [...(shapes.get(shape) ?? []), row]);
+    }
+    const saved = new Set();
+    for (const rows of shapes.values()) {
+        const [first] = rows;
+        if (!first)
+            continue;
+        const set = excludedSet(documentColumns, first);
+        for (const chunk of chunks(rows, sqliteInsertBatchSize(documents))) {
+            const returned = await tx
+                .insert(documents)
+                .values(chunk)
+                .onConflictDoUpdate({
+                target: [documents.appKind, documents.localId],
+                set,
+                setWhere: lte(documents.recoveryGeneration, excludedValue(documents.recoveryGeneration)),
+            })
+                .returning({ localId: documents.localId });
+            for (const row of returned)
+                saved.add(row.localId);
+        }
+    }
+    const savedEntries = entries.filter((entry) => saved.has(entry.document.id));
+    const projectionRows = savedEntries.map(({ document, updatedAt }) => ({
+        localId: document.id,
+        documentId: document.documentId,
+        containerId: document.containerId,
+        documentKind: document.documentKind ?? DEFAULT_DOCUMENT_KIND,
+        title: document.title ?? deriveStoredDocumentTitle(document.text),
+        updatedAt,
+    }));
+    const [firstProjection] = projectionRows;
+    if (firstProjection) {
+        const set = excludedSet(getTableColumns(documentProjection), firstProjection);
+        for (const chunk of chunks(projectionRows, sqliteInsertBatchSize(documentProjection))) {
+            await tx
+                .insert(documentProjection)
+                .values(chunk)
+                .onConflictDoUpdate({ target: documentProjection.localId, set })
+                .run();
+        }
+    }
+    const textRows = savedEntries.map(({ document }) => ({
+        localId: document.id,
+        text: document.text,
+    }));
+    const [firstText] = textRows;
+    if (firstText) {
+        const set = excludedSet(getTableColumns(documentProjectionText), firstText);
+        for (const chunk of chunks(textRows, sqliteInsertBatchSize(documentProjectionText))) {
+            await tx
+                .insert(documentProjectionText)
+                .values(chunk)
+                .onConflictDoUpdate({ target: documentProjectionText.localId, set })
+                .run();
+        }
+    }
+    return saved;
+}
 function didStoredDocumentContentChange(existing, next) {
     return (existing === null ||
         existing.documentKind !== (next.documentKind ?? DEFAULT_DOCUMENT_KIND) ||

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

@@ -1 +1 @@
-{"version":3,"file":"documentRows.js","sourceRoot":"","sources":["documentRows.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, lte } from \"drizzle-orm\";\nimport {\n  DEFAULT_DOCUMENT_KIND,\n  DOCUMENTS_APP_KIND,\n} from \"../../../documents/documentConstants\";\nimport {\n  deriveStoredDocumentTitle,\n  type StoredDocumentKind,\n} from \"../../../documents/documentKinds\";\nimport { serializeDocumentSyncPullContinuation } from \"../../../documents/shared/sync/pullContinuation\";\nimport { normalizeEffectiveAccessLevel } from \"../../../keying/accessLevel\";\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 { DocumentScope } from \"../records\";\nimport { CLEARED_DOCUMENT_SYNC_FAILURE } from \"../records/documentSyncFailurePersistence\";\nimport type { StoredDocumentRecord } from \"../types\";\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\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  /** Clears the recorded sync failure in the same guarded upsert. */\n  clearSyncFailure?: boolean;\n  document: StoredDocumentRecord;\n  tx: ClientSQLiteTransactionScope;\n  updatedAt: string;\n}): Promise<boolean> {\n  const { document, tx, updatedAt } = input;\n  const documentRow = {\n    ...toDocumentRecordRow({ document, updatedAt }),\n    ...(input.clearSyncFailure ? CLEARED_DOCUMENT_SYNC_FAILURE : {}),\n  };\n  // The recovery-generation fence rides on the upsert: a stored row from a\n  // newer recovery generation is left untouched and returns no row, so a\n  // stale writer skips the projection writes without a separate read.\n  const saved = await tx\n    .insert(documents)\n    .values(documentRow)\n    .onConflictDoUpdate({\n      target: [documents.appKind, documents.localId],\n      set: documentRow,\n      setWhere: lte(\n        documents.recoveryGeneration,\n        documentRow.recoveryGeneration,\n      ),\n    })\n    .returning({ localId: documents.localId });\n  if (saved.length === 0) {\n    return false;\n  }\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  // One read for the stored row and its projection; the projection columns\n  // are not nullable, so they are null exactly when the projection is absent.\n  const [existing] = await tx\n    .select({\n      snapshotEndVersion: documents.snapshotEndVersion,\n      documentKind: documentProjection.documentKind,\n      text: documentProjectionText.text,\n      title: documentProjection.title,\n      updatedAt: documentProjection.updatedAt,\n    })\n    .from(documents)\n    .leftJoin(\n      documentProjection,\n      eq(documentProjection.localId, documents.localId),\n    )\n    .leftJoin(\n      documentProjectionText,\n      eq(documentProjectionText.localId, documentProjection.localId),\n    )\n    .where(\n      and(\n        eq(documents.appKind, DOCUMENTS_APP_KIND),\n        eq(documents.localId, document.id),\n      ),\n    )\n    .limit(1);\n  return documentSaveTimestampFrom(\n    existing\n      ? {\n          projection:\n            existing.documentKind != null &&\n            existing.title != null &&\n            existing.updatedAt != null\n              ? {\n                  documentKind: existing.documentKind,\n                  text: existing.text,\n                  title: existing.title,\n                  updatedAt: existing.updatedAt,\n                }\n              : null,\n          snapshotEndVersion: existing.snapshotEndVersion,\n        }\n      : null,\n    document,\n  );\n}\n\n/**\n * The save timestamp from rows already read in the saving transaction: the\n * stored time survives only when the content is unchanged.\n */\nexport function documentSaveTimestampFrom(\n  existing: {\n    projection: {\n      documentKind: StoredDocumentKind;\n      text: string | null;\n      title: string;\n      updatedAt: string;\n    } | null;\n    snapshotEndVersion: string;\n  } | null,\n  document: StoredDocumentRecord,\n): string {\n  const existingProjection = existing?.projection ?? undefined;\n  const now = new Date().toISOString();\n  return didStoredDocumentContentChange(\n    existing\n      ? {\n          documentKind: getProjectionDocumentKind(existingProjection),\n          snapshotEndVersion: existing.snapshotEndVersion,\n          text: getProjectionText(existingProjection),\n          title: getProjectionTitle(existingProjection),\n        }\n      : null,\n    document,\n  )\n    ? now\n    : getProjectionUpdatedAt(existingProjection) || now;\n}\n"]}
+{"version":3,"file":"documentRows.js","sourceRoot":"","sources":["documentRows.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, getTableColumns, lte, type SQL } from \"drizzle-orm\";\nimport type { SQLiteColumn } from \"drizzle-orm/sqlite-core\";\nimport {\n  DEFAULT_DOCUMENT_KIND,\n  DOCUMENTS_APP_KIND,\n} from \"../../../documents/documentConstants\";\nimport {\n  deriveStoredDocumentTitle,\n  type StoredDocumentKind,\n} from \"../../../documents/documentKinds\";\nimport { serializeDocumentSyncPullContinuation } from \"../../../documents/shared/sync/pullContinuation\";\nimport { normalizeEffectiveAccessLevel } from \"../../../keying/accessLevel\";\nimport {\n  documentProjection,\n  documentProjectionText,\n  documents,\n} from \"../../../sqlite/schema\";\nimport { sqliteInsertBatchSize } from \"../../../sqlite/sqliteBindBudget\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport { excludedValue } from \"../../../sqlite/sqliteUpsert\";\nimport type { ExecSql } from \"../../../sqlite/sqlSchema\";\nimport type { DocumentScope } from \"../records\";\nimport { CLEARED_DOCUMENT_SYNC_FAILURE } from \"../records/documentSyncFailurePersistence\";\nimport type { StoredDocumentRecord } from \"../types\";\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\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  /** Clears the recorded sync failure in the same guarded upsert. */\n  clearSyncFailure?: boolean;\n  document: StoredDocumentRecord;\n  tx: ClientSQLiteTransactionScope;\n  updatedAt: string;\n}): Promise<boolean> {\n  const { document, tx, updatedAt } = input;\n  const documentRow = {\n    ...toDocumentRecordRow({ document, updatedAt }),\n    ...(input.clearSyncFailure ? CLEARED_DOCUMENT_SYNC_FAILURE : {}),\n  };\n  // The recovery-generation fence rides on the upsert: a stored row from a\n  // newer recovery generation is left untouched and returns no row, so a\n  // stale writer skips the projection writes without a separate read.\n  const saved = await tx\n    .insert(documents)\n    .values(documentRow)\n    .onConflictDoUpdate({\n      target: [documents.appKind, documents.localId],\n      set: documentRow,\n      setWhere: lte(\n        documents.recoveryGeneration,\n        documentRow.recoveryGeneration,\n      ),\n    })\n    .returning({ localId: documents.localId });\n  if (saved.length === 0) {\n    return false;\n  }\n  await saveDocumentProjectionRows(input);\n  return true;\n}\n\ntype UpsertRow = Record<string, unknown>;\n\n/** A `set` clause that applies each conflicting row's own proposed values. */\nfunction excludedSet(\n  columns: Record<string, SQLiteColumn>,\n  row: UpsertRow,\n): Record<string, SQL> {\n  const set: Record<string, SQL> = {};\n  for (const key of Object.keys(row)) {\n    const column = columns[key];\n    if (!column) throw new Error(`Unknown upsert column ${key}`);\n    set[key] = excludedValue(column);\n  }\n  return set;\n}\n\nfunction chunks<T>(values: ReadonlyArray<T>, size: number): T[][] {\n  const result: T[][] = [];\n  for (let offset = 0; offset < values.length; offset += size) {\n    result.push(values.slice(offset, offset + size));\n  }\n  return result;\n}\n\n/**\n * `saveDocumentRows` for documents with DISTINCT local ids, as multi-row\n * statements: one fenced documents upsert per chunk and row shape, then the\n * projection and text upserts for the rows the fence let through. Returns\n * those local ids; a row the recovery-generation fence skips returns no row,\n * exactly as the single-row upsert does.\n */\nexport async function saveDocumentRowsBatch(input: {\n  entries: ReadonlyArray<{ document: StoredDocumentRecord; updatedAt: string }>;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<Set<string>> {\n  const { entries, tx } = input;\n  const documentColumns: Record<string, SQLiteColumn> =\n    getTableColumns(documents);\n  // A row that omits an optional column leaves it untouched on update, so\n  // rows are grouped by their column shape and each shape gets its own set.\n  const shapes = new Map<string, ReturnType<typeof toDocumentRecordRow>[]>();\n  for (const entry of entries) {\n    const row = toDocumentRecordRow(entry);\n    const shape = Object.keys(row).join(\",\");\n    shapes.set(shape, [...(shapes.get(shape) ?? []), row]);\n  }\n  const saved = new Set<string>();\n  for (const rows of shapes.values()) {\n    const [first] = rows;\n    if (!first) continue;\n    const set = excludedSet(documentColumns, first);\n    for (const chunk of chunks(rows, sqliteInsertBatchSize(documents))) {\n      const returned = await tx\n        .insert(documents)\n        .values(chunk)\n        .onConflictDoUpdate({\n          target: [documents.appKind, documents.localId],\n          set,\n          setWhere: lte(\n            documents.recoveryGeneration,\n            excludedValue(documents.recoveryGeneration),\n          ),\n        })\n        .returning({ localId: documents.localId });\n      for (const row of returned) saved.add(row.localId);\n    }\n  }\n\n  const savedEntries = entries.filter((entry) => saved.has(entry.document.id));\n  const projectionRows = savedEntries.map(({ document, updatedAt }) => ({\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  const [firstProjection] = projectionRows;\n  if (firstProjection) {\n    const set = excludedSet(\n      getTableColumns(documentProjection),\n      firstProjection,\n    );\n    for (const chunk of chunks(\n      projectionRows,\n      sqliteInsertBatchSize(documentProjection),\n    )) {\n      await tx\n        .insert(documentProjection)\n        .values(chunk)\n        .onConflictDoUpdate({ target: documentProjection.localId, set })\n        .run();\n    }\n  }\n  const textRows = savedEntries.map(({ document }) => ({\n    localId: document.id,\n    text: document.text,\n  }));\n  const [firstText] = textRows;\n  if (firstText) {\n    const set = excludedSet(getTableColumns(documentProjectionText), firstText);\n    for (const chunk of chunks(\n      textRows,\n      sqliteInsertBatchSize(documentProjectionText),\n    )) {\n      await tx\n        .insert(documentProjectionText)\n        .values(chunk)\n        .onConflictDoUpdate({ target: documentProjectionText.localId, set })\n        .run();\n    }\n  }\n  return saved;\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  // One read for the stored row and its projection; the projection columns\n  // are not nullable, so they are null exactly when the projection is absent.\n  const [existing] = await tx\n    .select({\n      snapshotEndVersion: documents.snapshotEndVersion,\n      documentKind: documentProjection.documentKind,\n      text: documentProjectionText.text,\n      title: documentProjection.title,\n      updatedAt: documentProjection.updatedAt,\n    })\n    .from(documents)\n    .leftJoin(\n      documentProjection,\n      eq(documentProjection.localId, documents.localId),\n    )\n    .leftJoin(\n      documentProjectionText,\n      eq(documentProjectionText.localId, documentProjection.localId),\n    )\n    .where(\n      and(\n        eq(documents.appKind, DOCUMENTS_APP_KIND),\n        eq(documents.localId, document.id),\n      ),\n    )\n    .limit(1);\n  return documentSaveTimestampFrom(\n    existing\n      ? {\n          projection:\n            existing.documentKind != null &&\n            existing.title != null &&\n            existing.updatedAt != null\n              ? {\n                  documentKind: existing.documentKind,\n                  text: existing.text,\n                  title: existing.title,\n                  updatedAt: existing.updatedAt,\n                }\n              : null,\n          snapshotEndVersion: existing.snapshotEndVersion,\n        }\n      : null,\n    document,\n  );\n}\n\n/**\n * The save timestamp from rows already read in the saving transaction: the\n * stored time survives only when the content is unchanged.\n */\nexport function documentSaveTimestampFrom(\n  existing: {\n    projection: {\n      documentKind: StoredDocumentKind;\n      text: string | null;\n      title: string;\n      updatedAt: string;\n    } | null;\n    snapshotEndVersion: string;\n  } | null,\n  document: StoredDocumentRecord,\n): string {\n  const existingProjection = existing?.projection ?? undefined;\n  const now = new Date().toISOString();\n  return didStoredDocumentContentChange(\n    existing\n      ? {\n          documentKind: getProjectionDocumentKind(existingProjection),\n          snapshotEndVersion: existing.snapshotEndVersion,\n          text: getProjectionText(existingProjection),\n          title: getProjectionTitle(existingProjection),\n        }\n      : null,\n    document,\n  )\n    ? now\n    : getProjectionUpdatedAt(existingProjection) || now;\n}\n"]}

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

@@ -1,34 +1,30 @@
-import { and, desc, eq, notInArray } from "drizzle-orm";
+import { and, desc, eq, inArray, notInArray } from "drizzle-orm";
 import { DOCUMENTS_APP_KIND } from "../../../documents/documentConstants.js";
 import { HIDDEN_DOCUMENT_SUMMARY_KINDS } from "../../../documents/documentSummary.js";
 import { documentProjection, documentProjectionText, documents, } from "../../../sqlite/schema/index.js";
+import { sqliteRowsPerStatement } from "../../../sqlite/sqliteBindBudget.js";
 import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
 import { documentRecordSelection, findLocalIdByDocumentId, loadDocumentRecord, mapSelectedDocumentRecord, } from "../records/index.js";
 import { documentSummaryJoin, documentSummarySelection, getProjectionContainerId, getProjectionDocumentKind, getProjectionText, getProjectionTitle, mapDocumentSummary, } from "./documentProjectionRows.js";
 import { getDocumentScope, hasDocumentRow } from "./documentRows.js";
-/**
- * The canonical record and its projection from ONE joined statement, so the
- * pair comes from one snapshot and a save inside the same transaction can
- * reuse the projection instead of reading it again.
- */
-export async function loadStoredDocumentState(execSql, localId) {
+const storedDocumentStateSelection = {
+    ...documentRecordSelection,
+    projectionContainerId: documentProjection.containerId,
+    projectionDocumentKind: documentProjection.documentKind,
+    projectionText: documentProjectionText.text,
+    projectionTitle: documentProjection.title,
+    projectionUpdatedAt: documentProjection.updatedAt,
+};
+function storedDocumentStateQuery(execSql, localIds) {
     const { db } = getClientSQLitePersistenceRuntime(execSql);
-    const [row] = await db
-        .select({
-        ...documentRecordSelection,
-        projectionContainerId: documentProjection.containerId,
-        projectionDocumentKind: documentProjection.documentKind,
-        projectionText: documentProjectionText.text,
-        projectionTitle: documentProjection.title,
-        projectionUpdatedAt: documentProjection.updatedAt,
-    })
+    return db
+        .select(storedDocumentStateSelection)
         .from(documents)
         .leftJoin(documentProjection, eq(documentProjection.localId, documents.localId))
         .leftJoin(documentProjectionText, eq(documentProjectionText.localId, documentProjection.localId))
-        .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), eq(documents.localId, localId)))
-        .limit(1);
-    if (!row)
-        return null;
+        .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), localIds));
+}
+function mapStoredDocumentState(row) {
     const { projectionContainerId, projectionDocumentKind, projectionText, projectionTitle, projectionUpdatedAt, ...recordRow } = row;
     // Projection columns are NOT NULL, so they are null exactly when the
     // projection row is absent.
@@ -55,6 +51,28 @@ export async function loadStoredDocumentState(execSql, localId) {
         },
     };
 }
+/**
+ * The canonical record and its projection from ONE joined statement, so the
+ * pair comes from one snapshot and a save inside the same transaction can
+ * reuse the projection instead of reading it again.
+ */
+export async function loadStoredDocumentState(execSql, localId) {
+    const [row] = await storedDocumentStateQuery(execSql, eq(documents.localId, localId)).limit(1);
+    return row ? mapStoredDocumentState(row) : null;
+}
+/** `loadStoredDocumentState` for many local ids, one joined read per chunk. */
+export async function loadStoredDocumentStates(execSql, localIds) {
+    const states = new Map();
+    const unique = Array.from(new Set(localIds));
+    // One bind for the app kind; the rest carry local ids.
+    const chunkSize = sqliteRowsPerStatement(1, 1);
+    for (let offset = 0; offset < unique.length; offset += chunkSize) {
+        const rows = await storedDocumentStateQuery(execSql, inArray(documents.localId, unique.slice(offset, offset + chunkSize)));
+        for (const row of rows)
+            states.set(row.id, mapStoredDocumentState(row));
+    }
+    return states;
+}
 export const documentRowQueryPersistence = {
     async listDocuments(execSql) {
         const { db } = getClientSQLitePersistenceRuntime(execSql);

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

@@ -1 +1 @@
-{"version":3,"file":"rowQueryPersistence.js","sourceRoot":"","sources":["rowQueryPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, desc, eq, notInArray } from \"drizzle-orm\";\nimport { DOCUMENTS_APP_KIND } from \"../../../documents/documentConstants\";\nimport type { StoredDocumentKind } from \"../../../documents/documentKinds\";\nimport { HIDDEN_DOCUMENT_SUMMARY_KINDS } from \"../../../documents/documentSummary\";\nimport {\n  documentProjection,\n  documentProjectionText,\n  documents,\n} from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  documentRecordSelection,\n  findLocalIdByDocumentId,\n  loadDocumentRecord,\n  mapSelectedDocumentRecord,\n} from \"../records\";\nimport type { DocumentsPersistence, StoredDocumentRecord } from \"../types\";\nimport {\n  documentSummaryJoin,\n  documentSummarySelection,\n  getProjectionContainerId,\n  getProjectionDocumentKind,\n  getProjectionText,\n  getProjectionTitle,\n  mapDocumentSummary,\n} from \"./documentProjectionRows\";\nimport { getDocumentScope, hasDocumentRow } from \"./documentRows\";\n\n/** The projection columns a stored record was loaded with, if any. */\nexport interface StoredDocumentProjectionState {\n  documentKind: StoredDocumentKind;\n  text: string | null;\n  title: string;\n  updatedAt: string;\n}\n\n/**\n * The canonical record and its projection from ONE joined statement, so the\n * pair comes from one snapshot and a save inside the same transaction can\n * reuse the projection instead of reading it again.\n */\nexport async function loadStoredDocumentState(\n  execSql: Parameters<DocumentsPersistence[\"loadDocument\"]>[0],\n  localId: string,\n): Promise<{\n  projection: StoredDocumentProjectionState | null;\n  record: StoredDocumentRecord;\n} | null> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const [row] = await db\n    .select({\n      ...documentRecordSelection,\n      projectionContainerId: documentProjection.containerId,\n      projectionDocumentKind: documentProjection.documentKind,\n      projectionText: documentProjectionText.text,\n      projectionTitle: documentProjection.title,\n      projectionUpdatedAt: documentProjection.updatedAt,\n    })\n    .from(documents)\n    .leftJoin(\n      documentProjection,\n      eq(documentProjection.localId, documents.localId),\n    )\n    .leftJoin(\n      documentProjectionText,\n      eq(documentProjectionText.localId, documentProjection.localId),\n    )\n    .where(\n      and(\n        eq(documents.appKind, DOCUMENTS_APP_KIND),\n        eq(documents.localId, localId),\n      ),\n    )\n    .limit(1);\n  if (!row) return null;\n  const {\n    projectionContainerId,\n    projectionDocumentKind,\n    projectionText,\n    projectionTitle,\n    projectionUpdatedAt,\n    ...recordRow\n  } = row;\n  // Projection columns are NOT NULL, so they are null exactly when the\n  // projection row is absent.\n  const projectionRow =\n    projectionDocumentKind !== null &&\n    projectionTitle !== null &&\n    projectionUpdatedAt !== null\n      ? {\n          containerId: projectionContainerId,\n          documentKind: projectionDocumentKind,\n          text: projectionText,\n          title: projectionTitle,\n        }\n      : undefined;\n  return {\n    projection:\n      projectionRow && projectionUpdatedAt !== null\n        ? { ...projectionRow, updatedAt: projectionUpdatedAt }\n        : null,\n    record: {\n      ...mapSelectedDocumentRecord(recordRow),\n      containerId: getProjectionContainerId(projectionRow),\n      documentKind: getProjectionDocumentKind(projectionRow),\n      text: getProjectionText(projectionRow),\n      title: getProjectionTitle(projectionRow),\n    },\n  };\n}\n\ntype DocumentRowQueryPersistence = Pick<\n  DocumentsPersistence,\n  | \"listDocuments\"\n  | \"findDocumentLocalIdsByContainerId\"\n  | \"findLocalIdByDocumentId\"\n  | \"hasDocument\"\n  | \"documentIdentityMatches\"\n  | \"loadDocument\"\n  | \"loadDocumentContainer\"\n>;\n\nexport const documentRowQueryPersistence: DocumentRowQueryPersistence = {\n  async listDocuments(execSql) {\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    const rows = await db\n      .select(documentSummarySelection)\n      .from(documentProjection)\n      .leftJoin(documents, documentSummaryJoin)\n      .where(\n        notInArray(documentProjection.documentKind, [\n          ...HIDDEN_DOCUMENT_SUMMARY_KINDS,\n        ]),\n      )\n      .orderBy(\n        desc(documentProjection.updatedAt),\n        desc(documentProjection.localId),\n      );\n\n    return rows.map(mapDocumentSummary);\n  },\n  async findDocumentLocalIdsByContainerId(execSql, containerId) {\n    // Unlike `listDocumentsByContainerIdsOrDocumentIds`, this deliberately does\n    // NOT drop `HIDDEN_DOCUMENT_SUMMARY_KINDS` — it exists to reach the hidden\n    // `organization_profile` document by the container it is linked to, which is\n    // how a *foreign* org's display name is found on a member who synced the doc\n    // under its server documentId rather than the provisioner-only local alias.\n    // `documentProjection` is written and deleted in lockstep with the\n    // `documents` rows (all DOCUMENTS_APP_KIND), so filtering by containerId\n    // alone is sufficient — no join to `documents` is needed to select localId.\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    const rows = await db\n      .select({ localId: documentProjection.localId })\n      .from(documentProjection)\n      .where(eq(documentProjection.containerId, containerId))\n      .orderBy(\n        desc(documentProjection.updatedAt),\n        desc(documentProjection.localId),\n      );\n    return rows\n      .map((row) => row.localId)\n      .filter((localId): localId is string => localId !== null);\n  },\n  findLocalIdByDocumentId: (execSql, documentId) =>\n    findLocalIdByDocumentId(execSql, DOCUMENTS_APP_KIND, documentId),\n  async hasDocument(execSql, localId) {\n    return hasDocumentRow(execSql, localId);\n  },\n  async documentIdentityMatches(\n    execSql,\n    localId,\n    expectedDocumentId,\n    expectedRecoveryGeneration,\n  ) {\n    const record = await loadDocumentRecord(execSql, getDocumentScope(localId));\n    return (\n      record?.documentId === expectedDocumentId &&\n      (record.recoveryGeneration ?? 0) === expectedRecoveryGeneration\n    );\n  },\n  async loadDocument(execSql, localId) {\n    return (await loadStoredDocumentState(execSql, localId))?.record ?? null;\n  },\n  async loadDocumentContainer(execSql, localId) {\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    // Select the row itself, not just its container, so an existing row with a\n    // null container is reported as `{ containerId: null }` while a missing row\n    // is reported as `undefined` — the caller relies on that distinction to know\n    // whether the projection has authoritative placement to defer to.\n    const projectionRows = await db\n      .select({ containerId: documentProjection.containerId })\n      .from(documentProjection)\n      .where(eq(documentProjection.localId, localId))\n      .limit(1);\n    const projectionRow = projectionRows[0];\n    if (!projectionRow) {\n      return undefined;\n    }\n\n    return { containerId: projectionRow.containerId };\n  },\n};\n"]}
+{"version":3,"file":"rowQueryPersistence.js","sourceRoot":"","sources":["rowQueryPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAUlE,MAAM,4BAA4B,GAAG;IACnC,GAAG,uBAAuB;IAC1B,qBAAqB,EAAE,kBAAkB,CAAC,WAAW;IACrD,sBAAsB,EAAE,kBAAkB,CAAC,YAAY;IACvD,cAAc,EAAE,sBAAsB,CAAC,IAAI;IAC3C,eAAe,EAAE,kBAAkB,CAAC,KAAK;IACzC,mBAAmB,EAAE,kBAAkB,CAAC,SAAS;CAClD,CAAC;AAOF,SAAS,wBAAwB,CAC/B,OAA4D,EAC5D,QAAyB;IAEzB,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,EAAE;SACN,MAAM,CAAC,4BAA4B,CAAC;SACpC,IAAI,CAAC,SAAS,CAAC;SACf,QAAQ,CACP,kBAAkB,EAClB,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAClD;SACA,QAAQ,CACP,sBAAsB,EACtB,EAAE,CAAC,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAC/D;SACA,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,sBAAsB,CAC7B,GAAiE;IAEjE,MAAM,EACJ,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,GAAG,SAAS,EACb,GAAG,GAAG,CAAC;IACR,qEAAqE;IACrE,4BAA4B;IAC5B,MAAM,aAAa,GACjB,sBAAsB,KAAK,IAAI;QAC/B,eAAe,KAAK,IAAI;QACxB,mBAAmB,KAAK,IAAI;QAC1B,CAAC,CAAC;YACE,WAAW,EAAE,qBAAqB;YAClC,YAAY,EAAE,sBAAsB;YACpC,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,eAAe;SACvB;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO;QACL,UAAU,EACR,aAAa,IAAI,mBAAmB,KAAK,IAAI;YAC3C,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE;YACtD,CAAC,CAAC,IAAI;QACV,MAAM,EAAE;YACN,GAAG,yBAAyB,CAAC,SAAS,CAAC;YACvC,WAAW,EAAE,wBAAwB,CAAC,aAAa,CAAC;YACpD,YAAY,EAAE,yBAAyB,CAAC,aAAa,CAAC;YACtD,IAAI,EAAE,iBAAiB,CAAC,aAAa,CAAC;YACtC,KAAK,EAAE,kBAAkB,CAAC,aAAa,CAAC;SACzC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA4D,EAC5D,OAAe;IAEf,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,wBAAwB,CAC1C,OAAO,EACP,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAC/B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACX,OAAO,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAA4D,EAC5D,QAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,uDAAuD;IACvD,MAAM,SAAS,GAAG,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,wBAAwB,CACzC,OAAO,EACP,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CACrE,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAaD,MAAM,CAAC,MAAM,2BAA2B,GAAgC;IACtE,KAAK,CAAC,aAAa,CAAC,OAAO;QACzB,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC,wBAAwB,CAAC;aAChC,IAAI,CAAC,kBAAkB,CAAC;aACxB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;aACxC,KAAK,CACJ,UAAU,CAAC,kBAAkB,CAAC,YAAY,EAAE;YAC1C,GAAG,6BAA6B;SACjC,CAAC,CACH;aACA,OAAO,CACN,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAClC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CACjC,CAAC;QAEJ,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,CAAC,iCAAiC,CAAC,OAAO,EAAE,WAAW;QAC1D,4EAA4E;QAC5E,2EAA2E;QAC3E,6EAA6E;QAC7E,6EAA6E;QAC7E,4EAA4E;QAC5E,mEAAmE;QACnE,yEAAyE;QACzE,4EAA4E;QAC5E,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,kBAAkB,CAAC;aACxB,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;aACtD,OAAO,CACN,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAClC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CACjC,CAAC;QACJ,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;aACzB,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,uBAAuB,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,CAC/C,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,CAAC;IAClE,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO;QAChC,OAAO,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,uBAAuB,CAC3B,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,0BAA0B;QAE1B,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,OAAO,CACL,MAAM,EAAE,UAAU,KAAK,kBAAkB;YACzC,CAAC,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAC,KAAK,0BAA0B,CAChE,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO;QACjC,OAAO,CAAC,MAAM,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IAC3E,CAAC;IACD,KAAK,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO;QAC1C,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;QAC1D,2EAA2E;QAC3E,4EAA4E;QAC5E,6EAA6E;QAC7E,kEAAkE;QAClE,MAAM,cAAc,GAAG,MAAM,EAAE;aAC5B,MAAM,CAAC,EAAE,WAAW,EAAE,kBAAkB,CAAC,WAAW,EAAE,CAAC;aACvD,IAAI,CAAC,kBAAkB,CAAC;aACxB,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;aAC9C,KAAK,CAAC,CAAC,CAAC,CAAC;QACZ,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC;IACpD,CAAC;CACF,CAAC","sourcesContent":["import { and, desc, eq, inArray, notInArray, type SQL } from \"drizzle-orm\";\nimport { DOCUMENTS_APP_KIND } from \"../../../documents/documentConstants\";\nimport type { StoredDocumentKind } from \"../../../documents/documentKinds\";\nimport { HIDDEN_DOCUMENT_SUMMARY_KINDS } from \"../../../documents/documentSummary\";\nimport {\n  documentProjection,\n  documentProjectionText,\n  documents,\n} from \"../../../sqlite/schema\";\nimport { sqliteRowsPerStatement } from \"../../../sqlite/sqliteBindBudget\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  documentRecordSelection,\n  findLocalIdByDocumentId,\n  loadDocumentRecord,\n  mapSelectedDocumentRecord,\n} from \"../records\";\nimport type { DocumentsPersistence, StoredDocumentRecord } from \"../types\";\nimport {\n  documentSummaryJoin,\n  documentSummarySelection,\n  getProjectionContainerId,\n  getProjectionDocumentKind,\n  getProjectionText,\n  getProjectionTitle,\n  mapDocumentSummary,\n} from \"./documentProjectionRows\";\nimport { getDocumentScope, hasDocumentRow } from \"./documentRows\";\n\n/** The projection columns a stored record was loaded with, if any. */\nexport interface StoredDocumentProjectionState {\n  documentKind: StoredDocumentKind;\n  text: string | null;\n  title: string;\n  updatedAt: string;\n}\n\nconst storedDocumentStateSelection = {\n  ...documentRecordSelection,\n  projectionContainerId: documentProjection.containerId,\n  projectionDocumentKind: documentProjection.documentKind,\n  projectionText: documentProjectionText.text,\n  projectionTitle: documentProjection.title,\n  projectionUpdatedAt: documentProjection.updatedAt,\n};\n\nexport interface StoredDocumentState {\n  projection: StoredDocumentProjectionState | null;\n  record: StoredDocumentRecord;\n}\n\nfunction storedDocumentStateQuery(\n  execSql: Parameters<DocumentsPersistence[\"loadDocument\"]>[0],\n  localIds: SQL | undefined,\n) {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  return db\n    .select(storedDocumentStateSelection)\n    .from(documents)\n    .leftJoin(\n      documentProjection,\n      eq(documentProjection.localId, documents.localId),\n    )\n    .leftJoin(\n      documentProjectionText,\n      eq(documentProjectionText.localId, documentProjection.localId),\n    )\n    .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), localIds));\n}\n\nfunction mapStoredDocumentState(\n  row: Awaited<ReturnType<typeof storedDocumentStateQuery>>[number],\n): StoredDocumentState {\n  const {\n    projectionContainerId,\n    projectionDocumentKind,\n    projectionText,\n    projectionTitle,\n    projectionUpdatedAt,\n    ...recordRow\n  } = row;\n  // Projection columns are NOT NULL, so they are null exactly when the\n  // projection row is absent.\n  const projectionRow =\n    projectionDocumentKind !== null &&\n    projectionTitle !== null &&\n    projectionUpdatedAt !== null\n      ? {\n          containerId: projectionContainerId,\n          documentKind: projectionDocumentKind,\n          text: projectionText,\n          title: projectionTitle,\n        }\n      : undefined;\n  return {\n    projection:\n      projectionRow && projectionUpdatedAt !== null\n        ? { ...projectionRow, updatedAt: projectionUpdatedAt }\n        : null,\n    record: {\n      ...mapSelectedDocumentRecord(recordRow),\n      containerId: getProjectionContainerId(projectionRow),\n      documentKind: getProjectionDocumentKind(projectionRow),\n      text: getProjectionText(projectionRow),\n      title: getProjectionTitle(projectionRow),\n    },\n  };\n}\n\n/**\n * The canonical record and its projection from ONE joined statement, so the\n * pair comes from one snapshot and a save inside the same transaction can\n * reuse the projection instead of reading it again.\n */\nexport async function loadStoredDocumentState(\n  execSql: Parameters<DocumentsPersistence[\"loadDocument\"]>[0],\n  localId: string,\n): Promise<StoredDocumentState | null> {\n  const [row] = await storedDocumentStateQuery(\n    execSql,\n    eq(documents.localId, localId),\n  ).limit(1);\n  return row ? mapStoredDocumentState(row) : null;\n}\n\n/** `loadStoredDocumentState` for many local ids, one joined read per chunk. */\nexport async function loadStoredDocumentStates(\n  execSql: Parameters<DocumentsPersistence[\"loadDocument\"]>[0],\n  localIds: ReadonlyArray<string>,\n): Promise<Map<string, StoredDocumentState>> {\n  const states = new Map<string, StoredDocumentState>();\n  const unique = Array.from(new Set(localIds));\n  // One bind for the app kind; the rest carry local ids.\n  const chunkSize = sqliteRowsPerStatement(1, 1);\n  for (let offset = 0; offset < unique.length; offset += chunkSize) {\n    const rows = await storedDocumentStateQuery(\n      execSql,\n      inArray(documents.localId, unique.slice(offset, offset + chunkSize)),\n    );\n    for (const row of rows) states.set(row.id, mapStoredDocumentState(row));\n  }\n  return states;\n}\n\ntype DocumentRowQueryPersistence = Pick<\n  DocumentsPersistence,\n  | \"listDocuments\"\n  | \"findDocumentLocalIdsByContainerId\"\n  | \"findLocalIdByDocumentId\"\n  | \"hasDocument\"\n  | \"documentIdentityMatches\"\n  | \"loadDocument\"\n  | \"loadDocumentContainer\"\n>;\n\nexport const documentRowQueryPersistence: DocumentRowQueryPersistence = {\n  async listDocuments(execSql) {\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    const rows = await db\n      .select(documentSummarySelection)\n      .from(documentProjection)\n      .leftJoin(documents, documentSummaryJoin)\n      .where(\n        notInArray(documentProjection.documentKind, [\n          ...HIDDEN_DOCUMENT_SUMMARY_KINDS,\n        ]),\n      )\n      .orderBy(\n        desc(documentProjection.updatedAt),\n        desc(documentProjection.localId),\n      );\n\n    return rows.map(mapDocumentSummary);\n  },\n  async findDocumentLocalIdsByContainerId(execSql, containerId) {\n    // Unlike `listDocumentsByContainerIdsOrDocumentIds`, this deliberately does\n    // NOT drop `HIDDEN_DOCUMENT_SUMMARY_KINDS` — it exists to reach the hidden\n    // `organization_profile` document by the container it is linked to, which is\n    // how a *foreign* org's display name is found on a member who synced the doc\n    // under its server documentId rather than the provisioner-only local alias.\n    // `documentProjection` is written and deleted in lockstep with the\n    // `documents` rows (all DOCUMENTS_APP_KIND), so filtering by containerId\n    // alone is sufficient — no join to `documents` is needed to select localId.\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    const rows = await db\n      .select({ localId: documentProjection.localId })\n      .from(documentProjection)\n      .where(eq(documentProjection.containerId, containerId))\n      .orderBy(\n        desc(documentProjection.updatedAt),\n        desc(documentProjection.localId),\n      );\n    return rows\n      .map((row) => row.localId)\n      .filter((localId): localId is string => localId !== null);\n  },\n  findLocalIdByDocumentId: (execSql, documentId) =>\n    findLocalIdByDocumentId(execSql, DOCUMENTS_APP_KIND, documentId),\n  async hasDocument(execSql, localId) {\n    return hasDocumentRow(execSql, localId);\n  },\n  async documentIdentityMatches(\n    execSql,\n    localId,\n    expectedDocumentId,\n    expectedRecoveryGeneration,\n  ) {\n    const record = await loadDocumentRecord(execSql, getDocumentScope(localId));\n    return (\n      record?.documentId === expectedDocumentId &&\n      (record.recoveryGeneration ?? 0) === expectedRecoveryGeneration\n    );\n  },\n  async loadDocument(execSql, localId) {\n    return (await loadStoredDocumentState(execSql, localId))?.record ?? null;\n  },\n  async loadDocumentContainer(execSql, localId) {\n    const { db } = getClientSQLitePersistenceRuntime(execSql);\n    // Select the row itself, not just its container, so an existing row with a\n    // null container is reported as `{ containerId: null }` while a missing row\n    // is reported as `undefined` — the caller relies on that distinction to know\n    // whether the projection has authoritative placement to defer to.\n    const projectionRows = await db\n      .select({ containerId: documentProjection.containerId })\n      .from(documentProjection)\n      .where(eq(documentProjection.localId, localId))\n      .limit(1);\n    const projectionRow = projectionRows[0];\n    if (!projectionRow) {\n      return undefined;\n    }\n\n    return { containerId: projectionRow.containerId };\n  },\n};\n"]}

package/data/persistence/documents/records/documentRecordPersistence.d.ts

@@ -272,4 +272,9 @@ export declare const documentRecordSelection: {
 export declare function mapSelectedDocumentRecord(row: SelectedDocumentRecordRow): DocumentRecord;
 export declare function loadDocumentRecord(execSql: ExecSql, scope: DocumentScope): Promise<DocumentRecord | null>;
 export declare function findLocalIdByDocumentId(execSql: ExecSql, appKind: string, documentId: string): Promise<string | null>;
+/**
+ * `findLocalIdByDocumentId` for many document ids: one read per chunk, in the
+ * same preference order, keeping the first row per document id.
+ */
+export declare function findLocalIdsByDocumentIds(execSql: ExecSql, appKind: string, documentIds: ReadonlyArray<string>): Promise<Map<string, string>>;
 export declare function deleteDocumentRecord(execSql: ExecSql, scope: DocumentScope): Promise<void>;

package/data/persistence/documents/records/documentRecordPersistence.js

@@ -1,7 +1,8 @@
-import { and, desc, eq, sql } from "drizzle-orm";
+import { and, desc, eq, inArray, sql } from "drizzle-orm";
 import { deserializeDocumentSyncPullContinuation } from "../../../documents/shared/sync/pullContinuation.js";
 import { normalizeEffectiveAccessLevel } from "../../../keying/accessLevel.js";
 import { documentHistoryUpdates, documents } from "../../../sqlite/schema/index.js";
+import { sqliteRowsPerStatement } from "../../../sqlite/sqliteBindBudget.js";
 import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
 /**
  * The ONE select shape for a full documents-row record: every reader that
@@ -66,8 +67,12 @@ export async function loadDocumentRecord(execSql, scope) {
         .limit(1);
     return rows[0] ? mapSelectedDocumentRecord(rows[0]) : null;
 }
-export async function findLocalIdByDocumentId(execSql, appKind, documentId) {
-    const { db } = getClientSQLitePersistenceRuntime(execSql);
+/**
+ * Duplicate remote identities can survive an interrupted local adoption, so
+ * the row to use for a document id is chosen by this order: queued or
+ * deferred edits first, then a stable fallback.
+ */
+function localIdPreferenceOrder() {
     const hasPendingUpdates = sql `EXISTS (
     SELECT 1
     FROM ${documentHistoryUpdates}
@@ -82,16 +87,46 @@ export async function findLocalIdByDocumentId(execSql, appKind, documentId) {
       AND ${documents.pendingBaseVersion} <> ${documents.snapshotEndVersion}
     )
   )`;
+    return [
+        desc(hasPendingLocalWork),
+        desc(documents.updatedAt),
+        desc(documents.localId),
+    ];
+}
+export async function findLocalIdByDocumentId(execSql, appKind, documentId) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
     const rows = await db
         .select({ localId: documents.localId })
         .from(documents)
         .where(and(eq(documents.appKind, appKind), eq(documents.documentId, documentId)))
-        // Duplicate remote identities can survive an interrupted local adoption.
-        // Preserve queued or deferred edits, then make the fallback stable.
-        .orderBy(desc(hasPendingLocalWork), desc(documents.updatedAt), desc(documents.localId))
+        .orderBy(...localIdPreferenceOrder())
         .limit(1);
     return rows[0]?.localId ?? null;
 }
+/**
+ * `findLocalIdByDocumentId` for many document ids: one read per chunk, in the
+ * same preference order, keeping the first row per document id.
+ */
+export async function findLocalIdsByDocumentIds(execSql, appKind, documentIds) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const localIds = new Map();
+    const unique = Array.from(new Set(documentIds));
+    // One bind for the app kind; the rest carry document ids.
+    const chunkSize = sqliteRowsPerStatement(1, 1);
+    for (let offset = 0; offset < unique.length; offset += chunkSize) {
+        const rows = await db
+            .select({ documentId: documents.documentId, localId: documents.localId })
+            .from(documents)
+            .where(and(eq(documents.appKind, appKind), inArray(documents.documentId, unique.slice(offset, offset + chunkSize))))
+            .orderBy(...localIdPreferenceOrder());
+        for (const row of rows) {
+            if (row.documentId !== null && !localIds.has(row.documentId)) {
+                localIds.set(row.documentId, row.localId);
+            }
+        }
+    }
+    return localIds;
+}
 export async function deleteDocumentRecord(execSql, scope) {
     await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {
         await db

package/data/persistence/documents/records/documentRecordPersistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentRecordPersistence.js","sourceRoot":"","sources":["documentRecordPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, desc, eq, sql } from \"drizzle-orm\";\nimport { deserializeDocumentSyncPullContinuation } from \"../../../documents/shared/sync/pullContinuation\";\nimport { normalizeEffectiveAccessLevel } from \"../../../keying/accessLevel\";\nimport { documentHistoryUpdates, documents } from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../../sqlite/sqlSchema\";\nimport type {\n  DocumentRecord,\n  DocumentScope,\n  SelectedDocumentRecordRow,\n} from \"./documentPersistenceTypes\";\n\n/**\n * The ONE select shape for a full documents-row record: every reader that\n * feeds mapSelectedDocumentRecord spreads this, so a new record column cannot\n * silently miss one of them.\n */\nexport const documentRecordSelection = {\n  id: documents.localId,\n  documentId: documents.documentId,\n  recoveryGeneration: documents.recoveryGeneration,\n  recoveryDocumentId: documents.recoveryDocumentId,\n  snapshotEndVersion: documents.snapshotEndVersion,\n  accessEpoch: documents.accessEpoch,\n  accessStateHash: documents.accessStateHash,\n  effectiveAccessLevel: documents.effectiveAccessLevel,\n  lastCommitLsn: documents.lastCommitLsn,\n  documentManifestBundle: documents.documentManifestBundle,\n  contentKeyBundle: documents.contentKeyBundle,\n  documentKekTargets: documents.documentKekTargets,\n  pendingBaseVersion: documents.pendingBaseVersion,\n  pullContinuation: documents.pullContinuation,\n};\n\nexport function mapSelectedDocumentRecord(\n  row: SelectedDocumentRecordRow,\n): DocumentRecord {\n  const record: DocumentRecord = {\n    id: row.id,\n    documentId: row.documentId,\n    recoveryGeneration: row.recoveryGeneration,\n    snapshotEndVersion: row.snapshotEndVersion,\n    accessEpoch: row.accessEpoch,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      row.effectiveAccessLevel,\n    ),\n    lastCommitLsn: row.lastCommitLsn,\n    contentKeyBundle: row.contentKeyBundle,\n    documentKekTargets: row.documentKekTargets,\n    documentManifestBundle: row.documentManifestBundle,\n  };\n\n  if (row.accessStateHash !== null) {\n    record.accessStateHash = row.accessStateHash;\n  }\n\n  if (row.recoveryDocumentId !== null) {\n    record.recoveryDocumentId = row.recoveryDocumentId;\n  }\n\n  // Only surface the marker when one was persisted, so a row that never stored\n  // one keeps its prior shape (and init falls through to seeding it).\n  if (row.pendingBaseVersion !== null) {\n    record.pendingBaseVersion = row.pendingBaseVersion;\n  }\n\n  const pullContinuation = deserializeDocumentSyncPullContinuation(\n    row.pullContinuation,\n  );\n  if (pullContinuation !== null) {\n    record.pullContinuation = pullContinuation;\n  } else if (row.pullContinuation !== null) {\n    record.pullContinuationRecoveryRequired = true;\n  }\n\n  return record;\n}\n\nexport async function loadDocumentRecord(\n  execSql: ExecSql,\n  scope: DocumentScope,\n): Promise<DocumentRecord | null> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select(documentRecordSelection)\n    .from(documents)\n    .where(\n      and(\n        eq(documents.appKind, scope.appKind),\n        eq(documents.localId, scope.localId),\n      ),\n    )\n    .limit(1);\n\n  return rows[0] ? mapSelectedDocumentRecord(rows[0]) : null;\n}\n\nexport async function findLocalIdByDocumentId(\n  execSql: ExecSql,\n  appKind: string,\n  documentId: string,\n): Promise<string | null> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const hasPendingUpdates = sql<number>`EXISTS (\n    SELECT 1\n    FROM ${documentHistoryUpdates}\n    WHERE ${documentHistoryUpdates.appKind} = ${documents.appKind}\n      AND ${documentHistoryUpdates.localId} = ${documents.localId}\n      AND ${documentHistoryUpdates.updateId} IS NOT NULL\n  )`;\n  const hasPendingLocalWork = sql<number>`(\n    ${hasPendingUpdates}\n    OR (\n      ${documents.pendingBaseVersion} IS NOT NULL\n      AND ${documents.pendingBaseVersion} <> ${documents.snapshotEndVersion}\n    )\n  )`;\n  const rows = await db\n    .select({ localId: documents.localId })\n    .from(documents)\n    .where(\n      and(eq(documents.appKind, appKind), eq(documents.documentId, documentId)),\n    )\n    // Duplicate remote identities can survive an interrupted local adoption.\n    // Preserve queued or deferred edits, then make the fallback stable.\n    .orderBy(\n      desc(hasPendingLocalWork),\n      desc(documents.updatedAt),\n      desc(documents.localId),\n    )\n    .limit(1);\n\n  return rows[0]?.localId ?? null;\n}\n\nexport async function deleteDocumentRecord(\n  execSql: ExecSql,\n  scope: DocumentScope,\n): Promise<void> {\n  await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {\n    await db\n      .delete(documents)\n      .where(\n        and(\n          eq(documents.appKind, scope.appKind),\n          eq(documents.localId, scope.localId),\n        ),\n      )\n      .run();\n  });\n}\n"]}
+{"version":3,"file":"documentRecordPersistence.js","sourceRoot":"","sources":["documentRecordPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,uCAAuC,EAAE,MAAM,iDAAiD,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAQ7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,EAAE,EAAE,SAAS,CAAC,OAAO;IACrB,UAAU,EAAE,SAAS,CAAC,UAAU;IAChC,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,WAAW,EAAE,SAAS,CAAC,WAAW;IAClC,eAAe,EAAE,SAAS,CAAC,eAAe;IAC1C,oBAAoB,EAAE,SAAS,CAAC,oBAAoB;IACpD,aAAa,EAAE,SAAS,CAAC,aAAa;IACtC,sBAAsB,EAAE,SAAS,CAAC,sBAAsB;IACxD,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;IAC5C,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;CAC7C,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,GAA8B;IAE9B,MAAM,MAAM,GAAmB;QAC7B,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;QAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;QAC1C,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,oBAAoB,EAAE,6BAA6B,CACjD,GAAG,CAAC,oBAAoB,CACzB;QACD,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;QAC1C,sBAAsB,EAAE,GAAG,CAAC,sBAAsB;KACnD,CAAC;IAEF,IAAI,GAAG,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;IAC/C,CAAC;IAED,IAAI,GAAG,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACrD,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,IAAI,GAAG,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACrD,CAAC;IAED,MAAM,gBAAgB,GAAG,uCAAuC,CAC9D,GAAG,CAAC,gBAAgB,CACrB,CAAC;IACF,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC7C,CAAC;SAAM,IAAI,GAAG,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACzC,MAAM,CAAC,gCAAgC,GAAG,IAAI,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,KAAoB;IAEpB,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,MAAM,CAAC,uBAAuB,CAAC;SAC/B,IAAI,CAAC,SAAS,CAAC;SACf,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EACpC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CACrC,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAC;IAEZ,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB;IAC7B,MAAM,iBAAiB,GAAG,GAAG,CAAQ;;WAE5B,sBAAsB;YACrB,sBAAsB,CAAC,OAAO,MAAM,SAAS,CAAC,OAAO;YACrD,sBAAsB,CAAC,OAAO,MAAM,SAAS,CAAC,OAAO;YACrD,sBAAsB,CAAC,QAAQ;IACvC,CAAC;IACH,MAAM,mBAAmB,GAAG,GAAG,CAAQ;MACnC,iBAAiB;;QAEf,SAAS,CAAC,kBAAkB;YACxB,SAAS,CAAC,kBAAkB,OAAO,SAAS,CAAC,kBAAkB;;IAEvE,CAAC;IACH,OAAO;QACL,IAAI,CAAC,mBAAmB,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAgB,EAChB,OAAe,EACf,UAAkB;IAElB,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;SACtC,IAAI,CAAC,SAAS,CAAC;SACf,KAAK,CACJ,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAC1E;SACA,OAAO,CAAC,GAAG,sBAAsB,EAAE,CAAC;SACpC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEZ,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAgB,EAChB,OAAe,EACf,WAAkC;IAElC,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,0DAA0D;IAC1D,MAAM,SAAS,GAAG,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;aACxE,IAAI,CAAC,SAAS,CAAC;aACf,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAC9B,OAAO,CACL,SAAS,CAAC,UAAU,EACpB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CACzC,CACF,CACF;aACA,OAAO,CAAC,GAAG,sBAAsB,EAAE,CAAC,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7D,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAgB,EAChB,KAAoB;IAEpB,MAAM,iCAAiC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACxE,MAAM,EAAE;aACL,MAAM,CAAC,SAAS,CAAC;aACjB,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EACpC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CACrC,CACF;aACA,GAAG,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { and, desc, eq, inArray, sql } from \"drizzle-orm\";\nimport { deserializeDocumentSyncPullContinuation } from \"../../../documents/shared/sync/pullContinuation\";\nimport { normalizeEffectiveAccessLevel } from \"../../../keying/accessLevel\";\nimport { documentHistoryUpdates, documents } from \"../../../sqlite/schema\";\nimport { sqliteRowsPerStatement } from \"../../../sqlite/sqliteBindBudget\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../../sqlite/sqlSchema\";\nimport type {\n  DocumentRecord,\n  DocumentScope,\n  SelectedDocumentRecordRow,\n} from \"./documentPersistenceTypes\";\n\n/**\n * The ONE select shape for a full documents-row record: every reader that\n * feeds mapSelectedDocumentRecord spreads this, so a new record column cannot\n * silently miss one of them.\n */\nexport const documentRecordSelection = {\n  id: documents.localId,\n  documentId: documents.documentId,\n  recoveryGeneration: documents.recoveryGeneration,\n  recoveryDocumentId: documents.recoveryDocumentId,\n  snapshotEndVersion: documents.snapshotEndVersion,\n  accessEpoch: documents.accessEpoch,\n  accessStateHash: documents.accessStateHash,\n  effectiveAccessLevel: documents.effectiveAccessLevel,\n  lastCommitLsn: documents.lastCommitLsn,\n  documentManifestBundle: documents.documentManifestBundle,\n  contentKeyBundle: documents.contentKeyBundle,\n  documentKekTargets: documents.documentKekTargets,\n  pendingBaseVersion: documents.pendingBaseVersion,\n  pullContinuation: documents.pullContinuation,\n};\n\nexport function mapSelectedDocumentRecord(\n  row: SelectedDocumentRecordRow,\n): DocumentRecord {\n  const record: DocumentRecord = {\n    id: row.id,\n    documentId: row.documentId,\n    recoveryGeneration: row.recoveryGeneration,\n    snapshotEndVersion: row.snapshotEndVersion,\n    accessEpoch: row.accessEpoch,\n    effectiveAccessLevel: normalizeEffectiveAccessLevel(\n      row.effectiveAccessLevel,\n    ),\n    lastCommitLsn: row.lastCommitLsn,\n    contentKeyBundle: row.contentKeyBundle,\n    documentKekTargets: row.documentKekTargets,\n    documentManifestBundle: row.documentManifestBundle,\n  };\n\n  if (row.accessStateHash !== null) {\n    record.accessStateHash = row.accessStateHash;\n  }\n\n  if (row.recoveryDocumentId !== null) {\n    record.recoveryDocumentId = row.recoveryDocumentId;\n  }\n\n  // Only surface the marker when one was persisted, so a row that never stored\n  // one keeps its prior shape (and init falls through to seeding it).\n  if (row.pendingBaseVersion !== null) {\n    record.pendingBaseVersion = row.pendingBaseVersion;\n  }\n\n  const pullContinuation = deserializeDocumentSyncPullContinuation(\n    row.pullContinuation,\n  );\n  if (pullContinuation !== null) {\n    record.pullContinuation = pullContinuation;\n  } else if (row.pullContinuation !== null) {\n    record.pullContinuationRecoveryRequired = true;\n  }\n\n  return record;\n}\n\nexport async function loadDocumentRecord(\n  execSql: ExecSql,\n  scope: DocumentScope,\n): Promise<DocumentRecord | null> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select(documentRecordSelection)\n    .from(documents)\n    .where(\n      and(\n        eq(documents.appKind, scope.appKind),\n        eq(documents.localId, scope.localId),\n      ),\n    )\n    .limit(1);\n\n  return rows[0] ? mapSelectedDocumentRecord(rows[0]) : null;\n}\n\n/**\n * Duplicate remote identities can survive an interrupted local adoption, so\n * the row to use for a document id is chosen by this order: queued or\n * deferred edits first, then a stable fallback.\n */\nfunction localIdPreferenceOrder() {\n  const hasPendingUpdates = sql<number>`EXISTS (\n    SELECT 1\n    FROM ${documentHistoryUpdates}\n    WHERE ${documentHistoryUpdates.appKind} = ${documents.appKind}\n      AND ${documentHistoryUpdates.localId} = ${documents.localId}\n      AND ${documentHistoryUpdates.updateId} IS NOT NULL\n  )`;\n  const hasPendingLocalWork = sql<number>`(\n    ${hasPendingUpdates}\n    OR (\n      ${documents.pendingBaseVersion} IS NOT NULL\n      AND ${documents.pendingBaseVersion} <> ${documents.snapshotEndVersion}\n    )\n  )`;\n  return [\n    desc(hasPendingLocalWork),\n    desc(documents.updatedAt),\n    desc(documents.localId),\n  ];\n}\n\nexport async function findLocalIdByDocumentId(\n  execSql: ExecSql,\n  appKind: string,\n  documentId: string,\n): Promise<string | null> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select({ localId: documents.localId })\n    .from(documents)\n    .where(\n      and(eq(documents.appKind, appKind), eq(documents.documentId, documentId)),\n    )\n    .orderBy(...localIdPreferenceOrder())\n    .limit(1);\n\n  return rows[0]?.localId ?? null;\n}\n\n/**\n * `findLocalIdByDocumentId` for many document ids: one read per chunk, in the\n * same preference order, keeping the first row per document id.\n */\nexport async function findLocalIdsByDocumentIds(\n  execSql: ExecSql,\n  appKind: string,\n  documentIds: ReadonlyArray<string>,\n): Promise<Map<string, string>> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const localIds = new Map<string, string>();\n  const unique = Array.from(new Set(documentIds));\n  // One bind for the app kind; the rest carry document ids.\n  const chunkSize = sqliteRowsPerStatement(1, 1);\n  for (let offset = 0; offset < unique.length; offset += chunkSize) {\n    const rows = await db\n      .select({ documentId: documents.documentId, localId: documents.localId })\n      .from(documents)\n      .where(\n        and(\n          eq(documents.appKind, appKind),\n          inArray(\n            documents.documentId,\n            unique.slice(offset, offset + chunkSize),\n          ),\n        ),\n      )\n      .orderBy(...localIdPreferenceOrder());\n    for (const row of rows) {\n      if (row.documentId !== null && !localIds.has(row.documentId)) {\n        localIds.set(row.documentId, row.localId);\n      }\n    }\n  }\n  return localIds;\n}\n\nexport async function deleteDocumentRecord(\n  execSql: ExecSql,\n  scope: DocumentScope,\n): Promise<void> {\n  await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {\n    await db\n      .delete(documents)\n      .where(\n        and(\n          eq(documents.appKind, scope.appKind),\n          eq(documents.localId, scope.localId),\n        ),\n      )\n      .run();\n  });\n}\n"]}

package/data/persistence/documents/records/index.d.ts

@@ -18,5 +18,5 @@ export declare function invalidateDocumentSyncPullContinuation(execSql: ExecSql,
 }): Promise<DocumentRecord | null>;
 export { enqueueDocumentPendingUpdate, enqueueDocumentPendingUpdateWithHistory, listDocumentPendingUpdates, MAX_PENDING_UPDATE_REKEYS, rekeyDocumentPendingUpdate, resetDocumentPendingUpdateRekeyBudget, settleDocumentPendingUpdate, unqueueDocumentPendingUpdates, } from "./documentPendingUpdatePersistence.js";
 export type { DocumentRecord, DocumentScope, PendingUpdateFields, PendingUpdateRecord, } from "./documentPersistenceTypes.js";
-export { deleteDocumentRecord, documentRecordSelection, findLocalIdByDocumentId, loadDocumentRecord, mapSelectedDocumentRecord, } from "./documentRecordPersistence.js";
+export { deleteDocumentRecord, documentRecordSelection, findLocalIdByDocumentId, findLocalIdsByDocumentIds, loadDocumentRecord, mapSelectedDocumentRecord, } from "./documentRecordPersistence.js";
 export { clearDocumentSyncFailure, hasRecordedTerminalSyncFailures, recordDocumentSyncFailure, } from "./documentSyncFailurePersistence.js";

package/data/persistence/documents/records/index.js

@@ -30,6 +30,6 @@ export async function invalidateDocumentSyncPullContinuation(execSql, input) {
     });
 }
 export { enqueueDocumentPendingUpdate, enqueueDocumentPendingUpdateWithHistory, listDocumentPendingUpdates, MAX_PENDING_UPDATE_REKEYS, rekeyDocumentPendingUpdate, resetDocumentPendingUpdateRekeyBudget, settleDocumentPendingUpdate, unqueueDocumentPendingUpdates, } from "./documentPendingUpdatePersistence.js";
-export { deleteDocumentRecord, documentRecordSelection, findLocalIdByDocumentId, loadDocumentRecord, mapSelectedDocumentRecord, } from "./documentRecordPersistence.js";
+export { deleteDocumentRecord, documentRecordSelection, findLocalIdByDocumentId, findLocalIdsByDocumentIds, loadDocumentRecord, mapSelectedDocumentRecord, } from "./documentRecordPersistence.js";
 export { clearDocumentSyncFailure, hasRecordedTerminalSyncFailures, recordDocumentSyncFailure, } from "./documentSyncFailurePersistence.js";
 //# sourceMappingURL=index.js.map

package/data/persistence/documents/records/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, sql } from \"drizzle-orm\";\nimport {\n  DOCUMENT_SYNC_PULL_RECOVERY_REQUIRED,\n  type DocumentSyncPullContinuation,\n  serializeDocumentSyncPullContinuation,\n} from \"../../../documents/shared/sync/pullContinuation\";\nimport {\n  documentProjectionTables,\n  documents,\n  documentTables,\n} from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  type ExecSql,\n  ensureSqlTables,\n  runSerializedSqlMutation,\n} from \"../../../sqlite/sqlSchema\";\nimport type { DocumentRecord } from \"./documentPersistenceTypes\";\nimport { loadDocumentRecord } from \"./documentRecordPersistence\";\n\nexport function ensureDocumentTables(execSql: ExecSql): Promise<void> {\n  return ensureSqlTables(execSql, documentTables);\n}\n\nexport function ensureDocumentProjectionTables(\n  execSql: ExecSql,\n): Promise<void> {\n  return ensureSqlTables(execSql, documentProjectionTables);\n}\n\n/** Replace only the exact rejected continuation with a durable recovery marker. */\nexport async function invalidateDocumentSyncPullContinuation(\n  execSql: ExecSql,\n  input: {\n    accessEpoch: number;\n    accessStateHash: string | null;\n    appKind: string;\n    continuation: DocumentSyncPullContinuation;\n    contentKeyBundle: string | null;\n    documentId: string;\n    documentKekTargets: string | null;\n    documentManifestBundle: string | null;\n    lastCommitLsn: string | null;\n    localId: string;\n  },\n): Promise<DocumentRecord | null> {\n  await ensureDocumentTables(execSql);\n  const expectedContinuation = serializeDocumentSyncPullContinuation(\n    input.continuation,\n  );\n  if (expectedContinuation === null) return null;\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    const { db } = getClientSQLitePersistenceRuntime(lockedExecSql);\n    await db\n      .update(documents)\n      .set({ pullContinuation: DOCUMENT_SYNC_PULL_RECOVERY_REQUIRED })\n      .where(\n        and(\n          eq(documents.appKind, input.appKind),\n          eq(documents.localId, input.localId),\n          eq(documents.documentId, input.documentId),\n          eq(documents.accessEpoch, input.accessEpoch),\n          sql`${documents.accessStateHash} IS ${input.accessStateHash}`,\n          sql`${documents.contentKeyBundle} IS ${input.contentKeyBundle}`,\n          sql`${documents.documentKekTargets} IS ${input.documentKekTargets}`,\n          sql`${documents.documentManifestBundle} IS ${input.documentManifestBundle}`,\n          sql`${documents.lastCommitLsn} IS ${input.lastCommitLsn}`,\n          eq(documents.pullContinuation, expectedContinuation),\n        ),\n      )\n      .run();\n    return loadDocumentRecord(lockedExecSql, {\n      appKind: input.appKind,\n      localId: input.localId,\n    });\n  });\n}\n\nexport {\n  enqueueDocumentPendingUpdate,\n  enqueueDocumentPendingUpdateWithHistory,\n  listDocumentPendingUpdates,\n  MAX_PENDING_UPDATE_REKEYS,\n  rekeyDocumentPendingUpdate,\n  resetDocumentPendingUpdateRekeyBudget,\n  settleDocumentPendingUpdate,\n  unqueueDocumentPendingUpdates,\n} from \"./documentPendingUpdatePersistence\";\nexport type {\n  DocumentRecord,\n  DocumentScope,\n  PendingUpdateFields,\n  PendingUpdateRecord,\n} from \"./documentPersistenceTypes\";\nexport {\n  deleteDocumentRecord,\n  documentRecordSelection,\n  findLocalIdByDocumentId,\n  loadDocumentRecord,\n  mapSelectedDocumentRecord,\n} from \"./documentRecordPersistence\";\nexport {\n  clearDocumentSyncFailure,\n  hasRecordedTerminalSyncFailures,\n  recordDocumentSyncFailure,\n} from \"./documentSyncFailurePersistence\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, sql } from \"drizzle-orm\";\nimport {\n  DOCUMENT_SYNC_PULL_RECOVERY_REQUIRED,\n  type DocumentSyncPullContinuation,\n  serializeDocumentSyncPullContinuation,\n} from \"../../../documents/shared/sync/pullContinuation\";\nimport {\n  documentProjectionTables,\n  documents,\n  documentTables,\n} from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  type ExecSql,\n  ensureSqlTables,\n  runSerializedSqlMutation,\n} from \"../../../sqlite/sqlSchema\";\nimport type { DocumentRecord } from \"./documentPersistenceTypes\";\nimport { loadDocumentRecord } from \"./documentRecordPersistence\";\n\nexport function ensureDocumentTables(execSql: ExecSql): Promise<void> {\n  return ensureSqlTables(execSql, documentTables);\n}\n\nexport function ensureDocumentProjectionTables(\n  execSql: ExecSql,\n): Promise<void> {\n  return ensureSqlTables(execSql, documentProjectionTables);\n}\n\n/** Replace only the exact rejected continuation with a durable recovery marker. */\nexport async function invalidateDocumentSyncPullContinuation(\n  execSql: ExecSql,\n  input: {\n    accessEpoch: number;\n    accessStateHash: string | null;\n    appKind: string;\n    continuation: DocumentSyncPullContinuation;\n    contentKeyBundle: string | null;\n    documentId: string;\n    documentKekTargets: string | null;\n    documentManifestBundle: string | null;\n    lastCommitLsn: string | null;\n    localId: string;\n  },\n): Promise<DocumentRecord | null> {\n  await ensureDocumentTables(execSql);\n  const expectedContinuation = serializeDocumentSyncPullContinuation(\n    input.continuation,\n  );\n  if (expectedContinuation === null) return null;\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    const { db } = getClientSQLitePersistenceRuntime(lockedExecSql);\n    await db\n      .update(documents)\n      .set({ pullContinuation: DOCUMENT_SYNC_PULL_RECOVERY_REQUIRED })\n      .where(\n        and(\n          eq(documents.appKind, input.appKind),\n          eq(documents.localId, input.localId),\n          eq(documents.documentId, input.documentId),\n          eq(documents.accessEpoch, input.accessEpoch),\n          sql`${documents.accessStateHash} IS ${input.accessStateHash}`,\n          sql`${documents.contentKeyBundle} IS ${input.contentKeyBundle}`,\n          sql`${documents.documentKekTargets} IS ${input.documentKekTargets}`,\n          sql`${documents.documentManifestBundle} IS ${input.documentManifestBundle}`,\n          sql`${documents.lastCommitLsn} IS ${input.lastCommitLsn}`,\n          eq(documents.pullContinuation, expectedContinuation),\n        ),\n      )\n      .run();\n    return loadDocumentRecord(lockedExecSql, {\n      appKind: input.appKind,\n      localId: input.localId,\n    });\n  });\n}\n\nexport {\n  enqueueDocumentPendingUpdate,\n  enqueueDocumentPendingUpdateWithHistory,\n  listDocumentPendingUpdates,\n  MAX_PENDING_UPDATE_REKEYS,\n  rekeyDocumentPendingUpdate,\n  resetDocumentPendingUpdateRekeyBudget,\n  settleDocumentPendingUpdate,\n  unqueueDocumentPendingUpdates,\n} from \"./documentPendingUpdatePersistence\";\nexport type {\n  DocumentRecord,\n  DocumentScope,\n  PendingUpdateFields,\n  PendingUpdateRecord,\n} from \"./documentPersistenceTypes\";\nexport {\n  deleteDocumentRecord,\n  documentRecordSelection,\n  findLocalIdByDocumentId,\n  findLocalIdsByDocumentIds,\n  loadDocumentRecord,\n  mapSelectedDocumentRecord,\n} from \"./documentRecordPersistence\";\nexport {\n  clearDocumentSyncFailure,\n  hasRecordedTerminalSyncFailures,\n  recordDocumentSyncFailure,\n} from \"./documentSyncFailurePersistence\";\n"]}

package/data/persistence/keyingCheckpoints/documentPurgeCheckpointPersistence.d.ts

@@ -9,4 +9,6 @@ export interface DocumentPurgeCheckpoint {
 export declare function loadDocumentPurgeCheckpoint(execSql: ExecSql, documentId: string): Promise<DocumentPurgeCheckpoint | null>;
 /** Whether the document was permanently purged, read in the caller's transaction. */
 export declare function hasDocumentPurgeCheckpointInTransaction(tx: ClientSQLiteTransactionScope, documentId: string): Promise<boolean>;
+/** The document ids among `documentIds` that carry a purge checkpoint. */
+export declare function listPurgedDocumentIdsInTransaction(tx: ClientSQLiteTransactionScope, documentIds: ReadonlyArray<string>): Promise<Set<string>>;
 export declare function storeDocumentPurgeCheckpointInTransaction(tx: ClientSQLiteTransactionScope, checkpoint: DocumentPurgeCheckpoint, updatedAt: string): Promise<void>;

package/data/persistence/keyingCheckpoints/documentPurgeCheckpointPersistence.js

@@ -1,6 +1,7 @@
 import { KeyingVerificationError } from "../../../internal/crypto/index.js";
-import { eq } from "drizzle-orm";
+import { eq, inArray } from "drizzle-orm";
 import { documentPurgeCheckpoints, keyingCheckpointTables, } from "../../sqlite/schema/index.js";
+import { sqliteRowsPerStatement } from "../../sqlite/sqliteBindBudget.js";
 import { getClientSQLitePersistenceRuntime } from "../../sqlite/sqlitePersistenceRuntime.js";
 import { ensureSqlTables } from "../../sqlite/sqlSchema.js";
 export async function loadDocumentPurgeCheckpoint(execSql, documentId) {
@@ -26,6 +27,21 @@ export async function hasDocumentPurgeCheckpointInTransaction(tx, documentId) {
         .limit(1);
     return row !== undefined;
 }
+/** The document ids among `documentIds` that carry a purge checkpoint. */
+export async function listPurgedDocumentIdsInTransaction(tx, documentIds) {
+    const purged = new Set();
+    const unique = Array.from(new Set(documentIds));
+    const chunkSize = sqliteRowsPerStatement(1);
+    for (let offset = 0; offset < unique.length; offset += chunkSize) {
+        const rows = await tx
+            .select({ documentId: documentPurgeCheckpoints.documentId })
+            .from(documentPurgeCheckpoints)
+            .where(inArray(documentPurgeCheckpoints.documentId, unique.slice(offset, offset + chunkSize)));
+        for (const row of rows)
+            purged.add(row.documentId);
+    }
+    return purged;
+}
 export async function storeDocumentPurgeCheckpointInTransaction(tx, checkpoint, updatedAt) {
     const [stored] = await tx
         .select({

package/data/persistence/keyingCheckpoints/documentPurgeCheckpointPersistence.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentPurgeCheckpointPersistence.js","sourceRoot":"","sources":["documentPurgeCheckpointPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAgB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AASvE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAgB,EAChB,UAAkB;IAElB,MAAM,eAAe,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,iCAAiC,CAAC,OAAO,CAAC;SAC3D,EAAE,CAAC,MAAM,CAAC;QACT,UAAU,EAAE,wBAAwB,CAAC,UAAU;QAC/C,oBAAoB,EAAE,wBAAwB,CAAC,oBAAoB;QACnE,cAAc,EAAE,wBAAwB,CAAC,cAAc;QACvD,cAAc,EAAE,wBAAwB,CAAC,cAAc;KACxD,CAAC;SACD,IAAI,CAAC,wBAAwB,CAAC;SAC9B,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;SAC1D,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,GAAG,IAAI,IAAI,CAAC;AACrB,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,uCAAuC,CAC3D,EAAgC,EAChC,UAAkB;IAElB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,EAAE,UAAU,EAAE,wBAAwB,CAAC,UAAU,EAAE,CAAC;SAC3D,IAAI,CAAC,wBAAwB,CAAC;SAC9B,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;SAC1D,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,GAAG,KAAK,SAAS,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yCAAyC,CAC7D,EAAgC,EAChC,UAAmC,EACnC,SAAiB;IAEjB,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;SACtB,MAAM,CAAC;QACN,oBAAoB,EAAE,wBAAwB,CAAC,oBAAoB;QACnE,cAAc,EAAE,wBAAwB,CAAC,cAAc;QACvD,cAAc,EAAE,wBAAwB,CAAC,cAAc;KACxD,CAAC;SACD,IAAI,CAAC,wBAAwB,CAAC;SAC9B,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;SACrE,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,IAAI,MAAM,EAAE,CAAC;QACX,IACE,MAAM,CAAC,oBAAoB,KAAK,UAAU,CAAC,oBAAoB;YAC/D,MAAM,CAAC,cAAc,KAAK,UAAU,CAAC,cAAc;YACnD,MAAM,CAAC,cAAc,KAAK,UAAU,CAAC,cAAc,EACnD,CAAC;YACD,MAAM,IAAI,uBAAuB,CAC/B,cAAc,EACd,sEAAsE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,EAAE;SACL,MAAM,CAAC,wBAAwB,CAAC;SAChC,MAAM,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,CAAC;SACpC,GAAG,EAAE,CAAC;AACX,CAAC","sourcesContent":["import { KeyingVerificationError } from \"@tearleads/crypto\";\nimport { eq } from \"drizzle-orm\";\nimport {\n  documentPurgeCheckpoints,\n  keyingCheckpointTables,\n} from \"../../sqlite/schema\";\nimport type { ClientSQLiteTransactionScope } from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { getClientSQLitePersistenceRuntime } from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { type ExecSql, ensureSqlTables } from \"../../sqlite/sqlSchema\";\n\nexport interface DocumentPurgeCheckpoint {\n  readonly documentId: string;\n  readonly documentManifestHash: string;\n  readonly organizationId: string;\n  readonly purgeEventHash: string;\n}\n\nexport async function loadDocumentPurgeCheckpoint(\n  execSql: ExecSql,\n  documentId: string,\n): Promise<DocumentPurgeCheckpoint | null> {\n  await ensureSqlTables(execSql, keyingCheckpointTables);\n  const [row] = await getClientSQLitePersistenceRuntime(execSql)\n    .db.select({\n      documentId: documentPurgeCheckpoints.documentId,\n      documentManifestHash: documentPurgeCheckpoints.documentManifestHash,\n      organizationId: documentPurgeCheckpoints.organizationId,\n      purgeEventHash: documentPurgeCheckpoints.purgeEventHash,\n    })\n    .from(documentPurgeCheckpoints)\n    .where(eq(documentPurgeCheckpoints.documentId, documentId))\n    .limit(1);\n  return row ?? null;\n}\n\n/** Whether the document was permanently purged, read in the caller's transaction. */\nexport async function hasDocumentPurgeCheckpointInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  documentId: string,\n): Promise<boolean> {\n  const [row] = await tx\n    .select({ documentId: documentPurgeCheckpoints.documentId })\n    .from(documentPurgeCheckpoints)\n    .where(eq(documentPurgeCheckpoints.documentId, documentId))\n    .limit(1);\n  return row !== undefined;\n}\n\nexport async function storeDocumentPurgeCheckpointInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  checkpoint: DocumentPurgeCheckpoint,\n  updatedAt: string,\n): Promise<void> {\n  const [stored] = await tx\n    .select({\n      documentManifestHash: documentPurgeCheckpoints.documentManifestHash,\n      organizationId: documentPurgeCheckpoints.organizationId,\n      purgeEventHash: documentPurgeCheckpoints.purgeEventHash,\n    })\n    .from(documentPurgeCheckpoints)\n    .where(eq(documentPurgeCheckpoints.documentId, checkpoint.documentId))\n    .limit(1);\n  if (stored) {\n    if (\n      stored.documentManifestHash !== checkpoint.documentManifestHash ||\n      stored.organizationId !== checkpoint.organizationId ||\n      stored.purgeEventHash !== checkpoint.purgeEventHash\n    ) {\n      throw new KeyingVerificationError(\n        \"equivocation\",\n        \"Document purge checkpoint conflicts with the verified terminal event\",\n      );\n    }\n    return;\n  }\n  await tx\n    .insert(documentPurgeCheckpoints)\n    .values({ ...checkpoint, updatedAt })\n    .run();\n}\n"]}
+{"version":3,"file":"documentPurgeCheckpointPersistence.js","sourceRoot":"","sources":["documentPurgeCheckpointPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { KeyingVerificationError } from \"@tearleads/crypto\";\nimport { eq, inArray } from \"drizzle-orm\";\nimport {\n  documentPurgeCheckpoints,\n  keyingCheckpointTables,\n} from \"../../sqlite/schema\";\nimport { sqliteRowsPerStatement } from \"../../sqlite/sqliteBindBudget\";\nimport type { ClientSQLiteTransactionScope } from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { getClientSQLitePersistenceRuntime } from \"../../sqlite/sqlitePersistenceRuntime\";\nimport { type ExecSql, ensureSqlTables } from \"../../sqlite/sqlSchema\";\n\nexport interface DocumentPurgeCheckpoint {\n  readonly documentId: string;\n  readonly documentManifestHash: string;\n  readonly organizationId: string;\n  readonly purgeEventHash: string;\n}\n\nexport async function loadDocumentPurgeCheckpoint(\n  execSql: ExecSql,\n  documentId: string,\n): Promise<DocumentPurgeCheckpoint | null> {\n  await ensureSqlTables(execSql, keyingCheckpointTables);\n  const [row] = await getClientSQLitePersistenceRuntime(execSql)\n    .db.select({\n      documentId: documentPurgeCheckpoints.documentId,\n      documentManifestHash: documentPurgeCheckpoints.documentManifestHash,\n      organizationId: documentPurgeCheckpoints.organizationId,\n      purgeEventHash: documentPurgeCheckpoints.purgeEventHash,\n    })\n    .from(documentPurgeCheckpoints)\n    .where(eq(documentPurgeCheckpoints.documentId, documentId))\n    .limit(1);\n  return row ?? null;\n}\n\n/** Whether the document was permanently purged, read in the caller's transaction. */\nexport async function hasDocumentPurgeCheckpointInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  documentId: string,\n): Promise<boolean> {\n  const [row] = await tx\n    .select({ documentId: documentPurgeCheckpoints.documentId })\n    .from(documentPurgeCheckpoints)\n    .where(eq(documentPurgeCheckpoints.documentId, documentId))\n    .limit(1);\n  return row !== undefined;\n}\n\n/** The document ids among `documentIds` that carry a purge checkpoint. */\nexport async function listPurgedDocumentIdsInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  documentIds: ReadonlyArray<string>,\n): Promise<Set<string>> {\n  const purged = new Set<string>();\n  const unique = Array.from(new Set(documentIds));\n  const chunkSize = sqliteRowsPerStatement(1);\n  for (let offset = 0; offset < unique.length; offset += chunkSize) {\n    const rows = await tx\n      .select({ documentId: documentPurgeCheckpoints.documentId })\n      .from(documentPurgeCheckpoints)\n      .where(\n        inArray(\n          documentPurgeCheckpoints.documentId,\n          unique.slice(offset, offset + chunkSize),\n        ),\n      );\n    for (const row of rows) purged.add(row.documentId);\n  }\n  return purged;\n}\n\nexport async function storeDocumentPurgeCheckpointInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  checkpoint: DocumentPurgeCheckpoint,\n  updatedAt: string,\n): Promise<void> {\n  const [stored] = await tx\n    .select({\n      documentManifestHash: documentPurgeCheckpoints.documentManifestHash,\n      organizationId: documentPurgeCheckpoints.organizationId,\n      purgeEventHash: documentPurgeCheckpoints.purgeEventHash,\n    })\n    .from(documentPurgeCheckpoints)\n    .where(eq(documentPurgeCheckpoints.documentId, checkpoint.documentId))\n    .limit(1);\n  if (stored) {\n    if (\n      stored.documentManifestHash !== checkpoint.documentManifestHash ||\n      stored.organizationId !== checkpoint.organizationId ||\n      stored.purgeEventHash !== checkpoint.purgeEventHash\n    ) {\n      throw new KeyingVerificationError(\n        \"equivocation\",\n        \"Document purge checkpoint conflicts with the verified terminal event\",\n      );\n    }\n    return;\n  }\n  await tx\n    .insert(documentPurgeCheckpoints)\n    .values({ ...checkpoint, updatedAt })\n    .run();\n}\n"]}