@leaven-graphql/ws 0.1.0

package/dist/manager.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @leaven-graphql/ws - Subscription manager
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+import type { GraphQLSchema } from 'graphql';
+import { type GraphQLRequest, type GraphQLResponse } from '@leaven-graphql/core';
+/**
+ * Subscription status
+ */
+export type SubscriptionStatus = 'pending' | 'active' | 'completed' | 'error';
+/**
+ * Active subscription
+ */
+export interface Subscription {
+    /** Unique subscription ID */
+    id: string;
+    /** Connection ID */
+    connectionId: string;
+    /** The original request */
+    request: GraphQLRequest;
+    /** Subscription status */
+    status: SubscriptionStatus;
+    /** When the subscription was created */
+    createdAt: number;
+    /** Async iterator */
+    iterator?: AsyncIterableIterator<GraphQLResponse>;
+    /** Cleanup function */
+    cleanup?: () => void;
+}
+/**
+ * Subscription manager configuration
+ */
+export interface SubscriptionManagerConfig {
+    /** GraphQL schema */
+    schema: GraphQLSchema;
+    /** Maximum subscriptions per connection */
+    maxSubscriptionsPerConnection?: number;
+    /** Subscription timeout in milliseconds */
+    subscriptionTimeout?: number;
+}
+/**
+ * Manages GraphQL subscriptions
+ */
+export declare class SubscriptionManager {
+    private readonly executor;
+    private readonly subscriptions;
+    private readonly connectionSubscriptions;
+    private readonly maxSubscriptionsPerConnection;
+    private readonly subscriptionTimeout;
+    constructor(config: SubscriptionManagerConfig);
+    /**
+     * Create a new subscription
+     */
+    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>;
+    /**
+     * Consume an async iterator and call callbacks
+     */
+    private consumeIterator;
+    /**
+     * Unsubscribe from a subscription
+     */
+    unsubscribe(subscriptionId: string): boolean;
+    /**
+     * Unsubscribe all subscriptions for a connection
+     */
+    unsubscribeConnection(connectionId: string): number;
+    /**
+     * Get a subscription by ID
+     */
+    getSubscription(subscriptionId: string): Subscription | undefined;
+    /**
+     * Get all subscriptions for a connection
+     */
+    getConnectionSubscriptions(connectionId: string): Subscription[];
+    /**
+     * Get the total number of active subscriptions
+     */
+    get subscriptionCount(): number;
+    /**
+     * Get the number of active connections
+     */
+    get connectionCount(): number;
+    /**
+     * Clear all subscriptions
+     */
+    clear(): void;
+}
+/**
+ * Create a new subscription manager
+ */
+export declare function createSubscriptionManager(config: SubscriptionManagerConfig): SubscriptionManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEjG;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,OAAO,EAAE,cAAc,CAAC;IACxB,0BAA0B;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAClD,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,2CAA2C;IAC3C,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4B;IAC1D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA2B;IACnE,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAS;IACvD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAEjC,MAAM,EAAE,yBAAyB;IAQ7C;;OAEG;IACU,SAAS,CAAC,QAAQ,GAAG,OAAO,EACvC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,EACzC,UAAU,EAAE,MAAM,IAAI,EACtB,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,IAAI,GACxD,OAAO,CAAC,YAAY,CAAC;IAqExB;;OAEG;YACW,eAAe;IAkC7B;;OAEG;IACI,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IA4BnD;;OAEG;IACI,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAgB1D;;OAEG;IACI,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxE;;OAEG;IACI,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,EAAE;IAiBvE;;OAEG;IACH,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED;;OAEG;IACH,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}

package/dist/protocol.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @leaven-graphql/ws - GraphQL over WebSocket protocol
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Implements graphql-ws protocol
+ */
+/**
+ * Message types as defined by graphql-ws protocol
+ */
+export declare enum MessageType {
+    ConnectionInit = "connection_init",
+    ConnectionAck = "connection_ack",
+    Ping = "ping",
+    Pong = "pong",
+    Subscribe = "subscribe",
+    Next = "next",
+    Error = "error",
+    Complete = "complete"
+}
+/**
+ * Connection init message
+ */
+export interface ConnectionInitMessage {
+    type: MessageType.ConnectionInit;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Connection ack message
+ */
+export interface ConnectionAckMessage {
+    type: MessageType.ConnectionAck;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Ping message
+ */
+export interface PingMessage {
+    type: MessageType.Ping;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Pong message
+ */
+export interface PongMessage {
+    type: MessageType.Pong;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Subscribe message
+ */
+export interface SubscribeMessage {
+    id: string;
+    type: MessageType.Subscribe;
+    payload: {
+        operationName?: string;
+        query: string;
+        variables?: Record<string, unknown>;
+        extensions?: Record<string, unknown>;
+    };
+}
+/**
+ * Next message (data result)
+ */
+export interface NextMessage {
+    id: string;
+    type: MessageType.Next;
+    payload: {
+        data?: Record<string, unknown> | null;
+        errors?: readonly {
+            message: string;
+            [key: string]: unknown;
+        }[];
+        extensions?: Record<string, unknown>;
+    };
+}
+/**
+ * Error message
+ */
+export interface ErrorMessage {
+    id: string;
+    type: MessageType.Error;
+    payload: readonly {
+        message: string;
+        [key: string]: unknown;
+    }[];
+}
+/**
+ * Complete message
+ */
+export interface CompleteMessage {
+    id: string;
+    type: MessageType.Complete;
+}
+/**
+ * All message types
+ */
+export type Message = ConnectionInitMessage | ConnectionAckMessage | PingMessage | PongMessage | SubscribeMessage | NextMessage | ErrorMessage | CompleteMessage;
+/**
+ * Parse a WebSocket message
+ */
+export declare function parseMessage(data: string | Buffer): Message;
+/**
+ * Format a message for sending
+ */
+export declare function formatMessage(message: Message): string;
+/**
+ * Create a connection ack message
+ */
+export declare function createConnectionAck(payload?: Record<string, unknown>): ConnectionAckMessage;
+/**
+ * Create a next message
+ */
+export declare function createNextMessage(id: string, data: Record<string, unknown> | null | undefined, errors?: readonly {
+    message: string;
+}[]): NextMessage;
+/**
+ * Create an error message
+ */
+export declare function createErrorMessage(id: string, errors: readonly {
+    message: string;
+    [key: string]: unknown;
+}[]): ErrorMessage;
+/**
+ * Create a complete message
+ */
+export declare function createCompleteMessage(id: string): CompleteMessage;
+/**
+ * Create a pong message
+ */
+export declare function createPongMessage(payload?: Record<string, unknown>): PongMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/pubsub.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @leaven-graphql/ws - PubSub implementation
+ *
+ * Copyright 2026 Pegasus Heavy Industries LLC
+ * Licensed under the Apache License, Version 2.0
+ */
+/**
+ * Subscribe function type
+ */
+export type SubscribeFn<T = unknown> = (topic: string, callback: (payload: T) => void) => () => void;
+/**
+ * Publish function type
+ */
+export type PublishFn<T = unknown> = (topic: string, payload: T) => void;
+/**
+ * PubSub engine interface
+ */
+export interface PubSubEngine {
+    subscribe: SubscribeFn;
+    publish: PublishFn;
+}
+/**
+ * PubSub configuration
+ */
+export interface PubSubConfig {
+    /** Maximum subscribers per topic */
+    maxSubscribersPerTopic?: number;
+    /** Enable topic wildcards */
+    wildcards?: boolean;
+}
+/**
+ * In-memory PubSub implementation
+ */
+export declare class PubSub implements PubSubEngine {
+    private readonly subscribers;
+    private readonly maxSubscribersPerTopic;
+    private readonly wildcards;
+    private nextId;
+    constructor(config?: PubSubConfig);
+    /**
+     * Subscribe to a topic
+     */
+    subscribe<T = unknown>(topic: string, callback: (payload: T) => void): () => void;
+    /**
+     * Publish to a topic
+     */
+    publish<T = unknown>(topic: string, payload: T): void;
+    /**
+     * Publish to wildcard subscribers
+     */
+    private publishToWildcards;
+    /**
+     * Check if a topic pattern matches
+     */
+    private matchesWildcard;
+    /**
+     * Create an async iterator for a topic
+     */
+    asyncIterator<T = unknown>(topic: string | string[]): AsyncIterableIterator<T>;
+    /**
+     * Get the number of subscribers for a topic
+     */
+    getSubscriberCount(topic: string): number;
+    /**
+     * Get all topics with subscribers
+     */
+    getTopics(): string[];
+    /**
+     * Clear all subscriptions
+     */
+    clear(): void;
+}
+/**
+ * Create a new PubSub instance
+ */
+export declare function createPubSub(config?: PubSubConfig): PubSub;
+//# sourceMappingURL=pubsub.d.ts.map

package/dist/pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../src/pubsub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC3B,MAAM,IAAI,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAUD;;GAEG;AACH,qBAAa,MAAO,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,YAAiB;IAOrC;;OAEG;IACI,SAAS,CAAC,CAAC,GAAG,OAAO,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC7B,MAAM,IAAI;IA4Bb;;OAEG;IACI,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAmB5D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACI,aAAa,CAAC,CAAC,GAAG,OAAO,EAC9B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACvB,qBAAqB,CAAC,CAAC,CAAC;IA8D3B;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhD;;OAEG;IACI,SAAS,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAE1D"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@leaven-graphql/ws",
+  "version": "0.1.0",
+  "description": "WebSocket subscriptions support for Leaven GraphQL",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "graphql",
+    "bun",
+    "websocket",
+    "subscriptions"
+  ],
+  "author": "Pegasus Heavy Industries LLC",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "graphql": "^16.8.0",
+    "@leaven-graphql/core": "0.1.0",
+    "@leaven-graphql/context": "0.1.0",
+    "@leaven-graphql/errors": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "graphql": "^16.0.0"
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  }
+}