hyper-sdk 3.0.0__tar.gz → 3.1.0__tar.gz

{hyper_sdk-3.0.0 → hyper_sdk-3.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyper_sdk
-Version: 3.0.0
+Version: 3.1.0
 Summary: Hyper Solutions Python SDK
 License: MIT License
         
@@ -316,6 +316,21 @@ script_path = parse_kasada_script_path(blocked_page_html)
 # Returns: /ips.js?timestamp=...
 ```
 
+### Mobile User-Agent Generation
+
+Generate the **Kasada mobile `user-agent`** value sent on the native app flow. The mobile SDK derives it as the lowercase hex MD5 of `"<os_version> / <bundle_id> <app_version>"`:
+
+```python
+from hyper_sdk import generate_kasada_user_agent
+
+user_agent = generate_kasada_user_agent("18.0.1", "com.example.app", "9.15.0")
+# iOS:     os_version = UIDevice.systemVersion, bundle_id = CFBundleIdentifier
+# Android: os_version = Build.VERSION.SDK_INT,  bundle_id = package name
+# Returns: 7016adc4ba8d433533954ebad33be424
+```
+
+Available in `hyper_sdk` 3.1.0 and later.
+
 ## 🎯 DataDome Solutions
 
 Solve **DataDome captchas** including slider challenges and interstitial pages.

{hyper_sdk-3.0.0 → hyper_sdk-3.1.0}/README.md

@@ -273,6 +273,21 @@ script_path = parse_kasada_script_path(blocked_page_html)
 # Returns: /ips.js?timestamp=...
 ```
 
+### Mobile User-Agent Generation
+
+Generate the **Kasada mobile `user-agent`** value sent on the native app flow. The mobile SDK derives it as the lowercase hex MD5 of `"<os_version> / <bundle_id> <app_version>"`:
+
+```python
+from hyper_sdk import generate_kasada_user_agent
+
+user_agent = generate_kasada_user_agent("18.0.1", "com.example.app", "9.15.0")
+# iOS:     os_version = UIDevice.systemVersion, bundle_id = CFBundleIdentifier
+# Android: os_version = Build.VERSION.SDK_INT,  bundle_id = package name
+# Returns: 7016adc4ba8d433533954ebad33be424
+```
+
+Available in `hyper_sdk` 3.1.0 and later.
+
 ## 🎯 DataDome Solutions
 
 Solve **DataDome captchas** including slider challenges and interstitial pages.

{hyper_sdk-3.0.0 → hyper_sdk-3.1.0}/hyper_sdk/__init__.py

@@ -7,4 +7,5 @@ from .incapsula.dynamic import *
 from .session import *
 from .session_async import *
 from .kasada.parse import *
+from .kasada.user_agent import *
 from .datadome.parse import *

hyper_sdk-3.1.0/hyper_sdk/kasada/__init__.py

@@ -0,0 +1,2 @@
+from .parse import *
+from .user_agent import *

hyper_sdk-3.1.0/hyper_sdk/kasada/user_agent.py

@@ -0,0 +1,24 @@
+import hashlib
+
+__all__ = ["generate_kasada_user_agent"]
+
+
+def generate_kasada_user_agent(os_version: str, bundle_id: str, app_version: str) -> str:
+    """
+        Generates the Kasada mobile user-agent value.
+
+        The Kasada 2.x mobile SDK derives the user-agent header as the lowercase hex MD5 of
+        "<os_version> / <bundle_id> <app_version>". On iOS os_version is UIDevice.systemVersion
+        (e.g. "18.0.1") and bundle_id is the app bundle id (e.g. "com.example.app"); on
+        Android os_version is Build.VERSION.SDK_INT (e.g. "34") and bundle_id is the package name.
+
+        Args:
+            os_version (str): The device OS version string.
+            bundle_id (str): The app bundle id (iOS) or package name (Android).
+            app_version (str): The app version (e.g. "9.15.0").
+
+        Returns:
+            str: The lowercase hex MD5 user-agent value.
+    """
+    raw = f"{os_version} / {bundle_id} {app_version}"
+    return hashlib.md5(raw.encode("utf-8")).hexdigest()

{hyper_sdk-3.0.0 → hyper_sdk-3.1.0}/hyper_sdk/kasada_input.py

@@ -1,67 +1,67 @@
-class KasadaPowInput:
-    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, accept_language: str, ip: str):
-        # UserAgent must be a Chrome Windows User-Agent.
-        self.user_agent = user_agent
-
-        # IpsLink is the ips.js script link, parsed from the block page (429 status code)
-        self.ips_link = ips_link
-
-        # Script is the ips.js script retrieved using the IpsLink url
-        self.script = script
-
-        # Your accept-language header
-        self.accept_language = accept_language
-        self.ip = ip
-
-    def to_dict(self):
-        result = {
-            "userAgent": self.user_agent,
-            "ipsLink": self.ips_link,
-            "script": self.script,
-            "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,
+class KasadaPowInput:
+    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, accept_language: str, ip: str):
+        # UserAgent must be a Chrome Windows User-Agent.
+        self.user_agent = user_agent
+
+        # IpsLink is the ips.js script link, parsed from the block page (429 status code)
+        self.ips_link = ips_link
+
+        # Script is the ips.js script retrieved using the IpsLink url
+        self.script = script
+
+        # Your accept-language header
+        self.accept_language = accept_language
+        self.ip = ip
+
+    def to_dict(self):
+        result = {
+            "userAgent": self.user_agent,
+            "ipsLink": self.ips_link,
+            "script": self.script,
+            "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-3.0.0 → hyper_sdk-3.1.0}/hyper_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyper_sdk
-Version: 3.0.0
+Version: 3.1.0
 Summary: Hyper Solutions Python SDK
 License: MIT License
         
@@ -316,6 +316,21 @@ script_path = parse_kasada_script_path(blocked_page_html)
 # Returns: /ips.js?timestamp=...
 ```
 
+### Mobile User-Agent Generation
+
+Generate the **Kasada mobile `user-agent`** value sent on the native app flow. The mobile SDK derives it as the lowercase hex MD5 of `"<os_version> / <bundle_id> <app_version>"`:
+
+```python
+from hyper_sdk import generate_kasada_user_agent
+
+user_agent = generate_kasada_user_agent("18.0.1", "com.example.app", "9.15.0")
+# iOS:     os_version = UIDevice.systemVersion, bundle_id = CFBundleIdentifier
+# Android: os_version = Build.VERSION.SDK_INT,  bundle_id = package name
+# Returns: 7016adc4ba8d433533954ebad33be424
+```
+
+Available in `hyper_sdk` 3.1.0 and later.
+
 ## 🎯 DataDome Solutions
 
 Solve **DataDome captchas** including slider challenges and interstitial pages.

{hyper_sdk-3.0.0 → hyper_sdk-3.1.0}/hyper_sdk.egg-info/SOURCES.txt

@@ -26,4 +26,6 @@ hyper_sdk/incapsula/__init__.py
 hyper_sdk/incapsula/dynamic.py
 hyper_sdk/incapsula/utmvc.py
 hyper_sdk/kasada/__init__.py
-hyper_sdk/kasada/parse.py
+hyper_sdk/kasada/parse.py
+hyper_sdk/kasada/user_agent.py
+tests/test_user_agent.py

{hyper_sdk-3.0.0 → hyper_sdk-3.1.0}/pyproject.toml

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

hyper_sdk-3.1.0/tests/test_user_agent.py

@@ -0,0 +1,13 @@
+import unittest
+
+from hyper_sdk import generate_kasada_user_agent
+
+
+class KasadaUserAgent(unittest.TestCase):
+    def test_matches_documented_vector(self):
+        ua = generate_kasada_user_agent("18.0.1", "com.example.app", "9.15.0")
+        self.assertEqual(ua, "7016adc4ba8d433533954ebad33be424")
+
+
+if __name__ == "__main__":
+    unittest.main()

hyper_sdk-3.0.0/hyper_sdk/kasada/__init__.py

@@ -1 +0,0 @@
-from .parse import *