@morojs/moro 1.6.1 → 1.6.2

package/jest.config.mjs

@@ -0,0 +1,41 @@
+export default {
+    preset: 'ts-jest/presets/default-esm',
+    testEnvironment: 'node',
+    extensionsToTreatAsEsm: ['.ts'],
+    moduleNameMapper: {
+        '^(\\.{1,2}/.*)\\.js$': '$1',
+    },
+    transform: {
+        '^.+\\.ts$': [
+            'ts-jest',
+            {
+                useESM: true,
+                tsconfig: {
+                    module: 'ESNext',
+                    moduleResolution: 'NodeNext',
+                    target: 'ES2022',
+                    esModuleInterop: true,
+                    isolatedModules: true,
+                },
+            },
+        ],
+    },
+    roots: ['<rootDir>/src', '<rootDir>/tests'],
+    testMatch: ['**/tests/**/*.test.ts', '**/src/**/*.test.ts'],
+    collectCoverageFrom: [
+        'src/**/*.ts',
+        '!src/**/*.d.ts',
+        '!src/**/*.test.ts',
+        '!src/**/index.ts',
+    ],
+    coverageDirectory: 'coverage',
+    coverageReporters: ['text', 'lcov', 'html'],
+    setupFilesAfterEnv: ['<rootDir>/tests/setup.ts'],
+    testTimeout: 15000,
+    maxWorkers: 1,
+    forceExit: false,
+    detectOpenHandles: true,
+    openHandlesTimeout: 1000,
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+};
+

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@morojs/moro",
-  "version": "1.6.1",
-  "description": "High-performance Node.js framework with intelligent routing, automatic middleware ordering, enterprise authentication (Auth.js), type-safe Zod validation, and functional architecture",
+  "version": "1.6.2",
+  "description": "High-performance Node.js framework with intelligent routing, automatic middleware ordering, enterprise authentication (Auth.js), type-safe validation, and functional architecture",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "development": "./src/index.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.js",
       "types": "./dist/index.d.ts"
     }
   },
@@ -29,20 +29,22 @@
     "test:ci": "jest --coverage --watchAll=false --ci --forceExit",
     "test:force": "jest --forceExit",
     "test:all": "npm run test:unit && npm run test:integration && npm run test:e2e",
+    "test:dist": "npm run build && node scripts/validate-dist.mjs",
+    "test:package": "npm run build && node scripts/validate-package.mjs",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
     "lint-staged": "lint-staged",
     "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",
-    "prerelease": "node scripts/release.js",
-    "prerelease:patch": "node scripts/release.js patch",
-    "prerelease:minor": "node scripts/release.js minor",
-    "prerelease:major": "node scripts/release.js major"
+    "prerelease": "npm run build && npm test && npm run test:package && node scripts/release.js",
+    "prerelease:patch": "npm run build && npm test && npm run test:package && node scripts/release.js patch",
+    "prerelease:minor": "npm run build && npm test && npm run test:package && node scripts/release.js minor",
+    "prerelease:major": "npm run build && npm test && npm run test:package && node scripts/release.js major"
   },
   "keywords": [
     "nodejs",
@@ -89,8 +91,9 @@
     "pg": "^8.16.3",
     "socket.io": "^4.8.1",
     "swagger-ui-dist": "^5.28.1",
+    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.52.0",
     "ws": "^8.18.0",
-    "yup": "^1.0.0"
+    "yup": "^1.7.1"
   },
   "peerDependenciesMeta": {
     "@auth/core": {
@@ -120,6 +123,9 @@
     "socket.io": {
       "optional": true
     },
+    "uWebSockets.js": {
+      "optional": true
+    },
     "ws": {
       "optional": true
     },
@@ -165,6 +171,7 @@
     "typedoc-plugin-markdown": "^4.8.1",
     "typedoc-theme-hierarchy": "^6.0.0",
     "typescript": "^5.9.2",
+    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.52.0",
     "ws": "^8.18.3",
     "zod": "^4.1.8"
   },
@@ -174,49 +181,9 @@
     "README.md",
     "LICENSE",
     "API.md",
-    "tsconfig.json"
+    "tsconfig.json",
+    "jest.config.mjs"
   ],
-  "jest": {
-    "preset": "ts-jest",
-    "testEnvironment": "node",
-    "roots": [
-      "<rootDir>/src",
-      "<rootDir>/tests"
-    ],
-    "testMatch": [
-      "**/tests/**/*.test.ts",
-      "**/src/**/*.test.ts"
-    ],
-    "transform": {
-      "^.+\\.ts$": [
-        "ts-jest",
-        {}
-      ]
-    },
-    "collectCoverageFrom": [
-      "src/**/*.ts",
-      "!src/**/*.d.ts",
-      "!src/**/*.test.ts",
-      "!src/**/index.ts"
-    ],
-    "coverageDirectory": "coverage",
-    "coverageReporters": [
-      "text",
-      "lcov",
-      "html"
-    ],
-    "setupFilesAfterEnv": [
-      "<rootDir>/tests/setup.ts"
-    ],
-    "testTimeout": 15000,
-    "maxWorkers": 1,
-    "forceExit": false,
-    "detectOpenHandles": true,
-    "openHandlesTimeout": 1000,
-    "extensionsToTreatAsEsm": [
-      ".ts"
-    ]
-  },
   "lint-staged": {
     "src/**/*.ts": [
       "prettier --write",

package/src/core/auth/morojs-adapter.ts

@@ -8,7 +8,9 @@
  * @see https://github.com/nextauthjs/next-auth/tree/main/packages
  */
 
-import { logger } from '../logger';
+import { createFrameworkLogger } from '../logger/index.js';
+
+const logger = createFrameworkLogger('AuthAdapter');
 
 // Mock Auth.js types until we have the actual package
 // These would come from @auth/core in a real implementation
@@ -249,7 +251,7 @@ export async function MoroJSAuth(config: MoroJSAuthConfig): Promise<{
           basePath,
           raw: (code: any, ...message: any[]) => {
             if (config.morojs?.debug) {
-              logger.debug(`[MoroJS Auth] ${code}:`, 'AuthAdapter', { code, message });
+              logger.debug(`[MoroJS Auth] ${code}:`, 'AuthAdapter', { message });
             }
           },
         });
@@ -263,7 +265,7 @@ export async function MoroJSAuth(config: MoroJSAuthConfig): Promise<{
         // Convert Web API response to MoroJS response
         await fromWebResponse(finalResponse, res);
       } catch (error) {
-        logger.error('[MoroJS Auth] Error:', 'AuthAdapter', {
+        logger.error('[MoroJS Auth] Error', 'AuthAdapter', {
           error: error instanceof Error ? error.message : String(error),
         });
         // Robust error handling - check if response methods exist
@@ -312,7 +314,7 @@ export async function MoroJSAuth(config: MoroJSAuthConfig): Promise<{
         return null;
       } catch (error) {
         if (config.morojs?.debug) {
-          logger.error('[MoroJS Auth] Session error:', 'AuthAdapter', {
+          logger.error('[MoroJS Auth] Session error', 'AuthAdapter', {
             error: error instanceof Error ? error.message : String(error),
           });
         }
@@ -328,18 +330,21 @@ export async function MoroJSAuth(config: MoroJSAuthConfig): Promise<{
  * This creates a MoroJS-compatible middleware for authentication
  */
 export function createAuthMiddleware(config: MoroJSAuthConfig) {
-  logger.info('🏭 createAuthMiddleware called - creating middleware function', 'AuthAdapter');
+  logger.info('createAuthMiddleware called - creating middleware function', 'AuthAdapter');
   // Return a function that MoroJS can call directly
   return async (app: any) => {
-    logger.info('🔧 Installing Auth.js middleware...', 'AuthAdapter');
-    logger.info(`📦 App object received: ${typeof app} ${app.constructor.name}`, 'AuthAdapter');
+    logger.info('Installing Auth.js middleware...', 'AuthAdapter');
+    logger.debug('App object received', 'AuthAdapter', {
+      appType: typeof app,
+      appConstructor: app.constructor.name,
+    });
 
     // Get the hooks from the app's middleware system
     const hooks =
       (app as any).coreFramework?.middlewareManager?.hooks || (app as any).middlewareManager?.hooks;
 
     if (!hooks) {
-      logger.error('❌ Could not access MoroJS hooks system', 'AuthAdapter');
+      logger.error('Could not access MoroJS hooks system', 'AuthAdapter');
       return;
     }
 
@@ -350,9 +355,9 @@ export function createAuthMiddleware(config: MoroJSAuthConfig) {
 
     // Register request hook
     hooks.before('request', async (context: any) => {
-      logger.debug('🔒 Native adapter hook starting...', 'AuthAdapter');
+      logger.debug('Native adapter hook starting', 'AuthAdapter');
       const req = context.request;
-      logger.debug(`📝 Request path: ${req.path || req.url}`, 'AuthAdapter');
+      logger.debug('Request path', 'AuthAdapter', { path: req.path || req.url });
 
       try {
         // Just add auth object to request - don't touch response
@@ -389,16 +394,16 @@ export function createAuthMiddleware(config: MoroJSAuthConfig) {
             return { url: signOutUrl };
           },
         };
-        logger.debug('✅ Native adapter hook completed successfully', 'AuthAdapter');
+        logger.debug('Native adapter hook completed successfully', 'AuthAdapter');
       } catch (error) {
-        logger.error('❌ Error in native adapter hook:', 'AuthAdapter', {
+        logger.error('Error in native adapter hook', 'AuthAdapter', {
           error: error instanceof Error ? error.message : String(error),
         });
         throw error;
       }
     });
 
-    logger.info('✅ Auth.js middleware installed successfully!', 'AuthAdapter');
+    logger.info('Auth.js middleware installed successfully!', 'AuthAdapter');
   };
 }
 

package/src/core/config/config-manager.ts

@@ -0,0 +1,133 @@
+/**
+ * Configuration Manager - Immutable Single Source of Truth
+ *
+ * This module provides centralized, immutable configuration state management.
+ * Configuration is locked at createApp() initialization and cannot be changed afterward.
+ *
+ * Precedence: Environment Variables > createApp Options > Config File > Defaults
+ */
+
+import { AppConfig } from '../../types/config.js';
+import { createFrameworkLogger } from '../logger/index.js';
+
+const logger = createFrameworkLogger('ConfigManager');
+
+/**
+ * Global configuration state - immutable after initialization
+ */
+let globalConfig: Readonly<AppConfig> | null = null;
+let isLocked = false;
+
+/**
+ * Initialize and lock global configuration state
+ * This should only be called once during createApp() initialization
+ */
+export function initializeAndLockConfig(config: AppConfig): void {
+  if (isLocked) {
+    throw new Error(
+      'Configuration is already locked and cannot be changed. ' +
+        'Configuration can only be set once during createApp() initialization.'
+    );
+  }
+
+  // Deep freeze the configuration to make it truly immutable
+  globalConfig = deepFreeze(config);
+  isLocked = true;
+
+  logger.info(
+    `Configuration locked and initialized: ${process.env.NODE_ENV || 'development'}:${config.server.port}`
+  );
+}
+
+/**
+ * Get the current global configuration
+ * Throws if configuration hasn't been initialized
+ */
+export function getGlobalConfig(): Readonly<AppConfig> {
+  if (!globalConfig || !isLocked) {
+    throw new Error(
+      'Configuration not initialized. Call createApp() to initialize the configuration system.'
+    );
+  }
+  return globalConfig;
+}
+
+/**
+ * Check if configuration has been initialized and locked
+ */
+export function isConfigLocked(): boolean {
+  return isLocked && globalConfig !== null;
+}
+
+/**
+ * Reset configuration state (for testing only)
+ * @internal - This should only be used in tests
+ */
+export function resetConfigForTesting(): void {
+  if (
+    process.env.NODE_ENV !== 'test' &&
+    !process.env.MORO_ALLOW_CONFIG_RESET &&
+    !process.env.JEST_WORKER_ID
+  ) {
+    throw new Error(
+      'Configuration reset is only allowed in test environments. ' +
+        'Set MORO_ALLOW_CONFIG_RESET=true to override this check.'
+    );
+  }
+
+  globalConfig = null;
+  isLocked = false;
+  logger.debug('Configuration state reset for testing');
+}
+
+/**
+ * Deep freeze an object to make it truly immutable
+ * This prevents any accidental mutations to the configuration
+ */
+function deepFreeze<T>(obj: T): Readonly<T> {
+  // Get property names
+  const propNames = Object.getOwnPropertyNames(obj);
+
+  // Freeze properties before freezing self
+  for (const name of propNames) {
+    const value = (obj as any)[name];
+
+    if (value && typeof value === 'object') {
+      deepFreeze(value);
+    }
+  }
+
+  return Object.freeze(obj);
+}
+
+/**
+ * Get a specific configuration value using dot notation
+ * This provides a safe way to access nested config values
+ *
+ * @example
+ * getConfigValue('server.port') // Returns the server port
+ * getConfigValue('database.redis.url') // Returns the Redis URL
+ */
+export function getConfigValue<T = any>(path: string): T | undefined {
+  const config = getGlobalConfig();
+
+  return path.split('.').reduce((obj: any, key: string) => {
+    return obj && obj[key] !== undefined ? obj[key] : undefined;
+  }, config);
+}
+
+/**
+ * Utility functions for common environment checks
+ * These now read NODE_ENV directly for consistency with Node.js ecosystem
+ */
+export function isDevelopment(): boolean {
+  return process.env.NODE_ENV === 'development';
+}
+
+export function isProduction(): boolean {
+  return process.env.NODE_ENV === 'production';
+}
+
+export function isStaging(): boolean {
+  return process.env.NODE_ENV === 'staging';
+}