iploop 1.0.3 → 1.0.4

package/README.md

@@ -1,8 +1,11 @@
 # IPLoop Node.js SDK
 
-Residential proxy SDK — one-liner web fetching through millions of real IPs.
+Official Node.js SDK for [IPLoop](https://iploop.io) — residential proxy service with millions of real IPs worldwide.
 
-## Install
+[![npm version](https://img.shields.io/npm/v/iploop.svg)](https://www.npmjs.com/package/iploop)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
 
 ```bash
 npm install iploop
@@ -10,57 +13,193 @@ npm install iploop
 
 ## Quick Start
 
-```javascript
-const { IPLoop } = require('iploop');
-const ip = new IPLoop('YOUR_API_KEY');
+```typescript
+import { IPLoopClient } from 'iploop';
+
+const client = new IPLoopClient({ apiKey: 'your-api-key' });
+const response = await client.get('https://httpbin.org/ip');
+console.log(response.data);
+```
+
+## Features
+
+- **Residential proxies** — millions of real IPs across 195+ countries
+- **Geographic targeting** — country and city-level precision
+- **Sticky sessions** — keep the same IP across multiple requests
+- **Auto-retry** — failed requests automatically retry with fresh IPs
+- **Smart headers** — Chrome fingerprint headers matched to target country
+- **HTTP & SOCKS5** — both protocols supported
+- **Concurrent fetching** — batch requests with configurable concurrency
+- **TypeScript** — full type definitions included
+
+## Authentication
+
+Get your API key from the [IPLoop Dashboard](https://iploop.io/dashboard).
+
+```typescript
+const client = new IPLoopClient({
+  apiKey: 'your-api-key',
+  country: 'US',       // default country for all requests
+  debug: true,         // enable request logging
+});
+```
+
+## Geographic Targeting
+
+```typescript
+// Target a specific country
+const resp = await client.get('https://example.com', { country: 'DE' });
 
-// One-liner fetch through US residential IP
-const result = await ip.fetch('https://example.com', { country: 'US' });
-console.log(result.status, result.body);
+// Target a specific city
+const resp = await client.get('https://example.com', { country: 'US', city: 'miami' });
+```
+
+## Sticky Sessions
 
-// Sticky session (same IP across requests)
-const session = ip.session({ country: 'US', city: 'newyork' });
-const page1 = await session.fetch('https://site.com/page1');
-const page2 = await session.fetch('https://site.com/page2');
+Keep the same proxy IP across multiple requests:
 
-// Check usage
-const usage = await ip.usage();
+```typescript
+const session = client.session(undefined, 'US', 'newyork');
 
-// Ask support
-const answer = await ip.ask('how to handle captcha?');
+const page1 = await session.get('https://site.com/page1'); // same IP
+const page2 = await session.get('https://site.com/page2'); // same IP
 ```
 
-## Features
+## HTTP Methods
 
-- **Zero dependencies** — uses Node.js built-in `http`/`https` modules
-- **Auto-retry** with IP rotation (3 attempts by default)
-- **Smart headers** per country (28 countries, 12 Chrome UA versions)
-- **Sticky sessions** for multi-page scraping
-- **Support API** — usage, status, ask
-- **Debug mode** — `new IPLoop('KEY', { debug: true })`
+```typescript
+// GET
+const resp = await client.get('https://httpbin.org/get');
 
-## API
+// POST
+const resp = await client.post('https://httpbin.org/post', { key: 'value' });
+
+// PUT
+const resp = await client.put('https://httpbin.org/put', { key: 'value' });
+
+// DELETE
+const resp = await client.delete('https://httpbin.org/delete');
+```
+
+## Concurrent Fetching
+
+Fetch multiple URLs in parallel:
+
+```typescript
+const results = await client.fetchAll([
+  'https://example.com/page1',
+  'https://example.com/page2',
+  'https://example.com/page3',
+], { country: 'US' }, 10); // 10 concurrent workers
+
+console.log(results);
+// [{ url: '...', status: 200, success: true, sizeKb: 42 }, ...]
+```
+
+## SOCKS5 Support
+
+```typescript
+// Use SOCKS5 protocol
+const resp = await client.get('https://example.com', { protocol: 'socks5' });
+
+// Get SOCKS5 proxy URL for use with other libraries
+const proxyUrl = client.getProxyUrl({ protocol: 'socks5', country: 'US' });
+```
+
+## Use with Other Libraries
+
+Get the proxy URL or agent for use with Puppeteer, Playwright, Got, etc:
+
+```typescript
+// Get proxy URL string
+const proxyUrl = client.getProxyUrl({ country: 'US', session: 'my-session' });
+// → http://your-api-key:country-us:session-my-session@gateway.iploop.io:8880
+
+// Get axios-compatible agent
+const agent = client.getProxyAgent({ country: 'DE' });
+
+// Use with Puppeteer
+const browser = await puppeteer.launch({
+  args: [`--proxy-server=${client.getProxyUrl({ country: 'US' })}`],
+});
+```
+
+## Chrome Fingerprinting
+
+Every request automatically includes 14 Chrome desktop headers matched to the target country. You can also get them directly:
+
+```typescript
+const headers = client.fingerprint('JP');
+// Full Chrome headers with Japanese locale
+```
+
+## Request Statistics
+
+```typescript
+// After making requests...
+console.log(client.getStats());
+// { requests: 10, success: 9, errors: 1, totalTime: 23500, avgTime: 2350, successRate: 90.0 }
+```
+
+## API Methods
+
+```typescript
+// Check bandwidth usage
+const usage = await client.getUsage();
+
+// Service status
+const status = await client.getStatus();
+
+// Available countries
+const countries = await client.getCountries();
+```
+
+## Error Handling
+
+```typescript
+import { AuthenticationError, QuotaExceededError, ProxyError, RateLimitError } from 'iploop';
+
+try {
+  const resp = await client.get('https://example.com');
+} catch (err) {
+  if (err instanceof AuthenticationError) {
+    console.log('Invalid API key');
+  } else if (err instanceof QuotaExceededError) {
+    console.log('Upgrade at https://iploop.io/pricing');
+  } else if (err instanceof ProxyError) {
+    console.log('Proxy connection failed');
+  } else if (err instanceof RateLimitError) {
+    console.log('Rate limited, retry after:', err.retryAfter);
+  }
+}
+```
+
+## Debug Mode
+
+```typescript
+const client = new IPLoopClient({ apiKey: 'your-key', debug: true });
+// Logs: IPLoop: GET https://example.com → 200 (450ms) country=US session=abc123
+```
 
-### `new IPLoop(apiKey, options?)`
-- `apiKey` — your API key from https://iploop.io
-- `options.country` — default country code
-- `options.city` — default city
-- `options.debug` — enable debug logging
+## Configuration
 
-### `ip.fetch(url, options?)`
-Returns `{ status, headers, body }`
-- `country`, `city` — geo targeting
-- `session` — session ID for sticky IP
-- `headers` — custom headers (merged with smart defaults)
-- `retries` — retry count (default: 3)
-- `timeout` — seconds (default: 30)
+| Option | Default | Description |
+|--------|---------|-------------|
+| `apiKey` | *required* | Your IPLoop API key |
+| `proxyHost` | `gateway.iploop.io` | Proxy gateway hostname |
+| `httpPort` | `8880` | HTTP proxy port |
+| `socksPort` | `1080` | SOCKS5 proxy port |
+| `timeout` | `30000` | Request timeout in ms |
+| `country` | — | Default target country |
+| `city` | — | Default target city |
+| `debug` | `false` | Enable debug logging |
 
-### `ip.session(options?)`
-Returns a `StickySession` with `.fetch()` that reuses the same IP.
+## Links
 
-### `ip.usage()` / `ip.status()` / `ip.ask(question)`
-Support API endpoints.
+- **Website**: [iploop.io](https://iploop.io)
+- **Dashboard**: [iploop.io/dashboard](https://iploop.io/dashboard)
+- **Documentation**: [docs.iploop.io](https://docs.iploop.io)
 
 ## License
 
-MIT — https://iploop.io
+MIT

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+/**
+ * IPLoop Node.js SDK
+ * Official SDK for IPLoop residential proxy service
+ * https://iploop.io
+ */
+import { AxiosRequestConfig, AxiosResponse } from 'axios';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+export interface IPLoopConfig {
+    /** Your IPLoop API key */
+    apiKey: string;
+    /** Proxy gateway hostname (default: proxy.iploop.io) */
+    proxyHost?: string;
+    /** HTTP proxy port (default: 8880) */
+    httpPort?: number;
+    /** SOCKS5 proxy port (default: 1080) */
+    socksPort?: number;
+    /** Management API URL (default: https://gateway.iploop.io:9443) */
+    apiUrl?: string;
+    /** Default request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Default target country code */
+    country?: string;
+    /** Default target city */
+    city?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface ProxyOptions {
+    /** Target country code (e.g. "US", "DE", "JP") */
+    country?: string;
+    /** Target city (e.g. "miami", "london") */
+    city?: string;
+    /** Session ID for sticky sessions (same IP across requests) */
+    session?: string;
+    /** Proxy protocol (default: "http") */
+    protocol?: 'http' | 'socks5';
+    /** Enable JavaScript rendering */
+    render?: boolean;
+}
+export interface FetchResult {
+    url: string;
+    status: number;
+    success: boolean;
+    sizeKb: number;
+    error?: string;
+}
+export interface UsageSummary {
+    totalBytes: number;
+    totalRequests: number;
+    planLimitBytes: number;
+    usagePercent: number;
+    estimatedCost: number;
+}
+export interface DailyUsage {
+    date: string;
+    bytesTransferred: number;
+    requestCount: number;
+    successRate: number;
+}
+export declare class IPLoopError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+export declare class AuthenticationError extends IPLoopError {
+    constructor(message?: string);
+}
+export declare class RateLimitError extends IPLoopError {
+    retryAfter?: number | undefined;
+    constructor(message?: string, retryAfter?: number | undefined);
+}
+export declare class QuotaExceededError extends IPLoopError {
+    constructor(message?: string);
+}
+export declare class ProxyError extends IPLoopError {
+    constructor(message?: string);
+}
+export declare class StickySession {
+    private readonly client;
+    readonly sessionId: string;
+    readonly country?: string;
+    readonly city?: string;
+    constructor(client: IPLoopClient, sessionId: string, country?: string, city?: string);
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+}
+export declare class IPLoopClient {
+    private readonly apiKey;
+    private readonly proxyHost;
+    private readonly httpPort;
+    private readonly socksPort;
+    private readonly apiUrl;
+    private readonly timeout;
+    private readonly defaultCountry?;
+    private readonly defaultCity?;
+    private readonly debug;
+    private readonly apiClient;
+    private stats;
+    constructor(config: IPLoopConfig);
+    private buildAuth;
+    /**
+     * Get proxy URL for use with other HTTP libraries (e.g. puppeteer, playwright, got).
+     */
+    getProxyUrl(options?: ProxyOptions): string;
+    /**
+     * Get an HTTP/SOCKS agent for use with axios or other libraries.
+     */
+    getProxyAgent(options?: ProxyOptions): HttpsProxyAgent<string> | SocksProxyAgent;
+    /**
+     * Fetch a URL through the residential proxy with auto-retry and smart headers.
+     */
+    fetch<T = any>(url: string, options?: ProxyOptions, config?: AxiosRequestConfig, retries?: number): Promise<AxiosResponse<T>>;
+    /** GET request through proxy. */
+    get<T = any>(url: string, options?: ProxyOptions, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /** POST request through proxy. */
+    post<T = any>(url: string, data?: any, options?: ProxyOptions, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /** PUT request through proxy. */
+    put<T = any>(url: string, data?: any, options?: ProxyOptions, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /** DELETE request through proxy. */
+    delete<T = any>(url: string, options?: ProxyOptions, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /**
+     * Create a sticky session — all requests reuse the same proxy IP.
+     */
+    session(sessionId?: string, country?: string, city?: string): StickySession;
+    /**
+     * Fetch multiple URLs concurrently through the proxy.
+     */
+    fetchAll(urls: string[], options?: ProxyOptions, concurrency?: number): Promise<FetchResult[]>;
+    /**
+     * Get request statistics.
+     */
+    getStats(): {
+        avgTime: number;
+        successRate: number;
+        requests: number;
+        success: number;
+        errors: number;
+        totalTime: number;
+    };
+    /**
+     * Get Chrome desktop fingerprint headers for a country.
+     */
+    fingerprint(country?: string): Record<string, string>;
+    /** Check bandwidth usage and quota. */
+    getUsage(): Promise<UsageSummary>;
+    /** Check service status. */
+    getStatus(): Promise<any>;
+    /** List available proxy countries. */
+    getCountries(): Promise<any>;
+}
+declare const SDK_VERSION = "1.0.1";
+export { SDK_VERSION };
+export default IPLoopClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAc,EAAiB,kBAAkB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKpD,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,WAAY,SAAQ,KAAK;IAG3B,UAAU,CAAC,EAAE,MAAM;IACnB,QAAQ,CAAC,EAAE,GAAG;gBAFrB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,GAAG,YAAA;CAKxB;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,GAAE,MAA0B;CAIhD;AAED,qBAAa,cAAe,SAAQ,WAAW;IAGpC,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,GAAE,MAA8B,EAChC,UAAU,CAAC,EAAE,MAAM,YAAA;CAK7B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,GAAE,MAA+D;CAIrF;AAED,qBAAa,UAAW,SAAQ,WAAW;gBAC7B,OAAO,GAAE,MAAkC;CAIxD;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAO9E,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIjF,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAGrG;AAiDD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,KAAK,CAAwD;gBAEzD,MAAM,EAAE,YAAY;IAwBhC,OAAO,CAAC,SAAS;IAWjB;;OAEG;IACH,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM;IAQ/C;;OAEG;IACH,aAAa,CAAC,OAAO,GAAE,YAAiB,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe;IAQpF;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiB,EAC1B,MAAM,GAAE,kBAAuB,EAC/B,OAAO,SAAI,GACV,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAuD5B,iCAAiC;IAC3B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIvH,kCAAkC;IAC5B,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,GAAE,YAAiB,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAIpI,iCAAiC;IAC3B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,GAAE,YAAiB,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAInI,oCAAoC;IAC9B,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,EAAE,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAM1H;;OAEG;IACH,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAM3E;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,YAAiB,EAAE,WAAW,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBpG;;OAEG;IACH,QAAQ;;;;;;;;IAQR;;OAEG;IACH,WAAW,CAAC,OAAO,SAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMnD,uCAAuC;IACjC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAKvC,4BAA4B;IACtB,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IAK/B,sCAAsC;IAChC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;CAInC;AAID,QAAA,MAAM,WAAW,UAAU,CAAC;AAsB5B,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * IPLoop Node.js SDK
+ * Official SDK for IPLoop residential proxy service
+ * https://iploop.io
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_VERSION = exports.IPLoopClient = exports.StickySession = exports.ProxyError = exports.QuotaExceededError = exports.RateLimitError = exports.AuthenticationError = exports.IPLoopError = void 0;
+const axios_1 = __importDefault(require("axios"));
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+const https_proxy_agent_1 = require("https-proxy-agent");
+const crypto_1 = require("crypto");
+// ── Errors ───────────────────────────────────────────────────
+class IPLoopError extends Error {
+    constructor(message, statusCode, response) {
+        super(message);
+        this.statusCode = statusCode;
+        this.response = response;
+        this.name = 'IPLoopError';
+    }
+}
+exports.IPLoopError = IPLoopError;
+class AuthenticationError extends IPLoopError {
+    constructor(message = 'Invalid API key') {
+        super(message, 401);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class RateLimitError extends IPLoopError {
+    constructor(message = 'Rate limit exceeded', retryAfter) {
+        super(message, 429);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+exports.RateLimitError = RateLimitError;
+class QuotaExceededError extends IPLoopError {
+    constructor(message = 'Quota exceeded. Upgrade at https://iploop.io/pricing') {
+        super(message, 402);
+        this.name = 'QuotaExceededError';
+    }
+}
+exports.QuotaExceededError = QuotaExceededError;
+class ProxyError extends IPLoopError {
+    constructor(message = 'Proxy connection failed') {
+        super(message);
+        this.name = 'ProxyError';
+    }
+}
+exports.ProxyError = ProxyError;
+// ── Sticky Session ───────────────────────────────────────────
+class StickySession {
+    constructor(client, sessionId, country, city) {
+        this.client = client;
+        this.sessionId = sessionId;
+        this.country = country;
+        this.city = city;
+    }
+    async get(url, config) {
+        return this.client.get(url, { country: this.country, city: this.city, session: this.sessionId }, config);
+    }
+    async post(url, data, config) {
+        return this.client.post(url, data, { country: this.country, city: this.city, session: this.sessionId }, config);
+    }
+}
+exports.StickySession = StickySession;
+// ── Chrome Fingerprint ───────────────────────────────────────
+const CHROME_VERSIONS = ['120.0.0.0', '121.0.0.0', '122.0.0.0', '123.0.0.0', '124.0.0.0', '125.0.0.0', '126.0.0.0'];
+const LANG_MAP = {
+    US: 'en-US,en;q=0.9', GB: 'en-GB,en;q=0.9', DE: 'de-DE,de;q=0.9,en;q=0.8',
+    FR: 'fr-FR,fr;q=0.9,en;q=0.8', JP: 'ja-JP,ja;q=0.9,en;q=0.8', BR: 'pt-BR,pt;q=0.9,en;q=0.8',
+    KR: 'ko-KR,ko;q=0.9,en;q=0.8', IN: 'en-IN,en;q=0.9,hi;q=0.8', ES: 'es-ES,es;q=0.9,en;q=0.8',
+    IT: 'it-IT,it;q=0.9,en;q=0.8', NL: 'nl-NL,nl;q=0.9,en;q=0.8', AU: 'en-AU,en;q=0.9',
+};
+function chromeFingerprint(country = 'US') {
+    const ver = CHROME_VERSIONS[Math.floor(Math.random() * CHROME_VERSIONS.length)];
+    const major = ver.split('.')[0];
+    const lang = LANG_MAP[country.toUpperCase()] || 'en-US,en;q=0.9';
+    return {
+        'User-Agent': `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${ver} Safari/537.36`,
+        'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8',
+        'Accept-Language': lang,
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Connection': 'keep-alive',
+        'Upgrade-Insecure-Requests': '1',
+        'Sec-Fetch-Dest': 'document',
+        'Sec-Fetch-Mode': 'navigate',
+        'Sec-Fetch-Site': 'none',
+        'Sec-Fetch-User': '?1',
+        'Sec-Ch-Ua': `"Chromium";v="${major}", "Google Chrome";v="${major}", "Not-A.Brand";v="99"`,
+        'Sec-Ch-Ua-Mobile': '?0',
+        'Sec-Ch-Ua-Platform': '"Windows"',
+        'Cache-Control': 'max-age=0',
+    };
+}
+// ── Retryable statuses ───────────────────────────────────────
+const RETRYABLE_STATUSES = new Set([403, 407, 429, 500, 502, 503, 504]);
+function newSessionId() {
+    return (0, crypto_1.randomUUID)().replace(/-/g, '').slice(0, 16);
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ── Main Client ──────────────────────────────────────────────
+class IPLoopClient {
+    constructor(config) {
+        this.stats = { requests: 0, success: 0, errors: 0, totalTime: 0 };
+        if (!config.apiKey)
+            throw new AuthenticationError('API key is required');
+        this.apiKey = config.apiKey;
+        this.proxyHost = config.proxyHost || 'proxy.iploop.io';
+        this.httpPort = config.httpPort || 8880;
+        this.socksPort = config.socksPort || 1080;
+        this.apiUrl = config.apiUrl || 'https://gateway.iploop.io:9443';
+        this.timeout = config.timeout || 30000;
+        this.defaultCountry = config.country;
+        this.defaultCity = config.city;
+        this.debug = config.debug || false;
+        this.apiClient = axios_1.default.create({
+            baseURL: this.apiUrl,
+            timeout: this.timeout,
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    // ── Proxy URL & Auth ────────────────────────────────────
+    buildAuth(options = {}) {
+        const parts = [this.apiKey];
+        const country = options.country || this.defaultCountry;
+        const city = options.city || this.defaultCity;
+        if (country)
+            parts.push(`country-${country.toLowerCase()}`);
+        if (city)
+            parts.push(`city-${city.toLowerCase()}`);
+        if (options.session)
+            parts.push(`session-${options.session}`);
+        if (options.render)
+            parts.push('render-1');
+        return parts.join('-');
+    }
+    /**
+     * Get proxy URL for use with other HTTP libraries (e.g. puppeteer, playwright, got).
+     */
+    getProxyUrl(options = {}) {
+        const auth = this.buildAuth(options);
+        if (options.protocol === 'socks5') {
+            return `socks5://user:${auth}@${this.proxyHost}:${this.socksPort}`;
+        }
+        return `http://user:${auth}@${this.proxyHost}:${this.httpPort}`;
+    }
+    /**
+     * Get an HTTP/SOCKS agent for use with axios or other libraries.
+     */
+    getProxyAgent(options = {}) {
+        const url = this.getProxyUrl(options);
+        if (options.protocol === 'socks5')
+            return new socks_proxy_agent_1.SocksProxyAgent(url);
+        return new https_proxy_agent_1.HttpsProxyAgent(url);
+    }
+    // ── Request Methods ─────────────────────────────────────
+    /**
+     * Fetch a URL through the residential proxy with auto-retry and smart headers.
+     */
+    async fetch(url, options = {}, config = {}, retries = 3) {
+        const country = options.country || this.defaultCountry || 'US';
+        const headers = { ...chromeFingerprint(country), ...config.headers };
+        const agent = this.getProxyAgent(options);
+        this.stats.requests++;
+        const start = Date.now();
+        let lastError;
+        for (let attempt = 0; attempt < retries; attempt++) {
+            const sid = options.session || newSessionId();
+            const proxyOpts = { ...options, session: sid };
+            const proxyAgent = options.session ? agent : this.getProxyAgent(proxyOpts);
+            try {
+                const resp = await (0, axios_1.default)({
+                    method: config.method || 'GET',
+                    url,
+                    ...config,
+                    headers,
+                    httpsAgent: proxyAgent,
+                    httpAgent: proxyAgent,
+                    timeout: this.timeout,
+                });
+                const elapsed = Date.now() - start;
+                if (this.debug) {
+                    console.log(`IPLoop: ${config.method || 'GET'} ${url} → ${resp.status} (${elapsed}ms) country=${country} session=${sid}`);
+                }
+                if (RETRYABLE_STATUSES.has(resp.status) && attempt < retries - 1) {
+                    await sleep(1000 * (attempt + 1));
+                    continue;
+                }
+                this.stats.success++;
+                this.stats.totalTime += elapsed;
+                return resp;
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < retries - 1) {
+                    await sleep(1000 * (attempt + 1));
+                }
+            }
+        }
+        this.stats.errors++;
+        this.stats.totalTime += Date.now() - start;
+        if (lastError?.message?.includes('timeout')) {
+            throw new IPLoopError(`All ${retries} retries timed out for ${url}`);
+        }
+        throw new ProxyError(`Proxy connection failed after ${retries} retries: ${lastError?.message}`);
+    }
+    /** GET request through proxy. */
+    async get(url, options = {}, config = {}) {
+        return this.fetch(url, options, { ...config, method: 'GET' });
+    }
+    /** POST request through proxy. */
+    async post(url, data, options = {}, config = {}) {
+        return this.fetch(url, options, { ...config, method: 'POST', data });
+    }
+    /** PUT request through proxy. */
+    async put(url, data, options = {}, config = {}) {
+        return this.fetch(url, options, { ...config, method: 'PUT', data });
+    }
+    /** DELETE request through proxy. */
+    async delete(url, options = {}, config = {}) {
+        return this.fetch(url, options, { ...config, method: 'DELETE' });
+    }
+    // ── Sticky Sessions ─────────────────────────────────────
+    /**
+     * Create a sticky session — all requests reuse the same proxy IP.
+     */
+    session(sessionId, country, city) {
+        return new StickySession(this, sessionId || newSessionId(), country || this.defaultCountry, city || this.defaultCity);
+    }
+    // ── Batch / Concurrent ─────────────────────────────────
+    /**
+     * Fetch multiple URLs concurrently through the proxy.
+     */
+    async fetchAll(urls, options = {}, concurrency = 10) {
+        const results = [];
+        const queue = [...urls];
+        const worker = async () => {
+            while (queue.length > 0) {
+                const url = queue.shift();
+                try {
+                    const resp = await this.get(url, options);
+                    results.push({ url, status: resp.status, success: true, sizeKb: Math.round(JSON.stringify(resp.data).length / 1024) });
+                }
+                catch (err) {
+                    results.push({ url, status: 0, success: false, sizeKb: 0, error: err.message });
+                }
+            }
+        };
+        await Promise.all(Array.from({ length: Math.min(concurrency, urls.length) }, () => worker()));
+        return results;
+    }
+    // ── Stats ───────────────────────────────────────────────
+    /**
+     * Get request statistics.
+     */
+    getStats() {
+        const avg = this.stats.requests > 0 ? this.stats.totalTime / this.stats.requests : 0;
+        const rate = this.stats.requests > 0 ? (this.stats.success / this.stats.requests) * 100 : 0;
+        return { ...this.stats, avgTime: Math.round(avg), successRate: Math.round(rate * 10) / 10 };
+    }
+    // ── Chrome Fingerprint ──────────────────────────────────
+    /**
+     * Get Chrome desktop fingerprint headers for a country.
+     */
+    fingerprint(country = 'US') {
+        return chromeFingerprint(country);
+    }
+    // ── API Methods ─────────────────────────────────────────
+    /** Check bandwidth usage and quota. */
+    async getUsage() {
+        const resp = await this.apiClient.get('/api/support/diagnose');
+        return resp.data;
+    }
+    /** Check service status. */
+    async getStatus() {
+        const resp = await this.apiClient.get('/api/support/status');
+        return resp.data;
+    }
+    /** List available proxy countries. */
+    async getCountries() {
+        const resp = await this.apiClient.get('/api/support/countries');
+        return resp.data;
+    }
+}
+exports.IPLoopClient = IPLoopClient;
+// ── Version Check ────────────────────────────────────────────
+const SDK_VERSION = '1.0.1';
+exports.SDK_VERSION = SDK_VERSION;
+function checkVersion() {
+    try {
+        const https = require('https');
+        https.get('https://registry.npmjs.org/iploop/latest', { timeout: 3000 }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                try {
+                    const latest = JSON.parse(data).version;
+                    if (latest && latest !== SDK_VERSION) {
+                        console.warn(`\n⚠️  IPLoop v${latest} available (you have ${SDK_VERSION}). Run: npm update iploop\n`);
+                    }
+                }
+                catch { }
+            });
+        }).on('error', () => { });
+    }
+    catch { }
+}
+checkVersion();
+exports.default = IPLoopClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,28 +1,53 @@
 {
   "name": "iploop",
-  "version": "1.0.3",
-  "description": "Residential proxy SDK — one-liner web fetching through millions of real IPs",
-  "main": "src/index.js",
+  "version": "1.0.4",
+  "description": "Official Node.js SDK for IPLoop residential proxy service",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "scripts": {
-    "test": "node -e \"const {IPLoop} = require('.'); console.log('OK');\""
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts"
   },
   "keywords": [
     "proxy",
-    "residential",
-    "scraping",
-    "web",
-    "fetch",
-    "rotating",
-    "ip"
+    "residential-proxy",
+    "mobile-proxy",
+    "web-scraping",
+    "iploop",
+    "socks5",
+    "http-proxy"
   ],
-  "author": "IPLoop <partners@iploop.io>",
+  "author": "IPLoop <support@iploop.io>",
   "license": "MIT",
-  "homepage": "https://iploop.io",
   "repository": {
     "type": "git",
-    "url": "https://github.com/iploop/iploop-node-sdk"
+    "url": "https://github.com/iploop/nodejs-sdk"
+  },
+  "homepage": "https://iploop.io",
+  "bugs": {
+    "url": "https://github.com/iploop/nodejs-sdk/issues"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "https-proxy-agent": "^7.0.0",
+    "socks-proxy-agent": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0"
   }
 }

package/src/client.js

@@ -1,128 +0,0 @@
-const http = require('http');
-const https = require('https');
-const zlib = require('zlib');
-const { getHeaders } = require('./headers');
-const { retryRequest, newSessionId } = require('./retry');
-const { SupportClient } = require('./support');
-const { StickySession } = require('./session');
-const { AuthError, ProxyError, TimeoutError } = require('./exceptions');
-
-class IPLoop {
-  constructor(apiKey, opts = {}) {
-    if (!apiKey) throw new AuthError('API key is required');
-    this.apiKey = apiKey;
-    this.proxyHost = 'gateway.iploop.io';
-    this.proxyPort = 8880;
-    this.apiBase = 'https://gateway.iploop.io:9443';
-    this._country = opts.country || null;
-    this._city = opts.city || null;
-    this._debug = opts.debug || false;
-    this._support = new SupportClient(apiKey, this.apiBase);
-  }
-
-  _buildAuth(opts = {}) {
-    const parts = [this.apiKey];
-    const c = opts.country || this._country;
-    if (c) parts.push(`country-${c.toLowerCase()}`);
-    const ci = opts.city || this._city;
-    if (ci) parts.push(`city-${ci.toLowerCase()}`);
-    if (opts.session) parts.push(`session-${opts.session}`);
-    return parts.join(':');
-  }
-
-  _log(...args) { if (this._debug) console.error('[IPLoop]', ...args); }
-
-  fetch(url, opts = {}) {
-    const retries = opts.retries || 3;
-    const timeout = (opts.timeout || 30) * 1000;
-    const country = opts.country || this._country || 'US';
-    const hdrs = { ...getHeaders(country), ...(opts.headers || {}) };
-
-    return retryRequest(async (attempt) => {
-      const sid = opts._noRotate ? opts.session : (opts.session || newSessionId());
-      const auth = this._buildAuth({ ...opts, session: sid });
-      const start = Date.now();
-
-      const result = await this._connectAndFetch(url, auth, hdrs, timeout);
-      const elapsed = ((Date.now() - start) / 1000).toFixed(2);
-      this._log(`GET ${url} → ${result.status} (${elapsed}s) country=${country} session=${sid}`);
-      return result;
-    }, retries);
-  }
-
-  _connectAndFetch(url, auth, headers, timeout) {
-    return new Promise((resolve, reject) => {
-      const parsed = new URL(url);
-      const isHttps = parsed.protocol === 'https:';
-      const targetHost = parsed.hostname;
-      const targetPort = parsed.port || (isHttps ? 443 : 80);
-
-      const connectReq = http.request({
-        host: this.proxyHost,
-        port: this.proxyPort,
-        method: 'CONNECT',
-        path: `${targetHost}:${targetPort}`,
-        headers: {
-          'Host': `${targetHost}:${targetPort}`,
-          'Proxy-Authorization': 'Basic ' + Buffer.from(auth).toString('base64'),
-        },
-        timeout,
-      });
-
-      connectReq.on('connect', (res, socket) => {
-        if (res.statusCode !== 200) {
-          socket.destroy();
-          return reject(new ProxyError(`CONNECT failed: ${res.statusCode}`));
-        }
-
-        const reqOpts = {
-          hostname: targetHost,
-          port: targetPort,
-          path: parsed.pathname + (parsed.search || ''),
-          method: 'GET',
-          headers: { ...headers, Host: targetHost },
-          socket,
-          agent: false,
-          timeout,
-        };
-
-        const mod = isHttps ? https : http;
-        const req = (isHttps ? mod.request({ ...reqOpts, servername: targetHost }) : mod.request(reqOpts));
-
-        req.on('response', (response) => {
-          const chunks = [];
-          const encoding = response.headers['content-encoding'];
-          let stream = response;
-          if (encoding === 'gzip') stream = response.pipe(zlib.createGunzip());
-          else if (encoding === 'deflate') stream = response.pipe(zlib.createInflate());
-          else if (encoding === 'br') stream = response.pipe(zlib.createBrotliDecompress());
-
-          stream.on('data', c => chunks.push(c));
-          stream.on('end', () => {
-            const body = Buffer.concat(chunks).toString();
-            resolve({ status: response.statusCode, headers: response.headers, body });
-          });
-          stream.on('error', reject);
-        });
-        req.on('error', e => reject(new ProxyError(`Request failed: ${e.message}`)));
-        req.on('timeout', () => { req.destroy(); reject(new TimeoutError()); });
-        req.end();
-      });
-
-      connectReq.on('error', e => reject(new ProxyError(`CONNECT error: ${e.message}`)));
-      connectReq.on('timeout', () => { connectReq.destroy(); reject(new TimeoutError()); });
-      connectReq.end();
-    });
-  }
-
-  session(opts = {}) {
-    return new StickySession(this, opts.sessionId || newSessionId(), opts.country, opts.city);
-  }
-
-  usage() { return this._support.usage(); }
-  status() { return this._support.status(); }
-  ask(question) { return this._support.ask(question); }
-  countries() { return this._support.countries(); }
-}
-
-module.exports = { IPLoop };

package/src/exceptions.js

@@ -1,16 +0,0 @@
-class IPLoopError extends Error {
-  constructor(message) { super(message); this.name = 'IPLoopError'; }
-}
-class AuthError extends IPLoopError {
-  constructor(message) { super(message || 'Invalid or missing API key'); this.name = 'AuthError'; }
-}
-class QuotaExceeded extends IPLoopError {
-  constructor(message) { super(message || 'Quota exceeded. Upgrade at https://iploop.io/pricing'); this.name = 'QuotaExceeded'; }
-}
-class ProxyError extends IPLoopError {
-  constructor(message) { super(message || 'Proxy connection failed'); this.name = 'ProxyError'; }
-}
-class TimeoutError extends IPLoopError {
-  constructor(message) { super(message || 'Request timed out'); this.name = 'TimeoutError'; }
-}
-module.exports = { IPLoopError, AuthError, QuotaExceeded, ProxyError, TimeoutError };

package/src/headers.js

@@ -1,47 +0,0 @@
-const CHROME_VERSIONS = [
-  '120.0.6099.109','120.0.6099.199','121.0.6167.85','121.0.6167.160',
-  '122.0.6261.69','122.0.6261.112','123.0.6312.58','123.0.6312.105',
-  '124.0.6367.60','124.0.6367.118','125.0.6422.60','125.0.6422.113',
-];
-const PLATFORMS = {
-  windows: v => `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${v} Safari/537.36`,
-  mac: v => `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${v} Safari/537.36`,
-  linux: v => `Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${v} Safari/537.36`,
-};
-const COUNTRY_PROFILES = {
-  US:['windows','en-US','en-US,en;q=0.9'],GB:['windows','en-GB','en-GB,en;q=0.9'],
-  CA:['windows','en-CA','en-CA,en;q=0.9'],AU:['windows','en-AU','en-AU,en;q=0.9'],
-  DE:['windows','de-DE','de-DE,de;q=0.9,en;q=0.8'],FR:['windows','fr-FR','fr-FR,fr;q=0.9,en;q=0.8'],
-  ES:['windows','es-ES','es-ES,es;q=0.9,en;q=0.8'],IT:['windows','it-IT','it-IT,it;q=0.9,en;q=0.8'],
-  PT:['windows','pt-PT','pt-PT,pt;q=0.9,en;q=0.8'],BR:['windows','pt-BR','pt-BR,pt;q=0.9,en;q=0.8'],
-  NL:['windows','nl-NL','nl-NL,nl;q=0.9,en;q=0.8'],PL:['windows','pl-PL','pl-PL,pl;q=0.9,en;q=0.8'],
-  RU:['windows','ru-RU','ru-RU,ru;q=0.9,en;q=0.8'],UA:['windows','uk-UA','uk-UA,uk;q=0.9,en;q=0.8'],
-  JP:['mac','ja-JP','ja-JP,ja;q=0.9,en;q=0.8'],KR:['windows','ko-KR','ko-KR,ko;q=0.9,en;q=0.8'],
-  CN:['windows','zh-CN','zh-CN,zh;q=0.9,en;q=0.8'],TW:['windows','zh-TW','zh-TW,zh;q=0.9,en;q=0.8'],
-  IN:['windows','en-IN','en-IN,en;q=0.9,hi;q=0.8'],ID:['windows','id-ID','id-ID,id;q=0.9,en;q=0.8'],
-  TH:['windows','th-TH','th-TH,th;q=0.9,en;q=0.8'],VN:['windows','vi-VN','vi-VN,vi;q=0.9,en;q=0.8'],
-  TR:['windows','tr-TR','tr-TR,tr;q=0.9,en;q=0.8'],MX:['windows','es-MX','es-MX,es;q=0.9,en;q=0.8'],
-  AR:['windows','es-AR','es-AR,es;q=0.9,en;q=0.8'],IL:['windows','he-IL','he-IL,he;q=0.9,en;q=0.8'],
-  SE:['windows','sv-SE','sv-SE,sv;q=0.9,en;q=0.8'],NO:['windows','nb-NO','nb-NO,nb;q=0.9,en;q=0.8'],
-};
-function randomUA(platform='windows') {
-  const v = CHROME_VERSIONS[Math.floor(Math.random()*CHROME_VERSIONS.length)];
-  return (PLATFORMS[platform]||PLATFORMS.windows)(v);
-}
-function getHeaders(country='US') {
-  const [platform,lang,acceptLang] = COUNTRY_PROFILES[country.toUpperCase()]||COUNTRY_PROFILES.US;
-  return {
-    'User-Agent': randomUA(platform),
-    'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
-    'Accept-Language': acceptLang,
-    'Accept-Encoding': 'gzip, deflate, br',
-    'Connection': 'keep-alive',
-    'Upgrade-Insecure-Requests': '1',
-    'Sec-Fetch-Dest': 'document',
-    'Sec-Fetch-Mode': 'navigate',
-    'Sec-Fetch-Site': 'none',
-    'Sec-Fetch-User': '?1',
-    'Sec-Ch-Ua-Platform': platform==='windows'?'"Windows"':platform==='mac'?'"macOS"':'"Linux"',
-  };
-}
-module.exports = { getHeaders, randomUA, COUNTRY_PROFILES, CHROME_VERSIONS };

package/src/index.js

@@ -1,5 +0,0 @@
-const { IPLoop } = require('./client');
-const { StickySession } = require('./session');
-const { IPLoopError, AuthError, QuotaExceeded, ProxyError, TimeoutError } = require('./exceptions');
-
-module.exports = { IPLoop, StickySession, IPLoopError, AuthError, QuotaExceeded, ProxyError, TimeoutError };

package/src/retry.js

@@ -1,28 +0,0 @@
-const crypto = require('crypto');
-const RETRYABLE_STATUS = new Set([403, 407, 429, 500, 502, 503, 504]);
-function newSessionId() { return crypto.randomBytes(8).toString('hex'); }
-function shouldRetry(err, statusCode) {
-  if (statusCode && RETRYABLE_STATUS.has(statusCode)) return true;
-  if (err && (err.code === 'ECONNRESET' || err.code === 'ECONNREFUSED' || err.code === 'ETIMEDOUT' || err.code === 'EPIPE')) return true;
-  return false;
-}
-async function retryRequest(fn, retries = 3, delay = 1000) {
-  let lastErr;
-  for (let i = 0; i < retries; i++) {
-    try {
-      const result = await fn(i);
-      if (result && result.status && shouldRetry(null, result.status)) {
-        if (i < retries - 1) { await sleep(delay * (i + 1)); continue; }
-      }
-      return result;
-    } catch (e) {
-      lastErr = e;
-      if (shouldRetry(e) && i < retries - 1) { await sleep(delay * (i + 1)); continue; }
-      if (i === retries - 1) break;
-      throw e;
-    }
-  }
-  throw lastErr;
-}
-function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
-module.exports = { retryRequest, newSessionId, shouldRetry };

package/src/session.js

@@ -1,18 +0,0 @@
-class StickySession {
-  constructor(client, sessionId, country, city) {
-    this._client = client;
-    this.sessionId = sessionId;
-    this.country = country || client._country;
-    this.city = city || client._city;
-  }
-  fetch(url, opts = {}) {
-    return this._client.fetch(url, {
-      country: opts.country || this.country,
-      city: opts.city || this.city,
-      session: this.sessionId,
-      _noRotate: true,
-      ...opts,
-    });
-  }
-}
-module.exports = { StickySession };

package/src/support.js

@@ -1,61 +0,0 @@
-const https = require('https');
-const { AuthError, QuotaExceeded } = require('./exceptions');
-
-class SupportClient {
-  constructor(apiKey, apiBase) {
-    this.apiKey = apiKey;
-    this.apiBase = apiBase.replace(/\/+$/, '');
-    this.headers = { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' };
-  }
-
-  _request(method, path, body) {
-    return new Promise((resolve, reject) => {
-      const url = new URL(this.apiBase + path);
-      const opts = {
-        hostname: url.hostname, port: url.port || 443, path: url.pathname,
-        method, headers: { ...this.headers }, timeout: 15000,
-        rejectUnauthorized: true,
-      };
-      if (body) {
-        const data = JSON.stringify(body);
-        opts.headers['Content-Length'] = Buffer.byteLength(data);
-      }
-      const req = https.request(opts, res => {
-        let chunks = [];
-        res.on('data', c => chunks.push(c));
-        res.on('end', () => {
-          const text = Buffer.concat(chunks).toString();
-          if (res.statusCode === 401) return reject(new AuthError());
-          if (res.statusCode >= 400) return reject(new Error(`HTTP ${res.statusCode}: ${text}`));
-          try { resolve(JSON.parse(text)); } catch { resolve(text); }
-        });
-      });
-      req.on('error', reject);
-      req.on('timeout', () => { req.destroy(); reject(new Error('Request timeout')); });
-      if (body) req.write(JSON.stringify(body));
-      req.end();
-    });
-  }
-
-  async usage() {
-    const data = await this._request('GET', '/api/support/diagnose');
-    this._checkQuota(data);
-    return data;
-  }
-  status() { return this._request('GET', '/api/support/status'); }
-  ask(question) { return this._request('POST', '/api/support/ask', { question }); }
-  countries() { return this._request('GET', '/api/support/countries'); }
-
-  _checkQuota(data) {
-    try {
-      const used = data.used_gb || 0;
-      const total = used + (data.remaining_gb || 999);
-      if (total > 0) {
-        const pct = used / total * 100;
-        if (pct >= 100) throw new QuotaExceeded();
-        if (pct >= 80) process.stderr.write(`⚠️  IPLoop: ${pct.toFixed(0)}% bandwidth used. Upgrade at https://iploop.io/pricing\n`);
-      }
-    } catch (e) { if (e instanceof QuotaExceeded) throw e; }
-  }
-}
-module.exports = { SupportClient };