@effect-gql/bun 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Nick Fisher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { serve, type ServeOptions, type SubscriptionsConfig } from "./serve";
+export { createBunWSHandlers, toBunEffectWebSocket, type BunWSOptions } from "./ws";
+export { createBunSSEHandler, createBunSSEHandlers, type BunSSEOptions } from "./sse";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG5E,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAA;AAGnF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBunSSEHandlers = exports.createBunSSEHandler = exports.toBunEffectWebSocket = exports.createBunWSHandlers = exports.serve = void 0;
+var serve_1 = require("./serve");
+Object.defineProperty(exports, "serve", { enumerable: true, get: function () { return serve_1.serve; } });
+// WebSocket subscription support
+var ws_1 = require("./ws");
+Object.defineProperty(exports, "createBunWSHandlers", { enumerable: true, get: function () { return ws_1.createBunWSHandlers; } });
+Object.defineProperty(exports, "toBunEffectWebSocket", { enumerable: true, get: function () { return ws_1.toBunEffectWebSocket; } });
+// SSE (Server-Sent Events) subscription support
+var sse_1 = require("./sse");
+Object.defineProperty(exports, "createBunSSEHandler", { enumerable: true, get: function () { return sse_1.createBunSSEHandler; } });
+Object.defineProperty(exports, "createBunSSEHandlers", { enumerable: true, get: function () { return sse_1.createBunSSEHandlers; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAA4E;AAAnE,8FAAA,KAAK,OAAA;AAEd,iCAAiC;AACjC,2BAAmF;AAA1E,yGAAA,mBAAmB,OAAA;AAAE,0GAAA,oBAAoB,OAAA;AAElD,gDAAgD;AAChD,6BAAqF;AAA5E,0GAAA,mBAAmB,OAAA;AAAE,2GAAA,oBAAoB,OAAA"}

package/dist/serve.d.ts

@@ -0,0 +1,73 @@
+import { Layer } from "effect";
+import { HttpRouter } from "@effect/platform";
+import type { GraphQLSchema } from "graphql";
+import type { GraphQLWSOptions } from "@effect-gql/core";
+/**
+ * Configuration for WebSocket subscriptions
+ */
+export interface SubscriptionsConfig<R> extends GraphQLWSOptions<R> {
+    /**
+     * The GraphQL schema (required for subscriptions).
+     * Must be the same schema used to create the router.
+     */
+    readonly schema: GraphQLSchema;
+    /**
+     * Path for WebSocket connections.
+     * @default "/graphql"
+     */
+    readonly path?: string;
+}
+/**
+ * Options for the Bun GraphQL server
+ */
+export interface ServeOptions<R = never> {
+    /** Port to listen on (default: 4000) */
+    readonly port?: number;
+    /** Hostname to bind to (default: "0.0.0.0") */
+    readonly host?: string;
+    /** Callback when server starts */
+    readonly onStart?: (url: string) => void;
+    /**
+     * Enable WebSocket subscriptions.
+     * When provided, the server will handle WebSocket upgrade requests
+     * for GraphQL subscriptions using the graphql-ws protocol.
+     */
+    readonly subscriptions?: SubscriptionsConfig<R>;
+}
+/**
+ * Start a Bun HTTP server with the given router.
+ *
+ * This is the main entry point for running a GraphQL server on Bun.
+ * It handles all the Effect runtime setup and server lifecycle.
+ *
+ * @param router - The HttpRouter to serve (typically from makeGraphQLRouter or toRouter)
+ * @param layer - Layer providing the router's service dependencies
+ * @param options - Server configuration options
+ *
+ * @example
+ * ```typescript
+ * import { makeGraphQLRouter } from "@effect-gql/core"
+ * import { serve } from "@effect-gql/bun"
+ *
+ * const schema = GraphQLSchemaBuilder.empty
+ *   .query("hello", { type: S.String, resolve: () => Effect.succeed("world") })
+ *   .buildSchema()
+ *
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
+ *
+ * // Without subscriptions
+ * serve(router, serviceLayer, {
+ *   port: 4000,
+ *   onStart: (url) => console.log(`Server running at ${url}`)
+ * })
+ *
+ * // With subscriptions
+ * serve(router, serviceLayer, {
+ *   port: 4000,
+ *   subscriptions: { schema },
+ *   onStart: (url) => console.log(`Server running at ${url}`)
+ * })
+ * ```
+ */
+export declare const serve: <E, R, RE>(router: HttpRouter.HttpRouter<E, R>, layer: Layer.Layer<R, RE>, options?: ServeOptions<R>) => void;
+//# sourceMappingURL=serve.d.ts.map

package/dist/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAW,UAAU,EAAc,MAAM,kBAAkB,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,KAAK;IACrC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,kCAAkC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,EAAE,EAC5B,QAAQ,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EACzB,UAAS,YAAY,CAAC,CAAC,CAAM,KAC5B,IAsBF,CAAA"}

package/dist/serve.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serve = void 0;
+const effect_1 = require("effect");
+const platform_1 = require("@effect/platform");
+const platform_bun_1 = require("@effect/platform-bun");
+/**
+ * Start a Bun HTTP server with the given router.
+ *
+ * This is the main entry point for running a GraphQL server on Bun.
+ * It handles all the Effect runtime setup and server lifecycle.
+ *
+ * @param router - The HttpRouter to serve (typically from makeGraphQLRouter or toRouter)
+ * @param layer - Layer providing the router's service dependencies
+ * @param options - Server configuration options
+ *
+ * @example
+ * ```typescript
+ * import { makeGraphQLRouter } from "@effect-gql/core"
+ * import { serve } from "@effect-gql/bun"
+ *
+ * const schema = GraphQLSchemaBuilder.empty
+ *   .query("hello", { type: S.String, resolve: () => Effect.succeed("world") })
+ *   .buildSchema()
+ *
+ * const router = makeGraphQLRouter(schema, Layer.empty, { graphiql: true })
+ *
+ * // Without subscriptions
+ * serve(router, serviceLayer, {
+ *   port: 4000,
+ *   onStart: (url) => console.log(`Server running at ${url}`)
+ * })
+ *
+ * // With subscriptions
+ * serve(router, serviceLayer, {
+ *   port: 4000,
+ *   subscriptions: { schema },
+ *   onStart: (url) => console.log(`Server running at ${url}`)
+ * })
+ * ```
+ */
+const serve = (router, layer, options = {}) => {
+    const { port = 4000, host = "0.0.0.0", onStart, subscriptions } = options;
+    if (subscriptions) {
+        // With WebSocket subscriptions - use Bun.serve() directly
+        serveWithSubscriptions(router, layer, port, host, subscriptions, onStart);
+    }
+    else {
+        // Without subscriptions - use the standard Effect approach
+        const app = router.pipe(effect_1.Effect.catchAllCause((cause) => effect_1.Effect.die(cause)), platform_1.HttpServer.serve());
+        const serverLayer = platform_bun_1.BunHttpServer.layer({ port });
+        const fullLayer = effect_1.Layer.merge(serverLayer, layer);
+        if (onStart) {
+            onStart(`http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+        }
+        platform_bun_1.BunRuntime.runMain(effect_1.Layer.launch(effect_1.Layer.provide(app, fullLayer)));
+    }
+};
+exports.serve = serve;
+/**
+ * Internal implementation for serving with WebSocket subscriptions.
+ * Uses Bun.serve() directly to enable WebSocket support.
+ */
+function serveWithSubscriptions(router, layer, port, host, subscriptions, onStart) {
+    // Dynamically import ws module to keep it optional
+    const importWs = effect_1.Effect.tryPromise({
+        try: () => Promise.resolve().then(() => __importStar(require("./ws"))),
+        catch: (error) => error,
+    });
+    effect_1.Effect.runPromise(importWs.pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.logError("Failed to load WebSocket support", error).pipe(effect_1.Effect.andThen(effect_1.Effect.sync(() => process.exit(1))), effect_1.Effect.andThen(effect_1.Effect.fail(error)))))).then(({ createBunWSHandlers }) => {
+        // Create the web handler from the Effect router
+        const { handler } = platform_1.HttpApp.toWebHandlerLayer(router, layer);
+        // Create WebSocket handlers
+        const { upgrade, websocket } = createBunWSHandlers(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,
+        });
+        // Start Bun server with WebSocket support
+        const server = Bun.serve({
+            port,
+            hostname: host,
+            fetch: async (request, server) => {
+                // Try WebSocket upgrade first
+                if (upgrade(request, server)) {
+                    return new Response(null, { status: 101 });
+                }
+                // Handle HTTP requests
+                return handler(request);
+            },
+            websocket,
+        });
+        if (onStart) {
+            onStart(`http://${host === "0.0.0.0" ? "localhost" : host}:${port}`);
+        }
+        // Handle shutdown
+        process.on("SIGINT", () => {
+            server.stop();
+            process.exit(0);
+        });
+        process.on("SIGTERM", () => {
+            server.stop();
+            process.exit(0);
+        });
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"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"}

package/dist/sse.d.ts

@@ -0,0 +1,89 @@
+import { Layer } from "effect";
+import { GraphQLSchema } from "graphql";
+import { type GraphQLSSEOptions } from "@effect-gql/core";
+/**
+ * Options for Bun SSE handler
+ */
+export interface BunSSEOptions<R> extends GraphQLSSEOptions<R> {
+    /**
+     * Path for SSE connections.
+     * @default "/graphql/stream"
+     */
+    readonly path?: string;
+}
+/**
+ * Create an SSE handler for Bun.serve().
+ *
+ * This function creates a handler that returns a streaming Response for SSE
+ * subscription requests. It's designed to integrate with Bun.serve()'s fetch handler.
+ *
+ * @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 A function that handles SSE requests and returns a Response
+ *
+ * @example
+ * ```typescript
+ * const sseHandler = createBunSSEHandler(schema, serviceLayer, {
+ *   path: "/graphql/stream",
+ * })
+ *
+ * Bun.serve({
+ *   port: 4000,
+ *   fetch(req, server) {
+ *     const url = new URL(req.url)
+ *
+ *     // Handle SSE subscriptions
+ *     if (url.pathname === "/graphql/stream" && req.method === "POST") {
+ *       return sseHandler(req)
+ *     }
+ *
+ *     // Handle other requests...
+ *   },
+ * })
+ * ```
+ */
+export declare const createBunSSEHandler: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: BunSSEOptions<R>) => ((request: Request) => Promise<Response>);
+/**
+ * Create SSE handlers that integrate with Bun.serve().
+ *
+ * This returns an object with methods to check if a request should be
+ * handled as SSE and to handle it.
+ *
+ * @param schema - The GraphQL schema with subscription definitions
+ * @param layer - Effect layer providing services required by resolvers
+ * @param options - Optional lifecycle hooks and configuration
+ *
+ * @example
+ * ```typescript
+ * const { upgrade: wsUpgrade, websocket } = createBunWSHandlers(schema, layer)
+ * const sse = createBunSSEHandlers(schema, layer)
+ *
+ * Bun.serve({
+ *   port: 4000,
+ *   fetch(req, server) {
+ *     // Try WebSocket upgrade first
+ *     if (wsUpgrade(req, server)) {
+ *       return
+ *     }
+ *
+ *     // Try SSE subscriptions
+ *     if (sse.shouldHandle(req)) {
+ *       return sse.handle(req)
+ *     }
+ *
+ *     // Handle other requests...
+ *   },
+ *   websocket,
+ * })
+ * ```
+ */
+export declare const createBunSSEHandlers: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: BunSSEOptions<R>) => {
+    /** Path this SSE handler responds to */
+    readonly path: string;
+    /** Check if a request should be handled as SSE */
+    shouldHandle: (request: Request) => boolean;
+    /** Handle an SSE request */
+    handle: (request: Request) => Promise<Response>;
+};
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAU,MAAM,QAAQ,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAA;AAEzB;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,EACnC,QAAQ,aAAa,EACrB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,UAAU,aAAa,CAAC,CAAC,CAAC,KACzB,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAgE1C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EACpC,QAAQ,aAAa,EACrB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,UAAU,aAAa,CAAC,CAAC,CAAC,KACzB;IACD,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kDAAkD;IAClD,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAA;IAC3C,4BAA4B;IAC5B,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAchD,CAAA"}

package/dist/sse.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBunSSEHandlers = exports.createBunSSEHandler = void 0;
+const effect_1 = require("effect");
+const core_1 = require("@effect-gql/core");
+/**
+ * Create an SSE handler for Bun.serve().
+ *
+ * This function creates a handler that returns a streaming Response for SSE
+ * subscription requests. It's designed to integrate with Bun.serve()'s fetch handler.
+ *
+ * @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 A function that handles SSE requests and returns a Response
+ *
+ * @example
+ * ```typescript
+ * const sseHandler = createBunSSEHandler(schema, serviceLayer, {
+ *   path: "/graphql/stream",
+ * })
+ *
+ * Bun.serve({
+ *   port: 4000,
+ *   fetch(req, server) {
+ *     const url = new URL(req.url)
+ *
+ *     // Handle SSE subscriptions
+ *     if (url.pathname === "/graphql/stream" && req.method === "POST") {
+ *       return sseHandler(req)
+ *     }
+ *
+ *     // Handle other requests...
+ *   },
+ * })
+ * ```
+ */
+const createBunSSEHandler = (schema, layer, options) => {
+    const sseHandler = (0, core_1.makeGraphQLSSEHandler)(schema, layer, options);
+    return async (request) => {
+        // Check Accept header for SSE support
+        const accept = request.headers.get("accept") ?? "";
+        if (!accept.includes("text/event-stream") && !accept.includes("*/*")) {
+            return new Response(JSON.stringify({
+                errors: [{ message: "Client must accept text/event-stream" }],
+            }), { status: 406, headers: { "Content-Type": "application/json" } });
+        }
+        // Read and parse the request body
+        let subscriptionRequest;
+        try {
+            const body = (await request.json());
+            if (typeof body.query !== "string") {
+                throw new Error("Missing query");
+            }
+            subscriptionRequest = {
+                query: body.query,
+                variables: body.variables,
+                operationName: body.operationName,
+                extensions: body.extensions,
+            };
+        }
+        catch {
+            return new Response(JSON.stringify({
+                errors: [{ message: "Invalid GraphQL request body" }],
+            }), { status: 400, headers: { "Content-Type": "application/json" } });
+        }
+        // Get the event stream
+        const eventStream = sseHandler(subscriptionRequest, request.headers);
+        // Create a ReadableStream from the Effect Stream
+        const readableStream = new ReadableStream({
+            async start(controller) {
+                const encoder = new TextEncoder();
+                await effect_1.Effect.runPromise(effect_1.Stream.runForEach(eventStream, (event) => effect_1.Effect.sync(() => {
+                    const message = (0, core_1.formatSSEMessage)(event);
+                    controller.enqueue(encoder.encode(message));
+                })).pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.logWarning("SSE stream error", error)), effect_1.Effect.ensuring(effect_1.Effect.sync(() => controller.close()))));
+            },
+        });
+        return new Response(readableStream, {
+            status: 200,
+            headers: core_1.SSE_HEADERS,
+        });
+    };
+};
+exports.createBunSSEHandler = createBunSSEHandler;
+/**
+ * Create SSE handlers that integrate with Bun.serve().
+ *
+ * This returns an object with methods to check if a request should be
+ * handled as SSE and to handle it.
+ *
+ * @param schema - The GraphQL schema with subscription definitions
+ * @param layer - Effect layer providing services required by resolvers
+ * @param options - Optional lifecycle hooks and configuration
+ *
+ * @example
+ * ```typescript
+ * const { upgrade: wsUpgrade, websocket } = createBunWSHandlers(schema, layer)
+ * const sse = createBunSSEHandlers(schema, layer)
+ *
+ * Bun.serve({
+ *   port: 4000,
+ *   fetch(req, server) {
+ *     // Try WebSocket upgrade first
+ *     if (wsUpgrade(req, server)) {
+ *       return
+ *     }
+ *
+ *     // Try SSE subscriptions
+ *     if (sse.shouldHandle(req)) {
+ *       return sse.handle(req)
+ *     }
+ *
+ *     // Handle other requests...
+ *   },
+ *   websocket,
+ * })
+ * ```
+ */
+const createBunSSEHandlers = (schema, layer, options) => {
+    const path = options?.path ?? "/graphql/stream";
+    const handler = (0, exports.createBunSSEHandler)(schema, layer, options);
+    return {
+        path,
+        shouldHandle: (request) => {
+            if (request.method !== "POST")
+                return false;
+            const url = new URL(request.url);
+            return url.pathname === path;
+        },
+        handle: handler,
+    };
+};
+exports.createBunSSEHandlers = createBunSSEHandlers;
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"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"}

package/dist/ws.d.ts

@@ -0,0 +1,78 @@
+import { Effect, Queue, Deferred, Layer } from "effect";
+import { GraphQLSchema } from "graphql";
+import { type EffectWebSocket, type GraphQLWSOptions, WebSocketError, type CloseEvent } from "@effect-gql/core";
+import type { Server, ServerWebSocket } from "bun";
+/**
+ * Data attached to each WebSocket connection
+ */
+interface WebSocketData {
+    messageQueue: Queue.Queue<string>;
+    closedDeferred: Deferred.Deferred<CloseEvent, WebSocketError>;
+    effectSocket: EffectWebSocket;
+}
+/**
+ * Options for Bun WebSocket server
+ */
+export interface BunWSOptions<R> extends GraphQLWSOptions<R> {
+    /**
+     * Path for WebSocket connections.
+     * @default "/graphql"
+     */
+    readonly path?: string;
+}
+/**
+ * Create WebSocket handlers for Bun.serve().
+ *
+ * Bun has built-in WebSocket support that's configured as part of Bun.serve().
+ * This function returns the handlers needed to integrate GraphQL subscriptions.
+ *
+ * @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 containing upgrade check and WebSocket handlers
+ *
+ * @example
+ * ```typescript
+ * const { upgrade, websocket } = createBunWSHandlers(schema, serviceLayer)
+ *
+ * Bun.serve({
+ *   port: 4000,
+ *   fetch(req, server) {
+ *     // Try WebSocket upgrade first
+ *     if (upgrade(req, server)) {
+ *       return // Upgraded to WebSocket
+ *     }
+ *     // Handle HTTP requests...
+ *   },
+ *   websocket,
+ * })
+ * ```
+ */
+export declare const createBunWSHandlers: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: BunWSOptions<R>) => {
+    /**
+     * Check if request should upgrade to WebSocket and perform upgrade.
+     * Returns true if upgraded, false otherwise.
+     */
+    upgrade: (request: Request, server: Server<WebSocketData>) => boolean;
+    /**
+     * WebSocket event handlers for Bun.serve()
+     */
+    websocket: {
+        open: (ws: ServerWebSocket<WebSocketData>) => void;
+        message: (ws: ServerWebSocket<WebSocketData>, message: string | Buffer) => void;
+        close: (ws: ServerWebSocket<WebSocketData>, code: number, reason: string) => void;
+        error: (ws: ServerWebSocket<WebSocketData>, error: Error) => void;
+    };
+};
+/**
+ * Convert a Bun ServerWebSocket to an EffectWebSocket.
+ *
+ * This is a lower-level utility for custom WebSocket handling.
+ * Most users should use createBunWSHandlers() instead.
+ *
+ * @param ws - The Bun ServerWebSocket instance
+ * @returns An EffectWebSocket that can be used with makeGraphQLWSHandler
+ */
+export declare const toBunEffectWebSocket: (ws: ServerWebSocket<WebSocketData>) => Effect.Effect<EffectWebSocket, never, never>;
+export {};
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,cAAc,EACd,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,CAAA;AAElD;;GAEG;AACH,UAAU,aAAa;IACrB,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACjC,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAC7D,YAAY,EAAE,eAAe,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,EACnC,QAAQ,aAAa,EACrB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,UAAU,YAAY,CAAC,CAAC,CAAC,KACxB;IACD;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,OAAO,CAAA;IACrE;;OAEG;IACH,SAAS,EAAE;QACT,IAAI,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;QAClD,OAAO,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;QAC/E,KAAK,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;QACjF,KAAK,EAAE,CAAC,EAAE,EAAE,eAAe,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KAClE,CAAA;CA0HF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,IAAI,eAAe,CAAC,aAAa,CAAC,KACjC,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAkC1C,CAAA"}