hyper-sdk 2.7.0__tar.gz → 2.12.1__tar.gz

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyper_sdk
-Version: 2.7.0
+Version: 2.12.1
 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.7.0 → hyper_sdk-2.12.1}/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.7.0 → hyper_sdk-2.12.1}/hyper_sdk/akamai_input.py

@@ -1,38 +1,35 @@
 class SensorInput:
-    def __init__(self, abck: str, bmsz: str, version: str, page_url: str, user_agent: str, ip: str, acceptLanguage: str, context: str, script_hash="", dynamic_values=""):
+    def __init__(self, abck: str, bmsz: str, version: str, page_url: str, user_agent: str, ip: str, accept_language: str,
+                 context: str, script: str, script_url: str):
         self.abck = abck
         self.bmsz = bmsz
         self.version = version
         self.page_url = page_url
         self.user_agent = user_agent
-        self.script_hash = script_hash
-        self.dynamic_values = dynamic_values
+        self.script = script
+        self.script_url = script_url
         self.context = context
         self.ip = ip
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
 
 
 class PixelInput:
-    def __init__(self, user_agent: str, html_var: str, script_var: str, acceptLanguage: str, ip: str):
+    def __init__(self, user_agent: str, html_var: str, script_var: str, accept_language: str, ip: str):
         self.user_agent = user_agent
         self.html_var = html_var
         self.script_var = script_var
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip
 
 
-class DynamicInput:
-    def __init__(self, script: str):
-        self.script = script
-
-
 class SbsdInput:
-    def __init__(self, index: int, user_agent: str, uuid: str, page_url: str, o_cookie: str, script: str, acceptLanguage: str, ip: str):
+    def __init__(self, index: int, user_agent: str, uuid: str, page_url: str, o_cookie: str, script: str,
+                 accept_language: str, ip: str):
         self.index = index
         self.user_agent = user_agent
         self.uuid = uuid
         self.page_url = page_url
         self.o_cookie = o_cookie
         self.script = script
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/hyper_sdk/datadome/parse.py

@@ -76,6 +76,7 @@ def parse_interstitial_device_check_link(src: str, datadome_cookie: str, referer
         "cid": datadome_cookie,
         "referer": referer,
         "s": str(dd_object_parsed.get("s")),
+        "e": str(dd_object_parsed.get("e")),
         "b": str(dd_object_parsed.get("b")),
         "dm": "cd",
     }

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/hyper_sdk/datadome_input.py

@@ -1,6 +1,6 @@
 
 class DataDomeSliderInput:
-    def __init__(self, user_agent: str, device_link: str, html: str, puzzle: str, piece: str, parent_url: str, acceptLanguage: str, ip: str):
+    def __init__(self, user_agent: str, device_link: str, html: str, puzzle: str, piece: str, parent_url: str, accept_language: str, ip: str):
         # UserAgent must be a Chrome Windows User-Agent.
         self.user_agent = user_agent
 
@@ -22,7 +22,7 @@ class DataDomeSliderInput:
         self.piece = piece
 
         self.parent_url = parent_url
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip
 
     def to_dict(self):
@@ -33,13 +33,13 @@ class DataDomeSliderInput:
             "puzzle": self.puzzle,
             "piece": self.piece,
             "parentUrl": self.parent_url,
-            "acceptLanguage": self.acceptLanguage,
+            "acceptLanguage": self.accept_language,
             "ip": self.ip,
         }
 
 
 class DataDomeInterstitialInput:
-    def __init__(self, user_agent: str, device_link: str, html: str, acceptLanguage: str, ip: str):
+    def __init__(self, user_agent: str, device_link: str, html: str, accept_language: str, ip: str):
         # UserAgent must be a Chrome Windows User-Agent.
         self.user_agent = user_agent
 
@@ -50,7 +50,7 @@ class DataDomeInterstitialInput:
         # Html is the response body of the GET request to the DeviceLink
         self.html = html
 
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip
 
     def to_dict(self):
@@ -58,31 +58,32 @@ class DataDomeInterstitialInput:
             "userAgent": self.user_agent,
             "deviceLink": self.device_link,
             "html": self.html,
-            "acceptLanguage": self.acceptLanguage,
+            "acceptLanguage": self.accept_language,
             "ip": self.ip,
         }
 
 
 class DataDomeTagsInput:
-    def __init__(self, user_agent: str, cid: str, ddk: str, referer: str, tags_type: str, version: str, acceptLanguage: str, ip: str):
-        # UserAgent must be a Chrome Windows User-Agent.
+    def __init__(self, user_agent: str, ddk: str, referer: str, tags_type: str, version: str, accept_language: str, ip: str, cid: str = ""):
         self.user_agent = user_agent
         self.cid = cid
         self.ddk = ddk
         self.referer = referer
         self.tags_type = tags_type
         self.version = version
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip
 
     def to_dict(self):
-        return {
+        data = {
             "userAgent": self.user_agent,
-            "cid": self.cid,
             "ddk": self.ddk,
             "referer": self.referer,
             "type": self.tags_type,
-            "acceptLanguage": self.acceptLanguage,
+            "acceptLanguage": self.accept_language,
             "ip": self.ip,
             "version": self.version,
-        }
+        }
+        if self.cid:  # Only include cid if it's not empty
+            data["cid"] = self.cid
+        return data

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/hyper_sdk/incapsula_input.py

@@ -8,11 +8,11 @@ class UtmvcInput:
         self.script = script
 
 class ReeseInput:
-    def __init__(self, user_agent: str, acceptLanguage: str, ip: str, pageUrl: str, pow: str, script: str, scriptUrl: str = ""):
+    def __init__(self, user_agent: str, accept_language: str, ip: str, pageUrl: str, script: str, script_url: str, pow: str = ""):
         self.user_agent = user_agent
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip
-        self.scriptUrl = scriptUrl
+        self.script_url = script_url
         self.pow = pow
         self.script = script
-        self.pageUrl = pageUrl
+        self.pageUrl = pageUrl

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/hyper_sdk/kasada_input.py

@@ -1,22 +1,26 @@
 class KasadaPowInput:
-    def __init__(self, st: int, ct: str, domain: str, work_time: int = None):
+    def __init__(self, st: int, ct: str, domain: str, fc: str = "", work_time: int = None):
         # St is the x-kpsdk-st value returned by the /tl POST request
         self.st = st
         # Ct is the x-kpsdk-ct value returned by the /tl POST request
         self.ct = ct
+        # fc is the x-kpsdk-fc value returned by the /mfc GET request, if used by the site
+        self.fc = fc
         # WorkTime can be used to pre-generate POW strings
         self.work_time = work_time
         self.domain = domain
 
     def to_dict(self):
         result = {"st": self.st, "ct": self.ct, "domain": self.domain}
+        if self.fc:  # Only include fc if it's not empty
+            result["fc"] = self.fc
         if self.work_time is not None:
             result["workTime"] = self.work_time
         return result
 
 
 class KasadaPayloadInput:
-    def __init__(self, user_agent: str, ips_link: str, script: str, acceptLanguage: str, ip: str):
+    def __init__(self, user_agent: str, ips_link: str, script: str, accept_language: str, ip: str):
         # UserAgent must be a Chrome Windows User-Agent.
         self.user_agent = user_agent
 
@@ -27,7 +31,7 @@ class KasadaPayloadInput:
         self.script = script
 
         # Your accept-language header
-        self.acceptLanguage = acceptLanguage
+        self.accept_language = accept_language
         self.ip = ip
 
     def to_dict(self):
@@ -35,7 +39,29 @@ class KasadaPayloadInput:
             "userAgent": self.user_agent,
             "ipsLink": self.ips_link,
             "script": self.script,
-            "acceptLanguage": self.acceptLanguage,
+            "acceptLanguage": self.accept_language,
             "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.7.0 → hyper_sdk-2.12.1}/hyper_sdk/session.py

@@ -1,14 +1,13 @@
 """Session class for Hyper Solutions API."""
 
 from typing import Optional, Dict, Any, Tuple
-from urllib.parse import quote
 import httpx
 import json
-import zstandard as zstd
+import gzip
 
 from .shared import generate_signature, build_headers, validate_response
-from .akamai_input import SensorInput, PixelInput, DynamicInput, SbsdInput
-from .kasada_input import KasadaPowInput, KasadaPayloadInput
+from .akamai_input import SensorInput, PixelInput, SbsdInput
+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
@@ -24,12 +23,7 @@ class Session:
         self.app_secret = app_secret
         self.client = httpx.Client() if client is None else client
         self._owns_client = client is None
-        self.compression = compression and zstd is not None
-
-        # Initialize zstd compressor and decompressor if available
-        if self.compression:
-            self._compressor = zstd.ZstdCompressor(level=3)
-            self._decompressor = zstd.ZstdDecompressor()
+        self.compression = compression
 
     def __enter__(self):
         return self
@@ -63,18 +57,18 @@ class Session:
             'bmsz': input_data.bmsz,
             'version': input_data.version,
             'pageUrl': input_data.page_url,
-            'scriptHash': input_data.script_hash,
-            'dynamicValues': input_data.dynamic_values,
+            'script': input_data.script,
+            'scriptUrl': input_data.script_url,
             'context': input_data.context,
             'ip': input_data.ip,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
         }
         payload = json.dumps(payload_data).encode('utf-8')
 
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = self.client.post(sensor_endpoint, headers=headers, content=payload)
 
@@ -102,26 +96,11 @@ class Session:
             'pageUrl': input_data.page_url,
             'o': input_data.o_cookie,
             'script': input_data.script,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
             'ip': input_data.ip,
             'index': input_data.index,
         })
 
-    def parse_v3_dynamic(self, input_data: DynamicInput) -> str:
-        """
-        Returns the dynamic values required to generate sensor data for V3 dynamic with Hyper Solutions API.
-
-        Args:
-            input_data (DynamicInput): An instance of DynamicInput containing the necessary data for parsing the script.
-
-        Returns:
-            str: Dynamic values as a string.
-        """
-        sensor_endpoint = "https://akm.hypersolutions.co/v3dynamic"
-        return self._send_request(sensor_endpoint, {
-            'script': input_data.script,
-        })
-
     def generate_pixel_data(self, input_data: PixelInput) -> str:
         """
         Returns the pixel data using the Hyper Solutions API.
@@ -138,17 +117,16 @@ class Session:
             'htmlVar': input_data.html_var,
             'scriptVar': input_data.script_var,
             'ip': input_data.ip,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
         })
 
-    def generate_reese84_sensor(self, site: str, input_data: ReeseInput) -> str:
+    def generate_reese84_sensor(self, input_data: ReeseInput) -> str:
         """
         Returns the sensor data required to generate valid reese84 cookies using the Hyper Solutions API.
 
         This function sends a request to the specified sensor endpoint with the necessary data to generate the reese84 sensor data.
 
         Args:
-            site (str): The name of the site that will be used to generate the sensor data.
             input_data (ReeseInput): The input data.
 
         Returns:
@@ -157,11 +135,11 @@ class Session:
         Raises:
             ValueError: If the script attribute in input_data is empty.
         """
-        return self._send_request("https://incapsula.hypersolutions.co/reese84/" + quote(site), {
+        return self._send_request("https://incapsula.hypersolutions.co/reese84", {
             'userAgent': input_data.user_agent,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
             'ip': input_data.ip,
-            'scriptUrl': input_data.scriptUrl,
+            'scriptUrl': input_data.script_url,
             'pageUrl': input_data.pageUrl,
             'pow': input_data.pow,
             'script': input_data.script,
@@ -195,7 +173,7 @@ class Session:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = self.client.post("https://incapsula.hypersolutions.co/utmvc", headers=headers, content=payload)
 
@@ -237,7 +215,7 @@ class Session:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = self.client.post("https://kasada.hypersolutions.co/payload", headers=headers, content=payload)
 
@@ -248,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.
@@ -316,7 +307,7 @@ class Session:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = self.client.post("https://trustdecision.hypersolutions.co/payload", headers=headers, content=payload)
 
@@ -382,12 +373,12 @@ class Session:
         headers = build_headers(self.api_key, self.jwt_key, self.app_key, self.app_secret)
         # Add compression headers
         if self.compression:
-            headers["accept-encoding"] = "zstd"
+            headers["accept-encoding"] = "gzip"
         return headers
 
     def _compress_payload(self, payload: bytes) -> Tuple[bytes, bool]:
         """
-        Compresses the payload using zstd if enabled and payload is large enough.
+        Compresses the payload using gzip if enabled and payload is large enough.
 
         Args:
             payload (bytes): The payload to potentially compress
@@ -399,7 +390,7 @@ class Session:
             return payload, False
 
         try:
-            compressed = self._compressor.compress(payload)
+            compressed = gzip.compress(payload, compresslevel=6)
             return compressed, True
         except Exception:
             # Fall back to uncompressed if compression fails
@@ -407,7 +398,7 @@ class Session:
 
     def _decompress_response(self, response: httpx.Response) -> bytes:
         """
-        Decompresses the response body if it's compressed with zstd.
+        Decompresses the response body if it's compressed with gzip.
 
         Args:
             response (httpx.Response): The HTTP response
@@ -418,9 +409,9 @@ class Session:
         content = response.content
         content_encoding = response.headers.get("content-encoding", "").lower()
 
-        if content_encoding == "zstd" and self.compression:
+        if content_encoding == "gzip" and self.compression:
             try:
-                return self._decompressor.decompress(content)
+                return gzip.decompress(content)
             except Exception:
                 # Fall back to original content if decompression fails
                 pass
@@ -444,7 +435,7 @@ class Session:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = self.client.post(url, headers=headers, content=payload)
 
@@ -471,7 +462,7 @@ class Session:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = self.client.post(url, headers=headers, content=payload)
 

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/hyper_sdk/session_async.py

@@ -1,14 +1,13 @@
 """Async version of the Session class for Hyper Solutions API."""
 
 from typing import Optional, Dict, Any, Tuple
-from urllib.parse import quote
 import httpx
 import json
-import zstandard as zstd
+import gzip
 
 from .shared import generate_signature, build_headers, validate_response
-from .akamai_input import SensorInput, PixelInput, DynamicInput, SbsdInput
-from .kasada_input import KasadaPowInput, KasadaPayloadInput
+from .akamai_input import SensorInput, PixelInput, SbsdInput
+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
@@ -24,12 +23,7 @@ class SessionAsync:
         self.app_secret = app_secret
         self.client = client
         self._owns_client = client is None
-        self.compression = compression and zstd is not None
-
-        # Initialize zstd compressor and decompressor if available
-        if self.compression:
-            self._compressor = zstd.ZstdCompressor(level=3)
-            self._decompressor = zstd.ZstdDecompressor()
+        self.compression = compression
 
     async def __aenter__(self):
         if self._owns_client:
@@ -67,18 +61,18 @@ class SessionAsync:
             'bmsz': input_data.bmsz,
             'version': input_data.version,
             'pageUrl': input_data.page_url,
-            'scriptHash': input_data.script_hash,
-            'dynamicValues': input_data.dynamic_values,
+            'script': input_data.script,
+            'scriptUrl': input_data.script_url,
             'context': input_data.context,
             'ip': input_data.ip,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
         }
         payload = json.dumps(payload_data).encode('utf-8')
 
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = await self.client.post(sensor_endpoint, headers=headers, content=payload)
 
@@ -106,26 +100,11 @@ class SessionAsync:
             'pageUrl': input_data.page_url,
             'o': input_data.o_cookie,
             'script': input_data.script,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
             'ip': input_data.ip,
             'index': input_data.index,
         })
 
-    async def parse_v3_dynamic(self, input_data: DynamicInput) -> str:
-        """
-        Returns the dynamic values required to generate sensor data for V3 dynamic with Hyper Solutions API.
-
-        Args:
-            input_data (DynamicInput): An instance of DynamicInput containing the necessary data for parsing the script.
-
-        Returns:
-            str: Dynamic values as a string.
-        """
-        sensor_endpoint = "https://akm.hypersolutions.co/v3dynamic"
-        return await self._send_request(sensor_endpoint, {
-            'script': input_data.script,
-        })
-
     async def generate_pixel_data(self, input_data: PixelInput) -> str:
         """
         Returns the pixel data using the Hyper Solutions API.
@@ -142,17 +121,16 @@ class SessionAsync:
             'htmlVar': input_data.html_var,
             'scriptVar': input_data.script_var,
             'ip': input_data.ip,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
         })
 
-    async def generate_reese84_sensor(self, site: str, input_data: ReeseInput) -> str:
+    async def generate_reese84_sensor(self, input_data: ReeseInput) -> str:
         """
         Returns the sensor data required to generate valid reese84 cookies using the Hyper Solutions API.
 
         This function sends a request to the specified sensor endpoint with the necessary data to generate the reese84 sensor data.
 
         Args:
-            site (str): The name of the site that will be used to generate the sensor data.
             input_data (ReeseInput): The input data.
 
         Returns:
@@ -161,11 +139,11 @@ class SessionAsync:
         Raises:
             ValueError: If the script attribute in input_data is empty.
         """
-        return await self._send_request("https://incapsula.hypersolutions.co/reese84/" + quote(site), {
+        return await self._send_request("https://incapsula.hypersolutions.co/reese84", {
             'userAgent': input_data.user_agent,
-            'acceptLanguage': input_data.acceptLanguage,
+            'acceptLanguage': input_data.accept_language,
             'ip': input_data.ip,
-            'scriptUrl': input_data.scriptUrl,
+            'scriptUrl': input_data.script_url,
             'pageUrl': input_data.pageUrl,
             'pow': input_data.pow,
             'script': input_data.script,
@@ -200,7 +178,7 @@ class SessionAsync:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = await self.client.post("https://incapsula.hypersolutions.co/utmvc", headers=headers, content=payload)
 
@@ -243,7 +221,7 @@ class SessionAsync:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = await self.client.post("https://kasada.hypersolutions.co/payload", headers=headers, content=payload)
 
@@ -254,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.
@@ -325,7 +316,7 @@ class SessionAsync:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = await self.client.post("https://trustdecision.hypersolutions.co/payload", headers=headers, content=payload)
 
@@ -391,12 +382,12 @@ class SessionAsync:
         headers = build_headers(self.api_key, self.jwt_key, self.app_key, self.app_secret)
         # Add compression headers
         if self.compression:
-            headers["accept-encoding"] = "zstd"
+            headers["accept-encoding"] = "gzip"
         return headers
 
     def _compress_payload(self, payload: bytes) -> Tuple[bytes, bool]:
         """
-        Compresses the payload using zstd if enabled and payload is large enough.
+        Compresses the payload using gzip if enabled and payload is large enough.
 
         Args:
             payload (bytes): The payload to potentially compress
@@ -408,7 +399,7 @@ class SessionAsync:
             return payload, False
 
         try:
-            compressed = self._compressor.compress(payload)
+            compressed = gzip.compress(payload, compresslevel=6)
             return compressed, True
         except Exception:
             # Fall back to uncompressed if compression fails
@@ -416,7 +407,7 @@ class SessionAsync:
 
     def _decompress_response(self, response: httpx.Response) -> bytes:
         """
-        Decompresses the response body if it's compressed with zstd.
+        Decompresses the response body if it's compressed with gzip.
 
         Args:
             response (httpx.Response): The HTTP response
@@ -427,9 +418,9 @@ class SessionAsync:
         content = response.content
         content_encoding = response.headers.get("content-encoding", "").lower()
 
-        if content_encoding == "zstd" and self.compression:
+        if content_encoding == "gzip" and self.compression:
             try:
-                return self._decompressor.decompress(content)
+                return gzip.decompress(content)
             except Exception:
                 # Fall back to original content if decompression fails
                 pass
@@ -454,7 +445,7 @@ class SessionAsync:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = await self.client.post(url, headers=headers, content=payload)
 
@@ -482,7 +473,7 @@ class SessionAsync:
         # Compress payload if large enough
         payload, use_compression = self._compress_payload(payload)
         if use_compression:
-            headers["content-encoding"] = "zstd"
+            headers["content-encoding"] = "gzip"
 
         response = await self.client.post(url, headers=headers, content=payload)
 

{hyper_sdk-2.7.0 → hyper_sdk-2.12.1}/hyper_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyper_sdk
-Version: 2.7.0
+Version: 2.12.1
 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.7.0 → hyper_sdk-2.12.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hyper_sdk"
-version = "2.7.0"
+version = "2.12.1"
 description = "Hyper Solutions Python SDK"
 readme = "README.md"
 requires-python = ">=3.7"
@@ -21,7 +21,7 @@ dependencies = [
     "idna>=3.6",
     "jsonpickle>=3.0.3",
     "PyJWT>=2.8.0",
-    "urllib3>=2.2.1",
+    "urllib3>=2.2.1"
 ]
 license = {file = "LICENSE"}