@effect-gql/core 0.1.0 → 1.1.0

package/dist/server/sse-adapter.js

@@ -1,227 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeGraphQLSSEHandler = exports.makeSSESubscriptionStream = void 0;
-const effect_1 = require("effect");
-const graphql_1 = require("graphql");
-const sse_types_1 = require("./sse-types");
-const complexity_1 = require("./complexity");
-/**
- * Create a subscription event stream for SSE.
- *
- * This function handles the GraphQL subscription lifecycle:
- * 1. Parse and validate the query
- * 2. Check complexity limits if configured
- * 3. Execute the subscription
- * 4. Stream results as SSE events
- *
- * @param schema - The GraphQL schema with subscription definitions
- * @param layer - Effect layer providing services required by resolvers
- * @param request - The subscription request (query, variables, operationName)
- * @param headers - HTTP headers from the request (for auth)
- * @param options - Optional lifecycle hooks and configuration
- * @returns A Stream of SSE events to send to the client
- *
- * @example
- * ```typescript
- * const eventStream = makeSSESubscriptionStream(
- *   schema,
- *   serviceLayer,
- *   { query: "subscription { tick { count } }" },
- *   new Headers(),
- *   { onConnect: (req, headers) => Effect.succeed({ user: "alice" }) }
- * )
- *
- * // In platform-specific code, consume and send events:
- * Stream.runForEach(eventStream, (event) =>
- *   Effect.sync(() => res.write(formatSSEMessage(event)))
- * )
- * ```
- */
-const makeSSESubscriptionStream = (schema, layer, request, headers, options) => {
-    const complexityConfig = options?.complexity;
-    const fieldComplexities = options?.fieldComplexities ?? new Map();
-    return effect_1.Stream.unwrap(effect_1.Effect.gen(function* () {
-        // Create a runtime from the layer
-        const runtime = yield* effect_1.Effect.provide(effect_1.Effect.runtime(), layer);
-        // Run onConnect hook if provided
-        let connectionContext = {};
-        if (options?.onConnect) {
-            try {
-                connectionContext = yield* effect_1.Effect.provide(options.onConnect(request, headers), layer);
-            }
-            catch {
-                // Connection rejected
-                return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)([
-                    new graphql_1.GraphQLError("Subscription connection rejected", {
-                        extensions: { code: "CONNECTION_REJECTED" },
-                    }),
-                ]), (0, sse_types_1.formatCompleteEvent)());
-            }
-        }
-        // Parse the query
-        let document;
-        try {
-            document = (0, graphql_1.parse)(request.query);
-        }
-        catch (syntaxError) {
-            return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)([syntaxError]), (0, sse_types_1.formatCompleteEvent)());
-        }
-        // Validate the query
-        const validationErrors = (0, graphql_1.validate)(schema, document);
-        if (validationErrors.length > 0) {
-            return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)(validationErrors), (0, sse_types_1.formatCompleteEvent)());
-        }
-        // Find the subscription operation
-        const operations = document.definitions.filter((d) => d.kind === graphql_1.Kind.OPERATION_DEFINITION);
-        const operation = request.operationName
-            ? operations.find((o) => o.name?.value === request.operationName)
-            : operations[0];
-        if (!operation) {
-            return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)([new graphql_1.GraphQLError("No operation found in query")]), (0, sse_types_1.formatCompleteEvent)());
-        }
-        if (operation.operation !== "subscription") {
-            return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)([
-                new graphql_1.GraphQLError(`SSE endpoint only supports subscriptions, received: ${operation.operation}`, { extensions: { code: "OPERATION_NOT_SUPPORTED" } }),
-            ]), (0, sse_types_1.formatCompleteEvent)());
-        }
-        // Validate complexity if configured
-        if (complexityConfig) {
-            const complexityResult = yield* (0, complexity_1.validateComplexity)(request.query, request.operationName, request.variables, schema, fieldComplexities, complexityConfig).pipe(effect_1.Effect.map(() => null), effect_1.Effect.catchAll((error) => {
-                if (error._tag === "ComplexityLimitExceededError") {
-                    return effect_1.Effect.succeed(new graphql_1.GraphQLError(error.message, {
-                        extensions: {
-                            code: "COMPLEXITY_LIMIT_EXCEEDED",
-                            limitType: error.limitType,
-                            limit: error.limit,
-                            actual: error.actual,
-                        },
-                    }));
-                }
-                // Log analysis errors but don't block (fail open)
-                return effect_1.Effect.logWarning("Complexity analysis failed for SSE subscription", error).pipe(effect_1.Effect.map(() => null));
-            }));
-            if (complexityResult) {
-                return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)([complexityResult]), (0, sse_types_1.formatCompleteEvent)());
-            }
-        }
-        // Build the context for the subscription
-        const ctx = {
-            runtime,
-            request,
-            connectionContext,
-        };
-        // Call onSubscribe hook if provided
-        if (options?.onSubscribe) {
-            yield* effect_1.Effect.provide(options.onSubscribe(ctx), layer).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.void));
-        }
-        // Execute the subscription
-        const graphqlContext = {
-            runtime,
-            ...connectionContext,
-        };
-        const subscriptionResult = yield* effect_1.Effect.tryPromise({
-            try: () => (0, graphql_1.subscribe)({
-                schema,
-                document,
-                variableValues: request.variables,
-                operationName: request.operationName ?? undefined,
-                contextValue: graphqlContext,
-            }),
-            catch: (error) => new sse_types_1.SSEError({ cause: error }),
-        });
-        // Check if subscribe returned an error result instead of async iterator
-        if (!isAsyncIterable(subscriptionResult)) {
-            // It's an ExecutionResult with errors
-            const result = subscriptionResult;
-            if (result.errors) {
-                return effect_1.Stream.make((0, sse_types_1.formatErrorEvent)(result.errors), (0, sse_types_1.formatCompleteEvent)());
-            }
-            // Shouldn't happen, but handle gracefully
-            return effect_1.Stream.make((0, sse_types_1.formatNextEvent)(result), (0, sse_types_1.formatCompleteEvent)());
-        }
-        // Create a stream from the async iterator
-        const asyncIterator = subscriptionResult[Symbol.asyncIterator]();
-        const eventStream = effect_1.Stream.async((emit) => {
-            let done = false;
-            const iterate = async () => {
-                try {
-                    while (!done) {
-                        const result = await asyncIterator.next();
-                        if (result.done) {
-                            emit.end();
-                            break;
-                        }
-                        emit.single((0, sse_types_1.formatNextEvent)(result.value));
-                    }
-                }
-                catch (error) {
-                    if (!done) {
-                        emit.single((0, sse_types_1.formatErrorEvent)([
-                            error instanceof graphql_1.GraphQLError
-                                ? error
-                                : new graphql_1.GraphQLError(error instanceof Error ? error.message : "Subscription error", { extensions: { code: "SUBSCRIPTION_ERROR" } }),
-                        ]));
-                        emit.end();
-                    }
-                }
-            };
-            iterate();
-            // Return cleanup function
-            return effect_1.Effect.sync(() => {
-                done = true;
-                asyncIterator.return?.();
-            });
-        });
-        // Add complete event at the end and handle cleanup
-        return eventStream.pipe(effect_1.Stream.onDone(() => effect_1.Effect.gen(function* () {
-            yield* effect_1.Effect.sync(() => { });
-        }).pipe(effect_1.Effect.asVoid)), effect_1.Stream.concat(effect_1.Stream.make((0, sse_types_1.formatCompleteEvent)())), effect_1.Stream.onDone(() => {
-            if (options?.onComplete) {
-                return effect_1.Effect.provide(options.onComplete(ctx), layer).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.void));
-            }
-            return effect_1.Effect.void;
-        }));
-    }).pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.succeed(effect_1.Stream.make((0, sse_types_1.formatErrorEvent)([
-        new graphql_1.GraphQLError(error instanceof Error ? error.message : "Internal error", {
-            extensions: { code: "INTERNAL_ERROR" },
-        }),
-    ]), (0, sse_types_1.formatCompleteEvent)())))));
-};
-exports.makeSSESubscriptionStream = makeSSESubscriptionStream;
-/**
- * Create an SSE subscription handler that can be used with platform-specific servers.
- *
- * This is a higher-level API that returns a handler function. The handler
- * takes a request and headers, and returns a Stream of SSE events.
- *
- * @param schema - The GraphQL schema with subscription definitions
- * @param layer - Effect layer providing services required by resolvers
- * @param options - Optional lifecycle hooks and configuration
- * @returns A handler function for SSE subscription requests
- *
- * @example
- * ```typescript
- * const handler = makeGraphQLSSEHandler(schema, serviceLayer, {
- *   onConnect: (request, headers) => Effect.gen(function* () {
- *     const token = headers.get("authorization")
- *     const user = yield* AuthService.validateToken(token)
- *     return { user }
- *   }),
- * })
- *
- * // In platform-specific code:
- * const events = handler(request, headers)
- * // Stream events to client...
- * ```
- */
-const makeGraphQLSSEHandler = (schema, layer, options) => {
-    return (request, headers) => (0, exports.makeSSESubscriptionStream)(schema, layer, request, headers, options);
-};
-exports.makeGraphQLSSEHandler = makeGraphQLSSEHandler;
-/**
- * Type guard to check if a value is an AsyncIterable (subscription result)
- */
-function isAsyncIterable(value) {
-    return typeof value === "object" && value !== null && Symbol.asyncIterator in value;
-}
-//# sourceMappingURL=sse-adapter.js.map

package/dist/server/sse-adapter.js.map

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

package/dist/server/sse-types.d.ts

@@ -1,192 +0,0 @@
-import { Effect, Runtime, Stream } from "effect";
-import type { ExecutionResult } from "graphql";
-import type { ComplexityConfig, FieldComplexityMap } from "./complexity";
-/**
- * Standard SSE response headers following the graphql-sse protocol.
- * Use these headers when writing SSE responses in platform adapters.
- */
-export declare const SSE_HEADERS: Record<string, string>;
-declare const SSEError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
-    readonly _tag: "SSEError";
-} & Readonly<A>;
-/**
- * Error type for SSE operations
- */
-export declare class SSEError extends SSEError_base<{
-    readonly cause: unknown;
-}> {
-}
-/**
- * SSE event types following the graphql-sse protocol (distinct connections mode).
- * @see https://github.com/enisdenjo/graphql-sse/blob/master/PROTOCOL.md
- */
-export type SSEEventType = "next" | "error" | "complete";
-/**
- * An SSE event to be sent to the client.
- */
-export interface SSEEvent {
-    readonly event: SSEEventType;
-    readonly data: string;
-}
-/**
- * Platform-neutral SSE response interface using Effect types.
- *
- * This interface abstracts SSE operations across different platforms
- * (Node.js, Bun, Deno, Workers). Platform packages implement this
- * interface to bridge their specific HTTP response implementations.
- *
- * Unlike WebSocket which is bidirectional, SSE is unidirectional
- * (server to client only). The subscription query is provided
- * upfront when creating the SSE connection.
- */
-export interface EffectSSE {
-    /**
-     * Send an SSE event to the client.
-     * The platform adapter formats this as proper SSE format:
-     * ```
-     * event: next
-     * data: {"data":{"field":"value"}}
-     *
-     * ```
-     */
-    readonly sendEvent: (event: SSEEvent) => Effect.Effect<void, SSEError>;
-    /**
-     * Effect that completes when the client disconnects.
-     * Use this to detect client disconnection and cleanup.
-     */
-    readonly closed: Effect.Effect<void, SSEError>;
-}
-/**
- * The GraphQL request payload for SSE subscriptions.
- * Same as a regular GraphQL HTTP request.
- */
-export interface SSESubscriptionRequest {
-    readonly query: string;
-    readonly variables?: Record<string, unknown>;
-    readonly operationName?: string;
-    readonly extensions?: Record<string, unknown>;
-}
-/**
- * Context available during an SSE subscription.
- * This is passed to lifecycle hooks.
- */
-export interface SSEConnectionContext<R> {
-    /**
-     * The Effect runtime for this connection.
-     * Use this to run Effects within the connection scope.
-     */
-    readonly runtime: Runtime.Runtime<R>;
-    /**
-     * The original subscription request.
-     */
-    readonly request: SSESubscriptionRequest;
-    /**
-     * Optional authentication/authorization context.
-     * Populated by the onConnect hook.
-     */
-    readonly connectionContext: Record<string, unknown>;
-}
-/**
- * Options for configuring the GraphQL SSE handler.
- *
- * @template R - Service requirements for lifecycle hooks
- */
-export interface GraphQLSSEOptions<R> {
-    /**
-     * Query complexity limiting configuration.
-     * When provided, subscriptions are validated against complexity limits
-     * before execution begins.
-     */
-    readonly complexity?: ComplexityConfig;
-    /**
-     * Field complexity definitions from the schema builder.
-     * If using the platform serve() functions, this is typically
-     * passed automatically.
-     */
-    readonly fieldComplexities?: FieldComplexityMap;
-    /**
-     * Called before a subscription starts.
-     *
-     * Use this for authentication/authorization. Return:
-     * - A context object to accept the subscription
-     * - Throw/fail to reject the subscription
-     *
-     * The returned object is available in the GraphQL context.
-     *
-     * @example
-     * ```typescript
-     * onConnect: (request, headers) => Effect.gen(function* () {
-     *   const token = headers.get("authorization")
-     *   const user = yield* AuthService.validateToken(token)
-     *   return { user } // Available in GraphQL context
-     * })
-     * ```
-     */
-    readonly onConnect?: (request: SSESubscriptionRequest, headers: Headers) => Effect.Effect<Record<string, unknown>, unknown, R>;
-    /**
-     * Called when the subscription starts streaming.
-     */
-    readonly onSubscribe?: (ctx: SSEConnectionContext<R>) => Effect.Effect<void, never, R>;
-    /**
-     * Called when the subscription completes (normally or due to error).
-     */
-    readonly onComplete?: (ctx: SSEConnectionContext<R>) => Effect.Effect<void, never, R>;
-    /**
-     * Called when the client disconnects.
-     */
-    readonly onDisconnect?: (ctx: SSEConnectionContext<R>) => Effect.Effect<void, never, R>;
-    /**
-     * Called when an error occurs during subscription execution.
-     */
-    readonly onError?: (ctx: SSEConnectionContext<R>, error: unknown) => Effect.Effect<void, never, R>;
-}
-/**
- * Configuration for the SSE endpoint
- */
-export interface GraphQLSSEConfig {
-    /**
-     * Path for SSE connections.
-     * @default "/graphql/stream"
-     */
-    readonly path?: string;
-}
-/**
- * Result of SSE subscription handler creation.
- * This is used by platform packages to implement their SSE response.
- */
-export interface SSESubscriptionResult {
-    /**
-     * Stream of SSE events to send to the client.
-     * The platform adapter should consume this stream and send events.
-     */
-    readonly events: Stream.Stream<SSEEvent, SSEError>;
-    /**
-     * Effect that should be run when client disconnects.
-     * This allows cleanup of resources.
-     */
-    readonly cleanup: Effect.Effect<void, never, never>;
-}
-/**
- * Format an ExecutionResult as an SSE "next" event.
- */
-export declare const formatNextEvent: (result: ExecutionResult) => SSEEvent;
-/**
- * Format errors as an SSE "error" event.
- */
-export declare const formatErrorEvent: (errors: readonly unknown[]) => SSEEvent;
-/**
- * Format a "complete" event.
- */
-export declare const formatCompleteEvent: () => SSEEvent;
-/**
- * Format an SSE event to the wire format.
- * Each event is formatted as:
- * ```
- * event: <type>
- * data: <json>
- *
- * ```
- */
-export declare const formatSSEMessage: (event: SSEEvent) => string;
-export {};
-//# sourceMappingURL=sse-types.d.ts.map

package/dist/server/sse-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse-types.d.ts","sourceRoot":"","sources":["../../src/server/sse-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAExE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrC,CAAA;;;;AAEV;;GAEG;AACH,qBAAa,QAAS,SAAQ,cAA6B;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;AAEL;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAEtE;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAEpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAA;IAExC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;IAE/C;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CACnB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,OAAO,KACb,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IAEvD;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAEtF;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAErF;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAEvF;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;CACnG;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAElD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;CACpD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,eAAe,KAAG,QAGxD,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,OAAO,EAAE,KAAG,QAG5D,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO,QAGrC,CAAA;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,KAAG,MAOlD,CAAA"}

package/dist/server/sse-types.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatSSEMessage = exports.formatCompleteEvent = exports.formatErrorEvent = exports.formatNextEvent = exports.SSEError = exports.SSE_HEADERS = void 0;
-const effect_1 = require("effect");
-/**
- * Standard SSE response headers following the graphql-sse protocol.
- * Use these headers when writing SSE responses in platform adapters.
- */
-exports.SSE_HEADERS = {
-    "Content-Type": "text/event-stream",
-    "Cache-Control": "no-cache",
-    Connection: "keep-alive",
-    "X-Accel-Buffering": "no", // Disable nginx buffering
-};
-/**
- * Error type for SSE operations
- */
-class SSEError extends effect_1.Data.TaggedError("SSEError") {
-}
-exports.SSEError = SSEError;
-/**
- * Format an ExecutionResult as an SSE "next" event.
- */
-const formatNextEvent = (result) => ({
-    event: "next",
-    data: JSON.stringify(result),
-});
-exports.formatNextEvent = formatNextEvent;
-/**
- * Format errors as an SSE "error" event.
- */
-const formatErrorEvent = (errors) => ({
-    event: "error",
-    data: JSON.stringify({ errors }),
-});
-exports.formatErrorEvent = formatErrorEvent;
-/**
- * Format a "complete" event.
- */
-const formatCompleteEvent = () => ({
-    event: "complete",
-    data: "",
-});
-exports.formatCompleteEvent = formatCompleteEvent;
-/**
- * Format an SSE event to the wire format.
- * Each event is formatted as:
- * ```
- * event: <type>
- * data: <json>
- *
- * ```
- */
-const formatSSEMessage = (event) => {
-    const lines = [`event: ${event.event}`];
-    if (event.data) {
-        lines.push(`data: ${event.data}`);
-    }
-    lines.push("", ""); // Two newlines to end the event
-    return lines.join("\n");
-};
-exports.formatSSEMessage = formatSSEMessage;
-//# sourceMappingURL=sse-types.js.map

package/dist/server/sse-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sse-types.js","sourceRoot":"","sources":["../../src/server/sse-types.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAItD;;;GAGG;AACU,QAAA,WAAW,GAA2B;IACjD,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,UAAU;IAC3B,UAAU,EAAE,YAAY;IACxB,mBAAmB,EAAE,IAAI,EAAE,0BAA0B;CAC7C,CAAA;AAEV;;GAEG;AACH,MAAa,QAAS,SAAQ,aAAI,CAAC,WAAW,CAAC,UAAU,CAEvD;CAAG;AAFL,4BAEK;AA6KL;;GAEG;AACI,MAAM,eAAe,GAAG,CAAC,MAAuB,EAAY,EAAE,CAAC,CAAC;IACrE,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;CAC7B,CAAC,CAAA;AAHW,QAAA,eAAe,mBAG1B;AAEF;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAA0B,EAAY,EAAE,CAAC,CAAC;IACzE,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,CAAC,CAAA;AAHW,QAAA,gBAAgB,oBAG3B;AAEF;;GAEG;AACI,MAAM,mBAAmB,GAAG,GAAa,EAAE,CAAC,CAAC;IAClD,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,EAAE;CACT,CAAC,CAAA;AAHW,QAAA,mBAAmB,uBAG9B;AAEF;;;;;;;;GAQG;AACI,MAAM,gBAAgB,GAAG,CAAC,KAAe,EAAU,EAAE;IAC1D,MAAM,KAAK,GAAG,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;IACvC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACnC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA,CAAC,gCAAgC;IACnD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAA;AAPY,QAAA,gBAAgB,oBAO5B"}

package/dist/server/ws-adapter.d.ts

@@ -1,39 +0,0 @@
-import { Effect, Layer } from "effect";
-import { GraphQLSchema } from "graphql";
-import type { EffectWebSocket, GraphQLWSOptions } from "./ws-types";
-/**
- * Create a WebSocket handler for GraphQL subscriptions using the graphql-ws protocol.
- *
- * This function creates a handler that can be used with any WebSocket implementation
- * that conforms to the EffectWebSocket interface. Platform packages (node, bun, express)
- * provide adapters that convert their native WebSocket to EffectWebSocket.
- *
- * The handler:
- * - Uses the graphql-ws protocol for client communication
- * - Creates an Effect runtime from the provided layer for each connection
- * - Executes subscriptions using GraphQL's subscribe() function
- * - Properly cleans up resources when connections close
- *
- * @param schema - The GraphQL schema with subscription definitions
- * @param layer - Effect layer providing services required by resolvers
- * @param options - Optional lifecycle hooks for connection/subscription events
- * @returns A function that handles individual WebSocket connections
- *
- * @example
- * ```typescript
- * import { makeGraphQLWSHandler } from "@effect-gql/core"
- *
- * const handler = makeGraphQLWSHandler(schema, serviceLayer, {
- *   onConnect: (params) => Effect.gen(function* () {
- *     const user = yield* AuthService.validateToken(params.authToken)
- *     return { user }
- *   }),
- * })
- *
- * // In platform-specific code:
- * const effectSocket = toEffectWebSocket(rawWebSocket)
- * await Effect.runPromise(handler(effectSocket))
- * ```
- */
-export declare const makeGraphQLWSHandler: <R>(schema: GraphQLSchema, layer: Layer.Layer<R>, options?: GraphQLWSOptions<R>) => ((socket: EffectWebSocket) => Effect.Effect<void, never, never>);
-//# sourceMappingURL=ws-adapter.d.ts.map

package/dist/server/ws-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ws-adapter.d.ts","sourceRoot":"","sources":["../../src/server/ws-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAA2C,MAAM,QAAQ,CAAA;AAC/E,OAAO,EAAE,aAAa,EAA2B,MAAM,SAAS,CAAA;AAGhE,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAIjB,MAAM,YAAY,CAAA;AAuQnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EACpC,QAAQ,aAAa,EACrB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB,UAAU,gBAAgB,CAAC,CAAC,CAAC,KAC5B,CAAC,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CA2CjE,CAAA"}