@aeptus/aexeo-emdash 0.8.7 → 0.8.8

package/CHANGELOG.md

@@ -6,6 +6,51 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.8] - 2026-05-04
+
+### Fixed
+
+- **Astro dev mode no longer 500s on every request.** v0.8.7's
+  configured runtime relied on a synchronous default `.wasm`
+  import that Cloudflare Workers resolved to a
+  `WebAssembly.Module`, but Node ESM (Astro 6.1.3 + Vite 7.3.1
+  SSR runner) rejected at parse time with
+  `SyntaxError: The requested module ... does not provide an
+  export named 'default'`. The static import is gone; the plugin
+  now uses a dual-path runtime loader:
+  - Path A (Cloudflare Workers): dynamic `import()` of the
+    `.wasm` resolves to `{ default: WebAssembly.Module }` via
+    Wrangler's bundler integration; we use it synchronously.
+  - Path B (Node / Astro dev / Vite SSR): when Path A throws or
+    yields something that isn't a Module, fall back to
+    `node:fs/promises` `readFile` + `WebAssembly.compile`.
+  - Path C (browser-like edges): `fetch` + `compileStreaming` as
+    a last resort.
+
+  Production deploys to Cloudflare were unaffected by the v0.8.7
+  bug — only `pnpm dev` / `astro dev` workflows hit it. The fix
+  preserves the synchronous-Module path on Workers (Path A) so
+  there's no production regression.
+
+### Changed
+
+- **`vite-plugin-wasm` is no longer required.** With the dual-path
+  loader, Vite hosts can drop `vite-plugin-wasm` from dev deps and
+  `plugins: [wasm()]` from `vite.plugins`. INSTALL.md updated. The
+  plugins remain harmless if left in place — backwards-compatible.
+- **`optimizeDeps: { exclude: ["@aeptus/aexeo-emdash"] }`** is
+  still recommended (avoids Vite optimizer churn on dev start) but
+  no longer load-bearing.
+
+### Notes for hosts upgrading from 0.8.7
+
+- No code changes required for the fix to take effect; just bump
+  the package version. Astro dev should work on the next
+  `pnpm dev` / `astro dev` run.
+- If you want to clean up after the upgrade: `pnpm remove
+  vite-plugin-wasm` and remove `plugins: [wasm()]` + the
+  `wasm()` import from `astro.config.mjs`.
+
 ## [0.8.7] - 2026-05-04
 
 Picks up upstream aexeo-core 0.0.13 — three quality fixes from
@@ -822,7 +867,8 @@ First public release.
   `astro.config.mjs` for the WASM import to resolve to a
   precompiled `WebAssembly.Module`. Not optional.
 
-[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.7...HEAD
+[Unreleased]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.8...HEAD
+[0.8.8]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.7...aexeo-emdash-v0.8.8
 [0.8.7]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.6...aexeo-emdash-v0.8.7
 [0.8.6]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.5...aexeo-emdash-v0.8.6
 [0.8.5]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.4...aexeo-emdash-v0.8.5

package/INSTALL.md

@@ -36,14 +36,16 @@ when it's actually needed.
 ### Install
 
 ```bash
-npm install @aeptus/aexeo-emdash vite-plugin-wasm
+npm install @aeptus/aexeo-emdash
 ```
 
-`vite-plugin-wasm` is required because Vite's defaults treat `.wasm`
-imports as static-asset URLs, but Cloudflare Workers can only run
-WASM as precompiled `WebAssembly.Module` instances. The plugin
-bridges the two; without it, the Aexeo plugin's first call throws
-"WASM module did not resolve to a WebAssembly.Module."
+Starting in v0.8.8 the plugin loads its WASM internally with a
+dual-path runtime that tries the bundler-resolved import first
+(Cloudflare Workers) and falls back to `node:fs/promises` +
+`WebAssembly.compile` (Astro dev / Node ESM / Vite SSR runner).
+Earlier versions required `vite-plugin-wasm` because the plugin's
+single static `.wasm` import broke Astro dev mode with a
+SyntaxError; that's no longer needed.
 
 > **If installing from a private git remote or as a vendored
 > directory** — see the "Alternative install sources" section at the
@@ -57,19 +59,15 @@ import { d1, r2 } from "@emdash-cms/cloudflare";
 import { aexeoPlugin } from "@aeptus/aexeo-emdash";
 import { defineConfig } from "astro/config";
 import emdash from "emdash/astro";
-import wasm from "vite-plugin-wasm";
 
 export default defineConfig({
   output: "server",
   adapter: cloudflare(),
   vite: {
-    // Required: makes `import x from "./foo.wasm"` resolve to a
-    // precompiled WebAssembly.Module. Cloudflare Workers /
-    // workerd disallow runtime WebAssembly.instantiate from raw
-    // bytes, so the bundler has to do the compilation.
-    plugins: [wasm()],
-    // The Aexeo plugin's WASM import confuses Vite's dep
-    // optimizer when it tries to pre-bundle the package.
+    // Recommended: prevents Vite's dep optimizer from trying to
+    // pre-bundle the package, which churns on every dev start.
+    // The plugin itself works without this — but the optimizer
+    // chatter is annoying.
     optimizeDeps: { exclude: ["@aeptus/aexeo-emdash"] },
   },
   integrations: [
@@ -82,6 +80,12 @@ export default defineConfig({
 });
 ```
 
+> **Upgrading from 0.8.7 or earlier?** You can drop `vite-plugin-wasm`
+> from your dev dependencies and `plugins: [wasm()]` from the Vite
+> config; the new dual-path loader handles both runtimes internally.
+> Leaving them in place is harmless if you'd rather not touch the
+> config right away.
+
 That's it for code. No environment variables, no secrets to manage,
 no sidecar to deploy.
 

package/dist/configured.js

@@ -423,17 +423,40 @@ function __wbg_set_wasm(val) {
 }
 
 // src/wasm-init.ts
-import bridgeModule from "../wasm/aexeo_emdash_bridge_bg.wasm";
+var WASM_SPECIFIER = "../wasm/aexeo_emdash_bridge_bg.wasm";
 var initialized = false;
-function ensureInitialized() {
+var cachedModule = null;
+async function loadBridgeModule() {
+  if (cachedModule !== null) {
+    return cachedModule;
+  }
+  try {
+    const mod = await import(WASM_SPECIFIER);
+    if (mod.default instanceof WebAssembly.Module) {
+      cachedModule = mod.default;
+      return cachedModule;
+    }
+  } catch {
+  }
+  const wasmUrl = new URL(WASM_SPECIFIER, import.meta.url);
+  if (wasmUrl.protocol === "file:") {
+    const [{ readFile }, { fileURLToPath }] = await Promise.all([
+      import("node:fs/promises"),
+      import("node:url")
+    ]);
+    const bytes = await readFile(fileURLToPath(wasmUrl));
+    cachedModule = await WebAssembly.compile(bytes);
+    return cachedModule;
+  }
+  const response = await fetch(wasmUrl);
+  cachedModule = await WebAssembly.compileStreaming(response);
+  return cachedModule;
+}
+async function ensureInitialized() {
   if (initialized) {
     return;
   }
-  if (!(bridgeModule instanceof WebAssembly.Module)) {
-    throw new Error(
-      "aexeo: WASM module did not resolve to a WebAssembly.Module \u2014 the consumer's bundler isn't configured for .wasm imports. Add the .wasm loader to your Vite/wrangler config; see @aeptus/aexeo-emdash INSTALL.md for the recipe."
-    );
-  }
+  const bridgeModule = await loadBridgeModule();
   const instance = new WebAssembly.Instance(bridgeModule, {
     "./aexeo_emdash_bridge_bg.js": aexeo_emdash_bridge_bg_exports
   });
@@ -442,19 +465,19 @@ function ensureInitialized() {
   initialized = true;
 }
 async function evaluateDocuments2(documentsJson, configJson) {
-  ensureInitialized();
+  await ensureInitialized();
   return evaluateDocuments(documentsJson, configJson);
 }
 async function scoreIntelligence2(documentsJson, manifestJson) {
-  ensureInitialized();
+  await ensureInitialized();
   return scoreIntelligence(documentsJson, manifestJson ?? void 0);
 }
 async function generateFactsPrompt2(documentsJson) {
-  ensureInitialized();
+  await ensureInitialized();
   return generateFactsPrompt(documentsJson);
 }
 async function validateFactsManifest2(manifestJson, documentsJson) {
-  ensureInitialized();
+  await ensureInitialized();
   return validateFactsManifest(manifestJson, documentsJson);
 }
 
@@ -1160,7 +1183,7 @@ function globToMatcher(pattern) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.7";
+var PACKAGE_VERSION = "0.8.8";
 
 // src/configured.ts
 import { definePlugin } from "emdash";

package/dist/index.js

@@ -23,7 +23,7 @@ function buildAllowedHosts(evaluatorHost) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.7";
+var PACKAGE_VERSION = "0.8.8";
 
 // src/sandbox.ts
 function aexeoPluginSandboxed(options = {}) {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "0.8.7";
+export declare const PACKAGE_VERSION = "0.8.8";
 //# sourceMappingURL=version.d.ts.map

package/dist/wasm-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-init.d.ts","sourceRoot":"","sources":["../src/wasm-init.ts"],"names":[],"mappings":"AAmDA,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAID,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAKD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"wasm-init.d.ts","sourceRoot":"","sources":["../src/wasm-init.ts"],"names":[],"mappings":"AA0GA,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAID,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAKD,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeptus/aexeo-emdash",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "description": "Aexeo SEO/GEO content evaluator as an emdash plugin",
   "license": "MIT",
   "author": "Aeptus",