@ricsam/quickjs-test-utils 0.0.1 → 1.0.1

package/dist/mjs/integration-server.mjs

@@ -0,0 +1,106 @@
+// @bun
+// packages/test-utils/src/integration-server.ts
+import { getQuickJS } from "quickjs-emscripten";
+import { setupFetch } from "@ricsam/quickjs-fetch";
+import { setupCore } from "@ricsam/quickjs-core";
+async function startIntegrationServer(quickJSCode, options) {
+  const QuickJS = await getQuickJS();
+  const runtime = QuickJS.newRuntime();
+  const context = runtime.newContext();
+  const coreHandle = setupCore(context);
+  const fetchHandle = setupFetch(context, {
+    coreHandle,
+    onFetch: options?.onFetch
+  });
+  const wsConnections = new Map;
+  fetchHandle.onWebSocketCommand((cmd) => {
+    const ws = wsConnections.get(cmd.connectionId);
+    if (!ws)
+      return;
+    if (cmd.type === "message") {
+      ws.send(cmd.data);
+    } else if (cmd.type === "close") {
+      ws.close(cmd.code, cmd.reason);
+    }
+  });
+  const result = context.evalCode(quickJSCode);
+  if (result.error) {
+    const error = context.dump(result.error);
+    result.error.dispose();
+    fetchHandle.dispose();
+    coreHandle.dispose();
+    context.dispose();
+    runtime.dispose();
+    throw new Error(`Failed to evaluate QuickJS code: ${JSON.stringify(error)}`);
+  }
+  result.value.dispose();
+  const server = Bun.serve({
+    port: 0,
+    async fetch(req, server2) {
+      try {
+        const response = await fetchHandle.dispatchRequest(req);
+        const upgrade = fetchHandle.getUpgradeRequest();
+        if (upgrade?.requested) {
+          const connectionId = crypto.randomUUID();
+          const success = server2.upgrade(req, {
+            data: { connectionId, userData: upgrade.data }
+          });
+          if (success) {
+            return;
+          }
+          return new Response("WebSocket upgrade failed", { status: 500 });
+        }
+        return response;
+      } catch (error) {
+        console.error("Integration test request failed:", error);
+        return new Response("Internal Server Error", { status: 500 });
+      }
+    },
+    websocket: {
+      open(ws) {
+        const { connectionId, userData } = ws.data;
+        wsConnections.set(connectionId, ws);
+        fetchHandle.dispatchWebSocketOpen(connectionId, userData);
+      },
+      message(ws, message) {
+        const msg = typeof message === "string" ? message : message.buffer;
+        fetchHandle.dispatchWebSocketMessage(ws.data.connectionId, msg);
+      },
+      close(ws, code, reason) {
+        fetchHandle.dispatchWebSocketClose(ws.data.connectionId, code, reason);
+        wsConnections.delete(ws.data.connectionId);
+      }
+    }
+  });
+  const port = server.port;
+  if (port === undefined) {
+    throw new Error("Server failed to get port");
+  }
+  const baseURL = `http://localhost:${port}`;
+  const wsURL = `ws://localhost:${port}`;
+  return {
+    baseURL,
+    wsURL,
+    port,
+    fetchHandle,
+    context,
+    runtime,
+    coreHandle,
+    async stop() {
+      for (const ws of wsConnections.values()) {
+        ws.close(1000, "Server stopping");
+      }
+      wsConnections.clear();
+      server.stop(true);
+      fetchHandle.dispose();
+      coreHandle.dispose();
+      context.dispose();
+      runtime.dispose();
+    }
+  };
+}
+export {
+  startIntegrationServer
+};
+
+//# debugId=1C6D168A9BCD814A64756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "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  userData: unknown;\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          const connectionId = crypto.randomUUID();\n          const success = server.upgrade(req, {\n            data: { connectionId, userData: upgrade.data },\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, userData } = ws.data;\n        wsConnections.set(connectionId, ws);\n        fetchHandle.dispatchWebSocketOpen(connectionId, userData);\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"
+  ],
+  "mappings": ";;AAAA;AACA;AACA;AA6CA,eAAsB,sBAAsB,CAC1C,aACA,SACgC;AAAA,EAChC,MAAM,UAAU,MAAM,WAAW;AAAA,EACjC,MAAM,UAAU,QAAQ,WAAW;AAAA,EACnC,MAAM,UAAU,QAAQ,WAAW;AAAA,EAGnC,MAAM,aAAa,UAAU,OAAO;AAAA,EACpC,MAAM,cAAc,WAAW,SAAS;AAAA,IACtC;AAAA,IACA,SAAS,SAAS;AAAA,EACpB,CAAC;AAAA,EAGD,MAAM,gBAAgB,IAAI;AAAA,EAG1B,YAAY,mBAAmB,CAAC,QAA0B;AAAA,IACxD,MAAM,KAAK,cAAc,IAAI,IAAI,YAAY;AAAA,IAC7C,IAAI,CAAC;AAAA,MAAI;AAAA,IAET,IAAI,IAAI,SAAS,WAAW;AAAA,MAC1B,GAAG,KAAK,IAAI,IAAI;AAAA,IAClB,EAAO,SAAI,IAAI,SAAS,SAAS;AAAA,MAC/B,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM;AAAA,IAC/B;AAAA,GACD;AAAA,EAGD,MAAM,SAAS,QAAQ,SAAS,WAAW;AAAA,EAC3C,IAAI,OAAO,OAAO;AAAA,IAChB,MAAM,QAAQ,QAAQ,KAAK,OAAO,KAAK;AAAA,IACvC,OAAO,MAAM,QAAQ;AAAA,IACrB,YAAY,QAAQ;AAAA,IACpB,WAAW,QAAQ;AAAA,IACnB,QAAQ,QAAQ;AAAA,IAChB,QAAQ,QAAQ;AAAA,IAChB,MAAM,IAAI,MAAM,oCAAoC,KAAK,UAAU,KAAK,GAAG;AAAA,EAC7E;AAAA,EACA,OAAO,MAAM,QAAQ;AAAA,EAGrB,MAAM,SAAyB,IAAI,MAAc;AAAA,IAC/C,MAAM;AAAA,SACA,MAAK,CAAC,KAAK,SAAQ;AAAA,MACvB,IAAI;AAAA,QAEF,MAAM,WAAW,MAAM,YAAY,gBAAgB,GAAG;AAAA,QAGtD,MAAM,UAAU,YAAY,kBAAkB;AAAA,QAC9C,IAAI,SAAS,WAAW;AAAA,UACtB,MAAM,eAAe,OAAO,WAAW;AAAA,UACvC,MAAM,UAAU,QAAO,QAAQ,KAAK;AAAA,YAClC,MAAM,EAAE,cAAc,UAAU,QAAQ,KAAK;AAAA,UAC/C,CAAC;AAAA,UACD,IAAI,SAAS;AAAA,YACX;AAAA,UACF;AAAA,UACA,OAAO,IAAI,SAAS,4BAA4B,EAAE,QAAQ,IAAI,CAAC;AAAA,QACjE;AAAA,QAEA,OAAO;AAAA,QACP,OAAO,OAAO;AAAA,QACd,QAAQ,MAAM,oCAAoC,KAAK;AAAA,QACvD,OAAO,IAAI,SAAS,yBAAyB,EAAE,QAAQ,IAAI,CAAC;AAAA;AAAA;AAAA,IAGhE,WAAW;AAAA,MACT,IAAI,CAAC,IAAI;AAAA,QACP,QAAQ,cAAc,aAAa,GAAG;AAAA,QACtC,cAAc,IAAI,cAAc,EAAE;AAAA,QAClC,YAAY,sBAAsB,cAAc,QAAQ;AAAA;AAAA,MAE1D,OAAO,CAAC,IAAI,SAAS;AAAA,QACnB,MAAM,MAAM,OAAO,YAAY,WAAW,UAAU,QAAQ;AAAA,QAC5D,YAAY,yBAAyB,GAAG,KAAK,cAAc,GAA2B;AAAA;AAAA,MAExF,KAAK,CAAC,IAAI,MAAM,QAAQ;AAAA,QACtB,YAAY,uBAAuB,GAAG,KAAK,cAAc,MAAM,MAAM;AAAA,QACrE,cAAc,OAAO,GAAG,KAAK,YAAY;AAAA;AAAA,IAE7C;AAAA,EACF,CAAC;AAAA,EAED,MAAM,OAAO,OAAO;AAAA,EACpB,IAAI,SAAS,WAAW;AAAA,IACtB,MAAM,IAAI,MAAM,2BAA2B;AAAA,EAC7C;AAAA,EACA,MAAM,UAAU,oBAAoB;AAAA,EACpC,MAAM,QAAQ,kBAAkB;AAAA,EAEhC,OAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,SACM,KAAI,GAAG;AAAA,MAEX,WAAW,MAAM,cAAc,OAAO,GAAG;AAAA,QACvC,GAAG,MAAM,MAAM,iBAAiB;AAAA,MAClC;AAAA,MACA,cAAc,MAAM;AAAA,MAGpB,OAAO,KAAK,IAAI;AAAA,MAGhB,YAAY,QAAQ;AAAA,MACpB,WAAW,QAAQ;AAAA,MACnB,QAAQ,QAAQ;AAAA,MAChB,QAAQ,QAAQ;AAAA;AAAA,EAEpB;AAAA;",
+  "debugId": "1C6D168A9BCD814A64756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@ricsam/quickjs-test-utils",
+  "version": "1.0.1",
+  "type": "module"
+}