@tearleads/client-sdk 0.0.0-stage → 0.1.11

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

@@ -0,0 +1,39 @@
+import { DEFAULT_DOCUMENT_ACCESS_EPOCH } from "../../../documents/documentConstants.js";
+function didPersistedDocumentSecurityContextChange(existingDocument, input) {
+    return (existingDocument?.documentId !== input.documentId ||
+        (existingDocument?.accessEpoch ?? DEFAULT_DOCUMENT_ACCESS_EPOCH) !==
+            input.accessEpoch);
+}
+export function resolvePersistedDocumentRuntimeState(existingDocument, input) {
+    const documentIdChanged = existingDocument?.documentId !== input.documentId;
+    const securityContextChanged = didPersistedDocumentSecurityContextChange(existingDocument, input);
+    return {
+        lastCommitLsn: documentIdChanged
+            ? null
+            : (existingDocument?.lastCommitLsn ?? null),
+        contentKeyBundle: securityContextChanged
+            ? null
+            : (existingDocument?.contentKeyBundle ?? null),
+        documentKekTargets: securityContextChanged
+            ? null
+            : (existingDocument?.documentKekTargets ?? null),
+        documentManifestBundle: securityContextChanged
+            ? null
+            : (existingDocument?.documentManifestBundle ?? null),
+        ...(securityContextChanged
+            ? { pullContinuation: null }
+            : existingDocument?.pullContinuationRecoveryRequired
+                ? { pullContinuationRecoveryRequired: true }
+                : { pullContinuation: existingDocument?.pullContinuation ?? null }),
+    };
+}
+export function resolvePersistedAccessStateHash(existingDocument, input) {
+    if (input.accessStateHash !== undefined) {
+        return input.accessStateHash;
+    }
+    const securityContextChanged = didPersistedDocumentSecurityContextChange(existingDocument, input);
+    return securityContextChanged
+        ? null
+        : (existingDocument?.accessStateHash ?? null);
+}
+//# sourceMappingURL=documentRuntimeState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentRuntimeState.js","sourceRoot":"","sources":["documentRuntimeState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAGrF,SAAS,yCAAyC,CAChD,gBAAyD,EACzD,KAGC;IAED,OAAO,CACL,gBAAgB,EAAE,UAAU,KAAK,KAAK,CAAC,UAAU;QACjD,CAAC,gBAAgB,EAAE,WAAW,IAAI,6BAA6B,CAAC;YAC9D,KAAK,CAAC,WAAW,CACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,gBAAyD,EACzD,KAGC;IAUD,MAAM,iBAAiB,GAAG,gBAAgB,EAAE,UAAU,KAAK,KAAK,CAAC,UAAU,CAAC;IAC5E,MAAM,sBAAsB,GAAG,yCAAyC,CACtE,gBAAgB,EAChB,KAAK,CACN,CAAC;IAEF,OAAO;QACL,aAAa,EAAE,iBAAiB;YAC9B,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,gBAAgB,EAAE,aAAa,IAAI,IAAI,CAAC;QAC7C,gBAAgB,EAAE,sBAAsB;YACtC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,IAAI,IAAI,CAAC;QAChD,kBAAkB,EAAE,sBAAsB;YACxC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,gBAAgB,EAAE,kBAAkB,IAAI,IAAI,CAAC;QAClD,sBAAsB,EAAE,sBAAsB;YAC5C,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,gBAAgB,EAAE,sBAAsB,IAAI,IAAI,CAAC;QACtD,GAAG,CAAC,sBAAsB;YACxB,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE;YAC5B,CAAC,CAAC,gBAAgB,EAAE,gCAAgC;gBAClD,CAAC,CAAC,EAAE,gCAAgC,EAAE,IAAa,EAAE;gBACrD,CAAC,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,IAAI,IAAI,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,gBAAyD,EACzD,KAIC;IAED,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC,eAAe,CAAC;IAC/B,CAAC;IAED,MAAM,sBAAsB,GAAG,yCAAyC,CACtE,gBAAgB,EAChB,KAAK,CACN,CAAC;IACF,OAAO,sBAAsB;QAC3B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,CAAC,gBAAgB,EAAE,eAAe,IAAI,IAAI,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { DEFAULT_DOCUMENT_ACCESS_EPOCH } from \"../../../documents/documentConstants\";\nimport type { StoredDocumentRecord } from \"../types\";\n\nfunction didPersistedDocumentSecurityContextChange(\n  existingDocument: StoredDocumentRecord | null | undefined,\n  input: {\n    accessEpoch: number;\n    documentId: string | null;\n  },\n): boolean {\n  return (\n    existingDocument?.documentId !== input.documentId ||\n    (existingDocument?.accessEpoch ?? DEFAULT_DOCUMENT_ACCESS_EPOCH) !==\n      input.accessEpoch\n  );\n}\n\nexport function resolvePersistedDocumentRuntimeState(\n  existingDocument: StoredDocumentRecord | null | undefined,\n  input: {\n    accessEpoch: number;\n    documentId: string | null;\n  },\n): Pick<\n  StoredDocumentRecord,\n  | \"lastCommitLsn\"\n  | \"contentKeyBundle\"\n  | \"documentKekTargets\"\n  | \"documentManifestBundle\"\n  | \"pullContinuation\"\n  | \"pullContinuationRecoveryRequired\"\n> {\n  const documentIdChanged = existingDocument?.documentId !== input.documentId;\n  const securityContextChanged = didPersistedDocumentSecurityContextChange(\n    existingDocument,\n    input,\n  );\n\n  return {\n    lastCommitLsn: documentIdChanged\n      ? null\n      : (existingDocument?.lastCommitLsn ?? null),\n    contentKeyBundle: securityContextChanged\n      ? null\n      : (existingDocument?.contentKeyBundle ?? null),\n    documentKekTargets: securityContextChanged\n      ? null\n      : (existingDocument?.documentKekTargets ?? null),\n    documentManifestBundle: securityContextChanged\n      ? null\n      : (existingDocument?.documentManifestBundle ?? null),\n    ...(securityContextChanged\n      ? { pullContinuation: null }\n      : existingDocument?.pullContinuationRecoveryRequired\n        ? { pullContinuationRecoveryRequired: true as const }\n        : { pullContinuation: existingDocument?.pullContinuation ?? null }),\n  };\n}\n\nexport function resolvePersistedAccessStateHash(\n  existingDocument: StoredDocumentRecord | null | undefined,\n  input: {\n    accessEpoch: number;\n    accessStateHash?: string | null | undefined;\n    documentId: string | null;\n  },\n): string | null {\n  if (input.accessStateHash !== undefined) {\n    return input.accessStateHash;\n  }\n\n  const securityContextChanged = didPersistedDocumentSecurityContextChange(\n    existingDocument,\n    input,\n  );\n  return securityContextChanged\n    ? null\n    : (existingDocument?.accessStateHash ?? null);\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentStoreStatePersistence.js","sourceRoot":"","sources":["documentStoreStatePersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAsE,EACtE,OAAe,EACf,WAMC;IAED,OAAO,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAC/D,iCAAiC,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;QACtE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,mBAAmB,GAAG,MAAM,WAAW,CAAC,uBAAuB,CACnE,aAAa,EACb,OAAO,CACR,CAAC;QACF,MAAM,kBAAkB,GAAG,MAAM,WAAW,CAAC,sBAAsB,CACjE,aAAa,EACb,OAAO,CACR,CAAC;QACF,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC,oBAAoB,CAC7D,aAAa,EACb,OAAO,CACR,CAAC;QACF,OAAO;YACL,QAAQ;YACR,mBAAmB;YACnB,gBAAgB;YAChB,kBAAkB;SACnB,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport { runSerializedSqlMutation } from \"../../../sqlite/sqlSchema\";\nimport type { DocumentsPersistence } from \"../types\";\n\nexport async function loadStoredDocumentStoreState(\n  execSql: Parameters<DocumentsPersistence[\"loadDocumentStoreState\"]>[0],\n  localId: string,\n  persistence: Pick<\n    DocumentsPersistence,\n    | \"listLocalAttachments\"\n    | \"listPendingAttachments\"\n    | \"loadDocument\"\n    | \"loadHistoryRestoreState\"\n  >,\n): ReturnType<DocumentsPersistence[\"loadDocumentStoreState\"]> {\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n    getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async () => {\n      const document = await persistence.loadDocument(lockedExecSql, localId);\n      const historyRestoreState = await persistence.loadHistoryRestoreState(\n        lockedExecSql,\n        localId,\n      );\n      const pendingAttachments = await persistence.listPendingAttachments(\n        lockedExecSql,\n        localId,\n      );\n      const localAttachments = await persistence.listLocalAttachments(\n        lockedExecSql,\n        localId,\n      );\n      return {\n        document,\n        historyRestoreState,\n        localAttachments,\n        pendingAttachments,\n      };\n    }),\n  );\n}\n"]}

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

@@ -0,0 +1,89 @@
+import { and, asc, count, desc, eq, notInArray, sql, } from "drizzle-orm";
+import { HIDDEN_DOCUMENT_SUMMARY_KINDS } from "../../../documents/documentSummary.js";
+import { documentProjection, documents } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { documentSummaryJoin, documentSummarySelection, mapDocumentSummary, } from "./documentProjectionRows.js";
+const DEFAULT_DOCUMENT_SUMMARY_SORT = {
+    direction: "desc",
+    key: "updated",
+};
+function normalizeDocumentSummaryWindowValue(value) {
+    if (value === undefined || !Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, Math.trunc(value));
+}
+function normalizeDocumentSummarySort(sort) {
+    if (!sort ||
+        (sort.direction !== "asc" && sort.direction !== "desc") ||
+        !["kind", "title", "updated"].includes(sort.key)) {
+        return DEFAULT_DOCUMENT_SUMMARY_SORT;
+    }
+    return sort;
+}
+function getDocumentSummaryFilters(input) {
+    const conditions = [
+        notInArray(documentProjection.documentKind, [
+            ...HIDDEN_DOCUMENT_SUMMARY_KINDS,
+        ]),
+    ];
+    if (input.documentKind) {
+        conditions.push(eq(documentProjection.documentKind, input.documentKind));
+    }
+    return and(...conditions);
+}
+function getDocumentSummaryOrderBy(sort) {
+    const normalizedSort = normalizeDocumentSummarySort(sort);
+    const order = normalizedSort.direction === "asc"
+        ? {
+            column: asc,
+        }
+        : {
+            column: desc,
+        };
+    switch (normalizedSort.key) {
+        case "kind":
+            return [
+                order.column(documentProjection.documentKind),
+                order.column(documentProjection.localId),
+            ];
+        case "title":
+            return [
+                order.column(sql `${documentProjection.title} COLLATE NOCASE`),
+                order.column(documentProjection.localId),
+            ];
+        case "updated":
+            return [
+                order.column(documentProjection.updatedAt),
+                order.column(documentProjection.localId),
+            ];
+    }
+}
+export async function listDocumentSummaries(execSql, input = {}) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const filters = getDocumentSummaryFilters(input);
+    const normalizedOffset = normalizeDocumentSummaryWindowValue(input.offset);
+    const normalizedLimit = input.limit === undefined
+        ? null
+        : normalizeDocumentSummaryWindowValue(input.limit);
+    const totalCountRows = await db
+        .select({ totalCount: count() })
+        .from(documentProjection)
+        .where(filters);
+    const rowQuery = db
+        .select(documentSummarySelection)
+        .from(documentProjection)
+        .leftJoin(documents, documentSummaryJoin)
+        .where(filters)
+        .orderBy(...getDocumentSummaryOrderBy(input.sort));
+    const rows = normalizedLimit === null
+        ? normalizedOffset === 0
+            ? await rowQuery
+            : await rowQuery.limit(-1).offset(normalizedOffset)
+        : await rowQuery.limit(normalizedLimit).offset(normalizedOffset);
+    return {
+        rows: rows.map(mapDocumentSummary),
+        totalCount: totalCountRows[0]?.totalCount ?? 0,
+    };
+}
+//# sourceMappingURL=documentSummaryQueries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentSummaryQueries.js","sourceRoot":"","sources":["documentSummaryQueries.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,GAAG,EACH,KAAK,EACL,IAAI,EACJ,EAAE,EACF,UAAU,EAEV,GAAG,GACJ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAO7F,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,MAAM,6BAA6B,GAAwB;IACzD,SAAS,EAAE,MAAM;IACjB,GAAG,EAAE,SAAS;CACf,CAAC;AAEF,SAAS,mCAAmC,CAC1C,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,4BAA4B,CACnC,IAAqC;IAErC,IACE,CAAC,IAAI;QACL,CAAC,IAAI,CAAC,SAAS,KAAK,KAAK,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC;QACvD,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAChD,CAAC;QACD,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAiC;IAEjC,MAAM,UAAU,GAAU;QACxB,UAAU,CAAC,kBAAkB,CAAC,YAAY,EAAE;YAC1C,GAAG,6BAA6B;SACjC,CAAC;KACH,CAAC;IACF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,yBAAyB,CAChC,IAAqC;IAErC,MAAM,cAAc,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,KAAK,GACT,cAAc,CAAC,SAAS,KAAK,KAAK;QAChC,CAAC,CAAC;YACE,MAAM,EAAE,GAAG;SACZ;QACH,CAAC,CAAC;YACE,MAAM,EAAE,IAAI;SACb,CAAC;IAER,QAAQ,cAAc,CAAC,GAAG,EAAE,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO;gBACL,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC;gBAC7C,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC;aACzC,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,KAAK,CAAC,MAAM,CAAC,GAAG,CAAA,GAAG,kBAAkB,CAAC,KAAK,iBAAiB,CAAC;gBAC7D,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC;aACzC,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC;gBAC1C,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC;aACzC,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgB,EAChB,QAAoC,EAAE;IAEtC,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,gBAAgB,GAAG,mCAAmC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,eAAe,GACnB,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,mCAAmC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,MAAM,EAAE;SAC5B,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC;SAC/B,IAAI,CAAC,kBAAkB,CAAC;SACxB,KAAK,CAAC,OAAO,CAAC,CAAC;IAClB,MAAM,QAAQ,GAAG,EAAE;SAChB,MAAM,CAAC,wBAAwB,CAAC;SAChC,IAAI,CAAC,kBAAkB,CAAC;SACxB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;SACxC,KAAK,CAAC,OAAO,CAAC;SACd,OAAO,CAAC,GAAG,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,GACR,eAAe,KAAK,IAAI;QACtB,CAAC,CAAC,gBAAgB,KAAK,CAAC;YACtB,CAAC,CAAC,MAAM,QAAQ;YAChB,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACrD,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAErE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAClC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC;KAC/C,CAAC;AACJ,CAAC","sourcesContent":["import {\n  and,\n  asc,\n  count,\n  desc,\n  eq,\n  notInArray,\n  type SQL,\n  sql,\n} from \"drizzle-orm\";\nimport { HIDDEN_DOCUMENT_SUMMARY_KINDS } from \"../../../documents/documentSummary\";\nimport { documentProjection, documents } from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../../sqlite/sqlSchema\";\nimport type {\n  DocumentSummaryList,\n  DocumentSummarySort,\n  ListDocumentSummariesInput,\n} from \"../types\";\nimport {\n  documentSummaryJoin,\n  documentSummarySelection,\n  mapDocumentSummary,\n} from \"./documentProjectionRows\";\n\nconst DEFAULT_DOCUMENT_SUMMARY_SORT: DocumentSummarySort = {\n  direction: \"desc\",\n  key: \"updated\",\n};\n\nfunction normalizeDocumentSummaryWindowValue(\n  value: number | undefined,\n): number {\n  if (value === undefined || !Number.isFinite(value)) {\n    return 0;\n  }\n\n  return Math.max(0, Math.trunc(value));\n}\n\nfunction normalizeDocumentSummarySort(\n  sort: DocumentSummarySort | undefined,\n): DocumentSummarySort {\n  if (\n    !sort ||\n    (sort.direction !== \"asc\" && sort.direction !== \"desc\") ||\n    ![\"kind\", \"title\", \"updated\"].includes(sort.key)\n  ) {\n    return DEFAULT_DOCUMENT_SUMMARY_SORT;\n  }\n\n  return sort;\n}\n\nfunction getDocumentSummaryFilters(\n  input: ListDocumentSummariesInput,\n): SQL | undefined {\n  const conditions: SQL[] = [\n    notInArray(documentProjection.documentKind, [\n      ...HIDDEN_DOCUMENT_SUMMARY_KINDS,\n    ]),\n  ];\n  if (input.documentKind) {\n    conditions.push(eq(documentProjection.documentKind, input.documentKind));\n  }\n\n  return and(...conditions);\n}\n\nfunction getDocumentSummaryOrderBy(\n  sort: DocumentSummarySort | undefined,\n): SQL[] {\n  const normalizedSort = normalizeDocumentSummarySort(sort);\n  const order =\n    normalizedSort.direction === \"asc\"\n      ? {\n          column: asc,\n        }\n      : {\n          column: desc,\n        };\n\n  switch (normalizedSort.key) {\n    case \"kind\":\n      return [\n        order.column(documentProjection.documentKind),\n        order.column(documentProjection.localId),\n      ];\n    case \"title\":\n      return [\n        order.column(sql`${documentProjection.title} COLLATE NOCASE`),\n        order.column(documentProjection.localId),\n      ];\n    case \"updated\":\n      return [\n        order.column(documentProjection.updatedAt),\n        order.column(documentProjection.localId),\n      ];\n  }\n}\n\nexport async function listDocumentSummaries(\n  execSql: ExecSql,\n  input: ListDocumentSummariesInput = {},\n): Promise<DocumentSummaryList> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const filters = getDocumentSummaryFilters(input);\n  const normalizedOffset = normalizeDocumentSummaryWindowValue(input.offset);\n  const normalizedLimit =\n    input.limit === undefined\n      ? null\n      : normalizeDocumentSummaryWindowValue(input.limit);\n  const totalCountRows = await db\n    .select({ totalCount: count() })\n    .from(documentProjection)\n    .where(filters);\n  const rowQuery = db\n    .select(documentSummarySelection)\n    .from(documentProjection)\n    .leftJoin(documents, documentSummaryJoin)\n    .where(filters)\n    .orderBy(...getDocumentSummaryOrderBy(input.sort));\n  const rows =\n    normalizedLimit === null\n      ? normalizedOffset === 0\n        ? await rowQuery\n        : await rowQuery.limit(-1).offset(normalizedOffset)\n      : await rowQuery.limit(normalizedLimit).offset(normalizedOffset);\n\n  return {\n    rows: rows.map(mapDocumentSummary),\n    totalCount: totalCountRows[0]?.totalCount ?? 0,\n  };\n}\n"]}

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

@@ -0,0 +1,15 @@
+import { ensureDocumentProjectionTables, ensureDocumentTables, } from "../../../sqlite/documentPersistence.js";
+import { documentContainerProjectionTables, documentMoveIntentTables, keyingCheckpointTables, } from "../../../sqlite/schema.js";
+import { ensureSqlTables, runOncePerConnection, runSerializedSqlMutation, } from "../../../sqlite/sqlSchema.js";
+export async function ensureDocumentsSchema(execSql) {
+    await runOncePerConnection(execSql, "ensure:documents", () => runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        await ensureDocumentTables(lockedExecSql);
+        await ensureDocumentProjectionTables(lockedExecSql);
+        await ensureSqlTables(lockedExecSql, [
+            ...documentContainerProjectionTables,
+            ...documentMoveIntentTables,
+            ...keyingCheckpointTables,
+        ]);
+    }));
+}
+//# sourceMappingURL=ensureDocumentsSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensureDocumentsSchema.js","sourceRoot":"","sources":["ensureDocumentsSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,iCAAiC,EACjC,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,eAAe,EACf,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IAC1D,MAAM,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAC3D,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QACxD,MAAM,oBAAoB,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,8BAA8B,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,eAAe,CAAC,aAAa,EAAE;YACnC,GAAG,iCAAiC;YACpC,GAAG,wBAAwB;YAC3B,GAAG,sBAAsB;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import {\n  ensureDocumentProjectionTables,\n  ensureDocumentTables,\n} from \"../../../sqlite/documentPersistence\";\nimport {\n  documentContainerProjectionTables,\n  documentMoveIntentTables,\n  keyingCheckpointTables,\n} from \"../../../sqlite/schema\";\nimport {\n  type ExecSql,\n  ensureSqlTables,\n  runOncePerConnection,\n  runSerializedSqlMutation,\n} from \"../../../sqlite/sqlSchema\";\n\nexport async function ensureDocumentsSchema(execSql: ExecSql): Promise<void> {\n  await runOncePerConnection(execSql, \"ensure:documents\", () =>\n    runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n      await ensureDocumentTables(lockedExecSql);\n      await ensureDocumentProjectionTables(lockedExecSql);\n      await ensureSqlTables(lockedExecSql, [\n        ...documentContainerProjectionTables,\n        ...documentMoveIntentTables,\n        ...keyingCheckpointTables,\n      ]);\n    }),\n  );\n}\n"]}

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

@@ -0,0 +1,47 @@
+import { and, eq } from "drizzle-orm";
+import { documentAttachmentBlobProjection, documents, } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { queueDocumentAttachmentStorageKeys } from "./orphanSideRows.js";
+export const saveHydratedAttachment = async (execSql, input) => {
+    const { attachment, expectedStorageKey, stillCurrent } = input;
+    const outcome = await getClientSQLitePersistenceRuntime(execSql).guardedTransaction(async (tx) => {
+        const [document] = await tx
+            .select({ snapshotEndVersion: documents.snapshotEndVersion })
+            .from(documents)
+            .where(eq(documents.localId, attachment.localId))
+            .limit(1);
+        if ((document?.snapshotEndVersion ?? null) !==
+            input.expectedSnapshotEndVersion)
+            return false;
+        const [existing] = await tx
+            .select({ storageKey: documentAttachmentBlobProjection.storageKey })
+            .from(documentAttachmentBlobProjection)
+            .where(and(eq(documentAttachmentBlobProjection.localId, attachment.localId), eq(documentAttachmentBlobProjection.slotId, attachment.slotId)))
+            .limit(1);
+        if ((existing?.storageKey ?? null) !== expectedStorageKey)
+            return false;
+        const row = { ...attachment, updatedAt: new Date().toISOString() };
+        await tx
+            .insert(documentAttachmentBlobProjection)
+            .values(row)
+            .onConflictDoUpdate({
+            target: [
+                documentAttachmentBlobProjection.localId,
+                documentAttachmentBlobProjection.slotId,
+            ],
+            set: row,
+        })
+            .run();
+        if (expectedStorageKey &&
+            expectedStorageKey !== attachment.storageKey) {
+            await queueDocumentAttachmentStorageKeys(tx, [expectedStorageKey]);
+        }
+        return true;
+    }, stillCurrent, { behavior: "immediate" });
+    const committed = outcome.committed && outcome.result === true;
+    if (!committed) {
+        await getClientSQLitePersistenceRuntime(execSql).transaction((tx) => queueDocumentAttachmentStorageKeys(tx, [attachment.storageKey]));
+    }
+    return committed;
+};
+//# sourceMappingURL=hydratedAttachmentPersistence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydratedAttachmentPersistence.js","sourceRoot":"","sources":["hydratedAttachmentPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,gCAAgC,EAChC,SAAS,GACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAE7F,OAAO,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAC;AAEtE,MAAM,CAAC,MAAM,sBAAsB,GACjC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IACvB,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAC/D,MAAM,OAAO,GAAG,MAAM,iCAAiC,CACrD,OAAO,CACR,CAAC,kBAAkB,CAClB,KAAK,EAAE,EAAE,EAAE,EAAE;QACX,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;aACxB,MAAM,CAAC,EAAE,kBAAkB,EAAE,SAAS,CAAC,kBAAkB,EAAE,CAAC;aAC5D,IAAI,CAAC,SAAS,CAAC;aACf,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;aAChD,KAAK,CAAC,CAAC,CAAC,CAAC;QACZ,IACE,CAAC,QAAQ,EAAE,kBAAkB,IAAI,IAAI,CAAC;YACtC,KAAK,CAAC,0BAA0B;YAEhC,OAAO,KAAK,CAAC;QACf,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;aACxB,MAAM,CAAC,EAAE,UAAU,EAAE,gCAAgC,CAAC,UAAU,EAAE,CAAC;aACnE,IAAI,CAAC,gCAAgC,CAAC;aACtC,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,gCAAgC,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAChE,EAAE,CAAC,gCAAgC,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAC/D,CACF;aACA,KAAK,CAAC,CAAC,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,IAAI,CAAC,KAAK,kBAAkB;YAAE,OAAO,KAAK,CAAC;QACxE,MAAM,GAAG,GAAG,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACnE,MAAM,EAAE;aACL,MAAM,CAAC,gCAAgC,CAAC;aACxC,MAAM,CAAC,GAAG,CAAC;aACX,kBAAkB,CAAC;YAClB,MAAM,EAAE;gBACN,gCAAgC,CAAC,OAAO;gBACxC,gCAAgC,CAAC,MAAM;aACxC;YACD,GAAG,EAAE,GAAG;SACT,CAAC;aACD,GAAG,EAAE,CAAC;QACT,IACE,kBAAkB;YAClB,kBAAkB,KAAK,UAAU,CAAC,UAAU,EAC5C,CAAC;YACD,MAAM,kCAAkC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EACD,YAAY,EACZ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAC1B,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;IAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,iCAAiC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAClE,kCAAkC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAChE,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import { and, eq } from \"drizzle-orm\";\nimport {\n  documentAttachmentBlobProjection,\n  documents,\n} from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport type { DocumentsPersistence } from \"../types\";\nimport { queueDocumentAttachmentStorageKeys } from \"./orphanSideRows\";\n\nexport const saveHydratedAttachment: DocumentsPersistence[\"saveHydratedAttachment\"] =\n  async (execSql, input) => {\n    const { attachment, expectedStorageKey, stillCurrent } = input;\n    const outcome = await getClientSQLitePersistenceRuntime(\n      execSql,\n    ).guardedTransaction(\n      async (tx) => {\n        const [document] = await tx\n          .select({ snapshotEndVersion: documents.snapshotEndVersion })\n          .from(documents)\n          .where(eq(documents.localId, attachment.localId))\n          .limit(1);\n        if (\n          (document?.snapshotEndVersion ?? null) !==\n          input.expectedSnapshotEndVersion\n        )\n          return false;\n        const [existing] = await tx\n          .select({ storageKey: documentAttachmentBlobProjection.storageKey })\n          .from(documentAttachmentBlobProjection)\n          .where(\n            and(\n              eq(documentAttachmentBlobProjection.localId, attachment.localId),\n              eq(documentAttachmentBlobProjection.slotId, attachment.slotId),\n            ),\n          )\n          .limit(1);\n        if ((existing?.storageKey ?? null) !== expectedStorageKey) return false;\n        const row = { ...attachment, updatedAt: new Date().toISOString() };\n        await tx\n          .insert(documentAttachmentBlobProjection)\n          .values(row)\n          .onConflictDoUpdate({\n            target: [\n              documentAttachmentBlobProjection.localId,\n              documentAttachmentBlobProjection.slotId,\n            ],\n            set: row,\n          })\n          .run();\n        if (\n          expectedStorageKey &&\n          expectedStorageKey !== attachment.storageKey\n        ) {\n          await queueDocumentAttachmentStorageKeys(tx, [expectedStorageKey]);\n        }\n        return true;\n      },\n      stillCurrent,\n      { behavior: \"immediate\" },\n    );\n    const committed = outcome.committed && outcome.result === true;\n    if (!committed) {\n      await getClientSQLitePersistenceRuntime(execSql).transaction((tx) =>\n        queueDocumentAttachmentStorageKeys(tx, [attachment.storageKey]),\n      );\n    }\n    return committed;\n  };\n"]}

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

@@ -0,0 +1,204 @@
+import { and, asc, eq, inArray, isNotNull, lt, notExists, or, } from "drizzle-orm";
+import { documentOrphanBlobReclaims } from "../../../sqlite/documentOrphanBlobReclaims.js";
+import { documentAttachmentBlobProjection, documentHistoryCheckpoints, documentHistoryUpdates, documentPendingAttachments, documentPendingUpdates, documentSyncFailures, documents, } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime, } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { runSerializedSqlMutation, } from "../../../sqlite/sqlSchema.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+// Crash residue gets a full day to outlive slow devices and wall-clock skew;
+// canonical-row absence is necessary but never sufficient for fresh writes.
+const DOCUMENT_ORPHAN_SWEEP_MIN_AGE_MS = 24 * 60 * 60 * 1000;
+const DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE = 32;
+function requirePredicate(predicate) {
+    if (!predicate) {
+        throw new Error("Document orphan cleanup requires a SQL predicate");
+    }
+    return predicate;
+}
+function hasNoDocument(tx, localId, appKind = DOCUMENTS_APP_KIND) {
+    return notExists(tx
+        .select({ localId: documents.localId })
+        .from(documents)
+        .where(appKind === null
+        ? eq(documents.localId, localId)
+        : and(eq(documents.appKind, appKind), eq(documents.localId, localId))));
+}
+export async function queueDocumentAttachmentBlobReclaims(input) {
+    const { localWhere, pendingWhere, tx } = input;
+    const [pendingAttachmentRows, localAttachmentRows] = await Promise.all([
+        tx
+            .select({ storageKey: documentPendingAttachments.storageKey })
+            .from(documentPendingAttachments)
+            .where(pendingWhere),
+        tx
+            .select({ storageKey: documentAttachmentBlobProjection.storageKey })
+            .from(documentAttachmentBlobProjection)
+            .where(localWhere),
+    ]);
+    const storageKeys = [
+        ...new Set([...pendingAttachmentRows, ...localAttachmentRows].map((row) => row.storageKey)),
+    ];
+    await queueDocumentAttachmentStorageKeys(tx, storageKeys);
+}
+export async function queueDocumentAttachmentStorageKeys(tx, storageKeys) {
+    if (storageKeys.length > 0) {
+        await tx
+            .insert(documentOrphanBlobReclaims)
+            .values(storageKeys.map((storageKey) => ({ storageKey })))
+            .onConflictDoNothing()
+            .run();
+    }
+}
+function pendingAttachmentCandidatesWhere(candidates) {
+    return requirePredicate(or(...candidates.map((candidate) => and(eq(documentPendingAttachments.localId, candidate.localId), eq(documentPendingAttachments.slotId, candidate.slotId)))));
+}
+function localAttachmentCandidatesWhere(candidates) {
+    return requirePredicate(or(...candidates.map((candidate) => and(eq(documentAttachmentBlobProjection.localId, candidate.localId), eq(documentAttachmentBlobProjection.slotId, candidate.slotId)))));
+}
+async function selectHistorySweepCandidates(tx, olderThan) {
+    const checkpoints = await tx
+        .select({ localId: documentHistoryCheckpoints.localId })
+        .from(documentHistoryCheckpoints)
+        .where(and(eq(documentHistoryCheckpoints.appKind, DOCUMENTS_APP_KIND), lt(documentHistoryCheckpoints.updatedAt, olderThan), hasNoDocument(tx, documentHistoryCheckpoints.localId)))
+        .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+    const updates = await tx
+        .select({ id: documentHistoryUpdates.id })
+        .from(documentHistoryUpdates)
+        .where(and(eq(documentHistoryUpdates.appKind, DOCUMENTS_APP_KIND), isNotNull(documentHistoryUpdates.id), lt(documentHistoryUpdates.createdAt, olderThan), hasNoDocument(tx, documentHistoryUpdates.localId)))
+        .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+    return { checkpoints, updates };
+}
+async function selectWriteSweepCandidates(tx, olderThan) {
+    const pendingUpdates = await tx
+        .select({ id: documentPendingUpdates.id })
+        .from(documentPendingUpdates)
+        .where(and(eq(documentPendingUpdates.appKind, DOCUMENTS_APP_KIND), isNotNull(documentPendingUpdates.id), lt(documentPendingUpdates.createdAt, olderThan), hasNoDocument(tx, documentPendingUpdates.localId)))
+        .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+    const syncFailures = await tx
+        .select({ localId: documentSyncFailures.localId })
+        .from(documentSyncFailures)
+        .where(and(eq(documentSyncFailures.appKind, DOCUMENTS_APP_KIND), lt(documentSyncFailures.attemptedAt, olderThan), hasNoDocument(tx, documentSyncFailures.localId)))
+        .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+    return { pendingUpdates, syncFailures };
+}
+async function selectAttachmentSweepCandidates(tx, olderThan) {
+    const pending = await tx
+        .select({
+        localId: documentPendingAttachments.localId,
+        slotId: documentPendingAttachments.slotId,
+        storageKey: documentPendingAttachments.storageKey,
+    })
+        .from(documentPendingAttachments)
+        .where(and(lt(documentPendingAttachments.createdAt, olderThan), hasNoDocument(tx, documentPendingAttachments.localId, null)))
+        .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+    const local = await tx
+        .select({
+        localId: documentAttachmentBlobProjection.localId,
+        slotId: documentAttachmentBlobProjection.slotId,
+        storageKey: documentAttachmentBlobProjection.storageKey,
+    })
+        .from(documentAttachmentBlobProjection)
+        .where(and(lt(documentAttachmentBlobProjection.updatedAt, olderThan), hasNoDocument(tx, documentAttachmentBlobProjection.localId, null)))
+        .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+    return { local, pending };
+}
+async function deleteHistorySweepCandidates(tx, candidates) {
+    if (candidates.checkpoints.length > 0) {
+        await tx
+            .delete(documentHistoryCheckpoints)
+            .where(and(eq(documentHistoryCheckpoints.appKind, DOCUMENTS_APP_KIND), inArray(documentHistoryCheckpoints.localId, candidates.checkpoints.map((row) => row.localId))))
+            .run();
+    }
+    if (candidates.updates.length > 0) {
+        await tx
+            .delete(documentHistoryUpdates)
+            .where(inArray(documentHistoryUpdates.id, candidates.updates.flatMap((row) => row.id === null ? [] : [row.id])))
+            .run();
+    }
+}
+async function deleteWriteSweepCandidates(tx, candidates) {
+    if (candidates.pendingUpdates.length > 0) {
+        await tx
+            .delete(documentPendingUpdates)
+            .where(inArray(documentPendingUpdates.id, candidates.pendingUpdates.flatMap((row) => row.id === null ? [] : [row.id])))
+            .run();
+    }
+    if (candidates.syncFailures.length > 0) {
+        await tx
+            .delete(documentSyncFailures)
+            .where(and(eq(documentSyncFailures.appKind, DOCUMENTS_APP_KIND), inArray(documentSyncFailures.localId, candidates.syncFailures.map((row) => row.localId))))
+            .run();
+    }
+}
+async function deleteAttachmentSweepCandidates(tx, candidates) {
+    await queueDocumentAttachmentStorageKeys(tx, [
+        ...new Set([...candidates.pending, ...candidates.local].map((row) => row.storageKey)),
+    ]);
+    if (candidates.pending.length > 0) {
+        await tx
+            .delete(documentPendingAttachments)
+            .where(pendingAttachmentCandidatesWhere(candidates.pending))
+            .run();
+    }
+    if (candidates.local.length > 0) {
+        await tx
+            .delete(documentAttachmentBlobProjection)
+            .where(localAttachmentCandidatesWhere(candidates.local))
+            .run();
+    }
+}
+function hasFullSweepBatch(history, writes, attachments) {
+    return [
+        history.checkpoints,
+        history.updates,
+        writes.pendingUpdates,
+        writes.syncFailures,
+        attachments.pending,
+        attachments.local,
+    ].some((rows) => rows.length === DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);
+}
+/** Remove one bounded batch of aged side writes without a canonical row. */
+export async function deleteOrphanedDocumentSideRows(execSql, options = {}) {
+    const olderThan = new Date((options.now?.getTime() ?? Date.now()) - DOCUMENT_ORPHAN_SWEEP_MIN_AGE_MS).toISOString();
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async (tx) => {
+        const history = await selectHistorySweepCandidates(tx, olderThan);
+        const writes = await selectWriteSweepCandidates(tx, olderThan);
+        const attachments = await selectAttachmentSweepCandidates(tx, olderThan);
+        await deleteHistorySweepCandidates(tx, history);
+        await deleteWriteSweepCandidates(tx, writes);
+        await deleteAttachmentSweepCandidates(tx, attachments);
+        return hasFullSweepBatch(history, writes, attachments);
+    }));
+}
+export async function listDocumentOrphanBlobReclaims(execSql, limit) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select({ storageKey: documentOrphanBlobReclaims.storageKey })
+        .from(documentOrphanBlobReclaims)
+        .orderBy(asc(documentOrphanBlobReclaims.storageKey))
+        .limit(limit);
+    return rows.map((row) => row.storageKey);
+}
+export async function isDocumentBlobStorageKeyReferenced(execSql, storageKey) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const [pendingRows, localRows] = await Promise.all([
+        db
+            .select({ storageKey: documentPendingAttachments.storageKey })
+            .from(documentPendingAttachments)
+            .where(eq(documentPendingAttachments.storageKey, storageKey))
+            .limit(1),
+        db
+            .select({ storageKey: documentAttachmentBlobProjection.storageKey })
+            .from(documentAttachmentBlobProjection)
+            .where(eq(documentAttachmentBlobProjection.storageKey, storageKey))
+            .limit(1),
+    ]);
+    return pendingRows.length > 0 || localRows.length > 0;
+}
+export async function acknowledgeDocumentOrphanBlobReclaim(execSql, storageKey) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    await db
+        .delete(documentOrphanBlobReclaims)
+        .where(eq(documentOrphanBlobReclaims.storageKey, storageKey))
+        .run();
+}
+//# sourceMappingURL=orphanSideRows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orphanSideRows.js","sourceRoot":"","sources":["orphanSideRows.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  and,\n  asc,\n  eq,\n  inArray,\n  isNotNull,\n  lt,\n  notExists,\n  or,\n  type SQL,\n} from \"drizzle-orm\";\nimport { documentOrphanBlobReclaims } from \"../../../sqlite/documentOrphanBlobReclaims\";\nimport {\n  documentAttachmentBlobProjection,\n  documentHistoryCheckpoints,\n  documentHistoryUpdates,\n  documentPendingAttachments,\n  documentPendingUpdates,\n  documentSyncFailures,\n  documents,\n} from \"../../../sqlite/schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport {\n  type ExecSql,\n  runSerializedSqlMutation,\n} from \"../../../sqlite/sqlSchema\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\n\n// Crash residue gets a full day to outlive slow devices and wall-clock skew;\n// canonical-row absence is necessary but never sufficient for fresh writes.\nconst DOCUMENT_ORPHAN_SWEEP_MIN_AGE_MS = 24 * 60 * 60 * 1000;\nconst DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE = 32;\n\ntype DocumentSideLocalIdColumn =\n  | typeof documentAttachmentBlobProjection.localId\n  | typeof documentHistoryCheckpoints.localId\n  | typeof documentHistoryUpdates.localId\n  | typeof documentPendingAttachments.localId\n  | typeof documentPendingUpdates.localId\n  | typeof documentSyncFailures.localId;\n\nfunction requirePredicate(predicate: SQL | undefined): SQL {\n  if (!predicate) {\n    throw new Error(\"Document orphan cleanup requires a SQL predicate\");\n  }\n  return predicate;\n}\n\nfunction hasNoDocument(\n  tx: ClientSQLiteTransactionScope,\n  localId: DocumentSideLocalIdColumn,\n  appKind: string | null = DOCUMENTS_APP_KIND,\n): SQL {\n  return notExists(\n    tx\n      .select({ localId: documents.localId })\n      .from(documents)\n      .where(\n        appKind === null\n          ? eq(documents.localId, localId)\n          : and(eq(documents.appKind, appKind), eq(documents.localId, localId)),\n      ),\n  );\n}\n\nexport async function queueDocumentAttachmentBlobReclaims(input: {\n  localWhere: SQL;\n  pendingWhere: SQL;\n  tx: ClientSQLiteTransactionScope;\n}): Promise<void> {\n  const { localWhere, pendingWhere, tx } = input;\n  const [pendingAttachmentRows, localAttachmentRows] = await Promise.all([\n    tx\n      .select({ storageKey: documentPendingAttachments.storageKey })\n      .from(documentPendingAttachments)\n      .where(pendingWhere),\n    tx\n      .select({ storageKey: documentAttachmentBlobProjection.storageKey })\n      .from(documentAttachmentBlobProjection)\n      .where(localWhere),\n  ]);\n  const storageKeys = [\n    ...new Set(\n      [...pendingAttachmentRows, ...localAttachmentRows].map(\n        (row) => row.storageKey,\n      ),\n    ),\n  ];\n  await queueDocumentAttachmentStorageKeys(tx, storageKeys);\n}\n\nexport async function queueDocumentAttachmentStorageKeys(\n  tx: ClientSQLiteTransactionScope,\n  storageKeys: ReadonlyArray<string>,\n): Promise<void> {\n  if (storageKeys.length > 0) {\n    await tx\n      .insert(documentOrphanBlobReclaims)\n      .values(storageKeys.map((storageKey) => ({ storageKey })))\n      .onConflictDoNothing()\n      .run();\n  }\n}\n\ninterface AttachmentSweepCandidate {\n  localId: string;\n  slotId: string;\n  storageKey: string;\n}\n\nfunction pendingAttachmentCandidatesWhere(\n  candidates: ReadonlyArray<AttachmentSweepCandidate>,\n): SQL {\n  return requirePredicate(\n    or(\n      ...candidates.map((candidate) =>\n        and(\n          eq(documentPendingAttachments.localId, candidate.localId),\n          eq(documentPendingAttachments.slotId, candidate.slotId),\n        ),\n      ),\n    ),\n  );\n}\n\nfunction localAttachmentCandidatesWhere(\n  candidates: ReadonlyArray<AttachmentSweepCandidate>,\n): SQL {\n  return requirePredicate(\n    or(\n      ...candidates.map((candidate) =>\n        and(\n          eq(documentAttachmentBlobProjection.localId, candidate.localId),\n          eq(documentAttachmentBlobProjection.slotId, candidate.slotId),\n        ),\n      ),\n    ),\n  );\n}\n\ninterface HistorySweepCandidates {\n  checkpoints: ReadonlyArray<{ localId: string }>;\n  updates: ReadonlyArray<{ id: string | null }>;\n}\n\ninterface WriteSweepCandidates {\n  pendingUpdates: ReadonlyArray<{ id: string | null }>;\n  syncFailures: ReadonlyArray<{ localId: string }>;\n}\n\ninterface AttachmentSweepCandidates {\n  local: ReadonlyArray<AttachmentSweepCandidate>;\n  pending: ReadonlyArray<AttachmentSweepCandidate>;\n}\n\nasync function selectHistorySweepCandidates(\n  tx: ClientSQLiteTransactionScope,\n  olderThan: string,\n): Promise<HistorySweepCandidates> {\n  const checkpoints = await tx\n    .select({ localId: documentHistoryCheckpoints.localId })\n    .from(documentHistoryCheckpoints)\n    .where(\n      and(\n        eq(documentHistoryCheckpoints.appKind, DOCUMENTS_APP_KIND),\n        lt(documentHistoryCheckpoints.updatedAt, olderThan),\n        hasNoDocument(tx, documentHistoryCheckpoints.localId),\n      ),\n    )\n    .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n  const updates = await tx\n    .select({ id: documentHistoryUpdates.id })\n    .from(documentHistoryUpdates)\n    .where(\n      and(\n        eq(documentHistoryUpdates.appKind, DOCUMENTS_APP_KIND),\n        isNotNull(documentHistoryUpdates.id),\n        lt(documentHistoryUpdates.createdAt, olderThan),\n        hasNoDocument(tx, documentHistoryUpdates.localId),\n      ),\n    )\n    .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n  return { checkpoints, updates };\n}\n\nasync function selectWriteSweepCandidates(\n  tx: ClientSQLiteTransactionScope,\n  olderThan: string,\n): Promise<WriteSweepCandidates> {\n  const pendingUpdates = await tx\n    .select({ id: documentPendingUpdates.id })\n    .from(documentPendingUpdates)\n    .where(\n      and(\n        eq(documentPendingUpdates.appKind, DOCUMENTS_APP_KIND),\n        isNotNull(documentPendingUpdates.id),\n        lt(documentPendingUpdates.createdAt, olderThan),\n        hasNoDocument(tx, documentPendingUpdates.localId),\n      ),\n    )\n    .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n  const syncFailures = await tx\n    .select({ localId: documentSyncFailures.localId })\n    .from(documentSyncFailures)\n    .where(\n      and(\n        eq(documentSyncFailures.appKind, DOCUMENTS_APP_KIND),\n        lt(documentSyncFailures.attemptedAt, olderThan),\n        hasNoDocument(tx, documentSyncFailures.localId),\n      ),\n    )\n    .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n  return { pendingUpdates, syncFailures };\n}\n\nasync function selectAttachmentSweepCandidates(\n  tx: ClientSQLiteTransactionScope,\n  olderThan: string,\n): Promise<AttachmentSweepCandidates> {\n  const pending = await tx\n    .select({\n      localId: documentPendingAttachments.localId,\n      slotId: documentPendingAttachments.slotId,\n      storageKey: documentPendingAttachments.storageKey,\n    })\n    .from(documentPendingAttachments)\n    .where(\n      and(\n        lt(documentPendingAttachments.createdAt, olderThan),\n        hasNoDocument(tx, documentPendingAttachments.localId, null),\n      ),\n    )\n    .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n  const local = await tx\n    .select({\n      localId: documentAttachmentBlobProjection.localId,\n      slotId: documentAttachmentBlobProjection.slotId,\n      storageKey: documentAttachmentBlobProjection.storageKey,\n    })\n    .from(documentAttachmentBlobProjection)\n    .where(\n      and(\n        lt(documentAttachmentBlobProjection.updatedAt, olderThan),\n        hasNoDocument(tx, documentAttachmentBlobProjection.localId, null),\n      ),\n    )\n    .limit(DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n  return { local, pending };\n}\n\nasync function deleteHistorySweepCandidates(\n  tx: ClientSQLiteTransactionScope,\n  candidates: HistorySweepCandidates,\n): Promise<void> {\n  if (candidates.checkpoints.length > 0) {\n    await tx\n      .delete(documentHistoryCheckpoints)\n      .where(\n        and(\n          eq(documentHistoryCheckpoints.appKind, DOCUMENTS_APP_KIND),\n          inArray(\n            documentHistoryCheckpoints.localId,\n            candidates.checkpoints.map((row) => row.localId),\n          ),\n        ),\n      )\n      .run();\n  }\n  if (candidates.updates.length > 0) {\n    await tx\n      .delete(documentHistoryUpdates)\n      .where(\n        inArray(\n          documentHistoryUpdates.id,\n          candidates.updates.flatMap((row) =>\n            row.id === null ? [] : [row.id],\n          ),\n        ),\n      )\n      .run();\n  }\n}\n\nasync function deleteWriteSweepCandidates(\n  tx: ClientSQLiteTransactionScope,\n  candidates: WriteSweepCandidates,\n): Promise<void> {\n  if (candidates.pendingUpdates.length > 0) {\n    await tx\n      .delete(documentPendingUpdates)\n      .where(\n        inArray(\n          documentPendingUpdates.id,\n          candidates.pendingUpdates.flatMap((row) =>\n            row.id === null ? [] : [row.id],\n          ),\n        ),\n      )\n      .run();\n  }\n  if (candidates.syncFailures.length > 0) {\n    await tx\n      .delete(documentSyncFailures)\n      .where(\n        and(\n          eq(documentSyncFailures.appKind, DOCUMENTS_APP_KIND),\n          inArray(\n            documentSyncFailures.localId,\n            candidates.syncFailures.map((row) => row.localId),\n          ),\n        ),\n      )\n      .run();\n  }\n}\n\nasync function deleteAttachmentSweepCandidates(\n  tx: ClientSQLiteTransactionScope,\n  candidates: AttachmentSweepCandidates,\n): Promise<void> {\n  await queueDocumentAttachmentStorageKeys(tx, [\n    ...new Set(\n      [...candidates.pending, ...candidates.local].map((row) => row.storageKey),\n    ),\n  ]);\n  if (candidates.pending.length > 0) {\n    await tx\n      .delete(documentPendingAttachments)\n      .where(pendingAttachmentCandidatesWhere(candidates.pending))\n      .run();\n  }\n  if (candidates.local.length > 0) {\n    await tx\n      .delete(documentAttachmentBlobProjection)\n      .where(localAttachmentCandidatesWhere(candidates.local))\n      .run();\n  }\n}\n\nfunction hasFullSweepBatch(\n  history: HistorySweepCandidates,\n  writes: WriteSweepCandidates,\n  attachments: AttachmentSweepCandidates,\n): boolean {\n  return [\n    history.checkpoints,\n    history.updates,\n    writes.pendingUpdates,\n    writes.syncFailures,\n    attachments.pending,\n    attachments.local,\n  ].some((rows) => rows.length === DOCUMENT_ORPHAN_SWEEP_BATCH_SIZE);\n}\n\n/** Remove one bounded batch of aged side writes without a canonical row. */\nexport async function deleteOrphanedDocumentSideRows(\n  execSql: ExecSql,\n  options: { now?: Date | undefined } = {},\n): Promise<boolean> {\n  const olderThan = new Date(\n    (options.now?.getTime() ?? Date.now()) - DOCUMENT_ORPHAN_SWEEP_MIN_AGE_MS,\n  ).toISOString();\n  return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n    getClientSQLitePersistenceRuntime(lockedExecSql).transaction(async (tx) => {\n      const history = await selectHistorySweepCandidates(tx, olderThan);\n      const writes = await selectWriteSweepCandidates(tx, olderThan);\n      const attachments = await selectAttachmentSweepCandidates(tx, olderThan);\n      await deleteHistorySweepCandidates(tx, history);\n      await deleteWriteSweepCandidates(tx, writes);\n      await deleteAttachmentSweepCandidates(tx, attachments);\n      return hasFullSweepBatch(history, writes, attachments);\n    }),\n  );\n}\n\nexport async function listDocumentOrphanBlobReclaims(\n  execSql: ExecSql,\n  limit: number,\n): Promise<ReadonlyArray<string>> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const rows = await db\n    .select({ storageKey: documentOrphanBlobReclaims.storageKey })\n    .from(documentOrphanBlobReclaims)\n    .orderBy(asc(documentOrphanBlobReclaims.storageKey))\n    .limit(limit);\n  return rows.map((row) => row.storageKey);\n}\n\nexport async function isDocumentBlobStorageKeyReferenced(\n  execSql: ExecSql,\n  storageKey: string,\n): Promise<boolean> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const [pendingRows, localRows] = await Promise.all([\n    db\n      .select({ storageKey: documentPendingAttachments.storageKey })\n      .from(documentPendingAttachments)\n      .where(eq(documentPendingAttachments.storageKey, storageKey))\n      .limit(1),\n    db\n      .select({ storageKey: documentAttachmentBlobProjection.storageKey })\n      .from(documentAttachmentBlobProjection)\n      .where(eq(documentAttachmentBlobProjection.storageKey, storageKey))\n      .limit(1),\n  ]);\n  return pendingRows.length > 0 || localRows.length > 0;\n}\n\nexport async function acknowledgeDocumentOrphanBlobReclaim(\n  execSql: ExecSql,\n  storageKey: string,\n): Promise<void> {\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  await db\n    .delete(documentOrphanBlobReclaims)\n    .where(eq(documentOrphanBlobReclaims.storageKey, storageKey))\n    .run();\n}\n"]}

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

@@ -0,0 +1,43 @@
+import { and, eq, isNull } from "drizzle-orm";
+import { deriveStableDocumentId } from "../../../documents/shared/stableDocumentId.js";
+import { documentProjection, documents } from "../../../sqlite/schema.js";
+import { getClientSQLitePersistenceRuntime } from "../../../sqlite/sqlitePersistenceRuntime.js";
+import { DOCUMENTS_APP_KIND } from "./constants.js";
+import { documentSummaryJoin, documentSummarySelection, mapDocumentSummary, } from "./documentProjectionRows.js";
+/**
+ * Maps the stable remote document id each pending-create row would have sent
+ * to that row's localId. A remote create derives its document id from the
+ * stable localId (deriveStableDocumentId), so when discovery lists a document
+ * whose create this client committed but never saw the response for (e.g. a
+ * reload mid-bootstrap), the orphaned row is recognizable by re-deriving the
+ * id. Without this, discovery would mint a second row under localId=documentId
+ * and the replayed create would adopt the same remote document onto the
+ * original row — two local rows for one remote document.
+ * This lookup prevents duplicates; discovery cannot authorize adoption. The
+ * create retry must verify its signed container and organization scope first.
+ */
+export async function mapPendingCreateLocalIds(execSql) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select({ localId: documents.localId })
+        .from(documents)
+        .where(and(eq(documents.appKind, DOCUMENTS_APP_KIND), isNull(documents.documentId)));
+    const localIdsByStableDocumentId = new Map();
+    for (const row of rows) {
+        localIdsByStableDocumentId.set(await deriveStableDocumentId(row.localId), row.localId);
+    }
+    return localIdsByStableDocumentId;
+}
+export async function loadPendingCreateSummary(execSql, localId) {
+    if (!localId)
+        return null;
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const [row] = await db
+        .select(documentSummarySelection)
+        .from(documentProjection)
+        .innerJoin(documents, documentSummaryJoin)
+        .where(and(eq(documents.localId, localId), isNull(documents.documentId)))
+        .limit(1);
+    return row ? mapDocumentSummary(row) : null;
+}
+//# sourceMappingURL=pendingCreateAdoption.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pendingCreateAdoption.js","sourceRoot":"","sources":["pendingCreateAdoption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAE7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAgB;IAEhB,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,CACD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,kBAAkB,CAAC,EACzC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAC7B,CACF,CAAC;IAEJ,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,0BAA0B,CAAC,GAAG,CAC5B,MAAM,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,EACzC,GAAG,CAAC,OAAO,CACZ,CAAC;IACJ,CAAC;IACD,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAgB,EAChB,OAA2B;IAE3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,EAAE,EAAE,EAAE,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,wBAAwB,CAAC;SAChC,IAAI,CAAC,kBAAkB,CAAC;SACxB,SAAS,CAAC,SAAS,EAAE,mBAAmB,CAAC;SACzC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;SACxE,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,OAAO,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC","sourcesContent":["import { and, eq, isNull } from \"drizzle-orm\";\nimport type { DocumentSummary } from \"../../../documents/documentSummary\";\nimport { deriveStableDocumentId } from \"../../../documents/shared/stableDocumentId\";\nimport { documentProjection, documents } from \"../../../sqlite/schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../../../sqlite/sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../../../sqlite/sqlSchema\";\nimport { DOCUMENTS_APP_KIND } from \"./constants\";\nimport {\n  documentSummaryJoin,\n  documentSummarySelection,\n  mapDocumentSummary,\n} from \"./documentProjectionRows\";\n\n/**\n * Maps the stable remote document id each pending-create row would have sent\n * to that row's localId. A remote create derives its document id from the\n * stable localId (deriveStableDocumentId), so when discovery lists a document\n * whose create this client committed but never saw the response for (e.g. a\n * reload mid-bootstrap), the orphaned row is recognizable by re-deriving the\n * id. Without this, discovery would mint a second row under localId=documentId\n * and the replayed create would adopt the same remote document onto the\n * original row — two local rows for one remote document.\n * This lookup prevents duplicates; discovery cannot authorize adoption. The\n * create retry must verify its signed container and organization scope first.\n */\nexport async function mapPendingCreateLocalIds(\n  execSql: ExecSql,\n): Promise<ReadonlyMap<string, string>> {\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        isNull(documents.documentId),\n      ),\n    );\n\n  const localIdsByStableDocumentId = new Map<string, string>();\n  for (const row of rows) {\n    localIdsByStableDocumentId.set(\n      await deriveStableDocumentId(row.localId),\n      row.localId,\n    );\n  }\n  return localIdsByStableDocumentId;\n}\n\nexport async function loadPendingCreateSummary(\n  execSql: ExecSql,\n  localId: string | undefined,\n): Promise<DocumentSummary | null> {\n  if (!localId) return null;\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const [row] = await db\n    .select(documentSummarySelection)\n    .from(documentProjection)\n    .innerJoin(documents, documentSummaryJoin)\n    .where(and(eq(documents.localId, localId), isNull(documents.documentId)))\n    .limit(1);\n  return row ? mapDocumentSummary(row) : null;\n}\n"]}