recker 1.0.2-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Forattini Development
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# Recker
+
+<div align="center">
+  <h1>The HTTP Client for the AI Era</h1>
+  
+  <p>
+    Build resilient, type-safe, and high-performance integrations with the 
+    <strong>Smart SDK Builder</strong> designed for modern backend ecosystems.
+  </p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/recker">
+      <img src="https://img.shields.io/npm/v/recker.svg?style=flat-square&color=F5A623" alt="npm version" />
+    </a>
+    <a href="https://github.com/your-org/recker/blob/main/LICENSE">
+      <img src="https://img.shields.io/npm/l/recker.svg?style=flat-square&color=007AFF" alt="license" />
+    </a>
+    <img src="https://img.shields.io/badge/coverage-100%25-34C759?style=flat-square" alt="coverage" />
+    <img src="https://img.shields.io/badge/types-included-34C759?style=flat-square" alt="types" />
+  </p>
+  
+  <br />
+</div>
+
+---
+
+**Recker** is not just another `fetch` wrapper. It combines the ergonomics of `ky` with the resilience of `got` and the raw performance of `undici` into a unified **DevX Powerhouse**.
+
+## ⚡ Why Recker?
+
+| Feature | Description |
+| :--- | :--- |
+| **🛡️ Contract-First** | Define Zod schemas and get a fully typed SDK. No more `any`. |
+| **🚦 Task Pool** | Global Rate Limiting & Concurrency Control (Semaphore/Token Bucket). |
+| **👁️ Visual Debug** | Beautiful "Matrix-style" logs and cURL export. |
+| **🤖 AI Ready** | First-class Server-Sent Events (SSE) support for LLM streaming. |
+| **🔌 Plug & Play** | Circuit Breaker, Deduplication, Caching (SWR), and Retry built-in. |
+| **🌐 Universal** | Works in Node.js (Undici) and Edge/Browsers (Fetch). |
+
+## 📦 Installation
+
+```bash
+npm install recker undici zod
+```
+
+## 🚀 Quick Start
+
+### 1. The "Classic" Way
+Simple and intuitive API with better defaults and full type safety.
+
+```typescript
+import { createClient } from 'recker';
+
+const client = createClient({
+  baseUrl: 'https://jsonplaceholder.typicode.com'
+});
+
+// Auto-parse JSON, Typed response
+const todo = await client.get<{ title: string }>('/todos/1').json();
+console.log(todo.title);
+```
+
+### 2. The "Pro" Way (Contract-First)
+Stop guessing URLs. Define your API contract.
+
+```typescript
+import { z } from 'zod';
+import { createContract } from 'recker';
+
+const api = createContract(client, {
+  getUser: {
+    method: 'GET',
+    path: '/users/:id',
+    params: z.object({ id: z.string() }),
+    response: z.object({ name: z.string() })
+  }
+});
+
+// Fully typed! Typescript errors if you forget 'params.id'
+const user = await api.getUser({ params: { id: '1' } });
+```
+
+### 3. The "Resilient" Way
+Protect your downstream services with Circuit Breakers and Rate Limiting.
+
+```typescript
+import { circuitBreaker, rateLimit } from 'recker';
+
+const resilientClient = createClient({
+  // Never send more than 10 requests/sec
+  rateLimit: { requestsPerInterval: 10, interval: 1000 },
+  plugins: [
+    // Stop calling if 50% of requests fail
+    circuitBreaker({ threshold: 5 })
+  ]
+});
+```
+
+## 📚 Documentation
+
+Read the full documentation at [recker.js.org](https://recker.js.org) (mock link).
+
+- [Client Configuration](/docs/guides/client-config.md)
+- [Concurrency Guide](/docs/guides/concurrency.md)
+- [Streaming & SSE](/docs/guides/streaming.md)
+
+## License
+
+MIT

package/dist/cache/file-storage.d.ts

@@ -0,0 +1,13 @@
+import { CacheEntry, CacheStorage } from '../types/index.js';
+export declare class FileStorage implements CacheStorage {
+    private dir;
+    constructor(baseDir?: string);
+    private getHash;
+    private getPath;
+    private ensureDir;
+    get(key: string): Promise<CacheEntry | undefined>;
+    set(key: string, entry: CacheEntry, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=file-storage.d.ts.map

package/dist/cache/file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../src/cache/file-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM7D,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,GAAE,MAAwB;IAI7C,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;YAID,SAAS;IAMjB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAqBjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/cache/file-storage.js

@@ -0,0 +1,50 @@
+import { mkdir, readFile, writeFile, unlink, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+export class FileStorage {
+    dir;
+    constructor(baseDir = '.recker/cache') {
+        this.dir = baseDir;
+    }
+    getHash(key) {
+        return createHash('md5').update(key).digest('hex');
+    }
+    getPath(key) {
+        return join(this.dir, `${this.getHash(key)}.json`);
+    }
+    async ensureDir() {
+        if (!existsSync(this.dir)) {
+            await mkdir(this.dir, { recursive: true });
+        }
+    }
+    async get(key) {
+        try {
+            const path = this.getPath(key);
+            if (!existsSync(path))
+                return undefined;
+            const content = await readFile(path, 'utf-8');
+            const data = JSON.parse(content);
+            return data;
+        }
+        catch (error) {
+            return undefined;
+        }
+    }
+    async set(key, entry, ttl) {
+        await this.ensureDir();
+        const path = this.getPath(key);
+        await writeFile(path, JSON.stringify(entry), 'utf-8');
+    }
+    async delete(key) {
+        const path = this.getPath(key);
+        if (existsSync(path)) {
+            await unlink(path);
+        }
+    }
+    async clear() {
+        if (existsSync(this.dir)) {
+            await rm(this.dir, { recursive: true, force: true });
+        }
+    }
+}

package/dist/cache/memory-storage.d.ts

@@ -0,0 +1,10 @@
+import { CacheEntry, CacheStorage } from '../types/index.js';
+export declare class MemoryStorage implements CacheStorage {
+    private storage;
+    private ttls;
+    get(key: string): Promise<CacheEntry | undefined>;
+    set(key: string, entry: CacheEntry, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): void;
+}
+//# sourceMappingURL=memory-storage.d.ts.map

package/dist/cache/memory-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../src/cache/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,IAAI,CAA6B;IAEnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAajD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxC,KAAK;CAIN"}

package/dist/cache/memory-storage.js

@@ -0,0 +1,29 @@
+export class MemoryStorage {
+    storage = new Map();
+    ttls = new Map();
+    async get(key) {
+        const entry = this.storage.get(key);
+        if (!entry)
+            return undefined;
+        const expiry = this.ttls.get(key);
+        if (expiry && Date.now() > expiry) {
+            this.delete(key);
+            return undefined;
+        }
+        return entry;
+    }
+    async set(key, entry, ttl) {
+        this.storage.set(key, entry);
+        if (ttl) {
+            this.ttls.set(key, Date.now() + ttl);
+        }
+    }
+    async delete(key) {
+        this.storage.delete(key);
+        this.ttls.delete(key);
+    }
+    clear() {
+        this.storage.clear();
+        this.ttls.clear();
+    }
+}

package/dist/cache/redis-storage.d.ts

@@ -0,0 +1,16 @@
+import { CacheStorage, CacheEntry } from '../types/index.js';
+interface RedisClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode?: string, duration?: number): Promise<any>;
+    del(key: string): Promise<any>;
+}
+export declare class RedisStorage implements CacheStorage {
+    private redis;
+    private prefix;
+    constructor(redis: RedisClient, prefix?: string);
+    get(key: string): Promise<CacheEntry | undefined | null>;
+    set(key: string, value: CacheEntry, ttl: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=redis-storage.d.ts.map

package/dist/cache/redis-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-storage.d.ts","sourceRoot":"","sources":["../../src/cache/redis-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7D,UAAU,WAAW;IACnB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAChC;AAED,qBAAa,YAAa,YAAW,YAAY;IACnC,OAAO,CAAC,KAAK;IAAe,OAAO,CAAC,MAAM;gBAAlC,KAAK,EAAE,WAAW,EAAU,MAAM,GAAE,MAAkB;IAEpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;IAUxD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/dist/cache/redis-storage.js

@@ -0,0 +1,25 @@
+export class RedisStorage {
+    redis;
+    prefix;
+    constructor(redis, prefix = 'recker:') {
+        this.redis = redis;
+        this.prefix = prefix;
+    }
+    async get(key) {
+        const data = await this.redis.get(this.prefix + key);
+        if (!data)
+            return null;
+        try {
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value, ttl) {
+        await this.redis.set(this.prefix + key, JSON.stringify(value), 'PX', ttl);
+    }
+    async delete(key) {
+        await this.redis.del(this.prefix + key);
+    }
+}

package/dist/constants.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFAULT_MAX_RETRY_DELAY_MS = 30000;
+export declare const DEFAULT_RETRY_ATTEMPTS = 3;
+export declare const DEFAULT_BASE_DELAY_MS = 100;
+export declare const PROGRESS_THROTTLE_INTERVAL_MS = 100;
+export declare const PROGRESS_UPDATES_PER_SECOND = 10;
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+export declare const DEFAULT_CONNECT_TIMEOUT_MS = 10000;
+export declare const DEFAULT_CACHE_TTL_MS = 60000;
+export declare const DEFAULT_STALE_TTL_MS = 300000;
+export declare const DEFAULT_HTTP2_MAX_CONCURRENT_STREAMS = 100;
+export declare const DEFAULT_HTTP1_PIPELINING = 1;
+export declare const DEFAULT_COMPRESSION_THRESHOLD_BYTES = 1024;
+export declare const DEFAULT_COMPRESSION_ALGORITHM: "gzip";
+export declare const DEFAULT_MAX_PAGES: number;
+export declare const DEFAULT_PAGE_PARAM = "page";
+export declare const DEFAULT_LIMIT_PARAM = "limit";
+export declare const DEFAULT_FAILURE_THRESHOLD = 5;
+export declare const DEFAULT_RESET_TIMEOUT_MS = 60000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAGzC,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAG9C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAGjD,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAG5C,eAAO,MAAM,oCAAoC,MAAM,CAAC;AACxD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAG1C,eAAO,MAAM,mCAAmC,OAAO,CAAC;AACxD,eAAO,MAAM,6BAA6B,EAAG,MAAe,CAAC;AAG7D,eAAO,MAAM,iBAAiB,QAAW,CAAC;AAC1C,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAG3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,wBAAwB,QAAS,CAAC"}

package/dist/constants.js

@@ -0,0 +1,18 @@
+export const DEFAULT_MAX_RETRY_DELAY_MS = 30_000;
+export const DEFAULT_RETRY_ATTEMPTS = 3;
+export const DEFAULT_BASE_DELAY_MS = 100;
+export const PROGRESS_THROTTLE_INTERVAL_MS = 100;
+export const PROGRESS_UPDATES_PER_SECOND = 10;
+export const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+export const DEFAULT_CONNECT_TIMEOUT_MS = 10_000;
+export const DEFAULT_CACHE_TTL_MS = 60_000;
+export const DEFAULT_STALE_TTL_MS = 300_000;
+export const DEFAULT_HTTP2_MAX_CONCURRENT_STREAMS = 100;
+export const DEFAULT_HTTP1_PIPELINING = 1;
+export const DEFAULT_COMPRESSION_THRESHOLD_BYTES = 1024;
+export const DEFAULT_COMPRESSION_ALGORITHM = 'gzip';
+export const DEFAULT_MAX_PAGES = Infinity;
+export const DEFAULT_PAGE_PARAM = 'page';
+export const DEFAULT_LIMIT_PARAM = 'limit';
+export const DEFAULT_FAILURE_THRESHOLD = 5;
+export const DEFAULT_RESET_TIMEOUT_MS = 60_000;

package/dist/contract/index.d.ts

@@ -0,0 +1,32 @@
+import { z, ZodSchema } from 'zod';
+import { Client } from '../core/client.js';
+import { Method } from '../types/index.js';
+import { HttpError } from '../core/errors.js';
+export interface ContractEndpoint {
+    method: Method;
+    path: string;
+    params?: ZodSchema;
+    body?: ZodSchema;
+    response?: ZodSchema;
+    errors?: Record<number, ZodSchema>;
+}
+export type ContractDefinition = Record<string, ContractEndpoint>;
+type EndpointFunction<T extends ContractEndpoint> = (args: (T['params'] extends ZodSchema ? {
+    params: z.infer<T['params']>;
+} : {}) & (T['body'] extends ZodSchema ? {
+    body: z.infer<T['body']>;
+} : {}) & {
+    headers?: HeadersInit;
+}) => Promise<T['response'] extends ZodSchema ? z.infer<T['response']> : unknown>;
+export type ContractClient<T extends ContractDefinition> = {
+    [K in keyof T]: EndpointFunction<T[K]>;
+};
+export declare class ContractError extends Error {
+    status: number;
+    data: any;
+    originalError: HttpError;
+    constructor(status: number, data: any, originalError: HttpError);
+}
+export declare function createContract<T extends ContractDefinition>(client: Client, contract: T): ContractClient<T>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAMlE,KAAK,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAClD,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,SAAS,GAAG;IAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;CAAE,GAAG,EAAE,CAAC,GACvE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG;IAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;CAAE,GAAG,EAAE,CAAC,GACjE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAA;CAAE,KAC5B,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;AAGjF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,kBAAkB,IAAI;KACxD,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;IACnB,MAAM,EAAE,MAAM;IAAS,IAAI,EAAE,GAAG;IAAS,aAAa,EAAE,SAAS;gBAAjE,MAAM,EAAE,MAAM,EAAS,IAAI,EAAE,GAAG,EAAS,aAAa,EAAE,SAAS;CAIrF;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,kBAAkB,EACzD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,GACV,cAAc,CAAC,CAAC,CAAC,CAqEnB"}

package/dist/contract/index.js

@@ -0,0 +1,67 @@
+import { HttpError } from '../core/errors.js';
+export class ContractError extends Error {
+    status;
+    data;
+    originalError;
+    constructor(status, data, originalError) {
+        super(`Contract Error ${status}: ${JSON.stringify(data)}`);
+        this.status = status;
+        this.data = data;
+        this.originalError = originalError;
+        this.name = 'ContractError';
+    }
+}
+export function createContract(client, contract) {
+    const proxy = {};
+    for (const [key, endpoint] of Object.entries(contract)) {
+        proxy[key] = async (args = {}) => {
+            let finalParams = args.params;
+            if (endpoint.params) {
+                finalParams = endpoint.params.parse(args.params);
+            }
+            let finalBody = args.body;
+            if (endpoint.body) {
+                finalBody = endpoint.body.parse(args.body);
+            }
+            const headers = new Headers(args.headers);
+            if (finalBody && typeof finalBody === 'object' &&
+                !(finalBody instanceof Blob) &&
+                !(finalBody instanceof FormData) &&
+                !(finalBody instanceof URLSearchParams)) {
+                if (!headers.has('Content-Type')) {
+                    headers.set('Content-Type', 'application/json');
+                }
+                finalBody = JSON.stringify(finalBody);
+            }
+            try {
+                const request = client.request(endpoint.path, {
+                    method: endpoint.method,
+                    params: finalParams,
+                    body: finalBody,
+                    headers: headers,
+                });
+                if (endpoint.response) {
+                    return await request.parse(endpoint.response);
+                }
+                return await request.json();
+            }
+            catch (err) {
+                if (endpoint.errors && err instanceof HttpError && err.response) {
+                    const schema = endpoint.errors[err.status];
+                    if (schema) {
+                        try {
+                            const errorBody = await err.response.json();
+                            const parsedError = schema.parse(errorBody);
+                            throw new ContractError(err.status, parsedError, err);
+                        }
+                        catch (parseErr) {
+                            throw err;
+                        }
+                    }
+                }
+                throw err;
+            }
+        };
+    }
+    return proxy;
+}

package/dist/core/client.d.ts

@@ -0,0 +1,107 @@
+import { ClientOptions, Middleware, ReckerRequest, ReckerResponse, RequestOptions, CacheStorage, PageResult } from '../types/index.js';
+import { RequestPromise } from './request-promise.js';
+import { PaginationOptions } from '../plugins/pagination.js';
+import { RetryOptions } from '../plugins/retry.js';
+import { CacheOptions } from '../plugins/cache.js';
+import { DedupOptions } from '../plugins/dedup.js';
+import { ReckerWebSocket, type WebSocketOptions } from '../websocket/client.js';
+import { type WhoisOptions, type WhoisResult } from '../utils/whois.js';
+interface ClientCacheConfig extends Omit<CacheOptions, 'storage'> {
+    storage?: CacheStorage;
+    driver?: 'memory' | 'file';
+    fileStoragePath?: string;
+}
+export interface ExtendedClientOptions extends ClientOptions {
+    retry?: RetryOptions;
+    cache?: ClientCacheConfig;
+    dedup?: DedupOptions;
+}
+export declare class Client {
+    private baseUrl;
+    private middlewares;
+    private hooks;
+    private transport;
+    private defaultHeaders;
+    private defaultParams;
+    private paginationConfig?;
+    private handler;
+    private logger?;
+    private debugEnabled;
+    private agentManager?;
+    private concurrencyConfig;
+    private requestPool?;
+    constructor(options?: ExtendedClientOptions);
+    private createLoggingMiddleware;
+    private composeMiddlewares;
+    private hooksMiddleware;
+    private httpErrorMiddleware;
+    use(middleware: Middleware): this;
+    beforeRequest(hook: (req: ReckerRequest) => ReckerRequest | void | Promise<ReckerRequest | void>): this;
+    afterResponse(hook: (req: ReckerRequest, res: ReckerResponse) => ReckerResponse | void | Promise<ReckerResponse | void>): this;
+    onError(hook: (error: Error, req: ReckerRequest) => ReckerResponse | void | Promise<ReckerResponse | void>): this;
+    private buildUrl;
+    request<T = unknown>(path: string, options?: RequestOptions): RequestPromise<T>;
+    get<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    batch<T = ReckerResponse>(requests: Array<{
+        path: string;
+        options?: RequestOptions;
+    }>, options?: {
+        concurrency?: number;
+        mapResponse?: (res: ReckerResponse) => Promise<T> | T;
+    }): Promise<{
+        results: (T | Error)[];
+        stats: {
+            total: number;
+            successful: number;
+            failed: number;
+            duration: number;
+        };
+    }>;
+    multi<T = ReckerResponse>(requests: Array<{
+        path: string;
+        options?: RequestOptions;
+    }>, options?: {
+        concurrency?: number;
+        mapResponse?: (res: ReckerResponse) => Promise<T> | T;
+    }): Promise<{
+        results: (Error | T)[];
+        stats: {
+            total: number;
+            successful: number;
+            failed: number;
+            duration: number;
+        };
+    }>;
+    private requestWithBody;
+    post<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    put<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    patch<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    delete<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    head<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    options<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    trace<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    connect<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    purge<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    propfind<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    proppatch<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    mkcol<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    copy<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    move<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    lock<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    unlock<T = unknown>(path: string, options?: Omit<RequestOptions, 'method'>): RequestPromise<T>;
+    link<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    unlink<T = unknown>(path: string, body?: any, options?: Omit<RequestOptions, 'method' | 'body'>): RequestPromise<T>;
+    paginate<T>(path: string, options?: RequestOptions & PaginationOptions<T>): AsyncGenerator<T>;
+    pages<T = any>(path: string, options?: RequestOptions & PaginationOptions): AsyncGenerator<PageResult<T>>;
+    page<T = any>(path: string, pageNumber: number, options?: RequestOptions & {
+        pageParam?: string;
+    }): RequestPromise<T>;
+    getAll<T>(path: string, options?: RequestOptions & PaginationOptions<T>): Promise<T[]>;
+    websocket(path: string, options?: WebSocketOptions): ReckerWebSocket;
+    ws(path: string, options?: WebSocketOptions): ReckerWebSocket;
+    whois(query: string, options?: WhoisOptions): Promise<WhoisResult>;
+    isDomainAvailable(domain: string, options?: WhoisOptions): Promise<boolean>;
+}
+export declare function createClient(options?: ExtendedClientOptions): Client;
+export {};
+//# sourceMappingURL=client.d.ts.map

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

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