@ms-cloudpack/cli 0.77.42 → 0.77.44

package/lib/commands/init/types/InitOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InitOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/types/InitOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,OAAO,GAAG,eAAe,GAAG,eAAe,GAAG,OAAO,CAAC;IAC1F;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"InitOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/types/InitOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CACvC,aAAa,EACb,KAAK,GAAG,OAAO,GAAG,eAAe,GAAG,eAAe,GAAG,OAAO,CAC9D;IACC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/lib/commands/init/types/InitOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"InitOptions.js","sourceRoot":"","sources":["../../../../src/commands/init/types/InitOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReusedOptions } from '../../../types/ReusedOptions.js';\n\n/**\n * Defines the options for the \"init\" command.\n */\nexport interface InitOptions\n  extends Pick<ReusedOptions, 'app' | 'cache' | 'logBundleInfo' | 'logResolveMap' | 'match'> {\n  /**\n   * Ignore the previous generated config.\n   */\n  reset?: boolean;\n\n  /**\n   * Fail if updates to the generated config are required.\n   */\n  check?: boolean;\n}\n"]}
+{"version":3,"file":"InitOptions.js","sourceRoot":"","sources":["../../../../src/commands/init/types/InitOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReusedOptions } from '../../../types/ReusedOptions.js';\n\n/**\n * Defines the options for the \"init\" command.\n */\nexport interface InitOptions extends Pick<\n  ReusedOptions,\n  'app' | 'cache' | 'logBundleInfo' | 'logResolveMap' | 'match'\n> {\n  /**\n   * Ignore the previous generated config.\n   */\n  reset?: boolean;\n\n  /**\n   * Fail if updates to the generated config are required.\n   */\n  check?: boolean;\n}\n"]}

package/lib/commands/start/types/StartOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/start/types/StartOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,eAAe,GAAG,eAAe,GAAG,MAAM,CAAC,EACjG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAExB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACtC"}
+{"version":3,"file":"StartOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/start/types/StartOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,WAAW,YACf,SACE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,eAAe,GAAG,eAAe,GAAG,MAAM,CAAC,EAC3F,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAExB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACtC"}

package/lib/commands/start/types/StartOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"StartOptions.js","sourceRoot":"","sources":["../../../../src/commands/start/types/StartOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServerConfig } from '@ms-cloudpack/common-types';\nimport type { ReusedOptions } from '../../../types/ReusedOptions.js';\n\nexport interface StartOptions\n  extends Pick<ReusedOptions, 'app' | 'cache' | 'login' | 'logBundleInfo' | 'logResolveMap' | 'mode'>,\n    Pick<ServerConfig, 'showOverlay'> {\n  /**\n   * Whether to open the browser or a specific url to open the browser to.\n   * Defaults to the value from `ServerConfig.open` or `true`.\n   */\n  open?: boolean | string;\n\n  /** Mostly for testing: custom port for the API server */\n  apiServerPort?: number | number[];\n\n  /** Mostly for testing: custom port for the app server (also set in config via `server.port`) */\n  appServerPort?: number | number[];\n\n  /** Mostly for testing: custom port for the bundle server */\n  bundleServerPort?: number | number[];\n}\n"]}
+{"version":3,"file":"StartOptions.js","sourceRoot":"","sources":["../../../../src/commands/start/types/StartOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServerConfig } from '@ms-cloudpack/common-types';\nimport type { ReusedOptions } from '../../../types/ReusedOptions.js';\n\nexport interface StartOptions\n  extends\n    Pick<ReusedOptions, 'app' | 'cache' | 'login' | 'logBundleInfo' | 'logResolveMap' | 'mode'>,\n    Pick<ServerConfig, 'showOverlay'> {\n  /**\n   * Whether to open the browser or a specific url to open the browser to.\n   * Defaults to the value from `ServerConfig.open` or `true`.\n   */\n  open?: boolean | string;\n\n  /** Mostly for testing: custom port for the API server */\n  apiServerPort?: number | number[];\n\n  /** Mostly for testing: custom port for the app server (also set in config via `server.port`) */\n  appServerPort?: number | number[];\n\n  /** Mostly for testing: custom port for the bundle server */\n  bundleServerPort?: number | number[];\n}\n"]}

package/lib/types/CommandAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandAction.d.ts","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,uBAAuB,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,iBAAiB,CAAC;IAC7G,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,OAAO,kBAAkB,GAAG,OAAO,oBAAoB,GAAG,OAAO,2BAA2B,CAAC;AAEpH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,MAAM,CAC1D,SAAQ,iBAAiB,EACvB,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IACvC;;;;OAIG;IACH,OAAO,EAAE,QAAQ,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;OAEG;IACH,0BAA0B,EAAE,CAAC,UAAU,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;IAE/D;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI,CACpC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,GAAG,aAAa,CAAC,KAClD,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC,MAAM,MAAM,mBAAmB,CAAC,QAAQ,IAAI;IAC1C,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC"}
+{"version":3,"file":"CommandAction.d.ts","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,uBAAuB,EACvB,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,iBAAiB,CACvE;IACC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,OAAO,kBAAkB,GAAG,OAAO,oBAAoB,GAAG,OAAO,2BAA2B,CAAC;AAEpH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,MAAM,CAC1D,SAAQ,iBAAiB,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IAChE;;;;OAIG;IACH,OAAO,EAAE,QAAQ,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;;;;OAKG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;OAEG;IACH,0BAA0B,EAAE,CAAC,UAAU,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;IAE/D;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI,CACpC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,GAAG,aAAa,CAAC,KAClD,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC,MAAM,MAAM,mBAAmB,CAAC,QAAQ,IAAI;IAC1C,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC"}

package/lib/types/CommandAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandAction.js","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC","sourcesContent":["import type { CreateApiContextOptions } from '@ms-cloudpack/api-server';\nimport type { AutoDispose } from './AutoDispose.js';\nimport type { SharedOptions } from './SharedOptions.js';\nimport type { Span } from '@ms-cloudpack/telemetry';\nimport type { ProgramOptions } from './ProgramOptions.js';\n\n/**\n * Context for running a command in a specific app (after initialization).\n * For convenience, this can be passed/spread directly to `createApiContext`.\n */\nexport interface AppCommandContext\n  extends Pick<CreateApiContextOptions, 'cachePath' | 'config' | 'reporter' | 'taskRunner' | 'telemetryClient'> {\n  /** App path (CWD for most operations). */\n  appPath: string;\n}\n\nexport const ExitCodeSuccessful = 0;\nexport const ExitCodeGenericError = 1;\nexport const ExitCodeAuthenticationError = 2;\nexport type ExitCode = typeof ExitCodeSuccessful | typeof ExitCodeGenericError | typeof ExitCodeAuthenticationError;\n\nexport interface CommandExitParams {\n  /**\n   * Message to show on exit.\n   * If `isInterrupted` is true, use an empty string (it will show a default interrupt message).\n   */\n  message: string;\n  /** Whether there are errors. By default, checks the reporter for failed tasks. */\n  hasErrors?: boolean;\n  /** Exit code to use. Defaults to 1 if there are errors, 0 if not. */\n  exitCode?: ExitCode;\n  /** True if the user interrupted an operation (ctrl+C). Sets the message automatically. */\n  isInterrupted?: boolean;\n  /** Whether to restart the command after it exits. */\n  restart?: boolean;\n}\n\nexport interface CommandActionParams<TOptions extends object>\n  extends AppCommandContext,\n    Pick<ProgramOptions, 'commandEvents'> {\n  /**\n   * Command-specific options, parsed from `process.argv`.\n   * Types are generally defined in each command's `src/commands/<name>/types/<Name>Types.ts` module.\n   * The command line options are defined in each command's `src/commands/<name>/index.ts` module.\n   */\n  options: TOptions;\n\n  /**\n   * Command-specific arguments. Arguments in commander are positional arguments that are not options.\n   * For example, in `echo somestring`, `somestring` is an argument.\n   */\n  args: string[];\n\n  /**\n   * Whether the command is being run for multiple apps. (It only runs on one app at a time, but\n   * multi-app may impact formatting choices or other behaviors.)\n   *\n   * Note that this will only ever be true for commands initialized with `discoverAppPaths: 'multi'`.\n   */\n  isMultiApp: boolean;\n\n  /**\n   * Parent span for the command.\n   */\n  span: Span;\n\n  /**\n   * Function that can be called with any `Disposable`s that should be cleaned up automatically\n   * when the program exits. (See `AutoDisposableList.add` for implementation.)\n   */\n  autoDispose: AutoDispose;\n\n  /**\n   * Set a callback to get the message to display if ctrl+C is pressed.\n   */\n  setInterruptMessageHandler: (getMessage: () => string) => void;\n\n  /**\n   * Indicates whether this command execution is a restart of a previous execution.\n   * When true, the command is being run again due to a restart trigger (e.g., config changes).\n   * This can be used to modify behavior on restart, such as skipping browser opening.\n   */\n  isRestart: boolean;\n}\n\n/**\n * Command action function (executor). This is the type of the `execute` function which should\n * be exported from each command's `src/commands/<name>/execute.ts` module and is called by\n * `CommandExecutor` against each app.\n *\n * - If it returns an object, CommandExecutor will call the exit handler with that object.\n *   - For multi-app, it will exit immediately if `isInterrupted` is set, but otherwise it will\n *     keep running and use the accumulation of the results.\n * - If it returns null, it's assumed that this command is meant to keep running, such as `start`.\n *   - NOTE: Multi-app commands should not return null (if this is needed in the future, it will\n *     require extra logic in CommandExecutor).\n */\nexport type CommandAction<TOptions> = (\n  params: CommandActionParams<TOptions & SharedOptions>,\n) => Promise<CommandExitParams>;\n\nexport type CommandActionModule<TOptions> = {\n  execute: CommandAction<TOptions>;\n};\n"]}
+{"version":3,"file":"CommandAction.js","sourceRoot":"","sources":["../../src/types/CommandAction.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC","sourcesContent":["import type { CreateApiContextOptions } from '@ms-cloudpack/api-server';\nimport type { AutoDispose } from './AutoDispose.js';\nimport type { SharedOptions } from './SharedOptions.js';\nimport type { Span } from '@ms-cloudpack/telemetry';\nimport type { ProgramOptions } from './ProgramOptions.js';\n\n/**\n * Context for running a command in a specific app (after initialization).\n * For convenience, this can be passed/spread directly to `createApiContext`.\n */\nexport interface AppCommandContext extends Pick<\n  CreateApiContextOptions,\n  'cachePath' | 'config' | 'reporter' | 'taskRunner' | 'telemetryClient'\n> {\n  /** App path (CWD for most operations). */\n  appPath: string;\n}\n\nexport const ExitCodeSuccessful = 0;\nexport const ExitCodeGenericError = 1;\nexport const ExitCodeAuthenticationError = 2;\nexport type ExitCode = typeof ExitCodeSuccessful | typeof ExitCodeGenericError | typeof ExitCodeAuthenticationError;\n\nexport interface CommandExitParams {\n  /**\n   * Message to show on exit.\n   * If `isInterrupted` is true, use an empty string (it will show a default interrupt message).\n   */\n  message: string;\n  /** Whether there are errors. By default, checks the reporter for failed tasks. */\n  hasErrors?: boolean;\n  /** Exit code to use. Defaults to 1 if there are errors, 0 if not. */\n  exitCode?: ExitCode;\n  /** True if the user interrupted an operation (ctrl+C). Sets the message automatically. */\n  isInterrupted?: boolean;\n  /** Whether to restart the command after it exits. */\n  restart?: boolean;\n}\n\nexport interface CommandActionParams<TOptions extends object>\n  extends AppCommandContext, Pick<ProgramOptions, 'commandEvents'> {\n  /**\n   * Command-specific options, parsed from `process.argv`.\n   * Types are generally defined in each command's `src/commands/<name>/types/<Name>Types.ts` module.\n   * The command line options are defined in each command's `src/commands/<name>/index.ts` module.\n   */\n  options: TOptions;\n\n  /**\n   * Command-specific arguments. Arguments in commander are positional arguments that are not options.\n   * For example, in `echo somestring`, `somestring` is an argument.\n   */\n  args: string[];\n\n  /**\n   * Whether the command is being run for multiple apps. (It only runs on one app at a time, but\n   * multi-app may impact formatting choices or other behaviors.)\n   *\n   * Note that this will only ever be true for commands initialized with `discoverAppPaths: 'multi'`.\n   */\n  isMultiApp: boolean;\n\n  /**\n   * Parent span for the command.\n   */\n  span: Span;\n\n  /**\n   * Function that can be called with any `Disposable`s that should be cleaned up automatically\n   * when the program exits. (See `AutoDisposableList.add` for implementation.)\n   */\n  autoDispose: AutoDispose;\n\n  /**\n   * Set a callback to get the message to display if ctrl+C is pressed.\n   */\n  setInterruptMessageHandler: (getMessage: () => string) => void;\n\n  /**\n   * Indicates whether this command execution is a restart of a previous execution.\n   * When true, the command is being run again due to a restart trigger (e.g., config changes).\n   * This can be used to modify behavior on restart, such as skipping browser opening.\n   */\n  isRestart: boolean;\n}\n\n/**\n * Command action function (executor). This is the type of the `execute` function which should\n * be exported from each command's `src/commands/<name>/execute.ts` module and is called by\n * `CommandExecutor` against each app.\n *\n * - If it returns an object, CommandExecutor will call the exit handler with that object.\n *   - For multi-app, it will exit immediately if `isInterrupted` is set, but otherwise it will\n *     keep running and use the accumulation of the results.\n * - If it returns null, it's assumed that this command is meant to keep running, such as `start`.\n *   - NOTE: Multi-app commands should not return null (if this is needed in the future, it will\n *     require extra logic in CommandExecutor).\n */\nexport type CommandAction<TOptions> = (\n  params: CommandActionParams<TOptions & SharedOptions>,\n) => Promise<CommandExitParams>;\n\nexport type CommandActionModule<TOptions> = {\n  execute: CommandAction<TOptions>;\n};\n"]}

package/lib/utilities/CloudpackCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudpackCommand.d.ts","sourceRoot":"","sources":["../../src/utilities/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMnF;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM,CACxF,SAAQ,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,CAAC,CAAC;IACnG,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAEpD,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3D,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,WAAW,CAAC,EAAE;QACZ;;;WAGG;QACH,QAAQ,EAAE,mBAAmB,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,aAAa,CAAC,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IAC9E,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;;OAGG;gBAGD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,GAClD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,GAAG;QACxD,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IA0EL,8BAA8B;IACvB,aAAa,CAAC,aAAa,SAAS,MAAM,EAAE,eAAe,SAAS,MAAM,GAAG,KAAK,EACvF,MAAM,EAAE,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,GAC7D,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC;IAQnD,qEAAqE;IACxD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,qGAAqG;IACrG,OAAO,CAAC,aAAa;IAMrB,iGAAiG;IACjG,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,UAAU;CAoCnB"}
+{"version":3,"file":"CloudpackCommand.d.ts","sourceRoot":"","sources":["../../src/utilities/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMnF;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM,CAAE,SAAQ,OAAO,CACzG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,CAAC,CACnF;IACC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAEpD,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE1C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3D,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yDAAyD;IACzD,WAAW,CAAC,EAAE;QACZ;;;WAGG;QACH,QAAQ,EAAE,mBAAmB,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,aAAa,CAAC,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IAC9E,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;;OAGG;gBAGD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,GAClD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,GAAG;QACxD,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IA0EL,8BAA8B;IACvB,aAAa,CAAC,aAAa,SAAS,MAAM,EAAE,eAAe,SAAS,MAAM,GAAG,KAAK,EACvF,MAAM,EAAE,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,GAC7D,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC;IAQnD,qEAAqE;IACxD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,qGAAqG;IACrG,OAAO,CAAC,aAAa;IAMrB,iGAAiG;IACjG,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,UAAU;CAsCnB"}

package/lib/utilities/CloudpackCommand.js

@@ -123,6 +123,7 @@ export class CloudpackCommand {
             // (In `cloudpackCommand`, we added the shared options to each command object so that they show up
             // in help, but commander still seems to respect options only at the first command where they're
             // encountered, which for shared options will always be the program command.)
+            // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
             const options = command.optsWithGlobals();
             // Usually `command` will be a sub-command (e.g. "bundle"), but it could also be a sub-sub-command
             // (e.g. "cache clean").
@@ -133,6 +134,7 @@ export class CloudpackCommand {
                 // throw instead of exiting politely, since this is a major developer error
                 throw new Error(`No execute function was exported from the command module for ${verb}.`);
             }
+            // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
             const commandExecutor = new CommandExecutor({
                 args: processedArgs,
                 options,

package/lib/utilities/CloudpackCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"CloudpackCommand.js","sourceRoot":"","sources":["../../src/utilities/CloudpackCommand.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command, Option, type AddHelpTextPosition, type Argument, type OutputConfiguration } from 'commander';\nimport type { CommandActionModule } from '../types/CommandAction.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { CommandExecutor, type CommandExecutorParams } from './CommandExecutor.js';\nimport { environmentInfo } from '@ms-cloudpack/environment';\nimport { parseFeature } from './parseFeature.js';\nimport { parseDefine } from './parseDefine.js';\nimport { CloudpackHelp, optionGroups } from './CloudpackHelp.js';\n\n/**\n * Parameters for creating a command.\n * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.\n */\nexport interface CloudpackCommandParams<TOptions extends object, TArguments extends object>\n  extends Partial<Pick<CommandExecutorParams<TOptions>, 'discoverAppPaths' | 'applyOptionsToConfig'>> {\n  /** Command name */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /**\n   * Options specific to this command. The record ensures that all options are available in the CLI.\n   * Allow multiple options for the same key since commander supports it with negatable options.\n   */\n  options?: Record<keyof TOptions, Option | Option[]>; //\n\n  /** Arguments specific to this command. Key order determines the arg order. */\n  args?: Record<keyof TArguments, Argument>;\n\n  /**\n   * Function returning an async import of the command's `src/commands/<name>/execute.ts` module.\n   * Importing only on demand makes Cloudpack start up faster since it doesn't have to parse\n   * every command's dependencies (many of which may be unrelated to the command being run).\n   *\n   * This can be undefined for a command that only has sub-commands.\n   */\n  getExecutor?: () => Promise<CommandActionModule<TOptions>>;\n\n  /** Usage message override */\n  usage?: string;\n\n  /** Alternative name for the command */\n  alias?: string;\n\n  /** Extra text to be displayed with the built-in help. */\n  addHelpText?: {\n    /**\n     * `'before'` or `'after'` to affect just this command.\n     * `'beforeAll'` or `'afterAll'` to affect this command and all its subcommands.\n     */\n    position: AddHelpTextPosition;\n    text: string;\n  };\n\n  /** Output options override (mainly for testing) */\n  outputOptions?: OutputConfiguration;\n\n  /**\n   * The shared options are relevant for most commands, but this allows omitting them from help\n   * where they're not relevant. `true` hides all shared options, or an array hides specific ones.\n   */\n  hideSharedOptions?: Array<keyof SharedOptions> | true;\n}\n\n/**\n * This wraps the `Command` class from [`commander`](https://www.npmjs.com/package/commander) with\n * Cloudpack-specific functionality and simpler APIs.\n *\n * Similar to the pattern from `commander`, this class represents both the program and its sub-commands.\n * - The top-level \"program\" command should be created with `new CloudpackCommand()`.\n * - Sub-commands should be created with the `.addSubCommand` method on the parent.\n */\nexport class CloudpackCommand<TOptions extends object, TArguments extends object> {\n  private _command: Command;\n  private _executorOptions: Pick<\n    CommandExecutorParams<TOptions>,\n    'programOptions' | 'discoverAppPaths' | 'applyOptionsToConfig'\n  >;\n\n  /**\n   * This should only be used directly (outside this class) to create the top-level `program` command.\n   * To add sub-commands, use `.addSubCommand` instead.\n   */\n  constructor(\n    // The extra options here shouldn't be exposed to the `createSubCommand` API\n    params: CloudpackCommandParams<TOptions, TArguments> &\n      Pick<CommandExecutorParams<TOptions>, 'programOptions'> & {\n        /** This must be undefined for the top-level program command */\n        parent?: Command;\n      },\n  ) {\n    this._executorOptions = {\n      programOptions: params.programOptions,\n      discoverAppPaths: params.discoverAppPaths,\n      applyOptionsToConfig: params.applyOptionsToConfig,\n    };\n\n    const command = params.parent?.command(params.name) || new Command(params.name);\n    this._command = command;\n\n    command.version(params.programOptions.version);\n    command.description(params.description);\n    command.allowExcessArguments(false);\n\n    const isTopLevel = !params.parent;\n    command.createHelp = () => new CloudpackHelp({ isTopLevel });\n    // set the default help group for options\n    command.optionsGroup(optionGroups.default);\n\n    params.usage && command.usage(params.usage);\n    params.alias && command.alias(params.alias);\n    params.addHelpText && command.addHelpText(params.addHelpText.position, params.addHelpText.text);\n    params.outputOptions && command.configureOutput(params.outputOptions);\n    params.getExecutor && this._addAction(params.getExecutor);\n\n    if (params.args) {\n      this._addArguments<TArguments>(params.args);\n    }\n\n    if (params.options) {\n      // Add the command-specific options first so they show up first in help\n      this._addOptions<TOptions>(params.options);\n    }\n\n    // Add shared options. These must be manually added to the program command and each sub-command\n    // because commander doesn't natively support inheriting options.\n    this._addOptions<SharedOptions>(\n      {\n        verbose: new Option('-v, --verbose', 'Show additional details in logging.').helpGroup(optionGroups.logging),\n        debug: new Option('-d, --debug', 'Show debug information (superset of --verbose).')\n          .conflicts('verbose')\n          .helpGroup(optionGroups.logging),\n        quiet: new Option('-q, --quiet', 'Disable non-essential logging.')\n          .conflicts('verbose')\n          .conflicts('debug')\n          .helpGroup(optionGroups.logging),\n        color:\n          // In the parsed options, this will be a boolean `color` with default value true, except in tests, CI, or environments without a TTY (e.g., concurrently).\n          new Option('-n, --no-color', 'Disable colors in the output.')\n            .helpGroup(optionGroups.logging)\n            .default(\n              !environmentInfo.isJest && !environmentInfo.isLage && !environmentInfo.isCI && !!process.stdout.isTTY,\n            ),\n        logFile: new Option('--log-file', 'Write a log file with all console output.').helpGroup(optionGroups.logging),\n        cachePath: new Option(\n          '--cache-path <path>',\n          'Custom cache folder. To change the default, run `cloudpack config set cachePath <path>`.',\n        ).helpGroup(optionGroups.common),\n        config: new Option(\n          '-c, --config <filename>',\n          'Custom config file name to use instead of cloudpack.config.json.',\n        ).helpGroup(optionGroups.common),\n        define: new Option('--define <key=value>', 'Define a global variable. Can be specified multiple times.')\n          .helpGroup(optionGroups.common)\n          .argParser(parseDefine),\n        features: new Option('--features <featureNames...>', 'Enable experimental features.')\n          .helpGroup(optionGroups.common)\n          .argParser(parseFeature),\n      },\n      params.hideSharedOptions,\n    );\n  }\n\n  /** Create a child command. */\n  public addSubCommand<TChildOptions extends object, TChildArguments extends object = never>(\n    params: CloudpackCommandParams<TChildOptions, TChildArguments>,\n  ): CloudpackCommand<TChildOptions, TChildArguments> {\n    return new CloudpackCommand<TChildOptions, TChildArguments>({\n      ...params,\n      programOptions: this._executorOptions.programOptions,\n      parent: this._command,\n    });\n  }\n\n  /** Run the program (only works on the top-level program command). */\n  public async run(): Promise<void> {\n    if (this._command.parent) {\n      throw new Error('Only the top-level program command can be run directly.');\n    }\n\n    await this._command.parseAsync(this._executorOptions.programOptions.argv);\n    if (this._command.args.length === 0) {\n      this._command.help();\n    }\n  }\n\n  /** Add arguments. The generic enforces that argument objects are included for all keys of a type. */\n  private _addArguments<TAddArguments extends object>(args: Record<keyof TAddArguments, Argument>): void {\n    for (const argument of Object.values(args)) {\n      this._command.addArgument(argument as Argument);\n    }\n  }\n\n  /** Add options. The generic enforces that option objects are included for all keys of a type. */\n  private _addOptions<TAddOptions extends object>(\n    options: Record<keyof TAddOptions, Option | Option[]>,\n    hideOptions?: Array<keyof TAddOptions> | true,\n  ): void {\n    for (const [name, optionOrOptions] of Object.entries(options) as [keyof TAddOptions, Option | Option[]][]) {\n      const optionArray = Array.isArray(optionOrOptions) ? optionOrOptions : [optionOrOptions];\n      for (const option of optionArray) {\n        if (hideOptions === true || hideOptions?.includes(name)) {\n          option.hideHelp();\n        }\n        this._command.addOption(option);\n      }\n    }\n  }\n\n  private _addAction(getExecutor: NonNullable<CloudpackCommandParams<TOptions, TArguments>['getExecutor']>): void {\n    const command = this._command;\n    // The action function receives parsed options as its first parameter, but we ignore those\n    // because they only contain options *specific to this command*, not shared options like `debug`.\n    command.action(async () => {\n      // Commander has support for custom parsers that parse arguments.\n      // Use processedArgs instead of args to get the parsed arguments.\n      const processedArgs = command.processedArgs as string[];\n\n      // Get the shared options too, not just the ones for this command.\n      // (In `cloudpackCommand`, we added the shared options to each command object so that they show up\n      // in help, but commander still seems to respect options only at the first command where they're\n      // encountered, which for shared options will always be the program command.)\n      const options = command.optsWithGlobals<TOptions & SharedOptions>();\n\n      // Usually `command` will be a sub-command (e.g. \"bundle\"), but it could also be a sub-sub-command\n      // (e.g. \"cache clean\").\n      const verb = command.parent?.parent ? `${command.parent.name()} ${command.name()}` : command.name();\n\n      // Dynamically import the execute function\n      const { execute } = await getExecutor();\n      if (typeof execute !== 'function') {\n        // throw instead of exiting politely, since this is a major developer error\n        throw new Error(`No execute function was exported from the command module for ${verb}.`);\n      }\n\n      const commandExecutor = new CommandExecutor<TOptions & SharedOptions>({\n        args: processedArgs,\n        options,\n        execute,\n        verb,\n        ...this._executorOptions,\n      });\n      await commandExecutor.execute();\n    });\n  }\n}\n"]}
+{"version":3,"file":"CloudpackCommand.js","sourceRoot":"","sources":["../../src/utilities/CloudpackCommand.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command, Option, type AddHelpTextPosition, type Argument, type OutputConfiguration } from 'commander';\nimport type { CommandActionModule } from '../types/CommandAction.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { CommandExecutor, type CommandExecutorParams } from './CommandExecutor.js';\nimport { environmentInfo } from '@ms-cloudpack/environment';\nimport { parseFeature } from './parseFeature.js';\nimport { parseDefine } from './parseDefine.js';\nimport { CloudpackHelp, optionGroups } from './CloudpackHelp.js';\n\n/**\n * Parameters for creating a command.\n * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.\n */\nexport interface CloudpackCommandParams<TOptions extends object, TArguments extends object> extends Partial<\n  Pick<CommandExecutorParams<TOptions>, 'discoverAppPaths' | 'applyOptionsToConfig'>\n> {\n  /** Command name */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /**\n   * Options specific to this command. The record ensures that all options are available in the CLI.\n   * Allow multiple options for the same key since commander supports it with negatable options.\n   */\n  options?: Record<keyof TOptions, Option | Option[]>; //\n\n  /** Arguments specific to this command. Key order determines the arg order. */\n  args?: Record<keyof TArguments, Argument>;\n\n  /**\n   * Function returning an async import of the command's `src/commands/<name>/execute.ts` module.\n   * Importing only on demand makes Cloudpack start up faster since it doesn't have to parse\n   * every command's dependencies (many of which may be unrelated to the command being run).\n   *\n   * This can be undefined for a command that only has sub-commands.\n   */\n  getExecutor?: () => Promise<CommandActionModule<TOptions>>;\n\n  /** Usage message override */\n  usage?: string;\n\n  /** Alternative name for the command */\n  alias?: string;\n\n  /** Extra text to be displayed with the built-in help. */\n  addHelpText?: {\n    /**\n     * `'before'` or `'after'` to affect just this command.\n     * `'beforeAll'` or `'afterAll'` to affect this command and all its subcommands.\n     */\n    position: AddHelpTextPosition;\n    text: string;\n  };\n\n  /** Output options override (mainly for testing) */\n  outputOptions?: OutputConfiguration;\n\n  /**\n   * The shared options are relevant for most commands, but this allows omitting them from help\n   * where they're not relevant. `true` hides all shared options, or an array hides specific ones.\n   */\n  hideSharedOptions?: Array<keyof SharedOptions> | true;\n}\n\n/**\n * This wraps the `Command` class from [`commander`](https://www.npmjs.com/package/commander) with\n * Cloudpack-specific functionality and simpler APIs.\n *\n * Similar to the pattern from `commander`, this class represents both the program and its sub-commands.\n * - The top-level \"program\" command should be created with `new CloudpackCommand()`.\n * - Sub-commands should be created with the `.addSubCommand` method on the parent.\n */\nexport class CloudpackCommand<TOptions extends object, TArguments extends object> {\n  private _command: Command;\n  private _executorOptions: Pick<\n    CommandExecutorParams<TOptions>,\n    'programOptions' | 'discoverAppPaths' | 'applyOptionsToConfig'\n  >;\n\n  /**\n   * This should only be used directly (outside this class) to create the top-level `program` command.\n   * To add sub-commands, use `.addSubCommand` instead.\n   */\n  constructor(\n    // The extra options here shouldn't be exposed to the `createSubCommand` API\n    params: CloudpackCommandParams<TOptions, TArguments> &\n      Pick<CommandExecutorParams<TOptions>, 'programOptions'> & {\n        /** This must be undefined for the top-level program command */\n        parent?: Command;\n      },\n  ) {\n    this._executorOptions = {\n      programOptions: params.programOptions,\n      discoverAppPaths: params.discoverAppPaths,\n      applyOptionsToConfig: params.applyOptionsToConfig,\n    };\n\n    const command = params.parent?.command(params.name) || new Command(params.name);\n    this._command = command;\n\n    command.version(params.programOptions.version);\n    command.description(params.description);\n    command.allowExcessArguments(false);\n\n    const isTopLevel = !params.parent;\n    command.createHelp = () => new CloudpackHelp({ isTopLevel });\n    // set the default help group for options\n    command.optionsGroup(optionGroups.default);\n\n    params.usage && command.usage(params.usage);\n    params.alias && command.alias(params.alias);\n    params.addHelpText && command.addHelpText(params.addHelpText.position, params.addHelpText.text);\n    params.outputOptions && command.configureOutput(params.outputOptions);\n    params.getExecutor && this._addAction(params.getExecutor);\n\n    if (params.args) {\n      this._addArguments<TArguments>(params.args);\n    }\n\n    if (params.options) {\n      // Add the command-specific options first so they show up first in help\n      this._addOptions<TOptions>(params.options);\n    }\n\n    // Add shared options. These must be manually added to the program command and each sub-command\n    // because commander doesn't natively support inheriting options.\n    this._addOptions<SharedOptions>(\n      {\n        verbose: new Option('-v, --verbose', 'Show additional details in logging.').helpGroup(optionGroups.logging),\n        debug: new Option('-d, --debug', 'Show debug information (superset of --verbose).')\n          .conflicts('verbose')\n          .helpGroup(optionGroups.logging),\n        quiet: new Option('-q, --quiet', 'Disable non-essential logging.')\n          .conflicts('verbose')\n          .conflicts('debug')\n          .helpGroup(optionGroups.logging),\n        color:\n          // In the parsed options, this will be a boolean `color` with default value true, except in tests, CI, or environments without a TTY (e.g., concurrently).\n          new Option('-n, --no-color', 'Disable colors in the output.')\n            .helpGroup(optionGroups.logging)\n            .default(\n              !environmentInfo.isJest && !environmentInfo.isLage && !environmentInfo.isCI && !!process.stdout.isTTY,\n            ),\n        logFile: new Option('--log-file', 'Write a log file with all console output.').helpGroup(optionGroups.logging),\n        cachePath: new Option(\n          '--cache-path <path>',\n          'Custom cache folder. To change the default, run `cloudpack config set cachePath <path>`.',\n        ).helpGroup(optionGroups.common),\n        config: new Option(\n          '-c, --config <filename>',\n          'Custom config file name to use instead of cloudpack.config.json.',\n        ).helpGroup(optionGroups.common),\n        define: new Option('--define <key=value>', 'Define a global variable. Can be specified multiple times.')\n          .helpGroup(optionGroups.common)\n          .argParser(parseDefine),\n        features: new Option('--features <featureNames...>', 'Enable experimental features.')\n          .helpGroup(optionGroups.common)\n          .argParser(parseFeature),\n      },\n      params.hideSharedOptions,\n    );\n  }\n\n  /** Create a child command. */\n  public addSubCommand<TChildOptions extends object, TChildArguments extends object = never>(\n    params: CloudpackCommandParams<TChildOptions, TChildArguments>,\n  ): CloudpackCommand<TChildOptions, TChildArguments> {\n    return new CloudpackCommand<TChildOptions, TChildArguments>({\n      ...params,\n      programOptions: this._executorOptions.programOptions,\n      parent: this._command,\n    });\n  }\n\n  /** Run the program (only works on the top-level program command). */\n  public async run(): Promise<void> {\n    if (this._command.parent) {\n      throw new Error('Only the top-level program command can be run directly.');\n    }\n\n    await this._command.parseAsync(this._executorOptions.programOptions.argv);\n    if (this._command.args.length === 0) {\n      this._command.help();\n    }\n  }\n\n  /** Add arguments. The generic enforces that argument objects are included for all keys of a type. */\n  private _addArguments<TAddArguments extends object>(args: Record<keyof TAddArguments, Argument>): void {\n    for (const argument of Object.values(args)) {\n      this._command.addArgument(argument as Argument);\n    }\n  }\n\n  /** Add options. The generic enforces that option objects are included for all keys of a type. */\n  private _addOptions<TAddOptions extends object>(\n    options: Record<keyof TAddOptions, Option | Option[]>,\n    hideOptions?: Array<keyof TAddOptions> | true,\n  ): void {\n    for (const [name, optionOrOptions] of Object.entries(options) as [keyof TAddOptions, Option | Option[]][]) {\n      const optionArray = Array.isArray(optionOrOptions) ? optionOrOptions : [optionOrOptions];\n      for (const option of optionArray) {\n        if (hideOptions === true || hideOptions?.includes(name)) {\n          option.hideHelp();\n        }\n        this._command.addOption(option);\n      }\n    }\n  }\n\n  private _addAction(getExecutor: NonNullable<CloudpackCommandParams<TOptions, TArguments>['getExecutor']>): void {\n    const command = this._command;\n    // The action function receives parsed options as its first parameter, but we ignore those\n    // because they only contain options *specific to this command*, not shared options like `debug`.\n    command.action(async () => {\n      // Commander has support for custom parsers that parse arguments.\n      // Use processedArgs instead of args to get the parsed arguments.\n      const processedArgs = command.processedArgs as string[];\n\n      // Get the shared options too, not just the ones for this command.\n      // (In `cloudpackCommand`, we added the shared options to each command object so that they show up\n      // in help, but commander still seems to respect options only at the first command where they're\n      // encountered, which for shared options will always be the program command.)\n      // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\n      const options = command.optsWithGlobals<TOptions & SharedOptions>();\n\n      // Usually `command` will be a sub-command (e.g. \"bundle\"), but it could also be a sub-sub-command\n      // (e.g. \"cache clean\").\n      const verb = command.parent?.parent ? `${command.parent.name()} ${command.name()}` : command.name();\n\n      // Dynamically import the execute function\n      const { execute } = await getExecutor();\n      if (typeof execute !== 'function') {\n        // throw instead of exiting politely, since this is a major developer error\n        throw new Error(`No execute function was exported from the command module for ${verb}.`);\n      }\n\n      // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\n      const commandExecutor = new CommandExecutor<TOptions & SharedOptions>({\n        args: processedArgs,\n        options,\n        execute,\n        verb,\n        ...this._executorOptions,\n      });\n      await commandExecutor.execute();\n    });\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/cli",
-  "version": "0.77.42",
+  "version": "0.77.44",
   "description": "The Cloudpack command line interface - a tool for managing fast inner and outer looping in web apps.",
   "license": "MIT",
   "type": "module",
@@ -30,25 +30,25 @@
     "test": "cloudpack-scripts test"
   },
   "dependencies": {
-    "@ms-cloudpack/api-server": "^0.66.8",
-    "@ms-cloudpack/app-server": "^0.20.47",
-    "@ms-cloudpack/bundler": "^0.27.11",
+    "@ms-cloudpack/api-server": "^0.66.10",
+    "@ms-cloudpack/app-server": "^0.20.49",
+    "@ms-cloudpack/bundler": "^0.27.13",
     "@ms-cloudpack/bundler-capabilities": "^0.5.1",
     "@ms-cloudpack/common-types": "^0.33.2",
-    "@ms-cloudpack/config": "^0.38.26",
+    "@ms-cloudpack/config": "^0.38.28",
     "@ms-cloudpack/create-express-app": "^1.10.69",
     "@ms-cloudpack/environment": "^0.1.1",
     "@ms-cloudpack/file-watcher": "^0.4.28",
     "@ms-cloudpack/json-utilities": "^0.1.11",
-    "@ms-cloudpack/link-proxy": "^0.2.69",
-    "@ms-cloudpack/overlay": "^0.19.65",
-    "@ms-cloudpack/package-utilities": "^13.3.2",
+    "@ms-cloudpack/link-proxy": "^0.2.71",
+    "@ms-cloudpack/overlay": "^0.19.67",
+    "@ms-cloudpack/package-utilities": "^13.3.4",
     "@ms-cloudpack/path-string-parsing": "^1.3.0",
     "@ms-cloudpack/path-utilities": "^3.2.5",
-    "@ms-cloudpack/remote-cache": "^0.11.61",
+    "@ms-cloudpack/remote-cache": "^0.11.63",
     "@ms-cloudpack/setup-utilities": "^0.5.56",
     "@ms-cloudpack/task-reporter": "^0.17.4",
-    "@ms-cloudpack/telemetry": "^0.11.61",
+    "@ms-cloudpack/telemetry": "^0.11.63",
     "@yarnpkg/lockfile": "^1.1.0",
     "commander": "^14.0.0",
     "cross-spawn": "^7.0.3",