@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/credentials.js

@@ -0,0 +1,243 @@
+/**
+ * Where the command line keeps its sign-in (`cli-cloud`, "Signing in from the command line"):
+ * `credentials.json` in the user's configuration folder, one entry `{ token, id, user }` per host,
+ * and how a command finds the host and the token it uses.
+ *
+ * - The host is `--host`, else `MELTEMI_HOST`, else `https://diagrams.meltemi.dev`: never a
+ *   manifest's (`checkManifestHost` fails with `cloud.host-mismatch` when `project.json` names
+ *   another one).
+ * - The token is `MELTEMI_TOKEN` in the environment, else the file's entry for the host.
+ * - The file is written owner-only (`0o600`, in a `0o700` folder) where the system has such modes,
+ *   through a temporary file and a rename, so a failure never leaves half a file. Windows keeps the
+ *   ACLs the user's profile folder has.
+ * - A file that cannot be read as credentials is reported (`credentials.corrupt`) and never
+ *   overwritten.
+ */
+import { randomBytes } from "node:crypto";
+import { chmodSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { posix, win32 } from "node:path";
+import { cloudHostOrigin, parseCloudHost } from "@meltemi/diagrams-project";
+import { CloudError } from "./cloud-errors.js";
+/** The service every cloud command talks to unless `--host` or `MELTEMI_HOST` says otherwise. */
+export const DEFAULT_HOST = "https://diagrams.meltemi.dev";
+/** The folder of the configuration, and the file of the credentials in it. */
+export const CONFIGURATION_FOLDER = "meltemi-diagrams";
+export const CREDENTIALS_FILE = "credentials.json";
+/** The most a credentials file may weigh: it holds a few entries. */
+const MAX_FILE_BYTES = 1024 * 1024;
+/**
+ * The folder of the configuration: `%APPDATA%\meltemi-diagrams` on Windows;
+ * `$XDG_CONFIG_HOME/meltemi-diagrams` elsewhere (an absolute value only, as the specification
+ * says), else `~/.config/meltemi-diagrams`.
+ */
+export function configurationFolder(options) {
+    const platform = options.platform ?? process.platform;
+    const env = options.env;
+    if (platform === "win32") {
+        const home = options.home ?? (env["USERPROFILE"]?.trim() || homedir());
+        const appData = env["APPDATA"]?.trim();
+        return win32.join(appData ? appData : win32.join(home, "AppData", "Roaming"), CONFIGURATION_FOLDER);
+    }
+    const home = options.home ?? (env["HOME"]?.trim() || homedir());
+    const xdg = env["XDG_CONFIG_HOME"]?.trim();
+    return posix.join(xdg && posix.isAbsolute(xdg) ? xdg : posix.join(home, ".config"), CONFIGURATION_FOLDER);
+}
+/** The credentials file of an environment. */
+export function credentialsPath(options) {
+    const platform = options.platform ?? process.platform;
+    return (platform === "win32" ? win32 : posix).join(configurationFolder(options), CREDENTIALS_FILE);
+}
+// ------------------------------------------------------------------------------------ hosts
+/**
+ * The host a cloud command talks to: `--host` (`flag`), else `MELTEMI_HOST`, else the default. An
+ * empty `MELTEMI_HOST` counts as not set, as CI expands an unset variable. The answer is the
+ * normalised origin. Throws `cloud.host-invalid` for a text that is not an origin and
+ * `cloud.insecure-host` for `http:` anywhere but the loopback (`127.0.0.1`, `localhost`, `[::1]`),
+ * before anything is sent.
+ */
+export function resolveHost(options) {
+    const fromEnvironment = options.env["MELTEMI_HOST"]?.trim();
+    const raw = options.flag ?? (fromEnvironment ? fromEnvironment : DEFAULT_HOST);
+    const parsed = parseCloudHost(raw);
+    if (parsed.ok)
+        return parsed.origin;
+    if (parsed.reason === "insecure") {
+        throw new CloudError("cloud.insecure-host", `${raw} is an http: address; a token only travels over https:, or http: to 127.0.0.1, localhost or [::1].`, { details: { host: raw } });
+    }
+    throw new CloudError("cloud.host-invalid", `${raw} is not the address of a service; use an origin such as ${DEFAULT_HOST}.`, { details: { host: raw } });
+}
+/**
+ * Fails with `cloud.host-mismatch`, naming both hosts and `--host`, when a project's `cloud.host`
+ * is not the host the command resolved. A manifest never chooses where a token goes. Call it before
+ * any request; `manifestHost` is `project.json`'s `cloud.host` (absent when it names none).
+ */
+export function checkManifestHost(resolved, manifestHost) {
+    if (manifestHost === null || manifestHost === undefined)
+        return;
+    if (cloudHostOrigin(manifestHost) === resolved)
+        return;
+    throw new CloudError("cloud.host-mismatch", `project.json names ${manifestHost}, but this command talks to ${resolved}; pass --host ${manifestHost} to use it.`, { details: { manifestHost, host: resolved } });
+}
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** The entry a value is, or undefined when it is not one. */
+function readEntry(value) {
+    if (!isRecord(value) || !isRecord(value["user"]))
+        return undefined;
+    const { token, id } = value;
+    const { sub, name } = value["user"];
+    if (typeof token !== "string" || token === "" || /\s/.test(token))
+        return undefined;
+    if (typeof id !== "string" || id === "")
+        return undefined;
+    if (typeof sub !== "string" || typeof name !== "string")
+        return undefined;
+    return { token, id, user: { sub, name } };
+}
+/** The token of `MELTEMI_TOKEN`, when it is set to something. */
+export function environmentToken(env) {
+    const token = env["MELTEMI_TOKEN"]?.trim();
+    return token ? token : undefined;
+}
+/**
+ * The credentials file. A missing file is an empty one. A file that is not JSON, not an object, or
+ * whose `hosts` is not an object, or whose entry for the host asked about is not an entry, is
+ * `credentials.corrupt`; nothing is written over it, so the person can read what is there.
+ * Entries of other hosts and fields it does not know are kept as they were found.
+ */
+export class CredentialsStore {
+    path;
+    folder;
+    constructor(options) {
+        const platform = options.platform ?? process.platform;
+        this.folder = configurationFolder(options);
+        this.path = (platform === "win32" ? win32 : posix).join(this.folder, CREDENTIALS_FILE);
+    }
+    corrupt(reason) {
+        return new CloudError("credentials.corrupt", `The credentials file ${this.path} cannot be used: ${reason}. Fix it or delete it.`, { details: { path: this.path, reason } });
+    }
+    load() {
+        let text;
+        try {
+            const size = statSync(this.path).size;
+            if (size > MAX_FILE_BYTES)
+                throw this.corrupt("it is too large");
+            text = readFileSync(this.path, "utf8");
+        }
+        catch (error) {
+            if (error instanceof CloudError)
+                throw error;
+            // Nothing there, or a folder in the path that is not one: no file yet (writing says why not).
+            const reason = error.code;
+            if (reason === "ENOENT" || reason === "ENOTDIR")
+                return { hosts: {}, others: {} };
+            throw new CloudError("credentials.unreadable", `The credentials file ${this.path} cannot be read: ${error.message}`, { details: { path: this.path, reason: error.message } });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text.charCodeAt(0) === 0xfeff ? text.slice(1) : text);
+        }
+        catch (error) {
+            throw this.corrupt(`it is not valid JSON (${error.message})`);
+        }
+        if (!isRecord(parsed))
+            throw this.corrupt("it is not a JSON object");
+        const { hosts, ...others } = parsed;
+        if (hosts === undefined)
+            return { hosts: {}, others };
+        if (!isRecord(hosts))
+            throw this.corrupt('"hosts" is not an object');
+        return { hosts, others };
+    }
+    /** Reads the file and makes its folder, so that a command finds out before it asks for a token. */
+    prepare() {
+        this.load();
+        try {
+            mkdirSync(this.folder, { recursive: true, mode: 0o700 });
+        }
+        catch (error) {
+            throw new CloudError("credentials.unwritable", `The credentials folder ${this.folder} cannot be made: ${error.message}`, { details: { path: this.folder, reason: error.message } });
+        }
+    }
+    /** The hosts that have an entry. */
+    hosts() {
+        return Object.keys(this.load().hosts);
+    }
+    /** The entry of a host, or undefined; `credentials.corrupt` when what is there is not an entry. */
+    entry(host) {
+        const stored = this.load().hosts[host];
+        if (stored === undefined)
+            return undefined;
+        const entry = readEntry(stored);
+        if (entry === undefined) {
+            throw this.corrupt(`the entry for ${host} needs "token", "id" and "user" with "sub" and "name"`);
+        }
+        return entry;
+    }
+    /** Keeps the entry of a host, replacing the one it had. */
+    save(host, entry) {
+        const { hosts, others } = this.load();
+        this.write({ ...others, hosts: { ...hosts, [host]: entry } });
+    }
+    /** Forgets the entry of a host; whether there was one. The file goes when nothing is left in it. */
+    remove(host) {
+        const { hosts, others } = this.load();
+        if (!(host in hosts))
+            return false;
+        const { [host]: _removed, ...rest } = hosts;
+        if (Object.keys(rest).length === 0 && Object.keys(others).length === 0) {
+            try {
+                rmSync(this.path, { force: true });
+            }
+            catch (error) {
+                throw this.unwritable(error);
+            }
+            return true;
+        }
+        this.write({ ...others, hosts: rest });
+        return true;
+    }
+    unwritable(error) {
+        return new CloudError("credentials.unwritable", `The credentials file ${this.path} cannot be written: ${error.message}`, { details: { path: this.path, reason: error.message } });
+    }
+    /** Writes owner-only through a temporary file in the same folder, then renames it into place. */
+    write(document) {
+        const temporary = `${this.path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+        try {
+            mkdirSync(this.folder, { recursive: true, mode: 0o700 });
+            // A folder that was already there keeps its mode through mkdir: tighten it, as it holds tokens.
+            if (process.platform !== "win32")
+                chmodSync(this.folder, 0o700);
+            writeFileSync(temporary, `${JSON.stringify(document, null, 2)}\n`, {
+                encoding: "utf8",
+                mode: 0o600,
+                flag: "wx",
+            });
+            // The mode of a new file is subject to the umask and ignored where it is already there.
+            if (process.platform !== "win32")
+                chmodSync(temporary, 0o600);
+            renameSync(temporary, this.path);
+        }
+        catch (error) {
+            try {
+                rmSync(temporary, { force: true });
+            }
+            catch {
+                // Nothing more to do with a temporary file that will not go.
+            }
+            throw this.unwritable(error);
+        }
+    }
+    /**
+     * The token a command uses for a host: `MELTEMI_TOKEN` when it is set (the file is not even
+     * read), else the host's entry. Undefined when there is none.
+     */
+    resolveToken(host, env) {
+        const token = environmentToken(env);
+        if (token !== undefined)
+            return { token, source: "environment" };
+        const entry = this.entry(host);
+        return entry === undefined ? undefined : { token: entry.token, source: "file", entry };
+    }
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/export-command.d.ts

@@ -0,0 +1,35 @@
+import { WRITABLE_FORMATS, type ProjectSessions } from "@meltemi/diagrams-editor/node";
+import type { Diagnostic } from "@meltemi/diagrams-language";
+import { type Compilation } from "@meltemi/diagrams-model";
+import { type Workspace } from "@meltemi/diagrams-project";
+import { exportFileName } from "@meltemi/diagrams-editor";
+export { WRITABLE_FORMATS, exportFileName };
+/** What `export` needs from the command line around it. */
+export interface ExportHost {
+    readonly name: string;
+    readonly io: {
+        readonly stdout: (text: string) => void;
+        readonly stderr: (text: string) => void;
+        readonly cwd: string;
+    };
+    readonly display: (path: string) => string;
+    readonly projects: () => ProjectSessions;
+    readonly readSource: (path: string) => {
+        file: string;
+        text: string;
+    } | undefined;
+    readonly projectDiagnostics: (workspace: Workspace) => Map<string, readonly Diagnostic[]>;
+    readonly printDiagnostics: (out: (text: string) => void, path: string, diagnostics: readonly Diagnostic[]) => void;
+}
+export declare const EXIT_OK = 0;
+export declare const EXIT_FINDINGS = 1;
+export declare const EXIT_USAGE = 2;
+export declare const FONT_POLICIES: readonly ["embedded", "outlined", "system"];
+export declare const MOTION_MODES: readonly ["static", "animated"];
+export declare function noDiagramDiagnostic(compilation: Compilation): Diagnostic;
+/**
+ * `meltemi-diagrams export`: diagrams, story frames, players and profiles of a file, or of every
+ * file of a project folder.
+ */
+export declare function exportCommand(args: readonly string[], host: ExportHost): number;
+//# sourceMappingURL=export-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-command.d.ts","sourceRoot":"","sources":["../src/export-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,gBAAgB,EAMhB,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG1F,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE;QACX,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAClF,QAAQ,CAAC,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,GAAG,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,EAAE,CACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,SAAS,UAAU,EAAE,KAC/B,IAAI,CAAC;CACX;AAED,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,UAAU,IAAI,CAAC;AAG5B,eAAO,MAAM,aAAa,6CAA8C,CAAC;AACzE,eAAO,MAAM,YAAY,iCAAkC,CAAC;AAkF5D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAYxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CA8a/E"}