rezo 1.0.135 → 1.0.137

package/README.md

@@ -23,7 +23,7 @@
 
 ---
 
-Enterprise-grade HTTP client for Node.js 22+, Bun, Deno, browsers, React Native, and edge runtimes. One API everywhere — HTTP/2, cookies, proxy rotation, stealth mode, web crawling, and 70+ structured error codes out of the box.
+Enterprise-grade HTTP client for Node.js 22+, Bun, Deno, browsers, React Native, and edge runtimes. One API everywhere — HTTP/2, cookies, proxy rotation, stealth mode, web crawling, and 60+ structured error codes out of the box.
 
 ## Install
 
@@ -73,7 +73,7 @@ const { data: posts } = await client.get('/posts');
 <td>Full request lifecycle — DNS, TLS, redirects, retries, cookies, proxies</td>
 </tr>
 <tr>
-<td><strong>70+ Error Codes</strong></td>
+<td><strong>60+ Error Codes</strong></td>
 <td>Structured errors with boolean flags and recovery suggestions</td>
 </tr>
 </table>
@@ -119,7 +119,7 @@ const client = rezo.create({
   stealth: RezoStealth.chrome(),
   proxyManager: {
     proxies: ['socks5://proxy1:1080', 'http://proxy2:8080'],
-    rotation: { strategy: 'random' },
+    rotation: 'random',
     autoDisableDeadProxies: true
   }
 });

package/dist/adapters/entries/curl.d.ts

@@ -4,7 +4,7 @@ import { Agent as HttpsAgent } from 'node:https';
 import { Socket } from 'node:net';
 import { Readable, Writable, WritableOptions } from 'node:stream';
 import { SecureContext, TLSSocket } from 'node:tls';
-import { Cookie as TouchCookie, CookieJar as TouchCookieJar, CreateCookieJarOptions, CreateCookieOptions, Nullable, Store } from 'tough-cookie';
+import { Callback, Cookie as TouchCookie, CookieJar as TouchCookieJar, CreateCookieJarOptions, CreateCookieOptions, GetCookiesOptions, Nullable, SerializedCookieJar, SetCookieOptions, Store } from 'tough-cookie';
 
 export declare class Cookie extends TouchCookie {
 	constructor(options?: CreateCookieOptions);
@@ -67,6 +67,38 @@ export declare class RezoCookieJar extends TouchCookieJar {
 	constructor(cookies: Cookie[], url: string);
 	constructor(store: Nullable<Store>, options?: CreateCookieJarOptions | boolean);
 	private generateCookies;
+	setCookieSync(cookie: string | Cookie, url: string, options?: SetCookieOptions): Cookie | undefined;
+	setCookie(cookie: string | TouchCookie, url: string | URL, callback: Callback<TouchCookie | undefined>): void;
+	setCookie(cookie: string | TouchCookie, url: string | URL, options: SetCookieOptions, callback: Callback<TouchCookie | undefined>): void;
+	setCookie(cookie: string | TouchCookie, url: string | URL, options?: SetCookieOptions): Promise<TouchCookie | undefined>;
+	setCookie(cookie: string | TouchCookie, url: string | URL, options: SetCookieOptions | Callback<TouchCookie | undefined>, callback?: Callback<TouchCookie | undefined>): unknown;
+	getCookies(url: string, callback: Callback<TouchCookie[]>): void;
+	getCookies(url: string | URL, options: GetCookiesOptions | undefined, callback: Callback<TouchCookie[]>): void;
+	getCookies(url: string | URL, options?: GetCookiesOptions): Promise<TouchCookie[]>;
+	getCookies(url: string | URL, options: GetCookiesOptions | undefined | Callback<TouchCookie[]>, callback?: Callback<TouchCookie[]>): unknown;
+	getCookiesSync(url: string, options?: GetCookiesOptions): Cookie[];
+	getCookieString(url: string, callback: Callback<string | undefined>): void;
+	getCookieString(url: string, options: GetCookiesOptions, callback: Callback<string | undefined>): void;
+	getCookieString(url: string, options?: GetCookiesOptions): Promise<string>;
+	getCookieString(url: string, options: GetCookiesOptions | Callback<string | undefined>, callback?: Callback<string | undefined>): unknown;
+	getCookieStringSync(url: string, options?: GetCookiesOptions): string;
+	getSetCookieStrings(url: string, callback: Callback<string[] | undefined>): void;
+	getSetCookieStrings(url: string, options: GetCookiesOptions, callback: Callback<string[] | undefined>): void;
+	getSetCookieStrings(url: string, options?: GetCookiesOptions): Promise<string[] | undefined>;
+	getSetCookieStrings(url: string, options: GetCookiesOptions, callback?: Callback<string[] | undefined>): unknown;
+	getSetCookieStringsSync(url: string, options?: GetCookiesOptions): string[];
+	serialize(callback: Callback<SerializedCookieJar>): void;
+	serialize(): Promise<SerializedCookieJar>;
+	serializeSync(): SerializedCookieJar | undefined;
+	toJSON(): ReturnType<TouchCookieJar["toJSON"]>;
+	private toPublicSerializedJar;
+	private toStoredCookie;
+	private toPublicCookies;
+	private toPublicCookie;
+	private toStoredCookieKey;
+	private toPublicCookieKey;
+	private cookiesToCookieString;
+	private cookiesToSetCookieStrings;
 	/**
 	 * Get all cookies from the cookie jar.
 	 *
@@ -317,6 +349,9 @@ export declare class RezoHeaders extends Headers {
 	 * Used by stealth adapters to match browser header ordering.
 	 */
 	toOrderedObject(order: string[]): Record<string, string | string[]>;
+	toJSON(): Record<string, string> & {
+		"set-cookie"?: string[];
+	};
 	toObject(omit?: Array<keyof RezoHttpHeaders> | keyof RezoHttpHeaders): Record<string, string | string[]>;
 	toString(): string;
 	set(name: keyof RezoHttpHeaders, value: string): void;
@@ -7002,9 +7037,9 @@ export interface httpAdapterOverloads {
 	request(options: RezoRequestOptions & {
 		responseType: "blob";
 	}): Promise<RezoResponse<Blob>>;
-	request(options: RezoRequestOptions & {
+	request<T extends string = string>(options: RezoRequestOptions & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	request(options: RezoRequestOptions & {
 		responseType: "download";
 	}): Promise<RezoDownloadResponse>;
@@ -7034,9 +7069,9 @@ export interface httpAdapterOverloads {
 	get(url: string | URL, options: RezoHttpGetRequest & {
 		responseType: "blob";
 	}): Promise<RezoResponse<Blob>>;
-	get(url: string | URL, options: RezoHttpGetRequest & {
+	get<T extends string = string>(url: string | URL, options: RezoHttpGetRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	get(url: string | URL, options: RezoHttpGetRequest & {
 		responseType: "download";
 	}): Promise<RezoDownloadResponse>;
@@ -7068,9 +7103,9 @@ export interface httpAdapterOverloads {
 	delete(url: string | URL, options: RezoHttpDeleteRequest & {
 		responseType: "blob";
 	}): Promise<RezoResponse<Blob>>;
-	delete(url: string | URL, options: RezoHttpDeleteRequest & {
+	delete<T extends string = string>(url: string | URL, options: RezoHttpDeleteRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	delete(url: string | URL, options: RezoHttpDeleteRequest & {
 		responseType: "download";
 	}): Promise<RezoDownloadResponse>;
@@ -7157,9 +7192,9 @@ export interface httpAdapterPostOverloads {
 	post(url: string | URL, data: any, options: RezoHttpPostRequest & {
 		responseType: "blob";
 	}): Promise<RezoResponse<Blob>>;
-	post(url: string | URL, data: any, options: RezoHttpPostRequest & {
+	post<T extends string = string>(url: string | URL, data: any, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	post(url: string | URL, data: any, options: RezoHttpPostRequest & {
 		responseType: "download";
 	}): Promise<RezoDownloadResponse>;
@@ -7187,15 +7222,15 @@ export interface httpAdapterPostOverloads {
 	postJson<T = any>(url: string | URL, nullData: null | undefined, options: RezoHttpPostRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	postJson(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPostRequest & {
+	postJson<T extends string = string>(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	postJson(url: string | URL, jsonString: string, options: RezoHttpPostRequest & {
+	}): Promise<RezoResponse<T>>;
+	postJson<T extends string = string>(url: string | URL, jsonString: string, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	postJson(url: string | URL, nullData: null | undefined, options: RezoHttpPostRequest & {
+	}): Promise<RezoResponse<T>>;
+	postJson<T extends string = string>(url: string | URL, nullData: null | undefined, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	postJson(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPostRequest & {
 		responseType: "arrayBuffer";
 	}): Promise<RezoResponse<ArrayBuffer>>;
@@ -7247,15 +7282,15 @@ export interface httpAdapterPostOverloads {
 	postForm<T = any>(url: string | URL, nullData: null | undefined, options: RezoHttpPostRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	postForm(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPostRequest & {
+	postForm<T extends string = string>(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	postForm(url: string | URL, string: string, options: RezoHttpPostRequest & {
+	}): Promise<RezoResponse<T>>;
+	postForm<T extends string = string>(url: string | URL, string: string, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	postForm(url: string | URL, nullData: null | undefined, options: RezoHttpPostRequest & {
+	}): Promise<RezoResponse<T>>;
+	postForm<T extends string = string>(url: string | URL, nullData: null | undefined, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	postForm(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPostRequest & {
 		responseType: "arrayBuffer";
 	}): Promise<RezoResponse<ArrayBuffer>>;
@@ -7316,15 +7351,15 @@ export interface httpAdapterPostOverloads {
 	postMultipart<T = any>(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPostRequest & {
 		responseType: "json";
 	}): Promise<RezoResponse<T>>;
-	postMultipart(url: string | URL, formData: RezoFormData, options: RezoHttpPostRequest & {
+	postMultipart<T extends string = string>(url: string | URL, formData: RezoFormData, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	postMultipart(url: string | URL, formData: FormData, options: RezoHttpPostRequest & {
+	}): Promise<RezoResponse<T>>;
+	postMultipart<T extends string = string>(url: string | URL, formData: FormData, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	postMultipart(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPostRequest & {
+	}): Promise<RezoResponse<T>>;
+	postMultipart<T extends string = string>(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPostRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	postMultipart(url: string | URL, formData: RezoFormData, options: RezoHttpPostRequest & {
 		responseType: "stream";
 	}): Promise<RezoStreamResponse>;
@@ -7380,9 +7415,9 @@ export interface httpAdapterPatchOverloads {
 	patch(url: string | URL, data: any, options: RezoHttpPatchRequest & {
 		responseType: "blob";
 	}): Promise<RezoResponse<Blob>>;
-	patch(url: string | URL, data: any, options: RezoHttpPatchRequest & {
+	patch<T extends string = string>(url: string | URL, data: any, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	patch(url: string | URL, data: any, options: RezoHttpPatchRequest & {
 		responseType: "download";
 	}): RezoDownloadResponse;
@@ -7410,15 +7445,15 @@ export interface httpAdapterPatchOverloads {
 	patchJson<T = any>(url: string | URL, nullData: null | undefined, options: RezoHttpPatchRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	patchJson(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPatchRequest & {
+	patchJson<T extends string = string>(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	patchJson(url: string | URL, jsonString: string, options: RezoHttpPatchRequest & {
+	}): Promise<RezoResponse<T>>;
+	patchJson<T extends string = string>(url: string | URL, jsonString: string, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	patchJson(url: string | URL, nullData: null | undefined, options: RezoHttpPatchRequest & {
+	}): Promise<RezoResponse<T>>;
+	patchJson<T extends string = string>(url: string | URL, nullData: null | undefined, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	patchJson(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPatchRequest & {
 		responseType: "arrayBuffer";
 	}): Promise<RezoResponse<ArrayBuffer>>;
@@ -7479,15 +7514,15 @@ export interface httpAdapterPatchOverloads {
 	patchForm<T = any>(url: string | URL, nullData: null | undefined, options: RezoHttpPatchRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	patchForm(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPatchRequest & {
+	patchForm<T extends string = string>(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	patchForm(url: string | URL, string: string, options: RezoHttpPatchRequest & {
+	}): Promise<RezoResponse<T>>;
+	patchForm<T extends string = string>(url: string | URL, string: string, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	patchForm(url: string | URL, nullData: null | undefined, options: RezoHttpPatchRequest & {
+	}): Promise<RezoResponse<T>>;
+	patchForm<T extends string = string>(url: string | URL, nullData: null | undefined, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	patchForm(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPatchRequest & {
 		responseType: "arrayBuffer";
 	}): Promise<RezoResponse<ArrayBuffer>>;
@@ -7548,15 +7583,15 @@ export interface httpAdapterPatchOverloads {
 	patchMultipart<T = any>(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPatchRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	patchMultipart(url: string | URL, formData: RezoFormData, options: RezoHttpPatchRequest & {
+	patchMultipart<T extends string = string>(url: string | URL, formData: RezoFormData, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	patchMultipart(url: string | URL, formData: FormData, options: RezoHttpPatchRequest & {
+	}): Promise<RezoResponse<T>>;
+	patchMultipart<T extends string = string>(url: string | URL, formData: FormData, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	patchMultipart(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPatchRequest & {
+	}): Promise<RezoResponse<T>>;
+	patchMultipart<T extends string = string>(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPatchRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	patchMultipart(url: string | URL, formData: RezoFormData, options: RezoHttpPatchRequest & {
 		responseType: "stream";
 	}): RezoStreamResponse;
@@ -7621,9 +7656,9 @@ export interface httpAdapterPutOverloads {
 	put(url: string | URL, data: any, options: RezoHttpPutRequest & {
 		responseType: "blob";
 	}): Promise<RezoResponse<Blob>>;
-	put(url: string | URL, data: any, options: RezoHttpPutRequest & {
+	put<T extends string = string>(url: string | URL, data: any, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	put(url: string | URL, data: any, options: RezoHttpPutRequest & {
 		responseType: "download";
 	}): RezoDownloadResponse;
@@ -7651,15 +7686,15 @@ export interface httpAdapterPutOverloads {
 	putJson<T = any>(url: string | URL, nullData: null | undefined, options: RezoHttpPutRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	putJson(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPutRequest & {
+	putJson<T extends string = string>(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	putJson(url: string | URL, jsonString: string, options: RezoHttpPutRequest & {
+	}): Promise<RezoResponse<T>>;
+	putJson<T extends string = string>(url: string | URL, jsonString: string, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	putJson(url: string | URL, nullData: null | undefined, options: RezoHttpPutRequest & {
+	}): Promise<RezoResponse<T>>;
+	putJson<T extends string = string>(url: string | URL, nullData: null | undefined, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	putJson(url: string | URL, data: Record<any, any> | Array<any>, options: RezoHttpPutRequest & {
 		responseType: "arrayBuffer";
 	}): Promise<RezoResponse<ArrayBuffer>>;
@@ -7720,15 +7755,15 @@ export interface httpAdapterPutOverloads {
 	putForm<T = any>(url: string | URL, nullData: null | undefined, options: RezoHttpPutRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	putForm(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPutRequest & {
+	putForm<T extends string = string>(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	putForm(url: string | URL, string: string, options: RezoHttpPutRequest & {
+	}): Promise<RezoResponse<T>>;
+	putForm<T extends string = string>(url: string | URL, string: string, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	putForm(url: string | URL, nullData: null | undefined, options: RezoHttpPutRequest & {
+	}): Promise<RezoResponse<T>>;
+	putForm<T extends string = string>(url: string | URL, nullData: null | undefined, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	putForm(url: string | URL, data: URLSearchParams | RezoURLSearchParams | Record<string, any>, options: RezoHttpPutRequest & {
 		responseType: "arrayBuffer";
 	}): Promise<RezoResponse<ArrayBuffer>>;
@@ -7789,15 +7824,15 @@ export interface httpAdapterPutOverloads {
 	putMultipart<T = any>(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPutRequest & {
 		responseType: "auto" | "json";
 	}): Promise<RezoResponse<T>>;
-	putMultipart(url: string | URL, formData: RezoFormData, options: RezoHttpPutRequest & {
+	putMultipart<T extends string = string>(url: string | URL, formData: RezoFormData, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	putMultipart(url: string | URL, formData: FormData, options: RezoHttpPutRequest & {
+	}): Promise<RezoResponse<T>>;
+	putMultipart<T extends string = string>(url: string | URL, formData: FormData, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
-	putMultipart(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPutRequest & {
+	}): Promise<RezoResponse<T>>;
+	putMultipart<T extends string = string>(url: string | URL, dataObject: Record<string, any>, options: RezoHttpPutRequest & {
 		responseType: "text";
-	}): Promise<RezoResponse<string>>;
+	}): Promise<RezoResponse<T>>;
 	putMultipart(url: string | URL, formData: RezoFormData, options: RezoHttpPutRequest & {
 		responseType: "stream";
 	}): RezoStreamResponse;
@@ -8546,7 +8581,7 @@ export interface RezoInstance extends Rezo, RezoCallable {
  *
  * IMPORTANT: Update these values when bumping package version.
  */
-export declare const VERSION = "1.0.135";
+export declare const VERSION = "1.0.137";
 export declare const isRezoError: typeof RezoError.isRezoError;
 export declare const Cancel: typeof RezoError;
 export declare const CancelToken: {