@ricsam/isolate-runtime 0.1.4 → 0.1.7

package/dist/mjs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "import ivm from \"isolated-vm\";\nimport { setupCore } from \"@ricsam/isolate-core\";\nimport { setupConsole } from \"@ricsam/isolate-console\";\nimport { setupEncoding } from \"@ricsam/isolate-encoding\";\nimport { setupTimers } from \"@ricsam/isolate-timers\";\nimport { setupPath } from \"@ricsam/isolate-path\";\nimport { setupCrypto } from \"@ricsam/isolate-crypto\";\nimport { setupFetch } from \"@ricsam/isolate-fetch\";\nimport { setupFs } from \"@ricsam/isolate-fs\";\n\nimport type { ConsoleOptions, ConsoleHandle } from \"@ricsam/isolate-console\";\nimport type { FetchOptions, FetchHandle } from \"@ricsam/isolate-fetch\";\nimport type { FsOptions, FsHandle } from \"@ricsam/isolate-fs\";\nimport type { CoreHandle } from \"@ricsam/isolate-core\";\nimport type { EncodingHandle } from \"@ricsam/isolate-encoding\";\nimport type { TimersHandle } from \"@ricsam/isolate-timers\";\nimport type { PathHandle } from \"@ricsam/isolate-path\";\nimport type { CryptoHandle } from \"@ricsam/isolate-crypto\";\n\nexport interface RuntimeOptions {\n  /** Isolate memory limit in MB */\n  memoryLimit?: number;\n  /** Console options */\n  console?: ConsoleOptions;\n  /** Fetch options */\n  fetch?: FetchOptions;\n  /** File system options (optional - fs only set up if provided) */\n  fs?: FsOptions;\n}\n\nexport interface RuntimeHandle {\n  /** The isolate instance */\n  readonly isolate: ivm.Isolate;\n  /** The context instance */\n  readonly context: ivm.Context;\n  /** The fetch handle for serve() and WebSocket dispatching */\n  readonly fetch: FetchHandle;\n  /** Process pending timers */\n  tick(ms?: number): Promise<void>;\n  /** Dispose all resources */\n  dispose(): void;\n}\n\n/**\n * Create a fully configured isolated-vm runtime\n *\n * Sets up all WHATWG APIs: fetch, fs, console, crypto, encoding, timers\n *\n * @example\n * const runtime = await createRuntime({\n *   console: {\n *     onLog: (level, ...args) => console.log(`[${level}]`, ...args)\n *   },\n *   fetch: {\n *     onFetch: async (request) => fetch(request)\n *   }\n * });\n *\n * await runtime.context.eval(`\n *   console.log(\"Hello from sandbox!\");\n *   const response = await fetch(\"https://example.com\");\n * `);\n *\n * runtime.dispose();\n */\nexport async function createRuntime(\n  options?: RuntimeOptions\n): Promise<RuntimeHandle> {\n  const opts = options ?? {};\n\n  // Create isolate with optional memory limit\n  const isolate = new ivm.Isolate({\n    memoryLimit: opts.memoryLimit,\n  });\n  const context = await isolate.createContext();\n\n  // Store all handles for disposal\n  const handles: {\n    core?: CoreHandle;\n    console?: ConsoleHandle;\n    encoding?: EncodingHandle;\n    timers?: TimersHandle;\n    path?: PathHandle;\n    crypto?: CryptoHandle;\n    fetch?: FetchHandle;\n    fs?: FsHandle;\n  } = {};\n\n  // Setup all APIs in order\n  // Core must be first as it provides Blob, File, streams, URL, etc.\n  handles.core = await setupCore(context);\n\n  // Console\n  handles.console = await setupConsole(context, opts.console);\n\n  // Encoding (btoa/atob)\n  handles.encoding = await setupEncoding(context);\n\n  // Timers (setTimeout, setInterval)\n  handles.timers = await setupTimers(context);\n\n  // Path module\n  handles.path = await setupPath(context);\n\n  // Crypto (randomUUID, getRandomValues)\n  handles.crypto = await setupCrypto(context);\n\n  // Fetch API\n  handles.fetch = await setupFetch(context, opts.fetch);\n\n  // File system (only if handler provided)\n  if (opts.fs) {\n    handles.fs = await setupFs(context, opts.fs);\n  }\n\n  return {\n    isolate,\n    context,\n    fetch: handles.fetch!,\n    async tick(ms?: number) {\n      await handles.timers!.tick(ms);\n    },\n    dispose() {\n      // Dispose all handles\n      handles.fs?.dispose();\n      handles.fetch?.dispose();\n      handles.crypto?.dispose();\n      handles.path?.dispose();\n      handles.timers?.dispose();\n      handles.encoding?.dispose();\n      handles.console?.dispose();\n      handles.core?.dispose();\n\n      // Release context and dispose isolate\n      context.release();\n      isolate.dispose();\n    },\n  };\n}\n\n// Re-export all package types and functions\nexport { setupCore } from \"@ricsam/isolate-core\";\nexport type { CoreHandle, SetupCoreOptions } from \"@ricsam/isolate-core\";\n\nexport { setupConsole } from \"@ricsam/isolate-console\";\nexport type { ConsoleHandle, ConsoleOptions } from \"@ricsam/isolate-console\";\n\nexport { setupCrypto } from \"@ricsam/isolate-crypto\";\nexport type { CryptoHandle } from \"@ricsam/isolate-crypto\";\n\nexport { setupEncoding } from \"@ricsam/isolate-encoding\";\nexport type { EncodingHandle } from \"@ricsam/isolate-encoding\";\n\nexport { setupFetch } from \"@ricsam/isolate-fetch\";\nexport type { FetchHandle, FetchOptions, WebSocketCommand, UpgradeRequest } from \"@ricsam/isolate-fetch\";\n\nexport { setupFs, createNodeFileSystemHandler } from \"@ricsam/isolate-fs\";\nexport type { FsHandle, FsOptions, FileSystemHandler, NodeFileSystemHandlerOptions } from \"@ricsam/isolate-fs\";\n\nexport { setupPath } from \"@ricsam/isolate-path\";\nexport type { PathHandle } from \"@ricsam/isolate-path\";\n\nexport { setupTimers } from \"@ricsam/isolate-timers\";\nexport type { TimersHandle } from \"@ricsam/isolate-timers\";\n"
+    "import ivm from \"isolated-vm\";\nimport { setupCore } from \"@ricsam/isolate-core\";\nimport { setupConsole } from \"@ricsam/isolate-console\";\nimport { setupEncoding } from \"@ricsam/isolate-encoding\";\nimport { setupTimers } from \"@ricsam/isolate-timers\";\nimport { setupPath } from \"@ricsam/isolate-path\";\nimport { setupCrypto } from \"@ricsam/isolate-crypto\";\nimport { setupFetch } from \"@ricsam/isolate-fetch\";\nimport { setupFs } from \"@ricsam/isolate-fs\";\nimport {\n  setupTestEnvironment,\n  runTests as runTestsInContext,\n  hasTests as hasTestsInContext,\n  getTestCount as getTestCountInContext,\n} from \"@ricsam/isolate-test-environment\";\nimport { setupPlaywright } from \"@ricsam/isolate-playwright\";\n\nimport type { ConsoleOptions, ConsoleHandle } from \"@ricsam/isolate-console\";\nimport type { FetchOptions, FetchHandle, DispatchRequestOptions, UpgradeRequest, WebSocketCommand } from \"@ricsam/isolate-fetch\";\nimport type { FsOptions, FsHandle } from \"@ricsam/isolate-fs\";\nimport type { CoreHandle } from \"@ricsam/isolate-core\";\nimport type { EncodingHandle } from \"@ricsam/isolate-encoding\";\nimport type { TimersHandle } from \"@ricsam/isolate-timers\";\nimport type { PathHandle } from \"@ricsam/isolate-path\";\nimport type { CryptoHandle } from \"@ricsam/isolate-crypto\";\nimport type {\n  TestEnvironmentHandle,\n  RunResults,\n  TestEnvironmentOptions,\n  TestEvent,\n  SuiteInfo,\n  SuiteResult,\n  TestInfo,\n  TestResult,\n  TestError,\n} from \"@ricsam/isolate-test-environment\";\nimport type {\n  PlaywrightHandle,\n  NetworkRequestInfo,\n  NetworkResponseInfo,\n  BrowserConsoleLogEntry,\n  PlaywrightEvent,\n} from \"@ricsam/isolate-playwright\";\nimport type {\n  ConsoleCallbacks,\n  ConsoleEntry,\n  FetchCallback,\n  ModuleLoaderCallback,\n  CustomFunctionDefinition,\n  CustomFunctions,\n  CustomAsyncGeneratorFunction,\n  DispatchOptions,\n} from \"@ricsam/isolate-protocol\";\n\n// Re-export shared types from protocol\nexport type {\n  ConsoleCallbacks,\n  ConsoleEntry,\n  FetchCallback,\n  ModuleLoaderCallback,\n  CustomFunction,\n  CustomFunctionDefinition,\n  CustomFunctions,\n  DispatchOptions,\n} from \"@ricsam/isolate-protocol\";\n\n/**\n * Options for creating a runtime.\n */\nexport interface RuntimeOptions {\n  /** Memory limit in megabytes (optional) */\n  memoryLimitMB?: number;\n  /** Console callback handlers */\n  console?: ConsoleCallbacks;\n  /** Fetch callback handler */\n  fetch?: FetchCallback;\n  /**\n   * File system options.\n   * Note: For local runtime, this uses FsOptions with getDirectory returning a FileSystemHandler.\n   * For remote runtime (isolate-client), use FileSystemCallbacks instead.\n   */\n  fs?: FsOptions;\n  /** Module loader callback for resolving dynamic imports */\n  moduleLoader?: ModuleLoaderCallback;\n  /** Custom functions callable from within the isolate */\n  customFunctions?: CustomFunctions;\n  /** Current working directory for path.resolve(). Defaults to \"/\" */\n  cwd?: string;\n  /** Enable test environment (describe, it, expect, etc.) */\n  testEnvironment?: boolean | TestEnvironmentOptions;\n  /** Playwright options - user provides page object */\n  playwright?: PlaywrightOptions;\n}\n\n/**\n * Options for playwright in local runtime.\n */\nexport interface PlaywrightOptions {\n  /** Playwright Page object - user launches browser and creates page */\n  page: import(\"playwright\").Page;\n  /** Default timeout for operations (default: 30000ms) */\n  timeout?: number;\n  /** Base URL for relative navigation */\n  baseUrl?: string;\n  /** If true, browser console logs are routed through console handler (or printed to stdout if no handler) */\n  console?: boolean;\n  /** Unified event callback for all playwright events */\n  onEvent?: (event: PlaywrightEvent) => void;\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?: DispatchRequestOptions): Promise<Response>;\n  /** Check if isolate requested WebSocket upgrade */\n  getUpgradeRequest(): UpgradeRequest | null;\n  /** Dispatch WebSocket open event to isolate */\n  dispatchWebSocketOpen(connectionId: string): void;\n  /** Dispatch WebSocket message event to isolate */\n  dispatchWebSocketMessage(connectionId: string, message: string | ArrayBuffer): void;\n  /** Dispatch WebSocket close event to isolate */\n  dispatchWebSocketClose(connectionId: string, code: number, reason: string): void;\n  /** Dispatch WebSocket error event to isolate */\n  dispatchWebSocketError(connectionId: string, error: Error): void;\n  /** Register callback for WebSocket commands from isolate */\n  onWebSocketCommand(callback: (cmd: WebSocketCommand) => void): () => void;\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 * Timers fire automatically based on real time.\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 execution.\n */\nexport interface RuntimeTestEnvironmentHandle {\n  /** Run all registered tests */\n  runTests(timeout?: number): Promise<RunResults>;\n  /** Check if any tests are registered */\n  hasTests(): boolean;\n  /** Get count of registered tests */\n  getTestCount(): number;\n  /** Reset test state */\n  reset(): void;\n}\n\n/**\n * Runtime playwright handle - provides access to browser data collection.\n */\nexport interface RuntimePlaywrightHandle {\n  /** Get collected browser data (console logs, network requests/responses) */\n  getCollectedData(): CollectedData;\n  /** Clear collected browser data */\n  clearCollectedData(): void;\n}\n\n/**\n * Collected browser data from playwright.\n */\nexport interface CollectedData {\n  /** Browser console logs (from the page, not sandbox) */\n  browserConsoleLogs: BrowserConsoleLogEntry[];\n  networkRequests: NetworkRequestInfo[];\n  networkResponses: NetworkResponseInfo[];\n}\n\n/**\n * Options for eval() method.\n */\nexport interface EvalOptions {\n  /** Filename for stack traces */\n  filename?: string;\n  /** Maximum execution time in milliseconds. If exceeded, throws a timeout error. */\n  maxExecutionMs?: number;\n}\n\n/**\n * Runtime handle - the main interface for interacting with the isolate.\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, filenameOrOptions?: string | EvalOptions): 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 execution (throws if not enabled) */\n  readonly testEnvironment: RuntimeTestEnvironmentHandle;\n  /** Playwright handle - access to playwright operations (throws if not configured) */\n  readonly playwright: RuntimePlaywrightHandle;\n}\n\n// Internal state for runtime\ninterface RuntimeState {\n  isolate: ivm.Isolate;\n  context: ivm.Context;\n  handles: {\n    core?: CoreHandle;\n    console?: ConsoleHandle;\n    encoding?: EncodingHandle;\n    timers?: TimersHandle;\n    path?: PathHandle;\n    crypto?: CryptoHandle;\n    fetch?: FetchHandle;\n    fs?: FsHandle;\n    testEnvironment?: TestEnvironmentHandle;\n    playwright?: PlaywrightHandle;\n  };\n  moduleCache: Map<string, ivm.Module>;\n  moduleLoader?: ModuleLoaderCallback;\n  customFunctions?: CustomFunctions;\n  customFnInvokeRef?: ivm.Reference<\n    (name: string, argsJson: string) => Promise<string>\n  >;\n}\n\n// Iterator session tracking for async iterator custom functions\ninterface IteratorSession {\n  iterator: AsyncGenerator<unknown, unknown, unknown>;\n}\n\nconst iteratorSessions = new Map<number, IteratorSession>();\nlet nextIteratorId = 1;\n\n/**\n * Setup custom functions as globals in the isolate context.\n * Each function directly calls the host callback when invoked.\n */\nasync function setupCustomFunctions(\n  context: ivm.Context,\n  customFunctions: CustomFunctions\n): Promise<ivm.Reference<(name: string, argsJson: string) => Promise<string>>> {\n  const global = context.global;\n\n  // Reference that invokes the callback and returns the result\n  const invokeCallbackRef = new ivm.Reference(\n    async (name: string, argsJson: string): Promise<string> => {\n      const def = customFunctions[name];\n      if (!def) {\n        return JSON.stringify({\n          ok: false,\n          error: { message: `Custom function '${name}' not found`, name: \"Error\" },\n        });\n      }\n      const args = JSON.parse(argsJson) as unknown[];\n      try {\n        const result = def.type === 'async' ? await def.fn(...args) : def.fn(...args);\n        return JSON.stringify({ ok: true, value: result });\n      } catch (error: unknown) {\n        const err = error as Error;\n        return JSON.stringify({\n          ok: false,\n          error: { message: err.message, name: err.name },\n        });\n      }\n    }\n  );\n\n  global.setSync(\"__customFn_invoke\", invokeCallbackRef);\n\n  // Iterator start: creates iterator, stores in session, returns iteratorId\n  const iterStartRef = new ivm.Reference(\n    async (name: string, argsJson: string): Promise<string> => {\n      const def = customFunctions[name];\n      if (!def || def.type !== 'asyncIterator') {\n        return JSON.stringify({\n          ok: false,\n          error: { message: `Async iterator function '${name}' not found`, name: \"Error\" },\n        });\n      }\n      try {\n        const args = JSON.parse(argsJson) as unknown[];\n        const fn = def.fn as CustomAsyncGeneratorFunction;\n        const iterator = fn(...args);\n        const iteratorId = nextIteratorId++;\n        iteratorSessions.set(iteratorId, { iterator });\n        return JSON.stringify({ ok: true, iteratorId });\n      } catch (error: unknown) {\n        const err = error as Error;\n        return JSON.stringify({\n          ok: false,\n          error: { message: err.message, name: err.name },\n        });\n      }\n    }\n  );\n\n  global.setSync(\"__iter_start\", iterStartRef);\n\n  // Iterator next: calls iterator.next(), returns {done, value}\n  const iterNextRef = new ivm.Reference(\n    async (iteratorId: number): Promise<string> => {\n      const session = iteratorSessions.get(iteratorId);\n      if (!session) {\n        return JSON.stringify({\n          ok: false,\n          error: { message: `Iterator session ${iteratorId} not found`, name: \"Error\" },\n        });\n      }\n      try {\n        const result = await session.iterator.next();\n        if (result.done) {\n          iteratorSessions.delete(iteratorId);\n        }\n        return JSON.stringify({ ok: true, done: result.done, value: result.value });\n      } catch (error: unknown) {\n        const err = error as Error;\n        iteratorSessions.delete(iteratorId);\n        return JSON.stringify({\n          ok: false,\n          error: { message: err.message, name: err.name },\n        });\n      }\n    }\n  );\n\n  global.setSync(\"__iter_next\", iterNextRef);\n\n  // Iterator return: calls iterator.return(), cleans up session\n  const iterReturnRef = new ivm.Reference(\n    async (iteratorId: number, valueJson: string): Promise<string> => {\n      const session = iteratorSessions.get(iteratorId);\n      if (!session) {\n        return JSON.stringify({ ok: true, done: true, value: undefined });\n      }\n      try {\n        const value = valueJson ? JSON.parse(valueJson) : undefined;\n        const result = await session.iterator.return?.(value);\n        iteratorSessions.delete(iteratorId);\n        return JSON.stringify({ ok: true, done: true, value: result?.value });\n      } catch (error: unknown) {\n        const err = error as Error;\n        iteratorSessions.delete(iteratorId);\n        return JSON.stringify({\n          ok: false,\n          error: { message: err.message, name: err.name },\n        });\n      }\n    }\n  );\n\n  global.setSync(\"__iter_return\", iterReturnRef);\n\n  // Iterator throw: calls iterator.throw(), cleans up session\n  const iterThrowRef = new ivm.Reference(\n    async (iteratorId: number, errorJson: string): Promise<string> => {\n      const session = iteratorSessions.get(iteratorId);\n      if (!session) {\n        return JSON.stringify({\n          ok: false,\n          error: { message: `Iterator session ${iteratorId} not found`, name: \"Error\" },\n        });\n      }\n      try {\n        const errorData = JSON.parse(errorJson) as { message: string; name: string };\n        const error = Object.assign(new Error(errorData.message), { name: errorData.name });\n        const result = await session.iterator.throw?.(error);\n        iteratorSessions.delete(iteratorId);\n        return JSON.stringify({ ok: true, done: result?.done ?? true, value: result?.value });\n      } catch (error: unknown) {\n        const err = error as Error;\n        iteratorSessions.delete(iteratorId);\n        return JSON.stringify({\n          ok: false,\n          error: { message: err.message, name: err.name },\n        });\n      }\n    }\n  );\n\n  global.setSync(\"__iter_throw\", iterThrowRef);\n\n  // Create wrapper functions for each custom function\n  for (const name of Object.keys(customFunctions)) {\n    const def = customFunctions[name]!;\n\n    if (def.type === 'async') {\n      // Async function: use applySyncPromise and async function wrapper\n      context.evalSync(`\n        globalThis.${name} = async function(...args) {\n          const resultJson = __customFn_invoke.applySyncPromise(\n            undefined,\n            [\"${name}\", JSON.stringify(args)]\n          );\n          const result = JSON.parse(resultJson);\n          if (result.ok) {\n            return result.value;\n          } else {\n            const error = new Error(result.error.message);\n            error.name = result.error.name;\n            throw error;\n          }\n        };\n      `);\n    } else if (def.type === 'sync') {\n      // Sync function: use applySyncPromise (to await the host) but wrap in regular function\n      // The function blocks until the host responds, but returns the value directly (not a Promise)\n      context.evalSync(`\n        globalThis.${name} = function(...args) {\n          const resultJson = __customFn_invoke.applySyncPromise(\n            undefined,\n            [\"${name}\", JSON.stringify(args)]\n          );\n          const result = JSON.parse(resultJson);\n          if (result.ok) {\n            return result.value;\n          } else {\n            const error = new Error(result.error.message);\n            error.name = result.error.name;\n            throw error;\n          }\n        };\n      `);\n    } else if (def.type === 'asyncIterator') {\n      // Async iterator function: returns an async iterable object\n      context.evalSync(`\n        globalThis.${name} = function(...args) {\n          const startResult = JSON.parse(__iter_start.applySyncPromise(undefined, [\"${name}\", JSON.stringify(args)]));\n          if (!startResult.ok) {\n            throw Object.assign(new Error(startResult.error.message), { name: startResult.error.name });\n          }\n          const iteratorId = startResult.iteratorId;\n          return {\n            [Symbol.asyncIterator]() { return this; },\n            async next() {\n              const result = JSON.parse(__iter_next.applySyncPromise(undefined, [iteratorId]));\n              if (!result.ok) {\n                throw Object.assign(new Error(result.error.message), { name: result.error.name });\n              }\n              return { done: result.done, value: result.value };\n            },\n            async return(v) {\n              const result = JSON.parse(__iter_return.applySyncPromise(undefined, [iteratorId, JSON.stringify(v)]));\n              return { done: true, value: result.value };\n            },\n            async throw(e) {\n              const result = JSON.parse(__iter_throw.applySyncPromise(undefined, [iteratorId, JSON.stringify({ message: e.message, name: e.name })]));\n              if (!result.ok) {\n                throw Object.assign(new Error(result.error.message), { name: result.error.name });\n              }\n              return { done: result.done, value: result.value };\n            }\n          };\n        };\n      `);\n    }\n  }\n\n  return invokeCallbackRef;\n}\n\n/**\n * Create a module resolver function for local execution.\n */\nfunction createModuleResolver(\n  state: RuntimeState\n): (specifier: string, referrer: ivm.Module) => Promise<ivm.Module> {\n  return async (\n    specifier: string,\n    _referrer: ivm.Module\n  ): Promise<ivm.Module> => {\n    // Check cache first\n    const cached = state.moduleCache.get(specifier);\n    if (cached) return cached;\n\n    if (!state.moduleLoader) {\n      throw new Error(`No module loader registered. Cannot import: ${specifier}`);\n    }\n\n    // Invoke module loader to get source code\n    const code = await state.moduleLoader(specifier);\n\n    // Compile the module\n    const mod = await state.isolate.compileModule(code, {\n      filename: specifier,\n    });\n\n    // Cache before instantiation (for circular dependencies)\n    state.moduleCache.set(specifier, mod);\n\n    // Instantiate with recursive resolver\n    const resolver = createModuleResolver(state);\n    await mod.instantiate(state.context, resolver);\n\n    return mod;\n  };\n}\n\n/**\n * Convert FetchCallback to FetchOptions\n */\nfunction convertFetchCallback(callback?: FetchCallback): FetchOptions {\n  if (!callback) {\n    return {};\n  }\n  return {\n    onFetch: async (request: Request): Promise<Response> => {\n      // Wrap the result in a Promise to handle both sync and async callbacks\n      return Promise.resolve(callback(request));\n    },\n  };\n}\n\n/**\n * Create a fully configured isolated-vm runtime\n *\n * Sets up all WHATWG APIs: fetch, fs, console, crypto, encoding, timers\n *\n * @example\n * const runtime = await createRuntime({\n *   console: { log: (...args) => console.log(\"[isolate]\", ...args) },\n *   fetch: async (request) => fetch(request),\n * });\n *\n * await runtime.eval(`\n *   console.log(\"Hello from sandbox!\");\n *   const response = await fetch(\"https://example.com\");\n * `);\n *\n * await runtime.dispose();\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  // Create isolate with optional memory limit\n  const isolate = new ivm.Isolate({\n    memoryLimit: opts.memoryLimitMB,\n  });\n  const context = await isolate.createContext();\n\n  // Initialize state\n  const state: RuntimeState = {\n    isolate,\n    context,\n    handles: {},\n    moduleCache: new Map(),\n    moduleLoader: opts.moduleLoader,\n    customFunctions: opts.customFunctions,\n  };\n\n  // Setup all APIs in order\n  // Core must be first as it provides Blob, File, streams, URL, etc.\n  state.handles.core = await setupCore(context);\n\n  // Console\n  state.handles.console = await setupConsole(context, opts.console);\n\n  // Encoding (btoa/atob)\n  state.handles.encoding = await setupEncoding(context);\n\n  // Timers (setTimeout, setInterval)\n  state.handles.timers = await setupTimers(context);\n\n  // Path module\n  state.handles.path = await setupPath(context, { cwd: opts.cwd });\n\n  // Crypto (randomUUID, getRandomValues)\n  state.handles.crypto = await setupCrypto(context);\n\n  // Fetch API - convert callback to options\n  state.handles.fetch = await setupFetch(\n    context,\n    convertFetchCallback(opts.fetch)\n  );\n\n  // File system (only if handler provided)\n  if (opts.fs) {\n    state.handles.fs = await setupFs(context, opts.fs);\n  }\n\n  // Setup custom functions\n  if (opts.customFunctions) {\n    state.customFnInvokeRef = await setupCustomFunctions(\n      context,\n      opts.customFunctions\n    );\n  }\n\n  // Setup test environment (if enabled)\n  if (opts.testEnvironment) {\n    const testEnvOptions: TestEnvironmentOptions | undefined =\n      typeof opts.testEnvironment === \"object\" ? opts.testEnvironment : undefined;\n    state.handles.testEnvironment = await setupTestEnvironment(context, testEnvOptions);\n  }\n\n  // Setup playwright (if page provided) - AFTER test environment so expect can be extended\n  if (opts.playwright) {\n    // Determine event handler\n    // If console: true and we have a console handler, wrap onEvent to route browser logs\n    let eventCallback = opts.playwright.onEvent;\n\n    if (opts.playwright.console && opts.console?.onEntry) {\n      const originalCallback = eventCallback;\n      const consoleHandler = opts.console.onEntry;\n      eventCallback = (event) => {\n        // Call original callback if provided\n        if (originalCallback) {\n          originalCallback(event);\n        }\n        // Route browser console logs through console handler as browserOutput entry\n        if (event.type === \"browserConsoleLog\") {\n          consoleHandler({\n            type: \"browserOutput\",\n            level: event.level,\n            args: event.args,\n            timestamp: event.timestamp,\n          });\n        }\n      };\n    }\n\n    state.handles.playwright = await setupPlaywright(context, {\n      page: opts.playwright.page,\n      timeout: opts.playwright.timeout,\n      baseUrl: opts.playwright.baseUrl,\n      // Don't print directly if routing through console handler\n      console: opts.playwright.console && !opts.console?.onEntry,\n      onEvent: eventCallback,\n    });\n  }\n\n  // Create fetch handle wrapper\n  const fetchHandle: RuntimeFetchHandle = {\n    async dispatchRequest(request: Request, options?: DispatchRequestOptions): Promise<Response> {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      return state.handles.fetch.dispatchRequest(request, options);\n    },\n    getUpgradeRequest() {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      return state.handles.fetch.getUpgradeRequest();\n    },\n    dispatchWebSocketOpen(connectionId: string) {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      state.handles.fetch.dispatchWebSocketOpen(connectionId);\n    },\n    dispatchWebSocketMessage(connectionId: string, message: string | ArrayBuffer) {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      state.handles.fetch.dispatchWebSocketMessage(connectionId, message);\n    },\n    dispatchWebSocketClose(connectionId: string, code: number, reason: string) {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      state.handles.fetch.dispatchWebSocketClose(connectionId, code, reason);\n    },\n    dispatchWebSocketError(connectionId: string, error: Error) {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      state.handles.fetch.dispatchWebSocketError(connectionId, error);\n    },\n    onWebSocketCommand(callback: (cmd: WebSocketCommand) => void) {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      return state.handles.fetch.onWebSocketCommand(callback);\n    },\n    hasServeHandler() {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      return state.handles.fetch.hasServeHandler();\n    },\n    hasActiveConnections() {\n      if (!state.handles.fetch) {\n        throw new Error(\"Fetch handle not available\");\n      }\n      return state.handles.fetch.hasActiveConnections();\n    },\n  };\n\n  // Create timers handle wrapper\n  const timersHandle: RuntimeTimersHandle = {\n    clearAll() {\n      state.handles.timers?.clearAll();\n    },\n  };\n\n  // Create console handle wrapper\n  const consoleHandle: RuntimeConsoleHandle = {\n    reset() {\n      state.handles.console?.reset();\n    },\n    getTimers() {\n      return state.handles.console?.getTimers() ?? new Map();\n    },\n    getCounters() {\n      return state.handles.console?.getCounters() ?? new Map();\n    },\n    getGroupDepth() {\n      return state.handles.console?.getGroupDepth() ?? 0;\n    },\n  };\n\n  // Create test environment handle wrapper\n  const testEnvironmentHandle: RuntimeTestEnvironmentHandle = {\n    async runTests(_timeout?: number): Promise<RunResults> {\n      if (!state.handles.testEnvironment) {\n        throw new Error(\"Test environment not enabled. Set testEnvironment: true in createRuntime options.\");\n      }\n      // Note: timeout parameter reserved for future use\n      return runTestsInContext(state.context);\n    },\n    hasTests(): boolean {\n      if (!state.handles.testEnvironment) {\n        throw new Error(\"Test environment not enabled. Set testEnvironment: true in createRuntime options.\");\n      }\n      return hasTestsInContext(state.context);\n    },\n    getTestCount(): number {\n      if (!state.handles.testEnvironment) {\n        throw new Error(\"Test environment not enabled. Set testEnvironment: true in createRuntime options.\");\n      }\n      return getTestCountInContext(state.context);\n    },\n    reset() {\n      state.handles.testEnvironment?.dispose();\n    },\n  };\n\n  // Create playwright handle wrapper\n  const playwrightHandle: RuntimePlaywrightHandle = {\n    getCollectedData(): CollectedData {\n      if (!state.handles.playwright) {\n        throw new Error(\"Playwright not configured. Provide playwright.page in createRuntime options.\");\n      }\n      return {\n        browserConsoleLogs: state.handles.playwright.getBrowserConsoleLogs(),\n        networkRequests: state.handles.playwright.getNetworkRequests(),\n        networkResponses: state.handles.playwright.getNetworkResponses(),\n      };\n    },\n    clearCollectedData() {\n      state.handles.playwright?.clearCollected();\n    },\n  };\n\n  return {\n    id,\n\n    // Module handles\n    fetch: fetchHandle,\n    timers: timersHandle,\n    console: consoleHandle,\n    testEnvironment: testEnvironmentHandle,\n    playwright: playwrightHandle,\n\n    async eval(code: string, filenameOrOptions?: string | EvalOptions): Promise<void> {\n      // Parse options\n      const options = typeof filenameOrOptions === 'string'\n        ? { filename: filenameOrOptions }\n        : filenameOrOptions;\n\n      // Compile as ES module\n      const mod = await state.isolate.compileModule(code, {\n        filename: options?.filename ?? \"<eval>\",\n      });\n\n      // Instantiate with module resolver\n      const resolver = createModuleResolver(state);\n      await mod.instantiate(state.context, resolver);\n\n      // Evaluate the module with optional timeout\n      await mod.evaluate(options?.maxExecutionMs ? { timeout: options.maxExecutionMs } : undefined);\n    },\n\n    async dispose(): Promise<void> {\n      // Dispose custom function reference\n      if (state.customFnInvokeRef) {\n        state.customFnInvokeRef.release();\n      }\n\n      // Dispose all handles (in reverse order of setup)\n      state.handles.playwright?.dispose();\n      state.handles.testEnvironment?.dispose();\n      state.handles.fs?.dispose();\n      state.handles.fetch?.dispose();\n      state.handles.crypto?.dispose();\n      state.handles.path?.dispose();\n      state.handles.timers?.dispose();\n      state.handles.encoding?.dispose();\n      state.handles.console?.dispose();\n      state.handles.core?.dispose();\n\n      // Clear module cache\n      state.moduleCache.clear();\n\n      // Release context and dispose isolate\n      state.context.release();\n      state.isolate.dispose();\n    },\n  };\n}\n\n// Re-export all package types and functions\nexport { setupCore } from \"@ricsam/isolate-core\";\nexport type { CoreHandle, SetupCoreOptions } from \"@ricsam/isolate-core\";\n\nexport { setupConsole, simpleConsoleHandler } from \"@ricsam/isolate-console\";\nexport type { ConsoleHandle, ConsoleOptions, ConsoleEntry as ConsoleEntryFromConsole, SimpleConsoleCallbacks } from \"@ricsam/isolate-console\";\n\nexport { setupCrypto } from \"@ricsam/isolate-crypto\";\nexport type { CryptoHandle } from \"@ricsam/isolate-crypto\";\n\nexport { setupEncoding } from \"@ricsam/isolate-encoding\";\nexport type { EncodingHandle } from \"@ricsam/isolate-encoding\";\n\nexport { setupFetch } from \"@ricsam/isolate-fetch\";\nexport type { FetchHandle, FetchOptions, WebSocketCommand, UpgradeRequest } from \"@ricsam/isolate-fetch\";\n\nexport { setupFs, createNodeFileSystemHandler } from \"@ricsam/isolate-fs\";\nexport type { FsHandle, FsOptions, FileSystemHandler, NodeFileSystemHandlerOptions } from \"@ricsam/isolate-fs\";\n\nexport { setupPath } from \"@ricsam/isolate-path\";\nexport type { PathHandle, PathOptions } from \"@ricsam/isolate-path\";\n\nexport { setupTimers } from \"@ricsam/isolate-timers\";\nexport type { TimersHandle } from \"@ricsam/isolate-timers\";\n\nexport { setupTestEnvironment, runTests, hasTests, getTestCount } from \"@ricsam/isolate-test-environment\";\nexport type {\n  TestEnvironmentHandle,\n  TestEnvironmentOptions,\n  RunResults,\n  TestResult,\n  TestInfo,\n  TestError,\n  TestEvent,\n  SuiteInfo,\n  SuiteResult,\n} from \"@ricsam/isolate-test-environment\";\n\nexport { setupPlaywright, createPlaywrightHandler } from \"@ricsam/isolate-playwright\";\nexport type {\n  PlaywrightHandle,\n  PlaywrightSetupOptions,\n  PlaywrightCallback,\n  PlaywrightEvent,\n  NetworkRequestInfo,\n  NetworkResponseInfo,\n  BrowserConsoleLogEntry,\n} from \"@ricsam/isolate-playwright\";\n\nexport * from './internal.mjs';"
   ],
-  "mappings": ";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAqIA,sBAAS;AAGT,yBAAS;AAGT,wBAAS;AAGT,0BAAS;AAGT,uBAAS;AAGT,oBAAS;AAGT,sBAAS;AAGT,wBAAS;AAjGT,eAAsB,aAAa,CACjC,SACwB;AAAA,EACxB,MAAM,OAAO,WAAW,CAAC;AAAA,EAGzB,MAAM,UAAU,IAAI,IAAI,QAAQ;AAAA,IAC9B,aAAa,KAAK;AAAA,EACpB,CAAC;AAAA,EACD,MAAM,UAAU,MAAM,QAAQ,cAAc;AAAA,EAG5C,MAAM,UASF,CAAC;AAAA,EAIL,QAAQ,OAAO,MAAM,UAAU,OAAO;AAAA,EAGtC,QAAQ,UAAU,MAAM,aAAa,SAAS,KAAK,OAAO;AAAA,EAG1D,QAAQ,WAAW,MAAM,cAAc,OAAO;AAAA,EAG9C,QAAQ,SAAS,MAAM,YAAY,OAAO;AAAA,EAG1C,QAAQ,OAAO,MAAM,UAAU,OAAO;AAAA,EAGtC,QAAQ,SAAS,MAAM,YAAY,OAAO;AAAA,EAG1C,QAAQ,QAAQ,MAAM,WAAW,SAAS,KAAK,KAAK;AAAA,EAGpD,IAAI,KAAK,IAAI;AAAA,IACX,QAAQ,KAAK,MAAM,QAAQ,SAAS,KAAK,EAAE;AAAA,EAC7C;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,QAAQ;AAAA,SACT,KAAI,CAAC,IAAa;AAAA,MACtB,MAAM,QAAQ,OAAQ,KAAK,EAAE;AAAA;AAAA,IAE/B,OAAO,GAAG;AAAA,MAER,QAAQ,IAAI,QAAQ;AAAA,MACpB,QAAQ,OAAO,QAAQ;AAAA,MACvB,QAAQ,QAAQ,QAAQ;AAAA,MACxB,QAAQ,MAAM,QAAQ;AAAA,MACtB,QAAQ,QAAQ,QAAQ;AAAA,MACxB,QAAQ,UAAU,QAAQ;AAAA,MAC1B,QAAQ,SAAS,QAAQ;AAAA,MACzB,QAAQ,MAAM,QAAQ;AAAA,MAGtB,QAAQ,QAAQ;AAAA,MAChB,QAAQ,QAAQ;AAAA;AAAA,EAEpB;AAAA;",
-  "debugId": "FDBFD94222E0044364756E2164756E21",
+  "mappings": "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",
+  "debugId": "727908D2ABC724D264756E2164756E21",
   "names": []
 }

package/dist/mjs/internal.mjs

@@ -0,0 +1,53 @@
+// @bun
+// packages/runtime/src/internal.ts
+import ivm from "isolated-vm";
+import { setupCore } from "@ricsam/isolate-core";
+import { setupConsole } from "@ricsam/isolate-console";
+import { setupEncoding } from "@ricsam/isolate-encoding";
+import { setupTimers } from "@ricsam/isolate-timers";
+import { setupPath } from "@ricsam/isolate-path";
+import { setupCrypto } from "@ricsam/isolate-crypto";
+import { setupFetch } from "@ricsam/isolate-fetch";
+import { setupFs } from "@ricsam/isolate-fs";
+async function createInternalRuntime(options) {
+  const opts = options ?? {};
+  const isolate = new ivm.Isolate({
+    memoryLimit: opts.memoryLimitMB
+  });
+  const context = await isolate.createContext();
+  const handles = {};
+  handles.core = await setupCore(context);
+  handles.console = await setupConsole(context, opts.console);
+  handles.encoding = await setupEncoding(context);
+  handles.timers = await setupTimers(context);
+  handles.path = await setupPath(context, { cwd: opts.cwd });
+  handles.crypto = await setupCrypto(context);
+  handles.fetch = await setupFetch(context, opts.fetch);
+  if (opts.fs) {
+    handles.fs = await setupFs(context, opts.fs);
+  }
+  return {
+    isolate,
+    context,
+    fetch: handles.fetch,
+    timers: handles.timers,
+    console: handles.console,
+    dispose() {
+      handles.fs?.dispose();
+      handles.fetch?.dispose();
+      handles.crypto?.dispose();
+      handles.path?.dispose();
+      handles.timers?.dispose();
+      handles.encoding?.dispose();
+      handles.console?.dispose();
+      handles.core?.dispose();
+      context.release();
+      isolate.dispose();
+    }
+  };
+}
+export {
+  createInternalRuntime
+};
+
+//# debugId=BAB9B34244E5F7FC64756E2164756E21

package/dist/mjs/internal.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/internal.ts"],
+  "sourcesContent": [
+    "/**\n * Internal APIs for @ricsam/isolate-runtime\n *\n * These are not part of the public API and may change without notice.\n * Only used by @ricsam/isolate-daemon internally.\n */\n\nimport ivm from \"isolated-vm\";\nimport { setupCore } from \"@ricsam/isolate-core\";\nimport { setupConsole } from \"@ricsam/isolate-console\";\nimport { setupEncoding } from \"@ricsam/isolate-encoding\";\nimport { setupTimers } from \"@ricsam/isolate-timers\";\nimport { setupPath } from \"@ricsam/isolate-path\";\nimport { setupCrypto } from \"@ricsam/isolate-crypto\";\nimport { setupFetch } from \"@ricsam/isolate-fetch\";\nimport { setupFs } from \"@ricsam/isolate-fs\";\n\nimport type { ConsoleOptions, ConsoleHandle } from \"@ricsam/isolate-console\";\nimport type { FetchOptions, FetchHandle } from \"@ricsam/isolate-fetch\";\nimport type { FsOptions, FsHandle } from \"@ricsam/isolate-fs\";\nimport type { CoreHandle } from \"@ricsam/isolate-core\";\nimport type { EncodingHandle } from \"@ricsam/isolate-encoding\";\nimport type { TimersHandle } from \"@ricsam/isolate-timers\";\nimport type { PathHandle } from \"@ricsam/isolate-path\";\nimport type { CryptoHandle } from \"@ricsam/isolate-crypto\";\n\n/**\n * @internal Options for creating a legacy runtime.\n */\nexport interface InternalRuntimeOptions {\n  memoryLimitMB?: number;\n  console?: ConsoleOptions;\n  fetch?: FetchOptions;\n  fs?: FsOptions;\n  /** Current working directory for path.resolve(). Defaults to \"/\" */\n  cwd?: string;\n}\n\n/**\n * @internal Runtime handle with direct isolate/context access.\n * Used by isolate-daemon for low-level operations.\n */\nexport interface InternalRuntimeHandle {\n  readonly isolate: ivm.Isolate;\n  readonly context: ivm.Context;\n  readonly fetch: FetchHandle;\n  readonly timers: TimersHandle;\n  readonly console: ConsoleHandle;\n  dispose(): void;\n}\n\n/**\n * @internal Create a runtime with direct access to isolate and context.\n * This is for internal use by @ricsam/isolate-daemon only.\n */\nexport async function createInternalRuntime(\n  options?: InternalRuntimeOptions\n): Promise<InternalRuntimeHandle> {\n  const opts = options ?? {};\n\n  const isolate = new ivm.Isolate({\n    memoryLimit: opts.memoryLimitMB,\n  });\n\n  const context = await isolate.createContext();\n\n  // Setup all APIs\n  const handles: {\n    core?: CoreHandle;\n    console?: ConsoleHandle;\n    encoding?: EncodingHandle;\n    timers?: TimersHandle;\n    path?: PathHandle;\n    crypto?: CryptoHandle;\n    fetch?: FetchHandle;\n    fs?: FsHandle;\n  } = {};\n\n  handles.core = await setupCore(context);\n  handles.console = await setupConsole(context, opts.console);\n  handles.encoding = await setupEncoding(context);\n  handles.timers = await setupTimers(context);\n  handles.path = await setupPath(context, { cwd: opts.cwd });\n  handles.crypto = await setupCrypto(context);\n  handles.fetch = await setupFetch(context, opts.fetch);\n\n  if (opts.fs) {\n    handles.fs = await setupFs(context, opts.fs);\n  }\n\n  return {\n    isolate,\n    context,\n    fetch: handles.fetch,\n    timers: handles.timers!,\n    console: handles.console!,\n    dispose() {\n      handles.fs?.dispose();\n      handles.fetch?.dispose();\n      handles.crypto?.dispose();\n      handles.path?.dispose();\n      handles.timers?.dispose();\n      handles.encoding?.dispose();\n      handles.console?.dispose();\n      handles.core?.dispose();\n      context.release();\n      isolate.dispose();\n    },\n  };\n}\n"
+  ],
+  "mappings": ";;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAwCA,eAAsB,qBAAqB,CACzC,SACgC;AAAA,EAChC,MAAM,OAAO,WAAW,CAAC;AAAA,EAEzB,MAAM,UAAU,IAAI,IAAI,QAAQ;AAAA,IAC9B,aAAa,KAAK;AAAA,EACpB,CAAC;AAAA,EAED,MAAM,UAAU,MAAM,QAAQ,cAAc;AAAA,EAG5C,MAAM,UASF,CAAC;AAAA,EAEL,QAAQ,OAAO,MAAM,UAAU,OAAO;AAAA,EACtC,QAAQ,UAAU,MAAM,aAAa,SAAS,KAAK,OAAO;AAAA,EAC1D,QAAQ,WAAW,MAAM,cAAc,OAAO;AAAA,EAC9C,QAAQ,SAAS,MAAM,YAAY,OAAO;AAAA,EAC1C,QAAQ,OAAO,MAAM,UAAU,SAAS,EAAE,KAAK,KAAK,IAAI,CAAC;AAAA,EACzD,QAAQ,SAAS,MAAM,YAAY,OAAO;AAAA,EAC1C,QAAQ,QAAQ,MAAM,WAAW,SAAS,KAAK,KAAK;AAAA,EAEpD,IAAI,KAAK,IAAI;AAAA,IACX,QAAQ,KAAK,MAAM,QAAQ,SAAS,KAAK,EAAE;AAAA,EAC7C;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,QAAQ;AAAA,IACf,QAAQ,QAAQ;AAAA,IAChB,SAAS,QAAQ;AAAA,IACjB,OAAO,GAAG;AAAA,MACR,QAAQ,IAAI,QAAQ;AAAA,MACpB,QAAQ,OAAO,QAAQ;AAAA,MACvB,QAAQ,QAAQ,QAAQ;AAAA,MACxB,QAAQ,MAAM,QAAQ;AAAA,MACtB,QAAQ,QAAQ,QAAQ;AAAA,MACxB,QAAQ,UAAU,QAAQ;AAAA,MAC1B,QAAQ,SAAS,QAAQ;AAAA,MACzB,QAAQ,MAAM,QAAQ;AAAA,MACtB,QAAQ,QAAQ;AAAA,MAChB,QAAQ,QAAQ;AAAA;AAAA,EAEpB;AAAA;",
+  "debugId": "BAB9B34244E5F7FC64756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/isolate-runtime",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "type": "module"
 }

package/dist/types/index.d.ts

@@ -1,28 +1,155 @@
-import ivm from "isolated-vm";
-import type { ConsoleOptions } from "@ricsam/isolate-console";
-import type { FetchOptions, FetchHandle } from "@ricsam/isolate-fetch";
+import type { DispatchRequestOptions, UpgradeRequest, WebSocketCommand } from "@ricsam/isolate-fetch";
 import type { FsOptions } from "@ricsam/isolate-fs";
+import type { RunResults, TestEnvironmentOptions } from "@ricsam/isolate-test-environment";
+import type { NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, PlaywrightEvent } from "@ricsam/isolate-playwright";
+import type { ConsoleCallbacks, FetchCallback, ModuleLoaderCallback, CustomFunctions } from "@ricsam/isolate-protocol";
+export type { ConsoleCallbacks, ConsoleEntry, FetchCallback, ModuleLoaderCallback, CustomFunction, CustomFunctionDefinition, CustomFunctions, DispatchOptions, } from "@ricsam/isolate-protocol";
+/**
+ * Options for creating a runtime.
+ */
 export interface RuntimeOptions {
-    /** Isolate memory limit in MB */
-    memoryLimit?: number;
-    /** Console options */
-    console?: ConsoleOptions;
-    /** Fetch options */
-    fetch?: FetchOptions;
-    /** File system options (optional - fs only set up if provided) */
+    /** Memory limit in megabytes (optional) */
+    memoryLimitMB?: number;
+    /** Console callback handlers */
+    console?: ConsoleCallbacks;
+    /** Fetch callback handler */
+    fetch?: FetchCallback;
+    /**
+     * File system options.
+     * Note: For local runtime, this uses FsOptions with getDirectory returning a FileSystemHandler.
+     * For remote runtime (isolate-client), use FileSystemCallbacks instead.
+     */
     fs?: FsOptions;
+    /** Module loader callback for resolving dynamic imports */
+    moduleLoader?: ModuleLoaderCallback;
+    /** Custom functions callable from within the isolate */
+    customFunctions?: CustomFunctions;
+    /** Current working directory for path.resolve(). Defaults to "/" */
+    cwd?: string;
+    /** Enable test environment (describe, it, expect, etc.) */
+    testEnvironment?: boolean | TestEnvironmentOptions;
+    /** Playwright options - user provides page object */
+    playwright?: PlaywrightOptions;
+}
+/**
+ * Options for playwright in local runtime.
+ */
+export interface PlaywrightOptions {
+    /** Playwright Page object - user launches browser and creates page */
+    page: import("playwright").Page;
+    /** Default timeout for operations (default: 30000ms) */
+    timeout?: number;
+    /** Base URL for relative navigation */
+    baseUrl?: string;
+    /** If true, browser console logs are routed through console handler (or printed to stdout if no handler) */
+    console?: boolean;
+    /** Unified event callback for all playwright events */
+    onEvent?: (event: PlaywrightEvent) => void;
+}
+/**
+ * Runtime fetch handle - provides access to fetch/serve operations.
+ */
+export interface RuntimeFetchHandle {
+    /** Dispatch HTTP request to serve() handler */
+    dispatchRequest(request: Request, options?: DispatchRequestOptions): Promise<Response>;
+    /** Check if isolate requested WebSocket upgrade */
+    getUpgradeRequest(): UpgradeRequest | null;
+    /** Dispatch WebSocket open event to isolate */
+    dispatchWebSocketOpen(connectionId: string): void;
+    /** Dispatch WebSocket message event to isolate */
+    dispatchWebSocketMessage(connectionId: string, message: string | ArrayBuffer): void;
+    /** Dispatch WebSocket close event to isolate */
+    dispatchWebSocketClose(connectionId: string, code: number, reason: string): void;
+    /** Dispatch WebSocket error event to isolate */
+    dispatchWebSocketError(connectionId: string, error: Error): void;
+    /** Register callback for WebSocket commands from isolate */
+    onWebSocketCommand(callback: (cmd: WebSocketCommand) => void): () => void;
+    /** Check if serve() has been called */
+    hasServeHandler(): boolean;
+    /** Check if there are active WebSocket connections */
+    hasActiveConnections(): boolean;
+}
+/**
+ * Runtime timers handle - provides access to timer operations.
+ * Timers fire automatically based on real time.
+ */
+export interface RuntimeTimersHandle {
+    /** Clear all pending timers */
+    clearAll(): void;
+}
+/**
+ * Runtime console handle - provides access to console state.
+ */
+export interface RuntimeConsoleHandle {
+    /** Reset all console state (timers, counters, group depth) */
+    reset(): void;
+    /** Get console.time() timers */
+    getTimers(): Map<string, number>;
+    /** Get console.count() counters */
+    getCounters(): Map<string, number>;
+    /** Get current console.group() nesting depth */
+    getGroupDepth(): number;
 }
+/**
+ * Runtime test environment handle - provides access to test execution.
+ */
+export interface RuntimeTestEnvironmentHandle {
+    /** Run all registered tests */
+    runTests(timeout?: number): Promise<RunResults>;
+    /** Check if any tests are registered */
+    hasTests(): boolean;
+    /** Get count of registered tests */
+    getTestCount(): number;
+    /** Reset test state */
+    reset(): void;
+}
+/**
+ * Runtime playwright handle - provides access to browser data collection.
+ */
+export interface RuntimePlaywrightHandle {
+    /** Get collected browser data (console logs, network requests/responses) */
+    getCollectedData(): CollectedData;
+    /** Clear collected browser data */
+    clearCollectedData(): void;
+}
+/**
+ * Collected browser data from playwright.
+ */
+export interface CollectedData {
+    /** Browser console logs (from the page, not sandbox) */
+    browserConsoleLogs: BrowserConsoleLogEntry[];
+    networkRequests: NetworkRequestInfo[];
+    networkResponses: NetworkResponseInfo[];
+}
+/**
+ * Options for eval() method.
+ */
+export interface EvalOptions {
+    /** Filename for stack traces */
+    filename?: string;
+    /** Maximum execution time in milliseconds. If exceeded, throws a timeout error. */
+    maxExecutionMs?: number;
+}
+/**
+ * Runtime handle - the main interface for interacting with the isolate.
+ */
 export interface RuntimeHandle {
-    /** The isolate instance */
-    readonly isolate: ivm.Isolate;
-    /** The context instance */
-    readonly context: ivm.Context;
-    /** The fetch handle for serve() and WebSocket dispatching */
-    readonly fetch: FetchHandle;
-    /** Process pending timers */
-    tick(ms?: number): Promise<void>;
+    /** Unique runtime identifier */
+    readonly id: string;
+    /** Execute code as ES module (supports top-level await) */
+    eval(code: string, filenameOrOptions?: string | EvalOptions): Promise<void>;
     /** Dispose all resources */
-    dispose(): void;
+    dispose(): Promise<void>;
+    /** Fetch handle - access to fetch/serve operations */
+    readonly fetch: RuntimeFetchHandle;
+    /** Timers handle - access to timer operations */
+    readonly timers: RuntimeTimersHandle;
+    /** Console handle - access to console state */
+    readonly console: RuntimeConsoleHandle;
+    /** Test environment handle - access to test execution (throws if not enabled) */
+    readonly testEnvironment: RuntimeTestEnvironmentHandle;
+    /** Playwright handle - access to playwright operations (throws if not configured) */
+    readonly playwright: RuntimePlaywrightHandle;
 }
 /**
  * Create a fully configured isolated-vm runtime
@@ -31,26 +158,22 @@ export interface RuntimeHandle {
  *
  * @example
  * const runtime = await createRuntime({
- *   console: {
- *     onLog: (level, ...args) => console.log(`[${level}]`, ...args)
- *   },
- *   fetch: {
- *     onFetch: async (request) => fetch(request)
- *   }
+ *   console: { log: (...args) => console.log("[isolate]", ...args) },
+ *   fetch: async (request) => fetch(request),
  * });
  *
- * await runtime.context.eval(`
+ * await runtime.eval(`
  *   console.log("Hello from sandbox!");
  *   const response = await fetch("https://example.com");
  * `);
  *
- * runtime.dispose();
+ * await runtime.dispose();
  */
 export declare function createRuntime(options?: RuntimeOptions): Promise<RuntimeHandle>;
 export { setupCore } from "@ricsam/isolate-core";
 export type { CoreHandle, SetupCoreOptions } from "@ricsam/isolate-core";
-export { setupConsole } from "@ricsam/isolate-console";
-export type { ConsoleHandle, ConsoleOptions } from "@ricsam/isolate-console";
+export { setupConsole, simpleConsoleHandler } from "@ricsam/isolate-console";
+export type { ConsoleHandle, ConsoleOptions, ConsoleEntry as ConsoleEntryFromConsole, SimpleConsoleCallbacks } from "@ricsam/isolate-console";
 export { setupCrypto } from "@ricsam/isolate-crypto";
 export type { CryptoHandle } from "@ricsam/isolate-crypto";
 export { setupEncoding } from "@ricsam/isolate-encoding";
@@ -60,6 +183,11 @@ export type { FetchHandle, FetchOptions, WebSocketCommand, UpgradeRequest } from
 export { setupFs, createNodeFileSystemHandler } from "@ricsam/isolate-fs";
 export type { FsHandle, FsOptions, FileSystemHandler, NodeFileSystemHandlerOptions } from "@ricsam/isolate-fs";
 export { setupPath } from "@ricsam/isolate-path";
-export type { PathHandle } from "@ricsam/isolate-path";
+export type { PathHandle, PathOptions } from "@ricsam/isolate-path";
 export { setupTimers } from "@ricsam/isolate-timers";
 export type { TimersHandle } from "@ricsam/isolate-timers";
+export { setupTestEnvironment, runTests, hasTests, getTestCount } from "@ricsam/isolate-test-environment";
+export type { TestEnvironmentHandle, TestEnvironmentOptions, RunResults, TestResult, TestInfo, TestError, TestEvent, SuiteInfo, SuiteResult, } from "@ricsam/isolate-test-environment";
+export { setupPlaywright, createPlaywrightHandler } from "@ricsam/isolate-playwright";
+export type { PlaywrightHandle, PlaywrightSetupOptions, PlaywrightCallback, PlaywrightEvent, NetworkRequestInfo, NetworkResponseInfo, BrowserConsoleLogEntry, } from "@ricsam/isolate-playwright";
+export * from './internal.ts';

package/dist/types/internal.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Internal APIs for @ricsam/isolate-runtime
+ *
+ * These are not part of the public API and may change without notice.
+ * Only used by @ricsam/isolate-daemon internally.
+ */
+import ivm from "isolated-vm";
+import type { ConsoleOptions, ConsoleHandle } from "@ricsam/isolate-console";
+import type { FetchOptions, FetchHandle } from "@ricsam/isolate-fetch";
+import type { FsOptions } from "@ricsam/isolate-fs";
+import type { TimersHandle } from "@ricsam/isolate-timers";
+/**
+ * @internal Options for creating a legacy runtime.
+ */
+export interface InternalRuntimeOptions {
+    memoryLimitMB?: number;
+    console?: ConsoleOptions;
+    fetch?: FetchOptions;
+    fs?: FsOptions;
+    /** Current working directory for path.resolve(). Defaults to "/" */
+    cwd?: string;
+}
+/**
+ * @internal Runtime handle with direct isolate/context access.
+ * Used by isolate-daemon for low-level operations.
+ */
+export interface InternalRuntimeHandle {
+    readonly isolate: ivm.Isolate;
+    readonly context: ivm.Context;
+    readonly fetch: FetchHandle;
+    readonly timers: TimersHandle;
+    readonly console: ConsoleHandle;
+    dispose(): void;
+}
+/**
+ * @internal Create a runtime with direct access to isolate and context.
+ * This is for internal use by @ricsam/isolate-daemon only.
+ */
+export declare function createInternalRuntime(options?: InternalRuntimeOptions): Promise<InternalRuntimeHandle>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/isolate-runtime",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {
@@ -22,11 +22,21 @@
     "@ricsam/isolate-encoding": "*",
     "@ricsam/isolate-fetch": "*",
     "@ricsam/isolate-fs": "*",
+    "@ricsam/isolate-path": "*",
+    "@ricsam/isolate-playwright": "*",
+    "@ricsam/isolate-protocol": "*",
+    "@ricsam/isolate-test-environment": "*",
     "@ricsam/isolate-timers": "*",
     "isolated-vm": "^6"
   },
   "peerDependencies": {
-    "isolated-vm": "^6"
+    "isolated-vm": "^6",
+    "playwright": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
   },
   "author": "Richard Samuelsson",
   "license": "MIT",