@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/import-command.js

@@ -0,0 +1,254 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { IMPORT_EXTENSIONS, importText, mergeImport, stemOf, } from "@meltemi/diagrams-import";
+import { toProjectPath } from "@meltemi/diagrams-project";
+import { argumentsError, messages } from "./messages/index.js";
+const EXIT_OK = 0;
+const EXIT_FINDINGS = 1;
+const EXIT_USAGE = 2;
+const FORMATS = ["mermaid", "plantuml", "markdown"];
+/** Every importable file below a folder, sorted; hidden folders and `node_modules` are skipped. */
+function importableFiles(folder) {
+    const found = [];
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(path);
+            else {
+                const extension = entry.name.slice(entry.name.lastIndexOf(".") + 1).toLowerCase();
+                // Include files are imported through the files that include them.
+                if (extension !== "iuml" && IMPORT_EXTENSIONS.includes(extension))
+                    found.push(path);
+            }
+        }
+    };
+    walk(folder);
+    return found.sort();
+}
+/** `meltemi-diagrams import <file or folder>`. */
+export function importCommand(args, context) {
+    const fail = (message) => {
+        context.stderr(`${context.name} import: ${message}\n`);
+        return EXIT_USAGE;
+    };
+    let options;
+    let paths;
+    try {
+        const parsed = parseArgs({
+            args: [...args],
+            options: {
+                from: { type: "string" },
+                out: { type: "string" },
+                force: { type: "boolean", default: false },
+                merge: { type: "boolean", default: false },
+                check: { type: "boolean", default: false },
+                json: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        options = parsed.values;
+        paths = parsed.positionals;
+    }
+    catch (error) {
+        return fail(argumentsError(error));
+    }
+    const t = messages().import;
+    if (options.help) {
+        context.stdout(messages().help.import);
+        return EXIT_OK;
+    }
+    if (paths.length !== 1)
+        return fail(t.oneSource);
+    if (options.from !== undefined && !FORMATS.includes(options.from)) {
+        return fail(t.from(options.from, FORMATS));
+    }
+    if (options.force && options.merge)
+        return fail(t.forceAndMerge);
+    const source = isAbsolute(paths[0]) ? paths[0] : resolve(context.cwd, paths[0]);
+    let folder = false;
+    try {
+        folder = statSync(source).isDirectory();
+    }
+    catch {
+        // Reading the file reports it.
+    }
+    if (!folder) {
+        const out = options.out !== undefined
+            ? resolve(context.cwd, options.out)
+            : join(dirname(source), `${stemOf(source)}.meltemi`);
+        const result = importFile(context, source, out, options, false);
+        if (typeof result === "string")
+            return fail(result);
+        if (options.json) {
+            const { refused: _refused, ...report } = result;
+            context.stdout(`${JSON.stringify(report, null, 2)}\n`);
+        }
+        if (result.refused || result.status === "failed")
+            return EXIT_USAGE;
+        return result.status === "partial" ? EXIT_FINDINGS : EXIT_OK;
+    }
+    if (options.from !== undefined)
+        return fail(t.fromInFolder);
+    const files = importableFiles(source);
+    if (files.length === 0)
+        return fail(t.noSources(context.display(source)));
+    const outRoot = options.out === undefined ? null : resolve(context.cwd, options.out);
+    const reports = [];
+    let passed = 0;
+    for (const file of files) {
+        const out = outRoot === null
+            ? join(dirname(file), `${stemOf(file)}.meltemi`)
+            : join(outRoot, dirname(relative(source, file)), `${stemOf(file)}.meltemi`);
+        const result = importFile(context, file, out, options, true);
+        if (typeof result === "string") {
+            context.stderr(`${context.name} import: ${result}\n`);
+            reports.push({
+                source: context.display(file),
+                output: context.display(out),
+                status: "failed",
+                written: false,
+                refused: false,
+                diagrams: [],
+                findings: [],
+                merge: [],
+                coverage: [],
+            });
+            continue;
+        }
+        // A Markdown file without diagram blocks is documentation, not a failed import.
+        if (result.status === "failed" && /\.(md|markdown)$/i.test(file) && !result.written) {
+            passed++;
+            continue;
+        }
+        reports.push(result);
+    }
+    const count = (status) => reports.filter((r) => r.status === status).length;
+    const refused = reports.filter((r) => r.refused).length;
+    if (options.json) {
+        context.stdout(`${JSON.stringify({
+            folder: context.display(source),
+            files: reports.map(({ refused: _refused, ...report }) => report),
+            skipped: passed,
+        }, null, 2)}\n`);
+    }
+    else {
+        const parts = [
+            t.folder.complete(count("complete")),
+            t.folder.partial(count("partial")),
+            ...(count("failed") > 0 ? [t.folder.failed(count("failed"))] : []),
+            ...(refused > 0 ? [t.folder.notReplaced(refused)] : []),
+            ...(passed > 0 ? [t.folder.withoutDiagrams(passed)] : []),
+        ];
+        context.stdout(`${t.folderSummary(options.check, reports.length, context.display(source), parts)}\n`);
+    }
+    if (refused > 0 || count("failed") > 0)
+        return EXIT_USAGE;
+    return count("partial") > 0 ? EXIT_FINDINGS : EXIT_OK;
+}
+/** Imports one file into `out`; the report, or a message when it cannot even be read. */
+function importFile(context, source, out, options, quietNothing) {
+    let text;
+    try {
+        text = readFileSync(source, "utf8");
+    }
+    catch (error) {
+        return messages().common.cannotRead(context.display(source), error.message);
+    }
+    const t = messages().import;
+    if (out === source)
+        return t.replacesSource;
+    // Includes stay inside the source's project, or its folder when it has none.
+    const workspace = context.workspaceFor(toProjectPath(source));
+    const registry = workspace.assets().registry;
+    const result = importText(text, {
+        ...(options.from !== undefined ? { format: options.from } : {}),
+        fileName: toProjectPath(source),
+        includeRoot: workspace.root,
+        readFile: (path) => {
+            try {
+                return readFileSync(path, "utf8");
+            }
+            catch {
+                return undefined;
+            }
+        },
+        hasIcon: (name) => registry.lookup(name).status === "found",
+        locale: context.contentLocale(workspace),
+    });
+    const sourceName = context.display(source);
+    const outName = context.display(out);
+    let sheet = result.text;
+    let mergeFindings = [];
+    const exists = existsSync(out);
+    let refused = false;
+    if (sheet !== null && exists) {
+        if (options.merge) {
+            try {
+                const merged = mergeImport(readFileSync(out, "utf8"), sheet);
+                sheet = merged.text;
+                mergeFindings = merged.findings;
+            }
+            catch (error) {
+                return messages().common.cannotRead(outName, error.message);
+            }
+        }
+        else if (!options.force)
+            refused = true;
+    }
+    const written = sheet !== null && !refused && !options.check;
+    if (written) {
+        try {
+            mkdirSync(dirname(out), { recursive: true });
+            writeFileSync(out, sheet, "utf8");
+        }
+        catch (error) {
+            return messages().common.cannotWrite(outName, error.message);
+        }
+    }
+    if (!options.json && !(quietNothing && sheet === null)) {
+        printFindings(context, sourceName, result.findings);
+        printFindings(context, outName, mergeFindings);
+        for (const c of result.coverage) {
+            context.stdout(`${t.coverage(c.diagram, c.mapped, c.approximated, c.dropped)}\n`);
+        }
+        const status = t.status[result.status];
+        if (refused) {
+            context.stderr(`${context.name} import: ${t.exists(outName)}\n`);
+        }
+        else if (sheet === null) {
+            context.stderr(`${context.name} import: ${t.nothing(sourceName)}\n`);
+        }
+        else if (options.check) {
+            context.stdout(`${t.wouldImport(sourceName, outName, status)}\n`);
+        }
+        else {
+            context.stdout(`${t.imported(sourceName, outName, status, options.merge && exists)}\n`);
+        }
+    }
+    return {
+        source: sourceName,
+        output: outName,
+        status: result.status,
+        written,
+        refused,
+        diagrams: result.diagrams,
+        findings: result.findings,
+        merge: mergeFindings,
+        coverage: result.coverage,
+    };
+}
+function printFindings(context, path, findings) {
+    for (const f of findings) {
+        context.stdout(`${path}:${f.range.start.line}:${f.range.start.column}: ${f.severity} ${f.code} ${f.message}\n`);
+        for (const hint of f.hints ?? []) {
+            context.stdout(`    ${messages().common.hint}: ${hint}\n`);
+        }
+    }
+}
+//# sourceMappingURL=import-command.js.map

package/dist/import-command.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export declare const PACKAGE_NAME = "@meltemi/diagrams-cli";
+export { MELTEMI_EXTENSION, CLI_NAME, CLI_VERSION, EXIT_AUTH, EXIT_FINDINGS, EXIT_OK, EXIT_USAGE, run, type CliIo, } from "./cli.js";
+export { redactSecrets } from "./redact.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAEpD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,GAAG,EACH,KAAK,KAAK,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export const PACKAGE_NAME = "@meltemi/diagrams-cli";
+export { MELTEMI_EXTENSION, CLI_NAME, CLI_VERSION, EXIT_AUTH, EXIT_FINDINGS, EXIT_OK, EXIT_USAGE, run, } from "./cli.js";
+export { redactSecrets } from "./redact.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAEpD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,GAAG,GAEJ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/init-command.d.ts

@@ -0,0 +1,28 @@
+import { TEMPLATES, type TemplateName } from "@meltemi/diagrams-project";
+export { TEMPLATES, type TemplateName };
+/** What the init command needs from the CLI. */
+export interface InitContext {
+    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;
+    readonly languageVersion: string;
+}
+/** The CI services `--ci` writes a workflow for. */
+export declare const CI_SERVICES: readonly ["github", "gitlab"];
+/** The files of a template, relative to its folder, sorted. */
+export declare function templateFiles(template: TemplateName): string[];
+/**
+ * A CI template with its cloud job in or out. The job that pushes to the cloud sits at the end of
+ * the template between two marker comments (`# {{cloud-begin}}` and `# {{cloud-end}}`, so that the
+ * template is the workflow one reads and Prettier keeps it as it is): `--cloud` keeps the job and
+ * drops the markers, and without it the job goes, with the blank line before it, so that the
+ * workflow is byte for byte what it was before the job existed.
+ */
+export declare function withCloudJob(template: string, cloud: boolean): string;
+/** `meltemi-diagrams init`. */
+export declare function initCommand(args: readonly string[], context: InitContext): number;
+//# sourceMappingURL=init-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../src/init-command.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAoB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG3F,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,CAAC;AAExC,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,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,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,oDAAoD;AACpD,eAAO,MAAM,WAAW,+BAAgC,CAAC;AAQzD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAY9D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAIrE;AA6DD,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA0GjF"}

package/dist/init-command.js

@@ -0,0 +1,199 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync, } from "node:fs";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
+import { TEMPLATES, templateManifest } from "@meltemi/diagrams-project";
+import { argumentsError, messages } from "./messages/index.js";
+export { TEMPLATES };
+/** The CI services `--ci` writes a workflow for. */
+export const CI_SERVICES = ["github", "gitlab"];
+const EXIT_OK = 0;
+const EXIT_USAGE = 2;
+/** The folder of the templates: `templates/` beside `src/` and `dist/`. */
+const TEMPLATE_ROOT = fileURLToPath(new URL("../templates/", import.meta.url));
+/** The files of a template, relative to its folder, sorted. */
+export function templateFiles(template) {
+    const root = join(TEMPLATE_ROOT, template);
+    const found = [];
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(path);
+            else
+                found.push(relative(root, path).split(sep).join("/"));
+        }
+    };
+    walk(root);
+    return found.sort();
+}
+/**
+ * A CI template with its cloud job in or out. The job that pushes to the cloud sits at the end of
+ * the template between two marker comments (`# {{cloud-begin}}` and `# {{cloud-end}}`, so that the
+ * template is the workflow one reads and Prettier keeps it as it is): `--cloud` keeps the job and
+ * drops the markers, and without it the job goes, with the blank line before it, so that the
+ * workflow is byte for byte what it was before the job existed.
+ */
+export function withCloudJob(template, cloud) {
+    return cloud
+        ? template.replace(/^ *# \{\{cloud-(?:begin|end)\}\}\n/gm, "")
+        : template.replace(/\n *# \{\{cloud-begin\}\}\n[\s\S]*?\n *# \{\{cloud-end\}\}\n/, "");
+}
+/**
+ * The Git working tree that holds `folder`, or null, spelled as `folder` is: Git answers with the
+ * long form of a path, and a folder reached through a Windows short name (`RUNNER~1`) would
+ * otherwise lie outside it, so the top is reached by climbing from `folder` as far as Git's top is
+ * above it.
+ */
+function gitTop(folder) {
+    const result = spawnSync("git", ["rev-parse", "--show-toplevel"], {
+        cwd: folder,
+        encoding: "utf8",
+        windowsHide: true,
+    });
+    if (result.status !== 0)
+        return null;
+    const top = resolve(result.stdout.trim());
+    try {
+        return resolve(folder, relative(realpathSync.native(folder), realpathSync.native(top)));
+    }
+    catch {
+        return top;
+    }
+}
+/**
+ * Writes the CI workflow of a project: at the top of its Git working tree when it has one, with
+ * the project's path from there. A message when a workflow is already there.
+ */
+function writeCi(service, folder, context, written, cloud) {
+    const top = gitTop(folder) ?? folder;
+    const project = relative(top, folder).split(sep).join("/") || ".";
+    const text = withCloudJob(readFileSync(join(TEMPLATE_ROOT, "ci", `${service}.yml`), "utf8"), cloud)
+        .replaceAll("{{project}}", () => project)
+        .replaceAll("{{version}}", () => context.toolVersion);
+    const t = messages().init;
+    let target;
+    if (service === "github") {
+        target = join(top, ".github", "workflows", "meltemi-diagrams.yml");
+        if (existsSync(target))
+            return t.exists(context.display(target));
+    }
+    else {
+        target = join(top, ".gitlab-ci.yml");
+        if (existsSync(target)) {
+            target = join(top, ".gitlab", "meltemi-diagrams.yml");
+            if (existsSync(target))
+                return t.exists(context.display(target));
+            context.stdout(t.gitlab);
+        }
+    }
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, text);
+    written.push(target);
+    return undefined;
+}
+/** `meltemi-diagrams init`. */
+export function initCommand(args, context) {
+    const fail = (message) => {
+        context.stderr(`${context.name} init: ${message}\n`);
+        return EXIT_USAGE;
+    };
+    let options;
+    let paths;
+    try {
+        const parsed = parseArgs({
+            args: [...args],
+            options: {
+                template: { type: "string" },
+                name: { type: "string" },
+                list: { type: "boolean", default: false },
+                ci: { type: "string" },
+                cloud: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        options = parsed.values;
+        paths = parsed.positionals;
+    }
+    catch (error) {
+        return fail(argumentsError(error));
+    }
+    const t = messages().init;
+    const names = Object.keys(TEMPLATES);
+    if (options.help) {
+        context.stdout(messages().help.init(names.join(", ")));
+        return EXIT_OK;
+    }
+    if (options.list) {
+        const width = Math.max(...names.map((n) => n.length));
+        for (const name of names)
+            context.stdout(`${name.padEnd(width)}  ${t.templates[name]}\n`);
+        return EXIT_OK;
+    }
+    if (paths.length > 1)
+        return fail(t.oneFolder);
+    const template = (options.template ?? "flow");
+    if (!(template in TEMPLATES))
+        return fail(t.noTemplate(String(options.template), names));
+    if (options.ci !== undefined && !CI_SERVICES.includes(options.ci)) {
+        return fail(t.ci(options.ci, CI_SERVICES));
+    }
+    // The push job is a part of the workflow: there is nothing for `--cloud` to change without one.
+    if (options.cloud && options.ci === undefined)
+        return fail(t.cloudNeedsCi(CI_SERVICES));
+    if (options.name !== undefined && options.name.trim() === "")
+        return fail(t.name);
+    const folder = resolve(context.cwd, paths[0] ?? ".");
+    if (existsSync(folder) && !statSync(folder).isDirectory()) {
+        return fail(t.notAFolder(context.display(folder)));
+    }
+    const written = [];
+    const manifest = join(folder, "project.json");
+    if (existsSync(manifest)) {
+        // An existing project only gets its CI workflow.
+        if (options.ci === undefined || options.template !== undefined || options.name !== undefined) {
+            return fail(t.alreadyAProject(context.display(folder)));
+        }
+    }
+    else {
+        const files = templateFiles(template);
+        const clash = files.map((f) => join(folder, ...f.split("/"))).find((f) => existsSync(f));
+        if (clash)
+            return fail(t.clash(context.display(clash)));
+        const name = options.name?.trim() ?? (basename(folder) || "diagrams");
+        mkdirSync(folder, { recursive: true });
+        writeFileSync(manifest, templateManifest(name, template, context));
+        written.push(manifest);
+        for (const file of files) {
+            const target = join(folder, ...file.split("/"));
+            mkdirSync(dirname(target), { recursive: true });
+            writeFileSync(target, readFileSync(join(TEMPLATE_ROOT, template, ...file.split("/"))));
+            written.push(target);
+        }
+    }
+    if (options.ci !== undefined) {
+        const problem = writeCi(options.ci, folder, context, written, options.cloud);
+        if (problem)
+            return fail(problem);
+    }
+    for (const path of written)
+        context.stdout(`${t.created(context.display(path))}\n`);
+    if (options.cloud)
+        context.stdout(`${t.cloudNote("MELTEMI_TOKEN")}\n`);
+    if (written.includes(manifest)) {
+        const at = context.display(folder);
+        context.stdout([
+            "",
+            t.next,
+            `  ${context.name} validate ${at}`,
+            `  ${context.name} preview ${at}`,
+            `  ${context.name} build catalog ${at}`,
+            "",
+        ].join("\n"));
+    }
+    return EXIT_OK;
+}
+//# sourceMappingURL=init-command.js.map

package/dist/init-command.js.map

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

package/dist/login-listener.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The half of `mdg login` that runs on this computer (`cli-cloud`, "Signing in from the command
+ * line"): a listener on `127.0.0.1` at a random port that the approval page redirects the browser
+ * to, with the one-time `code` and the `state` of this request.
+ *
+ * It answers `GET /` with a `code` and a `state` and nothing else (anything else is refused and the
+ * wait goes on), checks the `Host` header so that a name that resolves to this machine is no way in,
+ * stops listening the moment the first such request arrives, and answers the browser only when the
+ * caller says how signing in ended, so the page never claims more than the truth. The code is never
+ * printed or logged.
+ */
+import { type Locale } from "@meltemi/diagrams-i18n";
+/** How long a person has to approve: five minutes, as the service's one-time code lives. */
+export declare const LOGIN_TIMEOUT_MS: number;
+/** RFC 4648 base32, upper case and without padding, of bytes. */
+export declare function base32(bytes: Uint8Array): string;
+/**
+ * The six characters the approval page shows for a `state`: the first six of the base32 of its
+ * SHA-256, so that a person can tell their own terminal's request from somebody else's.
+ */
+export declare function approvalCheck(state: string): string;
+/**
+ * The language of a page from an `Accept-Language` header: the first language, by preference, that
+ * is English or Spanish; the fallback when the header names neither.
+ */
+export declare function languageOf(header: string | undefined, fallback?: Locale): Locale;
+/** The small page the browser lands on: done, or that signing in did not finish. */
+export declare function donePage(locale: Locale, finished: boolean): string;
+/** The one-time code and the state a request brought, and the way to answer the browser. */
+export interface Arrival {
+    readonly code: string;
+    readonly state: string;
+    /** Answers the browser: `true` when signing in finished, `false` when it did not. Once. */
+    reply(finished: boolean): void;
+}
+export interface Approval {
+    /** The port the listener is on. */
+    readonly port: number;
+    /**
+     * Resolves with the first request that brought a `code` and a `state`, or with `timeout` when
+     * none came in time. The listener is closed by then (nothing more is accepted), and what was
+     * left open is closed once the arrival is answered.
+     */
+    readonly outcome: Promise<Arrival | "timeout">;
+    /** Stops listening and drops every connection; safe to call more than once. */
+    close(): Promise<void>;
+}
+export interface ListenOptions {
+    /** Milliseconds to wait for the approval. */
+    readonly timeoutMs: number;
+    /** The language of the page when the browser's `Accept-Language` names neither of ours. */
+    readonly fallbackLocale?: Locale;
+}
+/** Whether two texts are equal, in time that does not depend on where they differ. */
+export declare function sameText(a: string, b: string): boolean;
+/** Starts the listener on `127.0.0.1` at a free port. */
+export declare function listenForApproval(options: ListenOptions): Promise<Approval>;
+//# sourceMappingURL=login-listener.d.ts.map

package/dist/login-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-listener.d.ts","sourceRoot":"","sources":["../src/login-listener.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAA4C,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAG/F,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAI9C,iEAAiE;AACjE,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAehD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAuB,GAAG,MAAM,CAgBhG;AAKD,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAiBlE;AAED,4FAA4F;AAC5F,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC/C,+EAA+E;IAC/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAItD;AAOD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CA2E3E"}