🌪️ Windscribe Proxy SDK

A powerful and unofficial Node.js SDK for Windscribe proxy services featuring custom SNI support, bulk testing capabilities, comprehensive session management, and advanced monitoring.


✨ Features

- 🔐 Smart Authentication - Automatic session management with 2FA support
- 🌐 Custom SNI Support - Enhanced privacy with configurable SNI masking
- 🚀 Bulk Proxy Testing - Test multiple proxies concurrently with detailed metrics
- 📊 Real-time Analytics - Traffic usage, latency monitoring, and success rates
- 💾 State Persistence - Automatic session saving and loading
- 🔍 Smart DNS Resolution - Multiple resolver support with intelligent fallback
- 🛡️ TLS Security - Advanced TLS configurations with custom certificate handling
- 🎯 OOP Interface - Modern class-based API with event-driven architecture
- 🔄 Auto-Reconnect - Automatic connection recovery and health monitoring
- ⚖️ Load Balancing - Smart request distribution across multiple servers
- 📈 Advanced Monitoring - Real-time connection monitoring and analytics

🚀 Quick Start

``bash
npm install windscribe-proxy-sdk
`

$3

`javascript
const { session, serverCredentials, testProxy } = require('windscribe-proxy-sdk');

// Login and test a proxy
await session('username', 'password');
await serverCredentials();

const result = await testProxy('us-east-001.totallyacdn.com');
console.log(✅ Connected! IP: ${result.ip}, Latency: ${result.latency}ms);
`

$3

`javascript
const { WindscribeSDK } = require('windscribe-proxy-sdk');

const sdk = new WindscribeSDK({
autoReconnect: true,
enableLogging: true,
healthCheckInterval: 30000
});

// Event-driven monitoring
sdk.on('proxy_connected', (server) => {
console.log(Connected to: ${server.hostname});
});

sdk.on('health_check', (result) => {
console.log(Health: ${result.status}, Latency: ${result.latency}ms);
});

// Advanced operations
await sdk.session('username', 'password');
const bestServers = await sdk.findBestServers({
country: 'US',
maxLatency: 500,
testCount: 10
});
`

📚 Core API

$3

`javascript
// Basic login
await session('username', 'password');

// Login with 2FA
await session('username', 'password', '123456');

// Get proxy credentials
await serverCredentials();
`

$3

`javascript
// Test single proxy
const result = await testProxy('proxy.windscribe.com');

// Advanced testing with custom SNI
const result = await testCustomProxy({
hostname: 'proxy.windscribe.com',
port: 443,
customSni: 'www.google.com',
targetUrl: 'https://httpbin.org/ip'
});

// Bulk testing with concurrency
const results = await bulkTestProxies(proxies, {
concurrency: 5,
timeout: 10000,
customSni: 'www.google.com'
});
`

$3

`javascript
// Find best servers by location
const bestServers = await sdk.findBestServers({
country: 'US',
maxLatency: 300,
testCount: 5
});

// Real-time connection monitoring
const monitoring = await sdk.monitorConnection(
'us-central-001.windscribe.com',
443,
60000 // Monitor for 1 minute
);

// Load balancing across servers
const response = await sdk.loadBalanceRequests([
'us-east-001.windscribe.com',
'us-west-001.windscribe.com'
], 'https://httpbin.org/ip');

// Get detailed statistics
const stats = sdk.getStatistics();
console.log(Success Rate: ${stats.successRate}%);
`

💡 Examples

Check out the examples/ directory for complete usage examples:

$3

`bash

Update credentials in login.js first

node examples/login.js
`

$3

`bash

Load session and test all available servers

node examples/testproxy.js
`

$3

`bash

Test with enhanced privacy using custom SNI

node examples/customreq.js
`

$3

`bash

Monitor proxy connections with health checks

node examples/monitoring.js
`

$3

`bash

Distribute requests across multiple servers

node examples/loadbalance.js
`

$3

`bash

Step 1: Update credentials in login.js

Step 2: Login and save session

node examples/login.js

Step 3: Test custom proxy with SNI

node examples/customreq.js

Step 4: (Optional) Test all servers

node examples/testproxy.js

Step 5: (Optional) Try advanced monitoring

node examples/monitoring.js
`

🔧 Advanced Configuration

$3

`javascript
// Most effective SNI options (recommended)
customSni: 'www.google.com' // Best overall performance
customSni: 'cloudflare.com' // Alternative option
customSni: 'www.microsoft.com' // Corporate environments
`

$3

`javascript
const sdk = new WindscribeSDK({
autoReconnect: true, // Enable auto-reconnection
enableLogging: true, // Enable debug logging
healthCheckInterval: 30000, // Health check interval (ms)
maxRetries: 3, // Max connection retries
timeout: 10000, // Request timeout (ms)
cacheTimeout: 600000 // Server cache timeout (ms)
});
`

$3

`javascript
const results = await bulkTestProxies(proxies, {
concurrency: 3, // Concurrent connections
timeout: 10000, // Connection timeout
customSni: 'www.google.com',
retries: 2 // Retry failed connections
});
`

📖 API Reference

$3

| Method | Description | Returns |
|--------|-------------|---------|
| session(user, pass, 2fa?) | Authenticate with Windscribe | Promise