@intentius/sql-yodeler 0.0.0-stage → 0.1.0

package/dist/replay/clickhouse.js

@@ -0,0 +1,106 @@
+/**
+ * Replaying a ClickHouse history: the server `sql.profiles.<env>` binds (the
+ * emulator, `chant emulator up --lexicon sql`), statements sent as
+ * `yodel apply` sends them (rendered for the environment's topology, a
+ * mutation waited for), rebuild steps run as apply runs them, and each
+ * migration's recorded schema compared with what the server then holds, the
+ * way `chant sql plan` compares a build with a server (chant's normalizer,
+ * then the server's own formatter for expressions the rules leave
+ * different).
+ *
+ * The comparison reads every database the history names, so an object the
+ * replay made that the recorded schema leaves out is a difference too, and
+ * so is a database a migration should have dropped. chant's working objects
+ * (a rebuild's retained `__chant_old` table) are not read, as a plan does
+ * not read them.
+ */
+import { YodelError } from "../project.js";
+import { environmentSettings } from "../config/settings.js";
+import { httpPort } from "../history/index.js";
+import { renderForEnvironment } from "../topology/render.js";
+import { defaultStepRunner, planStep } from "../steps/index.js";
+const SYSTEM = new Set(["system", "information_schema", "INFORMATION_SCHEMA"]);
+const DEFAULT = "default";
+const ident = (s) => `\`${s.replace(/`/g, "``")}\``;
+const quote = (s) => `'${s.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+/** The databases a ClickHouse build output names, with bare names in `defaultDatabase`. */
+export async function clickhouseDatabases(schema, defaultDatabase) {
+    const { schemaFromBuildOutput } = await import("@intentius/chant-lexicon-sql/clickhouse/plan/schema");
+    return [...new Set(schemaFromBuildOutput(JSON.stringify(schema), defaultDatabase).map((o) => o.canonical.database ?? o.canonical.name))];
+}
+/** The replay driver for `env`, a ClickHouse environment, over the history `ordered`. */
+export async function clickhouseReplay(project, env, ordered, options = {}) {
+    const processEnv = options.processEnv ?? process.env;
+    const settings = environmentSettings(project, env.name, processEnv);
+    const { resolveClickHouseTarget, isUnresolvedTarget } = await import("@intentius/chant-lexicon-sql/clickhouse/live/bind");
+    const target = resolveClickHouseTarget({ environment: env.name, config: project.config, env: processEnv });
+    if (isUnresolvedTarget(target))
+        throw new YodelError(target.detail);
+    const endpoint = target.endpoint;
+    const topology = settings.topology;
+    const defaultDatabase = (m) => m.document.defaultDatabase ?? target.defaultDatabase;
+    const named = new Set();
+    for (const m of ordered)
+        for (const d of await clickhouseDatabases(m.document.schema, defaultDatabase(m)))
+            named.add(d);
+    const scope = [...named].sort();
+    const system = scope.filter((d) => SYSTEM.has(d));
+    if (system.length > 0)
+        throw new YodelError(`the history declares objects in ${system.join(", ")}, the server's own database; there is nothing a replay can start fresh there`);
+    if (scope.includes(settings.historyDatabase)) {
+        throw new YodelError(`the history declares objects in ${settings.historyDatabase}, the migration history's own database (${env.name}); the replay empties every database it replays into, so it refuses to touch that one`);
+    }
+    const port = options.port ?? (await httpPort(endpoint));
+    const log = options.log ?? (() => undefined);
+    const runStep = options.runStep ?? defaultStepRunner;
+    const tablesInDefault = async () => (await port.query(`SELECT name FROM system.tables WHERE database = ${quote(DEFAULT)} AND NOT is_temporary ORDER BY name`)).map((r) => r.name);
+    return {
+        dialect: "clickhouse",
+        where: `${endpoint.url} (${target.source})`,
+        scope,
+        async occupied() {
+            const others = scope.filter((d) => d !== DEFAULT);
+            const there = others.length === 0 ? [] : (await port.query(`SELECT name FROM system.databases WHERE name IN (${others.map(quote).join(", ")}) ORDER BY name`)).map((r) => r.name);
+            if (scope.includes(DEFAULT) && (await tablesInDefault()).length > 0)
+                there.unshift(`${DEFAULT} (not empty)`);
+            return there;
+        },
+        async clear() {
+            for (const d of scope) {
+                if (d !== DEFAULT)
+                    await port.query(`DROP DATABASE IF EXISTS ${ident(d)} SYNC`);
+                else
+                    for (const t of await tablesInDefault())
+                        await port.query(`DROP TABLE IF EXISTS ${ident(DEFAULT)}.${ident(t)} SYNC`);
+            }
+        },
+        async statement(_m, _index, step) {
+            await port.query(renderForEnvironment(step.sql, topology), step.waitsForMutation ? { settings: { mutations_sync: "2" } } : {});
+        },
+        async opStep(m, index) {
+            const step = m.document.steps[index];
+            if (!step)
+                return { refused: `${m.id} has no step ${String(index)}` };
+            const plan = planStep(step);
+            if (plan.run !== "rebuild")
+                return { refused: plan.run === "refused" ? plan.reason : `step ${String(index)} is not one the replay runs` };
+            const { summary } = await runStep({ environment: env.name, projectDir: project.dir, port, endpoint, migration: m, index, plan, log: (line) => { log(`  ${line}`); } });
+            const s = summary;
+            return { ran: true, ...(s?.swapped !== undefined ? { note: s.swapped ? "swapped" : "not swapped" } : {}) };
+        },
+        async compare(m) {
+            const { keyedByQualifiedName, schemaFromBuildOutput, schemaFromServer } = await import("@intentius/chant-lexicon-sql/clickhouse/plan/schema");
+            const { diffSchemas } = await import("@intentius/chant-lexicon-sql/clickhouse/plan/diff");
+            const { dropFormattingOnly } = await import("@intentius/chant-lexicon-sql/clickhouse/plan/server-format");
+            const db = defaultDatabase(m);
+            const declared = keyedByQualifiedName(schemaFromBuildOutput(JSON.stringify(m.document.schema), db, topology));
+            const live = await schemaFromServer({ ...target, databases: scope, defaultDatabase: db }, new Set(scope));
+            const diff = diffSchemas(live, declared);
+            const changes = await dropFormattingOnly(endpoint, diff.changes);
+            const label = new Map(declared.map((o) => [o.key, `${o.exportName} (${o.key})`]));
+            return changes.map((c) => ({ ...c, object: label.get(c.object) ?? c.object }));
+        },
+        close: () => Promise.resolve(),
+    };
+}
+//# sourceMappingURL=clickhouse.js.map

package/dist/replay/clickhouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.js","sourceRoot":"","sources":["../../src/replay/clickhouse.ts"],"names":[],"mappings":"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"}

package/dist/replay/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The replay check (#11): the migration history, replayed into the
+ * dialect's emulator, must produce each migration's recorded schema.
+ *
+ *   replayHistory(project, env, options)   read migrations/, replay them into env's server, compare after each
+ *   replayMigrations(ordered, driver)      the same over any driver (pure of dialect)
+ *   replayExitCode / replayFailure         0, 1 or 2; the first failing migration and why
+ *   renderReplay / replayJson              the result for people and for tools
+ *
+ * `yodel lint --replay <env>` and the CI template run it against the
+ * emulator (`chant emulator up --lexicon sql`), bound by the environment's
+ * `sql.profiles.<env>`.
+ */
+import type { Environment, Project } from "../project.js";
+import type { StepRunner } from "../steps/index.js";
+import type { ClickHousePort } from "../history/index.js";
+import { replayMigrations, type ReplayDriver, type ReplayOptions, type ReplayResult } from "./replay.js";
+export * from "./replay.js";
+export * from "./report.js";
+export { clickhouseDatabases, clickhouseReplay } from "./clickhouse.js";
+export { postgresReplay, postgresSchemas } from "./postgres.js";
+export interface ReplayHistoryOptions extends ReplayOptions {
+    processEnv?: NodeJS.ProcessEnv;
+    /** ClickHouse: the server, in place of an HTTP port to the bound endpoint. */
+    port?: ClickHousePort;
+    /** Runs a ClickHouseRebuildOp or PostgresMigrationOp step. Default: chant's local executor, as apply runs it. */
+    runStep?: StepRunner;
+}
+/** The dialect's driver for `env`. */
+export declare function openReplay(project: Project, env: Environment, ordered: Parameters<typeof replayMigrations>[0], options?: ReplayHistoryOptions): Promise<ReplayDriver>;
+/**
+ * Replays the project's migrations (well formed, or a `MigrationDirectoryError`)
+ * into `env`'s server and compares each with its recorded schema. Checksums
+ * are not this check's: `yodel lint` checks them.
+ */
+export declare function replayHistory(project: Project, env: Environment, options?: ReplayHistoryOptions): Promise<ReplayResult>;

package/dist/replay/index.js

@@ -0,0 +1,54 @@
+/**
+ * The replay check (#11): the migration history, replayed into the
+ * dialect's emulator, must produce each migration's recorded schema.
+ *
+ *   replayHistory(project, env, options)   read migrations/, replay them into env's server, compare after each
+ *   replayMigrations(ordered, driver)      the same over any driver (pure of dialect)
+ *   replayExitCode / replayFailure         0, 1 or 2; the first failing migration and why
+ *   renderReplay / replayJson              the result for people and for tools
+ *
+ * `yodel lint --replay <env>` and the CI template run it against the
+ * emulator (`chant emulator up --lexicon sql`), bound by the environment's
+ * `sql.profiles.<env>`.
+ */
+import { readMigrations } from "../migrations/index.js";
+import { migrationsDir } from "../versioned/index.js";
+import { clickhouseReplay } from "./clickhouse.js";
+import { postgresReplay } from "./postgres.js";
+import { replayMigrations } from "./replay.js";
+export * from "./replay.js";
+export * from "./report.js";
+export { clickhouseDatabases, clickhouseReplay } from "./clickhouse.js";
+export { postgresReplay, postgresSchemas } from "./postgres.js";
+/** The dialect's driver for `env`. */
+export async function openReplay(project, env, ordered, options = {}) {
+    if (project.dialect === "postgres") {
+        return postgresReplay(project, env, ordered, {
+            ...(options.processEnv ? { processEnv: options.processEnv } : {}),
+            ...(options.runStep ? { runStep: options.runStep } : {}),
+            ...(options.log ? { log: options.log } : {}),
+        });
+    }
+    return clickhouseReplay(project, env, ordered, {
+        ...(options.processEnv ? { processEnv: options.processEnv } : {}),
+        ...(options.port ? { port: options.port } : {}),
+        ...(options.runStep ? { runStep: options.runStep } : {}),
+        ...(options.log ? { log: options.log } : {}),
+    });
+}
+/**
+ * Replays the project's migrations (well formed, or a `MigrationDirectoryError`)
+ * into `env`'s server and compares each with its recorded schema. Checksums
+ * are not this check's: `yodel lint` checks them.
+ */
+export async function replayHistory(project, env, options = {}) {
+    const ordered = readMigrations(migrationsDir(project));
+    const driver = await openReplay(project, env, ordered, options);
+    try {
+        return await replayMigrations(ordered, driver, options);
+    }
+    finally {
+        await driver.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/replay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/replay/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAA4D,MAAM,aAAa,CAAC;AAEzG,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAUhE,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAgB,EAAE,GAAgB,EAAE,OAA+C,EAAE,UAAgC,EAAE;IACtJ,IAAI,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;YAC3C,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;QAC7C,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB,EAAE,GAAgB,EAAE,UAAgC,EAAE;IACxG,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/replay/postgres.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Replaying a Postgres history: the server `sql.profiles.<env>` binds (the
+ * emulator), each statement sent with `search_path` set to the migration's
+ * default schema, and each migration's recorded schema compared with the
+ * server the way `chant sql plan` compares a build with one
+ * (`planAgainstClient`: chant's normalizer, then the server's own
+ * formatting for expressions the rules leave different).
+ *
+ * Statements are sent one by one outside a transaction, so a
+ * `CONCURRENTLY` statement runs as written. The comparison reads every
+ * schema the history names.
+ *
+ * A `PostgresMigrationOp` step (a column rename, a type change across
+ * kinds) runs through the same step runner `yodel apply` uses: expand, dual
+ * write, backfill (of no rows), switch, contract, with the old column
+ * dropped as the recorded schema says.
+ */
+import { type Environment, type Project } from "../project.js";
+import type { Migration } from "../migrations/index.js";
+import { type StepRunner } from "../steps/index.js";
+import type { ReplayDriver } from "./replay.js";
+export interface PostgresReplayOptions {
+    processEnv?: NodeJS.ProcessEnv;
+    /** Runs a PostgresMigrationOp step. Default: chant's local executor, as apply runs it. */
+    runStep?: StepRunner;
+    log?: (line: string) => void;
+}
+/** The schemas a Postgres build output names, with bare names in `defaultSchema`. */
+export declare function postgresSchemas(schema: unknown, defaultSchema: string): Promise<string[]>;
+/** The replay driver for `env`, a Postgres environment, over the history `ordered`. */
+export declare function postgresReplay(project: Project, env: Environment, ordered: readonly Migration[], options?: PostgresReplayOptions): Promise<ReplayDriver>;

package/dist/replay/postgres.js

@@ -0,0 +1,140 @@
+/**
+ * Replaying a Postgres history: the server `sql.profiles.<env>` binds (the
+ * emulator), each statement sent with `search_path` set to the migration's
+ * default schema, and each migration's recorded schema compared with the
+ * server the way `chant sql plan` compares a build with one
+ * (`planAgainstClient`: chant's normalizer, then the server's own
+ * formatting for expressions the rules leave different).
+ *
+ * Statements are sent one by one outside a transaction, so a
+ * `CONCURRENTLY` statement runs as written. The comparison reads every
+ * schema the history names.
+ *
+ * A `PostgresMigrationOp` step (a column rename, a type change across
+ * kinds) runs through the same step runner `yodel apply` uses: expand, dual
+ * write, backfill (of no rows), switch, contract, with the old column
+ * dropped as the recorded schema says.
+ */
+import { YodelError } from "../project.js";
+import { environmentSettings } from "../config/settings.js";
+import { defaultStepRunner, planStep } from "../steps/index.js";
+const SYSTEM = new Set(["pg_catalog", "information_schema", "pg_toast"]);
+const PUBLIC = "public";
+const ident = (s) => `"${s.replace(/"/g, '""')}"`;
+/** The schemas a Postgres build output names, with bare names in `defaultSchema`. */
+export async function postgresSchemas(schema, defaultSchema) {
+    const { pgSchemaFromBuildOutput } = await import("@intentius/chant-lexicon-sql/postgres/plan/schema");
+    const out = new Set();
+    for (const o of pgSchemaFromBuildOutput(JSON.stringify(schema), defaultSchema)) {
+        if (o.canonical.kind === "schema")
+            out.add(o.canonical.name);
+        else if (o.canonical.schema)
+            out.add(o.canonical.schema);
+    }
+    return [...out];
+}
+/** The replay driver for `env`, a Postgres environment, over the history `ordered`. */
+export async function postgresReplay(project, env, ordered, options = {}) {
+    const processEnv = options.processEnv ?? process.env;
+    const settings = environmentSettings(project, env.name, processEnv);
+    const { resolvePostgresTarget, isUnresolvedTarget, redactUrl } = await import("@intentius/chant-lexicon-sql/postgres/live/bind");
+    const target = resolvePostgresTarget({ environment: env.name, config: project.config, env: processEnv });
+    if (isUnresolvedTarget(target))
+        throw new YodelError(target.detail);
+    const defaultSchema = (m) => m.document.defaultSchema ?? target.defaultSchema;
+    const runStep = options.runStep ?? defaultStepRunner;
+    const log = options.log ?? (() => undefined);
+    const named = new Set();
+    for (const m of ordered)
+        for (const s of await postgresSchemas(m.document.schema, defaultSchema(m)))
+            named.add(s);
+    const scope = [...named].sort();
+    const system = scope.filter((s) => SYSTEM.has(s) || s.startsWith("pg_"));
+    if (system.length > 0)
+        throw new YodelError(`the history declares objects in ${system.join(", ")}, the server's own schema; there is nothing a replay can start fresh there`);
+    if (scope.includes(settings.historyDatabase)) {
+        throw new YodelError(`the history declares objects in ${settings.historyDatabase}, the migration history's own schema (${env.name}); the replay empties every schema it replays into, so it refuses to touch that one`);
+    }
+    const { connectPostgres } = await import("@intentius/chant-lexicon-sql/postgres/live/client");
+    // Two sessions: the catalog is read with an empty search_path (as chant reads it), statements are sent with the migration's.
+    const reader = await connectPostgres(target.endpoint, { applicationName: "yodel replay" });
+    let writer;
+    try {
+        writer = await connectPostgres(target.endpoint, { applicationName: "yodel replay" });
+    }
+    catch (e) {
+        await reader.end();
+        throw e;
+    }
+    const publicObjects = async () => {
+        const [row] = await reader.query(`SELECT (SELECT count(*) FROM pg_catalog.pg_class c WHERE c.relnamespace = n.oid)
+            + (SELECT count(*) FROM pg_catalog.pg_type t WHERE t.typnamespace = n.oid AND t.typtype IN ('e', 'd'))
+            + (SELECT count(*) FROM pg_catalog.pg_proc p WHERE p.pronamespace = n.oid) AS n
+         FROM pg_catalog.pg_namespace n WHERE n.nspname = $1`, [PUBLIC]);
+        return Number(row?.n ?? 0);
+    };
+    return {
+        dialect: "postgres",
+        where: `${redactUrl(target.endpoint.url)} (${target.source})`,
+        scope,
+        async occupied() {
+            const others = scope.filter((s) => s !== PUBLIC);
+            const there = (await reader.query(`SELECT nspname FROM pg_catalog.pg_namespace WHERE nspname = ANY($1::text[]) ORDER BY nspname`, [others])).map((r) => r.nspname);
+            if (scope.includes(PUBLIC) && (await publicObjects()) > 0)
+                there.unshift(`${PUBLIC} (not empty)`);
+            return there;
+        },
+        async clear() {
+            for (const s of scope) {
+                if (s !== PUBLIC)
+                    await writer.query(`DROP SCHEMA IF EXISTS ${ident(s)} CASCADE`);
+                else
+                    await writer.query(`DROP SCHEMA IF EXISTS ${PUBLIC} CASCADE; CREATE SCHEMA ${PUBLIC}`);
+            }
+        },
+        async statement(m, _index, step) {
+            await writer.query(`SELECT pg_catalog.set_config('search_path', $1, false)`, [ident(defaultSchema(m))]);
+            await writer.query(step.sql);
+        },
+        async opStep(m, index) {
+            const step = m.document.steps[index];
+            if (!step)
+                return { refused: `${m.id} has no step ${String(index)}` };
+            const plan = planStep(step);
+            if (plan.run !== "pgMigration")
+                return { refused: plan.run === "refused" ? plan.reason : `step ${String(index)} is not one the replay runs on Postgres` };
+            const { summary } = await runStep({
+                environment: env.name,
+                projectDir: project.dir,
+                lockTimeoutMs: target.timeouts?.lockTimeoutMs,
+                migration: m,
+                index,
+                plan,
+                log: (line) => {
+                    log(`  ${line}`);
+                },
+            });
+            const s = summary;
+            const note = [s?.switched ? "switched" : undefined, s?.dropped ? "old column dropped" : undefined].filter(Boolean).join(", ");
+            return { ran: true, ...(note ? { note } : {}) };
+        },
+        async compare(m) {
+            const { pgSchemaFromBuildOutput } = await import("@intentius/chant-lexicon-sql/postgres/plan/schema");
+            const { planAgainstClient } = await import("@intentius/chant-lexicon-sql/postgres/plan/commands");
+            const ds = defaultSchema(m);
+            const recorded = m.document.schema;
+            const major = m.document.major ?? (typeof recorded.postgresMajor === "number" ? recorded.postgresMajor : undefined);
+            const { declared, diff } = await planAgainstClient(reader, { ...target, schemas: scope, defaultSchema: ds }, pgSchemaFromBuildOutput(JSON.stringify(m.document.schema), ds), {
+                ...(major !== undefined ? { major } : {}),
+                environment: env.name,
+            });
+            const label = new Map(declared.map((o) => [o.key, `${o.canonical.exportName ?? o.key} (${o.key.split(" ")[1] ?? o.key})`]));
+            return diff.changes.map((c) => ({ ...c, object: label.get(c.object) ?? c.object }));
+        },
+        async close() {
+            await writer.end();
+            await reader.end();
+        },
+    };
+}
+//# sourceMappingURL=postgres.js.map

package/dist/replay/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/replay/postgres.ts"],"names":[],"mappings":"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"}

package/dist/replay/replay.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The replay check, dialect-free: every migration, in chain order, into a
+ * database that starts empty, and after each one the database compared with
+ * the schema that migration records (`migration.json`'s `schema`). The first
+ * migration whose result differs fails the check, named, with what differs.
+ *
+ * A migration's recorded schema is what the next `yodel new` diffs from, so
+ * a recorded schema that its statements do not produce (a hand edit to
+ * either file, a rebase that recomputed one and not the other, a statement
+ * chant renders differently from what the server makes) would rot every
+ * migration after it. Replaying catches that while it is one migration.
+ *
+ * Steps, as replay treats them:
+ *
+ * - a `statement` is sent as `yodel apply` sends it;
+ * - a `ClickHouseRebuildOp` step (materialized-view mode) or a
+ *   `PostgresMigrationOp` step runs, as apply runs it: it changes the
+ *   table's schema, so the replay needs it;
+ * - a backfill step is skipped: it moves data, and the replayed database has
+ *   none, so it changes nothing the comparison reads;
+ * - anything else (a manual step, an Op apply does not run) cannot be
+ *   replayed: the check stops there, naming it ({@link ReplayResult} outcome
+ *   `unreplayable`).
+ *
+ * The database is the replay's: it must be fresh when the replay starts
+ * (every database or schema the history names absent, the default one
+ * empty), or emptied first when the caller says so (`reset`), and it is
+ * emptied again at the end unless `keep`. Nothing is recorded in a history
+ * table; no lock is taken.
+ */
+import type { ClassifiedChange } from "@intentius/chant-lexicon-sql/core/classifier";
+import type { StatementStep } from "@intentius/chant-lexicon-sql/migration-statements";
+import { type SqlDialect } from "../project.js";
+import type { Migration } from "../migrations/index.js";
+/** Exit code: the target is not fresh and `reset` was not given; nothing was run. */
+export declare const NOT_FRESH = 4;
+/** Exit code: a step the replay cannot run (a manual step, an Op it does not run). */
+export declare const UNREPLAYABLE = 2;
+/** One difference between the replayed database and a recorded schema: `before` is the replay's, `after` the record's. */
+export type ReplayChange = ClassifiedChange;
+/** What an Op step did in the replay. */
+export type OpStepOutcome = {
+    ran: true;
+    note?: string;
+} | {
+    refused: string;
+};
+/** What the replay needs from a dialect: a server it owns for the run. */
+export interface ReplayDriver {
+    dialect: SqlDialect;
+    /** The server, for messages (no credentials). */
+    where: string;
+    /** The databases (ClickHouse) or schemas (Postgres) the history names: the replay empties and compares all of them. */
+    scope: readonly string[];
+    /** The ones of {@link scope} that are not fresh: there (or, for the default one, not empty). */
+    occupied(): Promise<string[]>;
+    /** Empties {@link scope}: drops each one, and empties the default one. */
+    clear(): Promise<void>;
+    /** Sends one statement step of `m`, as apply sends it. Throws the server's error. */
+    statement(m: Migration, index: number, step: StatementStep): Promise<void>;
+    /** Runs an Op step that is neither a backfill nor refused by {@link planStep}; or says why it cannot. */
+    opStep(m: Migration, index: number): Promise<OpStepOutcome>;
+    /** The replayed database against `m`'s recorded schema. Empty when they match. */
+    compare(m: Migration): Promise<ReplayChange[]>;
+    close(): Promise<void>;
+}
+/** One migration the replay got through. */
+export interface ReplayedMigration {
+    id: string;
+    statements: number;
+    /** Op steps run, as `step <i>: <what>`. */
+    ran: string[];
+    /** Steps skipped, as `step <i>: <what> (<why>)`. */
+    skipped: string[];
+}
+export type ReplayResult = {
+    dialect: SqlDialect;
+    where: string;
+    scope: string[];
+    /** Whether the target held anything at the start, and was emptied (`reset`). */
+    reset: boolean;
+    /** Whether the replayed database was left in place (`keep`). */
+    kept: boolean;
+    /** The migrations that replayed to their recorded schema, in order. */
+    matched: ReplayedMigration[];
+    /** How many migrations the history has. */
+    total: number;
+} & ({
+    outcome: "matches";
+} | {
+    outcome: "differs";
+    migration: ReplayedMigration;
+    changes: ReplayChange[];
+} | {
+    outcome: "failed";
+    migration: string;
+    step: number;
+    error: string;
+} | {
+    outcome: "unreplayable";
+    migration: string;
+    step: number;
+    reason: string;
+});
+export interface ReplayOptions {
+    /** Empty the target first when it is not fresh. Without it, a target that is not fresh is refused ({@link NOT_FRESH}). */
+    reset?: boolean;
+    /** Leave the replayed database in place at the end, to look at. Default: emptied. */
+    keep?: boolean;
+    /** Progress, one line at a time. */
+    log?: (line: string) => void;
+}
+/** Replays `ordered` (first to newest) through `driver`; see the module comment. Throws only for a target that is not fresh, or a server that fails outside a statement. */
+export declare function replayMigrations(ordered: readonly Migration[], driver: ReplayDriver, options?: ReplayOptions): Promise<ReplayResult>;

package/dist/replay/replay.js

@@ -0,0 +1,98 @@
+/**
+ * The replay check, dialect-free: every migration, in chain order, into a
+ * database that starts empty, and after each one the database compared with
+ * the schema that migration records (`migration.json`'s `schema`). The first
+ * migration whose result differs fails the check, named, with what differs.
+ *
+ * A migration's recorded schema is what the next `yodel new` diffs from, so
+ * a recorded schema that its statements do not produce (a hand edit to
+ * either file, a rebase that recomputed one and not the other, a statement
+ * chant renders differently from what the server makes) would rot every
+ * migration after it. Replaying catches that while it is one migration.
+ *
+ * Steps, as replay treats them:
+ *
+ * - a `statement` is sent as `yodel apply` sends it;
+ * - a `ClickHouseRebuildOp` step (materialized-view mode) or a
+ *   `PostgresMigrationOp` step runs, as apply runs it: it changes the
+ *   table's schema, so the replay needs it;
+ * - a backfill step is skipped: it moves data, and the replayed database has
+ *   none, so it changes nothing the comparison reads;
+ * - anything else (a manual step, an Op apply does not run) cannot be
+ *   replayed: the check stops there, naming it ({@link ReplayResult} outcome
+ *   `unreplayable`).
+ *
+ * The database is the replay's: it must be fresh when the replay starts
+ * (every database or schema the history names absent, the default one
+ * empty), or emptied first when the caller says so (`reset`), and it is
+ * emptied again at the end unless `keep`. Nothing is recorded in a history
+ * table; no lock is taken.
+ */
+import { YodelError } from "../project.js";
+import { asBackfill, describeStep, planStep } from "../steps/kinds.js";
+/** Exit code: the target is not fresh and `reset` was not given; nothing was run. */
+export const NOT_FRESH = 4;
+/** Exit code: a step the replay cannot run (a manual step, an Op it does not run). */
+export const UNREPLAYABLE = 2;
+const firstLine = (s) => s.split("\n")[0] ?? s;
+const message = (e) => (e instanceof Error ? e.message : String(e));
+/** Replays `ordered` (first to newest) through `driver`; see the module comment. Throws only for a target that is not fresh, or a server that fails outside a statement. */
+export async function replayMigrations(ordered, driver, options = {}) {
+    const log = options.log ?? (() => undefined);
+    const base = { dialect: driver.dialect, where: driver.where, scope: [...driver.scope], total: ordered.length, kept: options.keep === true };
+    if (ordered.length === 0)
+        return { ...base, reset: false, kept: false, matched: [], outcome: "matches" };
+    const occupied = await driver.occupied();
+    if (occupied.length > 0) {
+        if (options.reset !== true) {
+            throw new YodelError(`refused: the replay needs a fresh database, and ${driver.where} already holds ${occupied.join(", ")}. ` +
+                `Point the replay at a throwaway emulator (chant emulator up --lexicon sql), or pass reset to drop ${occupied.length === 1 ? "it" : "them"} first. Nothing was run.`, NOT_FRESH);
+        }
+        log(`emptying ${occupied.join(", ")} on ${driver.where}`);
+        await driver.clear();
+    }
+    const matched = [];
+    try {
+        for (const m of ordered) {
+            const done = { id: m.id, statements: 0, ran: [], skipped: [] };
+            log(`${m.id}: replaying`);
+            for (const [i, step] of m.document.steps.entries()) {
+                const s = step;
+                if (s.kind === "statement") {
+                    try {
+                        await driver.statement(m, i, s);
+                    }
+                    catch (e) {
+                        return { ...base, reset: occupied.length > 0, matched, outcome: "failed", migration: m.id, step: i, error: firstLine(message(e)) };
+                    }
+                    done.statements++;
+                    continue;
+                }
+                if (asBackfill(s)) {
+                    done.skipped.push(`step ${String(i)}: ${describeStep(s)} (moves data; the replayed database has none)`);
+                    continue;
+                }
+                const plan = planStep(s);
+                const outcome = plan.run === "refused" ? { refused: plan.reason } : await driver.opStep(m, i);
+                if ("refused" in outcome) {
+                    return { ...base, reset: occupied.length > 0, matched, outcome: "unreplayable", migration: m.id, step: i, reason: outcome.refused };
+                }
+                done.ran.push(`step ${String(i)}: ${describeStep(s)}${outcome.note ? ` (${outcome.note})` : ""}`);
+            }
+            const changes = await driver.compare(m);
+            if (changes.length > 0) {
+                log(`${m.id}: differs from its recorded schema (${String(changes.length)} difference${changes.length === 1 ? "" : "s"})`);
+                return { ...base, reset: occupied.length > 0, matched, outcome: "differs", migration: done, changes };
+            }
+            log(`${m.id}: matches its recorded schema`);
+            matched.push(done);
+        }
+        return { ...base, reset: occupied.length > 0, matched, outcome: "matches" };
+    }
+    finally {
+        // Emptying afterwards is housekeeping: its failure is reported, never put in place of the result.
+        if (options.keep !== true)
+            await driver.clear().catch((e) => { log(`could not empty ${driver.scope.join(", ")} afterwards: ${firstLine(message(e))}`); });
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/replay/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/replay/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAqB,MAAM,mBAAmB,CAAC;AAE1F,qFAAqF;AACrF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAkE9B,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/D,MAAM,OAAO,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAErF,4KAA4K;AAC5K,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA6B,EAAE,MAAoB,EAAE,UAAyB,EAAE;IACrH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;IAC5I,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAEzG,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,IAAI,UAAU,CAClB,mDAAmD,MAAM,CAAC,KAAK,kBAAkB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBACtG,qGAAqG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,0BAA0B,EACtK,SAAS,CACV,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,YAAY,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAsB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAClF,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,IAAkC,CAAC;gBAC7C,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAC3B,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;oBAClC,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrI,CAAC;oBACD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAClB,SAAS;gBACX,CAAC;gBACD,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,+CAA+C,CAAC,CAAC;oBACxG,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,OAAO,GAAkB,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC7G,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;oBACzB,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtI,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpG,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,uCAAuC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;gBAC1H,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACxG,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC9E,CAAC;YAAS,CAAC;QACT,kGAAkG;QAClG,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;YAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,GAAG,GAAG,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrK,CAAC;AACH,CAAC"}