/**
 * Config validation and migration for SDK versioning.
 *
 * This module handles:
 * - Validating configs against the current SDK schema version
 * - Migrating old config formats to current version
 * - Providing warnings for version mismatches
 */
import type { CanvasConfigResponse } from './types';
/**
 * Result of config validation.
 */
export interface ConfigValidationResult {
    /** Whether the config is valid and can be used */
    valid: boolean;
    /** Warning messages (non-fatal issues) */
    warnings: string[];
    /** Error messages (fatal issues that prevent usage) */
    errors: string[];
    /** Migrated config if old version was detected */
    migratedConfig?: CanvasConfigResponse;
}
/**
 * Parse a schema version string into major and minor numbers.
 */
export declare function parseVersion(version: string): {
    major: number;
    minor: number;
};
/**
 * Validate and normalize a config, handling version mismatches.
 *
 * This function:
 * 1. Checks if config is valid object
 * 2. Compares config schema version with SDK version
 * 3. Migrates old configs to current version
 * 4. Returns validation result with warnings/errors
 *
 * @param config - Raw config from backend or fetcher
 * @returns Validation result with any migrations applied
 */
export declare function validateConfig(config: unknown): ConfigValidationResult;
/**
 * Check if a config needs migration.
 *
 * @param config - Config to check
 * @returns True if migration is needed
 */
export declare function needsMigration(config: unknown): boolean;
