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

hyperbrowser/client/async_client.py

@@ -4,6 +4,7 @@ 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
@@ -25,6 +26,7 @@ class AsyncHyperbrowser(HyperbrowserBase):
         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/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/sync.py

@@ -3,6 +3,7 @@ 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
@@ -24,6 +25,7 @@ class Hyperbrowser(HyperbrowserBase):
         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/session.py

@@ -145,9 +145,12 @@ 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"
+    )
 
 
 class SessionRecording(BaseModel):

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: hyperbrowser
-Version: 0.11.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.11.0.dist-info → hyperbrowser-0.12.0.dist-info}/RECORD

@@ -1,27 +1,30 @@
 LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
 hyperbrowser/__init__.py,sha256=zWGcLhqhvWy6BTwuNpzWK1-0LpIn311ks-4U9nrsb7Y,187
-hyperbrowser/client/async_client.py,sha256=BOM_FPK_I7SGwQ6vz5-vB-PXvKOf9kJECkMDE_gwQtI,1174
+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=U_4DTan8wuFhEerKAg4M_V4P6X-zUGtlUjmEotwAqbE,999
+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=xsMBPivE4M6wGJ5Q0x3oRTgt0Koi1occtAeHthes9ZY,4970
+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=fSxXSKrvjrAJhqFr4dmgwLKplBV07ui22NHMtaFvoWg,4903
-hyperbrowser/transport/async_transport.py,sha256=MrX0--xjPcri1zuXziQxSKJe0OyC-9b3UBpwLABIqDc,3850
+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=qU_ScFRjmxBvkKIzv5k77Vt9BmKZaCDF3rIve1is9mY,3150
-hyperbrowser-0.11.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
-hyperbrowser-0.11.0.dist-info/METADATA,sha256=ADGY2GMRxLIOjLzavVlKAIPsROLR1PevAVT0aFmcP9g,3290
-hyperbrowser-0.11.0.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-hyperbrowser-0.11.0.dist-info/RECORD,,
+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,,