@wirecat/cli-core 0.0.0 → 0.18.0

package/dist/commands/page.d.ts

@@ -0,0 +1,80 @@
+import type { CommandInfo, OptionInfo } from "./index.js";
+/** The labels of the tables; the same for every CLI writing in one language. */
+export type CommandsPageLabels = {
+    option: string;
+    does: string;
+    argument: string;
+    isWhat: string;
+    required: string;
+    optional: string;
+    /** Precedes a default: `Default` → "… Default: `20`." */
+    defaultIs: string;
+    /** Precedes the allowed values: `One of` → "… One of: `new`, `old`." */
+    oneOf: string;
+    code: string;
+    when: string;
+    success: string;
+    otherwise: string;
+};
+export declare const COMMANDS_PAGE_LABELS: {
+    readonly en: {
+        readonly option: "Option";
+        readonly does: "What it does";
+        readonly argument: "Argument";
+        readonly isWhat: "What it is";
+        readonly required: "required";
+        readonly optional: "optional";
+        readonly defaultIs: "Default";
+        readonly oneOf: "One of";
+        readonly code: "Code";
+        readonly when: "When";
+        readonly success: "it worked";
+        readonly otherwise: "anything else";
+    };
+    readonly ru: {
+        readonly option: "Опция";
+        readonly does: "Что делает";
+        readonly argument: "Аргумент";
+        readonly isWhat: "Что это";
+        readonly required: "обязательный";
+        readonly optional: "необязательный";
+        readonly defaultIs: "По умолчанию";
+        readonly oneOf: "Одно из";
+        readonly code: "Код";
+        readonly when: "Когда";
+        readonly success: "получилось";
+        readonly otherwise: "всё остальное";
+    };
+};
+/** The CLI's own words: everything on the page that is not read out of the program. */
+export type CommandsPageText = {
+    /** The first line, an HTML comment saying the page is generated and by what. */
+    banner: string;
+    title: string;
+    /** Markdown between the title and the global options. */
+    intro: string;
+    globalHeading: string;
+    globalIntro: string;
+    /** Shown under a command that changes something outside this machine. */
+    mutates: string;
+    /** Shown instead under a command marked `local`, which changes only this machine; without it, nothing is. */
+    mutatesLocal?: string;
+    exitHeading: string;
+    exitIntro: string;
+    /** Markdown after the exit codes; may be empty. */
+    outro: string;
+};
+export type CommandsPage = {
+    cli: string;
+    commands: readonly CommandInfo[];
+    options: readonly OptionInfo[];
+    labels: CommandsPageLabels;
+    text: CommandsPageText;
+};
+/**
+ * The whole `docs/commands.md`: every command at any depth, every option and argument, the exit
+ * codes. Descriptions are quoted as `--help` prints them, untranslated — a translation here would
+ * give the sentence a second home, and the one on screen is the one that gets corrected.
+ */
+export declare const commandsPage: ({ cli, commands, options, labels, text }: CommandsPage) => string;
+//# sourceMappingURL=page.d.ts.map

package/dist/commands/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/commands/page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvE,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,oBAAoB;;iBAE7B,MAAM,EAAE,QAAQ;iBAChB,IAAI,EAAE,cAAc;iBACpB,QAAQ,EAAE,UAAU;iBACpB,MAAM,EAAE,YAAY;iBACpB,QAAQ,EAAE,UAAU;iBACpB,QAAQ,EAAE,UAAU;iBACpB,SAAS,EAAE,SAAS;iBACpB,KAAK,EAAE,QAAQ;iBACf,IAAI,EAAE,MAAM;iBACZ,IAAI,EAAE,MAAM;iBACZ,OAAO,EAAE,WAAW;iBACpB,SAAS,EAAE,eAAe;;;iBAG1B,MAAM,EAAE,OAAO;iBACf,IAAI,EAAE,YAAY;iBAClB,QAAQ,EAAE,UAAU;iBACpB,MAAM,EAAE,SAAS;iBACjB,QAAQ,EAAE,cAAc;iBACxB,QAAQ,EAAE,gBAAgB;iBAC1B,SAAS,EAAE,cAAc;iBACzB,KAAK,EAAE,SAAS;iBAChB,IAAI,EAAE,KAAK;iBACX,IAAI,EAAE,OAAO;iBACb,OAAO,EAAE,YAAY;iBACrB,SAAS,EAAE,eAAe;;CAEyB,CAAA;AAEvD,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,6GAA6G;IAC7G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,IAAI,EAAE,gBAAgB,CAAA;CACvB,CAAA;AAWD;;;;GAIG;AACH,eAAO,MAAM,YAAY,6CAA8C,YAAY,KAAG,MAkErF,CAAA"}

package/dist/commands/page.js

@@ -0,0 +1,100 @@
+import { EXIT_CODES } from "../exit-codes.js";
+export const COMMANDS_PAGE_LABELS = {
+    en: {
+        option: "Option",
+        does: "What it does",
+        argument: "Argument",
+        isWhat: "What it is",
+        required: "required",
+        optional: "optional",
+        defaultIs: "Default",
+        oneOf: "One of",
+        code: "Code",
+        when: "When",
+        success: "it worked",
+        otherwise: "anything else",
+    },
+    ru: {
+        option: "Опция",
+        does: "Что делает",
+        argument: "Аргумент",
+        isWhat: "Что это",
+        required: "обязательный",
+        optional: "необязательный",
+        defaultIs: "По умолчанию",
+        oneOf: "Одно из",
+        code: "Код",
+        when: "Когда",
+        success: "получилось",
+        otherwise: "всё остальное",
+    },
+};
+/** A cell that will not break the table it sits in; `~~struck~~` in a description would strike the row. */
+const cell = (text) => (text ?? "").replace(/\|/g, "\\|").replace(/~/g, "\\~").replace(/\n+/g, " ").trim();
+const sentence = (text) => {
+    const said = cell(text);
+    return said === "" || /[.!?]$/.test(said) ? said : `${said}.`;
+};
+/**
+ * The whole `docs/commands.md`: every command at any depth, every option and argument, the exit
+ * codes. Descriptions are quoted as `--help` prints them, untranslated — a translation here would
+ * give the sentence a second home, and the one on screen is the one that gets corrected.
+ */
+export const commandsPage = ({ cli, commands, options, labels, text }) => {
+    // What a value may be and what it is when left out: Commander keeps both out of the description.
+    const extras = ({ choices, default: fallback }) => [
+        choices ? ` ${labels.oneOf}: ${choices.map((choice) => `\`${choice}\``).join(", ")}.` : "",
+        fallback === undefined || fallback === false ? "" : ` ${labels.defaultIs}: \`${String(fallback)}\`.`,
+    ].join("");
+    // The flags go through `cell` too: `--order <recent|name>` would otherwise split the row.
+    const optionRows = (list) => list.map((option) => `| \`${cell(option.flags)}\` | ${sentence(option.description)}${extras(option)} |`).join("\n");
+    const argumentRows = (list) => list
+        .map((argument) => `| \`${cell(argument.name)}\` | ${argument.required ? labels.required : labels.optional} | ${sentence(argument.description)}${extras(argument)} |`)
+        .join("\n");
+    const body = (command) => {
+        const parts = [cell(command.description), ""];
+        const label = command.mutates ? (command.local ? text.mutatesLocal : text.mutates) : undefined;
+        if (label)
+            parts.push(label, "");
+        parts.push("```sh", command.usage, "```");
+        if (command.arguments.length > 0)
+            parts.push("", `| ${labels.argument} | | ${labels.isWhat} |`, "|---|---|---|", argumentRows(command.arguments));
+        if (command.options.length > 0)
+            parts.push("", `| ${labels.option} | ${labels.does} |`, "|---|---|", optionRows(command.options));
+        return parts;
+    };
+    // A group shows its own usage only when it takes options of its own, as `doctor --online` does.
+    const section = (command, depth) => {
+        const heading = `${"#".repeat(Math.min(depth, 4))} \`${cli} ${command.path.join(" ")}\``;
+        if (command.commands.length === 0)
+            return [heading, "", ...body(command)].join("\n");
+        const own = command.options.length > 0 ? body(command) : [cell(command.description)];
+        return [heading, "", ...own, "", command.commands.map((child) => section(child, depth + 1)).join("\n\n")]
+            .join("\n")
+            .trimEnd();
+    };
+    const exitCodes = [
+        `| ${labels.code} | ${labels.when} |`,
+        "|---|---|",
+        `| \`0\` | ${labels.success} |`,
+        ...Object.entries(EXIT_CODES).map(([name, code]) => `| \`${code}\` | \`${name}\` |`),
+        `| \`1\` | ${labels.otherwise} |`,
+    ].join("\n");
+    return [
+        text.banner,
+        `# ${text.title}`,
+        text.intro,
+        `## ${text.globalHeading}`,
+        text.globalIntro,
+        [`| ${labels.option} | ${labels.does} |`, "|---|---|", optionRows(options)].join("\n"),
+        commands.map((command) => section(command, 2)).join("\n\n"),
+        `## ${text.exitHeading}`,
+        text.exitIntro,
+        exitCodes,
+        text.outro,
+    ]
+        .filter((part) => part !== "")
+        .join("\n\n")
+        .concat("\n");
+};
+//# sourceMappingURL=page.js.map

package/dist/commands/page.js.map

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

package/dist/completion/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shell completion over the command registry: which word may come next, as data.
+ *
+ * It speaks the protocol of the shell scripts `@bomb.sh/tab` generates — the shell runs
+ * `<cli> complete -- <words>` and reads `value<TAB>description` lines ending in `:<directive>` —
+ * so a CLI prints those scripts with tab and answers the requests with this. Nothing here reads a
+ * terminal, a file or the network: the words come in, the suggestions go out, and where values come
+ * from (a local cache, a config file) is the CLI's business, handed in as `sources`.
+ */
+import type { CommandInfo, OptionInfo } from "../commands/index.js";
+export interface Suggestion {
+    value: string;
+    description: string;
+}
+/** Values for one argument or option. Called on every Tab, so it must be cheap and must not connect anywhere. */
+export type Values = () => readonly (string | Suggestion)[];
+export interface CompletionSources {
+    /** By argument name, as registered: `chat`, `person`. */
+    arguments?: Readonly<Record<string, Values>>;
+    /** By long option name without dashes: `chat` for `--chat <id>`. */
+    options?: Readonly<Record<string, Values>>;
+    /** Offered alongside the top-level commands — a profile name that may come first, say. */
+    firstWord?: Values;
+}
+export interface CompletionRequest {
+    commands: readonly CommandInfo[];
+    globalOptions?: readonly OptionInfo[];
+    /** Everything after `complete --`; the last word is the one being typed, `""` for a fresh one. */
+    words: readonly string[];
+    sources?: CompletionSources;
+}
+/** Tells the shell not to fall back to file names when nothing matched. */
+export declare const NO_FILE_COMPLETION = 4;
+export declare const suggest: ({ commands, globalOptions, words, sources }: CompletionRequest) => Suggestion[];
+/** The answer in the form the shell script reads. */
+export declare const formatSuggestions: (suggestions: readonly Suggestion[]) => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/completion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/completion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,iHAAiH;AACjH,MAAM,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5C,oEAAoE;IACpE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1C,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC,kGAAkG;IAClG,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,eAAO,MAAM,OAAO,gDAA2D,iBAAiB,KAAG,UAAU,EA2C5G,CAAA;AAED,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,gBAAiB,SAAS,UAAU,EAAE,KAAG,MAC4C,CAAA"}

package/dist/completion/index.js

@@ -0,0 +1,87 @@
+/** Tells the shell not to fall back to file names when nothing matched. */
+export const NO_FILE_COMPLETION = 4;
+export const suggest = ({ commands, globalOptions = [], words, sources = {} }) => {
+    const typed = words.at(-1) ?? "";
+    const before = words.slice(0, -1);
+    let level = commands;
+    let current;
+    let positional = 0;
+    let pending;
+    for (const word of before) {
+        if (pending) {
+            pending = undefined;
+            continue;
+        }
+        if (word.startsWith("-")) {
+            const option = findOption(word, current, globalOptions);
+            if (option?.takesValue && !word.includes("="))
+                pending = option;
+            continue;
+        }
+        const child = level.find((command) => command.name === word);
+        if (child) {
+            current = child;
+            level = child.commands;
+            positional = 0;
+        }
+        else {
+            positional += 1;
+        }
+    }
+    const candidates = pending
+        ? optionValues(pending, sources)
+        : typed.startsWith("-")
+            ? typed.includes("=")
+                ? valuesAfterEquals(typed, current, globalOptions, sources)
+                : optionNames(current, globalOptions)
+            : [
+                ...level.filter((command) => command.state !== "deprecated").map(asSuggestion),
+                ...(current ? argumentValues(current.arguments, positional, sources) : []),
+                ...(current ? [] : resolve(sources.firstWord)),
+            ];
+    const unique = new Map(candidates.map((candidate) => [candidate.value, candidate]));
+    return [...unique.values()].filter(({ value }) => value.startsWith(typed));
+};
+/** The answer in the form the shell script reads. */
+export const formatSuggestions = (suggestions) => [...suggestions.map(({ value, description }) => `${value}\t${description}`), `:${NO_FILE_COMPLETION}`].join("\n");
+const asSuggestion = (command) => ({
+    value: command.name,
+    description: command.summary ?? command.description,
+});
+const longName = (option) => option.flags.match(/--([\w-]+)/)?.[1];
+const findOption = (word, current, globals) => {
+    const name = word.replace(/^-+/, "").split("=")[0];
+    const matches = (option) => longName(option) === name || option.flags.split(/[ ,]+/).includes(`-${name}`);
+    return [...(current?.options ?? []), ...globals].find(matches);
+};
+const optionNames = (current, globals) => [...(current?.options ?? []), ...globals].flatMap((option) => {
+    const name = longName(option);
+    return name ? [{ value: `--${name}`, description: option.description }] : [];
+});
+/** `--kind <dialog|group|channel>`: Commander does not know these as choices, but the flags say them. */
+const inlineChoices = (flags) => flags.match(/<([^>]*\|[^>]*)>/)?.[1]?.split("|") ?? [];
+const optionValues = (option, sources) => {
+    const name = longName(option);
+    return [
+        ...[...(option.choices ?? []), ...inlineChoices(option.flags)].map((value) => ({ value, description: "" })),
+        ...resolve(name ? sources.options?.[name] : undefined),
+    ];
+};
+const valuesAfterEquals = (typed, current, globals, sources) => {
+    const [flag] = typed.split("=");
+    const option = findOption(flag ?? "", current, globals);
+    if (!option?.takesValue)
+        return [];
+    return optionValues(option, sources).map(({ value, description }) => ({ value: `${flag}=${value}`, description }));
+};
+const argumentValues = (args, position, sources) => {
+    const argument = args[position] ?? (args.at(-1)?.variadic ? args.at(-1) : undefined);
+    if (!argument)
+        return [];
+    return [
+        ...(argument.choices ?? []).map((value) => ({ value, description: "" })),
+        ...resolve(sources.arguments?.[argument.name]),
+    ];
+};
+const resolve = (values) => (values?.() ?? []).map((value) => (typeof value === "string" ? { value, description: "" } : value));
+//# sourceMappingURL=index.js.map

package/dist/completion/index.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+import * as v from "valibot";
+/**
+ * Atomic, and the directory is locked down before the first write.
+ *
+ * Atomic because a partial credential file loses **every** profile's secret, not just the one
+ * being written, and the window for that is exactly a Ctrl+C mid-write. The directory mode matters
+ * as much as the file's: `0o600` on a file inside a world-readable directory is worth little.
+ * ⚠ Both modes are ignored on Windows.
+ */
+export declare const writeSecurely: (path: string, contents: string, mode: number) => void;
+/**
+ * Reads and validates a JSON config. A missing file is not an error — it is a program that has not
+ * been configured yet — but a malformed one is, and it says which field and why.
+ *
+ * The schema belongs to the host: what a profile holds is the one thing no shared package can know.
+ */
+export declare const loadConfigFile: <TSchema extends v.GenericSchema>(path: string, schema: TSchema, fallback: () => v.InferOutput<TSchema>) => v.InferOutput<TSchema>;
+/** Config is not a secret, so it is `0644`; the credential file next to it is not. */
+export declare const saveConfigFile: (path: string, config: unknown) => void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,SAAU,MAAM,YAAY,MAAM,QAAQ,MAAM,KAAG,IAe5E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,CAAC,CAAC,aAAa,QACtD,MAAM,UACJ,OAAO,YACL,MAAM,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,KACrC,CAAC,CAAC,WAAW,CAAC,OAAO,CAqBvB,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,cAAc,SAAU,MAAM,UAAU,OAAO,KAAG,IAE9D,CAAA"}

package/dist/config.js

@@ -0,0 +1,61 @@
+import { randomBytes } from "node:crypto";
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import * as v from "valibot";
+/**
+ * Atomic, and the directory is locked down before the first write.
+ *
+ * Atomic because a partial credential file loses **every** profile's secret, not just the one
+ * being written, and the window for that is exactly a Ctrl+C mid-write. The directory mode matters
+ * as much as the file's: `0o600` on a file inside a world-readable directory is worth little.
+ * ⚠ Both modes are ignored on Windows.
+ */
+export const writeSecurely = (path, contents, mode) => {
+    const dir = dirname(path);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    // An unguessable name opened with `wx` fails on anything already there, a planted symlink
+    // included, instead of writing through it.
+    const temp = join(dir, `.${randomBytes(8).toString("hex")}.tmp`);
+    try {
+        writeFileSync(temp, contents, { mode, flag: "wx" });
+        // A rename within one directory is atomic on every platform we target.
+        renameSync(temp, path);
+    }
+    catch (error) {
+        rmSync(temp, { force: true });
+        throw error;
+    }
+};
+/**
+ * Reads and validates a JSON config. A missing file is not an error — it is a program that has not
+ * been configured yet — but a malformed one is, and it says which field and why.
+ *
+ * The schema belongs to the host: what a profile holds is the one thing no shared package can know.
+ */
+export const loadConfigFile = (path, schema, fallback) => {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return fallback();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`${path} is not valid JSON`);
+    }
+    const result = v.safeParse(schema, parsed);
+    if (!result.success) {
+        const problems = result.issues.map((issue) => `${v.getDotPath(issue) ?? "(root)"}: ${issue.message}`);
+        throw new Error(`${path} is not a valid config:\n  ${problems.join("\n  ")}`);
+    }
+    return result.output;
+};
+/** Config is not a secret, so it is `0644`; the credential file next to it is not. */
+export const saveConfigFile = (path, config) => {
+    writeSecurely(path, `${JSON.stringify(config, null, 2)}\n`, 0o644);
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,IAAY,EAAQ,EAAE;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAEhD,0FAA0F;IAC1F,2CAA2C;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAChE,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,uEAAuE;QACvE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7B,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAY,EACZ,MAAe,EACf,QAAsC,EACd,EAAE;IAC1B,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,EAAE,CAAA;IACnB,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACrG,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,8BAA8B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,MAAe,EAAQ,EAAE;IACpE,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACpE,CAAC,CAAA"}

package/dist/credentials.d.ts

@@ -0,0 +1,48 @@
+import { type KeyringStore } from "./keyring.js";
+export declare const CREDENTIAL_STORAGE: readonly ["auto", "keyring", "file"];
+export type CredentialStorage = (typeof CREDENTIAL_STORAGE)[number];
+export type CredentialSource = "environment" | "keyring" | "file";
+export interface StoredCredential {
+    secret: string;
+    source: CredentialSource;
+}
+export interface CredentialsOptions {
+    /** Where the fallback file lives when the keyring cannot be used. */
+    configDir: string;
+    /** The keyring service name — the command's name, e.g. `max-cli`. */
+    service: string;
+    /**
+     * **True when the config directory came from the environment rather than the OS convention.**
+     *
+     * The OS keyring is global: an entry is addressed by service and account and knows nothing about
+     * which config directory asked for it. So a throwaway config directory looks isolated and is
+     * not — it overwrites the real secret for that account. In `brazecli` that destroyed two working
+     * keys on 2026-09-14, and a keyring entry cannot be read back out. Passing `true` here scopes the
+     * service name to the directory, making the isolation people already assume they have real.
+     */
+    isolated?: boolean;
+    /** Read before the keyring, for CI. */
+    envVar?: string;
+    storage?: CredentialStorage;
+    keyring?: KeyringStore;
+    env?: NodeJS.ProcessEnv;
+    fileName?: string;
+    /** Where the one-line warning goes when the keyring is unavailable. Never stdout. */
+    warn?: (message: string) => void;
+}
+export declare const keyringService: (service: string, configDir: string, isolated?: boolean) => string;
+/**
+ * Environment first, then the OS keyring, then a file.
+ *
+ * `auto` does not probe whether a keyring exists: it attempts the operation, and on failure warns
+ * once and falls through. A probe would touch the user's keychain for nothing and could still
+ * succeed where the real operation fails.
+ */
+export declare class Credentials {
+    #private;
+    constructor(options: CredentialsOptions);
+    read(account: string): StoredCredential | undefined;
+    write(account: string, secret: string): CredentialSource;
+    remove(account: string): CredentialSource[];
+}
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,cAAc,CAAA;AAE/D,eAAO,MAAM,kBAAkB,YAAI,MAAM,EAAE,SAAS,EAAE,MAAM,CAAU,CAAA;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,eAAO,MAAM,cAAc,YAAa,MAAM,aAAa,MAAM,yBAAqB,MACtC,CAAA;AAIhD;;;;;;GAMG;AACH,qBAAa,WAAW;;IAWtB,YAAY,OAAO,EAAE,kBAAkB,EAStC;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAWlD;IAED,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAoBvD;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAe1C;CA4CF"}

package/dist/credentials.js

@@ -0,0 +1,120 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { writeSecurely } from "./config.js";
+import { CliError } from "./errors.js";
+import { systemKeyring } from "./keyring.js";
+export const CREDENTIAL_STORAGE = ["auto", "keyring", "file"];
+export const keyringService = (service, configDir, isolated = false) => isolated ? `${service}:${configDir}` : service;
+/**
+ * Environment first, then the OS keyring, then a file.
+ *
+ * `auto` does not probe whether a keyring exists: it attempts the operation, and on failure warns
+ * once and falls through. A probe would touch the user's keychain for nothing and could still
+ * succeed where the real operation fails.
+ */
+export class Credentials {
+    #configDir;
+    #storage;
+    #keyring;
+    #env;
+    #service;
+    #envVar;
+    #fileName;
+    #warn;
+    #warned = false;
+    constructor(options) {
+        this.#configDir = options.configDir;
+        this.#storage = options.storage ?? "auto";
+        this.#keyring = options.keyring ?? systemKeyring;
+        this.#env = options.env ?? process.env;
+        this.#envVar = options.envVar;
+        this.#fileName = options.fileName ?? "credentials.json";
+        this.#warn = options.warn ?? ((message) => process.stderr.write(`${message}\n`));
+        this.#service = keyringService(options.service, options.configDir, options.isolated);
+    }
+    read(account) {
+        const fromEnv = this.#envVar ? this.#env[this.#envVar]?.trim() : undefined;
+        if (fromEnv)
+            return { secret: fromEnv, source: "environment" };
+        if (this.#storage !== "file") {
+            const fromKeyring = this.#tryKeyring(() => this.#keyring.get(this.#service, account));
+            if (fromKeyring)
+                return { secret: fromKeyring, source: "keyring" };
+        }
+        const fromFile = this.#readFile()?.[account]?.secret;
+        return fromFile ? { secret: fromFile, source: "file" } : undefined;
+    }
+    write(account, secret) {
+        if (this.#storage !== "file") {
+            const stored = this.#tryKeyring(() => {
+                this.#keyring.set(this.#service, account, secret);
+                return true;
+            });
+            if (stored)
+                return "keyring";
+        }
+        const store = this.#readFile();
+        if (!store) {
+            throw new CliError("configuration_error", `${this.#path()} cannot be read as a credentials file; storing now would replace every secret in it. ` +
+                "Fix the file or move it aside, then try again.");
+        }
+        store[account] = { secret };
+        this.#writeFile(store);
+        return "file";
+    }
+    remove(account) {
+        const removed = [];
+        if (this.#storage !== "file" && this.#tryKeyring(() => this.#keyring.delete(this.#service, account))) {
+            removed.push("keyring");
+        }
+        const store = this.#readFile();
+        if (store?.[account] !== undefined) {
+            delete store[account];
+            this.#writeFile(store);
+            removed.push("file");
+        }
+        return removed;
+    }
+    #path() {
+        return join(this.#configDir, this.#fileName);
+    }
+    /** `undefined` when the file exists but is not a store: writing would replace what it holds. */
+    #readFile() {
+        let text;
+        try {
+            text = readFileSync(this.#path(), "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return {};
+            return undefined;
+        }
+        try {
+            const parsed = JSON.parse(text);
+            return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : undefined;
+        }
+        catch {
+            // The parser's message quotes the file, and the file holds secrets.
+            return undefined;
+        }
+    }
+    #writeFile(store) {
+        writeSecurely(this.#path(), `${JSON.stringify(store, null, 2)}\n`, 0o600);
+    }
+    #tryKeyring(operation) {
+        if (this.#storage === "keyring")
+            return operation();
+        try {
+            return operation();
+        }
+        catch (error) {
+            if (!this.#warned) {
+                this.#warned = true;
+                this.#warn(`the OS keyring is unavailable (${error instanceof Error ? error.message : String(error)}); ` +
+                    `storing in ${this.#path()} instead, readable only by you`);
+            }
+            return undefined;
+        }
+    }
+}
+//# 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/dev/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/dev/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/dev/bin.ts"],"names":[],"mappings":""}

package/dist/dev/bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { main } from "./main.js";
+process.exitCode = await main(process.argv.slice(2), {
+    cwd: process.cwd(),
+    out: (text) => process.stdout.write(`${text}\n`),
+    err: (text) => process.stderr.write(`${text}\n`),
+});
+//# sourceMappingURL=bin.js.map

package/dist/dev/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/dev/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACnD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACjD,CAAC,CAAA"}