@ricsam/quickjs-core 0.2.16 → 0.2.17

package/README.md

@@ -1,6 +1,16 @@
 # @ricsam/quickjs-core
 
-Core utilities and Web Streams API.
+Core utilities and Web Streams API for QuickJS runtime bindings.
+
+> **Note**: This is a low-level package. For most use cases, use [`@ricsam/quickjs-runtime`](../runtime) with `createRuntime()` instead.
+
+## Installation
+
+```bash
+bun add @ricsam/quickjs-core
+```
+
+## Setup
 
 ```typescript
 import { setupCore } from "@ricsam/quickjs-core";
@@ -8,12 +18,13 @@ import { setupCore } from "@ricsam/quickjs-core";
 const handle = setupCore(context);
 ```
 
-**Injected Globals:**
+## Injected Globals
+
 - `ReadableStream`, `WritableStream`, `TransformStream`
 - `ReadableStreamDefaultReader`, `WritableStreamDefaultWriter`
 - `Blob`, `File`
 
-**Usage in QuickJS:**
+## Usage in QuickJS
 
 ```javascript
 // Streams
@@ -35,4 +46,100 @@ const text = await blob.text(); // "hello world"
 // File
 const file = new File(["content"], "file.txt", { type: "text/plain" });
 console.log(file.name); // "file.txt"
-```
+```
+
+## Core Utilities
+
+```typescript
+import {
+  // Marshalling
+  marshal,       // JS value -> QuickJS handle
+  unmarshal,     // QuickJS handle -> JS value
+
+  // Handle utilities
+  isHandle,      // Check if value is a QuickJS handle
+  getHandleType, // Get handle type as string
+
+  // Scope management
+  withScope,      // Automatic handle cleanup
+  withScopeAsync, // Async version
+
+  // Class/function builders
+  defineClass,
+  defineFunction,
+  defineAsyncFunction,
+  defineAsyncIteratorFunction, // For async generators
+  cleanupAsyncIterators,       // Cleanup on context disposal
+
+  // State management
+  createStateMap,
+  getState,
+  setState,
+} from "@ricsam/quickjs-core";
+```
+
+### Marshalling Example
+
+```typescript
+// Marshal JS values to QuickJS
+const handle = marshal(context, {
+  name: "test",
+  values: [1, 2, 3],
+  callback: (x) => x * 2,
+});
+
+// Unmarshal QuickJS values to JS
+const value = unmarshal(context, handle);
+```
+
+### Custom Class Definition
+
+```typescript
+const PointClass = defineClass(context, stateMap, {
+  name: "Point",
+  construct: ([x, y]) => ({ x: Number(x), y: Number(y) }),
+  properties: {
+    x: {
+      get() { return this.x; },
+      set(v) { this.x = Number(v); },
+    },
+    y: {
+      get() { return this.y; },
+      set(v) { this.y = Number(v); },
+    },
+  },
+  methods: {
+    distance() {
+      return Math.sqrt(this.x ** 2 + this.y ** 2);
+    },
+  },
+});
+
+context.setProp(context.global, "Point", PointClass);
+```
+
+### Async Iterator Function
+
+Define functions that return async iterables (for streaming data):
+
+```typescript
+import { defineAsyncIteratorFunction, cleanupAsyncIterators } from "@ricsam/quickjs-core";
+
+const streamFn = defineAsyncIteratorFunction(context, "streamNumbers", async function* (count) {
+  for (let i = 0; i < Number(count); i++) {
+    await new Promise(r => setTimeout(r, 100));
+    yield i;
+  }
+});
+
+context.setProp(context.global, "streamNumbers", streamFn);
+streamFn.dispose();
+
+// In QuickJS:
+// for await (const n of streamNumbers(5)) {
+//   console.log(n); // 0, 1, 2, 3, 4
+// }
+
+// Clean up before context disposal
+cleanupAsyncIterators(context);
+```

package/dist/cjs/function-builder.cjs

@@ -31,11 +31,160 @@ var __export = (target, all) => {
 var exports_function_builder = {};
 __export(exports_function_builder, {
   defineFunction: () => defineFunction,
-  defineAsyncFunction: () => defineAsyncFunction
+  defineAsyncIteratorFunction: () => defineAsyncIteratorFunction,
+  defineAsyncFunction: () => defineAsyncFunction,
+  cleanupAsyncIterators: () => cleanupAsyncIterators
 });
 module.exports = __toCommonJS(exports_function_builder);
 var import_unmarshal = require("./unmarshal.cjs");
 var import_marshal = require("./marshal.cjs");
+var generatorRegistries = new WeakMap;
+var generatorCounters = new WeakMap;
+var setupContexts = new WeakSet;
+function getGeneratorRegistry(context) {
+  let registry = generatorRegistries.get(context);
+  if (!registry) {
+    registry = new Map;
+    generatorRegistries.set(context, registry);
+  }
+  return registry;
+}
+function nextGeneratorId(context) {
+  let counter = generatorCounters.get(context);
+  if (!counter) {
+    counter = { value: 0 };
+    generatorCounters.set(context, counter);
+  }
+  return ++counter.value;
+}
+function registerGenerator(context, generator) {
+  const id = nextGeneratorId(context);
+  const registry = getGeneratorRegistry(context);
+  registry.set(id, generator);
+  return id;
+}
+function setupAsyncIteratorInfrastructure(context) {
+  if (setupContexts.has(context)) {
+    return;
+  }
+  setupContexts.add(context);
+  const nextFn = context.newFunction("__asyncIteratorNext__", (idHandle) => {
+    const id = context.getNumber(idHandle);
+    const registry = getGeneratorRegistry(context);
+    const generator = registry.get(id);
+    if (!generator) {
+      const deferred2 = context.newPromise();
+      const errorHandle = context.newError(`Generator ${id} not found`);
+      deferred2.reject(errorHandle);
+      errorHandle.dispose();
+      context.runtime.executePendingJobs();
+      return deferred2.handle;
+    }
+    const deferred = context.newPromise();
+    generator.next().then((result) => {
+      if (!context.alive)
+        return;
+      const resultHandle = import_marshal.marshal(context, {
+        value: result.value,
+        done: result.done
+      });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      if (result.done) {
+        registry.delete(id);
+      }
+      context.runtime.executePendingJobs();
+    }).catch((error) => {
+      if (!context.alive)
+        return;
+      const errorHandle = context.newError(error instanceof Error ? error.message : String(error));
+      deferred.reject(errorHandle);
+      errorHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    });
+    return deferred.handle;
+  });
+  context.setProp(context.global, "__asyncIteratorNext__", nextFn);
+  nextFn.dispose();
+  const returnFn = context.newFunction("__asyncIteratorReturn__", (idHandle, valueHandle) => {
+    const id = context.getNumber(idHandle);
+    const value = import_unmarshal.unmarshal(context, valueHandle);
+    const registry = getGeneratorRegistry(context);
+    const generator = registry.get(id);
+    const deferred = context.newPromise();
+    if (!generator) {
+      const resultHandle = import_marshal.marshal(context, { value, done: true });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      context.runtime.executePendingJobs();
+      return deferred.handle;
+    }
+    generator.return(value).then((result) => {
+      if (!context.alive)
+        return;
+      const resultHandle = import_marshal.marshal(context, {
+        value: result.value,
+        done: result.done
+      });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    }).catch((error) => {
+      if (!context.alive)
+        return;
+      const errorHandle = context.newError(error instanceof Error ? error.message : String(error));
+      deferred.reject(errorHandle);
+      errorHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    });
+    return deferred.handle;
+  });
+  context.setProp(context.global, "__asyncIteratorReturn__", returnFn);
+  returnFn.dispose();
+  const throwFn = context.newFunction("__asyncIteratorThrow__", (idHandle, errorHandle) => {
+    const id = context.getNumber(idHandle);
+    const errorValue = import_unmarshal.unmarshal(context, errorHandle);
+    const registry = getGeneratorRegistry(context);
+    const generator = registry.get(id);
+    const deferred = context.newPromise();
+    if (!generator) {
+      const errHandle = context.newError(errorValue instanceof Error ? errorValue.message : String(errorValue));
+      deferred.reject(errHandle);
+      errHandle.dispose();
+      context.runtime.executePendingJobs();
+      return deferred.handle;
+    }
+    const error = errorValue instanceof Error ? errorValue : new Error(String(errorValue));
+    generator.throw(error).then((result) => {
+      if (!context.alive)
+        return;
+      const resultHandle = import_marshal.marshal(context, {
+        value: result.value,
+        done: result.done
+      });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      if (result.done) {
+        registry.delete(id);
+      }
+      context.runtime.executePendingJobs();
+    }).catch((err) => {
+      if (!context.alive)
+        return;
+      const errHandle = context.newError(err instanceof Error ? err.message : String(err));
+      deferred.reject(errHandle);
+      errHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    });
+    return deferred.handle;
+  });
+  context.setProp(context.global, "__asyncIteratorThrow__", throwFn);
+  throwFn.dispose();
+}
 function defineFunction(context, name, fn) {
   return context.newFunction(name, (...argHandles) => {
     const args = argHandles.map((h) => import_unmarshal.unmarshal(context, h));
@@ -71,6 +220,39 @@ function defineAsyncFunction(context, name, fn) {
     return deferred.handle;
   });
 }
+function defineAsyncIteratorFunction(context, name, fn) {
+  setupAsyncIteratorInfrastructure(context);
+  return context.newFunction(name, (...argHandles) => {
+    const args = argHandles.map((h) => import_unmarshal.unmarshal(context, h));
+    try {
+      const generator = fn(...args);
+      const generatorId = registerGenerator(context, generator);
+      const result = context.evalCode(`({
+        [Symbol.asyncIterator]() {
+          return {
+            next: () => __asyncIteratorNext__(${generatorId}),
+            return: (v) => __asyncIteratorReturn__(${generatorId}, v),
+            throw: (e) => __asyncIteratorThrow__(${generatorId}, e)
+          };
+        }
+      })`);
+      if (result.error) {
+        const err = context.dump(result.error);
+        result.error.dispose();
+        const registry = getGeneratorRegistry(context);
+        registry.delete(generatorId);
+        throw context.newError(String(err));
+      }
+      return result.value;
+    } catch (error) {
+      throw context.newError(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+function cleanupAsyncIterators(context) {
+  generatorRegistries.delete(context);
+  generatorCounters.delete(context);
+}
 })
 
-//# debugId=C5D7588C3C8B806E64756E2164756E21
+//# debugId=679B9EDB41D36FF564756E2164756E21

package/dist/cjs/function-builder.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/function-builder.ts"],
   "sourcesContent": [
-    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport { unmarshal } from \"./unmarshal.cjs\";\nimport { marshal } from \"./marshal.cjs\";\n\n/**\n * Define a global function in the QuickJS context\n *\n * @returns Handle to the function (caller must manage disposal)\n *\n * @example\n * const logFn = defineFunction(context, \"log\", (...args) => {\n *   console.log(\"[QuickJS]\", ...args);\n * });\n * context.setProp(context.global, \"log\", logFn);\n */\nexport function defineFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => unknown\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    try {\n      // Call host function\n      const result = fn(...args);\n\n      // Marshal result\n      return marshal(context, result);\n    } catch (error) {\n      // Throw error in QuickJS\n      throw context.newError(\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n  });\n}\n\n/**\n * Define an async function that returns a promise to QuickJS\n *\n * @example\n * const fetchFn = defineAsyncFunction(context, \"fetch\", async (url) => {\n *   const response = await fetch(String(url));\n *   return response.text();\n * });\n */\nexport function defineAsyncFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => Promise<unknown>\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    // Create a promise in QuickJS\n    const deferred = context.newPromise();\n\n    // Call the async function\n    fn(...args)\n      .then((result) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const resultHandle = marshal(context, result);\n        deferred.resolve(resultHandle);\n        resultHandle.dispose();\n        context.runtime.executePendingJobs();\n      })\n      .catch((error) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const errorHandle = marshal(\n          context,\n          error instanceof Error\n            ? { name: error.name, message: error.message }\n            : { message: String(error) }\n        );\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        context.runtime.executePendingJobs();\n      });\n\n    return deferred.handle;\n  });\n}\n"
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport { unmarshal } from \"./unmarshal.cjs\";\nimport { marshal } from \"./marshal.cjs\";\n\n/**\n * Registry for async generators, scoped per-context.\n * Uses WeakMap to automatically clean up when context is GC'd.\n */\nconst generatorRegistries = new WeakMap<\n  QuickJSContext,\n  Map<number, AsyncGenerator<unknown, unknown, unknown>>\n>();\n\n/**\n * Counter for generating unique generator IDs per context.\n */\nconst generatorCounters = new WeakMap<QuickJSContext, { value: number }>();\n\n/**\n * Track which contexts have had async iterator infrastructure set up.\n */\nconst setupContexts = new WeakSet<QuickJSContext>();\n\n/**\n * Get or create the generator registry for a context.\n */\nfunction getGeneratorRegistry(\n  context: QuickJSContext\n): Map<number, AsyncGenerator<unknown, unknown, unknown>> {\n  let registry = generatorRegistries.get(context);\n  if (!registry) {\n    registry = new Map();\n    generatorRegistries.set(context, registry);\n  }\n  return registry;\n}\n\n/**\n * Get next generator ID for a context.\n */\nfunction nextGeneratorId(context: QuickJSContext): number {\n  let counter = generatorCounters.get(context);\n  if (!counter) {\n    counter = { value: 0 };\n    generatorCounters.set(context, counter);\n  }\n  return ++counter.value;\n}\n\n/**\n * Register a generator and return its ID.\n */\nfunction registerGenerator(\n  context: QuickJSContext,\n  generator: AsyncGenerator<unknown, unknown, unknown>\n): number {\n  const id = nextGeneratorId(context);\n  const registry = getGeneratorRegistry(context);\n  registry.set(id, generator);\n  return id;\n}\n\n/**\n * Setup async iterator infrastructure helpers in the context.\n * These are global functions that proxy to host-side generators.\n */\nfunction setupAsyncIteratorInfrastructure(context: QuickJSContext): void {\n  if (setupContexts.has(context)) {\n    return;\n  }\n  setupContexts.add(context);\n\n  // __asyncIteratorNext__(id) - calls generator.next()\n  const nextFn = context.newFunction(\n    \"__asyncIteratorNext__\",\n    (idHandle: QuickJSHandle) => {\n      const id = context.getNumber(idHandle);\n      const registry = getGeneratorRegistry(context);\n      const generator = registry.get(id);\n\n      if (!generator) {\n        // Generator not found - already cleaned up or invalid ID\n        const deferred = context.newPromise();\n        const errorHandle = context.newError(`Generator ${id} not found`);\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        context.runtime.executePendingJobs();\n        return deferred.handle;\n      }\n\n      const deferred = context.newPromise();\n\n      generator\n        .next()\n        .then((result) => {\n          if (!context.alive) return;\n\n          const resultHandle = marshal(context, {\n            value: result.value,\n            done: result.done,\n          });\n          deferred.resolve(resultHandle);\n          resultHandle.dispose();\n\n          // Clean up if done\n          if (result.done) {\n            registry.delete(id);\n          }\n\n          context.runtime.executePendingJobs();\n        })\n        .catch((error) => {\n          if (!context.alive) return;\n\n          // Create a proper Error object for rejection\n          const errorHandle = context.newError(\n            error instanceof Error ? error.message : String(error)\n          );\n          deferred.reject(errorHandle);\n          errorHandle.dispose();\n\n          // Clean up on error\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        });\n\n      return deferred.handle;\n    }\n  );\n  context.setProp(context.global, \"__asyncIteratorNext__\", nextFn);\n  nextFn.dispose();\n\n  // __asyncIteratorReturn__(id, value) - calls generator.return(value)\n  const returnFn = context.newFunction(\n    \"__asyncIteratorReturn__\",\n    (idHandle: QuickJSHandle, valueHandle: QuickJSHandle) => {\n      const id = context.getNumber(idHandle);\n      const value = unmarshal(context, valueHandle);\n      const registry = getGeneratorRegistry(context);\n      const generator = registry.get(id);\n\n      const deferred = context.newPromise();\n\n      if (!generator) {\n        // Generator not found - return a completed result\n        const resultHandle = marshal(context, { value, done: true });\n        deferred.resolve(resultHandle);\n        resultHandle.dispose();\n        context.runtime.executePendingJobs();\n        return deferred.handle;\n      }\n\n      generator\n        .return(value)\n        .then((result) => {\n          if (!context.alive) return;\n\n          const resultHandle = marshal(context, {\n            value: result.value,\n            done: result.done,\n          });\n          deferred.resolve(resultHandle);\n          resultHandle.dispose();\n\n          // Always clean up after return\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        })\n        .catch((error) => {\n          if (!context.alive) return;\n\n          const errorHandle = context.newError(\n            error instanceof Error ? error.message : String(error)\n          );\n          deferred.reject(errorHandle);\n          errorHandle.dispose();\n\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        });\n\n      return deferred.handle;\n    }\n  );\n  context.setProp(context.global, \"__asyncIteratorReturn__\", returnFn);\n  returnFn.dispose();\n\n  // __asyncIteratorThrow__(id, error) - calls generator.throw(error)\n  const throwFn = context.newFunction(\n    \"__asyncIteratorThrow__\",\n    (idHandle: QuickJSHandle, errorHandle: QuickJSHandle) => {\n      const id = context.getNumber(idHandle);\n      const errorValue = unmarshal(context, errorHandle);\n      const registry = getGeneratorRegistry(context);\n      const generator = registry.get(id);\n\n      const deferred = context.newPromise();\n\n      if (!generator) {\n        // Generator not found - reject with a proper error\n        const errHandle = context.newError(\n          errorValue instanceof Error ? errorValue.message : String(errorValue)\n        );\n        deferred.reject(errHandle);\n        errHandle.dispose();\n        context.runtime.executePendingJobs();\n        return deferred.handle;\n      }\n\n      // Convert to Error if needed\n      const error =\n        errorValue instanceof Error\n          ? errorValue\n          : new Error(String(errorValue));\n\n      generator\n        .throw(error)\n        .then((result) => {\n          if (!context.alive) return;\n\n          const resultHandle = marshal(context, {\n            value: result.value,\n            done: result.done,\n          });\n          deferred.resolve(resultHandle);\n          resultHandle.dispose();\n\n          if (result.done) {\n            registry.delete(id);\n          }\n\n          context.runtime.executePendingJobs();\n        })\n        .catch((err) => {\n          if (!context.alive) return;\n\n          const errHandle = context.newError(\n            err instanceof Error ? err.message : String(err)\n          );\n          deferred.reject(errHandle);\n          errHandle.dispose();\n\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        });\n\n      return deferred.handle;\n    }\n  );\n  context.setProp(context.global, \"__asyncIteratorThrow__\", throwFn);\n  throwFn.dispose();\n}\n\n/**\n * Define a global function in the QuickJS context\n *\n * @returns Handle to the function (caller must manage disposal)\n *\n * @example\n * const logFn = defineFunction(context, \"log\", (...args) => {\n *   console.log(\"[QuickJS]\", ...args);\n * });\n * context.setProp(context.global, \"log\", logFn);\n */\nexport function defineFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => unknown\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    try {\n      // Call host function\n      const result = fn(...args);\n\n      // Marshal result\n      return marshal(context, result);\n    } catch (error) {\n      // Throw error in QuickJS\n      throw context.newError(\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n  });\n}\n\n/**\n * Define an async function that returns a promise to QuickJS\n *\n * @example\n * const fetchFn = defineAsyncFunction(context, \"fetch\", async (url) => {\n *   const response = await fetch(String(url));\n *   return response.text();\n * });\n */\nexport function defineAsyncFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => Promise<unknown>\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    // Create a promise in QuickJS\n    const deferred = context.newPromise();\n\n    // Call the async function\n    fn(...args)\n      .then((result) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const resultHandle = marshal(context, result);\n        deferred.resolve(resultHandle);\n        resultHandle.dispose();\n        context.runtime.executePendingJobs();\n      })\n      .catch((error) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const errorHandle = marshal(\n          context,\n          error instanceof Error\n            ? { name: error.name, message: error.message }\n            : { message: String(error) }\n        );\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        context.runtime.executePendingJobs();\n      });\n\n    return deferred.handle;\n  });\n}\n\n/**\n * Define an async iterator function that returns an async iterable to QuickJS.\n * The host function should be an async generator.\n *\n * @example\n * const streamFn = defineAsyncIteratorFunction(context, \"stream\", async function* (n) {\n *   for (let i = 0; i < n; i++) {\n *     yield i;\n *   }\n *   return \"done\";\n * });\n *\n * // In QuickJS:\n * // for await (const value of stream(3)) { console.log(value); }\n * // Outputs: 0, 1, 2\n */\nexport function defineAsyncIteratorFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => AsyncGenerator<unknown, unknown, unknown>\n): QuickJSHandle {\n  // Ensure infrastructure is set up\n  setupAsyncIteratorInfrastructure(context);\n\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    try {\n      // Call host function to get generator instance\n      const generator = fn(...args);\n\n      // Register generator and get ID\n      const generatorId = registerGenerator(context, generator);\n\n      // Create proxy object that implements async iterator protocol\n      // This object when iterated will call our infrastructure helpers\n      const result = context.evalCode(`({\n        [Symbol.asyncIterator]() {\n          return {\n            next: () => __asyncIteratorNext__(${generatorId}),\n            return: (v) => __asyncIteratorReturn__(${generatorId}, v),\n            throw: (e) => __asyncIteratorThrow__(${generatorId}, e)\n          };\n        }\n      })`);\n\n      if (result.error) {\n        const err = context.dump(result.error);\n        result.error.dispose();\n        // Clean up the registered generator since we failed\n        const registry = getGeneratorRegistry(context);\n        registry.delete(generatorId);\n        throw context.newError(String(err));\n      }\n\n      return result.value;\n    } catch (error) {\n      // Throw error in QuickJS\n      throw context.newError(\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n  });\n}\n\n/**\n * Clean up all async iterator state for a context.\n * Should be called before context disposal.\n */\nexport function cleanupAsyncIterators(context: QuickJSContext): void {\n  generatorRegistries.delete(context);\n  generatorCounters.delete(context);\n  // Note: setupContexts uses WeakSet, so no need to explicitly delete\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAC0B,IAA1B;AACwB,IAAxB;AAaO,SAAS,cAAc,CAC5B,SACA,MACA,IACe;AAAA,EACf,OAAO,QAAQ,YAAY,MAAM,IAAI,eAAe;AAAA,IAElD,MAAM,OAAO,WAAW,IAAI,CAAC,MAAM,2BAAU,SAAS,CAAC,CAAC;AAAA,IAExD,IAAI;AAAA,MAEF,MAAM,SAAS,GAAG,GAAG,IAAI;AAAA,MAGzB,OAAO,uBAAQ,SAAS,MAAM;AAAA,MAC9B,OAAO,OAAO;AAAA,MAEd,MAAM,QAAQ,SACZ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA;AAAA,GAEH;AAAA;AAYI,SAAS,mBAAmB,CACjC,SACA,MACA,IACe;AAAA,EACf,OAAO,QAAQ,YAAY,MAAM,IAAI,eAAe;AAAA,IAElD,MAAM,OAAO,WAAW,IAAI,CAAC,MAAM,2BAAU,SAAS,CAAC,CAAC;AAAA,IAGxD,MAAM,WAAW,QAAQ,WAAW;AAAA,IAGpC,GAAG,GAAG,IAAI,EACP,KAAK,CAAC,WAAW;AAAA,MAEhB,IAAI,CAAC,QAAQ,OAAO;AAAA,QAClB;AAAA,MACF;AAAA,MACA,MAAM,eAAe,uBAAQ,SAAS,MAAM;AAAA,MAC5C,SAAS,QAAQ,YAAY;AAAA,MAC7B,aAAa,QAAQ;AAAA,MACrB,QAAQ,QAAQ,mBAAmB;AAAA,KACpC,EACA,MAAM,CAAC,UAAU;AAAA,MAEhB,IAAI,CAAC,QAAQ,OAAO;AAAA,QAClB;AAAA,MACF;AAAA,MACA,MAAM,cAAc,uBAClB,SACA,iBAAiB,QACb,EAAE,MAAM,MAAM,MAAM,SAAS,MAAM,QAAQ,IAC3C,EAAE,SAAS,OAAO,KAAK,EAAE,CAC/B;AAAA,MACA,SAAS,OAAO,WAAW;AAAA,MAC3B,YAAY,QAAQ;AAAA,MACpB,QAAQ,QAAQ,mBAAmB;AAAA,KACpC;AAAA,IAEH,OAAO,SAAS;AAAA,GACjB;AAAA;",
-  "debugId": "C5D7588C3C8B806E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "679B9EDB41D36FF564756E2164756E21",
   "names": []
 }

package/dist/cjs/index.cjs

@@ -58,6 +58,7 @@ __export(exports_src, {
   getClassInstanceState: () => import_class_helpers.getClassInstanceState,
   defineFunction: () => import_function_builder.defineFunction,
   defineClass: () => import_class_builder2.defineClass,
+  defineAsyncIteratorFunction: () => import_function_builder.defineAsyncIteratorFunction,
   defineAsyncFunction: () => import_function_builder.defineAsyncFunction,
   createWritableStream: () => import_writable_stream2.createWritableStream,
   createURLSearchParamsClass: () => import_url_search_params2.createURLSearchParamsClass,
@@ -79,6 +80,7 @@ __export(exports_src, {
   cleanupUnmarshaledHandles: () => import_unmarshal.cleanupUnmarshaledHandles,
   cleanupInstanceStateById: () => import_instance_state.cleanupInstanceState,
   cleanupInstanceState: () => import_class_builder2.cleanupInstanceState,
+  cleanupAsyncIterators: () => import_function_builder.cleanupAsyncIterators,
   classCoercer: () => import_coerce.classCoercer,
   addURLSearchParamsLinkage: () => import_url2.addURLSearchParamsLinkage,
   addURLSearchParamsGetter: () => import_url2.addURLSearchParamsGetter,
@@ -285,4 +287,4 @@ function setupCore(context, options) {
 }
 })
 
-//# debugId=AAC8B5BEA5BE896D64756E2164756E21
+//# debugId=2704213322BFE26C64756E2164756E21

package/dist/cjs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { SetupCoreOptions, CoreHandle, StateMap } from \"./types.cjs\";\nimport { createStateMap } from \"./class-builder.cjs\";\nimport {\n  createReadableStreamClass,\n  createReadableStreamDefaultReaderClass,\n  createReadableStream,\n} from \"./streams/readable-stream.cjs\";\nimport {\n  createWritableStreamClass,\n  createWritableStreamDefaultWriterClass,\n} from \"./streams/writable-stream.cjs\";\nimport { createTransformStreamClass } from \"./streams/transform-stream.cjs\";\nimport { createBlobClass } from \"./blob.cjs\";\nimport { createFileClass } from \"./file.cjs\";\nimport { createDOMExceptionClass } from \"./dom-exception.cjs\";\nimport { createURLSearchParamsClass } from \"./url-search-params.cjs\";\nimport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.cjs\";\n\n/**\n * Setup core APIs in a QuickJS context\n *\n * Injects the following globals:\n * - ReadableStream, WritableStream, TransformStream\n * - ReadableStreamDefaultReader, WritableStreamDefaultWriter\n * - Blob\n * - File\n * - DOMException\n * - URL, URLSearchParams\n * - TextEncoder, TextDecoder\n *\n * @example\n * const handle = setupCore(context);\n *\n * context.evalCode(`\n *   const blob = new Blob([\"hello\", \" \", \"world\"], { type: \"text/plain\" });\n *   const text = await blob.text(); // \"hello world\"\n *\n *   const stream = new ReadableStream({\n *     start(controller) {\n *       controller.enqueue(\"chunk1\");\n *       controller.enqueue(\"chunk2\");\n *       controller.close();\n *     }\n *   });\n * `);\n */\nexport function setupCore(\n  context: QuickJSContext,\n  options?: SetupCoreOptions\n): CoreHandle {\n  const stateMap = options?.stateMap ?? createStateMap();\n  const handles: { name: string; handle: QuickJSHandle }[] = [];\n\n  // Create ReadableStreamDefaultReader class first\n  const ReadableStreamDefaultReader = createReadableStreamDefaultReaderClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"ReadableStreamDefaultReader\",\n    ReadableStreamDefaultReader\n  );\n  ReadableStreamDefaultReader.dispose();\n\n  // Create ReadableStream class\n  const readerClassRef = context.getProp(context.global, \"ReadableStreamDefaultReader\");\n  const ReadableStream = createReadableStreamClass(\n    context,\n    stateMap,\n    readerClassRef\n  );\n  readerClassRef.dispose();\n  context.setProp(context.global, \"ReadableStream\", ReadableStream);\n  ReadableStream.dispose();\n\n  // Create WritableStreamDefaultWriter class first\n  const WritableStreamDefaultWriter = createWritableStreamDefaultWriterClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"WritableStreamDefaultWriter\",\n    WritableStreamDefaultWriter\n  );\n  WritableStreamDefaultWriter.dispose();\n\n  // Create WritableStream class\n  const writerClassRef = context.getProp(context.global, \"WritableStreamDefaultWriter\");\n  const WritableStream = createWritableStreamClass(\n    context,\n    stateMap,\n    writerClassRef\n  );\n  writerClassRef.dispose();\n  context.setProp(context.global, \"WritableStream\", WritableStream);\n  WritableStream.dispose();\n\n  // Create TransformStream class\n  const TransformStream = createTransformStreamClass(context, stateMap);\n  context.setProp(context.global, \"TransformStream\", TransformStream);\n  TransformStream.dispose();\n\n  // Create Blob class with stream factory\n  const BlobClass = createBlobClass(context, stateMap, (source) =>\n    createReadableStream(context, stateMap, source)\n  );\n  context.setProp(context.global, \"Blob\", BlobClass);\n  BlobClass.dispose();\n\n  // Create File class (extends Blob)\n  const blobClassRef = context.getProp(context.global, \"Blob\");\n  const FileClass = createFileClass(context, stateMap, blobClassRef);\n  blobClassRef.dispose();\n  context.setProp(context.global, \"File\", FileClass);\n  FileClass.dispose();\n\n  // Create DOMException class\n  const DOMExceptionClass = createDOMExceptionClass(context, stateMap);\n  context.setProp(context.global, \"DOMException\", DOMExceptionClass);\n  DOMExceptionClass.dispose();\n\n  // Create URLSearchParams class\n  const URLSearchParamsClass = createURLSearchParamsClass(context, stateMap);\n  context.setProp(context.global, \"URLSearchParams\", URLSearchParamsClass);\n  URLSearchParamsClass.dispose();\n\n  // Add Symbol.iterator support for URLSearchParams\n  const urlSearchParamsIteratorResult = context.evalCode(`\n    URLSearchParams.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (urlSearchParamsIteratorResult.error) {\n    urlSearchParamsIteratorResult.error.dispose();\n  } else {\n    urlSearchParamsIteratorResult.value.dispose();\n  }\n\n  // Create URL class (depends on URLSearchParams)\n  const URLClass = createURLClass(context, stateMap);\n  context.setProp(context.global, \"URL\", URLClass);\n  URLClass.dispose();\n\n  // Add searchParams getter to URL that returns URLSearchParams instance\n  // Uses JavaScript closures to sync URLSearchParams mutations back to URL\n  addURLSearchParamsLinkage(context);\n\n  // TextEncoder/TextDecoder - pure JS implementation for UTF-8\n  const textEncodingCode = `\n(function() {\n  class TextEncoder {\n    constructor(encoding = \"utf-8\") {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n    }\n\n    encode(input = \"\") {\n      const str = String(input);\n      const bytes = [];\n\n      for (let i = 0; i < str.length; i++) {\n        let charCode = str.charCodeAt(i);\n\n        if (charCode < 0x80) {\n          bytes.push(charCode);\n        } else if (charCode < 0x800) {\n          bytes.push(0xC0 | (charCode >> 6));\n          bytes.push(0x80 | (charCode & 0x3F));\n        } else if (charCode >= 0xD800 && charCode <= 0xDBFF) {\n          const nextCharCode = str.charCodeAt(++i);\n          if (nextCharCode >= 0xDC00 && nextCharCode <= 0xDFFF) {\n            const codePoint = 0x10000 + ((charCode - 0xD800) << 10) + (nextCharCode - 0xDC00);\n            bytes.push(0xF0 | (codePoint >> 18));\n            bytes.push(0x80 | ((codePoint >> 12) & 0x3F));\n            bytes.push(0x80 | ((codePoint >> 6) & 0x3F));\n            bytes.push(0x80 | (codePoint & 0x3F));\n          }\n        } else if (charCode < 0x10000) {\n          bytes.push(0xE0 | (charCode >> 12));\n          bytes.push(0x80 | ((charCode >> 6) & 0x3F));\n          bytes.push(0x80 | (charCode & 0x3F));\n        }\n      }\n\n      return new Uint8Array(bytes);\n    }\n\n    encodeInto(source, destination) {\n      const encoded = this.encode(source);\n      const len = Math.min(encoded.length, destination.length);\n      destination.set(encoded.subarray(0, len));\n      return { read: source.length, written: len };\n    }\n  }\n\n  class TextDecoder {\n    constructor(encoding = \"utf-8\", options = {}) {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n      this.fatal = Boolean(options.fatal);\n      this.ignoreBOM = Boolean(options.ignoreBOM);\n    }\n\n    decode(input, options = {}) {\n      if (!input) return \"\";\n\n      let bytes;\n      if (input instanceof ArrayBuffer) {\n        bytes = new Uint8Array(input);\n      } else if (ArrayBuffer.isView(input)) {\n        bytes = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n      } else if (input instanceof Uint8Array) {\n        bytes = input;\n      } else {\n        throw new TypeError(\"The provided value is not of type '(ArrayBuffer or ArrayBufferView)'\");\n      }\n\n      let offset = 0;\n      if (!this.ignoreBOM && bytes.length >= 3 &&\n          bytes[0] === 0xEF && bytes[1] === 0xBB && bytes[2] === 0xBF) {\n        offset = 3;\n      }\n\n      let result = \"\";\n      for (let i = offset; i < bytes.length;) {\n        const byte1 = bytes[i++];\n\n        if (byte1 < 0x80) {\n          result += String.fromCharCode(byte1);\n        } else if ((byte1 & 0xE0) === 0xC0) {\n          const byte2 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x1F) << 6) | byte2);\n        } else if ((byte1 & 0xF0) === 0xE0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x0F) << 12) | (byte2 << 6) | byte3);\n        } else if ((byte1 & 0xF8) === 0xF0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          const byte4 = bytes[i++] & 0x3F;\n          const codePoint = ((byte1 & 0x07) << 18) | (byte2 << 12) | (byte3 << 6) | byte4;\n          const adjusted = codePoint - 0x10000;\n          result += String.fromCharCode(0xD800 + (adjusted >> 10), 0xDC00 + (adjusted & 0x3FF));\n        }\n      }\n\n      return result;\n    }\n  }\n\n  globalThis.TextEncoder = TextEncoder;\n  globalThis.TextDecoder = TextDecoder;\n})();\n`;\n\n  const textEncodingResult = context.evalCode(textEncodingCode);\n  if (textEncodingResult.error) {\n    console.error(\"Failed to setup TextEncoder/TextDecoder\");\n    textEncodingResult.error.dispose();\n  } else {\n    textEncodingResult.value.dispose();\n  }\n\n  /**\n   * @returns CoreHandle with shared stateMap and dispose method\n   *\n   * **dispose() behavior:**\n   * - Clears internal handle tracking array\n   * - Does NOT dispose globals (ReadableStream, Blob, etc.) - they are owned\n   *   by context.global and cleaned up by context.dispose()\n   * - Call before context.dispose() to release internal references\n   *\n   * @see PATTERNS.md for implementation patterns\n   */\n  return {\n    stateMap,\n    dispose() {\n      // Note: handles set on global (ReadableStream, Blob, etc.) are NOT disposed here\n      // They are owned by the global object and will be cleaned up by context.dispose()\n      // Disposing them before context disposal causes QuickJS GC assertion failures\n      handles.length = 0;\n    },\n  };\n}\n\n// Re-export types\nexport type {\n  Scope,\n  MarshalOptions,\n  UnmarshalOptions,\n  PropertyDescriptor,\n  ClassDefinition,\n  StateMap,\n  SetupCoreOptions,\n  CoreHandle,\n  QuickJSContext,\n  QuickJSHandle,\n  QuickJSRuntime,\n} from \"./types.cjs\";\nexport { INTERNAL_STATE } from \"./types.cjs\";\n\n// Re-export utilities\nexport { withScope, withScopeAsync } from \"./scope.cjs\";\nexport { marshal, isHandle, getHandleType } from \"./marshal.cjs\";\nexport { unmarshal, cleanupUnmarshaledHandles } from \"./unmarshal.cjs\";\nexport { defineFunction, defineAsyncFunction } from \"./function-builder.cjs\";\nexport {\n  defineClass,\n  createStateMap,\n  getState,\n  setState,\n  getInstanceState,\n  setInstanceState,\n  getInstanceStateById,\n  cleanupInstanceState,\n  clearAllInstanceState,\n} from \"./class-builder.cjs\";\n\n// Re-export class instance helpers for cross-class access\nexport {\n  isDefineClassInstance,\n  isInstanceOf,\n  getClassInstanceState,\n  getInstanceId,\n  getClassName,\n  createClassTypeGuard,\n  isUnmarshalledRequest,\n  isUnmarshalledResponse,\n  isUnmarshalledHeaders,\n  isUnmarshalledFormData,\n} from \"./class-helpers.cjs\";\nexport type { DefineClassInstance, TypedClassInstance } from \"./class-helpers.cjs\";\n\n// Re-export instance state management\nexport {\n  nextInstanceId,\n  registerInstance,\n  getInstanceMetadata,\n  getInstanceClassName,\n  cleanupInstanceState as cleanupInstanceStateById,\n} from \"./instance-state.cjs\";\nexport type { InstanceMetadata } from \"./instance-state.cjs\";\n\n// Re-export stream utilities\nexport {\n  createReadableStream,\n  consumeReadableStream,\n} from \"./streams/readable-stream.cjs\";\nexport { createWritableStream } from \"./streams/writable-stream.cjs\";\n\n// Re-export Blob/File utilities\nexport { createBlob } from \"./blob.cjs\";\nexport { createFile } from \"./file.cjs\";\n\n// Re-export URL utilities\nexport { createURLSearchParamsClass } from \"./url-search-params.cjs\";\nexport type { URLSearchParamsState } from \"./url-search-params.cjs\";\nexport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.cjs\";\nexport type { URLState } from \"./url.cjs\";\n\n// Re-export coercion utilities\nexport {\n  createCoercer,\n  classCoercer,\n  instanceOrShape,\n  coerceURL,\n  coerceToURLString,\n  coerceHeaders,\n  coerceBody,\n  coerceRequestInit,\n  coerceResponseInit,\n} from \"./coerce.cjs\";\nexport type {\n  Coercer,\n  CoercionResult,\n  URLCoerced,\n  HeadersCoerced,\n  RequestInitCoerced,\n  ResponseInitCoerced,\n} from \"./coerce.cjs\";\n"
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { SetupCoreOptions, CoreHandle, StateMap } from \"./types.cjs\";\nimport { createStateMap } from \"./class-builder.cjs\";\nimport {\n  createReadableStreamClass,\n  createReadableStreamDefaultReaderClass,\n  createReadableStream,\n} from \"./streams/readable-stream.cjs\";\nimport {\n  createWritableStreamClass,\n  createWritableStreamDefaultWriterClass,\n} from \"./streams/writable-stream.cjs\";\nimport { createTransformStreamClass } from \"./streams/transform-stream.cjs\";\nimport { createBlobClass } from \"./blob.cjs\";\nimport { createFileClass } from \"./file.cjs\";\nimport { createDOMExceptionClass } from \"./dom-exception.cjs\";\nimport { createURLSearchParamsClass } from \"./url-search-params.cjs\";\nimport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.cjs\";\n\n/**\n * Setup core APIs in a QuickJS context\n *\n * Injects the following globals:\n * - ReadableStream, WritableStream, TransformStream\n * - ReadableStreamDefaultReader, WritableStreamDefaultWriter\n * - Blob\n * - File\n * - DOMException\n * - URL, URLSearchParams\n * - TextEncoder, TextDecoder\n *\n * @example\n * const handle = setupCore(context);\n *\n * context.evalCode(`\n *   const blob = new Blob([\"hello\", \" \", \"world\"], { type: \"text/plain\" });\n *   const text = await blob.text(); // \"hello world\"\n *\n *   const stream = new ReadableStream({\n *     start(controller) {\n *       controller.enqueue(\"chunk1\");\n *       controller.enqueue(\"chunk2\");\n *       controller.close();\n *     }\n *   });\n * `);\n */\nexport function setupCore(\n  context: QuickJSContext,\n  options?: SetupCoreOptions\n): CoreHandle {\n  const stateMap = options?.stateMap ?? createStateMap();\n  const handles: { name: string; handle: QuickJSHandle }[] = [];\n\n  // Create ReadableStreamDefaultReader class first\n  const ReadableStreamDefaultReader = createReadableStreamDefaultReaderClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"ReadableStreamDefaultReader\",\n    ReadableStreamDefaultReader\n  );\n  ReadableStreamDefaultReader.dispose();\n\n  // Create ReadableStream class\n  const readerClassRef = context.getProp(context.global, \"ReadableStreamDefaultReader\");\n  const ReadableStream = createReadableStreamClass(\n    context,\n    stateMap,\n    readerClassRef\n  );\n  readerClassRef.dispose();\n  context.setProp(context.global, \"ReadableStream\", ReadableStream);\n  ReadableStream.dispose();\n\n  // Create WritableStreamDefaultWriter class first\n  const WritableStreamDefaultWriter = createWritableStreamDefaultWriterClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"WritableStreamDefaultWriter\",\n    WritableStreamDefaultWriter\n  );\n  WritableStreamDefaultWriter.dispose();\n\n  // Create WritableStream class\n  const writerClassRef = context.getProp(context.global, \"WritableStreamDefaultWriter\");\n  const WritableStream = createWritableStreamClass(\n    context,\n    stateMap,\n    writerClassRef\n  );\n  writerClassRef.dispose();\n  context.setProp(context.global, \"WritableStream\", WritableStream);\n  WritableStream.dispose();\n\n  // Create TransformStream class\n  const TransformStream = createTransformStreamClass(context, stateMap);\n  context.setProp(context.global, \"TransformStream\", TransformStream);\n  TransformStream.dispose();\n\n  // Create Blob class with stream factory\n  const BlobClass = createBlobClass(context, stateMap, (source) =>\n    createReadableStream(context, stateMap, source)\n  );\n  context.setProp(context.global, \"Blob\", BlobClass);\n  BlobClass.dispose();\n\n  // Create File class (extends Blob)\n  const blobClassRef = context.getProp(context.global, \"Blob\");\n  const FileClass = createFileClass(context, stateMap, blobClassRef);\n  blobClassRef.dispose();\n  context.setProp(context.global, \"File\", FileClass);\n  FileClass.dispose();\n\n  // Create DOMException class\n  const DOMExceptionClass = createDOMExceptionClass(context, stateMap);\n  context.setProp(context.global, \"DOMException\", DOMExceptionClass);\n  DOMExceptionClass.dispose();\n\n  // Create URLSearchParams class\n  const URLSearchParamsClass = createURLSearchParamsClass(context, stateMap);\n  context.setProp(context.global, \"URLSearchParams\", URLSearchParamsClass);\n  URLSearchParamsClass.dispose();\n\n  // Add Symbol.iterator support for URLSearchParams\n  const urlSearchParamsIteratorResult = context.evalCode(`\n    URLSearchParams.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (urlSearchParamsIteratorResult.error) {\n    urlSearchParamsIteratorResult.error.dispose();\n  } else {\n    urlSearchParamsIteratorResult.value.dispose();\n  }\n\n  // Create URL class (depends on URLSearchParams)\n  const URLClass = createURLClass(context, stateMap);\n  context.setProp(context.global, \"URL\", URLClass);\n  URLClass.dispose();\n\n  // Add searchParams getter to URL that returns URLSearchParams instance\n  // Uses JavaScript closures to sync URLSearchParams mutations back to URL\n  addURLSearchParamsLinkage(context);\n\n  // TextEncoder/TextDecoder - pure JS implementation for UTF-8\n  const textEncodingCode = `\n(function() {\n  class TextEncoder {\n    constructor(encoding = \"utf-8\") {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n    }\n\n    encode(input = \"\") {\n      const str = String(input);\n      const bytes = [];\n\n      for (let i = 0; i < str.length; i++) {\n        let charCode = str.charCodeAt(i);\n\n        if (charCode < 0x80) {\n          bytes.push(charCode);\n        } else if (charCode < 0x800) {\n          bytes.push(0xC0 | (charCode >> 6));\n          bytes.push(0x80 | (charCode & 0x3F));\n        } else if (charCode >= 0xD800 && charCode <= 0xDBFF) {\n          const nextCharCode = str.charCodeAt(++i);\n          if (nextCharCode >= 0xDC00 && nextCharCode <= 0xDFFF) {\n            const codePoint = 0x10000 + ((charCode - 0xD800) << 10) + (nextCharCode - 0xDC00);\n            bytes.push(0xF0 | (codePoint >> 18));\n            bytes.push(0x80 | ((codePoint >> 12) & 0x3F));\n            bytes.push(0x80 | ((codePoint >> 6) & 0x3F));\n            bytes.push(0x80 | (codePoint & 0x3F));\n          }\n        } else if (charCode < 0x10000) {\n          bytes.push(0xE0 | (charCode >> 12));\n          bytes.push(0x80 | ((charCode >> 6) & 0x3F));\n          bytes.push(0x80 | (charCode & 0x3F));\n        }\n      }\n\n      return new Uint8Array(bytes);\n    }\n\n    encodeInto(source, destination) {\n      const encoded = this.encode(source);\n      const len = Math.min(encoded.length, destination.length);\n      destination.set(encoded.subarray(0, len));\n      return { read: source.length, written: len };\n    }\n  }\n\n  class TextDecoder {\n    constructor(encoding = \"utf-8\", options = {}) {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n      this.fatal = Boolean(options.fatal);\n      this.ignoreBOM = Boolean(options.ignoreBOM);\n    }\n\n    decode(input, options = {}) {\n      if (!input) return \"\";\n\n      let bytes;\n      if (input instanceof ArrayBuffer) {\n        bytes = new Uint8Array(input);\n      } else if (ArrayBuffer.isView(input)) {\n        bytes = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n      } else if (input instanceof Uint8Array) {\n        bytes = input;\n      } else {\n        throw new TypeError(\"The provided value is not of type '(ArrayBuffer or ArrayBufferView)'\");\n      }\n\n      let offset = 0;\n      if (!this.ignoreBOM && bytes.length >= 3 &&\n          bytes[0] === 0xEF && bytes[1] === 0xBB && bytes[2] === 0xBF) {\n        offset = 3;\n      }\n\n      let result = \"\";\n      for (let i = offset; i < bytes.length;) {\n        const byte1 = bytes[i++];\n\n        if (byte1 < 0x80) {\n          result += String.fromCharCode(byte1);\n        } else if ((byte1 & 0xE0) === 0xC0) {\n          const byte2 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x1F) << 6) | byte2);\n        } else if ((byte1 & 0xF0) === 0xE0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x0F) << 12) | (byte2 << 6) | byte3);\n        } else if ((byte1 & 0xF8) === 0xF0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          const byte4 = bytes[i++] & 0x3F;\n          const codePoint = ((byte1 & 0x07) << 18) | (byte2 << 12) | (byte3 << 6) | byte4;\n          const adjusted = codePoint - 0x10000;\n          result += String.fromCharCode(0xD800 + (adjusted >> 10), 0xDC00 + (adjusted & 0x3FF));\n        }\n      }\n\n      return result;\n    }\n  }\n\n  globalThis.TextEncoder = TextEncoder;\n  globalThis.TextDecoder = TextDecoder;\n})();\n`;\n\n  const textEncodingResult = context.evalCode(textEncodingCode);\n  if (textEncodingResult.error) {\n    console.error(\"Failed to setup TextEncoder/TextDecoder\");\n    textEncodingResult.error.dispose();\n  } else {\n    textEncodingResult.value.dispose();\n  }\n\n  /**\n   * @returns CoreHandle with shared stateMap and dispose method\n   *\n   * **dispose() behavior:**\n   * - Clears internal handle tracking array\n   * - Does NOT dispose globals (ReadableStream, Blob, etc.) - they are owned\n   *   by context.global and cleaned up by context.dispose()\n   * - Call before context.dispose() to release internal references\n   *\n   * @see PATTERNS.md for implementation patterns\n   */\n  return {\n    stateMap,\n    dispose() {\n      // Note: handles set on global (ReadableStream, Blob, etc.) are NOT disposed here\n      // They are owned by the global object and will be cleaned up by context.dispose()\n      // Disposing them before context disposal causes QuickJS GC assertion failures\n      handles.length = 0;\n    },\n  };\n}\n\n// Re-export types\nexport type {\n  Scope,\n  MarshalOptions,\n  UnmarshalOptions,\n  PropertyDescriptor,\n  ClassDefinition,\n  StateMap,\n  SetupCoreOptions,\n  CoreHandle,\n  QuickJSContext,\n  QuickJSHandle,\n  QuickJSRuntime,\n} from \"./types.cjs\";\nexport { INTERNAL_STATE } from \"./types.cjs\";\n\n// Re-export utilities\nexport { withScope, withScopeAsync } from \"./scope.cjs\";\nexport { marshal, isHandle, getHandleType } from \"./marshal.cjs\";\nexport { unmarshal, cleanupUnmarshaledHandles } from \"./unmarshal.cjs\";\nexport {\n  defineFunction,\n  defineAsyncFunction,\n  defineAsyncIteratorFunction,\n  cleanupAsyncIterators,\n} from \"./function-builder.cjs\";\nexport {\n  defineClass,\n  createStateMap,\n  getState,\n  setState,\n  getInstanceState,\n  setInstanceState,\n  getInstanceStateById,\n  cleanupInstanceState,\n  clearAllInstanceState,\n} from \"./class-builder.cjs\";\n\n// Re-export class instance helpers for cross-class access\nexport {\n  isDefineClassInstance,\n  isInstanceOf,\n  getClassInstanceState,\n  getInstanceId,\n  getClassName,\n  createClassTypeGuard,\n  isUnmarshalledRequest,\n  isUnmarshalledResponse,\n  isUnmarshalledHeaders,\n  isUnmarshalledFormData,\n} from \"./class-helpers.cjs\";\nexport type { DefineClassInstance, TypedClassInstance } from \"./class-helpers.cjs\";\n\n// Re-export instance state management\nexport {\n  nextInstanceId,\n  registerInstance,\n  getInstanceMetadata,\n  getInstanceClassName,\n  cleanupInstanceState as cleanupInstanceStateById,\n} from \"./instance-state.cjs\";\nexport type { InstanceMetadata } from \"./instance-state.cjs\";\n\n// Re-export stream utilities\nexport {\n  createReadableStream,\n  consumeReadableStream,\n} from \"./streams/readable-stream.cjs\";\nexport { createWritableStream } from \"./streams/writable-stream.cjs\";\n\n// Re-export Blob/File utilities\nexport { createBlob } from \"./blob.cjs\";\nexport { createFile } from \"./file.cjs\";\n\n// Re-export URL utilities\nexport { createURLSearchParamsClass } from \"./url-search-params.cjs\";\nexport type { URLSearchParamsState } from \"./url-search-params.cjs\";\nexport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.cjs\";\nexport type { URLState } from \"./url.cjs\";\n\n// Re-export coercion utilities\nexport {\n  createCoercer,\n  classCoercer,\n  instanceOrShape,\n  coerceURL,\n  coerceToURLString,\n  coerceHeaders,\n  coerceBody,\n  coerceRequestInit,\n  coerceResponseInit,\n} from \"./coerce.cjs\";\nexport type {\n  Coercer,\n  CoercionResult,\n  URLCoerced,\n  HeadersCoerced,\n  RequestInitCoerced,\n  ResponseInitCoerced,\n} from \"./coerce.cjs\";\n"
   ],
-  "mappings": "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",
-  "debugId": "AAC8B5BEA5BE896D64756E2164756E21",
+  "mappings": "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",
+  "debugId": "2704213322BFE26C64756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-core",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "type": "commonjs"
 }

package/dist/mjs/function-builder.mjs

@@ -2,6 +2,153 @@
 // packages/core/src/function-builder.ts
 import { unmarshal } from "./unmarshal.mjs";
 import { marshal } from "./marshal.mjs";
+var generatorRegistries = new WeakMap;
+var generatorCounters = new WeakMap;
+var setupContexts = new WeakSet;
+function getGeneratorRegistry(context) {
+  let registry = generatorRegistries.get(context);
+  if (!registry) {
+    registry = new Map;
+    generatorRegistries.set(context, registry);
+  }
+  return registry;
+}
+function nextGeneratorId(context) {
+  let counter = generatorCounters.get(context);
+  if (!counter) {
+    counter = { value: 0 };
+    generatorCounters.set(context, counter);
+  }
+  return ++counter.value;
+}
+function registerGenerator(context, generator) {
+  const id = nextGeneratorId(context);
+  const registry = getGeneratorRegistry(context);
+  registry.set(id, generator);
+  return id;
+}
+function setupAsyncIteratorInfrastructure(context) {
+  if (setupContexts.has(context)) {
+    return;
+  }
+  setupContexts.add(context);
+  const nextFn = context.newFunction("__asyncIteratorNext__", (idHandle) => {
+    const id = context.getNumber(idHandle);
+    const registry = getGeneratorRegistry(context);
+    const generator = registry.get(id);
+    if (!generator) {
+      const deferred2 = context.newPromise();
+      const errorHandle = context.newError(`Generator ${id} not found`);
+      deferred2.reject(errorHandle);
+      errorHandle.dispose();
+      context.runtime.executePendingJobs();
+      return deferred2.handle;
+    }
+    const deferred = context.newPromise();
+    generator.next().then((result) => {
+      if (!context.alive)
+        return;
+      const resultHandle = marshal(context, {
+        value: result.value,
+        done: result.done
+      });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      if (result.done) {
+        registry.delete(id);
+      }
+      context.runtime.executePendingJobs();
+    }).catch((error) => {
+      if (!context.alive)
+        return;
+      const errorHandle = context.newError(error instanceof Error ? error.message : String(error));
+      deferred.reject(errorHandle);
+      errorHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    });
+    return deferred.handle;
+  });
+  context.setProp(context.global, "__asyncIteratorNext__", nextFn);
+  nextFn.dispose();
+  const returnFn = context.newFunction("__asyncIteratorReturn__", (idHandle, valueHandle) => {
+    const id = context.getNumber(idHandle);
+    const value = unmarshal(context, valueHandle);
+    const registry = getGeneratorRegistry(context);
+    const generator = registry.get(id);
+    const deferred = context.newPromise();
+    if (!generator) {
+      const resultHandle = marshal(context, { value, done: true });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      context.runtime.executePendingJobs();
+      return deferred.handle;
+    }
+    generator.return(value).then((result) => {
+      if (!context.alive)
+        return;
+      const resultHandle = marshal(context, {
+        value: result.value,
+        done: result.done
+      });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    }).catch((error) => {
+      if (!context.alive)
+        return;
+      const errorHandle = context.newError(error instanceof Error ? error.message : String(error));
+      deferred.reject(errorHandle);
+      errorHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    });
+    return deferred.handle;
+  });
+  context.setProp(context.global, "__asyncIteratorReturn__", returnFn);
+  returnFn.dispose();
+  const throwFn = context.newFunction("__asyncIteratorThrow__", (idHandle, errorHandle) => {
+    const id = context.getNumber(idHandle);
+    const errorValue = unmarshal(context, errorHandle);
+    const registry = getGeneratorRegistry(context);
+    const generator = registry.get(id);
+    const deferred = context.newPromise();
+    if (!generator) {
+      const errHandle = context.newError(errorValue instanceof Error ? errorValue.message : String(errorValue));
+      deferred.reject(errHandle);
+      errHandle.dispose();
+      context.runtime.executePendingJobs();
+      return deferred.handle;
+    }
+    const error = errorValue instanceof Error ? errorValue : new Error(String(errorValue));
+    generator.throw(error).then((result) => {
+      if (!context.alive)
+        return;
+      const resultHandle = marshal(context, {
+        value: result.value,
+        done: result.done
+      });
+      deferred.resolve(resultHandle);
+      resultHandle.dispose();
+      if (result.done) {
+        registry.delete(id);
+      }
+      context.runtime.executePendingJobs();
+    }).catch((err) => {
+      if (!context.alive)
+        return;
+      const errHandle = context.newError(err instanceof Error ? err.message : String(err));
+      deferred.reject(errHandle);
+      errHandle.dispose();
+      registry.delete(id);
+      context.runtime.executePendingJobs();
+    });
+    return deferred.handle;
+  });
+  context.setProp(context.global, "__asyncIteratorThrow__", throwFn);
+  throwFn.dispose();
+}
 function defineFunction(context, name, fn) {
   return context.newFunction(name, (...argHandles) => {
     const args = argHandles.map((h) => unmarshal(context, h));
@@ -37,9 +184,44 @@ function defineAsyncFunction(context, name, fn) {
     return deferred.handle;
   });
 }
+function defineAsyncIteratorFunction(context, name, fn) {
+  setupAsyncIteratorInfrastructure(context);
+  return context.newFunction(name, (...argHandles) => {
+    const args = argHandles.map((h) => unmarshal(context, h));
+    try {
+      const generator = fn(...args);
+      const generatorId = registerGenerator(context, generator);
+      const result = context.evalCode(`({
+        [Symbol.asyncIterator]() {
+          return {
+            next: () => __asyncIteratorNext__(${generatorId}),
+            return: (v) => __asyncIteratorReturn__(${generatorId}, v),
+            throw: (e) => __asyncIteratorThrow__(${generatorId}, e)
+          };
+        }
+      })`);
+      if (result.error) {
+        const err = context.dump(result.error);
+        result.error.dispose();
+        const registry = getGeneratorRegistry(context);
+        registry.delete(generatorId);
+        throw context.newError(String(err));
+      }
+      return result.value;
+    } catch (error) {
+      throw context.newError(error instanceof Error ? error.message : String(error));
+    }
+  });
+}
+function cleanupAsyncIterators(context) {
+  generatorRegistries.delete(context);
+  generatorCounters.delete(context);
+}
 export {
   defineFunction,
-  defineAsyncFunction
+  defineAsyncIteratorFunction,
+  defineAsyncFunction,
+  cleanupAsyncIterators
 };
 
-//# debugId=8B474E0BF8843F0764756E2164756E21
+//# debugId=1A737A5AACCCCD4964756E2164756E21

package/dist/mjs/function-builder.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/function-builder.ts"],
   "sourcesContent": [
-    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport { unmarshal } from \"./unmarshal.mjs\";\nimport { marshal } from \"./marshal.mjs\";\n\n/**\n * Define a global function in the QuickJS context\n *\n * @returns Handle to the function (caller must manage disposal)\n *\n * @example\n * const logFn = defineFunction(context, \"log\", (...args) => {\n *   console.log(\"[QuickJS]\", ...args);\n * });\n * context.setProp(context.global, \"log\", logFn);\n */\nexport function defineFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => unknown\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    try {\n      // Call host function\n      const result = fn(...args);\n\n      // Marshal result\n      return marshal(context, result);\n    } catch (error) {\n      // Throw error in QuickJS\n      throw context.newError(\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n  });\n}\n\n/**\n * Define an async function that returns a promise to QuickJS\n *\n * @example\n * const fetchFn = defineAsyncFunction(context, \"fetch\", async (url) => {\n *   const response = await fetch(String(url));\n *   return response.text();\n * });\n */\nexport function defineAsyncFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => Promise<unknown>\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    // Create a promise in QuickJS\n    const deferred = context.newPromise();\n\n    // Call the async function\n    fn(...args)\n      .then((result) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const resultHandle = marshal(context, result);\n        deferred.resolve(resultHandle);\n        resultHandle.dispose();\n        context.runtime.executePendingJobs();\n      })\n      .catch((error) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const errorHandle = marshal(\n          context,\n          error instanceof Error\n            ? { name: error.name, message: error.message }\n            : { message: String(error) }\n        );\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        context.runtime.executePendingJobs();\n      });\n\n    return deferred.handle;\n  });\n}\n"
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport { unmarshal } from \"./unmarshal.mjs\";\nimport { marshal } from \"./marshal.mjs\";\n\n/**\n * Registry for async generators, scoped per-context.\n * Uses WeakMap to automatically clean up when context is GC'd.\n */\nconst generatorRegistries = new WeakMap<\n  QuickJSContext,\n  Map<number, AsyncGenerator<unknown, unknown, unknown>>\n>();\n\n/**\n * Counter for generating unique generator IDs per context.\n */\nconst generatorCounters = new WeakMap<QuickJSContext, { value: number }>();\n\n/**\n * Track which contexts have had async iterator infrastructure set up.\n */\nconst setupContexts = new WeakSet<QuickJSContext>();\n\n/**\n * Get or create the generator registry for a context.\n */\nfunction getGeneratorRegistry(\n  context: QuickJSContext\n): Map<number, AsyncGenerator<unknown, unknown, unknown>> {\n  let registry = generatorRegistries.get(context);\n  if (!registry) {\n    registry = new Map();\n    generatorRegistries.set(context, registry);\n  }\n  return registry;\n}\n\n/**\n * Get next generator ID for a context.\n */\nfunction nextGeneratorId(context: QuickJSContext): number {\n  let counter = generatorCounters.get(context);\n  if (!counter) {\n    counter = { value: 0 };\n    generatorCounters.set(context, counter);\n  }\n  return ++counter.value;\n}\n\n/**\n * Register a generator and return its ID.\n */\nfunction registerGenerator(\n  context: QuickJSContext,\n  generator: AsyncGenerator<unknown, unknown, unknown>\n): number {\n  const id = nextGeneratorId(context);\n  const registry = getGeneratorRegistry(context);\n  registry.set(id, generator);\n  return id;\n}\n\n/**\n * Setup async iterator infrastructure helpers in the context.\n * These are global functions that proxy to host-side generators.\n */\nfunction setupAsyncIteratorInfrastructure(context: QuickJSContext): void {\n  if (setupContexts.has(context)) {\n    return;\n  }\n  setupContexts.add(context);\n\n  // __asyncIteratorNext__(id) - calls generator.next()\n  const nextFn = context.newFunction(\n    \"__asyncIteratorNext__\",\n    (idHandle: QuickJSHandle) => {\n      const id = context.getNumber(idHandle);\n      const registry = getGeneratorRegistry(context);\n      const generator = registry.get(id);\n\n      if (!generator) {\n        // Generator not found - already cleaned up or invalid ID\n        const deferred = context.newPromise();\n        const errorHandle = context.newError(`Generator ${id} not found`);\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        context.runtime.executePendingJobs();\n        return deferred.handle;\n      }\n\n      const deferred = context.newPromise();\n\n      generator\n        .next()\n        .then((result) => {\n          if (!context.alive) return;\n\n          const resultHandle = marshal(context, {\n            value: result.value,\n            done: result.done,\n          });\n          deferred.resolve(resultHandle);\n          resultHandle.dispose();\n\n          // Clean up if done\n          if (result.done) {\n            registry.delete(id);\n          }\n\n          context.runtime.executePendingJobs();\n        })\n        .catch((error) => {\n          if (!context.alive) return;\n\n          // Create a proper Error object for rejection\n          const errorHandle = context.newError(\n            error instanceof Error ? error.message : String(error)\n          );\n          deferred.reject(errorHandle);\n          errorHandle.dispose();\n\n          // Clean up on error\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        });\n\n      return deferred.handle;\n    }\n  );\n  context.setProp(context.global, \"__asyncIteratorNext__\", nextFn);\n  nextFn.dispose();\n\n  // __asyncIteratorReturn__(id, value) - calls generator.return(value)\n  const returnFn = context.newFunction(\n    \"__asyncIteratorReturn__\",\n    (idHandle: QuickJSHandle, valueHandle: QuickJSHandle) => {\n      const id = context.getNumber(idHandle);\n      const value = unmarshal(context, valueHandle);\n      const registry = getGeneratorRegistry(context);\n      const generator = registry.get(id);\n\n      const deferred = context.newPromise();\n\n      if (!generator) {\n        // Generator not found - return a completed result\n        const resultHandle = marshal(context, { value, done: true });\n        deferred.resolve(resultHandle);\n        resultHandle.dispose();\n        context.runtime.executePendingJobs();\n        return deferred.handle;\n      }\n\n      generator\n        .return(value)\n        .then((result) => {\n          if (!context.alive) return;\n\n          const resultHandle = marshal(context, {\n            value: result.value,\n            done: result.done,\n          });\n          deferred.resolve(resultHandle);\n          resultHandle.dispose();\n\n          // Always clean up after return\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        })\n        .catch((error) => {\n          if (!context.alive) return;\n\n          const errorHandle = context.newError(\n            error instanceof Error ? error.message : String(error)\n          );\n          deferred.reject(errorHandle);\n          errorHandle.dispose();\n\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        });\n\n      return deferred.handle;\n    }\n  );\n  context.setProp(context.global, \"__asyncIteratorReturn__\", returnFn);\n  returnFn.dispose();\n\n  // __asyncIteratorThrow__(id, error) - calls generator.throw(error)\n  const throwFn = context.newFunction(\n    \"__asyncIteratorThrow__\",\n    (idHandle: QuickJSHandle, errorHandle: QuickJSHandle) => {\n      const id = context.getNumber(idHandle);\n      const errorValue = unmarshal(context, errorHandle);\n      const registry = getGeneratorRegistry(context);\n      const generator = registry.get(id);\n\n      const deferred = context.newPromise();\n\n      if (!generator) {\n        // Generator not found - reject with a proper error\n        const errHandle = context.newError(\n          errorValue instanceof Error ? errorValue.message : String(errorValue)\n        );\n        deferred.reject(errHandle);\n        errHandle.dispose();\n        context.runtime.executePendingJobs();\n        return deferred.handle;\n      }\n\n      // Convert to Error if needed\n      const error =\n        errorValue instanceof Error\n          ? errorValue\n          : new Error(String(errorValue));\n\n      generator\n        .throw(error)\n        .then((result) => {\n          if (!context.alive) return;\n\n          const resultHandle = marshal(context, {\n            value: result.value,\n            done: result.done,\n          });\n          deferred.resolve(resultHandle);\n          resultHandle.dispose();\n\n          if (result.done) {\n            registry.delete(id);\n          }\n\n          context.runtime.executePendingJobs();\n        })\n        .catch((err) => {\n          if (!context.alive) return;\n\n          const errHandle = context.newError(\n            err instanceof Error ? err.message : String(err)\n          );\n          deferred.reject(errHandle);\n          errHandle.dispose();\n\n          registry.delete(id);\n\n          context.runtime.executePendingJobs();\n        });\n\n      return deferred.handle;\n    }\n  );\n  context.setProp(context.global, \"__asyncIteratorThrow__\", throwFn);\n  throwFn.dispose();\n}\n\n/**\n * Define a global function in the QuickJS context\n *\n * @returns Handle to the function (caller must manage disposal)\n *\n * @example\n * const logFn = defineFunction(context, \"log\", (...args) => {\n *   console.log(\"[QuickJS]\", ...args);\n * });\n * context.setProp(context.global, \"log\", logFn);\n */\nexport function defineFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => unknown\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    try {\n      // Call host function\n      const result = fn(...args);\n\n      // Marshal result\n      return marshal(context, result);\n    } catch (error) {\n      // Throw error in QuickJS\n      throw context.newError(\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n  });\n}\n\n/**\n * Define an async function that returns a promise to QuickJS\n *\n * @example\n * const fetchFn = defineAsyncFunction(context, \"fetch\", async (url) => {\n *   const response = await fetch(String(url));\n *   return response.text();\n * });\n */\nexport function defineAsyncFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => Promise<unknown>\n): QuickJSHandle {\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    // Create a promise in QuickJS\n    const deferred = context.newPromise();\n\n    // Call the async function\n    fn(...args)\n      .then((result) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const resultHandle = marshal(context, result);\n        deferred.resolve(resultHandle);\n        resultHandle.dispose();\n        context.runtime.executePendingJobs();\n      })\n      .catch((error) => {\n        // Guard: Check if context is still alive\n        if (!context.alive) {\n          return;\n        }\n        const errorHandle = marshal(\n          context,\n          error instanceof Error\n            ? { name: error.name, message: error.message }\n            : { message: String(error) }\n        );\n        deferred.reject(errorHandle);\n        errorHandle.dispose();\n        context.runtime.executePendingJobs();\n      });\n\n    return deferred.handle;\n  });\n}\n\n/**\n * Define an async iterator function that returns an async iterable to QuickJS.\n * The host function should be an async generator.\n *\n * @example\n * const streamFn = defineAsyncIteratorFunction(context, \"stream\", async function* (n) {\n *   for (let i = 0; i < n; i++) {\n *     yield i;\n *   }\n *   return \"done\";\n * });\n *\n * // In QuickJS:\n * // for await (const value of stream(3)) { console.log(value); }\n * // Outputs: 0, 1, 2\n */\nexport function defineAsyncIteratorFunction(\n  context: QuickJSContext,\n  name: string,\n  fn: (...args: unknown[]) => AsyncGenerator<unknown, unknown, unknown>\n): QuickJSHandle {\n  // Ensure infrastructure is set up\n  setupAsyncIteratorInfrastructure(context);\n\n  return context.newFunction(name, (...argHandles) => {\n    // Unmarshal arguments\n    const args = argHandles.map((h) => unmarshal(context, h));\n\n    try {\n      // Call host function to get generator instance\n      const generator = fn(...args);\n\n      // Register generator and get ID\n      const generatorId = registerGenerator(context, generator);\n\n      // Create proxy object that implements async iterator protocol\n      // This object when iterated will call our infrastructure helpers\n      const result = context.evalCode(`({\n        [Symbol.asyncIterator]() {\n          return {\n            next: () => __asyncIteratorNext__(${generatorId}),\n            return: (v) => __asyncIteratorReturn__(${generatorId}, v),\n            throw: (e) => __asyncIteratorThrow__(${generatorId}, e)\n          };\n        }\n      })`);\n\n      if (result.error) {\n        const err = context.dump(result.error);\n        result.error.dispose();\n        // Clean up the registered generator since we failed\n        const registry = getGeneratorRegistry(context);\n        registry.delete(generatorId);\n        throw context.newError(String(err));\n      }\n\n      return result.value;\n    } catch (error) {\n      // Throw error in QuickJS\n      throw context.newError(\n        error instanceof Error ? error.message : String(error)\n      );\n    }\n  });\n}\n\n/**\n * Clean up all async iterator state for a context.\n * Should be called before context disposal.\n */\nexport function cleanupAsyncIterators(context: QuickJSContext): void {\n  generatorRegistries.delete(context);\n  generatorCounters.delete(context);\n  // Note: setupContexts uses WeakSet, so no need to explicitly delete\n}\n"
   ],
-  "mappings": ";;AACA;AACA;AAaO,SAAS,cAAc,CAC5B,SACA,MACA,IACe;AAAA,EACf,OAAO,QAAQ,YAAY,MAAM,IAAI,eAAe;AAAA,IAElD,MAAM,OAAO,WAAW,IAAI,CAAC,MAAM,UAAU,SAAS,CAAC,CAAC;AAAA,IAExD,IAAI;AAAA,MAEF,MAAM,SAAS,GAAG,GAAG,IAAI;AAAA,MAGzB,OAAO,QAAQ,SAAS,MAAM;AAAA,MAC9B,OAAO,OAAO;AAAA,MAEd,MAAM,QAAQ,SACZ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA;AAAA,GAEH;AAAA;AAYI,SAAS,mBAAmB,CACjC,SACA,MACA,IACe;AAAA,EACf,OAAO,QAAQ,YAAY,MAAM,IAAI,eAAe;AAAA,IAElD,MAAM,OAAO,WAAW,IAAI,CAAC,MAAM,UAAU,SAAS,CAAC,CAAC;AAAA,IAGxD,MAAM,WAAW,QAAQ,WAAW;AAAA,IAGpC,GAAG,GAAG,IAAI,EACP,KAAK,CAAC,WAAW;AAAA,MAEhB,IAAI,CAAC,QAAQ,OAAO;AAAA,QAClB;AAAA,MACF;AAAA,MACA,MAAM,eAAe,QAAQ,SAAS,MAAM;AAAA,MAC5C,SAAS,QAAQ,YAAY;AAAA,MAC7B,aAAa,QAAQ;AAAA,MACrB,QAAQ,QAAQ,mBAAmB;AAAA,KACpC,EACA,MAAM,CAAC,UAAU;AAAA,MAEhB,IAAI,CAAC,QAAQ,OAAO;AAAA,QAClB;AAAA,MACF;AAAA,MACA,MAAM,cAAc,QAClB,SACA,iBAAiB,QACb,EAAE,MAAM,MAAM,MAAM,SAAS,MAAM,QAAQ,IAC3C,EAAE,SAAS,OAAO,KAAK,EAAE,CAC/B;AAAA,MACA,SAAS,OAAO,WAAW;AAAA,MAC3B,YAAY,QAAQ;AAAA,MACpB,QAAQ,QAAQ,mBAAmB;AAAA,KACpC;AAAA,IAEH,OAAO,SAAS;AAAA,GACjB;AAAA;",
-  "debugId": "8B474E0BF8843F0764756E2164756E21",
+  "mappings": "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",
+  "debugId": "1A737A5AACCCCD4964756E2164756E21",
   "names": []
 }

package/dist/mjs/index.mjs

@@ -20,7 +20,12 @@ import { INTERNAL_STATE } from "./types.mjs";
 import { withScope, withScopeAsync } from "./scope.mjs";
 import { marshal, isHandle, getHandleType } from "./marshal.mjs";
 import { unmarshal, cleanupUnmarshaledHandles } from "./unmarshal.mjs";
-import { defineFunction, defineAsyncFunction } from "./function-builder.mjs";
+import {
+  defineFunction,
+  defineAsyncFunction,
+  defineAsyncIteratorFunction,
+  cleanupAsyncIterators
+} from "./function-builder.mjs";
 import {
   defineClass,
   createStateMap as createStateMap2,
@@ -274,6 +279,7 @@ export {
   getClassInstanceState,
   defineFunction,
   defineClass,
+  defineAsyncIteratorFunction,
   defineAsyncFunction,
   createWritableStream,
   createURLSearchParamsClass2 as createURLSearchParamsClass,
@@ -295,10 +301,11 @@ export {
   cleanupUnmarshaledHandles,
   cleanupInstanceState2 as cleanupInstanceStateById,
   cleanupInstanceState,
+  cleanupAsyncIterators,
   classCoercer,
   addURLSearchParamsLinkage2 as addURLSearchParamsLinkage,
   addURLSearchParamsGetter2 as addURLSearchParamsGetter,
   INTERNAL_STATE
 };
 
-//# debugId=F1D8DE89A0C3E63864756E2164756E21
+//# debugId=0EA35BEDA988897364756E2164756E21

package/dist/mjs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { SetupCoreOptions, CoreHandle, StateMap } from \"./types.mjs\";\nimport { createStateMap } from \"./class-builder.mjs\";\nimport {\n  createReadableStreamClass,\n  createReadableStreamDefaultReaderClass,\n  createReadableStream,\n} from \"./streams/readable-stream.mjs\";\nimport {\n  createWritableStreamClass,\n  createWritableStreamDefaultWriterClass,\n} from \"./streams/writable-stream.mjs\";\nimport { createTransformStreamClass } from \"./streams/transform-stream.mjs\";\nimport { createBlobClass } from \"./blob.mjs\";\nimport { createFileClass } from \"./file.mjs\";\nimport { createDOMExceptionClass } from \"./dom-exception.mjs\";\nimport { createURLSearchParamsClass } from \"./url-search-params.mjs\";\nimport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.mjs\";\n\n/**\n * Setup core APIs in a QuickJS context\n *\n * Injects the following globals:\n * - ReadableStream, WritableStream, TransformStream\n * - ReadableStreamDefaultReader, WritableStreamDefaultWriter\n * - Blob\n * - File\n * - DOMException\n * - URL, URLSearchParams\n * - TextEncoder, TextDecoder\n *\n * @example\n * const handle = setupCore(context);\n *\n * context.evalCode(`\n *   const blob = new Blob([\"hello\", \" \", \"world\"], { type: \"text/plain\" });\n *   const text = await blob.text(); // \"hello world\"\n *\n *   const stream = new ReadableStream({\n *     start(controller) {\n *       controller.enqueue(\"chunk1\");\n *       controller.enqueue(\"chunk2\");\n *       controller.close();\n *     }\n *   });\n * `);\n */\nexport function setupCore(\n  context: QuickJSContext,\n  options?: SetupCoreOptions\n): CoreHandle {\n  const stateMap = options?.stateMap ?? createStateMap();\n  const handles: { name: string; handle: QuickJSHandle }[] = [];\n\n  // Create ReadableStreamDefaultReader class first\n  const ReadableStreamDefaultReader = createReadableStreamDefaultReaderClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"ReadableStreamDefaultReader\",\n    ReadableStreamDefaultReader\n  );\n  ReadableStreamDefaultReader.dispose();\n\n  // Create ReadableStream class\n  const readerClassRef = context.getProp(context.global, \"ReadableStreamDefaultReader\");\n  const ReadableStream = createReadableStreamClass(\n    context,\n    stateMap,\n    readerClassRef\n  );\n  readerClassRef.dispose();\n  context.setProp(context.global, \"ReadableStream\", ReadableStream);\n  ReadableStream.dispose();\n\n  // Create WritableStreamDefaultWriter class first\n  const WritableStreamDefaultWriter = createWritableStreamDefaultWriterClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"WritableStreamDefaultWriter\",\n    WritableStreamDefaultWriter\n  );\n  WritableStreamDefaultWriter.dispose();\n\n  // Create WritableStream class\n  const writerClassRef = context.getProp(context.global, \"WritableStreamDefaultWriter\");\n  const WritableStream = createWritableStreamClass(\n    context,\n    stateMap,\n    writerClassRef\n  );\n  writerClassRef.dispose();\n  context.setProp(context.global, \"WritableStream\", WritableStream);\n  WritableStream.dispose();\n\n  // Create TransformStream class\n  const TransformStream = createTransformStreamClass(context, stateMap);\n  context.setProp(context.global, \"TransformStream\", TransformStream);\n  TransformStream.dispose();\n\n  // Create Blob class with stream factory\n  const BlobClass = createBlobClass(context, stateMap, (source) =>\n    createReadableStream(context, stateMap, source)\n  );\n  context.setProp(context.global, \"Blob\", BlobClass);\n  BlobClass.dispose();\n\n  // Create File class (extends Blob)\n  const blobClassRef = context.getProp(context.global, \"Blob\");\n  const FileClass = createFileClass(context, stateMap, blobClassRef);\n  blobClassRef.dispose();\n  context.setProp(context.global, \"File\", FileClass);\n  FileClass.dispose();\n\n  // Create DOMException class\n  const DOMExceptionClass = createDOMExceptionClass(context, stateMap);\n  context.setProp(context.global, \"DOMException\", DOMExceptionClass);\n  DOMExceptionClass.dispose();\n\n  // Create URLSearchParams class\n  const URLSearchParamsClass = createURLSearchParamsClass(context, stateMap);\n  context.setProp(context.global, \"URLSearchParams\", URLSearchParamsClass);\n  URLSearchParamsClass.dispose();\n\n  // Add Symbol.iterator support for URLSearchParams\n  const urlSearchParamsIteratorResult = context.evalCode(`\n    URLSearchParams.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (urlSearchParamsIteratorResult.error) {\n    urlSearchParamsIteratorResult.error.dispose();\n  } else {\n    urlSearchParamsIteratorResult.value.dispose();\n  }\n\n  // Create URL class (depends on URLSearchParams)\n  const URLClass = createURLClass(context, stateMap);\n  context.setProp(context.global, \"URL\", URLClass);\n  URLClass.dispose();\n\n  // Add searchParams getter to URL that returns URLSearchParams instance\n  // Uses JavaScript closures to sync URLSearchParams mutations back to URL\n  addURLSearchParamsLinkage(context);\n\n  // TextEncoder/TextDecoder - pure JS implementation for UTF-8\n  const textEncodingCode = `\n(function() {\n  class TextEncoder {\n    constructor(encoding = \"utf-8\") {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n    }\n\n    encode(input = \"\") {\n      const str = String(input);\n      const bytes = [];\n\n      for (let i = 0; i < str.length; i++) {\n        let charCode = str.charCodeAt(i);\n\n        if (charCode < 0x80) {\n          bytes.push(charCode);\n        } else if (charCode < 0x800) {\n          bytes.push(0xC0 | (charCode >> 6));\n          bytes.push(0x80 | (charCode & 0x3F));\n        } else if (charCode >= 0xD800 && charCode <= 0xDBFF) {\n          const nextCharCode = str.charCodeAt(++i);\n          if (nextCharCode >= 0xDC00 && nextCharCode <= 0xDFFF) {\n            const codePoint = 0x10000 + ((charCode - 0xD800) << 10) + (nextCharCode - 0xDC00);\n            bytes.push(0xF0 | (codePoint >> 18));\n            bytes.push(0x80 | ((codePoint >> 12) & 0x3F));\n            bytes.push(0x80 | ((codePoint >> 6) & 0x3F));\n            bytes.push(0x80 | (codePoint & 0x3F));\n          }\n        } else if (charCode < 0x10000) {\n          bytes.push(0xE0 | (charCode >> 12));\n          bytes.push(0x80 | ((charCode >> 6) & 0x3F));\n          bytes.push(0x80 | (charCode & 0x3F));\n        }\n      }\n\n      return new Uint8Array(bytes);\n    }\n\n    encodeInto(source, destination) {\n      const encoded = this.encode(source);\n      const len = Math.min(encoded.length, destination.length);\n      destination.set(encoded.subarray(0, len));\n      return { read: source.length, written: len };\n    }\n  }\n\n  class TextDecoder {\n    constructor(encoding = \"utf-8\", options = {}) {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n      this.fatal = Boolean(options.fatal);\n      this.ignoreBOM = Boolean(options.ignoreBOM);\n    }\n\n    decode(input, options = {}) {\n      if (!input) return \"\";\n\n      let bytes;\n      if (input instanceof ArrayBuffer) {\n        bytes = new Uint8Array(input);\n      } else if (ArrayBuffer.isView(input)) {\n        bytes = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n      } else if (input instanceof Uint8Array) {\n        bytes = input;\n      } else {\n        throw new TypeError(\"The provided value is not of type '(ArrayBuffer or ArrayBufferView)'\");\n      }\n\n      let offset = 0;\n      if (!this.ignoreBOM && bytes.length >= 3 &&\n          bytes[0] === 0xEF && bytes[1] === 0xBB && bytes[2] === 0xBF) {\n        offset = 3;\n      }\n\n      let result = \"\";\n      for (let i = offset; i < bytes.length;) {\n        const byte1 = bytes[i++];\n\n        if (byte1 < 0x80) {\n          result += String.fromCharCode(byte1);\n        } else if ((byte1 & 0xE0) === 0xC0) {\n          const byte2 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x1F) << 6) | byte2);\n        } else if ((byte1 & 0xF0) === 0xE0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x0F) << 12) | (byte2 << 6) | byte3);\n        } else if ((byte1 & 0xF8) === 0xF0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          const byte4 = bytes[i++] & 0x3F;\n          const codePoint = ((byte1 & 0x07) << 18) | (byte2 << 12) | (byte3 << 6) | byte4;\n          const adjusted = codePoint - 0x10000;\n          result += String.fromCharCode(0xD800 + (adjusted >> 10), 0xDC00 + (adjusted & 0x3FF));\n        }\n      }\n\n      return result;\n    }\n  }\n\n  globalThis.TextEncoder = TextEncoder;\n  globalThis.TextDecoder = TextDecoder;\n})();\n`;\n\n  const textEncodingResult = context.evalCode(textEncodingCode);\n  if (textEncodingResult.error) {\n    console.error(\"Failed to setup TextEncoder/TextDecoder\");\n    textEncodingResult.error.dispose();\n  } else {\n    textEncodingResult.value.dispose();\n  }\n\n  /**\n   * @returns CoreHandle with shared stateMap and dispose method\n   *\n   * **dispose() behavior:**\n   * - Clears internal handle tracking array\n   * - Does NOT dispose globals (ReadableStream, Blob, etc.) - they are owned\n   *   by context.global and cleaned up by context.dispose()\n   * - Call before context.dispose() to release internal references\n   *\n   * @see PATTERNS.md for implementation patterns\n   */\n  return {\n    stateMap,\n    dispose() {\n      // Note: handles set on global (ReadableStream, Blob, etc.) are NOT disposed here\n      // They are owned by the global object and will be cleaned up by context.dispose()\n      // Disposing them before context disposal causes QuickJS GC assertion failures\n      handles.length = 0;\n    },\n  };\n}\n\n// Re-export types\nexport type {\n  Scope,\n  MarshalOptions,\n  UnmarshalOptions,\n  PropertyDescriptor,\n  ClassDefinition,\n  StateMap,\n  SetupCoreOptions,\n  CoreHandle,\n  QuickJSContext,\n  QuickJSHandle,\n  QuickJSRuntime,\n} from \"./types.mjs\";\nexport { INTERNAL_STATE } from \"./types.mjs\";\n\n// Re-export utilities\nexport { withScope, withScopeAsync } from \"./scope.mjs\";\nexport { marshal, isHandle, getHandleType } from \"./marshal.mjs\";\nexport { unmarshal, cleanupUnmarshaledHandles } from \"./unmarshal.mjs\";\nexport { defineFunction, defineAsyncFunction } from \"./function-builder.mjs\";\nexport {\n  defineClass,\n  createStateMap,\n  getState,\n  setState,\n  getInstanceState,\n  setInstanceState,\n  getInstanceStateById,\n  cleanupInstanceState,\n  clearAllInstanceState,\n} from \"./class-builder.mjs\";\n\n// Re-export class instance helpers for cross-class access\nexport {\n  isDefineClassInstance,\n  isInstanceOf,\n  getClassInstanceState,\n  getInstanceId,\n  getClassName,\n  createClassTypeGuard,\n  isUnmarshalledRequest,\n  isUnmarshalledResponse,\n  isUnmarshalledHeaders,\n  isUnmarshalledFormData,\n} from \"./class-helpers.mjs\";\nexport type { DefineClassInstance, TypedClassInstance } from \"./class-helpers.mjs\";\n\n// Re-export instance state management\nexport {\n  nextInstanceId,\n  registerInstance,\n  getInstanceMetadata,\n  getInstanceClassName,\n  cleanupInstanceState as cleanupInstanceStateById,\n} from \"./instance-state.mjs\";\nexport type { InstanceMetadata } from \"./instance-state.mjs\";\n\n// Re-export stream utilities\nexport {\n  createReadableStream,\n  consumeReadableStream,\n} from \"./streams/readable-stream.mjs\";\nexport { createWritableStream } from \"./streams/writable-stream.mjs\";\n\n// Re-export Blob/File utilities\nexport { createBlob } from \"./blob.mjs\";\nexport { createFile } from \"./file.mjs\";\n\n// Re-export URL utilities\nexport { createURLSearchParamsClass } from \"./url-search-params.mjs\";\nexport type { URLSearchParamsState } from \"./url-search-params.mjs\";\nexport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.mjs\";\nexport type { URLState } from \"./url.mjs\";\n\n// Re-export coercion utilities\nexport {\n  createCoercer,\n  classCoercer,\n  instanceOrShape,\n  coerceURL,\n  coerceToURLString,\n  coerceHeaders,\n  coerceBody,\n  coerceRequestInit,\n  coerceResponseInit,\n} from \"./coerce.mjs\";\nexport type {\n  Coercer,\n  CoercionResult,\n  URLCoerced,\n  HeadersCoerced,\n  RequestInitCoerced,\n  ResponseInitCoerced,\n} from \"./coerce.mjs\";\n"
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport type { SetupCoreOptions, CoreHandle, StateMap } from \"./types.mjs\";\nimport { createStateMap } from \"./class-builder.mjs\";\nimport {\n  createReadableStreamClass,\n  createReadableStreamDefaultReaderClass,\n  createReadableStream,\n} from \"./streams/readable-stream.mjs\";\nimport {\n  createWritableStreamClass,\n  createWritableStreamDefaultWriterClass,\n} from \"./streams/writable-stream.mjs\";\nimport { createTransformStreamClass } from \"./streams/transform-stream.mjs\";\nimport { createBlobClass } from \"./blob.mjs\";\nimport { createFileClass } from \"./file.mjs\";\nimport { createDOMExceptionClass } from \"./dom-exception.mjs\";\nimport { createURLSearchParamsClass } from \"./url-search-params.mjs\";\nimport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.mjs\";\n\n/**\n * Setup core APIs in a QuickJS context\n *\n * Injects the following globals:\n * - ReadableStream, WritableStream, TransformStream\n * - ReadableStreamDefaultReader, WritableStreamDefaultWriter\n * - Blob\n * - File\n * - DOMException\n * - URL, URLSearchParams\n * - TextEncoder, TextDecoder\n *\n * @example\n * const handle = setupCore(context);\n *\n * context.evalCode(`\n *   const blob = new Blob([\"hello\", \" \", \"world\"], { type: \"text/plain\" });\n *   const text = await blob.text(); // \"hello world\"\n *\n *   const stream = new ReadableStream({\n *     start(controller) {\n *       controller.enqueue(\"chunk1\");\n *       controller.enqueue(\"chunk2\");\n *       controller.close();\n *     }\n *   });\n * `);\n */\nexport function setupCore(\n  context: QuickJSContext,\n  options?: SetupCoreOptions\n): CoreHandle {\n  const stateMap = options?.stateMap ?? createStateMap();\n  const handles: { name: string; handle: QuickJSHandle }[] = [];\n\n  // Create ReadableStreamDefaultReader class first\n  const ReadableStreamDefaultReader = createReadableStreamDefaultReaderClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"ReadableStreamDefaultReader\",\n    ReadableStreamDefaultReader\n  );\n  ReadableStreamDefaultReader.dispose();\n\n  // Create ReadableStream class\n  const readerClassRef = context.getProp(context.global, \"ReadableStreamDefaultReader\");\n  const ReadableStream = createReadableStreamClass(\n    context,\n    stateMap,\n    readerClassRef\n  );\n  readerClassRef.dispose();\n  context.setProp(context.global, \"ReadableStream\", ReadableStream);\n  ReadableStream.dispose();\n\n  // Create WritableStreamDefaultWriter class first\n  const WritableStreamDefaultWriter = createWritableStreamDefaultWriterClass(\n    context,\n    stateMap\n  );\n  context.setProp(\n    context.global,\n    \"WritableStreamDefaultWriter\",\n    WritableStreamDefaultWriter\n  );\n  WritableStreamDefaultWriter.dispose();\n\n  // Create WritableStream class\n  const writerClassRef = context.getProp(context.global, \"WritableStreamDefaultWriter\");\n  const WritableStream = createWritableStreamClass(\n    context,\n    stateMap,\n    writerClassRef\n  );\n  writerClassRef.dispose();\n  context.setProp(context.global, \"WritableStream\", WritableStream);\n  WritableStream.dispose();\n\n  // Create TransformStream class\n  const TransformStream = createTransformStreamClass(context, stateMap);\n  context.setProp(context.global, \"TransformStream\", TransformStream);\n  TransformStream.dispose();\n\n  // Create Blob class with stream factory\n  const BlobClass = createBlobClass(context, stateMap, (source) =>\n    createReadableStream(context, stateMap, source)\n  );\n  context.setProp(context.global, \"Blob\", BlobClass);\n  BlobClass.dispose();\n\n  // Create File class (extends Blob)\n  const blobClassRef = context.getProp(context.global, \"Blob\");\n  const FileClass = createFileClass(context, stateMap, blobClassRef);\n  blobClassRef.dispose();\n  context.setProp(context.global, \"File\", FileClass);\n  FileClass.dispose();\n\n  // Create DOMException class\n  const DOMExceptionClass = createDOMExceptionClass(context, stateMap);\n  context.setProp(context.global, \"DOMException\", DOMExceptionClass);\n  DOMExceptionClass.dispose();\n\n  // Create URLSearchParams class\n  const URLSearchParamsClass = createURLSearchParamsClass(context, stateMap);\n  context.setProp(context.global, \"URLSearchParams\", URLSearchParamsClass);\n  URLSearchParamsClass.dispose();\n\n  // Add Symbol.iterator support for URLSearchParams\n  const urlSearchParamsIteratorResult = context.evalCode(`\n    URLSearchParams.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (urlSearchParamsIteratorResult.error) {\n    urlSearchParamsIteratorResult.error.dispose();\n  } else {\n    urlSearchParamsIteratorResult.value.dispose();\n  }\n\n  // Create URL class (depends on URLSearchParams)\n  const URLClass = createURLClass(context, stateMap);\n  context.setProp(context.global, \"URL\", URLClass);\n  URLClass.dispose();\n\n  // Add searchParams getter to URL that returns URLSearchParams instance\n  // Uses JavaScript closures to sync URLSearchParams mutations back to URL\n  addURLSearchParamsLinkage(context);\n\n  // TextEncoder/TextDecoder - pure JS implementation for UTF-8\n  const textEncodingCode = `\n(function() {\n  class TextEncoder {\n    constructor(encoding = \"utf-8\") {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n    }\n\n    encode(input = \"\") {\n      const str = String(input);\n      const bytes = [];\n\n      for (let i = 0; i < str.length; i++) {\n        let charCode = str.charCodeAt(i);\n\n        if (charCode < 0x80) {\n          bytes.push(charCode);\n        } else if (charCode < 0x800) {\n          bytes.push(0xC0 | (charCode >> 6));\n          bytes.push(0x80 | (charCode & 0x3F));\n        } else if (charCode >= 0xD800 && charCode <= 0xDBFF) {\n          const nextCharCode = str.charCodeAt(++i);\n          if (nextCharCode >= 0xDC00 && nextCharCode <= 0xDFFF) {\n            const codePoint = 0x10000 + ((charCode - 0xD800) << 10) + (nextCharCode - 0xDC00);\n            bytes.push(0xF0 | (codePoint >> 18));\n            bytes.push(0x80 | ((codePoint >> 12) & 0x3F));\n            bytes.push(0x80 | ((codePoint >> 6) & 0x3F));\n            bytes.push(0x80 | (codePoint & 0x3F));\n          }\n        } else if (charCode < 0x10000) {\n          bytes.push(0xE0 | (charCode >> 12));\n          bytes.push(0x80 | ((charCode >> 6) & 0x3F));\n          bytes.push(0x80 | (charCode & 0x3F));\n        }\n      }\n\n      return new Uint8Array(bytes);\n    }\n\n    encodeInto(source, destination) {\n      const encoded = this.encode(source);\n      const len = Math.min(encoded.length, destination.length);\n      destination.set(encoded.subarray(0, len));\n      return { read: source.length, written: len };\n    }\n  }\n\n  class TextDecoder {\n    constructor(encoding = \"utf-8\", options = {}) {\n      if (encoding !== \"utf-8\" && encoding !== \"utf8\") {\n        throw new RangeError(\"The encoding label provided is invalid.\");\n      }\n      this.encoding = \"utf-8\";\n      this.fatal = Boolean(options.fatal);\n      this.ignoreBOM = Boolean(options.ignoreBOM);\n    }\n\n    decode(input, options = {}) {\n      if (!input) return \"\";\n\n      let bytes;\n      if (input instanceof ArrayBuffer) {\n        bytes = new Uint8Array(input);\n      } else if (ArrayBuffer.isView(input)) {\n        bytes = new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n      } else if (input instanceof Uint8Array) {\n        bytes = input;\n      } else {\n        throw new TypeError(\"The provided value is not of type '(ArrayBuffer or ArrayBufferView)'\");\n      }\n\n      let offset = 0;\n      if (!this.ignoreBOM && bytes.length >= 3 &&\n          bytes[0] === 0xEF && bytes[1] === 0xBB && bytes[2] === 0xBF) {\n        offset = 3;\n      }\n\n      let result = \"\";\n      for (let i = offset; i < bytes.length;) {\n        const byte1 = bytes[i++];\n\n        if (byte1 < 0x80) {\n          result += String.fromCharCode(byte1);\n        } else if ((byte1 & 0xE0) === 0xC0) {\n          const byte2 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x1F) << 6) | byte2);\n        } else if ((byte1 & 0xF0) === 0xE0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          result += String.fromCharCode(((byte1 & 0x0F) << 12) | (byte2 << 6) | byte3);\n        } else if ((byte1 & 0xF8) === 0xF0) {\n          const byte2 = bytes[i++] & 0x3F;\n          const byte3 = bytes[i++] & 0x3F;\n          const byte4 = bytes[i++] & 0x3F;\n          const codePoint = ((byte1 & 0x07) << 18) | (byte2 << 12) | (byte3 << 6) | byte4;\n          const adjusted = codePoint - 0x10000;\n          result += String.fromCharCode(0xD800 + (adjusted >> 10), 0xDC00 + (adjusted & 0x3FF));\n        }\n      }\n\n      return result;\n    }\n  }\n\n  globalThis.TextEncoder = TextEncoder;\n  globalThis.TextDecoder = TextDecoder;\n})();\n`;\n\n  const textEncodingResult = context.evalCode(textEncodingCode);\n  if (textEncodingResult.error) {\n    console.error(\"Failed to setup TextEncoder/TextDecoder\");\n    textEncodingResult.error.dispose();\n  } else {\n    textEncodingResult.value.dispose();\n  }\n\n  /**\n   * @returns CoreHandle with shared stateMap and dispose method\n   *\n   * **dispose() behavior:**\n   * - Clears internal handle tracking array\n   * - Does NOT dispose globals (ReadableStream, Blob, etc.) - they are owned\n   *   by context.global and cleaned up by context.dispose()\n   * - Call before context.dispose() to release internal references\n   *\n   * @see PATTERNS.md for implementation patterns\n   */\n  return {\n    stateMap,\n    dispose() {\n      // Note: handles set on global (ReadableStream, Blob, etc.) are NOT disposed here\n      // They are owned by the global object and will be cleaned up by context.dispose()\n      // Disposing them before context disposal causes QuickJS GC assertion failures\n      handles.length = 0;\n    },\n  };\n}\n\n// Re-export types\nexport type {\n  Scope,\n  MarshalOptions,\n  UnmarshalOptions,\n  PropertyDescriptor,\n  ClassDefinition,\n  StateMap,\n  SetupCoreOptions,\n  CoreHandle,\n  QuickJSContext,\n  QuickJSHandle,\n  QuickJSRuntime,\n} from \"./types.mjs\";\nexport { INTERNAL_STATE } from \"./types.mjs\";\n\n// Re-export utilities\nexport { withScope, withScopeAsync } from \"./scope.mjs\";\nexport { marshal, isHandle, getHandleType } from \"./marshal.mjs\";\nexport { unmarshal, cleanupUnmarshaledHandles } from \"./unmarshal.mjs\";\nexport {\n  defineFunction,\n  defineAsyncFunction,\n  defineAsyncIteratorFunction,\n  cleanupAsyncIterators,\n} from \"./function-builder.mjs\";\nexport {\n  defineClass,\n  createStateMap,\n  getState,\n  setState,\n  getInstanceState,\n  setInstanceState,\n  getInstanceStateById,\n  cleanupInstanceState,\n  clearAllInstanceState,\n} from \"./class-builder.mjs\";\n\n// Re-export class instance helpers for cross-class access\nexport {\n  isDefineClassInstance,\n  isInstanceOf,\n  getClassInstanceState,\n  getInstanceId,\n  getClassName,\n  createClassTypeGuard,\n  isUnmarshalledRequest,\n  isUnmarshalledResponse,\n  isUnmarshalledHeaders,\n  isUnmarshalledFormData,\n} from \"./class-helpers.mjs\";\nexport type { DefineClassInstance, TypedClassInstance } from \"./class-helpers.mjs\";\n\n// Re-export instance state management\nexport {\n  nextInstanceId,\n  registerInstance,\n  getInstanceMetadata,\n  getInstanceClassName,\n  cleanupInstanceState as cleanupInstanceStateById,\n} from \"./instance-state.mjs\";\nexport type { InstanceMetadata } from \"./instance-state.mjs\";\n\n// Re-export stream utilities\nexport {\n  createReadableStream,\n  consumeReadableStream,\n} from \"./streams/readable-stream.mjs\";\nexport { createWritableStream } from \"./streams/writable-stream.mjs\";\n\n// Re-export Blob/File utilities\nexport { createBlob } from \"./blob.mjs\";\nexport { createFile } from \"./file.mjs\";\n\n// Re-export URL utilities\nexport { createURLSearchParamsClass } from \"./url-search-params.mjs\";\nexport type { URLSearchParamsState } from \"./url-search-params.mjs\";\nexport { createURLClass, addURLSearchParamsLinkage, addURLSearchParamsGetter } from \"./url.mjs\";\nexport type { URLState } from \"./url.mjs\";\n\n// Re-export coercion utilities\nexport {\n  createCoercer,\n  classCoercer,\n  instanceOrShape,\n  coerceURL,\n  coerceToURLString,\n  coerceHeaders,\n  coerceBody,\n  coerceRequestInit,\n  coerceResponseInit,\n} from \"./coerce.mjs\";\nexport type {\n  Coercer,\n  CoercionResult,\n  URLCoerced,\n  HeadersCoerced,\n  RequestInitCoerced,\n  ResponseInitCoerced,\n} from \"./coerce.mjs\";\n"
   ],
-  "mappings": "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",
-  "debugId": "F1D8DE89A0C3E63864756E2164756E21",
+  "mappings": "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",
+  "debugId": "0EA35BEDA988897364756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-core",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "type": "module"
 }

package/dist/types/function-builder.d.ts

@@ -21,3 +21,25 @@ export declare function defineFunction(context: QuickJSContext, name: string, fn
  * });
  */
 export declare function defineAsyncFunction(context: QuickJSContext, name: string, fn: (...args: unknown[]) => Promise<unknown>): QuickJSHandle;
+/**
+ * Define an async iterator function that returns an async iterable to QuickJS.
+ * The host function should be an async generator.
+ *
+ * @example
+ * const streamFn = defineAsyncIteratorFunction(context, "stream", async function* (n) {
+ *   for (let i = 0; i < n; i++) {
+ *     yield i;
+ *   }
+ *   return "done";
+ * });
+ *
+ * // In QuickJS:
+ * // for await (const value of stream(3)) { console.log(value); }
+ * // Outputs: 0, 1, 2
+ */
+export declare function defineAsyncIteratorFunction(context: QuickJSContext, name: string, fn: (...args: unknown[]) => AsyncGenerator<unknown, unknown, unknown>): QuickJSHandle;
+/**
+ * Clean up all async iterator state for a context.
+ * Should be called before context disposal.
+ */
+export declare function cleanupAsyncIterators(context: QuickJSContext): void;

package/dist/types/index.d.ts

@@ -34,7 +34,7 @@ export { INTERNAL_STATE } from "./types.ts";
 export { withScope, withScopeAsync } from "./scope.ts";
 export { marshal, isHandle, getHandleType } from "./marshal.ts";
 export { unmarshal, cleanupUnmarshaledHandles } from "./unmarshal.ts";
-export { defineFunction, defineAsyncFunction } from "./function-builder.ts";
+export { defineFunction, defineAsyncFunction, defineAsyncIteratorFunction, cleanupAsyncIterators, } from "./function-builder.ts";
 export { defineClass, createStateMap, getState, setState, getInstanceState, setInstanceState, getInstanceStateById, cleanupInstanceState, clearAllInstanceState, } from "./class-builder.ts";
 export { isDefineClassInstance, isInstanceOf, getClassInstanceState, getInstanceId, getClassName, createClassTypeGuard, isUnmarshalledRequest, isUnmarshalledResponse, isUnmarshalledHeaders, isUnmarshalledFormData, } from "./class-helpers.ts";
 export type { DefineClassInstance, TypedClassInstance } from "./class-helpers.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-core",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {