recker 1.0.14 → 1.0.15-next.3794a15

package/README.md

@@ -1,158 +1,136 @@
-# Recker
-
 <div align="center">
 
-<img src="docs/assets/logo.svg" alt="Recker Logo" width="200" />
+# ⚡ Recker
 
-### The HTTP SDK for the AI Era
+### The Network SDK for the AI Era
 
-**Fast as infrastructure demands. AI-ready from the first byte. Observable down to the millisecond. Resilient when everything else fails.**
+**Zero-config HTTP. Multi-protocol support. AI-native streaming. Observable to the millisecond.**
 
 [![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)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-18+-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
-[![Coverage](https://img.shields.io/badge/coverage-85%25-F5A623?style=flat-square)](https://github.com/forattini-dev/recker)
+[![Coverage](https://img.shields.io/badge/coverage-90%25-34C759?style=flat-square)](https://github.com/forattini-dev/recker)
 [![License](https://img.shields.io/npm/l/recker.svg?style=flat-square&color=007AFF)](https://github.com/forattini-dev/recker/blob/main/LICENSE)
 
-[Documentation](https://forattini-dev.github.io/recker) · [Examples](./docs/examples/README.md) · [Migration](./docs/migration.md)
+[Documentation](https://forattini-dev.github.io/recker) · [API Reference](./docs/reference/01-api.md) · [Examples](./docs/examples/README.md)
 
 </div>
 
 ---
 
-## 📦 Install
+## Install
 
 ```bash
 npm install recker
 ```
 
-## 🚀 Quick Start
+## Quick Start
 
 ```typescript
-import { createClient } from 'recker';
+import { get, post, whois, dns } from 'recker';
+
+// HTTP - zero config
+const users = await get('https://api.example.com/users').json();
+await post('https://api.example.com/users', { json: { name: 'John' } });
 
-const client = createClient({ baseUrl: 'https://api.example.com' });
+// WHOIS
+const info = await whois('github.com');
 
-// GET with JSON
-const users = await client.get('/users').json();
+// DNS
+const ips = await dns('google.com');
+```
+
+### Unified Namespace
 
-// POST with body
-await client.post('/users', { json: { name: 'John' } });
+```typescript
+import { recker } from 'recker';
 
-// Path params + query
-await client.get('/users/:id', { params: { id: '123', expand: 'profile' } });
+// Everything in one place
+await recker.get('https://api.example.com/users').json();
+await recker.whois('github.com');
+await recker.dns('google.com');
+await recker.ai.chat('Hello!');
+
+const socket = recker.ws('wss://api.example.com/ws');
 ```
 
-## ✨ Why Recker?
+### With Configuration
+
+```typescript
+import { createClient } from 'recker';
+
+const api = createClient({
+  baseUrl: 'https://api.example.com',
+  headers: { 'Authorization': 'Bearer token' },
+  timeout: 10000,
+  retry: { maxAttempts: 3 }
+});
+
+const user = await api.get('/users/:id', { params: { id: '123' } }).json();
+```
 
-Recker isn't just another HTTP client. It's a **complete orchestration layer** designed for modern, data-intensive applications.
+## Features
 
 | Feature | Description |
 |:---|:---|
-| 🔮 **19 HTTP Methods** | Beyond CRUD: WebDAV, CDN Purging, and specialized verbs. |
-| 🤖 **AI-First** | Native Server-Sent Events (SSE) parsing optimized for LLMs. |
-| 🕷️ **Scraping Ready** | jQuery-like HTML parsing, HLS downloading, and proxy rotation. |
-| 🛡️ **Security Suite** | Built-in SSL inspection, WHOIS/RDAP, and DNS analysis. |
-| ⚡ **Performance** | Connection pooling, deduplication, and deep network metrics. |
-| 🛡️ **Resilience** | Circuit breakers, smart retries, and rate limit awareness. |
+| **Zero Config** | Direct functions work out of the box. No setup required. |
+| **Multi-Protocol** | HTTP, WebSocket, DNS, WHOIS, FTP, SFTP, Telnet in one SDK. |
+| **AI-Native** | SSE streaming, token counting, provider abstraction. |
+| **Type-Safe** | Full TypeScript with Zod schema validation. |
+| **Observable** | DNS/TCP/TLS/TTFB timing breakdown per request. |
+| **Resilient** | Retry, circuit breaker, rate limiting, deduplication. |
 
-## 💡 Feature Highlights
+## Highlights
 
-### Stream AI Responses
-Handle LLM streams effortlessly with the `.sse()` iterator.
+### AI Streaming
 
 ```typescript
-for await (const event of client.post('/v1/chat/completions', {
-  json: { model: 'gpt-5', messages, stream: true }
-}).sse()) {
-  process.stdout.write(event.data);
+for await (const event of recker.ai.stream({
+  model: 'gpt-4',
+  messages: [{ role: 'user', content: 'Hello!' }]
+})) {
+  process.stdout.write(event.choices[0]?.delta?.content || '');
 }
 ```
 
-### Scrape & Extract
-Turn any webpage into structured data with the `.scrape()` method.
+### Request Timing
+
+```typescript
+const response = await get('https://api.example.com/data');
+console.log(response.timings);
+// { dns: 12, tcp: 8, tls: 45, firstByte: 23, total: 156 }
+```
+
+### Scraping
 
 ```typescript
 const doc = await client.scrape('https://example.com');
 const titles = doc.selectAll('h1').map(el => el.text());
 ```
 
-### Reliability Built-in
-Configure advanced retry policies in declarative style.
+### Circuit Breaker
 
 ```typescript
+import { createClient, circuitBreaker } from 'recker';
+
 const client = createClient({
+  baseUrl: 'https://api.example.com',
   plugins: [
-    retry({ maxAttempts: 3, backoff: 'exponential', jitter: true })
+    circuitBreaker({ threshold: 5, resetTimeout: 30000 })
   ]
 });
 ```
 
-### Deep Observability
-Know exactly where your latency comes from.
-
-```typescript
-const { timings } = await client.get('/api/data');
-console.log(timings);
-// { dns: 12ms, tcp: 8ms, tls: 45ms, firstByte: 23ms, total: 156ms }
-```
+## Documentation
 
-## 📚 Documentation
+- **[Quick Start](./docs/http/01-quickstart.md)** - Get running in 2 minutes
+- **[API Reference](./docs/reference/01-api.md)** - Complete API documentation
+- **[Configuration](./docs/http/05-configuration.md)** - Client options
+- **[Plugins](./docs/http/10-plugins.md)** - Extend functionality
+- **[AI Integration](./docs/ai/01-overview.md)** - OpenAI, Anthropic, and more
+- **[Protocols](./docs/protocols/01-websocket.md)** - WebSocket, DNS, WHOIS
 
-**Getting Started**
-- [Installation](./docs/getting-started/installation.md)
-- [Quick Start](./docs/http/01-quickstart.md)
-- [Client Configuration](./docs/http/05-configuration.md)
-
-**Core Features**
-- [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/http/13-graphql.md)
-- [Scraping](./docs/http/14-scraping.md)
-- [Plugins](./docs/http/10-plugins.md)
-
-**Reference**
-- [API Reference](./docs/reference/01-api.md)
-- [Troubleshooting](./docs/reference/05-troubleshooting.md)
-- [Examples](./docs/examples/README.md)
-
-## ❤️ Acknowledgements
-
-At Recker, we are passionate about these incredible open-source technologies. We are here to celebrate the past achievements that shaped the internet as we know it today, and to prepare ourselves for the future of web development.
-
-Recker stands on the shoulders of giants. We extend our deepest gratitude to these projects:
-
-<div align="center">
-
-| | | |
-|:---|:---|:---|
-| **[Apollo Client](https://github.com/apollographql/apollo-client)** | **[Axios](https://github.com/axios/axios)** | **[Cheerio](https://github.com/cheeriojs/cheerio)** |
-| **[Cookie](https://github.com/jshttp/cookie)** | **[Got](https://github.com/sindresorhus/got)** | **[GraphQL.js](https://github.com/graphql/graphql-js)** |
-| **[Ky](https://github.com/sindresorhus/ky)** | **[Needle](https://github.com/tomas/needle)** | **[Node-libcurl](https://github.com/JCMais/node-libcurl)** |
-| **[SuperAgent](https://github.com/ladjs/superagent)** | **[Undici](https://github.com/nodejs/undici)** | **[WS](https://github.com/websockets/ws)** |
-
-</div>
-
-## 🤝 Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
-
-## 📄 License
+## License
 
 MIT © [Forattini](https://github.com/forattini-dev)
-
----
-
-<div align="center">
-
-**Built for the AI era.**
-
-[Documentation](https://forattini-dev.github.io/recker) · [GitHub](https://github.com/forattini-dev/recker) · [npm](https://www.npmjs.com/package/recker)
-
-</div>

package/dist/ai/client.d.ts

@@ -1,5 +1,5 @@
 import type { AIClient, AIClientConfig, ChatOptions, AIResponse, AIStream, EmbedOptions, EmbedResponse, AIMetrics } from '../types/ai.js';
-export declare class AIClientImpl implements AIClient {
+export declare class UnifiedAIClient implements AIClient {
     private config;
     private providers;
     private _metrics;
@@ -19,6 +19,5 @@ export declare class AIClientImpl implements AIClient {
     private logResponse;
     private sleep;
 }
-export declare function createAIClient(config?: AIClientConfig): AIClient;
-export declare const ai: AIClient;
+export declare function createAI(config?: AIClientConfig): AIClient;
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,SAAS,EAGV,MAAM,gBAAgB,CAAC;AAgIxB,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAAsC;gBAE1C,MAAM,GAAE,cAAmB;IAevC,IAAI,OAAO,IAAI,SAAS,CAEvB;IAKK,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BhE,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ/C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ1D,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,QAAQ;IAwBhD,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,gBAAgB;YAYV,gBAAgB;IAwE9B,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,KAAK;CAGd;AAKD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,CAEhE;AAKD,eAAO,MAAM,EAAE,UAAmB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,SAAS,EAGV,MAAM,gBAAgB,CAAC;AA+IxB,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAA4C;gBAEhD,MAAM,GAAE,cAAmB;IAevC,IAAI,OAAO,IAAI,SAAS,CAEvB;IAKK,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BhE,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ/C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ1D,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,QAAQ;IAwBhD,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,gBAAgB;YAYV,gBAAgB;IAwE9B,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,KAAK;CAGd;AAiBD,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,CAE1D"}

package/dist/ai/client.js

@@ -1,7 +1,7 @@
 import { AIError, RateLimitError, ContextLengthError, OverloadedError } from './providers/base.js';
 import { OpenAIProvider } from './providers/openai.js';
 import { AnthropicProvider } from './providers/anthropic.js';
-class AIMetricsImpl {
+class AIMetricsTracker {
     data = {
         totalRequests: 0,
         totalTokens: 0,
@@ -87,10 +87,10 @@ class AIMetricsImpl {
         };
     }
 }
-export class AIClientImpl {
+export class UnifiedAIClient {
     config;
     providers = new Map();
-    _metrics = new AIMetricsImpl();
+    _metrics = new AIMetricsTracker();
     constructor(config = {}) {
         this.config = {
             defaultProvider: 'openai',
@@ -283,7 +283,6 @@ export class AIClientImpl {
         return new Promise((resolve) => setTimeout(resolve, ms));
     }
 }
-export function createAIClient(config) {
-    return new AIClientImpl(config);
+export function createAI(config) {
+    return new UnifiedAIClient(config);
 }
-export const ai = createAIClient();

package/dist/ai/index.d.ts

@@ -1,4 +1,4 @@
-export { AIClientImpl, createAIClient, ai } from './client.js';
+export { UnifiedAIClient, createAI } from './client.js';
 export { BaseAIProvider, AIError, RateLimitError, ContextLengthError, OverloadedError, AuthenticationError } from './providers/base.js';
 export { OpenAIProvider } from './providers/openai.js';
 export { AnthropicProvider } from './providers/anthropic.js';

package/dist/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AA2DA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACxI,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG1G,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAEV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,QAAQ,EAGR,UAAU,EACV,QAAQ,EACR,SAAS,EAGT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EAGZ,UAAU,EACV,aAAa,EAGb,eAAe,EACf,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EAGR,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EAGZ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAGhB,SAAS,EACT,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,KAAK,GACN,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AA2DA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACxI,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG1G,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAEV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,QAAQ,EAGR,UAAU,EACV,QAAQ,EACR,SAAS,EAGT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EAGZ,UAAU,EACV,aAAa,EAGb,eAAe,EACf,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EAGR,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EAGZ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAGhB,SAAS,EACT,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,KAAK,GACN,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/ai/index.js

@@ -1,4 +1,4 @@
-export { AIClientImpl, createAIClient, ai } from './client.js';
+export { UnifiedAIClient, createAI } from './client.js';
 export { BaseAIProvider, AIError, RateLimitError, ContextLengthError, OverloadedError, AuthenticationError } from './providers/base.js';
 export { OpenAIProvider } from './providers/openai.js';
 export { AnthropicProvider } from './providers/anthropic.js';

package/dist/cli/tui/ai-chat.js

@@ -1,6 +1,6 @@
 import readline from 'node:readline';
 import pc from '../../utils/colors.js';
-import { createAIClient } from '../../ai/client.js';
+import { createAI } from '../../ai/client.js';
 export async function startAIChat(rl, provider = 'openai', apiKey, model) {
     console.clear();
     console.log(pc.bold(pc.magenta(`🤖 Rek AI Chat (${provider})`)));
@@ -14,7 +14,7 @@ Warning: No API Key found for ${provider}.`));
         console.log(`Example: set ${envKey}=sk-... inside the shell.`);
         return;
     }
-    const client = createAIClient({
+    const client = createAI({
         defaultProvider: provider,
         providers: {
             [provider]: { apiKey: key }

package/dist/dns/index.d.ts

@@ -0,0 +1,35 @@
+import { type DnsSecurityRecords } from '../utils/dns-toolkit.js';
+export { createLookupFunction, customDNSLookup } from '../utils/dns.js';
+export { createDoHLookup } from '../utils/doh.js';
+export { getSecurityRecords, type DnsSecurityRecords } from '../utils/dns-toolkit.js';
+export type { DNSOptions } from '../types/index.js';
+export type RecordType = 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' | 'SOA' | 'SRV' | 'CAA' | 'PTR';
+export type DoHProvider = 'cloudflare' | 'google' | 'quad9' | 'system';
+export interface DNSClientOptions {
+    provider?: DoHProvider;
+    timeout?: number;
+    debug?: boolean;
+    servers?: string[];
+}
+export declare class DNSClient {
+    private options;
+    constructor(options?: DNSClientOptions);
+    private log;
+    resolve(hostname: string, type?: RecordType): Promise<string[]>;
+    resolve4(hostname: string): Promise<string[]>;
+    resolve6(hostname: string): Promise<string[]>;
+    resolveMx(hostname: string): Promise<{
+        priority: number;
+        exchange: string;
+    }[]>;
+    resolveTxt(hostname: string): Promise<string[]>;
+    resolveNs(hostname: string): Promise<string[]>;
+    resolveSoa(hostname: string): Promise<import("dns").SoaRecord>;
+    resolveSrv(hostname: string): Promise<import("dns").SrvRecord[]>;
+    resolveCaa(hostname: string): Promise<import("dns").CaaRecord[]>;
+    reverse(ip: string): Promise<string[]>;
+    resolveAll(hostname: string): Promise<Record<string, unknown[]>>;
+    getSecurityRecords(domain: string): Promise<DnsSecurityRecords>;
+}
+export declare function createDNS(options?: DNSClientOptions): DNSClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/dns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dns/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAgD,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGhH,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACtF,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAKtG,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAKvE,MAAM,WAAW,gBAAgB;IAK/B,QAAQ,CAAC,EAAE,WAAW,CAAC;IAMvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAMjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAKhB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAqBD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA6B;gBAEhC,OAAO,GAAE,gBAAqB;IAc1C,OAAO,CAAC,GAAG;IASL,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,UAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiD1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO7C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAOxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQrD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO9C,UAAU,CAAC,QAAQ,EAAE,MAAM;IAO3B,UAAU,CAAC,QAAQ,EAAE,MAAM;IAO3B,UAAU,CAAC,QAAQ,EAAE,MAAM;IAO3B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOhC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IA4BhE,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAItE;AA0BD,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAE/D"}

package/dist/dns/index.js

@@ -0,0 +1,124 @@
+import { promises as nodeDns } from 'node:dns';
+import { getSecurityRecords as getSecurityRecordsUtil } from '../utils/dns-toolkit.js';
+export { createLookupFunction, customDNSLookup } from '../utils/dns.js';
+export { createDoHLookup } from '../utils/doh.js';
+export { getSecurityRecords } from '../utils/dns-toolkit.js';
+export class DNSClient {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            provider: options.provider ?? 'system',
+            timeout: options.timeout ?? 5000,
+            debug: options.debug ?? false,
+            servers: options.servers ?? [],
+        };
+        if (this.options.servers.length > 0 && this.options.provider === 'system') {
+            nodeDns.setServers(this.options.servers);
+        }
+    }
+    log(message, ...args) {
+        if (this.options.debug) {
+            console.log(`[DNS] ${message}`, ...args);
+        }
+    }
+    async resolve(hostname, type = 'A') {
+        this.log(`Resolving ${hostname} (${type})`);
+        const start = Date.now();
+        try {
+            let result;
+            switch (type) {
+                case 'A':
+                    result = await nodeDns.resolve4(hostname);
+                    break;
+                case 'AAAA':
+                    result = await nodeDns.resolve6(hostname);
+                    break;
+                case 'CNAME':
+                    result = await nodeDns.resolveCname(hostname);
+                    break;
+                case 'NS':
+                    result = await nodeDns.resolveNs(hostname);
+                    break;
+                case 'PTR':
+                    result = await nodeDns.resolvePtr(hostname);
+                    break;
+                case 'TXT': {
+                    const txt = await nodeDns.resolveTxt(hostname);
+                    result = txt.map(chunks => chunks.join(''));
+                    break;
+                }
+                default: {
+                    const records = await nodeDns.resolve(hostname, type);
+                    if (Array.isArray(records)) {
+                        result = records.map(r => typeof r === 'string' ? r : JSON.stringify(r));
+                    }
+                    else {
+                        result = [JSON.stringify(records)];
+                    }
+                }
+            }
+            this.log(`Resolved ${hostname} in ${Date.now() - start}ms:`, result);
+            return result;
+        }
+        catch (error) {
+            this.log(`Failed to resolve ${hostname}:`, error);
+            throw error;
+        }
+    }
+    resolve4(hostname) {
+        return nodeDns.resolve4(hostname);
+    }
+    resolve6(hostname) {
+        return nodeDns.resolve6(hostname);
+    }
+    resolveMx(hostname) {
+        return nodeDns.resolveMx(hostname);
+    }
+    async resolveTxt(hostname) {
+        const records = await nodeDns.resolveTxt(hostname);
+        return records.map(chunks => chunks.join(''));
+    }
+    resolveNs(hostname) {
+        return nodeDns.resolveNs(hostname);
+    }
+    resolveSoa(hostname) {
+        return nodeDns.resolveSoa(hostname);
+    }
+    resolveSrv(hostname) {
+        return nodeDns.resolveSrv(hostname);
+    }
+    resolveCaa(hostname) {
+        return nodeDns.resolveCaa(hostname);
+    }
+    reverse(ip) {
+        return nodeDns.reverse(ip);
+    }
+    async resolveAll(hostname) {
+        this.log(`Resolving all records for ${hostname}`);
+        const results = {};
+        const tryResolve = async (type, fn) => {
+            try {
+                results[type] = await fn();
+            }
+            catch {
+            }
+        };
+        await Promise.all([
+            tryResolve('A', () => nodeDns.resolve4(hostname)),
+            tryResolve('AAAA', () => nodeDns.resolve6(hostname)),
+            tryResolve('MX', () => nodeDns.resolveMx(hostname)),
+            tryResolve('TXT', () => nodeDns.resolveTxt(hostname)),
+            tryResolve('NS', () => nodeDns.resolveNs(hostname)),
+            tryResolve('CAA', () => nodeDns.resolveCaa(hostname)),
+        ]);
+        this.log(`Resolved all for ${hostname}:`, Object.keys(results));
+        return results;
+    }
+    async getSecurityRecords(domain) {
+        this.log(`Getting security records for ${domain}`);
+        return getSecurityRecordsUtil(domain);
+    }
+}
+export function createDNS(options) {
+    return new DNSClient(options);
+}

package/dist/index.d.ts

@@ -64,4 +64,6 @@ export * as protocols from './protocols/index.js';
 export * from './mcp/client.js';
 export * from './mcp/contract.js';
 export { Client as Recker } from './core/client.js';
+export { get, post, put, patch, del, del as delete, head, options, whois, whoisAvailable, dns, dnsSecurity, ws, recker, } from './recker.js';
+export { default } from './recker.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAGlD,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAGlD,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAOpD,OAAO,EACL,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,GAAG,IAAI,MAAM,EACb,IAAI,EACJ,OAAO,EACP,KAAK,EACL,cAAc,EACd,GAAG,EACH,WAAW,EACX,EAAE,EACF,MAAM,GACP,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -64,3 +64,5 @@ export * as protocols from './protocols/index.js';
 export * from './mcp/client.js';
 export * from './mcp/contract.js';
 export { Client as Recker } from './core/client.js';
+export { get, post, put, patch, del, del as delete, head, options, whois, whoisAvailable, dns, dnsSecurity, ws, recker, } from './recker.js';
+export { default } from './recker.js';

package/dist/recker.d.ts

@@ -0,0 +1,47 @@
+import { Client, type ExtendedClientOptions } from './core/client.js';
+import { type RequestPromise } from './core/request-promise.js';
+import type { RequestOptions } from './types/index.js';
+import { type WebSocketOptions, type ReckerWebSocket } from './websocket/client.js';
+import { createWhois, type WhoisResult, type WhoisOptions } from './utils/whois.js';
+import { type DNSClientOptions, type DNSClient } from './dns/index.js';
+import type { AIClientConfig } from './types/ai.js';
+export declare function get(url: string, options?: RequestOptions): RequestPromise;
+export declare function post(url: string, options?: RequestOptions): RequestPromise;
+export declare function put(url: string, options?: RequestOptions): RequestPromise;
+export declare function patch(url: string, options?: RequestOptions): RequestPromise;
+export declare function del(url: string, options?: RequestOptions): RequestPromise;
+export declare function head(url: string, options?: RequestOptions): RequestPromise;
+export declare function options(url: string, options?: RequestOptions): RequestPromise;
+export declare function whois(query: string, options?: WhoisOptions): Promise<WhoisResult>;
+export declare function whoisAvailable(domain: string): Promise<boolean>;
+export declare function dns(hostname: string, type?: 'A' | 'AAAA' | 'MX' | 'TXT' | 'NS' | 'CNAME'): Promise<string[]>;
+export declare function dnsSecurity(domain: string): Promise<import("./utils/dns-toolkit.js").DnsSecurityRecords>;
+export declare function ws(url: string, options?: WebSocketOptions): ReckerWebSocket;
+export declare const recker: {
+    get: typeof get;
+    post: typeof post;
+    put: typeof put;
+    patch: typeof patch;
+    delete: typeof del;
+    head: typeof head;
+    options: typeof options;
+    whois: typeof whois;
+    whoisAvailable: typeof whoisAvailable;
+    dns: typeof dns;
+    dnsSecurity: typeof dnsSecurity;
+    ws: typeof ws;
+    ai: {
+        chat: (optionsOrPrompt: string | import("./types/ai.js").ChatOptions) => Promise<import("./types/ai.js").AIResponse<string>>;
+        stream: (options: import("./types/ai.js").ChatOptions) => Promise<import("./types/ai.js").AIStream>;
+        embed: (options: import("./types/ai.js").EmbedOptions) => Promise<import("./types/ai.js").EmbedResponse>;
+        extend: (defaults: Partial<import("./types/ai.js").ChatOptions>) => import("./types/ai.js").AIClient;
+        readonly metrics: import("./types/ai.js").AIMetrics;
+    };
+    client: (options?: ExtendedClientOptions) => Client;
+    dnsClient: (options?: DNSClientOptions) => DNSClient;
+    whoisClient: typeof createWhois;
+    aiClient: (options?: AIClientConfig) => import("./types/ai.js").AIClient;
+    reset: () => void;
+};
+export default recker;
+//# sourceMappingURL=recker.d.ts.map

package/dist/recker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recker.d.ts","sourceRoot":"","sources":["../src/recker.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,MAAM,EAAgB,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrG,OAAO,EAA2C,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7H,OAAO,EAAa,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA0CpD,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAEzE;AAMD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAE1E;AAKD,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAEzE;AAKD,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAE3E;AAKD,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAEzE;AAKD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAE1E;AAKD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAE7E;AAUD,wBAAsB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAEvF;AAMD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE;AAMD,wBAAsB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,OAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEvH;AAMD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,gEAE/C;AAMD,wBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAE3E;AA8DD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;uBAgDE,qBAAqB;0BAKlB,gBAAgB;;yBAUjB,cAAc;;CAUpC,CAAC;AAGF,eAAe,MAAM,CAAC"}