@intentius/sql-yodeler 0.2.0 → 0.4.0

package/dist/tenants/wave.js

@@ -0,0 +1,254 @@
+/**
+ * A tenant set's wave (#56): how the apply pipeline runs it, and what
+ * `yodel plan` and `yodel approve` show of it.
+ *
+ * A set given as a list or a file is a run per tenant, `<env>/<tenant>`,
+ * written into the rendered pipeline. A set given by a query is read when
+ * the wave runs, never when the pipeline is rendered: its wave is `shares`
+ * slots (one without `shares`), `<env>/@<i>of<n>`, and a slot is every
+ * tenant the query lists at that moment whose name hashes to it
+ * ({@link slotIndex}). Tenants come and go without a change to the
+ * pipeline, and a tenant always lands in the same slot.
+ *
+ * A slot's plan (`yodel apply <env>/@<i>of<n> --wave-plan`) is each of its
+ * tenants' wave plans and a digest over them, so the wave's one gate binds
+ * every tenant's plan whichever way the set is given. `--wave-apply` applies
+ * each tenant under its own lock, and refuses (exit 4) a tenant whose plan
+ * moved since the decision, naming it, after applying the others.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { resolveEnvironment, YodelError } from "../project.js";
+import { EXIT_REFUSED } from "../exit.js";
+import { closeVersioned, openVersioned } from "../versioned/engine.js";
+import { statusReport } from "../versioned/index.js";
+import { gateAtBase, planWave, viewWavePlan, WAVES_PIPELINE, WavePlanMoved } from "../waves/index.js";
+import { listTenants, tenantSetOf } from "./index.js";
+import { splitTarget, tenantTarget } from "./target.js";
+import { describeApprovalMode, signFlag, waveApproval } from "../approval-mode/index.js";
+/** A slot's tenant part: `@<i>of<n>`. */
+const SLOT = /^@([1-9][0-9]*)of([1-9][0-9]*)$/;
+/** Which slot of which set's wave a target is, when it is one: `prod/@2of4`. */
+export function splitSlot(target) {
+    const { env, tenant } = splitTarget(target);
+    const m = tenant === undefined ? null : SLOT.exec(tenant);
+    if (!m)
+        return undefined;
+    const index = Number(m[1]);
+    const count = Number(m[2]);
+    return index <= count ? { env, index, count } : undefined;
+}
+export const slotTarget = (env, index, count) => tenantTarget(env, `@${String(index)}of${String(count)}`);
+/** The slot, 1 to `count`, a tenant's name hashes to: the same whatever else the set lists. */
+export function slotIndex(tenant, count) {
+    return (Number.parseInt(createHash("sha256").update(tenant).digest("hex").slice(0, 8), 16) % count) + 1;
+}
+/** A set given by a query is read when its wave runs. */
+export const readAtRunTime = (set) => set !== undefined && !Array.isArray(set) && "query" in set;
+/**
+ * The runs of `env`'s wave, when it has a tenant set: a run per tenant, or
+ * for a set given by a query, `shares` slots (one without), with no server
+ * read. Undefined for an environment without a tenant set.
+ */
+export async function waveTargets(project, env, shares) {
+    const set = tenantSetOf(project, env);
+    if (set === undefined)
+        return undefined;
+    if (readAtRunTime(set)) {
+        const n = Math.max(1, shares ?? 1);
+        return Array.from({ length: n }, (_, i) => slotTarget(env, i + 1, n));
+    }
+    const tenants = (await listTenants(project, env)) ?? [];
+    if (tenants.length === 0)
+        throw new YodelError(`${env}'s tenant set lists no tenant, so its wave would apply nothing`);
+    return tenants.map((t) => tenantTarget(env, t));
+}
+/** The tenants of a slot now, sorted. */
+async function slotTenants(project, slot) {
+    return ((await listTenants(project, slot.env)) ?? []).filter((t) => slotIndex(t, slot.count) === slot.index).sort();
+}
+/** The digest of a slot's plan: over each of its tenants' wave plan digests. */
+export async function slotDigest(environment, tenants) {
+    const { computePlanDigest } = await import("@intentius/chant/lifecycle/plan-digest");
+    return computePlanDigest("yodel-wave-slot", { environment, tenants: [...tenants].sort((a, b) => (a.target < b.target ? -1 : 1)).map((t) => ({ target: t.target, planDigest: t.planDigest })) });
+}
+/** `yodel apply <env>/@<i>of<n> --wave-plan <file>`: plans every tenant of the slot, as the query lists them now. */
+export async function writeSlotPlan(project, target, ordered, file, options, log) {
+    const slot = splitSlot(target);
+    if (!slot)
+        throw new YodelError(`${target} is not a slot of a tenant set's wave`);
+    const path = resolve(file);
+    const before = existsSync(path) ? readSlotPlanSoftly(path) : undefined;
+    const tenants = [];
+    for (const t of await slotTenants(project, slot)) {
+        const env = resolveEnvironment(project, tenantTarget(slot.env, t));
+        const venv = await openVersioned(project, env);
+        try {
+            const plan = await planWave(project, venv, ordered, options);
+            tenants.push({ target: env.name, plan });
+            log(`${env.name}: ${plan.empty ? "nothing to apply" : `${String(plan.pending.length)} pending (${plan.pending.join(", ")})`}; plan ${plan.planDigest}`);
+            const was = before?.tenants.find((x) => x.target === env.name)?.plan.planDigest;
+            if (was !== undefined && was !== plan.planDigest)
+                log(`${env.name}: its plan moved since the plan before this one (${was}, now ${plan.planDigest})`);
+        }
+        finally {
+            await closeVersioned(venv);
+        }
+    }
+    const held = tenants.flatMap((t) => (t.plan.held ?? []).map((h) => `${t.target}: ${h}`));
+    const doc = {
+        planDigest: await slotDigest(target, tenants.map((t) => ({ target: t.target, planDigest: t.plan.planDigest }))),
+        destructive: tenants.some((t) => t.plan.destructive),
+        empty: tenants.every((t) => t.plan.empty),
+        environment: target,
+        tenants,
+        ...(held.length > 0 ? { held } : {}),
+    };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(doc, null, 2)}\n`);
+    log(`${target}: ${String(tenants.length)} tenant${tenants.length === 1 ? "" : "s"} of ${slot.env} (read now); plan ${doc.planDigest}`);
+    return doc;
+}
+function readSlotPlanSoftly(path) {
+    try {
+        const doc = JSON.parse(readFileSync(path, "utf8"));
+        return Array.isArray(doc.tenants) ? doc : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Reads a slot's plan file. */
+export function readSlotPlan(file) {
+    const path = resolve(file);
+    if (!existsSync(path))
+        throw new YodelError(`refused: the slot's plan file is not at ${path}. --wave-apply runs inside chant run wave, after it decided the wave; nothing was applied`, EXIT_REFUSED);
+    const doc = readSlotPlanSoftly(path);
+    if (!doc || typeof doc.planDigest !== "string")
+        throw new YodelError(`${file} is not a plan yodel apply <env>/@<i>of<n> --wave-plan wrote`);
+    return doc;
+}
+/**
+ * `yodel apply <env>/@<i>of<n> --wave-apply <file>`: each tenant the slot's
+ * plan names, through `applyTenant` (the tenant's own `--wave-apply`, with
+ * the decision checked for the slot). The exit code is 1 when a tenant
+ * failed, else 4 when a tenant's plan moved since the decision, else 0.
+ */
+export async function applySlot(target, file, applyTenant, log) {
+    const planned = readSlotPlan(file);
+    if (planned.environment !== target)
+        throw new YodelError(`refused: ${file} is ${planned.environment}'s plan, not ${target}'s; nothing was applied`, EXIT_REFUSED);
+    const moved = [];
+    const failed = [];
+    for (const { target: tenant, plan } of planned.tenants) {
+        const tenantFile = `${resolve(file)}.${splitTarget(tenant).tenant ?? "tenant"}.json`;
+        writeFileSync(tenantFile, `${JSON.stringify(plan, null, 2)}\n`);
+        try {
+            const code = await applyTenant(tenant, tenantFile, { target, planDigest: planned.planDigest });
+            if (code !== 0)
+                failed.push(tenant);
+        }
+        catch (e) {
+            if (e instanceof WavePlanMoved) {
+                log(`${tenant}: its plan moved since the wave was decided, so it was not applied. ${e.message}`);
+                moved.push(tenant);
+            }
+            else {
+                log(`${tenant}: ${e instanceof Error ? e.message : String(e)}`);
+                failed.push(tenant);
+            }
+        }
+    }
+    const applied = planned.tenants.length - moved.length - failed.length;
+    log(`${target}: ${String(applied)} of ${String(planned.tenants.length)} tenants applied${moved.length > 0 ? `; moved, not applied: ${moved.join(", ")}` : ""}${failed.length > 0 ? `; failed: ${failed.join(", ")}` : ""}`);
+    return failed.length > 0 ? 1 : moved.length > 0 ? EXIT_REFUSED : 0;
+}
+/** Every tenant of `set` now, each against its own history. */
+export async function viewTenants(project, set, ordered, options = {}) {
+    const out = [];
+    for (const t of (await listTenants(project, set)) ?? []) {
+        const env = resolveEnvironment(project, tenantTarget(set, t));
+        const venv = await openVersioned(project, env);
+        try {
+            const report = await statusReport(venv, ordered, { allowOutOfOrder: options.allowOutOfOrder === true, sync: false });
+            out.push({ target: env.name, report, ...(report.refusal ? {} : { plan: await viewWavePlan(project, venv, ordered, options) }) });
+        }
+        finally {
+            await closeVersioned(venv);
+        }
+    }
+    return out;
+}
+/**
+ * `set`'s wave over `tenants`, when yodel.config.ts `waves` names it: the
+ * runs the deciding job plans, their digests, and the set digest over them,
+ * which is what one approval binds. The `before` steps are not run here.
+ */
+export async function viewTenantSetWave(project, set, tenants) {
+    const waves = project.yodel?.config.waves ?? [];
+    const k = waves.findIndex((w) => w.env === set) + 1;
+    if (k === 0)
+        return undefined;
+    const { gate, at } = await gateAtBase(project, set);
+    const refused = tenants.filter((t) => !t.plan).map((t) => t.target);
+    const blocked = tenants.filter((t) => t.plan?.blocked).map((t) => t.target);
+    const planned = tenants.flatMap((t) => (t.plan ? [{ target: t.target, plan: t.plan }] : []));
+    const runs = [];
+    if (readAtRunTime(tenantSetOf(project, set))) {
+        const n = Math.max(1, waves[k - 1]?.shares ?? 1);
+        for (let i = 1; i <= n; i++) {
+            const target = slotTarget(set, i, n);
+            const mine = planned.filter((t) => slotIndex(splitTarget(t.target).tenant ?? "", n) === i).sort((a, b) => (a.target < b.target ? -1 : 1));
+            runs.push({
+                target,
+                tenants: mine.map((t) => t.target),
+                planDigest: await slotDigest(target, mine.map((t) => ({ target: t.target, planDigest: t.plan.planDigest }))),
+                destructive: mine.some((t) => t.plan.destructive),
+                empty: mine.every((t) => t.plan.empty),
+            });
+        }
+    }
+    else {
+        for (const t of planned)
+            runs.push({ target: t.target, tenants: [t.target], planDigest: t.plan.planDigest, destructive: t.plan.destructive, empty: t.plan.empty });
+    }
+    const view = { wave: k, gate, base: at.sha, baseSource: at.base.source, runs, refused, blocked, waits: false };
+    if (refused.length > 0)
+        return view;
+    const { waveSetDigest, waveGateName } = await import("@intentius/chant/gated-waves");
+    const { opWaveNeedsApproval } = await import("@intentius/chant/op");
+    const members = runs.map((r) => ({ member: r.target, planDigest: r.planDigest, op: "", ...(r.destructive ? { destructive: true } : {}), ...(r.empty ? { empty: true } : {}) }));
+    view.digest = waveSetDigest(members);
+    view.waits = blocked.length === 0 && opWaveNeedsApproval(gate, members);
+    const approval = waveApproval(at.config, set);
+    view.approve = `chant approve ${WAVES_PIPELINE} ${waveGateName(WAVES_PIPELINE, k)} --plan ${view.digest}${signFlag(approval)}`;
+    if (approval !== "ledger")
+        view.approval = approval;
+    return view;
+}
+/** The tenants of a set grouped by what is pending on them (the same migrations), in the order first seen. */
+export function groupTenants(tenants, key) {
+    const groups = new Map();
+    for (const t of tenants)
+        groups.set(key(t), [...(groups.get(key(t)) ?? []), t]);
+    return [...groups].map(([k, members]) => ({ key: k, members }));
+}
+/** Up to `max` names, then how many more. */
+export function someNames(names, code = (s) => s, max = 30) {
+    const shown = names.slice(0, max).map(code).join(", ");
+    return names.length > max ? `${shown} and ${String(names.length - max)} more` : shown;
+}
+/** One line on a tenant set's wave, for text and markdown. */
+export function describeTenantSetWave(w, count, code = (s) => s) {
+    const at = `gate ${code(w.gate)} at ${code(w.base.slice(0, 12))}`;
+    const tenants = `${String(count)} tenant${count === 1 ? "" : "s"}`;
+    if (w.refused.length > 0)
+        return `The apply pipeline fails wave ${String(w.wave)} until yodel apply stops refusing ${someNames(w.refused, code)} (${at}).`;
+    if (w.blocked.length > 0)
+        return `The apply pipeline refuses wave ${String(w.wave)} until what is pending on ${someNames(w.blocked, code)} has run where ${w.blocked.length === 1 ? "it requires" : "they require"} first; approve it then (${at}).`;
+    if (!w.waits)
+        return `The apply pipeline applies this to ${tenants} in wave ${String(w.wave)} with no approval (${at}).`;
+    return `The apply pipeline waits in wave ${String(w.wave)} for one approval of ${code(w.digest ?? "")}, for all ${tenants} (${at}).${w.approval && w.approval !== "ledger" ? ` ${describeApprovalMode(w.approval, code)}` : ""}`;
+}
+//# sourceMappingURL=wave.js.map

package/dist/tenants/wave.js.map

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

package/dist/testing/define.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Tests for migrations and schema objects (#54): what a project's
+ * `tests/*.test.ts` files declare, and the helpers they declare it with.
+ *
+ *     import { defineTests, expectError, expectRows, expectValue } from "@intentius/sql-yodeler";
+ *
+ *     export default defineTests([
+ *       {
+ *         name: "fill-country fills every event's country",
+ *         at: "20261010T0530-add-source",
+ *         seed: ["INSERT INTO shop.events (id, kind, at) VALUES (1, 'view', '2026-06-01 10:00:00')"],
+ *         expect: [expectValue("SELECT count() FROM shop.events WHERE country = ''", 0)],
+ *       },
+ *     ]);
+ *
+ * A case runs on a database of its own, built by `yodel test` from the
+ * migrations: every migration up to `at` (all of them when `at` is not
+ * given) is replayed into an empty database, the `seed` statements run,
+ * the migrations after `at` up to `through` (default: the newest) run with
+ * their steps, backfills included, and then each expectation is checked.
+ * A case without `at` tests the schema as the newest migration leaves it:
+ * a view's rows, a function's result, a constraint that refuses a row.
+ */
+/** Rows a query must return, in order: each row its column values in order. */
+export interface RowsExpectation {
+    kind: "rows";
+    sql: string;
+    rows: unknown[][];
+}
+/** The first column of the first row a query returns. */
+export interface ValueExpectation {
+    kind: "value";
+    sql: string;
+    value: unknown;
+}
+/** A statement that must fail; with `match`, with a message that contains it (a string) or matches it (a pattern). */
+export interface ErrorExpectation {
+    kind: "error";
+    sql: string;
+    match?: string | RegExp;
+}
+export type Expectation = RowsExpectation | ValueExpectation | ErrorExpectation;
+export interface TestCase {
+    /** Names the case in the output, in the JUnit file and for `--run`. */
+    name: string;
+    /** The migration the seed runs after. Default: the newest, so nothing runs after the seed. */
+    at?: string;
+    /** Statements run once the database is at `at`: the data the migrations after it meet. */
+    seed?: string[];
+    /** The last migration run after the seed. Default: the newest. */
+    through?: string;
+    /** Checked in order, after the migrations ran; every one is checked, even after one fails. */
+    expect: Expectation[];
+}
+/** Types a test file's cases; returns them as given. */
+export declare const defineTests: (cases: TestCase[]) => TestCase[];
+/** The query returns exactly `rows`, in order. Values compare as text: `1` and `"1"` are the same, a date as its ISO string. */
+export declare const expectRows: (sql: string, rows: unknown[][]) => RowsExpectation;
+/** The query's first row's first column is `value`, compared as text. */
+export declare const expectValue: (sql: string, value: unknown) => ValueExpectation;
+/** The statement fails; with `match`, with a message containing it (or matching it). */
+export declare const expectError: (sql: string, match?: string | RegExp) => ErrorExpectation;

package/dist/testing/define.js

@@ -0,0 +1,32 @@
+/**
+ * Tests for migrations and schema objects (#54): what a project's
+ * `tests/*.test.ts` files declare, and the helpers they declare it with.
+ *
+ *     import { defineTests, expectError, expectRows, expectValue } from "@intentius/sql-yodeler";
+ *
+ *     export default defineTests([
+ *       {
+ *         name: "fill-country fills every event's country",
+ *         at: "20261010T0530-add-source",
+ *         seed: ["INSERT INTO shop.events (id, kind, at) VALUES (1, 'view', '2026-06-01 10:00:00')"],
+ *         expect: [expectValue("SELECT count() FROM shop.events WHERE country = ''", 0)],
+ *       },
+ *     ]);
+ *
+ * A case runs on a database of its own, built by `yodel test` from the
+ * migrations: every migration up to `at` (all of them when `at` is not
+ * given) is replayed into an empty database, the `seed` statements run,
+ * the migrations after `at` up to `through` (default: the newest) run with
+ * their steps, backfills included, and then each expectation is checked.
+ * A case without `at` tests the schema as the newest migration leaves it:
+ * a view's rows, a function's result, a constraint that refuses a row.
+ */
+/** Types a test file's cases; returns them as given. */
+export const defineTests = (cases) => cases;
+/** The query returns exactly `rows`, in order. Values compare as text: `1` and `"1"` are the same, a date as its ISO string. */
+export const expectRows = (sql, rows) => ({ kind: "rows", sql, rows });
+/** The query's first row's first column is `value`, compared as text. */
+export const expectValue = (sql, value) => ({ kind: "value", sql, value });
+/** The statement fails; with `match`, with a message containing it (or matching it). */
+export const expectError = (sql, match) => ({ kind: "error", sql, ...(match !== undefined ? { match } : {}) });
+//# sourceMappingURL=define.js.map

package/dist/testing/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/testing/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAsCH,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAc,EAAE,CAAC,KAAK,CAAC;AAEpE,gIAAgI;AAChI,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,IAAiB,EAAmB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAE7G,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,KAAc,EAAoB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AAE9G,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,KAAuB,EAAoB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/testing/files.d.ts

@@ -0,0 +1,5 @@
+/** Where `yodel test` (#54) finds a project's test files: tests/*.test.ts. */
+/** Where test files are, under the project directory. */
+export declare const TESTS_DIR = "tests";
+/** The project's test files, by name; none when there is no tests/ directory. */
+export declare function testFiles(dir: string): string[];

package/dist/testing/files.js

@@ -0,0 +1,18 @@
+/** Where `yodel test` (#54) finds a project's test files: tests/*.test.ts. */
+import { readdirSync } from "node:fs";
+import { join } from "node:path";
+/** Where test files are, under the project directory. */
+export const TESTS_DIR = "tests";
+const TEST_FILE = /\.test\.(ts|mts|js|mjs)$/;
+/** The project's test files, by name; none when there is no tests/ directory. */
+export function testFiles(dir) {
+    let names;
+    try {
+        names = readdirSync(join(dir, TESTS_DIR));
+    }
+    catch {
+        return [];
+    }
+    return names.filter((n) => TEST_FILE.test(n)).sort().map((n) => join(dir, TESTS_DIR, n));
+}
+//# sourceMappingURL=files.js.map

package/dist/testing/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/testing/files.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AACjC,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAE7C,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/testing/report.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `yodel test`'s outcome for people (text), for tools (`--json`,
+ * schemas/test.schema.json) and for CI (`--junit <file>`, JUnit XML: one
+ * testsuite per test file, one testcase per case).
+ */
+import type { TestRun } from "./run.js";
+/** Exit code: a case failed, or could not run. */
+export declare const TESTS_FAILED = 3;
+export declare const testExitCode: (run: TestRun) => number;
+export declare function renderTests(run: TestRun): string;
+/** `--json`: schemas/test.schema.json. */
+export declare function testJson(run: TestRun): Record<string, unknown>;
+/** `--junit <file>`: JUnit XML, one testsuite per test file. */
+export declare function testJunit(run: TestRun): string;

package/dist/testing/report.js

@@ -0,0 +1,83 @@
+/**
+ * `yodel test`'s outcome for people (text), for tools (`--json`,
+ * schemas/test.schema.json) and for CI (`--junit <file>`, JUnit XML: one
+ * testsuite per test file, one testcase per case).
+ */
+/** Exit code: a case failed, or could not run. */
+export const TESTS_FAILED = 3;
+export const testExitCode = (run) => (run.cases.some((c) => c.status !== "passed") ? TESTS_FAILED : 0);
+const count = (run, status) => run.cases.filter((c) => c.status === status).length;
+export function renderTests(run) {
+    const lines = [`yodel test on ${run.environment} (${run.where})${run.reset ? `, ${run.scope.join(", ")} emptied first` : ""}:`];
+    for (const c of run.cases) {
+        lines.push(`  ${c.status === "passed" ? "pass" : c.status === "failed" ? "FAIL" : "ERROR"}  ${c.file} > ${c.name} (${String(c.ms)} ms)`);
+        if (c.error)
+            lines.push(`        ${c.error}`);
+        for (const f of c.failures)
+            lines.push(`        ${f}`);
+    }
+    if (run.cases.length === 0)
+        lines.push("  no case ran");
+    lines.push(`${String(count(run, "passed"))} passed, ${String(count(run, "failed"))} failed, ${String(count(run, "error"))} errors`);
+    return `${lines.join("\n")}\n`;
+}
+/** `--json`: schemas/test.schema.json. */
+export function testJson(run) {
+    return {
+        environment: run.environment,
+        dialect: run.dialect,
+        where: run.where,
+        scope: run.scope,
+        reset: run.reset,
+        files: run.files,
+        summary: { passed: count(run, "passed"), failed: count(run, "failed"), errors: count(run, "error") },
+        cases: run.cases.map((c) => ({
+            file: c.file,
+            name: c.name,
+            status: c.status,
+            ms: c.ms,
+            failures: c.failures,
+            ...(c.error !== undefined ? { error: c.error } : {}),
+            before: c.before,
+            after: c.after,
+        })),
+    };
+}
+const xml = (s) => s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    // XML 1.0 has no place for most control characters.
+    // eslint-disable-next-line no-control-regex
+    .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f]/g, "");
+const secs = (ms) => (ms / 1000).toFixed(3);
+/** `--junit <file>`: JUnit XML, one testsuite per test file. */
+export function testJunit(run) {
+    const out = ['<?xml version="1.0" encoding="UTF-8"?>'];
+    const total = run.cases.reduce((n, c) => n + c.ms, 0);
+    out.push(`<testsuites name="yodel test" tests="${String(run.cases.length)}" failures="${String(count(run, "failed"))}" errors="${String(count(run, "error"))}" time="${secs(total)}">`);
+    for (const file of run.files) {
+        const cases = run.cases.filter((c) => c.file === file);
+        const failures = cases.filter((c) => c.status === "failed").length;
+        const errors = cases.filter((c) => c.status === "error").length;
+        out.push(`  <testsuite name="${xml(file)}" tests="${String(cases.length)}" failures="${String(failures)}" errors="${String(errors)}" time="${secs(cases.reduce((n, c) => n + c.ms, 0))}">`);
+        for (const c of cases) {
+            const open = `    <testcase classname="${xml(file)}" name="${xml(c.name)}" time="${secs(c.ms)}"`;
+            if (c.status === "passed") {
+                out.push(`${open}/>`);
+                continue;
+            }
+            out.push(`${open}>`);
+            if (c.status === "failed")
+                out.push(`      <failure message="${xml(c.failures[0] ?? "")}">${xml(c.failures.join("\n"))}</failure>`);
+            else
+                out.push(`      <error message="${xml(c.error ?? "")}">${xml(c.error ?? "")}</error>`);
+            out.push("    </testcase>");
+        }
+        out.push("  </testsuite>");
+    }
+    out.push("</testsuites>");
+    return `${out.join("\n")}\n`;
+}
+//# sourceMappingURL=report.js.map

package/dist/testing/report.js.map

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

package/dist/testing/run.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `yodel test` (#54): the cases of a project's `tests/*.test.ts`
+ * (`./define.ts`), each run on a database built by replaying the
+ * migrations on a throwaway server.
+ *
+ * Per case, on the server the environment's profile binds:
+ *
+ * 1. the databases (ClickHouse) or schemas (Postgres) the history names are
+ *    emptied, so every case starts from nothing;
+ * 2. the migrations up to the case's `at` are replayed as `yodel lint
+ *    --replay` replays them: statements, and the rebuild and
+ *    PostgresMigrationOp steps apply runs, but not backfills, which would
+ *    find no rows;
+ * 3. the `seed` statements run;
+ * 4. the migrations after `at`, up to `through`, run with every step,
+ *    backfills included.
+ *
+ * A case's receipts, a backfill's batches and a ClickHouse rebuild's
+ * partitions, are kept in memory for that case alone (#112): nothing is
+ * written to the server's receipts table, and no case skips work because
+ * another case did it, or a run before this one.
+ * 5. each expectation is checked, every one even after one fails.
+ *
+ * A checkpoint (#63) is left out of the chain, as the replay leaves it out.
+ *
+ * It never runs against an environment yodel applies to: an environment
+ * whose history table holds a row is refused, `--reset` or not, and so is a
+ * target that already holds what the history names (unless `--reset`), and
+ * one another profile on the same server names (unless `--reset-shared`),
+ * as the replay refuses them. Nothing is written to a history. The
+ * databases are emptied again at the end unless `keep`.
+ */
+import { type Environment, type Project } from "../project.js";
+import { type RebuildReceiptStore, type StepRunner } from "../steps/index.js";
+import type { Expectation, TestCase } from "./define.js";
+export { TESTS_DIR, testFiles } from "./files.js";
+/** One test file and its cases. */
+export interface TestFile {
+    /** Relative to the project directory. */
+    file: string;
+    cases: TestCase[];
+}
+/** What a case's run came to. */
+export interface CaseResult {
+    file: string;
+    name: string;
+    /** passed: every expectation held. failed: one did not. error: the case could not run (a migration or a seed statement failed, an unknown migration id). */
+    status: "passed" | "failed" | "error";
+    ms: number;
+    /** The expectations that did not hold, one line each. */
+    failures: string[];
+    error?: string;
+    /** The migrations replayed before the seed, and those run after it. */
+    before: string[];
+    after: string[];
+}
+export interface TestRun {
+    environment: string;
+    dialect: Project["dialect"];
+    where: string;
+    scope: string[];
+    /** The target held what the history names, and was emptied first (`reset`). */
+    reset: boolean;
+    files: string[];
+    cases: CaseResult[];
+}
+/** Imports each test file and returns its cases: the default export, or `tests`. Throws naming what is wrong. */
+export declare function loadTests(projectDir: string, files?: string[]): Promise<TestFile[]>;
+/** A value as text, for comparing what a query returned with what a case expects. */
+export declare function asText(v: unknown): string;
+/** What running an expectation's SQL gave: its rows, or the server's error. */
+export type Outcome = {
+    rows: Array<Record<string, unknown>>;
+} | {
+    error: string;
+};
+/** Why `e` does not hold for `outcome`, or undefined when it holds. */
+export declare function expectationFailure(e: Expectation, outcome: Outcome): string | undefined;
+/**
+ * A receipt store for one case: a backfill's batches and a rebuild's
+ * partitions each run once in it, and nothing outlives the case.
+ *
+ * It keeps each receipt under its effect. A rebuild reads its receipts with
+ * `readAll(prefix)` and looks each up by address, the effect after the
+ * store's identity (`<stack>/<env>/`); the identity is the part of the
+ * prefix before the effects it asks for.
+ */
+export declare function memoryReceipts(): RebuildReceiptStore;
+export interface RunTestsOptions {
+    /** Only the cases whose name matches. */
+    run?: RegExp;
+    /** Empty the target first when it holds what the history names. */
+    reset?: boolean;
+    /** Other profiles on the same server whose databases or schemas the run may empty. */
+    resetShared?: readonly string[];
+    /** Leave the last case's database in place. */
+    keep?: boolean;
+    processEnv?: NodeJS.ProcessEnv;
+    log?: (line: string) => void;
+    /** Runs a backfill step (and every other Op step the replay driver does not). Default: as apply runs it. */
+    runStep?: StepRunner;
+}
+/** Runs the project's test cases on `env`'s server; see the module comment. */
+export declare function runTests(project: Project, env: Environment, files: readonly TestFile[], options?: RunTestsOptions): Promise<TestRun>;