rezo 1.0.6 → 1.0.8

package/dist/adapters/entries/curl.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
 const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../../utils/headers.cjs');
 const { RezoFormData } = require('../../utils/form-data.cjs');
-const { RezoCookieJar } = require('../../utils/cookies.cjs');
+const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
 const packageJson = require("../../../package.json");
 
@@ -13,6 +13,7 @@ exports.RezoErrorCode = RezoErrorCode;
 exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
+exports.Cookie = Cookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

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

@@ -156,7 +156,7 @@ export interface SerializedCookie {
 	lastAccessed?: string;
 	[key: string]: unknown;
 }
-declare class Cookie extends TouchCookie {
+export declare class Cookie extends TouchCookie {
 	constructor(options?: CreateCookieOptions);
 	/**
 	 * Fixes date fields that may have become strings during JSON deserialization.
@@ -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/entries/curl.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
 import { RezoHeaders } from '../../utils/headers.js';
 import { RezoFormData } from '../../utils/form-data.js';
-import { RezoCookieJar } from '../../utils/cookies.js';
+import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
 import packageJson from "../../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar };
+export { RezoCookieJar, Cookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/adapters/entries/fetch.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
 const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../../utils/headers.cjs');
 const { RezoFormData } = require('../../utils/form-data.cjs');
-const { RezoCookieJar } = require('../../utils/cookies.cjs');
+const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
 const packageJson = require("../../../package.json");
 
@@ -13,6 +13,7 @@ exports.RezoErrorCode = RezoErrorCode;
 exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
+exports.Cookie = Cookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

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

@@ -156,7 +156,7 @@ export interface SerializedCookie {
 	lastAccessed?: string;
 	[key: string]: unknown;
 }
-declare class Cookie extends TouchCookie {
+export declare class Cookie extends TouchCookie {
 	constructor(options?: CreateCookieOptions);
 	/**
 	 * Fixes date fields that may have become strings during JSON deserialization.
@@ -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/entries/fetch.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
 import { RezoHeaders } from '../../utils/headers.js';
 import { RezoFormData } from '../../utils/form-data.js';
-import { RezoCookieJar } from '../../utils/cookies.js';
+import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
 import packageJson from "../../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar };
+export { RezoCookieJar, Cookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/adapters/entries/http.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
 const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../../utils/headers.cjs');
 const { RezoFormData } = require('../../utils/form-data.cjs');
-const { RezoCookieJar } = require('../../utils/cookies.cjs');
+const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
 const packageJson = require("../../../package.json");
 
@@ -13,6 +13,7 @@ exports.RezoErrorCode = RezoErrorCode;
 exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
+exports.Cookie = Cookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

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

@@ -156,7 +156,7 @@ export interface SerializedCookie {
 	lastAccessed?: string;
 	[key: string]: unknown;
 }
-declare class Cookie extends TouchCookie {
+export declare class Cookie extends TouchCookie {
 	constructor(options?: CreateCookieOptions);
 	/**
 	 * Fixes date fields that may have become strings during JSON deserialization.
@@ -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/entries/http.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
 import { RezoHeaders } from '../../utils/headers.js';
 import { RezoFormData } from '../../utils/form-data.js';
-import { RezoCookieJar } from '../../utils/cookies.js';
+import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
 import packageJson from "../../../package.json" with { type: 'json' };
 
@@ -13,6 +13,7 @@ export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
 export { RezoCookieJar };
+export { Cookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/adapters/entries/http2.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
 const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../../utils/headers.cjs');
 const { RezoFormData } = require('../../utils/form-data.cjs');
-const { RezoCookieJar } = require('../../utils/cookies.cjs');
+const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
 const packageJson = require("../../../package.json");
 
@@ -13,6 +13,7 @@ exports.RezoErrorCode = RezoErrorCode;
 exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
+exports.Cookie = Cookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;

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

@@ -156,7 +156,7 @@ export interface SerializedCookie {
 	lastAccessed?: string;
 	[key: string]: unknown;
 }
-declare class Cookie extends TouchCookie {
+export declare class Cookie extends TouchCookie {
 	constructor(options?: CreateCookieOptions);
 	/**
 	 * Fixes date fields that may have become strings during JSON deserialization.
@@ -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/entries/http2.js

@@ -3,7 +3,7 @@ import { setGlobalAdapter, createRezoInstance, Rezo } from '../../core/rezo.js';
 import { RezoError, RezoErrorCode } from '../../errors/rezo-error.js';
 import { RezoHeaders } from '../../utils/headers.js';
 import { RezoFormData } from '../../utils/form-data.js';
-import { RezoCookieJar } from '../../utils/cookies.js';
+import { RezoCookieJar, Cookie } from '../../utils/cookies.js';
 import { createDefaultHooks, mergeHooks } from '../../core/hooks.js';
 import packageJson from "../../../package.json" with { type: 'json' };
 
@@ -12,7 +12,7 @@ export { RezoError };
 export { RezoErrorCode };
 export { RezoHeaders };
 export { RezoFormData };
-export { RezoCookieJar };
+export { RezoCookieJar, Cookie };
 export { createDefaultHooks };
 export { mergeHooks };
 export const isRezoError = RezoError.isRezoError;

package/dist/adapters/entries/react-native.cjs

@@ -3,7 +3,7 @@ const { setGlobalAdapter, createRezoInstance, Rezo } = require('../../core/rezo.
 const { RezoError, RezoErrorCode } = require('../../errors/rezo-error.cjs');
 const { RezoHeaders } = require('../../utils/headers.cjs');
 const { RezoFormData } = require('../../utils/form-data.cjs');
-const { RezoCookieJar } = require('../../utils/cookies.cjs');
+const { RezoCookieJar, Cookie } = require('../../utils/cookies.cjs');
 const { createDefaultHooks, mergeHooks } = require('../../core/hooks.cjs');
 const packageJson = require("../../../package.json");
 
@@ -13,6 +13,7 @@ exports.RezoErrorCode = RezoErrorCode;
 exports.RezoHeaders = RezoHeaders;
 exports.RezoFormData = RezoFormData;
 exports.RezoCookieJar = RezoCookieJar;
+exports.Cookie = Cookie;
 exports.createDefaultHooks = createDefaultHooks;
 exports.mergeHooks = mergeHooks;
 const isRezoError = exports.isRezoError = RezoError.isRezoError;