wreq 1.1.0 → 1.2.1

data/lib/wreq_ruby/client.rb

@@ -35,9 +35,11 @@ unless defined?(Wreq)
       # @param user_agent [String, nil] Custom User-Agent header value.
       #   If not specified, a default user agent will be used.
       #
-      # @param headers [Hash{String=>String}, nil] Default headers to include
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Default headers to include
       #   in every request. Header names are case-insensitive. These headers
       #   can be overridden on a per-request basis.
+      # @param orig_headers [Array<String>, nil] Original header names used to
+      #   preserve raw header order and HTTP/1 case-sensitive header handling.
       #
       # @param referer [Boolean, nil] Whether to automatically send Referer
       #   headers when following redirects. When true, the previous URL will
@@ -236,17 +238,14 @@ unless defined?(Wreq)
       #
       # @param method [Wreq::Method] HTTP method to use
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -256,10 +255,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the client's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
       # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def request(method, url, **options)
       end
@@ -267,17 +269,14 @@ unless defined?(Wreq)
       # Send an HTTP GET request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -287,10 +286,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate GET requests from a specific address. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Supported on Linux/Android/Fuchsia; typically requires privileges.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def get(url, **options)
       end
@@ -298,17 +300,14 @@ unless defined?(Wreq)
       # Send an HTTP HEAD request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -318,10 +317,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate HEAD requests from a specific address. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1".
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0").
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def head(url, **options)
       end
@@ -329,17 +331,14 @@ unless defined?(Wreq)
       # Send an HTTP POST request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -349,10 +348,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate POST requests from a specific address.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE`.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def post(url, **options)
       end
@@ -360,17 +362,14 @@ unless defined?(Wreq)
       # Send an HTTP PUT request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -380,10 +379,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate PUT requests from a specific address.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE`.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def put(url, **options)
       end
@@ -391,17 +393,14 @@ unless defined?(Wreq)
       # Send an HTTP DELETE request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -411,10 +410,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate DELETE requests from a specific address.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE`.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def delete(url, **options)
       end
@@ -422,17 +424,14 @@ unless defined?(Wreq)
       # Send an HTTP OPTIONS request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -442,10 +441,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate OPTIONS requests from a specific address.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE`.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def options(url, **options)
       end
@@ -453,17 +455,14 @@ unless defined?(Wreq)
       # Send an HTTP TRACE request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -473,10 +472,13 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate OPTIONS requests from a specific address.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE`.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def trace(url, **options)
       end
@@ -484,17 +486,14 @@ unless defined?(Wreq)
       # Send an HTTP PATCH request.
       #
       # @param url [String] Target URL
-      # @param headers [Hash{String=>String}, nil] Custom headers for this request
-      # @param orig_headers [Hash{String=>String}, nil] Original headers (raw, unmodified)
+      # @param headers [Wreq::Headers, Hash{String=>String}, nil] Custom headers for this request
+      # @param orig_headers [Array<String>, nil] Original header names used to preserve raw header order and HTTP/1 case-sensitive header handling
       # @param default_headers [Hash{String=>String}, nil] Default headers to merge
       # @param query [Hash, nil] URL query parameters
-      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
-      # @param json [Object, nil] JSON body (will be serialized)
-      # @param body [String, IO, nil] Raw request body (string or stream)
       # @param auth [String, nil] Authorization header value
       # @param bearer_auth [String, nil] Bearer token for Authorization header
       # @param basic_auth [Array<String>, nil] Username and password for basic auth
-      # @param cookies [Array<String>, nil] Cookies to send
+      # @param cookies [Hash{String=>String}, String, nil] Cookies to send
       # @param allow_redirects [Boolean, nil] Whether to follow redirects
       # @param max_redirects [Integer, nil] Maximum number of redirects to follow
       # @param gzip [Boolean, nil] Enable gzip compression
@@ -504,13 +503,24 @@ unless defined?(Wreq)
       # @param timeout [Integer, nil] Total request timeout (seconds)
       # @param read_timeout [Integer, nil] Per-chunk read timeout (seconds)
       # @param proxy [String, nil] Proxy server URI
-      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful to originate OPTIONS requests from a specific address.
-      # @param interface [String, nil] Bind the socket to a network interface via `SO_BINDTODEVICE`.
+      # @param local_address [String, nil] Bind the request's local source IP address (IPv4/IPv6). Useful on multi-homed hosts to originate connections from a specific address or enforce source routing. Examples: "192.168.1.10", "10.0.0.5", "2001:db8::1". The address must exist on the host and be routable or the connection may fail.
+      # @param interface [String, nil] Bind the socket to a specific network interface via `SO_BINDTODEVICE` (e.g., "eth0", "wlan0", "tun0"). Effective only on systems that support the option (Linux/Android/Fuchsia) and typically requires privileges (root or CAP_NET_ADMIN).
       # @param emulation [Wreq::Emulation, nil] Device/OS emulation for this request
       # @param version [Wreq::Version, nil] HTTP version to use
+      # @param form [Hash{String=>String}, nil] Form data (application/x-www-form-urlencoded)
+      # @param json [Object, nil] JSON body (will be serialized)
+      # @param body [String, IO, nil] Raw request body (string or stream)
       # @return [Wreq::Response] HTTP response
       def patch(url, **options)
       end
     end
   end
 end
+
+module Wreq
+  class Client
+    def inspect
+      "#<Wreq::Client>"
+    end
+  end
+end

data/lib/wreq_ruby/cookie.rb

@@ -114,18 +114,11 @@ unless defined?(Wreq)
       def get_all
       end
 
-      # Add a cookie object for the given URL.
-      # @param cookie [Wreq::Cookie]
-      # @param url [String]
-      # @return [void]
-      def add_cookie(cookie, url)
-      end
-
       # Add a cookie from a Set-Cookie string for the given URL.
-      # @param cookie [String] A Set-Cookie string
+      # @param cookie [String, Wreq::Cookie] A Set-Cookie string
       # @param url [String]
       # @return [void]
-      def add_cookie_str(cookie, url)
+      def add(cookie, url)
       end
 
       # Remove a cookie by name for the given URL.
@@ -142,3 +135,22 @@ unless defined?(Wreq)
     end
   end
 end
+
+module Wreq
+  class Cookie
+    def inspect
+      parts = ["#<Wreq::Cookie", name]
+      parts << "domain=#{domain}" if domain
+      parts << "path=#{path}" if path
+      parts << "secure" if secure?
+      parts << "http_only" if http_only?
+      parts.join(" ") + ">"
+    end
+  end
+
+  class Jar
+    def inspect
+      "#<Wreq::Jar [#{get_all.length} cookies]>"
+    end
+  end
+end

data/lib/wreq_ruby/{emulation.rb → emulate.rb}

@@ -1,15 +1,19 @@
 # frozen_string_literal: true
 
 module Wreq
-  # Device emulation enumeration backed by Rust.
+  # Browser and client fingerprint profile enumeration backed by Rust.
   #
   # Variants are exposed as constants under this class.
-  # Each constant is an instance of {Wreq::EmulationDevice}.
+  # Each constant is an instance of {Wreq::Profile} and can be passed to
+  # {Wreq::Emulation.new} via the `profile:` keyword.
   #
-  # @example Using predefined constants
-  #   device = Wreq::EmulationDevice::Chrome117
-  #   device.class #=> Wreq::EmulationDevice
-  class EmulationDevice
+  # @example Using a predefined profile
+  #   profile = Wreq::Profile::Chrome117
+  #   profile.class #=> Wreq::Profile
+  #
+  # @example Applying a profile to emulation
+  #   emu = Wreq::Emulation.new(profile: Wreq::Profile::Chrome117)
+  class Profile
     # Constants are set by the native extension at initialization.
     # These stubs are for documentation only.
     unless const_defined?(:Chrome100)
@@ -52,6 +56,8 @@ module Wreq
       Chrome145 = nil
       Chrome146 = nil
       Chrome147 = nil
+      Chrome148 = nil
+
       Edge101 = nil
       Edge122 = nil
       Edge127 = nil
@@ -70,6 +76,8 @@ module Wreq
       Edge145 = nil
       Edge146 = nil
       Edge147 = nil
+      Edge148 = nil
+
       Firefox109 = nil
       Firefox117 = nil
       Firefox128 = nil
@@ -88,6 +96,9 @@ module Wreq
       Firefox147 = nil
       Firefox148 = nil
       Firefox149 = nil
+      Firefox150 = nil
+      Firefox151 = nil
+
       SafariIos17_2 = nil
       SafariIos17_4_1 = nil
       SafariIos16_5 = nil
@@ -111,10 +122,13 @@ module Wreq
       Safari26 = nil
       Safari26_1 = nil
       Safari26_2 = nil
+      Safari26_3 = nil
+      Safari26_4 = nil
       SafariIos26 = nil
       SafariIos26_2 = nil
       SafariIPad26 = nil
       SafariIpad26_2 = nil
+
       OkHttp3_9 = nil
       OkHttp3_11 = nil
       OkHttp3_13 = nil
@@ -123,6 +137,7 @@ module Wreq
       OkHttp4_10 = nil
       OkHttp4_12 = nil
       OkHttp5 = nil
+
       Opera116 = nil
       Opera117 = nil
       Opera118 = nil
@@ -138,25 +153,30 @@ module Wreq
       Opera128 = nil
       Opera129 = nil
       Opera130 = nil
+      Opera131 = nils
     end
 
     unless method_defined?(:to_s)
-      # Returns a string representation of the emulation device.
-      # @return [String] Emulation device as string
+      # Returns the profile name.
+      # @return [String] Profile name as a string
       def to_s
       end
     end
   end
 
-  # Operating system emulation enumeration backed by Rust.
+  # Operating system platform enumeration backed by Rust.
   #
   # Variants are exposed as constants under this class.
-  # Each constant is an instance of {Wreq::EmulationOS}.
+  # Each constant is an instance of {Wreq::Platform} and can be passed to
+  # {Wreq::Emulation.new} via the `platform:` keyword.
   #
-  # @example Using predefined constants
-  #   os = Wreq::EmulationOS::Windows
-  #   os.class #=> Wreq::EmulationOS
-  class EmulationOS
+  # @example Using a predefined platform
+  #   platform = Wreq::Platform::Windows
+  #   platform.class #=> Wreq::Platform
+  #
+  # @example Applying a platform to emulation
+  #   emu = Wreq::Emulation.new(platform: Wreq::Platform::Windows)
+  class Platform
     # Constants are set by the native extension at initialization.
     # These stubs are for documentation only.
     unless const_defined?(:Windows)
@@ -168,8 +188,8 @@ module Wreq
     end
 
     unless method_defined?(:to_s)
-      # Returns a string representation of the emulation OS.
-      # @return [String] Emulation OS as string
+      # Returns the platform name.
+      # @return [String] Platform name as a string
       def to_s
       end
     end
@@ -177,26 +197,34 @@ module Wreq
 
   # Emulation option wrapper.
   #
-  # This class wraps device and OS emulation options and provides
-  # a unified interface for browser environment simulation.
-  # The actual implementation is provided by Rust for performance.
+  # This class combines a fingerprint `profile`, an OS `platform`, and toggles
+  # for HTTP/2 and automatic default headers. The actual implementation is
+  # provided by Rust.
+  #
+  # `profile:` defaults to the library's default profile when omitted.
+  # `platform:` defaults to the library's default platform when omitted.
   #
   # @example Create an emulation option
-  #   emu = Wreq::Emulation.new(device: Wreq::EmulationDevice::Chrome117, os: Wreq::EmulationOS::Windows)
+  #   emu = Wreq::Emulation.new(
+  #     profile: Wreq::Profile::Chrome117,
+  #     platform: Wreq::Platform::Windows,
+  #     http2: true,
+  #     headers: true
+  #   )
   #
-  # @param device [Wreq::EmulationDevice] Device profile (optional)
-  # @param os [Wreq::EmulationOS] Operating system profile (optional)
-  # @param skip_http2 [Boolean] Whether to skip HTTP/2 (optional)
-  # @param skip_headers [Boolean] Whether to skip default headers (optional)
+  # @param profile [Wreq::Profile, nil] Fingerprint profile to emulate
+  # @param platform [Wreq::Platform, nil] Operating system platform to emulate
+  # @param http2 [Boolean] Whether HTTP/2 support is enabled
+  # @param headers [Boolean] Whether default emulation headers are enabled
   class Emulation
     # Native fields and methods are set by the extension.
     # This stub is for documentation only.
     unless method_defined?(:new)
-      # @param device [Wreq::EmulationDevice] Device profile (optional)
-      # @param os [Wreq::EmulationOS] Operating system profile (optional)
-      # @param skip_http2 [Boolean] Whether to skip HTTP/2 (optional)
-      # @param skip_headers [Boolean] Whether to skip default headers (optional)
-      def self.new(device: nil, os: nil, skip_http2: false, skip_headers: false)
+      # @param profile [Wreq::Profile, nil] Fingerprint profile to emulate
+      # @param platform [Wreq::Platform, nil] Operating system platform to emulate
+      # @param http2 [Boolean] Whether HTTP/2 support is enabled
+      # @param headers [Boolean] Whether default emulation headers are enabled
+      def self.new(profile: nil, platform: nil, http2: true, headers: true)
       end
     end
   end

data/lib/wreq_ruby/header.rb

@@ -195,3 +195,11 @@ unless defined?(Wreq)
     end
   end
 end
+
+module Wreq
+  class Headers
+    def inspect
+      "#<Wreq::Headers [#{length} headers]>"
+    end
+  end
+end

data/lib/wreq_ruby/http.rb

@@ -49,6 +49,20 @@ module Wreq
       def to_s
       end
     end
+
+    # Compares HTTP versions by semantic value, not object identity.
+    #
+    # This method is implemented by the native extension.
+    # When comparing with non-{Wreq::Version} objects, it returns false.
+    #
+    # @param other [Object] object to compare against
+    # @return [Boolean] true when both represent the same HTTP version
+    # @example
+    #   Wreq::Version::HTTP_11 == response.version
+    unless method_defined?(:==)
+      def ==(other)
+      end
+    end
   end
 
   # HTTP status code wrapper.
@@ -130,3 +144,17 @@ module Wreq
     end
   end
 end
+
+module Wreq
+  class StatusCode
+    def inspect
+      "#<Wreq::StatusCode #{self}>"
+    end
+  end
+
+  class Version
+    def inspect
+      "#<Wreq::Version #{self}>"
+    end
+  end
+end