import type { BackupMetadata, FileEntry, SyncpointConfig } from '../utils/types.js';
/**
 * Create a full metadata object for a backup.
 */
export declare function createMetadata(files: FileEntry[], config: SyncpointConfig): BackupMetadata;
/**
 * Parse and validate metadata from a buffer or string.
 */
export declare function parseMetadata(data: Buffer | string): BackupMetadata;
/**
 * Compute the SHA-256 hash of a file.
 * Returns "sha256:<hex>"
 */
export declare function computeFileHash(filePath: string): Promise<string>;
/**
 * Collect file information: size, hash, type detection.
 * @param absolutePath  The real filesystem path
 * @param logicalPath   The display path (e.g. ~/.zshrc)
 */
export declare function collectFileInfo(absolutePath: string, logicalPath: string): Promise<FileEntry>;