From 7aef8d8ed3a6f4e1ec0f4f86bce914e9c2f58bdc Mon Sep 17 00:00:00 2001
From: Nico Verbruggen <mail@nicoverbruggen.be>
Date: Thu, 19 Mar 2026 18:11:49 +0100
Subject: [PATCH] Fix naming consistency in JS, script files

- JavaScript exports have been simplified and renamed
- Certain scripts now reference DIST and SRC folders
- Software URLs are now loaded via the JSON file
---
 .gitignore                                   |   1 -
 README.md                                    |   7 +-
 kobopatch-wasm/build.sh                      |   8 +-
 serve-locally.sh                             |   8 +-
 tests/e2e/playwright.config.js               |   2 +-
 tests/e2e/run-e2e.sh                         |  15 +-
 web/src/index.html                           |   2 +
 web/src/js/app.js                            |  22 +-
 web/src/js/kobo-device.js                    |  51 +-
 web/src/js/kobo-software-urls.js             |  47 ++
 web/src/js/{kobopatch.js => patch-runner.js} |   4 +-
 web/src/js/patch-ui.js                       |   2 +-
 web/src/js/wasm_exec.js                      | 575 -------------------
 web/src/patches/downloads.json               |   8 +
 web/src/wasm/.gitkeep                        |   0
 15 files changed, 102 insertions(+), 650 deletions(-)
 create mode 100644 web/src/js/kobo-software-urls.js
 rename web/src/js/{kobopatch.js => patch-runner.js} (97%)
 delete mode 100644 web/src/js/wasm_exec.js
 create mode 100644 web/src/patches/downloads.json
 delete mode 100644 web/src/wasm/.gitkeep

diff --git a/.gitignore b/.gitignore
index bab7578..822b353 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,7 +12,6 @@ kobopatch-wasm/kobopatch.wasm
 kobopatch-wasm/wasm_exec.js
 
 # Generated files in src (written by build scripts, regenerated on demand)
-web/src/wasm/kobopatch.wasm
 web/src/js/wasm_exec.js
 web/src/nickelmenu/NickelMenu.zip
 web/src/nickelmenu/kobo-config.zip
diff --git a/README.md b/README.md
index ce694f4..8f5565c 100644
--- a/README.md
+++ b/README.md
@@ -41,10 +41,11 @@ web/
       style.css
     js/
       app.js                    # ES module entry point: step navigation, flow orchestration
-      kobo-device.js            # KOBO_MODELS, FIRMWARE_DOWNLOADS, KoboDevice class
+      kobo-device.js            # KoboModels, KoboDevice class
+      kobo-software-urls.js     # KoboSoftwareUrls, getSoftwareUrl, getDevicesForVersion
       nickelmenu.js             # NickelMenuInstaller: downloads/bundles NickelMenu + config
       patch-ui.js               # PatchUI: loads patches, parses YAML, renders toggle UI
-      kobopatch.js              # KobopatchRunner: spawns Web Worker per build
+      patch-runner.js           # KoboPatchRunner: spawns Web Worker per build
       patch-worker.js           # Web Worker: loads WASM, runs patchFirmware()
       wasm_exec.js              # Go WASM runtime (generated by build.sh, gitignored)
     wasm/
@@ -84,7 +85,7 @@ tests/
 ## Adding a new software version
 
 1. Add the patch zip to `web/src/patches/` and update `index.json`
-2. Add download URLs to `FIRMWARE_DOWNLOADS` in `web/src/js/kobo-device.js` (keyed by version then serial prefix)
+2. Add download URLs to `KoboSoftwareUrls` in `web/src/js/kobo-software-urls.js` (keyed by version then serial prefix)
 3. The Kobo CDN prefix per device family (e.g. `kobo12`, `kobo13`) is stable; the date path segment changes per release
 
 ## Building the WASM binary
diff --git a/kobopatch-wasm/build.sh b/kobopatch-wasm/build.sh
index 52fcb19..6e021de 100755
--- a/kobopatch-wasm/build.sh
+++ b/kobopatch-wasm/build.sh
@@ -2,6 +2,9 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+WEB_DIR="$SCRIPT_DIR/../web"
+SRC_DIR="$WEB_DIR/src"
+DIST_DIR="$WEB_DIR/dist"
 
 if [ ! -d "$SCRIPT_DIR/kobopatch-src" ]; then
     echo "Error: kobopatch source not found. Run ./setup.sh first."
@@ -15,7 +18,8 @@ GOOS=js GOARCH=wasm go build -o kobopatch.wasm .
 echo "WASM binary size: $(du -h kobopatch.wasm | cut -f1)"
 
 echo "Copying artifacts..."
-cp kobopatch.wasm "$SCRIPT_DIR/../web/src/wasm/kobopatch.wasm"
-cp wasm_exec.js "$SCRIPT_DIR/../web/src/js/wasm_exec.js"
+mkdir -p "$DIST_DIR/wasm"
+cp kobopatch.wasm "$DIST_DIR/wasm/kobopatch.wasm"
+cp wasm_exec.js "$SRC_DIR/js/wasm_exec.js"
 
 echo "Done."
diff --git a/serve-locally.sh b/serve-locally.sh
index 5bd8737..4344740 100755
--- a/serve-locally.sh
+++ b/serve-locally.sh
@@ -2,16 +2,18 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+WEB_DIR="$SCRIPT_DIR/web"
+SRC_DIR="$WEB_DIR/src"
+DIST_DIR="$WEB_DIR/dist"
 WASM_DIR="$SCRIPT_DIR/kobopatch-wasm"
-DIST_DIR="$SCRIPT_DIR/web/dist"
 
-if [ ! -f "$DIST_DIR/nickelmenu/NickelMenu.zip" ]; then
+if [ ! -f "$SRC_DIR/nickelmenu/NickelMenu.zip" ]; then
     echo "NickelMenu assets not found, downloading..."
     "$SCRIPT_DIR/nickelmenu/setup.sh"
 fi
 
 echo "Building JS bundle..."
-cd "$SCRIPT_DIR/web"
+cd "$WEB_DIR"
 npm install --silent
 npm run build
 
diff --git a/tests/e2e/playwright.config.js b/tests/e2e/playwright.config.js
index 36329e6..a5d2621 100644
--- a/tests/e2e/playwright.config.js
+++ b/tests/e2e/playwright.config.js
@@ -17,7 +17,7 @@ module.exports = defineConfig({
     },
   },
   webServer: {
-    command: 'cd ../../kobopatch-wasm && bash build.sh && cd ../web && node build.mjs && python3 -m http.server -d dist 8889',
+    command: 'cd ../../web && node build.mjs && cd ../kobopatch-wasm && bash build.sh && cd ../web && python3 -m http.server -d dist 8889',
     port: 8889,
     reuseExistingServer: true,
   },
diff --git a/tests/e2e/run-e2e.sh b/tests/e2e/run-e2e.sh
index b4dd261..3373a12 100755
--- a/tests/e2e/run-e2e.sh
+++ b/tests/e2e/run-e2e.sh
@@ -16,6 +16,11 @@ set -euo pipefail
 
 cd "$(dirname "$0")"
 
+PROJECT_ROOT="$(cd ../.. && pwd)"
+WEB_DIR="$PROJECT_ROOT/web"
+SRC_DIR="$WEB_DIR/src"
+DIST_DIR="$WEB_DIR/dist"
+
 PLAYWRIGHT_ARGS=("--reporter=list")
 
 while [[ $# -gt 0 ]]; do
@@ -42,20 +47,20 @@ done
 
 FIRMWARE_VERSION="4.45.23646"
 FIRMWARE_URL="https://ereaderfiles.kobo.com/firmwares/kobo13/Mar2026/kobo-update-${FIRMWARE_VERSION}.zip"
-FIRMWARE_DIR="../../kobopatch-wasm/testdata"
+FIRMWARE_DIR="$PROJECT_ROOT/kobopatch-wasm/testdata"
 FIRMWARE_FILE="${FIRMWARE_DIR}/kobo-update-${FIRMWARE_VERSION}.zip"
 
 # Check WASM is built.
-if [ ! -f "../../web/dist/wasm/kobopatch.wasm" ]; then
+if [ ! -f "$DIST_DIR/wasm/kobopatch.wasm" ]; then
     echo "ERROR: kobopatch.wasm not found. Run kobopatch-wasm/build.sh first."
     exit 1
 fi
 
 # Set up NickelMenu assets if not present.
-NM_DIR="../../web/src/nickelmenu"
+NM_DIR="$SRC_DIR/nickelmenu"
 if [ ! -f "$NM_DIR/NickelMenu.zip" ] || [ ! -f "$NM_DIR/kobo-config.zip" ]; then
     echo "Setting up NickelMenu assets..."
-    ../../nickelmenu/setup.sh
+    "$PROJECT_ROOT/nickelmenu/setup.sh"
 fi
 
 # Download firmware if not cached.
@@ -80,5 +85,5 @@ npx playwright install chromium
 
 # Run the tests.
 echo "Running E2E integration tests..."
-FIRMWARE_ZIP="$(cd ../.. && pwd)/kobopatch-wasm/testdata/kobo-update-${FIRMWARE_VERSION}.zip" \
+FIRMWARE_ZIP="$FIRMWARE_FILE" \
     npx playwright test "${PLAYWRIGHT_ARGS[@]}"
diff --git a/web/src/index.html b/web/src/index.html
index f50e85b..41e8cb8 100644
--- a/web/src/index.html
+++ b/web/src/index.html
@@ -12,6 +12,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Google+Sans:ital,opsz,wght@0,17..18,400..700;1,17..18,400..700&display=swap" rel="stylesheet">
+    <link rel="preload" href="/patches/downloads.json" as="fetch" crossorigin>
+    <link rel="preload" href="/patches/index.json" as="fetch" crossorigin>
 
     <!-- Inline critical styles so the hero + loader render before style.css arrives on slow connections -->
     <style>
diff --git a/web/src/js/app.js b/web/src/js/app.js
index 4839092..b295e1d 100644
--- a/web/src/js/app.js
+++ b/web/src/js/app.js
@@ -1,13 +1,14 @@
-import { KoboDevice, KOBO_MODELS, getFirmwareURL, getDevicesForVersion } from './kobo-device.js';
+import { KoboDevice, KoboModels } from './kobo-device.js';
+import { loadSoftwareUrls, getSoftwareUrl, getDevicesForVersion } from './kobo-software-urls.js';
 import { PatchUI, scanAvailablePatches } from './patch-ui.js';
-import { KobopatchRunner } from './kobopatch.js';
+import { KoboPatchRunner } from './patch-runner.js';
 import { NickelMenuInstaller } from './nickelmenu.js';
 import JSZip from 'jszip';
 
 (() => {
     const device = new KoboDevice();
     const patchUI = new PatchUI();
-    const runner = new KobopatchRunner();
+    const runner = new KoboPatchRunner();
     const nmInstaller = new NickelMenuInstaller();
 
     let firmwareURL = null;
@@ -21,7 +22,8 @@ import JSZip from 'jszip';
     let selectedMode = null;        // 'nickelmenu' | 'patches'
     let nickelMenuOption = null;    // 'sample' | 'nickelmenu-only' | 'remove'
 
-    // Fetch patch index immediately so it's ready when needed.
+    // Fetch data eagerly so it's ready when needed.
+    const softwareUrlsReady = loadSoftwareUrls();
     const availablePatchesReady = scanAvailablePatches().then(p => { availablePatches = p; });
 
     // --- Helpers ---
@@ -196,9 +198,9 @@ import JSZip from 'jszip';
 
     // --- Firmware step config ---
     function configureFirmwareStep(version, prefix) {
-        firmwareURL = prefix ? getFirmwareURL(prefix, version) : null;
+        firmwareURL = prefix ? getSoftwareUrl(prefix, version) : null;
         firmwareVersionLabel.textContent = version;
-        firmwareDeviceLabel.textContent = KOBO_MODELS[prefix] || prefix;
+        firmwareDeviceLabel.textContent = KoboModels[prefix] || prefix;
         $('firmware-download-url').textContent = firmwareURL || '';
     }
 
@@ -304,7 +306,7 @@ import JSZip from 'jszip';
 
             selectedPrefix = info.serialPrefix;
 
-            await availablePatchesReady;
+            await Promise.all([softwareUrlsReady, availablePatchesReady]);
             const match = availablePatches.find(p => p.version === info.firmware);
 
             configureFirmwareStep(info.firmware, info.serialPrefix);
@@ -426,7 +428,7 @@ import JSZip from 'jszip';
 
     // --- Manual version/model selection (only for custom patches in manual mode) ---
     async function enterManualVersionSelection() {
-        await availablePatchesReady;
+        await Promise.all([softwareUrlsReady, availablePatchesReady]);
         populateSelect(manualVersion, '-- Select software version --',
             availablePatches.map(p => ({ value: p.version, text: p.version, data: { filename: p.filename } }))
         );
@@ -769,7 +771,7 @@ import JSZip from 'jszip';
     function showBuildResult() {
         const action = isRestore ? 'Software extracted' : 'Patching complete';
         const description = isRestore ? 'This will restore the original unpatched software.' : '';
-        const deviceName = KOBO_MODELS[selectedPrefix] || 'Kobo';
+        const deviceName = KoboModels[selectedPrefix] || 'Kobo';
         const installHint = manualMode
             ? 'Download the file and copy it to your ' + deviceName + '.'
             : 'Write it directly to your connected Kobo, or download for manual installation.';
@@ -868,7 +870,7 @@ import JSZip from 'jszip';
         triggerDownload(resultTgz, 'KoboRoot.tgz', 'application/gzip');
         writeInstructions.hidden = true;
         downloadInstructions.hidden = false;
-        $('download-device-name').textContent = KOBO_MODELS[selectedPrefix] || 'Kobo';
+        $('download-device-name').textContent = KoboModels[selectedPrefix] || 'Kobo';
     });
 
     // --- Error / Retry ---
diff --git a/web/src/js/kobo-device.js b/web/src/js/kobo-device.js
index 8e13e32..e5f5c9f 100644
--- a/web/src/js/kobo-device.js
+++ b/web/src/js/kobo-device.js
@@ -3,7 +3,7 @@
  * Source: https://help.kobo.com/hc/en-us/articles/360019676973
  * The serial number prefix (first 3-4 characters) identifies the model.
  */
-const KOBO_MODELS = {
+const KoboModels = {
     // Current eReaders
     'N428': 'Kobo Libra Colour',
     'N367': 'Kobo Clara Colour',
@@ -36,48 +36,6 @@ const KOBO_MODELS = {
     'N204': 'Kobo Aura HD',
 };
 
-/**
- * Firmware download URLs by version and serial prefix.
- * Source: https://help.kobo.com/hc/en-us/articles/35059171032727
- *
- * The kobo prefix (kobo12, kobo13, kobo14) is stable per device family.
- * The date path segment (e.g. Mar2026) changes per release.
- * help.kobo.com may lag behind; verify URLs when adding new versions.
- */
-var FIRMWARE_DOWNLOADS = {
-    '4.45.23646': {
-        'N428': 'https://ereaderfiles.kobo.com/firmwares/kobo13/Mar2026/kobo-update-4.45.23646.zip',
-        'N365': 'https://ereaderfiles.kobo.com/firmwares/kobo12/Mar2026/kobo-update-4.45.23646.zip',
-        'N367': 'https://ereaderfiles.kobo.com/firmwares/kobo12/Mar2026/kobo-update-4.45.23646.zip',
-        'P365': 'https://ereaderfiles.kobo.com/firmwares/kobo14/Mar2026/kobo-update-4.45.23646.zip',
-    },
-};
-
-/**
- * Get the firmware download URL for a given serial prefix and firmware version.
- * Returns null if no URL is available.
- */
-function getFirmwareURL(serialPrefix, version) {
-    const versionMap = FIRMWARE_DOWNLOADS[version];
-    if (!versionMap) return null;
-    return versionMap[serialPrefix] || null;
-}
-
-/**
- * Get all device models that have firmware downloads for a given version.
- * Returns array of { prefix, model } objects.
- */
-function getDevicesForVersion(version) {
-    const versionMap = FIRMWARE_DOWNLOADS[version];
-    if (!versionMap) return [];
-    const devices = [];
-    for (const prefix of Object.keys(versionMap)) {
-        const model = KOBO_MODELS[prefix] || 'Unknown';
-        devices.push({ prefix, model: model + ' (' + prefix + ')' });
-    }
-    return devices;
-}
-
 class KoboDevice {
     constructor() {
         this.directoryHandle = null;
@@ -144,10 +102,10 @@ class KoboDevice {
         const hardwareId = parts[5];
 
         // Try matching 4-char prefix first, then 3-char for models like N204B
-        const serialPrefix = KOBO_MODELS[serial.substring(0, 4)]
+        const serialPrefix = KoboModels[serial.substring(0, 4)]
             ? serial.substring(0, 4)
             : serial.substring(0, 3);
-        const model = KOBO_MODELS[serialPrefix] || 'Unknown Kobo (' + serial.substring(0, 4) + ')';
+        const model = KoboModels[serialPrefix] || 'Unknown Kobo (' + serial.substring(0, 4) + ')';
         const fwParts = firmware.split('.');
         const fwMajor = parseInt(fwParts[0], 10) || 0;
         const fwMinor = parseInt(fwParts[1], 10) || 0;
@@ -220,6 +178,5 @@ class KoboDevice {
 
 // Expose on window for E2E test compatibility (tests access these via page.evaluate)
 window.KoboDevice = KoboDevice;
-window.FIRMWARE_DOWNLOADS = FIRMWARE_DOWNLOADS;
 
-export { KOBO_MODELS, FIRMWARE_DOWNLOADS, getFirmwareURL, getDevicesForVersion, KoboDevice };
+export { KoboModels, KoboDevice };
diff --git a/web/src/js/kobo-software-urls.js b/web/src/js/kobo-software-urls.js
new file mode 100644
index 0000000..559b10f
--- /dev/null
+++ b/web/src/js/kobo-software-urls.js
@@ -0,0 +1,47 @@
+import { KoboModels } from './kobo-device.js';
+
+let _data = null;
+
+/**
+ * Load software download URLs from the JSON manifest.
+ * Can be called multiple times — subsequent calls return cached data.
+ */
+async function loadSoftwareUrls() {
+    if (_data) return _data;
+    const resp = await fetch('/patches/downloads.json');
+    if (!resp.ok) throw new Error('Failed to load download URLs');
+    _data = await resp.json();
+    window.FIRMWARE_DOWNLOADS = _data;
+    return _data;
+}
+
+/**
+ * Get the firmware download URL for a given serial prefix and firmware version.
+ * Returns null if no URL is available.
+ */
+function getSoftwareUrl(serialPrefix, version) {
+    const data = _data || window.FIRMWARE_DOWNLOADS;
+    if (!data) return null;
+    const versionMap = data[version];
+    if (!versionMap) return null;
+    return versionMap[serialPrefix] || null;
+}
+
+/**
+ * Get all device models that have firmware downloads for a given version.
+ * Returns array of { prefix, model } objects.
+ */
+function getDevicesForVersion(version) {
+    const data = _data || window.FIRMWARE_DOWNLOADS;
+    if (!data) return [];
+    const versionMap = data[version];
+    if (!versionMap) return [];
+    const devices = [];
+    for (const prefix of Object.keys(versionMap)) {
+        const model = KoboModels[prefix] || 'Unknown';
+        devices.push({ prefix, model: model + ' (' + prefix + ')' });
+    }
+    return devices;
+}
+
+export { loadSoftwareUrls, getSoftwareUrl, getDevicesForVersion };
diff --git a/web/src/js/kobopatch.js b/web/src/js/patch-runner.js
similarity index 97%
rename from web/src/js/kobopatch.js
rename to web/src/js/patch-runner.js
index 81cc7ef..b729347 100644
--- a/web/src/js/kobopatch.js
+++ b/web/src/js/patch-runner.js
@@ -1,7 +1,7 @@
 /**
  * Runs kobopatch WASM in a Web Worker for non-blocking UI.
  */
-class KobopatchRunner {
+class KoboPatchRunner {
     constructor() {
         this._worker = null;
     }
@@ -52,4 +52,4 @@ class KobopatchRunner {
     }
 }
 
-export { KobopatchRunner };
+export { KoboPatchRunner };
diff --git a/web/src/js/patch-ui.js b/web/src/js/patch-ui.js
index 51d9936..0592c28 100644
--- a/web/src/js/patch-ui.js
+++ b/web/src/js/patch-ui.js
@@ -459,4 +459,4 @@ class PatchUI {
 
 }
 
-export { PATCH_FILE_LABELS, parsePatchYAML, parsePatchConfig, scanAvailablePatches, PatchUI };
+export { PatchUI, scanAvailablePatches };
diff --git a/web/src/js/wasm_exec.js b/web/src/js/wasm_exec.js
deleted file mode 100644
index d71af9e..0000000
--- a/web/src/js/wasm_exec.js
+++ /dev/null
@@ -1,575 +0,0 @@
-// Copyright 2018 The Go Authors. All rights reserved.
-// Use of this source code is governed by a BSD-style
-// license that can be found in the LICENSE file.
-
-"use strict";
-
-(() => {
-	const enosys = () => {
-		const err = new Error("not implemented");
-		err.code = "ENOSYS";
-		return err;
-	};
-
-	if (!globalThis.fs) {
-		let outputBuf = "";
-		globalThis.fs = {
-			constants: { O_WRONLY: -1, O_RDWR: -1, O_CREAT: -1, O_TRUNC: -1, O_APPEND: -1, O_EXCL: -1, O_DIRECTORY: -1 }, // unused
-			writeSync(fd, buf) {
-				outputBuf += decoder.decode(buf);
-				const nl = outputBuf.lastIndexOf("\n");
-				if (nl != -1) {
-					console.log(outputBuf.substring(0, nl));
-					outputBuf = outputBuf.substring(nl + 1);
-				}
-				return buf.length;
-			},
-			write(fd, buf, offset, length, position, callback) {
-				if (offset !== 0 || length !== buf.length || position !== null) {
-					callback(enosys());
-					return;
-				}
-				const n = this.writeSync(fd, buf);
-				callback(null, n);
-			},
-			chmod(path, mode, callback) { callback(enosys()); },
-			chown(path, uid, gid, callback) { callback(enosys()); },
-			close(fd, callback) { callback(enosys()); },
-			fchmod(fd, mode, callback) { callback(enosys()); },
-			fchown(fd, uid, gid, callback) { callback(enosys()); },
-			fstat(fd, callback) { callback(enosys()); },
-			fsync(fd, callback) { callback(null); },
-			ftruncate(fd, length, callback) { callback(enosys()); },
-			lchown(path, uid, gid, callback) { callback(enosys()); },
-			link(path, link, callback) { callback(enosys()); },
-			lstat(path, callback) { callback(enosys()); },
-			mkdir(path, perm, callback) { callback(enosys()); },
-			open(path, flags, mode, callback) { callback(enosys()); },
-			read(fd, buffer, offset, length, position, callback) { callback(enosys()); },
-			readdir(path, callback) { callback(enosys()); },
-			readlink(path, callback) { callback(enosys()); },
-			rename(from, to, callback) { callback(enosys()); },
-			rmdir(path, callback) { callback(enosys()); },
-			stat(path, callback) { callback(enosys()); },
-			symlink(path, link, callback) { callback(enosys()); },
-			truncate(path, length, callback) { callback(enosys()); },
-			unlink(path, callback) { callback(enosys()); },
-			utimes(path, atime, mtime, callback) { callback(enosys()); },
-		};
-	}
-
-	if (!globalThis.process) {
-		globalThis.process = {
-			getuid() { return -1; },
-			getgid() { return -1; },
-			geteuid() { return -1; },
-			getegid() { return -1; },
-			getgroups() { throw enosys(); },
-			pid: -1,
-			ppid: -1,
-			umask() { throw enosys(); },
-			cwd() { throw enosys(); },
-			chdir() { throw enosys(); },
-		}
-	}
-
-	if (!globalThis.path) {
-		globalThis.path = {
-			resolve(...pathSegments) {
-				return pathSegments.join("/");
-			}
-		}
-	}
-
-	if (!globalThis.crypto) {
-		throw new Error("globalThis.crypto is not available, polyfill required (crypto.getRandomValues only)");
-	}
-
-	if (!globalThis.performance) {
-		throw new Error("globalThis.performance is not available, polyfill required (performance.now only)");
-	}
-
-	if (!globalThis.TextEncoder) {
-		throw new Error("globalThis.TextEncoder is not available, polyfill required");
-	}
-
-	if (!globalThis.TextDecoder) {
-		throw new Error("globalThis.TextDecoder is not available, polyfill required");
-	}
-
-	const encoder = new TextEncoder("utf-8");
-	const decoder = new TextDecoder("utf-8");
-
-	globalThis.Go = class {
-		constructor() {
-			this.argv = ["js"];
-			this.env = {};
-			this.exit = (code) => {
-				if (code !== 0) {
-					console.warn("exit code:", code);
-				}
-			};
-			this._exitPromise = new Promise((resolve) => {
-				this._resolveExitPromise = resolve;
-			});
-			this._pendingEvent = null;
-			this._scheduledTimeouts = new Map();
-			this._nextCallbackTimeoutID = 1;
-
-			const setInt64 = (addr, v) => {
-				this.mem.setUint32(addr + 0, v, true);
-				this.mem.setUint32(addr + 4, Math.floor(v / 4294967296), true);
-			}
-
-			const setInt32 = (addr, v) => {
-				this.mem.setUint32(addr + 0, v, true);
-			}
-
-			const getInt64 = (addr) => {
-				const low = this.mem.getUint32(addr + 0, true);
-				const high = this.mem.getInt32(addr + 4, true);
-				return low + high * 4294967296;
-			}
-
-			const loadValue = (addr) => {
-				const f = this.mem.getFloat64(addr, true);
-				if (f === 0) {
-					return undefined;
-				}
-				if (!isNaN(f)) {
-					return f;
-				}
-
-				const id = this.mem.getUint32(addr, true);
-				return this._values[id];
-			}
-
-			const storeValue = (addr, v) => {
-				const nanHead = 0x7FF80000;
-
-				if (typeof v === "number" && v !== 0) {
-					if (isNaN(v)) {
-						this.mem.setUint32(addr + 4, nanHead, true);
-						this.mem.setUint32(addr, 0, true);
-						return;
-					}
-					this.mem.setFloat64(addr, v, true);
-					return;
-				}
-
-				if (v === undefined) {
-					this.mem.setFloat64(addr, 0, true);
-					return;
-				}
-
-				let id = this._ids.get(v);
-				if (id === undefined) {
-					id = this._idPool.pop();
-					if (id === undefined) {
-						id = this._values.length;
-					}
-					this._values[id] = v;
-					this._goRefCounts[id] = 0;
-					this._ids.set(v, id);
-				}
-				this._goRefCounts[id]++;
-				let typeFlag = 0;
-				switch (typeof v) {
-					case "object":
-						if (v !== null) {
-							typeFlag = 1;
-						}
-						break;
-					case "string":
-						typeFlag = 2;
-						break;
-					case "symbol":
-						typeFlag = 3;
-						break;
-					case "function":
-						typeFlag = 4;
-						break;
-				}
-				this.mem.setUint32(addr + 4, nanHead | typeFlag, true);
-				this.mem.setUint32(addr, id, true);
-			}
-
-			const loadSlice = (addr) => {
-				const array = getInt64(addr + 0);
-				const len = getInt64(addr + 8);
-				return new Uint8Array(this._inst.exports.mem.buffer, array, len);
-			}
-
-			const loadSliceOfValues = (addr) => {
-				const array = getInt64(addr + 0);
-				const len = getInt64(addr + 8);
-				const a = new Array(len);
-				for (let i = 0; i < len; i++) {
-					a[i] = loadValue(array + i * 8);
-				}
-				return a;
-			}
-
-			const loadString = (addr) => {
-				const saddr = getInt64(addr + 0);
-				const len = getInt64(addr + 8);
-				return decoder.decode(new DataView(this._inst.exports.mem.buffer, saddr, len));
-			}
-
-			const testCallExport = (a, b) => {
-				this._inst.exports.testExport0();
-				return this._inst.exports.testExport(a, b);
-			}
-
-			const timeOrigin = Date.now() - performance.now();
-			this.importObject = {
-				_gotest: {
-					add: (a, b) => a + b,
-					callExport: testCallExport,
-				},
-				gojs: {
-					// Go's SP does not change as long as no Go code is running. Some operations (e.g. calls, getters and setters)
-					// may synchronously trigger a Go event handler. This makes Go code get executed in the middle of the imported
-					// function. A goroutine can switch to a new stack if the current stack is too small (see morestack function).
-					// This changes the SP, thus we have to update the SP used by the imported function.
-
-					// func wasmExit(code int32)
-					"runtime.wasmExit": (sp) => {
-						sp >>>= 0;
-						const code = this.mem.getInt32(sp + 8, true);
-						this.exited = true;
-						delete this._inst;
-						delete this._values;
-						delete this._goRefCounts;
-						delete this._ids;
-						delete this._idPool;
-						this.exit(code);
-					},
-
-					// func wasmWrite(fd uintptr, p unsafe.Pointer, n int32)
-					"runtime.wasmWrite": (sp) => {
-						sp >>>= 0;
-						const fd = getInt64(sp + 8);
-						const p = getInt64(sp + 16);
-						const n = this.mem.getInt32(sp + 24, true);
-						fs.writeSync(fd, new Uint8Array(this._inst.exports.mem.buffer, p, n));
-					},
-
-					// func resetMemoryDataView()
-					"runtime.resetMemoryDataView": (sp) => {
-						sp >>>= 0;
-						this.mem = new DataView(this._inst.exports.mem.buffer);
-					},
-
-					// func nanotime1() int64
-					"runtime.nanotime1": (sp) => {
-						sp >>>= 0;
-						setInt64(sp + 8, (timeOrigin + performance.now()) * 1000000);
-					},
-
-					// func walltime() (sec int64, nsec int32)
-					"runtime.walltime": (sp) => {
-						sp >>>= 0;
-						const msec = (new Date).getTime();
-						setInt64(sp + 8, msec / 1000);
-						this.mem.setInt32(sp + 16, (msec % 1000) * 1000000, true);
-					},
-
-					// func scheduleTimeoutEvent(delay int64) int32
-					"runtime.scheduleTimeoutEvent": (sp) => {
-						sp >>>= 0;
-						const id = this._nextCallbackTimeoutID;
-						this._nextCallbackTimeoutID++;
-						this._scheduledTimeouts.set(id, setTimeout(
-							() => {
-								this._resume();
-								while (this._scheduledTimeouts.has(id)) {
-									// for some reason Go failed to register the timeout event, log and try again
-									// (temporary workaround for https://github.com/golang/go/issues/28975)
-									console.warn("scheduleTimeoutEvent: missed timeout event");
-									this._resume();
-								}
-							},
-							getInt64(sp + 8),
-						));
-						this.mem.setInt32(sp + 16, id, true);
-					},
-
-					// func clearTimeoutEvent(id int32)
-					"runtime.clearTimeoutEvent": (sp) => {
-						sp >>>= 0;
-						const id = this.mem.getInt32(sp + 8, true);
-						clearTimeout(this._scheduledTimeouts.get(id));
-						this._scheduledTimeouts.delete(id);
-					},
-
-					// func getRandomData(r []byte)
-					"runtime.getRandomData": (sp) => {
-						sp >>>= 0;
-						crypto.getRandomValues(loadSlice(sp + 8));
-					},
-
-					// func finalizeRef(v ref)
-					"syscall/js.finalizeRef": (sp) => {
-						sp >>>= 0;
-						const id = this.mem.getUint32(sp + 8, true);
-						this._goRefCounts[id]--;
-						if (this._goRefCounts[id] === 0) {
-							const v = this._values[id];
-							this._values[id] = null;
-							this._ids.delete(v);
-							this._idPool.push(id);
-						}
-					},
-
-					// func stringVal(value string) ref
-					"syscall/js.stringVal": (sp) => {
-						sp >>>= 0;
-						storeValue(sp + 24, loadString(sp + 8));
-					},
-
-					// func valueGet(v ref, p string) ref
-					"syscall/js.valueGet": (sp) => {
-						sp >>>= 0;
-						const result = Reflect.get(loadValue(sp + 8), loadString(sp + 16));
-						sp = this._inst.exports.getsp() >>> 0; // see comment above
-						storeValue(sp + 32, result);
-					},
-
-					// func valueSet(v ref, p string, x ref)
-					"syscall/js.valueSet": (sp) => {
-						sp >>>= 0;
-						Reflect.set(loadValue(sp + 8), loadString(sp + 16), loadValue(sp + 32));
-					},
-
-					// func valueDelete(v ref, p string)
-					"syscall/js.valueDelete": (sp) => {
-						sp >>>= 0;
-						Reflect.deleteProperty(loadValue(sp + 8), loadString(sp + 16));
-					},
-
-					// func valueIndex(v ref, i int) ref
-					"syscall/js.valueIndex": (sp) => {
-						sp >>>= 0;
-						storeValue(sp + 24, Reflect.get(loadValue(sp + 8), getInt64(sp + 16)));
-					},
-
-					// valueSetIndex(v ref, i int, x ref)
-					"syscall/js.valueSetIndex": (sp) => {
-						sp >>>= 0;
-						Reflect.set(loadValue(sp + 8), getInt64(sp + 16), loadValue(sp + 24));
-					},
-
-					// func valueCall(v ref, m string, args []ref) (ref, bool)
-					"syscall/js.valueCall": (sp) => {
-						sp >>>= 0;
-						try {
-							const v = loadValue(sp + 8);
-							const m = Reflect.get(v, loadString(sp + 16));
-							const args = loadSliceOfValues(sp + 32);
-							const result = Reflect.apply(m, v, args);
-							sp = this._inst.exports.getsp() >>> 0; // see comment above
-							storeValue(sp + 56, result);
-							this.mem.setUint8(sp + 64, 1);
-						} catch (err) {
-							sp = this._inst.exports.getsp() >>> 0; // see comment above
-							storeValue(sp + 56, err);
-							this.mem.setUint8(sp + 64, 0);
-						}
-					},
-
-					// func valueInvoke(v ref, args []ref) (ref, bool)
-					"syscall/js.valueInvoke": (sp) => {
-						sp >>>= 0;
-						try {
-							const v = loadValue(sp + 8);
-							const args = loadSliceOfValues(sp + 16);
-							const result = Reflect.apply(v, undefined, args);
-							sp = this._inst.exports.getsp() >>> 0; // see comment above
-							storeValue(sp + 40, result);
-							this.mem.setUint8(sp + 48, 1);
-						} catch (err) {
-							sp = this._inst.exports.getsp() >>> 0; // see comment above
-							storeValue(sp + 40, err);
-							this.mem.setUint8(sp + 48, 0);
-						}
-					},
-
-					// func valueNew(v ref, args []ref) (ref, bool)
-					"syscall/js.valueNew": (sp) => {
-						sp >>>= 0;
-						try {
-							const v = loadValue(sp + 8);
-							const args = loadSliceOfValues(sp + 16);
-							const result = Reflect.construct(v, args);
-							sp = this._inst.exports.getsp() >>> 0; // see comment above
-							storeValue(sp + 40, result);
-							this.mem.setUint8(sp + 48, 1);
-						} catch (err) {
-							sp = this._inst.exports.getsp() >>> 0; // see comment above
-							storeValue(sp + 40, err);
-							this.mem.setUint8(sp + 48, 0);
-						}
-					},
-
-					// func valueLength(v ref) int
-					"syscall/js.valueLength": (sp) => {
-						sp >>>= 0;
-						setInt64(sp + 16, parseInt(loadValue(sp + 8).length));
-					},
-
-					// valuePrepareString(v ref) (ref, int)
-					"syscall/js.valuePrepareString": (sp) => {
-						sp >>>= 0;
-						const str = encoder.encode(String(loadValue(sp + 8)));
-						storeValue(sp + 16, str);
-						setInt64(sp + 24, str.length);
-					},
-
-					// valueLoadString(v ref, b []byte)
-					"syscall/js.valueLoadString": (sp) => {
-						sp >>>= 0;
-						const str = loadValue(sp + 8);
-						loadSlice(sp + 16).set(str);
-					},
-
-					// func valueInstanceOf(v ref, t ref) bool
-					"syscall/js.valueInstanceOf": (sp) => {
-						sp >>>= 0;
-						this.mem.setUint8(sp + 24, (loadValue(sp + 8) instanceof loadValue(sp + 16)) ? 1 : 0);
-					},
-
-					// func copyBytesToGo(dst []byte, src ref) (int, bool)
-					"syscall/js.copyBytesToGo": (sp) => {
-						sp >>>= 0;
-						const dst = loadSlice(sp + 8);
-						const src = loadValue(sp + 32);
-						if (!(src instanceof Uint8Array || src instanceof Uint8ClampedArray)) {
-							this.mem.setUint8(sp + 48, 0);
-							return;
-						}
-						const toCopy = src.subarray(0, dst.length);
-						dst.set(toCopy);
-						setInt64(sp + 40, toCopy.length);
-						this.mem.setUint8(sp + 48, 1);
-					},
-
-					// func copyBytesToJS(dst ref, src []byte) (int, bool)
-					"syscall/js.copyBytesToJS": (sp) => {
-						sp >>>= 0;
-						const dst = loadValue(sp + 8);
-						const src = loadSlice(sp + 16);
-						if (!(dst instanceof Uint8Array || dst instanceof Uint8ClampedArray)) {
-							this.mem.setUint8(sp + 48, 0);
-							return;
-						}
-						const toCopy = src.subarray(0, dst.length);
-						dst.set(toCopy);
-						setInt64(sp + 40, toCopy.length);
-						this.mem.setUint8(sp + 48, 1);
-					},
-
-					"debug": (value) => {
-						console.log(value);
-					},
-				}
-			};
-		}
-
-		async run(instance) {
-			if (!(instance instanceof WebAssembly.Instance)) {
-				throw new Error("Go.run: WebAssembly.Instance expected");
-			}
-			this._inst = instance;
-			this.mem = new DataView(this._inst.exports.mem.buffer);
-			this._values = [ // JS values that Go currently has references to, indexed by reference id
-				NaN,
-				0,
-				null,
-				true,
-				false,
-				globalThis,
-				this,
-			];
-			this._goRefCounts = new Array(this._values.length).fill(Infinity); // number of references that Go has to a JS value, indexed by reference id
-			this._ids = new Map([ // mapping from JS values to reference ids
-				[0, 1],
-				[null, 2],
-				[true, 3],
-				[false, 4],
-				[globalThis, 5],
-				[this, 6],
-			]);
-			this._idPool = [];   // unused ids that have been garbage collected
-			this.exited = false; // whether the Go program has exited
-
-			// Pass command line arguments and environment variables to WebAssembly by writing them to the linear memory.
-			let offset = 4096;
-
-			const strPtr = (str) => {
-				const ptr = offset;
-				const bytes = encoder.encode(str + "\0");
-				new Uint8Array(this.mem.buffer, offset, bytes.length).set(bytes);
-				offset += bytes.length;
-				if (offset % 8 !== 0) {
-					offset += 8 - (offset % 8);
-				}
-				return ptr;
-			};
-
-			const argc = this.argv.length;
-
-			const argvPtrs = [];
-			this.argv.forEach((arg) => {
-				argvPtrs.push(strPtr(arg));
-			});
-			argvPtrs.push(0);
-
-			const keys = Object.keys(this.env).sort();
-			keys.forEach((key) => {
-				argvPtrs.push(strPtr(`${key}=${this.env[key]}`));
-			});
-			argvPtrs.push(0);
-
-			const argv = offset;
-			argvPtrs.forEach((ptr) => {
-				this.mem.setUint32(offset, ptr, true);
-				this.mem.setUint32(offset + 4, 0, true);
-				offset += 8;
-			});
-
-			// The linker guarantees global data starts from at least wasmMinDataAddr.
-			// Keep in sync with cmd/link/internal/ld/data.go:wasmMinDataAddr.
-			const wasmMinDataAddr = 4096 + 8192;
-			if (offset >= wasmMinDataAddr) {
-				throw new Error("total length of command line and environment variables exceeds limit");
-			}
-
-			this._inst.exports.run(argc, argv);
-			if (this.exited) {
-				this._resolveExitPromise();
-			}
-			await this._exitPromise;
-		}
-
-		_resume() {
-			if (this.exited) {
-				throw new Error("Go program has already exited");
-			}
-			this._inst.exports.resume();
-			if (this.exited) {
-				this._resolveExitPromise();
-			}
-		}
-
-		_makeFuncWrapper(id) {
-			const go = this;
-			return function () {
-				const event = { id: id, this: this, args: arguments };
-				go._pendingEvent = event;
-				go._resume();
-				return event.result;
-			};
-		}
-	}
-})();
diff --git a/web/src/patches/downloads.json b/web/src/patches/downloads.json
new file mode 100644
index 0000000..2c03534
--- /dev/null
+++ b/web/src/patches/downloads.json
@@ -0,0 +1,8 @@
+{
+  "4.45.23646": {
+    "N428": "https://ereaderfiles.kobo.com/firmwares/kobo13/Mar2026/kobo-update-4.45.23646.zip",
+    "N365": "https://ereaderfiles.kobo.com/firmwares/kobo12/Mar2026/kobo-update-4.45.23646.zip",
+    "N367": "https://ereaderfiles.kobo.com/firmwares/kobo12/Mar2026/kobo-update-4.45.23646.zip",
+    "P365": "https://ereaderfiles.kobo.com/firmwares/kobo14/Mar2026/kobo-update-4.45.23646.zip"
+  }
+}
diff --git a/web/src/wasm/.gitkeep b/web/src/wasm/.gitkeep
deleted file mode 100644
index e69de29..0000000