@effect-gql/node 0.1.0 → 1.1.0

package/README.md

@@ -0,0 +1,100 @@
+# Effect GraphQL
+
+A GraphQL framework for Effect-TS that brings full type safety, composability, and functional programming to your GraphQL servers.
+
+> **Note:** This is an experimental prototype exploring the integration between Effect Schema, Effect's service system, and GraphQL.
+
+## Features
+
+- **Type-Safe End-to-End** - Define schemas once with Effect Schema, get TypeScript types and GraphQL types automatically
+- **Effect-Powered Resolvers** - Resolvers are Effect programs with built-in error handling and service injection
+- **Immutable Builder** - Fluent, pipe-able API for composing schemas from reusable parts
+- **Service Integration** - Use Effect's Layer system for dependency injection
+
+## Installation
+
+```bash
+npm install @effect-gql/core effect graphql
+```
+
+## Quick Start
+
+```typescript
+import { Effect, Layer } from "effect"
+import * as S from "effect/Schema"
+import { GraphQLSchemaBuilder, execute } from "@effect-gql/core"
+
+// Define your schema with Effect Schema
+const UserSchema = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+})
+
+// Build your GraphQL schema
+const schema = GraphQLSchemaBuilder.empty
+  .objectType({ name: "User", schema: UserSchema })
+  .query("users", {
+    type: S.Array(UserSchema),
+    resolve: () => Effect.succeed([
+      { id: "1", name: "Alice", email: "alice@example.com" },
+      { id: "2", name: "Bob", email: "bob@example.com" },
+    ]),
+  })
+  .query("user", {
+    type: UserSchema,
+    args: S.Struct({ id: S.String }),
+    resolve: (args) => Effect.succeed({
+      id: args.id,
+      name: "Alice",
+      email: "alice@example.com",
+    }),
+  })
+  .buildSchema()
+
+// Execute a query
+const result = await Effect.runPromise(
+  execute(schema, Layer.empty)(`
+    query {
+      users { id name email }
+    }
+  `)
+)
+```
+
+## Documentation
+
+For full documentation, guides, and API reference, visit the [documentation site](https://nrf110.github.io/effect-gql/).
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Development mode with watch
+npm run dev
+```
+
+## Contributing
+
+Contributions are welcome! Here's how you can help:
+
+1. **Report bugs** - Open an issue describing the problem and steps to reproduce
+2. **Suggest features** - Open an issue describing your idea
+3. **Submit PRs** - Fork the repo, make your changes, and open a pull request
+
+Please ensure your code:
+- Passes all existing tests (`npm test`)
+- Includes tests for new functionality
+- Follows the existing code style
+
+## License
+
+MIT

package/index.cjs

@@ -0,0 +1,315 @@
+'use strict';
+
+var effect = require('effect');
+var ws = require('ws');
+var core = require('@effect-gql/core');
+var platform = require('@effect/platform');
+var platformNode = require('@effect/platform-node');
+var http = require('http');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/ws.ts
+var ws_exports = {};
+__export(ws_exports, {
+  attachWebSocketToServer: () => exports.attachWebSocketToServer,
+  createGraphQLWSServer: () => exports.createGraphQLWSServer,
+  toEffectWebSocket: () => exports.toEffectWebSocket
+});
+exports.toEffectWebSocket = void 0; exports.createGraphQLWSServer = void 0; exports.attachWebSocketToServer = void 0;
+var init_ws = __esm({
+  "src/ws.ts"() {
+    exports.toEffectWebSocket = (ws) => core.toEffectWebSocketFromWs(ws);
+    exports.createGraphQLWSServer = (schema, layer, options) => {
+      const wss = new ws.WebSocketServer({ noServer: true });
+      const path = options?.path ?? "/graphql";
+      const handler = core.makeGraphQLWSHandler(schema, layer, options);
+      const activeConnections = /* @__PURE__ */ new Set();
+      wss.on("connection", (ws, _request) => {
+        activeConnections.add(ws);
+        const effectSocket = exports.toEffectWebSocket(ws);
+        effect.Effect.runPromise(
+          handler(effectSocket).pipe(
+            effect.Effect.catchAll((error) => effect.Effect.logError("GraphQL WebSocket handler error", error))
+          )
+        ).finally(() => {
+          activeConnections.delete(ws);
+        });
+      });
+      const handleUpgrade = (request, socket, head) => {
+        const url = new URL(request.url ?? "/", `http://${request.headers.host}`);
+        if (url.pathname !== path) {
+          socket.destroy();
+          return;
+        }
+        const protocol = request.headers["sec-websocket-protocol"];
+        if (!protocol?.includes("graphql-transport-ws")) {
+          socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
+          socket.destroy();
+          return;
+        }
+        wss.handleUpgrade(request, socket, head, (ws) => {
+          wss.emit("connection", ws, request);
+        });
+      };
+      const close = async () => {
+        for (const ws of activeConnections) {
+          ws.close(1001, "Server shutting down");
+        }
+        activeConnections.clear();
+        return new Promise((resolve, reject) => {
+          wss.close((error) => {
+            if (error) reject(error);
+            else resolve();
+          });
+        });
+      };
+      return { wss, handleUpgrade, close };
+    };
+    exports.attachWebSocketToServer = (server, schema, layer, options) => {
+      const { handleUpgrade, close } = exports.createGraphQLWSServer(schema, layer, options);
+      server.on("upgrade", (request, socket, head) => {
+        handleUpgrade(request, socket, head);
+      });
+      return { close };
+    };
+  }
+});
+
+// src/http-utils.ts
+var toWebHeaders = (nodeHeaders) => {
+  const headers = new Headers();
+  for (const [key, value] of Object.entries(nodeHeaders)) {
+    if (value) {
+      if (Array.isArray(value)) {
+        value.forEach((v) => headers.append(key, v));
+      } else {
+        headers.set(key, value);
+      }
+    }
+  }
+  return headers;
+};
+
+// src/serve.ts
+var serve = (router, layer, options = {}) => {
+  const { port = 4e3, host = "0.0.0.0", onStart, subscriptions } = options;
+  if (subscriptions) {
+    serveWithSubscriptions(router, layer, port, host, subscriptions, onStart);
+  } else {
+    const app = router.pipe(
+      effect.Effect.catchAllCause((cause) => effect.Effect.die(cause)),
+      platform.HttpServer.serve()
+    );
+    const serverLayer = platformNode.NodeHttpServer.layer(() => http.createServer(), { port });
+    const fullLayer = effect.Layer.merge(serverLayer, layer);
+    if (onStart) {
+      onStart(`http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+    }
+    platformNode.NodeRuntime.runMain(effect.Layer.launch(effect.Layer.provide(app, fullLayer)));
+  }
+};
+function serveWithSubscriptions(router, layer, port, host, subscriptions, onStart) {
+  const importWs = effect.Effect.tryPromise({
+    try: () => Promise.resolve().then(() => (init_ws(), ws_exports)),
+    catch: (error) => error
+  });
+  effect.Effect.runPromise(
+    importWs.pipe(
+      effect.Effect.catchAll(
+        (error) => effect.Effect.logError("Failed to load WebSocket support", error).pipe(
+          effect.Effect.andThen(effect.Effect.logError("Make sure 'ws' package is installed: npm install ws")),
+          effect.Effect.andThen(effect.Effect.sync(() => process.exit(1))),
+          effect.Effect.andThen(effect.Effect.fail(error))
+        )
+      )
+    )
+  ).then(({ createGraphQLWSServer: createGraphQLWSServer2 }) => {
+    const { handler } = platform.HttpApp.toWebHandlerLayer(router, layer);
+    const httpServer = http.createServer(async (req, res) => {
+      try {
+        const chunks = [];
+        for await (const chunk of req) {
+          chunks.push(chunk);
+        }
+        const body = Buffer.concat(chunks).toString();
+        const baseUrl = `http://${host === "0.0.0.0" ? "localhost" : host}:${port}`;
+        const url = new URL(req.url || "/", baseUrl).href;
+        const headers = toWebHeaders(req.headers);
+        const webRequest = new Request(url, {
+          method: req.method,
+          headers,
+          body: ["GET", "HEAD"].includes(req.method) ? void 0 : body
+        });
+        const webResponse = await handler(webRequest);
+        res.statusCode = webResponse.status;
+        webResponse.headers.forEach((value, key) => {
+          res.setHeader(key, value);
+        });
+        const responseBody = await webResponse.text();
+        res.end(responseBody);
+      } catch (error) {
+        res.statusCode = 500;
+        res.end(JSON.stringify({ error: String(error) }));
+      }
+    });
+    const { handleUpgrade, close: closeWS } = createGraphQLWSServer2(
+      subscriptions.schema,
+      layer,
+      {
+        path: subscriptions.path,
+        complexity: subscriptions.complexity,
+        fieldComplexities: subscriptions.fieldComplexities,
+        onConnect: subscriptions.onConnect,
+        onDisconnect: subscriptions.onDisconnect,
+        onSubscribe: subscriptions.onSubscribe,
+        onComplete: subscriptions.onComplete,
+        onError: subscriptions.onError
+      }
+    );
+    httpServer.on("upgrade", (request, socket, head) => {
+      handleUpgrade(request, socket, head);
+    });
+    process.on("SIGINT", async () => {
+      await closeWS();
+      httpServer.close();
+      process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+      await closeWS();
+      httpServer.close();
+      process.exit(0);
+    });
+    httpServer.listen(port, host, () => {
+      if (onStart) {
+        onStart(`http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+      }
+    });
+  });
+}
+
+// src/index.ts
+init_ws();
+var createSSEHandler = (schema, layer, options) => {
+  const sseHandler = core.makeGraphQLSSEHandler(schema, layer, options);
+  return async (req, res) => {
+    const accept = req.headers.accept ?? "";
+    if (!accept.includes("text/event-stream") && !accept.includes("*/*")) {
+      res.statusCode = 406;
+      res.end(
+        JSON.stringify({
+          errors: [{ message: "Client must accept text/event-stream" }]
+        })
+      );
+      return;
+    }
+    let body;
+    try {
+      body = await readBody(req);
+    } catch {
+      res.statusCode = 400;
+      res.end(
+        JSON.stringify({
+          errors: [{ message: "Failed to read request body" }]
+        })
+      );
+      return;
+    }
+    let request;
+    try {
+      const parsed = JSON.parse(body);
+      if (typeof parsed.query !== "string") {
+        throw new Error("Missing query");
+      }
+      request = {
+        query: parsed.query,
+        variables: parsed.variables,
+        operationName: parsed.operationName,
+        extensions: parsed.extensions
+      };
+    } catch {
+      res.statusCode = 400;
+      res.end(
+        JSON.stringify({
+          errors: [{ message: "Invalid GraphQL request body" }]
+        })
+      );
+      return;
+    }
+    const headers = toWebHeaders(req.headers);
+    res.writeHead(200, core.SSE_HEADERS);
+    const eventStream = sseHandler(request, headers);
+    const streamEffect = effect.Effect.gen(function* () {
+      const clientDisconnected = yield* effect.Deferred.make();
+      req.on("close", () => {
+        effect.Effect.runPromise(effect.Deferred.succeed(clientDisconnected, void 0)).catch(() => {
+        });
+      });
+      req.on("error", (error) => {
+        effect.Effect.runPromise(effect.Deferred.fail(clientDisconnected, new core.SSEError({ cause: error }))).catch(
+          () => {
+          }
+        );
+      });
+      const runStream = effect.Stream.runForEach(
+        eventStream,
+        (event) => effect.Effect.async((resume) => {
+          const message = core.formatSSEMessage(event);
+          res.write(message, (error) => {
+            if (error) {
+              resume(effect.Effect.fail(new core.SSEError({ cause: error })));
+            } else {
+              resume(effect.Effect.succeed(void 0));
+            }
+          });
+        })
+      );
+      yield* effect.Effect.race(
+        runStream.pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning("SSE stream error", error))),
+        effect.Deferred.await(clientDisconnected)
+      );
+    });
+    await effect.Effect.runPromise(
+      streamEffect.pipe(
+        effect.Effect.ensuring(effect.Effect.sync(() => res.end())),
+        effect.Effect.catchAll(() => effect.Effect.void)
+      )
+    );
+  };
+};
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("end", () => resolve(Buffer.concat(chunks).toString()));
+    req.on("error", reject);
+  });
+}
+var createSSEServer = (schema, layer, options) => {
+  const path = options?.path ?? "/graphql/stream";
+  const handler = createSSEHandler(schema, layer, options);
+  return {
+    path,
+    shouldHandle: (req) => {
+      if (req.method !== "POST") return false;
+      const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+      return url.pathname === path;
+    },
+    handle: handler
+  };
+};
+
+exports.createSSEHandler = createSSEHandler;
+exports.createSSEServer = createSSEServer;
+exports.serve = serve;
+exports.toWebHeaders = toWebHeaders;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ws.ts","../src/http-utils.ts","../src/serve.ts","../src/index.ts","../src/sse.ts"],"names":["attachWebSocketToServer","createGraphQLWSServer","toEffectWebSocket","toEffectWebSocketFromWs","WebSocketServer","makeGraphQLWSHandler","Effect","HttpServer","NodeHttpServer","createServer","Layer","NodeRuntime","HttpApp","makeGraphQLSSEHandler","SSE_HEADERS","Deferred","SSEError","Stream","formatSSEMessage"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Effect, Layer } from \"effect\"\nimport type { IncomingMessage, Server } from \"node:http\"\nimport type { Duplex } from \"node:stream\"\nimport { WebSocket, WebSocketServer } from \"ws\"\nimport { GraphQLSchema } from \"graphql\"\nimport {\n  makeGraphQLWSHandler,\n  toEffectWebSocketFromWs,\n  type EffectWebSocket,\n  type GraphQLWSOptions,\n} from \"@effect-gql/core\"\n\n/**\n * Options for Node.js WebSocket server\n */\nexport interface NodeWSOptions<R> extends GraphQLWSOptions<R> {\n  /**\n   * Path for WebSocket connections.\n   * @default \"/graphql\"\n   */\n  readonly path?: string\n}\n\n/**\n * Convert a Node.js WebSocket (from 'ws' library) to an EffectWebSocket.\n *\n * This creates an Effect-based wrapper around the ws WebSocket instance,\n * providing a Stream for incoming messages and Effect-based send/close operations.\n *\n * @param ws - The WebSocket instance from the 'ws' library\n * @returns An EffectWebSocket that can be used with makeGraphQLWSHandler\n *\n * @example\n * ```typescript\n * wss.on(\"connection\", (ws, req) => {\n *   const effectSocket = toEffectWebSocket(ws)\n *   Effect.runPromise(handler(effectSocket))\n * })\n * ```\n */\nexport const toEffectWebSocket = (ws: WebSocket): EffectWebSocket => toEffectWebSocketFromWs(ws)\n\n/**\n * Create a WebSocket server that handles GraphQL subscriptions.\n *\n * This function creates a WebSocketServer and returns utilities for\n * integrating it with an HTTP server via the upgrade event.\n *\n * @param schema - The GraphQL schema with subscription definitions\n * @param layer - Effect layer providing services required by resolvers\n * @param options - Optional configuration and lifecycle hooks\n * @returns Object containing the WebSocketServer and handlers\n *\n * @example\n * ```typescript\n * const httpServer = createServer(requestHandler)\n * const { wss, handleUpgrade } = createGraphQLWSServer(schema, serviceLayer)\n *\n * httpServer.on(\"upgrade\", (request, socket, head) => {\n *   if (request.url === \"/graphql\") {\n *     handleUpgrade(request, socket, head)\n *   }\n * })\n *\n * httpServer.listen(4000)\n * ```\n */\nexport const createGraphQLWSServer = <R>(\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: NodeWSOptions<R>\n): {\n  /** The underlying WebSocketServer instance */\n  wss: WebSocketServer\n  /** Handle HTTP upgrade requests */\n  handleUpgrade: (request: IncomingMessage, socket: Duplex, head: Buffer) => void\n  /** Close the WebSocket server */\n  close: () => Promise<void>\n} => {\n  const wss = new WebSocketServer({ noServer: true })\n  const path = options?.path ?? \"/graphql\"\n\n  // Create the handler from core\n  const handler = makeGraphQLWSHandler(schema, layer, options)\n\n  // Track active connections for cleanup\n  const activeConnections = new Set<WebSocket>()\n\n  wss.on(\"connection\", (ws, _request) => {\n    activeConnections.add(ws)\n\n    const effectSocket = toEffectWebSocket(ws)\n\n    // Run the handler\n    Effect.runPromise(\n      handler(effectSocket).pipe(\n        Effect.catchAll((error) => Effect.logError(\"GraphQL WebSocket handler error\", error))\n      )\n    ).finally(() => {\n      activeConnections.delete(ws)\n    })\n  })\n\n  const handleUpgrade = (request: IncomingMessage, socket: Duplex, head: Buffer) => {\n    // Check if this is the GraphQL WebSocket path\n    const url = new URL(request.url ?? \"/\", `http://${request.headers.host}`)\n    if (url.pathname !== path) {\n      socket.destroy()\n      return\n    }\n\n    // Check for correct WebSocket subprotocol\n    const protocol = request.headers[\"sec-websocket-protocol\"]\n    if (!protocol?.includes(\"graphql-transport-ws\")) {\n      socket.write(\"HTTP/1.1 400 Bad Request\\r\\n\\r\\n\")\n      socket.destroy()\n      return\n    }\n\n    wss.handleUpgrade(request, socket, head, (ws) => {\n      wss.emit(\"connection\", ws, request)\n    })\n  }\n\n  const close = async () => {\n    // Close all active connections\n    for (const ws of activeConnections) {\n      ws.close(1001, \"Server shutting down\")\n    }\n    activeConnections.clear()\n\n    // Close the WebSocket server\n    return new Promise<void>((resolve, reject) => {\n      wss.close((error) => {\n        if (error) reject(error)\n        else resolve()\n      })\n    })\n  }\n\n  return { wss, handleUpgrade, close }\n}\n\n/**\n * Attach WebSocket subscription support to an existing HTTP server.\n *\n * This is a convenience function that creates a GraphQL WebSocket server\n * and attaches it to an HTTP server's upgrade event.\n *\n * @param server - The HTTP server to attach to\n * @param schema - The GraphQL schema with subscription definitions\n * @param layer - Effect layer providing services required by resolvers\n * @param options - Optional configuration and lifecycle hooks\n * @returns Cleanup function to close the WebSocket server\n *\n * @example\n * ```typescript\n * const httpServer = createServer(requestHandler)\n *\n * const cleanup = attachWebSocketToServer(httpServer, schema, serviceLayer, {\n *   path: \"/graphql\",\n * })\n *\n * httpServer.listen(4000)\n *\n * // Later, to cleanup:\n * await cleanup()\n * ```\n */\nexport const attachWebSocketToServer = <R>(\n  server: Server,\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: NodeWSOptions<R>\n): { close: () => Promise<void> } => {\n  const { handleUpgrade, close } = createGraphQLWSServer(schema, layer, options)\n\n  server.on(\"upgrade\", (request, socket, head) => {\n    handleUpgrade(request, socket as Duplex, head)\n  })\n\n  return { close }\n}\n","import type { IncomingHttpHeaders } from \"node:http\"\n\n/**\n * Convert Node.js IncomingHttpHeaders to web standard Headers.\n *\n * This handles the difference between Node.js headers (which can be\n * string | string[] | undefined) and web Headers (which are always strings).\n *\n * @param nodeHeaders - Headers from IncomingMessage.headers\n * @returns A web standard Headers object\n *\n * @example\n * ```typescript\n * import { toWebHeaders } from \"@effect-gql/node\"\n *\n * const webHeaders = toWebHeaders(req.headers)\n * const auth = webHeaders.get(\"authorization\")\n * ```\n */\nexport const toWebHeaders = (nodeHeaders: IncomingHttpHeaders): Headers => {\n  const headers = new Headers()\n  for (const [key, value] of Object.entries(nodeHeaders)) {\n    if (value) {\n      if (Array.isArray(value)) {\n        value.forEach((v) => headers.append(key, v))\n      } else {\n        headers.set(key, value)\n      }\n    }\n  }\n  return headers\n}\n","import { Effect, Layer } from \"effect\"\nimport { HttpApp, HttpRouter, HttpServer } from \"@effect/platform\"\nimport { NodeHttpServer, NodeRuntime } from \"@effect/platform-node\"\nimport { createServer } from \"node:http\"\nimport type { GraphQLSchema } from \"graphql\"\nimport type { GraphQLWSOptions } from \"@effect-gql/core\"\nimport { toWebHeaders } from \"./http-utils\"\n\n/**\n * Configuration for WebSocket subscriptions\n */\nexport interface SubscriptionsConfig<R> extends GraphQLWSOptions<R> {\n  /**\n   * The GraphQL schema (required for subscriptions).\n   * Must be the same schema used to create the router.\n   */\n  readonly schema: GraphQLSchema\n  /**\n   * Path for WebSocket connections.\n   * @default \"/graphql\"\n   */\n  readonly path?: string\n}\n\n/**\n * Options for the Node.js GraphQL server\n */\nexport interface ServeOptions<R = never> {\n  /** Port to listen on (default: 4000) */\n  readonly port?: number\n  /** Hostname to bind to (default: \"0.0.0.0\") */\n  readonly host?: string\n  /** Callback when server starts */\n  readonly onStart?: (url: string) => void\n  /**\n   * Enable WebSocket subscriptions.\n   * When provided, the server will handle WebSocket upgrade requests\n   * for GraphQL subscriptions using the graphql-ws protocol.\n   */\n  readonly subscriptions?: SubscriptionsConfig<R>\n}\n\n/**\n * Start a Node.js HTTP server with the given router.\n *\n * This is the main entry point for running a GraphQL server on Node.js.\n * It handles all the Effect runtime setup and server lifecycle.\n *\n * @param router - The HttpRouter to serve (typically from makeGraphQLRouter or toRouter)\n * @param layer - Layer providing the router's service dependencies\n * @param options - Server configuration options\n *\n * @example\n * ```typescript\n * import { makeGraphQLRouter } from \"@effect-gql/core\"\n * import { serve } from \"@effect-gql/node\"\n *\n * const schema = GraphQLSchemaBuilder.empty\n *   .query(\"hello\", { type: S.String, resolve: () => Effect.succeed(\"world\") })\n *   .buildSchema()\n *\n * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })\n *\n * // Without subscriptions\n * serve(router, serviceLayer, {\n *   port: 4000,\n *   onStart: (url) => console.log(`Server running at ${url}`)\n * })\n *\n * // With subscriptions\n * serve(router, serviceLayer, {\n *   port: 4000,\n *   subscriptions: { schema },\n *   onStart: (url) => console.log(`Server running at ${url}`)\n * })\n * ```\n */\nexport const serve = <E, R, RE>(\n  router: HttpRouter.HttpRouter<E, R>,\n  layer: Layer.Layer<R, RE>,\n  options: ServeOptions<R> = {}\n): void => {\n  const { port = 4000, host = \"0.0.0.0\", onStart, subscriptions } = options\n\n  if (subscriptions) {\n    // With WebSocket subscriptions - we need to manage the HTTP server ourselves\n    serveWithSubscriptions(router, layer, port, host, subscriptions, onStart)\n  } else {\n    // Without subscriptions - use the standard Effect approach\n    const app = router.pipe(\n      Effect.catchAllCause((cause) => Effect.die(cause)),\n      HttpServer.serve()\n    )\n\n    const serverLayer = NodeHttpServer.layer(() => createServer(), { port })\n    const fullLayer = Layer.merge(serverLayer, layer)\n\n    if (onStart) {\n      onStart(`http://${host === \"0.0.0.0\" ? \"localhost\" : host}:${port}`)\n    }\n\n    NodeRuntime.runMain(Layer.launch(Layer.provide(app, fullLayer)))\n  }\n}\n\n/**\n * Internal implementation for serving with WebSocket subscriptions.\n * Uses a custom HTTP server setup to enable WebSocket upgrade handling.\n */\nfunction serveWithSubscriptions<E, R, RE>(\n  router: HttpRouter.HttpRouter<E, R>,\n  layer: Layer.Layer<R, RE>,\n  port: number,\n  host: string,\n  subscriptions: SubscriptionsConfig<R>,\n  onStart?: (url: string) => void\n): void {\n  // Dynamically import ws module to keep it optional\n  const importWs = Effect.tryPromise({\n    try: () => import(\"./ws\"),\n    catch: (error) => error as Error,\n  })\n\n  Effect.runPromise(\n    importWs.pipe(\n      Effect.catchAll((error) =>\n        Effect.logError(\"Failed to load WebSocket support\", error).pipe(\n          Effect.andThen(Effect.logError(\"Make sure 'ws' package is installed: npm install ws\")),\n          Effect.andThen(Effect.sync(() => process.exit(1))),\n          Effect.andThen(Effect.fail(error))\n        )\n      )\n    )\n  ).then(({ createGraphQLWSServer }) => {\n    // Create the web handler from the Effect router\n    const { handler } = HttpApp.toWebHandlerLayer(router, layer)\n\n    // Create the HTTP server\n    const httpServer = createServer(async (req, res) => {\n      try {\n        // Collect request body\n        const chunks: Buffer[] = []\n        for await (const chunk of req) {\n          chunks.push(chunk as Buffer)\n        }\n        const body = Buffer.concat(chunks).toString()\n\n        // Convert Node.js request to web standard Request\n        // Use URL constructor for safe URL parsing (avoids injection via req.url)\n        const baseUrl = `http://${host === \"0.0.0.0\" ? \"localhost\" : host}:${port}`\n        const url = new URL(req.url || \"/\", baseUrl).href\n        const headers = toWebHeaders(req.headers)\n\n        const webRequest = new Request(url, {\n          method: req.method,\n          headers,\n          body: [\"GET\", \"HEAD\"].includes(req.method!) ? undefined : body,\n        })\n\n        // Process through Effect handler\n        const webResponse = await handler(webRequest)\n\n        // Write response\n        res.statusCode = webResponse.status\n        webResponse.headers.forEach((value, key) => {\n          res.setHeader(key, value)\n        })\n        const responseBody = await webResponse.text()\n        res.end(responseBody)\n      } catch (error) {\n        res.statusCode = 500\n        res.end(JSON.stringify({ error: String(error) }))\n      }\n    })\n\n    // Create WebSocket server for subscriptions\n    const { handleUpgrade, close: closeWS } = createGraphQLWSServer(\n      subscriptions.schema,\n      layer as Layer.Layer<R>,\n      {\n        path: subscriptions.path,\n        complexity: subscriptions.complexity,\n        fieldComplexities: subscriptions.fieldComplexities,\n        onConnect: subscriptions.onConnect,\n        onDisconnect: subscriptions.onDisconnect,\n        onSubscribe: subscriptions.onSubscribe,\n        onComplete: subscriptions.onComplete,\n        onError: subscriptions.onError,\n      }\n    )\n\n    // Attach WebSocket upgrade handler\n    httpServer.on(\"upgrade\", (request, socket, head) => {\n      handleUpgrade(request, socket, head)\n    })\n\n    // Handle shutdown\n    process.on(\"SIGINT\", async () => {\n      await closeWS()\n      httpServer.close()\n      process.exit(0)\n    })\n\n    process.on(\"SIGTERM\", async () => {\n      await closeWS()\n      httpServer.close()\n      process.exit(0)\n    })\n\n    // Start listening\n    httpServer.listen(port, host, () => {\n      if (onStart) {\n        onStart(`http://${host === \"0.0.0.0\" ? \"localhost\" : host}:${port}`)\n      }\n    })\n  })\n}\n","export { serve, type ServeOptions } from \"./serve\"\n\n// HTTP utilities\nexport { toWebHeaders } from \"./http-utils\"\n\n// WebSocket subscription support\nexport {\n  toEffectWebSocket,\n  createGraphQLWSServer,\n  attachWebSocketToServer,\n  type NodeWSOptions,\n} from \"./ws\"\n\n// SSE (Server-Sent Events) subscription support\nexport { createSSEHandler, createSSEServer, type NodeSSEOptions } from \"./sse\"\n","import { Effect, Layer, Stream, Deferred } from \"effect\"\nimport type { IncomingMessage, ServerResponse } from \"node:http\"\nimport { GraphQLSchema } from \"graphql\"\nimport {\n  makeGraphQLSSEHandler,\n  formatSSEMessage,\n  SSE_HEADERS,\n  type GraphQLSSEOptions,\n  type SSESubscriptionRequest,\n  SSEError,\n} from \"@effect-gql/core\"\nimport { toWebHeaders } from \"./http-utils\"\n\n/**\n * Options for Node.js SSE handler\n */\nexport interface NodeSSEOptions<R> extends GraphQLSSEOptions<R> {\n  /**\n   * Path for SSE connections.\n   * @default \"/graphql/stream\"\n   */\n  readonly path?: string\n}\n\n/**\n * Create an SSE handler for Node.js HTTP server.\n *\n * This function creates a handler that can process SSE subscription requests.\n * It handles:\n * - Parsing the GraphQL subscription request from the HTTP body\n * - Setting up the SSE connection with proper headers\n * - Streaming subscription events to the client\n * - Detecting client disconnection and cleaning up\n *\n * @param schema - The GraphQL schema with subscription definitions\n * @param layer - Effect layer providing services required by resolvers\n * @param options - Optional lifecycle hooks and configuration\n * @returns A request handler function\n *\n * @example\n * ```typescript\n * import { createServer } from \"node:http\"\n * import { createSSEHandler } from \"@effect-gql/node\"\n *\n * const sseHandler = createSSEHandler(schema, serviceLayer, {\n *   path: \"/graphql/stream\",\n *   onConnect: (request, headers) => Effect.gen(function* () {\n *     const user = yield* AuthService.validateToken(headers.get(\"authorization\"))\n *     return { user }\n *   }),\n * })\n *\n * const server = createServer((req, res) => {\n *   const url = new URL(req.url, `http://${req.headers.host}`)\n *   if (url.pathname === \"/graphql/stream\" && req.method === \"POST\") {\n *     sseHandler(req, res)\n *   } else {\n *     // Handle other requests...\n *   }\n * })\n *\n * server.listen(4000)\n * ```\n */\nexport const createSSEHandler = <R>(\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: NodeSSEOptions<R>\n): ((req: IncomingMessage, res: ServerResponse) => Promise<void>) => {\n  const sseHandler = makeGraphQLSSEHandler(schema, layer, options)\n\n  return async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    // Check Accept header for SSE support\n    const accept = req.headers.accept ?? \"\"\n    if (!accept.includes(\"text/event-stream\") && !accept.includes(\"*/*\")) {\n      res.statusCode = 406\n      res.end(\n        JSON.stringify({\n          errors: [{ message: \"Client must accept text/event-stream\" }],\n        })\n      )\n      return\n    }\n\n    // Read the request body\n    let body: string\n    try {\n      body = await readBody(req)\n    } catch {\n      res.statusCode = 400\n      res.end(\n        JSON.stringify({\n          errors: [{ message: \"Failed to read request body\" }],\n        })\n      )\n      return\n    }\n\n    // Parse the GraphQL request\n    let request: SSESubscriptionRequest\n    try {\n      const parsed = JSON.parse(body)\n      if (typeof parsed.query !== \"string\") {\n        throw new Error(\"Missing query\")\n      }\n      request = {\n        query: parsed.query,\n        variables: parsed.variables,\n        operationName: parsed.operationName,\n        extensions: parsed.extensions,\n      }\n    } catch {\n      res.statusCode = 400\n      res.end(\n        JSON.stringify({\n          errors: [{ message: \"Invalid GraphQL request body\" }],\n        })\n      )\n      return\n    }\n\n    // Convert Node.js headers to web Headers\n    const headers = toWebHeaders(req.headers)\n\n    // Set SSE headers\n    res.writeHead(200, SSE_HEADERS)\n\n    // Get the event stream\n    const eventStream = sseHandler(request, headers)\n\n    // Create the streaming effect\n    const streamEffect = Effect.gen(function* () {\n      // Track client disconnection\n      const clientDisconnected = yield* Deferred.make<void, SSEError>()\n\n      req.on(\"close\", () => {\n        Effect.runPromise(Deferred.succeed(clientDisconnected, undefined)).catch(() => {})\n      })\n\n      req.on(\"error\", (error) => {\n        Effect.runPromise(Deferred.fail(clientDisconnected, new SSEError({ cause: error }))).catch(\n          () => {}\n        )\n      })\n\n      // Stream events to the client\n      const runStream = Stream.runForEach(eventStream, (event) =>\n        Effect.async<void, SSEError>((resume) => {\n          const message = formatSSEMessage(event)\n          res.write(message, (error) => {\n            if (error) {\n              resume(Effect.fail(new SSEError({ cause: error })))\n            } else {\n              resume(Effect.succeed(undefined))\n            }\n          })\n        })\n      )\n\n      // Race between stream completion and client disconnection\n      yield* Effect.race(\n        runStream.pipe(Effect.catchAll((error) => Effect.logWarning(\"SSE stream error\", error))),\n        Deferred.await(clientDisconnected)\n      )\n    })\n\n    await Effect.runPromise(\n      streamEffect.pipe(\n        Effect.ensuring(Effect.sync(() => res.end())),\n        Effect.catchAll(() => Effect.void)\n      )\n    )\n  }\n}\n\n/**\n * Read the request body as a string.\n */\nfunction readBody(req: IncomingMessage): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = []\n    req.on(\"data\", (chunk: Buffer) => chunks.push(chunk))\n    req.on(\"end\", () => resolve(Buffer.concat(chunks).toString()))\n    req.on(\"error\", reject)\n  })\n}\n\n/**\n * Create SSE middleware that can be used with the serve() function.\n *\n * This returns an object that can be used to integrate SSE subscriptions\n * with the HTTP server when using the custom subscription mode.\n *\n * @param schema - The GraphQL schema with subscription definitions\n * @param layer - Effect layer providing services required by resolvers\n * @param options - Optional lifecycle hooks and configuration\n *\n * @example\n * ```typescript\n * // In serve.ts with custom HTTP server setup\n * const sseServer = createSSEServer(schema, layer, { path: \"/graphql/stream\" })\n *\n * httpServer.on(\"request\", (req, res) => {\n *   if (sseServer.shouldHandle(req)) {\n *     sseServer.handle(req, res)\n *   }\n * })\n * ```\n */\nexport const createSSEServer = <R>(\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: NodeSSEOptions<R>\n): {\n  /** Path this SSE server handles */\n  readonly path: string\n  /** Check if a request should be handled by this SSE server */\n  shouldHandle: (req: IncomingMessage) => boolean\n  /** Handle an SSE request */\n  handle: (req: IncomingMessage, res: ServerResponse) => Promise<void>\n} => {\n  const path = options?.path ?? \"/graphql/stream\"\n  const handler = createSSEHandler(schema, layer, options)\n\n  return {\n    path,\n    shouldHandle: (req: IncomingMessage) => {\n      if (req.method !== \"POST\") return false\n      const url = new URL(req.url ?? \"/\", `http://${req.headers.host ?? \"localhost\"}`)\n      return url.pathname === path\n    },\n    handle: handler,\n  }\n}\n"]}