@morojs/moro 1.3.0 → 1.5.0

package/dist/core/networking/adapters/ws-adapter.js

@@ -0,0 +1,383 @@
+"use strict";
+// Native WebSocket Adapter for Moro Framework
+// Implements the WebSocket adapter interface using the 'ws' library
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WSAdapter = void 0;
+/**
+ * Native WebSocket adapter using the 'ws' library
+ * Provides a lightweight, standards-compliant WebSocket implementation
+ */
+class WSAdapter {
+    constructor() {
+        this.namespaces = new Map();
+        this.connections = new Map();
+        this.connectionCounter = 0;
+    }
+    async initialize(httpServer, options = {}) {
+        try {
+            // Dynamic import to avoid requiring ws as a hard dependency
+            const { WebSocketServer } = await Promise.resolve().then(() => __importStar(require('ws')));
+            this.wss = new WebSocketServer({
+                server: httpServer,
+                path: options.path || '/ws',
+                maxPayload: options.maxPayloadLength || 100 * 1024 * 1024, // 100MB default
+                // Note: ws doesn't have built-in compression like socket.io
+                // but browsers handle compression at the transport level
+            });
+            // Setup connection handling
+            this.wss.on('connection', (ws, request) => {
+                this.handleConnection(ws, request);
+            });
+            // Setup default namespace
+            this.createNamespace('/');
+        }
+        catch (error) {
+            throw new Error('ws library not found. Install it with: npm install ws @types/ws\n' +
+                'Or use a different WebSocket adapter.');
+        }
+    }
+    handleConnection(ws, request) {
+        const id = this.generateId();
+        const connection = new WSConnectionWrapper(id, ws, request);
+        this.connections.set(id, connection);
+        // Parse namespace from URL path or default to '/'
+        const url = new URL(request.url || '/', `http://${request.headers.host}`);
+        const namespacePath = url.pathname === '/ws' ? '/' : url.pathname.replace('/ws', '') || '/';
+        const namespace = this.namespaces.get(namespacePath);
+        if (namespace) {
+            namespace.handleConnection(connection);
+        }
+        // Clean up on disconnect
+        ws.on('close', () => {
+            this.connections.delete(id);
+        });
+    }
+    createNamespace(namespace) {
+        if (!this.namespaces.has(namespace)) {
+            const ns = new WSNamespaceWrapper(namespace, this);
+            this.namespaces.set(namespace, ns);
+        }
+        return this.namespaces.get(namespace);
+    }
+    getDefaultNamespace() {
+        return this.createNamespace('/');
+    }
+    async close() {
+        if (this.wss) {
+            return new Promise(resolve => {
+                this.wss.close(() => {
+                    this.connections.clear();
+                    this.namespaces.clear();
+                    resolve();
+                });
+            });
+        }
+    }
+    setCompression(enabled, _options = {}) {
+        // ws library handles compression at the browser level
+        // This is a no-op but kept for interface compatibility
+        if (enabled) {
+            console.warn('Compression is handled automatically by the ws library and browsers');
+        }
+    }
+    setCustomIdGenerator(generator) {
+        this.customIdGenerator = generator;
+    }
+    getAdapterName() {
+        return 'ws';
+    }
+    getConnectionCount() {
+        return this.connections.size;
+    }
+    generateId() {
+        if (this.customIdGenerator) {
+            return this.customIdGenerator();
+        }
+        return `ws_${++this.connectionCounter}_${Date.now()}`;
+    }
+    addConnection(id, connection) {
+        this.connections.set(id, connection);
+    }
+    removeConnection(id) {
+        this.connections.delete(id);
+    }
+    getAllConnections() {
+        return this.connections;
+    }
+}
+exports.WSAdapter = WSAdapter;
+/**
+ * WebSocket namespace wrapper
+ */
+class WSNamespaceWrapper {
+    constructor(namespacePath, adapter) {
+        this.namespacePath = namespacePath;
+        this.adapter = adapter;
+        this.connectionHandlers = [];
+        this.middlewares = [];
+        this.connections = new Map();
+    }
+    handleConnection(connection) {
+        this.connections.set(connection.id, connection);
+        // Run middlewares
+        this.runMiddlewares(connection, () => {
+            // Notify connection handlers
+            this.connectionHandlers.forEach(handler => handler(connection));
+        });
+        // Clean up on disconnect
+        connection.on('close', () => {
+            this.connections.delete(connection.id);
+        });
+    }
+    runMiddlewares(connection, callback) {
+        let index = 0;
+        const next = (err) => {
+            if (err || index >= this.middlewares.length) {
+                if (!err)
+                    callback();
+                return;
+            }
+            const middleware = this.middlewares[index++];
+            middleware(connection, next);
+        };
+        next();
+    }
+    on(event, handler) {
+        this.connectionHandlers.push(handler);
+    }
+    emit(event, data) {
+        const message = JSON.stringify({ event, data });
+        for (const connection of this.connections.values()) {
+            if (connection.connected) {
+                connection.ws.send(message);
+            }
+        }
+    }
+    to(room) {
+        return new WSEmitterWrapper(this.connections, room);
+    }
+    except(room) {
+        return new WSEmitterWrapper(this.connections, undefined, room);
+    }
+    getSockets() {
+        return Array.from(this.connections.values());
+    }
+    getConnectionCount() {
+        return this.connections.size;
+    }
+    use(middleware) {
+        this.middlewares.push(middleware);
+    }
+}
+/**
+ * WebSocket connection wrapper
+ */
+class WSConnectionWrapper {
+    constructor(id, ws, request) {
+        this.id = id;
+        this.ws = ws;
+        this.request = request;
+        this.data = {};
+        this.eventHandlers = new Map();
+        this.anyHandlers = [];
+        this.rooms = new Set();
+        this._connected = true;
+        // Setup message handling
+        this.ws.on('message', (data) => {
+            this.handleMessage(data);
+        });
+        this.ws.on('close', () => {
+            this._connected = false;
+            this.emit('close');
+        });
+        this.ws.on('error', (error) => {
+            this.emit('error', error);
+        });
+    }
+    get ip() {
+        return (this.request.socket?.remoteAddress || this.request.headers['x-forwarded-for']?.split(',')[0]);
+    }
+    get headers() {
+        return this.request.headers;
+    }
+    get connected() {
+        return this._connected && this.ws.readyState === 1; // WebSocket.OPEN
+    }
+    get broadcast() {
+        // Get all connections except this one
+        const allConnections = new Map();
+        // This would need access to adapter's connections
+        return new WSEmitterWrapper(allConnections, undefined, undefined, this.id);
+    }
+    on(event, handler) {
+        if (event === 'close' || event === 'error') {
+            // Special internal events
+            if (!this.eventHandlers.has(event)) {
+                this.eventHandlers.set(event, []);
+            }
+            this.eventHandlers.get(event).push(handler);
+            return;
+        }
+        if (!this.eventHandlers.has(event)) {
+            this.eventHandlers.set(event, []);
+        }
+        this.eventHandlers.get(event).push(handler);
+    }
+    onAny(handler) {
+        this.anyHandlers.push(handler);
+    }
+    emit(event, data) {
+        if (event === 'close' || event === 'error') {
+            // Internal events
+            const handlers = this.eventHandlers.get(event);
+            if (handlers) {
+                handlers.forEach(handler => handler(data));
+            }
+            return;
+        }
+        if (this.connected) {
+            const message = JSON.stringify({ event, data });
+            this.ws.send(message);
+        }
+    }
+    compressedEmit(event, data) {
+        // ws library handles compression automatically
+        this.emit(event, data);
+    }
+    join(room) {
+        if (Array.isArray(room)) {
+            room.forEach(r => this.rooms.add(r));
+        }
+        else {
+            this.rooms.add(room);
+        }
+    }
+    leave(room) {
+        if (Array.isArray(room)) {
+            room.forEach(r => this.rooms.delete(r));
+        }
+        else {
+            this.rooms.delete(room);
+        }
+    }
+    to(room) {
+        const connections = new Map([[this.id, this]]);
+        return new WSEmitterWrapper(connections, room);
+    }
+    getRooms() {
+        return new Set(this.rooms);
+    }
+    disconnect(close) {
+        if (close !== false && this.ws.readyState === 1) {
+            this.ws.close();
+        }
+        this._connected = false;
+    }
+    handleMessage(data) {
+        try {
+            const text = data.toString();
+            const parsed = JSON.parse(text);
+            const { event, data: messageData, callback: callbackId } = parsed;
+            // Create callback function if callback ID is provided
+            const callback = callbackId
+                ? (response) => {
+                    this.emit('callback', { id: callbackId, data: response });
+                }
+                : undefined;
+            // Call any handlers
+            this.anyHandlers.forEach(handler => handler(event, messageData));
+            // Call specific event handlers
+            const handlers = this.eventHandlers.get(event);
+            if (handlers) {
+                handlers.forEach(handler => handler(messageData, callback));
+            }
+        }
+        catch (error) {
+            // Invalid message format - ignore
+        }
+    }
+}
+/**
+ * WebSocket emitter wrapper
+ */
+class WSEmitterWrapper {
+    constructor(connections, targetRooms, excludeRooms, excludeId) {
+        this.connections = connections;
+        this.targetRooms = targetRooms;
+        this.excludeRooms = excludeRooms;
+        this.excludeId = excludeId;
+    }
+    emit(event, data) {
+        const message = JSON.stringify({ event, data });
+        for (const connection of this.connections.values()) {
+            if (this.excludeId && connection.id === this.excludeId) {
+                continue;
+            }
+            if (this.shouldIncludeConnection(connection) && connection.connected) {
+                connection.ws.send(message);
+            }
+        }
+    }
+    to(room) {
+        return new WSEmitterWrapper(this.connections, room, this.excludeRooms, this.excludeId);
+    }
+    except(room) {
+        return new WSEmitterWrapper(this.connections, this.targetRooms, room, this.excludeId);
+    }
+    compress(_compress) {
+        // ws library handles compression automatically
+        return this;
+    }
+    shouldIncludeConnection(connection) {
+        const rooms = connection.getRooms();
+        // Check target rooms
+        if (this.targetRooms) {
+            const targets = Array.isArray(this.targetRooms) ? this.targetRooms : [this.targetRooms];
+            if (!targets.some(room => rooms.has(room))) {
+                return false;
+            }
+        }
+        // Check exclude rooms
+        if (this.excludeRooms) {
+            const excludes = Array.isArray(this.excludeRooms) ? this.excludeRooms : [this.excludeRooms];
+            if (excludes.some(room => rooms.has(room))) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=ws-adapter.js.map

package/dist/core/networking/adapters/ws-adapter.js.map

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

package/dist/core/networking/websocket-adapter.d.ts

@@ -0,0 +1,171 @@
+export interface WebSocketAdapterOptions {
+    compression?: boolean;
+    cors?: {
+        origin?: string | string[] | boolean;
+        methods?: string[];
+        credentials?: boolean;
+    };
+    path?: string;
+    maxPayloadLength?: number;
+    idleTimeout?: number;
+    [key: string]: any;
+}
+/**
+ * Abstract WebSocket adapter interface
+ * Allows the framework to work with different WebSocket implementations
+ */
+export interface WebSocketAdapter {
+    /**
+     * Initialize the WebSocket server with the given HTTP server
+     */
+    initialize(httpServer: any, options?: WebSocketAdapterOptions): Promise<void>;
+    /**
+     * Create a namespace for organizing WebSocket connections
+     */
+    createNamespace(namespace: string): WebSocketNamespace;
+    /**
+     * Get the default namespace (usually '/')
+     */
+    getDefaultNamespace(): WebSocketNamespace;
+    /**
+     * Close the WebSocket server and all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Set compression configuration
+     */
+    setCompression(enabled: boolean, options?: any): void;
+    /**
+     * Set custom ID generator for connections
+     */
+    setCustomIdGenerator(generator: () => string): void;
+    /**
+     * Get adapter name/type
+     */
+    getAdapterName(): string;
+    /**
+     * Get connection count across all namespaces
+     */
+    getConnectionCount(): number;
+}
+/**
+ * WebSocket namespace interface
+ * Represents a logical grouping of WebSocket connections
+ */
+export interface WebSocketNamespace {
+    /**
+     * Listen for connection events
+     */
+    on(event: 'connection', handler: (socket: WebSocketConnection) => void): void;
+    /**
+     * Emit event to all connected sockets in this namespace
+     */
+    emit(event: string, data: any): void;
+    /**
+     * Emit to specific room(s)
+     */
+    to(room: string | string[]): WebSocketEmitter;
+    /**
+     * Emit to sockets except those in specified room(s)
+     */
+    except(room: string | string[]): WebSocketEmitter;
+    /**
+     * Get all connected sockets
+     */
+    getSockets(): WebSocketConnection[];
+    /**
+     * Get connection count for this namespace
+     */
+    getConnectionCount(): number;
+    /**
+     * Use middleware for this namespace
+     */
+    use(middleware: (socket: WebSocketConnection, next: (err?: Error) => void) => void): void;
+}
+/**
+ * WebSocket connection interface
+ * Represents an individual client connection
+ */
+export interface WebSocketConnection {
+    /** Unique connection ID */
+    id: string;
+    /** Client IP address */
+    ip?: string;
+    /** Connection headers */
+    headers?: Record<string, string>;
+    /** Custom data storage */
+    data: Record<string, any>;
+    /**
+     * Listen for events from this socket
+     */
+    on(event: string, handler: (data: any, callback?: (response?: any) => void) => void): void;
+    /**
+     * Listen for any event from this socket
+     */
+    onAny(handler: (event: string, ...args: any[]) => void): void;
+    /**
+     * Emit event to this socket
+     */
+    emit(event: string, data: any): void;
+    /**
+     * Emit with compression
+     */
+    compressedEmit?(event: string, data: any): void;
+    /**
+     * Join a room
+     */
+    join(room: string | string[]): void;
+    /**
+     * Leave a room
+     */
+    leave(room: string | string[]): void;
+    /**
+     * Emit to specific room(s)
+     */
+    to(room: string | string[]): WebSocketEmitter;
+    /**
+     * Emit to all sockets except this one
+     */
+    broadcast: WebSocketEmitter;
+    /**
+     * Get rooms this socket has joined
+     */
+    getRooms(): Set<string>;
+    /**
+     * Disconnect this socket
+     */
+    disconnect(close?: boolean): void;
+    /**
+     * Check if socket is connected
+     */
+    connected: boolean;
+}
+/**
+ * WebSocket emitter interface for chaining operations
+ */
+export interface WebSocketEmitter {
+    /**
+     * Emit to target sockets
+     */
+    emit(event: string, data: any): void;
+    /**
+     * Target specific room(s)
+     */
+    to(room: string | string[]): WebSocketEmitter;
+    /**
+     * Exclude specific room(s)
+     */
+    except(room: string | string[]): WebSocketEmitter;
+    /**
+     * Use compression for this emit
+     */
+    compress(compress: boolean): WebSocketEmitter;
+}
+/**
+ * WebSocket middleware function type
+ */
+export type WebSocketMiddleware = (socket: WebSocketConnection, next: (err?: Error) => void) => void;
+/**
+ * WebSocket event handler type
+ */
+export type WebSocketEventHandler = (socket: WebSocketConnection, data: any, callback?: (response?: any) => void) => void | Promise<void>;

package/dist/core/networking/websocket-adapter.js

@@ -0,0 +1,5 @@
+"use strict";
+// WebSocket Adapter Interface for Moro Framework
+// Provides a common interface for different WebSocket implementations
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=websocket-adapter.js.map

package/dist/core/networking/websocket-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-adapter.js","sourceRoot":"","sources":["../../../src/core/networking/websocket-adapter.ts"],"names":[],"mappings":";AAAA,iDAAiD;AACjD,sEAAsE"}

package/dist/core/networking/websocket-manager.d.ts

@@ -1,27 +1,63 @@
-import { Server as SocketIOServer, Namespace } from 'socket.io';
 import { Container } from '../utilities';
 import { ModuleConfig, WebSocketDefinition } from '../../types/module';
+import { WebSocketAdapter, WebSocketNamespace } from './websocket-adapter';
 export declare class WebSocketManager {
-    private io;
+    private adapter;
     private container;
     private circuitBreakers;
     private rateLimiters;
-    private compressionEnabled;
-    private customIdGenerator?;
-    constructor(io: SocketIOServer, container: Container);
-    private setupAdvancedFeatures;
+    private logger;
+    constructor(adapter: WebSocketAdapter, container: Container);
+    /**
+     * Set custom ID generator for the adapter
+     */
     setCustomIdGenerator(generator: () => string): void;
-    enableCompression(options?: {
-        threshold?: number;
-        concurrencyLimit?: number;
-        memLevel?: number;
-    }): void;
-    private processBinaryData;
-    private shouldCompress;
-    registerHandler(namespace: Namespace, wsConfig: WebSocketDefinition, moduleConfig: ModuleConfig): Promise<void>;
-    private setupSocketHandlers;
+    /**
+     * Enable compression for the adapter
+     */
+    enableCompression(options?: any): void;
+    /**
+     * Get the underlying adapter
+     */
+    getAdapter(): WebSocketAdapter;
+    /**
+     * Get connection count across all namespaces
+     */
+    getConnectionCount(): number;
+    /**
+     * Create or get a namespace
+     */
+    getNamespace(namespace: string): WebSocketNamespace;
+    /**
+     * Register WebSocket handlers for a module
+     */
+    registerHandler(namespace: WebSocketNamespace, wsConfig: WebSocketDefinition, moduleConfig: ModuleConfig): Promise<void>;
+    /**
+     * Setup socket-specific middleware
+     */
     private setupSocketMiddleware;
-    private checkRateLimit;
+    /**
+     * Setup handlers for a specific WebSocket configuration
+     */
+    private setupSocketHandlers;
+    /**
+     * Get or create circuit breaker for handler
+     */
     private getCircuitBreaker;
-    private cleanup;
+    /**
+     * Check rate limit for socket and handler
+     */
+    private checkRateLimit;
+    /**
+     * Process binary data efficiently
+     */
+    private processBinaryData;
+    /**
+     * Check if data should be compressed
+     */
+    private shouldCompress;
+    /**
+     * Close the WebSocket manager and underlying adapter
+     */
+    close(): Promise<void>;
 }