@leaven-graphql/ws 0.1.0 → 0.2.0

package/LICENSE

@@ -175,7 +175,7 @@
 
    END OF TERMS AND CONDITIONS
 
-   Copyright 2026 Pegasus Heavy Industries LLC
+   Copyright 2026 Joseph Quinn
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -10,33 +10,60 @@ bun add @leaven-graphql/ws @leaven-graphql/core graphql
 
 ## Quick Start
 
+`createWebSocketHandler` implements the whole `graphql-ws` server: connection
+init and acknowledgement, keep-alive pings, subscription lifecycle, and the
+protocol close codes. Hand it to `Bun.serve` via `getWebSocketConfig()`.
+
 ```typescript
-import { createPubSub } from '@leaven-graphql/ws';
-import { LeavenExecutor } from '@leaven-graphql/core';
+import { createWebSocketHandler, type WebSocketContext } from '@leaven-graphql/ws';
 
-const pubsub = createPubSub();
-const executor = new LeavenExecutor({ schema });
+const handler = createWebSocketHandler({
+  schema,
+  // Optional: build the GraphQL context for every operation
+  context: (socket) => ({ user: socket.data.connectionParams?.user }),
+});
 
 Bun.serve({
   port: 4000,
   fetch(request, server) {
-    if (request.headers.get('upgrade') === 'websocket') {
-      server.upgrade(request);
+    // Bun's types require the `data` option, but the handler's `open` replaces
+    // socket.data with a fresh WebSocketContext, so nothing needs stashing.
+    if (server.upgrade(request, { data: undefined as unknown as WebSocketContext })) {
       return;
     }
     return new Response('Not Found', { status: 404 });
   },
-  websocket: {
-    message(ws, message) {
-      handleMessage(ws, message, executor, pubsub);
-    },
-    close(ws) {
-      cleanupConnection(ws);
-    },
-  },
+  websocket: handler.getWebSocketConfig(),
 });
 ```
 
+Queries and mutations are supported on the same transport: per the `graphql-ws`
+protocol, a `subscribe` frame carrying a query or mutation is answered with a
+single `next` followed by `complete`. Failures before execution (validation,
+variable coercion) come back as an `error` frame instead; resolver errors ride
+inside the `next` payload.
+
+Serving HTTP and WebSocket from one server is a matter of passing the handler
+to `@leaven-graphql/http`. Subscriptions do **not** inherit the HTTP
+executor's options, so state them for both transports — otherwise the
+longest-lived transport quietly runs on executor defaults:
+
+```typescript
+import { createServer } from '@leaven-graphql/http';
+import { createWebSocketHandler } from '@leaven-graphql/ws';
+
+const executor = { introspection: false, maxDepth: 10 };
+
+createServer({
+  schema,
+  executor,
+  websocket: createWebSocketHandler({
+    schema,
+    subscriptionManager: { executor },
+  }),
+}).start();
+```
+
 ## Features
 
 ### PubSub
@@ -114,62 +141,35 @@ const resolvers = {
 
 ### Authentication
 
-```typescript
-import { parseMessage } from '@leaven-graphql/ws';
-
-const connections = new Map();
-
-Bun.serve({
-  websocket: {
-    async message(ws, data) {
-      const message = parseMessage(data);
-
-      switch (message.type) {
-        case 'connection_init': {
-          const token = message.payload?.authToken;
-
-          try {
-            const user = await verifyToken(token);
-            connections.set(ws, { user, subscriptions: new Map() });
-            ws.send(JSON.stringify({ type: 'connection_ack' }));
-          } catch (error) {
-            ws.close(4401, 'Unauthorized');
-          }
-          break;
-        }
-
-        case 'subscribe': {
-          const connection = connections.get(ws);
-          if (!connection) {
-            ws.close(4401, 'Unauthorized');
-            return;
-          }
-          handleSubscribe(ws, message, connection.user);
-          break;
-        }
+Authenticate in `onConnect`. Returning `false` closes the socket with `4403`,
+and no `subscribe` frame is accepted before a connection is acknowledged
+(unacknowledged operations are closed with `4401`).
 
-        case 'complete': {
-          const connection = connections.get(ws);
-          connection?.subscriptions.get(message.id)?.unsubscribe();
-          connection?.subscriptions.delete(message.id);
-          break;
-        }
-      }
-    },
-
-    close(ws) {
-      const connection = connections.get(ws);
-      if (connection) {
-        for (const sub of connection.subscriptions.values()) {
-          sub.unsubscribe();
-        }
-        connections.delete(ws);
-      }
-    },
+```typescript
+import { createWebSocketHandler } from '@leaven-graphql/ws';
+
+const users = new WeakMap<object, User>();
+
+const handler = createWebSocketHandler({
+  schema,
+  async onConnect(socket, params) {
+    try {
+      users.set(socket, await verifyToken(params?.authToken as string));
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  context: (socket) => ({ user: users.get(socket) }),
+  onDisconnect(socket) {
+    users.delete(socket);
   },
 });
 ```
 
+The lifecycle hooks may be async; a hook that rejects is logged and never
+takes the connection (or the process) down with it.
+
 ### Schema Definition
 
 ```graphql
@@ -239,44 +239,289 @@ unsubscribe();
 
 ## API Reference
 
+### WebSocketHandler
+
+The `graphql-ws` server. `getWebSocketConfig()` returns the object `Bun.serve`
+expects under `websocket`.
+
+```typescript
+class WebSocketHandler<TContext = unknown> {
+  constructor(config: WebSocketHandlerConfig<TContext>);
+
+  handleOpen(socket: ServerWebSocket<WebSocketContext>): void;
+  handleMessage(
+    socket: ServerWebSocket<WebSocketContext>,
+    message: string | Buffer
+  ): Promise<void>;
+  handleClose(socket: ServerWebSocket<WebSocketContext>): Promise<void>;
+
+  getWebSocketConfig(): {
+    open: (socket: ServerWebSocket<WebSocketContext>) => void;
+    message: (
+      socket: ServerWebSocket<WebSocketContext>,
+      message: string | Buffer
+    ) => void;
+    close: (socket: ServerWebSocket<WebSocketContext>) => void;
+  };
+}
+
+function createWebSocketHandler<TContext = unknown>(
+  config: WebSocketHandlerConfig<TContext>
+): WebSocketHandler<TContext>;
+
+interface WebSocketHandlerConfig<TContext = unknown> {
+  /** GraphQL schema */
+  schema: GraphQLSchema;
+  /** Builds the GraphQL context for each operation */
+  context?: (
+    socket: ServerWebSocket<WebSocketContext>,
+    request: GraphQLRequest
+  ) => TContext | Promise<TContext>;
+  /** Close with 4408 if `connection_init` does not arrive in time (default 3000ms) */
+  connectionInitTimeout?: number;
+  /** Server ping interval; 0 disables keep-alive (default 12000ms) */
+  keepAliveInterval?: number;
+  /** Forwarded to the SubscriptionManager (minus `schema`) */
+  subscriptionManager?: Omit<SubscriptionManagerConfig, 'schema'>;
+  /** Return false to reject the connection with 4403 */
+  onConnect?: (
+    socket: ServerWebSocket<WebSocketContext>,
+    params?: Record<string, unknown>
+  ) => boolean | Promise<boolean>;
+  onDisconnect?: (socket: ServerWebSocket<WebSocketContext>) => void | Promise<void>;
+  onSubscribe?: (
+    socket: ServerWebSocket<WebSocketContext>,
+    id: string,
+    request: GraphQLRequest
+  ) => void | Promise<void>;
+  /** Called once per operation id when it reaches a terminal state */
+  onComplete?: (
+    socket: ServerWebSocket<WebSocketContext>,
+    id: string
+  ) => void | Promise<void>;
+}
+
+interface WebSocketContext {
+  /** Opaque UUIDv4 — do not parse it */
+  connectionId: string;
+  connectionParams?: Record<string, unknown>;
+  initialized: boolean;
+  subscriptions: Set<string>;
+}
+```
+
+Close codes follow the protocol: `4400` invalid message, `4401` unauthorized
+(operation before `connection_init`), `4403` rejected by `onConnect`, `4408`
+init timeout, `4409` duplicate subscription id, `4429` repeated
+`connection_init`.
+
+### SubscriptionManager
+
+Owns the executor and the per-connection subscription registry. The handler
+creates one; you only need it directly when driving subscriptions yourself.
+
+```typescript
+class SubscriptionManager {
+  constructor(config: SubscriptionManagerConfig);
+
+  subscribe<TContext = unknown>(
+    connectionId: string,
+    subscriptionId: string,
+    request: GraphQLRequest,
+    context: TContext,
+    onNext: (result: GraphQLResponse) => void,
+    onComplete: () => void,
+    onError: (errors: readonly { message: string }[]) => void
+  ): Promise<Subscription>;
+
+  /** Run a query or mutation on the same executor */
+  execute<TContext = unknown>(
+    request: GraphQLRequest,
+    context?: TContext
+  ): Promise<GraphQLResponse>;
+
+  unsubscribe(connectionId: string, subscriptionId: string): boolean;
+  unsubscribeConnection(connectionId: string): number;
+  getSubscription(connectionId: string, subscriptionId: string): Subscription | undefined;
+  getConnectionSubscriptions(connectionId: string): Subscription[];
+  clear(): void;
+
+  readonly subscriptionCount: number;
+  readonly connectionCount: number;
+}
+
+function createSubscriptionManager(config: SubscriptionManagerConfig): SubscriptionManager;
+
+interface SubscriptionManagerConfig {
+  schema: GraphQLSchema;
+  /** Default 100 */
+  maxSubscriptionsPerConnection?: number;
+  /** Complete a subscription after this many ms; 0 disables (default 0) */
+  subscriptionTimeout?: number;
+  /**
+   * Reuse an existing executor, or configure the one this manager builds.
+   * Sharing an executor with the HTTP transport avoids a second schema print
+   * and a duplicate document cache, and is the only way subscriptions inherit
+   * `introspection: false`, `maxDepth` or `maxComplexity`.
+   */
+  executor?: LeavenExecutor | Omit<ExecutorConfig, 'schema'>;
+}
+
+interface Subscription {
+  id: string;
+  connectionId: string;
+  request: GraphQLRequest;
+  status: 'pending' | 'active' | 'completed' | 'error';
+  createdAt: number;
+  iterator?: AsyncIterableIterator<GraphQLResponse>;
+  cleanup?: () => void;
+}
+```
+
+Subscription ids are scoped to a connection: `graphql-ws` clients number their
+operations per connection (starting at `"1"`), so every lookup and teardown
+takes **both** the connection id and the subscription id.
+
 ### PubSub
 
 ```typescript
-class PubSub {
-  subscribe(topic: string, callback: (payload: unknown) => void): () => void;
-  publish(topic: string, payload: unknown): void;
-  asyncIterator(topic: string | string[]): AsyncIterableIterator<unknown>;
+class PubSub implements PubSubEngine {
+  constructor(config?: PubSubConfig);
+
+  subscribe<T = unknown>(topic: string, callback: (payload: T) => void): () => void;
+  publish<T = unknown>(topic: string, payload: T): void;
+  asyncIterator<T = unknown>(topic: string | string[]): AsyncIterableIterator<T>;
+  getSubscriberCount(topic: string): number;
+  getTopics(): string[];
+  clear(): void;
 }
 
 function createPubSub(config?: PubSubConfig): PubSub;
 
 interface PubSubConfig {
-  maxSubscribers?: number;
+  /** Subscribers allowed per topic before `subscribe` throws (default 10000) */
+  maxSubscribersPerTopic?: number;
+  /** Enable `.`-segmented `*` / `#` topic patterns (default false) */
   wildcards?: boolean;
+  /**
+   * Payloads an `asyncIterator` buffers while nothing is pulling. When full,
+   * the OLDEST payload is dropped so a slow consumer sees the most recent
+   * events instead of an unbounded queue. Unlimited by default.
+   */
+  maxQueueSize?: number;
 }
 ```
 
 ### Message Handling
 
+`parseMessage` returns a parsed message object; `formatMessage` takes a message
+object and returns the string to send. The `create*` helpers build message
+objects, so they are composed with `formatMessage` rather than sent directly.
+
 ```typescript
-function parseMessage(data: string | Buffer): GraphQLWSMessage;
-function formatMessage(type: string, payload?: unknown): string;
-function createNextMessage(id: string, payload: unknown): string;
-function createErrorMessage(id: string, errors: GraphQLError[]): string;
-function createCompleteMessage(id: string): string;
+function parseMessage(data: string | Buffer, options?: ParseMessageOptions): Message;
+function formatMessage(message: Message): string;
+
+function createConnectionAck(payload?: Record<string, unknown>): ConnectionAckMessage;
+function createNextMessage(
+  id: string,
+  data: Record<string, unknown> | null | undefined,
+  errors?: readonly { message: string }[]
+): NextMessage;
+function createErrorMessage(
+  id: string,
+  errors: readonly { message: string }[]
+): ErrorMessage;
+function createCompleteMessage(id: string): CompleteMessage;
+function createPongMessage(payload?: Record<string, unknown>): PongMessage;
+
+interface ParseMessageOptions {
+  /**
+   * Require a string `id` on the types that carry one (`subscribe`, `next`,
+   * `error`, `complete`). Defaults to `true`, which is correct for a server
+   * reading client frames: an operation frame with no id cannot be routed.
+   * Pass `false` on the client, where a lenient peer may omit the id and a
+   * throw would tear down the whole connection.
+   */
+  requireId?: boolean;
+}
 ```
 
+```typescript
+import {
+  createCompleteMessage,
+  createNextMessage,
+  formatMessage,
+  parseMessage,
+} from '@leaven-graphql/ws';
+
+socket.send(formatMessage(createNextMessage('1', { hello: 'world' })));
+socket.send(formatMessage(createCompleteMessage('1')));
+
+const message = parseMessage(data, { requireId: false });
+```
+
+`parseMessage` throws on invalid JSON, on JSON that is not an object, on a
+missing or unknown `type`, and — unless `requireId` is `false` — on a missing
+`id`.
+
 ### Message Types
 
 ```typescript
-interface GraphQLWSMessage {
-  type: 'connection_init' | 'connection_ack' | 'ping' | 'pong'
-      | 'subscribe' | 'next' | 'error' | 'complete';
-  id?: string;
-  payload?: unknown;
+enum MessageType {
+  ConnectionInit = 'connection_init',
+  ConnectionAck = 'connection_ack',
+  Ping = 'ping',
+  Pong = 'pong',
+  Subscribe = 'subscribe',
+  Next = 'next',
+  Error = 'error',
+  Complete = 'complete',
+}
+
+type Message =
+  | ConnectionInitMessage
+  | ConnectionAckMessage
+  | PingMessage
+  | PongMessage
+  | SubscribeMessage
+  | NextMessage
+  | ErrorMessage
+  | CompleteMessage;
+
+interface SubscribeMessage {
+  id: string;
+  type: MessageType.Subscribe;
+  payload: {
+    operationName?: string;
+    query: string;
+    variables?: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+  };
+}
+
+interface NextMessage {
+  id: string;
+  type: MessageType.Next;
+  payload: {
+    data?: Record<string, unknown> | null;
+    errors?: readonly { message: string; [key: string]: unknown }[];
+    extensions?: Record<string, unknown>;
+  };
+}
+
+interface ErrorMessage {
+  id: string;
+  type: MessageType.Error;
+  payload: readonly { message: string; [key: string]: unknown }[];
+}
+
+interface CompleteMessage {
+  id: string;
+  type: MessageType.Complete;
 }
 ```
 
 ## License
 
-Apache 2.0 - Pegasus Heavy Industries LLC
+Apache 2.0 - Joseph Quinn

package/dist/handler.d.ts

@@ -1,10 +1,10 @@
 /**
  * @leaven-graphql/ws - WebSocket handler
  *
- * Copyright 2026 Pegasus Heavy Industries LLC
+ * Copyright 2026 Joseph Quinn
  * Licensed under the Apache License, Version 2.0
  */
-import type { GraphQLSchema } from 'graphql';
+import { type GraphQLSchema } from 'graphql';
 import type { ServerWebSocket } from 'bun';
 import type { GraphQLRequest } from '@leaven-graphql/core';
 import { type SubscriptionManagerConfig } from './manager';
@@ -68,6 +68,16 @@ export declare class WebSocketHandler<TContext = unknown> {
      * Generate a unique connection ID
      */
     private generateConnectionId;
+    /**
+     * Invoke a user-supplied lifecycle hook without letting its failure escape.
+     *
+     * These hooks are called from places with no caller able to catch: iterator
+     * consumption stacks inside the subscription manager, timer callbacks, and
+     * Bun's `void`-returning socket callbacks. A rejected promise dropped into
+     * one of those slots is an unhandled rejection, which by default aborts the
+     * process and takes every other connection with it.
+     */
+    private invokeHook;
     /**
      * Handle WebSocket open
      */
@@ -88,6 +98,15 @@ export declare class WebSocketHandler<TContext = unknown> {
      * Handle subscribe message
      */
     private handleSubscribe;
+    /**
+     * Whether a request's selected operation is a subscription.
+     *
+     * A document graphql-js cannot resolve to a single operation (no operations
+     * at all, or several with no `operationName`) is reported as a subscription
+     * so the executor produces the precise error rather than this method
+     * guessing at one.
+     */
+    private isSubscriptionOperation;
     /**
      * Handle complete message (client unsubscribe)
      */

package/dist/handler.d.ts.map

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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @leaven-graphql/ws - WebSocket subscriptions for Leaven
  *
- * Copyright 2026 Pegasus Heavy Industries LLC
+ * Copyright 2026 Joseph Quinn
  * Licensed under the Apache License, Version 2.0
  */
 export { WebSocketHandler, createWebSocketHandler } from './handler';
@@ -10,5 +10,5 @@ export { SubscriptionManager, createSubscriptionManager } from './manager';
 export type { SubscriptionManagerConfig, Subscription, SubscriptionStatus } from './manager';
 export { PubSub, createPubSub } from './pubsub';
 export type { PubSubConfig, PubSubEngine, SubscribeFn, PublishFn } from './pubsub';
-export { MessageType, parseMessage, formatMessage, type ConnectionInitMessage, type ConnectionAckMessage, type SubscribeMessage, type NextMessage, type ErrorMessage, type CompleteMessage, type PingMessage, type PongMessage, } from './protocol';
+export { MessageType, parseMessage, formatMessage, createConnectionAck, createNextMessage, createErrorMessage, createCompleteMessage, createPongMessage, type ConnectionInitMessage, type ConnectionAckMessage, type SubscribeMessage, type NextMessage, type ErrorMessage, type CompleteMessage, type PingMessage, type PongMessage, type ParseMessageOptions, } from './protocol';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,yBAAyB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE7F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,yBAAyB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE7F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC"}