@morojs/moro 1.2.1 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morojs/moro",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "High-performance Node.js framework with intelligent routing, automatic middleware ordering, enterprise authentication (Auth.js), type-safe Zod validation, and functional architecture",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,7 +14,7 @@
   },
   "scripts": {
     "build": "tsc",
-    "dev": "ts-node-dev --respawn --transpile-only --ignore-watch node_modules src/index.ts",
+    "dev": "tsx watch src/index.ts",
     "dev:watch": "tsc --watch",
     "clean": "rm -rf dist",
     "prepare": "husky",
@@ -34,8 +34,11 @@
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
     "lint-staged": "lint-staged",
-    "docs:build": "typedoc --out docs src/index.ts",
-    "docs:serve": "http-server docs -p 8080"
+    "docs:build": "typedoc --out docs-html src/index.ts",
+    "docs:serve": "http-server docs-html -p 8080",
+    "docs:json": "typedoc --json docs-json/api.json src/index.ts",
+    "docs:markdown": "typedoc --plugin typedoc-plugin-markdown --out docs-md src/index.ts",
+    "docs:all": "npm run docs:build && npm run docs:json && npm run docs:markdown"
   },
   "keywords": [
     "nodejs",
@@ -70,10 +73,7 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {
-    "socket.io": "^4.8.1",
-    "zod": "^4.1.5"
-  },
+  "dependencies": {},
   "peerDependencies": {
     "@auth/core": "^0.37.3",
     "better-sqlite3": "^12.2.0",
@@ -82,8 +82,13 @@
     "mongodb": "^6.19.0",
     "mysql2": "^3.14.5",
     "pg": "^8.16.3",
+    "socket.io": "^4.8.1",
     "swagger-ui-dist": "^5.28.1",
-    "ts-node": "^10.9.1"
+    "ws": "^8.18.0",
+    "zod": "^4.1.5",
+    "joi": "^17.0.0",
+    "yup": "^1.0.0",
+    "class-validator": "^0.14.0"
   },
   "peerDependenciesMeta": {
     "@auth/core": {
@@ -95,9 +100,6 @@
     "swagger-ui-dist": {
       "optional": true
     },
-    "ts-node": {
-      "optional": true
-    },
     "pg": {
       "optional": true
     },
@@ -112,6 +114,24 @@
     },
     "drizzle-orm": {
       "optional": true
+    },
+    "socket.io": {
+      "optional": true
+    },
+    "ws": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "joi": {
+      "optional": true
+    },
+    "yup": {
+      "optional": true
+    },
+    "class-validator": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -120,6 +140,7 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^24.3.1",
     "@types/supertest": "^6.0.2",
+    "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.18.2",
     "@typescript-eslint/parser": "^8.18.2",
     "depcheck": "^1.4.7",
@@ -131,11 +152,18 @@
     "jest": "^30.1.3",
     "lint-staged": "^16.1.6",
     "prettier": "^3.4.2",
+    "socket.io": "^4.8.1",
     "supertest": "^7.0.0",
     "ts-jest": "^29.4.1",
-    "ts-node-dev": "^2.0.0",
+    "tsx": "^4.7.0",
     "typedoc": "^0.28.12",
-    "typescript": "^5.9.2"
+    "typedoc-github-theme": "^0.3.1",
+    "typedoc-material-theme": "^1.4.0",
+    "typedoc-plugin-extras": "^4.0.1",
+    "typedoc-plugin-markdown": "^4.8.1",
+    "typedoc-theme-hierarchy": "^6.0.0",
+    "typescript": "^5.9.2",
+    "ws": "^8.18.3"
   },
   "files": [
     "dist/**/*",

package/src/core/config/file-loader.ts

@@ -23,11 +23,35 @@ export function loadConfigFileSync(cwd: string = process.cwd()): Partial<AppConf
     logger.debug('No configuration file found');
     return null;
   }
+  // Handle TypeScript files by trying dynamic import (works with tsx/ts-node runtimes)
+  if (configFile.endsWith('.ts')) {
+    logger.debug('Found TypeScript config file, attempting to load with dynamic import');
+    try {
+      // When running under tsx/ts-node, dynamic imports work synchronously for TypeScript
+      // We can use require() with the current environment that already has TypeScript support
+      const config = require(configFile);
+      const configData = config.default || config;
+
+      if (!configData || typeof configData !== 'object') {
+        logger.warn(`Configuration file ${configFile} did not export a valid configuration object`);
+        return null;
+      }
+
+      logger.info(`TypeScript configuration loaded from: ${configFile}`);
+      return configData;
+    } catch (error) {
+      logger.debug(
+        'TypeScript config loading failed in sync mode, this is expected if not running with tsx/ts-node'
+      );
+      logger.debug('Error details:', String(error));
+      return null;
+    }
+  }
 
-  // Only support .js files for synchronous loading to avoid complexity
+  // Only .js files use the standard synchronous loading
   if (!configFile.endsWith('.js')) {
     logger.debug(
-      'Found config file, but only JavaScript files are supported in sync mode. Use loadConfigFile() for TypeScript support.'
+      'Found config file with unsupported extension. Only .js and .ts files are supported.'
     );
     return null;
   }
@@ -129,7 +153,7 @@ async function importConfigFile(filePath: string): Promise<Partial<AppConfig> |
       error.message.includes('Unknown file extension')
     ) {
       throw new Error(
-        `Failed to load TypeScript config file. Make sure you have ts-node installed: npm install --save-dev ts-node`
+        `Failed to load TypeScript config file. Run your application with tsx or ts-node: "tsx your-app.ts" or "ts-node your-app.ts"`
       );
     }
     throw error;
@@ -138,30 +162,15 @@ async function importConfigFile(filePath: string): Promise<Partial<AppConfig> |
 
 /**
  * Setup TypeScript loader for .ts config files
+ * Note: This function is intentionally minimal because TypeScript config files
+ * should be handled by the runtime environment (tsx, ts-node, etc.) when the
+ * user runs their application, not by the framework itself.
  */
 async function setupTypeScriptLoader(): Promise<void> {
-  try {
-    // Try to register ts-node if available
-    const tsNode = await import('ts-node');
-    if (!tsNode.register) {
-      // ts-node might already be registered
-      return;
-    }
-
-    tsNode.register({
-      transpileOnly: true,
-      compilerOptions: {
-        module: 'commonjs',
-        target: 'es2020',
-        moduleResolution: 'node',
-        allowSyntheticDefaultImports: true,
-        esModuleInterop: true,
-      },
-    });
-  } catch (error) {
-    // ts-node not available, try other methods or fail gracefully
-    logger.debug('ts-node not available for TypeScript config loading');
-  }
+  // No-op: TypeScript loading is handled by the runtime environment
+  // When users run `tsx moro.config.ts` or `ts-node moro.config.ts`,
+  // the TypeScript transpilation is already handled by those tools.
+  logger.debug('TypeScript config loading delegated to runtime environment');
 }
 
 /**

package/src/core/config/schema.ts

@@ -243,7 +243,7 @@ const PerformanceConfigSchema = z.object({
 
   clustering: z.object({
     enabled: z.coerce.boolean().default(false),
-    workers: z.coerce.number().min(1).default(1),
+    workers: z.union([z.coerce.number().min(1), z.literal('auto')]).default(1),
   }),
 });
 

package/src/core/config/types.ts

@@ -0,0 +1,277 @@
+// TypeScript-based Configuration Types for Moro Framework
+// Replaces Zod schemas with pure TypeScript interfaces
+
+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';
+  };
+}
+
+// Main configuration interface
+export interface AppConfig {
+  server: ServerConfig;
+  serviceDiscovery: ServiceDiscoveryConfig;
+  database: DatabaseConfig;
+  modules: ModuleDefaultsConfig;
+  logging: LoggingConfig;
+  security: SecurityConfig;
+  external: ExternalServicesConfig;
+  performance: PerformanceConfig;
+}
+
+// Default configuration
+export const DEFAULT_CONFIG: AppConfig = {
+  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,
+    },
+  },
+};