@zudojs/config 0.0.1

package/dist/configResolver/accessors/configResolver.accessors.js

@@ -0,0 +1,237 @@
+import { parseConfigBigInt, parseConfigBoolean, parseConfigDate, parseConfigNumber, } from "../../configValue/configValue.core.js";
+import { ConfigResolutionError } from "../core/configResolver.error.js";
+/**
+ * Typed accessor methods for configuration resolution.
+ *
+ * These functions provide type-safe access to configuration values
+ * with optional fallback and type coercion support.
+ */
+export function resolveString(get, key, fallback, strict = true) {
+    const value = get(key);
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value !== "string") {
+        if (strict) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Expected configuration "${key}" to be string.`,
+                    code: "TYPE_MISMATCH",
+                    expected: "string",
+                    received: typeof value,
+                },
+            ]);
+        }
+        return fallback;
+    }
+    return value;
+}
+export function resolveRequiredString(get, key) {
+    const value = resolveString(get, key);
+    if (value === undefined) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Required string configuration "${key}" is missing.`,
+                code: "REQUIRED_STRING",
+            },
+        ]);
+    }
+    return value;
+}
+export function resolveNumber(get, key, fallback, strict = true) {
+    const value = get(key);
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value === "number") {
+        if (Number.isFinite(value)) {
+            return value;
+        }
+    }
+    if (typeof value === "string") {
+        const parsed = parseConfigNumber(value);
+        if (parsed !== undefined) {
+            return parsed;
+        }
+    }
+    if (strict) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Expected configuration "${key}" to be number.`,
+                code: "TYPE_MISMATCH",
+                expected: "number",
+                received: typeof value,
+            },
+        ]);
+    }
+    return fallback;
+}
+export function resolveRequiredNumber(get, key) {
+    const value = resolveNumber(get, key);
+    if (value === undefined) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Required number configuration "${key}" is missing.`,
+                code: "REQUIRED_NUMBER",
+            },
+        ]);
+    }
+    return value;
+}
+export function resolveBoolean(get, key, fallback, strict = true) {
+    const value = 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;
+        }
+    }
+    if (strict) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Expected configuration "${key}" to be boolean.`,
+                code: "TYPE_MISMATCH",
+                expected: "boolean",
+                received: typeof value,
+            },
+        ]);
+    }
+    return fallback;
+}
+export function resolveRequiredBoolean(get, key) {
+    const value = resolveBoolean(get, key);
+    if (value === undefined) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Required boolean configuration "${key}" is missing.`,
+                code: "REQUIRED_BOOLEAN",
+            },
+        ]);
+    }
+    return value;
+}
+export function resolveBigint(get, key, fallback, strict = true) {
+    const value = 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;
+        }
+    }
+    if (strict) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Expected configuration "${key}" to be bigint.`,
+                code: "TYPE_MISMATCH",
+                expected: "bigint",
+                received: typeof value,
+            },
+        ]);
+    }
+    return fallback;
+}
+export function resolveDate(get, key, fallback, strict = true) {
+    const value = 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;
+        }
+    }
+    if (strict) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Expected configuration "${key}" to be date.`,
+                code: "TYPE_MISMATCH",
+                expected: "date",
+                received: typeof value,
+            },
+        ]);
+    }
+    return fallback;
+}
+export function resolveRequiredDate(get, key) {
+    const value = resolveDate(get, key);
+    if (value === undefined) {
+        throw new ConfigResolutionError(key, [
+            {
+                path: key,
+                message: `Required date configuration "${key}" is missing.`,
+                code: "REQUIRED_DATE",
+            },
+        ]);
+    }
+    return value;
+}
+export function resolveObject(get, key, fallback, strict = true) {
+    const value = get(key);
+    if (value === undefined) {
+        return fallback;
+    }
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        value instanceof Date) {
+        if (strict) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Expected configuration "${key}" to be object.`,
+                    code: "TYPE_MISMATCH",
+                    expected: "object",
+                    received: typeof value,
+                },
+            ]);
+        }
+        return fallback;
+    }
+    return value;
+}
+export function resolveArray(get, key, fallback, strict = true) {
+    const value = get(key);
+    if (value === undefined) {
+        return fallback;
+    }
+    if (!Array.isArray(value)) {
+        if (strict) {
+            throw new ConfigResolutionError(key, [
+                {
+                    path: key,
+                    message: `Expected configuration "${key}" to be array.`,
+                    code: "TYPE_MISMATCH",
+                    expected: "array",
+                    received: typeof value,
+                },
+            ]);
+        }
+        return fallback;
+    }
+    return value;
+}
+//# sourceMappingURL=configResolver.accessors.js.map

package/dist/configResolver/accessors/configResolver.accessors.js.map

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

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

@@ -0,0 +1,28 @@
+import type { ConfigValue } from "../../configValue/configValue.core.js";
+import type { ConfigSchema } from "../../configSchema/configSchema.core.js";
+import type { ConfigResolver } from "../core/configResolver.core.js";
+/**
+ * Resolver scoped to a configuration key prefix.
+ */
+export declare class ScopedConfigResolver {
+    private readonly resolver;
+    private readonly prefix;
+    constructor(resolver: ConfigResolver, prefix: string);
+    /**
+     * Resolves a key inside the current scope.
+     */
+    key(key: string): string;
+    get<T extends ConfigValue = ConfigValue>(key: string): T | undefined;
+    required<T extends ConfigValue = ConfigValue>(key: string): T;
+    string(key: string, fallback?: string): string | undefined;
+    number(key: string, fallback?: number): number | undefined;
+    boolean(key: string, fallback?: boolean): boolean | undefined;
+    bigint(key: string, fallback?: bigint): bigint | undefined;
+    date(key: string, fallback?: Date): Date | undefined;
+    object<T extends ConfigValue = ConfigValue>(key: string, fallback?: T): T | undefined;
+    array<T extends ConfigValue = ConfigValue>(key: string, fallback?: readonly T[]): readonly T[] | undefined;
+    resolve<T extends ConfigValue>(key: string, schema: ConfigSchema<T>): T | undefined;
+    pick(keys: readonly string[]): Readonly<Record<string, ConfigValue>>;
+    scoped(prefix: string): ScopedConfigResolver;
+}
+//# sourceMappingURL=configResolver.scoped.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.scoped.d.ts","sourceRoot":"","sources":["../../../src/configResolver/accessors/configResolver.scoped.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAInD;IAED;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvB;IAED,GAAG,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAEnE;IAED,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAE5D;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAE5D;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAEnD;IAED,MAAM,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACxC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,GAAG,SAAS,CAEf;IAED,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACvC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,SAAS,CAAC,EAAE,GACtB,SAAS,CAAC,EAAE,GAAG,SAAS,CAE1B;IAED,OAAO,CAAC,CAAC,SAAS,WAAW,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,CAAC,GAAG,SAAS,CAEf;IAED,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAEnE;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAE3C;CACF"}

package/dist/configResolver/accessors/configResolver.scoped.js

@@ -0,0 +1,54 @@
+/**
+ * Resolver scoped to a configuration key prefix.
+ */
+export class ScopedConfigResolver {
+    resolver;
+    prefix;
+    constructor(resolver, prefix) {
+        this.resolver = resolver;
+        this.prefix = prefix.trim().replace(/\.$/, "");
+    }
+    /**
+     * Resolves a key inside the current scope.
+     */
+    key(key) {
+        return this.prefix ? `${this.prefix}.${key}` : key;
+    }
+    get(key) {
+        return this.resolver.get(this.key(key));
+    }
+    required(key) {
+        return this.resolver.required(this.key(key));
+    }
+    string(key, fallback) {
+        return this.resolver.string(this.key(key), fallback);
+    }
+    number(key, fallback) {
+        return this.resolver.number(this.key(key), fallback);
+    }
+    boolean(key, fallback) {
+        return this.resolver.boolean(this.key(key), fallback);
+    }
+    bigint(key, fallback) {
+        return this.resolver.bigint(this.key(key), fallback);
+    }
+    date(key, fallback) {
+        return this.resolver.date(this.key(key), fallback);
+    }
+    object(key, fallback) {
+        return this.resolver.object(this.key(key), fallback);
+    }
+    array(key, fallback) {
+        return this.resolver.array(this.key(key), fallback);
+    }
+    resolve(key, schema) {
+        return this.resolver.resolve(this.key(key), schema);
+    }
+    pick(keys) {
+        return this.resolver.pick(keys.map((key) => this.key(key)));
+    }
+    scoped(prefix) {
+        return this.resolver.scoped(this.key(prefix));
+    }
+}
+//# sourceMappingURL=configResolver.scoped.js.map

package/dist/configResolver/accessors/configResolver.scoped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.scoped.js","sourceRoot":"","sources":["../../../src/configResolver/accessors/configResolver.scoped.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACd,QAAQ,CAAiB;IAEzB,MAAM,CAAS;IAEhC,YAAY,QAAwB,EAAE,MAAc;QAClD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,CAAC;IAED,GAAG,CAAsC,GAAW;QAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAsC,GAAW;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,QAAiB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,QAAiB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,QAAkB;QACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,QAAiB;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,QAAe;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,CACJ,GAAW,EACX,QAAY;QAEZ,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CACH,GAAW,EACX,QAAuB;QAEvB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CACL,GAAW,EACX,MAAuB;QAEvB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,IAAuB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;CACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configResolver/accessors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC"}

package/dist/configResolver/accessors/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/config/configResolver/accessors
+ *
+ * Configuration accessors and scoped resolver.
+ */
+export * from "./configResolver.accessors.js";
+export * from "./configResolver.scoped.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configResolver/accessors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC"}

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

@@ -0,0 +1,100 @@
+import type { ConfigValue } from "../../configValue/configValue.core.js";
+import type { ConfigSchema } from "../../configSchema/configSchema.core.js";
+import type { ConfigStore } from "../../configStore/configStore.core.js";
+import type { ConfigResolverOptions, ConfigResolutionResult } from "./configResolver.type.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 declare class ConfigResolver {
+    private readonly store;
+    private readonly options;
+    constructor(store: ConfigStore, options?: ConfigResolverOptions);
+    /**
+     * Returns the raw configuration value.
+     */
+    get<T extends ConfigValue = ConfigValue>(key: string): T | undefined;
+    /**
+     * Resolves a value using a schema.
+     */
+    resolve<T extends ConfigValue>(key: string, schema: ConfigSchema<T>): T | undefined;
+    /**
+     * Resolves a value and returns diagnostic information.
+     */
+    resolveResult<T extends ConfigValue>(key: string, schema: ConfigSchema<T>): ConfigResolutionResult<T>;
+    /**
+     * Returns a required configuration value.
+     */
+    required<T extends ConfigValue = ConfigValue>(key: string): T;
+    /**
+     * Returns a string configuration value.
+     */
+    string(key: string, fallback?: string): string | undefined;
+    /**
+     * Returns a required string.
+     */
+    requiredString(key: string): string;
+    /**
+     * Returns a number configuration value.
+     */
+    number(key: string, fallback?: number): number | undefined;
+    /**
+     * Returns a required number.
+     */
+    requiredNumber(key: string): number;
+    /**
+     * Returns a boolean configuration value.
+     */
+    boolean(key: string, fallback?: boolean): boolean | undefined;
+    /**
+     * Returns a required boolean.
+     */
+    requiredBoolean(key: string): boolean;
+    /**
+     * Returns a bigint configuration value.
+     */
+    bigint(key: string, fallback?: bigint): bigint | undefined;
+    /**
+     * Returns a Date configuration value.
+     */
+    date(key: string, fallback?: Date): Date | undefined;
+    /**
+     * Returns a required Date.
+     */
+    requiredDate(key: string): Date;
+    /**
+     * Returns an object configuration value.
+     */
+    object<T extends ConfigValue = ConfigValue>(key: string, fallback?: T): T | undefined;
+    /**
+     * Returns an array configuration value.
+     */
+    array<T extends ConfigValue = ConfigValue>(key: string, fallback?: readonly T[]): readonly T[] | undefined;
+    /**
+     * Resolves a group of configuration keys.
+     */
+    pick(keys: readonly string[]): Readonly<Record<string, ConfigValue>>;
+    /**
+     * Creates a resolver for a nested key prefix.
+     */
+    scoped(prefix: string): ScopedConfigResolver;
+    /**
+     * Returns the underlying store.
+     */
+    getStore(): ConfigStore;
+    private prepareValue;
+    private invalidType;
+}
+import { ConfigurationError } from "@zudojs/errors";
+/**
+ * Error thrown when configuration resolution fails.
+ */
+export declare class ConfigResolutionError extends ConfigurationError {
+    readonly key: string;
+    readonly issues: readonly unknown[];
+    constructor(key: string, issues: readonly unknown[]);
+}
+//# sourceMappingURL=configResolver.core.d.ts.map

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

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