hyperbrowser 0.10.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

hyperbrowser/client/async_client.py

@@ -1,7 +1,10 @@
 from typing import Optional
+
+from .managers.async_manager.profile import ProfileManager
 from .managers.async_manager.session import SessionManager
 from .managers.async_manager.scrape import ScrapeManager
 from .managers.async_manager.crawl import CrawlManager
+from .managers.async_manager.extension import ExtensionManager
 from .base import HyperbrowserBase
 from ..transport.async_transport import AsyncTransport
 from ..config import ClientConfig
@@ -15,11 +18,15 @@ class AsyncHyperbrowser(HyperbrowserBase):
         config: Optional[ClientConfig] = None,
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
+        timeout: Optional[int] = 30,
     ):
         super().__init__(AsyncTransport, config, api_key, base_url)
+        self.transport.client.timeout = timeout
         self.sessions = SessionManager(self)
         self.scrape = ScrapeManager(self)
         self.crawl = CrawlManager(self)
+        self.profiles = ProfileManager(self)
+        self.extensions = ExtensionManager(self)
 
     async def close(self) -> None:
         await self.transport.close()

hyperbrowser/client/managers/async_manager/extension.py

@@ -0,0 +1,40 @@
+import os
+from typing import List
+
+from hyperbrowser.exceptions import HyperbrowserError
+from hyperbrowser.models.extension import CreateExtensionParams, ExtensionResponse
+
+
+class ExtensionManager:
+    def __init__(self, client):
+        self._client = client
+
+    async def create(self, params: CreateExtensionParams) -> ExtensionResponse:
+        file_path = params.file_path
+        params.file_path = None
+
+        # Check if file exists before trying to open it
+        if not os.path.exists(file_path):
+            raise FileNotFoundError(f"Extension file not found at path: {file_path}")
+
+        response = await self._client.transport.post(
+            self._client._build_url("/extensions/add"),
+            data=(
+                {}
+                if params is None
+                else params.model_dump(exclude_none=True, by_alias=True)
+            ),
+            files={"file": open(file_path, "rb")},
+        )
+        return ExtensionResponse(**response.data)
+
+    async def list(self) -> List[ExtensionResponse]:
+        response = await self._client.transport.get(
+            self._client._build_url("/extensions/list"),
+        )
+        if not isinstance(response.data, list):
+            raise HyperbrowserError(
+                f"Expected list response but got {type(response.data)}",
+                original_error=None,
+            )
+        return [ExtensionResponse(**extension) for extension in response.data]

hyperbrowser/client/managers/async_manager/profile.py

@@ -0,0 +1,25 @@
+from hyperbrowser.models.profile import ProfileResponse, CreateProfileResponse
+from hyperbrowser.models.session import BasicResponse
+
+
+class ProfileManager:
+    def __init__(self, client):
+        self._client = client
+
+    async def create(self) -> CreateProfileResponse:
+        response = await self._client.transport.post(
+            self._client._build_url("/profile"),
+        )
+        return CreateProfileResponse(**response.data)
+
+    async def get(self, id: str) -> ProfileResponse:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/profile/{id}"),
+        )
+        return ProfileResponse(**response.data)
+
+    async def delete(self, id: str) -> BasicResponse:
+        response = await self._client.transport.delete(
+            self._client._build_url(f"/profile/{id}"),
+        )
+        return BasicResponse(**response.data)

hyperbrowser/client/managers/async_manager/session.py

@@ -16,7 +16,11 @@ class SessionManager:
     async def create(self, params: CreateSessionParams = None) -> SessionDetail:
         response = await self._client.transport.post(
             self._client._build_url("/session"),
-            data={} if params is None else params.model_dump(exclude_none=True, by_alias=True),
+            data=(
+                {}
+                if params is None
+                else params.model_dump(exclude_none=True, by_alias=True)
+            ),
         )
         return SessionDetail(**response.data)
 

hyperbrowser/client/managers/sync_manager/extension.py

@@ -0,0 +1,40 @@
+import os
+from typing import List
+
+from hyperbrowser.exceptions import HyperbrowserError
+from hyperbrowser.models.extension import CreateExtensionParams, ExtensionResponse
+
+
+class ExtensionManager:
+    def __init__(self, client):
+        self._client = client
+
+    def create(self, params: CreateExtensionParams) -> ExtensionResponse:
+        file_path = params.file_path
+        params.file_path = None
+
+        # Check if file exists before trying to open it
+        if not os.path.exists(file_path):
+            raise FileNotFoundError(f"Extension file not found at path: {file_path}")
+
+        response = self._client.transport.post(
+            self._client._build_url("/extensions/add"),
+            data=(
+                {}
+                if params is None
+                else params.model_dump(exclude_none=True, by_alias=True)
+            ),
+            files={"file": open(file_path, "rb")},
+        )
+        return ExtensionResponse(**response.data)
+
+    def list(self) -> List[ExtensionResponse]:
+        response = self._client.transport.get(
+            self._client._build_url("/extensions/list"),
+        )
+        if not isinstance(response.data, list):
+            raise HyperbrowserError(
+                f"Expected list response but got {type(response.data)}",
+                original_error=None,
+            )
+        return [ExtensionResponse(**extension) for extension in response.data]

hyperbrowser/client/managers/sync_manager/profile.py

@@ -0,0 +1,25 @@
+from hyperbrowser.models.profile import ProfileResponse, CreateProfileResponse
+from hyperbrowser.models.session import BasicResponse
+
+
+class ProfileManager:
+    def __init__(self, client):
+        self._client = client
+
+    def create(self) -> CreateProfileResponse:
+        response = self._client.transport.post(
+            self._client._build_url("/profile"),
+        )
+        return CreateProfileResponse(**response.data)
+
+    def get(self, id: str) -> ProfileResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/profile/{id}"),
+        )
+        return ProfileResponse(**response.data)
+
+    def delete(self, id: str) -> BasicResponse:
+        response = self._client.transport.delete(
+            self._client._build_url(f"/profile/{id}"),
+        )
+        return BasicResponse(**response.data)

hyperbrowser/client/managers/sync_manager/session.py

@@ -16,7 +16,11 @@ class SessionManager:
     def create(self, params: CreateSessionParams = None) -> SessionDetail:
         response = self._client.transport.post(
             self._client._build_url("/session"),
-            data={} if params is None else params.model_dump(exclude_none=True, by_alias=True),
+            data=(
+                {}
+                if params is None
+                else params.model_dump(exclude_none=True, by_alias=True)
+            ),
         )
         return SessionDetail(**response.data)
 

hyperbrowser/client/sync.py

@@ -1,7 +1,9 @@
 from typing import Optional
+from .managers.sync_manager.profile import ProfileManager
 from .managers.sync_manager.session import SessionManager
 from .managers.sync_manager.scrape import ScrapeManager
 from .managers.sync_manager.crawl import CrawlManager
+from .managers.sync_manager.extension import ExtensionManager
 from .base import HyperbrowserBase
 from ..transport.sync import SyncTransport
 from ..config import ClientConfig
@@ -15,11 +17,15 @@ class Hyperbrowser(HyperbrowserBase):
         config: Optional[ClientConfig] = None,
         api_key: Optional[str] = None,
         base_url: Optional[str] = None,
+        timeout: Optional[int] = 30,
     ):
         super().__init__(SyncTransport, config, api_key, base_url)
+        self.transport.client.timeout = timeout
         self.sessions = SessionManager(self)
         self.scrape = ScrapeManager(self)
         self.crawl = CrawlManager(self)
+        self.profiles = ProfileManager(self)
+        self.extensions = ExtensionManager(self)
 
     def close(self) -> None:
         self.transport.close()

hyperbrowser/models/consts.py

@@ -1,6 +1,6 @@
 from typing import Literal
 
-ScrapeFormat = Literal["markdown", "html", "links"]
+ScrapeFormat = Literal["markdown", "html", "links", "screenshot"]
 
 Country = Literal[
     "AD",

hyperbrowser/models/extension.py

@@ -0,0 +1,27 @@
+from datetime import datetime
+from typing import List, Literal, Optional
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CreateExtensionParams(BaseModel):
+    """
+    Parameters for creating a new extension.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    name: Optional[str] = Field(default=None, serialization_alias="name")
+    file_path: str = Field(serialization_alias="filePath")
+
+
+class ExtensionResponse(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    id: str = Field(serialization_alias="id")
+    name: str = Field(serialization_alias="name")
+    created_at: datetime = Field(serialization_alias="createdAt", alias="createdAt")
+    updated_at: datetime = Field(serialization_alias="updatedAt", alias="updatedAt")

hyperbrowser/models/profile.py

@@ -0,0 +1,17 @@
+from pydantic import BaseModel, ConfigDict, Field
+from datetime import datetime
+
+
+class CreateProfileResponse(BaseModel):
+    id: str
+
+
+class ProfileResponse(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    id: str
+    team_id: str = Field(alias="teamId")
+    created_at: datetime = Field(alias="createdAt")
+    updated_at: datetime = Field(alias="updatedAt")

hyperbrowser/models/session.py

@@ -101,6 +101,17 @@ class ScreenConfig(BaseModel):
     height: int = Field(default=720, serialization_alias="height")
 
 
+class CreateSessionProfile(BaseModel):
+    """
+    Profile configuration parameters for browser session.
+    """
+
+    id: Optional[str] = Field(default=None, serialization_alias="id")
+    persist_changes: Optional[bool] = Field(
+        default=None, serialization_alias="persistChanges"
+    )
+
+
 class CreateSessionParams(BaseModel):
     """
     Parameters for creating a new browser session.
@@ -134,7 +145,11 @@ class CreateSessionParams(BaseModel):
     trackers: bool = Field(default=False, serialization_alias="trackers")
     annoyances: bool = Field(default=False, serialization_alias="annoyances")
     enable_web_recording: Optional[bool] = Field(
-        default=False, serialization_alias="enableWebRecording"
+        default=True, serialization_alias="enableWebRecording"
+    )
+    profile: Optional[CreateSessionProfile] = Field(default=None)
+    extension_ids: Optional[List[str]] = Field(
+        default=None, serialization_alias="extensionIds"
     )
 
 

hyperbrowser/transport/async_transport.py

@@ -66,9 +66,14 @@ class AsyncTransport(TransportStrategy):
         except httpx.RequestError as e:
             raise HyperbrowserError("Request failed", original_error=e)
 
-    async def post(self, url: str, data: Optional[dict] = None) -> APIResponse:
+    async def post(
+        self, url: str, data: Optional[dict] = None, files: Optional[dict] = None
+    ) -> APIResponse:
         try:
-            response = await self.client.post(url, json=data)
+            if files:
+                response = await self.client.post(url, data=data, files=files)
+            else:
+                response = await self.client.post(url, json=data)
             return await self._handle_response(response)
         except HyperbrowserError:
             raise
@@ -94,3 +99,12 @@ class AsyncTransport(TransportStrategy):
             raise
         except Exception as e:
             raise HyperbrowserError("Put request failed", original_error=e)
+
+    async def delete(self, url: str) -> APIResponse:
+        try:
+            response = await self.client.delete(url)
+            return await self._handle_response(response)
+        except HyperbrowserError:
+            raise
+        except Exception as e:
+            raise HyperbrowserError("Delete request failed", original_error=e)

hyperbrowser/transport/base.py

@@ -55,3 +55,7 @@ class TransportStrategy(ABC):
     @abstractmethod
     def put(self, url: str) -> APIResponse:
         pass
+
+    @abstractmethod
+    def delete(self, url: str) -> APIResponse:
+        pass

hyperbrowser/transport/sync.py

@@ -45,9 +45,14 @@ class SyncTransport(TransportStrategy):
     def close(self) -> None:
         self.client.close()
 
-    def post(self, url: str, data: Optional[dict] = None) -> APIResponse:
+    def post(
+        self, url: str, data: Optional[dict] = None, files: Optional[dict] = None
+    ) -> APIResponse:
         try:
-            response = self.client.post(url, json=data)
+            if files:
+                response = self.client.post(url, data=data, files=files)
+            else:
+                response = self.client.post(url, json=data)
             return self._handle_response(response)
         except HyperbrowserError:
             raise
@@ -73,3 +78,12 @@ class SyncTransport(TransportStrategy):
             raise
         except Exception as e:
             raise HyperbrowserError("Put request failed", original_error=e)
+
+    def delete(self, url: str) -> APIResponse:
+        try:
+            response = self.client.delete(url)
+            return self._handle_response(response)
+        except HyperbrowserError:
+            raise
+        except Exception as e:
+            raise HyperbrowserError("Delete request failed", original_error=e)

{hyperbrowser-0.10.0.dist-info → hyperbrowser-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hyperbrowser
-Version: 0.10.0
+Version: 0.12.0
 Summary: Python SDK for hyperbrowser
 Home-page: https://github.com/hyperbrowserai/python-sdk
 License: MIT
@@ -19,6 +19,10 @@ Requires-Dist: pydantic (>=2.10.0,<3.0.0)
 Project-URL: Repository, https://github.com/hyperbrowserai/python-sdk
 Description-Content-Type: text/markdown
 
+# Hyperbrowser Python SDK
+
+Checkout the full documentation [here](https://docs.hyperbrowser.ai/)
+
 ## Installation
 
 Currently Hyperbrowser supports creating a browser session in two ways:

hyperbrowser-0.12.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
+hyperbrowser/__init__.py,sha256=zWGcLhqhvWy6BTwuNpzWK1-0LpIn311ks-4U9nrsb7Y,187
+hyperbrowser/client/async_client.py,sha256=ov01IDpAUrZNKwjBGt8JB6eYzzM3AigkD1V4FmuKSr8,1286
+hyperbrowser/client/base.py,sha256=9gFma7RdvJBUlDCqr8tZd315UPrjn4ldU4B0-Y-L4O4,1268
+hyperbrowser/client/managers/async_manager/crawl.py,sha256=hBS2WwfE0-ZopCW9PjP30meU5iTDdRViFl1C1OF1hVU,2291
+hyperbrowser/client/managers/async_manager/extension.py,sha256=a-xYtXXdCspukYtsguRgjEoQ8E_kzzA2tQAJtIyCtAs,1439
+hyperbrowser/client/managers/async_manager/profile.py,sha256=l9S-5iw-zLP89xg9f5ZCT7OjimuCotFFQtyxfDZ8Ahg,882
+hyperbrowser/client/managers/async_manager/scrape.py,sha256=7FdYS_NNEpvB9z3ShGZaZxNryKHm02MQR-g9diadGhA,1319
+hyperbrowser/client/managers/async_manager/session.py,sha256=ObJhz1IkCCIQLwmztQ-M7lCKzKsVDr-eWCFnan2d9rQ,1692
+hyperbrowser/client/managers/sync_manager/crawl.py,sha256=lnMtBmOPcamjtvzH4BAnWbBTGbKBmHGUQiMnnZlj2tg,2222
+hyperbrowser/client/managers/sync_manager/extension.py,sha256=1YoyTZtMo43trl9jAsXv95aor0nBHiJEmLva39jFW-k,1415
+hyperbrowser/client/managers/sync_manager/profile.py,sha256=EvEtJ9INV8yhYKJoSJV1x2eBtsrS2QPeSifFEi7gxb4,846
+hyperbrowser/client/managers/sync_manager/scrape.py,sha256=DxSvdHa-z2P_rvNUwmRfU4iQz19wiEi_M2YmBQZfLyk,1265
+hyperbrowser/client/managers/sync_manager/session.py,sha256=74cekrDaGKW5WlP_0Qrqlk-xW2p1u4s63E-D08a4A2s,1610
+hyperbrowser/client/sync.py,sha256=CbC1no2BP-jSLDfD2c0VkRhvA9RWQ7xjdYDkJrrRpXM,1110
+hyperbrowser/config.py,sha256=2J6GYNR_83vzJZ6jEV-LXO1U-q6DHIrfyAU0WrUPhw8,625
+hyperbrowser/exceptions.py,sha256=SUUkptK2OL36xDORYmSicaTYR7pMbxeWAjAgz35xnM8,1171
+hyperbrowser/models/consts.py,sha256=9hv1NQKrXoqPn-6QHbCTJOc2-Dnj--7XEOZZ0IGtvvk,4984
+hyperbrowser/models/crawl.py,sha256=DWeJRwuZ0EXOEpEx0OyUZp_HOdGfpptg_mNo5J0u6po,2566
+hyperbrowser/models/extension.py,sha256=nXjKXKt9R7RxyZ4hd3EvfqZsEGy_ufh1r5j2mqCLykQ,804
+hyperbrowser/models/profile.py,sha256=SYu4SR6OSwvg0C3bMW3j9z3zhPi-IzXuJE5aVJ3t-Nc,397
+hyperbrowser/models/scrape.py,sha256=e3Z5HgCkLD1FxOjXtPmI6SAJ9wsrAKXj7WElXFXy8yE,2103
+hyperbrowser/models/session.py,sha256=LNxBGg1v5O9N0t6sPEhzBeVzHGvIZ3E2S6OlyLg2tSQ,5013
+hyperbrowser/transport/async_transport.py,sha256=MIPJvilvZWBPXLZ96c9OohuN6TN9DaaU0EnyleG3q6g,4017
+hyperbrowser/transport/base.py,sha256=ildpMrDiM8nvrSGrH2LTOafmB17T7PQB_NQ1ODA378U,1703
+hyperbrowser/transport/sync.py,sha256=ER844H_OCPCrnmbc58cuqphWTVvCZJQn7-D7ZenCr3Y,3311
+hyperbrowser-0.12.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
+hyperbrowser-0.12.0.dist-info/METADATA,sha256=DqQgGhybzTUs2MykDmqYtbo1UWGcXsJmWIRbgr8Gc7k,3388
+hyperbrowser-0.12.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+hyperbrowser-0.12.0.dist-info/RECORD,,

hyperbrowser-0.10.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
-hyperbrowser/__init__.py,sha256=zWGcLhqhvWy6BTwuNpzWK1-0LpIn311ks-4U9nrsb7Y,187
-hyperbrowser/client/async_client.py,sha256=ppJI8O7SQi89mwMhIHVgTgFeRu2aZbLl2zbFaI3sXNU,984
-hyperbrowser/client/base.py,sha256=9gFma7RdvJBUlDCqr8tZd315UPrjn4ldU4B0-Y-L4O4,1268
-hyperbrowser/client/managers/async_manager/crawl.py,sha256=hBS2WwfE0-ZopCW9PjP30meU5iTDdRViFl1C1OF1hVU,2291
-hyperbrowser/client/managers/async_manager/scrape.py,sha256=7FdYS_NNEpvB9z3ShGZaZxNryKHm02MQR-g9diadGhA,1319
-hyperbrowser/client/managers/async_manager/session.py,sha256=cJCYzJYHUXx19U5vQNi6_80BPxd1QTDq6XvXHM-PNVg,1628
-hyperbrowser/client/managers/sync_manager/crawl.py,sha256=lnMtBmOPcamjtvzH4BAnWbBTGbKBmHGUQiMnnZlj2tg,2222
-hyperbrowser/client/managers/sync_manager/scrape.py,sha256=DxSvdHa-z2P_rvNUwmRfU4iQz19wiEi_M2YmBQZfLyk,1265
-hyperbrowser/client/managers/sync_manager/session.py,sha256=n81y5af8bmFlyk9QoPCmKrhRwvYlsVv136jDHfpbOBI,1546
-hyperbrowser/client/sync.py,sha256=CzXlPksK4D7eazQDzbra-pM64Sy0bLrg0zjv5xBKZdk,811
-hyperbrowser/config.py,sha256=2J6GYNR_83vzJZ6jEV-LXO1U-q6DHIrfyAU0WrUPhw8,625
-hyperbrowser/exceptions.py,sha256=SUUkptK2OL36xDORYmSicaTYR7pMbxeWAjAgz35xnM8,1171
-hyperbrowser/models/consts.py,sha256=xsMBPivE4M6wGJ5Q0x3oRTgt0Koi1occtAeHthes9ZY,4970
-hyperbrowser/models/crawl.py,sha256=DWeJRwuZ0EXOEpEx0OyUZp_HOdGfpptg_mNo5J0u6po,2566
-hyperbrowser/models/scrape.py,sha256=e3Z5HgCkLD1FxOjXtPmI6SAJ9wsrAKXj7WElXFXy8yE,2103
-hyperbrowser/models/session.py,sha256=QVcPc4rkXqTfSE9roEImRgsJ4xxHruTaKubQSHy__xI,4541
-hyperbrowser/transport/async_transport.py,sha256=P-nX9iczGVYJyvqtqlGAOFQ3PghRC2_bE6Lruiiecn0,3511
-hyperbrowser/transport/base.py,sha256=9l7k-qTX4Q2KaZIR_fwsNlxDgOzsmc8zgucZ9tfHgkw,1622
-hyperbrowser/transport/sync.py,sha256=DFDPYqF-_WQSZkRbWDRFTPowQMzz-B3N869r2vvocPc,2829
-hyperbrowser-0.10.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
-hyperbrowser-0.10.0.dist-info/METADATA,sha256=x-k7Iin7O1lTl6mLSRjwPRJ8JRRNQItbc-N3Tq4vqFY,3290
-hyperbrowser-0.10.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-hyperbrowser-0.10.0.dist-info/RECORD,,