recker 1.0.2-0

package/dist/utils/user-agent.d.ts

@@ -0,0 +1,45 @@
+export declare function getDefaultUserAgent(): string;
+export declare const USER_AGENT_PRESETS: {
+    readonly chrome_windows: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+    readonly chrome_mac: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+    readonly chrome_linux: "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+    readonly firefox_windows: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:121.0) Gecko/20100101 Firefox/121.0";
+    readonly firefox_mac: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:121.0) Gecko/20100101 Firefox/121.0";
+    readonly firefox_linux: "Mozilla/5.0 (X11; Linux x86_64; rv:121.0) Gecko/20100101 Firefox/121.0";
+    readonly safari_mac: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15";
+    readonly edge_windows: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0";
+    readonly edge_mac: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0";
+    readonly opera_windows: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 OPR/105.0.0.0";
+    readonly opera_mac: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 OPR/105.0.0.0";
+    readonly safari_iphone: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
+    readonly safari_ipad: "Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
+    readonly chrome_ios: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/120.0.6099.119 Mobile/15E148 Safari/604.1";
+    readonly chrome_android: "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.144 Mobile Safari/537.36";
+    readonly chrome_android_tablet: "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.144 Safari/537.36";
+    readonly firefox_android: "Mozilla/5.0 (Android 14; Mobile; rv:121.0) Gecko/121.0 Firefox/121.0";
+    readonly samsung_browser: "Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/23.0 Chrome/115.0.0.0 Mobile Safari/537.36";
+    readonly googlebot: "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)";
+    readonly googlebot_mobile: "Mozilla/5.0 (Linux; Android 6.0.1; Nexus 5X Build/MMB29P) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.144 Mobile Safari/537.36 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)";
+    readonly recker: string;
+};
+export type UserAgentPreset = keyof typeof USER_AGENT_PRESETS;
+export declare function getUserAgent(preset: UserAgentPreset): string;
+export declare const USER_AGENT_CATEGORIES: {
+    readonly desktop: {
+        readonly chrome: readonly ["chrome_windows", "chrome_mac", "chrome_linux"];
+        readonly firefox: readonly ["firefox_windows", "firefox_mac", "firefox_linux"];
+        readonly safari: readonly ["safari_mac"];
+        readonly edge: readonly ["edge_windows", "edge_mac"];
+        readonly opera: readonly ["opera_windows", "opera_mac"];
+    };
+    readonly mobile: {
+        readonly ios: readonly ["safari_iphone", "safari_ipad", "chrome_ios"];
+        readonly android: readonly ["chrome_android", "chrome_android_tablet", "firefox_android", "samsung_browser"];
+    };
+    readonly bot: readonly ["googlebot", "googlebot_mobile"];
+    readonly default: readonly ["recker"];
+};
+export declare function getRandomUserAgent(category: string): string;
+export declare function detectDeviceType(userAgent: string): 'desktop' | 'mobile' | 'tablet' | 'bot' | 'unknown';
+export declare function isMobile(userAgent: string): boolean;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/utils/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../src/utils/user-agent.ts"],"names":[],"mappings":"AAuBA,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAMD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;CAmCrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAW9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAE5D;AAKD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;CAcxB,CAAC;AAWX,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0B3D;AAKD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAqBvG;AAKD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGnD"}

package/dist/utils/user-agent.js

@@ -0,0 +1,100 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+let RECKER_VERSION = '1.0.0';
+try {
+    const pkgPath = join(process.cwd(), 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    if (pkg.name === 'recker' && pkg.version) {
+        RECKER_VERSION = pkg.version;
+    }
+}
+catch {
+}
+export function getDefaultUserAgent() {
+    return `recker/${RECKER_VERSION}`;
+}
+export const USER_AGENT_PRESETS = {
+    chrome_windows: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+    chrome_mac: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+    chrome_linux: 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+    firefox_windows: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:121.0) Gecko/20100101 Firefox/121.0',
+    firefox_mac: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:121.0) Gecko/20100101 Firefox/121.0',
+    firefox_linux: 'Mozilla/5.0 (X11; Linux x86_64; rv:121.0) Gecko/20100101 Firefox/121.0',
+    safari_mac: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15',
+    edge_windows: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0',
+    edge_mac: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0',
+    opera_windows: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 OPR/105.0.0.0',
+    opera_mac: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 OPR/105.0.0.0',
+    safari_iphone: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1',
+    safari_ipad: 'Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1',
+    chrome_ios: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/120.0.6099.119 Mobile/15E148 Safari/604.1',
+    chrome_android: 'Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.144 Mobile Safari/537.36',
+    chrome_android_tablet: 'Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.144 Safari/537.36',
+    firefox_android: 'Mozilla/5.0 (Android 14; Mobile; rv:121.0) Gecko/121.0 Firefox/121.0',
+    samsung_browser: 'Mozilla/5.0 (Linux; Android 14) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/23.0 Chrome/115.0.0.0 Mobile Safari/537.36',
+    googlebot: 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)',
+    googlebot_mobile: 'Mozilla/5.0 (Linux; Android 6.0.1; Nexus 5X Build/MMB29P) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.144 Mobile Safari/537.36 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)',
+    recker: getDefaultUserAgent(),
+};
+export function getUserAgent(preset) {
+    return USER_AGENT_PRESETS[preset];
+}
+export const USER_AGENT_CATEGORIES = {
+    desktop: {
+        chrome: ['chrome_windows', 'chrome_mac', 'chrome_linux'],
+        firefox: ['firefox_windows', 'firefox_mac', 'firefox_linux'],
+        safari: ['safari_mac'],
+        edge: ['edge_windows', 'edge_mac'],
+        opera: ['opera_windows', 'opera_mac'],
+    },
+    mobile: {
+        ios: ['safari_iphone', 'safari_ipad', 'chrome_ios'],
+        android: ['chrome_android', 'chrome_android_tablet', 'firefox_android', 'samsung_browser'],
+    },
+    bot: ['googlebot', 'googlebot_mobile'],
+    default: ['recker'],
+};
+export function getRandomUserAgent(category) {
+    const parts = category.split('.');
+    let presets = [];
+    if (parts.length === 1) {
+        const cat = USER_AGENT_CATEGORIES[parts[0]];
+        if (Array.isArray(cat)) {
+            presets = cat;
+        }
+        else if (typeof cat === 'object') {
+            presets = Object.values(cat).flat();
+        }
+    }
+    else if (parts.length === 2) {
+        const cat = USER_AGENT_CATEGORIES[parts[0]];
+        if (typeof cat === 'object' && parts[1] in cat) {
+            presets = cat[parts[1]];
+        }
+    }
+    if (presets.length === 0) {
+        return getDefaultUserAgent();
+    }
+    const randomIndex = Math.floor(Math.random() * presets.length);
+    return getUserAgent(presets[randomIndex]);
+}
+export function detectDeviceType(userAgent) {
+    const ua = userAgent.toLowerCase();
+    if (ua.includes('bot') || ua.includes('crawler') || ua.includes('spider')) {
+        return 'bot';
+    }
+    if (ua.includes('ipad') || (ua.includes('tablet')) || (ua.includes('android') && !ua.includes('mobile'))) {
+        return 'tablet';
+    }
+    if (ua.includes('mobile') || ua.includes('iphone')) {
+        return 'mobile';
+    }
+    if (ua.includes('windows') || ua.includes('macintosh') || (ua.includes('linux') && !ua.includes('android'))) {
+        return 'desktop';
+    }
+    return 'unknown';
+}
+export function isMobile(userAgent) {
+    const type = detectDeviceType(userAgent);
+    return type === 'mobile' || type === 'tablet';
+}

package/dist/utils/whois.d.ts

@@ -0,0 +1,15 @@
+export interface WhoisOptions {
+    server?: string;
+    port?: number;
+    timeout?: number;
+    follow?: boolean;
+}
+export interface WhoisResult {
+    raw: string;
+    query: string;
+    server: string;
+    data: Record<string, string | string[]>;
+}
+export declare function whois(query: string, options?: WhoisOptions): Promise<WhoisResult>;
+export declare function isDomainAvailable(domain: string, options?: WhoisOptions): Promise<boolean>;
+//# sourceMappingURL=whois.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whois.d.ts","sourceRoot":"","sources":["../../src/utils/whois.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAK3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAKhB,IAAI,CAAC,EAAE,MAAM,CAAC;IAMd,OAAO,CAAC,EAAE,MAAM,CAAC;IAMjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAI1B,GAAG,EAAE,MAAM,CAAC;IAKZ,KAAK,EAAE,MAAM,CAAC;IAKd,MAAM,EAAE,MAAM,CAAC;IAKf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACzC;AA4KD,wBAAsB,KAAK,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,OAAO,CAAC,CAoBlB"}

package/dist/utils/whois.js

@@ -0,0 +1,159 @@
+import { createConnection } from 'net';
+const DEFAULT_SERVERS = {
+    'com': 'whois.verisign-grs.com',
+    'net': 'whois.verisign-grs.com',
+    'org': 'whois.pir.org',
+    'info': 'whois.afilias.net',
+    'biz': 'whois.biz',
+    'us': 'whois.nic.us',
+    'uk': 'whois.nic.uk',
+    'ca': 'whois.cira.ca',
+    'de': 'whois.denic.de',
+    'fr': 'whois.afnic.fr',
+    'au': 'whois.aunic.net',
+    'jp': 'whois.jprs.jp',
+    'cn': 'whois.cnnic.cn',
+    'ru': 'whois.tcinet.ru',
+    'br': 'whois.registro.br',
+    'eu': 'whois.eu',
+    'io': 'whois.nic.io',
+    'co': 'whois.nic.co',
+    'me': 'whois.nic.me',
+    'tv': 'whois.nic.tv',
+    'cc': 'whois.nic.cc',
+    'ws': 'whois.website.ws',
+    'mobi': 'whois.dotmobiregistry.net',
+    'asia': 'whois.nic.asia',
+    'tel': 'whois.nic.tel',
+    'pro': 'whois.registrypro.pro',
+    'aero': 'whois.aero',
+    'cat': 'whois.cat',
+    'coop': 'whois.nic.coop',
+    'jobs': 'whois.nic.jobs',
+    'museum': 'whois.museum',
+    'travel': 'whois.nic.travel',
+    'xxx': 'whois.nic.xxx',
+    'app': 'whois.nic.google',
+    'dev': 'whois.nic.google',
+    'ai': 'whois.nic.ai',
+};
+function extractTLD(domain) {
+    const parts = domain.toLowerCase().split('.');
+    return parts[parts.length - 1];
+}
+function getWhoisServer(query, customServer) {
+    if (customServer) {
+        return customServer;
+    }
+    const ipv4Pattern = /^(\d{1,3}\.){3}\d{1,3}$/;
+    const ipv6Pattern = /^([0-9a-fA-F]{0,4}:){2,7}[0-9a-fA-F]{0,4}$/;
+    if (ipv4Pattern.test(query) || ipv6Pattern.test(query)) {
+        return 'whois.arin.net';
+    }
+    const tld = extractTLD(query);
+    return DEFAULT_SERVERS[tld] || 'whois.iana.org';
+}
+function parseWhoisData(raw) {
+    const data = {};
+    const lines = raw.split('\n');
+    for (const line of lines) {
+        if (line.startsWith('%') || line.startsWith('#') || !line.trim()) {
+            continue;
+        }
+        const colonIndex = line.indexOf(':');
+        if (colonIndex === -1) {
+            continue;
+        }
+        const key = line.substring(0, colonIndex).trim().toLowerCase();
+        const value = line.substring(colonIndex + 1).trim();
+        if (!key || !value) {
+            continue;
+        }
+        if (data[key]) {
+            if (Array.isArray(data[key])) {
+                data[key].push(value);
+            }
+            else {
+                data[key] = [data[key], value];
+            }
+        }
+        else {
+            data[key] = value;
+        }
+    }
+    return data;
+}
+function extractReferralServer(raw) {
+    const lines = raw.toLowerCase().split('\n');
+    for (const line of lines) {
+        if (line.includes('whois server:') || line.includes('referral url:')) {
+            const match = line.match(/whois\.[\w.-]+/);
+            if (match) {
+                return match[0];
+            }
+        }
+    }
+    return null;
+}
+async function queryWhoisServer(server, query, port, timeout) {
+    return new Promise((resolve, reject) => {
+        let response = '';
+        let socket = null;
+        const timeoutId = setTimeout(() => {
+            socket?.destroy();
+            reject(new Error(`WHOIS query timed out after ${timeout}ms`));
+        }, timeout);
+        socket = createConnection({ host: server, port }, () => {
+            socket.write(query + '\r\n');
+        });
+        socket.on('data', (chunk) => {
+            response += chunk.toString('utf-8');
+        });
+        socket.on('end', () => {
+            clearTimeout(timeoutId);
+            resolve(response);
+        });
+        socket.on('error', (error) => {
+            clearTimeout(timeoutId);
+            reject(new Error(`WHOIS query failed: ${error.message}`));
+        });
+    });
+}
+export async function whois(query, options = {}) {
+    const { server: customServer, port = 43, timeout = 10000, follow = true, } = options;
+    const cleanQuery = query.trim().toLowerCase();
+    let server = getWhoisServer(cleanQuery, customServer);
+    let raw = await queryWhoisServer(server, cleanQuery, port, timeout);
+    if (follow && !customServer) {
+        const referralServer = extractReferralServer(raw);
+        if (referralServer && referralServer !== server) {
+            server = referralServer;
+            raw = await queryWhoisServer(server, cleanQuery, port, timeout);
+        }
+    }
+    const data = parseWhoisData(raw);
+    return {
+        raw,
+        query: cleanQuery,
+        server,
+        data,
+    };
+}
+export async function isDomainAvailable(domain, options) {
+    try {
+        const result = await whois(domain, options);
+        const rawLower = result.raw.toLowerCase();
+        const notFoundIndicators = [
+            'no match',
+            'not found',
+            'no entries found',
+            'no data found',
+            'status: available',
+            'status: free',
+        ];
+        return notFoundIndicators.some(indicator => rawLower.includes(indicator));
+    }
+    catch (error) {
+        return false;
+    }
+}

package/dist/websocket/client.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter } from 'events';
+export interface WebSocketOptions {
+    protocols?: string | string[];
+    headers?: Record<string, string>;
+    reconnect?: boolean;
+    reconnectDelay?: number;
+    maxReconnectAttempts?: number;
+    heartbeatInterval?: number;
+}
+export interface WebSocketMessage {
+    data: string | Buffer;
+    isBinary: boolean;
+}
+export declare class ReckerWebSocket extends EventEmitter {
+    private ws;
+    private url;
+    private options;
+    private reconnectAttempts;
+    private reconnectTimer?;
+    private heartbeatTimer?;
+    private isClosed;
+    private isReconnecting;
+    constructor(url: string, options?: WebSocketOptions);
+    connect(): Promise<void>;
+    send(data: string | Buffer | ArrayBuffer): void;
+    sendJSON(data: any): void;
+    close(code?: number, reason?: string): void;
+    ping(): void;
+    get readyState(): number;
+    get isConnected(): boolean;
+    [Symbol.asyncIterator](): AsyncGenerator<WebSocketMessage>;
+    private attemptReconnect;
+    private clearReconnectTimer;
+    private startHeartbeat;
+    private stopHeartbeat;
+}
+export declare function websocket(url: string, options?: WebSocketOptions): ReckerWebSocket;
+//# sourceMappingURL=client.d.ts.map

package/dist/websocket/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/websocket/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAI/B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAK9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAMjC,SAAS,CAAC,EAAE,OAAO,CAAC;IAMpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAMxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAO9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;gBAEnB,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAgBjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI;IAU/C,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAOzB,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAerC,IAAI,IAAI,IAAI;IAeZ,IAAI,UAAU,IAAI,MAAM,CAEvB;IAKD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAKM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,gBAAgB,CAAC;IAoDjE,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;CAMtB;AAKD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAMlF"}

package/dist/websocket/client.js

@@ -0,0 +1,184 @@
+import { WebSocket } from 'undici';
+import { EventEmitter } from 'events';
+export class ReckerWebSocket extends EventEmitter {
+    ws = null;
+    url;
+    options;
+    reconnectAttempts = 0;
+    reconnectTimer;
+    heartbeatTimer;
+    isClosed = false;
+    isReconnecting = false;
+    constructor(url, options = {}) {
+        super();
+        this.url = url;
+        this.options = {
+            protocols: options.protocols || [],
+            headers: options.headers || {},
+            reconnect: options.reconnect ?? false,
+            reconnectDelay: options.reconnectDelay ?? 1000,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? 5,
+            heartbeatInterval: options.heartbeatInterval ?? 30000,
+        };
+    }
+    async connect() {
+        return new Promise((resolve, reject) => {
+            try {
+                this.ws = new WebSocket(this.url, this.options.protocols);
+                this.ws.addEventListener('open', () => {
+                    this.reconnectAttempts = 0;
+                    this.isReconnecting = false;
+                    this.startHeartbeat();
+                    this.emit('open');
+                    resolve();
+                });
+                this.ws.addEventListener('message', (event) => {
+                    const message = {
+                        data: event.data,
+                        isBinary: event.data instanceof Buffer
+                    };
+                    this.emit('message', message);
+                });
+                this.ws.addEventListener('close', (event) => {
+                    this.stopHeartbeat();
+                    this.emit('close', event.code, event.reason);
+                    if (!this.isClosed && this.options.reconnect) {
+                        this.attemptReconnect();
+                    }
+                });
+                this.ws.addEventListener('error', (event) => {
+                    this.emit('error', event.error || new Error('WebSocket error'));
+                    reject(event.error || new Error('WebSocket connection failed'));
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    send(data) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('WebSocket is not connected');
+        }
+        this.ws.send(data);
+    }
+    sendJSON(data) {
+        this.send(JSON.stringify(data));
+    }
+    close(code = 1000, reason = '') {
+        this.isClosed = true;
+        this.stopHeartbeat();
+        this.clearReconnectTimer();
+        if (this.ws) {
+            this.ws.close(code, reason);
+            this.ws = null;
+        }
+    }
+    ping() {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            try {
+                this.ws.send('__heartbeat__');
+            }
+            catch (e) {
+            }
+        }
+    }
+    get readyState() {
+        return this.ws?.readyState ?? WebSocket.CLOSED;
+    }
+    get isConnected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    async *[Symbol.asyncIterator]() {
+        const queue = [];
+        let resolveNext = null;
+        let closed = false;
+        const messageHandler = (msg) => {
+            if (resolveNext) {
+                resolveNext(msg);
+                resolveNext = null;
+            }
+            else {
+                queue.push(msg);
+            }
+        };
+        const closeHandler = () => {
+            closed = true;
+            if (resolveNext) {
+                resolveNext(null);
+                resolveNext = null;
+            }
+        };
+        this.on('message', messageHandler);
+        this.on('close', closeHandler);
+        try {
+            while (true) {
+                if (queue.length > 0) {
+                    yield queue.shift();
+                }
+                else {
+                    if (closed)
+                        break;
+                    const msg = await new Promise((resolve) => {
+                        resolveNext = resolve;
+                    });
+                    if (msg) {
+                        yield msg;
+                    }
+                    else {
+                        break;
+                    }
+                }
+            }
+        }
+        finally {
+            this.off('message', messageHandler);
+            this.off('close', closeHandler);
+        }
+    }
+    attemptReconnect() {
+        if (this.isReconnecting)
+            return;
+        if (this.options.maxReconnectAttempts > 0 &&
+            this.reconnectAttempts >= this.options.maxReconnectAttempts) {
+            this.emit('max-reconnect-attempts');
+            return;
+        }
+        this.isReconnecting = true;
+        this.reconnectAttempts++;
+        const delay = this.options.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
+        this.emit('reconnecting', this.reconnectAttempts, delay);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect().catch((error) => {
+                this.emit('reconnect-error', error);
+            });
+        }, delay);
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+    }
+    startHeartbeat() {
+        if (this.options.heartbeatInterval <= 0)
+            return;
+        this.heartbeatTimer = setInterval(() => {
+            if (this.isConnected) {
+                this.ping();
+            }
+        }, this.options.heartbeatInterval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+    }
+}
+export function websocket(url, options) {
+    const ws = new ReckerWebSocket(url, options);
+    ws.connect().catch(() => {
+    });
+    return ws;
+}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "recker",
+  "version": "1.0.2-0",
+  "description": "AI & DevX focused HTTP client for Node.js 18+",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "keywords": [
+    "http",
+    "client",
+    "fetch",
+    "axios",
+    "ky",
+    "got",
+    "undici",
+    "typescript",
+    "promise",
+    "retry",
+    "cache",
+    "hooks",
+    "http2",
+    "http3",
+    "sse",
+    "websocket",
+    "whois",
+    "dns",
+    "proxy",
+    "ai"
+  ],
+  "author": "Forattini Dev",
+  "license": "MIT",
+  "homepage": "https://forattini-dev.github.io/recker",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forattini-dev/recker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/forattini-dev/recker/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/core/client.d.ts",
+      "import": "./dist/core/client.js"
+    },
+    "./plugins/*": {
+      "types": "./dist/plugins/*.d.ts",
+      "import": "./dist/plugins/*.js"
+    },
+    "./utils/*": {
+      "types": "./dist/utils/*.d.ts",
+      "import": "./dist/utils/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "undici": "^7.16.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "axios": "^1.13.2",
+    "docsify-darklight-theme": "^3.2.0",
+    "docsify-mermaid": "^2.0.1",
+    "got": "^14.6.5",
+    "husky": "^9.1.7",
+    "ky": "^1.14.0",
+    "mermaid": "^11.12.1",
+    "mitata": "^1.0.34",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "bench": "tsx benchmark/index.ts",
+    "bench:all": "tsx benchmark/run-all.ts",
+    "docs:dev": "npx -y docsify-cli serve docs --port 3000",
+    "docs:preview": "npx -y docsify-cli serve docs --port 3000 --open"
+  }
+}