@spec extract_entry(String.t() | binary(), String.t()) ::
  {:ok, binary()} | {:error, term()}

Extracts and decompresses a specific file by its filename from the ZIP archive. Accepts either a file path or a binary containing ZIP data.

Returns {:ok, decompressed_binary} or {:error, reason}.

@spec list_entries(String.t() | binary()) :: {:ok, [Z64.Entry.t()]} | {:error, term()}

Lists all file entries inside the given ZIP archive. Accepts either a file path or a binary containing ZIP data.

Returns {:ok, [%Z64.Entry{filename: "file.txt", compressed_size: 100, uncompressed_size: 200, compression_method: 9, ...}]} or {:error, reason}.

@spec unzip(String.t() | binary(), String.t()) :: :ok | {:error, term()}

Unzips all file entries from the ZIP archive and writes them into output_dir. Accepts either a file path or a binary containing ZIP data.

Returns :ok or {:error, reason}.