rezo 1.0.41 → 1.0.43

package/dist/adapters/curl.cjs

@@ -195,7 +195,7 @@ function buildUrlTree(config, finalUrl) {
   }
   return urls.length > 0 ? urls : [finalUrl];
 }
-async function updateCookies(config, cookieStrings, url) {
+async function updateCookies(config, cookieStrings, url, rootJar) {
   if (!cookieStrings || cookieStrings.length === 0)
     return;
   const tempJar = new RezoCookieJar;
@@ -233,8 +233,9 @@ async function updateCookies(config, cookieStrings, url) {
     acceptedCookies.push(...parsedCookies.array);
   }
   const acceptedCookieStrings = acceptedCookies.map((c) => c.toSetCookieString());
-  if (!config.disableCookieJar && config.cookieJar) {
-    config.cookieJar.setCookiesSync(acceptedCookieStrings, url);
+  const jarToUpdate = rootJar || config.cookieJar;
+  if (!config.disableCookieJar && jarToUpdate) {
+    jarToUpdate.setCookiesSync(acceptedCookieStrings, url);
   }
   if (config.useCookies) {
     const existingArray = config.responseCookies?.array || [];
@@ -1484,14 +1485,15 @@ class CurlCommandBuilder {
       case "socks5h":
         this.addArg("--socks5", hostPort);
         if (auth) {
-          this.addArg("--socks5-user", auth);
+          this.addArg("--socks5-basic");
+          this.addArg("--proxy-user", auth);
         }
         break;
       case "socks4":
       case "socks4a":
         this.addArg("--socks4", hostPort);
         if (username) {
-          this.addArg("--socks4-user", username);
+          this.addArg("--proxy-user", username);
         }
         break;
       case "http":
@@ -1634,6 +1636,7 @@ class CurlCommandBuilder {
       "local_ip:%{local_ip}",
       "local_port:%{local_port}",
       "redirect_url:%{redirect_url}",
+      "url_effective:%{url_effective}",
       "ssl_verify_result:%{ssl_verify_result}",
       "content_type:%{content_type}",
       "---CURL_STATS_END---"
@@ -1655,27 +1658,68 @@ class CurlResponseParser {
       body = stdout.slice(0, statsStart);
       for (const line of statsSection.split(`
 `)) {
-        const [key, value] = line.split(":");
-        if (key && value !== undefined) {
-          stats[key.trim()] = value.trim();
+        const colonIndex = line.indexOf(":");
+        if (colonIndex !== -1) {
+          const key = line.slice(0, colonIndex).trim();
+          const value = line.slice(colonIndex + 1).trim();
+          if (key && value !== undefined) {
+            stats[key] = value;
+          }
         }
       }
     }
-    const headerBodySplit = body.indexOf(`\r
-\r
-`);
-    let headerSection = "";
-    let responseBody = body;
-    if (headerBodySplit !== -1) {
-      headerSection = body.slice(0, headerBodySplit);
-      responseBody = body.slice(headerBodySplit + 4);
+    const allResponses = this.parseAllHttpResponses(body);
+    const finalResponse = allResponses[allResponses.length - 1] || { headers: "", body };
+    let headerSection = finalResponse.headers;
+    let responseBody = finalResponse.body;
+    const allSetCookies = [];
+    for (const resp of allResponses) {
+      const respHeaders = this.parseHeaders(resp.headers);
+      const setCookieHeader = respHeaders["set-cookie"];
+      if (setCookieHeader) {
+        if (Array.isArray(setCookieHeader)) {
+          allSetCookies.push(...setCookieHeader);
+        } else {
+          allSetCookies.push(setCookieHeader);
+        }
+      }
+    }
+    if (allResponses.length > 1) {
+      config.redirectHistory = config.redirectHistory || [];
+      let currentUrl = config.url || "";
+      for (let i = 0;i < allResponses.length - 1; i++) {
+        const resp = allResponses[i];
+        const respHeaders = this.parseHeaders(resp.headers);
+        const statusMatch = resp.headers.match(/HTTP\/[\d.]+ (\d+)/);
+        const statusCode = statusMatch ? parseInt(statusMatch[1]) : 0;
+        const locationHeader = respHeaders["location"] || "";
+        config.redirectHistory.push({
+          url: currentUrl,
+          statusCode,
+          statusText: this.getStatusText(statusCode),
+          headers: new RezoHeaders(respHeaders),
+          method: config.method || "GET",
+          cookies: [],
+          duration: 0,
+          request: originalRequest
+        });
+        if (locationHeader) {
+          try {
+            currentUrl = new URL(locationHeader, currentUrl).toString();
+          } catch {
+            currentUrl = locationHeader;
+          }
+        }
+      }
+      config.redirectCount = allResponses.length - 1;
     }
     const statusMatch = headerSection.match(/HTTP\/[\d.]+ (\d+)/);
     const status = statusMatch ? parseInt(statusMatch[1]) : parseInt(stats["http_code"]) || 200;
     const statusText = this.getStatusText(status);
     const headers = this.parseHeaders(headerSection);
     const rezoHeaders = new RezoHeaders(headers);
-    const responseCookies = this.parseCookies(headers);
+    rezoHeaders.delete("set-cookie");
+    const responseCookies = this.parseCookiesFromStrings(allSetCookies, config.url || "");
     const mergedCookieArray = mergeRequestAndResponseCookies(config.requestCookies, responseCookies.array);
     let cookies;
     if (mergedCookieArray.length > 0) {
@@ -1714,7 +1758,7 @@ class CurlResponseParser {
     const isSecure = config.url?.startsWith("https") || false;
     config.adapterUsed = "curl";
     config.isSecure = isSecure;
-    config.finalUrl = stats["redirect_url"] || config.url || "";
+    config.finalUrl = stats["url_effective"] || config.url || "";
     if (!config.network) {
       config.network = {};
     }
@@ -1728,7 +1772,7 @@ class CurlResponseParser {
     config.transfer.bodySize = responseBody.length;
     config.transfer.headerSize = headerSection.length;
     config.responseCookies = cookies;
-    const finalUrl = stats["redirect_url"] || config.url || "";
+    const finalUrl = stats["url_effective"] || config.url || "";
     const urls = buildUrlTree(config, finalUrl);
     const timingDurations = getTimingDurations(config);
     debugLog.responseHeaders(config, headers);
@@ -1812,6 +1856,55 @@ class CurlResponseParser {
       setCookiesString: cookieArray
     };
   }
+  static parseAllHttpResponses(output) {
+    const responses = [];
+    const httpPattern = /HTTP\/[\d.]+ \d+/g;
+    const matches = [];
+    let match;
+    while ((match = httpPattern.exec(output)) !== null) {
+      matches.push(match.index);
+    }
+    if (matches.length === 0) {
+      return [{ headers: "", body: output }];
+    }
+    for (let i = 0;i < matches.length; i++) {
+      const start = matches[i];
+      const end = i < matches.length - 1 ? matches[i + 1] : output.length;
+      const segment = output.slice(start, end);
+      const separator = segment.indexOf(`\r
+\r
+`);
+      if (separator !== -1) {
+        const headers = segment.slice(0, separator);
+        const body = segment.slice(separator + 4);
+        responses.push({ headers, body });
+      } else {
+        responses.push({ headers: segment.trim(), body: "" });
+      }
+    }
+    if (responses.length > 1) {
+      const lastBody = responses[responses.length - 1].body;
+      for (let i = 0;i < responses.length - 1; i++) {
+        responses[i].body = "";
+      }
+      responses[responses.length - 1].body = lastBody;
+    }
+    return responses;
+  }
+  static parseCookiesFromStrings(setCookieStrings, url) {
+    if (setCookieStrings.length === 0) {
+      return {
+        array: [],
+        serialized: [],
+        netscape: "",
+        string: "",
+        setCookiesString: []
+      };
+    }
+    const jar = new RezoCookieJar;
+    jar.setCookiesSync(setCookieStrings, url);
+    return jar.cookies();
+  }
 }
 
 class CurlExecutor {
@@ -2148,6 +2241,9 @@ async function executeRequest(options, defaultOptions, jar) {
       }
     }
   }
+  if (!config.requestId) {
+    config.requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+  }
   debugLog.requestStart(config, requestUrl, method);
   let streamResponse;
   let downloadResponse;
@@ -2201,6 +2297,11 @@ async function executeRequest(options, defaultOptions, jar) {
       const duration = perform.now();
       debugLog.response(config, response.status, response.statusText, duration);
       debugLog.cookies(config, response.cookies?.array?.length || 0);
+      if (response.cookies?.setCookiesString?.length > 0 && jar) {
+        try {
+          jar.setCookiesSync(response.cookies.setCookiesString, response.finalUrl || requestUrl);
+        } catch (e) {}
+      }
       if (cache) {
         if (response.status === 304 && cachedEntry) {
           const responseHeaders = response.headers instanceof RezoHeaders ? Object.fromEntries(response.headers.entries()) : response.headers;
@@ -2220,21 +2321,31 @@ async function executeRequest(options, defaultOptions, jar) {
         if (config.retry) {
           const maxRetries = config.retry.maxRetries || 0;
           const statusCodes = config.retry.statusCodes || [408, 429, 500, 502, 503, 504];
-          if (config.retryAttempts < maxRetries && statusCodes.includes(response.status)) {
-            const retryDelay = config.retry.retryDelay || 0;
-            const incrementDelay = config.retry.incrementDelay || false;
-            const delay = incrementDelay ? retryDelay * (config.retryAttempts + 1) : retryDelay;
-            debugLog.retry(config, config.retryAttempts + 1, maxRetries, response.status, delay);
-            if (config.hooks?.beforeRetry && config.hooks.beforeRetry.length > 0) {
-              for (const hook of config.hooks.beforeRetry) {
-                await hook(config, httpError, config.retryAttempts + 1);
+          if (statusCodes.includes(response.status)) {
+            if (config.retryAttempts < maxRetries) {
+              config.retryAttempts++;
+              if (!config.errors)
+                config.errors = [];
+              config.errors.push({
+                attempt: config.retryAttempts,
+                error: httpError,
+                duration: perform.now()
+              });
+              perform.reset();
+              const retryDelay = config.retry.retryDelay || 0;
+              const incrementDelay = config.retry.incrementDelay || false;
+              const delay = incrementDelay ? retryDelay * config.retryAttempts : retryDelay;
+              debugLog.retry(config, config.retryAttempts, maxRetries, response.status, delay);
+              if (config.hooks?.beforeRetry && config.hooks.beforeRetry.length > 0) {
+                for (const hook of config.hooks.beforeRetry) {
+                  await hook(config, httpError, config.retryAttempts);
+                }
               }
+              if (delay > 0) {
+                await new Promise((resolve) => setTimeout(resolve, delay));
+              }
+              return executeRequest(options, defaultOptions, jar);
             }
-            if (delay > 0) {
-              await new Promise((resolve) => setTimeout(resolve, delay));
-            }
-            config.retryAttempts++;
-            return executeRequest(options, defaultOptions, jar);
           }
           debugLog.maxRetries(config, maxRetries);
         }

package/dist/adapters/curl.js

@@ -195,7 +195,7 @@ function buildUrlTree(config, finalUrl) {
   }
   return urls.length > 0 ? urls : [finalUrl];
 }
-async function updateCookies(config, cookieStrings, url) {
+async function updateCookies(config, cookieStrings, url, rootJar) {
   if (!cookieStrings || cookieStrings.length === 0)
     return;
   const tempJar = new RezoCookieJar;
@@ -233,8 +233,9 @@ async function updateCookies(config, cookieStrings, url) {
     acceptedCookies.push(...parsedCookies.array);
   }
   const acceptedCookieStrings = acceptedCookies.map((c) => c.toSetCookieString());
-  if (!config.disableCookieJar && config.cookieJar) {
-    config.cookieJar.setCookiesSync(acceptedCookieStrings, url);
+  const jarToUpdate = rootJar || config.cookieJar;
+  if (!config.disableCookieJar && jarToUpdate) {
+    jarToUpdate.setCookiesSync(acceptedCookieStrings, url);
   }
   if (config.useCookies) {
     const existingArray = config.responseCookies?.array || [];
@@ -1484,14 +1485,15 @@ class CurlCommandBuilder {
       case "socks5h":
         this.addArg("--socks5", hostPort);
         if (auth) {
-          this.addArg("--socks5-user", auth);
+          this.addArg("--socks5-basic");
+          this.addArg("--proxy-user", auth);
         }
         break;
       case "socks4":
       case "socks4a":
         this.addArg("--socks4", hostPort);
         if (username) {
-          this.addArg("--socks4-user", username);
+          this.addArg("--proxy-user", username);
         }
         break;
       case "http":
@@ -1634,6 +1636,7 @@ class CurlCommandBuilder {
       "local_ip:%{local_ip}",
       "local_port:%{local_port}",
       "redirect_url:%{redirect_url}",
+      "url_effective:%{url_effective}",
       "ssl_verify_result:%{ssl_verify_result}",
       "content_type:%{content_type}",
       "---CURL_STATS_END---"
@@ -1655,27 +1658,68 @@ class CurlResponseParser {
       body = stdout.slice(0, statsStart);
       for (const line of statsSection.split(`
 `)) {
-        const [key, value] = line.split(":");
-        if (key && value !== undefined) {
-          stats[key.trim()] = value.trim();
+        const colonIndex = line.indexOf(":");
+        if (colonIndex !== -1) {
+          const key = line.slice(0, colonIndex).trim();
+          const value = line.slice(colonIndex + 1).trim();
+          if (key && value !== undefined) {
+            stats[key] = value;
+          }
         }
       }
     }
-    const headerBodySplit = body.indexOf(`\r
-\r
-`);
-    let headerSection = "";
-    let responseBody = body;
-    if (headerBodySplit !== -1) {
-      headerSection = body.slice(0, headerBodySplit);
-      responseBody = body.slice(headerBodySplit + 4);
+    const allResponses = this.parseAllHttpResponses(body);
+    const finalResponse = allResponses[allResponses.length - 1] || { headers: "", body };
+    let headerSection = finalResponse.headers;
+    let responseBody = finalResponse.body;
+    const allSetCookies = [];
+    for (const resp of allResponses) {
+      const respHeaders = this.parseHeaders(resp.headers);
+      const setCookieHeader = respHeaders["set-cookie"];
+      if (setCookieHeader) {
+        if (Array.isArray(setCookieHeader)) {
+          allSetCookies.push(...setCookieHeader);
+        } else {
+          allSetCookies.push(setCookieHeader);
+        }
+      }
+    }
+    if (allResponses.length > 1) {
+      config.redirectHistory = config.redirectHistory || [];
+      let currentUrl = config.url || "";
+      for (let i = 0;i < allResponses.length - 1; i++) {
+        const resp = allResponses[i];
+        const respHeaders = this.parseHeaders(resp.headers);
+        const statusMatch = resp.headers.match(/HTTP\/[\d.]+ (\d+)/);
+        const statusCode = statusMatch ? parseInt(statusMatch[1]) : 0;
+        const locationHeader = respHeaders["location"] || "";
+        config.redirectHistory.push({
+          url: currentUrl,
+          statusCode,
+          statusText: this.getStatusText(statusCode),
+          headers: new RezoHeaders(respHeaders),
+          method: config.method || "GET",
+          cookies: [],
+          duration: 0,
+          request: originalRequest
+        });
+        if (locationHeader) {
+          try {
+            currentUrl = new URL(locationHeader, currentUrl).toString();
+          } catch {
+            currentUrl = locationHeader;
+          }
+        }
+      }
+      config.redirectCount = allResponses.length - 1;
     }
     const statusMatch = headerSection.match(/HTTP\/[\d.]+ (\d+)/);
     const status = statusMatch ? parseInt(statusMatch[1]) : parseInt(stats["http_code"]) || 200;
     const statusText = this.getStatusText(status);
     const headers = this.parseHeaders(headerSection);
     const rezoHeaders = new RezoHeaders(headers);
-    const responseCookies = this.parseCookies(headers);
+    rezoHeaders.delete("set-cookie");
+    const responseCookies = this.parseCookiesFromStrings(allSetCookies, config.url || "");
     const mergedCookieArray = mergeRequestAndResponseCookies(config.requestCookies, responseCookies.array);
     let cookies;
     if (mergedCookieArray.length > 0) {
@@ -1714,7 +1758,7 @@ class CurlResponseParser {
     const isSecure = config.url?.startsWith("https") || false;
     config.adapterUsed = "curl";
     config.isSecure = isSecure;
-    config.finalUrl = stats["redirect_url"] || config.url || "";
+    config.finalUrl = stats["url_effective"] || config.url || "";
     if (!config.network) {
       config.network = {};
     }
@@ -1728,7 +1772,7 @@ class CurlResponseParser {
     config.transfer.bodySize = responseBody.length;
     config.transfer.headerSize = headerSection.length;
     config.responseCookies = cookies;
-    const finalUrl = stats["redirect_url"] || config.url || "";
+    const finalUrl = stats["url_effective"] || config.url || "";
     const urls = buildUrlTree(config, finalUrl);
     const timingDurations = getTimingDurations(config);
     debugLog.responseHeaders(config, headers);
@@ -1812,6 +1856,55 @@ class CurlResponseParser {
       setCookiesString: cookieArray
     };
   }
+  static parseAllHttpResponses(output) {
+    const responses = [];
+    const httpPattern = /HTTP\/[\d.]+ \d+/g;
+    const matches = [];
+    let match;
+    while ((match = httpPattern.exec(output)) !== null) {
+      matches.push(match.index);
+    }
+    if (matches.length === 0) {
+      return [{ headers: "", body: output }];
+    }
+    for (let i = 0;i < matches.length; i++) {
+      const start = matches[i];
+      const end = i < matches.length - 1 ? matches[i + 1] : output.length;
+      const segment = output.slice(start, end);
+      const separator = segment.indexOf(`\r
+\r
+`);
+      if (separator !== -1) {
+        const headers = segment.slice(0, separator);
+        const body = segment.slice(separator + 4);
+        responses.push({ headers, body });
+      } else {
+        responses.push({ headers: segment.trim(), body: "" });
+      }
+    }
+    if (responses.length > 1) {
+      const lastBody = responses[responses.length - 1].body;
+      for (let i = 0;i < responses.length - 1; i++) {
+        responses[i].body = "";
+      }
+      responses[responses.length - 1].body = lastBody;
+    }
+    return responses;
+  }
+  static parseCookiesFromStrings(setCookieStrings, url) {
+    if (setCookieStrings.length === 0) {
+      return {
+        array: [],
+        serialized: [],
+        netscape: "",
+        string: "",
+        setCookiesString: []
+      };
+    }
+    const jar = new RezoCookieJar;
+    jar.setCookiesSync(setCookieStrings, url);
+    return jar.cookies();
+  }
 }
 
 class CurlExecutor {
@@ -2148,6 +2241,9 @@ export async function executeRequest(options, defaultOptions, jar) {
       }
     }
   }
+  if (!config.requestId) {
+    config.requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+  }
   debugLog.requestStart(config, requestUrl, method);
   let streamResponse;
   let downloadResponse;
@@ -2201,6 +2297,11 @@ export async function executeRequest(options, defaultOptions, jar) {
       const duration = perform.now();
       debugLog.response(config, response.status, response.statusText, duration);
       debugLog.cookies(config, response.cookies?.array?.length || 0);
+      if (response.cookies?.setCookiesString?.length > 0 && jar) {
+        try {
+          jar.setCookiesSync(response.cookies.setCookiesString, response.finalUrl || requestUrl);
+        } catch (e) {}
+      }
       if (cache) {
         if (response.status === 304 && cachedEntry) {
           const responseHeaders = response.headers instanceof RezoHeaders ? Object.fromEntries(response.headers.entries()) : response.headers;
@@ -2220,21 +2321,31 @@ export async function executeRequest(options, defaultOptions, jar) {
         if (config.retry) {
           const maxRetries = config.retry.maxRetries || 0;
           const statusCodes = config.retry.statusCodes || [408, 429, 500, 502, 503, 504];
-          if (config.retryAttempts < maxRetries && statusCodes.includes(response.status)) {
-            const retryDelay = config.retry.retryDelay || 0;
-            const incrementDelay = config.retry.incrementDelay || false;
-            const delay = incrementDelay ? retryDelay * (config.retryAttempts + 1) : retryDelay;
-            debugLog.retry(config, config.retryAttempts + 1, maxRetries, response.status, delay);
-            if (config.hooks?.beforeRetry && config.hooks.beforeRetry.length > 0) {
-              for (const hook of config.hooks.beforeRetry) {
-                await hook(config, httpError, config.retryAttempts + 1);
+          if (statusCodes.includes(response.status)) {
+            if (config.retryAttempts < maxRetries) {
+              config.retryAttempts++;
+              if (!config.errors)
+                config.errors = [];
+              config.errors.push({
+                attempt: config.retryAttempts,
+                error: httpError,
+                duration: perform.now()
+              });
+              perform.reset();
+              const retryDelay = config.retry.retryDelay || 0;
+              const incrementDelay = config.retry.incrementDelay || false;
+              const delay = incrementDelay ? retryDelay * config.retryAttempts : retryDelay;
+              debugLog.retry(config, config.retryAttempts, maxRetries, response.status, delay);
+              if (config.hooks?.beforeRetry && config.hooks.beforeRetry.length > 0) {
+                for (const hook of config.hooks.beforeRetry) {
+                  await hook(config, httpError, config.retryAttempts);
+                }
               }
+              if (delay > 0) {
+                await new Promise((resolve) => setTimeout(resolve, delay));
+              }
+              return executeRequest(options, defaultOptions, jar);
             }
-            if (delay > 0) {
-              await new Promise((resolve) => setTimeout(resolve, delay));
-            }
-            config.retryAttempts++;
-            return executeRequest(options, defaultOptions, jar);
           }
           debugLog.maxRetries(config, maxRetries);
         }

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

@@ -4355,6 +4355,71 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more control
 	 */
 	clearCookies(): void;
+	/**
+	 * Convert a Rezo request configuration to a cURL command string.
+	 *
+	 * Generates a valid cURL command that can be executed in a terminal to
+	 * reproduce the same HTTP request. Useful for:
+	 * - Debugging and sharing requests
+	 * - Documentation and examples
+	 * - Testing requests outside of Node.js
+	 * - Exporting requests to other tools
+	 *
+	 * @param config - Request configuration object
+	 * @returns A cURL command string
+	 *
+	 * @example
+	 * ```typescript
+	 * const curl = Rezo.toCurl({
+	 *   url: 'https://api.example.com/users',
+	 *   method: 'POST',
+	 *   headers: { 'Content-Type': 'application/json' },
+	 *   body: { name: 'John', email: 'john@example.com' }
+	 * });
+	 * // Output: curl -X POST -H 'content-type: application/json' --data-raw '{"name":"John","email":"john@example.com"}' -L --compressed 'https://api.example.com/users'
+	 * ```
+	 */
+	static toCurl(config: RezoRequestConfig | RezoRequestOptions): string;
+	/**
+	 * Parse a cURL command string into a Rezo request configuration.
+	 *
+	 * Converts a cURL command into a configuration object that can be
+	 * passed directly to Rezo request methods. Useful for:
+	 * - Importing requests from browser DevTools
+	 * - Converting curl examples from API documentation
+	 * - Migrating scripts from curl to Rezo
+	 *
+	 * Supports common cURL options:
+	 * - `-X, --request` - HTTP method
+	 * - `-H, --header` - Request headers
+	 * - `-d, --data, --data-raw, --data-binary` - Request body
+	 * - `-u, --user` - Basic authentication
+	 * - `-x, --proxy` - Proxy configuration
+	 * - `--socks5, --socks4` - SOCKS proxy
+	 * - `-L, --location` - Follow redirects
+	 * - `--max-redirs` - Maximum redirects
+	 * - `--max-time` - Request timeout
+	 * - `-k, --insecure` - Skip TLS verification
+	 * - `-A, --user-agent` - User agent header
+	 *
+	 * @param curlCommand - A cURL command string
+	 * @returns A request configuration object
+	 *
+	 * @example
+	 * ```typescript
+	 * // From browser DevTools "Copy as cURL"
+	 * const config = Rezo.fromCurl(`
+	 *   curl 'https://api.example.com/data' \\
+	 *     -H 'Authorization: Bearer token123' \\
+	 *     -H 'Content-Type: application/json'
+	 * `);
+	 *
+	 * // Use with Rezo
+	 * const rezo = new Rezo();
+	 * const response = await rezo.request(config);
+	 * ```
+	 */
+	static fromCurl(curlCommand: string): RezoRequestOptions;
 }
 /**
  * Extended Rezo instance with Axios-compatible static helpers.

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

@@ -4355,6 +4355,71 @@ export declare class Rezo {
 	 * @see {@link cookieJar} - Access the underlying RezoCookieJar for more control
 	 */
 	clearCookies(): void;
+	/**
+	 * Convert a Rezo request configuration to a cURL command string.
+	 *
+	 * Generates a valid cURL command that can be executed in a terminal to
+	 * reproduce the same HTTP request. Useful for:
+	 * - Debugging and sharing requests
+	 * - Documentation and examples
+	 * - Testing requests outside of Node.js
+	 * - Exporting requests to other tools
+	 *
+	 * @param config - Request configuration object
+	 * @returns A cURL command string
+	 *
+	 * @example
+	 * ```typescript
+	 * const curl = Rezo.toCurl({
+	 *   url: 'https://api.example.com/users',
+	 *   method: 'POST',
+	 *   headers: { 'Content-Type': 'application/json' },
+	 *   body: { name: 'John', email: 'john@example.com' }
+	 * });
+	 * // Output: curl -X POST -H 'content-type: application/json' --data-raw '{"name":"John","email":"john@example.com"}' -L --compressed 'https://api.example.com/users'
+	 * ```
+	 */
+	static toCurl(config: RezoRequestConfig | RezoRequestOptions): string;
+	/**
+	 * Parse a cURL command string into a Rezo request configuration.
+	 *
+	 * Converts a cURL command into a configuration object that can be
+	 * passed directly to Rezo request methods. Useful for:
+	 * - Importing requests from browser DevTools
+	 * - Converting curl examples from API documentation
+	 * - Migrating scripts from curl to Rezo
+	 *
+	 * Supports common cURL options:
+	 * - `-X, --request` - HTTP method
+	 * - `-H, --header` - Request headers
+	 * - `-d, --data, --data-raw, --data-binary` - Request body
+	 * - `-u, --user` - Basic authentication
+	 * - `-x, --proxy` - Proxy configuration
+	 * - `--socks5, --socks4` - SOCKS proxy
+	 * - `-L, --location` - Follow redirects
+	 * - `--max-redirs` - Maximum redirects
+	 * - `--max-time` - Request timeout
+	 * - `-k, --insecure` - Skip TLS verification
+	 * - `-A, --user-agent` - User agent header
+	 *
+	 * @param curlCommand - A cURL command string
+	 * @returns A request configuration object
+	 *
+	 * @example
+	 * ```typescript
+	 * // From browser DevTools "Copy as cURL"
+	 * const config = Rezo.fromCurl(`
+	 *   curl 'https://api.example.com/data' \\
+	 *     -H 'Authorization: Bearer token123' \\
+	 *     -H 'Content-Type: application/json'
+	 * `);
+	 *
+	 * // Use with Rezo
+	 * const rezo = new Rezo();
+	 * const response = await rezo.request(config);
+	 * ```
+	 */
+	static fromCurl(curlCommand: string): RezoRequestOptions;
 }
 /**
  * Extended Rezo instance with Axios-compatible static helpers.