skuba 0.0.0-master-20230318044948

package/lib/utils/template.d.ts

@@ -0,0 +1,37 @@
+import * as t from 'runtypes';
+export declare const TEMPLATE_NAMES: readonly ["express-rest-api", "greeter", "koa-rest-api", "lambda-sqs-worker", "lambda-sqs-worker-cdk", "oss-npm-package", "private-npm-package"];
+export type TemplateName = (typeof TEMPLATE_NAMES)[number];
+export declare const TEMPLATE_NAMES_WITH_BYO: readonly ["express-rest-api", "greeter", "koa-rest-api", "lambda-sqs-worker", "lambda-sqs-worker-cdk", "oss-npm-package", "private-npm-package", "github →"];
+interface TemplateDocumentationConfig {
+    /**
+     * The semantic version in which the template was first added.
+     *
+     * This is used to filter out historical changelogs.
+     */
+    added: string;
+    /**
+     * The Markdown file for the template in our `/docs`.
+     *
+     * This is used to compile per-template changelogs for our documentation site.
+     */
+    filename: string;
+}
+export declare const TEMPLATE_DOCUMENTATION_CONFIG: Record<TemplateName, TemplateDocumentationConfig>;
+export type TemplateConfig = t.Static<typeof TemplateConfig>;
+export declare const TemplateConfig: t.Record<{
+    fields: t.Array<t.Record<{
+        name: t.String;
+        message: t.String;
+        initial: t.String;
+        validate: t.Optional<t.Function>;
+    }, false>, false>;
+    entryPoint: t.Optional<t.String>;
+    noSkip: t.Optional<t.Boolean>;
+    type: t.Optional<t.Union<[t.Literal<"application">, t.Literal<"package">]>>;
+}, false>;
+export declare const TEMPLATE_CONFIG_FILENAME = "skuba.template.js";
+export declare const TEMPLATE_DIR: string;
+export declare const BASE_TEMPLATE_DIR: string;
+export declare const ensureTemplateConfigDeletion: (dir: string) => Promise<void>;
+export declare const readBaseTemplateFile: (src: string) => Promise<string>;
+export {};

package/lib/utils/template.js

@@ -0,0 +1,116 @@
+"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 template_exports = {};
+__export(template_exports, {
+  BASE_TEMPLATE_DIR: () => BASE_TEMPLATE_DIR,
+  TEMPLATE_CONFIG_FILENAME: () => TEMPLATE_CONFIG_FILENAME,
+  TEMPLATE_DIR: () => TEMPLATE_DIR,
+  TEMPLATE_DOCUMENTATION_CONFIG: () => TEMPLATE_DOCUMENTATION_CONFIG,
+  TEMPLATE_NAMES: () => TEMPLATE_NAMES,
+  TEMPLATE_NAMES_WITH_BYO: () => TEMPLATE_NAMES_WITH_BYO,
+  TemplateConfig: () => TemplateConfig,
+  ensureTemplateConfigDeletion: () => ensureTemplateConfigDeletion,
+  readBaseTemplateFile: () => readBaseTemplateFile
+});
+module.exports = __toCommonJS(template_exports);
+var import_path = __toESM(require("path"));
+var import_fs_extra = __toESM(require("fs-extra"));
+var t = __toESM(require("runtypes"));
+var import_manifest = require("./manifest");
+const TEMPLATE_NAMES = [
+  "express-rest-api",
+  "greeter",
+  "koa-rest-api",
+  "lambda-sqs-worker",
+  "lambda-sqs-worker-cdk",
+  "oss-npm-package",
+  "private-npm-package"
+];
+const TEMPLATE_NAMES_WITH_BYO = [...TEMPLATE_NAMES, "github \u2192"];
+const TEMPLATE_DOCUMENTATION_CONFIG = {
+  "express-rest-api": {
+    added: "3.8.0",
+    filename: "api.md"
+  },
+  greeter: {
+    added: "3.4.1",
+    filename: "barebones.md"
+  },
+  "koa-rest-api": {
+    added: "3.4.1",
+    filename: "api.md"
+  },
+  "lambda-sqs-worker": {
+    added: "3.4.1",
+    filename: "worker.md"
+  },
+  "lambda-sqs-worker-cdk": {
+    added: "3.13.0",
+    filename: "worker.md"
+  },
+  "oss-npm-package": {
+    added: "3.7.0",
+    filename: "package.md"
+  },
+  "private-npm-package": {
+    added: "3.6.0",
+    filename: "package.md"
+  }
+};
+const TemplateConfig = t.Record({
+  fields: t.Array(
+    t.Record({
+      name: t.String,
+      message: t.String,
+      initial: t.String,
+      validate: t.Function.optional()
+    })
+  ),
+  entryPoint: t.String.optional(),
+  noSkip: t.Boolean.optional(),
+  type: import_manifest.ProjectType.optional()
+});
+const TEMPLATE_CONFIG_FILENAME = "skuba.template.js";
+const TEMPLATE_DIR = import_path.default.join(__dirname, "..", "..", "template");
+const BASE_TEMPLATE_DIR = import_path.default.join(TEMPLATE_DIR, "base");
+const ensureTemplateConfigDeletion = (dir) => import_fs_extra.default.promises.rm(import_path.default.join(dir, TEMPLATE_CONFIG_FILENAME));
+const readBaseTemplateFile = (src) => import_fs_extra.default.promises.readFile(import_path.default.join(BASE_TEMPLATE_DIR, src), "utf8");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BASE_TEMPLATE_DIR,
+  TEMPLATE_CONFIG_FILENAME,
+  TEMPLATE_DIR,
+  TEMPLATE_DOCUMENTATION_CONFIG,
+  TEMPLATE_NAMES,
+  TEMPLATE_NAMES_WITH_BYO,
+  TemplateConfig,
+  ensureTemplateConfigDeletion,
+  readBaseTemplateFile
+});
+//# sourceMappingURL=template.js.map

package/lib/utils/template.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/template.ts"],
+  "sourcesContent": ["/* eslint-disable new-cap */\n\nimport path from 'path';\n\nimport fs from 'fs-extra';\nimport * as t from 'runtypes';\n\nimport { ProjectType } from './manifest';\n\nexport const TEMPLATE_NAMES = [\n  'express-rest-api',\n  'greeter',\n  'koa-rest-api',\n  'lambda-sqs-worker',\n  'lambda-sqs-worker-cdk',\n  'oss-npm-package',\n  'private-npm-package',\n] as const;\n\nexport type TemplateName = (typeof TEMPLATE_NAMES)[number];\n\nexport const TEMPLATE_NAMES_WITH_BYO = [...TEMPLATE_NAMES, 'github \u2192'] as const;\n\ninterface TemplateDocumentationConfig {\n  /**\n   * The semantic version in which the template was first added.\n   *\n   * This is used to filter out historical changelogs.\n   */\n  added: string;\n\n  /**\n   * The Markdown file for the template in our `/docs`.\n   *\n   * This is used to compile per-template changelogs for our documentation site.\n   */\n  filename: string;\n}\n\nexport const TEMPLATE_DOCUMENTATION_CONFIG: Record<\n  TemplateName,\n  TemplateDocumentationConfig\n> = {\n  'express-rest-api': {\n    added: '3.8.0',\n    filename: 'api.md',\n  },\n  greeter: {\n    added: '3.4.1',\n    filename: 'barebones.md',\n  },\n  'koa-rest-api': {\n    added: '3.4.1',\n    filename: 'api.md',\n  },\n  'lambda-sqs-worker': {\n    added: '3.4.1',\n    filename: 'worker.md',\n  },\n  'lambda-sqs-worker-cdk': {\n    added: '3.13.0',\n    filename: 'worker.md',\n  },\n  'oss-npm-package': {\n    added: '3.7.0',\n    filename: 'package.md',\n  },\n  'private-npm-package': {\n    added: '3.6.0',\n    filename: 'package.md',\n  },\n};\n\nexport type TemplateConfig = t.Static<typeof TemplateConfig>;\n\nexport const TemplateConfig = t.Record({\n  fields: t.Array(\n    t.Record({\n      name: t.String,\n      message: t.String,\n      initial: t.String,\n      validate: t.Function.optional(),\n    }),\n  ),\n  entryPoint: t.String.optional(),\n  noSkip: t.Boolean.optional(),\n  type: ProjectType.optional(),\n});\n\nexport const TEMPLATE_CONFIG_FILENAME = 'skuba.template.js';\n\nexport const TEMPLATE_DIR = path.join(__dirname, '..', '..', 'template');\n\nexport const BASE_TEMPLATE_DIR = path.join(TEMPLATE_DIR, 'base');\n\nexport const ensureTemplateConfigDeletion = (dir: string): Promise<void> =>\n  fs.promises.rm(path.join(dir, TEMPLATE_CONFIG_FILENAME));\n\nexport const readBaseTemplateFile = (src: string): Promise<string> =>\n  fs.promises.readFile(path.join(BASE_TEMPLATE_DIR, src), 'utf8');\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAiB;AAEjB,sBAAe;AACf,QAAmB;AAEnB,sBAA4B;AAErB,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,0BAA0B,CAAC,GAAG,gBAAgB,eAAU;AAkB9D,MAAM,gCAGT;AAAA,EACF,oBAAoB;AAAA,IAClB,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,gBAAgB;AAAA,IACd,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,qBAAqB;AAAA,IACnB,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,yBAAyB;AAAA,IACvB,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,mBAAmB;AAAA,IACjB,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,uBAAuB;AAAA,IACrB,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AACF;AAIO,MAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,QAAQ,EAAE;AAAA,IACR,EAAE,OAAO;AAAA,MACP,MAAM,EAAE;AAAA,MACR,SAAS,EAAE;AAAA,MACX,SAAS,EAAE;AAAA,MACX,UAAU,EAAE,SAAS,SAAS;AAAA,IAChC,CAAC;AAAA,EACH;AAAA,EACA,YAAY,EAAE,OAAO,SAAS;AAAA,EAC9B,QAAQ,EAAE,QAAQ,SAAS;AAAA,EAC3B,MAAM,4BAAY,SAAS;AAC7B,CAAC;AAEM,MAAM,2BAA2B;AAEjC,MAAM,eAAe,YAAAA,QAAK,KAAK,WAAW,MAAM,MAAM,UAAU;AAEhE,MAAM,oBAAoB,YAAAA,QAAK,KAAK,cAAc,MAAM;AAExD,MAAM,+BAA+B,CAAC,QAC3C,gBAAAC,QAAG,SAAS,GAAG,YAAAD,QAAK,KAAK,KAAK,wBAAwB,CAAC;AAElD,MAAM,uBAAuB,CAAC,QACnC,gBAAAC,QAAG,SAAS,SAAS,YAAAD,QAAK,KAAK,mBAAmB,GAAG,GAAG,MAAM;",
+  "names": ["path", "fs"]
+}

package/lib/utils/validation.d.ts

@@ -0,0 +1,6 @@
+export declare const isFunction: (data: unknown) => data is (...args: unknown[]) => unknown | Promise<unknown>;
+export declare const isIpPort: (value: unknown) => value is number;
+export declare const isObject: (value: unknown) => value is Record<PropertyKey, unknown>;
+export declare const hasProp: <P extends PropertyKey>(value: unknown, prop: P) => value is Record<P, unknown>;
+export declare const hasNumberProp: <P extends PropertyKey>(value: unknown, prop: P) => value is Record<P, string>;
+export declare const hasStringProp: <P extends PropertyKey>(value: unknown, prop: P) => value is Record<P, string>;

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[]) => 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>(\n  value: unknown,\n  prop: P,\n): value is Record<P, unknown> => isObject(value) && value.hasOwnProperty(prop);\n\nexport const hasNumberProp = <P extends PropertyKey>(\n  value: unknown,\n  prop: P,\n): value is Record<P, string> =>\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,SACgC,SAAS,KAAK,KAAK,MAAM,eAAe,IAAI;AAEvE,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,yCAAyC;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;AAAA,IACd;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,QAAE;AACA,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,GAAG;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,SACvC;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;AAAA,EACd;AAEA,QAAM,sBAAkB,+CAAkC,EAAE;AAE5D,aAAO,kCAAqB,iBAAiB,aAAa;AAC5D;",
+  "names": ["fnArgs"]
+}