recker 1.0.7 → 1.0.9

package/README.md

@@ -6,7 +6,7 @@
 
 ### The HTTP SDK for the AI Era
 
-**Stop fetching. Start orchestrating.**
+**Fast as infrastructure demands. AI-ready from the first byte. Observable down to the millisecond. Resilient when everything else fails.**
 
 [![npm version](https://img.shields.io/npm/v/recker.svg?style=flat-square&color=F5A623)](https://www.npmjs.com/package/recker)
 [![npm downloads](https://img.shields.io/npm/dm/recker.svg?style=flat-square&color=34C759)](https://www.npmjs.com/package/recker)
@@ -102,24 +102,24 @@ console.log(timings);
 
 **Getting Started**
 - [Installation](./docs/getting-started/installation.md)
-- [Quick Start](./docs/getting-started/quickstart.md)
-- [Client Configuration](./docs/guides/client-config.md)
+- [Quick Start](./docs/http/01-quickstart.md)
+- [Client Configuration](./docs/http/05-configuration.md)
 
 **Core Features**
-- [HTTP Methods (19)](./docs/guides/http-methods.md)
-- [Streaming & SSE](./docs/guides/streaming.md)
-- [Retry & Backoff](./docs/guides/advanced/retry.md)
-- [Caching](./docs/guides/caching.md)
-- [Pagination](./docs/guides/pagination.md)
+- [HTTP Fundamentals](./docs/http/02-fundamentals.md)
+- [Streaming & SSE](./docs/ai/02-streaming.md)
+- [Retry & Resilience](./docs/http/07-resilience.md)
+- [Caching](./docs/http/09-cache.md)
+- [Concurrency](./docs/http/08-concurrency.md)
 
 **Integrations**
-- [GraphQL](./docs/guides/graphql.md)
-- [Scraping](./docs/guides/scraping.md)
-- [Hooks](./docs/guides/hooks.md)
+- [GraphQL](./docs/http/13-graphql.md)
+- [Scraping](./docs/http/14-scraping.md)
+- [Plugins](./docs/http/10-plugins.md)
 
 **Reference**
-- [API Reference](./docs/api/README.md)
-- [Troubleshooting](./docs/guides/troubleshooting.md)
+- [API Reference](./docs/reference/01-api.md)
+- [Troubleshooting](./docs/reference/05-troubleshooting.md)
 - [Examples](./docs/examples/README.md)
 
 ## ❤️ Acknowledgements

package/dist/cli/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/cli/handler.ts"],"names":[],"mappings":"AAmBA,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,iBAqG1D"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/cli/handler.ts"],"names":[],"mappings":"AAwBA,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,iBAqG1D"}

package/dist/cli/handler.js

@@ -6,8 +6,13 @@ let highlight;
 const ora = oraImport;
 async function initDependencies() {
     if (!highlight) {
-        const cardinal = await requireOptional('cardinal', 'recker/cli');
-        highlight = cardinal.highlight;
+        try {
+            const cardinal = await requireOptional('cardinal', 'recker/cli');
+            highlight = cardinal.highlight;
+        }
+        catch {
+            highlight = (code) => code;
+        }
     }
 }
 export async function handleRequest(options) {

package/dist/cli/tui/shell.d.ts

@@ -6,9 +6,13 @@ export declare class RekShell {
     private lastResponse;
     private variables;
     private initialized;
+    private currentDoc;
+    private currentDocUrl;
     constructor();
     private ensureInitialized;
     private getPrompt;
+    private getBaseDomain;
+    private getRootDomain;
     private completer;
     start(): Promise<void>;
     private prompt;
@@ -22,6 +26,19 @@ export declare class RekShell {
     private resolveVariables;
     private resolveUrl;
     private executeRequest;
+    private runWhois;
+    private runTLS;
+    private runDNS;
+    private runRDAP;
+    private runPing;
+    private runScrap;
+    private runSelect;
+    private runSelectText;
+    private runSelectAttr;
+    private runSelectHtml;
+    private runSelectLinks;
+    private runSelectImages;
+    private runSelectTable;
     private printHelp;
 }
 //# sourceMappingURL=shell.d.ts.map

package/dist/cli/tui/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/shell.ts"],"names":[],"mappings":"AAsBA,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAsB;IAChC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAS;;YAWd,iBAAiB;IAe/B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,SAAS;IAMJ,KAAK;IA8BlB,OAAO,CAAC,MAAM;YAKA,aAAa;YAgGb,kBAAkB;YAkBlB,SAAS;YAkBT,WAAW;IA0DzB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,UAAU;YAeJ,cAAc;IAyE5B,OAAO,CAAC,SAAS;CAwClB"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/shell.ts"],"names":[],"mappings":"AAiCA,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAsB;IAChC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,aAAa,CAAc;;YAWrB,iBAAiB;IAe/B,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,SAAS;IAYJ,KAAK;IA8BlB,OAAO,CAAC,MAAM;YAKA,aAAa;YAwIb,kBAAkB;YAkBlB,SAAS;YAkBT,WAAW;IA0DzB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,UAAU;YAeJ,cAAc;YAyEd,QAAQ;YA8GR,MAAM;YA2DN,MAAM;YA2EN,OAAO;YA+DP,OAAO;YA0CP,QAAQ;YAwCR,SAAS;YAsCT,aAAa;YA8Bb,aAAa;YA+Bb,aAAa;YA6Bb,cAAc;YAkCd,eAAe;YAkCf,cAAc;IA8C5B,OAAO,CAAC,SAAS;CAyDlB"}

package/dist/cli/tui/shell.js

@@ -1,13 +1,24 @@
 import readline from 'node:readline';
+import { promises as dns } from 'node:dns';
 import { requireOptional } from '../../utils/optional-require.js';
 import { createClient } from '../../core/client.js';
 import { startInteractiveWebSocket } from './websocket.js';
-import pc from '../../utils/colors.js';
+import { whois, isDomainAvailable } from '../../utils/whois.js';
+import { inspectTLS } from '../../utils/tls-inspector.js';
+import { getSecurityRecords } from '../../utils/dns-toolkit.js';
+import { rdap } from '../../utils/rdap.js';
+import { ScrapeDocument } from '../../scrape/document.js';
+import colors from '../../utils/colors.js';
 let highlight;
 async function initDependencies() {
     if (!highlight) {
-        const cardinal = await requireOptional('cardinal', 'recker/cli');
-        highlight = cardinal.highlight;
+        try {
+            const cardinal = await requireOptional('cardinal', 'recker/cli');
+            highlight = cardinal.highlight;
+        }
+        catch {
+            highlight = (code) => code;
+        }
     }
 }
 export class RekShell {
@@ -18,6 +29,8 @@ export class RekShell {
     lastResponse = null;
     variables = {};
     initialized = false;
+    currentDoc = null;
+    currentDocUrl = '';
     constructor() {
         this.client = createClient({
             baseUrl: 'http://localhost',
@@ -37,20 +50,49 @@ export class RekShell {
         this.initialized = true;
     }
     getPrompt() {
-        const base = this.baseUrl ? pc.cyan(new URL(this.baseUrl).hostname) : pc.gray('rek');
-        return `${base} ${pc.magenta('›')} `;
+        const base = this.baseUrl ? colors.cyan(new URL(this.baseUrl).hostname) : colors.gray('rek');
+        return `${base} ${colors.magenta('›')} `;
+    }
+    getBaseDomain() {
+        if (!this.baseUrl)
+            return null;
+        try {
+            return new URL(this.baseUrl).hostname;
+        }
+        catch {
+            return null;
+        }
+    }
+    getRootDomain() {
+        const hostname = this.getBaseDomain();
+        if (!hostname)
+            return null;
+        const parts = hostname.split('.');
+        if (parts.length <= 2)
+            return hostname;
+        const commonSLDs = ['co', 'com', 'net', 'org', 'gov', 'edu', 'ac'];
+        if (parts.length >= 3 && commonSLDs.includes(parts[parts.length - 2])) {
+            return parts.slice(-3).join('.');
+        }
+        return parts.slice(-2).join('.');
     }
     completer(line) {
-        const commands = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'ws', 'udp', 'load', 'chat', 'ai', 'help', 'clear', 'exit', 'set', 'url'];
+        const commands = [
+            'get', 'post', 'put', 'delete', 'patch', 'head', 'options',
+            'ws', 'udp', 'load', 'chat', 'ai',
+            'whois', 'tls', 'ssl', 'dns', 'rdap', 'ping',
+            'scrap', '$', '$text', '$attr', '$html', '$links', '$images', '$table',
+            'help', 'clear', 'exit', 'set', 'url', 'vars'
+        ];
         const hits = commands.filter((c) => c.startsWith(line));
         return [hits.length ? hits : commands, line];
     }
     async start() {
         await this.ensureInitialized();
         console.clear();
-        console.log(pc.bold(pc.cyan('Rek Console')));
-        console.log(pc.gray('Chat with your APIs. Type "help" for magic.'));
-        console.log(pc.gray('--------------------------------------------\n'));
+        console.log(colors.bold(colors.cyan('Rek Console')));
+        console.log(colors.gray('Chat with your APIs. Type "help" for magic.'));
+        console.log(colors.gray('--------------------------------------------\n'));
         this.prompt();
         this.rl.on('line', async (line) => {
             const input = line.trim();
@@ -60,11 +102,11 @@ export class RekShell {
             this.prompt();
         });
         this.rl.on('SIGINT', () => {
-            readline.clearLine(process.stdout, 0);
-            this.prompt();
+            console.log('');
+            this.rl.close();
         });
         this.rl.on('close', () => {
-            console.log(pc.gray('\nSee ya.'));
+            console.log(colors.gray('\nSee ya.'));
             process.exit(0);
         });
     }
@@ -104,6 +146,46 @@ export class RekShell {
             case 'chat':
                 await this.runAIChat(parts.slice(1));
                 return;
+            case 'whois':
+                await this.runWhois(parts[1]);
+                return;
+            case 'tls':
+            case 'ssl':
+                await this.runTLS(parts[1], parts[2] ? parseInt(parts[2]) : 443);
+                return;
+            case 'dns':
+                await this.runDNS(parts[1]);
+                return;
+            case 'rdap':
+                await this.runRDAP(parts[1]);
+                return;
+            case 'ping':
+                await this.runPing(parts[1]);
+                return;
+            case 'scrap':
+                await this.runScrap(parts[1]);
+                return;
+            case '$':
+                await this.runSelect(parts.slice(1).join(' '));
+                return;
+            case '$text':
+                await this.runSelectText(parts.slice(1).join(' '));
+                return;
+            case '$attr':
+                await this.runSelectAttr(parts[1], parts.slice(2).join(' '));
+                return;
+            case '$html':
+                await this.runSelectHtml(parts.slice(1).join(' '));
+                return;
+            case '$links':
+                await this.runSelectLinks(parts[1]);
+                return;
+            case '$images':
+                await this.runSelectImages(parts[1]);
+                return;
+            case '$table':
+                await this.runSelectTable(parts.slice(1).join(' '));
+                return;
         }
         const methods = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
         let method = 'GET';
@@ -121,12 +203,12 @@ export class RekShell {
             bodyParts = parts.slice(1);
         }
         else {
-            console.log(pc.red(`Unknown command: ${cmd}`));
+            console.log(colors.red(`Unknown command: ${cmd}`));
             return;
         }
         url = this.resolveUrl(url);
         if (!url) {
-            console.log(pc.yellow('No URL provided and no Base URL set. Use "url <url>" or provide full URL.'));
+            console.log(colors.yellow('No URL provided and no Base URL set. Use "url <url>" or provide full URL.'));
             return;
         }
         const body = {};
@@ -181,7 +263,7 @@ export class RekShell {
         let targetUrl = '';
         let users = 50;
         let duration = 300;
-        let mode = 'throughput';
+        let mode = 'realistic';
         let http2 = false;
         let rampUp = 5;
         for (const arg of args) {
@@ -208,7 +290,7 @@ export class RekShell {
         }
         targetUrl = this.resolveUrl(targetUrl);
         if (!targetUrl) {
-            console.log(pc.yellow('Target URL required. usage: load <url> users=10 duration=10s ramp=5'));
+            console.log(colors.yellow('Target URL required. usage: load <url> users=10 duration=10s ramp=5'));
             return;
         }
         const { startLoadDashboard } = await import('./load-dashboard.js');
@@ -225,7 +307,7 @@ export class RekShell {
             });
         }
         catch (e) {
-            console.error(pc.red('Load Test Failed: ' + e.message));
+            console.error(colors.red('Load Test Failed: ' + e.message));
         }
         finally {
             process.stdout.write('\x1B[?25h');
@@ -240,7 +322,7 @@ export class RekShell {
         if (!url.startsWith('http'))
             url = `https://${url}`;
         this.baseUrl = url;
-        console.log(pc.gray(`Base URL set to: ${pc.cyan(this.baseUrl)}`));
+        console.log(colors.gray(`Base URL set to: ${colors.cyan(this.baseUrl)}`));
     }
     setVariable(args) {
         const [expr] = args;
@@ -248,7 +330,7 @@ export class RekShell {
             return;
         const [key, val] = expr.split('=');
         this.variables[key] = val;
-        console.log(pc.gray(`Variable $${key} set.`));
+        console.log(colors.gray(`Variable $${key} set.`));
     }
     resolveVariables(value) {
         if (value.startsWith('$')) {
@@ -297,18 +379,18 @@ export class RekShell {
             const { UDPTransport } = await import('../../transport/udp.js');
             const transport = new UDPTransport(url);
             const msg = Object.keys(body).length ? JSON.stringify(body) : 'ping';
-            console.log(pc.gray(`UDP packet -> ${url}`));
+            console.log(colors.gray(`UDP packet -> ${url}`));
             const res = await transport.dispatch({
                 url, method: 'GET', headers: new Headers(),
                 body: msg, withHeader: () => ({}), withBody: () => ({})
             });
             const text = await res.text();
-            console.log(pc.green('✔ Sent/Received'));
+            console.log(colors.green('✔ Sent/Received'));
             if (text)
                 console.log(text);
             return;
         }
-        console.log(pc.gray(`${method} ${url}...`));
+        console.log(colors.gray(`${method} ${url}...`));
         try {
             const hasBody = Object.keys(body).length > 0;
             const res = await this.client.request(url, {
@@ -317,9 +399,9 @@ export class RekShell {
                 json: hasBody ? body : undefined
             });
             const duration = Math.round(performance.now() - startTime);
-            const statusColor = res.ok ? pc.green : pc.red;
-            console.log(`${statusColor(pc.bold(res.status))} ${statusColor(res.statusText)} ` +
-                `${pc.gray(`(${duration}ms)`)}`);
+            const statusColor = res.ok ? colors.green : colors.red;
+            console.log(`${statusColor(colors.bold(res.status))} ${statusColor(res.statusText)} ` +
+                `${colors.gray(`(${duration}ms)`)}`);
             const text = await res.text();
             const isJson = res.headers.get('content-type')?.includes('json');
             if (isJson) {
@@ -339,43 +421,594 @@ export class RekShell {
             }
         }
         catch (error) {
-            console.error(pc.red(`Error: ${error.message}`));
+            console.error(colors.red(`Error: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runWhois(domain) {
+        if (!domain) {
+            domain = this.getRootDomain() || '';
+            if (!domain) {
+                console.log(colors.yellow('Usage: whois <domain>'));
+                console.log(colors.gray('  Examples: whois google.com | whois 8.8.8.8'));
+                console.log(colors.gray('  Or set a base URL first: url https://example.com'));
+                return;
+            }
+        }
+        const maxRetries = 3;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            if (attempt === 1) {
+                console.log(colors.gray(`Looking up ${domain}...`));
+            }
+            else {
+                console.log(colors.gray(`Retrying (${attempt}/${maxRetries})...`));
+            }
+            const startTime = performance.now();
+            try {
+                const result = await whois(domain);
+                const duration = Math.round(performance.now() - startTime);
+                console.log(colors.green(`✔ WHOIS lookup completed`) + colors.gray(` (${duration}ms)`));
+                console.log(colors.gray(`Server: ${result.server}\n`));
+                const importantFields = [
+                    'domain name', 'registrar', 'registrar url',
+                    'creation date', 'registry expiry date', 'updated date',
+                    'domain status', 'name server', 'dnssec',
+                    'organization', 'orgname', 'cidr', 'netname', 'country'
+                ];
+                let foundFields = 0;
+                for (const field of importantFields) {
+                    const value = result.data[field];
+                    if (value) {
+                        const displayValue = Array.isArray(value) ? value.join(', ') : value;
+                        console.log(`  ${colors.cyan(field)}: ${displayValue}`);
+                        foundFields++;
+                    }
+                }
+                if (foundFields === 0 && Object.keys(result.data).length > 0) {
+                    console.log(colors.gray('  (showing all available fields)\n'));
+                    for (const [key, value] of Object.entries(result.data)) {
+                        if (value) {
+                            const displayValue = Array.isArray(value) ? value.join(', ') : String(value);
+                            console.log(`  ${colors.cyan(key)}: ${displayValue}`);
+                        }
+                    }
+                }
+                if (Object.keys(result.data).length === 0 && result.raw) {
+                    console.log(colors.gray('  (raw response)\n'));
+                    console.log(colors.white(result.raw.slice(0, 2000)));
+                }
+                const available = await isDomainAvailable(domain);
+                if (available) {
+                    console.log(colors.green(`\n✓ Domain appears to be available`));
+                }
+                this.lastResponse = result.data;
+                console.log('');
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                const isRetryable = error.code === 'ECONNRESET' ||
+                    error.code === 'ECONNREFUSED' ||
+                    error.code === 'ETIMEDOUT' ||
+                    error.code === 'ENOTFOUND' ||
+                    error.message?.includes('timeout') ||
+                    error.message?.includes('WHOIS query failed');
+                if (!isRetryable || attempt === maxRetries) {
+                    break;
+                }
+                await new Promise(resolve => setTimeout(resolve, 500 * attempt));
+            }
+        }
+        const errorMsg = lastError?.message || 'Unknown error';
+        const errorCode = lastError?.code;
+        console.error(colors.red(`WHOIS failed: ${errorMsg}`));
+        if (errorCode) {
+            console.error(colors.gray(`  Error code: ${errorCode}`));
+        }
+        if (lastError?.suggestions?.length) {
+            console.log(colors.yellow('  Suggestions:'));
+            for (const suggestion of lastError.suggestions) {
+                console.log(colors.gray(`    • ${suggestion}`));
+            }
+        }
+        console.log('');
+    }
+    async runTLS(host, port = 443) {
+        if (!host) {
+            host = this.getBaseDomain() || '';
+            if (!host) {
+                console.log(colors.yellow('Usage: tls <host> [port]'));
+                console.log(colors.gray('  Examples: tls google.com | tls api.stripe.com 443'));
+                console.log(colors.gray('  Or set a base URL first: url https://example.com'));
+                return;
+            }
+        }
+        else {
+            host = host.replace(/^https?:\/\//, '').split('/')[0];
+        }
+        console.log(colors.gray(`Inspecting TLS for ${host}:${port}...`));
+        const startTime = performance.now();
+        try {
+            const info = await inspectTLS(host, port);
+            const duration = Math.round(performance.now() - startTime);
+            const statusIcon = info.valid ? colors.green('✔') : colors.red('✖');
+            const statusText = info.valid ? colors.green('Valid') : colors.red('Invalid/Expired');
+            console.log(`${statusIcon} Certificate ${statusText}` + colors.gray(` (${duration}ms)\n`));
+            console.log(colors.bold('  Certificate:'));
+            console.log(`    ${colors.cyan('Subject')}: ${info.subject?.CN || info.subject?.O || 'N/A'}`);
+            console.log(`    ${colors.cyan('Issuer')}: ${info.issuer?.CN || info.issuer?.O || 'N/A'}`);
+            console.log(`    ${colors.cyan('Valid From')}: ${info.validFrom.toISOString()}`);
+            console.log(`    ${colors.cyan('Valid To')}: ${info.validTo.toISOString()}`);
+            const daysColor = info.daysRemaining < 30 ? colors.red : info.daysRemaining < 90 ? colors.yellow : colors.green;
+            console.log(`    ${colors.cyan('Days Remaining')}: ${daysColor(String(info.daysRemaining))}`);
+            console.log(colors.bold('\n  Connection:'));
+            console.log(`    ${colors.cyan('Protocol')}: ${info.protocol || 'N/A'}`);
+            console.log(`    ${colors.cyan('Cipher')}: ${info.cipher?.name || 'N/A'}`);
+            console.log(`    ${colors.cyan('Authorized')}: ${info.authorized ? colors.green('Yes') : colors.red('No')}`);
+            if (info.authorizationError) {
+                console.log(`    ${colors.cyan('Auth Error')}: ${colors.red(String(info.authorizationError))}`);
+            }
+            console.log(colors.bold('\n  Fingerprints:'));
+            console.log(`    ${colors.cyan('SHA1')}: ${info.fingerprint}`);
+            console.log(`    ${colors.cyan('SHA256')}: ${info.fingerprint256}`);
+            console.log(`    ${colors.cyan('Serial')}: ${info.serialNumber}`);
+            this.lastResponse = info;
+        }
+        catch (error) {
+            console.error(colors.red(`TLS inspection failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runDNS(domain) {
+        if (!domain) {
+            domain = this.getBaseDomain() || '';
+            if (!domain) {
+                console.log(colors.yellow('Usage: dns <domain>'));
+                console.log(colors.gray('  Examples: dns google.com | dns github.com'));
+                console.log(colors.gray('  Or set a base URL first: url https://example.com'));
+                return;
+            }
+        }
+        console.log(colors.gray(`Resolving DNS for ${domain}...`));
+        const startTime = performance.now();
+        try {
+            const [a, aaaa, mx, ns, txt, security] = await Promise.all([
+                dns.resolve4(domain).catch(() => []),
+                dns.resolve6(domain).catch(() => []),
+                dns.resolveMx(domain).catch(() => []),
+                dns.resolveNs(domain).catch(() => []),
+                dns.resolveTxt(domain).catch(() => []),
+                getSecurityRecords(domain).catch(() => ({}))
+            ]);
+            const duration = Math.round(performance.now() - startTime);
+            console.log(colors.green(`✔ DNS resolved`) + colors.gray(` (${duration}ms)\n`));
+            if (a.length) {
+                console.log(colors.bold('  A Records (IPv4):'));
+                a.forEach(ip => console.log(`    ${colors.cyan('→')} ${ip}`));
+            }
+            if (aaaa.length) {
+                console.log(colors.bold('  AAAA Records (IPv6):'));
+                aaaa.forEach(ip => console.log(`    ${colors.cyan('→')} ${ip}`));
+            }
+            if (ns.length) {
+                console.log(colors.bold('  NS Records:'));
+                ns.forEach(n => console.log(`    ${colors.cyan('→')} ${n}`));
+            }
+            if (mx.length) {
+                console.log(colors.bold('  MX Records:'));
+                mx.sort((a, b) => a.priority - b.priority)
+                    .forEach(m => console.log(`    ${colors.cyan(String(m.priority).padStart(3))} ${m.exchange}`));
+            }
+            const sec = security;
+            if (sec.spf?.length) {
+                console.log(colors.bold('  SPF:'));
+                console.log(`    ${colors.gray(sec.spf[0].slice(0, 80))}${sec.spf[0].length > 80 ? '...' : ''}`);
+            }
+            if (sec.dmarc) {
+                console.log(colors.bold('  DMARC:'));
+                console.log(`    ${colors.gray(sec.dmarc.slice(0, 80))}${sec.dmarc.length > 80 ? '...' : ''}`);
+            }
+            if (sec.caa?.issue?.length) {
+                console.log(colors.bold('  CAA:'));
+                sec.caa.issue.forEach((ca) => console.log(`    ${colors.cyan('issue')} ${ca}`));
+            }
+            this.lastResponse = { a, aaaa, mx, ns, txt, security };
+        }
+        catch (error) {
+            console.error(colors.red(`DNS lookup failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runRDAP(domain) {
+        if (!domain) {
+            domain = this.getRootDomain() || '';
+            if (!domain) {
+                console.log(colors.yellow('Usage: rdap <domain>'));
+                console.log(colors.gray('  Examples: rdap google.com | rdap 8.8.8.8'));
+                console.log(colors.gray('  Or set a base URL first: url https://example.com'));
+                return;
+            }
+        }
+        console.log(colors.gray(`RDAP lookup for ${domain}...`));
+        const startTime = performance.now();
+        try {
+            const result = await rdap(this.client, domain);
+            const duration = Math.round(performance.now() - startTime);
+            console.log(colors.green(`✔ RDAP lookup completed`) + colors.gray(` (${duration}ms)\n`));
+            if (result.status?.length) {
+                console.log(colors.bold('  Status:'));
+                result.status.forEach((s) => console.log(`    ${colors.cyan('→')} ${s}`));
+            }
+            if (result.events?.length) {
+                console.log(colors.bold('  Events:'));
+                result.events.forEach((e) => {
+                    const date = new Date(e.eventDate).toISOString().split('T')[0];
+                    console.log(`    ${colors.cyan(e.eventAction.padEnd(15))} ${date}`);
+                });
+            }
+            if (result.entities?.length) {
+                console.log(colors.bold('  Entities:'));
+                result.entities.forEach((e) => {
+                    const roles = e.roles?.join(', ') || 'unknown';
+                    console.log(`    ${colors.cyan(roles.padEnd(15))} ${e.handle || 'N/A'}`);
+                });
+            }
+            if (result.handle) {
+                console.log(`  ${colors.cyan('Handle')}: ${result.handle}`);
+            }
+            if (result.name) {
+                console.log(`  ${colors.cyan('Name')}: ${result.name}`);
+            }
+            if (result.startAddress && result.endAddress) {
+                console.log(`  ${colors.cyan('Range')}: ${result.startAddress} - ${result.endAddress}`);
+            }
+            this.lastResponse = result;
+        }
+        catch (error) {
+            console.error(colors.red(`RDAP lookup failed: ${error.message}`));
+            console.log(colors.gray('  Tip: RDAP may not be available for all TLDs. Try "whois" instead.'));
+        }
+        console.log('');
+    }
+    async runPing(host) {
+        if (!host) {
+            host = this.getBaseDomain() || '';
+            if (!host) {
+                console.log(colors.yellow('Usage: ping <host>'));
+                console.log(colors.gray('  Or set a base URL first: url https://example.com'));
+                return;
+            }
+        }
+        else {
+            host = host.replace(/^https?:\/\//, '').split('/')[0];
+        }
+        console.log(colors.gray(`Pinging ${host}...`));
+        try {
+            const { connect } = await import('node:net');
+            const port = 443;
+            const startTime = performance.now();
+            await new Promise((resolve, reject) => {
+                const socket = connect(port, host, () => {
+                    const duration = Math.round(performance.now() - startTime);
+                    console.log(colors.green(`✔ ${host}:${port} is reachable`) + colors.gray(` (${duration}ms)`));
+                    socket.end();
+                    resolve();
+                });
+                socket.on('error', reject);
+                socket.setTimeout(5000, () => {
+                    socket.destroy();
+                    reject(new Error('Connection timed out'));
+                });
+            });
+        }
+        catch (error) {
+            console.error(colors.red(`✖ ${host} is unreachable: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runScrap(url) {
+        if (!url) {
+            if (!this.baseUrl) {
+                console.log(colors.yellow('Usage: scrap <url>'));
+                console.log(colors.gray('  Examples: scrap https://news.ycombinator.com'));
+                console.log(colors.gray('  Or set a base URL first: url https://example.com'));
+                return;
+            }
+            url = this.baseUrl;
+        }
+        else if (!url.startsWith('http')) {
+            url = this.baseUrl ? `${this.baseUrl}${url.startsWith('/') ? '' : '/'}${url}` : `https://${url}`;
+        }
+        console.log(colors.gray(`Fetching ${url}...`));
+        const startTime = performance.now();
+        try {
+            const response = await this.client.get(url);
+            const html = await response.text();
+            const duration = Math.round(performance.now() - startTime);
+            this.currentDoc = await ScrapeDocument.create(html);
+            this.currentDocUrl = url;
+            const elementCount = this.currentDoc.select('*').length;
+            const title = this.currentDoc.selectFirst('title').text() || 'No title';
+            console.log(colors.green(`✔ Loaded`) + colors.gray(` (${duration}ms)`));
+            console.log(`  ${colors.cyan('Title')}: ${title}`);
+            console.log(`  ${colors.cyan('Elements')}: ${elementCount}`);
+            console.log(`  ${colors.cyan('Size')}: ${(html.length / 1024).toFixed(1)}kb`);
+            console.log(colors.gray('\n  Use $ <selector> to query, $text, $attr, $links, $images, $table'));
+        }
+        catch (error) {
+            console.error(colors.red(`Scrape failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelect(selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        if (!selector) {
+            console.log(colors.yellow('Usage: $ <selector>'));
+            console.log(colors.gray('  Examples: $ h1 | $ .title | $ a[href*="article"]'));
+            return;
+        }
+        try {
+            const elements = this.currentDoc.select(selector);
+            const count = elements.length;
+            console.log(colors.cyan(`Found ${count} element(s)`));
+            if (count > 0 && count <= 10) {
+                elements.each((el, i) => {
+                    const text = el.text().slice(0, 80).replace(/\s+/g, ' ').trim();
+                    console.log(`  ${colors.gray(`${i + 1}.`)} ${text}${text.length >= 80 ? '...' : ''}`);
+                });
+            }
+            else if (count > 10) {
+                console.log(colors.gray('  (showing first 10)'));
+                let shown = 0;
+                elements.each((el, i) => {
+                    if (shown >= 10)
+                        return;
+                    const text = el.text().slice(0, 80).replace(/\s+/g, ' ').trim();
+                    console.log(`  ${colors.gray(`${i + 1}.`)} ${text}${text.length >= 80 ? '...' : ''}`);
+                    shown++;
+                });
+            }
+            this.lastResponse = { count, selector };
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelectText(selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        if (!selector) {
+            console.log(colors.yellow('Usage: $text <selector>'));
+            return;
+        }
+        try {
+            const elements = this.currentDoc.select(selector);
+            const texts = [];
+            elements.each((el, i) => {
+                const text = el.text().trim();
+                if (text) {
+                    texts.push(text);
+                    console.log(`${colors.gray(`${i + 1}.`)} ${text.slice(0, 200)}${text.length > 200 ? '...' : ''}`);
+                }
+            });
+            this.lastResponse = texts;
+            console.log(colors.gray(`\n  ${texts.length} text item(s) extracted`));
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelectAttr(attrName, selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        if (!attrName || !selector) {
+            console.log(colors.yellow('Usage: $attr <attribute> <selector>'));
+            console.log(colors.gray('  Examples: $attr href a | $attr src img'));
+            return;
+        }
+        try {
+            const elements = this.currentDoc.select(selector);
+            const attrs = [];
+            elements.each((el, i) => {
+                const value = el.attr(attrName);
+                if (value) {
+                    attrs.push(value);
+                    console.log(`${colors.gray(`${i + 1}.`)} ${value}`);
+                }
+            });
+            this.lastResponse = attrs;
+            console.log(colors.gray(`\n  ${attrs.length} attribute(s) extracted`));
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelectHtml(selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        if (!selector) {
+            console.log(colors.yellow('Usage: $html <selector>'));
+            return;
+        }
+        try {
+            const element = this.currentDoc.selectFirst(selector);
+            const html = element.html();
+            if (html) {
+                console.log(html.slice(0, 1000));
+                if (html.length > 1000) {
+                    console.log(colors.gray(`\n  ... (${html.length} chars total)`));
+                }
+                this.lastResponse = html;
+            }
+            else {
+                console.log(colors.gray('No element found'));
+            }
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelectLinks(selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        try {
+            const linkSelector = selector || 'a[href]';
+            const elements = this.currentDoc.select(linkSelector);
+            const links = [];
+            elements.each((el, i) => {
+                const href = el.attr('href');
+                const text = el.text().trim().slice(0, 50);
+                if (href) {
+                    links.push({ text, href });
+                    if (i < 20) {
+                        console.log(`${colors.gray(`${i + 1}.`)} ${colors.cyan(text || '(no text)')} ${colors.gray('→')} ${href}`);
+                    }
+                }
+            });
+            if (links.length > 20) {
+                console.log(colors.gray(`  ... and ${links.length - 20} more links`));
+            }
+            this.lastResponse = links;
+            console.log(colors.gray(`\n  ${links.length} link(s) found`));
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelectImages(selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        try {
+            const imgSelector = selector || 'img[src]';
+            const elements = this.currentDoc.select(imgSelector);
+            const images = [];
+            elements.each((el, i) => {
+                const src = el.attr('src');
+                const alt = el.attr('alt') || '';
+                if (src) {
+                    images.push({ alt, src });
+                    if (i < 20) {
+                        console.log(`${colors.gray(`${i + 1}.`)} ${colors.cyan(alt.slice(0, 30) || '(no alt)')} ${colors.gray('→')} ${src.slice(0, 60)}`);
+                    }
+                }
+            });
+            if (images.length > 20) {
+                console.log(colors.gray(`  ... and ${images.length - 20} more images`));
+            }
+            this.lastResponse = images;
+            console.log(colors.gray(`\n  ${images.length} image(s) found`));
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runSelectTable(selector) {
+        if (!this.currentDoc) {
+            console.log(colors.yellow('No document loaded. Use "scrap <url>" first.'));
+            return;
+        }
+        if (!selector) {
+            console.log(colors.yellow('Usage: $table <selector>'));
+            console.log(colors.gray('  Examples: $table table | $table .data-table'));
+            return;
+        }
+        try {
+            const tables = this.currentDoc.tables(selector);
+            if (tables.length === 0) {
+                console.log(colors.gray('No tables found'));
+                return;
+            }
+            tables.forEach((table, tableIndex) => {
+                console.log(colors.bold(`\nTable ${tableIndex + 1}:`));
+                if (table.headers.length > 0) {
+                    console.log(colors.cyan('  Headers: ') + table.headers.join(' | '));
+                }
+                console.log(colors.cyan(`  Rows: `) + table.rows.length);
+                table.rows.slice(0, 5).forEach((row, i) => {
+                    const rowStr = row.map(cell => cell.slice(0, 20)).join(' | ');
+                    console.log(`  ${colors.gray(`${i + 1}.`)} ${rowStr}`);
+                });
+                if (table.rows.length > 5) {
+                    console.log(colors.gray(`  ... and ${table.rows.length - 5} more rows`));
+                }
+            });
+            this.lastResponse = tables;
+        }
+        catch (error) {
+            console.error(colors.red(`Query failed: ${error.message}`));
         }
         console.log('');
     }
     printHelp() {
         console.log(`
-  ${pc.bold(pc.cyan('Rek Console Help'))}
+  ${colors.bold(colors.cyan('Rek Console Help'))}
+
+  ${colors.bold('Core Commands:')}
+    ${colors.green('url <url>')}           Set persistent Base URL.
+    ${colors.green('set <key>=<val>')}     Set a session variable.
+    ${colors.green('vars')}                List all session variables.
+    ${colors.green('clear')}               Clear the screen.
+    ${colors.green('exit')}                Exit the console.
+
+  ${colors.bold('HTTP Requests:')}
+    ${colors.green('<method> <path>')}     Execute HTTP request (GET, POST, PUT, DELETE, etc).
+                             ${colors.gray('Params:')} ${colors.white('key=value')} (string) or ${colors.white('key:=value')} (typed).
+                             ${colors.gray('Headers:')} ${colors.white('Key:Value')}
 
-  ${pc.bold('Core Commands:')}
-    ${pc.green('url <url>')}           Set persistent Base URL.
-    ${pc.green('set <key>=<val>')}     Set a session variable.
-    ${pc.green('vars')}                List all session variables.
-    ${pc.green('clear')}               Clear the screen.
-    ${pc.green('exit')}                Exit the console.
+  ${colors.bold('Advanced Tools:')}
+    ${colors.green('load <url>')}          Run Load Test.
+                             ${colors.gray('Options:')}
+                             ${colors.white('users=50')}      ${colors.gray('Concurrent users')}
+                             ${colors.white('duration=300')}  ${colors.gray('Duration in seconds')}
+                             ${colors.white('ramp=5')}        ${colors.gray('Ramp-up time in seconds')}
+                             ${colors.white('mode=realistic')} ${colors.gray('realistic | throughput | stress')}
+                             ${colors.white('http2=false')}   ${colors.gray('Force HTTP/2')}
 
-  ${pc.bold('HTTP Requests:')}
-    ${pc.green('<method> <path>')}     Execute HTTP request (GET, POST, PUT, DELETE, etc).
-                             ${pc.gray('Params:')} ${pc.white('key=value')} (string) or ${pc.white('key:=value')} (typed).
-                             ${pc.gray('Headers:')} ${pc.white('Key:Value')}
+    ${colors.green('chat <provider>')}     Start AI Chat.
+                             ${colors.gray('Providers:')} ${colors.white('openai')}, ${colors.white('anthropic')}
+                             ${colors.gray('Arg:')} ${colors.white('model=...')} (optional)
 
-  ${pc.bold('Advanced Tools:')}
-    ${pc.green('load <url>')}          Run Load Test.
-                             ${pc.gray('Options:')}
-                             ${pc.white('users=50')}      ${pc.gray('Concurrent users')}
-                             ${pc.white('duration=300')}  ${pc.gray('Duration in seconds')}
-                             ${pc.white('ramp=5')}        ${pc.gray('Ramp-up time in seconds')}
-                             ${pc.white('mode=throughput')}${pc.gray('throughput | stress | realistic')}
-                             ${pc.white('http2=false')}   ${pc.gray('Force HTTP/2')}
+    ${colors.green('ws <url>')}            Start interactive WebSocket session.
+    ${colors.green('udp <url>')}           Send UDP packet.
 
-    ${pc.green('chat <provider>')}     Start AI Chat.
-                             ${pc.gray('Providers:')} ${pc.white('openai')}, ${pc.white('anthropic')}
-                             ${pc.gray('Arg:')} ${pc.white('model=...')} (optional)
+  ${colors.bold('Network Tools:')}
+    ${colors.green('whois <domain>')}      WHOIS lookup (domain or IP).
+    ${colors.green('tls <host> [port]')}   Inspect TLS/SSL certificate.
+    ${colors.green('dns <domain>')}        Full DNS lookup (A, AAAA, MX, NS, SPF, DMARC).
+    ${colors.green('rdap <domain>')}       RDAP lookup (modern WHOIS).
+    ${colors.green('ping <host>')}         Quick TCP connectivity check.
 
-    ${pc.green('ws <url>')}            Start interactive WebSocket session.
-    ${pc.green('udp <url>')}           Send UDP packet.
+  ${colors.bold('Web Scraping:')}
+    ${colors.green('scrap <url>')}         Fetch and parse HTML document.
+    ${colors.green('$ <selector>')}        Query elements (CSS selector).
+    ${colors.green('$text <selector>')}    Extract text content.
+    ${colors.green('$attr <name> <sel>')}  Extract attribute values.
+    ${colors.green('$html <selector>')}    Get inner HTML.
+    ${colors.green('$links [selector]')}   List all links.
+    ${colors.green('$images [selector]')}  List all images.
+    ${colors.green('$table <selector>')}   Extract table as data.
 
-  ${pc.bold('Examples:')}
+  ${colors.bold('Examples:')}
     › url httpbin.org
     › get /json
     › post /post name="Neo" active:=true role:Admin

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

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

@@ -120,11 +120,26 @@ async function queryWhoisServer(server, query, port, timeout) {
         });
         socket.on('error', (error) => {
             clearTimeout(timeoutId);
-            reject(new ReckerError(`WHOIS query failed: ${error.message}`, undefined, undefined, [
+            const errorDetail = error.message || error.code || 'Connection failed';
+            const err = new ReckerError(`WHOIS query failed: ${errorDetail}`, undefined, undefined, [
                 'Verify the WHOIS server is reachable and correct.',
                 'Check network/firewall settings blocking WHOIS port 43.',
                 'Retry the query; transient network issues can occur.'
-            ]));
+            ]);
+            err.code = error.code;
+            reject(err);
+        });
+        socket.on('close', (hadError) => {
+            clearTimeout(timeoutId);
+            if (hadError && !response) {
+                const err = new ReckerError('WHOIS connection closed unexpectedly', undefined, undefined, [
+                    'The WHOIS server may be rate limiting requests.',
+                    'Try again in a few seconds.',
+                    'Some TLDs have unreliable WHOIS servers.'
+                ]);
+                err.code = 'ECONNRESET';
+                reject(err);
+            }
         });
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",