Support mapping payloads in transport error extraction

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

hyperbrowser/transport/error_utils.py

@@ -1,6 +1,7 @@
 import json
 from numbers import Real
 import re
+from collections.abc import Mapping
 from typing import Any
 
 import httpx
@@ -138,7 +139,7 @@ def _stringify_error_value(value: Any, *, _depth: int = 0) -> str:
         return _safe_to_string(value)
     if isinstance(value, str):
         return value
-    if isinstance(value, dict):
+    if isinstance(value, Mapping):
         for key in ("message", "error", "detail", "errors", "msg", "title", "reason"):
             try:
                 nested_value = value.get(key)
@@ -195,7 +196,7 @@ def _fallback_message() -> str:
         return _fallback_message()
 
     extracted_message: str
-    if isinstance(error_data, dict):
+    if isinstance(error_data, Mapping):
         for key in ("message", "error", "detail", "errors", "title", "reason"):
             try:
                 message = error_data.get(key)

tests/test_transport_error_utils.py

@@ -1,5 +1,6 @@
 import httpx
 import pytest
+from types import MappingProxyType
 
 from hyperbrowser.transport.error_utils import (
     extract_error_message,
@@ -689,6 +690,15 @@ def test_extract_error_message_handles_unstringifiable_message_values():
     assert message == "<unstringifiable _UnstringifiableErrorValue>"
 
 
+def test_extract_error_message_supports_mapping_proxy_payloads():
+    message = extract_error_message(
+        _DummyResponse(MappingProxyType({"detail": "mapped detail"})),
+        RuntimeError("fallback detail"),
+    )
+
+    assert message == "mapped detail"
+
+
 def test_extract_error_message_handles_dict_get_failures():
     message = extract_error_message(
         _DummyResponse({"message": _BrokenGetErrorDict({"inner": object()})}),