{"id":30618188,"url":"https://github.com/hyper-solutions/hyper-sdk-js","last_synced_at":"2025-10-15T03:05:34.420Z","repository":{"id":235204312,"uuid":"732771272","full_name":"Hyper-Solutions/hyper-sdk-js","owner":"Hyper-Solutions","description":"Hyper Solutions SDK for JavaScript / TypeScript - With support for Akamai Bot Manager, Incapsula, Datadome and Kasada..","archived":false,"fork":false,"pushed_at":"2025-08-26T08:36:34.000Z","size":68,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-26T10:39:31.181Z","etag":null,"topics":["akamai","akamai-api","akamai-bot-manager","akamai-sensor-generator","akamai-solver","datadome","datadome-api","datadome-bypass","datadome-captcha","datadome-interstitial","datadome-slider","datadome-solver","incapsula","incapsula-anti-bot","incapsula-api","incapsula-solver","kasada","kasada-api","kasada-solver","reese84"],"latest_commit_sha":null,"homepage":"https://discord.gg/akamai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hyper-Solutions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-12-17T19:17:42.000Z","updated_at":"2025-08-26T08:36:38.000Z","dependencies_parsed_at":"2024-04-22T17:24:27.071Z","dependency_job_id":"c1e55c47-6d1c-415c-812b-4d5f19895fe1","html_url":"https://github.com/Hyper-Solutions/hyper-sdk-js","commit_stats":null,"previous_names":["hyper-solutions/hyper-sdk-js"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Hyper-Solutions/hyper-sdk-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hyper-Solutions%2Fhyper-sdk-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hyper-Solutions%2Fhyper-sdk-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hyper-Solutions%2Fhyper-sdk-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hyper-Solutions%2Fhyper-sdk-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hyper-Solutions","download_url":"https://codeload.github.com/Hyper-Solutions/hyper-sdk-js/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hyper-Solutions%2Fhyper-sdk-js/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272839800,"owners_count":25001886,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["akamai","akamai-api","akamai-bot-manager","akamai-sensor-generator","akamai-solver","datadome","datadome-api","datadome-bypass","datadome-captcha","datadome-interstitial","datadome-slider","datadome-solver","incapsula","incapsula-anti-bot","incapsula-api","incapsula-solver","kasada","kasada-api","kasada-solver","reese84"],"created_at":"2025-08-30T11:09:40.426Z","updated_at":"2025-10-15T03:05:34.410Z","avatar_url":"https://github.com/Hyper-Solutions.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hyper Solutions SDK - TypeScript/JavaScript Library for Bot Protection Bypass (Akamai, Incapsula, Kasada, DataDome)\n\n![Node Version](https://img.shields.io/badge/Node.js-16+-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n![NPM Version](https://img.shields.io/npm/v/hyper-sdk-js)\n![NPM Downloads](https://img.shields.io/npm/dm/hyper-sdk-js)\n\n[![](https://dcbadge.limes.pink/api/server/akamai)](https://discord.gg/akamai)\n\nA powerful **TypeScript/JavaScript SDK** for bypassing modern bot protection systems including **Akamai Bot Manager**, **Incapsula**, **Kasada**, and **DataDome**. Generate valid cookies, solve anti-bot challenges, and automate protected endpoints with ease.\n\nPerfect for **web scraping**, **automation**, and **data collection** from protected websites.\n\n## 🔑 Getting API Access\n\nBefore using this SDK, you'll need an API key from Hyper Solutions:\n\n1. **Visit [hypersolutions.co](https://hypersolutions.co?utm_source=github\u0026utm_medium=sdk_readme\u0026utm_campaign=node_sdk_api_access)** to create your account\n2. **Choose your plan**:\n    - 💳 **Pay-as-you-go**: Perfect for testing and small-scale usage\n    - 📊 **Subscription plans**: Cost-effective for high-volume applications\n3. **Get your API key** from the dashboard\n4. **Start bypassing bot protection** with this SDK!\n\n\n## 🚀 Quick Start\n\n```typescript\nimport { Session, SensorInput, generateSensorData } from 'hyper-sdk-js';\n\nconst session = new Session(\"your-api-key\");\n\n// Generate Akamai sensor data\nconst result = await generateSensorData(session, new SensorInput(\n    // sensor input fields\n));\n\nconsole.log(`Generated sensor data: ${result.payload}`);\nconsole.log(`Sensor context: ${result.context}`);\n```\n\n## ✨ Features\n\n- 🛡️ **Akamai Bot Manager**: Generate sensor data, handle pixel challenges, validate cookies\n- 🔒 **Incapsula Protection**: Generate Reese84 sensors and UTMVC cookies\n- ⚡ **Kasada Bypass**: Generate payload data (CT) and POW tokens (CD)\n- 🎯 **DataDome Solutions**: Solve tags, slider captchas and interstitial challenges\n- 🔧 **Easy Integration**: Simple TypeScript/JavaScript API with async/await support\n- ⚙️ **Flexible Configuration**: Custom HTTP clients and session management\n\n## 📦 Installation\n\nInstall the Hyper Solutions SDK for Node.js/TypeScript using:\n\n```bash\nnpm install hyper-sdk-js\n```\n\n## 📋 Table of Contents\n\n- [Quick Start](#-quick-start)\n- [Installation](#-installation)\n- [Basic Usage](#-basic-usage)\n- [Akamai Bot Manager](#-akamai-bot-manager)\n- [Incapsula Protection](#-incapsula-protection)\n- [Kasada Bypass](#-kasada-bypass)\n- [DataDome Solutions](#-datadome-solutions)\n- [Documentation](#-documentation)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## 🔧 Basic Usage\n\n### Creating a Session\n\nInitialize the SDK with your API key to start bypassing bot protection:\n\n```typescript\nimport { Session } from 'hyper-sdk-js';\n\n// Basic session\nconst session = new Session(\"your-api-key\");\n\n// Advanced session with custom configuration\nconst session = new Session(\n    \"your-api-key\",\n    \"your-jwt-key\",\n    \"your-app-key\",\n    \"your-app-secret\",\n    customRequestOptions\n);\n```\n\n## 🛡️ Akamai Bot Manager\n\nBypass **Akamai Bot Manager** protection with sensor data generation, cookie validation, and challenge solving.\n\n### Generating Sensor Data\n\nGenerate sensor data for valid **Akamai cookies** and bot detection bypass:\n\n```typescript\nimport { SensorInput, generateSensorData } from 'hyper-sdk-js';\n\nconst result = await generateSensorData(session, new SensorInput(\n    // sensor input fields\n));\n```\n\n### Parsing Script Path\n\nExtract Akamai Bot Manager script paths from HTML:\n\n```typescript\nimport { parseAkamaiPath } from 'hyper-sdk-js';\n\nconst scriptPath = parseAkamaiPath(htmlContent);\n```\n\n### Handling Sec-Cpt Challenges\n\nSolve **sec-cpt challenges** with built-in parsing and payload generation:\n\n```typescript\nimport { parseChallengeHTML, parseChallengeJSON } from 'hyper-sdk-js';\n\n// Parse sec-cpt challenge from HTML\nconst challenge = parseChallengeHTML(htmlContent);\n\n// Or parse from JSON response\nconst challenge = parseChallengeJSON(jsonResponse);\n\n// Generate challenge response payload\nif (challenge?.cryptoChallenge) {\n    const payload = challenge.cryptoChallenge.generatePayload(secCptCookie);\n}\n\n// Handle challenge timing requirements\nawait challenge?.wait();\n```\n\n### Cookie Validation\n\nValidate **Akamai _abck cookies** and session states:\n\n```typescript\nimport { isAkamaiCookieValid, isAkamaiCookieInvalidated } from 'hyper-sdk-js';\n\n// Check if cookie is valid for the current request count\nconst isValid = isAkamaiCookieValid(cookieValue, requestCount);\n\n// Check if cookie has been invalidated and needs refresh\nconst needsRefresh = isAkamaiCookieInvalidated(cookieValue);\n```\n\n### Pixel Challenge Solving\n\nHandle **Akamai pixel challenges** for advanced bot detection bypass:\n\n```typescript\nimport {\n    PixelInput,\n    generatePixelData,\n    parsePixelHtmlVar,\n    parsePixelScriptUrl,\n    parsePixelScriptVar\n} from 'hyper-sdk-js';\n\n// Parse pixel challenge data\nconst htmlVar = parsePixelHtmlVar(htmlContent);\nconst scriptUrls = parsePixelScriptUrl(htmlContent);\nconst scriptVar = parsePixelScriptVar(scriptContent);\n\n// Generate pixel data\nconst pixelData = await generatePixelData(session, new PixelInput(\n    // pixel input fields\n));\n```\n\n### SBSD Challenge Solving\n\nGenerate SBSD data for specialized Akamai challenges:\n\n```typescript\nimport { SbsdInput, generateSbsdPayload } from 'hyper-sdk-js';\n\nconst sbsdData = await generateSbsdPayload(session, new SbsdInput(\n    // sbsd input fields\n));\n```\n\n## 🔒 Incapsula Protection\n\nBypass **Incapsula bot detection** with Reese84 sensors and UTMVC cookie generation.\n\n### Generating Reese84 Sensors\n\nCreate **Reese84 sensor data** for Incapsula bypass:\n\n```typescript\nimport { Reese84Input, generateReese84Sensor } from 'hyper-sdk-js';\n\nconst sensorData = await generateReese84Sensor(session, new Reese84Input(\n    // reese84 input fields\n));\n```\n\n### UTMVC Cookie Generation\n\nGenerate **UTMVC cookies** for Incapsula protection bypass:\n\n```typescript\nimport { UtmvcInput, generateUtmvcCookie } from 'hyper-sdk-js';\n\nconst result = await generateUtmvcCookie(session, new UtmvcInput(\n    // utmvc input fields\n));\n\nconst utmvcCookie = result.payload;\nconst swhanedl = result.swhanedl;\n```\n\n### Script Path Parsing\n\nParse **UTMVC script paths** and generate submit paths:\n\n```typescript\nimport {\n    parseUtmvcScriptPath,\n    generateUtmvcScriptPath,\n    getSessionIds,\n    isSessionCookie\n} from 'hyper-sdk-js';\n\n// Parse script path from content\nconst scriptPath = parseUtmvcScriptPath(scriptContent);\n\n// Generate unique submit path\nconst submitPath = generateUtmvcScriptPath();\n\n// Extract session IDs from cookies\nconst sessionIds = getSessionIds(cookies);\n```\n\n### Dynamic Reese Script Parsing\n\nParse dynamic Reese84 script paths from interruption pages:\n\n```typescript\nimport { parseDynamicReeseScript } from 'hyper-sdk-js';\n\nconst result = parseDynamicReeseScript(htmlContent, \"https://example.com\");\nconsole.log(result.sensorPath, result.scriptPath);\n```\n\n## ⚡ Kasada Bypass\n\nDefeat **Kasada Bot Manager** with payload generation and POW solving.\n\n### Generating Payload Data (CT)\n\nCreate **x-kpsdk-ct tokens** for Kasada bypass:\n\n```typescript\nimport { KasadaPayloadInput, generateKasadaPayload } from 'hyper-sdk-js';\n\nconst result = await generateKasadaPayload(session, new KasadaPayloadInput(\n    // kasada payload input fields\n));\n\nconst payload = result.payload;\nconst headers = result.headers;\n```\n\n### Generating POW Data (CD)\n\nSolve **Kasada Proof-of-Work** challenges for x-kpsdk-cd tokens:\n\n```typescript\nimport { KasadaPowInput, generateKasadaPow } from 'hyper-sdk-js';\n\nconst powPayload = await generateKasadaPow(session, new KasadaPowInput(\n    // kasada pow input fields\n));\n```\n\n### Script Path Extraction\n\nExtract **Kasada script paths** from blocked pages (HTTP 429):\n\n```typescript\nimport { parseKasadaPath } from 'hyper-sdk-js';\n\nconst scriptPath = parseKasadaPath(blockedPageHtml);\n// Returns: /ips.js?timestamp=...\n```\n\n## 🎯 DataDome Solutions\n\nSolve **DataDome captchas** including slider challenges and interstitial pages.\n\n### Interstitial Challenge Solving\n\nBypass **DataDome interstitial pages**:\n\n```typescript\nimport {\n    InterstitialInput,\n    generateInterstitialPayload,\n    parseInterstitialDeviceCheckUrl\n} from 'hyper-sdk-js';\n\n// Parse device check URL\nconst deviceUrl = parseInterstitialDeviceCheckUrl(htmlContent, datadomeCookie, refererUrl);\n\n// Generate interstitial payload\nconst result = await generateInterstitialPayload(session, new InterstitialInput(\n    // interstitial input fields\n));\n\nconst payload = result.payload;\nconst headers = result.headers;\n// POST payload to https://geo.captcha-delivery.com/interstitial/\n```\n\n### Slider Captcha Solving\n\nSolve **DataDome slider captchas** automatically:\n\n```typescript\nimport {\n    SliderInput,\n    generateSliderPayload,\n    parseSliderDeviceCheckUrl\n} from 'hyper-sdk-js';\n\n// Parse device check URL\nconst parseResult = parseSliderDeviceCheckUrl(htmlContent, datadomeCookie, refererUrl);\n\nif (parseResult.isIpBanned) {\n    console.log(\"IP is banned\");\n} else {\n    // Generate slider payload\n    const result = await generateSliderPayload(session, new SliderInput(\n        // slider input fields\n    ));\n\n    const checkUrl = result.payload;\n    const headers = result.headers;\n    // GET request to checkUrl\n}\n```\n\n### Tags Payload Generation\n\nGenerate **DataDome tags payload**:\n\n```typescript\nimport { TagsInput, generateTagsPayload } from 'hyper-sdk-js';\n\nconst tagsPayload = await generateTagsPayload(session, new TagsInput(\n    // tags input fields\n));\n```\n\n## 📖 Documentation\n\nFor detailed documentation on how to use the SDK, including examples and API reference, please visit our documentation website:\n\n[https://docs.justhyped.dev/](https://docs.justhyped.dev/)\n\n### Getting Help\n\n- Check our [documentation](https://docs.justhyped.dev)\n- Join our [Discord community](https://discord.gg/akamai)\n\n## 🤝 Contributing\n\nIf you find any issues or have suggestions for improvement, please open an issue or submit a pull request.\n\n## 📄 License\n\nThis SDK is licensed under the [MIT License](LICENSE).\n\n---\n\n**Keywords**: TypeScript SDK, JavaScript SDK, Node.js, bot protection bypass, web scraping, Akamai bypass, Incapsula bypass, Kasada bypass, DataDome bypass, anti-bot, captcha solver, automation, reverse engineering, bot detection, web automation","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyper-solutions%2Fhyper-sdk-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyper-solutions%2Fhyper-sdk-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyper-solutions%2Fhyper-sdk-js/lists"}