recker 1.0.21-next.cd9a658 → 1.0.21-next.d9fe496

package/README.md

@@ -77,6 +77,28 @@ const api = createClient({
 const user = await api.get('/users/:id', { params: { id: '123' } }).json();
 ```
 
+### Mini Client (Maximum Performance)
+
+Need raw speed? Use `recker-mini` for ~2% overhead vs raw undici:
+
+```typescript
+import { createMiniClient, miniGet } from 'recker/mini';
+
+// Client instance
+const fast = createMiniClient({ baseUrl: 'https://api.example.com' });
+const data = await fast.get('/users').then(r => r.json());
+
+// Or direct function (even faster)
+const users = await miniGet('https://api.example.com/users').then(r => r.json());
+```
+
+| Mode | Speed | Features |
+|------|-------|----------|
+| `recker-mini` | ~146µs (2% overhead) | Base URL, headers, JSON |
+| `recker` | ~265µs (86% overhead) | Retry, cache, auth, hooks, plugins |
+
+See [Mini Client documentation](./docs/http/18-mini-client.md) for more.
+
 ## Features
 
 | Feature | Description |
@@ -163,6 +185,7 @@ See [CLI Documentation](./docs/cli/01-overview.md) for more.
 ## Documentation
 
 - **[Quick Start](./docs/http/01-quickstart.md)** - Get running in 2 minutes
+- **[Mini Client](./docs/http/18-mini-client.md)** - Maximum performance mode
 - **[CLI Guide](./docs/cli/01-overview.md)** - Terminal client documentation
 - **[API Reference](./docs/reference/01-api.md)** - Complete API documentation
 - **[Configuration](./docs/http/05-configuration.md)** - Client options
@@ -170,6 +193,7 @@ See [CLI Documentation](./docs/cli/01-overview.md) for more.
 - **[AI Integration](./docs/ai/01-overview.md)** - OpenAI, Anthropic, and more
 - **[Protocols](./docs/protocols/01-websocket.md)** - WebSocket, DNS, WHOIS
 - **[Mock Servers](./docs/cli/08-mock-servers.md)** - Built-in test servers
+- **[Benchmarks](./docs/benchmarks.md)** - Performance comparisons
 
 ## License
 

package/dist/index.d.ts

@@ -65,7 +65,7 @@ export * as testing from './testing/index.js';
 export * as protocols from './protocols/index.js';
 export * from './mcp/client.js';
 export * from './mcp/contract.js';
-export * from './bare.js';
+export * from './mini.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/index.js

@@ -65,7 +65,7 @@ export * as testing from './testing/index.js';
 export * as protocols from './protocols/index.js';
 export * from './mcp/client.js';
 export * from './mcp/contract.js';
-export * from './bare.js';
+export * from './mini.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/mini.d.ts

@@ -0,0 +1,28 @@
+export interface MiniClientOptions {
+    baseUrl: string;
+    headers?: Record<string, string>;
+}
+export interface MiniResponse<T = unknown> {
+    status: number;
+    headers: Headers;
+    json(): Promise<T>;
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    blob(): Promise<Blob>;
+}
+export interface MiniClient {
+    get<T = unknown>(path: string): Promise<MiniResponse<T>>;
+    post<T = unknown>(path: string, body?: unknown): Promise<MiniResponse<T>>;
+    put<T = unknown>(path: string, body?: unknown): Promise<MiniResponse<T>>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<MiniResponse<T>>;
+    delete<T = unknown>(path: string): Promise<MiniResponse<T>>;
+}
+export declare function createMiniClient(options: MiniClientOptions): MiniClient;
+export declare function miniGet<T = unknown>(url: string, headers?: Record<string, string>): Promise<MiniResponse<T>>;
+export declare function miniPost<T = unknown>(url: string, data?: unknown, headers?: Record<string, string>): Promise<MiniResponse<T>>;
+export declare const createBareClient: typeof createMiniClient;
+export type BareClientOptions = MiniClientOptions;
+export type BareResponse<T = unknown> = MiniResponse<T>;
+export type BareClient = MiniClient;
+export declare const bareGet: typeof miniGet;
+export declare const barePost: typeof miniPost;

package/dist/{bare.js → mini.js}

@@ -1,5 +1,5 @@
 import { request as undiciRequest } from 'undici';
-export function createBareClient(options) {
+export function createMiniClient(options) {
     const base = options.baseUrl.endsWith('/')
         ? options.baseUrl.slice(0, -1)
         : options.baseUrl;
@@ -57,7 +57,7 @@ export function createBareClient(options) {
         }
     };
 }
-export async function bareGet(url, headers) {
+export async function miniGet(url, headers) {
     const { statusCode, headers: resHeaders, body } = await undiciRequest(url, {
         method: 'GET',
         headers
@@ -71,7 +71,7 @@ export async function bareGet(url, headers) {
         blob: async () => new Blob([await body.arrayBuffer()])
     };
 }
-export async function barePost(url, data, headers) {
+export async function miniPost(url, data, headers) {
     const { statusCode, headers: resHeaders, body } = await undiciRequest(url, {
         method: 'POST',
         headers: {
@@ -89,3 +89,6 @@ export async function barePost(url, data, headers) {
         blob: async () => new Blob([await body.arrayBuffer()])
     };
 }
+export const createBareClient = createMiniClient;
+export const bareGet = miniGet;
+export const barePost = miniPost;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.21-next.cd9a658",
+  "version": "1.0.21-next.d9fe496",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -106,9 +106,13 @@
       "types": "./dist/ai/index.d.ts",
       "import": "./dist/ai/index.js"
     },
+    "./mini": {
+      "types": "./dist/mini.d.ts",
+      "import": "./dist/mini.js"
+    },
     "./bare": {
-      "types": "./dist/bare.d.ts",
-      "import": "./dist/bare.js"
+      "types": "./dist/mini.d.ts",
+      "import": "./dist/mini.js"
     },
     "./package.json": "./package.json"
   },

package/dist/bare.d.ts

@@ -1,22 +0,0 @@
-export interface BareClientOptions {
-    baseUrl: string;
-    headers?: Record<string, string>;
-}
-export interface BareResponse<T = unknown> {
-    status: number;
-    headers: Headers;
-    json(): Promise<T>;
-    text(): Promise<string>;
-    arrayBuffer(): Promise<ArrayBuffer>;
-    blob(): Promise<Blob>;
-}
-export interface BareClient {
-    get<T = unknown>(path: string): Promise<BareResponse<T>>;
-    post<T = unknown>(path: string, body?: unknown): Promise<BareResponse<T>>;
-    put<T = unknown>(path: string, body?: unknown): Promise<BareResponse<T>>;
-    patch<T = unknown>(path: string, body?: unknown): Promise<BareResponse<T>>;
-    delete<T = unknown>(path: string): Promise<BareResponse<T>>;
-}
-export declare function createBareClient(options: BareClientOptions): BareClient;
-export declare function bareGet<T = unknown>(url: string, headers?: Record<string, string>): Promise<BareResponse<T>>;
-export declare function barePost<T = unknown>(url: string, data?: unknown, headers?: Record<string, string>): Promise<BareResponse<T>>;