skuba 0.0.0-beta-20231002015947

package/lib/cli/test/reporters/github/index.js

@@ -0,0 +1,75 @@
+"use strict";
+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;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var github_exports = {};
+__export(github_exports, {
+  default: () => GitHubReporter
+});
+module.exports = __toCommonJS(github_exports);
+var import_util = require("util");
+var GitHub = __toESM(require("../../../../api/github"));
+var import_environment = require("../../../../api/github/environment");
+var import_logging = require("../../../../utils/logging");
+var import_wait = require("../../../../utils/wait");
+var import_annotations = require("./annotations");
+class GitHubReporter {
+  async onRunComplete(_contexts, { testResults }) {
+    if (!(0, import_environment.enabledFromEnvironment)()) {
+      return;
+    }
+    let lastCheckRun;
+    try {
+      const entries = (0, import_annotations.generateAnnotationEntries)(testResults);
+      const build = (0, import_environment.buildNameFromEnvironment)();
+      for (const { displayName, annotations } of entries) {
+        const name = `skuba/test${displayName ? ` (${displayName})` : ""}`;
+        const isOk = !annotations.length;
+        const summary = isOk ? "`skuba test` passed." : "`skuba test` found issues that require triage.";
+        const checkRun = {
+          name,
+          annotations,
+          conclusion: isOk ? "success" : "failure",
+          summary,
+          title: `${build} ${isOk ? "passed" : "failed"}`
+        };
+        lastCheckRun = checkRun;
+        await (0, import_wait.throwOnTimeout)(GitHub.createCheckRun(checkRun), {
+          s: 30
+        });
+      }
+    } catch (err) {
+      import_logging.log.warn("Failed to report test results to GitHub.");
+      import_logging.log.subtle((0, import_util.inspect)(err));
+      if (lastCheckRun) {
+        import_logging.log.subtle("Last request:");
+        import_logging.log.subtle(JSON.stringify(lastCheckRun));
+      }
+    }
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/cli/test/reporters/github/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/test/reporters/github/index.ts"],
+  "sourcesContent": ["import { inspect } from 'util';\n\nimport type { Reporter, TestContext } from '@jest/reporters';\nimport type { AggregatedResult } from '@jest/test-result';\n\nimport * as GitHub from '../../../../api/github';\nimport {\n  buildNameFromEnvironment,\n  enabledFromEnvironment,\n} from '../../../../api/github/environment';\nimport { log } from '../../../../utils/logging';\nimport { throwOnTimeout } from '../../../../utils/wait';\n\nimport { generateAnnotationEntries } from './annotations';\n\nexport default class GitHubReporter implements Pick<Reporter, 'onRunComplete'> {\n  async onRunComplete(\n    _contexts: Set<TestContext>,\n    { testResults }: AggregatedResult,\n  ): Promise<void> {\n    if (!enabledFromEnvironment()) {\n      return;\n    }\n\n    type CheckRun = Parameters<typeof GitHub.createCheckRun>[0];\n\n    let lastCheckRun: CheckRun | undefined;\n\n    try {\n      const entries = generateAnnotationEntries(testResults);\n\n      const build = buildNameFromEnvironment();\n\n      // Create a check run per display name.\n      // Run in series to reduce the likelihood of exceeding GitHub rate limits.\n      for (const { displayName, annotations } of entries) {\n        const name = `skuba/test${displayName ? ` (${displayName})` : ''}`;\n\n        const isOk = !annotations.length;\n\n        const summary = isOk\n          ? '`skuba test` passed.'\n          : '`skuba test` found issues that require triage.';\n\n        const checkRun: CheckRun = {\n          name,\n          annotations,\n          conclusion: isOk ? 'success' : 'failure',\n          summary,\n          title: `${build} ${isOk ? 'passed' : 'failed'}`,\n        };\n\n        lastCheckRun = checkRun;\n\n        await throwOnTimeout(GitHub.createCheckRun(checkRun), {\n          s: 30,\n        });\n      }\n    } catch (err) {\n      log.warn('Failed to report test results to GitHub.');\n      log.subtle(inspect(err));\n\n      if (lastCheckRun) {\n        log.subtle('Last request:');\n        log.subtle(JSON.stringify(lastCheckRun));\n      }\n    }\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAwB;AAKxB,aAAwB;AACxB,yBAGO;AACP,qBAAoB;AACpB,kBAA+B;AAE/B,yBAA0C;AAE1C,MAAO,eAAwE;AAAA,EAC7E,MAAM,cACJ,WACA,EAAE,YAAY,GACC;AACf,QAAI,KAAC,2CAAuB,GAAG;AAC7B;AAAA,IACF;AAIA,QAAI;AAEJ,QAAI;AACF,YAAM,cAAU,8CAA0B,WAAW;AAErD,YAAM,YAAQ,6CAAyB;AAIvC,iBAAW,EAAE,aAAa,YAAY,KAAK,SAAS;AAClD,cAAM,OAAO,aAAa,cAAc,KAAK,WAAW,MAAM,EAAE;AAEhE,cAAM,OAAO,CAAC,YAAY;AAE1B,cAAM,UAAU,OACZ,yBACA;AAEJ,cAAM,WAAqB;AAAA,UACzB;AAAA,UACA;AAAA,UACA,YAAY,OAAO,YAAY;AAAA,UAC/B;AAAA,UACA,OAAO,GAAG,KAAK,IAAI,OAAO,WAAW,QAAQ;AAAA,QAC/C;AAEA,uBAAe;AAEf,kBAAM,4BAAe,OAAO,eAAe,QAAQ,GAAG;AAAA,UACpD,GAAG;AAAA,QACL,CAAC;AAAA,MACH;AAAA,IACF,SAAS,KAAK;AACZ,yBAAI,KAAK,0CAA0C;AACnD,yBAAI,WAAO,qBAAQ,GAAG,CAAC;AAEvB,UAAI,cAAc;AAChB,2BAAI,OAAO,eAAe;AAC1B,2BAAI,OAAO,KAAK,UAAU,YAAY,CAAC;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/lib/cli/test/reporters/prettier/index.d.ts

@@ -0,0 +1,4 @@
+import type { Reporter } from '@jest/reporters';
+export default class SnapshotPrettifier implements Pick<Reporter, 'onTestFileResult'> {
+    onTestFileResult(...[test, testResult]: Parameters<NonNullable<Reporter['onTestFileResult']>>): Promise<void>;
+}

package/lib/cli/test/reporters/prettier/index.js

@@ -0,0 +1,67 @@
+"use strict";
+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;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var prettier_exports = {};
+__export(prettier_exports, {
+  default: () => SnapshotPrettifier
+});
+module.exports = __toCommonJS(prettier_exports);
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_prettier = require("prettier");
+var import_prettier2 = require("../../../../cli/adapter/prettier");
+class SnapshotPrettifier {
+  async onTestFileResult(...[test, testResult]) {
+    if (!testResult.snapshot.added && !testResult.snapshot.updated) {
+      return;
+    }
+    const filepath = test.path;
+    try {
+      const [config, data] = await Promise.all([
+        (0, import_prettier.resolveConfig)(filepath),
+        import_fs_extra.default.promises.readFile(filepath, "utf-8")
+      ]);
+      const formatted = await (0, import_prettier2.formatOrLintFile)(
+        {
+          data,
+          filepath,
+          options: {
+            ...config,
+            filepath
+          }
+        },
+        "format",
+        null
+      );
+      if (typeof formatted === "string") {
+        await import_fs_extra.default.promises.writeFile(filepath, formatted);
+      }
+    } catch {
+    }
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/cli/test/reporters/prettier/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/test/reporters/prettier/index.ts"],
+  "sourcesContent": ["import type { Reporter } from '@jest/reporters';\nimport fs from 'fs-extra';\nimport { resolveConfig } from 'prettier';\n\nimport { formatOrLintFile } from '../../../../cli/adapter/prettier';\n\nexport default class SnapshotPrettifier\n  implements Pick<Reporter, 'onTestFileResult'>\n{\n  async onTestFileResult(\n    ...[test, testResult]: Parameters<NonNullable<Reporter['onTestFileResult']>>\n  ): Promise<void> {\n    if (!testResult.snapshot.added && !testResult.snapshot.updated) {\n      return;\n    }\n\n    const filepath = test.path;\n\n    // This is a best-effort workaround to automatically format code.\n    // Don't pollute console output if it fails for whatever reason.\n    try {\n      const [config, data] = await Promise.all([\n        resolveConfig(filepath),\n        fs.promises.readFile(filepath, 'utf-8'),\n      ]);\n\n      const formatted = await formatOrLintFile(\n        {\n          data,\n          filepath,\n          options: {\n            ...config,\n            filepath,\n          },\n        },\n        'format',\n        null,\n      );\n\n      if (typeof formatted === 'string') {\n        await fs.promises.writeFile(filepath, formatted);\n      }\n    } catch {}\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,sBAAe;AACf,sBAA8B;AAE9B,IAAAA,mBAAiC;AAEjC,MAAO,mBAEP;AAAA,EACE,MAAM,oBACD,CAAC,MAAM,UAAU,GACL;AACf,QAAI,CAAC,WAAW,SAAS,SAAS,CAAC,WAAW,SAAS,SAAS;AAC9D;AAAA,IACF;AAEA,UAAM,WAAW,KAAK;AAItB,QAAI;AACF,YAAM,CAAC,QAAQ,IAAI,IAAI,MAAM,QAAQ,IAAI;AAAA,YACvC,+BAAc,QAAQ;AAAA,QACtB,gBAAAC,QAAG,SAAS,SAAS,UAAU,OAAO;AAAA,MACxC,CAAC;AAED,YAAM,YAAY,UAAM;AAAA,QACtB;AAAA,UACE;AAAA,UACA;AAAA,UACA,SAAS;AAAA,YACP,GAAG;AAAA,YACH;AAAA,UACF;AAAA,QACF;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAEA,UAAI,OAAO,cAAc,UAAU;AACjC,cAAM,gBAAAA,QAAG,SAAS,UAAU,UAAU,SAAS;AAAA,MACjD;AAAA,IACF,QAAQ;AAAA,IAAC;AAAA,EACX;AACF;",
+  "names": ["import_prettier", "fs"]
+}

package/lib/cli/version.d.ts

@@ -0,0 +1 @@
+export declare const version: () => Promise<void>;

package/lib/cli/version.js

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var version_exports = {};
+__export(version_exports, {
+  version: () => version
+});
+module.exports = __toCommonJS(version_exports);
+var import_logging = require("../utils/logging");
+var import_version = require("../utils/version");
+const version = async () => {
+  const skubaVersion = await (0, import_version.getSkubaVersion)();
+  import_logging.log.plain(skubaVersion);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  version
+});
+//# sourceMappingURL=version.js.map

package/lib/cli/version.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cli/version.ts"],
+  "sourcesContent": ["import { log } from '../utils/logging';\nimport { getSkubaVersion } from '../utils/version';\n\nexport const version = async () => {\n  const skubaVersion = await getSkubaVersion();\n\n  log.plain(skubaVersion);\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAoB;AACpB,qBAAgC;AAEzB,MAAM,UAAU,YAAY;AACjC,QAAM,eAAe,UAAM,gCAAgB;AAE3C,qBAAI,MAAM,YAAY;AACxB;",
+  "names": []
+}

package/lib/enquirer.d.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=enquirer.d.js.map

package/lib/enquirer.d.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/lib/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Entry point for the Node.js development API.
+ *
+ * This is where skuba imports point to:
+ *
+ * ```typescript
+ * import { Net } from 'skuba';
+ *
+ * const { Net } = require('skuba');
+ * ```
+ */
+export * as Buildkite from './api/buildkite';
+export * as Git from './api/git';
+export * as GitHub from './api/github';
+export * as Jest from './api/jest';
+export * as Net from './api/net';
+declare global {
+    namespace WebAssembly {
+        interface Module {
+        }
+    }
+}

package/lib/index.js

@@ -0,0 +1,51 @@
+"use strict";
+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;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  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

@@ -0,0 +1,7 @@
+{
+  "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    // eslint-disable-next-line @typescript-eslint/no-empty-interface\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.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the CLI.
+ *
+ * This is where you end up when you run:
+ *
+ * ```bash
+ * [yarn] skuba help
+ * ```
+ */
+export {};

package/lib/skuba.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+"use strict";
+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;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  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, 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;
+    }
+    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;
+  return;
+};
+skuba().catch(import_error.handleCliError);
+//# sourceMappingURL=skuba.js.map

package/lib/skuba.js.map

@@ -0,0 +1,7 @@
+{
+  "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 {\n  COMMAND_DIR,\n  COMMAND_SET,\n  type Command,\n  commandToModule,\n} 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 as Command);\n\n    /* eslint-disable @typescript-eslint/no-var-requires */\n    const commandModule = require(\n      path.join(COMMAND_DIR, 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  return;\n};\n\nskuba().catch(handleCliError);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAYA,kBAAiB;AAEjB,kBAAiC;AACjC,qBAKO;AACP,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,WAAsB;AAGzD,UAAM,gBAAgB,QACpB,YAAAA,QAAK,KAAK,4BAAa,UAAU,CACnC;AAEA,QAAI,KAAC,2BAAQ,eAAe,UAAU,GAAG;AACvC,yBAAI,IAAI,mBAAI,KAAK,WAAW,GAAG,uCAAuC;AACtE,cAAQ,WAAW;AACnB;AAAA,IACF;AAEA,UAAM,MAAM,cAAc,UAAU;AAEpC,WAAO,IAAI;AAAA,EACb;AAEA,qBAAI,IAAI,mBAAI,KAAK,WAAW,GAAG,iCAAiC;AAChE,YAAM,oCAAuB;AAC7B,4BAAS;AAET,UAAQ,WAAW;AACnB;AACF;AAEA,MAAM,EAAE,MAAM,2BAAc;",
+  "names": ["path"]
+}

package/lib/utils/args.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="node" />
+export declare const hasDebugFlag: (args?: string[]) => boolean;
+export declare const hasSerialFlag: (args?: string[], env?: NodeJS.ProcessEnv) => boolean;
+/**
+ * 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']
+ * ```
+ */
+export declare const parseProcessArgs: (args?: string[]) => {
+    commandName: string;
+    args: string[];
+};
+interface RunArgs {
+    /** The path to the entry point script. */
+    entryPoint?: string;
+    /** The port to start an HTTP server on. */
+    port?: number;
+    /** Arguments passed through to the Node.js executable. */
+    node: string[];
+    /** Arguments passed through to the entry point script. */
+    script: string[];
+}
+/**
+ * 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
+ */
+export declare const parseRunArgs: (argv: string[]) => RunArgs;
+export {};

package/lib/utils/args.js

@@ -0,0 +1,114 @@
+"use strict";
+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;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  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(
+  // 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")
+  )
+);
+const parseProcessArgs = (args = process.argv) => {
+  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;
+};
+const parseRunArgs = (argv) => {
+  const state = {
+    node: [],
+    script: []
+  };
+  let args = argv.filter((element) => element.length);
+  while (args.length) {
+    args = parseRunArgsIteration(state, args);
+  }
+  return state;
+};
+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);
+  }
+  if (["--inspect", "--inspect-brk"].includes(arg1)) {
+    if (isDigits(arg2)) {
+      state.node.push(`${arg1}=${arg2}`);
+      return args.slice(2);
+    }
+    state.node.push(arg1);
+    if (arg2) {
+      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);
+  }
+  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 [];
+};
+// 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

@@ -0,0 +1,7 @@
+{
+  "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): arg is string =>\n  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;AAAA;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,CAAC,KAAK,QAAQ,kBAAkB;AAEpE,QAAM,cAAc,+BAAgB,UAAU,KAAK;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,QAChB,OAAO,QAAQ,YAAY,QAAQ,KAAK,GAAG;AAE7C,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,IAAI,IAAI,IAAI,EAAE;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.d.ts

@@ -0,0 +1,6 @@
+export type Command = (typeof COMMAND_LIST)[number];
+export declare const COMMAND_ALIASES: Record<string, Command>;
+export declare const COMMAND_DIR: string;
+export declare const COMMAND_LIST: readonly ["build", "build-package", "configure", "format", "help", "init", "lint", "node", "release", "start", "test", "version"];
+export declare const COMMAND_SET: Set<string>;
+export declare const commandToModule: (command: Command) => string;

package/lib/utils/command.js

@@ -0,0 +1,72 @@
+"use strict";
+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;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  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"
+];
+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