@pristine-ts/cli 2.0.6 → 2.0.16

package/dist/lib/cjs/services/command-options-resolver.js

@@ -0,0 +1,114 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandOptionsResolver = void 0;
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const class_validator_1 = require("@pristine-ts/class-validator");
+const data_mapping_1 = require("@pristine-ts/data-mapping");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const cli_error_code_enum_1 = require("../errors/cli-error-code.enum");
+const command_parameter_prompter_1 = require("./command-parameter-prompter");
+/**
+ * Resolves a typed, validated options instance from raw arguments: it fills any missing
+ * `@commandParameter` values by prompting, maps the result onto a real `optionsType`
+ * instance (prototype + decorator metadata intact, so `class-validator` finds its rules),
+ * and validates it.
+ *
+ * This is the reusable core behind command dispatch — `CommandArgumentResolver` delegates
+ * here — exposed so commands and dynamic flows can fill an options class from prompts on
+ * demand, including ones not tied to a registered command:
+ *
+ * ```ts
+ * constructor(private readonly optionsResolver: CommandOptionsResolver) {}
+ * // ...later, possibly choosing the class at runtime:
+ * const options = await this.optionsResolver.resolve(MyOptions, {region: "us"});
+ * ```
+ *
+ * Throws `UsageError` for mapping failures and `ValidationError` for validation failures —
+ * both carry structured `details` for `CliErrorReporter`.
+ */
+let CommandOptionsResolver = class CommandOptionsResolver {
+    constructor(validator, dataMapper, commandParameterPrompter) {
+        this.validator = validator;
+        this.dataMapper = dataMapper;
+        this.commandParameterPrompter = commandParameterPrompter;
+    }
+    /**
+     * Prompts for any missing parameters declared on `optionsType`, then maps `rawArgs` (plus
+     * the prompted answers) onto a real instance and validates it. `rawArgs` seeds the values
+     * already known — anything absent that carries a `question` is asked for interactively.
+     */
+    resolve(optionsType_1) {
+        return __awaiter(this, arguments, void 0, function* (optionsType, rawArgs = {}) {
+            const preparedArgs = yield this.commandParameterPrompter.fillMissingParameters(optionsType, rawArgs);
+            let mapped;
+            try {
+                // `throwOnErrors: true` so a normalizer failure surfaces here instead of `autoMap`
+                // silently returning the source object (which would defeat validation downstream).
+                mapped = yield this.dataMapper.autoMap(preparedArgs, optionsType, new data_mapping_1.AutoDataMappingBuilderOptions({ throwOnErrors: true }));
+            }
+            catch (cause) {
+                throw new common_1.UsageError(`Failed to map arguments to '${optionsType.name}': ${cause.message}`, {
+                    code: cli_error_code_enum_1.CliErrorCode.ArgumentMappingFailed,
+                    cause: cause,
+                    details: { targetType: optionsType.name },
+                });
+            }
+            const validationErrors = yield this.validator.validate(mapped);
+            if (validationErrors.length === 0) {
+                return mapped;
+            }
+            // Reshape the class-validator output into structured `details` the reporter can render
+            // line-by-line. Keeps the throw single-pass and the reporter format-agnostic.
+            const failures = {};
+            for (const error of validationErrors) {
+                const messages = [];
+                for (const constraintKey in error.constraints) {
+                    // `@pristine-ts/class-validator` stores constraints as `{keyname, message}` objects
+                    // rather than the plain strings vanilla class-validator uses. Extract the message
+                    // when present, falling back to JSON for unknown shapes so we never print
+                    // `[object Object]`.
+                    const constraint = error.constraints[constraintKey];
+                    const message = typeof constraint === "string"
+                        ? constraint
+                        : (constraint && typeof constraint === "object" && typeof constraint.message === "string")
+                            ? constraint.message
+                            : JSON.stringify(constraint);
+                    messages.push(`[${constraintKey}] ${message}`);
+                }
+                failures[error.property] = messages;
+            }
+            throw new common_1.ValidationError("Argument validation failed", {
+                code: cli_error_code_enum_1.CliErrorCode.ArgumentValidationFailed,
+                details: failures,
+            });
+        });
+    }
+};
+exports.CommandOptionsResolver = CommandOptionsResolver;
+exports.CommandOptionsResolver = CommandOptionsResolver = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    __metadata("design:paramtypes", [class_validator_1.Validator,
+        data_mapping_1.DataMapper,
+        command_parameter_prompter_1.CommandParameterPrompter])
+], CommandOptionsResolver);
+//# sourceMappingURL=command-options-resolver.js.map

package/dist/lib/cjs/services/command-options-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-options-resolver.js","sourceRoot":"","sources":["../../../../src/services/command-options-resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,uCAAoC;AAEpC,gDAA8E;AAC9E,kEAAuD;AACvD,4DAAoF;AACpF,8DAAuD;AACvD,uEAA2D;AAC3D,6EAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AAGI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YACmB,SAAoB,EACpB,UAAsB,EACtB,wBAAkD;QAFlD,cAAS,GAAT,SAAS,CAAW;QACpB,eAAU,GAAV,UAAU,CAAY;QACtB,6BAAwB,GAAxB,wBAAwB,CAA0B;IAErE,CAAC;IAED;;;;OAIG;IACG,OAAO;6DAAI,WAAgC,EAAE,UAA+B,EAAE;YAClF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAErG,IAAI,MAAS,CAAC;YACd,IAAI,CAAC;gBACH,mFAAmF;gBACnF,mFAAmF;gBACnF,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,4CAA6B,CAAC,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC;YAC9H,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,mBAAU,CAClB,+BAA+B,WAAW,CAAC,IAAI,MAAO,KAAe,CAAC,OAAO,EAAE,EAC/E;oBACE,IAAI,EAAE,kCAAY,CAAC,qBAAqB;oBACxC,KAAK,EAAE,KAAc;oBACrB,OAAO,EAAE,EAAC,UAAU,EAAE,WAAW,CAAC,IAAI,EAAC;iBACxC,CACF,CAAC;YACJ,CAAC;YAED,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,uFAAuF;YACvF,8EAA8E;YAC9E,MAAM,QAAQ,GAA6B,EAAE,CAAC;YAC9C,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;gBAC9B,KAAK,MAAM,aAAa,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC9C,oFAAoF;oBACpF,kFAAkF;oBAClF,0EAA0E;oBAC1E,qBAAqB;oBACrB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;oBACpD,MAAM,OAAO,GAAG,OAAO,UAAU,KAAK,QAAQ;wBAC5C,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,QAAQ,CAAC;4BACjG,CAAC,CAAE,UAAkB,CAAC,OAAO;4BAC7B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;oBACjC,QAAQ,CAAC,IAAI,CAAC,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC,CAAC;gBACjD,CAAC;gBACD,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;YACtC,CAAC;YACD,MAAM,IAAI,wBAAe,CAAC,4BAA4B,EAAE;gBACtD,IAAI,EAAE,kCAAY,CAAC,wBAAwB;gBAC3C,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;KAAA;CACF,CAAA;AA9DY,wDAAsB;iCAAtB,sBAAsB;IAFlC,IAAA,qBAAU,GAAE;IACZ,IAAA,qBAAY,EAAC,qCAAgB,CAAC;qCAGC,2BAAS;QACR,yBAAU;QACI,qDAAwB;GAJ1D,sBAAsB,CA8DlC"}

package/dist/lib/cjs/services/command-parameter-prompter.js

@@ -0,0 +1,311 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var CommandParameterPrompter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandParameterPrompter = void 0;
+require("reflect-metadata");
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const metadata_1 = require("@pristine-ts/metadata");
+const class_validator_1 = require("@pristine-ts/class-validator");
+const data_mapping_1 = require("@pristine-ts/data-mapping");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const cli_configuration_keys_1 = require("../cli.configuration-keys");
+const cli_prompt_manager_1 = require("../managers/cli-prompt.manager");
+const cli_output_manager_1 = require("../managers/cli-output.manager");
+const cli_decorator_metadata_keyname_enum_1 = require("../enums/cli-decorator-metadata-keyname.enum");
+const cli_error_code_enum_1 = require("../errors/cli-error-code.enum");
+const boolean_answer_parser_1 = require("../utils/boolean-answer-parser");
+/**
+ * Applies a command's `@commandParameter` metadata to its raw, parsed arguments before they
+ * are mapped onto the options instance and validated. Two things happen here:
+ *
+ *   1. **Flag binding** — a parameter whose `flag` differs from its property name is copied
+ *      from the flag key onto the property key, so the by-property-name data mapper picks it
+ *      up. Two parameters resolving to the same flag is a programming error and throws.
+ *   2. **Interactive fill** — a parameter that is absent and declares a `question` is asked
+ *      for interactively. Answers are rendered and checked against the property's declared
+ *      type (booleans as `(y/n)`, enum-constrained values list their choices) and coerced +
+ *      validated through the same mapper/validator the command pipeline uses, re-asking on an
+ *      invalid answer. Gated by the `InteractiveParameters` configuration and only run against
+ *      an interactive terminal; otherwise the absent value is left for validation to report.
+ *
+ * Parameters without a `@commandParameter` decorator are untouched, so commands that don't
+ * use it pay nothing.
+ */
+let CommandParameterPrompter = CommandParameterPrompter_1 = class CommandParameterPrompter {
+    constructor(cliPrompt, cliOutput, validator, dataMapper, interactiveParametersEnabled) {
+        this.cliPrompt = cliPrompt;
+        this.cliOutput = cliOutput;
+        this.validator = validator;
+        this.dataMapper = dataMapper;
+        this.interactiveParametersEnabled = interactiveParametersEnabled;
+    }
+    /**
+     * Returns a copy of `rawArgs` with aliased flags bound to their property and any missing,
+     * question-carrying parameters filled in interactively. The input object is never mutated
+     * — the original command event payload stays intact.
+     */
+    fillMissingParameters(optionsType, rawArgs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = Object.assign({}, rawArgs);
+            const parameters = this.collectParameters(optionsType);
+            if (parameters.length === 0) {
+                return args;
+            }
+            for (const { propertyKey, flag, options } of parameters) {
+                // Bind an aliased flag (`--flag`) onto the property name so the data mapper, which maps
+                // by property name, resolves it. Only when the flag was actually passed.
+                if (flag !== propertyKey && args[flag] !== undefined) {
+                    args[propertyKey] = args[flag];
+                }
+                const isPassed = args[propertyKey] !== undefined || args[flag] !== undefined;
+                if (isPassed || options.question === undefined) {
+                    continue;
+                }
+                // Absent + a question to ask. Skip silently when prompting is turned off or there is no
+                // interactive terminal to ask on — the missing value then falls through to validation.
+                if (this.interactiveParametersEnabled !== true || this.isInputInteractive() === false) {
+                    continue;
+                }
+                const value = yield this.promptForValue(optionsType, propertyKey, options);
+                if (value !== undefined) {
+                    args[propertyKey] = value;
+                }
+            }
+            return args;
+        });
+    }
+    /**
+     * Reads every `@commandParameter` off `optionsType`, resolving each to its effective flag
+     * and detecting two parameters that would claim the same flag (a programming error).
+     * @private
+     */
+    collectParameters(optionsType) {
+        var _a;
+        const properties = metadata_1.ClassMetadata.getInformation(optionsType).properties;
+        const parameters = [];
+        const propertyByFlag = new Map();
+        for (const propertyKey of properties) {
+            const options = metadata_1.PropertyMetadata.getMetadata(optionsType.prototype, propertyKey, cli_decorator_metadata_keyname_enum_1.CliDecoratorMetadataKeynameEnum.CommandParameter);
+            if (options === undefined) {
+                continue;
+            }
+            const flag = (_a = options.flag) !== null && _a !== void 0 ? _a : propertyKey;
+            const existing = propertyByFlag.get(flag);
+            if (existing !== undefined) {
+                throw new common_1.UsageError(`Command parameters '${existing}' and '${propertyKey}' on '${optionsType.name}' both bind to the flag '--${flag}'. Give one of them a distinct 'flag'.`, {
+                    code: cli_error_code_enum_1.CliErrorCode.CommandParameterFlagConflict,
+                    details: { targetType: optionsType.name, flag, properties: [existing, propertyKey] },
+                });
+            }
+            propertyByFlag.set(flag, propertyKey);
+            parameters.push({ propertyKey, flag, options });
+        }
+        return parameters;
+    }
+    /**
+     * Asks for a single parameter's value, rendering and validating it according to the
+     * property's declared type:
+     *
+     *   - sensitive values are read with the input masked and never trimmed;
+     *   - booleans render as `(y/n)` and accept y/yes/true/1 & n/no/false/0;
+     *   - enum-constrained values (`@IsIn` / `@IsEnum`) list their choices;
+     *   - every other answer is coerced (via the data mapper) and validated (via the validator)
+     *     exactly as a typed flag would be, re-asking with the real constraint message when it
+     *     doesn't pass.
+     *
+     * Returns the coerced value, or `undefined` when the user enters nothing or the attempt
+     * budget is exhausted — in which case the absent value falls through to validation.
+     * @private
+     */
+    promptForValue(optionsType, propertyKey, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const sensitive = options.sensitive === true;
+            const isBoolean = sensitive === false && Reflect.getMetadata("design:type", optionsType.prototype, propertyKey) === Boolean;
+            const choices = (sensitive || isBoolean) ? undefined : this.getChoices(optionsType, propertyKey);
+            const prompt = this.formatQuestion(this.decorateQuestion((_a = options.question) !== null && _a !== void 0 ? _a : "", isBoolean, choices));
+            for (let attempt = 0; attempt < CommandParameterPrompter_1.MaxAttempts; attempt++) {
+                // Secrets go through the masked reader and are never trimmed (a password may legitimately
+                // contain surrounding whitespace); ordinary answers are trimmed.
+                const raw = sensitive
+                    ? yield this.cliPrompt.readSecret(prompt)
+                    : (yield this.cliPrompt.readLine(prompt)).trim();
+                // Nothing entered → leave the value unset so validation reports it (and a required
+                // field surfaces the same way it would have without a prompt).
+                if (raw.length === 0) {
+                    return undefined;
+                }
+                if (isBoolean) {
+                    const parsed = boolean_answer_parser_1.BooleanAnswerParser.parse(raw);
+                    if (parsed === undefined) {
+                        this.cliOutput.writeLine("Please answer yes (y) or no (n).");
+                        continue;
+                    }
+                    return parsed;
+                }
+                const outcome = yield this.coerceAndValidate(optionsType, propertyKey, raw);
+                if (outcome.valid) {
+                    return outcome.value;
+                }
+                for (const message of (_b = outcome.messages) !== null && _b !== void 0 ? _b : []) {
+                    this.cliOutput.writeLine(message);
+                }
+            }
+            this.cliOutput.writeLine(`No valid value provided after ${CommandParameterPrompter_1.MaxAttempts} attempts.`);
+            return undefined;
+        });
+    }
+    /**
+     * Maps a single raw answer onto a probe instance of `optionsType` and validates just that
+     * property, returning the coerced value when it passes or the constraint messages when it
+     * doesn't. Reuses the same mapper + validator the command pipeline uses, so coercion and
+     * constraints behave identically whether a value was typed as a flag or answered here.
+     * @private
+     */
+    coerceAndValidate(optionsType, propertyKey, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let probe;
+            try {
+                probe = yield this.dataMapper.autoMap({ [propertyKey]: raw }, optionsType, new data_mapping_1.AutoDataMappingBuilderOptions({ throwOnErrors: false }));
+            }
+            catch (_a) {
+                return { valid: false, messages: [`'${raw}' could not be interpreted — please try again.`] };
+            }
+            const validationErrors = yield this.validator.validate(probe);
+            const propertyErrors = validationErrors.filter((error) => error.property === propertyKey);
+            if (propertyErrors.length === 0) {
+                return { valid: true, value: probe[propertyKey] };
+            }
+            return { valid: false, messages: this.describeErrors(propertyErrors) };
+        });
+    }
+    /**
+     * Flattens `class-validator`'s per-property constraint objects into plain, user-facing
+     * lines. `@pristine-ts/class-validator` stores each constraint as `{keyname, message}`
+     * rather than a bare string, so prefer `.message`, falling back so we never print
+     * `[object Object]`.
+     * @private
+     */
+    describeErrors(errors) {
+        const messages = [];
+        for (const error of errors) {
+            for (const key in error.constraints) {
+                const constraint = error.constraints[key];
+                const message = typeof constraint === "string"
+                    ? constraint
+                    : (constraint && typeof constraint === "object" && typeof constraint.message === "string")
+                        ? constraint.message
+                        : JSON.stringify(constraint);
+                messages.push(message);
+            }
+        }
+        return messages.length > 0 ? messages : ["Invalid value — please try again."];
+    }
+    /**
+     * The allowed values declared by an `@IsIn([...])` or `@IsEnum(Enum)` on the property, for
+     * display in the prompt. Reads `@pristine-ts/class-validator`'s stored validator instances
+     * defensively — any shape mismatch just yields no menu (validation still rejects bad input
+     * and re-asks). Returns undefined when the property isn't enum-constrained.
+     * @private
+     */
+    getChoices(optionsType, propertyKey) {
+        const validators = metadata_1.PropertyMetadata.getMetadata(optionsType.prototype, propertyKey, CommandParameterPrompter_1.ClassValidatorMetadataKey);
+        if (Array.isArray(validators) === false) {
+            return undefined;
+        }
+        for (const validator of validators) {
+            if (validator === null || validator === undefined || typeof validator.getConstraints !== "function") {
+                continue;
+            }
+            let constraints;
+            try {
+                constraints = validator.getConstraints();
+            }
+            catch (_a) {
+                continue;
+            }
+            if (Array.isArray(constraints === null || constraints === void 0 ? void 0 : constraints.possibleValues)) {
+                return constraints.possibleValues.map((value) => String(value));
+            }
+            if ((constraints === null || constraints === void 0 ? void 0 : constraints.entity) !== null && typeof (constraints === null || constraints === void 0 ? void 0 : constraints.entity) === "object") {
+                return Object.keys(constraints.entity).map((key) => String(constraints.entity[key]));
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Appends a type hint to the question: `(y/n)` for booleans, `(a/b/c)` for enum choices.
+     * @private
+     */
+    decorateQuestion(question, isBoolean, choices) {
+        if (isBoolean) {
+            return `${question} (y/n)`;
+        }
+        if (choices !== undefined && choices.length > 0) {
+            return `${question} (${choices.join("/")})`;
+        }
+        return question;
+    }
+    /**
+     * Whether stdin is an interactive terminal. Pulled out so the gate is easy to reason about
+     * (and to stub in tests) — there is no point asking a question when input is piped or runs
+     * under CI, where a read would either hang or return EOF.
+     * @private
+     */
+    isInputInteractive() {
+        return process.stdin.isTTY === true;
+    }
+    /**
+     * Ensures the rendered question ends with a trailing space so the typed answer doesn't butt
+     * up against the prompt text.
+     * @private
+     */
+    formatQuestion(question) {
+        return question.endsWith(" ") ? question : `${question} `;
+    }
+};
+exports.CommandParameterPrompter = CommandParameterPrompter;
+/**
+ * `@pristine-ts/class-validator` stores its instantiated validators (one per `@IsX`
+ * decorator) as an array under this property-metadata key. We read it only to surface enum
+ * choices in the prompt; all actual validation goes through `Validator`.
+ */
+CommandParameterPrompter.ClassValidatorMetadataKey = "pristine-validator:validator";
+/**
+ * How many times a single value is re-asked before giving up and letting the missing /
+ * invalid value fall through to the normal validation error. A bound (rather than an
+ * unbounded loop) keeps a misconfigured validator that can never pass from hanging the CLI.
+ */
+CommandParameterPrompter.MaxAttempts = 5;
+exports.CommandParameterPrompter = CommandParameterPrompter = CommandParameterPrompter_1 = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    __param(4, (0, common_1.injectConfig)(cli_configuration_keys_1.CliConfigurationKeys.InteractiveParameters)),
+    __metadata("design:paramtypes", [cli_prompt_manager_1.CliPrompt,
+        cli_output_manager_1.CliOutput,
+        class_validator_1.Validator,
+        data_mapping_1.DataMapper, Boolean])
+], CommandParameterPrompter);
+//# sourceMappingURL=command-parameter-prompter.js.map

package/dist/lib/cjs/services/command-parameter-prompter.js.map

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

package/dist/lib/cjs/services/services.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./command-argument-resolver"), exports);
+__exportStar(require("./command-options-resolver"), exports);
+__exportStar(require("./command-parameter-prompter"), exports);
+//# sourceMappingURL=services.js.map

package/dist/lib/cjs/services/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../../src/services/services.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,6DAA2C;AAC3C,+DAA6C"}