/**
 * Migration utilities for converting v1 (old binary format) to v2 (WAL format).
 *
 * v1 format:
 * - Header: "EMBD" (4) + version (2) + dimension (4) + reserved (6) = 16 bytes
 * - Records: keyLen (2) + key (N) + embedding (D*4) + recordLenFooter (4)
 *
 * v2 format:
 * - Uses WAL-based storage with checksums and sequence numbers
 */
/**
 * Detect the format version of a database file.
 * Returns null if the file doesn't exist or is not a valid database.
 */
export declare function detectVersion(filePath: string): Promise<number | null>;
/**
 * Migrate a v1 database to v2 format.
 * Creates a backup of the original file before migration.
 */
export declare function migrateV1ToV2(sourcePath: string, backupPath?: string): Promise<void>;
/**
 * Check if migration is needed and perform it automatically.
 * Returns the path to use (may be different if migration occurred).
 */
export declare function ensureV2Format(dataPath: string, _dimension: number): Promise<void>;
//# sourceMappingURL=migration.d.ts.map