@arikajs/config 0.0.5

package/dist/Repository.js

@@ -0,0 +1,418 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { createRequire } from 'module';
+const localRequire = createRequire(import.meta.url);
+// ─── Repository ─────────────────────────────────────────────────────────────
+export class Repository {
+    config = {};
+    booted = false;
+    // Feature 1: Config Caching
+    flatCache = new Map();
+    cacheBuilt = false;
+    // Feature 2: Schema Validation
+    schema = null;
+    // Feature 4: Change Listeners
+    listeners = new Map();
+    globalListeners = [];
+    // Feature 6: Encrypted Config
+    decrypter = null;
+    constructor(initialConfig = {}) {
+        this.config = { ...initialConfig };
+    }
+    // ─── Loading ────────────────────────────────────────────────────────────
+    /**
+     * Load configuration files from the config directory.
+     */
+    loadConfigDirectory(configPath, environment) {
+        if (this.booted) {
+            throw new Error('Configuration cannot be modified after boot.');
+        }
+        if (!fs.existsSync(configPath)) {
+            return;
+        }
+        const files = fs.readdirSync(configPath);
+        // Feature 3: Environment-based Merging
+        // First load base configs (e.g., database.js)
+        // Then overlay env-specific (e.g., database.production.js)
+        const env = environment || process.env.NODE_ENV || 'development';
+        const baseFiles = files.filter((file) => this.isConfigFile(file) && !this.isEnvSpecificFile(file));
+        const envFiles = files.filter((file) => this.isConfigFile(file) && file.includes(`.${env}.`));
+        // Load base configs first
+        for (const file of baseFiles) {
+            this.loadFile(configPath, file);
+        }
+        // Then overlay environment-specific configs
+        for (const file of envFiles) {
+            this.loadFile(configPath, file, true);
+        }
+    }
+    isConfigFile(file) {
+        return (file.endsWith('.js') ||
+            file.endsWith('.ts') ||
+            file.endsWith('.cjs') ||
+            file.endsWith('.mjs'));
+    }
+    isEnvSpecificFile(file) {
+        const envPatterns = [
+            '.development.',
+            '.production.',
+            '.staging.',
+            '.testing.',
+            '.local.',
+        ];
+        return envPatterns.some((p) => file.includes(p));
+    }
+    loadFile(configPath, file, isOverlay = false) {
+        const filePath = path.join(configPath, file);
+        // Extract base config name (e.g., "database" from "database.production.js")
+        const parts = path.basename(file, path.extname(file)).split('.');
+        const configName = parts[0];
+        try {
+            let configValue;
+            try {
+                const module = localRequire(filePath);
+                configValue = module.default || module;
+            }
+            catch {
+                // ESM fallback — silently skip
+            }
+            if (typeof configValue === 'object' && configValue !== null) {
+                if (isOverlay && this.config[configName]) {
+                    // Deep merge for env overlays
+                    this.config[configName] = this.deepMerge(this.config[configName], configValue);
+                }
+                else {
+                    this.config[configName] = {
+                        ...this.config[configName],
+                        ...configValue,
+                    };
+                }
+            }
+        }
+        catch {
+            // Silently skip files that can't be loaded
+        }
+    }
+    // ─── Get / Set / Has ────────────────────────────────────────────────────
+    /**
+     * Get a configuration value using dot notation.
+     * Uses flat cache for O(1) lookup when booted.
+     */
+    get(key, defaultValue) {
+        // Feature 1: Use flat cache after boot for O(1)
+        if (this.cacheBuilt) {
+            const cached = this.flatCache.get(key);
+            if (cached !== undefined) {
+                // Feature 6: Auto-decrypt encrypted values
+                if (typeof cached === 'string' && cached.startsWith('enc:')) {
+                    return this.decrypt(cached);
+                }
+                return cached;
+            }
+            return defaultValue;
+        }
+        // Pre-boot: walk the tree
+        const keys = key.split('.');
+        let value = this.config;
+        for (const k of keys) {
+            if (value === undefined || value === null) {
+                return defaultValue;
+            }
+            value = value[k];
+        }
+        const result = value !== undefined ? value : defaultValue;
+        // Feature 6: Auto-decrypt encrypted values
+        if (typeof result === 'string' && result.startsWith('enc:')) {
+            return this.decrypt(result);
+        }
+        return result;
+    }
+    /**
+     * Check if a configuration key exists.
+     */
+    has(key) {
+        if (this.cacheBuilt) {
+            return this.flatCache.has(key);
+        }
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Set a configuration value using dot notation.
+     */
+    set(key, value) {
+        if (this.booted) {
+            throw new Error('Configuration cannot be modified after boot.');
+        }
+        const oldValue = this.get(key);
+        const keys = key.split('.');
+        let current = this.config;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const k = keys[i];
+            if (!(k in current) ||
+                typeof current[k] !== 'object' ||
+                current[k] === null) {
+                current[k] = {};
+            }
+            current = current[k];
+        }
+        current[keys[keys.length - 1]] = value;
+        // Feature 4: Notify change listeners
+        this.notifyListeners(key, value, oldValue);
+    }
+    /**
+     * Get all configuration.
+     */
+    all() {
+        return { ...this.config };
+    }
+    // ─── Boot Lifecycle ─────────────────────────────────────────────────────
+    /**
+     * Mark the repository as booted (read-only).
+     * Builds the flat cache and deep-freezes the config for immutability.
+     */
+    markAsBooted() {
+        // Feature 2: Validate schema before boot
+        if (this.schema) {
+            const errors = this.validateSchema();
+            if (errors.length > 0) {
+                const messages = errors.map((e) => `  - ${e.key}: ${e.message}`).join('\n');
+                throw new Error(`Configuration validation failed:\n${messages}`);
+            }
+        }
+        // Feature 1: Build flat cache
+        this.buildFlatCache();
+        // Feature 5: Deep freeze
+        this.deepFreeze(this.config);
+        this.booted = true;
+    }
+    /**
+     * Check if the repository has been booted.
+     */
+    isBooted() {
+        return this.booted;
+    }
+    // ─── Feature 1: Config Caching ──────────────────────────────────────────
+    /**
+     * Build a flat Map of all dot-notation keys for O(1) lookups.
+     */
+    buildFlatCache(obj, prefix) {
+        const target = obj || this.config;
+        const pre = prefix ? `${prefix}.` : '';
+        for (const key of Object.keys(target)) {
+            const fullKey = `${pre}${key}`;
+            const value = target[key];
+            this.flatCache.set(fullKey, value);
+            if (typeof value === 'object' &&
+                value !== null &&
+                !Array.isArray(value)) {
+                this.buildFlatCache(value, fullKey);
+            }
+        }
+        if (!prefix) {
+            this.cacheBuilt = true;
+        }
+    }
+    // ─── Feature 2: Schema Validation ───────────────────────────────────────
+    /**
+     * Define a validation schema for the configuration.
+     */
+    defineSchema(schema) {
+        this.schema = schema;
+        return this;
+    }
+    /**
+     * Validate the current config against the defined schema.
+     */
+    validate() {
+        if (!this.schema)
+            return [];
+        return this.validateSchema();
+    }
+    validateSchema(schema, prefix) {
+        const errors = [];
+        const rules = schema || this.schema;
+        if (!rules)
+            return errors;
+        for (const [key, rule] of Object.entries(rules)) {
+            const fullKey = prefix ? `${prefix}.${key}` : key;
+            const value = this.get(fullKey);
+            // Handle nested schema via 'children'
+            if (rule.children) {
+                errors.push(...this.validateSchema(rule.children, fullKey));
+                continue;
+            }
+            const r = rule;
+            // Required check
+            if (r.required && (value === undefined || value === null)) {
+                errors.push({
+                    key: fullKey,
+                    message: r.message || `'${fullKey}' is required but not set.`,
+                });
+                continue;
+            }
+            // Skip further checks if value is undefined and not required
+            if (value === undefined || value === null)
+                continue;
+            // Type check
+            if (r.type) {
+                const actualType = Array.isArray(value) ? 'array' : typeof value;
+                if (actualType !== r.type) {
+                    errors.push({
+                        key: fullKey,
+                        message: r.message ||
+                            `'${fullKey}' must be of type '${r.type}', got '${actualType}'.`,
+                    });
+                }
+            }
+            // Enum check
+            if (r.enum && !r.enum.includes(value)) {
+                errors.push({
+                    key: fullKey,
+                    message: r.message ||
+                        `'${fullKey}' must be one of [${r.enum.join(', ')}], got '${value}'.`,
+                });
+            }
+            // Min/Max for numbers
+            if (r.type === 'number' && typeof value === 'number') {
+                if (r.min !== undefined && value < r.min) {
+                    errors.push({
+                        key: fullKey,
+                        message: r.message ||
+                            `'${fullKey}' must be >= ${r.min}, got ${value}.`,
+                    });
+                }
+                if (r.max !== undefined && value > r.max) {
+                    errors.push({
+                        key: fullKey,
+                        message: r.message ||
+                            `'${fullKey}' must be <= ${r.max}, got ${value}.`,
+                    });
+                }
+            }
+            // Min/Max for string length
+            if (r.type === 'string' && typeof value === 'string') {
+                if (r.min !== undefined && value.length < r.min) {
+                    errors.push({
+                        key: fullKey,
+                        message: r.message ||
+                            `'${fullKey}' must have at least ${r.min} characters.`,
+                    });
+                }
+                if (r.max !== undefined && value.length > r.max) {
+                    errors.push({
+                        key: fullKey,
+                        message: r.message ||
+                            `'${fullKey}' must have at most ${r.max} characters.`,
+                    });
+                }
+            }
+            // Pattern check
+            if (r.pattern && typeof value === 'string' && !r.pattern.test(value)) {
+                errors.push({
+                    key: fullKey,
+                    message: r.message ||
+                        `'${fullKey}' does not match the required pattern.`,
+                });
+            }
+        }
+        return errors;
+    }
+    // ─── Feature 3: Environment Merging (handled in loadConfigDirectory) ────
+    // ─── Feature 4: Config Change Listeners ─────────────────────────────────
+    /**
+     * Register a listener for changes to a specific config key.
+     */
+    onChange(key, listener) {
+        if (!this.listeners.has(key)) {
+            this.listeners.set(key, []);
+        }
+        this.listeners.get(key).push(listener);
+        return this;
+    }
+    /**
+     * Register a global listener for ALL config changes.
+     */
+    onAnyChange(listener) {
+        this.globalListeners.push(listener);
+        return this;
+    }
+    notifyListeners(key, newValue, oldValue) {
+        // Key-specific listeners
+        const keyListeners = this.listeners.get(key);
+        if (keyListeners) {
+            for (const listener of keyListeners) {
+                listener(key, newValue, oldValue);
+            }
+        }
+        // Wildcard: notify listeners for parent keys too
+        // e.g. changing 'database.host' should notify 'database' listeners
+        const parts = key.split('.');
+        for (let i = parts.length - 1; i > 0; i--) {
+            const parentKey = parts.slice(0, i).join('.');
+            const parentListeners = this.listeners.get(parentKey);
+            if (parentListeners) {
+                for (const listener of parentListeners) {
+                    listener(key, newValue, oldValue);
+                }
+            }
+        }
+        // Global listeners
+        for (const listener of this.globalListeners) {
+            listener(key, newValue, oldValue);
+        }
+    }
+    // ─── Feature 5: Deep Freeze ─────────────────────────────────────────────
+    /**
+     * Recursively freeze an object to prevent any mutations.
+     */
+    deepFreeze(obj) {
+        if (obj === null || typeof obj !== 'object')
+            return obj;
+        Object.freeze(obj);
+        for (const key of Object.keys(obj)) {
+            const value = obj[key];
+            if (typeof value === 'object' && value !== null && !Object.isFrozen(value)) {
+                this.deepFreeze(value);
+            }
+        }
+        return obj;
+    }
+    // ─── Feature 6: Encrypted Config Values ─────────────────────────────────
+    /**
+     * Set a decrypter function for auto-decrypting `enc:` prefixed values.
+     */
+    setDecrypter(fn) {
+        this.decrypter = fn;
+        return this;
+    }
+    decrypt(value) {
+        const encrypted = value.substring(4); // Remove 'enc:' prefix
+        if (this.decrypter) {
+            return this.decrypter(encrypted);
+        }
+        // If no decrypter is set, return the raw encrypted string
+        return encrypted;
+    }
+    // ─── Utilities ──────────────────────────────────────────────────────────
+    /**
+     * Deep merge two objects. Source values override target values.
+     */
+    deepMerge(target, source) {
+        const result = { ...target };
+        for (const key of Object.keys(source)) {
+            if (source[key] &&
+                typeof source[key] === 'object' &&
+                !Array.isArray(source[key]) &&
+                result[key] &&
+                typeof result[key] === 'object' &&
+                !Array.isArray(result[key])) {
+                result[key] = this.deepMerge(result[key], source[key]);
+            }
+            else {
+                result[key] = source[key];
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=Repository.js.map

package/dist/Repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repository.js","sourceRoot":"","sources":["../src/Repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AA2BpD,+EAA+E;AAE/E,MAAM,OAAO,UAAU;IACX,MAAM,GAAwB,EAAE,CAAC;IACjC,MAAM,GAAG,KAAK,CAAC;IAEvB,4BAA4B;IACpB,SAAS,GAAqB,IAAI,GAAG,EAAE,CAAC;IACxC,UAAU,GAAG,KAAK,CAAC;IAE3B,+BAA+B;IACvB,MAAM,GAAwB,IAAI,CAAC;IAE3C,8BAA8B;IACtB,SAAS,GAAwC,IAAI,GAAG,EAAE,CAAC;IAC3D,eAAe,GAA2B,EAAE,CAAC;IAErD,8BAA8B;IACtB,SAAS,GAAuC,IAAI,CAAC;IAE7D,YAAY,gBAAqC,EAAE;QAC/C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;IACvC,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACI,mBAAmB,CAAC,UAAkB,EAAE,WAAoB;QAC/D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,OAAO;QACX,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAEzC,uCAAuC;QACvC,8CAA8C;QAC9C,2DAA2D;QAC3D,MAAM,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa,CAAC;QAEjE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAC1B,CAAC,IAAY,EAAE,EAAE,CACb,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAC/D,CAAC;QAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CACzB,CAAC,IAAY,EAAE,EAAE,CACb,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,CAC3D,CAAC;QAEF,0BAA0B;QAC1B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,4CAA4C;QAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEO,YAAY,CAAC,IAAY;QAC7B,OAAO,CACH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CACxB,CAAC;IACN,CAAC;IAEO,iBAAiB,CAAC,IAAY;QAClC,MAAM,WAAW,GAAG;YAChB,eAAe;YACf,cAAc;YACd,WAAW;YACX,WAAW;YACX,SAAS;SACZ,CAAC;QACF,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAEO,QAAQ,CACZ,UAAkB,EAClB,IAAY,EACZ,YAAqB,KAAK;QAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAE7C,4EAA4E;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE5B,IAAI,CAAC;YACD,IAAI,WAAW,CAAC;YAChB,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACtC,WAAW,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACL,+BAA+B;YACnC,CAAC;YAED,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC1D,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACvC,8BAA8B;oBAC9B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,SAAS,CACpC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EACvB,WAAW,CACd,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG;wBACtB,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;wBAC1B,GAAG,WAAW;qBACjB,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,2CAA2C;QAC/C,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E;;;OAGG;IACI,GAAG,CAAU,GAAW,EAAE,YAAgB;QAC7C,gDAAgD;QAChD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvB,2CAA2C;gBAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAM,CAAC;gBACrC,CAAC;gBACD,OAAO,MAAW,CAAC;YACvB,CAAC;YACD,OAAO,YAAiB,CAAC;QAC7B,CAAC;QAED,0BAA0B;QAC1B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,GAAQ,IAAI,CAAC,MAAM,CAAC;QAE7B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACxC,OAAO,YAAiB,CAAC;YAC7B,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;QAE1D,2CAA2C;QAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAM,CAAC;QACrC,CAAC;QAED,OAAO,MAAW,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,GAAW;QAClB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IACvC,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,GAAW,EAAE,KAAU;QAC9B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,IACI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;gBACf,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACrB,CAAC;gBACC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAEvC,qCAAqC;QACrC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,GAAG;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,2EAA2E;IAE3E;;;OAGG;IACI,YAAY;QACf,yCAAyC;QACzC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5E,MAAM,IAAI,KAAK,CACX,qCAAqC,QAAQ,EAAE,CAClD,CAAC;YACN,CAAC;QACL,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtB,yBAAyB;QACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACK,cAAc,CAAC,GAAyB,EAAE,MAAe;QAC7D,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAEvC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAE1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAEnC,IACI,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACvB,CAAC;gBACC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACI,YAAY,CAAC,MAAoB;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;IACjC,CAAC;IAEO,cAAc,CAClB,MAAmC,EACnC,MAAe;QAEf,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAEpC,IAAI,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC;QAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAEhC,sCAAsC;YACtC,IAAK,IAAmB,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CACP,GAAG,IAAI,CAAC,cAAc,CACjB,IAAmB,CAAC,QAAQ,EAC7B,OAAO,CACV,CACJ,CAAC;gBACF,SAAS;YACb,CAAC;YAED,MAAM,CAAC,GAAG,IAAkB,CAAC;YAE7B,iBAAiB;YACjB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC;oBACR,GAAG,EAAE,OAAO;oBACZ,OAAO,EACH,CAAC,CAAC,OAAO,IAAI,IAAI,OAAO,4BAA4B;iBAC3D,CAAC,CAAC;gBACH,SAAS;YACb,CAAC;YAED,6DAA6D;YAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAEpD,aAAa;YACb,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACT,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;gBACjE,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,CAAC;wBACR,GAAG,EAAE,OAAO;wBACZ,OAAO,EACH,CAAC,CAAC,OAAO;4BACT,IAAI,OAAO,sBAAsB,CAAC,CAAC,IAAI,WAAW,UAAU,IAAI;qBACvE,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAED,aAAa;YACb,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC;oBACR,GAAG,EAAE,OAAO;oBACZ,OAAO,EACH,CAAC,CAAC,OAAO;wBACT,IAAI,OAAO,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI;iBAC5E,CAAC,CAAC;YACP,CAAC;YAED,sBAAsB;YACtB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnD,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC;wBACR,GAAG,EAAE,OAAO;wBACZ,OAAO,EACH,CAAC,CAAC,OAAO;4BACT,IAAI,OAAO,gBAAgB,CAAC,CAAC,GAAG,SAAS,KAAK,GAAG;qBACxD,CAAC,CAAC;gBACP,CAAC;gBACD,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC;wBACR,GAAG,EAAE,OAAO;wBACZ,OAAO,EACH,CAAC,CAAC,OAAO;4BACT,IAAI,OAAO,gBAAgB,CAAC,CAAC,GAAG,SAAS,KAAK,GAAG;qBACxD,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAED,4BAA4B;YAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnD,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,CAAC;wBACR,GAAG,EAAE,OAAO;wBACZ,OAAO,EACH,CAAC,CAAC,OAAO;4BACT,IAAI,OAAO,wBAAwB,CAAC,CAAC,GAAG,cAAc;qBAC7D,CAAC,CAAC;gBACP,CAAC;gBACD,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,CAAC;wBACR,GAAG,EAAE,OAAO;wBACZ,OAAO,EACH,CAAC,CAAC,OAAO;4BACT,IAAI,OAAO,uBAAuB,CAAC,CAAC,GAAG,cAAc;qBAC5D,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAED,gBAAgB;YAChB,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnE,MAAM,CAAC,IAAI,CAAC;oBACR,GAAG,EAAE,OAAO;oBACZ,OAAO,EACH,CAAC,CAAC,OAAO;wBACT,IAAI,OAAO,wCAAwC;iBAC1D,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,2EAA2E;IAE3E,2EAA2E;IAE3E;;OAEG;IACI,QAAQ,CAAC,GAAW,EAAE,QAA8B;QACvD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAA8B;QAC7C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,GAAW,EAAE,QAAa,EAAE,QAAa;QAC7D,yBAAyB;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,YAAY,EAAE,CAAC;YACf,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;gBAClC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,mEAAmE;QACnE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,eAAe,EAAE,CAAC;gBAClB,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;oBACrC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACtC,CAAC;YACL,CAAC;QACL,CAAC;QAED,mBAAmB;QACnB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACK,UAAU,CAAC,GAAQ;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QAExD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACI,YAAY,CAAC,EAAsC;QACtD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,OAAO,CAAC,KAAa;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAC7D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QACD,0DAA0D;QAC1D,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACK,SAAS,CACb,MAA2B,EAC3B,MAA2B;QAE3B,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,IACI,MAAM,CAAC,GAAG,CAAC;gBACX,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC;gBACX,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAC7B,CAAC;gBACC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/dist/helpers.d.ts

@@ -0,0 +1,13 @@
+import { Repository } from './Repository.js';
+/**
+ * Set the global configuration repository.
+ */
+export declare function setConfigRepository(repo: Repository): void;
+/**
+ * Get/Set configuration values.
+ */
+export declare function config<T = any>(key?: string, defaultValue?: T): T | Repository | any;
+/**
+ * Get an environment variable.
+ */
+export declare function env<T = any>(key: string, defaultValue?: T): T;

package/dist/helpers.js

@@ -0,0 +1,27 @@
+import { EnvLoader } from './EnvLoader.js';
+let repository = null;
+/**
+ * Set the global configuration repository.
+ */
+export function setConfigRepository(repo) {
+    repository = repo;
+}
+/**
+ * Get/Set configuration values.
+ */
+export function config(key, defaultValue) {
+    if (key === undefined) {
+        return repository;
+    }
+    if (!repository) {
+        return defaultValue;
+    }
+    return repository.get(key, defaultValue);
+}
+/**
+ * Get an environment variable.
+ */
+export function env(key, defaultValue) {
+    return EnvLoader.get(key, defaultValue);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IAChD,UAAU,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAU,GAAY,EAAE,YAAgB;IAC1D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAU,GAAW,EAAE,YAAgB;IACtD,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Repository.js';
+export * from './EnvLoader.js';
+export * from './helpers.js';
+export type { SchemaRule, ConfigSchema, ValidationError, ConfigChangeListener, } from './Repository.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './Repository.js';
+export * from './EnvLoader.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@arikajs/config",
+  "version": "0.0.5",
+  "description": "Premium configuration management for ArikaJS.",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "npx tsx --test tests/**/*.test.ts",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "typescript": "^5.3.3",
+    "tsx": "^4.7.1"
+  },
+  "author": "Prakash Tank",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArikaJs/arikajs.git",
+    "directory": "packages/config"
+  },
+  "bugs": {
+    "url": "https://github.com/ArikaJs/arikajs/issues"
+  },
+  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/config#readme"
+}

package/src/EnvLoader.ts

@@ -0,0 +1,51 @@
+
+import * as dotenv from 'dotenv';
+import * as fs from 'fs';
+import * as path from 'path';
+
+export class EnvLoader {
+    /**
+     * Load environment variables from the given path.
+     */
+    public static load(basePath: string): void {
+        const envPath = path.join(basePath, '.env');
+
+        if (fs.existsSync(envPath)) {
+            dotenv.config({ path: envPath, override: true });
+        }
+
+        // Load .env.example if .env doesn't exist (optional, mostly for local dev)
+        const examplePath = path.join(basePath, '.env.example');
+        if (!fs.existsSync(envPath) && fs.existsSync(examplePath)) {
+            dotenv.config({ path: examplePath, override: true });
+        }
+    }
+
+    /**
+     * Get an environment variable with intelligent type casting.
+     */
+    public static get<T = any>(key: string, defaultValue?: T): T {
+        const value = process.env[key];
+
+        if (value === undefined) {
+            return defaultValue as T;
+        }
+
+        switch (value.toLowerCase()) {
+            case 'true':
+            case '(true)':
+                return true as any;
+            case 'false':
+            case '(false)':
+                return false as any;
+            case 'empty':
+            case '(empty)':
+                return '' as any;
+            case 'null':
+            case '(null)':
+                return null as any;
+        }
+
+        return value as any;
+    }
+}