@kya-os/checkpoint-wasm-runtime 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,101 @@
 # @kya-os/checkpoint-wasm-runtime
 
+## 1.1.1 — 2026-05-17
+
+**Critical runtime fix.** 1.1.0 (and all prior versions back to 1.0.0)
+shipped with `engineVerify` tree-shaken to a broken stub —
+`function engineVerify(input, ctx) { const result = (void 0)(input, ctx); return result; }`.
+The wasm-bindgen `verify` import was removed by tsup at build time
+because `"sideEffects": false` told the bundler the whole package was
+side-effect-free, but the wasm-bindgen `--target nodejs` JS file binds
+its exports as a side-effect of loading (`module.exports = ...` runs
+at import time + the WASM instance writes its symbols into that
+exports object).
+
+Why this didn't surface before SDK-WASM-Bundler-Loader-1 (#2600):
+Next.js consumers couldn't reach `engineVerify` at all because the
+Web-target WASM URL trick failed bundler analysis first. Once #2600
+unblocked the build, every request started fail-opening with
+`(void 0) is not a function (TypeError)`. Express consumers likely
+hit the same bug but it manifested differently (verification just
+silently failed) and went unreported.
+
+### Fix
+
+Four coordinated changes — each addresses a different layer of the
+wasm-bindgen-meets-modern-bundler problem:
+
+1. **Source: namespace import + lazy property access**
+   (`src/engine/index.ts`). Static named imports of CJS exports
+   (`import { verify }`) get tree-shaken to `(void 0)` by esbuild
+   because it can't see runtime-assigned `exports.verify`. Reading
+   `wasmModule.verify` inside the function body keeps the access as
+   a runtime member lookup that survives esbuild's static analysis.
+
+2. **Per-engine `wasm/<target>/package.json`** — pins each subdir to
+   `"type": "commonjs"` (Node target) or `"type": "module"` (Edge
+   target). The parent `wasm/package.json` declares `"type": "module"`
+   for the older `agentshield_wasm.js` ESM file; without these
+   per-subdir overrides, Node mis-classifies the CJS Node-target file
+   as ESM and throws `ERR_REQUIRE_ESM` in test environments.
+
+3. **`sideEffects: ["./wasm/**/\*.js"]`** in package.json (was `false`).
+   Defense in depth — preserves wasm-bindgen modules' load-time
+   binding side effects even if future tsup config changes loosen
+   the explicit safeguards above.
+
+4. **tsup `onSuccess` copies `wasm/.../kya_os_engine_bg.wasm` to
+   `dist/`** so the inlined wasm-bindgen glue's
+   `__dirname + '/<name>_bg.wasm'` lookup finds the artifact next
+   to the bundled JS (otherwise ENOENT — `__dirname` resolves to
+   `dist/` when bundled, not the original `wasm/` source location).
+   Adds ~1.2 MB to the bundle dir but the file was already in the
+   published tarball; it's now in two places. Acceptable for a binary.
+
+### Bundle verification
+
+Before (broken):
+
+```
+function engineVerify(input, ctx) {
+  const result = (void 0)(input, ctx);   # ✗ wasmVerify tree-shaken
+  return result;
+}
+```
+
+After (this PR):
+
+```
+var wasmModule = __toESM(require_kya_os_engine());
+function engineVerify(input, ctx) {
+  const verify2 = wasmModule.verify;     # ✓ runtime property access
+  return verify2(input, ctx);
+}
+```
+
+### Test verification
+
+- `@kya-os/checkpoint-wasm-runtime`: 173/173 tests pass
+- `@kya-os/checkpoint-nextjs`: 141/141 tests pass (was 109 in 1.1.0)
+- `@kya-os/checkpoint-express`: 21/21 tests pass
+
+### Consumers
+
+No package.json changes needed in `@kya-os/checkpoint-{nextjs,express}`
+— both already use `workspace:^` to depend on `^1.1.0`, so fresh
+installs (including Vercel + Lambda redeploys) automatically pull
+1.1.1 transitively.
+
+### Coordinated release context
+
+Third in the SDK-WASM-Bundler-Loader sequence:
+
+- 1.0.0 → 1.1.0: SDK-WASM-Bundler-Loader-1 (#2600) — Node-only orchestrator entry
+- 1.1.0 → **1.1.1**: this — `sideEffects` config preserves wasm-bindgen binding
+- Future: SDK-WASM-Bundler-Loader-2 (#2605) — explicit init API for custom runtimes
+
+---
+
 ## 1.1.0 — 2026-05-17
 
 **SDK-WASM-Bundler-Loader-1 fix.** Surfaced during Bench-Before-After-1

package/dist/engine.js

@@ -1,9 +1,454 @@
 'use strict';
 
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// wasm/kya-os-engine/kya_os_engine.js
+var require_kya_os_engine = __commonJS({
+  "wasm/kya-os-engine/kya_os_engine.js"(exports$1, module) {
+    var imports = {};
+    imports["__wbindgen_placeholder__"] = module.exports;
+    var cachedUint8ArrayMemory0 = null;
+    function getUint8ArrayMemory0() {
+      if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+      }
+      return cachedUint8ArrayMemory0;
+    }
+    var cachedTextDecoder = new TextDecoder("utf-8", { ignoreBOM: true, fatal: true });
+    cachedTextDecoder.decode();
+    function decodeText(ptr, len) {
+      return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+    }
+    function getStringFromWasm0(ptr, len) {
+      ptr = ptr >>> 0;
+      return decodeText(ptr, len);
+    }
+    var heap = new Array(128).fill(void 0);
+    heap.push(void 0, null, true, false);
+    var heap_next = heap.length;
+    function addHeapObject(obj) {
+      if (heap_next === heap.length) heap.push(heap.length + 1);
+      const idx = heap_next;
+      heap_next = heap[idx];
+      heap[idx] = obj;
+      return idx;
+    }
+    function getObject(idx) {
+      return heap[idx];
+    }
+    var WASM_VECTOR_LEN = 0;
+    var cachedTextEncoder = new TextEncoder();
+    if (!("encodeInto" in cachedTextEncoder)) {
+      cachedTextEncoder.encodeInto = function(arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+          read: arg.length,
+          written: buf.length
+        };
+      };
+    }
+    function passStringToWasm0(arg, malloc, realloc) {
+      if (realloc === void 0) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr2 = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr2, ptr2 + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr2;
+      }
+      let len = arg.length;
+      let ptr = malloc(len, 1) >>> 0;
+      const mem = getUint8ArrayMemory0();
+      let offset = 0;
+      for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 127) break;
+        mem[ptr + offset] = code;
+      }
+      if (offset !== len) {
+        if (offset !== 0) {
+          arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+      }
+      WASM_VECTOR_LEN = offset;
+      return ptr;
+    }
+    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 isLikeNone(x) {
+      return x === void 0 || x === null;
+    }
+    function debugString(val) {
+      const type = typeof val;
+      if (type == "number" || type == "boolean" || val == null) {
+        return `${val}`;
+      }
+      if (type == "string") {
+        return `"${val}"`;
+      }
+      if (type == "symbol") {
+        const description = val.description;
+        if (description == null) {
+          return "Symbol";
+        } else {
+          return `Symbol(${description})`;
+        }
+      }
+      if (type == "function") {
+        const name = val.name;
+        if (typeof name == "string" && name.length > 0) {
+          return `Function(${name})`;
+        } else {
+          return "Function";
+        }
+      }
+      if (Array.isArray(val)) {
+        const length = val.length;
+        let debug = "[";
+        if (length > 0) {
+          debug += debugString(val[0]);
+        }
+        for (let i = 1; i < length; i++) {
+          debug += ", " + debugString(val[i]);
+        }
+        debug += "]";
+        return debug;
+      }
+      const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
+      let className;
+      if (builtInMatches && builtInMatches.length > 1) {
+        className = builtInMatches[1];
+      } else {
+        return toString.call(val);
+      }
+      if (className == "Object") {
+        try {
+          return "Object(" + JSON.stringify(val) + ")";
+        } catch (_) {
+          return "Object";
+        }
+      }
+      if (val instanceof Error) {
+        return `${val.name}: ${val.message}
+${val.stack}`;
+      }
+      return className;
+    }
+    function handleError(f, args) {
+      try {
+        return f.apply(this, args);
+      } catch (e) {
+        wasm.__wbindgen_export3(addHeapObject(e));
+      }
+    }
+    function getArrayU8FromWasm0(ptr, len) {
+      ptr = ptr >>> 0;
+      return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+    }
+    function dropObject(idx) {
+      if (idx < 132) return;
+      heap[idx] = heap_next;
+      heap_next = idx;
+    }
+    function takeObject(idx) {
+      const ret = getObject(idx);
+      dropObject(idx);
+      return ret;
+    }
+    exports$1.verify = function(input_js, ctx_js) {
+      try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        wasm.verify(retptr, addHeapObject(input_js), addHeapObject(ctx_js));
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+          throw takeObject(r1);
+        }
+        return takeObject(r0);
+      } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+      }
+    };
+    exports$1.__wbg_Error_e83987f665cf5504 = function(arg0, arg1) {
+      const ret = Error(getStringFromWasm0(arg0, arg1));
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_Number_bb48ca12f395cd08 = function(arg0) {
+      const ret = Number(getObject(arg0));
+      return ret;
+    };
+    exports$1.__wbg_String_8f0eb39a4a4c2f66 = function(arg0, arg1) {
+      const ret = String(getObject(arg1));
+      const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+      const len1 = WASM_VECTOR_LEN;
+      getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+      getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+    };
+    exports$1.__wbg___wbindgen_bigint_get_as_i64_f3ebc5a755000afd = function(arg0, arg1) {
+      const v = getObject(arg1);
+      const ret = typeof v === "bigint" ? v : void 0;
+      getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
+      getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+    };
+    exports$1.__wbg___wbindgen_boolean_get_6d5a1ee65bab5f68 = function(arg0) {
+      const v = getObject(arg0);
+      const ret = typeof v === "boolean" ? v : void 0;
+      return isLikeNone(ret) ? 16777215 : ret ? 1 : 0;
+    };
+    exports$1.__wbg___wbindgen_debug_string_df47ffb5e35e6763 = function(arg0, arg1) {
+      const ret = debugString(getObject(arg1));
+      const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+      const len1 = WASM_VECTOR_LEN;
+      getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+      getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+    };
+    exports$1.__wbg___wbindgen_in_bb933bd9e1b3bc0f = function(arg0, arg1) {
+      const ret = getObject(arg0) in getObject(arg1);
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_is_bigint_cb320707dcd35f0b = function(arg0) {
+      const ret = typeof getObject(arg0) === "bigint";
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_is_function_ee8a6c5833c90377 = function(arg0) {
+      const ret = typeof getObject(arg0) === "function";
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_is_object_c818261d21f283a4 = function(arg0) {
+      const val = getObject(arg0);
+      const ret = typeof val === "object" && val !== null;
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_is_string_fbb76cb2940daafd = function(arg0) {
+      const ret = typeof getObject(arg0) === "string";
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_is_undefined_2d472862bd29a478 = function(arg0) {
+      const ret = getObject(arg0) === void 0;
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_jsval_eq_6b13ab83478b1c50 = function(arg0, arg1) {
+      const ret = getObject(arg0) === getObject(arg1);
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_jsval_loose_eq_b664b38a2f582147 = function(arg0, arg1) {
+      const ret = getObject(arg0) == getObject(arg1);
+      return ret;
+    };
+    exports$1.__wbg___wbindgen_number_get_a20bf9b85341449d = function(arg0, arg1) {
+      const obj = getObject(arg1);
+      const ret = typeof obj === "number" ? obj : void 0;
+      getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+      getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+    };
+    exports$1.__wbg___wbindgen_string_get_e4f06c90489ad01b = function(arg0, arg1) {
+      const obj = getObject(arg1);
+      const ret = typeof obj === "string" ? obj : void 0;
+      var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+      var len1 = WASM_VECTOR_LEN;
+      getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+      getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+    };
+    exports$1.__wbg___wbindgen_throw_b855445ff6a94295 = function(arg0, arg1) {
+      throw new Error(getStringFromWasm0(arg0, arg1));
+    };
+    exports$1.__wbg_call_e762c39fa8ea36bf = function() {
+      return handleError(function(arg0, arg1) {
+        const ret = getObject(arg0).call(getObject(arg1));
+        return addHeapObject(ret);
+      }, arguments);
+    };
+    exports$1.__wbg_done_2042aa2670fb1db1 = function(arg0) {
+      const ret = getObject(arg0).done;
+      return ret;
+    };
+    exports$1.__wbg_entries_e171b586f8f6bdbf = function(arg0) {
+      const ret = Object.entries(getObject(arg0));
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_get_7bed016f185add81 = function(arg0, arg1) {
+      const ret = getObject(arg0)[arg1 >>> 0];
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_get_efcb449f58ec27c2 = function() {
+      return handleError(function(arg0, arg1) {
+        const ret = Reflect.get(getObject(arg0), getObject(arg1));
+        return addHeapObject(ret);
+      }, arguments);
+    };
+    exports$1.__wbg_get_with_ref_key_1dc361bd10053bfe = function(arg0, arg1) {
+      const ret = getObject(arg0)[getObject(arg1)];
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_instanceof_ArrayBuffer_70beb1189ca63b38 = function(arg0) {
+      let result;
+      try {
+        result = getObject(arg0) instanceof ArrayBuffer;
+      } catch (_) {
+        result = false;
+      }
+      const ret = result;
+      return ret;
+    };
+    exports$1.__wbg_instanceof_Map_8579b5e2ab5437c7 = function(arg0) {
+      let result;
+      try {
+        result = getObject(arg0) instanceof Map;
+      } catch (_) {
+        result = false;
+      }
+      const ret = result;
+      return ret;
+    };
+    exports$1.__wbg_instanceof_Uint8Array_20c8e73002f7af98 = function(arg0) {
+      let result;
+      try {
+        result = getObject(arg0) instanceof Uint8Array;
+      } catch (_) {
+        result = false;
+      }
+      const ret = result;
+      return ret;
+    };
+    exports$1.__wbg_isArray_96e0af9891d0945d = function(arg0) {
+      const ret = Array.isArray(getObject(arg0));
+      return ret;
+    };
+    exports$1.__wbg_isSafeInteger_d216eda7911dde36 = function(arg0) {
+      const ret = Number.isSafeInteger(getObject(arg0));
+      return ret;
+    };
+    exports$1.__wbg_iterator_e5822695327a3c39 = function() {
+      const ret = Symbol.iterator;
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_length_69bca3cb64fc8748 = function(arg0) {
+      const ret = getObject(arg0).length;
+      return ret;
+    };
+    exports$1.__wbg_length_cdd215e10d9dd507 = function(arg0) {
+      const ret = getObject(arg0).length;
+      return ret;
+    };
+    exports$1.__wbg_new_1acc0b6eea89d040 = function() {
+      const ret = new Object();
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_new_5a79be3ab53b8aa5 = function(arg0) {
+      const ret = new Uint8Array(getObject(arg0));
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_new_68651c719dcda04e = function() {
+      const ret = /* @__PURE__ */ new Map();
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_new_e17d9f43105b08be = function() {
+      const ret = new Array();
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_next_020810e0ae8ebcb0 = function() {
+      return handleError(function(arg0) {
+        const ret = getObject(arg0).next();
+        return addHeapObject(ret);
+      }, arguments);
+    };
+    exports$1.__wbg_next_2c826fe5dfec6b6a = function(arg0) {
+      const ret = getObject(arg0).next;
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_prototypesetcall_2a6620b6922694b2 = function(arg0, arg1, arg2) {
+      Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), getObject(arg2));
+    };
+    exports$1.__wbg_set_3f1d0b984ed272ed = function(arg0, arg1, arg2) {
+      getObject(arg0)[takeObject(arg1)] = takeObject(arg2);
+    };
+    exports$1.__wbg_set_907fb406c34a251d = function(arg0, arg1, arg2) {
+      const ret = getObject(arg0).set(getObject(arg1), getObject(arg2));
+      return addHeapObject(ret);
+    };
+    exports$1.__wbg_set_c213c871859d6500 = function(arg0, arg1, arg2) {
+      getObject(arg0)[arg1 >>> 0] = takeObject(arg2);
+    };
+    exports$1.__wbg_value_692627309814bb8c = function(arg0) {
+      const ret = getObject(arg0).value;
+      return addHeapObject(ret);
+    };
+    exports$1.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
+      const ret = getStringFromWasm0(arg0, arg1);
+      return addHeapObject(ret);
+    };
+    exports$1.__wbindgen_cast_4625c577ab2ec9ee = function(arg0) {
+      const ret = BigInt.asUintN(64, arg0);
+      return addHeapObject(ret);
+    };
+    exports$1.__wbindgen_cast_9ae0607507abb057 = function(arg0) {
+      const ret = arg0;
+      return addHeapObject(ret);
+    };
+    exports$1.__wbindgen_cast_d6cd19b81560fd6e = function(arg0) {
+      const ret = arg0;
+      return addHeapObject(ret);
+    };
+    exports$1.__wbindgen_object_clone_ref = function(arg0) {
+      const ret = getObject(arg0);
+      return addHeapObject(ret);
+    };
+    exports$1.__wbindgen_object_drop_ref = function(arg0) {
+      takeObject(arg0);
+    };
+    var wasmPath = `${__dirname}/kya_os_engine_bg.wasm`;
+    var wasmBytes = __require("fs").readFileSync(wasmPath);
+    var wasmModule2 = new WebAssembly.Module(wasmBytes);
+    var wasm = exports$1.__wasm = new WebAssembly.Instance(wasmModule2, imports).exports;
+  }
+});
+
 // src/engine/index.ts
+var wasmModule = __toESM(require_kya_os_engine());
 function engineVerify(input, ctx) {
-  const result = (void 0)(input, ctx);
-  return result;
+  const verify2 = wasmModule.verify;
+  return verify2(input, ctx);
 }
 
 exports.engineVerify = engineVerify;