rezo 1.0.13 → 1.0.15

package/dist/platform/react-native.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/worker.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/plugin/index.cjs

@@ -1,36 +1,36 @@
-const _mod_dq9ozb = require('./crawler.cjs');
-exports.Crawler = _mod_dq9ozb.Crawler;;
-const _mod_d0jsak = require('./crawler-options.cjs');
-exports.CrawlerOptions = _mod_d0jsak.CrawlerOptions;;
-const _mod_wbhzam = require('../cache/file-cacher.cjs');
-exports.FileCacher = _mod_wbhzam.FileCacher;;
-const _mod_ic6xnp = require('../cache/url-store.cjs');
-exports.UrlStore = _mod_ic6xnp.UrlStore;;
-const _mod_u5fn2x = require('./addon/oxylabs/index.cjs');
-exports.Oxylabs = _mod_u5fn2x.Oxylabs;;
-const _mod_mc3i9t = require('./addon/oxylabs/options.cjs');
-exports.OXYLABS_BROWSER_TYPES = _mod_mc3i9t.OXYLABS_BROWSER_TYPES;
-exports.OXYLABS_COMMON_LOCALES = _mod_mc3i9t.OXYLABS_COMMON_LOCALES;
-exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_mc3i9t.OXYLABS_COMMON_GEO_LOCATIONS;
-exports.OXYLABS_US_STATES = _mod_mc3i9t.OXYLABS_US_STATES;
-exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_mc3i9t.OXYLABS_EUROPEAN_COUNTRIES;
-exports.OXYLABS_ASIAN_COUNTRIES = _mod_mc3i9t.OXYLABS_ASIAN_COUNTRIES;
-exports.getRandomOxylabsBrowserType = _mod_mc3i9t.getRandomBrowserType;
-exports.getRandomOxylabsLocale = _mod_mc3i9t.getRandomLocale;
-exports.getRandomOxylabsGeoLocation = _mod_mc3i9t.getRandomGeoLocation;;
-const _mod_d70cyo = require('./addon/decodo/index.cjs');
-exports.Decodo = _mod_d70cyo.Decodo;;
-const _mod_cmnvxg = require('./addon/decodo/options.cjs');
-exports.DECODO_DEVICE_TYPES = _mod_cmnvxg.DECODO_DEVICE_TYPES;
-exports.DECODO_HEADLESS_MODES = _mod_cmnvxg.DECODO_HEADLESS_MODES;
-exports.DECODO_COMMON_LOCALES = _mod_cmnvxg.DECODO_COMMON_LOCALES;
-exports.DECODO_COMMON_COUNTRIES = _mod_cmnvxg.DECODO_COMMON_COUNTRIES;
-exports.DECODO_EUROPEAN_COUNTRIES = _mod_cmnvxg.DECODO_EUROPEAN_COUNTRIES;
-exports.DECODO_ASIAN_COUNTRIES = _mod_cmnvxg.DECODO_ASIAN_COUNTRIES;
-exports.DECODO_US_STATES = _mod_cmnvxg.DECODO_US_STATES;
-exports.DECODO_COMMON_CITIES = _mod_cmnvxg.DECODO_COMMON_CITIES;
-exports.getRandomDecodoDeviceType = _mod_cmnvxg.getRandomDeviceType;
-exports.getRandomDecodoLocale = _mod_cmnvxg.getRandomLocale;
-exports.getRandomDecodoCountry = _mod_cmnvxg.getRandomCountry;
-exports.getRandomDecodoCity = _mod_cmnvxg.getRandomCity;
-exports.generateDecodoSessionId = _mod_cmnvxg.generateSessionId;;
+const _mod_xp0ne3 = require('./crawler.cjs');
+exports.Crawler = _mod_xp0ne3.Crawler;;
+const _mod_zix686 = require('./crawler-options.cjs');
+exports.CrawlerOptions = _mod_zix686.CrawlerOptions;;
+const _mod_lt3nae = require('../cache/file-cacher.cjs');
+exports.FileCacher = _mod_lt3nae.FileCacher;;
+const _mod_6jrabt = require('../cache/url-store.cjs');
+exports.UrlStore = _mod_6jrabt.UrlStore;;
+const _mod_4joht5 = require('./addon/oxylabs/index.cjs');
+exports.Oxylabs = _mod_4joht5.Oxylabs;;
+const _mod_fz188n = require('./addon/oxylabs/options.cjs');
+exports.OXYLABS_BROWSER_TYPES = _mod_fz188n.OXYLABS_BROWSER_TYPES;
+exports.OXYLABS_COMMON_LOCALES = _mod_fz188n.OXYLABS_COMMON_LOCALES;
+exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_fz188n.OXYLABS_COMMON_GEO_LOCATIONS;
+exports.OXYLABS_US_STATES = _mod_fz188n.OXYLABS_US_STATES;
+exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_fz188n.OXYLABS_EUROPEAN_COUNTRIES;
+exports.OXYLABS_ASIAN_COUNTRIES = _mod_fz188n.OXYLABS_ASIAN_COUNTRIES;
+exports.getRandomOxylabsBrowserType = _mod_fz188n.getRandomBrowserType;
+exports.getRandomOxylabsLocale = _mod_fz188n.getRandomLocale;
+exports.getRandomOxylabsGeoLocation = _mod_fz188n.getRandomGeoLocation;;
+const _mod_mycz3h = require('./addon/decodo/index.cjs');
+exports.Decodo = _mod_mycz3h.Decodo;;
+const _mod_omyn21 = require('./addon/decodo/options.cjs');
+exports.DECODO_DEVICE_TYPES = _mod_omyn21.DECODO_DEVICE_TYPES;
+exports.DECODO_HEADLESS_MODES = _mod_omyn21.DECODO_HEADLESS_MODES;
+exports.DECODO_COMMON_LOCALES = _mod_omyn21.DECODO_COMMON_LOCALES;
+exports.DECODO_COMMON_COUNTRIES = _mod_omyn21.DECODO_COMMON_COUNTRIES;
+exports.DECODO_EUROPEAN_COUNTRIES = _mod_omyn21.DECODO_EUROPEAN_COUNTRIES;
+exports.DECODO_ASIAN_COUNTRIES = _mod_omyn21.DECODO_ASIAN_COUNTRIES;
+exports.DECODO_US_STATES = _mod_omyn21.DECODO_US_STATES;
+exports.DECODO_COMMON_CITIES = _mod_omyn21.DECODO_COMMON_CITIES;
+exports.getRandomDecodoDeviceType = _mod_omyn21.getRandomDeviceType;
+exports.getRandomDecodoLocale = _mod_omyn21.getRandomLocale;
+exports.getRandomDecodoCountry = _mod_omyn21.getRandomCountry;
+exports.getRandomDecodoCity = _mod_omyn21.getRandomCity;
+exports.generateDecodoSessionId = _mod_omyn21.generateSessionId;;

package/dist/proxy/index.cjs

@@ -1,8 +1,8 @@
 const { SocksProxyAgent: RezoSocksProxy } = require("socks-proxy-agent");
 const { HttpsProxyAgent: RezoHttpsSocks } = require("https-proxy-agent");
 const { HttpProxyAgent: RezoHttpSocks } = require("http-proxy-agent");
-const _mod_p28kf5 = require('./manager.cjs');
-exports.ProxyManager = _mod_p28kf5.ProxyManager;;
+const _mod_7lhr2y = require('./manager.cjs');
+exports.ProxyManager = _mod_7lhr2y.ProxyManager;;
 function createOptions(uri, opts) {
   if (uri instanceof URL || typeof uri === "string") {
     return {

package/dist/queue/index.cjs

@@ -1,8 +1,8 @@
-const _mod_5bxokv = require('./queue.cjs');
-exports.RezoQueue = _mod_5bxokv.RezoQueue;;
-const _mod_12mknl = require('./http-queue.cjs');
-exports.HttpQueue = _mod_12mknl.HttpQueue;
-exports.extractDomain = _mod_12mknl.extractDomain;;
-const _mod_u9vq92 = require('./types.cjs');
-exports.Priority = _mod_u9vq92.Priority;
-exports.HttpMethodPriority = _mod_u9vq92.HttpMethodPriority;;
+const _mod_0fmt7n = require('./queue.cjs');
+exports.RezoQueue = _mod_0fmt7n.RezoQueue;;
+const _mod_lmjsvb = require('./http-queue.cjs');
+exports.HttpQueue = _mod_lmjsvb.HttpQueue;
+exports.extractDomain = _mod_lmjsvb.extractDomain;;
+const _mod_x9aox1 = require('./types.cjs');
+exports.Priority = _mod_x9aox1.Priority;
+exports.HttpMethodPriority = _mod_x9aox1.HttpMethodPriority;;

package/dist/utils/form-data.cjs

@@ -71,16 +71,73 @@ class RezoFormData extends NodeFormData {
   static fromObject(obj, options) {
     const formData = new RezoFormData(options);
     for (const [key, value] of Object.entries(obj)) {
-      if (Array.isArray(value)) {
-        for (const item of value) {
-          formData.append(key, item);
-        }
-      } else {
-        formData.append(key, value);
-      }
+      RezoFormData.appendValue(formData, key, value);
     }
     return formData;
   }
+  static appendValue(formData, key, value) {
+    if (value === null || value === undefined) {
+      return;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      formData.append(key, String(value));
+      return;
+    }
+    if (Buffer.isBuffer(value)) {
+      formData.append(key, value, {
+        contentType: "application/octet-stream"
+      });
+      return;
+    }
+    if (value instanceof Uint8Array) {
+      formData.append(key, Buffer.from(value), {
+        contentType: "application/octet-stream"
+      });
+      return;
+    }
+    if (value instanceof Readable) {
+      formData.append(key, value);
+      return;
+    }
+    if (typeof File !== "undefined" && value instanceof File) {
+      formData.append(key, value, {
+        filename: value.name,
+        contentType: value.type || "application/octet-stream"
+      });
+      return;
+    }
+    if (typeof Blob !== "undefined" && value instanceof Blob) {
+      formData.append(key, value, {
+        contentType: value.type || "application/octet-stream"
+      });
+      return;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        RezoFormData.appendValue(formData, key, item);
+      }
+      return;
+    }
+    if (typeof value === "object" && value !== null && "value" in value && (value.filename || value.contentType)) {
+      const opts = {};
+      if (value.filename)
+        opts.filename = value.filename;
+      if (value.contentType)
+        opts.contentType = value.contentType;
+      formData.append(key, value.value, opts);
+      return;
+    }
+    if (typeof value === "object" && value !== null) {
+      const jsonString = JSON.stringify(value);
+      const jsonBuffer = Buffer.from(jsonString, "utf8");
+      formData.append(key, jsonBuffer, {
+        filename: `${key}.json`,
+        contentType: "application/json"
+      });
+      return;
+    }
+    formData.append(key, String(value));
+  }
   async toUrlQueryString(convertBinaryToBase64 = false) {
     const params = new URLSearchParams;
     let hasOmittedData = false;

package/dist/utils/form-data.js

@@ -71,16 +71,73 @@ export class RezoFormData extends NodeFormData {
   static fromObject(obj, options) {
     const formData = new RezoFormData(options);
     for (const [key, value] of Object.entries(obj)) {
-      if (Array.isArray(value)) {
-        for (const item of value) {
-          formData.append(key, item);
-        }
-      } else {
-        formData.append(key, value);
-      }
+      RezoFormData.appendValue(formData, key, value);
     }
     return formData;
   }
+  static appendValue(formData, key, value) {
+    if (value === null || value === undefined) {
+      return;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+      formData.append(key, String(value));
+      return;
+    }
+    if (Buffer.isBuffer(value)) {
+      formData.append(key, value, {
+        contentType: "application/octet-stream"
+      });
+      return;
+    }
+    if (value instanceof Uint8Array) {
+      formData.append(key, Buffer.from(value), {
+        contentType: "application/octet-stream"
+      });
+      return;
+    }
+    if (value instanceof Readable) {
+      formData.append(key, value);
+      return;
+    }
+    if (typeof File !== "undefined" && value instanceof File) {
+      formData.append(key, value, {
+        filename: value.name,
+        contentType: value.type || "application/octet-stream"
+      });
+      return;
+    }
+    if (typeof Blob !== "undefined" && value instanceof Blob) {
+      formData.append(key, value, {
+        contentType: value.type || "application/octet-stream"
+      });
+      return;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        RezoFormData.appendValue(formData, key, item);
+      }
+      return;
+    }
+    if (typeof value === "object" && value !== null && "value" in value && (value.filename || value.contentType)) {
+      const opts = {};
+      if (value.filename)
+        opts.filename = value.filename;
+      if (value.contentType)
+        opts.contentType = value.contentType;
+      formData.append(key, value.value, opts);
+      return;
+    }
+    if (typeof value === "object" && value !== null) {
+      const jsonString = JSON.stringify(value);
+      const jsonBuffer = Buffer.from(jsonString, "utf8");
+      formData.append(key, jsonBuffer, {
+        filename: `${key}.json`,
+        contentType: "application/json"
+      });
+      return;
+    }
+    formData.append(key, String(value));
+  }
   async toUrlQueryString(convertBinaryToBase64 = false) {
     const params = new URLSearchParams;
     let hasOmittedData = false;

package/dist/utils/http-config.cjs

@@ -562,7 +562,7 @@ As a workaround, process.env.NODE_TLS_REJECT_UNAUTHORIZED is being set to '0'.
     timeout: typeof requestOptions.timeout === "number" ? requestOptions.timeout : null,
     enableCookieJar: typeof defaultOptions.enableCookieJar === "boolean" ? defaultOptions.enableCookieJar : true,
     useCookies: typeof requestOptions.useCookies === "boolean" ? requestOptions.useCookies : true,
-    cookieJar: requestOptions.cookieJar || jar,
+    cookieJar: requestOptions.jar || jar,
     retry: {
       maxRetries: retryLimit,
       retryDelay,

package/dist/utils/http-config.js

@@ -562,7 +562,7 @@ As a workaround, process.env.NODE_TLS_REJECT_UNAUTHORIZED is being set to '0'.
     timeout: typeof requestOptions.timeout === "number" ? requestOptions.timeout : null,
     enableCookieJar: typeof defaultOptions.enableCookieJar === "boolean" ? defaultOptions.enableCookieJar : true,
     useCookies: typeof requestOptions.useCookies === "boolean" ? requestOptions.useCookies : true,
-    cookieJar: requestOptions.cookieJar || jar,
+    cookieJar: requestOptions.jar || jar,
     retry: {
       maxRetries: retryLimit,
       retryDelay,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rezo",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Lightning-fast, enterprise-grade HTTP client for modern JavaScript. Full HTTP/2 support, intelligent cookie management, multiple adapters (HTTP, Fetch, cURL, XHR), streaming, proxy support (HTTP/HTTPS/SOCKS), and cross-environment compatibility.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",