import { Config } from './schemas';
/**
 * Configuration error class for better error handling
 */
export declare class ConfigurationError extends Error {
    cause?: Error | undefined;
    constructor(message: string, cause?: Error | undefined);
}
/**
 * Configuration source interface
 */
export interface ConfigSource {
    type: 'environment' | 'file' | 'default';
    priority: number;
    load(): Promise<Partial<Config>>;
}
/**
 * Configuration manager that handles loading and merging configuration from multiple sources
 */
export declare class ConfigurationManager {
    private sources;
    private cachedConfig?;
    constructor(configFilePath?: string);
    /**
     * Load configuration from all sources with proper priority
     */
    loadConfig(): Promise<Config>;
    /**
     * Validate configuration and provide clear error messages
     */
    validateConfig(config: Partial<Config>): Promise<Config>;
    /**
     * Merge multiple configuration objects with deep merging
     */
    private mergeConfigs;
    /**
     * Clear cached configuration (useful for testing or config reloading)
     */
    clearCache(): void;
    /**
     * Get configuration summary for debugging
     */
    getConfigSummary(): string;
}
/**
 * Create a configuration manager instance
 */
export declare function createConfigurationManager(configFilePath?: string): ConfigurationManager;