@ricsam/quickjs-runtime 0.2.20 → 0.2.21

package/dist/cjs/create-runtime.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/create-runtime.ts"],
+  "sourcesContent": [
+    "import {\n  getQuickJS,\n  newAsyncContext,\n  type QuickJSAsyncContext,\n  type QuickJSAsyncRuntime,\n  type QuickJSContext,\n  type QuickJSRuntime,\n} from \"quickjs-emscripten\";\nimport {\n  setupCore,\n  createStateMap,\n  cleanupUnmarshaledHandles,\n  clearAllInstanceState,\n  defineFunction,\n  defineAsyncFunction,\n  type StateMap,\n  type CoreHandle,\n} from \"@ricsam/quickjs-core\";\nimport {\n  setupFetch,\n  type SetupFetchOptions,\n  type FetchHandle,\n} from \"@ricsam/quickjs-fetch\";\nimport {\n  setupFs,\n  type SetupFsOptions,\n  type FsHandle,\n} from \"@ricsam/quickjs-fs\";\nimport {\n  setupConsole,\n  type ConsoleHandle,\n  type ConsoleEntry,\n  type ConsoleCallbacks,\n} from \"@ricsam/quickjs-console\";\nimport {\n  setupEncoding,\n  type EncodingHandle,\n} from \"@ricsam/quickjs-encoding\";\nimport {\n  setupTimers,\n  type TimersHandle,\n} from \"@ricsam/quickjs-timers\";\nimport {\n  setupCrypto,\n  type CryptoHandle,\n} from \"@ricsam/quickjs-crypto\";\nimport {\n  setupTestEnvironment,\n  type TestEnvironmentHandle,\n  type RunResults,\n  type TestEvent,\n} from \"@ricsam/quickjs-test-environment\";\nimport {\n  setupPlaywright,\n  type PlaywrightHandle,\n  type PlaywrightOptions,\n  type PlaywrightEvent,\n  type BrowserConsoleLogEntry,\n  type NetworkRequestInfo,\n  type NetworkResponseInfo,\n} from \"@ricsam/quickjs-playwright\";\n\n// Re-export types\nexport type { ConsoleEntry, ConsoleCallbacks, TestEvent, PlaywrightEvent };\n\n/**\n * Module loader callback type.\n * Called when the runtime imports a module dynamically.\n * Returns the JavaScript source code for the module.\n */\nexport type ModuleLoaderCallback = (\n  moduleName: string\n) => string | Promise<string>;\n\n/**\n * A custom function that can be called from within the runtime.\n */\nexport type CustomFunction = (...args: unknown[]) => unknown | Promise<unknown>;\n\n/**\n * Custom function definition with metadata.\n * Requires explicit `async` property to be clear about function behavior.\n */\nexport interface CustomFunctionDefinition {\n  /** The function implementation */\n  fn: CustomFunction;\n  /** Whether the function is async (returns a Promise) */\n  async: boolean;\n}\n\n/**\n * Custom functions to register in the runtime.\n * Each function must be defined with explicit async property.\n *\n * @example\n * ```typescript\n * customFunctions: {\n *   // Async function\n *   hashPassword: {\n *     fn: async (password) => bcrypt.hash(password, 10),\n *     async: true,\n *   },\n *   // Sync function\n *   getConfig: {\n *     fn: () => ({ environment: \"production\" }),\n *     async: false,\n *   },\n * }\n * ```\n */\nexport type CustomFunctions = Record<string, CustomFunctionDefinition>;\n\n/**\n * Fetch callback type.\n */\nexport type FetchCallback = (request: Request) => Response | Promise<Response>;\n\n/**\n * Test environment options.\n */\nexport interface TestEnvironmentOptions {\n  /** Event callback for test events */\n  onEvent?: (event: TestEvent) => void;\n  /** Default test timeout in milliseconds */\n  testTimeout?: number;\n}\n\n/**\n * Options for creating a runtime.\n */\nexport interface RuntimeOptions {\n  /** Memory limit in bytes (optional) */\n  memoryLimit?: number;\n  /** Console callback handlers */\n  console?: ConsoleCallbacks;\n  /** Fetch callback handler */\n  fetch?: FetchCallback;\n  /** File system options */\n  fs?: SetupFsOptions;\n  /** Module loader callback for resolving dynamic imports */\n  moduleLoader?: ModuleLoaderCallback;\n  /** Custom functions callable from within the runtime */\n  customFunctions?: CustomFunctions;\n  /** Current working directory for path operations. Defaults to \"/\" */\n  cwd?: string;\n  /** Test environment options. Set to true for defaults, or provide options. */\n  testEnvironment?: boolean | TestEnvironmentOptions;\n  /** Playwright options for browser automation */\n  playwright?: PlaywrightOptions;\n}\n\n/**\n * Runtime fetch handle - provides access to fetch/serve operations.\n */\nexport interface RuntimeFetchHandle {\n  /** Dispatch HTTP request to serve() handler */\n  dispatchRequest(request: Request, options?: { timeout?: number }): Promise<Response>;\n  /** Check if serve() has been called */\n  hasServeHandler(): boolean;\n  /** Check if there are active WebSocket connections */\n  hasActiveConnections(): boolean;\n}\n\n/**\n * Runtime timers handle - provides access to timer operations.\n */\nexport interface RuntimeTimersHandle {\n  /** Clear all pending timers */\n  clearAll(): void;\n}\n\n/**\n * Runtime console handle - provides access to console state.\n */\nexport interface RuntimeConsoleHandle {\n  /** Reset all console state (timers, counters, group depth) */\n  reset(): void;\n  /** Get console.time() timers */\n  getTimers(): Map<string, number>;\n  /** Get console.count() counters */\n  getCounters(): Map<string, number>;\n  /** Get current console.group() nesting depth */\n  getGroupDepth(): number;\n}\n\n/**\n * Runtime test environment handle - provides access to test operations.\n */\nexport interface RuntimeTestEnvironmentHandle {\n  /** Run all registered tests */\n  runTests(timeout?: number): Promise<RunResults>;\n  /** Check if any tests have been registered */\n  hasTests(): boolean;\n  /** Get the number of registered tests */\n  getTestCount(): number;\n  /** Reset test state (clear registered tests) */\n  reset(): void;\n}\n\n/**\n * Collected playwright data.\n */\nexport interface CollectedData {\n  browserConsoleLogs: BrowserConsoleLogEntry[];\n  networkRequests: NetworkRequestInfo[];\n  networkResponses: NetworkResponseInfo[];\n}\n\n/**\n * Runtime playwright handle - provides access to playwright data.\n */\nexport interface RuntimePlaywrightHandle {\n  /** Get collected browser logs and network data */\n  getCollectedData(): CollectedData;\n  /** Clear all collected data */\n  clearCollectedData(): void;\n}\n\n/**\n * Runtime handle - the main interface for interacting with the runtime.\n */\nexport interface RuntimeHandle {\n  /** Unique runtime identifier */\n  readonly id: string;\n  /** Execute code as ES module (supports top-level await) */\n  eval(code: string, filename?: string): Promise<void>;\n  /** Dispose all resources */\n  dispose(): Promise<void>;\n\n  /** Fetch handle - access to fetch/serve operations */\n  readonly fetch: RuntimeFetchHandle;\n  /** Timers handle - access to timer operations */\n  readonly timers: RuntimeTimersHandle;\n  /** Console handle - access to console state */\n  readonly console: RuntimeConsoleHandle;\n  /** Test environment handle - access to test operations */\n  readonly testEnvironment: RuntimeTestEnvironmentHandle;\n  /** Playwright handle - access to browser automation data */\n  readonly playwright: RuntimePlaywrightHandle;\n}\n\n/**\n * Create a fully configured QuickJS runtime\n *\n * Sets up all WHATWG APIs: fetch, fs, console, crypto, encoding, timers.\n * Supports ES modules with custom module loader and custom host functions.\n *\n * @example\n * ```typescript\n * const runtime = await createRuntime({\n *   console: { onEntry: (e) => console.log(\"[sandbox]\", e) },\n *   fetch: async (request) => fetch(request),\n *   moduleLoader: async (name) => {\n *     if (name === \"@/utils\") {\n *       return `export const add = (a, b) => a + b;`;\n *     }\n *     throw new Error(`Unknown module: ${name}`);\n *   },\n *   customFunctions: {\n *     hashPassword: {\n *       fn: async (pw) => Bun.password.hash(pw),\n *       async: true,\n *     },\n *   },\n * });\n *\n * await runtime.eval(`\n *   import { add } from \"@/utils\";\n *   const hash = await hashPassword(\"secret\");\n *   console.log(add(1, 2), hash);\n * `);\n *\n * await runtime.dispose();\n * ```\n */\nexport async function createRuntime(\n  options?: RuntimeOptions\n): Promise<RuntimeHandle> {\n  const opts = options ?? {};\n\n  // Generate unique ID\n  const id = crypto.randomUUID();\n\n  // Determine if we need async context (for async module loader)\n  const needsAsync = opts.moduleLoader !== undefined;\n\n  let context: QuickJSContext | QuickJSAsyncContext;\n  let runtime: QuickJSRuntime | QuickJSAsyncRuntime;\n  let isAsyncContext = false;\n\n  if (needsAsync) {\n    // Create async context for module loading support\n    const asyncContext = await newAsyncContext();\n    context = asyncContext;\n    runtime = asyncContext.runtime;\n    isAsyncContext = true;\n\n    // Set up module loader\n    if (opts.moduleLoader) {\n      const moduleLoader = opts.moduleLoader;\n      (runtime as QuickJSAsyncRuntime).setModuleLoader(async (moduleName: string) => {\n        try {\n          const code = await moduleLoader(moduleName);\n          return code;\n        } catch (error) {\n          // Return error in SuccessOrFail format\n          return { error: error as Error };\n        }\n      });\n    }\n  } else {\n    // Create sync context\n    const QuickJS = await getQuickJS();\n    runtime = QuickJS.newRuntime();\n    context = runtime.newContext();\n  }\n\n  // Set memory limit if specified\n  if (opts.memoryLimit) {\n    runtime.setMemoryLimit(opts.memoryLimit);\n  }\n\n  // Create shared state\n  const stateMap = createStateMap();\n\n  // Setup core APIs\n  const coreHandle = setupCore(context, { stateMap });\n\n  // Setup console\n  const consoleHandle = setupConsole(context, {\n    ...opts.console,\n    stateMap,\n    coreHandle,\n  });\n\n  // Setup encoding (btoa/atob)\n  const encodingHandle = setupEncoding(context, { stateMap, coreHandle });\n\n  // Setup timers\n  const timersHandle = setupTimers(context, { stateMap, coreHandle });\n\n  // Setup crypto\n  const cryptoHandle = setupCrypto(context, { stateMap, coreHandle });\n\n  // Setup fetch if callback provided\n  let fetchHandle: FetchHandle | undefined;\n  if (opts.fetch) {\n    const fetchCallback = opts.fetch;\n    fetchHandle = setupFetch(context, {\n      stateMap,\n      coreHandle,\n      onFetch: async (request: Request) => {\n        return Promise.resolve(fetchCallback(request));\n      },\n    });\n  } else {\n    // Still setup fetch for serve() support, but without fetch() function\n    fetchHandle = setupFetch(context, { stateMap, coreHandle });\n  }\n\n  // Setup file system if provided\n  let fsHandle: FsHandle | undefined;\n  if (opts.fs) {\n    fsHandle = setupFs(context, {\n      ...opts.fs,\n      stateMap,\n      coreHandle,\n    });\n  }\n\n  // Setup custom functions\n  if (opts.customFunctions) {\n    for (const [name, def] of Object.entries(opts.customFunctions)) {\n      if (def.async) {\n        const fn = defineAsyncFunction(context, name, async (...args: unknown[]) => {\n          return def.fn(...args);\n        });\n        context.setProp(context.global, name, fn);\n        fn.dispose();\n      } else {\n        const fn = defineFunction(context, name, (...args: unknown[]) => {\n          return def.fn(...args);\n        });\n        context.setProp(context.global, name, fn);\n        fn.dispose();\n      }\n    }\n  }\n\n  // Setup test environment if enabled\n  let testEnvHandle: TestEnvironmentHandle | undefined;\n  if (opts.testEnvironment) {\n    const testEnvOpts = typeof opts.testEnvironment === \"object\" ? opts.testEnvironment : {};\n    testEnvHandle = setupTestEnvironment(context, {\n      stateMap,\n      coreHandle,\n      onEvent: testEnvOpts.onEvent,\n    });\n  }\n\n  // Setup playwright if provided\n  let playwrightHandle: PlaywrightHandle | undefined;\n  if (opts.playwright) {\n    playwrightHandle = setupPlaywright(context, {\n      ...opts.playwright,\n      stateMap,\n      coreHandle,\n      consoleCallbacks: opts.playwright.console ? opts.console : undefined,\n    });\n  }\n\n  // Create fetch handle wrapper\n  const runtimeFetchHandle: RuntimeFetchHandle = {\n    async dispatchRequest(request: Request, _options?: { timeout?: number }): Promise<Response> {\n      if (!fetchHandle) {\n        throw new Error(\"Fetch not configured\");\n      }\n      // Note: timeout option not yet implemented in underlying FetchHandle\n      return fetchHandle.dispatchRequest(request);\n    },\n    hasServeHandler() {\n      return fetchHandle?.hasServeHandler() ?? false;\n    },\n    hasActiveConnections() {\n      return fetchHandle?.hasActiveConnections() ?? false;\n    },\n  };\n\n  // Create timers handle wrapper\n  const runtimeTimersHandle: RuntimeTimersHandle = {\n    clearAll() {\n      timersHandle.clearAll();\n    },\n  };\n\n  // Create console handle wrapper\n  const runtimeConsoleHandle: RuntimeConsoleHandle = {\n    reset() {\n      consoleHandle.reset();\n    },\n    getTimers() {\n      return consoleHandle.getTimers();\n    },\n    getCounters() {\n      return consoleHandle.getCounters();\n    },\n    getGroupDepth() {\n      return consoleHandle.getGroupDepth();\n    },\n  };\n\n  // Create test environment handle wrapper\n  const runtimeTestEnvironmentHandle: RuntimeTestEnvironmentHandle = {\n    async runTests(_timeout?: number): Promise<RunResults> {\n      if (!testEnvHandle) {\n        throw new Error(\"Test environment not enabled. Set testEnvironment: true in createRuntime options.\");\n      }\n      return testEnvHandle.run();\n    },\n    hasTests() {\n      return testEnvHandle?.hasTests() ?? false;\n    },\n    getTestCount() {\n      return testEnvHandle?.getTestCount() ?? 0;\n    },\n    reset() {\n      testEnvHandle?.reset();\n    },\n  };\n\n  // Create playwright handle wrapper\n  const runtimePlaywrightHandle: RuntimePlaywrightHandle = {\n    getCollectedData() {\n      if (!playwrightHandle) {\n        return { browserConsoleLogs: [], networkRequests: [], networkResponses: [] };\n      }\n      return {\n        browserConsoleLogs: playwrightHandle.getBrowserConsoleLogs(),\n        networkRequests: playwrightHandle.getNetworkRequests(),\n        networkResponses: playwrightHandle.getNetworkResponses(),\n      };\n    },\n    clearCollectedData() {\n      playwrightHandle?.clearCollected();\n    },\n  };\n\n  return {\n    id,\n    fetch: runtimeFetchHandle,\n    timers: runtimeTimersHandle,\n    console: runtimeConsoleHandle,\n    testEnvironment: runtimeTestEnvironmentHandle,\n    playwright: runtimePlaywrightHandle,\n\n    async eval(code: string, filename?: string): Promise<void> {\n      if (isAsyncContext) {\n        // Use evalCodeAsync for async context (supports top-level await and async module loading)\n        const asyncContext = context as QuickJSAsyncContext;\n        const result = await asyncContext.evalCodeAsync(code, filename ?? \"<eval>\", {\n          type: \"module\",\n        });\n\n        if (result.error) {\n          const err = context.dump(result.error);\n          result.error.dispose();\n          throw new Error(`Eval failed: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n        }\n\n        // Handle module exports (could be a promise for top-level await)\n        const promiseState = context.getPromiseState(result.value);\n        if (promiseState.type === \"pending\") {\n          const resolved = await context.resolvePromise(result.value);\n          result.value.dispose();\n\n          if (resolved.error) {\n            const err = context.dump(resolved.error);\n            resolved.error.dispose();\n            throw new Error(`Promise rejected: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n          }\n          resolved.value.dispose();\n        } else {\n          result.value.dispose();\n        }\n\n        // Execute pending jobs\n        runtime.executePendingJobs();\n      } else {\n        // Use evalCode for sync context\n        const result = context.evalCode(code, filename ?? \"<eval>\", {\n          type: \"module\",\n        });\n\n        if (result.error) {\n          const err = context.dump(result.error);\n          result.error.dispose();\n          throw new Error(`Eval failed: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n        }\n\n        // Handle async module result\n        const promiseState = context.getPromiseState(result.value);\n        if (promiseState.type === \"pending\") {\n          const resolved = await context.resolvePromise(result.value);\n          result.value.dispose();\n\n          // Execute pending jobs\n          runtime.executePendingJobs();\n\n          if (resolved.error) {\n            const err = context.dump(resolved.error);\n            resolved.error.dispose();\n            throw new Error(`Promise rejected: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n          }\n          resolved.value.dispose();\n        } else {\n          result.value.dispose();\n        }\n\n        // Execute any remaining pending jobs\n        runtime.executePendingJobs();\n      }\n    },\n\n    async dispose(): Promise<void> {\n      // Drain pending jobs before disposal\n      for (let i = 0; i < 1000; i++) {\n        if (!runtime.hasPendingJob()) break;\n        const result = runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Dispose handles in reverse order\n      playwrightHandle?.dispose();\n      testEnvHandle?.dispose();\n      cryptoHandle.dispose();\n      timersHandle.dispose();\n      encodingHandle.dispose();\n      consoleHandle.dispose();\n      fsHandle?.dispose();\n      fetchHandle?.dispose();\n\n      // Drain pending jobs again\n      for (let i = 0; i < 1000; i++) {\n        if (!runtime.hasPendingJob()) break;\n        const result = runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Clean up handles\n      cleanupUnmarshaledHandles(context);\n      clearAllInstanceState();\n\n      // Clear globals to help GC\n      try {\n        const clearGlobals = context.evalCode(`\n          (function() {\n            const keysToDelete = Object.keys(globalThis).filter(k =>\n              k !== 'globalThis' && k !== 'undefined' && k !== 'NaN' && k !== 'Infinity'\n            );\n            for (const key of keysToDelete) {\n              try { globalThis[key] = undefined; } catch (e) {}\n            }\n            for (const key of keysToDelete) {\n              try { delete globalThis[key]; } catch (e) {}\n            }\n            return keysToDelete.length;\n          })()\n        `);\n        if (clearGlobals.error) {\n          clearGlobals.error.dispose();\n        } else {\n          clearGlobals.value.dispose();\n        }\n      } catch {\n        // Ignore errors during cleanup\n      }\n\n      // Final drain\n      for (let i = 0; i < 100; i++) {\n        if (!runtime.hasPendingJob()) break;\n        const result = runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      coreHandle.dispose();\n      context.dispose();\n\n      // Only dispose runtime if it was created separately (not via newAsyncContext)\n      if (!isAsyncContext) {\n        runtime.dispose();\n      }\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "0041C068E93313DA64756E2164756E21",
+  "names": []
+}

package/dist/cjs/index.cjs

@@ -47,7 +47,8 @@ var __export = (target, all) => {
 // packages/runtime/src/index.ts
 var exports_src = {};
 __export(exports_src, {
-  setupRuntime: () => setupRuntime
+  setupRuntime: () => setupRuntime,
+  createRuntime: () => import_create_runtime.createRuntime
 });
 module.exports = __toCommonJS(exports_src);
 __reExport(exports_src, require("@ricsam/quickjs-core"), module.exports);
@@ -57,6 +58,7 @@ __reExport(exports_src, require("@ricsam/quickjs-encoding"), module.exports);
 __reExport(exports_src, require("@ricsam/quickjs-fetch"), module.exports);
 __reExport(exports_src, require("@ricsam/quickjs-fs"), module.exports);
 __reExport(exports_src, require("@ricsam/quickjs-timers"), module.exports);
+var import_create_runtime = require("./create-runtime.cjs");
 var import_quickjs_core = require("@ricsam/quickjs-core");
 var import_quickjs_fetch = require("@ricsam/quickjs-fetch");
 var import_quickjs_fs = require("@ricsam/quickjs-fs");
@@ -181,4 +183,4 @@ function setupRuntime(context, options = {}) {
 }
 })
 
-//# debugId=9F06C7428583920964756E2164756E21
+//# debugId=D5C8A62287B56EA664756E2164756E21

package/dist/cjs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "// Re-export everything from sub-packages\nexport * from \"@ricsam/quickjs-core\";\nexport * from \"@ricsam/quickjs-console\";\nexport * from \"@ricsam/quickjs-crypto\";\nexport * from \"@ricsam/quickjs-encoding\";\nexport * from \"@ricsam/quickjs-fetch\";\nexport * from \"@ricsam/quickjs-fs\";\nexport * from \"@ricsam/quickjs-timers\";\n\nimport type { QuickJSContext } from \"quickjs-emscripten\";\nimport {\n  setupCore,\n  createStateMap,\n  cleanupUnmarshaledHandles,\n  clearAllInstanceState,\n  type StateMap,\n  type CoreHandle,\n} from \"@ricsam/quickjs-core\";\nimport {\n  setupFetch,\n  type SetupFetchOptions,\n  type FetchHandle,\n} from \"@ricsam/quickjs-fetch\";\nimport {\n  setupFs,\n  type SetupFsOptions,\n  type FsHandle,\n} from \"@ricsam/quickjs-fs\";\nimport {\n  setupConsole,\n  type SetupConsoleOptions,\n  type ConsoleHandle,\n} from \"@ricsam/quickjs-console\";\nimport {\n  setupEncoding,\n  type SetupEncodingOptions,\n  type EncodingHandle,\n} from \"@ricsam/quickjs-encoding\";\nimport {\n  setupTimers,\n  type SetupTimersOptions,\n  type TimersHandle,\n} from \"@ricsam/quickjs-timers\";\nimport {\n  setupCrypto,\n  type SetupCryptoOptions,\n  type CryptoHandle,\n} from \"@ricsam/quickjs-crypto\";\n\n/**\n * Options for setting up the runtime\n */\nexport interface SetupRuntimeOptions {\n  /**\n   * Fetch API options\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  fetch?: SetupFetchOptions | boolean;\n\n  /**\n   * File system options\n   * Pass options object to enable\n   * Pass `false` or omit to disable\n   */\n  fs?: SetupFsOptions | false;\n\n  /**\n   * Console options\n   * Pass `true` to enable with defaults\n   * Pass handlers object to customize\n   * Pass `false` or omit to disable\n   */\n  console?: SetupConsoleOptions | boolean;\n\n  /**\n   * Encoding options (atob/btoa)\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  encoding?: SetupEncodingOptions | boolean;\n\n  /**\n   * Timer options (setTimeout, setInterval, clearTimeout, clearInterval)\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  timers?: SetupTimersOptions | boolean;\n\n  /**\n   * Crypto API options (crypto.subtle, crypto.getRandomValues, crypto.randomUUID)\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  crypto?: SetupCryptoOptions | boolean;\n}\n\n/**\n * Handle returned from setupRuntime\n */\nexport interface RuntimeHandle {\n  /** Core handle (always present) */\n  core: CoreHandle;\n\n  /** Fetch handle (if enabled) */\n  fetch?: FetchHandle;\n\n  /** File system handle (if enabled) */\n  fs?: FsHandle;\n\n  /** Console handle (if enabled) */\n  console?: ConsoleHandle;\n\n  /** Encoding handle (if enabled) */\n  encoding?: EncodingHandle;\n\n  /** Timers handle (if enabled) */\n  timers?: TimersHandle;\n\n  /** Crypto handle (if enabled) */\n  crypto?: CryptoHandle;\n\n  /** Shared state map */\n  readonly stateMap: StateMap;\n\n  /** Get the underlying QuickJS context */\n  readonly context: QuickJSContext;\n\n  /**\n   * Drain all pending jobs with timeout.\n   * Call BEFORE dispose() to prevent GC assertion failures.\n   * @param maxIterations - Maximum iterations (default: 1000)\n   * @returns true if all jobs completed, false if timed out\n   */\n  drainPendingJobs(maxIterations?: number): boolean;\n\n  /** Dispose all handles and cleanup */\n  dispose(): void;\n}\n\n/**\n * Setup multiple APIs in a QuickJS context\n *\n * @example\n * const handle = setupRuntime(context, {\n *   fetch: {\n *     onFetch: async (req) => fetch(req),\n *   },\n *   fs: {\n *     getDirectory: async (path) => createNodeDirectoryHandle(`/sandbox${path}`),\n *   },\n * });\n *\n * // Use the context...\n *\n * handle.dispose();\n */\nexport function setupRuntime(\n  context: QuickJSContext,\n  options: SetupRuntimeOptions = {}\n): RuntimeHandle {\n  const stateMap = createStateMap();\n\n  // Always setup core\n  const core = setupCore(context, { stateMap });\n\n  let fetch: FetchHandle | undefined;\n  let fs: FsHandle | undefined;\n  let consoleHandle: ConsoleHandle | undefined;\n  let encoding: EncodingHandle | undefined;\n  let timers: TimersHandle | undefined;\n  let cryptoHandle: CryptoHandle | undefined;\n\n  // Setup fetch if enabled\n  if (options.fetch) {\n    const fetchOptions: SetupFetchOptions =\n      options.fetch === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.fetch, stateMap, coreHandle: core };\n\n    fetch = setupFetch(context, fetchOptions);\n  }\n\n  // Setup fs if provided\n  if (options.fs) {\n    fs = setupFs(context, {\n      ...options.fs,\n      stateMap,\n      coreHandle: core,\n    });\n  }\n\n  // Setup console if enabled\n  if (options.console) {\n    const consoleOptions: SetupConsoleOptions =\n      options.console === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.console, stateMap, coreHandle: core };\n\n    consoleHandle = setupConsole(context, consoleOptions);\n  }\n\n  // Setup encoding if enabled\n  if (options.encoding) {\n    const encodingOptions: SetupEncodingOptions =\n      options.encoding === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.encoding, stateMap, coreHandle: core };\n\n    encoding = setupEncoding(context, encodingOptions);\n  }\n\n  // Setup timers if enabled\n  if (options.timers) {\n    const timersOptions: SetupTimersOptions =\n      options.timers === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.timers, stateMap, coreHandle: core };\n\n    timers = setupTimers(context, timersOptions);\n  }\n\n  // Setup crypto if enabled\n  if (options.crypto) {\n    const cryptoOptions: SetupCryptoOptions =\n      options.crypto === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.crypto, stateMap, coreHandle: core };\n\n    cryptoHandle = setupCrypto(context, cryptoOptions);\n  }\n\n  return {\n    core,\n    fetch,\n    fs,\n    console: consoleHandle,\n    encoding,\n    timers,\n    crypto: cryptoHandle,\n    stateMap,\n    get context() {\n      return context;\n    },\n    drainPendingJobs(maxIterations = 1000): boolean {\n      for (let i = 0; i < maxIterations; i++) {\n        if (!context.runtime.hasPendingJob()) {\n          return true;\n        }\n        const result = context.runtime.executePendingJobs();\n        if (result.error) {\n          result.error.dispose();\n        }\n      }\n      return !context.runtime.hasPendingJob();\n    },\n    dispose() {\n      // Drain pending jobs before disposal\n      for (let i = 0; i < 1000; i++) {\n        if (!context.runtime.hasPendingJob()) break;\n        const result = context.runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Dispose sub-handles in reverse order\n      cryptoHandle?.dispose();\n      timers?.dispose();\n      encoding?.dispose();\n      consoleHandle?.dispose();\n      fs?.dispose();\n      fetch?.dispose();\n\n      // Drain pending jobs again after sub-handle disposal\n      // (fetch?.dispose() calls evalCode which can create new jobs)\n      for (let i = 0; i < 1000; i++) {\n        if (!context.runtime.hasPendingJob()) break;\n        const result = context.runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Clean up tracked handles\n      cleanupUnmarshaledHandles(context);\n      clearAllInstanceState();\n\n      // Clear globals to help GC break circular references\n      try {\n        const clearGlobals = context.evalCode(`\n          (function() {\n            const keysToDelete = Object.keys(globalThis).filter(k =>\n              k !== 'globalThis' && k !== 'undefined' && k !== 'NaN' && k !== 'Infinity'\n            );\n            for (const key of keysToDelete) {\n              try { globalThis[key] = undefined; } catch (e) {}\n            }\n            for (const key of keysToDelete) {\n              try { delete globalThis[key]; } catch (e) {}\n            }\n            return keysToDelete.length;\n          })()\n        `);\n        if (clearGlobals.error) {\n          clearGlobals.error.dispose();\n        } else {\n          clearGlobals.value.dispose();\n        }\n      } catch (e) {\n        // Ignore errors during cleanup\n      }\n\n      // Final drain\n      for (let i = 0; i < 100; i++) {\n        if (!context.runtime.hasPendingJob()) break;\n        const result = context.runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      core.dispose();\n    },\n  };\n}\n"
+    "// Re-export everything from sub-packages\nexport * from \"@ricsam/quickjs-core\";\nexport * from \"@ricsam/quickjs-console\";\nexport * from \"@ricsam/quickjs-crypto\";\nexport * from \"@ricsam/quickjs-encoding\";\nexport * from \"@ricsam/quickjs-fetch\";\nexport * from \"@ricsam/quickjs-fs\";\nexport * from \"@ricsam/quickjs-timers\";\n\n// Export high-level createRuntime API\nexport {\n  createRuntime,\n  type RuntimeOptions,\n  type RuntimeHandle,\n  type RuntimeFetchHandle,\n  type RuntimeTimersHandle,\n  type RuntimeConsoleHandle,\n  type ModuleLoaderCallback,\n  type CustomFunction,\n  type CustomFunctionDefinition,\n  type CustomFunctions,\n  type FetchCallback,\n} from \"./create-runtime.cjs\";\n\nimport type { QuickJSContext } from \"quickjs-emscripten\";\nimport {\n  setupCore,\n  createStateMap,\n  cleanupUnmarshaledHandles,\n  clearAllInstanceState,\n  type StateMap,\n  type CoreHandle,\n} from \"@ricsam/quickjs-core\";\nimport {\n  setupFetch,\n  type SetupFetchOptions,\n  type FetchHandle,\n} from \"@ricsam/quickjs-fetch\";\nimport {\n  setupFs,\n  type SetupFsOptions,\n  type FsHandle,\n} from \"@ricsam/quickjs-fs\";\nimport {\n  setupConsole,\n  type SetupConsoleOptions,\n  type ConsoleHandle,\n} from \"@ricsam/quickjs-console\";\nimport {\n  setupEncoding,\n  type SetupEncodingOptions,\n  type EncodingHandle,\n} from \"@ricsam/quickjs-encoding\";\nimport {\n  setupTimers,\n  type SetupTimersOptions,\n  type TimersHandle,\n} from \"@ricsam/quickjs-timers\";\nimport {\n  setupCrypto,\n  type SetupCryptoOptions,\n  type CryptoHandle,\n} from \"@ricsam/quickjs-crypto\";\n\n/**\n * Options for setting up the runtime\n */\nexport interface SetupRuntimeOptions {\n  /**\n   * Fetch API options\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  fetch?: SetupFetchOptions | boolean;\n\n  /**\n   * File system options\n   * Pass options object to enable\n   * Pass `false` or omit to disable\n   */\n  fs?: SetupFsOptions | false;\n\n  /**\n   * Console options\n   * Pass `true` to enable with defaults\n   * Pass handlers object to customize\n   * Pass `false` or omit to disable\n   */\n  console?: SetupConsoleOptions | boolean;\n\n  /**\n   * Encoding options (atob/btoa)\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  encoding?: SetupEncodingOptions | boolean;\n\n  /**\n   * Timer options (setTimeout, setInterval, clearTimeout, clearInterval)\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  timers?: SetupTimersOptions | boolean;\n\n  /**\n   * Crypto API options (crypto.subtle, crypto.getRandomValues, crypto.randomUUID)\n   * Pass `true` to enable with defaults\n   * Pass `false` or omit to disable\n   */\n  crypto?: SetupCryptoOptions | boolean;\n}\n\n/**\n * Handle returned from setupRuntime (low-level API)\n */\nexport interface SetupRuntimeHandle {\n  /** Core handle (always present) */\n  core: CoreHandle;\n\n  /** Fetch handle (if enabled) */\n  fetch?: FetchHandle;\n\n  /** File system handle (if enabled) */\n  fs?: FsHandle;\n\n  /** Console handle (if enabled) */\n  console?: ConsoleHandle;\n\n  /** Encoding handle (if enabled) */\n  encoding?: EncodingHandle;\n\n  /** Timers handle (if enabled) */\n  timers?: TimersHandle;\n\n  /** Crypto handle (if enabled) */\n  crypto?: CryptoHandle;\n\n  /** Shared state map */\n  readonly stateMap: StateMap;\n\n  /** Get the underlying QuickJS context */\n  readonly context: QuickJSContext;\n\n  /**\n   * Drain all pending jobs with timeout.\n   * Call BEFORE dispose() to prevent GC assertion failures.\n   * @param maxIterations - Maximum iterations (default: 1000)\n   * @returns true if all jobs completed, false if timed out\n   */\n  drainPendingJobs(maxIterations?: number): boolean;\n\n  /** Dispose all handles and cleanup */\n  dispose(): void;\n}\n\n/**\n * Setup multiple APIs in a QuickJS context\n *\n * @example\n * const handle = setupRuntime(context, {\n *   fetch: {\n *     onFetch: async (req) => fetch(req),\n *   },\n *   fs: {\n *     getDirectory: async (path) => createNodeDirectoryHandle(`/sandbox${path}`),\n *   },\n * });\n *\n * // Use the context...\n *\n * handle.dispose();\n */\nexport function setupRuntime(\n  context: QuickJSContext,\n  options: SetupRuntimeOptions = {}\n): SetupRuntimeHandle {\n  const stateMap = createStateMap();\n\n  // Always setup core\n  const core = setupCore(context, { stateMap });\n\n  let fetch: FetchHandle | undefined;\n  let fs: FsHandle | undefined;\n  let consoleHandle: ConsoleHandle | undefined;\n  let encoding: EncodingHandle | undefined;\n  let timers: TimersHandle | undefined;\n  let cryptoHandle: CryptoHandle | undefined;\n\n  // Setup fetch if enabled\n  if (options.fetch) {\n    const fetchOptions: SetupFetchOptions =\n      options.fetch === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.fetch, stateMap, coreHandle: core };\n\n    fetch = setupFetch(context, fetchOptions);\n  }\n\n  // Setup fs if provided\n  if (options.fs) {\n    fs = setupFs(context, {\n      ...options.fs,\n      stateMap,\n      coreHandle: core,\n    });\n  }\n\n  // Setup console if enabled\n  if (options.console) {\n    const consoleOptions: SetupConsoleOptions =\n      options.console === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.console, stateMap, coreHandle: core };\n\n    consoleHandle = setupConsole(context, consoleOptions);\n  }\n\n  // Setup encoding if enabled\n  if (options.encoding) {\n    const encodingOptions: SetupEncodingOptions =\n      options.encoding === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.encoding, stateMap, coreHandle: core };\n\n    encoding = setupEncoding(context, encodingOptions);\n  }\n\n  // Setup timers if enabled\n  if (options.timers) {\n    const timersOptions: SetupTimersOptions =\n      options.timers === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.timers, stateMap, coreHandle: core };\n\n    timers = setupTimers(context, timersOptions);\n  }\n\n  // Setup crypto if enabled\n  if (options.crypto) {\n    const cryptoOptions: SetupCryptoOptions =\n      options.crypto === true\n        ? { stateMap, coreHandle: core }\n        : { ...options.crypto, stateMap, coreHandle: core };\n\n    cryptoHandle = setupCrypto(context, cryptoOptions);\n  }\n\n  return {\n    core,\n    fetch,\n    fs,\n    console: consoleHandle,\n    encoding,\n    timers,\n    crypto: cryptoHandle,\n    stateMap,\n    get context() {\n      return context;\n    },\n    drainPendingJobs(maxIterations = 1000): boolean {\n      for (let i = 0; i < maxIterations; i++) {\n        if (!context.runtime.hasPendingJob()) {\n          return true;\n        }\n        const result = context.runtime.executePendingJobs();\n        if (result.error) {\n          result.error.dispose();\n        }\n      }\n      return !context.runtime.hasPendingJob();\n    },\n    dispose() {\n      // Drain pending jobs before disposal\n      for (let i = 0; i < 1000; i++) {\n        if (!context.runtime.hasPendingJob()) break;\n        const result = context.runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Dispose sub-handles in reverse order\n      cryptoHandle?.dispose();\n      timers?.dispose();\n      encoding?.dispose();\n      consoleHandle?.dispose();\n      fs?.dispose();\n      fetch?.dispose();\n\n      // Drain pending jobs again after sub-handle disposal\n      // (fetch?.dispose() calls evalCode which can create new jobs)\n      for (let i = 0; i < 1000; i++) {\n        if (!context.runtime.hasPendingJob()) break;\n        const result = context.runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Clean up tracked handles\n      cleanupUnmarshaledHandles(context);\n      clearAllInstanceState();\n\n      // Clear globals to help GC break circular references\n      try {\n        const clearGlobals = context.evalCode(`\n          (function() {\n            const keysToDelete = Object.keys(globalThis).filter(k =>\n              k !== 'globalThis' && k !== 'undefined' && k !== 'NaN' && k !== 'Infinity'\n            );\n            for (const key of keysToDelete) {\n              try { globalThis[key] = undefined; } catch (e) {}\n            }\n            for (const key of keysToDelete) {\n              try { delete globalThis[key]; } catch (e) {}\n            }\n            return keysToDelete.length;\n          })()\n        `);\n        if (clearGlobals.error) {\n          clearGlobals.error.dispose();\n        } else {\n          clearGlobals.value.dispose();\n        }\n      } catch (e) {\n        // Ignore errors during cleanup\n      }\n\n      // Final drain\n      for (let i = 0; i < 100; i++) {\n        if (!context.runtime.hasPendingJob()) break;\n        const result = context.runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      core.dispose();\n    },\n  };\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "9F06C7428583920964756E2164756E21",
+  "mappings": "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",
+  "debugId": "D5C8A62287B56EA664756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-runtime",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "type": "commonjs"
 }

package/dist/mjs/create-runtime.mjs

@@ -0,0 +1,324 @@
+// @bun
+// packages/runtime/src/create-runtime.ts
+import {
+  getQuickJS,
+  newAsyncContext
+} from "quickjs-emscripten";
+import {
+  setupCore,
+  createStateMap,
+  cleanupUnmarshaledHandles,
+  clearAllInstanceState,
+  defineFunction,
+  defineAsyncFunction
+} from "@ricsam/quickjs-core";
+import {
+  setupFetch
+} from "@ricsam/quickjs-fetch";
+import {
+  setupFs
+} from "@ricsam/quickjs-fs";
+import {
+  setupConsole
+} from "@ricsam/quickjs-console";
+import {
+  setupEncoding
+} from "@ricsam/quickjs-encoding";
+import {
+  setupTimers
+} from "@ricsam/quickjs-timers";
+import {
+  setupCrypto
+} from "@ricsam/quickjs-crypto";
+import {
+  setupTestEnvironment
+} from "@ricsam/quickjs-test-environment";
+import {
+  setupPlaywright
+} from "@ricsam/quickjs-playwright";
+async function createRuntime(options) {
+  const opts = options ?? {};
+  const id = crypto.randomUUID();
+  const needsAsync = opts.moduleLoader !== undefined;
+  let context;
+  let runtime;
+  let isAsyncContext = false;
+  if (needsAsync) {
+    const asyncContext = await newAsyncContext();
+    context = asyncContext;
+    runtime = asyncContext.runtime;
+    isAsyncContext = true;
+    if (opts.moduleLoader) {
+      const moduleLoader = opts.moduleLoader;
+      runtime.setModuleLoader(async (moduleName) => {
+        try {
+          const code = await moduleLoader(moduleName);
+          return code;
+        } catch (error) {
+          return { error };
+        }
+      });
+    }
+  } else {
+    const QuickJS = await getQuickJS();
+    runtime = QuickJS.newRuntime();
+    context = runtime.newContext();
+  }
+  if (opts.memoryLimit) {
+    runtime.setMemoryLimit(opts.memoryLimit);
+  }
+  const stateMap = createStateMap();
+  const coreHandle = setupCore(context, { stateMap });
+  const consoleHandle = setupConsole(context, {
+    ...opts.console,
+    stateMap,
+    coreHandle
+  });
+  const encodingHandle = setupEncoding(context, { stateMap, coreHandle });
+  const timersHandle = setupTimers(context, { stateMap, coreHandle });
+  const cryptoHandle = setupCrypto(context, { stateMap, coreHandle });
+  let fetchHandle;
+  if (opts.fetch) {
+    const fetchCallback = opts.fetch;
+    fetchHandle = setupFetch(context, {
+      stateMap,
+      coreHandle,
+      onFetch: async (request) => {
+        return Promise.resolve(fetchCallback(request));
+      }
+    });
+  } else {
+    fetchHandle = setupFetch(context, { stateMap, coreHandle });
+  }
+  let fsHandle;
+  if (opts.fs) {
+    fsHandle = setupFs(context, {
+      ...opts.fs,
+      stateMap,
+      coreHandle
+    });
+  }
+  if (opts.customFunctions) {
+    for (const [name, def] of Object.entries(opts.customFunctions)) {
+      if (def.async) {
+        const fn = defineAsyncFunction(context, name, async (...args) => {
+          return def.fn(...args);
+        });
+        context.setProp(context.global, name, fn);
+        fn.dispose();
+      } else {
+        const fn = defineFunction(context, name, (...args) => {
+          return def.fn(...args);
+        });
+        context.setProp(context.global, name, fn);
+        fn.dispose();
+      }
+    }
+  }
+  let testEnvHandle;
+  if (opts.testEnvironment) {
+    const testEnvOpts = typeof opts.testEnvironment === "object" ? opts.testEnvironment : {};
+    testEnvHandle = setupTestEnvironment(context, {
+      stateMap,
+      coreHandle,
+      onEvent: testEnvOpts.onEvent
+    });
+  }
+  let playwrightHandle;
+  if (opts.playwright) {
+    playwrightHandle = setupPlaywright(context, {
+      ...opts.playwright,
+      stateMap,
+      coreHandle,
+      consoleCallbacks: opts.playwright.console ? opts.console : undefined
+    });
+  }
+  const runtimeFetchHandle = {
+    async dispatchRequest(request, _options) {
+      if (!fetchHandle) {
+        throw new Error("Fetch not configured");
+      }
+      return fetchHandle.dispatchRequest(request);
+    },
+    hasServeHandler() {
+      return fetchHandle?.hasServeHandler() ?? false;
+    },
+    hasActiveConnections() {
+      return fetchHandle?.hasActiveConnections() ?? false;
+    }
+  };
+  const runtimeTimersHandle = {
+    clearAll() {
+      timersHandle.clearAll();
+    }
+  };
+  const runtimeConsoleHandle = {
+    reset() {
+      consoleHandle.reset();
+    },
+    getTimers() {
+      return consoleHandle.getTimers();
+    },
+    getCounters() {
+      return consoleHandle.getCounters();
+    },
+    getGroupDepth() {
+      return consoleHandle.getGroupDepth();
+    }
+  };
+  const runtimeTestEnvironmentHandle = {
+    async runTests(_timeout) {
+      if (!testEnvHandle) {
+        throw new Error("Test environment not enabled. Set testEnvironment: true in createRuntime options.");
+      }
+      return testEnvHandle.run();
+    },
+    hasTests() {
+      return testEnvHandle?.hasTests() ?? false;
+    },
+    getTestCount() {
+      return testEnvHandle?.getTestCount() ?? 0;
+    },
+    reset() {
+      testEnvHandle?.reset();
+    }
+  };
+  const runtimePlaywrightHandle = {
+    getCollectedData() {
+      if (!playwrightHandle) {
+        return { browserConsoleLogs: [], networkRequests: [], networkResponses: [] };
+      }
+      return {
+        browserConsoleLogs: playwrightHandle.getBrowserConsoleLogs(),
+        networkRequests: playwrightHandle.getNetworkRequests(),
+        networkResponses: playwrightHandle.getNetworkResponses()
+      };
+    },
+    clearCollectedData() {
+      playwrightHandle?.clearCollected();
+    }
+  };
+  return {
+    id,
+    fetch: runtimeFetchHandle,
+    timers: runtimeTimersHandle,
+    console: runtimeConsoleHandle,
+    testEnvironment: runtimeTestEnvironmentHandle,
+    playwright: runtimePlaywrightHandle,
+    async eval(code, filename) {
+      if (isAsyncContext) {
+        const asyncContext = context;
+        const result = await asyncContext.evalCodeAsync(code, filename ?? "<eval>", {
+          type: "module"
+        });
+        if (result.error) {
+          const err = context.dump(result.error);
+          result.error.dispose();
+          throw new Error(`Eval failed: ${typeof err === "string" ? err : JSON.stringify(err)}`);
+        }
+        const promiseState = context.getPromiseState(result.value);
+        if (promiseState.type === "pending") {
+          const resolved = await context.resolvePromise(result.value);
+          result.value.dispose();
+          if (resolved.error) {
+            const err = context.dump(resolved.error);
+            resolved.error.dispose();
+            throw new Error(`Promise rejected: ${typeof err === "string" ? err : JSON.stringify(err)}`);
+          }
+          resolved.value.dispose();
+        } else {
+          result.value.dispose();
+        }
+        runtime.executePendingJobs();
+      } else {
+        const result = context.evalCode(code, filename ?? "<eval>", {
+          type: "module"
+        });
+        if (result.error) {
+          const err = context.dump(result.error);
+          result.error.dispose();
+          throw new Error(`Eval failed: ${typeof err === "string" ? err : JSON.stringify(err)}`);
+        }
+        const promiseState = context.getPromiseState(result.value);
+        if (promiseState.type === "pending") {
+          const resolved = await context.resolvePromise(result.value);
+          result.value.dispose();
+          runtime.executePendingJobs();
+          if (resolved.error) {
+            const err = context.dump(resolved.error);
+            resolved.error.dispose();
+            throw new Error(`Promise rejected: ${typeof err === "string" ? err : JSON.stringify(err)}`);
+          }
+          resolved.value.dispose();
+        } else {
+          result.value.dispose();
+        }
+        runtime.executePendingJobs();
+      }
+    },
+    async dispose() {
+      for (let i = 0;i < 1000; i++) {
+        if (!runtime.hasPendingJob())
+          break;
+        const result = runtime.executePendingJobs();
+        if (result.error)
+          result.error.dispose();
+      }
+      playwrightHandle?.dispose();
+      testEnvHandle?.dispose();
+      cryptoHandle.dispose();
+      timersHandle.dispose();
+      encodingHandle.dispose();
+      consoleHandle.dispose();
+      fsHandle?.dispose();
+      fetchHandle?.dispose();
+      for (let i = 0;i < 1000; i++) {
+        if (!runtime.hasPendingJob())
+          break;
+        const result = runtime.executePendingJobs();
+        if (result.error)
+          result.error.dispose();
+      }
+      cleanupUnmarshaledHandles(context);
+      clearAllInstanceState();
+      try {
+        const clearGlobals = context.evalCode(`
+          (function() {
+            const keysToDelete = Object.keys(globalThis).filter(k =>
+              k !== 'globalThis' && k !== 'undefined' && k !== 'NaN' && k !== 'Infinity'
+            );
+            for (const key of keysToDelete) {
+              try { globalThis[key] = undefined; } catch (e) {}
+            }
+            for (const key of keysToDelete) {
+              try { delete globalThis[key]; } catch (e) {}
+            }
+            return keysToDelete.length;
+          })()
+        `);
+        if (clearGlobals.error) {
+          clearGlobals.error.dispose();
+        } else {
+          clearGlobals.value.dispose();
+        }
+      } catch {}
+      for (let i = 0;i < 100; i++) {
+        if (!runtime.hasPendingJob())
+          break;
+        const result = runtime.executePendingJobs();
+        if (result.error)
+          result.error.dispose();
+      }
+      coreHandle.dispose();
+      context.dispose();
+      if (!isAsyncContext) {
+        runtime.dispose();
+      }
+    }
+  };
+}
+export {
+  createRuntime
+};
+
+//# debugId=59A2539D0E5B79D664756E2164756E21

package/dist/mjs/create-runtime.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/create-runtime.ts"],
+  "sourcesContent": [
+    "import {\n  getQuickJS,\n  newAsyncContext,\n  type QuickJSAsyncContext,\n  type QuickJSAsyncRuntime,\n  type QuickJSContext,\n  type QuickJSRuntime,\n} from \"quickjs-emscripten\";\nimport {\n  setupCore,\n  createStateMap,\n  cleanupUnmarshaledHandles,\n  clearAllInstanceState,\n  defineFunction,\n  defineAsyncFunction,\n  type StateMap,\n  type CoreHandle,\n} from \"@ricsam/quickjs-core\";\nimport {\n  setupFetch,\n  type SetupFetchOptions,\n  type FetchHandle,\n} from \"@ricsam/quickjs-fetch\";\nimport {\n  setupFs,\n  type SetupFsOptions,\n  type FsHandle,\n} from \"@ricsam/quickjs-fs\";\nimport {\n  setupConsole,\n  type ConsoleHandle,\n  type ConsoleEntry,\n  type ConsoleCallbacks,\n} from \"@ricsam/quickjs-console\";\nimport {\n  setupEncoding,\n  type EncodingHandle,\n} from \"@ricsam/quickjs-encoding\";\nimport {\n  setupTimers,\n  type TimersHandle,\n} from \"@ricsam/quickjs-timers\";\nimport {\n  setupCrypto,\n  type CryptoHandle,\n} from \"@ricsam/quickjs-crypto\";\nimport {\n  setupTestEnvironment,\n  type TestEnvironmentHandle,\n  type RunResults,\n  type TestEvent,\n} from \"@ricsam/quickjs-test-environment\";\nimport {\n  setupPlaywright,\n  type PlaywrightHandle,\n  type PlaywrightOptions,\n  type PlaywrightEvent,\n  type BrowserConsoleLogEntry,\n  type NetworkRequestInfo,\n  type NetworkResponseInfo,\n} from \"@ricsam/quickjs-playwright\";\n\n// Re-export types\nexport type { ConsoleEntry, ConsoleCallbacks, TestEvent, PlaywrightEvent };\n\n/**\n * Module loader callback type.\n * Called when the runtime imports a module dynamically.\n * Returns the JavaScript source code for the module.\n */\nexport type ModuleLoaderCallback = (\n  moduleName: string\n) => string | Promise<string>;\n\n/**\n * A custom function that can be called from within the runtime.\n */\nexport type CustomFunction = (...args: unknown[]) => unknown | Promise<unknown>;\n\n/**\n * Custom function definition with metadata.\n * Requires explicit `async` property to be clear about function behavior.\n */\nexport interface CustomFunctionDefinition {\n  /** The function implementation */\n  fn: CustomFunction;\n  /** Whether the function is async (returns a Promise) */\n  async: boolean;\n}\n\n/**\n * Custom functions to register in the runtime.\n * Each function must be defined with explicit async property.\n *\n * @example\n * ```typescript\n * customFunctions: {\n *   // Async function\n *   hashPassword: {\n *     fn: async (password) => bcrypt.hash(password, 10),\n *     async: true,\n *   },\n *   // Sync function\n *   getConfig: {\n *     fn: () => ({ environment: \"production\" }),\n *     async: false,\n *   },\n * }\n * ```\n */\nexport type CustomFunctions = Record<string, CustomFunctionDefinition>;\n\n/**\n * Fetch callback type.\n */\nexport type FetchCallback = (request: Request) => Response | Promise<Response>;\n\n/**\n * Test environment options.\n */\nexport interface TestEnvironmentOptions {\n  /** Event callback for test events */\n  onEvent?: (event: TestEvent) => void;\n  /** Default test timeout in milliseconds */\n  testTimeout?: number;\n}\n\n/**\n * Options for creating a runtime.\n */\nexport interface RuntimeOptions {\n  /** Memory limit in bytes (optional) */\n  memoryLimit?: number;\n  /** Console callback handlers */\n  console?: ConsoleCallbacks;\n  /** Fetch callback handler */\n  fetch?: FetchCallback;\n  /** File system options */\n  fs?: SetupFsOptions;\n  /** Module loader callback for resolving dynamic imports */\n  moduleLoader?: ModuleLoaderCallback;\n  /** Custom functions callable from within the runtime */\n  customFunctions?: CustomFunctions;\n  /** Current working directory for path operations. Defaults to \"/\" */\n  cwd?: string;\n  /** Test environment options. Set to true for defaults, or provide options. */\n  testEnvironment?: boolean | TestEnvironmentOptions;\n  /** Playwright options for browser automation */\n  playwright?: PlaywrightOptions;\n}\n\n/**\n * Runtime fetch handle - provides access to fetch/serve operations.\n */\nexport interface RuntimeFetchHandle {\n  /** Dispatch HTTP request to serve() handler */\n  dispatchRequest(request: Request, options?: { timeout?: number }): Promise<Response>;\n  /** Check if serve() has been called */\n  hasServeHandler(): boolean;\n  /** Check if there are active WebSocket connections */\n  hasActiveConnections(): boolean;\n}\n\n/**\n * Runtime timers handle - provides access to timer operations.\n */\nexport interface RuntimeTimersHandle {\n  /** Clear all pending timers */\n  clearAll(): void;\n}\n\n/**\n * Runtime console handle - provides access to console state.\n */\nexport interface RuntimeConsoleHandle {\n  /** Reset all console state (timers, counters, group depth) */\n  reset(): void;\n  /** Get console.time() timers */\n  getTimers(): Map<string, number>;\n  /** Get console.count() counters */\n  getCounters(): Map<string, number>;\n  /** Get current console.group() nesting depth */\n  getGroupDepth(): number;\n}\n\n/**\n * Runtime test environment handle - provides access to test operations.\n */\nexport interface RuntimeTestEnvironmentHandle {\n  /** Run all registered tests */\n  runTests(timeout?: number): Promise<RunResults>;\n  /** Check if any tests have been registered */\n  hasTests(): boolean;\n  /** Get the number of registered tests */\n  getTestCount(): number;\n  /** Reset test state (clear registered tests) */\n  reset(): void;\n}\n\n/**\n * Collected playwright data.\n */\nexport interface CollectedData {\n  browserConsoleLogs: BrowserConsoleLogEntry[];\n  networkRequests: NetworkRequestInfo[];\n  networkResponses: NetworkResponseInfo[];\n}\n\n/**\n * Runtime playwright handle - provides access to playwright data.\n */\nexport interface RuntimePlaywrightHandle {\n  /** Get collected browser logs and network data */\n  getCollectedData(): CollectedData;\n  /** Clear all collected data */\n  clearCollectedData(): void;\n}\n\n/**\n * Runtime handle - the main interface for interacting with the runtime.\n */\nexport interface RuntimeHandle {\n  /** Unique runtime identifier */\n  readonly id: string;\n  /** Execute code as ES module (supports top-level await) */\n  eval(code: string, filename?: string): Promise<void>;\n  /** Dispose all resources */\n  dispose(): Promise<void>;\n\n  /** Fetch handle - access to fetch/serve operations */\n  readonly fetch: RuntimeFetchHandle;\n  /** Timers handle - access to timer operations */\n  readonly timers: RuntimeTimersHandle;\n  /** Console handle - access to console state */\n  readonly console: RuntimeConsoleHandle;\n  /** Test environment handle - access to test operations */\n  readonly testEnvironment: RuntimeTestEnvironmentHandle;\n  /** Playwright handle - access to browser automation data */\n  readonly playwright: RuntimePlaywrightHandle;\n}\n\n/**\n * Create a fully configured QuickJS runtime\n *\n * Sets up all WHATWG APIs: fetch, fs, console, crypto, encoding, timers.\n * Supports ES modules with custom module loader and custom host functions.\n *\n * @example\n * ```typescript\n * const runtime = await createRuntime({\n *   console: { onEntry: (e) => console.log(\"[sandbox]\", e) },\n *   fetch: async (request) => fetch(request),\n *   moduleLoader: async (name) => {\n *     if (name === \"@/utils\") {\n *       return `export const add = (a, b) => a + b;`;\n *     }\n *     throw new Error(`Unknown module: ${name}`);\n *   },\n *   customFunctions: {\n *     hashPassword: {\n *       fn: async (pw) => Bun.password.hash(pw),\n *       async: true,\n *     },\n *   },\n * });\n *\n * await runtime.eval(`\n *   import { add } from \"@/utils\";\n *   const hash = await hashPassword(\"secret\");\n *   console.log(add(1, 2), hash);\n * `);\n *\n * await runtime.dispose();\n * ```\n */\nexport async function createRuntime(\n  options?: RuntimeOptions\n): Promise<RuntimeHandle> {\n  const opts = options ?? {};\n\n  // Generate unique ID\n  const id = crypto.randomUUID();\n\n  // Determine if we need async context (for async module loader)\n  const needsAsync = opts.moduleLoader !== undefined;\n\n  let context: QuickJSContext | QuickJSAsyncContext;\n  let runtime: QuickJSRuntime | QuickJSAsyncRuntime;\n  let isAsyncContext = false;\n\n  if (needsAsync) {\n    // Create async context for module loading support\n    const asyncContext = await newAsyncContext();\n    context = asyncContext;\n    runtime = asyncContext.runtime;\n    isAsyncContext = true;\n\n    // Set up module loader\n    if (opts.moduleLoader) {\n      const moduleLoader = opts.moduleLoader;\n      (runtime as QuickJSAsyncRuntime).setModuleLoader(async (moduleName: string) => {\n        try {\n          const code = await moduleLoader(moduleName);\n          return code;\n        } catch (error) {\n          // Return error in SuccessOrFail format\n          return { error: error as Error };\n        }\n      });\n    }\n  } else {\n    // Create sync context\n    const QuickJS = await getQuickJS();\n    runtime = QuickJS.newRuntime();\n    context = runtime.newContext();\n  }\n\n  // Set memory limit if specified\n  if (opts.memoryLimit) {\n    runtime.setMemoryLimit(opts.memoryLimit);\n  }\n\n  // Create shared state\n  const stateMap = createStateMap();\n\n  // Setup core APIs\n  const coreHandle = setupCore(context, { stateMap });\n\n  // Setup console\n  const consoleHandle = setupConsole(context, {\n    ...opts.console,\n    stateMap,\n    coreHandle,\n  });\n\n  // Setup encoding (btoa/atob)\n  const encodingHandle = setupEncoding(context, { stateMap, coreHandle });\n\n  // Setup timers\n  const timersHandle = setupTimers(context, { stateMap, coreHandle });\n\n  // Setup crypto\n  const cryptoHandle = setupCrypto(context, { stateMap, coreHandle });\n\n  // Setup fetch if callback provided\n  let fetchHandle: FetchHandle | undefined;\n  if (opts.fetch) {\n    const fetchCallback = opts.fetch;\n    fetchHandle = setupFetch(context, {\n      stateMap,\n      coreHandle,\n      onFetch: async (request: Request) => {\n        return Promise.resolve(fetchCallback(request));\n      },\n    });\n  } else {\n    // Still setup fetch for serve() support, but without fetch() function\n    fetchHandle = setupFetch(context, { stateMap, coreHandle });\n  }\n\n  // Setup file system if provided\n  let fsHandle: FsHandle | undefined;\n  if (opts.fs) {\n    fsHandle = setupFs(context, {\n      ...opts.fs,\n      stateMap,\n      coreHandle,\n    });\n  }\n\n  // Setup custom functions\n  if (opts.customFunctions) {\n    for (const [name, def] of Object.entries(opts.customFunctions)) {\n      if (def.async) {\n        const fn = defineAsyncFunction(context, name, async (...args: unknown[]) => {\n          return def.fn(...args);\n        });\n        context.setProp(context.global, name, fn);\n        fn.dispose();\n      } else {\n        const fn = defineFunction(context, name, (...args: unknown[]) => {\n          return def.fn(...args);\n        });\n        context.setProp(context.global, name, fn);\n        fn.dispose();\n      }\n    }\n  }\n\n  // Setup test environment if enabled\n  let testEnvHandle: TestEnvironmentHandle | undefined;\n  if (opts.testEnvironment) {\n    const testEnvOpts = typeof opts.testEnvironment === \"object\" ? opts.testEnvironment : {};\n    testEnvHandle = setupTestEnvironment(context, {\n      stateMap,\n      coreHandle,\n      onEvent: testEnvOpts.onEvent,\n    });\n  }\n\n  // Setup playwright if provided\n  let playwrightHandle: PlaywrightHandle | undefined;\n  if (opts.playwright) {\n    playwrightHandle = setupPlaywright(context, {\n      ...opts.playwright,\n      stateMap,\n      coreHandle,\n      consoleCallbacks: opts.playwright.console ? opts.console : undefined,\n    });\n  }\n\n  // Create fetch handle wrapper\n  const runtimeFetchHandle: RuntimeFetchHandle = {\n    async dispatchRequest(request: Request, _options?: { timeout?: number }): Promise<Response> {\n      if (!fetchHandle) {\n        throw new Error(\"Fetch not configured\");\n      }\n      // Note: timeout option not yet implemented in underlying FetchHandle\n      return fetchHandle.dispatchRequest(request);\n    },\n    hasServeHandler() {\n      return fetchHandle?.hasServeHandler() ?? false;\n    },\n    hasActiveConnections() {\n      return fetchHandle?.hasActiveConnections() ?? false;\n    },\n  };\n\n  // Create timers handle wrapper\n  const runtimeTimersHandle: RuntimeTimersHandle = {\n    clearAll() {\n      timersHandle.clearAll();\n    },\n  };\n\n  // Create console handle wrapper\n  const runtimeConsoleHandle: RuntimeConsoleHandle = {\n    reset() {\n      consoleHandle.reset();\n    },\n    getTimers() {\n      return consoleHandle.getTimers();\n    },\n    getCounters() {\n      return consoleHandle.getCounters();\n    },\n    getGroupDepth() {\n      return consoleHandle.getGroupDepth();\n    },\n  };\n\n  // Create test environment handle wrapper\n  const runtimeTestEnvironmentHandle: RuntimeTestEnvironmentHandle = {\n    async runTests(_timeout?: number): Promise<RunResults> {\n      if (!testEnvHandle) {\n        throw new Error(\"Test environment not enabled. Set testEnvironment: true in createRuntime options.\");\n      }\n      return testEnvHandle.run();\n    },\n    hasTests() {\n      return testEnvHandle?.hasTests() ?? false;\n    },\n    getTestCount() {\n      return testEnvHandle?.getTestCount() ?? 0;\n    },\n    reset() {\n      testEnvHandle?.reset();\n    },\n  };\n\n  // Create playwright handle wrapper\n  const runtimePlaywrightHandle: RuntimePlaywrightHandle = {\n    getCollectedData() {\n      if (!playwrightHandle) {\n        return { browserConsoleLogs: [], networkRequests: [], networkResponses: [] };\n      }\n      return {\n        browserConsoleLogs: playwrightHandle.getBrowserConsoleLogs(),\n        networkRequests: playwrightHandle.getNetworkRequests(),\n        networkResponses: playwrightHandle.getNetworkResponses(),\n      };\n    },\n    clearCollectedData() {\n      playwrightHandle?.clearCollected();\n    },\n  };\n\n  return {\n    id,\n    fetch: runtimeFetchHandle,\n    timers: runtimeTimersHandle,\n    console: runtimeConsoleHandle,\n    testEnvironment: runtimeTestEnvironmentHandle,\n    playwright: runtimePlaywrightHandle,\n\n    async eval(code: string, filename?: string): Promise<void> {\n      if (isAsyncContext) {\n        // Use evalCodeAsync for async context (supports top-level await and async module loading)\n        const asyncContext = context as QuickJSAsyncContext;\n        const result = await asyncContext.evalCodeAsync(code, filename ?? \"<eval>\", {\n          type: \"module\",\n        });\n\n        if (result.error) {\n          const err = context.dump(result.error);\n          result.error.dispose();\n          throw new Error(`Eval failed: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n        }\n\n        // Handle module exports (could be a promise for top-level await)\n        const promiseState = context.getPromiseState(result.value);\n        if (promiseState.type === \"pending\") {\n          const resolved = await context.resolvePromise(result.value);\n          result.value.dispose();\n\n          if (resolved.error) {\n            const err = context.dump(resolved.error);\n            resolved.error.dispose();\n            throw new Error(`Promise rejected: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n          }\n          resolved.value.dispose();\n        } else {\n          result.value.dispose();\n        }\n\n        // Execute pending jobs\n        runtime.executePendingJobs();\n      } else {\n        // Use evalCode for sync context\n        const result = context.evalCode(code, filename ?? \"<eval>\", {\n          type: \"module\",\n        });\n\n        if (result.error) {\n          const err = context.dump(result.error);\n          result.error.dispose();\n          throw new Error(`Eval failed: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n        }\n\n        // Handle async module result\n        const promiseState = context.getPromiseState(result.value);\n        if (promiseState.type === \"pending\") {\n          const resolved = await context.resolvePromise(result.value);\n          result.value.dispose();\n\n          // Execute pending jobs\n          runtime.executePendingJobs();\n\n          if (resolved.error) {\n            const err = context.dump(resolved.error);\n            resolved.error.dispose();\n            throw new Error(`Promise rejected: ${typeof err === \"string\" ? err : JSON.stringify(err)}`);\n          }\n          resolved.value.dispose();\n        } else {\n          result.value.dispose();\n        }\n\n        // Execute any remaining pending jobs\n        runtime.executePendingJobs();\n      }\n    },\n\n    async dispose(): Promise<void> {\n      // Drain pending jobs before disposal\n      for (let i = 0; i < 1000; i++) {\n        if (!runtime.hasPendingJob()) break;\n        const result = runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Dispose handles in reverse order\n      playwrightHandle?.dispose();\n      testEnvHandle?.dispose();\n      cryptoHandle.dispose();\n      timersHandle.dispose();\n      encodingHandle.dispose();\n      consoleHandle.dispose();\n      fsHandle?.dispose();\n      fetchHandle?.dispose();\n\n      // Drain pending jobs again\n      for (let i = 0; i < 1000; i++) {\n        if (!runtime.hasPendingJob()) break;\n        const result = runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      // Clean up handles\n      cleanupUnmarshaledHandles(context);\n      clearAllInstanceState();\n\n      // Clear globals to help GC\n      try {\n        const clearGlobals = context.evalCode(`\n          (function() {\n            const keysToDelete = Object.keys(globalThis).filter(k =>\n              k !== 'globalThis' && k !== 'undefined' && k !== 'NaN' && k !== 'Infinity'\n            );\n            for (const key of keysToDelete) {\n              try { globalThis[key] = undefined; } catch (e) {}\n            }\n            for (const key of keysToDelete) {\n              try { delete globalThis[key]; } catch (e) {}\n            }\n            return keysToDelete.length;\n          })()\n        `);\n        if (clearGlobals.error) {\n          clearGlobals.error.dispose();\n        } else {\n          clearGlobals.value.dispose();\n        }\n      } catch {\n        // Ignore errors during cleanup\n      }\n\n      // Final drain\n      for (let i = 0; i < 100; i++) {\n        if (!runtime.hasPendingJob()) break;\n        const result = runtime.executePendingJobs();\n        if (result.error) result.error.dispose();\n      }\n\n      coreHandle.dispose();\n      context.dispose();\n\n      // Only dispose runtime if it was created separately (not via newAsyncContext)\n      if (!isAsyncContext) {\n        runtime.dispose();\n      }\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "59A2539D0E5B79D664756E2164756E21",
+  "names": []
+}

package/dist/mjs/index.mjs

@@ -7,6 +7,9 @@ export * from "@ricsam/quickjs-encoding";
 export * from "@ricsam/quickjs-fetch";
 export * from "@ricsam/quickjs-fs";
 export * from "@ricsam/quickjs-timers";
+import {
+  createRuntime
+} from "./create-runtime.mjs";
 import {
   setupCore,
   createStateMap,
@@ -147,7 +150,8 @@ function setupRuntime(context, options = {}) {
   };
 }
 export {
-  setupRuntime
+  setupRuntime,
+  createRuntime
 };
 
-//# debugId=3A1DE579F5C2FCF564756E2164756E21
+//# debugId=B678E9E9303FA62664756E2164756E21