@zudojs/config 0.0.1

package/dist/configManager/configManager.core.js

@@ -0,0 +1,328 @@
+import { cloneConfigValue } from "../configValue/configValue.core.js";
+import { ConfigValueType, validateConfigObject, } from "../configSchema/configSchema.core.js";
+import { createConfigSource } from "../configSource/configSource.core.js";
+import { createConfigLoader } from "../configLoader/configLoader.core.js";
+import { createConfigStore } from "../configStore/configStore.factory.js";
+import { createConfigResolver } from "../configResolver/core/configResolver.factory.js";
+import { ConfigManagerState } from "./configManager.type.js";
+import { ConfigManagerValidationError } from "./configManager.error.js";
+/**
+ * Central configuration lifecycle manager.
+ *
+ * ConfigManager coordinates the store, loader and resolver while
+ * keeping their responsibilities separate.
+ */
+export class ConfigManager {
+    store;
+    loader;
+    resolver;
+    listeners = new Set();
+    state = ConfigManagerState.CREATED;
+    lastLoadedAt;
+    lastError;
+    disposed = false;
+    constructor(options = {}) {
+        this.store =
+            options.store ??
+                createConfigStore({
+                    initialValues: options.initialValues,
+                    freeze: options.freeze ?? true,
+                });
+        this.loader =
+            options.loader ??
+                createConfigLoader({
+                    sources: options.sources,
+                    context: options.context,
+                    store: this.store,
+                    freeze: options.freeze ?? true,
+                });
+        this.resolver = createConfigResolver(this.store, {
+            strict: options.strict ?? true,
+            allowUndefined: options.allowUndefined ?? true,
+            clone: options.clone ?? false,
+        });
+    }
+    /**
+     * Returns the current lifecycle state.
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Returns whether the manager is ready.
+     */
+    get isReady() {
+        return this.state === ConfigManagerState.READY;
+    }
+    /**
+     * Returns whether configuration is currently loading.
+     */
+    get isLoading() {
+        return (this.state === ConfigManagerState.LOADING ||
+            this.state === ConfigManagerState.RELOADING);
+    }
+    /**
+     * Returns the configuration store.
+     */
+    getStore() {
+        this.assertActive();
+        return this.store;
+    }
+    /**
+     * Returns the configuration loader.
+     */
+    getLoader() {
+        this.assertActive();
+        return this.loader;
+    }
+    /**
+     * Returns the configuration resolver.
+     */
+    getResolver() {
+        this.assertActive();
+        return this.resolver;
+    }
+    /**
+     * Returns a scoped resolver.
+     */
+    scoped(prefix) {
+        this.assertActive();
+        return this.resolver.scoped(prefix);
+    }
+    /**
+     * Loads configuration.
+     */
+    async load() {
+        this.assertActive();
+        if (this.isLoading) {
+            throw new Error("Configuration manager is already loading.");
+        }
+        this.setState(ConfigManagerState.LOADING);
+        try {
+            const result = await this.loader.load();
+            this.lastLoadedAt = result.loadedAt;
+            this.lastError = undefined;
+            this.setState(ConfigManagerState.READY);
+            return result;
+        }
+        catch (error) {
+            this.lastError = error;
+            this.setState(ConfigManagerState.FAILED);
+            throw error;
+        }
+    }
+    /**
+     * Reloads configuration.
+     */
+    async reload() {
+        this.assertActive();
+        if (this.isLoading) {
+            throw new Error("Configuration manager is already loading.");
+        }
+        this.setState(ConfigManagerState.RELOADING);
+        try {
+            const result = await this.loader.reload();
+            this.lastLoadedAt = result.loadedAt;
+            this.lastError = undefined;
+            this.setState(ConfigManagerState.READY);
+            return result;
+        }
+        catch (error) {
+            this.lastError = error;
+            this.setState(ConfigManagerState.FAILED);
+            throw error;
+        }
+    }
+    /**
+     * Loads a schema and validates the complete configuration.
+     */
+    validate(schema) {
+        this.assertActive();
+        const result = validateConfigObject(this.store.toObject(), {
+            type: ConfigValueType.OBJECT,
+            properties: schema.properties,
+            additionalProperties: schema.additionalProperties,
+        });
+        if (!result.valid) {
+            throw new ConfigManagerValidationError(result.issues);
+        }
+        return cloneConfigValue(result.value);
+    }
+    /**
+     * Gets a raw configuration value.
+     */
+    get(key) {
+        this.assertActive();
+        return this.resolver.get(key);
+    }
+    /**
+     * Gets a required configuration value.
+     */
+    required(key) {
+        this.assertActive();
+        return this.resolver.required(key);
+    }
+    /**
+     * Gets a configuration value with schema validation.
+     */
+    resolve(key, schema) {
+        this.assertActive();
+        return this.resolver.resolve(key, schema);
+    }
+    /**
+     * Gets a string value.
+     */
+    string(key, fallback) {
+        this.assertActive();
+        return this.resolver.string(key, fallback);
+    }
+    /**
+     * Gets a number value.
+     */
+    number(key, fallback) {
+        this.assertActive();
+        return this.resolver.number(key, fallback);
+    }
+    /**
+     * Gets a boolean value.
+     */
+    boolean(key, fallback) {
+        this.assertActive();
+        return this.resolver.boolean(key, fallback);
+    }
+    /**
+     * Gets a bigint value.
+     */
+    bigint(key, fallback) {
+        this.assertActive();
+        return this.resolver.bigint(key, fallback);
+    }
+    /**
+     * Gets a Date value.
+     */
+    date(key, fallback) {
+        this.assertActive();
+        return this.resolver.date(key, fallback);
+    }
+    /**
+     * Gets an object value.
+     */
+    object(key, fallback) {
+        this.assertActive();
+        return this.resolver.object(key, fallback);
+    }
+    /**
+     * Gets an array value.
+     */
+    array(key, fallback) {
+        this.assertActive();
+        return this.resolver.array(key, fallback);
+    }
+    /**
+     * Sets a runtime configuration value.
+     */
+    set(key, value, options = {}) {
+        this.assertActive();
+        return this.store.set(key, value, {
+            source: options.source ?? "runtime",
+            priority: options.priority ?? Number.MAX_SAFE_INTEGER,
+            sensitive: options.sensitive ?? false,
+        });
+    }
+    /**
+     * Removes a configuration value.
+     */
+    delete(key) {
+        this.assertActive();
+        return this.store.delete(key);
+    }
+    /**
+     * Returns the complete configuration object.
+     */
+    toObject() {
+        this.assertActive();
+        return this.store.toObject();
+    }
+    /**
+     * Returns a manager status snapshot.
+     */
+    getStatus() {
+        return {
+            state: this.state,
+            loaded: this.isReady,
+            loading: this.isLoading,
+            size: this.store.size,
+            lastLoadedAt: this.lastLoadedAt,
+            lastError: this.lastError,
+        };
+    }
+    /**
+     * Subscribes to lifecycle state changes.
+     */
+    subscribe(listener) {
+        this.assertActive();
+        if (typeof listener !== "function") {
+            throw new TypeError("Configuration manager listener must be a function.");
+        }
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * Adds a configuration source.
+     */
+    addSource(source) {
+        this.assertActive();
+        this.loader.addSource(source);
+    }
+    /**
+     * Creates and adds a custom source.
+     */
+    addSourceLoader(name, loader) {
+        this.assertActive();
+        const source = createConfigSource({
+            name,
+        }, loader);
+        this.loader.addSource(source);
+        return source;
+    }
+    /**
+     * Removes a source.
+     */
+    removeSource(name) {
+        this.assertActive();
+        return this.loader.removeSource(name);
+    }
+    /**
+     * Marks the manager as disposed.
+     */
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.listeners.clear();
+        await this.loader.dispose();
+        this.store.dispose();
+        this.state = ConfigManagerState.DISPOSED;
+    }
+    setState(state) {
+        this.state = state;
+        const status = this.getStatus();
+        for (const listener of this.listeners) {
+            try {
+                listener(status);
+            }
+            catch {
+                // State listeners must not interrupt configuration lifecycle.
+            }
+        }
+    }
+    assertActive() {
+        if (this.disposed || this.state === ConfigManagerState.DISPOSED) {
+            throw new Error("ConfigManager has been disposed.");
+        }
+    }
+}
+//# sourceMappingURL=configManager.core.js.map

package/dist/configManager/configManager.core.js.map

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

package/dist/configManager/configManager.error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @zudojs/config/configManager/configManager.error
+ *
+ * ConfigurationManager error types re-exported from @zudojs/errors.
+ */
+import { ConfigurationError, createConfigurationError, isConfigurationError, missingConfigurationError, invalidConfigurationError } from "@zudojs/errors";
+/**
+ * Error thrown when complete configuration validation fails.
+ *
+ * Re-exported as a configuration-specific variant of
+ * the base ConfigurationError from @zudojs/errors.
+ */
+export declare class ConfigManagerValidationError extends ConfigurationError {
+    readonly issues: readonly unknown[];
+    constructor(issues: readonly unknown[]);
+}
+export { ConfigurationError, createConfigurationError, isConfigurationError, missingConfigurationError, invalidConfigurationError, };
+//# sourceMappingURL=configManager.error.d.ts.map

package/dist/configManager/configManager.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.error.d.ts","sourceRoot":"","sources":["../../src/configManager/configManager.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,kBAAkB;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAEpC,YAAY,MAAM,EAAE,SAAS,OAAO,EAAE,EAUrC;CACF;AAED,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAC1B,CAAC"}

package/dist/configManager/configManager.error.js

@@ -0,0 +1,24 @@
+/**
+ * @zudojs/config/configManager/configManager.error
+ *
+ * ConfigurationManager error types re-exported from @zudojs/errors.
+ */
+import { ConfigurationError, createConfigurationError, isConfigurationError, missingConfigurationError, invalidConfigurationError, } from "@zudojs/errors";
+/**
+ * Error thrown when complete configuration validation fails.
+ *
+ * Re-exported as a configuration-specific variant of
+ * the base ConfigurationError from @zudojs/errors.
+ */
+export class ConfigManagerValidationError extends ConfigurationError {
+    issues;
+    constructor(issues) {
+        super(`Configuration validation failed with ${issues.length} issue${issues.length === 1 ? "" : "s"}.`, {
+            configKey: "configuration",
+            component: "ConfigurationManager",
+        });
+        this.issues = Object.freeze([...issues]);
+    }
+}
+export { ConfigurationError, createConfigurationError, isConfigurationError, missingConfigurationError, invalidConfigurationError, };
+//# sourceMappingURL=configManager.error.js.map

package/dist/configManager/configManager.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.error.js","sourceRoot":"","sources":["../../src/configManager/configManager.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,OAAO,4BAA6B,SAAQ,kBAAkB;IACzD,MAAM,CAAqB;IAEpC,YAAY,MAA0B;QACpC,KAAK,CACH,wCAAwC,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAC/F;YACE,SAAS,EAAE,eAAe;YAC1B,SAAS,EAAE,sBAAsB;SAClC,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,GAC1B,CAAC"}

package/dist/configManager/configManager.factory.d.ts

@@ -0,0 +1,11 @@
+import type { ConfigManagerOptions } from "./configManager.type.js";
+import { ConfigManager } from "./configManager.core.js";
+/**
+ * Creates a configuration manager.
+ */
+export declare function createConfigManager(options?: ConfigManagerOptions): ConfigManager;
+/**
+ * Creates a manager and loads configuration immediately.
+ */
+export declare function initializeConfigManager(options?: ConfigManagerOptions): Promise<ConfigManager>;
+//# sourceMappingURL=configManager.factory.d.ts.map

package/dist/configManager/configManager.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.factory.d.ts","sourceRoot":"","sources":["../../src/configManager/configManager.factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAEf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAYxB"}

package/dist/configManager/configManager.factory.js

@@ -0,0 +1,22 @@
+import { ConfigManager } from "./configManager.core.js";
+/**
+ * Creates a configuration manager.
+ */
+export function createConfigManager(options = {}) {
+    return new ConfigManager(options);
+}
+/**
+ * Creates a manager and loads configuration immediately.
+ */
+export async function initializeConfigManager(options = {}) {
+    const manager = createConfigManager(options);
+    try {
+        await manager.load();
+        return manager;
+    }
+    catch (error) {
+        await manager.dispose();
+        throw error;
+    }
+}
+//# sourceMappingURL=configManager.factory.js.map

package/dist/configManager/configManager.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.factory.js","sourceRoot":"","sources":["../../src/configManager/configManager.factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAAyB,EAAE;IAElC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAO,GAAyB,EAAE;IAElC,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QAErB,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAExB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/configManager/configManager.type.d.ts

@@ -0,0 +1,48 @@
+import type { ConfigValue } from "../configValue/configValue.core.js";
+import type { ConfigSource } from "../configSource/configSource.core.js";
+import type { ConfigLoader } from "../configLoader/configLoader.core.js";
+import type { ConfigStore } from "../configStore/configStore.core.js";
+import type { ConfigResolverOptions } from "../configResolver/core/configResolver.type.js";
+/**
+ * Configuration manager lifecycle state.
+ */
+export declare enum ConfigManagerState {
+    CREATED = "created",
+    LOADING = "loading",
+    READY = "ready",
+    RELOADING = "reloading",
+    FAILED = "failed",
+    DISPOSED = "disposed"
+}
+/**
+ * Configuration manager options.
+ */
+export interface ConfigManagerOptions extends ConfigResolverOptions {
+    readonly sources?: readonly ConfigSource[];
+    readonly initialValues?: Readonly<Record<string, ConfigValue>>;
+    readonly store?: ConfigStore;
+    readonly loader?: ConfigLoader;
+    readonly freeze?: boolean;
+    readonly autoLoad?: boolean;
+    readonly context?: {
+        readonly environment?: string;
+        readonly namespace?: string;
+        readonly signal?: AbortSignal;
+    };
+}
+/**
+ * Configuration manager status.
+ */
+export interface ConfigManagerStatus {
+    readonly state: ConfigManagerState;
+    readonly loaded: boolean;
+    readonly loading: boolean;
+    readonly size: number;
+    readonly lastLoadedAt?: number;
+    readonly lastError?: unknown;
+}
+/**
+ * Listener for configuration manager state changes.
+ */
+export type ConfigManagerListener = (status: ConfigManagerStatus) => void;
+//# sourceMappingURL=configManager.type.d.ts.map

package/dist/configManager/configManager.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.type.d.ts","sourceRoot":"","sources":["../../src/configManager/configManager.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAE3F;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAE3C,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAE/D,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAE7B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAE/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC"}

package/dist/configManager/configManager.type.js

@@ -0,0 +1,13 @@
+/**
+ * Configuration manager lifecycle state.
+ */
+export var ConfigManagerState;
+(function (ConfigManagerState) {
+    ConfigManagerState["CREATED"] = "created";
+    ConfigManagerState["LOADING"] = "loading";
+    ConfigManagerState["READY"] = "ready";
+    ConfigManagerState["RELOADING"] = "reloading";
+    ConfigManagerState["FAILED"] = "failed";
+    ConfigManagerState["DISPOSED"] = "disposed";
+})(ConfigManagerState || (ConfigManagerState = {}));
+//# sourceMappingURL=configManager.type.js.map

package/dist/configManager/configManager.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configManager.type.js","sourceRoot":"","sources":["../../src/configManager/configManager.type.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;AACvB,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B"}

package/dist/configManager/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/config/configManager
+ *
+ * Configuration lifecycle management and orchestration.
+ */
+export * from "./configManager.type.js";
+export * from "./configManager.core.js";
+export * from "./configManager.error.js";
+export * from "./configManager.factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/configManager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configManager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/configManager/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/config/configManager
+ *
+ * Configuration lifecycle management and orchestration.
+ */
+export * from "./configManager.type.js";
+export * from "./configManager.core.js";
+export * from "./configManager.error.js";
+export * from "./configManager.factory.js";
+//# sourceMappingURL=index.js.map

package/dist/configManager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configManager/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC"}

package/dist/configResolver/accessors/configResolver.accessors.d.ts

@@ -0,0 +1,19 @@
+import type { ConfigValue } from "../../configValue/configValue.core.js";
+/**
+ * Typed accessor methods for configuration resolution.
+ *
+ * These functions provide type-safe access to configuration values
+ * with optional fallback and type coercion support.
+ */
+export declare function resolveString(get: (key: string) => ConfigValue | undefined, key: string, fallback?: string, strict?: boolean): string | undefined;
+export declare function resolveRequiredString(get: (key: string) => ConfigValue | undefined, key: string): string;
+export declare function resolveNumber(get: (key: string) => ConfigValue | undefined, key: string, fallback?: number, strict?: boolean): number | undefined;
+export declare function resolveRequiredNumber(get: (key: string) => ConfigValue | undefined, key: string): number;
+export declare function resolveBoolean(get: (key: string) => ConfigValue | undefined, key: string, fallback?: boolean, strict?: boolean): boolean | undefined;
+export declare function resolveRequiredBoolean(get: (key: string) => ConfigValue | undefined, key: string): boolean;
+export declare function resolveBigint(get: (key: string) => ConfigValue | undefined, key: string, fallback?: bigint, strict?: boolean): bigint | undefined;
+export declare function resolveDate(get: (key: string) => ConfigValue | undefined, key: string, fallback?: Date, strict?: boolean): Date | undefined;
+export declare function resolveRequiredDate(get: (key: string) => ConfigValue | undefined, key: string): Date;
+export declare function resolveObject<T extends ConfigValue = ConfigValue>(get: (key: string) => ConfigValue | undefined, key: string, fallback?: T, strict?: boolean): T | undefined;
+export declare function resolveArray<T extends ConfigValue = ConfigValue>(get: (key: string) => ConfigValue | undefined, key: string, fallback?: readonly T[], strict?: boolean): readonly T[] | undefined;
+//# sourceMappingURL=configResolver.accessors.d.ts.map

package/dist/configResolver/accessors/configResolver.accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.accessors.d.ts","sourceRoot":"","sources":["../../../src/configResolver/accessors/configResolver.accessors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAWzE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,UAAO,GACZ,MAAM,GAAG,SAAS,CAuBpB;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,GACV,MAAM,CAcR;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,UAAO,GACZ,MAAM,GAAG,SAAS,CAiCpB;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,GACV,MAAM,CAcR;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,OAAO,EAClB,MAAM,UAAO,GACZ,OAAO,GAAG,SAAS,CA+BrB;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,GACV,OAAO,CAcT;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,UAAO,GACZ,MAAM,GAAG,SAAS,CA+BpB;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,IAAI,EACf,MAAM,UAAO,GACZ,IAAI,GAAG,SAAS,CA+BlB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,GACV,IAAI,CAcN;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC/D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,CAAC,EACZ,MAAM,UAAO,GACZ,CAAC,GAAG,SAAS,CA4Bf;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,EAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,SAAS,CAAC,EAAE,EACvB,MAAM,UAAO,GACZ,SAAS,CAAC,EAAE,GAAG,SAAS,CAuB1B"}