@ms-cloudpack/cli 0.69.2 → 0.69.4

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAY9E,eAAO,MAAM,IAAI,EAAE,mBA8ClB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAM9E,eAAO,MAAM,IAAI,EAAE,mBAwDlB,CAAC"}

package/lib/commands/config/index.js

@@ -1,12 +1,18 @@
-import { Argument } from 'commander';
 import { allUserPreferences } from '@ms-cloudpack/config';
-const userPreferencesKeys = Object.keys(allUserPreferences);
-const skipSharedOptions = ['cachePath', 'features'];
+import { Argument } from 'commander';
 export const init = (program) => {
+    const userPreferencesKeys = Object.keys(allUserPreferences);
+    const keyWidth = Math.max(20, ...userPreferencesKeys.map((key) => key.length + 1));
     const configCommand = program.addSubCommand({
         name: 'config',
         description: 'Manage Cloudpack user preferences (requires a sub-command).',
         usage: '<command>',
+        hideSharedOptions: true,
+        addHelpText: {
+            position: 'afterAll',
+            text: '\nAvailable preferences:\n' +
+                userPreferencesKeys.map((key) => `  ${key.padEnd(keyWidth)}${allUserPreferences[key]}`).join('\n'),
+        },
     });
     configCommand.addSubCommand({
         name: 'set',
@@ -16,7 +22,7 @@ export const init = (program) => {
             key: new Argument('<key>', 'The key to set.').choices(userPreferencesKeys).argRequired(),
             value: new Argument('<value>', 'The value to set.').argRequired(),
         },
-        skipSharedOptions,
+        hideSharedOptions: true,
         getExecutor: () => import('./set.js'),
     });
     configCommand.addSubCommand({
@@ -25,13 +31,13 @@ export const init = (program) => {
         args: {
             key: new Argument('<key>', 'The key to get.').choices(userPreferencesKeys).argRequired(),
         },
-        skipSharedOptions,
+        hideSharedOptions: true,
         getExecutor: () => import('./get.js'),
     });
     configCommand.addSubCommand({
         name: 'list',
         description: 'List the current user preferences.',
-        skipSharedOptions,
+        hideSharedOptions: true,
         getExecutor: () => import('./list.js'),
     });
     configCommand.addSubCommand({
@@ -41,7 +47,7 @@ export const init = (program) => {
         args: {
             key: new Argument('<key>', 'The key to delete.').choices(userPreferencesKeys).argRequired(),
         },
-        skipSharedOptions,
+        hideSharedOptions: true,
         getExecutor: () => import('./delete.js'),
     });
 };

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAE5D,MAAM,iBAAiB,GAA+B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAA2B;QACpD,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,wBAAwB;QACrC,IAAI,EAAE;YACJ,oGAAoG;YACpG,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;YACxF,KAAK,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,WAAW,EAAE;SAClE;QACD,iBAAiB;QACjB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;KACtC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAA2B;QACpD,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,wBAAwB;QACrC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;SACzF;QACD,iBAAiB;QACjB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;KACtC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAAc;QACvC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oCAAoC;QACjD,iBAAiB;QACjB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;KACvC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAAiC;QAC1D,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,2BAA2B;QACxC,KAAK,EAAE,OAAO,EAAE,qBAAqB;QACrC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;SAC5F;QACD,iBAAiB;QACjB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC;KACzC,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Argument } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { SetArguments, SetOptions } from './set.js';\nimport { allUserPreferences } from '@ms-cloudpack/config';\nimport type { ListOptions } from './list.js';\nimport type { GetArguments, GetOptions } from './get.js';\nimport type { DeleteArguments, DeleteOptions } from './delete.js';\nimport type { SharedOptions } from '../../types/SharedOptions.js';\n\nconst userPreferencesKeys = Object.keys(allUserPreferences);\n\nconst skipSharedOptions: Array<keyof SharedOptions> = ['cachePath', 'features'];\n\nexport const init: CommandInitFunction = (program) => {\n  const configCommand = program.addSubCommand({\n    name: 'config',\n    description: 'Manage Cloudpack user preferences (requires a sub-command).',\n    usage: '<command>',\n  });\n\n  configCommand.addSubCommand<SetOptions, SetArguments>({\n    name: 'set',\n    description: 'Set a user preference.',\n    args: {\n      // commander will throw if key is not one of these values, so we don't need manual validation later.\n      key: new Argument('<key>', 'The key to set.').choices(userPreferencesKeys).argRequired(),\n      value: new Argument('<value>', 'The value to set.').argRequired(),\n    },\n    skipSharedOptions,\n    getExecutor: () => import('./set.js'),\n  });\n\n  configCommand.addSubCommand<GetOptions, GetArguments>({\n    name: 'get',\n    description: 'Get a user preference.',\n    args: {\n      key: new Argument('<key>', 'The key to get.').choices(userPreferencesKeys).argRequired(),\n    },\n    skipSharedOptions,\n    getExecutor: () => import('./get.js'),\n  });\n\n  configCommand.addSubCommand<ListOptions>({\n    name: 'list',\n    description: 'List the current user preferences.',\n    skipSharedOptions,\n    getExecutor: () => import('./list.js'),\n  });\n\n  configCommand.addSubCommand<DeleteOptions, DeleteArguments>({\n    name: 'delete',\n    description: 'Delete a user preference.',\n    alias: 'unset', // git uses this name\n    args: {\n      key: new Argument('<key>', 'The key to delete.').choices(userPreferencesKeys).argRequired(),\n    },\n    skipSharedOptions,\n    getExecutor: () => import('./delete.js'),\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAOrC,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAwC,CAAC;IACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAEnF,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE,WAAW;QAClB,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE;YACX,QAAQ,EAAE,UAAU;YACpB,IAAI,EACF,4BAA4B;gBAC5B,mBAAmB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SACrG;KACF,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAA2B;QACpD,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,wBAAwB;QACrC,IAAI,EAAE;YACJ,oGAAoG;YACpG,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;YACxF,KAAK,EAAE,IAAI,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,WAAW,EAAE;SAClE;QACD,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;KACtC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAA2B;QACpD,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,wBAAwB;QACrC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;SACzF;QACD,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;KACtC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAAc;QACvC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oCAAoC;QACjD,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;KACvC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAAiC;QAC1D,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,2BAA2B;QACxC,KAAK,EAAE,OAAO,EAAE,qBAAqB;QACrC,IAAI,EAAE;YACJ,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,EAAE;SAC5F;QACD,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC;KACzC,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { allUserPreferences } from '@ms-cloudpack/config';\nimport { Argument } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { DeleteArguments, DeleteOptions } from './delete.js';\nimport type { GetArguments, GetOptions } from './get.js';\nimport type { ListOptions } from './list.js';\nimport type { SetArguments, SetOptions } from './set.js';\n\nexport const init: CommandInitFunction = (program) => {\n  const userPreferencesKeys = Object.keys(allUserPreferences) as (keyof typeof allUserPreferences)[];\n  const keyWidth = Math.max(20, ...userPreferencesKeys.map((key) => key.length + 1));\n\n  const configCommand = program.addSubCommand({\n    name: 'config',\n    description: 'Manage Cloudpack user preferences (requires a sub-command).',\n    usage: '<command>',\n    hideSharedOptions: true,\n    addHelpText: {\n      position: 'afterAll',\n      text:\n        '\\nAvailable preferences:\\n' +\n        userPreferencesKeys.map((key) => `  ${key.padEnd(keyWidth)}${allUserPreferences[key]}`).join('\\n'),\n    },\n  });\n\n  configCommand.addSubCommand<SetOptions, SetArguments>({\n    name: 'set',\n    description: 'Set a user preference.',\n    args: {\n      // commander will throw if key is not one of these values, so we don't need manual validation later.\n      key: new Argument('<key>', 'The key to set.').choices(userPreferencesKeys).argRequired(),\n      value: new Argument('<value>', 'The value to set.').argRequired(),\n    },\n    hideSharedOptions: true,\n    getExecutor: () => import('./set.js'),\n  });\n\n  configCommand.addSubCommand<GetOptions, GetArguments>({\n    name: 'get',\n    description: 'Get a user preference.',\n    args: {\n      key: new Argument('<key>', 'The key to get.').choices(userPreferencesKeys).argRequired(),\n    },\n    hideSharedOptions: true,\n    getExecutor: () => import('./get.js'),\n  });\n\n  configCommand.addSubCommand<ListOptions>({\n    name: 'list',\n    description: 'List the current user preferences.',\n    hideSharedOptions: true,\n    getExecutor: () => import('./list.js'),\n  });\n\n  configCommand.addSubCommand<DeleteOptions, DeleteArguments>({\n    name: 'delete',\n    description: 'Delete a user preference.',\n    alias: 'unset', // git uses this name\n    args: {\n      key: new Argument('<key>', 'The key to delete.').choices(userPreferencesKeys).argRequired(),\n    },\n    hideSharedOptions: true,\n    getExecutor: () => import('./delete.js'),\n  });\n};\n"]}

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

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

package/lib/commands/info/index.js

@@ -1,24 +1,25 @@
 import { Option } from 'commander';
-const skipSharedOptions = ['cachePath', 'features'];
+const hideSharedOptions = ['cachePath', 'features'];
 /** Defines the "info" verb. */
 export const init = (program) => {
     const infoCommand = program.addSubCommand({
         name: 'info',
         description: 'Get repo info relevant to cloudpack (requires a sub-command).',
         usage: '<command>',
+        hideSharedOptions,
     });
     infoCommand.addSubCommand({
         name: 'lock-file',
         alias: 'lockfile',
         description: 'Get info about potentially problematic deps from the lock file (yarn v1 only).',
-        skipSharedOptions,
+        hideSharedOptions,
         getExecutor: () => import('./lockFile/execute.js'),
     });
     infoCommand.addSubCommand({
         name: 'non-semver-deps',
         description: 'Get a list of non-semver deps from local packages.',
         getExecutor: () => import('./nonSemverDeps/execute.js'),
-        skipSharedOptions,
+        hideSharedOptions,
         options: {
             prod: new Option('--prod', 'Only get production deps'),
         },

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,MAAM,iBAAiB,GAA+B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAEhF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;QACxC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;IAEH,WAAW,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,gFAAgF;QAC7F,iBAAiB;QACjB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;KACnD,CAAC,CAAC;IAEH,WAAW,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,oDAAoD;QACjE,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;QACvD,iBAAiB;QACjB,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SACvD;KACF,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { SharedOptions } from '../../types/SharedOptions.js';\n\nconst skipSharedOptions: Array<keyof SharedOptions> = ['cachePath', 'features'];\n\n/** Defines the \"info\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  const infoCommand = program.addSubCommand({\n    name: 'info',\n    description: 'Get repo info relevant to cloudpack (requires a sub-command).',\n    usage: '<command>',\n  });\n\n  infoCommand.addSubCommand({\n    name: 'lock-file',\n    alias: 'lockfile',\n    description: 'Get info about potentially problematic deps from the lock file (yarn v1 only).',\n    skipSharedOptions,\n    getExecutor: () => import('./lockFile/execute.js'),\n  });\n\n  infoCommand.addSubCommand({\n    name: 'non-semver-deps',\n    description: 'Get a list of non-semver deps from local packages.',\n    getExecutor: () => import('./nonSemverDeps/execute.js'),\n    skipSharedOptions,\n    options: {\n      prod: new Option('--prod', 'Only get production deps'),\n    },\n  });\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,MAAM,iBAAiB,GAA+B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAEhF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,IAAI,GAAwB,CAAC,OAAO,EAAE,EAAE;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;QACxC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,WAAW;QAClB,iBAAiB;KAClB,CAAC,CAAC;IAEH,WAAW,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,gFAAgF;QAC7F,iBAAiB;QACjB,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;KACnD,CAAC,CAAC;IAEH,WAAW,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,oDAAoD;QACjE,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;QACvD,iBAAiB;QACjB,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SACvD;KACF,CAAC,CAAC;AACL,CAAC,CAAC","sourcesContent":["import { Option } from 'commander';\nimport type { CommandInitFunction } from '../../types/CommandInitFunction.js';\nimport type { SharedOptions } from '../../types/SharedOptions.js';\n\nconst hideSharedOptions: Array<keyof SharedOptions> = ['cachePath', 'features'];\n\n/** Defines the \"info\" verb. */\nexport const init: CommandInitFunction = (program) => {\n  const infoCommand = program.addSubCommand({\n    name: 'info',\n    description: 'Get repo info relevant to cloudpack (requires a sub-command).',\n    usage: '<command>',\n    hideSharedOptions,\n  });\n\n  infoCommand.addSubCommand({\n    name: 'lock-file',\n    alias: 'lockfile',\n    description: 'Get info about potentially problematic deps from the lock file (yarn v1 only).',\n    hideSharedOptions,\n    getExecutor: () => import('./lockFile/execute.js'),\n  });\n\n  infoCommand.addSubCommand({\n    name: 'non-semver-deps',\n    description: 'Get a list of non-semver deps from local packages.',\n    getExecutor: () => import('./nonSemverDeps/execute.js'),\n    hideSharedOptions,\n    options: {\n      prod: new Option('--prod', 'Only get production deps'),\n    },\n  });\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;AAI9E,+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,mBAmBlB,CAAC"}

package/lib/commands/init/index.js

@@ -1,18 +1,19 @@
 import { Option } from 'commander';
 import { parseMatch } from '../../utilities/parseMatch.js';
+import { reusedOptions } from '../../utilities/reusedOptions.js';
 /** Defines the "init" verb. */
 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.',
         options: {
-            logResolveMap: new Option('--log-resolve-map', 'Logs the resolve map to "resolve-map.json" for diagnostics.'),
+            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'),
             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),
-            cache: new Option('--no-cache', 'Ensures Cloudpack rebuilds all packages, rather than utilizing cached assets.'),
+            cache: reusedOptions.noCache(),
         },
         getExecutor: () => import('./execute.js'),
     });

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;AAE3D,+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,IAAI,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;YAC7G,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,IAAI,MAAM,CAAC,YAAY,EAAE,+EAA+E,CAAC;SACjH;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';\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: new Option('--log-resolve-map', 'Logs the resolve map to \"resolve-map.json\" for diagnostics.'),\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: new Option('--no-cache', 'Ensures Cloudpack rebuilds all packages, rather than utilizing cached assets.'),\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,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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/link/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBA+BlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/link/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAI9E,+BAA+B;AAC/B,eAAO,MAAM,IAAI,EAAE,mBA4BlB,CAAC"}

package/lib/commands/link/index.js

@@ -1,4 +1,5 @@
 import { Option } from 'commander';
+import { reusedOptions } from '../../utilities/reusedOptions.js';
 /** Defines the "link" verb. */
 export const init = (program) => {
     program.addSubCommand({
@@ -11,7 +12,7 @@ export const init = (program) => {
             resolveStrategy: new Option('--resolve-strategy <strategy>', 'The strategy to use when resolving linked packages. Options are "dedupe" or "duplicate". Defaults to "dedupe".')
                 .choices(['dedupe', 'duplicate'])
                 .default('dedupe'),
-            logResolveMap: new Option('--log-resolve-map', 'Logs the linked resolve map to "resolve-map-linked.json" for diagnostics.'),
+            logResolveMap: reusedOptions.logResolveMap(),
         },
         getExecutor: () => import('./execute.js'),
     });

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;AAInC,+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,IAAI,MAAM,CACvB,mBAAmB,EACnB,2EAA2E,CAC5E;SACF;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';\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: new Option(\n        '--log-resolve-map',\n        'Logs the linked resolve map to \"resolve-map-linked.json\" for diagnostics.',\n      ),\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,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"]}

package/lib/commands/setup/index.js

@@ -7,7 +7,7 @@ export const init = (program) => {
         options: {
             force: new Option('--force', 'Forces execution of setup steps.'),
         },
-        skipSharedOptions: ['cachePath', 'features'],
+        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    skipSharedOptions: ['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;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"]}

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;AAK9E,gCAAgC;AAChC,eAAO,MAAM,IAAI,EAAE,mBAqBlB,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;AAM9E,gCAAgC;AAChC,eAAO,MAAM,IAAI,EAAE,mBAkBlB,CAAC"}

package/lib/commands/start/index.js

@@ -1,6 +1,7 @@
 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. */
 export const init = (program) => {
     program.addSubCommand({
@@ -10,10 +11,10 @@ export const init = (program) => {
             mode: new Option('--mode <mode>', 'The mode to run the app in. (library | development | production)')
                 .argParser(parseBundleMode)
                 .default('library'),
-            logResolveMap: new Option('--log-resolve-map', 'Logs the resolve map to "resolve-map.json" for diagnostics.'),
+            logResolveMap: reusedOptions.logResolveMap(),
             app: new Option('--app <appPackageName>', 'Run Cloudpack targeting a specific app.'),
             open: new Option('--no-open', 'Do not open the browser.'),
-            cache: new Option('--no-cache', 'Ensures Cloudpack rebuilds all packages when requested, rather than utilizing cached assets.'),
+            cache: reusedOptions.noCache(),
             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;AAEvC,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,IAAI,MAAM,CAAC,mBAAmB,EAAE,6DAA6D,CAAC;YAC7G,GAAG,EAAE,IAAI,MAAM,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;YACpF,IAAI,EAAE,IAAI,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;YACzD,KAAK,EAAE,IAAI,MAAM,CACf,YAAY,EACZ,8FAA8F,CAC/F;YACD,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';\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: new Option('--log-resolve-map', 'Logs the resolve map to \"resolve-map.json\" for diagnostics.'),\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: new Option(\n        '--no-cache',\n        'Ensures Cloudpack rebuilds all packages when requested, rather than utilizing cached assets.',\n      ),\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,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"]}

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":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,iCAAiC;AACjC,eAAO,MAAM,IAAI,EAAE,mBAalB,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,mBAUlB,CAAC"}

package/lib/commands/unlink/index.js

@@ -1,11 +1,11 @@
-import { Option } from 'commander';
+import { reusedOptions } from '../../utilities/reusedOptions.js';
 /** Defines the "unlink" verb. */
 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.',
         options: {
-            logResolveMap: new Option('--log-resolve-map', 'Logs the unlinked resolve map to "resolve-map-unlinked.json" for diagnostics.'),
+            logResolveMap: reusedOptions.logResolveMap(),
         },
         getExecutor: () => import('./execute.js'),
     });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/unlink/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,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,IAAI,MAAM,CACvB,mBAAmB,EACnB,+EAA+E,CAChF;SACF;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 { UnlinkOptions } from './types/UnlinkOptions.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: new Option(\n        '--log-resolve-map',\n        'Logs the unlinked resolve map to \"resolve-map-unlinked.json\" for diagnostics.',\n      ),\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,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"]}

package/lib/utilities/CloudpackCommand.d.ts

@@ -1,4 +1,4 @@
-import { Command, Option, type Argument, type OutputConfiguration } from 'commander';
+import { Command, Option, type AddHelpTextPosition, type Argument, type OutputConfiguration } from 'commander';
 import type { CommandActionModule } from '../types/CommandAction.js';
 import type { ProgramOptions } from '../types/ProgramOptions.js';
 import type { SharedOptions } from '../types/SharedOptions.js';
@@ -27,13 +27,22 @@ interface CloudpackCommandParams<TOptions extends object, TArguments extends obj
     usage?: string;
     /** Alternative name for the command */
     alias?: string;
+    /** Extra text to be displayed with the built-in help. */
+    addHelpText?: {
+        /**
+         * `'before'` or `'after'` to affect just this command.
+         * `'beforeAll'` or `'afterAll'` to affect this command and all its subcommands.
+         */
+        position: AddHelpTextPosition;
+        text: string;
+    };
     /** Output options override (mainly for testing) */
     outputOptions?: OutputConfiguration;
     /**
-     * Skip these shared options. The shared options are relevant for most commands, but this allows
-     * omitting them where they're not relevant (and none of the options are required, so it's fine).
+     * The shared options are relevant for most commands, but this allows omitting them from help
+     * where they're not relevant. `true` hides all shared options, or an array hides specific ones.
      */
-    skipSharedOptions?: Array<keyof SharedOptions>;
+    hideSharedOptions?: Array<keyof SharedOptions> | true;
 }
 /**
  * This wraps the `Command` class from [`commander`](https://www.npmjs.com/package/commander) with

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,QAAQ,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D;;;GAGG;AACH,UAAU,sBAAsB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IACjF,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEzC,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,mDAAmD;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,aAAa,CAAC,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IAC9E,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAiB;IAExC;;;OAGG;gBAGD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG;QACrD,cAAc,EAAE,cAAc,CAAC;QAC/B,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IAyCH,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;IAWnB,OAAO,CAAC,UAAU;CAoCnB"}
+{"version":3,"file":"CloudpackCommand.d.ts","sourceRoot":"","sources":["../../src/utilities/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,EAAE,KAAK,mBAAmB,EAAE,KAAK,QAAQ,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D;;;GAGG;AACH,UAAU,sBAAsB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM;IACjF,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEzC,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,eAAe,CAAiB;IAExC;;;OAGG;gBAGD,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG;QACrD,cAAc,EAAE,cAAc,CAAC;QAC/B,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IAiDH,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;IAYnB,OAAO,CAAC,UAAU;CAoCnB"}

package/lib/utilities/CloudpackCommand.js

@@ -1,4 +1,4 @@
-import { Command, Option } from 'commander';
+import { Command, Help, Option } from 'commander';
 import { isCIBuild } from '../utilities/isCIBuild.js';
 import { CommandExecutor } from './CommandExecutor.js';
 /**
@@ -23,8 +23,10 @@ export class CloudpackCommand {
         command.version(params.programOptions.version);
         command.description(params.description);
         command.allowExcessArguments(false);
+        command.createHelp = () => new CloudpackHelp();
         params.usage && command.usage(params.usage);
         params.alias && command.alias(params.alias);
+        params.addHelpText && command.addHelpText(params.addHelpText.position, params.addHelpText.text);
         params.outputOptions && command.configureOutput(params.outputOptions);
         params.getExecutor && this._addAction(params.getExecutor);
         if (params.args) {
@@ -44,8 +46,8 @@ export class CloudpackCommand {
             // In the parsed options, this will be a boolean `color` with default value true (except in tests and CI)
             new Option('-n, --no-color', 'Disable colors in the output.').default(!process.env.JEST_WORKER_ID && !process.env.LAGE_PACKAGE_NAME && !isCIBuild()),
             features: new Option('--features <featureNames...>', 'Enable experimental features.'),
-            cachePath: new Option('--cache-path <path>', 'Custom cache folder.'),
-        });
+            cachePath: new Option('--cache-path <path>', 'Custom cache folder. To change the default, run `cloudpack config set cachePath <path>`.'),
+        }, params.hideSharedOptions);
     }
     /** Create a child command. */
     addSubCommand(params) {
@@ -72,11 +74,12 @@ export class CloudpackCommand {
         }
     }
     /** Add options. The generic enforces that option objects are included for all keys of a type. */
-    _addOptions(options, skipOptions = []) {
+    _addOptions(options, hideOptions) {
         for (const [name, option] of Object.entries(options)) {
-            if (!skipOptions.includes(name)) {
-                this._command.addOption(option);
+            if (hideOptions === true || hideOptions?.includes(name)) {
+                option.hideHelp();
             }
+            this._command.addOption(option);
         }
     }
     _addAction(getExecutor) {
@@ -112,4 +115,14 @@ export class CloudpackCommand {
         });
     }
 }
+class CloudpackHelp extends Help {
+    visibleOptions(cmd) {
+        const options = super.visibleOptions(cmd);
+        if (cmd.name() !== 'cloudpack') {
+            // Remove --version from help except at the top level (it's not very useful)
+            return options.filter((option) => option.name() !== 'version');
+        }
+        return options;
+    }
+}
 //# sourceMappingURL=CloudpackCommand.js.map

package/lib/utilities/CloudpackCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"CloudpackCommand.js","sourceRoot":"","sources":["../../src/utilities/CloudpackCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAA2C,MAAM,WAAW,CAAC;AAIrF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA4CvD;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IAI3B;;;OAGG;IACH;IACE,4EAA4E;IAC5E,MAIC;QAED,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;QAE7C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAEpC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtE,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,CAAa,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,uEAAuE;YACvE,IAAI,CAAC,WAAW,CAAW,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,+FAA+F;QAC/F,iEAAiE;QACjE,IAAI,CAAC,WAAW,CAAgB;YAC9B,OAAO,EAAE,IAAI,MAAM,CAAC,eAAe,EAAE,kDAAkD,CAAC;YACxF,KAAK,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC;YACxG,KAAK,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;YAC1G,KAAK;YACH,yGAAyG;YACzG,IAAI,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC,OAAO,CACnE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,EAAE,CAC9E;YACH,QAAQ,EAAE,IAAI,MAAM,CAAC,8BAA8B,EAAE,+BAA+B,CAAC;YACrF,SAAS,EAAE,IAAI,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;SACrE,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IACvB,aAAa,CAClB,MAA8D;QAE9D,OAAO,IAAI,gBAAgB,CAAiC;YAC1D,GAAG,MAAM;YACT,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,MAAM,EAAE,IAAI,CAAC,QAAQ;SACtB,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IAC9D,KAAK,CAAC,GAAG;QACd,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,qGAAqG;IAC7F,aAAa,CAA+B,IAA2C;QAC7F,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAoB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,iGAAiG;IACzF,WAAW,CACjB,OAA0C,EAC1C,cAAwC,EAAE;QAE1C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAkC,EAAE,CAAC;YACtF,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,WAAqF;QACtG,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,0FAA0F;QAC1F,iGAAiG;QACjG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YACxB,iEAAiE;YACjE,iEAAiE;YACjE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAyB,CAAC;YAExD,kEAAkE;YAClE,kGAAkG;YAClG,gGAAgG;YAChG,6EAA6E;YAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,EAA4B,CAAC;YAEpE,kGAAkG;YAClG,wBAAwB;YACxB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAEpG,0CAA0C;YAC1C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;YACxC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,2EAA2E;gBAC3E,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,GAAG,CAAC,CAAC;YAC3F,CAAC;YAED,MAAM,eAAe,GAAG,IAAI,eAAe,CAA2B;gBACpE,IAAI,EAAE,aAAa;gBACnB,OAAO;gBACP,OAAO;gBACP,cAAc,EAAE,IAAI,CAAC,eAAe;gBACpC,IAAI;aACL,CAAC,CAAC;YACH,MAAM,eAAe,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { Command, Option, type Argument, type OutputConfiguration } from 'commander';\nimport type { CommandActionModule } from '../types/CommandAction.js';\nimport type { ProgramOptions } from '../types/ProgramOptions.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { isCIBuild } from '../utilities/isCIBuild.js';\nimport { CommandExecutor } from './CommandExecutor.js';\n\n/**\n * Parameters for creating a command.\n * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.\n */\ninterface CloudpackCommandParams<TOptions extends object, TArguments extends object> {\n  /** Command name */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /** Options specific to this command. The record ensures that all options are available in the CLI. */\n  options?: Record<keyof TOptions, 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  /** Output options override (mainly for testing) */\n  outputOptions?: OutputConfiguration;\n\n  /**\n   * Skip these shared options. The shared options are relevant for most commands, but this allows\n   * omitting them where they're not relevant (and none of the options are required, so it's fine).\n   */\n  skipSharedOptions?: Array<keyof SharedOptions>;\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 _programOptions: ProgramOptions;\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      programOptions: ProgramOptions;\n      /** This must be undefined for the top-level program command */\n      parent?: Command;\n    },\n  ) {\n    this._programOptions = params.programOptions;\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    params.usage && command.usage(params.usage);\n    params.alias && command.alias(params.alias);\n    params.outputOptions && command.configureOutput(params.outputOptions);\n    params.getExecutor && this._addAction(params.getExecutor);\n\n    if (params.args) {\n      this._addArguemnts<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      verbose: new Option('-v, --verbose', 'Show additional details about the running tasks.'),\n      debug: new Option('-d, --debug', 'Show debug information (superset of --verbose).').conflicts('verbose'),\n      quiet: new Option('-q, --quiet', 'Disable non-essential logging.').conflicts('verbose').conflicts('debug'),\n      color:\n        // In the parsed options, this will be a boolean `color` with default value true (except in tests and CI)\n        new Option('-n, --no-color', 'Disable colors in the output.').default(\n          !process.env.JEST_WORKER_ID && !process.env.LAGE_PACKAGE_NAME && !isCIBuild(),\n        ),\n      features: new Option('--features <featureNames...>', 'Enable experimental features.'),\n      cachePath: new Option('--cache-path <path>', 'Custom cache folder.'),\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._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._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 _addArguemnts<TAddArguments extends object>(args: Record<keyof TAddArguments, Argument>) {\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>,\n    skipOptions: Array<keyof TAddOptions> = [],\n  ): void {\n    for (const [name, option] of Object.entries(options) as [keyof TAddOptions, Option][]) {\n      if (!skipOptions.includes(name)) {\n        this._command.addOption(option);\n      }\n    }\n  }\n\n  private _addAction(getExecutor: NonNullable<CloudpackCommandParams<TOptions, TArguments>['getExecutor']>) {\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        programOptions: this._programOptions,\n        verb,\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, Help, Option, type AddHelpTextPosition, type Argument, type OutputConfiguration } from 'commander';\nimport type { CommandActionModule } from '../types/CommandAction.js';\nimport type { ProgramOptions } from '../types/ProgramOptions.js';\nimport type { SharedOptions } from '../types/SharedOptions.js';\nimport { isCIBuild } from '../utilities/isCIBuild.js';\nimport { CommandExecutor } from './CommandExecutor.js';\n\n/**\n * Parameters for creating a command.\n * `TOptions` should be the command-specific options (if any), e.g. `StartOptions`.\n */\ninterface CloudpackCommandParams<TOptions extends object, TArguments extends object> {\n  /** Command name */\n  name: string;\n\n  /** Command description */\n  description: string;\n\n  /** Options specific to this command. The record ensures that all options are available in the CLI. */\n  options?: Record<keyof TOptions, 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 _programOptions: ProgramOptions;\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      programOptions: ProgramOptions;\n      /** This must be undefined for the top-level program command */\n      parent?: Command;\n    },\n  ) {\n    this._programOptions = params.programOptions;\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    command.createHelp = () => new CloudpackHelp();\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._addArguemnts<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 about the running tasks.'),\n        debug: new Option('-d, --debug', 'Show debug information (superset of --verbose).').conflicts('verbose'),\n        quiet: new Option('-q, --quiet', 'Disable non-essential logging.').conflicts('verbose').conflicts('debug'),\n        color:\n          // In the parsed options, this will be a boolean `color` with default value true (except in tests and CI)\n          new Option('-n, --no-color', 'Disable colors in the output.').default(\n            !process.env.JEST_WORKER_ID && !process.env.LAGE_PACKAGE_NAME && !isCIBuild(),\n          ),\n        features: new Option('--features <featureNames...>', 'Enable experimental features.'),\n        cachePath: new Option(\n          '--cache-path <path>',\n          'Custom cache folder. To change the default, run `cloudpack config set cachePath <path>`.',\n        ),\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._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._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 _addArguemnts<TAddArguments extends object>(args: Record<keyof TAddArguments, Argument>) {\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>,\n    hideOptions?: Array<keyof TAddOptions> | true,\n  ): void {\n    for (const [name, option] of Object.entries(options) as [keyof TAddOptions, Option][]) {\n      if (hideOptions === true || hideOptions?.includes(name)) {\n        option.hideHelp();\n      }\n      this._command.addOption(option);\n    }\n  }\n\n  private _addAction(getExecutor: NonNullable<CloudpackCommandParams<TOptions, TArguments>['getExecutor']>) {\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        programOptions: this._programOptions,\n        verb,\n      });\n      await commandExecutor.execute();\n    });\n  }\n}\n\nclass CloudpackHelp extends Help {\n  visibleOptions(cmd: Command): Option[] {\n    const options = super.visibleOptions(cmd);\n\n    if (cmd.name() !== 'cloudpack') {\n      // Remove --version from help except at the top level (it's not very useful)\n      return options.filter((option) => option.name() !== 'version');\n    }\n\n    return options;\n  }\n}\n"]}

package/lib/utilities/reusedOptions.d.ts

@@ -0,0 +1,9 @@
+import { Option } from 'commander';
+/**
+ * These options are used by multiple commands, but should be manually added.
+ */
+export declare const reusedOptions: {
+    logResolveMap: () => Option;
+    noCache: () => Option;
+};
+//# sourceMappingURL=reusedOptions.d.ts.map

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

@@ -0,0 +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"}

package/lib/utilities/reusedOptions.js

@@ -0,0 +1,9 @@
+import { 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.'),
+};
+//# sourceMappingURL=reusedOptions.js.map

package/lib/utilities/reusedOptions.js.map

@@ -0,0 +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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ms-cloudpack/cli",
-  "version": "0.69.2",
+  "version": "0.69.4",
   "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.51.2",
-    "@ms-cloudpack/app-server": "^0.15.6",
-    "@ms-cloudpack/common-types": "^0.19.1",
-    "@ms-cloudpack/config": "^0.28.0",
+    "@ms-cloudpack/api-server": "^0.51.4",
+    "@ms-cloudpack/app-server": "^0.15.8",
+    "@ms-cloudpack/common-types": "^0.19.2",
+    "@ms-cloudpack/config": "^0.28.2",
     "@ms-cloudpack/feature-flags": "^0.1.1",
     "@ms-cloudpack/json-utilities": "^0.1.7",
-    "@ms-cloudpack/overlay": "^0.17.59",
-    "@ms-cloudpack/package-utilities": "^10.0.1",
+    "@ms-cloudpack/overlay": "^0.17.61",
+    "@ms-cloudpack/package-utilities": "^10.0.2",
     "@ms-cloudpack/path-string-parsing": "^1.2.4",
-    "@ms-cloudpack/path-utilities": "^2.7.38",
+    "@ms-cloudpack/path-utilities": "^2.7.39",
     "@ms-cloudpack/remote-cache": "^0.8.7",
-    "@ms-cloudpack/setup-utilities": "^0.3.0",
+    "@ms-cloudpack/setup-utilities": "^0.3.1",
     "@ms-cloudpack/task-reporter": "^0.14.4",
     "@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.1",
+    "@ms-cloudpack/common-types": "^0.19.2",
     "@ms-cloudpack/eslint-plugin-internal": "^0.0.1",
     "@ms-cloudpack/scripts": "^0.0.1",
     "@ms-cloudpack/test-utilities": "^0.5.0",
@@ -50,6 +50,7 @@
     "build": "cloudpack-scripts build",
     "lint:update": "cloudpack-scripts lint-update",
     "lint": "cloudpack-scripts lint",
+    "prepack": "cp .npmignore lib/.npmignore",
     "test:update": "cloudpack-scripts test-update",
     "test:watch": "cloudpack-scripts test-watch",
     "test": "cloudpack-scripts test"

package/lib/__fixtures__/commandTestSetup.d.ts

@@ -1,18 +0,0 @@
-export declare const cliRoot: string;
-export type CommandSpies = ReturnType<typeof commandBeforeAll>;
-/**
- * Shared setup for command tests: mock process.exit, spy on TaskReporter methods, override stdout
- * for TaskReporter, etc. Returns an object with potentially-useful spies.
- */
-export declare function commandBeforeAll(): {
-    exit: import(".store/jest-mock-npm-30.0.0-alpha.6-d61fbc299a/package").SpiedFunction<(code?: number) => never>;
-    reporterAddTask: import(".store/jest-mock-npm-30.0.0-alpha.6-d61fbc299a/package").SpiedFunction<(name: string, pending?: boolean) => import("@ms-cloudpack/task-reporter").TaskReporterTask>;
-    reporterComplete: import(".store/jest-mock-npm-30.0.0-alpha.6-d61fbc299a/package").SpiedFunction<(completeReason?: string, completedWithError?: boolean) => void>;
-    reporterStdoutOverride: import(".store/jest-mock-npm-30.0.0-alpha.6-d61fbc299a/package").Mock<(message: string) => void>;
-};
-/**
- * Shared `afterEach` for command tests:
- * Stop servers if relevant, verify that exit was called, and clear mocks.
- */
-export declare function commandAfterEach(spies: Pick<CommandSpies, 'exit'>): Promise<void>;
-//# sourceMappingURL=commandTestSetup.d.ts.map

package/lib/__fixtures__/commandTestSetup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commandTestSetup.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/commandTestSetup.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,OAAO,QAA4C,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,gBAAgB;;;;4GAGmB,MAAM,KAAK,IAAI;EAgCjE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,iBAavE"}

package/lib/__fixtures__/commandTestSetup.js

@@ -1,61 +0,0 @@
-import { expect, jest } from '@jest/globals';
-import { setStdoutOverride, TaskReporter } from '@ms-cloudpack/task-reporter';
-import { disableOpenBrowser } from '../commands/start/openBrowser.js';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { findPackageRoot } from 'workspace-tools';
-import { stopServers } from '../utilities/stopServers.js';
-const dirname = path.dirname(fileURLToPath(import.meta.url));
-// eslint-disable-next-line no-restricted-properties
-export const cliRoot = findPackageRoot(dirname) || process.cwd();
-/**
- * Shared setup for command tests: mock process.exit, spy on TaskReporter methods, override stdout
- * for TaskReporter, etc. Returns an object with potentially-useful spies.
- */
-export function commandBeforeAll() {
-    const reporterAddTask = jest.spyOn(TaskReporter.prototype, 'addTask');
-    const reporterComplete = jest.spyOn(TaskReporter.prototype, 'complete');
-    const reporterStdoutOverride = jest.fn();
-    setStdoutOverride({ write: reporterStdoutOverride, columns: 80 });
-    // throw if anything calls process.exit() with non-zero code
-    const exit = jest.spyOn(process, 'exit').mockImplementation(((code) => {
-        if (code && code !== 0) {
-            // If reporter.complete() was called with a reason, include it in the error message
-            // to make debugging easier (since reporter logs are hidden from the console)
-            const completeReason = reporterComplete.mock.calls[0]?.[0];
-            throw new Error(`Process exited with code ${code}${completeReason ? `. Reason:\n${completeReason}` : ''}`);
-        }
-    })); // process.exit() returns `never`
-    // only for start, but doesn't hurt for other commands
-    disableOpenBrowser();
-    // We don't want to accidentally call these utilities during a test...
-    // NOTE: for this to work, the test must not synchronously import something referencing this package
-    // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-    jest.unstable_mockModule('@ms-cloudpack/setup-utilities', () => ({
-        __esModule: true,
-        createCertificate: jest.fn(() => Promise.reject('not implemented')),
-        updateHostsEntry: jest.fn(() => Promise.reject('not implemented')),
-        getCertificate: jest.fn(() => Promise.reject('not implemented')),
-    }));
-    return {
-        exit,
-        reporterAddTask,
-        reporterComplete,
-        reporterStdoutOverride,
-    };
-}
-/**
- * Shared `afterEach` for command tests:
- * Stop servers if relevant, verify that exit was called, and clear mocks.
- */
-export async function commandAfterEach(spies) {
-    // This is for tests that use start, and must be done before the spies.exit check
-    await stopServers();
-    const exitCalled = spies.exit.mock.calls.length > 0;
-    jest.clearAllMocks();
-    if (!exitCalled) {
-        // Give a clearer error message here
-        expect('Test did not call process.exit(). If there was an earlier failure in the test, you can ignore this one.').toEqual('Test called process.exit()');
-    }
-}
-//# sourceMappingURL=commandTestSetup.js.map

package/lib/__fixtures__/commandTestSetup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"commandTestSetup.js","sourceRoot":"","sources":["../../src/__fixtures__/commandTestSetup.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, jest } from '@jest/globals';\nimport { setStdoutOverride, TaskReporter } from '@ms-cloudpack/task-reporter';\nimport { disableOpenBrowser } from '../commands/start/openBrowser.js';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { findPackageRoot } from 'workspace-tools';\nimport { stopServers } from '../utilities/stopServers.js';\n\nconst dirname = path.dirname(fileURLToPath(import.meta.url));\n// eslint-disable-next-line no-restricted-properties\nexport const cliRoot = findPackageRoot(dirname) || process.cwd();\n\nexport type CommandSpies = ReturnType<typeof commandBeforeAll>;\n\n/**\n * Shared setup for command tests: mock process.exit, spy on TaskReporter methods, override stdout\n * for TaskReporter, etc. Returns an object with potentially-useful spies.\n */\nexport function commandBeforeAll() {\n  const reporterAddTask = jest.spyOn(TaskReporter.prototype, 'addTask');\n  const reporterComplete = jest.spyOn(TaskReporter.prototype, 'complete');\n  const reporterStdoutOverride = jest.fn<(message: string) => void>();\n  setStdoutOverride({ write: reporterStdoutOverride, columns: 80 });\n\n  // throw if anything calls process.exit() with non-zero code\n  const exit = jest.spyOn(process, 'exit').mockImplementation(((code) => {\n    if (code && code !== 0) {\n      // If reporter.complete() was called with a reason, include it in the error message\n      // to make debugging easier (since reporter logs are hidden from the console)\n      const completeReason = reporterComplete.mock.calls[0]?.[0];\n      throw new Error(`Process exited with code ${code}${completeReason ? `. Reason:\\n${completeReason}` : ''}`);\n    }\n  }) as typeof process.exit); // process.exit() returns `never`\n\n  // only for start, but doesn't hurt for other commands\n  disableOpenBrowser();\n\n  // We don't want to accidentally call these utilities during a test...\n  // NOTE: for this to work, the test must not synchronously import something referencing this package\n  // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n  jest.unstable_mockModule<typeof import('@ms-cloudpack/setup-utilities')>('@ms-cloudpack/setup-utilities', () => ({\n    __esModule: true,\n    createCertificate: jest.fn(() => Promise.reject('not implemented')),\n    updateHostsEntry: jest.fn(() => Promise.reject('not implemented')),\n    getCertificate: jest.fn(() => Promise.reject('not implemented')),\n  }));\n\n  return {\n    exit,\n    reporterAddTask,\n    reporterComplete,\n    reporterStdoutOverride,\n  };\n}\n\n/**\n * Shared `afterEach` for command tests:\n * Stop servers if relevant, verify that exit was called, and clear mocks.\n */\nexport async function commandAfterEach(spies: Pick<CommandSpies, 'exit'>) {\n  // This is for tests that use start, and must be done before the spies.exit check\n  await stopServers();\n\n  const exitCalled = spies.exit.mock.calls.length > 0;\n  jest.clearAllMocks();\n\n  if (!exitCalled) {\n    // Give a clearer error message here\n    expect(\n      'Test did not call process.exit(). If there was an earlier failure in the test, you can ignore this one.',\n    ).toEqual('Test called process.exit()');\n  }\n}\n"]}

package/lib/__fixtures__/createMockSession.d.ts

@@ -1,6 +0,0 @@
-import { type Session } from '@ms-cloudpack/api-server';
-export declare function createMockSession(params: {
-    id: string;
-    cachePath: string;
-}): Session;
-//# sourceMappingURL=createMockSession.d.ts.map

package/lib/__fixtures__/createMockSession.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createMockSession.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/createMockSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAiBpF"}

package/lib/__fixtures__/createMockSession.js

@@ -1,19 +0,0 @@
-export function createMockSession(params) {
-    return {
-        ...params,
-        config: { appPath: '/path/to/app', mode: 'library', generated: {} },
-        projectName: 'app',
-        resolveMap: {},
-        sequence: 0,
-        urls: {},
-        targetVersions: {},
-        sessionVersion: 1,
-        incrementSessionVersion: () => { },
-        incrementTargetVersion: () => { },
-        importMap: { imports: {} },
-        linkedPaths: [],
-        addLinkedPath: () => Promise.resolve({ resolveMap: {}, linkedPaths: [] }),
-        removeLinkedPath: () => Promise.resolve({ resolveMap: {}, linkedPaths: [] }),
-    };
-}
-//# sourceMappingURL=createMockSession.js.map

package/lib/__fixtures__/createMockSession.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createMockSession.js","sourceRoot":"","sources":["../../src/__fixtures__/createMockSession.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAyC;IACzE,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QACnE,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,EAAE;QACR,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,CAAC;QACjB,uBAAuB,EAAE,GAAG,EAAE,GAAE,CAAC;QACjC,sBAAsB,EAAE,GAAG,EAAE,GAAE,CAAC;QAChC,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1B,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QACzE,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;KAC7E,CAAC;AACJ,CAAC","sourcesContent":["import { type Session } from '@ms-cloudpack/api-server';\n\nexport function createMockSession(params: { id: string; cachePath: string }): Session {\n  return {\n    ...params,\n    config: { appPath: '/path/to/app', mode: 'library', generated: {} },\n    projectName: 'app',\n    resolveMap: {},\n    sequence: 0,\n    urls: {},\n    targetVersions: {},\n    sessionVersion: 1,\n    incrementSessionVersion: () => {},\n    incrementTargetVersion: () => {},\n    importMap: { imports: {} },\n    linkedPaths: [],\n    addLinkedPath: () => Promise.resolve({ resolveMap: {}, linkedPaths: [] }),\n    removeLinkedPath: () => Promise.resolve({ resolveMap: {}, linkedPaths: [] }),\n  };\n}\n"]}

package/lib/__fixtures__/getPortArgsForStart.d.ts

@@ -1,21 +0,0 @@
-declare const ranges: {
-    apiServer: {
-        [k: string]: number[];
-    };
-    appServer: {
-        [k: string]: number[];
-    };
-    bundleServer: {
-        [k: string]: number[];
-    };
-};
-/**
- * Get the designated range of ports for a given file.
- */
-export declare function getPortsForFile(importMetaUrl: string, type: keyof typeof ranges): number[];
-/**
- * Get port args for the start command, with a non-overlapping ports based on the current file.
- */
-export declare function getPortArgsForStart(importMetaUrl: string): string[];
-export {};
-//# sourceMappingURL=getPortArgsForStart.d.ts.map

package/lib/__fixtures__/getPortArgsForStart.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getPortArgsForStart.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/getPortArgsForStart.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,MAAM;;;;;;;;;;CAIX,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,MAAM,GAAG,MAAM,EAAE,CAO1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,YASxD"}

package/lib/__fixtures__/getPortArgsForStart.js

@@ -1,36 +0,0 @@
-import { portNumbers } from 'get-port';
-import path from 'path';
-// New files can be added to this list to get a port range.
-const files = ['start.e2e.test.ts', 'link.e2e.test.ts', 'unlink.e2e.test.ts', 'getActiveSessions.test.ts'];
-const makePortNumbers = (startPort) => Object.fromEntries(files.map((file) => [file, [...portNumbers(startPort + 1, (startPort += 10))]]));
-// These start numbers are somewhat arbitrary: currently a bit above the default ranges.
-const ranges = {
-    apiServer: makePortNumbers(9900),
-    appServer: makePortNumbers(5010),
-    bundleServer: makePortNumbers(5510),
-};
-/**
- * Get the designated range of ports for a given file.
- */
-export function getPortsForFile(importMetaUrl, type) {
-    const filename = path.basename(importMetaUrl);
-    const range = ranges[type][filename];
-    if (!range) {
-        throw new Error(`Please add ${filename} to the list of files with port ranges`);
-    }
-    return range;
-}
-/**
- * Get port args for the start command, with a non-overlapping ports based on the current file.
- */
-export function getPortArgsForStart(importMetaUrl) {
-    return [
-        '--api-server-port',
-        `${getPortsForFile(importMetaUrl, 'apiServer').join(',')}`,
-        '--app-server-port',
-        `${getPortsForFile(importMetaUrl, 'appServer').join(',')}`,
-        '--bundle-server-port',
-        `${getPortsForFile(importMetaUrl, 'bundleServer').join(',')}`,
-    ];
-}
-//# sourceMappingURL=getPortArgsForStart.js.map

package/lib/__fixtures__/getPortArgsForStart.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getPortArgsForStart.js","sourceRoot":"","sources":["../../src/__fixtures__/getPortArgsForStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,2DAA2D;AAC3D,MAAM,KAAK,GAAG,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,2BAA2B,CAAC,CAAC;AAE3G,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC5C,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtG,wFAAwF;AACxF,MAAM,MAAM,GAAG;IACb,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC;IAChC,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC;IAChC,YAAY,EAAE,eAAe,CAAC,IAAI,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB,EAAE,IAAyB;IAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,wCAAwC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,aAAqB;IACvD,OAAO;QACL,mBAAmB;QACnB,GAAG,eAAe,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC1D,mBAAmB;QACnB,GAAG,eAAe,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC1D,sBAAsB;QACtB,GAAG,eAAe,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;KAC9D,CAAC;AACJ,CAAC","sourcesContent":["import { portNumbers } from 'get-port';\nimport path from 'path';\n\n// New files can be added to this list to get a port range.\nconst files = ['start.e2e.test.ts', 'link.e2e.test.ts', 'unlink.e2e.test.ts', 'getActiveSessions.test.ts'];\n\nconst makePortNumbers = (startPort: number) =>\n  Object.fromEntries(files.map((file) => [file, [...portNumbers(startPort + 1, (startPort += 10))]]));\n\n// These start numbers are somewhat arbitrary: currently a bit above the default ranges.\nconst ranges = {\n  apiServer: makePortNumbers(9900),\n  appServer: makePortNumbers(5010),\n  bundleServer: makePortNumbers(5510),\n};\n\n/**\n * Get the designated range of ports for a given file.\n */\nexport function getPortsForFile(importMetaUrl: string, type: keyof typeof ranges): number[] {\n  const filename = path.basename(importMetaUrl);\n  const range = ranges[type][filename];\n  if (!range) {\n    throw new Error(`Please add ${filename} to the list of files with port ranges`);\n  }\n  return range;\n}\n\n/**\n * Get port args for the start command, with a non-overlapping ports based on the current file.\n */\nexport function getPortArgsForStart(importMetaUrl: string) {\n  return [\n    '--api-server-port',\n    `${getPortsForFile(importMetaUrl, 'apiServer').join(',')}`,\n    '--app-server-port',\n    `${getPortsForFile(importMetaUrl, 'appServer').join(',')}`,\n    '--bundle-server-port',\n    `${getPortsForFile(importMetaUrl, 'bundleServer').join(',')}`,\n  ];\n}\n"]}

package/lib/__fixtures__/mainWrapper.d.ts

@@ -1,9 +0,0 @@
-import { type MainOptions } from '../main.js';
-/**
- * Call `main` with a cwd and appropriate args.
- * Note that for the test, `options.argv` only needs to contain the verb and its args.
- */
-export declare function mainWrapper(options: Omit<MainOptions, 'cwd'> & {
-    cwd: string;
-}): Promise<void>;
-//# sourceMappingURL=mainWrapper.d.ts.map

package/lib/__fixtures__/mainWrapper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mainWrapper.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/mainWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,iBAW9E"}

package/lib/__fixtures__/mainWrapper.js

@@ -1,17 +0,0 @@
-import { main } from '../main.js';
-/**
- * Call `main` with a cwd and appropriate args.
- * Note that for the test, `options.argv` only needs to contain the verb and its args.
- */
-export function mainWrapper(options) {
-    // Simulate running `cloudpack` from the command line (the first two args aren't used).
-    // Always run in quiet mode to avoid cluttering the test output with logs.
-    const argv = ['node', 'cloudpack', ...(options.argv || []), '--quiet'];
-    return main({
-        ...options,
-        argv,
-        // Ensure no telemetry is sent during tests
-        disableTelemetry: true,
-    });
-}
-//# sourceMappingURL=mainWrapper.js.map

package/lib/__fixtures__/mainWrapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mainWrapper.js","sourceRoot":"","sources":["../../src/__fixtures__/mainWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmD;IAC7E,uFAAuF;IACvF,0EAA0E;IAC1E,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IAEvE,OAAO,IAAI,CAAC;QACV,GAAG,OAAO;QACV,IAAI;QACJ,2CAA2C;QAC3C,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { main, type MainOptions } from '../main.js';\n\n/**\n * Call `main` with a cwd and appropriate args.\n * Note that for the test, `options.argv` only needs to contain the verb and its args.\n */\nexport function mainWrapper(options: Omit<MainOptions, 'cwd'> & { cwd: string }) {\n  // Simulate running `cloudpack` from the command line (the first two args aren't used).\n  // Always run in quiet mode to avoid cluttering the test output with logs.\n  const argv = ['node', 'cloudpack', ...(options.argv || []), '--quiet'];\n\n  return main({\n    ...options,\n    argv,\n    // Ensure no telemetry is sent during tests\n    disableTelemetry: true,\n  });\n}\n"]}

package/lib/__fixtures__/mockActiveSessions.d.ts

@@ -1,15 +0,0 @@
-import type { Session } from '@ms-cloudpack/common-types';
-import type { trackSession as trackSessionType } from '../commands/start/trackSession.js';
-/**
- * Mock `getActiveSessions` to return a custom list of sessions, and mock `trackSession` to add
- * sessions to the list.
- *
- * This ensures that for link tests, there's not a prompt to choose a session.
- *
- * @param fromImportMetaUrl The import.meta.url of the test file calling this function.
- */
-export declare function mockActiveSessions(fromImportMetaUrl: string): {
-    activeSessions: Session[];
-    trackSession: import(".store/jest-mock-npm-30.0.0-alpha.6-d61fbc299a/package").Mock<typeof trackSessionType>;
-};
-//# sourceMappingURL=mockActiveSessions.d.ts.map

package/lib/__fixtures__/mockActiveSessions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mockActiveSessions.d.ts","sourceRoot":"","sources":["../../src/__fixtures__/mockActiveSessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAO1F;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,iBAAiB,EAAE,MAAM;oBAElC,OAAO,EAAE;;EAmBlC"}

package/lib/__fixtures__/mockActiveSessions.js

@@ -1,38 +0,0 @@
-import { jest } from '@jest/globals';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { normalizedPathRelativeTo } from '@ms-cloudpack/path-utilities';
-const currentDir = path.dirname(fileURLToPath(import.meta.url));
-/**
- * Mock `getActiveSessions` to return a custom list of sessions, and mock `trackSession` to add
- * sessions to the list.
- *
- * This ensures that for link tests, there's not a prompt to choose a session.
- *
- * @param fromImportMetaUrl The import.meta.url of the test file calling this function.
- */
-export function mockActiveSessions(fromImportMetaUrl) {
-    const mocks = {
-        activeSessions: [],
-        trackSession: jest.fn((session) => {
-            mocks.activeSessions.push(session);
-            return Promise.resolve({ close: () => Promise.resolve() });
-        }),
-    };
-    // These paths need to be relative to the test file, not the current file
-    jest.unstable_mockModule(getRelativePath(fromImportMetaUrl, '../commands/link/getActiveSessions.js'), () => ({
-        __esModule: true,
-        getActiveSessions: () => Promise.resolve(mocks.activeSessions),
-    }));
-    jest.unstable_mockModule(getRelativePath(fromImportMetaUrl, '../commands/start/trackSession.js'), () => ({
-        __esModule: true,
-        trackSession: mocks.trackSession,
-    }));
-    return mocks;
-}
-function getRelativePath(fromImportMetaUrl, toRelativePath) {
-    const fromAbsDir = path.dirname(fileURLToPath(fromImportMetaUrl));
-    const toAbsFile = path.resolve(currentDir, toRelativePath);
-    return normalizedPathRelativeTo(fromAbsDir, toAbsFile);
-}
-//# sourceMappingURL=mockActiveSessions.js.map

package/lib/__fixtures__/mockActiveSessions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mockActiveSessions.js","sourceRoot":"","sources":["../../src/__fixtures__/mockActiveSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,iBAAyB;IAC1D,MAAM,KAAK,GAAG;QACZ,cAAc,EAAE,EAAe;QAC/B,YAAY,EAAE,IAAI,CAAC,EAAE,CAA0B,CAAC,OAAO,EAAE,EAAE;YACzD,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC;KACH,CAAC;IAEF,yEAAyE;IACzE,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,iBAAiB,EAAE,uCAAuC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3G,UAAU,EAAE,IAAI;QAChB,iBAAiB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;KAC/D,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,iBAAiB,EAAE,mCAAmC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACvG,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC,CAAC;IAEJ,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,iBAAyB,EAAE,cAAsB;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC3D,OAAO,wBAAwB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import { jest } from '@jest/globals';\nimport type { Session } from '@ms-cloudpack/common-types';\nimport type { trackSession as trackSessionType } from '../commands/start/trackSession.js';\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { normalizedPathRelativeTo } from '@ms-cloudpack/path-utilities';\n\nconst currentDir = path.dirname(fileURLToPath(import.meta.url));\n\n/**\n * Mock `getActiveSessions` to return a custom list of sessions, and mock `trackSession` to add\n * sessions to the list.\n *\n * This ensures that for link tests, there's not a prompt to choose a session.\n *\n * @param fromImportMetaUrl The import.meta.url of the test file calling this function.\n */\nexport function mockActiveSessions(fromImportMetaUrl: string) {\n  const mocks = {\n    activeSessions: [] as Session[],\n    trackSession: jest.fn<typeof trackSessionType>((session) => {\n      mocks.activeSessions.push(session);\n      return Promise.resolve({ close: () => Promise.resolve() });\n    }),\n  };\n\n  // These paths need to be relative to the test file, not the current file\n  jest.unstable_mockModule(getRelativePath(fromImportMetaUrl, '../commands/link/getActiveSessions.js'), () => ({\n    __esModule: true,\n    getActiveSessions: () => Promise.resolve(mocks.activeSessions),\n  }));\n\n  jest.unstable_mockModule(getRelativePath(fromImportMetaUrl, '../commands/start/trackSession.js'), () => ({\n    __esModule: true,\n    trackSession: mocks.trackSession,\n  }));\n\n  return mocks;\n}\n\nfunction getRelativePath(fromImportMetaUrl: string, toRelativePath: string) {\n  const fromAbsDir = path.dirname(fileURLToPath(fromImportMetaUrl));\n  const toAbsFile = path.resolve(currentDir, toRelativePath);\n  return normalizedPathRelativeTo(fromAbsDir, toAbsFile);\n}\n"]}