@rocicorp/zero 1.6.2 → 1.7.0-canary.2

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

@@ -4,153 +4,137 @@ import { createRowsVersionTable, setupCVRTables } from "./cvr.js";
 //#region ../zero-cache/src/services/view-syncer/schema/init.ts
 async function initViewSyncerSchema(log, db, shard) {
 	const schema = cvrSchema(shard);
-	const setupMigration = {
+	await runSchemaMigrations(log, "view-syncer", cvrSchema(shard), db, {
 		migrateSchema: (lc, tx) => setupCVRTables(lc, tx, shard),
 		minSafeVersion: 1
-	};
-	const migrateV1toV2 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.instances ADD "replicaVersion" TEXT`;
-	} };
-	const migrateV2ToV3 = {
-		migrateSchema: async (_, tx) => {
-			await tx.unsafe(createRowsVersionTable(shard));
-		},
-		migrateData: async (lc, tx) => {
-			const pending = [];
-			for await (const versions of tx`
+	}, {
+		2: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.instances ADD "replicaVersion" TEXT`;
+		} },
+		3: {
+			migrateSchema: async (_, tx) => {
+				await tx.unsafe(createRowsVersionTable(shard));
+			},
+			/** Populates the cvr.rowsVersion table with versions from cvr.instances. */
+			migrateData: async (lc, tx) => {
+				const pending = [];
+				for await (const versions of tx`
       SELECT "clientGroupID", "version" FROM ${tx(schema)}.instances`.cursor(5e3)) for (const version of versions) pending.push(tx`INSERT INTO ${tx(schema)}."rowsVersion" ${tx(version)} 
                ON CONFLICT ("clientGroupID")
                DO UPDATE SET ${tx(version)}`.execute());
-			lc.info?.(`initializing rowsVersion for ${pending.length} cvrs`);
-			await Promise.all(pending);
-		}
-	};
-	const migrateV3ToV4 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.instances ADD "owner" TEXT`;
-		await tx`ALTER TABLE ${tx(schema)}.instances ADD "grantedAt" TIMESTAMPTZ`;
-	} };
-	const migrateV5ToV6 = { migrateSchema: async (_, tx) => {
-		await tx`
+				lc.info?.(`initializing rowsVersion for ${pending.length} cvrs`);
+				await Promise.all(pending);
+			}
+		},
+		4: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.instances ADD "owner" TEXT`;
+			await tx`ALTER TABLE ${tx(schema)}.instances ADD "grantedAt" TIMESTAMPTZ`;
+		} },
+		5: { minSafeVersion: 3 },
+		6: { migrateSchema: async (_, tx) => {
+			await tx`
       ALTER TABLE ${tx(schema)}."rows"
         DROP CONSTRAINT fk_rows_client_group`;
-		await tx`
+			await tx`
       ALTER TABLE ${tx(schema)}."rowsVersion"
         DROP CONSTRAINT fk_rows_version_client_group`;
-	} };
-	const migrateV6ToV7 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.desires ADD "expiresAt" TIMESTAMPTZ`;
-		await tx`ALTER TABLE ${tx(schema)}.desires ADD "inactivatedAt" TIMESTAMPTZ`;
-		await tx`ALTER TABLE ${tx(schema)}.desires ADD "ttl" INTERVAL`;
-		await tx`CREATE INDEX desires_expires_at ON ${tx(schema)}.desires ("expiresAt")`;
-		await tx`CREATE INDEX desires_inactivated_at ON ${tx(schema)}.desires ("inactivatedAt")`;
-	} };
-	const migrateV7ToV8 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}."desires" DROP CONSTRAINT fk_desires_client`;
-	} };
-	const migrateV8ToV9 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.instances ADD "clientSchema" JSONB`;
-	} };
-	const migrateV9ToV10 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.queries ADD "queryName" TEXT`;
-		await tx`ALTER TABLE ${tx(schema)}.queries ADD "queryArgs" JSONB`;
-		await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN "clientAST" DROP NOT NULL`;
-	} };
-	const migrateV10ToV11 = { migrateSchema: async (_, tx) => {
-		await tx`DROP INDEX IF EXISTS ${tx(schema)}.desires_expires_at`;
-		await tx`ALTER TABLE ${tx(schema)}.desires DROP COLUMN "expiresAt"`;
-		await tx`DROP INDEX IF EXISTS ${tx(schema)}.client_patch_version`;
-		await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN "patchVersion"`;
-		await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN "deleted"`;
-	} };
-	const migratedV11ToV12 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN "queryArgs" TYPE JSON USING "queryArgs"::JSON`;
-	} };
-	const migratedV12ToV13 = { migrateSchema: async (_, tx) => {
-		await tx`ALTER TABLE ${tx(schema)}.instances ADD COLUMN "ttlClock" DOUBLE PRECISION NOT NULL DEFAULT 0`;
-	} };
-	const migratedV13ToV14 = { migrateSchema: async (_, sql) => {
-		await sql`
+		} },
+		7: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.desires ADD "expiresAt" TIMESTAMPTZ`;
+			await tx`ALTER TABLE ${tx(schema)}.desires ADD "inactivatedAt" TIMESTAMPTZ`;
+			await tx`ALTER TABLE ${tx(schema)}.desires ADD "ttl" INTERVAL`;
+			await tx`CREATE INDEX desires_expires_at ON ${tx(schema)}.desires ("expiresAt")`;
+			await tx`CREATE INDEX desires_inactivated_at ON ${tx(schema)}.desires ("inactivatedAt")`;
+		} },
+		8: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}."desires" DROP CONSTRAINT fk_desires_client`;
+		} },
+		9: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.instances ADD "clientSchema" JSONB`;
+		} },
+		10: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.queries ADD "queryName" TEXT`;
+			await tx`ALTER TABLE ${tx(schema)}.queries ADD "queryArgs" JSONB`;
+			await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN "clientAST" DROP NOT NULL`;
+		} },
+		11: { migrateSchema: async (_, tx) => {
+			await tx`DROP INDEX IF EXISTS ${tx(schema)}.desires_expires_at`;
+			await tx`ALTER TABLE ${tx(schema)}.desires DROP COLUMN "expiresAt"`;
+			await tx`DROP INDEX IF EXISTS ${tx(schema)}.client_patch_version`;
+			await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN "patchVersion"`;
+			await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN "deleted"`;
+		} },
+		12: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN "queryArgs" TYPE JSON USING "queryArgs"::JSON`;
+		} },
+		13: { migrateSchema: async (_, tx) => {
+			await tx`ALTER TABLE ${tx(schema)}.instances ADD COLUMN "ttlClock" DOUBLE PRECISION NOT NULL DEFAULT 0`;
+		} },
+		14: { migrateSchema: async (_, sql) => {
+			await sql`
         CREATE INDEX instances_last_active ON ${sql(schema)}.instances ("lastActive");
       `;
-		for (const [table, reference] of [
-			["clients", "instances"],
-			["queries", "instances"],
-			["rows", "rowsVersion"]
-		]) {
-			const constraint = sql(`fk_${table}_client_group`);
-			await sql`
+			for (const [table, reference] of [
+				["clients", "instances"],
+				["queries", "instances"],
+				["rows", "rowsVersion"]
+			]) {
+				const constraint = sql(`fk_${table}_client_group`);
+				await sql`
           ALTER TABLE ${sql(schema)}.${sql(table)} DROP CONSTRAINT IF EXISTS ${constraint}`;
-			await sql`
+				await sql`
           ALTER TABLE ${sql(schema)}.${sql(table)} ADD CONSTRAINT ${constraint}
             FOREIGN KEY("clientGroupID")
             REFERENCES ${sql(schema)}.${sql(reference)} ("clientGroupID")
             ON DELETE CASCADE;
         `;
-		}
-	} };
-	const migratedV14ToV15 = {
-		migrateSchema: async (_, sql) => {
-			await sql`ALTER TABLE ${sql(schema)}.desires 
+			}
+		} },
+		15: {
+			migrateSchema: async (_, sql) => {
+				await sql`ALTER TABLE ${sql(schema)}.desires 
         ADD COLUMN "inactivatedAtMs" DOUBLE PRECISION`;
-			await sql`ALTER TABLE ${sql(schema)}.desires 
+				await sql`ALTER TABLE ${sql(schema)}.desires 
         ADD COLUMN "ttlMs" DOUBLE PRECISION`;
-		},
-		migrateData: async (lc, sql) => {
-			lc.info?.("Migrating desires.inactivatedAt to inactivatedAtMs and ttl to ttlMs");
-			await sql`
+			},
+			migrateData: async (lc, sql) => {
+				lc.info?.("Migrating desires.inactivatedAt to inactivatedAtMs and ttl to ttlMs");
+				await sql`
         UPDATE ${sql(schema)}.desires
         SET "inactivatedAtMs" = EXTRACT(EPOCH FROM "inactivatedAt") * 1000,
             "ttlMs" = EXTRACT(EPOCH FROM "ttl") * 1000
       `;
-		}
-	};
-	const migratedV15ToV16 = {
-		migrateSchema: async (_, sql) => {
-			await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN "profileID" TEXT`;
-			await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN "deleted" BOOL DEFAULT FALSE`;
-			await sql`
+			}
+		},
+		16: {
+			migrateSchema: async (_, sql) => {
+				await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN "profileID" TEXT`;
+				await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN "deleted" BOOL DEFAULT FALSE`;
+				await sql`
         DROP INDEX IF EXISTS ${sql(schema)}.instances_last_active`;
-			await sql`
+				await sql`
         CREATE INDEX instances_last_active ON ${sql(schema)}.instances ("lastActive")
           WHERE NOT "deleted"`;
-			await sql`
+				await sql`
         CREATE INDEX tombstones_last_active ON ${sql(schema)}.instances ("lastActive")
           WHERE "deleted"`;
-			await sql`
+				await sql`
         CREATE INDEX profile_ids_last_active ON ${sql(schema)}.instances ("lastActive", "profileID")
           WHERE "profileID" IS NOT NULL`;
-		},
-		migrateData: async (lc, sql) => {
-			lc.info?.("Backfilling instance.profileIDs");
-			await sql`
+			},
+			migrateData: async (lc, sql) => {
+				lc.info?.("Backfilling instance.profileIDs");
+				await sql`
         UPDATE ${sql(schema)}.instances
         SET "profileID" = 'cg' || "clientGroupID"
         WHERE "profileID" IS NULL
       `;
-		}
-	};
-	const migratedV16ToV17 = { migrateSchema: async (_, sql) => {
-		await sql`ALTER TABLE ${sql(schema)}.queries ADD COLUMN "rowSetSignature" TEXT`;
-	} };
-	const schemaVersionMigrationMap = {
-		2: migrateV1toV2,
-		3: migrateV2ToV3,
-		4: migrateV3ToV4,
-		5: { minSafeVersion: 3 },
-		6: migrateV5ToV6,
-		7: migrateV6ToV7,
-		8: migrateV7ToV8,
-		9: migrateV8ToV9,
-		10: migrateV9ToV10,
-		11: migrateV10ToV11,
-		12: migratedV11ToV12,
-		13: migratedV12ToV13,
-		14: migratedV13ToV14,
-		15: migratedV14ToV15,
-		16: migratedV15ToV16,
-		17: migratedV16ToV17
-	};
-	await runSchemaMigrations(log, "view-syncer", cvrSchema(shard), db, setupMigration, schemaVersionMigrationMap);
+			}
+		},
+		17: { migrateSchema: async (_, sql) => {
+			await sql`ALTER TABLE ${sql(schema)}.queries ADD COLUMN "rowSetSignature" TEXT`;
+		} }
+	});
 }
 //#endregion
 export { initViewSyncerSchema };

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

@@ -1 +1 @@
-{"version":3,"file":"init.js","names":[],"sources":["../../../../../../../zero-cache/src/services/view-syncer/schema/init.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {PendingQuery, Row} from 'postgres';\nimport {\n  runSchemaMigrations,\n  type IncrementalMigrationMap,\n  type Migration,\n} from '../../../db/migration.ts';\nimport type {PostgresDB} from '../../../types/pg.ts';\nimport {cvrSchema, type ShardID} from '../../../types/shards.ts';\nimport {createRowsVersionTable, setupCVRTables} from './cvr.ts';\n\nexport async function initViewSyncerSchema(\n  log: LogContext,\n  db: PostgresDB,\n  shard: ShardID,\n): Promise<void> {\n  const schema = cvrSchema(shard);\n\n  const setupMigration: Migration = {\n    migrateSchema: (lc, tx) => setupCVRTables(lc, tx, shard),\n    minSafeVersion: 1,\n  };\n\n  const migrateV1toV2: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"replicaVersion\" TEXT`;\n    },\n  };\n\n  const migrateV2ToV3: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx.unsafe(createRowsVersionTable(shard));\n    },\n\n    /** Populates the cvr.rowsVersion table with versions from cvr.instances. */\n    migrateData: async (lc, tx) => {\n      const pending: PendingQuery<Row[]>[] = [];\n      for await (const versions of tx<\n        {clientGroupID: string; version: string}[]\n      >`\n      SELECT \"clientGroupID\", \"version\" FROM ${tx(schema)}.instances`.cursor(\n        5000,\n      )) {\n        for (const version of versions) {\n          pending.push(\n            tx`INSERT INTO ${tx(schema)}.\"rowsVersion\" ${tx(version)} \n               ON CONFLICT (\"clientGroupID\")\n               DO UPDATE SET ${tx(version)}`.execute(),\n          );\n        }\n      }\n      lc.info?.(`initializing rowsVersion for ${pending.length} cvrs`);\n      await Promise.all(pending);\n    },\n  };\n\n  const migrateV3ToV4: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"owner\" TEXT`;\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"grantedAt\" TIMESTAMPTZ`;\n    },\n  };\n\n  const migrateV5ToV6: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`\n      ALTER TABLE ${tx(schema)}.\"rows\"\n        DROP CONSTRAINT fk_rows_client_group`;\n      await tx`\n      ALTER TABLE ${tx(schema)}.\"rowsVersion\"\n        DROP CONSTRAINT fk_rows_version_client_group`;\n    },\n  };\n\n  const migrateV6ToV7: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.desires ADD \"expiresAt\" TIMESTAMPTZ`;\n      await tx`ALTER TABLE ${tx(\n        schema,\n      )}.desires ADD \"inactivatedAt\" TIMESTAMPTZ`;\n      await tx`ALTER TABLE ${tx(schema)}.desires ADD \"ttl\" INTERVAL`;\n\n      await tx`CREATE INDEX desires_expires_at ON ${tx(\n        schema,\n      )}.desires (\"expiresAt\")`;\n      await tx`CREATE INDEX desires_inactivated_at ON ${tx(\n        schema,\n      )}.desires (\"inactivatedAt\")`;\n    },\n  };\n\n  const migrateV7ToV8: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(\n        schema,\n      )}.\"desires\" DROP CONSTRAINT fk_desires_client`;\n    },\n  };\n\n  const migrateV8ToV9: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"clientSchema\" JSONB`;\n    },\n  };\n\n  const migrateV9ToV10: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.queries ADD \"queryName\" TEXT`;\n      await tx`ALTER TABLE ${tx(schema)}.queries ADD \"queryArgs\" JSONB`;\n      await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN \"clientAST\" DROP NOT NULL`;\n    },\n  };\n\n  const migrateV10ToV11: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`DROP INDEX IF EXISTS ${tx(schema)}.desires_expires_at`;\n      await tx`ALTER TABLE ${tx(schema)}.desires DROP COLUMN \"expiresAt\"`;\n      await tx`DROP INDEX IF EXISTS ${tx(schema)}.client_patch_version`;\n      await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN \"patchVersion\"`;\n      await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN \"deleted\"`;\n    },\n  };\n\n  const migratedV11ToV12: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN \"queryArgs\" TYPE JSON USING \"queryArgs\"::JSON`;\n    },\n  };\n\n  const migratedV12ToV13: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD COLUMN \"ttlClock\" DOUBLE PRECISION NOT NULL DEFAULT 0`;\n    },\n  };\n\n  const migratedV13ToV14: Migration = {\n    migrateSchema: async (_, sql) => {\n      await sql`\n        CREATE INDEX instances_last_active ON ${sql(schema)}.instances (\"lastActive\");\n      `;\n\n      // Update / add foreign key constraints to cascade deletes.\n      for (const [table, reference] of [\n        ['clients', 'instances'],\n        ['queries', 'instances'],\n        ['rows', 'rowsVersion'],\n      ] as [string, string][]) {\n        const constraint = sql(`fk_${table}_client_group`);\n        await sql`\n          ALTER TABLE ${sql(schema)}.${sql(table)} DROP CONSTRAINT IF EXISTS ${constraint}`;\n        await sql`\n          ALTER TABLE ${sql(schema)}.${sql(table)} ADD CONSTRAINT ${constraint}\n            FOREIGN KEY(\"clientGroupID\")\n            REFERENCES ${sql(schema)}.${sql(reference)} (\"clientGroupID\")\n            ON DELETE CASCADE;\n        `;\n      }\n    },\n  };\n\n  const migratedV14ToV15: Migration = {\n    migrateSchema: async (_, sql) => {\n      // Add new columns for storing inactivatedAt and ttl in milliseconds.\n      // This avoids postgres.js type conversion issues with TIMESTAMPTZ and INTERVAL.\n      await sql`ALTER TABLE ${sql(schema)}.desires \n        ADD COLUMN \"inactivatedAtMs\" DOUBLE PRECISION`;\n      await sql`ALTER TABLE ${sql(schema)}.desires \n        ADD COLUMN \"ttlMs\" DOUBLE PRECISION`;\n    },\n    // Migrate existing data: convert TIMESTAMPTZ to milliseconds for inactivatedAt\n    // and INTERVAL to milliseconds for ttl\n    // Note: EXTRACT(EPOCH FROM NULL) returns NULL, so NULL values are preserved\n    migrateData: async (lc, sql) => {\n      lc.info?.(\n        'Migrating desires.inactivatedAt to inactivatedAtMs and ttl to ttlMs',\n      );\n      await sql`\n        UPDATE ${sql(schema)}.desires\n        SET \"inactivatedAtMs\" = EXTRACT(EPOCH FROM \"inactivatedAt\") * 1000,\n            \"ttlMs\" = EXTRACT(EPOCH FROM \"ttl\") * 1000\n      `;\n    },\n  };\n\n  const migratedV15ToV16: Migration = {\n    migrateSchema: async (_, sql) => {\n      await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN \"profileID\" TEXT`;\n      await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN \"deleted\" BOOL DEFAULT FALSE`;\n\n      // Recreate the instances_last_active index to exclude tombstones\n      await sql`\n        DROP INDEX IF EXISTS ${sql(schema)}.instances_last_active`;\n      await sql`\n        CREATE INDEX instances_last_active ON ${sql(schema)}.instances (\"lastActive\")\n          WHERE NOT \"deleted\"`;\n      await sql`\n        CREATE INDEX tombstones_last_active ON ${sql(schema)}.instances (\"lastActive\")\n          WHERE \"deleted\"`;\n      await sql`\n        CREATE INDEX profile_ids_last_active ON ${sql(schema)}.instances (\"lastActive\", \"profileID\")\n          WHERE \"profileID\" IS NOT NULL`;\n    },\n\n    // Backfill profileIDs to the `cg${clientGroupID}`, as is done for\n    // client groups from old zero-clients that don't send a profileID.\n    migrateData: async (lc, sql) => {\n      lc.info?.('Backfilling instance.profileIDs');\n      await sql`\n        UPDATE ${sql(schema)}.instances\n        SET \"profileID\" = 'cg' || \"clientGroupID\"\n        WHERE \"profileID\" IS NULL\n      `;\n    },\n  };\n\n  const migratedV16ToV17: Migration = {\n    migrateSchema: async (_, sql) => {\n      await sql`ALTER TABLE ${sql(schema)}.queries ADD COLUMN \"rowSetSignature\" TEXT`;\n    },\n  };\n\n  const schemaVersionMigrationMap: IncrementalMigrationMap = {\n    2: migrateV1toV2,\n    3: migrateV2ToV3,\n    4: migrateV3ToV4,\n    // v5 enables asynchronous row-record flushing, and thus relies on\n    // the logic that updates and checks the rowsVersion table in v3.\n    5: {minSafeVersion: 3},\n    6: migrateV5ToV6,\n    7: migrateV6ToV7,\n    8: migrateV7ToV8,\n    9: migrateV8ToV9,\n    // v10 adds queryName and queryArgs to the queries table to support\n    // custom queries. clientAST is now optional to support migrating\n    // off client queries.\n    10: migrateV9ToV10,\n    // V11 removes the deprecated queries.\"expiresAt\", clients.\"patchVersion\",\n    // clients.\"deleted\" columns.\n    11: migrateV10ToV11,\n    12: migratedV11ToV12,\n    // V13 adds instances.\"ttlClock\"\n    13: migratedV12ToV13,\n    // V14 adds an index on instances.\"lastActive\" and a FK constraint\n    // from rows.\"clientGroupID\" to rowsVersion.\"clientGroupID\" for\n    // garbage collection\n    14: migratedV13ToV14,\n    // V15 adds desires.\"inactivatedAtTTLClock\" to store TTLClock values\n    // directly as DOUBLE PRECISION, avoiding postgres.js TIMESTAMPTZ\n    // type conversion issues\n    15: migratedV14ToV15,\n    // V16 adds instances.\"profileID\" and a corresponding index for estimating\n    // active user counts more accurately for apps that use memstore.\n    16: migratedV15ToV16,\n    // V17 adds queries.\"rowSetSignature\" — XOR'd hash of row IDs attached to\n    // each query, used to detect drift on re-hydration of queries containing\n    // the Cap operator.\n    17: migratedV16ToV17,\n  };\n\n  await runSchemaMigrations(\n    log,\n    'view-syncer',\n    cvrSchema(shard),\n    db,\n    setupMigration,\n    schemaVersionMigrationMap,\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"init.js","names":[],"sources":["../../../../../../../zero-cache/src/services/view-syncer/schema/init.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {PendingQuery, Row} from 'postgres';\nimport {\n  runSchemaMigrations,\n  type IncrementalMigrationMap,\n  type Migration,\n} from '../../../db/migration.ts';\nimport type {PostgresDB} from '../../../types/pg.ts';\nimport {cvrSchema, type ShardID} from '../../../types/shards.ts';\nimport {createRowsVersionTable, setupCVRTables} from './cvr.ts';\n\nexport async function initViewSyncerSchema(\n  log: LogContext,\n  db: PostgresDB,\n  shard: ShardID,\n): Promise<void> {\n  const schema = cvrSchema(shard);\n\n  const setupMigration: Migration = {\n    migrateSchema: (lc, tx) => setupCVRTables(lc, tx, shard),\n    minSafeVersion: 1,\n  };\n\n  const migrateV1toV2: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"replicaVersion\" TEXT`;\n    },\n  };\n\n  const migrateV2ToV3: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx.unsafe(createRowsVersionTable(shard));\n    },\n\n    /** Populates the cvr.rowsVersion table with versions from cvr.instances. */\n    migrateData: async (lc, tx) => {\n      const pending: PendingQuery<Row[]>[] = [];\n      for await (const versions of tx<\n        {clientGroupID: string; version: string}[]\n      >`\n      SELECT \"clientGroupID\", \"version\" FROM ${tx(schema)}.instances`.cursor(\n        5000,\n      )) {\n        for (const version of versions) {\n          pending.push(\n            tx`INSERT INTO ${tx(schema)}.\"rowsVersion\" ${tx(version)} \n               ON CONFLICT (\"clientGroupID\")\n               DO UPDATE SET ${tx(version)}`.execute(),\n          );\n        }\n      }\n      lc.info?.(`initializing rowsVersion for ${pending.length} cvrs`);\n      await Promise.all(pending);\n    },\n  };\n\n  const migrateV3ToV4: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"owner\" TEXT`;\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"grantedAt\" TIMESTAMPTZ`;\n    },\n  };\n\n  const migrateV5ToV6: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`\n      ALTER TABLE ${tx(schema)}.\"rows\"\n        DROP CONSTRAINT fk_rows_client_group`;\n      await tx`\n      ALTER TABLE ${tx(schema)}.\"rowsVersion\"\n        DROP CONSTRAINT fk_rows_version_client_group`;\n    },\n  };\n\n  const migrateV6ToV7: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.desires ADD \"expiresAt\" TIMESTAMPTZ`;\n      await tx`ALTER TABLE ${tx(\n        schema,\n      )}.desires ADD \"inactivatedAt\" TIMESTAMPTZ`;\n      await tx`ALTER TABLE ${tx(schema)}.desires ADD \"ttl\" INTERVAL`;\n\n      await tx`CREATE INDEX desires_expires_at ON ${tx(\n        schema,\n      )}.desires (\"expiresAt\")`;\n      await tx`CREATE INDEX desires_inactivated_at ON ${tx(\n        schema,\n      )}.desires (\"inactivatedAt\")`;\n    },\n  };\n\n  const migrateV7ToV8: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(\n        schema,\n      )}.\"desires\" DROP CONSTRAINT fk_desires_client`;\n    },\n  };\n\n  const migrateV8ToV9: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD \"clientSchema\" JSONB`;\n    },\n  };\n\n  const migrateV9ToV10: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.queries ADD \"queryName\" TEXT`;\n      await tx`ALTER TABLE ${tx(schema)}.queries ADD \"queryArgs\" JSONB`;\n      await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN \"clientAST\" DROP NOT NULL`;\n    },\n  };\n\n  const migrateV10ToV11: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`DROP INDEX IF EXISTS ${tx(schema)}.desires_expires_at`;\n      await tx`ALTER TABLE ${tx(schema)}.desires DROP COLUMN \"expiresAt\"`;\n      await tx`DROP INDEX IF EXISTS ${tx(schema)}.client_patch_version`;\n      await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN \"patchVersion\"`;\n      await tx`ALTER TABLE ${tx(schema)}.clients DROP COLUMN \"deleted\"`;\n    },\n  };\n\n  const migratedV11ToV12: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.queries ALTER COLUMN \"queryArgs\" TYPE JSON USING \"queryArgs\"::JSON`;\n    },\n  };\n\n  const migratedV12ToV13: Migration = {\n    migrateSchema: async (_, tx) => {\n      await tx`ALTER TABLE ${tx(schema)}.instances ADD COLUMN \"ttlClock\" DOUBLE PRECISION NOT NULL DEFAULT 0`;\n    },\n  };\n\n  const migratedV13ToV14: Migration = {\n    migrateSchema: async (_, sql) => {\n      await sql`\n        CREATE INDEX instances_last_active ON ${sql(schema)}.instances (\"lastActive\");\n      `;\n\n      // Update / add foreign key constraints to cascade deletes.\n      for (const [table, reference] of [\n        ['clients', 'instances'],\n        ['queries', 'instances'],\n        ['rows', 'rowsVersion'],\n      ] as [string, string][]) {\n        const constraint = sql(`fk_${table}_client_group`);\n        await sql`\n          ALTER TABLE ${sql(schema)}.${sql(table)} DROP CONSTRAINT IF EXISTS ${constraint}`;\n        await sql`\n          ALTER TABLE ${sql(schema)}.${sql(table)} ADD CONSTRAINT ${constraint}\n            FOREIGN KEY(\"clientGroupID\")\n            REFERENCES ${sql(schema)}.${sql(reference)} (\"clientGroupID\")\n            ON DELETE CASCADE;\n        `;\n      }\n    },\n  };\n\n  const migratedV14ToV15: Migration = {\n    migrateSchema: async (_, sql) => {\n      // Add new columns for storing inactivatedAt and ttl in milliseconds.\n      // This avoids postgres.js type conversion issues with TIMESTAMPTZ and INTERVAL.\n      await sql`ALTER TABLE ${sql(schema)}.desires \n        ADD COLUMN \"inactivatedAtMs\" DOUBLE PRECISION`;\n      await sql`ALTER TABLE ${sql(schema)}.desires \n        ADD COLUMN \"ttlMs\" DOUBLE PRECISION`;\n    },\n    // Migrate existing data: convert TIMESTAMPTZ to milliseconds for inactivatedAt\n    // and INTERVAL to milliseconds for ttl\n    // Note: EXTRACT(EPOCH FROM NULL) returns NULL, so NULL values are preserved\n    migrateData: async (lc, sql) => {\n      lc.info?.(\n        'Migrating desires.inactivatedAt to inactivatedAtMs and ttl to ttlMs',\n      );\n      await sql`\n        UPDATE ${sql(schema)}.desires\n        SET \"inactivatedAtMs\" = EXTRACT(EPOCH FROM \"inactivatedAt\") * 1000,\n            \"ttlMs\" = EXTRACT(EPOCH FROM \"ttl\") * 1000\n      `;\n    },\n  };\n\n  const migratedV15ToV16: Migration = {\n    migrateSchema: async (_, sql) => {\n      await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN \"profileID\" TEXT`;\n      await sql`ALTER TABLE ${sql(schema)}.instances ADD COLUMN \"deleted\" BOOL DEFAULT FALSE`;\n\n      // Recreate the instances_last_active index to exclude tombstones\n      await sql`\n        DROP INDEX IF EXISTS ${sql(schema)}.instances_last_active`;\n      await sql`\n        CREATE INDEX instances_last_active ON ${sql(schema)}.instances (\"lastActive\")\n          WHERE NOT \"deleted\"`;\n      await sql`\n        CREATE INDEX tombstones_last_active ON ${sql(schema)}.instances (\"lastActive\")\n          WHERE \"deleted\"`;\n      await sql`\n        CREATE INDEX profile_ids_last_active ON ${sql(schema)}.instances (\"lastActive\", \"profileID\")\n          WHERE \"profileID\" IS NOT NULL`;\n    },\n\n    // Backfill profileIDs to the `cg${clientGroupID}`, as is done for\n    // client groups from old zero-clients that don't send a profileID.\n    migrateData: async (lc, sql) => {\n      lc.info?.('Backfilling instance.profileIDs');\n      await sql`\n        UPDATE ${sql(schema)}.instances\n        SET \"profileID\" = 'cg' || \"clientGroupID\"\n        WHERE \"profileID\" IS NULL\n      `;\n    },\n  };\n\n  const migratedV16ToV17: Migration = {\n    migrateSchema: async (_, sql) => {\n      await sql`ALTER TABLE ${sql(schema)}.queries ADD COLUMN \"rowSetSignature\" TEXT`;\n    },\n  };\n\n  const schemaVersionMigrationMap: IncrementalMigrationMap = {\n    2: migrateV1toV2,\n    3: migrateV2ToV3,\n    4: migrateV3ToV4,\n    // v5 enables asynchronous row-record flushing, and thus relies on\n    // the logic that updates and checks the rowsVersion table in v3.\n    5: {minSafeVersion: 3},\n    6: migrateV5ToV6,\n    7: migrateV6ToV7,\n    8: migrateV7ToV8,\n    9: migrateV8ToV9,\n    // v10 adds queryName and queryArgs to the queries table to support\n    // custom queries. clientAST is now optional to support migrating\n    // off client queries.\n    10: migrateV9ToV10,\n    // V11 removes the deprecated queries.\"expiresAt\", clients.\"patchVersion\",\n    // clients.\"deleted\" columns.\n    11: migrateV10ToV11,\n    12: migratedV11ToV12,\n    // V13 adds instances.\"ttlClock\"\n    13: migratedV12ToV13,\n    // V14 adds an index on instances.\"lastActive\" and a FK constraint\n    // from rows.\"clientGroupID\" to rowsVersion.\"clientGroupID\" for\n    // garbage collection\n    14: migratedV13ToV14,\n    // V15 adds desires.\"inactivatedAtTTLClock\" to store TTLClock values\n    // directly as DOUBLE PRECISION, avoiding postgres.js TIMESTAMPTZ\n    // type conversion issues\n    15: migratedV14ToV15,\n    // V16 adds instances.\"profileID\" and a corresponding index for estimating\n    // active user counts more accurately for apps that use memstore.\n    16: migratedV15ToV16,\n    // V17 adds queries.\"rowSetSignature\" — XOR'd hash of row IDs attached to\n    // each query, used to detect drift on re-hydration of queries containing\n    // the Cap operator.\n    17: migratedV16ToV17,\n  };\n\n  await runSchemaMigrations(\n    log,\n    'view-syncer',\n    cvrSchema(shard),\n    db,\n    setupMigration,\n    schemaVersionMigrationMap,\n  );\n}\n"],"mappings":"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"}

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

@@ -7,7 +7,26 @@ import { majorVersionToString, stateVersionFromString } from "../../../types/sta
 import { ttlClockSchema } from "../ttl-clock.js";
 //#region ../zero-cache/src/services/view-syncer/schema/types.ts
 var cvrVersionSchema = valita_exports.object({
+	/**
+	* The database `stateVersion` with which the rows in the CVR are consistent.
+	*/
 	stateVersion: valita_exports.string(),
+	/**
+	* `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: valita_exports.number().optional()
 });
 var EMPTY_CVR_VERSION = { stateVersion: majorVersionToString(0) };
@@ -34,15 +53,75 @@ function cookieToVersion(cookie) {
 	return versionFromString(cookie);
 }
 valita_exports.object({ id: valita_exports.string() });
-var cvrRecordSchema = valita_exports.object({ patchVersion: cvrVersionSchema });
+var cvrRecordSchema = valita_exports.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 });
 valita_exports.object({
+	/** The client ID, of which there can be multiple for a client group view. */
 	id: valita_exports.string(),
+	/** The client's desired query IDs. Patch information is stored in the QueryRecord. */
 	desiredQueryIDs: valita_exports.array(valita_exports.string())
 });
 var baseQueryRecordSchema = valita_exports.object({
+	/** The client-specified ID used to identify this query. Typically a hash. */
 	id: valita_exports.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: valita_exports.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(),
+	/**
+	* Hex-encoded XOR signature over `h64(JSON.stringify([schema, table, rowKey]))`
+	* of every row currently attached to this query. Maintained incrementally by
+	* `PipelineDriver` as ADDs / REMOVEs are yielded from the query's pipeline
+	* (EDITs no-op), and persisted via `CVRQueryDrivenUpdater.flush` by a
+	* signature-provider callback.
+	*
+	* Used to detect drift on re-hydration of queries containing the `Cap` operator,
+	* which intentionally does not impose ordering and thus may pick a different N-row
+	* subset on re-execution. Comparing the pre-hydration signature with the post-
+	* hydration signature lets us force a `configVersion` bump so the standard CVR-diff
+	* machinery emits the reconciling poke. Absent or `'0'` means the signature is
+	* empty (no rows currently attached).
+	*/
 	rowSetSignature: valita_exports.string().optional()
 });
 /**
@@ -56,16 +135,39 @@ var internalQueryRecordSchema = baseQueryRecordSchema.extend({
 	ast: astSchema
 });
 var clientStateSchema = valita_exports.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: valita_exports.number(),
+	/**
+	* The version at which the client state changed (i.e. individual `patchVersion`s).
+	*/
 	version: cvrVersionSchema
 });
 var 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: valita_exports.record(clientStateSchema),
 	patchVersion: cvrVersionSchema.optional()
 });
 var clientQueryRecordSchema = externalQueryRecordSchema.extend({
 	type: valita_exports.literal("client"),
+	/** The original AST as supplied by the client. */
 	ast: astSchema
 });
 var customQueryRecordSchema = externalQueryRecordSchema.extend({

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

@@ -1 +1 @@
-{"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   * Hex-encoded XOR signature over `h64(JSON.stringify([schema, table, rowKey]))`\n   * of every row currently attached to this query. Maintained incrementally by\n   * `PipelineDriver` as ADDs / REMOVEs are yielded from the query's pipeline\n   * (EDITs no-op), and persisted via `CVRQueryDrivenUpdater.flush` by a\n   * signature-provider callback.\n   *\n   * Used to detect drift on re-hydration of queries containing the `Cap` operator,\n   * which intentionally does not impose ordering and thus may pick a different N-row\n   * subset on re-execution. Comparing the pre-hydration signature with the post-\n   * hydration signature lets us force a `configVersion` bump so the standard CVR-diff\n   * machinery emits the reconciling poke. Absent or `'0'` means the signature is\n   * empty (no rows currently attached).\n   */\n  rowSetSignature: v.string().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        rowSetSignature: query.rowSetSignature ?? null,\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        rowSetSignature: query.rowSetSignature ?? null,\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        rowSetSignature: query.rowSetSignature ?? null,\n      };\n  }\n}\n\nexport const maybeVersionString = (v: CVRVersion | undefined) =>\n  v ? versionString(v) : null;\n"],"mappings":"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"}
+{"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   * Hex-encoded XOR signature over `h64(JSON.stringify([schema, table, rowKey]))`\n   * of every row currently attached to this query. Maintained incrementally by\n   * `PipelineDriver` as ADDs / REMOVEs are yielded from the query's pipeline\n   * (EDITs no-op), and persisted via `CVRQueryDrivenUpdater.flush` by a\n   * signature-provider callback.\n   *\n   * Used to detect drift on re-hydration of queries containing the `Cap` operator,\n   * which intentionally does not impose ordering and thus may pick a different N-row\n   * subset on re-execution. Comparing the pre-hydration signature with the post-\n   * hydration signature lets us force a `configVersion` bump so the standard CVR-diff\n   * machinery emits the reconciling poke. Absent or `'0'` means the signature is\n   * empty (no rows currently attached).\n   */\n  rowSetSignature: v.string().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        rowSetSignature: query.rowSetSignature ?? null,\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        rowSetSignature: query.rowSetSignature ?? null,\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        rowSetSignature: query.rowSetSignature ?? null,\n      };\n  }\n}\n\nexport const maybeVersionString = (v: CVRVersion | undefined) =>\n  v ? versionString(v) : null;\n"],"mappings":"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"}