Require host component in configured base URLs

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

Author: cursoragent

hyperbrowser/config.py

@@ -1,5 +1,6 @@
 from dataclasses import dataclass
 import json
+from urllib.parse import urlparse
 from typing import Dict, Mapping, Optional
 import os
 
@@ -27,10 +28,14 @@ def __post_init__(self) -> None:
         self.base_url = self.base_url.strip().rstrip("/")
         if not self.base_url:
             raise HyperbrowserError("base_url must not be empty")
-        if not (
-            self.base_url.startswith("https://") or self.base_url.startswith("http://")
+        parsed_base_url = urlparse(self.base_url)
+        if (
+            parsed_base_url.scheme not in {"https", "http"}
+            or not parsed_base_url.netloc
         ):
-            raise HyperbrowserError("base_url must start with 'https://' or 'http://'")
+            raise HyperbrowserError(
+                "base_url must start with 'https://' or 'http://' and include a host"
+            )
         if self.headers is not None:
             normalized_headers: Dict[str, str] = {}
             for key, value in self.headers.items():

tests/test_config.py

@@ -117,6 +117,14 @@ def test_client_config_from_env_rejects_invalid_base_url(monkeypatch):
         ClientConfig.from_env()
 
 
+def test_client_config_from_env_rejects_base_url_without_host(monkeypatch):
+    monkeypatch.setenv("HYPERBROWSER_API_KEY", "test-key")
+    monkeypatch.setenv("HYPERBROWSER_BASE_URL", "https://")
+
+    with pytest.raises(HyperbrowserError, match="include a host"):
+        ClientConfig.from_env()
+
+
 def test_client_config_normalizes_whitespace_and_trailing_slash():
     config = ClientConfig(api_key="  test-key  ", base_url=" https://example.local/ ")
 
@@ -145,6 +153,9 @@ def test_client_config_rejects_empty_or_invalid_base_url():
     with pytest.raises(HyperbrowserError, match="base_url must start with"):
         ClientConfig(api_key="test-key", base_url="api.hyperbrowser.ai")
 
+    with pytest.raises(HyperbrowserError, match="include a host"):
+        ClientConfig(api_key="test-key", base_url="http://")
+
 
 def test_client_config_normalizes_headers_to_internal_copy():
     headers = {"X-Correlation-Id": "abc123"}