@zudojs/config 0.0.1

package/dist/configStore/configStore.core.js

@@ -0,0 +1,306 @@
+import { cloneConfigValue, configValuesEqual, freezeConfigValue, } from "../configValue/configValue.core.js";
+import { createConfigEntry } from "../configEntry/configEntry.type.js";
+/**
+ * Normalizes a configuration key.
+ */
+export function normalizeKey(key) {
+    if (typeof key !== "string") {
+        throw new TypeError("Configuration key must be a string.");
+    }
+    const normalized = key.trim();
+    if (normalized.length === 0) {
+        throw new TypeError("Configuration key cannot be empty.");
+    }
+    return normalized;
+}
+/**
+ * Central in-memory configuration store.
+ *
+ * The store keeps resolved values and their metadata together so
+ * consumers can inspect where a value originated from.
+ */
+export class ConfigStore {
+    entries = new Map();
+    listeners = new Set();
+    shouldFreeze;
+    disposed = false;
+    constructor(options = {}) {
+        this.shouldFreeze = options.freeze ?? true;
+        if (options.initialValues) {
+            for (const [key, value] of Object.entries(options.initialValues)) {
+                this.set(key, value);
+            }
+        }
+        if (options.entries) {
+            for (const entry of options.entries) {
+                this.setEntry(entry);
+            }
+        }
+    }
+    /**
+     * Returns whether the store has been disposed.
+     */
+    get isDisposed() {
+        return this.disposed;
+    }
+    /**
+     * Returns the number of stored configuration entries.
+     */
+    get size() {
+        return this.entries.size;
+    }
+    /**
+     * Checks whether a key exists.
+     */
+    has(key) {
+        this.assertActive();
+        return this.entries.has(normalizeKey(key));
+    }
+    /**
+     * Gets a configuration value.
+     */
+    get(key) {
+        this.assertActive();
+        const entry = this.entries.get(normalizeKey(key));
+        if (!entry) {
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Gets a configuration entry.
+     */
+    getEntry(key) {
+        this.assertActive();
+        return this.entries.get(normalizeKey(key));
+    }
+    /**
+     * Gets a value or returns the supplied fallback.
+     */
+    getOrDefault(key, fallback) {
+        const value = this.get(key);
+        return value === undefined ? fallback : value;
+    }
+    /**
+     * Sets a configuration value.
+     */
+    set(key, value, options = {}) {
+        this.assertActive();
+        const normalizedKey = normalizeKey(key);
+        const previous = this.entries.get(normalizedKey);
+        const normalizedValue = this.shouldFreeze
+            ? freezeConfigValue(cloneConfigValue(value))
+            : value;
+        const entry = createConfigEntry({
+            key: normalizedKey,
+            value: normalizedValue,
+            source: options.source ?? "runtime",
+            sourceType: options.sourceType,
+            priority: options.priority ?? 0,
+            sensitive: options.sensitive ?? false,
+            resolved: options.resolved ?? true,
+        });
+        if (previous &&
+            configValuesEqual(previous.value, entry.value) &&
+            previous.source === entry.source &&
+            previous.sourceType === entry.sourceType &&
+            previous.priority === entry.priority &&
+            previous.sensitive === entry.sensitive &&
+            previous.resolved === entry.resolved) {
+            return entry;
+        }
+        this.entries.set(normalizedKey, entry);
+        this.emitChange({
+            key: normalizedKey,
+            previous,
+            current: entry,
+            timestamp: Date.now(),
+        });
+        return entry;
+    }
+    /**
+     * Stores an existing configuration entry.
+     */
+    setEntry(entry) {
+        this.assertActive();
+        this.set(entry.key, entry.value, {
+            source: entry.source,
+            sourceType: entry.sourceType,
+            priority: entry.priority,
+            sensitive: entry.sensitive,
+            resolved: entry.resolved,
+        });
+    }
+    /**
+     * Sets multiple configuration values.
+     */
+    setMany(values, options = {}) {
+        this.assertActive();
+        for (const [key, value] of Object.entries(values)) {
+            this.set(key, value, options);
+        }
+    }
+    /**
+     * Removes a configuration value.
+     */
+    delete(key) {
+        this.assertActive();
+        const normalizedKey = normalizeKey(key);
+        const previous = this.entries.get(normalizedKey);
+        if (!previous) {
+            return false;
+        }
+        this.entries.delete(normalizedKey);
+        this.emitChange({
+            key: normalizedKey,
+            previous,
+            current: undefined,
+            timestamp: Date.now(),
+        });
+        return true;
+    }
+    /**
+     * Removes every configuration entry.
+     */
+    clear() {
+        this.assertActive();
+        const entries = Array.from(this.entries.values());
+        this.entries.clear();
+        const timestamp = Date.now();
+        for (const previous of entries) {
+            this.emitChange({
+                key: previous.key,
+                previous,
+                current: undefined,
+                timestamp,
+            });
+        }
+    }
+    /**
+     * Returns all entries.
+     */
+    getEntries() {
+        this.assertActive();
+        return Array.from(this.entries.values());
+    }
+    /**
+     * Returns all keys.
+     */
+    keys() {
+        this.assertActive();
+        return Array.from(this.entries.keys());
+    }
+    /**
+     * Returns all values.
+     */
+    values() {
+        this.assertActive();
+        return Array.from(this.entries.values(), (entry) => entry.value);
+    }
+    /**
+     * Returns a plain object containing all configuration values.
+     */
+    toObject() {
+        this.assertActive();
+        const result = {};
+        for (const entry of this.entries.values()) {
+            result[entry.key] = entry.value;
+        }
+        if (this.shouldFreeze) {
+            freezeConfigValue(result);
+        }
+        return result;
+    }
+    /**
+     * Returns entries matching a prefix.
+     */
+    getByPrefix(prefix) {
+        this.assertActive();
+        const normalizedPrefix = normalizeKey(prefix);
+        return Array.from(this.entries.values()).filter((entry) => entry.key === normalizedPrefix ||
+            entry.key.startsWith(`${normalizedPrefix}.`));
+    }
+    /**
+     * Returns configuration values matching a prefix.
+     */
+    getObjectByPrefix(prefix) {
+        const entries = this.getByPrefix(prefix);
+        const normalizedPrefix = normalizeKey(prefix);
+        const result = {};
+        for (const entry of entries) {
+            const key = entry.key === normalizedPrefix
+                ? ""
+                : entry.key.slice(normalizedPrefix.length + 1);
+            if (key.length > 0) {
+                result[key] = entry.value;
+            }
+        }
+        if (this.shouldFreeze) {
+            freezeConfigValue(result);
+        }
+        return result;
+    }
+    /**
+     * Subscribes to configuration changes.
+     */
+    subscribe(listener) {
+        this.assertActive();
+        if (typeof listener !== "function") {
+            throw new TypeError("Configuration change listener must be a function.");
+        }
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * Creates a snapshot of the current store.
+     */
+    snapshot() {
+        this.assertActive();
+        return new ConfigStore({
+            entries: this.getEntries(),
+            freeze: this.shouldFreeze,
+        });
+    }
+    /**
+     * Replaces the current store contents.
+     */
+    replace(values, options = {}) {
+        this.assertActive();
+        const incomingKeys = new Set(Object.keys(values).map(normalizeKey));
+        for (const key of this.keys()) {
+            if (!incomingKeys.has(key)) {
+                this.delete(key);
+            }
+        }
+        this.setMany(values, options);
+    }
+    /**
+     * Disposes the store and removes listeners.
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.listeners.clear();
+        this.entries.clear();
+        this.disposed = true;
+    }
+    emitChange(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Listener failures must not break configuration writes.
+            }
+        }
+    }
+    assertActive() {
+        if (this.disposed) {
+            throw new Error("ConfigStore has been disposed.");
+        }
+    }
+}
+//# sourceMappingURL=configStore.core.js.map

package/dist/configStore/configStore.core.js.map

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

package/dist/configStore/configStore.factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @zudojs/config/configStore/configStore.factory
+ *
+ * Factory and utility functions for ConfigStore.
+ */
+export { normalizeKey } from "./configStore.core.js";
+import type { ConfigStoreOptions } from "./configStore.type.js";
+import { ConfigStore } from "./configStore.core.js";
+/**
+ * Creates a configuration store.
+ */
+export declare function createConfigStore(options?: ConfigStoreOptions): ConfigStore;
+//# sourceMappingURL=configStore.factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.factory.d.ts","sourceRoot":"","sources":["../../src/configStore/configStore.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAEb"}

package/dist/configStore/configStore.factory.js

@@ -0,0 +1,14 @@
+/**
+ * @zudojs/config/configStore/configStore.factory
+ *
+ * Factory and utility functions for ConfigStore.
+ */
+export { normalizeKey } from "./configStore.core.js";
+import { ConfigStore } from "./configStore.core.js";
+/**
+ * Creates a configuration store.
+ */
+export function createConfigStore(options = {}) {
+    return new ConfigStore(options);
+}
+//# sourceMappingURL=configStore.factory.js.map

package/dist/configStore/configStore.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.factory.js","sourceRoot":"","sources":["../../src/configStore/configStore.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAO,GAAuB,EAAE;IAEhC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/configStore/configStore.type.d.ts

@@ -0,0 +1,24 @@
+import type { ConfigValue } from "../configValue/configValue.core.js";
+import type { ConfigEntry } from "../configEntry/configEntry.type.js";
+/**
+ * Event emitted when a configuration value changes.
+ */
+export interface ConfigChangeEvent {
+    readonly key: string;
+    readonly previous?: ConfigEntry;
+    readonly current?: ConfigEntry;
+    readonly timestamp: number;
+}
+/**
+ * Listener called when configuration changes.
+ */
+export type ConfigChangeListener = (event: ConfigChangeEvent) => void;
+/**
+ * Options used to initialize a configuration store.
+ */
+export interface ConfigStoreOptions {
+    readonly initialValues?: Readonly<Record<string, ConfigValue>>;
+    readonly entries?: readonly ConfigEntry[];
+    readonly freeze?: boolean;
+}
+//# sourceMappingURL=configStore.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.type.d.ts","sourceRoot":"","sources":["../../src/configStore/configStore.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAE/D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAE1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/configStore/configStore.type.js

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

package/dist/configStore/configStore.type.js.map

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

package/dist/configStore/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/config/configStore
+ *
+ * In-memory configuration storage and access.
+ */
+export * from "./configStore.type.js";
+export * from "./configStore.core.js";
+export * from "./configStore.factory.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/configStore/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/config/configStore
+ *
+ * In-memory configuration storage and access.
+ */
+export * from "./configStore.type.js";
+export * from "./configStore.core.js";
+export * from "./configStore.factory.js";
+//# sourceMappingURL=index.js.map

package/dist/configStore/index.js.map

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

package/dist/configValue/configValue.core.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Configuration values used throughout Zudojs.
+ *
+ * This module provides the common value types and utilities used by
+ * the configuration system. Values remain JSON-compatible where
+ * possible, while allowing common runtime values such as undefined,
+ * Date, and Buffer-like binary data to be handled safely.
+ */
+/**
+ * Primitive configuration values.
+ */
+export type ConfigPrimitive = string | number | boolean | bigint | null | undefined;
+/**
+ * JSON-compatible configuration values.
+ */
+export type ConfigJsonValue = string | number | boolean | null | ConfigJsonValue[] | {
+    readonly [key: string]: ConfigJsonValue;
+};
+/**
+ * Values accepted by the Zudojs configuration system.
+ */
+export type ConfigValue = ConfigPrimitive | Date | ConfigValue[] | {
+    readonly [key: string]: ConfigValue;
+};
+/**
+ * Configuration values after environment-variable parsing.
+ */
+export type ResolvedConfigValue = string | number | boolean | bigint | null | undefined | Date | ResolvedConfigValue[] | {
+    readonly [key: string]: ResolvedConfigValue;
+};
+/**
+ * Checks whether a value is a configuration primitive.
+ */
+export declare function isConfigPrimitive(value: unknown): value is ConfigPrimitive;
+/**
+ * Checks whether a value is a plain configuration object.
+ */
+export declare function isConfigObject(value: unknown): value is {
+    readonly [key: string]: ConfigValue;
+};
+/**
+ * Checks whether a value can be stored as a configuration value.
+ */
+export declare function isConfigValue(value: unknown): value is ConfigValue;
+/**
+ * Converts a configuration value into a JSON-compatible value.
+ *
+ * Undefined values are preserved by default so callers can decide
+ * whether they should be omitted.
+ */
+export declare function toConfigJsonValue(value: ConfigValue): ConfigJsonValue | undefined;
+/**
+ * Converts a configuration value to a string.
+ *
+ * This is primarily useful when generating environment-like output.
+ */
+export declare function configValueToString(value: ConfigValue): string | undefined;
+/**
+ * Parses a primitive environment-style value.
+ *
+ * The parser intentionally does not aggressively infer numbers or
+ * booleans from arbitrary strings. Use the typed config resolvers
+ * when a specific type is required.
+ */
+export declare function parseConfigString(value: string | undefined): ConfigPrimitive;
+/**
+ * Parses a boolean configuration value.
+ */
+export declare function parseConfigBoolean(value: string | boolean | undefined): boolean | undefined;
+/**
+ * Parses a numeric configuration value.
+ */
+export declare function parseConfigNumber(value: string | number | undefined): number | undefined;
+/**
+ * Parses a bigint configuration value.
+ */
+export declare function parseConfigBigInt(value: string | bigint | undefined): bigint | undefined;
+/**
+ * Parses a Date configuration value.
+ */
+export declare function parseConfigDate(value: string | Date | undefined): Date | undefined;
+/**
+ * Deeply freezes a configuration value.
+ *
+ * Configuration objects should normally be immutable after
+ * resolution to prevent accidental runtime mutation.
+ */
+export declare function freezeConfigValue<T extends ConfigValue>(value: T): T;
+/**
+ * Deeply clones a configuration value.
+ */
+export declare function cloneConfigValue<T extends ConfigValue>(value: T): T;
+/**
+ * Compares two configuration values deeply.
+ */
+export declare function configValuesEqual(left: ConfigValue, right: ConfigValue): boolean;
+//# sourceMappingURL=configValue.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configValue.core.d.ts","sourceRoot":"","sources":["../../src/configValue/configValue.core.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GACzB,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,eAAe,EAAE,GACjB;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;CACzC,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,IAAI,GACJ,WAAW,EAAE,GACb;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,SAAS,GACT,IAAI,GACJ,mBAAmB,EAAE,GACrB;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC7C,CAAC;AAEN;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAS1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IACvD,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC,CAaA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAkBlE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,GACjB,eAAe,GAAG,SAAS,CAkD7B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAoC1E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAM5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAClC,OAAO,GAAG,SAAS,CA2BrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACjC,MAAM,GAAG,SAAS,CAkBpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACjC,MAAM,GAAG,SAAS,CAoBpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,IAAI,GAAG,SAAS,CAclB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAoBpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAwBnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAkCT"}