recker 1.0.14 → 1.0.15-next.0dab95d

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/bench/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bench/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IACpB,KAAK,EAAE,SAAS,CAAC;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,UAAU;IAKxB,KAAK;IA4FX,IAAI;CAGL"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/bench/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IACpB,KAAK,EAAE,SAAS,CAAC;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,UAAU;IAKxB,KAAK;IAgGX,IAAI;CAGL"}

package/dist/bench/generator.js

@@ -22,7 +22,7 @@ export class LoadGenerator {
                 agent: {
                     connections: this.config.users,
                     pipelining: this.config.mode === 'throughput' ? 2 : 1,
-                    keepAlive: false
+                    keepAlive: true
                 }
             },
             retry: {
@@ -41,6 +41,7 @@ export class LoadGenerator {
                         await new Promise(r => setTimeout(r, 50 + Math.random() * 450));
                     }
                     const res = await client.get(path, { signal: controller.signal });
+                    await res.text();
                     const duration = performance.now() - start;
                     const bytes = Number(res.headers.get('content-length') || 0);
                     this.stats.addResult(duration, res.status, bytes);

package/dist/bench/stats.d.ts

@@ -1,15 +1,29 @@
+export interface ErrorEntry {
+    status: number;
+    message: string;
+    count: number;
+    lastSeen: number;
+}
 export declare class LoadStats {
     totalRequests: number;
     successful: number;
     failed: number;
     bytesTransferred: number;
     statusCodes: Record<number, number>;
-    errors: Record<string, number>;
+    private errorMap;
+    private recentErrors;
+    private readonly maxRecentErrors;
     latencies: number[];
     private lastSnapshotTime;
     private lastSnapshotRequests;
     activeUsers: number;
     addResult(durationMs: number, status: number, bytes: number, error?: Error): void;
+    private trackError;
+    private formatErrorMessage;
+    private getStatusText;
+    getErrors(): ErrorEntry[];
+    getRecentErrors(): ErrorEntry[];
+    get errors(): Record<string, number>;
     getSnapshot(): {
         rps: number;
         p95: number;

package/dist/bench/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/bench/stats.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAS;IACpB,aAAa,SAAK;IAClB,UAAU,SAAK;IACf,MAAM,SAAK;IACX,gBAAgB,SAAK;IAErB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAGpC,SAAS,EAAE,MAAM,EAAE,CAAM;IAGzB,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,oBAAoB,CAAK;IAGjC,WAAW,SAAK;IAEhB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAoB1E,WAAW;;;;;IAmBX,UAAU;;;;;;;;;;;;;;;;CAmBX"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/bench/stats.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IACpB,aAAa,SAAK;IAClB,UAAU,SAAK;IACf,MAAM,SAAK;IACX,gBAAgB,SAAK;IAErB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAKzC,OAAO,CAAC,QAAQ,CAAiC;IAKjD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAM;IAGtC,SAAS,EAAE,MAAM,EAAE,CAAM;IAGzB,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,oBAAoB,CAAK;IAGjC,WAAW,SAAK;IAEhB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;IAoB1E,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,aAAa;IAoBrB,SAAS,IAAI,UAAU,EAAE;IAQzB,eAAe,IAAI,UAAU,EAAE;IAO/B,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnC;IAED,WAAW;;;;;IAmBX,UAAU;;;;;;;;;;;;;;;;CAmBX"}

package/dist/bench/stats.js

@@ -4,7 +4,9 @@ export class LoadStats {
     failed = 0;
     bytesTransferred = 0;
     statusCodes = {};
-    errors = {};
+    errorMap = new Map();
+    recentErrors = [];
+    maxRecentErrors = 10;
     latencies = [];
     lastSnapshotTime = Date.now();
     lastSnapshotRequests = 0;
@@ -15,10 +17,7 @@ export class LoadStats {
         this.latencies.push(durationMs);
         if (error || status >= 400) {
             this.failed++;
-            if (error) {
-                const msg = error.message || 'Unknown Error';
-                this.errors[msg] = (this.errors[msg] || 0) + 1;
-            }
+            this.trackError(status, error);
         }
         else {
             this.successful++;
@@ -27,6 +26,86 @@ export class LoadStats {
             this.statusCodes[status] = (this.statusCodes[status] || 0) + 1;
         }
     }
+    trackError(status, error) {
+        const message = this.formatErrorMessage(status, error);
+        const key = `${status}:${message}`;
+        const now = Date.now();
+        const existing = this.errorMap.get(key);
+        if (existing) {
+            existing.count++;
+            existing.lastSeen = now;
+        }
+        else {
+            const entry = { status, message, count: 1, lastSeen: now };
+            this.errorMap.set(key, entry);
+            this.recentErrors.push(entry);
+            if (this.recentErrors.length > this.maxRecentErrors) {
+                this.recentErrors.shift();
+            }
+        }
+    }
+    formatErrorMessage(status, error) {
+        if (error) {
+            let msg = error.message || 'Unknown Error';
+            if (msg.includes('ECONNREFUSED'))
+                return 'Connection refused';
+            if (msg.includes('ECONNRESET'))
+                return 'Connection reset';
+            if (msg.includes('ETIMEDOUT'))
+                return 'Connection timeout';
+            if (msg.includes('ENOTFOUND'))
+                return 'DNS lookup failed';
+            if (msg.includes('UND_ERR_SOCKET'))
+                return 'Socket error';
+            if (msg.includes('UND_ERR_HEADERS_TIMEOUT'))
+                return 'Headers timeout';
+            if (msg.includes('UND_ERR_BODY_TIMEOUT'))
+                return 'Body timeout';
+            if (msg.includes('UND_ERR_CONNECT_TIMEOUT'))
+                return 'Connect timeout';
+            if (msg.includes('AbortError') || msg.includes('aborted'))
+                return 'Request aborted';
+            if (msg.length > 50) {
+                msg = msg.substring(0, 47) + '...';
+            }
+            return msg;
+        }
+        if (status >= 400) {
+            return this.getStatusText(status);
+        }
+        return 'Unknown Error';
+    }
+    getStatusText(status) {
+        const texts = {
+            400: 'Bad Request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not Found',
+            405: 'Method Not Allowed',
+            408: 'Request Timeout',
+            429: 'Too Many Requests',
+            500: 'Internal Server Error',
+            502: 'Bad Gateway',
+            503: 'Service Unavailable',
+            504: 'Gateway Timeout',
+        };
+        return texts[status] || `HTTP ${status}`;
+    }
+    getErrors() {
+        return Array.from(this.errorMap.values())
+            .sort((a, b) => b.count - a.count);
+    }
+    getRecentErrors() {
+        return [...this.recentErrors];
+    }
+    get errors() {
+        const result = {};
+        for (const entry of this.errorMap.values()) {
+            const key = entry.status > 0 ? `[${entry.status}] ${entry.message}` : entry.message;
+            result[key] = entry.count;
+        }
+        return result;
+    }
     getSnapshot() {
         const now = Date.now();
         const timeDiff = (now - this.lastSnapshotTime) / 1000;

package/dist/cli/index.js

@@ -270,6 +270,27 @@ complete -F _rek_completions rek
         const shell = new RekShell();
         shell.start();
     });
+    program
+        .command('docs [query...]')
+        .alias('?')
+        .description('Search Recker documentation (opens fullscreen panel)')
+        .action(async (queryParts) => {
+        const query = queryParts.join(' ').trim();
+        const { openSearchPanel } = await import('./tui/search-panel.js');
+        await openSearchPanel(query || undefined);
+    });
+    const dns = program.command('dns').description('DNS tools and diagnostics');
+    dns
+        .command('propagate')
+        .description('Check global DNS propagation across multiple providers')
+        .argument('<domain>', 'Domain name to check')
+        .argument('[type]', 'Record type (A, AAAA, CNAME, MX, NS, TXT)', 'A')
+        .action(async (domain, type) => {
+        const { checkPropagation, formatPropagationReport } = await import('../dns/propagation.js');
+        console.log(pc.gray(`Checking propagation for ${domain} (${type})...`));
+        const results = await checkPropagation(domain, type);
+        console.log(formatPropagationReport(results, domain, type));
+    });
     const bench = program.command('bench').description('Performance benchmarking tools');
     bench
         .command('load')

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/cli/tui/load-dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/load-dashboard.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKrE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,iBA4E1D"}
+{"version":3,"file":"load-dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/load-dashboard.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAMrE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,iBA4E1D"}

package/dist/cli/tui/load-dashboard.js

@@ -72,11 +72,11 @@ function render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory
     console.log(`${pc.white('Time:')} ${pc.green(elapsed + 's')} ` +
         `${pc.gray('/')} ${config.duration}s ` +
         `${pc.gray('(')}${pc.yellow(remaining + 's left')}${pc.gray(')')}   ` +
-        `${pc.white('Reqs:')} ${pc.bold(stats.totalRequests)}`);
-    console.log(`${pc.blue('Users:')} ${pc.bold(snapshot.activeUsers)}   ` +
+        `${pc.white('Reqs:')} ${pc.bold(String(stats.totalRequests))}`);
+    console.log(`${pc.blue('Users:')} ${pc.bold(String(snapshot.activeUsers))}   ` +
         `${pc.green('RPS:')} ${pc.bold(snapshot.rps.toFixed(0))}   ` +
         `${pc.magenta('Latency (P95):')} ${pc.bold(snapshot.p95.toFixed(0) + 'ms')}   ` +
-        `${pc.white('Errors:')} ${stats.failed > 0 ? pc.red(stats.failed) : pc.green('0')}`);
+        `${pc.white('Errors:')} ${stats.failed > 0 ? pc.red(String(stats.failed)) : pc.green('0')}`);
     console.log(pc.gray('──────────────────────────────────────────────────'));
     console.log(pc.bold(pc.blue('👥 Active Users')));
     console.log(pc.blue(plot(usersHistory, { height: 4 })));
@@ -86,6 +86,39 @@ function render(config, elapsed, remaining, snapshot, rpsHistory, latencyHistory
     console.log('');
     console.log(pc.bold(pc.magenta('⏱️  Latency P95 (ms)')));
     console.log(pc.magenta(plot(latencyHistory, { height: 4 })));
+    const recentErrors = stats.getRecentErrors();
+    if (recentErrors.length > 0) {
+        console.log('');
+        console.log(pc.bold(pc.red('⚠️  Recent Errors')));
+        renderErrorList(recentErrors, 5);
+    }
+}
+function formatErrorEntry(entry) {
+    const count = pc.gray(`${entry.count}x`);
+    if (entry.status === 0) {
+        return `  ${count} ${pc.red('NET')} ${entry.message}`;
+    }
+    const statusBadge = formatStatusBadge(entry.status);
+    return `  ${count} ${statusBadge} ${entry.message}`;
+}
+function formatStatusBadge(status) {
+    const code = String(status);
+    if (status >= 500)
+        return pc.bgRed(pc.white(` ${code} `));
+    if (status >= 400)
+        return pc.bgYellow(pc.black(` ${code} `));
+    if (status >= 300)
+        return pc.bgCyan(pc.black(` ${code} `));
+    return pc.bgGreen(pc.black(` ${code} `));
+}
+function renderErrorList(errors, maxItems = 10) {
+    const toShow = errors.slice(-maxItems);
+    for (const entry of toShow) {
+        console.log(formatErrorEntry(entry));
+    }
+    if (errors.length > maxItems) {
+        console.log(pc.gray(`  ... and ${errors.length - maxItems} more`));
+    }
 }
 function renderFinalReport(stats, config) {
     const summary = stats.getSummary();
@@ -97,8 +130,8 @@ function renderFinalReport(stats, config) {
     console.log(`  Duration: ${config.duration}s`);
     console.log('\n' + pc.bold('Traffic:'));
     console.log(`  Total Requests:  ${summary.total}`);
-    console.log(`  Successful:      ${pc.green(summary.success)}`);
-    console.log(`  Failed:          ${summary.failed > 0 ? pc.red(summary.failed) : pc.gray(0)}`);
+    console.log(`  Successful:      ${pc.green(String(summary.success))}`);
+    console.log(`  Failed:          ${summary.failed > 0 ? pc.red(String(summary.failed)) : pc.gray('0')}`);
     console.log(`  Total Bytes:     ${(summary.bytes / 1024 / 1024).toFixed(2)} MB`);
     console.log('\n' + pc.bold('Latency (ms):'));
     console.log(`  Avg: ${summary.latency.avg.toFixed(2)}`);
@@ -108,10 +141,31 @@ function renderFinalReport(stats, config) {
     console.log(`  Max: ${summary.latency.max.toFixed(0)}`);
     if (Object.keys(summary.codes).length > 0) {
         console.log('\n' + pc.bold('Status Codes:'));
-        Object.entries(summary.codes).forEach(([code, count]) => {
-            const color = code.startsWith('2') ? pc.green : code.startsWith('5') ? pc.red : pc.yellow;
-            console.log(`  ${color(code)}: ${count}`);
+        Object.entries(summary.codes)
+            .sort(([a], [b]) => Number(a) - Number(b))
+            .forEach(([code, count]) => {
+            const badge = formatStatusBadge(Number(code));
+            console.log(`  ${badge} ${count}`);
         });
     }
+    const allErrors = stats.getErrors();
+    if (allErrors.length > 0) {
+        console.log('\n' + pc.bold(pc.red('Errors:')));
+        renderErrorList(allErrors, 15);
+        const networkErrors = allErrors.filter(e => e.status === 0);
+        const httpErrors = allErrors.filter(e => e.status > 0);
+        if (networkErrors.length > 0 || httpErrors.length > 0) {
+            console.log('');
+            console.log(pc.gray('  Summary:'));
+            if (networkErrors.length > 0) {
+                const total = networkErrors.reduce((sum, e) => sum + e.count, 0);
+                console.log(pc.gray(`    Network errors: ${total} (${networkErrors.length} types)`));
+            }
+            if (httpErrors.length > 0) {
+                const total = httpErrors.reduce((sum, e) => sum + e.count, 0);
+                console.log(pc.gray(`    HTTP errors: ${total} (${httpErrors.length} types)`));
+            }
+        }
+    }
     console.log('');
 }