@effect-gql/node 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/config.d.ts

@@ -0,0 +1,43 @@
+import { Config } from "effect";
+/**
+ * Configuration for the GraphiQL UI
+ */
+export interface GraphiQLConfig {
+    /** Path where GraphiQL UI is served (default: "/graphiql") */
+    readonly path: string;
+    /** URL where GraphiQL sends requests (default: same as graphql path) */
+    readonly endpoint: string;
+}
+/**
+ * Configuration for the GraphQL router
+ */
+export interface GraphQLRouterConfig {
+    /** Path for GraphQL endpoint (default: "/graphql") */
+    readonly path: string;
+    /** GraphiQL configuration, or false to disable */
+    readonly graphiql: false | GraphiQLConfig;
+}
+/**
+ * Default configuration values
+ */
+export declare const defaultConfig: GraphQLRouterConfig;
+/**
+ * Normalize user-provided config (which may use boolean shorthand for graphiql)
+ * into the full GraphQLRouterConfig format
+ */
+export interface GraphQLRouterConfigInput {
+    readonly path?: string;
+    readonly graphiql?: boolean | Partial<GraphiQLConfig>;
+}
+export declare const normalizeConfig: (input?: GraphQLRouterConfigInput) => GraphQLRouterConfig;
+/**
+ * Effect Config for loading GraphQL router configuration from environment variables.
+ *
+ * Environment variables:
+ * - GRAPHQL_PATH: Path for GraphQL endpoint (default: "/graphql")
+ * - GRAPHIQL_ENABLED: Enable GraphiQL UI (default: false)
+ * - GRAPHIQL_PATH: Path for GraphiQL UI (default: "/graphiql")
+ * - GRAPHIQL_ENDPOINT: URL where GraphiQL sends requests (default: same as GRAPHQL_PATH)
+ */
+export declare const GraphQLRouterConfigFromEnv: Config.Config<GraphQLRouterConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,cAAc,CAAA;CAC1C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,mBAG3B,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACtD;AAED,eAAO,MAAM,eAAe,GAC1B,QAAO,wBAA6B,KACnC,mBAcF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAsBvE,CAAA"}

package/dist/config.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphQLRouterConfigFromEnv = exports.normalizeConfig = exports.defaultConfig = void 0;
+const effect_1 = require("effect");
+/**
+ * Default configuration values
+ */
+exports.defaultConfig = {
+    path: "/graphql",
+    graphiql: false,
+};
+const normalizeConfig = (input = {}) => {
+    const path = input.path ?? exports.defaultConfig.path;
+    let graphiql = false;
+    if (input.graphiql === true) {
+        graphiql = { path: "/graphiql", endpoint: path };
+    }
+    else if (input.graphiql && typeof input.graphiql === "object") {
+        graphiql = {
+            path: input.graphiql.path ?? "/graphiql",
+            endpoint: input.graphiql.endpoint ?? path,
+        };
+    }
+    return { path, graphiql };
+};
+exports.normalizeConfig = normalizeConfig;
+/**
+ * Effect Config for loading GraphQL router configuration from environment variables.
+ *
+ * Environment variables:
+ * - GRAPHQL_PATH: Path for GraphQL endpoint (default: "/graphql")
+ * - GRAPHIQL_ENABLED: Enable GraphiQL UI (default: false)
+ * - GRAPHIQL_PATH: Path for GraphiQL UI (default: "/graphiql")
+ * - GRAPHIQL_ENDPOINT: URL where GraphiQL sends requests (default: same as GRAPHQL_PATH)
+ */
+exports.GraphQLRouterConfigFromEnv = effect_1.Config.all({
+    path: effect_1.Config.string("GRAPHQL_PATH").pipe(effect_1.Config.withDefault("/graphql")),
+    graphiqlEnabled: effect_1.Config.boolean("GRAPHIQL_ENABLED").pipe(effect_1.Config.withDefault(false)),
+    graphiqlPath: effect_1.Config.string("GRAPHIQL_PATH").pipe(effect_1.Config.withDefault("/graphiql")),
+    graphiqlEndpoint: effect_1.Config.string("GRAPHIQL_ENDPOINT").pipe(effect_1.Config.option),
+}).pipe(effect_1.Config.map(({ path, graphiqlEnabled, graphiqlPath, graphiqlEndpoint }) => ({
+    path,
+    graphiql: graphiqlEnabled
+        ? {
+            path: graphiqlPath,
+            endpoint: graphiqlEndpoint._tag === "Some"
+                ? graphiqlEndpoint.value
+                : path,
+        }
+        : false,
+})));
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA,mCAA+B;AAsB/B;;GAEG;AACU,QAAA,aAAa,GAAwB;IAChD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,KAAK;CAChB,CAAA;AAWM,MAAM,eAAe,GAAG,CAC7B,QAAkC,EAAE,EACf,EAAE;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,qBAAa,CAAC,IAAI,CAAA;IAE7C,IAAI,QAAQ,GAA2B,KAAK,CAAA;IAC5C,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5B,QAAQ,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAClD,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,QAAQ,GAAG;YACT,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,WAAW;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI;SAC1C,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC3B,CAAC,CAAA;AAhBY,QAAA,eAAe,mBAgB3B;AAED;;;;;;;;GAQG;AACU,QAAA,0BAA0B,GACrC,eAAM,CAAC,GAAG,CAAC;IACT,IAAI,EAAE,eAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,eAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACxE,eAAe,EAAE,eAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CACtD,eAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAC1B;IACD,YAAY,EAAE,eAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAC/C,eAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAChC;IACD,gBAAgB,EAAE,eAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,eAAM,CAAC,MAAM,CAAC;CACzE,CAAC,CAAC,IAAI,CACL,eAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI;IACJ,QAAQ,EAAE,eAAe;QACvB,CAAC,CAAC;YACE,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,gBAAgB,CAAC,IAAI,KAAK,MAAM;gBACxC,CAAC,CAAC,gBAAgB,CAAC,KAAK;gBACxB,CAAC,CAAC,IAAI;SACT;QACH,CAAC,CAAE,KAAe;CACrB,CAAC,CAAC,CACJ,CAAA"}

package/dist/graphiql.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate HTML for GraphiQL IDE, loading dependencies from CDN
+ */
+export declare const graphiqlHtml: (endpoint: string) => string;
+//# sourceMappingURL=graphiql.d.ts.map

package/dist/graphiql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphiql.d.ts","sourceRoot":"","sources":["../src/graphiql.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,MAkCxC,CAAA"}

package/dist/graphiql.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.graphiqlHtml = void 0;
+/**
+ * Generate HTML for GraphiQL IDE, loading dependencies from CDN
+ */
+const graphiqlHtml = (endpoint) => `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>GraphiQL</title>
+    <link
+      rel="stylesheet"
+      href="https://unpkg.com/graphiql@3/graphiql.min.css"
+    />
+  </head>
+  <body style="margin: 0; overflow: hidden;">
+    <div id="graphiql" style="height: 100vh;"></div>
+    <script
+      crossorigin
+      src="https://unpkg.com/react@18/umd/react.production.min.js"
+    ></script>
+    <script
+      crossorigin
+      src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"
+    ></script>
+    <script
+      crossorigin
+      src="https://unpkg.com/graphiql@3/graphiql.min.js"
+    ></script>
+    <script>
+      const fetcher = GraphiQL.createFetcher({
+        url: '${endpoint}',
+      });
+      ReactDOM.createRoot(document.getElementById('graphiql')).render(
+        React.createElement(GraphiQL, { fetcher })
+      );
+    </script>
+  </body>
+</html>`;
+exports.graphiqlHtml = graphiqlHtml;
+//# sourceMappingURL=graphiql.js.map

package/dist/graphiql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphiql.js","sourceRoot":"","sources":["../src/graphiql.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACI,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA2B1C,QAAQ;;;;;;;QAOhB,CAAA;AAlCK,QAAA,YAAY,gBAkCjB"}

package/dist/http-utils.d.ts

@@ -0,0 +1,20 @@
+import type { IncomingHttpHeaders } from "node:http";
+/**
+ * Convert Node.js IncomingHttpHeaders to web standard Headers.
+ *
+ * This handles the difference between Node.js headers (which can be
+ * string | string[] | undefined) and web Headers (which are always strings).
+ *
+ * @param nodeHeaders - Headers from IncomingMessage.headers
+ * @returns A web standard Headers object
+ *
+ * @example
+ * ```typescript
+ * import { toWebHeaders } from "@effect-gql/node"
+ *
+ * const webHeaders = toWebHeaders(req.headers)
+ * const auth = webHeaders.get("authorization")
+ * ```
+ */
+export declare const toWebHeaders: (nodeHeaders: IncomingHttpHeaders) => Headers;
+//# sourceMappingURL=http-utils.d.ts.map

package/dist/http-utils.d.ts.map

@@ -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;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,mBAAmB,KAAG,OAY/D,CAAA"}

package/dist/http-utils.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWebHeaders = void 0;
+/**
+ * Convert Node.js IncomingHttpHeaders to web standard Headers.
+ *
+ * This handles the difference between Node.js headers (which can be
+ * string | string[] | undefined) and web Headers (which are always strings).
+ *
+ * @param nodeHeaders - Headers from IncomingMessage.headers
+ * @returns A web standard Headers object
+ *
+ * @example
+ * ```typescript
+ * import { toWebHeaders } from "@effect-gql/node"
+ *
+ * const webHeaders = toWebHeaders(req.headers)
+ * const auth = webHeaders.get("authorization")
+ * ```
+ */
+const 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;
+};
+exports.toWebHeaders = toWebHeaders;
+//# sourceMappingURL=http-utils.js.map

package/dist/http-utils.js.map

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

@@ -0,0 +1,5 @@
+export { serve, type ServeOptions } from "./serve";
+export { toWebHeaders } from "./http-utils";
+export { toEffectWebSocket, createGraphQLWSServer, attachWebSocketToServer, type NodeWSOptions, } from "./ws";
+export { createSSEHandler, createSSEServer, type NodeSSEOptions } 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,MAAM,SAAS,CAAA;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,aAAa,GACnB,MAAM,MAAM,CAAA;AAGb,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSSEServer = exports.createSSEHandler = exports.attachWebSocketToServer = exports.createGraphQLWSServer = exports.toEffectWebSocket = exports.toWebHeaders = exports.serve = void 0;
+var serve_1 = require("./serve");
+Object.defineProperty(exports, "serve", { enumerable: true, get: function () { return serve_1.serve; } });
+// HTTP utilities
+var http_utils_1 = require("./http-utils");
+Object.defineProperty(exports, "toWebHeaders", { enumerable: true, get: function () { return http_utils_1.toWebHeaders; } });
+// WebSocket subscription support
+var ws_1 = require("./ws");
+Object.defineProperty(exports, "toEffectWebSocket", { enumerable: true, get: function () { return ws_1.toEffectWebSocket; } });
+Object.defineProperty(exports, "createGraphQLWSServer", { enumerable: true, get: function () { return ws_1.createGraphQLWSServer; } });
+Object.defineProperty(exports, "attachWebSocketToServer", { enumerable: true, get: function () { return ws_1.attachWebSocketToServer; } });
+// SSE (Server-Sent Events) subscription support
+var sse_1 = require("./sse");
+Object.defineProperty(exports, "createSSEHandler", { enumerable: true, get: function () { return sse_1.createSSEHandler; } });
+Object.defineProperty(exports, "createSSEServer", { enumerable: true, get: function () { return sse_1.createSSEServer; } });
+//# 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,iCAAkD;AAAzC,8FAAA,KAAK,OAAA;AAEd,iBAAiB;AACjB,2CAA2C;AAAlC,0GAAA,YAAY,OAAA;AAErB,iCAAiC;AACjC,2BAKa;AAJX,uGAAA,iBAAiB,OAAA;AACjB,2GAAA,qBAAqB,OAAA;AACrB,6GAAA,uBAAuB,OAAA;AAIzB,gDAAgD;AAChD,6BAA8E;AAArE,uGAAA,gBAAgB,OAAA;AAAE,sGAAA,eAAe,OAAA"}

package/dist/router.d.ts

@@ -0,0 +1,32 @@
+import { HttpRouter } from "@effect/platform";
+import { Layer } from "effect";
+import { GraphQLSchema } from "graphql";
+import { type GraphQLRouterConfigInput } from "./config";
+/**
+ * Create an HttpRouter configured for GraphQL
+ *
+ * The router handles:
+ * - POST requests to the GraphQL endpoint
+ * - GET requests to the GraphiQL UI (if enabled)
+ *
+ * @param schema - The GraphQL schema
+ * @param layer - Effect layer providing services required by resolvers
+ * @param config - Optional configuration for paths and GraphiQL
+ * @returns An HttpRouter that can be composed with other routes
+ *
+ * @example
+ * ```typescript
+ * const router = makeGraphQLRouter(schema, Layer.empty, {
+ *   path: "/graphql",
+ *   graphiql: { path: "/graphiql" }
+ * })
+ *
+ * // Compose with other routes
+ * const app = HttpRouter.empty.pipe(
+ *   HttpRouter.get("/health", HttpServerResponse.json({ status: "ok" })),
+ *   HttpRouter.concat(router)
+ * )
+ * ```
+ */
+export declare const makeGraphQLRouter: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, config?: GraphQLRouterConfigInput) => HttpRouter.HttpRouter<never, never>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,kBAAkB,CAAA;AACpF,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,aAAa,EAAW,MAAM,SAAS,CAAA;AAGhD,OAAO,EAAmB,KAAK,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,QAAQ,aAAa,EACrB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,SAAQ,wBAA6B,KACpC,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAoEpC,CAAA"}

package/dist/router.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeGraphQLRouter = void 0;
+const platform_1 = require("@effect/platform");
+const effect_1 = require("effect");
+const graphql_1 = require("graphql");
+const graphiql_1 = require("./graphiql");
+const config_1 = require("./config");
+/**
+ * Create an HttpRouter configured for GraphQL
+ *
+ * The router handles:
+ * - POST requests to the GraphQL endpoint
+ * - GET requests to the GraphiQL UI (if enabled)
+ *
+ * @param schema - The GraphQL schema
+ * @param layer - Effect layer providing services required by resolvers
+ * @param config - Optional configuration for paths and GraphiQL
+ * @returns An HttpRouter that can be composed with other routes
+ *
+ * @example
+ * ```typescript
+ * const router = makeGraphQLRouter(schema, Layer.empty, {
+ *   path: "/graphql",
+ *   graphiql: { path: "/graphiql" }
+ * })
+ *
+ * // Compose with other routes
+ * const app = HttpRouter.empty.pipe(
+ *   HttpRouter.get("/health", HttpServerResponse.json({ status: "ok" })),
+ *   HttpRouter.concat(router)
+ * )
+ * ```
+ */
+const makeGraphQLRouter = (schema, layer, config = {}) => {
+    const resolvedConfig = (0, config_1.normalizeConfig)(config);
+    // GraphQL POST handler
+    const graphqlHandler = effect_1.Effect.gen(function* () {
+        // Get the runtime from the layer
+        const runtime = yield* effect_1.Effect.runtime();
+        // Parse request body
+        const request = yield* platform_1.HttpServerRequest.HttpServerRequest;
+        const body = yield* request.json;
+        // Execute GraphQL query
+        const result = yield* effect_1.Effect.tryPromise({
+            try: () => (0, graphql_1.graphql)({
+                schema,
+                source: body.query,
+                variableValues: body.variables,
+                operationName: body.operationName,
+                contextValue: { runtime },
+            }),
+            catch: (error) => new Error(String(error)),
+        });
+        return yield* platform_1.HttpServerResponse.json(result);
+    }).pipe(effect_1.Effect.provide(layer), effect_1.Effect.catchAllCause((cause) => platform_1.HttpServerResponse.json({
+        errors: [
+            {
+                message: cause._tag === "Fail"
+                    ? cause.error instanceof Error
+                        ? cause.error.message
+                        : String(cause.error)
+                    : "Internal server error",
+            },
+        ],
+    }, { status: 400 }).pipe(effect_1.Effect.orDie)));
+    // Build router with GraphQL endpoint
+    let router = platform_1.HttpRouter.empty.pipe(platform_1.HttpRouter.post(resolvedConfig.path, graphqlHandler));
+    // Add GraphiQL route if enabled
+    if (resolvedConfig.graphiql) {
+        const { path, endpoint } = resolvedConfig.graphiql;
+        router = router.pipe(platform_1.HttpRouter.get(path, platform_1.HttpServerResponse.html((0, graphiql_1.graphiqlHtml)(endpoint))));
+    }
+    return router;
+};
+exports.makeGraphQLRouter = makeGraphQLRouter;
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":";;;AAAA,+CAAoF;AACpF,mCAAsC;AACtC,qCAAgD;AAEhD,yCAAyC;AACzC,qCAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,MAAM,iBAAiB,GAAG,CAC/B,MAAqB,EACrB,KAAqB,EACrB,SAAmC,EAAE,EACA,EAAE;IACvC,MAAM,cAAc,GAAG,IAAA,wBAAe,EAAC,MAAM,CAAC,CAAA;IAE9C,uBAAuB;IACvB,MAAM,cAAc,GAAG,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzC,iCAAiC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,OAAO,EAAK,CAAA;QAE1C,qBAAqB;QACrB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,4BAAiB,CAAC,iBAAiB,CAAA;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAI1B,CAAA;QAEF,wBAAwB;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,UAAU,CAAC;YACtC,GAAG,EAAE,GAAG,EAAE,CACR,IAAA,iBAAO,EAAC;gBACN,MAAM;gBACN,MAAM,EAAE,IAAI,CAAC,KAAK;gBAClB,cAAc,EAAE,IAAI,CAAC,SAAS;gBAC9B,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,YAAY,EAAE,EAAE,OAAO,EAAoC;aAC5D,CAAC;YACJ,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC3C,CAAC,CAAA;QAEF,OAAO,KAAK,CAAC,CAAC,6BAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAC,IAAI,CACL,eAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EACrB,eAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7B,6BAAkB,CAAC,IAAI,CACrB;QACE,MAAM,EAAE;YACN;gBACE,OAAO,EACL,KAAK,CAAC,IAAI,KAAK,MAAM;oBACnB,CAAC,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK;wBAC5B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO;wBACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;oBACvB,CAAC,CAAC,uBAAuB;aAC9B;SACF;KACF,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC,IAAI,CAAC,eAAM,CAAC,KAAK,CAAC,CACrB,CACF,CAAA;IAED,qCAAqC;IACrC,IAAI,MAAM,GAAG,qBAAU,CAAC,KAAK,CAAC,IAAI,CAChC,qBAAU,CAAC,IAAI,CAAC,cAAc,CAAC,IAA4B,EAAE,cAAc,CAAC,CAC7E,CAAA;IAED,gCAAgC;IAChC,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAA;QAClD,MAAM,GAAG,MAAM,CAAC,IAAI,CAClB,qBAAU,CAAC,GAAG,CACZ,IAA4B,EAC5B,6BAAkB,CAAC,IAAI,CAAC,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC,CAChD,CACF,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAxEY,QAAA,iBAAiB,qBAwE7B"}

package/dist/schema-builder-extensions.d.ts

@@ -0,0 +1,31 @@
+import { Layer } from "effect";
+import { HttpRouter } from "@effect/platform";
+import { GraphQLSchemaBuilder } from "@effect-gql/core";
+import type { GraphQLRouterConfigInput } from "./config";
+/**
+ * Convert a GraphQLSchemaBuilder to an HttpRouter.
+ *
+ * This is the Node.js server integration that bridges the core
+ * GraphQL schema with the @effect/platform HTTP server.
+ *
+ * @param builder - The GraphQL schema builder
+ * @param layer - Effect layer providing services required by resolvers
+ * @param config - Optional configuration for paths and GraphiQL
+ * @returns An HttpRouter that can be composed with other routes
+ *
+ * @example
+ * ```typescript
+ * import { GraphQLSchemaBuilder, query } from "@effect-gql/core"
+ * import { toRouter } from "@effect-gql/node"
+ * import { Layer } from "effect"
+ * import * as S from "effect/Schema"
+ *
+ * const builder = GraphQLSchemaBuilder.empty.pipe(
+ *   query("hello", { type: S.String, resolve: () => Effect.succeed("world") })
+ * )
+ *
+ * const router = toRouter(builder, Layer.empty, { graphiql: true })
+ * ```
+ */
+export declare const toRouter: <R, R2>(builder: GraphQLSchemaBuilder<R>, layer: Layer.Layer<R2>, config?: GraphQLRouterConfigInput) => HttpRouter.HttpRouter<never, never>;
+//# sourceMappingURL=schema-builder-extensions.d.ts.map

package/dist/schema-builder-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder-extensions.d.ts","sourceRoot":"","sources":["../src/schema-builder-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,EAAE,EAC5B,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAChC,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EACtB,SAAS,wBAAwB,KAChC,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAGpC,CAAA"}

package/dist/schema-builder-extensions.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toRouter = void 0;
+const router_1 = require("./router");
+/**
+ * Convert a GraphQLSchemaBuilder to an HttpRouter.
+ *
+ * This is the Node.js server integration that bridges the core
+ * GraphQL schema with the @effect/platform HTTP server.
+ *
+ * @param builder - The GraphQL schema builder
+ * @param layer - Effect layer providing services required by resolvers
+ * @param config - Optional configuration for paths and GraphiQL
+ * @returns An HttpRouter that can be composed with other routes
+ *
+ * @example
+ * ```typescript
+ * import { GraphQLSchemaBuilder, query } from "@effect-graphql/core"
+ * import { toRouter } from "@effect-graphql/node"
+ * import { Layer } from "effect"
+ * import * as S from "effect/Schema"
+ *
+ * const builder = GraphQLSchemaBuilder.empty.pipe(
+ *   query("hello", { type: S.String, resolve: () => Effect.succeed("world") })
+ * )
+ *
+ * const router = toRouter(builder, Layer.empty, { graphiql: true })
+ * ```
+ */
+const toRouter = (builder, layer, config) => {
+    const schema = builder.buildSchema();
+    return (0, router_1.makeGraphQLRouter)(schema, layer, config);
+};
+exports.toRouter = toRouter;
+//# sourceMappingURL=schema-builder-extensions.js.map

package/dist/schema-builder-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder-extensions.js","sourceRoot":"","sources":["../src/schema-builder-extensions.ts"],"names":[],"mappings":";;;AAGA,qCAA4C;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,MAAM,QAAQ,GAAG,CACtB,OAAgC,EAChC,KAAsB,EACtB,MAAiC,EACI,EAAE;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAA;IACpC,OAAO,IAAA,0BAAiB,EAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC,CAAA;AAPY,QAAA,QAAQ,YAOpB"}

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 Node.js 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 Node.js HTTP server with the given router.
+ *
+ * This is the main entry point for running a GraphQL server on Node.js.
+ * 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/node"
+ *
+ * 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;AAGlE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGxD;;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"}