@effect-gql/express 0.1.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.ts ADDED
@@ -0,0 +1,184 @@
1
+ import { Layer } from 'effect';
2
+ import { HttpRouter } from '@effect/platform';
3
+ import { RequestHandler } from 'express';
4
+ import { Server } from 'node:http';
5
+ import { GraphQLSchema } from 'graphql';
6
+ import { GraphQLWSOptions, GraphQLSSEOptions } from '@effect-gql/core';
7
+
8
+ /**
9
+ * Convert an HttpRouter to Express middleware.
10
+ *
11
+ * This creates Express-compatible middleware that can be mounted on any Express app.
12
+ * The middleware converts Express requests to web standard Requests, processes them
13
+ * through the Effect router, and writes the response back to Express.
14
+ *
15
+ * @param router - The HttpRouter to convert (typically from makeGraphQLRouter or toRouter)
16
+ * @param layer - Layer providing any services required by the router
17
+ * @returns Express middleware function
18
+ *
19
+ * @example
20
+ * ```typescript
21
+ * import express from "express"
22
+ * import { makeGraphQLRouter } from "@effect-gql/core"
23
+ * import { toMiddleware } from "@effect-gql/express"
24
+ * import { Layer } from "effect"
25
+ *
26
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
27
+ *
28
+ * const app = express()
29
+ * app.use(toMiddleware(router, Layer.empty))
30
+ * app.listen(4000, () => console.log("Server running on http://localhost:4000"))
31
+ * ```
32
+ */
33
+ declare const toMiddleware: <E, R, RE>(router: HttpRouter.HttpRouter<E, R>, layer: Layer.Layer<R, RE>) => RequestHandler;
34
+
35
+ /**
36
+ * Options for Express WebSocket server
37
+ */
38
+ interface ExpressWSOptions<R> extends GraphQLWSOptions<R> {
39
+ /**
40
+ * Path for WebSocket connections.
41
+ * @default "/graphql"
42
+ */
43
+ readonly path?: string;
44
+ }
45
+ /**
46
+ * Attach WebSocket subscription support to an Express HTTP server.
47
+ *
48
+ * Since Express middleware doesn't own the HTTP server, this function
49
+ * must be called separately with the HTTP server instance to enable
50
+ * WebSocket subscriptions.
51
+ *
52
+ * @param server - The HTTP server running the Express app
53
+ * @param schema - The GraphQL schema with subscription definitions
54
+ * @param layer - Effect layer providing services required by resolvers
55
+ * @param options - Optional configuration and lifecycle hooks
56
+ * @returns Object with cleanup function
57
+ *
58
+ * @example
59
+ * ```typescript
60
+ * import express from "express"
61
+ * import { createServer } from "node:http"
62
+ * import { toMiddleware, attachWebSocket } from "@effect-gql/express"
63
+ * import { makeGraphQLRouter, GraphQLSchemaBuilder } from "@effect-gql/core"
64
+ * import { Layer, Effect, Stream } from "effect"
65
+ * import * as S from "effect/Schema"
66
+ *
67
+ * // Build schema with subscriptions
68
+ * const schema = GraphQLSchemaBuilder.empty
69
+ * .query("hello", { type: S.String, resolve: () => Effect.succeed("world") })
70
+ * .subscription("counter", {
71
+ * type: S.Int,
72
+ * subscribe: () => Effect.succeed(Stream.fromIterable([1, 2, 3]))
73
+ * })
74
+ * .buildSchema()
75
+ *
76
+ * // Create Express app with middleware
77
+ * const app = express()
78
+ * app.use(express.json())
79
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
80
+ * app.use(toMiddleware(router, Layer.empty))
81
+ *
82
+ * // Create HTTP server and attach WebSocket support
83
+ * const server = createServer(app)
84
+ * const ws = attachWebSocket(server, schema, Layer.empty, {
85
+ * path: "/graphql"
86
+ * })
87
+ *
88
+ * server.listen(4000, () => {
89
+ * console.log("Server running on http://localhost:4000")
90
+ * console.log("WebSocket subscriptions available at ws://localhost:4000/graphql")
91
+ * })
92
+ *
93
+ * // Cleanup on shutdown
94
+ * process.on("SIGINT", async () => {
95
+ * await ws.close()
96
+ * server.close()
97
+ * })
98
+ * ```
99
+ */
100
+ declare const attachWebSocket: <R>(server: Server, schema: GraphQLSchema, layer: Layer.Layer<R>, options?: ExpressWSOptions<R>) => {
101
+ close: () => Promise<void>;
102
+ };
103
+
104
+ /**
105
+ * Options for Express SSE middleware
106
+ */
107
+ interface ExpressSSEOptions<R> extends GraphQLSSEOptions<R> {
108
+ /**
109
+ * Path for SSE connections.
110
+ * @default "/graphql/stream"
111
+ */
112
+ readonly path?: string;
113
+ }
114
+ /**
115
+ * Create an Express middleware for SSE subscriptions.
116
+ *
117
+ * This middleware handles POST requests to the configured path and streams
118
+ * GraphQL subscription events as Server-Sent Events.
119
+ *
120
+ * @param schema - The GraphQL schema with subscription definitions
121
+ * @param layer - Effect layer providing services required by resolvers
122
+ * @param options - Optional lifecycle hooks and configuration
123
+ * @returns An Express middleware function
124
+ *
125
+ * @example
126
+ * ```typescript
127
+ * import express from "express"
128
+ * import { createServer } from "node:http"
129
+ * import { toMiddleware, sseMiddleware, attachWebSocket } from "@effect-gql/express"
130
+ * import { makeGraphQLRouter } from "@effect-gql/core"
131
+ *
132
+ * const app = express()
133
+ * app.use(express.json())
134
+ *
135
+ * // Regular GraphQL endpoint
136
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
137
+ * app.use(toMiddleware(router, Layer.empty))
138
+ *
139
+ * // SSE subscriptions endpoint
140
+ * app.use(sseMiddleware(schema, Layer.empty, {
141
+ * path: "/graphql/stream",
142
+ * onConnect: (request, headers) => Effect.gen(function* () {
143
+ * const token = headers.get("authorization")
144
+ * const user = yield* AuthService.validateToken(token)
145
+ * return { user }
146
+ * }),
147
+ * }))
148
+ *
149
+ * const server = createServer(app)
150
+ *
151
+ * // Optional: Also attach WebSocket subscriptions
152
+ * attachWebSocket(server, schema, Layer.empty)
153
+ *
154
+ * server.listen(4000)
155
+ * ```
156
+ */
157
+ declare const sseMiddleware: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: ExpressSSEOptions<R>) => RequestHandler;
158
+ /**
159
+ * Create a standalone Express route handler for SSE subscriptions.
160
+ *
161
+ * Use this if you want more control over routing than the middleware provides.
162
+ *
163
+ * @param schema - The GraphQL schema with subscription definitions
164
+ * @param layer - Effect layer providing services required by resolvers
165
+ * @param options - Optional lifecycle hooks and configuration
166
+ * @returns An Express request handler
167
+ *
168
+ * @example
169
+ * ```typescript
170
+ * import express from "express"
171
+ * import { createSSEHandler } from "@effect-gql/express"
172
+ *
173
+ * const app = express()
174
+ * app.use(express.json())
175
+ *
176
+ * const sseHandler = createSSEHandler(schema, Layer.empty)
177
+ * app.post("/graphql/stream", sseHandler)
178
+ *
179
+ * app.listen(4000)
180
+ * ```
181
+ */
182
+ declare const createSSEHandler: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: Omit<ExpressSSEOptions<R>, "path">) => RequestHandler;
183
+
184
+ export { type ExpressSSEOptions, type ExpressWSOptions, attachWebSocket, createSSEHandler, sseMiddleware, toMiddleware };
package/index.js ADDED
@@ -0,0 +1,247 @@
1
+ import { HttpApp } from '@effect/platform';
2
+ import { Effect, Deferred, Stream } from 'effect';
3
+ import { WebSocketServer } from 'ws';
4
+ import { makeGraphQLWSHandler, toEffectWebSocketFromWs, makeGraphQLSSEHandler, SSE_HEADERS, SSEError, formatSSEMessage } from '@effect-gql/core';
5
+
6
+ // src/middleware.ts
7
+
8
+ // src/http-utils.ts
9
+ var toWebHeaders = (nodeHeaders) => {
10
+ const headers = new Headers();
11
+ for (const [key, value] of Object.entries(nodeHeaders)) {
12
+ if (value) {
13
+ if (Array.isArray(value)) {
14
+ value.forEach((v) => headers.append(key, v));
15
+ } else {
16
+ headers.set(key, value);
17
+ }
18
+ }
19
+ }
20
+ return headers;
21
+ };
22
+
23
+ // src/middleware.ts
24
+ var toMiddleware = (router, layer) => {
25
+ const { handler } = HttpApp.toWebHandlerLayer(router, layer);
26
+ return async (req, res, next) => {
27
+ try {
28
+ const baseUrl = `${req.protocol}://${req.hostname}`;
29
+ const url = new URL(req.originalUrl || "/", baseUrl).href;
30
+ const headers = toWebHeaders(req.headers);
31
+ const webRequest = new Request(url, {
32
+ method: req.method,
33
+ headers,
34
+ body: ["GET", "HEAD"].includes(req.method) ? void 0 : JSON.stringify(req.body)
35
+ });
36
+ const webResponse = await handler(webRequest);
37
+ res.status(webResponse.status);
38
+ webResponse.headers.forEach((value, key) => {
39
+ res.setHeader(key, value);
40
+ });
41
+ const body = await webResponse.text();
42
+ res.send(body);
43
+ } catch (error) {
44
+ next(error);
45
+ }
46
+ };
47
+ };
48
+ var attachWebSocket = (server, schema, layer, options) => {
49
+ const wss = new WebSocketServer({ noServer: true });
50
+ const path = options?.path ?? "/graphql";
51
+ const handler = makeGraphQLWSHandler(schema, layer, options);
52
+ const activeConnections = /* @__PURE__ */ new Set();
53
+ wss.on("connection", (ws) => {
54
+ activeConnections.add(ws);
55
+ const effectSocket = toEffectWebSocketFromWs(ws);
56
+ Effect.runPromise(
57
+ handler(effectSocket).pipe(
58
+ Effect.catchAll((error) => Effect.logError("GraphQL WebSocket handler error", error))
59
+ )
60
+ ).finally(() => {
61
+ activeConnections.delete(ws);
62
+ });
63
+ });
64
+ const handleUpgrade = (request, socket, head) => {
65
+ const url = new URL(request.url ?? "/", `http://${request.headers.host}`);
66
+ if (url.pathname !== path) {
67
+ socket.destroy();
68
+ return;
69
+ }
70
+ const protocol = request.headers["sec-websocket-protocol"];
71
+ if (!protocol?.includes("graphql-transport-ws")) {
72
+ socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
73
+ socket.destroy();
74
+ return;
75
+ }
76
+ wss.handleUpgrade(request, socket, head, (ws) => {
77
+ wss.emit("connection", ws, request);
78
+ });
79
+ };
80
+ server.on("upgrade", (request, socket, head) => {
81
+ handleUpgrade(request, socket, head);
82
+ });
83
+ const close = async () => {
84
+ for (const ws of activeConnections) {
85
+ ws.close(1001, "Server shutting down");
86
+ }
87
+ activeConnections.clear();
88
+ return new Promise((resolve, reject) => {
89
+ wss.close((error) => {
90
+ if (error) reject(error);
91
+ else resolve();
92
+ });
93
+ });
94
+ };
95
+ return { close };
96
+ };
97
+ var sseMiddleware = (schema, layer, options) => {
98
+ const path = options?.path ?? "/graphql/stream";
99
+ const sseHandler = makeGraphQLSSEHandler(schema, layer, options);
100
+ return async (req, res, next) => {
101
+ if (req.path !== path) {
102
+ next();
103
+ return;
104
+ }
105
+ if (req.method !== "POST") {
106
+ next();
107
+ return;
108
+ }
109
+ const accept = req.headers.accept ?? "";
110
+ if (!accept.includes("text/event-stream") && !accept.includes("*/*")) {
111
+ res.status(406).json({
112
+ errors: [{ message: "Client must accept text/event-stream" }]
113
+ });
114
+ return;
115
+ }
116
+ let subscriptionRequest;
117
+ try {
118
+ const body = req.body;
119
+ if (typeof body.query !== "string") {
120
+ throw new Error("Missing query");
121
+ }
122
+ subscriptionRequest = {
123
+ query: body.query,
124
+ variables: body.variables,
125
+ operationName: body.operationName,
126
+ extensions: body.extensions
127
+ };
128
+ } catch {
129
+ res.status(400).json({
130
+ errors: [{ message: "Invalid GraphQL request body" }]
131
+ });
132
+ return;
133
+ }
134
+ const headers = toWebHeaders(req.headers);
135
+ res.writeHead(200, SSE_HEADERS);
136
+ const eventStream = sseHandler(subscriptionRequest, headers);
137
+ const streamEffect = Effect.gen(function* () {
138
+ const clientDisconnected = yield* Deferred.make();
139
+ req.on("close", () => {
140
+ Effect.runPromise(Deferred.succeed(clientDisconnected, void 0)).catch(() => {
141
+ });
142
+ });
143
+ req.on("error", (error) => {
144
+ Effect.runPromise(Deferred.fail(clientDisconnected, new SSEError({ cause: error }))).catch(
145
+ () => {
146
+ }
147
+ );
148
+ });
149
+ const runStream = Stream.runForEach(
150
+ eventStream,
151
+ (event) => Effect.async((resume) => {
152
+ const message = formatSSEMessage(event);
153
+ res.write(message, (error) => {
154
+ if (error) {
155
+ resume(Effect.fail(new SSEError({ cause: error })));
156
+ } else {
157
+ resume(Effect.succeed(void 0));
158
+ }
159
+ });
160
+ })
161
+ );
162
+ yield* Effect.race(
163
+ runStream.pipe(Effect.catchAll((error) => Effect.logWarning("SSE stream error", error))),
164
+ Deferred.await(clientDisconnected)
165
+ );
166
+ });
167
+ await Effect.runPromise(
168
+ streamEffect.pipe(
169
+ Effect.ensuring(Effect.sync(() => res.end())),
170
+ Effect.catchAll(() => Effect.void)
171
+ )
172
+ );
173
+ };
174
+ };
175
+ var createSSEHandler = (schema, layer, options) => {
176
+ const sseHandler = makeGraphQLSSEHandler(schema, layer, options);
177
+ return async (req, res, _next) => {
178
+ const accept = req.headers.accept ?? "";
179
+ if (!accept.includes("text/event-stream") && !accept.includes("*/*")) {
180
+ res.status(406).json({
181
+ errors: [{ message: "Client must accept text/event-stream" }]
182
+ });
183
+ return;
184
+ }
185
+ let subscriptionRequest;
186
+ try {
187
+ const body = req.body;
188
+ if (typeof body.query !== "string") {
189
+ throw new Error("Missing query");
190
+ }
191
+ subscriptionRequest = {
192
+ query: body.query,
193
+ variables: body.variables,
194
+ operationName: body.operationName,
195
+ extensions: body.extensions
196
+ };
197
+ } catch {
198
+ res.status(400).json({
199
+ errors: [{ message: "Invalid GraphQL request body" }]
200
+ });
201
+ return;
202
+ }
203
+ const headers = toWebHeaders(req.headers);
204
+ res.writeHead(200, SSE_HEADERS);
205
+ const eventStream = sseHandler(subscriptionRequest, headers);
206
+ const streamEffect = Effect.gen(function* () {
207
+ const clientDisconnected = yield* Deferred.make();
208
+ req.on("close", () => {
209
+ Effect.runPromise(Deferred.succeed(clientDisconnected, void 0)).catch(() => {
210
+ });
211
+ });
212
+ req.on("error", (error) => {
213
+ Effect.runPromise(Deferred.fail(clientDisconnected, new SSEError({ cause: error }))).catch(
214
+ () => {
215
+ }
216
+ );
217
+ });
218
+ const runStream = Stream.runForEach(
219
+ eventStream,
220
+ (event) => Effect.async((resume) => {
221
+ const message = formatSSEMessage(event);
222
+ res.write(message, (error) => {
223
+ if (error) {
224
+ resume(Effect.fail(new SSEError({ cause: error })));
225
+ } else {
226
+ resume(Effect.succeed(void 0));
227
+ }
228
+ });
229
+ })
230
+ );
231
+ yield* Effect.race(
232
+ runStream.pipe(Effect.catchAll((error) => Effect.logWarning("SSE stream error", error))),
233
+ Deferred.await(clientDisconnected)
234
+ );
235
+ });
236
+ await Effect.runPromise(
237
+ streamEffect.pipe(
238
+ Effect.ensuring(Effect.sync(() => res.end())),
239
+ Effect.catchAll(() => Effect.void)
240
+ )
241
+ );
242
+ };
243
+ };
244
+
245
+ export { attachWebSocket, createSSEHandler, sseMiddleware, toMiddleware };
246
+ //# sourceMappingURL=index.js.map
247
+ //# sourceMappingURL=index.js.map
package/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/http-utils.ts","../src/middleware.ts","../src/ws.ts","../src/sse.ts"],"names":["Effect"],"mappings":"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","file":"index.js","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/package.json CHANGED
@@ -1,21 +1,23 @@
1
1
  {
2
2
  "name": "@effect-gql/express",
3
- "version": "0.1.0",
3
+ "version": "1.1.0",
4
4
  "description": "Express middleware adapter for @effect-gql/core",
5
- "main": "dist/index.js",
6
- "types": "dist/index.d.ts",
5
+ "repository": {
6
+ "url": "https://github.com/nrf110/effect-gql"
7
+ },
8
+ "type": "module",
9
+ "main": "./index.cjs",
10
+ "module": "dist/index.js",
11
+ "types": "./index.d.ts",
7
12
  "exports": {
8
13
  ".": {
9
- "types": "./dist/index.d.ts",
10
- "default": "./dist/index.js"
14
+ "types": "./index.d.ts",
15
+ "import": "./index.js",
16
+ "require": "./index.cjs"
11
17
  }
12
18
  },
13
- "files": [
14
- "dist",
15
- "src"
16
- ],
17
19
  "peerDependencies": {
18
- "@effect-gql/core": "^0.1.0",
20
+ "@effect-gql/core": "^1.1.0",
19
21
  "@effect/platform": "^0.94.0",
20
22
  "effect": "^3.19.0",
21
23
  "express": "^4.18.0 || ^5.0.0",
@@ -30,16 +32,6 @@
30
32
  "optional": true
31
33
  }
32
34
  },
33
- "devDependencies": {
34
- "@effect-gql/core": "*",
35
- "@effect/platform": "^0.94.0",
36
- "@types/express": "^5.0.6",
37
- "@types/ws": "^8.5.0",
38
- "effect": "^3.19.13",
39
- "express": "^5.2.1",
40
- "graphql-ws": "^6.0.6",
41
- "ws": "^8.18.0"
42
- },
43
35
  "keywords": [
44
36
  "effect",
45
37
  "graphql",
@@ -48,14 +40,5 @@
48
40
  "http",
49
41
  "server"
50
42
  ],
51
- "license": "MIT",
52
- "scripts": {
53
- "build": "tsc",
54
- "dev": "tsc --watch",
55
- "clean": "rm -rf dist",
56
- "test": "vitest run",
57
- "test:unit": "vitest run test/unit",
58
- "test:integration": "vitest run test/integration",
59
- "test:watch": "vitest"
60
- }
61
- }
43
+ "license": "MIT"
44
+ }
@@ -1,12 +0,0 @@
1
- import type { IncomingHttpHeaders } from "node:http";
2
- /**
3
- * Convert Node.js/Express IncomingHttpHeaders to web standard Headers.
4
- *
5
- * This handles the difference between Node.js headers (which can be
6
- * string | string[] | undefined) and web Headers (which are always strings).
7
- *
8
- * @param nodeHeaders - Headers from req.headers
9
- * @returns A web standard Headers object
10
- */
11
- export declare const toWebHeaders: (nodeHeaders: IncomingHttpHeaders) => Headers;
12
- //# sourceMappingURL=http-utils.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"http-utils.d.ts","sourceRoot":"","sources":["../src/http-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAEpD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,mBAAmB,KAAG,OAY/D,CAAA"}
@@ -1,28 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.toWebHeaders = void 0;
4
- /**
5
- * Convert Node.js/Express IncomingHttpHeaders to web standard Headers.
6
- *
7
- * This handles the difference between Node.js headers (which can be
8
- * string | string[] | undefined) and web Headers (which are always strings).
9
- *
10
- * @param nodeHeaders - Headers from req.headers
11
- * @returns A web standard Headers object
12
- */
13
- const toWebHeaders = (nodeHeaders) => {
14
- const headers = new Headers();
15
- for (const [key, value] of Object.entries(nodeHeaders)) {
16
- if (value) {
17
- if (Array.isArray(value)) {
18
- value.forEach((v) => headers.append(key, v));
19
- }
20
- else {
21
- headers.set(key, value);
22
- }
23
- }
24
- }
25
- return headers;
26
- };
27
- exports.toWebHeaders = toWebHeaders;
28
- //# sourceMappingURL=http-utils.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"http-utils.js","sourceRoot":"","sources":["../src/http-utils.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACI,MAAM,YAAY,GAAG,CAAC,WAAgC,EAAW,EAAE;IACxE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;YAC9C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAZY,QAAA,YAAY,gBAYxB"}
package/dist/index.d.ts DELETED
@@ -1,4 +0,0 @@
1
- export { toMiddleware } from "./middleware";
2
- export { attachWebSocket, type ExpressWSOptions } from "./ws";
3
- export { sseMiddleware, createSSEHandler, type ExpressSSEOptions } from "./sse";
4
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAG7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA"}
package/dist/index.js DELETED
@@ -1,13 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.createSSEHandler = exports.sseMiddleware = exports.attachWebSocket = exports.toMiddleware = void 0;
4
- var middleware_1 = require("./middleware");
5
- Object.defineProperty(exports, "toMiddleware", { enumerable: true, get: function () { return middleware_1.toMiddleware; } });
6
- // WebSocket subscription support
7
- var ws_1 = require("./ws");
8
- Object.defineProperty(exports, "attachWebSocket", { enumerable: true, get: function () { return ws_1.attachWebSocket; } });
9
- // SSE (Server-Sent Events) subscription support
10
- var sse_1 = require("./sse");
11
- Object.defineProperty(exports, "sseMiddleware", { enumerable: true, get: function () { return sse_1.sseMiddleware; } });
12
- Object.defineProperty(exports, "createSSEHandler", { enumerable: true, get: function () { return sse_1.createSSEHandler; } });
13
- //# sourceMappingURL=index.js.map
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAA2C;AAAlC,0GAAA,YAAY,OAAA;AAErB,iCAAiC;AACjC,2BAA6D;AAApD,qGAAA,eAAe,OAAA;AAExB,gDAAgD;AAChD,6BAA+E;AAAtE,oGAAA,aAAa,OAAA;AAAE,uGAAA,gBAAgB,OAAA"}
@@ -1,30 +0,0 @@
1
- import { Layer } from "effect";
2
- import { HttpRouter } from "@effect/platform";
3
- import type { RequestHandler } from "express";
4
- /**
5
- * Convert an HttpRouter to Express middleware.
6
- *
7
- * This creates Express-compatible middleware that can be mounted on any Express app.
8
- * The middleware converts Express requests to web standard Requests, processes them
9
- * through the Effect router, and writes the response back to Express.
10
- *
11
- * @param router - The HttpRouter to convert (typically from makeGraphQLRouter or toRouter)
12
- * @param layer - Layer providing any services required by the router
13
- * @returns Express middleware function
14
- *
15
- * @example
16
- * ```typescript
17
- * import express from "express"
18
- * import { makeGraphQLRouter } from "@effect-gql/core"
19
- * import { toMiddleware } from "@effect-gql/express"
20
- * import { Layer } from "effect"
21
- *
22
- * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
23
- *
24
- * const app = express()
25
- * app.use(toMiddleware(router, Layer.empty))
26
- * app.listen(4000, () => console.log("Server running on http://localhost:4000"))
27
- * ```
28
- */
29
- export declare const toMiddleware: <E, R, RE>(router: HttpRouter.HttpRouter<E, R>, layer: Layer.Layer<R, RE>) => RequestHandler;
30
- //# sourceMappingURL=middleware.d.ts.map