@ricsam/quickjs-runtime 0.2.20 → 0.2.21

package/dist/mjs/index.mjs.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.mjs\";\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": "3A1DE579F5C2FCF564756E2164756E21",
+  "mappings": ";;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AAAA;AAAA;AAeA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA;AAAA;AAAA;AAKA;AAAA;AAAA;AAKA;AAAA;AAAA;AAKA;AAAA;AAAA;AAKA;AAAA;AAAA;AAKA;AAAA;AAAA;AAkHO,SAAS,YAAY,CAC1B,SACA,UAA+B,CAAC,GACZ;AAAA,EACpB,MAAM,WAAW,eAAe;AAAA,EAGhC,MAAM,OAAO,UAAU,SAAS,EAAE,SAAS,CAAC;AAAA,EAE5C,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EAGJ,IAAI,QAAQ,OAAO;AAAA,IACjB,MAAM,eACJ,QAAQ,UAAU,OACd,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,OAAO,UAAU,YAAY,KAAK;AAAA,IAErD,QAAQ,WAAW,SAAS,YAAY;AAAA,EAC1C;AAAA,EAGA,IAAI,QAAQ,IAAI;AAAA,IACd,KAAK,QAAQ,SAAS;AAAA,SACjB,QAAQ;AAAA,MACX;AAAA,MACA,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAGA,IAAI,QAAQ,SAAS;AAAA,IACnB,MAAM,iBACJ,QAAQ,YAAY,OAChB,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,SAAS,UAAU,YAAY,KAAK;AAAA,IAEvD,gBAAgB,aAAa,SAAS,cAAc;AAAA,EACtD;AAAA,EAGA,IAAI,QAAQ,UAAU;AAAA,IACpB,MAAM,kBACJ,QAAQ,aAAa,OACjB,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,UAAU,UAAU,YAAY,KAAK;AAAA,IAExD,WAAW,cAAc,SAAS,eAAe;AAAA,EACnD;AAAA,EAGA,IAAI,QAAQ,QAAQ;AAAA,IAClB,MAAM,gBACJ,QAAQ,WAAW,OACf,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,QAAQ,UAAU,YAAY,KAAK;AAAA,IAEtD,SAAS,YAAY,SAAS,aAAa;AAAA,EAC7C;AAAA,EAGA,IAAI,QAAQ,QAAQ;AAAA,IAClB,MAAM,gBACJ,QAAQ,WAAW,OACf,EAAE,UAAU,YAAY,KAAK,IAC7B,KAAK,QAAQ,QAAQ,UAAU,YAAY,KAAK;AAAA,IAEtD,eAAe,YAAY,SAAS,aAAa;AAAA,EACnD;AAAA,EAEA,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,QACI,OAAO,GAAG;AAAA,MACZ,OAAO;AAAA;AAAA,IAET,gBAAgB,CAAC,gBAAgB,MAAe;AAAA,MAC9C,SAAS,IAAI,EAAG,IAAI,eAAe,KAAK;AAAA,QACtC,IAAI,CAAC,QAAQ,QAAQ,cAAc,GAAG;AAAA,UACpC,OAAO;AAAA,QACT;AAAA,QACA,MAAM,SAAS,QAAQ,QAAQ,mBAAmB;AAAA,QAClD,IAAI,OAAO,OAAO;AAAA,UAChB,OAAO,MAAM,QAAQ;AAAA,QACvB;AAAA,MACF;AAAA,MACA,OAAO,CAAC,QAAQ,QAAQ,cAAc;AAAA;AAAA,IAExC,OAAO,GAAG;AAAA,MAER,SAAS,IAAI,EAAG,IAAI,MAAM,KAAK;AAAA,QAC7B,IAAI,CAAC,QAAQ,QAAQ,cAAc;AAAA,UAAG;AAAA,QACtC,MAAM,SAAS,QAAQ,QAAQ,mBAAmB;AAAA,QAClD,IAAI,OAAO;AAAA,UAAO,OAAO,MAAM,QAAQ;AAAA,MACzC;AAAA,MAGA,cAAc,QAAQ;AAAA,MACtB,QAAQ,QAAQ;AAAA,MAChB,UAAU,QAAQ;AAAA,MAClB,eAAe,QAAQ;AAAA,MACvB,IAAI,QAAQ;AAAA,MACZ,OAAO,QAAQ;AAAA,MAIf,SAAS,IAAI,EAAG,IAAI,MAAM,KAAK;AAAA,QAC7B,IAAI,CAAC,QAAQ,QAAQ,cAAc;AAAA,UAAG;AAAA,QACtC,MAAM,SAAS,QAAQ,QAAQ,mBAAmB;AAAA,QAClD,IAAI,OAAO;AAAA,UAAO,OAAO,MAAM,QAAQ;AAAA,MACzC;AAAA,MAGA,0BAA0B,OAAO;AAAA,MACjC,sBAAsB;AAAA,MAGtB,IAAI;AAAA,QACF,MAAM,eAAe,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAarC;AAAA,QACD,IAAI,aAAa,OAAO;AAAA,UACtB,aAAa,MAAM,QAAQ;AAAA,QAC7B,EAAO;AAAA,UACL,aAAa,MAAM,QAAQ;AAAA;AAAA,QAE7B,OAAO,GAAG;AAAA,MAKZ,SAAS,IAAI,EAAG,IAAI,KAAK,KAAK;AAAA,QAC5B,IAAI,CAAC,QAAQ,QAAQ,cAAc;AAAA,UAAG;AAAA,QACtC,MAAM,SAAS,QAAQ,QAAQ,mBAAmB;AAAA,QAClD,IAAI,OAAO;AAAA,UAAO,OAAO,MAAM,QAAQ;AAAA,MACzC;AAAA,MAEA,KAAK,QAAQ;AAAA;AAAA,EAEjB;AAAA;",
+  "debugId": "B678E9E9303FA62664756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

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

package/dist/types/create-runtime.d.ts

@@ -0,0 +1,201 @@
+import { type SetupFsOptions } from "@ricsam/quickjs-fs";
+import { type ConsoleEntry, type ConsoleCallbacks } from "@ricsam/quickjs-console";
+import { type RunResults, type TestEvent } from "@ricsam/quickjs-test-environment";
+import { type PlaywrightOptions, type PlaywrightEvent, type BrowserConsoleLogEntry, type NetworkRequestInfo, type NetworkResponseInfo } from "@ricsam/quickjs-playwright";
+export type { ConsoleEntry, ConsoleCallbacks, TestEvent, PlaywrightEvent };
+/**
+ * Module loader callback type.
+ * Called when the runtime imports a module dynamically.
+ * Returns the JavaScript source code for the module.
+ */
+export type ModuleLoaderCallback = (moduleName: string) => string | Promise<string>;
+/**
+ * A custom function that can be called from within the runtime.
+ */
+export type CustomFunction = (...args: unknown[]) => unknown | Promise<unknown>;
+/**
+ * Custom function definition with metadata.
+ * Requires explicit `async` property to be clear about function behavior.
+ */
+export interface CustomFunctionDefinition {
+    /** The function implementation */
+    fn: CustomFunction;
+    /** Whether the function is async (returns a Promise) */
+    async: boolean;
+}
+/**
+ * Custom functions to register in the runtime.
+ * Each function must be defined with explicit async property.
+ *
+ * @example
+ * ```typescript
+ * customFunctions: {
+ *   // Async function
+ *   hashPassword: {
+ *     fn: async (password) => bcrypt.hash(password, 10),
+ *     async: true,
+ *   },
+ *   // Sync function
+ *   getConfig: {
+ *     fn: () => ({ environment: "production" }),
+ *     async: false,
+ *   },
+ * }
+ * ```
+ */
+export type CustomFunctions = Record<string, CustomFunctionDefinition>;
+/**
+ * Fetch callback type.
+ */
+export type FetchCallback = (request: Request) => Response | Promise<Response>;
+/**
+ * Test environment options.
+ */
+export interface TestEnvironmentOptions {
+    /** Event callback for test events */
+    onEvent?: (event: TestEvent) => void;
+    /** Default test timeout in milliseconds */
+    testTimeout?: number;
+}
+/**
+ * Options for creating a runtime.
+ */
+export interface RuntimeOptions {
+    /** Memory limit in bytes (optional) */
+    memoryLimit?: number;
+    /** Console callback handlers */
+    console?: ConsoleCallbacks;
+    /** Fetch callback handler */
+    fetch?: FetchCallback;
+    /** File system options */
+    fs?: SetupFsOptions;
+    /** Module loader callback for resolving dynamic imports */
+    moduleLoader?: ModuleLoaderCallback;
+    /** Custom functions callable from within the runtime */
+    customFunctions?: CustomFunctions;
+    /** Current working directory for path operations. Defaults to "/" */
+    cwd?: string;
+    /** Test environment options. Set to true for defaults, or provide options. */
+    testEnvironment?: boolean | TestEnvironmentOptions;
+    /** Playwright options for browser automation */
+    playwright?: PlaywrightOptions;
+}
+/**
+ * Runtime fetch handle - provides access to fetch/serve operations.
+ */
+export interface RuntimeFetchHandle {
+    /** Dispatch HTTP request to serve() handler */
+    dispatchRequest(request: Request, options?: {
+        timeout?: number;
+    }): Promise<Response>;
+    /** 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.
+ */
+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 operations.
+ */
+export interface RuntimeTestEnvironmentHandle {
+    /** Run all registered tests */
+    runTests(timeout?: number): Promise<RunResults>;
+    /** Check if any tests have been registered */
+    hasTests(): boolean;
+    /** Get the number of registered tests */
+    getTestCount(): number;
+    /** Reset test state (clear registered tests) */
+    reset(): void;
+}
+/**
+ * Collected playwright data.
+ */
+export interface CollectedData {
+    browserConsoleLogs: BrowserConsoleLogEntry[];
+    networkRequests: NetworkRequestInfo[];
+    networkResponses: NetworkResponseInfo[];
+}
+/**
+ * Runtime playwright handle - provides access to playwright data.
+ */
+export interface RuntimePlaywrightHandle {
+    /** Get collected browser logs and network data */
+    getCollectedData(): CollectedData;
+    /** Clear all collected data */
+    clearCollectedData(): void;
+}
+/**
+ * Runtime handle - the main interface for interacting with the runtime.
+ */
+export interface RuntimeHandle {
+    /** Unique runtime identifier */
+    readonly id: string;
+    /** Execute code as ES module (supports top-level await) */
+    eval(code: string, filename?: string): Promise<void>;
+    /** Dispose all resources */
+    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 operations */
+    readonly testEnvironment: RuntimeTestEnvironmentHandle;
+    /** Playwright handle - access to browser automation data */
+    readonly playwright: RuntimePlaywrightHandle;
+}
+/**
+ * Create a fully configured QuickJS runtime
+ *
+ * Sets up all WHATWG APIs: fetch, fs, console, crypto, encoding, timers.
+ * Supports ES modules with custom module loader and custom host functions.
+ *
+ * @example
+ * ```typescript
+ * const runtime = await createRuntime({
+ *   console: { onEntry: (e) => console.log("[sandbox]", e) },
+ *   fetch: async (request) => fetch(request),
+ *   moduleLoader: async (name) => {
+ *     if (name === "@/utils") {
+ *       return `export const add = (a, b) => a + b;`;
+ *     }
+ *     throw new Error(`Unknown module: ${name}`);
+ *   },
+ *   customFunctions: {
+ *     hashPassword: {
+ *       fn: async (pw) => Bun.password.hash(pw),
+ *       async: true,
+ *     },
+ *   },
+ * });
+ *
+ * await runtime.eval(`
+ *   import { add } from "@/utils";
+ *   const hash = await hashPassword("secret");
+ *   console.log(add(1, 2), hash);
+ * `);
+ *
+ * await runtime.dispose();
+ * ```
+ */
+export declare function createRuntime(options?: RuntimeOptions): Promise<RuntimeHandle>;

package/dist/types/index.d.ts

@@ -5,6 +5,7 @@ export * from "@ricsam/quickjs-encoding";
 export * from "@ricsam/quickjs-fetch";
 export * from "@ricsam/quickjs-fs";
 export * from "@ricsam/quickjs-timers";
+export { createRuntime, type RuntimeOptions, type RuntimeHandle, type RuntimeFetchHandle, type RuntimeTimersHandle, type RuntimeConsoleHandle, type ModuleLoaderCallback, type CustomFunction, type CustomFunctionDefinition, type CustomFunctions, type FetchCallback, } from "./create-runtime.ts";
 import type { QuickJSContext } from "quickjs-emscripten";
 import { type StateMap, type CoreHandle } from "@ricsam/quickjs-core";
 import { type SetupFetchOptions, type FetchHandle } from "@ricsam/quickjs-fetch";
@@ -56,9 +57,9 @@ export interface SetupRuntimeOptions {
     crypto?: SetupCryptoOptions | boolean;
 }
 /**
- * Handle returned from setupRuntime
+ * Handle returned from setupRuntime (low-level API)
  */
-export interface RuntimeHandle {
+export interface SetupRuntimeHandle {
     /** Core handle (always present) */
     core: CoreHandle;
     /** Fetch handle (if enabled) */
@@ -104,4 +105,4 @@ export interface RuntimeHandle {
  *
  * handle.dispose();
  */
-export declare function setupRuntime(context: QuickJSContext, options?: SetupRuntimeOptions): RuntimeHandle;
+export declare function setupRuntime(context: QuickJSContext, options?: SetupRuntimeOptions): SetupRuntimeHandle;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-runtime",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {
@@ -17,12 +17,14 @@
   },
   "dependencies": {
     "@ricsam/quickjs-core": "^0.2.16",
-    "@ricsam/quickjs-console": "^0.2.16",
+    "@ricsam/quickjs-console": "^0.2.17",
     "@ricsam/quickjs-crypto": "^0.2.16",
     "@ricsam/quickjs-encoding": "^0.2.16",
-    "@ricsam/quickjs-fetch": "^0.2.18",
+    "@ricsam/quickjs-fetch": "^0.2.19",
     "@ricsam/quickjs-fs": "^0.2.17",
     "@ricsam/quickjs-timers": "^0.2.16",
+    "@ricsam/quickjs-test-environment": "^0.2.17",
+    "@ricsam/quickjs-playwright": "^0.2.19",
     "quickjs-emscripten": "^0.31.0"
   },
   "peerDependencies": {