@breadstone-infrastructure/utilities 0.0.12-beta.0

package/Cli/Interfaces/IProgramCommands.d.ts

@@ -0,0 +1,47 @@
+import type { IType } from '../../System/Interfaces/IType';
+import type { ProgramCommandResult } from '../ProgramCommandResult';
+import type { IProgramCommand } from './IProgramCommand';
+/**
+ * Represents the program commands.
+ *
+ * @public
+ */
+export interface IProgramCommands {
+    /**
+     * Registers a new command.
+     *
+     * @public
+     * @param commandName - The command name.
+     * @param commandType - The command type to register.
+     * @param commandInstanceFactory - The optional factory to instaiate the command.
+     */
+    register<TCommand extends IType<IProgramCommand>>(commandName: string, commandType: TCommand, commandInstanceFactory?: () => ConstructorParameters<TCommand>): this;
+    /**
+     * Initalizes all commands.
+     *
+     * @public
+     * @param command - The optional command to parse.
+     */
+    initalize(command?: string): Promise<void>;
+    /**
+     * Executes all commands.
+     *
+     * @public
+     */
+    execute(): Promise<ProgramCommandResult>;
+    /**
+     * Parses the command from argv.
+     *
+     * @public
+     * @param command - The optional command to parse.
+     * @param args - The optional arguments to parse.
+     */
+    parse(command?: string, args?: Array<string>): void;
+    /**
+     * Disposes all commands.
+     *
+     * @public
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=IProgramCommands.d.ts.map

package/Cli/Interfaces/IProgramCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgramCommands.d.ts","sourceRoot":"","sources":["../../../src/Cli/Interfaces/IProgramCommands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAI7B;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,SAAS,KAAK,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,sBAAsB,CAAC,EAAE,MAAM,qBAAqB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAEpK;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAI5B"}

package/Cli/Interfaces/IProgramCommands.js

@@ -0,0 +1,4 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProgramCommands.js.map

package/Cli/Interfaces/IProgramCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgramCommands.js","sourceRoot":"","sources":["../../../src/Cli/Interfaces/IProgramCommands.ts"],"names":[],"mappings":";AAAA,kBAAkB"}

package/Cli/Interfaces/IProgramConfig.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Represents the program configuration.
+ *
+ * @public
+ */
+export interface IProgramConfig<TConfig extends Record<string, unknown>> {
+    readonly config: TConfig | undefined;
+    assign(value?: Partial<TConfig>): TConfig;
+}
+//# sourceMappingURL=IProgramConfig.d.ts.map

package/Cli/Interfaces/IProgramConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgramConfig.d.ts","sourceRoot":"","sources":["../../../src/Cli/Interfaces/IProgramConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnE,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAErC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAE7C"}

package/Cli/Interfaces/IProgramConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProgramConfig.js.map

package/Cli/Interfaces/IProgramConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgramConfig.js","sourceRoot":"","sources":["../../../src/Cli/Interfaces/IProgramConfig.ts"],"names":[],"mappings":""}

package/Cli/Interfaces/IProgramInit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @public
+ */
+export interface IProgramInit {
+    description?: string;
+    epilog?: string;
+    addHelp?: boolean;
+    prefixChars?: string;
+    prog?: string;
+    usage?: string;
+    version?: string;
+    debug?: boolean;
+}
+//# sourceMappingURL=IProgramInit.d.ts.map

package/Cli/Interfaces/IProgramInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgramInit.d.ts","sourceRoot":"","sources":["../../../src/Cli/Interfaces/IProgramInit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAIzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,KAAK,CAAC,EAAE,OAAO,CAAC;CAInB"}

package/Cli/Interfaces/IProgramInit.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProgramInit.js.map

package/Cli/Interfaces/IProgramInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgramInit.js","sourceRoot":"","sources":["../../../src/Cli/Interfaces/IProgramInit.ts"],"names":[],"mappings":""}

package/Cli/Program.d.ts

@@ -0,0 +1,97 @@
+import type { IProgramArgs } from './Interfaces/IProgramArgs';
+import type { IProgramCommands } from './Interfaces/IProgramCommands';
+import type { IProgramInit } from './Interfaces/IProgramInit';
+import { ProgramConfig } from './ProgramConfig';
+import type { ProgramDoneFn } from './ProgramDoneFn';
+/**
+ * A abstract class for node.js cli's
+ *
+ * @public
+ * @abstract
+ */
+export declare abstract class Program<TConfig extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly _programmCommands;
+    private readonly _programmArgs;
+    private readonly _programmConfig;
+    private readonly _parser;
+    /**
+     * Creates an instance of program.
+     *
+     * @protected
+     */
+    protected constructor(init?: IProgramInit, commands?: IProgramCommands, args?: IProgramArgs);
+    /**
+     * Returns the program configuration.
+     *
+     * @public
+     * @readonly
+     */
+    get config(): ProgramConfig<TConfig>;
+    /**
+     * Returns the program commands.
+     *
+     * @public
+     * @readonly
+     */
+    get commands(): IProgramCommands;
+    /**
+     * Returns the program arguments.
+     *
+     * @public
+     * @readonly
+     */
+    get args(): IProgramArgs;
+    exit(code?: number): never;
+    /**
+     * The method parse all arguments form outside.
+     * After this method, all arguments should be presented.
+     *
+     * @public
+     * @virtual
+     * @returns {Program} The program instance
+     */
+    init(): Promise<this>;
+    /**
+     * The method observes errors an starts the process.
+     *
+     * @public
+     * @virtual
+     * @returns {Promise<number>} The process exit code.
+     */
+    run(): Promise<number>;
+    /**
+     * The abstract method will called after the run method
+     * This method should include your bussines logic
+     *
+     * @ignore
+     * @protected
+     * @virtual
+     * @param {ProgramDoneFn} done The done callback
+     * @returns {Promise<number>} The result code.
+     */
+    protected process(done: ProgramDoneFn): Promise<number>;
+    /**
+     * @ignore
+     * @protected
+     * @virtual
+     * @param {Error} error The error
+     * @param {string} stderr The stderr
+     * @returns {void}
+     */
+    protected onError(error: Error | null, stderr?: string, startedAt?: number): void;
+    /**
+     * @ignore
+     * @protected
+     * @virtual
+     * @param {string} stdout The stdout
+     * @returns {void}
+     */
+    protected onSuccess(stdout: string, startedAt: number): void;
+    /**
+     * Extract the command form argv.
+     *
+     * @private
+     */
+    private firstArgType;
+}
+//# sourceMappingURL=Program.d.ts.map

package/Cli/Program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Program.d.ts","sourceRoot":"","sources":["../../src/Cli/Program.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD;;;;;GAKG;AACH,8BAAsB,OAAO,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI3F,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAMzC;;;;OAIG;IACH,SAAS,aAAa,IAAI,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,YAAY;IAoB3F;;;;;OAKG;IACH,IAAW,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,CAE1C;IAED;;;;;OAKG;IACH,IAAW,QAAQ,IAAI,gBAAgB,CAEtC;IAED;;;;;OAKG;IACH,IAAW,IAAI,IAAI,YAAY,CAE9B;IAMM,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK;IAIjC;;;;;;;OAOG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BlC;;;;;;OAMG;IACU,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAcnC;;;;;;;;;OASG;cACa,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7D;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAajF;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAa5D;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAmBvB"}

package/Cli/Program.js

@@ -0,0 +1,217 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Program = void 0;
+const argparse_1 = require("argparse");
+const String_1 = require("../System/String");
+const Time_1 = require("../System/Time");
+const TerminalColors_1 = require("../Terminal/TerminalColors");
+const TerminalSymbols_1 = require("../Terminal/TerminalSymbols");
+const ProgramArgs_1 = require("./ProgramArgs");
+const ProgramCommands_1 = require("./ProgramCommands");
+const ProgramConfig_1 = require("./ProgramConfig");
+// #endregion
+/**
+ * A abstract class for node.js cli's
+ *
+ * @public
+ * @abstract
+ */
+class Program {
+    // #region Fields
+    _programmCommands;
+    _programmArgs;
+    _programmConfig;
+    _parser;
+    // #endregion
+    // #region Ctor
+    /**
+     * Creates an instance of program.
+     *
+     * @protected
+     */
+    constructor(init, commands, args) {
+        this._programmConfig = new ProgramConfig_1.ProgramConfig();
+        this._programmCommands = commands ?? new ProgramCommands_1.ProgramCommands(init);
+        this._programmArgs = args ?? new ProgramArgs_1.ProgramArgs();
+        this._parser = new argparse_1.ArgumentParser({
+            description: init?.description,
+            epilog: init?.epilog,
+            // eslint-disable-next-line camelcase
+            add_help: init?.addHelp,
+            // eslint-disable-next-line camelcase
+            prefix_chars: init?.prefixChars ?? '-',
+            prog: init?.prog,
+            usage: init?.usage
+        });
+    }
+    // #endregion
+    // #region Properties
+    /**
+     * Returns the program configuration.
+     *
+     * @public
+     * @readonly
+     */
+    get config() {
+        return this._programmConfig;
+    }
+    /**
+     * Returns the program commands.
+     *
+     * @public
+     * @readonly
+     */
+    get commands() {
+        return this._programmCommands;
+    }
+    /**
+     * Returns the program arguments.
+     *
+     * @public
+     * @readonly
+     */
+    get args() {
+        return this._programmArgs;
+    }
+    // #endregion
+    // #region Methods
+    exit(code) {
+        process.exit(code);
+    }
+    /**
+     * The method parse all arguments form outside.
+     * After this method, all arguments should be presented.
+     *
+     * @public
+     * @virtual
+     * @returns {Program} The program instance
+     */
+    async init() {
+        process.on('uncaughtException', (error) => {
+            this.onError(error);
+        });
+        process.on('unhandledRejection', (event) => {
+            this.onError(event);
+        });
+        if (this.firstArgType() === 'cmd') {
+            await this.commands.initalize();
+            this.commands.parse();
+        }
+        else {
+            // If a command is present, the program args not needed.
+            // Ensure that the program args already defined in the command args.
+            this.args.options.forEach((x) => {
+                if (typeof x.alias === 'string') {
+                    this._parser.add_argument(x.alias, x.options);
+                }
+                else {
+                    this._parser.add_argument(x.alias[0], x.alias[1], x.options);
+                }
+            });
+            const parsedArgs = this._parser.parse_args(process.argv);
+            this.config.assign(parsedArgs);
+        }
+        return this;
+    }
+    /**
+     * The method observes errors an starts the process.
+     *
+     * @public
+     * @virtual
+     * @returns {Promise<number>} The process exit code.
+     */
+    async run() {
+        const startedAt = Date.now();
+        return this.process((error, stdout, stderr) => {
+            if (error || stderr) {
+                this.onError(error, stderr, startedAt);
+                this.exit(1);
+            }
+            else {
+                this.onSuccess(stdout, startedAt);
+                this.exit(0);
+            }
+        });
+    }
+    /**
+     * The abstract method will called after the run method
+     * This method should include your bussines logic
+     *
+     * @ignore
+     * @protected
+     * @virtual
+     * @param {ProgramDoneFn} done The done callback
+     * @returns {Promise<number>} The result code.
+     */
+    async process(done) {
+        if (this.firstArgType() === 'cmd') {
+            const result = await this.commands.execute();
+            if (result.canceled && result.error.code !== 0) {
+                done(result.error, '', result.error.message);
+                return result.error.code ?? 1;
+            }
+        }
+        done(null, '', '');
+        return 0;
+    }
+    /**
+     * @ignore
+     * @protected
+     * @virtual
+     * @param {Error} error The error
+     * @param {string} stderr The stderr
+     * @returns {void}
+     */
+    onError(error, stderr, startedAt) {
+        const msg = stderr ?? error?.message ?? '';
+        if (msg) {
+            console.error(`${TerminalSymbols_1.TerminalSymbols.error} ${TerminalColors_1.TerminalColors.from(msg, 'red').toString()}`);
+        }
+        if (startedAt) {
+            console.error(`${String_1.StringExtensions.newLine}${String_1.StringExtensions.newLine}${TerminalSymbols_1.TerminalSymbols.error} ${TerminalColors_1.TerminalColors.from('Done.', 'red').toString()} ${TerminalColors_1.TerminalColors.from(`in ${Time_1.Time.humanize(Date.now() - startedAt)}s`, 'gray').toString()}`);
+        }
+        else {
+            console.error(`${String_1.StringExtensions.newLine}${String_1.StringExtensions.newLine}${TerminalSymbols_1.TerminalSymbols.error} ${TerminalColors_1.TerminalColors.from('Done.', 'red').toString()}`);
+        }
+    }
+    /**
+     * @ignore
+     * @protected
+     * @virtual
+     * @param {string} stdout The stdout
+     * @returns {void}
+     */
+    onSuccess(stdout, startedAt) {
+        const msg = stdout;
+        if (msg) {
+            console.info(`${TerminalSymbols_1.TerminalSymbols.success} ${TerminalColors_1.TerminalColors.from(msg, 'green').toString()}`);
+        }
+        if (startedAt) {
+            console.info(`${String_1.StringExtensions.newLine}${String_1.StringExtensions.newLine}${TerminalSymbols_1.TerminalSymbols.success} ${TerminalColors_1.TerminalColors.from('Done.', 'green').toString()} ${TerminalColors_1.TerminalColors.from(`in ${Time_1.Time.humanize(Date.now() - startedAt)}s`, 'gray').toString()}`);
+        }
+        else {
+            console.info(`${String_1.StringExtensions.newLine}${String_1.StringExtensions.newLine}${TerminalSymbols_1.TerminalSymbols.success} ${TerminalColors_1.TerminalColors.from('Done.', 'green').toString()}`);
+        }
+    }
+    /**
+     * Extract the command form argv.
+     *
+     * @private
+     */
+    firstArgType() {
+        const command = process.argv
+            .slice(2)
+            .splice(0, 1)
+            .join();
+        if (command !== '' && !command.startsWith('-')) {
+            return 'cmd';
+        }
+        if (command !== '' && command.startsWith('-')) {
+            return 'param';
+        }
+        return 'none';
+    }
+}
+exports.Program = Program;
+//# sourceMappingURL=Program.js.map

package/Cli/Program.js.map

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

package/Cli/ProgramArgs.d.ts

@@ -0,0 +1,39 @@
+import type { IProgramArg } from './Interfaces/IProgramArg';
+import type { IProgramArgs } from './Interfaces/IProgramArgs';
+import type { IProgramArgOptions } from './Interfaces/IProgramArgOptions';
+interface IProgrammOption {
+    alias: string | [string, string];
+    options: IProgramArgOptions;
+}
+/**
+ * @private
+ */
+export declare class ProgramArgs implements IProgramArgs {
+    private readonly _argOptions;
+    /**
+     * Constructs a new instance of the `ProgramArgs` class.
+     *
+     * @public
+     */
+    constructor();
+    /**
+     * Returns the all registered options.
+     *
+     * @public
+     * @readonly
+     */
+    get options(): Array<IProgrammOption>;
+    /**
+     * Registers a new argument.
+     *
+     * @public
+     * @param args - The arguments to register.
+     */
+    register(...args: Array<IProgramArg>): this;
+    /**
+     * @public
+     */
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=ProgramArgs.d.ts.map

package/Cli/ProgramArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramArgs.d.ts","sourceRoot":"","sources":["../../src/Cli/ProgramArgs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAI1E,UAAU,eAAe;IACrB,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,kBAAkB,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAI5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAMrD;;;;OAIG;;IASH;;;;;OAKG;IACH,IAAW,OAAO,IAAI,KAAK,CAAC,eAAe,CAAC,CAE3C;IAMD;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI;IAQlD;;OAEG;IACI,QAAQ,IAAI,MAAM;CAkC5B"}

package/Cli/ProgramArgs.js

@@ -0,0 +1,83 @@
+"use strict";
+/* eslint-disable @typescript-eslint/switch-exhaustiveness-check */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgramArgs = void 0;
+// #region Imports
+const String_1 = require("../System/String");
+/**
+ * @private
+ */
+class ProgramArgs {
+    // #region Fields
+    _argOptions;
+    // #endregion
+    // #region Ctor
+    /**
+     * Constructs a new instance of the `ProgramArgs` class.
+     *
+     * @public
+     */
+    constructor() {
+        this._argOptions = [];
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Returns the all registered options.
+     *
+     * @public
+     * @readonly
+     */
+    get options() {
+        return this._argOptions;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Registers a new argument.
+     *
+     * @public
+     * @param args - The arguments to register.
+     */
+    register(...args) {
+        args.forEach((arg) => this._argOptions.push({
+            alias: arg.alias,
+            options: arg.options
+        }));
+        return this;
+    }
+    /**
+     * @public
+     */
+    toString() {
+        // @ts-ignore fix suppressImplicitAnyIndexErrors
+        const argumentKeys = this._argOptions.map((x) => x[0] ? x[0].pop() : '').map((x) => String_1.StringExtensions.firstCharToLowerCase((x ?? '').replace('--', '-')));
+        // @ts-ignore fix suppressImplicitAnyIndexErrors
+        const argumentOptions = this._argOptions.map((x) => x[1]);
+        const propertyKeys = argumentKeys.map((x) => String_1.StringExtensions.firstCharToLowerCase(x.replace('-', '')));
+        const argumentPropertyMapping = new Map();
+        // @ts-ignore fix suppressImplicitAnyIndexErrors
+        argumentKeys.forEach((_, i) => argumentPropertyMapping.set(argumentKeys[i], this[propertyKeys[i]]));
+        const argumentPropertyString = Array.from(argumentPropertyMapping.entries()).map((x, i) => {
+            const option = argumentOptions[i];
+            if (option) {
+                switch (typeof x[1]) {
+                    case 'string':
+                        return x[1] !== '' ? `${x[0]} ${x[1]}` : '';
+                    case 'boolean':
+                        return x[1] ? x[0] : '';
+                    case 'number':
+                        return x[1] > 0 ? `${x[0]} ${x[1]}` : '';
+                    case 'object':
+                        return JSON.stringify(x[1]);
+                    default:
+                        throw new Error(`Invalid argument type '${String(x[1])}'.`);
+                }
+            }
+            throw new Error();
+        });
+        return argumentPropertyString.join(' ');
+    }
+}
+exports.ProgramArgs = ProgramArgs;
+//# sourceMappingURL=ProgramArgs.js.map

package/Cli/ProgramArgs.js.map

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

package/Cli/ProgramCommandResult.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @public
+ */
+export type ProgramCommandResult<TResult = unknown> = {
+    canceled: true;
+    error: Error & {
+        code?: number;
+    };
+} | {
+    canceled: false;
+    result: TResult;
+};
+//# sourceMappingURL=ProgramCommandResult.d.ts.map

package/Cli/ProgramCommandResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramCommandResult.d.ts","sourceRoot":"","sources":["../../src/Cli/ProgramCommandResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,OAAO,GAAG,OAAO,IAAM;IACpD,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC,GAAG;IACA,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC"}

package/Cli/ProgramCommandResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ProgramCommandResult.js.map

package/Cli/ProgramCommandResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgramCommandResult.js","sourceRoot":"","sources":["../../src/Cli/ProgramCommandResult.ts"],"names":[],"mappings":""}

package/Cli/ProgramCommands.d.ts

@@ -0,0 +1,66 @@
+import type { IType } from '../System/Interfaces/IType';
+import type { IProgramCommand } from './Interfaces/IProgramCommand';
+import type { IProgramCommands } from './Interfaces/IProgramCommands';
+import type { IProgramInit } from './Interfaces/IProgramInit';
+import type { ProgramCommandResult } from './ProgramCommandResult';
+/**
+ * @private
+ */
+export declare class ProgramCommands implements IProgramCommands {
+    private readonly _commandTypes;
+    private readonly _commandInstances;
+    private readonly _parser;
+    private _currentCommand;
+    private _currentArgs;
+    /**
+     * Constructs a new instance of the `ProgramCommands` class.
+     *
+     * @public
+     */
+    constructor(init?: IProgramInit);
+    /**
+     * Register a command.
+     *
+     * @public
+     * @param commandName - The command name.
+     * @param commandType - The command type to register.
+     * @param commandInstanceFactory - The optional factory to instaiate the command.
+     */
+    register<TCommand extends IType<IProgramCommand>>(commandName: string, commandType: TCommand, commandInstanceFactory?: () => ConstructorParameters<TCommand>): this;
+    /**
+     * Initalize a command.
+     *
+     * @public
+     * @param command - The optional command to parse.
+     */
+    initalize(command?: string): Promise<void>;
+    /**
+     * Parse the command from argv.
+     *
+     * @public
+     * @param command - The optional command to parse.
+     * @param args - The optional arguments to parse.
+     */
+    parse(command?: string, args?: Array<string>): void;
+    /**
+     * Execute a command.
+     *
+     * @public
+     */
+    execute(): Promise<ProgramCommandResult>;
+    /**
+     * Dispose a command.
+     *
+     * @public
+     */
+    dispose(): Promise<void>;
+    private ensureCommand;
+}
+/**
+ * Converts object keys from snake_case to camelCase.
+ *
+ * @param obj - The object to be converted.
+ * @returns A new object with camelCase keys.
+ */
+export declare function convertKeysToCamelCase(obj: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=ProgramCommands.d.ts.map