@zudojs/config 0.0.1

package/dist/configEntry/configEntry.type.js

@@ -0,0 +1,149 @@
+/**
+ * Creates a configuration entry.
+ */
+export function createConfigEntry(options) {
+    const key = options.key.trim();
+    if (key.length === 0) {
+        throw new TypeError("Configuration entry key cannot be empty.");
+    }
+    return Object.freeze({
+        key,
+        value: options.value,
+        source: options.source ?? "unknown",
+        sourceType: options.sourceType ?? "custom",
+        priority: options.priority ?? 0,
+        sensitive: options.sensitive ?? false,
+        resolved: options.resolved ?? true,
+        createdAt: options.createdAt ?? Date.now(),
+    });
+}
+/**
+ * Creates an entry from another entry while replacing its value.
+ */
+export function updateConfigEntry(entry, value) {
+    return createConfigEntry({
+        key: entry.key,
+        value,
+        source: entry.source,
+        sourceType: entry.sourceType,
+        priority: entry.priority,
+        sensitive: entry.sensitive,
+        resolved: entry.resolved,
+        createdAt: entry.createdAt,
+    });
+}
+/**
+ * Checks whether a value is a valid configuration entry.
+ */
+export function isConfigEntry(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const entry = value;
+    return (typeof entry.key === "string" &&
+        entry.key.length > 0 &&
+        "value" in entry &&
+        typeof entry.source === "string" &&
+        typeof entry.sourceType === "string" &&
+        typeof entry.priority === "number" &&
+        typeof entry.sensitive === "boolean" &&
+        typeof entry.resolved === "boolean" &&
+        typeof entry.createdAt === "number");
+}
+/**
+ * Masks a sensitive configuration value.
+ */
+export function redactConfigValue(value, replacement = "[REDACTED]") {
+    if (value === undefined || value === null || typeof value !== "object") {
+        return replacement;
+    }
+    if (value instanceof Date) {
+        return replacement;
+    }
+    if (Array.isArray(value)) {
+        return value.map(() => replacement);
+    }
+    return replacement;
+}
+/**
+ * Creates a safe representation of an entry for logging or
+ * diagnostics.
+ *
+ * Sensitive values are never returned in clear text.
+ */
+export function toSafeConfigEntry(entry) {
+    if (!entry.sensitive) {
+        return entry;
+    }
+    return createConfigEntry({
+        key: entry.key,
+        value: redactConfigValue(entry.value),
+        source: entry.source,
+        sourceType: entry.sourceType,
+        priority: entry.priority,
+        sensitive: true,
+        resolved: entry.resolved,
+        createdAt: entry.createdAt,
+    });
+}
+/**
+ * Converts an entry into a plain serializable object.
+ */
+export function serializeConfigEntry(entry) {
+    const safeEntry = toSafeConfigEntry(entry);
+    return {
+        key: safeEntry.key,
+        value: safeEntry.value,
+        source: safeEntry.source,
+        sourceType: safeEntry.sourceType,
+        priority: safeEntry.priority,
+        sensitive: safeEntry.sensitive,
+        resolved: safeEntry.resolved,
+        createdAt: safeEntry.createdAt,
+    };
+}
+/**
+ * Creates a copy of an entry with a different source.
+ */
+export function withConfigEntrySource(entry, source, sourceType, priority = entry.priority) {
+    return createConfigEntry({
+        key: entry.key,
+        value: entry.value,
+        source,
+        sourceType,
+        priority,
+        sensitive: entry.sensitive,
+        resolved: entry.resolved,
+        createdAt: entry.createdAt,
+    });
+}
+/**
+ * Compares two configuration entries.
+ *
+ * Source metadata is included in the comparison because two entries
+ * with the same value can still represent different configuration
+ * states.
+ */
+export function configEntriesEqual(left, right) {
+    return (left.key === right.key &&
+        left.source === right.source &&
+        left.sourceType === right.sourceType &&
+        left.priority === right.priority &&
+        left.sensitive === right.sensitive &&
+        left.resolved === right.resolved &&
+        left.createdAt === right.createdAt &&
+        Object.is(left.value, right.value));
+}
+/**
+ * Sorts configuration entries by key and then priority.
+ */
+export function sortConfigEntries(entries) {
+    return [...entries].sort((left, right) => {
+        const keyComparison = left.key.localeCompare(right.key);
+        if (keyComparison !== 0) {
+            return keyComparison;
+        }
+        return right.priority - left.priority;
+    });
+}
+//# sourceMappingURL=configEntry.type.js.map

package/dist/configEntry/configEntry.type.js.map

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

package/dist/configEntry/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/config/configEntry
+ *
+ * Configuration entry types and value definitions.
+ */
+export * from "./configEntry.type.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/configEntry/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/config/configEntry
+ *
+ * Configuration entry types and value definitions.
+ */
+export * from "./configEntry.type.js";
+//# sourceMappingURL=index.js.map

package/dist/configEntry/index.js.map

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

package/dist/configFactory/configFactory.core.d.ts

@@ -0,0 +1,54 @@
+import type { ConfigValue } from "../configValue/configValue.core.js";
+import type { ConfigSchema } from "../configSchema/configSchema.type.js";
+import type { ConfigSource } from "../configSource/configSource.core.js";
+import type { ConfigStore } from "../configStore/configStore.core.js";
+import type { ConfigManagerOptions } from "../configManager/configManager.type.js";
+import type { ConfigManager } from "../configManager/configManager.core.js";
+/**
+ * Factory options for creating a configuration manager.
+ */
+export interface ConfigFactoryOptions extends ConfigManagerOptions {
+    readonly name?: string;
+}
+/**
+ * Creates a configuration manager without loading it.
+ */
+export declare function createConfiguration(options?: ConfigFactoryOptions): ConfigManager;
+/**
+ * Creates and initializes a configuration manager.
+ */
+export declare function createInitializedConfiguration(options?: ConfigFactoryOptions): Promise<ConfigManager>;
+/**
+ * Creates a configuration manager from initial values.
+ */
+export declare function createConfigurationFromValues(values: Readonly<Record<string, ConfigValue>>, options?: Omit<ConfigFactoryOptions, "initialValues">): ConfigManager;
+/**
+ * Creates a configuration manager from sources.
+ */
+export declare function createConfigurationFromSources(sources: readonly ConfigSource[], options?: Omit<ConfigFactoryOptions, "sources">): ConfigManager;
+/**
+ * Creates a configuration manager from an existing store.
+ */
+export declare function createConfigurationFromStore(store: ConfigStore, options?: Omit<ConfigFactoryOptions, "store">): ConfigManager;
+/**
+ * Creates a configuration manager and validates it against a schema.
+ */
+export declare function createValidatedConfiguration<T extends ConfigValue = ConfigValue>(schema: {
+    readonly properties: Readonly<Record<string, ConfigSchema>>;
+    readonly additionalProperties?: boolean | ConfigSchema;
+}, options?: ConfigFactoryOptions): Promise<{
+    readonly manager: ConfigManager;
+    readonly config: T;
+}>;
+/**
+ * Factory object for dependency injection and application bootstrap.
+ */
+export declare const configFactory: Readonly<{
+    create: typeof createConfiguration;
+    initialize: typeof createInitializedConfiguration;
+    fromValues: typeof createConfigurationFromValues;
+    fromSources: typeof createConfigurationFromSources;
+    fromStore: typeof createConfigurationFromStore;
+    validated: typeof createValidatedConfiguration;
+}>;
+//# sourceMappingURL=configFactory.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configFactory.core.d.ts","sourceRoot":"","sources":["../../src/configFactory/configFactory.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAO5E;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAEf;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAExB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAC7C,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,eAAe,CAAM,GACxD,aAAa,CAKf;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAM,GAClD,aAAa,CAKf;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAM,GAChD,aAAa,CAKf;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,CAAC,SAAS,WAAW,GAAG,WAAW,EAEnC,MAAM,EAAE;IACN,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;CACxD,EACD,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC;IACT,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB,CAAC,CAeD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;EAYxB,CAAC"}

package/dist/configFactory/configFactory.core.js

@@ -0,0 +1,69 @@
+import { createConfigManager, initializeConfigManager, } from "../configManager/configManager.factory.js";
+/**
+ * Creates a configuration manager without loading it.
+ */
+export function createConfiguration(options = {}) {
+    return createConfigManager(options);
+}
+/**
+ * Creates and initializes a configuration manager.
+ */
+export async function createInitializedConfiguration(options = {}) {
+    return initializeConfigManager(options);
+}
+/**
+ * Creates a configuration manager from initial values.
+ */
+export function createConfigurationFromValues(values, options = {}) {
+    return createConfigManager({
+        ...options,
+        initialValues: values,
+    });
+}
+/**
+ * Creates a configuration manager from sources.
+ */
+export function createConfigurationFromSources(sources, options = {}) {
+    return createConfigManager({
+        ...options,
+        sources,
+    });
+}
+/**
+ * Creates a configuration manager from an existing store.
+ */
+export function createConfigurationFromStore(store, options = {}) {
+    return createConfigManager({
+        ...options,
+        store,
+    });
+}
+/**
+ * Creates a configuration manager and validates it against a schema.
+ */
+export async function createValidatedConfiguration(schema, options = {}) {
+    const manager = await createInitializedConfiguration(options);
+    try {
+        const config = manager.validate(schema);
+        return {
+            manager,
+            config,
+        };
+    }
+    catch (error) {
+        await manager.dispose();
+        throw error;
+    }
+}
+/**
+ * Factory object for dependency injection and application bootstrap.
+ */
+export const configFactory = Object.freeze({
+    create: createConfiguration,
+    initialize: createInitializedConfiguration,
+    fromValues: createConfigurationFromValues,
+    fromSources: createConfigurationFromSources,
+    fromStore: createConfigurationFromStore,
+    validated: createValidatedConfiguration,
+});
+//# sourceMappingURL=configFactory.core.js.map

package/dist/configFactory/configFactory.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFactory.core.js","sourceRoot":"","sources":["../../src/configFactory/configFactory.core.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,2CAA2C,CAAC;AASnD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAAyB,EAAE;IAElC,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAAO,GAAyB,EAAE;IAElC,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAA6C,EAC7C,OAAO,GAAgD,EAAE;IAEzD,OAAO,mBAAmB,CAAC;QACzB,GAAG,OAAO;QACV,aAAa,EAAE,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAgC,EAChC,OAAO,GAA0C,EAAE;IAEnD,OAAO,mBAAmB,CAAC;QACzB,GAAG,OAAO;QACV,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAkB,EAClB,OAAO,GAAwC,EAAE;IAEjD,OAAO,mBAAmB,CAAC;QACzB,GAAG,OAAO;QACV,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAGhD,MAGC,EACD,OAAO,GAAyB,EAAE;IAKlC,MAAM,OAAO,GAAG,MAAM,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAI,MAAM,CAAC,CAAC;QAE3C,OAAO;YACL,OAAO;YACP,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAExB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,mBAAmB;IAE3B,UAAU,EAAE,8BAA8B;IAE1C,UAAU,EAAE,6BAA6B;IAEzC,WAAW,EAAE,8BAA8B;IAE3C,SAAS,EAAE,4BAA4B;IAEvC,SAAS,EAAE,4BAA4B;CACxC,CAAC,CAAC"}

package/dist/configFactory/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/config/configFactory
+ *
+ * Factory functions for creating configuration instances.
+ */
+export * from "./configFactory.core.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/configFactory/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/config/configFactory
+ *
+ * Factory functions for creating configuration instances.
+ */
+export * from "./configFactory.core.js";
+//# sourceMappingURL=index.js.map

package/dist/configFactory/index.js.map

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

package/dist/configLoader/configLoader.core.d.ts

@@ -0,0 +1,121 @@
+import type { ConfigEntry } from "../configEntry/configEntry.type.js";
+import type { ConfigSource, ConfigSourceContext, ConfigSourceResult } from "../configSource/configSource.core.js";
+import type { ConfigStore } from "../configStore/configStore.core.js";
+/**
+ * Options controlling configuration loading.
+ */
+export interface ConfigLoaderOptions {
+    readonly sources?: readonly ConfigSource[];
+    readonly context?: ConfigSourceContext;
+    readonly store?: ConfigStore;
+    readonly freeze?: boolean;
+    readonly clearStore?: boolean;
+    readonly onSourceLoaded?: (source: ConfigSource, result: ConfigSourceResult) => void | Promise<void>;
+    readonly onSourceError?: (source: ConfigSource, error: unknown) => void | Promise<void>;
+}
+/**
+ * Result returned after configuration loading.
+ */
+export interface ConfigLoadResult {
+    readonly store: ConfigStore;
+    readonly entries: readonly ConfigEntry[];
+    readonly sources: readonly ConfigSourceResult[];
+    readonly loadedAt: number;
+}
+/**
+ * Configuration loader.
+ *
+ * Sources are loaded in priority order and their values are resolved
+ * into a single ConfigStore. Higher-priority sources win.
+ */
+export declare class ConfigLoader {
+    private readonly sources;
+    private readonly context;
+    private readonly store;
+    private readonly onSourceLoaded?;
+    private readonly onSourceError?;
+    private readonly clearStore;
+    private loading;
+    private loaded;
+    private disposed;
+    private lastResult?;
+    constructor(options?: ConfigLoaderOptions);
+    /**
+     * Returns the underlying configuration store.
+     */
+    getStore(): ConfigStore;
+    /**
+     * Returns the configured sources.
+     */
+    getSources(): readonly ConfigSource[];
+    /**
+     * Returns whether configuration has been loaded.
+     */
+    get isLoaded(): boolean;
+    /**
+     * Returns whether configuration is currently loading.
+     */
+    get isLoading(): boolean;
+    /**
+     * Returns the previous load result.
+     */
+    get lastLoadResult(): ConfigLoadResult | undefined;
+    /**
+     * Loads all configured sources.
+     */
+    load(): Promise<ConfigLoadResult>;
+    /**
+     * Reloads configuration.
+     *
+     * The current store is replaced with freshly loaded values.
+     */
+    reload(): Promise<ConfigLoadResult>;
+    /**
+     * Loads only selected sources.
+     */
+    loadSources(sources: readonly ConfigSource[]): Promise<ConfigLoadResult>;
+    /**
+     * Adds a source to the loader.
+     */
+    addSource(source: ConfigSource): void;
+    /**
+     * Removes a source by name.
+     */
+    removeSource(name: string): boolean;
+    /**
+     * Finds a source by name.
+     */
+    getSource(name: string): ConfigSource | undefined;
+    /**
+     * Disposes the loader and its source resources.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Detaches this loader from its source lifecycle.
+     *
+     * Useful for temporary loaders sharing an existing store.
+     */
+    private detach;
+    /**
+     * 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.
+     */
+    private applySource;
+    private assertActive;
+}
+/**
+ * Creates a configuration loader.
+ */
+export declare function createConfigLoader(options?: ConfigLoaderOptions): ConfigLoader;
+/**
+ * Loads configuration directly from a collection of sources.
+ */
+export declare function loadConfiguration(sources: readonly ConfigSource[], options?: Omit<ConfigLoaderOptions, "sources">): Promise<ConfigLoadResult>;
+/**
+ * Converts loaded source results into configuration entries.
+ */
+export declare function sourceResultsToEntries(results: readonly ConfigSourceResult[], sources: readonly ConfigSource[]): readonly ConfigEntry[];
+//# sourceMappingURL=configLoader.core.d.ts.map

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

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