hyper-sdk 2.11.1__tar.gz → 2.12.0__tar.gz

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyper_sdk
-Version: 2.11.1
+Version: 2.12.0
 Summary: Hyper Solutions Python SDK
 License: MIT License
         
@@ -280,6 +280,31 @@ pow_payload = session.generate_kasada_pow(KasadaPowInput(
 ))
 ```
 
+## 🤖 Vercel BotID
+
+Bypass **Vercel BotID** protection by generating the required `x-is-human` header.
+
+### Generating the x-is-human Header
+
+Create the **x-is-human header** for Vercel BotID bypass:
+
+```python
+from hyper_sdk import BotIDHeaderInput
+
+header = session.generate_botid_header(BotIDHeaderInput(
+    script=script_body,          # The c.js script content
+    user_agent="your-user-agent",
+    ip="your-proxy-ip",
+    accept_language="en-US,en;q=0.9",
+))
+
+# Use the header in your requests
+headers = {
+    "x-is-human": header,
+    # ... other headers
+}
+```
+
 ### Script Path Extraction
 
 Extract **Kasada script paths** from blocked pages (HTTP 429):

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/README.md

@@ -237,6 +237,31 @@ pow_payload = session.generate_kasada_pow(KasadaPowInput(
 ))
 ```
 
+## 🤖 Vercel BotID
+
+Bypass **Vercel BotID** protection by generating the required `x-is-human` header.
+
+### Generating the x-is-human Header
+
+Create the **x-is-human header** for Vercel BotID bypass:
+
+```python
+from hyper_sdk import BotIDHeaderInput
+
+header = session.generate_botid_header(BotIDHeaderInput(
+    script=script_body,          # The c.js script content
+    user_agent="your-user-agent",
+    ip="your-proxy-ip",
+    accept_language="en-US,en;q=0.9",
+))
+
+# Use the header in your requests
+headers = {
+    "x-is-human": header,
+    # ... other headers
+}
+```
+
 ### Script Path Extraction
 
 Extract **Kasada script paths** from blocked pages (HTTP 429):

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/hyper_sdk/kasada_input.py

@@ -43,3 +43,25 @@ class KasadaPayloadInput:
             "ip": self.ip,
         }
         return result
+
+class BotIDHeaderInput:
+    def __init__(self, script: str, user_agent: str, ip: str, accept_language: str):
+        # Script is the c.js script retrieved from the BotID script endpoint
+        self.script = script
+
+        # UserAgent must be a Chrome Windows User-Agent.
+        self.user_agent = user_agent
+
+        # IP is the IPV4 address of your network or proxy
+        self.ip = ip
+
+        # Your accept-language header
+        self.accept_language = accept_language
+
+    def to_dict(self):
+        return {
+            "script": self.script,
+            "userAgent": self.user_agent,
+            "ip": self.ip,
+            "acceptLanguage": self.accept_language,
+        }

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/hyper_sdk/session.py

@@ -7,7 +7,7 @@ import gzip
 
 from .shared import generate_signature, build_headers, validate_response
 from .akamai_input import SensorInput, PixelInput, SbsdInput
-from .kasada_input import KasadaPowInput, KasadaPayloadInput
+from .kasada_input import KasadaPowInput, KasadaPayloadInput, BotIDHeaderInput
 from .datadome_input import DataDomeSliderInput, DataDomeInterstitialInput, DataDomeTagsInput
 from .incapsula_input import UtmvcInput, ReeseInput
 from .trustdecision_input import PayloadInput, DecodeInput, SignatureInput
@@ -226,6 +226,19 @@ class Session:
 
         return response_data["payload"], response_data["headers"]
 
+    def generate_botid_header(self, input_data: BotIDHeaderInput) -> str:
+        """
+        Returns the x-is-human header value for Vercel BotID using the Hyper Solutions API.
+
+        Args:
+            input_data (BotIDHeaderInput): An instance of BotIDHeaderInput containing the script,
+                user agent, IP, and accept language.
+
+        Returns:
+            str: The x-is-human header value as a string.
+        """
+        return self._send_request("https://kasada.hypersolutions.co/botid", input_data.to_dict())
+
     def generate_interstitial_payload(self, input_data: DataDomeInterstitialInput) -> Dict[str, Any]:
         """
         Returns the DataDome interstitial payload value and response headers using the Hyper Solutions API.

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/hyper_sdk/session_async.py

@@ -7,7 +7,7 @@ import gzip
 
 from .shared import generate_signature, build_headers, validate_response
 from .akamai_input import SensorInput, PixelInput, SbsdInput
-from .kasada_input import KasadaPowInput, KasadaPayloadInput
+from .kasada_input import KasadaPowInput, KasadaPayloadInput, BotIDHeaderInput
 from .datadome_input import DataDomeSliderInput, DataDomeInterstitialInput, DataDomeTagsInput
 from .incapsula_input import UtmvcInput, ReeseInput
 from .trustdecision_input import PayloadInput, DecodeInput, SignatureInput
@@ -232,6 +232,19 @@ class SessionAsync:
 
         return response_data["payload"], response_data["headers"]
 
+    async def generate_botid_header(self, input_data: BotIDHeaderInput) -> str:
+        """
+        Returns the x-is-human header value for Vercel BotID using the Hyper Solutions API.
+
+        Args:
+            input_data (BotIDHeaderInput): An instance of BotIDHeaderInput containing the script,
+                user agent, IP, and accept language.
+
+        Returns:
+            str: The x-is-human header value as a string.
+        """
+        return await self._send_request("https://kasada.hypersolutions.co/botid", input_data.to_dict())
+
     async def generate_interstitial_payload(self, input_data: DataDomeInterstitialInput) -> Dict[str, Any]:
         """
         Returns the DataDome interstitial payload value and response headers using the Hyper Solutions API.

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/hyper_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyper_sdk
-Version: 2.11.1
+Version: 2.12.0
 Summary: Hyper Solutions Python SDK
 License: MIT License
         
@@ -280,6 +280,31 @@ pow_payload = session.generate_kasada_pow(KasadaPowInput(
 ))
 ```
 
+## 🤖 Vercel BotID
+
+Bypass **Vercel BotID** protection by generating the required `x-is-human` header.
+
+### Generating the x-is-human Header
+
+Create the **x-is-human header** for Vercel BotID bypass:
+
+```python
+from hyper_sdk import BotIDHeaderInput
+
+header = session.generate_botid_header(BotIDHeaderInput(
+    script=script_body,          # The c.js script content
+    user_agent="your-user-agent",
+    ip="your-proxy-ip",
+    accept_language="en-US,en;q=0.9",
+))
+
+# Use the header in your requests
+headers = {
+    "x-is-human": header,
+    # ... other headers
+}
+```
+
 ### Script Path Extraction
 
 Extract **Kasada script paths** from blocked pages (HTTP 429):

{hyper_sdk-2.11.1 → hyper_sdk-2.12.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hyper_sdk"
-version = "2.11.1"
+version = "2.12.0"
 description = "Hyper Solutions Python SDK"
 readme = "README.md"
 requires-python = ">=3.7"