nlcurl 0.7.0 → 0.9.0

package/dist/middleware/retry-after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.js","sourceRoot":"","sources":["../../src/middleware/retry-after.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO,OAAO,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/middleware/retry.d.ts

@@ -1,31 +1,22 @@
 import type { RetryConfig } from "../core/request.js";
 import { NLcURLResponse } from "../core/response.js";
 import { type Logger } from "../utils/logger.js";
-/**
- * Carries context about the current retry attempt that is passed to the
- * `execute` callback on each invocation.
- *
- * @typedef  {Object}          RetryContext
- * @property {number}          attempt       - Zero-based attempt index (0 = first try).
- * @property {Error}           [lastError]   - The error thrown by the previous attempt, if any.
- * @property {NLcURLResponse}  [lastResponse] - The response from the previous attempt, if any.
- */
+/** Context passed to each retry attempt. */
 export interface RetryContext {
+    /** Current attempt number (1-based). */
     attempt: number;
+    /** Error from the previous attempt, if any. */
     lastError?: Error;
+    /** Response from the previous attempt, if any. */
     lastResponse?: NLcURLResponse;
 }
 /**
- * Executes `execute` up to `config.count + 1` times with configurable
- * back-off and jitter between attempts. Transparent to `AbortError` -- those
- * propagate immediately without retry.
+ * Execute a request function with configurable retry logic.
  *
- * @param {RetryConfig | undefined} config  - Retry parameters; `undefined` uses library defaults.
- * @param {(ctx: RetryContext) => Promise<NLcURLResponse>} execute - The operation to attempt.
- * @param {Logger} [logger] - Optional logger for retry diagnostics.
- * @returns {Promise<NLcURLResponse>} The first successful response.
- * @throws {AbortError}  Immediately if the operation is aborted.
- * @throws {Error}       Re-throws the last error if all attempts are exhausted.
+ * @param {RetryConfig|undefined} config - Retry configuration.
+ * @param {(ctx: RetryContext) => Promise<NLcURLResponse>} execute - Function that performs the request attempt.
+ * @param {Logger} [logger] - Optional logger for retry events.
+ * @returns {Promise<NLcURLResponse>} Final HTTP response after all retries.
  */
 export declare function withRetry(config: RetryConfig | undefined, execute: (ctx: RetryContext) => Promise<NLcURLResponse>, logger?: Logger): Promise<NLcURLResponse>;
 //# sourceMappingURL=retry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/middleware/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,oBAAoB,CAAC;AAInE;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AASD;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA4ClK"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/middleware/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,oBAAoB,CAAC;AAKnE,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AASD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAkDlK"}

package/dist/middleware/retry.js

@@ -1,5 +1,6 @@
 import { AbortError, TLSError, TimeoutError, ConnectionError, ProtocolError } from "../core/errors.js";
 import { getDefaultLogger } from "../utils/logger.js";
+import { getRetryAfterMs } from "./retry-after.js";
 const RETRYABLE_H2_ERROR_CODES = new Set([1, 2, 7, 8, 11, 13]);
 function shouldRetryDefault(error, statusCode) {
     if (error instanceof ConnectionError || error instanceof TimeoutError || error instanceof TLSError)
@@ -11,16 +12,12 @@ function shouldRetryDefault(error, statusCode) {
     return false;
 }
 /**
- * Executes `execute` up to `config.count + 1` times with configurable
- * back-off and jitter between attempts. Transparent to `AbortError` -- those
- * propagate immediately without retry.
+ * Execute a request function with configurable retry logic.
  *
- * @param {RetryConfig | undefined} config  - Retry parameters; `undefined` uses library defaults.
- * @param {(ctx: RetryContext) => Promise<NLcURLResponse>} execute - The operation to attempt.
- * @param {Logger} [logger] - Optional logger for retry diagnostics.
- * @returns {Promise<NLcURLResponse>} The first successful response.
- * @throws {AbortError}  Immediately if the operation is aborted.
- * @throws {Error}       Re-throws the last error if all attempts are exhausted.
+ * @param {RetryConfig|undefined} config - Retry configuration.
+ * @param {(ctx: RetryContext) => Promise<NLcURLResponse>} execute - Function that performs the request attempt.
+ * @param {Logger} [logger] - Optional logger for retry events.
+ * @returns {Promise<NLcURLResponse>} Final HTTP response after all retries.
  */
 export async function withRetry(config, execute, logger) {
     const log = logger ?? getDefaultLogger();
@@ -42,6 +39,12 @@ export async function withRetry(config, execute, logger) {
         try {
             const response = await execute({ attempt, lastError, lastResponse });
             if (attempt < count && retryOn(null, response.status)) {
+                const retryAfterMs = getRetryAfterMs(response.headers);
+                if (retryAfterMs !== undefined && retryAfterMs > 0) {
+                    const cappedDelay = Math.min(retryAfterMs, 300_000);
+                    log.debug(`retry respecting Retry-After: ${Math.round(cappedDelay)}ms`);
+                    await sleep(cappedDelay);
+                }
                 lastResponse = response;
                 continue;
             }

package/dist/middleware/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/middleware/retry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAe,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAiB/D,SAAS,kBAAkB,CAAC,KAAmB,EAAE,UAAmB;IAClE,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChH,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAClI,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;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA+B,EAAE,OAAuD,EAAE,MAAe;IACvI,MAAM,GAAG,GAAG,MAAM,IAAI,gBAAgB,EAAE,CAAC;IACzC,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,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5F,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,iBAAiB,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACrF,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,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,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,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"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/middleware/retry.ts"],"names":[],"mappings":"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"}

package/dist/proxy/auth.d.ts

@@ -0,0 +1,73 @@
+/** Supported proxy authentication scheme identifiers. */
+export type ProxyAuthScheme = "basic" | "digest" | "negotiate" | "ntlm";
+/** Credentials and scheme selection for proxy authentication. */
+export interface ProxyAuthConfig {
+    /** Proxy account username. */
+    username: string;
+    /** Proxy account password. */
+    password: string;
+    /** Authentication scheme to use — defaults to `"basic"`. */
+    scheme?: ProxyAuthScheme;
+}
+/** Parsed parameters from an HTTP Digest authentication challenge. */
+export interface DigestChallenge {
+    /** Protection realm name. */
+    realm: string;
+    /** Server-generated nonce value. */
+    nonce: string;
+    /** Quality-of-protection directive (e.g. `"auth"`). */
+    qop?: string;
+    /** Opaque value to be returned unchanged to the server. */
+    opaque?: string;
+    /** Hash algorithm name (e.g. `"MD5"`, `"SHA-256"`). */
+    algorithm?: string;
+    /** Whether the previous nonce has gone stale. */
+    stale?: boolean;
+    /** Space-delimited list of URIs defining the protection space. */
+    domain?: string;
+}
+/**
+ * Parse a `Proxy-Authenticate` response header into its scheme and raw challenge.
+ *
+ * @param {string} header - Raw header value.
+ * @returns {object|null} Parsed scheme and challenge string, or `null` if unrecognized.
+ */
+export declare function parseProxyAuthenticate(header: string): {
+    scheme: ProxyAuthScheme;
+    challenge: string;
+} | null;
+/**
+ * Parse a raw Digest challenge string into structured parameters.
+ *
+ * @param {string} challenge - The challenge portion after `Digest `.
+ * @returns {DigestChallenge|null} Parsed {@link DigestChallenge}, or `null` if required fields are missing.
+ */
+export declare function parseDigestChallenge(challenge: string): DigestChallenge | null;
+/**
+ * Build an HTTP Digest `Proxy-Authorization` header value.
+ *
+ * @param {string} method - HTTP method (e.g. `"CONNECT"`).
+ * @param {string} uri - Request URI.
+ * @param {ProxyAuthConfig} auth - Proxy credentials.
+ * @param {DigestChallenge} challenge - Parsed digest challenge from the proxy.
+ * @returns {string} Fully-formed `Digest` authorization header value.
+ */
+export declare function buildDigestAuth(method: string, uri: string, auth: ProxyAuthConfig, challenge: DigestChallenge): string;
+/**
+ * Build an HTTP Basic `Proxy-Authorization` header value.
+ *
+ * @param {ProxyAuthConfig} auth - Proxy credentials.
+ * @returns {string} Base64-encoded `Basic` authorization header value.
+ */
+export declare function buildBasicProxyAuth(auth: ProxyAuthConfig): string;
+/**
+ * Build a `Proxy-Authorization` header for the configured scheme.
+ *
+ * @param {string} method - HTTP method.
+ * @param {string} uri - Request URI.
+ * @param {ProxyAuthConfig} auth - Proxy credentials and scheme preference.
+ * @param {string} [proxyAuthHeader] - Optional raw `Proxy-Authenticate` header for digest negotiation.
+ * @returns {string|null} Header value string, or `null` if the scheme cannot be satisfied.
+ */
+export declare function buildProxyAuthorization(method: string, uri: string, auth: ProxyAuthConfig, proxyAuthHeader?: string): string | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/proxy/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/proxy/auth.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAExE,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAiBP;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAoB9E;AAID;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAiCtH;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAGjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBnI"}

package/dist/proxy/auth.js

@@ -0,0 +1,129 @@
+import { createHash, randomBytes } from "node:crypto";
+/**
+ * Parse a `Proxy-Authenticate` response header into its scheme and raw challenge.
+ *
+ * @param {string} header - Raw header value.
+ * @returns {object|null} Parsed scheme and challenge string, or `null` if unrecognized.
+ */
+export function parseProxyAuthenticate(header) {
+    if (!header)
+        return null;
+    const lower = header.trimStart().toLowerCase();
+    if (lower.startsWith("digest ")) {
+        return { scheme: "digest", challenge: header.substring(7) };
+    }
+    if (lower.startsWith("negotiate")) {
+        return { scheme: "negotiate", challenge: header.substring(10).trim() };
+    }
+    if (lower.startsWith("ntlm")) {
+        return { scheme: "ntlm", challenge: header.substring(5).trim() };
+    }
+    if (lower.startsWith("basic ")) {
+        return { scheme: "basic", challenge: header.substring(6) };
+    }
+    return null;
+}
+/**
+ * Parse a raw Digest challenge string into structured parameters.
+ *
+ * @param {string} challenge - The challenge portion after `Digest `.
+ * @returns {DigestChallenge|null} Parsed {@link DigestChallenge}, or `null` if required fields are missing.
+ */
+export function parseDigestChallenge(challenge) {
+    const params = {};
+    const regex = /(\w+)=(?:"([^"]*)"|([\w.]+))/g;
+    let match;
+    while ((match = regex.exec(challenge)) !== null) {
+        params[match[1].toLowerCase()] = match[2] ?? match[3] ?? "";
+    }
+    if (!params["realm"] || !params["nonce"])
+        return null;
+    return {
+        realm: params["realm"],
+        nonce: params["nonce"],
+        qop: params["qop"],
+        opaque: params["opaque"],
+        algorithm: params["algorithm"],
+        stale: params["stale"]?.toLowerCase() === "true",
+        domain: params["domain"],
+    };
+}
+const nonceCounters = new Map();
+/**
+ * Build an HTTP Digest `Proxy-Authorization` header value.
+ *
+ * @param {string} method - HTTP method (e.g. `"CONNECT"`).
+ * @param {string} uri - Request URI.
+ * @param {ProxyAuthConfig} auth - Proxy credentials.
+ * @param {DigestChallenge} challenge - Parsed digest challenge from the proxy.
+ * @returns {string} Fully-formed `Digest` authorization header value.
+ */
+export function buildDigestAuth(method, uri, auth, challenge) {
+    const algorithm = (challenge.algorithm ?? "MD5").toUpperCase();
+    const hashFn = algorithm === "SHA-256" ? "sha256" : "md5";
+    const ha1 = md(hashFn, `${auth.username}:${challenge.realm}:${auth.password}`);
+    const ha2 = md(hashFn, `${method}:${uri}`);
+    const count = (nonceCounters.get(challenge.nonce) ?? 0) + 1;
+    nonceCounters.set(challenge.nonce, count);
+    const nc = count.toString(16).padStart(8, "0");
+    const cnonce = randomBytes(16).toString("hex");
+    let response;
+    if (challenge.qop) {
+        const qop = challenge.qop.includes("auth") ? "auth" : challenge.qop;
+        response = md(hashFn, `${ha1}:${challenge.nonce}:${nc}:${cnonce}:${qop}:${ha2}`);
+        let header = `Digest username="${auth.username}", realm="${challenge.realm}", `;
+        header += `nonce="${challenge.nonce}", uri="${uri}", `;
+        header += `algorithm=${algorithm}, qop=${qop}, nc=${nc}, cnonce="${cnonce}", `;
+        header += `response="${response}"`;
+        if (challenge.opaque)
+            header += `, opaque="${challenge.opaque}"`;
+        return header;
+    }
+    response = md(hashFn, `${ha1}:${challenge.nonce}:${ha2}`);
+    let header = `Digest username="${auth.username}", realm="${challenge.realm}", `;
+    header += `nonce="${challenge.nonce}", uri="${uri}", `;
+    header += `algorithm=${algorithm}, response="${response}"`;
+    if (challenge.opaque)
+        header += `, opaque="${challenge.opaque}"`;
+    return header;
+}
+/**
+ * Build an HTTP Basic `Proxy-Authorization` header value.
+ *
+ * @param {ProxyAuthConfig} auth - Proxy credentials.
+ * @returns {string} Base64-encoded `Basic` authorization header value.
+ */
+export function buildBasicProxyAuth(auth) {
+    const encoded = Buffer.from(`${auth.username}:${auth.password}`).toString("base64");
+    return `Basic ${encoded}`;
+}
+/**
+ * Build a `Proxy-Authorization` header for the configured scheme.
+ *
+ * @param {string} method - HTTP method.
+ * @param {string} uri - Request URI.
+ * @param {ProxyAuthConfig} auth - Proxy credentials and scheme preference.
+ * @param {string} [proxyAuthHeader] - Optional raw `Proxy-Authenticate` header for digest negotiation.
+ * @returns {string|null} Header value string, or `null` if the scheme cannot be satisfied.
+ */
+export function buildProxyAuthorization(method, uri, auth, proxyAuthHeader) {
+    const scheme = auth.scheme ?? "basic";
+    if (scheme === "basic") {
+        return buildBasicProxyAuth(auth);
+    }
+    if (scheme === "digest" && proxyAuthHeader) {
+        const parsed = parseProxyAuthenticate(proxyAuthHeader);
+        if (parsed?.scheme === "digest") {
+            const challenge = parseDigestChallenge(parsed.challenge);
+            if (challenge) {
+                return buildDigestAuth(method, uri, auth, challenge);
+            }
+        }
+        return null;
+    }
+    return null;
+}
+function md(algorithm, data) {
+    return createHash(algorithm).update(data).digest("hex");
+}
+//# sourceMappingURL=auth.js.map

package/dist/proxy/auth.js.map

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

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

@@ -1,21 +1,11 @@
 /**
- * Resolves proxy configuration from standard environment variables
- * (`HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` and their lowercase variants).
- * Follows the same conventions as curl, got, axios, and undici.
- */
-/**
- * Resolves a proxy URL from environment variables for the given request URL.
- * Returns `undefined` if no proxy should be used (either not configured or
- * the host is in the `NO_PROXY` bypass list).
+ * Resolve a proxy URL from standard environment variables.
  *
- * Precedence (same as curl):
- * 1. `no_proxy` / `NO_PROXY` to skip proxy for matching hosts.
- * 2. `https_proxy` / `HTTPS_PROXY` for HTTPS URLs.
- * 3. `http_proxy` / `HTTP_PROXY` for HTTP URLs.
- * 4. `all_proxy` / `ALL_PROXY` as a fallback for either protocol.
+ * Checks `NO_PROXY` / `no_proxy` first, then selects `HTTPS_PROXY` or
+ * `HTTP_PROXY` (and their lowercase variants) based on the URL scheme.
  *
- * @param {string} url - The target request URL.
- * @returns {string | undefined} Proxy URL, or `undefined` if no proxy applies.
+ * @param {string} url - Absolute URL to resolve a proxy for.
+ * @returns {string|undefined} Proxy URL string, or `undefined` if none applies.
  */
 export declare function resolveEnvProxy(url: string): string | undefined;
 //# sourceMappingURL=env-proxy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"env-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/env-proxy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA2B/D"}
+{"version":3,"file":"env-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/env-proxy.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA2B/D"}

package/dist/proxy/env-proxy.js

@@ -1,16 +1,3 @@
-/**
- * Resolves proxy configuration from standard environment variables
- * (`HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY` and their lowercase variants).
- * Follows the same conventions as curl, got, axios, and undici.
- */
-/**
- * Checks whether the given hostname should bypass the proxy according to the
- * `NO_PROXY` / `no_proxy` environment variable.
- *
- * @param {string} hostname - The target hostname to check.
- * @param {string} noProxy  - Comma-separated list of hosts/domains/CIDRs to bypass.
- * @returns {boolean} `true` if the hostname matches a bypass pattern.
- */
 function matchesNoProxy(hostname, noProxy) {
     if (noProxy === "*")
         return true;
@@ -30,18 +17,13 @@ function matchesNoProxy(hostname, noProxy) {
     return false;
 }
 /**
- * Resolves a proxy URL from environment variables for the given request URL.
- * Returns `undefined` if no proxy should be used (either not configured or
- * the host is in the `NO_PROXY` bypass list).
+ * Resolve a proxy URL from standard environment variables.
  *
- * Precedence (same as curl):
- * 1. `no_proxy` / `NO_PROXY` to skip proxy for matching hosts.
- * 2. `https_proxy` / `HTTPS_PROXY` for HTTPS URLs.
- * 3. `http_proxy` / `HTTP_PROXY` for HTTP URLs.
- * 4. `all_proxy` / `ALL_PROXY` as a fallback for either protocol.
+ * Checks `NO_PROXY` / `no_proxy` first, then selects `HTTPS_PROXY` or
+ * `HTTP_PROXY` (and their lowercase variants) based on the URL scheme.
  *
- * @param {string} url - The target request URL.
- * @returns {string | undefined} Proxy URL, or `undefined` if no proxy applies.
+ * @param {string} url - Absolute URL to resolve a proxy for.
+ * @returns {string|undefined} Proxy URL string, or `undefined` if none applies.
  */
 export function resolveEnvProxy(url) {
     let parsed;

package/dist/proxy/env-proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-proxy.js","sourceRoot":"","sources":["../../src/proxy/env-proxy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAe;IACvD,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO;SACpB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAClC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5F,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACzE,IAAI,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC;IAE3E,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"env-proxy.js","sourceRoot":"","sources":["../../src/proxy/env-proxy.ts"],"names":[],"mappings":"AAAA,SAAS,cAAc,CAAC,QAAgB,EAAE,OAAe;IACvD,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO;SACpB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAClC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5F,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACzE,IAAI,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC;IAE3E,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACrE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -1,33 +1,26 @@
 import * as net from "node:net";
-/**
- * Options for establishing a connection through an HTTP CONNECT proxy.
- *
- * @typedef  {Object}   HttpProxyOptions
- * @property {string}   host      - Proxy server hostname or IP address.
- * @property {number}   port      - Proxy server port.
- * @property {string}   [auth]    - Proxy credentials in `username:password` format (used for Basic auth).
- * @property {number}   [timeout] - Connection timeout in milliseconds (default: 30 000).
- * @property {4 | 6}   [family]  - IP address family to use when resolving the proxy host.
- */
+/** Configuration for connecting through an HTTP CONNECT proxy. */
 export interface HttpProxyOptions {
+    /** Proxy server hostname or IP address. */
     host: string;
+    /** Proxy server port. */
     port: number;
+    /** Optional `Proxy-Authorization` header value. */
     auth?: string;
+    /** Connection timeout in milliseconds. */
     timeout?: number;
+    /** IP address family to use (`4` or `6`). */
     family?: 4 | 6;
-    /** When `true`, connects to the proxy over TLS (HTTPS proxy). */
+    /** Connect to the proxy over TLS (HTTPS proxy). */
     secure?: boolean;
 }
 /**
- * Opens a TCP connection to an HTTP CONNECT proxy and tunnels through it to
- * `targetHost:targetPort`. Resolves with the raw socket once the tunnel is
- * established.
+ * Establish a TCP tunnel through an HTTP CONNECT proxy.
  *
- * @param {HttpProxyOptions} proxy      - Proxy server connection details.
- * @param {string}           targetHost - Destination hostname or IP to tunnel to.
- * @param {number}           targetPort - Destination port to tunnel to.
- * @returns {Promise<net.Socket>} Plain TCP socket connected through the proxy tunnel.
- * @throws {ProxyError} If the connection times out or the proxy rejects the CONNECT request.
+ * @param {HttpProxyOptions} proxy - Proxy connection options.
+ * @param {string} targetHost - Destination hostname.
+ * @param {number} targetPort - Destination port.
+ * @returns {Promise<net.Socket>} Connected socket tunneled through the proxy.
  */
 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

@@ -1 +1 @@
-{"version":3,"file":"http-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/http-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAIhC;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CA0G3H"}
+{"version":3,"file":"http-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/http-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAIhC,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CA0G3H"}

package/dist/proxy/http-proxy.js

@@ -2,15 +2,12 @@ import * as net from "node:net";
 import * as tls from "node:tls";
 import { ProxyError } from "../core/errors.js";
 /**
- * Opens a TCP connection to an HTTP CONNECT proxy and tunnels through it to
- * `targetHost:targetPort`. Resolves with the raw socket once the tunnel is
- * established.
+ * Establish a TCP tunnel through an HTTP CONNECT proxy.
  *
- * @param {HttpProxyOptions} proxy      - Proxy server connection details.
- * @param {string}           targetHost - Destination hostname or IP to tunnel to.
- * @param {number}           targetPort - Destination port to tunnel to.
- * @returns {Promise<net.Socket>} Plain TCP socket connected through the proxy tunnel.
- * @throws {ProxyError} If the connection times out or the proxy rejects the CONNECT request.
+ * @param {HttpProxyOptions} proxy - Proxy connection options.
+ * @param {string} targetHost - Destination hostname.
+ * @param {number} targetPort - Destination port.
+ * @returns {Promise<net.Socket>} Connected socket tunneled through the proxy.
  */
 export async function httpProxyConnect(proxy, targetHost, targetPort) {
     return new Promise((resolve, reject) => {

package/dist/proxy/http-proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-proxy.js","sourceRoot":"","sources":["../../src/proxy/http-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsB/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAuB,EAAE,UAAkB,EAAE,UAAkB;IACpG,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,IAAI,MAAkC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,kBAAkB,EAAE,IAAI;gBACxB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClD,CAAC;YACF,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC;QAC1C,IAAI,KAAgD,CAAC;QAErD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3D,IAAI,UAAU,GAAG,WAAW,UAAU,IAAI,UAAU,eAAe,CAAC;YACpE,UAAU,IAAI,SAAS,UAAU,IAAI,UAAU,MAAM,CAAC;YAEtD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC3D,UAAU,IAAI,8BAA8B,OAAO,MAAM,CAAC;YAC5D,CAAC;YAED,UAAU,IAAI,MAAM,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAEzB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,MAAM,yBAAyB,GAAG,KAAK,CAAC;YAExC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;gBAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,MAAM,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;oBAC9C,OAAO,GAAG,IAAI,CAAC;oBACf,IAAI,KAAK;wBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;oBAC/B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBACtC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC,CAAC;oBAC3E,OAAO;gBACT,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC7C,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACnB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAEtC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC/D,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAEzD,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,OAAO,GAAG,IAAI,CAAC;wBACf,IAAI,KAAK;4BAAE,YAAY,CAAC,KAAK,CAAC,CAAC;wBAC/B,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,MAAM,CAAC,IAAI,UAAU,CAAC,2BAA2B,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;wBAClF,OAAO;oBACT,CAAC;oBAED,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;oBAC3C,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;wBACvB,OAAO,GAAG,IAAI,CAAC;wBACf,IAAI,KAAK;4BAAE,YAAY,CAAC,KAAK,CAAC,CAAC;wBAC/B,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,MAAM,CAAC,IAAI,UAAU,CAAC,oCAAoC,UAAU,EAAE,CAAC,CAAC,CAAC;wBACzE,OAAO;oBACT,CAAC;oBAED,OAAO,GAAG,IAAI,CAAC;oBACf,IAAI,KAAK;wBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;oBAE/B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;oBAClD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACnD,CAAC;oBAED,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,UAAU,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"http-proxy.js","sourceRoot":"","sources":["../../src/proxy/http-proxy.ts"],"names":[],"mappings":"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"}

package/dist/proxy/socks.d.ts

@@ -1,35 +1,28 @@
 import * as net from "node:net";
-/**
- * Options for establishing a connection through a SOCKS4 or SOCKS5 proxy.
- *
- * @typedef  {Object}   SocksProxyOptions
- * @property {string}   host       - Proxy server hostname or IP address.
- * @property {number}   port       - Proxy server port.
- * @property {4 | 5}   version    - SOCKS protocol version.
- * @property {string}   [username] - Username for SOCKS5 username/password authentication.
- * @property {string}   [password] - Password for SOCKS5 username/password authentication.
- * @property {number}   [timeout]  - Connection timeout in milliseconds.
- * @property {4 | 6}   [family]   - IP address family used when resolving the proxy host.
- */
+/** Configuration for connecting through a SOCKS proxy. */
 export interface SocksProxyOptions {
+    /** Proxy server hostname or IP address. */
     host: string;
+    /** Proxy server port. */
     port: number;
+    /** SOCKS protocol version (`4` or `5`). */
     version: 4 | 5;
+    /** Username for SOCKS5 authentication. */
     username?: string;
+    /** Password for SOCKS5 authentication. */
     password?: string;
+    /** Connection timeout in milliseconds. */
     timeout?: number;
+    /** IP address family to use (`4` or `6`). */
     family?: 4 | 6;
 }
 /**
- * Opens a TCP connection to a SOCKS4 or SOCKS5 proxy and negotiates a tunnel
- * to `targetHost:targetPort`. Resolves with the raw socket once the tunnel is
- * established.
+ * Establish a TCP connection through a SOCKS4 or SOCKS5 proxy.
  *
- * @param {SocksProxyOptions} proxy      - Proxy server connection details.
- * @param {string}            targetHost - Destination hostname.
- * @param {number}            targetPort - Destination port.
- * @returns {Promise<net.Socket>} Plain TCP socket connected through the SOCKS tunnel.
- * @throws {ProxyError} If authentication fails or the proxy rejects the connection request.
+ * @param {SocksProxyOptions} proxy - SOCKS proxy options including version and optional credentials.
+ * @param {string} targetHost - Destination hostname.
+ * @param {number} targetPort - Destination port.
+ * @returns {Promise<net.Socket>} Connected socket tunneled through the SOCKS proxy.
  */
 export declare function socksConnect(proxy: SocksProxyOptions, targetHost: string, targetPort: number): Promise<net.Socket>;
 //# sourceMappingURL=socks.d.ts.map

package/dist/proxy/socks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socks.d.ts","sourceRoot":"","sources":["../../src/proxy/socks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAcxH"}
+{"version":3,"file":"socks.d.ts","sourceRoot":"","sources":["../../src/proxy/socks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAcxH"}

package/dist/proxy/socks.js

@@ -1,15 +1,12 @@
 import * as net from "node:net";
 import { ProxyError } from "../core/errors.js";
 /**
- * Opens a TCP connection to a SOCKS4 or SOCKS5 proxy and negotiates a tunnel
- * to `targetHost:targetPort`. Resolves with the raw socket once the tunnel is
- * established.
+ * Establish a TCP connection through a SOCKS4 or SOCKS5 proxy.
  *
- * @param {SocksProxyOptions} proxy      - Proxy server connection details.
- * @param {string}            targetHost - Destination hostname.
- * @param {number}            targetPort - Destination port.
- * @returns {Promise<net.Socket>} Plain TCP socket connected through the SOCKS tunnel.
- * @throws {ProxyError} If authentication fails or the proxy rejects the connection request.
+ * @param {SocksProxyOptions} proxy - SOCKS proxy options including version and optional credentials.
+ * @param {string} targetHost - Destination hostname.
+ * @param {number} targetPort - Destination port.
+ * @returns {Promise<net.Socket>} Connected socket tunneled through the SOCKS proxy.
  */
 export async function socksConnect(proxy, targetHost, targetPort) {
     const socket = await tcpConnect(proxy.host, proxy.port, proxy.timeout, proxy.family);
@@ -103,8 +100,8 @@ async function socks5Handshake(socket, proxy, host, port) {
     }
 }
 async function socks4Connect(socket, host, port) {
-    const hostBuf = Buffer.from(host + "\0", "utf-8");
-    const req = Buffer.alloc(9 + hostBuf.length);
+    const hostBuf = Buffer.from(host, "utf-8");
+    const req = Buffer.alloc(9 + hostBuf.length + 1);
     req[0] = 0x04;
     req[1] = 0x01;
     req.writeUInt16BE(port, 2);
@@ -114,6 +111,7 @@ async function socks4Connect(socket, host, port) {
     req[7] = 1;
     req[8] = 0;
     hostBuf.copy(req, 9);
+    req[9 + hostBuf.length] = 0;
     await socketWrite(socket, req);
     const resp = await socketRead(socket, 8);
     if (resp[1] !== 0x5a) {