@morojs/moro 1.3.0 → 1.4.0

package/README.md

@@ -25,7 +25,8 @@ Moro eliminates the pain points of traditional Node.js frameworks with **intelli
 - **Multi-Runtime Support** - Deploy to Node.js, Vercel Edge, AWS Lambda, Cloudflare Workers
 - **Intelligent Routing** - Chainable + schema-first APIs with automatic middleware ordering
 - **Enterprise Authentication** - Auth.js integration with RBAC, OAuth, and native adapter
-- **Zod Validation** - Type-safe, functional validation with full TypeScript inference
+- **Universal Validation** - Support for Zod, Joi, Yup, Class Validator with full TypeScript inference
+- **WebSocket Support** - Pluggable adapters for Socket.IO, native WebSockets, or auto-detection
 - **Native Performance** - Zero framework overhead, optimized for each runtime
 - **Functional Architecture** - No decorators, pure functional patterns
 - **Zero Order Dependencies** - Framework handles optimal middleware execution
@@ -127,20 +128,30 @@ app.post('/users')
    .handler(createUser);   // Always executed last
 ```
 
-### **Full Type Safety with Zod**
+### **Universal Validation with Full Type Safety**
 
 ```typescript
+// Use any validation library - Zod (default)
+import { z } from '@morojs/moro';
 const UserSchema = z.object({
   name: z.string().min(2).max(50),
   email: z.string().email(),
   age: z.number().min(18).optional()
 });
 
+// Or Joi with adapter
+import { joi } from '@morojs/moro';
+import Joi from 'joi';
+const UserSchema = joi(Joi.object({
+  name: Joi.string().min(2).max(50).required(),
+  email: Joi.string().email().required(),
+  age: Joi.number().min(18).optional()
+}));
+
 app.post('/users')
-   .body(UserSchema)
+   .body(UserSchema)  // Works with any validation library!
    .handler((req, res) => {
-     // req.body is typed as z.infer<typeof UserSchema>
-     // Full IDE support, no type assertions needed!
+     // req.body is fully typed regardless of validation library
      const user = req.body; // ✨ Fully typed
      return { success: true, data: user };
    });
@@ -168,6 +179,45 @@ app.route({
 });
 ```
 
+### WebSocket Support
+
+Pluggable WebSocket adapters with auto-detection:
+
+```typescript
+import { createApp, SocketIOAdapter, WSAdapter } from '@morojs/moro';
+
+const app = createApp({
+  // Auto-detect available WebSocket library
+  websocket: { enabled: true },
+
+  // Or use specific adapter
+  websocket: { adapter: new SocketIOAdapter() },
+
+  // Or native WebSockets
+  websocket: { adapter: new WSAdapter() }
+});
+
+// Define WebSocket handlers
+app.websocket('/chat', {
+  connect: (socket) => {
+    console.log(`Client connected: ${socket.id}`);
+    socket.join('general');
+  },
+
+  message: (socket, data) => {
+    socket.to('general').emit('message', {
+      user: socket.user,
+      text: data.text,
+      timestamp: new Date()
+    });
+  },
+
+  disconnect: (socket) => {
+    console.log(`Client disconnected: ${socket.id}`);
+  }
+});
+```
+
 ### Authentication & Security
 
 Built-in Auth.js integration with enterprise features:
@@ -256,15 +306,19 @@ await app.loadModule(UsersModule);
 - **Multi-Runtime Support** - Same API works on Node.js, Edge, Lambda, and Workers
 - **Intelligent Routing** - Automatic middleware ordering eliminates Express.js pain points
 - **Enterprise Authentication** - Auth.js integration with OAuth, RBAC, and native adapter
+- **Universal Validation** - Support for any validation library with full type safety
+- **WebSocket Flexibility** - Choose between Socket.IO, native WebSockets, or auto-detection
 - **Functional Architecture** - No decorators, pure functions, better performance
-- **Type Safety** - Zod provides compile-time and runtime type safety
+- **Type Safety** - Universal validation with compile-time and runtime type safety
 
 ## Why Choose Moro?
 
 **Same API everywhere** - Write once, deploy to any runtime
 **No middleware dependencies** - Framework handles optimal ordering
 **Enterprise authentication** - Auth.js integration with native adapter
-**Full type safety** - Zod provides end-to-end TypeScript inference
+**Validation flexibility** - Use any validation library (Zod, Joi, Yup, Class Validator)
+**WebSocket choice** - Socket.IO, native WebSockets, or auto-detection
+**Full type safety** - Universal validation provides end-to-end TypeScript inference
 **Clean APIs** - Chainable and schema-first approaches
 **Production ready** - Circuit breakers, rate limiting, events, RBAC
 **Performance optimized** - Runtime-specific adapters

package/dist/core/config/types.d.ts

@@ -0,0 +1,147 @@
+export interface ServerConfig {
+    port: number;
+    host: string;
+    environment: 'development' | 'staging' | 'production';
+    maxConnections: number;
+    timeout: number;
+}
+export interface ServiceDiscoveryConfig {
+    enabled: boolean;
+    type: 'memory' | 'consul' | 'kubernetes';
+    consulUrl: string;
+    kubernetesNamespace: string;
+    healthCheckInterval: number;
+    retryAttempts: number;
+}
+export interface DatabaseConfig {
+    url?: string;
+    redis: {
+        url: string;
+        maxRetries: number;
+        retryDelay: number;
+        keyPrefix: string;
+    };
+    mysql?: {
+        host: string;
+        port: number;
+        database?: string;
+        username?: string;
+        password?: string;
+        connectionLimit: number;
+        acquireTimeout: number;
+        timeout: number;
+    };
+}
+export interface ModuleDefaultsConfig {
+    cache: {
+        enabled: boolean;
+        defaultTtl: number;
+        maxSize: number;
+        strategy: 'lru' | 'lfu' | 'fifo';
+    };
+    rateLimit: {
+        enabled: boolean;
+        defaultRequests: number;
+        defaultWindow: number;
+        skipSuccessfulRequests: boolean;
+        skipFailedRequests: boolean;
+    };
+    validation: {
+        enabled: boolean;
+        stripUnknown: boolean;
+        abortEarly: boolean;
+    };
+}
+export interface LoggingConfig {
+    level: 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+    format: 'pretty' | 'json' | 'compact';
+    enableColors: boolean;
+    enableTimestamp: boolean;
+    enableContext: boolean;
+    outputs: {
+        console: boolean;
+        file: {
+            enabled: boolean;
+            path: string;
+            maxSize: string;
+            maxFiles: number;
+        };
+        webhook: {
+            enabled: boolean;
+            url?: string;
+            headers: Record<string, string>;
+        };
+    };
+}
+export interface SecurityConfig {
+    cors: {
+        enabled: boolean;
+        origin: string | string[] | boolean;
+        methods: string[];
+        allowedHeaders: string[];
+        credentials: boolean;
+    };
+    helmet: {
+        enabled: boolean;
+        contentSecurityPolicy: boolean;
+        hsts: boolean;
+        noSniff: boolean;
+        frameguard: boolean;
+    };
+    rateLimit: {
+        global: {
+            enabled: boolean;
+            requests: number;
+            window: number;
+        };
+    };
+}
+export interface ExternalServicesConfig {
+    stripe?: {
+        secretKey?: string;
+        publishableKey?: string;
+        webhookSecret?: string;
+        apiVersion: string;
+    };
+    paypal?: {
+        clientId?: string;
+        clientSecret?: string;
+        webhookId?: string;
+        environment: 'sandbox' | 'production';
+    };
+    smtp?: {
+        host?: string;
+        port: number;
+        secure: boolean;
+        username?: string;
+        password?: string;
+    };
+}
+export interface PerformanceConfig {
+    compression: {
+        enabled: boolean;
+        level: number;
+        threshold: number;
+    };
+    circuitBreaker: {
+        enabled: boolean;
+        failureThreshold: number;
+        resetTimeout: number;
+        monitoringPeriod: number;
+    };
+    clustering: {
+        enabled: boolean;
+        workers: number | 'auto';
+    };
+}
+export interface AppConfig {
+    server: ServerConfig;
+    serviceDiscovery: ServiceDiscoveryConfig;
+    database: DatabaseConfig;
+    modules: ModuleDefaultsConfig;
+    logging: LoggingConfig;
+    security: SecurityConfig;
+    external: ExternalServicesConfig;
+    performance: PerformanceConfig;
+}
+export declare const DEFAULT_CONFIG: AppConfig;

package/dist/core/config/types.js

@@ -0,0 +1,124 @@
+"use strict";
+// TypeScript-based Configuration Types for Moro Framework
+// Replaces Zod schemas with pure TypeScript interfaces
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+// Default configuration
+exports.DEFAULT_CONFIG = {
+    server: {
+        port: 3001,
+        host: 'localhost',
+        environment: 'development',
+        maxConnections: 1000,
+        timeout: 30000,
+    },
+    serviceDiscovery: {
+        enabled: false,
+        type: 'memory',
+        consulUrl: 'http://localhost:8500',
+        kubernetesNamespace: 'default',
+        healthCheckInterval: 30000,
+        retryAttempts: 3,
+    },
+    database: {
+        redis: {
+            url: 'redis://localhost:6379',
+            maxRetries: 3,
+            retryDelay: 1000,
+            keyPrefix: 'moro:',
+        },
+    },
+    modules: {
+        cache: {
+            enabled: true,
+            defaultTtl: 300,
+            maxSize: 1000,
+            strategy: 'lru',
+        },
+        rateLimit: {
+            enabled: true,
+            defaultRequests: 100,
+            defaultWindow: 60000,
+            skipSuccessfulRequests: false,
+            skipFailedRequests: false,
+        },
+        validation: {
+            enabled: true,
+            stripUnknown: true,
+            abortEarly: false,
+        },
+    },
+    logging: {
+        level: 'info',
+        format: 'pretty',
+        enableColors: true,
+        enableTimestamp: true,
+        enableContext: true,
+        outputs: {
+            console: true,
+            file: {
+                enabled: false,
+                path: './logs/moro.log',
+                maxSize: '10MB',
+                maxFiles: 5,
+            },
+            webhook: {
+                enabled: false,
+                headers: {},
+            },
+        },
+    },
+    security: {
+        cors: {
+            enabled: true,
+            origin: '*',
+            methods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'],
+            allowedHeaders: ['Content-Type', 'Authorization'],
+            credentials: false,
+        },
+        helmet: {
+            enabled: true,
+            contentSecurityPolicy: true,
+            hsts: true,
+            noSniff: true,
+            frameguard: true,
+        },
+        rateLimit: {
+            global: {
+                enabled: false,
+                requests: 1000,
+                window: 60000,
+            },
+        },
+    },
+    external: {
+        stripe: {
+            apiVersion: '2023-10-16',
+        },
+        paypal: {
+            environment: 'sandbox',
+        },
+        smtp: {
+            port: 587,
+            secure: false,
+        },
+    },
+    performance: {
+        compression: {
+            enabled: true,
+            level: 6,
+            threshold: 1024,
+        },
+        circuitBreaker: {
+            enabled: true,
+            failureThreshold: 5,
+            resetTimeout: 60000,
+            monitoringPeriod: 10000,
+        },
+        clustering: {
+            enabled: false,
+            workers: 1,
+        },
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/core/config/types.js.map

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

package/dist/core/config/typescript-loader.d.ts

@@ -0,0 +1,6 @@
+import { AppConfig } from './types';
+/**
+ * Load and validate configuration using TypeScript + simple validation
+ * No Zod dependency required!
+ */
+export declare function loadConfigWithTypeScript(): AppConfig;