@hotbunny/hackhub-content-sdk 0.4.0 → 0.5.0

package/build.mjs

@@ -0,0 +1,96 @@
+import fs from "node:fs";
+import path from "node:path";
+
+function copyDirSync(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirSync(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+
+function prepareDist() {
+    fs.mkdirSync("dist", { recursive: true });
+    if (fs.existsSync("manifest.json")) {
+        fs.copyFileSync("manifest.json", path.join("dist", "manifest.json"));
+    }
+    if (fs.existsSync("public")) {
+        copyDirSync("public", "dist");
+    }
+}
+
+/**
+ * esbuild plugin: scans HTML files for local asset references
+ * (script src, link href, img src) and copies them into dist/.
+ */
+export function htmlAssetsPlugin() {
+    const assetPattern = /(?:src|href)\s*=\s*["'](\.[^"']+)["']/g;
+
+    return {
+        name: "html-assets",
+        setup(build) {
+            build.onLoad({ filter: /\.html$/ }, (args) => {
+                const html = fs.readFileSync(args.path, "utf-8");
+                const htmlDir = path.dirname(args.path);
+                let match;
+
+                while ((match = assetPattern.exec(html)) !== null) {
+                    const ref = match[1];
+                    if (ref.startsWith("./") || !ref.startsWith("/")) {
+                        const absPath = path.resolve(htmlDir, ref);
+                        if (fs.existsSync(absPath)) {
+                            const rel = ref.startsWith("./") ? ref.slice(2) : ref;
+                            const dest = path.join("dist", rel);
+                            fs.mkdirSync(path.dirname(dest), { recursive: true });
+                            fs.copyFileSync(absPath, dest);
+                        }
+                    }
+                }
+
+                return { contents: html, loader: "text" };
+            });
+        },
+    };
+}
+
+/**
+ * Builds a HackHub mod project.
+ * Call this from your esbuild.config.ts — all build logic is handled here.
+ *
+ * @param {object} [options]
+ * @param {string} [options.entryPoint] - Entry file (default: "src/index.ts")
+ * @param {string} [options.outfile]    - Output file (default: "dist/mod.js")
+ * @param {import("esbuild").Plugin[]} [options.plugins] - Extra esbuild plugins
+ */
+export async function buildMod(options = {}) {
+    const esbuild = await import("esbuild");
+    const isWatch = process.argv.includes("--watch");
+
+    prepareDist();
+
+    const config = {
+        entryPoints: [options.entryPoint || "src/index.ts"],
+        bundle: true,
+        outfile: options.outfile || "dist/mod.js",
+        format: "cjs",
+        platform: "neutral",
+        target: "es2020",
+        external: ["@hotbunny/hackhub-content-sdk"],
+        loader: { ".html": "text" },
+        plugins: [htmlAssetsPlugin(), ...(options.plugins || [])],
+    };
+
+    if (isWatch) {
+        const ctx = await esbuild.context(config);
+        await ctx.watch();
+        console.log("Watching for changes...");
+    } else {
+        await esbuild.build(config);
+        console.log("Build complete: " + config.outfile);
+    }
+}

package/index.d.ts

@@ -937,17 +937,17 @@ export declare abstract class Quest {
  * }
  * ```
  *
- * In your HTML, access exported functions via `window.ModExports`:
+ * In your HTML, exported functions are available as globals:
  * ```html
  * <script>
- *   const formatted = window.ModExports.formatPost("hello");
+ *   const formatted = formatPost("hello");
  * </script>
  * ```
  *
- * SDK APIs are available via `window.HackhubSDK`:
+ * SDK APIs are available via the `HackhubSDK` global:
  * ```html
  * <script>
- *   window.HackhubSDK.Mail.send({ to: "user@mail.com", subject: "Hi" });
+ *   HackhubSDK.Mail.send({ to: "user@mail.com", subject: "Hi" });
  * </script>
  * ```
  */
@@ -958,8 +958,9 @@ export declare abstract class Website {
 	abstract Pages: WebsitePageDefinition[];
 	Popular?: boolean;
 	/**
-	 * Functions/values exposed to all pages' HTML via `window.ModExports`.
-	 * Use this to bridge your TypeScript logic with the iframe UI.
+	 * Functions/values exposed to all pages' HTML as globals.
+	 * Each key becomes directly callable in your HTML scripts (e.g. `formatPost("hello")`).
+	 * Also accessible via the `ModExports` namespace.
 	 */
 	Exports?: Record<string, any>;
 }
@@ -1030,18 +1031,18 @@ export declare abstract class Command {
  * }
  * ```
  *
- * In your HTML, access exported functions via `window.ModExports`:
+ * In your HTML, exported functions are available as globals:
  * ```html
  * <script>
- *   const pw = window.ModExports.generate(16);
+ *   const pw = generate(16);
  *   document.getElementById("result").textContent = pw;
  * </script>
  * ```
  *
- * SDK APIs are available via `window.HackhubSDK`:
+ * SDK APIs are available via the `HackhubSDK` global:
  * ```html
  * <script>
- *   window.HackhubSDK.Events.emit("PasswordGenerated");
+ *   HackhubSDK.Events.emit("PasswordGenerated");
  * </script>
  * ```
  */
@@ -1061,8 +1062,9 @@ export declare abstract class App {
 	/** If true, the app is unlocked in the AppStore by default (no quest required). */
 	Unlocked?: boolean;
 	/**
-	 * Functions/values exposed to the app's HTML via `window.ModExports`.
-	 * Use this to bridge your TypeScript logic with the iframe UI.
+	 * Functions/values exposed to the app's HTML as globals.
+	 * Each key becomes directly callable in your HTML scripts (e.g. `generate(16)`).
+	 * Also accessible via the `ModExports` namespace.
 	 */
 	Exports?: Record<string, any>;
 }

package/package.json

@@ -1,10 +1,19 @@
 {
     "name": "@hotbunny/hackhub-content-sdk",
-    "version": "0.4.0",
-    "description": "Type definitions and API reference for HackHub mod development",
+    "version": "0.5.0",
+    "description": "Type definitions and build tools for HackHub mod development",
     "types": "index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./index.d.ts"
+        },
+        "./build": {
+            "import": "./build.mjs"
+        }
+    },
     "files": [
-        "index.d.ts"
+        "index.d.ts",
+        "build.mjs"
     ],
     "keywords": [
         "hackhub",