Accept mapping extension list response payloads

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

Author: cursoragent

hyperbrowser/client/managers/extension_utils.py

@@ -1,3 +1,4 @@
+from collections.abc import Mapping
 from typing import Any, List
 
 from hyperbrowser.exceptions import HyperbrowserError
@@ -9,13 +10,19 @@ def _get_type_name(value: Any) -> str:
 
 
 def parse_extension_list_response_data(response_data: Any) -> List[ExtensionResponse]:
-    if not isinstance(response_data, dict):
+    if not isinstance(response_data, Mapping):
         raise HyperbrowserError(
-            f"Expected dict response but got {_get_type_name(response_data)}"
+            f"Expected mapping response but got {_get_type_name(response_data)}"
         )
     if "extensions" not in response_data:
+        available_keys = ", ".join(sorted(str(key) for key in response_data.keys()))
+        if available_keys:
+            available_keys = f"[{available_keys}]"
+        else:
+            available_keys = "[]"
         raise HyperbrowserError(
-            f"Expected 'extensions' key in response but got {response_data.keys()}"
+            "Expected 'extensions' key in response but got "
+            f"{available_keys} keys"
         )
     if not isinstance(response_data["extensions"], list):
         raise HyperbrowserError(
@@ -24,13 +31,13 @@ def parse_extension_list_response_data(response_data: Any) -> List[ExtensionResp
         )
     parsed_extensions: List[ExtensionResponse] = []
     for index, extension in enumerate(response_data["extensions"]):
-        if not isinstance(extension, dict):
+        if not isinstance(extension, Mapping):
             raise HyperbrowserError(
                 "Expected extension object at index "
                 f"{index} but got {_get_type_name(extension)}"
             )
         try:
-            parsed_extensions.append(ExtensionResponse(**extension))
+            parsed_extensions.append(ExtensionResponse(**dict(extension)))
         except HyperbrowserError:
             raise
         except Exception as exc:

tests/test_extension_utils.py

@@ -1,4 +1,5 @@
 import pytest
+from types import MappingProxyType
 
 from hyperbrowser.client.managers import extension_utils
 from hyperbrowser.client.managers.extension_utils import (
@@ -26,12 +27,14 @@ def test_parse_extension_list_response_data_parses_extensions():
 
 
 def test_parse_extension_list_response_data_rejects_non_dict_payload():
-    with pytest.raises(HyperbrowserError, match="Expected dict response"):
+    with pytest.raises(HyperbrowserError, match="Expected mapping response"):
         parse_extension_list_response_data(["not-a-dict"])  # type: ignore[arg-type]
 
 
 def test_parse_extension_list_response_data_rejects_missing_extensions_key():
-    with pytest.raises(HyperbrowserError, match="Expected 'extensions' key"):
+    with pytest.raises(
+        HyperbrowserError, match="Expected 'extensions' key in response but got \\[\\] keys"
+    ):
         parse_extension_list_response_data({})
 
 
@@ -77,3 +80,38 @@ def __init__(self, **kwargs):
         parse_extension_list_response_data({"extensions": [{"id": "ext_1"}]})
 
     assert exc_info.value.original_error is None
+
+
+def test_parse_extension_list_response_data_accepts_mapping_proxy_payload():
+    extension_mapping = MappingProxyType(
+        {
+            "id": "ext_123",
+            "name": "my-extension",
+            "createdAt": "2026-01-01T00:00:00Z",
+            "updatedAt": "2026-01-01T00:00:00Z",
+        }
+    )
+    payload = MappingProxyType({"extensions": [extension_mapping]})
+
+    parsed = parse_extension_list_response_data(payload)
+
+    assert len(parsed) == 1
+    assert parsed[0].id == "ext_123"
+
+
+def test_parse_extension_list_response_data_missing_key_lists_available_keys():
+    with pytest.raises(
+        HyperbrowserError,
+        match=(
+            "Expected 'extensions' key in response but got "
+            "\\[createdAt, id, name, updatedAt\\] keys"
+        ),
+    ):
+        parse_extension_list_response_data(
+            {
+                "id": "ext_123",
+                "name": "my-extension",
+                "createdAt": "2026-01-01T00:00:00Z",
+                "updatedAt": "2026-01-01T00:00:00Z",
+            }
+        )