@qlever-llc/trellis 0.8.0 → 0.8.3

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,217 @@
+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 manifestUrl = new URL("./deno.json", globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url);
+    const manifest = JSON.parse(await dntShim.Deno.readTextFile(manifestUrl));
+    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 = 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.0",
+  "version": "0.8.3",
   "description": "Client-side Trellis runtime, models, and contract helpers for TypeScript applications.",
   "homepage": "https://github.com/Qlever-LLC/trellis#readme",
   "repository": {
@@ -42,6 +42,10 @@
       "import": "./esm/npm/src/device/deno.js",
       "require": "./script/npm/src/device/deno.js"
     },
+    "./generate": {
+      "import": "./esm/npm/src/generate.js",
+      "require": "./script/npm/src/generate.js"
+    },
     "./health": {
       "import": "./esm/health.js",
       "require": "./script/health.js"
@@ -119,7 +123,7 @@
     "ts-deepmerge": "^7.0.3",
     "typebox": "^1.0.15",
     "ulid": "^3.0.1",
-    "@qlever-llc/result": "^0.8.0"
+    "@qlever-llc/result": "^0.8.3"
   },
   "devDependencies": {
     "@types/node": "^20.9.0"

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,252 @@
+"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 manifestUrl = new URL("./deno.json", globalThis[Symbol.for("import-meta-ponyfill-commonjs")](require, module).url);
+    const manifest = JSON.parse(await dntShim.Deno.readTextFile(manifestUrl));
+    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 = 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);
+    });
+}