@rocicorp/zero 0.26.1 → 0.26.2-canary.1

package/out/zero-cache/src/services/view-syncer/active-users-gauge.js.map

@@ -1 +1 @@
-{"version":3,"file":"active-users-gauge.js","sources":["../../../../../../zero-cache/src/services/view-syncer/active-users-gauge.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {must} from '../../../../shared/src/must.ts';\nimport {mapValues} from '../../../../shared/src/objects.ts';\nimport {\n  setActiveUsersGetter,\n  type ActiveUsers,\n} from '../../server/anonymous-otel-start.ts';\nimport type {PostgresDB} from '../../types/pg.ts';\nimport {cvrSchema, type ShardID} from '../../types/shards.ts';\nimport {RunningState} from '../running-state.ts';\nimport type {Service} from '../service.ts';\n\nconst MINUTE = 60 * 1000;\nconst DAY = 24 * 60 * MINUTE;\n\ntype Options = {\n  updateIntervalMs?: number;\n};\n\nexport class ActiveUsersGauge implements Service {\n  readonly id = 'active-users-gauge';\n\n  readonly #lc: LogContext;\n  readonly #db: PostgresDB;\n  readonly #schema: string;\n  readonly #updateIntervalMs: number;\n  readonly #state = new RunningState('active-users-gauge');\n  readonly #setActiveUsersGetter: typeof setActiveUsersGetter;\n\n  // latest computed value exposed via the observable gauge callback\n  #lastActiveUsers: ActiveUsers | undefined;\n\n  constructor(\n    lc: LogContext,\n    db: PostgresDB,\n    shard: ShardID,\n    opts: Options = {},\n    setActiveUsersGetterFn = setActiveUsersGetter,\n  ) {\n    this.#lc = lc;\n    this.#db = db;\n    this.#schema = cvrSchema(shard);\n    this.#updateIntervalMs = opts.updateIntervalMs ?? 60 * 1000; // default 1 minute\n    this.#setActiveUsersGetter = setActiveUsersGetterFn;\n  }\n\n  async run(): Promise<void> {\n    while (this.#state.shouldRun()) {\n      try {\n        const now = Date.now();\n        const since30day = now - DAY * 30;\n        const since7day = now - DAY * 7;\n        const since1day = now - DAY;\n\n        // This query performs a single scan over the `profile_ids_last_active`\n        // index to compute aggregated results for all of our active user\n        // metric variants.\n        //\n        // The eventually-correct metrics are `users_#da` which count distinct\n        // profileIDs produced by the zero-client (i.e. starting with 'p').\n        // The `users_#da_legacy` metrics include back-filled profileIDs (which\n        // start with `cg`) and will over-count users on apps using memstore.\n        const [actives] = await this.#db<[ActiveUsers]> /*sql*/ `\n          SELECT \n            COUNT(*) FILTER (WHERE \"lastActive\" >= ${since1day}) AS active_users_last_day,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since1day} AND starts_with(\"profileID\", 'p')) AS users_1da,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since7day} AND starts_with(\"profileID\", 'p')) AS users_7da,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE starts_with(\"profileID\", 'p')) AS users_30da,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since1day}) AS users_1da_legacy,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since7day}) AS users_7da_legacy,\n            COUNT(DISTINCT(\"profileID\")) AS users_30da_legacy\n            FROM ${this.#db(this.#schema)}.instances\n            WHERE \"lastActive\" >= ${since30day}\n        `;\n        // Determine if the getter needs to be set (i.e. the first time).\n        const setGetter = this.#lastActiveUsers === undefined;\n        this.#lastActiveUsers = mapValues(actives, bigVal => Number(bigVal));\n\n        // Set the getter after the first value is computed\n        if (setGetter) {\n          this.#setActiveUsersGetter(() => must(this.#lastActiveUsers));\n        }\n\n        this.#lc.debug?.(`updated active-users gauge`, this.#lastActiveUsers);\n      } catch (e) {\n        this.#lc.warn?.('error updating active-users gauge', e);\n      }\n\n      await this.#state.sleep(this.#updateIntervalMs);\n    }\n  }\n\n  stop(): Promise<void> {\n    this.#state.stop(this.#lc);\n    return this.#state.stopped();\n  }\n}\n"],"names":[],"mappings":";;;;;AAYA,MAAM,SAAS,KAAK;AACpB,MAAM,MAAM,KAAK,KAAK;AAMf,MAAM,iBAAoC;AAAA,EACtC,KAAK;AAAA,EAEL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS,IAAI,aAAa,oBAAoB;AAAA,EAC9C;AAAA;AAAA,EAGT;AAAA,EAEA,YACE,IACA,IACA,OACA,OAAgB,CAAA,GAChB,yBAAyB,sBACzB;AACA,SAAK,MAAM;AACX,SAAK,MAAM;AACX,SAAK,UAAU,UAAU,KAAK;AAC9B,SAAK,oBAAoB,KAAK,oBAAoB,KAAK;AACvD,SAAK,wBAAwB;AAAA,EAC/B;AAAA,EAEA,MAAM,MAAqB;AACzB,WAAO,KAAK,OAAO,aAAa;AAC9B,UAAI;AACF,cAAM,MAAM,KAAK,IAAA;AACjB,cAAM,aAAa,MAAM,MAAM;AAC/B,cAAM,YAAY,MAAM,MAAM;AAC9B,cAAM,YAAY,MAAM;AAUxB,cAAM,CAAC,OAAO,IAAI,MAAM,KAAK;AAAA;AAAA,qDAEgB,SAAS;AAAA,yEACW,SAAS;AAAA,yEACT,SAAS;AAAA;AAAA,yEAET,SAAS;AAAA,yEACT,SAAS;AAAA;AAAA,mBAE/D,KAAK,IAAI,KAAK,OAAO,CAAC;AAAA,oCACL,UAAU;AAAA;AAGtC,cAAM,YAAY,KAAK,qBAAqB;AAC5C,aAAK,mBAAmB,UAAU,SAAS,CAAA,WAAU,OAAO,MAAM,CAAC;AAGnE,YAAI,WAAW;AACb,eAAK,sBAAsB,MAAM,KAAK,KAAK,gBAAgB,CAAC;AAAA,QAC9D;AAEA,aAAK,IAAI,QAAQ,8BAA8B,KAAK,gBAAgB;AAAA,MACtE,SAAS,GAAG;AACV,aAAK,IAAI,OAAO,qCAAqC,CAAC;AAAA,MACxD;AAEA,YAAM,KAAK,OAAO,MAAM,KAAK,iBAAiB;AAAA,IAChD;AAAA,EACF;AAAA,EAEA,OAAsB;AACpB,SAAK,OAAO,KAAK,KAAK,GAAG;AACzB,WAAO,KAAK,OAAO,QAAA;AAAA,EACrB;AACF;"}
+{"version":3,"file":"active-users-gauge.js","names":["#lc","#db","#schema","#updateIntervalMs","#state","#setActiveUsersGetter","#lastActiveUsers"],"sources":["../../../../../../zero-cache/src/services/view-syncer/active-users-gauge.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {must} from '../../../../shared/src/must.ts';\nimport {mapValues} from '../../../../shared/src/objects.ts';\nimport {\n  setActiveUsersGetter,\n  type ActiveUsers,\n} from '../../server/anonymous-otel-start.ts';\nimport type {PostgresDB} from '../../types/pg.ts';\nimport {cvrSchema, type ShardID} from '../../types/shards.ts';\nimport {RunningState} from '../running-state.ts';\nimport type {Service} from '../service.ts';\n\nconst MINUTE = 60 * 1000;\nconst DAY = 24 * 60 * MINUTE;\n\ntype Options = {\n  updateIntervalMs?: number;\n};\n\nexport class ActiveUsersGauge implements Service {\n  readonly id = 'active-users-gauge';\n\n  readonly #lc: LogContext;\n  readonly #db: PostgresDB;\n  readonly #schema: string;\n  readonly #updateIntervalMs: number;\n  readonly #state = new RunningState('active-users-gauge');\n  readonly #setActiveUsersGetter: typeof setActiveUsersGetter;\n\n  // latest computed value exposed via the observable gauge callback\n  #lastActiveUsers: ActiveUsers | undefined;\n\n  constructor(\n    lc: LogContext,\n    db: PostgresDB,\n    shard: ShardID,\n    opts: Options = {},\n    setActiveUsersGetterFn = setActiveUsersGetter,\n  ) {\n    this.#lc = lc;\n    this.#db = db;\n    this.#schema = cvrSchema(shard);\n    this.#updateIntervalMs = opts.updateIntervalMs ?? 60 * 1000; // default 1 minute\n    this.#setActiveUsersGetter = setActiveUsersGetterFn;\n  }\n\n  async run(): Promise<void> {\n    while (this.#state.shouldRun()) {\n      try {\n        const now = Date.now();\n        const since30day = now - DAY * 30;\n        const since7day = now - DAY * 7;\n        const since1day = now - DAY;\n\n        // This query performs a single scan over the `profile_ids_last_active`\n        // index to compute aggregated results for all of our active user\n        // metric variants.\n        //\n        // The eventually-correct metrics are `users_#da` which count distinct\n        // profileIDs produced by the zero-client (i.e. starting with 'p').\n        // The `users_#da_legacy` metrics include back-filled profileIDs (which\n        // start with `cg`) and will over-count users on apps using memstore.\n        const [actives] = await this.#db<[ActiveUsers]> /*sql*/ `\n          SELECT \n            COUNT(*) FILTER (WHERE \"lastActive\" >= ${since1day}) AS active_users_last_day,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since1day} AND starts_with(\"profileID\", 'p')) AS users_1da,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since7day} AND starts_with(\"profileID\", 'p')) AS users_7da,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE starts_with(\"profileID\", 'p')) AS users_30da,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since1day}) AS users_1da_legacy,\n            COUNT(DISTINCT(\"profileID\")) FILTER (WHERE \"lastActive\" >= ${since7day}) AS users_7da_legacy,\n            COUNT(DISTINCT(\"profileID\")) AS users_30da_legacy\n            FROM ${this.#db(this.#schema)}.instances\n            WHERE \"lastActive\" >= ${since30day}\n        `;\n        // Determine if the getter needs to be set (i.e. the first time).\n        const setGetter = this.#lastActiveUsers === undefined;\n        this.#lastActiveUsers = mapValues(actives, bigVal => Number(bigVal));\n\n        // Set the getter after the first value is computed\n        if (setGetter) {\n          this.#setActiveUsersGetter(() => must(this.#lastActiveUsers));\n        }\n\n        this.#lc.debug?.(`updated active-users gauge`, this.#lastActiveUsers);\n      } catch (e) {\n        this.#lc.warn?.('error updating active-users gauge', e);\n      }\n\n      await this.#state.sleep(this.#updateIntervalMs);\n    }\n  }\n\n  stop(): Promise<void> {\n    this.#state.stop(this.#lc);\n    return this.#state.stopped();\n  }\n}\n"],"mappings":";;;;;;AAaA,IAAM,MAAM,QADG,KAAK;AAOpB,IAAa,mBAAb,MAAiD;CAC/C,KAAc;CAEd;CACA;CACA;CACA;CACA,SAAkB,IAAI,aAAa,qBAAqB;CACxD;CAGA;CAEA,YACE,IACA,IACA,OACA,OAAgB,EAAE,EAClB,yBAAyB,sBACzB;AACA,QAAA,KAAW;AACX,QAAA,KAAW;AACX,QAAA,SAAe,UAAU,MAAM;AAC/B,QAAA,mBAAyB,KAAK,oBAAoB,KAAK;AACvD,QAAA,uBAA6B;;CAG/B,MAAM,MAAqB;AACzB,SAAO,MAAA,MAAY,WAAW,EAAE;AAC9B,OAAI;IACF,MAAM,MAAM,KAAK,KAAK;IACtB,MAAM,aAAa,MAAM,MAAM;IAC/B,MAAM,YAAY,MAAM,MAAM;IAC9B,MAAM,YAAY,MAAM;IAUxB,MAAM,CAAC,WAAW,MAAM,MAAA,EAAgC;;qDAEX,UAAU;yEACU,UAAU;yEACV,UAAU;;yEAEV,UAAU;yEACV,UAAU;;mBAEhE,MAAA,GAAS,MAAA,OAAa,CAAC;oCACN,WAAW;;IAGvC,MAAM,YAAY,MAAA,oBAA0B,KAAA;AAC5C,UAAA,kBAAwB,UAAU,UAAS,WAAU,OAAO,OAAO,CAAC;AAGpE,QAAI,UACF,OAAA,2BAAiC,KAAK,MAAA,gBAAsB,CAAC;AAG/D,UAAA,GAAS,QAAQ,8BAA8B,MAAA,gBAAsB;YAC9D,GAAG;AACV,UAAA,GAAS,OAAO,qCAAqC,EAAE;;AAGzD,SAAM,MAAA,MAAY,MAAM,MAAA,iBAAuB;;;CAInD,OAAsB;AACpB,QAAA,MAAY,KAAK,MAAA,GAAS;AAC1B,SAAO,MAAA,MAAY,SAAS"}

package/out/zero-cache/src/services/view-syncer/client-handler.js

@@ -1,315 +1,273 @@
-import { unreachable, assert } from "../../../../shared/src/asserts.js";
+import { assert, unreachable } from "../../../../shared/src/asserts.js";
 import { assertJSONValue } from "../../../../shared/src/json.js";
 import { promiseVoid } from "../../../../shared/src/resolved-promises.js";
-import { parse } from "../../../../shared/src/valita.js";
+import { parse, valita_exports } from "../../../../shared/src/valita.js";
 import { rowSchema } from "../../../../zero-protocol/src/data.js";
 import { ProtocolError } from "../../../../zero-protocol/src/error.js";
 import { primaryKeyValueRecordSchema } from "../../../../zero-protocol/src/primary-key.js";
 import { mutationResultSchema } from "../../../../zero-protocol/src/push.js";
-import { getOrCreateHistogram, getOrCreateCounter } from "../../observability/metrics.js";
-import { getLogLevel, wrapWithProtocolError } from "../../types/error-with-level.js";
 import { upstreamSchema } from "../../types/shards.js";
-import { cookieToVersion, versionToCookie, cmpVersions, versionToNullableCookie } from "./schema/types.js";
-import { object, number, string } from "@badrap/valita";
-const NOOP = {
-  addPatch: () => promiseVoid,
-  cancel: () => promiseVoid,
-  end: () => promiseVoid
+import { getOrCreateCounter, getOrCreateHistogram } from "../../observability/metrics.js";
+import { cmpVersions, cookieToVersion, versionToCookie, versionToNullableCookie } from "./schema/types.js";
+import { getLogLevel, wrapWithProtocolError } from "../../types/error-with-level.js";
+//#region ../zero-cache/src/services/view-syncer/client-handler.ts
+var NOOP = {
+	addPatch: () => promiseVoid,
+	cancel: () => promiseVoid,
+	end: () => promiseVoid
 };
+/** Wraps PokeHandlers for multiple clients in a single PokeHandler. */
 function startPoke(clients, tentativeVersion) {
-  const pokers = clients.map((c) => c.startPoke(tentativeVersion));
-  return {
-    addPatch: async (patch) => {
-      await Promise.allSettled(pokers.map((poker) => poker.addPatch(patch)));
-    },
-    cancel: async () => {
-      await Promise.allSettled(pokers.map((poker) => poker.cancel()));
-    },
-    end: async (finalVersion) => {
-      await Promise.allSettled(pokers.map((poker) => poker.end(finalVersion)));
-    }
-  };
-}
-const PART_COUNT_FLUSH_THRESHOLD = 100;
-class ClientHandler {
-  #clientGroupID;
-  clientID;
-  wsID;
-  #zeroClientsTable;
-  #zeroMutationsTable;
-  #lc;
-  #downstream;
-  #baseVersion;
-  #pokeTime = getOrCreateHistogram("sync", "poke.time", {
-    description: "Time elapsed for each poke transaction. Canceled / noop pokes are excluded.",
-    unit: "s"
-  });
-  #pokeTransactions = getOrCreateCounter(
-    "sync",
-    "poke.transactions",
-    "Count of poke transactions."
-  );
-  #pokedRows = getOrCreateCounter(
-    "sync",
-    "poke.rows",
-    "Count of poked rows."
-  );
-  constructor(lc, clientGroupID, clientID, wsID, shard, baseCookie, downstream) {
-    lc.debug?.("new client handler");
-    this.#clientGroupID = clientGroupID;
-    this.clientID = clientID;
-    this.wsID = wsID;
-    this.#zeroClientsTable = `${upstreamSchema(shard)}.clients`;
-    this.#zeroMutationsTable = `${upstreamSchema(shard)}.mutations`;
-    this.#lc = lc;
-    this.#downstream = downstream;
-    this.#baseVersion = cookieToVersion(baseCookie);
-  }
-  version() {
-    return this.#baseVersion;
-  }
-  async #push(msg) {
-    const { result } = this.#downstream.push(msg);
-    await result;
-  }
-  fail(e) {
-    this.#lc[getLogLevel(e)]?.(
-      `view-syncer closing connection with error: ${String(e)}`,
-      e
-    );
-    this.#downstream.fail(wrapWithProtocolError(e));
-  }
-  close(reason) {
-    this.#lc.debug?.(`view-syncer closing connection: ${reason}`);
-    this.#downstream.cancel();
-  }
-  startPoke(tentativeVersion) {
-    const pokeID = versionToCookie(tentativeVersion);
-    const lc = this.#lc.withContext("pokeID", pokeID);
-    if (cmpVersions(this.#baseVersion, tentativeVersion) >= 0) {
-      lc.info?.(`already caught up, not sending poke.`);
-      return NOOP;
-    }
-    const baseCookie = versionToNullableCookie(this.#baseVersion);
-    const cookie = versionToCookie(tentativeVersion);
-    lc.info?.(`starting poke from ${baseCookie} to ${cookie}`);
-    const start = performance.now();
-    const pokeStart = { pokeID, baseCookie };
-    let pokeStarted = false;
-    let body;
-    let partCount = 0;
-    const ensureBody = async () => {
-      if (!pokeStarted) {
-        await this.#push(["pokeStart", pokeStart]);
-        pokeStarted = true;
-      }
-      return body ??= { pokeID };
-    };
-    const flushBody = async () => {
-      if (body) {
-        await this.#push(["pokePart", body]);
-        body = void 0;
-        partCount = 0;
-      }
-    };
-    const addPatch = async (patchToVersion) => {
-      const { patch, toVersion } = patchToVersion;
-      if (cmpVersions(toVersion, this.#baseVersion) <= 0) {
-        return;
-      }
-      const body2 = await ensureBody();
-      const { type, op } = patch;
-      switch (type) {
-        case "query": {
-          const patches = patch.clientID ? (body2.desiredQueriesPatches ??= {})[patch.clientID] ??= [] : body2.gotQueriesPatch ??= [];
-          if (op === "put") {
-            patches.push({ op, hash: patch.id });
-          } else {
-            patches.push({ op, hash: patch.id });
-          }
-          break;
-        }
-        case "row":
-          if (patch.id.table === this.#zeroClientsTable) {
-            this.#updateLMIDs(body2.lastMutationIDChanges ??= {}, patch);
-          } else if (patch.id.table === this.#zeroMutationsTable) {
-            const patches = body2.mutationsPatch ??= [];
-            if (op === "put") {
-              const row = parse(
-                ensureSafeJSON(patch.contents),
-                mutationRowSchema,
-                "passthrough"
-              );
-              patches.push({
-                op: "put",
-                mutation: {
-                  id: {
-                    clientID: row.clientID,
-                    id: row.mutationID
-                  },
-                  result: row.result
-                }
-              });
-            } else {
-              const { clientID, mutationID } = patch.id.rowKey;
-              assert(
-                typeof clientID === "string",
-                "client id must be a string"
-              );
-              const id = Number(mutationID);
-              assert(
-                !Number.isNaN(id) && Number.isFinite(id) && id >= 0,
-                "mutation id must be a finite number"
-              );
-              patches.push({
-                op: "del",
-                id: {
-                  clientID,
-                  id
-                }
-              });
-            }
-          } else {
-            (body2.rowsPatch ??= []).push(makeRowPatch(patch));
-          }
-          break;
-        default:
-          unreachable();
-      }
-      if (++partCount >= PART_COUNT_FLUSH_THRESHOLD) {
-        await flushBody();
-      }
-    };
-    return {
-      addPatch: async (patchToVersion) => {
-        try {
-          await addPatch(patchToVersion);
-          if (patchToVersion.patch.type === "row") {
-            this.#pokedRows.add(1);
-          }
-        } catch (e) {
-          this.#downstream.fail(wrapWithProtocolError(e));
-        }
-      },
-      cancel: async () => {
-        if (pokeStarted) {
-          await this.#push(["pokeEnd", { pokeID, cookie: "", cancel: true }]);
-        }
-      },
-      end: async (finalVersion) => {
-        const cookie2 = versionToCookie(finalVersion);
-        if (!pokeStarted) {
-          if (cmpVersions(this.#baseVersion, finalVersion) === 0) {
-            return;
-          }
-          await this.#push(["pokeStart", pokeStart]);
-        } else if (cmpVersions(this.#baseVersion, finalVersion) >= 0) {
-          throw new Error(
-            `Patches were sent but finalVersion ${finalVersion} is not greater than baseVersion ${this.#baseVersion}`
-          );
-        }
-        await flushBody();
-        await this.#push(["pokeEnd", { pokeID, cookie: cookie2 }]);
-        this.#baseVersion = finalVersion;
-        const elapsed = performance.now() - start;
-        this.#pokeTransactions.add(1);
-        this.#pokeTime.record(elapsed / 1e3);
-      }
-    };
-  }
-  async sendDeleteClients(lc, deletedClientIDs, deletedClientGroupIDs) {
-    const deleteClientsBody = {};
-    if (deletedClientIDs.length > 0) {
-      deleteClientsBody.clientIDs = deletedClientIDs;
-    }
-    if (deletedClientGroupIDs.length > 0) {
-      deleteClientsBody.clientGroupIDs = deletedClientGroupIDs;
-    }
-    lc.debug?.("sending deleteClients", deleteClientsBody);
-    await this.#push(["deleteClients", deleteClientsBody]);
-  }
-  sendQueryTransformApplicationErrors(errors) {
-    void this.#push(["transformError", errors]);
-  }
-  sendQueryTransformFailedError(error) {
-    this.fail(new ProtocolError(error));
-  }
-  sendInspectResponse(lc, response) {
-    lc.debug?.("sending inspect response", response);
-    this.#downstream.push(["inspect", response]);
-  }
-  #updateLMIDs(lmids, patch) {
-    if (patch.op === "put") {
-      const row = ensureSafeJSON(patch.contents);
-      const { clientGroupID, clientID, lastMutationID } = parse(
-        row,
-        lmidRowSchema,
-        "passthrough"
-      );
-      if (clientGroupID !== this.#clientGroupID) {
-        this.#lc.error?.(
-          `Received clients row for wrong clientGroupID. Ignoring.`,
-          clientGroupID
-        );
-      } else {
-        lmids[clientID] = lastMutationID;
-      }
-    } else {
-      patch.op;
-    }
-  }
+	const pokers = clients.map((c) => c.startPoke(tentativeVersion));
+	return {
+		addPatch: async (patch) => {
+			await Promise.allSettled(pokers.map((poker) => poker.addPatch(patch)));
+		},
+		cancel: async () => {
+			await Promise.allSettled(pokers.map((poker) => poker.cancel()));
+		},
+		end: async (finalVersion) => {
+			await Promise.allSettled(pokers.map((poker) => poker.end(finalVersion)));
+		}
+	};
 }
-const lmidRowSchema = object({
-  clientGroupID: string(),
-  clientID: string(),
-  lastMutationID: number()
-  // Actually returned as a bigint, but converted by ensureSafeJSON().
+var PART_COUNT_FLUSH_THRESHOLD = 100;
+/**
+* Handles a single `ViewSyncer` connection.
+*/
+var ClientHandler = class {
+	#clientGroupID;
+	clientID;
+	wsID;
+	#zeroClientsTable;
+	#zeroMutationsTable;
+	#lc;
+	#downstream;
+	#baseVersion;
+	#pokeTime = getOrCreateHistogram("sync", "poke.time", {
+		description: "Time elapsed for each poke transaction. Canceled / noop pokes are excluded.",
+		unit: "s"
+	});
+	#pokeTransactions = getOrCreateCounter("sync", "poke.transactions", "Count of poke transactions.");
+	#pokedRows = getOrCreateCounter("sync", "poke.rows", "Count of poked rows.");
+	constructor(lc, clientGroupID, clientID, wsID, shard, baseCookie, downstream) {
+		lc.debug?.("new client handler");
+		this.#clientGroupID = clientGroupID;
+		this.clientID = clientID;
+		this.wsID = wsID;
+		this.#zeroClientsTable = `${upstreamSchema(shard)}.clients`;
+		this.#zeroMutationsTable = `${upstreamSchema(shard)}.mutations`;
+		this.#lc = lc;
+		this.#downstream = downstream;
+		this.#baseVersion = cookieToVersion(baseCookie);
+	}
+	version() {
+		return this.#baseVersion;
+	}
+	async #push(msg) {
+		const { result } = this.#downstream.push(msg);
+		await result;
+	}
+	fail(e) {
+		this.#lc[getLogLevel(e)]?.(`view-syncer closing connection with error: ${String(e)}`, e);
+		this.#downstream.fail(wrapWithProtocolError(e));
+	}
+	close(reason) {
+		this.#lc.debug?.(`view-syncer closing connection: ${reason}`);
+		this.#downstream.cancel();
+	}
+	startPoke(tentativeVersion) {
+		const pokeID = versionToCookie(tentativeVersion);
+		const lc = this.#lc.withContext("pokeID", pokeID);
+		if (cmpVersions(this.#baseVersion, tentativeVersion) >= 0) {
+			lc.info?.(`already caught up, not sending poke.`);
+			return NOOP;
+		}
+		const baseCookie = versionToNullableCookie(this.#baseVersion);
+		const cookie = versionToCookie(tentativeVersion);
+		lc.info?.(`starting poke from ${baseCookie} to ${cookie}`);
+		const start = performance.now();
+		const pokeStart = {
+			pokeID,
+			baseCookie
+		};
+		let pokeStarted = false;
+		let body;
+		let partCount = 0;
+		const ensureBody = async () => {
+			if (!pokeStarted) {
+				await this.#push(["pokeStart", pokeStart]);
+				pokeStarted = true;
+			}
+			return body ??= { pokeID };
+		};
+		const flushBody = async () => {
+			if (body) {
+				await this.#push(["pokePart", body]);
+				body = void 0;
+				partCount = 0;
+			}
+		};
+		const addPatch = async (patchToVersion) => {
+			const { patch, toVersion } = patchToVersion;
+			if (cmpVersions(toVersion, this.#baseVersion) <= 0) return;
+			const body = await ensureBody();
+			const { type, op } = patch;
+			switch (type) {
+				case "query": {
+					const patches = patch.clientID ? (body.desiredQueriesPatches ??= {})[patch.clientID] ??= [] : body.gotQueriesPatch ??= [];
+					if (op === "put") patches.push({
+						op,
+						hash: patch.id
+					});
+					else patches.push({
+						op,
+						hash: patch.id
+					});
+					break;
+				}
+				case "row":
+					if (patch.id.table === this.#zeroClientsTable) this.#updateLMIDs(body.lastMutationIDChanges ??= {}, patch);
+					else if (patch.id.table === this.#zeroMutationsTable) {
+						const patches = body.mutationsPatch ??= [];
+						if (op === "put") {
+							const row = parse(ensureSafeJSON(patch.contents), mutationRowSchema, "passthrough");
+							patches.push({
+								op: "put",
+								mutation: {
+									id: {
+										clientID: row.clientID,
+										id: row.mutationID
+									},
+									result: row.result
+								}
+							});
+						} else {
+							const { clientID, mutationID } = patch.id.rowKey;
+							assert(typeof clientID === "string", "client id must be a string");
+							const id = Number(mutationID);
+							assert(!Number.isNaN(id) && Number.isFinite(id) && id >= 0, "mutation id must be a finite number");
+							patches.push({
+								op: "del",
+								id: {
+									clientID,
+									id
+								}
+							});
+						}
+					} else (body.rowsPatch ??= []).push(makeRowPatch(patch));
+					break;
+				default: unreachable(patch);
+			}
+			if (++partCount >= PART_COUNT_FLUSH_THRESHOLD) await flushBody();
+		};
+		return {
+			addPatch: async (patchToVersion) => {
+				try {
+					await addPatch(patchToVersion);
+					if (patchToVersion.patch.type === "row") this.#pokedRows.add(1);
+				} catch (e) {
+					this.#downstream.fail(wrapWithProtocolError(e));
+				}
+			},
+			cancel: async () => {
+				if (pokeStarted) await this.#push(["pokeEnd", {
+					pokeID,
+					cookie: "",
+					cancel: true
+				}]);
+			},
+			end: async (finalVersion) => {
+				const cookie = versionToCookie(finalVersion);
+				if (!pokeStarted) {
+					if (cmpVersions(this.#baseVersion, finalVersion) === 0) return;
+					await this.#push(["pokeStart", pokeStart]);
+				} else if (cmpVersions(this.#baseVersion, finalVersion) >= 0) throw new Error(`Patches were sent but finalVersion ${finalVersion} is not greater than baseVersion ${this.#baseVersion}`);
+				await flushBody();
+				await this.#push(["pokeEnd", {
+					pokeID,
+					cookie
+				}]);
+				this.#baseVersion = finalVersion;
+				const elapsed = performance.now() - start;
+				this.#pokeTransactions.add(1);
+				this.#pokeTime.record(elapsed / 1e3);
+			}
+		};
+	}
+	async sendDeleteClients(lc, deletedClientIDs, deletedClientGroupIDs) {
+		const deleteClientsBody = {};
+		if (deletedClientIDs.length > 0) deleteClientsBody.clientIDs = deletedClientIDs;
+		if (deletedClientGroupIDs.length > 0) deleteClientsBody.clientGroupIDs = deletedClientGroupIDs;
+		lc.debug?.("sending deleteClients", deleteClientsBody);
+		await this.#push(["deleteClients", deleteClientsBody]);
+	}
+	sendQueryTransformApplicationErrors(errors) {
+		this.#push(["transformError", errors]);
+	}
+	sendQueryTransformFailedError(error) {
+		this.fail(new ProtocolError(error));
+	}
+	sendInspectResponse(lc, response) {
+		lc.debug?.("sending inspect response", response);
+		this.#downstream.push(["inspect", response]);
+	}
+	#updateLMIDs(lmids, patch) {
+		if (patch.op === "put") {
+			const { clientGroupID, clientID, lastMutationID } = parse(ensureSafeJSON(patch.contents), lmidRowSchema, "passthrough");
+			if (clientGroupID !== this.#clientGroupID) this.#lc.error?.(`Received clients row for wrong clientGroupID. Ignoring.`, clientGroupID);
+			else lmids[clientID] = lastMutationID;
+		} else patch.op;
+	}
+};
+var lmidRowSchema = valita_exports.object({
+	clientGroupID: valita_exports.string(),
+	clientID: valita_exports.string(),
+	lastMutationID: valita_exports.number()
 });
-const mutationRowSchema = object({
-  clientGroupID: string(),
-  clientID: string(),
-  mutationID: number(),
-  result: mutationResultSchema
+var mutationRowSchema = valita_exports.object({
+	clientGroupID: valita_exports.string(),
+	clientID: valita_exports.string(),
+	mutationID: valita_exports.number(),
+	result: mutationResultSchema
 });
 function makeRowPatch(patch) {
-  const {
-    op,
-    id: { table: tableName, rowKey: id }
-  } = patch;
-  switch (op) {
-    case "put":
-      return {
-        op: "put",
-        tableName,
-        value: parse(ensureSafeJSON(patch.contents), rowSchema)
-      };
-    case "del":
-      return {
-        op,
-        tableName,
-        id: parse(id, primaryKeyValueRecordSchema)
-      };
-    default:
-      unreachable();
-  }
+	const { op, id: { table: tableName, rowKey: id } } = patch;
+	switch (op) {
+		case "put": return {
+			op: "put",
+			tableName,
+			value: parse(ensureSafeJSON(patch.contents), rowSchema)
+		};
+		case "del": return {
+			op,
+			tableName,
+			id: parse(id, primaryKeyValueRecordSchema)
+		};
+		default: unreachable(op);
+	}
 }
+/**
+* Column values of type INT8 are returned as the `bigint` from the
+* Postgres library. These are converted to `number` if they are within
+* the safe Number range, allowing the protocol to support numbers larger
+* than 32-bits. Values outside of the safe number range (e.g. > 2^53) will
+* result in an Error.
+*/
 function ensureSafeJSON(row) {
-  const modified = Object.entries(row).filter(([k, v2]) => {
-    if (typeof v2 === "bigint") {
-      if (v2 >= Number.MIN_SAFE_INTEGER && v2 <= Number.MAX_SAFE_INTEGER) {
-        return true;
-      }
-      throw new Error(`Value of "${k}" exceeds safe Number range (${v2})`);
-    } else if (typeof v2 === "object") {
-      assertJSONValue(v2);
-    }
-    return false;
-  }).map(([k, v2]) => [k, Number(v2)]);
-  return modified.length ? { ...row, ...Object.fromEntries(modified) } : row;
+	const modified = Object.entries(row).filter(([k, v]) => {
+		if (typeof v === "bigint") {
+			if (v >= Number.MIN_SAFE_INTEGER && v <= Number.MAX_SAFE_INTEGER) return true;
+			throw new Error(`Value of "${k}" exceeds safe Number range (${v})`);
+		} else if (typeof v === "object") assertJSONValue(v);
+		return false;
+	}).map(([k, v]) => [k, Number(v)]);
+	return modified.length ? {
+		...row,
+		...Object.fromEntries(modified)
+	} : row;
 }
-export {
-  ClientHandler,
-  ensureSafeJSON,
-  startPoke
-};
-//# sourceMappingURL=client-handler.js.map
+//#endregion
+export { ClientHandler, startPoke };
+
+//# sourceMappingURL=client-handler.js.map