recker 1.0.2-0 → 1.0.4

package/dist/utils/client-pool.d.ts

@@ -0,0 +1,21 @@
+import { Client } from '../core/client.js';
+import type { ExtendedClientOptions } from '../core/client.js';
+export declare class ClientPool {
+    private pool;
+    private defaultOptions;
+    constructor(options?: Omit<ExtendedClientOptions, 'baseUrl'>);
+    get(baseUrl: string): Client;
+    has(baseUrl: string): boolean;
+    get size(): number;
+    clear(): void;
+    remove(baseUrl: string): boolean;
+    multi<T = unknown>(requests: Array<{
+        baseUrl: string;
+        path: string;
+        method?: string;
+        options?: Record<string, unknown>;
+    }>): Promise<T[]>;
+}
+export declare const globalPool: ClientPool;
+export declare function createDedupPool(options?: Omit<ExtendedClientOptions, 'baseUrl' | 'dedup'>): ClientPool;
+//# sourceMappingURL=client-pool.d.ts.map

package/dist/utils/client-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-pool.d.ts","sourceRoot":"","sources":["../../src/utils/client-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAwB/D,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,cAAc,CAAyC;gBAEnD,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAM;IAQhE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAiB5B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAO7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKD,KAAK,IAAI,IAAI;IAOb,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAmB1B,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,GACD,OAAO,CAAC,CAAC,EAAE,CAAC;CAchB;AAcD,eAAO,MAAM,UAAU,YAAmB,CAAC;AAW3C,wBAAgB,eAAe,CAAC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,OAAO,CAAM,GAAG,UAAU,CAK1G"}

package/dist/utils/client-pool.js

@@ -0,0 +1,49 @@
+import { Client } from '../core/client.js';
+export class ClientPool {
+    pool = new Map();
+    defaultOptions;
+    constructor(options = {}) {
+        this.defaultOptions = options;
+    }
+    get(baseUrl) {
+        let client = this.pool.get(baseUrl);
+        if (!client) {
+            client = new Client({
+                ...this.defaultOptions,
+                baseUrl,
+            });
+            this.pool.set(baseUrl, client);
+        }
+        return client;
+    }
+    has(baseUrl) {
+        return this.pool.has(baseUrl);
+    }
+    get size() {
+        return this.pool.size;
+    }
+    clear() {
+        this.pool.clear();
+    }
+    remove(baseUrl) {
+        return this.pool.delete(baseUrl);
+    }
+    async multi(requests) {
+        const promises = requests.map(({ baseUrl, path, method = 'GET', options = {} }) => {
+            const client = this.get(baseUrl);
+            const methodFn = client[method.toLowerCase()];
+            if (typeof methodFn !== 'function') {
+                throw new Error(`Unknown HTTP method: ${method}`);
+            }
+            return methodFn.call(client, path, options).json();
+        });
+        return Promise.all(promises);
+    }
+}
+export const globalPool = new ClientPool();
+export function createDedupPool(options = {}) {
+    return new ClientPool({
+        ...options,
+        dedup: {},
+    });
+}

package/dist/utils/concurrency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,YAAY,EAEZ,aAAa,EACd,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE,YAAY,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE;QACL,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AA+BD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,GACpD,2BAA2B,CAuE7B;AAiED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,OAAO,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,UAAU,GAAE,MAAU,GACrB,MAAM,CAaR;AA4BD,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,2BAA2B,EAC5C,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,GACnB,2BAA2B,CA6B7B"}
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,YAAY,EAEZ,aAAa,EACd,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE,YAAY,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE;QACL,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AA8BD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,GACpD,2BAA2B,CAuE7B;AAqED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,OAAO,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,UAAU,GAAE,MAAU,GACrB,MAAM,CAaR;AA4BD,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,2BAA2B,EAC5C,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,GACnB,2BAA2B,CA6B7B"}

package/dist/utils/concurrency.js

@@ -1,4 +1,4 @@
-const DEFAULT_INTERVAL = 1000;
+const DEFAULT_INTERVAL = 1 * 1000;
 export function normalizeConcurrency(options) {
     let config;
     if (typeof options.concurrency === 'number') {
@@ -57,10 +57,14 @@ function normalizeAgentConfig(agentConfig, maxConcurrent, http2Enabled, http2Max
     const defaults = {
         pipelining: 1,
         keepAlive: true,
-        keepAliveTimeout: 4000,
-        keepAliveMaxTimeout: 600000,
-        connectTimeout: 10000,
+        keepAliveTimeout: 4 * 1000,
+        keepAliveMaxTimeout: 10 * 60 * 1000,
+        keepAliveTimeoutThreshold: 1 * 1000,
+        connectTimeout: 10 * 1000,
         perDomainPooling: true,
+        maxCachedSessions: 100,
+        maxRequestsPerClient: 0,
+        clientTtl: null,
     };
     const merged = { ...defaults, ...agentConfig };
     let connections;

package/dist/utils/dns-toolkit.d.ts

@@ -0,0 +1,13 @@
+export interface DnsSecurityRecords {
+    spf?: string[];
+    dmarc?: string;
+    caa?: {
+        issue?: string[];
+        issuewild?: string[];
+        iodef?: string;
+    };
+    mx?: string[];
+    txt?: string[];
+}
+export declare function getSecurityRecords(domain: string): Promise<DnsSecurityRecords>;
+//# sourceMappingURL=dns-toolkit.d.ts.map

package/dist/utils/dns-toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns-toolkit.d.ts","sourceRoot":"","sources":["../../src/utils/dns-toolkit.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+DpF"}

package/dist/utils/dns-toolkit.js

@@ -0,0 +1,48 @@
+import { promises as dns } from 'node:dns';
+export async function getSecurityRecords(domain) {
+    const results = { txt: [] };
+    try {
+        const txtRecords = await dns.resolveTxt(domain);
+        const flatTxt = txtRecords.map(chunks => chunks.join(''));
+        results.txt = flatTxt;
+        results.spf = flatTxt.filter(txt => txt.startsWith('v=spf1'));
+        try {
+            const dmarcRecords = await dns.resolveTxt(`_dmarc.${domain}`);
+            const dmarcTxt = dmarcRecords.map(chunks => chunks.join(''))[0];
+            if (dmarcTxt && dmarcTxt.startsWith('v=DMARC1')) {
+                results.dmarc = dmarcTxt;
+            }
+        }
+        catch {
+        }
+        try {
+            const caaRecords = await dns.resolveCaa(domain);
+            results.caa = {};
+            caaRecords.forEach(r => {
+                if (!results.caa[r.issue]) {
+                }
+                if (r.issue) {
+                    results.caa.issue = [...(results.caa.issue || []), r.issue];
+                }
+                if (r.issuewild) {
+                    results.caa.issuewild = [...(results.caa.issuewild || []), r.issuewild];
+                }
+                if (r.iodef) {
+                    results.caa.iodef = r.iodef;
+                }
+            });
+        }
+        catch {
+        }
+        try {
+            const mx = await dns.resolveMx(domain);
+            results.mx = mx.map(r => r.exchange);
+        }
+        catch {
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve DNS for ${domain}: ${error}`);
+    }
+    return results;
+}

package/dist/utils/doh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doh.d.ts","sourceRoot":"","sources":["../../src/utils/doh.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAsBrE,wBAAgB,eAAe,CAAC,QAAQ,GAAE,WAA0B,IAGpD,UAAU,MAAM,EAAE,MAAM,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,mBAqClH"}
+{"version":3,"file":"doh.d.ts","sourceRoot":"","sources":["../../src/utils/doh.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAsBrE,wBAAgB,eAAe,CAAC,QAAQ,GAAE,WAA0B,IAGpD,UAAU,MAAM,EAAE,MAAM,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,mBAwElH"}

package/dist/utils/doh.js

@@ -1,4 +1,5 @@
 import { request } from 'undici';
+import { ReckerError } from '../core/errors.js';
 const PROVIDERS = {
     cloudflare: 'https://1.1.1.1/dns-query',
     google: 'https://8.8.8.8/resolve',
@@ -16,17 +17,29 @@ export function createDoHLookup(provider = 'cloudflare') {
                 headers: { 'Accept': 'application/dns-json' }
             });
             if (statusCode !== 200) {
-                throw new Error(`DoH request failed with status ${statusCode}`);
+                throw new ReckerError(`DoH request failed with status ${statusCode}`, undefined, undefined, [
+                    'Verify the DNS-over-HTTPS endpoint URL.',
+                    'Check network connectivity and TLS settings for the DoH provider.',
+                    'Retry the request; some providers throttle bursts.'
+                ]);
             }
             const data = await body.json();
             if (data.Status !== 0 || !data.Answer || data.Answer.length === 0) {
-                return callback(new Error(`DNS lookup failed for ${hostname}`), '', 4);
+                return callback(new ReckerError(`DNS lookup failed for ${hostname}`, undefined, undefined, [
+                    'Confirm the hostname is correct.',
+                    'Check that the DoH provider is reachable.',
+                    'Retry or fall back to system DNS if the provider is down.'
+                ]), '', 4);
             }
             const record = data.Answer.find(r => r.type === 1);
             if (record) {
                 return callback(null, record.data, 4);
             }
-            callback(new Error(`No A record found for ${hostname}`), '', 4);
+            callback(new ReckerError(`No A record found for ${hostname}`, undefined, undefined, [
+                'Verify the domain has an A record (or use AAAA for IPv6).',
+                'Check DNS propagation if the record was recently added.',
+                'Try an alternate resolver to rule out stale caches.'
+            ]), '', 4);
         }
         catch (err) {
             callback(err, '', 0);

package/dist/utils/download.d.ts

@@ -0,0 +1,15 @@
+import { Client } from '../core/client.js';
+import type { ProgressCallback, RequestOptions } from '../types/index.js';
+export interface DownloadToFileOptions {
+    resume?: boolean;
+    headers?: Record<string, string> | Headers | [string, string][];
+    onProgress?: ProgressCallback;
+    request?: Omit<RequestOptions, 'headers' | 'onDownloadProgress'>;
+}
+export interface DownloadResult {
+    resumed: boolean;
+    status: number;
+    bytesWritten: number;
+}
+export declare function downloadToFile(client: Client, url: string, destination: string, options?: DownloadToFileOptions): Promise<DownloadResult>;
+//# sourceMappingURL=download.d.ts.map

package/dist/utils/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/utils/download.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG1E,MAAM,WAAW,qBAAqB;IAKpC,MAAM,CAAC,EAAE,OAAO,CAAC;IAKjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAKhE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAK9B,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,oBAAoB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,cAAc,CAAC,CAyCzB"}

package/dist/utils/download.js

@@ -0,0 +1,44 @@
+import { createWriteStream, existsSync, statSync } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { ReckerError } from '../core/errors.js';
+export async function downloadToFile(client, url, destination, options = {}) {
+    const resumeEnabled = options.resume === true;
+    const existingSize = resumeEnabled && existsSync(destination) ? statSync(destination).size : 0;
+    const headers = new Headers(options.headers || {});
+    if (resumeEnabled && existingSize > 0 && !headers.has('Range')) {
+        headers.set('Range', `bytes=${existingSize}-`);
+    }
+    const response = await client.get(url, {
+        ...(options.request || {}),
+        headers,
+        onDownloadProgress: options.onProgress,
+    });
+    const shouldAppend = resumeEnabled && existingSize > 0 && response.status === 206;
+    if (resumeEnabled && existingSize > 0 && response.status === 416) {
+        throw new ReckerError('Requested range not satisfiable for resume download.', undefined, response, [
+            'Verify the destination file size matches the server content.',
+            'Delete the local file and retry without resume.',
+            'Ensure the server supports Range requests for this resource.'
+        ]);
+    }
+    const bytesWritten = await streamToFile(response, destination, shouldAppend);
+    return {
+        resumed: shouldAppend,
+        status: response.status,
+        bytesWritten,
+    };
+}
+async function streamToFile(response, destination, append) {
+    const nodeStream = response.toNodeStream();
+    if (!nodeStream) {
+        throw new ReckerError('Response has no body to write', undefined, response, [
+            'Ensure the request returned a body (avoid HEAD/204).',
+            'Check upstream for empty responses or errors.',
+            'Retry the download if the connection was interrupted.'
+        ]);
+    }
+    const writer = createWriteStream(destination, { flags: append ? 'a' : 'w' });
+    await pipeline(nodeStream, writer);
+    const written = writer.bytesWritten;
+    return written;
+}

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

@@ -0,0 +1,13 @@
+export interface EnvProxyOptions {
+    url?: string;
+    httpProxy?: string;
+    httpsProxy?: string;
+    noProxy?: string;
+}
+export declare function getProxyForUrl(url: string, options?: EnvProxyOptions): string | undefined;
+export declare function shouldBypassProxy(hostname: string, port: string, noProxy: string): boolean;
+export declare function getProxyEnv(): Record<string, string | undefined>;
+export declare function createProxyConfig(url: string): {
+    url: string;
+} | undefined;
+//# sourceMappingURL=env-proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env-proxy.d.ts","sourceRoot":"","sources":["../../src/utils/env-proxy.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAI9B,GAAG,CAAC,EAAE,MAAM,CAAC;IAKb,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA+BD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,GAAG,SAAS,CAkC7F;AAiBD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyD1F;AAgCD,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAWhE;AAoBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAI1E"}

package/dist/utils/env-proxy.js

@@ -0,0 +1,105 @@
+export function getProxyForUrl(url, options = {}) {
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url);
+    }
+    catch {
+        return undefined;
+    }
+    const protocol = parsedUrl.protocol.replace(':', '').toLowerCase();
+    const noProxy = options.noProxy ?? process.env.NO_PROXY ?? process.env.no_proxy ?? '';
+    if (shouldBypassProxy(parsedUrl.hostname, parsedUrl.port, noProxy)) {
+        return undefined;
+    }
+    let proxy;
+    if (protocol === 'https') {
+        proxy = options.httpsProxy ??
+            process.env.HTTPS_PROXY ??
+            process.env.https_proxy ??
+            process.env.ALL_PROXY ??
+            process.env.all_proxy;
+    }
+    else {
+        proxy = options.httpProxy ??
+            process.env.HTTP_PROXY ??
+            process.env.http_proxy ??
+            process.env.ALL_PROXY ??
+            process.env.all_proxy;
+    }
+    return proxy || undefined;
+}
+export function shouldBypassProxy(hostname, port, noProxy) {
+    if (!noProxy || noProxy.trim() === '') {
+        return false;
+    }
+    hostname = hostname.toLowerCase();
+    const rules = noProxy.split(/[\s,]+/).filter(Boolean);
+    for (const rule of rules) {
+        const normalizedRule = rule.toLowerCase().trim();
+        if (normalizedRule === '*') {
+            return true;
+        }
+        if (normalizedRule.includes('/') && !normalizedRule.includes(':')) {
+            if (matchesCIDR(hostname, normalizedRule)) {
+                return true;
+            }
+            continue;
+        }
+        if (normalizedRule.includes(':') && !normalizedRule.startsWith('[')) {
+            const [ruleHost, rulePort] = normalizedRule.split(':');
+            if (hostname === ruleHost && (!rulePort || port === rulePort)) {
+                return true;
+            }
+            continue;
+        }
+        if (normalizedRule.startsWith('.')) {
+            if (hostname.endsWith(normalizedRule) || hostname === normalizedRule.slice(1)) {
+                return true;
+            }
+            continue;
+        }
+        if (hostname === normalizedRule) {
+            return true;
+        }
+        if (hostname.endsWith('.' + normalizedRule)) {
+            return true;
+        }
+    }
+    return false;
+}
+function matchesCIDR(ip, cidr) {
+    const [range, bits] = cidr.split('/');
+    if (!bits)
+        return ip === range;
+    const mask = parseInt(bits, 10);
+    if (isNaN(mask))
+        return false;
+    const ipParts = ip.split('.').map(Number);
+    const rangeParts = range.split('.').map(Number);
+    if (ipParts.length !== 4 || rangeParts.length !== 4)
+        return false;
+    if (ipParts.some(isNaN) || rangeParts.some(isNaN))
+        return false;
+    const ipNum = (ipParts[0] << 24) | (ipParts[1] << 16) | (ipParts[2] << 8) | ipParts[3];
+    const rangeNum = (rangeParts[0] << 24) | (rangeParts[1] << 16) | (rangeParts[2] << 8) | rangeParts[3];
+    const maskNum = ~((1 << (32 - mask)) - 1);
+    return (ipNum & maskNum) === (rangeNum & maskNum);
+}
+export function getProxyEnv() {
+    return {
+        HTTP_PROXY: process.env.HTTP_PROXY,
+        http_proxy: process.env.http_proxy,
+        HTTPS_PROXY: process.env.HTTPS_PROXY,
+        https_proxy: process.env.https_proxy,
+        ALL_PROXY: process.env.ALL_PROXY,
+        all_proxy: process.env.all_proxy,
+        NO_PROXY: process.env.NO_PROXY,
+        no_proxy: process.env.no_proxy,
+    };
+}
+export function createProxyConfig(url) {
+    const proxyUrl = getProxyForUrl(url);
+    if (!proxyUrl)
+        return undefined;
+    return { url: proxyUrl };
+}

package/dist/utils/header-parser.d.ts

@@ -7,7 +7,7 @@ export interface CacheInfo {
 }
 export interface PlatformInfo {
     provider?: string;
-    category?: 'cdn' | 'cloud' | 'hosting' | 'server' | 'proxy' | 'unknown';
+    category?: 'cdn' | 'cloud' | 'hosting' | 'server' | 'proxy' | 'security' | 'framework' | 'unknown';
     region?: string;
     server?: string;
     metadata?: {
@@ -68,6 +68,18 @@ export interface AcceptInfo {
     }>;
 }
 export declare function parseAcceptInfo(headers: Headers): AcceptInfo;
+export interface AuthInfo {
+    methods: string[];
+    realm?: string;
+    error?: string;
+    errorDescription?: string;
+}
+export declare function parseAuthInfo(headers: Headers): AuthInfo;
+export interface ClockSkewInfo {
+    serverTime?: Date;
+    skewMs?: number;
+}
+export declare function parseClockSkew(headers: Headers): ClockSkewInfo;
 export interface HeaderInfo {
     cache: CacheInfo;
     platform: PlatformInfo;
@@ -76,6 +88,8 @@ export interface HeaderInfo {
     csp: CSPInfo;
     contentType: ContentTypeInfo;
     accept: AcceptInfo;
+    auth: AuthInfo;
+    clockSkew: ClockSkewInfo;
 }
 export declare function parseHeaders(headers: Headers, status: number): HeaderInfo;
 //# sourceMappingURL=header-parser.d.ts.map

package/dist/utils/header-parser.d.ts.map

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

package/dist/utils/header-parser.js

@@ -189,6 +189,123 @@ const PLATFORM_DETECTORS = [
                 origin: headers.get('x-render-origin-server')
             }
         })
+    },
+    {
+        name: 'datadome',
+        category: 'security',
+        headers: ['x-datadome', 'x-datadome-cid'],
+        detect: (headers) => headers.get('x-datadome') !== null || headers.get('x-datadome-cid') !== null,
+        extract: (headers) => ({
+            metadata: { cid: headers.get('x-datadome-cid') }
+        })
+    },
+    {
+        name: 'incapsula',
+        category: 'security',
+        headers: ['x-iinfo', 'x-cdn'],
+        detect: (headers) => headers.get('x-iinfo') !== null || (headers.get('x-cdn') || '').includes('Incapsula'),
+        extract: (headers) => ({
+            metadata: { iinfo: headers.get('x-iinfo') }
+        })
+    },
+    {
+        name: 'imperva',
+        category: 'security',
+        headers: ['x-imperva-uuid'],
+        detect: (headers) => headers.get('x-imperva-uuid') !== null,
+        extract: (headers) => ({
+            metadata: { uuid: headers.get('x-imperva-uuid') }
+        })
+    },
+    {
+        name: 'aws-waf',
+        category: 'security',
+        headers: ['x-amzn-waf-action'],
+        detect: (headers) => headers.get('server') === 'awselb/2.0',
+        extract: (headers) => ({})
+    },
+    {
+        name: 'envoy',
+        category: 'proxy',
+        headers: ['x-envoy-upstream-service-time'],
+        detect: (headers) => headers.get('x-envoy-upstream-service-time') !== null || headers.get('server') === 'envoy',
+        extract: (headers) => ({})
+    },
+    {
+        name: 'traefik',
+        category: 'proxy',
+        headers: [],
+        detect: (headers) => (headers.get('server') || '').toLowerCase().includes('traefik'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'caddy',
+        category: 'server',
+        headers: [],
+        detect: (headers) => (headers.get('server') || '').toLowerCase().includes('caddy'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'haproxy',
+        category: 'proxy',
+        headers: [],
+        detect: (headers) => (headers.get('server') || '').toLowerCase().includes('haproxy'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'iis',
+        category: 'server',
+        headers: ['x-powered-by'],
+        detect: (headers) => (headers.get('server') || '').toLowerCase().includes('iis'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'kestrel',
+        category: 'server',
+        headers: [],
+        detect: (headers) => (headers.get('server') || '').toLowerCase().includes('kestrel'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'express',
+        category: 'framework',
+        headers: ['x-powered-by'],
+        detect: (headers) => (headers.get('x-powered-by') || '').toLowerCase().includes('express'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'rails',
+        category: 'framework',
+        headers: ['x-runtime', 'x-request-id'],
+        detect: (headers) => headers.get('x-runtime') !== null && !(headers.get('x-powered-by') || '').includes('Express'),
+        extract: (headers) => ({
+            metadata: { runtime: headers.get('x-runtime') }
+        })
+    },
+    {
+        name: 'django',
+        category: 'framework',
+        headers: [],
+        detect: (headers) => (headers.get('server') || '').toLowerCase().includes('wsgi'),
+        extract: (headers) => ({})
+    },
+    {
+        name: 'aspnet',
+        category: 'framework',
+        headers: ['x-aspnet-version', 'x-powered-by'],
+        detect: (headers) => headers.get('x-aspnet-version') !== null || (headers.get('x-powered-by') || '').includes('ASP.NET'),
+        extract: (headers) => ({
+            metadata: { version: headers.get('x-aspnet-version') }
+        })
+    },
+    {
+        name: 'php',
+        category: 'framework',
+        headers: ['x-powered-by'],
+        detect: (headers) => (headers.get('x-powered-by') || '').toLowerCase().includes('php'),
+        extract: (headers) => ({
+            metadata: { version: headers.get('x-powered-by') }
+        })
     }
 ];
 export function parsePlatformInfo(headers) {
@@ -444,6 +561,47 @@ export function parseAcceptInfo(headers) {
     }
     return info;
 }
+export function parseAuthInfo(headers) {
+    const info = { methods: [] };
+    const wwwAuth = headers.get('www-authenticate');
+    if (wwwAuth) {
+        if (wwwAuth.toLowerCase().includes('basic'))
+            info.methods.push('Basic');
+        if (wwwAuth.toLowerCase().includes('bearer'))
+            info.methods.push('Bearer');
+        if (wwwAuth.toLowerCase().includes('digest'))
+            info.methods.push('Digest');
+        if (wwwAuth.toLowerCase().includes('negotiate'))
+            info.methods.push('Negotiate');
+        if (wwwAuth.toLowerCase().includes('aws4-hmac-sha256'))
+            info.methods.push('AWS4');
+        const realmMatch = wwwAuth.match(/realm="([^"]+)"/);
+        if (realmMatch)
+            info.realm = realmMatch[1];
+        const errorMatch = wwwAuth.match(/error="([^"]+)"/);
+        if (errorMatch)
+            info.error = errorMatch[1];
+        const descMatch = wwwAuth.match(/error_description="([^"]+)"/);
+        if (descMatch)
+            info.errorDescription = descMatch[1];
+    }
+    const xAuthError = headers.get('x-auth-error') || headers.get('x-authentication-error');
+    if (xAuthError) {
+        if (!info.error)
+            info.error = xAuthError;
+    }
+    return info;
+}
+export function parseClockSkew(headers) {
+    const dateHeader = headers.get('date');
+    if (!dateHeader)
+        return {};
+    const serverTime = new Date(dateHeader);
+    if (isNaN(serverTime.getTime()))
+        return {};
+    const skewMs = serverTime.getTime() - Date.now();
+    return { serverTime, skewMs };
+}
 export function parseHeaders(headers, status) {
     return {
         cache: parseCacheInfo(headers),
@@ -452,6 +610,8 @@ export function parseHeaders(headers, status) {
         compression: parseCompressionInfo(headers),
         csp: parseCSPInfo(headers),
         contentType: parseContentType(headers),
-        accept: parseAcceptInfo(headers)
+        accept: parseAcceptInfo(headers),
+        auth: parseAuthInfo(headers),
+        clockSkew: parseClockSkew(headers)
     };
 }