@rocicorp/zero 0.26.1-canary.9 → 0.26.2-canary.1

package/out/zero-cache/src/services/view-syncer/schema/types.js

@@ -1,297 +1,172 @@
-import { jsonValueSchema } from "../../../../../shared/src/bigint-json.js";
+import { literalUnion, readonly, valita_exports } from "../../../../../shared/src/valita.js";
 import { jsonSchema } from "../../../../../shared/src/json-schema.js";
-import { readonly, literalUnion } from "../../../../../shared/src/valita.js";
 import { astSchema } from "../../../../../zero-protocol/src/ast.js";
-import { versionToLexi, versionFromLexi } from "../../../types/lexi-version.js";
+import { jsonValueSchema } from "../../../../../shared/src/bigint-json.js";
+import { versionFromLexi, versionToLexi } from "../../../types/lexi-version.js";
 import { majorVersionToString, stateVersionFromString } from "../../../types/state-version.js";
 import { ttlClockSchema } from "../ttl-clock.js";
-import { object, number, string, array, literal, record, union } from "@badrap/valita";
-const cvrVersionSchema = object({
-  /**
-   * The database `stateVersion` with which the rows in the CVR are consistent.
-   */
-  stateVersion: string(),
-  // LexiVersion
-  /**
-   * `configVersion` is subversion of `stateVersion` that is initially absent for each
-   * `stateVersion`, and incremented for configuration changes that affect the contents
-   * of the CVR such as:
-   *
-   * * query set changes
-   * * query transformation changes (which may happen for changes
-   *   in server-side logic or authorization policies)
-   *
-   * Such configuration changes are always correlated with a change to one or more
-   * `/meta/...` records in the CVR, often (but not always) with corresponding
-   * patches in `/patches/meta/...`.
-   *
-   * When the `stateVersion` moves forward, the `minorVersion` is reset to absent.
-   * In this manner it behaves like the analogous concept in semantic versioning.
-   */
-  configVersion: number().optional()
+//#region ../zero-cache/src/services/view-syncer/schema/types.ts
+var cvrVersionSchema = valita_exports.object({
+	stateVersion: valita_exports.string(),
+	configVersion: valita_exports.number().optional()
 });
-const EMPTY_CVR_VERSION = {
-  stateVersion: majorVersionToString(0)
-};
-function oneAfter(v2) {
-  return v2 === null ? { stateVersion: majorVersionToString(0) } : {
-    stateVersion: v2.stateVersion,
-    configVersion: (v2.configVersion ?? 0) + 1
-  };
+var EMPTY_CVR_VERSION = { stateVersion: majorVersionToString(0) };
+function oneAfter(v) {
+	return v === null ? { stateVersion: majorVersionToString(0) } : {
+		stateVersion: v.stateVersion,
+		configVersion: (v.configVersion ?? 0) + 1
+	};
 }
 function cmpVersions(a, b) {
-  return a === null && b === null ? 0 : a === null ? -1 : b === null ? 1 : a.stateVersion < b.stateVersion ? -1 : a.stateVersion > b.stateVersion ? 1 : (a.configVersion ?? 0) - (b.configVersion ?? 0);
+	return a === null && b === null ? 0 : a === null ? -1 : b === null ? 1 : a.stateVersion < b.stateVersion ? -1 : a.stateVersion > b.stateVersion ? 1 : (a.configVersion ?? 0) - (b.configVersion ?? 0);
 }
 function maxVersion(a, b) {
-  return !b ? a : cmpVersions(b, a) > 0 ? b : a;
+	return !b ? a : cmpVersions(b, a) > 0 ? b : a;
 }
-function versionToCookie(v2) {
-  return versionString(v2);
+function versionToCookie(v) {
+	return versionString(v);
 }
-function versionToNullableCookie(v2) {
-  return v2 === null ? null : versionToCookie(v2);
+function versionToNullableCookie(v) {
+	return v === null ? null : versionToCookie(v);
 }
 function cookieToVersion(cookie) {
-  if (cookie === null) {
-    return null;
-  }
-  return versionFromString(cookie);
+	if (cookie === null) return null;
+	return versionFromString(cookie);
 }
-object({ id: string() });
-const cvrRecordSchema = object({
-  /**
-   * CVR records store the CVRVersion at which the record was last patched into
-   * the CVR, which corresponds with a patch row that is cleaned up when the
-   * record is changed (updated, deleted, and re-added in the case of rows).
-   *
-   * Tombstones are stored for row records but not for config records. This means
-   * that "orphaned" delete patches for config records may exist, and therefore
-   * scans of config patches must always run until the end of the list. On the
-   * contrary, for row patches, the row record tombstones allow cleanup of delete
-   * patches.
-   */
-  patchVersion: cvrVersionSchema
-});
-object({
-  /** The client ID, of which there can be multiple for a client group view. */
-  id: string(),
-  /** The client's desired query IDs. Patch information is stored in the QueryRecord. */
-  desiredQueryIDs: array(string())
+valita_exports.object({ id: valita_exports.string() });
+var cvrRecordSchema = valita_exports.object({ patchVersion: cvrVersionSchema });
+valita_exports.object({
+	id: valita_exports.string(),
+	desiredQueryIDs: valita_exports.array(valita_exports.string())
 });
-const baseQueryRecordSchema = object({
-  /** The client-specified ID used to identify this query. Typically a hash. */
-  id: string(),
-  /**
-   * The hash of the query after server-side transformations, which include:
-   *
-   * * Normalization (which may differ from what the client does)
-   * * Query "expansion" to include primary keys and query-execution-related columns
-   * * Authorization transforms
-   *
-   * Transformations depend on conditions that are independent of the db state version,
-   * such as server-side logic and authorization policies. As such, the version of a CVR
-   * version may need to be advanced independent of db state changes. This is done
-   * via the `minorVersion` counter of the CVRVersion object, which is used to account
-   * for both changes to the query set and changes to query transformations (which are
-   * effectively remove-old-query + add-new-query).
-   *
-   * Note that the transformed AST itself is **not** stored, as the result of the previous
-   * transformation is not useful in and of itself. If the current transformation results in
-   * a different hash than that of the transformation used for the last version of the CVR,
-   * it is simply handled by invalidating the existing rows, re-executed the query with
-   * the new transformation, and advancing the CVR's `minorVersion` and this query's
-   * `transformationVersion`.
-   *
-   * Note that the transformationHash is only stored when the query has reached the "gotten"
-   * state. If the query is in the "desired" but not yet "gotten" state, the field is absent.
-   */
-  transformationHash: string().optional(),
-  /**
-   * The CVR version corresponding to the `transformationHash`. This essentially tracks when
-   * this version of the query was effectively added to the CVR (as opposed to the
-   * `patchVersion`, which is simply when the client was notified that its query was added
-   * to the gotten set). Catchup of clients from old CVR versions require executing all
-   * queries with a newer `transformationVersion`.
-   */
-  transformationVersion: cvrVersionSchema.optional()
+var baseQueryRecordSchema = valita_exports.object({
+	id: valita_exports.string(),
+	transformationHash: valita_exports.string().optional(),
+	transformationVersion: cvrVersionSchema.optional()
 });
-const internalQueryRecordSchema = baseQueryRecordSchema.extend({
-  type: literal("internal"),
-  ast: astSchema
+/**
+* Internal queries track rows in the database for internal use, such as the
+* `lastMutationID`s in the `zero.clients` table. They participate in the standard
+* invalidation / update logic for row contents, but not in the desired/got or
+* size-based quota logic for client-requested queries.
+*/
+var internalQueryRecordSchema = baseQueryRecordSchema.extend({
+	type: valita_exports.literal("internal"),
+	ast: astSchema
 });
-const clientStateSchema = object({
-  /**
-   * The time at which the query was last inactivated. If this undefined or
-   * missing then the query is active.
-   *
-   * Desired queries are always active and have an undefined inactivatedAt.
-   */
-  inactivatedAt: ttlClockSchema.optional(),
-  /**
-   * TTL, time to live in milliseconds. If the query is not updated within this
-   * time. The time to live is the time after it has become inactive. Negative
-   * values are treated as `'forever'`.
-   *
-   * We do clamp this to a maximum of 10 minutes, so that queries do not
-   * live for a very long time in the CVR.
-   */
-  ttl: number(),
-  /**
-   * The version at which the client state changed (i.e. individual `patchVersion`s).
-   */
-  version: cvrVersionSchema
+var clientStateSchema = valita_exports.object({
+	inactivatedAt: ttlClockSchema.optional(),
+	ttl: valita_exports.number(),
+	version: cvrVersionSchema
 });
-const externalQueryRecordSchema = baseQueryRecordSchema.extend({
-  /**
-   * The client state for this query, which includes the inactivatedAt, ttl and
-   * version. The client state is stored in a record with the client ID as the
-   * key.
-   */
-  clientState: record(clientStateSchema),
-  // For queries, the `patchVersion` indicates when query was added to the got set,
-  // and is absent if not yet gotten.
-  patchVersion: cvrVersionSchema.optional()
+var externalQueryRecordSchema = baseQueryRecordSchema.extend({
+	clientState: valita_exports.record(clientStateSchema),
+	patchVersion: cvrVersionSchema.optional()
 });
-const clientQueryRecordSchema = externalQueryRecordSchema.extend({
-  type: literal("client"),
-  /** The original AST as supplied by the client. */
-  ast: astSchema
+var clientQueryRecordSchema = externalQueryRecordSchema.extend({
+	type: valita_exports.literal("client"),
+	ast: astSchema
 });
-const customQueryRecordSchema = externalQueryRecordSchema.extend({
-  type: literal("custom"),
-  name: string(),
-  args: readonly(array(jsonSchema))
+var customQueryRecordSchema = externalQueryRecordSchema.extend({
+	type: valita_exports.literal("custom"),
+	name: valita_exports.string(),
+	args: readonly(valita_exports.array(jsonSchema))
 });
-union(
-  clientQueryRecordSchema,
-  customQueryRecordSchema,
-  internalQueryRecordSchema
-);
-const rowIDSchema = object({
-  schema: string(),
-  table: string(),
-  rowKey: record(jsonValueSchema)
+valita_exports.union(clientQueryRecordSchema, customQueryRecordSchema, internalQueryRecordSchema);
+var rowIDSchema = valita_exports.object({
+	schema: valita_exports.string(),
+	table: valita_exports.string(),
+	rowKey: valita_exports.record(jsonValueSchema)
 });
 cvrRecordSchema.extend({
-  id: rowIDSchema,
-  rowVersion: string(),
-  // '_0_version' of the row
-  // query hashes => refCount, or `null` for a row that was removed from the
-  // view (i.e. tombstone).
-  refCounts: record(number()).nullable()
+	id: rowIDSchema,
+	rowVersion: valita_exports.string(),
+	refCounts: valita_exports.record(valita_exports.number()).nullable()
 });
-const patchSchema = object({
-  type: literalUnion("row", "query"),
-  op: literalUnion("put", "del")
+var patchSchema = valita_exports.object({
+	type: literalUnion("row", "query"),
+	op: literalUnion("put", "del")
 });
-const putRowPatchSchema = patchSchema.extend({
-  type: literal("row"),
-  op: literal("put"),
-  id: rowIDSchema,
-  rowVersion: string()
-  // '_0_version' of the row
+var putRowPatchSchema = patchSchema.extend({
+	type: valita_exports.literal("row"),
+	op: valita_exports.literal("put"),
+	id: rowIDSchema,
+	rowVersion: valita_exports.string()
 });
-const delRowPatchSchema = patchSchema.extend({
-  type: literal("row"),
-  op: literal("del"),
-  id: rowIDSchema
+var delRowPatchSchema = patchSchema.extend({
+	type: valita_exports.literal("row"),
+	op: valita_exports.literal("del"),
+	id: rowIDSchema
 });
-union(putRowPatchSchema, delRowPatchSchema);
+valita_exports.union(putRowPatchSchema, delRowPatchSchema);
 patchSchema.extend({
-  type: literal("query"),
-  id: string(),
-  clientID: string().optional()
-  // defined for "desired", undefined for "got"
+	type: valita_exports.literal("query"),
+	id: valita_exports.string(),
+	clientID: valita_exports.string().optional()
 });
-function versionString(v2) {
-  return v2.configVersion ? `${v2.stateVersion}:${versionToLexi(v2.configVersion)}` : v2.stateVersion;
+function versionString(v) {
+	return v.configVersion ? `${v.stateVersion}:${versionToLexi(v.configVersion)}` : v.stateVersion;
 }
 function versionFromString(str) {
-  const parts = str.split(":");
-  const stateVersion = parts[0];
-  switch (parts.length) {
-    case 1: {
-      stateVersionFromString(stateVersion);
-      return { stateVersion };
-    }
-    case 2: {
-      const configVersion = versionFromLexi(parts[1]);
-      if (configVersion > BigInt(Number.MAX_SAFE_INTEGER)) {
-        throw new Error(`minorVersion ${parts[1]} exceeds max safe integer`);
-      }
-      return { stateVersion, configVersion: Number(configVersion) };
-    }
-    default:
-      throw new TypeError(`Invalid version string ${str}`);
-  }
+	const parts = str.split(":");
+	const stateVersion = parts[0];
+	switch (parts.length) {
+		case 1:
+			stateVersionFromString(stateVersion);
+			return { stateVersion };
+		case 2: {
+			const configVersion = versionFromLexi(parts[1]);
+			if (configVersion > BigInt(Number.MAX_SAFE_INTEGER)) throw new Error(`minorVersion ${parts[1]} exceeds max safe integer`);
+			return {
+				stateVersion,
+				configVersion: Number(configVersion)
+			};
+		}
+		default: throw new TypeError(`Invalid version string ${str}`);
+	}
 }
 function queryRecordToQueryRow(clientGroupID, query) {
-  switch (query.type) {
-    case "internal":
-      return {
-        clientGroupID,
-        queryHash: query.id,
-        clientAST: query.ast,
-        queryName: null,
-        queryArgs: null,
-        patchVersion: null,
-        transformationHash: query.transformationHash ?? null,
-        transformationVersion: maybeVersionString(query.transformationVersion),
-        internal: true,
-        deleted: false
-        // put vs del "got" query
-      };
-    case "client":
-      return {
-        clientGroupID,
-        queryHash: query.id,
-        clientAST: query.ast,
-        queryName: null,
-        queryArgs: null,
-        patchVersion: maybeVersionString(query.patchVersion),
-        transformationHash: query.transformationHash ?? null,
-        transformationVersion: maybeVersionString(query.transformationVersion),
-        internal: null,
-        deleted: false
-        // put vs del "got" query
-      };
-    case "custom":
-      return {
-        clientGroupID,
-        queryHash: query.id,
-        clientAST: null,
-        queryName: query.name,
-        queryArgs: query.args,
-        patchVersion: maybeVersionString(query.patchVersion),
-        transformationHash: query.transformationHash ?? null,
-        transformationVersion: maybeVersionString(query.transformationVersion),
-        internal: null,
-        deleted: false
-        // put vs del "got" query
-      };
-  }
+	switch (query.type) {
+		case "internal": return {
+			clientGroupID,
+			queryHash: query.id,
+			clientAST: query.ast,
+			queryName: null,
+			queryArgs: null,
+			patchVersion: null,
+			transformationHash: query.transformationHash ?? null,
+			transformationVersion: maybeVersionString(query.transformationVersion),
+			internal: true,
+			deleted: false
+		};
+		case "client": return {
+			clientGroupID,
+			queryHash: query.id,
+			clientAST: query.ast,
+			queryName: null,
+			queryArgs: null,
+			patchVersion: maybeVersionString(query.patchVersion),
+			transformationHash: query.transformationHash ?? null,
+			transformationVersion: maybeVersionString(query.transformationVersion),
+			internal: null,
+			deleted: false
+		};
+		case "custom": return {
+			clientGroupID,
+			queryHash: query.id,
+			clientAST: null,
+			queryName: query.name,
+			queryArgs: query.args,
+			patchVersion: maybeVersionString(query.patchVersion),
+			transformationHash: query.transformationHash ?? null,
+			transformationVersion: maybeVersionString(query.transformationVersion),
+			internal: null,
+			deleted: false
+		};
+	}
 }
-const maybeVersionString = (v2) => v2 ? versionString(v2) : null;
-export {
-  EMPTY_CVR_VERSION,
-  baseQueryRecordSchema,
-  clientQueryRecordSchema,
-  cmpVersions,
-  cookieToVersion,
-  customQueryRecordSchema,
-  cvrVersionSchema,
-  delRowPatchSchema,
-  internalQueryRecordSchema,
-  maxVersion,
-  maybeVersionString,
-  oneAfter,
-  patchSchema,
-  putRowPatchSchema,
-  queryRecordToQueryRow,
-  rowIDSchema,
-  versionFromString,
-  versionString,
-  versionToCookie,
-  versionToNullableCookie
-};
-//# sourceMappingURL=types.js.map
+var maybeVersionString = (v) => v ? versionString(v) : null;
+//#endregion
+export { EMPTY_CVR_VERSION, cmpVersions, cookieToVersion, maxVersion, oneAfter, queryRecordToQueryRow, versionFromString, versionString, versionToCookie, versionToNullableCookie };
+
+//# sourceMappingURL=types.js.map

package/out/zero-cache/src/services/view-syncer/schema/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../../../../../zero-cache/src/services/view-syncer/schema/types.ts"],"sourcesContent":["import {jsonValueSchema} from '../../../../../shared/src/bigint-json.ts';\nimport {jsonSchema} from '../../../../../shared/src/json-schema.ts';\nimport * as v from '../../../../../shared/src/valita.ts';\nimport {astSchema} from '../../../../../zero-protocol/src/ast.ts';\nimport {versionFromLexi, versionToLexi} from '../../../types/lexi-version.ts';\nimport {\n  majorVersionToString,\n  stateVersionFromString,\n} from '../../../types/state-version.ts';\nimport {ttlClockSchema} from '../ttl-clock.ts';\nimport type {QueriesRow} from './cvr.ts';\n\nexport const cvrVersionSchema = v.object({\n  /**\n   * The database `stateVersion` with which the rows in the CVR are consistent.\n   */\n  stateVersion: v.string(), // LexiVersion\n\n  /**\n   * `configVersion` is subversion of `stateVersion` that is initially absent for each\n   * `stateVersion`, and incremented for configuration changes that affect the contents\n   * of the CVR such as:\n   *\n   * * query set changes\n   * * query transformation changes (which may happen for changes\n   *   in server-side logic or authorization policies)\n   *\n   * Such configuration changes are always correlated with a change to one or more\n   * `/meta/...` records in the CVR, often (but not always) with corresponding\n   * patches in `/patches/meta/...`.\n   *\n   * When the `stateVersion` moves forward, the `minorVersion` is reset to absent.\n   * In this manner it behaves like the analogous concept in semantic versioning.\n   */\n  configVersion: v.number().optional(),\n});\n\nexport type CVRVersion = v.Infer<typeof cvrVersionSchema>;\n\nexport const EMPTY_CVR_VERSION: CVRVersion = {\n  stateVersion: majorVersionToString(0),\n} as const;\n\nexport function oneAfter(v: NullableCVRVersion): CVRVersion {\n  return v === null\n    ? {stateVersion: majorVersionToString(0)}\n    : {\n        stateVersion: v.stateVersion,\n        configVersion: (v.configVersion ?? 0) + 1,\n      };\n}\n\nexport type NullableCVRVersion = CVRVersion | null;\n\nexport function cmpVersions(\n  a: NullableCVRVersion,\n  b: NullableCVRVersion,\n): number {\n  return a === null && b === null\n    ? 0\n    : a === null\n      ? -1\n      : b === null\n        ? 1\n        : a.stateVersion < b.stateVersion\n          ? -1\n          : a.stateVersion > b.stateVersion\n            ? 1\n            : (a.configVersion ?? 0) - (b.configVersion ?? 0);\n}\n\nexport function maxVersion(a: CVRVersion, b?: CVRVersion): CVRVersion {\n  return !b ? a : cmpVersions(b, a) > 0 ? b : a;\n}\n\nexport function versionToCookie(v: CVRVersion): string {\n  return versionString(v);\n}\n\nexport function versionToNullableCookie(v: NullableCVRVersion): string | null {\n  return v === null ? null : versionToCookie(v);\n}\n\nexport function cookieToVersion(cookie: string | null): NullableCVRVersion {\n  if (cookie === null) {\n    return null;\n  }\n  return versionFromString(cookie);\n}\n\n// Last Active tracking.\n\nexport const cvrIDSchema = v.object({id: v.string()});\nexport type CvrID = v.Infer<typeof cvrIDSchema>;\n\nconst cvrRecordSchema = v.object({\n  /**\n   * CVR records store the CVRVersion at which the record was last patched into\n   * the CVR, which corresponds with a patch row that is cleaned up when the\n   * record is changed (updated, deleted, and re-added in the case of rows).\n   *\n   * Tombstones are stored for row records but not for config records. This means\n   * that \"orphaned\" delete patches for config records may exist, and therefore\n   * scans of config patches must always run until the end of the list. On the\n   * contrary, for row patches, the row record tombstones allow cleanup of delete\n   * patches.\n   */\n  patchVersion: cvrVersionSchema,\n});\n\nexport const clientRecordSchema = v.object({\n  /** The client ID, of which there can be multiple for a client group view. */\n  id: v.string(),\n\n  /** The client's desired query IDs. Patch information is stored in the QueryRecord. */\n  desiredQueryIDs: v.array(v.string()),\n});\n\nexport type ClientRecord = v.Infer<typeof clientRecordSchema>;\n\nexport const baseQueryRecordSchema = v.object({\n  /** The client-specified ID used to identify this query. Typically a hash. */\n  id: v.string(),\n\n  /**\n   * The hash of the query after server-side transformations, which include:\n   *\n   * * Normalization (which may differ from what the client does)\n   * * Query \"expansion\" to include primary keys and query-execution-related columns\n   * * Authorization transforms\n   *\n   * Transformations depend on conditions that are independent of the db state version,\n   * such as server-side logic and authorization policies. As such, the version of a CVR\n   * version may need to be advanced independent of db state changes. This is done\n   * via the `minorVersion` counter of the CVRVersion object, which is used to account\n   * for both changes to the query set and changes to query transformations (which are\n   * effectively remove-old-query + add-new-query).\n   *\n   * Note that the transformed AST itself is **not** stored, as the result of the previous\n   * transformation is not useful in and of itself. If the current transformation results in\n   * a different hash than that of the transformation used for the last version of the CVR,\n   * it is simply handled by invalidating the existing rows, re-executed the query with\n   * the new transformation, and advancing the CVR's `minorVersion` and this query's\n   * `transformationVersion`.\n   *\n   * Note that the transformationHash is only stored when the query has reached the \"gotten\"\n   * state. If the query is in the \"desired\" but not yet \"gotten\" state, the field is absent.\n   */\n  transformationHash: v.string().optional(),\n\n  /**\n   * The CVR version corresponding to the `transformationHash`. This essentially tracks when\n   * this version of the query was effectively added to the CVR (as opposed to the\n   * `patchVersion`, which is simply when the client was notified that its query was added\n   * to the gotten set). Catchup of clients from old CVR versions require executing all\n   * queries with a newer `transformationVersion`.\n   */\n  transformationVersion: cvrVersionSchema.optional(),\n});\n\n/**\n * Internal queries track rows in the database for internal use, such as the\n * `lastMutationID`s in the `zero.clients` table. They participate in the standard\n * invalidation / update logic for row contents, but not in the desired/got or\n * size-based quota logic for client-requested queries.\n */\nexport const internalQueryRecordSchema = baseQueryRecordSchema.extend({\n  type: v.literal('internal'),\n  ast: astSchema,\n});\n\nexport type InternalQueryRecord = v.Infer<typeof internalQueryRecordSchema>;\n\nconst clientStateSchema = v.object({\n  /**\n   * The time at which the query was last inactivated. If this undefined or\n   * missing then the query is active.\n   *\n   * Desired queries are always active and have an undefined inactivatedAt.\n   */\n  inactivatedAt: ttlClockSchema.optional(),\n\n  /**\n   * TTL, time to live in milliseconds. If the query is not updated within this\n   * time. The time to live is the time after it has become inactive. Negative\n   * values are treated as `'forever'`.\n   *\n   * We do clamp this to a maximum of 10 minutes, so that queries do not\n   * live for a very long time in the CVR.\n   */\n  ttl: v.number(),\n\n  /**\n   * The version at which the client state changed (i.e. individual `patchVersion`s).\n   */\n  version: cvrVersionSchema,\n});\n\nconst externalQueryRecordSchema = baseQueryRecordSchema.extend({\n  /**\n   * The client state for this query, which includes the inactivatedAt, ttl and\n   * version. The client state is stored in a record with the client ID as the\n   * key.\n   */\n  clientState: v.record(clientStateSchema),\n\n  // For queries, the `patchVersion` indicates when query was added to the got set,\n  // and is absent if not yet gotten.\n  patchVersion: cvrVersionSchema.optional(),\n});\n\nexport const clientQueryRecordSchema = externalQueryRecordSchema.extend({\n  type: v.literal('client'),\n\n  /** The original AST as supplied by the client. */\n  ast: astSchema,\n});\n\nexport type ClientQueryRecord = v.Infer<typeof clientQueryRecordSchema>;\n\nexport const customQueryRecordSchema = externalQueryRecordSchema.extend({\n  type: v.literal('custom'),\n  name: v.string(),\n  args: v.readonly(v.array(jsonSchema)),\n});\n\nexport type CustomQueryRecord = v.Infer<typeof customQueryRecordSchema>;\n\nexport const queryRecordSchema = v.union(\n  clientQueryRecordSchema,\n  customQueryRecordSchema,\n  internalQueryRecordSchema,\n);\n\nexport type QueryRecord = v.Infer<typeof queryRecordSchema>;\n\nexport const rowIDSchema = v.object({\n  schema: v.string(),\n  table: v.string(),\n  rowKey: v.record(jsonValueSchema),\n});\n\nexport type RowID = v.Infer<typeof rowIDSchema>;\n\nexport const rowRecordSchema = cvrRecordSchema.extend({\n  id: rowIDSchema,\n  rowVersion: v.string(), // '_0_version' of the row\n  // query hashes => refCount, or `null` for a row that was removed from the\n  // view (i.e. tombstone).\n  refCounts: v.record(v.number()).nullable(),\n});\n\nexport type RowRecord = v.Infer<typeof rowRecordSchema>;\n\nexport const patchSchema = v.object({\n  type: v.literalUnion('row', 'query'),\n  op: v.literalUnion('put', 'del'),\n});\n\nexport const putRowPatchSchema = patchSchema.extend({\n  type: v.literal('row'),\n  op: v.literal('put'),\n  id: rowIDSchema,\n  rowVersion: v.string(), // '_0_version' of the row\n});\n\nexport type PutRowPatch = v.Infer<typeof putRowPatchSchema>;\n\nexport const delRowPatchSchema = patchSchema.extend({\n  type: v.literal('row'),\n  op: v.literal('del'),\n  id: rowIDSchema,\n});\n\nexport type DelRowPatch = v.Infer<typeof delRowPatchSchema>;\n\nexport const rowPatchSchema = v.union(putRowPatchSchema, delRowPatchSchema);\n\nexport type RowPatch = v.Infer<typeof rowPatchSchema>;\n\nexport const queryPatchSchema = patchSchema.extend({\n  type: v.literal('query'),\n  id: v.string(),\n  clientID: v.string().optional(), // defined for \"desired\", undefined for \"got\"\n});\n\nexport type QueryPatch = v.Infer<typeof queryPatchSchema>;\n\nexport type PutQueryPatch = QueryPatch & {op: 'put'};\nexport type DelQueryPatch = QueryPatch & {op: 'del'};\n\nexport const metadataPatchSchema = queryPatchSchema;\n\nexport type MetadataPatch = v.Infer<typeof metadataPatchSchema>;\n\nexport function versionString(v: CVRVersion) {\n  // The separator (e.g. \":\") needs to be lexicographically greater than the\n  // storage key path separator (e.g. \"/\") so that \"01/row-hash\" is less than \"01:01/row-hash\".\n  // In particular, the traditional separator for major.minor versions (\".\") does not\n  // satisfy this quality.\n  return v.configVersion\n    ? `${v.stateVersion}:${versionToLexi(v.configVersion)}`\n    : v.stateVersion;\n}\n\nexport function versionFromString(str: string): CVRVersion {\n  const parts = str.split(':');\n  const stateVersion = parts[0];\n  switch (parts.length) {\n    case 1: {\n      stateVersionFromString(stateVersion); // Purely for validation.\n      return {stateVersion};\n    }\n    case 2: {\n      const configVersion = versionFromLexi(parts[1]);\n      if (configVersion > BigInt(Number.MAX_SAFE_INTEGER)) {\n        throw new Error(`minorVersion ${parts[1]} exceeds max safe integer`);\n      }\n      return {stateVersion, configVersion: Number(configVersion)};\n    }\n    default:\n      throw new TypeError(`Invalid version string ${str}`);\n  }\n}\n\nexport function queryRecordToQueryRow(\n  clientGroupID: string,\n  query: QueryRecord,\n): QueriesRow {\n  switch (query.type) {\n    case 'internal':\n      return {\n        clientGroupID,\n        queryHash: query.id,\n        clientAST: query.ast,\n        queryName: null,\n        queryArgs: null,\n        patchVersion: null,\n        transformationHash: query.transformationHash ?? null,\n        transformationVersion: maybeVersionString(query.transformationVersion),\n        internal: true,\n        deleted: false, // put vs del \"got\" query\n      };\n    case 'client':\n      return {\n        clientGroupID,\n        queryHash: query.id,\n        clientAST: query.ast,\n        queryName: null,\n        queryArgs: null,\n        patchVersion: maybeVersionString(query.patchVersion),\n        transformationHash: query.transformationHash ?? null,\n        transformationVersion: maybeVersionString(query.transformationVersion),\n        internal: null,\n        deleted: false, // put vs del \"got\" query\n      };\n    case 'custom':\n      return {\n        clientGroupID,\n        queryHash: query.id,\n        clientAST: null,\n        queryName: query.name,\n        queryArgs: query.args,\n        patchVersion: maybeVersionString(query.patchVersion),\n        transformationHash: query.transformationHash ?? null,\n        transformationVersion: maybeVersionString(query.transformationVersion),\n        internal: null,\n        deleted: false, // put vs del \"got\" query\n      };\n  }\n}\n\nexport const maybeVersionString = (v: CVRVersion | undefined) =>\n  v ? versionString(v) : null;\n"],"names":["v.object","v.string","v.number","v","v.array","v.literal","v.record","v.readonly","v.union","v.literalUnion"],"mappings":";;;;;;;;AAYO,MAAM,mBAAmBA,OAAS;AAAA;AAAA;AAAA;AAAA,EAIvC,cAAcC,OAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBhB,eAAeC,OAAE,EAAS,SAAA;AAC5B,CAAC;AAIM,MAAM,oBAAgC;AAAA,EAC3C,cAAc,qBAAqB,CAAC;AACtC;AAEO,SAAS,SAASC,IAAmC;AAC1D,SAAOA,OAAM,OACT,EAAC,cAAc,qBAAqB,CAAC,MACrC;AAAA,IACE,cAAcA,GAAE;AAAA,IAChB,gBAAgBA,GAAE,iBAAiB,KAAK;AAAA,EAAA;AAEhD;AAIO,SAAS,YACd,GACA,GACQ;AACR,SAAO,MAAM,QAAQ,MAAM,OACvB,IACA,MAAM,OACJ,KACA,MAAM,OACJ,IACA,EAAE,eAAe,EAAE,eACjB,KACA,EAAE,eAAe,EAAE,eACjB,KACC,EAAE,iBAAiB,MAAM,EAAE,iBAAiB;AAC3D;AAEO,SAAS,WAAW,GAAe,GAA4B;AACpE,SAAO,CAAC,IAAI,IAAI,YAAY,GAAG,CAAC,IAAI,IAAI,IAAI;AAC9C;AAEO,SAAS,gBAAgBA,IAAuB;AACrD,SAAO,cAAcA,EAAC;AACxB;AAEO,SAAS,wBAAwBA,IAAsC;AAC5E,SAAOA,OAAM,OAAO,OAAO,gBAAgBA,EAAC;AAC9C;AAEO,SAAS,gBAAgB,QAA2C;AACzE,MAAI,WAAW,MAAM;AACnB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,MAAM;AACjC;AAI2BH,OAAS,EAAC,IAAIC,UAAW;AAGpD,MAAM,kBAAkBD,OAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAY/B,cAAc;AAChB,CAAC;AAEiCA,OAAS;AAAA;AAAA,EAEzC,IAAIC,OAAE;AAAA;AAAA,EAGN,iBAAiBG,MAAQH,QAAU;AACrC,CAAC;AAIM,MAAM,wBAAwBD,OAAS;AAAA;AAAA,EAE5C,IAAIC,OAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA0BN,oBAAoBA,OAAE,EAAS,SAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS/B,uBAAuB,iBAAiB,SAAA;AAC1C,CAAC;AAQM,MAAM,4BAA4B,sBAAsB,OAAO;AAAA,EACpE,MAAMI,QAAU,UAAU;AAAA,EAC1B,KAAK;AACP,CAAC;AAID,MAAM,oBAAoBL,OAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOjC,eAAe,eAAe,SAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU9B,KAAKE,OAAE;AAAA;AAAA;AAAA;AAAA,EAKP,SAAS;AACX,CAAC;AAED,MAAM,4BAA4B,sBAAsB,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM7D,aAAaI,OAAS,iBAAiB;AAAA;AAAA;AAAA,EAIvC,cAAc,iBAAiB,SAAA;AACjC,CAAC;AAEM,MAAM,0BAA0B,0BAA0B,OAAO;AAAA,EACtE,MAAMD,QAAU,QAAQ;AAAA;AAAA,EAGxB,KAAK;AACP,CAAC;AAIM,MAAM,0BAA0B,0BAA0B,OAAO;AAAA,EACtE,MAAMA,QAAU,QAAQ;AAAA,EACxB,MAAMJ,OAAE;AAAA,EACR,MAAMM,SAAWH,MAAQ,UAAU,CAAC;AACtC,CAAC;AAIgCI;AAAAA,EAC/B;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,cAAcR,OAAS;AAAA,EAClC,QAAQC,OAAE;AAAA,EACV,OAAOA,OAAE;AAAA,EACT,QAAQK,OAAS,eAAe;AAClC,CAAC;AAI8B,gBAAgB,OAAO;AAAA,EACpD,IAAI;AAAA,EACJ,YAAYL,OAAE;AAAA;AAAA;AAAA;AAAA,EAGd,WAAWK,OAASJ,OAAE,CAAQ,EAAE,SAAA;AAClC,CAAC;AAIM,MAAM,cAAcF,OAAS;AAAA,EAClC,MAAMS,aAAe,OAAO,OAAO;AAAA,EACnC,IAAIA,aAAe,OAAO,KAAK;AACjC,CAAC;AAEM,MAAM,oBAAoB,YAAY,OAAO;AAAA,EAClD,MAAMJ,QAAU,KAAK;AAAA,EACrB,IAAIA,QAAU,KAAK;AAAA,EACnB,IAAI;AAAA,EACJ,YAAYJ,OAAE;AAAA;AAChB,CAAC;AAIM,MAAM,oBAAoB,YAAY,OAAO;AAAA,EAClD,MAAMI,QAAU,KAAK;AAAA,EACrB,IAAIA,QAAU,KAAK;AAAA,EACnB,IAAI;AACN,CAAC;AAI6BG,MAAQ,mBAAmB,iBAAiB;AAI1C,YAAY,OAAO;AAAA,EACjD,MAAMH,QAAU,OAAO;AAAA,EACvB,IAAIJ,OAAE;AAAA,EACN,UAAUA,OAAE,EAAS,SAAA;AAAA;AACvB,CAAC;AAWM,SAAS,cAAcE,IAAe;AAK3C,SAAOA,GAAE,gBACL,GAAGA,GAAE,YAAY,IAAI,cAAcA,GAAE,aAAa,CAAC,KACnDA,GAAE;AACR;AAEO,SAAS,kBAAkB,KAAyB;AACzD,QAAM,QAAQ,IAAI,MAAM,GAAG;AAC3B,QAAM,eAAe,MAAM,CAAC;AAC5B,UAAQ,MAAM,QAAA;AAAA,IACZ,KAAK,GAAG;AACN,6BAAuB,YAAY;AACnC,aAAO,EAAC,aAAA;AAAA,IACV;AAAA,IACA,KAAK,GAAG;AACN,YAAM,gBAAgB,gBAAgB,MAAM,CAAC,CAAC;AAC9C,UAAI,gBAAgB,OAAO,OAAO,gBAAgB,GAAG;AACnD,cAAM,IAAI,MAAM,gBAAgB,MAAM,CAAC,CAAC,2BAA2B;AAAA,MACrE;AACA,aAAO,EAAC,cAAc,eAAe,OAAO,aAAa,EAAA;AAAA,IAC3D;AAAA,IACA;AACE,YAAM,IAAI,UAAU,0BAA0B,GAAG,EAAE;AAAA,EAAA;AAEzD;AAEO,SAAS,sBACd,eACA,OACY;AACZ,UAAQ,MAAM,MAAA;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,WAAW,MAAM;AAAA,QACjB,WAAW;AAAA,QACX,WAAW;AAAA,QACX,cAAc;AAAA,QACd,oBAAoB,MAAM,sBAAsB;AAAA,QAChD,uBAAuB,mBAAmB,MAAM,qBAAqB;AAAA,QACrE,UAAU;AAAA,QACV,SAAS;AAAA;AAAA,MAAA;AAAA,IAEb,KAAK;AACH,aAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,WAAW,MAAM;AAAA,QACjB,WAAW;AAAA,QACX,WAAW;AAAA,QACX,cAAc,mBAAmB,MAAM,YAAY;AAAA,QACnD,oBAAoB,MAAM,sBAAsB;AAAA,QAChD,uBAAuB,mBAAmB,MAAM,qBAAqB;AAAA,QACrE,UAAU;AAAA,QACV,SAAS;AAAA;AAAA,MAAA;AAAA,IAEb,KAAK;AACH,aAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,WAAW;AAAA,QACX,WAAW,MAAM;AAAA,QACjB,WAAW,MAAM;AAAA,QACjB,cAAc,mBAAmB,MAAM,YAAY;AAAA,QACnD,oBAAoB,MAAM,sBAAsB;AAAA,QAChD,uBAAuB,mBAAmB,MAAM,qBAAqB;AAAA,QACrE,UAAU;AAAA,QACV,SAAS;AAAA;AAAA,MAAA;AAAA,EACX;AAEN;AAEO,MAAM,qBAAqB,CAACA,OACjCA,KAAI,cAAcA,EAAC,IAAI;"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../../../../../zero-cache/src/services/view-syncer/schema/types.ts"],"sourcesContent":["import {jsonValueSchema} from '../../../../../shared/src/bigint-json.ts';\nimport {jsonSchema} from '../../../../../shared/src/json-schema.ts';\nimport * as v from '../../../../../shared/src/valita.ts';\nimport {astSchema} from '../../../../../zero-protocol/src/ast.ts';\nimport {versionFromLexi, versionToLexi} from '../../../types/lexi-version.ts';\nimport {\n  majorVersionToString,\n  stateVersionFromString,\n} from '../../../types/state-version.ts';\nimport {ttlClockSchema} from '../ttl-clock.ts';\nimport type {QueriesRow} from './cvr.ts';\n\nexport const cvrVersionSchema = v.object({\n  /**\n   * The database `stateVersion` with which the rows in the CVR are consistent.\n   */\n  stateVersion: v.string(), // LexiVersion\n\n  /**\n   * `configVersion` is subversion of `stateVersion` that is initially absent for each\n   * `stateVersion`, and incremented for configuration changes that affect the contents\n   * of the CVR such as:\n   *\n   * * query set changes\n   * * query transformation changes (which may happen for changes\n   *   in server-side logic or authorization policies)\n   *\n   * Such configuration changes are always correlated with a change to one or more\n   * `/meta/...` records in the CVR, often (but not always) with corresponding\n   * patches in `/patches/meta/...`.\n   *\n   * When the `stateVersion` moves forward, the `minorVersion` is reset to absent.\n   * In this manner it behaves like the analogous concept in semantic versioning.\n   */\n  configVersion: v.number().optional(),\n});\n\nexport type CVRVersion = v.Infer<typeof cvrVersionSchema>;\n\nexport const EMPTY_CVR_VERSION: CVRVersion = {\n  stateVersion: majorVersionToString(0),\n} as const;\n\nexport function oneAfter(v: NullableCVRVersion): CVRVersion {\n  return v === null\n    ? {stateVersion: majorVersionToString(0)}\n    : {\n        stateVersion: v.stateVersion,\n        configVersion: (v.configVersion ?? 0) + 1,\n      };\n}\n\nexport type NullableCVRVersion = CVRVersion | null;\n\nexport function cmpVersions(\n  a: NullableCVRVersion,\n  b: NullableCVRVersion,\n): number {\n  return a === null && b === null\n    ? 0\n    : a === null\n      ? -1\n      : b === null\n        ? 1\n        : a.stateVersion < b.stateVersion\n          ? -1\n          : a.stateVersion > b.stateVersion\n            ? 1\n            : (a.configVersion ?? 0) - (b.configVersion ?? 0);\n}\n\nexport function maxVersion(a: CVRVersion, b?: CVRVersion): CVRVersion {\n  return !b ? a : cmpVersions(b, a) > 0 ? b : a;\n}\n\nexport function versionToCookie(v: CVRVersion): string {\n  return versionString(v);\n}\n\nexport function versionToNullableCookie(v: NullableCVRVersion): string | null {\n  return v === null ? null : versionToCookie(v);\n}\n\nexport function cookieToVersion(cookie: string | null): NullableCVRVersion {\n  if (cookie === null) {\n    return null;\n  }\n  return versionFromString(cookie);\n}\n\n// Last Active tracking.\n\nexport const cvrIDSchema = v.object({id: v.string()});\nexport type CvrID = v.Infer<typeof cvrIDSchema>;\n\nconst cvrRecordSchema = v.object({\n  /**\n   * CVR records store the CVRVersion at which the record was last patched into\n   * the CVR, which corresponds with a patch row that is cleaned up when the\n   * record is changed (updated, deleted, and re-added in the case of rows).\n   *\n   * Tombstones are stored for row records but not for config records. This means\n   * that \"orphaned\" delete patches for config records may exist, and therefore\n   * scans of config patches must always run until the end of the list. On the\n   * contrary, for row patches, the row record tombstones allow cleanup of delete\n   * patches.\n   */\n  patchVersion: cvrVersionSchema,\n});\n\nexport const clientRecordSchema = v.object({\n  /** The client ID, of which there can be multiple for a client group view. */\n  id: v.string(),\n\n  /** The client's desired query IDs. Patch information is stored in the QueryRecord. */\n  desiredQueryIDs: v.array(v.string()),\n});\n\nexport type ClientRecord = v.Infer<typeof clientRecordSchema>;\n\nexport const baseQueryRecordSchema = v.object({\n  /** The client-specified ID used to identify this query. Typically a hash. */\n  id: v.string(),\n\n  /**\n   * The hash of the query after server-side transformations, which include:\n   *\n   * * Normalization (which may differ from what the client does)\n   * * Query \"expansion\" to include primary keys and query-execution-related columns\n   * * Authorization transforms\n   *\n   * Transformations depend on conditions that are independent of the db state version,\n   * such as server-side logic and authorization policies. As such, the version of a CVR\n   * version may need to be advanced independent of db state changes. This is done\n   * via the `minorVersion` counter of the CVRVersion object, which is used to account\n   * for both changes to the query set and changes to query transformations (which are\n   * effectively remove-old-query + add-new-query).\n   *\n   * Note that the transformed AST itself is **not** stored, as the result of the previous\n   * transformation is not useful in and of itself. If the current transformation results in\n   * a different hash than that of the transformation used for the last version of the CVR,\n   * it is simply handled by invalidating the existing rows, re-executed the query with\n   * the new transformation, and advancing the CVR's `minorVersion` and this query's\n   * `transformationVersion`.\n   *\n   * Note that the transformationHash is only stored when the query has reached the \"gotten\"\n   * state. If the query is in the \"desired\" but not yet \"gotten\" state, the field is absent.\n   */\n  transformationHash: v.string().optional(),\n\n  /**\n   * The CVR version corresponding to the `transformationHash`. This essentially tracks when\n   * this version of the query was effectively added to the CVR (as opposed to the\n   * `patchVersion`, which is simply when the client was notified that its query was added\n   * to the gotten set). Catchup of clients from old CVR versions require executing all\n   * queries with a newer `transformationVersion`.\n   */\n  transformationVersion: cvrVersionSchema.optional(),\n});\n\n/**\n * Internal queries track rows in the database for internal use, such as the\n * `lastMutationID`s in the `zero.clients` table. They participate in the standard\n * invalidation / update logic for row contents, but not in the desired/got or\n * size-based quota logic for client-requested queries.\n */\nexport const internalQueryRecordSchema = baseQueryRecordSchema.extend({\n  type: v.literal('internal'),\n  ast: astSchema,\n});\n\nexport type InternalQueryRecord = v.Infer<typeof internalQueryRecordSchema>;\n\nconst clientStateSchema = v.object({\n  /**\n   * The time at which the query was last inactivated. If this undefined or\n   * missing then the query is active.\n   *\n   * Desired queries are always active and have an undefined inactivatedAt.\n   */\n  inactivatedAt: ttlClockSchema.optional(),\n\n  /**\n   * TTL, time to live in milliseconds. If the query is not updated within this\n   * time. The time to live is the time after it has become inactive. Negative\n   * values are treated as `'forever'`.\n   *\n   * We do clamp this to a maximum of 10 minutes, so that queries do not\n   * live for a very long time in the CVR.\n   */\n  ttl: v.number(),\n\n  /**\n   * The version at which the client state changed (i.e. individual `patchVersion`s).\n   */\n  version: cvrVersionSchema,\n});\n\nconst externalQueryRecordSchema = baseQueryRecordSchema.extend({\n  /**\n   * The client state for this query, which includes the inactivatedAt, ttl and\n   * version. The client state is stored in a record with the client ID as the\n   * key.\n   */\n  clientState: v.record(clientStateSchema),\n\n  // For queries, the `patchVersion` indicates when query was added to the got set,\n  // and is absent if not yet gotten.\n  patchVersion: cvrVersionSchema.optional(),\n});\n\nexport const clientQueryRecordSchema = externalQueryRecordSchema.extend({\n  type: v.literal('client'),\n\n  /** The original AST as supplied by the client. */\n  ast: astSchema,\n});\n\nexport type ClientQueryRecord = v.Infer<typeof clientQueryRecordSchema>;\n\nexport const customQueryRecordSchema = externalQueryRecordSchema.extend({\n  type: v.literal('custom'),\n  name: v.string(),\n  args: v.readonly(v.array(jsonSchema)),\n});\n\nexport type CustomQueryRecord = v.Infer<typeof customQueryRecordSchema>;\n\nexport const queryRecordSchema = v.union(\n  clientQueryRecordSchema,\n  customQueryRecordSchema,\n  internalQueryRecordSchema,\n);\n\nexport type QueryRecord = v.Infer<typeof queryRecordSchema>;\n\nexport const rowIDSchema = v.object({\n  schema: v.string(),\n  table: v.string(),\n  rowKey: v.record(jsonValueSchema),\n});\n\nexport type RowID = v.Infer<typeof rowIDSchema>;\n\nexport const rowRecordSchema = cvrRecordSchema.extend({\n  id: rowIDSchema,\n  rowVersion: v.string(), // '_0_version' of the row\n  // query hashes => refCount, or `null` for a row that was removed from the\n  // view (i.e. tombstone).\n  refCounts: v.record(v.number()).nullable(),\n});\n\nexport type RowRecord = v.Infer<typeof rowRecordSchema>;\n\nexport const patchSchema = v.object({\n  type: v.literalUnion('row', 'query'),\n  op: v.literalUnion('put', 'del'),\n});\n\nexport const putRowPatchSchema = patchSchema.extend({\n  type: v.literal('row'),\n  op: v.literal('put'),\n  id: rowIDSchema,\n  rowVersion: v.string(), // '_0_version' of the row\n});\n\nexport type PutRowPatch = v.Infer<typeof putRowPatchSchema>;\n\nexport const delRowPatchSchema = patchSchema.extend({\n  type: v.literal('row'),\n  op: v.literal('del'),\n  id: rowIDSchema,\n});\n\nexport type DelRowPatch = v.Infer<typeof delRowPatchSchema>;\n\nexport const rowPatchSchema = v.union(putRowPatchSchema, delRowPatchSchema);\n\nexport type RowPatch = v.Infer<typeof rowPatchSchema>;\n\nexport const queryPatchSchema = patchSchema.extend({\n  type: v.literal('query'),\n  id: v.string(),\n  clientID: v.string().optional(), // defined for \"desired\", undefined for \"got\"\n});\n\nexport type QueryPatch = v.Infer<typeof queryPatchSchema>;\n\nexport type PutQueryPatch = QueryPatch & {op: 'put'};\nexport type DelQueryPatch = QueryPatch & {op: 'del'};\n\nexport const metadataPatchSchema = queryPatchSchema;\n\nexport type MetadataPatch = v.Infer<typeof metadataPatchSchema>;\n\nexport function versionString(v: CVRVersion) {\n  // The separator (e.g. \":\") needs to be lexicographically greater than the\n  // storage key path separator (e.g. \"/\") so that \"01/row-hash\" is less than \"01:01/row-hash\".\n  // In particular, the traditional separator for major.minor versions (\".\") does not\n  // satisfy this quality.\n  return v.configVersion\n    ? `${v.stateVersion}:${versionToLexi(v.configVersion)}`\n    : v.stateVersion;\n}\n\nexport function versionFromString(str: string): CVRVersion {\n  const parts = str.split(':');\n  const stateVersion = parts[0];\n  switch (parts.length) {\n    case 1: {\n      stateVersionFromString(stateVersion); // Purely for validation.\n      return {stateVersion};\n    }\n    case 2: {\n      const configVersion = versionFromLexi(parts[1]);\n      if (configVersion > BigInt(Number.MAX_SAFE_INTEGER)) {\n        throw new Error(`minorVersion ${parts[1]} exceeds max safe integer`);\n      }\n      return {stateVersion, configVersion: Number(configVersion)};\n    }\n    default:\n      throw new TypeError(`Invalid version string ${str}`);\n  }\n}\n\nexport function queryRecordToQueryRow(\n  clientGroupID: string,\n  query: QueryRecord,\n): QueriesRow {\n  switch (query.type) {\n    case 'internal':\n      return {\n        clientGroupID,\n        queryHash: query.id,\n        clientAST: query.ast,\n        queryName: null,\n        queryArgs: null,\n        patchVersion: null,\n        transformationHash: query.transformationHash ?? null,\n        transformationVersion: maybeVersionString(query.transformationVersion),\n        internal: true,\n        deleted: false, // put vs del \"got\" query\n      };\n    case 'client':\n      return {\n        clientGroupID,\n        queryHash: query.id,\n        clientAST: query.ast,\n        queryName: null,\n        queryArgs: null,\n        patchVersion: maybeVersionString(query.patchVersion),\n        transformationHash: query.transformationHash ?? null,\n        transformationVersion: maybeVersionString(query.transformationVersion),\n        internal: null,\n        deleted: false, // put vs del \"got\" query\n      };\n    case 'custom':\n      return {\n        clientGroupID,\n        queryHash: query.id,\n        clientAST: null,\n        queryName: query.name,\n        queryArgs: query.args,\n        patchVersion: maybeVersionString(query.patchVersion),\n        transformationHash: query.transformationHash ?? null,\n        transformationVersion: maybeVersionString(query.transformationVersion),\n        internal: null,\n        deleted: false, // put vs del \"got\" query\n      };\n  }\n}\n\nexport const maybeVersionString = (v: CVRVersion | undefined) =>\n  v ? versionString(v) : null;\n"],"mappings":"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"}

package/out/zero-cache/src/services/view-syncer/snapshotter.d.ts

@@ -2,7 +2,7 @@ import type { LogContext } from '@rocicorp/logger';
 import { type JSONValue } from '../../../../shared/src/bigint-json.ts';
 import type { Row } from '../../../../zero-protocol/src/data.ts';
 import type { PrimaryKey } from '../../../../zero-types/src/schema.ts';
-import type { LiteAndZqlSpec, LiteTableSpecWithKeys } from '../../db/specs.ts';
+import type { LiteAndZqlSpec, LiteTableSpecWithKeysAndVersion } from '../../db/specs.ts';
 import { StatementRunner } from '../../db/statements.ts';
 import { type RowKey, type RowValue } from '../../types/row-key.ts';
 import type { AppID } from '../../types/shards.ts';
@@ -186,8 +186,8 @@ declare class Snapshot {
         changes: IterableIterator<unknown>;
         cleanup: () => void;
     };
-    getRow(table: LiteTableSpecWithKeys, rowKey: JSONValue): any;
-    getRows(table: LiteTableSpecWithKeys, keys: PrimaryKey[], row: RowValue): any[];
+    getRow(table: LiteTableSpecWithKeysAndVersion, rowKey: JSONValue): any;
+    getRows(table: LiteTableSpecWithKeysAndVersion, keys: PrimaryKey[], row: RowValue): any[];
     resetToHead(): Snapshot;
 }
 export declare class InvalidDiffError extends Error {

package/out/zero-cache/src/services/view-syncer/snapshotter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotter.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/snapshotter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshotter.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/snapshotter.ts"],"names":[],"mappings":"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"}