rezo 1.0.10 → 1.0.12

package/dist/platform/worker.d.ts

@@ -2502,8 +2502,73 @@ export interface RezoRequestConfig<D = any> {
 	maxRedirects?: number;
 	/** Whether to automatically decompress response data */
 	decompress?: boolean;
-	/** Whether to keep the connection alive for reuse */
+	/**
+	 * Whether to keep TCP connections alive for reuse across multiple requests.
+	 *
+	 * When enabled, the underlying TCP connection is kept open after a request completes,
+	 * allowing subsequent requests to the same host to reuse the connection. This reduces
+	 * latency by avoiding the overhead of establishing new connections (TCP handshake,
+	 * TLS negotiation for HTTPS).
+	 *
+	 * **Behavior:**
+	 * - `false` (default) - Connection closes after each request. Process exits immediately.
+	 * - `true` - Connection stays open for reuse. Idle connections close after `keepAliveMsecs`.
+	 *
+	 * **When to use `keepAlive: true`:**
+	 * - Making multiple requests to the same host in sequence
+	 * - Long-running applications (servers, bots, scrapers)
+	 * - Performance-critical applications where connection overhead matters
+	 *
+	 * **When to use `keepAlive: false` (default):**
+	 * - Single requests or scripts that should exit immediately
+	 * - CLI tools that make one-off requests
+	 * - When you need predictable process termination
+	 *
+	 * @example
+	 * ```typescript
+	 * // Default: process exits immediately after request
+	 * const { data } = await rezo.get('https://api.example.com/data');
+	 *
+	 * // Keep connection alive for 1 minute (default) for subsequent requests
+	 * const client = new Rezo({ keepAlive: true });
+	 * await client.get('https://api.example.com/users');
+	 * await client.get('https://api.example.com/posts'); // Reuses connection
+	 *
+	 * // Custom keep-alive timeout (30 seconds)
+	 * const client = new Rezo({ keepAlive: true, keepAliveMsecs: 30000 });
+	 * ```
+	 *
+	 * @default false
+	 */
 	keepAlive?: boolean;
+	/**
+	 * How long to keep idle connections alive in milliseconds.
+	 *
+	 * Only applies when `keepAlive: true`. After this duration of inactivity,
+	 * the connection is closed automatically. This prevents resource leaks
+	 * from connections that are no longer needed.
+	 *
+	 * **Note:** Even with keep-alive enabled, the Node.js process can still exit
+	 * cleanly when there's no other work to do, thanks to socket unreferencing.
+	 *
+	 * @example
+	 * ```typescript
+	 * // Keep connections alive for 30 seconds
+	 * const client = new Rezo({
+	 *   keepAlive: true,
+	 *   keepAliveMsecs: 30000
+	 * });
+	 *
+	 * // Keep connections alive for 2 minutes
+	 * const client = new Rezo({
+	 *   keepAlive: true,
+	 *   keepAliveMsecs: 120000
+	 * });
+	 * ```
+	 *
+	 * @default 60000 (1 minute)
+	 */
+	keepAliveMsecs?: number;
 	withoutBodyOnRedirect?: boolean;
 	autoSetReferer?: boolean;
 	autoSetOrigin?: boolean;
@@ -4104,6 +4169,7 @@ export declare class Rezo {
 	private __create;
 	/** Get the cookie jar for this instance */
 	get cookieJar(): RezoCookieJar;
+	set cookieJar(jar: RezoCookieJar);
 	/**
 	 * Save cookies to file (if cookieFile is configured).
 	 * Can also specify a different path to save to.

package/dist/plugin/index.cjs

@@ -1,36 +1,36 @@
-const _mod_cizrxa = require('./crawler.cjs');
-exports.Crawler = _mod_cizrxa.Crawler;;
-const _mod_7yd7lj = require('./crawler-options.cjs');
-exports.CrawlerOptions = _mod_7yd7lj.CrawlerOptions;;
-const _mod_d1skng = require('../cache/file-cacher.cjs');
-exports.FileCacher = _mod_d1skng.FileCacher;;
-const _mod_lxwyvt = require('../cache/url-store.cjs');
-exports.UrlStore = _mod_lxwyvt.UrlStore;;
-const _mod_09oe6w = require('./addon/oxylabs/index.cjs');
-exports.Oxylabs = _mod_09oe6w.Oxylabs;;
-const _mod_3wv0s7 = require('./addon/oxylabs/options.cjs');
-exports.OXYLABS_BROWSER_TYPES = _mod_3wv0s7.OXYLABS_BROWSER_TYPES;
-exports.OXYLABS_COMMON_LOCALES = _mod_3wv0s7.OXYLABS_COMMON_LOCALES;
-exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_3wv0s7.OXYLABS_COMMON_GEO_LOCATIONS;
-exports.OXYLABS_US_STATES = _mod_3wv0s7.OXYLABS_US_STATES;
-exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_3wv0s7.OXYLABS_EUROPEAN_COUNTRIES;
-exports.OXYLABS_ASIAN_COUNTRIES = _mod_3wv0s7.OXYLABS_ASIAN_COUNTRIES;
-exports.getRandomOxylabsBrowserType = _mod_3wv0s7.getRandomBrowserType;
-exports.getRandomOxylabsLocale = _mod_3wv0s7.getRandomLocale;
-exports.getRandomOxylabsGeoLocation = _mod_3wv0s7.getRandomGeoLocation;;
-const _mod_vi6kgn = require('./addon/decodo/index.cjs');
-exports.Decodo = _mod_vi6kgn.Decodo;;
-const _mod_avxi0i = require('./addon/decodo/options.cjs');
-exports.DECODO_DEVICE_TYPES = _mod_avxi0i.DECODO_DEVICE_TYPES;
-exports.DECODO_HEADLESS_MODES = _mod_avxi0i.DECODO_HEADLESS_MODES;
-exports.DECODO_COMMON_LOCALES = _mod_avxi0i.DECODO_COMMON_LOCALES;
-exports.DECODO_COMMON_COUNTRIES = _mod_avxi0i.DECODO_COMMON_COUNTRIES;
-exports.DECODO_EUROPEAN_COUNTRIES = _mod_avxi0i.DECODO_EUROPEAN_COUNTRIES;
-exports.DECODO_ASIAN_COUNTRIES = _mod_avxi0i.DECODO_ASIAN_COUNTRIES;
-exports.DECODO_US_STATES = _mod_avxi0i.DECODO_US_STATES;
-exports.DECODO_COMMON_CITIES = _mod_avxi0i.DECODO_COMMON_CITIES;
-exports.getRandomDecodoDeviceType = _mod_avxi0i.getRandomDeviceType;
-exports.getRandomDecodoLocale = _mod_avxi0i.getRandomLocale;
-exports.getRandomDecodoCountry = _mod_avxi0i.getRandomCountry;
-exports.getRandomDecodoCity = _mod_avxi0i.getRandomCity;
-exports.generateDecodoSessionId = _mod_avxi0i.generateSessionId;;
+const _mod_a9kn57 = require('./crawler.cjs');
+exports.Crawler = _mod_a9kn57.Crawler;;
+const _mod_6ccm6s = require('./crawler-options.cjs');
+exports.CrawlerOptions = _mod_6ccm6s.CrawlerOptions;;
+const _mod_7naagm = require('../cache/file-cacher.cjs');
+exports.FileCacher = _mod_7naagm.FileCacher;;
+const _mod_22i2ua = require('../cache/url-store.cjs');
+exports.UrlStore = _mod_22i2ua.UrlStore;;
+const _mod_37jf5t = require('./addon/oxylabs/index.cjs');
+exports.Oxylabs = _mod_37jf5t.Oxylabs;;
+const _mod_u1lbrx = require('./addon/oxylabs/options.cjs');
+exports.OXYLABS_BROWSER_TYPES = _mod_u1lbrx.OXYLABS_BROWSER_TYPES;
+exports.OXYLABS_COMMON_LOCALES = _mod_u1lbrx.OXYLABS_COMMON_LOCALES;
+exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_u1lbrx.OXYLABS_COMMON_GEO_LOCATIONS;
+exports.OXYLABS_US_STATES = _mod_u1lbrx.OXYLABS_US_STATES;
+exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_u1lbrx.OXYLABS_EUROPEAN_COUNTRIES;
+exports.OXYLABS_ASIAN_COUNTRIES = _mod_u1lbrx.OXYLABS_ASIAN_COUNTRIES;
+exports.getRandomOxylabsBrowserType = _mod_u1lbrx.getRandomBrowserType;
+exports.getRandomOxylabsLocale = _mod_u1lbrx.getRandomLocale;
+exports.getRandomOxylabsGeoLocation = _mod_u1lbrx.getRandomGeoLocation;;
+const _mod_mozpwt = require('./addon/decodo/index.cjs');
+exports.Decodo = _mod_mozpwt.Decodo;;
+const _mod_g6f0a3 = require('./addon/decodo/options.cjs');
+exports.DECODO_DEVICE_TYPES = _mod_g6f0a3.DECODO_DEVICE_TYPES;
+exports.DECODO_HEADLESS_MODES = _mod_g6f0a3.DECODO_HEADLESS_MODES;
+exports.DECODO_COMMON_LOCALES = _mod_g6f0a3.DECODO_COMMON_LOCALES;
+exports.DECODO_COMMON_COUNTRIES = _mod_g6f0a3.DECODO_COMMON_COUNTRIES;
+exports.DECODO_EUROPEAN_COUNTRIES = _mod_g6f0a3.DECODO_EUROPEAN_COUNTRIES;
+exports.DECODO_ASIAN_COUNTRIES = _mod_g6f0a3.DECODO_ASIAN_COUNTRIES;
+exports.DECODO_US_STATES = _mod_g6f0a3.DECODO_US_STATES;
+exports.DECODO_COMMON_CITIES = _mod_g6f0a3.DECODO_COMMON_CITIES;
+exports.getRandomDecodoDeviceType = _mod_g6f0a3.getRandomDeviceType;
+exports.getRandomDecodoLocale = _mod_g6f0a3.getRandomLocale;
+exports.getRandomDecodoCountry = _mod_g6f0a3.getRandomCountry;
+exports.getRandomDecodoCity = _mod_g6f0a3.getRandomCity;
+exports.generateDecodoSessionId = _mod_g6f0a3.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_l3fp62 = require('./manager.cjs');
-exports.ProxyManager = _mod_l3fp62.ProxyManager;;
+const _mod_448ob0 = require('./manager.cjs');
+exports.ProxyManager = _mod_448ob0.ProxyManager;;
 function createOptions(uri, opts) {
   if (uri instanceof URL || typeof uri === "string") {
     return {

package/dist/queue/index.cjs

@@ -1,8 +1,8 @@
-const _mod_yii8q7 = require('./queue.cjs');
-exports.RezoQueue = _mod_yii8q7.RezoQueue;;
-const _mod_unk7rd = require('./http-queue.cjs');
-exports.HttpQueue = _mod_unk7rd.HttpQueue;
-exports.extractDomain = _mod_unk7rd.extractDomain;;
-const _mod_6fv9eb = require('./types.cjs');
-exports.Priority = _mod_6fv9eb.Priority;
-exports.HttpMethodPriority = _mod_6fv9eb.HttpMethodPriority;;
+const _mod_ipfe1q = require('./queue.cjs');
+exports.RezoQueue = _mod_ipfe1q.RezoQueue;;
+const _mod_sc99zf = require('./http-queue.cjs');
+exports.HttpQueue = _mod_sc99zf.HttpQueue;
+exports.extractDomain = _mod_sc99zf.extractDomain;;
+const _mod_4akyyt = require('./types.cjs');
+exports.Priority = _mod_4akyyt.Priority;
+exports.HttpMethodPriority = _mod_4akyyt.HttpMethodPriority;;

package/dist/responses/buildResponse.cjs

@@ -297,11 +297,36 @@ function buildResponse(params) {
   const rezoHeaders = new RezoHeaders(headers);
   rezoHeaders.delete("set-cookie");
   let cookieData;
+  const mergedCookiesArray = [];
+  const cookieKeyDomainMap = new Map;
+  if (config.requestCookies && config.requestCookies.length > 0) {
+    for (const cookie of config.requestCookies) {
+      const key = `${cookie.key}|${cookie.domain || ""}`;
+      mergedCookiesArray.push(cookie);
+      cookieKeyDomainMap.set(key, mergedCookiesArray.length - 1);
+    }
+  }
+  let responseCookiesArray = [];
   if (config.responseCookies && config.responseCookies.array && config.responseCookies.array.length > 0) {
-    cookieData = config.responseCookies;
+    responseCookiesArray = config.responseCookies.array;
   } else if (cookies.length > 0) {
-    const cookieJar = new RezoCookieJar;
-    cookieData = cookieJar.setCookiesSync(cookies, url);
+    const tempJar = new RezoCookieJar;
+    const parsed = tempJar.setCookiesSync(cookies, url);
+    responseCookiesArray = parsed.array;
+  }
+  for (const cookie of responseCookiesArray) {
+    const key = `${cookie.key}|${cookie.domain || ""}`;
+    const existingIndex = cookieKeyDomainMap.get(key);
+    if (existingIndex !== undefined) {
+      mergedCookiesArray[existingIndex] = cookie;
+    } else {
+      mergedCookiesArray.push(cookie);
+      cookieKeyDomainMap.set(key, mergedCookiesArray.length - 1);
+    }
+  }
+  if (mergedCookiesArray.length > 0) {
+    const mergedJar = new RezoCookieJar(mergedCookiesArray, url);
+    cookieData = mergedJar.cookies();
   } else {
     cookieData = {
       array: [],

package/dist/responses/buildResponse.js

@@ -297,11 +297,36 @@ export function buildResponse(params) {
   const rezoHeaders = new RezoHeaders(headers);
   rezoHeaders.delete("set-cookie");
   let cookieData;
+  const mergedCookiesArray = [];
+  const cookieKeyDomainMap = new Map;
+  if (config.requestCookies && config.requestCookies.length > 0) {
+    for (const cookie of config.requestCookies) {
+      const key = `${cookie.key}|${cookie.domain || ""}`;
+      mergedCookiesArray.push(cookie);
+      cookieKeyDomainMap.set(key, mergedCookiesArray.length - 1);
+    }
+  }
+  let responseCookiesArray = [];
   if (config.responseCookies && config.responseCookies.array && config.responseCookies.array.length > 0) {
-    cookieData = config.responseCookies;
+    responseCookiesArray = config.responseCookies.array;
   } else if (cookies.length > 0) {
-    const cookieJar = new RezoCookieJar;
-    cookieData = cookieJar.setCookiesSync(cookies, url);
+    const tempJar = new RezoCookieJar;
+    const parsed = tempJar.setCookiesSync(cookies, url);
+    responseCookiesArray = parsed.array;
+  }
+  for (const cookie of responseCookiesArray) {
+    const key = `${cookie.key}|${cookie.domain || ""}`;
+    const existingIndex = cookieKeyDomainMap.get(key);
+    if (existingIndex !== undefined) {
+      mergedCookiesArray[existingIndex] = cookie;
+    } else {
+      mergedCookiesArray.push(cookie);
+      cookieKeyDomainMap.set(key, mergedCookiesArray.length - 1);
+    }
+  }
+  if (mergedCookiesArray.length > 0) {
+    const mergedJar = new RezoCookieJar(mergedCookiesArray, url);
+    cookieData = mergedJar.cookies();
   } else {
     cookieData = {
       array: [],

package/dist/utils/http-config.cjs

@@ -170,7 +170,11 @@ function setSignal() {
     clearTimeout(this.timeoutClearInstanse);
   if (this.timeout && typeof this.timeout === "number" && this.timeout > 100) {
     const controller = new AbortController;
-    this.timeoutClearInstanse = setTimeout(() => controller.abort(), this.timeout);
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    if (typeof timer === "object" && "unref" in timer) {
+      timer.unref();
+    }
+    this.timeoutClearInstanse = timer;
     this.signal = controller.signal;
   }
 }
@@ -285,6 +289,9 @@ function prepareHTTPOptions(options, jar, addedOptions, config) {
       }
     }
   }
+  if (cookiesString) {
+    fetchOptions.headers.set("Cookie", cookiesString);
+  }
   if (options.body) {
     fetchOptions.body = options.body;
   }

package/dist/utils/http-config.js

@@ -170,7 +170,11 @@ function setSignal() {
     clearTimeout(this.timeoutClearInstanse);
   if (this.timeout && typeof this.timeout === "number" && this.timeout > 100) {
     const controller = new AbortController;
-    this.timeoutClearInstanse = setTimeout(() => controller.abort(), this.timeout);
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    if (typeof timer === "object" && "unref" in timer) {
+      timer.unref();
+    }
+    this.timeoutClearInstanse = timer;
     this.signal = controller.signal;
   }
 }
@@ -285,6 +289,9 @@ export function prepareHTTPOptions(options, jar, addedOptions, config) {
       }
     }
   }
+  if (cookiesString) {
+    fetchOptions.headers.set("Cookie", cookiesString);
+  }
   if (options.body) {
     fetchOptions.body = options.body;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rezo",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "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",