skuba 0.0.0-beta-20231002015947

package/lib/utils/validation.js

@@ -0,0 +1,44 @@
+"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 validation_exports = {};
+__export(validation_exports, {
+  hasNumberProp: () => hasNumberProp,
+  hasProp: () => hasProp,
+  hasStringProp: () => hasStringProp,
+  isFunction: () => isFunction,
+  isIpPort: () => isIpPort,
+  isObject: () => isObject
+});
+module.exports = __toCommonJS(validation_exports);
+const isFunction = (data) => typeof data === "function";
+const isIpPort = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= 65535;
+const isObject = (value) => typeof value === "object" && value !== null;
+const hasProp = (value, prop) => isObject(value) && value.hasOwnProperty(prop);
+const hasNumberProp = (value, prop) => isObject(value) && typeof value[prop] === "number";
+const hasStringProp = (value, prop) => isObject(value) && typeof value[prop] === "string";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hasNumberProp,
+  hasProp,
+  hasStringProp,
+  isFunction,
+  isIpPort,
+  isObject
+});
+//# sourceMappingURL=validation.js.map

package/lib/utils/validation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/validation.ts"],
+  "sourcesContent": ["export const isFunction = (\n  data: unknown,\n): data is (...args: unknown[]) => Promise<unknown> =>\n  typeof data === 'function';\n\nexport const isIpPort = (value: unknown): value is number =>\n  typeof value === 'number' &&\n  Number.isSafeInteger(value) &&\n  value >= 0 &&\n  value <= 65535;\n\nexport const isObject = (\n  value: unknown,\n): value is Record<PropertyKey, unknown> =>\n  typeof value === 'object' && value !== null;\n\nexport const hasProp = <P extends PropertyKey, V = unknown>(\n  value: unknown,\n  prop: P,\n): value is Record<P, V> => isObject(value) && value.hasOwnProperty(prop);\n\nexport const hasNumberProp = <P extends PropertyKey>(\n  value: unknown,\n  prop: P,\n): value is Record<P, number> =>\n  isObject(value) && typeof value[prop] === 'number';\n\nexport const hasStringProp = <P extends PropertyKey>(\n  value: unknown,\n  prop: P,\n): value is Record<P, string> =>\n  isObject(value) && typeof value[prop] === 'string';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,aAAa,CACxB,SAEA,OAAO,SAAS;AAEX,MAAM,WAAW,CAAC,UACvB,OAAO,UAAU,YACjB,OAAO,cAAc,KAAK,KAC1B,SAAS,KACT,SAAS;AAEJ,MAAM,WAAW,CACtB,UAEA,OAAO,UAAU,YAAY,UAAU;AAElC,MAAM,UAAU,CACrB,OACA,SAC0B,SAAS,KAAK,KAAK,MAAM,eAAe,IAAI;AAEjE,MAAM,gBAAgB,CAC3B,OACA,SAEA,SAAS,KAAK,KAAK,OAAO,MAAM,IAAI,MAAM;AAErC,MAAM,gBAAgB,CAC3B,OACA,SAEA,SAAS,KAAK,KAAK,OAAO,MAAM,IAAI,MAAM;",
+  "names": []
+}

package/lib/utils/version.d.ts

@@ -0,0 +1,13 @@
+export declare const latestNpmVersion: (packageName: string) => Promise<string>;
+export declare const getSkubaVersion: () => Promise<string>;
+type SkubaVersionInfo = {
+    isStale: true;
+    local: string;
+    latest: string;
+} | {
+    isStale: false;
+    local: string;
+    latest: string | null;
+};
+export declare const getSkubaVersionInfo: () => Promise<SkubaVersionInfo>;
+export {};

package/lib/utils/version.js

@@ -0,0 +1,89 @@
+"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 version_exports = {};
+__export(version_exports, {
+  getSkubaVersion: () => getSkubaVersion,
+  getSkubaVersionInfo: () => getSkubaVersionInfo,
+  latestNpmVersion: () => latestNpmVersion
+});
+module.exports = __toCommonJS(version_exports);
+var import_libnpmsearch = __toESM(require("libnpmsearch"));
+var import_validate_npm_package_name = __toESM(require("validate-npm-package-name"));
+var import_manifest = require("./manifest");
+var import_wait = require("./wait");
+const latestNpmVersion = async (packageName) => {
+  const { validForNewPackages } = (0, import_validate_npm_package_name.default)(packageName);
+  if (!validForNewPackages) {
+    throw new Error(`Package "${packageName}" does not have a valid name`);
+  }
+  const [result] = await (0, import_libnpmsearch.default)(packageName, { limit: 1, timeout: 5e3 });
+  if (result?.name !== packageName) {
+    throw new Error(
+      `Package "${packageName}" does not exist on the npm registry`
+    );
+  }
+  return result.version;
+};
+const latestSkubaVersion = async () => {
+  try {
+    const result = await (0, import_wait.withTimeout)(latestNpmVersion("skuba"), { s: 2 });
+    return result.ok ? result.value : null;
+  } catch {
+    return null;
+  }
+};
+const getSkubaVersion = async () => {
+  const { version } = await (0, import_manifest.getSkubaManifest)();
+  return version;
+};
+const getSkubaVersionInfo = async () => {
+  const [local, latest] = await Promise.all([
+    getSkubaVersion(),
+    latestSkubaVersion()
+  ]);
+  if (latest === null) {
+    return {
+      isStale: false,
+      local,
+      latest
+    };
+  }
+  return {
+    isStale: latest !== local,
+    local,
+    latest
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getSkubaVersion,
+  getSkubaVersionInfo,
+  latestNpmVersion
+});
+//# sourceMappingURL=version.js.map

package/lib/utils/version.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/version.ts"],
+  "sourcesContent": ["import searchNpm from 'libnpmsearch';\nimport validatePackageName from 'validate-npm-package-name';\n\nimport { getSkubaManifest } from './manifest';\nimport { withTimeout } from './wait';\n\nexport const latestNpmVersion = async (\n  packageName: string,\n): Promise<string> => {\n  const { validForNewPackages } = validatePackageName(packageName);\n\n  if (!validForNewPackages) {\n    throw new Error(`Package \"${packageName}\" does not have a valid name`);\n  }\n\n  const [result] = await searchNpm(packageName, { limit: 1, timeout: 5_000 });\n\n  if (result?.name !== packageName) {\n    throw new Error(\n      `Package \"${packageName}\" does not exist on the npm registry`,\n    );\n  }\n\n  return result.version;\n};\n\nconst latestSkubaVersion = async (): Promise<string | null> => {\n  try {\n    const result = await withTimeout(latestNpmVersion('skuba'), { s: 2 });\n\n    return result.ok ? result.value : null;\n  } catch {\n    return null;\n  }\n};\n\nexport const getSkubaVersion = async (): Promise<string> => {\n  const { version } = await getSkubaManifest();\n\n  return version;\n};\n\ntype SkubaVersionInfo =\n  | {\n      isStale: true;\n\n      local: string;\n      latest: string;\n    }\n  | {\n      isStale: false;\n\n      local: string;\n      latest: string | null;\n    };\n\nexport const getSkubaVersionInfo = async (): Promise<SkubaVersionInfo> => {\n  const [local, latest] = await Promise.all([\n    getSkubaVersion(),\n    latestSkubaVersion(),\n  ]);\n\n  if (latest === null) {\n    // Assume we're up to date if we can't reach the npm registry\n    return {\n      isStale: false,\n      local,\n      latest,\n    };\n  }\n\n  return {\n    isStale: latest !== local,\n    local,\n    latest,\n  };\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAsB;AACtB,uCAAgC;AAEhC,sBAAiC;AACjC,kBAA4B;AAErB,MAAM,mBAAmB,OAC9B,gBACoB;AACpB,QAAM,EAAE,oBAAoB,QAAI,iCAAAA,SAAoB,WAAW;AAE/D,MAAI,CAAC,qBAAqB;AACxB,UAAM,IAAI,MAAM,YAAY,WAAW,8BAA8B;AAAA,EACvE;AAEA,QAAM,CAAC,MAAM,IAAI,UAAM,oBAAAC,SAAU,aAAa,EAAE,OAAO,GAAG,SAAS,IAAM,CAAC;AAE1E,MAAI,QAAQ,SAAS,aAAa;AAChC,UAAM,IAAI;AAAA,MACR,YAAY,WAAW;AAAA,IACzB;AAAA,EACF;AAEA,SAAO,OAAO;AAChB;AAEA,MAAM,qBAAqB,YAAoC;AAC7D,MAAI;AACF,UAAM,SAAS,UAAM,yBAAY,iBAAiB,OAAO,GAAG,EAAE,GAAG,EAAE,CAAC;AAEpE,WAAO,OAAO,KAAK,OAAO,QAAQ;AAAA,EACpC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,MAAM,kBAAkB,YAA6B;AAC1D,QAAM,EAAE,QAAQ,IAAI,UAAM,kCAAiB;AAE3C,SAAO;AACT;AAgBO,MAAM,sBAAsB,YAAuC;AACxE,QAAM,CAAC,OAAO,MAAM,IAAI,MAAM,QAAQ,IAAI;AAAA,IACxC,gBAAgB;AAAA,IAChB,mBAAmB;AAAA,EACrB,CAAC;AAED,MAAI,WAAW,MAAM;AAEnB,WAAO;AAAA,MACL,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,SAAS,WAAW;AAAA,IACpB;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": ["validatePackageName", "searchNpm"]
+}

package/lib/utils/wait.d.ts

@@ -0,0 +1,17 @@
+interface Timeout extends PromiseLike<void> {
+    clear?: () => void;
+}
+export declare const sleep: (ms: number) => Timeout;
+export declare const throwOnTimeout: <T>(promise: PromiseLike<T>, { s }: {
+    s: number;
+}) => Promise<T>;
+type TimeoutResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+};
+export declare const withTimeout: <T>(promise: T | PromiseLike<T>, { s }: {
+    s: number;
+}) => Promise<TimeoutResult<T>>;
+export {};

package/lib/utils/wait.js

@@ -0,0 +1,59 @@
+"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 wait_exports = {};
+__export(wait_exports, {
+  sleep: () => sleep,
+  throwOnTimeout: () => throwOnTimeout,
+  withTimeout: () => withTimeout
+});
+module.exports = __toCommonJS(wait_exports);
+var import_error = require("./error");
+var import_logging = require("./logging");
+const sleep = (ms) => {
+  let timeout;
+  return Object.assign(
+    new Promise((resolve) => timeout = setTimeout(resolve, ms)),
+    { clear: () => clearTimeout(timeout) }
+  );
+};
+const throwOnTimeout = async (promise, { s }) => {
+  const result = await withTimeout(promise, { s });
+  if (!result.ok) {
+    throw (0, import_error.createTerseError)(`Timed out after ${(0, import_logging.pluralise)(s, "second")}`);
+  }
+  return result.value;
+};
+const withTimeout = async (promise, { s }) => {
+  const timeout = sleep(s * 1e3);
+  try {
+    return await Promise.race([
+      Promise.resolve(promise).then((value) => ({ ok: true, value })),
+      timeout.then(() => ({ ok: false }))
+    ]);
+  } finally {
+    timeout.clear?.();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sleep,
+  throwOnTimeout,
+  withTimeout
+});
+//# sourceMappingURL=wait.js.map

package/lib/utils/wait.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/wait.ts"],
+  "sourcesContent": ["import { createTerseError } from './error';\nimport { pluralise } from './logging';\n\ninterface Timeout extends PromiseLike<void> {\n  clear?: () => void;\n}\n\nexport const sleep = (ms: number): Timeout => {\n  let timeout: NodeJS.Timeout;\n\n  return Object.assign(\n    new Promise<void>((resolve) => (timeout = setTimeout(resolve, ms))),\n    { clear: () => clearTimeout(timeout) },\n  );\n};\n\nexport const throwOnTimeout = async <T>(\n  promise: PromiseLike<T>,\n  { s }: { s: number },\n): Promise<T> => {\n  const result = await withTimeout(promise, { s });\n\n  if (!result.ok) {\n    throw createTerseError(`Timed out after ${pluralise(s, 'second')}`);\n  }\n\n  return result.value;\n};\n\ntype TimeoutResult<T> = { ok: true; value: T } | { ok: false };\n\nexport const withTimeout = async <T>(\n  promise: T | PromiseLike<T>,\n  { s }: { s: number },\n): Promise<TimeoutResult<T>> => {\n  const timeout = sleep(s * 1_000);\n\n  try {\n    return await Promise.race<TimeoutResult<T>>([\n      Promise.resolve(promise).then((value) => ({ ok: true, value })),\n      timeout.then(() => ({ ok: false })),\n    ]);\n  } finally {\n    timeout.clear?.();\n  }\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiC;AACjC,qBAA0B;AAMnB,MAAM,QAAQ,CAAC,OAAwB;AAC5C,MAAI;AAEJ,SAAO,OAAO;AAAA,IACZ,IAAI,QAAc,CAAC,YAAa,UAAU,WAAW,SAAS,EAAE,CAAE;AAAA,IAClE,EAAE,OAAO,MAAM,aAAa,OAAO,EAAE;AAAA,EACvC;AACF;AAEO,MAAM,iBAAiB,OAC5B,SACA,EAAE,EAAE,MACW;AACf,QAAM,SAAS,MAAM,YAAY,SAAS,EAAE,EAAE,CAAC;AAE/C,MAAI,CAAC,OAAO,IAAI;AACd,cAAM,+BAAiB,uBAAmB,0BAAU,GAAG,QAAQ,CAAC,EAAE;AAAA,EACpE;AAEA,SAAO,OAAO;AAChB;AAIO,MAAM,cAAc,OACzB,SACA,EAAE,EAAE,MAC0B;AAC9B,QAAM,UAAU,MAAM,IAAI,GAAK;AAE/B,MAAI;AACF,WAAO,MAAM,QAAQ,KAAuB;AAAA,MAC1C,QAAQ,QAAQ,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,MAAM,MAAM,EAAE;AAAA,MAC9D,QAAQ,KAAK,OAAO,EAAE,IAAI,MAAM,EAAE;AAAA,IACpC,CAAC;AAAA,EACH,UAAE;AACA,YAAQ,QAAQ;AAAA,EAClB;AACF;",
+  "names": []
+}

package/lib/utils/worker.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Executes a script at `filepath` in a Node.js worker thread.
+ */
+export declare const execWorkerThread: <Input, Output>(filepath: string, input: Input) => Promise<Output>;
+/**
+ * Runs a function in a Node.js worker thread context, forwarding the result
+ * to the parent thread.
+ */
+export declare const postWorkerOutput: <Input, Output>(fn: (input: Input) => Promise<Output>, logger?: {
+    bold: import("chalk").Chalk;
+    formatSubtle: import("chalk").Chalk;
+    timing: (start: bigint, end: bigint) => string;
+    debug: (...message: unknown[]) => void;
+    subtle: (...message: unknown[]) => void;
+    err: (...message: unknown[]) => void;
+    newline: () => void;
+    ok: (...message: unknown[]) => void;
+    plain: (...message: unknown[]) => void;
+    warn: (...message: unknown[]) => void;
+}) => void;

package/lib/utils/worker.js

@@ -0,0 +1,63 @@
+"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 worker_exports = {};
+__export(worker_exports, {
+  execWorkerThread: () => execWorkerThread,
+  postWorkerOutput: () => postWorkerOutput
+});
+module.exports = __toCommonJS(worker_exports);
+var import_util = require("util");
+var import_worker_threads = require("worker_threads");
+var import_logging = require("./logging");
+const execWorkerThread = async (filepath, input) => {
+  let output;
+  let messageReceived = false;
+  return new Promise(
+    (resolve, reject) => new import_worker_threads.Worker(filepath, {
+      workerData: input
+    }).on("error", reject).on(
+      "exit",
+      (code) => messageReceived ? resolve(output) : reject(
+        new Error(
+          code ? `Worker thread failed with exit code ${code}` : "Worker thread exited without posting a message"
+        )
+      )
+    ).on("message", (message) => {
+      output = message;
+      messageReceived = true;
+    }).on("messageerror", (err) => reject(err))
+  );
+};
+const postWorkerOutput = (fn, logger = import_logging.log) => {
+  const port = import_worker_threads.parentPort;
+  if (!port) {
+    logger.err("`postWorkerOutput` called outside of a worker thread context");
+    process.exit(1);
+  }
+  fn(import_worker_threads.workerData).then((output) => port.postMessage(output)).catch((err) => {
+    logger.err((0, import_util.inspect)(err));
+    process.exit(1);
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  execWorkerThread,
+  postWorkerOutput
+});
+//# sourceMappingURL=worker.js.map

package/lib/utils/worker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/worker.ts"],
+  "sourcesContent": ["import { inspect } from 'util';\nimport { Worker, parentPort, workerData } from 'worker_threads';\n\nimport { log } from './logging';\n\n/**\n * Executes a script at `filepath` in a Node.js worker thread.\n */\nexport const execWorkerThread = async <Input, Output>(\n  filepath: string,\n  input: Input,\n) => {\n  let output: Output;\n  let messageReceived = false;\n\n  return new Promise<Output>((resolve, reject) =>\n    new Worker(filepath, {\n      workerData: input,\n    })\n      .on('error', reject)\n      .on('exit', (code) =>\n        messageReceived\n          ? resolve(output)\n          : reject(\n              new Error(\n                code\n                  ? `Worker thread failed with exit code ${code}`\n                  : 'Worker thread exited without posting a message',\n              ),\n            ),\n      )\n      .on('message', (message: Output) => {\n        // Defer promise resolution to `exit` so stdio can settle.\n        output = message;\n        messageReceived = true;\n      })\n      .on('messageerror', (err) => reject(err)),\n  );\n};\n\n/**\n * Runs a function in a Node.js worker thread context, forwarding the result\n * to the parent thread.\n */\nexport const postWorkerOutput = <Input, Output>(\n  fn: (input: Input) => Promise<Output>,\n  logger = log,\n) => {\n  const port = parentPort;\n\n  if (!port) {\n    logger.err('`postWorkerOutput` called outside of a worker thread context');\n\n    process.exit(1);\n  }\n\n  fn(workerData as Input)\n    .then((output) => port.postMessage(output))\n    .catch((err) => {\n      logger.err(inspect(err));\n\n      process.exit(1);\n    });\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAwB;AACxB,4BAA+C;AAE/C,qBAAoB;AAKb,MAAM,mBAAmB,OAC9B,UACA,UACG;AACH,MAAI;AACJ,MAAI,kBAAkB;AAEtB,SAAO,IAAI;AAAA,IAAgB,CAAC,SAAS,WACnC,IAAI,6BAAO,UAAU;AAAA,MACnB,YAAY;AAAA,IACd,CAAC,EACE,GAAG,SAAS,MAAM,EAClB;AAAA,MAAG;AAAA,MAAQ,CAAC,SACX,kBACI,QAAQ,MAAM,IACd;AAAA,QACE,IAAI;AAAA,UACF,OACI,uCAAuC,IAAI,KAC3C;AAAA,QACN;AAAA,MACF;AAAA,IACN,EACC,GAAG,WAAW,CAAC,YAAoB;AAElC,eAAS;AACT,wBAAkB;AAAA,IACpB,CAAC,EACA,GAAG,gBAAgB,CAAC,QAAQ,OAAO,GAAG,CAAC;AAAA,EAC5C;AACF;AAMO,MAAM,mBAAmB,CAC9B,IACA,SAAS,uBACN;AACH,QAAM,OAAO;AAEb,MAAI,CAAC,MAAM;AACT,WAAO,IAAI,8DAA8D;AAEzE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,KAAG,gCAAmB,EACnB,KAAK,CAAC,WAAW,KAAK,YAAY,MAAM,CAAC,EACzC,MAAM,CAAC,QAAQ;AACd,WAAO,QAAI,qBAAQ,GAAG,CAAC;AAEvB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AACL;",
+  "names": []
+}

package/lib/wrapper/function-arguments.d.js

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

package/lib/wrapper/function-arguments.d.js.map

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

package/lib/wrapper/functionHandler.d.ts

@@ -0,0 +1,10 @@
+interface Args {
+    availablePort?: number;
+    entryPoint: unknown;
+    functionName: string;
+}
+/**
+ * Create an HTTP server that calls into an exported function.
+ */
+export declare const runFunctionHandler: ({ availablePort, entryPoint, functionName, }: Args) => Promise<void>;
+export {};

package/lib/wrapper/functionHandler.js

@@ -0,0 +1,63 @@
+"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 functionHandler_exports = {};
+__export(functionHandler_exports, {
+  runFunctionHandler: () => runFunctionHandler
+});
+module.exports = __toCommonJS(functionHandler_exports);
+var import_function_arguments = __toESM(require("function-arguments"));
+var import_logging = require("../utils/logging");
+var import_validation = require("../utils/validation");
+var import_http = require("./http");
+const runFunctionHandler = async ({
+  availablePort,
+  entryPoint,
+  functionName
+}) => {
+  if (!(0, import_validation.isObject)(entryPoint)) {
+    import_logging.log.subtle(import_logging.log.bold(functionName), "is not exported");
+    return;
+  }
+  const fn = entryPoint[functionName];
+  if (!(0, import_validation.isFunction)(fn)) {
+    import_logging.log.subtle(import_logging.log.bold(functionName), "is not a function");
+    return;
+  }
+  import_logging.log.warn(
+    import_logging.log.bold(functionName),
+    `(${(0, import_function_arguments.default)(fn).map((arg) => arg || "?").join(", ")})`
+  );
+  const requestListener = (0, import_http.createRequestListenerFromFunction)(fn);
+  return (0, import_http.serveRequestListener)(requestListener, availablePort);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  runFunctionHandler
+});
+//# sourceMappingURL=functionHandler.js.map

package/lib/wrapper/functionHandler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wrapper/functionHandler.ts"],
+  "sourcesContent": ["import fnArgs from 'function-arguments';\n\nimport { log } from '../utils/logging';\nimport { isFunction, isObject } from '../utils/validation';\n\nimport {\n  createRequestListenerFromFunction,\n  serveRequestListener,\n} from './http';\n\ninterface Args {\n  availablePort?: number;\n  entryPoint: unknown;\n  functionName: string;\n}\n\n/**\n * Create an HTTP server that calls into an exported function.\n */\nexport const runFunctionHandler = async ({\n  availablePort,\n  entryPoint,\n  functionName,\n}: Args): Promise<void> => {\n  if (!isObject(entryPoint)) {\n    log.subtle(log.bold(functionName), 'is not exported');\n    return;\n  }\n\n  const fn = entryPoint[functionName];\n\n  if (!isFunction(fn)) {\n    log.subtle(log.bold(functionName), 'is not a function');\n    return;\n  }\n\n  log.warn(\n    log.bold(functionName),\n    `(${fnArgs(fn)\n      // Add a `?` placeholder for unnamed arguments.\n      .map((arg) => arg || '?')\n      .join(', ')})`,\n  );\n\n  const requestListener = createRequestListenerFromFunction(fn);\n\n  return serveRequestListener(requestListener, availablePort);\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gCAAmB;AAEnB,qBAAoB;AACpB,wBAAqC;AAErC,kBAGO;AAWA,MAAM,qBAAqB,OAAO;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACF,MAA2B;AACzB,MAAI,KAAC,4BAAS,UAAU,GAAG;AACzB,uBAAI,OAAO,mBAAI,KAAK,YAAY,GAAG,iBAAiB;AACpD;AAAA,EACF;AAEA,QAAM,KAAK,WAAW,YAAY;AAElC,MAAI,KAAC,8BAAW,EAAE,GAAG;AACnB,uBAAI,OAAO,mBAAI,KAAK,YAAY,GAAG,mBAAmB;AACtD;AAAA,EACF;AAEA,qBAAI;AAAA,IACF,mBAAI,KAAK,YAAY;AAAA,IACrB,QAAI,0BAAAA,SAAO,EAAE,EAEV,IAAI,CAAC,QAAQ,OAAO,GAAG,EACvB,KAAK,IAAI,CAAC;AAAA,EACf;AAEA,QAAM,sBAAkB,+CAAkC,EAAE;AAE5D,aAAO,kCAAqB,iBAAiB,aAAa;AAC5D;",
+  "names": ["fnArgs"]
+}

package/lib/wrapper/http.d.ts

@@ -0,0 +1,20 @@
+import http from 'http';
+/**
+ * Create an HTTP request listener based on the supplied function.
+ *
+ * - The request body is JSON parsed and passed into the function as parameters.
+ * - The function's return value is JSON stringified into the response body.
+ */
+export declare const createRequestListenerFromFunction: (fn: (...args: unknown[]) => Promise<unknown>) => http.RequestListener;
+/**
+ * Create a HTTP server based on the supplied `http.RequestListener`.
+ *
+ * This function resolves when the server is closed.
+ */
+export declare const serveRequestListener: (requestListener: http.RequestListener, port?: number) => Promise<void>;
+/**
+ * Returns a HTTP server wrapped in a promise
+ *
+ * This function resolves when the server is closed.
+ */
+export declare const startServer: (server: http.Server, port?: number) => Promise<void>;

package/lib/wrapper/http.js

@@ -0,0 +1,79 @@
+"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 http_exports = {};
+__export(http_exports, {
+  createRequestListenerFromFunction: () => createRequestListenerFromFunction,
+  serveRequestListener: () => serveRequestListener,
+  startServer: () => startServer
+});
+module.exports = __toCommonJS(http_exports);
+var import_http = __toESM(require("http"));
+var import_serialize_error = require("serialize-error");
+var import_logging = require("../utils/logging");
+const createRequestListenerFromFunction = (fn) => async (req, res) => {
+  const writeJsonResponse = (statusCode, jsonResponse) => {
+    res.writeHead(statusCode, { "Content-Type": "application/json" });
+    return new Promise(
+      (resolve, reject) => jsonResponse === void 0 ? res.end(resolve) : res.write(
+        JSON.stringify(jsonResponse, null, 2),
+        "utf8",
+        (err) => err ? reject(err) : res.end(resolve)
+      )
+    );
+  };
+  try {
+    const requestBody = await new Promise((resolve, reject) => {
+      const data = [];
+      req.on("data", (chunk) => data.push(chunk)).on("end", () => resolve(Buffer.concat(data).toString())).on("error", (err) => reject(err));
+    });
+    const jsonRequest = requestBody ? JSON.parse(requestBody) : [];
+    const args = Array.isArray(jsonRequest) ? jsonRequest : [jsonRequest];
+    const response = await fn(...args);
+    await writeJsonResponse(200, response);
+  } catch (err) {
+    await writeJsonResponse(500, (0, import_serialize_error.serializeError)(err));
+  }
+};
+const serveRequestListener = (requestListener, port) => {
+  const server = import_http.default.createServer(requestListener);
+  return startServer(server, port);
+};
+const startServer = (server, port) => new Promise(
+  (resolve, reject) => server.listen(port).on("close", resolve).on("error", reject).on("listening", () => {
+    const address = server.address();
+    import_logging.log.ok("listening on port", import_logging.log.bold(address.port));
+  })
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRequestListenerFromFunction,
+  serveRequestListener,
+  startServer
+});
+//# sourceMappingURL=http.js.map

package/lib/wrapper/http.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wrapper/http.ts"],
+  "sourcesContent": ["import http from 'http';\nimport type { AddressInfo } from 'net';\n\nimport { serializeError } from 'serialize-error';\n\nimport { log } from '../utils/logging';\n\n/**\n * Create an HTTP request listener based on the supplied function.\n *\n * - The request body is JSON parsed and passed into the function as parameters.\n * - The function's return value is JSON stringified into the response body.\n */\nexport const createRequestListenerFromFunction =\n  (fn: (...args: unknown[]) => Promise<unknown>): http.RequestListener =>\n  async (req, res) => {\n    const writeJsonResponse = (statusCode: number, jsonResponse: unknown) => {\n      res.writeHead(statusCode, { 'Content-Type': 'application/json' });\n\n      return new Promise<void>((resolve, reject) =>\n        jsonResponse === undefined\n          ? res.end(resolve)\n          : res.write(JSON.stringify(jsonResponse, null, 2), 'utf8', (err) =>\n              err ? reject(err) : res.end(resolve),\n            ),\n      );\n    };\n\n    try {\n      const requestBody = await new Promise<string>((resolve, reject) => {\n        const data: Buffer[] = [];\n\n        req\n          .on('data', (chunk: Buffer) => data.push(chunk))\n          .on('end', () => resolve(Buffer.concat(data).toString()))\n          .on('error', (err) => reject(err));\n      });\n\n      // Treat an empty body as no arguments\n      const jsonRequest: unknown = requestBody ? JSON.parse(requestBody) : [];\n\n      // Pass a non-array request body as the first parameter\n      const args: unknown[] = Array.isArray(jsonRequest)\n        ? jsonRequest\n        : [jsonRequest];\n\n      const response: unknown = await fn(...args);\n\n      await writeJsonResponse(200, response);\n    } catch (err) {\n      await writeJsonResponse(500, serializeError(err));\n    }\n  };\n\n/**\n * Create a HTTP server based on the supplied `http.RequestListener`.\n *\n * This function resolves when the server is closed.\n */\nexport const serveRequestListener = (\n  requestListener: http.RequestListener,\n  port?: number,\n) => {\n  const server = http.createServer(requestListener);\n  return startServer(server, port);\n};\n\n/**\n * Returns a HTTP server wrapped in a promise\n *\n * This function resolves when the server is closed.\n */\nexport const startServer = (server: http.Server, port?: number) =>\n  new Promise<void>((resolve, reject) =>\n    server\n      .listen(port)\n      .on('close', resolve)\n      .on('error', reject)\n      .on('listening', () => {\n        const address = server.address() as AddressInfo;\n\n        log.ok('listening on port', log.bold(address.port));\n      }),\n  );\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AAGjB,6BAA+B;AAE/B,qBAAoB;AAQb,MAAM,oCACX,CAAC,OACD,OAAO,KAAK,QAAQ;AAClB,QAAM,oBAAoB,CAAC,YAAoB,iBAA0B;AACvE,QAAI,UAAU,YAAY,EAAE,gBAAgB,mBAAmB,CAAC;AAEhE,WAAO,IAAI;AAAA,MAAc,CAAC,SAAS,WACjC,iBAAiB,SACb,IAAI,IAAI,OAAO,IACf,IAAI;AAAA,QAAM,KAAK,UAAU,cAAc,MAAM,CAAC;AAAA,QAAG;AAAA,QAAQ,CAAC,QACxD,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,OAAO;AAAA,MACrC;AAAA,IACN;AAAA,EACF;AAEA,MAAI;AACF,UAAM,cAAc,MAAM,IAAI,QAAgB,CAAC,SAAS,WAAW;AACjE,YAAM,OAAiB,CAAC;AAExB,UACG,GAAG,QAAQ,CAAC,UAAkB,KAAK,KAAK,KAAK,CAAC,EAC9C,GAAG,OAAO,MAAM,QAAQ,OAAO,OAAO,IAAI,EAAE,SAAS,CAAC,CAAC,EACvD,GAAG,SAAS,CAAC,QAAQ,OAAO,GAAG,CAAC;AAAA,IACrC,CAAC;AAGD,UAAM,cAAuB,cAAc,KAAK,MAAM,WAAW,IAAI,CAAC;AAGtE,UAAM,OAAkB,MAAM,QAAQ,WAAW,IAC7C,cACA,CAAC,WAAW;AAEhB,UAAM,WAAoB,MAAM,GAAG,GAAG,IAAI;AAE1C,UAAM,kBAAkB,KAAK,QAAQ;AAAA,EACvC,SAAS,KAAK;AACZ,UAAM,kBAAkB,SAAK,uCAAe,GAAG,CAAC;AAAA,EAClD;AACF;AAOK,MAAM,uBAAuB,CAClC,iBACA,SACG;AACH,QAAM,SAAS,YAAAA,QAAK,aAAa,eAAe;AAChD,SAAO,YAAY,QAAQ,IAAI;AACjC;AAOO,MAAM,cAAc,CAAC,QAAqB,SAC/C,IAAI;AAAA,EAAc,CAAC,SAAS,WAC1B,OACG,OAAO,IAAI,EACX,GAAG,SAAS,OAAO,EACnB,GAAG,SAAS,MAAM,EAClB,GAAG,aAAa,MAAM;AACrB,UAAM,UAAU,OAAO,QAAQ;AAE/B,uBAAI,GAAG,qBAAqB,mBAAI,KAAK,QAAQ,IAAI,CAAC;AAAA,EACpD,CAAC;AACL;",
+  "names": ["http"]
+}

package/lib/wrapper/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wrapper around an entry point provided to `skuba node` or `skuba start`.
+ *
+ * Beyond simply loading the entry point, it supports the following features:
+ *
+ * - If you set the entry point to an exported function like `src/app#handler`,
+ *   it will spin up a local HTTP server that calls into the function.
+ *
+ * - If you `export =` or `export default` an Express or Koa application,
+ *   it will spin up a local HTTP server based on the request listener.
+ */
+export {};

package/lib/wrapper/index.js

@@ -0,0 +1,16 @@
+"use strict";
+var import_error = require("../utils/error");
+var import_logging = require("../utils/logging");
+var import_main = require("./main");
+const ENTRY_POINT_VAR = "__SKUBA_ENTRY_POINT";
+const PORT_VAR = "__SKUBA_PORT";
+const rawEntryPoint = process.env[ENTRY_POINT_VAR];
+if (!rawEntryPoint) {
+  throw new Error(`Missing environment variable: ${import_logging.log.bold(ENTRY_POINT_VAR)}`);
+}
+const rawPort = process.env[PORT_VAR];
+if (!rawPort) {
+  throw new Error(`Missing environment variable: ${import_logging.log.bold(PORT_VAR)}`);
+}
+(0, import_main.main)(rawEntryPoint, rawPort).catch(import_error.handleCliError);
+//# sourceMappingURL=index.js.map

package/lib/wrapper/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/wrapper/index.ts"],
+  "sourcesContent": ["/**\n * Wrapper around an entry point provided to `skuba node` or `skuba start`.\n *\n * Beyond simply loading the entry point, it supports the following features:\n *\n * - If you set the entry point to an exported function like `src/app#handler`,\n *   it will spin up a local HTTP server that calls into the function.\n *\n * - If you `export =` or `export default` an Express or Koa application,\n *   it will spin up a local HTTP server based on the request listener.\n */\n\nimport { handleCliError } from '../utils/error';\nimport { log } from '../utils/logging';\n\nimport { main } from './main';\n\nconst ENTRY_POINT_VAR = '__SKUBA_ENTRY_POINT';\nconst PORT_VAR = '__SKUBA_PORT';\n\nconst rawEntryPoint = process.env[ENTRY_POINT_VAR];\nif (!rawEntryPoint) {\n  throw new Error(`Missing environment variable: ${log.bold(ENTRY_POINT_VAR)}`);\n}\n\nconst rawPort = process.env[PORT_VAR];\nif (!rawPort) {\n  throw new Error(`Missing environment variable: ${log.bold(PORT_VAR)}`);\n}\n\nmain(rawEntryPoint, rawPort).catch(handleCliError);\n"],
+  "mappings": ";AAYA,mBAA+B;AAC/B,qBAAoB;AAEpB,kBAAqB;AAErB,MAAM,kBAAkB;AACxB,MAAM,WAAW;AAEjB,MAAM,gBAAgB,QAAQ,IAAI,eAAe;AACjD,IAAI,CAAC,eAAe;AAClB,QAAM,IAAI,MAAM,iCAAiC,mBAAI,KAAK,eAAe,CAAC,EAAE;AAC9E;AAEA,MAAM,UAAU,QAAQ,IAAI,QAAQ;AACpC,IAAI,CAAC,SAAS;AACZ,QAAM,IAAI,MAAM,iCAAiC,mBAAI,KAAK,QAAQ,CAAC,EAAE;AACvE;AAAA,IAEA,kBAAK,eAAe,OAAO,EAAE,MAAM,2BAAc;",
+  "names": []
+}

package/lib/wrapper/main.d.ts

@@ -0,0 +1 @@
+export declare const main: (rawEntryPoint: string, rawPort: string) => Promise<void>;