rezo 1.0.44 → 1.0.46

package/dist/crawler/index.cjs

@@ -1,40 +1,40 @@
-const _mod_uzdw07 = require('./crawler.cjs');
-exports.Crawler = _mod_uzdw07.Crawler;;
-const _mod_fk2i9s = require('./crawler-options.cjs');
-exports.CrawlerOptions = _mod_fk2i9s.CrawlerOptions;;
-const _mod_y9972f = require('./plugin/robots-txt.cjs');
-exports.RobotsTxt = _mod_y9972f.RobotsTxt;;
-const _mod_y7t1zo = require('./plugin/file-cacher.cjs');
-exports.FileCacher = _mod_y7t1zo.FileCacher;;
-const _mod_ecu03i = require('./plugin/url-store.cjs');
-exports.UrlStore = _mod_ecu03i.UrlStore;;
-const _mod_kxfnq7 = require('./plugin/navigation-history.cjs');
-exports.NavigationHistory = _mod_kxfnq7.NavigationHistory;;
-const _mod_bg9vts = require('./addon/oxylabs/index.cjs');
-exports.Oxylabs = _mod_bg9vts.Oxylabs;;
-const _mod_zd2i1t = require('./addon/oxylabs/options.cjs');
-exports.OXYLABS_BROWSER_TYPES = _mod_zd2i1t.OXYLABS_BROWSER_TYPES;
-exports.OXYLABS_COMMON_LOCALES = _mod_zd2i1t.OXYLABS_COMMON_LOCALES;
-exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_zd2i1t.OXYLABS_COMMON_GEO_LOCATIONS;
-exports.OXYLABS_US_STATES = _mod_zd2i1t.OXYLABS_US_STATES;
-exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_zd2i1t.OXYLABS_EUROPEAN_COUNTRIES;
-exports.OXYLABS_ASIAN_COUNTRIES = _mod_zd2i1t.OXYLABS_ASIAN_COUNTRIES;
-exports.getRandomOxylabsBrowserType = _mod_zd2i1t.getRandomBrowserType;
-exports.getRandomOxylabsLocale = _mod_zd2i1t.getRandomLocale;
-exports.getRandomOxylabsGeoLocation = _mod_zd2i1t.getRandomGeoLocation;;
-const _mod_gr8483 = require('./addon/decodo/index.cjs');
-exports.Decodo = _mod_gr8483.Decodo;;
-const _mod_km63k6 = require('./addon/decodo/options.cjs');
-exports.DECODO_DEVICE_TYPES = _mod_km63k6.DECODO_DEVICE_TYPES;
-exports.DECODO_HEADLESS_MODES = _mod_km63k6.DECODO_HEADLESS_MODES;
-exports.DECODO_COMMON_LOCALES = _mod_km63k6.DECODO_COMMON_LOCALES;
-exports.DECODO_COMMON_COUNTRIES = _mod_km63k6.DECODO_COMMON_COUNTRIES;
-exports.DECODO_EUROPEAN_COUNTRIES = _mod_km63k6.DECODO_EUROPEAN_COUNTRIES;
-exports.DECODO_ASIAN_COUNTRIES = _mod_km63k6.DECODO_ASIAN_COUNTRIES;
-exports.DECODO_US_STATES = _mod_km63k6.DECODO_US_STATES;
-exports.DECODO_COMMON_CITIES = _mod_km63k6.DECODO_COMMON_CITIES;
-exports.getRandomDecodoDeviceType = _mod_km63k6.getRandomDeviceType;
-exports.getRandomDecodoLocale = _mod_km63k6.getRandomLocale;
-exports.getRandomDecodoCountry = _mod_km63k6.getRandomCountry;
-exports.getRandomDecodoCity = _mod_km63k6.getRandomCity;
-exports.generateDecodoSessionId = _mod_km63k6.generateSessionId;;
+const _mod_33fvzd = require('./crawler.cjs');
+exports.Crawler = _mod_33fvzd.Crawler;;
+const _mod_1ldv58 = require('./crawler-options.cjs');
+exports.CrawlerOptions = _mod_1ldv58.CrawlerOptions;;
+const _mod_imehct = require('./plugin/robots-txt.cjs');
+exports.RobotsTxt = _mod_imehct.RobotsTxt;;
+const _mod_u0gyun = require('./plugin/file-cacher.cjs');
+exports.FileCacher = _mod_u0gyun.FileCacher;;
+const _mod_9wk5ke = require('./plugin/url-store.cjs');
+exports.UrlStore = _mod_9wk5ke.UrlStore;;
+const _mod_yqhjwv = require('./plugin/navigation-history.cjs');
+exports.NavigationHistory = _mod_yqhjwv.NavigationHistory;;
+const _mod_klxadq = require('./addon/oxylabs/index.cjs');
+exports.Oxylabs = _mod_klxadq.Oxylabs;;
+const _mod_n6jnu4 = require('./addon/oxylabs/options.cjs');
+exports.OXYLABS_BROWSER_TYPES = _mod_n6jnu4.OXYLABS_BROWSER_TYPES;
+exports.OXYLABS_COMMON_LOCALES = _mod_n6jnu4.OXYLABS_COMMON_LOCALES;
+exports.OXYLABS_COMMON_GEO_LOCATIONS = _mod_n6jnu4.OXYLABS_COMMON_GEO_LOCATIONS;
+exports.OXYLABS_US_STATES = _mod_n6jnu4.OXYLABS_US_STATES;
+exports.OXYLABS_EUROPEAN_COUNTRIES = _mod_n6jnu4.OXYLABS_EUROPEAN_COUNTRIES;
+exports.OXYLABS_ASIAN_COUNTRIES = _mod_n6jnu4.OXYLABS_ASIAN_COUNTRIES;
+exports.getRandomOxylabsBrowserType = _mod_n6jnu4.getRandomBrowserType;
+exports.getRandomOxylabsLocale = _mod_n6jnu4.getRandomLocale;
+exports.getRandomOxylabsGeoLocation = _mod_n6jnu4.getRandomGeoLocation;;
+const _mod_sjw00p = require('./addon/decodo/index.cjs');
+exports.Decodo = _mod_sjw00p.Decodo;;
+const _mod_f5prd7 = require('./addon/decodo/options.cjs');
+exports.DECODO_DEVICE_TYPES = _mod_f5prd7.DECODO_DEVICE_TYPES;
+exports.DECODO_HEADLESS_MODES = _mod_f5prd7.DECODO_HEADLESS_MODES;
+exports.DECODO_COMMON_LOCALES = _mod_f5prd7.DECODO_COMMON_LOCALES;
+exports.DECODO_COMMON_COUNTRIES = _mod_f5prd7.DECODO_COMMON_COUNTRIES;
+exports.DECODO_EUROPEAN_COUNTRIES = _mod_f5prd7.DECODO_EUROPEAN_COUNTRIES;
+exports.DECODO_ASIAN_COUNTRIES = _mod_f5prd7.DECODO_ASIAN_COUNTRIES;
+exports.DECODO_US_STATES = _mod_f5prd7.DECODO_US_STATES;
+exports.DECODO_COMMON_CITIES = _mod_f5prd7.DECODO_COMMON_CITIES;
+exports.getRandomDecodoDeviceType = _mod_f5prd7.getRandomDeviceType;
+exports.getRandomDecodoLocale = _mod_f5prd7.getRandomLocale;
+exports.getRandomDecodoCountry = _mod_f5prd7.getRandomCountry;
+exports.getRandomDecodoCity = _mod_f5prd7.getRandomCity;
+exports.generateDecodoSessionId = _mod_f5prd7.generateSessionId;;

package/dist/crawler.d.ts

@@ -1528,6 +1528,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
@@ -1608,6 +1637,7 @@ export interface RezoHooks {
 	onTls: OnTlsHook[];
 	onTimeout: OnTimeoutHook[];
 	onAbort: OnAbortHook[];
+	onRateLimitWait: OnRateLimitWaitHook[];
 }
 /**
  * Configuration object that encapsulates comprehensive request execution metadata and response processing information.
@@ -2433,6 +2463,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/entries/crawler.cjs

@@ -1,5 +1,5 @@
-const _mod_398eir = require('../crawler/crawler.cjs');
-exports.Crawler = _mod_398eir.Crawler;;
-const _mod_m4xc57 = require('../crawler/crawler-options.cjs');
-exports.CrawlerOptions = _mod_m4xc57.CrawlerOptions;
-exports.Domain = _mod_m4xc57.Domain;;
+const _mod_jqo3a7 = require('../crawler/crawler.cjs');
+exports.Crawler = _mod_jqo3a7.Crawler;;
+const _mod_5y7u4a = require('../crawler/crawler-options.cjs');
+exports.CrawlerOptions = _mod_5y7u4a.CrawlerOptions;
+exports.Domain = _mod_5y7u4a.Domain;;

package/dist/index.cjs

@@ -1,30 +1,30 @@
-const _mod_y77uk1 = require('./core/rezo.cjs');
-exports.Rezo = _mod_y77uk1.Rezo;
-exports.createRezoInstance = _mod_y77uk1.createRezoInstance;
-exports.createDefaultInstance = _mod_y77uk1.createDefaultInstance;;
-const _mod_dc3jgu = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_dc3jgu.RezoError;
-exports.RezoErrorCode = _mod_dc3jgu.RezoErrorCode;;
-const _mod_o16xti = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_o16xti.RezoHeaders;;
-const _mod_y43k9y = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_y43k9y.RezoFormData;;
-const _mod_n8l01e = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_n8l01e.RezoCookieJar;
-exports.Cookie = _mod_n8l01e.Cookie;;
-const _mod_3ypli0 = require('./utils/curl.cjs');
-exports.toCurl = _mod_3ypli0.toCurl;
-exports.fromCurl = _mod_3ypli0.fromCurl;;
-const _mod_1mlx0a = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_1mlx0a.createDefaultHooks;
-exports.mergeHooks = _mod_1mlx0a.mergeHooks;;
-const _mod_xo1ifa = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_xo1ifa.ProxyManager;;
-const _mod_77x7bf = require('./queue/index.cjs');
-exports.RezoQueue = _mod_77x7bf.RezoQueue;
-exports.HttpQueue = _mod_77x7bf.HttpQueue;
-exports.Priority = _mod_77x7bf.Priority;
-exports.HttpMethodPriority = _mod_77x7bf.HttpMethodPriority;;
+const _mod_vh18hs = require('./core/rezo.cjs');
+exports.Rezo = _mod_vh18hs.Rezo;
+exports.createRezoInstance = _mod_vh18hs.createRezoInstance;
+exports.createDefaultInstance = _mod_vh18hs.createDefaultInstance;;
+const _mod_o1tm8z = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_o1tm8z.RezoError;
+exports.RezoErrorCode = _mod_o1tm8z.RezoErrorCode;;
+const _mod_qs57sl = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_qs57sl.RezoHeaders;;
+const _mod_bcveiy = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_bcveiy.RezoFormData;;
+const _mod_j7t4t9 = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_j7t4t9.RezoCookieJar;
+exports.Cookie = _mod_j7t4t9.Cookie;;
+const _mod_cuuq7u = require('./utils/curl.cjs');
+exports.toCurl = _mod_cuuq7u.toCurl;
+exports.fromCurl = _mod_cuuq7u.fromCurl;;
+const _mod_psm01k = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_psm01k.createDefaultHooks;
+exports.mergeHooks = _mod_psm01k.mergeHooks;;
+const _mod_x2anu4 = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_x2anu4.ProxyManager;;
+const _mod_tnhdd0 = require('./queue/index.cjs');
+exports.RezoQueue = _mod_tnhdd0.RezoQueue;
+exports.HttpQueue = _mod_tnhdd0.HttpQueue;
+exports.Priority = _mod_tnhdd0.Priority;
+exports.HttpMethodPriority = _mod_tnhdd0.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/index.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
@@ -2552,6 +2582,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/internal/agents/index.cjs

@@ -1,10 +1,10 @@
-const _mod_ka4e3g = require('./base.cjs');
-exports.Agent = _mod_ka4e3g.Agent;;
-const _mod_nmerdf = require('./http-proxy.cjs');
-exports.HttpProxyAgent = _mod_nmerdf.HttpProxyAgent;;
-const _mod_do1bvj = require('./https-proxy.cjs');
-exports.HttpsProxyAgent = _mod_do1bvj.HttpsProxyAgent;;
-const _mod_1bn8q4 = require('./socks-proxy.cjs');
-exports.SocksProxyAgent = _mod_1bn8q4.SocksProxyAgent;;
-const _mod_wb9id7 = require('./socks-client.cjs');
-exports.SocksClient = _mod_wb9id7.SocksClient;;
+const _mod_150zmc = require('./base.cjs');
+exports.Agent = _mod_150zmc.Agent;;
+const _mod_0kmp78 = require('./http-proxy.cjs');
+exports.HttpProxyAgent = _mod_0kmp78.HttpProxyAgent;;
+const _mod_4tvb7u = require('./https-proxy.cjs');
+exports.HttpsProxyAgent = _mod_4tvb7u.HttpsProxyAgent;;
+const _mod_wgeif4 = require('./socks-proxy.cjs');
+exports.SocksProxyAgent = _mod_wgeif4.SocksProxyAgent;;
+const _mod_3nqvg8 = require('./socks-client.cjs');
+exports.SocksClient = _mod_3nqvg8.SocksClient;;

package/dist/platform/browser.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 */