@qlever-llc/trellis 0.8.2 → 0.8.4

package/bin/trellis-generate.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+const { createHash } = require("node:crypto");
+const fs = require("node:fs");
+const https = require("node:https");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const REPO_OWNER = "qlever-llc";
+const REPO_NAME = "trellis";
+const BIN_NAME = "trellis-generate";
+const SUPPORTED_TARGETS = new Set([
+  "x86_64-unknown-linux-gnu",
+  "aarch64-unknown-linux-gnu",
+  "x86_64-apple-darwin",
+  "aarch64-apple-darwin",
+]);
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+
+async function main() {
+  const packageVersion = readPackageVersion();
+  const binary = (process.env.TRELLIS_GENERATE_BIN || "").trim() ||
+    await ensureCachedReleaseBinary(packageVersion);
+  verifyBinaryVersion(binary, packageVersion);
+  const status = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+  if (status.error) throw status.error;
+  process.exit(status.status ?? 1);
+}
+
+function readPackageVersion() {
+  const manifestPath = path.resolve(__dirname, "../package.json");
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+  if (typeof manifest.version !== "string" || !manifest.version.trim()) {
+    throw new Error("@qlever-llc/trellis package manifest does not declare a version");
+  }
+  return manifest.version.trim();
+}
+
+async function ensureCachedReleaseBinary(version) {
+  const target = releaseTarget();
+  const cacheDir = path.join(cacheRoot(), version, target);
+  const binary = path.join(cacheDir, BIN_NAME);
+  if (fs.existsSync(binary)) return binary;
+
+  fs.mkdirSync(cacheDir, { recursive: true });
+  const tag = "v" + version;
+  const archiveName = BIN_NAME + "-" + tag + "-" + target + ".tar.gz";
+  const checksumName = "checksum-" + tag + "-" + target + "-" + BIN_NAME + ".sha256";
+  const releaseBase = "https://github.com/" + REPO_OWNER + "/" + REPO_NAME + "/releases/download/" + tag;
+  const [archive, checksumText] = await Promise.all([
+    downloadBytes(releaseBase + "/" + archiveName),
+    downloadText(releaseBase + "/" + checksumName),
+  ]);
+  verifyChecksum(archive, checksumText, archiveName);
+
+  const archivePath = path.join(cacheDir, archiveName);
+  fs.writeFileSync(archivePath, archive);
+  const extract = spawnSync("tar", ["-xzf", archivePath, "-C", cacheDir], { stdio: "inherit" });
+  if (extract.error) throw extract.error;
+  if (extract.status !== 0) throw new Error("tar failed with exit code " + extract.status);
+  fs.chmodSync(binary, 0o755);
+  return binary;
+}
+
+function releaseTarget() {
+  const arch = os.arch() === "x64" ? "x86_64" : os.arch() === "arm64" ? "aarch64" : os.arch();
+  const platform = os.platform() === "darwin" ? "apple-darwin" : os.platform() === "linux" ? "unknown-linux-gnu" : undefined;
+  const target = platform ? arch + "-" + platform : undefined;
+  if (target && SUPPORTED_TARGETS.has(target)) return target;
+  throw new Error("no " + BIN_NAME + " release binary is available for " + os.platform() + " " + os.arch());
+}
+
+function cacheRoot() {
+  if ((process.env.TRELLIS_GENERATE_CACHE || "").trim()) return process.env.TRELLIS_GENERATE_CACHE.trim();
+  if ((process.env.XDG_CACHE_HOME || "").trim()) return path.join(process.env.XDG_CACHE_HOME.trim(), "trellis", BIN_NAME);
+  if ((process.env.LOCALAPPDATA || "").trim()) return path.join(process.env.LOCALAPPDATA.trim(), "trellis", BIN_NAME);
+  if ((process.env.HOME || "").trim()) return path.join(process.env.HOME.trim(), ".cache", "trellis", BIN_NAME);
+  throw new Error("HOME, LOCALAPPDATA, or TRELLIS_GENERATE_CACHE must be set to cache trellis-generate");
+}
+
+function downloadBytes(url) {
+  return new Promise((resolve, reject) => {
+    https.get(url, (response) => {
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        resolve(downloadBytes(response.headers.location));
+        return;
+      }
+      if (response.statusCode !== 200) {
+        reject(new Error("failed to download " + url + ": HTTP " + response.statusCode));
+        response.resume();
+        return;
+      }
+      const chunks = [];
+      response.on("data", (chunk) => chunks.push(chunk));
+      response.on("end", () => resolve(Buffer.concat(chunks)));
+    }).on("error", reject);
+  });
+}
+
+async function downloadText(url) {
+  return (await downloadBytes(url)).toString("utf8");
+}
+
+function verifyChecksum(bytes, checksumText, label) {
+  const expected = checksumText.trim().split(/\s+/)[0]?.toLowerCase();
+  if (!expected || !/^[0-9a-f]{64}$/.test(expected)) {
+    throw new Error("release checksum asset did not contain a SHA-256 digest");
+  }
+  const actual = createHash("sha256").update(bytes).digest("hex");
+  if (actual !== expected) {
+    throw new Error("checksum mismatch for " + label + ": expected " + expected + ", got " + actual);
+  }
+}
+
+function verifyBinaryVersion(binary, expectedVersion) {
+  const output = spawnSync(binary, ["--version"], { encoding: "utf8" });
+  if (output.error) throw output.error;
+  if (output.status !== 0) throw new Error("failed to run " + binary + " --version");
+  const text = (output.stdout || "").trim();
+  const actualVersion = text.split(/\s+/).find((part) => /^v?\d+\.\d+\.\d+/.test(part));
+  if (!actualVersion || normalizeVersion(actualVersion) !== normalizeVersion(expectedVersion)) {
+    throw new Error(binary + " is " + (text || "unknown version") + "; expected " + BIN_NAME + " " + expectedVersion);
+  }
+}
+
+function normalizeVersion(version) {
+  return version.trim().replace(/^v/, "").split("+")[0];
+}

package/esm/npm/src/_dnt.polyfills.d.ts

@@ -15,4 +15,103 @@ declare global {
     }
 }
 export {};
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
 //# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/npm/src/_dnt.polyfills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../../../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC;AAgBV,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../../../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC;AAgBV,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC;AACV;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}

package/esm/npm/src/_dnt.polyfills.js

@@ -12,4 +12,130 @@ if (!Object.hasOwn) {
         writable: true,
     });
 }
-export {};
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});

package/esm/npm/src/generate.d.ts

@@ -0,0 +1,2 @@
+import "./_dnt.polyfills.js";
+//# sourceMappingURL=generate.d.ts.map

package/esm/npm/src/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC"}

package/esm/npm/src/generate.js

@@ -0,0 +1,234 @@
+import "./_dnt.polyfills.js";
+import * as dntShim from "./_dnt.shims.js";
+const REPO_OWNER = "qlever-llc";
+const REPO_NAME = "trellis";
+const BIN_NAME = "trellis-generate";
+const SUPPORTED_TARGETS = new Set([
+    "x86_64-unknown-linux-gnu",
+    "aarch64-unknown-linux-gnu",
+    "x86_64-apple-darwin",
+    "aarch64-apple-darwin",
+]);
+async function main() {
+    const localRepoRoot = await findLocalTrellisRepoRoot();
+    if (localRepoRoot) {
+        await runLocalGenerator(localRepoRoot, dntShim.Deno.args);
+        return;
+    }
+    const packageVersion = await readPackageVersion();
+    const binary = dntShim.Deno.env.get("TRELLIS_GENERATE_BIN")?.trim() ||
+        await ensureCachedReleaseBinary(packageVersion);
+    await verifyBinaryVersion(binary, packageVersion);
+    await runBinary(binary, dntShim.Deno.args);
+}
+async function findLocalTrellisRepoRoot() {
+    let current = urlDirname(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+    while (current !== dirname(current)) {
+        if (await pathExists(joinPath(current, "rust/tools/generate/Cargo.toml")) &&
+            await pathExists(joinPath(current, "js/deno.json"))) {
+            return current;
+        }
+        current = dirname(current);
+    }
+    return undefined;
+}
+async function runLocalGenerator(repoRoot, args) {
+    return await runCommand("cargo", [
+        "run",
+        "--manifest-path",
+        joinPath(repoRoot, "rust/tools/generate/Cargo.toml"),
+        "--bin",
+        BIN_NAME,
+        "--",
+        ...args,
+    ]);
+}
+async function readPackageVersion() {
+    const manifest = await readFirstManifest([
+        new URL("./deno.json", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url),
+        new URL("../package.json", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url),
+        new URL("../../../package.json", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url),
+    ]);
+    if (typeof manifest.version !== "string" || !manifest.version.trim()) {
+        throw new Error("@qlever-llc/trellis package manifest does not declare a version");
+    }
+    return manifest.version.trim();
+}
+async function readFirstManifest(urls) {
+    for (const url of urls) {
+        try {
+            return JSON.parse(await dntShim.Deno.readTextFile(url));
+        }
+        catch (error) {
+            if (error instanceof dntShim.Deno.errors.NotFound) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw new Error("could not find @qlever-llc/trellis package manifest");
+}
+async function ensureCachedReleaseBinary(version) {
+    const target = releaseTarget();
+    const cacheDir = joinPath(cacheRoot(), version, target);
+    const binary = joinPath(cacheDir, BIN_NAME);
+    if (await pathExists(binary)) {
+        return binary;
+    }
+    await dntShim.Deno.mkdir(cacheDir, { recursive: true });
+    const tag = `v${version}`;
+    const archiveName = `${BIN_NAME}-${tag}-${target}.tar.gz`;
+    const archiveUrl = `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/${tag}/${archiveName}`;
+    const checksumName = `checksum-${tag}-${target}-${BIN_NAME}.sha256`;
+    const checksumUrl = `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/${tag}/${checksumName}`;
+    const [archive, checksumText] = await Promise.all([
+        downloadBytes(archiveUrl),
+        downloadText(checksumUrl),
+    ]);
+    await verifyChecksum(archive, checksumText, archiveUrl);
+    const archivePath = joinPath(cacheDir, archiveName);
+    await dntShim.Deno.writeFile(archivePath, archive);
+    await runCommandChecked("tar", ["-xzf", archivePath, "-C", cacheDir]);
+    await dntShim.Deno.chmod(binary, 0o755);
+    return binary;
+}
+function releaseTarget() {
+    if (SUPPORTED_TARGETS.has(dntShim.Deno.build.target)) {
+        return dntShim.Deno.build.target;
+    }
+    const buildArch = dntShim.Deno.build.arch;
+    const arch = buildArch === "x86_64" || buildArch === "x64"
+        ? "x86_64"
+        : buildArch;
+    const os = dntShim.Deno.build.os === "darwin"
+        ? "apple-darwin"
+        : dntShim.Deno.build.os === "linux"
+            ? "unknown-linux-gnu"
+            : undefined;
+    const target = os ? `${arch}-${os}` : undefined;
+    if (target && SUPPORTED_TARGETS.has(target)) {
+        return target;
+    }
+    throw new Error(`no ${BIN_NAME} release binary is available for ${dntShim.Deno.build.target}`);
+}
+function cacheRoot() {
+    const explicit = dntShim.Deno.env.get("TRELLIS_GENERATE_CACHE")?.trim();
+    if (explicit) {
+        return explicit;
+    }
+    const xdg = dntShim.Deno.env.get("XDG_CACHE_HOME")?.trim();
+    if (xdg) {
+        return joinPath(xdg, "trellis", BIN_NAME);
+    }
+    const home = dntShim.Deno.env.get("HOME")?.trim();
+    if (!home) {
+        throw new Error("HOME or TRELLIS_GENERATE_CACHE must be set to cache trellis-generate");
+    }
+    return joinPath(home, ".cache", "trellis", BIN_NAME);
+}
+async function downloadBytes(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`failed to download ${url}: HTTP ${response.status}`);
+    }
+    return new Uint8Array(await response.arrayBuffer());
+}
+async function downloadText(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`failed to download ${url}: HTTP ${response.status}`);
+    }
+    return await response.text();
+}
+async function verifyChecksum(bytes, checksumText, label) {
+    const expected = checksumText.trim().split(/\s+/)[0]?.toLowerCase();
+    if (!expected || !/^[0-9a-f]{64}$/.test(expected)) {
+        throw new Error("release checksum asset did not contain a SHA-256 digest");
+    }
+    const buffer = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(buffer).set(bytes);
+    const digest = await crypto.subtle.digest("SHA-256", buffer);
+    const actual = Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+    if (actual !== expected) {
+        throw new Error(`checksum mismatch for ${label}: expected ${expected}, got ${actual}`);
+    }
+}
+async function verifyBinaryVersion(binary, expectedVersion) {
+    const output = await new dntShim.Deno.Command(binary, {
+        args: ["--version"],
+        stdout: "piped",
+        stderr: "piped",
+    }).output();
+    if (!output.success) {
+        throw new Error(`failed to run ${binary} --version`);
+    }
+    const text = new TextDecoder().decode(output.stdout).trim();
+    const actualVersion = text.split(/\s+/).find((part) => /^v?\d+\.\d+\.\d+/.test(part));
+    if (!actualVersion ||
+        normalizeVersion(actualVersion) !== normalizeVersion(expectedVersion)) {
+        throw new Error(`${binary} is ${text || "unknown version"}; expected ${BIN_NAME} ${expectedVersion}`);
+    }
+}
+function normalizeVersion(version) {
+    return version.trim().replace(/^v/, "").split("+")[0];
+}
+async function runBinary(binary, args) {
+    return await runCommand(binary, args);
+}
+async function runCommand(command, args, options = {}) {
+    const status = await spawnCommand(command, args, options);
+    dntShim.Deno.exit(status.code);
+}
+async function runCommandChecked(command, args, options = {}) {
+    const status = await spawnCommand(command, args, options);
+    if (!status.success) {
+        throw new Error(`${command} failed with exit code ${status.code}`);
+    }
+}
+async function spawnCommand(command, args, options = {}) {
+    const status = await new dntShim.Deno.Command(command, {
+        args,
+        cwd: options.cwd,
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+    }).spawn().status;
+    return status;
+}
+async function pathExists(path) {
+    try {
+        await dntShim.Deno.stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.NotFound) {
+            return false;
+        }
+        throw error;
+    }
+}
+function urlDirname(url) {
+    return dirname(decodeURIComponent(new URL(url).pathname));
+}
+function dirname(path) {
+    const normalized = path.replace(/\/+$/, "");
+    const index = normalized.lastIndexOf("/");
+    if (index <= 0) {
+        return "/";
+    }
+    return normalized.slice(0, index);
+}
+function joinPath(...parts) {
+    return parts
+        .filter((part) => part.length > 0)
+        .join("/")
+        .replace(/\/+/g, "/");
+}
+if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
+    main().catch((error) => {
+        console.error(error);
+        dntShim.Deno.exit(1);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlever-llc/trellis",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Client-side Trellis runtime, models, and contract helpers for TypeScript applications.",
   "homepage": "https://github.com/Qlever-LLC/trellis#readme",
   "repository": {
@@ -119,10 +119,13 @@
     "ts-deepmerge": "^7.0.3",
     "typebox": "^1.0.15",
     "ulid": "^3.0.1",
-    "@qlever-llc/result": "^0.8.2"
+    "@qlever-llc/result": "^0.8.4"
   },
   "devDependencies": {
     "@types/node": "^20.9.0"
   },
-  "_generatedBy": "dnt@dev"
+  "_generatedBy": "dnt@dev",
+  "bin": {
+    "trellis-generate": "./bin/trellis-generate.js"
+  }
 }

package/script/npm/src/_dnt.polyfills.d.ts

@@ -15,4 +15,103 @@ declare global {
     }
 }
 export {};
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+import { createRequire } from "node:module";
+import { type URL } from "node:url";
+declare global {
+    interface ImportMeta {
+        /** A string representation of the fully qualified module URL. When the
+         * module is loaded locally, the value will be a file URL (e.g.
+         * `file:///path/module.ts`).
+         *
+         * You can also parse the string as a URL to determine more information about
+         * how the current module was loaded. For example to determine if a module was
+         * local or not:
+         *
+         * ```ts
+         * const url = new URL(import.meta.url);
+         * if (url.protocol === "file:") {
+         *   console.log("this module was loaded locally");
+         * }
+         * ```
+         */
+        url: string;
+        /**
+         * A function that returns resolved specifier as if it would be imported
+         * using `import(specifier)`.
+         *
+         * ```ts
+         * console.log(import.meta.resolve("./foo.js"));
+         * // file:///dev/foo.js
+         * ```
+         *
+         * @param specifier The module specifier to resolve relative to `parent`.
+         * @param parent The absolute parent module URL to resolve from.
+         * @returns The absolute (`file:`) URL string for the resolved module.
+         */
+        resolve(specifier: string, parent?: string | URL | undefined): string;
+        /** A flag that indicates if the current module is the main module that was
+         * called when starting the program under Deno.
+         *
+         * ```ts
+         * if (import.meta.main) {
+         *   // this was loaded as the main module, maybe do some bootstrapping
+         * }
+         * ```
+         */
+        main: boolean;
+        /** The absolute path of the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.filename); // /home/alice/my_module.ts
+         *
+         * // Windows
+         * console.log(import.meta.filename); // C:\alice\my_module.ts
+         * ```
+         */
+        filename: string;
+        /** The absolute path of the directory containing the current module.
+         *
+         * This property is only provided for local modules (ie. using `file://` URLs).
+         *
+         * * Example:
+         * ```
+         * // Unix
+         * console.log(import.meta.dirname); // /home/alice
+         *
+         * // Windows
+         * console.log(import.meta.dirname); // C:\alice
+         * ```
+         */
+        dirname: string;
+    }
+}
+type NodeRequest = ReturnType<typeof createRequire>;
+type NodeModule = NonNullable<NodeRequest["main"]>;
+interface ImportMetaPonyfillCommonjs {
+    (require: NodeRequest, module: NodeModule): ImportMeta;
+}
+interface ImportMetaPonyfillEsmodule {
+    (importMeta: ImportMeta): ImportMeta;
+}
+interface ImportMetaPonyfill extends ImportMetaPonyfillCommonjs, ImportMetaPonyfillEsmodule {
+}
+export declare let import_meta_ponyfill_commonjs: ImportMetaPonyfillCommonjs;
+export declare let import_meta_ponyfill_esmodule: ImportMetaPonyfillEsmodule;
+export declare let import_meta_ponyfill: ImportMetaPonyfill;
 //# sourceMappingURL=_dnt.polyfills.d.ts.map

package/script/npm/src/_dnt.polyfills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../../../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC;AAgBV,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../../../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC;AAgBV,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC;AACV;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB;;;;;;;;;;;;;;WAcG;QACH,GAAG,EAAE,MAAM,CAAC;QACZ;;;;;;;;;;;;WAYG;QACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,MAAM,CAAC;QACtE;;;;;;;;WAQG;QACH,IAAI,EAAE,OAAO,CAAC;QAEd;;;;;;;;;;;;WAYG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;;;;;;;;;WAYG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB;CACF;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,UAAU,0BAA0B;IAClC,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;CACxD;AACD,UAAU,0BAA0B;IAClC,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AACD,UAAU,kBACR,SAAQ,0BAA0B,EAAE,0BAA0B;CAC/D;AAiBD,eAAO,IAAI,6BAA6B,EA2BnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,6BAA6B,EA4DnC,0BAA0B,CAAC;AAMhC,eAAO,IAAI,oBAAoB,EAoB1B,kBAAkB,CAAC"}

package/script/npm/src/_dnt.polyfills.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.import_meta_ponyfill = exports.import_meta_ponyfill_esmodule = exports.import_meta_ponyfill_commonjs = void 0;
 // https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
 if (!Object.hasOwn) {
     Object.defineProperty(Object, "hasOwn", {
@@ -14,3 +15,130 @@ if (!Object.hasOwn) {
         writable: true,
     });
 }
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+const node_module_1 = require("node:module");
+//@ts-ignore
+const node_url_1 = require("node:url");
+//@ts-ignore
+const node_path_1 = require("node:path");
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+exports.import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: (0, node_url_1.pathToFileURL)(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return (0, node_url_1.pathToFileURL)((importMeta.url === parentURL
+                            ? require
+                            : (0, node_module_1.createRequire)(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", exports.import_meta_ponyfill_commonjs);
+exports.import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = (0, node_url_1.fileURLToPath)(importMeta.url);
+                importMeta.dirname = (0, node_path_1.dirname)(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            exports.import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: (0, node_module_1.createRequire)(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return (0, node_url_1.pathToFileURL)((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : (0, node_module_1.createRequire)(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            exports.import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return (0, exports.import_meta_ponyfill_esmodule)(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", exports.import_meta_ponyfill_esmodule);
+exports.import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        exports.import_meta_ponyfill = (r, m) => (0, exports.import_meta_ponyfill_commonjs)(r, m);
+    }
+    else {
+        //@ts-ignore
+        exports.import_meta_ponyfill = (im) => (0, exports.import_meta_ponyfill_esmodule)(im);
+    }
+    //@ts-ignore
+    return (0, exports.import_meta_ponyfill)(...args);
+});

package/script/npm/src/generate.d.ts

@@ -0,0 +1,2 @@
+import "./_dnt.polyfills.js";
+//# sourceMappingURL=generate.d.ts.map

package/script/npm/src/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC"}

package/script/npm/src/generate.js

@@ -0,0 +1,269 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./_dnt.polyfills.js");
+const dntShim = __importStar(require("./_dnt.shims.js"));
+const REPO_OWNER = "qlever-llc";
+const REPO_NAME = "trellis";
+const BIN_NAME = "trellis-generate";
+const SUPPORTED_TARGETS = new Set([
+    "x86_64-unknown-linux-gnu",
+    "aarch64-unknown-linux-gnu",
+    "x86_64-apple-darwin",
+    "aarch64-apple-darwin",
+]);
+async function main() {
+    const localRepoRoot = await findLocalTrellisRepoRoot();
+    if (localRepoRoot) {
+        await runLocalGenerator(localRepoRoot, dntShim.Deno.args);
+        return;
+    }
+    const packageVersion = await readPackageVersion();
+    const binary = dntShim.Deno.env.get("TRELLIS_GENERATE_BIN")?.trim() ||
+        await ensureCachedReleaseBinary(packageVersion);
+    await verifyBinaryVersion(binary, packageVersion);
+    await runBinary(binary, dntShim.Deno.args);
+}
+async function findLocalTrellisRepoRoot() {
+    let current = urlDirname(globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url);
+    while (current !== dirname(current)) {
+        if (await pathExists(joinPath(current, "rust/tools/generate/Cargo.toml")) &&
+            await pathExists(joinPath(current, "js/deno.json"))) {
+            return current;
+        }
+        current = dirname(current);
+    }
+    return undefined;
+}
+async function runLocalGenerator(repoRoot, args) {
+    return await runCommand("cargo", [
+        "run",
+        "--manifest-path",
+        joinPath(repoRoot, "rust/tools/generate/Cargo.toml"),
+        "--bin",
+        BIN_NAME,
+        "--",
+        ...args,
+    ]);
+}
+async function readPackageVersion() {
+    const manifest = await readFirstManifest([
+        new URL("./deno.json", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url),
+        new URL("../package.json", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url),
+        new URL("../../../package.json", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url),
+    ]);
+    if (typeof manifest.version !== "string" || !manifest.version.trim()) {
+        throw new Error("@qlever-llc/trellis package manifest does not declare a version");
+    }
+    return manifest.version.trim();
+}
+async function readFirstManifest(urls) {
+    for (const url of urls) {
+        try {
+            return JSON.parse(await dntShim.Deno.readTextFile(url));
+        }
+        catch (error) {
+            if (error instanceof dntShim.Deno.errors.NotFound) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw new Error("could not find @qlever-llc/trellis package manifest");
+}
+async function ensureCachedReleaseBinary(version) {
+    const target = releaseTarget();
+    const cacheDir = joinPath(cacheRoot(), version, target);
+    const binary = joinPath(cacheDir, BIN_NAME);
+    if (await pathExists(binary)) {
+        return binary;
+    }
+    await dntShim.Deno.mkdir(cacheDir, { recursive: true });
+    const tag = `v${version}`;
+    const archiveName = `${BIN_NAME}-${tag}-${target}.tar.gz`;
+    const archiveUrl = `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/${tag}/${archiveName}`;
+    const checksumName = `checksum-${tag}-${target}-${BIN_NAME}.sha256`;
+    const checksumUrl = `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/${tag}/${checksumName}`;
+    const [archive, checksumText] = await Promise.all([
+        downloadBytes(archiveUrl),
+        downloadText(checksumUrl),
+    ]);
+    await verifyChecksum(archive, checksumText, archiveUrl);
+    const archivePath = joinPath(cacheDir, archiveName);
+    await dntShim.Deno.writeFile(archivePath, archive);
+    await runCommandChecked("tar", ["-xzf", archivePath, "-C", cacheDir]);
+    await dntShim.Deno.chmod(binary, 0o755);
+    return binary;
+}
+function releaseTarget() {
+    if (SUPPORTED_TARGETS.has(dntShim.Deno.build.target)) {
+        return dntShim.Deno.build.target;
+    }
+    const buildArch = dntShim.Deno.build.arch;
+    const arch = buildArch === "x86_64" || buildArch === "x64"
+        ? "x86_64"
+        : buildArch;
+    const os = dntShim.Deno.build.os === "darwin"
+        ? "apple-darwin"
+        : dntShim.Deno.build.os === "linux"
+            ? "unknown-linux-gnu"
+            : undefined;
+    const target = os ? `${arch}-${os}` : undefined;
+    if (target && SUPPORTED_TARGETS.has(target)) {
+        return target;
+    }
+    throw new Error(`no ${BIN_NAME} release binary is available for ${dntShim.Deno.build.target}`);
+}
+function cacheRoot() {
+    const explicit = dntShim.Deno.env.get("TRELLIS_GENERATE_CACHE")?.trim();
+    if (explicit) {
+        return explicit;
+    }
+    const xdg = dntShim.Deno.env.get("XDG_CACHE_HOME")?.trim();
+    if (xdg) {
+        return joinPath(xdg, "trellis", BIN_NAME);
+    }
+    const home = dntShim.Deno.env.get("HOME")?.trim();
+    if (!home) {
+        throw new Error("HOME or TRELLIS_GENERATE_CACHE must be set to cache trellis-generate");
+    }
+    return joinPath(home, ".cache", "trellis", BIN_NAME);
+}
+async function downloadBytes(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`failed to download ${url}: HTTP ${response.status}`);
+    }
+    return new Uint8Array(await response.arrayBuffer());
+}
+async function downloadText(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`failed to download ${url}: HTTP ${response.status}`);
+    }
+    return await response.text();
+}
+async function verifyChecksum(bytes, checksumText, label) {
+    const expected = checksumText.trim().split(/\s+/)[0]?.toLowerCase();
+    if (!expected || !/^[0-9a-f]{64}$/.test(expected)) {
+        throw new Error("release checksum asset did not contain a SHA-256 digest");
+    }
+    const buffer = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(buffer).set(bytes);
+    const digest = await crypto.subtle.digest("SHA-256", buffer);
+    const actual = Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+    if (actual !== expected) {
+        throw new Error(`checksum mismatch for ${label}: expected ${expected}, got ${actual}`);
+    }
+}
+async function verifyBinaryVersion(binary, expectedVersion) {
+    const output = await new dntShim.Deno.Command(binary, {
+        args: ["--version"],
+        stdout: "piped",
+        stderr: "piped",
+    }).output();
+    if (!output.success) {
+        throw new Error(`failed to run ${binary} --version`);
+    }
+    const text = new TextDecoder().decode(output.stdout).trim();
+    const actualVersion = text.split(/\s+/).find((part) => /^v?\d+\.\d+\.\d+/.test(part));
+    if (!actualVersion ||
+        normalizeVersion(actualVersion) !== normalizeVersion(expectedVersion)) {
+        throw new Error(`${binary} is ${text || "unknown version"}; expected ${BIN_NAME} ${expectedVersion}`);
+    }
+}
+function normalizeVersion(version) {
+    return version.trim().replace(/^v/, "").split("+")[0];
+}
+async function runBinary(binary, args) {
+    return await runCommand(binary, args);
+}
+async function runCommand(command, args, options = {}) {
+    const status = await spawnCommand(command, args, options);
+    dntShim.Deno.exit(status.code);
+}
+async function runCommandChecked(command, args, options = {}) {
+    const status = await spawnCommand(command, args, options);
+    if (!status.success) {
+        throw new Error(`${command} failed with exit code ${status.code}`);
+    }
+}
+async function spawnCommand(command, args, options = {}) {
+    const status = await new dntShim.Deno.Command(command, {
+        args,
+        cwd: options.cwd,
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+    }).spawn().status;
+    return status;
+}
+async function pathExists(path) {
+    try {
+        await dntShim.Deno.stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof dntShim.Deno.errors.NotFound) {
+            return false;
+        }
+        throw error;
+    }
+}
+function urlDirname(url) {
+    return dirname(decodeURIComponent(new URL(url).pathname));
+}
+function dirname(path) {
+    const normalized = path.replace(/\/+$/, "");
+    const index = normalized.lastIndexOf("/");
+    if (index <= 0) {
+        return "/";
+    }
+    return normalized.slice(0, index);
+}
+function joinPath(...parts) {
+    return parts
+        .filter((part) => part.length > 0)
+        .join("/")
+        .replace(/\/+/g, "/");
+}
+if (globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).main) {
+    main().catch((error) => {
+        console.error(error);
+        dntShim.Deno.exit(1);
+    });
+}