@tearleads/client-sdk 0.1.63 → 0.1.65

package/data/sqlite/documentPersistence/documentRecordPersistence.d.ts

@@ -0,0 +1,275 @@
+import type { ExecSql } from "../sqlSchema.js";
+import type { DocumentRecord, DocumentScope, SelectedDocumentRecordRow } from "./documentPersistenceTypes.js";
+/**
+ * The ONE select shape for a full documents-row record: every reader that
+ * feeds mapSelectedDocumentRecord spreads this, so a new record column cannot
+ * silently miss one of them.
+ */
+export declare const documentRecordSelection: {
+    id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "local_id";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    documentId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "document_id";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    recoveryGeneration: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "recovery_generation";
+        tableName: "documents";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    recoveryDocumentId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "recovery_document_id";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    snapshotEndVersion: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "snapshot_end_version";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    accessEpoch: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "access_epoch";
+        tableName: "documents";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    accessStateHash: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "access_state_hash";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    effectiveAccessLevel: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "effective_access_level";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    lastCommitLsn: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "last_commit_lsn";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    documentManifestBundle: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "document_manifest_bundle";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    contentKeyBundle: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "content_key_bundle";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    documentKekTargets: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "document_kek_targets";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    pendingBaseVersion: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "pending_base_version";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+    pullContinuation: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+        name: "pull_continuation";
+        tableName: "documents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        length: number | undefined;
+    }>;
+};
+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>;
+export declare function deleteDocumentRecord(execSql: ExecSql, scope: DocumentScope): Promise<void>;

package/data/sqlite/documentPersistence/documentRecordPersistence.js

@@ -0,0 +1,103 @@
+import { and, desc, eq, sql } from "drizzle-orm";
+import { deserializeDocumentSyncPullContinuation } from "../../documents/shared/sync/pullContinuation.js";
+import { normalizeEffectiveAccessLevel } from "../../keying/accessLevel.js";
+import { documentHistoryUpdates, documents } from "../schema/index.js";
+import { getClientSQLitePersistenceRuntime } from "../sqlitePersistenceRuntime.js";
+/**
+ * The ONE select shape for a full documents-row record: every reader that
+ * feeds mapSelectedDocumentRecord spreads this, so a new record column cannot
+ * silently miss one of them.
+ */
+export const documentRecordSelection = {
+    id: documents.localId,
+    documentId: documents.documentId,
+    recoveryGeneration: documents.recoveryGeneration,
+    recoveryDocumentId: documents.recoveryDocumentId,
+    snapshotEndVersion: documents.snapshotEndVersion,
+    accessEpoch: documents.accessEpoch,
+    accessStateHash: documents.accessStateHash,
+    effectiveAccessLevel: documents.effectiveAccessLevel,
+    lastCommitLsn: documents.lastCommitLsn,
+    documentManifestBundle: documents.documentManifestBundle,
+    contentKeyBundle: documents.contentKeyBundle,
+    documentKekTargets: documents.documentKekTargets,
+    pendingBaseVersion: documents.pendingBaseVersion,
+    pullContinuation: documents.pullContinuation,
+};
+export function mapSelectedDocumentRecord(row) {
+    const record = {
+        id: row.id,
+        documentId: row.documentId,
+        recoveryGeneration: row.recoveryGeneration,
+        snapshotEndVersion: row.snapshotEndVersion,
+        accessEpoch: row.accessEpoch,
+        effectiveAccessLevel: normalizeEffectiveAccessLevel(row.effectiveAccessLevel),
+        lastCommitLsn: row.lastCommitLsn,
+        contentKeyBundle: row.contentKeyBundle,
+        documentKekTargets: row.documentKekTargets,
+        documentManifestBundle: row.documentManifestBundle,
+    };
+    if (row.accessStateHash !== null) {
+        record.accessStateHash = row.accessStateHash;
+    }
+    if (row.recoveryDocumentId !== null) {
+        record.recoveryDocumentId = row.recoveryDocumentId;
+    }
+    // Only surface the marker when one was persisted, so a row that never stored
+    // one keeps its prior shape (and init falls through to seeding it).
+    if (row.pendingBaseVersion !== null) {
+        record.pendingBaseVersion = row.pendingBaseVersion;
+    }
+    const pullContinuation = deserializeDocumentSyncPullContinuation(row.pullContinuation);
+    if (pullContinuation !== null) {
+        record.pullContinuation = pullContinuation;
+    }
+    else if (row.pullContinuation !== null) {
+        record.pullContinuationRecoveryRequired = true;
+    }
+    return record;
+}
+export async function loadDocumentRecord(execSql, scope) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const rows = await db
+        .select(documentRecordSelection)
+        .from(documents)
+        .where(and(eq(documents.appKind, scope.appKind), eq(documents.localId, scope.localId)))
+        .limit(1);
+    return rows[0] ? mapSelectedDocumentRecord(rows[0]) : null;
+}
+export async function findLocalIdByDocumentId(execSql, appKind, documentId) {
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const hasPendingUpdates = sql `EXISTS (
+    SELECT 1
+    FROM ${documentHistoryUpdates}
+    WHERE ${documentHistoryUpdates.appKind} = ${documents.appKind}
+      AND ${documentHistoryUpdates.localId} = ${documents.localId}
+      AND ${documentHistoryUpdates.updateId} IS NOT NULL
+  )`;
+    const hasPendingLocalWork = sql `(
+    ${hasPendingUpdates}
+    OR (
+      ${documents.pendingBaseVersion} IS NOT NULL
+      AND ${documents.pendingBaseVersion} <> ${documents.snapshotEndVersion}
+    )
+  )`;
+    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))
+        .limit(1);
+    return rows[0]?.localId ?? null;
+}
+export async function deleteDocumentRecord(execSql, scope) {
+    await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {
+        await db
+            .delete(documents)
+            .where(and(eq(documents.appKind, scope.appKind), eq(documents.localId, scope.localId)))
+            .run();
+    });
+}
+//# sourceMappingURL=documentRecordPersistence.js.map

package/data/sqlite/documentPersistence/documentRecordPersistence.js.map

@@ -0,0 +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 \"../schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../sqlitePersistenceRuntime\";\nimport type { ExecSql } from \"../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"]}

package/data/sqlite/documentPersistence/documentSyncFailurePersistence.d.ts

@@ -0,0 +1,39 @@
+import { type ClientSQLiteTransactionScope } from "../sqlitePersistenceRuntime.js";
+import { type ExecSql } from "../sqlSchema.js";
+import type { DocumentScope } from "./documentPersistenceTypes.js";
+interface DocumentSyncFailureFields {
+    readonly attemptedAt: string;
+    readonly message: string;
+    readonly status: number | null;
+}
+/** The `documents` column values of a scope with no recorded failure. */
+export declare const CLEARED_DOCUMENT_SYNC_FAILURE: {
+    readonly syncFailureAttemptedAt: null;
+    readonly syncFailureMessage: null;
+    readonly syncFailureStatus: null;
+};
+/**
+ * Record the last terminal failure or incoming-update quarantine on a document
+ * scope's row. The durable pending-update queue has no status columns, so
+ * these columns let the write-queue view explain a blocked document. A newer
+ * failure replaces the old. A scope with no `documents` row has nothing left
+ * to explain, so the update is a no-op there.
+ */
+export declare function recordDocumentSyncFailure(execSql: ExecSql, scope: DocumentScope, failure: DocumentSyncFailureFields): Promise<void>;
+/**
+ * Whether any queued local write has recorded a terminal failure — a document
+ * row carrying a sync failure or an intent row carrying `last_error`. This is
+ * the evidence gate for recovery triggers (e.g. re-arming write lanes when org
+ * access is restored): without it a transient denial during bootstrap would
+ * fire recovery work with nothing to recover, racing the startup sync passes.
+ */
+export declare function hasRecordedTerminalSyncFailures(execSql: ExecSql): Promise<boolean>;
+/** Clear a scope's recorded failure inside a caller's transaction. */
+export declare function clearDocumentSyncFailureInTransaction(tx: ClientSQLiteTransactionScope, scope: DocumentScope): Promise<void>;
+/**
+ * Drop the recorded failure for a scope. Called when a later sync pass for the
+ * scope succeeds and whenever the scope's local sync state is torn down, so a
+ * stale failure never outlives the condition it describes.
+ */
+export declare function clearDocumentSyncFailure(execSql: ExecSql, scope: DocumentScope): Promise<void>;
+export {};

package/data/sqlite/documentPersistence/documentSyncFailurePersistence.js

@@ -0,0 +1,81 @@
+import { and, eq, isNotNull } from "drizzle-orm";
+import { documents, documentTables, localIntents, localIntentTables, } from "../schema/index.js";
+import { getClientSQLitePersistenceRuntime, } from "../sqlitePersistenceRuntime.js";
+import { ensureSqlTables } from "../sqlSchema.js";
+/** The `documents` column values of a scope with no recorded failure. */
+export const CLEARED_DOCUMENT_SYNC_FAILURE = {
+    syncFailureAttemptedAt: null,
+    syncFailureMessage: null,
+    syncFailureStatus: null,
+};
+function scopeWhere(scope) {
+    return and(eq(documents.appKind, scope.appKind), eq(documents.localId, scope.localId));
+}
+/**
+ * Record the last terminal failure or incoming-update quarantine on a document
+ * scope's row. The durable pending-update queue has no status columns, so
+ * these columns let the write-queue view explain a blocked document. A newer
+ * failure replaces the old. A scope with no `documents` row has nothing left
+ * to explain, so the update is a no-op there.
+ */
+export async function recordDocumentSyncFailure(execSql, scope, failure) {
+    await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {
+        await db
+            .update(documents)
+            .set({
+            syncFailureAttemptedAt: failure.attemptedAt,
+            syncFailureMessage: failure.message,
+            syncFailureStatus: failure.status,
+        })
+            .where(scopeWhere(scope))
+            .run();
+    });
+}
+/**
+ * Whether any queued local write has recorded a terminal failure — a document
+ * row carrying a sync failure or an intent row carrying `last_error`. This is
+ * the evidence gate for recovery triggers (e.g. re-arming write lanes when org
+ * access is restored): without it a transient denial during bootstrap would
+ * fire recovery work with nothing to recover, racing the startup sync passes.
+ */
+export async function hasRecordedTerminalSyncFailures(execSql) {
+    await ensureSqlTables(execSql, [...documentTables, ...localIntentTables]);
+    const { db } = getClientSQLitePersistenceRuntime(execSql);
+    const [failure] = await db
+        .select({ localId: documents.localId })
+        .from(documents)
+        .where(isNotNull(documents.syncFailureMessage))
+        .limit(1);
+    if (failure) {
+        return true;
+    }
+    const [intent] = await db
+        .select({ id: localIntents.id })
+        .from(localIntents)
+        .where(isNotNull(localIntents.lastError))
+        .limit(1);
+    return intent !== undefined;
+}
+/** Clear a scope's recorded failure inside a caller's transaction. */
+export async function clearDocumentSyncFailureInTransaction(tx, scope) {
+    await tx
+        .update(documents)
+        .set(CLEARED_DOCUMENT_SYNC_FAILURE)
+        .where(scopeWhere(scope))
+        .run();
+}
+/**
+ * Drop the recorded failure for a scope. Called when a later sync pass for the
+ * scope succeeds and whenever the scope's local sync state is torn down, so a
+ * stale failure never outlives the condition it describes.
+ */
+export async function clearDocumentSyncFailure(execSql, scope) {
+    await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {
+        await db
+            .update(documents)
+            .set(CLEARED_DOCUMENT_SYNC_FAILURE)
+            .where(scopeWhere(scope))
+            .run();
+    });
+}
+//# sourceMappingURL=documentSyncFailurePersistence.js.map

package/data/sqlite/documentPersistence/documentSyncFailurePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentSyncFailurePersistence.js","sourceRoot":"","sources":["documentSyncFailurePersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { and, eq, isNotNull } from \"drizzle-orm\";\nimport {\n  documents,\n  documentTables,\n  localIntents,\n  localIntentTables,\n} from \"../schema\";\nimport {\n  type ClientSQLiteTransactionScope,\n  getClientSQLitePersistenceRuntime,\n} from \"../sqlitePersistenceRuntime\";\nimport { type ExecSql, ensureSqlTables } from \"../sqlSchema\";\nimport type { DocumentScope } from \"./documentPersistenceTypes\";\n\ninterface DocumentSyncFailureFields {\n  readonly attemptedAt: string;\n  readonly message: string;\n  readonly status: number | null;\n}\n\n/** The `documents` column values of a scope with no recorded failure. */\nexport const CLEARED_DOCUMENT_SYNC_FAILURE = {\n  syncFailureAttemptedAt: null,\n  syncFailureMessage: null,\n  syncFailureStatus: null,\n} as const;\n\nfunction scopeWhere(scope: DocumentScope) {\n  return and(\n    eq(documents.appKind, scope.appKind),\n    eq(documents.localId, scope.localId),\n  );\n}\n\n/**\n * Record the last terminal failure or incoming-update quarantine on a document\n * scope's row. The durable pending-update queue has no status columns, so\n * these columns let the write-queue view explain a blocked document. A newer\n * failure replaces the old. A scope with no `documents` row has nothing left\n * to explain, so the update is a no-op there.\n */\nexport async function recordDocumentSyncFailure(\n  execSql: ExecSql,\n  scope: DocumentScope,\n  failure: DocumentSyncFailureFields,\n): Promise<void> {\n  await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {\n    await db\n      .update(documents)\n      .set({\n        syncFailureAttemptedAt: failure.attemptedAt,\n        syncFailureMessage: failure.message,\n        syncFailureStatus: failure.status,\n      })\n      .where(scopeWhere(scope))\n      .run();\n  });\n}\n\n/**\n * Whether any queued local write has recorded a terminal failure — a document\n * row carrying a sync failure or an intent row carrying `last_error`. This is\n * the evidence gate for recovery triggers (e.g. re-arming write lanes when org\n * access is restored): without it a transient denial during bootstrap would\n * fire recovery work with nothing to recover, racing the startup sync passes.\n */\nexport async function hasRecordedTerminalSyncFailures(\n  execSql: ExecSql,\n): Promise<boolean> {\n  await ensureSqlTables(execSql, [...documentTables, ...localIntentTables]);\n  const { db } = getClientSQLitePersistenceRuntime(execSql);\n  const [failure] = await db\n    .select({ localId: documents.localId })\n    .from(documents)\n    .where(isNotNull(documents.syncFailureMessage))\n    .limit(1);\n  if (failure) {\n    return true;\n  }\n  const [intent] = await db\n    .select({ id: localIntents.id })\n    .from(localIntents)\n    .where(isNotNull(localIntents.lastError))\n    .limit(1);\n  return intent !== undefined;\n}\n\n/** Clear a scope's recorded failure inside a caller's transaction. */\nexport async function clearDocumentSyncFailureInTransaction(\n  tx: ClientSQLiteTransactionScope,\n  scope: DocumentScope,\n): Promise<void> {\n  await tx\n    .update(documents)\n    .set(CLEARED_DOCUMENT_SYNC_FAILURE)\n    .where(scopeWhere(scope))\n    .run();\n}\n\n/**\n * Drop the recorded failure for a scope. Called when a later sync pass for the\n * scope succeeds and whenever the scope's local sync state is torn down, so a\n * stale failure never outlives the condition it describes.\n */\nexport async function clearDocumentSyncFailure(\n  execSql: ExecSql,\n  scope: DocumentScope,\n): Promise<void> {\n  await getClientSQLitePersistenceRuntime(execSql).runMutation(async (db) => {\n    await db\n      .update(documents)\n      .set(CLEARED_DOCUMENT_SYNC_FAILURE)\n      .where(scopeWhere(scope))\n      .run();\n  });\n}\n"]}

package/data/sqlite/documentPersistence/index.d.ts

@@ -0,0 +1,22 @@
+import { type DocumentSyncPullContinuation } from "../../documents/shared/sync/pullContinuation.js";
+import { type ExecSql } from "../sqlSchema.js";
+import type { DocumentRecord } from "./documentPersistenceTypes.js";
+export declare function ensureDocumentTables(execSql: ExecSql): Promise<void>;
+export declare function ensureDocumentProjectionTables(execSql: ExecSql): Promise<void>;
+/** Replace only the exact rejected continuation with a durable recovery marker. */
+export declare function invalidateDocumentSyncPullContinuation(execSql: ExecSql, input: {
+    accessEpoch: number;
+    accessStateHash: string | null;
+    appKind: string;
+    continuation: DocumentSyncPullContinuation;
+    contentKeyBundle: string | null;
+    documentId: string;
+    documentKekTargets: string | null;
+    documentManifestBundle: string | null;
+    lastCommitLsn: string | null;
+    localId: string;
+}): 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 { clearDocumentSyncFailure, hasRecordedTerminalSyncFailures, recordDocumentSyncFailure, } from "./documentSyncFailurePersistence.js";

package/data/sqlite/documentPersistence/index.js

@@ -0,0 +1,35 @@
+import { and, eq, sql } from "drizzle-orm";
+import { DOCUMENT_SYNC_PULL_RECOVERY_REQUIRED, serializeDocumentSyncPullContinuation, } from "../../documents/shared/sync/pullContinuation.js";
+import { documentProjectionTables, documents, documentTables } from "../schema/index.js";
+import { getClientSQLitePersistenceRuntime } from "../sqlitePersistenceRuntime.js";
+import { ensureSqlTables, runSerializedSqlMutation, } from "../sqlSchema.js";
+import { loadDocumentRecord } from "./documentRecordPersistence.js";
+export function ensureDocumentTables(execSql) {
+    return ensureSqlTables(execSql, documentTables);
+}
+export function ensureDocumentProjectionTables(execSql) {
+    return ensureSqlTables(execSql, documentProjectionTables);
+}
+/** Replace only the exact rejected continuation with a durable recovery marker. */
+export async function invalidateDocumentSyncPullContinuation(execSql, input) {
+    await ensureDocumentTables(execSql);
+    const expectedContinuation = serializeDocumentSyncPullContinuation(input.continuation);
+    if (expectedContinuation === null)
+        return null;
+    return runSerializedSqlMutation(execSql, async (lockedExecSql) => {
+        const { db } = getClientSQLitePersistenceRuntime(lockedExecSql);
+        await db
+            .update(documents)
+            .set({ pullContinuation: DOCUMENT_SYNC_PULL_RECOVERY_REQUIRED })
+            .where(and(eq(documents.appKind, input.appKind), eq(documents.localId, input.localId), eq(documents.documentId, input.documentId), eq(documents.accessEpoch, input.accessEpoch), sql `${documents.accessStateHash} IS ${input.accessStateHash}`, sql `${documents.contentKeyBundle} IS ${input.contentKeyBundle}`, sql `${documents.documentKekTargets} IS ${input.documentKekTargets}`, sql `${documents.documentManifestBundle} IS ${input.documentManifestBundle}`, sql `${documents.lastCommitLsn} IS ${input.lastCommitLsn}`, eq(documents.pullContinuation, expectedContinuation)))
+            .run();
+        return loadDocumentRecord(lockedExecSql, {
+            appKind: input.appKind,
+            localId: input.localId,
+        });
+    });
+}
+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 { clearDocumentSyncFailure, hasRecordedTerminalSyncFailures, recordDocumentSyncFailure, } from "./documentSyncFailurePersistence.js";
+//# sourceMappingURL=index.js.map

package/data/sqlite/documentPersistence/index.js.map

@@ -0,0 +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 { documentProjectionTables, documents, documentTables } from \"../schema\";\nimport { getClientSQLitePersistenceRuntime } from \"../sqlitePersistenceRuntime\";\nimport {\n  type ExecSql,\n  ensureSqlTables,\n  runSerializedSqlMutation,\n} from \"../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"]}