@ricsam/quickjs-test-utils 1.0.16 → 1.0.18

package/README.md

@@ -73,7 +73,8 @@ import {
   CORE_TYPES,   // ReadableStream, Blob, File, URL, etc.
   FETCH_TYPES,  // fetch, Request, Response, serve, etc.
   FS_TYPES,     // fs.getDirectory, FileSystemHandle, etc.
-  TYPE_DEFINITIONS  // All types as { core, fetch, fs }
+  CRYPTO_TYPES, // crypto.subtle, CryptoKey, etc.
+  TYPE_DEFINITIONS  // All types as { core, fetch, fs, crypto, ... }
 } from "@ricsam/quickjs-test-utils";
 
 // Use with your own ts-morph project
@@ -93,7 +94,8 @@ Each package also exports `.d.ts` files for use with `tsconfig.json`:
   "references": [
     { "path": "./node_modules/@ricsam/quickjs-core/src/quickjs.d.ts" },
     { "path": "./node_modules/@ricsam/quickjs-fetch/src/quickjs.d.ts" },
-    { "path": "./node_modules/@ricsam/quickjs-fs/src/quickjs.d.ts" }
+    { "path": "./node_modules/@ricsam/quickjs-fs/src/quickjs.d.ts" },
+    { "path": "./node_modules/@ricsam/quickjs-crypto/src/quickjs.d.ts" }
   ]
 }
 ```

package/dist/cjs/integration-server.cjs

@@ -36,6 +36,7 @@ module.exports = __toCommonJS(exports_integration_server);
 var import_quickjs_emscripten = require("quickjs-emscripten");
 var import_quickjs_fetch = require("@ricsam/quickjs-fetch");
 var import_quickjs_core = require("@ricsam/quickjs-core");
+var import_quickjs_console = require("@ricsam/quickjs-console");
 async function startIntegrationServer(quickJSCode, options) {
   const QuickJS = await import_quickjs_emscripten.getQuickJS();
   const runtime = QuickJS.newRuntime();
@@ -45,6 +46,7 @@ async function startIntegrationServer(quickJSCode, options) {
     coreHandle,
     onFetch: options?.onFetch
   });
+  const consoleHandle = options?.consoleHandlers ? import_quickjs_console.setupConsole(context, { handlers: options.consoleHandlers, coreHandle }) : undefined;
   const wsConnections = new Map;
   fetchHandle.onWebSocketCommand((cmd) => {
     const ws = wsConnections.get(cmd.connectionId);
@@ -118,6 +120,7 @@ async function startIntegrationServer(quickJSCode, options) {
     context,
     runtime,
     coreHandle,
+    consoleHandle,
     async stop() {
       for (const ws of wsConnections.values()) {
         ws.close(1000, "Server stopping");
@@ -125,6 +128,7 @@ async function startIntegrationServer(quickJSCode, options) {
       wsConnections.clear();
       server.stop(true);
       fetchHandle.dispose();
+      consoleHandle?.dispose();
       coreHandle.dispose();
       context.dispose();
       runtime.dispose();
@@ -133,4 +137,4 @@ async function startIntegrationServer(quickJSCode, options) {
 }
 })
 
-//# debugId=C6A40A02405DC16F64756E2164756E21
+//# debugId=815B5672C4B716AE64756E2164756E21

package/dist/cjs/integration-server.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/integration-server.ts"],
   "sourcesContent": [
-    "import { getQuickJS, type QuickJSContext, type QuickJSRuntime } from \"quickjs-emscripten\";\nimport { setupFetch, type FetchHandle, type WebSocketCommand, type SetupFetchOptions } from \"@ricsam/quickjs-fetch\";\nimport { setupCore, type CoreHandle } from \"@ricsam/quickjs-core\";\nimport type { Server, ServerWebSocket } from \"bun\";\n\ninterface WsData {\n  connectionId: string;\n}\n\nexport interface IntegrationTestServer {\n  baseURL: string;\n  wsURL: string;\n  port: number;\n  fetchHandle: FetchHandle;\n  context: QuickJSContext;\n  runtime: QuickJSRuntime;\n  coreHandle: CoreHandle;\n  stop(): Promise<void>;\n}\n\nexport interface StartIntegrationServerOptions {\n  /** Handler for outbound fetch() calls from QuickJS */\n  onFetch?: SetupFetchOptions[\"onFetch\"];\n}\n\n/**\n * Start a real HTTP server that dispatches requests to a QuickJS serve() handler.\n *\n * @param quickJSCode - JavaScript code to run in QuickJS, should call serve()\n * @param options - Optional configuration\n * @returns Server info including baseURL, wsURL, and stop function\n *\n * @example\n * const server = await startIntegrationServer(`\n *   serve({\n *     fetch(request) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `);\n *\n * const response = await fetch(\\`\\${server.baseURL}/test\\`);\n * expect(await response.text()).toBe(\"Hello!\");\n *\n * await server.stop();\n */\nexport async function startIntegrationServer(\n  quickJSCode: string,\n  options?: StartIntegrationServerOptions\n): Promise<IntegrationTestServer> {\n  const QuickJS = await getQuickJS();\n  const runtime = QuickJS.newRuntime();\n  const context = runtime.newContext();\n\n  // Setup core and fetch APIs\n  const coreHandle = setupCore(context);\n  const fetchHandle = setupFetch(context, {\n    coreHandle,\n    onFetch: options?.onFetch,\n  });\n\n  // Track WebSocket connections\n  const wsConnections = new Map<string, ServerWebSocket<WsData>>();\n\n  // Handle outgoing WebSocket commands from QuickJS\n  fetchHandle.onWebSocketCommand((cmd: WebSocketCommand) => {\n    const ws = wsConnections.get(cmd.connectionId);\n    if (!ws) return;\n\n    if (cmd.type === \"message\") {\n      ws.send(cmd.data);\n    } else if (cmd.type === \"close\") {\n      ws.close(cmd.code, cmd.reason);\n    }\n  });\n\n  // Run the user's QuickJS code\n  const result = context.evalCode(quickJSCode);\n  if (result.error) {\n    const error = context.dump(result.error);\n    result.error.dispose();\n    fetchHandle.dispose();\n    coreHandle.dispose();\n    context.dispose();\n    runtime.dispose();\n    throw new Error(`Failed to evaluate QuickJS code: ${JSON.stringify(error)}`);\n  }\n  result.value.dispose();\n\n  // Start Bun server with port 0 for dynamic assignment\n  const server: Server<WsData> = Bun.serve<WsData>({\n    port: 0,\n    async fetch(req, server) {\n      try {\n        // Dispatch to QuickJS handler\n        const response = await fetchHandle.dispatchRequest(req);\n\n        // Check if QuickJS requested a WebSocket upgrade\n        const upgrade = fetchHandle.getUpgradeRequest();\n        if (upgrade?.requested) {\n          // The connectionId is generated by QuickJS in server.upgrade()\n          // User data is stored in QuickJS registry - we just pass the connectionId\n          const success = server.upgrade(req, {\n            data: { connectionId: upgrade.connectionId },\n          });\n          if (success) {\n            return undefined;\n          }\n          return new Response(\"WebSocket upgrade failed\", { status: 500 });\n        }\n\n        return response;\n      } catch (error) {\n        console.error(\"Integration test request failed:\", error);\n        return new Response(\"Internal Server Error\", { status: 500 });\n      }\n    },\n    websocket: {\n      open(ws) {\n        const { connectionId } = ws.data;\n        wsConnections.set(connectionId, ws);\n        // User data is looked up from QuickJS registry using connectionId\n        fetchHandle.dispatchWebSocketOpen(connectionId);\n      },\n      message(ws, message) {\n        const msg = typeof message === \"string\" ? message : message.buffer;\n        fetchHandle.dispatchWebSocketMessage(ws.data.connectionId, msg as string | ArrayBuffer);\n      },\n      close(ws, code, reason) {\n        fetchHandle.dispatchWebSocketClose(ws.data.connectionId, code, reason);\n        wsConnections.delete(ws.data.connectionId);\n      },\n    },\n  });\n\n  const port = server.port;\n  if (port === undefined) {\n    throw new Error(\"Server failed to get port\");\n  }\n  const baseURL = `http://localhost:${port}`;\n  const wsURL = `ws://localhost:${port}`;\n\n  return {\n    baseURL,\n    wsURL,\n    port,\n    fetchHandle,\n    context,\n    runtime,\n    coreHandle,\n    async stop() {\n      // Close all WebSocket connections\n      for (const ws of wsConnections.values()) {\n        ws.close(1000, \"Server stopping\");\n      }\n      wsConnections.clear();\n\n      // Stop the server\n      server.stop(true);\n\n      // Dispose QuickJS resources\n      fetchHandle.dispose();\n      coreHandle.dispose();\n      context.dispose();\n      runtime.dispose();\n    },\n  };\n}\n"
+    "import { getQuickJS, type QuickJSContext, type QuickJSRuntime } from \"quickjs-emscripten\";\nimport { setupFetch, type FetchHandle, type WebSocketCommand, type SetupFetchOptions } from \"@ricsam/quickjs-fetch\";\nimport { setupCore, type CoreHandle } from \"@ricsam/quickjs-core\";\nimport type { Server, ServerWebSocket } from \"bun\";\nimport { setupConsole, type ConsoleOutputHandler, type ConsoleHandle } from \"@ricsam/quickjs-console\";\n\ninterface WsData {\n  connectionId: string;\n}\n\nexport interface IntegrationTestServer {\n  baseURL: string;\n  wsURL: string;\n  port: number;\n  fetchHandle: FetchHandle;\n  context: QuickJSContext;\n  runtime: QuickJSRuntime;\n  coreHandle: CoreHandle;\n  consoleHandle?: ConsoleHandle;\n  stop(): Promise<void>;\n}\n\nexport interface StartIntegrationServerOptions {\n  /** Handler for outbound fetch() calls from QuickJS */\n  onFetch?: SetupFetchOptions[\"onFetch\"];\n  /** Handlers for console output from QuickJS */\n  consoleHandlers?: ConsoleOutputHandler;\n}\n\n/**\n * Start a real HTTP server that dispatches requests to a QuickJS serve() handler.\n *\n * @param quickJSCode - JavaScript code to run in QuickJS, should call serve()\n * @param options - Optional configuration\n * @returns Server info including baseURL, wsURL, and stop function\n *\n * @example\n * const server = await startIntegrationServer(`\n *   serve({\n *     fetch(request) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `);\n *\n * const response = await fetch(\\`\\${server.baseURL}/test\\`);\n * expect(await response.text()).toBe(\"Hello!\");\n *\n * await server.stop();\n */\nexport async function startIntegrationServer(\n  quickJSCode: string,\n  options?: StartIntegrationServerOptions\n): Promise<IntegrationTestServer> {\n  const QuickJS = await getQuickJS();\n  const runtime = QuickJS.newRuntime();\n  const context = runtime.newContext();\n\n  // Setup core and fetch APIs\n  const coreHandle = setupCore(context);\n  const fetchHandle = setupFetch(context, {\n    coreHandle,\n    onFetch: options?.onFetch,\n  });\n\n  // Setup console if handlers provided\n  const consoleHandle = options?.consoleHandlers\n    ? setupConsole(context, { handlers: options.consoleHandlers, coreHandle })\n    : undefined;\n\n  // Track WebSocket connections\n  const wsConnections = new Map<string, ServerWebSocket<WsData>>();\n\n  // Handle outgoing WebSocket commands from QuickJS\n  fetchHandle.onWebSocketCommand((cmd: WebSocketCommand) => {\n    const ws = wsConnections.get(cmd.connectionId);\n    if (!ws) return;\n\n    if (cmd.type === \"message\") {\n      ws.send(cmd.data);\n    } else if (cmd.type === \"close\") {\n      ws.close(cmd.code, cmd.reason);\n    }\n  });\n\n  // Run the user's QuickJS code\n  const result = context.evalCode(quickJSCode);\n  if (result.error) {\n    const error = context.dump(result.error);\n    result.error.dispose();\n    fetchHandle.dispose();\n    coreHandle.dispose();\n    context.dispose();\n    runtime.dispose();\n    throw new Error(`Failed to evaluate QuickJS code: ${JSON.stringify(error)}`);\n  }\n  result.value.dispose();\n\n  // Start Bun server with port 0 for dynamic assignment\n  const server: Server<WsData> = Bun.serve<WsData>({\n    port: 0,\n    async fetch(req, server) {\n      try {\n        // Dispatch to QuickJS handler\n        const response = await fetchHandle.dispatchRequest(req);\n\n        // Check if QuickJS requested a WebSocket upgrade\n        const upgrade = fetchHandle.getUpgradeRequest();\n        if (upgrade?.requested) {\n          // The connectionId is generated by QuickJS in server.upgrade()\n          // User data is stored in QuickJS registry - we just pass the connectionId\n          const success = server.upgrade(req, {\n            data: { connectionId: upgrade.connectionId },\n          });\n          if (success) {\n            return undefined;\n          }\n          return new Response(\"WebSocket upgrade failed\", { status: 500 });\n        }\n\n        return response;\n      } catch (error) {\n        console.error(\"Integration test request failed:\", error);\n        return new Response(\"Internal Server Error\", { status: 500 });\n      }\n    },\n    websocket: {\n      open(ws) {\n        const { connectionId } = ws.data;\n        wsConnections.set(connectionId, ws);\n        // User data is looked up from QuickJS registry using connectionId\n        fetchHandle.dispatchWebSocketOpen(connectionId);\n      },\n      message(ws, message) {\n        const msg = typeof message === \"string\" ? message : message.buffer;\n        fetchHandle.dispatchWebSocketMessage(ws.data.connectionId, msg as string | ArrayBuffer);\n      },\n      close(ws, code, reason) {\n        fetchHandle.dispatchWebSocketClose(ws.data.connectionId, code, reason);\n        wsConnections.delete(ws.data.connectionId);\n      },\n    },\n  });\n\n  const port = server.port;\n  if (port === undefined) {\n    throw new Error(\"Server failed to get port\");\n  }\n  const baseURL = `http://localhost:${port}`;\n  const wsURL = `ws://localhost:${port}`;\n\n  return {\n    baseURL,\n    wsURL,\n    port,\n    fetchHandle,\n    context,\n    runtime,\n    coreHandle,\n    consoleHandle,\n    async stop() {\n      // Close all WebSocket connections\n      for (const ws of wsConnections.values()) {\n        ws.close(1000, \"Server stopping\");\n      }\n      wsConnections.clear();\n\n      // Stop the server\n      server.stop(true);\n\n      // Dispose QuickJS resources\n      fetchHandle.dispose();\n      consoleHandle?.dispose();\n      coreHandle.dispose();\n      context.dispose();\n      runtime.dispose();\n    },\n  };\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "C6A40A02405DC16F64756E2164756E21",
+  "mappings": "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",
+  "debugId": "815B5672C4B716AE64756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-test-utils",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "type": "commonjs"
 }

package/dist/cjs/quickjs-types.cjs

@@ -36,6 +36,7 @@ __export(exports_quickjs_types, {
   FS_TYPES: () => FS_TYPES,
   FETCH_TYPES: () => FETCH_TYPES,
   ENCODING_TYPES: () => ENCODING_TYPES,
+  CRYPTO_TYPES: () => CRYPTO_TYPES,
   CORE_TYPES: () => CORE_TYPES,
   CONSOLE_TYPES: () => CONSOLE_TYPES
 });
@@ -1168,6 +1169,294 @@ declare global {
   function btoa(stringToEncode: string): string;
 }
 `;
+var CRYPTO_TYPES = `/**
+ * QuickJS Global Type Definitions for @ricsam/quickjs-crypto
+ *
+ * These types define the globals injected by setupCrypto() into a QuickJS context.
+ * Use these types to typecheck user code that will run inside QuickJS.
+ *
+ * @example
+ * // Generate random bytes
+ * const arr = new Uint8Array(16);
+ * crypto.getRandomValues(arr);
+ *
+ * // Generate UUID
+ * const uuid = crypto.randomUUID();
+ *
+ * // Use SubtleCrypto
+ * const key = await crypto.subtle.generateKey(
+ *   { name: "AES-GCM", length: 256 },
+ *   true,
+ *   ["encrypt", "decrypt"]
+ * );
+ */
+
+export {};
+
+declare global {
+  /**
+   * CryptoKey represents a cryptographic key.
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/CryptoKey
+   */
+  interface CryptoKey {
+    /**
+     * The type of key: "public", "private", or "secret".
+     */
+    readonly type: "public" | "private" | "secret";
+
+    /**
+     * Whether the key can be exported.
+     */
+    readonly extractable: boolean;
+
+    /**
+     * The algorithm used by this key.
+     */
+    readonly algorithm: KeyAlgorithm;
+
+    /**
+     * The usages allowed for this key.
+     */
+    readonly usages: ReadonlyArray<KeyUsage>;
+  }
+
+  /**
+   * CryptoKey constructor (keys cannot be constructed directly).
+   */
+  const CryptoKey: {
+    prototype: CryptoKey;
+  };
+
+  /**
+   * SubtleCrypto interface for cryptographic operations.
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto
+   */
+  interface SubtleCrypto {
+    /**
+     * Generate a digest (hash) of the given data.
+     *
+     * @param algorithm - Hash algorithm (e.g., "SHA-256", "SHA-384", "SHA-512")
+     * @param data - Data to hash
+     * @returns Promise resolving to the hash as ArrayBuffer
+     */
+    digest(
+      algorithm: AlgorithmIdentifier,
+      data: BufferSource
+    ): Promise<ArrayBuffer>;
+
+    /**
+     * Generate a new cryptographic key or key pair.
+     *
+     * @param algorithm - Key generation algorithm
+     * @param extractable - Whether the key can be exported
+     * @param keyUsages - Allowed key usages
+     * @returns Promise resolving to a CryptoKey or CryptoKeyPair
+     */
+    generateKey(
+      algorithm: RsaHashedKeyGenParams | EcKeyGenParams | AesKeyGenParams | HmacKeyGenParams,
+      extractable: boolean,
+      keyUsages: KeyUsage[]
+    ): Promise<CryptoKey | CryptoKeyPair>;
+
+    /**
+     * Sign data using a private key.
+     *
+     * @param algorithm - Signing algorithm
+     * @param key - Private key to sign with
+     * @param data - Data to sign
+     * @returns Promise resolving to the signature as ArrayBuffer
+     */
+    sign(
+      algorithm: AlgorithmIdentifier,
+      key: CryptoKey,
+      data: BufferSource
+    ): Promise<ArrayBuffer>;
+
+    /**
+     * Verify a signature.
+     *
+     * @param algorithm - Signing algorithm
+     * @param key - Public key to verify with
+     * @param signature - Signature to verify
+     * @param data - Data that was signed
+     * @returns Promise resolving to true if valid, false otherwise
+     */
+    verify(
+      algorithm: AlgorithmIdentifier,
+      key: CryptoKey,
+      signature: BufferSource,
+      data: BufferSource
+    ): Promise<boolean>;
+
+    /**
+     * Encrypt data.
+     *
+     * @param algorithm - Encryption algorithm
+     * @param key - Encryption key
+     * @param data - Data to encrypt
+     * @returns Promise resolving to encrypted data as ArrayBuffer
+     */
+    encrypt(
+      algorithm: AlgorithmIdentifier,
+      key: CryptoKey,
+      data: BufferSource
+    ): Promise<ArrayBuffer>;
+
+    /**
+     * Decrypt data.
+     *
+     * @param algorithm - Decryption algorithm
+     * @param key - Decryption key
+     * @param data - Data to decrypt
+     * @returns Promise resolving to decrypted data as ArrayBuffer
+     */
+    decrypt(
+      algorithm: AlgorithmIdentifier,
+      key: CryptoKey,
+      data: BufferSource
+    ): Promise<ArrayBuffer>;
+
+    /**
+     * Import a key from external data.
+     *
+     * @param format - Key format ("raw", "pkcs8", "spki", "jwk")
+     * @param keyData - Key data
+     * @param algorithm - Key algorithm
+     * @param extractable - Whether the key can be exported
+     * @param keyUsages - Allowed key usages
+     * @returns Promise resolving to a CryptoKey
+     */
+    importKey(
+      format: "raw" | "pkcs8" | "spki" | "jwk",
+      keyData: BufferSource | JsonWebKey,
+      algorithm: AlgorithmIdentifier,
+      extractable: boolean,
+      keyUsages: KeyUsage[]
+    ): Promise<CryptoKey>;
+
+    /**
+     * Export a key.
+     *
+     * @param format - Export format ("raw", "pkcs8", "spki", "jwk")
+     * @param key - Key to export
+     * @returns Promise resolving to ArrayBuffer or JsonWebKey
+     */
+    exportKey(
+      format: "raw" | "pkcs8" | "spki" | "jwk",
+      key: CryptoKey
+    ): Promise<ArrayBuffer | JsonWebKey>;
+
+    /**
+     * Derive bits from a key.
+     *
+     * @param algorithm - Derivation algorithm
+     * @param baseKey - Base key for derivation
+     * @param length - Number of bits to derive
+     * @returns Promise resolving to derived bits as ArrayBuffer
+     */
+    deriveBits(
+      algorithm: AlgorithmIdentifier,
+      baseKey: CryptoKey,
+      length: number
+    ): Promise<ArrayBuffer>;
+
+    /**
+     * Derive a new key from a base key.
+     *
+     * @param algorithm - Derivation algorithm
+     * @param baseKey - Base key for derivation
+     * @param derivedKeyType - Type of key to derive
+     * @param extractable - Whether the derived key can be exported
+     * @param keyUsages - Allowed usages for derived key
+     * @returns Promise resolving to a CryptoKey
+     */
+    deriveKey(
+      algorithm: AlgorithmIdentifier,
+      baseKey: CryptoKey,
+      derivedKeyType: AlgorithmIdentifier,
+      extractable: boolean,
+      keyUsages: KeyUsage[]
+    ): Promise<CryptoKey>;
+
+    /**
+     * Wrap a key for secure export.
+     *
+     * @param format - Key format
+     * @param key - Key to wrap
+     * @param wrappingKey - Key to wrap with
+     * @param wrapAlgorithm - Wrapping algorithm
+     * @returns Promise resolving to wrapped key as ArrayBuffer
+     */
+    wrapKey(
+      format: "raw" | "pkcs8" | "spki" | "jwk",
+      key: CryptoKey,
+      wrappingKey: CryptoKey,
+      wrapAlgorithm: AlgorithmIdentifier
+    ): Promise<ArrayBuffer>;
+
+    /**
+     * Unwrap a wrapped key.
+     *
+     * @param format - Key format
+     * @param wrappedKey - Wrapped key data
+     * @param unwrappingKey - Key to unwrap with
+     * @param unwrapAlgorithm - Unwrapping algorithm
+     * @param unwrappedKeyAlgorithm - Algorithm for the unwrapped key
+     * @param extractable - Whether the unwrapped key can be exported
+     * @param keyUsages - Allowed usages for unwrapped key
+     * @returns Promise resolving to a CryptoKey
+     */
+    unwrapKey(
+      format: "raw" | "pkcs8" | "spki" | "jwk",
+      wrappedKey: BufferSource,
+      unwrappingKey: CryptoKey,
+      unwrapAlgorithm: AlgorithmIdentifier,
+      unwrappedKeyAlgorithm: AlgorithmIdentifier,
+      extractable: boolean,
+      keyUsages: KeyUsage[]
+    ): Promise<CryptoKey>;
+  }
+
+  /**
+   * Crypto interface providing cryptographic functionality.
+   * @see https://developer.mozilla.org/en-US/docs/Web/API/Crypto
+   */
+  interface Crypto {
+    /**
+     * SubtleCrypto interface for cryptographic operations.
+     */
+    readonly subtle: SubtleCrypto;
+
+    /**
+     * Fill a TypedArray with cryptographically random values.
+     *
+     * @param array - TypedArray to fill (max 65536 bytes)
+     * @returns The same array, filled with random values
+     *
+     * @example
+     * const arr = new Uint8Array(16);
+     * crypto.getRandomValues(arr);
+     */
+    getRandomValues<T extends ArrayBufferView | null>(array: T): T;
+
+    /**
+     * Generate a random UUID v4.
+     *
+     * @returns A random UUID string
+     *
+     * @example
+     * const uuid = crypto.randomUUID();
+     * // "550e8400-e29b-41d4-a716-446655440000"
+     */
+    randomUUID(): string;
+  }
+
+  /**
+   * Crypto object providing cryptographic functionality.
+   */
+  const crypto: Crypto;
+}
+`;
 var TIMERS_TYPES = `/**
  * QuickJS Global Type Definitions for @ricsam/quickjs-timers
  *
@@ -1252,6 +1541,7 @@ declare global {
 var TYPE_DEFINITIONS = {
   core: CORE_TYPES,
   console: CONSOLE_TYPES,
+  crypto: CRYPTO_TYPES,
   encoding: ENCODING_TYPES,
   fetch: FETCH_TYPES,
   fs: FS_TYPES,
@@ -1260,4 +1550,4 @@ var TYPE_DEFINITIONS = {
 };
 })
 
-//# debugId=D9337DFBBDE4C79F64756E2164756E21
+//# debugId=0BC014EC5A81951964756E2164756E21