rezo 1.0.43 → 1.0.45

package/dist/platform/node.d.ts

@@ -1416,6 +1416,35 @@ export type OnTimeoutHook = (event: TimeoutEvent, config: RezoConfig) => void;
  * Use for cleanup, logging
  */
 export type OnAbortHook = (event: AbortEvent, config: RezoConfig) => void;
+/**
+ * Rate limit wait event data - fired when waiting due to rate limiting
+ */
+export interface RateLimitWaitEvent {
+	/** HTTP status code that triggered the wait (e.g., 429, 503) */
+	status: number;
+	/** Time to wait in milliseconds */
+	waitTime: number;
+	/** Current wait attempt number (1-indexed) */
+	attempt: number;
+	/** Maximum wait attempts configured */
+	maxAttempts: number;
+	/** Where the wait time was extracted from */
+	source: "header" | "body" | "function" | "default";
+	/** The header or body path used (if applicable) */
+	sourcePath?: string;
+	/** URL being requested */
+	url: string;
+	/** HTTP method of the request */
+	method: string;
+	/** Timestamp when the wait started */
+	timestamp: number;
+}
+/**
+ * Hook called when rate limit wait occurs
+ * Informational only - cannot abort the wait
+ * Use for logging, monitoring, alerting
+ */
+export type OnRateLimitWaitHook = (event: RateLimitWaitEvent, config: RezoConfig) => void | Promise<void>;
 /**
  * Hook called before a proxy is selected
  * Can return a specific proxy to override selection
@@ -1496,6 +1525,7 @@ export interface RezoHooks {
 	onTls: OnTlsHook[];
 	onTimeout: OnTimeoutHook[];
 	onAbort: OnAbortHook[];
+	onRateLimitWait: OnRateLimitWaitHook[];
 }
 /**
  * Create empty hooks object with all arrays initialized
@@ -2426,6 +2456,91 @@ export interface RezoRequestConfig<D = any> {
 		/** Weather to stop or continue retry when certain condition is met*/
 		condition?: (error: RezoError) => boolean | Promise<boolean>;
 	};
+	/**
+	 * Rate limit wait configuration - wait and retry when receiving rate limit responses.
+	 *
+	 * This feature runs BEFORE the retry system. When a rate-limiting status code is received,
+	 * the client will wait for the specified time and automatically retry the request.
+	 *
+	 * **Basic Usage:**
+	 * - `waitOnStatus: true` - Enable waiting on 429 status (default behavior)
+	 * - `waitOnStatus: [429, 503]` - Enable waiting on specific status codes
+	 *
+	 * **Wait Time Sources:**
+	 * - `'retry-after'` - Use standard Retry-After header (default)
+	 * - `{ header: 'X-RateLimit-Reset' }` - Use custom header
+	 * - `{ body: 'retry_after' }` - Extract from JSON response body
+	 * - Custom function for complex logic
+	 *
+	 * @example
+	 * ```typescript
+	 * // Wait on 429 using Retry-After header
+	 * await rezo.get(url, { waitOnStatus: true });
+	 *
+	 * // Wait on 429 using custom header
+	 * await rezo.get(url, {
+	 *   waitOnStatus: true,
+	 *   waitTimeSource: { header: 'X-RateLimit-Reset' }
+	 * });
+	 *
+	 * // Wait on 429 extracting time from JSON body
+	 * await rezo.get(url, {
+	 *   waitOnStatus: true,
+	 *   waitTimeSource: { body: 'data.retry_after' }
+	 * });
+	 *
+	 * // Custom function for complex APIs
+	 * await rezo.get(url, {
+	 *   waitOnStatus: [429, 503],
+	 *   waitTimeSource: (response) => {
+	 *     const reset = response.headers.get('x-ratelimit-reset');
+	 *     return reset ? parseInt(reset) - Math.floor(Date.now() / 1000) : null;
+	 *   }
+	 * });
+	 * ```
+	 */
+	waitOnStatus?: boolean | number[];
+	/**
+	 * Where to extract the wait time from when rate-limited.
+	 *
+	 * - `'retry-after'` - Standard Retry-After header (default)
+	 * - `{ header: string }` - Custom header name (e.g., 'X-RateLimit-Reset')
+	 * - `{ body: string }` - JSON path in response body (e.g., 'data.retry_after', 'wait_seconds')
+	 * - Function - Custom logic receiving the response, return seconds to wait or null
+	 *
+	 * @default 'retry-after'
+	 */
+	waitTimeSource?: "retry-after" | {
+		header: string;
+	} | {
+		body: string;
+	} | ((response: {
+		status: number;
+		headers: RezoHeaders;
+		data?: any;
+	}) => number | null);
+	/**
+	 * Maximum time to wait for rate limit in milliseconds.
+	 * If the extracted wait time exceeds this, the request will fail instead of waiting.
+	 * Set to 0 for unlimited wait time.
+	 *
+	 * @default 60000 (60 seconds)
+	 */
+	maxWaitTime?: number;
+	/**
+	 * Default wait time in milliseconds if the wait time source returns nothing.
+	 * Used as fallback when Retry-After header or body path is not present.
+	 *
+	 * @default 1000 (1 second)
+	 */
+	defaultWaitTime?: number;
+	/**
+	 * Maximum number of wait attempts before giving up.
+	 * After this many waits, the request will proceed to retry logic or fail.
+	 *
+	 * @default 3
+	 */
+	maxWaitAttempts?: number;
 	/** Whether to use a secure context for HTTPS requests */
 	useSecureContext?: boolean;
 	/** Custom secure context for TLS connections */

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

@@ -1416,6 +1416,35 @@ export type OnTimeoutHook = (event: TimeoutEvent, config: RezoConfig) => void;
  * Use for cleanup, logging
  */
 export type OnAbortHook = (event: AbortEvent, config: RezoConfig) => void;
+/**
+ * Rate limit wait event data - fired when waiting due to rate limiting
+ */
+export interface RateLimitWaitEvent {
+	/** HTTP status code that triggered the wait (e.g., 429, 503) */
+	status: number;
+	/** Time to wait in milliseconds */
+	waitTime: number;
+	/** Current wait attempt number (1-indexed) */
+	attempt: number;
+	/** Maximum wait attempts configured */
+	maxAttempts: number;
+	/** Where the wait time was extracted from */
+	source: "header" | "body" | "function" | "default";
+	/** The header or body path used (if applicable) */
+	sourcePath?: string;
+	/** URL being requested */
+	url: string;
+	/** HTTP method of the request */
+	method: string;
+	/** Timestamp when the wait started */
+	timestamp: number;
+}
+/**
+ * Hook called when rate limit wait occurs
+ * Informational only - cannot abort the wait
+ * Use for logging, monitoring, alerting
+ */
+export type OnRateLimitWaitHook = (event: RateLimitWaitEvent, config: RezoConfig) => void | Promise<void>;
 /**
  * Hook called before a proxy is selected
  * Can return a specific proxy to override selection
@@ -1496,6 +1525,7 @@ export interface RezoHooks {
 	onTls: OnTlsHook[];
 	onTimeout: OnTimeoutHook[];
 	onAbort: OnAbortHook[];
+	onRateLimitWait: OnRateLimitWaitHook[];
 }
 /**
  * Create empty hooks object with all arrays initialized
@@ -2426,6 +2456,91 @@ export interface RezoRequestConfig<D = any> {
 		/** Weather to stop or continue retry when certain condition is met*/
 		condition?: (error: RezoError) => boolean | Promise<boolean>;
 	};
+	/**
+	 * Rate limit wait configuration - wait and retry when receiving rate limit responses.
+	 *
+	 * This feature runs BEFORE the retry system. When a rate-limiting status code is received,
+	 * the client will wait for the specified time and automatically retry the request.
+	 *
+	 * **Basic Usage:**
+	 * - `waitOnStatus: true` - Enable waiting on 429 status (default behavior)
+	 * - `waitOnStatus: [429, 503]` - Enable waiting on specific status codes
+	 *
+	 * **Wait Time Sources:**
+	 * - `'retry-after'` - Use standard Retry-After header (default)
+	 * - `{ header: 'X-RateLimit-Reset' }` - Use custom header
+	 * - `{ body: 'retry_after' }` - Extract from JSON response body
+	 * - Custom function for complex logic
+	 *
+	 * @example
+	 * ```typescript
+	 * // Wait on 429 using Retry-After header
+	 * await rezo.get(url, { waitOnStatus: true });
+	 *
+	 * // Wait on 429 using custom header
+	 * await rezo.get(url, {
+	 *   waitOnStatus: true,
+	 *   waitTimeSource: { header: 'X-RateLimit-Reset' }
+	 * });
+	 *
+	 * // Wait on 429 extracting time from JSON body
+	 * await rezo.get(url, {
+	 *   waitOnStatus: true,
+	 *   waitTimeSource: { body: 'data.retry_after' }
+	 * });
+	 *
+	 * // Custom function for complex APIs
+	 * await rezo.get(url, {
+	 *   waitOnStatus: [429, 503],
+	 *   waitTimeSource: (response) => {
+	 *     const reset = response.headers.get('x-ratelimit-reset');
+	 *     return reset ? parseInt(reset) - Math.floor(Date.now() / 1000) : null;
+	 *   }
+	 * });
+	 * ```
+	 */
+	waitOnStatus?: boolean | number[];
+	/**
+	 * Where to extract the wait time from when rate-limited.
+	 *
+	 * - `'retry-after'` - Standard Retry-After header (default)
+	 * - `{ header: string }` - Custom header name (e.g., 'X-RateLimit-Reset')
+	 * - `{ body: string }` - JSON path in response body (e.g., 'data.retry_after', 'wait_seconds')
+	 * - Function - Custom logic receiving the response, return seconds to wait or null
+	 *
+	 * @default 'retry-after'
+	 */
+	waitTimeSource?: "retry-after" | {
+		header: string;
+	} | {
+		body: string;
+	} | ((response: {
+		status: number;
+		headers: RezoHeaders;
+		data?: any;
+	}) => number | null);
+	/**
+	 * Maximum time to wait for rate limit in milliseconds.
+	 * If the extracted wait time exceeds this, the request will fail instead of waiting.
+	 * Set to 0 for unlimited wait time.
+	 *
+	 * @default 60000 (60 seconds)
+	 */
+	maxWaitTime?: number;
+	/**
+	 * Default wait time in milliseconds if the wait time source returns nothing.
+	 * Used as fallback when Retry-After header or body path is not present.
+	 *
+	 * @default 1000 (1 second)
+	 */
+	defaultWaitTime?: number;
+	/**
+	 * Maximum number of wait attempts before giving up.
+	 * After this many waits, the request will proceed to retry logic or fail.
+	 *
+	 * @default 3
+	 */
+	maxWaitAttempts?: number;
 	/** Whether to use a secure context for HTTPS requests */
 	useSecureContext?: boolean;
 	/** Custom secure context for TLS connections */

package/dist/platform/worker.d.ts

@@ -1416,6 +1416,35 @@ export type OnTimeoutHook = (event: TimeoutEvent, config: RezoConfig) => void;
  * Use for cleanup, logging
  */
 export type OnAbortHook = (event: AbortEvent, config: RezoConfig) => void;
+/**
+ * Rate limit wait event data - fired when waiting due to rate limiting
+ */
+export interface RateLimitWaitEvent {
+	/** HTTP status code that triggered the wait (e.g., 429, 503) */
+	status: number;
+	/** Time to wait in milliseconds */
+	waitTime: number;
+	/** Current wait attempt number (1-indexed) */
+	attempt: number;
+	/** Maximum wait attempts configured */
+	maxAttempts: number;
+	/** Where the wait time was extracted from */
+	source: "header" | "body" | "function" | "default";
+	/** The header or body path used (if applicable) */
+	sourcePath?: string;
+	/** URL being requested */
+	url: string;
+	/** HTTP method of the request */
+	method: string;
+	/** Timestamp when the wait started */
+	timestamp: number;
+}
+/**
+ * Hook called when rate limit wait occurs
+ * Informational only - cannot abort the wait
+ * Use for logging, monitoring, alerting
+ */
+export type OnRateLimitWaitHook = (event: RateLimitWaitEvent, config: RezoConfig) => void | Promise<void>;
 /**
  * Hook called before a proxy is selected
  * Can return a specific proxy to override selection
@@ -1496,6 +1525,7 @@ export interface RezoHooks {
 	onTls: OnTlsHook[];
 	onTimeout: OnTimeoutHook[];
 	onAbort: OnAbortHook[];
+	onRateLimitWait: OnRateLimitWaitHook[];
 }
 /**
  * Create empty hooks object with all arrays initialized
@@ -2426,6 +2456,91 @@ export interface RezoRequestConfig<D = any> {
 		/** Weather to stop or continue retry when certain condition is met*/
 		condition?: (error: RezoError) => boolean | Promise<boolean>;
 	};
+	/**
+	 * Rate limit wait configuration - wait and retry when receiving rate limit responses.
+	 *
+	 * This feature runs BEFORE the retry system. When a rate-limiting status code is received,
+	 * the client will wait for the specified time and automatically retry the request.
+	 *
+	 * **Basic Usage:**
+	 * - `waitOnStatus: true` - Enable waiting on 429 status (default behavior)
+	 * - `waitOnStatus: [429, 503]` - Enable waiting on specific status codes
+	 *
+	 * **Wait Time Sources:**
+	 * - `'retry-after'` - Use standard Retry-After header (default)
+	 * - `{ header: 'X-RateLimit-Reset' }` - Use custom header
+	 * - `{ body: 'retry_after' }` - Extract from JSON response body
+	 * - Custom function for complex logic
+	 *
+	 * @example
+	 * ```typescript
+	 * // Wait on 429 using Retry-After header
+	 * await rezo.get(url, { waitOnStatus: true });
+	 *
+	 * // Wait on 429 using custom header
+	 * await rezo.get(url, {
+	 *   waitOnStatus: true,
+	 *   waitTimeSource: { header: 'X-RateLimit-Reset' }
+	 * });
+	 *
+	 * // Wait on 429 extracting time from JSON body
+	 * await rezo.get(url, {
+	 *   waitOnStatus: true,
+	 *   waitTimeSource: { body: 'data.retry_after' }
+	 * });
+	 *
+	 * // Custom function for complex APIs
+	 * await rezo.get(url, {
+	 *   waitOnStatus: [429, 503],
+	 *   waitTimeSource: (response) => {
+	 *     const reset = response.headers.get('x-ratelimit-reset');
+	 *     return reset ? parseInt(reset) - Math.floor(Date.now() / 1000) : null;
+	 *   }
+	 * });
+	 * ```
+	 */
+	waitOnStatus?: boolean | number[];
+	/**
+	 * Where to extract the wait time from when rate-limited.
+	 *
+	 * - `'retry-after'` - Standard Retry-After header (default)
+	 * - `{ header: string }` - Custom header name (e.g., 'X-RateLimit-Reset')
+	 * - `{ body: string }` - JSON path in response body (e.g., 'data.retry_after', 'wait_seconds')
+	 * - Function - Custom logic receiving the response, return seconds to wait or null
+	 *
+	 * @default 'retry-after'
+	 */
+	waitTimeSource?: "retry-after" | {
+		header: string;
+	} | {
+		body: string;
+	} | ((response: {
+		status: number;
+		headers: RezoHeaders;
+		data?: any;
+	}) => number | null);
+	/**
+	 * Maximum time to wait for rate limit in milliseconds.
+	 * If the extracted wait time exceeds this, the request will fail instead of waiting.
+	 * Set to 0 for unlimited wait time.
+	 *
+	 * @default 60000 (60 seconds)
+	 */
+	maxWaitTime?: number;
+	/**
+	 * Default wait time in milliseconds if the wait time source returns nothing.
+	 * Used as fallback when Retry-After header or body path is not present.
+	 *
+	 * @default 1000 (1 second)
+	 */
+	defaultWaitTime?: number;
+	/**
+	 * Maximum number of wait attempts before giving up.
+	 * After this many waits, the request will proceed to retry logic or fail.
+	 *
+	 * @default 3
+	 */
+	maxWaitAttempts?: number;
 	/** Whether to use a secure context for HTTPS requests */
 	useSecureContext?: boolean;
 	/** Custom secure context for TLS connections */

package/dist/proxy/index.cjs

@@ -1,9 +1,9 @@
-const { Agent, HttpProxyAgent, HttpsProxyAgent, SocksProxyAgent } = require('../internal/agents.cjs');
+const { Agent, HttpProxyAgent, HttpsProxyAgent, SocksProxyAgent } = require('../internal/agents/index.cjs');
 const { parseProxyString } = require('./parse.cjs');
-const _mod_wpx4sa = require('./manager.cjs');
-exports.ProxyManager = _mod_wpx4sa.ProxyManager;;
-const _mod_138ems = require('./parse.cjs');
-exports.parseProxyString = _mod_138ems.parseProxyString;;
+const _mod_0wfzka = require('./manager.cjs');
+exports.ProxyManager = _mod_0wfzka.ProxyManager;;
+const _mod_bwzrrk = require('./parse.cjs');
+exports.parseProxyString = _mod_bwzrrk.parseProxyString;;
 function createOptions(uri, opts) {
   if (uri instanceof URL || typeof uri === "string") {
     return {

package/dist/proxy/index.js

@@ -3,7 +3,7 @@ import {
   HttpProxyAgent,
   HttpsProxyAgent,
   SocksProxyAgent
-} from '../internal/agents.js';
+} from '../internal/agents/index.js';
 import { parseProxyString } from './parse.js';
 export { ProxyManager } from './manager.js';
 export { parseProxyString } from './parse.js';

package/dist/queue/index.cjs

@@ -1,8 +1,8 @@
-const _mod_nvb61m = require('./queue.cjs');
-exports.RezoQueue = _mod_nvb61m.RezoQueue;;
-const _mod_rl81m9 = require('./http-queue.cjs');
-exports.HttpQueue = _mod_rl81m9.HttpQueue;
-exports.extractDomain = _mod_rl81m9.extractDomain;;
-const _mod_gou0ma = require('./types.cjs');
-exports.Priority = _mod_gou0ma.Priority;
-exports.HttpMethodPriority = _mod_gou0ma.HttpMethodPriority;;
+const _mod_cfqi4l = require('./queue.cjs');
+exports.RezoQueue = _mod_cfqi4l.RezoQueue;;
+const _mod_9m2if8 = require('./http-queue.cjs');
+exports.HttpQueue = _mod_9m2if8.HttpQueue;
+exports.extractDomain = _mod_9m2if8.extractDomain;;
+const _mod_w9of0o = require('./types.cjs');
+exports.Priority = _mod_w9of0o.Priority;
+exports.HttpMethodPriority = _mod_w9of0o.HttpMethodPriority;;

package/dist/responses/universal/index.cjs

@@ -1,11 +1,11 @@
-const _mod_cj1scv = require('./event-emitter.cjs');
-exports.UniversalEventEmitter = _mod_cj1scv.UniversalEventEmitter;;
-const _mod_ko3suu = require('./stream.cjs');
-exports.UniversalStreamResponse = _mod_ko3suu.UniversalStreamResponse;
-exports.StreamResponse = _mod_ko3suu.StreamResponse;;
-const _mod_gddm7l = require('./download.cjs');
-exports.UniversalDownloadResponse = _mod_gddm7l.UniversalDownloadResponse;
-exports.DownloadResponse = _mod_gddm7l.DownloadResponse;;
-const _mod_rxt6z9 = require('./upload.cjs');
-exports.UniversalUploadResponse = _mod_rxt6z9.UniversalUploadResponse;
-exports.UploadResponse = _mod_rxt6z9.UploadResponse;;
+const _mod_rxkza8 = require('./event-emitter.cjs');
+exports.UniversalEventEmitter = _mod_rxkza8.UniversalEventEmitter;;
+const _mod_gre5wb = require('./stream.cjs');
+exports.UniversalStreamResponse = _mod_gre5wb.UniversalStreamResponse;
+exports.StreamResponse = _mod_gre5wb.StreamResponse;;
+const _mod_xea59w = require('./download.cjs');
+exports.UniversalDownloadResponse = _mod_xea59w.UniversalDownloadResponse;
+exports.DownloadResponse = _mod_xea59w.DownloadResponse;;
+const _mod_1q9fpp = require('./upload.cjs');
+exports.UniversalUploadResponse = _mod_1q9fpp.UniversalUploadResponse;
+exports.UploadResponse = _mod_1q9fpp.UploadResponse;;

package/dist/utils/rate-limit-wait.cjs

@@ -0,0 +1,217 @@
+const { RezoHeaders } = require('./headers.cjs');
+const DEFAULT_WAIT_STATUS_CODES = exports.DEFAULT_WAIT_STATUS_CODES = [429];
+const DEFAULT_MAX_WAIT_TIME = exports.DEFAULT_MAX_WAIT_TIME = 60000;
+const DEFAULT_WAIT_TIME = exports.DEFAULT_WAIT_TIME = 1000;
+const DEFAULT_MAX_WAIT_ATTEMPTS = exports.DEFAULT_MAX_WAIT_ATTEMPTS = 3;
+function shouldWaitOnStatus(status, waitOnStatus) {
+  if (!waitOnStatus)
+    return false;
+  if (waitOnStatus === true) {
+    return DEFAULT_WAIT_STATUS_CODES.includes(status);
+  }
+  if (Array.isArray(waitOnStatus)) {
+    return waitOnStatus.includes(status);
+  }
+  return false;
+}
+function parseRetryAfterHeader(value) {
+  if (!value)
+    return null;
+  const trimmed = value.trim();
+  const seconds = parseInt(trimmed, 10);
+  if (!isNaN(seconds) && seconds >= 0) {
+    return seconds * 1000;
+  }
+  const date = new Date(trimmed);
+  if (!isNaN(date.getTime())) {
+    const delayMs = date.getTime() - Date.now();
+    return delayMs > 0 ? delayMs : 0;
+  }
+  return null;
+}
+function getNestedValue(obj, path) {
+  if (!obj || typeof path !== "string")
+    return;
+  const parts = path.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current === null || current === undefined)
+      return;
+    if (typeof current !== "object")
+      return;
+    current = current[part];
+  }
+  return current;
+}
+function extractWaitTime(response, options) {
+  const source = options.waitTimeSource ?? "retry-after";
+  const defaultWaitTime = options.defaultWaitTime ?? DEFAULT_WAIT_TIME;
+  if (typeof source === "function") {
+    try {
+      const seconds = source(response);
+      if (seconds !== null && seconds !== undefined && seconds > 0) {
+        return {
+          waitTimeMs: seconds * 1000,
+          source: "function"
+        };
+      }
+    } catch {}
+    return {
+      waitTimeMs: defaultWaitTime,
+      source: "default"
+    };
+  }
+  if (source === "retry-after") {
+    const headerValue = response.headers?.get?.("retry-after") ?? response.headers?.get?.("Retry-After") ?? response.headers?.["retry-after"] ?? response.headers?.["Retry-After"];
+    const waitTimeMs = parseRetryAfterHeader(headerValue);
+    if (waitTimeMs !== null) {
+      return {
+        waitTimeMs,
+        source: "header",
+        sourcePath: "retry-after"
+      };
+    }
+    return {
+      waitTimeMs: defaultWaitTime,
+      source: "default"
+    };
+  }
+  if (typeof source === "object" && "header" in source) {
+    const headerName = source.header;
+    const headerValue = response.headers?.get?.(headerName) ?? response.headers?.get?.(headerName.toLowerCase()) ?? response.headers?.[headerName] ?? response.headers?.[headerName.toLowerCase()];
+    if (headerValue) {
+      const numValue = parseInt(headerValue, 10);
+      if (!isNaN(numValue)) {
+        const now = Math.floor(Date.now() / 1000);
+        if (numValue > now && numValue < now + 86400 * 365) {
+          const waitTimeMs = (numValue - now) * 1000;
+          return {
+            waitTimeMs: waitTimeMs > 0 ? waitTimeMs : defaultWaitTime,
+            source: "header",
+            sourcePath: headerName
+          };
+        }
+        return {
+          waitTimeMs: numValue * 1000,
+          source: "header",
+          sourcePath: headerName
+        };
+      }
+      const waitTimeMs = parseRetryAfterHeader(headerValue);
+      if (waitTimeMs !== null) {
+        return {
+          waitTimeMs,
+          source: "header",
+          sourcePath: headerName
+        };
+      }
+    }
+    return {
+      waitTimeMs: defaultWaitTime,
+      source: "default"
+    };
+  }
+  if (typeof source === "object" && "body" in source) {
+    const bodyPath = source.body;
+    const value = getNestedValue(response.data, bodyPath);
+    if (value !== null && value !== undefined) {
+      const numValue = typeof value === "number" ? value : parseInt(String(value), 10);
+      if (!isNaN(numValue) && numValue > 0) {
+        return {
+          waitTimeMs: numValue * 1000,
+          source: "body",
+          sourcePath: bodyPath
+        };
+      }
+    }
+    return {
+      waitTimeMs: defaultWaitTime,
+      source: "default"
+    };
+  }
+  return {
+    waitTimeMs: defaultWaitTime,
+    source: "default"
+  };
+}
+function createRateLimitWaitEvent(status, waitTimeMs, attempt, maxAttempts, source, sourcePath, url, method) {
+  return {
+    status,
+    waitTime: waitTimeMs,
+    attempt,
+    maxAttempts,
+    source,
+    sourcePath,
+    url,
+    method,
+    timestamp: Date.now()
+  };
+}
+async function executeRateLimitWaitHooks(event, config) {
+  const hooks = config.hooks?.onRateLimitWait;
+  if (!hooks || hooks.length === 0)
+    return;
+  for (const hook of hooks) {
+    try {
+      await hook(event, config);
+    } catch (err) {
+      if (config.debug) {
+        console.log("[Rezo Debug] onRateLimitWait hook error:", err);
+      }
+    }
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function normalizeHeaders(headers) {
+  if (!headers)
+    return new RezoHeaders;
+  if (headers instanceof RezoHeaders)
+    return headers;
+  if (typeof headers.get === "function")
+    return headers;
+  try {
+    return new RezoHeaders(headers);
+  } catch {
+    return new RezoHeaders;
+  }
+}
+async function handleRateLimitWait(ctx) {
+  const { status, headers, data, url, method, config, options, currentWaitAttempt } = ctx;
+  if (!shouldWaitOnStatus(status, options.waitOnStatus)) {
+    return { shouldRetry: false, waitAttempt: currentWaitAttempt, waitedMs: 0 };
+  }
+  const maxAttempts = options.maxWaitAttempts ?? DEFAULT_MAX_WAIT_ATTEMPTS;
+  const maxWaitTime = options.maxWaitTime ?? DEFAULT_MAX_WAIT_TIME;
+  const nextAttempt = currentWaitAttempt + 1;
+  if (nextAttempt > maxAttempts) {
+    return { shouldRetry: false, waitAttempt: currentWaitAttempt, waitedMs: 0 };
+  }
+  const normalizedHeaders = normalizeHeaders(headers);
+  const extracted = extractWaitTime({ status, headers: normalizedHeaders, data }, options);
+  let waitTimeMs = extracted.waitTimeMs;
+  if (maxWaitTime > 0 && waitTimeMs > maxWaitTime) {
+    return { shouldRetry: false, waitAttempt: currentWaitAttempt, waitedMs: 0 };
+  }
+  const event = createRateLimitWaitEvent(status, waitTimeMs, nextAttempt, maxAttempts, extracted.source, extracted.sourcePath, url, method);
+  await executeRateLimitWaitHooks(event, config);
+  if (config.debug) {
+    console.log(`[Rezo Debug] Rate limit (${status}) - waiting ${waitTimeMs}ms (attempt ${nextAttempt}/${maxAttempts}, source: ${extracted.source}${extracted.sourcePath ? `:${extracted.sourcePath}` : ""})`);
+  }
+  await sleep(waitTimeMs);
+  return {
+    shouldRetry: true,
+    waitAttempt: nextAttempt,
+    waitedMs: waitTimeMs
+  };
+}
+
+exports.shouldWaitOnStatus = shouldWaitOnStatus;
+exports.parseRetryAfterHeader = parseRetryAfterHeader;
+exports.getNestedValue = getNestedValue;
+exports.extractWaitTime = extractWaitTime;
+exports.createRateLimitWaitEvent = createRateLimitWaitEvent;
+exports.executeRateLimitWaitHooks = executeRateLimitWaitHooks;
+exports.sleep = sleep;
+exports.handleRateLimitWait = handleRateLimitWait;