@futdevpro/nts-dynamo 1.15.306 → 1.15.308

package/build/_modules/cli/_services/cli-program.control-service.d.ts

@@ -0,0 +1,106 @@
+import type * as Commander from 'commander';
+import { DyCLI_Command_Params, DyCLI_CommandValues } from '../_models/control-models/cli-command-params.control-model';
+import { DyCLI_CommonOptions } from '../_models/interfaces/cli-common-options.interface';
+import { DyCLI_Settings } from '../_models/interfaces/cli-settings.interface';
+/** Where the program writes (injectable for specs). */
+export interface DyCLI_ProgramIo {
+    /** Writes to stdout. */
+    stdout(text: string): void;
+    /** Writes to stderr. */
+    stderr(text: string): void;
+}
+/** Calls the server operation of a generated command (the MCP client of HP-DOPL MP-4.5 / MP-4.6). */
+export type DyCLI_OperationCaller = (params: DyCLI_Command_Params, values: DyCLI_CommandValues, common: DyCLI_CommonOptions) => Promise<unknown>;
+/**
+ * The commander program of a Dynamo CLI (HP-DOPL MP-4.3 + MP-4.4): the skeleton the fleet CLIs repeat by hand
+ * (`name / description / version / addHelpText / parse`), the common options, and ONE execution path per command —
+ * `before` → own `action` or the server call → `after` → the `fo` result envelope and the exit code.
+ *
+ * - Success: the envelope on stdout (or the `formatHuman` text when the command's output is `human` and no `--json`).
+ * - Failure: the envelope on stderr (or `<command>: <code>: <message>`), exit code by `DyCLI_Command_Params.exitCodeOf`.
+ * - An argument error (unknown option, invalid value, missing required flag): the `cli.parse` envelope, exit `usage`;
+ *   `--help` / `--version` exit 0.
+ * - `run()` RETURNS the exit code and never calls `process.exit` — `process.exitCode = await program.run()`.
+ *
+ * `build()` gives the commander program before parsing, so `registerDynamoCommands(program, version)` of
+ * `@futdevpro/cli-dynamo` can still be called on it (or pass it as `configure`).
+ *
+ * @example
+ * ```ts
+ * const cli: DyCLI_Program_ControlService = new DyCLI_Program_ControlService({
+ *   name: 'fo', description: 'Organizer CLI', version: '2.0.0',
+ *   commands: [ listTasks, backup ],
+ *   callOperation: mcpCaller,                              // generated commands call the server through MCP
+ * });
+ *
+ * process.exitCode = await cli.run();
+ * ```
+ */
+export declare class DyCLI_Program_ControlService {
+    /** The program name (the binary). */
+    readonly name: string;
+    /** The program description. */
+    readonly description: string;
+    /** The program version (`-v, --version`). */
+    readonly version: string;
+    /** The commands. */
+    readonly commands: DyCLI_Command_Params[];
+    /** Extra help text after the command list. */
+    readonly helpText?: string;
+    /** The exit code of the last command run through this program. */
+    private lastExitCode;
+    private readonly callOperation?;
+    private readonly configure?;
+    private readonly settings;
+    private readonly io;
+    /**
+     * @param set - the program settings; throws a coded `DyFM_Error` (500 `DyNTS-CLI-*`) when invalid
+     */
+    constructor(set: {
+        name: string;
+        description: string;
+        version: string;
+        commands: DyCLI_Command_Params[];
+        helpText?: string;
+        callOperation?: DyCLI_OperationCaller;
+        configure?(program: Commander.Command): void | Promise<void>;
+        settings?: DyCLI_Settings | null;
+        io?: DyCLI_ProgramIo;
+    });
+    /**
+     * Builds the commander program with every command and its common options; nothing is parsed yet.
+     * @throws 501 `DyNTS-OPT-MIS` when `commander` is not installed
+     */
+    build(): Promise<Commander.Command>;
+    /**
+     * Parses the command line and runs the command.
+     * @param argv - the full argv (default: `process.argv`)
+     * @returns the exit code — set it as `process.exitCode`
+     */
+    run(argv?: string[]): Promise<number>;
+    /**
+     * Runs one command: `before` → `action` or the server call → `after`, then writes the envelope.
+     * @param params - the command
+     * @param values - the collected flag values
+     * @param common - the common options
+     * @returns the exit code
+     */
+    execute(params: DyCLI_Command_Params, values: DyCLI_CommandValues, common: DyCLI_CommonOptions): Promise<number>;
+    /** Calls the operation of a generated command through the configured caller. */
+    private callServer;
+    /**
+     * Adds the common options a command does not already have (a command flag of the same name wins).
+     * @returns the added long flags
+     */
+    private addCommonOptions;
+    /** The exit code of a commander argument error: the `usage` code of the settings (a command override does not apply). */
+    private exitCodeOfParse;
+    /**
+     * The common options from the parsed commander options — only the ones the program added to this command, so a
+     * command's own flag of the same name (e.g. the `dryRun` guardrail argument) stays a value, not a common option.
+     * @param options - the parsed options (`command.opts()`)
+     * @param added - the long flags of the common options added to the command
+     */
+    private static commonOf;
+}
+//# sourceMappingURL=cli-program.control-service.d.ts.map

package/build/_modules/cli/_services/cli-program.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-program.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_services/cli-program.control-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,SAAS,MAAM,WAAW,CAAC;AAW5C,OAAO,EACL,oBAAoB,EAAE,mBAAmB,EAC1C,MAAM,4DAA4D,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AAGzF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAG9E,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wBAAwB;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qGAAqG;AACrG,MAAM,MAAM,qBAAqB,GAAG,CAClC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,KACnF,OAAO,CAAC,OAAO,CAAC,CAAC;AAOtB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,4BAA4B;IACvC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAC1C,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,kEAAkE;IAClE,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAuD;IAClF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAkB;IAErC;;OAEG;gBACS,GAAG,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,qBAAqB,CAAC;QACtC,SAAS,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;QACjC,EAAE,CAAC,EAAE,eAAe,CAAC;KACtB;IAoDD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;IAyBzC;;;;OAIG;IACG,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6CzD;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCtH,gFAAgF;YAClE,UAAU;IAexB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+BxB,yHAAyH;IACzH,OAAO,CAAC,eAAe;IAIvB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CAiBxB"}

package/build/_modules/cli/_services/cli-program.control-service.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_Program_ControlService = void 0;
+const crypto_1 = require("crypto");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const cli_commander_util_1 = require("../_collections/cli-commander.util");
+const cli_envelope_util_1 = require("../_collections/cli-envelope.util");
+const cli_flag_util_1 = require("../_collections/cli-flag.util");
+const cli_exit_code_type_enum_1 = require("../_enums/cli-exit-code.type-enum");
+const cli_output_type_enum_1 = require("../_enums/cli-output.type-enum");
+const cli_command_params_control_model_1 = require("../_models/control-models/cli-command-params.control-model");
+/** The common options of every command. */
+const DyCLI_outputOptions = ['json', 'pretty', 'dry-run'];
+/** The common options of a command that calls a server operation. */
+const DyCLI_remoteOptions = ['api-key', 'base-url', 'timeout'];
+/**
+ * The commander program of a Dynamo CLI (HP-DOPL MP-4.3 + MP-4.4): the skeleton the fleet CLIs repeat by hand
+ * (`name / description / version / addHelpText / parse`), the common options, and ONE execution path per command —
+ * `before` → own `action` or the server call → `after` → the `fo` result envelope and the exit code.
+ *
+ * - Success: the envelope on stdout (or the `formatHuman` text when the command's output is `human` and no `--json`).
+ * - Failure: the envelope on stderr (or `<command>: <code>: <message>`), exit code by `DyCLI_Command_Params.exitCodeOf`.
+ * - An argument error (unknown option, invalid value, missing required flag): the `cli.parse` envelope, exit `usage`;
+ *   `--help` / `--version` exit 0.
+ * - `run()` RETURNS the exit code and never calls `process.exit` — `process.exitCode = await program.run()`.
+ *
+ * `build()` gives the commander program before parsing, so `registerDynamoCommands(program, version)` of
+ * `@futdevpro/cli-dynamo` can still be called on it (or pass it as `configure`).
+ *
+ * @example
+ * ```ts
+ * const cli: DyCLI_Program_ControlService = new DyCLI_Program_ControlService({
+ *   name: 'fo', description: 'Organizer CLI', version: '2.0.0',
+ *   commands: [ listTasks, backup ],
+ *   callOperation: mcpCaller,                              // generated commands call the server through MCP
+ * });
+ *
+ * process.exitCode = await cli.run();
+ * ```
+ */
+class DyCLI_Program_ControlService {
+    /** The program name (the binary). */
+    name;
+    /** The program description. */
+    description;
+    /** The program version (`-v, --version`). */
+    version;
+    /** The commands. */
+    commands;
+    /** Extra help text after the command list. */
+    helpText;
+    /** The exit code of the last command run through this program. */
+    lastExitCode = 0;
+    callOperation;
+    configure;
+    settings;
+    io;
+    /**
+     * @param set - the program settings; throws a coded `DyFM_Error` (500 `DyNTS-CLI-*`) when invalid
+     */
+    constructor(set) {
+        const invalid = (code, reason) => new fsm_dynamo_1.DyFM_Error({
+            status: 500,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|${code}`,
+            message: `DyCLI_Program_ControlService construction failed: ${reason}`,
+        });
+        if (typeof set?.name !== 'string' || !/^[a-z][a-z0-9-]*$/.test(set.name)) {
+            throw invalid('DyNTS-CLI-NAM', `the program name must be kebab-case (got: ${JSON.stringify(set?.name)})`);
+        }
+        if (typeof set.description !== 'string' || !set.description.trim() || typeof set.version !== 'string' ||
+            !set.version.trim()) {
+            throw invalid('DyNTS-CLI-DSC', 'the program needs a description and a version');
+        }
+        if (!Array.isArray(set.commands) ||
+            set.commands.some((command) => !(command instanceof cli_command_params_control_model_1.DyCLI_Command_Params))) {
+            throw invalid('DyNTS-CLI-CMD', 'commands must be DyCLI_Command_Params instances');
+        }
+        const names = set.commands.flatMap((command) => [command.command, ...command.aliases]);
+        const duplicate = names.find((name, index) => names.indexOf(name) !== index);
+        if (duplicate) {
+            throw invalid('DyNTS-CLI-DUP', `two commands use the name "${duplicate}"`);
+        }
+        if (set.callOperation !== undefined && typeof set.callOperation !== 'function') {
+            throw invalid('DyNTS-CLI-CAL', 'callOperation must be a function');
+        }
+        this.name = set.name;
+        this.description = set.description;
+        this.version = set.version;
+        this.commands = [...set.commands];
+        this.helpText = set.helpText;
+        this.callOperation = set.callOperation;
+        this.configure = set.configure;
+        this.settings = set.settings === undefined ? global_settings_const_1.DyNTS_global_settings.cli_settings : set.settings;
+        this.io = set.io ?? {
+            stdout: (text) => {
+                process.stdout.write(text);
+            },
+            stderr: (text) => {
+                process.stderr.write(text);
+            },
+        };
+    }
+    /**
+     * Builds the commander program with every command and its common options; nothing is parsed yet.
+     * @throws 501 `DyNTS-OPT-MIS` when `commander` is not installed
+     */
+    async build() {
+        const commander = await cli_commander_util_1.DyCLI_Commander_Util.load();
+        const program = new commander.Command(this.name)
+            .description(this.description)
+            .version(this.version, '-v, --version', 'output the current version');
+        if (this.helpText) {
+            program.addHelpText('after', this.helpText);
+        }
+        this.commands.forEach((params) => {
+            const command = params.buildCommand(commander, async (values) => {
+                this.lastExitCode = await this.execute(params, values, DyCLI_Program_ControlService.commonOf(command.opts(), common));
+            });
+            const common = this.addCommonOptions(commander, params, command);
+            program.addCommand(command);
+        });
+        await this.configure?.(program);
+        return program;
+    }
+    /**
+     * Parses the command line and runs the command.
+     * @param argv - the full argv (default: `process.argv`)
+     * @returns the exit code — set it as `process.exitCode`
+     */
+    async run(argv = process.argv) {
+        const program = await this.build();
+        let parseMessage = '';
+        // commander must not exit the process: every command gets the override, and its messages are captured
+        [program, ...program.commands].forEach((command) => {
+            command.exitOverride().configureOutput({
+                writeOut: (text) => this.io.stdout(text),
+                writeErr: (text) => {
+                    parseMessage += text;
+                },
+            });
+        });
+        this.lastExitCode = 0;
+        try {
+            await program.parseAsync(argv);
+            return this.lastExitCode;
+        }
+        catch (error) {
+            const failure = error;
+            // help and version are not errors
+            if (failure?.code === 'commander.helpDisplayed' || failure?.code === 'commander.version' ||
+                failure?.code === 'commander.help') {
+                return 0;
+            }
+            if (typeof failure?.code !== 'string' || !failure.code.startsWith('commander.')) {
+                throw error;
+            }
+            const envelope = cli_envelope_util_1.DyCLI_Envelope_Util.failure({
+                action: 'cli.parse', requestId: (0, crypto_1.randomUUID)(), startedAt: Date.now(),
+                error: { code: 'INVALID_ARGS', message: (failure.message || parseMessage).replace(/^error:\s*/i, '').trim() },
+            });
+            this.io.stderr(cli_envelope_util_1.DyCLI_Envelope_Util.stringify(envelope, argv.includes('--pretty')));
+            return this.exitCodeOfParse();
+        }
+    }
+    /**
+     * Runs one command: `before` → `action` or the server call → `after`, then writes the envelope.
+     * @param params - the command
+     * @param values - the collected flag values
+     * @param common - the common options
+     * @returns the exit code
+     */
+    async execute(params, values, common) {
+        const startedAt = Date.now();
+        const requestId = (0, crypto_1.randomUUID)();
+        const human = !common.json && params.getOutput(this.settings) === cli_output_type_enum_1.DyCLI_Output_Type.human;
+        try {
+            await params.before?.(values, params);
+            const result = params.action ?
+                await params.action(values, params, common) : await this.callServer(params, values, common);
+            await params.after?.(result, values, params);
+            if (human) {
+                this.io.stdout(`${params.formatHuman ? params.formatHuman(result) : JSON.stringify(result, null, 2)}\n`);
+            }
+            else {
+                this.io.stdout(cli_envelope_util_1.DyCLI_Envelope_Util.stringify(cli_envelope_util_1.DyCLI_Envelope_Util.success({ action: params.command, requestId: requestId, startedAt: startedAt, result: result }), common.pretty));
+            }
+            return 0;
+        }
+        catch (error) {
+            const envelope = cli_envelope_util_1.DyCLI_Envelope_Util.failure({
+                action: params.command, requestId: requestId, startedAt: startedAt, error: error,
+            });
+            if (human) {
+                this.io.stderr([
+                    `${params.command}: ${envelope.error.code}: ${envelope.error.message}`,
+                    ...(envelope.error.nextStep ? [`next: ${envelope.error.nextStep}`] : []),
+                ].join('\n') + '\n');
+            }
+            else {
+                this.io.stderr(cli_envelope_util_1.DyCLI_Envelope_Util.stringify(envelope, common.pretty));
+            }
+            return params.exitCodeOf(error, this.settings);
+        }
+    }
+    /** Calls the operation of a generated command through the configured caller. */
+    async callServer(params, values, common) {
+        if (!this.callOperation) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                status: 501,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-CLI-NOC`,
+                message: `command "${params.command}" calls a server operation, but the program has no callOperation`,
+                userMessage: `This CLI can not call "${params.command}": no server connection is configured.`,
+            });
+        }
+        return this.callOperation(params, values, common);
+    }
+    /**
+     * Adds the common options a command does not already have (a command flag of the same name wins).
+     * @returns the added long flags
+     */
+    addCommonOptions(commander, params, command) {
+        const own = params.flags.map((flag) => flag.flag);
+        const wanted = params.operation ? [...DyCLI_outputOptions, ...DyCLI_remoteOptions] : DyCLI_outputOptions;
+        const options = {
+            'json': () => new commander.Option('--json', 'print the JSON result envelope'),
+            'pretty': () => new commander.Option('--pretty', 'indent the JSON output'),
+            'dry-run': () => new commander.Option('--dry-run', 'validate and preview without saving'),
+            'api-key': () => new commander.Option('--api-key <key>', 'the API key of the server call'),
+            'base-url': () => new commander.Option('--base-url <url>', 'the server base URL'),
+            'timeout': () => new commander.Option('--timeout <ms>', 'the server call timeout in milliseconds')
+                .argParser((raw) => {
+                if (!/^\d+$/.test(raw.trim()) || Number(raw) < 1) {
+                    throw new commander.InvalidArgumentError('--timeout must be a positive integer of milliseconds');
+                }
+                return Number(raw);
+            }),
+        };
+        const added = wanted.filter((flag) => !own.includes(flag) && !cli_flag_util_1.DyCLI_reservedFlags.includes(flag));
+        added.forEach((flag) => {
+            command.addOption(options[flag]());
+        });
+        return added;
+    }
+    /** The exit code of a commander argument error: the `usage` code of the settings (a command override does not apply). */
+    exitCodeOfParse() {
+        return this.settings?.exitCodes?.usage ?? cli_exit_code_type_enum_1.DyCLI_ExitCode_Type.usage;
+    }
+    /**
+     * The common options from the parsed commander options — only the ones the program added to this command, so a
+     * command's own flag of the same name (e.g. the `dryRun` guardrail argument) stays a value, not a common option.
+     * @param options - the parsed options (`command.opts()`)
+     * @param added - the long flags of the common options added to the command
+     */
+    static commonOf(options, added) {
+        const common = {};
+        const keys = {
+            'json': 'json', 'pretty': 'pretty', 'dry-run': 'dryRun', 'api-key': 'apiKey', 'base-url': 'baseUrl',
+            'timeout': 'timeoutMs',
+        };
+        added.forEach((flag) => {
+            const value = options?.[cli_flag_util_1.DyCLI_Flag_Util.attributeOf(flag)];
+            if (value !== undefined) {
+                common[keys[flag]] = value;
+            }
+        });
+        return common;
+    }
+}
+exports.DyCLI_Program_ControlService = DyCLI_Program_ControlService;
+//# sourceMappingURL=cli-program.control-service.js.map

package/build/_modules/cli/_services/cli-program.control-service.js.map

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

package/build/_modules/cli/index.d.ts

@@ -1,2 +1,13 @@
+export * from './_enums/cli-exit-code.type-enum';
+export * from './_enums/cli-flag-value.type-enum';
+export * from './_enums/cli-output.type-enum';
+export * from './_models/interfaces/cli-common-options.interface';
+export * from './_models/interfaces/cli-envelope.interface';
+export * from './_models/interfaces/cli-flag.interface';
+export * from './_models/interfaces/cli-settings.interface';
+export * from './_models/control-models/cli-command-params.control-model';
 export * from './_collections/cli-commander.util';
+export * from './_collections/cli-envelope.util';
+export * from './_collections/cli-flag.util';
+export * from './_services/cli-program.control-service';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":"AAOA,cAAc,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":"AAOA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,2DAA2D,CAAC;AAG1E,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,yCAAyC,CAAC"}

package/build/_modules/cli/index.js

@@ -4,6 +4,21 @@
 // re-export this module, so a server never needs `commander`.
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+// ENUMS
+tslib_1.__exportStar(require("./_enums/cli-exit-code.type-enum"), exports);
+tslib_1.__exportStar(require("./_enums/cli-flag-value.type-enum"), exports);
+tslib_1.__exportStar(require("./_enums/cli-output.type-enum"), exports);
+// INTERFACES
+tslib_1.__exportStar(require("./_models/interfaces/cli-common-options.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/cli-envelope.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/cli-flag.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/cli-settings.interface"), exports);
+// CONTROL MODELS
+tslib_1.__exportStar(require("./_models/control-models/cli-command-params.control-model"), exports);
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/cli-commander.util"), exports);
+tslib_1.__exportStar(require("./_collections/cli-envelope.util"), exports);
+tslib_1.__exportStar(require("./_collections/cli-flag.util"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/cli-program.control-service"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":";AAEA,qHAAqH;AACrH,qHAAqH;AACrH,8DAA8D;;;AAE9D,cAAc;AACd,4EAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":";AAEA,qHAAqH;AACrH,qHAAqH;AACrH,8DAA8D;;;AAE9D,QAAQ;AACR,2EAAiD;AACjD,4EAAkD;AAClD,wEAA8C;AAE9C,aAAa;AACb,4FAAkE;AAClE,sFAA4D;AAC5D,kFAAwD;AACxD,sFAA4D;AAE5D,iBAAiB;AACjB,oGAA0E;AAE1E,cAAc;AACd,4EAAkD;AAClD,2EAAiD;AACjD,uEAA6C;AAE7C,WAAW;AACX,kFAAwD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.306",
+  "version": "01.15.308",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",