@morojs/moro 1.3.0 → 1.4.0

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

@@ -0,0 +1,244 @@
+"use strict";
+// Socket.IO WebSocket Adapter for Moro Framework
+// Implements the WebSocket adapter interface using Socket.IO
+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.SocketIOAdapter = void 0;
+/**
+ * Socket.IO adapter implementation
+ */
+class SocketIOAdapter {
+    async initialize(httpServer, options = {}) {
+        try {
+            // Dynamic import to avoid requiring socket.io as a hard dependency
+            const { Server } = await Promise.resolve().then(() => __importStar(require('socket.io')));
+            this.io = new Server(httpServer, {
+                cors: options.cors || { origin: '*' },
+                path: options.path || '/socket.io/',
+                compression: options.compression !== false,
+                maxHttpBufferSize: options.maxPayloadLength,
+                ...options,
+            });
+            // Apply custom ID generator if set
+            if (this.customIdGenerator) {
+                this.io.engine.generateId = this.customIdGenerator;
+            }
+            // Setup compression if enabled
+            if (options.compression) {
+                this.setCompression(true);
+            }
+        }
+        catch (error) {
+            throw new Error('Socket.IO not found. Install it with: npm install socket.io\n' +
+                'Or use a different WebSocket adapter.');
+        }
+    }
+    createNamespace(namespace) {
+        if (!this.io) {
+            throw new Error('Socket.IO adapter not initialized');
+        }
+        const ns = this.io.of(namespace);
+        return new SocketIONamespaceWrapper(ns);
+    }
+    getDefaultNamespace() {
+        return this.createNamespace('/');
+    }
+    async close() {
+        if (this.io) {
+            return new Promise(resolve => {
+                this.io.close(() => resolve());
+            });
+        }
+    }
+    setCompression(enabled, options = {}) {
+        if (this.io && enabled) {
+            this.io.engine.compression = true;
+            this.io.engine.perMessageDeflate = {
+                threshold: 1024,
+                concurrencyLimit: 10,
+                memLevel: 8,
+                ...options,
+            };
+        }
+    }
+    setCustomIdGenerator(generator) {
+        this.customIdGenerator = generator;
+        if (this.io) {
+            this.io.engine.generateId = generator;
+        }
+    }
+    getAdapterName() {
+        return 'socket.io';
+    }
+    getConnectionCount() {
+        if (!this.io)
+            return 0;
+        return this.io.engine.clientsCount || 0;
+    }
+}
+exports.SocketIOAdapter = SocketIOAdapter;
+/**
+ * Socket.IO namespace wrapper
+ */
+class SocketIONamespaceWrapper {
+    constructor(namespace) {
+        this.namespace = namespace;
+    }
+    on(event, handler) {
+        this.namespace.on(event, (socket) => {
+            handler(new SocketIOConnectionWrapper(socket));
+        });
+    }
+    emit(event, data) {
+        this.namespace.emit(event, data);
+    }
+    to(room) {
+        const target = Array.isArray(room)
+            ? room.reduce((acc, r) => acc.to(r), this.namespace)
+            : this.namespace.to(room);
+        return new SocketIOEmitterWrapper(target);
+    }
+    except(room) {
+        const target = Array.isArray(room)
+            ? room.reduce((acc, r) => acc.except(r), this.namespace)
+            : this.namespace.except(room);
+        return new SocketIOEmitterWrapper(target);
+    }
+    getSockets() {
+        const sockets = this.namespace.sockets;
+        return Array.from(sockets.values()).map((socket) => new SocketIOConnectionWrapper(socket));
+    }
+    getConnectionCount() {
+        return this.namespace.sockets.size;
+    }
+    use(middleware) {
+        this.namespace.use((socket, next) => {
+            middleware(new SocketIOConnectionWrapper(socket), next);
+        });
+    }
+}
+/**
+ * Socket.IO connection wrapper
+ */
+class SocketIOConnectionWrapper {
+    constructor(socket) {
+        this.socket = socket;
+        this.data = {};
+        // Map socket.data to our data property
+        this.data = socket.data || {};
+    }
+    get id() {
+        return this.socket.id;
+    }
+    get ip() {
+        return this.socket.handshake?.address;
+    }
+    get headers() {
+        return this.socket.handshake?.headers;
+    }
+    get connected() {
+        return this.socket.connected;
+    }
+    get broadcast() {
+        return new SocketIOEmitterWrapper(this.socket.broadcast);
+    }
+    on(event, handler) {
+        this.socket.on(event, handler);
+    }
+    onAny(handler) {
+        this.socket.onAny(handler);
+    }
+    emit(event, data) {
+        this.socket.emit(event, data);
+    }
+    compressedEmit(event, data) {
+        this.socket.compress(true).emit(event, data);
+    }
+    join(room) {
+        if (Array.isArray(room)) {
+            room.forEach(r => this.socket.join(r));
+        }
+        else {
+            this.socket.join(room);
+        }
+    }
+    leave(room) {
+        if (Array.isArray(room)) {
+            room.forEach(r => this.socket.leave(r));
+        }
+        else {
+            this.socket.leave(room);
+        }
+    }
+    to(room) {
+        const target = Array.isArray(room)
+            ? room.reduce((acc, r) => acc.to(r), this.socket)
+            : this.socket.to(room);
+        return new SocketIOEmitterWrapper(target);
+    }
+    getRooms() {
+        return new Set(this.socket.rooms);
+    }
+    disconnect(close) {
+        this.socket.disconnect(close);
+    }
+}
+/**
+ * Socket.IO emitter wrapper
+ */
+class SocketIOEmitterWrapper {
+    constructor(emitter) {
+        this.emitter = emitter;
+    }
+    emit(event, data) {
+        this.emitter.emit(event, data);
+    }
+    to(room) {
+        const target = Array.isArray(room)
+            ? room.reduce((acc, r) => acc.to(r), this.emitter)
+            : this.emitter.to(room);
+        return new SocketIOEmitterWrapper(target);
+    }
+    except(room) {
+        const target = Array.isArray(room)
+            ? room.reduce((acc, r) => acc.except(r), this.emitter)
+            : this.emitter.except(room);
+        return new SocketIOEmitterWrapper(target);
+    }
+    compress(compress) {
+        return new SocketIOEmitterWrapper(this.emitter.compress(compress));
+    }
+}
+//# sourceMappingURL=socketio-adapter.js.map

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

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

package/dist/core/networking/adapters/ws-adapter.d.ts

@@ -0,0 +1,54 @@
+import { WebSocketAdapter, WebSocketAdapterOptions, WebSocketNamespace, WebSocketConnection, WebSocketEmitter } from '../websocket-adapter';
+/**
+ * Native WebSocket adapter using the 'ws' library
+ * Provides a lightweight, standards-compliant WebSocket implementation
+ */
+export declare class WSAdapter implements WebSocketAdapter {
+    private wss;
+    private namespaces;
+    private connections;
+    private customIdGenerator?;
+    private connectionCounter;
+    initialize(httpServer: any, options?: WebSocketAdapterOptions): Promise<void>;
+    private handleConnection;
+    createNamespace(namespace: string): WebSocketNamespace;
+    getDefaultNamespace(): WebSocketNamespace;
+    close(): Promise<void>;
+    setCompression(enabled: boolean, _options?: any): void;
+    setCustomIdGenerator(generator: () => string): void;
+    getAdapterName(): string;
+    getConnectionCount(): number;
+    generateId(): string;
+    addConnection(id: string, connection: WSConnectionWrapper): void;
+    removeConnection(id: string): void;
+    getAllConnections(): Map<string, WSConnectionWrapper>;
+}
+/**
+ * WebSocket connection wrapper
+ */
+declare class WSConnectionWrapper implements WebSocketConnection {
+    readonly id: string;
+    readonly ws: any;
+    private request;
+    data: Record<string, any>;
+    private eventHandlers;
+    private anyHandlers;
+    private rooms;
+    private _connected;
+    constructor(id: string, ws: any, request: any);
+    get ip(): string | undefined;
+    get headers(): Record<string, string> | undefined;
+    get connected(): boolean;
+    get broadcast(): WebSocketEmitter;
+    on(event: string, handler: (data: any, callback?: (response?: any) => void) => void): void;
+    onAny(handler: (event: string, ...args: any[]) => void): void;
+    emit(event: string, data?: any): void;
+    compressedEmit(event: string, data: any): void;
+    join(room: string | string[]): void;
+    leave(room: string | string[]): void;
+    to(room: string | string[]): WebSocketEmitter;
+    getRooms(): Set<string>;
+    disconnect(close?: boolean): void;
+    private handleMessage;
+}
+export {};

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