@microsoft/managed-apps-cli 0.20.0 → 0.21.0

package/dist/ArgumentProvider.d.ts

@@ -1,144 +0,0 @@
-/*!
- * Copyright (C) Microsoft Corporation. All rights reserved.
- */
-import { type Cloud, type IHttpClient } from '@microsoft/managed-apps-common/services';
-import type { CliLogger } from './Logger/CliLogger.js';
-import type { CliOption } from './Types/Argument.types.js';
-import type { IAccountManager, IAuthenticationProvider } from './Types/Cli.types.js';
-import type { ResolvedCommand } from './Types/Command.types.js';
-export interface IArgumentProvider {
-    addOption(cliOption: CliOption): void;
-    addOptions(cliOptions: CliOption[]): void;
-    addSwitch(cliOption: CliOption): void;
-    addSwitches(cliOptions: CliOption[]): void;
-    consumePositionalArg(name: string): void;
-    consumePositionalArgs(name: string): void;
-    getPositionalArg(index: number): string | undefined;
-    getPositionalArgs(index: number): readonly string[];
-    runVerb(): Promise<void>;
-    getVerb(): string;
-    getResolvedCommand(): ResolvedCommand | null;
-    handleGlobalHelpOrFlagsAndExit(): void;
-    getOption<T>(key: string, ignorePrompt?: boolean): Promise<T>;
-    getAuthenticationProvider(): IAuthenticationProvider;
-    /**
-     * Returns the account manager for the current auth mode. Throws `UsageError` when the
-     * current mode (service principal, HTTP forward) does not support account management —
-     * only interactive MSAL does.
-     */
-    getAccountManager(): IAccountManager;
-    getHttpClient(): IHttpClient;
-    getTenantIdAsync(): Promise<string | undefined>;
-    getAuthResourceUrl(): string;
-    getLoginAuthority(tenantId: string): string;
-    setDescription(description: string): void;
-    isJsonMode(): boolean;
-    addExamples(examples: string[]): void;
-    /** Returns all `--flag` tokens currently registered with the program (including short aliases). */
-    getRegisteredFlags(): ReadonlySet<string>;
-    /** Returns the validated, normalized user-facing cloud value (from --cloud or ms.config.json). */
-    getCloud(): Cloud | undefined;
-    /** Returns the effective environment ID without prompting. */
-    getEnvironmentId(options?: {
-        includeConfig?: boolean;
-    }): string | undefined;
-    /** Updates the resolved environment used by Player Services and telemetry. */
-    updateEnvironmentId(environmentId: string): void;
-}
-export declare class ArgumentProvider implements IArgumentProvider {
-    private _httpClient;
-    private _logger;
-    private _authenticationProvider;
-    private _accountManager?;
-    private _environmentId;
-    private _debugEnvironmentId;
-    private _environmentIdNotified;
-    private _cloud;
-    private _region;
-    private _verb;
-    private _resolvedCommand;
-    private _tokensConsumed;
-    private _program;
-    private _options;
-    private _positionalArgs;
-    private _positionalArgNames;
-    private _isParsed;
-    constructor(_httpClient: IHttpClient, _logger: CliLogger, _authenticationProvider: IAuthenticationProvider, _accountManager?: IAccountManager | undefined);
-    addSwitch(cliOption: CliOption): void;
-    addSwitches(cliOptions: CliOption[]): void;
-    /**
-     * Consumes the next positional token from process.argv before Commander parses flags.
-     * Increments the internal token counter so runVerb() excludes this token from Commander's
-     * args, and updates the usage string so --help shows the argument name.
-     *
-     * Must be called before runVerb().
-     */
-    consumePositionalArg(name: string): void;
-    /**
-     * Registers a variadic positional argument with Commander. Parsing uses
-     * optional syntax so the verb can provide its own missing-input error, while
-     * usage renders the argument as required.
-     *
-     * Unlike consumePositionalArg(), Commander can collect multiple values and
-     * allows options to appear before or after them. Must be called before runVerb().
-     */
-    consumePositionalArgs(name: string): void;
-    getPositionalArg(index: number): string | undefined;
-    getPositionalArgs(index: number): readonly string[];
-    addOption(cliOption: CliOption): void;
-    addOptions(cliOptions: CliOption[]): void;
-    runVerb(): Promise<void>;
-    handleGlobalHelpOrFlagsAndExit(): void;
-    /**
-     * Detects `--help` requests on nested typed-verb paths the resolver can't
-     * leaf-match (e.g. `ms app share link --help` — `link` is a nested typed
-     * verb with no handler of its own) and prints the typed verb's flattened
-     * subcommand list. Returns true if it handled the request.
-     *
-     * Skips when the user is asking for help on a path the resolver already
-     * fully matched (those paths route through Commander's normal `--help`
-     * handling at the leaf level).
-     */
-    private _tryPrintDeepTypedHelp;
-    getVerb(): string;
-    getResolvedCommand(): ResolvedCommand | null;
-    getOption<T>(key: string, ignorePrompt?: boolean): Promise<T>;
-    getAuthenticationProvider(): IAuthenticationProvider;
-    getAccountManager(): IAccountManager;
-    getHttpClient(): IHttpClient;
-    /**
-     * Returns the tenant ID for the authenticated user, acquiring a token first if needed.
-     *
-     * NodeMsalAuthenticationProvider only populates _tenantId after getAccessTokenForResource()
-     * is called. This method pre-acquires a token for the Power Platform resource so the tenant
-     * ID is always available after runVerb() completes.
-     */
-    getTenantIdAsync(): Promise<string | undefined>;
-    getAuthResourceUrl(): string;
-    getCloud(): Cloud | undefined;
-    getLoginAuthority(tenantId: string): string;
-    /**
-     * Sets the description for the current command context.
-     * This is used to display help information specific to the verb being executed.
-     *
-     * @param {string} description - The description to set for the program.
-     */
-    setDescription(description: string): void;
-    isJsonMode(): boolean;
-    addExamples(examples: string[]): void;
-    getRegisteredFlags(): ReadonlySet<string>;
-    getEnvironmentId(options?: {
-        includeConfig?: boolean;
-    }): string | undefined;
-    private _resolveEnvironmentId;
-    updateEnvironmentId(environmentId: string): void;
-    private _getRequiredVariables;
-    /**
-     * @param {CliOption} cliOption
-     * @param {boolean} [hasValue=true] true if the option requires a value, false for a switch such as --help
-     */
-    private _createOption;
-    private _createFlags;
-    private _createSwitchFlags;
-}
-//# sourceMappingURL=ArgumentProvider.d.ts.map

package/dist/ArgumentProvider.d.ts.map

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

package/dist/ArgumentProvider.js

@@ -1,493 +0,0 @@
-/*!
- * Copyright (C) Microsoft Corporation. All rights reserved.
- */
-import { getAuthResource, initializePlayerServices, updateEnvironmentName, updateRegion, } from '@microsoft/managed-apps-actions';
-import { Clouds, cloudToRegion, } from '@microsoft/managed-apps-common/services';
-import { Command } from 'commander';
-import packageJson from '../package.json' with { type: 'json' };
-import { getSettings } from './CliSettings.js';
-import { extractEnvironmentId, getAuthority } from './CliUtils.js';
-import { CLI_BINARY_NAME } from './Constants/CliConstants.js';
-import { COMMAND_TREE } from './Constants/CommandRegistry.js';
-import { HelpStrings } from './Constants/HelpStrings.js';
-import { UsageError } from './Errors/CliError.js';
-import { buildNounHelpText, buildPathTypedHelpText, buildVerbDescriptionTable, } from './Utils/BuildVerbDescriptionTable.js';
-import { printInfo } from './Utils/ConsoleOutput.js';
-import { cliEnvVarFullName, getCliEnvVar } from './Utils/EnvVars.js';
-import { getHelpBanner } from './Utils/HelpBanner.js';
-import { findIncompleteTypedPath, isKnownNoun, resolveCommand } from './Utils/ResolveCommand.js';
-import { GlobalArguments } from './Verbs/VerbConstants.js';
-function normalizeOptionalString(value) {
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-    const normalized = value.trim();
-    return normalized || undefined;
-}
-export class ArgumentProvider {
-    _httpClient;
-    _logger;
-    _authenticationProvider;
-    _accountManager;
-    _environmentId;
-    _debugEnvironmentId;
-    _environmentIdNotified = false;
-    _cloud;
-    _region;
-    _verb;
-    _resolvedCommand;
-    _tokensConsumed = 0;
-    _program;
-    _options = {};
-    _positionalArgs = [];
-    _positionalArgNames = [];
-    _isParsed = false;
-    constructor(_httpClient, _logger, _authenticationProvider, _accountManager) {
-        this._httpClient = _httpClient;
-        this._logger = _logger;
-        this._authenticationProvider = _authenticationProvider;
-        this._accountManager = _accountManager;
-        // Resolve command using multi-token matching against the command registry
-        this._resolvedCommand = resolveCommand(process.argv, COMMAND_TREE);
-        if (this._resolvedCommand) {
-            // Use the command path as the verb identifier for telemetry and internal checks
-            this._verb = this._resolvedCommand.path.join(' ');
-            this._tokensConsumed = this._resolvedCommand.tokensConsumed;
-        }
-        this._program = new Command();
-        // Add the --non-interactive switch as a global option
-        this._program.option('--non-interactive', 'Run in non-interactive mode (no prompts, all parameters must be provided via flags or environment variables)');
-        this._program.option('--json', 'Format output as JSON');
-        this._program.option('--no-color', 'Disable colored output');
-        // If a command was resolved, show the full command path in help/usage.
-        // Otherwise show the generic top-level help.
-        if (this._resolvedCommand) {
-            this._program.name(`${CLI_BINARY_NAME} ${this._verb}`);
-        }
-        else {
-            this._program.name(CLI_BINARY_NAME);
-            this._program.usage('[option] [command] [<args>]');
-        }
-        this._program.version(packageJson.version, '-v, --version', 'output the current version');
-        this._program.description(HelpStrings.global.programDescription);
-        // Register custom help text to show verb table on global --help
-        // This uses Commander's addHelpText hook which runs when help is displayed
-        this._program.addHelpText('beforeAll', () => `${getHelpBanner()}\n\n`);
-        this._program.addHelpText('after', (_context) => {
-            // Only show verb table for global help (not verb-specific help)
-            if (!this._resolvedCommand) {
-                return '\n' + buildVerbDescriptionTable() + '\n';
-            }
-            return '';
-        });
-        const settings = getSettings();
-        // Seed the project and debug fallbacks. Command-specific flags and their environment
-        // variables are registered later and resolved by getEnvironmentId().
-        const configEnvironmentId = normalizeOptionalString(settings.appConfig?.environmentId);
-        const debugEnvironmentId = normalizeOptionalString(getCliEnvVar('MAAF_DEBUG_ENVIRONMENT_ID'));
-        this._debugEnvironmentId = debugEnvironmentId;
-        this._environmentId = configEnvironmentId ?? debugEnvironmentId;
-        if (!configEnvironmentId && debugEnvironmentId) {
-            printInfo(`[debug] ${cliEnvVarFullName('MAAF_DEBUG_ENVIRONMENT_ID')} is set to '${debugEnvironmentId}'.`);
-        }
-        const configCloud = settings.appConfig?.cloud;
-        if (configCloud) {
-            const normalized = configCloud.toLowerCase();
-            if (!Clouds.includes(normalized)) {
-                throw new UsageError(`Invalid cloud value '${configCloud}' in ms.config.json. Valid values are: ${Clouds.join(', ')}.`);
-            }
-            this._cloud = normalized;
-            this._region = cloudToRegion(this._cloud);
-        }
-        if (!this._cloud) {
-            // Do not provide a prompt, default to public
-            this.addOption({
-                flags: {
-                    key: GlobalArguments.Cloud.name,
-                },
-                env: GlobalArguments.Cloud.envVar,
-                default: 'public',
-                description: HelpStrings.global.cloud,
-            });
-        }
-        initializePlayerServices({
-            httpClient: this._httpClient,
-            logger: this._logger,
-            region: this._region ?? cloudToRegion('public'),
-            environmentName: this._resolveEnvironmentId() || 'default',
-        });
-    }
-    addSwitch(cliOption) {
-        this._createOption(cliOption, false);
-    }
-    addSwitches(cliOptions) {
-        cliOptions.forEach((cliOption) => this._createOption(cliOption, false));
-    }
-    /**
-     * Consumes the next positional token from process.argv before Commander parses flags.
-     * Increments the internal token counter so runVerb() excludes this token from Commander's
-     * args, and updates the usage string so --help shows the argument name.
-     *
-     * Must be called before runVerb().
-     */
-    consumePositionalArg(name) {
-        const value = process.argv[2 + this._tokensConsumed];
-        // Skip flags (e.g. --help, -h) — leave them in the args for Commander to handle.
-        if (value !== undefined && !/^-[a-zA-Z-]/.test(value)) {
-            this._tokensConsumed++;
-            this._positionalArgs.push(value);
-        }
-        else {
-            this._positionalArgs.push(undefined);
-        }
-        this._positionalArgNames.push(name);
-        this._program.usage(`${this._positionalArgNames.join(' ')} [options]`);
-    }
-    /**
-     * Registers a variadic positional argument with Commander. Parsing uses
-     * optional syntax so the verb can provide its own missing-input error, while
-     * usage renders the argument as required.
-     *
-     * Unlike consumePositionalArg(), Commander can collect multiple values and
-     * allows options to appear before or after them. Must be called before runVerb().
-     */
-    consumePositionalArgs(name) {
-        this._program.argument(`[${name}...]`);
-        this._positionalArgNames.push(`<${name}...>`);
-        this._program.usage(`${this._positionalArgNames.join(' ')} [options]`);
-    }
-    getPositionalArg(index) {
-        return this._positionalArgs[index];
-    }
-    getPositionalArgs(index) {
-        const value = this._program.processedArgs[index];
-        if (!Array.isArray(value)) {
-            return [];
-        }
-        return value.filter((entry) => typeof entry === 'string');
-    }
-    addOption(cliOption) {
-        this._createOption(cliOption);
-    }
-    addOptions(cliOptions) {
-        cliOptions.forEach((cliOption) => this._createOption(cliOption));
-    }
-    async runVerb() {
-        // Commander needs to see only the flag arguments, so strip the command path
-        // tokens that were consumed by the resolver (e.g., 1 for 'init', 2 for 'app init',
-        // 3 for 'app add table'). Global flag paths skip this method entirely.
-        if (this._tokensConsumed > 0) {
-            const args = [
-                process.argv[0],
-                process.argv[1],
-                ...process.argv.slice(2 + this._tokensConsumed),
-            ];
-            this._program.parse(args);
-        }
-        else {
-            this._program.parse();
-        }
-        this._isParsed = true;
-        await this._getRequiredVariables();
-        if (!this._region) {
-            throw new UsageError(`Region is not set. Use --cloud or set the ${cliEnvVarFullName('CLOUD_INSTANCE')} environment variable.`);
-        }
-        this._logger.setTelemetryContext({ region: this._region });
-        await this._authenticationProvider.initAsync(this._region);
-        this._logger.trackActivityEvent('Initialize', {
-            verb: this._verb,
-        });
-    }
-    // Handles scenarios where only global flags (e.g., --help/--version) are provided,
-    // or partial commands that should show contextual help (e.g., 'app', 'app add').
-    handleGlobalHelpOrFlagsAndExit() {
-        const firstToken = process.argv[2];
-        if (!firstToken) {
-            this._program.help(); // No arguments at all — show help and exit
-        }
-        // If the first token is a flag (e.g., --version, --help), let Commander handle it
-        if (firstToken.startsWith('-')) {
-            this._program.parse(process.argv);
-            this._isParsed = true;
-            return;
-        }
-        // Deep typed-verb help: when the user has drilled past the resolver's leaf
-        // match (e.g. `ms app share link --help` resolves to the `share` hybrid
-        // parent + extra positional args), surface the deeper typed verb's
-        // subcommand list rather than letting Commander print the parent's help.
-        if (this._tryPrintDeepTypedHelp()) {
-            process.exit(0);
-        }
-        // If no command resolved, surface the most contextual help/error possible.
-        if (!this._resolvedCommand) {
-            // Walk the typed-verb tree along the argv path. This handles every
-            // arbitrarily-deep "incomplete typed group" case in one place — e.g.
-            // `ms app add` (group help), `ms app add bogus` (Unknown type error),
-            // `ms app share link` (deeper group help), `ms app share link bogus`
-            // (Unknown type error).
-            const incomplete = findIncompleteTypedPath(process.argv, COMMAND_TREE);
-            if (incomplete) {
-                if (incomplete.unknownToken !== undefined) {
-                    throw new UsageError(`Unknown type '${incomplete.unknownToken}' for '${CLI_BINARY_NAME} ${incomplete.pathTokens.join(' ')}'. Run "${CLI_BINARY_NAME} ${incomplete.pathTokens.join(' ')} --help" for available types.`);
-                }
-                const helpText = buildPathTypedHelpText(incomplete.pathTokens);
-                if (helpText) {
-                    printInfo(`${getHelpBanner()}\n\n${helpText}`);
-                    process.exit(0);
-                }
-            }
-            // Noun-level fallbacks: noun-only (show noun help) and unknown verb
-            // under a known noun (Unknown command error).
-            if (isKnownNoun(firstToken, COMMAND_TREE)) {
-                const secondToken = process.argv[3];
-                if (secondToken && !secondToken.startsWith('-')) {
-                    throw new UsageError(`Unknown command '${secondToken}' under '${CLI_BINARY_NAME} ${firstToken}'. Run "${CLI_BINARY_NAME} ${firstToken} --help" for available commands.`);
-                }
-                printInfo(`${getHelpBanner()}\n\n${buildNounHelpText(firstToken)}`);
-                process.exit(0);
-            }
-            // Unrecognised top-level token (not a known noun, not a registered command)
-            throw new UsageError(`Unknown command '${firstToken}'. Run "${CLI_BINARY_NAME} --help" for available commands.`);
-        }
-    }
-    /**
-     * Detects `--help` requests on nested typed-verb paths the resolver can't
-     * leaf-match (e.g. `ms app share link --help` — `link` is a nested typed
-     * verb with no handler of its own) and prints the typed verb's flattened
-     * subcommand list. Returns true if it handled the request.
-     *
-     * Skips when the user is asking for help on a path the resolver already
-     * fully matched (those paths route through Commander's normal `--help`
-     * handling at the leaf level).
-     */
-    _tryPrintDeepTypedHelp() {
-        const argv = process.argv.slice(2);
-        const helpIdx = argv.findIndex((t) => t === '--help' || t === '-h');
-        if (helpIdx === -1)
-            return false;
-        const pathTokens = argv.slice(0, helpIdx).filter((t) => !t.startsWith('-'));
-        // Bail when the resolver consumed every non-flag path token already —
-        // those are leaf matches (or noun-only / typed-parent help, both of
-        // which are handled by the existing branches below).
-        if (this._resolvedCommand && pathTokens.length <= this._resolvedCommand.tokensConsumed) {
-            return false;
-        }
-        const helpText = buildPathTypedHelpText(pathTokens);
-        if (!helpText)
-            return false;
-        printInfo(`${getHelpBanner()}\n\n${helpText}`);
-        return true;
-    }
-    getVerb() {
-        if (!this._resolvedCommand) {
-            throw new UsageError(`No command specified. Run "${CLI_BINARY_NAME} --help" for available commands.`);
-        }
-        return this._verb;
-    }
-    getResolvedCommand() {
-        return this._resolvedCommand;
-    }
-    async getOption(key, ignorePrompt) {
-        const settings = getSettings();
-        let value = this._program.getOptionValue(key);
-        const option = this._options[key];
-        // Fallback to environment variable if not provided via CLI
-        if (value === undefined && option && option.env) {
-            value = getCliEnvVar(option.env);
-        }
-        // Fallback to default value if not provided via CLI or Env
-        if (value === undefined && option && option.default !== undefined) {
-            value = option.default;
-        }
-        if (!value && !ignorePrompt && option?.customPrompt) {
-            if (!settings.interactive) {
-                if (option.optionalInNonInteractive) {
-                    // Option is optional — return undefined and let the actions layer handle it.
-                }
-                else {
-                    const flagName = option.flags.key;
-                    const alias = option.flags.alias;
-                    const flagHint = alias ? `--${flagName} (-${alias})` : `--${flagName}`;
-                    const envHint = option.env
-                        ? ` or environment variable (${cliEnvVarFullName(option.env)})`
-                        : '';
-                    throw new UsageError(`Missing required option ${flagHint}${envHint}. In non-interactive mode, all parameters must be provided via flags or environment variables.`);
-                }
-            }
-            else {
-                value = await option.customPrompt();
-            }
-        }
-        // Option could be undefined by design, so just return it.
-        return value;
-    }
-    getAuthenticationProvider() {
-        return this._authenticationProvider;
-    }
-    getAccountManager() {
-        if (!this._accountManager) {
-            throw new UsageError(`Account management commands (auth login/logout/status/switch) are only available in interactive mode. ` +
-                `They cannot be used with service principal or HTTP forward authentication.`);
-        }
-        return this._accountManager;
-    }
-    getHttpClient() {
-        return this._httpClient;
-    }
-    /**
-     * Returns the tenant ID for the authenticated user, acquiring a token first if needed.
-     *
-     * NodeMsalAuthenticationProvider only populates _tenantId after getAccessTokenForResource()
-     * is called. This method pre-acquires a token for the Power Platform resource so the tenant
-     * ID is always available after runVerb() completes.
-     */
-    async getTenantIdAsync() {
-        // Fast path: provider already knows the tenant ID (e.g. ServicePrincipalAuthenticationProvider).
-        const existing = this._authenticationProvider.getUserTenantId();
-        if (existing)
-            return existing;
-        // Acquire a token to populate the tenant ID from the MSAL token response.
-        if (this._region && this._region !== 'local' && this._region !== 'dev') {
-            const resource = getAuthResource()[this._region];
-            await this._authenticationProvider.getAccessTokenForResource(resource);
-        }
-        return this._authenticationProvider.getUserTenantId();
-    }
-    getAuthResourceUrl() {
-        const region = this._region ?? cloudToRegion('public');
-        if (region === 'local' || region === 'dev')
-            return getAuthResource()['test'];
-        return getAuthResource()[region];
-    }
-    getCloud() {
-        return this._cloud;
-    }
-    getLoginAuthority(tenantId) {
-        return getAuthority(this._region, tenantId);
-    }
-    /**
-     * Sets the description for the current command context.
-     * This is used to display help information specific to the verb being executed.
-     *
-     * @param {string} description - The description to set for the program.
-     */
-    setDescription(description) {
-        this._program.description(description);
-    }
-    isJsonMode() {
-        // Once Commander has parsed, opts() is the source of truth and won't
-        // confuse `--json` as a flag with `--json` as a value to another option.
-        // Pre-parse (e.g. a UsageError thrown from handleGlobalHelpOrFlagsAndExit
-        // before parse runs) we have no choice but to peek argv directly.
-        if (this._isParsed) {
-            return this._program.opts().json === true;
-        }
-        return process.argv.includes('--json');
-    }
-    addExamples(examples) {
-        if (!examples || examples.length === 0)
-            return;
-        this._program.addHelpText('after', () => {
-            const lines = ['', 'Examples:'];
-            examples.forEach((example) => {
-                lines.push(`  $ ${example}`);
-            });
-            return lines.join('\n');
-        });
-    }
-    getRegisteredFlags() {
-        const flags = new Set();
-        for (const option of this._program.options) {
-            if (option.long)
-                flags.add(option.long);
-            // Commander also accepts the positive form of negated options (--color for --no-color)
-            if (option.negate && option.long?.startsWith('--no-')) {
-                flags.add(`--${option.long.slice('--no-'.length)}`);
-            }
-        }
-        return flags;
-    }
-    getEnvironmentId(options = {}) {
-        const environmentId = this._resolveEnvironmentId(options);
-        if (environmentId) {
-            this.updateEnvironmentId(environmentId);
-        }
-        return environmentId;
-    }
-    _resolveEnvironmentId(options = {}) {
-        const option = this._options.environmentId;
-        const optionValue = this._program.getOptionValue('environmentId');
-        const environmentValue = normalizeOptionalString(optionValue) ??
-            normalizeOptionalString(option?.env ? getCliEnvVar(option.env) : undefined) ??
-            // includeConfig:false still keeps the debug override available by design.
-            normalizeOptionalString(options.includeConfig === false ? this._debugEnvironmentId : this._environmentId);
-        if (!environmentValue) {
-            return undefined;
-        }
-        return extractEnvironmentId(environmentValue);
-    }
-    updateEnvironmentId(environmentId) {
-        // Idempotent: only update once per command execution.
-        if (this._environmentIdNotified) {
-            return;
-        }
-        const normalizedEnvironmentId = extractEnvironmentId(environmentId.trim());
-        this._environmentId = normalizedEnvironmentId;
-        updateEnvironmentName(normalizedEnvironmentId);
-        if (this._region) {
-            this._logger.setTelemetryContext({
-                environmentId: normalizedEnvironmentId,
-                region: this._region,
-            });
-        }
-        this._environmentIdNotified = true;
-    }
-    async _getRequiredVariables() {
-        if (!this._cloud) {
-            const rawCloud = await this.getOption('cloud');
-            if (rawCloud) {
-                const normalized = rawCloud.toLowerCase();
-                if (!Clouds.includes(normalized)) {
-                    throw new UsageError(`Invalid --cloud value '${rawCloud}'. Valid values are: ${Clouds.join(', ')}.`);
-                }
-                this._cloud = normalized;
-                this._region = cloudToRegion(this._cloud);
-                updateRegion(this._region);
-            }
-        }
-    }
-    /**
-     * @param {CliOption} cliOption
-     * @param {boolean} [hasValue=true] true if the option requires a value, false for a switch such as --help
-     */
-    _createOption(cliOption, hasValue = true) {
-        const isOptional = hasValue && (cliOption.default !== undefined || cliOption.optionalInNonInteractive === true);
-        const description = isOptional
-            ? `[optional] ${cliOption.description ?? ''}`
-            : cliOption.description;
-        const option = this._program.createOption(hasValue ? this._createFlags(cliOption.flags) : this._createSwitchFlags(cliOption.flags), description);
-        if (cliOption.parseArg) {
-            option.argParser(cliOption.parseArg);
-        }
-        // We do not set the env or default here because we want to handle it manually in getOption
-        // This allows us to hide the env variable from the help text
-        // Hide global options from help output when showing global help
-        // This prevents --environment-id and --cloud from showing up in the global help
-        if (!this._resolvedCommand || cliOption.hidden) {
-            option.hideHelp();
-        }
-        this._program.addOption(option);
-        // Map to CliOption using Commander's camelCase attribute name so option
-        // accessors find entries registered with kebab-case flags.
-        this._options[option.attributeName()] = cliOption;
-    }
-    _createFlags(flags) {
-        const { key, alias } = flags;
-        return alias ? `-${alias}, --${key} <${key}>` : `--${key} <${key}>`;
-    }
-    _createSwitchFlags(flags) {
-        const { key, alias } = flags;
-        return alias ? `-${alias}, --${key}` : `--${key}`;
-    }
-}
-//# sourceMappingURL=ArgumentProvider.js.map