@morojs/moro 1.0.2 → 1.1.0

package/dist/core/config/utils.js

@@ -32,12 +32,53 @@ function getConfig() {
     }
     return appConfig;
 }
+/**
+ * Coerce environment variable string values to appropriate types
+ */
+function coerceEnvironmentValue(value) {
+    // Handle boolean values
+    if (value.toLowerCase() === 'true')
+        return true;
+    if (value.toLowerCase() === 'false')
+        return false;
+    // Handle numeric values
+    if (/^\d+$/.test(value)) {
+        const num = parseInt(value, 10);
+        return num;
+    }
+    if (/^\d+\.\d+$/.test(value)) {
+        const num = parseFloat(value);
+        return num;
+    }
+    // Handle JSON objects/arrays
+    if ((value.startsWith('{') && value.endsWith('}')) ||
+        (value.startsWith('[') && value.endsWith(']'))) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            // If JSON parsing fails, return as string
+            return value;
+        }
+    }
+    // Return as string for all other cases
+    return value;
+}
 /**
  * Create module-specific configuration with environment override support
  */
 function createModuleConfig(schema, defaultConfig, envPrefix) {
-    const globalConfig = getConfig();
-    // Build environment configuration object
+    // Try to get global config, but don't fail if not initialized
+    let globalConfig = {};
+    try {
+        const { getGlobalConfig } = require('./index');
+        globalConfig = getGlobalConfig();
+    }
+    catch {
+        // Global config not initialized - use empty object (module config can still work independently)
+        globalConfig = {};
+    }
+    // Build environment configuration object with type coercion
     const envConfig = {};
     if (envPrefix) {
         // Extract environment variables with the given prefix
@@ -47,13 +88,19 @@ function createModuleConfig(schema, defaultConfig, envPrefix) {
                     .substring(envPrefix.length)
                     .toLowerCase()
                     .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-                envConfig[configKey] = process.env[key];
+                const envValue = process.env[key];
+                if (envValue !== undefined) {
+                    // Attempt basic type coercion for common types
+                    envConfig[configKey] = coerceEnvironmentValue(envValue);
+                }
             }
         });
     }
     // Merge default config, global defaults, and environment overrides
+    // Priority: environment variables > global config > default config
     const mergedConfig = {
         ...defaultConfig,
+        ...globalConfig, // Now actually using global config!
         ...envConfig,
     };
     try {

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

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

package/dist/index.d.ts

@@ -21,7 +21,8 @@ export type { RouteBuilder, RouteSchema, CompiledRoute, HttpMethod, AuthConfig,
 export { DocumentationSystem, AppDocumentationManager, createDocumentationSystem, generateDocsFromIntelligentRoutes, } from './core/docs';
 export type { DocsConfig } from './core/docs';
 export { getConfig, createModuleConfig, getEnvVar, getEnvArray, getEnvJson, isDevelopment, isProduction, isStaging, requireEnvVars, envVar, getConfigValue, } from './core/config/utils';
-export { initializeConfig, getGlobalConfig, isConfigInitialized } from './core/config';
+export { initializeConfig, getGlobalConfig, isConfigInitialized, resetConfig } from './core/config';
+export type { AppConfig } from './core/config';
 export { MiddlewareManager } from './core/middleware';
 export type { MiddlewareInterface, MoroMiddleware } from './core/middleware';
 export type * from './types/core';

package/dist/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EXECUTION_PHASES = exports.defineRoute = exports.createRoute = exports.autoDiscoverModuleDirectories = exports.ModuleDiscovery = exports.ModuleLoader = exports.defineModule = exports.z = exports.combineSchemas = exports.params = exports.query = exports.body = exports.validate = exports.logger = exports.createFrameworkLogger = exports.MoroEventBus = exports.middleware = exports.HOOK_EVENTS = exports.HookManager = exports.CircuitBreaker = exports.withTimeout = exports.withRetry = exports.withCaching = exports.withLogging = exports.ServiceLifecycle = exports.ServiceScope = exports.FunctionalContainer = exports.Container = exports.ServiceRegistry = exports.WebSocketManager = exports.simpleMiddleware = exports.builtInMiddleware = exports.httpMiddleware = exports.MoroHttpServer = exports.createWorkerHandler = exports.createLambdaHandler = exports.createEdgeHandler = exports.createNodeHandler = exports.createRuntimeAdapter = exports.CloudflareWorkersAdapter = exports.AWSLambdaAdapter = exports.VercelEdgeAdapter = exports.NodeRuntimeAdapter = exports.createAppWorker = exports.createAppLambda = exports.createAppEdge = exports.createAppNode = exports.createApp = exports.MoroCore = exports.Moro = void 0;
-exports.MiddlewareManager = exports.isConfigInitialized = exports.getGlobalConfig = exports.initializeConfig = exports.getConfigValue = exports.envVar = exports.requireEnvVars = exports.isStaging = exports.isProduction = exports.isDevelopment = exports.getEnvJson = exports.getEnvArray = exports.getEnvVar = exports.createModuleConfig = exports.getConfig = exports.generateDocsFromIntelligentRoutes = exports.createDocumentationSystem = exports.AppDocumentationManager = exports.DocumentationSystem = exports.RouteRegistry = exports.IntelligentRoutingManager = void 0;
+exports.MiddlewareManager = exports.resetConfig = exports.isConfigInitialized = exports.getGlobalConfig = exports.initializeConfig = exports.getConfigValue = exports.envVar = exports.requireEnvVars = exports.isStaging = exports.isProduction = exports.isDevelopment = exports.getEnvJson = exports.getEnvArray = exports.getEnvVar = exports.createModuleConfig = exports.getConfig = exports.generateDocsFromIntelligentRoutes = exports.createDocumentationSystem = exports.AppDocumentationManager = exports.DocumentationSystem = exports.RouteRegistry = exports.IntelligentRoutingManager = void 0;
 // MoroJS Framework - Main Entry Point
 var moro_1 = require("./moro");
 Object.defineProperty(exports, "Moro", { enumerable: true, get: function () { return moro_1.Moro; } });
@@ -112,6 +112,7 @@ var config_1 = require("./core/config");
 Object.defineProperty(exports, "initializeConfig", { enumerable: true, get: function () { return config_1.initializeConfig; } });
 Object.defineProperty(exports, "getGlobalConfig", { enumerable: true, get: function () { return config_1.getGlobalConfig; } });
 Object.defineProperty(exports, "isConfigInitialized", { enumerable: true, get: function () { return config_1.isConfigInitialized; } });
+Object.defineProperty(exports, "resetConfig", { enumerable: true, get: function () { return config_1.resetConfig; } });
 // Middleware System
 var middleware_1 = require("./core/middleware");
 Object.defineProperty(exports, "MiddlewareManager", { enumerable: true, get: function () { return middleware_1.MiddlewareManager; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,sCAAsC;AACtC,+BAQgB;AAPd,4FAAA,IAAI,OAAA;AACJ,gGAAA,IAAI,OAAY;AAChB,iGAAA,SAAS,OAAA;AACT,qGAAA,aAAa,OAAA;AACb,qGAAA,aAAa,OAAA;AACb,uGAAA,eAAe,OAAA;AACf,uGAAA,eAAe,OAAA;AAajB,0CAUwB;AATtB,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AACjB,2GAAA,gBAAgB,OAAA;AAChB,mHAAA,wBAAwB,OAAA;AACxB,+GAAA,oBAAoB,OAAA;AACpB,4GAAA,iBAAiB,OAAA;AACjB,4GAAA,iBAAiB,OAAA;AACjB,8GAAA,mBAAmB,OAAA;AACnB,8GAAA,mBAAmB,OAAA;AAOrB,eAAe;AACf,oCAA2E;AAAlE,sGAAA,cAAc,OAAA;AAAE,sGAAA,UAAU,OAAkB;AACrD,uDAAiF;AAAxE,6GAAA,iBAAiB,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAE5C,oBAAoB;AACpB,gDAK2B;AAJzB,8GAAA,gBAAgB,OAAA;AAChB,6GAAA,eAAe,OAAA;AAKjB,iCAAiC;AACjC,8CAa0B;AAZxB,sGAAA,SAAS,OAAA;AACT,gHAAA,mBAAmB,OAAA;AACnB,yGAAA,YAAY,OAAA;AACZ,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AACX,wGAAA,WAAW,OAAA;AACX,sGAAA,SAAS,OAAA;AACT,wGAAA,WAAW,OAAA;AACX,2GAAA,cAAc,OAAA;AACd,wGAAA,WAAW,OAAA;AACX,wGAAA,WAAW,OAAA;AACX,uGAAA,UAAU,OAAA;AAGZ,eAAe;AACf,wCAA6C;AAApC,sGAAA,YAAY,OAAA;AAYrB,gBAAgB;AAChB,wCAA8D;AAArD,+GAAA,qBAAqB,OAAA;AAAE,gGAAA,MAAM,OAAA;AAEtC,gCAAgC;AAChC,gDAAqF;AAA5E,sGAAA,QAAQ,OAAA;AAAE,kGAAA,IAAI,OAAA;AAAE,mGAAA,KAAK,OAAA;AAAE,oGAAA,MAAM,OAAA;AAAE,4GAAA,cAAc,OAAA;AAAE,+FAAA,CAAC,OAAA;AAQzD,gBAAgB;AAChB,0CAKwB;AAJtB,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,0GAAA,eAAe,OAAA;AACf,wHAAA,6BAA6B,OAAA;AAI/B,6BAA6B;AAC7B,0CAA4E;AAAnE,sGAAA,WAAW,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AACnD,kEAA0F;AAAjF,4HAAA,yBAAyB,OAAA;AAAE,gHAAA,aAAa,OAAA;AAajD,uBAAuB;AACvB,oCAKqB;AAJnB,2GAAA,mBAAmB,OAAA;AACnB,+GAAA,uBAAuB,OAAA;AACvB,iHAAA,yBAAyB,OAAA;AACzB,yHAAA,iCAAiC,OAAA;AAInC,0BAA0B;AAC1B,6CAY6B;AAX3B,kGAAA,SAAS,OAAA;AACT,2GAAA,kBAAkB,OAAA;AAClB,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AACX,mGAAA,UAAU,OAAA;AACV,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,kGAAA,SAAS,OAAA;AACT,uGAAA,cAAc,OAAA;AACd,+FAAA,MAAM,OAAA;AACN,uGAAA,cAAc,OAAA;AAGhB,wCAAuF;AAA9E,0GAAA,gBAAgB,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAE/D,oBAAoB;AACpB,gDAAsD;AAA7C,+GAAA,iBAAiB,OAAA;AAc1B,WAAW;AACX,sEAAoD;AACpD,2DAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morojs/moro",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "High-performance Node.js framework with intelligent routing, automatic middleware ordering, type-safe Zod validation, and functional architecture",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -0,0 +1,398 @@
+// Configuration File Loader - Load moro.config.js/ts files
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { AppConfig } from './schema';
+import { createFrameworkLogger } from '../logger';
+
+const logger = createFrameworkLogger('ConfigFile');
+
+/**
+ * Supported configuration file names in order of preference
+ */
+const CONFIG_FILES = ['moro.config.js', 'moro.config.ts'] as const;
+
+/**
+ * Find and load configuration from moro.config.js (synchronously)
+ * @param cwd Current working directory to search for config files
+ * @returns Partial configuration object or null if no config file found
+ */
+export function loadConfigFileSync(cwd: string = process.cwd()): Partial<AppConfig> | null {
+  const configFile = findConfigFile(cwd);
+
+  if (!configFile) {
+    logger.debug('No configuration file found');
+    return null;
+  }
+
+  // Only support .js files for synchronous loading to avoid complexity
+  if (!configFile.endsWith('.js')) {
+    logger.debug(
+      'Found config file, but only JavaScript files are supported in sync mode. Use loadConfigFile() for TypeScript support.'
+    );
+    return null;
+  }
+
+  logger.debug(`Loading configuration from: ${configFile}`);
+
+  try {
+    // Clear module cache to ensure fresh load
+    delete require.cache[require.resolve(configFile)];
+
+    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(`Configuration loaded from: ${configFile}`);
+    return configData;
+  } catch (error) {
+    logger.error(`Failed to load configuration file ${configFile}:`, String(error));
+    logger.warn('Falling back to environment variable configuration');
+    return null;
+  }
+}
+
+/**
+ * Find and load configuration from moro.config.js or moro.config.ts (async)
+ * @param cwd Current working directory to search for config files
+ * @returns Partial configuration object or null if no config file found
+ */
+export async function loadConfigFile(
+  cwd: string = process.cwd()
+): Promise<Partial<AppConfig> | null> {
+  const configFile = findConfigFile(cwd);
+
+  if (!configFile) {
+    logger.debug('No configuration file found');
+    return null;
+  }
+
+  logger.debug(`Loading configuration from: ${configFile}`);
+
+  try {
+    const config = await importConfigFile(configFile);
+
+    if (!config || typeof config !== 'object') {
+      logger.warn(`Configuration file ${configFile} did not export a valid configuration object`);
+      return null;
+    }
+
+    logger.info(`Configuration loaded from: ${configFile}`);
+    return config;
+  } catch (error) {
+    logger.error(`Failed to load configuration file ${configFile}:`, String(error));
+    logger.warn('Falling back to environment variable configuration');
+    return null;
+  }
+}
+
+/**
+ * Find the first existing configuration file in the given directory
+ */
+function findConfigFile(cwd: string): string | null {
+  for (const fileName of CONFIG_FILES) {
+    const filePath = join(cwd, fileName);
+    if (existsSync(filePath)) {
+      return filePath;
+    }
+  }
+  return null;
+}
+
+/**
+ * Dynamically import a configuration file
+ */
+async function importConfigFile(filePath: string): Promise<Partial<AppConfig> | null> {
+  const isTypeScript = filePath.endsWith('.ts');
+
+  if (isTypeScript) {
+    // For TypeScript files, we need to handle ts-node/tsx or similar
+    await setupTypeScriptLoader();
+  }
+
+  try {
+    // Use dynamic import to load the configuration
+    const configModule = await import(filePath);
+
+    // Handle both default export and module.exports
+    const config = configModule.default || configModule;
+
+    return config;
+  } catch (error) {
+    // If TypeScript loading fails, provide helpful error message
+    if (
+      isTypeScript &&
+      error instanceof Error &&
+      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`
+      );
+    }
+    throw error;
+  }
+}
+
+/**
+ * Setup TypeScript loader for .ts config files
+ */
+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');
+  }
+}
+
+/**
+ * Convert a configuration object to environment variable mappings
+ * This function flattens the config object and sets corresponding environment variables
+ */
+export function applyConfigAsEnvironmentVariables(config: Partial<AppConfig>): void {
+  if (!config || typeof config !== 'object') {
+    return;
+  }
+
+  // Apply server configuration
+  if (config.server) {
+    setEnvIfNotSet('PORT', config.server.port?.toString());
+    setEnvIfNotSet('HOST', config.server.host);
+    setEnvIfNotSet('NODE_ENV', config.server.environment);
+    setEnvIfNotSet('MAX_CONNECTIONS', config.server.maxConnections?.toString());
+    setEnvIfNotSet('REQUEST_TIMEOUT', config.server.timeout?.toString());
+  }
+
+  // Apply database configuration
+  if (config.database) {
+    setEnvIfNotSet('DATABASE_URL', config.database.url);
+
+    if (config.database.redis) {
+      setEnvIfNotSet('REDIS_URL', config.database.redis.url);
+      setEnvIfNotSet('REDIS_MAX_RETRIES', config.database.redis.maxRetries?.toString());
+      setEnvIfNotSet('REDIS_RETRY_DELAY', config.database.redis.retryDelay?.toString());
+      setEnvIfNotSet('REDIS_KEY_PREFIX', config.database.redis.keyPrefix);
+    }
+
+    if (config.database.mysql) {
+      setEnvIfNotSet('MYSQL_HOST', config.database.mysql.host);
+      setEnvIfNotSet('MYSQL_PORT', config.database.mysql.port?.toString());
+      setEnvIfNotSet('MYSQL_DATABASE', config.database.mysql.database);
+      setEnvIfNotSet('MYSQL_USERNAME', config.database.mysql.username);
+      setEnvIfNotSet('MYSQL_PASSWORD', config.database.mysql.password);
+      setEnvIfNotSet('MYSQL_CONNECTION_LIMIT', config.database.mysql.connectionLimit?.toString());
+      setEnvIfNotSet('MYSQL_ACQUIRE_TIMEOUT', config.database.mysql.acquireTimeout?.toString());
+      setEnvIfNotSet('MYSQL_TIMEOUT', config.database.mysql.timeout?.toString());
+    }
+  }
+
+  // Apply service discovery configuration
+  if (config.serviceDiscovery) {
+    setEnvIfNotSet('SERVICE_DISCOVERY_ENABLED', config.serviceDiscovery.enabled?.toString());
+    setEnvIfNotSet('DISCOVERY_TYPE', config.serviceDiscovery.type);
+    setEnvIfNotSet('CONSUL_URL', config.serviceDiscovery.consulUrl);
+    setEnvIfNotSet('K8S_NAMESPACE', config.serviceDiscovery.kubernetesNamespace);
+    setEnvIfNotSet(
+      'HEALTH_CHECK_INTERVAL',
+      config.serviceDiscovery.healthCheckInterval?.toString()
+    );
+    setEnvIfNotSet('DISCOVERY_RETRY_ATTEMPTS', config.serviceDiscovery.retryAttempts?.toString());
+  }
+
+  // Apply logging configuration
+  if (config.logging) {
+    setEnvIfNotSet('LOG_LEVEL', config.logging.level);
+    setEnvIfNotSet('LOG_FORMAT', config.logging.format);
+    setEnvIfNotSet('LOG_COLORS', config.logging.enableColors?.toString());
+    setEnvIfNotSet('LOG_TIMESTAMP', config.logging.enableTimestamp?.toString());
+    setEnvIfNotSet('LOG_CONTEXT', config.logging.enableContext?.toString());
+
+    if (config.logging.outputs) {
+      setEnvIfNotSet('LOG_CONSOLE', config.logging.outputs.console?.toString());
+
+      if (config.logging.outputs.file) {
+        setEnvIfNotSet('LOG_FILE_ENABLED', config.logging.outputs.file.enabled?.toString());
+        setEnvIfNotSet('LOG_FILE_PATH', config.logging.outputs.file.path);
+        setEnvIfNotSet('LOG_FILE_MAX_SIZE', config.logging.outputs.file.maxSize);
+        setEnvIfNotSet('LOG_FILE_MAX_FILES', config.logging.outputs.file.maxFiles?.toString());
+      }
+
+      if (config.logging.outputs.webhook) {
+        setEnvIfNotSet('LOG_WEBHOOK_ENABLED', config.logging.outputs.webhook.enabled?.toString());
+        setEnvIfNotSet('LOG_WEBHOOK_URL', config.logging.outputs.webhook.url);
+        if (config.logging.outputs.webhook.headers) {
+          setEnvIfNotSet(
+            'LOG_WEBHOOK_HEADERS',
+            JSON.stringify(config.logging.outputs.webhook.headers)
+          );
+        }
+      }
+    }
+  }
+
+  // Apply module defaults
+  if (config.modules) {
+    if (config.modules.cache) {
+      setEnvIfNotSet('CACHE_ENABLED', config.modules.cache.enabled?.toString());
+      setEnvIfNotSet('DEFAULT_CACHE_TTL', config.modules.cache.defaultTtl?.toString());
+      setEnvIfNotSet('CACHE_MAX_SIZE', config.modules.cache.maxSize?.toString());
+      setEnvIfNotSet('CACHE_STRATEGY', config.modules.cache.strategy);
+    }
+
+    if (config.modules.rateLimit) {
+      setEnvIfNotSet('RATE_LIMIT_ENABLED', config.modules.rateLimit.enabled?.toString());
+      setEnvIfNotSet(
+        'DEFAULT_RATE_LIMIT_REQUESTS',
+        config.modules.rateLimit.defaultRequests?.toString()
+      );
+      setEnvIfNotSet(
+        'DEFAULT_RATE_LIMIT_WINDOW',
+        config.modules.rateLimit.defaultWindow?.toString()
+      );
+      setEnvIfNotSet(
+        'RATE_LIMIT_SKIP_SUCCESS',
+        config.modules.rateLimit.skipSuccessfulRequests?.toString()
+      );
+      setEnvIfNotSet(
+        'RATE_LIMIT_SKIP_FAILED',
+        config.modules.rateLimit.skipFailedRequests?.toString()
+      );
+    }
+
+    if (config.modules.validation) {
+      setEnvIfNotSet('VALIDATION_ENABLED', config.modules.validation.enabled?.toString());
+      setEnvIfNotSet(
+        'VALIDATION_STRIP_UNKNOWN',
+        config.modules.validation.stripUnknown?.toString()
+      );
+      setEnvIfNotSet('VALIDATION_ABORT_EARLY', config.modules.validation.abortEarly?.toString());
+    }
+  }
+
+  // Apply security configuration
+  if (config.security) {
+    if (config.security.cors) {
+      setEnvIfNotSet('CORS_ENABLED', config.security.cors.enabled?.toString());
+      if (typeof config.security.cors.origin === 'string') {
+        setEnvIfNotSet('CORS_ORIGIN', config.security.cors.origin);
+      } else if (Array.isArray(config.security.cors.origin)) {
+        setEnvIfNotSet('CORS_ORIGIN', config.security.cors.origin.join(','));
+      } else if (typeof config.security.cors.origin === 'boolean') {
+        setEnvIfNotSet('CORS_ORIGIN', config.security.cors.origin.toString());
+      }
+      setEnvIfNotSet('CORS_METHODS', config.security.cors.methods?.join(','));
+      setEnvIfNotSet('CORS_HEADERS', config.security.cors.allowedHeaders?.join(','));
+      setEnvIfNotSet('CORS_CREDENTIALS', config.security.cors.credentials?.toString());
+    }
+
+    if (config.security.helmet) {
+      setEnvIfNotSet('HELMET_ENABLED', config.security.helmet.enabled?.toString());
+      setEnvIfNotSet('HELMET_CSP', config.security.helmet.contentSecurityPolicy?.toString());
+      setEnvIfNotSet('HELMET_HSTS', config.security.helmet.hsts?.toString());
+      setEnvIfNotSet('HELMET_NO_SNIFF', config.security.helmet.noSniff?.toString());
+      setEnvIfNotSet('HELMET_FRAMEGUARD', config.security.helmet.frameguard?.toString());
+    }
+
+    if (config.security.rateLimit?.global) {
+      setEnvIfNotSet(
+        'GLOBAL_RATE_LIMIT_ENABLED',
+        config.security.rateLimit.global.enabled?.toString()
+      );
+      setEnvIfNotSet(
+        'GLOBAL_RATE_LIMIT_REQUESTS',
+        config.security.rateLimit.global.requests?.toString()
+      );
+      setEnvIfNotSet(
+        'GLOBAL_RATE_LIMIT_WINDOW',
+        config.security.rateLimit.global.window?.toString()
+      );
+    }
+  }
+
+  // Apply external services configuration
+  if (config.external) {
+    if (config.external.stripe) {
+      setEnvIfNotSet('STRIPE_SECRET_KEY', config.external.stripe.secretKey);
+      setEnvIfNotSet('STRIPE_PUBLISHABLE_KEY', config.external.stripe.publishableKey);
+      setEnvIfNotSet('STRIPE_WEBHOOK_SECRET', config.external.stripe.webhookSecret);
+      setEnvIfNotSet('STRIPE_API_VERSION', config.external.stripe.apiVersion);
+    }
+
+    if (config.external.paypal) {
+      setEnvIfNotSet('PAYPAL_CLIENT_ID', config.external.paypal.clientId);
+      setEnvIfNotSet('PAYPAL_CLIENT_SECRET', config.external.paypal.clientSecret);
+      setEnvIfNotSet('PAYPAL_WEBHOOK_ID', config.external.paypal.webhookId);
+      setEnvIfNotSet('PAYPAL_ENVIRONMENT', config.external.paypal.environment);
+    }
+
+    if (config.external.smtp) {
+      setEnvIfNotSet('SMTP_HOST', config.external.smtp.host);
+      setEnvIfNotSet('SMTP_PORT', config.external.smtp.port?.toString());
+      setEnvIfNotSet('SMTP_SECURE', config.external.smtp.secure?.toString());
+      setEnvIfNotSet('SMTP_USERNAME', config.external.smtp.username);
+      setEnvIfNotSet('SMTP_PASSWORD', config.external.smtp.password);
+    }
+  }
+
+  // Apply performance configuration
+  if (config.performance) {
+    if (config.performance.compression) {
+      setEnvIfNotSet('COMPRESSION_ENABLED', config.performance.compression.enabled?.toString());
+      setEnvIfNotSet('COMPRESSION_LEVEL', config.performance.compression.level?.toString());
+      setEnvIfNotSet('COMPRESSION_THRESHOLD', config.performance.compression.threshold?.toString());
+    }
+
+    if (config.performance.circuitBreaker) {
+      setEnvIfNotSet(
+        'CIRCUIT_BREAKER_ENABLED',
+        config.performance.circuitBreaker.enabled?.toString()
+      );
+      setEnvIfNotSet(
+        'CIRCUIT_BREAKER_THRESHOLD',
+        config.performance.circuitBreaker.failureThreshold?.toString()
+      );
+      setEnvIfNotSet(
+        'CIRCUIT_BREAKER_RESET',
+        config.performance.circuitBreaker.resetTimeout?.toString()
+      );
+      setEnvIfNotSet(
+        'CIRCUIT_BREAKER_MONITOR',
+        config.performance.circuitBreaker.monitoringPeriod?.toString()
+      );
+    }
+
+    if (config.performance.clustering) {
+      setEnvIfNotSet('CLUSTERING_ENABLED', config.performance.clustering.enabled?.toString());
+      setEnvIfNotSet('CLUSTER_WORKERS', config.performance.clustering.workers?.toString());
+    }
+  }
+}
+
+/**
+ * Set environment variable only if it's not already set
+ * This ensures environment variables take precedence over config file values
+ */
+function setEnvIfNotSet(key: string, value: string | undefined): void {
+  if (value !== undefined && process.env[key] === undefined) {
+    process.env[key] = value;
+  }
+}

package/src/core/config/index.ts

@@ -2,6 +2,7 @@
 export * from './schema';
 export * from './loader';
 export * from './utils';
+export * from './file-loader';
 
 // Re-export common Zod utilities for configuration
 export { z } from 'zod';
@@ -9,6 +10,7 @@ export { z } from 'zod';
 // Main configuration loading function
 import { loadConfig } from './loader';
 import type { AppConfig } from './schema';
+import { setConfig } from './utils';
 
 // Global configuration instance
 let globalConfig: AppConfig | null = null;
@@ -23,6 +25,10 @@ export function initializeConfig(): AppConfig {
   }
 
   globalConfig = loadConfig();
+
+  // Also set the config for utils functions
+  setConfig(globalConfig);
+
   return globalConfig;
 }
 
@@ -43,3 +49,15 @@ export function getGlobalConfig(): AppConfig {
 export function isConfigInitialized(): boolean {
   return globalConfig !== null;
 }
+
+/**
+ * Reset the global configuration state (for testing purposes)
+ * @internal
+ */
+export function resetConfig(): void {
+  globalConfig = null;
+
+  // Also reset the utils config (by setting it to null via direct access)
+  const { setConfig } = require('./utils');
+  setConfig(null as any);
+}

package/src/core/config/loader.ts

@@ -2,15 +2,31 @@
 import { ZodError } from 'zod';
 import { ConfigSchema, AppConfig } from './schema';
 import { createFrameworkLogger } from '../logger';
+import { loadConfigFileSync, applyConfigAsEnvironmentVariables } from './file-loader';
 
 const logger = createFrameworkLogger('Config');
 
 /**
- * Load and validate configuration from environment variables
+ * Load and validate configuration from config files and environment variables
+ * Priority: Environment Variables > Config File > Schema Defaults
  * @returns Validated and typed application configuration
  */
 export function loadConfig(): AppConfig {
-  logger.debug('Loading configuration from environment variables');
+  logger.debug('Loading configuration from config files and environment variables');
+
+  // First, try to load from config file and apply as environment variables (synchronously)
+  try {
+    const fileConfig = loadConfigFileSync();
+    if (fileConfig) {
+      logger.debug('Applying config file values as environment variables');
+      applyConfigAsEnvironmentVariables(fileConfig);
+    }
+  } catch (error) {
+    logger.warn(
+      'Config file loading failed, continuing with environment variables only:',
+      String(error)
+    );
+  }
 
   // Map environment variables to configuration structure
   const envConfig = {