@alacard-project/config-sdk 1.1.0 → 1.1.2

package/dist/clients/config.client.d.ts

@@ -1,8 +1,6 @@
 import { ConfigOptions } from '../types/config.types';
 export declare class ConfigClient {
-    private readonly logger;
     private configMap;
-    private consumer;
     private options;
     private vaultClient;
     private breaker;
@@ -16,7 +14,6 @@ export declare class ConfigClient {
     private loadVaultSecrets;
     private initCircuitBreaker;
     private fetchRemoteConfig;
-    private startWatching;
     get<T = string>(key: string, defaultValue?: T): T;
     getInt(key: string, defaultValue?: number): number;
     getBool(key: string, defaultValue?: boolean): boolean;

package/dist/clients/config.client.js

@@ -38,17 +38,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigClient = void 0;
 const grpc = __importStar(require("@grpc/grpc-js"));
-const kafkajs_1 = require("kafkajs");
 const path = __importStar(require("path"));
 const dotenv = __importStar(require("dotenv"));
 const opossum_1 = __importDefault(require("opossum"));
-const common_1 = require("@nestjs/common");
 const config_1 = require("../generated/config");
 const vault_client_1 = require("./vault.client");
 class ConfigClient {
-    logger = new common_1.Logger('ConfigSDK');
     configMap = {};
-    consumer = null;
     options;
     vaultClient = null;
     breaker = null;
@@ -86,15 +82,11 @@ class ConfigClient {
             }
             // 4. Fetch Remote Config via gRPC (with Circuit Breaker)
             await this.fetchRemoteConfig(serviceName, environment, grpcUrl, version);
-            // 5. Start Kafka Watcher (if configured)
-            if (this.options.kafkaBrokers && this.options.kafkaBrokers.length > 0) {
-                await this.startWatching();
-            }
-            this.logger.log(`Configuration initialized with ${Object.keys(this.configMap).length} keys`);
+            console.log(`[ConfigSDK] Configuration initialized with ${Object.keys(this.configMap).length} keys`);
         }
         catch (error) {
             const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.error(`Critical initialization failure: ${errorMsg}. Service starting with loaded config.`);
+            console.error(`[ConfigSDK] Critical initialization failure: ${errorMsg}. Service starting with loaded config.`);
         }
     }
     loadProcessEnv() {
@@ -106,19 +98,17 @@ class ConfigClient {
         }
     }
     loadDotEnv(environment) {
-        // Only support standard .env and environment-specific .env
         const envFiles = [`.env.${environment}`, '.env'];
         for (const file of envFiles) {
             const filePath = path.resolve(process.cwd(), file);
             const result = dotenv.config({ path: filePath });
             if (result.parsed) {
-                // Do not overwrite existing keys (process.env wins)
                 for (const [key, value] of Object.entries(result.parsed)) {
                     if (!this.configMap[key]) {
                         this.configMap[key] = value;
                     }
                 }
-                this.logger.log(`Loaded variables from ${file}`);
+                console.log(`[ConfigSDK] Loaded variables from ${file}`);
             }
         }
     }
@@ -128,19 +118,16 @@ class ConfigClient {
         this.vaultClient = new vault_client_1.VaultClient(this.options.vault);
         try {
             const vaultSecrets = await this.vaultClient.getKVSecrets(`config-service/${serviceName}`);
-            // Vault secrets should overwrite env vars if needed, or fill gaps. 
-            // Usually Vault > Env, but here we treat Env > Vault for local overrides. 
-            // Let's adopt a safe merge: Existing keys (from Env) take precedence.
             for (const [key, value] of Object.entries(vaultSecrets)) {
                 if (!this.configMap[key]) {
                     this.configMap[key] = value;
                 }
             }
-            this.logger.log(`Loaded secrets from Vault for ${serviceName}`);
+            console.log(`[ConfigSDK] Loaded secrets from Vault for ${serviceName}`);
         }
         catch (error) {
             const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.warn(`Vault secrets unavailable: ${errorMsg}. Continuing with local config.`);
+            console.warn(`[ConfigSDK] Vault secrets unavailable: ${errorMsg}. Continuing with local config.`);
         }
     }
     initCircuitBreaker(client) {
@@ -154,13 +141,10 @@ class ConfigClient {
             });
         };
         this.breaker = new opossum_1.default(fetchFunction, {
-            timeout: 5000, // 5s timeout
-            errorThresholdPercentage: 50, // 50% errors opens the breaker
-            resetTimeout: 10000, // wait 10s before trying again
+            timeout: 5000,
+            errorThresholdPercentage: 50,
+            resetTimeout: 10000,
         });
-        this.breaker.on('open', () => this.logger.warn('Circuit Breaker (Config gRPC) is OPEN'));
-        this.breaker.on('halfOpen', () => this.logger.log('Circuit Breaker (Config gRPC) is HALF_OPEN'));
-        this.breaker.on('close', () => this.logger.log('Circuit Breaker (Config gRPC) is CLOSED'));
     }
     async fetchRemoteConfig(serviceName, environment, grpcUrl, version) {
         let credentials = grpc.credentials.createInsecure();
@@ -179,59 +163,17 @@ class ConfigClient {
         try {
             const values = await this.breaker.fire(request, metadata);
             if (values) {
-                // Remote config fills in the gaps
                 for (const [key, value] of Object.entries(values)) {
                     if (!this.configMap[key]) {
                         this.configMap[key] = value;
                     }
                 }
-                this.logger.log(`Remote config loaded from config-service`);
+                console.log(`[ConfigSDK] Remote config loaded via gRPC`);
             }
         }
         catch (error) {
             const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.warn(`Remote config (gRPC) failure: ${errorMsg}. Using local/vault fallback.`);
-        }
-    }
-    async startWatching() {
-        if (this.consumer)
-            return;
-        try {
-            const kafka = new kafkajs_1.Kafka({
-                clientId: `config-sdk-${this.options.serviceName}`,
-                brokers: this.options.kafkaBrokers,
-                retry: {
-                    retries: 5, // Retry up to 5 times
-                    maxRetryTime: 30000 // Max time spent retrying
-                }
-            });
-            const groupId = `config-watch-${this.options.serviceName}-${this.options.environment}`;
-            this.consumer = kafka.consumer({ groupId });
-            await this.consumer.connect();
-            await this.consumer.subscribe({ topic: 'config.updated', fromBeginning: false });
-            await this.consumer.run({
-                eachMessage: async ({ message }) => {
-                    if (!message.value)
-                        return;
-                    try {
-                        const event = JSON.parse(message.value.toString());
-                        if (event.service === 'global' || event.service === this.options.serviceName) {
-                            if (event.environment === this.options.environment) {
-                                this.logger.log(`Hot-reload: ${event.key} updated`);
-                                this.configMap[event.key] = event.value;
-                            }
-                        }
-                    }
-                    catch (err) {
-                        const errorMsg = err instanceof Error ? err.message : String(err);
-                        this.logger.error(`Failed to parse config update: ${errorMsg}`);
-                    }
-                },
-            });
-        }
-        catch (error) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.warn(`Config watch mode (Kafka) failed: ${errorMsg}`);
+            console.warn(`[ConfigSDK] Remote config (gRPC) failure: ${errorMsg}. Using local/vault fallback.`);
         }
     }
     get(key, defaultValue) {
@@ -240,8 +182,7 @@ class ConfigClient {
             if (defaultValue !== undefined) {
                 return defaultValue;
             }
-            // Strict mode: warn if key is missing and no default value
-            this.logger.warn(`Configuration key '${key}' not found and no default value provided.`);
+            console.warn(`[ConfigSDK] Configuration key '${key}' not found and no default value provided.`);
             return undefined;
         }
         return val;

package/dist/{modules/config.module.d.ts → config.module.d.ts}

@@ -1,5 +1,5 @@
 import { DynamicModule } from '@nestjs/common';
-import { ConfigOptions } from '../types/config.types';
+import { ConfigOptions } from './types/config.types';
 export declare class ConfigModule {
     static forRoot(options: ConfigOptions): DynamicModule;
 }

package/dist/{modules/config.module.js → config.module.js}

@@ -36,8 +36,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigModule = void 0;
 const common_1 = require("@nestjs/common");
-const config_client_1 = require("../clients/config.client");
-const constants_1 = require("../constants");
+const config_client_1 = require("./clients/config.client");
 let ConfigModule = (() => {
     let _classDecorators = [(0, common_1.Global)(), (0, common_1.Module)({})];
     let _classDescriptor;
@@ -53,20 +52,19 @@ let ConfigModule = (() => {
             __runInitializers(_classThis, _classExtraInitializers);
         }
         static forRoot(options) {
-            const optionsProvider = {
-                provide: constants_1.CONFIG_OPTIONS,
-                useValue: options,
-            };
-            const configClientProvider = {
-                provide: config_client_1.ConfigClient,
-                useFactory: async () => {
-                    return await config_client_1.ConfigClient.initialize(options);
-                },
-            };
             return {
                 module: ConfigModule,
-                providers: [optionsProvider, configClientProvider],
-                exports: [configClientProvider, optionsProvider],
+                providers: [
+                    {
+                        provide: 'CONFIG_OPTIONS',
+                        useValue: options,
+                    },
+                    {
+                        provide: config_client_1.ConfigClient,
+                        useFactory: async () => await config_client_1.ConfigClient.initialize(options),
+                    },
+                ],
+                exports: [config_client_1.ConfigClient],
             };
         }
     };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export * from './clients/config.client';
 export * from './clients/vault.client';
-export * from './modules/config.module';
-export * from './utils/nest-helpers';
+export * from './utils/config.helpers';
 export * from './constants';
 export * from './enums/env.enum';
 export * from './types/config.types';
 export * from './types/grpc.types';
+export { ConfigServiceClient } from './generated/config';
+export * from './config.module';

package/dist/index.js

@@ -14,11 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigServiceClient = void 0;
 __exportStar(require("./clients/config.client"), exports);
 __exportStar(require("./clients/vault.client"), exports);
-__exportStar(require("./modules/config.module"), exports);
-__exportStar(require("./utils/nest-helpers"), exports);
+__exportStar(require("./utils/config.helpers"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./enums/env.enum"), exports);
 __exportStar(require("./types/config.types"), exports);
 __exportStar(require("./types/grpc.types"), exports);
+var config_1 = require("./generated/config");
+Object.defineProperty(exports, "ConfigServiceClient", { enumerable: true, get: function () { return config_1.ConfigServiceClient; } });
+__exportStar(require("./config.module"), exports);

package/dist/utils/{nest-helpers.d.ts → config.helpers.d.ts}

@@ -1,7 +1,7 @@
 import { Environment } from '../enums/env.enum';
 export declare abstract class BaseConfigService {
     constructor();
-    protected get<T = string>(key: string, defaultValue?: T): T;
+    get<T = string>(key: string, defaultValue?: T): T;
     getRequiredString(key: string): string;
     getRequiredNumber(key: string): number;
     getOptionalString(key: string, defaultValue: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@alacard-project/config-sdk",
-    "version": "1.1.0",
+    "version": "1.1.2",
     "engines": {
         "node": ">=24.0.0"
     },
@@ -11,6 +11,10 @@
     "exports": {
         ".": "./dist/index.js"
     },
+    "files": [
+        "dist",
+        "README.md"
+    ],
     "scripts": {
         "build": "tsc",
         "lint": "eslint \"src/**/*.ts\" --fix",
@@ -20,27 +24,27 @@
         "prepublishOnly": "npm run build"
     },
     "dependencies": {
-        "@bufbuild/protobuf": "^2.2.3",
-        "@grpc/grpc-js": "^1.12.5",
-        "@grpc/proto-loader": "^0.7.13",
-        "axios": "^1.7.9",
-        "dotenv": "^16.4.7",
-        "kafkajs": "^2.2.4",
-        "opossum": "^9.0.0"
+        "@bufbuild/protobuf": "2.2.3"
+    },
+    "peerDependencies": {
+        "@grpc/grpc-js": "^1.11.0",
+        "@grpc/proto-loader": "^0.7.0",
+        "axios": "^1.7.0",
+        "dotenv": "^16.0.0 || ^17.0.0",
+        "opossum": "^8.0.0 || ^9.0.0"
     },
     "devDependencies": {
-        "@eslint/js": "^9.39.2",
-        "@nestjs/common": "^11.1.12",
-        "@types/jest": "^29.5.14",
-        "@types/node": "^22.10.7",
-        "@types/opossum": "^8.1.9",
-        "eslint": "^9.39.2",
-        "globals": "^15.15.0",
-        "jest": "^29.7.0",
-        "ts-jest": "^29.2.5",
-        "ts-proto": "^2.6.1",
-        "typescript": "^5.7.3",
-        "typescript-eslint": "^8.54.0"
+        "@eslint/js": "9.18.0",
+        "@types/jest": "29.5.14",
+        "@types/node": "22.10.10",
+        "@types/opossum": "8.1.9",
+        "eslint": "9.18.0",
+        "globals": "17.3.0",
+        "jest": "29.7.0",
+        "ts-jest": "29.2.6",
+        "ts-proto": "2.6.1",
+        "typescript": "5.7.3",
+        "typescript-eslint": "8.20.0"
     },
     "jest": {
         "moduleFileExtensions": [
@@ -59,4 +63,4 @@
         "coverageDirectory": "./coverage",
         "testEnvironment": "node"
     }
-}
+}

package/eslint.config.mjs

@@ -1,29 +0,0 @@
-import js from "@eslint/js";
-import globals from "globals";
-import tsParser from "@typescript-eslint/parser";
-import tsPlugin from "@typescript-eslint/eslint-plugin";
-
-export default [
-    js.configs.recommended,
-    {
-        ignores: ["src/generated/**/*"],
-    },
-    {
-        files: ["src/**/*.ts"],
-        languageOptions: {
-            parser: tsParser,
-            globals: {
-                ...globals.node,
-                ...globals.jest,
-            },
-        },
-        plugins: {
-            "@typescript-eslint": tsPlugin,
-        },
-        rules: {
-            "no-console": "error",
-            "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_", varsIgnorePattern: "^_" }],
-            "@typescript-eslint/no-explicit-any": "warn",
-        },
-    },
-];

package/proto/config.proto

@@ -1,39 +0,0 @@
-syntax = "proto3";
-
-package config;
-
-service ConfigService {
-  rpc GetConfig (GetConfigRequest) returns (ConfigResponse);
-  rpc SetConfig (SetConfigRequest) returns (ConfigResponse);
-  rpc ListConfigs (ListConfigsRequest) returns (ListConfigsResponse);
-}
-
-message GetConfigRequest {
-  string serviceName = 1;
-  string environment = 2;
-  string version = 3;
-}
-
-message ConfigResponse {
-  map<string, string> values = 1;
-}
-
-message SetConfigRequest {
-  string serviceName = 1;
-  string environment = 2;
-  string key = 3;
-  string value = 4;
-}
-
-message ListConfigsRequest {
-  string environment = 1;
-}
-
-message ServiceConfig {
-  string serviceName = 1;
-  map<string, string> values = 2;
-}
-
-message ListConfigsResponse {
-  repeated ServiceConfig configs = 1;
-}

package/src/clients/config.client.ts

@@ -1,252 +0,0 @@
-import * as grpc from '@grpc/grpc-js';
-import { Kafka, Consumer, EachMessagePayload } from 'kafkajs';
-import * as path from 'path';
-import * as dotenv from 'dotenv';
-import CircuitBreaker from 'opossum';
-import { Logger } from '@nestjs/common';
-import { ConfigServiceClient } from '../generated/config';
-import { GetConfigRequest } from '../types/grpc.types';
-import { VaultClient } from './vault.client';
-import { ConfigOptions, ConfigUpdatedEvent } from '../types/config.types';
-
-export class ConfigClient {
-    private readonly logger: Logger = new Logger('ConfigSDK');
-    private configMap: Record<string, string> = {};
-    private consumer: Consumer | null = null;
-    private options: ConfigOptions;
-    private vaultClient: VaultClient | null = null;
-    private breaker: CircuitBreaker | null = null;
-    private static instance: ConfigClient | null = null;
-
-    private constructor(options: ConfigOptions) {
-        this.options = options;
-    }
-
-    public static async initialize(options: ConfigOptions): Promise<ConfigClient> {
-        if (this.instance) {
-            return this.instance;
-        }
-        const client = new ConfigClient(options);
-        await client.init();
-        this.instance = client;
-        return client;
-    }
-
-    public static getInstance(): ConfigClient {
-        if (!this.instance) {
-            throw new Error('[ConfigSDK] ConfigClient not initialized. Call initialize() first.');
-        }
-        return this.instance;
-    }
-
-    private async init(): Promise<void> {
-        const { serviceName, environment, grpcUrl, version = 'v1', useDotenvFallback = true } = this.options;
-
-        try {
-            // 1. Load from Process Env (Highest Priority for overrides)
-            this.loadProcessEnv();
-
-            // 2. Load from DotEnv (if enabled)
-            if (useDotenvFallback) {
-                this.loadDotEnv(environment);
-            }
-
-            // 3. Load from Vault (if configured)
-            if (this.options.vault) {
-                await this.loadVaultSecrets(serviceName);
-            }
-
-            // 4. Fetch Remote Config via gRPC (with Circuit Breaker)
-            await this.fetchRemoteConfig(serviceName, environment, grpcUrl, version);
-
-            // 5. Start Kafka Watcher (if configured)
-            if (this.options.kafkaBrokers && this.options.kafkaBrokers.length > 0) {
-                await this.startWatching();
-            }
-
-            this.logger.log(`Configuration initialized with ${Object.keys(this.configMap).length} keys`);
-        } catch (error: unknown) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.error(`Critical initialization failure: ${errorMsg}. Service starting with loaded config.`);
-        }
-    }
-
-    private loadProcessEnv(): void {
-        const ALLOWED_ENV_PREFIXES = ['APP_', 'KAFKA_', 'DB_', 'REDIS_', 'GRPC_', 'PORT', 'NODE_ENV', 'DATABASE_URL'];
-        for (const [key, value] of Object.entries(process.env)) {
-            if (value && ALLOWED_ENV_PREFIXES.some(prefix => key.startsWith(prefix))) {
-                this.configMap[key] = value;
-            }
-        }
-    }
-
-    private loadDotEnv(environment: string): void {
-        // Only support standard .env and environment-specific .env
-        const envFiles = [`.env.${environment}`, '.env'];
-        for (const file of envFiles) {
-            const filePath = path.resolve(process.cwd(), file);
-            const result = dotenv.config({ path: filePath });
-            if (result.parsed) {
-                // Do not overwrite existing keys (process.env wins)
-                for (const [key, value] of Object.entries(result.parsed)) {
-                    if (!this.configMap[key]) {
-                        this.configMap[key] = value;
-                    }
-                }
-                this.logger.log(`Loaded variables from ${file}`);
-            }
-        }
-    }
-
-    private async loadVaultSecrets(serviceName: string): Promise<void> {
-        if (!this.options.vault) return;
-
-        this.vaultClient = new VaultClient(this.options.vault);
-        try {
-            const vaultSecrets = await this.vaultClient.getKVSecrets(`config-service/${serviceName}`);
-            // Vault secrets should overwrite env vars if needed, or fill gaps. 
-            // Usually Vault > Env, but here we treat Env > Vault for local overrides. 
-            // Let's adopt a safe merge: Existing keys (from Env) take precedence.
-            for (const [key, value] of Object.entries(vaultSecrets)) {
-                if (!this.configMap[key]) {
-                    this.configMap[key] = value as string;
-                }
-            }
-            this.logger.log(`Loaded secrets from Vault for ${serviceName}`);
-        } catch (error: unknown) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.warn(`Vault secrets unavailable: ${errorMsg}. Continuing with local config.`);
-        }
-    }
-
-    private initCircuitBreaker(client: ConfigServiceClient): void {
-        const fetchFunction = (request: GetConfigRequest, metadata: grpc.Metadata) => {
-            return new Promise<Record<string, string>>((resolve, reject) => {
-                client.getConfig(request, metadata, (error, response) => {
-                    if (error) return reject(error);
-                    resolve(response.values || {});
-                });
-            });
-        };
-
-        this.breaker = new CircuitBreaker(fetchFunction, {
-            timeout: 5000, // 5s timeout
-            errorThresholdPercentage: 50, // 50% errors opens the breaker
-            resetTimeout: 10000, // wait 10s before trying again
-        });
-
-        this.breaker.on('open', () => this.logger.warn('Circuit Breaker (Config gRPC) is OPEN'));
-        this.breaker.on('halfOpen', () => this.logger.log('Circuit Breaker (Config gRPC) is HALF_OPEN'));
-        this.breaker.on('close', () => this.logger.log('Circuit Breaker (Config gRPC) is CLOSED'));
-    }
-
-    private async fetchRemoteConfig(serviceName: string, environment: string, grpcUrl: string, version: string): Promise<void> {
-        let credentials = grpc.credentials.createInsecure();
-        if (this.options.tls) {
-            credentials = grpc.credentials.createSsl(
-                this.options.tls.rootCert,
-                this.options.tls.clientKey,
-                this.options.tls.clientCert,
-            );
-        }
-
-        const client = new ConfigServiceClient(grpcUrl, credentials);
-
-        if (!this.breaker) {
-            this.initCircuitBreaker(client);
-        }
-
-        const request: GetConfigRequest = { serviceName, environment, version };
-        const metadata = new grpc.Metadata();
-        if (this.options.internalKey) {
-            metadata.set('x-internal-key', this.options.internalKey);
-        }
-
-        try {
-            const values = await this.breaker!.fire(request, metadata);
-            if (values) {
-                // Remote config fills in the gaps
-                for (const [key, value] of Object.entries(values)) {
-                    if (!this.configMap[key]) {
-                        this.configMap[key] = value as string;
-                    }
-                }
-                this.logger.log(`Remote config loaded from config-service`);
-            }
-        } catch (error: unknown) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.warn(`Remote config (gRPC) failure: ${errorMsg}. Using local/vault fallback.`);
-        }
-    }
-
-    private async startWatching(): Promise<void> {
-        if (this.consumer) return;
-        try {
-            const kafka = new Kafka({
-                clientId: `config-sdk-${this.options.serviceName}`,
-                brokers: this.options.kafkaBrokers!,
-                retry: {
-                    retries: 5, // Retry up to 5 times
-                    maxRetryTime: 30000 // Max time spent retrying
-                }
-            });
-            const groupId = `config-watch-${this.options.serviceName}-${this.options.environment}`;
-            this.consumer = kafka.consumer({ groupId });
-            await this.consumer.connect();
-            await this.consumer.subscribe({ topic: 'config.updated', fromBeginning: false });
-
-            await this.consumer.run({
-                eachMessage: async ({ message }: EachMessagePayload) => {
-                    if (!message.value) return;
-                    try {
-                        const event: ConfigUpdatedEvent = JSON.parse(message.value.toString());
-                        if (event.service === 'global' || event.service === this.options.serviceName) {
-                            if (event.environment === this.options.environment) {
-                                this.logger.log(`Hot-reload: ${event.key} updated`);
-                                this.configMap[event.key] = event.value;
-                            }
-                        }
-                    } catch (err: unknown) {
-                        const errorMsg = err instanceof Error ? err.message : String(err);
-                        this.logger.error(`Failed to parse config update: ${errorMsg}`);
-                    }
-                },
-            });
-        } catch (error: unknown) {
-            const errorMsg = error instanceof Error ? error.message : String(error);
-            this.logger.warn(`Config watch mode (Kafka) failed: ${errorMsg}`);
-        }
-    }
-
-    public get<T = string>(key: string, defaultValue?: T): T {
-        const val = this.configMap[key];
-
-        if (val === undefined || val === null) {
-            if (defaultValue !== undefined) {
-                return defaultValue;
-            }
-            // Strict mode: warn if key is missing and no default value
-            this.logger.warn(`Configuration key '${key}' not found and no default value provided.`);
-            return undefined as unknown as T;
-        }
-
-        return val as unknown as T;
-    }
-
-    public getInt(key: string, defaultValue: number = 0): number {
-        const val = this.get<string>(key);
-        if (!val) return defaultValue;
-        const parsed = parseInt(val, 10);
-        return isNaN(parsed) ? defaultValue : parsed;
-    }
-
-    public getBool(key: string, defaultValue: boolean = false): boolean {
-        const val = this.get<string>(key);
-        if (!val) return defaultValue;
-        return val.toLowerCase() === 'true' || val === '1';
-    }
-
-    public getAll(): Record<string, string> {
-        return { ...this.configMap };
-    }
-}