@intentius/sql-yodeler 0.1.0 → 0.3.0

package/dist/schema-docs/render.js

@@ -0,0 +1,359 @@
+/**
+ * `yodel docs` (#62): the declared schema as a static reference, from the
+ * sql lexicon's build output (or a migration's recorded schema), with no
+ * server read and nothing to run in the browser.
+ *
+ * - {@link schemaHtml}: one self-contained HTML page (inline CSS, no
+ *   scripts): every object with its columns, keys, relations, ClickHouse
+ *   engine and sort key, comments, DDL, and the migrations that changed it.
+ * - {@link erdMermaid}: a Mermaid `erDiagram` of the tables and views and
+ *   how they relate: Postgres foreign keys, what a view or materialized view
+ *   reads, the table a materialized view writes to, and the local table a
+ *   ClickHouse `Distributed` table serves.
+ *
+ * Both are deterministic: the same input gives the same bytes, so the
+ * output can be committed and compared.
+ */
+const RELATIONS = new Set(["Table", "View", "MaterializedView", "Dictionary"]);
+/** "ClickHouse::Table" to "Table". */
+const kindOf = (o) => (o.type ?? "").split("::").pop() ?? "";
+const str = (v) => (typeof v === "string" ? v : undefined);
+const strs = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === "string") : []);
+const sqlName = (o) => str(o.sqlName) ?? str(o.name) ?? o.export;
+const columnsOf = (o) => (Array.isArray(o.columns) ? o.columns : []);
+const foreignKeysOf = (o) => (Array.isArray(o.foreignKeys) ? o.foreignKeys : []);
+/** The objects in apply order (then any the order leaves out, by export name). */
+function ordered(output) {
+    const objects = output.objects;
+    const byExport = new Map(objects.map((o) => [o.export, o]));
+    const order = strs(output.applyOrder);
+    const seen = new Set();
+    const out = [];
+    for (const name of order) {
+        const o = byExport.get(name);
+        if (o && !seen.has(name)) {
+            out.push(o);
+            seen.add(name);
+        }
+    }
+    for (const o of [...objects].sort((a, b) => a.export.localeCompare(b.export)))
+        if (!seen.has(o.export))
+            out.push(o);
+    return out;
+}
+/** The tables, views, materialized views and dictionaries: what the ERD draws. */
+const relationsOf = (output) => ordered(output).filter((o) => RELATIONS.has(kindOf(o)));
+/** The identifiers in a key expression such as `(kind, id)` or `tuple()`. */
+const identifiers = (expr) => new Set((expr ?? "").match(/[A-Za-z_][A-Za-z0-9_]*/g) ?? []);
+/** Every relation between the objects the ERD draws, in a stable order. */
+export function relations(output) {
+    const objects = relationsOf(output);
+    const byExport = new Map(objects.map((o) => [o.export, o]));
+    const bySqlName = new Map(objects.map((o) => [sqlName(o), o]));
+    const out = [];
+    for (const o of objects) {
+        for (const fk of foreignKeysOf(o)) {
+            const target = (fk.references !== undefined ? byExport.get(fk.references) : undefined) ?? (fk.refTable !== undefined ? bySqlName.get(fk.refTable) : undefined);
+            if (!target)
+                continue;
+            const columns = columnsOf(o);
+            const optional = fk.columns.some((c) => columns.find((col) => col.name === c)?.notNull !== true);
+            const cols = `${fk.columns.join(", ")} to ${(fk.refColumns ?? []).join(", ") || "its primary key"}`;
+            out.push({ from: o.export, to: target.export, kind: "foreign key", label: fk.name ? `${fk.name}: ${cols}` : cols, optional });
+        }
+        const to = str(o.to);
+        if (to !== undefined && byExport.has(to))
+            out.push({ from: o.export, to, kind: "writes to", label: "writes to" });
+        for (const r of strs(o.reads))
+            if (byExport.has(r))
+                out.push({ from: o.export, to: r, kind: "reads", label: "reads" });
+        const engine = o.engine;
+        if (engine?.name === "Distributed") {
+            const [, db, table] = (engine.args ?? []).map((a) => (typeof a === "string" ? a.replace(/^'|'$/g, "") : ""));
+            const target = db !== undefined && table !== undefined ? bySqlName.get(`${db}.${table}`) : undefined;
+            if (target)
+                out.push({ from: o.export, to: target.export, kind: "distributes", label: "distributes to" });
+        }
+    }
+    return out;
+}
+/** A Mermaid entity id: the SQL name with every other character as `_`. */
+function entityIds(objects) {
+    const ids = new Map();
+    const used = new Set();
+    for (const o of objects) {
+        const base = sqlName(o).replace(/[^A-Za-z0-9_]/g, "_");
+        let id = base;
+        for (let n = 2; used.has(id); n++)
+            id = `${base}_${String(n)}`;
+        used.add(id);
+        ids.set(o.export, id);
+    }
+    return ids;
+}
+/** Mermaid takes a type as one word: the type with spaces and commas as `_`. */
+const mermaidType = (type) => (type ?? "unknown").replace(/,\s*/g, "_").replace(/[^A-Za-z0-9_()[\]-]/g, "_");
+const mermaidText = (text) => text.replace(/"/g, "'").replace(/\s+/g, " ").trim();
+/** The columns the object's keys name: PK, FK, UK, for the ERD's key column. */
+function columnKeys(o) {
+    const keys = new Map();
+    const add = (column, key) => {
+        const list = keys.get(column) ?? [];
+        if (!list.includes(key))
+            list.push(key);
+        keys.set(column, list);
+    };
+    const pk = o.primaryKey;
+    if (pk && typeof pk === "object" && "columns" in pk)
+        for (const c of strs((pk).columns))
+            add(c, "PK");
+    // ClickHouse: the primary key, or the sort key when it has none, is what the sparse index is built on.
+    if (typeof pk === "string" || (pk === undefined && typeof o.orderBy === "string")) {
+        const names = new Set(columnsOf(o).map((c) => c.name));
+        for (const id of identifiers(str(pk) ?? str(o.orderBy)))
+            if (names.has(id))
+                add(id, "PK");
+    }
+    for (const fk of foreignKeysOf(o))
+        for (const c of fk.columns)
+            add(c, "FK");
+    if (Array.isArray(o.uniques))
+        for (const u of o.uniques)
+            for (const c of strs(u.columns))
+                add(c, "UK");
+    return keys;
+}
+/** The Mermaid `erDiagram`: one entity per table or view, one line per relation. */
+export function erdMermaid(output) {
+    const objects = relationsOf(output);
+    const ids = entityIds(objects);
+    const lines = ["erDiagram"];
+    for (const o of objects) {
+        const keys = columnKeys(o);
+        const entity = `  ${ids.get(o.export) ?? o.export}["${sqlName(o)}"]`;
+        const columns = columnsOf(o);
+        // A view's columns come from its query and have no declared type: the entity alone.
+        if (columns.length === 0) {
+            lines.push(entity);
+            continue;
+        }
+        lines.push(`${entity} {`);
+        for (const c of columns) {
+            const k = keys.get(c.name);
+            const comment = c.comment ? ` "${mermaidText(c.comment)}"` : "";
+            lines.push(`    ${mermaidType(c.type)} ${c.name}${k ? ` ${k.join(", ")}` : ""}${comment}`);
+        }
+        lines.push("  }");
+    }
+    for (const r of relations(output)) {
+        const from = ids.get(r.from) ?? r.from;
+        const to = ids.get(r.to) ?? r.to;
+        // A foreign key: many rows to one (or none, when its columns may be null). The rest are not keys, so dotted.
+        const shape = r.kind === "foreign key" ? (r.optional ? "}o--o|" : "}o--||") : "}o..||";
+        lines.push(`  ${from} ${shape} ${to} : "${mermaidText(r.label)}"`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** The ERD as Markdown, which GitHub, GitLab and Forgejo render. */
+export function erdMarkdown(input) {
+    return `# ${input.title}: entity relationships\n\nFrom ${input.source}. Written by \`yodel docs\`; index.html next to this file has every object's columns, keys, engine and history.\n\n\`\`\`mermaid\n${erdMermaid(input.output)}\`\`\`\n`;
+}
+const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+const code = (s) => `<code>${esc(s)}</code>`;
+const anchor = (o) => `o-${o.export.replace(/[^A-Za-z0-9_-]/g, "-")}`;
+/** A column's default, generated expression or codec, as one line. */
+function columnDetail(c) {
+    const parts = [];
+    const d = c.default;
+    if (typeof d === "string")
+        parts.push(`DEFAULT ${d}`);
+    else if (d && typeof d === "object") {
+        const { kind, expr } = d;
+        parts.push(`${kind ?? "DEFAULT"} ${expr ?? ""}`.trim());
+    }
+    const g = c.generated;
+    if (g && typeof g === "object") {
+        const { kind, always, expr } = g;
+        parts.push(kind === "identity" ? `GENERATED ${always ? "ALWAYS" : "BY DEFAULT"} AS IDENTITY` : `GENERATED ALWAYS AS (${expr ?? ""})`);
+    }
+    if (c.codec)
+        parts.push(`CODEC(${c.codec})`);
+    if (c.ttl)
+        parts.push(`TTL ${c.ttl}`);
+    return parts.join(", ");
+}
+/** A view's columns: each output of its query and the expression it comes from. */
+function lineageTable(o) {
+    const lineage = Array.isArray(o.lineage) ? o.lineage : [];
+    if (lineage.length === 0)
+        return "";
+    const rows = lineage.map((l) => `<tr><td>${code(l.output ?? "")}</td><td>${code(l.expr ?? "")}</td></tr>`);
+    return `<table><thead><tr><th>Column</th><th>Expression</th></tr></thead><tbody>\n${rows.join("\n")}\n</tbody></table>`;
+}
+function columnsTable(o) {
+    const columns = columnsOf(o);
+    if (columns.length === 0)
+        return lineageTable(o);
+    const keys = columnKeys(o);
+    const postgres = o.type?.startsWith("Postgres::") === true;
+    const rows = columns.map((c) => {
+        const nullable = postgres ? (c.notNull === true ? "no" : "yes") : /^Nullable\(/.test(c.type ?? "") ? "yes" : "no";
+        return `<tr><td>${code(c.name)}</td><td>${code(c.type ?? "")}</td><td>${nullable}</td><td>${esc((keys.get(c.name) ?? []).join(", "))}</td><td>${esc(columnDetail(c))}</td><td>${esc(c.comment ?? "")}</td></tr>`;
+    });
+    return `<table><thead><tr><th>Column</th><th>Type</th><th>Null</th><th>Key</th><th>Default</th><th>Comment</th></tr></thead><tbody>\n${rows.join("\n")}\n</tbody></table>`;
+}
+/** The facts under an object's name: engine, sort key and the rest, as a definition list. */
+function facts(o, byExport) {
+    const items = [];
+    const engine = o.engine;
+    if (engine?.name)
+        items.push(["Engine", code(`${engine.name}${engine.args?.length ? `(${engine.args.map(String).join(", ")})` : ""}`)]);
+    for (const [key, label] of [
+        ["orderBy", "ORDER BY"],
+        ["primaryKey", "PRIMARY KEY"],
+        ["partitionBy", "PARTITION BY"],
+        ["sampleBy", "SAMPLE BY"],
+        ["ttl", "TTL"],
+    ]) {
+        const v = str(o[key]);
+        if (v !== undefined)
+            items.push([label, code(v)]);
+    }
+    const pk = o.primaryKey;
+    if (pk && typeof pk === "object" && "columns" in pk) {
+        const { name, columns } = pk;
+        items.push(["Primary key", `${code(`(${strs(columns).join(", ")})`)}${name ? ` ${esc(name)}` : ""}`]);
+    }
+    if (Array.isArray(o.uniques))
+        for (const u of o.uniques)
+            items.push(["Unique", `${code(`(${strs(u.columns).join(", ")})`)}${u.name ? ` ${esc(u.name)}` : ""}`]);
+    if (Array.isArray(o.checks))
+        for (const c of o.checks)
+            items.push(["Check", `${code(c.expr ?? "")}${c.name ? ` ${esc(c.name)}` : ""}`]);
+    for (const fk of foreignKeysOf(o)) {
+        const target = (fk.references !== undefined ? byExport.get(fk.references) : undefined);
+        const ref = target ? `<a href="#${anchor(target)}">${esc(sqlName(target))}</a>` : esc(fk.refTable ?? fk.references ?? "");
+        const actions = [fk.onDelete ? `ON DELETE ${fk.onDelete}` : "", fk.onUpdate ? `ON UPDATE ${fk.onUpdate}` : ""].filter(Boolean).join(" ");
+        items.push(["Foreign key", `${code(`(${fk.columns.join(", ")})`)} references ${ref} ${code(`(${(fk.refColumns ?? []).join(", ")})`)}${actions ? ` ${esc(actions)}` : ""}${fk.name ? ` ${esc(fk.name)}` : ""}`]);
+    }
+    if (Array.isArray(o.indexes))
+        for (const i of o.indexes)
+            items.push(["Skip index", code(`${i.name ?? ""} ${i.expr ?? ""} TYPE ${i.type ?? ""}`.trim())]);
+    if (Array.isArray(o.projections))
+        for (const p of o.projections)
+            items.push(["Projection", code(p.name ?? "")]);
+    const table = str(o.table);
+    if (kindOf(o) === "Index" && table !== undefined) {
+        const t = byExport.get(table);
+        const elements = Array.isArray(o.elements) ? o.elements.map((e) => e.expr ?? "") : [];
+        items.push(["On", `${t ? `<a href="#${anchor(t)}">${esc(sqlName(t))}</a>` : esc(str(o.tableName) ?? table)} ${code(`(${elements.join(", ")})`)}${str(o.method) ? ` using ${esc(str(o.method) ?? "")}` : ""}`]);
+    }
+    const select = str(o.select) ?? str(o.query);
+    if (select !== undefined)
+        items.push(["Query", `<pre>${esc(select)}</pre>`]);
+    if (items.length === 0)
+        return "";
+    return `<dl>\n${items.map(([k, v]) => `<dt>${esc(k)}</dt><dd>${v}</dd>`).join("\n")}\n</dl>`;
+}
+function relationList(o, all, byExport) {
+    const link = (exportName) => {
+        const t = byExport.get(exportName);
+        return t ? `<a href="#${anchor(t)}">${esc(sqlName(t))}</a>` : esc(exportName);
+    };
+    const out = all.filter((r) => r.from === o.export).map((r) => `<li>${esc(r.kind === "foreign key" ? `foreign key ${r.label}:` : r.label)} ${link(r.to)}</li>`);
+    const inbound = all.filter((r) => r.to === o.export).map((r) => {
+        const verb = r.kind === "foreign key" ? `referenced by (${r.label})` : r.kind === "reads" ? "read by" : r.kind === "writes to" ? "written by" : "distributed by";
+        return `<li>${esc(verb)} ${link(r.from)}</li>`;
+    });
+    const items = [...out, ...inbound];
+    return items.length ? `<h4>Relations</h4>\n<ul>\n${items.join("\n")}\n</ul>` : "";
+}
+/** What one migration step did to an object, as one line. */
+function stepLine(step) {
+    const s = step;
+    if (s.kind === "statement")
+        return `${str(s.rule) ?? ""} ${str(s.class) ?? ""}: ${str(s.sql) ?? ""}`.trim();
+    if (s.kind === "op") {
+        const changes = Array.isArray(s.changes) ? s.changes.map((c) => `${c.rule ?? ""} ${c.field ?? ""}`.trim()).join("; ") : "";
+        return `${str(s.op) ?? "Op"} step${changes ? ` (${changes})` : ""}`;
+    }
+    return `${typeof s.kind === "string" ? s.kind : "manual"} step${str(s.detail) ? `: ${str(s.detail) ?? ""}` : ""}`;
+}
+function history(o, migrations) {
+    if (!migrations)
+        return "";
+    const rows = [];
+    for (const m of migrations) {
+        for (const step of m.steps) {
+            const s = step;
+            if (s.name === sqlName(o) || (s.name === undefined && s.object === o.export))
+                rows.push(`<tr><td>${code(m.id)}</td><td>${code(stepLine(step))}</td></tr>`);
+        }
+    }
+    if (rows.length === 0)
+        return "";
+    return `<h4>History</h4>\n<table><thead><tr><th>Migration</th><th>Step</th></tr></thead><tbody>\n${rows.join("\n")}\n</tbody></table>`;
+}
+const STYLE = `:root{color-scheme:light dark;--fg:#1d1f23;--muted:#5d6470;--bg:#fff;--line:#d8dce3;--code:#f3f5f8;--link:#1f5fbf}
+@media (prefers-color-scheme:dark){:root{--fg:#e6e8eb;--muted:#a3a9b3;--bg:#16181c;--line:#353a42;--code:#22262c;--link:#7fb0ff}}
+body{margin:0;background:var(--bg);color:var(--fg);font:15px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif}
+main{max-width:1100px;margin:0 auto;padding:24px 16px 64px}
+h1{font-size:1.6rem;margin:0 0 4px}h2{margin-top:2.2rem;border-bottom:1px solid var(--line);padding-bottom:4px}
+h3{margin:2rem 0 .3rem}h4{margin:1rem 0 .3rem;font-size:.95rem}
+.muted,.kind{color:var(--muted)}.kind{font-weight:400;font-size:.85rem;margin-left:.5rem}
+a{color:var(--link)}code,pre{font:13px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace;background:var(--code);border-radius:4px}
+code{padding:1px 4px}pre{padding:8px 10px;overflow-x:auto;white-space:pre}
+table{border-collapse:collapse;width:100%;margin:.4rem 0;display:block;overflow-x:auto}
+th,td{border:1px solid var(--line);padding:4px 8px;text-align:left;vertical-align:top}th{font-weight:600}
+dl{display:grid;grid-template-columns:max-content 1fr;gap:4px 12px;margin:.5rem 0}dt{color:var(--muted)}dd{margin:0}dd pre{margin:0}
+ul.toc{columns:2 260px;padding-left:1.2rem}details{margin:.5rem 0}summary{cursor:pointer;color:var(--muted)}`;
+/** The self-contained HTML reference. */
+export function schemaHtml(input) {
+    const objects = ordered(input.output);
+    const byExport = new Map(objects.map((o) => [o.export, o]));
+    const all = relations(input.output);
+    const sections = objects.map((o) => {
+        const comment = str(o.comment);
+        return [
+            `<section id="${anchor(o)}">`,
+            `<h3>${esc(sqlName(o))}<span class="kind">${esc(o.type ?? "")}, export ${esc(o.export)}</span></h3>`,
+            comment ? `<p>${esc(comment)}</p>` : "",
+            facts(o, byExport),
+            columnsTable(o),
+            relationList(o, all, byExport),
+            history(o, input.migrations),
+            `<details><summary>DDL</summary><pre>${esc(o.ddl)}</pre></details>`,
+            "</section>",
+        ].filter(Boolean).join("\n");
+    });
+    const toc = objects.map((o) => `<li><a href="#${anchor(o)}">${esc(sqlName(o))}</a> <span class="muted">${esc(kindOf(o))}</span></li>`);
+    const dialect = input.output.dialect === "clickhouse" ? "ClickHouse" : "Postgres";
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${esc(input.title)}: schema</title>
+<style>
+${STYLE}
+</style>
+</head>
+<body>
+<main>
+<h1>${esc(input.title)}</h1>
+<p class="muted">${esc(dialect)}, ${String(objects.length)} objects, from ${esc(input.source)}. Written by <code>yodel docs</code>.</p>
+<h2>Objects</h2>
+<ul class="toc">
+${toc.join("\n")}
+</ul>
+<h2>Entity relationships</h2>
+<p class="muted">Mermaid source; erd.md next to this file renders it on GitHub, GitLab and Forgejo.</p>
+<pre>${esc(erdMermaid(input.output))}</pre>
+<h2>Reference</h2>
+${sections.join("\n")}
+</main>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=render.js.map

package/dist/schema-docs/render.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The JSON Schemas of `yodel <command> --json` and of `yodel mcp`'s tool
+ * results. They are written beside the code, in `schemas/` at the package
+ * root, and ship in the package; the docs site serves them at their `$id`.
+ * test/schemas.test.ts validates each command's output against its schema.
+ *
+ * Within a version a schema only gains fields, and a reader ignores fields it
+ * does not know. Removing a field or changing what one means is a new version:
+ * a new `v<N>/` in every `$id`, and {@link SCHEMA_VERSION} moves with it.
+ */
+export declare const SCHEMA_VERSION = 1;
+/** Where the schemas are published; each `$id` is this plus `<name>.schema.json`. */
+export declare const SCHEMA_BASE: string;
+/** `schemas/` in the package: src/ and dist/ are both one level below it. */
+export declare const schemasDir: string;
+/** The schema of each command's `--json` output, by the command line that prints it. */
+export declare const COMMAND_SCHEMAS: {
+    readonly init: "init";
+    readonly plan: "plan";
+    readonly apply: "apply";
+    readonly new: "new";
+    readonly checkpoint: "checkpoint";
+    readonly lint: "lint";
+    readonly "lint --rules": "lint-rules";
+    readonly status: "status";
+    readonly report: "report";
+    readonly drift: "drift";
+    readonly rebase: "rebase";
+    readonly repair: "repair";
+    readonly revert: "revert";
+};
+/** Every schema file: the commands', the definitions they share, the MCP tool results, and the webhook event (#61). */
+export declare const SCHEMA_NAMES: readonly ["common", ...("checkpoint" | "drift" | "apply" | "plan" | "status" | "lint" | "revert" | "report" | "init" | "new" | "lint-rules" | "rebase" | "repair")[], "mcp", "event"];
+export type SchemaName = (typeof SCHEMA_NAMES)[number];
+export declare const schemaId: (name: SchemaName) => string;
+/** A schema as the package ships it. */
+export declare function readSchema(name: SchemaName): Record<string, unknown>;

package/dist/schemas.js

@@ -0,0 +1,41 @@
+/**
+ * The JSON Schemas of `yodel <command> --json` and of `yodel mcp`'s tool
+ * results. They are written beside the code, in `schemas/` at the package
+ * root, and ship in the package; the docs site serves them at their `$id`.
+ * test/schemas.test.ts validates each command's output against its schema.
+ *
+ * Within a version a schema only gains fields, and a reader ignores fields it
+ * does not know. Removing a field or changing what one means is a new version:
+ * a new `v<N>/` in every `$id`, and {@link SCHEMA_VERSION} moves with it.
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+export const SCHEMA_VERSION = 1;
+/** Where the schemas are published; each `$id` is this plus `<name>.schema.json`. */
+export const SCHEMA_BASE = `https://intentius.io/sql-yodeler/schemas/v${String(SCHEMA_VERSION)}/`;
+/** `schemas/` in the package: src/ and dist/ are both one level below it. */
+export const schemasDir = fileURLToPath(new URL("../schemas/", import.meta.url));
+/** The schema of each command's `--json` output, by the command line that prints it. */
+export const COMMAND_SCHEMAS = {
+    init: "init",
+    plan: "plan",
+    apply: "apply",
+    new: "new",
+    checkpoint: "checkpoint",
+    lint: "lint",
+    "lint --rules": "lint-rules",
+    status: "status",
+    report: "report",
+    drift: "drift",
+    rebase: "rebase",
+    repair: "repair",
+    revert: "revert",
+};
+/** Every schema file: the commands', the definitions they share, the MCP tool results, and the webhook event (#61). */
+export const SCHEMA_NAMES = ["common", ...Object.values(COMMAND_SCHEMAS), "mcp", "event"];
+export const schemaId = (name) => `${SCHEMA_BASE}${name}.schema.json`;
+/** A schema as the package ships it. */
+export function readSchema(name) {
+    return JSON.parse(readFileSync(`${schemasDir}${name}.schema.json`, "utf8"));
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,6CAA6C,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC;AAElG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEjF,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,YAAY;IAC5B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,uHAAuH;AACvH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC;AAInG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAgB,EAAU,EAAE,CAAC,GAAG,WAAW,GAAG,IAAI,cAAc,CAAC;AAE1F,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,GAAG,IAAI,cAAc,EAAE,MAAM,CAAC,CAA4B,CAAC;AACzG,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Which server a command reached, for the first line of its output (#11):
+ * `postgres 16.14 at 127.0.0.1:5432/postgres`. A wrong target (a native
+ * Postgres on localhost:5432 instead of the emulator) then shows in the
+ * header, by its address and its version.
+ *
+ * The address comes from the profile's URL, without credentials; the
+ * version is asked of the server. A server that does not answer the version
+ * query still gets its address.
+ */
+import type { Environment, Project, SqlDialect } from "./project.js";
+export interface ServerInfo {
+    dialect: SqlDialect;
+    /** `host:port/database` on Postgres, `host:port` on ClickHouse. */
+    address: string;
+    /** The server's own version string, first word: `16.14`, `25.3.2.39`. */
+    version?: string | undefined;
+}
+/** `postgres 16.14 at 127.0.0.1:5432/postgres`. */
+export declare function describeServer(s: ServerInfo): string;
+/** `host:port/database` (Postgres) or `host:port` (ClickHouse) from a server URL, with no credentials. */
+export declare function serverAddress(dialect: SqlDialect, url: string): string;
+/** The first word of a version string: `16.14 (Homebrew)` is `16.14`. */
+export declare const versionWord: (v: unknown) => string | undefined;
+/** Asks a Postgres connection its version. */
+export declare function postgresVersion(client: {
+    query<T>(sql: string): Promise<T[]>;
+}): Promise<string | undefined>;
+/** Asks a ClickHouse server its version. */
+export declare function clickhouseVersion(port: {
+    query<T>(sql: string): Promise<T[]>;
+}): Promise<string | undefined>;
+/** Runs `probe`, giving up quietly: the header is worth a line, not a failure. */
+export declare function softly<T>(probe: () => Promise<T>): Promise<T | undefined>;
+/**
+ * The server `sql.profiles.<env>` binds, with its version when it answers,
+ * for a command that does not hold its own connection (the declarative plan
+ * and apply, drift). Undefined when the profile binds no server.
+ */
+export declare function probeServer(project: Project, env: Environment, processEnv?: NodeJS.ProcessEnv): Promise<ServerInfo | undefined>;

package/dist/server.js

@@ -0,0 +1,87 @@
+/**
+ * Which server a command reached, for the first line of its output (#11):
+ * `postgres 16.14 at 127.0.0.1:5432/postgres`. A wrong target (a native
+ * Postgres on localhost:5432 instead of the emulator) then shows in the
+ * header, by its address and its version.
+ *
+ * The address comes from the profile's URL, without credentials; the
+ * version is asked of the server. A server that does not answer the version
+ * query still gets its address.
+ */
+/** `postgres 16.14 at 127.0.0.1:5432/postgres`. */
+export function describeServer(s) {
+    return `${s.dialect}${s.version ? ` ${s.version}` : ""} at ${s.address}`;
+}
+/** `host:port/database` (Postgres) or `host:port` (ClickHouse) from a server URL, with no credentials. */
+export function serverAddress(dialect, url) {
+    let u;
+    try {
+        u = new URL(url);
+    }
+    catch {
+        return url.replace(/\/\/[^@/]*@/, "//");
+    }
+    if (dialect === "postgres") {
+        const port = u.port || "5432";
+        const db = decodeURIComponent(u.pathname.replace(/^\/+/, "")) || "postgres";
+        return `${u.hostname}:${port}/${db}`;
+    }
+    const port = u.port || (u.protocol === "https:" ? "8443" : "8123");
+    return `${u.hostname}:${port}`;
+}
+/** The first word of a version string: `16.14 (Homebrew)` is `16.14`. */
+export const versionWord = (v) => (typeof v === "string" && v.trim() ? v.trim().split(/\s+/)[0] : undefined);
+/** Asks a Postgres connection its version. */
+export async function postgresVersion(client) {
+    const rows = await client.query("SHOW server_version");
+    return versionWord(rows[0]?.server_version);
+}
+/** Asks a ClickHouse server its version. */
+export async function clickhouseVersion(port) {
+    const rows = await port.query("SELECT version() AS version");
+    return versionWord(rows[0]?.version);
+}
+/** Runs `probe`, giving up quietly: the header is worth a line, not a failure. */
+export async function softly(probe) {
+    try {
+        return await probe();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The server `sql.profiles.<env>` binds, with its version when it answers,
+ * for a command that does not hold its own connection (the declarative plan
+ * and apply, drift). Undefined when the profile binds no server.
+ */
+export async function probeServer(project, env, processEnv = process.env) {
+    return softly(async () => {
+        if (project.dialect === "postgres") {
+            const { resolvePostgresTarget, isUnresolvedTarget } = await import("@intentius/chant-lexicon-sql/postgres/live/bind");
+            const target = resolvePostgresTarget({ environment: env.name, config: project.config, env: processEnv });
+            if (isUnresolvedTarget(target))
+                return undefined;
+            const info = { dialect: "postgres", address: serverAddress("postgres", target.endpoint.url) };
+            const { connectPostgres } = await import("@intentius/chant-lexicon-sql/postgres/live/client");
+            const client = await softly(() => connectPostgres(target.endpoint, { applicationName: "yodel" }));
+            if (client) {
+                try {
+                    info.version = await softly(() => postgresVersion(client));
+                }
+                finally {
+                    await client.end();
+                }
+            }
+            return info;
+        }
+        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))
+            return undefined;
+        const { httpPort } = await import("./history/client.js");
+        const port = await httpPort(target.endpoint);
+        return { dialect: "clickhouse", address: serverAddress("clickhouse", target.endpoint.url), version: await softly(() => clickhouseVersion(port)) };
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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