@hazeljs/config 0.2.0-alpha.1

package/dist/config.module.d.ts

@@ -0,0 +1,46 @@
+export declare class ConfigModule {
+    /**
+     * Register ConfigModule with options
+     */
+    static forRoot(options?: ConfigModuleOptions): typeof ConfigModule;
+}
+export interface ConfigModuleOptions {
+    /**
+     * Path to .env file
+     */
+    envFilePath?: string | string[];
+    /**
+     * Whether to ignore .env file
+     */
+    ignoreEnvFile?: boolean;
+    /**
+     * Whether to ignore environment variables
+     */
+    ignoreEnvVars?: boolean;
+    /**
+     * Validation schema for configuration
+     */
+    validationSchema?: ValidationSchema;
+    /**
+     * Validation options
+     */
+    validationOptions?: {
+        allowUnknown?: boolean;
+        abortEarly?: boolean;
+    };
+    /**
+     * Whether configuration is global
+     */
+    isGlobal?: boolean;
+    /**
+     * Custom configuration loader
+     */
+    load?: Array<() => Record<string, unknown>>;
+}
+export interface ValidationSchema {
+    validate(config: Record<string, unknown>): {
+        error?: Error;
+        value: Record<string, unknown>;
+    };
+}
+//# sourceMappingURL=config.module.d.ts.map

package/dist/config.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../src/config.module.ts"],"names":[],"mappings":"AAGA,qBAIa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,YAAY;CAMnE;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,iBAAiB,CAAC,EAAE;QAClB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACzC,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;CACH"}

package/dist/config.module.js

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ConfigModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigModule = void 0;
+const core_1 = require("@hazeljs/core");
+const config_service_1 = require("./config.service");
+let ConfigModule = ConfigModule_1 = class ConfigModule {
+    /**
+     * Register ConfigModule with options
+     */
+    static forRoot(options) {
+        if (options) {
+            config_service_1.ConfigService.setOptions(options);
+        }
+        return ConfigModule_1;
+    }
+};
+exports.ConfigModule = ConfigModule;
+exports.ConfigModule = ConfigModule = ConfigModule_1 = __decorate([
+    (0, core_1.HazelModule)({
+        providers: [config_service_1.ConfigService],
+        exports: [config_service_1.ConfigService],
+    })
+], ConfigModule);

package/dist/config.service.d.ts

@@ -0,0 +1,49 @@
+import { ConfigModuleOptions } from './config.module';
+export declare class ConfigService {
+    private static options;
+    private config;
+    private isLoaded;
+    constructor();
+    /**
+     * Set module options (called by ConfigModule.forRoot)
+     */
+    static setOptions(options: ConfigModuleOptions): void;
+    /**
+     * Load configuration
+     */
+    private load;
+    /**
+     * Load environment files
+     */
+    private loadEnvFiles;
+    /**
+     * Validate configuration against schema
+     */
+    private validate;
+    /**
+     * Get a configuration value
+     */
+    get<T = unknown>(key: string): T | undefined;
+    get<T = unknown>(key: string, defaultValue: T): T;
+    /**
+     * Get nested value using dot notation
+     */
+    private getNestedValue;
+    /**
+     * Get all configuration
+     */
+    getAll(): Record<string, unknown>;
+    /**
+     * Set a configuration value
+     */
+    set(key: string, value: unknown): void;
+    /**
+     * Check if a key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get configuration as a specific type
+     */
+    getOrThrow<T = unknown>(key: string): T;
+}
+//# sourceMappingURL=config.service.d.ts.map

package/dist/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../src/config.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,iBAAiB,CAAC;AAMxE,qBACa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,OAAO,CAA2B;IACjD,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,QAAQ,CAAS;;IAMzB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIrD;;OAEG;IACH,OAAO,CAAC,IAAI;IAgCZ;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAC5C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC;IAMjD;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;CASxC"}

package/dist/config.service.js

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var ConfigService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = void 0;
+const core_1 = require("@hazeljs/core");
+const dotenv = __importStar(require("dotenv"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const core_2 = __importDefault(require("@hazeljs/core"));
+let ConfigService = ConfigService_1 = class ConfigService {
+    constructor() {
+        this.config = {};
+        this.isLoaded = false;
+        this.load();
+    }
+    /**
+     * Set module options (called by ConfigModule.forRoot)
+     */
+    static setOptions(options) {
+        ConfigService_1.options = options;
+    }
+    /**
+     * Load configuration
+     */
+    load() {
+        if (this.isLoaded)
+            return;
+        const options = ConfigService_1.options;
+        // Load from .env files
+        if (!options.ignoreEnvFile) {
+            this.loadEnvFiles(options.envFilePath);
+        }
+        // Load from environment variables
+        if (!options.ignoreEnvVars) {
+            this.config = { ...this.config, ...process.env };
+        }
+        // Load custom configurations
+        if (options.load) {
+            options.load.forEach((loader) => {
+                const customConfig = loader();
+                this.config = { ...this.config, ...customConfig };
+            });
+        }
+        // Validate configuration
+        if (options.validationSchema) {
+            this.validate(options.validationSchema, options.validationOptions);
+        }
+        this.isLoaded = true;
+        core_2.default.info('Configuration loaded successfully');
+    }
+    /**
+     * Load environment files
+     */
+    loadEnvFiles(envFilePath) {
+        const paths = Array.isArray(envFilePath) ? envFilePath : envFilePath ? [envFilePath] : ['.env'];
+        for (const filePath of paths) {
+            const fullPath = path.resolve(process.cwd(), filePath);
+            if (fs.existsSync(fullPath)) {
+                core_2.default.debug(`Loading environment file: ${fullPath}`);
+                const result = dotenv.config({ path: fullPath });
+                if (result.parsed) {
+                    this.config = { ...this.config, ...result.parsed };
+                }
+                if (result.error) {
+                    core_2.default.warn(`Error loading ${fullPath}:`, result.error);
+                }
+            }
+            else {
+                core_2.default.debug(`Environment file not found: ${fullPath}`);
+            }
+        }
+    }
+    /**
+     * Validate configuration against schema
+     */
+    validate(schema, options) {
+        const result = schema.validate(this.config);
+        if (result.error) {
+            const message = `Configuration validation error: ${result.error.message}`;
+            core_2.default.error(message);
+            if (!options?.abortEarly) {
+                throw new Error(message);
+            }
+        }
+        this.config = result.value;
+    }
+    get(key, defaultValue) {
+        const value = this.getNestedValue(key);
+        return value !== undefined ? value : defaultValue;
+    }
+    /**
+     * Get nested value using dot notation
+     */
+    getNestedValue(key) {
+        const keys = key.split('.');
+        let value = this.config;
+        for (const k of keys) {
+            if (value && typeof value === 'object' && value !== null && k in value) {
+                value = value[k];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return value;
+    }
+    /**
+     * Get all configuration
+     */
+    getAll() {
+        return { ...this.config };
+    }
+    /**
+     * Set a configuration value
+     */
+    set(key, value) {
+        this.config[key] = value;
+    }
+    /**
+     * Check if a key exists
+     */
+    has(key) {
+        return this.getNestedValue(key) !== undefined;
+    }
+    /**
+     * Get configuration as a specific type
+     */
+    getOrThrow(key) {
+        const value = this.get(key);
+        if (value === undefined) {
+            throw new Error(`Configuration key "${key}" is required but not found`);
+        }
+        return value;
+    }
+};
+exports.ConfigService = ConfigService;
+ConfigService.options = {};
+exports.ConfigService = ConfigService = ConfigService_1 = __decorate([
+    (0, core_1.Service)(),
+    __metadata("design:paramtypes", [])
+], ConfigService);

package/dist/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}

package/dist/config.test.js

@@ -0,0 +1,287 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/// <reference types="jest" />
+const fs = __importStar(require("fs"));
+const dotenv = __importStar(require("dotenv"));
+const config_service_1 = require("./config.service");
+const config_module_1 = require("./config.module");
+jest.mock('fs');
+jest.mock('dotenv');
+// Use __esModule: true so default import (`import logger from`) resolves correctly
+jest.mock('@hazeljs/core', () => ({
+    __esModule: true,
+    Service: () => () => undefined,
+    HazelModule: () => () => undefined,
+    logger: { info: jest.fn(), debug: jest.fn(), warn: jest.fn(), error: jest.fn() },
+    default: { info: jest.fn(), debug: jest.fn(), warn: jest.fn(), error: jest.fn() },
+}));
+const mockedFs = fs;
+const mockedDotenv = dotenv;
+describe('ConfigService', () => {
+    beforeEach(() => {
+        // Reset static options between tests
+        config_service_1.ConfigService.setOptions({});
+        // Clear mock call history
+        jest.clearAllMocks();
+        // Default: fs.existsSync returns false (no .env files)
+        mockedFs.existsSync.mockReturnValue(false);
+        // Default: dotenv.config returns empty parsed
+        mockedDotenv.config.mockReturnValue({ parsed: {} });
+    });
+    describe('get()', () => {
+        it('returns undefined for missing key', () => {
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('MISSING_KEY_HAZEL_TEST')).toBeUndefined();
+        });
+        it('returns default value for missing key', () => {
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('MISSING_KEY_HAZEL_TEST', 'default')).toBe('default');
+        });
+        it('returns value for existing env var', () => {
+            process.env.__HAZEL_TEST_VAR__ = 'hello';
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('__HAZEL_TEST_VAR__')).toBe('hello');
+            delete process.env.__HAZEL_TEST_VAR__;
+        });
+    });
+    describe('set()', () => {
+        it('sets a configuration value', () => {
+            const svc = new config_service_1.ConfigService();
+            svc.set('myKey', 'myValue');
+            expect(svc.get('myKey')).toBe('myValue');
+        });
+        it('overwrites existing value', () => {
+            const svc = new config_service_1.ConfigService();
+            svc.set('myKey', 'first');
+            svc.set('myKey', 'second');
+            expect(svc.get('myKey')).toBe('second');
+        });
+    });
+    describe('has()', () => {
+        it('returns false for missing key', () => {
+            const svc = new config_service_1.ConfigService();
+            expect(svc.has('NO_SUCH_KEY_XYZ')).toBe(false);
+        });
+        it('returns true for existing key', () => {
+            const svc = new config_service_1.ConfigService();
+            svc.set('existingKey', 'val');
+            expect(svc.has('existingKey')).toBe(true);
+        });
+    });
+    describe('getAll()', () => {
+        it('returns all configuration values', () => {
+            const svc = new config_service_1.ConfigService();
+            svc.set('k1', 'v1');
+            svc.set('k2', 'v2');
+            const all = svc.getAll();
+            expect(all.k1).toBe('v1');
+            expect(all.k2).toBe('v2');
+        });
+        it('returns a copy, not a reference', () => {
+            const svc = new config_service_1.ConfigService();
+            svc.set('k', 'v');
+            const all = svc.getAll();
+            all.k = 'mutated';
+            expect(svc.get('k')).toBe('v');
+        });
+    });
+    describe('getOrThrow()', () => {
+        it('returns value when key exists', () => {
+            const svc = new config_service_1.ConfigService();
+            svc.set('req', 'present');
+            expect(svc.getOrThrow('req')).toBe('present');
+        });
+        it('throws when key is missing', () => {
+            const svc = new config_service_1.ConfigService();
+            expect(() => svc.getOrThrow('DEFINITELY_NOT_SET_HAZEL')).toThrow('Configuration key "DEFINITELY_NOT_SET_HAZEL" is required but not found');
+        });
+    });
+    describe('dot-notation nested keys', () => {
+        it('resolves nested config via dot notation', () => {
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                ignoreEnvFile: true,
+                load: [() => ({ database: { host: 'localhost', port: 5432 } })],
+            });
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('database.host')).toBe('localhost');
+            expect(svc.get('database.port')).toBe(5432);
+        });
+        it('returns undefined for missing nested key', () => {
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                ignoreEnvFile: true,
+                load: [() => ({ database: { host: 'localhost' } })],
+            });
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('database.missing')).toBeUndefined();
+        });
+        it('returns undefined when parent key does not exist', () => {
+            config_service_1.ConfigService.setOptions({ ignoreEnvVars: true, ignoreEnvFile: true });
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('no.such.path')).toBeUndefined();
+        });
+    });
+    describe('custom loaders', () => {
+        it('merges custom loader config', () => {
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                ignoreEnvFile: true,
+                load: [() => ({ APP_NAME: 'hazel' }), () => ({ APP_VERSION: '1.0.0' })],
+            });
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('APP_NAME')).toBe('hazel');
+            expect(svc.get('APP_VERSION')).toBe('1.0.0');
+        });
+    });
+    describe('ignoreEnvVars', () => {
+        it('skips loading process.env when ignoreEnvVars is true', () => {
+            process.env.__HAZEL_IGNORE_TEST__ = 'should-not-appear';
+            config_service_1.ConfigService.setOptions({ ignoreEnvVars: true, ignoreEnvFile: true });
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('__HAZEL_IGNORE_TEST__')).toBeUndefined();
+            delete process.env.__HAZEL_IGNORE_TEST__;
+        });
+    });
+    describe('ignoreEnvFile', () => {
+        it('skips .env loading when ignoreEnvFile is true', () => {
+            config_service_1.ConfigService.setOptions({ ignoreEnvFile: true });
+            new config_service_1.ConfigService();
+            expect(mockedFs.existsSync).not.toHaveBeenCalled();
+        });
+    });
+    describe('.env file loading', () => {
+        it('loads values from an existing .env file', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedDotenv.config.mockReturnValue({ parsed: { FROM_ENV_FILE: 'env-value' } });
+            config_service_1.ConfigService.setOptions({ ignoreEnvVars: true, envFilePath: '/custom/.env' });
+            const svc = new config_service_1.ConfigService();
+            expect(mockedDotenv.config).toHaveBeenCalled();
+            expect(svc.get('FROM_ENV_FILE')).toBe('env-value');
+        });
+        it('handles multiple env file paths', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedDotenv.config
+                .mockReturnValueOnce({ parsed: { KEY_A: 'a' } })
+                .mockReturnValueOnce({ parsed: { KEY_B: 'b' } });
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                envFilePath: ['/path/one.env', '/path/two.env'],
+            });
+            const svc = new config_service_1.ConfigService();
+            expect(mockedDotenv.config).toHaveBeenCalledTimes(2);
+            expect(svc.get('KEY_A')).toBe('a');
+            expect(svc.get('KEY_B')).toBe('b');
+        });
+        it('handles dotenv parse errors gracefully', () => {
+            mockedFs.existsSync.mockReturnValue(true);
+            mockedDotenv.config.mockReturnValue({ error: new Error('parse error') });
+            // Should not throw
+            config_service_1.ConfigService.setOptions({ ignoreEnvVars: true, envFilePath: '/bad.env' });
+            expect(() => new config_service_1.ConfigService()).not.toThrow();
+        });
+        it('skips non-existent env files gracefully', () => {
+            mockedFs.existsSync.mockReturnValue(false);
+            config_service_1.ConfigService.setOptions({ ignoreEnvVars: true, envFilePath: '/missing.env' });
+            expect(() => new config_service_1.ConfigService()).not.toThrow();
+            expect(mockedDotenv.config).not.toHaveBeenCalled();
+        });
+    });
+    describe('validation schema', () => {
+        it('uses validated config value when validation passes', () => {
+            const schema = {
+                validate: (config) => ({
+                    value: { ...config, EXTRA_KEY: 'added-by-schema' },
+                }),
+            };
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                ignoreEnvFile: true,
+                validationSchema: schema,
+            });
+            const svc = new config_service_1.ConfigService();
+            expect(svc.get('EXTRA_KEY')).toBe('added-by-schema');
+        });
+        it('throws when validation fails and abortEarly is not set', () => {
+            const schema = {
+                validate: () => ({
+                    error: new Error('validation failed'),
+                    value: {},
+                }),
+            };
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                ignoreEnvFile: true,
+                validationSchema: schema,
+            });
+            expect(() => new config_service_1.ConfigService()).toThrow('Configuration validation error: validation failed');
+        });
+        it('does not throw when validation fails and abortEarly is true', () => {
+            const schema = {
+                validate: () => ({
+                    error: new Error('validation failed'),
+                    value: {},
+                }),
+            };
+            config_service_1.ConfigService.setOptions({
+                ignoreEnvVars: true,
+                ignoreEnvFile: true,
+                validationSchema: schema,
+                validationOptions: { abortEarly: true },
+            });
+            expect(() => new config_service_1.ConfigService()).not.toThrow();
+        });
+    });
+});
+describe('ConfigModule', () => {
+    beforeEach(() => {
+        config_service_1.ConfigService.setOptions({});
+    });
+    it('forRoot returns ConfigModule', () => {
+        const result = config_module_1.ConfigModule.forRoot();
+        expect(result).toBe(config_module_1.ConfigModule);
+    });
+    it('forRoot sets options on ConfigService', () => {
+        config_module_1.ConfigModule.forRoot({ ignoreEnvFile: true, ignoreEnvVars: true });
+        // If options were set, a new ConfigService should not try loading env files
+        mockedFs.existsSync.mockReturnValue(false);
+        expect(() => new config_service_1.ConfigService()).not.toThrow();
+    });
+    it('forRoot without options returns ConfigModule', () => {
+        const result = config_module_1.ConfigModule.forRoot();
+        expect(result).toBe(config_module_1.ConfigModule);
+    });
+});

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @hazeljs/config - Configuration module for HazelJS
+ */
+export { ConfigModule, type ConfigModuleOptions, type ValidationSchema as ConfigValidationSchema, } from './config.module';
+export { ConfigService } from './config.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,IAAI,sBAAsB,GAChD,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @hazeljs/config - Configuration module for HazelJS
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = exports.ConfigModule = void 0;
+var config_module_1 = require("./config.module");
+Object.defineProperty(exports, "ConfigModule", { enumerable: true, get: function () { return config_module_1.ConfigModule; } });
+var config_service_1 = require("./config.service");
+Object.defineProperty(exports, "ConfigService", { enumerable: true, get: function () { return config_service_1.ConfigService; } });