iploop 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 IPLoop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,11 @@
 # IPLoop Node.js SDK
 
-Residential proxy SDK — route requests through millions of real devices across 111+ countries.
+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,66 +13,192 @@ npm install iploop
 
 ## Quick Start
 
-```javascript
-const IPLoop = require('iploop');
+```typescript
+import { IPLoopClient } from 'iploop';
 
-const ip = new IPLoop('your-api-key');
+const client = new IPLoopClient({ apiKey: 'your-api-key' });
+const response = await client.get('https://httpbin.org/ip');
+console.log(response.data);
+```
 
-// Fetch any URL through a residential proxy
-const res = await ip.get('https://httpbin.org/ip');
-console.log(res.body);
+## Features
 
-// Target a specific country
-const de = await ip.get('https://example.com', { country: 'DE' });
+- **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
 
-// POST request
-const post = await ip.post('https://api.example.com/data', {
-  body: JSON.stringify({ key: 'value' }),
-  headers: { 'Content-Type': 'application/json' }
+## 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' });
+
+// Target a specific city
+const resp = await client.get('https://example.com', { country: 'US', city: 'miami' });
+```
+
 ## Sticky Sessions
 
-Keep the same IP across multiple requests:
+Keep the same proxy IP across multiple requests:
+
+```typescript
+const session = client.session(undefined, 'US', 'newyork');
 
-```javascript
-const session = ip.session({ country: 'US', city: 'newyork' });
 const page1 = await session.get('https://site.com/page1'); // same IP
 const page2 = await session.get('https://site.com/page2'); // same IP
 ```
 
-## Geo-Targeting
+## HTTP Methods
+
+```typescript
+// GET
+const resp = await client.get('https://httpbin.org/get');
+
+// 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:
 
-```javascript
-const ip = new IPLoop('key', { country: 'JP' }); // All requests through Japan
-// Or per-request:
-const res = await ip.get('https://example.com', { country: 'GB' });
+```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 }, ...]
 ```
 
-## TypeScript
+## 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);
+  }
+}
+```
 
-Full TypeScript support included:
+## Debug Mode
 
 ```typescript
-import IPLoop from 'iploop';
-const ip = new IPLoop('your-api-key', { country: 'US' });
+const client = new IPLoopClient({ apiKey: 'your-key', debug: true });
+// Logs: IPLoop: GET https://example.com → 200 (450ms) country=US session=abc123
 ```
 
-## API
+## Configuration
 
-- `ip.get(url, options?)` — GET request
-- `ip.post(url, options?)` — POST request  
-- `ip.put(url, options?)` — PUT request
-- `ip.delete(url, options?)` — DELETE request
-- `ip.fetch(url, options?)` — Custom request
-- `ip.session(options?)` — Create sticky session
-- `ip.countries()` — List available countries
+| 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 |
 
 ## Links
 
-- Website: [iploop.io](https://iploop.io)
-- Twitter: [@iploop_io](https://x.com/iploop_io)
+- **Website**: [iploop.io](https://iploop.io)
+- **Dashboard**: [iploop.io/dashboard](https://iploop.io/dashboard)
+- **Documentation**: [docs.iploop.io](https://docs.iploop.io)
 
 ## License
 

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: gateway.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,0DAA0D;IAC1D,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 || 'gateway.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://${auth}@${this.proxyHost}:${this.socksPort}`;
+        }
+        return `http://${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,21 +1,53 @@
 {
   "name": "iploop",
-  "version": "1.0.0",
-  "description": "IPLoop Residential Proxy SDK — route requests through millions of real devices",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "keywords": ["proxy", "residential-proxy", "web-scraping", "rotating-proxy", "socks5", "http-proxy", "iploop", "sdk"],
-  "author": "IPLoop <partners@iploop.io>",
+  "version": "1.0.1",
+  "description": "Official Node.js SDK for IPLoop residential proxy service",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts"
+  },
+  "keywords": [
+    "proxy",
+    "residential-proxy",
+    "mobile-proxy",
+    "web-scraping",
+    "iploop",
+    "socks5",
+    "http-proxy"
+  ],
+  "author": "IPLoop <support@iploop.io>",
   "license": "MIT",
-  "homepage": "https://iploop.io",
   "repository": {
     "type": "git",
-    "url": "https://github.com/iploop/iploop-node"
+    "url": "https://github.com/iploop/nodejs-sdk"
+  },
+  "homepage": "https://iploop.io",
+  "bugs": {
+    "url": "https://github.com/iploop/nodejs-sdk/issues"
   },
   "engines": {
-    "node": ">=14"
+    "node": ">=16.0.0"
   },
   "dependencies": {
-    "node-fetch": "^2.7.0"
+    "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/index.d.ts

@@ -1,51 +0,0 @@
-declare class IPLoop {
-  constructor(apiKey: string, options?: {
-    gateway?: string;
-    port?: number;
-    country?: string;
-    city?: string;
-    timeout?: number;
-  });
-
-  fetch(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  get(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  post(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  put(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  delete(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  session(options?: SessionOptions): IPLoopSession;
-  countries(): Promise<string[]>;
-}
-
-interface RequestOptions {
-  method?: string;
-  headers?: Record<string, string>;
-  body?: string | object;
-  country?: string;
-  city?: string;
-  session?: string;
-  timeout?: number;
-}
-
-interface SessionOptions {
-  country?: string;
-  city?: string;
-  session?: string;
-}
-
-interface IPLoopResponse {
-  status: number;
-  statusCode: number;
-  headers: Record<string, string>;
-  body: string;
-  text(): Promise<string>;
-  json(): Promise<any>;
-}
-
-declare class IPLoopSession {
-  fetch(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  get(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-  post(url: string, options?: RequestOptions): Promise<IPLoopResponse>;
-}
-
-export = IPLoop;
-export { IPLoop, IPLoopSession, RequestOptions, SessionOptions, IPLoopResponse };

package/index.js

@@ -1,152 +0,0 @@
-const http = require('http');
-const https = require('https');
-const { URL } = require('url');
-
-class IPLoop {
-  constructor(apiKey, options = {}) {
-    this.apiKey = apiKey;
-    this.gateway = options.gateway || 'gateway.iploop.io';
-    this.port = options.port || 8880;
-    this.country = options.country || null;
-    this.city = options.city || null;
-    this.timeout = options.timeout || 30000;
-  }
-
-  _buildAuth(options = {}) {
-    const parts = [this.apiKey];
-    const country = options.country || this.country;
-    const city = options.city || this.city;
-    const session = options.session || null;
-    
-    if (country) parts.push(`country-${country}`);
-    if (city) parts.push(`city-${city}`);
-    if (session) parts.push(`session-${session}`);
-    
-    return `user:${parts.join('-')}`;
-  }
-
-  fetch(url, options = {}) {
-    return new Promise((resolve, reject) => {
-      const target = new URL(url);
-      const auth = this._buildAuth(options);
-      
-      const proxyOptions = {
-        hostname: this.gateway,
-        port: this.port,
-        path: url,
-        method: options.method || 'GET',
-        headers: {
-          ...this._defaultHeaders(target, options),
-          ...(options.headers || {}),
-          'Proxy-Authorization': 'Basic ' + Buffer.from(auth).toString('base64'),
-          'Host': target.hostname,
-        },
-        timeout: options.timeout || this.timeout,
-      };
-
-      const req = http.request(proxyOptions, (res) => {
-        let data = '';
-        res.on('data', chunk => data += chunk);
-        res.on('end', () => {
-          resolve({
-            status: res.statusCode,
-            statusCode: res.statusCode,
-            headers: res.headers,
-            text: () => Promise.resolve(data),
-            json: () => Promise.resolve(JSON.parse(data)),
-            body: data,
-          });
-        });
-      });
-
-      req.on('error', reject);
-      req.on('timeout', () => {
-        req.destroy();
-        reject(new Error('Request timeout'));
-      });
-
-      if (options.body) {
-        req.write(typeof options.body === 'string' ? options.body : JSON.stringify(options.body));
-      }
-      req.end();
-    });
-  }
-
-  get(url, options = {}) {
-    return this.fetch(url, { ...options, method: 'GET' });
-  }
-
-  post(url, options = {}) {
-    return this.fetch(url, { ...options, method: 'POST' });
-  }
-
-  put(url, options = {}) {
-    return this.fetch(url, { ...options, method: 'PUT' });
-  }
-
-  delete(url, options = {}) {
-    return this.fetch(url, { ...options, method: 'DELETE' });
-  }
-
-  session(options = {}) {
-    const sessionId = options.session || `sess-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    return new IPLoopSession(this, { ...options, session: sessionId });
-  }
-
-  _defaultHeaders(target, options = {}) {
-    const country = options.country || this.country || 'US';
-    const langs = {
-      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',
-      IL: 'he-IL,he;q=0.9,en;q=0.8',
-    };
-
-    return {
-      'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36',
-      'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
-      'Accept-Language': langs[country] || langs.US,
-      'Accept-Encoding': 'gzip, deflate, br',
-      'Cache-Control': 'no-cache',
-      'Sec-Fetch-Dest': 'document',
-      'Sec-Fetch-Mode': 'navigate',
-      'Sec-Fetch-Site': 'none',
-      'Sec-Ch-Ua': '"Chromium";v="122", "Not(A:Brand";v="24"',
-      'Sec-Ch-Ua-Mobile': '?0',
-      'Sec-Ch-Ua-Platform': '"Windows"',
-      'Upgrade-Insecure-Requests': '1',
-    };
-  }
-
-  async countries() {
-    return ['US', 'GB', 'DE', 'FR', 'JP', 'BR', 'IN', 'AU', 'CA', 'IL', 
-            'KR', 'SG', 'NL', 'SE', 'CH', 'ES', 'IT', 'PL', 'TR', 'ZA',
-            'NG', 'PH', 'MX', 'AR', 'CL', 'CO', 'EG', 'KE', 'TH', 'VN'];
-  }
-}
-
-class IPLoopSession {
-  constructor(client, options) {
-    this.client = client;
-    this.options = options;
-  }
-
-  fetch(url, options = {}) {
-    return this.client.fetch(url, { ...this.options, ...options });
-  }
-
-  get(url, options = {}) {
-    return this.fetch(url, { ...options, method: 'GET' });
-  }
-
-  post(url, options = {}) {
-    return this.fetch(url, { ...options, method: 'POST' });
-  }
-}
-
-module.exports = IPLoop;
-module.exports.IPLoop = IPLoop;
-module.exports.default = IPLoop;