nlcurl 0.1.0

package/dist/http/pool.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Connection pool.
+ *
+ * Manages TLS connections keyed by origin, supporting both HTTP/1.1
+ * keep-alive and HTTP/2 multiplexing.  Handles connection reuse,
+ * eviction, and idle timeout.
+ */
+import type { TLSSocket } from '../tls/types.js';
+import { H2Client } from './h2/client.js';
+import type { H2Profile } from '../fingerprints/types.js';
+export interface PoolEntry {
+    origin: string;
+    socket: TLSSocket;
+    protocol: 'h1' | 'h2';
+    h2Client?: H2Client;
+    createdAt: number;
+    lastUsed: number;
+    busy: boolean;
+}
+export interface PoolOptions {
+    /** Maximum connections per origin. */
+    maxConnectionsPerOrigin?: number;
+    /** Maximum total connections across all origins. */
+    maxTotalConnections?: number;
+    /** Connection idle timeout in milliseconds. */
+    idleTimeout?: number;
+    /** Connection max age in milliseconds. */
+    maxAge?: number;
+}
+export declare class ConnectionPool {
+    private readonly options;
+    private readonly connections;
+    private totalConnections;
+    private cleanupTimer;
+    constructor(options?: PoolOptions);
+    /**
+     * Get an existing idle connection for the given origin.
+     *
+     * Returns undefined if no reusable connection is available.
+     */
+    get(origin: string): PoolEntry | undefined;
+    /**
+     * Add a new connection to the pool.
+     */
+    put(origin: string, socket: TLSSocket, protocol: 'h1' | 'h2', h2Profile?: H2Profile, defaultHeaders?: Array<[string, string]>): PoolEntry;
+    /**
+     * Release an H1 connection back to the pool.
+     */
+    release(entry: PoolEntry): void;
+    /**
+     * Remove a specific connection from the pool.
+     */
+    remove(entry: PoolEntry): void;
+    /**
+     * Close all connections and stop the cleanup timer.
+     */
+    close(): void;
+    get size(): number;
+    private isExpired;
+    private evictIdle;
+    private evictOldest;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/http/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/http/pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAA6C;gBAErD,OAAO,GAAE,WAAgB;IASrC;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAwB1C;;OAEG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,EACrB,SAAS,CAAC,EAAE,SAAS,EACrB,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,SAAS;IAyCZ;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK/B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAe9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAID,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,WAAW;CAiBpB"}

package/dist/http/pool.js

@@ -0,0 +1,177 @@
+/**
+ * Connection pool.
+ *
+ * Manages TLS connections keyed by origin, supporting both HTTP/1.1
+ * keep-alive and HTTP/2 multiplexing.  Handles connection reuse,
+ * eviction, and idle timeout.
+ */
+import { H2Client } from './h2/client.js';
+const DEFAULT_POOL_OPTIONS = {
+    maxConnectionsPerOrigin: 6,
+    maxTotalConnections: 64,
+    idleTimeout: 60_000,
+    maxAge: 300_000,
+};
+export class ConnectionPool {
+    options;
+    connections = new Map();
+    totalConnections = 0;
+    cleanupTimer;
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_POOL_OPTIONS, ...options };
+        // Periodic cleanup
+        this.cleanupTimer = setInterval(() => this.evictIdle(), 30_000);
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    /**
+     * Get an existing idle connection for the given origin.
+     *
+     * Returns undefined if no reusable connection is available.
+     */
+    get(origin) {
+        const entries = this.connections.get(origin);
+        if (!entries)
+            return undefined;
+        const now = Date.now();
+        for (const entry of entries) {
+            // H2 connections can be multiplexed (always reusable)
+            if (entry.protocol === 'h2' && !this.isExpired(entry, now)) {
+                entry.lastUsed = now;
+                return entry;
+            }
+            // H1 connections must be idle
+            if (entry.protocol === 'h1' && !entry.busy && !this.isExpired(entry, now)) {
+                entry.busy = true;
+                entry.lastUsed = now;
+                return entry;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Add a new connection to the pool.
+     */
+    put(origin, socket, protocol, h2Profile, defaultHeaders) {
+        // Evict if at capacity
+        if (this.totalConnections >= this.options.maxTotalConnections) {
+            this.evictOldest();
+            // If eviction failed (all busy), allow temporary over-capacity
+        }
+        const entry = {
+            origin,
+            socket,
+            protocol,
+            createdAt: Date.now(),
+            lastUsed: Date.now(),
+            busy: protocol === 'h1',
+        };
+        if (protocol === 'h2') {
+            entry.h2Client = new H2Client(socket, h2Profile, defaultHeaders);
+        }
+        let entries = this.connections.get(origin);
+        if (!entries) {
+            entries = [];
+            this.connections.set(origin, entries);
+        }
+        // Check per-origin limit
+        while (entries.length >= this.options.maxConnectionsPerOrigin) {
+            const evicted = entries.shift();
+            if (evicted) {
+                evicted.socket.destroyTLS();
+                this.totalConnections--;
+            }
+        }
+        entries.push(entry);
+        this.totalConnections++;
+        return entry;
+    }
+    /**
+     * Release an H1 connection back to the pool.
+     */
+    release(entry) {
+        entry.busy = false;
+        entry.lastUsed = Date.now();
+    }
+    /**
+     * Remove a specific connection from the pool.
+     */
+    remove(entry) {
+        const entries = this.connections.get(entry.origin);
+        if (entries) {
+            const idx = entries.indexOf(entry);
+            if (idx >= 0) {
+                entries.splice(idx, 1);
+                this.totalConnections--;
+            }
+            if (entries.length === 0) {
+                this.connections.delete(entry.origin);
+            }
+        }
+        entry.socket.destroyTLS();
+    }
+    /**
+     * Close all connections and stop the cleanup timer.
+     */
+    close() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        for (const [, entries] of this.connections) {
+            for (const entry of entries) {
+                if (entry.h2Client)
+                    entry.h2Client.destroy();
+                entry.socket.destroyTLS();
+            }
+        }
+        this.connections.clear();
+        this.totalConnections = 0;
+    }
+    get size() {
+        return this.totalConnections;
+    }
+    // ---- Internal ----
+    isExpired(entry, now) {
+        if (now - entry.createdAt > this.options.maxAge)
+            return true;
+        if (now - entry.lastUsed > this.options.idleTimeout)
+            return true;
+        return false;
+    }
+    evictIdle() {
+        const now = Date.now();
+        for (const [origin, entries] of this.connections) {
+            for (let i = entries.length - 1; i >= 0; i--) {
+                const entry = entries[i];
+                if (this.isExpired(entry, now) && !entry.busy) {
+                    entries.splice(i, 1);
+                    this.totalConnections--;
+                    if (entry.h2Client)
+                        entry.h2Client.destroy();
+                    entry.socket.destroyTLS();
+                }
+            }
+            if (entries.length === 0) {
+                this.connections.delete(origin);
+            }
+        }
+    }
+    evictOldest() {
+        let oldest;
+        for (const [origin, entries] of this.connections) {
+            for (const entry of entries) {
+                if (!entry.busy) {
+                    if (!oldest || entry.lastUsed < oldest.entry.lastUsed) {
+                        oldest = { entry, origin };
+                    }
+                }
+            }
+        }
+        if (oldest) {
+            this.remove(oldest.entry);
+        }
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/http/pool.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * NLcURL -- Pure TypeScript HTTP client with browser fingerprint impersonation.
+ *
+ * Zero runtime dependencies. Uses Node.js built-in modules exclusively.
+ *
+ * @module nlcurl
+ */
+export type { HttpMethod, NLcURLRequest, NLcURLSessionConfig, RequestBody, RequestTimings, RetryConfig, TimeoutConfig, } from './core/request.js';
+export { NLcURLResponse } from './core/response.js';
+export type { ResponseMeta } from './core/response.js';
+export { NLcURLError, TLSError, HTTPError, TimeoutError, ProxyError, AbortError, ConnectionError, ProtocolError, } from './core/errors.js';
+export { NLcURLSession, type RequestOptions } from './core/session.js';
+export { createSession, request, get, post, put, patch, del, head, } from './core/client.js';
+export { getProfile, listProfiles, DEFAULT_PROFILE, } from './fingerprints/database.js';
+export type { BrowserProfile, TLSProfile, H2Profile, HeaderProfile, } from './fingerprints/types.js';
+export type { RequestInterceptor, ResponseInterceptor, } from './middleware/interceptor.js';
+export type { RateLimitConfig } from './middleware/rate-limiter.js';
+export { CookieJar } from './cookies/jar.js';
+export { WebSocketClient, type WebSocketOptions, type WebSocketEvents } from './ws/client.js';
+export { ja3Hash, ja3String } from './fingerprints/ja3.js';
+export { akamaiFingerprint } from './fingerprints/akamai.js';
+//# 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;;;;;;GAMG;AAGH,YAAY,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG9F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * NLcURL -- Pure TypeScript HTTP client with browser fingerprint impersonation.
+ *
+ * Zero runtime dependencies. Uses Node.js built-in modules exclusively.
+ *
+ * @module nlcurl
+ */
+export { NLcURLResponse } from './core/response.js';
+// ---- Error types ----
+export { NLcURLError, TLSError, HTTPError, TimeoutError, ProxyError, AbortError, ConnectionError, ProtocolError, } from './core/errors.js';
+// ---- Session and client ----
+export { NLcURLSession } from './core/session.js';
+export { createSession, request, get, post, put, patch, del, head, } from './core/client.js';
+// ---- Fingerprints ----
+export { getProfile, listProfiles, DEFAULT_PROFILE, } from './fingerprints/database.js';
+// ---- Cookies ----
+export { CookieJar } from './cookies/jar.js';
+// ---- WebSocket ----
+export { WebSocketClient } from './ws/client.js';
+// ---- Utilities ----
+export { ja3Hash, ja3String } from './fingerprints/ja3.js';
+export { akamaiFingerprint } from './fingerprints/akamai.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,wBAAwB;AACxB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,+BAA+B;AAC/B,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,kBAAkB,CAAC;AAE1B,yBAAyB;AACzB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAiBpC,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAA+C,MAAM,gBAAgB,CAAC;AAE9F,sBAAsB;AACtB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/middleware/interceptor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Request/response interceptor middleware.
+ */
+import type { NLcURLRequest } from '../core/request.js';
+import { NLcURLResponse } from '../core/response.js';
+/**
+ * A function that can modify a request before it is sent.
+ */
+export type RequestInterceptor = (request: NLcURLRequest) => NLcURLRequest | Promise<NLcURLRequest>;
+/**
+ * A function that can modify or inspect a response after it is received.
+ */
+export type ResponseInterceptor = (response: NLcURLResponse) => NLcURLResponse | Promise<NLcURLResponse>;
+/**
+ * Middleware chain.
+ *
+ * Interceptors are executed in FIFO order.
+ */
+export declare class InterceptorChain {
+    private readonly requestInterceptors;
+    private readonly responseInterceptors;
+    addRequestInterceptor(fn: RequestInterceptor): this;
+    addResponseInterceptor(fn: ResponseInterceptor): this;
+    processRequest(request: NLcURLRequest): Promise<NLcURLRequest>;
+    processResponse(response: NLcURLResponse): Promise<NLcURLResponse>;
+}
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/middleware/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,aAAa,KACnB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,cAAc,KACrB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAKnD,sBAAsB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAK/C,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ9D,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAOzE"}

package/dist/middleware/interceptor.js

@@ -0,0 +1,35 @@
+/**
+ * Request/response interceptor middleware.
+ */
+/**
+ * Middleware chain.
+ *
+ * Interceptors are executed in FIFO order.
+ */
+export class InterceptorChain {
+    requestInterceptors = [];
+    responseInterceptors = [];
+    addRequestInterceptor(fn) {
+        this.requestInterceptors.push(fn);
+        return this;
+    }
+    addResponseInterceptor(fn) {
+        this.responseInterceptors.push(fn);
+        return this;
+    }
+    async processRequest(request) {
+        let req = request;
+        for (const fn of this.requestInterceptors) {
+            req = await fn(req);
+        }
+        return req;
+    }
+    async processResponse(response) {
+        let resp = response;
+        for (const fn of this.responseInterceptors) {
+            resp = await fn(resp);
+        }
+        return resp;
+    }
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/middleware/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACV,mBAAmB,GAAyB,EAAE,CAAC;IAC/C,oBAAoB,GAA0B,EAAE,CAAC;IAElE,qBAAqB,CAAC,EAAsB;QAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB,CAAC,EAAuB;QAC5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAsB;QACzC,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1C,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAwB;QAC5C,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3C,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/middleware/rate-limiter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Rate limiter middleware.
+ *
+ * Token-bucket rate limiter for controlling request frequency.
+ */
+export interface RateLimitConfig {
+    /** Maximum requests per window. */
+    maxRequests: number;
+    /** Window duration in milliseconds. */
+    windowMs: number;
+}
+export declare class RateLimiter {
+    private readonly maxRequests;
+    private readonly windowMs;
+    private tokens;
+    private lastRefill;
+    private waitQueue;
+    constructor(config: RateLimitConfig);
+    /**
+     * Wait until a request token is available.
+     */
+    acquire(): Promise<void>;
+    private drain;
+    private refill;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/middleware/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAyB;gBAE9B,MAAM,EAAE,eAAe;IAOnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B,OAAO,CAAC,KAAK;IAgBb,OAAO,CAAC,MAAM;CAQf"}

package/dist/middleware/rate-limiter.js

@@ -0,0 +1,59 @@
+/**
+ * Rate limiter middleware.
+ *
+ * Token-bucket rate limiter for controlling request frequency.
+ */
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    tokens;
+    lastRefill;
+    waitQueue = [];
+    constructor(config) {
+        this.maxRequests = config.maxRequests;
+        this.windowMs = config.windowMs;
+        this.tokens = config.maxRequests;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * Wait until a request token is available.
+     */
+    async acquire() {
+        this.refill();
+        if (this.tokens > 0) {
+            this.tokens--;
+            return;
+        }
+        // Enqueue and wait for a token to become available
+        await new Promise((resolve) => {
+            this.waitQueue.push(resolve);
+            // Schedule a refill check after the current window expires
+            const elapsed = Date.now() - this.lastRefill;
+            const waitMs = Math.max(1, this.windowMs - elapsed);
+            setTimeout(() => this.drain(), waitMs);
+        });
+    }
+    drain() {
+        this.refill();
+        while (this.tokens > 0 && this.waitQueue.length > 0) {
+            this.tokens--;
+            const next = this.waitQueue.shift();
+            next();
+        }
+        // If there are still waiters, schedule another drain
+        if (this.waitQueue.length > 0) {
+            const elapsed = Date.now() - this.lastRefill;
+            const waitMs = Math.max(1, this.windowMs - elapsed);
+            setTimeout(() => this.drain(), waitMs);
+        }
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        if (elapsed >= this.windowMs) {
+            this.tokens = this.maxRequests;
+            this.lastRefill = now;
+        }
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/middleware/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,OAAO,WAAW;IACL,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,GAAsB,EAAE,CAAC;IAE1C,YAAY,MAAuB;QACjC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,mDAAmD;QACnD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,2DAA2D;YAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACrC,IAAI,EAAE,CAAC;QACT,CAAC;QAED,qDAAqD;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/middleware/retry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Retry middleware.
+ *
+ * Implements configurable retry logic with exponential backoff.
+ */
+import type { RetryConfig } from '../core/request.js';
+import { NLcURLResponse } from '../core/response.js';
+export interface RetryContext {
+    attempt: number;
+    lastError?: Error;
+    lastResponse?: NLcURLResponse;
+}
+/**
+ * Execute a request function with retry logic.
+ */
+export declare function withRetry(config: RetryConfig | undefined, execute: (ctx: RetryContext) => Promise<NLcURLResponse>): Promise<NLcURLResponse>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/middleware/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/middleware/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAQD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,GACtD,OAAO,CAAC,cAAc,CAAC,CAgDzB"}

package/dist/middleware/retry.js

@@ -0,0 +1,64 @@
+/**
+ * Retry middleware.
+ *
+ * Implements configurable retry logic with exponential backoff.
+ */
+import { AbortError, TimeoutError, ConnectionError } from '../core/errors.js';
+function shouldRetryDefault(error, statusCode) {
+    if (error instanceof ConnectionError || error instanceof TimeoutError)
+        return true;
+    if (statusCode !== undefined && [429, 500, 502, 503, 504].includes(statusCode))
+        return true;
+    return false;
+}
+/**
+ * Execute a request function with retry logic.
+ */
+export async function withRetry(config, execute) {
+    const count = config?.count ?? 3;
+    const baseDelay = config?.delay ?? 1000;
+    const backoff = config?.backoff ?? 'exponential';
+    const jitterMax = config?.jitter ?? 200;
+    const retryOn = config?.retryOn ?? shouldRetryDefault;
+    let lastError;
+    let lastResponse;
+    for (let attempt = 0; attempt <= count; attempt++) {
+        // Wait before retry (skip first attempt)
+        if (attempt > 0) {
+            const factor = backoff === 'exponential'
+                ? Math.pow(2, attempt - 1)
+                : attempt;
+            const delay = baseDelay * factor;
+            const jitter = Math.random() * jitterMax;
+            await sleep(delay + jitter);
+        }
+        try {
+            const response = await execute({ attempt, lastError, lastResponse });
+            // Check if response status warrants retry
+            if (attempt < count && retryOn(null, response.status)) {
+                lastResponse = response;
+                continue;
+            }
+            return response;
+        }
+        catch (err) {
+            // Never retry aborted requests
+            if (err instanceof AbortError)
+                throw err;
+            const error = err instanceof Error ? err : new Error(String(err));
+            if (attempt < count && retryOn(error)) {
+                lastError = error;
+                continue;
+            }
+            throw err;
+        }
+    }
+    // Should not reach here, but if it does, throw the last error
+    if (lastError)
+        throw lastError;
+    return lastResponse;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/middleware/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/middleware/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQ9E,SAAS,kBAAkB,CAAC,KAAmB,EAAE,UAAmB;IAClE,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,YAAY;QAAE,OAAO,IAAI,CAAC;IACnF,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5F,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA+B,EAC/B,OAAuD;IAEvD,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,aAAa,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,kBAAkB,CAAC;IAEtD,IAAI,SAA4B,CAAC;IACjC,IAAI,YAAwC,CAAC;IAE7C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QAClD,yCAAyC;QACzC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,OAAO,KAAK,aAAa;gBACtC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;gBAC1B,CAAC,CAAC,OAAO,CAAC;YACZ,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;YACzC,MAAM,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YAErE,0CAA0C;YAC1C,IAAI,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,YAAY,GAAG,QAAQ,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,+BAA+B;YAC/B,IAAI,GAAG,YAAY,UAAU;gBAAE,MAAM,GAAG,CAAC;YAEzC,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtC,SAAS,GAAG,KAAK,CAAC;gBAClB,SAAS;YACX,CAAC;YAED,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,SAAS;QAAE,MAAM,SAAS,CAAC;IAC/B,OAAO,YAAa,CAAC;AACvB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/proxy/http-proxy.d.ts

@@ -0,0 +1,23 @@
+/**
+ * HTTP CONNECT proxy tunneling.
+ *
+ * Establishes a TCP tunnel through an HTTP proxy using the CONNECT
+ * method, then returns the raw socket for TLS negotiation.
+ */
+import * as net from 'node:net';
+export interface HttpProxyOptions {
+    host: string;
+    port: number;
+    /** Proxy authentication (user:pass). */
+    auth?: string;
+    /** Timeout in milliseconds. */
+    timeout?: number;
+}
+/**
+ * Connect to a target host:port through an HTTP CONNECT proxy.
+ *
+ * Returns a raw TCP socket with the tunnel established, ready for
+ * TLS handshake.
+ */
+export declare function httpProxyConnect(proxy: HttpProxyOptions, targetHost: string, targetPort: number): Promise<net.Socket>;
+//# sourceMappingURL=http-proxy.d.ts.map

package/dist/proxy/http-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/http-proxy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAwFrB"}