@kvishal04/library-core 1.0.0

package/dist/configmanager/src/service.d.ts

@@ -0,0 +1,90 @@
+import { loadConfig, reloadConfig, reloadConfigs } from './utils/config.loader';
+import { getAllConfigsSafe, sanitize } from './utils/config.serializer';
+import { readConfigFile, createConfigFile, updateConfigFile, archiveConfigFile, unarchiveConfigFile, renameConfigFile, getConfigTree } from './utils/config.file';
+import { ConfigMeta } from './types/config.meta.types';
+import { ConfigEventName, ConfigEventPayload } from './events/config.events';
+declare const ConfigManagerService: {
+    /** Reload ALL non-archived configs from disk into the cache. */
+    reloadConfigs: typeof reloadConfigs;
+    /** Reload a single config file by relative path. */
+    reloadConfig: typeof reloadConfig;
+    /** Load a config file by path (used for on-demand loading). */
+    loadConfig: typeof loadConfig;
+    /**
+     * Returns the cached config value.
+     * Returns `null` if the config has not been loaded or does not exist.
+     */
+    getConfig<T = any>(relativePath: string): T | any;
+    /** Returns all cached configs as a plain object. */
+    getAllConfigs(): Record<string, unknown>;
+    /**
+     * Returns all cached configs sanitized for JSON serialization.
+     * Functions become `"[Function]"`, circular refs become `"[Circular]"`.
+     */
+    getAllConfigsSafe: typeof getAllConfigsSafe;
+    /** Returns `true` if the config is present in the runtime cache. */
+    configExists(relativePath: string): boolean;
+    /**
+     * Parses a config value with runtime params.
+     * Supports function evaluation, variable interpolation, and deep traversal.
+     */
+    parseConfig(config: unknown, params: Record<string, unknown>): unknown;
+    /** Evicts all entries from the runtime cache and runtime meta store. */
+    flushCache(): void;
+    /** Evicts a single config from the runtime cache. */
+    flushConfig(relativePath: string): void;
+    /** Returns the registry metadata for a config. */
+    getConfigMeta(relativePath: string): ConfigMeta | undefined;
+    /** Partially updates the registry metadata for a config. */
+    updateConfigMeta(relativePath: string, meta: Partial<ConfigMeta>): void;
+    /**
+     * Archives a config: marks it inactive in the registry and evicts from cache.
+     * The config file on disk is NOT modified.
+     */
+    archiveConfig: typeof archiveConfigFile;
+    /**
+     * Unarchives a config: marks it active in the registry.
+     * Call `reloadConfig()` afterwards to repopulate the cache.
+     */
+    unarchiveConfig: typeof unarchiveConfigFile;
+    /** Returns `true` if the config is marked active in the registry. */
+    isConfigActive(relativePath: string): boolean;
+    /** Returns the normalized keys of all archived configs. */
+    listArchivedConfigs(): string[];
+    /** Returns the normalized keys of all active (non-archived) configs. */
+    listActiveConfigs(): string[];
+    /** Returns the combined cache + registry status of a config. */
+    getConfigStatus(relativePath: string): {
+        cached: boolean;
+        stale: boolean;
+        active: boolean;
+    };
+    /** Returns `true` if the cached entry is marked stale. */
+    isConfigStale(relativePath: string): boolean;
+    /** Returns all cache keys whose entries are marked stale. */
+    getPendingReloads(): string[];
+    /** Reads the raw source content of a config file from disk. */
+    readConfigFile: typeof readConfigFile;
+    /** Creates a new config file on disk. Throws if the file already exists. */
+    createConfigFile: typeof createConfigFile;
+    /** Overwrites a config file on disk and marks the cache entry stale. */
+    updateConfigFile: typeof updateConfigFile;
+    /** Renames a config file on disk and updates cache + registry. */
+    renameConfigFile: typeof renameConfigFile;
+    /**
+     * Returns a recursive directory tree of the config root (or a sub-path).
+     * Each file node includes registry `active` status.
+     */
+    getConfigTree: typeof getConfigTree;
+    /** Sanitizes any value for safe JSON output (functions, circular refs, secrets). */
+    sanitize: typeof sanitize;
+    /**
+     * Subscribe to a config lifecycle event.
+     * @example ConfigManager.on('config:reloaded', ({ key }) => { ... })
+     */
+    on(event: ConfigEventName, listener: (payload: ConfigEventPayload) => void): void;
+    off(event: ConfigEventName, listener: (payload: ConfigEventPayload) => void): void;
+    once(event: ConfigEventName, listener: (payload: ConfigEventPayload) => void): void;
+};
+export default ConfigManagerService;
+//# sourceMappingURL=service.d.ts.map

package/dist/configmanager/src/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../core/configmanager/src/service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAM3F,QAAA,MAAM,oBAAoB;IAGxB,gEAAgE;;IAGhE,oDAAoD;;IAGpD,+DAA+D;;IAK/D;;;OAGG;cACO,CAAC,sBAAsB,MAAM,GAAG,CAAC,GAAG,GAAG;IAKjD,oDAAoD;qBACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQxC;;;OAGG;;IAGH,oEAAoE;+BACzC,MAAM,GAAG,OAAO;IAM3C;;;OAGG;wBACiB,OAAO,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAMtE,wEAAwE;kBAC1D,IAAI;IAMlB,qDAAqD;8BAC3B,MAAM,GAAG,IAAI;IAQvC,kDAAkD;gCACtB,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3D,4DAA4D;mCAC7B,MAAM,QAAQ,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAIvE;;;OAGG;;IAGH;;;OAGG;;IAGH,qEAAqE;iCACxC,MAAM,GAAG,OAAO;IAK7C,2DAA2D;2BACpC,MAAM,EAAE;IAM/B,wEAAwE;yBACnD,MAAM,EAAE;IAQ7B,gEAAgE;kCAClC,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IAY3F,0DAA0D;gCAC9B,MAAM,GAAG,OAAO;IAI5C,6DAA6D;yBACxC,MAAM,EAAE;IAM7B,+DAA+D;;IAG/D,4EAA4E;;IAG5E,wEAAwE;;IAGxE,kEAAkE;;IAGlE;;;OAGG;;IAKH,oFAAoF;;IAKpF;;;OAGG;cACO,eAAe,YAAY,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;eAItE,eAAe,YAAY,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;gBAItE,eAAe,YAAY,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;CAGpF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/configmanager/src/service.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_cache_1 = require("./models/config.cache");
+const config_registry_1 = require("./models/config.registry");
+const config_meta_1 = require("./models/config.meta");
+const config_loader_1 = require("./utils/config.loader");
+const config_parser_1 = require("./utils/config.parser");
+const config_serializer_1 = require("./utils/config.serializer");
+const config_file_1 = require("./utils/config.file");
+const config_path_1 = require("./utils/config.path");
+const config_events_1 = __importDefault(require("./events/config.events"));
+// ─── ConfigManager Service ────────────────────────────────────────────────────
+// Single facade for all ConfigManager operations.
+// No business logic in routes — everything goes through here.
+const ConfigManagerService = {
+    // ── Loading ────────────────────────────────────────────────────────────────
+    /** Reload ALL non-archived configs from disk into the cache. */
+    reloadConfigs: config_loader_1.reloadConfigs,
+    /** Reload a single config file by relative path. */
+    reloadConfig: config_loader_1.reloadConfig,
+    /** Load a config file by path (used for on-demand loading). */
+    loadConfig: config_loader_1.loadConfig,
+    // ── Reading ────────────────────────────────────────────────────────────────
+    /**
+     * Returns the cached config value.
+     * Returns `null` if the config has not been loaded or does not exist.
+     */
+    getConfig(relativePath) {
+        const key = (0, config_path_1.normalizeKey)(relativePath);
+        return config_cache_1.configCache.get(key)?.value ?? null;
+    },
+    /** Returns all cached configs as a plain object. */
+    getAllConfigs() {
+        const result = {};
+        for (const [key, entry] of config_cache_1.configCache.entries()) {
+            result[key] = entry.value;
+        }
+        return result;
+    },
+    /**
+     * Returns all cached configs sanitized for JSON serialization.
+     * Functions become `"[Function]"`, circular refs become `"[Circular]"`.
+     */
+    getAllConfigsSafe: config_serializer_1.getAllConfigsSafe,
+    /** Returns `true` if the config is present in the runtime cache. */
+    configExists(relativePath) {
+        return config_cache_1.configCache.has((0, config_path_1.normalizeKey)(relativePath));
+    },
+    // ── Parsing ────────────────────────────────────────────────────────────────
+    /**
+     * Parses a config value with runtime params.
+     * Supports function evaluation, variable interpolation, and deep traversal.
+     */
+    parseConfig(config, params) {
+        return (0, config_parser_1.parseConfig)(config, params);
+    },
+    // ── Cache Management ───────────────────────────────────────────────────────
+    /** Evicts all entries from the runtime cache and runtime meta store. */
+    flushCache() {
+        config_cache_1.configCache.flush();
+        config_meta_1.configRuntimeMeta.flush();
+        config_events_1.default.emit('config:cache-flushed', { key: '*', path: '*' });
+    },
+    /** Evicts a single config from the runtime cache. */
+    flushConfig(relativePath) {
+        const key = (0, config_path_1.normalizeKey)(relativePath);
+        config_cache_1.configCache.delete(key);
+        config_meta_1.configRuntimeMeta.delete(key);
+    },
+    // ── Metadata Management ────────────────────────────────────────────────────
+    /** Returns the registry metadata for a config. */
+    getConfigMeta(relativePath) {
+        return config_registry_1.configRegistry.get((0, config_path_1.normalizeKey)(relativePath));
+    },
+    /** Partially updates the registry metadata for a config. */
+    updateConfigMeta(relativePath, meta) {
+        config_registry_1.configRegistry.update((0, config_path_1.normalizeKey)(relativePath), meta);
+    },
+    /**
+     * Archives a config: marks it inactive in the registry and evicts from cache.
+     * The config file on disk is NOT modified.
+     */
+    archiveConfig: config_file_1.archiveConfigFile,
+    /**
+     * Unarchives a config: marks it active in the registry.
+     * Call `reloadConfig()` afterwards to repopulate the cache.
+     */
+    unarchiveConfig: config_file_1.unarchiveConfigFile,
+    /** Returns `true` if the config is marked active in the registry. */
+    isConfigActive(relativePath) {
+        const meta = config_registry_1.configRegistry.get((0, config_path_1.normalizeKey)(relativePath));
+        return meta?.active ?? false;
+    },
+    /** Returns the normalized keys of all archived configs. */
+    listArchivedConfigs() {
+        return Object.entries(config_registry_1.configRegistry.getAll())
+            .filter(([, meta]) => meta.archivedAt !== null)
+            .map(([key]) => key);
+    },
+    /** Returns the normalized keys of all active (non-archived) configs. */
+    listActiveConfigs() {
+        return Object.entries(config_registry_1.configRegistry.getAll())
+            .filter(([, meta]) => meta.active && meta.archivedAt === null)
+            .map(([key]) => key);
+    },
+    // ── Status ─────────────────────────────────────────────────────────────────
+    /** Returns the combined cache + registry status of a config. */
+    getConfigStatus(relativePath) {
+        const key = (0, config_path_1.normalizeKey)(relativePath);
+        const cached = config_cache_1.configCache.has(key);
+        const runtime = config_meta_1.configRuntimeMeta.get(key);
+        const meta = config_registry_1.configRegistry.get(key);
+        return {
+            cached,
+            stale: runtime?.stale ?? false,
+            active: meta?.active ?? false,
+        };
+    },
+    /** Returns `true` if the cached entry is marked stale. */
+    isConfigStale(relativePath) {
+        return config_meta_1.configRuntimeMeta.get((0, config_path_1.normalizeKey)(relativePath))?.stale ?? false;
+    },
+    /** Returns all cache keys whose entries are marked stale. */
+    getPendingReloads() {
+        return config_cache_1.configCache.keys().filter((key) => config_meta_1.configRuntimeMeta.get(key)?.stale === true);
+    },
+    // ── File Operations ────────────────────────────────────────────────────────
+    /** Reads the raw source content of a config file from disk. */
+    readConfigFile: config_file_1.readConfigFile,
+    /** Creates a new config file on disk. Throws if the file already exists. */
+    createConfigFile: config_file_1.createConfigFile,
+    /** Overwrites a config file on disk and marks the cache entry stale. */
+    updateConfigFile: config_file_1.updateConfigFile,
+    /** Renames a config file on disk and updates cache + registry. */
+    renameConfigFile: config_file_1.renameConfigFile,
+    /**
+     * Returns a recursive directory tree of the config root (or a sub-path).
+     * Each file node includes registry `active` status.
+     */
+    getConfigTree: config_file_1.getConfigTree,
+    // ── Serialization ──────────────────────────────────────────────────────────
+    /** Sanitizes any value for safe JSON output (functions, circular refs, secrets). */
+    sanitize: config_serializer_1.sanitize,
+    // ── Event System ───────────────────────────────────────────────────────────
+    /**
+     * Subscribe to a config lifecycle event.
+     * @example ConfigManager.on('config:reloaded', ({ key }) => { ... })
+     */
+    on(event, listener) {
+        config_events_1.default.on(event, listener);
+    },
+    off(event, listener) {
+        config_events_1.default.off(event, listener);
+    },
+    once(event, listener) {
+        config_events_1.default.once(event, listener);
+    },
+};
+exports.default = ConfigManagerService;
+//# sourceMappingURL=service.js.map

package/dist/configmanager/src/service.js.map

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

package/dist/configmanager/src/types/api.types.d.ts

@@ -0,0 +1,11 @@
+export interface ApiSuccessResponse<T = unknown> {
+    status: true;
+    message?: string;
+    data?: T;
+}
+export interface ApiErrorResponse {
+    status: false;
+    error: string;
+}
+export type ApiResponse<T = unknown> = ApiSuccessResponse<T> | ApiErrorResponse;
+//# sourceMappingURL=api.types.d.ts.map

package/dist/configmanager/src/types/api.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.types.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/types/api.types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC"}

package/dist/configmanager/src/types/api.types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Shared API response envelope ─────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.types.js.map

package/dist/configmanager/src/types/api.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.types.js","sourceRoot":"","sources":["../../../../core/configmanager/src/types/api.types.ts"],"names":[],"mappings":";AAAA,iFAAiF"}

package/dist/configmanager/src/types/config.meta.types.d.ts

@@ -0,0 +1,12 @@
+export interface ConfigMeta {
+    /** Whether the config is currently active (i.e. should be loaded into cache) */
+    active: boolean;
+    /** When the registry entry was first created */
+    createdAt: Date;
+    /** When the registry entry was last modified */
+    modifiedAt: Date;
+    /** Set when the config is archived; null while active */
+    archivedAt: Date | null;
+}
+export type ConfigRegistry = Record<string, ConfigMeta>;
+//# sourceMappingURL=config.meta.types.d.ts.map

package/dist/configmanager/src/types/config.meta.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.meta.types.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/types/config.meta.types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,SAAS,EAAE,IAAI,CAAC;IAChB,gDAAgD;IAChD,UAAU,EAAE,IAAI,CAAC;IACjB,yDAAyD;IACzD,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAKD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/dist/configmanager/src/types/config.meta.types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ─── File / registry metadata ─────────────────────────────────────────────────
+// Maintained in the persisted registry. Never stored inside config files.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.meta.types.js.map

package/dist/configmanager/src/types/config.meta.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.meta.types.js","sourceRoot":"","sources":["../../../../core/configmanager/src/types/config.meta.types.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,0EAA0E"}

package/dist/configmanager/src/types/config.types.d.ts

@@ -0,0 +1,17 @@
+export interface RuntimeMeta {
+    /** Timestamp when the config was loaded into cache */
+    loadedAt: Date;
+    /** MD5 checksum of the file content at load time */
+    checksum: string;
+    /** True when the file has been updated on disk after the last cache load */
+    stale: boolean;
+    /** File mtime at the moment it was loaded */
+    fileModifiedAt: Date;
+}
+export interface CacheEntry {
+    /** The evaluated config object */
+    value: unknown;
+    /** Runtime metadata — separate from file/registry metadata */
+    runtime: RuntimeMeta;
+}
+//# sourceMappingURL=config.types.d.ts.map

package/dist/configmanager/src/types/config.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/types/config.types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,IAAI,CAAC;IACf,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,cAAc,EAAE,IAAI,CAAC;CACtB;AAID,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/configmanager/src/types/config.types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ─── Runtime metadata attached to each cached entry ──────────────────────────
+// This is maintained by ConfigManager and never written to config files.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.types.js.map

package/dist/configmanager/src/types/config.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.js","sourceRoot":"","sources":["../../../../core/configmanager/src/types/config.types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yEAAyE"}

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

@@ -0,0 +1,72 @@
+export interface TreeNode {
+    name: string;
+    type: 'file' | 'directory';
+    path: string;
+    size?: number;
+    modifiedAt?: Date | null;
+    active?: boolean;
+    cached?: boolean;
+    children?: TreeNode[];
+}
+export interface TreeSummary {
+    files: number;
+    directories: number;
+}
+/**
+ * Recursively builds a directory tree under `dirPath`.
+ * Each file node includes its registry `active` status.
+ * Pass `relativBase = ''` for the root call.
+ */
+export declare function buildTree(dirPath: string, relativeBase?: string): Promise<TreeNode[]>;
+/** Counts files and directories in a tree recursively. */
+export declare function countTreeItems(nodes: TreeNode[]): TreeSummary;
+/**
+ * Builds the full tree starting from APP_CONFIG_ROOT.
+ * Optionally scoped to a sub-path (body.path).
+ */
+export declare function getConfigTree(relativePath?: string): Promise<{
+    tree: TreeNode[];
+    summary: TreeSummary;
+    root: string;
+}>;
+export interface ConfigFileContent {
+    path: string;
+    content: string;
+    size: number;
+    modifiedAt: Date | null;
+    active: boolean;
+}
+/**
+ * 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.
+ */
+export declare function readConfigFile(relativePath: string): Promise<ConfigFileContent>;
+/**
+ * Creates a new `.config` file. Throws with status 409 if it already exists.
+ */
+export declare function createConfigFile(relativePath: string, content: string): Promise<void>;
+/**
+ * Overwrites an existing `.config` file and marks the cache entry as stale.
+ * Creates parent directories if they do not exist.
+ */
+export declare function updateConfigFile(relativePath: string, content: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function archiveConfigFile(relativePath: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function unarchiveConfigFile(relativePath: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function renameConfigFile(oldRelativePath: string, newRelativePath: string): Promise<void>;
+//# sourceMappingURL=config.file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.file.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/utils/config.file.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA8BvF;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,CAgB7D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,SAAM,GACjB,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBnE;AAQD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoBrF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB3F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3F;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAiDf"}