@zudojs/config 0.0.1

package/dist/configResolver/core/configResolver.core.js

@@ -0,0 +1,347 @@
+import { parseConfigBigInt, parseConfigBoolean, parseConfigDate, parseConfigNumber, } from "../../configValue/configValue.core.js";
+import { validateConfigValue } from "../../configSchema/configSchema.core.js";
+import { ScopedConfigResolver } from "../accessors/configResolver.scoped.js";
+/**
+ * Resolves typed configuration values from a ConfigStore.
+ *
+ * This class is intentionally separate from ConfigStore. The store
+ * owns values, while the resolver owns interpretation and validation.
+ */
+export class ConfigResolver {
+    store;
+    options;
+    constructor(store, options = {}) {
+        this.store = store;
+        this.options = {
+            strict: options.strict ?? true,
+            allowUndefined: options.allowUndefined ?? true,
+            clone: options.clone ?? false,
+        };
+    }
+    /**
+     * Returns the raw configuration value.
+     */
+    get(key) {
+        const value = this.store.get(key);
+        return this.prepareValue(value);
+    }
+    /**
+     * Resolves a value using a schema.
+     */
+    resolve(key, schema) {
+        const value = this.store.get(key);
+        const result = validateConfigValue(value, schema, {
+            path: key,
+            root: value,
+        });
+        if (!result.valid && this.options.strict) {
+            throw new ConfigResolutionError(key, result.issues);
+        }
+        if (result.value === undefined && !this.options.allowUndefined) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Configuration value "${key}" is undefined.`,
+                    code: "UNDEFINED_VALUE",
+                },
+            ]);
+        }
+        return this.prepareValue(result.value);
+    }
+    /**
+     * Resolves a value and returns diagnostic information.
+     */
+    resolveResult(key, schema) {
+        const value = this.store.get(key);
+        const result = validateConfigValue(value, schema, {
+            path: key,
+            root: value,
+        });
+        return {
+            key,
+            value: this.prepareValue(result.value),
+            found: value !== undefined,
+            valid: result.valid,
+            issues: result.issues,
+        };
+    }
+    /**
+     * Returns a required configuration value.
+     */
+    required(key) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Required configuration value "${key}" is missing.`,
+                    code: "REQUIRED",
+                },
+            ]);
+        }
+        return this.prepareValue(value);
+    }
+    /**
+     * Returns a string configuration value.
+     */
+    string(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (typeof value !== "string") {
+            return this.invalidType(key, "string", value, fallback);
+        }
+        return value;
+    }
+    /**
+     * Returns a required string.
+     */
+    requiredString(key) {
+        const value = this.string(key);
+        if (value === undefined) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Required string configuration "${key}" is missing.`,
+                    code: "REQUIRED_STRING",
+                },
+            ]);
+        }
+        return value;
+    }
+    /**
+     * Returns a number configuration value.
+     */
+    number(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (typeof value === "number") {
+            if (Number.isFinite(value)) {
+                return value;
+            }
+            return this.invalidType(key, "number", value, fallback);
+        }
+        if (typeof value === "string") {
+            const parsed = parseConfigNumber(value);
+            if (parsed !== undefined) {
+                return parsed;
+            }
+        }
+        return this.invalidType(key, "number", value, fallback);
+    }
+    /**
+     * Returns a required number.
+     */
+    requiredNumber(key) {
+        const value = this.number(key);
+        if (value === undefined) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Required number configuration "${key}" is missing.`,
+                    code: "REQUIRED_NUMBER",
+                },
+            ]);
+        }
+        return value;
+    }
+    /**
+     * Returns a boolean configuration value.
+     */
+    boolean(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (typeof value === "boolean") {
+            return value;
+        }
+        if (typeof value === "string") {
+            const parsed = parseConfigBoolean(value);
+            if (parsed !== undefined) {
+                return parsed;
+            }
+        }
+        return this.invalidType(key, "boolean", value, fallback);
+    }
+    /**
+     * Returns a required boolean.
+     */
+    requiredBoolean(key) {
+        const value = this.boolean(key);
+        if (value === undefined) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Required boolean configuration "${key}" is missing.`,
+                    code: "REQUIRED_BOOLEAN",
+                },
+            ]);
+        }
+        return value;
+    }
+    /**
+     * Returns a bigint configuration value.
+     */
+    bigint(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (typeof value === "bigint") {
+            return value;
+        }
+        if (typeof value === "string") {
+            const parsed = parseConfigBigInt(value);
+            if (parsed !== undefined) {
+                return parsed;
+            }
+        }
+        return this.invalidType(key, "bigint", value, fallback);
+    }
+    /**
+     * Returns a Date configuration value.
+     */
+    date(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (value instanceof Date) {
+            return parseConfigDate(value);
+        }
+        if (typeof value === "string") {
+            const parsed = parseConfigDate(value);
+            if (parsed !== undefined) {
+                return parsed;
+            }
+        }
+        return this.invalidType(key, "date", value, fallback);
+    }
+    /**
+     * Returns a required Date.
+     */
+    requiredDate(key) {
+        const value = this.date(key);
+        if (value === undefined) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Required date configuration "${key}" is missing.`,
+                    code: "REQUIRED_DATE",
+                },
+            ]);
+        }
+        return value;
+    }
+    /**
+     * Returns an object configuration value.
+     */
+    object(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (typeof value !== "object" ||
+            value === null ||
+            Array.isArray(value) ||
+            value instanceof Date) {
+            return this.invalidType(key, "object", value, fallback);
+        }
+        return this.prepareValue(value);
+    }
+    /**
+     * Returns an array configuration value.
+     */
+    array(key, fallback) {
+        const value = this.store.get(key);
+        if (value === undefined) {
+            return fallback;
+        }
+        if (!Array.isArray(value)) {
+            return this.invalidType(key, "array", value, fallback);
+        }
+        return this.prepareValue(value);
+    }
+    /**
+     * Resolves a group of configuration keys.
+     */
+    pick(keys) {
+        const result = {};
+        for (const key of keys) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                result[key] = value;
+            }
+        }
+        return Object.freeze(result);
+    }
+    /**
+     * Creates a resolver for a nested key prefix.
+     */
+    scoped(prefix) {
+        return new ScopedConfigResolver(this, prefix);
+    }
+    /**
+     * Returns the underlying store.
+     */
+    getStore() {
+        return this.store;
+    }
+    prepareValue(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        if (!this.options.clone) {
+            return value;
+        }
+        if (typeof value !== "object" || value === null) {
+            return value;
+        }
+        if (value instanceof Date) {
+            return new Date(value.getTime());
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.prepareValue(item));
+        }
+        const result = {};
+        for (const [key, child] of Object.entries(value)) {
+            result[key] = this.prepareValue(child);
+        }
+        return result;
+    }
+    invalidType(key, expected, received, fallback) {
+        if (this.options.strict) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Expected configuration "${key}" to be ${expected}.`,
+                    code: "TYPE_MISMATCH",
+                    expected,
+                    received: typeof received,
+                },
+            ]);
+        }
+        return fallback;
+    }
+}
+import { ConfigurationError } from "@zudojs/errors";
+/**
+ * Error thrown when configuration resolution fails.
+ */
+export class ConfigResolutionError extends ConfigurationError {
+    key;
+    issues;
+    constructor(key, issues) {
+        super(`Failed to resolve configuration "${key}".`, {
+            configKey: key,
+            component: "ConfigurationResolver",
+        });
+        this.key = key;
+        this.issues = Object.freeze([...issues]);
+    }
+}
+//# sourceMappingURL=configResolver.core.js.map

package/dist/configResolver/core/configResolver.core.js.map

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

package/dist/configResolver/core/configResolver.error.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configResolver/configResolver.error
+ *
+ * Configuration resolution error types.
+ */
+export { ConfigurationError, isConfigurationError } from "@zudojs/errors";
+export { ConfigResolutionError } from "./configResolver.core.js";
+//# sourceMappingURL=configResolver.error.d.ts.map

package/dist/configResolver/core/configResolver.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.error.d.ts","sourceRoot":"","sources":["../../../src/configResolver/core/configResolver.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/configResolver/core/configResolver.error.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configResolver/configResolver.error
+ *
+ * Configuration resolution error types.
+ */
+export { ConfigurationError, isConfigurationError } from "@zudojs/errors";
+export { ConfigResolutionError } from "./configResolver.core.js";
+//# sourceMappingURL=configResolver.error.js.map

package/dist/configResolver/core/configResolver.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.error.js","sourceRoot":"","sources":["../../../src/configResolver/core/configResolver.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/configResolver/core/configResolver.factory.d.ts

@@ -0,0 +1,8 @@
+import type { ConfigStore } from "../../configStore/configStore.core.js";
+import type { ConfigResolverOptions } from "./configResolver.type.js";
+import { ConfigResolver } from "./configResolver.core.js";
+/**
+ * Creates a configuration resolver.
+ */
+export declare function createConfigResolver(store: ConfigStore, options?: ConfigResolverOptions): ConfigResolver;
+//# sourceMappingURL=configResolver.factory.d.ts.map

package/dist/configResolver/core/configResolver.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.factory.d.ts","sourceRoot":"","sources":["../../../src/configResolver/core/configResolver.factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAEhB"}

package/dist/configResolver/core/configResolver.factory.js

@@ -0,0 +1,8 @@
+import { ConfigResolver } from "./configResolver.core.js";
+/**
+ * Creates a configuration resolver.
+ */
+export function createConfigResolver(store, options = {}) {
+    return new ConfigResolver(store, options);
+}
+//# sourceMappingURL=configResolver.factory.js.map

package/dist/configResolver/core/configResolver.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.factory.js","sourceRoot":"","sources":["../../../src/configResolver/core/configResolver.factory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAkB,EAClB,OAAO,GAA0B,EAAE;IAEnC,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/configResolver/core/configResolver.type.d.ts

@@ -0,0 +1,20 @@
+import type { ConfigValue } from "../../configValue/configValue.core.js";
+/**
+ * Options for resolving configuration values.
+ */
+export interface ConfigResolverOptions {
+    readonly strict?: boolean;
+    readonly allowUndefined?: boolean;
+    readonly clone?: boolean;
+}
+/**
+ * Result returned when resolving a configuration value.
+ */
+export interface ConfigResolutionResult<T extends ConfigValue = ConfigValue> {
+    readonly key: string;
+    readonly value: T | undefined;
+    readonly found: boolean;
+    readonly valid: boolean;
+    readonly issues: readonly unknown[];
+}
+//# sourceMappingURL=configResolver.type.d.ts.map

package/dist/configResolver/core/configResolver.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.type.d.ts","sourceRoot":"","sources":["../../../src/configResolver/core/configResolver.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAMzE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC"}

package/dist/configResolver/core/configResolver.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=configResolver.type.js.map

package/dist/configResolver/core/configResolver.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.type.js","sourceRoot":"","sources":["../../../src/configResolver/core/configResolver.type.ts"],"names":[],"mappings":""}

package/dist/configResolver/core/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/config/configResolver/core
+ *
+ * Core resolver implementation, types, factory, and errors.
+ */
+export * from "./configResolver.type.js";
+export * from "./configResolver.core.js";
+export * from "./configResolver.error.js";
+export * from "./configResolver.factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/configResolver/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configResolver/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC"}

package/dist/configResolver/core/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/config/configResolver/core
+ *
+ * Core resolver implementation, types, factory, and errors.
+ */
+export * from "./configResolver.type.js";
+export * from "./configResolver.core.js";
+export * from "./configResolver.error.js";
+export * from "./configResolver.factory.js";
+//# sourceMappingURL=index.js.map

package/dist/configResolver/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configResolver/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC"}

package/dist/configResolver/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configResolver
+ *
+ * Configuration resolution with priority and merging.
+ */
+export * from "./core/index.js";
+export * from "./accessors/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configResolver/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/configResolver/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configResolver
+ *
+ * Configuration resolution with priority and merging.
+ */
+export * from "./core/index.js";
+export * from "./accessors/index.js";
+//# sourceMappingURL=index.js.map

package/dist/configResolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/configResolver/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/configSchema/configSchema.core.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configSchema/configSchema.core
+ *
+ * Re-exports from type and validator modules for backward compatibility.
+ */
+export * from "./configSchema.type.js";
+export * from "./configSchema.validator.js";
+//# sourceMappingURL=configSchema.core.d.ts.map

package/dist/configSchema/configSchema.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchema.core.d.ts","sourceRoot":"","sources":["../../src/configSchema/configSchema.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC"}

package/dist/configSchema/configSchema.core.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configSchema/configSchema.core
+ *
+ * Re-exports from type and validator modules for backward compatibility.
+ */
+export * from "./configSchema.type.js";
+export * from "./configSchema.validator.js";
+//# sourceMappingURL=configSchema.core.js.map

package/dist/configSchema/configSchema.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchema.core.js","sourceRoot":"","sources":["../../src/configSchema/configSchema.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC"}

package/dist/configSchema/configSchema.rules.d.ts

@@ -0,0 +1,18 @@
+import type { ConfigSchema, ConfigValidationContext, ConfigValidationIssue } from "./configSchema.type.js";
+/**
+ * Formats expected schema types.
+ */
+export declare function formatExpectedType(type: import("./configSchema.type.js").ConfigValueType | readonly import("./configSchema.type.js").ConfigValueType[]): string;
+/**
+ * Resolves a schema default.
+ */
+export declare function resolveDefaultValue(schema: ConfigSchema): import("../configValue/configValue.core.js").ConfigValue | undefined;
+/**
+ * Adds custom validation output to the issue list.
+ */
+export declare function appendCustomValidationResult(result: boolean | string | ConfigValidationIssue | readonly ConfigValidationIssue[], path: string, issues: ConfigValidationIssue[]): void;
+/**
+ * Built-in schema validation rules.
+ */
+export declare function validateBuiltInRules(value: unknown, schema: ConfigSchema, context: ConfigValidationContext, issues: ConfigValidationIssue[]): void;
+//# sourceMappingURL=configSchema.rules.d.ts.map

package/dist/configSchema/configSchema.rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchema.rules.d.ts","sourceRoot":"","sources":["../../src/configSchema/configSchema.rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAIZ,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EACA,OAAO,wBAAwB,EAAE,eAAe,GAChD,SAAS,OAAO,wBAAwB,EAAE,eAAe,EAAE,GAC9D,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,GACnB,OAAO,oCAAoC,EAAE,WAAW,GAAG,SAAS,CAUtE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EACJ,OAAO,GAAG,MAAM,GAAG,qBAAqB,GAAG,SAAS,qBAAqB,EAAE,EAC7E,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,qBAAqB,EAAE,GAC9B,IAAI,CA8BN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,qBAAqB,EAAE,GAC9B,IAAI,CAkJN"}