@abdokouta/react-config 1.0.0 → 1.0.2

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/config.module.ts","../src/utils/get-nested-value.util.ts","../src/drivers/env.driver.ts","../src/drivers/file.driver.ts","../src/services/config.service.ts","../src/constants/tokens.constant.ts","../src/utils/load-config-file.util.ts"],"sourcesContent":["import { Module, DynamicModule } from '@abdokouta/react-di';\n\nimport { EnvDriver } from './drivers/env.driver';\nimport { FileDriver } from './drivers/file.driver';\nimport { ConfigService } from './services/config.service';\nimport type { ConfigDriver } from './interfaces/config-driver.interface';\nimport type { ConfigModuleOptions } from './interfaces/config-module-options.interface';\nimport { CONFIG_DRIVER, CONFIG_OPTIONS, CONFIG_SERVICE } from './constants/tokens.constant';\n\n/**\n * Configuration Module\n * \n * Provides configuration management with multiple drivers.\n * Similar to NestJS ConfigModule.\n * \n * @example\n * ```typescript\n * // Using environment variables (default)\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       envFilePath: '.env',\n *       isGlobal: true,\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n * \n * @example\n * ```typescript\n * // Using file-based configuration\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       driver: 'file',\n *       filePattern: 'config/**\\/*.config.ts',\n *       isGlobal: true,\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n */\n@Module({})\nexport class ConfigModule {\n  /**\n   * Register configuration module with options\n   * \n   * @param options - Configuration options\n   * @returns Dynamic module\n   */\n  static forRoot(options: ConfigModuleOptions = {}): DynamicModule {\n    const driver = this.createDriver(options);\n    \n    const isGlobal = options.isGlobal ?? false;\n    \n    const providers = [\n      {\n        provide: CONFIG_OPTIONS,\n        useValue: options,\n        isGlobal,\n      },\n      {\n        provide: CONFIG_DRIVER,\n        useValue: driver,\n        isGlobal,\n      },\n      ConfigService,\n      {\n        provide: CONFIG_SERVICE,\n        useExisting: ConfigService,\n        isGlobal,\n      },\n    ];\n\n    return {\n      module: ConfigModule,\n      providers: providers as any,\n      exports: [ConfigService],\n    };\n  }\n\n  /**\n   * Register configuration module asynchronously\n   * \n   * @param options - Async configuration options\n   * @returns Dynamic module\n   */\n  static async forRootAsync(\n    options: ConfigModuleOptions & {\n      useFactory?: () => Promise<ConfigModuleOptions> | ConfigModuleOptions;\n    }\n  ): Promise<DynamicModule> {\n    const resolvedOptions = options.useFactory\n      ? await options.useFactory()\n      : options;\n\n    return this.forRoot(resolvedOptions);\n  }\n\n  /**\n   * Create configuration driver based on options\n   */\n  private static createDriver(options: ConfigModuleOptions): ConfigDriver {\n    const driverType = options.driver || 'env';\n\n    switch (driverType) {\n      case 'env':\n        const envDriver = new EnvDriver({\n          envFilePath: options.envFilePath,\n          ignoreEnvFile: options.ignoreEnvFile,\n          expandVariables: options.expandVariables,\n          envPrefix: options.envPrefix,\n          globalName: options.globalName,\n        });\n        envDriver.load();\n        \n        // Merge custom load function if provided\n        if (options.load) {\n          this.mergeCustomConfig(envDriver, options.load);\n        }\n        \n        return envDriver;\n\n      case 'file':\n        const fileDriver = new FileDriver({\n          config: typeof options.load === 'object' ? options.load : undefined,\n        });\n        return fileDriver;\n\n      default:\n        throw new Error(`Unknown configuration driver: ${driverType}`);\n    }\n  }\n\n  /**\n   * Merge custom configuration into driver\n   */\n  private static mergeCustomConfig(\n    driver: ConfigDriver,\n    load: Record<string, any> | (() => Record<string, any> | Promise<Record<string, any>>)\n  ): void {\n    const customConfig = typeof load === 'function' ? load() : load;\n    \n    if (customConfig instanceof Promise) {\n      customConfig.then(config => {\n        Object.assign(driver.all(), config);\n      });\n    } else {\n      Object.assign(driver.all(), customConfig);\n    }\n  }\n}\n","/**\n * Get nested value from object using dot notation\n * \n * @param obj - Source object\n * @param path - Dot-notated path (e.g., 'database.host')\n * @param defaultValue - Default value if path not found\n * @returns Value at path or default value\n * \n * @example\n * ```typescript\n * const config = { database: { host: 'localhost' } };\n * getNestedValue(config, 'database.host'); // 'localhost'\n * getNestedValue(config, 'database.port', 5432); // 5432\n * ```\n */\nexport function getNestedValue<T = any>(\n  obj: Record<string, any>,\n  path: string,\n  defaultValue?: T\n): T | undefined {\n  const keys = path.split('.');\n  let current: any = obj;\n\n  for (const key of keys) {\n    if (current === null || current === undefined) {\n      return defaultValue;\n    }\n    current = current[key];\n  }\n\n  return current !== undefined ? current : defaultValue;\n}\n\n/**\n * Check if nested path exists in object\n * \n * @param obj - Source object\n * @param path - Dot-notated path\n * @returns True if path exists\n */\nexport function hasNestedValue(\n  obj: Record<string, any>,\n  path: string\n): boolean {\n  const keys = path.split('.');\n  let current: any = obj;\n\n  for (const key of keys) {\n    if (current === null || current === undefined || !(key in current)) {\n      return false;\n    }\n    current = current[key];\n  }\n\n  return true;\n}\n","import type { ConfigDriver } from '../interfaces/config-driver.interface';\nimport { getNestedValue, hasNestedValue } from '../utils/get-nested-value.util';\n\n/**\n * Environment Variable Configuration Driver\n * \n * Loads configuration from environment variables (process.env).\n * Supports .env files via dotenv.\n */\nexport class EnvDriver implements ConfigDriver {\n  private config: Record<string, any> = {};\n  private loaded = false;\n\n  constructor(\n    private options: {\n      envFilePath?: string | string[];\n      ignoreEnvFile?: boolean;\n      expandVariables?: boolean;\n      envPrefix?: string | false;\n      globalName?: string; // Custom global variable name\n    } = {}\n  ) {}\n\n  /**\n   * Load environment variables\n   */\n  load(): Record<string, any> {\n    if (this.loaded) {\n      console.log('[EnvDriver] Already loaded, returning cached config');\n      return this.config;\n    }\n\n    console.log('[EnvDriver] Loading environment variables...');\n    console.log('[EnvDriver] Options:', { ...this.options });\n\n    // Load .env file if not ignored\n    if (!this.options.ignoreEnvFile) {\n      this.loadDotEnv();\n    }\n\n    // Get global config name (default: __APP_CONFIG__)\n    const globalName = this.options.globalName || '__APP_CONFIG__';\n\n    // Try to load from custom global variable first (browser environment)\n    if (typeof window !== 'undefined' && (window as any)[globalName]) {\n      this.config = { ...(window as any)[globalName] };\n      console.log(`[EnvDriver] Loaded config from window.${globalName}:`, Object.keys(this.config).length, 'keys');\n    }\n    // Fallback to process.env (Node.js environment or backward compatibility)\n    else if (typeof process !== 'undefined' && process.env) {\n      this.config = { ...process.env };\n      console.log('[EnvDriver] Loaded config from process.env:', Object.keys(this.config).length, 'keys');\n    }\n    // No config source available\n    else {\n      console.warn('[EnvDriver] No config source available (neither window.' + globalName + ' nor process.env)');\n      this.config = {};\n    }\n\n    console.log('[EnvDriver] Initial config keys:', [...Object.keys(this.config).filter(k => k.includes('APP') || k.includes('VITE'))]);\n\n    // Strip prefix if configured\n    if (this.options.envPrefix !== false) {\n      console.log('[EnvDriver] Stripping prefix...');\n      this.stripPrefix();\n      console.log('[EnvDriver] After stripPrefix, config keys:', [...Object.keys(this.config).filter(k => k.includes('APP') || k.includes('VITE'))]);\n    }\n\n    // Expand variables if enabled\n    if (this.options.expandVariables) {\n      this.expandEnvVariables();\n    }\n\n    this.loaded = true;\n    console.log('[EnvDriver] Load complete. Sample values:', {\n      APP_NAME: this.config.APP_NAME,\n      VITE_APP_NAME: this.config.VITE_APP_NAME,\n    });\n    return this.config;\n  }\n\n  /**\n   * Get configuration value\n   */\n  get<T = any>(key: string, defaultValue?: T): T | undefined {\n    if (!this.loaded) {\n      this.load();\n    }\n    const value = getNestedValue(this.config, key, defaultValue);\n    console.log(`[EnvDriver] get(\"${key}\", \"${defaultValue}\") = \"${value}\"`);\n    return value;\n  }\n\n  /**\n   * Check if key exists\n   */\n  has(key: string): boolean {\n    if (!this.loaded) {\n      this.load();\n    }\n    return hasNestedValue(this.config, key);\n  }\n\n  /**\n   * Get all configuration\n   */\n  all(): Record<string, any> {\n    if (!this.loaded) {\n      this.load();\n    }\n    return { ...this.config };\n  }\n\n  /**\n   * Load .env file using dotenv\n   */\n  private loadDotEnv(): void {\n    try {\n      // Try to load dotenv\n      const dotenv = require('dotenv');\n      const paths = Array.isArray(this.options.envFilePath)\n        ? this.options.envFilePath\n        : [this.options.envFilePath || '.env'];\n\n      for (const path of paths) {\n        dotenv.config({ path });\n      }\n    } catch (error) {\n      // dotenv not installed, skip\n    }\n  }\n\n  /**\n   * Expand environment variables (e.g., ${VAR_NAME})\n   */\n  private expandEnvVariables(): void {\n    const regex = /\\$\\{([^}]+)\\}/g;\n\n    const expand = (value: string): string => {\n      return value.replace(regex, (_, key) => {\n        return this.config[key] || '';\n      });\n    };\n\n    for (const [key, value] of Object.entries(this.config)) {\n      if (typeof value === 'string' && value.includes('${')) {\n        this.config[key] = expand(value);\n      }\n    }\n  }\n\n  /**\n   * Strip environment variable prefix\n   * Auto-detects framework (Vite, Next.js) or uses custom prefix\n   */\n  private stripPrefix(): void {\n    let prefix = this.options.envPrefix;\n\n    // Auto-detect framework prefix\n    if (prefix === 'auto' || prefix === undefined) {\n      // Check for Vite (import.meta.env exists or VITE_ variables present)\n      const hasViteVars = Object.keys(this.config).some(key => key.startsWith('VITE_'));\n      if (hasViteVars || typeof import.meta !== 'undefined') {\n        prefix = 'VITE_';\n      }\n      // Check for Next.js (NEXT_PUBLIC_ variables present)\n      else if (Object.keys(this.config).some(key => key.startsWith('NEXT_PUBLIC_'))) {\n        prefix = 'NEXT_PUBLIC_';\n      }\n      // No framework detected, don't strip\n      else {\n        return;\n      }\n    }\n\n    // Strip the prefix from all matching keys\n    if (typeof prefix === 'string' && prefix.length > 0) {\n      const newConfig: Record<string, any> = {};\n      \n      for (const [key, value] of Object.entries(this.config)) {\n        if (key.startsWith(prefix)) {\n          // Add both prefixed and unprefixed versions\n          const unprefixedKey = key.substring(prefix.length);\n          newConfig[unprefixedKey] = value;\n          newConfig[key] = value; // Keep original too\n        } else {\n          newConfig[key] = value;\n        }\n      }\n      \n      this.config = newConfig;\n    }\n  }\n}\n","import type { ConfigDriver } from '@/interfaces/config-driver.interface';\nimport { getNestedValue, hasNestedValue } from '@/utils/get-nested-value.util';\n\n/**\n * File-based Configuration Driver\n * \n * Loads configuration from TypeScript/JavaScript files.\n * This is a server-side only driver. For client-side, use the Vite plugin.\n * \n * @see packages/pixielity/config/src/plugins/vite-config.plugin.ts\n */\nexport class FileDriver implements ConfigDriver {\n  private config: Record<string, any> = {};\n  private loaded = false;\n\n  constructor(\n    options: {\n      config?: Record<string, any>;\n    } = {}\n  ) {\n    // Pre-loaded config from Vite plugin or server\n    if (options.config) {\n      this.config = options.config;\n      this.loaded = true;\n    }\n  }\n\n  /**\n   * Load configuration\n   * Config should be pre-loaded via Vite plugin or passed in constructor\n   */\n  async load(): Promise<Record<string, any>> {\n    if (this.loaded) {\n      return this.config;\n    }\n\n    // If running on server (Node.js), throw error\n    const isServer = typeof globalThis !== 'undefined' && \n                     typeof (globalThis as typeof globalThis & { window?: any }).window === 'undefined';\n    \n    if (isServer) {\n      throw new Error(\n        'FileDriver requires pre-loaded configuration. ' +\n        'Use Vite plugin for client-side or pass config in constructor for server-side.'\n      );\n    }\n\n    this.loaded = true;\n    return this.config;\n  }\n\n  /**\n   * Get configuration value\n   */\n  get<T = any>(key: string, defaultValue?: T): T | undefined {\n    if (!this.loaded) {\n      throw new Error('Configuration not loaded. Call load() first or use async initialization.');\n    }\n    return getNestedValue(this.config, key, defaultValue);\n  }\n\n  /**\n   * Check if key exists\n   */\n  has(key: string): boolean {\n    if (!this.loaded) {\n      throw new Error('Configuration not loaded. Call load() first or use async initialization.');\n    }\n    return hasNestedValue(this.config, key);\n  }\n\n  /**\n   * Get all configuration\n   */\n  all(): Record<string, any> {\n    if (!this.loaded) {\n      throw new Error('Configuration not loaded. Call load() first or use async initialization.');\n    }\n    return { ...this.config };\n  }\n}\n","import { Inject, Injectable } from \"@abdokouta/react-di\";\n\nimport { CONFIG_DRIVER } from \"@/constants/tokens.constant\";\nimport type { ConfigDriver } from \"@/interfaces/config-driver.interface\";\nimport type { ConfigServiceInterface } from \"@/interfaces/config-service.interface\";\n\n/**\n * Configuration Service\n *\n * Provides type-safe access to configuration values with various getter methods.\n * Similar to NestJS ConfigService.\n *\n * @example\n * ```typescript\n * class MyService {\n *   constructor(private config: ConfigService) {}\n *\n *   getDbConfig() {\n *     return {\n *       host: this.config.getString('DB_HOST', 'localhost'),\n *       port: this.config.getNumber('DB_PORT', 5432),\n *       ssl: this.config.getBool('DB_SSL', false),\n *     };\n *   }\n * }\n * ```\n */\n@Injectable()\nexport class ConfigService implements ConfigServiceInterface {\n  constructor(\n    @Inject(CONFIG_DRIVER)\n    private driver: ConfigDriver,\n  ) {}\n\n  /**\n   * Get configuration value\n   */\n  get<T = any>(key: string, defaultValue?: T): T | undefined {\n    return this.driver.get<T>(key, defaultValue);\n  }\n\n  /**\n   * Get configuration value or throw if not found\n   */\n  getOrThrow<T = any>(key: string): T {\n    const value = this.get<T>(key);\n    if (value === undefined) {\n      throw new Error(`Configuration key \"${key}\" is required but not set`);\n    }\n    return value;\n  }\n\n  /**\n   * Get string value\n   */\n  getString(key: string, defaultValue?: string): string | undefined {\n    const value = this.get(key, defaultValue);\n    return value !== undefined ? String(value) : undefined;\n  }\n\n  /**\n   * Get string value or throw\n   */\n  getStringOrThrow(key: string): string {\n    return String(this.getOrThrow(key));\n  }\n\n  /**\n   * Get number value\n   */\n  getNumber(key: string, defaultValue?: number): number | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    const parsed = Number(value);\n    return isNaN(parsed) ? defaultValue : parsed;\n  }\n\n  /**\n   * Get number value or throw\n   */\n  getNumberOrThrow(key: string): number {\n    const value = this.getNumber(key);\n    if (value === undefined) {\n      throw new Error(`Configuration key \"${key}\" is required but not set`);\n    }\n    return value;\n  }\n\n  /**\n   * Get boolean value\n   * Treats 'true', '1', 'yes', 'on' as true\n   */\n  getBool(key: string, defaultValue?: boolean): boolean | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    if (typeof value === \"boolean\") {\n      return value;\n    }\n    return [\"true\", \"1\", \"yes\", \"on\"].includes(String(value).toLowerCase());\n  }\n\n  /**\n   * Get boolean value or throw\n   */\n  getBoolOrThrow(key: string): boolean {\n    const value = this.getBool(key);\n    if (value === undefined) {\n      throw new Error(`Configuration key \"${key}\" is required but not set`);\n    }\n    return value;\n  }\n\n  /**\n   * Get array value (comma-separated string or actual array)\n   */\n  getArray(key: string, defaultValue?: string[]): string[] | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    if (Array.isArray(value)) {\n      return value.map(String);\n    }\n    return String(value)\n      .split(\",\")\n      .map((v) => v.trim())\n      .filter(Boolean);\n  }\n\n  /**\n   * Get JSON value\n   */\n  getJson<T = any>(key: string, defaultValue?: T): T | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    if (typeof value === \"object\") {\n      return value as T;\n    }\n    try {\n      return JSON.parse(String(value)) as T;\n    } catch {\n      return defaultValue;\n    }\n  }\n\n  /**\n   * Check if configuration key exists\n   */\n  has(key: string): boolean {\n    return this.driver.has(key);\n  }\n\n  /**\n   * Get all configuration values\n   */\n  all(): Record<string, any> {\n    return this.driver.all();\n  }\n\n  /**\n   * Clear cache (no-op since we don't cache in ConfigService)\n   */\n  clearCache(): void {\n    // No-op - caching should be done at a higher level if needed\n  }\n}\n","/**\n * Dependency Injection Tokens\n * \n * Used for injecting configuration dependencies.\n */\n\n/**\n * Configuration driver token\n * \n * @example\n * ```typescript\n * @Inject(CONFIG_DRIVER)\n * private driver: ConfigDriver\n * ```\n */\nexport const CONFIG_DRIVER = Symbol('CONFIG_DRIVER');\n\n/**\n * Configuration options token\n * \n * @example\n * ```typescript\n * @Inject(CONFIG_OPTIONS)\n * private options: ConfigModuleOptions\n * ```\n */\nexport const CONFIG_OPTIONS = Symbol('CONFIG_OPTIONS');\n\n/**\n * Configuration service token\n * \n * @example\n * ```typescript\n * @Inject(CONFIG_SERVICE)\n * private config: ConfigService\n * ```\n */\nexport const CONFIG_SERVICE = Symbol('CONFIG_SERVICE');\n","/**\n * Load Config File Utility\n *\n * Dynamically loads and parses a config file.\n */\n\n/**\n * Load and parse config file\n *\n * @param filePath - Absolute path to the config file\n * @returns Parsed config object\n */\nexport async function loadConfigFile(\n  filePath: string\n): Promise<Record<string, any>> {\n  try {\n    // Dynamic import of the config file\n    // @ts-ignore - Dynamic import path\n    const module = await import(/* @vite-ignore */ filePath);\n\n    // Extract config object (could be default export or named export)\n    const config = module.default || module;\n\n    // If it's a function, call it\n    if (typeof config === 'function') {\n      return await config();\n    }\n\n    return config;\n  } catch (error) {\n    console.warn(\n      `[vite-plugin-config] Failed to load config file: ${filePath}`,\n      error\n    );\n    return {};\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/config.module.ts","../src/utils/get-nested-value.util.ts","../src/drivers/env.driver.ts","../src/drivers/file.driver.ts","../src/services/config.service.ts","../src/constants/tokens.constant.ts","../src/utils/define-config.util.ts","../src/utils/load-config-file.util.ts"],"sourcesContent":["import { Module, DynamicModule } from '@abdokouta/react-di';\n\nimport { EnvDriver } from './drivers/env.driver';\nimport { FileDriver } from './drivers/file.driver';\nimport { ConfigService } from './services/config.service';\nimport type { ConfigDriver } from './interfaces/config-driver.interface';\nimport type { ConfigModuleOptions } from './interfaces/config-module-options.interface';\nimport { CONFIG_DRIVER, CONFIG_OPTIONS, CONFIG_SERVICE } from './constants/tokens.constant';\n\n/**\n * Configuration Module\n *\n * Provides configuration management with multiple drivers.\n * Similar to NestJS ConfigModule.\n *\n * @example\n * ```typescript\n * // Using environment variables (default)\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       envFilePath: '.env',\n *       isGlobal: true,\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n *\n * @example\n * ```typescript\n * // Using file-based configuration\n * @Module({\n *   imports: [\n *     ConfigModule.forRoot({\n *       driver: 'file',\n *       filePattern: 'config/**\\/*.config.ts',\n *       isGlobal: true,\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n */\n@Module({})\nexport class ConfigModule {\n  /**\n   * Register configuration module with options\n   *\n   * @param options - Configuration options\n   * @returns Dynamic module\n   */\n  static forRoot(options: ConfigModuleOptions = {}): DynamicModule {\n    const driver = this.createDriver(options);\n\n    const isGlobal = options.isGlobal ?? false;\n\n    const providers = [\n      {\n        provide: CONFIG_OPTIONS,\n        useValue: options,\n        isGlobal,\n      },\n      {\n        provide: CONFIG_DRIVER,\n        useValue: driver,\n        isGlobal,\n      },\n      ConfigService,\n      {\n        provide: CONFIG_SERVICE,\n        useExisting: ConfigService,\n        isGlobal,\n      },\n    ];\n\n    return {\n      module: ConfigModule,\n      providers: providers as any,\n      exports: [ConfigService],\n    };\n  }\n\n  /**\n   * Register configuration module asynchronously\n   *\n   * @param options - Async configuration options\n   * @returns Dynamic module\n   */\n  static async forRootAsync(\n    options: ConfigModuleOptions & {\n      useFactory?: () => Promise<ConfigModuleOptions> | ConfigModuleOptions;\n    }\n  ): Promise<DynamicModule> {\n    const resolvedOptions = options.useFactory ? await options.useFactory() : options;\n\n    return this.forRoot(resolvedOptions);\n  }\n\n  /**\n   * Create configuration driver based on options\n   */\n  private static createDriver(options: ConfigModuleOptions): ConfigDriver {\n    const driverType = options.driver || 'env';\n\n    switch (driverType) {\n      case 'env':\n        const envDriver = new EnvDriver({\n          envFilePath: options.envFilePath,\n          ignoreEnvFile: options.ignoreEnvFile,\n          expandVariables: options.expandVariables,\n          envPrefix: options.envPrefix,\n          globalName: options.globalName,\n        });\n        envDriver.load();\n\n        // Merge custom load function if provided\n        if (options.load) {\n          this.mergeCustomConfig(envDriver, options.load);\n        }\n\n        return envDriver;\n\n      case 'file':\n        const fileDriver = new FileDriver({\n          config: typeof options.load === 'object' ? options.load : undefined,\n        });\n        return fileDriver;\n\n      default:\n        throw new Error(`Unknown configuration driver: ${driverType}`);\n    }\n  }\n\n  /**\n   * Merge custom configuration into driver\n   */\n  private static mergeCustomConfig(\n    driver: ConfigDriver,\n    load: Record<string, any> | (() => Record<string, any> | Promise<Record<string, any>>)\n  ): void {\n    const customConfig = typeof load === 'function' ? load() : load;\n\n    if (customConfig instanceof Promise) {\n      customConfig.then((config) => {\n        Object.assign(driver.all(), config);\n      });\n    } else {\n      Object.assign(driver.all(), customConfig);\n    }\n  }\n}\n","/**\n * Get nested value from object using dot notation\n *\n * @param obj - Source object\n * @param path - Dot-notated path (e.g., 'database.host')\n * @param defaultValue - Default value if path not found\n * @returns Value at path or default value\n *\n * @example\n * ```typescript\n * const config = { database: { host: 'localhost' } };\n * getNestedValue(config, 'database.host'); // 'localhost'\n * getNestedValue(config, 'database.port', 5432); // 5432\n * ```\n */\nexport function getNestedValue<T = any>(\n  obj: Record<string, any>,\n  path: string,\n  defaultValue?: T\n): T | undefined {\n  const keys = path.split('.');\n  let current: any = obj;\n\n  for (const key of keys) {\n    if (current === null || current === undefined) {\n      return defaultValue;\n    }\n    current = current[key];\n  }\n\n  return current !== undefined ? current : defaultValue;\n}\n\n/**\n * Check if nested path exists in object\n *\n * @param obj - Source object\n * @param path - Dot-notated path\n * @returns True if path exists\n */\nexport function hasNestedValue(obj: Record<string, any>, path: string): boolean {\n  const keys = path.split('.');\n  let current: any = obj;\n\n  for (const key of keys) {\n    if (current === null || current === undefined || !(key in current)) {\n      return false;\n    }\n    current = current[key];\n  }\n\n  return true;\n}\n","import type { ConfigDriver } from '../interfaces/config-driver.interface';\nimport { getNestedValue, hasNestedValue } from '../utils/get-nested-value.util';\n\n/**\n * Environment Variable Configuration Driver\n *\n * Loads configuration from environment variables (process.env).\n * Supports .env files via dotenv.\n */\nexport class EnvDriver implements ConfigDriver {\n  private config: Record<string, any> = {};\n  private loaded = false;\n\n  constructor(\n    private options: {\n      envFilePath?: string | string[];\n      ignoreEnvFile?: boolean;\n      expandVariables?: boolean;\n      envPrefix?: string | false;\n      globalName?: string; // Custom global variable name\n    } = {}\n  ) {}\n\n  /**\n   * Load environment variables\n   */\n  load(): Record<string, any> {\n    if (this.loaded) {\n      console.log('[EnvDriver] Already loaded, returning cached config');\n      return this.config;\n    }\n\n    console.log('[EnvDriver] Loading environment variables...');\n    console.log('[EnvDriver] Options:', { ...this.options });\n\n    // Load .env file if not ignored\n    if (!this.options.ignoreEnvFile) {\n      this.loadDotEnv();\n    }\n\n    // Get global config name (default: __APP_CONFIG__)\n    const globalName = this.options.globalName || '__APP_CONFIG__';\n\n    // Try to load from custom global variable first (browser environment)\n    if (typeof window !== 'undefined' && (window as any)[globalName]) {\n      this.config = { ...(window as any)[globalName] };\n      console.log(\n        `[EnvDriver] Loaded config from window.${globalName}:`,\n        Object.keys(this.config).length,\n        'keys'\n      );\n    }\n    // Fallback to process.env (Node.js environment or backward compatibility)\n    else if (typeof process !== 'undefined' && process.env) {\n      this.config = { ...process.env };\n      console.log(\n        '[EnvDriver] Loaded config from process.env:',\n        Object.keys(this.config).length,\n        'keys'\n      );\n    }\n    // No config source available\n    else {\n      console.warn(\n        '[EnvDriver] No config source available (neither window.' + globalName + ' nor process.env)'\n      );\n      this.config = {};\n    }\n\n    console.log('[EnvDriver] Initial config keys:', [\n      ...Object.keys(this.config).filter((k) => k.includes('APP') || k.includes('VITE')),\n    ]);\n\n    // Strip prefix if configured\n    if (this.options.envPrefix !== false) {\n      console.log('[EnvDriver] Stripping prefix...');\n      this.stripPrefix();\n      console.log('[EnvDriver] After stripPrefix, config keys:', [\n        ...Object.keys(this.config).filter((k) => k.includes('APP') || k.includes('VITE')),\n      ]);\n    }\n\n    // Expand variables if enabled\n    if (this.options.expandVariables) {\n      this.expandEnvVariables();\n    }\n\n    this.loaded = true;\n    console.log('[EnvDriver] Load complete. Sample values:', {\n      APP_NAME: this.config.APP_NAME,\n      VITE_APP_NAME: this.config.VITE_APP_NAME,\n    });\n    return this.config;\n  }\n\n  /**\n   * Get configuration value\n   */\n  get<T = any>(key: string, defaultValue?: T): T | undefined {\n    if (!this.loaded) {\n      this.load();\n    }\n    const value = getNestedValue(this.config, key, defaultValue);\n    console.log(`[EnvDriver] get(\"${key}\", \"${defaultValue}\") = \"${value}\"`);\n    return value;\n  }\n\n  /**\n   * Check if key exists\n   */\n  has(key: string): boolean {\n    if (!this.loaded) {\n      this.load();\n    }\n    return hasNestedValue(this.config, key);\n  }\n\n  /**\n   * Get all configuration\n   */\n  all(): Record<string, any> {\n    if (!this.loaded) {\n      this.load();\n    }\n    return { ...this.config };\n  }\n\n  /**\n   * Load .env file using dotenv\n   */\n  private loadDotEnv(): void {\n    try {\n      // Try to load dotenv\n      const dotenv = require('dotenv');\n      const paths = Array.isArray(this.options.envFilePath)\n        ? this.options.envFilePath\n        : [this.options.envFilePath || '.env'];\n\n      for (const path of paths) {\n        dotenv.config({ path });\n      }\n    } catch (error) {\n      // dotenv not installed, skip\n    }\n  }\n\n  /**\n   * Expand environment variables (e.g., ${VAR_NAME})\n   */\n  private expandEnvVariables(): void {\n    const regex = /\\$\\{([^}]+)\\}/g;\n\n    const expand = (value: string): string => {\n      return value.replace(regex, (_, key) => {\n        return this.config[key] || '';\n      });\n    };\n\n    for (const [key, value] of Object.entries(this.config)) {\n      if (typeof value === 'string' && value.includes('${')) {\n        this.config[key] = expand(value);\n      }\n    }\n  }\n\n  /**\n   * Strip environment variable prefix\n   * Auto-detects framework (Vite, Next.js) or uses custom prefix\n   */\n  private stripPrefix(): void {\n    let prefix = this.options.envPrefix;\n\n    // Auto-detect framework prefix\n    if (prefix === 'auto' || prefix === undefined) {\n      // Check for Vite (import.meta.env exists or VITE_ variables present)\n      const hasViteVars = Object.keys(this.config).some((key) => key.startsWith('VITE_'));\n      if (hasViteVars || typeof import.meta !== 'undefined') {\n        prefix = 'VITE_';\n      }\n      // Check for Next.js (NEXT_PUBLIC_ variables present)\n      else if (Object.keys(this.config).some((key) => key.startsWith('NEXT_PUBLIC_'))) {\n        prefix = 'NEXT_PUBLIC_';\n      }\n      // No framework detected, don't strip\n      else {\n        return;\n      }\n    }\n\n    // Strip the prefix from all matching keys\n    if (typeof prefix === 'string' && prefix.length > 0) {\n      const newConfig: Record<string, any> = {};\n\n      for (const [key, value] of Object.entries(this.config)) {\n        if (key.startsWith(prefix)) {\n          // Add both prefixed and unprefixed versions\n          const unprefixedKey = key.substring(prefix.length);\n          newConfig[unprefixedKey] = value;\n          newConfig[key] = value; // Keep original too\n        } else {\n          newConfig[key] = value;\n        }\n      }\n\n      this.config = newConfig;\n    }\n  }\n}\n","import type { ConfigDriver } from '@/interfaces/config-driver.interface';\nimport { getNestedValue, hasNestedValue } from '@/utils/get-nested-value.util';\n\n/**\n * File-based Configuration Driver\n *\n * Loads configuration from TypeScript/JavaScript files.\n * This is a server-side only driver. For client-side, use the Vite plugin.\n *\n * @see packages/abdokouta/config/src/plugins/vite-config.plugin.ts\n */\nexport class FileDriver implements ConfigDriver {\n  private config: Record<string, any> = {};\n  private loaded = false;\n\n  constructor(\n    options: {\n      config?: Record<string, any>;\n    } = {}\n  ) {\n    // Pre-loaded config from Vite plugin or server\n    if (options.config) {\n      this.config = options.config;\n      this.loaded = true;\n    }\n  }\n\n  /**\n   * Load configuration\n   * Config should be pre-loaded via Vite plugin or passed in constructor\n   */\n  async load(): Promise<Record<string, any>> {\n    if (this.loaded) {\n      return this.config;\n    }\n\n    // If running on server (Node.js), throw error\n    const isServer =\n      typeof globalThis !== 'undefined' &&\n      typeof (globalThis as typeof globalThis & { window?: any }).window === 'undefined';\n\n    if (isServer) {\n      throw new Error(\n        'FileDriver requires pre-loaded configuration. ' +\n          'Use Vite plugin for client-side or pass config in constructor for server-side.'\n      );\n    }\n\n    this.loaded = true;\n    return this.config;\n  }\n\n  /**\n   * Get configuration value\n   */\n  get<T = any>(key: string, defaultValue?: T): T | undefined {\n    if (!this.loaded) {\n      throw new Error('Configuration not loaded. Call load() first or use async initialization.');\n    }\n    return getNestedValue(this.config, key, defaultValue);\n  }\n\n  /**\n   * Check if key exists\n   */\n  has(key: string): boolean {\n    if (!this.loaded) {\n      throw new Error('Configuration not loaded. Call load() first or use async initialization.');\n    }\n    return hasNestedValue(this.config, key);\n  }\n\n  /**\n   * Get all configuration\n   */\n  all(): Record<string, any> {\n    if (!this.loaded) {\n      throw new Error('Configuration not loaded. Call load() first or use async initialization.');\n    }\n    return { ...this.config };\n  }\n}\n","import { Inject, Injectable } from '@abdokouta/react-di';\n\nimport { CONFIG_DRIVER } from '@/constants/tokens.constant';\nimport type { ConfigDriver } from '@/interfaces/config-driver.interface';\nimport type { ConfigServiceInterface } from '@/interfaces/config-service.interface';\n\n/**\n * Configuration Service\n *\n * Provides type-safe access to configuration values with various getter methods.\n * Similar to NestJS ConfigService.\n *\n * @example\n * ```typescript\n * class MyService {\n *   constructor(private config: ConfigService) {}\n *\n *   getDbConfig() {\n *     return {\n *       host: this.config.getString('DB_HOST', 'localhost'),\n *       port: this.config.getNumber('DB_PORT', 5432),\n *       ssl: this.config.getBool('DB_SSL', false),\n *     };\n *   }\n * }\n * ```\n */\n@Injectable()\nexport class ConfigService implements ConfigServiceInterface {\n  constructor(\n    @Inject(CONFIG_DRIVER)\n    private driver: ConfigDriver\n  ) {}\n\n  /**\n   * Get configuration value\n   */\n  get<T = any>(key: string, defaultValue?: T): T | undefined {\n    return this.driver.get<T>(key, defaultValue);\n  }\n\n  /**\n   * Get configuration value or throw if not found\n   */\n  getOrThrow<T = any>(key: string): T {\n    const value = this.get<T>(key);\n    if (value === undefined) {\n      throw new Error(`Configuration key \"${key}\" is required but not set`);\n    }\n    return value;\n  }\n\n  /**\n   * Get string value\n   */\n  getString(key: string, defaultValue?: string): string | undefined {\n    const value = this.get(key, defaultValue);\n    return value !== undefined ? String(value) : undefined;\n  }\n\n  /**\n   * Get string value or throw\n   */\n  getStringOrThrow(key: string): string {\n    return String(this.getOrThrow(key));\n  }\n\n  /**\n   * Get number value\n   */\n  getNumber(key: string, defaultValue?: number): number | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    const parsed = Number(value);\n    return isNaN(parsed) ? defaultValue : parsed;\n  }\n\n  /**\n   * Get number value or throw\n   */\n  getNumberOrThrow(key: string): number {\n    const value = this.getNumber(key);\n    if (value === undefined) {\n      throw new Error(`Configuration key \"${key}\" is required but not set`);\n    }\n    return value;\n  }\n\n  /**\n   * Get boolean value\n   * Treats 'true', '1', 'yes', 'on' as true\n   */\n  getBool(key: string, defaultValue?: boolean): boolean | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    return ['true', '1', 'yes', 'on'].includes(String(value).toLowerCase());\n  }\n\n  /**\n   * Get boolean value or throw\n   */\n  getBoolOrThrow(key: string): boolean {\n    const value = this.getBool(key);\n    if (value === undefined) {\n      throw new Error(`Configuration key \"${key}\" is required but not set`);\n    }\n    return value;\n  }\n\n  /**\n   * Get array value (comma-separated string or actual array)\n   */\n  getArray(key: string, defaultValue?: string[]): string[] | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    if (Array.isArray(value)) {\n      return value.map(String);\n    }\n    return String(value)\n      .split(',')\n      .map((v) => v.trim())\n      .filter(Boolean);\n  }\n\n  /**\n   * Get JSON value\n   */\n  getJson<T = any>(key: string, defaultValue?: T): T | undefined {\n    const value = this.get(key, defaultValue);\n    if (value === undefined) {\n      return undefined;\n    }\n    if (typeof value === 'object') {\n      return value as T;\n    }\n    try {\n      return JSON.parse(String(value)) as T;\n    } catch {\n      return defaultValue;\n    }\n  }\n\n  /**\n   * Check if configuration key exists\n   */\n  has(key: string): boolean {\n    return this.driver.has(key);\n  }\n\n  /**\n   * Get all configuration values\n   */\n  all(): Record<string, any> {\n    return this.driver.all();\n  }\n\n  /**\n   * Clear cache (no-op since we don't cache in ConfigService)\n   */\n  clearCache(): void {\n    // No-op - caching should be done at a higher level if needed\n  }\n}\n","/**\n * Dependency Injection Tokens\n *\n * Used for injecting configuration dependencies.\n */\n\n/**\n * Configuration driver token\n *\n * @example\n * ```typescript\n * @Inject(CONFIG_DRIVER)\n * private driver: ConfigDriver\n * ```\n */\nexport const CONFIG_DRIVER = Symbol('CONFIG_DRIVER');\n\n/**\n * Configuration options token\n *\n * @example\n * ```typescript\n * @Inject(CONFIG_OPTIONS)\n * private options: ConfigModuleOptions\n * ```\n */\nexport const CONFIG_OPTIONS = Symbol('CONFIG_OPTIONS');\n\n/**\n * Configuration service token\n *\n * @example\n * ```typescript\n * @Inject(CONFIG_SERVICE)\n * private config: ConfigService\n * ```\n */\nexport const CONFIG_SERVICE = Symbol('CONFIG_SERVICE');\n","/**\n * Define Config Utility\n *\n * Helper function to define config module options with type safety.\n *\n * @module @abdokouta/config\n */\n\nimport type { ConfigModuleOptions } from '../interfaces/config-module-options.interface';\n\n/**\n * Helper function to define config module options with type safety\n *\n * Provides IDE autocomplete and type checking for configuration objects.\n * This pattern is consistent with modern tooling (Vite, Vitest, etc.).\n *\n * @param config - The config module options object\n * @returns The same configuration object with proper typing\n *\n * @example\n * ```typescript\n * // config.config.ts\n * import { defineConfig } from '@abdokouta/config';\n *\n * export default defineConfig({\n *   driver: 'env',\n *   ignoreEnvFile: true,\n *   isGlobal: true,\n *   envPrefix: 'auto',\n * });\n * ```\n */\nexport function defineConfig(config: ConfigModuleOptions): ConfigModuleOptions {\n  return config;\n}\n","/**\n * Load Config File Utility\n *\n * Dynamically loads and parses a config file.\n */\n\n/**\n * Load and parse config file\n *\n * @param filePath - Absolute path to the config file\n * @returns Parsed config object\n */\nexport async function loadConfigFile(filePath: string): Promise<Record<string, any>> {\n  try {\n    // Dynamic import of the config file\n    // @ts-ignore - Dynamic import path\n    const module = await import(/* @vite-ignore */ filePath);\n\n    // Extract config object (could be default export or named export)\n    const config = module.default || module;\n\n    // If it's a function, call it\n    if (typeof config === 'function') {\n      return await config();\n    }\n\n    return config;\n  } catch (error) {\n    console.warn(`[vite-plugin-config] Failed to load config file: ${filePath}`, error);\n    return {};\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,22 @@
 {
   "name": "@abdokouta/react-config",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "NestJS-inspired configuration management with multiple drivers (Env, File, Firebase) for React",
+  "license": "MIT",
+  "author": {
+    "name": "Abdelrhman Kouta",
+    "email": "abdelrhman@pixielity.com",
+    "url": "https://github.com/abdokouta"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abdokouta/config.git",
+    "directory": "packages/config"
+  },
+  "bugs": {
+    "url": "https://github.com/abdokouta/config/issues"
+  },
+  "homepage": "https://github.com/abdokouta/config#readme",
   "keywords": [
     "react",
     "config",
@@ -9,17 +24,11 @@
     "environment",
     "nestjs",
     "env",
-    "dotenv"
+    "dotenv",
+    "dependency-injection",
+    "di"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pixielity-inc/react-config.git"
-  },
-  "license": "MIT",
-  "author": "Refine",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
+  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -32,22 +41,22 @@
       "require": "./dist/vite-plugin.js"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest --run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest --run --coverage",
-    "test:ui": "vitest --ui",
-    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json}\""
-  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "config",
+    "README.md",
+    "LICENSE"
+  ],
   "dependencies": {
-    "@abdokouta/react-support": "^1.1.0",
-    "@abdokouta/react-di": "^2.1.0"
+    "@abdokouta/react-di": "^2.0.0",
+    "@abdokouta/react-support": "^1.0.0"
   },
   "peerDependencies": {
     "dotenv": "^16.0.0",
-    "vite": "^5.0.0"
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
     "dotenv": {
@@ -65,6 +74,7 @@
     "@types/node": "^25.5.0",
     "@vitest/ui": "^4.1.2",
     "dotenv": "^17.3.1",
+    "jsdom": "^29.0.1",
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",
     "typescript": "^6.0.2",
@@ -72,6 +82,26 @@
     "vitest": "^4.1.2"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist node_modules/.cache",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "release": "pnpm publish --access public --no-git-checks"
   }
-}
+}

package/.examples/01-basic-usage.ts

@@ -1,289 +0,0 @@
-/**
- * Basic Config Usage Example
- * 
- * This example demonstrates the fundamental configuration operations:
- * - Environment variable access
- * - Type-safe getters
- * - Default values
- * - Nested configuration
- * 
- * @example
- * Run this example:
- * ```bash
- * ts-node examples/01-basic-usage.ts
- * ```
- */
-
-import { ConfigModule, ConfigService } from '@abdokouta/config';
-import { Inversiland } from '@abdokouta/react-di';
-
-/**
- * Initialize the config module
- */
-async function setupConfig() {
-  // Set some example environment variables
-  process.env.APP_NAME = 'My Application';
-  process.env.APP_PORT = '3000';
-  process.env.APP_DEBUG = 'true';
-  process.env.APP_URL = 'http://localhost:3000';
-  process.env.ALLOWED_HOSTS = 'localhost,127.0.0.1,example.com';
-  process.env.DATABASE_CONFIG = JSON.stringify({
-    host: 'localhost',
-    port: 5432,
-    database: 'myapp',
-  });
-
-  // Create the application module with config
-  const app = await Inversiland.run({
-    module: class AppModule {},
-    imports: [
-      ConfigModule.forRoot({
-        driver: 'env',
-        ignoreEnvFile: true, // Use process.env directly for this example
-        isGlobal: true,
-      }),
-    ],
-  });
-
-  return app.get(ConfigService);
-}
-
-/**
- * Example 1: Basic string values
- */
-function stringValues(config: ConfigService) {
-  console.log('\n=== Example 1: String Values ===\n');
-
-  // Get string value
-  const appName = config.getString('APP_NAME');
-  console.log(`✓ APP_NAME: "${appName}"`);
-
-  // Get string with default
-  const appEnv = config.getString('APP_ENV', 'development');
-  console.log(`✓ APP_ENV: "${appEnv}" (using default)`);
-
-  // Get URL
-  const appUrl = config.getString('APP_URL');
-  console.log(`✓ APP_URL: "${appUrl}"`);
-}
-
-/**
- * Example 2: Number values
- */
-function numberValues(config: ConfigService) {
-  console.log('\n=== Example 2: Number Values ===\n');
-
-  // Get number value
-  const port = config.getNumber('APP_PORT');
-  console.log(`✓ APP_PORT: ${port} (type: ${typeof port})`);
-
-  // Get number with default
-  const timeout = config.getNumber('APP_TIMEOUT', 5000);
-  console.log(`✓ APP_TIMEOUT: ${timeout} (using default)`);
-
-  // Get number that doesn't exist
-  const maxConnections = config.getNumber('MAX_CONNECTIONS', 100);
-  console.log(`✓ MAX_CONNECTIONS: ${maxConnections} (using default)`);
-}
-
-/**
- * Example 3: Boolean values
- */
-function booleanValues(config: ConfigService) {
-  console.log('\n=== Example 3: Boolean Values ===\n');
-
-  // Get boolean value (true)
-  const debug = config.getBool('APP_DEBUG');
-  console.log(`✓ APP_DEBUG: ${debug} (type: ${typeof debug})`);
-
-  // Get boolean with default
-  const enableCache = config.getBool('ENABLE_CACHE', true);
-  console.log(`✓ ENABLE_CACHE: ${enableCache} (using default)`);
-
-  // Test various boolean formats
-  process.env.TEST_TRUE_1 = 'true';
-  process.env.TEST_TRUE_2 = '1';
-  process.env.TEST_TRUE_3 = 'yes';
-  process.env.TEST_TRUE_4 = 'on';
-  process.env.TEST_FALSE = 'false';
-
-  console.log(`✓ "true" → ${config.getBool('TEST_TRUE_1')}`);
-  console.log(`✓ "1" → ${config.getBool('TEST_TRUE_2')}`);
-  console.log(`✓ "yes" → ${config.getBool('TEST_TRUE_3')}`);
-  console.log(`✓ "on" → ${config.getBool('TEST_TRUE_4')}`);
-  console.log(`✓ "false" → ${config.getBool('TEST_FALSE')}`);
-}
-
-/**
- * Example 4: Array values
- */
-function arrayValues(config: ConfigService) {
-  console.log('\n=== Example 4: Array Values ===\n');
-
-  // Get array from comma-separated string
-  const allowedHosts = config.getArray('ALLOWED_HOSTS');
-  console.log(`✓ ALLOWED_HOSTS:`, allowedHosts);
-
-  // Get array with default
-  const corsOrigins = config.getArray('CORS_ORIGINS', ['http://localhost:3000']);
-  console.log(`✓ CORS_ORIGINS:`, corsOrigins, '(using default)');
-
-  // Empty array
-  const emptyArray = config.getArray('EMPTY_ARRAY', []);
-  console.log(`✓ EMPTY_ARRAY:`, emptyArray, '(using default)');
-}
-
-/**
- * Example 5: JSON values
- */
-function jsonValues(config: ConfigService) {
-  console.log('\n=== Example 5: JSON Values ===\n');
-
-  // Get JSON object
-  const dbConfig = config.getJson('DATABASE_CONFIG');
-  console.log(`✓ DATABASE_CONFIG:`, dbConfig);
-
-  // Get JSON with default
-  const apiConfig = config.getJson('API_CONFIG', {
-    url: 'http://localhost:3000',
-    timeout: 5000,
-  });
-  console.log(`✓ API_CONFIG:`, apiConfig, '(using default)');
-}
-
-/**
- * Example 6: Check if keys exist
- */
-function checkExistence(config: ConfigService) {
-  console.log('\n=== Example 6: Check Existence ===\n');
-
-  // Check existing key
-  const hasAppName = config.has('APP_NAME');
-  console.log(`✓ has('APP_NAME'): ${hasAppName}`);
-
-  // Check non-existent key
-  const hasApiKey = config.has('API_KEY');
-  console.log(`✓ has('API_KEY'): ${hasApiKey}`);
-}
-
-/**
- * Example 7: Required values (OrThrow)
- */
-function requiredValues(config: ConfigService) {
-  console.log('\n=== Example 7: Required Values ===\n');
-
-  try {
-    // Get required value that exists
-    const appName = config.getStringOrThrow('APP_NAME');
-    console.log(`✓ getStringOrThrow('APP_NAME'): "${appName}"`);
-
-    // Try to get required value that doesn't exist
-    const apiKey = config.getStringOrThrow('API_KEY');
-    console.log(`✓ getStringOrThrow('API_KEY'): "${apiKey}"`);
-  } catch (error) {
-    console.log(`✗ Error: ${(error as Error).message}`);
-    console.log(`  💡 Use OrThrow methods for required configuration`);
-  }
-}
-
-/**
- * Example 8: Get all configuration
- */
-function getAllConfig(config: ConfigService) {
-  console.log('\n=== Example 8: Get All Configuration ===\n');
-
-  const allConfig = config.all();
-  const keys = Object.keys(allConfig).filter(k => k.startsWith('APP_') || k.startsWith('ALLOWED_'));
-  
-  console.log('✓ All APP_* and ALLOWED_* configuration:');
-  keys.forEach(key => {
-    console.log(`  - ${key}: ${allConfig[key]}`);
-  });
-}
-
-/**
- * Example 9: Practical use case - Database configuration
- */
-function databaseConfig(config: ConfigService) {
-  console.log('\n=== Example 9: Database Configuration ===\n');
-
-  // Set database environment variables
-  process.env.DB_HOST = 'localhost';
-  process.env.DB_PORT = '5432';
-  process.env.DB_NAME = 'myapp';
-  process.env.DB_USER = 'admin';
-  process.env.DB_PASSWORD = 'secret123';
-  process.env.DB_SSL = 'true';
-  process.env.DB_POOL_MIN = '2';
-  process.env.DB_POOL_MAX = '10';
-
-  // Build database configuration object
-  const dbConfig = {
-    host: config.getString('DB_HOST', 'localhost'),
-    port: config.getNumber('DB_PORT', 5432),
-    database: config.getString('DB_NAME', 'myapp'),
-    username: config.getString('DB_USER'),
-    password: config.getString('DB_PASSWORD'),
-    ssl: config.getBool('DB_SSL', false),
-    pool: {
-      min: config.getNumber('DB_POOL_MIN', 2),
-      max: config.getNumber('DB_POOL_MAX', 10),
-    },
-  };
-
-  console.log('✓ Database configuration:');
-  console.log(JSON.stringify(dbConfig, null, 2));
-}
-
-/**
- * Example 10: Practical use case - Feature flags
- */
-function featureFlags(config: ConfigService) {
-  console.log('\n=== Example 10: Feature Flags ===\n');
-
-  // Set feature flags
-  process.env.FEATURE_CACHE = 'true';
-  process.env.FEATURE_LOGGING = 'true';
-  process.env.FEATURE_METRICS = 'false';
-  process.env.FEATURE_ANALYTICS = '1';
-
-  // Read feature flags
-  const features = {
-    cache: config.getBool('FEATURE_CACHE', false),
-    logging: config.getBool('FEATURE_LOGGING', false),
-    metrics: config.getBool('FEATURE_METRICS', false),
-    analytics: config.getBool('FEATURE_ANALYTICS', false),
-  };
-
-  console.log('✓ Feature flags:');
-  Object.entries(features).forEach(([name, enabled]) => {
-    console.log(`  - ${name}: ${enabled ? '✅ enabled' : '❌ disabled'}`);
-  });
-}
-
-/**
- * Run all examples
- */
-async function main() {
-  console.log('╔════════════════════════════════════════╗');
-  console.log('║   Config Basic Usage Examples          ║');
-  console.log('╚════════════════════════════════════════╝');
-
-  const config = await setupConfig();
-
-  stringValues(config);
-  numberValues(config);
-  booleanValues(config);
-  arrayValues(config);
-  jsonValues(config);
-  checkExistence(config);
-  requiredValues(config);
-  getAllConfig(config);
-  databaseConfig(config);
-  featureFlags(config);
-
-  console.log('\n✅ All examples completed successfully!\n');
-}
-
-// Run the examples
-main().catch(console.error);