@zudojs/core 0.0.1

package/dist/configuration/registry/configurationProvider.provider.js

@@ -0,0 +1,113 @@
+import { Configuration } from "../core/configuration.js";
+/**
+ * Default implementation of ConfigurationProvider.
+ *
+ * Responsible for coordinating configuration sources while
+ * keeping the rest of the application independent from them.
+ */
+export class DefaultConfigurationProvider {
+    configuration;
+    sources;
+    constructor(options = {}) {
+        this.configuration = options.configuration ?? new Configuration();
+        this.sources = [...(options.sources ?? [])];
+    }
+    /**
+     * Returns the current configuration.
+     */
+    getConfiguration() {
+        return this.configuration;
+    }
+    /**
+     * Retrieves a configuration value.
+     */
+    get(path) {
+        return this.configuration.get(path);
+    }
+    /**
+     * Retrieves a required configuration value.
+     */
+    require(path) {
+        return this.configuration.require(path);
+    }
+    /**
+     * Retrieves a typed configuration value.
+     */
+    getByKey(key) {
+        return this.configuration.getByKey(key);
+    }
+    /**
+     * Retrieves a required typed configuration value.
+     */
+    requireByKey(key) {
+        return this.configuration.requireByKey(key);
+    }
+    /**
+     * Checks whether a configuration value exists.
+     */
+    has(path) {
+        return this.configuration.has(path);
+    }
+    /**
+     * Reloads configuration from all registered sources.
+     *
+     * Sources are loaded according to priority. Higher priority
+     * sources override values from lower priority sources.
+     */
+    async reload() {
+        const sources = [...this.sources].sort((a, b) => a.priority - b.priority);
+        let configuration = new Configuration();
+        for (const source of sources) {
+            const entries = await source.load();
+            for (const entry of entries) {
+                configuration = configuration.with(entry.path, entry.value, source.type);
+            }
+        }
+        this.configuration = configuration;
+        return configuration;
+    }
+    /**
+     * Returns the registered configuration sources.
+     */
+    getSources() {
+        return [...this.sources];
+    }
+    /**
+     * Updates the provider with a new configuration.
+     *
+     * This is used by ConfigurationManager to push loaded
+     * configuration into the provider.
+     */
+    setConfiguration(configuration) {
+        this.configuration = configuration;
+    }
+    /**
+     * Registers an additional configuration source.
+     *
+     * The source is not loaded automatically.
+     * Call reload() when the provider should rebuild its configuration.
+     */
+    addSource(source) {
+        this.sources.push(source);
+    }
+    /**
+     * Removes a configuration source by name.
+     *
+     * Returns true when a source was removed.
+     */
+    removeSource(name) {
+        const index = this.sources.findIndex((source) => source.name === name);
+        if (index === -1) {
+            return false;
+        }
+        this.sources.splice(index, 1);
+        return true;
+    }
+}
+/**
+ * Creates the default configuration provider.
+ */
+export function createConfigurationProvider(options = {}) {
+    return new DefaultConfigurationProvider(options);
+}
+//# sourceMappingURL=configurationProvider.provider.js.map

package/dist/configuration/registry/configurationProvider.provider.js.map

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

package/dist/configuration/registry/configurationRegistry.registry.d.ts

@@ -0,0 +1,143 @@
+import { Configuration } from "../core/configuration.js";
+import type { ConfigurationSource } from "../core/configurationSource.source.js";
+/**
+ * A named configuration section.
+ *
+ * Sections allow modules to expose configuration under a
+ * predictable namespace.
+ *
+ * Example:
+ *
+ * auth
+ * database
+ * cache
+ * messaging
+ */
+export interface ConfigurationSection {
+    /**
+     * Unique section name.
+     */
+    readonly name: string;
+    /**
+     * Configuration namespace/path represented by this section.
+     */
+    readonly path: string;
+    /**
+     * Optional description for documentation and diagnostics.
+     */
+    readonly description?: string;
+}
+/**
+ * Options used when registering a configuration section.
+ */
+export interface ConfigurationSectionOptions {
+    /**
+     * Section name.
+     */
+    readonly name: string;
+    /**
+     * Configuration path represented by the section.
+     *
+     * Example:
+     *
+     * auth.jwt
+     */
+    readonly path?: string;
+    /**
+     * Optional description.
+     */
+    readonly description?: string;
+}
+/**
+ * Registry containing configuration sources and sections
+ * registered by the framework and application modules.
+ *
+ * The registry does not load configuration.
+ */
+export declare class ConfigurationRegistry {
+    private readonly sources;
+    private readonly sections;
+    /**
+     * Registers a configuration source.
+     *
+     * Source names must be unique.
+     */
+    registerSource(source: ConfigurationSource): void;
+    /**
+     * Registers multiple configuration sources.
+     */
+    registerSources(sources: readonly ConfigurationSource[]): void;
+    /**
+     * Gets a registered configuration source.
+     */
+    getSource(name: string): ConfigurationSource | undefined;
+    /**
+     * Returns all registered configuration sources.
+     */
+    getSources(): readonly ConfigurationSource[];
+    /**
+     * Checks whether a source is registered.
+     */
+    hasSource(name: string): boolean;
+    /**
+     * Removes a registered source.
+     */
+    removeSource(name: string): boolean;
+    /**
+     * Registers a named configuration section.
+     */
+    registerSection(options: ConfigurationSectionOptions): ConfigurationSection;
+    /**
+     * Gets a registered configuration section.
+     */
+    getSection(name: string): ConfigurationSection | undefined;
+    /**
+     * Returns all registered configuration sections.
+     */
+    getSections(): readonly ConfigurationSection[];
+    /**
+     * Checks whether a configuration section exists.
+     */
+    hasSection(name: string): boolean;
+    /**
+     * Removes a configuration section.
+     */
+    removeSection(name: string): boolean;
+    /**
+     * Creates a scoped Configuration instance for
+     * a registered section.
+     *
+     * Example:
+     *
+     * registry.getConfigurationSection(
+     *   configuration,
+     *   "database",
+     * );
+     */
+    getConfigurationSection(configuration: Configuration, name: string): Configuration;
+    /**
+     * Clears all registered sources.
+     */
+    clearSources(): void;
+    /**
+     * Clears all registered sections.
+     */
+    clearSections(): void;
+    /**
+     * Clears the complete registry.
+     */
+    clear(): void;
+    /**
+     * Returns the number of registered sources.
+     */
+    sourceCount(): number;
+    /**
+     * Returns the number of registered sections.
+     */
+    sectionCount(): number;
+}
+/**
+ * Creates a new ConfigurationRegistry.
+ */
+export declare function createConfigurationRegistry(): ConfigurationRegistry;
+//# sourceMappingURL=configurationRegistry.registry.d.ts.map

package/dist/configuration/registry/configurationRegistry.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationRegistry.registry.d.ts","sourceRoot":"","sources":["../../../src/configuration/registry/configurationRegistry.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAElE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IAEpE;;;;OAIG;IACI,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAQvD;IAED;;OAEG;IACI,eAAe,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI,CAIpE;IAED;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE9D;IAED;;OAEG;IACI,UAAU,IAAI,SAAS,mBAAmB,EAAE,CAElD;IAED;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtC;IAED;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzC;IAED;;OAEG;IACI,eAAe,CACpB,OAAO,EAAE,2BAA2B,GACnC,oBAAoB,CA4BtB;IAED;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEhE;IAED;;OAEG;IACI,WAAW,IAAI,SAAS,oBAAoB,EAAE,CAEpD;IAED;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvC;IAED;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1C;IAED;;;;;;;;;;OAUG;IACI,uBAAuB,CAC5B,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,GACX,aAAa,CAQf;IAED;;OAEG;IACI,YAAY,IAAI,IAAI,CAE1B;IAED;;OAEG;IACI,aAAa,IAAI,IAAI,CAE3B;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAGnB;IAED;;OAEG;IACI,WAAW,IAAI,MAAM,CAE3B;IAED;;OAEG;IACI,YAAY,IAAI,MAAM,CAE5B;CACF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE"}

package/dist/configuration/registry/configurationRegistry.registry.js

@@ -0,0 +1,157 @@
+import { Configuration } from "../core/configuration.js";
+/**
+ * Registry containing configuration sources and sections
+ * registered by the framework and application modules.
+ *
+ * The registry does not load configuration.
+ */
+export class ConfigurationRegistry {
+    sources = new Map();
+    sections = new Map();
+    /**
+     * Registers a configuration source.
+     *
+     * Source names must be unique.
+     */
+    registerSource(source) {
+        if (this.sources.has(source.name)) {
+            throw new Error(`Configuration source "${source.name}" is already registered.`);
+        }
+        this.sources.set(source.name, source);
+    }
+    /**
+     * Registers multiple configuration sources.
+     */
+    registerSources(sources) {
+        for (const source of sources) {
+            this.registerSource(source);
+        }
+    }
+    /**
+     * Gets a registered configuration source.
+     */
+    getSource(name) {
+        return this.sources.get(name);
+    }
+    /**
+     * Returns all registered configuration sources.
+     */
+    getSources() {
+        return [...this.sources.values()];
+    }
+    /**
+     * Checks whether a source is registered.
+     */
+    hasSource(name) {
+        return this.sources.has(name);
+    }
+    /**
+     * Removes a registered source.
+     */
+    removeSource(name) {
+        return this.sources.delete(name);
+    }
+    /**
+     * Registers a named configuration section.
+     */
+    registerSection(options) {
+        const name = options.name.trim();
+        if (!name) {
+            throw new Error("Configuration section name cannot be empty.");
+        }
+        if (this.sections.has(name)) {
+            throw new Error(`Configuration section "${name}" is already registered.`);
+        }
+        const path = (options.path ?? name).trim().replace(/\s+/g, "");
+        if (!path) {
+            throw new Error(`Configuration path for section "${name}" cannot be empty.`);
+        }
+        const section = Object.freeze({
+            name,
+            path,
+            description: options.description,
+        });
+        this.sections.set(name, section);
+        return section;
+    }
+    /**
+     * Gets a registered configuration section.
+     */
+    getSection(name) {
+        return this.sections.get(name);
+    }
+    /**
+     * Returns all registered configuration sections.
+     */
+    getSections() {
+        return [...this.sections.values()];
+    }
+    /**
+     * Checks whether a configuration section exists.
+     */
+    hasSection(name) {
+        return this.sections.has(name);
+    }
+    /**
+     * Removes a configuration section.
+     */
+    removeSection(name) {
+        return this.sections.delete(name);
+    }
+    /**
+     * Creates a scoped Configuration instance for
+     * a registered section.
+     *
+     * Example:
+     *
+     * registry.getConfigurationSection(
+     *   configuration,
+     *   "database",
+     * );
+     */
+    getConfigurationSection(configuration, name) {
+        const section = this.sections.get(name);
+        if (!section) {
+            throw new Error(`Configuration section "${name}" is not registered.`);
+        }
+        return configuration.scope(section.path);
+    }
+    /**
+     * Clears all registered sources.
+     */
+    clearSources() {
+        this.sources.clear();
+    }
+    /**
+     * Clears all registered sections.
+     */
+    clearSections() {
+        this.sections.clear();
+    }
+    /**
+     * Clears the complete registry.
+     */
+    clear() {
+        this.clearSources();
+        this.clearSections();
+    }
+    /**
+     * Returns the number of registered sources.
+     */
+    sourceCount() {
+        return this.sources.size;
+    }
+    /**
+     * Returns the number of registered sections.
+     */
+    sectionCount() {
+        return this.sections.size;
+    }
+}
+/**
+ * Creates a new ConfigurationRegistry.
+ */
+export function createConfigurationRegistry() {
+    return new ConfigurationRegistry();
+}
+//# sourceMappingURL=configurationRegistry.registry.js.map

package/dist/configuration/registry/configurationRegistry.registry.js.map

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

package/dist/configuration/registry/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/core/configuration/registry
+ *
+ * Configuration registry and provider.
+ */
+export { ConfigurationRegistry, createConfigurationRegistry, } from "./configurationRegistry.registry.js";
+export type { ConfigurationSection, ConfigurationSectionOptions, } from "./configurationRegistry.registry.js";
+export { DefaultConfigurationProvider, createConfigurationProvider, } from "./configurationProvider.provider.js";
+export type { ConfigurationProvider, ConfigurationProviderOptions, } from "./configurationProvider.provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/configuration/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAE7C,YAAY,EACV,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAE7C,YAAY,EACV,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC"}

package/dist/configuration/registry/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/configuration/registry
+ *
+ * Configuration registry and provider.
+ */
+export { ConfigurationRegistry, createConfigurationRegistry, } from "./configurationRegistry.registry.js";
+export { DefaultConfigurationProvider, createConfigurationProvider, } from "./configurationProvider.provider.js";
+//# sourceMappingURL=index.js.map

package/dist/configuration/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAO7C,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC"}

package/dist/configuration/schema/configurationSchema.schema.d.ts

@@ -0,0 +1,159 @@
+import type { Configuration, ConfigurationValue } from "../core/configuration.js";
+/**
+ * Result returned by a configuration schema validator.
+ */
+export interface ConfigurationValidationResult<T> {
+    /**
+     * Whether validation succeeded.
+     */
+    readonly success: boolean;
+    /**
+     * Validated and potentially transformed value.
+     */
+    readonly value?: T;
+    /**
+     * Validation errors.
+     */
+    readonly errors: readonly ConfigurationValidationIssue[];
+}
+/**
+ * Represents one configuration validation issue.
+ */
+export interface ConfigurationValidationIssue {
+    /**
+     * Configuration path where the error occurred.
+     */
+    readonly path: string;
+    /**
+     * Human-readable error message.
+     */
+    readonly message: string;
+    /**
+     * Optional validation error code.
+     */
+    readonly code?: string;
+    /**
+     * Value that failed validation.
+     */
+    readonly value?: unknown;
+}
+/**
+ * Context supplied to configuration validators.
+ */
+export interface ConfigurationValidationContext {
+    /**
+     * Configuration being validated.
+     */
+    readonly configuration: Configuration;
+    /**
+     * Current configuration path.
+     */
+    readonly path: string;
+}
+/**
+ * Function capable of validating a configuration value.
+ */
+export type ConfigurationValidator<T> = (value: T, context: ConfigurationValidationContext) => ConfigurationValidationResult<T> | Promise<ConfigurationValidationResult<T>>;
+/**
+ * Options used to create a configuration schema.
+ */
+export interface ConfigurationSchemaOptions<T> {
+    /**
+     * Configuration path represented by the schema.
+     */
+    readonly path: string;
+    /**
+     * Whether the configuration value is required.
+     *
+     * Defaults to true.
+     */
+    readonly required?: boolean;
+    /**
+     * Optional default value.
+     */
+    readonly defaultValue?: T;
+    /**
+     * Optional custom validator.
+     */
+    readonly validator?: ConfigurationValidator<T>;
+    /**
+     * Optional description.
+     */
+    readonly description?: string;
+}
+/**
+ * Schema describing and validating one configuration value.
+ */
+export interface ConfigurationSchema<T = ConfigurationValue> {
+    /**
+     * Configuration path.
+     */
+    readonly path: string;
+    /**
+     * Whether the value must exist.
+     */
+    readonly required: boolean;
+    /**
+     * Default value.
+     */
+    readonly defaultValue?: T;
+    /**
+     * Human-readable description.
+     */
+    readonly description?: string;
+    /**
+     * Validates the configuration value.
+     */
+    validate(configuration: Configuration): Promise<ConfigurationValidationResult<T>>;
+}
+/**
+ * Creates a configuration schema.
+ */
+export declare function createConfigurationSchema<T = ConfigurationValue>(options: ConfigurationSchemaOptions<T>): ConfigurationSchema<T>;
+/**
+ * Collection of configuration schemas.
+ */
+export declare class ConfigurationSchemaRegistry {
+    private readonly schemas;
+    /**
+     * Registers a schema.
+     */
+    register<T>(schema: ConfigurationSchema<T>): void;
+    /**
+     * Registers multiple schemas.
+     */
+    registerMany(schemas: readonly ConfigurationSchema[]): void;
+    /**
+     * Retrieves a schema.
+     */
+    get<T>(path: string): ConfigurationSchema<T> | undefined;
+    /**
+     * Checks whether a schema exists.
+     */
+    has(path: string): boolean;
+    /**
+     * Removes a schema.
+     */
+    remove(path: string): boolean;
+    /**
+     * Returns all registered schemas.
+     */
+    getAll(): readonly ConfigurationSchema[];
+    /**
+     * Returns the number of registered schemas.
+     */
+    size(): number;
+    /**
+     * Removes all schemas.
+     */
+    clear(): void;
+}
+/**
+ * Creates a schema registry.
+ */
+export declare function createConfigurationSchemaRegistry(): ConfigurationSchemaRegistry;
+/**
+ * Validates every registered schema against a configuration.
+ */
+export declare function validateConfiguration(configuration: Configuration, registry: ConfigurationSchemaRegistry): Promise<ConfigurationValidationResult<Configuration>>;
+//# sourceMappingURL=configurationSchema.schema.d.ts.map

package/dist/configuration/schema/configurationSchema.schema.d.ts.map

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