recker 1.0.15 → 1.0.17-next.316500c

package/README.md

@@ -2,155 +2,144 @@
 
 # ⚡ 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';
+import { rdap, supportsRDAP } from 'recker/utils/rdap';
 
-const client = createClient({ baseUrl: 'https://api.example.com' });
+// HTTP - zero config
+const users = await get('https://api.example.com/users').json();
+await post('https://api.example.com/users', { json: { name: 'John' } });
 
-// GET with JSON
-const users = await client.get('/users').json();
+// WHOIS
+const info = await whois('github.com');
 
-// POST with body
-await client.post('/users', { json: { name: 'John' } });
+// RDAP (modern WHOIS)
+if (supportsRDAP('com')) {
+  const data = await rdap(client, 'google.com');
+  console.log(data.status, data.events);
+}
 
-// Path params + query
-await client.get('/users/:id', { params: { id: '123', expand: 'profile' } });
+// DNS
+const ips = await dns('google.com');
 ```
 
-## ✨ Why Recker?
+### Unified Namespace
+
+```typescript
+import { recker } from 'recker';
+
+// 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');
+```
+
+### 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, RDAP, 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. |
+| **GeoIP (Offline)** | MaxMind GeoLite2 database with bogon detection. |
+| **RDAP Support** | Modern WHOIS with IANA Bootstrap and TLD detection. |
 
-## 💡 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
-
-**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
+## Documentation
 
-We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+- **[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
 
-## 📄 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/providers/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,sBAAsB,EAMvB,MAAM,WAAW,CAAC;AAKnB,MAAM,WAAW,eAAgB,SAAQ,cAAc;IAErD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;CAC1C;AAED,KAAK,oBAAoB,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAclE,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,UAAU,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAkBD,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,OAAO,CAAC,eAAe,CAAkB;gBAE7B,MAAM,GAAE,eAAoB;IAKxC,SAAS,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAI5C,SAAS,CAAC,UAAU,IAAI,MAAM;IAI9B,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAShD,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE;IA0BxE,OAAO,CAAC,gBAAgB;IAuDxB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IAYjB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAa/C,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAY/C,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAW3D,OAAO,CAAC,aAAa;YAmCP,WAAW;YAsBX,WAAW;IA8BzB,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,GAAG,UAAU;IAiD/F,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,WAAW,GAAG,IAAI;YAKjF,oBAAoB;CAyHpC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,sBAAsB,EAMvB,MAAM,WAAW,CAAC;AAMnB,MAAM,WAAW,eAAgB,SAAQ,cAAc;IAErD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;CAC1C;AAED,KAAK,oBAAoB,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAclE,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,UAAU,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAkBD,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,OAAO,CAAC,eAAe,CAAkB;gBAE7B,MAAM,GAAE,eAAoB;IAKxC,SAAS,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAI5C,SAAS,CAAC,UAAU,IAAI,MAAM;IAI9B,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAShD,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE;IA0BxE,OAAO,CAAC,gBAAgB;IAuDxB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IAYjB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAa/C,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAY/C,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAW3D,OAAO,CAAC,aAAa;YAmCP,WAAW;YAsBX,WAAW;IA8BzB,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,GAAG,UAAU;IAiD/F,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,WAAW,GAAG,IAAI;YAKjF,oBAAoB;CA2HpC"}

package/dist/ai/providers/anthropic.js

@@ -1,4 +1,5 @@
 import { BaseAIProvider, AIError, RateLimitError, ContextLengthError, OverloadedError, AuthenticationError, } from './base.js';
+import { StreamError } from '../../core/errors.js';
 export class AnthropicProvider extends BaseAIProvider {
     anthropicConfig;
     constructor(config = {}) {
@@ -256,7 +257,9 @@ export class AnthropicProvider extends BaseAIProvider {
     async *parseAnthropicStream(response, context) {
         const reader = response.body?.getReader();
         if (!reader) {
-            throw new Error('Response body is not readable');
+            throw new StreamError('Response body is not readable', {
+                streamType: 'anthropic-sse',
+            });
         }
         const decoder = new TextDecoder();
         let buffer = '';

package/dist/ai/providers/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/base.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IAExD,IAAI,EAAE,UAAU,CAAC;CAClB;AAKD,8BAAsB,cAAc;IAClC,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBAEzB,MAAM,EAAE,kBAAkB;IAOtC,IAAI,IAAI,IAAI,UAAU,CAErB;IAKD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxD,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAK7D,SAAS,CAAC,SAAS,IAAI,MAAM;IAW7B,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAKrD,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,MAAM;IAKvC,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUhD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE;IAKxE,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,UAAU;IAKhG,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,WAAW,GAAG,IAAI;IAKvG,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS;IAgBtE,SAAS,CAAC,UAAU,IAAI,UAAU;cAWjB,cAAc,CAC7B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,sBAAsB,GAC9B,QAAQ;IA6DX,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE;CAY9D;AAKD,qBAAa,OAAQ,SAAQ,KAAK;aAGd,QAAQ,EAAE,UAAU;aACpB,IAAI,CAAC,EAAE,MAAM;aACb,MAAM,CAAC,EAAE,MAAM;aACf,SAAS,EAAE,OAAO;gBAJlC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,UAAU,EACpB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,SAAS,GAAE,OAAe;CAK7C;AAED,qBAAa,cAAe,SAAQ,OAAO;aAGvB,UAAU,CAAC,EAAE,MAAM;gBADnC,QAAQ,EAAE,UAAU,EACJ,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED,qBAAa,kBAAmB,SAAQ,OAAO;gBACjC,QAAQ,EAAE,UAAU;CAIjC;AAED,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,QAAQ,EAAE,UAAU;CAIjC;AAED,qBAAa,mBAAoB,SAAQ,OAAO;gBAClC,QAAQ,EAAE,UAAU;CAIjC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/base.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IAExD,IAAI,EAAE,UAAU,CAAC;CAClB;AAKD,8BAAsB,cAAc;IAClC,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBAEzB,MAAM,EAAE,kBAAkB;IAOtC,IAAI,IAAI,IAAI,UAAU,CAErB;IAKD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKxD,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAK7D,SAAS,CAAC,SAAS,IAAI,MAAM;IAa7B,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAKrD,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,MAAM;IAKvC,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUhD,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE;IAKxE,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,UAAU;IAKhG,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,WAAW,GAAG,IAAI;IAKvG,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS;IAgBtE,SAAS,CAAC,UAAU,IAAI,UAAU;cAWjB,cAAc,CAC7B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,sBAAsB,GAC9B,QAAQ;IA+DX,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE;CAY9D;AAKD,qBAAa,OAAQ,SAAQ,KAAK;aAGd,QAAQ,EAAE,UAAU;aACpB,IAAI,CAAC,EAAE,MAAM;aACb,MAAM,CAAC,EAAE,MAAM;aACf,SAAS,EAAE,OAAO;gBAJlC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,UAAU,EACpB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,SAAS,GAAE,OAAe;CAK7C;AAED,qBAAa,cAAe,SAAQ,OAAO;aAGvB,UAAU,CAAC,EAAE,MAAM;gBADnC,QAAQ,EAAE,UAAU,EACJ,UAAU,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED,qBAAa,kBAAmB,SAAQ,OAAO;gBACjC,QAAQ,EAAE,UAAU;CAIjC;AAED,qBAAa,eAAgB,SAAQ,OAAO;gBAC9B,QAAQ,EAAE,UAAU;CAIjC;AAED,qBAAa,mBAAoB,SAAQ,OAAO;gBAClC,QAAQ,EAAE,UAAU;CAIjC"}

package/dist/ai/providers/base.js

@@ -1,3 +1,4 @@
+import { ConfigurationError, StreamError } from '../../core/errors.js';
 export class BaseAIProvider {
     config;
     constructor(config) {
@@ -9,7 +10,9 @@ export class BaseAIProvider {
     getApiKey() {
         const key = this.config.apiKey || this.getEnvApiKey();
         if (!key) {
-            throw new Error(`API key not configured for provider: ${this.config.name}`);
+            throw new ConfigurationError(`API key not configured for provider: ${this.config.name}`, {
+                configKey: `${this.config.name}.apiKey`,
+            });
         }
         return key;
     }
@@ -40,7 +43,9 @@ export class BaseAIProvider {
     async *parseSSEStream(response, context) {
         const reader = response.body?.getReader();
         if (!reader) {
-            throw new Error('Response body is not readable');
+            throw new StreamError('Response body is not readable', {
+                streamType: 'sse',
+            });
         }
         const decoder = new TextDecoder();
         let buffer = '';

package/dist/ai/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/ai/rate-limiter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAyFxE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,oBAAyB;IAYvC,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;KAAE,GAC3E,OAAO,CAAC,CAAC,CAAC;IA4BP,WAAW,CAAC,CAAC,EACjB,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAUb,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAchE,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB;IAeD,UAAU,IAAI,IAAI;IAUlB,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,UAAU;YAYJ,UAAU;IAUxB,OAAO,CAAC,OAAO;YAmCD,YAAY;IAkC1B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,KAAK;CAGd;AAKD,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAKD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAa9E,CAAC;AAKF,wBAAgB,iBAAiB,CAC/B,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACxC,gBAAgB,CAGlB;AAKD,eAAO,MAAM,eAAe;6BA/UD,MAAM,GAAG,MAAM;gCAQZ,WAAW,GAAG,MAAM;CAuUH,CAAC"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/ai/rate-limiter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA0FxE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAa;gBAEf,MAAM,GAAE,oBAAyB;IAYvC,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;KAAE,GAC3E,OAAO,CAAC,CAAC,CAAC;IA4BP,WAAW,CAAC,CAAC,EACjB,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAUb,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAchE,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB;IAeD,UAAU,IAAI,IAAI;IAYlB,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,UAAU;YAYJ,UAAU;IAUxB,OAAO,CAAC,OAAO;YAmCD,YAAY;IAkC1B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,KAAK;CAGd;AAKD,qBAAa,sBAAuB,SAAQ,KAAK;aACnB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAI/C;AAKD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAa9E,CAAC;AAKF,wBAAgB,iBAAiB,CAC/B,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACxC,gBAAgB,CAGlB;AAKD,eAAO,MAAM,eAAe;6BAjVD,MAAM,GAAG,MAAM;gCAQZ,WAAW,GAAG,MAAM;CAyUH,CAAC"}

package/dist/ai/rate-limiter.js

@@ -1,3 +1,4 @@
+import { QueueCancelledError } from '../core/errors.js';
 const DEFAULT_LIMITS = {
     tokensPerMinute: 90000,
     requestsPerMinute: 500,
@@ -94,7 +95,9 @@ export class TokenRateLimiter {
     }
     clearQueue() {
         for (const req of this.queue) {
-            req.reject(new Error('Queue cleared'));
+            req.reject(new QueueCancelledError('Queue cleared', {
+                queueName: 'ai-rate-limiter',
+            }));
         }
         this.queue = [];
     }

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;IA8GX,IAAI;CAGL"}

package/dist/bench/generator.js

@@ -11,6 +11,8 @@ export class LoadGenerator {
     async start() {
         this.running = true;
         const startTime = Date.now();
+        const connections = Math.min(Math.ceil(this.config.users / 10), 100);
+        const pipelining = this.config.mode === 'stress' ? 1 : 10;
         const client = createClient({
             baseUrl: new URL(this.config.url).origin,
             observability: false,
@@ -20,9 +22,11 @@ export class LoadGenerator {
                 requestsPerInterval: Infinity,
                 interval: 1000,
                 agent: {
-                    connections: this.config.users,
-                    pipelining: this.config.mode === 'throughput' ? 2 : 1,
-                    keepAlive: false
+                    connections,
+                    pipelining,
+                    keepAlive: true,
+                    keepAliveTimeout: 30000,
+                    connectTimeout: 5000,
                 }
             },
             retry: {
@@ -41,6 +45,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;IAoC1B,OAAO,CAAC,aAAa;IAiDrB,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,119 @@ 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.includes('expression evaluated to a falsy value'))
+                return 'Connection pool exhausted';
+            if (msg.includes('AssertionError'))
+                return 'Internal assertion failed';
+            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: 'BadRequest',
+            401: 'Unauthorized',
+            402: 'PaymentRequired',
+            403: 'Forbidden',
+            404: 'NotFound',
+            405: 'MethodNotAllowed',
+            406: 'NotAcceptable',
+            407: 'ProxyAuthRequired',
+            408: 'RequestTimeout',
+            409: 'Conflict',
+            410: 'Gone',
+            411: 'LengthRequired',
+            412: 'PreconditionFailed',
+            413: 'PayloadTooLarge',
+            414: 'URITooLong',
+            415: 'UnsupportedMediaType',
+            416: 'RangeNotSatisfiable',
+            417: 'ExpectationFailed',
+            418: 'Teapot',
+            421: 'MisdirectedRequest',
+            422: 'UnprocessableEntity',
+            423: 'Locked',
+            424: 'FailedDependency',
+            425: 'TooEarly',
+            426: 'UpgradeRequired',
+            428: 'PreconditionRequired',
+            429: 'TooManyRequests',
+            431: 'HeaderFieldsTooLarge',
+            451: 'UnavailableForLegalReasons',
+            500: 'InternalServerError',
+            501: 'NotImplemented',
+            502: 'BadGateway',
+            503: 'ServiceUnavailable',
+            504: 'GatewayTimeout',
+            505: 'HTTPVersionNotSupported',
+            506: 'VariantAlsoNegotiates',
+            507: 'InsufficientStorage',
+            508: 'LoopDetected',
+            510: 'NotExtended',
+            511: 'NetworkAuthRequired',
+        };
+        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/cache/memory-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../src/cache/memory-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../src/cache/memory-storage.ts"],"names":[],"mappings":"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"}

package/dist/cache/memory-storage.js

@@ -1,3 +1,4 @@
+import { ConfigurationError } from '../core/errors.js';
 import zlib from 'node:zlib';
 import os from 'node:os';
 import { getEffectiveTotalMemoryBytes, resolveCacheMemoryLimit, formatBytes, getHeapStats, } from './memory-limits.js';
@@ -38,11 +39,11 @@ export class MemoryStorage {
             options.maxMemoryBytes > 0 &&
             options.maxMemoryPercent &&
             options.maxMemoryPercent > 0) {
-            throw new Error('[MemoryStorage] Cannot use both maxMemoryBytes and maxMemoryPercent');
+            throw new ConfigurationError('[MemoryStorage] Cannot use both maxMemoryBytes and maxMemoryPercent', { configKey: 'maxMemoryBytes|maxMemoryPercent' });
         }
         if (options.maxMemoryPercent !== undefined &&
             (options.maxMemoryPercent < 0 || options.maxMemoryPercent > 1)) {
-            throw new Error('[MemoryStorage] maxMemoryPercent must be between 0 and 1');
+            throw new ConfigurationError('[MemoryStorage] maxMemoryPercent must be between 0 and 1', { configKey: 'maxMemoryPercent' });
         }
         this.maxSize = options.maxSize ?? 1000;
         this.defaultTtl = options.ttl ?? 300000;