@abdokouta/react-config 1.0.1 → 1.0.2

package/__tests__/drivers/env.driver.test.ts

@@ -1,259 +0,0 @@
-/**
- * @fileoverview Tests for EnvDriver
- *
- * This test suite verifies the EnvDriver functionality including:
- * - Loading environment variables
- * - Getting values with dot notation
- * - Variable expansion
- * - Default values
- * - Type conversions
- *
- * @module @abdokouta/config
- * @category Tests
- */
-
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { EnvDriver } from '@/drivers/env.driver';
-
-describe('EnvDriver', () => {
-  const originalEnv = process.env;
-
-  beforeEach(() => {
-    // Arrange: Reset environment
-    process.env = { ...originalEnv };
-  });
-
-  afterEach(() => {
-    // Cleanup: Restore environment
-    process.env = originalEnv;
-  });
-
-  describe('load', () => {
-    it('should load environment variables', () => {
-      // Arrange: Set env vars
-      process.env.APP_NAME = 'Test App';
-      process.env.APP_PORT = '3000';
-      process.env.APP_DEBUG = 'true';
-
-      const driver = new EnvDriver();
-
-      // Act: Load config
-      const config = driver.load();
-
-      // Assert: Config is loaded
-      expect(config).toBeDefined();
-      expect(typeof config).toBe('object');
-    });
-
-    it('should handle empty environment', () => {
-      // Arrange: Clear env
-      process.env = {};
-
-      const driver = new EnvDriver();
-
-      // Act: Load config
-      const config = driver.load();
-
-      // Assert: Empty config is returned
-      expect(config).toBeDefined();
-      expect(typeof config).toBe('object');
-    });
-  });
-
-  describe('get', () => {
-    beforeEach(() => {
-      // Arrange: Set test env vars
-      process.env.APP_NAME = 'Test App';
-      process.env.APP_PORT = '3000';
-      process.env.DATABASE_HOST = 'localhost';
-      process.env.DATABASE_PORT = '5432';
-    });
-
-    it('should get environment variable', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get value
-      const appName = driver.get('APP_NAME');
-
-      // Assert: Value is returned
-      expect(appName).toBe('Test App');
-    });
-
-    it("should return default value when key doesn't exist", () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get with default
-      const value = driver.get('MISSING_KEY', 'default');
-
-      // Assert: Default is returned
-      expect(value).toBe('default');
-    });
-
-    it("should return undefined when key doesn't exist and no default", () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get without default
-      const value = driver.get('MISSING_KEY');
-
-      // Assert: Undefined is returned
-      expect(value).toBeUndefined();
-    });
-
-    it('should handle numeric string values', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get numeric value
-      const port = driver.get('APP_PORT');
-
-      // Assert: String is returned (no auto-conversion)
-      expect(port).toBe('3000');
-    });
-  });
-
-  describe('has', () => {
-    beforeEach(() => {
-      // Arrange: Set test env vars
-      process.env.APP_NAME = 'Test App';
-      process.env.EMPTY_VAR = '';
-    });
-
-    it('should return true for existing key', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Check existence
-      const exists = driver.has('APP_NAME');
-
-      // Assert: Key exists
-      expect(exists).toBe(true);
-    });
-
-    it('should return false for missing key', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Check existence
-      const exists = driver.has('MISSING_KEY');
-
-      // Assert: Key doesn't exist
-      expect(exists).toBe(false);
-    });
-
-    it('should return true for empty string value', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Check existence
-      const exists = driver.has('EMPTY_VAR');
-
-      // Assert: Key exists even with empty value
-      expect(exists).toBe(true);
-    });
-  });
-
-  describe('all', () => {
-    beforeEach(() => {
-      // Arrange: Set test env vars
-      process.env.APP_NAME = 'Test App';
-      process.env.APP_PORT = '3000';
-      process.env.DATABASE_HOST = 'localhost';
-    });
-
-    it('should return all configuration', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get all config
-      const config = driver.all();
-
-      // Assert: All config is returned
-      expect(config).toBeDefined();
-      expect(typeof config).toBe('object');
-    });
-
-    it('should include all loaded variables', () => {
-      // Arrange: Create driver
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get all config
-      const config = driver.all();
-
-      // Assert: Contains loaded vars
-      expect(config).toBeDefined();
-    });
-  });
-
-  describe('Variable Expansion', () => {
-    it('should expand variables when enabled', () => {
-      // Arrange: Set vars with references
-      process.env.BASE_URL = 'http://localhost';
-      process.env.API_URL = '${BASE_URL}/api';
-
-      const driver = new EnvDriver({ expandVariables: true });
-      driver.load();
-
-      // Act: Get expanded value
-      const apiUrl = driver.get('API_URL');
-
-      // Assert: Variable is expanded (if implemented)
-      expect(apiUrl).toBeDefined();
-    });
-  });
-
-  describe('Edge Cases', () => {
-    it('should handle special characters in values', () => {
-      // Arrange: Set var with special chars
-      process.env.SPECIAL = 'value with spaces & symbols!@#';
-
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get value
-      const value = driver.get('SPECIAL');
-
-      // Assert: Special chars are preserved
-      expect(value).toBe('value with spaces & symbols!@#');
-    });
-
-    it('should handle multiline values', () => {
-      // Arrange: Set multiline var
-      process.env.MULTILINE = 'line1\\nline2\\nline3';
-
-      const driver = new EnvDriver();
-      driver.load();
-
-      // Act: Get value
-      const value = driver.get('MULTILINE');
-
-      // Assert: Multiline is preserved
-      expect(value).toBeDefined();
-    });
-
-    it('should handle empty environment', () => {
-      // Arrange: Clear all env vars
-      process.env = {};
-
-      const driver = new EnvDriver();
-
-      // Act: Load and get
-      driver.load();
-      const value = driver.get('ANY_KEY', 'default');
-
-      // Assert: Default is returned
-      expect(value).toBe('default');
-    });
-  });
-});

package/__tests__/services/config.service.test.ts

@@ -1,335 +0,0 @@
-/**
- * @fileoverview Tests for ConfigService
- *
- * This test suite verifies the ConfigService functionality including:
- * - Getting configuration values
- * - Type-safe getters (getString, getNumber, getBoolean)
- * - Throwing methods (getOrThrow, getStringOrThrow)
- * - Default value handling
- * - Nested key access
- *
- * @module @abdokouta/config
- * @category Tests
- */
-
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { ConfigService } from '@/services/config.service';
-import type { ConfigDriver } from '@/interfaces/config-driver.interface';
-
-describe('ConfigService', () => {
-  let mockDriver: ConfigDriver;
-  let configService: ConfigService;
-
-  beforeEach(() => {
-    // Arrange: Create mock driver
-    mockDriver = {
-      load: vi.fn().mockReturnValue({
-        app: {
-          name: 'Test App',
-          port: 3000,
-          debug: true,
-        },
-        database: {
-          host: 'localhost',
-          port: 5432,
-          name: 'testdb',
-        },
-        api: {
-          key: 'test-key-123',
-          timeout: 5000,
-        },
-      }),
-      get: vi.fn((key: string, defaultValue?: any) => {
-        const data: any = {
-          'app.name': 'Test App',
-          'app.port': 3000,
-          'app.debug': true,
-          'database.host': 'localhost',
-          'database.port': 5432,
-          'api.key': 'test-key-123',
-        };
-        return data[key] ?? defaultValue;
-      }),
-      has: vi.fn((key: string) => {
-        const keys = [
-          'app.name',
-          'app.port',
-          'app.debug',
-          'database.host',
-          'database.port',
-          'api.key',
-        ];
-        return keys.includes(key);
-      }),
-      all: vi.fn().mockReturnValue({
-        app: { name: 'Test App', port: 3000, debug: true },
-        database: { host: 'localhost', port: 5432, name: 'testdb' },
-      }),
-    };
-
-    configService = new ConfigService(mockDriver);
-  });
-
-  describe('get', () => {
-    it('should get existing configuration value', () => {
-      // Act: Get config value
-      const appName = configService.get('app.name');
-
-      // Assert: Value is returned
-      expect(appName).toBe('Test App');
-      expect(mockDriver.get).toHaveBeenCalledWith('app.name', undefined);
-    });
-
-    it("should return default value when key doesn't exist", () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn((key, defaultValue) => defaultValue);
-
-      // Act: Get with default
-      const value = configService.get('missing.key', 'default');
-
-      // Assert: Default is returned
-      expect(value).toBe('default');
-    });
-
-    it("should return undefined when key doesn't exist and no default", () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn(() => undefined);
-
-      // Act: Get without default
-      const value = configService.get('missing.key');
-
-      // Assert: Undefined is returned
-      expect(value).toBeUndefined();
-    });
-
-    it('should handle nested keys', () => {
-      // Act: Get nested value
-      const dbHost = configService.get('database.host');
-
-      // Assert: Nested value is returned
-      expect(dbHost).toBe('localhost');
-    });
-
-    it('should handle numeric values', () => {
-      // Act: Get numeric value
-      const port = configService.get<number>('app.port');
-
-      // Assert: Number is returned
-      expect(port).toBe(3000);
-      expect(typeof port).toBe('number');
-    });
-
-    it('should handle boolean values', () => {
-      // Act: Get boolean value
-      const debug = configService.get<boolean>('app.debug');
-
-      // Assert: Boolean is returned
-      expect(debug).toBe(true);
-      expect(typeof debug).toBe('boolean');
-    });
-  });
-
-  describe('getOrThrow', () => {
-    it('should return value when key exists', () => {
-      // Act: Get existing key
-      const appName = configService.getOrThrow('app.name');
-
-      // Assert: Value is returned
-      expect(appName).toBe('Test App');
-    });
-
-    it("should throw error when key doesn't exist", () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn(() => undefined);
-
-      // Act & Assert: Should throw
-      expect(() => {
-        configService.getOrThrow('missing.key');
-      }).toThrow();
-    });
-
-    it('should throw with descriptive error message', () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn(() => undefined);
-
-      // Act & Assert: Should throw with message
-      expect(() => {
-        configService.getOrThrow('missing.key');
-      }).toThrow(/missing\.key/);
-    });
-  });
-
-  describe('getString', () => {
-    it('should return string value', () => {
-      // Act: Get string
-      const appName = configService.getString('app.name');
-
-      // Assert: String is returned
-      expect(appName).toBe('Test App');
-      expect(typeof appName).toBe('string');
-    });
-
-    it("should return default string when key doesn't exist", () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn((key, defaultValue) => defaultValue);
-
-      // Act: Get with default
-      const value = configService.getString('missing.key', 'default');
-
-      // Assert: Default is returned
-      expect(value).toBe('default');
-    });
-
-    it('should return undefined when no default provided', () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn(() => undefined);
-
-      // Act: Get without default
-      const value = configService.getString('missing.key');
-
-      // Assert: Undefined is returned
-      expect(value).toBeUndefined();
-    });
-  });
-
-  describe('getStringOrThrow', () => {
-    it('should return string value when key exists', () => {
-      // Act: Get existing string
-      const apiKey = configService.getStringOrThrow('api.key');
-
-      // Assert: String is returned
-      expect(apiKey).toBe('test-key-123');
-      expect(typeof apiKey).toBe('string');
-    });
-
-    it("should throw when key doesn't exist", () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn(() => undefined);
-
-      // Act & Assert: Should throw
-      expect(() => {
-        configService.getStringOrThrow('missing.key');
-      }).toThrow();
-    });
-  });
-
-  describe('getNumber', () => {
-    it('should return number value', () => {
-      // Act: Get number
-      const port = configService.getNumber('app.port');
-
-      // Assert: Number is returned
-      expect(port).toBe(3000);
-      expect(typeof port).toBe('number');
-    });
-
-    it("should return default number when key doesn't exist", () => {
-      // Arrange: Mock missing key
-      mockDriver.get = vi.fn((key, defaultValue) => defaultValue);
-
-      // Act: Get with default
-      const value = configService.getNumber('missing.key', 8080);
-
-      // Assert: Default is returned
-      expect(value).toBe(8080);
-    });
-
-    it('should parse string numbers', () => {
-      // Arrange: Mock string number
-      mockDriver.get = vi.fn(() => '5432');
-
-      // Act: Get as number
-      const port = configService.getNumber('database.port');
-
-      // Assert: Parsed number is returned
-      expect(port).toBe(5432);
-      expect(typeof port).toBe('number');
-    });
-  });
-
-  describe('getBoolean', () => {
-    it('should return boolean value', () => {
-      // Act: Get boolean
-      const debug = configService.getBoolean('app.debug');
-
-      // Assert: Boolean is returned
-      expect(debug).toBe(true);
-      expect(typeof debug).toBe('boolean');
-    });
-
-    it('should parse string booleans', () => {
-      // Arrange: Mock string boolean
-      mockDriver.get = vi.fn((key) => {
-        if (key === 'feature.enabled') return 'true';
-        if (key === 'feature.disabled') return 'false';
-        return undefined;
-      });
-
-      // Act: Get as boolean
-      const enabled = configService.getBoolean('feature.enabled');
-      const disabled = configService.getBoolean('feature.disabled');
-
-      // Assert: Parsed booleans are returned
-      expect(enabled).toBe(true);
-      expect(disabled).toBe(false);
-    });
-
-    it('should handle truthy/falsy values', () => {
-      // Arrange: Mock various values
-      mockDriver.get = vi.fn((key) => {
-        if (key === 'one') return 1;
-        if (key === 'zero') return 0;
-        if (key === 'yes') return 'yes';
-        if (key === 'no') return 'no';
-        return undefined;
-      });
-
-      // Act: Get as booleans
-      const one = configService.getBoolean('one');
-      const zero = configService.getBoolean('zero');
-      const yes = configService.getBoolean('yes');
-      const no = configService.getBoolean('no');
-
-      // Assert: Values are converted to boolean
-      expect(one).toBe(true);
-      expect(zero).toBe(false);
-      expect(yes).toBe(true);
-      expect(no).toBe(false);
-    });
-  });
-
-  describe('Edge Cases', () => {
-    it('should handle null values', () => {
-      // Arrange: Mock null value
-      mockDriver.get = vi.fn(() => null);
-
-      // Act: Get null value
-      const value = configService.get('null.key');
-
-      // Assert: Null is returned
-      expect(value).toBeNull();
-    });
-
-    it('should handle empty string values', () => {
-      // Arrange: Mock empty string
-      mockDriver.get = vi.fn(() => '');
-
-      // Act: Get empty string
-      const value = configService.getString('empty.key');
-
-      // Assert: Empty string is returned
-      expect(value).toBe('');
-    });
-
-    it('should handle zero values', () => {
-      // Arrange: Mock zero
-      mockDriver.get = vi.fn(() => 0);
-
-      // Act: Get zero
-      const value = configService.getNumber('zero.key');
-
-      // Assert: Zero is returned
-      expect(value).toBe(0);
-    });
-  });
-});

package/__tests__/setup.d.ts

@@ -1,11 +0,0 @@
-/**
- * @fileoverview Type declarations for Vitest test environment
- *
- * This file extends Vitest's type definitions to include custom matchers
- * and global test utilities.
- *
- * @module @abdokouta/config
- * @category Configuration
- */
-
-import 'vitest/globals';

package/__tests__/vitest.setup.ts

@@ -1,30 +0,0 @@
-/**
- * @fileoverview Vitest setup file for @abdokouta/config package
- *
- * This file configures the testing environment before running tests.
- * It sets up container mocking for dependency injection tests.
- *
- * Setup Features:
- * - Container mocking for DI tests
- *
- * @module @abdokouta/config
- * @category Configuration
- */
-
-import { vi } from 'vitest';
-
-/**
- * Mock @abdokouta/react-di decorators
- *
- * This ensures that decorator metadata doesn't interfere with tests
- * and allows us to test module behavior in isolation.
- */
-vi.mock('@abdokouta/react-di', async () => {
-  const actual = await vi.importActual('@abdokouta/react-di');
-  return {
-    ...actual,
-    Injectable: () => (target: any) => target,
-    Inject: () => (target: any, propertyKey: string, parameterIndex: number) => {},
-    Module: (metadata: any) => (target: any) => target,
-  };
-});

package/eslint.config.js

@@ -1,13 +0,0 @@
-import nesvelConfig from '@nesvel/eslint-config';
-
-export default [
-  ...nesvelConfig,
-  {
-    ignores: ['dist/**', 'node_modules/**', '*.config.js', '*.config.ts'],
-  },
-  {
-    rules: {
-      // Add any package-specific rule overrides here
-    },
-  },
-];