rezo 1.0.13 → 1.0.15

package/dist/adapters/index.cjs

@@ -1,6 +1,6 @@
-const _mod_h6yyuw = require('./picker.cjs');
-exports.detectRuntime = _mod_h6yyuw.detectRuntime;
-exports.getAdapterCapabilities = _mod_h6yyuw.getAdapterCapabilities;
-exports.buildAdapterContext = _mod_h6yyuw.buildAdapterContext;
-exports.getAvailableAdapters = _mod_h6yyuw.getAvailableAdapters;
-exports.selectAdapter = _mod_h6yyuw.selectAdapter;;
+const _mod_58re9h = require('./picker.cjs');
+exports.detectRuntime = _mod_58re9h.detectRuntime;
+exports.getAdapterCapabilities = _mod_58re9h.getAdapterCapabilities;
+exports.buildAdapterContext = _mod_58re9h.buildAdapterContext;
+exports.getAvailableAdapters = _mod_58re9h.getAvailableAdapters;
+exports.selectAdapter = _mod_58re9h.selectAdapter;;

package/dist/adapters/picker.cjs

@@ -133,7 +133,7 @@ function getAdapterCapabilities(adapter) {
 function buildAdapterContext(options, defaultOptions) {
   const internal = options;
   return {
-    needsCookies: !!(options.cookieJar || defaultOptions.cookieJar),
+    needsCookies: !!(options.jar || defaultOptions.jar),
     needsProxy: !!options.proxy,
     needsStreaming: !!internal._isStream,
     needsHttp2: false,

package/dist/adapters/picker.js

@@ -133,7 +133,7 @@ export function getAdapterCapabilities(adapter) {
 export function buildAdapterContext(options, defaultOptions) {
   const internal = options;
   return {
-    needsCookies: !!(options.cookieJar || defaultOptions.cookieJar),
+    needsCookies: !!(options.jar || defaultOptions.jar),
     needsProxy: !!options.proxy,
     needsStreaming: !!internal._isStream,
     needsHttp2: false,

package/dist/cache/index.cjs

@@ -1,13 +1,13 @@
-const _mod_vgyhxh = require('./lru-cache.cjs');
-exports.LRUCache = _mod_vgyhxh.LRUCache;;
-const _mod_57d30y = require('./dns-cache.cjs');
-exports.DNSCache = _mod_57d30y.DNSCache;
-exports.getGlobalDNSCache = _mod_57d30y.getGlobalDNSCache;
-exports.resetGlobalDNSCache = _mod_57d30y.resetGlobalDNSCache;;
-const _mod_qx55fg = require('./response-cache.cjs');
-exports.ResponseCache = _mod_qx55fg.ResponseCache;
-exports.normalizeResponseCacheConfig = _mod_qx55fg.normalizeResponseCacheConfig;;
-const _mod_clz0cm = require('./file-cacher.cjs');
-exports.FileCacher = _mod_clz0cm.FileCacher;;
-const _mod_39vswi = require('./url-store.cjs');
-exports.UrlStore = _mod_39vswi.UrlStore;;
+const _mod_4clxtx = require('./lru-cache.cjs');
+exports.LRUCache = _mod_4clxtx.LRUCache;;
+const _mod_8thcxt = require('./dns-cache.cjs');
+exports.DNSCache = _mod_8thcxt.DNSCache;
+exports.getGlobalDNSCache = _mod_8thcxt.getGlobalDNSCache;
+exports.resetGlobalDNSCache = _mod_8thcxt.resetGlobalDNSCache;;
+const _mod_k4qt4t = require('./response-cache.cjs');
+exports.ResponseCache = _mod_k4qt4t.ResponseCache;
+exports.normalizeResponseCacheConfig = _mod_k4qt4t.normalizeResponseCacheConfig;;
+const _mod_7l7g18 = require('./file-cacher.cjs');
+exports.FileCacher = _mod_7l7g18.FileCacher;;
+const _mod_x7x6qu = require('./url-store.cjs');
+exports.UrlStore = _mod_x7x6qu.UrlStore;;

package/dist/core/rezo.cjs

@@ -49,8 +49,8 @@ class Rezo {
     }
     this.adapter = adapter || globalAdapter;
     this.defaults = config || {};
-    if (config?.cookieJar instanceof RezoCookieJar) {
-      this.jar = config.cookieJar;
+    if (config?.jar instanceof RezoCookieJar) {
+      this.jar = config.jar;
     } else if (config?.cookieFile) {
       this.jar = RezoCookieJar.fromFile(config.cookieFile);
     } else {
@@ -176,11 +176,18 @@ class Rezo {
     }, this.defaults, this.jar);
   };
   postMultipart = async (url, data, options = {}) => {
-    data = data instanceof FormData ? await RezoFormData.fromNativeFormData(data) : data;
+    let formData;
+    if (data instanceof RezoFormData) {
+      formData = data;
+    } else if (data instanceof FormData) {
+      formData = await RezoFormData.fromNativeFormData(data);
+    } else {
+      formData = RezoFormData.fromObject(data);
+    }
     return this.executeRequest({
       ...options,
       url,
-      formData: data,
+      formData,
       method: "POST"
     }, this.defaults, this.jar);
   };
@@ -217,11 +224,18 @@ class Rezo {
     }, this.defaults, this.jar);
   };
   putMultipart = async (url, data, options = {}) => {
-    data = data instanceof FormData ? await RezoFormData.fromNativeFormData(data) : data;
+    let formData;
+    if (data instanceof RezoFormData) {
+      formData = data;
+    } else if (data instanceof FormData) {
+      formData = await RezoFormData.fromNativeFormData(data);
+    } else {
+      formData = RezoFormData.fromObject(data);
+    }
     return this.executeRequest({
       ...options,
       url,
-      formData: data,
+      formData,
       method: "PUT"
     }, this.defaults, this.jar);
   };
@@ -258,11 +272,18 @@ class Rezo {
     }, this.defaults, this.jar);
   };
   patchMultipart = async (url, data, options = {}) => {
-    data = data instanceof FormData ? await RezoFormData.fromNativeFormData(data) : data;
+    let formData;
+    if (data instanceof RezoFormData) {
+      formData = data;
+    } else if (data instanceof FormData) {
+      formData = await RezoFormData.fromNativeFormData(data);
+    } else {
+      formData = RezoFormData.fromObject(data);
+    }
     return this.executeRequest({
       ...options,
       url,
-      formData: data,
+      formData,
       method: "PATCH"
     }, this.defaults, this.jar);
   };

package/dist/core/rezo.js

@@ -49,8 +49,8 @@ export class Rezo {
     }
     this.adapter = adapter || globalAdapter;
     this.defaults = config || {};
-    if (config?.cookieJar instanceof RezoCookieJar) {
-      this.jar = config.cookieJar;
+    if (config?.jar instanceof RezoCookieJar) {
+      this.jar = config.jar;
     } else if (config?.cookieFile) {
       this.jar = RezoCookieJar.fromFile(config.cookieFile);
     } else {
@@ -176,11 +176,18 @@ export class Rezo {
     }, this.defaults, this.jar);
   };
   postMultipart = async (url, data, options = {}) => {
-    data = data instanceof FormData ? await RezoFormData.fromNativeFormData(data) : data;
+    let formData;
+    if (data instanceof RezoFormData) {
+      formData = data;
+    } else if (data instanceof FormData) {
+      formData = await RezoFormData.fromNativeFormData(data);
+    } else {
+      formData = RezoFormData.fromObject(data);
+    }
     return this.executeRequest({
       ...options,
       url,
-      formData: data,
+      formData,
       method: "POST"
     }, this.defaults, this.jar);
   };
@@ -217,11 +224,18 @@ export class Rezo {
     }, this.defaults, this.jar);
   };
   putMultipart = async (url, data, options = {}) => {
-    data = data instanceof FormData ? await RezoFormData.fromNativeFormData(data) : data;
+    let formData;
+    if (data instanceof RezoFormData) {
+      formData = data;
+    } else if (data instanceof FormData) {
+      formData = await RezoFormData.fromNativeFormData(data);
+    } else {
+      formData = RezoFormData.fromObject(data);
+    }
     return this.executeRequest({
       ...options,
       url,
-      formData: data,
+      formData,
       method: "PUT"
     }, this.defaults, this.jar);
   };
@@ -258,11 +272,18 @@ export class Rezo {
     }, this.defaults, this.jar);
   };
   patchMultipart = async (url, data, options = {}) => {
-    data = data instanceof FormData ? await RezoFormData.fromNativeFormData(data) : data;
+    let formData;
+    if (data instanceof RezoFormData) {
+      formData = data;
+    } else if (data instanceof FormData) {
+      formData = await RezoFormData.fromNativeFormData(data);
+    } else {
+      formData = RezoFormData.fromObject(data);
+    }
     return this.executeRequest({
       ...options,
       url,
-      formData: data,
+      formData,
       method: "PATCH"
     }, this.defaults, this.jar);
   };

package/dist/crawler.d.ts

@@ -537,11 +537,19 @@ declare class RezoFormData extends NodeFormData {
 	toBuffer(): Buffer;
 	/**
 	 * Create RezoFormData from object
+	 * Properly handles nested objects by JSON.stringify-ing them
 	 * @param {Record<string, any>} obj - Object to convert
 	 * @param {Options} options - Optional RezoFormData options
 	 * @returns {RezoFormData}
 	 */
 	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Helper to append a value to FormData with proper type handling
+	 * @param {RezoFormData} formData - The form data to append to
+	 * @param {string} key - The field name
+	 * @param {any} value - The value to append
+	 */
+	private static appendValue;
 	/**
 	 * Convert to URL query string
 	 * Warning: File, Blob, and binary data will be omitted
@@ -2803,8 +2811,19 @@ export interface RezoRequestConfig<D = any> {
 	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoCookieJar;
+	/**
+	 * Custom cookie jar for managing cookies in this request.
+	 * Note: Passing jar per-request is supported but not recommended.
+	 * For better cookie management, pass the jar when creating the instance:
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 * If you need custom cookies for a single request, use the `cookies` option instead.
+	 */
+	jar?: RezoCookieJar;
 	/** Cookies to send with the request in various formats */
 	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
 	/** Callback for upload progress events */
@@ -3235,8 +3254,17 @@ export interface RezoDefaultOptions {
 	hooks?: Partial<RezoHooks>;
 	/** Whether to enable automatic cookie handling (default: true)*/
 	enableCookieJar?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoHttpRequest["cookieJar"];
+	/**
+	 * Custom cookie jar for managing cookies.
+	 * The recommended way to manage cookies - pass the jar when creating the instance.
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 */
+	jar?: RezoHttpRequest["jar"];
 	/** Set default cookies to send with the requests in various formats */
 	cookies?: RezoHttpRequest["cookies"];
 	/**

package/dist/entries/crawler.cjs

@@ -1,5 +1,5 @@
-const _mod_m9euun = require('../plugin/crawler.cjs');
-exports.Crawler = _mod_m9euun.Crawler;;
-const _mod_358g2f = require('../plugin/crawler-options.cjs');
-exports.CrawlerOptions = _mod_358g2f.CrawlerOptions;
-exports.Domain = _mod_358g2f.Domain;;
+const _mod_sr4bcr = require('../plugin/crawler.cjs');
+exports.Crawler = _mod_sr4bcr.Crawler;;
+const _mod_fra6kj = require('../plugin/crawler-options.cjs');
+exports.CrawlerOptions = _mod_fra6kj.CrawlerOptions;
+exports.Domain = _mod_fra6kj.Domain;;

package/dist/index.cjs

@@ -1,27 +1,27 @@
-const _mod_txkkmz = require('./core/rezo.cjs');
-exports.Rezo = _mod_txkkmz.Rezo;
-exports.createRezoInstance = _mod_txkkmz.createRezoInstance;
-exports.createDefaultInstance = _mod_txkkmz.createDefaultInstance;;
-const _mod_a3vsp1 = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_a3vsp1.RezoError;
-exports.RezoErrorCode = _mod_a3vsp1.RezoErrorCode;;
-const _mod_2ef980 = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_2ef980.RezoHeaders;;
-const _mod_e56bdp = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_e56bdp.RezoFormData;;
-const _mod_ss7zpn = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_ss7zpn.RezoCookieJar;
-exports.Cookie = _mod_ss7zpn.Cookie;;
-const _mod_vdi6fa = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_vdi6fa.createDefaultHooks;
-exports.mergeHooks = _mod_vdi6fa.mergeHooks;;
-const _mod_049k4s = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_049k4s.ProxyManager;;
-const _mod_5l0v67 = require('./queue/index.cjs');
-exports.RezoQueue = _mod_5l0v67.RezoQueue;
-exports.HttpQueue = _mod_5l0v67.HttpQueue;
-exports.Priority = _mod_5l0v67.Priority;
-exports.HttpMethodPriority = _mod_5l0v67.HttpMethodPriority;;
+const _mod_izj7ua = require('./core/rezo.cjs');
+exports.Rezo = _mod_izj7ua.Rezo;
+exports.createRezoInstance = _mod_izj7ua.createRezoInstance;
+exports.createDefaultInstance = _mod_izj7ua.createDefaultInstance;;
+const _mod_tgc1sb = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_tgc1sb.RezoError;
+exports.RezoErrorCode = _mod_tgc1sb.RezoErrorCode;;
+const _mod_h7bez0 = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_h7bez0.RezoHeaders;;
+const _mod_ez8yvh = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_ez8yvh.RezoFormData;;
+const _mod_fqunh0 = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_fqunh0.RezoCookieJar;
+exports.Cookie = _mod_fqunh0.Cookie;;
+const _mod_ydcmkw = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_ydcmkw.createDefaultHooks;
+exports.mergeHooks = _mod_ydcmkw.mergeHooks;;
+const _mod_3apyk1 = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_3apyk1.ProxyManager;;
+const _mod_ilywic = require('./queue/index.cjs');
+exports.RezoQueue = _mod_ilywic.RezoQueue;
+exports.HttpQueue = _mod_ilywic.HttpQueue;
+exports.Priority = _mod_ilywic.Priority;
+exports.HttpMethodPriority = _mod_ilywic.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/index.d.ts

@@ -314,11 +314,19 @@ export declare class RezoFormData extends NodeFormData {
 	toBuffer(): Buffer;
 	/**
 	 * Create RezoFormData from object
+	 * Properly handles nested objects by JSON.stringify-ing them
 	 * @param {Record<string, any>} obj - Object to convert
 	 * @param {Options} options - Optional RezoFormData options
 	 * @returns {RezoFormData}
 	 */
 	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Helper to append a value to FormData with proper type handling
+	 * @param {RezoFormData} formData - The form data to append to
+	 * @param {string} key - The field name
+	 * @param {any} value - The value to append
+	 */
+	private static appendValue;
 	/**
 	 * Convert to URL query string
 	 * Warning: File, Blob, and binary data will be omitted
@@ -2811,8 +2819,19 @@ export interface RezoRequestConfig<D = any> {
 	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoCookieJar;
+	/**
+	 * Custom cookie jar for managing cookies in this request.
+	 * Note: Passing jar per-request is supported but not recommended.
+	 * For better cookie management, pass the jar when creating the instance:
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 * If you need custom cookies for a single request, use the `cookies` option instead.
+	 */
+	jar?: RezoCookieJar;
 	/** Cookies to send with the request in various formats */
 	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
 	/** Callback for upload progress events */
@@ -3262,8 +3281,17 @@ export interface RezoDefaultOptions {
 	hooks?: Partial<RezoHooks>;
 	/** Whether to enable automatic cookie handling (default: true)*/
 	enableCookieJar?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoHttpRequest["cookieJar"];
+	/**
+	 * Custom cookie jar for managing cookies.
+	 * The recommended way to manage cookies - pass the jar when creating the instance.
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 */
+	jar?: RezoHttpRequest["jar"];
 	/** Set default cookies to send with the requests in various formats */
 	cookies?: RezoHttpRequest["cookies"];
 	/**

package/dist/platform/browser.d.ts

@@ -314,11 +314,19 @@ export declare class RezoFormData extends NodeFormData {
 	toBuffer(): Buffer;
 	/**
 	 * Create RezoFormData from object
+	 * Properly handles nested objects by JSON.stringify-ing them
 	 * @param {Record<string, any>} obj - Object to convert
 	 * @param {Options} options - Optional RezoFormData options
 	 * @returns {RezoFormData}
 	 */
 	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Helper to append a value to FormData with proper type handling
+	 * @param {RezoFormData} formData - The form data to append to
+	 * @param {string} key - The field name
+	 * @param {any} value - The value to append
+	 */
+	private static appendValue;
 	/**
 	 * Convert to URL query string
 	 * Warning: File, Blob, and binary data will be omitted
@@ -2685,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
 	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoCookieJar;
+	/**
+	 * Custom cookie jar for managing cookies in this request.
+	 * Note: Passing jar per-request is supported but not recommended.
+	 * For better cookie management, pass the jar when creating the instance:
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 * If you need custom cookies for a single request, use the `cookies` option instead.
+	 */
+	jar?: RezoCookieJar;
 	/** Cookies to send with the request in various formats */
 	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
 	/** Callback for upload progress events */
@@ -3117,8 +3136,17 @@ export interface RezoDefaultOptions {
 	hooks?: Partial<RezoHooks>;
 	/** Whether to enable automatic cookie handling (default: true)*/
 	enableCookieJar?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoHttpRequest["cookieJar"];
+	/**
+	 * Custom cookie jar for managing cookies.
+	 * The recommended way to manage cookies - pass the jar when creating the instance.
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 */
+	jar?: RezoHttpRequest["jar"];
 	/** Set default cookies to send with the requests in various formats */
 	cookies?: RezoHttpRequest["cookies"];
 	/**

package/dist/platform/bun.d.ts

@@ -314,11 +314,19 @@ export declare class RezoFormData extends NodeFormData {
 	toBuffer(): Buffer;
 	/**
 	 * Create RezoFormData from object
+	 * Properly handles nested objects by JSON.stringify-ing them
 	 * @param {Record<string, any>} obj - Object to convert
 	 * @param {Options} options - Optional RezoFormData options
 	 * @returns {RezoFormData}
 	 */
 	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Helper to append a value to FormData with proper type handling
+	 * @param {RezoFormData} formData - The form data to append to
+	 * @param {string} key - The field name
+	 * @param {any} value - The value to append
+	 */
+	private static appendValue;
 	/**
 	 * Convert to URL query string
 	 * Warning: File, Blob, and binary data will be omitted
@@ -2685,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
 	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoCookieJar;
+	/**
+	 * Custom cookie jar for managing cookies in this request.
+	 * Note: Passing jar per-request is supported but not recommended.
+	 * For better cookie management, pass the jar when creating the instance:
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 * If you need custom cookies for a single request, use the `cookies` option instead.
+	 */
+	jar?: RezoCookieJar;
 	/** Cookies to send with the request in various formats */
 	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
 	/** Callback for upload progress events */
@@ -3117,8 +3136,17 @@ export interface RezoDefaultOptions {
 	hooks?: Partial<RezoHooks>;
 	/** Whether to enable automatic cookie handling (default: true)*/
 	enableCookieJar?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoHttpRequest["cookieJar"];
+	/**
+	 * Custom cookie jar for managing cookies.
+	 * The recommended way to manage cookies - pass the jar when creating the instance.
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 */
+	jar?: RezoHttpRequest["jar"];
 	/** Set default cookies to send with the requests in various formats */
 	cookies?: RezoHttpRequest["cookies"];
 	/**

package/dist/platform/deno.d.ts

@@ -314,11 +314,19 @@ export declare class RezoFormData extends NodeFormData {
 	toBuffer(): Buffer;
 	/**
 	 * Create RezoFormData from object
+	 * Properly handles nested objects by JSON.stringify-ing them
 	 * @param {Record<string, any>} obj - Object to convert
 	 * @param {Options} options - Optional RezoFormData options
 	 * @returns {RezoFormData}
 	 */
 	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Helper to append a value to FormData with proper type handling
+	 * @param {RezoFormData} formData - The form data to append to
+	 * @param {string} key - The field name
+	 * @param {any} value - The value to append
+	 */
+	private static appendValue;
 	/**
 	 * Convert to URL query string
 	 * Warning: File, Blob, and binary data will be omitted
@@ -2685,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
 	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoCookieJar;
+	/**
+	 * Custom cookie jar for managing cookies in this request.
+	 * Note: Passing jar per-request is supported but not recommended.
+	 * For better cookie management, pass the jar when creating the instance:
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 * If you need custom cookies for a single request, use the `cookies` option instead.
+	 */
+	jar?: RezoCookieJar;
 	/** Cookies to send with the request in various formats */
 	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
 	/** Callback for upload progress events */
@@ -3117,8 +3136,17 @@ export interface RezoDefaultOptions {
 	hooks?: Partial<RezoHooks>;
 	/** Whether to enable automatic cookie handling (default: true)*/
 	enableCookieJar?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoHttpRequest["cookieJar"];
+	/**
+	 * Custom cookie jar for managing cookies.
+	 * The recommended way to manage cookies - pass the jar when creating the instance.
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 */
+	jar?: RezoHttpRequest["jar"];
 	/** Set default cookies to send with the requests in various formats */
 	cookies?: RezoHttpRequest["cookies"];
 	/**

package/dist/platform/node.d.ts

@@ -314,11 +314,19 @@ export declare class RezoFormData extends NodeFormData {
 	toBuffer(): Buffer;
 	/**
 	 * Create RezoFormData from object
+	 * Properly handles nested objects by JSON.stringify-ing them
 	 * @param {Record<string, any>} obj - Object to convert
 	 * @param {Options} options - Optional RezoFormData options
 	 * @returns {RezoFormData}
 	 */
 	static fromObject(obj: Record<string, any>, options?: Options): RezoFormData;
+	/**
+	 * Helper to append a value to FormData with proper type handling
+	 * @param {RezoFormData} formData - The form data to append to
+	 * @param {string} key - The field name
+	 * @param {any} value - The value to append
+	 */
+	private static appendValue;
 	/**
 	 * Convert to URL query string
 	 * Warning: File, Blob, and binary data will be omitted
@@ -2685,8 +2693,19 @@ export interface RezoRequestConfig<D = any> {
 	useProxyManager?: boolean;
 	/** Whether to enable automatic cookie handling */
 	useCookies?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoCookieJar;
+	/**
+	 * Custom cookie jar for managing cookies in this request.
+	 * Note: Passing jar per-request is supported but not recommended.
+	 * For better cookie management, pass the jar when creating the instance:
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 * If you need custom cookies for a single request, use the `cookies` option instead.
+	 */
+	jar?: RezoCookieJar;
 	/** Cookies to send with the request in various formats */
 	cookies?: Cookies["array"] | Cookies["netscape"] | Cookies["serialized"] | Cookies["setCookiesString"];
 	/** Callback for upload progress events */
@@ -3117,8 +3136,17 @@ export interface RezoDefaultOptions {
 	hooks?: Partial<RezoHooks>;
 	/** Whether to enable automatic cookie handling (default: true)*/
 	enableCookieJar?: boolean;
-	/** Custom cookie jar for managing cookies */
-	cookieJar?: RezoHttpRequest["cookieJar"];
+	/**
+	 * Custom cookie jar for managing cookies.
+	 * The recommended way to manage cookies - pass the jar when creating the instance.
+	 * @example
+	 * ```typescript
+	 * const client = new Rezo({ jar: myJar });
+	 * // or
+	 * const client = rezo.create({ jar: myJar });
+	 * ```
+	 */
+	jar?: RezoHttpRequest["jar"];
 	/** Set default cookies to send with the requests in various formats */
 	cookies?: RezoHttpRequest["cookies"];
 	/**