https://github.com/hyper-solutions/hyper-sdk-js
Hyper Solutions SDK for JavaScript / TypeScript - With support for Akamai Bot Manager, Incapsula, Datadome and Kasada..
https://github.com/hyper-solutions/hyper-sdk-js
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
Last synced: about 1 month ago
JSON representation
Hyper Solutions SDK for JavaScript / TypeScript - With support for Akamai Bot Manager, Incapsula, Datadome and Kasada..
- Host: GitHub
- URL: https://github.com/hyper-solutions/hyper-sdk-js
- Owner: Hyper-Solutions
- License: mit
- Created: 2023-12-17T19:17:42.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-08-26T08:36:34.000Z (about 1 month ago)
- Last Synced: 2025-08-26T10:39:31.181Z (about 1 month ago)
- 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
- Language: TypeScript
- Homepage: https://discord.gg/akamai
- Size: 66.4 KB
- Stars: 16
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hyper Solutions SDK - TypeScript/JavaScript Library for Bot Protection Bypass (Akamai, Incapsula, Kasada, DataDome)



[](https://discord.gg/akamai)
A 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.
Perfect for **web scraping**, **automation**, and **data collection** from protected websites.
## 🔑 Getting API Access
Before using this SDK, you'll need an API key from Hyper Solutions:
1. **Visit [hypersolutions.co](https://hypersolutions.co?utm_source=github&utm_medium=sdk_readme&utm_campaign=node_sdk_api_access)** to create your account
2. **Choose your plan**:
- 💳 **Pay-as-you-go**: Perfect for testing and small-scale usage
- 📊 **Subscription plans**: Cost-effective for high-volume applications
3. **Get your API key** from the dashboard
4. **Start bypassing bot protection** with this SDK!## 🚀 Quick Start
```typescript
import { Session, SensorInput } from 'hyper-sdk-js';const session = new Session("your-api-key");
// Generate Akamai sensor data
const result = await session.generateSensorData(new SensorInput(
// sensor input fields
));console.log(`Generated sensor data: ${result.payload}`);
console.log(`Sensor context: ${result.context}`);
```## ✨ Features
- 🛡️ **Akamai Bot Manager**: Generate sensor data, handle pixel challenges, validate cookies
- 🔒 **Incapsula Protection**: Generate Reese84 sensors and UTMVC cookies
- ⚡ **Kasada Bypass**: Generate payload data (CT) and POW tokens (CD)
- 🎯 **DataDome Solutions**: Solve tags, slider captchas and interstitial challenges
- 🔧 **Easy Integration**: Simple TypeScript/JavaScript API with async/await support
- ⚙️ **Flexible Configuration**: Custom HTTP clients and session management## 📦 Installation
Install the Hyper Solutions SDK for Node.js/TypeScript using:
```bash
npm install hyper-sdk-js
```## 📋 Table of Contents
- [Quick Start](#-quick-start)
- [Installation](#-installation)
- [Basic Usage](#-basic-usage)
- [Akamai Bot Manager](#-akamai-bot-manager)
- [Incapsula Protection](#-incapsula-protection)
- [Kasada Bypass](#-kasada-bypass)
- [DataDome Solutions](#-datadome-solutions)
- [Documentation](#-documentation)
- [Contributing](#-contributing)
- [License](#-license)## 🔧 Basic Usage
### Creating a Session
Initialize the SDK with your API key to start bypassing bot protection:
```typescript
import { Session } from 'hyper-sdk-js';// Basic session
const session = new Session("your-api-key");// Advanced session with custom configuration
const session = new Session(
"your-api-key",
"your-jwt-key",
"your-app-key",
"your-app-secret",
customRequestOptions
);
```## 🛡️ Akamai Bot Manager
Bypass **Akamai Bot Manager** protection with sensor data generation, cookie validation, and challenge solving.
### Generating Sensor Data
Generate sensor data for valid **Akamai cookies** and bot detection bypass:
```typescript
import { SensorInput, generateSensorData } from 'hyper-sdk-js';const result = await generateSensorData(session, new SensorInput(
// sensor input fields
));
```### Parsing Script Path
Extract Akamai Bot Manager script paths from HTML:
```typescript
import { parseAkamaiPath } from 'hyper-sdk-js';const scriptPath = parseAkamaiPath(htmlContent);
```### Handling Sec-Cpt Challenges
Solve **sec-cpt challenges** with built-in parsing and payload generation:
```typescript
import { parseChallengeHTML, parseChallengeJSON } from 'hyper-sdk-js';// Parse sec-cpt challenge from HTML
const challenge = parseChallengeHTML(htmlContent);// Or parse from JSON response
const challenge = parseChallengeJSON(jsonResponse);// Generate challenge response payload
if (challenge?.cryptoChallenge) {
const payload = challenge.cryptoChallenge.generatePayload(secCptCookie);
}// Handle challenge timing requirements
await challenge?.wait();
```### Cookie Validation
Validate **Akamai _abck cookies** and session states:
```typescript
import { isAkamaiCookieValid, isAkamaiCookieInvalidated } from 'hyper-sdk-js';// Check if cookie is valid for the current request count
const isValid = isAkamaiCookieValid(cookieValue, requestCount);// Check if cookie has been invalidated and needs refresh
const needsRefresh = isAkamaiCookieInvalidated(cookieValue);
```### Pixel Challenge Solving
Handle **Akamai pixel challenges** for advanced bot detection bypass:
```typescript
import {
PixelInput,
generatePixelData,
parsePixelHtmlVar,
parsePixelScriptUrl,
parsePixelScriptVar
} from 'hyper-sdk-js';// Parse pixel challenge data
const htmlVar = parsePixelHtmlVar(htmlContent);
const scriptUrls = parsePixelScriptUrl(htmlContent);
const scriptVar = parsePixelScriptVar(scriptContent);// Generate pixel data
const pixelData = await generatePixelData(session, new PixelInput(
// pixel input fields
));
```### V3 Dynamic Values
Parse V3 dynamic script values for advanced sensor generation:
```typescript
import { V3DynamicInput, parseV3DynamicValues } from 'hyper-sdk-js';const dynamicValues = await parseV3DynamicValues(session, new V3DynamicInput(
// v3 dynamic input fields
));
```### SBSD Challenge Solving
Generate SBSD data for specialized Akamai challenges:
```typescript
import { SbsdInput, generateSbsdPayload } from 'hyper-sdk-js';const sbsdData = await generateSbsdPayload(session, new SbsdInput(
// sbsd input fields
));
```## 🔒 Incapsula Protection
Bypass **Incapsula bot detection** with Reese84 sensors and UTMVC cookie generation.
### Generating Reese84 Sensors
Create **Reese84 sensor data** for Incapsula bypass:
```typescript
import { Reese84Input, generateReese84Sensor } from 'hyper-sdk-js';const sensorData = await generateReese84Sensor(session, new Reese84Input(
// reese84 input fields
));
```### UTMVC Cookie Generation
Generate **UTMVC cookies** for Incapsula protection bypass:
```typescript
import { UtmvcInput, generateUtmvcCookie } from 'hyper-sdk-js';const result = await generateUtmvcCookie(session, new UtmvcInput(
// utmvc input fields
));const utmvcCookie = result.payload;
const swhanedl = result.swhanedl;
```### Script Path Parsing
Parse **UTMVC script paths** and generate submit paths:
```typescript
import {
parseUtmvcScriptPath,
generateUtmvcScriptPath,
getSessionIds,
isSessionCookie
} from 'hyper-sdk-js';// Parse script path from content
const scriptPath = parseUtmvcScriptPath(scriptContent);// Generate unique submit path
const submitPath = generateUtmvcScriptPath();// Extract session IDs from cookies
const sessionIds = getSessionIds(cookies);
```### Dynamic Reese Script Parsing
Parse dynamic Reese84 script paths from interruption pages:
```typescript
import { parseDynamicReeseScript } from 'hyper-sdk-js';const result = parseDynamicReeseScript(htmlContent, "https://example.com");
console.log(result.sensorPath, result.scriptPath);
```## ⚡ Kasada Bypass
Defeat **Kasada Bot Manager** with payload generation and POW solving.
### Generating Payload Data (CT)
Create **x-kpsdk-ct tokens** for Kasada bypass:
```typescript
import { KasadaPayloadInput, generateKasadaPayload } from 'hyper-sdk-js';const result = await generateKasadaPayload(session, new KasadaPayloadInput(
// kasada payload input fields
));const payload = result.payload;
const headers = result.headers;
```### Generating POW Data (CD)
Solve **Kasada Proof-of-Work** challenges for x-kpsdk-cd tokens:
```typescript
import { KasadaPowInput, generateKasadaPow } from 'hyper-sdk-js';const powPayload = await generateKasadaPow(session, new KasadaPowInput(
// kasada pow input fields
));
```### Script Path Extraction
Extract **Kasada script paths** from blocked pages (HTTP 429):
```typescript
import { parseKasadaPath } from 'hyper-sdk-js';const scriptPath = parseKasadaPath(blockedPageHtml);
// Returns: /ips.js?timestamp=...
```## 🎯 DataDome Solutions
Solve **DataDome captchas** including slider challenges and interstitial pages.
### Interstitial Challenge Solving
Bypass **DataDome interstitial pages**:
```typescript
import {
InterstitialInput,
generateInterstitialPayload,
parseInterstitialDeviceCheckUrl
} from 'hyper-sdk-js';// Parse device check URL
const deviceUrl = parseInterstitialDeviceCheckUrl(htmlContent, datadomeCookie, refererUrl);// Generate interstitial payload
const result = await generateInterstitialPayload(session, new InterstitialInput(
// interstitial input fields
));const payload = result.payload;
const headers = result.headers;
// POST payload to https://geo.captcha-delivery.com/interstitial/
```### Slider Captcha Solving
Solve **DataDome slider captchas** automatically:
```typescript
import {
SliderInput,
generateSliderPayload,
parseSliderDeviceCheckUrl
} from 'hyper-sdk-js';// Parse device check URL
const parseResult = parseSliderDeviceCheckUrl(htmlContent, datadomeCookie, refererUrl);if (parseResult.isIpBanned) {
console.log("IP is banned");
} else {
// Generate slider payload
const result = await generateSliderPayload(session, new SliderInput(
// slider input fields
));const checkUrl = result.payload;
const headers = result.headers;
// GET request to checkUrl
}
```### Tags Payload Generation
Generate **DataDome tags payload**:
```typescript
import { TagsInput, generateTagsPayload } from 'hyper-sdk-js';const tagsPayload = await generateTagsPayload(session, new TagsInput(
// tags input fields
));
```## 📖 Documentation
For detailed documentation on how to use the SDK, including examples and API reference, please visit our documentation website:
[https://docs.justhyped.dev/](https://docs.justhyped.dev/)
### Getting Help
- Check our [documentation](https://docs.justhyped.dev)
- Join our [Discord community](https://discord.gg/akamai)## 🤝 Contributing
If you find any issues or have suggestions for improvement, please open an issue or submit a pull request.
## 📄 License
This SDK is licensed under the [MIT License](LICENSE).
---
**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