@tearleads/client-sdk 0.1.116 → 0.1.118

package/data/sqlite/schema/verifiedManifestBundleSchema.js

@@ -8,10 +8,15 @@ import { defineSqlTableSchema } from "../sqlTableSchema.js";
  * verifies the rebuilt projection from scratch. Rows are neither trust nor
  * checkpoint state: a missing, evicted, or damaged row only costs bytes.
  *
+ * Container KEK levels share the table as typed rows (`objectKind`
+ * `container-kek-level`), keyed by the SHA-256 of their canonical wire bytes.
+ *
  * Columns:
- * - `manifestHash`: Manifest hash; equals the stored bundle's `manifestHash`.
+ * - `manifestHash`: Citation key: the stored bundle's `manifestHash`, or a
+ *   level row's digest.
  * - `organizationId`, `objectKind`, `objectId`, `epoch`: The verified
- *   manifest's object, used to cite the lineage relevant to a request.
+ *   manifest's object (or the level's container and key epoch), used to cite
+ *   the lineage relevant to a request.
  * - `bundleJson`: The exact verified bundle as JSON.
  * - `bundleDigest`: SHA-256 hex of `bundleJson`; a mismatch drops the row.
  * - `verifiedAt`: Latest local verification time; oldest rows evict first.
@@ -27,8 +32,10 @@ export const verifiedAccessManifestBundles = sqliteTable("verified_access_manife
     verifiedAt: text("verified_at").notNull(),
 }, (table) => [
     index("verified_access_manifest_bundles_object_idx").on(table.objectKind, table.objectId, desc(table.epoch)),
-    index("verified_access_manifest_bundles_verified_at_idx").on(table.verifiedAt),
-    index("verified_access_manifest_bundles_organization_idx").on(table.organizationId),
+    // Eviction order: oldest verification first, hash as the tiebreak.
+    index("verified_access_manifest_bundles_eviction_idx").on(table.verifiedAt, table.manifestHash),
+    // Recent citations: an organization's newest verifications first.
+    index("verified_access_manifest_bundles_organization_recent_idx").on(table.organizationId, desc(table.verifiedAt), table.manifestHash),
 ]);
 export const verifiedManifestBundleTables = [
     defineSqlTableSchema(verifiedAccessManifestBundles),

package/data/sqlite/schema/verifiedManifestBundleSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"verifiedManifestBundleSchema.js","sourceRoot":"","sources":["verifiedManifestBundleSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CACtD,kCAAkC,EAClC;IACE,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,UAAU,EAAE;IAChD,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE;IACjD,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IACjC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;CAC1C,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,6CAA6C,CAAC,CAAC,EAAE,CACrD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,QAAQ,EACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAClB;IACD,KAAK,CAAC,kDAAkD,CAAC,CAAC,EAAE,CAC1D,KAAK,CAAC,UAAU,CACjB;IACD,KAAK,CAAC,mDAAmD,CAAC,CAAC,EAAE,CAC3D,KAAK,CAAC,cAAc,CACrB;CACF,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAkC;IACzE,oBAAoB,CAAC,6BAA6B,CAAC;CACpD,CAAC","sourcesContent":["import { desc } from \"drizzle-orm\";\nimport { index, integer, sqliteTable, text } from \"drizzle-orm/sqlite-core\";\nimport { defineSqlTableSchema, type SqlTableSchema } from \"../sqlTableSchema\";\n\n/**\n * Access-manifest bundles this device verified inside a writer projection,\n * keyed by manifest hash. A later projection read cites them so the API can\n * omit their bytes; the client refills each omission from this row and\n * verifies the rebuilt projection from scratch. Rows are neither trust nor\n * checkpoint state: a missing, evicted, or damaged row only costs bytes.\n *\n * Columns:\n * - `manifestHash`: Manifest hash; equals the stored bundle's `manifestHash`.\n * - `organizationId`, `objectKind`, `objectId`, `epoch`: The verified\n *   manifest's object, used to cite the lineage relevant to a request.\n * - `bundleJson`: The exact verified bundle as JSON.\n * - `bundleDigest`: SHA-256 hex of `bundleJson`; a mismatch drops the row.\n * - `verifiedAt`: Latest local verification time; oldest rows evict first.\n */\nexport const verifiedAccessManifestBundles = sqliteTable(\n  \"verified_access_manifest_bundles\",\n  {\n    manifestHash: text(\"manifest_hash\").primaryKey(),\n    organizationId: text(\"organization_id\").notNull(),\n    objectKind: text(\"object_kind\").notNull(),\n    objectId: text(\"object_id\").notNull(),\n    epoch: integer(\"epoch\").notNull(),\n    bundleJson: text(\"bundle_json\").notNull(),\n    bundleDigest: text(\"bundle_digest\").notNull(),\n    verifiedAt: text(\"verified_at\").notNull(),\n  },\n  (table) => [\n    index(\"verified_access_manifest_bundles_object_idx\").on(\n      table.objectKind,\n      table.objectId,\n      desc(table.epoch),\n    ),\n    index(\"verified_access_manifest_bundles_verified_at_idx\").on(\n      table.verifiedAt,\n    ),\n    index(\"verified_access_manifest_bundles_organization_idx\").on(\n      table.organizationId,\n    ),\n  ],\n);\n\nexport const verifiedManifestBundleTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(verifiedAccessManifestBundles),\n];\n"]}
+{"version":3,"file":"verifiedManifestBundleSchema.js","sourceRoot":"","sources":["verifiedManifestBundleSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CACtD,kCAAkC,EAClC;IACE,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,UAAU,EAAE;IAChD,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE;IACjD,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IACjC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;CAC1C,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,6CAA6C,CAAC,CAAC,EAAE,CACrD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,QAAQ,EACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAClB;IACD,mEAAmE;IACnE,KAAK,CAAC,+CAA+C,CAAC,CAAC,EAAE,CACvD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,YAAY,CACnB;IACD,kEAAkE;IAClE,KAAK,CAAC,0DAA0D,CAAC,CAAC,EAAE,CAClE,KAAK,CAAC,cAAc,EACpB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EACtB,KAAK,CAAC,YAAY,CACnB;CACF,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAkC;IACzE,oBAAoB,CAAC,6BAA6B,CAAC;CACpD,CAAC","sourcesContent":["import { desc } from \"drizzle-orm\";\nimport { index, integer, sqliteTable, text } from \"drizzle-orm/sqlite-core\";\nimport { defineSqlTableSchema, type SqlTableSchema } from \"../sqlTableSchema\";\n\n/**\n * Access-manifest bundles this device verified inside a writer projection,\n * keyed by manifest hash. A later projection read cites them so the API can\n * omit their bytes; the client refills each omission from this row and\n * verifies the rebuilt projection from scratch. Rows are neither trust nor\n * checkpoint state: a missing, evicted, or damaged row only costs bytes.\n *\n * Container KEK levels share the table as typed rows (`objectKind`\n * `container-kek-level`), keyed by the SHA-256 of their canonical wire bytes.\n *\n * Columns:\n * - `manifestHash`: Citation key: the stored bundle's `manifestHash`, or a\n *   level row's digest.\n * - `organizationId`, `objectKind`, `objectId`, `epoch`: The verified\n *   manifest's object (or the level's container and key epoch), used to cite\n *   the lineage relevant to a request.\n * - `bundleJson`: The exact verified bundle as JSON.\n * - `bundleDigest`: SHA-256 hex of `bundleJson`; a mismatch drops the row.\n * - `verifiedAt`: Latest local verification time; oldest rows evict first.\n */\nexport const verifiedAccessManifestBundles = sqliteTable(\n  \"verified_access_manifest_bundles\",\n  {\n    manifestHash: text(\"manifest_hash\").primaryKey(),\n    organizationId: text(\"organization_id\").notNull(),\n    objectKind: text(\"object_kind\").notNull(),\n    objectId: text(\"object_id\").notNull(),\n    epoch: integer(\"epoch\").notNull(),\n    bundleJson: text(\"bundle_json\").notNull(),\n    bundleDigest: text(\"bundle_digest\").notNull(),\n    verifiedAt: text(\"verified_at\").notNull(),\n  },\n  (table) => [\n    index(\"verified_access_manifest_bundles_object_idx\").on(\n      table.objectKind,\n      table.objectId,\n      desc(table.epoch),\n    ),\n    // Eviction order: oldest verification first, hash as the tiebreak.\n    index(\"verified_access_manifest_bundles_eviction_idx\").on(\n      table.verifiedAt,\n      table.manifestHash,\n    ),\n    // Recent citations: an organization's newest verifications first.\n    index(\"verified_access_manifest_bundles_organization_recent_idx\").on(\n      table.organizationId,\n      desc(table.verifiedAt),\n      table.manifestHash,\n    ),\n  ],\n);\n\nexport const verifiedManifestBundleTables: ReadonlyArray<SqlTableSchema> = [\n  defineSqlTableSchema(verifiedAccessManifestBundles),\n];\n"]}

package/data/sqlite/sqlExec.d.ts

@@ -27,6 +27,18 @@ export declare const unavailableExecSql: ExecSql;
 export declare function resolveCanonicalExecSql(execSql: ExecSql): ExecSql;
 export declare function hasCompletedConnectionOnce(execSql: ExecSql, key: string): boolean;
 export declare function markCompletedConnectionOnce(execSql: ExecSql, key: string): void;
+/**
+ * Start recording the once-per-connection keys completed inside a transaction
+ * scope (a transaction or one of its savepoints). Every open must be paired
+ * with exactly one `closeTransactionSchemaMemoScope`.
+ */
+export declare function openTransactionSchemaMemoScope(execSql: ExecSql): void;
+/**
+ * Close the innermost transaction scope. A rollback forgets only the keys
+ * completed inside it, so the next query re-ensures exactly the schema the
+ * rollback undid; a commit keeps them, handing them to the enclosing scope.
+ */
+export declare function closeTransactionSchemaMemoScope(execSql: ExecSql, committed: boolean): void;
 export declare function runOncePerConnection(execSql: ExecSql, key: string, run: () => Promise<void>): Promise<void>;
 /**
  * Forget every completed once-per-connection key for this connection. Required

package/data/sqlite/sqlExec.js

@@ -24,6 +24,11 @@ export function resolveCanonicalExecSql(execSql) {
 // awaiting a promise that can only settle after the lock the other context is
 // already holding.
 const completedConnectionOnceKeys = new WeakMap();
+// Keys first completed inside each open transaction scope on a connection,
+// innermost scope last. A rolled-back scope undid that schema work, so it
+// forgets exactly its own keys; a committed savepoint hands its keys to the
+// enclosing scope, whose rollback would undo them too.
+const transactionSchemaMemoScopes = new WeakMap();
 export function hasCompletedConnectionOnce(execSql, key) {
     return (completedConnectionOnceKeys
         .get(resolveCanonicalExecSql(execSql))
@@ -32,12 +37,51 @@ export function hasCompletedConnectionOnce(execSql, key) {
 export function markCompletedConnectionOnce(execSql, key) {
     const canonical = resolveCanonicalExecSql(execSql);
     const keys = completedConnectionOnceKeys.get(canonical) ?? new Set();
+    if (keys.has(key))
+        return;
     keys.add(key);
     completedConnectionOnceKeys.set(canonical, keys);
+    transactionSchemaMemoScopes.get(canonical)?.at(-1)?.add(key);
+}
+/**
+ * Start recording the once-per-connection keys completed inside a transaction
+ * scope (a transaction or one of its savepoints). Every open must be paired
+ * with exactly one `closeTransactionSchemaMemoScope`.
+ */
+export function openTransactionSchemaMemoScope(execSql) {
+    const canonical = resolveCanonicalExecSql(execSql);
+    const scopes = transactionSchemaMemoScopes.get(canonical) ?? [];
+    scopes.push(new Set());
+    transactionSchemaMemoScopes.set(canonical, scopes);
+}
+/**
+ * Close the innermost transaction scope. A rollback forgets only the keys
+ * completed inside it, so the next query re-ensures exactly the schema the
+ * rollback undid; a commit keeps them, handing them to the enclosing scope.
+ */
+export function closeTransactionSchemaMemoScope(execSql, committed) {
+    const canonical = resolveCanonicalExecSql(execSql);
+    const scopes = transactionSchemaMemoScopes.get(canonical);
+    const scopeKeys = scopes?.pop();
+    if (!scopes || !scopeKeys) {
+        throw new Error("No open transaction schema memo scope to close");
+    }
+    if (scopes.length === 0)
+        transactionSchemaMemoScopes.delete(canonical);
+    if (committed) {
+        const parent = scopes.at(-1);
+        for (const key of scopeKeys)
+            parent?.add(key);
+        return;
+    }
+    const completed = completedConnectionOnceKeys.get(canonical);
+    for (const key of scopeKeys)
+        completed?.delete(key);
 }
-// Callers must not invoke this inside an explicit SQL transaction that can
-// roll back: completion is recorded as soon as `run` resolves, so a later
-// ROLLBACK would leave the memo asserting schema that no longer exists.
+// Completion is recorded as soon as `run` resolves. Inside a runtime
+// transaction the key joins the open schema memo scope, so a later ROLLBACK
+// forgets it; an explicit transaction outside the runtime must instead call
+// `resetConnectionSchemaMemo` after rolling back.
 export async function runOncePerConnection(execSql, key, run) {
     if (hasCompletedConnectionOnce(execSql, key)) {
         return;

package/data/sqlite/sqlExec.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlExec.js","sourceRoot":"","sources":["sqlExec.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  readUserTimingClock,\n  recordUserTimingEntry,\n} from \"../shared/userTiming\";\n\nexport type SqlRowValue = string | number | null;\nexport type SqlRow = Record<string, SqlRowValue>;\nexport type SqlArrayRow = SqlRowValue[];\nexport type SqlBind = Record<string, SqlRowValue> | ReadonlyArray<SqlRowValue>;\nexport type SqlRowMode = \"object\" | \"array\";\n\nexport interface ExecSql {\n  (\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: \"object\" },\n  ): Promise<SqlRow[]>;\n  (\n    sql: string,\n    bind: SqlBind | undefined,\n    options: { rowMode: \"array\" },\n  ): Promise<SqlArrayRow[]>;\n  (\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ): Promise<Array<SqlRow | SqlArrayRow>>;\n}\n\nexport interface ExecSqlClientLike {\n  exec(options: {\n    sql: string;\n    bind?: SqlBind;\n    rowMode?: SqlRowMode;\n  }): Promise<{ rows: Array<SqlRow | SqlArrayRow> }>;\n}\n\nexport const unavailableExecSql: ExecSql = async () => {\n  throw new Error(\"Database client is unavailable.\");\n};\n\n// Tracks the active serialized mutation chain for each canonical SQL executor\n// so callers sharing one connection cannot interleave transactional statements.\nconst sqlMutationQueue = new WeakMap<ExecSql, Promise<void>>();\n\n// Marks executors that already run inside the shared mutation lock so nested\n// callers can reuse the current lock instead of queueing a second time.\nconst serializedSqlExecs = new WeakSet<ExecSql>();\n\n// Reuses one ExecSql adapter per client so all wrappers around the same\n// connection share the same serialized mutation queue.\nconst clientExecSqls = new WeakMap<ExecSqlClientLike, ExecSql>();\n\n// Maps each locked executor back to the canonical executor whose lock it runs\n// under, so per-connection caches key on one stable identity no matter which\n// wrapper a caller holds.\nconst serializedSqlExecCanonicals = new WeakMap<ExecSql, ExecSql>();\n\nexport function resolveCanonicalExecSql(execSql: ExecSql): ExecSql {\n  return serializedSqlExecCanonicals.get(execSql) ?? execSql;\n}\n\n// Completed once-per-connection keys (schema ensures).\n// Only COMPLETED runs are recorded — never in-flight promises — so two lock\n// contexts racing the same key both run the (idempotent) work instead of one\n// awaiting a promise that can only settle after the lock the other context is\n// already holding.\nconst completedConnectionOnceKeys = new WeakMap<ExecSql, Set<string>>();\n\nexport function hasCompletedConnectionOnce(\n  execSql: ExecSql,\n  key: string,\n): boolean {\n  return (\n    completedConnectionOnceKeys\n      .get(resolveCanonicalExecSql(execSql))\n      ?.has(key) ?? false\n  );\n}\n\nexport function markCompletedConnectionOnce(\n  execSql: ExecSql,\n  key: string,\n): void {\n  const canonical = resolveCanonicalExecSql(execSql);\n  const keys = completedConnectionOnceKeys.get(canonical) ?? new Set<string>();\n  keys.add(key);\n  completedConnectionOnceKeys.set(canonical, keys);\n}\n\n// Callers must not invoke this inside an explicit SQL transaction that can\n// roll back: completion is recorded as soon as `run` resolves, so a later\n// ROLLBACK would leave the memo asserting schema that no longer exists.\nexport async function runOncePerConnection(\n  execSql: ExecSql,\n  key: string,\n  run: () => Promise<void>,\n): Promise<void> {\n  if (hasCompletedConnectionOnce(execSql, key)) {\n    return;\n  }\n  await run();\n  markCompletedConnectionOnce(execSql, key);\n}\n\n/**\n * Forget every completed once-per-connection key for this connection. Required\n * after an operation that rebuilds the schema out from under the runtime (the\n * local backup restore drops and recreates all user tables) so the next query\n * re-runs its schema ensures.\n */\nexport function resetConnectionSchemaMemo(execSql: ExecSql): void {\n  completedConnectionOnceKeys.delete(resolveCanonicalExecSql(execSql));\n}\n\nfunction defineExecSql(\n  run: (\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ) => Promise<Array<SqlRow | SqlArrayRow>>,\n): ExecSql {\n  function execSql(\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: \"object\" },\n  ): Promise<SqlRow[]>;\n  function execSql(\n    sql: string,\n    bind: SqlBind | undefined,\n    options: { rowMode: \"array\" },\n  ): Promise<SqlArrayRow[]>;\n  function execSql(\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ): Promise<Array<SqlRow | SqlArrayRow>>;\n  async function execSql(\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ): Promise<Array<SqlRow | SqlArrayRow>> {\n    return run(sql, bind, options);\n  }\n\n  return execSql;\n}\n\nexport function createExecSql(client: ExecSqlClientLike): ExecSql {\n  const existingExecSql = clientExecSqls.get(client);\n  if (existingExecSql) {\n    return existingExecSql;\n  }\n\n  const execSql = defineExecSql(async (sql, bind, options) => {\n    const result = await client.exec({\n      sql,\n      ...(bind !== undefined ? { bind } : {}),\n      ...(options?.rowMode ? { rowMode: options.rowMode } : {}),\n    });\n    return result.rows;\n  });\n\n  clientExecSqls.set(client, execSql);\n  return execSql;\n}\n\nfunction isSerializedSqlExec(execSql: ExecSql): boolean {\n  return serializedSqlExecs.has(execSql);\n}\n\nfunction createSerializedSqlExec(execSql: ExecSql): ExecSql {\n  if (isSerializedSqlExec(execSql)) {\n    return execSql;\n  }\n\n  const serializedExecSql = defineExecSql(execSql);\n  serializedSqlExecs.add(serializedExecSql);\n  serializedSqlExecCanonicals.set(\n    serializedExecSql,\n    resolveCanonicalExecSql(execSql),\n  );\n  return serializedExecSql;\n}\n\n// SQLite transactions are scoped to the shared connection, so we must hold a\n// connection-level lock across multi-statement mutations to prevent interleaving.\n// Nested callers must keep passing the provided locked executor. Re-entering\n// with the original canonical executor will wait on the current mutation and\n// deadlock.\n// Each outermost mutation is drawn on DevTools tracks: time spent queued\n// behind another mutation, then time holding the lock.\nexport async function runSerializedSqlMutation<T>(\n  execSql: ExecSql,\n  operation: (execSql: ExecSql) => Promise<T> | T,\n): Promise<T> {\n  if (isSerializedSqlExec(execSql)) {\n    return operation(execSql);\n  }\n\n  const queuedAtMs = readUserTimingClock();\n  const previous = sqlMutationQueue.get(execSql);\n  let releaseCurrent = () => {};\n  const current = new Promise<void>((resolve) => {\n    releaseCurrent = resolve;\n  });\n  const waitForPrevious = (previous ?? Promise.resolve()).catch(\n    () => undefined,\n  );\n  const queuedCurrent = waitForPrevious.then(() => current);\n\n  sqlMutationQueue.set(execSql, queuedCurrent);\n  await waitForPrevious;\n  const acquiredAtMs = readUserTimingClock();\n  if (previous) {\n    recordUserTimingEntry({\n      endMs: acquiredAtMs,\n      name: \"SQLite mutation wait\",\n      startMs: queuedAtMs,\n      track: \"SQLite mutation queue\",\n    });\n  }\n\n  let failed = true;\n  try {\n    const result = await operation(createSerializedSqlExec(execSql));\n    failed = false;\n    return result;\n  } finally {\n    const releasedAtMs = readUserTimingClock();\n    releaseCurrent();\n    if (sqlMutationQueue.get(execSql) === queuedCurrent) {\n      sqlMutationQueue.delete(execSql);\n    }\n    recordUserTimingEntry({\n      endMs: releasedAtMs,\n      failed,\n      name: \"SQLite mutation\",\n      startMs: acquiredAtMs,\n      track: \"SQLite mutations\",\n    });\n  }\n}\n"]}
+{"version":3,"file":"sqlExec.js","sourceRoot":"","sources":["sqlExec.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  readUserTimingClock,\n  recordUserTimingEntry,\n} from \"../shared/userTiming\";\n\nexport type SqlRowValue = string | number | null;\nexport type SqlRow = Record<string, SqlRowValue>;\nexport type SqlArrayRow = SqlRowValue[];\nexport type SqlBind = Record<string, SqlRowValue> | ReadonlyArray<SqlRowValue>;\nexport type SqlRowMode = \"object\" | \"array\";\n\nexport interface ExecSql {\n  (\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: \"object\" },\n  ): Promise<SqlRow[]>;\n  (\n    sql: string,\n    bind: SqlBind | undefined,\n    options: { rowMode: \"array\" },\n  ): Promise<SqlArrayRow[]>;\n  (\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ): Promise<Array<SqlRow | SqlArrayRow>>;\n}\n\nexport interface ExecSqlClientLike {\n  exec(options: {\n    sql: string;\n    bind?: SqlBind;\n    rowMode?: SqlRowMode;\n  }): Promise<{ rows: Array<SqlRow | SqlArrayRow> }>;\n}\n\nexport const unavailableExecSql: ExecSql = async () => {\n  throw new Error(\"Database client is unavailable.\");\n};\n\n// Tracks the active serialized mutation chain for each canonical SQL executor\n// so callers sharing one connection cannot interleave transactional statements.\nconst sqlMutationQueue = new WeakMap<ExecSql, Promise<void>>();\n\n// Marks executors that already run inside the shared mutation lock so nested\n// callers can reuse the current lock instead of queueing a second time.\nconst serializedSqlExecs = new WeakSet<ExecSql>();\n\n// Reuses one ExecSql adapter per client so all wrappers around the same\n// connection share the same serialized mutation queue.\nconst clientExecSqls = new WeakMap<ExecSqlClientLike, ExecSql>();\n\n// Maps each locked executor back to the canonical executor whose lock it runs\n// under, so per-connection caches key on one stable identity no matter which\n// wrapper a caller holds.\nconst serializedSqlExecCanonicals = new WeakMap<ExecSql, ExecSql>();\n\nexport function resolveCanonicalExecSql(execSql: ExecSql): ExecSql {\n  return serializedSqlExecCanonicals.get(execSql) ?? execSql;\n}\n\n// Completed once-per-connection keys (schema ensures).\n// Only COMPLETED runs are recorded — never in-flight promises — so two lock\n// contexts racing the same key both run the (idempotent) work instead of one\n// awaiting a promise that can only settle after the lock the other context is\n// already holding.\nconst completedConnectionOnceKeys = new WeakMap<ExecSql, Set<string>>();\n\n// Keys first completed inside each open transaction scope on a connection,\n// innermost scope last. A rolled-back scope undid that schema work, so it\n// forgets exactly its own keys; a committed savepoint hands its keys to the\n// enclosing scope, whose rollback would undo them too.\nconst transactionSchemaMemoScopes = new WeakMap<ExecSql, Set<string>[]>();\n\nexport function hasCompletedConnectionOnce(\n  execSql: ExecSql,\n  key: string,\n): boolean {\n  return (\n    completedConnectionOnceKeys\n      .get(resolveCanonicalExecSql(execSql))\n      ?.has(key) ?? false\n  );\n}\n\nexport function markCompletedConnectionOnce(\n  execSql: ExecSql,\n  key: string,\n): void {\n  const canonical = resolveCanonicalExecSql(execSql);\n  const keys = completedConnectionOnceKeys.get(canonical) ?? new Set<string>();\n  if (keys.has(key)) return;\n  keys.add(key);\n  completedConnectionOnceKeys.set(canonical, keys);\n  transactionSchemaMemoScopes.get(canonical)?.at(-1)?.add(key);\n}\n\n/**\n * Start recording the once-per-connection keys completed inside a transaction\n * scope (a transaction or one of its savepoints). Every open must be paired\n * with exactly one `closeTransactionSchemaMemoScope`.\n */\nexport function openTransactionSchemaMemoScope(execSql: ExecSql): void {\n  const canonical = resolveCanonicalExecSql(execSql);\n  const scopes = transactionSchemaMemoScopes.get(canonical) ?? [];\n  scopes.push(new Set<string>());\n  transactionSchemaMemoScopes.set(canonical, scopes);\n}\n\n/**\n * Close the innermost transaction scope. A rollback forgets only the keys\n * completed inside it, so the next query re-ensures exactly the schema the\n * rollback undid; a commit keeps them, handing them to the enclosing scope.\n */\nexport function closeTransactionSchemaMemoScope(\n  execSql: ExecSql,\n  committed: boolean,\n): void {\n  const canonical = resolveCanonicalExecSql(execSql);\n  const scopes = transactionSchemaMemoScopes.get(canonical);\n  const scopeKeys = scopes?.pop();\n  if (!scopes || !scopeKeys) {\n    throw new Error(\"No open transaction schema memo scope to close\");\n  }\n  if (scopes.length === 0) transactionSchemaMemoScopes.delete(canonical);\n  if (committed) {\n    const parent = scopes.at(-1);\n    for (const key of scopeKeys) parent?.add(key);\n    return;\n  }\n  const completed = completedConnectionOnceKeys.get(canonical);\n  for (const key of scopeKeys) completed?.delete(key);\n}\n\n// Completion is recorded as soon as `run` resolves. Inside a runtime\n// transaction the key joins the open schema memo scope, so a later ROLLBACK\n// forgets it; an explicit transaction outside the runtime must instead call\n// `resetConnectionSchemaMemo` after rolling back.\nexport async function runOncePerConnection(\n  execSql: ExecSql,\n  key: string,\n  run: () => Promise<void>,\n): Promise<void> {\n  if (hasCompletedConnectionOnce(execSql, key)) {\n    return;\n  }\n  await run();\n  markCompletedConnectionOnce(execSql, key);\n}\n\n/**\n * Forget every completed once-per-connection key for this connection. Required\n * after an operation that rebuilds the schema out from under the runtime (the\n * local backup restore drops and recreates all user tables) so the next query\n * re-runs its schema ensures.\n */\nexport function resetConnectionSchemaMemo(execSql: ExecSql): void {\n  completedConnectionOnceKeys.delete(resolveCanonicalExecSql(execSql));\n}\n\nfunction defineExecSql(\n  run: (\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ) => Promise<Array<SqlRow | SqlArrayRow>>,\n): ExecSql {\n  function execSql(\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: \"object\" },\n  ): Promise<SqlRow[]>;\n  function execSql(\n    sql: string,\n    bind: SqlBind | undefined,\n    options: { rowMode: \"array\" },\n  ): Promise<SqlArrayRow[]>;\n  function execSql(\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ): Promise<Array<SqlRow | SqlArrayRow>>;\n  async function execSql(\n    sql: string,\n    bind?: SqlBind,\n    options?: { rowMode?: SqlRowMode },\n  ): Promise<Array<SqlRow | SqlArrayRow>> {\n    return run(sql, bind, options);\n  }\n\n  return execSql;\n}\n\nexport function createExecSql(client: ExecSqlClientLike): ExecSql {\n  const existingExecSql = clientExecSqls.get(client);\n  if (existingExecSql) {\n    return existingExecSql;\n  }\n\n  const execSql = defineExecSql(async (sql, bind, options) => {\n    const result = await client.exec({\n      sql,\n      ...(bind !== undefined ? { bind } : {}),\n      ...(options?.rowMode ? { rowMode: options.rowMode } : {}),\n    });\n    return result.rows;\n  });\n\n  clientExecSqls.set(client, execSql);\n  return execSql;\n}\n\nfunction isSerializedSqlExec(execSql: ExecSql): boolean {\n  return serializedSqlExecs.has(execSql);\n}\n\nfunction createSerializedSqlExec(execSql: ExecSql): ExecSql {\n  if (isSerializedSqlExec(execSql)) {\n    return execSql;\n  }\n\n  const serializedExecSql = defineExecSql(execSql);\n  serializedSqlExecs.add(serializedExecSql);\n  serializedSqlExecCanonicals.set(\n    serializedExecSql,\n    resolveCanonicalExecSql(execSql),\n  );\n  return serializedExecSql;\n}\n\n// SQLite transactions are scoped to the shared connection, so we must hold a\n// connection-level lock across multi-statement mutations to prevent interleaving.\n// Nested callers must keep passing the provided locked executor. Re-entering\n// with the original canonical executor will wait on the current mutation and\n// deadlock.\n// Each outermost mutation is drawn on DevTools tracks: time spent queued\n// behind another mutation, then time holding the lock.\nexport async function runSerializedSqlMutation<T>(\n  execSql: ExecSql,\n  operation: (execSql: ExecSql) => Promise<T> | T,\n): Promise<T> {\n  if (isSerializedSqlExec(execSql)) {\n    return operation(execSql);\n  }\n\n  const queuedAtMs = readUserTimingClock();\n  const previous = sqlMutationQueue.get(execSql);\n  let releaseCurrent = () => {};\n  const current = new Promise<void>((resolve) => {\n    releaseCurrent = resolve;\n  });\n  const waitForPrevious = (previous ?? Promise.resolve()).catch(\n    () => undefined,\n  );\n  const queuedCurrent = waitForPrevious.then(() => current);\n\n  sqlMutationQueue.set(execSql, queuedCurrent);\n  await waitForPrevious;\n  const acquiredAtMs = readUserTimingClock();\n  if (previous) {\n    recordUserTimingEntry({\n      endMs: acquiredAtMs,\n      name: \"SQLite mutation wait\",\n      startMs: queuedAtMs,\n      track: \"SQLite mutation queue\",\n    });\n  }\n\n  let failed = true;\n  try {\n    const result = await operation(createSerializedSqlExec(execSql));\n    failed = false;\n    return result;\n  } finally {\n    const releasedAtMs = readUserTimingClock();\n    releaseCurrent();\n    if (sqlMutationQueue.get(execSql) === queuedCurrent) {\n      sqlMutationQueue.delete(execSql);\n    }\n    recordUserTimingEntry({\n      endMs: releasedAtMs,\n      failed,\n      name: \"SQLite mutation\",\n      startMs: acquiredAtMs,\n      track: \"SQLite mutations\",\n    });\n  }\n}\n"]}

package/data/sqlite/sqlTableSchema.js

@@ -1,6 +1,7 @@
 import { SQL } from "drizzle-orm";
 import { getTableConfig, SQLiteSyncDialect, } from "drizzle-orm/sqlite-core";
 import { hasCompletedConnectionOnce, markCompletedConnectionOnce, runSerializedSqlMutation, } from "./sqlExec.js";
+import { sqliteRowsPerStatement } from "./sqliteBindBudget.js";
 const sqliteDialect = new SQLiteSyncDialect();
 function renderIdentifier(name) {
     return `"${name.replaceAll('"', '""')}"`;
@@ -100,15 +101,30 @@ export function defineSqlTableSchema(table) {
 function getTableEnsureKey(table) {
     return `sql-table:${table.name}`;
 }
-async function assertRequiredColumns(execSql, table) {
-    if (!table.requiredColumns || table.requiredColumns.length === 0) {
-        return;
+// Two binds per table; the schema has far fewer tables than this.
+const REQUIRED_COLUMN_TABLES_PER_STATEMENT = sqliteRowsPerStatement(2);
+// One read of every checked table's stored columns. The first obsolete table,
+// in ensure order, fails before any index DDL runs.
+async function assertRequiredColumns(execSql, tables) {
+    const checked = tables.filter((table) => (table.requiredColumns?.length ?? 0) > 0);
+    const storedColumns = new Map();
+    for (let offset = 0; offset < checked.length; offset += REQUIRED_COLUMN_TABLES_PER_STATEMENT) {
+        const batch = checked.slice(offset, offset + REQUIRED_COLUMN_TABLES_PER_STATEMENT);
+        const rows = await execSql(batch
+            .map(() => "SELECT ? AS table_name, name FROM pragma_table_info(?)")
+            .join(" UNION ALL "), batch.flatMap((table) => [table.name, table.name]));
+        for (const { name, table_name: tableName } of rows) {
+            const tableKey = String(tableName);
+            const columns = storedColumns.get(tableKey) ?? new Set();
+            columns.add(String(name));
+            storedColumns.set(tableKey, columns);
+        }
     }
-    const rows = await execSql(`PRAGMA table_info(${renderIdentifier(table.name)})`);
-    const storedColumns = new Set(rows.map(({ name }) => name));
-    const missingColumns = table.requiredColumns.filter((column) => !storedColumns.has(column));
-    if (missingColumns.length > 0) {
-        throw new Error(`Local database schema for ${table.name} is obsolete; reset the local database before continuing`);
+    for (const table of checked) {
+        const stored = storedColumns.get(table.name);
+        if (table.requiredColumns?.some((column) => !stored?.has(column))) {
+            throw new Error(`Local database schema for ${table.name} is obsolete; reset the local database before continuing`);
+        }
     }
 }
 // Table ensures run on every query path, so completed ones are
@@ -118,17 +134,26 @@ async function assertRequiredColumns(execSql, table) {
 // EXISTS no-ops. `resetConnectionSchemaMemo` forgets the memo when the schema
 // is rebuilt out from under the runtime (local backup restore).
 export async function ensureSqlTables(execSql, tables) {
-    const pendingTables = tables.filter((table) => !hasCompletedConnectionOnce(execSql, getTableEnsureKey(table)));
+    const pendingByName = new Map();
+    for (const table of tables) {
+        if (!pendingByName.has(table.name) &&
+            !hasCompletedConnectionOnce(execSql, getTableEnsureKey(table))) {
+            pendingByName.set(table.name, table);
+        }
+    }
+    const pendingTables = [...pendingByName.values()];
     if (pendingTables.length === 0) {
         return;
     }
+    // Each statement is a worker message, so the DDL travels in three: every
+    // CREATE TABLE, then the required-column read (an obsolete table fails
+    // before an index can trip over a missing column), then every CREATE INDEX.
     await runSerializedSqlMutation(execSql, async (lockedExecSql) => {
-        for (const table of pendingTables) {
-            await lockedExecSql(table.createSql);
-            await assertRequiredColumns(lockedExecSql, table);
-            for (const indexSql of table.indexes ?? []) {
-                await lockedExecSql(indexSql);
-            }
+        await lockedExecSql(pendingTables.map((table) => table.createSql).join(";\n"));
+        await assertRequiredColumns(lockedExecSql, pendingTables);
+        const indexSql = pendingTables.flatMap((table) => table.indexes ?? []);
+        if (indexSql.length > 0) {
+            await lockedExecSql(indexSql.join(";\n"));
         }
     });
     for (const table of pendingTables) {

package/data/sqlite/sqlTableSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlTableSchema.js","sourceRoot":"","sources":["sqlTableSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import { SQL } from \"drizzle-orm\";\nimport {\n  getTableConfig,\n  type Index,\n  type IndexColumn,\n  type SQLiteColumn,\n  SQLiteSyncDialect,\n  type SQLiteTable,\n} from \"drizzle-orm/sqlite-core\";\nimport type { ExecSql } from \"./sqlExec\";\nimport {\n  hasCompletedConnectionOnce,\n  markCompletedConnectionOnce,\n  runSerializedSqlMutation,\n} from \"./sqlExec\";\n\nexport interface SqlTableSchema {\n  name: string;\n  createSql: string;\n  indexes?: ReadonlyArray<string>;\n  requiredColumns?: ReadonlyArray<string>;\n}\n\nconst sqliteDialect = new SQLiteSyncDialect();\n\nfunction renderIdentifier(name: string): string {\n  return `\"${name.replaceAll('\"', '\"\"')}\"`;\n}\n\nfunction renderDefaultValue(value: unknown): string {\n  if (value === null) {\n    return \"NULL\";\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? \"1\" : \"0\";\n  }\n\n  if (value instanceof SQL) {\n    return sqliteDialect.sqlToQuery(value).sql;\n  }\n\n  if (typeof value === \"number\") {\n    return String(value);\n  }\n\n  if (typeof value === \"string\") {\n    return `'${value.replaceAll(\"'\", \"''\")}'`;\n  }\n\n  throw new Error(`Unsupported SQLite default value: ${String(value)}`);\n}\n\nfunction renderColumn(\n  column: SQLiteColumn,\n  inlinePrimaryKeyColumnName?: string,\n): string {\n  const parts = [\n    renderIdentifier(column.name),\n    column.getSQLType().toUpperCase(),\n  ];\n\n  if (column.notNull) {\n    parts.push(\"NOT NULL\");\n  }\n\n  if (column.hasDefault) {\n    parts.push(\"DEFAULT\", renderDefaultValue(column.default));\n  }\n\n  if (column.primary || column.name === inlinePrimaryKeyColumnName) {\n    parts.push(\"PRIMARY KEY\");\n  }\n\n  if (column.isUnique) {\n    parts.push(\"UNIQUE\");\n  }\n\n  return parts.join(\" \");\n}\n\nfunction renderPrimaryKey(columns: ReadonlyArray<SQLiteColumn>): string {\n  const columnNames = columns.map((column) => renderIdentifier(column.name));\n  return `PRIMARY KEY (${columnNames.join(\", \")})`;\n}\n\nfunction renderUniqueConstraint(columns: ReadonlyArray<SQLiteColumn>): string {\n  const columnNames = columns.map((column) => renderIdentifier(column.name));\n  return `UNIQUE (${columnNames.join(\", \")})`;\n}\n\nfunction isSQLiteColumn(value: IndexColumn): value is SQLiteColumn {\n  return (\n    \"name\" in value && typeof value.name === \"string\" && \"getSQLType\" in value\n  );\n}\n\nfunction renderIndexColumn(column: IndexColumn): string {\n  if (isSQLiteColumn(column)) {\n    return renderIdentifier(column.name);\n  }\n\n  return sqliteDialect.sqlToQuery(column.getSQL(), \"indexes\").sql;\n}\n\nfunction renderIndex(indexDefinition: Index): string {\n  const config = indexDefinition.config;\n  const unique = config.unique ? \"UNIQUE \" : \"\";\n  const columns = config.columns.map(renderIndexColumn).join(\", \");\n  const where = config.where\n    ? ` WHERE ${sqliteDialect.sqlToQuery(config.where, \"indexes\").sql}`\n    : \"\";\n\n  return `CREATE ${unique}INDEX IF NOT EXISTS ${renderIdentifier(\n    config.name,\n  )} ON ${renderIdentifier(getTableConfig(config.table).name)} (${columns})${where}`;\n}\n\n/**\n * Render a Drizzle SQLite table definition into executable schema SQL.\n *\n * The client runtime creates local tables through `ensureSqlTables`, which works\n * with raw SQL strings rather than Drizzle migrations. This helper keeps the\n * Drizzle table definitions as the source of truth while preserving primary\n * keys, table-level unique constraints, partial indexes, default values, and\n * identifier quoting.\n */\nexport function defineSqlTableSchema(table: SQLiteTable): SqlTableSchema {\n  const config = getTableConfig(table);\n  const inlinePrimaryKeyColumnName =\n    config.primaryKeys.length === 1 &&\n    config.primaryKeys[0]?.columns.length === 1\n      ? config.primaryKeys[0].columns[0]?.name\n      : undefined;\n  const columns = config.columns.map((column) =>\n    renderColumn(column, inlinePrimaryKeyColumnName),\n  );\n  const primaryKeys = inlinePrimaryKeyColumnName\n    ? []\n    : config.primaryKeys.map((key) => renderPrimaryKey(key.columns));\n  const uniqueConstraints = config.uniqueConstraints.map((constraint) =>\n    renderUniqueConstraint(constraint.columns),\n  );\n  const columnDefinitions = [...columns, ...primaryKeys, ...uniqueConstraints];\n\n  return {\n    name: config.name,\n    createSql: `CREATE TABLE IF NOT EXISTS ${renderIdentifier(config.name)} (\n  ${columnDefinitions.join(\",\\n  \")}\n)`,\n    indexes: config.indexes.map(renderIndex),\n  };\n}\n\nfunction getTableEnsureKey(table: SqlTableSchema): string {\n  return `sql-table:${table.name}`;\n}\n\nasync function assertRequiredColumns(\n  execSql: ExecSql,\n  table: SqlTableSchema,\n): Promise<void> {\n  if (!table.requiredColumns || table.requiredColumns.length === 0) {\n    return;\n  }\n  const rows = await execSql(\n    `PRAGMA table_info(${renderIdentifier(table.name)})`,\n  );\n  const storedColumns = new Set(rows.map(({ name }) => name));\n  const missingColumns = table.requiredColumns.filter(\n    (column) => !storedColumns.has(column),\n  );\n  if (missingColumns.length > 0) {\n    throw new Error(\n      `Local database schema for ${table.name} is obsolete; reset the local database before continuing`,\n    );\n  }\n}\n\n// Table ensures run on every query path, so completed ones are\n// remembered per connection: a re-ensure of an already-ensured table skips the\n// DDL round-trips AND the serialized mutation lock, keeping diagnostic reads\n// from queueing behind bulk-import writes just to re-issue CREATE IF NOT\n// EXISTS no-ops. `resetConnectionSchemaMemo` forgets the memo when the schema\n// is rebuilt out from under the runtime (local backup restore).\nexport async function ensureSqlTables(\n  execSql: ExecSql,\n  tables: ReadonlyArray<SqlTableSchema>,\n): Promise<void> {\n  const pendingTables = tables.filter(\n    (table) => !hasCompletedConnectionOnce(execSql, getTableEnsureKey(table)),\n  );\n  if (pendingTables.length === 0) {\n    return;\n  }\n\n  await runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    for (const table of pendingTables) {\n      await lockedExecSql(table.createSql);\n      await assertRequiredColumns(lockedExecSql, table);\n      for (const indexSql of table.indexes ?? []) {\n        await lockedExecSql(indexSql);\n      }\n    }\n  });\n  for (const table of pendingTables) {\n    markCompletedConnectionOnce(execSql, getTableEnsureKey(table));\n  }\n}\n"]}
+{"version":3,"file":"sqlTableSchema.js","sourceRoot":"","sources":["sqlTableSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EACL,cAAc,EAId,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAS5D,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAE9C,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AAC3C,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,YAAY,CACnB,MAAoB,EACpB,0BAAmC;IAEnC,MAAM,KAAK,GAAG;QACZ,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE;KAClC,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAoC;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,OAAO,gBAAgB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAoC;IAClE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,OAAO,WAAW,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB;IACxC,OAAO,CACL,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,IAAI,KAAK,CAC3E,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,eAAsB;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK;QACxB,CAAC,CAAC,UAAU,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,GAAG,EAAE;QACnE,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,UAAU,MAAM,uBAAuB,gBAAgB,CAC5D,MAAM,CAAC,IAAI,CACZ,OAAO,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,IAAI,KAAK,EAAE,CAAC;AACrF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,0BAA0B,GAC9B,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QACzC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI;QACxC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC5C,YAAY,CAAC,MAAM,EAAE,0BAA0B,CAAC,CACjD,CAAC;IACF,MAAM,WAAW,GAAG,0BAA0B;QAC5C,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACpE,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,CAC3C,CAAC;IACF,MAAM,iBAAiB,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,iBAAiB,CAAC,CAAC;IAE7E,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,8BAA8B,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;IACtE,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;EACjC;QACE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAqB;IAC9C,OAAO,aAAa,KAAK,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,kEAAkE;AAClE,MAAM,oCAAoC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;AAEvE,8EAA8E;AAC9E,oDAAoD;AACpD,KAAK,UAAU,qBAAqB,CAClC,OAAgB,EAChB,MAAqC;IAErC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC3B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CACpD,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IACrD,KACE,IAAI,MAAM,GAAG,CAAC,EACd,MAAM,GAAG,OAAO,CAAC,MAAM,EACvB,MAAM,IAAI,oCAAoC,EAC9C,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CACzB,MAAM,EACN,MAAM,GAAG,oCAAoC,CAC9C,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,KAAK;aACF,GAAG,CAAC,GAAG,EAAE,CAAC,wDAAwD,CAAC;aACnE,IAAI,CAAC,aAAa,CAAC,EACtB,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CACnD,CAAC;QACF,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1B,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,KAAK,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,CAAC,IAAI,0DAA0D,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,+EAA+E;AAC/E,6EAA6E;AAC7E,yEAAyE;AACzE,8EAA8E;AAC9E,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAgB,EAChB,MAAqC;IAErC,MAAM,aAAa,GAAG,IAAI,GAAG,EAA0B,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IACE,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAC9B,CAAC,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAC9D,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,MAAM,aAAa,GAAG,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,yEAAyE;IACzE,uEAAuE;IACvE,4EAA4E;IAC5E,MAAM,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE;QAC9D,MAAM,aAAa,CACjB,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAC1D,CAAC;QACF,MAAM,qBAAqB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACvE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,2BAA2B,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC","sourcesContent":["import { SQL } from \"drizzle-orm\";\nimport {\n  getTableConfig,\n  type Index,\n  type IndexColumn,\n  type SQLiteColumn,\n  SQLiteSyncDialect,\n  type SQLiteTable,\n} from \"drizzle-orm/sqlite-core\";\nimport type { ExecSql } from \"./sqlExec\";\nimport {\n  hasCompletedConnectionOnce,\n  markCompletedConnectionOnce,\n  runSerializedSqlMutation,\n} from \"./sqlExec\";\nimport { sqliteRowsPerStatement } from \"./sqliteBindBudget\";\n\nexport interface SqlTableSchema {\n  name: string;\n  createSql: string;\n  indexes?: ReadonlyArray<string>;\n  requiredColumns?: ReadonlyArray<string>;\n}\n\nconst sqliteDialect = new SQLiteSyncDialect();\n\nfunction renderIdentifier(name: string): string {\n  return `\"${name.replaceAll('\"', '\"\"')}\"`;\n}\n\nfunction renderDefaultValue(value: unknown): string {\n  if (value === null) {\n    return \"NULL\";\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? \"1\" : \"0\";\n  }\n\n  if (value instanceof SQL) {\n    return sqliteDialect.sqlToQuery(value).sql;\n  }\n\n  if (typeof value === \"number\") {\n    return String(value);\n  }\n\n  if (typeof value === \"string\") {\n    return `'${value.replaceAll(\"'\", \"''\")}'`;\n  }\n\n  throw new Error(`Unsupported SQLite default value: ${String(value)}`);\n}\n\nfunction renderColumn(\n  column: SQLiteColumn,\n  inlinePrimaryKeyColumnName?: string,\n): string {\n  const parts = [\n    renderIdentifier(column.name),\n    column.getSQLType().toUpperCase(),\n  ];\n\n  if (column.notNull) {\n    parts.push(\"NOT NULL\");\n  }\n\n  if (column.hasDefault) {\n    parts.push(\"DEFAULT\", renderDefaultValue(column.default));\n  }\n\n  if (column.primary || column.name === inlinePrimaryKeyColumnName) {\n    parts.push(\"PRIMARY KEY\");\n  }\n\n  if (column.isUnique) {\n    parts.push(\"UNIQUE\");\n  }\n\n  return parts.join(\" \");\n}\n\nfunction renderPrimaryKey(columns: ReadonlyArray<SQLiteColumn>): string {\n  const columnNames = columns.map((column) => renderIdentifier(column.name));\n  return `PRIMARY KEY (${columnNames.join(\", \")})`;\n}\n\nfunction renderUniqueConstraint(columns: ReadonlyArray<SQLiteColumn>): string {\n  const columnNames = columns.map((column) => renderIdentifier(column.name));\n  return `UNIQUE (${columnNames.join(\", \")})`;\n}\n\nfunction isSQLiteColumn(value: IndexColumn): value is SQLiteColumn {\n  return (\n    \"name\" in value && typeof value.name === \"string\" && \"getSQLType\" in value\n  );\n}\n\nfunction renderIndexColumn(column: IndexColumn): string {\n  if (isSQLiteColumn(column)) {\n    return renderIdentifier(column.name);\n  }\n\n  return sqliteDialect.sqlToQuery(column.getSQL(), \"indexes\").sql;\n}\n\nfunction renderIndex(indexDefinition: Index): string {\n  const config = indexDefinition.config;\n  const unique = config.unique ? \"UNIQUE \" : \"\";\n  const columns = config.columns.map(renderIndexColumn).join(\", \");\n  const where = config.where\n    ? ` WHERE ${sqliteDialect.sqlToQuery(config.where, \"indexes\").sql}`\n    : \"\";\n\n  return `CREATE ${unique}INDEX IF NOT EXISTS ${renderIdentifier(\n    config.name,\n  )} ON ${renderIdentifier(getTableConfig(config.table).name)} (${columns})${where}`;\n}\n\n/**\n * Render a Drizzle SQLite table definition into executable schema SQL.\n *\n * The client runtime creates local tables through `ensureSqlTables`, which works\n * with raw SQL strings rather than Drizzle migrations. This helper keeps the\n * Drizzle table definitions as the source of truth while preserving primary\n * keys, table-level unique constraints, partial indexes, default values, and\n * identifier quoting.\n */\nexport function defineSqlTableSchema(table: SQLiteTable): SqlTableSchema {\n  const config = getTableConfig(table);\n  const inlinePrimaryKeyColumnName =\n    config.primaryKeys.length === 1 &&\n    config.primaryKeys[0]?.columns.length === 1\n      ? config.primaryKeys[0].columns[0]?.name\n      : undefined;\n  const columns = config.columns.map((column) =>\n    renderColumn(column, inlinePrimaryKeyColumnName),\n  );\n  const primaryKeys = inlinePrimaryKeyColumnName\n    ? []\n    : config.primaryKeys.map((key) => renderPrimaryKey(key.columns));\n  const uniqueConstraints = config.uniqueConstraints.map((constraint) =>\n    renderUniqueConstraint(constraint.columns),\n  );\n  const columnDefinitions = [...columns, ...primaryKeys, ...uniqueConstraints];\n\n  return {\n    name: config.name,\n    createSql: `CREATE TABLE IF NOT EXISTS ${renderIdentifier(config.name)} (\n  ${columnDefinitions.join(\",\\n  \")}\n)`,\n    indexes: config.indexes.map(renderIndex),\n  };\n}\n\nfunction getTableEnsureKey(table: SqlTableSchema): string {\n  return `sql-table:${table.name}`;\n}\n\n// Two binds per table; the schema has far fewer tables than this.\nconst REQUIRED_COLUMN_TABLES_PER_STATEMENT = sqliteRowsPerStatement(2);\n\n// One read of every checked table's stored columns. The first obsolete table,\n// in ensure order, fails before any index DDL runs.\nasync function assertRequiredColumns(\n  execSql: ExecSql,\n  tables: ReadonlyArray<SqlTableSchema>,\n): Promise<void> {\n  const checked = tables.filter(\n    (table) => (table.requiredColumns?.length ?? 0) > 0,\n  );\n  const storedColumns = new Map<string, Set<string>>();\n  for (\n    let offset = 0;\n    offset < checked.length;\n    offset += REQUIRED_COLUMN_TABLES_PER_STATEMENT\n  ) {\n    const batch = checked.slice(\n      offset,\n      offset + REQUIRED_COLUMN_TABLES_PER_STATEMENT,\n    );\n    const rows = await execSql(\n      batch\n        .map(() => \"SELECT ? AS table_name, name FROM pragma_table_info(?)\")\n        .join(\" UNION ALL \"),\n      batch.flatMap((table) => [table.name, table.name]),\n    );\n    for (const { name, table_name: tableName } of rows) {\n      const tableKey = String(tableName);\n      const columns = storedColumns.get(tableKey) ?? new Set<string>();\n      columns.add(String(name));\n      storedColumns.set(tableKey, columns);\n    }\n  }\n  for (const table of checked) {\n    const stored = storedColumns.get(table.name);\n    if (table.requiredColumns?.some((column) => !stored?.has(column))) {\n      throw new Error(\n        `Local database schema for ${table.name} is obsolete; reset the local database before continuing`,\n      );\n    }\n  }\n}\n\n// Table ensures run on every query path, so completed ones are\n// remembered per connection: a re-ensure of an already-ensured table skips the\n// DDL round-trips AND the serialized mutation lock, keeping diagnostic reads\n// from queueing behind bulk-import writes just to re-issue CREATE IF NOT\n// EXISTS no-ops. `resetConnectionSchemaMemo` forgets the memo when the schema\n// is rebuilt out from under the runtime (local backup restore).\nexport async function ensureSqlTables(\n  execSql: ExecSql,\n  tables: ReadonlyArray<SqlTableSchema>,\n): Promise<void> {\n  const pendingByName = new Map<string, SqlTableSchema>();\n  for (const table of tables) {\n    if (\n      !pendingByName.has(table.name) &&\n      !hasCompletedConnectionOnce(execSql, getTableEnsureKey(table))\n    ) {\n      pendingByName.set(table.name, table);\n    }\n  }\n  const pendingTables = [...pendingByName.values()];\n  if (pendingTables.length === 0) {\n    return;\n  }\n\n  // Each statement is a worker message, so the DDL travels in three: every\n  // CREATE TABLE, then the required-column read (an obsolete table fails\n  // before an index can trip over a missing column), then every CREATE INDEX.\n  await runSerializedSqlMutation(execSql, async (lockedExecSql) => {\n    await lockedExecSql(\n      pendingTables.map((table) => table.createSql).join(\";\\n\"),\n    );\n    await assertRequiredColumns(lockedExecSql, pendingTables);\n    const indexSql = pendingTables.flatMap((table) => table.indexes ?? []);\n    if (indexSql.length > 0) {\n      await lockedExecSql(indexSql.join(\";\\n\"));\n    }\n  });\n  for (const table of pendingTables) {\n    markCompletedConnectionOnce(execSql, getTableEnsureKey(table));\n  }\n}\n"]}

package/data/sqlite/sqlitePersistenceRuntime.js

@@ -1,7 +1,8 @@
 import { drizzle } from "drizzle-orm/sqlite-proxy";
 import { clientSQLiteSchema } from "./schema/index.js";
+import { closeTransactionSchemaMemoScope, openTransactionSchemaMemoScope, } from "./sqlExec.js";
 import { assertClientSQLiteCommitAllowed, beginClientSQLiteCommitGuards, captureClientSQLiteCommitGuards, clearClientSQLiteCommitGuards, rethrowClientSQLiteCommitGuardFailure, } from "./sqliteCommitGuards.js";
-import { createExecSql, resetConnectionSchemaMemo, resolveCanonicalExecSql, runSerializedSqlMutation, } from "./sqlSchema.js";
+import { createExecSql, resolveCanonicalExecSql, runSerializedSqlMutation, } from "./sqlSchema.js";
 const runtimeByExecSql = new WeakMap();
 function transactionBeginStatement(config) {
     if (config?.behavior === "immediate")
@@ -86,19 +87,23 @@ async function runNestedSavepointScope(canonical, lockedExecSql, operation) {
         transactionDepthByCanonicalExecSql.set(canonical, depth + 1);
         const savepoint = `runtime_transaction_sp_${depth}`;
         const discardNestedGuards = captureClientSQLiteCommitGuards(canonical);
+        openTransactionSchemaMemoScope(canonical);
+        let released = false;
         try {
             await lockedExecSql(`SAVEPOINT ${savepoint}`);
             const result = await operation();
             await lockedExecSql(`RELEASE SAVEPOINT ${savepoint}`);
+            released = true;
             return result;
         }
         catch (error) {
             await lockedExecSql(`ROLLBACK TO SAVEPOINT ${savepoint}`).then(discardNestedGuards, () => undefined);
             await lockedExecSql(`RELEASE SAVEPOINT ${savepoint}`).catch(() => undefined);
-            resetConnectionSchemaMemo(canonical);
             throw error;
         }
         finally {
+            // The savepoint's rollback undid only the schema it first ensured.
+            closeTransactionSchemaMemoScope(canonical, released);
             transactionDepthByCanonicalExecSql.set(canonical, depth);
             if (chains.get(depthAtEntry) === tracked) {
                 chains.delete(depthAtEntry);
@@ -142,19 +147,20 @@ function createRuntimeForExecSql(execSql) {
                 }
                 transactionDepthByCanonicalExecSql.set(canonical, 1);
                 beginClientSQLiteCommitGuards(canonical);
+                openTransactionSchemaMemoScope(canonical);
+                let committed = false;
                 try {
-                    return await db.transaction(operation, config);
+                    const result = await db.transaction(operation, config);
+                    committed = true;
+                    return result;
                 }
                 catch (error) {
-                    // The rollback undid any DDL this transaction ran, but the
-                    // per-connection ensure memo still claims it exists — reset it
-                    // so later operations re-ensure instead of hitting missing
-                    // tables.
-                    resetConnectionSchemaMemo(canonical);
                     rethrowClientSQLiteCommitGuardFailure(canonical);
                     throw error;
                 }
                 finally {
+                    // A rollback forgets the ensures it undid (see sqlExec).
+                    closeTransactionSchemaMemoScope(canonical, committed);
                     clearClientSQLiteCommitGuards(canonical);
                     transactionDepthByCanonicalExecSql.delete(canonical);
                 }
@@ -168,12 +174,13 @@ function createRuntimeForExecSql(execSql) {
                 }
                 transactionDepthByCanonicalExecSql.set(canonical, 1);
                 beginClientSQLiteCommitGuards(canonical);
+                openTransactionSchemaMemoScope(canonical);
+                let committed = false;
                 try {
                     await lockedExecSql(transactionBeginStatement(config));
                     const result = await operation(db);
                     if (!canCommit()) {
                         await lockedExecSql("ROLLBACK");
-                        resetConnectionSchemaMemo(canonical);
                         return { committed: false, result: null };
                     }
                     // The guard passed in THIS synchronous slice and the COMMIT is
@@ -184,15 +191,16 @@ function createRuntimeForExecSql(execSql) {
                     assertClientSQLiteCommitAllowed(lockedExecSql);
                     const commit = lockedExecSql("COMMIT");
                     await commit;
+                    committed = true;
                     return { committed: true, result };
                 }
                 catch (error) {
                     await lockedExecSql("ROLLBACK").catch(() => undefined);
-                    resetConnectionSchemaMemo(canonical);
                     rethrowClientSQLiteCommitGuardFailure(canonical);
                     throw error;
                 }
                 finally {
+                    closeTransactionSchemaMemoScope(canonical, committed);
                     clearClientSQLiteCommitGuards(canonical);
                     transactionDepthByCanonicalExecSql.delete(canonical);
                 }

package/data/sqlite/sqlitePersistenceRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlitePersistenceRuntime.js","sourceRoot":"","sources":["sqlitePersistenceRuntime.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RemoteCallback,\n  SqliteRemoteDatabase,\n} from \"drizzle-orm/sqlite-proxy\";\nimport { drizzle } from \"drizzle-orm/sqlite-proxy\";\nimport { clientSQLiteSchema } from \"./schema\";\nimport {\n  assertClientSQLiteCommitAllowed,\n  beginClientSQLiteCommitGuards,\n  captureClientSQLiteCommitGuards,\n  clearClientSQLiteCommitGuards,\n  rethrowClientSQLiteCommitGuardFailure,\n} from \"./sqliteCommitGuards\";\nimport {\n  createExecSql,\n  type ExecSql,\n  type ExecSqlClientLike,\n  resetConnectionSchemaMemo,\n  resolveCanonicalExecSql,\n  runSerializedSqlMutation,\n  type SqlArrayRow,\n  type SqlRowValue,\n} from \"./sqlSchema\";\n\nexport type ClientSQLiteSchema = typeof clientSQLiteSchema;\nexport type ClientSQLiteDatabase = SqliteRemoteDatabase<ClientSQLiteSchema>;\nexport type ClientSQLiteTransactionConfig = NonNullable<\n  Parameters<ClientSQLiteDatabase[\"transaction\"]>[1]\n>;\n/**\n * The handle a runtime transaction callback receives: the transaction's\n * query interface WITHOUT `rollback` (throw instead — every scope maps an\n * exception to its own rollback) and WITHOUT `transaction` (nest by calling\n * `runtime.transaction` again, which scopes to a savepoint). Narrowing the\n * contract here is what lets a nested scope share the connection-backed\n * database handle safely.\n */\nexport type ClientSQLiteTransactionScope = Pick<\n  ClientSQLiteDatabase,\n  | \"all\"\n  | \"delete\"\n  | \"get\"\n  | \"insert\"\n  | \"query\"\n  | \"run\"\n  | \"select\"\n  | \"selectDistinct\"\n  | \"update\"\n  | \"values\"\n>;\n\nexport interface ClientSQLitePersistenceRuntime {\n  db: ClientSQLiteDatabase;\n  execSql: ExecSql;\n  runMutation<T>(\n    operation: (db: ClientSQLiteDatabase) => Promise<T> | T,\n  ): Promise<T>;\n  transaction<T>(\n    operation: (tx: ClientSQLiteTransactionScope) => Promise<T>,\n    config?: ClientSQLiteTransactionConfig,\n  ): Promise<T>;\n  /**\n   * A transaction whose commit is gated on a SYNCHRONOUS guard: the guard\n   * runs and — when it passes — the COMMIT is dispatched in the same\n   * synchronous slice, so no JavaScript (an identity replacement included)\n   * can interleave between the decision and the commit dispatch. Resolves\n   * with `committed: false` (all writes rolled back) when the guard refuses.\n   */\n  guardedTransaction<T>(\n    operation: (tx: ClientSQLiteTransactionScope) => Promise<T>,\n    canCommit: () => boolean,\n    config?: ClientSQLiteTransactionConfig,\n  ): Promise<{ committed: boolean; result: T | null }>;\n}\n\nconst runtimeByExecSql = new WeakMap<ExecSql, ClientSQLitePersistenceRuntime>();\n\nfunction transactionBeginStatement(\n  config: ClientSQLiteTransactionConfig | undefined,\n): \"BEGIN\" | \"BEGIN EXCLUSIVE\" | \"BEGIN IMMEDIATE\" {\n  if (config?.behavior === \"immediate\") return \"BEGIN IMMEDIATE\";\n  if (config?.behavior === \"exclusive\") return \"BEGIN EXCLUSIVE\";\n  return \"BEGIN\";\n}\n\n// One transaction depth per underlying connection (canonical executor), so a\n// runtime.transaction call made while another transaction is already open on\n// the same connection degrades to a SAVEPOINT scope instead of issuing a\n// second BEGIN. Callers inside a serialized mutation get separate runtime\n// instances per locked executor, so the depth cannot live on the runtime.\nconst transactionDepthByCanonicalExecSql = new WeakMap<ExecSql, number>();\n// Sibling nested scopes on one connection must not interleave: SQLite\n// savepoints form a stack, so releasing an earlier savepoint would also\n// release a later sibling started concurrently. Scopes serialize per\n// NESTING DEPTH — siblings share a depth and queue behind each other, while\n// a descendant runs one level deeper and must NOT wait on its own enclosing\n// scope (that wait can never resolve).\nconst nestedScopeChainsByCanonicalExecSql = new WeakMap<\n  ExecSql,\n  Map<number, Promise<unknown>>\n>();\nconst execSqlByClient = new WeakMap<ExecSqlClientLike, ExecSql>();\n\nfunction toSqlRowValue(value: unknown): SqlRowValue {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  if (typeof value === \"string\" || typeof value === \"number\") {\n    return value;\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? 1 : 0;\n  }\n\n  throw new Error(`Unsupported SQLite bind value: ${String(value)}`);\n}\n\nfunction createRemoteCallback(getExecSql: () => ExecSql): RemoteCallback {\n  type RemoteResult = Awaited<ReturnType<RemoteCallback>>;\n\n  function getRemoteResult(rows: readonly SqlArrayRow[]): RemoteResult {\n    const row = rows[0];\n    if (row !== undefined) {\n      return { rows: row } satisfies RemoteResult;\n    }\n\n    // Drizzle's RemoteCallback type requires rows, but sqlite-proxy's get()\n    // mapper treats an undefined rows value as \"no row found\".\n    return Object.defineProperty({ rows: [] } satisfies RemoteResult, \"rows\", {\n      enumerable: true,\n      value: undefined,\n    });\n  }\n\n  return async (sql, params, method) => {\n    const execSql = getExecSql();\n    if (sql.trim().toLowerCase() === \"commit\")\n      assertClientSQLiteCommitAllowed(execSql);\n    const rows = await execSql(sql, params.map(toSqlRowValue), {\n      rowMode: \"array\",\n    });\n\n    if (method === \"get\") {\n      return getRemoteResult(rows);\n    }\n\n    return { rows } satisfies RemoteResult;\n  };\n}\n\nfunction createClientSQLiteDatabase(\n  getExecSql: () => ExecSql,\n): ClientSQLiteDatabase {\n  return drizzle(createRemoteCallback(getExecSql), {\n    schema: clientSQLiteSchema,\n  });\n}\n\n// Serialize nested savepoint scopes per connection AND depth: a sibling\n// (same depth) queues behind the previous sibling so their savepoints\n// strictly nest instead of interleaving on the shared stack, while a\n// descendant (called from inside an executing scope, so one level deeper)\n// starts on its own depth's chain and never waits on its unresolved parent.\nasync function runNestedSavepointScope<T>(\n  canonical: ExecSql,\n  lockedExecSql: ExecSql,\n  operation: () => Promise<T>,\n): Promise<T> {\n  const depthAtEntry = transactionDepthByCanonicalExecSql.get(canonical) ?? 0;\n  const chains =\n    nestedScopeChainsByCanonicalExecSql.get(canonical) ??\n    new Map<number, Promise<unknown>>();\n  nestedScopeChainsByCanonicalExecSql.set(canonical, chains);\n  const previous = chains.get(depthAtEntry) ?? Promise.resolve();\n  let tracked: Promise<unknown> = Promise.resolve();\n  const scope = previous\n    .catch(() => undefined)\n    .then(async () => {\n      const depth = transactionDepthByCanonicalExecSql.get(canonical) ?? 0;\n      transactionDepthByCanonicalExecSql.set(canonical, depth + 1);\n      const savepoint = `runtime_transaction_sp_${depth}`;\n      const discardNestedGuards = captureClientSQLiteCommitGuards(canonical);\n      try {\n        await lockedExecSql(`SAVEPOINT ${savepoint}`);\n        const result = await operation();\n        await lockedExecSql(`RELEASE SAVEPOINT ${savepoint}`);\n        return result;\n      } catch (error: unknown) {\n        await lockedExecSql(`ROLLBACK TO SAVEPOINT ${savepoint}`).then(\n          discardNestedGuards,\n          () => undefined,\n        );\n        await lockedExecSql(`RELEASE SAVEPOINT ${savepoint}`).catch(\n          () => undefined,\n        );\n        resetConnectionSchemaMemo(canonical);\n        throw error;\n      } finally {\n        transactionDepthByCanonicalExecSql.set(canonical, depth);\n        if (chains.get(depthAtEntry) === tracked) {\n          chains.delete(depthAtEntry);\n        }\n      }\n    });\n  tracked = scope.catch(() => undefined);\n  chains.set(depthAtEntry, tracked);\n  return scope;\n}\n\nfunction createRuntimeForExecSql(\n  execSql: ExecSql,\n): ClientSQLitePersistenceRuntime {\n  let activeExecSql = execSql;\n  const db = createClientSQLiteDatabase(() => activeExecSql);\n\n  async function withActiveExecSql<T>(\n    nextExecSql: ExecSql,\n    operation: () => Promise<T> | T,\n  ): Promise<T> {\n    const previousExecSql = activeExecSql;\n    activeExecSql = nextExecSql;\n\n    try {\n      return await operation();\n    } finally {\n      activeExecSql = previousExecSql;\n    }\n  }\n\n  const runtime: ClientSQLitePersistenceRuntime = {\n    db,\n    execSql,\n    runMutation(operation) {\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n        withActiveExecSql(lockedExecSql, () => operation(db)),\n      );\n    },\n    transaction(operation, config) {\n      // A caller already inside an open transaction on this connection MUST\n      // reach us through the transaction's locked executor (the runtime that\n      // executor resolves to detects the open transaction below and joins it\n      // as a savepoint scope). Re-entering through the canonical executor\n      // queues here for full isolation — the contract every persistence\n      // helper follows by passing its received locked executor down.\n      const canonical = resolveCanonicalExecSql(execSql);\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n        withActiveExecSql(lockedExecSql, async () => {\n          if ((transactionDepthByCanonicalExecSql.get(canonical) ?? 0) > 0) {\n            return runNestedSavepointScope(canonical, lockedExecSql, () =>\n              operation(db),\n            );\n          }\n\n          transactionDepthByCanonicalExecSql.set(canonical, 1);\n          beginClientSQLiteCommitGuards(canonical);\n          try {\n            return await db.transaction(operation, config);\n          } catch (error: unknown) {\n            // The rollback undid any DDL this transaction ran, but the\n            // per-connection ensure memo still claims it exists — reset it\n            // so later operations re-ensure instead of hitting missing\n            // tables.\n            resetConnectionSchemaMemo(canonical);\n            rethrowClientSQLiteCommitGuardFailure(canonical);\n            throw error;\n          } finally {\n            clearClientSQLiteCommitGuards(canonical);\n            transactionDepthByCanonicalExecSql.delete(canonical);\n          }\n        }),\n      );\n    },\n    guardedTransaction(operation, canCommit, config) {\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n        withActiveExecSql(lockedExecSql, async () => {\n          const canonical = resolveCanonicalExecSql(execSql);\n          if ((transactionDepthByCanonicalExecSql.get(canonical) ?? 0) > 0) {\n            throw new Error(\n              \"guardedTransaction cannot nest inside an open transaction\",\n            );\n          }\n\n          transactionDepthByCanonicalExecSql.set(canonical, 1);\n          beginClientSQLiteCommitGuards(canonical);\n          try {\n            await lockedExecSql(transactionBeginStatement(config));\n            const result = await operation(db);\n            if (!canCommit()) {\n              await lockedExecSql(\"ROLLBACK\");\n              resetConnectionSchemaMemo(canonical);\n              return { committed: false, result: null };\n            }\n            // The guard passed in THIS synchronous slice and the COMMIT is\n            // dispatched in the same slice: no JavaScript can run between\n            // the two, so the decision cannot go stale before dispatch. (A\n            // host tearing the connection down concurrently is resolved by\n            // SQLite's own commit atomicity, not by anything client-side.)\n            assertClientSQLiteCommitAllowed(lockedExecSql);\n            const commit = lockedExecSql(\"COMMIT\");\n            await commit;\n            return { committed: true, result };\n          } catch (error: unknown) {\n            await lockedExecSql(\"ROLLBACK\").catch(() => undefined);\n            resetConnectionSchemaMemo(canonical);\n            rethrowClientSQLiteCommitGuardFailure(canonical);\n            throw error;\n          } finally {\n            clearClientSQLiteCommitGuards(canonical);\n            transactionDepthByCanonicalExecSql.delete(canonical);\n          }\n        }),\n      );\n    },\n  };\n\n  runtimeByExecSql.set(execSql, runtime);\n  return runtime;\n}\n\nexport function getClientSQLitePersistenceRuntime(\n  execSql: ExecSql,\n): ClientSQLitePersistenceRuntime {\n  return runtimeByExecSql.get(execSql) ?? createRuntimeForExecSql(execSql);\n}\n\nexport function createClientSQLitePersistenceRuntime(\n  client: ExecSqlClientLike,\n): ClientSQLitePersistenceRuntime {\n  let execSql = execSqlByClient.get(client);\n  if (!execSql) {\n    execSql = createExecSql(client);\n    execSqlByClient.set(client, execSql);\n  }\n\n  return getClientSQLitePersistenceRuntime(execSql);\n}\n"]}
+{"version":3,"file":"sqlitePersistenceRuntime.js","sourceRoot":"","sources":["sqlitePersistenceRuntime.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RemoteCallback,\n  SqliteRemoteDatabase,\n} from \"drizzle-orm/sqlite-proxy\";\nimport { drizzle } from \"drizzle-orm/sqlite-proxy\";\nimport { clientSQLiteSchema } from \"./schema\";\nimport {\n  closeTransactionSchemaMemoScope,\n  openTransactionSchemaMemoScope,\n} from \"./sqlExec\";\nimport {\n  assertClientSQLiteCommitAllowed,\n  beginClientSQLiteCommitGuards,\n  captureClientSQLiteCommitGuards,\n  clearClientSQLiteCommitGuards,\n  rethrowClientSQLiteCommitGuardFailure,\n} from \"./sqliteCommitGuards\";\nimport {\n  createExecSql,\n  type ExecSql,\n  type ExecSqlClientLike,\n  resolveCanonicalExecSql,\n  runSerializedSqlMutation,\n  type SqlArrayRow,\n  type SqlRowValue,\n} from \"./sqlSchema\";\n\nexport type ClientSQLiteSchema = typeof clientSQLiteSchema;\nexport type ClientSQLiteDatabase = SqliteRemoteDatabase<ClientSQLiteSchema>;\nexport type ClientSQLiteTransactionConfig = NonNullable<\n  Parameters<ClientSQLiteDatabase[\"transaction\"]>[1]\n>;\n/**\n * The handle a runtime transaction callback receives: the transaction's\n * query interface WITHOUT `rollback` (throw instead — every scope maps an\n * exception to its own rollback) and WITHOUT `transaction` (nest by calling\n * `runtime.transaction` again, which scopes to a savepoint). Narrowing the\n * contract here is what lets a nested scope share the connection-backed\n * database handle safely.\n */\nexport type ClientSQLiteTransactionScope = Pick<\n  ClientSQLiteDatabase,\n  | \"all\"\n  | \"delete\"\n  | \"get\"\n  | \"insert\"\n  | \"query\"\n  | \"run\"\n  | \"select\"\n  | \"selectDistinct\"\n  | \"update\"\n  | \"values\"\n>;\n\nexport interface ClientSQLitePersistenceRuntime {\n  db: ClientSQLiteDatabase;\n  execSql: ExecSql;\n  runMutation<T>(\n    operation: (db: ClientSQLiteDatabase) => Promise<T> | T,\n  ): Promise<T>;\n  transaction<T>(\n    operation: (tx: ClientSQLiteTransactionScope) => Promise<T>,\n    config?: ClientSQLiteTransactionConfig,\n  ): Promise<T>;\n  /**\n   * A transaction whose commit is gated on a SYNCHRONOUS guard: the guard\n   * runs and — when it passes — the COMMIT is dispatched in the same\n   * synchronous slice, so no JavaScript (an identity replacement included)\n   * can interleave between the decision and the commit dispatch. Resolves\n   * with `committed: false` (all writes rolled back) when the guard refuses.\n   */\n  guardedTransaction<T>(\n    operation: (tx: ClientSQLiteTransactionScope) => Promise<T>,\n    canCommit: () => boolean,\n    config?: ClientSQLiteTransactionConfig,\n  ): Promise<{ committed: boolean; result: T | null }>;\n}\n\nconst runtimeByExecSql = new WeakMap<ExecSql, ClientSQLitePersistenceRuntime>();\n\nfunction transactionBeginStatement(\n  config: ClientSQLiteTransactionConfig | undefined,\n): \"BEGIN\" | \"BEGIN EXCLUSIVE\" | \"BEGIN IMMEDIATE\" {\n  if (config?.behavior === \"immediate\") return \"BEGIN IMMEDIATE\";\n  if (config?.behavior === \"exclusive\") return \"BEGIN EXCLUSIVE\";\n  return \"BEGIN\";\n}\n\n// One transaction depth per underlying connection (canonical executor), so a\n// runtime.transaction call made while another transaction is already open on\n// the same connection degrades to a SAVEPOINT scope instead of issuing a\n// second BEGIN. Callers inside a serialized mutation get separate runtime\n// instances per locked executor, so the depth cannot live on the runtime.\nconst transactionDepthByCanonicalExecSql = new WeakMap<ExecSql, number>();\n// Sibling nested scopes on one connection must not interleave: SQLite\n// savepoints form a stack, so releasing an earlier savepoint would also\n// release a later sibling started concurrently. Scopes serialize per\n// NESTING DEPTH — siblings share a depth and queue behind each other, while\n// a descendant runs one level deeper and must NOT wait on its own enclosing\n// scope (that wait can never resolve).\nconst nestedScopeChainsByCanonicalExecSql = new WeakMap<\n  ExecSql,\n  Map<number, Promise<unknown>>\n>();\nconst execSqlByClient = new WeakMap<ExecSqlClientLike, ExecSql>();\n\nfunction toSqlRowValue(value: unknown): SqlRowValue {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  if (typeof value === \"string\" || typeof value === \"number\") {\n    return value;\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? 1 : 0;\n  }\n\n  throw new Error(`Unsupported SQLite bind value: ${String(value)}`);\n}\n\nfunction createRemoteCallback(getExecSql: () => ExecSql): RemoteCallback {\n  type RemoteResult = Awaited<ReturnType<RemoteCallback>>;\n\n  function getRemoteResult(rows: readonly SqlArrayRow[]): RemoteResult {\n    const row = rows[0];\n    if (row !== undefined) {\n      return { rows: row } satisfies RemoteResult;\n    }\n\n    // Drizzle's RemoteCallback type requires rows, but sqlite-proxy's get()\n    // mapper treats an undefined rows value as \"no row found\".\n    return Object.defineProperty({ rows: [] } satisfies RemoteResult, \"rows\", {\n      enumerable: true,\n      value: undefined,\n    });\n  }\n\n  return async (sql, params, method) => {\n    const execSql = getExecSql();\n    if (sql.trim().toLowerCase() === \"commit\")\n      assertClientSQLiteCommitAllowed(execSql);\n    const rows = await execSql(sql, params.map(toSqlRowValue), {\n      rowMode: \"array\",\n    });\n\n    if (method === \"get\") {\n      return getRemoteResult(rows);\n    }\n\n    return { rows } satisfies RemoteResult;\n  };\n}\n\nfunction createClientSQLiteDatabase(\n  getExecSql: () => ExecSql,\n): ClientSQLiteDatabase {\n  return drizzle(createRemoteCallback(getExecSql), {\n    schema: clientSQLiteSchema,\n  });\n}\n\n// Serialize nested savepoint scopes per connection AND depth: a sibling\n// (same depth) queues behind the previous sibling so their savepoints\n// strictly nest instead of interleaving on the shared stack, while a\n// descendant (called from inside an executing scope, so one level deeper)\n// starts on its own depth's chain and never waits on its unresolved parent.\nasync function runNestedSavepointScope<T>(\n  canonical: ExecSql,\n  lockedExecSql: ExecSql,\n  operation: () => Promise<T>,\n): Promise<T> {\n  const depthAtEntry = transactionDepthByCanonicalExecSql.get(canonical) ?? 0;\n  const chains =\n    nestedScopeChainsByCanonicalExecSql.get(canonical) ??\n    new Map<number, Promise<unknown>>();\n  nestedScopeChainsByCanonicalExecSql.set(canonical, chains);\n  const previous = chains.get(depthAtEntry) ?? Promise.resolve();\n  let tracked: Promise<unknown> = Promise.resolve();\n  const scope = previous\n    .catch(() => undefined)\n    .then(async () => {\n      const depth = transactionDepthByCanonicalExecSql.get(canonical) ?? 0;\n      transactionDepthByCanonicalExecSql.set(canonical, depth + 1);\n      const savepoint = `runtime_transaction_sp_${depth}`;\n      const discardNestedGuards = captureClientSQLiteCommitGuards(canonical);\n      openTransactionSchemaMemoScope(canonical);\n      let released = false;\n      try {\n        await lockedExecSql(`SAVEPOINT ${savepoint}`);\n        const result = await operation();\n        await lockedExecSql(`RELEASE SAVEPOINT ${savepoint}`);\n        released = true;\n        return result;\n      } catch (error: unknown) {\n        await lockedExecSql(`ROLLBACK TO SAVEPOINT ${savepoint}`).then(\n          discardNestedGuards,\n          () => undefined,\n        );\n        await lockedExecSql(`RELEASE SAVEPOINT ${savepoint}`).catch(\n          () => undefined,\n        );\n        throw error;\n      } finally {\n        // The savepoint's rollback undid only the schema it first ensured.\n        closeTransactionSchemaMemoScope(canonical, released);\n        transactionDepthByCanonicalExecSql.set(canonical, depth);\n        if (chains.get(depthAtEntry) === tracked) {\n          chains.delete(depthAtEntry);\n        }\n      }\n    });\n  tracked = scope.catch(() => undefined);\n  chains.set(depthAtEntry, tracked);\n  return scope;\n}\n\nfunction createRuntimeForExecSql(\n  execSql: ExecSql,\n): ClientSQLitePersistenceRuntime {\n  let activeExecSql = execSql;\n  const db = createClientSQLiteDatabase(() => activeExecSql);\n\n  async function withActiveExecSql<T>(\n    nextExecSql: ExecSql,\n    operation: () => Promise<T> | T,\n  ): Promise<T> {\n    const previousExecSql = activeExecSql;\n    activeExecSql = nextExecSql;\n\n    try {\n      return await operation();\n    } finally {\n      activeExecSql = previousExecSql;\n    }\n  }\n\n  const runtime: ClientSQLitePersistenceRuntime = {\n    db,\n    execSql,\n    runMutation(operation) {\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n        withActiveExecSql(lockedExecSql, () => operation(db)),\n      );\n    },\n    transaction(operation, config) {\n      // A caller already inside an open transaction on this connection MUST\n      // reach us through the transaction's locked executor (the runtime that\n      // executor resolves to detects the open transaction below and joins it\n      // as a savepoint scope). Re-entering through the canonical executor\n      // queues here for full isolation — the contract every persistence\n      // helper follows by passing its received locked executor down.\n      const canonical = resolveCanonicalExecSql(execSql);\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n        withActiveExecSql(lockedExecSql, async () => {\n          if ((transactionDepthByCanonicalExecSql.get(canonical) ?? 0) > 0) {\n            return runNestedSavepointScope(canonical, lockedExecSql, () =>\n              operation(db),\n            );\n          }\n\n          transactionDepthByCanonicalExecSql.set(canonical, 1);\n          beginClientSQLiteCommitGuards(canonical);\n          openTransactionSchemaMemoScope(canonical);\n          let committed = false;\n          try {\n            const result = await db.transaction(operation, config);\n            committed = true;\n            return result;\n          } catch (error: unknown) {\n            rethrowClientSQLiteCommitGuardFailure(canonical);\n            throw error;\n          } finally {\n            // A rollback forgets the ensures it undid (see sqlExec).\n            closeTransactionSchemaMemoScope(canonical, committed);\n            clearClientSQLiteCommitGuards(canonical);\n            transactionDepthByCanonicalExecSql.delete(canonical);\n          }\n        }),\n      );\n    },\n    guardedTransaction(operation, canCommit, config) {\n      return runSerializedSqlMutation(execSql, async (lockedExecSql) =>\n        withActiveExecSql(lockedExecSql, async () => {\n          const canonical = resolveCanonicalExecSql(execSql);\n          if ((transactionDepthByCanonicalExecSql.get(canonical) ?? 0) > 0) {\n            throw new Error(\n              \"guardedTransaction cannot nest inside an open transaction\",\n            );\n          }\n\n          transactionDepthByCanonicalExecSql.set(canonical, 1);\n          beginClientSQLiteCommitGuards(canonical);\n          openTransactionSchemaMemoScope(canonical);\n          let committed = false;\n          try {\n            await lockedExecSql(transactionBeginStatement(config));\n            const result = await operation(db);\n            if (!canCommit()) {\n              await lockedExecSql(\"ROLLBACK\");\n              return { committed: false, result: null };\n            }\n            // The guard passed in THIS synchronous slice and the COMMIT is\n            // dispatched in the same slice: no JavaScript can run between\n            // the two, so the decision cannot go stale before dispatch. (A\n            // host tearing the connection down concurrently is resolved by\n            // SQLite's own commit atomicity, not by anything client-side.)\n            assertClientSQLiteCommitAllowed(lockedExecSql);\n            const commit = lockedExecSql(\"COMMIT\");\n            await commit;\n            committed = true;\n            return { committed: true, result };\n          } catch (error: unknown) {\n            await lockedExecSql(\"ROLLBACK\").catch(() => undefined);\n            rethrowClientSQLiteCommitGuardFailure(canonical);\n            throw error;\n          } finally {\n            closeTransactionSchemaMemoScope(canonical, committed);\n            clearClientSQLiteCommitGuards(canonical);\n            transactionDepthByCanonicalExecSql.delete(canonical);\n          }\n        }),\n      );\n    },\n  };\n\n  runtimeByExecSql.set(execSql, runtime);\n  return runtime;\n}\n\nexport function getClientSQLitePersistenceRuntime(\n  execSql: ExecSql,\n): ClientSQLitePersistenceRuntime {\n  return runtimeByExecSql.get(execSql) ?? createRuntimeForExecSql(execSql);\n}\n\nexport function createClientSQLitePersistenceRuntime(\n  client: ExecSqlClientLike,\n): ClientSQLitePersistenceRuntime {\n  let execSql = execSqlByClient.get(client);\n  if (!execSql) {\n    execSql = createExecSql(client);\n    execSqlByClient.set(client, execSql);\n  }\n\n  return getClientSQLitePersistenceRuntime(execSql);\n}\n"]}

package/internal/api-client/ApiClient.d.ts

@@ -11,7 +11,7 @@ import { type UploadMultipartBlobPartBytesRequest } from "./routes/blobs/get.js"
 import { type ContainerKekLogOptions } from "./routes/containers/reads.js";
 import { type DocumentPurgeProofOptions } from "./routes/documents/mutations.js";
 import type { HttpMethod, ListDocumentEditAttributionRangesOptions, RequestResult, RequestResultOptions } from "./types.js";
-import type { VerifiedManifestCitations } from "./verifiedManifestCitations.js";
+import type { VerifiedManifestCitations, WriterProjectionListing } from "./verifiedManifestCitations.js";
 type ExpiredHandler = () => boolean | Promise<boolean>;
 type PaymentRequiredHandler = (organizationId: string | null) => void;
 export declare class ApiClient {
@@ -2827,7 +2827,8 @@ export declare class ApiClient {
         } | undefined;
     } | null>;
     createDocumentResult(input: DocumentCreateRequest, options?: RequestResultOptions): Promise<RequestResult<DocumentCreateResponse>>;
-    getContainerWriterProjection(containerId: string): Promise<{
+    /** `listing` only picks which held bytes an unstored container cites. */
+    getContainerWriterProjection(containerId: string, listing?: WriterProjectionListing): Promise<{
         policyEvidence: {
             organization: {
                 head: {

package/internal/api-client/ApiClient.js

@@ -435,8 +435,9 @@ export class ApiClient {
     createDocumentResult(input, options = {}) {
         return this.requestResult(documentCreate.path, documentCreate.isResponse, documentCreate.method, JSON.stringify(input), options, createDocumentOperation);
     }
-    getContainerWriterProjection(containerId) {
-        return cachedRequest(this.containerWriterProjectionRequestsByContainerId, containerId, () => this.request(containerWriterProjection.path(containerId), containerWriterProjection.isResponseFor(containerId), containerWriterProjection.method, undefined, undefined, getContainerWriterProjectionOperation));
+    /** `listing` only picks which held bytes an unstored container cites. */
+    getContainerWriterProjection(containerId, listing) {
+        return cachedRequest(this.containerWriterProjectionRequestsByContainerId, containerId, () => this.request(containerWriterProjection.path(containerId), containerWriterProjection.isResponseFor(containerId), containerWriterProjection.method, undefined, listing ? { projectionListing: listing } : undefined, getContainerWriterProjectionOperation));
     }
     getContainerReplacementAuthorizationsResult(containerId, replacesOrganizationId) {
         return this.transport.requestResult(getContainerReplacementAuthorizationsOperation, { params: { containerId, replacesOrganizationId } }, { reportErrors: false });