rezo 1.0.14 → 1.0.16

package/dist/index.cjs

@@ -1,27 +1,28 @@
-const _mod_wsc945 = require('./core/rezo.cjs');
-exports.Rezo = _mod_wsc945.Rezo;
-exports.createRezoInstance = _mod_wsc945.createRezoInstance;
-exports.createDefaultInstance = _mod_wsc945.createDefaultInstance;;
-const _mod_pc2qgs = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_pc2qgs.RezoError;
-exports.RezoErrorCode = _mod_pc2qgs.RezoErrorCode;;
-const _mod_wei4ay = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_wei4ay.RezoHeaders;;
-const _mod_honebj = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_honebj.RezoFormData;;
-const _mod_6yx1gr = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_6yx1gr.RezoCookieJar;
-exports.Cookie = _mod_6yx1gr.Cookie;;
-const _mod_dyuwd6 = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_dyuwd6.createDefaultHooks;
-exports.mergeHooks = _mod_dyuwd6.mergeHooks;;
-const _mod_h49ine = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_h49ine.ProxyManager;;
-const _mod_psyc82 = require('./queue/index.cjs');
-exports.RezoQueue = _mod_psyc82.RezoQueue;
-exports.HttpQueue = _mod_psyc82.HttpQueue;
-exports.Priority = _mod_psyc82.Priority;
-exports.HttpMethodPriority = _mod_psyc82.HttpMethodPriority;;
+const _mod_toz4kt = require('./core/rezo.cjs');
+exports.Rezo = _mod_toz4kt.Rezo;
+exports.createRezoInstance = _mod_toz4kt.createRezoInstance;
+exports.createDefaultInstance = _mod_toz4kt.createDefaultInstance;;
+const _mod_zus14s = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_zus14s.RezoError;
+exports.RezoErrorCode = _mod_zus14s.RezoErrorCode;;
+const _mod_cs9fz9 = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_cs9fz9.RezoHeaders;;
+const _mod_i4n9wl = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_i4n9wl.RezoFormData;;
+const _mod_sfwm5d = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_sfwm5d.RezoCookieJar;
+exports.Cookie = _mod_sfwm5d.Cookie;
+exports.SerializedCookie = _mod_sfwm5d.SerializedCookie;;
+const _mod_0zewxy = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_0zewxy.createDefaultHooks;
+exports.mergeHooks = _mod_0zewxy.mergeHooks;;
+const _mod_lwjjga = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_lwjjga.ProxyManager;;
+const _mod_lhq2m2 = require('./queue/index.cjs');
+exports.RezoQueue = _mod_lhq2m2.RezoQueue;
+exports.HttpQueue = _mod_lhq2m2.HttpQueue;
+exports.Priority = _mod_lhq2m2.Priority;
+exports.HttpMethodPriority = _mod_lhq2m2.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/index.d.ts

@@ -2819,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 */
@@ -3270,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/index.js

@@ -6,7 +6,7 @@ export {
 export { RezoError, RezoErrorCode } from './errors/rezo-error.js';
 export { RezoHeaders } from './utils/headers.js';
 export { RezoFormData } from './utils/form-data.js';
-export { RezoCookieJar, Cookie } from './utils/cookies.js';
+export { RezoCookieJar, Cookie, SerializedCookie } from './utils/cookies.js';
 export { createDefaultHooks, mergeHooks } from './core/hooks.js';
 export { ProxyManager } from './proxy/manager.js';
 export { RezoQueue, HttpQueue, Priority, HttpMethodPriority } from './queue/index.js';

package/dist/platform/browser.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../core/rezo.cjs
 const { RezoError, RezoErrorCode } = require('../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../utils/headers.cjs');
 const { RezoFormData } = require('../utils/form-data.cjs');
-const { RezoCookieJar, Cookie } = require('../utils/cookies.cjs');
+const { RezoCookieJar, Cookie, SerializedCookie } = require('../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../core/hooks.cjs');
 const packageJson = require("../../package.json");
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
 exports.Cookie = Cookie;
+exports.SerializedCookie = SerializedCookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

package/dist/platform/browser.d.ts

@@ -2693,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 */
@@ -3125,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/browser.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../errors/rezo-error.js';
 import { RezoHeaders } from '../utils/headers.js';
 import { RezoFormData } from '../utils/form-data.js';
-import { RezoCookieJar, Cookie } from '../utils/cookies.js';
+import { RezoCookieJar, Cookie, SerializedCookie } from '../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../core/hooks.js';
 import packageJson from "../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar, Cookie };
+export { RezoCookieJar, Cookie, SerializedCookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/platform/bun.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../core/rezo.cjs
 const { RezoError, RezoErrorCode } = require('../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../utils/headers.cjs');
 const { RezoFormData } = require('../utils/form-data.cjs');
-const { RezoCookieJar, Cookie } = require('../utils/cookies.cjs');
+const { RezoCookieJar, Cookie, SerializedCookie } = require('../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../core/hooks.cjs');
 const packageJson = require("../../package.json");
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
 exports.Cookie = Cookie;
+exports.SerializedCookie = SerializedCookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

package/dist/platform/bun.d.ts

@@ -2693,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 */
@@ -3125,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.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../errors/rezo-error.js';
 import { RezoHeaders } from '../utils/headers.js';
 import { RezoFormData } from '../utils/form-data.js';
-import { RezoCookieJar, Cookie } from '../utils/cookies.js';
+import { RezoCookieJar, Cookie, SerializedCookie } from '../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../core/hooks.js';
 import packageJson from "../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar, Cookie };
+export { RezoCookieJar, Cookie, SerializedCookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/platform/deno.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../core/rezo.cjs
 const { RezoError, RezoErrorCode } = require('../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../utils/headers.cjs');
 const { RezoFormData } = require('../utils/form-data.cjs');
-const { RezoCookieJar, Cookie } = require('../utils/cookies.cjs');
+const { RezoCookieJar, Cookie, SerializedCookie } = require('../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../core/hooks.cjs');
 const packageJson = require("../../package.json");
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
 exports.Cookie = Cookie;
+exports.SerializedCookie = SerializedCookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

package/dist/platform/deno.d.ts

@@ -2693,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 */
@@ -3125,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.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../errors/rezo-error.js';
 import { RezoHeaders } from '../utils/headers.js';
 import { RezoFormData } from '../utils/form-data.js';
-import { RezoCookieJar, Cookie } from '../utils/cookies.js';
+import { RezoCookieJar, Cookie, SerializedCookie } from '../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../core/hooks.js';
 import packageJson from "../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar, Cookie };
+export { RezoCookieJar, Cookie, SerializedCookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/platform/node.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../core/rezo.cjs
 const { RezoError, RezoErrorCode } = require('../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../utils/headers.cjs');
 const { RezoFormData } = require('../utils/form-data.cjs');
-const { RezoCookieJar, Cookie } = require('../utils/cookies.cjs');
+const { RezoCookieJar, Cookie, SerializedCookie } = require('../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../core/hooks.cjs');
 const packageJson = require("../../package.json");
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
 exports.Cookie = Cookie;
+exports.SerializedCookie = SerializedCookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

package/dist/platform/node.d.ts

@@ -2693,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 */
@@ -3125,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.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../errors/rezo-error.js';
 import { RezoHeaders } from '../utils/headers.js';
 import { RezoFormData } from '../utils/form-data.js';
-import { RezoCookieJar, Cookie } from '../utils/cookies.js';
+import { RezoCookieJar, Cookie, SerializedCookie } from '../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../core/hooks.js';
 import packageJson from "../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar, Cookie };
+export { RezoCookieJar, Cookie, SerializedCookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/platform/react-native.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../core/rezo.cjs
 const { RezoError, RezoErrorCode } = require('../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../utils/headers.cjs');
 const { RezoFormData } = require('../utils/form-data.cjs');
-const { RezoCookieJar, Cookie } = require('../utils/cookies.cjs');
+const { RezoCookieJar, Cookie, SerializedCookie } = require('../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../core/hooks.cjs');
 const packageJson = require("../../package.json");
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
 exports.Cookie = Cookie;
+exports.SerializedCookie = SerializedCookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

package/dist/platform/react-native.d.ts

@@ -2693,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 */
@@ -3125,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/react-native.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../errors/rezo-error.js';
 import { RezoHeaders } from '../utils/headers.js';
 import { RezoFormData } from '../utils/form-data.js';
-import { RezoCookieJar, Cookie } from '../utils/cookies.js';
+import { RezoCookieJar, Cookie, SerializedCookie } from '../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../core/hooks.js';
 import packageJson from "../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar, Cookie };
+export { RezoCookieJar, Cookie, SerializedCookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/platform/worker.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../core/rezo.cjs
 const { RezoError, RezoErrorCode } = require('../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../utils/headers.cjs');
 const { RezoFormData } = require('../utils/form-data.cjs');
-const { RezoCookieJar, Cookie } = require('../utils/cookies.cjs');
+const { RezoCookieJar, Cookie, SerializedCookie } = require('../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../core/hooks.cjs');
 const packageJson = require("../../package.json");
 
@@ -14,6 +14,7 @@ exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
 exports.Cookie = Cookie;
+exports.SerializedCookie = SerializedCookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

package/dist/platform/worker.d.ts

@@ -2693,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 */
@@ -3125,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/worker.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../errors/rezo-error.js';
 import { RezoHeaders } from '../utils/headers.js';
 import { RezoFormData } from '../utils/form-data.js';
-import { RezoCookieJar, Cookie } from '../utils/cookies.js';
+import { RezoCookieJar, Cookie, SerializedCookie } from '../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../core/hooks.js';
 import packageJson from "../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar, Cookie };
+export { RezoCookieJar, Cookie, SerializedCookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;