rezo 1.0.6 → 1.0.7

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

@@ -1191,6 +1191,35 @@ export interface AfterProxyEnableContext {
 	/** Reason for enabling */
 	reason: "cooldown-expired" | "manual";
 }
+/**
+ * Context for onNoProxiesAvailable hook
+ * Triggered when no proxies are available and an error would be thrown
+ */
+export interface OnNoProxiesAvailableContext {
+	/** Request URL that needed a proxy */
+	url: string;
+	/** The error that will be thrown */
+	error: Error;
+	/** All proxies (including disabled ones) */
+	allProxies: ProxyState[];
+	/** Number of active proxies (should be 0) */
+	activeCount: number;
+	/** Number of disabled proxies */
+	disabledCount: number;
+	/** Number of proxies in cooldown */
+	cooldownCount: number;
+	/** Reasons why proxies are unavailable */
+	disabledReasons: {
+		/** Proxies disabled due to failures */
+		dead: number;
+		/** Proxies disabled due to request limit */
+		limitReached: number;
+		/** Proxies manually disabled */
+		manual: number;
+	};
+	/** Timestamp when this event occurred */
+	timestamp: number;
+}
 /**
  * Context provided to beforeRequest hook
  * Contains metadata about the current request state
@@ -1509,6 +1538,16 @@ export type AfterProxyRotateHook = (context: AfterProxyRotateContext) => void |
  * Use for notifications, logging
  */
 export type AfterProxyEnableHook = (context: AfterProxyEnableContext) => void | Promise<void>;
+/**
+ * Hook called when no proxies are available and an error is about to be thrown
+ * Use for alerting, logging exhausted proxy pools, or triggering proxy refresh
+ * This hook is called just before the error is thrown, allowing you to:
+ * - Log the exhaustion event for monitoring
+ * - Trigger external proxy pool refresh
+ * - Send alerts to monitoring systems
+ * - Record statistics about proxy pool health
+ */
+export type OnNoProxiesAvailableHook = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Collection of all hook types
  * All hooks are arrays to allow multiple handlers
@@ -1533,6 +1572,7 @@ export interface RezoHooks {
 	afterProxyDisable: AfterProxyDisableHook[];
 	afterProxyRotate: AfterProxyRotateHook[];
 	afterProxyEnable: AfterProxyEnableHook[];
+	onNoProxiesAvailable: OnNoProxiesAvailableHook[];
 	onSocket: OnSocketHook[];
 	onDns: OnDnsHook[];
 	onTls: OnTlsHook[];
@@ -2815,6 +2855,7 @@ type BeforeProxyDisableHook$1 = (context: BeforeProxyDisableContext) => boolean
 type AfterProxyDisableHook$1 = (context: AfterProxyDisableContext) => void | Promise<void>;
 type AfterProxyRotateHook$1 = (context: AfterProxyRotateContext) => void | Promise<void>;
 type AfterProxyEnableHook$1 = (context: AfterProxyEnableContext) => void | Promise<void>;
+type OnNoProxiesAvailableHook$1 = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Proxy hooks collection for ProxyManager events
  */
@@ -2827,6 +2868,8 @@ export interface ProxyHooks {
 	afterProxyDisable: AfterProxyDisableHook$1[];
 	afterProxyRotate: AfterProxyRotateHook$1[];
 	afterProxyEnable: AfterProxyEnableHook$1[];
+	/** Hook triggered when no proxies are available */
+	onNoProxiesAvailable: OnNoProxiesAvailableHook$1[];
 }
 declare class ProxyManager {
 	/** Configuration for the proxy manager */
@@ -2962,6 +3005,38 @@ declare class ProxyManager {
 	private runAfterProxyRotateHooks;
 	private runAfterProxyDisableHooks;
 	private runAfterProxyEnableHooks;
+	/**
+	 * Run onNoProxiesAvailable hooks synchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	private runOnNoProxiesAvailableHooksSync;
+	/**
+	 * Run onNoProxiesAvailable hooks asynchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	runOnNoProxiesAvailableHooks(context: OnNoProxiesAvailableContext): Promise<void>;
+	/**
+	 * Notify that no proxies are available and trigger hooks
+	 * This method is called when proxy selection fails due to pool exhaustion
+	 *
+	 * @param url - The request URL that needed a proxy
+	 * @param error - The error that will be thrown
+	 * @returns The context object with detailed information about the proxy pool state
+	 *
+	 * @example
+	 * ```typescript
+	 * manager.hooks.onNoProxiesAvailable.push((context) => {
+	 *     console.error(`No proxies available for ${context.url}`);
+	 *     console.log(`Dead: ${context.disabledReasons.dead}, Limit: ${context.disabledReasons.limitReached}`);
+	 *     // Trigger external alert or proxy refresh
+	 *     alertSystem.notify('Proxy pool exhausted', context);
+	 * });
+	 *
+	 * // Called internally or by adapters when no proxies are available
+	 * const context = manager.notifyNoProxiesAvailable('https://api.example.com', new Error('No proxies'));
+	 * ```
+	 */
+	notifyNoProxiesAvailable(url: string, error: Error): OnNoProxiesAvailableContext;
 }
 export type queueOptions = QueueConfig;
 export interface CacheConfig {

package/dist/adapters/index.cjs

@@ -1,6 +1,6 @@
-const _mod_slc4v7 = require('./picker.cjs');
-exports.detectRuntime = _mod_slc4v7.detectRuntime;
-exports.getAdapterCapabilities = _mod_slc4v7.getAdapterCapabilities;
-exports.buildAdapterContext = _mod_slc4v7.buildAdapterContext;
-exports.getAvailableAdapters = _mod_slc4v7.getAvailableAdapters;
-exports.selectAdapter = _mod_slc4v7.selectAdapter;;
+const _mod_1j8os6 = require('./picker.cjs');
+exports.detectRuntime = _mod_1j8os6.detectRuntime;
+exports.getAdapterCapabilities = _mod_1j8os6.getAdapterCapabilities;
+exports.buildAdapterContext = _mod_1j8os6.buildAdapterContext;
+exports.getAvailableAdapters = _mod_1j8os6.getAvailableAdapters;
+exports.selectAdapter = _mod_1j8os6.selectAdapter;;

package/dist/cache/index.cjs

@@ -1,13 +1,13 @@
-const _mod_bs0nd1 = require('./lru-cache.cjs');
-exports.LRUCache = _mod_bs0nd1.LRUCache;;
-const _mod_x43uw8 = require('./dns-cache.cjs');
-exports.DNSCache = _mod_x43uw8.DNSCache;
-exports.getGlobalDNSCache = _mod_x43uw8.getGlobalDNSCache;
-exports.resetGlobalDNSCache = _mod_x43uw8.resetGlobalDNSCache;;
-const _mod_9ecxnj = require('./response-cache.cjs');
-exports.ResponseCache = _mod_9ecxnj.ResponseCache;
-exports.normalizeResponseCacheConfig = _mod_9ecxnj.normalizeResponseCacheConfig;;
-const _mod_o6sd86 = require('./file-cacher.cjs');
-exports.FileCacher = _mod_o6sd86.FileCacher;;
-const _mod_pdmgem = require('./url-store.cjs');
-exports.UrlStore = _mod_pdmgem.UrlStore;;
+const _mod_5re24b = require('./lru-cache.cjs');
+exports.LRUCache = _mod_5re24b.LRUCache;;
+const _mod_nmlyd4 = require('./dns-cache.cjs');
+exports.DNSCache = _mod_nmlyd4.DNSCache;
+exports.getGlobalDNSCache = _mod_nmlyd4.getGlobalDNSCache;
+exports.resetGlobalDNSCache = _mod_nmlyd4.resetGlobalDNSCache;;
+const _mod_n1g00g = require('./response-cache.cjs');
+exports.ResponseCache = _mod_n1g00g.ResponseCache;
+exports.normalizeResponseCacheConfig = _mod_n1g00g.normalizeResponseCacheConfig;;
+const _mod_xmultr = require('./file-cacher.cjs');
+exports.FileCacher = _mod_xmultr.FileCacher;;
+const _mod_81d50n = require('./url-store.cjs');
+exports.UrlStore = _mod_81d50n.UrlStore;;

package/dist/core/hooks.cjs

@@ -19,6 +19,7 @@ function createDefaultHooks() {
     afterProxyDisable: [],
     afterProxyRotate: [],
     afterProxyEnable: [],
+    onNoProxiesAvailable: [],
     onSocket: [],
     onDns: [],
     onTls: [],
@@ -49,6 +50,7 @@ function mergeHooks(base, overrides) {
     afterProxyDisable: [...base.afterProxyDisable, ...overrides.afterProxyDisable || []],
     afterProxyRotate: [...base.afterProxyRotate, ...overrides.afterProxyRotate || []],
     afterProxyEnable: [...base.afterProxyEnable, ...overrides.afterProxyEnable || []],
+    onNoProxiesAvailable: [...base.onNoProxiesAvailable, ...overrides.onNoProxiesAvailable || []],
     onSocket: [...base.onSocket, ...overrides.onSocket || []],
     onDns: [...base.onDns, ...overrides.onDns || []],
     onTls: [...base.onTls, ...overrides.onTls || []],

package/dist/core/hooks.js

@@ -19,6 +19,7 @@ export function createDefaultHooks() {
     afterProxyDisable: [],
     afterProxyRotate: [],
     afterProxyEnable: [],
+    onNoProxiesAvailable: [],
     onSocket: [],
     onDns: [],
     onTls: [],
@@ -49,6 +50,7 @@ export function mergeHooks(base, overrides) {
     afterProxyDisable: [...base.afterProxyDisable, ...overrides.afterProxyDisable || []],
     afterProxyRotate: [...base.afterProxyRotate, ...overrides.afterProxyRotate || []],
     afterProxyEnable: [...base.afterProxyEnable, ...overrides.afterProxyEnable || []],
+    onNoProxiesAvailable: [...base.onNoProxiesAvailable, ...overrides.onNoProxiesAvailable || []],
     onSocket: [...base.onSocket, ...overrides.onSocket || []],
     onDns: [...base.onDns, ...overrides.onDns || []],
     onTls: [...base.onTls, ...overrides.onTls || []],

package/dist/crawler.d.ts

@@ -1414,6 +1414,35 @@ export interface AfterProxyEnableContext {
 	/** Reason for enabling */
 	reason: "cooldown-expired" | "manual";
 }
+/**
+ * Context for onNoProxiesAvailable hook
+ * Triggered when no proxies are available and an error would be thrown
+ */
+export interface OnNoProxiesAvailableContext {
+	/** Request URL that needed a proxy */
+	url: string;
+	/** The error that will be thrown */
+	error: Error;
+	/** All proxies (including disabled ones) */
+	allProxies: ProxyState[];
+	/** Number of active proxies (should be 0) */
+	activeCount: number;
+	/** Number of disabled proxies */
+	disabledCount: number;
+	/** Number of proxies in cooldown */
+	cooldownCount: number;
+	/** Reasons why proxies are unavailable */
+	disabledReasons: {
+		/** Proxies disabled due to failures */
+		dead: number;
+		/** Proxies disabled due to request limit */
+		limitReached: number;
+		/** Proxies manually disabled */
+		manual: number;
+	};
+	/** Timestamp when this event occurred */
+	timestamp: number;
+}
 /**
  * Context provided to beforeRequest hook
  * Contains metadata about the current request state
@@ -1732,6 +1761,16 @@ export type AfterProxyRotateHook = (context: AfterProxyRotateContext) => void |
  * Use for notifications, logging
  */
 export type AfterProxyEnableHook = (context: AfterProxyEnableContext) => void | Promise<void>;
+/**
+ * Hook called when no proxies are available and an error is about to be thrown
+ * Use for alerting, logging exhausted proxy pools, or triggering proxy refresh
+ * This hook is called just before the error is thrown, allowing you to:
+ * - Log the exhaustion event for monitoring
+ * - Trigger external proxy pool refresh
+ * - Send alerts to monitoring systems
+ * - Record statistics about proxy pool health
+ */
+export type OnNoProxiesAvailableHook = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Collection of all hook types
  * All hooks are arrays to allow multiple handlers
@@ -1756,6 +1795,7 @@ export interface RezoHooks {
 	afterProxyDisable: AfterProxyDisableHook[];
 	afterProxyRotate: AfterProxyRotateHook[];
 	afterProxyEnable: AfterProxyEnableHook[];
+	onNoProxiesAvailable: OnNoProxiesAvailableHook[];
 	onSocket: OnSocketHook[];
 	onDns: OnDnsHook[];
 	onTls: OnTlsHook[];
@@ -2933,6 +2973,7 @@ type BeforeProxyDisableHook$1 = (context: BeforeProxyDisableContext) => boolean
 type AfterProxyDisableHook$1 = (context: AfterProxyDisableContext) => void | Promise<void>;
 type AfterProxyRotateHook$1 = (context: AfterProxyRotateContext) => void | Promise<void>;
 type AfterProxyEnableHook$1 = (context: AfterProxyEnableContext) => void | Promise<void>;
+type OnNoProxiesAvailableHook$1 = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Proxy hooks collection for ProxyManager events
  */
@@ -2945,6 +2986,8 @@ export interface ProxyHooks {
 	afterProxyDisable: AfterProxyDisableHook$1[];
 	afterProxyRotate: AfterProxyRotateHook$1[];
 	afterProxyEnable: AfterProxyEnableHook$1[];
+	/** Hook triggered when no proxies are available */
+	onNoProxiesAvailable: OnNoProxiesAvailableHook$1[];
 }
 declare class ProxyManager {
 	/** Configuration for the proxy manager */
@@ -3080,6 +3123,38 @@ declare class ProxyManager {
 	private runAfterProxyRotateHooks;
 	private runAfterProxyDisableHooks;
 	private runAfterProxyEnableHooks;
+	/**
+	 * Run onNoProxiesAvailable hooks synchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	private runOnNoProxiesAvailableHooksSync;
+	/**
+	 * Run onNoProxiesAvailable hooks asynchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	runOnNoProxiesAvailableHooks(context: OnNoProxiesAvailableContext): Promise<void>;
+	/**
+	 * Notify that no proxies are available and trigger hooks
+	 * This method is called when proxy selection fails due to pool exhaustion
+	 *
+	 * @param url - The request URL that needed a proxy
+	 * @param error - The error that will be thrown
+	 * @returns The context object with detailed information about the proxy pool state
+	 *
+	 * @example
+	 * ```typescript
+	 * manager.hooks.onNoProxiesAvailable.push((context) => {
+	 *     console.error(`No proxies available for ${context.url}`);
+	 *     console.log(`Dead: ${context.disabledReasons.dead}, Limit: ${context.disabledReasons.limitReached}`);
+	 *     // Trigger external alert or proxy refresh
+	 *     alertSystem.notify('Proxy pool exhausted', context);
+	 * });
+	 *
+	 * // Called internally or by adapters when no proxies are available
+	 * const context = manager.notifyNoProxiesAvailable('https://api.example.com', new Error('No proxies'));
+	 * ```
+	 */
+	notifyNoProxiesAvailable(url: string, error: Error): OnNoProxiesAvailableContext;
 }
 export type queueOptions = QueueConfig;
 export interface CacheConfig {

package/dist/entries/crawler.cjs

@@ -1,5 +1,5 @@
-const _mod_8o6t31 = require('../plugin/crawler.cjs');
-exports.Crawler = _mod_8o6t31.Crawler;;
-const _mod_a2uxv0 = require('../plugin/crawler-options.cjs');
-exports.CrawlerOptions = _mod_a2uxv0.CrawlerOptions;
-exports.Domain = _mod_a2uxv0.Domain;;
+const _mod_juod8q = require('../plugin/crawler.cjs');
+exports.Crawler = _mod_juod8q.Crawler;;
+const _mod_lugvyb = require('../plugin/crawler-options.cjs');
+exports.CrawlerOptions = _mod_lugvyb.CrawlerOptions;
+exports.Domain = _mod_lugvyb.Domain;;

package/dist/index.cjs

@@ -1,26 +1,26 @@
-const _mod_b7ju2q = require('./core/rezo.cjs');
-exports.Rezo = _mod_b7ju2q.Rezo;
-exports.createRezoInstance = _mod_b7ju2q.createRezoInstance;
-exports.createDefaultInstance = _mod_b7ju2q.createDefaultInstance;;
-const _mod_cnsb78 = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_cnsb78.RezoError;
-exports.RezoErrorCode = _mod_cnsb78.RezoErrorCode;;
-const _mod_skuirr = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_skuirr.RezoHeaders;;
-const _mod_57nl1j = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_57nl1j.RezoFormData;;
-const _mod_ue7zge = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_ue7zge.RezoCookieJar;;
-const _mod_lm33u8 = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_lm33u8.createDefaultHooks;
-exports.mergeHooks = _mod_lm33u8.mergeHooks;;
-const _mod_biuxmx = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_biuxmx.ProxyManager;;
-const _mod_aekrq7 = require('./queue/index.cjs');
-exports.RezoQueue = _mod_aekrq7.RezoQueue;
-exports.HttpQueue = _mod_aekrq7.HttpQueue;
-exports.Priority = _mod_aekrq7.Priority;
-exports.HttpMethodPriority = _mod_aekrq7.HttpMethodPriority;;
+const _mod_8g1zwb = require('./core/rezo.cjs');
+exports.Rezo = _mod_8g1zwb.Rezo;
+exports.createRezoInstance = _mod_8g1zwb.createRezoInstance;
+exports.createDefaultInstance = _mod_8g1zwb.createDefaultInstance;;
+const _mod_brpqyx = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_brpqyx.RezoError;
+exports.RezoErrorCode = _mod_brpqyx.RezoErrorCode;;
+const _mod_nxs9mv = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_nxs9mv.RezoHeaders;;
+const _mod_sp17k6 = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_sp17k6.RezoFormData;;
+const _mod_rt2h0v = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_rt2h0v.RezoCookieJar;;
+const _mod_pg0wwn = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_pg0wwn.createDefaultHooks;
+exports.mergeHooks = _mod_pg0wwn.mergeHooks;;
+const _mod_qipnt4 = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_qipnt4.ProxyManager;;
+const _mod_z8k198 = require('./queue/index.cjs');
+exports.RezoQueue = _mod_z8k198.RezoQueue;
+exports.HttpQueue = _mod_z8k198.HttpQueue;
+exports.Priority = _mod_z8k198.Priority;
+exports.HttpMethodPriority = _mod_z8k198.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;

package/dist/index.d.ts

@@ -1191,6 +1191,35 @@ export interface AfterProxyEnableContext {
 	/** Reason for enabling */
 	reason: "cooldown-expired" | "manual";
 }
+/**
+ * Context for onNoProxiesAvailable hook
+ * Triggered when no proxies are available and an error would be thrown
+ */
+export interface OnNoProxiesAvailableContext {
+	/** Request URL that needed a proxy */
+	url: string;
+	/** The error that will be thrown */
+	error: Error;
+	/** All proxies (including disabled ones) */
+	allProxies: ProxyState[];
+	/** Number of active proxies (should be 0) */
+	activeCount: number;
+	/** Number of disabled proxies */
+	disabledCount: number;
+	/** Number of proxies in cooldown */
+	cooldownCount: number;
+	/** Reasons why proxies are unavailable */
+	disabledReasons: {
+		/** Proxies disabled due to failures */
+		dead: number;
+		/** Proxies disabled due to request limit */
+		limitReached: number;
+		/** Proxies manually disabled */
+		manual: number;
+	};
+	/** Timestamp when this event occurred */
+	timestamp: number;
+}
 /**
  * Context provided to beforeRequest hook
  * Contains metadata about the current request state
@@ -1509,6 +1538,16 @@ export type AfterProxyRotateHook = (context: AfterProxyRotateContext) => void |
  * Use for notifications, logging
  */
 export type AfterProxyEnableHook = (context: AfterProxyEnableContext) => void | Promise<void>;
+/**
+ * Hook called when no proxies are available and an error is about to be thrown
+ * Use for alerting, logging exhausted proxy pools, or triggering proxy refresh
+ * This hook is called just before the error is thrown, allowing you to:
+ * - Log the exhaustion event for monitoring
+ * - Trigger external proxy pool refresh
+ * - Send alerts to monitoring systems
+ * - Record statistics about proxy pool health
+ */
+export type OnNoProxiesAvailableHook = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Collection of all hook types
  * All hooks are arrays to allow multiple handlers
@@ -1533,6 +1572,7 @@ export interface RezoHooks {
 	afterProxyDisable: AfterProxyDisableHook[];
 	afterProxyRotate: AfterProxyRotateHook[];
 	afterProxyEnable: AfterProxyEnableHook[];
+	onNoProxiesAvailable: OnNoProxiesAvailableHook[];
 	onSocket: OnSocketHook[];
 	onDns: OnDnsHook[];
 	onTls: OnTlsHook[];
@@ -2941,6 +2981,7 @@ type BeforeProxyDisableHook$1 = (context: BeforeProxyDisableContext) => boolean
 type AfterProxyDisableHook$1 = (context: AfterProxyDisableContext) => void | Promise<void>;
 type AfterProxyRotateHook$1 = (context: AfterProxyRotateContext) => void | Promise<void>;
 type AfterProxyEnableHook$1 = (context: AfterProxyEnableContext) => void | Promise<void>;
+type OnNoProxiesAvailableHook$1 = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Proxy hooks collection for ProxyManager events
  */
@@ -2953,6 +2994,8 @@ export interface ProxyHooks {
 	afterProxyDisable: AfterProxyDisableHook$1[];
 	afterProxyRotate: AfterProxyRotateHook$1[];
 	afterProxyEnable: AfterProxyEnableHook$1[];
+	/** Hook triggered when no proxies are available */
+	onNoProxiesAvailable: OnNoProxiesAvailableHook$1[];
 }
 /**
  * ProxyManager - Advanced proxy rotation and pool management
@@ -3107,6 +3150,38 @@ export declare class ProxyManager {
 	private runAfterProxyRotateHooks;
 	private runAfterProxyDisableHooks;
 	private runAfterProxyEnableHooks;
+	/**
+	 * Run onNoProxiesAvailable hooks synchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	private runOnNoProxiesAvailableHooksSync;
+	/**
+	 * Run onNoProxiesAvailable hooks asynchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	runOnNoProxiesAvailableHooks(context: OnNoProxiesAvailableContext): Promise<void>;
+	/**
+	 * Notify that no proxies are available and trigger hooks
+	 * This method is called when proxy selection fails due to pool exhaustion
+	 *
+	 * @param url - The request URL that needed a proxy
+	 * @param error - The error that will be thrown
+	 * @returns The context object with detailed information about the proxy pool state
+	 *
+	 * @example
+	 * ```typescript
+	 * manager.hooks.onNoProxiesAvailable.push((context) => {
+	 *     console.error(`No proxies available for ${context.url}`);
+	 *     console.log(`Dead: ${context.disabledReasons.dead}, Limit: ${context.disabledReasons.limitReached}`);
+	 *     // Trigger external alert or proxy refresh
+	 *     alertSystem.notify('Proxy pool exhausted', context);
+	 * });
+	 *
+	 * // Called internally or by adapters when no proxies are available
+	 * const context = manager.notifyNoProxiesAvailable('https://api.example.com', new Error('No proxies'));
+	 * ```
+	 */
+	notifyNoProxiesAvailable(url: string, error: Error): OnNoProxiesAvailableContext;
 }
 export type queueOptions = QueueConfig;
 export interface CacheConfig {

package/dist/platform/browser.d.ts

@@ -1191,6 +1191,35 @@ export interface AfterProxyEnableContext {
 	/** Reason for enabling */
 	reason: "cooldown-expired" | "manual";
 }
+/**
+ * Context for onNoProxiesAvailable hook
+ * Triggered when no proxies are available and an error would be thrown
+ */
+export interface OnNoProxiesAvailableContext {
+	/** Request URL that needed a proxy */
+	url: string;
+	/** The error that will be thrown */
+	error: Error;
+	/** All proxies (including disabled ones) */
+	allProxies: ProxyState[];
+	/** Number of active proxies (should be 0) */
+	activeCount: number;
+	/** Number of disabled proxies */
+	disabledCount: number;
+	/** Number of proxies in cooldown */
+	cooldownCount: number;
+	/** Reasons why proxies are unavailable */
+	disabledReasons: {
+		/** Proxies disabled due to failures */
+		dead: number;
+		/** Proxies disabled due to request limit */
+		limitReached: number;
+		/** Proxies manually disabled */
+		manual: number;
+	};
+	/** Timestamp when this event occurred */
+	timestamp: number;
+}
 /**
  * Context provided to beforeRequest hook
  * Contains metadata about the current request state
@@ -1509,6 +1538,16 @@ export type AfterProxyRotateHook = (context: AfterProxyRotateContext) => void |
  * Use for notifications, logging
  */
 export type AfterProxyEnableHook = (context: AfterProxyEnableContext) => void | Promise<void>;
+/**
+ * Hook called when no proxies are available and an error is about to be thrown
+ * Use for alerting, logging exhausted proxy pools, or triggering proxy refresh
+ * This hook is called just before the error is thrown, allowing you to:
+ * - Log the exhaustion event for monitoring
+ * - Trigger external proxy pool refresh
+ * - Send alerts to monitoring systems
+ * - Record statistics about proxy pool health
+ */
+export type OnNoProxiesAvailableHook = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Collection of all hook types
  * All hooks are arrays to allow multiple handlers
@@ -1533,6 +1572,7 @@ export interface RezoHooks {
 	afterProxyDisable: AfterProxyDisableHook[];
 	afterProxyRotate: AfterProxyRotateHook[];
 	afterProxyEnable: AfterProxyEnableHook[];
+	onNoProxiesAvailable: OnNoProxiesAvailableHook[];
 	onSocket: OnSocketHook[];
 	onDns: OnDnsHook[];
 	onTls: OnTlsHook[];
@@ -2815,6 +2855,7 @@ type BeforeProxyDisableHook$1 = (context: BeforeProxyDisableContext) => boolean
 type AfterProxyDisableHook$1 = (context: AfterProxyDisableContext) => void | Promise<void>;
 type AfterProxyRotateHook$1 = (context: AfterProxyRotateContext) => void | Promise<void>;
 type AfterProxyEnableHook$1 = (context: AfterProxyEnableContext) => void | Promise<void>;
+type OnNoProxiesAvailableHook$1 = (context: OnNoProxiesAvailableContext) => void | Promise<void>;
 /**
  * Proxy hooks collection for ProxyManager events
  */
@@ -2827,6 +2868,8 @@ export interface ProxyHooks {
 	afterProxyDisable: AfterProxyDisableHook$1[];
 	afterProxyRotate: AfterProxyRotateHook$1[];
 	afterProxyEnable: AfterProxyEnableHook$1[];
+	/** Hook triggered when no proxies are available */
+	onNoProxiesAvailable: OnNoProxiesAvailableHook$1[];
 }
 declare class ProxyManager {
 	/** Configuration for the proxy manager */
@@ -2962,6 +3005,38 @@ declare class ProxyManager {
 	private runAfterProxyRotateHooks;
 	private runAfterProxyDisableHooks;
 	private runAfterProxyEnableHooks;
+	/**
+	 * Run onNoProxiesAvailable hooks synchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	private runOnNoProxiesAvailableHooksSync;
+	/**
+	 * Run onNoProxiesAvailable hooks asynchronously
+	 * Called when no proxies are available and an error is about to be thrown
+	 */
+	runOnNoProxiesAvailableHooks(context: OnNoProxiesAvailableContext): Promise<void>;
+	/**
+	 * Notify that no proxies are available and trigger hooks
+	 * This method is called when proxy selection fails due to pool exhaustion
+	 *
+	 * @param url - The request URL that needed a proxy
+	 * @param error - The error that will be thrown
+	 * @returns The context object with detailed information about the proxy pool state
+	 *
+	 * @example
+	 * ```typescript
+	 * manager.hooks.onNoProxiesAvailable.push((context) => {
+	 *     console.error(`No proxies available for ${context.url}`);
+	 *     console.log(`Dead: ${context.disabledReasons.dead}, Limit: ${context.disabledReasons.limitReached}`);
+	 *     // Trigger external alert or proxy refresh
+	 *     alertSystem.notify('Proxy pool exhausted', context);
+	 * });
+	 *
+	 * // Called internally or by adapters when no proxies are available
+	 * const context = manager.notifyNoProxiesAvailable('https://api.example.com', new Error('No proxies'));
+	 * ```
+	 */
+	notifyNoProxiesAvailable(url: string, error: Error): OnNoProxiesAvailableContext;
 }
 export type queueOptions = QueueConfig;
 export interface CacheConfig {