@zudojs/core 0.0.1

package/dist/configuration/error/configurationError.error.js

@@ -0,0 +1,168 @@
+import { FrameworkError } from "../../errors/frameworkError.error.js";
+import { ErrorCode } from "../../errors/errorCode.code.js";
+/**
+ * Base error for all configuration related failures.
+ *
+ * This gives the configuration subsystem a common error type
+ * while still allowing callers to handle more specific errors.
+ */
+export class ConfigurationError extends FrameworkError {
+    /**
+     * Configuration path associated with the error.
+     */
+    path;
+    /**
+     * Original error that caused this failure.
+     */
+    name = "ConfigurationError";
+    constructor(code, message, options = {}) {
+        super(message, {
+            code,
+            details: {
+                ...(options.details ?? {}),
+                ...(options.path
+                    ? {
+                        path: options.path,
+                    }
+                    : {}),
+            },
+            cause: options.cause,
+        });
+        this.name = "ConfigurationError";
+        this.path = options.path;
+    }
+}
+/**
+ * Thrown when configuration loading fails.
+ */
+export class ConfigurationSourceError extends ConfigurationError {
+    /**
+     * Name of the configuration source that failed.
+     */
+    sourceName;
+    /**
+     * Type of configuration source.
+     */
+    sourceType;
+    constructor(sourceName, sourceType, cause) {
+        const causeMessage = cause instanceof Error ? cause.message : String(cause);
+        super(ErrorCode.CONFIGURATION_LOAD_FAILED, `Failed to load configuration source "${sourceName}": ${causeMessage}`, {
+            cause,
+            details: {
+                sourceName,
+                sourceType,
+            },
+        });
+        this.name = "ConfigurationSourceError";
+        this.sourceName = sourceName;
+        this.sourceType = sourceType;
+    }
+}
+/**
+ * Thrown when a required configuration value is missing.
+ */
+export class ConfigurationMissingError extends ConfigurationError {
+    constructor(path) {
+        super(ErrorCode.CONFIGURATION_REQUIRED, `Required configuration "${path}" is not defined.`, {
+            path,
+        });
+        this.name = "ConfigurationMissingError";
+    }
+}
+/**
+ * Thrown when a configuration value has an invalid type
+ * or otherwise cannot be interpreted correctly.
+ */
+export class ConfigurationTypeError extends ConfigurationError {
+    /**
+     * Expected configuration type.
+     */
+    expectedType;
+    /**
+     * Actual configuration type.
+     */
+    actualType;
+    constructor(path, expectedType, value) {
+        const actualType = getValueType(value);
+        super(ErrorCode.CONFIGURATION_INVALID_TYPE, `Configuration "${path}" must be of type ${expectedType}, received ${actualType}.`, {
+            path,
+            details: {
+                expectedType,
+                actualType,
+            },
+        });
+        this.name = "ConfigurationTypeError";
+        this.expectedType = expectedType;
+        this.actualType = actualType;
+    }
+}
+/**
+ * Thrown when a configuration value fails schema validation.
+ */
+export class ConfigurationSchemaError extends ConfigurationError {
+    /**
+     * Validation issues associated with the schema.
+     */
+    issues;
+    constructor(path, issues) {
+        super(ErrorCode.CONFIGURATION_VALIDATION_FAILED, createSchemaErrorMessage(path, issues), {
+            path,
+            details: {
+                issues,
+            },
+        });
+        this.name = "ConfigurationSchemaError";
+        this.issues = [...issues];
+    }
+}
+/**
+ * Thrown when a configuration source contains
+ * duplicate or conflicting definitions that cannot
+ * be resolved.
+ */
+export class ConfigurationConflictError extends ConfigurationError {
+    /**
+     * Configuration path where the conflict occurred.
+     */
+    conflictingPath;
+    /**
+     * Names of the conflicting sources.
+     */
+    sources;
+    constructor(path, sources) {
+        super(ErrorCode.CONFIGURATION_CONFLICT, `Configuration conflict detected for "${path}" between sources: ${sources.join(", ")}.`, {
+            path,
+            details: {
+                sources,
+            },
+        });
+        this.name = "ConfigurationConflictError";
+        this.conflictingPath = path;
+        this.sources = [...sources];
+    }
+}
+/**
+ * Creates a safe representation of a configuration value's type.
+ */
+function getValueType(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        return "array";
+    }
+    return typeof value;
+}
+/**
+ * Formats schema validation issues.
+ */
+function createSchemaErrorMessage(path, issues) {
+    if (issues.length === 0) {
+        return `Configuration "${path}" failed schema validation.`;
+    }
+    const details = issues
+        .map((issue) => `${issue.path}: ${issue.message}`)
+        .join("; ");
+    return `Configuration "${path}" failed schema validation: ${details}`;
+}
+//# sourceMappingURL=configurationError.error.js.map

package/dist/configuration/error/configurationError.error.js.map

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

package/dist/configuration/error/configurationRedactor.redactor.d.ts

@@ -0,0 +1,111 @@
+import type { Configuration, ConfigurationValue } from "../core/configuration.js";
+/**
+ * Default configuration paths and key fragments that should
+ * be treated as sensitive.
+ *
+ * Matching is case-insensitive.
+ */
+export declare const DEFAULT_SENSITIVE_PATTERNS: readonly string[];
+/**
+ * Default value used when a sensitive configuration value
+ * is redacted.
+ */
+export declare const DEFAULT_REDACTION_VALUE = "[REDACTED]";
+/**
+ * Options for ConfigurationRedactor.
+ */
+export interface ConfigurationRedactorOptions {
+    /**
+     * Additional patterns that should be treated as sensitive.
+     */
+    readonly sensitivePatterns?: readonly string[];
+    /**
+     * Exact configuration paths that should be treated
+     * as sensitive.
+     */
+    readonly sensitivePaths?: readonly string[];
+    /**
+     * Value used when redacting sensitive data.
+     *
+     * Defaults to "[REDACTED]".
+     */
+    readonly redactionValue?: string;
+    /**
+     * Whether nested objects and arrays should be traversed.
+     *
+     * Defaults to true.
+     */
+    readonly deep?: boolean;
+}
+/**
+ * Result of checking whether a configuration path
+ * contains sensitive information.
+ */
+export interface ConfigurationSensitivity {
+    /**
+     * Whether the path is sensitive.
+     */
+    readonly sensitive: boolean;
+    /**
+     * Reason the path was classified as sensitive.
+     */
+    readonly reason?: "pattern" | "exact-path";
+}
+/**
+ * Safe representation of configuration.
+ */
+export type RedactedConfiguration = ConfigurationValue;
+/**
+ * Redacts sensitive configuration values.
+ *
+ * This class deliberately operates on copies and never mutates
+ * the original configuration object.
+ */
+export declare class ConfigurationRedactor {
+    private readonly sensitivePatterns;
+    private readonly sensitivePaths;
+    private readonly redactionValue;
+    private readonly deep;
+    constructor(options?: ConfigurationRedactorOptions);
+    /**
+     * Determines whether a configuration path is sensitive.
+     */
+    isSensitive(path: string): boolean;
+    /**
+     * Provides detailed sensitivity information.
+     */
+    checkSensitivity(path: string): ConfigurationSensitivity;
+    /**
+     * Redacts a complete Configuration instance.
+     *
+     * The returned object is safe to use for logging and
+     * diagnostics.
+     */
+    redact(configuration: Configuration): RedactedConfiguration;
+    /**
+     * Redacts a plain configuration object.
+     */
+    redactObject(value: ConfigurationValue): RedactedConfiguration;
+    /**
+     * Redacts a single configuration value at a known path.
+     */
+    redactValueAtPath(path: string, value: ConfigurationValue): ConfigurationValue;
+    /**
+     * Recursively redacts objects and arrays.
+     */
+    private redactValue;
+    /**
+     * Checks whether a path segment matches one of the
+     * configured sensitive patterns.
+     */
+    private matchesSensitivePattern;
+}
+/**
+ * Creates a ConfigurationRedactor.
+ */
+export declare function createConfigurationRedactor(options?: ConfigurationRedactorOptions): ConfigurationRedactor;
+/**
+ * Redacts configuration using the default redaction rules.
+ */
+export declare function redactConfiguration(configuration: Configuration): RedactedConfiguration;
+//# sourceMappingURL=configurationRedactor.redactor.d.ts.map

package/dist/configuration/error/configurationRedactor.redactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationRedactor.redactor.d.ts","sourceRoot":"","sources":["../../../src/configuration/error/configurationRedactor.redactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAevD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IAEtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAE/B,YAAmB,OAAO,GAAE,4BAAiC,EAa5D;IAED;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExC;IAED;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CA+B9D;IAED;;;;;OAKG;IACI,MAAM,CAAC,aAAa,EAAE,aAAa,GAAG,qBAAqB,CAEjE;IAED;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,qBAAqB,CAEpE;IAED;;OAEG;IACI,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,kBAAkB,GACxB,kBAAkB,CAUpB;IAED;;OAEG;IACH,OAAO,CAAC,WAAW;IAkDnB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;CAOhC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAEvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,aAAa,GAC3B,qBAAqB,CAEvB"}

package/dist/configuration/error/configurationRedactor.redactor.js

@@ -0,0 +1,176 @@
+/**
+ * Default configuration paths and key fragments that should
+ * be treated as sensitive.
+ *
+ * Matching is case-insensitive.
+ */
+export const DEFAULT_SENSITIVE_PATTERNS = [
+    "password",
+    "passwd",
+    "secret",
+    "token",
+    "access_token",
+    "refresh_token",
+    "api_key",
+    "apikey",
+    "private_key",
+    "privatekey",
+    "client_secret",
+    "authorization",
+    "credential",
+    "credentials",
+];
+/**
+ * Default value used when a sensitive configuration value
+ * is redacted.
+ */
+export const DEFAULT_REDACTION_VALUE = "[REDACTED]";
+/**
+ * Redacts sensitive configuration values.
+ *
+ * This class deliberately operates on copies and never mutates
+ * the original configuration object.
+ */
+export class ConfigurationRedactor {
+    sensitivePatterns;
+    sensitivePaths;
+    redactionValue;
+    deep;
+    constructor(options = {}) {
+        this.sensitivePatterns = [
+            ...DEFAULT_SENSITIVE_PATTERNS,
+            ...(options.sensitivePatterns ?? []),
+        ].map((pattern) => normalizePattern(pattern));
+        this.sensitivePaths = new Set((options.sensitivePaths ?? []).map((path) => normalizePath(path)));
+        this.redactionValue = options.redactionValue ?? DEFAULT_REDACTION_VALUE;
+        this.deep = options.deep ?? true;
+    }
+    /**
+     * Determines whether a configuration path is sensitive.
+     */
+    isSensitive(path) {
+        return this.checkSensitivity(path).sensitive;
+    }
+    /**
+     * Provides detailed sensitivity information.
+     */
+    checkSensitivity(path) {
+        const normalizedPath = normalizePath(path);
+        if (this.sensitivePaths.has(normalizedPath)) {
+            return {
+                sensitive: true,
+                reason: "exact-path",
+            };
+        }
+        const pathSegments = normalizedPath.split(".");
+        for (const segment of pathSegments) {
+            if (this.matchesSensitivePattern(segment)) {
+                return {
+                    sensitive: true,
+                    reason: "pattern",
+                };
+            }
+        }
+        if (this.matchesSensitivePattern(normalizedPath)) {
+            return {
+                sensitive: true,
+                reason: "pattern",
+            };
+        }
+        return {
+            sensitive: false,
+        };
+    }
+    /**
+     * Redacts a complete Configuration instance.
+     *
+     * The returned object is safe to use for logging and
+     * diagnostics.
+     */
+    redact(configuration) {
+        return this.redactValue(configuration.toObject(), "");
+    }
+    /**
+     * Redacts a plain configuration object.
+     */
+    redactObject(value) {
+        return this.redactValue(value, "");
+    }
+    /**
+     * Redacts a single configuration value at a known path.
+     */
+    redactValueAtPath(path, value) {
+        if (this.isSensitive(path)) {
+            return this.redactionValue;
+        }
+        if (!this.deep) {
+            return value;
+        }
+        return this.redactValue(value, path);
+    }
+    /**
+     * Recursively redacts objects and arrays.
+     */
+    redactValue(value, parentPath) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            if (parentPath && this.isSensitive(parentPath)) {
+                return this.redactionValue;
+            }
+            return value;
+        }
+        if (Array.isArray(value)) {
+            if (!this.deep) {
+                return value;
+            }
+            return value.map((item, index) => this.redactValue(item, parentPath ? `${parentPath}.${index}` : String(index)));
+        }
+        const result = {};
+        for (const [key, childValue] of Object.entries(value)) {
+            const path = parentPath ? `${parentPath}.${key}` : key;
+            if (this.isSensitive(path)) {
+                result[key] = this.redactionValue;
+                continue;
+            }
+            result[key] = this.deep ? this.redactValue(childValue, path) : childValue;
+        }
+        return result;
+    }
+    /**
+     * Checks whether a path segment matches one of the
+     * configured sensitive patterns.
+     */
+    matchesSensitivePattern(value) {
+        const normalized = normalizePattern(value);
+        return this.sensitivePatterns.some((pattern) => normalized.includes(pattern));
+    }
+}
+/**
+ * Creates a ConfigurationRedactor.
+ */
+export function createConfigurationRedactor(options = {}) {
+    return new ConfigurationRedactor(options);
+}
+/**
+ * Redacts configuration using the default redaction rules.
+ */
+export function redactConfiguration(configuration) {
+    return createConfigurationRedactor().redact(configuration);
+}
+/**
+ * Normalizes a configuration path.
+ */
+function normalizePath(path) {
+    return path.trim().replace(/\s+/g, "").toLowerCase();
+}
+/**
+ * Normalizes a sensitivity pattern.
+ */
+function normalizePattern(pattern) {
+    return pattern.trim().replace(/\s+/g, "").toLowerCase();
+}
+//# sourceMappingURL=configurationRedactor.redactor.js.map

package/dist/configuration/error/configurationRedactor.redactor.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/core/configuration/error
+ *
+ * Configuration errors and redaction.
+ */
+export { ConfigurationError, ConfigurationSourceError, ConfigurationMissingError, ConfigurationTypeError, ConfigurationSchemaError, ConfigurationConflictError, } from "./configurationError.error.js";
+export type { ConfigurationErrorIssue } from "./configurationError.error.js";
+export { ConfigurationRedactor, createConfigurationRedactor, redactConfiguration, DEFAULT_SENSITIVE_PATTERNS, DEFAULT_REDACTION_VALUE, } from "./configurationRedactor.redactor.js";
+export type { ConfigurationRedactorOptions, ConfigurationSensitivity, RedactedConfiguration, } from "./configurationRedactor.redactor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/error/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,YAAY,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC"}

package/dist/configuration/error/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/configuration/error
+ *
+ * Configuration errors and redaction.
+ */
+export { ConfigurationError, ConfigurationSourceError, ConfigurationMissingError, ConfigurationTypeError, ConfigurationSchemaError, ConfigurationConflictError, } from "./configurationError.error.js";
+export { ConfigurationRedactor, createConfigurationRedactor, redactConfiguration, DEFAULT_SENSITIVE_PATTERNS, DEFAULT_REDACTION_VALUE, } from "./configurationRedactor.redactor.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/error/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,qCAAqC,CAAC"}

package/dist/configuration/events/configurationEvents.events.d.ts

@@ -0,0 +1,174 @@
+import type { Configuration } from "../core/configuration.js";
+import type { ConfigurationLoadResult } from "../loader/configurationLoader.loader.js";
+import type { ConfigurationValidationReport } from "../schema/configurationValidation.validator.js";
+import type { ConfigurationManagerState } from "../configurationManager.manager.js";
+/**
+ * Base contract for all configuration events.
+ */
+export interface ConfigurationEvent {
+    /**
+     * Unique event name.
+     */
+    readonly type: string;
+    /**
+     * Time at which the event occurred.
+     */
+    readonly timestamp: Date;
+    /**
+     * Configuration manager state associated with the event.
+     */
+    readonly state: ConfigurationManagerState;
+}
+/**
+ * Emitted before configuration initialization begins.
+ */
+export interface ConfigurationInitializingEvent extends ConfigurationEvent {
+    readonly type: "configuration.initializing";
+}
+/**
+ * Emitted after configuration sources have been loaded.
+ */
+export interface ConfigurationLoadedEvent extends ConfigurationEvent {
+    readonly type: "configuration.loaded";
+    /**
+     * Result produced by the configuration loader.
+     */
+    readonly result: ConfigurationLoadResult;
+    /**
+     * Loaded configuration.
+     */
+    readonly configuration: Configuration;
+}
+/**
+ * Emitted after configuration validation succeeds.
+ */
+export interface ConfigurationValidatedEvent extends ConfigurationEvent {
+    readonly type: "configuration.validated";
+    /**
+     * Validation report.
+     */
+    readonly validation: ConfigurationValidationReport;
+    /**
+     * Validated configuration.
+     */
+    readonly configuration: Configuration;
+}
+/**
+ * Emitted when configuration initialization completes
+ * successfully.
+ */
+export interface ConfigurationReadyEvent extends ConfigurationEvent {
+    readonly type: "configuration.ready";
+    /**
+     * Active configuration.
+     */
+    readonly configuration: Configuration;
+    /**
+     * Validation report.
+     */
+    readonly validation: ConfigurationValidationReport;
+}
+/**
+ * Emitted when configuration initialization or reload fails.
+ */
+export interface ConfigurationFailedEvent extends ConfigurationEvent {
+    readonly type: "configuration.failed";
+    /**
+     * Error that caused the failure.
+     */
+    readonly error: unknown;
+    /**
+     * Configuration that was active before the failure,
+     * when available.
+     */
+    readonly previousConfiguration?: Configuration;
+}
+/**
+ * Emitted before a configuration reload begins.
+ */
+export interface ConfigurationReloadingEvent extends ConfigurationEvent {
+    readonly type: "configuration.reloading";
+    /**
+     * Configuration currently in use.
+     */
+    readonly previousConfiguration: Configuration;
+}
+/**
+ * Emitted after a configuration reload succeeds.
+ */
+export interface ConfigurationReloadedEvent extends ConfigurationEvent {
+    readonly type: "configuration.reloaded";
+    /**
+     * Previous configuration.
+     */
+    readonly previousConfiguration: Configuration;
+    /**
+     * New active configuration.
+     */
+    readonly configuration: Configuration;
+    /**
+     * Load result for the new configuration.
+     */
+    readonly load: ConfigurationLoadResult;
+    /**
+     * Validation result for the new configuration.
+     */
+    readonly validation: ConfigurationValidationReport;
+}
+/**
+ * Union of all configuration lifecycle events.
+ */
+export type ConfigurationLifecycleEvent = ConfigurationInitializingEvent | ConfigurationLoadedEvent | ConfigurationValidatedEvent | ConfigurationReadyEvent | ConfigurationFailedEvent | ConfigurationReloadingEvent | ConfigurationReloadedEvent;
+/**
+ * Configuration event type names.
+ */
+export declare const ConfigurationEventType: Readonly<{
+    readonly INITIALIZING: "configuration.initializing";
+    readonly LOADED: "configuration.loaded";
+    readonly VALIDATED: "configuration.validated";
+    readonly READY: "configuration.ready";
+    readonly FAILED: "configuration.failed";
+    readonly RELOADING: "configuration.reloading";
+    readonly RELOADED: "configuration.reloaded";
+}>;
+/**
+ * Type representing a valid configuration event name.
+ */
+export type ConfigurationEventTypeValue = (typeof ConfigurationEventType)[keyof typeof ConfigurationEventType];
+/**
+ * Configuration event listener.
+ */
+export type ConfigurationEventListener<T extends ConfigurationLifecycleEvent = ConfigurationLifecycleEvent> = (event: T) => void | Promise<void>;
+/**
+ * Creates the base metadata shared by configuration events.
+ */
+export declare function createConfigurationEventBase(type: string, state: ConfigurationManagerState): ConfigurationEvent;
+/**
+ * Creates a configuration initializing event.
+ */
+export declare function createConfigurationInitializingEvent(state: ConfigurationManagerState): ConfigurationInitializingEvent;
+/**
+ * Creates a configuration loaded event.
+ */
+export declare function createConfigurationLoadedEvent(state: ConfigurationManagerState, result: ConfigurationLoadResult): ConfigurationLoadedEvent;
+/**
+ * Creates a configuration validated event.
+ */
+export declare function createConfigurationValidatedEvent(state: ConfigurationManagerState, configuration: Configuration, validation: ConfigurationValidationReport): ConfigurationValidatedEvent;
+/**
+ * Creates a configuration ready event.
+ */
+export declare function createConfigurationReadyEvent(state: ConfigurationManagerState, configuration: Configuration, validation: ConfigurationValidationReport): ConfigurationReadyEvent;
+/**
+ * Creates a configuration failed event.
+ */
+export declare function createConfigurationFailedEvent(state: ConfigurationManagerState, error: unknown, previousConfiguration?: Configuration): ConfigurationFailedEvent;
+/**
+ * Creates a configuration reloading event.
+ */
+export declare function createConfigurationReloadingEvent(state: ConfigurationManagerState, previousConfiguration: Configuration): ConfigurationReloadingEvent;
+/**
+ * Creates a configuration reloaded event.
+ */
+export declare function createConfigurationReloadedEvent(state: ConfigurationManagerState, previousConfiguration: Configuration, configuration: Configuration, load: ConfigurationLoadResult, validation: ConfigurationValidationReport): ConfigurationReloadedEvent;
+//# sourceMappingURL=configurationEvents.events.d.ts.map