@kvishal04/library-core 1.0.0

package/dist/configmanager/src/utils/config.file.js

@@ -0,0 +1,238 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTree = buildTree;
+exports.countTreeItems = countTreeItems;
+exports.getConfigTree = getConfigTree;
+exports.readConfigFile = readConfigFile;
+exports.createConfigFile = createConfigFile;
+exports.updateConfigFile = updateConfigFile;
+exports.archiveConfigFile = archiveConfigFile;
+exports.unarchiveConfigFile = unarchiveConfigFile;
+exports.renameConfigFile = renameConfigFile;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const config_path_1 = require("./config.path");
+const config_cache_1 = require("../models/config.cache");
+const config_meta_1 = require("../models/config.meta");
+const config_events_1 = __importDefault(require("../events/config.events"));
+const config_registry_1 = require("../models/config.registry");
+/**
+ * Recursively builds a directory tree under `dirPath`.
+ * Each file node includes its registry `active` status.
+ * Pass `relativBase = ''` for the root call.
+ */
+async function buildTree(dirPath, relativeBase = '') {
+    const entries = await promises_1.default.readdir(dirPath, { withFileTypes: true });
+    const nodes = [];
+    for (const entry of entries) {
+        // Skip the registry file itself
+        if (entry.name === '.config-registry.json')
+            continue;
+        const entryRel = relativeBase ? `${relativeBase}/${entry.name}` : entry.name;
+        const entryFull = path_1.default.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            const children = await buildTree(entryFull, entryRel);
+            nodes.push({ name: entry.name, type: 'directory', path: `${entryRel}/`, children });
+        }
+        else {
+            const stat = await promises_1.default.stat(entryFull).catch(() => null);
+            const key = entryRel.replace(/\\/g, '/').toLowerCase();
+            const meta = config_registry_1.configRegistry.get(key);
+            nodes.push({
+                name: entry.name,
+                type: 'file',
+                path: entryRel,
+                size: stat?.size ?? 0,
+                modifiedAt: stat?.mtime ?? null,
+                active: meta?.active ?? true,
+            });
+        }
+    }
+    return nodes;
+}
+/** Counts files and directories in a tree recursively. */
+function countTreeItems(nodes) {
+    let files = 0;
+    let directories = 0;
+    for (const node of nodes) {
+        if (node.type === 'directory') {
+            directories++;
+            if (node.children?.length) {
+                const child = countTreeItems(node.children);
+                files += child.files;
+                directories += child.directories;
+            }
+        }
+        else {
+            files++;
+        }
+    }
+    return { files, directories };
+}
+/**
+ * Builds the full tree starting from APP_CONFIG_ROOT.
+ * Optionally scoped to a sub-path (body.path).
+ */
+async function getConfigTree(relativePath = '.') {
+    const configRoot = (0, config_path_1.getConfigRoot)();
+    let targetPath;
+    let displayRoot;
+    if (!relativePath || relativePath === '.') {
+        targetPath = configRoot;
+        displayRoot = '';
+    }
+    else {
+        targetPath = (0, config_path_1.resolveConfigPath)(relativePath);
+        (0, config_path_1.ensureInsideRoot)(targetPath);
+        displayRoot = relativePath;
+    }
+    const stat = await promises_1.default.stat(targetPath).catch(() => null);
+    if (!stat)
+        throw new Error(`Path not found: ${relativePath}`);
+    if (!stat.isDirectory())
+        throw new Error(`Path is not a directory: ${relativePath}`);
+    const tree = await buildTree(targetPath, displayRoot);
+    const summary = countTreeItems(tree);
+    return { tree, summary, root: displayRoot };
+}
+/**
+ * Reads the raw text content of a `.config` file from disk.
+ * Does NOT evaluate the file — returns the raw source string.
+ * Throws 404-style if the file does not exist.
+ */
+async function readConfigFile(relativePath) {
+    const effectivePath = (0, config_path_1.normalizeToConfigFile)(relativePath);
+    const fullPath = (0, config_path_1.resolveConfigPath)(effectivePath);
+    (0, config_path_1.ensureInsideRoot)(fullPath);
+    const stat = await promises_1.default.stat(fullPath).catch(() => null);
+    if (!stat)
+        throw new Error(`Config file not found: ${effectivePath}`);
+    if (stat.isDirectory())
+        throw new Error(`Path is a directory: ${effectivePath}`);
+    const content = await promises_1.default.readFile(fullPath, 'utf8');
+    const key = (0, config_path_1.normalizeKey)(effectivePath);
+    const meta = config_registry_1.configRegistry.get(key);
+    // encode the content as base64 to ensure it's JSON-safe, since it may contain arbitrary text (including binary data, secrets, etc.)
+    return {
+        path: effectivePath,
+        content: content,
+        size: stat.size,
+        modifiedAt: stat.mtime,
+        active: meta?.active ?? true,
+    };
+}
+/**
+ * Creates a new `.config` file. Throws with status 409 if it already exists.
+ */
+async function createConfigFile(relativePath, content) {
+    const effectivePath = (0, config_path_1.normalizeToConfigFile)(relativePath);
+    const fullPath = (0, config_path_1.resolveConfigPath)(effectivePath);
+    (0, config_path_1.ensureInsideRoot)(fullPath);
+    const dir = path_1.default.dirname(fullPath);
+    await promises_1.default.mkdir(dir, { recursive: true });
+    const exists = await promises_1.default
+        .stat(fullPath)
+        .then(() => true)
+        .catch(() => false);
+    if (exists)
+        throw new Error(`Config file already exists: ${effectivePath}`);
+    await promises_1.default.writeFile(fullPath, content, 'utf8');
+    const key = (0, config_path_1.normalizeKey)(effectivePath);
+    config_registry_1.configRegistry.ensureEntry(key);
+    config_events_1.default.emit('config:updated', { key, path: effectivePath, action: 'created' });
+}
+/**
+ * Overwrites an existing `.config` file and marks the cache entry as stale.
+ * Creates parent directories if they do not exist.
+ */
+async function updateConfigFile(relativePath, content) {
+    const effectivePath = (0, config_path_1.normalizeToConfigFile)(relativePath);
+    const fullPath = (0, config_path_1.resolveConfigPath)(effectivePath);
+    (0, config_path_1.ensureInsideRoot)(fullPath);
+    const dir = path_1.default.dirname(fullPath);
+    await promises_1.default.mkdir(dir, { recursive: true });
+    await promises_1.default.writeFile(fullPath, content, 'utf8');
+    const key = (0, config_path_1.normalizeKey)(effectivePath);
+    config_registry_1.configRegistry.update(key, { modifiedAt: new Date() });
+    // Mark the cache entry stale so callers know a reload is needed
+    const cached = config_cache_1.configCache.get(key);
+    if (cached) {
+        cached.runtime.stale = true;
+    }
+    config_events_1.default.emit('config:updated', { key, path: effectivePath, action: 'updated' });
+}
+/**
+ * Archives a config: sets `active = false` and `archivedAt` in the registry,
+ * then evicts the entry from the runtime cache.
+ * The file on disk is NOT moved, renamed, or modified.
+ */
+async function archiveConfigFile(relativePath) {
+    const effectivePath = (0, config_path_1.normalizeToConfigFile)(relativePath);
+    const key = (0, config_path_1.normalizeKey)(effectivePath);
+    config_registry_1.configRegistry.update(key, { active: false, archivedAt: new Date() });
+    config_cache_1.configCache.delete(key);
+    config_meta_1.configRuntimeMeta.delete(key);
+    config_events_1.default.emit('config:archived', { key, path: effectivePath });
+}
+/**
+ * Unarchives a config: sets `active = true` and clears `archivedAt`.
+ * The caller should call `reloadConfig()` to repopulate the cache.
+ * The file on disk is NOT modified.
+ */
+async function unarchiveConfigFile(relativePath) {
+    const effectivePath = (0, config_path_1.normalizeToConfigFile)(relativePath);
+    const key = (0, config_path_1.normalizeKey)(effectivePath);
+    config_registry_1.configRegistry.update(key, { active: true, archivedAt: null });
+    config_events_1.default.emit('config:unarchived', { key, path: effectivePath });
+}
+/**
+ * Renames a config file on disk and updates the cache, registry, and runtime meta.
+ * Throws if the source file does not exist or the destination already exists.
+ * Both paths must be within the config root.
+ */
+async function renameConfigFile(oldRelativePath, newRelativePath) {
+    const effectiveOld = (0, config_path_1.normalizeToConfigFile)(oldRelativePath);
+    const effectiveNew = (0, config_path_1.normalizeToConfigFile)(newRelativePath);
+    const oldAbsolute = (0, config_path_1.resolveConfigPath)(effectiveOld);
+    const newAbsolute = (0, config_path_1.resolveConfigPath)(effectiveNew);
+    (0, config_path_1.ensureInsideRoot)(oldAbsolute);
+    (0, config_path_1.ensureInsideRoot)(newAbsolute);
+    // Source must exist
+    const oldStat = await promises_1.default.stat(oldAbsolute).catch(() => null);
+    if (!oldStat)
+        throw new Error(`Source config file not found: ${effectiveOld}`);
+    if (oldStat.isDirectory())
+        throw new Error(`Source path is a directory: ${effectiveOld}`);
+    // Destination must not exist (case-sensitive check)
+    const newParentDir = path_1.default.dirname(newAbsolute);
+    const newBaseName = path_1.default.basename(newAbsolute);
+    const siblings = await promises_1.default.readdir(newParentDir).catch(() => []);
+    if (siblings.includes(newBaseName)) {
+        throw new Error(`Destination already exists: ${effectiveNew}`);
+    }
+    // Ensure destination directory exists
+    await promises_1.default.mkdir(newParentDir, { recursive: true });
+    // Rename the file on disk
+    await promises_1.default.rename(oldAbsolute, newAbsolute);
+    const oldKey = (0, config_path_1.normalizeKey)(effectiveOld);
+    const newKey = (0, config_path_1.normalizeKey)(effectiveNew);
+    // Transfer cache entry
+    const cached = config_cache_1.configCache.get(oldKey);
+    if (cached) {
+        config_cache_1.configCache.set(newKey, cached);
+        config_cache_1.configCache.delete(oldKey);
+    }
+    // Transfer runtime metadata
+    const runtimeMeta = config_meta_1.configRuntimeMeta.get(oldKey);
+    if (runtimeMeta) {
+        config_meta_1.configRuntimeMeta.set(newKey, runtimeMeta);
+        config_meta_1.configRuntimeMeta.delete(oldKey);
+    }
+    // Transfer registry metadata
+    config_registry_1.configRegistry.rename(oldKey, newKey);
+    config_events_1.default.emit('config:updated', { key: newKey, path: effectiveNew, action: 'renamed' });
+}
+//# sourceMappingURL=config.file.js.map

package/dist/configmanager/src/utils/config.file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.file.js","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.file.ts"],"names":[],"mappings":"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"}

package/dist/configmanager/src/utils/config.loader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Recursively collects all `.config` file paths relative to `dir`.
+ */
+export declare function scanConfigFiles(dir: string, base?: string): string[];
+/**
+ * Loads a single config file into the cache.
+ * Safe to call multiple times — subsequent calls overwrite the cached entry.
+ */
+export declare function loadConfig(configPath: string): Promise<unknown>;
+/**
+ * Forces a reload of a single config file.
+ * The cache entry is replaced with fresh file content.
+ */
+export declare function reloadConfig(relativePath: string): Promise<unknown>;
+/**
+ * Scans APP_CONFIG_ROOT and reloads all non-archived .config files.
+ * Returns the map of { normalizedKey → configValue } for all loaded files.
+ */
+export declare function reloadConfigs(): Promise<Record<string, unknown>>;
+//# sourceMappingURL=config.loader.d.ts.map

package/dist/configmanager/src/utils/config.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.loader.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.loader.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE,CAahE;AAID;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BrE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBtE"}

package/dist/configmanager/src/utils/config.loader.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanConfigFiles = scanConfigFiles;
+exports.loadConfig = loadConfig;
+exports.reloadConfig = reloadConfig;
+exports.reloadConfigs = reloadConfigs;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const vm_1 = __importDefault(require("vm"));
+const crypto_1 = __importDefault(require("crypto"));
+const config_cache_1 = require("../models/config.cache");
+const config_meta_1 = require("../models/config.meta");
+const config_registry_1 = require("../models/config.registry");
+const config_path_1 = require("./config.path");
+const config_events_1 = __importDefault(require("../events/config.events"));
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+function computeChecksum(content) {
+    return crypto_1.default.createHash('md5').update(content).digest('hex');
+}
+/**
+ * Evaluates a .config file's content as a JS expression.
+ * Files may export plain objects, arrow functions, or wrapped expressions.
+ */
+function evaluateContent(content) {
+    return vm_1.default.runInNewContext(content);
+}
+// ─── File scanner ─────────────────────────────────────────────────────────────
+/**
+ * Recursively collects all `.config` file paths relative to `dir`.
+ */
+function scanConfigFiles(dir, base = '') {
+    const results = [];
+    if (!fs_1.default.existsSync(dir))
+        return results;
+    const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const rel = base ? `${base}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            results.push(...scanConfigFiles(path_1.default.join(dir, entry.name), rel));
+        }
+        else if (entry.name.endsWith('.config')) {
+            results.push(rel);
+        }
+    }
+    return results;
+}
+// ─── Public loader API ────────────────────────────────────────────────────────
+/**
+ * Loads a single config file into the cache.
+ * Safe to call multiple times — subsequent calls overwrite the cached entry.
+ */
+async function loadConfig(configPath) {
+    const key = (0, config_path_1.normalizeKey)(configPath);
+    const fullPath = (0, config_path_1.resolveConfigPath)(configPath);
+    (0, config_path_1.ensureInsideRoot)(fullPath);
+    const stat = await fs_1.default.promises.stat(fullPath);
+    const content = await fs_1.default.promises.readFile(fullPath, 'utf-8');
+    const value = evaluateContent(content);
+    const checksum = computeChecksum(content);
+    const entry = {
+        value,
+        runtime: {
+            loadedAt: new Date(),
+            checksum,
+            stale: false,
+            fileModifiedAt: stat.mtime,
+        },
+    };
+    config_cache_1.configCache.set(key, entry);
+    config_meta_1.configRuntimeMeta.set(key, entry.runtime);
+    config_registry_1.configRegistry.ensureEntry(key);
+    config_events_1.default.emit('config:loaded', { key, path: configPath });
+    return value;
+}
+/**
+ * Forces a reload of a single config file.
+ * The cache entry is replaced with fresh file content.
+ */
+async function reloadConfig(relativePath) {
+    const value = await loadConfig(relativePath);
+    const key = (0, config_path_1.normalizeKey)(relativePath);
+    config_events_1.default.emit('config:reloaded', { key, path: relativePath });
+    console.log(`[ConfigLoader] Reloaded "${relativePath}"`);
+    return value;
+}
+/**
+ * Scans APP_CONFIG_ROOT and reloads all non-archived .config files.
+ * Returns the map of { normalizedKey → configValue } for all loaded files.
+ */
+async function reloadConfigs() {
+    const configRoot = (0, config_path_1.getConfigRoot)();
+    const files = scanConfigFiles(configRoot);
+    const map = {};
+    for (const relPath of files) {
+        const key = (0, config_path_1.normalizeKey)(relPath);
+        const meta = config_registry_1.configRegistry.get(key);
+        // Skip archived configs
+        if (meta && meta.archivedAt !== null) {
+            console.log(`[ConfigLoader] Skipped archived config: "${relPath}"`);
+            continue;
+        }
+        try {
+            const value = await loadConfig(relPath);
+            map[key] = value;
+        }
+        catch (err) {
+            console.warn(`[ConfigLoader] Skipped "${relPath}": ${err.message}`);
+        }
+    }
+    console.log(`[ConfigLoader] Loaded ${Object.keys(map).length} / ${files.length} config file(s)`);
+    return map;
+}
+//# sourceMappingURL=config.loader.js.map

package/dist/configmanager/src/utils/config.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.loader.js","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.loader.ts"],"names":[],"mappings":"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"}

package/dist/configmanager/src/utils/config.parser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parses a config value against a params map.
+ *
+ * - If `config` is a function, it is called with `params` and the result is returned.
+ * - If `config` is a string, `${KEY}` placeholders are interpolated.
+ * - Arrays and plain objects are traversed recursively.
+ * - All other primitives are returned as-is.
+ */
+export declare function parseConfig(config: unknown, params: Record<string, unknown>): unknown;
+//# sourceMappingURL=config.parser.d.ts.map

package/dist/configmanager/src/utils/config.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.parser.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.parser.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAkBrF"}

package/dist/configmanager/src/utils/config.parser.js

@@ -0,0 +1,52 @@
+"use strict";
+// ─── Config parser ────────────────────────────────────────────────────────────
+// Supports:
+//   • Function evaluation  — config exported as a function receives `params`
+//   • Variable interpolation — ${KEY} resolved from params then process.env
+//   • Recursive traversal  — arrays and nested objects are parsed deeply
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseConfig = parseConfig;
+/**
+ * Parses a config value against a params map.
+ *
+ * - If `config` is a function, it is called with `params` and the result is returned.
+ * - If `config` is a string, `${KEY}` placeholders are interpolated.
+ * - Arrays and plain objects are traversed recursively.
+ * - All other primitives are returned as-is.
+ */
+function parseConfig(config, params) {
+    if (typeof config === 'function') {
+        return config(params);
+    }
+    if (typeof config === 'string') {
+        return interpolateString(config, params);
+    }
+    if (Array.isArray(config)) {
+        return config.map((item) => parseConfig(item, params));
+    }
+    if (config !== null && typeof config === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(config)) {
+            result[key] = parseConfig(value, params);
+        }
+        return result;
+    }
+    return config;
+}
+// ─── String interpolation ─────────────────────────────────────────────────────
+function interpolateString(template, params) {
+    return template.replace(/\$\{([^}]+)\}/g, (original, rawKey) => {
+        const key = rawKey.trim();
+        // 1. Check params first
+        if (Object.prototype.hasOwnProperty.call(params, key)) {
+            return String(params[key]);
+        }
+        // 2. Fall back to environment variable
+        const envValue = process.env[key];
+        if (envValue !== undefined)
+            return envValue;
+        // 3. Leave placeholder intact
+        return original;
+    });
+}
+//# sourceMappingURL=config.parser.js.map

package/dist/configmanager/src/utils/config.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.parser.js","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.parser.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,YAAY;AACZ,6EAA6E;AAC7E,4EAA4E;AAC5E,yEAAyE;;AAUzE,kCAkBC;AA1BD;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,MAAe,EAAE,MAA+B;IAC1E,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAQ,MAAkD,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF,SAAS,iBAAiB,CAAC,QAAgB,EAAE,MAA+B;IAC1E,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAc,EAAE,EAAE;QACrE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1B,wBAAwB;QACxB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,uCAAuC;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,8BAA8B;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/configmanager/src/utils/config.path.d.ts

@@ -0,0 +1,18 @@
+export declare function getConfigRoot(): string;
+export declare function normalizeKey(relativePath: string): string;
+/**
+ * Resolves a relative config path against APP_CONFIG_ROOT.
+ * Throws if the path is absolute or attempts path traversal.
+ */
+export declare function resolveConfigPath(relativePath: string): string;
+/**
+ * Throws if `resolvedPath` escapes the config root.
+ */
+export declare function ensureInsideRoot(resolvedPath: string): void;
+/**
+ * Ensures the path ends with `.config`.
+ * Appends `.config` if no extension is present.
+ * Throws if the extension is something other than `.config`.
+ */
+export declare function normalizeToConfigFile(relativePath: string, allowDirectory?: boolean): string;
+//# sourceMappingURL=config.path.d.ts.map

package/dist/configmanager/src/utils/config.path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.path.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.path.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAKD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,MAAM,CAS1F"}

package/dist/configmanager/src/utils/config.path.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigRoot = getConfigRoot;
+exports.normalizeKey = normalizeKey;
+exports.resolveConfigPath = resolveConfigPath;
+exports.ensureInsideRoot = ensureInsideRoot;
+exports.normalizeToConfigFile = normalizeToConfigFile;
+const path_1 = __importDefault(require("path"));
+const appConfig_1 = __importDefault(require("../../../appConfig"));
+// ─── Config root ──────────────────────────────────────────────────────────────
+function getConfigRoot() {
+    const root = appConfig_1.default.get('APP_CONFIG_ROOT');
+    if (!root)
+        throw new Error('APP_CONFIG_ROOT is not configured in AppConfig');
+    return root;
+}
+// ─── Key normalization ────────────────────────────────────────────────────────
+// All cache / registry keys must be lowercase forward-slash paths.
+function normalizeKey(relativePath) {
+    return relativePath.replace(/\\/g, '/').toLowerCase().trim();
+}
+// ─── Path resolution ──────────────────────────────────────────────────────────
+/**
+ * Resolves a relative config path against APP_CONFIG_ROOT.
+ * Throws if the path is absolute or attempts path traversal.
+ */
+function resolveConfigPath(relativePath) {
+    if (!relativePath || typeof relativePath !== 'string') {
+        throw new Error('Path is required');
+    }
+    const normalized = path_1.default.normalize(relativePath);
+    if (normalized.startsWith('..') || path_1.default.isAbsolute(normalized)) {
+        throw new Error('Invalid path: must be relative and within config root');
+    }
+    return path_1.default.resolve(getConfigRoot(), normalized);
+}
+/**
+ * Throws if `resolvedPath` escapes the config root.
+ */
+function ensureInsideRoot(resolvedPath) {
+    const root = path_1.default.resolve(getConfigRoot());
+    const sep = path_1.default.sep;
+    if (resolvedPath !== root && !resolvedPath.startsWith(root + sep)) {
+        throw new Error('Path outside config root is not allowed');
+    }
+}
+/**
+ * Ensures the path ends with `.config`.
+ * Appends `.config` if no extension is present.
+ * Throws if the extension is something other than `.config`.
+ */
+function normalizeToConfigFile(relativePath, allowDirectory = false) {
+    if (!relativePath || typeof relativePath !== 'string') {
+        throw new Error('Path is required');
+    }
+    if (allowDirectory && relativePath.endsWith('/'))
+        return relativePath;
+    const ext = path_1.default.extname(relativePath);
+    if (!ext)
+        return `${relativePath}.config`;
+    if (ext !== '.config')
+        throw new Error('Only .config files are allowed');
+    return relativePath;
+}
+//# sourceMappingURL=config.path.js.map

package/dist/configmanager/src/utils/config.path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.path.js","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.path.ts"],"names":[],"mappings":";;;;;AAKA,sCAIC;AAKD,oCAEC;AAQD,8CASC;AAKD,4CAMC;AAOD,sDASC;AA5DD,gDAAwB;AACxB,mEAA6C;AAE7C,iFAAiF;AAEjF,SAAgB,aAAa;IAC3B,MAAM,IAAI,GAAG,mBAAW,CAAC,GAAG,CAAS,iBAAiB,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,mEAAmE;AAEnE,SAAgB,YAAY,CAAC,YAAoB;IAC/C,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,YAAoB;IACpD,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,UAAU,GAAG,cAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,cAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,YAAoB;IACnD,MAAM,IAAI,GAAG,cAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,cAAI,CAAC,GAAG,CAAC;IACrB,IAAI,YAAY,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,YAAoB,EAAE,cAAc,GAAG,KAAK;IAChF,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,cAAc,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IACtE,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,YAAY,SAAS,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACzE,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/configmanager/src/utils/config.serializer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Recursively sanitizes a config value for safe JSON serialization.
+ *
+ * - Functions are replaced with the string `"[Function]"`
+ * - When `maskSecrets` is true, keys matching common secret patterns are replaced with `"***"`
+ * - Circular references are handled gracefully via a seen-set
+ */
+export declare function sanitize(obj: unknown, maskSecrets?: boolean, _seen?: WeakSet<object>): unknown;
+/**
+ * Returns a JSON-safe snapshot of all cached configs.
+ * Functions become `"[Function]"`, circular refs become `"[Circular]"`.
+ * Pass `maskSecrets = true` to redact common credential keys.
+ */
+export declare function getAllConfigsSafe(maskSecrets?: boolean): Record<string, unknown>;
+//# sourceMappingURL=config.serializer.d.ts.map

package/dist/configmanager/src/utils/config.serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.serializer.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.serializer.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,UAAQ,EAAE,KAAK,kBAAgB,GAAG,OAAO,CAiB1F;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,UAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9E"}

package/dist/configmanager/src/utils/config.serializer.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitize = sanitize;
+exports.getAllConfigsSafe = getAllConfigsSafe;
+const config_cache_1 = require("../models/config.cache");
+// ─── Secret key pattern ───────────────────────────────────────────────────────
+const SECRET_KEYS = /password|secret|token|key|credential|auth/i;
+// ─── Deep sanitizer ───────────────────────────────────────────────────────────
+/**
+ * Recursively sanitizes a config value for safe JSON serialization.
+ *
+ * - Functions are replaced with the string `"[Function]"`
+ * - When `maskSecrets` is true, keys matching common secret patterns are replaced with `"***"`
+ * - Circular references are handled gracefully via a seen-set
+ */
+function sanitize(obj, maskSecrets = false, _seen = new WeakSet()) {
+    if (typeof obj === 'function')
+        return '[Function]';
+    if (Array.isArray(obj))
+        return obj.map((item) => sanitize(item, maskSecrets, _seen));
+    if (obj !== null && typeof obj === 'object') {
+        if (_seen.has(obj))
+            return '[Circular]';
+        _seen.add(obj);
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            if (maskSecrets && SECRET_KEYS.test(k)) {
+                out[k] = '***';
+            }
+            else {
+                out[k] = sanitize(v, maskSecrets, _seen);
+            }
+        }
+        return out;
+    }
+    return obj;
+}
+// ─── Public serializer ────────────────────────────────────────────────────────
+/**
+ * Returns a JSON-safe snapshot of all cached configs.
+ * Functions become `"[Function]"`, circular refs become `"[Circular]"`.
+ * Pass `maskSecrets = true` to redact common credential keys.
+ */
+function getAllConfigsSafe(maskSecrets = false) {
+    const result = {};
+    for (const [key, entry] of config_cache_1.configCache.entries()) {
+        result[key] = sanitize(entry.value, maskSecrets);
+    }
+    return result;
+}
+//# sourceMappingURL=config.serializer.js.map