import type { BackupInfo, RestoreOptions, RestorePlan, RestoreResult, SyncpointConfig } from '../utils/types.js';
/**
 * List all backup archives in the backup directory, sorted by date desc.
 */
export declare function getBackupList(config?: SyncpointConfig): Promise<BackupInfo[]>;
/**
 * Build a restore plan by reading metadata and comparing with current files.
 */
export declare function getRestorePlan(archivePath: string): Promise<RestorePlan>;
/**
 * Create a safety backup of the given file paths before restoring.
 * Returns the path to the safety backup archive.
 */
export declare function createSafetyBackup(filePaths: string[]): Promise<string>;
/**
 * Restore files from a backup archive.
 *
 * Flow:
 *   1. Read metadata
 *   2. Build restore plan
 *   3. Create safety backup of files that will be overwritten
 *   4. Extract and copy files to their target locations
 */
export declare function restoreBackup(archivePath: string, options?: RestoreOptions): Promise<RestoreResult>;