@rocicorp/zero 1.3.0-canary.2 → 1.3.0-canary.3

package/out/zero-cache/src/services/replicator/write-worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-worker.js","names":[],"sources":["../../../../../../zero-cache/src/services/replicator/write-worker.ts"],"sourcesContent":["import {parentPort} from 'node:worker_threads';\nimport type {LogContext} from '@rocicorp/logger';\nimport type {LogConfig} from '../../../../shared/src/logging.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport {Database} from '../../../../zqlite/src/db.ts';\nimport {StatementRunner} from '../../db/statements.ts';\nimport {createLogContext} from '../../server/logging.ts';\nimport type {ChangeStreamData} from '../change-source/protocol/current/downstream.ts';\nimport {ChangeProcessor, type ChangeProcessorMode} from './change-processor.ts';\nimport {getSubscriptionState} from './schema/replication-state.ts';\nimport {\n  applyPragmas,\n  type ArgsMap,\n  type Method,\n  type PragmaConfig,\n  type Request,\n  type Response,\n  type ResultMap,\n  type WriteError,\n} from './write-worker-client.ts';\n\nif (!parentPort) {\n  throw new Error('write-worker must be run as a worker thread');\n}\n\nconst port = parentPort;\n\ntype API = {[M in Method]: (...args: ArgsMap[M]) => ResultMap[M]};\n\nfunction createAPI(): API {\n  let db: Database | undefined;\n  let runner: StatementRunner | undefined;\n  let processor: ChangeProcessor | undefined;\n  let mode: ChangeProcessorMode | undefined;\n  let lc: LogContext | undefined;\n\n  function createProcessor() {\n    processor = new ChangeProcessor(must(runner), must(mode), (_lc, err) => {\n      port.postMessage({\n        writeError: err instanceof Error ? err : new Error(String(err)),\n      } satisfies WriteError);\n    });\n  }\n\n  return {\n    init(\n      dbPath: string,\n      cpMode: ChangeProcessorMode,\n      pragmas: PragmaConfig,\n      logConfig: LogConfig,\n    ) {\n      lc = createLogContext({log: logConfig}, {worker: 'write-worker'});\n      db = new Database(lc, dbPath);\n      applyPragmas(db, pragmas);\n      runner = new StatementRunner(db);\n      mode = cpMode;\n      createProcessor();\n    },\n\n    getSubscriptionState() {\n      return getSubscriptionState(must(runner));\n    },\n\n    processMessage(downstream: ChangeStreamData) {\n      return must(processor).processMessage(must(lc), downstream);\n    },\n\n    abort() {\n      must(processor).abort(must(lc));\n      createProcessor();\n    },\n\n    stop() {\n      db?.close();\n      db = undefined;\n      runner = undefined;\n      processor = undefined;\n    },\n  };\n}\n\nconst api = createAPI();\n\nport.on('message', (msg: Request) => {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- TS can't narrow msg.method + msg.args together\n    const result = (api[msg.method] as (...args: any[]) => unknown)(\n      ...msg.args,\n    );\n    // abort is fire-and-forget — no pending slot on the client side.\n    if (msg.method !== 'abort') {\n      port.postMessage({method: msg.method, result} as Response);\n    }\n  } catch (e) {\n    if (msg.method !== 'abort') {\n      port.postMessage({method: msg.method, error: e} as Response);\n    }\n  }\n});\n"],"mappings":";;;;;;;;;AAqBA,IAAI,CAAC,WACH,OAAM,IAAI,MAAM,8CAA8C;AAGhE,IAAM,OAAO;AAIb,SAAS,YAAiB;CACxB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,SAAS,kBAAkB;AACzB,cAAY,IAAI,gBAAgB,KAAK,OAAO,EAAE,KAAK,KAAK,GAAG,KAAK,QAAQ;AACtE,QAAK,YAAY,EACf,YAAY,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,EAChE,CAAsB;IACvB;;AAGJ,QAAO;EACL,KACE,QACA,QACA,SACA,WACA;AACA,QAAK,iBAAiB,EAAC,KAAK,WAAU,EAAE,EAAC,QAAQ,gBAAe,CAAC;AACjE,QAAK,IAAI,SAAS,IAAI,OAAO;AAC7B,gBAAa,IAAI,QAAQ;AACzB,YAAS,IAAI,gBAAgB,GAAG;AAChC,UAAO;AACP,oBAAiB;;EAGnB,uBAAuB;AACrB,UAAO,qBAAqB,KAAK,OAAO,CAAC;;EAG3C,eAAe,YAA8B;AAC3C,UAAO,KAAK,UAAU,CAAC,eAAe,KAAK,GAAG,EAAE,WAAW;;EAG7D,QAAQ;AACN,QAAK,UAAU,CAAC,MAAM,KAAK,GAAG,CAAC;AAC/B,oBAAiB;;EAGnB,OAAO;AACL,OAAI,OAAO;AACX,QAAK,KAAA;AACL,YAAS,KAAA;AACT,eAAY,KAAA;;EAEf;;AAGH,IAAM,MAAM,WAAW;AAEvB,KAAK,GAAG,YAAY,QAAiB;AACnC,KAAI;EAEF,MAAM,SAAU,IAAI,IAAI,QACtB,GAAG,IAAI,KACR;AAED,MAAI,IAAI,WAAW,QACjB,MAAK,YAAY;GAAC,QAAQ,IAAI;GAAQ;GAAO,CAAa;UAErD,GAAG;AACV,MAAI,IAAI,WAAW,QACjB,MAAK,YAAY;GAAC,QAAQ,IAAI;GAAQ,OAAO;GAAE,CAAa;;EAGhE"}
+{"version":3,"file":"write-worker.js","names":[],"sources":["../../../../../../zero-cache/src/services/replicator/write-worker.ts"],"sourcesContent":["import {parentPort} from 'node:worker_threads';\nimport type {LogContext} from '@rocicorp/logger';\nimport type {LogConfig} from '../../../../shared/src/logging.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport {Database} from '../../../../zqlite/src/db.ts';\nimport {StatementRunner} from '../../db/statements.ts';\nimport {createLogContext} from '../../server/logging.ts';\nimport type {ChangeStreamData} from '../change-source/protocol/current/downstream.ts';\nimport {ChangeProcessor, type ChangeProcessorMode} from './change-processor.ts';\nimport {getSubscriptionState} from './schema/replication-state.ts';\nimport {\n  applyPragmas,\n  type ArgsMap,\n  type Method,\n  type PragmaConfig,\n  type Request,\n  type Response,\n  type ResultMap,\n  type WriteError,\n} from './write-worker-client.ts';\n\nif (!parentPort) {\n  throw new Error('write-worker must be run as a worker thread');\n}\n\nconst port = parentPort;\n\ntype API = {[M in Method]: (...args: ArgsMap[M]) => ResultMap[M]};\n\nfunction createAPI(): API {\n  let db: Database | undefined;\n  let runner: StatementRunner | undefined;\n  let processor: ChangeProcessor | undefined;\n  let mode: ChangeProcessorMode | undefined;\n  let lc: LogContext | undefined;\n\n  function createProcessor() {\n    processor = new ChangeProcessor(must(runner), must(mode), (_lc, err) => {\n      port.postMessage({\n        writeError: err instanceof Error ? err : new Error(String(err)),\n      } satisfies WriteError);\n    });\n  }\n\n  return {\n    init(\n      dbPath: string,\n      cpMode: ChangeProcessorMode,\n      pragmas: PragmaConfig,\n      logConfig: LogConfig,\n    ) {\n      lc = createLogContext({log: logConfig}, 'write-worker');\n      db = new Database(lc, dbPath);\n      applyPragmas(db, pragmas);\n      runner = new StatementRunner(db);\n      mode = cpMode;\n      createProcessor();\n    },\n\n    getSubscriptionState() {\n      return getSubscriptionState(must(runner));\n    },\n\n    processMessage(downstream: ChangeStreamData) {\n      return must(processor).processMessage(must(lc), downstream);\n    },\n\n    abort() {\n      must(processor).abort(must(lc));\n      createProcessor();\n    },\n\n    stop() {\n      db?.close();\n      db = undefined;\n      runner = undefined;\n      processor = undefined;\n    },\n  };\n}\n\nconst api = createAPI();\n\nport.on('message', (msg: Request) => {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- TS can't narrow msg.method + msg.args together\n    const result = (api[msg.method] as (...args: any[]) => unknown)(\n      ...msg.args,\n    );\n    // abort is fire-and-forget — no pending slot on the client side.\n    if (msg.method !== 'abort') {\n      port.postMessage({method: msg.method, result} as Response);\n    }\n  } catch (e) {\n    if (msg.method !== 'abort') {\n      port.postMessage({method: msg.method, error: e} as Response);\n    }\n  }\n});\n"],"mappings":";;;;;;;;;AAqBA,IAAI,CAAC,WACH,OAAM,IAAI,MAAM,8CAA8C;AAGhE,IAAM,OAAO;AAIb,SAAS,YAAiB;CACxB,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,SAAS,kBAAkB;AACzB,cAAY,IAAI,gBAAgB,KAAK,OAAO,EAAE,KAAK,KAAK,GAAG,KAAK,QAAQ;AACtE,QAAK,YAAY,EACf,YAAY,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,EAChE,CAAsB;IACvB;;AAGJ,QAAO;EACL,KACE,QACA,QACA,SACA,WACA;AACA,QAAK,iBAAiB,EAAC,KAAK,WAAU,EAAE,eAAe;AACvD,QAAK,IAAI,SAAS,IAAI,OAAO;AAC7B,gBAAa,IAAI,QAAQ;AACzB,YAAS,IAAI,gBAAgB,GAAG;AAChC,UAAO;AACP,oBAAiB;;EAGnB,uBAAuB;AACrB,UAAO,qBAAqB,KAAK,OAAO,CAAC;;EAG3C,eAAe,YAA8B;AAC3C,UAAO,KAAK,UAAU,CAAC,eAAe,KAAK,GAAG,EAAE,WAAW;;EAG7D,QAAQ;AACN,QAAK,UAAU,CAAC,MAAM,KAAK,GAAG,CAAC;AAC/B,oBAAiB;;EAGnB,OAAO;AACL,OAAI,OAAO;AACX,QAAK,KAAA;AACL,YAAS,KAAA;AACT,eAAY,KAAA;;EAEf;;AAGH,IAAM,MAAM,WAAW;AAEvB,KAAK,GAAG,YAAY,QAAiB;AACnC,KAAI;EAEF,MAAM,SAAU,IAAI,IAAI,QACtB,GAAG,IAAI,KACR;AAED,MAAI,IAAI,WAAW,QACjB,MAAK,YAAY;GAAC,QAAQ,IAAI;GAAQ;GAAO,CAAa;UAErD,GAAG;AACV,MAAI,IAAI,WAAW,QACjB,MAAK,YAAY;GAAC,QAAQ,IAAI;GAAQ,OAAO;GAAE,CAAa;;EAGhE"}

package/out/zero-cache/src/services/view-syncer/cvr-store.js

@@ -363,7 +363,7 @@ var CVRStore = class {
 		const start = afterVersion ? versionString(afterVersion) : "";
 		const end = versionString(upToCVR.version);
 		lc.debug?.(`scanning config patches for clients from ${start}`);
-		const reader = new TransactionPool(lc, READONLY).run(this.#db);
+		const reader = new TransactionPool(lc, { mode: READONLY }).run(this.#db);
 		try {
 			await reader.processReadTask((tx) => checkVersion(tx, this.#schema, this.#id, current));
 			const [allDesires, queryRows] = await reader.processReadTask((tx) => Promise.all([tx`
@@ -724,7 +724,7 @@ var CVRStore = class {
 	async inspectQueries(lc, ttlClock, clientID) {
 		const db = this.#db;
 		const clientGroupID = this.#id;
-		const reader = new TransactionPool(lc, READONLY).run(db);
+		const reader = new TransactionPool(lc, { mode: READONLY }).run(db);
 		try {
 			return await reader.processReadTask((tx) => tx`
   SELECT DISTINCT ON (d."clientID", d."queryHash")

package/out/zero-cache/src/services/view-syncer/cvr-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"cvr-store.js","names":["#schema","#taskID","#id","#failService","#db","#writes","#pendingRowRecordUpdates","#forceUpdates","#rowCache","#loadAttemptIntervalMs","#maxLoadAttempts","#pendingQueryUpdates","#pendingDesireUpdates","#pendingQueryPartialUpdates","#load","#cvr","#pendingInstanceWrite","#updateQueryFields","#checkVersionAndOwnership","#flush","#rowCount","#flushDesires","#flushQueries"],"sources":["../../../../../../zero-cache/src/services/view-syncer/cvr-store.ts"],"sourcesContent":["import {trace} from '@opentelemetry/api';\nimport type {LogContext} from '@rocicorp/logger';\nimport type {MaybeRow, PendingQuery, Row} from 'postgres';\nimport {startAsyncSpan} from '../../../../otel/src/span.ts';\nimport {version} from '../../../../otel/src/version.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport {CustomKeyMap} from '../../../../shared/src/custom-key-map.ts';\nimport {CustomKeySet} from '../../../../shared/src/custom-key-set.ts';\nimport {\n  deepEqual,\n  type ReadonlyJSONValue,\n} from '../../../../shared/src/json.ts';\nimport {sleep} from '../../../../shared/src/sleep.ts';\nimport * as v from '../../../../shared/src/valita.ts';\nimport {astSchema} from '../../../../zero-protocol/src/ast.ts';\nimport {clientSchemaSchema} from '../../../../zero-protocol/src/client-schema.ts';\nimport {ErrorKind} from '../../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../../zero-protocol/src/error-origin.ts';\nimport type {InspectQueryRow} from '../../../../zero-protocol/src/inspect-down.ts';\nimport {clampTTL, DEFAULT_TTL_MS} from '../../../../zql/src/query/ttl.ts';\nimport * as Mode from '../../db/mode-enum.ts';\nimport {runTx} from '../../db/run-transaction.ts';\nimport {TransactionPool} from '../../db/transaction-pool.ts';\nimport {recordRowsSynced} from '../../server/anonymous-otel-start.ts';\nimport {ProtocolErrorWithLevel} from '../../types/error-with-level.ts';\nimport type {PostgresDB, PostgresTransaction} from '../../types/pg.ts';\nimport {rowIDString} from '../../types/row-key.ts';\nimport {cvrSchema, type ShardID} from '../../types/shards.ts';\nimport type {Patch, PatchToVersion} from './client-handler.ts';\nimport type {CVR, CVRSnapshot} from './cvr.ts';\nimport {RowRecordCache} from './row-record-cache.ts';\nimport {\n  type ClientsRow,\n  type DesiresRow,\n  type InstancesRow,\n  type QueriesRow,\n  type RowsRow,\n} from './schema/cvr.ts';\nimport {\n  type ClientQueryRecord,\n  type ClientRecord,\n  cmpVersions,\n  type CustomQueryRecord,\n  type CVRVersion,\n  EMPTY_CVR_VERSION,\n  type InternalQueryRecord,\n  type NullableCVRVersion,\n  type QueryPatch,\n  type QueryRecord,\n  queryRecordToQueryRow,\n  type RowID,\n  type RowRecord,\n  versionFromString,\n  versionString,\n} from './schema/types.ts';\nimport {\n  type TTLClock,\n  ttlClockAsNumber,\n  ttlClockFromNumber,\n} from './ttl-clock.ts';\n\nexport type CVRFlushStats = {\n  instances: number;\n  queries: number;\n  desires: number;\n  clients: number;\n  rows: number;\n  rowsDeferred: number;\n  statements: number;\n};\n\nlet flushCounter = 0;\n\n/**\n * Convert TTL/timestamp values for both old (seconds-based) and new (ms-based) columns.\n * Old columns: inactivatedAt (TIMESTAMPTZ), ttl (INTERVAL) - need conversion ms->seconds\n * New columns: inactivatedAtMs (DOUBLE PRECISION), ttlMs (DOUBLE PRECISION) - store ms directly\n */\nfunction convertTTLValues(\n  inactivatedAt: TTLClock | undefined,\n  ttl: number,\n): {\n  ttlInterval: number | null;\n  ttlMs: number | null;\n  inactivatedAtTimestamp: TTLClock | null;\n  inactivatedAtMs: TTLClock | null;\n} {\n  return {\n    ttlInterval: ttl < 0 ? null : ttl / 1000, // INTERVAL needs seconds\n    ttlMs: ttl < 0 ? null : ttl, // New column stores ms directly\n    inactivatedAtTimestamp:\n      inactivatedAt === undefined\n        ? null\n        : ttlClockFromNumber(ttlClockAsNumber(inactivatedAt) / 1000),\n    inactivatedAtMs: inactivatedAt ?? null,\n  };\n}\n\nconst tracer = trace.getTracer('cvr-store', version);\n\n/**\n * QueriesRow with queryArgs as a stringified JSON value.\n * Used for batched config writes where queryArgs are pre-stringified\n * to handle the postgres.js boolean array bug.\n */\ntype StringifiedQueriesRow = Omit<QueriesRow, 'queryArgs'> & {\n  queryArgs: string | null;\n};\n\nfunction asQuery(row: QueriesRow): QueryRecord {\n  const maybeVersion = (s: string | null) =>\n    s === null ? undefined : versionFromString(s);\n\n  if (row.clientAST === null) {\n    // custom query\n    assert(\n      row.queryName !== null && row.queryArgs !== null,\n      'queryName and queryArgs must be set for custom queries',\n    );\n    return {\n      type: 'custom',\n      id: row.queryHash,\n      name: row.queryName,\n      args: row.queryArgs,\n      patchVersion: maybeVersion(row.patchVersion),\n      clientState: {},\n      transformationHash: row.transformationHash ?? undefined,\n      transformationVersion: maybeVersion(row.transformationVersion),\n    } satisfies CustomQueryRecord;\n  }\n\n  const ast = astSchema.parse(row.clientAST);\n  return row.internal\n    ? ({\n        type: 'internal',\n        id: row.queryHash,\n        ast,\n        transformationHash: row.transformationHash ?? undefined,\n        transformationVersion: maybeVersion(row.transformationVersion),\n      } satisfies InternalQueryRecord)\n    : ({\n        type: 'client',\n        id: row.queryHash,\n        ast,\n        patchVersion: maybeVersion(row.patchVersion),\n        clientState: {},\n        transformationHash: row.transformationHash ?? undefined,\n        transformationVersion: maybeVersion(row.transformationVersion),\n      } satisfies ClientQueryRecord);\n}\n\n// The time to wait between load attempts.\nconst LOAD_ATTEMPT_INTERVAL_MS = 500;\n// The maximum number of load() attempts if the rowsVersion is behind.\n// This currently results in a maximum catchup time of ~5 seconds, after\n// which we give up and consider the CVR invalid.\n//\n// TODO: Make this configurable with something like --max-catchup-wait-ms,\n//       as it is technically application specific.\nconst MAX_LOAD_ATTEMPTS = 10;\n\nexport class CVRStore {\n  readonly #schema: string;\n  readonly #taskID: string;\n  readonly #id: string;\n  readonly #failService: (e: unknown) => void;\n  readonly #db: PostgresDB;\n  readonly #writes: Set<{\n    stats: Partial<CVRFlushStats>;\n    write: (\n      tx: PostgresTransaction,\n      lastConnectTime: number,\n    ) => PendingQuery<MaybeRow[]>;\n  }> = new Set();\n  // Stored separately so repeated putInstance() calls (e.g. setClientSchema,\n  // setProfileID, and the final call in #flush) replace each other rather than\n  // accumulating as independent statements in #writes.\n  #pendingInstanceWrite:\n    | ((\n        tx: PostgresTransaction,\n        lastConnectTime: number,\n      ) => PendingQuery<MaybeRow[]>)\n    | undefined = undefined;\n  readonly #pendingRowRecordUpdates = new CustomKeyMap<RowID, RowRecord | null>(\n    rowIDString,\n  );\n  readonly #forceUpdates = new CustomKeySet<RowID>(rowIDString);\n  readonly #rowCache: RowRecordCache;\n  readonly #loadAttemptIntervalMs: number;\n  readonly #maxLoadAttempts: number;\n  #rowCount: number = 0;\n  readonly #pendingQueryUpdates = new Map<string, StringifiedQueriesRow>();\n  readonly #pendingDesireUpdates = new Map<string, DesiresRow>();\n  readonly #pendingQueryPartialUpdates = new Map<string, Partial<QueriesRow>>();\n\n  constructor(\n    lc: LogContext,\n    cvrDb: PostgresDB,\n    shard: ShardID,\n    taskID: string,\n    cvrID: string,\n    failService: (e: unknown) => void,\n    loadAttemptIntervalMs = LOAD_ATTEMPT_INTERVAL_MS,\n    maxLoadAttempts = MAX_LOAD_ATTEMPTS,\n    deferredRowFlushThreshold = 100, // somewhat arbitrary\n    setTimeoutFn = setTimeout,\n  ) {\n    this.#failService = failService;\n    this.#db = cvrDb;\n    this.#schema = cvrSchema(shard);\n    this.#taskID = taskID;\n    this.#id = cvrID;\n    this.#rowCache = new RowRecordCache(\n      lc,\n      cvrDb,\n      shard,\n      cvrID,\n      failService,\n      deferredRowFlushThreshold,\n      setTimeoutFn,\n    );\n    this.#loadAttemptIntervalMs = loadAttemptIntervalMs;\n    this.#maxLoadAttempts = maxLoadAttempts;\n  }\n\n  #cvr(table: string) {\n    return this.#db(`${this.#schema}.${table}`);\n  }\n\n  #updateQueryFields(queryHash: string, fields: Partial<QueriesRow>): void {\n    // Track as partial-only update for batched flush\n    this.#pendingQueryPartialUpdates.set(queryHash, fields);\n  }\n\n  load(lc: LogContext, lastConnectTime: number): Promise<CVR> {\n    return startAsyncSpan(tracer, 'cvr.load', async () => {\n      let err: RowsVersionBehindError | undefined;\n      for (let i = 0; i < this.#maxLoadAttempts; i++) {\n        if (i > 0) {\n          await sleep(this.#loadAttemptIntervalMs);\n        }\n        const result = await this.#load(lc, lastConnectTime);\n        if (result instanceof RowsVersionBehindError) {\n          lc.info?.(`attempt ${i + 1}: ${String(result)}`);\n          err = result;\n          continue;\n        }\n        return result;\n      }\n      assert(err, 'Expected error to be set after retry loop exhausted');\n      throw new ClientNotFoundError(\n        `max attempts exceeded waiting for CVR@${err.cvrVersion} to catch up from ${err.rowsVersion}`,\n      );\n    });\n  }\n\n  async #load(\n    lc: LogContext,\n    lastConnectTime: number,\n  ): Promise<CVR | RowsVersionBehindError> {\n    const start = Date.now();\n\n    const id = this.#id;\n    const cvr: CVR = {\n      id,\n      version: EMPTY_CVR_VERSION,\n      lastActive: 0,\n      ttlClock: ttlClockFromNumber(0), // TTL clock starts at 0, not Date.now()\n      replicaVersion: null,\n      clients: {},\n      queries: {},\n      clientSchema: null,\n      profileID: null,\n    };\n\n    const [instance, clientsRows, queryRows, desiresRows] = await runTx(\n      this.#db,\n      tx => {\n        lc.debug?.(`CVR tx started after ${Date.now() - start} ms`);\n        return [\n          tx<\n            (Omit<InstancesRow, 'clientGroupID'> & {\n              profileID: string | null;\n              deleted: boolean;\n              rowsVersion: string | null;\n            })[]\n          >`SELECT cvr.\"version\",\n                 \"lastActive\",\n                 \"ttlClock\",\n                 \"replicaVersion\",\n                 \"owner\",\n                 \"grantedAt\",\n                 \"clientSchema\",\n                 \"profileID\",\n                 \"deleted\",\n                 rows.\"version\" as \"rowsVersion\"\n            FROM ${this.#cvr('instances')} AS cvr\n            LEFT JOIN ${this.#cvr('rowsVersion')} AS rows\n            ON cvr.\"clientGroupID\" = rows.\"clientGroupID\"\n            WHERE cvr.\"clientGroupID\" = ${id}`,\n          tx<Pick<ClientsRow, 'clientID'>[]>`SELECT \"clientID\" FROM ${this.#cvr(\n            'clients',\n          )}\n           WHERE \"clientGroupID\" = ${id}`,\n          tx<QueriesRow[]>`SELECT * FROM ${this.#cvr('queries')}\n          WHERE \"clientGroupID\" = ${id} AND deleted IS DISTINCT FROM true`,\n          tx<DesiresRow[]>`SELECT\n          \"clientGroupID\",\n          \"clientID\",\n          \"queryHash\",\n          \"patchVersion\",\n          \"deleted\",\n          \"ttlMs\" AS \"ttl\",\n          \"inactivatedAtMs\" AS \"inactivatedAt\"\n          FROM ${this.#cvr('desires')}\n          WHERE \"clientGroupID\" = ${id}`,\n        ];\n      },\n      {mode: Mode.READONLY},\n    );\n    lc.debug?.(\n      `CVR tx completed after ${Date.now() - start} ms ` +\n        `(${clientsRows.length} clients, ${queryRows.length} queries, ${desiresRows.length} desires)`,\n    );\n\n    if (instance.length === 0) {\n      // This is the first time we see this CVR.\n      this.putInstance({\n        version: cvr.version,\n        lastActive: 0,\n        ttlClock: ttlClockFromNumber(0), // TTL clock starts at 0 for new instances\n        replicaVersion: null,\n        clientSchema: null,\n        profileID: null,\n      });\n    } else {\n      assert(\n        instance.length === 1,\n        () => `Expected exactly one CVR instance, got ${instance.length}`,\n      );\n      const {\n        version,\n        lastActive,\n        ttlClock,\n        replicaVersion,\n        owner,\n        grantedAt,\n        rowsVersion,\n        clientSchema,\n        profileID,\n        deleted,\n      } = instance[0];\n\n      if (deleted) {\n        throw new ClientNotFoundError(\n          'Client has been purged due to inactivity',\n        );\n      }\n\n      if (owner !== this.#taskID) {\n        if ((grantedAt ?? 0) > lastConnectTime) {\n          throw new OwnershipError(owner, grantedAt, lastConnectTime);\n        } else {\n          // Fire-and-forget an ownership change to signal the current owner.\n          // Note that the query is structured such that it only succeeds in the\n          // correct conditions (i.e. gated on `grantedAt`).\n          void this.#db`\n            UPDATE ${this.#cvr('instances')} \n              SET \"owner\"     = ${this.#taskID}, \n                  \"grantedAt\" = ${lastConnectTime}\n              WHERE \"clientGroupID\" = ${this.#id} AND\n                    (\"grantedAt\" IS NULL OR\n                     \"grantedAt\" <= to_timestamp(${lastConnectTime / 1000}))\n        `\n            .execute()\n            .catch(this.#failService);\n        }\n      }\n\n      if (version !== (rowsVersion ?? EMPTY_CVR_VERSION.stateVersion)) {\n        // This will cause the load() method to wait for row catchup and retry.\n        // Assuming the ownership signal succeeds, the current owner will stop\n        // modifying the CVR and flush its pending row changes.\n        return new RowsVersionBehindError(version, rowsVersion);\n      }\n\n      cvr.version = versionFromString(version);\n      cvr.lastActive = lastActive;\n      cvr.ttlClock = ttlClock;\n      cvr.replicaVersion = replicaVersion;\n      cvr.profileID = profileID;\n\n      try {\n        cvr.clientSchema =\n          clientSchema === null\n            ? null\n            : v.parse(clientSchema, clientSchemaSchema);\n      } catch (e) {\n        throw new InvalidClientSchemaError(e);\n      }\n    }\n\n    for (const row of clientsRows) {\n      cvr.clients[row.clientID] = {\n        id: row.clientID,\n        desiredQueryIDs: [],\n      };\n    }\n\n    for (const row of queryRows) {\n      const query = asQuery(row);\n      cvr.queries[row.queryHash] = query;\n    }\n\n    for (const row of desiresRows) {\n      const client = cvr.clients[row.clientID];\n      // Note: row.inactivatedAt is mapped from inactivatedAtMs in the SQL query\n      if (!row.deleted && row.inactivatedAt === null) {\n        if (client) {\n          client.desiredQueryIDs.push(row.queryHash);\n        } else {\n          // This can happen if the client was deleted but the queries are still alive.\n          lc.debug?.(\n            `Not adding to desiredQueryIDs for client ${row.clientID} because it has been deleted.`,\n          );\n        }\n      }\n\n      const query = cvr.queries[row.queryHash];\n      if (\n        query &&\n        query.type !== 'internal' &&\n        (!row.deleted || row.inactivatedAt !== null)\n      ) {\n        query.clientState[row.clientID] = {\n          inactivatedAt: row.inactivatedAt ?? undefined,\n          ttl: clampTTL(row.ttl ?? DEFAULT_TTL_MS),\n          version: versionFromString(row.patchVersion),\n        };\n      }\n    }\n\n    lc.info?.(\n      `loaded cvr@${versionString(cvr.version)} (${Date.now() - start} ms)`,\n    );\n\n    // why do we not sort `desiredQueryIDs` here?\n\n    return cvr;\n  }\n\n  getRowRecords(): Promise<ReadonlyMap<RowID, RowRecord>> {\n    return this.#rowCache.getRowRecords();\n  }\n\n  putRowRecord(row: RowRecord): void {\n    this.#pendingRowRecordUpdates.set(row.id, row);\n  }\n\n  /**\n   * Note: Removing a row from the CVR should be represented by a\n   *       {@link putRowRecord()} with `refCounts: null` in order to properly\n   *       produce the appropriate delete patch when catching up old clients.\n   *\n   * This `delRowRecord()` method, on the other hand, is only used for\n   * \"canceling\" the put of a row that was not in the CVR in the first place.\n   */\n  delRowRecord(id: RowID): void {\n    this.#pendingRowRecordUpdates.set(id, null);\n  }\n\n  /**\n   * Overrides the default logic that removes no-op writes and forces\n   * the updates for the given row `ids`. This has no effect if there\n   * are no corresponding puts or dels for the associated row records.\n   */\n  forceUpdates(...ids: RowID[]) {\n    for (const id of ids) {\n      this.#forceUpdates.add(id);\n    }\n  }\n\n  /**\n   * Updates the `ttlClock` of the CVR instance. The ttlClock starts at 0 when\n   * the CVR instance is first created and increments based on elapsed time\n   * since the base time established by the ViewSyncerService.\n   */\n  async updateTTLClock(ttlClock: TTLClock, lastActive: number): Promise<void> {\n    await this.#db`UPDATE ${this.#cvr('instances')}\n          SET \"lastActive\" = ${lastActive},\n              \"ttlClock\" = ${ttlClock}\n          WHERE \"clientGroupID\" = ${this.#id}`.execute();\n  }\n\n  /**\n   * @returns This returns the current `ttlClock` of the CVR instance. The ttlClock\n   *          represents elapsed time since the instance was created (starting from 0).\n   *          If the CVR has never been initialized for this client group, it returns\n   *          `undefined`.\n   */\n  async getTTLClock(): Promise<TTLClock | undefined> {\n    const result = await this.#db<Pick<InstancesRow, 'ttlClock'>[]>`\n      SELECT \"ttlClock\" FROM ${this.#cvr('instances')}\n      WHERE \"clientGroupID\" = ${this.#id}`.values();\n    if (result.length === 0) {\n      // This can happen if the CVR has not been initialized yet.\n      return undefined;\n    }\n    assert(\n      result.length === 1,\n      () => `Expected exactly one rowsVersion result, got ${result.length}`,\n    );\n    return result[0][0];\n  }\n\n  putInstance({\n    version,\n    replicaVersion,\n    lastActive,\n    clientSchema,\n    profileID,\n    ttlClock,\n  }: Pick<\n    CVRSnapshot,\n    | 'version'\n    | 'replicaVersion'\n    | 'lastActive'\n    | 'clientSchema'\n    | 'profileID'\n    | 'ttlClock'\n  >): void {\n    // Overwrite any previously queued instance write — only the last call\n    // matters since they all target the same row.\n    this.#pendingInstanceWrite = (tx, lastConnectTime) => {\n      const change: InstancesRow = {\n        clientGroupID: this.#id,\n        version: versionString(version),\n        lastActive,\n        ttlClock,\n        replicaVersion,\n        owner: this.#taskID,\n        grantedAt: lastConnectTime,\n        clientSchema,\n        profileID,\n      };\n      return tx`\n        INSERT INTO ${this.#cvr('instances')} ${tx(change)} \n          ON CONFLICT (\"clientGroupID\") DO UPDATE SET ${tx(change)}`;\n    };\n  }\n\n  markQueryAsDeleted(version: CVRVersion, queryPatch: QueryPatch): void {\n    this.#updateQueryFields(queryPatch.id, {\n      patchVersion: versionString(version),\n      deleted: true,\n      transformationHash: null,\n      transformationVersion: null,\n    });\n  }\n\n  putQuery(query: QueryRecord): void {\n    const change = queryRecordToQueryRow(this.#id, query);\n\n    const c = {\n      ...change,\n      // Pre-stringify queryArgs to handle postgres.js boolean array bug\n      queryArgs:\n        change.queryArgs !== null ? JSON.stringify(change.queryArgs) : null,\n      transformationHash: change.transformationHash ?? null,\n      transformationVersion: change.transformationVersion ?? null,\n      deleted: change.deleted ?? false,\n    };\n    this.#pendingQueryUpdates.set(query.id, c);\n  }\n\n  updateQuery(query: QueryRecord) {\n    const maybeVersionString = (v: CVRVersion | undefined) =>\n      v ? versionString(v) : null;\n    this.#updateQueryFields(query.id, {\n      patchVersion:\n        query.type === 'internal'\n          ? null\n          : maybeVersionString(query.patchVersion),\n      transformationHash: query.transformationHash ?? null,\n      transformationVersion: maybeVersionString(query.transformationVersion),\n      deleted: false,\n    });\n  }\n\n  insertClient(client: ClientRecord): void {\n    const change: ClientsRow = {\n      clientGroupID: this.#id,\n      clientID: client.id,\n    };\n\n    this.#writes.add({\n      stats: {clients: 1},\n      write: tx => tx`INSERT INTO ${this.#cvr('clients')} ${tx(change)}`,\n    });\n  }\n\n  deleteClient(clientID: string) {\n    this.#writes.add({\n      stats: {clients: 1},\n      write: sql =>\n        sql`DELETE FROM ${this.#cvr('clients')}\n            WHERE \"clientGroupID\" = ${this.#id}\n              AND \"clientID\" = ${clientID}`,\n    });\n  }\n\n  putDesiredQuery(\n    newVersion: CVRVersion,\n    query: {id: string},\n    client: {id: string},\n    deleted: boolean,\n    inactivatedAt: TTLClock | undefined,\n    ttl: number,\n  ): void {\n    const {ttlMs, inactivatedAtMs} = convertTTLValues(inactivatedAt, ttl);\n\n    const change: DesiresRow = {\n      clientGroupID: this.#id,\n      clientID: client.id,\n      deleted,\n      inactivatedAt: inactivatedAtMs,\n      patchVersion: versionString(newVersion),\n      queryHash: query.id,\n      ttl: ttlMs,\n    };\n\n    // Use composite key to deduplicate/replace entries for the same client-query pair\n    const key = `${client.id}:${query.id}`;\n    this.#pendingDesireUpdates.set(key, change);\n  }\n\n  catchupRowPatches(\n    lc: LogContext,\n    afterVersion: NullableCVRVersion,\n    upToCVR: CVRSnapshot,\n    current: CVRVersion,\n    excludeQueryHashes: string[] = [],\n  ): AsyncGenerator<RowsRow[], void, undefined> {\n    return this.#rowCache.catchupRowPatches(\n      lc,\n      afterVersion,\n      upToCVR,\n      current,\n      excludeQueryHashes,\n    );\n  }\n\n  async catchupConfigPatches(\n    lc: LogContext,\n    afterVersion: NullableCVRVersion,\n    upToCVR: CVRSnapshot,\n    current: CVRVersion,\n  ): Promise<PatchToVersion[]> {\n    if (cmpVersions(afterVersion, upToCVR.version) >= 0) {\n      return [];\n    }\n\n    const startMs = Date.now();\n    const start = afterVersion ? versionString(afterVersion) : '';\n    const end = versionString(upToCVR.version);\n    lc.debug?.(`scanning config patches for clients from ${start}`);\n\n    const reader = new TransactionPool(lc, Mode.READONLY).run(this.#db);\n    try {\n      // Verify that we are reading the right version of the CVR.\n      await reader.processReadTask(tx =>\n        checkVersion(tx, this.#schema, this.#id, current),\n      );\n\n      const [allDesires, queryRows] = await reader.processReadTask(tx =>\n        Promise.all([\n          tx<DesiresRow[]>`\n      SELECT * FROM ${this.#cvr('desires')}\n        WHERE \"clientGroupID\" = ${this.#id}\n        AND \"patchVersion\" > ${start}\n        AND \"patchVersion\" <= ${end}`,\n          tx<Pick<QueriesRow, 'deleted' | 'queryHash' | 'patchVersion'>[]>`\n      SELECT deleted, \"queryHash\", \"patchVersion\" FROM ${this.#cvr('queries')}\n        WHERE \"clientGroupID\" = ${this.#id}\n        AND \"patchVersion\" > ${start}\n        AND \"patchVersion\" <= ${end}`,\n        ]),\n      );\n\n      const patches: PatchToVersion[] = [];\n      for (const row of queryRows) {\n        const {queryHash: id} = row;\n        const patch: Patch = row.deleted\n          ? {type: 'query', op: 'del', id}\n          : {type: 'query', op: 'put', id};\n        const v = row.patchVersion;\n        assert(v, 'patchVersion must be set for query patches');\n        patches.push({patch, toVersion: versionFromString(v)});\n      }\n      for (const row of allDesires) {\n        const {clientID, queryHash: id} = row;\n        const patch: Patch = row.deleted\n          ? {type: 'query', op: 'del', id, clientID}\n          : {type: 'query', op: 'put', id, clientID};\n        patches.push({patch, toVersion: versionFromString(row.patchVersion)});\n      }\n\n      lc.debug?.(\n        `${patches.length} config patches (${Date.now() - startMs} ms)`,\n      );\n      return patches;\n    } finally {\n      reader.setDone();\n    }\n  }\n\n  #flushQueries(\n    tx: PostgresTransaction,\n    lc: LogContext,\n  ): PendingQuery<Row[]>[] {\n    // Merge partial updates into full updates\n    const partialOnly = new Map<string, Partial<QueriesRow>>();\n    for (const [queryHash, partial] of this.#pendingQueryPartialUpdates) {\n      const existing = this.#pendingQueryUpdates.get(queryHash);\n      if (existing) {\n        // Merge partial into full update\n        Object.assign(existing, partial);\n      } else {\n        // Track partial-only updates to batch separately\n        partialOnly.set(queryHash, partial);\n      }\n    }\n\n    const queries: PendingQuery<Row[]>[] = [];\n\n    // Batch full updates\n    if (this.#pendingQueryUpdates.size > 0) {\n      const rows = [...this.#pendingQueryUpdates.values()];\n      lc.debug?.(`Batch flushing ${rows.length} full query updates`);\n\n      queries.push(tx`\n        INSERT INTO ${this.#cvr('queries')} (\n          \"clientGroupID\",\n          \"queryHash\",\n          \"clientAST\",\n          \"queryName\",\n          \"queryArgs\",\n          \"patchVersion\",\n          \"transformationHash\",\n          \"transformationVersion\",\n          \"internal\",\n          \"deleted\"\n        )\n        SELECT\n          \"clientGroupID\",\n          \"queryHash\",\n          \"clientAST\",\n          \"queryName\",\n          CASE\n            WHEN \"queryArgs\" IS NULL THEN NULL\n            ELSE \"queryArgs\"::json\n          END,\n          \"patchVersion\",\n          \"transformationHash\",\n          \"transformationVersion\",\n          \"internal\",\n          \"deleted\"\n        FROM json_to_recordset(${rows}) AS x(\n          \"clientGroupID\" TEXT,\n          \"queryHash\" TEXT,\n          \"clientAST\" JSONB,\n          \"queryName\" TEXT,\n          \"queryArgs\" TEXT,\n          \"patchVersion\" TEXT,\n          \"transformationHash\" TEXT,\n          \"transformationVersion\" TEXT,\n          \"internal\" BOOLEAN,\n          \"deleted\" BOOLEAN\n        )\n        ON CONFLICT (\"clientGroupID\", \"queryHash\") DO UPDATE SET\n          \"clientAST\" = excluded.\"clientAST\",\n          \"queryName\" = excluded.\"queryName\",\n          \"queryArgs\" = CASE \n            WHEN excluded.\"queryArgs\" IS NULL THEN NULL\n            ELSE excluded.\"queryArgs\"::json\n          END,\n          \"patchVersion\" = excluded.\"patchVersion\",\n          \"transformationHash\" = excluded.\"transformationHash\",\n          \"transformationVersion\" = excluded.\"transformationVersion\",\n          \"internal\" = excluded.\"internal\",\n          \"deleted\" = excluded.\"deleted\"\n      `);\n    }\n\n    // Batch partial-only updates\n    if (partialOnly.size > 0) {\n      lc.debug?.(`Batch flushing ${partialOnly.size} partial query updates`);\n      const rows = Array.from(\n        partialOnly.entries(),\n        ([queryHash, partial]) => ({\n          clientGroupID: this.#id,\n          queryHash,\n          patchVersionSet: partial.patchVersion !== undefined,\n          patchVersion: partial.patchVersion ?? null,\n          deletedSet: partial.deleted !== undefined,\n          deleted: partial.deleted ?? null,\n          transformationHashSet: partial.transformationHash !== undefined,\n          transformationHash: partial.transformationHash ?? null,\n          transformationVersionSet: partial.transformationVersion !== undefined,\n          transformationVersion: partial.transformationVersion ?? null,\n        }),\n      );\n      queries.push(tx`\n        UPDATE ${this.#cvr('queries')} AS q\n        SET\n          \"patchVersion\" = CASE\n            WHEN u.\"patchVersionSet\" THEN u.\"patchVersion\"\n            ELSE q.\"patchVersion\"\n          END,\n          \"deleted\" = CASE\n            WHEN u.\"deletedSet\" THEN u.\"deleted\"\n            ELSE q.\"deleted\"\n          END,\n          \"transformationHash\" = CASE\n            WHEN u.\"transformationHashSet\" THEN u.\"transformationHash\"\n            ELSE q.\"transformationHash\"\n          END,\n          \"transformationVersion\" = CASE\n            WHEN u.\"transformationVersionSet\" THEN u.\"transformationVersion\"\n            ELSE q.\"transformationVersion\"\n          END\n        FROM json_to_recordset(${rows}) AS u(\n          \"clientGroupID\" TEXT,\n          \"queryHash\" TEXT,\n          \"patchVersionSet\" BOOLEAN,\n          \"patchVersion\" TEXT,\n          \"deletedSet\" BOOLEAN,\n          \"deleted\" BOOLEAN,\n          \"transformationHashSet\" BOOLEAN,\n          \"transformationHash\" TEXT,\n          \"transformationVersionSet\" BOOLEAN,\n          \"transformationVersion\" TEXT\n        )\n        WHERE q.\"clientGroupID\" = u.\"clientGroupID\"\n          AND q.\"queryHash\" = u.\"queryHash\"\n      `);\n    }\n\n    return queries;\n  }\n\n  #flushDesires(\n    tx: PostgresTransaction,\n    lc: LogContext,\n  ): PendingQuery<Row[]> | null {\n    if (this.#pendingDesireUpdates.size === 0) {\n      return null;\n    }\n\n    const rows = Array.from(this.#pendingDesireUpdates.values(), row => {\n      const {ttlInterval, ttlMs, inactivatedAtTimestamp, inactivatedAtMs} =\n        convertTTLValues(row.inactivatedAt ?? undefined, row.ttl ?? -1);\n      return {\n        clientGroupID: row.clientGroupID,\n        clientID: row.clientID,\n        queryHash: row.queryHash,\n        patchVersion: row.patchVersion,\n        deleted: row.deleted,\n        ttl: ttlInterval,\n        ttlMs,\n        inactivatedAt: inactivatedAtTimestamp,\n        inactivatedAtMs,\n      };\n    });\n\n    lc.debug?.(`Batch flushing ${rows.length} desire updates`);\n\n    return tx`\n      INSERT INTO ${this.#cvr('desires')} (\n        \"clientGroupID\",\n        \"clientID\",\n        \"queryHash\",\n        \"patchVersion\",\n        \"deleted\",\n        \"ttl\",\n        \"ttlMs\",\n        \"inactivatedAt\",\n        \"inactivatedAtMs\"\n      )\n      SELECT\n        \"clientGroupID\",\n        \"clientID\",\n        \"queryHash\",\n        \"patchVersion\",\n        \"deleted\",\n        \"ttl\",\n        \"ttlMs\",\n        CASE\n          WHEN \"inactivatedAt\" IS NULL THEN NULL\n          -- Divide by 1000 because postgres.js serializeTimestamp treats numbers as ms\n          -- and to_timestamp expects seconds. This matches non-batched behavior.\n          ELSE to_timestamp(\"inactivatedAt\" / 1000.0)\n        END,\n        \"inactivatedAtMs\"\n      FROM json_to_recordset(${rows}) AS x(\n        \"clientGroupID\" TEXT,\n        \"clientID\" TEXT,\n        \"queryHash\" TEXT,\n        \"patchVersion\" TEXT,\n        \"deleted\" BOOLEAN,\n        \"ttl\" INTERVAL,\n        \"ttlMs\" DOUBLE PRECISION,\n        \"inactivatedAt\" DOUBLE PRECISION,\n        \"inactivatedAtMs\" DOUBLE PRECISION\n      )\n      ON CONFLICT (\"clientGroupID\", \"clientID\", \"queryHash\") DO UPDATE SET\n        \"patchVersion\" = excluded.\"patchVersion\",\n        \"deleted\" = excluded.\"deleted\",\n        \"ttl\" = excluded.\"ttl\",\n        \"ttlMs\" = excluded.\"ttlMs\",\n        \"inactivatedAt\" = excluded.\"inactivatedAt\",\n        \"inactivatedAtMs\" = excluded.\"inactivatedAtMs\"\n      `;\n  }\n\n  async #checkVersionAndOwnership(\n    lc: LogContext,\n    tx: PostgresTransaction,\n    expectedCurrentVersion: CVRVersion,\n    lastConnectTime: number,\n  ): Promise<void> {\n    const start = Date.now();\n    lc.debug?.('checking cvr version and ownership');\n    const result = await tx<\n      Pick<InstancesRow, 'version' | 'owner' | 'grantedAt'>[]\n    >`SELECT \"version\", \"owner\", \"grantedAt\" FROM ${this.#cvr('instances')}\n        WHERE \"clientGroupID\" = ${this.#id}\n        FOR UPDATE`;\n    const expected = versionString(expectedCurrentVersion);\n    const {version, owner, grantedAt} =\n      result.length > 0\n        ? result[0]\n        : {\n            version: EMPTY_CVR_VERSION.stateVersion,\n            owner: null,\n            grantedAt: null,\n          };\n    lc.debug?.(\n      'checked cvr version and ownership in ' + (Date.now() - start) + ' ms',\n    );\n    if (owner !== this.#taskID && (grantedAt ?? 0) > lastConnectTime) {\n      throw new OwnershipError(owner, grantedAt, lastConnectTime);\n    }\n    if (version !== expected) {\n      throw new ConcurrentModificationException(expected, version);\n    }\n  }\n\n  async #flush(\n    lc: LogContext,\n    expectedCurrentVersion: CVRVersion,\n    cvr: CVRSnapshot,\n    lastConnectTime: number,\n  ): Promise<CVRFlushStats | null> {\n    const stats: CVRFlushStats = {\n      instances: 0,\n      queries: 0,\n      desires: 0,\n      clients: 0,\n      rows: 0,\n      rowsDeferred: 0,\n      statements: 0,\n    };\n    if (this.#pendingRowRecordUpdates.size) {\n      const existingRowRecords = await this.getRowRecords();\n      this.#rowCount = existingRowRecords.size;\n      for (const [id, row] of this.#pendingRowRecordUpdates.entries()) {\n        if (this.#forceUpdates.has(id)) {\n          continue;\n        }\n        const existing = existingRowRecords.get(id);\n        if (\n          // Don't delete or add an unreferenced row if it's not in the CVR.\n          (existing === undefined && !row?.refCounts) ||\n          // Don't write a row record that exactly matches what's in the CVR.\n          deepEqual(\n            (row ?? undefined) as ReadonlyJSONValue | undefined,\n            existing as ReadonlyJSONValue | undefined,\n          )\n        ) {\n          this.#pendingRowRecordUpdates.delete(id);\n        }\n      }\n    }\n    if (\n      this.#pendingRowRecordUpdates.size === 0 &&\n      this.#writes.size === 0 &&\n      this.#pendingInstanceWrite === undefined &&\n      this.#pendingQueryUpdates.size === 0 &&\n      this.#pendingQueryPartialUpdates.size === 0 &&\n      this.#pendingDesireUpdates.size === 0\n    ) {\n      return null;\n    }\n    // Note: The CVR instance itself is only updated if there are material\n    // changes (i.e. changes to the CVR contents) to flush.\n    this.putInstance(cvr);\n    const start = Date.now();\n    lc.debug?.('flush tx beginning');\n\n    // Use an async callback so we can await the version/ownership check and\n    // validate it INSIDE the transaction. If validation fails, the exception\n    // causes postgres.js to ROLLBACK, ensuring no writes are committed on error.\n    const results = await runTx(\n      this.#db,\n      async tx => {\n        lc.debug?.(`flush tx begun after ${Date.now() - start} ms`);\n\n        // Acquire row-level lock and validate version/ownership before queuing writes.\n        // Throwing here (inside the begin callback) rolls back the transaction so that\n        // no writes are committed when concurrent modification or ownership errors occur.\n        await this.#checkVersionAndOwnership(\n          lc,\n          tx,\n          expectedCurrentVersion,\n          lastConnectTime,\n        );\n\n        const writeQueries = [];\n        if (this.#pendingInstanceWrite) {\n          writeQueries.push(this.#pendingInstanceWrite(tx, lastConnectTime));\n          stats.instances++;\n          stats.statements++;\n        }\n        for (const write of this.#writes) {\n          stats.clients += write.stats.clients ?? 0;\n          stats.rows += write.stats.rows ?? 0;\n\n          writeQueries.push(write.write(tx, lastConnectTime));\n          stats.statements++;\n        }\n\n        // Batch flush config writes\n        // Flush queries first (desires depend on queries via foreign key)\n        const hasQueryUpdates =\n          this.#pendingQueryUpdates.size > 0 ||\n          this.#pendingQueryPartialUpdates.size > 0;\n\n        const desireFlush = this.#flushDesires(tx, lc);\n\n        let queryFlushes: PendingQuery<Row[]>[] = [];\n        if (hasQueryUpdates) {\n          queryFlushes = this.#flushQueries(tx, lc);\n\n          // Count both full updates and partial-only updates\n          const partialOnlyCount = [\n            ...this.#pendingQueryPartialUpdates.keys(),\n          ].filter(key => !this.#pendingQueryUpdates.has(key)).length;\n\n          stats.queries = this.#pendingQueryUpdates.size + partialOnlyCount;\n          stats.statements +=\n            (this.#pendingQueryUpdates.size > 0 ? 1 : 0) +\n            (partialOnlyCount > 0 ? 1 : 0);\n\n          if (desireFlush) {\n            stats.desires = this.#pendingDesireUpdates.size;\n            stats.statements++;\n          }\n        } else if (desireFlush) {\n          stats.desires = this.#pendingDesireUpdates.size;\n          stats.statements++;\n        }\n\n        const rowUpdates = this.#rowCache.executeRowUpdates(\n          tx,\n          cvr.version,\n          this.#pendingRowRecordUpdates,\n          'allow-defer',\n          lc,\n        );\n        stats.statements += rowUpdates.length;\n\n        // Pipeline writes now that the version check has passed.\n        const pipelined = [\n          ...writeQueries,\n          ...queryFlushes,\n          ...(desireFlush ? [desireFlush] : []),\n          ...rowUpdates,\n        ];\n\n        lc.debug?.(`returning ${pipelined.length} queries for pipelining`);\n\n        // Explicitly await all pipelined queries. When the begin callback is async,\n        // postgres.js does not call Promise.all() on the return value the way it does\n        // for sync callbacks, so we must do it ourselves.\n        return Promise.all(pipelined);\n      },\n      {mode: Mode.READ_COMMITTED},\n    );\n\n    lc.debug?.(`flush tx completed after ${Date.now() - start} ms`);\n\n    // Calculate how many row update queries were in the pipeline.\n    // Note: the version check was awaited separately and is not in the results array.\n    const baseQueries =\n      (this.#pendingInstanceWrite ? 1 : 0) +\n      this.#writes.size +\n      (this.#pendingQueryUpdates.size > 0 ? 1 : 0) +\n      ([...this.#pendingQueryPartialUpdates.keys()].filter(\n        key => !this.#pendingQueryUpdates.has(key),\n      ).length > 0\n        ? 1\n        : 0) +\n      (this.#pendingDesireUpdates.size > 0 ? 1 : 0);\n    const rowUpdateCount = results.length - baseQueries;\n\n    const rowsFlushed = rowUpdateCount > 0;\n    if (!rowsFlushed) {\n      stats.rowsDeferred = this.#pendingRowRecordUpdates.size;\n    } else {\n      stats.rows += this.#pendingRowRecordUpdates.size;\n    }\n\n    this.#rowCount = await this.#rowCache.apply(\n      this.#pendingRowRecordUpdates,\n      cvr.version,\n      rowsFlushed,\n    );\n    recordRowsSynced(this.#rowCount);\n\n    return stats;\n  }\n\n  get rowCount(): number {\n    return this.#rowCount;\n  }\n\n  async flush(\n    lc: LogContext,\n    expectedCurrentVersion: CVRVersion,\n    cvr: CVRSnapshot,\n    lastConnectTime: number,\n  ): Promise<CVRFlushStats | null> {\n    const start = performance.now();\n    lc = lc.withContext('cvrFlushID', flushCounter++);\n    try {\n      const stats = await this.#flush(\n        lc,\n        expectedCurrentVersion,\n        cvr,\n        lastConnectTime,\n      );\n      if (stats) {\n        const elapsed = performance.now() - start;\n        lc.info?.(\n          `flushed cvr@${versionString(cvr.version)} ` +\n            `${JSON.stringify(stats)} in (${elapsed} ms)`,\n        );\n        this.#rowCache.recordSyncFlushStats(stats, elapsed);\n      }\n      return stats;\n    } catch (e) {\n      // Clear cached state if an error (e.g. ConcurrentModificationException) is encountered.\n      this.#rowCache.clear();\n      throw e;\n    } finally {\n      this.#writes.clear();\n      this.#pendingInstanceWrite = undefined;\n      this.#pendingRowRecordUpdates.clear();\n      this.#forceUpdates.clear();\n      this.#pendingQueryUpdates.clear();\n      this.#pendingDesireUpdates.clear();\n      this.#pendingQueryPartialUpdates.clear();\n    }\n  }\n\n  hasPendingUpdates(): boolean {\n    return this.#rowCache.hasPendingUpdates();\n  }\n\n  /** Resolves when all pending updates are flushed. */\n  flushed(lc: LogContext): Promise<void> {\n    return this.#rowCache.flushed(lc);\n  }\n\n  async inspectQueries(\n    lc: LogContext,\n    ttlClock: TTLClock,\n    clientID?: string,\n  ): Promise<InspectQueryRow[]> {\n    const db = this.#db;\n    const clientGroupID = this.#id;\n\n    const reader = new TransactionPool(lc, Mode.READONLY).run(db);\n    try {\n      return await reader.processReadTask(\n        tx => tx<InspectQueryRow[]>`\n  SELECT DISTINCT ON (d.\"clientID\", d.\"queryHash\")\n    d.\"clientID\",\n    d.\"queryHash\" AS \"queryID\",\n    COALESCE(d.\"ttlMs\", ${DEFAULT_TTL_MS}) AS \"ttl\",\n    d.\"inactivatedAtMs\" AS \"inactivatedAt\",\n    (SELECT COUNT(*)::INT FROM ${this.#cvr('rows')} r \n     WHERE r.\"clientGroupID\" = d.\"clientGroupID\" \n     AND r.\"refCounts\" ? d.\"queryHash\") AS \"rowCount\",\n    q.\"clientAST\" AS \"ast\",\n    (q.\"patchVersion\" IS NOT NULL) AS \"got\",\n    COALESCE(d.\"deleted\", FALSE) AS \"deleted\",\n    q.\"queryName\" AS \"name\",\n    q.\"queryArgs\" AS \"args\"\n  FROM ${this.#cvr('desires')} d\n  LEFT JOIN ${this.#cvr('queries')} q\n    ON q.\"clientGroupID\" = d.\"clientGroupID\"\n   AND q.\"queryHash\" = d.\"queryHash\"\n  WHERE d.\"clientGroupID\" = ${clientGroupID}\n    ${clientID ? tx`AND d.\"clientID\" = ${clientID}` : tx``}\n    AND NOT (\n      d.\"inactivatedAtMs\" IS NOT NULL \n      AND d.\"ttlMs\" IS NOT NULL \n      AND (d.\"inactivatedAtMs\" + d.\"ttlMs\") <= ${ttlClockAsNumber(ttlClock)}\n    )\n  ORDER BY d.\"clientID\", d.\"queryHash\"`,\n      );\n    } finally {\n      reader.setDone();\n    }\n  }\n}\n\n/**\n * This is similar to {@link CVRStore.#checkVersionAndOwnership} except\n * that it only checks the version and is suitable for snapshot reads\n * (i.e. by doing a plain `SELECT` rather than a `SELECT ... FOR UPDATE`).\n */\nexport async function checkVersion(\n  tx: PostgresTransaction,\n  schema: string,\n  clientGroupID: string,\n  expectedCurrentVersion: CVRVersion,\n): Promise<void> {\n  const expected = versionString(expectedCurrentVersion);\n  const result = await tx<Pick<InstancesRow, 'version'>[]>`\n    SELECT version FROM ${tx(schema)}.instances \n      WHERE \"clientGroupID\" = ${clientGroupID}`;\n  const {version} =\n    result.length > 0 ? result[0] : {version: EMPTY_CVR_VERSION.stateVersion};\n  if (version !== expected) {\n    throw new ConcurrentModificationException(expected, version);\n  }\n}\n\nexport class ClientNotFoundError extends ProtocolErrorWithLevel {\n  constructor(message: string) {\n    super(\n      {\n        kind: ErrorKind.ClientNotFound,\n        message,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'warn',\n    );\n  }\n}\n\nexport class ConcurrentModificationException extends ProtocolErrorWithLevel {\n  readonly name = 'ConcurrentModificationException';\n\n  constructor(expectedVersion: string, actualVersion: string) {\n    super(\n      {\n        kind: ErrorKind.Internal,\n        message: `CVR has been concurrently modified. Expected ${expectedVersion}, got ${actualVersion}`,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'warn',\n    );\n  }\n}\n\nexport class OwnershipError extends ProtocolErrorWithLevel {\n  readonly name = 'OwnershipError';\n\n  constructor(\n    owner: string | null,\n    grantedAt: number | null,\n    lastConnectTime: number,\n  ) {\n    super(\n      {\n        kind: ErrorKind.Rehome,\n        message:\n          `CVR ownership was transferred to ${owner} at ` +\n          `${new Date(grantedAt ?? 0).toISOString()} ` +\n          `(last connect time: ${new Date(lastConnectTime).toISOString()})`,\n        maxBackoffMs: 0,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'info',\n    );\n  }\n}\n\nexport class InvalidClientSchemaError extends ProtocolErrorWithLevel {\n  readonly name = 'InvalidClientSchemaError';\n\n  constructor(cause: unknown) {\n    super(\n      {\n        kind: ErrorKind.SchemaVersionNotSupported,\n        message: `Could not parse clientSchema stored in CVR: ${String(cause)}`,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'warn',\n      {cause},\n    );\n  }\n}\n\nexport class RowsVersionBehindError extends Error {\n  readonly name = 'RowsVersionBehindError';\n  readonly cvrVersion: string;\n  readonly rowsVersion: string | null;\n\n  constructor(cvrVersion: string, rowsVersion: string | null) {\n    super(`rowsVersion (${rowsVersion}) is behind CVR ${cvrVersion}`);\n    this.cvrVersion = cvrVersion;\n    this.rowsVersion = rowsVersion;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cvr-store.js","names":["#schema","#taskID","#id","#failService","#db","#writes","#pendingRowRecordUpdates","#forceUpdates","#rowCache","#loadAttemptIntervalMs","#maxLoadAttempts","#pendingQueryUpdates","#pendingDesireUpdates","#pendingQueryPartialUpdates","#load","#cvr","#pendingInstanceWrite","#updateQueryFields","#checkVersionAndOwnership","#flush","#rowCount","#flushDesires","#flushQueries"],"sources":["../../../../../../zero-cache/src/services/view-syncer/cvr-store.ts"],"sourcesContent":["import {trace} from '@opentelemetry/api';\nimport type {LogContext} from '@rocicorp/logger';\nimport type {MaybeRow, PendingQuery, Row} from 'postgres';\nimport {startAsyncSpan} from '../../../../otel/src/span.ts';\nimport {version} from '../../../../otel/src/version.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport {CustomKeyMap} from '../../../../shared/src/custom-key-map.ts';\nimport {CustomKeySet} from '../../../../shared/src/custom-key-set.ts';\nimport {\n  deepEqual,\n  type ReadonlyJSONValue,\n} from '../../../../shared/src/json.ts';\nimport {sleep} from '../../../../shared/src/sleep.ts';\nimport * as v from '../../../../shared/src/valita.ts';\nimport {astSchema} from '../../../../zero-protocol/src/ast.ts';\nimport {clientSchemaSchema} from '../../../../zero-protocol/src/client-schema.ts';\nimport {ErrorKind} from '../../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../../zero-protocol/src/error-origin.ts';\nimport type {InspectQueryRow} from '../../../../zero-protocol/src/inspect-down.ts';\nimport {clampTTL, DEFAULT_TTL_MS} from '../../../../zql/src/query/ttl.ts';\nimport * as Mode from '../../db/mode-enum.ts';\nimport {runTx} from '../../db/run-transaction.ts';\nimport {TransactionPool} from '../../db/transaction-pool.ts';\nimport {recordRowsSynced} from '../../server/anonymous-otel-start.ts';\nimport {ProtocolErrorWithLevel} from '../../types/error-with-level.ts';\nimport type {PostgresDB, PostgresTransaction} from '../../types/pg.ts';\nimport {rowIDString} from '../../types/row-key.ts';\nimport {cvrSchema, type ShardID} from '../../types/shards.ts';\nimport type {Patch, PatchToVersion} from './client-handler.ts';\nimport type {CVR, CVRSnapshot} from './cvr.ts';\nimport {RowRecordCache} from './row-record-cache.ts';\nimport {\n  type ClientsRow,\n  type DesiresRow,\n  type InstancesRow,\n  type QueriesRow,\n  type RowsRow,\n} from './schema/cvr.ts';\nimport {\n  type ClientQueryRecord,\n  type ClientRecord,\n  cmpVersions,\n  type CustomQueryRecord,\n  type CVRVersion,\n  EMPTY_CVR_VERSION,\n  type InternalQueryRecord,\n  type NullableCVRVersion,\n  type QueryPatch,\n  type QueryRecord,\n  queryRecordToQueryRow,\n  type RowID,\n  type RowRecord,\n  versionFromString,\n  versionString,\n} from './schema/types.ts';\nimport {\n  type TTLClock,\n  ttlClockAsNumber,\n  ttlClockFromNumber,\n} from './ttl-clock.ts';\n\nexport type CVRFlushStats = {\n  instances: number;\n  queries: number;\n  desires: number;\n  clients: number;\n  rows: number;\n  rowsDeferred: number;\n  statements: number;\n};\n\nlet flushCounter = 0;\n\n/**\n * Convert TTL/timestamp values for both old (seconds-based) and new (ms-based) columns.\n * Old columns: inactivatedAt (TIMESTAMPTZ), ttl (INTERVAL) - need conversion ms->seconds\n * New columns: inactivatedAtMs (DOUBLE PRECISION), ttlMs (DOUBLE PRECISION) - store ms directly\n */\nfunction convertTTLValues(\n  inactivatedAt: TTLClock | undefined,\n  ttl: number,\n): {\n  ttlInterval: number | null;\n  ttlMs: number | null;\n  inactivatedAtTimestamp: TTLClock | null;\n  inactivatedAtMs: TTLClock | null;\n} {\n  return {\n    ttlInterval: ttl < 0 ? null : ttl / 1000, // INTERVAL needs seconds\n    ttlMs: ttl < 0 ? null : ttl, // New column stores ms directly\n    inactivatedAtTimestamp:\n      inactivatedAt === undefined\n        ? null\n        : ttlClockFromNumber(ttlClockAsNumber(inactivatedAt) / 1000),\n    inactivatedAtMs: inactivatedAt ?? null,\n  };\n}\n\nconst tracer = trace.getTracer('cvr-store', version);\n\n/**\n * QueriesRow with queryArgs as a stringified JSON value.\n * Used for batched config writes where queryArgs are pre-stringified\n * to handle the postgres.js boolean array bug.\n */\ntype StringifiedQueriesRow = Omit<QueriesRow, 'queryArgs'> & {\n  queryArgs: string | null;\n};\n\nfunction asQuery(row: QueriesRow): QueryRecord {\n  const maybeVersion = (s: string | null) =>\n    s === null ? undefined : versionFromString(s);\n\n  if (row.clientAST === null) {\n    // custom query\n    assert(\n      row.queryName !== null && row.queryArgs !== null,\n      'queryName and queryArgs must be set for custom queries',\n    );\n    return {\n      type: 'custom',\n      id: row.queryHash,\n      name: row.queryName,\n      args: row.queryArgs,\n      patchVersion: maybeVersion(row.patchVersion),\n      clientState: {},\n      transformationHash: row.transformationHash ?? undefined,\n      transformationVersion: maybeVersion(row.transformationVersion),\n    } satisfies CustomQueryRecord;\n  }\n\n  const ast = astSchema.parse(row.clientAST);\n  return row.internal\n    ? ({\n        type: 'internal',\n        id: row.queryHash,\n        ast,\n        transformationHash: row.transformationHash ?? undefined,\n        transformationVersion: maybeVersion(row.transformationVersion),\n      } satisfies InternalQueryRecord)\n    : ({\n        type: 'client',\n        id: row.queryHash,\n        ast,\n        patchVersion: maybeVersion(row.patchVersion),\n        clientState: {},\n        transformationHash: row.transformationHash ?? undefined,\n        transformationVersion: maybeVersion(row.transformationVersion),\n      } satisfies ClientQueryRecord);\n}\n\n// The time to wait between load attempts.\nconst LOAD_ATTEMPT_INTERVAL_MS = 500;\n// The maximum number of load() attempts if the rowsVersion is behind.\n// This currently results in a maximum catchup time of ~5 seconds, after\n// which we give up and consider the CVR invalid.\n//\n// TODO: Make this configurable with something like --max-catchup-wait-ms,\n//       as it is technically application specific.\nconst MAX_LOAD_ATTEMPTS = 10;\n\nexport class CVRStore {\n  readonly #schema: string;\n  readonly #taskID: string;\n  readonly #id: string;\n  readonly #failService: (e: unknown) => void;\n  readonly #db: PostgresDB;\n  readonly #writes: Set<{\n    stats: Partial<CVRFlushStats>;\n    write: (\n      tx: PostgresTransaction,\n      lastConnectTime: number,\n    ) => PendingQuery<MaybeRow[]>;\n  }> = new Set();\n  // Stored separately so repeated putInstance() calls (e.g. setClientSchema,\n  // setProfileID, and the final call in #flush) replace each other rather than\n  // accumulating as independent statements in #writes.\n  #pendingInstanceWrite:\n    | ((\n        tx: PostgresTransaction,\n        lastConnectTime: number,\n      ) => PendingQuery<MaybeRow[]>)\n    | undefined = undefined;\n  readonly #pendingRowRecordUpdates = new CustomKeyMap<RowID, RowRecord | null>(\n    rowIDString,\n  );\n  readonly #forceUpdates = new CustomKeySet<RowID>(rowIDString);\n  readonly #rowCache: RowRecordCache;\n  readonly #loadAttemptIntervalMs: number;\n  readonly #maxLoadAttempts: number;\n  #rowCount: number = 0;\n  readonly #pendingQueryUpdates = new Map<string, StringifiedQueriesRow>();\n  readonly #pendingDesireUpdates = new Map<string, DesiresRow>();\n  readonly #pendingQueryPartialUpdates = new Map<string, Partial<QueriesRow>>();\n\n  constructor(\n    lc: LogContext,\n    cvrDb: PostgresDB,\n    shard: ShardID,\n    taskID: string,\n    cvrID: string,\n    failService: (e: unknown) => void,\n    loadAttemptIntervalMs = LOAD_ATTEMPT_INTERVAL_MS,\n    maxLoadAttempts = MAX_LOAD_ATTEMPTS,\n    deferredRowFlushThreshold = 100, // somewhat arbitrary\n    setTimeoutFn = setTimeout,\n  ) {\n    this.#failService = failService;\n    this.#db = cvrDb;\n    this.#schema = cvrSchema(shard);\n    this.#taskID = taskID;\n    this.#id = cvrID;\n    this.#rowCache = new RowRecordCache(\n      lc,\n      cvrDb,\n      shard,\n      cvrID,\n      failService,\n      deferredRowFlushThreshold,\n      setTimeoutFn,\n    );\n    this.#loadAttemptIntervalMs = loadAttemptIntervalMs;\n    this.#maxLoadAttempts = maxLoadAttempts;\n  }\n\n  #cvr(table: string) {\n    return this.#db(`${this.#schema}.${table}`);\n  }\n\n  #updateQueryFields(queryHash: string, fields: Partial<QueriesRow>): void {\n    // Track as partial-only update for batched flush\n    this.#pendingQueryPartialUpdates.set(queryHash, fields);\n  }\n\n  load(lc: LogContext, lastConnectTime: number): Promise<CVR> {\n    return startAsyncSpan(tracer, 'cvr.load', async () => {\n      let err: RowsVersionBehindError | undefined;\n      for (let i = 0; i < this.#maxLoadAttempts; i++) {\n        if (i > 0) {\n          await sleep(this.#loadAttemptIntervalMs);\n        }\n        const result = await this.#load(lc, lastConnectTime);\n        if (result instanceof RowsVersionBehindError) {\n          lc.info?.(`attempt ${i + 1}: ${String(result)}`);\n          err = result;\n          continue;\n        }\n        return result;\n      }\n      assert(err, 'Expected error to be set after retry loop exhausted');\n      throw new ClientNotFoundError(\n        `max attempts exceeded waiting for CVR@${err.cvrVersion} to catch up from ${err.rowsVersion}`,\n      );\n    });\n  }\n\n  async #load(\n    lc: LogContext,\n    lastConnectTime: number,\n  ): Promise<CVR | RowsVersionBehindError> {\n    const start = Date.now();\n\n    const id = this.#id;\n    const cvr: CVR = {\n      id,\n      version: EMPTY_CVR_VERSION,\n      lastActive: 0,\n      ttlClock: ttlClockFromNumber(0), // TTL clock starts at 0, not Date.now()\n      replicaVersion: null,\n      clients: {},\n      queries: {},\n      clientSchema: null,\n      profileID: null,\n    };\n\n    const [instance, clientsRows, queryRows, desiresRows] = await runTx(\n      this.#db,\n      tx => {\n        lc.debug?.(`CVR tx started after ${Date.now() - start} ms`);\n        return [\n          tx<\n            (Omit<InstancesRow, 'clientGroupID'> & {\n              profileID: string | null;\n              deleted: boolean;\n              rowsVersion: string | null;\n            })[]\n          >`SELECT cvr.\"version\",\n                 \"lastActive\",\n                 \"ttlClock\",\n                 \"replicaVersion\",\n                 \"owner\",\n                 \"grantedAt\",\n                 \"clientSchema\",\n                 \"profileID\",\n                 \"deleted\",\n                 rows.\"version\" as \"rowsVersion\"\n            FROM ${this.#cvr('instances')} AS cvr\n            LEFT JOIN ${this.#cvr('rowsVersion')} AS rows\n            ON cvr.\"clientGroupID\" = rows.\"clientGroupID\"\n            WHERE cvr.\"clientGroupID\" = ${id}`,\n          tx<Pick<ClientsRow, 'clientID'>[]>`SELECT \"clientID\" FROM ${this.#cvr(\n            'clients',\n          )}\n           WHERE \"clientGroupID\" = ${id}`,\n          tx<QueriesRow[]>`SELECT * FROM ${this.#cvr('queries')}\n          WHERE \"clientGroupID\" = ${id} AND deleted IS DISTINCT FROM true`,\n          tx<DesiresRow[]>`SELECT\n          \"clientGroupID\",\n          \"clientID\",\n          \"queryHash\",\n          \"patchVersion\",\n          \"deleted\",\n          \"ttlMs\" AS \"ttl\",\n          \"inactivatedAtMs\" AS \"inactivatedAt\"\n          FROM ${this.#cvr('desires')}\n          WHERE \"clientGroupID\" = ${id}`,\n        ];\n      },\n      {mode: Mode.READONLY},\n    );\n    lc.debug?.(\n      `CVR tx completed after ${Date.now() - start} ms ` +\n        `(${clientsRows.length} clients, ${queryRows.length} queries, ${desiresRows.length} desires)`,\n    );\n\n    if (instance.length === 0) {\n      // This is the first time we see this CVR.\n      this.putInstance({\n        version: cvr.version,\n        lastActive: 0,\n        ttlClock: ttlClockFromNumber(0), // TTL clock starts at 0 for new instances\n        replicaVersion: null,\n        clientSchema: null,\n        profileID: null,\n      });\n    } else {\n      assert(\n        instance.length === 1,\n        () => `Expected exactly one CVR instance, got ${instance.length}`,\n      );\n      const {\n        version,\n        lastActive,\n        ttlClock,\n        replicaVersion,\n        owner,\n        grantedAt,\n        rowsVersion,\n        clientSchema,\n        profileID,\n        deleted,\n      } = instance[0];\n\n      if (deleted) {\n        throw new ClientNotFoundError(\n          'Client has been purged due to inactivity',\n        );\n      }\n\n      if (owner !== this.#taskID) {\n        if ((grantedAt ?? 0) > lastConnectTime) {\n          throw new OwnershipError(owner, grantedAt, lastConnectTime);\n        } else {\n          // Fire-and-forget an ownership change to signal the current owner.\n          // Note that the query is structured such that it only succeeds in the\n          // correct conditions (i.e. gated on `grantedAt`).\n          void this.#db`\n            UPDATE ${this.#cvr('instances')} \n              SET \"owner\"     = ${this.#taskID}, \n                  \"grantedAt\" = ${lastConnectTime}\n              WHERE \"clientGroupID\" = ${this.#id} AND\n                    (\"grantedAt\" IS NULL OR\n                     \"grantedAt\" <= to_timestamp(${lastConnectTime / 1000}))\n        `\n            .execute()\n            .catch(this.#failService);\n        }\n      }\n\n      if (version !== (rowsVersion ?? EMPTY_CVR_VERSION.stateVersion)) {\n        // This will cause the load() method to wait for row catchup and retry.\n        // Assuming the ownership signal succeeds, the current owner will stop\n        // modifying the CVR and flush its pending row changes.\n        return new RowsVersionBehindError(version, rowsVersion);\n      }\n\n      cvr.version = versionFromString(version);\n      cvr.lastActive = lastActive;\n      cvr.ttlClock = ttlClock;\n      cvr.replicaVersion = replicaVersion;\n      cvr.profileID = profileID;\n\n      try {\n        cvr.clientSchema =\n          clientSchema === null\n            ? null\n            : v.parse(clientSchema, clientSchemaSchema);\n      } catch (e) {\n        throw new InvalidClientSchemaError(e);\n      }\n    }\n\n    for (const row of clientsRows) {\n      cvr.clients[row.clientID] = {\n        id: row.clientID,\n        desiredQueryIDs: [],\n      };\n    }\n\n    for (const row of queryRows) {\n      const query = asQuery(row);\n      cvr.queries[row.queryHash] = query;\n    }\n\n    for (const row of desiresRows) {\n      const client = cvr.clients[row.clientID];\n      // Note: row.inactivatedAt is mapped from inactivatedAtMs in the SQL query\n      if (!row.deleted && row.inactivatedAt === null) {\n        if (client) {\n          client.desiredQueryIDs.push(row.queryHash);\n        } else {\n          // This can happen if the client was deleted but the queries are still alive.\n          lc.debug?.(\n            `Not adding to desiredQueryIDs for client ${row.clientID} because it has been deleted.`,\n          );\n        }\n      }\n\n      const query = cvr.queries[row.queryHash];\n      if (\n        query &&\n        query.type !== 'internal' &&\n        (!row.deleted || row.inactivatedAt !== null)\n      ) {\n        query.clientState[row.clientID] = {\n          inactivatedAt: row.inactivatedAt ?? undefined,\n          ttl: clampTTL(row.ttl ?? DEFAULT_TTL_MS),\n          version: versionFromString(row.patchVersion),\n        };\n      }\n    }\n\n    lc.info?.(\n      `loaded cvr@${versionString(cvr.version)} (${Date.now() - start} ms)`,\n    );\n\n    // why do we not sort `desiredQueryIDs` here?\n\n    return cvr;\n  }\n\n  getRowRecords(): Promise<ReadonlyMap<RowID, RowRecord>> {\n    return this.#rowCache.getRowRecords();\n  }\n\n  putRowRecord(row: RowRecord): void {\n    this.#pendingRowRecordUpdates.set(row.id, row);\n  }\n\n  /**\n   * Note: Removing a row from the CVR should be represented by a\n   *       {@link putRowRecord()} with `refCounts: null` in order to properly\n   *       produce the appropriate delete patch when catching up old clients.\n   *\n   * This `delRowRecord()` method, on the other hand, is only used for\n   * \"canceling\" the put of a row that was not in the CVR in the first place.\n   */\n  delRowRecord(id: RowID): void {\n    this.#pendingRowRecordUpdates.set(id, null);\n  }\n\n  /**\n   * Overrides the default logic that removes no-op writes and forces\n   * the updates for the given row `ids`. This has no effect if there\n   * are no corresponding puts or dels for the associated row records.\n   */\n  forceUpdates(...ids: RowID[]) {\n    for (const id of ids) {\n      this.#forceUpdates.add(id);\n    }\n  }\n\n  /**\n   * Updates the `ttlClock` of the CVR instance. The ttlClock starts at 0 when\n   * the CVR instance is first created and increments based on elapsed time\n   * since the base time established by the ViewSyncerService.\n   */\n  async updateTTLClock(ttlClock: TTLClock, lastActive: number): Promise<void> {\n    await this.#db`UPDATE ${this.#cvr('instances')}\n          SET \"lastActive\" = ${lastActive},\n              \"ttlClock\" = ${ttlClock}\n          WHERE \"clientGroupID\" = ${this.#id}`.execute();\n  }\n\n  /**\n   * @returns This returns the current `ttlClock` of the CVR instance. The ttlClock\n   *          represents elapsed time since the instance was created (starting from 0).\n   *          If the CVR has never been initialized for this client group, it returns\n   *          `undefined`.\n   */\n  async getTTLClock(): Promise<TTLClock | undefined> {\n    const result = await this.#db<Pick<InstancesRow, 'ttlClock'>[]>`\n      SELECT \"ttlClock\" FROM ${this.#cvr('instances')}\n      WHERE \"clientGroupID\" = ${this.#id}`.values();\n    if (result.length === 0) {\n      // This can happen if the CVR has not been initialized yet.\n      return undefined;\n    }\n    assert(\n      result.length === 1,\n      () => `Expected exactly one rowsVersion result, got ${result.length}`,\n    );\n    return result[0][0];\n  }\n\n  putInstance({\n    version,\n    replicaVersion,\n    lastActive,\n    clientSchema,\n    profileID,\n    ttlClock,\n  }: Pick<\n    CVRSnapshot,\n    | 'version'\n    | 'replicaVersion'\n    | 'lastActive'\n    | 'clientSchema'\n    | 'profileID'\n    | 'ttlClock'\n  >): void {\n    // Overwrite any previously queued instance write — only the last call\n    // matters since they all target the same row.\n    this.#pendingInstanceWrite = (tx, lastConnectTime) => {\n      const change: InstancesRow = {\n        clientGroupID: this.#id,\n        version: versionString(version),\n        lastActive,\n        ttlClock,\n        replicaVersion,\n        owner: this.#taskID,\n        grantedAt: lastConnectTime,\n        clientSchema,\n        profileID,\n      };\n      return tx`\n        INSERT INTO ${this.#cvr('instances')} ${tx(change)} \n          ON CONFLICT (\"clientGroupID\") DO UPDATE SET ${tx(change)}`;\n    };\n  }\n\n  markQueryAsDeleted(version: CVRVersion, queryPatch: QueryPatch): void {\n    this.#updateQueryFields(queryPatch.id, {\n      patchVersion: versionString(version),\n      deleted: true,\n      transformationHash: null,\n      transformationVersion: null,\n    });\n  }\n\n  putQuery(query: QueryRecord): void {\n    const change = queryRecordToQueryRow(this.#id, query);\n\n    const c = {\n      ...change,\n      // Pre-stringify queryArgs to handle postgres.js boolean array bug\n      queryArgs:\n        change.queryArgs !== null ? JSON.stringify(change.queryArgs) : null,\n      transformationHash: change.transformationHash ?? null,\n      transformationVersion: change.transformationVersion ?? null,\n      deleted: change.deleted ?? false,\n    };\n    this.#pendingQueryUpdates.set(query.id, c);\n  }\n\n  updateQuery(query: QueryRecord) {\n    const maybeVersionString = (v: CVRVersion | undefined) =>\n      v ? versionString(v) : null;\n    this.#updateQueryFields(query.id, {\n      patchVersion:\n        query.type === 'internal'\n          ? null\n          : maybeVersionString(query.patchVersion),\n      transformationHash: query.transformationHash ?? null,\n      transformationVersion: maybeVersionString(query.transformationVersion),\n      deleted: false,\n    });\n  }\n\n  insertClient(client: ClientRecord): void {\n    const change: ClientsRow = {\n      clientGroupID: this.#id,\n      clientID: client.id,\n    };\n\n    this.#writes.add({\n      stats: {clients: 1},\n      write: tx => tx`INSERT INTO ${this.#cvr('clients')} ${tx(change)}`,\n    });\n  }\n\n  deleteClient(clientID: string) {\n    this.#writes.add({\n      stats: {clients: 1},\n      write: sql =>\n        sql`DELETE FROM ${this.#cvr('clients')}\n            WHERE \"clientGroupID\" = ${this.#id}\n              AND \"clientID\" = ${clientID}`,\n    });\n  }\n\n  putDesiredQuery(\n    newVersion: CVRVersion,\n    query: {id: string},\n    client: {id: string},\n    deleted: boolean,\n    inactivatedAt: TTLClock | undefined,\n    ttl: number,\n  ): void {\n    const {ttlMs, inactivatedAtMs} = convertTTLValues(inactivatedAt, ttl);\n\n    const change: DesiresRow = {\n      clientGroupID: this.#id,\n      clientID: client.id,\n      deleted,\n      inactivatedAt: inactivatedAtMs,\n      patchVersion: versionString(newVersion),\n      queryHash: query.id,\n      ttl: ttlMs,\n    };\n\n    // Use composite key to deduplicate/replace entries for the same client-query pair\n    const key = `${client.id}:${query.id}`;\n    this.#pendingDesireUpdates.set(key, change);\n  }\n\n  catchupRowPatches(\n    lc: LogContext,\n    afterVersion: NullableCVRVersion,\n    upToCVR: CVRSnapshot,\n    current: CVRVersion,\n    excludeQueryHashes: string[] = [],\n  ): AsyncGenerator<RowsRow[], void, undefined> {\n    return this.#rowCache.catchupRowPatches(\n      lc,\n      afterVersion,\n      upToCVR,\n      current,\n      excludeQueryHashes,\n    );\n  }\n\n  async catchupConfigPatches(\n    lc: LogContext,\n    afterVersion: NullableCVRVersion,\n    upToCVR: CVRSnapshot,\n    current: CVRVersion,\n  ): Promise<PatchToVersion[]> {\n    if (cmpVersions(afterVersion, upToCVR.version) >= 0) {\n      return [];\n    }\n\n    const startMs = Date.now();\n    const start = afterVersion ? versionString(afterVersion) : '';\n    const end = versionString(upToCVR.version);\n    lc.debug?.(`scanning config patches for clients from ${start}`);\n\n    const reader = new TransactionPool(lc, {mode: Mode.READONLY}).run(this.#db);\n    try {\n      // Verify that we are reading the right version of the CVR.\n      await reader.processReadTask(tx =>\n        checkVersion(tx, this.#schema, this.#id, current),\n      );\n\n      const [allDesires, queryRows] = await reader.processReadTask(tx =>\n        Promise.all([\n          tx<DesiresRow[]>`\n      SELECT * FROM ${this.#cvr('desires')}\n        WHERE \"clientGroupID\" = ${this.#id}\n        AND \"patchVersion\" > ${start}\n        AND \"patchVersion\" <= ${end}`,\n          tx<Pick<QueriesRow, 'deleted' | 'queryHash' | 'patchVersion'>[]>`\n      SELECT deleted, \"queryHash\", \"patchVersion\" FROM ${this.#cvr('queries')}\n        WHERE \"clientGroupID\" = ${this.#id}\n        AND \"patchVersion\" > ${start}\n        AND \"patchVersion\" <= ${end}`,\n        ]),\n      );\n\n      const patches: PatchToVersion[] = [];\n      for (const row of queryRows) {\n        const {queryHash: id} = row;\n        const patch: Patch = row.deleted\n          ? {type: 'query', op: 'del', id}\n          : {type: 'query', op: 'put', id};\n        const v = row.patchVersion;\n        assert(v, 'patchVersion must be set for query patches');\n        patches.push({patch, toVersion: versionFromString(v)});\n      }\n      for (const row of allDesires) {\n        const {clientID, queryHash: id} = row;\n        const patch: Patch = row.deleted\n          ? {type: 'query', op: 'del', id, clientID}\n          : {type: 'query', op: 'put', id, clientID};\n        patches.push({patch, toVersion: versionFromString(row.patchVersion)});\n      }\n\n      lc.debug?.(\n        `${patches.length} config patches (${Date.now() - startMs} ms)`,\n      );\n      return patches;\n    } finally {\n      reader.setDone();\n    }\n  }\n\n  #flushQueries(\n    tx: PostgresTransaction,\n    lc: LogContext,\n  ): PendingQuery<Row[]>[] {\n    // Merge partial updates into full updates\n    const partialOnly = new Map<string, Partial<QueriesRow>>();\n    for (const [queryHash, partial] of this.#pendingQueryPartialUpdates) {\n      const existing = this.#pendingQueryUpdates.get(queryHash);\n      if (existing) {\n        // Merge partial into full update\n        Object.assign(existing, partial);\n      } else {\n        // Track partial-only updates to batch separately\n        partialOnly.set(queryHash, partial);\n      }\n    }\n\n    const queries: PendingQuery<Row[]>[] = [];\n\n    // Batch full updates\n    if (this.#pendingQueryUpdates.size > 0) {\n      const rows = [...this.#pendingQueryUpdates.values()];\n      lc.debug?.(`Batch flushing ${rows.length} full query updates`);\n\n      queries.push(tx`\n        INSERT INTO ${this.#cvr('queries')} (\n          \"clientGroupID\",\n          \"queryHash\",\n          \"clientAST\",\n          \"queryName\",\n          \"queryArgs\",\n          \"patchVersion\",\n          \"transformationHash\",\n          \"transformationVersion\",\n          \"internal\",\n          \"deleted\"\n        )\n        SELECT\n          \"clientGroupID\",\n          \"queryHash\",\n          \"clientAST\",\n          \"queryName\",\n          CASE\n            WHEN \"queryArgs\" IS NULL THEN NULL\n            ELSE \"queryArgs\"::json\n          END,\n          \"patchVersion\",\n          \"transformationHash\",\n          \"transformationVersion\",\n          \"internal\",\n          \"deleted\"\n        FROM json_to_recordset(${rows}) AS x(\n          \"clientGroupID\" TEXT,\n          \"queryHash\" TEXT,\n          \"clientAST\" JSONB,\n          \"queryName\" TEXT,\n          \"queryArgs\" TEXT,\n          \"patchVersion\" TEXT,\n          \"transformationHash\" TEXT,\n          \"transformationVersion\" TEXT,\n          \"internal\" BOOLEAN,\n          \"deleted\" BOOLEAN\n        )\n        ON CONFLICT (\"clientGroupID\", \"queryHash\") DO UPDATE SET\n          \"clientAST\" = excluded.\"clientAST\",\n          \"queryName\" = excluded.\"queryName\",\n          \"queryArgs\" = CASE \n            WHEN excluded.\"queryArgs\" IS NULL THEN NULL\n            ELSE excluded.\"queryArgs\"::json\n          END,\n          \"patchVersion\" = excluded.\"patchVersion\",\n          \"transformationHash\" = excluded.\"transformationHash\",\n          \"transformationVersion\" = excluded.\"transformationVersion\",\n          \"internal\" = excluded.\"internal\",\n          \"deleted\" = excluded.\"deleted\"\n      `);\n    }\n\n    // Batch partial-only updates\n    if (partialOnly.size > 0) {\n      lc.debug?.(`Batch flushing ${partialOnly.size} partial query updates`);\n      const rows = Array.from(\n        partialOnly.entries(),\n        ([queryHash, partial]) => ({\n          clientGroupID: this.#id,\n          queryHash,\n          patchVersionSet: partial.patchVersion !== undefined,\n          patchVersion: partial.patchVersion ?? null,\n          deletedSet: partial.deleted !== undefined,\n          deleted: partial.deleted ?? null,\n          transformationHashSet: partial.transformationHash !== undefined,\n          transformationHash: partial.transformationHash ?? null,\n          transformationVersionSet: partial.transformationVersion !== undefined,\n          transformationVersion: partial.transformationVersion ?? null,\n        }),\n      );\n      queries.push(tx`\n        UPDATE ${this.#cvr('queries')} AS q\n        SET\n          \"patchVersion\" = CASE\n            WHEN u.\"patchVersionSet\" THEN u.\"patchVersion\"\n            ELSE q.\"patchVersion\"\n          END,\n          \"deleted\" = CASE\n            WHEN u.\"deletedSet\" THEN u.\"deleted\"\n            ELSE q.\"deleted\"\n          END,\n          \"transformationHash\" = CASE\n            WHEN u.\"transformationHashSet\" THEN u.\"transformationHash\"\n            ELSE q.\"transformationHash\"\n          END,\n          \"transformationVersion\" = CASE\n            WHEN u.\"transformationVersionSet\" THEN u.\"transformationVersion\"\n            ELSE q.\"transformationVersion\"\n          END\n        FROM json_to_recordset(${rows}) AS u(\n          \"clientGroupID\" TEXT,\n          \"queryHash\" TEXT,\n          \"patchVersionSet\" BOOLEAN,\n          \"patchVersion\" TEXT,\n          \"deletedSet\" BOOLEAN,\n          \"deleted\" BOOLEAN,\n          \"transformationHashSet\" BOOLEAN,\n          \"transformationHash\" TEXT,\n          \"transformationVersionSet\" BOOLEAN,\n          \"transformationVersion\" TEXT\n        )\n        WHERE q.\"clientGroupID\" = u.\"clientGroupID\"\n          AND q.\"queryHash\" = u.\"queryHash\"\n      `);\n    }\n\n    return queries;\n  }\n\n  #flushDesires(\n    tx: PostgresTransaction,\n    lc: LogContext,\n  ): PendingQuery<Row[]> | null {\n    if (this.#pendingDesireUpdates.size === 0) {\n      return null;\n    }\n\n    const rows = Array.from(this.#pendingDesireUpdates.values(), row => {\n      const {ttlInterval, ttlMs, inactivatedAtTimestamp, inactivatedAtMs} =\n        convertTTLValues(row.inactivatedAt ?? undefined, row.ttl ?? -1);\n      return {\n        clientGroupID: row.clientGroupID,\n        clientID: row.clientID,\n        queryHash: row.queryHash,\n        patchVersion: row.patchVersion,\n        deleted: row.deleted,\n        ttl: ttlInterval,\n        ttlMs,\n        inactivatedAt: inactivatedAtTimestamp,\n        inactivatedAtMs,\n      };\n    });\n\n    lc.debug?.(`Batch flushing ${rows.length} desire updates`);\n\n    return tx`\n      INSERT INTO ${this.#cvr('desires')} (\n        \"clientGroupID\",\n        \"clientID\",\n        \"queryHash\",\n        \"patchVersion\",\n        \"deleted\",\n        \"ttl\",\n        \"ttlMs\",\n        \"inactivatedAt\",\n        \"inactivatedAtMs\"\n      )\n      SELECT\n        \"clientGroupID\",\n        \"clientID\",\n        \"queryHash\",\n        \"patchVersion\",\n        \"deleted\",\n        \"ttl\",\n        \"ttlMs\",\n        CASE\n          WHEN \"inactivatedAt\" IS NULL THEN NULL\n          -- Divide by 1000 because postgres.js serializeTimestamp treats numbers as ms\n          -- and to_timestamp expects seconds. This matches non-batched behavior.\n          ELSE to_timestamp(\"inactivatedAt\" / 1000.0)\n        END,\n        \"inactivatedAtMs\"\n      FROM json_to_recordset(${rows}) AS x(\n        \"clientGroupID\" TEXT,\n        \"clientID\" TEXT,\n        \"queryHash\" TEXT,\n        \"patchVersion\" TEXT,\n        \"deleted\" BOOLEAN,\n        \"ttl\" INTERVAL,\n        \"ttlMs\" DOUBLE PRECISION,\n        \"inactivatedAt\" DOUBLE PRECISION,\n        \"inactivatedAtMs\" DOUBLE PRECISION\n      )\n      ON CONFLICT (\"clientGroupID\", \"clientID\", \"queryHash\") DO UPDATE SET\n        \"patchVersion\" = excluded.\"patchVersion\",\n        \"deleted\" = excluded.\"deleted\",\n        \"ttl\" = excluded.\"ttl\",\n        \"ttlMs\" = excluded.\"ttlMs\",\n        \"inactivatedAt\" = excluded.\"inactivatedAt\",\n        \"inactivatedAtMs\" = excluded.\"inactivatedAtMs\"\n      `;\n  }\n\n  async #checkVersionAndOwnership(\n    lc: LogContext,\n    tx: PostgresTransaction,\n    expectedCurrentVersion: CVRVersion,\n    lastConnectTime: number,\n  ): Promise<void> {\n    const start = Date.now();\n    lc.debug?.('checking cvr version and ownership');\n    const result = await tx<\n      Pick<InstancesRow, 'version' | 'owner' | 'grantedAt'>[]\n    >`SELECT \"version\", \"owner\", \"grantedAt\" FROM ${this.#cvr('instances')}\n        WHERE \"clientGroupID\" = ${this.#id}\n        FOR UPDATE`;\n    const expected = versionString(expectedCurrentVersion);\n    const {version, owner, grantedAt} =\n      result.length > 0\n        ? result[0]\n        : {\n            version: EMPTY_CVR_VERSION.stateVersion,\n            owner: null,\n            grantedAt: null,\n          };\n    lc.debug?.(\n      'checked cvr version and ownership in ' + (Date.now() - start) + ' ms',\n    );\n    if (owner !== this.#taskID && (grantedAt ?? 0) > lastConnectTime) {\n      throw new OwnershipError(owner, grantedAt, lastConnectTime);\n    }\n    if (version !== expected) {\n      throw new ConcurrentModificationException(expected, version);\n    }\n  }\n\n  async #flush(\n    lc: LogContext,\n    expectedCurrentVersion: CVRVersion,\n    cvr: CVRSnapshot,\n    lastConnectTime: number,\n  ): Promise<CVRFlushStats | null> {\n    const stats: CVRFlushStats = {\n      instances: 0,\n      queries: 0,\n      desires: 0,\n      clients: 0,\n      rows: 0,\n      rowsDeferred: 0,\n      statements: 0,\n    };\n    if (this.#pendingRowRecordUpdates.size) {\n      const existingRowRecords = await this.getRowRecords();\n      this.#rowCount = existingRowRecords.size;\n      for (const [id, row] of this.#pendingRowRecordUpdates.entries()) {\n        if (this.#forceUpdates.has(id)) {\n          continue;\n        }\n        const existing = existingRowRecords.get(id);\n        if (\n          // Don't delete or add an unreferenced row if it's not in the CVR.\n          (existing === undefined && !row?.refCounts) ||\n          // Don't write a row record that exactly matches what's in the CVR.\n          deepEqual(\n            (row ?? undefined) as ReadonlyJSONValue | undefined,\n            existing as ReadonlyJSONValue | undefined,\n          )\n        ) {\n          this.#pendingRowRecordUpdates.delete(id);\n        }\n      }\n    }\n    if (\n      this.#pendingRowRecordUpdates.size === 0 &&\n      this.#writes.size === 0 &&\n      this.#pendingInstanceWrite === undefined &&\n      this.#pendingQueryUpdates.size === 0 &&\n      this.#pendingQueryPartialUpdates.size === 0 &&\n      this.#pendingDesireUpdates.size === 0\n    ) {\n      return null;\n    }\n    // Note: The CVR instance itself is only updated if there are material\n    // changes (i.e. changes to the CVR contents) to flush.\n    this.putInstance(cvr);\n    const start = Date.now();\n    lc.debug?.('flush tx beginning');\n\n    // Use an async callback so we can await the version/ownership check and\n    // validate it INSIDE the transaction. If validation fails, the exception\n    // causes postgres.js to ROLLBACK, ensuring no writes are committed on error.\n    const results = await runTx(\n      this.#db,\n      async tx => {\n        lc.debug?.(`flush tx begun after ${Date.now() - start} ms`);\n\n        // Acquire row-level lock and validate version/ownership before queuing writes.\n        // Throwing here (inside the begin callback) rolls back the transaction so that\n        // no writes are committed when concurrent modification or ownership errors occur.\n        await this.#checkVersionAndOwnership(\n          lc,\n          tx,\n          expectedCurrentVersion,\n          lastConnectTime,\n        );\n\n        const writeQueries = [];\n        if (this.#pendingInstanceWrite) {\n          writeQueries.push(this.#pendingInstanceWrite(tx, lastConnectTime));\n          stats.instances++;\n          stats.statements++;\n        }\n        for (const write of this.#writes) {\n          stats.clients += write.stats.clients ?? 0;\n          stats.rows += write.stats.rows ?? 0;\n\n          writeQueries.push(write.write(tx, lastConnectTime));\n          stats.statements++;\n        }\n\n        // Batch flush config writes\n        // Flush queries first (desires depend on queries via foreign key)\n        const hasQueryUpdates =\n          this.#pendingQueryUpdates.size > 0 ||\n          this.#pendingQueryPartialUpdates.size > 0;\n\n        const desireFlush = this.#flushDesires(tx, lc);\n\n        let queryFlushes: PendingQuery<Row[]>[] = [];\n        if (hasQueryUpdates) {\n          queryFlushes = this.#flushQueries(tx, lc);\n\n          // Count both full updates and partial-only updates\n          const partialOnlyCount = [\n            ...this.#pendingQueryPartialUpdates.keys(),\n          ].filter(key => !this.#pendingQueryUpdates.has(key)).length;\n\n          stats.queries = this.#pendingQueryUpdates.size + partialOnlyCount;\n          stats.statements +=\n            (this.#pendingQueryUpdates.size > 0 ? 1 : 0) +\n            (partialOnlyCount > 0 ? 1 : 0);\n\n          if (desireFlush) {\n            stats.desires = this.#pendingDesireUpdates.size;\n            stats.statements++;\n          }\n        } else if (desireFlush) {\n          stats.desires = this.#pendingDesireUpdates.size;\n          stats.statements++;\n        }\n\n        const rowUpdates = this.#rowCache.executeRowUpdates(\n          tx,\n          cvr.version,\n          this.#pendingRowRecordUpdates,\n          'allow-defer',\n          lc,\n        );\n        stats.statements += rowUpdates.length;\n\n        // Pipeline writes now that the version check has passed.\n        const pipelined = [\n          ...writeQueries,\n          ...queryFlushes,\n          ...(desireFlush ? [desireFlush] : []),\n          ...rowUpdates,\n        ];\n\n        lc.debug?.(`returning ${pipelined.length} queries for pipelining`);\n\n        // Explicitly await all pipelined queries. When the begin callback is async,\n        // postgres.js does not call Promise.all() on the return value the way it does\n        // for sync callbacks, so we must do it ourselves.\n        return Promise.all(pipelined);\n      },\n      {mode: Mode.READ_COMMITTED},\n    );\n\n    lc.debug?.(`flush tx completed after ${Date.now() - start} ms`);\n\n    // Calculate how many row update queries were in the pipeline.\n    // Note: the version check was awaited separately and is not in the results array.\n    const baseQueries =\n      (this.#pendingInstanceWrite ? 1 : 0) +\n      this.#writes.size +\n      (this.#pendingQueryUpdates.size > 0 ? 1 : 0) +\n      ([...this.#pendingQueryPartialUpdates.keys()].filter(\n        key => !this.#pendingQueryUpdates.has(key),\n      ).length > 0\n        ? 1\n        : 0) +\n      (this.#pendingDesireUpdates.size > 0 ? 1 : 0);\n    const rowUpdateCount = results.length - baseQueries;\n\n    const rowsFlushed = rowUpdateCount > 0;\n    if (!rowsFlushed) {\n      stats.rowsDeferred = this.#pendingRowRecordUpdates.size;\n    } else {\n      stats.rows += this.#pendingRowRecordUpdates.size;\n    }\n\n    this.#rowCount = await this.#rowCache.apply(\n      this.#pendingRowRecordUpdates,\n      cvr.version,\n      rowsFlushed,\n    );\n    recordRowsSynced(this.#rowCount);\n\n    return stats;\n  }\n\n  get rowCount(): number {\n    return this.#rowCount;\n  }\n\n  async flush(\n    lc: LogContext,\n    expectedCurrentVersion: CVRVersion,\n    cvr: CVRSnapshot,\n    lastConnectTime: number,\n  ): Promise<CVRFlushStats | null> {\n    const start = performance.now();\n    lc = lc.withContext('cvrFlushID', flushCounter++);\n    try {\n      const stats = await this.#flush(\n        lc,\n        expectedCurrentVersion,\n        cvr,\n        lastConnectTime,\n      );\n      if (stats) {\n        const elapsed = performance.now() - start;\n        lc.info?.(\n          `flushed cvr@${versionString(cvr.version)} ` +\n            `${JSON.stringify(stats)} in (${elapsed} ms)`,\n        );\n        this.#rowCache.recordSyncFlushStats(stats, elapsed);\n      }\n      return stats;\n    } catch (e) {\n      // Clear cached state if an error (e.g. ConcurrentModificationException) is encountered.\n      this.#rowCache.clear();\n      throw e;\n    } finally {\n      this.#writes.clear();\n      this.#pendingInstanceWrite = undefined;\n      this.#pendingRowRecordUpdates.clear();\n      this.#forceUpdates.clear();\n      this.#pendingQueryUpdates.clear();\n      this.#pendingDesireUpdates.clear();\n      this.#pendingQueryPartialUpdates.clear();\n    }\n  }\n\n  hasPendingUpdates(): boolean {\n    return this.#rowCache.hasPendingUpdates();\n  }\n\n  /** Resolves when all pending updates are flushed. */\n  flushed(lc: LogContext): Promise<void> {\n    return this.#rowCache.flushed(lc);\n  }\n\n  async inspectQueries(\n    lc: LogContext,\n    ttlClock: TTLClock,\n    clientID?: string,\n  ): Promise<InspectQueryRow[]> {\n    const db = this.#db;\n    const clientGroupID = this.#id;\n\n    const reader = new TransactionPool(lc, {mode: Mode.READONLY}).run(db);\n    try {\n      return await reader.processReadTask(\n        tx => tx<InspectQueryRow[]>`\n  SELECT DISTINCT ON (d.\"clientID\", d.\"queryHash\")\n    d.\"clientID\",\n    d.\"queryHash\" AS \"queryID\",\n    COALESCE(d.\"ttlMs\", ${DEFAULT_TTL_MS}) AS \"ttl\",\n    d.\"inactivatedAtMs\" AS \"inactivatedAt\",\n    (SELECT COUNT(*)::INT FROM ${this.#cvr('rows')} r \n     WHERE r.\"clientGroupID\" = d.\"clientGroupID\" \n     AND r.\"refCounts\" ? d.\"queryHash\") AS \"rowCount\",\n    q.\"clientAST\" AS \"ast\",\n    (q.\"patchVersion\" IS NOT NULL) AS \"got\",\n    COALESCE(d.\"deleted\", FALSE) AS \"deleted\",\n    q.\"queryName\" AS \"name\",\n    q.\"queryArgs\" AS \"args\"\n  FROM ${this.#cvr('desires')} d\n  LEFT JOIN ${this.#cvr('queries')} q\n    ON q.\"clientGroupID\" = d.\"clientGroupID\"\n   AND q.\"queryHash\" = d.\"queryHash\"\n  WHERE d.\"clientGroupID\" = ${clientGroupID}\n    ${clientID ? tx`AND d.\"clientID\" = ${clientID}` : tx``}\n    AND NOT (\n      d.\"inactivatedAtMs\" IS NOT NULL \n      AND d.\"ttlMs\" IS NOT NULL \n      AND (d.\"inactivatedAtMs\" + d.\"ttlMs\") <= ${ttlClockAsNumber(ttlClock)}\n    )\n  ORDER BY d.\"clientID\", d.\"queryHash\"`,\n      );\n    } finally {\n      reader.setDone();\n    }\n  }\n}\n\n/**\n * This is similar to {@link CVRStore.#checkVersionAndOwnership} except\n * that it only checks the version and is suitable for snapshot reads\n * (i.e. by doing a plain `SELECT` rather than a `SELECT ... FOR UPDATE`).\n */\nexport async function checkVersion(\n  tx: PostgresTransaction,\n  schema: string,\n  clientGroupID: string,\n  expectedCurrentVersion: CVRVersion,\n): Promise<void> {\n  const expected = versionString(expectedCurrentVersion);\n  const result = await tx<Pick<InstancesRow, 'version'>[]>`\n    SELECT version FROM ${tx(schema)}.instances \n      WHERE \"clientGroupID\" = ${clientGroupID}`;\n  const {version} =\n    result.length > 0 ? result[0] : {version: EMPTY_CVR_VERSION.stateVersion};\n  if (version !== expected) {\n    throw new ConcurrentModificationException(expected, version);\n  }\n}\n\nexport class ClientNotFoundError extends ProtocolErrorWithLevel {\n  constructor(message: string) {\n    super(\n      {\n        kind: ErrorKind.ClientNotFound,\n        message,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'warn',\n    );\n  }\n}\n\nexport class ConcurrentModificationException extends ProtocolErrorWithLevel {\n  readonly name = 'ConcurrentModificationException';\n\n  constructor(expectedVersion: string, actualVersion: string) {\n    super(\n      {\n        kind: ErrorKind.Internal,\n        message: `CVR has been concurrently modified. Expected ${expectedVersion}, got ${actualVersion}`,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'warn',\n    );\n  }\n}\n\nexport class OwnershipError extends ProtocolErrorWithLevel {\n  readonly name = 'OwnershipError';\n\n  constructor(\n    owner: string | null,\n    grantedAt: number | null,\n    lastConnectTime: number,\n  ) {\n    super(\n      {\n        kind: ErrorKind.Rehome,\n        message:\n          `CVR ownership was transferred to ${owner} at ` +\n          `${new Date(grantedAt ?? 0).toISOString()} ` +\n          `(last connect time: ${new Date(lastConnectTime).toISOString()})`,\n        maxBackoffMs: 0,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'info',\n    );\n  }\n}\n\nexport class InvalidClientSchemaError extends ProtocolErrorWithLevel {\n  readonly name = 'InvalidClientSchemaError';\n\n  constructor(cause: unknown) {\n    super(\n      {\n        kind: ErrorKind.SchemaVersionNotSupported,\n        message: `Could not parse clientSchema stored in CVR: ${String(cause)}`,\n        origin: ErrorOrigin.ZeroCache,\n      },\n      'warn',\n      {cause},\n    );\n  }\n}\n\nexport class RowsVersionBehindError extends Error {\n  readonly name = 'RowsVersionBehindError';\n  readonly cvrVersion: string;\n  readonly rowsVersion: string | null;\n\n  constructor(cvrVersion: string, rowsVersion: string | null) {\n    super(`rowsVersion (${rowsVersion}) is behind CVR ${cvrVersion}`);\n    this.cvrVersion = cvrVersion;\n    this.rowsVersion = rowsVersion;\n  }\n}\n"],"mappings":"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"}

package/out/zero-cache/src/services/view-syncer/row-record-cache.js

@@ -217,7 +217,7 @@ var RowRecordCache = class {
 		lc.debug?.(`scanning row patches for clients from ${start}`);
 		await this.flushed(lc);
 		const flushMs = Date.now() - startMs;
-		const reader = new TransactionPool(lc, READONLY).run(this.#db);
+		const reader = new TransactionPool(lc, { mode: READONLY }).run(this.#db);
 		try {
 			await reader.processReadTask((tx) => checkVersion(tx, this.#schema, this.#cvrID, current));
 			const { query } = await reader.processReadTask((tx) => {

package/out/zero-cache/src/services/view-syncer/row-record-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"row-record-cache.js","names":["#lc","#db","#schema","#cvrID","#failService","#deferredRowFlushThreshold","#setTimeout","#pending","#cvrFlushTime","#cvrRowsFlushed","#ensureLoaded","#cache","#cvr","#pendingRowsVersion","#flushing","#flush","#flushedRowsVersion","#recordAsyncFlushStats"],"sources":["../../../../../../zero-cache/src/services/view-syncer/row-record-cache.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {type Resolver, resolver} from '@rocicorp/resolver';\nimport type {PendingQuery, Row} from 'postgres';\nimport {startAsyncSpan} from '../../../../otel/src/span.ts';\nimport {CustomKeyMap} from '../../../../shared/src/custom-key-map.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport {promiseVoid} from '../../../../shared/src/resolved-promises.ts';\nimport * as Mode from '../../db/mode-enum.ts';\nimport {runTx} from '../../db/run-transaction.ts';\nimport {TransactionPool} from '../../db/transaction-pool.ts';\nimport {\n  getOrCreateCounter,\n  getOrCreateHistogram,\n} from '../../observability/metrics.ts';\nimport {type PostgresDB, type PostgresTransaction} from '../../types/pg.ts';\nimport {rowIDString} from '../../types/row-key.ts';\nimport {cvrSchema, type ShardID} from '../../types/shards.ts';\nimport {checkVersion, type CVRFlushStats} from './cvr-store.ts';\nimport type {CVRSnapshot} from './cvr.ts';\nimport {\n  rowRecordToRowsRow,\n  type RowsRow,\n  rowsRowToRowRecord,\n} from './schema/cvr.ts';\nimport {\n  cmpVersions,\n  type CVRVersion,\n  type NullableCVRVersion,\n  type RowID,\n  type RowRecord,\n  versionString,\n  versionToNullableCookie,\n} from './schema/types.ts';\nimport {tracer} from './tracer.ts';\n\nconst FLUSH_TYPE_ATTRIBUTE = 'flush.type';\n\n/**\n * The RowRecordCache is an in-memory cache of the `cvr.rows` tables that\n * operates as both a write-through and write-back cache.\n *\n * For \"small\" CVR updates (i.e. zero or small numbers of rows) the\n * RowRecordCache operates as write-through, executing commits in\n * {@link executeRowUpdates()} before they are {@link apply}-ed to the\n * in-memory state.\n *\n * For \"large\" CVR updates (i.e. with many rows), the cache switches to a\n * write-back mode of operation, in which {@link executeRowUpdates()} is a\n * no-op, and {@link apply()} initiates a background task to flush the pending\n * row changes to the store. This allows the client poke to be completed and\n * committed on the client without waiting for the heavyweight operation of\n * committing the row records to the CVR store.\n *\n * Note that when the cache is in write-back mode, all updates become\n * write-back (i.e. asynchronously flushed) until the pending update queue is\n * fully flushed. This is required because updates must be applied in version\n * order. As with all pending work systems in zero-cache, multiple pending\n * updates are coalesced to reduce buildup of work.\n *\n * ### High level consistency\n *\n * Note that the above caching scheme only applies to the row data in `cvr.rows`\n * and corresponding `cvr.rowsVersion` tables. CVR metadata and query\n * information, on the other hand, are always committed before completing the\n * client poke. In this manner, the difference between the `version` column in\n * `cvr.instances` and the analogous column in `cvr.rowsVersion` determines\n * whether the data in the store is consistent, or whether it is awaiting a\n * pending update.\n *\n * The logic in {@link CVRStore#load()} takes this into account by loading both\n * the `cvr.instances` version and the `cvr.rowsVersion` version and checking\n * if they are in sync, waiting for a configurable delay until they are.\n *\n * ### Eventual conversion\n *\n * In the event of a continual stream of mutations (e.g. an animation-style\n * app), it is conceivable that the row record data be continually behind\n * the CVR metadata. In order to effect eventual convergence, a new view-syncer\n * signals the current view-syncer to stop updating by writing new `owner`\n * information to the `cvr.instances` row. This effectively stops the mutation\n * processing (in {@link CVRStore.#checkVersionAndOwnership}) so that the row\n * data can eventually catch up, allowing the new view-syncer to take over.\n *\n * Of course, there is the pathological situation in which a view-syncer\n * process crashes before the pending row updates are flushed. In this case,\n * the wait timeout will elapse and the CVR considered invalid.\n */\nexport class RowRecordCache {\n  // The state in the #cache is always in sync with the CVR metadata\n  // (i.e. cvr.instances). It may contain information that has not yet\n  // been flushed to cvr.rows.\n  #cache: Promise<CustomKeyMap<RowID, RowRecord>> | undefined;\n  readonly #lc: LogContext;\n  readonly #db: PostgresDB;\n  readonly #schema: string;\n  readonly #cvrID: string;\n  readonly #failService: (e: unknown) => void;\n  readonly #deferredRowFlushThreshold: number;\n  readonly #setTimeout: typeof setTimeout;\n\n  // Write-back cache state.\n  readonly #pending = new CustomKeyMap<RowID, RowRecord | null>(rowIDString);\n  #pendingRowsVersion: CVRVersion | null = null;\n  #flushedRowsVersion: CVRVersion | null = null;\n  #flushing: Resolver<void> | null = null;\n\n  readonly #cvrFlushTime = getOrCreateHistogram('sync', 'cvr.flush-time', {\n    description:\n      'Time to flush a CVR transaction. This includes both synchronous ' +\n      'and asynchronous flushes, distinguished by the flush.type attribute',\n    unit: 's',\n  });\n  readonly #cvrRowsFlushed = getOrCreateCounter(\n    'sync',\n    'cvr.rows-flushed',\n    'Number of (changed) rows flushed to a CVR',\n  );\n\n  constructor(\n    lc: LogContext,\n    db: PostgresDB,\n    shard: ShardID,\n    cvrID: string,\n    failService: (e: unknown) => void,\n    deferredRowFlushThreshold = 100,\n    setTimeoutFn = setTimeout,\n  ) {\n    this.#lc = lc;\n    this.#db = db;\n    this.#schema = cvrSchema(shard);\n    this.#cvrID = cvrID;\n    this.#failService = failService;\n    this.#deferredRowFlushThreshold = deferredRowFlushThreshold;\n    this.#setTimeout = setTimeoutFn;\n  }\n\n  recordSyncFlushStats(stats: CVRFlushStats, elapsedMs: number) {\n    this.#cvrFlushTime.record(elapsedMs / 1000, {\n      [FLUSH_TYPE_ATTRIBUTE]: 'sync',\n    });\n    if (stats.rowsDeferred === 0) {\n      this.#cvrRowsFlushed.add(stats.rows);\n    }\n  }\n\n  #recordAsyncFlushStats(rows: number, elapsedMs: number) {\n    this.#cvrFlushTime.record(elapsedMs / 1000, {\n      [FLUSH_TYPE_ATTRIBUTE]: 'async',\n    });\n    this.#cvrRowsFlushed.add(rows);\n  }\n\n  #cvr(table: string) {\n    return this.#db(`${this.#schema}.${table}`);\n  }\n\n  async #ensureLoaded(): Promise<CustomKeyMap<RowID, RowRecord>> {\n    if (this.#cache) {\n      return this.#cache;\n    }\n    const start = Date.now();\n    const r = resolver<CustomKeyMap<RowID, RowRecord>>();\n    r.promise.catch(() => {});\n    // Set this.#cache immediately (before await) so that only one db\n    // query is made even if there are multiple callers.\n    this.#cache = r.promise;\n    try {\n      const cache = await startAsyncSpan(\n        tracer,\n        'RowRecordCache.load',\n        async span => {\n          const cache: CustomKeyMap<RowID, RowRecord> = new CustomKeyMap(\n            rowIDString,\n          );\n          for await (const rows of this.#db<RowsRow[]>`\n            SELECT * FROM ${this.#cvr(`rows`)}\n              WHERE \"clientGroupID\" = ${this.#cvrID} AND \"refCounts\" IS NOT NULL`\n            // TODO(arv): Arbitrary page size\n            .cursor(5000)) {\n            for (const row of rows) {\n              const rowRecord = rowsRowToRowRecord(row);\n              cache.set(rowRecord.id, rowRecord);\n            }\n          }\n          span.setAttribute('rows', cache.size);\n          return cache;\n        },\n      );\n      this.#lc.info?.(\n        `Loaded ${cache.size} row records in ${Date.now() - start} ms`,\n      );\n      r.resolve(cache);\n      return this.#cache;\n    } catch (e) {\n      r.reject(e); // Make sure the error is reflected in the cached promise\n      throw e;\n    }\n  }\n\n  getRowRecords(): Promise<ReadonlyMap<RowID, RowRecord>> {\n    return this.#ensureLoaded();\n  }\n\n  /**\n   * Applies the `rowRecords` corresponding to the `rowsVersion`\n   * to the cache, indicating whether the corresponding updates\n   * (generated by {@link executeRowUpdates}) were `flushed`.\n   *\n   * If `flushed` is false, the RowRecordCache will flush the records\n   * asynchronously.\n   *\n   * Note that `apply()` indicates that the CVR metadata associated with\n   * the `rowRecords` was successfully committed, which essentially means\n   * that this process has the unconditional right (and responsibility) of\n   * following up with a flush of the `rowRecords`. In particular, the\n   * commit of row records are not conditioned on the version or ownership\n   * columns of the `cvr.instances` row.\n   */\n  async apply(\n    rowRecords: Map<RowID, RowRecord | null>,\n    rowsVersion: CVRVersion,\n    flushed: boolean,\n  ): Promise<number> {\n    const cache = await this.#ensureLoaded();\n    for (const [id, row] of rowRecords.entries()) {\n      if (row === null || row.refCounts === null) {\n        cache.delete(id);\n      } else {\n        cache.set(id, row);\n      }\n      if (!flushed) {\n        this.#pending.set(id, row);\n      }\n    }\n    this.#pendingRowsVersion = rowsVersion;\n    // Initiate a flush if not already flushing.\n    if (!flushed && this.#flushing === null) {\n      this.#flushing = resolver();\n      // The #flush() method handles propagating errors to #failService.\n      // Attach a rejection handler to this promise to avoid unhandled\n      // rejections.\n      this.#flushing.promise.catch(() => {});\n      this.#setTimeout(() => this.#flush(), 0);\n    }\n    return cache.size;\n  }\n\n  async #flush() {\n    const flushing = must(this.#flushing);\n    try {\n      while (this.#pendingRowsVersion !== this.#flushedRowsVersion) {\n        const start = performance.now();\n\n        const {rows, rowsVersion} = await runTx(\n          this.#db,\n          tx => {\n            // Note: This code block is synchronous, guaranteeing that the\n            // #pendingRowsVersion is consistent with the #pending rows.\n            const rows = this.#pending.size;\n            const rowsVersion = must(this.#pendingRowsVersion);\n            // Awaiting all of the individual statements incurs too much\n            // overhead. Instead, just catch and log exception(s); the outer\n            // transaction will properly fail.\n            void Promise.all(\n              this.executeRowUpdates(tx, rowsVersion, this.#pending, 'force'),\n            ).catch(e => this.#lc.error?.(`error flushing cvr rows`, e));\n\n            this.#pending.clear();\n            return {rows, rowsVersion};\n          },\n          {mode: Mode.READ_COMMITTED},\n        );\n        const elapsed = performance.now() - start;\n        this.#lc.info?.(\n          `flushed ${rows} rows@${versionString(rowsVersion)} (${elapsed} ms)`,\n        );\n        this.#recordAsyncFlushStats(rows, elapsed);\n        this.#flushedRowsVersion = rowsVersion;\n        // Note: apply() may have called while the transaction was committing,\n        //       which will result in looping to commit the next #pendingRowsVersion.\n      }\n      this.#lc.info?.(\n        `up to date rows@${versionToNullableCookie(this.#flushedRowsVersion)}`,\n      );\n      flushing.resolve();\n      this.#flushing = null;\n    } catch (e) {\n      this.#lc.info?.(`row record flush failed`, e);\n      flushing.reject(e);\n      this.#failService(e);\n    }\n  }\n\n  hasPendingUpdates() {\n    return this.#flushing !== null;\n  }\n\n  /**\n   * Returns a promise that resolves when all outstanding row-records\n   * have been committed.\n   */\n  flushed(lc: LogContext): Promise<void> {\n    if (this.#flushing) {\n      lc.debug?.('awaiting pending row flush');\n      return this.#flushing.promise;\n    }\n    return promiseVoid;\n  }\n\n  clear() {\n    // Note: Only the #cache is cleared. #pending updates, on the other hand,\n    // comprise canonical (i.e. already flushed) data and must be flushed\n    // even if the snapshot of the present state (the #cache) is cleared.\n    this.#cache = undefined;\n  }\n\n  async *catchupRowPatches(\n    lc: LogContext,\n    afterVersion: NullableCVRVersion,\n    upToCVR: CVRSnapshot,\n    current: CVRVersion,\n    excludeQueryHashes: string[] = [],\n  ): AsyncGenerator<RowsRow[], void, undefined> {\n    if (cmpVersions(afterVersion, upToCVR.version) >= 0) {\n      return;\n    }\n\n    const startMs = Date.now();\n    const start = afterVersion ? versionString(afterVersion) : '';\n    const end = versionString(upToCVR.version);\n    lc.debug?.(`scanning row patches for clients from ${start}`);\n\n    // Before accessing the CVR db, pending row records must be flushed.\n    // Note that because catchupRowPatches() is called from within the\n    // view syncer lock, this flush is guaranteed to complete since no\n    // new CVR updates can happen while the lock is held.\n    await this.flushed(lc);\n    const flushMs = Date.now() - startMs;\n\n    const reader = new TransactionPool(lc, Mode.READONLY).run(this.#db);\n    try {\n      // Verify that we are reading the right version of the CVR.\n      await reader.processReadTask(tx =>\n        checkVersion(tx, this.#schema, this.#cvrID, current),\n      );\n\n      const {query} = await reader.processReadTask(tx => {\n        const query =\n          excludeQueryHashes.length === 0\n            ? tx<RowsRow[]>`SELECT * FROM ${this.#cvr('rows')}\n        WHERE \"clientGroupID\" = ${this.#cvrID}\n          AND \"patchVersion\" > ${start}\n          AND \"patchVersion\" <= ${end}`\n            : // Exclude rows that were already sent as part of query hydration.\n              tx<RowsRow[]>`SELECT * FROM ${this.#cvr('rows')}\n        WHERE \"clientGroupID\" = ${this.#cvrID}\n          AND \"patchVersion\" > ${start}\n          AND \"patchVersion\" <= ${end}\n          AND (\"refCounts\" IS NULL OR NOT \"refCounts\" ?| ${excludeQueryHashes})`;\n        return {query};\n      });\n\n      yield* query.cursor(10000);\n    } finally {\n      reader.setDone();\n    }\n\n    const totalMs = Date.now() - startMs;\n    lc.info?.(\n      `finished row catchup (flush: ${flushMs} ms, total: ${totalMs} ms)`,\n    );\n  }\n\n  executeRowUpdates(\n    tx: PostgresTransaction,\n    version: CVRVersion,\n    rowUpdates: Map<RowID, RowRecord | null>,\n    mode: 'allow-defer' | 'force',\n    lc = this.#lc,\n  ): PendingQuery<Row[]>[] {\n    if (\n      mode === 'allow-defer' &&\n      // defer if pending rows are being flushed\n      (this.#flushing !== null ||\n        // or if the new batch is above the limit.\n        rowUpdates.size > this.#deferredRowFlushThreshold)\n    ) {\n      return [];\n    }\n    const rowsVersion = {\n      clientGroupID: this.#cvrID,\n      version: versionString(version),\n    };\n    const pending: PendingQuery<Row[]>[] = [\n      tx`INSERT INTO ${this.#cvr('rowsVersion')} ${tx(rowsVersion)}\n           ON CONFLICT (\"clientGroupID\") \n           DO UPDATE SET ${tx(rowsVersion)}`,\n    ];\n\n    const rowRecordRows: RowsRow[] = [];\n    for (const [id, row] of rowUpdates.entries()) {\n      if (row === null) {\n        pending.push(\n          tx`\n          DELETE FROM ${this.#cvr('rows')}\n            WHERE \"clientGroupID\" = ${this.#cvrID}\n              AND \"schema\" = ${id.schema}\n              AND \"table\" = ${id.table}\n              AND \"rowKey\" = ${id.rowKey}\n       `,\n        );\n      } else {\n        rowRecordRows.push(rowRecordToRowsRow(this.#cvrID, row));\n      }\n    }\n    if (rowRecordRows.length) {\n      pending.push(\n        tx`\n  INSERT INTO ${this.#cvr('rows')}(\n      \"clientGroupID\", \"schema\", \"table\", \"rowKey\", \"rowVersion\", \"patchVersion\", \"refCounts\"\n  ) SELECT\n      \"clientGroupID\", \"schema\", \"table\", \"rowKey\", \"rowVersion\", \"patchVersion\", \"refCounts\"\n    FROM json_to_recordset(${rowRecordRows}) AS x(\n      \"clientGroupID\" TEXT,\n      \"schema\" TEXT,\n      \"table\" TEXT,\n      \"rowKey\" JSONB,\n      \"rowVersion\" TEXT,\n      \"patchVersion\" TEXT,\n      \"refCounts\" JSONB\n  ) ON CONFLICT (\"clientGroupID\", \"schema\", \"table\", \"rowKey\")\n    DO UPDATE SET \"rowVersion\" = excluded.\"rowVersion\",\n      \"patchVersion\" = excluded.\"patchVersion\",\n      \"refCounts\" = excluded.\"refCounts\"\n    `,\n      );\n      lc.info?.(\n        `flushing ${rowUpdates.size} rows (${rowRecordRows.length} inserts, ${\n          rowUpdates.size - rowRecordRows.length\n        } deletes)`,\n      );\n    }\n    return pending;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"row-record-cache.js","names":["#lc","#db","#schema","#cvrID","#failService","#deferredRowFlushThreshold","#setTimeout","#pending","#cvrFlushTime","#cvrRowsFlushed","#ensureLoaded","#cache","#cvr","#pendingRowsVersion","#flushing","#flush","#flushedRowsVersion","#recordAsyncFlushStats"],"sources":["../../../../../../zero-cache/src/services/view-syncer/row-record-cache.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {type Resolver, resolver} from '@rocicorp/resolver';\nimport type {PendingQuery, Row} from 'postgres';\nimport {startAsyncSpan} from '../../../../otel/src/span.ts';\nimport {CustomKeyMap} from '../../../../shared/src/custom-key-map.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport {promiseVoid} from '../../../../shared/src/resolved-promises.ts';\nimport * as Mode from '../../db/mode-enum.ts';\nimport {runTx} from '../../db/run-transaction.ts';\nimport {TransactionPool} from '../../db/transaction-pool.ts';\nimport {\n  getOrCreateCounter,\n  getOrCreateHistogram,\n} from '../../observability/metrics.ts';\nimport {type PostgresDB, type PostgresTransaction} from '../../types/pg.ts';\nimport {rowIDString} from '../../types/row-key.ts';\nimport {cvrSchema, type ShardID} from '../../types/shards.ts';\nimport {checkVersion, type CVRFlushStats} from './cvr-store.ts';\nimport type {CVRSnapshot} from './cvr.ts';\nimport {\n  rowRecordToRowsRow,\n  type RowsRow,\n  rowsRowToRowRecord,\n} from './schema/cvr.ts';\nimport {\n  cmpVersions,\n  type CVRVersion,\n  type NullableCVRVersion,\n  type RowID,\n  type RowRecord,\n  versionString,\n  versionToNullableCookie,\n} from './schema/types.ts';\nimport {tracer} from './tracer.ts';\n\nconst FLUSH_TYPE_ATTRIBUTE = 'flush.type';\n\n/**\n * The RowRecordCache is an in-memory cache of the `cvr.rows` tables that\n * operates as both a write-through and write-back cache.\n *\n * For \"small\" CVR updates (i.e. zero or small numbers of rows) the\n * RowRecordCache operates as write-through, executing commits in\n * {@link executeRowUpdates()} before they are {@link apply}-ed to the\n * in-memory state.\n *\n * For \"large\" CVR updates (i.e. with many rows), the cache switches to a\n * write-back mode of operation, in which {@link executeRowUpdates()} is a\n * no-op, and {@link apply()} initiates a background task to flush the pending\n * row changes to the store. This allows the client poke to be completed and\n * committed on the client without waiting for the heavyweight operation of\n * committing the row records to the CVR store.\n *\n * Note that when the cache is in write-back mode, all updates become\n * write-back (i.e. asynchronously flushed) until the pending update queue is\n * fully flushed. This is required because updates must be applied in version\n * order. As with all pending work systems in zero-cache, multiple pending\n * updates are coalesced to reduce buildup of work.\n *\n * ### High level consistency\n *\n * Note that the above caching scheme only applies to the row data in `cvr.rows`\n * and corresponding `cvr.rowsVersion` tables. CVR metadata and query\n * information, on the other hand, are always committed before completing the\n * client poke. In this manner, the difference between the `version` column in\n * `cvr.instances` and the analogous column in `cvr.rowsVersion` determines\n * whether the data in the store is consistent, or whether it is awaiting a\n * pending update.\n *\n * The logic in {@link CVRStore#load()} takes this into account by loading both\n * the `cvr.instances` version and the `cvr.rowsVersion` version and checking\n * if they are in sync, waiting for a configurable delay until they are.\n *\n * ### Eventual conversion\n *\n * In the event of a continual stream of mutations (e.g. an animation-style\n * app), it is conceivable that the row record data be continually behind\n * the CVR metadata. In order to effect eventual convergence, a new view-syncer\n * signals the current view-syncer to stop updating by writing new `owner`\n * information to the `cvr.instances` row. This effectively stops the mutation\n * processing (in {@link CVRStore.#checkVersionAndOwnership}) so that the row\n * data can eventually catch up, allowing the new view-syncer to take over.\n *\n * Of course, there is the pathological situation in which a view-syncer\n * process crashes before the pending row updates are flushed. In this case,\n * the wait timeout will elapse and the CVR considered invalid.\n */\nexport class RowRecordCache {\n  // The state in the #cache is always in sync with the CVR metadata\n  // (i.e. cvr.instances). It may contain information that has not yet\n  // been flushed to cvr.rows.\n  #cache: Promise<CustomKeyMap<RowID, RowRecord>> | undefined;\n  readonly #lc: LogContext;\n  readonly #db: PostgresDB;\n  readonly #schema: string;\n  readonly #cvrID: string;\n  readonly #failService: (e: unknown) => void;\n  readonly #deferredRowFlushThreshold: number;\n  readonly #setTimeout: typeof setTimeout;\n\n  // Write-back cache state.\n  readonly #pending = new CustomKeyMap<RowID, RowRecord | null>(rowIDString);\n  #pendingRowsVersion: CVRVersion | null = null;\n  #flushedRowsVersion: CVRVersion | null = null;\n  #flushing: Resolver<void> | null = null;\n\n  readonly #cvrFlushTime = getOrCreateHistogram('sync', 'cvr.flush-time', {\n    description:\n      'Time to flush a CVR transaction. This includes both synchronous ' +\n      'and asynchronous flushes, distinguished by the flush.type attribute',\n    unit: 's',\n  });\n  readonly #cvrRowsFlushed = getOrCreateCounter(\n    'sync',\n    'cvr.rows-flushed',\n    'Number of (changed) rows flushed to a CVR',\n  );\n\n  constructor(\n    lc: LogContext,\n    db: PostgresDB,\n    shard: ShardID,\n    cvrID: string,\n    failService: (e: unknown) => void,\n    deferredRowFlushThreshold = 100,\n    setTimeoutFn = setTimeout,\n  ) {\n    this.#lc = lc;\n    this.#db = db;\n    this.#schema = cvrSchema(shard);\n    this.#cvrID = cvrID;\n    this.#failService = failService;\n    this.#deferredRowFlushThreshold = deferredRowFlushThreshold;\n    this.#setTimeout = setTimeoutFn;\n  }\n\n  recordSyncFlushStats(stats: CVRFlushStats, elapsedMs: number) {\n    this.#cvrFlushTime.record(elapsedMs / 1000, {\n      [FLUSH_TYPE_ATTRIBUTE]: 'sync',\n    });\n    if (stats.rowsDeferred === 0) {\n      this.#cvrRowsFlushed.add(stats.rows);\n    }\n  }\n\n  #recordAsyncFlushStats(rows: number, elapsedMs: number) {\n    this.#cvrFlushTime.record(elapsedMs / 1000, {\n      [FLUSH_TYPE_ATTRIBUTE]: 'async',\n    });\n    this.#cvrRowsFlushed.add(rows);\n  }\n\n  #cvr(table: string) {\n    return this.#db(`${this.#schema}.${table}`);\n  }\n\n  async #ensureLoaded(): Promise<CustomKeyMap<RowID, RowRecord>> {\n    if (this.#cache) {\n      return this.#cache;\n    }\n    const start = Date.now();\n    const r = resolver<CustomKeyMap<RowID, RowRecord>>();\n    r.promise.catch(() => {});\n    // Set this.#cache immediately (before await) so that only one db\n    // query is made even if there are multiple callers.\n    this.#cache = r.promise;\n    try {\n      const cache = await startAsyncSpan(\n        tracer,\n        'RowRecordCache.load',\n        async span => {\n          const cache: CustomKeyMap<RowID, RowRecord> = new CustomKeyMap(\n            rowIDString,\n          );\n          for await (const rows of this.#db<RowsRow[]>`\n            SELECT * FROM ${this.#cvr(`rows`)}\n              WHERE \"clientGroupID\" = ${this.#cvrID} AND \"refCounts\" IS NOT NULL`\n            // TODO(arv): Arbitrary page size\n            .cursor(5000)) {\n            for (const row of rows) {\n              const rowRecord = rowsRowToRowRecord(row);\n              cache.set(rowRecord.id, rowRecord);\n            }\n          }\n          span.setAttribute('rows', cache.size);\n          return cache;\n        },\n      );\n      this.#lc.info?.(\n        `Loaded ${cache.size} row records in ${Date.now() - start} ms`,\n      );\n      r.resolve(cache);\n      return this.#cache;\n    } catch (e) {\n      r.reject(e); // Make sure the error is reflected in the cached promise\n      throw e;\n    }\n  }\n\n  getRowRecords(): Promise<ReadonlyMap<RowID, RowRecord>> {\n    return this.#ensureLoaded();\n  }\n\n  /**\n   * Applies the `rowRecords` corresponding to the `rowsVersion`\n   * to the cache, indicating whether the corresponding updates\n   * (generated by {@link executeRowUpdates}) were `flushed`.\n   *\n   * If `flushed` is false, the RowRecordCache will flush the records\n   * asynchronously.\n   *\n   * Note that `apply()` indicates that the CVR metadata associated with\n   * the `rowRecords` was successfully committed, which essentially means\n   * that this process has the unconditional right (and responsibility) of\n   * following up with a flush of the `rowRecords`. In particular, the\n   * commit of row records are not conditioned on the version or ownership\n   * columns of the `cvr.instances` row.\n   */\n  async apply(\n    rowRecords: Map<RowID, RowRecord | null>,\n    rowsVersion: CVRVersion,\n    flushed: boolean,\n  ): Promise<number> {\n    const cache = await this.#ensureLoaded();\n    for (const [id, row] of rowRecords.entries()) {\n      if (row === null || row.refCounts === null) {\n        cache.delete(id);\n      } else {\n        cache.set(id, row);\n      }\n      if (!flushed) {\n        this.#pending.set(id, row);\n      }\n    }\n    this.#pendingRowsVersion = rowsVersion;\n    // Initiate a flush if not already flushing.\n    if (!flushed && this.#flushing === null) {\n      this.#flushing = resolver();\n      // The #flush() method handles propagating errors to #failService.\n      // Attach a rejection handler to this promise to avoid unhandled\n      // rejections.\n      this.#flushing.promise.catch(() => {});\n      this.#setTimeout(() => this.#flush(), 0);\n    }\n    return cache.size;\n  }\n\n  async #flush() {\n    const flushing = must(this.#flushing);\n    try {\n      while (this.#pendingRowsVersion !== this.#flushedRowsVersion) {\n        const start = performance.now();\n\n        const {rows, rowsVersion} = await runTx(\n          this.#db,\n          tx => {\n            // Note: This code block is synchronous, guaranteeing that the\n            // #pendingRowsVersion is consistent with the #pending rows.\n            const rows = this.#pending.size;\n            const rowsVersion = must(this.#pendingRowsVersion);\n            // Awaiting all of the individual statements incurs too much\n            // overhead. Instead, just catch and log exception(s); the outer\n            // transaction will properly fail.\n            void Promise.all(\n              this.executeRowUpdates(tx, rowsVersion, this.#pending, 'force'),\n            ).catch(e => this.#lc.error?.(`error flushing cvr rows`, e));\n\n            this.#pending.clear();\n            return {rows, rowsVersion};\n          },\n          {mode: Mode.READ_COMMITTED},\n        );\n        const elapsed = performance.now() - start;\n        this.#lc.info?.(\n          `flushed ${rows} rows@${versionString(rowsVersion)} (${elapsed} ms)`,\n        );\n        this.#recordAsyncFlushStats(rows, elapsed);\n        this.#flushedRowsVersion = rowsVersion;\n        // Note: apply() may have called while the transaction was committing,\n        //       which will result in looping to commit the next #pendingRowsVersion.\n      }\n      this.#lc.info?.(\n        `up to date rows@${versionToNullableCookie(this.#flushedRowsVersion)}`,\n      );\n      flushing.resolve();\n      this.#flushing = null;\n    } catch (e) {\n      this.#lc.info?.(`row record flush failed`, e);\n      flushing.reject(e);\n      this.#failService(e);\n    }\n  }\n\n  hasPendingUpdates() {\n    return this.#flushing !== null;\n  }\n\n  /**\n   * Returns a promise that resolves when all outstanding row-records\n   * have been committed.\n   */\n  flushed(lc: LogContext): Promise<void> {\n    if (this.#flushing) {\n      lc.debug?.('awaiting pending row flush');\n      return this.#flushing.promise;\n    }\n    return promiseVoid;\n  }\n\n  clear() {\n    // Note: Only the #cache is cleared. #pending updates, on the other hand,\n    // comprise canonical (i.e. already flushed) data and must be flushed\n    // even if the snapshot of the present state (the #cache) is cleared.\n    this.#cache = undefined;\n  }\n\n  async *catchupRowPatches(\n    lc: LogContext,\n    afterVersion: NullableCVRVersion,\n    upToCVR: CVRSnapshot,\n    current: CVRVersion,\n    excludeQueryHashes: string[] = [],\n  ): AsyncGenerator<RowsRow[], void, undefined> {\n    if (cmpVersions(afterVersion, upToCVR.version) >= 0) {\n      return;\n    }\n\n    const startMs = Date.now();\n    const start = afterVersion ? versionString(afterVersion) : '';\n    const end = versionString(upToCVR.version);\n    lc.debug?.(`scanning row patches for clients from ${start}`);\n\n    // Before accessing the CVR db, pending row records must be flushed.\n    // Note that because catchupRowPatches() is called from within the\n    // view syncer lock, this flush is guaranteed to complete since no\n    // new CVR updates can happen while the lock is held.\n    await this.flushed(lc);\n    const flushMs = Date.now() - startMs;\n\n    const reader = new TransactionPool(lc, {mode: Mode.READONLY}).run(this.#db);\n    try {\n      // Verify that we are reading the right version of the CVR.\n      await reader.processReadTask(tx =>\n        checkVersion(tx, this.#schema, this.#cvrID, current),\n      );\n\n      const {query} = await reader.processReadTask(tx => {\n        const query =\n          excludeQueryHashes.length === 0\n            ? tx<RowsRow[]>`SELECT * FROM ${this.#cvr('rows')}\n        WHERE \"clientGroupID\" = ${this.#cvrID}\n          AND \"patchVersion\" > ${start}\n          AND \"patchVersion\" <= ${end}`\n            : // Exclude rows that were already sent as part of query hydration.\n              tx<RowsRow[]>`SELECT * FROM ${this.#cvr('rows')}\n        WHERE \"clientGroupID\" = ${this.#cvrID}\n          AND \"patchVersion\" > ${start}\n          AND \"patchVersion\" <= ${end}\n          AND (\"refCounts\" IS NULL OR NOT \"refCounts\" ?| ${excludeQueryHashes})`;\n        return {query};\n      });\n\n      yield* query.cursor(10000);\n    } finally {\n      reader.setDone();\n    }\n\n    const totalMs = Date.now() - startMs;\n    lc.info?.(\n      `finished row catchup (flush: ${flushMs} ms, total: ${totalMs} ms)`,\n    );\n  }\n\n  executeRowUpdates(\n    tx: PostgresTransaction,\n    version: CVRVersion,\n    rowUpdates: Map<RowID, RowRecord | null>,\n    mode: 'allow-defer' | 'force',\n    lc = this.#lc,\n  ): PendingQuery<Row[]>[] {\n    if (\n      mode === 'allow-defer' &&\n      // defer if pending rows are being flushed\n      (this.#flushing !== null ||\n        // or if the new batch is above the limit.\n        rowUpdates.size > this.#deferredRowFlushThreshold)\n    ) {\n      return [];\n    }\n    const rowsVersion = {\n      clientGroupID: this.#cvrID,\n      version: versionString(version),\n    };\n    const pending: PendingQuery<Row[]>[] = [\n      tx`INSERT INTO ${this.#cvr('rowsVersion')} ${tx(rowsVersion)}\n           ON CONFLICT (\"clientGroupID\") \n           DO UPDATE SET ${tx(rowsVersion)}`,\n    ];\n\n    const rowRecordRows: RowsRow[] = [];\n    for (const [id, row] of rowUpdates.entries()) {\n      if (row === null) {\n        pending.push(\n          tx`\n          DELETE FROM ${this.#cvr('rows')}\n            WHERE \"clientGroupID\" = ${this.#cvrID}\n              AND \"schema\" = ${id.schema}\n              AND \"table\" = ${id.table}\n              AND \"rowKey\" = ${id.rowKey}\n       `,\n        );\n      } else {\n        rowRecordRows.push(rowRecordToRowsRow(this.#cvrID, row));\n      }\n    }\n    if (rowRecordRows.length) {\n      pending.push(\n        tx`\n  INSERT INTO ${this.#cvr('rows')}(\n      \"clientGroupID\", \"schema\", \"table\", \"rowKey\", \"rowVersion\", \"patchVersion\", \"refCounts\"\n  ) SELECT\n      \"clientGroupID\", \"schema\", \"table\", \"rowKey\", \"rowVersion\", \"patchVersion\", \"refCounts\"\n    FROM json_to_recordset(${rowRecordRows}) AS x(\n      \"clientGroupID\" TEXT,\n      \"schema\" TEXT,\n      \"table\" TEXT,\n      \"rowKey\" JSONB,\n      \"rowVersion\" TEXT,\n      \"patchVersion\" TEXT,\n      \"refCounts\" JSONB\n  ) ON CONFLICT (\"clientGroupID\", \"schema\", \"table\", \"rowKey\")\n    DO UPDATE SET \"rowVersion\" = excluded.\"rowVersion\",\n      \"patchVersion\" = excluded.\"patchVersion\",\n      \"refCounts\" = excluded.\"refCounts\"\n    `,\n      );\n      lc.info?.(\n        `flushing ${rowUpdates.size} rows (${rowRecordRows.length} inserts, ${\n          rowUpdates.size - rowRecordRows.length\n        } deletes)`,\n      );\n    }\n    return pending;\n  }\n}\n"],"mappings":"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"}

package/out/zero-client/src/client/version.js

@@ -2,7 +2,7 @@
 /**
 * The current version of Zero.
 */
-var version = "1.3.0-canary.2";
+var version = "1.3.0-canary.3";
 //#endregion
 export { version };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocicorp/zero",
-  "version": "1.3.0-canary.2",
+  "version": "1.3.0-canary.3",
   "description": "Zero is a web framework for serverless web development.",
   "homepage": "https://zero.rocicorp.dev",
   "bugs": {
@@ -132,7 +132,7 @@
     "@rocicorp/lock": "^1.0.4",
     "@rocicorp/logger": "^5.4.0",
     "@rocicorp/resolver": "^1.0.2",
-    "@rocicorp/zero-sqlite3": "^1.0.15",
+    "@rocicorp/zero-sqlite3": "^1.0.17",
     "@standard-schema/spec": "^1.0.0",
     "@types/basic-auth": "^1.1.8",
     "@types/ws": "^8.5.12",