@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/preview.js

@@ -0,0 +1,249 @@
+import { statSync, watch } from "node:fs";
+import { createServer } from "node:http";
+import { relative, resolve, sep } from "node:path";
+import { parseArgs } from "node:util";
+import { href } from "@meltemi/diagrams-catalog";
+import { buildCatalog, } from "@meltemi/diagrams-editor/node";
+import { getLocale } from "@meltemi/diagrams-i18n";
+import { joinPath, toProjectPath } from "@meltemi/diagrams-project";
+import { argumentsError, messages } from "./messages/index.js";
+import { openUrl } from "./open-url.js";
+const EVENTS = "/events";
+const LOCAL_HOSTS = new Set(["127.0.0.1", "localhost", "[::1]"]);
+/** Whether a change under the project root can change the catalog. */
+function relevant(root, file) {
+    const path = relative(root, file).split(sep).join("/");
+    if (path.split("/").some((part) => part.startsWith(".") || part === "node_modules")) {
+        return false;
+    }
+    return (path.endsWith(".meltemi") ||
+        path === "project.json" ||
+        path === "assets.lock.json" ||
+        path.startsWith("assets/") ||
+        /\.(svg|png|jpe?g|gif|webp)$/i.test(path));
+}
+/**
+ * Serves the catalog of a project on the loopback interface and builds it again when its files
+ * change; open pages reload where they were (decision 0028). Only requests addressed to this
+ * machine's names are answered.
+ */
+export function startPreview(options) {
+    let projects = options.projects();
+    const workspaceOf = () => options.isFolder ? projects.forFolder(options.target) : projects.forFile(options.target);
+    let workspace = workspaceOf();
+    const root = workspace.root;
+    let html = "";
+    let builds = 0;
+    const clients = new Set();
+    const build = () => {
+        const result = buildCatalog(workspace, projects, {
+            generator: options.generator,
+            script: options.script,
+            liveReload: EVENTS,
+        });
+        html = result.html;
+        builds++;
+        options.report(result, workspace);
+        return result;
+    };
+    const first = build();
+    const rebuild = (changed = []) => {
+        // Settings and assets reach fonts and icons: start again from the files.
+        if (changed.some((p) => p === joinPath(root, "project.json") || p.includes("/assets"))) {
+            projects = options.projects();
+            workspace = workspaceOf();
+        }
+        else {
+            for (const path of changed)
+                workspace.invalidate(path);
+        }
+        build();
+        for (const client of clients)
+            client.write(`event: reload\ndata: ${builds}\n\n`);
+    };
+    const serve = (request, response) => {
+        const host = (request.headers.host ?? "").replace(/:\d+$/, "");
+        if (!LOCAL_HOSTS.has(host)) {
+            response.writeHead(403, { "Content-Type": "text/plain; charset=utf-8" });
+            response.end(`${messages().preview.onlyHere}\n`);
+            return;
+        }
+        const path = (request.url ?? "/").split("?")[0];
+        if (request.method !== "GET") {
+            response.writeHead(405, { Allow: "GET" });
+            response.end();
+        }
+        else if (path === EVENTS) {
+            response.writeHead(200, {
+                "Content-Type": "text/event-stream",
+                "Cache-Control": "no-store",
+                Connection: "keep-alive",
+            });
+            response.write("retry: 1000\n\n");
+            clients.add(response);
+            request.on("close", () => clients.delete(response));
+        }
+        else if (path === "/" || path === "/index.html") {
+            response.writeHead(200, {
+                "Content-Type": "text/html; charset=utf-8",
+                "Cache-Control": "no-store",
+                "X-Content-Type-Options": "nosniff",
+            });
+            response.end(html);
+        }
+        else {
+            response.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+            response.end(`${messages().preview.notFound}\n`);
+        }
+    };
+    return new Promise((resolvePromise, reject) => {
+        const server = createServer(serve);
+        let watcher;
+        let timer;
+        const pending = new Set();
+        server.once("error", reject);
+        server.listen(options.port, "127.0.0.1", () => {
+            server.off("error", reject);
+            try {
+                watcher = watch(root, { recursive: true }, (_event, name) => {
+                    if (!name)
+                        return;
+                    const file = toProjectPath(joinPath(root, String(name).split(sep).join("/")));
+                    if (!relevant(root, file))
+                        return;
+                    pending.add(file);
+                    clearTimeout(timer);
+                    timer = setTimeout(() => {
+                        const changed = [...pending];
+                        pending.clear();
+                        rebuild(changed);
+                    }, 150);
+                });
+            }
+            catch {
+                // Without file watching, the page still serves; rebuild() still works.
+            }
+            const address = server.address();
+            const port = typeof address === "object" && address ? address.port : options.port;
+            const firstDiagram = options.isFolder
+                ? undefined
+                : first.data.entries.find((e) => e.file === relative(root, options.target).split(sep).join("/"));
+            const route = firstDiagram
+                ? href(firstDiagram.kind === "story"
+                    ? { page: "story", key: firstDiagram.key }
+                    : { page: "diagram", key: firstDiagram.key, scenario: null, element: null })
+                : "";
+            resolvePromise({
+                url: `http://127.0.0.1:${port}/${route}`,
+                get builds() {
+                    return builds;
+                },
+                rebuild,
+                close: () => new Promise((done) => {
+                    clearTimeout(timer);
+                    watcher?.close();
+                    for (const client of clients)
+                        client.end();
+                    clients.clear();
+                    server.close(() => done());
+                }),
+            });
+        });
+    });
+}
+/**
+ * Opens a URL in the default browser, the way `login` does (`open-url.ts`): the address is one
+ * argument of the opener and no shell reads it, so a `&` or a quote in it means nothing (`cmd /c
+ * start` ended the command at the first `&`). The preview prints its address first, so an opener
+ * that cannot start is not an error here. `open` is replaceable for tests.
+ */
+export function openInBrowser(url, open = openUrl) {
+    try {
+        void open(url).catch(() => undefined);
+    }
+    catch {
+        // An address that is not a web address: nothing to open.
+    }
+}
+/** Prints the diagnostics of a build as the other commands do. */
+export function previewReport(print, stdout, display) {
+    return (build) => {
+        const t = messages().preview;
+        for (const [path, diagnostics] of build.diagnostics)
+            print(display(path), diagnostics);
+        for (const entry of build.skipped) {
+            stdout(`${t.skipped(`${display(entry.path)}#${entry.id}`, entry.reason)}\n`);
+        }
+        const diagrams = build.data.entries.filter((e) => e.kind === "diagram").length;
+        const stories = build.data.entries.length - diagrams;
+        // The machine's clock in English, as before; Spanish writes its own.
+        const locale = getLocale();
+        const time = new Date().toLocaleTimeString(locale === "en" ? undefined : locale);
+        stdout(`${t.built(diagrams, stories, time)}\n`);
+    };
+}
+/** `meltemi-diagrams preview`: runs until stopped; usage errors return 2 at once. */
+export function previewCommand(args, context) {
+    const fail = (message) => {
+        context.stderr(`${context.name} preview: ${message}\n`);
+        return 2;
+    };
+    let values;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: [...args],
+            options: {
+                port: { type: "string" },
+                open: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (error) {
+        return fail(argumentsError(error));
+    }
+    const t = messages().preview;
+    if (values.help) {
+        context.stdout(messages().help.preview);
+        return 0;
+    }
+    if (positionals.length > 1)
+        return fail(messages().common.oneProject);
+    const port = values.port === undefined ? 4317 : Number(values.port);
+    if (!Number.isInteger(port) || port < 0 || port > 65535)
+        return fail(t.port(values.port));
+    const target = toProjectPath(resolve(context.cwd, positionals[0] ?? "."));
+    let isFolder;
+    try {
+        isFolder = statSync(target).isDirectory();
+    }
+    catch {
+        return fail(messages().common.pathNotFound(positionals[0] ?? "."));
+    }
+    startPreview({
+        target,
+        isFolder,
+        port,
+        projects: context.projects,
+        generator: context.generator,
+        script: context.script,
+        report: previewReport(context.printDiagnostics, context.stdout, context.display),
+    }).then((server) => {
+        context.stdout(`${t.serving(server.url)}\n`);
+        if (values.open)
+            openInBrowser(server.url);
+        process.once("SIGINT", () => {
+            void server.close().then(() => process.exit(0));
+        });
+    }, (error) => {
+        context.stderr(`${context.name} preview: ${error.code === "EADDRINUSE" ? t.portInUse(port) : error.message}\n`);
+        process.exitCode = 2;
+    });
+    return 0;
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

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

package/dist/project-errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * How the failures of `push` and `pull` read in the interface language (`cli-cloud`): by stable
+ * code, with the facts the failure carries in its `details` (a path, a count, a project id).
+ * `describeCloudError` (`cloud-context.ts`) asks here for every code it has no sentence of its own
+ * for and falls back to the failure's English message when this does not know the code either.
+ *
+ * Besides the commands' own codes (`push.*`, `pull.*`) these are the service's codes as a push or a
+ * pull meets them (`revision.mismatch`, `quota.files`, `quota.binary`, `doc.too-large`, ...). The
+ * codes that `cloud-context.ts` has sentences for (`cloud.no-project`, `pull.unsafe-path`,
+ * `project.not-found`, `version.not-found`, `access.denied`) are not repeated here.
+ */
+import { CloudError } from "./cloud-errors.js";
+/** The sentence of a failure of `push`, `pull` or the service as they meet it; undefined for any other code. */
+export declare function describeProjectError(error: CloudError): string | undefined;
+/** The same failure with more facts in its `details` (the project or version it was about). */
+export declare function withDetails(error: unknown, details: Readonly<Record<string, unknown>>): unknown;
+//# sourceMappingURL=project-errors.d.ts.map

package/dist/project-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-errors.d.ts","sourceRoot":"","sources":["../src/project-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAc/C,gHAAgH;AAChH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAoD1E;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAQ/F"}

package/dist/project-errors.js

@@ -0,0 +1,85 @@
+/**
+ * How the failures of `push` and `pull` read in the interface language (`cli-cloud`): by stable
+ * code, with the facts the failure carries in its `details` (a path, a count, a project id).
+ * `describeCloudError` (`cloud-context.ts`) asks here for every code it has no sentence of its own
+ * for and falls back to the failure's English message when this does not know the code either.
+ *
+ * Besides the commands' own codes (`push.*`, `pull.*`) these are the service's codes as a push or a
+ * pull meets them (`revision.mismatch`, `quota.files`, `quota.binary`, `doc.too-large`, ...). The
+ * codes that `cloud-context.ts` has sentences for (`cloud.no-project`, `pull.unsafe-path`,
+ * `project.not-found`, `version.not-found`, `access.denied`) are not repeated here.
+ */
+import { CloudError } from "./cloud-errors.js";
+import { messages } from "./messages/index.js";
+/** A detail as text: a string or a number, else `fallback`. */
+function text(value, fallback = "") {
+    if (typeof value === "string")
+        return value;
+    return typeof value === "number" ? String(value) : fallback;
+}
+/** A detail as a count. */
+function whole(value) {
+    return typeof value === "number" ? value : 0;
+}
+/** The sentence of a failure of `push`, `pull` or the service as they meet it; undefined for any other code. */
+export function describeProjectError(error) {
+    const t = messages().cloud.projectErrors;
+    const d = error.details;
+    const path = text(d["path"]);
+    switch (error.code) {
+        case "revision.mismatch":
+            return t.revisionMismatch;
+        case "quota.files":
+            return t.quotaFiles;
+        case "quota.binary":
+            return t.quotaBinary(path);
+        case "quota.storage":
+            return t.quotaStorage;
+        case "quota.projects":
+            return t.quotaProjects;
+        case "doc.too-large":
+            return t.docTooLarge(path);
+        case "path.invalid":
+            return t.pathInvalid(path);
+        case "binary.invalid":
+            return t.binaryInvalid(path);
+        case "push.differs":
+            return t.pushDiffers(whole(d["count"]));
+        case "push.declined":
+            return t.pushDeclined;
+        case "push.already-linked":
+            return t.pushLinked(text(d["project"], "?"));
+        case "push.strict":
+            return t.pushStrict(whole(d["errors"]), whole(d["unsent"]));
+        case "push.manifest-invalid":
+            return t.pushManifestInvalid(text(d["reason"], error.message));
+        case "push.manifest-not-written":
+            return t.pushManifestNotWritten(text(d["project"], "?"), text(d["host"], "?"), text(d["reason"], error.message));
+        case "push.file-changed":
+            return t.pushFileChanged(path);
+        case "pull.no-project":
+            return t.pullNoProject;
+        case "pull.other-project":
+            return t.pullOtherProject(text(d["project"], "?"), text(d["linked"], "?"));
+        case "pull.not-a-folder":
+            return t.pullNotAFolder(path);
+        case "pull.manifest-not-updated":
+            return t.pullManifestNotUpdated(text(d["reason"], error.message));
+        case "pull.write":
+            return t.pullWrite(path, text(d["reason"], error.message));
+        default:
+            return undefined;
+    }
+}
+/** The same failure with more facts in its `details` (the project or version it was about). */
+export function withDetails(error, details) {
+    if (!(error instanceof CloudError))
+        return error;
+    return new CloudError(error.code, error.message, {
+        status: error.status,
+        details: { ...error.details, ...details },
+        exitCode: error.exitCode,
+        ...(error.retryAfter === undefined ? {} : { retryAfter: error.retryAfter }),
+    });
+}
+//# sourceMappingURL=project-errors.js.map

package/dist/project-errors.js.map

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

package/dist/projects-command.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `projects` (`cli-cloud`, "Projects and review against the cloud"): the person's cloud projects
+ * with id, name, role and last change, most recent first, as a table or as JSON.
+ *
+ * The JSON is one object whose field names are the service's own and are stable:
+ * `{ "host": "<origin>", "projects": [{ "id", "name", "description", "role", "updated_at" }] }`,
+ * `role` being `owner`, `editor` or `viewer` and `updated_at` an ISO 8601 time in UTC. The table is
+ * for people: its words follow the interface language, and a name that holds a control character
+ * (an escape sequence in a project somebody shared) is printed with spaces instead.
+ */
+import { type CloudCommand } from "./cloud-context.js";
+export declare const projectsCommand: CloudCommand;
+//# sourceMappingURL=projects-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects-command.d.ts","sourceRoot":"","sources":["../src/projects-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAiCrF,eAAO,MAAM,eAAe,EAAE,YAmD7B,CAAC"}

package/dist/projects-command.js

@@ -0,0 +1,85 @@
+/**
+ * `projects` (`cli-cloud`, "Projects and review against the cloud"): the person's cloud projects
+ * with id, name, role and last change, most recent first, as a table or as JSON.
+ *
+ * The JSON is one object whose field names are the service's own and are stable:
+ * `{ "host": "<origin>", "projects": [{ "id", "name", "description", "role", "updated_at" }] }`,
+ * `role` being `owner`, `editor` or `viewer` and `updated_at` an ISO 8601 time in UTC. The table is
+ * for people: its words follow the interface language, and a name that holds a control character
+ * (an escape sequence in a project somebody shared) is printed with spaces instead.
+ */
+import { parseArgs } from "node:util";
+import { openCloud, usage, usageError } from "./cloud-context.js";
+import { EXIT_OK } from "./cloud-errors.js";
+import { messages } from "./messages/index.js";
+/** Text safe for a terminal: control characters (C0, DEL and C1) become spaces. */
+function plain(text) {
+    return Array.from(text, (character) => {
+        const code = character.codePointAt(0);
+        return code < 0x20 || (code >= 0x7f && code <= 0x9f) ? " " : character;
+    }).join("");
+}
+/** A time as the table shows it: ISO 8601 in UTC to the second, `2026-10-15T09:41:02Z`. */
+function shown(time) {
+    return plain(time.replace(/\.\d+Z$/, "Z"));
+}
+/** The table, columns padded to the width of their widest cell. */
+function table(projects) {
+    const t = messages().cloud.projects;
+    const rows = [
+        [t.header.id, t.header.name, t.header.role, t.header.changed],
+        ...projects.map((p) => [plain(p.id), plain(p.name), t.roles[p.role], shown(p.updated_at)]),
+    ];
+    const widths = [0, 1, 2].map((column) => Math.max(...rows.map((row) => row[column].length)));
+    return rows
+        .map((row) => [...row.slice(0, 3).map((cell, i) => cell.padEnd(widths[i])), row[3]].join("  ").trimEnd())
+        .join("\n");
+}
+export const projectsCommand = async (args, context) => {
+    const help = messages().help.projects;
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: [...args],
+            options: {
+                json: { type: "boolean", default: false },
+                host: { type: "string" },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+    }
+    catch (error) {
+        return usageError(context, error, help);
+    }
+    if (parsed.values.help) {
+        context.stdout(help);
+        return EXIT_OK;
+    }
+    if (parsed.positionals.length > 0) {
+        return usage(context, messages().cloud.noArguments(context.command), help);
+    }
+    const { host, client } = openCloud(context, { host: parsed.values.host });
+    const projects = await client.projects();
+    if (parsed.values.json) {
+        context.stdout(`${JSON.stringify({
+            host,
+            projects: projects.map((p) => ({
+                id: p.id,
+                name: p.name,
+                description: p.description,
+                role: p.role,
+                updated_at: p.updated_at,
+            })),
+        }, null, 2)}\n`);
+        return EXIT_OK;
+    }
+    if (projects.length === 0) {
+        context.stdout(`${messages().cloud.projects.none(context.name)}\n`);
+        return EXIT_OK;
+    }
+    context.stdout(`${table(projects)}\n`);
+    return EXIT_OK;
+};
+//# sourceMappingURL=projects-command.js.map

package/dist/projects-command.js.map

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

package/dist/publish-command.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `publish` (`cli-cloud`, "Publish"): the catalog of the folder's project as a web page of the cloud
+ * service.
+ *
+ * The order, and why:
+ *
+ * 1. The project and the session: the folder's manifest names the cloud project (`cloud.project`,
+ *    or `--project`), the host is `--host`, `MELTEMI_HOST` or the default, and `cloud.host-mismatch`
+ *    and "not signed in" fail before any request.
+ * 2. `--unpublish` ends here: one `DELETE`, nothing is built or pushed.
+ * 3. `GET …/publish` first: it is the owner's, so a project the person may not publish (`access.denied`,
+ *    `project.not-found`) fails before the catalog is built, and it says whether a handle is chosen.
+ * 4. The catalog is built in memory, exactly as `build catalog` builds it (same generator, same
+ *    defaults, the `--lang` language), before anything is sent: a catalog with nothing in it, with
+ *    errors under `--strict`, or too large for a page, fails with nothing pushed and nothing
+ *    published.
+ * 5. The handle: the first publication needs one (`--handle`, or asked on a terminal). With
+ *    `--handle` the handle is set first (`PATCH /api/account`); the service lets a token do that; a
+ *    service that answers `403 request.forbidden` instead makes it `publish.handle-in-page`.
+ * 6. The folder is pushed when it differs from the cloud project: the command of `push`, with its
+ *    comparison and its question (`--force` answers it, as in CI), so what is published is what the
+ *    cloud holds.
+ * 7. `PUT …/publish`, and the public address printed on a line of its own.
+ */
+import { type CloudCommand } from "./cloud-context.js";
+/**
+ * The size that makes a page too large for the service, or undefined when it fits: the HTML over
+ * 16 MiB of UTF-8, or the request that carries it over 24 MiB (JSON escapes quotes and the like, so
+ * a page below the first limit can still be above the second). Checked here so that nothing is sent.
+ */
+export declare function oversize(slug: string, html: string): number | undefined;
+/** A page name made of a project's name: lower-case ASCII letters and digits with single hyphens. */
+export declare function slugOf(text: string): string;
+/**
+ * The `publish` command, with the step that pushes the folder given: `push`'s own command, which
+ * compares the folder with the cloud project and asks (or is forced), and answers its exit code.
+ */
+export declare function createPublishCommand(push: CloudCommand): CloudCommand;
+/** `publish`, pushing the folder with `push`'s own command. */
+export declare const publishCommand: CloudCommand;
+//# sourceMappingURL=publish-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish-command.d.ts","sourceRoot":"","sources":["../src/publish-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAYH,OAAO,EAIL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAa5B;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOvE;AAKD,qGAAqG;AACrG,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU3C;AAoKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAiHrE;AAED,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,YAAgD,CAAC"}