Harden header env JSON parsing error wrapping

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

Author: cursoragent

hyperbrowser/header_utils.py

@@ -112,7 +112,7 @@ def parse_headers_env_json(raw_headers: Optional[str]) -> Optional[Dict[str, str
         return None
     try:
         parsed_headers = json.loads(raw_headers)
-    except json.JSONDecodeError as exc:
+    except (json.JSONDecodeError, ValueError, RecursionError, TypeError) as exc:
         raise HyperbrowserError(
             "HYPERBROWSER_HEADERS must be valid JSON object"
         ) from exc

tests/test_header_utils.py

@@ -101,6 +101,20 @@ def test_parse_headers_env_json_rejects_invalid_json():
         parse_headers_env_json("{invalid")
 
 
+def test_parse_headers_env_json_wraps_recursive_json_errors(
+    monkeypatch: pytest.MonkeyPatch,
+):
+    def _raise_recursion_error(_raw_headers: str):
+        raise RecursionError("nested too deeply")
+
+    monkeypatch.setattr("hyperbrowser.header_utils.json.loads", _raise_recursion_error)
+
+    with pytest.raises(
+        HyperbrowserError, match="HYPERBROWSER_HEADERS must be valid JSON object"
+    ):
+        parse_headers_env_json('{"X-Trace-Id":"abc123"}')
+
+
 def test_parse_headers_env_json_rejects_non_mapping_payload():
     with pytest.raises(
         HyperbrowserError,