@effect-gql/express 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,252 @@
+'use strict';
+
+var platform = require('@effect/platform');
+var effect = require('effect');
+var ws = require('ws');
+var core = require('@effect-gql/core');
+
+// src/middleware.ts
+
+// 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/middleware.ts
+var toMiddleware = (router, layer) => {
+  const { handler } = platform.HttpApp.toWebHandlerLayer(router, layer);
+  return async (req, res, next) => {
+    try {
+      const baseUrl = `${req.protocol}://${req.hostname}`;
+      const url = new URL(req.originalUrl || "/", baseUrl).href;
+      const headers = toWebHeaders(req.headers);
+      const webRequest = new Request(url, {
+        method: req.method,
+        headers,
+        body: ["GET", "HEAD"].includes(req.method) ? void 0 : JSON.stringify(req.body)
+      });
+      const webResponse = await handler(webRequest);
+      res.status(webResponse.status);
+      webResponse.headers.forEach((value, key) => {
+        res.setHeader(key, value);
+      });
+      const body = await webResponse.text();
+      res.send(body);
+    } catch (error) {
+      next(error);
+    }
+  };
+};
+var attachWebSocket = (server, 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) => {
+    activeConnections.add(ws);
+    const effectSocket = core.toEffectWebSocketFromWs(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);
+    });
+  };
+  server.on("upgrade", (request, socket, head) => {
+    handleUpgrade(request, socket, head);
+  });
+  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 { close };
+};
+var sseMiddleware = (schema, layer, options) => {
+  const path = options?.path ?? "/graphql/stream";
+  const sseHandler = core.makeGraphQLSSEHandler(schema, layer, options);
+  return async (req, res, next) => {
+    if (req.path !== path) {
+      next();
+      return;
+    }
+    if (req.method !== "POST") {
+      next();
+      return;
+    }
+    const accept = req.headers.accept ?? "";
+    if (!accept.includes("text/event-stream") && !accept.includes("*/*")) {
+      res.status(406).json({
+        errors: [{ message: "Client must accept text/event-stream" }]
+      });
+      return;
+    }
+    let subscriptionRequest;
+    try {
+      const body = req.body;
+      if (typeof body.query !== "string") {
+        throw new Error("Missing query");
+      }
+      subscriptionRequest = {
+        query: body.query,
+        variables: body.variables,
+        operationName: body.operationName,
+        extensions: body.extensions
+      };
+    } catch {
+      res.status(400).json({
+        errors: [{ message: "Invalid GraphQL request body" }]
+      });
+      return;
+    }
+    const headers = toWebHeaders(req.headers);
+    res.writeHead(200, core.SSE_HEADERS);
+    const eventStream = sseHandler(subscriptionRequest, 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)
+      )
+    );
+  };
+};
+var createSSEHandler = (schema, layer, options) => {
+  const sseHandler = core.makeGraphQLSSEHandler(schema, layer, options);
+  return async (req, res, _next) => {
+    const accept = req.headers.accept ?? "";
+    if (!accept.includes("text/event-stream") && !accept.includes("*/*")) {
+      res.status(406).json({
+        errors: [{ message: "Client must accept text/event-stream" }]
+      });
+      return;
+    }
+    let subscriptionRequest;
+    try {
+      const body = req.body;
+      if (typeof body.query !== "string") {
+        throw new Error("Missing query");
+      }
+      subscriptionRequest = {
+        query: body.query,
+        variables: body.variables,
+        operationName: body.operationName,
+        extensions: body.extensions
+      };
+    } catch {
+      res.status(400).json({
+        errors: [{ message: "Invalid GraphQL request body" }]
+      });
+      return;
+    }
+    const headers = toWebHeaders(req.headers);
+    res.writeHead(200, core.SSE_HEADERS);
+    const eventStream = sseHandler(subscriptionRequest, 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)
+      )
+    );
+  };
+};
+
+exports.attachWebSocket = attachWebSocket;
+exports.createSSEHandler = createSSEHandler;
+exports.sseMiddleware = sseMiddleware;
+exports.toMiddleware = toMiddleware;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http-utils.ts","../src/middleware.ts","../src/ws.ts","../src/sse.ts"],"names":["HttpApp","WebSocketServer","makeGraphQLWSHandler","toEffectWebSocketFromWs","Effect","makeGraphQLSSEHandler","SSE_HEADERS","Deferred","SSEError","Stream","formatSSEMessage"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { IncomingHttpHeaders } from \"node:http\"\n\n/**\n * Convert Node.js/Express 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 req.headers\n * @returns A web standard Headers object\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 { Layer } from \"effect\"\nimport { HttpApp, HttpRouter } from \"@effect/platform\"\nimport type { Request, Response, NextFunction, RequestHandler } from \"express\"\nimport { toWebHeaders } from \"./http-utils\"\n\n/**\n * Convert an HttpRouter to Express middleware.\n *\n * This creates Express-compatible middleware that can be mounted on any Express app.\n * The middleware converts Express requests to web standard Requests, processes them\n * through the Effect router, and writes the response back to Express.\n *\n * @param router - The HttpRouter to convert (typically from makeGraphQLRouter or toRouter)\n * @param layer - Layer providing any services required by the router\n * @returns Express middleware function\n *\n * @example\n * ```typescript\n * import express from \"express\"\n * import { makeGraphQLRouter } from \"@effect-gql/core\"\n * import { toMiddleware } from \"@effect-gql/express\"\n * import { Layer } from \"effect\"\n *\n * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })\n *\n * const app = express()\n * app.use(toMiddleware(router, Layer.empty))\n * app.listen(4000, () => console.log(\"Server running on http://localhost:4000\"))\n * ```\n */\nexport const toMiddleware = <E, R, RE>(\n  router: HttpRouter.HttpRouter<E, R>,\n  layer: Layer.Layer<R, RE>\n): RequestHandler => {\n  const { handler } = HttpApp.toWebHandlerLayer(router, layer)\n\n  return async (req: Request, res: Response, next: NextFunction) => {\n    try {\n      // Convert Express request to web standard Request\n      // Use URL constructor for safe URL parsing (avoids Host header injection)\n      const baseUrl = `${req.protocol}://${req.hostname}`\n      const url = new URL(req.originalUrl || \"/\", 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 : JSON.stringify(req.body),\n      })\n\n      // Process through Effect handler\n      const webResponse = await handler(webRequest)\n\n      // Write response back to Express\n      res.status(webResponse.status)\n      webResponse.headers.forEach((value, key) => {\n        res.setHeader(key, value)\n      })\n      const body = await webResponse.text()\n      res.send(body)\n    } catch (error) {\n      next(error)\n    }\n  }\n}\n","import { Effect, Layer } from \"effect\"\nimport type { Server } from \"node:http\"\nimport type { IncomingMessage } 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 GraphQLWSOptions,\n} from \"@effect-gql/core\"\n\n/**\n * Options for Express WebSocket server\n */\nexport interface ExpressWSOptions<R> extends GraphQLWSOptions<R> {\n  /**\n   * Path for WebSocket connections.\n   * @default \"/graphql\"\n   */\n  readonly path?: string\n}\n\n/**\n * Attach WebSocket subscription support to an Express HTTP server.\n *\n * Since Express middleware doesn't own the HTTP server, this function\n * must be called separately with the HTTP server instance to enable\n * WebSocket subscriptions.\n *\n * @param server - The HTTP server running the Express app\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 with cleanup function\n *\n * @example\n * ```typescript\n * import express from \"express\"\n * import { createServer } from \"node:http\"\n * import { toMiddleware, attachWebSocket } from \"@effect-gql/express\"\n * import { makeGraphQLRouter, GraphQLSchemaBuilder } from \"@effect-gql/core\"\n * import { Layer, Effect, Stream } from \"effect\"\n * import * as S from \"effect/Schema\"\n *\n * // Build schema with subscriptions\n * const schema = GraphQLSchemaBuilder.empty\n *   .query(\"hello\", { type: S.String, resolve: () => Effect.succeed(\"world\") })\n *   .subscription(\"counter\", {\n *     type: S.Int,\n *     subscribe: () => Effect.succeed(Stream.fromIterable([1, 2, 3]))\n *   })\n *   .buildSchema()\n *\n * // Create Express app with middleware\n * const app = express()\n * app.use(express.json())\n * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })\n * app.use(toMiddleware(router, Layer.empty))\n *\n * // Create HTTP server and attach WebSocket support\n * const server = createServer(app)\n * const ws = attachWebSocket(server, schema, Layer.empty, {\n *   path: \"/graphql\"\n * })\n *\n * server.listen(4000, () => {\n *   console.log(\"Server running on http://localhost:4000\")\n *   console.log(\"WebSocket subscriptions available at ws://localhost:4000/graphql\")\n * })\n *\n * // Cleanup on shutdown\n * process.on(\"SIGINT\", async () => {\n *   await ws.close()\n *   server.close()\n * })\n * ```\n */\nexport const attachWebSocket = <R>(\n  server: Server,\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: ExpressWSOptions<R>\n): { close: () => Promise<void> } => {\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) => {\n    activeConnections.add(ws)\n\n    const effectSocket = toEffectWebSocketFromWs(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  // Attach upgrade handler to server\n  server.on(\"upgrade\", (request, socket, head) => {\n    handleUpgrade(request, socket as Duplex, head)\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 { close }\n}\n","import { Effect, Layer, Stream, Deferred } from \"effect\"\nimport type { Request, Response, NextFunction, RequestHandler } from \"express\"\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 Express SSE middleware\n */\nexport interface ExpressSSEOptions<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 Express middleware for SSE subscriptions.\n *\n * This middleware handles POST requests to the configured path and streams\n * GraphQL subscription events as Server-Sent Events.\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 An Express middleware function\n *\n * @example\n * ```typescript\n * import express from \"express\"\n * import { createServer } from \"node:http\"\n * import { toMiddleware, sseMiddleware, attachWebSocket } from \"@effect-gql/express\"\n * import { makeGraphQLRouter } from \"@effect-gql/core\"\n *\n * const app = express()\n * app.use(express.json())\n *\n * // Regular GraphQL endpoint\n * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })\n * app.use(toMiddleware(router, Layer.empty))\n *\n * // SSE subscriptions endpoint\n * app.use(sseMiddleware(schema, Layer.empty, {\n *   path: \"/graphql/stream\",\n *   onConnect: (request, headers) => Effect.gen(function* () {\n *     const token = headers.get(\"authorization\")\n *     const user = yield* AuthService.validateToken(token)\n *     return { user }\n *   }),\n * }))\n *\n * const server = createServer(app)\n *\n * // Optional: Also attach WebSocket subscriptions\n * attachWebSocket(server, schema, Layer.empty)\n *\n * server.listen(4000)\n * ```\n */\nexport const sseMiddleware = <R>(\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: ExpressSSEOptions<R>\n): RequestHandler => {\n  const path = options?.path ?? \"/graphql/stream\"\n  const sseHandler = makeGraphQLSSEHandler(schema, layer, options)\n\n  return async (req: Request, res: Response, next: NextFunction): Promise<void> => {\n    // Check if this request is for our path\n    if (req.path !== path) {\n      next()\n      return\n    }\n\n    // Only handle POST requests\n    if (req.method !== \"POST\") {\n      next()\n      return\n    }\n\n    // Check Accept header for SSE support\n    const accept = req.headers.accept ?? \"\"\n    if (!accept.includes(\"text/event-stream\") && !accept.includes(\"*/*\")) {\n      res.status(406).json({\n        errors: [{ message: \"Client must accept text/event-stream\" }],\n      })\n      return\n    }\n\n    // Parse the GraphQL request from the body\n    let subscriptionRequest: SSESubscriptionRequest\n    try {\n      const body = req.body as Record<string, unknown>\n      if (typeof body.query !== \"string\") {\n        throw new Error(\"Missing query\")\n      }\n      subscriptionRequest = {\n        query: body.query,\n        variables: body.variables as Record<string, unknown> | undefined,\n        operationName: body.operationName as string | undefined,\n        extensions: body.extensions as Record<string, unknown> | undefined,\n      }\n    } catch {\n      res.status(400).json({\n        errors: [{ message: \"Invalid GraphQL request body\" }],\n      })\n      return\n    }\n\n    // Convert Express 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(subscriptionRequest, 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 * Create a standalone Express route handler for SSE subscriptions.\n *\n * Use this if you want more control over routing than the middleware provides.\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 An Express request handler\n *\n * @example\n * ```typescript\n * import express from \"express\"\n * import { createSSEHandler } from \"@effect-gql/express\"\n *\n * const app = express()\n * app.use(express.json())\n *\n * const sseHandler = createSSEHandler(schema, Layer.empty)\n * app.post(\"/graphql/stream\", sseHandler)\n *\n * app.listen(4000)\n * ```\n */\nexport const createSSEHandler = <R>(\n  schema: GraphQLSchema,\n  layer: Layer.Layer<R>,\n  options?: Omit<ExpressSSEOptions<R>, \"path\">\n): RequestHandler => {\n  const sseHandler = makeGraphQLSSEHandler(schema, layer, options)\n\n  return async (req: Request, res: Response, _next: NextFunction): 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.status(406).json({\n        errors: [{ message: \"Client must accept text/event-stream\" }],\n      })\n      return\n    }\n\n    // Parse the GraphQL request from the body\n    let subscriptionRequest: SSESubscriptionRequest\n    try {\n      const body = req.body as Record<string, unknown>\n      if (typeof body.query !== \"string\") {\n        throw new Error(\"Missing query\")\n      }\n      subscriptionRequest = {\n        query: body.query,\n        variables: body.variables as Record<string, unknown> | undefined,\n        operationName: body.operationName as string | undefined,\n        extensions: body.extensions as Record<string, unknown> | undefined,\n      }\n    } catch {\n      res.status(400).json({\n        errors: [{ message: \"Invalid GraphQL request body\" }],\n      })\n      return\n    }\n\n    // Convert Express 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(subscriptionRequest, 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"]}

package/index.d.cts

@@ -0,0 +1,184 @@
+import { Layer } from 'effect';
+import { HttpRouter } from '@effect/platform';
+import { RequestHandler } from 'express';
+import { Server } from 'node:http';
+import { GraphQLSchema } from 'graphql';
+import { GraphQLWSOptions, GraphQLSSEOptions } from '@effect-gql/core';
+
+/**
+ * Convert an HttpRouter to Express middleware.
+ *
+ * This creates Express-compatible middleware that can be mounted on any Express app.
+ * The middleware converts Express requests to web standard Requests, processes them
+ * through the Effect router, and writes the response back to Express.
+ *
+ * @param router - The HttpRouter to convert (typically from makeGraphQLRouter or toRouter)
+ * @param layer - Layer providing any services required by the router
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * import express from "express"
+ * import { makeGraphQLRouter } from "@effect-gql/core"
+ * import { toMiddleware } from "@effect-gql/express"
+ * import { Layer } from "effect"
+ *
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
+ *
+ * const app = express()
+ * app.use(toMiddleware(router, Layer.empty))
+ * app.listen(4000, () => console.log("Server running on http://localhost:4000"))
+ * ```
+ */
+declare const toMiddleware: <E, R, RE>(router: HttpRouter.HttpRouter<E, R>, layer: Layer.Layer<R, RE>) => RequestHandler;
+
+/**
+ * Options for Express WebSocket server
+ */
+interface ExpressWSOptions<R> extends GraphQLWSOptions<R> {
+    /**
+     * Path for WebSocket connections.
+     * @default "/graphql"
+     */
+    readonly path?: string;
+}
+/**
+ * Attach WebSocket subscription support to an Express HTTP server.
+ *
+ * Since Express middleware doesn't own the HTTP server, this function
+ * must be called separately with the HTTP server instance to enable
+ * WebSocket subscriptions.
+ *
+ * @param server - The HTTP server running the Express app
+ * @param schema - The GraphQL schema with subscription definitions
+ * @param layer - Effect layer providing services required by resolvers
+ * @param options - Optional configuration and lifecycle hooks
+ * @returns Object with cleanup function
+ *
+ * @example
+ * ```typescript
+ * import express from "express"
+ * import { createServer } from "node:http"
+ * import { toMiddleware, attachWebSocket } from "@effect-gql/express"
+ * import { makeGraphQLRouter, GraphQLSchemaBuilder } from "@effect-gql/core"
+ * import { Layer, Effect, Stream } from "effect"
+ * import * as S from "effect/Schema"
+ *
+ * // Build schema with subscriptions
+ * const schema = GraphQLSchemaBuilder.empty
+ *   .query("hello", { type: S.String, resolve: () => Effect.succeed("world") })
+ *   .subscription("counter", {
+ *     type: S.Int,
+ *     subscribe: () => Effect.succeed(Stream.fromIterable([1, 2, 3]))
+ *   })
+ *   .buildSchema()
+ *
+ * // Create Express app with middleware
+ * const app = express()
+ * app.use(express.json())
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
+ * app.use(toMiddleware(router, Layer.empty))
+ *
+ * // Create HTTP server and attach WebSocket support
+ * const server = createServer(app)
+ * const ws = attachWebSocket(server, schema, Layer.empty, {
+ *   path: "/graphql"
+ * })
+ *
+ * server.listen(4000, () => {
+ *   console.log("Server running on http://localhost:4000")
+ *   console.log("WebSocket subscriptions available at ws://localhost:4000/graphql")
+ * })
+ *
+ * // Cleanup on shutdown
+ * process.on("SIGINT", async () => {
+ *   await ws.close()
+ *   server.close()
+ * })
+ * ```
+ */
+declare const attachWebSocket: <R>(server: Server, schema: GraphQLSchema, layer: Layer.Layer<R>, options?: ExpressWSOptions<R>) => {
+    close: () => Promise<void>;
+};
+
+/**
+ * Options for Express SSE middleware
+ */
+interface ExpressSSEOptions<R> extends GraphQLSSEOptions<R> {
+    /**
+     * Path for SSE connections.
+     * @default "/graphql/stream"
+     */
+    readonly path?: string;
+}
+/**
+ * Create an Express middleware for SSE subscriptions.
+ *
+ * This middleware handles POST requests to the configured path and streams
+ * GraphQL subscription events as Server-Sent Events.
+ *
+ * @param schema - The GraphQL schema with subscription definitions
+ * @param layer - Effect layer providing services required by resolvers
+ * @param options - Optional lifecycle hooks and configuration
+ * @returns An Express middleware function
+ *
+ * @example
+ * ```typescript
+ * import express from "express"
+ * import { createServer } from "node:http"
+ * import { toMiddleware, sseMiddleware, attachWebSocket } from "@effect-gql/express"
+ * import { makeGraphQLRouter } from "@effect-gql/core"
+ *
+ * const app = express()
+ * app.use(express.json())
+ *
+ * // Regular GraphQL endpoint
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
+ * app.use(toMiddleware(router, Layer.empty))
+ *
+ * // SSE subscriptions endpoint
+ * app.use(sseMiddleware(schema, Layer.empty, {
+ *   path: "/graphql/stream",
+ *   onConnect: (request, headers) => Effect.gen(function* () {
+ *     const token = headers.get("authorization")
+ *     const user = yield* AuthService.validateToken(token)
+ *     return { user }
+ *   }),
+ * }))
+ *
+ * const server = createServer(app)
+ *
+ * // Optional: Also attach WebSocket subscriptions
+ * attachWebSocket(server, schema, Layer.empty)
+ *
+ * server.listen(4000)
+ * ```
+ */
+declare const sseMiddleware: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: ExpressSSEOptions<R>) => RequestHandler;
+/**
+ * Create a standalone Express route handler for SSE subscriptions.
+ *
+ * Use this if you want more control over routing than the middleware provides.
+ *
+ * @param schema - The GraphQL schema with subscription definitions
+ * @param layer - Effect layer providing services required by resolvers
+ * @param options - Optional lifecycle hooks and configuration
+ * @returns An Express request handler
+ *
+ * @example
+ * ```typescript
+ * import express from "express"
+ * import { createSSEHandler } from "@effect-gql/express"
+ *
+ * const app = express()
+ * app.use(express.json())
+ *
+ * const sseHandler = createSSEHandler(schema, Layer.empty)
+ * app.post("/graphql/stream", sseHandler)
+ *
+ * app.listen(4000)
+ * ```
+ */
+declare const createSSEHandler: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: Omit<ExpressSSEOptions<R>, "path">) => RequestHandler;
+
+export { type ExpressSSEOptions, type ExpressWSOptions, attachWebSocket, createSSEHandler, sseMiddleware, toMiddleware };