@plugjs/plug 0.0.1

package/dist/utils/walk.mjs

@@ -0,0 +1,79 @@
+// utils/walk.ts
+import { basename, join } from "node:path";
+import { $p, log } from "../log.mjs";
+import { resolveAbsolutePath } from "../paths.mjs";
+import { readdir, stat } from "./asyncfs.mjs";
+import { match } from "./match.mjs";
+function walk(directory, globs, options = {}) {
+  const {
+    maxDepth = Infinity,
+    followSymlinks = true,
+    allowNodeModules = false,
+    ...opts
+  } = options;
+  const onDirectory = (dir) => {
+    if (dir === directory)
+      return true;
+    const name = basename(dir);
+    if (name === "node_modules")
+      return !!allowNodeModules;
+    if (name.startsWith("."))
+      return !!opts.dot;
+    return true;
+  };
+  const positiveMatcher = match(globs, opts);
+  log.debug("Walking directory", $p(directory), { globs, options });
+  return walker({
+    directory,
+    relative: "",
+    matcher: positiveMatcher,
+    onDirectory,
+    followSymlinks,
+    maxDepth,
+    depth: 0
+  });
+}
+async function* walker(args) {
+  const {
+    directory,
+    relative,
+    matcher: positiveMatcher,
+    onDirectory,
+    followSymlinks,
+    maxDepth,
+    depth
+  } = args;
+  const dir = resolveAbsolutePath(directory, relative);
+  if (!onDirectory(dir))
+    return;
+  log.trace("Reading directory", $p(dir));
+  const dirents = await readdir(dir, { withFileTypes: true }).catch((error) => {
+    if (error.code !== "ENOENT")
+      throw error;
+    log.warn("Directory", $p(dir), "not found");
+    return [];
+  });
+  for (const dirent of dirents) {
+    const path = join(relative, dirent.name);
+    if (dirent.isFile() && positiveMatcher(path))
+      yield path;
+    else if (dirent.isDirectory() && depth < maxDepth) {
+      const children = walker({ ...args, relative: path, depth: depth + 1 });
+      for await (const child of children)
+        yield child;
+    } else if (dirent.isSymbolicLink() && followSymlinks) {
+      const info = await stat(join(directory, path));
+      if (info.isFile() && positiveMatcher(path))
+        yield path;
+      else if (info.isDirectory() && depth < maxDepth) {
+        const children = walker({ ...args, relative: path, depth: depth + 1 });
+        for await (const child of children)
+          yield child;
+      }
+    }
+  }
+}
+export {
+  walk
+};
+//# sourceMappingURL=walk.mjs.map

package/dist/utils/walk.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/walk.ts"],
+  "mappings": ";AAAA,SAAS,UAAU,YAAY;AAC/B,SAAS,IAAI,WAAW;AACxB,SAAuB,2BAA2B;AAClD,SAAS,SAAS,YAAY;AAC9B,SAAS,aAA2B;AA8B7B,SAAS,KACZ,WACA,OACA,UAAuB,CAAC,GACU;AACpC,QAAM;AAAA,IACJ,WAAW;AAAA,IACX,iBAAiB;AAAA,IACjB,mBAAmB;AAAA,OAChB;AAAA,EACL,IAAI;AAGJ,QAAM,cAAc,CAAC,QAA+B;AAGlD,QAAI,QAAQ;AAAW,aAAO;AAC9B,UAAM,OAAO,SAAS,GAAG;AACzB,QAAI,SAAS;AAAgB,aAAO,CAAC,CAAC;AACtC,QAAI,KAAK,WAAW,GAAG;AAAG,aAAO,CAAC,CAAC,KAAK;AACxC,WAAO;AAAA,EACT;AAGA,QAAM,kBAAkB,MAAM,OAAO,IAAI;AAGzC,MAAI,MAAM,qBAAqB,GAAG,SAAS,GAAG,EAAE,OAAO,QAAQ,CAAC;AAChE,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,IACV,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO;AAAA,EACT,CAAC;AACH;AAiBA,gBAAgB,OAAO,MAA2D;AAChF,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAGJ,QAAM,MAAM,oBAAoB,WAAW,QAAQ;AACnD,MAAI,CAAE,YAAY,GAAG;AAAG;AACxB,MAAI,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACtC,QAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU;AAC3E,QAAI,MAAM,SAAS;AAAU,YAAM;AACnC,QAAI,KAAK,aAAa,GAAG,GAAG,GAAG,WAAW;AAC1C,WAAO,CAAC;AAAA,EACV,CAAC;AAGD,aAAW,UAAU,SAAS;AAC5B,UAAM,OAAO,KAAK,UAAU,OAAO,IAAI;AAGvC,QAAI,OAAO,OAAO,KAAK,gBAAgB,IAAI;AAAG,YAAM;AAAA,aAG3C,OAAO,YAAY,KAAM,QAAQ,UAAW;AACnD,YAAM,WAAW,OAAO,EAAE,GAAG,MAAM,UAAU,MAAM,OAAO,QAAQ,EAAE,CAAC;AACrE,uBAAiB,SAAS;AAAU,cAAM;AAAA,IAG5C,WAAW,OAAO,eAAe,KAAK,gBAAgB;AACpD,YAAM,OAAO,MAAM,KAAK,KAAK,WAAW,IAAI,CAAC;AAG7C,UAAI,KAAK,OAAO,KAAK,gBAAgB,IAAI;AAAG,cAAM;AAAA,eAGzC,KAAK,YAAY,KAAM,QAAQ,UAAW;AACjD,cAAM,WAAW,OAAO,EAAE,GAAG,MAAM,UAAU,MAAM,OAAO,QAAQ,EAAE,CAAC;AACrE,yBAAiB,SAAS;AAAU,gBAAM;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/extra/cli.mjs

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+import _yargs from "yargs-parser";
+import _childProcess from "node:child_process";
+import _fs from "node:fs";
+import _path from "node:path";
+import _url from "node:url";
+async function main() {
+  const { buildFile, tasks, listOnly } = parseCommandLine();
+  if (tasks.length === 0)
+    tasks.push("default");
+  const build = (await import(buildFile)).default;
+  if (!isBuild(build)) {
+    console.log("Build file did not export a proper build");
+    console.log();
+    console.log('- If using CommonJS export your build as "module.exports"');
+    console.log("  e.g.: module.exports = build({ ... })");
+    console.log();
+    console.log('- If using ESM modules export your build as "default"');
+    console.log("  e.g.: export default build({ ... })");
+    console.log();
+    process.exit(1);
+  }
+  for (const task of tasks) {
+    if (task in build)
+      continue;
+    console.log(`Build file does not contain task "${task}"`);
+    process.exit(1);
+  }
+  if (listOnly) {
+    console.log("Build file tasks\n- " + Object.keys(build).sort().join("\n- "));
+  } else {
+    let run;
+    for (const task of tasks) {
+      run = await build[task](run);
+    }
+  }
+}
+const sourceMapsEnabled = process.execArgv.indexOf("--enable-source-maps") >= 0;
+const tsLoaderMarker = Symbol.for("plugjs:tsLoader");
+const typeScriptEnabled = globalThis[tsLoaderMarker] === tsLoaderMarker;
+if (process.env.DEBUG_CLI === "true") {
+  console.log("SourceMaps enabled =", sourceMapsEnabled);
+  console.log("TypeScript enabled =", typeScriptEnabled);
+  console.log("         Arguments =", process.argv.join(" "));
+  console.log("               PID =", process.pid);
+}
+if (sourceMapsEnabled && typeScriptEnabled) {
+  main().then(() => process.exit(0)).catch((error) => {
+    if (!isBuildFailure(error))
+      console.log(error);
+    process.exit(1);
+  });
+} else {
+  const script = _url.fileURLToPath(import.meta.url);
+  const execArgv = [...process.execArgv];
+  if (!sourceMapsEnabled)
+    execArgv.push("--enable-source-maps");
+  if (!typeScriptEnabled) {
+    const directory = _path.dirname(script);
+    const extension = _path.extname(script);
+    const loader = _path.resolve(directory, `ts-loader${extension}`);
+    execArgv.push(`--experimental-loader=${loader}`, "--no-warnings");
+  }
+  const child = _childProcess.fork(script, [...process.argv.slice(2)], {
+    stdio: ["inherit", "inherit", "inherit", "ipc"],
+    execArgv
+  });
+  child.on("error", (error) => {
+    console.log("Error respawning CLI", error);
+    process.exit(1);
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      console.log(`CLI process exited with signal ${signal}`);
+      process.exit(1);
+    } else if (typeof code !== "number") {
+      console.log("CLI process failed for an unknown reason");
+      process.exit(1);
+    } else {
+      process.exit(code);
+    }
+  });
+}
+const buildMarker = Symbol.for("plugjs:isBuild");
+const buildFailure = Symbol.for("plugjs:buildFailure");
+function isBuild(build) {
+  return build && build[buildMarker] === buildMarker;
+}
+function isBuildFailure(arg) {
+  return arg && arg[buildFailure] === buildFailure;
+}
+function parseCommandLine() {
+  const parsed = _yargs(process.argv.slice(2), {
+    configuration: {
+      "camel-case-expansion": true,
+      "strip-aliased": true,
+      "strip-dashed": true
+    },
+    alias: {
+      verbose: ["v"],
+      quiet: ["q"],
+      colors: ["c"],
+      file: ["f"],
+      list: ["l"],
+      help: ["h"]
+    },
+    string: ["file"],
+    boolean: ["help", "colors", "list"],
+    count: ["verbose", "quiet"]
+  });
+  const tasks = [];
+  let verbosity = 0;
+  let colors = void 0;
+  let file = void 0;
+  let listOnly = false;
+  let help = false;
+  for (const key in parsed) {
+    switch (key) {
+      case "_":
+        tasks.push(...parsed[key].map((s) => `${s}`));
+        break;
+      case "verbose":
+        verbosity = verbosity + parsed[key];
+        break;
+      case "quiet":
+        verbosity = verbosity - parsed[key];
+        break;
+      case "file":
+        file = parsed[key];
+        break;
+      case "colors":
+        colors = !!parsed[key];
+        break;
+      case "list":
+        listOnly = !!parsed[key];
+        break;
+      case "help":
+        help = !!parsed[key];
+        break;
+      default:
+        console.log(`Unsupported option "${key}" (try "--help")`);
+        process.exit(1);
+    }
+  }
+  if (help) {
+    console.log(`Usage:
+
+    plugjs [--options] [... tasks]
+
+    Options:
+      -v --verbose  Increase logging verbosity
+      -q --quiet    Decrease logging verbosity
+      -c --colors   Force colorful output (use "--no-colors" to force plain text)
+      -f --file     Specify the build file to use (default "./build.[ts/js/...]")
+      -l --list     Only list the tasks defined by the build, nothing more!
+      -h --help     Help! You're reading it now!
+
+    Tasks:
+      Any other argument will be treated as a task name. If no task names are
+      specified, the "default" task will be executed.
+  `);
+    process.exit(1);
+  }
+  if (colors !== void 0)
+    process.env.LOG_COLORS = `${colors}`;
+  if (verbosity) {
+    const levels = ["TRACE", "DEBUG", "INFO", "NOTICE", "WARN", "ERROR", "OFF"];
+    let level = levels.indexOf("NOTICE") - verbosity;
+    if (level >= levels.length)
+      level = levels.length - 1;
+    else if (level < 0)
+      level = 0;
+    process.env.LOG_LEVEL = levels[level];
+  }
+  const exts = ["ts", "mts", "mjs", "js", "mjs", "cjs"];
+  let buildFile = void 0;
+  if (file) {
+    const absolute = _path.resolve(file);
+    if (!isFile(absolute)) {
+      console.log(`Specified build file "${file}" was not found`);
+      process.exit(1);
+    } else {
+      buildFile = absolute;
+    }
+  } else {
+    for (const ext of exts) {
+      const absolute = _path.resolve(`build.${ext}`);
+      if (!isFile(absolute))
+        continue;
+      buildFile = absolute;
+      break;
+    }
+  }
+  if (!buildFile) {
+    console.log(`Unable to find build file "./build.[${exts.join("|")}]`);
+    process.exit(1);
+  }
+  return { buildFile, tasks, listOnly };
+}
+function isFile(path) {
+  try {
+    return _fs.statSync(path).isFile();
+  } catch (error) {
+    return false;
+  }
+}
+export {
+  isBuild,
+  isBuildFailure,
+  parseCommandLine
+};
+//# sourceMappingURL=data:application/json;base64,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

package/extra/ts-loader.mjs

@@ -0,0 +1,214 @@
+import _esbuild from "esbuild";
+import _fs from "node:fs";
+import _module from "node:module";
+import _path from "node:path";
+import _url from "node:url";
+const CJS = "commonjs";
+const ESM = "module";
+const _debug = process.env.DEBUG_TS_LOADER === "true";
+function _log(type, ...args) {
+  if (!_debug)
+    return;
+  const t = type === "module" ? "esm" : type === "commonjs" ? "cjs" : "---";
+  const prefix = `[ts-loader|${t}|pid=${process.pid}]`;
+  console.log(prefix, ...args);
+}
+function _throw(type, message, options = {}) {
+  const t = type === "module" ? "esm" : type === "commonjs" ? "cjs" : "---";
+  const prefix = `[ts-loader|${t}|pid=${process.pid}]`;
+  const { start = _throw, ...extra } = options;
+  const error = new Error(`${prefix} ${message}`);
+  Error.captureStackTrace(error, start);
+  Object.assign(error, extra);
+  throw error;
+}
+const _moduleFormatCache = /* @__PURE__ */ new Map();
+function _moduleFormat(directory) {
+  const type = _moduleFormatCache.get(directory);
+  if (type)
+    return type;
+  const file = _path.resolve(directory, "package.json");
+  try {
+    const json = _fs.readFileSync(file, "utf-8");
+    const data = JSON.parse(json);
+    const type2 = data.type === "module" ? ESM : CJS;
+    _log(null, `File "${file}" defines module type as "${data.type}" (${type2})`);
+    _moduleFormatCache.set(directory, type2);
+    return type2;
+  } catch (cause) {
+    if (cause.code !== "ENOENT" && cause.code !== "EISDIR") {
+      _throw(null, `Unable to read or parse "${file}"`, { cause, start: _moduleFormat });
+    }
+  }
+  const name = _path.basename(directory);
+  const parent = _path.dirname(directory);
+  if (name === "node_modules" || parent === directory) {
+    _moduleFormatCache.set(directory, CJS);
+    return CJS;
+  } else {
+    const type2 = _moduleFormat(parent);
+    _moduleFormatCache.set(directory, type2);
+    return type2;
+  }
+}
+function _isFile(path) {
+  try {
+    return _fs.statSync(path).isFile();
+  } catch (error) {
+    return false;
+  }
+}
+function _isDirectory(path) {
+  try {
+    return _fs.statSync(path).isDirectory();
+  } catch (error) {
+    return false;
+  }
+}
+function _esbReport(kind, messages = []) {
+  const output = process.stderr;
+  const options = { color: !!output.isTTY, terminalWidth: output.columns || 80 };
+  const array = _esbuild.formatMessagesSync(messages, { kind, ...options });
+  array.forEach((message) => output.write(`${message}
+`));
+}
+function _esbTranpile(filename, type) {
+  _log(type, `Transpiling "${filename}`);
+  const [format, __fileurl] = type === ESM ? ["esm", "import.meta.url"] : ["cjs", "__filename"];
+  const options = {
+    sourcefile: filename,
+    format,
+    loader: "ts",
+    sourcemap: "inline",
+    sourcesContent: false,
+    platform: "node",
+    logLevel: "silent",
+    target: `node${process.versions["node"]}`,
+    define: { __fileurl }
+  };
+  if (_debug) {
+    options.banner = `console.log(\`[ts-loader|${format}]: Loaded "\${${__fileurl}}"\`);`;
+  }
+  let result;
+  try {
+    const source = _fs.readFileSync(filename, "utf-8");
+    result = _esbuild.transformSync(source, options);
+  } catch (cause) {
+    _esbReport("error", cause.errors);
+    _esbReport("warning", cause.warnings);
+    _throw(type, `ESBuild error transpiling "${filename}"`, { cause, start: _esbTranpile });
+  }
+  if (_debug)
+    _esbReport("warning", result.warnings);
+  return result.code;
+}
+const resolve = (specifier, context, nextResolve) => {
+  _log(ESM, `Resolving "${specifier}" from "${context.parentURL}"`);
+  if (!specifier.match(/^\.\.?\//))
+    return nextResolve(specifier, context);
+  const parentURL = context.parentURL;
+  if (!parentURL)
+    return nextResolve(specifier, context);
+  if (!parentURL.startsWith("file:"))
+    return nextResolve(specifier, context);
+  if (!parentURL.match(/\.m?ts$/))
+    return nextResolve(specifier, context);
+  const url = new URL(specifier, parentURL).href;
+  const path = _url.fileURLToPath(url);
+  if (_isFile(path)) {
+    _log(ESM, `Positive match for "${specifier}" as "${path}" (1)`);
+    return nextResolve(specifier, context);
+  }
+  const match = specifier.match(/(.*)(\.[mc]?js$)/);
+  if (match) {
+    const [, base, ext] = match;
+    const tsspecifier = base + ext.replace("js", "ts");
+    const tsurl = new URL(tsspecifier, parentURL).href;
+    const tspath = _url.fileURLToPath(tsurl);
+    if (_isFile(tspath)) {
+      _log(ESM, `Positive match for "${specifier}" as "${tspath}" (2)`);
+      return nextResolve(tsspecifier, context);
+    }
+  }
+  if (_isFile(`${path}.ts`)) {
+    _log(ESM, `Positive match for "${specifier}.ts" as "${path}.ts" (3)`);
+    return nextResolve(`${specifier}.ts`, context);
+  }
+  if (_isDirectory(path)) {
+    const file = _path.resolve(path, "index.ts");
+    const spec = _path.join(specifier, "index.ts");
+    if (_isFile(file)) {
+      _log(ESM, `Positive match for "${spec}" as "${file}"  (4)`);
+      return nextResolve(spec, context);
+    }
+  }
+  return nextResolve(specifier, context);
+};
+const load = (url, context, nextLoad) => {
+  var _a;
+  _log(ESM, `Attempting to load "${url}"`);
+  if (!url.startsWith("file:"))
+    return nextLoad(url, context);
+  const ext = (_a = url.match(/\.[cm]?ts$/)) == null ? void 0 : _a[0];
+  if (!ext)
+    return nextLoad(url, context);
+  if (ext === ".cts")
+    return { format: "commonjs" };
+  const filename = _url.fileURLToPath(url);
+  if (ext === ".ts") {
+    const format = _moduleFormat(_path.dirname(filename));
+    if (format === CJS)
+      return { format: "commonjs" };
+  }
+  const source = _esbTranpile(filename, ESM);
+  return { source, format: "module", shortCircuit: true };
+};
+const loader = (module, filename) => {
+  _log(ESM, `Attempting to load "${filename}"`);
+  const ext = _path.extname(filename);
+  if (ext === ".ts") {
+    const format = _moduleFormat(_path.dirname(filename));
+    if (format === ESM) {
+      _throw(CJS, `Must use import to load ES Module: ${filename}`, { code: "ERR_REQUIRE_ESM" });
+    }
+  } else if (ext !== ".cts") {
+    _throw(CJS, `Unsupported filename "${filename}"`);
+  }
+  const source = _esbTranpile(filename, CJS);
+  try {
+    module._compile(source, filename);
+  } catch (cause) {
+    _throw(CJS, `Error compiling module "${filename}"`, { cause });
+  }
+};
+_module._extensions[".ts"] = _module._extensions[".cts"] = loader;
+const _oldResolveFilename = _module._resolveFilename;
+_module._resolveFilename = function(request, parent, ...args) {
+  try {
+    return _oldResolveFilename.call(this, request, parent, ...args);
+  } catch (error) {
+    if (error.code !== "MODULE_NOT_FOUND")
+      throw error;
+    const match = request.match(/(.*)(\.[mc]?js$)/);
+    if (parent && match) {
+      const [, name, ext] = match;
+      const tsrequest = name + ext.replace("js", "ts");
+      try {
+        const result = _oldResolveFilename.call(this, tsrequest, parent, ...args);
+        _log("commonjs", `Resolution for "${request}" intercepted as "${tsrequest}`);
+        return result;
+      } catch (discard) {
+        throw error;
+      }
+    }
+    throw error;
+  }
+};
+const tsLoaderMarker = Symbol.for("plugjs:tsLoader");
+globalThis[tsLoaderMarker] = tsLoaderMarker;
+_log(null, `Installing loader from "${import.meta.url}"`);
+export {
+  load,
+  resolve
+};
+//# sourceMappingURL=data:application/json;base64,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

package/extra/webassembly.d.ts

@@ -0,0 +1,11 @@
+/// <reference no-default-lib="true"/>
+
+/*
+ * Type definition for `WebAssembly`. This is normally provided to TypeScript
+ * by `lib.dom.d.ts`, and is not defined by Node's own types.
+ *
+ * https://github.com/evanw/esbuild/issues/2388
+ */
+declare namespace WebAssembly {
+  interface Module {} // for esbuild types
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@plugjs/plug",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./types/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./types/index.d.ts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "bin": {
+    "plug": "./extra/cli.mjs"
+  },
+  "scripts": {
+    "bootstrap": "./bootstrap.sh",
+    "build": "node ./extra/cli.mjs",
+    "dev": "npx nodemon -e .ts -w ./test -w ./src -x ./runme.sh"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@babel/parser": "^7.18.11",
+    "@babel/types": "^7.18.10",
+    "@plugjs/cov8-html": "^0.0.1",
+    "diff": "^5.1.0",
+    "esbuild": "^0.15.4",
+    "eslint": "^8.22.0",
+    "mocha": "^10.0.0",
+    "picomatch": "^2.3.1",
+    "source-map": "^0.7.4",
+    "typescript": "^4.7.4",
+    "yargs-parser": "^21.1.1"
+  },
+  "devDependencies": {
+    "@types/chai": "^4.3.3",
+    "@types/diff": "^5.0.2",
+    "@types/eslint": "^8.4.5",
+    "@types/mocha": "^9.1.1",
+    "@types/ms": "^0.7.31",
+    "@types/node": "<17",
+    "@types/picomatch": "^2.3.0",
+    "@types/yargs-parser": "^21.0.0",
+    "@typescript-eslint/eslint-plugin": "^5.33.1",
+    "@typescript-eslint/parser": "^5.33.1",
+    "chai": "^4.3.6",
+    "eslint-config-google": "^0.14.0"
+  }
+}

package/src/assert.ts

@@ -0,0 +1,47 @@
+/* ========================================================================== *
+ * BUILD FAILURES                                                             *
+ * ========================================================================== */
+
+const buildError = Symbol.for('plugjs:buildError')
+const buildFailure = Symbol.for('plugjs:buildFailure')
+
+/** Check if the specified argument is a {@link BuildError} */
+export function isBuildError(arg: any): arg is BuildError {
+  return arg && arg[buildError] === buildError
+}
+
+/** Check if the specified argument is a {@link BuildFailure} */
+export function isBuildFailure(arg: any): arg is BuildFailure {
+  return arg && arg[buildFailure] === buildFailure
+}
+
+/** An error produced in our build, with proper inspection for logging */
+export class BuildError extends Error {
+  constructor(message: string) {
+    super(message)
+    Object.defineProperty(this, buildError, { value: buildError })
+  }
+}
+
+/** A {@link BuildFailure} represents an error _already logged_ in our build. */
+export class BuildFailure extends Error {
+  constructor() {
+    super('Build Failure')
+    Object.defineProperty(this, buildFailure, { value: buildFailure })
+  }
+}
+
+/** Asserts something as _truthy_ and fail the build if not */
+export function assert(assertion: any, message: string): asserts assertion {
+  if (! assertion) throw new BuildError(message)
+}
+
+/** Throw a {@link BuildError} (an {@link Error} printed nicely) */
+export function fail(message: string): never {
+  throw new BuildError(message)
+}
+
+/** Return a non-logged {@link BuildFailure} */
+export function failure(): BuildFailure {
+  return new BuildFailure()
+}