HTTP Client Chunked Support (#2414)

* HTTP Client Chunked Support

* fix order

* Update http-client.md

Author: stephenberry

docs/networking/http-client.md

@@ -33,6 +33,7 @@ int main() {
 ## Features
 
 - **Connection Pooling**: Automatically reuses connections for better performance
+- **Chunked Transfer-Encoding**: Transparent decoding of chunked responses across synchronous, asynchronous, and streaming paths
 - **Asynchronous Operations**: Non-blocking requests with futures or completion handlers
 - **JSON Support**: Built-in JSON serialization for POST requests
 - **Thread-Safe**: Multiple threads can safely use the same client instance
@@ -445,6 +446,16 @@ if (url_parts) {
 }
 ```
 
+## Chunked Transfer-Encoding
+
+Responses using `Transfer-Encoding: chunked` are automatically decoded. This is transparent to the caller -- `response_body` contains the fully assembled body regardless of whether the server used `Content-Length` or chunked encoding.
+
+- Chunk extensions (`;key=value`) are ignored per RFC 7230
+- Trailer headers after the terminal chunk are consumed and discarded
+- Malformed chunk sizes return a `protocol_error`
+
+For streaming requests (`stream_request_v2`), chunked data is delivered incrementally via the `on_data` callback as each chunk arrives.
+
 ## Performance Notes
 
 - The client automatically pools connections for better performance when making multiple requests to the same host