hyperbrowser 0.28.0__py3-none-any.whl → 0.30.0__py3-none-any.whl

hyperbrowser/client/managers/async_manager/session.py

@@ -2,6 +2,7 @@ from typing import List
 from ....models.session import (
     BasicResponse,
     CreateSessionParams,
+    GetSessionDownloadsUrlResponse,
     GetSessionRecordingUrlResponse,
     SessionDetail,
     SessionListParams,
@@ -47,7 +48,7 @@ class SessionManager:
 
     async def get_recording(self, id: str) -> List[SessionRecording]:
         response = await self._client.transport.get(
-            self._client._build_url(f"/session/{id}/recording")
+            self._client._build_url(f"/session/{id}/recording"), None, True
         )
         return [SessionRecording(**recording) for recording in response.data]
 
@@ -56,3 +57,9 @@ class SessionManager:
             self._client._build_url(f"/session/{id}/recording-url")
         )
         return GetSessionRecordingUrlResponse(**response.data)
+
+    async def get_downloads_url(self, id: str) -> GetSessionDownloadsUrlResponse:
+        response = await self._client.transport.get(
+            self._client._build_url(f"/session/{id}/downloads-url")
+        )
+        return GetSessionDownloadsUrlResponse(**response.data)

hyperbrowser/client/managers/sync_manager/session.py

@@ -2,6 +2,7 @@ from typing import List
 from ....models.session import (
     BasicResponse,
     CreateSessionParams,
+    GetSessionDownloadsUrlResponse,
     GetSessionRecordingUrlResponse,
     SessionDetail,
     SessionListParams,
@@ -45,7 +46,7 @@ class SessionManager:
 
     def get_recording(self, id: str) -> List[SessionRecording]:
         response = self._client.transport.get(
-            self._client._build_url(f"/session/{id}/recording")
+            self._client._build_url(f"/session/{id}/recording"), None, True
         )
         return [SessionRecording(**recording) for recording in response.data]
 
@@ -54,3 +55,9 @@ class SessionManager:
             self._client._build_url(f"/session/{id}/recording-url")
         )
         return GetSessionRecordingUrlResponse(**response.data)
+
+    def get_downloads_url(self, id: str) -> GetSessionDownloadsUrlResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/session/{id}/downloads-url")
+        )
+        return GetSessionDownloadsUrlResponse(**response.data)

hyperbrowser/models/consts.py

@@ -4,6 +4,12 @@ ScrapeFormat = Literal["markdown", "html", "links", "screenshot"]
 ScrapeWaitUntil = Literal["load", "domcontentloaded", "networkidle"]
 ScrapePageStatus = Literal["completed", "failed", "pending", "running"]
 ScrapeScreenshotFormat = Literal["jpeg", "png", "webp"]
+RecordingStatus = Literal[
+    "not_enabled", "pending", "in_progress", "completed", "failed"
+]
+DownloadsStatus = Literal[
+    "not_enabled", "pending", "in_progress", "completed", "failed"
+]
 
 POLLING_ATTEMPTS = 5
 
@@ -486,3 +492,106 @@ ISO639_1 = Literal[
     "zh",
     "zu",
 ]
+
+State = Literal[
+    "AL",
+    "AK",
+    "AZ",
+    "AR",
+    "CA",
+    "CO",
+    "CT",
+    "DE",
+    "FL",
+    "GA",
+    "HI",
+    "ID",
+    "IL",
+    "IN",
+    "IA",
+    "KS",
+    "KY",
+    "LA",
+    "ME",
+    "MD",
+    "MA",
+    "MI",
+    "MN",
+    "MS",
+    "MO",
+    "MT",
+    "NE",
+    "NV",
+    "NH",
+    "NJ",
+    "NM",
+    "NY",
+    "NC",
+    "ND",
+    "OH",
+    "OK",
+    "OR",
+    "PA",
+    "RI",
+    "SC",
+    "SD",
+    "TN",
+    "TX",
+    "UT",
+    "VT",
+    "VA",
+    "WA",
+    "WV",
+    "WI",
+    "WY",
+    "al",
+    "ak",
+    "az",
+    "ar",
+    "ca",
+    "co",
+    "ct",
+    "de",
+    "fl",
+    "ga",
+    "hi",
+    "id",
+    "il",
+    "in",
+    "ia",
+    "ks",
+    "ky",
+    "la",
+    "me",
+    "md",
+    "ma",
+    "mi",
+    "mn",
+    "ms",
+    "mo",
+    "mt",
+    "ne",
+    "nv",
+    "nh",
+    "nj",
+    "nm",
+    "ny",
+    "nc",
+    "nd",
+    "oh",
+    "ok",
+    "or",
+    "pa",
+    "ri",
+    "sc",
+    "sd",
+    "tn",
+    "tx",
+    "ut",
+    "vt",
+    "va",
+    "wa",
+    "wv",
+    "wi",
+    "wy",
+]

hyperbrowser/models/extract.py

@@ -24,6 +24,7 @@ class StartExtractJobParams(BaseModel):
     schema_: Optional[Any] = pydantic.Field(
         None, alias="schema", serialization_alias="schema"
     )
+    wait_for: Optional[int] = Field(default=None, serialization_alias="waitFor")
     session_options: Optional[CreateSessionParams] = Field(
         default=None, serialization_alias="sessionOptions"
     )

hyperbrowser/models/session.py

@@ -3,7 +3,15 @@ from typing import Any, List, Literal, Optional, Union
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
-from hyperbrowser.models.consts import ISO639_1, Country, OperatingSystem, Platform
+from hyperbrowser.models.consts import (
+    ISO639_1,
+    Country,
+    DownloadsStatus,
+    OperatingSystem,
+    Platform,
+    RecordingStatus,
+    State,
+)
 
 SessionStatus = Literal["active", "closed", "error"]
 
@@ -138,8 +146,10 @@ class CreateSessionParams(BaseModel):
         default=None, serialization_alias="proxyServerUsername"
     )
     proxy_country: Optional[Country] = Field(
-        default="US", serialization_alias="proxyCountry"
+        default=None, serialization_alias="proxyCountry"
     )
+    proxy_state: Optional[State] = Field(default=None, serialization_alias="proxyState")
+    proxy_city: Optional[str] = Field(default=None, serialization_alias="proxyCity")
     operating_systems: Optional[List[OperatingSystem]] = Field(
         default=None, serialization_alias="operatingSystems"
     )
@@ -168,6 +178,9 @@ class CreateSessionParams(BaseModel):
     browser_args: Optional[List[str]] = Field(
         default=None, serialization_alias="browserArgs"
     )
+    save_downloads: Optional[bool] = Field(
+        default=None, serialization_alias="saveDownloads"
+    )
 
 
 class SessionRecording(BaseModel):
@@ -194,4 +207,20 @@ class GetSessionRecordingUrlResponse(BaseModel):
         populate_by_alias=True,
     )
 
-    recording_url: str = Field(alias="recordingUrl")
+    status: RecordingStatus = Field(alias="status")
+    recording_url: Optional[str] = Field(default=None, alias="recordingUrl")
+    error: Optional[str] = Field(default=None, alias="error")
+
+
+class GetSessionDownloadsUrlResponse(BaseModel):
+    """
+    Response containing the signed URL for the session downloads.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    status: DownloadsStatus = Field(alias="status")
+    downloads_url: Optional[str] = Field(default=None, alias="downloadsUrl")
+    error: Optional[str] = Field(default=None, alias="error")

hyperbrowser/transport/async_transport.py

@@ -80,11 +80,15 @@ class AsyncTransport(TransportStrategy):
         except Exception as e:
             raise HyperbrowserError("Post request failed", original_error=e)
 
-    async def get(self, url: str, params: Optional[dict] = None) -> APIResponse:
+    async def get(
+        self, url: str, params: Optional[dict] = None, follow_redirects: bool = False
+    ) -> APIResponse:
         if params:
             params = {k: v for k, v in params.items() if v is not None}
         try:
-            response = await self.client.get(url, params=params)
+            response = await self.client.get(
+                url, params=params, follow_redirects=follow_redirects
+            )
             return await self._handle_response(response)
         except HyperbrowserError:
             raise

hyperbrowser/transport/sync.py

@@ -59,11 +59,15 @@ class SyncTransport(TransportStrategy):
         except Exception as e:
             raise HyperbrowserError("Post request failed", original_error=e)
 
-    def get(self, url: str, params: Optional[dict] = None) -> APIResponse:
+    def get(
+        self, url: str, params: Optional[dict] = None, follow_redirects: bool = False
+    ) -> APIResponse:
         if params:
             params = {k: v for k, v in params.items() if v is not None}
         try:
-            response = self.client.get(url, params=params)
+            response = self.client.get(
+                url, params=params, follow_redirects=follow_redirects
+            )
             return self._handle_response(response)
         except HyperbrowserError:
             raise

{hyperbrowser-0.28.0.dist-info → hyperbrowser-0.30.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: hyperbrowser
-Version: 0.28.0
+Version: 0.30.0
 Summary: Python SDK for hyperbrowser
 License: MIT
 Author: Nikhil Shahi

{hyperbrowser-0.28.0.dist-info → hyperbrowser-0.30.0.dist-info}/RECORD

@@ -6,31 +6,31 @@ hyperbrowser/client/managers/async_manager/extension.py,sha256=a-xYtXXdCspukYtsg
 hyperbrowser/client/managers/async_manager/extract.py,sha256=9p8dGLYmoow7smnQ0BTRN6diDmIayjW-EPRGzzvheZk,2102
 hyperbrowser/client/managers/async_manager/profile.py,sha256=f2uX2GGYdgL0fyzB0jnI-L-nWleqG6cwZ0pc1K1zdQY,1244
 hyperbrowser/client/managers/async_manager/scrape.py,sha256=Lr6oicTX3U1xooczUVQlsq2mzIhAKEW-A9909ZdSzKc,5720
-hyperbrowser/client/managers/async_manager/session.py,sha256=KN28FEwGdJ1GC0aq_4JFDsVQrWs7CigBAwgQE5BtaEE,2005
+hyperbrowser/client/managers/async_manager/session.py,sha256=jO9Z2MSooG9eTmdsOWiNU0mFYdrxh5HirNnFqgwDIn0,2330
 hyperbrowser/client/managers/sync_manager/crawl.py,sha256=uAVmjhUbamVnzAAyfswq1bdBR5c7JrfGVvPdVmmw4R8,3799
 hyperbrowser/client/managers/sync_manager/extension.py,sha256=1YoyTZtMo43trl9jAsXv95aor0nBHiJEmLva39jFW-k,1415
 hyperbrowser/client/managers/sync_manager/extract.py,sha256=XocMKC0qAarRpE12KU4m_mi1KhUOHp3-TK4dLeiIn6E,2034
 hyperbrowser/client/managers/sync_manager/profile.py,sha256=va6mlhQ5SKZa-viEGFNzV6UBZEP5SqwVp32_oxC_NzM,1196
 hyperbrowser/client/managers/sync_manager/scrape.py,sha256=y4YB-NusXRi3brE7jBGRBHGANY-_-aHMBirKuuU6mdg,5579
-hyperbrowser/client/managers/sync_manager/session.py,sha256=x2yHIkamcIHbmzMLQtJHzY93UgAlhZ02gHMMmJqiHpc,1911
+hyperbrowser/client/managers/sync_manager/session.py,sha256=aE4T9LWbOKcKCnh04n3rwnjeyus73Z47otrdCGTTKSM,2224
 hyperbrowser/client/sync.py,sha256=HgglJY9pNdW987OzNO_5dSZgj1AfAqovCmY99WYQD2E,1213
 hyperbrowser/config.py,sha256=2J6GYNR_83vzJZ6jEV-LXO1U-q6DHIrfyAU0WrUPhw8,625
 hyperbrowser/exceptions.py,sha256=SUUkptK2OL36xDORYmSicaTYR7pMbxeWAjAgz35xnM8,1171
-hyperbrowser/models/consts.py,sha256=SgXPzWHNiQj02d6AehQbzty4qaE2tZ8KxQrdsGBsN1c,5203
+hyperbrowser/models/consts.py,sha256=yEPR3_Kmx44KDA3HC7p_96fTVIfNs2VwVfltIwe5Kgg,6415
 hyperbrowser/models/crawl.py,sha256=22hP_DPZMfa2MAfOeJ90qj5CH4rr7VtQT1gCQqO8jO8,2610
 hyperbrowser/models/extension.py,sha256=nXjKXKt9R7RxyZ4hd3EvfqZsEGy_ufh1r5j2mqCLykQ,804
-hyperbrowser/models/extract.py,sha256=24rNo0BzczRPTb3JOcz_WHo5Lz3rBc1Z3-l4EhhroI0,1447
+hyperbrowser/models/extract.py,sha256=Thq1wQhXlS-dh4442JLDONGOYix06s3gjWSnP1OuyN4,1528
 hyperbrowser/models/profile.py,sha256=KRb_LNxxW00AsD_thzzthFS51vInJawt1RcoNz4Q9i8,1322
 hyperbrowser/models/scrape.py,sha256=ZdVNN4rh7EKLh-O1Ou5aU_OgTNxC9pFQlkG-Q2fR-Z4,4611
-hyperbrowser/models/session.py,sha256=UJ16Pvgih38QM2DQlSeLdYBigjAqlAcCAVl8bZnRb7c,5841
+hyperbrowser/models/session.py,sha256=i1NkrQWNlKziDd98ySdrUUH7XSv6qOa2cmiK5vV7VeI,6730
 hyperbrowser/tools/__init__.py,sha256=OUaTUM-kiigYmzfbpx3XQhzMK1xT1wd8cqXgR4znsAY,2021
 hyperbrowser/tools/anthropic.py,sha256=5pEkJm1H-26GToTwXsDjo4GGqVy1hATws4Pg59mumow,1667
 hyperbrowser/tools/openai.py,sha256=4-71IIWSxc_ByhywcfWj9-QI9iYNEe0xO6B2spE8WG0,2200
 hyperbrowser/tools/schema.py,sha256=cR2MUX8TvUyN8TnCyeX0pccp4AmPjrdaKzuAXRThOJo,3075
-hyperbrowser/transport/async_transport.py,sha256=MIPJvilvZWBPXLZ96c9OohuN6TN9DaaU0EnyleG3q6g,4017
+hyperbrowser/transport/async_transport.py,sha256=6HKoeM5TutIqraEscEWobvSPWF3iVKh2hPflGNKwykw,4128
 hyperbrowser/transport/base.py,sha256=ildpMrDiM8nvrSGrH2LTOafmB17T7PQB_NQ1ODA378U,1703
-hyperbrowser/transport/sync.py,sha256=ER844H_OCPCrnmbc58cuqphWTVvCZJQn7-D7ZenCr3Y,3311
-hyperbrowser-0.28.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
-hyperbrowser-0.28.0.dist-info/METADATA,sha256=zMfF5QFi32wKO6JDUK-Z6ce-RgYC34ePKQ_CF4dTlgs,3438
-hyperbrowser-0.28.0.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-hyperbrowser-0.28.0.dist-info/RECORD,,
+hyperbrowser/transport/sync.py,sha256=aUVpxWF8sqSycLNKxVNEZvlsZSoqc1eHgPK1Y1QA1u8,3422
+hyperbrowser-0.30.0.dist-info/LICENSE,sha256=6rUGKlyKb_1ZAH7h7YITYAAUNFN3MNGGKCyfrw49NLE,1071
+hyperbrowser-0.30.0.dist-info/METADATA,sha256=EdPIlQtwBgME4yioEdu6GUiJcEHt87woh5MVLQRHE3s,3438
+hyperbrowser-0.30.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+hyperbrowser-0.30.0.dist-info/RECORD,,

{hyperbrowser-0.28.0.dist-info → hyperbrowser-0.30.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.0.1
+Generator: poetry-core 2.1.1
 Root-Is-Purelib: true
 Tag: py3-none-any