recker 1.0.7 → 1.0.8

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

@@ -22,6 +22,11 @@ export declare class RekShell {
     private resolveVariables;
     private resolveUrl;
     private executeRequest;
+    private runWhois;
+    private runTLS;
+    private runDNS;
+    private runRDAP;
+    private runPing;
     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":"AAgCA,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;IAWJ,KAAK;IA8BlB,OAAO,CAAC,MAAM;YAKA,aAAa;YAgHb,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;YA8CR,MAAM;YAuDN,MAAM;YAuEN,OAAO;YA2DP,OAAO;IAoCrB,OAAO,CAAC,SAAS;CA+ClB"}

package/dist/cli/tui/shell.js

@@ -1,13 +1,23 @@
 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 { 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 pc 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 {
@@ -41,7 +51,12 @@ export class RekShell {
         return `${base} ${pc.magenta('›')} `;
     }
     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',
+            'help', 'clear', 'exit', 'set', 'url', 'vars'
+        ];
         const hits = commands.filter((c) => c.startsWith(line));
         return [hits.length ? hits : commands, line];
     }
@@ -104,6 +119,22 @@ 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;
         }
         const methods = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
         let method = 'GET';
@@ -343,6 +374,216 @@ export class RekShell {
         }
         console.log('');
     }
+    async runWhois(domain) {
+        if (!domain) {
+            console.log(pc.yellow('Usage: whois <domain>'));
+            console.log(pc.gray('  Examples: whois google.com | whois 8.8.8.8'));
+            return;
+        }
+        console.log(pc.gray(`Looking up ${domain}...`));
+        const startTime = performance.now();
+        try {
+            const result = await whois(domain);
+            const duration = Math.round(performance.now() - startTime);
+            console.log(pc.green(`✔ WHOIS lookup completed`) + pc.gray(` (${duration}ms)`));
+            console.log(pc.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'
+            ];
+            for (const field of importantFields) {
+                const value = result.data[field];
+                if (value) {
+                    const displayValue = Array.isArray(value) ? value.join(', ') : value;
+                    console.log(`  ${pc.cyan(field)}: ${displayValue}`);
+                }
+            }
+            const available = await isDomainAvailable(domain);
+            if (available) {
+                console.log(pc.green(`\n✓ Domain appears to be available`));
+            }
+            this.lastResponse = result.data;
+        }
+        catch (error) {
+            console.error(pc.red(`WHOIS failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runTLS(host, port = 443) {
+        if (!host) {
+            console.log(pc.yellow('Usage: tls <host> [port]'));
+            console.log(pc.gray('  Examples: tls google.com | tls api.stripe.com 443'));
+            return;
+        }
+        host = host.replace(/^https?:\/\//, '').split('/')[0];
+        console.log(pc.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 ? pc.green('✔') : pc.red('✖');
+            const statusText = info.valid ? pc.green('Valid') : pc.red('Invalid/Expired');
+            console.log(`${statusIcon} Certificate ${statusText}` + pc.gray(` (${duration}ms)\n`));
+            console.log(pc.bold('  Certificate:'));
+            console.log(`    ${pc.cyan('Subject')}: ${info.subject?.CN || info.subject?.O || 'N/A'}`);
+            console.log(`    ${pc.cyan('Issuer')}: ${info.issuer?.CN || info.issuer?.O || 'N/A'}`);
+            console.log(`    ${pc.cyan('Valid From')}: ${info.validFrom.toISOString()}`);
+            console.log(`    ${pc.cyan('Valid To')}: ${info.validTo.toISOString()}`);
+            const daysColor = info.daysRemaining < 30 ? pc.red : info.daysRemaining < 90 ? pc.yellow : pc.green;
+            console.log(`    ${pc.cyan('Days Remaining')}: ${daysColor(String(info.daysRemaining))}`);
+            console.log(pc.bold('\n  Connection:'));
+            console.log(`    ${pc.cyan('Protocol')}: ${info.protocol || 'N/A'}`);
+            console.log(`    ${pc.cyan('Cipher')}: ${info.cipher?.name || 'N/A'}`);
+            console.log(`    ${pc.cyan('Authorized')}: ${info.authorized ? pc.green('Yes') : pc.red('No')}`);
+            if (info.authorizationError) {
+                console.log(`    ${pc.cyan('Auth Error')}: ${pc.red(String(info.authorizationError))}`);
+            }
+            console.log(pc.bold('\n  Fingerprints:'));
+            console.log(`    ${pc.cyan('SHA1')}: ${info.fingerprint}`);
+            console.log(`    ${pc.cyan('SHA256')}: ${info.fingerprint256}`);
+            console.log(`    ${pc.cyan('Serial')}: ${info.serialNumber}`);
+            this.lastResponse = info;
+        }
+        catch (error) {
+            console.error(pc.red(`TLS inspection failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runDNS(domain) {
+        if (!domain) {
+            console.log(pc.yellow('Usage: dns <domain>'));
+            console.log(pc.gray('  Examples: dns google.com | dns github.com'));
+            return;
+        }
+        console.log(pc.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(pc.green(`✔ DNS resolved`) + pc.gray(` (${duration}ms)\n`));
+            if (a.length) {
+                console.log(pc.bold('  A Records (IPv4):'));
+                a.forEach(ip => console.log(`    ${pc.cyan('→')} ${ip}`));
+            }
+            if (aaaa.length) {
+                console.log(pc.bold('  AAAA Records (IPv6):'));
+                aaaa.forEach(ip => console.log(`    ${pc.cyan('→')} ${ip}`));
+            }
+            if (ns.length) {
+                console.log(pc.bold('  NS Records:'));
+                ns.forEach(n => console.log(`    ${pc.cyan('→')} ${n}`));
+            }
+            if (mx.length) {
+                console.log(pc.bold('  MX Records:'));
+                mx.sort((a, b) => a.priority - b.priority)
+                    .forEach(m => console.log(`    ${pc.cyan(String(m.priority).padStart(3))} ${m.exchange}`));
+            }
+            const sec = security;
+            if (sec.spf?.length) {
+                console.log(pc.bold('  SPF:'));
+                console.log(`    ${pc.gray(sec.spf[0].slice(0, 80))}${sec.spf[0].length > 80 ? '...' : ''}`);
+            }
+            if (sec.dmarc) {
+                console.log(pc.bold('  DMARC:'));
+                console.log(`    ${pc.gray(sec.dmarc.slice(0, 80))}${sec.dmarc.length > 80 ? '...' : ''}`);
+            }
+            if (sec.caa?.issue?.length) {
+                console.log(pc.bold('  CAA:'));
+                sec.caa.issue.forEach((ca) => console.log(`    ${pc.cyan('issue')} ${ca}`));
+            }
+            this.lastResponse = { a, aaaa, mx, ns, txt, security };
+        }
+        catch (error) {
+            console.error(pc.red(`DNS lookup failed: ${error.message}`));
+        }
+        console.log('');
+    }
+    async runRDAP(domain) {
+        if (!domain) {
+            console.log(pc.yellow('Usage: rdap <domain>'));
+            console.log(pc.gray('  Examples: rdap google.com | rdap 8.8.8.8'));
+            return;
+        }
+        console.log(pc.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(pc.green(`✔ RDAP lookup completed`) + pc.gray(` (${duration}ms)\n`));
+            if (result.status?.length) {
+                console.log(pc.bold('  Status:'));
+                result.status.forEach((s) => console.log(`    ${pc.cyan('→')} ${s}`));
+            }
+            if (result.events?.length) {
+                console.log(pc.bold('  Events:'));
+                result.events.forEach((e) => {
+                    const date = new Date(e.eventDate).toISOString().split('T')[0];
+                    console.log(`    ${pc.cyan(e.eventAction.padEnd(15))} ${date}`);
+                });
+            }
+            if (result.entities?.length) {
+                console.log(pc.bold('  Entities:'));
+                result.entities.forEach((e) => {
+                    const roles = e.roles?.join(', ') || 'unknown';
+                    console.log(`    ${pc.cyan(roles.padEnd(15))} ${e.handle || 'N/A'}`);
+                });
+            }
+            if (result.handle) {
+                console.log(`  ${pc.cyan('Handle')}: ${result.handle}`);
+            }
+            if (result.name) {
+                console.log(`  ${pc.cyan('Name')}: ${result.name}`);
+            }
+            if (result.startAddress && result.endAddress) {
+                console.log(`  ${pc.cyan('Range')}: ${result.startAddress} - ${result.endAddress}`);
+            }
+            this.lastResponse = result;
+        }
+        catch (error) {
+            console.error(pc.red(`RDAP lookup failed: ${error.message}`));
+            console.log(pc.gray('  Tip: RDAP may not be available for all TLDs. Try "whois" instead.'));
+        }
+        console.log('');
+    }
+    async runPing(host) {
+        if (!host) {
+            console.log(pc.yellow('Usage: ping <host>'));
+            return;
+        }
+        host = host.replace(/^https?:\/\//, '').split('/')[0];
+        console.log(pc.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(pc.green(`✔ ${host}:${port} is reachable`) + pc.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(pc.red(`✖ ${host} is unreachable: ${error.message}`));
+        }
+        console.log('');
+    }
     printHelp() {
         console.log(`
   ${pc.bold(pc.cyan('Rek Console Help'))}
@@ -375,6 +616,13 @@ export class RekShell {
     ${pc.green('ws <url>')}            Start interactive WebSocket session.
     ${pc.green('udp <url>')}           Send UDP packet.
 
+  ${pc.bold('Network Tools:')}
+    ${pc.green('whois <domain>')}      WHOIS lookup (domain or IP).
+    ${pc.green('tls <host> [port]')}   Inspect TLS/SSL certificate.
+    ${pc.green('dns <domain>')}        Full DNS lookup (A, AAAA, MX, NS, SPF, DMARC).
+    ${pc.green('rdap <domain>')}       RDAP lookup (modern WHOIS).
+    ${pc.green('ping <host>')}         Quick TCP connectivity check.
+
   ${pc.bold('Examples:')}
     › url httpbin.org
     › get /json

package/package.json

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