@ms-cloudpack/cli 0.70.0 → 0.70.2

package/lib/commands/bundle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/bundle/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAK9E,iCAAiC;AACjC,eAAO,MAAM,IAAI,EAAE,mBAyBlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/bundle/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAK9E,iCAAiC;AACjC,eAAO,MAAM,IAAI,EAAE,mBAuBlB,CAAC"}

package/lib/commands/bundle/index.js

@@ -1,23 +1,21 @@
 import { InvalidArgumentError, Option } from 'commander';
 import { parseMatch } from '../../utilities/parseMatch.js';
-import { parseBundleMode } from '../../utilities/parseBundleMode.js';
+import { reusedOptions } from '../../utilities/reusedOptions.js';
 /** Defines the "bundle" verb. */
 export const init = (program) => {
     program.addSubCommand({
         name: 'bundle',
         description: 'Bundles a package.',
         options: {
-            mode: new Option('--mode <mode>', 'The mode to run the app in. (library | development | production)')
-                .argParser(parseBundleMode)
-                .default('library'),
-            bundler: new Option('--bundler <name>', 'Forces use of a specific bundler.'),
+            mode: reusedOptions.mode({ action: 'bundle' }),
+            bundler: new Option('--bundler <name>', 'Force using a specific bundler.').choices(['ori', 'rollup', 'webpack']),
             match: new Option('--match <match...>', 'Bundle specific package(s), optionally with a version: e.g. "foo", "@foo/*", "foo@1.2.3"').argParser(parseMatch),
             package: new Option('--package <package>').hideHelp().argParser(() => {
                 throw new InvalidArgumentError('Use --match instead of --package');
             }),
-            outdir: new Option('--outdir <path>', 'Path to drop the bundle output, relative to current or package path. ' +
-                'If not set, uses the default path under the cloudpack cache.'),
-            disableSourceMaps: new Option('--disable-source-maps', 'Disables source maps.'),
+            outdir: new Option('--outdir <path>', 'Path for the bundle output, relative to current path (or the resolved path to --package if specified). ' +
+                'Default is a path under the cloudpack cache.'),
+            disableSourceMaps: new Option('--disable-source-maps', 'Disable source maps.'),
         },
         getExecutor: () => import('./execute.js'),
     });

package/lib/commands/bundle/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/bundle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAgB;QACnC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,MAAM,CAAC,eAAe,EAAE,kEAAkE,CAAC;iBAClG,SAAS,CAAC,eAAe,CAAC;iBAC1B,OAAO,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,IAAI,MAAM,CAAC,kBAAkB,EAAE,mCAAmC,CAAC;YAC5E,KAAK,EAAE,IAAI,MAAM,CACf,oBAAoB,EACpB,0FAA0F,CAC3F,CAAC,SAAS,CAAC,UAAU,CAAC;YACvB,OAAO,EAAE,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnE,MAAM,IAAI,oBAAoB,CAAC,kCAAkC,CAAC,CAAC;YACrE,CAAC,CAAC;YACF,MAAM,EAAE,IAAI,MAAM,CAChB,iBAAiB,EACjB,uEAAuE;gBACrE,8DAA8D,CACjE;YACD,iBAAiB,EAAE,IAAI,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;SAChF;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { InvalidArgumentError, Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { BundleOptions } from './types/BundleOptions.js';\nimport { parseMatch } from '../../utilities/parseMatch.js';\nimport { parseBundleMode } from '../../utilities/parseBundleMode.js';\n\n/** Defines the \"bundle\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<BundleOptions>({\n    name: 'bundle',\n    description: 'Bundles a package.',\n    options: {\n      mode: new Option('--mode <mode>', 'The mode to run the app in. (library | development | production)')\n        .argParser(parseBundleMode)\n        .default('library'),\n      bundler: new Option('--bundler <name>', 'Forces use of a specific bundler.'),\n      match: new Option(\n        '--match <match...>',\n        'Bundle specific package(s), optionally with a version: e.g. \"foo\", \"@foo/*\", \"foo@1.2.3\"',\n      ).argParser(parseMatch),\n      package: new Option('--package <package>').hideHelp().argParser(() => {\n        throw new InvalidArgumentError('Use --match instead of --package');\n      }),\n      outdir: new Option(\n        '--outdir <path>',\n        'Path to drop the bundle output, relative to current or package path. ' +\n          'If not set, uses the default path under the cloudpack cache.',\n      ),\n      disableSourceMaps: new Option('--disable-source-maps', 'Disables source maps.'),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/bundle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAgB;QACnC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE;YACP,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC9C,OAAO,EAAE,IAAI,MAAM,CAAC,kBAAkB,EAAE,iCAAiC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAChH,KAAK,EAAE,IAAI,MAAM,CACf,oBAAoB,EACpB,0FAA0F,CAC3F,CAAC,SAAS,CAAC,UAAU,CAAC;YACvB,OAAO,EAAE,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;gBACnE,MAAM,IAAI,oBAAoB,CAAC,kCAAkC,CAAC,CAAC;YACrE,CAAC,CAAC;YACF,MAAM,EAAE,IAAI,MAAM,CAChB,iBAAiB,EACjB,yGAAyG;gBACvG,8CAA8C,CACjD;YACD,iBAAiB,EAAE,IAAI,MAAM,CAAC,uBAAuB,EAAE,sBAAsB,CAAC;SAC/E;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { InvalidArgumentError, Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { BundleOptions } from './types/BundleOptions.js';\nimport { parseMatch } from '../../utilities/parseMatch.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"bundle\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<BundleOptions>({\n    name: 'bundle',\n    description: 'Bundles a package.',\n    options: {\n      mode: reusedOptions.mode({ action: 'bundle' }),\n      bundler: new Option('--bundler <name>', 'Force using a specific bundler.').choices(['ori', 'rollup', 'webpack']),\n      match: new Option(\n        '--match <match...>',\n        'Bundle specific package(s), optionally with a version: e.g. \"foo\", \"@foo/*\", \"foo@1.2.3\"',\n      ).argParser(parseMatch),\n      package: new Option('--package <package>').hideHelp().argParser(() => {\n        throw new InvalidArgumentError('Use --match instead of --package');\n      }),\n      outdir: new Option(\n        '--outdir <path>',\n        'Path for the bundle output, relative to current path (or the resolved path to --package if specified). ' +\n          'Default is a path under the cloudpack cache.',\n      ),\n      disableSourceMaps: new Option('--disable-source-maps', 'Disable source maps.'),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}

package/lib/commands/bundle/types/BundleOptions.d.ts

@@ -1,7 +1,10 @@
 import type { BundleMode, PackageSettingsMatch } from '@ms-cloudpack/common-types';
 export interface BundleOptions {
     /**
-     * Forces use of a specific bundler. 'ori' | 'rollup' | 'auto'. Defaults to "auto".
+     * Force using a specific bundler (ori/rollup/webpack).
+     *
+     * Default is automatically choosing the bundler based on package contents, unless there any
+     * relevant package settings specify a bundler.
      */
     bundler?: string;
     /**
@@ -9,7 +12,7 @@ export interface BundleOptions {
      */
     disableSourceMaps?: boolean;
     /**
-     * Path to drop the bundle output. This is usually relative to the app path.
+     * Path for the bundle output. This is usually relative to the app path.
      * If `package` is set, it's relative to the package path.
      *
      * If not set, the bundle output is dropped in the default path under the cloudpack cache.
@@ -23,7 +26,7 @@ export interface BundleOptions {
      * If set, only evaluate matching packages.
      */
     match?: PackageSettingsMatch[];
-    /** The mode to bundle in (library/development/production). */
+    /** The mode to bundle in. */
     mode: BundleMode;
 }
 //# sourceMappingURL=BundleOptions.d.ts.map

package/lib/commands/bundle/types/BundleOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BundleOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/bundle/types/BundleOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAE/B,8DAA8D;IAC9D,IAAI,EAAE,UAAU,CAAC;CAClB"}
+{"version":3,"file":"BundleOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/bundle/types/BundleOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAE/B,6BAA6B;IAC7B,IAAI,EAAE,UAAU,CAAC;CAClB"}

package/lib/commands/bundle/types/BundleOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"BundleOptions.js","sourceRoot":"","sources":["../../../../src/commands/bundle/types/BundleOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BundleMode, PackageSettingsMatch } from '@ms-cloudpack/common-types';\n\nexport interface BundleOptions {\n  /**\n   * Forces use of a specific bundler. 'ori' | 'rollup' | 'auto'. Defaults to \"auto\".\n   */\n  bundler?: string;\n\n  /**\n   * Disables source maps.\n   */\n  disableSourceMaps?: boolean;\n\n  /**\n   * Path to drop the bundle output. This is usually relative to the app path.\n   * If `package` is set, it's relative to the package path.\n   *\n   * If not set, the bundle output is dropped in the default path under the cloudpack cache.\n   */\n  outdir?: string;\n\n  /**\n   * @deprecated Removed in favor of `match`.\n   */\n  package?: string;\n\n  /**\n   * If set, only evaluate matching packages.\n   */\n  match?: PackageSettingsMatch[];\n\n  /** The mode to bundle in (library/development/production). */\n  mode: BundleMode;\n}\n"]}
+{"version":3,"file":"BundleOptions.js","sourceRoot":"","sources":["../../../../src/commands/bundle/types/BundleOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { BundleMode, PackageSettingsMatch } from '@ms-cloudpack/common-types';\n\nexport interface BundleOptions {\n  /**\n   * Force using a specific bundler (ori/rollup/webpack).\n   *\n   * Default is automatically choosing the bundler based on package contents, unless there any\n   * relevant package settings specify a bundler.\n   */\n  bundler?: string;\n\n  /**\n   * Disables source maps.\n   */\n  disableSourceMaps?: boolean;\n\n  /**\n   * Path for the bundle output. This is usually relative to the app path.\n   * If `package` is set, it's relative to the package path.\n   *\n   * If not set, the bundle output is dropped in the default path under the cloudpack cache.\n   */\n  outdir?: string;\n\n  /**\n   * @deprecated Removed in favor of `match`.\n   */\n  package?: string;\n\n  /**\n   * If set, only evaluate matching packages.\n   */\n  match?: PackageSettingsMatch[];\n\n  /** The mode to bundle in. */\n  mode: BundleMode;\n}\n"]}

package/lib/commands/init/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAK9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBAmBlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAK9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBAoBlB,CAAC"}

package/lib/commands/init/index.js

@@ -5,11 +5,12 @@ import { reusedOptions } from '../../utilities/reusedOptions.js';
 export const init = (program) => {
     program.addSubCommand({
         name: 'init',
-        description: 'Initializes a given app project and defines the necessary configuration overrides to make an existing app compatible with Cloudpack.',
+        description: "Validate an app's compatibility with Cloudpack, and generate any necessary " +
+            'configuration overrides (cloudpack.generated.json).',
         options: {
             logResolveMap: reusedOptions.logResolveMap(),
-            reset: new Option('--reset', 'Ignores existing overrides when determining all entries.').conflicts('check'),
-            check: new Option('--check', 'Fails if any package exports are missing.').conflicts('reset'),
+            reset: new Option('--reset', 'Ignore the previous generated config.').conflicts('check'),
+            check: new Option('--check', 'Fail if updates to the generated config are required.').conflicts('reset'),
             match: new Option('--match <match...>', 'Only evaluate specific package(s), optionally with a version: e.g. "foo", "@foo/*", "foo@1.2.3"')
                 .conflicts('reset')
                 .argParser(parseMatch),

package/lib/commands/init/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAc;QACjC,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,sIAAsI;QACxI,OAAO,EAAE;YACP,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;YAC5C,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,0DAA0D,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAC3G,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,2CAA2C,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAC5F,KAAK,EAAE,IAAI,MAAM,CACf,oBAAoB,EACpB,iGAAiG,CAClG;iBACE,SAAS,CAAC,OAAO,CAAC;iBAClB,SAAS,CAAC,UAAU,CAAC;YACxB,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE;SAC/B;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { InitOptions } from './types/InitOptions.js';\nimport { parseMatch } from '../../utilities/parseMatch.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"init\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<InitOptions>({\n    name: 'init',\n    description:\n      'Initializes a given app project and defines the necessary configuration overrides to make an existing app compatible with Cloudpack.',\n    options: {\n      logResolveMap: reusedOptions.logResolveMap(),\n      reset: new Option('--reset', 'Ignores existing overrides when determining all entries.').conflicts('check'),\n      check: new Option('--check', 'Fails if any package exports are missing.').conflicts('reset'),\n      match: new Option(\n        '--match <match...>',\n        'Only evaluate specific package(s), optionally with a version: e.g. \"foo\", \"@foo/*\", \"foo@1.2.3\"',\n      )\n        .conflicts('reset')\n        .argParser(parseMatch),\n      cache: reusedOptions.noCache(),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAc;QACjC,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,6EAA6E;YAC7E,qDAAqD;QACvD,OAAO,EAAE;YACP,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;YAC5C,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,uCAAuC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YACxF,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,uDAAuD,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YACxG,KAAK,EAAE,IAAI,MAAM,CACf,oBAAoB,EACpB,iGAAiG,CAClG;iBACE,SAAS,CAAC,OAAO,CAAC;iBAClB,SAAS,CAAC,UAAU,CAAC;YACxB,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE;SAC/B;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { InitOptions } from './types/InitOptions.js';\nimport { parseMatch } from '../../utilities/parseMatch.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"init\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<InitOptions>({\n    name: 'init',\n    description:\n      \"Validate an app's compatibility with Cloudpack, and generate any necessary \" +\n      'configuration overrides (cloudpack.generated.json).',\n    options: {\n      logResolveMap: reusedOptions.logResolveMap(),\n      reset: new Option('--reset', 'Ignore the previous generated config.').conflicts('check'),\n      check: new Option('--check', 'Fail if updates to the generated config are required.').conflicts('reset'),\n      match: new Option(\n        '--match <match...>',\n        'Only evaluate specific package(s), optionally with a version: e.g. \"foo\", \"@foo/*\", \"foo@1.2.3\"',\n      )\n        .conflicts('reset')\n        .argParser(parseMatch),\n      cache: reusedOptions.noCache(),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}

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

@@ -6,15 +6,15 @@ export interface InitOptions {
     /** Writes the resolve map to `resolve-map.json`. */
     logResolveMap?: boolean;
     /**
-     * Whether to ignore existing overrides when determining all entries.
+     * Ignore the previous generated config.
      */
     reset?: boolean;
     /**
-     * Whether to fail on missing exports.
+     * Fail if updates to the generated config are required.
      */
     check?: boolean;
     /**
-     * If set, only evaluate matching packages.
+     * Only evaluate specific package(s).
      */
     match?: PackageSettingsMatch[];
     /** Whether to use the cache */

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 { PackageSettingsMatch } from '@ms-cloudpack/common-types';\n\n/**\n * Defines the options for the \"init\" command.\n */\nexport interface InitOptions {\n  /** Writes the resolve map to `resolve-map.json`. */\n  logResolveMap?: boolean;\n\n  /**\n   * Whether to ignore existing overrides when determining all entries.\n   */\n  reset?: boolean;\n\n  /**\n   * Whether to fail on missing exports.\n   */\n  check?: boolean;\n\n  /**\n   * If set, only evaluate matching packages.\n   */\n  match?: PackageSettingsMatch[];\n\n  /** Whether to use the cache */\n  cache?: boolean;\n}\n"]}
+{"version":3,"file":"InitOptions.js","sourceRoot":"","sources":["../../../../src/commands/init/types/InitOptions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PackageSettingsMatch } from '@ms-cloudpack/common-types';\n\n/**\n * Defines the options for the \"init\" command.\n */\nexport interface InitOptions {\n  /** Writes the resolve map to `resolve-map.json`. */\n  logResolveMap?: boolean;\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  /**\n   * Only evaluate specific package(s).\n   */\n  match?: PackageSettingsMatch[];\n\n  /** Whether to use the cache */\n  cache?: boolean;\n}\n"]}

package/lib/commands/link/index.js

@@ -4,12 +4,16 @@ import { reusedOptions } from '../../utilities/reusedOptions.js';
 export const init = (program) => {
     program.addSubCommand({
         name: 'link',
-        description: 'Links the package or packages found within the current folder from an existing Cloudpack start session.',
+        description: 'Links the package(s) found within the current folder to an existing cloudpack start session.',
         options: {
-            ignore: new Option('--ignore [packages...]', 'Ignores the given packages when linking. This can be used to ignore packages that are part of the current repo but have issues being bundled.'),
-            all: new Option('--all', 'If specified, will link all internal packages discovered within the linked repo graph.'),
-            ignoreResolutions: new Option('--ignore-resolutions', 'If specified, ignores resolutions from the host repo definition to the linked packages.'),
-            resolveStrategy: new Option('--resolve-strategy <strategy>', 'The strategy to use when resolving linked packages. Options are "dedupe" or "duplicate". Defaults to "dedupe".')
+            ignore: new Option('--ignore [packages...]', 'Ignore these packages when linking. This can be used for packages in the current repo ' +
+                'that have issues being bundled.'),
+            all: new Option('--all', "Link all internal packages discovered within the linked repo's graph."),
+            ignoreResolutions: new Option('--ignore-resolutions', "Don't apply resolutions from the host repo's package.json to linked packages."),
+            resolveStrategy: new Option('--resolve-strategy <strategy>', 'Strategy to use when resolving linked packages.\n' +
+                '- "dedupe": Attempt to dedupe packages from the resolve map by removing all but the ' +
+                'highest version that satisfies semver requirements from all parent entries.\n' +
+                `- "duplicate": Allow duplicates in the resolve map (don't bump dependencies).`)
                 .choices(['dedupe', 'duplicate'])
                 .default('dedupe'),
             logResolveMap: reusedOptions.logResolveMap(),

package/lib/commands/link/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAc;QACjC,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,yGAAyG;QAC3G,OAAO,EAAE;YACP,MAAM,EAAE,IAAI,MAAM,CAChB,wBAAwB,EACxB,+IAA+I,CAChJ;YACD,GAAG,EAAE,IAAI,MAAM,CACb,OAAO,EACP,wFAAwF,CACzF;YACD,iBAAiB,EAAE,IAAI,MAAM,CAC3B,sBAAsB,EACtB,yFAAyF,CAC1F;YACD,eAAe,EAAE,IAAI,MAAM,CACzB,+BAA+B,EAC/B,gHAAgH,CACjH;iBACE,OAAO,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;iBAChC,OAAO,CAAC,QAAQ,CAAC;YACpB,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;SAC7C;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { LinkOptions } from './types/LinkOptions.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"link\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<LinkOptions>({\n    name: 'link',\n    description:\n      'Links the package or packages found within the current folder from an existing Cloudpack start session.',\n    options: {\n      ignore: new Option(\n        '--ignore [packages...]',\n        'Ignores the given packages when linking. This can be used to ignore packages that are part of the current repo but have issues being bundled.',\n      ),\n      all: new Option(\n        '--all',\n        'If specified, will link all internal packages discovered within the linked repo graph.',\n      ),\n      ignoreResolutions: new Option(\n        '--ignore-resolutions',\n        'If specified, ignores resolutions from the host repo definition to the linked packages.',\n      ),\n      resolveStrategy: new Option(\n        '--resolve-strategy <strategy>',\n        'The strategy to use when resolving linked packages. Options are \"dedupe\" or \"duplicate\". Defaults to \"dedupe\".',\n      )\n        .choices(['dedupe', 'duplicate'])\n        .default('dedupe'),\n      logResolveMap: reusedOptions.logResolveMap(),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAc;QACjC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,8FAA8F;QAC3G,OAAO,EAAE;YACP,MAAM,EAAE,IAAI,MAAM,CAChB,wBAAwB,EACxB,wFAAwF;gBACtF,iCAAiC,CACpC;YACD,GAAG,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE,uEAAuE,CAAC;YACjG,iBAAiB,EAAE,IAAI,MAAM,CAC3B,sBAAsB,EACtB,+EAA+E,CAChF;YACD,eAAe,EAAE,IAAI,MAAM,CACzB,+BAA+B,EAC/B,mDAAmD;gBACjD,sFAAsF;gBACtF,+EAA+E;gBAC/E,+EAA+E,CAClF;iBACE,OAAO,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;iBAChC,OAAO,CAAC,QAAQ,CAAC;YACpB,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;SAC7C;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { LinkOptions } from './types/LinkOptions.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"link\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<LinkOptions>({\n    name: 'link',\n    description: 'Links the package(s) found within the current folder to an existing cloudpack start session.',\n    options: {\n      ignore: new Option(\n        '--ignore [packages...]',\n        'Ignore these packages when linking. This can be used for packages in the current repo ' +\n          'that have issues being bundled.',\n      ),\n      all: new Option('--all', \"Link all internal packages discovered within the linked repo's graph.\"),\n      ignoreResolutions: new Option(\n        '--ignore-resolutions',\n        \"Don't apply resolutions from the host repo's package.json to linked packages.\",\n      ),\n      resolveStrategy: new Option(\n        '--resolve-strategy <strategy>',\n        'Strategy to use when resolving linked packages.\\n' +\n          '- \"dedupe\": Attempt to dedupe packages from the resolve map by removing all but the ' +\n          'highest version that satisfies semver requirements from all parent entries.\\n' +\n          `- \"duplicate\": Allow duplicates in the resolve map (don't bump dependencies).`,\n      )\n        .choices(['dedupe', 'duplicate'])\n        .default('dedupe'),\n      logResolveMap: reusedOptions.logResolveMap(),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}

package/lib/commands/link/types/LinkOptions.d.ts

@@ -1,15 +1,19 @@
 export interface LinkOptions {
-    /** Ignores the given packages when linking. This can be used to ignore packages that are part of the current repo but have issues being bundled. */
+    /**
+     * Ignore these packages when linking.
+     * This can be used for packages in the current repo that have issues being bundled.
+     */
     ignore?: string[];
-    /** If specified, will link all internal packages discovered within the linked repo graph. */
+    /** Link all internal packages discovered within the linked repo's graph. */
     all?: boolean;
-    /** If specified, ignores resolutions from the host repo definition to the linked packages. */
+    /** Don't apply resolutions from the host repo's package.json to linked packages. */
     ignoreResolutions?: boolean;
-    /** The strategy to use when resolving linked packages. Defaults to "dedupe".
-     * - The "dedupe" strategy will attempt to remove duplicate packages from the resolve map
-     * by removing all but the highest version that satisfies the semver requirements of all the parent entries.
-     * - The "duplicate" strategy will not make any attempt to bump dependencies to the highest version, and will instead
-     * duplicate the package in the resolve map.
+    /**
+     * Strategy to use when resolving linked packages.
+     * - `"dedupe"`: Attempt to dedupe packages from the resolve map by removing all but the
+     *   highest version that satisfies semver requirements from all parent entries.
+     * - `"duplicate"`: Allow duplicates in the resolve map (don't bump dependencies).
+     * @default "dedupe"
      */
     resolveStrategy: 'dedupe' | 'duplicate';
     /** Writes the linked resolve map to `resolve-map-linked.json`. */

package/lib/commands/link/types/LinkOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LinkOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/link/types/LinkOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,oJAAoJ;IACpJ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6FAA6F;IAC7F,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,eAAe,EAAE,QAAQ,GAAG,WAAW,CAAC;IACxC,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}
+{"version":3,"file":"LinkOptions.d.ts","sourceRoot":"","sources":["../../../../src/commands/link/types/LinkOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;OAMG;IACH,eAAe,EAAE,QAAQ,GAAG,WAAW,CAAC;IAExC,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/lib/commands/link/types/LinkOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"LinkOptions.js","sourceRoot":"","sources":["../../../../src/commands/link/types/LinkOptions.ts"],"names":[],"mappings":"","sourcesContent":["export interface LinkOptions {\n  /** Ignores the given packages when linking. This can be used to ignore packages that are part of the current repo but have issues being bundled. */\n  ignore?: string[];\n  /** If specified, will link all internal packages discovered within the linked repo graph. */\n  all?: boolean;\n  /** If specified, ignores resolutions from the host repo definition to the linked packages. */\n  ignoreResolutions?: boolean;\n  /** The strategy to use when resolving linked packages. Defaults to \"dedupe\".\n   * - The \"dedupe\" strategy will attempt to remove duplicate packages from the resolve map\n   * by removing all but the highest version that satisfies the semver requirements of all the parent entries.\n   * - The \"duplicate\" strategy will not make any attempt to bump dependencies to the highest version, and will instead\n   * duplicate the package in the resolve map.\n   */\n  resolveStrategy: 'dedupe' | 'duplicate';\n  /** Writes the linked resolve map to `resolve-map-linked.json`. */\n  logResolveMap?: boolean;\n}\n"]}
+{"version":3,"file":"LinkOptions.js","sourceRoot":"","sources":["../../../../src/commands/link/types/LinkOptions.ts"],"names":[],"mappings":"","sourcesContent":["export interface LinkOptions {\n  /**\n   * Ignore these packages when linking.\n   * This can be used for packages in the current repo that have issues being bundled.\n   */\n  ignore?: string[];\n\n  /** Link all internal packages discovered within the linked repo's graph. */\n  all?: boolean;\n\n  /** Don't apply resolutions from the host repo's package.json to linked packages. */\n  ignoreResolutions?: boolean;\n\n  /**\n   * Strategy to use when resolving linked packages.\n   * - `\"dedupe\"`: Attempt to dedupe packages from the resolve map by removing all but the\n   *   highest version that satisfies semver requirements from all parent entries.\n   * - `\"duplicate\"`: Allow duplicates in the resolve map (don't bump dependencies).\n   * @default \"dedupe\"\n   */\n  resolveStrategy: 'dedupe' | 'duplicate';\n\n  /** Writes the linked resolve map to `resolve-map-linked.json`. */\n  logResolveMap?: boolean;\n}\n"]}

package/lib/commands/setup/execute.d.ts

@@ -2,6 +2,6 @@ import type { CommandAction } from '../../types/CommandAction.js';
 export interface SetupOptions {
     force?: boolean;
 }
-/** Executor for the "info non-semver-deps" verb */
+/** Executor for the "setup" verb */
 export declare const execute: CommandAction<SetupOptions>;
 //# sourceMappingURL=execute.d.ts.map

package/lib/commands/setup/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/commands/setup/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,mDAAmD;AACnD,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,YAAY,CAe/C,CAAC"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/commands/setup/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,oCAAoC;AACpC,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,YAAY,CAe/C,CAAC"}

package/lib/commands/setup/execute.js

@@ -1,5 +1,5 @@
 import { setup } from '@ms-cloudpack/setup-utilities';
-/** Executor for the "info non-semver-deps" verb */
+/** Executor for the "setup" verb */
 export const execute = async (params) => {
     const { cwd, initialize, exit } = params;
     const { config } = await initialize({ appPath: cwd });

package/lib/commands/setup/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/commands/setup/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAMtD,mDAAmD;AACnD,MAAM,CAAC,MAAM,OAAO,GAAgC,KAAK,EAAE,MAAM,EAAE,EAAE;IACnE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAEpC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,KAAK,CAAC;YACV,MAAM;YACN,uBAAuB,EAAE,KAAK,KAAK,IAAI;YACvC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC","sourcesContent":["import type { CommandAction } from '../../types/CommandAction.js';\nimport { setup } from '@ms-cloudpack/setup-utilities';\n\nexport interface SetupOptions {\n  force?: boolean;\n}\n\n/** Executor for the \"info non-semver-deps\" verb */\nexport const execute: CommandAction<SetupOptions> = async (params) => {\n  const { cwd, initialize, exit } = params;\n  const { config } = await initialize({ appPath: cwd });\n  const { devServer = {} } = config;\n  const { domain, https } = devServer;\n\n  if (domain || https) {\n    await setup({\n      domain,\n      shouldCreateCertificate: https === true,\n      cwd,\n    });\n  }\n\n  await exit({ message: 'Setup complete.' });\n};\n"]}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/commands/setup/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAMtD,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAgC,KAAK,EAAE,MAAM,EAAE,EAAE;IACnE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAEpC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,KAAK,CAAC;YACV,MAAM;YACN,uBAAuB,EAAE,KAAK,KAAK,IAAI;YACvC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC","sourcesContent":["import type { CommandAction } from '../../types/CommandAction.js';\nimport { setup } from '@ms-cloudpack/setup-utilities';\n\nexport interface SetupOptions {\n  force?: boolean;\n}\n\n/** Executor for the \"setup\" verb */\nexport const execute: CommandAction<SetupOptions> = async (params) => {\n  const { cwd, initialize, exit } = params;\n  const { config } = await initialize({ appPath: cwd });\n  const { devServer = {} } = config;\n  const { domain, https } = devServer;\n\n  if (domain || https) {\n    await setup({\n      domain,\n      shouldCreateCertificate: https === true,\n      cwd,\n    });\n  }\n\n  await exit({ message: 'Setup complete.' });\n};\n"]}

package/lib/commands/setup/index.d.ts

@@ -1,4 +1,4 @@
 import type { CommandInitFunction } from '../../types/CommandInitFunction.js';
-/** Defines the "info" verb. */
+/** Defines the "setup" verb. */
 export declare const init: CommandInitFunction;
 //# sourceMappingURL=index.d.ts.map

package/lib/commands/setup/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/setup/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBAUlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/setup/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,gCAAgC;AAChC,eAAO,MAAM,IAAI,EAAE,mBAYlB,CAAC"}

package/lib/commands/setup/index.js

@@ -1,11 +1,12 @@
 import { Option } from 'commander';
-/** Defines the "info" verb. */
+/** Defines the "setup" verb. */
 export const init = (program) => {
     program.addSubCommand({
         name: 'setup',
-        description: 'Sets up cert and hosts file settings for the relevant inner loop domain and https preferences.',
+        description: 'Sets up cert and hosts file settings for the relevant inner loop domain and HTTPS options ' +
+            '(based on the devServer config).',
         options: {
-            force: new Option('--force', 'Forces execution of setup steps.'),
+            force: new Option('--force', 'Force execution of setup steps.'),
         },
         hideSharedOptions: ['cachePath', 'features'],
         getExecutor: () => import('./execute.js'),

package/lib/commands/setup/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/setup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAC;QACpB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,gGAAgG;QAC7G,OAAO,EAAE;YACP,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,kCAAkC,CAAC;SACjE;QACD,iBAAiB,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;QAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\n\n/** Defines the \"info\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand({\n    name: 'setup',\n    description: 'Sets up cert and hosts file settings for the relevant inner loop domain and https preferences.',\n    options: {\n      force: new Option('--force', 'Forces execution of setup steps.'),\n    },\n    hideSharedOptions: ['cachePath', 'features'],\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/setup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,gCAAgC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAe;QAClC,IAAI,EAAE,OAAO;QACb,WAAW,EACT,4FAA4F;YAC5F,kCAAkC;QACpC,OAAO,EAAE;YACP,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,iCAAiC,CAAC;SAChE;QACD,iBAAiB,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;QAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { SetupOptions } from './execute.js';\n\n/** Defines the \"setup\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<SetupOptions>({\n    name: 'setup',\n    description:\n      'Sets up cert and hosts file settings for the relevant inner loop domain and HTTPS options ' +\n      '(based on the devServer config).',\n    options: {\n      force: new Option('--force', 'Force execution of setup steps.'),\n    },\n    hideSharedOptions: ['cachePath', 'features'],\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}

package/lib/commands/start/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/commands/start/execute.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,YAAY,CAkJ/C,CAAC"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/commands/start/execute.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAKlE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,YAAY,CAgH/C,CAAC"}

package/lib/commands/start/execute.js

@@ -50,40 +50,13 @@ export const execute = async (params) => {
         // Write the resolve map to disk.
         await writeJson(path.join(appPath, 'resolve-map.json'), session.resolveMap);
     }
-    const domains = config.devServer?.domain
-        ? Array.isArray(config.devServer.domain)
-            ? config.devServer.domain
-            : [config.devServer.domain]
-        : [];
-    const primaryDomain = domains[0];
-    // If a cert is needed, check that it exists.
-    if (config.devServer?.https === true && !(await getCertificate({ domain: config.devServer?.domain, cwd: appPath }))) {
-        await exit({
-            exitCode: 1,
-            message: `The local site is configured to use https in cloudpack.config.json, but is missing a cert.\n\nRun "${cyan(bold('cloudpack setup'))}" to create the required certificate and try start again.\n`,
-        });
-        return;
-    }
-    const { createCloudpackServer } = await import('@ms-cloudpack/api-server');
-    let apiServer;
     // Start api server for tracking status and handling remote requests.
-    try {
-        apiServer = await createCloudpackServer({ port: options.apiServerPort }, apiContext);
-    }
-    catch (err) {
-        const error = err;
-        if (error.code === 'EADDRNOTAVAIL' && config.devServer?.domain) {
-            await exit({
-                exitCode: 1,
-                message: `The domain "${cyan(bold(primaryDomain))}" in cloudpack.config.json is not resolvable.\n\n` +
-                    `Run "${cyan(bold('cloudpack setup'))}" to add the appropriate entries to your hosts file and ` +
-                    `try start again.\n`,
-            });
-            return;
-        }
-        console.error('Error creating api server:', err);
-        throw err;
+    const serverOrError = await createApiServer(options, apiContext);
+    if (typeof serverOrError === 'string') {
+        await exit({ exitCode: 1, message: serverOrError });
+        return;
     }
+    const apiServer = serverOrError;
     // Kick off bundling app package as soon as api server is ready.
     void ensurePackageBundled({
         input: { name: definition.name, version: definition.version },
@@ -130,5 +103,32 @@ export const execute = async (params) => {
         console.log('Please open the browser manually to:', defaultUrl);
     }
 };
+/**
+ * Create the API server, or return an error message if the server could not be created.
+ */
+async function createApiServer(options, apiContext) {
+    const { session } = apiContext;
+    const { config } = session;
+    const { devServer, appPath } = config;
+    // If a cert is needed, check that it exists.
+    if (devServer?.https === true && !(await getCertificate({ domain: devServer?.domain, cwd: appPath }))) {
+        return (`The local site is configured to use https in cloudpack.config.json, but is missing a cert.\n\n` +
+            `Run "${cyan(bold('cloudpack setup'))}" to create the required certificate and try start again.\n`);
+    }
+    const { createCloudpackServer } = await import('@ms-cloudpack/api-server');
+    try {
+        return await createCloudpackServer({ port: options.apiServerPort }, apiContext);
+    }
+    catch (err) {
+        const error = err;
+        if (error.code === 'EADDRNOTAVAIL' && devServer?.domain) {
+            const primaryDomain = (Array.isArray(devServer.domain) ? devServer.domain : [devServer.domain])[0];
+            return (`The domain "${cyan(bold(primaryDomain))}" in cloudpack.config.json is not resolvable.\n\n` +
+                `Run "${cyan(bold('cloudpack setup'))}" to add the appropriate entries to your hosts file and ` +
+                `try start again.\n`);
+        }
+        return `Error creating API server: ${err.stack || err}`;
+    }
+}
 // cspell:ignore Prereqs
 //# sourceMappingURL=execute.js.map

package/lib/commands/start/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/commands/start/execute.ts"],"names":[],"mappings":"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","sourcesContent":["import { createPartialApiContext, ensurePackageBundled } from '@ms-cloudpack/api-server';\nimport { writeJson } from '@ms-cloudpack/json-utilities';\nimport { isExternalPackage, resolve } from '@ms-cloudpack/package-utilities';\nimport { makeUrl } from '@ms-cloudpack/path-string-parsing';\nimport { cyan, yellow, bold } from '@ms-cloudpack/task-reporter';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { PerfMarkerCliEntry, PerfMeasurementOpenBrowser } from '../../performance/markers.js';\nimport type { CommandAction } from '../../types/CommandAction.js';\nimport { runPrerequisites } from '../../utilities/runPrerequisites.js';\nimport { getStartingAppPath } from './getStartingAppPath.js';\nimport { openBrowser } from './openBrowser.js';\nimport { trackSession } from './trackSession.js';\nimport type { StartOptions } from './types/StartOptions.js';\nimport { getCertificate } from '@ms-cloudpack/setup-utilities';\nimport { setStopServersFunction } from '../../utilities/stopServers.js';\n\n/**\n * Defines the \"start\" verb entry point.\n */\nexport const execute: CommandAction<StartOptions> = async (params) => {\n  const { options, cwd, initialize, autoDispose, exit } = params;\n  setStopServersFunction(exit);\n\n  const appPath = await getStartingAppPath(cwd, options.app);\n  const apiContextOptions = await initialize({ appPath, mode: options.mode });\n  const { config, telemetryClient } = apiContextOptions;\n\n  console.log('App path:', yellow(appPath));\n  console.log('Bundle mode:', yellow(options.mode));\n\n  runPrerequisites(apiContextOptions);\n\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  let overlayPath = await resolve('@ms-cloudpack/overlay', currentDir);\n\n  // If overlay is an internal package, resolve the overlay from the current package's linked node modules\n  // to \"externalize\" it, so that we always use the bundled version of the overlay instead of the source.\n  if (overlayPath && !isExternalPackage(overlayPath)) {\n    const cliPath = await resolve('@ms-cloudpack/cli', currentDir);\n    overlayPath = cliPath ? path.join(cliPath, 'node_modules', '@ms-cloudpack/overlay') : undefined;\n  }\n\n  const [apiContext] = autoDispose(\n    await createPartialApiContext({\n      ...apiContextOptions,\n      items: ['bus', 'watcher', 'taskRunner', 'packages', 'session', 'packageImportPaths', 'packageHashes'],\n      overlayPath,\n    }),\n  );\n  const { packages, session } = apiContext;\n\n  // Increment the session version if caching is disabled.\n  if (options.cache === false) {\n    session.incrementSessionVersion();\n  }\n\n  // Make sure the package has a valid definition.\n  const definition = await packages.get(appPath);\n\n  // Set shared telemetry attributes which will be sent with all telemetry events.\n  telemetryClient.setSharedSpanAttribute('sessionId', session.id);\n\n  if (options.logResolveMap) {\n    // Write the resolve map to disk.\n    await writeJson(path.join(appPath, 'resolve-map.json'), session.resolveMap);\n  }\n\n  const domains = config.devServer?.domain\n    ? Array.isArray(config.devServer.domain)\n      ? config.devServer.domain\n      : [config.devServer.domain]\n    : [];\n  const primaryDomain = domains[0];\n\n  // If a cert is needed, check that it exists.\n  if (config.devServer?.https === true && !(await getCertificate({ domain: config.devServer?.domain, cwd: appPath }))) {\n    await exit({\n      exitCode: 1,\n      message: `The local site is configured to use https in cloudpack.config.json, but is missing a cert.\\n\\nRun \"${cyan(bold('cloudpack setup'))}\" to create the required certificate and try start again.\\n`,\n    });\n    return;\n  }\n\n  const { createCloudpackServer } = await import('@ms-cloudpack/api-server');\n  let apiServer: Awaited<ReturnType<typeof createCloudpackServer>> | undefined;\n\n  // Start api server for tracking status and handling remote requests.\n  try {\n    apiServer = await createCloudpackServer({ port: options.apiServerPort }, apiContext);\n  } catch (err) {\n    const error = err as { code: string };\n\n    if (error.code === 'EADDRNOTAVAIL' && config.devServer?.domain) {\n      await exit({\n        exitCode: 1,\n        message:\n          `The domain \"${cyan(bold(primaryDomain))}\" in cloudpack.config.json is not resolvable.\\n\\n` +\n          `Run \"${cyan(bold('cloudpack setup'))}\" to add the appropriate entries to your hosts file and ` +\n          `try start again.\\n`,\n      });\n\n      return;\n    }\n\n    console.error('Error creating api server:', err);\n\n    throw err;\n  }\n\n  // Kick off bundling app package as soon as api server is ready.\n  void ensurePackageBundled({\n    input: { name: definition.name, version: definition.version },\n    ctx: apiContext,\n  });\n\n  // Then start bundle and app servers for hosting the app.\n  const { startServers } = await import('@ms-cloudpack/app-server');\n  const servers = await startServers(\n    {\n      definition,\n      bundleServerOptions: { disableCache: !options.cache, port: options.bundleServerPort },\n      port: options.appServerPort,\n    },\n    apiContext,\n  );\n\n  // Save the session to active sessions.\n  const sessionTracker = await trackSession(session);\n\n  const cleanup = async () => {\n    // Stop tracking the session.\n    await sessionTracker.close();\n\n    await Promise.all(\n      Object.entries({ apiServer, ...servers }).map(async ([name, server]) => {\n        if (!server) return;\n\n        const desc = `${name} (${server.url})`;\n        console.info(`Closing ${desc}`);\n        try {\n          await server.close();\n          console.info(`Closed ${desc}`);\n        } catch (err) {\n          console.warn(`Error closing ${desc}:`, err);\n        }\n      }),\n    );\n  };\n\n  autoDispose({ dispose: cleanup });\n\n  const defaultUrl = makeUrl(config.devServer?.defaultPath || '', session.urls.appServer).href;\n\n  performance.measure(PerfMeasurementOpenBrowser, PerfMarkerCliEntry);\n\n  // Open the browser.\n  if (options.open !== false) {\n    openBrowser(defaultUrl).catch((err) => {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n      console.warn('Error opening browser:', err?.stack || err);\n      console.warn('Please open the browser manually to:', defaultUrl);\n    });\n  } else {\n    console.log('Please open the browser manually to:', defaultUrl);\n  }\n};\n\n// cspell:ignore Prereqs\n"]}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/commands/start/execute.ts"],"names":[],"mappings":"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","sourcesContent":["import { createPartialApiContext, ensurePackageBundled, type ApiServer, type Context } from '@ms-cloudpack/api-server';\nimport { writeJson } from '@ms-cloudpack/json-utilities';\nimport { isExternalPackage, resolve } from '@ms-cloudpack/package-utilities';\nimport { makeUrl } from '@ms-cloudpack/path-string-parsing';\nimport { cyan, yellow, bold } from '@ms-cloudpack/task-reporter';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { PerfMarkerCliEntry, PerfMeasurementOpenBrowser } from '../../performance/markers.js';\nimport type { CommandAction } from '../../types/CommandAction.js';\nimport { runPrerequisites } from '../../utilities/runPrerequisites.js';\nimport { getStartingAppPath } from './getStartingAppPath.js';\nimport { openBrowser } from './openBrowser.js';\nimport { trackSession } from './trackSession.js';\nimport type { StartOptions } from './types/StartOptions.js';\nimport { getCertificate } from '@ms-cloudpack/setup-utilities';\nimport { setStopServersFunction } from '../../utilities/stopServers.js';\n\n/**\n * Defines the \"start\" verb entry point.\n */\nexport const execute: CommandAction<StartOptions> = async (params) => {\n  const { options, cwd, initialize, autoDispose, exit } = params;\n  setStopServersFunction(exit);\n\n  const appPath = await getStartingAppPath(cwd, options.app);\n  const apiContextOptions = await initialize({ appPath, mode: options.mode });\n  const { config, telemetryClient } = apiContextOptions;\n\n  console.log('App path:', yellow(appPath));\n  console.log('Bundle mode:', yellow(options.mode));\n\n  runPrerequisites(apiContextOptions);\n\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  let overlayPath = await resolve('@ms-cloudpack/overlay', currentDir);\n\n  // If overlay is an internal package, resolve the overlay from the current package's linked node modules\n  // to \"externalize\" it, so that we always use the bundled version of the overlay instead of the source.\n  if (overlayPath && !isExternalPackage(overlayPath)) {\n    const cliPath = await resolve('@ms-cloudpack/cli', currentDir);\n    overlayPath = cliPath ? path.join(cliPath, 'node_modules', '@ms-cloudpack/overlay') : undefined;\n  }\n\n  const [apiContext] = autoDispose(\n    await createPartialApiContext({\n      ...apiContextOptions,\n      items: ['bus', 'watcher', 'taskRunner', 'packages', 'session', 'packageImportPaths', 'packageHashes'],\n      overlayPath,\n    }),\n  );\n  const { packages, session } = apiContext;\n\n  // Increment the session version if caching is disabled.\n  if (options.cache === false) {\n    session.incrementSessionVersion();\n  }\n\n  // Make sure the package has a valid definition.\n  const definition = await packages.get(appPath);\n\n  // Set shared telemetry attributes which will be sent with all telemetry events.\n  telemetryClient.setSharedSpanAttribute('sessionId', session.id);\n\n  if (options.logResolveMap) {\n    // Write the resolve map to disk.\n    await writeJson(path.join(appPath, 'resolve-map.json'), session.resolveMap);\n  }\n\n  // Start api server for tracking status and handling remote requests.\n  const serverOrError = await createApiServer(options, apiContext);\n  if (typeof serverOrError === 'string') {\n    await exit({ exitCode: 1, message: serverOrError });\n    return;\n  }\n  const apiServer = serverOrError;\n\n  // Kick off bundling app package as soon as api server is ready.\n  void ensurePackageBundled({\n    input: { name: definition.name, version: definition.version },\n    ctx: apiContext,\n  });\n\n  // Then start bundle and app servers for hosting the app.\n  const { startServers } = await import('@ms-cloudpack/app-server');\n  const servers = await startServers(\n    {\n      definition,\n      bundleServerOptions: { disableCache: !options.cache, port: options.bundleServerPort },\n      port: options.appServerPort,\n    },\n    apiContext,\n  );\n\n  // Save the session to active sessions.\n  const sessionTracker = await trackSession(session);\n\n  const cleanup = async () => {\n    // Stop tracking the session.\n    await sessionTracker.close();\n\n    await Promise.all(\n      Object.entries({ apiServer, ...servers }).map(async ([name, server]) => {\n        if (!server) return;\n\n        const desc = `${name} (${server.url})`;\n        console.info(`Closing ${desc}`);\n        try {\n          await server.close();\n          console.info(`Closed ${desc}`);\n        } catch (err) {\n          console.warn(`Error closing ${desc}:`, err);\n        }\n      }),\n    );\n  };\n\n  autoDispose({ dispose: cleanup });\n\n  const defaultUrl = makeUrl(config.devServer?.defaultPath || '', session.urls.appServer).href;\n\n  performance.measure(PerfMeasurementOpenBrowser, PerfMarkerCliEntry);\n\n  // Open the browser.\n  if (options.open !== false) {\n    openBrowser(defaultUrl).catch((err) => {\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n      console.warn('Error opening browser:', err?.stack || err);\n      console.warn('Please open the browser manually to:', defaultUrl);\n    });\n  } else {\n    console.log('Please open the browser manually to:', defaultUrl);\n  }\n};\n\n/**\n * Create the API server, or return an error message if the server could not be created.\n */\nasync function createApiServer(options: StartOptions, apiContext: Context): Promise<ApiServer | string> {\n  const { session } = apiContext;\n  const { config } = session;\n  const { devServer, appPath } = config;\n\n  // If a cert is needed, check that it exists.\n  if (devServer?.https === true && !(await getCertificate({ domain: devServer?.domain, cwd: appPath }))) {\n    return (\n      `The local site is configured to use https in cloudpack.config.json, but is missing a cert.\\n\\n` +\n      `Run \"${cyan(bold('cloudpack setup'))}\" to create the required certificate and try start again.\\n`\n    );\n  }\n\n  const { createCloudpackServer } = await import('@ms-cloudpack/api-server');\n\n  try {\n    return await createCloudpackServer({ port: options.apiServerPort }, apiContext);\n  } catch (err) {\n    const error = err as { code: string };\n\n    if (error.code === 'EADDRNOTAVAIL' && devServer?.domain) {\n      const primaryDomain = (Array.isArray(devServer.domain) ? devServer.domain : [devServer.domain])[0];\n\n      return (\n        `The domain \"${cyan(bold(primaryDomain))}\" in cloudpack.config.json is not resolvable.\\n\\n` +\n        `Run \"${cyan(bold('cloudpack setup'))}\" to add the appropriate entries to your hosts file and ` +\n        `try start again.\\n`\n      );\n    }\n\n    return `Error creating API server: ${(err as Error).stack || err}`;\n  }\n}\n\n// cspell:ignore Prereqs\n"]}

package/lib/commands/start/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/start/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAM9E,gCAAgC;AAChC,eAAO,MAAM,IAAI,EAAE,mBAkBlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/start/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAK9E,gCAAgC;AAChC,eAAO,MAAM,IAAI,EAAE,mBAmBlB,CAAC"}

package/lib/commands/start/index.js

@@ -1,5 +1,4 @@
 import { InvalidArgumentError, Option } from 'commander';
-import { parseBundleMode } from '../../utilities/parseBundleMode.js';
 import { portNumbers } from 'get-port';
 import { reusedOptions } from '../../utilities/reusedOptions.js';
 /** Defines the "start" verb. */
@@ -8,13 +7,11 @@ export const init = (program) => {
         name: 'start',
         description: 'Starts a web inner-loop from the current package folder.',
         options: {
-            mode: new Option('--mode <mode>', 'The mode to run the app in. (library | development | production)')
-                .argParser(parseBundleMode)
-                .default('library'),
-            logResolveMap: reusedOptions.logResolveMap(),
-            app: new Option('--app <appPackageName>', 'Run Cloudpack targeting a specific app.'),
+            mode: reusedOptions.mode({ action: 'run' }),
+            app: new Option('--app <appPackageName>', 'Run Cloudpack targeting a specific app (only needed if running init at a higher level in the repo).'),
             open: new Option('--no-open', 'Do not open the browser.'),
             cache: reusedOptions.noCache(),
+            logResolveMap: reusedOptions.logResolveMap(),
             apiServerPort: getPortOption('--api-server-port <port>', 'API'),
             appServerPort: getPortOption('--app-server-port <port>', 'app'),
             bundleServerPort: getPortOption('--bundle-server-port <port>', 'bundle'),

package/lib/commands/start/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,gCAAgC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAe;QAClC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,MAAM,CAAC,eAAe,EAAE,kEAAkE,CAAC;iBAClG,SAAS,CAAC,eAAe,CAAC;iBAC1B,OAAO,CAAC,SAAS,CAAC;YACrB,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;YAC5C,GAAG,EAAE,IAAI,MAAM,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;YACpF,IAAI,EAAE,IAAI,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;YACzD,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE;YAC9B,aAAa,EAAE,aAAa,CAAC,0BAA0B,EAAE,KAAK,CAAC;YAC/D,aAAa,EAAE,aAAa,CAAC,0BAA0B,EAAE,KAAK,CAAC;YAC/D,gBAAgB,EAAE,aAAa,CAAC,6BAA6B,EAAE,QAAQ,CAAC;SACzE;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa,EAAE,IAAY;IAChD,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,uBAAuB,IAAI,wDAAwD,CAAC;SAC1G,SAAS,CAAC,UAAU,CAAC;SACrB,QAAQ,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,oBAAoB,CAAC,qCAAqC,KAAK,GAAG,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { InvalidArgumentError, Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { StartOptions } from './types/StartOptions.js';\nimport { parseBundleMode } from '../../utilities/parseBundleMode.js';\nimport { portNumbers } from 'get-port';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"start\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<StartOptions>({\n    name: 'start',\n    description: 'Starts a web inner-loop from the current package folder.',\n    options: {\n      mode: new Option('--mode <mode>', 'The mode to run the app in. (library | development | production)')\n        .argParser(parseBundleMode)\n        .default('library'),\n      logResolveMap: reusedOptions.logResolveMap(),\n      app: new Option('--app <appPackageName>', 'Run Cloudpack targeting a specific app.'),\n      open: new Option('--no-open', 'Do not open the browser.'),\n      cache: reusedOptions.noCache(),\n      apiServerPort: getPortOption('--api-server-port <port>', 'API'),\n      appServerPort: getPortOption('--app-server-port <port>', 'app'),\n      bundleServerPort: getPortOption('--bundle-server-port <port>', 'bundle'),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n\nfunction getPortOption(flags: string, name: string) {\n  return new Option(flags, `Port to use for the ${name} server (single, comma-separated, or range with dash).`)\n    .argParser(parsePorts)\n    .hideHelp();\n}\n\nfunction parsePorts(value: string): number[] {\n  if (value.includes('-')) {\n    const split = value.split('-');\n    if (split.length !== 2) {\n      throw new InvalidArgumentError(`Invalid port range: \"${value}\"`);\n    }\n    return [...portNumbers(parseNumber(split[0]), parseNumber(split[1]))];\n  }\n\n  return value.split(',').map(parseNumber);\n}\n\nfunction parseNumber(value: string) {\n  value = value.trim();\n  const parsed = parseInt(value, 10);\n  if (isNaN(parsed)) {\n    throw new InvalidArgumentError(`Port must be a number; received: \"${value}\"`);\n  }\n  return parsed;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,gCAAgC;AAChC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAe;QAClC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE;YACP,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAC3C,GAAG,EAAE,IAAI,MAAM,CACb,wBAAwB,EACxB,qGAAqG,CACtG;YACD,IAAI,EAAE,IAAI,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;YACzD,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE;YAC9B,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;YAC5C,aAAa,EAAE,aAAa,CAAC,0BAA0B,EAAE,KAAK,CAAC;YAC/D,aAAa,EAAE,aAAa,CAAC,0BAA0B,EAAE,KAAK,CAAC;YAC/D,gBAAgB,EAAE,aAAa,CAAC,6BAA6B,EAAE,QAAQ,CAAC;SACzE;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa,EAAE,IAAY;IAChD,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,uBAAuB,IAAI,wDAAwD,CAAC;SAC1G,SAAS,CAAC,UAAU,CAAC;SACrB,QAAQ,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,oBAAoB,CAAC,qCAAqC,KAAK,GAAG,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { InvalidArgumentError, Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { StartOptions } from './types/StartOptions.js';\nimport { portNumbers } from 'get-port';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"start\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<StartOptions>({\n    name: 'start',\n    description: 'Starts a web inner-loop from the current package folder.',\n    options: {\n      mode: reusedOptions.mode({ action: 'run' }),\n      app: new Option(\n        '--app <appPackageName>',\n        'Run Cloudpack targeting a specific app (only needed if running init at a higher level in the repo).',\n      ),\n      open: new Option('--no-open', 'Do not open the browser.'),\n      cache: reusedOptions.noCache(),\n      logResolveMap: reusedOptions.logResolveMap(),\n      apiServerPort: getPortOption('--api-server-port <port>', 'API'),\n      appServerPort: getPortOption('--app-server-port <port>', 'app'),\n      bundleServerPort: getPortOption('--bundle-server-port <port>', 'bundle'),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n\nfunction getPortOption(flags: string, name: string) {\n  return new Option(flags, `Port to use for the ${name} server (single, comma-separated, or range with dash).`)\n    .argParser(parsePorts)\n    .hideHelp();\n}\n\nfunction parsePorts(value: string): number[] {\n  if (value.includes('-')) {\n    const split = value.split('-');\n    if (split.length !== 2) {\n      throw new InvalidArgumentError(`Invalid port range: \"${value}\"`);\n    }\n    return [...portNumbers(parseNumber(split[0]), parseNumber(split[1]))];\n  }\n\n  return value.split(',').map(parseNumber);\n}\n\nfunction parseNumber(value: string) {\n  value = value.trim();\n  const parsed = parseInt(value, 10);\n  if (isNaN(parsed)) {\n    throw new InvalidArgumentError(`Port must be a number; received: \"${value}\"`);\n  }\n  return parsed;\n}\n"]}

package/lib/commands/sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAiB9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBAgBlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAiB9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBAclB,CAAC"}

package/lib/commands/sync/index.js

@@ -14,12 +14,13 @@ function getDefaultLogin() {
 export const init = (program) => {
     program.addSubCommand({
         name: 'sync',
-        description: 'Syncs the packages from/to the remote cache. If the package is not in the local cache, it will be downloaded.',
+        description: 'Syncs packages from/to the remote cache. ' +
+            'By default (without --upload) it will download any packages not found in the local cache.',
         options: {
-            upload: new Option('--upload', 'Uploads the packages to the remote cache.'),
-            login: new Option('--login <method>', 'The way to authenticate against remote cache')
+            upload: new Option('--upload', 'Upload packages to the remote cache (instead of downloading).'),
+            login: new Option('--login <method>', 'How to authenticate against the remote cache.')
                 .choices(['interactive', 'azure-cli', 'device-code'])
-                .default(getDefaultLogin(), 'Default login method is azure-cli in CI, device-code in Github Codespaces and interactive otherwise.'),
+                .default(getDefaultLogin(), '"azure-cli" in CI, "device-code" in Github Codespaces, "interactive" otherwise'),
         },
         getExecutor: () => import('./execute.js'),
     });

package/lib/commands/sync/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,SAAS,eAAe;IACtB,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAc;QACjC,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,+GAA+G;QACjH,OAAO,EAAE;YACP,MAAM,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,2CAA2C,CAAC;YAC3E,KAAK,EAAE,IAAI,MAAM,CAAC,kBAAkB,EAAE,8CAA8C,CAAC;iBAClF,OAAO,CAAC,CAAC,aAAa,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;iBACpD,OAAO,CACN,eAAe,EAAE,EACjB,sGAAsG,CACvG;SACJ;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { SyncOptions } from './types/SyncOptions.js';\nimport { isCIBuild } from '../../utilities/isCIBuild.js';\nimport { isCodespaces } from '../../utilities/isCodespaces.js';\n\nfunction getDefaultLogin() {\n  if (isCIBuild()) {\n    return 'azure-cli';\n  }\n\n  if (isCodespaces()) {\n    return 'device-code';\n  }\n\n  return 'interactive';\n}\n\n/** Defines the \"sync\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<SyncOptions>({\n    name: 'sync',\n    description:\n      'Syncs the packages from/to the remote cache. If the package is not in the local cache, it will be downloaded.',\n    options: {\n      upload: new Option('--upload', 'Uploads the packages to the remote cache.'),\n      login: new Option('--login <method>', 'The way to authenticate against remote cache')\n        .choices(['interactive', 'azure-cli', 'device-code'])\n        .default(\n          getDefaultLogin(),\n          'Default login method is azure-cli in CI, device-code in Github Codespaces and interactive otherwise.',\n        ),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,SAAS,eAAe;IACtB,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAc;QACjC,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,2CAA2C;YAC3C,2FAA2F;QAC7F,OAAO,EAAE;YACP,MAAM,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,+DAA+D,CAAC;YAC/F,KAAK,EAAE,IAAI,MAAM,CAAC,kBAAkB,EAAE,+CAA+C,CAAC;iBACnF,OAAO,CAAC,CAAC,aAAa,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;iBACpD,OAAO,CAAC,eAAe,EAAE,EAAE,gFAAgF,CAAC;SAChH;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { SyncOptions } from './types/SyncOptions.js';\nimport { isCIBuild } from '../../utilities/isCIBuild.js';\nimport { isCodespaces } from '../../utilities/isCodespaces.js';\n\nfunction getDefaultLogin() {\n  if (isCIBuild()) {\n    return 'azure-cli';\n  }\n\n  if (isCodespaces()) {\n    return 'device-code';\n  }\n\n  return 'interactive';\n}\n\n/** Defines the \"sync\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<SyncOptions>({\n    name: 'sync',\n    description:\n      'Syncs packages from/to the remote cache. ' +\n      'By default (without --upload) it will download any packages not found in the local cache.',\n    options: {\n      upload: new Option('--upload', 'Upload packages to the remote cache (instead of downloading).'),\n      login: new Option('--login <method>', 'How to authenticate against the remote cache.')\n        .choices(['interactive', 'azure-cli', 'device-code'])\n        .default(getDefaultLogin(), '\"azure-cli\" in CI, \"device-code\" in Github Codespaces, \"interactive\" otherwise'),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}

package/lib/commands/unlink/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/unlink/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAI9E,iCAAiC;AACjC,eAAO,MAAM,IAAI,EAAE,mBAUlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/unlink/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAI9E,iCAAiC;AACjC,eAAO,MAAM,IAAI,EAAE,mBASlB,CAAC"}

package/lib/commands/unlink/index.js

@@ -3,7 +3,7 @@ import { reusedOptions } from '../../utilities/reusedOptions.js';
 export const init = (program) => {
     program.addSubCommand({
         name: 'unlink',
-        description: 'Unlinks the package or packages found within the current folder from an existing Cloudpack start session.',
+        description: 'Unlinks the package(s) found within the current folder from a cloudpack start session.',
         options: {
             logResolveMap: reusedOptions.logResolveMap(),
         },

package/lib/commands/unlink/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/unlink/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAgB;QACnC,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,2GAA2G;QAC7G,OAAO,EAAE;YACP,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;SAC7C;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { UnlinkOptions } from './types/UnlinkOptions.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"unlink\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<UnlinkOptions>({\n    name: 'unlink',\n    description:\n      'Unlinks the package or packages found within the current folder from an existing Cloudpack start session.',\n    options: {\n      logResolveMap: reusedOptions.logResolveMap(),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/unlink/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,aAAa,CAAgB;QACnC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,wFAAwF;QACrG,OAAO,EAAE;YACP,aAAa,EAAE,aAAa,CAAC,aAAa,EAAE;SAC7C;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { UnlinkOptions } from './types/UnlinkOptions.js';\nimport { reusedOptions } from '../../utilities/reusedOptions.js';\n\n/** Defines the \"unlink\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  program.addSubCommand<UnlinkOptions>({\n    name: 'unlink',\n    description: 'Unlinks the package(s) found within the current folder from a cloudpack start session.',\n    options: {\n      logResolveMap: reusedOptions.logResolveMap(),\n    },\n    getExecutor: () => import('./execute.js'),\n  });\n};\n"]}

package/lib/utilities/reusedOptions.d.ts

@@ -5,5 +5,8 @@ import { Option } from 'commander';
 export declare const reusedOptions: {
     logResolveMap: () => Option;
     noCache: () => Option;
+    mode: (options: {
+        action: "bundle" | "run";
+    }) => Option;
 };
 //# sourceMappingURL=reusedOptions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reusedOptions.d.ts","sourceRoot":"","sources":["../../src/utilities/reusedOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,aAAa;;;CAIzB,CAAC"}
+{"version":3,"file":"reusedOptions.d.ts","sourceRoot":"","sources":["../../src/utilities/reusedOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,aAAa;;;oBAGR;QAAE,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAA;KAAE;CAO7C,CAAC"}

package/lib/utilities/reusedOptions.js

@@ -1,9 +1,28 @@
-import { Option } from 'commander';
+import { InvalidArgumentError, Option } from 'commander';
 /**
  * These options are used by multiple commands, but should be manually added.
  */
 export const reusedOptions = {
-    logResolveMap: () => new Option('--log-resolve-map', 'Logs the resolve map to "resolve-map.json" for diagnostics.'),
-    noCache: () => new Option('--no-cache', 'Ensures Cloudpack rebuilds all packages, rather than utilizing cached assets.'),
+    logResolveMap: () => new Option('--log-resolve-map', 'Log the resolve map to "resolve-map.json" for diagnostics.'),
+    noCache: () => new Option('--no-cache', 'Rebuild all packages, rather than using cached assets.'),
+    mode: (options) => new Option('--mode <mode>', `The mode to ${options.action === 'bundle' ? 'bundle the package' : 'run the app'} in. (library | production)`)
+        .argParser(parseBundleMode)
+        .default('library'),
 };
+/** Parse the session mode based on user input (e.g. --mode argument in start.) */
+function parseBundleMode(mode) {
+    switch (mode.toLowerCase()) {
+        case 'lib':
+        case 'library':
+            return 'library';
+        case 'dev':
+        case 'development':
+            return 'development';
+        case 'prod':
+        case 'production':
+            return 'production';
+        default:
+            throw new InvalidArgumentError(`Valid options are 'lib', 'dev', or 'prod'.`);
+    }
+}
 //# sourceMappingURL=reusedOptions.js.map

package/lib/utilities/reusedOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"reusedOptions.js","sourceRoot":"","sources":["../../src/utilities/reusedOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;IACnH,OAAO,EAAE,GAAG,EAAE,CACZ,IAAI,MAAM,CAAC,YAAY,EAAE,+EAA+E,CAAC;CAC5G,CAAC","sourcesContent":["import { Option } from 'commander';\n\n/**\n * These options are used by multiple commands, but should be manually added.\n */\nexport const reusedOptions = {\n  logResolveMap: () => new Option('--log-resolve-map', 'Logs the resolve map to \"resolve-map.json\" for diagnostics.'),\n  noCache: () =>\n    new Option('--no-cache', 'Ensures Cloudpack rebuilds all packages, rather than utilizing cached assets.'),\n};\n"]}
+{"version":3,"file":"reusedOptions.js","sourceRoot":"","sources":["../../src/utilities/reusedOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,mBAAmB,EAAE,4DAA4D,CAAC;IAClH,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,wDAAwD,CAAC;IACjG,IAAI,EAAE,CAAC,OAAqC,EAAE,EAAE,CAC9C,IAAI,MAAM,CACR,eAAe,EACf,eAAe,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,aAAa,6BAA6B,CAC/G;SACE,SAAS,CAAC,eAAe,CAAC;SAC1B,OAAO,CAAC,SAAS,CAAC;CACxB,CAAC;AAEF,kFAAkF;AAClF,SAAS,eAAe,CAAC,IAAY;IACnC,QAAQ,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK,CAAC;QACX,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,MAAM,CAAC;QACZ,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB;YACE,MAAM,IAAI,oBAAoB,CAAC,4CAA4C,CAAC,CAAC;IACjF,CAAC;AACH,CAAC","sourcesContent":["import type { BundleMode } from '@ms-cloudpack/common-types';\nimport { InvalidArgumentError, Option } from 'commander';\n\n/**\n * These options are used by multiple commands, but should be manually added.\n */\nexport const reusedOptions = {\n  logResolveMap: () => new Option('--log-resolve-map', 'Log the resolve map to \"resolve-map.json\" for diagnostics.'),\n  noCache: () => new Option('--no-cache', 'Rebuild all packages, rather than using cached assets.'),\n  mode: (options: { action: 'bundle' | 'run' }) =>\n    new Option(\n      '--mode <mode>',\n      `The mode to ${options.action === 'bundle' ? 'bundle the package' : 'run the app'} in. (library | production)`,\n    )\n      .argParser(parseBundleMode)\n      .default('library'),\n};\n\n/** Parse the session mode based on user input (e.g. --mode argument in start.) */\nfunction parseBundleMode(mode: string): BundleMode {\n  switch (mode.toLowerCase()) {\n    case 'lib':\n    case 'library':\n      return 'library';\n    case 'dev':\n    case 'development':\n      return 'development';\n    case 'prod':\n    case 'production':\n      return 'production';\n    default:\n      throw new InvalidArgumentError(`Valid options are 'lib', 'dev', or 'prod'.`);\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/cli",
-  "version": "0.70.0",
+  "version": "0.70.2",
   "description": "The Cloudpack command line interface - a tool for managing fast inner and outer looping in web apps.",
   "license": "MIT",
   "type": "module",
@@ -10,18 +10,18 @@
     "cloudpack": "./bin/cloudpack.js"
   },
   "dependencies": {
-    "@ms-cloudpack/api-server": "^0.52.1",
-    "@ms-cloudpack/app-server": "^0.15.16",
-    "@ms-cloudpack/common-types": "^0.19.7",
-    "@ms-cloudpack/config": "^0.29.1",
+    "@ms-cloudpack/api-server": "^0.52.3",
+    "@ms-cloudpack/app-server": "^0.15.18",
+    "@ms-cloudpack/common-types": "^0.20.0",
+    "@ms-cloudpack/config": "^0.29.2",
     "@ms-cloudpack/feature-flags": "^0.1.1",
     "@ms-cloudpack/json-utilities": "^0.1.7",
-    "@ms-cloudpack/overlay": "^0.17.69",
-    "@ms-cloudpack/package-utilities": "^10.1.1",
+    "@ms-cloudpack/overlay": "^0.17.71",
+    "@ms-cloudpack/package-utilities": "^10.1.2",
     "@ms-cloudpack/path-string-parsing": "^1.2.4",
-    "@ms-cloudpack/path-utilities": "^2.7.44",
-    "@ms-cloudpack/remote-cache": "^0.8.10",
-    "@ms-cloudpack/setup-utilities": "^0.4.0",
+    "@ms-cloudpack/path-utilities": "^2.7.45",
+    "@ms-cloudpack/remote-cache": "^0.8.11",
+    "@ms-cloudpack/setup-utilities": "^0.4.1",
     "@ms-cloudpack/task-reporter": "^0.14.5",
     "@ms-cloudpack/telemetry": "^0.6.2",
     "@yarnpkg/lockfile": "^1.1.0",
@@ -36,7 +36,7 @@
     "workspace-tools": "^0.36.4"
   },
   "devDependencies": {
-    "@ms-cloudpack/common-types": "^0.19.7",
+    "@ms-cloudpack/common-types": "^0.20.0",
     "@ms-cloudpack/eslint-plugin-internal": "^0.0.1",
     "@ms-cloudpack/scripts": "^0.0.1",
     "@ms-cloudpack/test-utilities": "^0.5.0",

package/lib/utilities/parseBundleMode.d.ts

@@ -1,4 +0,0 @@
-import type { BundleMode } from '@ms-cloudpack/common-types';
-/** Parse the session mode based on user input (e.g. --mode argument in start.) */
-export declare function parseBundleMode(mode: string): BundleMode;
-//# sourceMappingURL=parseBundleMode.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"parseBundleMode.d.ts","sourceRoot":"","sources":["../../src/utilities/parseBundleMode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAcxD"}

package/lib/utilities/parseBundleMode.js

@@ -1,18 +0,0 @@
-import { InvalidArgumentError } from 'commander';
-/** Parse the session mode based on user input (e.g. --mode argument in start.) */
-export function parseBundleMode(mode) {
-    switch (mode.toLowerCase()) {
-        case 'lib':
-        case 'library':
-            return 'library';
-        case 'dev':
-        case 'development':
-            return 'development';
-        case 'prod':
-        case 'production':
-            return 'production';
-        default:
-            throw new InvalidArgumentError(`Valid options are 'lib', 'dev', or 'prod'.`);
-    }
-}
-//# sourceMappingURL=parseBundleMode.js.map

package/lib/utilities/parseBundleMode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseBundleMode.js","sourceRoot":"","sources":["../../src/utilities/parseBundleMode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,QAAQ,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK,CAAC;QACX,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,MAAM,CAAC;QACZ,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB;YACE,MAAM,IAAI,oBAAoB,CAAC,4CAA4C,CAAC,CAAC;IACjF,CAAC;AACH,CAAC","sourcesContent":["import type { BundleMode } from '@ms-cloudpack/common-types';\nimport { InvalidArgumentError } from 'commander';\n\n/** Parse the session mode based on user input (e.g. --mode argument in start.) */\nexport function parseBundleMode(mode: string): BundleMode {\n  switch (mode.toLowerCase()) {\n    case 'lib':\n    case 'library':\n      return 'library';\n    case 'dev':\n    case 'development':\n      return 'development';\n    case 'prod':\n    case 'production':\n      return 'production';\n    default:\n      throw new InvalidArgumentError(`Valid options are 'lib', 'dev', or 'prod'.`);\n  }\n}\n"]}