@aeptus/aexeo-emdash 0.8.7 → 0.8.9

package/CHANGELOG.md

@@ -6,6 +6,92 @@ and the project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.8.9] - 2026-05-04
+
+### Fixed
+
+- **`wasm_error: unreachable` on refresh in Astro dev.** v0.8.8
+  fixed the Astro/Vite startup regression but a second issue
+  remained: refresh evaluation traps with bare
+  `wasm_error: unreachable` in Node-loaded WASM. Root cause is
+  `std::time::Instant::now()` panicking on
+  `wasm32-unknown-unknown` ("time not implemented on this
+  platform"). Cloudflare Workers' workerd runtime appears to
+  provide a clock shim that masks the panic in production; Node's
+  experimental WASM ESM runner does not.
+
+  Fixed by adding `aexeo_core::time_shim::Instant` — a transparent
+  re-export of `std::time::Instant` on non-wasm targets, and a
+  no-op `Duration::ZERO` returner on `wasm32-unknown-unknown`.
+  Eval-path callers (`static_check.rs` + the intelligence
+  modules) swap their import; CLI and native tests still report
+  real timings on real OSes. The `RuleTiming` `elapsed_us` value
+  in `SiteCheckProfile` is `0` when the bridge runs in the
+  plugin, but no host consumes that field from the bridge today.
+
+### Added
+
+- **`console_error_panic_hook` in the bridge.** Future Rust
+  panics inside the bridge surface as console errors with
+  `file:line` + message instead of bare `unreachable` traps.
+  Installed lazily at every `#[wasm_bindgen]` entry point;
+  `set_once` is idempotent so repeated calls are cheap. Without
+  this, the v0.8.7→v0.8.8 `Instant::now()` panic was effectively
+  undebuggable from the host side — every future bridge bug now
+  carries its own diagnostic.
+
+### Notes for hosts upgrading from 0.8.8
+
+- No code changes required. Bump the package; refresh should
+  stop trapping in `pnpm dev` / `astro dev`.
+- Production behavior unchanged — the shim is only active on
+  the wasm32 build path.
+
+## [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 +908,9 @@ 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.9...HEAD
+[0.8.9]: https://github.com/schiste/Aexeo/compare/aexeo-emdash-v0.8.8...aexeo-emdash-v0.8.9
+[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

@@ -233,7 +233,10 @@ async function readFindings(kv, route) {
 var aexeo_emdash_bridge_bg_exports = {};
 __export(aexeo_emdash_bridge_bg_exports, {
   __wbg_Error_960c155d3d49e4c2: () => __wbg_Error_960c155d3d49e4c2,
+  __wbg_error_a6fa202b58aa1cd3: () => __wbg_error_a6fa202b58aa1cd3,
+  __wbg_new_227d7c05414eb861: () => __wbg_new_227d7c05414eb861,
   __wbg_set_wasm: () => __wbg_set_wasm,
+  __wbg_stack_3b0d974bbf31e44f: () => __wbg_stack_3b0d974bbf31e44f,
   __wbindgen_init_externref_table: () => __wbindgen_init_externref_table,
   evaluateDocuments: () => evaluateDocuments,
   generateFactsPrompt: () => generateFactsPrompt,
@@ -334,6 +337,28 @@ function __wbg_Error_960c155d3d49e4c2(arg0, arg1) {
   const ret = Error(getStringFromWasm0(arg0, arg1));
   return ret;
 }
+function __wbg_error_a6fa202b58aa1cd3(arg0, arg1) {
+  let deferred0_0;
+  let deferred0_1;
+  try {
+    deferred0_0 = arg0;
+    deferred0_1 = arg1;
+    console.error(getStringFromWasm0(arg0, arg1));
+  } finally {
+    wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
+  }
+}
+function __wbg_new_227d7c05414eb861() {
+  const ret = new Error();
+  return ret;
+}
+function __wbg_stack_3b0d974bbf31e44f(arg0, arg1) {
+  const ret = arg1.stack;
+  const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+  const len1 = WASM_VECTOR_LEN;
+  getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+  getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
 function __wbindgen_init_externref_table() {
   const table = wasm.__wbindgen_externrefs;
   const offset = table.grow(4);
@@ -343,6 +368,13 @@ function __wbindgen_init_externref_table() {
   table.set(offset + 2, true);
   table.set(offset + 3, false);
 }
+var cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+  if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || cachedDataViewMemory0.buffer.detached === void 0 && cachedDataViewMemory0.buffer !== wasm.memory.buffer) {
+    cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+  }
+  return cachedDataViewMemory0;
+}
 function getStringFromWasm0(ptr, len) {
   ptr = ptr >>> 0;
   return decodeText(ptr, len);
@@ -423,17 +455,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 +497,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 +1215,7 @@ function globToMatcher(pattern) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.8.7";
+var PACKAGE_VERSION = "0.8.9";
 
 // 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.9";
 
 // 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.9";
 //# 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.9",
   "description": "Aexeo SEO/GEO content evaluator as an emdash plugin",
   "license": "MIT",
   "author": "Aeptus",

package/wasm/aexeo_emdash_bridge_bg.js

@@ -117,6 +117,28 @@ export function __wbg_Error_960c155d3d49e4c2(arg0, arg1) {
     const ret = Error(getStringFromWasm0(arg0, arg1));
     return ret;
 }
+export function __wbg_error_a6fa202b58aa1cd3(arg0, arg1) {
+    let deferred0_0;
+    let deferred0_1;
+    try {
+        deferred0_0 = arg0;
+        deferred0_1 = arg1;
+        console.error(getStringFromWasm0(arg0, arg1));
+    } finally {
+        wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
+    }
+}
+export function __wbg_new_227d7c05414eb861() {
+    const ret = new Error();
+    return ret;
+}
+export function __wbg_stack_3b0d974bbf31e44f(arg0, arg1) {
+    const ret = arg1.stack;
+    const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+}
 export function __wbindgen_init_externref_table() {
     const table = wasm.__wbindgen_externrefs;
     const offset = table.grow(4);
@@ -126,6 +148,14 @@ export function __wbindgen_init_externref_table() {
     table.set(offset + 2, true);
     table.set(offset + 3, false);
 }
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
 function getStringFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return decodeText(ptr, len);

package/wasm/aexeo_emdash_bridge_bg.wasm.d.ts

@@ -5,9 +5,9 @@ export const evaluateDocuments: (a: number, b: number, c: number, d: number) =>
 export const generateFactsPrompt: (a: number, b: number) => [number, number, number, number];
 export const scoreIntelligence: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const validateFactsManifest: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
 export const __externref_table_dealloc: (a: number) => void;
-export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_start: () => void;