@twin.org/cli-core 0.0.2-next.8 → 0.0.3-next.1

package/dist/cjs/index.cjs

@@ -1,878 +0,0 @@
-'use strict';
-
-var core = require('@twin.org/core');
-var commander = require('commander');
-var node_readline = require('node:readline');
-var node_util = require('node:util');
-var chalk = require('chalk');
-var path = require('node:path');
-var dotenv = require('dotenv');
-var node_child_process = require('node:child_process');
-var node_fs = require('node:fs');
-var promises = require('node:fs/promises');
-var crypto = require('@twin.org/crypto');
-
-function _interopNamespaceDefault(e) {
-    var n = Object.create(null);
-    if (e) {
-        Object.keys(e).forEach(function (k) {
-            if (k !== 'default') {
-                var d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: function () { return e[k]; }
-                });
-            }
-        });
-    }
-    n.default = e;
-    return Object.freeze(n);
-}
-
-var dotenv__namespace = /*#__PURE__*/_interopNamespaceDefault(dotenv);
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Display utilities for the CLI.
- */
-class CLIDisplay {
-    /**
-     * The interval ID for the spinner.
-     * @internal
-     */
-    static _spinnerIntervalId;
-    /**
-     * The default output method for writing standard messages.
-     * @param buffer The message to output.
-     */
-    static write = buffer => process.stdout.write(buffer);
-    /**
-     * The default output method for writing error messages.
-     * @param buffer The message to output.
-     */
-    static writeError = buffer => process.stderr.write(buffer);
-    /**
-     * The default output method for clearing the current line.
-     */
-    static clearLine = () => {
-        node_readline.clearLine(process.stdout, 0);
-        node_readline.cursorTo(process.stdout, 0);
-    };
-    /**
-     * Display the header for the CLI.
-     * @param title The title of the CLI.
-     * @param version The version of the CLI.
-     * @param icon The icon for the CLI.
-     */
-    static header(title, version, icon) {
-        const titleVersion = `${title} v${version}`;
-        CLIDisplay.write(`${icon} ${chalk.underline.bold.blue(titleVersion)}\n`);
-        CLIDisplay.write("\n");
-    }
-    /**
-     * Display an error message.
-     * @param error The error to display.
-     * @param lineBreaks Whether to add a line break after the error.
-     */
-    static error(error, lineBreaks = true) {
-        CLIDisplay.writeError("❗ ");
-        CLIDisplay.writeError(chalk.red(core.I18n.formatMessage("cli.progress.error")));
-        if (lineBreaks) {
-            CLIDisplay.writeError("\n");
-        }
-        const formatted = core.ErrorHelper.formatErrors(error, true);
-        CLIDisplay.writeError(chalk.red(formatted.map(e => `\t${e}`).join("\n")));
-        if (lineBreaks) {
-            CLIDisplay.writeError("\n");
-        }
-    }
-    /**
-     * Display a section.
-     * @param label The label for the section.
-     */
-    static section(label) {
-        CLIDisplay.write(chalk.hex("#FFA500").bold.underline(label));
-        CLIDisplay.write("\n\n");
-    }
-    /**
-     * Display a value with a label.
-     * @param label The label for the value.
-     * @param value The value to display.
-     * @param indentLevel The level of indentation.
-     */
-    static value(label, value, indentLevel = 0) {
-        CLIDisplay.write("\t".repeat(indentLevel));
-        if (core.Is.stringValue(label)) {
-            CLIDisplay.write(chalk.hex("#FFA500").bold(`${label}: `));
-        }
-        CLIDisplay.write(core.Coerce.string(value) ?? "");
-        CLIDisplay.write("\n");
-    }
-    /**
-     * Display a task with a label.
-     * @param label The label for the value.
-     * @param task The task to display.
-     */
-    static task(label, task) {
-        CLIDisplay.write("➡️  ");
-        if (core.Is.empty(task)) {
-            CLIDisplay.write(chalk.cyan(label));
-        }
-        else {
-            CLIDisplay.write(chalk.cyan(`${label}: `));
-            CLIDisplay.write(task);
-        }
-        CLIDisplay.write("\n");
-    }
-    /**
-     * Display a break.
-     */
-    static break() {
-        CLIDisplay.write("\n");
-    }
-    /**
-     * Display formatted and colorized JSON.
-     * @param obj The object to display.
-     */
-    static json(obj) {
-        CLIDisplay.write(node_util.inspect(obj, false, undefined, true));
-        CLIDisplay.write("\n");
-    }
-    /**
-     * Display a warning.
-     * @param label The label for the warning.
-     */
-    static warning(label) {
-        CLIDisplay.write("⚠️  ");
-        CLIDisplay.write(chalk.hex("#FFA500").bold(label));
-        CLIDisplay.write("\n\n");
-    }
-    /**
-     * Display the processing is done.
-     */
-    static done() {
-        CLIDisplay.write("🎉 ");
-        CLIDisplay.write(chalk.greenBright.bold(core.I18n.formatMessage("cli.progress.done")));
-        CLIDisplay.write("\n");
-    }
-    /**
-     * Start the spinner.
-     * @param i18nMessage The message to display with the spinner.
-     * @param spinnerCharacters The characters to use in the spinner.
-     * @param interval The interval for the spinner.
-     */
-    static spinnerStart(i18nMessage = "cli.progress.pleaseWait", spinnerCharacters = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"], interval = 100) {
-        let spinnerIndex = 0;
-        if (CLIDisplay._spinnerIntervalId) {
-            clearInterval(CLIDisplay._spinnerIntervalId);
-        }
-        CLIDisplay._spinnerIntervalId = setInterval(() => {
-            CLIDisplay.clearLine();
-            CLIDisplay.write(`${spinnerCharacters[spinnerIndex++ % spinnerCharacters.length]} ${core.I18n.formatMessage(i18nMessage)}`);
-        }, interval);
-    }
-    /**
-     * Stop the spinner.
-     */
-    static spinnerStop() {
-        if (CLIDisplay._spinnerIntervalId) {
-            clearInterval(CLIDisplay._spinnerIntervalId);
-            CLIDisplay._spinnerIntervalId = undefined;
-        }
-        CLIDisplay.clearLine();
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Utilities function for helping in the CLI.
- */
-class CLIUtils {
-    /**
-     * Does the specified file exist.
-     * @param filename The filename to check for existence.
-     * @returns True if the file exists.
-     */
-    static async fileExists(filename) {
-        try {
-            const stats = await promises.stat(filename);
-            return stats.isFile();
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Does the specified file exist, synchronously.
-     * @param filename The filename to check for existence.
-     * @returns True if the file exists.
-     */
-    static fileExistsSync(filename) {
-        try {
-            const stats = node_fs.statSync(filename);
-            return stats.isFile();
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Check if the dir exists.
-     * @param dir The directory to check.
-     * @returns True if the dir exists.
-     */
-    static async dirExists(dir) {
-        try {
-            await promises.access(dir);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Check if the dir exists, synchronously.
-     * @param dir The directory to check.
-     * @returns True if the dir exists.
-     */
-    static dirExistsSync(dir) {
-        try {
-            node_fs.accessSync(dir);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Read a JSON file and parse it.
-     * @param filename The filename to read.
-     * @returns The parsed JSON.
-     */
-    static async readJsonFile(filename) {
-        if (await CLIUtils.fileExists(filename)) {
-            const content = await promises.readFile(filename, "utf8");
-            return JSON.parse(content);
-        }
-    }
-    /**
-     * Read a JSON file and parse it, synchronously.
-     * @param filename The filename to read.
-     * @returns The parsed JSON.
-     */
-    static readJsonFileSync(filename) {
-        if (CLIUtils.fileExistsSync(filename)) {
-            const content = node_fs.readFileSync(filename, "utf8");
-            return JSON.parse(content);
-        }
-    }
-    /**
-     * Read a file as lines.
-     * @param filename The filename to read.
-     * @returns The lines.
-     */
-    static async readLinesFile(filename) {
-        if (await CLIUtils.fileExists(filename)) {
-            const content = await promises.readFile(filename, "utf8");
-            return content.split("\n");
-        }
-    }
-    /**
-     * Read a file as lines, synchronously.
-     * @param filename The filename to read.
-     * @returns The lines.
-     */
-    static readLinesFileSync(filename) {
-        if (CLIUtils.fileExistsSync(filename)) {
-            const content = node_fs.readFileSync(filename, "utf8");
-            return content.split("\n");
-        }
-    }
-    /**
-     * Find the NPM root based on a package.json path.
-     * @param rootFolder The path to the package.json.
-     * @returns The root path.
-     */
-    static async findNpmRoot(rootFolder) {
-        return new Promise((resolve, reject) => {
-            node_child_process.exec("npm root", { cwd: rootFolder }, (error, stdout, stderr) => {
-                if (error) {
-                    reject(error);
-                }
-                else {
-                    resolve(stdout.trim());
-                }
-            });
-        });
-    }
-    /**
-     * Run a shell command.
-     * @param command The app to run in the shell.
-     * @param args The args for the app.
-     * @param cwd The working directory to execute the command in.
-     * @returns Promise to wait for command execution to complete.
-     */
-    static async runShellCmd(command, args, cwd) {
-        const osCommand = process.platform.startsWith("win") ? `${command}.cmd` : command;
-        return CLIUtils.runShellApp(osCommand, args, cwd);
-    }
-    /**
-     * Run a shell app.
-     * @param app The app to run in the shell.
-     * @param args The args for the app.
-     * @param cwd The working directory to execute the command in.
-     * @returns Promise to wait for command execution to complete.
-     */
-    static async runShellApp(app, args, cwd) {
-        return new Promise((resolve, reject) => {
-            const sp = node_child_process.spawn(app, args, {
-                shell: true,
-                cwd
-            });
-            sp.stdout?.on("data", data => {
-                CLIDisplay.write(data);
-            });
-            sp.stderr?.on("data", data => {
-                CLIDisplay.writeError(data);
-            });
-            sp.on("exit", (exitCode, signals) => {
-                if (core.Coerce.number(exitCode) !== 0 || signals?.length) {
-                    // eslint-disable-next-line no-restricted-syntax
-                    reject(new Error("Run failed"));
-                }
-                else {
-                    resolve();
-                }
-            });
-        });
-    }
-    /**
-     * Write a JSON file.
-     * @param jsonFilename The filename to write.
-     * @param data The data to write.
-     * @param append Append to the file.
-     */
-    static async writeJsonFile(jsonFilename, data, append) {
-        if (core.Is.stringValue(jsonFilename)) {
-            const filename = path.resolve(jsonFilename);
-            let currentJson = {};
-            if (append) {
-                CLIDisplay.task(core.I18n.formatMessage("cli.progress.readingJsonFile"), filename);
-                currentJson = (await CLIUtils.readJsonFile(filename)) ?? {};
-            }
-            CLIDisplay.task(core.I18n.formatMessage("cli.progress.writingJsonFile"), filename);
-            CLIDisplay.break();
-            await promises.mkdir(path.dirname(filename), { recursive: true });
-            await promises.writeFile(filename, `${JSON.stringify(core.ObjectHelper.merge(currentJson, data), undefined, "\t")}\n`);
-        }
-    }
-    /**
-     * Write an env file.
-     * @param envFilename The filename to write.
-     * @param data The data to write.
-     * @param append Append to the file.
-     */
-    static async writeEnvFile(envFilename, data, append) {
-        if (core.Is.stringValue(envFilename)) {
-            const filename = path.resolve(envFilename);
-            const outputKeys = [];
-            const outputDict = {};
-            if (append) {
-                CLIDisplay.task(core.I18n.formatMessage("cli.progress.readingEnvFile"), filename);
-                const lines = await CLIUtils.readLinesFile(filename);
-                if (core.Is.arrayValue(lines)) {
-                    for (const line of lines) {
-                        const parts = line.split("=");
-                        outputKeys.push(parts[0]);
-                        outputDict[parts[0]] = parts.slice(1).join("=");
-                    }
-                }
-            }
-            CLIDisplay.task(core.I18n.formatMessage("cli.progress.writingEnvFile"), filename);
-            CLIDisplay.break();
-            if (core.Is.arrayValue(data)) {
-                for (const line of data) {
-                    const parts = line.split("=");
-                    const currentIndex = outputKeys.indexOf(parts[0]);
-                    if (currentIndex !== -1) {
-                        outputKeys.splice(currentIndex, 1);
-                    }
-                    outputKeys.push(parts[0]);
-                    outputDict[parts[0]] = parts.slice(1).join("=");
-                }
-            }
-            const output = [];
-            for (const outputKey of outputKeys) {
-                output.push(`${outputKey}=${outputDict[outputKey]}`);
-            }
-            await promises.mkdir(path.dirname(filename), { recursive: true });
-            await promises.writeFile(filename, output.join("\n"));
-        }
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-let localesDir;
-/**
- * Initialize the global options.
- * @param localesDirectory The path to load the locales from.
- */
-function initGlobalOptions(localesDirectory) {
-    localesDir = localesDirectory;
-}
-/**
- * Add the global options.
- * @param program The program to add the options to.
- * @param supportsLang Whether the CLI supports different languages.
- * @param supportsEnvFiles Whether the CLI supports loading env files
- */
-function addGlobalOptions(program, supportsLang, supportsEnvFiles) {
-    if (supportsLang) {
-        program.option(core.I18n.formatMessage("cli.options.lang.param"), core.I18n.formatMessage("cli.options.lang.description"), "en");
-    }
-    if (supportsEnvFiles) {
-        program.option(core.I18n.formatMessage("cli.options.load-env.param"), core.I18n.formatMessage("cli.options.load-env.description"));
-    }
-}
-/**
- * Handle the global options.
- * @param command The command to use for context.
- * @internal
- */
-function handleGlobalOptions(command) {
-    const globalOpts = command.optsWithGlobals();
-    if (core.Is.stringValue(globalOpts?.lang)) {
-        initLocales(globalOpts.lang);
-    }
-    const loadEnv = globalOpts?.loadEnv;
-    if (core.Is.arrayValue(loadEnv)) {
-        const resolvedEnv = loadEnv.map(e => path.resolve(e));
-        CLIDisplay.task(core.I18n.formatMessage("cli.progress.loadingEnvFiles"), resolvedEnv.join(", "));
-        CLIDisplay.break();
-        dotenv__namespace.config({ path: resolvedEnv, quiet: true });
-    }
-}
-/**
- * Initialize the locales for the CLI.
- * @param locale The locale to use.
- * @internal
- */
-function initLocales(locale) {
-    const localePath = path.join(localesDir, `${locale}.json`);
-    const localeContent = CLIUtils.readJsonFileSync(localePath);
-    if (core.Is.objectValue(localeContent)) {
-        core.I18n.addDictionary(locale, localeContent);
-        core.I18n.setLocale(locale);
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * The main entry point for the CLI.
- */
-class CLIBase {
-    /**
-     * Execute the command line processing.
-     * @param options The options for the CLI.
-     * @param localesDirectory The path to load the locales from.
-     * @param argv The process arguments.
-     * @returns The exit code.
-     */
-    async execute(options, localesDirectory, argv) {
-        initGlobalOptions(localesDirectory);
-        initLocales("en");
-        try {
-            process.title = options.title;
-            if (!argv.includes("--version") && !argv.includes("-v")) {
-                CLIDisplay.header(options.title, options.version, options.icon);
-            }
-            const program = new commander.Command();
-            let outputWidth = options.overrideOutputWidth;
-            let outputErrWidth = options.overrideOutputWidth;
-            if (core.Is.undefined(outputWidth) && process.stdout.isTTY) {
-                outputWidth = process.stdout.columns;
-                outputErrWidth = process.stderr.columns;
-            }
-            program
-                .name(options.appName)
-                .version(options.version)
-                .usage("[command]")
-                .showHelpAfterError()
-                .configureOutput({
-                writeOut: str => CLIDisplay.write(str),
-                writeErr: str => CLIDisplay.writeError(str),
-                getOutHelpWidth: () => outputWidth,
-                getErrHelpWidth: () => outputErrWidth,
-                outputError: (str, write) => CLIDisplay.error(str.replace(/^error: /, ""), false)
-            })
-                .exitOverride(err => {
-                // By default commander still calls process.exit on exit
-                // which we don't want as we might have subsequent
-                // processing to handle, so instead we throw the exit code
-                // as a way to skip the process.exit call.
-                // If the error code is commander.help then we return 0 as
-                // we don't want displaying help to be an error.
-                // eslint-disable-next-line no-restricted-syntax
-                throw new Error(err.code === "commander.help" ? "0" : err.exitCode.toString());
-            });
-            if (options.showDevToolWarning ?? false) {
-                program.hook("preAction", () => CLIDisplay.warning(core.I18n.formatMessage("warn.common.devOnlyTool")));
-            }
-            this.configureRoot(program);
-            addGlobalOptions(program, options.supportsLang ?? true, options.supportsEnvFiles ?? false);
-            // We parse the options before building the command
-            // in case the language has been set, then the
-            // help for the options will be in the correct language.
-            program.parseOptions(argv);
-            handleGlobalOptions(program);
-            const commandCount = this.buildCommands(program);
-            if (commandCount === 0) {
-                program.usage(" ");
-            }
-            await program.parseAsync(argv);
-        }
-        catch (error) {
-            CLIDisplay.spinnerStop();
-            let exitCode;
-            if (error instanceof Error) {
-                // This error could be the exit code we errored with
-                // from the exitOverride so parse and resolve with it
-                exitCode = core.Coerce.number(error.message);
-            }
-            if (core.Is.integer(exitCode)) {
-                return exitCode;
-            }
-            CLIDisplay.error(error);
-            return 1;
-        }
-        return 0;
-    }
-    /**
-     * Configure any options or actions at the root program level.
-     * @param program The root program command.
-     */
-    configureRoot(program) {
-        program.action(() => {
-            program.help();
-        });
-    }
-    /**
-     * Get the commands for the CLI, override in derived class to supply your own.
-     * @param program The main program that the commands will be added to.
-     * @returns The commands for the CLI.
-     */
-    getCommands(program) {
-        return [];
-    }
-    /**
-     * Build the commands for the CLI.
-     * @param program The main program that the commands are added to.
-     * @returns The number of commands added.
-     * @internal
-     */
-    buildCommands(program) {
-        const commands = this.getCommands(program);
-        for (const command of commands) {
-            program.addCommand(command.copyInheritedSettings(program));
-        }
-        return commands.length;
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Utilities for getting standard options.
- */
-class CLIOptions {
-    /**
-     * Get the options for output.
-     * @param command The command to add the options to.
-     * @param opts The options of what to include.
-     * @param opts.noConsole Do not output to the console.
-     * @param opts.json Output to a JSON file.
-     * @param opts.env Output to an environment file.
-     * @param opts.mergeJson Merge existing JSON file.
-     * @param opts.mergeEnv Merge existing environment file.
-     */
-    static output(command, opts) {
-        if (opts.noConsole) {
-            command.option(core.I18n.formatMessage("cli.options.no-console.param"), core.I18n.formatMessage("cli.options.no-console.description"));
-        }
-        if (opts.json) {
-            command.option(core.I18n.formatMessage("cli.options.json.param"), core.I18n.formatMessage("cli.options.json.description"));
-        }
-        if (opts.mergeJson) {
-            command.option(core.I18n.formatMessage("cli.options.merge-json.param"), core.I18n.formatMessage("cli.options.merge-json.description"));
-        }
-        if (opts.env) {
-            command.option(core.I18n.formatMessage("cli.options.env.param"), core.I18n.formatMessage("cli.options.env.description"));
-        }
-        if (opts.mergeEnv) {
-            command.option(core.I18n.formatMessage("cli.options.merge-env.param"), core.I18n.formatMessage("cli.options.merge-env.description"));
-        }
-    }
-}
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Parameter utilities for the CLI.
- */
-class CLIParam {
-    /**
-     * Check the option to see if it exists.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static env(optionName, optionValue, allowEnvVar) {
-        if (allowEnvVar && optionValue?.startsWith("!")) {
-            const envValueName = optionValue.slice(1);
-            const envValue = process.env[envValueName];
-            if (core.Is.empty(envValue)) {
-                throw new core.GeneralError("commands", "commands.common.missingEnv", {
-                    option: optionName,
-                    value: envValueName
-                });
-            }
-            else {
-                optionValue = envValue;
-            }
-        }
-        return optionValue;
-    }
-    /**
-     * Check the option to see if the String exists.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static stringValue(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        core.Guards.stringValue("commands", optionName, optionValue);
-        return optionValue;
-    }
-    /**
-     * Check the option to see if it is a url.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static url(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        core.Url.guard("commands", optionName, optionValue);
-        return optionValue;
-    }
-    /**
-     * Check the option to see if it exists and is a number.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @param minValue The minimum value.
-     * @param maxValue The maximum value.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static number(optionName, optionValue, allowEnvVar = true, minValue = 0, maxValue) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        const coerced = core.Coerce.number(optionValue);
-        if (core.Is.number(coerced)) {
-            if (core.Is.number(minValue) && coerced < minValue) {
-                throw new core.GeneralError("commands", "commands.common.optionMinValue", {
-                    option: optionName,
-                    value: optionValue,
-                    minValue
-                });
-            }
-            else if (core.Is.number(maxValue) && coerced > maxValue) {
-                throw new core.GeneralError("commands", "commands.common.optionMaxValue", {
-                    option: optionName,
-                    value: optionValue,
-                    maxValue
-                });
-            }
-            return coerced;
-        }
-        core.Guards.number("commands", optionName, optionValue);
-        return 0;
-    }
-    /**
-     * Check the option to see if it exists and is an integer.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @param minValue The minimum value.
-     * @param maxValue The maximum value.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static integer(optionName, optionValue, allowEnvVar = true, minValue = 0, maxValue) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        const coerced = core.Coerce.number(optionValue);
-        if (core.Is.integer(coerced)) {
-            if (core.Is.number(minValue) && coerced < minValue) {
-                throw new core.GeneralError("commands", "commands.common.optionMinValue", {
-                    option: optionName,
-                    value: optionValue,
-                    minValue
-                });
-            }
-            else if (core.Is.number(maxValue) && coerced > maxValue) {
-                throw new core.GeneralError("commands", "commands.common.optionMaxValue", {
-                    option: optionName,
-                    value: optionValue,
-                    maxValue
-                });
-            }
-            return coerced;
-        }
-        core.Guards.integer("commands", optionName, optionValue);
-        return 0;
-    }
-    /**
-     * Check the option to see if it exists and is a big number.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @param minValue The minimum value.
-     * @param maxValue The maximum value.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static bigint(optionName, optionValue, allowEnvVar = true, minValue = 0n, maxValue) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        const coerced = core.Coerce.bigint(optionValue);
-        if (core.Is.bigint(coerced)) {
-            if (core.Is.bigint(minValue) && coerced < minValue) {
-                throw new core.GeneralError("commands", "commands.common.optionMinValue", {
-                    option: optionName,
-                    value: optionValue,
-                    minValue
-                });
-            }
-            else if (core.Is.bigint(maxValue) && coerced > maxValue) {
-                throw new core.GeneralError("commands", "commands.common.optionMaxValue", {
-                    option: optionName,
-                    value: optionValue,
-                    maxValue
-                });
-            }
-            return coerced;
-        }
-        core.Guards.bigint("commands", optionName, optionValue);
-        return 0n;
-    }
-    /**
-     * Check the option to see if it exists and is a boolean.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static boolean(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        const coerced = core.Coerce.boolean(optionValue);
-        if (core.Is.boolean(coerced)) {
-            return coerced;
-        }
-        core.Guards.boolean("commands", optionName, optionValue);
-        return false;
-    }
-    /**
-     * Check the option to see if it exists and is hex.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static hex(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        if (core.Is.stringHex(optionValue, true)) {
-            return core.Converter.hexToBytes(optionValue);
-        }
-        throw new core.GeneralError("commands", "commands.common.optionInvalidHex", {
-            option: optionName,
-            value: optionValue
-        });
-    }
-    /**
-     * Check the option to see if it exists and is base64.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static base64(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        if (core.Is.stringBase64(optionValue)) {
-            return core.Converter.base64ToBytes(optionValue);
-        }
-        throw new core.GeneralError("commands", "commands.common.optionInvalidBase64", {
-            option: optionName,
-            value: optionValue
-        });
-    }
-    /**
-     * Check the option to see if it exists and is hex or base64.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static hexBase64(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        if (core.Is.stringHex(optionValue, true)) {
-            return core.Converter.hexToBytes(optionValue);
-        }
-        else if (core.Is.stringBase64(optionValue)) {
-            return core.Converter.base64ToBytes(optionValue);
-        }
-        throw new core.GeneralError("commands", "commands.common.optionInvalidHexBase64", {
-            option: optionName,
-            value: optionValue
-        });
-    }
-    /**
-     * Check the option to see if it exists and is bech32.
-     * @param optionName The name of the option.
-     * @param optionValue The option value.
-     * @param allowEnvVar Allow the option to be read from an env var.
-     * @returns The final option value.
-     * @throws An error if the option is invalid.
-     */
-    static bech32(optionName, optionValue, allowEnvVar = true) {
-        optionValue = CLIParam.env(optionName, optionValue, allowEnvVar);
-        if (crypto.Bech32.isBech32(optionValue)) {
-            return optionValue;
-        }
-        throw new core.GeneralError("commands", "commands.common.optionInvalidBech32", {
-            option: optionName,
-            value: optionValue
-        });
-    }
-}
-
-exports.CLIBase = CLIBase;
-exports.CLIDisplay = CLIDisplay;
-exports.CLIOptions = CLIOptions;
-exports.CLIParam = CLIParam;
-exports.CLIUtils = CLIUtils;
-exports.addGlobalOptions = addGlobalOptions;
-exports.handleGlobalOptions = handleGlobalOptions;
-exports.initGlobalOptions = initGlobalOptions;
-exports.initLocales = initLocales;