hyperbrowser 0.86.0__tar.gz → 0.88.0__tar.gz

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 0.86.0
+Version: 0.88.0
 Summary: Python SDK for hyperbrowser
 License: MIT
 License-File: LICENSE

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/client/managers/async_manager/sandbox.py

@@ -7,9 +7,14 @@ from ....models.sandbox import (
     SandboxExecParams,
     SandboxExposeParams,
     SandboxExposeResult,
+    SandboxImageListResponse,
+    SandboxListParams,
+    SandboxListResponse,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxRuntimeSession,
+    SandboxSnapshotListParams,
+    SandboxSnapshotListResponse,
     StartSandboxFromSnapshotParams,
 )
 from ....models.session import BasicResponse
@@ -288,6 +293,34 @@ class SandboxManager:
         await sandbox.connect()
         return sandbox
 
+    async def list(
+        self, params: SandboxListParams = SandboxListParams()
+    ) -> SandboxListResponse:
+        if not isinstance(params, SandboxListParams):
+            raise TypeError("params must be a SandboxListParams instance")
+        payload = await self._request(
+            "GET",
+            "/sandboxes",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxListResponse(**payload)
+
+    async def list_images(self) -> SandboxImageListResponse:
+        payload = await self._request("GET", "/images")
+        return SandboxImageListResponse(**payload)
+
+    async def list_snapshots(
+        self, params: SandboxSnapshotListParams = SandboxSnapshotListParams()
+    ) -> SandboxSnapshotListResponse:
+        if not isinstance(params, SandboxSnapshotListParams):
+            raise TypeError("params must be a SandboxSnapshotListParams instance")
+        payload = await self._request(
+            "GET",
+            "/snapshots",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxSnapshotListResponse(**payload)
+
     async def stop(self, sandbox_id: str) -> BasicResponse:
         payload = await self._request("PUT", f"/sandbox/{sandbox_id}/stop")
         return BasicResponse(**payload)

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/client/managers/async_manager/session.py

@@ -15,6 +15,7 @@ from ....models.session import (
     SessionEventLogListResponse,
     SessionEventLog,
     UpdateSessionProfileParams,
+    UpdateSessionProxyParams,
     SessionGetParams,
 )
 
@@ -183,6 +184,20 @@ class SessionManager:
         )
         return BasicResponse(**response.data)
 
+    async def update_proxy_params(
+        self,
+        id: str,
+        params: UpdateSessionProxyParams,
+    ) -> BasicResponse:
+        response = await self._client.transport.put(
+            self._client._build_url(f"/session/{id}/update"),
+            data={
+                "type": "proxy",
+                "params": params.model_dump(exclude_none=True, by_alias=True),
+            },
+        )
+        return BasicResponse(**response.data)
+
     def _warn_update_profile_params_boolean_deprecated(self) -> None:
         if SessionManager._has_warned_update_profile_params_boolean_deprecated:
             return

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/client/managers/sync_manager/sandbox.py

@@ -7,9 +7,14 @@ from ....models.sandbox import (
     SandboxExecParams,
     SandboxExposeParams,
     SandboxExposeResult,
+    SandboxImageListResponse,
+    SandboxListParams,
+    SandboxListResponse,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxRuntimeSession,
+    SandboxSnapshotListParams,
+    SandboxSnapshotListResponse,
     StartSandboxFromSnapshotParams,
 )
 from ....models.session import BasicResponse
@@ -288,6 +293,34 @@ class SandboxManager:
         sandbox.connect()
         return sandbox
 
+    def list(
+        self, params: SandboxListParams = SandboxListParams()
+    ) -> SandboxListResponse:
+        if not isinstance(params, SandboxListParams):
+            raise TypeError("params must be a SandboxListParams instance")
+        payload = self._request(
+            "GET",
+            "/sandboxes",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxListResponse(**payload)
+
+    def list_images(self) -> SandboxImageListResponse:
+        payload = self._request("GET", "/images")
+        return SandboxImageListResponse(**payload)
+
+    def list_snapshots(
+        self, params: SandboxSnapshotListParams = SandboxSnapshotListParams()
+    ) -> SandboxSnapshotListResponse:
+        if not isinstance(params, SandboxSnapshotListParams):
+            raise TypeError("params must be a SandboxSnapshotListParams instance")
+        payload = self._request(
+            "GET",
+            "/snapshots",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxSnapshotListResponse(**payload)
+
     def stop(self, sandbox_id: str) -> BasicResponse:
         payload = self._request("PUT", f"/sandbox/{sandbox_id}/stop")
         return BasicResponse(**payload)

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/client/managers/sync_manager/session.py

@@ -13,8 +13,8 @@ from ....models.session import (
     UploadFileResponse,
     SessionEventLogListParams,
     SessionEventLogListResponse,
-    SessionEventLog,
     UpdateSessionProfileParams,
+    UpdateSessionProxyParams,
     SessionGetParams,
 )
 
@@ -179,6 +179,20 @@ class SessionManager:
         )
         return BasicResponse(**response.data)
 
+    def update_proxy_params(
+        self,
+        id: str,
+        params: UpdateSessionProxyParams,
+    ) -> BasicResponse:
+        response = self._client.transport.put(
+            self._client._build_url(f"/session/{id}/update"),
+            data={
+                "type": "proxy",
+                "params": params.model_dump(exclude_none=True, by_alias=True),
+            },
+        )
+        return BasicResponse(**response.data)
+
     def _warn_update_profile_params_boolean_deprecated(self) -> None:
         if SessionManager._has_warned_update_profile_params_boolean_deprecated:
             return

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/models/__init__.py

@@ -234,6 +234,8 @@ from .session import (
     UploadFileResponse,
     ImageCaptchaParam,
     UpdateSessionProfileParams,
+    UpdateSessionProxyLocationParams,
+    UpdateSessionProxyParams,
 )
 from .sandbox import (
     SandboxStatus,
@@ -246,6 +248,12 @@ from .sandbox import (
     StartSandboxFromSnapshotParams,
     SandboxListParams,
     SandboxListResponse,
+    SandboxImageListResponse,
+    SandboxImageSummary,
+    SandboxSnapshotStatus,
+    SandboxSnapshotListResponse,
+    SandboxSnapshotSummary,
+    SandboxSnapshotListParams,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxExposeParams,
@@ -479,6 +487,8 @@ __all__ = [
     "UploadFileResponse",
     "ImageCaptchaParam",
     "UpdateSessionProfileParams",
+    "UpdateSessionProxyLocationParams",
+    "UpdateSessionProxyParams",
     # sandbox
     "SandboxStatus",
     "SandboxRegion",
@@ -490,6 +500,12 @@ __all__ = [
     "StartSandboxFromSnapshotParams",
     "SandboxListParams",
     "SandboxListResponse",
+    "SandboxImageListResponse",
+    "SandboxImageSummary",
+    "SandboxSnapshotStatus",
+    "SandboxSnapshotListResponse",
+    "SandboxSnapshotSummary",
+    "SandboxSnapshotListParams",
     "SandboxMemorySnapshotParams",
     "SandboxMemorySnapshotResult",
     "SandboxExposeParams",

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/models/sandbox.py

@@ -23,6 +23,7 @@ SandboxProcessStatus = Literal[
     "killed",
     "timed_out",
 ]
+SandboxSnapshotStatus = Literal["creating", "created", "failed"]
 SandboxFileType = Literal["file", "dir"]
 SandboxFileEncoding = Literal["utf8", "base64"]
 SandboxFileReadFormat = Literal["text", "bytes", "blob", "stream"]
@@ -164,10 +165,9 @@ class StartSandboxFromSnapshotParams(CreateSandboxParams):
 
 
 class SandboxListParams(SandboxBaseModel):
-    status: Optional[SandboxStatus] = None
-    page: Optional[int] = None
-    limit: Optional[int] = None
-    search: Optional[str] = None
+    status: Optional[SandboxStatus] = Field(default=None, exclude=None)
+    page: int = Field(default=1, ge=1)
+    limit: int = Field(default=10, ge=1)
 
 
 class SandboxListResponse(SandboxBaseModel):
@@ -177,6 +177,51 @@ class SandboxListResponse(SandboxBaseModel):
     per_page: int = Field(alias="perPage")
 
 
+class SandboxImageSummary(SandboxBaseModel):
+    id: str
+    image_name: str = Field(alias="imageName")
+    namespace: str
+    uploaded: bool
+    created_at: datetime = Field(alias="createdAt")
+    updated_at: datetime = Field(alias="updatedAt")
+
+
+class SandboxImageListResponse(SandboxBaseModel):
+    images: List[SandboxImageSummary]
+    # TODO: add pagination metadata when /api/images supports it.
+    # total_count: Optional[int] = Field(default=None, alias="totalCount")
+    # page: Optional[int] = None
+    # per_page: Optional[int] = Field(default=None, alias="perPage")
+
+
+class SandboxSnapshotSummary(SandboxBaseModel):
+    id: str
+    snapshot_name: str = Field(alias="snapshotName")
+    namespace: str
+    image_namespace: str = Field(alias="imageNamespace")
+    image_name: str = Field(alias="imageName")
+    image_id: str = Field(alias="imageId")
+    status: SandboxSnapshotStatus
+    compatibility_tag: Optional[str] = Field(default=None, alias="compatibilityTag")
+    metadata: Dict[str, object]
+    uploaded: bool
+    created_at: datetime = Field(alias="createdAt")
+    updated_at: datetime = Field(alias="updatedAt")
+
+
+class SandboxSnapshotListParams(SandboxBaseModel):
+    status: Optional[SandboxSnapshotStatus] = Field(default=None, exclude=None)
+    limit: Optional[int] = Field(default=None, ge=1)
+
+
+class SandboxSnapshotListResponse(SandboxBaseModel):
+    snapshots: List[SandboxSnapshotSummary]
+    # TODO: add pagination metadata when /api/snapshots supports it.
+    # total_count: Optional[int] = Field(default=None, alias="totalCount")
+    # page: Optional[int] = None
+    # per_page: Optional[int] = Field(default=None, alias="perPage")
+
+
 class SandboxMemorySnapshotParams(SandboxBaseModel):
     snapshot_name: Optional[str] = Field(
         default=None, serialization_alias="snapshotName"

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/hyperbrowser/models/session.py

@@ -1,6 +1,5 @@
 from datetime import datetime
 from typing import Any, List, Literal, Optional, Union, Dict
-from .computer_action import ComputerActionParams, ComputerActionResponse
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
@@ -70,6 +69,37 @@ class UpdateSessionProfileParams(BaseModel):
     )
 
 
+class UpdateSessionProxyLocationParams(BaseModel):
+    """
+    Managed proxy geolocation overrides for a running session.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    country: Optional[Country] = Field(default=None, serialization_alias="country")
+    state: Optional[State] = Field(default=None, serialization_alias="state")
+    city: Optional[str] = Field(default=None, serialization_alias="city")
+
+
+class UpdateSessionProxyParams(BaseModel):
+    """
+    Parameters for enabling, disabling, or reconfiguring a session proxy.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    enabled: bool = Field(serialization_alias="enabled")
+    static_ip_id: Optional[str] = Field(default=None, serialization_alias="staticIpId")
+    location: Optional[UpdateSessionProxyLocationParams] = Field(
+        default=None,
+        serialization_alias="location",
+    )
+
+
 class SessionLaunchState(BaseModel):
     model_config = ConfigDict(
         populate_by_alias=True,

{hyperbrowser-0.86.0 → hyperbrowser-0.88.0}/pyproject.toml

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