@morojs/moro 1.0.0

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

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketManager = void 0;
+const utilities_1 = require("../utilities");
+class WebSocketManager {
+    constructor(io, container) {
+        this.io = io;
+        this.container = container;
+        this.circuitBreakers = new Map();
+        this.rateLimiters = new Map();
+        this.compressionEnabled = true;
+        this.setupAdvancedFeatures();
+    }
+    setupAdvancedFeatures() {
+        // Enable compression for WebSocket messages
+        if (this.compressionEnabled) {
+            this.io.engine.compression = true;
+            this.io.engine.perMessageDeflate = {
+                threshold: 1024,
+                concurrencyLimit: 10,
+                memLevel: 8,
+            };
+        }
+        // Custom session ID generation if provided
+        if (this.customIdGenerator) {
+            this.io.engine.generateId = this.customIdGenerator;
+        }
+        // Global WebSocket middleware for advanced features
+        this.io.use((socket, next) => {
+            // Add binary message handling
+            socket.onAny((event, ...args) => {
+                // Handle binary frames efficiently
+                args.forEach((arg, index) => {
+                    if (Buffer.isBuffer(arg)) {
+                        // Process binary data with optimizations
+                        args[index] = this.processBinaryData(arg);
+                    }
+                });
+            });
+            // Add compression per message
+            socket.compressedEmit = (event, data) => {
+                if (this.compressionEnabled && this.shouldCompress(data)) {
+                    socket.compress(true).emit(event, data);
+                }
+                else {
+                    socket.emit(event, data);
+                }
+            };
+            // Add heartbeat mechanism
+            socket.heartbeat = () => {
+                socket.emit("heartbeat", { timestamp: Date.now() });
+            };
+            next();
+        });
+    }
+    setCustomIdGenerator(generator) {
+        this.customIdGenerator = generator;
+        this.io.engine.generateId = generator;
+    }
+    enableCompression(options) {
+        this.compressionEnabled = true;
+        if (options) {
+            this.io.engine.perMessageDeflate = {
+                threshold: options.threshold || 1024,
+                concurrencyLimit: options.concurrencyLimit || 10,
+                memLevel: options.memLevel || 8,
+            };
+        }
+    }
+    processBinaryData(buffer) {
+        // Optimize binary data processing
+        // Could add compression, validation, etc.
+        return buffer;
+    }
+    shouldCompress(data) {
+        // Determine if data should be compressed
+        const serialized = JSON.stringify(data);
+        return serialized.length > 1024; // Compress if larger than 1KB
+    }
+    async registerHandler(namespace, wsConfig, moduleConfig) {
+        namespace.on("connection", (socket) => {
+            console.log(`WebSocket connected to /${moduleConfig.name}: ${socket.id}`);
+            this.setupSocketHandlers(socket, wsConfig, moduleConfig);
+            this.setupSocketMiddleware(socket, moduleConfig.name);
+        });
+    }
+    setupSocketHandlers(socket, wsConfig, moduleConfig) {
+        socket.on(wsConfig.event, async (data, callback) => {
+            const handlerKey = `${moduleConfig.name}.${wsConfig.handler}`;
+            try {
+                // Rate limiting
+                if (wsConfig.rateLimit &&
+                    !this.checkRateLimit(socket.id, handlerKey, wsConfig.rateLimit)) {
+                    const error = {
+                        success: false,
+                        error: "Rate limit exceeded",
+                        code: "RATE_LIMIT",
+                    };
+                    if (callback)
+                        callback(error);
+                    else
+                        socket.emit("error", error);
+                    return;
+                }
+                // Validation (Zod-only)
+                if (wsConfig.validation) {
+                    try {
+                        data = wsConfig.validation.parse(data);
+                    }
+                    catch (validationError) {
+                        if (validationError.issues) {
+                            const error = {
+                                success: false,
+                                error: "Validation failed",
+                                details: validationError.issues.map((issue) => ({
+                                    field: issue.path.length > 0 ? issue.path.join(".") : "data",
+                                    message: issue.message,
+                                    code: issue.code,
+                                })),
+                            };
+                            if (callback)
+                                callback(error);
+                            else
+                                socket.emit("error", error);
+                            return;
+                        }
+                        throw validationError;
+                    }
+                }
+                // Circuit breaker protection
+                const circuitBreaker = this.getCircuitBreaker(handlerKey);
+                const result = await circuitBreaker.execute(async () => {
+                    const controller = this.container.resolve(moduleConfig.name);
+                    return await controller[wsConfig.handler](socket, data);
+                });
+                // Handle response
+                if (callback) {
+                    callback({ success: true, data: result });
+                }
+                else if (wsConfig.broadcast && result?.event) {
+                    socket.broadcast.emit(result.event, result.data);
+                }
+                else if (result) {
+                    socket.emit(`${wsConfig.event}:response`, result);
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                const errorCode = error?.code || "INTERNAL_ERROR";
+                console.error(`WebSocket error in ${handlerKey}:`, errorMessage);
+                const errorResponse = {
+                    success: false,
+                    error: errorMessage,
+                    code: errorCode,
+                };
+                if (callback) {
+                    callback(errorResponse);
+                }
+                else {
+                    socket.emit("error", errorResponse);
+                }
+            }
+        });
+    }
+    setupSocketMiddleware(socket, moduleName) {
+        socket.on("disconnect", (reason) => {
+            console.log(`WebSocket disconnected from /${moduleName}: ${socket.id} (${reason})`);
+            this.cleanup(socket.id);
+        });
+        socket.on("ping", () => {
+            socket.emit("pong");
+        });
+    }
+    checkRateLimit(socketId, handlerKey, rateLimit) {
+        if (!this.rateLimiters.has(handlerKey)) {
+            this.rateLimiters.set(handlerKey, new Map());
+        }
+        const handlerLimiter = this.rateLimiters.get(handlerKey);
+        const now = Date.now();
+        const socketLimit = handlerLimiter.get(socketId);
+        if (!socketLimit || now > socketLimit.resetTime) {
+            handlerLimiter.set(socketId, {
+                count: 1,
+                resetTime: now + rateLimit.window,
+            });
+            return true;
+        }
+        if (socketLimit.count >= rateLimit.requests) {
+            return false;
+        }
+        socketLimit.count++;
+        return true;
+    }
+    getCircuitBreaker(key) {
+        if (!this.circuitBreakers.has(key)) {
+            this.circuitBreakers.set(key, new utilities_1.CircuitBreaker({
+                failureThreshold: 5,
+                resetTimeout: 30000,
+                monitoringPeriod: 10000,
+            }));
+        }
+        return this.circuitBreakers.get(key);
+    }
+    cleanup(socketId) {
+        this.rateLimiters.forEach((limiter) => {
+            limiter.delete(socketId);
+        });
+    }
+}
+exports.WebSocketManager = WebSocketManager;
+//# sourceMappingURL=websocket-manager.js.map

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

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

package/dist/core/routing/app-integration.d.ts

@@ -0,0 +1,42 @@
+import { RouteBuilder, RouteSchema, CompiledRoute } from "./index";
+import { HttpRequest, HttpResponse } from "../http";
+export interface IntelligentApp {
+    get(path: string): RouteBuilder;
+    post(path: string): RouteBuilder;
+    put(path: string): RouteBuilder;
+    delete(path: string): RouteBuilder;
+    patch(path: string): RouteBuilder;
+    head(path: string): RouteBuilder;
+    options(path: string): RouteBuilder;
+    route(schema: RouteSchema): CompiledRoute;
+    register(route: CompiledRoute): void;
+    directRoute(method: string, path: string, handler: Function, options?: any): void;
+}
+export declare class RouteRegistry {
+    private routes;
+    private routePatterns;
+    register(route: CompiledRoute): void;
+    handleRequest(req: HttpRequest, res: HttpResponse): Promise<boolean>;
+    getRoutes(): CompiledRoute[];
+    private pathToRegex;
+}
+export declare class IntelligentRoutingManager implements IntelligentApp {
+    private routeRegistry;
+    get(path: string): RouteBuilder;
+    post(path: string): RouteBuilder;
+    put(path: string): RouteBuilder;
+    delete(path: string): RouteBuilder;
+    patch(path: string): RouteBuilder;
+    head(path: string): RouteBuilder;
+    options(path: string): RouteBuilder;
+    route(schema: RouteSchema): CompiledRoute;
+    register(route: CompiledRoute): void;
+    handleIntelligentRoute(req: HttpRequest, res: HttpResponse): Promise<boolean>;
+    getIntelligentRoutes(): CompiledRoute[];
+    directRoute(method: string, path: string, handler: Function, options?: any): void;
+    private createChainableRoute;
+}
+export type AppWithIntelligentRouting = IntelligentApp & {
+    handleIntelligentRoute(req: HttpRequest, res: HttpResponse): Promise<boolean>;
+    getIntelligentRoutes(): CompiledRoute[];
+};

package/dist/core/routing/app-integration.js

@@ -0,0 +1,152 @@
+"use strict";
+// Integration layer for intelligent routing system with main Moro app
+// Provides both chainable and schema-first APIs
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntelligentRoutingManager = exports.RouteRegistry = void 0;
+const index_1 = require("./index");
+const logger_1 = require("../logger");
+const logger = (0, logger_1.createFrameworkLogger)("AppIntegration");
+// Route registry for managing compiled routes
+class RouteRegistry {
+    constructor() {
+        this.routes = new Map();
+        this.routePatterns = [];
+    }
+    register(route) {
+        const key = `${route.schema.method}:${route.schema.path}`;
+        this.routes.set(key, route);
+        // Convert path to regex pattern for matching
+        const { pattern, paramNames } = this.pathToRegex(route.schema.path);
+        this.routePatterns.push({
+            pattern,
+            route,
+            method: route.schema.method,
+            paramNames,
+        });
+        logger.debug(`Registered route: ${key}`, "RouteRegistry", {
+            path: route.schema.path,
+            hasValidation: !!route.schema.validation,
+            hasAuth: !!route.schema.auth,
+            hasRateLimit: !!route.schema.rateLimit,
+        });
+    }
+    async handleRequest(req, res) {
+        const method = req.method?.toUpperCase();
+        const path = req.path;
+        // Find matching route
+        for (const routePattern of this.routePatterns) {
+            if (routePattern.method === method && routePattern.pattern.test(path)) {
+                // Extract path parameters
+                const matches = path.match(routePattern.pattern);
+                if (matches) {
+                    req.params = {};
+                    routePattern.paramNames.forEach((name, index) => {
+                        req.params[name] = matches[index + 1];
+                    });
+                }
+                // Execute the route
+                await routePattern.route.execute(req, res);
+                return true; // Route handled
+            }
+        }
+        return false; // No route matched
+    }
+    getRoutes() {
+        return Array.from(this.routes.values());
+    }
+    pathToRegex(path) {
+        const paramNames = [];
+        // Convert path parameters like :id to regex groups
+        const regexPath = path
+            .replace(/\//g, "\\/") // Escape forward slashes
+            .replace(/:([^/]+)/g, (match, paramName) => {
+            paramNames.push(paramName);
+            return "([^/]+)"; // Match parameter value
+        });
+        return {
+            pattern: new RegExp(`^${regexPath}$`),
+            paramNames,
+        };
+    }
+}
+exports.RouteRegistry = RouteRegistry;
+// Intelligent routing manager class
+class IntelligentRoutingManager {
+    constructor() {
+        this.routeRegistry = new RouteRegistry();
+    }
+    // Chainable route methods
+    get(path) {
+        return this.createChainableRoute("GET", path);
+    }
+    post(path) {
+        return this.createChainableRoute("POST", path);
+    }
+    put(path) {
+        return this.createChainableRoute("PUT", path);
+    }
+    delete(path) {
+        return this.createChainableRoute("DELETE", path);
+    }
+    patch(path) {
+        return this.createChainableRoute("PATCH", path);
+    }
+    head(path) {
+        return this.createChainableRoute("HEAD", path);
+    }
+    options(path) {
+        return this.createChainableRoute("OPTIONS", path);
+    }
+    // Schema-first route method
+    route(schema) {
+        const compiledRoute = (0, index_1.defineRoute)(schema);
+        this.register(compiledRoute);
+        return compiledRoute;
+    }
+    // Register compiled route
+    register(route) {
+        this.routeRegistry.register(route);
+    }
+    // Handle incoming requests with intelligent routing
+    async handleIntelligentRoute(req, res) {
+        return await this.routeRegistry.handleRequest(req, res);
+    }
+    // Get all registered routes (useful for debugging/docs)
+    getIntelligentRoutes() {
+        return this.routeRegistry.getRoutes();
+    }
+    // Direct route method (deprecated)
+    directRoute(method, path, handler, options) {
+        logger.warn("Using deprecated direct route method", "DirectRoute", {
+            method,
+            path,
+            suggestion: "Use chainable or schema-first API instead",
+        });
+        // Convert direct options to new schema format
+        const schema = {
+            method: method.toUpperCase(),
+            path,
+            handler: handler,
+        };
+        if (options?.validation) {
+            schema.validation = { body: options.validation };
+        }
+        if (options?.rateLimit) {
+            schema.rateLimit = options.rateLimit;
+        }
+        this.route(schema);
+    }
+    createChainableRoute(method, path) {
+        const builder = (0, index_1.createRoute)(method, path);
+        // Override the handler method to auto-register the route
+        const originalHandler = builder.handler.bind(builder);
+        builder.handler = (handler) => {
+            const compiledRoute = originalHandler(handler);
+            this.register(compiledRoute);
+            return compiledRoute;
+        };
+        return builder;
+    }
+}
+exports.IntelligentRoutingManager = IntelligentRoutingManager;
+//# sourceMappingURL=app-integration.js.map

package/dist/core/routing/app-integration.js.map

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

package/dist/core/routing/index.d.ts

@@ -0,0 +1,106 @@
+import { ZodSchema } from "zod";
+import { HttpRequest, HttpResponse } from "../http";
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
+export type RouteHandler<T = any> = (req: HttpRequest, res: HttpResponse) => T | Promise<T>;
+export type Middleware = (req: HttpRequest, res: HttpResponse, next: () => void) => void | Promise<void>;
+export interface ValidationConfig {
+    body?: ZodSchema;
+    query?: ZodSchema;
+    params?: ZodSchema;
+    headers?: ZodSchema;
+}
+export interface AuthConfig {
+    roles?: string[];
+    permissions?: string[];
+    optional?: boolean;
+}
+export interface RateLimitConfig {
+    requests: number;
+    window: number;
+    skipSuccessfulRequests?: boolean;
+}
+export interface CacheConfig {
+    ttl: number;
+    key?: string;
+    tags?: string[];
+}
+export interface MiddlewarePhases {
+    before?: Middleware[];
+    after?: Middleware[];
+    transform?: Middleware[];
+}
+export interface RouteSchema {
+    method: HttpMethod;
+    path: string;
+    handler: RouteHandler;
+    validation?: ValidationConfig;
+    auth?: AuthConfig;
+    rateLimit?: RateLimitConfig;
+    cache?: CacheConfig;
+    middleware?: MiddlewarePhases;
+    description?: string;
+    tags?: string[];
+}
+export declare const EXECUTION_PHASES: readonly ["security", "parsing", "rateLimit", "before", "auth", "validation", "transform", "cache", "after", "handler"];
+export type ExecutionPhase = (typeof EXECUTION_PHASES)[number];
+export interface ValidatedRequest<T = any> extends HttpRequest {
+    validatedBody?: T;
+    validatedQuery?: any;
+    validatedParams?: any;
+    validatedHeaders?: any;
+    user?: any;
+}
+export interface RouteBuilder {
+    validate(config: ValidationConfig): RouteBuilder;
+    body<T>(schema: ZodSchema<T>): RouteBuilder;
+    query<T>(schema: ZodSchema<T>): RouteBuilder;
+    params<T>(schema: ZodSchema<T>): RouteBuilder;
+    headers<T>(schema: ZodSchema<T>): RouteBuilder;
+    auth(config: AuthConfig): RouteBuilder;
+    rateLimit(config: RateLimitConfig): RouteBuilder;
+    cache(config: CacheConfig): RouteBuilder;
+    before(...middleware: Middleware[]): RouteBuilder;
+    after(...middleware: Middleware[]): RouteBuilder;
+    transform(...middleware: Middleware[]): RouteBuilder;
+    use(...middleware: Middleware[]): RouteBuilder;
+    describe(description: string): RouteBuilder;
+    tag(...tags: string[]): RouteBuilder;
+    handler<T>(handler: RouteHandler<T>): CompiledRoute;
+}
+export interface CompiledRoute {
+    schema: RouteSchema;
+    execute(req: HttpRequest, res: HttpResponse): Promise<void>;
+}
+export declare class IntelligentRouteBuilder implements RouteBuilder {
+    private schema;
+    constructor(method: HttpMethod, path: string);
+    validate(config: ValidationConfig): RouteBuilder;
+    body<T>(schema: ZodSchema<T>): RouteBuilder;
+    query<T>(schema: ZodSchema<T>): RouteBuilder;
+    params<T>(schema: ZodSchema<T>): RouteBuilder;
+    headers<T>(schema: ZodSchema<T>): RouteBuilder;
+    auth(config: AuthConfig): RouteBuilder;
+    rateLimit(config: RateLimitConfig): RouteBuilder;
+    cache(config: CacheConfig): RouteBuilder;
+    before(...middleware: Middleware[]): RouteBuilder;
+    after(...middleware: Middleware[]): RouteBuilder;
+    transform(...middleware: Middleware[]): RouteBuilder;
+    use(...middleware: Middleware[]): RouteBuilder;
+    describe(description: string): RouteBuilder;
+    tag(...tags: string[]): RouteBuilder;
+    handler<T>(handler: RouteHandler<T>): CompiledRoute;
+}
+export declare class ExecutableRoute implements CompiledRoute {
+    readonly schema: RouteSchema;
+    constructor(schema: RouteSchema);
+    execute(req: HttpRequest, res: HttpResponse): Promise<void>;
+    private executePhase;
+    private executeMiddleware;
+    private executeRateLimit;
+    private executeAuth;
+    private executeValidation;
+    private sendValidationError;
+    private executeCache;
+}
+export declare function createRoute(method: HttpMethod, path: string): RouteBuilder;
+export declare function defineRoute(schema: RouteSchema): CompiledRoute;