Struct Response 

pub struct Response { /* private fields */ }

A high-level response wrapper providing transparent decompression and body management.

Response unifies both HTTP/2 and HTTP/3 connection payloads under a single, public-API-compatible interface, implementing transparent decompression on hot paths.

Key Architecture:

• Encapsulation: Keeps the underlying transport polymorphic (H2 vs H3) transparent to the client caller.
• Zero-Copy Decompression: Employs stack-allocated decompressors (brotli_decompressor, zstd, flate2) upon bytes() invocation, decoding raw buffers directly into final owned storage.

Implementations

impl Response

pub fn new( status: StatusCode, headers: HeaderMap, body: ResponseBody, url: String, ) -> Self

Creates a new Response from polymorphic parts.

pub fn status(&self) -> StatusCode

Returns the HTTP status code.

pub fn headers(&self) -> &HeaderMap

Returns a reference to the header map.

pub fn url(&self) -> &str

Returns the final post-redirect URL.

pub async fn bytes(self) -> Result<Bytes>

Collects the response body and returns the decompressed bytes.

This method is async as it must support asynchronous polling of H2 chunks. Supports gzip, br, and zstd encodings.

Implementation Strategy:

1. Polymorphic Assembly: Accumulates body frames from TCP/H2 streaming loops, or yields the pre-buffered UDP/H3 vector.
2. Transport Content-Encoding Negotiation: Inspects the Content-Encoding header and routes bytes dynamically through the appropriate decompression block (Brotli, Zstd, or Gzip).

pub async fn text(self) -> Result<String>

Collects the body and decodes it as a UTF-8 string.

pub async fn json<T: DeserializeOwned>(self) -> Result<T>

Collects the body and decodes it as JSON.