@abdokouta/react-config 1.0.0 → 1.0.2

package/src/drivers/env.driver.ts

@@ -1,194 +0,0 @@
-import type { ConfigDriver } from '../interfaces/config-driver.interface';
-import { getNestedValue, hasNestedValue } from '../utils/get-nested-value.util';
-
-/**
- * Environment Variable Configuration Driver
- * 
- * Loads configuration from environment variables (process.env).
- * Supports .env files via dotenv.
- */
-export class EnvDriver implements ConfigDriver {
-  private config: Record<string, any> = {};
-  private loaded = false;
-
-  constructor(
-    private options: {
-      envFilePath?: string | string[];
-      ignoreEnvFile?: boolean;
-      expandVariables?: boolean;
-      envPrefix?: string | false;
-      globalName?: string; // Custom global variable name
-    } = {}
-  ) {}
-
-  /**
-   * Load environment variables
-   */
-  load(): Record<string, any> {
-    if (this.loaded) {
-      console.log('[EnvDriver] Already loaded, returning cached config');
-      return this.config;
-    }
-
-    console.log('[EnvDriver] Loading environment variables...');
-    console.log('[EnvDriver] Options:', { ...this.options });
-
-    // Load .env file if not ignored
-    if (!this.options.ignoreEnvFile) {
-      this.loadDotEnv();
-    }
-
-    // Get global config name (default: __APP_CONFIG__)
-    const globalName = this.options.globalName || '__APP_CONFIG__';
-
-    // Try to load from custom global variable first (browser environment)
-    if (typeof window !== 'undefined' && (window as any)[globalName]) {
-      this.config = { ...(window as any)[globalName] };
-      console.log(`[EnvDriver] Loaded config from window.${globalName}:`, Object.keys(this.config).length, 'keys');
-    }
-    // Fallback to process.env (Node.js environment or backward compatibility)
-    else if (typeof process !== 'undefined' && process.env) {
-      this.config = { ...process.env };
-      console.log('[EnvDriver] Loaded config from process.env:', Object.keys(this.config).length, 'keys');
-    }
-    // No config source available
-    else {
-      console.warn('[EnvDriver] No config source available (neither window.' + globalName + ' nor process.env)');
-      this.config = {};
-    }
-
-    console.log('[EnvDriver] Initial config keys:', [...Object.keys(this.config).filter(k => k.includes('APP') || k.includes('VITE'))]);
-
-    // Strip prefix if configured
-    if (this.options.envPrefix !== false) {
-      console.log('[EnvDriver] Stripping prefix...');
-      this.stripPrefix();
-      console.log('[EnvDriver] After stripPrefix, config keys:', [...Object.keys(this.config).filter(k => k.includes('APP') || k.includes('VITE'))]);
-    }
-
-    // Expand variables if enabled
-    if (this.options.expandVariables) {
-      this.expandEnvVariables();
-    }
-
-    this.loaded = true;
-    console.log('[EnvDriver] Load complete. Sample values:', {
-      APP_NAME: this.config.APP_NAME,
-      VITE_APP_NAME: this.config.VITE_APP_NAME,
-    });
-    return this.config;
-  }
-
-  /**
-   * Get configuration value
-   */
-  get<T = any>(key: string, defaultValue?: T): T | undefined {
-    if (!this.loaded) {
-      this.load();
-    }
-    const value = getNestedValue(this.config, key, defaultValue);
-    console.log(`[EnvDriver] get("${key}", "${defaultValue}") = "${value}"`);
-    return value;
-  }
-
-  /**
-   * Check if key exists
-   */
-  has(key: string): boolean {
-    if (!this.loaded) {
-      this.load();
-    }
-    return hasNestedValue(this.config, key);
-  }
-
-  /**
-   * Get all configuration
-   */
-  all(): Record<string, any> {
-    if (!this.loaded) {
-      this.load();
-    }
-    return { ...this.config };
-  }
-
-  /**
-   * Load .env file using dotenv
-   */
-  private loadDotEnv(): void {
-    try {
-      // Try to load dotenv
-      const dotenv = require('dotenv');
-      const paths = Array.isArray(this.options.envFilePath)
-        ? this.options.envFilePath
-        : [this.options.envFilePath || '.env'];
-
-      for (const path of paths) {
-        dotenv.config({ path });
-      }
-    } catch (error) {
-      // dotenv not installed, skip
-    }
-  }
-
-  /**
-   * Expand environment variables (e.g., ${VAR_NAME})
-   */
-  private expandEnvVariables(): void {
-    const regex = /\$\{([^}]+)\}/g;
-
-    const expand = (value: string): string => {
-      return value.replace(regex, (_, key) => {
-        return this.config[key] || '';
-      });
-    };
-
-    for (const [key, value] of Object.entries(this.config)) {
-      if (typeof value === 'string' && value.includes('${')) {
-        this.config[key] = expand(value);
-      }
-    }
-  }
-
-  /**
-   * Strip environment variable prefix
-   * Auto-detects framework (Vite, Next.js) or uses custom prefix
-   */
-  private stripPrefix(): void {
-    let prefix = this.options.envPrefix;
-
-    // Auto-detect framework prefix
-    if (prefix === 'auto' || prefix === undefined) {
-      // Check for Vite (import.meta.env exists or VITE_ variables present)
-      const hasViteVars = Object.keys(this.config).some(key => key.startsWith('VITE_'));
-      if (hasViteVars || typeof import.meta !== 'undefined') {
-        prefix = 'VITE_';
-      }
-      // Check for Next.js (NEXT_PUBLIC_ variables present)
-      else if (Object.keys(this.config).some(key => key.startsWith('NEXT_PUBLIC_'))) {
-        prefix = 'NEXT_PUBLIC_';
-      }
-      // No framework detected, don't strip
-      else {
-        return;
-      }
-    }
-
-    // Strip the prefix from all matching keys
-    if (typeof prefix === 'string' && prefix.length > 0) {
-      const newConfig: Record<string, any> = {};
-      
-      for (const [key, value] of Object.entries(this.config)) {
-        if (key.startsWith(prefix)) {
-          // Add both prefixed and unprefixed versions
-          const unprefixedKey = key.substring(prefix.length);
-          newConfig[unprefixedKey] = value;
-          newConfig[key] = value; // Keep original too
-        } else {
-          newConfig[key] = value;
-        }
-      }
-      
-      this.config = newConfig;
-    }
-  }
-}

package/src/drivers/file.driver.ts

@@ -1,81 +0,0 @@
-import type { ConfigDriver } from '@/interfaces/config-driver.interface';
-import { getNestedValue, hasNestedValue } from '@/utils/get-nested-value.util';
-
-/**
- * File-based Configuration Driver
- * 
- * Loads configuration from TypeScript/JavaScript files.
- * This is a server-side only driver. For client-side, use the Vite plugin.
- * 
- * @see packages/pixielity/config/src/plugins/vite-config.plugin.ts
- */
-export class FileDriver implements ConfigDriver {
-  private config: Record<string, any> = {};
-  private loaded = false;
-
-  constructor(
-    options: {
-      config?: Record<string, any>;
-    } = {}
-  ) {
-    // Pre-loaded config from Vite plugin or server
-    if (options.config) {
-      this.config = options.config;
-      this.loaded = true;
-    }
-  }
-
-  /**
-   * Load configuration
-   * Config should be pre-loaded via Vite plugin or passed in constructor
-   */
-  async load(): Promise<Record<string, any>> {
-    if (this.loaded) {
-      return this.config;
-    }
-
-    // If running on server (Node.js), throw error
-    const isServer = typeof globalThis !== 'undefined' && 
-                     typeof (globalThis as typeof globalThis & { window?: any }).window === 'undefined';
-    
-    if (isServer) {
-      throw new Error(
-        'FileDriver requires pre-loaded configuration. ' +
-        'Use Vite plugin for client-side or pass config in constructor for server-side.'
-      );
-    }
-
-    this.loaded = true;
-    return this.config;
-  }
-
-  /**
-   * Get configuration value
-   */
-  get<T = any>(key: string, defaultValue?: T): T | undefined {
-    if (!this.loaded) {
-      throw new Error('Configuration not loaded. Call load() first or use async initialization.');
-    }
-    return getNestedValue(this.config, key, defaultValue);
-  }
-
-  /**
-   * Check if key exists
-   */
-  has(key: string): boolean {
-    if (!this.loaded) {
-      throw new Error('Configuration not loaded. Call load() first or use async initialization.');
-    }
-    return hasNestedValue(this.config, key);
-  }
-
-  /**
-   * Get all configuration
-   */
-  all(): Record<string, any> {
-    if (!this.loaded) {
-      throw new Error('Configuration not loaded. Call load() first or use async initialization.');
-    }
-    return { ...this.config };
-  }
-}

package/src/drivers/index.ts

@@ -1,6 +0,0 @@
-/**
- * Drivers
- */
-
-export { EnvDriver } from './env.driver';
-export { FileDriver } from './file.driver';

package/src/index.ts

@@ -1,92 +0,0 @@
-/**
- * @abdokouta/config
- *
- * NestJS-inspired configuration management with multiple drivers for loading
- * configuration from various sources (environment variables, files, etc.).
- * Provides type-safe access to configuration values with support for nested
- * properties and default values.
- *
- * @example
- * Basic usage with environment variables:
- * ```typescript
- * import { ConfigModule, ConfigService, EnvDriver } from '@abdokouta/config';
- * import { Module, Injectable, Inject } from '@abdokouta/react-di';
- *
- * @Module({
- *   imports: [
- *     ConfigModule.forRoot({
- *       driver: new EnvDriver(),
- *     }),
- *   ],
- * })
- * export class AppModule {}
- *
- * @Injectable()
- * class DatabaseService {
- *   constructor(@Inject(ConfigService) private config: ConfigService) {}
- *
- *   connect() {
- *     const host = this.config.get('DATABASE_HOST', 'localhost');
- *     const port = this.config.get('DATABASE_PORT', 5432);
- *     // Connect to database...
- *   }
- * }
- * ```
- *
- * @example
- * Using file-based configuration:
- * ```typescript
- * import { ConfigModule, FileDriver } from '@abdokouta/config';
- *
- * @Module({
- *   imports: [
- *     ConfigModule.forRoot({
- *       driver: new FileDriver({
- *         path: './config/app.json',
- *       }),
- *     }),
- *   ],
- * })
- * export class AppModule {}
- * ```
- *
- * @example
- * Accessing nested configuration:
- * ```typescript
- * // config.json: { "database": { "host": "localhost", "port": 5432 } }
- * const host = config.get('database.host');
- * const port = config.get('database.port', 3306);
- * ```
- *
- * @module @abdokouta/config
- */
-
-// ============================================================================
-// Module (DI Configuration)
-// ============================================================================
-export { ConfigModule } from './config.module';
-
-// ============================================================================
-// Core Service
-// ============================================================================
-export { ConfigService } from './services/config.service';
-
-// ============================================================================
-// Drivers
-// ============================================================================
-export { EnvDriver } from './drivers/env.driver';
-export { FileDriver } from './drivers/file.driver';
-
-// ============================================================================
-// Interfaces
-// ============================================================================
-export type { ConfigDriver } from './interfaces/config-driver.interface';
-export type { ConfigModuleOptions } from './interfaces/config-module-options.interface';
-export type { ConfigServiceInterface } from './interfaces/config-service.interface';
-export type { ViteConfigPluginOptions } from './interfaces/vite-config-plugin-options.interface';
-
-// ============================================================================
-// Utilities
-// ============================================================================
-export { getNestedValue, hasNestedValue } from './utils/get-nested-value.util';
-export { loadConfigFile } from './utils/load-config-file.util';

package/src/interfaces/config-driver.interface.ts

@@ -1,30 +0,0 @@
-/**
- * Configuration Driver Interface
- * 
- * Defines the contract for configuration drivers (env, file, firebase, etc.)
- */
-export interface ConfigDriver {
-  /**
-   * Load configuration from the driver source
-   * @returns Configuration object
-   */
-  load(): Promise<Record<string, any>> | Record<string, any>;
-
-  /**
-   * Get a configuration value by key
-   * @param key - Configuration key (supports dot notation)
-   * @param defaultValue - Default value if key not found
-   */
-  get<T = any>(key: string, defaultValue?: T): T | undefined;
-
-  /**
-   * Check if a configuration key exists
-   * @param key - Configuration key
-   */
-  has(key: string): boolean;
-
-  /**
-   * Get all configuration values
-   */
-  all(): Record<string, any>;
-}

package/src/interfaces/config-module-options.interface.ts

@@ -1,84 +0,0 @@
-/**
- * Configuration Module Options
- */
-export interface ConfigModuleOptions {
-  /**
-   * Configuration driver to use
-   * @default 'env'
-   */
-  driver?: 'env' | 'file' | 'firebase' | string;
-
-  /**
-   * Path to .env file (for env driver)
-   * @default '.env'
-   */
-  envFilePath?: string | string[];
-
-  /**
-   * Path pattern to scan for config files (for file driver)
-   * @example 'config/**\/*.config.ts'
-   */
-  filePattern?: string | string[];
-
-  /**
-   * Whether to ignore .env file
-   * @default false
-   */
-  ignoreEnvFile?: boolean;
-
-  /**
-   * Whether to expand environment variables
-   * @default false
-   */
-  expandVariables?: boolean;
-
-  /**
-   * Custom configuration object to merge
-   */
-  load?: Record<string, any> | (() => Record<string, any> | Promise<Record<string, any>>);
-
-  /**
-   * Whether configuration is global
-   * @default false
-   */
-  isGlobal?: boolean;
-
-  /**
-   * Cache configuration values
-   * @default true
-   */
-  cache?: boolean;
-
-  /**
-   * Validate configuration on load
-   */
-  validate?: (config: Record<string, any>) => void | Promise<void>;
-
-  /**
-   * Firebase configuration (for firebase driver)
-   */
-  firebase?: {
-    projectId: string;
-    configPath?: string;
-  };
-
-  /**
-   * Environment variable prefix to strip
-   * Set to 'auto' to auto-detect (VITE_ for Vite, NEXT_PUBLIC_ for Next.js)
-   * Set to 'VITE_' or 'NEXT_PUBLIC_' for specific framework
-   * Set to a custom string to strip that prefix
-   * Set to false to disable prefix stripping
-   * @default 'auto'
-   * @example 'VITE_' - strips VITE_ prefix, so VITE_APP_NAME becomes APP_NAME
-   * @example 'NEXT_PUBLIC_' - strips NEXT_PUBLIC_ prefix, so NEXT_PUBLIC_API_URL becomes API_URL
-   * @example 'auto' - auto-detects framework and strips appropriate prefix
-   */
-  envPrefix?: 'auto' | 'VITE_' | 'NEXT_PUBLIC_' | string | false;
-
-  /**
-   * Global variable name to read config from in browser
-   * @default '__APP_CONFIG__'
-   * @example '__APP_CONFIG__' - reads from window.__APP_CONFIG__
-   */
-  globalName?: string;
-}

package/src/interfaces/config-service.interface.ts

@@ -1,71 +0,0 @@
-/**
- * Configuration Service Interface
- * 
- * Defines the contract for configuration service implementations.
- */
-export interface ConfigServiceInterface {
-  /**
-   * Get configuration value
-   */
-  get<T = any>(key: string, defaultValue?: T): T | undefined;
-
-  /**
-   * Get configuration value or throw if not found
-   */
-  getOrThrow<T = any>(key: string): T;
-
-  /**
-   * Get string value
-   */
-  getString(key: string, defaultValue?: string): string | undefined;
-
-  /**
-   * Get string value or throw
-   */
-  getStringOrThrow(key: string): string;
-
-  /**
-   * Get number value
-   */
-  getNumber(key: string, defaultValue?: number): number | undefined;
-
-  /**
-   * Get number value or throw
-   */
-  getNumberOrThrow(key: string): number;
-
-  /**
-   * Get boolean value
-   */
-  getBool(key: string, defaultValue?: boolean): boolean | undefined;
-
-  /**
-   * Get boolean value or throw
-   */
-  getBoolOrThrow(key: string): boolean;
-
-  /**
-   * Get array value
-   */
-  getArray(key: string, defaultValue?: string[]): string[] | undefined;
-
-  /**
-   * Get JSON value
-   */
-  getJson<T = any>(key: string, defaultValue?: T): T | undefined;
-
-  /**
-   * Check if configuration key exists
-   */
-  has(key: string): boolean;
-
-  /**
-   * Get all configuration values
-   */
-  all(): Record<string, any>;
-
-  /**
-   * Clear cache
-   */
-  clearCache(): void;
-}

package/src/interfaces/index.ts

@@ -1,8 +0,0 @@
-/**
- * Interfaces
- */
-
-export type { ConfigDriver } from './config-driver.interface';
-export type { ConfigModuleOptions } from './config-module-options.interface';
-export type { ConfigServiceInterface } from './config-service.interface';
-export type { ViteConfigPluginOptions } from './vite-config-plugin-options.interface';

package/src/interfaces/vite-config-plugin-options.interface.ts

@@ -1,56 +0,0 @@
-/**
- * Vite Config Plugin Options Interface
- *
- * Configuration options for the Vite config plugin that injects
- * environment variables into the browser.
- */
-
-export interface ViteConfigPluginOptions {
-  /**
-   * Environment variables loaded by Vite's loadEnv
-   * Pass the result of loadEnv(mode, envDir, '') here
-   */
-  env?: Record<string, string>;
-
-  /**
-   * Scan and collect .config.ts files
-   * @default false (disabled by default to avoid Node.js module issues)
-   */
-  scanConfigFiles?: boolean;
-
-  /**
-   * Pattern to match config files
-   * @default 'src/**\/*.config.ts'
-   */
-  configFilePattern?: string | string[];
-
-  /**
-   * Directories to exclude from config file scanning
-   * @default ['node_modules', 'dist', 'build', '.git']
-   */
-  excludeDirs?: string[];
-
-  /**
-   * Root directory for scanning config files
-   * @default process.cwd()
-   */
-  root?: string;
-
-  /**
-   * Include all environment variables
-   * @default true
-   */
-  includeAll?: boolean;
-
-  /**
-   * Specific environment variables to include
-   * Only used if includeAll is false
-   */
-  include?: string[];
-
-  /**
-   * Global variable name to inject config into
-   * @default '__APP_CONFIG__'
-   */
-  globalName?: string;
-}

package/src/plugins/index.ts

@@ -1,5 +0,0 @@
-/**
- * Plugins
- */
-
-export { viteConfigPlugin } from './vite.plugin';