skuba 4.4.1 → 5.0.0

package/lib/index.js

@@ -1,43 +1,47 @@
 "use strict";
-/**
- * Entry point for the Node.js development API.
- *
- * This is where skuba imports point to:
- *
- * ```typescript
- * import { Net } from 'skuba';
- *
- * const { Net } = require('skuba');
- * ```
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Net = exports.Jest = exports.GitHub = exports.Git = exports.Buildkite = void 0;
-exports.Buildkite = __importStar(require("./api/buildkite"));
-exports.Git = __importStar(require("./api/git"));
-exports.GitHub = __importStar(require("./api/github"));
-exports.Jest = __importStar(require("./api/jest"));
-exports.Net = __importStar(require("./api/net"));
-//# sourceMappingURL=index.js.map
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var src_exports = {};
+__export(src_exports, {
+  Buildkite: () => Buildkite,
+  Git: () => Git,
+  GitHub: () => GitHub,
+  Jest: () => Jest,
+  Net: () => Net
+});
+module.exports = __toCommonJS(src_exports);
+var Buildkite = __toESM(require("./api/buildkite"));
+var Git = __toESM(require("./api/git"));
+var GitHub = __toESM(require("./api/github"));
+var Jest = __toESM(require("./api/jest"));
+var Net = __toESM(require("./api/net"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Buildkite,
+  Git,
+  GitHub,
+  Jest,
+  Net
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,6DAA6C;AAC7C,iDAAiC;AACjC,uDAAuC;AACvC,mDAAmC;AACnC,iDAAiC"}
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * Entry point for the Node.js development API.\n *\n * This is where skuba imports point to:\n *\n * ```typescript\n * import { Net } from 'skuba';\n *\n * const { Net } = require('skuba');\n * ```\n */\n\nexport * as Buildkite from './api/buildkite';\nexport * as Git from './api/git';\nexport * as GitHub from './api/github';\nexport * as Jest from './api/jest';\nexport * as Net from './api/net';\n\n// evanw/esbuild#2388\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace WebAssembly {\n    interface Module {}\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,gBAA2B;AAC3B,UAAqB;AACrB,aAAwB;AACxB,WAAsB;AACtB,UAAqB;",
+  "names": []
+}

package/lib/skuba.js

@@ -1,44 +1,51 @@
 #!/usr/bin/env node
 "use strict";
-/**
- * Entry point for the CLI.
- *
- * This is where you end up when you run:
- *
- * ```bash
- * [yarn] skuba help
- * ```
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
-const args_1 = require("./utils/args");
-const command_1 = require("./utils/command");
-const error_1 = require("./utils/error");
-const help_1 = require("./utils/help");
-const logging_1 = require("./utils/logging");
-const logo_1 = require("./utils/logo");
-const validation_1 = require("./utils/validation");
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_path = __toESM(require("path"));
+var import_args = require("./utils/args");
+var import_command = require("./utils/command");
+var import_error = require("./utils/error");
+var import_help = require("./utils/help");
+var import_logging = require("./utils/logging");
+var import_logo = require("./utils/logo");
+var import_validation = require("./utils/validation");
 const skuba = async () => {
-    const { commandName } = (0, args_1.parseProcessArgs)(process.argv);
-    if (command_1.COMMAND_SET.has(commandName)) {
-        const moduleName = (0, command_1.commandToModule)(commandName);
-        /* eslint-disable @typescript-eslint/no-var-requires */
-        const commandModule = require(path_1.default.join(command_1.COMMAND_DIR, moduleName));
-        if (!(0, validation_1.hasProp)(commandModule, moduleName)) {
-            logging_1.log.err(logging_1.log.bold(commandName), "couldn't run! Please submit an issue.");
-            process.exitCode = 1;
-            return;
-        }
-        const run = commandModule[moduleName];
-        return run();
+  const { commandName } = (0, import_args.parseProcessArgs)(process.argv);
+  if (import_command.COMMAND_SET.has(commandName)) {
+    const moduleName = (0, import_command.commandToModule)(commandName);
+    const commandModule = require(import_path.default.join(
+      import_command.COMMAND_DIR,
+      moduleName
+    ));
+    if (!(0, import_validation.hasProp)(commandModule, moduleName)) {
+      import_logging.log.err(import_logging.log.bold(commandName), "couldn't run! Please submit an issue.");
+      process.exitCode = 1;
+      return;
     }
-    logging_1.log.err(logging_1.log.bold(commandName), 'is not recognised as a command.');
-    await (0, logo_1.showLogoAndVersionInfo)();
-    (0, help_1.showHelp)();
-    process.exitCode = 1;
+    const run = commandModule[moduleName];
+    return run();
+  }
+  import_logging.log.err(import_logging.log.bold(commandName), "is not recognised as a command.");
+  await (0, import_logo.showLogoAndVersionInfo)();
+  (0, import_help.showHelp)();
+  process.exitCode = 1;
 };
-skuba().catch(error_1.handleCliError);
-//# sourceMappingURL=skuba.js.map
+skuba().catch(import_error.handleCliError);
+//# sourceMappingURL=skuba.js.map

package/lib/skuba.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"skuba.js","sourceRoot":"","sources":["../src/skuba.ts"],"names":[],"mappings":";;AAEA;;;;;;;;GAQG;;;;;AAEH,gDAAwB;AAExB,uCAAgD;AAChD,6CAA4E;AAC5E,yCAA+C;AAC/C,uCAAwC;AACxC,6CAAsC;AACtC,uCAAsD;AACtD,mDAA6C;AAE7C,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;IACvB,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,uBAAgB,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,IAAI,qBAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QAChC,MAAM,UAAU,GAAG,IAAA,yBAAe,EAAC,WAAW,CAAC,CAAC;QAEhD,uDAAuD;QACvD,MAAM,aAAa,GAAG,OAAO,CAAC,cAAI,CAAC,IAAI,CACrC,qBAAW,EACX,UAAU,CACX,CAAY,CAAC;QAEd,IAAI,CAAC,IAAA,oBAAO,EAAC,aAAa,EAAE,UAAU,CAAC,EAAE;YACvC,aAAG,CAAC,GAAG,CAAC,aAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,uCAAuC,CAAC,CAAC;YACxE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;SACR;QAED,MAAM,GAAG,GAAG,aAAa,CAAC,UAAU,CAA2B,CAAC;QAEhE,OAAO,GAAG,EAAE,CAAC;KACd;IAED,aAAG,CAAC,GAAG,CAAC,aAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,iCAAiC,CAAC,CAAC;IAClE,MAAM,IAAA,6BAAsB,GAAE,CAAC;IAC/B,IAAA,eAAQ,GAAE,CAAC;IAEX,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,KAAK,EAAE,CAAC,KAAK,CAAC,sBAAc,CAAC,CAAC"}
+{
+  "version": 3,
+  "sources": ["../src/skuba.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * Entry point for the CLI.\n *\n * This is where you end up when you run:\n *\n * ```bash\n * [yarn] skuba help\n * ```\n */\n\nimport path from 'path';\n\nimport { parseProcessArgs } from './utils/args';\nimport { COMMAND_DIR, COMMAND_SET, commandToModule } from './utils/command';\nimport { handleCliError } from './utils/error';\nimport { showHelp } from './utils/help';\nimport { log } from './utils/logging';\nimport { showLogoAndVersionInfo } from './utils/logo';\nimport { hasProp } from './utils/validation';\n\nconst skuba = async () => {\n  const { commandName } = parseProcessArgs(process.argv);\n\n  if (COMMAND_SET.has(commandName)) {\n    const moduleName = commandToModule(commandName);\n\n    /* eslint-disable @typescript-eslint/no-var-requires */\n    const commandModule = require(path.join(\n      COMMAND_DIR,\n      moduleName,\n    )) as unknown;\n\n    if (!hasProp(commandModule, moduleName)) {\n      log.err(log.bold(commandName), \"couldn't run! Please submit an issue.\");\n      process.exitCode = 1;\n      return;\n    }\n\n    const run = commandModule[moduleName] as () => Promise<unknown>;\n\n    return run();\n  }\n\n  log.err(log.bold(commandName), 'is not recognised as a command.');\n  await showLogoAndVersionInfo();\n  showHelp();\n\n  process.exitCode = 1;\n};\n\nskuba().catch(handleCliError);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAYA,kBAAiB;AAEjB,kBAAiC;AACjC,qBAA0D;AAC1D,mBAA+B;AAC/B,kBAAyB;AACzB,qBAAoB;AACpB,kBAAuC;AACvC,wBAAwB;AAExB,MAAM,QAAQ,YAAY;AACxB,QAAM,EAAE,YAAY,QAAI,8BAAiB,QAAQ,IAAI;AAErD,MAAI,2BAAY,IAAI,WAAW,GAAG;AAChC,UAAM,iBAAa,gCAAgB,WAAW;AAG9C,UAAM,gBAAgB,QAAQ,YAAAA,QAAK;AAAA,MACjC;AAAA,MACA;AAAA,IACF,CAAC;AAED,QAAI,KAAC,2BAAQ,eAAe,UAAU,GAAG;AACvC,yBAAI,IAAI,mBAAI,KAAK,WAAW,GAAG,uCAAuC;AACtE,cAAQ,WAAW;AACnB;AAAA,IACF;AAEA,UAAM,MAAM,cAAc;AAE1B,WAAO,IAAI;AAAA,EACb;AAEA,qBAAI,IAAI,mBAAI,KAAK,WAAW,GAAG,iCAAiC;AAChE,YAAM,oCAAuB;AAC7B,4BAAS;AAET,UAAQ,WAAW;AACrB;AAEA,MAAM,EAAE,MAAM,2BAAc;",
+  "names": ["path"]
+}

package/lib/utils/args.js

@@ -1,107 +1,108 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseRunArgs = exports.parseProcessArgs = exports.hasSerialFlag = exports.hasDebugFlag = void 0;
-const assert_1 = __importDefault(require("assert"));
-const command_1 = require("./command");
-const hasDebugFlag = (args = process.argv) => args.some((arg) => arg.toLocaleLowerCase() === '--debug');
-exports.hasDebugFlag = hasDebugFlag;
-const hasSerialFlag = (args = process.argv, env = process.env) => args.some((arg) => arg.toLocaleLowerCase() === '--serial') ||
-    Boolean(
-    // Run serially on SEEK's central npm publishing pipeline.
-    // Exhausting agents here can cause grief.
-    env.BUILDKITE_AGENT_META_DATA_QUEUE?.split(',').some((queueName) => queueName.startsWith('artefacts:npm')));
-exports.hasSerialFlag = hasSerialFlag;
-/**
- * Parse process arguments.
- *
- * This function mutates the input list by removing the command name element.
- * Downstream commands can access their args with an ordinary
- * `process.argv.slice(2)`.
- *
- * Example input:
- *
- * ```typescript
- * ['/bin/node', 'node_modules/.bin/skuba', 'test', '--foo', '--bar']
- * ```
- */
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var args_exports = {};
+__export(args_exports, {
+  hasDebugFlag: () => hasDebugFlag,
+  hasSerialFlag: () => hasSerialFlag,
+  parseProcessArgs: () => parseProcessArgs,
+  parseRunArgs: () => parseRunArgs
+});
+module.exports = __toCommonJS(args_exports);
+var import_assert = __toESM(require("assert"));
+var import_command = require("./command");
+const hasDebugFlag = (args = process.argv) => args.some((arg) => arg.toLocaleLowerCase() === "--debug");
+const hasSerialFlag = (args = process.argv, env = process.env) => args.some((arg) => arg.toLocaleLowerCase() === "--serial") || Boolean(
+  env.BUILDKITE_AGENT_META_DATA_QUEUE?.split(",").some(
+    (queueName) => queueName.startsWith("artefacts:npm")
+  )
+);
 const parseProcessArgs = (args = process.argv) => {
-    const skubaIdx = args.findIndex((chunk) => /skuba(\.[jt]s)?$/.test(chunk));
-    (0, assert_1.default)(skubaIdx >= 0, 'Cannot parse args for `skuba`');
-    const rawCommand = (args[skubaIdx + 1] ?? 'help').toLocaleLowerCase();
-    const commandName = command_1.COMMAND_ALIASES[rawCommand] ?? rawCommand;
-    const payload = {
-        commandName,
-        args: args.slice(skubaIdx + 2),
-    };
-    args.splice(skubaIdx + 1, 1);
-    return payload;
+  const skubaIdx = args.findIndex((chunk) => /skuba(\.[jt]s)?$/.test(chunk));
+  (0, import_assert.default)(skubaIdx >= 0, "Cannot parse args for `skuba`");
+  const rawCommand = (args[skubaIdx + 1] ?? "help").toLocaleLowerCase();
+  const commandName = import_command.COMMAND_ALIASES[rawCommand] ?? rawCommand;
+  const payload = {
+    commandName,
+    args: args.slice(skubaIdx + 2)
+  };
+  args.splice(skubaIdx + 1, 1);
+  return payload;
 };
-exports.parseProcessArgs = parseProcessArgs;
-/**
- * Make a best effort to parse "run" args.
- *
- * These are arguments that would be passed to `skuba node` or `skuba start`.
- * Parsing is handrolled because we support some weird and wonderful behaviour:
- *
- * - The `--port` option may be intended for skuba itself
- * - The `--inspect` options may be intended for the Node.js inspector
- * - The entry point may be omitted in favour of `package.json` inference
- * - Other args may be intended for propagation to the entry point
- */
 const parseRunArgs = (argv) => {
-    const state = {
-        node: [],
-        script: [],
-    };
-    let args = argv.filter((element) => element.length);
-    while (args.length) {
-        args = parseRunArgsIteration(state, args);
-    }
-    return state;
+  const state = {
+    node: [],
+    script: []
+  };
+  let args = argv.filter((element) => element.length);
+  while (args.length) {
+    args = parseRunArgsIteration(state, args);
+  }
+  return state;
 };
-exports.parseRunArgs = parseRunArgs;
-const isDigits = (arg) => typeof arg === 'string' && /^\d+$/.test(arg);
+const isDigits = (arg) => typeof arg === "string" && /^\d+$/.test(arg);
 const parseRunArgsIteration = (state, args) => {
-    const [arg1, arg2] = args;
-    if (!arg1) {
-        return [];
-    }
-    if (/^--inspect(-brk)?=\d+$/.test(arg1)) {
-        state.node.push(arg1);
-        return args.slice(1);
-    }
-    // Node.js inspector options that are optionally followed by a numeric port.
-    if (['--inspect', '--inspect-brk'].includes(arg1)) {
-        if (isDigits(arg2)) {
-            state.node.push(`${arg1}=${arg2}`);
-            return args.slice(2);
-        }
-        state.node.push(arg1);
-        if (arg2) {
-            // Some other string that doesn't relate to the Node.js inspector option.
-            // This is presumably the entry point script to run.
-            state.entryPoint = arg2;
-            state.script.push(...args.slice(2));
-        }
-        return [];
-    }
-    if (/^--port=\d+$/.test(arg1)) {
-        state.port = Number(arg1.slice(7));
-        return args.slice(1);
+  const [arg1, arg2] = args;
+  if (!arg1) {
+    return [];
+  }
+  if (/^--inspect(-brk)?=\d+$/.test(arg1)) {
+    state.node.push(arg1);
+    return args.slice(1);
+  }
+  if (["--inspect", "--inspect-brk"].includes(arg1)) {
+    if (isDigits(arg2)) {
+      state.node.push(`${arg1}=${arg2}`);
+      return args.slice(2);
     }
-    if (arg1 === '--port') {
-        if (isDigits(arg2)) {
-            state.port = Number(arg2);
-            return args.slice(2);
-        }
-        // Invalid port argument; eat it.
-        return args.slice(1);
+    state.node.push(arg1);
+    if (arg2) {
+      state.entryPoint = arg2;
+      state.script.push(...args.slice(2));
     }
-    state.entryPoint = arg1;
-    state.script.push(...args.slice(1));
     return [];
+  }
+  if (/^--port=\d+$/.test(arg1)) {
+    state.port = Number(arg1.slice(7));
+    return args.slice(1);
+  }
+  if (arg1 === "--port") {
+    if (isDigits(arg2)) {
+      state.port = Number(arg2);
+      return args.slice(2);
+    }
+    return args.slice(1);
+  }
+  state.entryPoint = arg1;
+  state.script.push(...args.slice(1));
+  return [];
 };
-//# sourceMappingURL=args.js.map
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hasDebugFlag,
+  hasSerialFlag,
+  parseProcessArgs,
+  parseRunArgs
+});
+//# sourceMappingURL=args.js.map

package/lib/utils/args.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/utils/args.ts"],"names":[],"mappings":"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"}
+{
+  "version": 3,
+  "sources": ["../../src/utils/args.ts"],
+  "sourcesContent": ["import assert from 'assert';\n\nimport { COMMAND_ALIASES } from './command';\n\nexport const hasDebugFlag = (args = process.argv) =>\n  args.some((arg) => arg.toLocaleLowerCase() === '--debug');\n\nexport const hasSerialFlag = (args = process.argv, env = process.env) =>\n  args.some((arg) => arg.toLocaleLowerCase() === '--serial') ||\n  Boolean(\n    // Run serially on SEEK's central npm publishing pipeline.\n    // Exhausting agents here can cause grief.\n    env.BUILDKITE_AGENT_META_DATA_QUEUE?.split(',').some((queueName) =>\n      queueName.startsWith('artefacts:npm'),\n    ),\n  );\n\n/**\n * Parse process arguments.\n *\n * This function mutates the input list by removing the command name element.\n * Downstream commands can access their args with an ordinary\n * `process.argv.slice(2)`.\n *\n * Example input:\n *\n * ```typescript\n * ['/bin/node', 'node_modules/.bin/skuba', 'test', '--foo', '--bar']\n * ```\n */\nexport const parseProcessArgs = (args = process.argv) => {\n  const skubaIdx = args.findIndex((chunk) => /skuba(\\.[jt]s)?$/.test(chunk));\n\n  assert(skubaIdx >= 0, 'Cannot parse args for `skuba`');\n\n  const rawCommand = (args[skubaIdx + 1] ?? 'help').toLocaleLowerCase();\n\n  const commandName = COMMAND_ALIASES[rawCommand] ?? rawCommand;\n\n  const payload = {\n    commandName,\n    args: args.slice(skubaIdx + 2),\n  };\n\n  args.splice(skubaIdx + 1, 1);\n\n  return payload;\n};\n\ninterface RunArgs {\n  /** The path to the entry point script. */\n  entryPoint?: string;\n\n  /** The port to start an HTTP server on. */\n  port?: number;\n\n  /** Arguments passed through to the Node.js executable. */\n  node: string[];\n\n  /** Arguments passed through to the entry point script. */\n  script: string[];\n}\n\n/**\n * Make a best effort to parse \"run\" args.\n *\n * These are arguments that would be passed to `skuba node` or `skuba start`.\n * Parsing is handrolled because we support some weird and wonderful behaviour:\n *\n * - The `--port` option may be intended for skuba itself\n * - The `--inspect` options may be intended for the Node.js inspector\n * - The entry point may be omitted in favour of `package.json` inference\n * - Other args may be intended for propagation to the entry point\n */\nexport const parseRunArgs = (argv: string[]): RunArgs => {\n  const state: RunArgs = {\n    node: [],\n    script: [],\n  };\n\n  let args = argv.filter((element) => element.length);\n\n  while (args.length) {\n    args = parseRunArgsIteration(state, args);\n  }\n\n  return state;\n};\n\nconst isDigits = (arg: unknown) => typeof arg === 'string' && /^\\d+$/.test(arg);\n\nconst parseRunArgsIteration = (state: RunArgs, args: string[]): string[] => {\n  const [arg1, arg2] = args;\n\n  if (!arg1) {\n    return [];\n  }\n\n  if (/^--inspect(-brk)?=\\d+$/.test(arg1)) {\n    state.node.push(arg1);\n    return args.slice(1);\n  }\n\n  // Node.js inspector options that are optionally followed by a numeric port.\n  if (['--inspect', '--inspect-brk'].includes(arg1)) {\n    if (isDigits(arg2)) {\n      state.node.push(`${arg1}=${arg2}`);\n      return args.slice(2);\n    }\n\n    state.node.push(arg1);\n\n    if (arg2) {\n      // Some other string that doesn't relate to the Node.js inspector option.\n      // This is presumably the entry point script to run.\n      state.entryPoint = arg2;\n      state.script.push(...args.slice(2));\n    }\n\n    return [];\n  }\n\n  if (/^--port=\\d+$/.test(arg1)) {\n    state.port = Number(arg1.slice(7));\n    return args.slice(1);\n  }\n\n  if (arg1 === '--port') {\n    if (isDigits(arg2)) {\n      state.port = Number(arg2);\n      return args.slice(2);\n    }\n\n    // Invalid port argument; eat it.\n    return args.slice(1);\n  }\n\n  state.entryPoint = arg1;\n  state.script.push(...args.slice(1));\n  return [];\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAmB;AAEnB,qBAAgC;AAEzB,MAAM,eAAe,CAAC,OAAO,QAAQ,SAC1C,KAAK,KAAK,CAAC,QAAQ,IAAI,kBAAkB,MAAM,SAAS;AAEnD,MAAM,gBAAgB,CAAC,OAAO,QAAQ,MAAM,MAAM,QAAQ,QAC/D,KAAK,KAAK,CAAC,QAAQ,IAAI,kBAAkB,MAAM,UAAU,KACzD;AAAA,EAGE,IAAI,iCAAiC,MAAM,GAAG,EAAE;AAAA,IAAK,CAAC,cACpD,UAAU,WAAW,eAAe;AAAA,EACtC;AACF;AAeK,MAAM,mBAAmB,CAAC,OAAO,QAAQ,SAAS;AACvD,QAAM,WAAW,KAAK,UAAU,CAAC,UAAU,mBAAmB,KAAK,KAAK,CAAC;AAEzE,oBAAAA,SAAO,YAAY,GAAG,+BAA+B;AAErD,QAAM,cAAc,KAAK,WAAW,MAAM,QAAQ,kBAAkB;AAEpE,QAAM,cAAc,+BAAgB,eAAe;AAEnD,QAAM,UAAU;AAAA,IACd;AAAA,IACA,MAAM,KAAK,MAAM,WAAW,CAAC;AAAA,EAC/B;AAEA,OAAK,OAAO,WAAW,GAAG,CAAC;AAE3B,SAAO;AACT;AA2BO,MAAM,eAAe,CAAC,SAA4B;AACvD,QAAM,QAAiB;AAAA,IACrB,MAAM,CAAC;AAAA,IACP,QAAQ,CAAC;AAAA,EACX;AAEA,MAAI,OAAO,KAAK,OAAO,CAAC,YAAY,QAAQ,MAAM;AAElD,SAAO,KAAK,QAAQ;AAClB,WAAO,sBAAsB,OAAO,IAAI;AAAA,EAC1C;AAEA,SAAO;AACT;AAEA,MAAM,WAAW,CAAC,QAAiB,OAAO,QAAQ,YAAY,QAAQ,KAAK,GAAG;AAE9E,MAAM,wBAAwB,CAAC,OAAgB,SAA6B;AAC1E,QAAM,CAAC,MAAM,IAAI,IAAI;AAErB,MAAI,CAAC,MAAM;AACT,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,yBAAyB,KAAK,IAAI,GAAG;AACvC,UAAM,KAAK,KAAK,IAAI;AACpB,WAAO,KAAK,MAAM,CAAC;AAAA,EACrB;AAGA,MAAI,CAAC,aAAa,eAAe,EAAE,SAAS,IAAI,GAAG;AACjD,QAAI,SAAS,IAAI,GAAG;AAClB,YAAM,KAAK,KAAK,GAAG,QAAQ,MAAM;AACjC,aAAO,KAAK,MAAM,CAAC;AAAA,IACrB;AAEA,UAAM,KAAK,KAAK,IAAI;AAEpB,QAAI,MAAM;AAGR,YAAM,aAAa;AACnB,YAAM,OAAO,KAAK,GAAG,KAAK,MAAM,CAAC,CAAC;AAAA,IACpC;AAEA,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,eAAe,KAAK,IAAI,GAAG;AAC7B,UAAM,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC;AACjC,WAAO,KAAK,MAAM,CAAC;AAAA,EACrB;AAEA,MAAI,SAAS,UAAU;AACrB,QAAI,SAAS,IAAI,GAAG;AAClB,YAAM,OAAO,OAAO,IAAI;AACxB,aAAO,KAAK,MAAM,CAAC;AAAA,IACrB;AAGA,WAAO,KAAK,MAAM,CAAC;AAAA,EACrB;AAEA,QAAM,aAAa;AACnB,QAAM,OAAO,KAAK,GAAG,KAAK,MAAM,CAAC,CAAC;AAClC,SAAO,CAAC;AACV;",
+  "names": ["assert"]
+}

package/lib/utils/command.js

@@ -1,37 +1,68 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.commandToModule = exports.COMMAND_SET = exports.COMMAND_LIST = exports.COMMAND_DIR = exports.COMMAND_ALIASES = void 0;
-const path_1 = __importDefault(require("path"));
-exports.COMMAND_ALIASES = {
-    '-h': 'help',
-    '--help': 'help',
-    '-v': 'version',
-    '--version': 'version',
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
-exports.COMMAND_DIR = path_1.default.join(__dirname, '..', 'cli');
-exports.COMMAND_LIST = [
-    'build',
-    'build-package',
-    'configure',
-    'format',
-    'help',
-    'init',
-    'lint',
-    'node',
-    'release',
-    'start',
-    'test',
-    'version',
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var command_exports = {};
+__export(command_exports, {
+  COMMAND_ALIASES: () => COMMAND_ALIASES,
+  COMMAND_DIR: () => COMMAND_DIR,
+  COMMAND_LIST: () => COMMAND_LIST,
+  COMMAND_SET: () => COMMAND_SET,
+  commandToModule: () => commandToModule
+});
+module.exports = __toCommonJS(command_exports);
+var import_path = __toESM(require("path"));
+const COMMAND_ALIASES = {
+  "-h": "help",
+  "--help": "help",
+  "-v": "version",
+  "--version": "version"
+};
+const COMMAND_DIR = import_path.default.join(__dirname, "..", "cli");
+const COMMAND_LIST = [
+  "build",
+  "build-package",
+  "configure",
+  "format",
+  "help",
+  "init",
+  "lint",
+  "node",
+  "release",
+  "start",
+  "test",
+  "version"
 ];
-exports.COMMAND_SET = new Set(exports.COMMAND_LIST);
-const commandToModule = (command) => command
-    .split('-')
-    .map((segment, index) => index === 0
-    ? segment
-    : `${segment[0].toLocaleUpperCase()}${segment.slice(1)}`)
-    .join('');
-exports.commandToModule = commandToModule;
-//# sourceMappingURL=command.js.map
+const COMMAND_SET = new Set(COMMAND_LIST);
+const commandToModule = (command) => command.split("-").map(
+  (segment, index) => index === 0 ? segment : `${segment[0].toLocaleUpperCase()}${segment.slice(1)}`
+).join("");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COMMAND_ALIASES,
+  COMMAND_DIR,
+  COMMAND_LIST,
+  COMMAND_SET,
+  commandToModule
+});
+//# sourceMappingURL=command.js.map

package/lib/utils/command.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/utils/command.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAIX,QAAA,eAAe,GAA4B;IACtD,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,SAAS;CACvB,CAAC;AAEW,QAAA,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEhD,QAAA,YAAY,GAAG;IAC1B,OAAO;IACP,eAAe;IACf,WAAW;IACX,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,MAAM;IACN,SAAS;CACD,CAAC;AAEE,QAAA,WAAW,GAAG,IAAI,GAAG,CAAS,oBAAY,CAAC,CAAC;AAElD,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAU,EAAE,CAC1D,OAAO;KACJ,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CACtB,KAAK,KAAK,CAAC;IACT,CAAC,CAAC,OAAO;IACT,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAC3D;KACA,IAAI,CAAC,EAAE,CAAC,CAAC;AARD,QAAA,eAAe,mBAQd"}
+{
+  "version": 3,
+  "sources": ["../../src/utils/command.ts"],
+  "sourcesContent": ["import path from 'path';\n\nexport type Command = typeof COMMAND_LIST[number];\n\nexport const COMMAND_ALIASES: Record<string, Command> = {\n  '-h': 'help',\n  '--help': 'help',\n  '-v': 'version',\n  '--version': 'version',\n};\n\nexport const COMMAND_DIR = path.join(__dirname, '..', 'cli');\n\nexport const COMMAND_LIST = [\n  'build',\n  'build-package',\n  'configure',\n  'format',\n  'help',\n  'init',\n  'lint',\n  'node',\n  'release',\n  'start',\n  'test',\n  'version',\n] as const;\n\nexport const COMMAND_SET = new Set<string>(COMMAND_LIST);\n\nexport const commandToModule = (command: Command): string =>\n  command\n    .split('-')\n    .map((segment, index) =>\n      index === 0\n        ? segment\n        : `${segment[0].toLocaleUpperCase()}${segment.slice(1)}`,\n    )\n    .join('');\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AAIV,MAAM,kBAA2C;AAAA,EACtD,MAAM;AAAA,EACN,UAAU;AAAA,EACV,MAAM;AAAA,EACN,aAAa;AACf;AAEO,MAAM,cAAc,YAAAA,QAAK,KAAK,WAAW,MAAM,KAAK;AAEpD,MAAM,eAAe;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,cAAc,IAAI,IAAY,YAAY;AAEhD,MAAM,kBAAkB,CAAC,YAC9B,QACG,MAAM,GAAG,EACT;AAAA,EAAI,CAAC,SAAS,UACb,UAAU,IACN,UACA,GAAG,QAAQ,GAAG,kBAAkB,IAAI,QAAQ,MAAM,CAAC;AACzD,EACC,KAAK,EAAE;",
+  "names": ["path"]
+}