Browser network policy (#111)

* expose browser network policies

* bump version

Author: Dingway98

README.md

@@ -54,6 +54,23 @@ session = client.sessions.create(
 )
 ```
 
+Browser sessions can also use an outbound network policy. Omitting these fields
+keeps the default unrestricted behavior:
+
+```python
+session = client.sessions.create(
+    {
+        "allow_internet_access": False,
+        "allow_out": ["example.com"],
+        "deny_out": ["0.0.0.0/0"],
+    }
+)
+```
+
+Direct browser policies accept domains, IPv4 addresses, and CIDR ranges in
+`allow_out`; `deny_out` accepts IPv4 addresses and CIDR ranges. With a proxy,
+allow rules must be domains and the only supported deny rule is `0.0.0.0/0`.
+
 Existing Pydantic request classes remain accepted, so upgrading does not require
 an immediate rewrite:
 

hyperbrowser/models/session.py

@@ -144,6 +144,11 @@ class SessionLaunchState(BaseModel):
         default=None, alias="enableVideoWebRecording"
     )
     enable_log_capture: Optional[bool] = Field(default=None, alias="enableLogCapture")
+    allow_internet_access: Optional[bool] = Field(
+        default=None, alias="allowInternetAccess"
+    )
+    allow_out: Optional[List[str]] = Field(default=None, alias="allowOut")
+    deny_out: Optional[List[str]] = Field(default=None, alias="denyOut")
     accept_cookies: Optional[bool] = Field(default=None, alias="acceptCookies")
     solver_type: Optional[CaptchaSolverType] = Field(default=None, alias="solverType")
     profile: Optional[SessionProfile] = Field(default=None, alias="profile")
@@ -472,6 +477,11 @@ class CreateSessionParams(BaseModel):
     timeout_minutes: Optional[int] = Field(
         default=None, serialization_alias="timeoutMinutes"
     )
+    allow_internet_access: Optional[bool] = Field(
+        default=None, serialization_alias="allowInternetAccess"
+    )
+    allow_out: Optional[List[str]] = Field(default=None, serialization_alias="allowOut")
+    deny_out: Optional[List[str]] = Field(default=None, serialization_alias="denyOut")
     enable_window_manager: Optional[bool] = Field(
         default=None, serialization_alias="enableWindowManager"
     )

hyperbrowser/types/session.py

@@ -149,6 +149,9 @@ class CreateSessionParams(TypedDict, total=False):
     save_downloads: Optional[bool]
     image_captcha_params: Optional[List[ImageCaptchaParam]]
     timeout_minutes: Optional[int]
+    allow_internet_access: Optional[bool]
+    allow_out: Optional[List[str]]
+    deny_out: Optional[List[str]]
     enable_window_manager: Optional[bool]
     enable_window_manager_taskbar: Optional[bool]
     region: Optional[SessionRegion]

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hyperbrowser"
-version = "1.0.0"
+version = "1.1.0"
 description = "Python SDK for hyperbrowser"
 authors = ["Nikhil Shahi <nshahi1998@gmail.com>"]
 license = "MIT"