@voltrix/websocket 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Randy stiven Valentin
+
+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/README.md

@@ -0,0 +1,10 @@
+# @voltrix/websocket
+
+High-performance, programmatic-first and decorator-driven WebSocket package with pluggable adapters and distributed pub/sub for Voltrix.
+
+## Features
+- **Programmatic-First**: Full programmatic instanciation and routing support without decorators.
+- **Ultra High-Performance**: Optimized for zero-allocation hot paths running directly on uWebSockets.js.
+- **Pre-Upgrade Handshake validation**: Validate tokens and deny connection in HTTP Upgrade phase (zero TCP ws handle leakage).
+- **Pluggable Pub/Sub Engine**: Local C++ uWS pub/sub or clustered Redis Pub/Sub out-of-the-box.
+- **Decorator Gateways**: Optional elegant controllers mimicking high-level clean architectures.

package/dist/adapters/index.d.ts

@@ -0,0 +1 @@
+export * from './uws-adapter.js';

package/dist/adapters/index.js

@@ -0,0 +1,2 @@
+export * from './uws-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/adapters/uws-adapter.d.ts

@@ -0,0 +1,87 @@
+import type { IRequest, IResponse } from '@voltrix/core';
+import type { IWebSocketAdapter, WsSocket, WsMessageHandler } from '../types/index.js';
+/**
+ * 📦 Options for configuring the uWebSockets.js Adapter
+ */
+export interface UwsAdapterOptions {
+    app?: any;
+    path?: string;
+    maxPayloadLength?: number;
+    idleTimeout?: number;
+    compression?: number;
+    maxBackpressure?: number;
+    onUpgrade?: (req: IRequest, res: IResponse) => any | Promise<any>;
+}
+/**
+ * 📨 Heap-allocated request clone to bypass uWebSockets.js stack-allocation lifetime limitations.
+ */
+export declare class HeapRequest implements IRequest {
+    private readonly _headers;
+    readonly query: Record<string, any>;
+    readonly cookies: Record<string, string>;
+    readonly url: string;
+    readonly method: string;
+    readonly ip: string;
+    readonly params: Record<string, string>;
+    readonly context: Record<string, any>;
+    user?: any;
+    constructor(req: any, ip: string);
+    header(name: string): string | undefined;
+    headers(): Record<string, string>;
+    getParam(name: string): string | undefined;
+    getQuery(name: string): any;
+    buffer(): Promise<Uint8Array>;
+    body(): Promise<string>;
+    json<T = any>(): Promise<T>;
+    onData(handler: (chunk: Uint8Array, isLast: boolean) => void): void;
+}
+/**
+ * 🔒 Minimal HTTP Response wrapper for validation failures during Handshake/Upgrade phase
+ */
+export declare class UpgradeResponse implements IResponse {
+    private _status;
+    private _headers;
+    readonly raw: any;
+    headersSent: boolean;
+    isAborted: boolean;
+    locals: Record<string, any>;
+    constructor(res: any);
+    setHeader(name: string, value: string): IResponse;
+    json(data: any): void;
+    send(data: string): void;
+    status(code: number): IResponse;
+    type(contentType: string): IResponse;
+    end(data?: string | Uint8Array): void;
+}
+/**
+ * 🔌 Engine Socket wrapper mapping directly onto C++ uWebSockets.js instance.
+ */
+export declare class UwsSocket<TUser = any> implements WsSocket<TUser, any> {
+    private readonly ws;
+    readonly raw: any;
+    readonly id: string;
+    user?: TUser;
+    constructor(ws: any, raw: any);
+    send(message: string | ArrayBufferView | ArrayBuffer, isBinary?: boolean): void;
+    subscribe(topic: string): void;
+    unsubscribe(topic: string): void;
+    publish(topic: string, message: string | ArrayBufferView | ArrayBuffer, isBinary?: boolean): void;
+    close(code?: number, reason?: string): void;
+}
+/**
+ * 🚀 High-performance uWebSockets.js Adapter.
+ */
+export declare class UwsWebSocketAdapter implements IWebSocketAdapter<any, UwsSocket, UwsAdapterOptions> {
+    private serverApp;
+    private isStandalone;
+    private readonly socketMap;
+    private onConnectCallback?;
+    private onDisconnectCallback?;
+    private readonly globalHandlers;
+    create(port: number, options?: UwsAdapterOptions): any;
+    bindClientConnect(server: any, callback: (client: UwsSocket) => void | Promise<void>): void;
+    bindClientDisconnect(client: UwsSocket, callback: (client: UwsSocket, code: number, reason: ArrayBuffer) => void | Promise<void>): void;
+    bindMessageHandlers(client: UwsSocket, handlers: WsMessageHandler<UwsSocket>[]): void;
+    getOrCreateSocket(rawWs: any): UwsSocket;
+    close(): void | Promise<void>;
+}

package/dist/adapters/uws-adapter.js

@@ -0,0 +1,295 @@
+/**
+ * 📨 Heap-allocated request clone to bypass uWebSockets.js stack-allocation lifetime limitations.
+ */
+export class HeapRequest {
+    _headers = {};
+    query = {};
+    cookies = {};
+    url;
+    method;
+    ip;
+    params = {};
+    context = {};
+    user;
+    constructor(req, ip) {
+        this.url = req.getUrl();
+        this.method = req.getMethod().toUpperCase();
+        this.ip = ip;
+        // Synchronously copy all headers
+        req.forEach((key, val) => {
+            this._headers[key.toLowerCase()] = val;
+        });
+        // Synchronously parse query string
+        const queryStr = req.getQuery();
+        if (queryStr) {
+            const searchParams = new URLSearchParams(queryStr);
+            for (const [key, val] of searchParams.entries()) {
+                this.query[key] = val;
+            }
+        }
+        // Synchronously parse cookies
+        const cookieHeader = this._headers['cookie'];
+        if (cookieHeader) {
+            cookieHeader.split(';').forEach((cookie) => {
+                const parts = cookie.split('=');
+                const k = parts[0]?.trim();
+                const v = parts.slice(1).join('=').trim();
+                if (k)
+                    this.cookies[k] = v;
+            });
+        }
+    }
+    header(name) {
+        return this._headers[name.toLowerCase()];
+    }
+    headers() {
+        return this._headers;
+    }
+    getParam(name) {
+        return this.params[name];
+    }
+    getQuery(name) {
+        return this.query[name];
+    }
+    buffer() {
+        return Promise.resolve(new Uint8Array(0));
+    }
+    body() {
+        return Promise.resolve('');
+    }
+    json() {
+        return Promise.resolve({});
+    }
+    onData(handler) {
+        // No-op for upgrade requests
+    }
+}
+/**
+ * 🔒 Minimal HTTP Response wrapper for validation failures during Handshake/Upgrade phase
+ */
+export class UpgradeResponse {
+    _status = '200 OK';
+    _headers = {};
+    raw;
+    headersSent = false;
+    isAborted = false;
+    locals = {};
+    constructor(res) {
+        this.raw = res;
+        res.onAborted(() => {
+            this.isAborted = true;
+        });
+    }
+    setHeader(name, value) {
+        this._headers[name] = value;
+        return this;
+    }
+    json(data) {
+        this.setHeader('Content-Type', 'application/json');
+        this.send(JSON.stringify(data));
+    }
+    send(data) {
+        if (this.isAborted)
+            return;
+        this.headersSent = true;
+        this.raw.cork(() => {
+            this.raw.writeStatus(this._status);
+            Object.entries(this._headers).forEach(([k, v]) => {
+                this.raw.writeHeader(k, v);
+            });
+            this.raw.end(data);
+        });
+    }
+    status(code) {
+        switch (code) {
+            case 400:
+                this._status = '400 Bad Request';
+                break;
+            case 401:
+                this._status = '401 Unauthorized';
+                break;
+            case 403:
+                this._status = '403 Forbidden';
+                break;
+            case 429:
+                this._status = '429 Too Many Requests';
+                break;
+            case 500:
+                this._status = '500 Internal Server Error';
+                break;
+            default: this._status = `${code} Custom`;
+        }
+        return this;
+    }
+    type(contentType) {
+        this.setHeader('Content-Type', contentType);
+        return this;
+    }
+    end(data) {
+        if (this.isAborted)
+            return;
+        this.headersSent = true;
+        this.raw.cork(() => {
+            this.raw.writeStatus(this._status);
+            Object.entries(this._headers).forEach(([k, v]) => {
+                this.raw.writeHeader(k, v);
+            });
+            this.raw.end(data || '');
+        });
+    }
+}
+/**
+ * 🔌 Engine Socket wrapper mapping directly onto C++ uWebSockets.js instance.
+ */
+export class UwsSocket {
+    ws;
+    raw;
+    id;
+    user;
+    constructor(ws, raw) {
+        this.ws = ws;
+        this.raw = raw;
+        this.id = Math.random().toString(36).slice(2) + Date.now().toString(36);
+        const data = ws.getUserData();
+        if (data && data.user) {
+            this.user = data.user;
+        }
+    }
+    send(message, isBinary) {
+        this.ws.send(message, isBinary);
+    }
+    subscribe(topic) {
+        this.ws.subscribe(topic);
+    }
+    unsubscribe(topic) {
+        this.ws.unsubscribe(topic);
+    }
+    publish(topic, message, isBinary) {
+        this.ws.publish(topic, message, isBinary);
+    }
+    close(code, reason) {
+        this.ws.end(code, reason);
+    }
+}
+/**
+ * 🚀 High-performance uWebSockets.js Adapter.
+ */
+export class UwsWebSocketAdapter {
+    serverApp = null;
+    isStandalone = false;
+    socketMap = new WeakMap();
+    onConnectCallback;
+    onDisconnectCallback;
+    globalHandlers = new Map();
+    create(port, options = {}) {
+        const uWSModule = require('uWebSockets.js');
+        this.serverApp = options.app || uWSModule.App({});
+        this.isStandalone = !options.app;
+        const path = options.path || '/ws';
+        const maxPayloadLength = options.maxPayloadLength ?? 16 * 1024 * 1024;
+        const idleTimeout = options.idleTimeout ?? 120;
+        const compression = options.compression ?? 0;
+        const maxBackpressure = options.maxBackpressure ?? 1024 * 1024;
+        this.serverApp.ws(path, {
+            compression,
+            maxPayloadLength,
+            idleTimeout,
+            maxBackpressure,
+            upgrade: async (res, req, context) => {
+                let aborted = false;
+                res.onAborted(() => {
+                    aborted = true;
+                });
+                const remoteIp = Buffer.from(res.getRemoteAddressAsText()).toString();
+                const heapReq = new HeapRequest(req, remoteIp);
+                const uwsKey = req.getHeader('sec-websocket-key');
+                const uwsProtocol = req.getHeader('sec-websocket-protocol');
+                const uwsExtensions = req.getHeader('sec-websocket-extensions');
+                try {
+                    let userContext = null;
+                    if (options.onUpgrade) {
+                        const wrapRes = new UpgradeResponse(res);
+                        userContext = await options.onUpgrade(heapReq, wrapRes);
+                        if (wrapRes.isAborted || aborted)
+                            return;
+                        if (userContext === false) {
+                            wrapRes.status(401).json({ error: 'Unauthorized', message: 'Handshake validation failed' });
+                            return;
+                        }
+                    }
+                    if (!aborted) {
+                        res.upgrade({ user: userContext || heapReq.user }, uwsKey, uwsProtocol, uwsExtensions, context);
+                    }
+                }
+                catch (err) {
+                    if (!aborted) {
+                        const wrapRes = new UpgradeResponse(res);
+                        wrapRes.status(500).json({ error: 'Internal Server Error', message: err.message });
+                    }
+                }
+            },
+            open: (ws) => {
+                const socket = this.getOrCreateSocket(ws);
+                if (this.onConnectCallback) {
+                    this.onConnectCallback(socket);
+                }
+            },
+            message: (ws, message, isBinary) => {
+                const socket = this.getOrCreateSocket(ws);
+                const payloadStr = Buffer.from(message).toString('utf8');
+                try {
+                    const packet = JSON.parse(payloadStr);
+                    if (packet && typeof packet === 'object' && packet.event) {
+                        const handler = this.globalHandlers.get(packet.event);
+                        if (handler) {
+                            handler(socket, packet.data);
+                        }
+                    }
+                }
+                catch (err) {
+                    // Stable under spam
+                }
+            },
+            close: (ws, code, message) => {
+                const socket = this.getOrCreateSocket(ws);
+                if (this.onDisconnectCallback) {
+                    this.onDisconnectCallback(socket, code, message);
+                }
+                this.socketMap.delete(ws);
+            }
+        });
+        if (this.isStandalone) {
+            this.serverApp.listen(port, (token) => {
+                if (!token) {
+                    throw new Error(`Failed to start standalone uWS WebSocket Server on port ${port}`);
+                }
+            });
+        }
+        return this.serverApp;
+    }
+    bindClientConnect(server, callback) {
+        this.onConnectCallback = callback;
+    }
+    bindClientDisconnect(client, callback) {
+        this.onDisconnectCallback = callback;
+    }
+    bindMessageHandlers(client, handlers) {
+        handlers.forEach((h) => {
+            this.globalHandlers.set(h.event, h.handler);
+        });
+    }
+    getOrCreateSocket(rawWs) {
+        let socket = this.socketMap.get(rawWs);
+        if (!socket) {
+            socket = new UwsSocket(rawWs, rawWs);
+            this.socketMap.set(rawWs, socket);
+        }
+        return socket;
+    }
+    close() {
+        if (this.isStandalone && this.serverApp) {
+            // Standalone server cleanup
+        }
+    }
+}
+//# sourceMappingURL=uws-adapter.js.map

package/dist/adapters/uws-adapter.js.map

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

package/dist/decorators/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 🏷️ Global Symbols and Keys for WebSocket metadata storage
+ */
+export declare const WS_KEYS: {
+    readonly GATEWAY: "voltrix:ws:gateway";
+    readonly EVENTS: "voltrix:ws:events";
+    readonly PARAMS: "voltrix:ws:params";
+    readonly ON_CONNECT: "voltrix:ws:on_connect";
+    readonly ON_DISCONNECT: "voltrix:ws:on_disconnect";
+};
+/**
+ * 🚀 WebSocketGateway Decorator.
+ * Declares a class as an injectable WebSocket Gateway.
+ */
+export declare function WebSocketGateway(options?: {
+    path?: string;
+    guard?: any;
+}): ClassDecorator;
+/**
+ * 📡 SubscribeMessage Decorator.
+ * Binds a gateway method to intercept incoming client messages matching the specified event.
+ */
+export declare function SubscribeMessage(event: string): MethodDecorator;
+/**
+ * 🔌 OnConnect Decorator.
+ * Binds a gateway method to connection established events.
+ */
+export declare function OnConnect(): MethodDecorator;
+/**
+ * 🔌 OnDisconnect Decorator.
+ * Binds a gateway method to connection closed events.
+ */
+export declare function OnDisconnect(): MethodDecorator;
+/**
+ * 🎛️ ConnectedSocket Parameter Decorator.
+ * Injects the normalized WsSocket wrapper into the decorated parameter.
+ */
+export declare function ConnectedSocket(): ParameterDecorator;
+/**
+ * 📦 MessageBody Parameter Decorator.
+ * Injects the parsed packet data payload into the decorated parameter.
+ */
+export declare function MessageBody(): ParameterDecorator;

package/dist/decorators/index.js

@@ -0,0 +1,90 @@
+import { Metadata } from '@voltrix/core';
+import { Injectable } from '@voltrix/injector';
+/**
+ * 🏷️ Global Symbols and Keys for WebSocket metadata storage
+ */
+export const WS_KEYS = {
+    GATEWAY: 'voltrix:ws:gateway',
+    EVENTS: 'voltrix:ws:events',
+    PARAMS: 'voltrix:ws:params',
+    ON_CONNECT: 'voltrix:ws:on_connect',
+    ON_DISCONNECT: 'voltrix:ws:on_disconnect'
+};
+/**
+ * 🚀 WebSocketGateway Decorator.
+ * Declares a class as an injectable WebSocket Gateway.
+ */
+export function WebSocketGateway(options = {}) {
+    return (target) => {
+        const meta = Metadata.get(target);
+        meta[WS_KEYS.GATEWAY] = options;
+        // Programmatically apply the DI @Injectable() decorator to register within the DI Container
+        Injectable()(target);
+    };
+}
+/**
+ * 📡 SubscribeMessage Decorator.
+ * Binds a gateway method to intercept incoming client messages matching the specified event.
+ */
+export function SubscribeMessage(event) {
+    return (target, propertyKey) => {
+        const ctor = target.constructor;
+        const meta = Metadata.get(ctor);
+        const events = meta[WS_KEYS.EVENTS] || [];
+        events.push({ event, propertyKey });
+        meta[WS_KEYS.EVENTS] = events;
+    };
+}
+/**
+ * 🔌 OnConnect Decorator.
+ * Binds a gateway method to connection established events.
+ */
+export function OnConnect() {
+    return (target, propertyKey) => {
+        const ctor = target.constructor;
+        const meta = Metadata.get(ctor);
+        meta[WS_KEYS.ON_CONNECT] = propertyKey;
+    };
+}
+/**
+ * 🔌 OnDisconnect Decorator.
+ * Binds a gateway method to connection closed events.
+ */
+export function OnDisconnect() {
+    return (target, propertyKey) => {
+        const ctor = target.constructor;
+        const meta = Metadata.get(ctor);
+        meta[WS_KEYS.ON_DISCONNECT] = propertyKey;
+    };
+}
+/**
+ * 🎛️ ConnectedSocket Parameter Decorator.
+ * Injects the normalized WsSocket wrapper into the decorated parameter.
+ */
+export function ConnectedSocket() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const ctor = target.constructor;
+        const meta = Metadata.get(ctor, propertyKey);
+        const params = meta[WS_KEYS.PARAMS] || [];
+        params.push({ index: parameterIndex, type: 'socket' });
+        meta[WS_KEYS.PARAMS] = params;
+    };
+}
+/**
+ * 📦 MessageBody Parameter Decorator.
+ * Injects the parsed packet data payload into the decorated parameter.
+ */
+export function MessageBody() {
+    return (target, propertyKey, parameterIndex) => {
+        if (!propertyKey)
+            return;
+        const ctor = target.constructor;
+        const meta = Metadata.get(ctor, propertyKey);
+        const params = meta[WS_KEYS.PARAMS] || [];
+        params.push({ index: parameterIndex, type: 'body' });
+        meta[WS_KEYS.PARAMS] = params;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types/index.js';
+export * from './adapters/index.js';
+export * from './pubsub/index.js';
+export * from './pipeline/index.js';
+export * from './decorators/index.js';
+export * from './processors/websocket.processor.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+// 🔌 Unified Entry Point for @voltrix/websocket
+export * from './types/index.js';
+export * from './adapters/index.js';
+export * from './pubsub/index.js';
+export * from './pipeline/index.js';
+export * from './decorators/index.js';
+export * from './processors/websocket.processor.js';
+//# 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,gDAAgD;AAEhD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qCAAqC,CAAC"}

package/dist/pipeline/index.d.ts

@@ -0,0 +1,19 @@
+import type { WsSocket, WsMiddleware } from '../types/index.js';
+export * from './parser.js';
+/**
+ * 🧅 High-performance Onion-style Message Execution Pipeline.
+ * Enables sequential middleware/interceptor execution with full support for asynchronous validation,
+ * short-circuiting, payload mutation, and error propagation.
+ */
+export declare class WsPipeline<TUser = any> {
+    private readonly middlewares;
+    /**
+     * Registers a new middleware/interceptor in the message pipeline.
+     */
+    use(middleware: WsMiddleware<TUser>): this;
+    /**
+     * Executes the registered middleware pipeline sequentially.
+     * If all middlewares successfully call next(), the final handler is executed.
+     */
+    run(client: WsSocket<TUser>, event: string, payload: any, handler: (client: WsSocket<TUser>, data: any) => void | Promise<void>): Promise<void>;
+}

package/dist/pipeline/index.js

@@ -0,0 +1,45 @@
+export * from './parser.js';
+/**
+ * 🧅 High-performance Onion-style Message Execution Pipeline.
+ * Enables sequential middleware/interceptor execution with full support for asynchronous validation,
+ * short-circuiting, payload mutation, and error propagation.
+ */
+export class WsPipeline {
+    middlewares = [];
+    /**
+     * Registers a new middleware/interceptor in the message pipeline.
+     */
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    /**
+     * Executes the registered middleware pipeline sequentially.
+     * If all middlewares successfully call next(), the final handler is executed.
+     */
+    async run(client, event, payload, handler) {
+        const context = {
+            client,
+            event,
+            payload
+        };
+        let index = -1;
+        const dispatch = async (i) => {
+            if (i <= index) {
+                throw new Error('next() called multiple times inside WsPipeline');
+            }
+            index = i;
+            // When we reach the end of the middleware list, invoke the final message handler
+            if (i === this.middlewares.length) {
+                await handler(context.client, context.payload);
+                return;
+            }
+            const middleware = this.middlewares[i];
+            await middleware(context, async () => {
+                await dispatch(i + 1);
+            });
+        };
+        await dispatch(0);
+    }
+}
+//# sourceMappingURL=index.js.map