@zudojs/config 0.0.1

package/dist/configLoader/configLoader.core.js

@@ -0,0 +1,292 @@
+import { cloneConfigValue } from "../configValue/configValue.core.js";
+import { createConfigEntry } from "../configEntry/configEntry.type.js";
+import { loadConfigSources, sortConfigSources, } from "../configSource/configSource.core.js";
+import { createConfigStore } from "../configStore/configStore.factory.js";
+/**
+ * Configuration loader.
+ *
+ * Sources are loaded in priority order and their values are resolved
+ * into a single ConfigStore. Higher-priority sources win.
+ */
+export class ConfigLoader {
+    sources;
+    context;
+    store;
+    onSourceLoaded;
+    onSourceError;
+    clearStore;
+    loading = false;
+    loaded = false;
+    disposed = false;
+    lastResult;
+    constructor(options = {}) {
+        this.sources = [...(options.sources ?? [])];
+        this.context = options.context ?? {};
+        this.store =
+            options.store ??
+                createConfigStore({
+                    freeze: options.freeze ?? true,
+                });
+        this.onSourceLoaded = options.onSourceLoaded;
+        this.onSourceError = options.onSourceError;
+        this.clearStore = options.clearStore ?? true;
+    }
+    /**
+     * Returns the underlying configuration store.
+     */
+    getStore() {
+        this.assertActive();
+        return this.store;
+    }
+    /**
+     * Returns the configured sources.
+     */
+    getSources() {
+        this.assertActive();
+        return [...this.sources];
+    }
+    /**
+     * Returns whether configuration has been loaded.
+     */
+    get isLoaded() {
+        return this.loaded && !this.disposed;
+    }
+    /**
+     * Returns whether configuration is currently loading.
+     */
+    get isLoading() {
+        return this.loading;
+    }
+    /**
+     * Returns the previous load result.
+     */
+    get lastLoadResult() {
+        return this.lastResult;
+    }
+    /**
+     * Loads all configured sources.
+     */
+    async load() {
+        this.assertActive();
+        if (this.loading) {
+            throw new Error("Configuration is already being loaded.");
+        }
+        this.loading = true;
+        try {
+            if (this.clearStore) {
+                this.store.clear();
+            }
+            const sortedSources = sortConfigSources(this.sources);
+            const results = [];
+            for (const source of sortedSources) {
+                try {
+                    const result = await loadSingleSource(source, this.context);
+                    if (!result) {
+                        continue;
+                    }
+                    results.push(result);
+                    this.applySource(source, result);
+                    if (this.onSourceLoaded) {
+                        await this.onSourceLoaded(source, result);
+                    }
+                }
+                catch (error) {
+                    if (this.onSourceError) {
+                        await this.onSourceError(source, error);
+                    }
+                    if (!source.optional) {
+                        throw error;
+                    }
+                }
+            }
+            const result = {
+                store: this.store,
+                entries: this.store.getEntries(),
+                sources: results,
+                loadedAt: Date.now(),
+            };
+            this.lastResult = result;
+            this.loaded = true;
+            return result;
+        }
+        finally {
+            this.loading = false;
+        }
+    }
+    /**
+     * Reloads configuration.
+     *
+     * The current store is replaced with freshly loaded values.
+     */
+    async reload() {
+        this.assertActive();
+        this.loaded = false;
+        return this.load();
+    }
+    /**
+     * Loads only selected sources.
+     */
+    async loadSources(sources) {
+        this.assertActive();
+        const temporaryLoader = new ConfigLoader({
+            sources,
+            context: this.context,
+            store: this.store,
+            clearStore: this.clearStore,
+        });
+        const result = await temporaryLoader.load();
+        temporaryLoader.detach();
+        return result;
+    }
+    /**
+     * Adds a source to the loader.
+     */
+    addSource(source) {
+        this.assertActive();
+        if (this.sources.some((existing) => existing.name === source.name)) {
+            throw new Error(`Configuration source "${source.name}" is already registered.`);
+        }
+        this.sources.push(source);
+    }
+    /**
+     * Removes a source by name.
+     */
+    removeSource(name) {
+        this.assertActive();
+        const index = this.sources.findIndex((source) => source.name === name);
+        if (index === -1) {
+            return false;
+        }
+        this.sources.splice(index, 1);
+        return true;
+    }
+    /**
+     * Finds a source by name.
+     */
+    getSource(name) {
+        this.assertActive();
+        return this.sources.find((source) => source.name === name);
+    }
+    /**
+     * Disposes the loader and its source resources.
+     */
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.loaded = false;
+        for (const source of this.sources) {
+            if (!source.close) {
+                continue;
+            }
+            try {
+                await source.close();
+            }
+            catch {
+                // Continue closing remaining sources.
+            }
+        }
+        this.sources.length = 0;
+        this.lastResult = undefined;
+    }
+    /**
+     * Detaches this loader from its source lifecycle.
+     *
+     * Useful for temporary loaders sharing an existing store.
+     */
+    detach() {
+        this.sources.length = 0;
+        this.lastResult = undefined;
+        this.disposed = true;
+    }
+    /**
+     * Applies one source to the configuration store.
+     *
+     * Sources are processed from highest to lowest priority. Existing
+     * values are therefore retained when a lower-priority source
+     * attempts to replace them.
+     */
+    applySource(source, result) {
+        const priority = source.priority;
+        for (const [key, value] of Object.entries(result.values)) {
+            const existing = this.store.getEntry(key);
+            if (existing && existing.priority > priority) {
+                continue;
+            }
+            this.store.set(key, cloneConfigValue(value), {
+                source: source.name,
+                sourceType: source.type,
+                priority,
+                sensitive: existing?.sensitive ?? false,
+                resolved: true,
+            });
+        }
+    }
+    assertActive() {
+        if (this.disposed) {
+            throw new Error("ConfigLoader has been disposed.");
+        }
+    }
+}
+/**
+ * Loads one source while preserving the source lifecycle contract.
+ */
+async function loadSingleSource(source, context) {
+    if (source.isAvailable) {
+        const available = await source.isAvailable(context);
+        if (!available) {
+            if (source.optional) {
+                return undefined;
+            }
+            throw new Error(`Configuration source "${source.name}" is unavailable.`);
+        }
+    }
+    const result = await source.load(context);
+    if (!result || typeof result !== "object") {
+        throw new Error(`Configuration source "${source.name}" returned an invalid result.`);
+    }
+    return result;
+}
+/**
+ * Creates a configuration loader.
+ */
+export function createConfigLoader(options = {}) {
+    return new ConfigLoader(options);
+}
+/**
+ * Loads configuration directly from a collection of sources.
+ */
+export async function loadConfiguration(sources, options = {}) {
+    const loader = createConfigLoader({
+        ...options,
+        sources,
+    });
+    try {
+        return await loader.load();
+    }
+    finally {
+        await loader.dispose();
+    }
+}
+/**
+ * Converts loaded source results into configuration entries.
+ */
+export function sourceResultsToEntries(results, sources) {
+    const sourceMap = new Map(sources.map((source) => [source.name, source]));
+    const entries = [];
+    for (const result of results) {
+        const source = sourceMap.get(result.source);
+        for (const [key, value] of Object.entries(result.values)) {
+            entries.push(createConfigEntry({
+                key,
+                value,
+                source: result.source,
+                sourceType: result.type,
+                priority: source?.priority ?? 0,
+            }));
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=configLoader.core.js.map

package/dist/configLoader/configLoader.core.js.map

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

package/dist/configLoader/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/config/configLoader
+ *
+ * Configuration loading from sources and caching.
+ */
+export * from "./configLoader.core.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/configLoader/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/config/configLoader
+ *
+ * Configuration loading from sources and caching.
+ */
+export * from "./configLoader.core.js";
+//# sourceMappingURL=index.js.map

package/dist/configLoader/index.js.map

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

package/dist/configManager/configManager.core.d.ts

@@ -0,0 +1,165 @@
+import type { ConfigValue } from "../configValue/configValue.core.js";
+import type { ConfigSchema } from "../configSchema/configSchema.core.js";
+import type { ConfigSource } from "../configSource/configSource.core.js";
+import type { ConfigEntry } from "../configEntry/configEntry.type.js";
+import type { ConfigLoader, ConfigLoadResult } from "../configLoader/configLoader.core.js";
+import type { ConfigStore } from "../configStore/configStore.core.js";
+import type { ConfigResolver } from "../configResolver/core/configResolver.core.js";
+import type { ScopedConfigResolver } from "../configResolver/accessors/configResolver.scoped.js";
+import type { ConfigManagerOptions, ConfigManagerStatus, ConfigManagerListener } from "./configManager.type.js";
+import { ConfigManagerState } from "./configManager.type.js";
+/**
+ * Central configuration lifecycle manager.
+ *
+ * ConfigManager coordinates the store, loader and resolver while
+ * keeping their responsibilities separate.
+ */
+export declare class ConfigManager {
+    private readonly store;
+    private readonly loader;
+    private readonly resolver;
+    private readonly listeners;
+    private state;
+    private lastLoadedAt?;
+    private lastError?;
+    private disposed;
+    constructor(options?: ConfigManagerOptions);
+    /**
+     * Returns the current lifecycle state.
+     */
+    getState(): ConfigManagerState;
+    /**
+     * Returns whether the manager is ready.
+     */
+    get isReady(): boolean;
+    /**
+     * Returns whether configuration is currently loading.
+     */
+    get isLoading(): boolean;
+    /**
+     * Returns the configuration store.
+     */
+    getStore(): ConfigStore;
+    /**
+     * Returns the configuration loader.
+     */
+    getLoader(): ConfigLoader;
+    /**
+     * Returns the configuration resolver.
+     */
+    getResolver(): ConfigResolver;
+    /**
+     * Returns a scoped resolver.
+     */
+    scoped(prefix: string): ScopedConfigResolver;
+    /**
+     * Loads configuration.
+     */
+    load(): Promise<ConfigLoadResult>;
+    /**
+     * Reloads configuration.
+     */
+    reload(): Promise<ConfigLoadResult>;
+    /**
+     * Loads a schema and validates the complete configuration.
+     */
+    validate<T extends ConfigValue>(schema: {
+        readonly properties: Readonly<Record<string, ConfigSchema>>;
+        readonly additionalProperties?: boolean | ConfigSchema;
+    }): T;
+    /**
+     * Gets a raw configuration value.
+     */
+    get<T extends ConfigValue = ConfigValue>(key: string): T | undefined;
+    /**
+     * Gets a required configuration value.
+     */
+    required<T extends ConfigValue = ConfigValue>(key: string): T;
+    /**
+     * Gets a configuration value with schema validation.
+     */
+    resolve<T extends ConfigValue>(key: string, schema: ConfigSchema<T>): T | undefined;
+    /**
+     * Gets a string value.
+     */
+    string(key: string, fallback?: string): string | undefined;
+    /**
+     * Gets a number value.
+     */
+    number(key: string, fallback?: number): number | undefined;
+    /**
+     * Gets a boolean value.
+     */
+    boolean(key: string, fallback?: boolean): boolean | undefined;
+    /**
+     * Gets a bigint value.
+     */
+    bigint(key: string, fallback?: bigint): bigint | undefined;
+    /**
+     * Gets a Date value.
+     */
+    date(key: string, fallback?: Date): Date | undefined;
+    /**
+     * Gets an object value.
+     */
+    object<T extends ConfigValue = ConfigValue>(key: string, fallback?: T): T | undefined;
+    /**
+     * Gets an array value.
+     */
+    array<T extends ConfigValue = ConfigValue>(key: string, fallback?: readonly T[]): readonly T[] | undefined;
+    /**
+     * Sets a runtime configuration value.
+     */
+    set<T extends ConfigValue>(key: string, value: T, options?: {
+        readonly source?: string;
+        readonly priority?: number;
+        readonly sensitive?: boolean;
+    }): ConfigEntry<T>;
+    /**
+     * Removes a configuration value.
+     */
+    delete(key: string): boolean;
+    /**
+     * Returns the complete configuration object.
+     */
+    toObject(): Readonly<Record<string, ConfigValue>>;
+    /**
+     * Returns a manager status snapshot.
+     */
+    getStatus(): ConfigManagerStatus;
+    /**
+     * Subscribes to lifecycle state changes.
+     */
+    subscribe(listener: ConfigManagerListener): () => void;
+    /**
+     * Adds a configuration source.
+     */
+    addSource(source: ConfigSource): void;
+    /**
+     * Creates and adds a custom source.
+     */
+    addSourceLoader(name: string, loader: (context: {
+        readonly environment?: string;
+        readonly namespace?: string;
+        readonly signal?: AbortSignal;
+    }) => {
+        readonly values: Readonly<Record<string, ConfigValue>>;
+        readonly source: string;
+        readonly type: import("../configSource/configSource.core.js").ConfigSourceType;
+    } | Promise<{
+        readonly values: Readonly<Record<string, ConfigValue>>;
+        readonly source: string;
+        readonly type: import("../configSource/configSource.core.js").ConfigSourceType;
+    }>): ConfigSource;
+    /**
+     * Removes a source.
+     */
+    removeSource(name: string): boolean;
+    /**
+     * Marks the manager as disposed.
+     */
+    dispose(): Promise<void>;
+    private setState;
+    private assertActive;
+}
+//# sourceMappingURL=configManager.core.d.ts.map

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

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