@intentius/sql-yodeler 0.0.0-stage → 0.1.0

package/dist/chant/drift.js

@@ -0,0 +1,91 @@
+/**
+ * Drift: the declared objects whose live definition changed out of band, or
+ * that are gone from the server. Read from `chant lifecycle diff <env> --live
+ * --json`, the sql lexicon's section of it:
+ *
+ * - `deep.drifted[].changes[]`: a declared object whose live definition
+ *   differs, property by property, declared against live;
+ * - `resources.missing`: a declared object the server does not have;
+ * - `resources.unobserved` and `deep.unobserved`: a declared object chant
+ *   could not read (no credentials, a kind it cannot observe). Not drift, and
+ *   not clean either: that part of the environment is unknown.
+ *
+ * An object the project does not declare is never reported: chant only reads
+ * what the project declares, and only touches what carries its marker.
+ */
+import { YodelError } from "../project.js";
+import { lastJsonLine, runChant } from "./process.js";
+/** Exit code: an owned object changed or is gone. */
+export const DRIFTED = 2;
+/** `2` on drift; `1` when there is none but part of the environment could not be read; `0` when clean. */
+export function driftExitCode(drift) {
+    if (drift.changed.length > 0 || drift.missing.length > 0)
+        return DRIFTED;
+    return drift.unobserved.length > 0 ? 1 : 0;
+}
+/** The drift in a parsed `chant lifecycle diff --live --json` document. */
+export function driftFromLifecycle(environment, doc) {
+    const lexicons = doc?.lexicons;
+    if (!lexicons) {
+        const stacks = doc?.stacks;
+        throw new YodelError(stacks
+            ? "chant lifecycle diff reported per stack; a yodel project is one database and one stack"
+            : "chant lifecycle diff --json printed no lexicons");
+    }
+    const sql = lexicons.sql ?? {};
+    const unobserved = new Map();
+    for (const u of [...(sql.resources?.unobserved ?? []), ...(sql.deep?.unobserved ?? [])]) {
+        if (!unobserved.has(u.name))
+            unobserved.set(u.name, u);
+    }
+    return {
+        environment,
+        changed: (sql.deep?.drifted ?? []).filter((d) => d.changes.length > 0),
+        missing: [...(sql.resources?.missing ?? [])].sort(),
+        unobserved: [...unobserved.values()].sort((a, b) => a.name.localeCompare(b.name)),
+    };
+}
+/** Runs `chant lifecycle diff <env> --live --json` in the project and reads the drift from it. */
+export async function readDrift(project, env, options = {}) {
+    const result = await runChant(["lifecycle", "diff", env.name, "--live", "--json"], {
+        cwd: project.dir,
+        ...(options.env ? { env: options.env } : {}),
+    });
+    const doc = lastJsonLine(result.stdout);
+    if (result.code !== 0 || doc === undefined) {
+        const detail = (result.stderr || result.stdout).trim();
+        throw new YodelError(`chant lifecycle diff ${env.name} --live failed (exit ${String(result.code)})${detail ? `:\n${detail}` : ""}`);
+    }
+    return driftFromLifecycle(env.name, doc);
+}
+const show = (v) => (v === undefined ? "(none)" : typeof v === "string" ? v : JSON.stringify(v));
+/** The drift as text. */
+export function renderDrift(drift) {
+    const lines = [`Drift in ${drift.environment}`, ""];
+    if (drift.changed.length === 0 && drift.missing.length === 0) {
+        lines.push("No drift: every declared object matches the server.");
+    }
+    if (drift.changed.length > 0) {
+        lines.push("Changed out of band:");
+        for (const e of drift.changed) {
+            lines.push(`  ${e.name} (${e.type})`);
+            for (const c of e.changes) {
+                lines.push(c.kind === "absent" ? `    ${c.path}: declared ${show(c.declared)}, absent live` : `    ${c.path}: declared ${show(c.declared)}, live ${show(c.live)}`);
+            }
+        }
+    }
+    if (drift.missing.length > 0) {
+        if (drift.changed.length > 0)
+            lines.push("");
+        lines.push("Gone (declared, not on the server):");
+        for (const name of drift.missing)
+            lines.push(`  ${name}`);
+    }
+    if (drift.unobserved.length > 0) {
+        lines.push("", "Could not be read, so their state is unknown:");
+        for (const u of drift.unobserved)
+            lines.push(`  ${u.name}: ${u.reason}${u.detail ? ` (${u.detail})` : ""}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=drift.js.map

package/dist/chant/drift.js.map

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

package/dist/chant/plan.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The plan: the classified change from an environment's live database to the
+ * declared schema. This is `chant sql plan <env> <build>`, called as the
+ * library functions that command runs (`planAgainstServer` for ClickHouse,
+ * `planPgAgainstServer` for Postgres) rather than through the CLI.
+ */
+import type { SchemaDiff } from "@intentius/chant-lexicon-sql/clickhouse/plan/diff";
+import type { PgSchemaDiff } from "@intentius/chant-lexicon-sql/postgres/plan/diff";
+import type { ClassifiedChange } from "@intentius/chant-lexicon-sql/core/classifier";
+import { type Environment, type Project, type SqlDialect } from "../project.js";
+import type { Build } from "./build.js";
+/** A plan for one environment, in either dialect. */
+export interface Plan {
+    environment: string;
+    dialect: SqlDialect;
+    /** chant's own diff, as `chant sql plan --json` prints it. */
+    diff: SchemaDiff | PgSchemaDiff;
+    /**
+     * The changes the plan refuses to make in place, each of which needs its
+     * own Op: a ClickHouse rebuild (`rebuilds`, run as `ClickHouseRebuildOp`)
+     * or a Postgres expand-and-contract change (`refused`, run as
+     * `PostgresMigrationOp`).
+     */
+    refused: ClassifiedChange[];
+}
+/** Exit code: the plan has a change that needs a rebuild (or expand-and-contract) Op. */
+export declare const PLAN_NEEDS_OP = 2;
+/** `2` when any change needs its own Op, `0` otherwise. */
+export declare function planExitCode(plan: Plan): number;
+/**
+ * The changes to objects the build declares. A plan also lists live objects
+ * the project does not declare, as drops; an ApplyOp never touches those
+ * (it only prunes objects carrying chant's marker), so they are not work
+ * left for apply. chant labels a declared object `<export> (<name>)` and an
+ * undeclared one by its name alone.
+ */
+export declare function declaredChanges(plan: Plan, build: Build): ClassifiedChange[];
+/** The plan as `yodel plan --json` prints it: chant's diff, with the environment and dialect it is of. */
+export declare function planJson(plan: Plan): Record<string, unknown>;
+/** Plans `build` against the server `sql.profiles.<env>` binds. */
+export declare function planEnvironment(project: Project, env: Environment, build: Build, options?: {
+    env?: NodeJS.ProcessEnv;
+}): Promise<Plan>;
+/** The plan as text, chant's own report for the dialect. */
+export declare function renderPlan(plan: Plan, title: string): Promise<string>;

package/dist/chant/plan.js

@@ -0,0 +1,61 @@
+/**
+ * The plan: the classified change from an environment's live database to the
+ * declared schema. This is `chant sql plan <env> <build>`, called as the
+ * library functions that command runs (`planAgainstServer` for ClickHouse,
+ * `planPgAgainstServer` for Postgres) rather than through the CLI.
+ */
+import { YodelError } from "../project.js";
+/** Exit code: the plan has a change that needs a rebuild (or expand-and-contract) Op. */
+export const PLAN_NEEDS_OP = 2;
+/** `2` when any change needs its own Op, `0` otherwise. */
+export function planExitCode(plan) {
+    return plan.refused.length > 0 ? PLAN_NEEDS_OP : 0;
+}
+/**
+ * The changes to objects the build declares. A plan also lists live objects
+ * the project does not declare, as drops; an ApplyOp never touches those
+ * (it only prunes objects carrying chant's marker), so they are not work
+ * left for apply. chant labels a declared object `<export> (<name>)` and an
+ * undeclared one by its name alone.
+ */
+export function declaredChanges(plan, build) {
+    const exports = new Set(build.output.objects.map((o) => o.export));
+    return plan.diff.changes.filter((c) => {
+        const at = c.object.indexOf(" (");
+        return at > 0 && c.object.endsWith(")") && exports.has(c.object.slice(0, at));
+    });
+}
+/** The plan as `yodel plan --json` prints it: chant's diff, with the environment and dialect it is of. */
+export function planJson(plan) {
+    return { environment: plan.environment, dialect: plan.dialect, ...plan.diff };
+}
+function bindError(e) {
+    return new YodelError(e instanceof Error ? e.message : String(e));
+}
+/** Plans `build` against the server `sql.profiles.<env>` binds. */
+export async function planEnvironment(project, env, build, options = {}) {
+    const bind = { config: project.config, cwd: project.dir, ...(options.env ? { env: options.env } : {}) };
+    try {
+        if (project.dialect === "postgres") {
+            const { planPgAgainstServer } = await import("@intentius/chant-lexicon-sql/postgres/plan/commands");
+            const diff = await planPgAgainstServer(env.name, build.path, bind);
+            return { environment: env.name, dialect: "postgres", diff, refused: diff.refused };
+        }
+        const { planAgainstServer } = await import("@intentius/chant-lexicon-sql/clickhouse/plan/commands");
+        const diff = await planAgainstServer(env.name, build.path, bind);
+        return { environment: env.name, dialect: "clickhouse", diff, refused: diff.rebuilds };
+    }
+    catch (e) {
+        throw bindError(e);
+    }
+}
+/** The plan as text, chant's own report for the dialect. */
+export async function renderPlan(plan, title) {
+    if (plan.dialect === "postgres") {
+        const { renderPgDiff } = await import("@intentius/chant-lexicon-sql/postgres/plan/report");
+        return renderPgDiff(plan.diff, { title });
+    }
+    const { renderDiff } = await import("@intentius/chant-lexicon-sql/clickhouse/plan/report");
+    return renderDiff(plan.diff, { title });
+}
+//# sourceMappingURL=plan.js.map

package/dist/chant/plan.js.map

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

package/dist/chant/process.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Running the `chant` CLI that yodel depends on, for the commands that have
+ * no library surface (`build`, `run`, `lifecycle diff`).
+ *
+ * Published chant ships TypeScript source, and its own bin runs
+ * `node --import <tsx loader> src/cli/main.ts`. yodel does the same with its
+ * own copy of tsx, so the chant it runs is the one in its own dependencies,
+ * not whatever `chant` is first on PATH. That chant's `bin/` goes first on the
+ * child's PATH, because chant's Op activities shell out to `chant` themselves
+ * (`lifecycleDiff` runs `chant lifecycle diff`).
+ */
+export interface ChantInstall {
+    /** The `@intentius/chant` package directory. */
+    root: string;
+    /** Its CLI entry, `src/cli/main.ts`. */
+    main: string;
+    /** Its `bin/`, which holds the `chant` script. */
+    bin: string;
+    /** The tsx loader to run it under, as a file URL. */
+    loader: string;
+}
+/** Where yodel's chant and tsx are installed. */
+export declare function chantInstall(): ChantInstall;
+export interface ChantResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface RunChantOptions {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    /** Called with each chunk as it arrives, for output a person watches (an Op run). */
+    onStdout?: (text: string) => void;
+    onStderr?: (text: string) => void;
+}
+/** The environment a chant child runs with: the caller's, with chant's bin first on PATH. */
+export declare function chantEnv(base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** Runs `chant <args>` in `cwd` and resolves with its exit code and output. Never rejects on a non-zero exit. */
+export declare function runChant(args: readonly string[], options: RunChantOptions): Promise<ChantResult>;
+/** The last line of `stdout` that parses as a JSON object: chant prints its `--json` document as one line, after any log lines. */
+export declare function lastJsonLine(stdout: string): unknown;

package/dist/chant/process.js

@@ -0,0 +1,87 @@
+/**
+ * Running the `chant` CLI that yodel depends on, for the commands that have
+ * no library surface (`build`, `run`, `lifecycle diff`).
+ *
+ * Published chant ships TypeScript source, and its own bin runs
+ * `node --import <tsx loader> src/cli/main.ts`. yodel does the same with its
+ * own copy of tsx, so the chant it runs is the one in its own dependencies,
+ * not whatever `chant` is first on PATH. That chant's `bin/` goes first on the
+ * child's PATH, because chant's Op activities shell out to `chant` themselves
+ * (`lifecycleDiff` runs `chant lifecycle diff`).
+ */
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, delimiter, join } from "node:path";
+import { pathToFileURL } from "node:url";
+let install;
+/** Where yodel's chant and tsx are installed. */
+export function chantInstall() {
+    if (install)
+        return install;
+    const require = createRequire(import.meta.url);
+    // "." resolves to <root>/src/index.ts; package.json is not an export.
+    const root = dirname(dirname(require.resolve("@intentius/chant")));
+    install = {
+        root,
+        main: join(root, "src", "cli", "main.ts"),
+        bin: join(root, "bin"),
+        loader: pathToFileURL(require.resolve("tsx")).href,
+    };
+    return install;
+}
+/** The environment a chant child runs with: the caller's, with chant's bin first on PATH. */
+export function chantEnv(base = process.env) {
+    const { bin } = chantInstall();
+    return { ...base, PATH: [bin, base.PATH ?? ""].filter(Boolean).join(delimiter), FORCE_COLOR: "0", NO_COLOR: "1" };
+}
+/** Runs `chant <args>` in `cwd` and resolves with its exit code and output. Never rejects on a non-zero exit. */
+export function runChant(args, options) {
+    const { main, loader } = chantInstall();
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn(process.execPath, ["--import", loader, main, ...args], {
+            cwd: options.cwd,
+            env: chantEnv(options.env),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+            options.onStdout?.(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+            options.onStderr?.(chunk);
+        });
+        child.on("error", reject);
+        child.on("close", (code, signal) => {
+            resolvePromise({ code: code ?? (signal ? 128 : 1), stdout, stderr });
+        });
+    });
+}
+/** The last line of `stdout` that parses as a JSON object: chant prints its `--json` document as one line, after any log lines. */
+export function lastJsonLine(stdout) {
+    const lines = stdout.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("{"));
+    for (const line of lines.reverse()) {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            // A log line that happens to start with "{"; keep looking.
+        }
+    }
+    // A pretty-printed document spans lines; try the whole of stdout from its first "{".
+    const at = stdout.indexOf("{");
+    if (at >= 0) {
+        try {
+            return JSON.parse(stdout.slice(at));
+        }
+        catch {
+            // Not JSON.
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=process.js.map

package/dist/chant/process.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import type { Command, Io } from "./command.js";
+export declare function help(list?: readonly Command[]): string;
+/** Parses argv (without the node and script paths) and runs a verb; resolves to the exit code. */
+export declare function main(argv: string[], io: Io, list?: readonly Command[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,59 @@
+import { parseArgs } from "node:util";
+import { commands } from "./commands/index.js";
+import { version } from "./version.js";
+export function help(list = commands) {
+    const width = Math.max(...list.map((c) => c.name.length));
+    const lines = list.map((c) => {
+        const mark = c.implemented ? "" : " (not implemented yet)";
+        return `  ${c.name.padEnd(width)}  ${c.summary}${mark}`;
+    });
+    return [
+        "Usage: yodel <command> [options]",
+        "",
+        "Schema management and migrations for ClickHouse and Postgres.",
+        "",
+        "Commands:",
+        ...lines,
+        "",
+        "Options:",
+        "  -h, --help     show this help",
+        "  -v, --version  print the version",
+        "",
+    ].join("\n");
+}
+/** Parses argv (without the node and script paths) and runs a verb; resolves to the exit code. */
+export async function main(argv, io, list = commands) {
+    const verbAt = argv.findIndex((a) => !a.startsWith("-"));
+    const globals = verbAt === -1 ? argv : argv.slice(0, verbAt);
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args: globals,
+            options: {
+                help: { type: "boolean", short: "h" },
+                version: { type: "boolean", short: "v" },
+            },
+            strict: true,
+        }));
+    }
+    catch (e) {
+        io.err(`yodel: ${e instanceof Error ? e.message : String(e)}\n\n${help(list)}`);
+        return 1;
+    }
+    if (values.version) {
+        io.out(`${version()}\n`);
+        return 0;
+    }
+    if (values.help || verbAt === -1) {
+        (values.help ? io.out : io.err)(help(list));
+        return values.help ? 0 : 1;
+    }
+    const name = argv[verbAt];
+    const command = list.find((c) => c.name === name);
+    if (!command) {
+        io.err(`yodel: unknown command "${String(name)}"\n\n${help(list)}`);
+        return 1;
+    }
+    return command.run(argv.slice(verbAt + 1), io);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/command.d.ts

@@ -0,0 +1,17 @@
+/** Where a command writes. Tests pass their own; the bin passes process.stdout and stderr. */
+export interface Io {
+    out: (text: string) => void;
+    err: (text: string) => void;
+}
+/** One `yodel` verb. Each lives in its own module under src/commands/. */
+export interface Command {
+    name: string;
+    /** One line for `yodel --help`. */
+    summary: string;
+    /** False until a later issue builds the verb; `yodel --help` marks it. */
+    implemented: boolean;
+    /** Runs the verb with the arguments after its name; resolves to the exit code. */
+    run: (args: string[], io: Io) => Promise<number>;
+}
+/** A verb that is listed but not built yet. Later issues replace these one by one. */
+export declare function notImplemented(name: string, summary: string): Command;

package/dist/command.js

@@ -0,0 +1,13 @@
+/** A verb that is listed but not built yet. Later issues replace these one by one. */
+export function notImplemented(name, summary) {
+    return {
+        name,
+        summary,
+        implemented: false,
+        run: (_args, io) => {
+            io.err(`yodel ${name}: not implemented yet\n`);
+            return Promise.resolve(2);
+        },
+    };
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAiBA,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,OAAO;QACL,IAAI;QACJ,OAAO;QACP,WAAW,EAAE,KAAK;QAClB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YACjB,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,yBAAyB,CAAC,CAAC;YAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/apply.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "../command.js";
+/** `yodel apply <env>`; the exit codes are in `help`. */
+export declare const apply: Command;