@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/push-set.d.ts

@@ -0,0 +1,126 @@
+/**
+ * The push set and its comparison (`cli-cloud`, "Push"): what a folder offers the cloud project, and
+ * how it differs from what the cloud holds.
+ *
+ * The set is the folder's project as `validate` reads it, widened to every file the cloud keeps:
+ * `project.json`, the `.meltemi` sources, themes, and the other text files (`isTextPath`) travel by
+ * content; images and fonts travel by hash (`png`, `jpg`, `jpeg`, `gif`, `webp`, `woff2`, `ttf`,
+ * `otf`, at most 10 MiB each). Never part of it: dotfiles and dot folders (`.git`), `node_modules`,
+ * what the manifest's `exclude` names, the catalog's output (`catalog.out`), links (never followed)
+ * and files of a kind the cloud does not keep (listed as `ignored`).
+ *
+ * A file the folder has but cannot send (its path breaks the cloud's path rule, it is not UTF-8,
+ * it cannot be read) is reported in `notSent`, never sent, and never leads to the deletion of the
+ * cloud's file of that name. The same goes for anything the folder deliberately leaves out.
+ *
+ * `compareWithCloud` compares every path against the cloud's files, fetched once: text by content,
+ * binaries by hash, cloud paths absent from the folder as deletions.
+ */
+import { type ProjectManifest } from "@meltemi/diagrams-project";
+import { CloudError } from "./cloud-errors.js";
+export type FileKind = "text" | "binary";
+/** What the cloud keeps a path as: text, an image or a font, or nothing (undefined). */
+export declare function kindOfPath(path: string): FileKind | undefined;
+/** An image or a font of the folder: its hash, its size and where it is. */
+export interface LocalBinary {
+    readonly hash: string;
+    readonly size: number;
+    /** The file, as a native absolute path, read again when it is uploaded. */
+    readonly file: string;
+}
+export type NotSentReason = "path" | "encoding" | "unreadable";
+/** A file or folder of the project that is not sent, and why. */
+export interface NotSent {
+    /** The project path; a folder ends with `/`. */
+    readonly path: string;
+    readonly reason: NotSentReason;
+    /** The system's reason, for `unreadable`. */
+    readonly detail?: string;
+}
+/** A file over a limit of the cloud: refused before anything is sent, with the service's code. */
+export interface OverLimit {
+    readonly path: string;
+    readonly code: "doc.too-large" | "quota.binary";
+}
+export interface PushSet {
+    /** The folder, as a native absolute path. */
+    readonly folder: string;
+    /** Path to text, `project.json` included. */
+    readonly texts: Map<string, string>;
+    /** Path to the image or font. */
+    readonly binaries: Map<string, LocalBinary>;
+    readonly notSent: NotSent[];
+    /** Files of a kind the cloud does not keep, and links. */
+    readonly ignored: string[];
+    readonly overLimit: OverLimit[];
+    /** Whether the folder holds more files than the cloud keeps (the walk stopped reading). */
+    readonly truncated: boolean;
+    /** Whether a path is one the folder leaves out on purpose or could not send. */
+    holds(path: string): boolean;
+}
+/**
+ * Whether a project path is left out of the push set by rule: a hidden name, `node_modules`, a
+ * path the manifest excludes or the catalog's output.
+ */
+export declare function leftOutRule(manifest: ProjectManifest | null): (path: string) => boolean;
+/**
+ * Reads the push set of a folder. `manifest` is its `project.json` as read (null when there is
+ * none): its `exclude` and `catalog.out` shape the set. Never follows a link, never reads past what
+ * a limit refuses, and never throws for a file: each is either part of the set or listed.
+ */
+export declare function readPushSet(folder: string, manifest: ProjectManifest | null): PushSet;
+/**
+ * The refusal the limits of the cloud call for, before anything is sent, with the service's own
+ * code: a file over its limit (`doc.too-large`, `quota.binary`, naming the path), more than 2000
+ * files (`quota.files`), texts over the 16 MiB a project's document holds (`doc.too-large`).
+ */
+export declare function limitError(set: PushSet): CloudError | undefined;
+/** One path whose cloud state differs from the folder's. */
+export interface Difference {
+    readonly path: string;
+    /** What the folder holds there; what the cloud holds for a deletion. */
+    readonly kind: FileKind;
+    /** `added`: not in the cloud yet. `changed`: both have it and it differs. `deleted`: only in the cloud. */
+    readonly change: "added" | "changed" | "deleted";
+}
+/** A cloud path the push leaves alone, and why. */
+export interface LeftAlone {
+    readonly path: string;
+    readonly why: "collision" | "kept-out";
+}
+export interface Comparison {
+    /** Every path that differs, by path. */
+    readonly differences: readonly Difference[];
+    readonly left: readonly LeftAlone[];
+}
+/** The cloud's files as `GET …/files` answers them. */
+export interface CloudState {
+    readonly files: Readonly<Record<string, string>>;
+    readonly binaries: Readonly<Record<string, string>>;
+    readonly collisions: readonly unknown[];
+}
+/**
+ * Compares every path of the push set with the cloud's: text files by content, binaries by hash and
+ * cloud paths the folder lacks as deletions. A cloud path left alone: the loser of a name collision
+ * (`<path>~<id>`, which the path rule refuses to send), and one the folder keeps out on purpose or
+ * could not send (excluded, unreadable, not UTF-8).
+ */
+export declare function compareWithCloud(set: PushSet, cloud: CloudState): Comparison;
+/** What a push sends, as `PUT …/files` takes it, and the binaries to put in the cloud first. */
+export interface PushPlan {
+    /** Path to text, or `null` to delete the path. Only what differs. */
+    readonly texts: Record<string, string | null>;
+    /** Path to the hash of an image or font, or `null` to delete the path. Only what differs. */
+    readonly binaries: Record<string, string | null>;
+    /** The images and fonts that differ and so need their bytes in the cloud before the push. */
+    readonly uploads: readonly {
+        readonly path: string;
+        readonly binary: LocalBinary;
+    }[];
+}
+/**
+ * What it takes to make the cloud equal to the set, given the comparison: the texts that differ, the
+ * hashes that differ, the deletions, and a deletion of the other kind of a path whose kind changed.
+ */
+export declare function planPush(set: PushSet, comparison: Comparison, cloud: CloudState): PushPlan;
+//# sourceMappingURL=push-set.d.ts.map

package/dist/push-set.d.ts.map

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

package/dist/push-set.js

@@ -0,0 +1,289 @@
+/**
+ * The push set and its comparison (`cli-cloud`, "Push"): what a folder offers the cloud project, and
+ * how it differs from what the cloud holds.
+ *
+ * The set is the folder's project as `validate` reads it, widened to every file the cloud keeps:
+ * `project.json`, the `.meltemi` sources, themes, and the other text files (`isTextPath`) travel by
+ * content; images and fonts travel by hash (`png`, `jpg`, `jpeg`, `gif`, `webp`, `woff2`, `ttf`,
+ * `otf`, at most 10 MiB each). Never part of it: dotfiles and dot folders (`.git`), `node_modules`,
+ * what the manifest's `exclude` names, the catalog's output (`catalog.out`), links (never followed)
+ * and files of a kind the cloud does not keep (listed as `ignored`).
+ *
+ * A file the folder has but cannot send (its path breaks the cloud's path rule, it is not UTF-8,
+ * it cannot be read) is reported in `notSent`, never sent, and never leads to the deletion of the
+ * cloud's file of that name. The same goes for anything the folder deliberately leaves out.
+ *
+ * `compareWithCloud` compares every path against the cloud's files, fetched once: text by content,
+ * binaries by hash, cloud paths absent from the folder as deletions.
+ */
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { ALWAYS_EXCLUDED, CLOUD_LIMITS, DEFAULT_CATALOG, isCleanPath, isTextPath, } from "@meltemi/diagrams-project";
+import { sha256Hex } from "./cloud-client.js";
+import { CloudError } from "./cloud-errors.js";
+import { collisionLosers } from "./cloud-paths.js";
+/** Extensions of the images and fonts the cloud keeps by hash (SVG is a text file in a cloud project). */
+const BINARY_EXTENSIONS = [
+    "png",
+    "jpg",
+    "jpeg",
+    "gif",
+    "webp",
+    "woff2",
+    "ttf",
+    "otf",
+];
+/** What the cloud keeps a path as: text, an image or a font, or nothing (undefined). */
+export function kindOfPath(path) {
+    if (isTextPath(path))
+        return "text";
+    const dot = path.lastIndexOf(".");
+    const extension = dot === -1 ? "" : path.slice(dot + 1).toLowerCase();
+    return BINARY_EXTENSIONS.includes(extension) ? "binary" : undefined;
+}
+/** A text of 2 Mi characters takes at most four bytes each: a file over this is too large unread. */
+const MAX_TEXT_BYTES = CLOUD_LIMITS.textCharacters * 4;
+const DECODER = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+/**
+ * Whether a project path is left out of the push set by rule: a hidden name, `node_modules`, a
+ * path the manifest excludes or the catalog's output.
+ */
+export function leftOutRule(manifest) {
+    const excluded = [...(manifest?.exclude ?? []), manifest?.catalog.out ?? DEFAULT_CATALOG.out];
+    return (path) => path
+        .split("/")
+        .some((name) => name.startsWith(".") || ALWAYS_EXCLUDED.includes(name)) ||
+        excluded.some((entry) => entry === "." || path === entry || path.startsWith(`${entry}/`));
+}
+const byName = (a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+/**
+ * Reads the push set of a folder. `manifest` is its `project.json` as read (null when there is
+ * none): its `exclude` and `catalog.out` shape the set. Never follows a link, never reads past what
+ * a limit refuses, and never throws for a file: each is either part of the set or listed.
+ */
+export function readPushSet(folder, manifest) {
+    const leftOut = leftOutRule(manifest);
+    const texts = new Map();
+    const binaries = new Map();
+    const notSent = [];
+    const ignored = [];
+    const overLimit = [];
+    let kept = 0;
+    let truncated = false;
+    const readFile = (path, kind, file) => {
+        let size;
+        try {
+            size = statSync(file).size;
+        }
+        catch (error) {
+            notSent.push({ path, reason: "unreadable", detail: error.message });
+            return;
+        }
+        if (kind === "binary" && size > CLOUD_LIMITS.binaryBytes) {
+            overLimit.push({ path, code: "quota.binary" });
+            return;
+        }
+        if (kind === "text" && size > MAX_TEXT_BYTES) {
+            overLimit.push({ path, code: "doc.too-large" });
+            return;
+        }
+        let raw;
+        try {
+            raw = readFileSync(file);
+        }
+        catch (error) {
+            notSent.push({ path, reason: "unreadable", detail: error.message });
+            return;
+        }
+        if (kind === "binary") {
+            binaries.set(path, { hash: sha256Hex(raw), size: raw.byteLength, file });
+            return;
+        }
+        let text;
+        try {
+            text = DECODER.decode(raw);
+        }
+        catch {
+            notSent.push({ path, reason: "encoding" });
+            return;
+        }
+        if (text.length > CLOUD_LIMITS.textCharacters)
+            overLimit.push({ path, code: "doc.too-large" });
+        else
+            texts.set(path, text);
+    };
+    const visit = (absolute, prefix) => {
+        let entries;
+        try {
+            entries = readdirSync(absolute, { withFileTypes: true });
+        }
+        catch (error) {
+            notSent.push({ path: `${prefix}/`, reason: "unreadable", detail: error.message });
+            return;
+        }
+        for (const entry of entries.sort(byName)) {
+            if (truncated)
+                return;
+            const name = entry.name;
+            if (name.startsWith("."))
+                continue;
+            const path = prefix === "" ? name : `${prefix}/${name}`;
+            if (leftOut(path))
+                continue;
+            if (entry.isSymbolicLink()) {
+                ignored.push(path);
+                continue;
+            }
+            if (entry.isDirectory()) {
+                if (isCleanPath(name))
+                    visit(join(absolute, name), path);
+                else
+                    notSent.push({ path: `${path}/`, reason: "path" });
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            const kind = kindOfPath(path);
+            if (kind === undefined) {
+                ignored.push(path);
+                continue;
+            }
+            if (!isCleanPath(path)) {
+                notSent.push({ path, reason: "path" });
+                continue;
+            }
+            // One file past the limit is enough to refuse the push; there is no point in reading the rest.
+            if (kept > CLOUD_LIMITS.files) {
+                truncated = true;
+                return;
+            }
+            kept++;
+            readFile(path, kind, join(absolute, name));
+        }
+    };
+    visit(folder, "");
+    const set = {
+        folder,
+        texts,
+        binaries,
+        notSent,
+        ignored,
+        overLimit,
+        truncated,
+        holds: (path) => leftOut(path) ||
+            notSent.some((item) => item.path === path || (item.path.endsWith("/") && path.startsWith(item.path))) ||
+            // A link to a folder holds everything under it: the folder is left out, never deleted.
+            ignored.some((link) => link === path || path.startsWith(`${link}/`)) ||
+            // A root that could not be read holds the whole folder.
+            notSent.some((item) => item.path === "/") ||
+            overLimit.some((item) => item.path === path),
+    };
+    return set;
+}
+/**
+ * The refusal the limits of the cloud call for, before anything is sent, with the service's own
+ * code: a file over its limit (`doc.too-large`, `quota.binary`, naming the path), more than 2000
+ * files (`quota.files`), texts over the 16 MiB a project's document holds (`doc.too-large`).
+ */
+export function limitError(set) {
+    const first = set.overLimit[0];
+    if (first) {
+        return new CloudError(first.code, first.code === "quota.binary"
+            ? `${first.path} is larger than the 10 MiB an image or font may be.`
+            : `${first.path} is larger than the 2 Mi characters a text file may have.`, { details: { path: first.path } });
+    }
+    if (set.truncated || set.texts.size + set.binaries.size > CLOUD_LIMITS.files) {
+        return new CloudError("quota.files", `The folder holds more than the ${CLOUD_LIMITS.files} files a project may.`);
+    }
+    let bytes = 0;
+    for (const text of set.texts.values())
+        bytes += Buffer.byteLength(text);
+    if (bytes > CLOUD_LIMITS.documentBytes) {
+        return new CloudError("doc.too-large", "The texts of the folder are larger than a project's 16 MiB.");
+    }
+    return undefined;
+}
+/**
+ * Compares every path of the push set with the cloud's: text files by content, binaries by hash and
+ * cloud paths the folder lacks as deletions. A cloud path left alone: the loser of a name collision
+ * (`<path>~<id>`, which the path rule refuses to send), and one the folder keeps out on purpose or
+ * could not send (excluded, unreadable, not UTF-8).
+ */
+export function compareWithCloud(set, cloud) {
+    const differences = [];
+    const left = [];
+    const cloudTexts = new Map(Object.entries(cloud.files));
+    const cloudBinaries = new Map(Object.entries(cloud.binaries));
+    const losers = collisionLosers([...cloudTexts.keys(), ...cloudBinaries.keys()], cloud.collisions);
+    for (const [path, text] of set.texts) {
+        const held = cloudTexts.get(path);
+        if (held === undefined) {
+            differences.push({
+                path,
+                kind: "text",
+                change: cloudBinaries.has(path) ? "changed" : "added",
+            });
+        }
+        else if (held !== text)
+            differences.push({ path, kind: "text", change: "changed" });
+    }
+    for (const [path, binary] of set.binaries) {
+        const held = cloudBinaries.get(path);
+        if (held === undefined) {
+            differences.push({
+                path,
+                kind: "binary",
+                change: cloudTexts.has(path) ? "changed" : "added",
+            });
+        }
+        else if (held !== binary.hash)
+            differences.push({ path, kind: "binary", change: "changed" });
+    }
+    const cloudOnly = (path, kind) => {
+        if (set.texts.has(path) || set.binaries.has(path))
+            return;
+        if (losers.has(path))
+            left.push({ path, why: "collision" });
+        else if (!isCleanPath(path) || set.holds(path))
+            left.push({ path, why: "kept-out" });
+        else
+            differences.push({ path, kind, change: "deleted" });
+    };
+    for (const path of cloudTexts.keys())
+        cloudOnly(path, "text");
+    for (const path of cloudBinaries.keys())
+        cloudOnly(path, "binary");
+    const byPath = (a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
+    return { differences: differences.sort(byPath), left: left.sort(byPath) };
+}
+/**
+ * What it takes to make the cloud equal to the set, given the comparison: the texts that differ, the
+ * hashes that differ, the deletions, and a deletion of the other kind of a path whose kind changed.
+ */
+export function planPush(set, comparison, cloud) {
+    const texts = {};
+    const binaries = {};
+    const uploads = [];
+    for (const { path, kind, change } of comparison.differences) {
+        if (change === "deleted") {
+            if (kind === "text")
+                texts[path] = null;
+            else
+                binaries[path] = null;
+        }
+        else if (kind === "text") {
+            texts[path] = set.texts.get(path);
+            if (Object.hasOwn(cloud.binaries, path))
+                binaries[path] = null;
+        }
+        else {
+            const binary = set.binaries.get(path);
+            binaries[path] = binary.hash;
+            uploads.push({ path, binary });
+            if (Object.hasOwn(cloud.files, path))
+                texts[path] = null;
+        }
+    }
+    return { texts, binaries, uploads };
+}
+//# sourceMappingURL=push-set.js.map

package/dist/push-set.js.map

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

package/dist/push-validation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The validation a push prints (`cli-cloud`, "Push"): the diagnostics of the folder's project as
+ * `validate <folder>` prints them (the manifest, the limits, plugins, assets, every source with its
+ * composition), in the same line format. They do not stop a push (the page shows them too) unless
+ * `--strict` asks for it.
+ */
+export interface ValidationResult {
+    /** Files with diagnostics are listed; this is how many files were checked (sources and manifest). */
+    readonly files: number;
+    readonly errors: number;
+    readonly warnings: number;
+    /** The printed lines, in the order `validate` prints them. */
+    readonly lines: readonly string[];
+}
+/** Validates the project of a folder as `validate` does and returns what it would print. */
+export declare function validateFolder(folder: string, options: {
+    readonly toolVersion: string;
+    readonly display: (path: string) => string;
+}): ValidationResult;
+//# sourceMappingURL=push-validation.d.ts.map

package/dist/push-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-validation.d.ts","sourceRoot":"","sources":["../src/push-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,qGAAqG;IACrG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAiBD,4FAA4F;AAC5F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GACpF,gBAAgB,CAwClB"}

package/dist/push-validation.js

@@ -0,0 +1,70 @@
+/**
+ * The validation a push prints (`cli-cloud`, "Push"): the diagnostics of the folder's project as
+ * `validate <folder>` prints them (the manifest, the limits, plugins, assets, every source with its
+ * composition), in the same line format. They do not stop a push (the page shows them too) unless
+ * `--strict` asks for it.
+ */
+import { ProjectSessions } from "@meltemi/diagrams-editor/node";
+import { sortDiagnostics } from "@meltemi/diagrams-language";
+import { toProjectPath } from "@meltemi/diagrams-project";
+import { createNodeHost } from "@meltemi/diagrams-project/node";
+import { messages } from "./messages/index.js";
+/** Diagnostics of `project.json`, of the project's plugins and of its assets, by file. */
+function projectDiagnostics(workspace) {
+    const manifest = workspace.manifest();
+    const byPath = new Map();
+    if (manifest.diagnostics.length > 0)
+        byPath.set(manifest.path, [...manifest.diagnostics]);
+    for (const [path, list] of [
+        ...workspace.limits(),
+        ...workspace.plugins().diagnostics,
+        ...workspace.assets().diagnostics,
+    ]) {
+        byPath.set(path, [...(byPath.get(path) ?? []), ...list]);
+    }
+    return new Map([...byPath].map(([path, list]) => [path, sortDiagnostics(list)]));
+}
+/** Validates the project of a folder as `validate` does and returns what it would print. */
+export function validateFolder(folder, options) {
+    const root = toProjectPath(folder);
+    const projects = new ProjectSessions({
+        toolVersion: options.toolVersion,
+        host: createNodeHost(),
+    });
+    const workspace = projects.forFolder(root);
+    const results = new Map(projectDiagnostics(workspace));
+    /** A file's diagnostics with the composition of its diagrams, as the editor shows them. */
+    const withComposition = (diagnostics, file) => {
+        const layout = projects.analyze(file).diagnostics.filter((d) => d.code.startsWith("layout."));
+        const seen = new Set(diagnostics.map((d) => `${d.code}@${d.range.start.offset}|${d.message}`));
+        return sortDiagnostics([
+            ...diagnostics,
+            ...layout.filter((d) => !seen.has(`${d.code}@${d.range.start.offset}|${d.message}`)),
+        ]);
+    };
+    const program = workspace.compileProject();
+    let files = results.size;
+    for (const [file, compiled] of program.files) {
+        if (file !== root && !file.startsWith(`${root}/`))
+            continue;
+        if (!results.has(file))
+            files++;
+        results.set(file, withComposition(compiled.diagnostics, file));
+    }
+    const lines = [];
+    let errors = 0;
+    let warnings = 0;
+    for (const [path, diagnostics] of results) {
+        for (const d of diagnostics) {
+            if (d.severity === "error")
+                errors++;
+            else if (d.severity === "warning")
+                warnings++;
+            lines.push(`${options.display(path)}:${d.range.start.line}:${d.range.start.column}: ${d.severity} ${d.code} ${d.message}`);
+            for (const hint of d.hints ?? [])
+                lines.push(`    ${messages().common.hint}: ${hint}`);
+        }
+    }
+    return { files, errors, warnings, lines };
+}
+//# sourceMappingURL=push-validation.js.map

package/dist/push-validation.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1,9 @@
+/** What a token is shown as. */
+export declare const REDACTED_TOKEN = "mdg_\u2026";
+/**
+ * A message with API tokens (`mdg_…`) and the values of secret-looking environment variables
+ * (names with KEY, TOKEN, SECRET, PASSWORD or CREDENTIAL) removed, so that an unexpected error never
+ * prints a key or a token (decision 0030).
+ */
+export declare function redactSecrets(message: string, env: Readonly<Record<string, string | undefined>>): string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAMA,gCAAgC;AAChC,eAAO,MAAM,cAAc,eAAU,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,MAAM,CAOR"}

package/dist/redact.js

@@ -0,0 +1,22 @@
+/**
+ * An API token of the cloud service: `mdg_` followed by base64url characters (`cli-cloud`,
+ * "Tokens never shown"). `mdg_` alone, and words such as `mdg push`, are not tokens.
+ */
+const API_TOKEN = /mdg_[A-Za-z0-9_-]+/g;
+/** What a token is shown as. */
+export const REDACTED_TOKEN = "mdg_…";
+/**
+ * A message with API tokens (`mdg_…`) and the values of secret-looking environment variables
+ * (names with KEY, TOKEN, SECRET, PASSWORD or CREDENTIAL) removed, so that an unexpected error never
+ * prints a key or a token (decision 0030).
+ */
+export function redactSecrets(message, env) {
+    let result = message.replace(API_TOKEN, REDACTED_TOKEN);
+    for (const [name, value] of Object.entries(env)) {
+        if (!value || value.length < 8 || !/KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL/i.test(name))
+            continue;
+        result = result.split(value).join("[redacted]");
+    }
+    return result;
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAExC,gCAAgC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,GAAiD;IAEjD,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAChG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/review-command.d.ts

@@ -0,0 +1,44 @@
+import { type Locale } from "@meltemi/diagrams-i18n";
+import { type Review } from "@meltemi/diagrams-editor/node";
+import { type ModelChange } from "@meltemi/diagrams-model";
+import { type CloudContext } from "./cloud-context.js";
+/** What the review command needs from the CLI. */
+export interface ReviewContext {
+    readonly name: string;
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    readonly cwd: string;
+    /** A path as printed: relative to the working folder. */
+    readonly display: (path: string) => string;
+    readonly toolVersion: string;
+    /** The language of what the command writes: `--lang`, when given. */
+    readonly locale?: Locale;
+    /**
+     * The connection to the cloud service, for `--base cloud[:<n>]` (`cloudContext("review", …)` of
+     * `cloud-command.ts`). Everything the command prints or writes goes through its `redactSecrets`,
+     * so no token reaches a line, the JSON or the review page.
+     */
+    readonly cloud?: CloudContext;
+}
+/**
+ * What `--base` names when it is the cloud: `cloud` (the project's current files) or `cloud:<n>`
+ * (version `n`); `invalid` for `cloud:` and `cloud:x`; undefined for a Git revision.
+ */
+export declare function parseCloudBase(base: string | undefined): {
+    readonly version: number | undefined;
+} | "invalid" | undefined;
+/** Counts of changes by kind, over every file. */
+export declare function reviewSummary(review: Review): Record<ModelChange["kind"], number> & {
+    files: number;
+};
+/**
+ * The review page: the changes of every file and the pictures of its changed diagrams, with its
+ * words in `locale`, the language of the files the command writes (never the machine's).
+ */
+export declare function reviewPage(review: Review, title: string, compared: string, pictures: ReadonlyMap<string, {
+    before: string | null;
+    after: string | null;
+}>, locale?: Locale): string;
+/** `meltemi-diagrams review`; asynchronous, because `--base cloud` reads the cloud project first. */
+export declare function reviewCommand(args: readonly string[], context: ReviewContext): Promise<number>;
+//# sourceMappingURL=review-command.d.ts.map

package/dist/review-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-command.d.ts","sourceRoot":"","sources":["../src/review-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAIhE,OAAO,EAKL,KAAK,MAAM,EAGZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3E,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKpF,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,GAAG,SAAS,CAIlE;AAqBD,kDAAkD;AAClD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAIzD;AAuCD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,EAC9E,MAAM,GAAE,MAAa,GACpB,MAAM,CAqER;AAED,qGAAqG;AACrG,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAoMjB"}