Function extract_archive 

pub fn extract_archive(
    archive_path: &Path,
    dest_dir: &Path,
) -> Result<Vec<PathBuf>>

Extracts an archive to the given destination directory.

Dispatches to the appropriate format-specific extractor based on detect_format. Returns the list of extracted file paths.

Errors

Returns an error if the archive format is unrecognised or extraction fails (corrupted, password-protected, etc.).