recker 1.0.2-0 → 1.0.4

package/dist/core/request.d.ts

@@ -1,4 +1,4 @@
-import { Method, ReckerRequest, RequestOptions, ProgressCallback } from '../types/index.js';
+import { Method, ReckerRequest, RequestOptions, ProgressCallback, TimeoutOptions, RedirectInfo } from '../types/index.js';
 export declare class HttpRequest implements ReckerRequest {
     readonly url: string;
     readonly method: Method;
@@ -6,8 +6,14 @@ export declare class HttpRequest implements ReckerRequest {
     readonly body: BodyInit | null;
     readonly signal?: AbortSignal;
     readonly throwHttpErrors?: boolean;
+    readonly timeout?: TimeoutOptions;
     readonly onUploadProgress?: ProgressCallback;
     readonly onDownloadProgress?: ProgressCallback;
+    readonly maxResponseSize?: number;
+    readonly beforeRedirect?: (info: RedirectInfo) => void | false | string | Promise<void | false | string>;
+    readonly maxRedirects?: number;
+    readonly followRedirects?: boolean;
+    readonly http2?: boolean;
     constructor(url: string, options?: RequestOptions);
     withHeader(name: string, value: string): ReckerRequest;
     withBody(body: BodyInit): ReckerRequest;

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

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/core/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5F,qBAAa,WAAY,YAAW,aAAa;IAC/C,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,SAAgB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrC,SAAgB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1C,SAAgB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpD,SAAgB,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;gBAE1C,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAWrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IActD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa;CAWxC"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/core/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAa1H,qBAAa,WAAY,YAAW,aAAa;IAC/C,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,SAAgB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrC,SAAgB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1C,SAAgB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzC,SAAgB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpD,SAAgB,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;IACtD,SAAgB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzC,SAAgB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAChH,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtC,SAAgB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1C,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAiBrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAoBtD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa;CAiBxC"}

package/dist/core/request.js

@@ -1,3 +1,11 @@
+function normalizeTimeout(timeout) {
+    if (timeout === undefined)
+        return undefined;
+    if (typeof timeout === 'number') {
+        return { request: timeout };
+    }
+    return timeout;
+}
 export class HttpRequest {
     url;
     method;
@@ -5,8 +13,14 @@ export class HttpRequest {
     body;
     signal;
     throwHttpErrors;
+    timeout;
     onUploadProgress;
     onDownloadProgress;
+    maxResponseSize;
+    beforeRedirect;
+    maxRedirects;
+    followRedirects;
+    http2;
     constructor(url, options = {}) {
         this.url = url;
         this.method = options.method || 'GET';
@@ -14,8 +28,14 @@ export class HttpRequest {
         this.body = options.body || null;
         this.signal = options.signal;
         this.throwHttpErrors = options.throwHttpErrors !== undefined ? options.throwHttpErrors : true;
+        this.timeout = normalizeTimeout(options.timeout);
         this.onUploadProgress = options.onUploadProgress;
         this.onDownloadProgress = options.onDownloadProgress;
+        this.maxResponseSize = options.maxResponseSize;
+        this.beforeRedirect = options.beforeRedirect;
+        this.maxRedirects = options.maxRedirects;
+        this.followRedirects = options.followRedirects;
+        this.http2 = options.http2;
     }
     withHeader(name, value) {
         const newHeaders = new Headers(this.headers);
@@ -26,8 +46,14 @@ export class HttpRequest {
             body: this.body,
             signal: this.signal,
             throwHttpErrors: this.throwHttpErrors,
+            timeout: this.timeout,
             onUploadProgress: this.onUploadProgress,
             onDownloadProgress: this.onDownloadProgress,
+            maxResponseSize: this.maxResponseSize,
+            beforeRedirect: this.beforeRedirect,
+            maxRedirects: this.maxRedirects,
+            followRedirects: this.followRedirects,
+            http2: this.http2,
         });
     }
     withBody(body) {
@@ -37,8 +63,14 @@ export class HttpRequest {
             body: body,
             signal: this.signal,
             throwHttpErrors: this.throwHttpErrors,
+            timeout: this.timeout,
             onUploadProgress: this.onUploadProgress,
             onDownloadProgress: this.onDownloadProgress,
+            maxResponseSize: this.maxResponseSize,
+            beforeRedirect: this.beforeRedirect,
+            maxRedirects: this.maxRedirects,
+            followRedirects: this.followRedirects,
+            http2: this.http2,
         });
     }
 }

package/dist/core/response.d.ts

@@ -1,6 +1,7 @@
 import { ConnectionInfo, ReckerResponse, Timings, SSEEvent, ProgressEvent } from '../types/index.js';
 import { Dispatcher } from 'undici';
 import { type HeaderInfo, type CacheInfo, type RateLimitInfo } from '../utils/header-parser.js';
+import { type LinkHeaderParser } from '../utils/link-header.js';
 import type { Readable } from 'node:stream';
 export declare class HttpResponse<T = unknown> implements ReckerResponse<T> {
     readonly timings?: Timings;
@@ -17,6 +18,7 @@ export declare class HttpResponse<T = unknown> implements ReckerResponse<T> {
     get url(): string;
     get cache(): CacheInfo;
     get rateLimit(): RateLimitInfo;
+    links(): LinkHeaderParser | null;
     get headerInfo(): HeaderInfo;
     json<R = T>(): Promise<R>;
     text(): Promise<string>;

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

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/core/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAKpC,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC9G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACjE,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,SAAgB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5C,SAAgB,GAAG,EAAE,QAAQ,CAAC;gBAG5B,iBAAiB,EAAE,QAAQ,GAAG,UAAU,CAAC,YAAY,EACrD,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAO;IAkBlE,IAAI,MAAM,WAET;IAED,IAAI,UAAU,WAEb;IAED,IAAI,OAAO,YAEV;IAED,IAAI,EAAE,YAEL;IAED,IAAI,GAAG,WAEN;IAMD,IAAI,KAAK,IAAI,SAAS,CAErB;IAMD,IAAI,SAAS,IAAI,aAAa,CAE7B;IAKD,IAAI,UAAU,IAAI,UAAU,CAE3B;IAEK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAIzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI;IAqBzC,YAAY,IAAI,QAAQ,GAAG,IAAI;IAmBzB,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7D,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC;IAO1B,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC;IAQxB,QAAQ,IAAI,cAAc,CAAC,aAAa,CAAC;IAoDzC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC;CAe5D"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/core/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAKpC,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC9G,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACjE,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,SAAgB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5C,SAAgB,GAAG,EAAE,QAAQ,CAAC;gBAG5B,iBAAiB,EAAE,QAAQ,GAAG,UAAU,CAAC,YAAY,EACrD,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,cAAc,CAAA;KAAO;IAkBlE,IAAI,MAAM,WAET;IAED,IAAI,UAAU,WAEb;IAED,IAAI,OAAO,YAEV;IAED,IAAI,EAAE,YAEL;IAED,IAAI,GAAG,WAEN;IAMD,IAAI,KAAK,IAAI,SAAS,CAErB;IAMD,IAAI,SAAS,IAAI,aAAa,CAE7B;IAiBD,KAAK,IAAI,gBAAgB,GAAG,IAAI;IAOhC,IAAI,UAAU,IAAI,UAAU,CAE3B;IAEK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAIzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI;IAqBzC,YAAY,IAAI,QAAQ,GAAG,IAAI;IAmBzB,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7D,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC;IAO1B,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC;IAgBxB,QAAQ,IAAI,cAAc,CAAC,aAAa,CAAC;IA2EzC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC;CAe5D"}

package/dist/core/response.js

@@ -2,6 +2,8 @@ import { parseSSE } from '../utils/sse.js';
 import { cleanHtml } from '../utils/html-cleaner.js';
 import { webToNodeStream } from '../utils/streaming.js';
 import { parseHeaders } from '../utils/header-parser.js';
+import { parseLinkHeader } from '../utils/link-header.js';
+import { ReckerError } from './errors.js';
 export class HttpResponse {
     timings;
     connection;
@@ -41,6 +43,9 @@ export class HttpResponse {
     get rateLimit() {
         return parseHeaders(this.headers, this.status).rateLimit;
     }
+    links() {
+        return parseLinkHeader(this.headers);
+    }
     get headerInfo() {
         return parseHeaders(this.headers, this.status);
     }
@@ -69,7 +74,11 @@ export class HttpResponse {
     async pipe(destination) {
         const nodeStream = this.toNodeStream();
         if (!nodeStream) {
-            throw new Error('Response has no body to pipe');
+            throw new ReckerError('Response has no body to pipe', undefined, this, [
+                'Ensure the request method returns a body (e.g., not HEAD).',
+                'Check the upstream response status and headers.',
+                'Verify the request was not aborted before receiving a body.'
+            ]);
         }
         return new Promise((resolve, reject) => {
             nodeStream.pipe(destination);
@@ -95,35 +104,51 @@ export class HttpResponse {
         const total = contentLength ? parseInt(contentLength, 10) : undefined;
         let loaded = 0;
         const startTime = Date.now();
-        let lastUpdate = startTime;
+        let lastUpdate = 0;
+        let lastLoaded = 0;
+        let lastRateUpdate = startTime;
+        let smoothedRate = 0;
+        const rateSmoothingFactor = 0.3;
+        const createProgress = (isFinal) => {
+            const now = Date.now();
+            const intervalMs = now - lastRateUpdate;
+            const bytesInInterval = loaded - lastLoaded;
+            if (intervalMs > 0) {
+                const instantRate = (bytesInInterval / intervalMs) * 1000;
+                smoothedRate = smoothedRate === 0
+                    ? instantRate
+                    : smoothedRate * (1 - rateSmoothingFactor) + instantRate * rateSmoothingFactor;
+            }
+            lastLoaded = loaded;
+            lastRateUpdate = now;
+            let percent;
+            if (total) {
+                percent = isFinal ? 100 : Math.min((loaded / total) * 100, 99.9);
+            }
+            return {
+                loaded,
+                transferred: loaded,
+                total,
+                percent,
+                rate: smoothedRate,
+                estimated: total && smoothedRate > 0 ? ((total - loaded) / smoothedRate) * 1000 : undefined,
+                direction: 'download',
+            };
+        };
         const reader = this.raw.body.getReader();
         try {
+            yield createProgress(false);
             while (true) {
                 const { done, value } = await reader.read();
                 if (done) {
-                    const elapsed = (Date.now() - startTime) / 1000;
-                    const rate = elapsed > 0 ? loaded / elapsed : 0;
-                    yield {
-                        loaded,
-                        total,
-                        percent: total ? 100 : undefined,
-                        rate,
-                    };
+                    yield createProgress(true);
                     break;
                 }
                 if (value) {
                     loaded += value.byteLength;
                     const now = Date.now();
-                    const elapsed = (now - startTime) / 1000;
-                    const rate = elapsed > 0 ? loaded / elapsed : 0;
                     if (now - lastUpdate > 100) {
-                        yield {
-                            loaded,
-                            total,
-                            percent: total ? (loaded / total) * 100 : undefined,
-                            rate,
-                            estimated: total && rate > 0 ? ((total - loaded) / rate) * 1000 : undefined,
-                        };
+                        yield createProgress(false);
                         lastUpdate = now;
                     }
                 }

package/dist/events/request-events.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'events';
+import type { ProgressEvent, ReckerResponse, ReckerRequest } from '../types/index.js';
+export interface RequestEvents {
+    request: (request: ReckerRequest) => void;
+    response: (response: ResponseInfo) => void;
+    downloadProgress: (progress: ProgressEvent) => void;
+    uploadProgress: (progress: ProgressEvent) => void;
+    retry: (info: RetryInfo) => void;
+    redirect: (info: EventRedirectInfo) => void;
+    complete: (response: ReckerResponse) => void;
+    error: (error: Error) => void;
+}
+export interface ResponseInfo {
+    status: number;
+    statusText: string;
+    headers: Headers;
+    url: string;
+}
+export interface RetryInfo {
+    attempt: number;
+    maxAttempts: number;
+    error: Error;
+    delay: number;
+}
+export interface EventRedirectInfo {
+    from: string;
+    to: string;
+    status: number;
+}
+export declare class RequestEventEmitter extends EventEmitter {
+    on<E extends keyof RequestEvents>(event: E, listener: RequestEvents[E]): this;
+    once<E extends keyof RequestEvents>(event: E, listener: RequestEvents[E]): this;
+    emit<E extends keyof RequestEvents>(event: E, ...args: Parameters<RequestEvents[E]>): boolean;
+    off<E extends keyof RequestEvents>(event: E, listener: RequestEvents[E]): this;
+    removeListener<E extends keyof RequestEvents>(event: E, listener: RequestEvents[E]): this;
+}
+export declare function createRequestEvents(): RequestEventEmitter;
+export declare function createEventStream(stream: ReadableStream<Uint8Array>, events: RequestEventEmitter, options: {
+    total?: number;
+    direction: 'upload' | 'download';
+    throttleMs?: number;
+}): ReadableStream<Uint8Array>;
+export interface StreamEventsConfig {
+    events: RequestEventEmitter;
+    total?: number;
+    throttleMs?: number;
+}
+//# sourceMappingURL=request-events.d.ts.map

package/dist/events/request-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-events.d.ts","sourceRoot":"","sources":["../../src/events/request-events.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKtF,MAAM,WAAW,aAAa;IAE5B,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAG1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAG3C,gBAAgB,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAGpD,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAGlD,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAGjC,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAG5C,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAG7C,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAI7E,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAI/E,IAAI,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;IAI7F,GAAG,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9E,cAAc,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;CAG1F;AAoBD,wBAAgB,mBAAmB,IAAI,mBAAmB,CAEzD;AAMD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,cAAc,CAAC,UAAU,CAAC,CA6E5B;AAKD,MAAM,WAAW,kBAAkB;IAEjC,MAAM,EAAE,mBAAmB,CAAC;IAG5B,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/events/request-events.js

@@ -0,0 +1,85 @@
+import { EventEmitter } from 'events';
+export class RequestEventEmitter extends EventEmitter {
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    removeListener(event, listener) {
+        return super.removeListener(event, listener);
+    }
+}
+export function createRequestEvents() {
+    return new RequestEventEmitter();
+}
+export function createEventStream(stream, events, options) {
+    const { total, direction, throttleMs = 100 } = options;
+    let loaded = 0;
+    let startTime = Date.now();
+    let lastUpdate = 0;
+    let lastLoaded = 0;
+    let lastRateUpdate = startTime;
+    let smoothedRate = 0;
+    const rateSmoothingFactor = 0.3;
+    const emitProgress = (now, isFinal) => {
+        const intervalMs = now - lastRateUpdate;
+        const bytesInInterval = loaded - lastLoaded;
+        if (intervalMs > 0) {
+            const instantRate = (bytesInInterval / intervalMs) * 1000;
+            smoothedRate = smoothedRate === 0
+                ? instantRate
+                : smoothedRate * (1 - rateSmoothingFactor) + instantRate * rateSmoothingFactor;
+        }
+        lastLoaded = loaded;
+        lastRateUpdate = now;
+        let percent;
+        if (total) {
+            percent = isFinal ? 100 : Math.min((loaded / total) * 100, 99.9);
+        }
+        const progress = {
+            loaded,
+            transferred: loaded,
+            total,
+            percent,
+            rate: smoothedRate,
+            estimated: total && smoothedRate > 0 ? ((total - loaded) / smoothedRate) * 1000 : undefined,
+            direction,
+        };
+        const event = direction === 'download' ? 'downloadProgress' : 'uploadProgress';
+        events.emit(event, progress);
+        lastUpdate = now;
+    };
+    return new ReadableStream({
+        async start(controller) {
+            const reader = stream.getReader();
+            try {
+                emitProgress(Date.now(), false);
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) {
+                        emitProgress(Date.now(), true);
+                        controller.close();
+                        break;
+                    }
+                    loaded += value.byteLength;
+                    const now = Date.now();
+                    if (now - lastUpdate >= throttleMs || (total && loaded === total)) {
+                        emitProgress(now, false);
+                    }
+                    controller.enqueue(value);
+                }
+            }
+            catch (error) {
+                controller.error(error);
+                throw error;
+            }
+        },
+    });
+}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export * from './core/request-promise.js';
 export * from './transport/undici.js';
+export * from './utils/tls-inspector.js';
+export * from './utils/rdap.js';
+export * from './utils/dns-toolkit.js';
 export * from './transport/fetch.js';
-export * from './types/index.js';
 export * from './core/errors.js';
 export * from './core/client.js';
 export * from './core/request.js';
@@ -12,6 +14,7 @@ export * from './plugins/dedup.js';
 export * from './plugins/logger.js';
 export * from './plugins/circuit-breaker.js';
 export * from './plugins/cookie-jar.js';
+export * from './cookies/memory-cookie-jar.js';
 export * from './runner/request-runner.js';
 export * from './contract/index.js';
 export * from './cache/memory-storage.js';
@@ -22,19 +25,42 @@ export * from './plugins/compression.js';
 export * from './utils/streaming.js';
 export * from './utils/request-pool.js';
 export * from './utils/header-parser.js';
+export * from './utils/link-header.js';
 export * from './websocket/client.js';
 export * from './utils/whois.js';
 export * from './utils/dns.js';
 export * from './utils/cert.js';
 export * from './utils/doh.js';
 export * from './utils/upload.js';
+export * from './utils/download.js';
 export * from './utils/user-agent.js';
 export * from './plugins/har-recorder.js';
 export * from './plugins/har-player.js';
 export * from './plugins/graphql.js';
+export * from './plugins/xml.js';
+export * from './plugins/scrape.js';
+export * from './scrape/index.js';
 export * from './plugins/server-timing.js';
+export * from './plugins/auth.js';
 export * from './plugins/proxy-rotator.js';
+export * from './plugins/interface-rotator.js';
+export * from './plugins/hls.js';
+export * from './plugins/jsonrpc.js';
+export * from './plugins/grpc-web.js';
+export * from './plugins/soap.js';
+export * from './plugins/odata.js';
+export * from './plugins/http2-push.js';
+export * from './plugins/http3.js';
 export * from './cache/redis-storage.js';
-export * from './mcp/index.js';
+export * from './events/request-events.js';
+export * from './constants/http-status.js';
+export * from './utils/env-proxy.js';
+export * from './utils/charset.js';
+export * from './utils/client-pool.js';
+export * as presets from './presets/index.js';
+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 { Client as Recker } from './core/client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,7 +1,9 @@
 export * from './core/request-promise.js';
 export * from './transport/undici.js';
+export * from './utils/tls-inspector.js';
+export * from './utils/rdap.js';
+export * from './utils/dns-toolkit.js';
 export * from './transport/fetch.js';
-export * from './types/index.js';
 export * from './core/errors.js';
 export * from './core/client.js';
 export * from './core/request.js';
@@ -12,6 +14,7 @@ export * from './plugins/dedup.js';
 export * from './plugins/logger.js';
 export * from './plugins/circuit-breaker.js';
 export * from './plugins/cookie-jar.js';
+export * from './cookies/memory-cookie-jar.js';
 export * from './runner/request-runner.js';
 export * from './contract/index.js';
 export * from './cache/memory-storage.js';
@@ -22,18 +25,41 @@ export * from './plugins/compression.js';
 export * from './utils/streaming.js';
 export * from './utils/request-pool.js';
 export * from './utils/header-parser.js';
+export * from './utils/link-header.js';
 export * from './websocket/client.js';
 export * from './utils/whois.js';
 export * from './utils/dns.js';
 export * from './utils/cert.js';
 export * from './utils/doh.js';
 export * from './utils/upload.js';
+export * from './utils/download.js';
 export * from './utils/user-agent.js';
 export * from './plugins/har-recorder.js';
 export * from './plugins/har-player.js';
 export * from './plugins/graphql.js';
+export * from './plugins/xml.js';
+export * from './plugins/scrape.js';
+export * from './scrape/index.js';
 export * from './plugins/server-timing.js';
+export * from './plugins/auth.js';
 export * from './plugins/proxy-rotator.js';
+export * from './plugins/interface-rotator.js';
+export * from './plugins/hls.js';
+export * from './plugins/jsonrpc.js';
+export * from './plugins/grpc-web.js';
+export * from './plugins/soap.js';
+export * from './plugins/odata.js';
+export * from './plugins/http2-push.js';
+export * from './plugins/http3.js';
 export * from './cache/redis-storage.js';
-export * from './mcp/index.js';
+export * from './events/request-events.js';
+export * from './constants/http-status.js';
+export * from './utils/env-proxy.js';
+export * from './utils/charset.js';
+export * from './utils/client-pool.js';
+export * as presets from './presets/index.js';
+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 { Client as Recker } from './core/client.js';

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAGV,aAAa,EACb,OAAO,EAEP,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAYjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AA2BD,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAkB;IAExC,SAAgB,OAAO,EAAE,wBAAwB,CAAC;gBAEtC,OAAO,EAAE,gBAAgB;IAwC/B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IA2BjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,SAAgB,KAAK;oBAIH,OAAO,CAAC,OAAO,EAAE,CAAC;qBAQf,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,aAAa,CAAC;oBAWhE,MAAM,KAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;MAIvD;IAKF,SAAgB,SAAS;oBAIP,OAAO,CAAC,WAAW,EAAE,CAAC;oBAQpB,MAAM,KAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;yBAUjC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;2BAOpB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAG/C;IAKF,SAAgB,OAAO;oBAIL,OAAO,CAAC,SAAS,EAAE,CAAC;oBAQlB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;MAOtF;IAKI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,aAAa,IAAI,aAAa,GAAG,SAAS;IAO1C,WAAW,IAAI,OAAO;YAMR,OAAO;YA8BP,UAAU;IAmBxB,OAAO,CAAC,cAAc;CAiCvB;AAYD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEpE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EAGV,aAAa,EACb,OAAO,EAEP,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAYjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AA2BD,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAC,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAkB;IAExC,SAAgB,OAAO,EAAE,wBAAwB,CAAC;gBAEtC,OAAO,EAAE,gBAAgB;IAoC/B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAuBjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC,SAAgB,KAAK;oBACH,OAAO,CAAC,OAAO,EAAE,CAAC;qBAKf,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,aAAa,CAAC;oBAQhE,MAAM,KAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;MAIvD;IAEF,SAAgB,SAAS;oBACP,OAAO,CAAC,WAAW,EAAE,CAAC;oBAKpB,MAAM,KAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;yBAOjC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;2BAIpB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAG/C;IAEF,SAAgB,OAAO;oBACL,OAAO,CAAC,SAAS,EAAE,CAAC;oBAKlB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;MAOtF;IAEI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,IAAI,aAAa,GAAG,SAAS;IAI1C,WAAW,IAAI,OAAO;YAIR,OAAO;YAgDP,UAAU;IAkBxB,OAAO,CAAC,cAAc;CAgCvB;AAYD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEpE"}

package/dist/mcp/client.js

@@ -1,5 +1,7 @@
 import { EventEmitter } from 'events';
 import { createClient } from '../core/client.js';
+import { ReckerError } from '../core/errors.js';
+import { consoleLogger } from '../types/logger.js';
 export class MCPClient extends EventEmitter {
     client;
     endpoint;
@@ -34,9 +36,10 @@ export class MCPClient extends EventEmitter {
             transport: options.transport,
         });
         if (this.options.debug) {
-            this.on('request', (req) => console.log('[MCP Request]', req));
-            this.on('response', (res) => console.log('[MCP Response]', res));
-            this.on('notification', (notif) => console.log('[MCP Notification]', notif));
+            const logger = consoleLogger;
+            this.on('request', (req) => logger.debug({ type: 'mcp-request', data: req }, `[MCP Request] ${JSON.stringify(req)}`));
+            this.on('response', (res) => logger.debug({ type: 'mcp-response', data: res }, `[MCP Response] ${JSON.stringify(res)}`));
+            this.on('notification', (notif) => logger.debug({ type: 'mcp-notification', data: notif }, `[MCP Notification] ${JSON.stringify(notif)}`));
         }
     }
     async connect() {
@@ -125,7 +128,11 @@ export class MCPClient extends EventEmitter {
     }
     async request(method, params) {
         if (!this.initialized && method !== 'initialize') {
-            throw new Error('MCP client not initialized. Call connect() first.');
+            throw new ReckerError('MCP client not initialized. Call connect() first.', undefined, undefined, [
+                'Call connect() before invoking MCP methods.',
+                'Check for initialization errors in serverInfo.',
+                'Ensure the MCP server URL and credentials are correct.'
+            ]);
         }
         const request = {
             jsonrpc: '2.0',
@@ -139,7 +146,11 @@ export class MCPClient extends EventEmitter {
             .json();
         this.emit('response', response);
         if (response.error) {
-            const error = new Error(response.error.message);
+            const error = new ReckerError(response.error.message, undefined, undefined, [
+                'Inspect MCP server logs for the reported error.',
+                'Validate request params against the tool schema.',
+                'Retry if the error is transient.'
+            ]);
             error.code = response.error.code;
             error.data = response.error.data;
             throw error;

package/dist/mcp/contract.d.ts

@@ -0,0 +1,77 @@
+import { z, ZodSchema } from 'zod';
+import type { MCPClient } from './client.js';
+import type { MCPToolResult } from './types.js';
+import type { Client } from '../core/client.js';
+import type { SSEEvent } from '../utils/sse.js';
+export interface MCPToolContract {
+    inputSchema?: ZodSchema;
+    outputSchema?: ZodSchema;
+    stream?: boolean;
+    description?: string;
+}
+export type MCPContractDefinition = Record<string, MCPToolContract>;
+type ToolFunction<T extends MCPToolContract> = (args: T['inputSchema'] extends ZodSchema ? z.infer<T['inputSchema']> : Record<string, unknown>) => Promise<T['outputSchema'] extends ZodSchema ? z.infer<T['outputSchema']> : MCPToolResult>;
+type StreamingToolFunction<T extends MCPToolContract> = (args: T['inputSchema'] extends ZodSchema ? z.infer<T['inputSchema']> : Record<string, unknown>) => AsyncGenerator<string, void, unknown>;
+type MCPToolFunction<T extends MCPToolContract> = T['stream'] extends true ? StreamingToolFunction<T> : ToolFunction<T>;
+export type MCPContractClient<T extends MCPContractDefinition> = {
+    [K in keyof T]: MCPToolFunction<T[K]>;
+} & {
+    raw: <K extends keyof T>(name: K, args: T[K]['inputSchema'] extends ZodSchema ? z.infer<T[K]['inputSchema']> : Record<string, unknown>) => Promise<MCPToolResult>;
+    list: () => Array<{
+        name: string;
+        description?: string;
+        inputSchema?: ZodSchema;
+    }>;
+    has: (name: string) => boolean;
+};
+export declare class MCPContractError extends Error {
+    toolName: string;
+    validationType: 'input' | 'output';
+    originalError: Error;
+    constructor(toolName: string, validationType: 'input' | 'output', originalError: Error);
+}
+export declare function createMCPContract<T extends MCPContractDefinition>(mcp: MCPClient, contract: T): MCPContractClient<T>;
+export declare function createMCPStream(mcp: MCPClient, toolName: string, options?: {
+    inputParam?: string;
+    extraParams?: Record<string, unknown>;
+}): MCPStreamFunction;
+export interface MCPStreamFunction {
+    (input: string): AsyncGenerator<string>;
+    text(input: string): Promise<string>;
+    json<T = unknown>(input: string): Promise<T>;
+}
+export declare function createMCPBatch<T extends MCPContractDefinition>(mcp: MCPClient, contract: T): <K extends keyof T>(calls: Array<{
+    tool: K;
+    args?: T[K]["inputSchema"] extends ZodSchema ? z.infer<T[K]["inputSchema"]> : Record<string, unknown>;
+}>) => Promise<Array<{
+    success: boolean;
+    result?: any;
+    error?: Error;
+}>>;
+export interface SSEStreamOptions {
+    inputParam?: string;
+    extraParams?: Record<string, unknown>;
+    eventType?: string | string[];
+    extractData?: (event: SSEEvent) => string | null;
+    signal?: AbortSignal;
+    timeout?: number;
+}
+export interface SSEStreamFunction {
+    (input: string, options?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): AsyncGenerator<string>;
+    text(input: string, options?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): Promise<string>;
+    json<T = unknown>(input: string, options?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): Promise<T>;
+    events(input: string, options?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): AsyncGenerator<SSEEvent>;
+}
+export declare function createMCPSSEStream(client: Client, endpoint: string, options?: SSEStreamOptions): SSEStreamFunction;
+export declare function createValidatedSSEStream<T extends ZodSchema>(client: Client, endpoint: string, options: SSEStreamOptions & {
+    inputSchema: T;
+}): {
+    (args: z.infer<T>, callOptions?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): AsyncGenerator<string>;
+    text(args: z.infer<T>, callOptions?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): Promise<string>;
+    json<R = unknown>(args: z.infer<T>, callOptions?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): Promise<R>;
+    events(args: z.infer<T>, callOptions?: Pick<SSEStreamOptions, 'signal' | 'timeout'>): AsyncGenerator<SSEEvent>;
+};
+export declare function openAIExtractor(event: SSEEvent): string | null;
+export declare function anthropicExtractor(event: SSEEvent): string | null;
+export {};
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/mcp/contract.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,eAAe;IAE9B,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,YAAY,CAAC,EAAE,SAAS,CAAC;IAEzB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAMpE,KAAK,YAAY,CAAC,CAAC,SAAS,eAAe,IAAI,CAC7C,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3F,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;AAG/F,KAAK,qBAAqB,CAAC,CAAC,SAAS,eAAe,IAAI,CACtD,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3F,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAG3C,KAAK,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,GACtE,qBAAqB,CAAC,CAAC,CAAC,GACxB,YAAY,CAAC,CAAC,CAAC,CAAC;AAGpB,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,GAAG;IAEF,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EACrB,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACjG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5B,IAAI,EAAE,MAAM,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IAEnF,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAChC,CAAC;AAKF,qBAAa,gBAAiB,SAAQ,KAAK;IAEhC,QAAQ,EAAE,MAAM;IAChB,cAAc,EAAE,OAAO,GAAG,QAAQ;IAClC,aAAa,EAAE,KAAK;gBAFpB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,GAAG,QAAQ,EAClC,aAAa,EAAE,KAAK;CAK9B;AA+BD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,EAC/D,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,CAAC,GACV,iBAAiB,CAAC,CAAC,CAAC,CAoGtB;AAoBD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAEP,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GACL,iBAAiB,CA8BnB;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9C;AAgBD,wBAAgB,cAAc,CAAC,CAAC,SAAS,qBAAqB,EAC5D,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,CAAC,IAEG,CAAC,SAAS,MAAM,CAAC,EAC7B,OAAO,KAAK,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvG,CAAC,KACD,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC,CAwCrE;AAMD,MAAM,WAAW,gBAAgB;IAE/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE9B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,GAAG,IAAI,CAAC;IAEjD,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEhG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7F,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;CACzG;AAqCD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,iBAAiB,CAkFnB;AAsBD,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,SAAS,EAC1D,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GAAG;IAC1B,WAAW,EAAE,CAAC,CAAC;CAChB,GACA;IACD,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5G,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;CAChH,CA2EA;AAgBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAoB9D;AAgBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAoBjE"}