rezo 1.0.72 → 1.0.74

package/dist/crawler.d.ts

@@ -11,8 +11,9 @@ import { Cookie as TouchCookie, CookieJar as TouchCookieJar, CreateCookieOptions
  * Optimized specifically for crawler workloads with:
  * - WAL mode for high-throughput concurrent reads/writes
  * - Batch operations for efficient bulk storage
- * - Domain-based namespacing for organized cache management
+ * - Domain-based namespacing via column (single database)
  * - Optional zstd compression for storage efficiency
+ * - LRU eviction to prevent unbounded growth
  *
  * @module cache/file-cacher
  * @author Rezo HTTP Client Library
@@ -22,10 +23,15 @@ import { Cookie as TouchCookie, CookieJar as TouchCookieJar, CreateCookieOptions
  */
 export interface FileCacherOptions {
 	/**
-	 * Directory path for storing cache databases
+	 * Directory path for storing the cache database
 	 * @default '/tmp/rezo-crawler/cache'
 	 */
 	cacheDir?: string;
+	/**
+	 * Database filename
+	 * @default 'cache.db'
+	 */
+	dbFileName?: string;
 	/**
 	 * Default time-to-live in milliseconds
 	 * @default 604800000 (7 days)
@@ -38,30 +44,33 @@ export interface FileCacherOptions {
 	 */
 	compression?: boolean;
 	/**
-	 * Hash namespace names for privacy
-	 * @default false
-	 */
-	encryptNamespace?: boolean;
-	/**
-	 * Maximum entries per namespace (0 = unlimited)
-	 * @default 0
+	 * Maximum total entries (0 = unlimited, recommended: 100000)
+	 * Uses LRU eviction when limit is reached
+	 * @default 100000
 	 */
 	maxEntries?: number;
 }
 declare class FileCacher {
-	private databases;
+	private db;
 	private readonly options;
 	private readonly cacheDir;
+	private readonly dbPath;
 	private closed;
+	private initPromise;
+	private evictionInProgress;
 	private constructor();
 	/**
 	 * Create a new FileCacher instance
 	 */
 	static create(options?: FileCacherOptions): Promise<FileCacher>;
 	/**
-	 * Get or create optimized database for a namespace (domain)
+	 * Initialize the single database with optimized settings
 	 */
-	private getDatabase;
+	private initialize;
+	/**
+	 * Ensure database is initialized
+	 */
+	private ensureDb;
 	/**
 	 * Store a response in the cache
 	 */
@@ -74,6 +83,11 @@ declare class FileCacher {
 		value: T;
 		ttl?: number;
 	}>, namespace?: string): Promise<void>;
+	/**
+	 * LRU eviction - removes oldest entries when limit exceeded
+	 * Runs asynchronously to not block writes
+	 */
+	private maybeEvict;
 	/**
 	 * Retrieve a cached response
 	 */
@@ -95,22 +109,24 @@ declare class FileCacher {
 	 */
 	clear(namespace?: string): Promise<void>;
 	/**
-	 * Remove all expired entries
+	 * Remove all expired entries across all namespaces
 	 */
-	cleanup(namespace?: string): Promise<number>;
+	cleanup(): Promise<number>;
 	/**
-	 * Get cache statistics for a namespace
+	 * Get cache statistics
 	 */
 	stats(namespace?: string): Promise<{
 		count: number;
 		expired: number;
+		namespaces: number;
 	}>;
 	/**
-	 * Close all database connections
+	 * Close the database connection
 	 */
 	close(): Promise<void>;
 	get isClosed(): boolean;
 	get directory(): string;
+	get databasePath(): string;
 }
 export interface CrawlSession {
 	sessionId: string;
@@ -2063,6 +2079,13 @@ export interface QueueConfig {
 	intervalCap?: number;
 	/** Carry over unused interval capacity to next interval */
 	carryoverConcurrencyCount?: boolean;
+	/**
+	 * Reject the task promise when an error occurs (default: false)
+	 * When false, errors are swallowed and task.resolve(undefined) is called.
+	 * This prevents unhandled promise rejections but makes error handling harder.
+	 * When true, task.reject(error) is called, allowing proper try/catch handling.
+	 */
+	rejectOnError?: boolean;
 }
 /**
  * Task options when adding to queue
@@ -2268,8 +2291,12 @@ declare class RezoQueue<T = any> {
 	/**
 	 * Wait for queue size to be less than limit
 	 * @param limit - Size threshold
+	 * @param timeoutMs - Optional timeout in milliseconds (default: 0 = no timeout)
+	 *                    If timeout occurs, promise resolves (not rejects) to prevent blocking
 	 */
-	onSizeLessThan(limit: number): Promise<void>;
+	onSizeLessThan(limit: number, timeoutMs?: number): Promise<void>;
+	/** Maximum recommended handlers per event before warning */
+	private static readonly MAX_HANDLERS_WARNING;
 	/**
 	 * Register an event handler
 	 * @param event - Event name
@@ -6477,6 +6504,12 @@ export interface ICrawlerOptions {
 	} | {
 		enable: false;
 	} | undefined | false;
+	/** Enable graceful shutdown handlers for SIGINT/SIGTERM - saves session state (default: false) */
+	enableSignalHandlers?: boolean;
+	/** Maximum concurrent requests for crawler (default: 100) */
+	concurrency?: number;
+	/** Maximum concurrent requests for scraper - separate queue (default: same as concurrency) */
+	scraperConcurrency?: number;
 	/** Maximum crawl depth from start URL (0 = unlimited, default: 0) */
 	maxDepth?: number;
 	/** Maximum total URLs to crawl (0 = unlimited, default: 0) */
@@ -6575,6 +6608,12 @@ export declare class CrawlerOptions {
 	throwFatalError?: boolean;
 	/** Enable debug logging */
 	debug?: boolean;
+	/** Enable graceful shutdown handlers for SIGINT/SIGTERM - saves session state */
+	enableSignalHandlers: boolean;
+	/** Maximum concurrent requests for crawler (default: 100) */
+	concurrency: number;
+	/** Maximum concurrent requests for scraper (default: same as concurrency) */
+	scraperConcurrency: number;
 	/** Maximum crawl depth from start URL (0 = unlimited) */
 	maxDepth: number;
 	/** Maximum total URLs to crawl (0 = unlimited) */
@@ -6991,6 +7030,32 @@ export interface EmailDiscoveryEvent<T = Record<string, any>> {
 	timestamp: Date;
 	metadata: T;
 }
+export interface HealthSnapshot {
+	/** Timestamp of snapshot */
+	timestamp: number;
+	/** Requests per second (rolling average) */
+	requestsPerSecond: number;
+	/** Success rate percentage (0-100) */
+	successRate: number;
+	/** Failure rate percentage (0-100) */
+	failureRate: number;
+	/** Average response time in ms */
+	avgResponseTime: number;
+	/** 95th percentile response time in ms */
+	p95ResponseTime: number;
+	/** Current queue depth */
+	queueDepth: number;
+	/** Active concurrent requests */
+	activeRequests: number;
+	/** Total requests processed */
+	totalRequests: number;
+	/** Total successful requests */
+	totalSuccesses: number;
+	/** Total failed requests */
+	totalFailures: number;
+	/** Uptime in milliseconds */
+	uptimeMs: number;
+}
 interface RedirectEvent$1 {
 	originalUrl: string;
 	finalUrl: string;
@@ -7070,6 +7135,7 @@ export declare class Crawler {
 	 */
 	cacher: FileCacher;
 	private queue;
+	private scraperQueue;
 	private readonly isCacheEnabled;
 	readonly config: CrawlerOptions;
 	private urlStorage;
@@ -7085,15 +7151,10 @@ export declare class Crawler {
 	/** Adapter-specific request executor */
 	private adapterExecutor;
 	private adapterType;
-	/** Track pending execute() calls for proper done() behavior */
-	private pendingExecutions;
-	/**
-	 * Track pending visits that haven't yet added to the queue.
-	 * This prevents waitForAll() from exiting when execute() is still in its async preamble.
-	 */
-	private pendingVisitCount;
 	/** Track if the crawler has been destroyed */
 	private isDestroyed;
+	/** Track if graceful shutdown has been requested */
+	private shutdownRequested;
 	/** Original queue options for restoration */
 	private readonly queueOptions;
 	/** robots.txt parser and validator */
@@ -7105,14 +7166,30 @@ export declare class Crawler {
 	private crawlStats;
 	/** URL depth tracking for maxDepth limit */
 	private urlDepthMap;
+	/** Periodic cleanup interval for memory management */
+	private cleanupInterval?;
+	/** Auto-checkpoint interval for session persistence */
+	private checkpointInterval?;
+	/** Last checkpoint timestamp */
+	private lastCheckpointTime;
+	/** Memory monitor for auto-throttling */
+	private memoryMonitor;
+	/** Health metrics for monitoring */
+	private healthMetrics;
+	/** Original concurrency for restoration after memory pressure */
+	private originalConcurrency;
+	/** Shutdown handler reference for cleanup */
+	private shutdownHandler;
 	/** Lifecycle event handlers */
 	private startHandlers;
 	private finishHandlers;
 	private redirectHandlers;
-	/** Data collection for export */
+	/** Data collection for export - bounded to prevent memory issues */
 	private collectedData;
 	/** Flag to track if crawl has started */
 	private crawlStarted;
+	/** Promise lock for triggerStartHandlers to prevent race condition */
+	private startHandlersPromise;
 	/**
 	 * Creates a new Crawler instance with the specified configuration.
 	 *
@@ -7144,6 +7221,18 @@ export declare class Crawler {
 	 * ```
 	 */
 	constructor(crawlerOptions: ICrawlerOptions, http?: Rezo);
+	/**
+	 * Register process signal handlers for graceful shutdown
+	 */
+	private registerShutdownHandlers;
+	/**
+	 * Remove process signal handlers
+	 */
+	private removeShutdownHandlers;
+	/**
+	 * Graceful shutdown - finish current tasks and save state
+	 */
+	gracefulShutdown(): Promise<void>;
 	/**
 	 * Initialize the HTTP adapter based on configuration
 	 */
@@ -7212,8 +7301,30 @@ export declare class Crawler {
 	 */
 	setAdapter(adapter: CrawlerAdapterType): Promise<void>;
 	private rawResponseHandler;
+	/**
+	 * Wait for cache to be ready with timeout (non-recursive)
+	 * @param timeoutMs - Maximum time to wait in milliseconds (default: 30s)
+	 */
 	private waitForCache;
+	/**
+	 * Wait for storage to be ready with timeout (non-recursive)
+	 * @param timeoutMs - Maximum time to wait in milliseconds (default: 30s)
+	 */
 	private waitForStorage;
+	/**
+	 * Start periodic cleanup to prevent unbounded memory growth
+	 * Trims urlDepthMap and domainResponseTimes to reasonable sizes
+	 * Also monitors memory and auto-throttles if needed
+	 */
+	private startPeriodicCleanup;
+	/**
+	 * Start auto-checkpointing to save session progress every 5 minutes
+	 */
+	private startAutoCheckpoint;
+	/**
+	 * Save current crawl progress to navigation history
+	 */
+	saveCheckpoint(): Promise<void>;
 	private saveUrl;
 	private hasUrlInCache;
 	private saveCache;
@@ -7621,8 +7732,24 @@ export declare class Crawler {
 	 * Get current crawl statistics
 	 */
 	getStats(): CrawlStats;
+	/**
+	 * Get health metrics snapshot for monitoring
+	 */
+	getHealthSnapshot(): HealthSnapshot;
+	/**
+	 * Check if crawler is healthy based on thresholds
+	 */
+	isHealthy(options?: {
+		minSuccessRate?: number;
+		maxAvgResponseTime?: number;
+	}): boolean;
+	/**
+	 * Get Prometheus-formatted metrics for monitoring systems
+	 */
+	getPrometheusMetrics(prefix?: string): string;
 	/**
 	 * Trigger onStart handlers (called once on first visit)
+	 * Uses promise lock to prevent race condition with concurrent visits
 	 */
 	private triggerStartHandlers;
 	/**

package/dist/entries/crawler.cjs

@@ -1,4 +1,4 @@
-const _mod_gw9950 = require('../crawler/crawler.cjs');
-exports.Crawler = _mod_gw9950.Crawler;;
-const _mod_zlq90d = require('../crawler/crawler-options.cjs');
-exports.CrawlerOptions = _mod_zlq90d.CrawlerOptions;;
+const _mod_yduaec = require('../crawler/crawler.cjs');
+exports.Crawler = _mod_yduaec.Crawler;;
+const _mod_58t9fo = require('../crawler/crawler-options.cjs');
+exports.CrawlerOptions = _mod_58t9fo.CrawlerOptions;;

package/dist/errors/rezo-error.cjs

@@ -553,9 +553,9 @@ function cleanStackTrace(stack) {
 class RezoError extends Error {
   constructor(message, config, code, request, response) {
     super();
-    Object.defineProperty(this, "config", { value: config, enumerable: false });
-    Object.defineProperty(this, "request", { value: request, enumerable: false });
-    Object.defineProperty(this, "response", { value: response, enumerable: false });
+    Object.defineProperty(this, "config", { value: config, enumerable: !!config });
+    Object.defineProperty(this, "request", { value: request, enumerable: !!request });
+    Object.defineProperty(this, "response", { value: response, enumerable: !!response });
     Object.defineProperty(this, "isRezoError", { value: true, enumerable: false });
     if (code) {
       Object.defineProperty(this, "code", { value: code, enumerable: true });
@@ -600,75 +600,6 @@ class RezoError extends Error {
       }
     }
   }
-  [Symbol.for("nodejs.util.inspect.custom")](_depth, options) {
-    const parts = [];
-    const isDebug = this.config?.debug === true;
-    const inspect = options?.stylize ? (v) => require("util").inspect(v, { depth: 3, colors: true }) : JSON.stringify;
-    parts.push(`${this.name}: ${this.message}`);
-    if (this.code)
-      parts.push(`  code: '${this.code}'`);
-    if (this.method)
-      parts.push(`  method: '${this.method}'`);
-    if (this.url)
-      parts.push(`  url: '${this.url}'`);
-    if (this.finalUrl && this.finalUrl !== this.url) {
-      parts.push(`  finalUrl: '${this.finalUrl}'`);
-    }
-    if (this.status)
-      parts.push(`  status: ${this.status}`);
-    if (this.statusText)
-      parts.push(`  statusText: '${this.statusText}'`);
-    if (this.urls && this.urls.length > 1) {
-      parts.push(`  urls: [${this.urls.map((u) => `'${u}'`).join(", ")}]`);
-    }
-    if (this.suggestion)
-      parts.push(`  suggestion: ${this.suggestion}`);
-    if (isDebug) {
-      parts.push("");
-      parts.push("  --- Debug Info ---");
-      if (this.cause) {
-        const causeMsg = typeof this.cause === "string" ? this.cause : this.cause?.message || String(this.cause);
-        parts.push(`  cause: ${causeMsg}`);
-      }
-      if (this.errno)
-        parts.push(`  errno: ${this.errno}`);
-      if (this.hostname)
-        parts.push(`  hostname: '${this.hostname}'`);
-      if (this.port)
-        parts.push(`  port: ${this.port}`);
-      if (this.address)
-        parts.push(`  address: '${this.address}'`);
-      if (this.syscall)
-        parts.push(`  syscall: '${this.syscall}'`);
-      if (this.response) {
-        parts.push("");
-        parts.push("  --- Response ---");
-        parts.push(`  response.status: ${this.response.status}`);
-        parts.push(`  response.statusText: '${this.response.statusText || ""}'`);
-        parts.push(`  response.finalUrl: '${this.response.finalUrl || ""}'`);
-        if (this.response.headers) {
-          parts.push(`  response.headers: ${inspect(this.response.headers)}`);
-        }
-        if (this.response.data !== undefined) {
-          const dataStr = typeof this.response.data === "string" ? this.response.data.substring(0, 500) + (this.response.data.length > 500 ? "..." : "") : inspect(this.response.data);
-          parts.push(`  response.data: ${dataStr}`);
-        }
-      }
-      if (this.response?.config) {
-        parts.push("");
-        parts.push("  --- Request Config ---");
-        const { cookieJar, ...configWithoutJar } = this.response.config;
-        parts.push(`  config: ${inspect(configWithoutJar)}`);
-      }
-      if (this.stack) {
-        parts.push("");
-        parts.push("  --- Stack Trace ---");
-        parts.push(this.stack);
-      }
-    }
-    return parts.join(`
-`);
-  }
   static isRezoError(error) {
     return error instanceof RezoError || error !== null && typeof error === "object" && error.isRezoError === true;
   }

package/dist/errors/rezo-error.js

@@ -553,9 +553,9 @@ function cleanStackTrace(stack) {
 export class RezoError extends Error {
   constructor(message, config, code, request, response) {
     super();
-    Object.defineProperty(this, "config", { value: config, enumerable: false });
-    Object.defineProperty(this, "request", { value: request, enumerable: false });
-    Object.defineProperty(this, "response", { value: response, enumerable: false });
+    Object.defineProperty(this, "config", { value: config, enumerable: !!config });
+    Object.defineProperty(this, "request", { value: request, enumerable: !!request });
+    Object.defineProperty(this, "response", { value: response, enumerable: !!response });
     Object.defineProperty(this, "isRezoError", { value: true, enumerable: false });
     if (code) {
       Object.defineProperty(this, "code", { value: code, enumerable: true });
@@ -600,75 +600,6 @@ export class RezoError extends Error {
       }
     }
   }
-  [Symbol.for("nodejs.util.inspect.custom")](_depth, options) {
-    const parts = [];
-    const isDebug = this.config?.debug === true;
-    const inspect = options?.stylize ? (v) => require("util").inspect(v, { depth: 3, colors: true }) : JSON.stringify;
-    parts.push(`${this.name}: ${this.message}`);
-    if (this.code)
-      parts.push(`  code: '${this.code}'`);
-    if (this.method)
-      parts.push(`  method: '${this.method}'`);
-    if (this.url)
-      parts.push(`  url: '${this.url}'`);
-    if (this.finalUrl && this.finalUrl !== this.url) {
-      parts.push(`  finalUrl: '${this.finalUrl}'`);
-    }
-    if (this.status)
-      parts.push(`  status: ${this.status}`);
-    if (this.statusText)
-      parts.push(`  statusText: '${this.statusText}'`);
-    if (this.urls && this.urls.length > 1) {
-      parts.push(`  urls: [${this.urls.map((u) => `'${u}'`).join(", ")}]`);
-    }
-    if (this.suggestion)
-      parts.push(`  suggestion: ${this.suggestion}`);
-    if (isDebug) {
-      parts.push("");
-      parts.push("  --- Debug Info ---");
-      if (this.cause) {
-        const causeMsg = typeof this.cause === "string" ? this.cause : this.cause?.message || String(this.cause);
-        parts.push(`  cause: ${causeMsg}`);
-      }
-      if (this.errno)
-        parts.push(`  errno: ${this.errno}`);
-      if (this.hostname)
-        parts.push(`  hostname: '${this.hostname}'`);
-      if (this.port)
-        parts.push(`  port: ${this.port}`);
-      if (this.address)
-        parts.push(`  address: '${this.address}'`);
-      if (this.syscall)
-        parts.push(`  syscall: '${this.syscall}'`);
-      if (this.response) {
-        parts.push("");
-        parts.push("  --- Response ---");
-        parts.push(`  response.status: ${this.response.status}`);
-        parts.push(`  response.statusText: '${this.response.statusText || ""}'`);
-        parts.push(`  response.finalUrl: '${this.response.finalUrl || ""}'`);
-        if (this.response.headers) {
-          parts.push(`  response.headers: ${inspect(this.response.headers)}`);
-        }
-        if (this.response.data !== undefined) {
-          const dataStr = typeof this.response.data === "string" ? this.response.data.substring(0, 500) + (this.response.data.length > 500 ? "..." : "") : inspect(this.response.data);
-          parts.push(`  response.data: ${dataStr}`);
-        }
-      }
-      if (this.response?.config) {
-        parts.push("");
-        parts.push("  --- Request Config ---");
-        const { cookieJar, ...configWithoutJar } = this.response.config;
-        parts.push(`  config: ${inspect(configWithoutJar)}`);
-      }
-      if (this.stack) {
-        parts.push("");
-        parts.push("  --- Stack Trace ---");
-        parts.push(this.stack);
-      }
-    }
-    return parts.join(`
-`);
-  }
   static isRezoError(error) {
     return error instanceof RezoError || error !== null && typeof error === "object" && error.isRezoError === true;
   }

package/dist/index.cjs

@@ -1,30 +1,30 @@
-const _mod_89zcr3 = require('./core/rezo.cjs');
-exports.Rezo = _mod_89zcr3.Rezo;
-exports.createRezoInstance = _mod_89zcr3.createRezoInstance;
-exports.createDefaultInstance = _mod_89zcr3.createDefaultInstance;;
-const _mod_flff0b = require('./errors/rezo-error.cjs');
-exports.RezoError = _mod_flff0b.RezoError;
-exports.RezoErrorCode = _mod_flff0b.RezoErrorCode;;
-const _mod_etg4qe = require('./utils/headers.cjs');
-exports.RezoHeaders = _mod_etg4qe.RezoHeaders;;
-const _mod_588bw4 = require('./utils/form-data.cjs');
-exports.RezoFormData = _mod_588bw4.RezoFormData;;
-const _mod_ln3xsz = require('./utils/cookies.cjs');
-exports.RezoCookieJar = _mod_ln3xsz.RezoCookieJar;
-exports.Cookie = _mod_ln3xsz.Cookie;;
-const _mod_7uw8z4 = require('./utils/curl.cjs');
-exports.toCurl = _mod_7uw8z4.toCurl;
-exports.fromCurl = _mod_7uw8z4.fromCurl;;
-const _mod_bk97w3 = require('./core/hooks.cjs');
-exports.createDefaultHooks = _mod_bk97w3.createDefaultHooks;
-exports.mergeHooks = _mod_bk97w3.mergeHooks;;
-const _mod_be60uf = require('./proxy/manager.cjs');
-exports.ProxyManager = _mod_be60uf.ProxyManager;;
-const _mod_6suru4 = require('./queue/index.cjs');
-exports.RezoQueue = _mod_6suru4.RezoQueue;
-exports.HttpQueue = _mod_6suru4.HttpQueue;
-exports.Priority = _mod_6suru4.Priority;
-exports.HttpMethodPriority = _mod_6suru4.HttpMethodPriority;;
+const _mod_f5e2x4 = require('./core/rezo.cjs');
+exports.Rezo = _mod_f5e2x4.Rezo;
+exports.createRezoInstance = _mod_f5e2x4.createRezoInstance;
+exports.createDefaultInstance = _mod_f5e2x4.createDefaultInstance;;
+const _mod_l2n0t8 = require('./errors/rezo-error.cjs');
+exports.RezoError = _mod_l2n0t8.RezoError;
+exports.RezoErrorCode = _mod_l2n0t8.RezoErrorCode;;
+const _mod_pgi4on = require('./utils/headers.cjs');
+exports.RezoHeaders = _mod_pgi4on.RezoHeaders;;
+const _mod_k82fb8 = require('./utils/form-data.cjs');
+exports.RezoFormData = _mod_k82fb8.RezoFormData;;
+const _mod_u8f16d = require('./utils/cookies.cjs');
+exports.RezoCookieJar = _mod_u8f16d.RezoCookieJar;
+exports.Cookie = _mod_u8f16d.Cookie;;
+const _mod_5km04t = require('./utils/curl.cjs');
+exports.toCurl = _mod_5km04t.toCurl;
+exports.fromCurl = _mod_5km04t.fromCurl;;
+const _mod_c99qva = require('./core/hooks.cjs');
+exports.createDefaultHooks = _mod_c99qva.createDefaultHooks;
+exports.mergeHooks = _mod_c99qva.mergeHooks;;
+const _mod_nlh20q = require('./proxy/manager.cjs');
+exports.ProxyManager = _mod_nlh20q.ProxyManager;;
+const _mod_2j9uz9 = require('./queue/index.cjs');
+exports.RezoQueue = _mod_2j9uz9.RezoQueue;
+exports.HttpQueue = _mod_2j9uz9.HttpQueue;
+exports.Priority = _mod_2j9uz9.Priority;
+exports.HttpMethodPriority = _mod_2j9uz9.HttpMethodPriority;;
 const { RezoError } = require('./errors/rezo-error.cjs');
 const isRezoError = exports.isRezoError = RezoError.isRezoError;
 const Cancel = exports.Cancel = RezoError;
@@ -34,9 +34,9 @@ const isCancel = exports.isCancel = (error) => {
 };
 const all = exports.all = Promise.all.bind(Promise);
 const spread = exports.spread = (callback) => (array) => callback(...array);
-const _mod_f3fuza = require('./version.cjs');
-exports.VERSION = _mod_f3fuza.VERSION;
-exports.PACKAGE_NAME = _mod_f3fuza.PACKAGE_NAME;;
+const _mod_xznh6j = require('./version.cjs');
+exports.VERSION = _mod_xznh6j.VERSION;
+exports.PACKAGE_NAME = _mod_xznh6j.PACKAGE_NAME;;
 const { executeRequest } = require('./adapters/http.cjs');
 const { setGlobalAdapter, createRezoInstance } = require('./core/rezo.cjs');
 setGlobalAdapter(executeRequest);

package/dist/index.d.ts

@@ -2030,6 +2030,13 @@ export interface QueueConfig {
 	intervalCap?: number;
 	/** Carry over unused interval capacity to next interval */
 	carryoverConcurrencyCount?: boolean;
+	/**
+	 * Reject the task promise when an error occurs (default: false)
+	 * When false, errors are swallowed and task.resolve(undefined) is called.
+	 * This prevents unhandled promise rejections but makes error handling harder.
+	 * When true, task.reject(error) is called, allowing proper try/catch handling.
+	 */
+	rejectOnError?: boolean;
 }
 /**
  * HTTP-specific queue configuration
@@ -2342,8 +2349,12 @@ export declare class RezoQueue<T = any> {
 	/**
 	 * Wait for queue size to be less than limit
 	 * @param limit - Size threshold
+	 * @param timeoutMs - Optional timeout in milliseconds (default: 0 = no timeout)
+	 *                    If timeout occurs, promise resolves (not rejects) to prevent blocking
 	 */
-	onSizeLessThan(limit: number): Promise<void>;
+	onSizeLessThan(limit: number, timeoutMs?: number): Promise<void>;
+	/** Maximum recommended handlers per event before warning */
+	private static readonly MAX_HANDLERS_WARNING;
 	/**
 	 * Register an event handler
 	 * @param event - Event name
@@ -4872,7 +4883,7 @@ export declare class HttpQueue extends RezoQueue<any> {
  *
  * IMPORTANT: Update these values when bumping package version.
  */
-export declare const VERSION = "1.0.72";
+export declare const VERSION = "1.0.74";
 export declare const PACKAGE_NAME = "rezo";
 export declare const isRezoError: typeof RezoError.isRezoError;
 export declare const Cancel: typeof RezoError;

package/dist/internal/agents/index.cjs

@@ -1,10 +1,10 @@
-const _mod_qwaec6 = require('./base.cjs');
-exports.Agent = _mod_qwaec6.Agent;;
-const _mod_lrn2yu = require('./http-proxy.cjs');
-exports.HttpProxyAgent = _mod_lrn2yu.HttpProxyAgent;;
-const _mod_jyfvy6 = require('./https-proxy.cjs');
-exports.HttpsProxyAgent = _mod_jyfvy6.HttpsProxyAgent;;
-const _mod_frfunk = require('./socks-proxy.cjs');
-exports.SocksProxyAgent = _mod_frfunk.SocksProxyAgent;;
-const _mod_zcnfo4 = require('./socks-client.cjs');
-exports.SocksClient = _mod_zcnfo4.SocksClient;;
+const _mod_0a73ie = require('./base.cjs');
+exports.Agent = _mod_0a73ie.Agent;;
+const _mod_rs317e = require('./http-proxy.cjs');
+exports.HttpProxyAgent = _mod_rs317e.HttpProxyAgent;;
+const _mod_syy64b = require('./https-proxy.cjs');
+exports.HttpsProxyAgent = _mod_syy64b.HttpsProxyAgent;;
+const _mod_rciw1o = require('./socks-proxy.cjs');
+exports.SocksProxyAgent = _mod_rciw1o.SocksProxyAgent;;
+const _mod_w9tiwm = require('./socks-client.cjs');
+exports.SocksClient = _mod_w9tiwm.SocksClient;;