/**
 * Storage provider interface for backup destinations.
 * Implementations handle the mechanics of uploading, downloading,
 * and managing files on a specific storage backend.
 */
export interface StorageProvider {
  /** Upload a local file to the storage destination */
  upload(localPath: string, remotePath: string): Promise<void>;
  /** Download a file from storage to a local path */
  download(remotePath: string, localPath: string): Promise<void>;
  /** Delete a file from storage */
  delete(remotePath: string): Promise<void>;
  /** List files under a prefix */
  list(prefix: string): Promise<string[]>;
  /** Test connectivity and permissions (write/read/delete a test file) */
  verify(): Promise<StorageVerifyResult>;
  /** Create initial directory structure for backups */
  initialize(): Promise<void>;
}

export interface StorageVerifyResult {
  success: boolean;
  message: string;
}