@monque/core 1.4.0 → 1.5.0

package/dist/index.d.cts

@@ -578,16 +578,16 @@ interface MonqueEventMap {
   };
   /**
    * Emitted when multiple jobs are cancelled in bulk.
+   * Contains only the count of affected jobs (no individual IDs for O(1) performance).
    */
   'jobs:cancelled': {
-    jobIds: string[];
     count: number;
   };
   /**
    * Emitted when multiple jobs are retried in bulk.
+   * Contains only the count of affected jobs (no individual IDs for O(1) performance).
    */
   'jobs:retried': {
-    jobIds: string[];
     count: number;
   };
   /**
@@ -780,6 +780,27 @@ interface MonqueOptions {
    * @default false
    */
   skipIndexCreation?: boolean;
+  /**
+   * Maximum allowed BSON byte size for job data payloads.
+   *
+   * When set, `enqueue()`, `now()`, and `schedule()` validate the payload size
+   * using `BSON.calculateObjectSize()` before insertion. Jobs exceeding this limit
+   * throw `PayloadTooLargeError`.
+   *
+   * When undefined, no size validation occurs.
+   */
+  maxPayloadSize?: number | undefined;
+  /**
+   * TTL in milliseconds for getQueueStats() result caching.
+   *
+   * When set to a positive value, repeated getQueueStats() calls with the same
+   * filter return cached results instead of re-executing the aggregation pipeline.
+   * Each unique filter (job name) maintains its own cache entry.
+   *
+   * Set to 0 to disable caching entirely.
+   * @default 5000
+   */
+  statsCacheTtlMs?: number;
 }
 //#endregion
 //#region src/scheduler/monque.d.ts
@@ -852,9 +873,6 @@ declare class Monque extends EventEmitter {
   private readonly options;
   private collection;
   private workers;
-  private pollIntervalId;
-  private heartbeatIntervalId;
-  private cleanupIntervalId;
   private isRunning;
   private isInitialized;
   private _scheduler;
@@ -862,6 +880,7 @@ declare class Monque extends EventEmitter {
   private _query;
   private _processor;
   private _changeStreamHandler;
+  private _lifecycleManager;
   constructor(db: Db, options?: MonqueOptions);
   /**
    * Initialize the scheduler by setting up the MongoDB collection and indexes.
@@ -880,6 +899,8 @@ declare class Monque extends EventEmitter {
   private get processor();
   /** @throws {ConnectionError} if not initialized */
   private get changeStreamHandler();
+  /** @throws {ConnectionError} if not initialized */
+  private get lifecycleManager();
   /**
    * Build the shared context for internal services.
    */
@@ -904,16 +925,15 @@ declare class Monque extends EventEmitter {
    */
   private recoverStaleJobs;
   /**
-   * Clean up old completed and failed jobs based on retention policy.
-   *
-   * - Removes completed jobs older than `jobRetention.completed`
-   * - Removes failed jobs older than `jobRetention.failed`
+   * Check if another active instance is using the same schedulerInstanceId.
+   * Uses heartbeat staleness to distinguish active instances from crashed ones.
    *
-   * The cleanup runs concurrently for both statuses if configured.
+   * Called after stale recovery to avoid false positives: stale recovery resets
+   * jobs with old `lockedAt`, so only jobs with recent heartbeats remain.
    *
-   * @returns Promise resolving when all deletion operations complete
+   * @throws {ConnectionError} If an active instance with the same ID is detected
    */
-  private cleanupJobs;
+  private checkInstanceCollision;
   /**
    * Enqueue a job for processing.
    *
@@ -932,6 +952,7 @@ declare class Monque extends EventEmitter {
    * @param options - Scheduling and deduplication options
    * @returns Promise resolving to the created or existing job document
    * @throws {ConnectionError} If database operation fails or scheduler not initialized
+   * @throws {PayloadTooLargeError} If payload exceeds configured `maxPayloadSize`
    *
    * @example Basic job enqueueing
    * ```typescript
@@ -957,6 +978,8 @@ declare class Monque extends EventEmitter {
    * });
    * // Subsequent enqueues with same uniqueKey return existing pending/processing job
    * ```
+   *
+   * @see {@link JobScheduler.enqueue}
    */
   enqueue<T>(name: string, data: T, options?: EnqueueOptions): Promise<PersistedJob<T>>;
   /**
@@ -986,6 +1009,8 @@ declare class Monque extends EventEmitter {
    * await monque.now('process-order', { orderId: order.id });
    * return order; // Return immediately, processing happens async
    * ```
+   *
+   * @see {@link JobScheduler.now}
    */
   now<T>(name: string, data: T): Promise<PersistedJob<T>>;
   /**
@@ -1008,6 +1033,7 @@ declare class Monque extends EventEmitter {
    * @returns Promise resolving to the created job document with `repeatInterval` set
    * @throws {InvalidCronError} If cron expression is invalid
    * @throws {ConnectionError} If database operation fails or scheduler not initialized
+   * @throws {PayloadTooLargeError} If payload exceeds configured `maxPayloadSize`
    *
    * @example Hourly cleanup job
    * ```typescript
@@ -1031,6 +1057,8 @@ declare class Monque extends EventEmitter {
    *   recipients: ['analytics@example.com']
    * });
    * ```
+   *
+   * @see {@link JobScheduler.schedule}
    */
   schedule<T>(cron: string, name: string, data: T, options?: ScheduleOptions): Promise<PersistedJob<T>>;
   /**
@@ -1049,6 +1077,8 @@ declare class Monque extends EventEmitter {
    * const job = await monque.enqueue('report', { type: 'daily' });
    * await monque.cancelJob(job._id.toString());
    * ```
+   *
+   * @see {@link JobManager.cancelJob}
    */
   cancelJob(jobId: string): Promise<PersistedJob<unknown> | null>;
   /**
@@ -1068,6 +1098,8 @@ declare class Monque extends EventEmitter {
    *   await monque.retryJob(job._id.toString());
    * });
    * ```
+   *
+   * @see {@link JobManager.retryJob}
    */
   retryJob(jobId: string): Promise<PersistedJob<unknown> | null>;
   /**
@@ -1085,6 +1117,8 @@ declare class Monque extends EventEmitter {
    * const nextHour = new Date(Date.now() + 60 * 60 * 1000);
    * await monque.rescheduleJob(jobId, nextHour);
    * ```
+   *
+   * @see {@link JobManager.rescheduleJob}
    */
   rescheduleJob(jobId: string, runAt: Date): Promise<PersistedJob<unknown> | null>;
   /**
@@ -1103,17 +1137,20 @@ declare class Monque extends EventEmitter {
    *   console.log('Job permanently removed');
    * }
    * ```
+   *
+   * @see {@link JobManager.deleteJob}
    */
   deleteJob(jobId: string): Promise<boolean>;
   /**
-   * Cancel multiple jobs matching the given filter.
+   * Cancel multiple jobs matching the given filter via a single updateMany call.
    *
-   * Only cancels jobs in 'pending' status. Jobs in other states are collected
-   * as errors in the result. Emits a 'jobs:cancelled' event with the IDs of
+   * Only cancels jobs in 'pending' status — the status guard is applied regardless
+   * of what the filter specifies. Jobs in other states are silently skipped (not
+   * matched by the query). Emits a 'jobs:cancelled' event with the count of
    * successfully cancelled jobs.
    *
    * @param filter - Selector for which jobs to cancel (name, status, date range)
-   * @returns Result with count of cancelled jobs and any errors encountered
+   * @returns Result with count of cancelled jobs (errors array always empty for bulk ops)
    *
    * @example Cancel all pending jobs for a queue
    * ```typescript
@@ -1123,17 +1160,20 @@ declare class Monque extends EventEmitter {
    * });
    * console.log(`Cancelled ${result.count} jobs`);
    * ```
+   *
+   * @see {@link JobManager.cancelJobs}
    */
   cancelJobs(filter: JobSelector): Promise<BulkOperationResult>;
   /**
-   * Retry multiple jobs matching the given filter.
+   * Retry multiple jobs matching the given filter via a single pipeline-style updateMany call.
    *
-   * Only retries jobs in 'failed' or 'cancelled' status. Jobs in other states
-   * are collected as errors in the result. Emits a 'jobs:retried' event with
-   * the IDs of successfully retried jobs.
+   * Only retries jobs in 'failed' or 'cancelled' status — the status guard is applied
+   * regardless of what the filter specifies. Jobs in other states are silently skipped.
+   * Uses `$rand` for per-document staggered `nextRunAt` to avoid thundering herd on retry.
+   * Emits a 'jobs:retried' event with the count of successfully retried jobs.
    *
    * @param filter - Selector for which jobs to retry (name, status, date range)
-   * @returns Result with count of retried jobs and any errors encountered
+   * @returns Result with count of retried jobs (errors array always empty for bulk ops)
    *
    * @example Retry all failed jobs
    * ```typescript
@@ -1142,12 +1182,15 @@ declare class Monque extends EventEmitter {
    * });
    * console.log(`Retried ${result.count} jobs`);
    * ```
+   *
+   * @see {@link JobManager.retryJobs}
    */
   retryJobs(filter: JobSelector): Promise<BulkOperationResult>;
   /**
    * Delete multiple jobs matching the given filter.
    *
    * Deletes jobs in any status. Uses a batch delete for efficiency.
+   * Emits a 'jobs:deleted' event with the count of deleted jobs.
    * Does not emit individual 'job:deleted' events to avoid noise.
    *
    * @param filter - Selector for which jobs to delete (name, status, date range)
@@ -1162,6 +1205,8 @@ declare class Monque extends EventEmitter {
    * });
    * console.log(`Deleted ${result.count} jobs`);
    * ```
+   *
+   * @see {@link JobManager.deleteJobs}
    */
   deleteJobs(filter: JobSelector): Promise<BulkOperationResult>;
   /**
@@ -1194,6 +1239,8 @@ declare class Monque extends EventEmitter {
    *   res.json(job);
    * });
    * ```
+   *
+   * @see {@link JobQueryService.getJob}
    */
   getJob<T = unknown>(id: ObjectId): Promise<PersistedJob<T> | null>;
   /**
@@ -1237,6 +1284,8 @@ declare class Monque extends EventEmitter {
    * const jobs = await monque.getJobs();
    * const pendingRecurring = jobs.filter(job => isPendingJob(job) && isRecurringJob(job));
    * ```
+   *
+   * @see {@link JobQueryService.getJobs}
    */
   getJobs<T = unknown>(filter?: GetJobsFilter): Promise<PersistedJob<T>[]>;
   /**
@@ -1267,6 +1316,8 @@ declare class Monque extends EventEmitter {
    *   });
    * }
    * ```
+   *
+   * @see {@link JobQueryService.getJobsWithCursor}
    */
   getJobsWithCursor<T = unknown>(options?: CursorOptions): Promise<CursorPage<T>>;
   /**
@@ -1275,6 +1326,9 @@ declare class Monque extends EventEmitter {
    * Uses MongoDB aggregation pipeline for efficient server-side calculation.
    * Returns counts per status and optional average processing duration for completed jobs.
    *
+   * Results are cached per unique filter with a configurable TTL (default 5s).
+   * Set `statsCacheTtlMs: 0` to disable caching.
+   *
    * @param filter - Optional filter to scope statistics by job name
    * @returns Promise resolving to queue statistics
    * @throws {AggregationTimeoutError} If aggregation exceeds 30 second timeout
@@ -1291,6 +1345,8 @@ declare class Monque extends EventEmitter {
    * const emailStats = await monque.getQueueStats({ name: 'send-email' });
    * console.log(`${emailStats.total} email jobs in queue`);
    * ```
+   *
+   * @see {@link JobQueryService.getQueueStats}
    */
   getQueueStats(filter?: Pick<JobSelector, 'name'>): Promise<QueueStats>;
   /**
@@ -1664,6 +1720,27 @@ declare class InvalidCursorError extends MonqueError {
 declare class AggregationTimeoutError extends MonqueError {
   constructor(message?: string);
 }
+/**
+ * Error thrown when a job payload exceeds the configured maximum BSON byte size.
+ *
+ * @example
+ * ```typescript
+ * const monque = new Monque(db, { maxPayloadSize: 1_000_000 }); // 1 MB
+ *
+ * try {
+ *   await monque.enqueue('job', hugePayload);
+ * } catch (error) {
+ *   if (error instanceof PayloadTooLargeError) {
+ *     console.error(`Payload ${error.actualSize} bytes exceeds limit ${error.maxSize} bytes`);
+ *   }
+ * }
+ * ```
+ */
+declare class PayloadTooLargeError extends MonqueError {
+  readonly actualSize: number;
+  readonly maxSize: number;
+  constructor(message: string, actualSize: number, maxSize: number);
+}
 //#endregion
 //#region src/shared/utils/backoff.d.ts
 /**
@@ -1753,5 +1830,5 @@ declare function getNextCronDate(expression: string, currentDate?: Date): Date;
  */
 declare function validateCronExpression(expression: string): void;
 //#endregion
-export { AggregationTimeoutError, type BulkOperationResult, ConnectionError, CursorDirection, type CursorOptions, type CursorPage, DEFAULT_BASE_INTERVAL, DEFAULT_MAX_BACKOFF_DELAY, type EnqueueOptions, type GetJobsFilter, InvalidCronError, InvalidCursorError, type Job, type JobHandler, type JobSelector, JobStateError, JobStatus, type JobStatusType, Monque, MonqueError, type MonqueEventMap, type MonqueOptions, type PersistedJob, type QueueStats, type ScheduleOptions, ShutdownTimeoutError, type WorkerOptions, WorkerRegistrationError, calculateBackoff, calculateBackoffDelay, getNextCronDate, isCancelledJob, isCompletedJob, isFailedJob, isPendingJob, isPersistedJob, isProcessingJob, isRecurringJob, isValidJobStatus, validateCronExpression };
+export { AggregationTimeoutError, type BulkOperationResult, ConnectionError, CursorDirection, type CursorOptions, type CursorPage, DEFAULT_BASE_INTERVAL, DEFAULT_MAX_BACKOFF_DELAY, type EnqueueOptions, type GetJobsFilter, InvalidCronError, InvalidCursorError, type Job, type JobHandler, type JobSelector, JobStateError, JobStatus, type JobStatusType, Monque, MonqueError, type MonqueEventMap, type MonqueOptions, PayloadTooLargeError, type PersistedJob, type QueueStats, type ScheduleOptions, ShutdownTimeoutError, type WorkerOptions, WorkerRegistrationError, calculateBackoff, calculateBackoffDelay, getNextCronDate, isCancelledJob, isCompletedJob, isFailedJob, isPendingJob, isPersistedJob, isProcessingJob, isRecurringJob, isValidJobStatus, validateCronExpression };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/jobs/types.ts","../src/jobs/guards.ts","../src/events/types.ts","../src/workers/types.ts","../src/scheduler/types.ts","../src/scheduler/monque.ts","../src/shared/errors.ts","../src/shared/utils/backoff.ts","../src/shared/utils/cron.ts"],"mappings":";;;;;;;AAmBA;;;;;;;;;;;AAgBA;;;cAhBa,SAAA;EAgBwD,8EA0BjD;EAAA,mCAEb;EAAA,iCASE;EAAA,2BAMG;EAAA;;;;;KA3CA,aAAA,WAAwB,SAAA,eAAwB,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;UA0B3C,GAAA;EAgEL;EA9DX,GAAA,GAAM,QAAA;EA8DiB;EA3DvB,IAAA;EA2DuC;EAxDvC,IAAA,EAAM,CAAA;EAwDyD;EArD/D,MAAA,EAAQ,aAAA;EAqDgB;EAlDxB,SAAA,EAAW,IAAA;EAkDgC;EA/C3C,QAAA,GAAW,IAAA;EA+C4C;;;AAaxD;;EArDC,SAAA;EA+DY;;;;;EAxDZ,aAAA,GAAgB,IAAA;EAqEA;;;;EA/DhB,iBAAA;EA4FgB;EAzFhB,SAAA;;EAGA,UAAA;EAwFA;EArFA,cAAA;EAwFS;EArFT,SAAA;EAwFA;EArFA,SAAA,EAAW,IAAA;EAwFP;EArFJ,SAAA,EAAW,IAAA;AAAA;;;;;;;KASA,YAAA,gBAA4B,GAAA,CAAI,CAAA;EAAO,GAAA,EAAK,QAAA;AAAA;;;;;;AAqGxD;;;;;AAKA;UA7FiB,cAAA;;;;AA6GjB;EAxGC,SAAA;;;;EAKA,KAAA,GAAQ,IAAA;AAAA;;;;;;;;;;;UAaQ,eAAA;EA0FA;AAejB;;;EApGC,SAAA;AAAA;;;;;;;;;;;;;AA0HD;;;;;;;;;UAlGiB,aAAA;EAsGhB;EApGA,IAAA;EAoGe;EAjGf,MAAA,GAAS,aAAA,GAAgB,aAAA;EAiHC;EA9G1B,KAAA;EA8G0B;EA3G1B,IAAA;AAAA;;;;;;;;AAkID;;;;;KAnHY,UAAA,iBAA2B,GAAA,EAAK,GAAA,CAAI,CAAA,MAAO,OAAA;;;;;;;;;cAU1C,eAAA;EAAA,SAGH,OAAA;EAAA,SAAA,QAAA;AAAA;AAAA,KAEE,mBAAA,WAA8B,eAAA,eAA8B,eAAA;;;;;;;;;;;;;;AC/JxE;UD+KiB,WAAA;EAChB,IAAA;EACA,MAAA,GAAS,aAAA,GAAgB,aAAA;EACzB,SAAA,GAAY,IAAA;EACZ,SAAA,GAAY,IAAA;AAAA;;;ACvJb;;;;;;;;;;UDsKiB,aAAA;EAChB,MAAA;EACA,KAAA;EACA,SAAA,GAAY,mBAAA;EACZ,MAAA,GAAS,IAAA,CAAK,aAAA;AAAA;;;;;AChIf;;;;;;;;;;AAyBA;UDyHiB,UAAA;EAChB,IAAA,EAAM,YAAA,CAAa,CAAA;EACnB,MAAA;EACA,WAAA;EACA,eAAA;AAAA;;;;ACxGD;;;;;;;;;;UDwHiB,UAAA;EAChB,OAAA;EACA,UAAA;EACA,SAAA;EACA,MAAA;EACA,SAAA;EACA,KAAA;EACA,uBAAA;AAAA;;;;;AEtTD;;;;;;;;;UFsUiB,mBAAA;EAChB,KAAA;EACA,MAAA,EAAQ,KAAA;IAAQ,KAAA;IAAe,KAAA;EAAA;AAAA;;;;;;AA1ThC;;;;;;;;;;;AAgBA;;;;;AA0BA;;;;;;;;;;;;;;iBCzBgB,cAAA,GAAA,CAAkB,GAAA,EAAK,GAAA,CAAI,CAAA,IAAK,GAAA,IAAO,YAAA,CAAa,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;ADyFpE;;;;;;;;iBCrDgB,gBAAA,CAAiB,KAAA,YAAiB,KAAA,IAAS,aAAA;;;;;;;ADkE3D;;;;;;;;;AAuBA;;;;;AA6BA;;;;iBC1FgB,YAAA,GAAA,CAAgB,GAAA,EAAK,GAAA,CAAI,CAAA;;;;;;;;ADoHzC;;;;;;;;;;iBC/FgB,eAAA,GAAA,CAAmB,GAAA,EAAK,GAAA,CAAI,CAAA;;;;;ADyG5C;;;;;AAKA;;;;;AAgBA;;;iBCzGgB,cAAA,GAAA,CAAkB,GAAA,EAAK,GAAA,CAAI,CAAA;;;;;;;;;;;;;;;;AD4H3C;;;;;;iBCnGgB,WAAA,GAAA,CAAe,GAAA,EAAK,GAAA,CAAI,CAAA;;;;;;;;;;;ADyHxC;;;;;;;iBCpGgB,cAAA,GAAA,CAAkB,GAAA,EAAK,GAAA,CAAI,CAAA;;;;;;ADwH3C;;;;;;;;;;;;;AAuBA;;;;;;;iBClHgB,cAAA,GAAA,CAAkB,GAAA,EAAK,GAAA,CAAI,CAAA;;;;;;UCpN1B,cAAA;EFyBP;;;EErBT,WAAA,EAAa,GAAA;;;;EAKb,cAAA;IACC,GAAA,EAAK,GAAA;IAEL,QAAA;EAAA;;;;EAMD,UAAA;IACC,GAAA,EAAK,GAAA;IACL,KAAA,EAAO,KAAA,EFsCF;IEpCL,SAAA;EAAA;EFgDU;;;EE1CX,WAAA;IACC,KAAA,EAAO,KAAA;IACP,GAAA,GAAM,GAAA;EAAA;EF0Ba;;;EEpBpB,iBAAA;IACC,KAAA;EAAA;EF8BD;;;EExBA,wBAAA;EF8BA;;;EEzBA,oBAAA;IACC,KAAA,EAAO,KAAA;EAAA;EF+CR;;;EEzCA,qBAAA;EFqDA;;;EEhDA,uBAAA;IACC,MAAA;EAAA;EF2DU;;;EEtDX,eAAA;IACC,GAAA,EAAK,GAAA;EAAA;EFqDyD;;;EE/C/D,aAAA;IACC,GAAA,EAAK,GAAA;IACL,cAAA;EAAA;EF6C8D;;AAahE;EEpDC,aAAA;IACC,KAAA;EAAA;EFwDD;;;EElDA,gBAAA;IACC,MAAA;IACA,KAAA;EAAA;;;;EAMD,cAAA;IACC,MAAA;IACA,KAAA;EAAA;EFyFD;;;EEnFA,cAAA;IACC,KAAA;EAAA;AAAA;;;;;;AF3FF;;;;;;;UGPiB,aAAA;;;;AHuBjB;EGlBC,WAAA;;;;AH4CD;;EGrCC,OAAA;AAAA;;;;;;;AHLD;;;;;;;;;;;AAgBA;UInBiB,aAAA;;;;AJ6CjB;EIxCC,cAAA;EJwCmB;;;;EIlCnB,YAAA;EJmDW;;;;EI7CX,UAAA;EJmFe;;;;;EI5Ef,iBAAA;EJ6BM;;;;;;;EIpBN,eAAA;EJ2CA;;;;EIrCA,eAAA;EJoDA;;;;;;;;EI1CA,iBAAA;EJ4DuB;;;;;;EIpDvB,kBAAA;EJoDwB;;;;;;;AAazB;EIvDC,WAAA;;;;;;;EAQA,mBAAA;EJsEgB;;;;;AA6BjB;;;EIzFC,iBAAA;EJ2FA;;;;;EIpFA,gBAAA;EJ6FI;;AAeL;;EItGC,YAAA;IJsG+C;;;;IIhG5C,SAAA;IJgGmB;;;;II1FnB,MAAA;IJ0F0D;;AAU9D;;II9FI,QAAA;EAAA;;AJmGJ;;;;;AAgBA;;;;;;;;;;;;;;EI3FC,mBAAA;EJ+FA;;;;AAeD;EIvGC,cAAA;;;;;;;;;;EAWA,iBAAA;AAAA;;;;;;;;;;;;AJ3ID;;;;;AA0BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgEA;;;;;;;;;;;cKXa,MAAA,SAAe,YAAA;EAAA,iBACV,EAAA;EAAA,iBACA,OAAA;EAAA,QACT,UAAA;EAAA,QACA,OAAA;EAAA,QACA,cAAA;EAAA,QACA,mBAAA;EAAA,QACA,iBAAA;EAAA,QACA,SAAA;EAAA,QACA,aAAA;EAAA,QAGA,UAAA;EAAA,QACA,QAAA;EAAA,QACA,MAAA;EAAA,QACA,UAAA;EAAA,QACA,oBAAA;cAEI,EAAA,EAAI,EAAA,EAAI,OAAA,GAAS,aAAA;ELkC7B;;AAwBD;;;;EK9BO,UAAA,CAAA,GAAc,OAAA;ELmCpB;EAAA,YKIY,SAAA,CAAA;ELJa;EAAA,YKab,OAAA,CAAA;ELPZ;EAAA,YKgBY,KAAA,CAAA;ELhBR;EAAA,YKyBQ,SAAA,CAAA;ELVS;EAAA,YKmBT,mBAAA,CAAA;ELnBmC;;;EAAA,QK8BvC,YAAA;EL9BqD;;;;;;;;AAU9D;;;;EAV8D,QK0D/C,aAAA;EL3CH;;;;;EAAA,QKmFG,gBAAA;ELnEa;;;;;;;;;;EAAA,QK+Gb,WAAA;EL7GW;;;;;;;AAiB1B;;;;;;;;;;;;;;;;;AAsBA;;;;;;;;;;;;;AAoBA;;;;;;;EKoIO,OAAA,GAAA,CAAW,IAAA,UAAc,IAAA,EAAM,CAAA,EAAG,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,YAAA,CAAa,CAAA;EL/H5F;;;;;AAkBD;;;;;;;;;;;;;;ACvSA;;;;;;;;;EIqbO,GAAA,GAAA,CAAO,IAAA,UAAc,IAAA,EAAM,CAAA,GAAI,OAAA,CAAQ,YAAA,CAAa,CAAA;EJrbpB;;;;;;;;AAoCvC;;;;;;;;;AA4BA;;;;;;;;;;AAqBA;;;;;;;;;;AAqBA;;;;;;;EI4XO,QAAA,GAAA,CACL,IAAA,UACA,IAAA,UACA,IAAA,EAAM,CAAA,EACN,OAAA,GAAS,eAAA,GACP,OAAA,CAAQ,YAAA,CAAa,CAAA;EJjYoB;;AAyB7C;;;;;;;;;;AAqBA;;;;;EI6WO,SAAA,CAAU,KAAA,WAAgB,OAAA,CAAQ,YAAA;EJ7WE;;;;AA6B3C;;;;;;;;;;;;;ACpNA;EG2jBO,QAAA,CAAS,KAAA,WAAgB,OAAA,CAAQ,YAAA;;;;;;;;;;;;;;;;;EAqBjC,aAAA,CAAc,KAAA,UAAe,KAAA,EAAO,IAAA,GAAO,OAAA,CAAQ,YAAA;EHpkBxD;;;;;;;;;;;;;;;;;EG0lBK,SAAA,CAAU,KAAA,WAAgB,OAAA;EH/iBhC;;;;;;;;;;;;;;;;;;;EGukBM,UAAA,CAAW,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,mBAAA;EHrhBzC;;;;;AClGP;;;;;;;;ACIA;;;;;EC0oBO,SAAA,CAAU,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,mBAAA;EDznB9C;;;;;;;;;;;;;;;;;;;ECipBM,UAAA,CAAW,MAAA,EAAQ,WAAA,GAAc,OAAA,CAAQ,mBAAA;;;AAhkBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwmBO,MAAA,aAAA,CAAoB,EAAA,EAAI,QAAA,GAAW,OAAA,CAAQ,YAAA,CAAa,CAAA;EAvFvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsIjC,OAAA,aAAA,CAAqB,MAAA,GAAQ,aAAA,GAAqB,OAAA,CAAQ,YAAA,CAAa,CAAA;EAvpBlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyrBrB,iBAAA,aAAA,CAA+B,OAAA,GAAS,aAAA,GAAqB,OAAA,CAAQ,UAAA,CAAW,CAAA;EArjB9E;;;;;;;;;;;;;;;;;;;;;;;EAilBF,aAAA,CAAc,MAAA,GAAS,IAAA,CAAK,WAAA,YAAuB,OAAA,CAAQ,UAAA;EA5ThE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqYD,QAAA,GAAA,CAAY,IAAA,UAAc,OAAA,EAAS,UAAA,CAAW,CAAA,GAAI,OAAA,GAAS,aAAA;EAzEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0IpB,KAAA,CAAA;EA6QS;;;;;;;;;;;;;;AC9sCV;;;;;;;;;AA0BA;;;;;;;;;;ED2/BO,IAAA,CAAA,GAAQ,OAAA;EC/9BF;;;;;;;;;;;;AA6Bb;;;;;;;;;;;;;;;;;AAiCA;;;;;;;;;;;AA4BA;;;;;;EDy/BC,SAAA,CAAA;ECp/BiB;;;;;;EAAA,QDkgCT,iBAAA;EClgC2D;AAyBpE;;;;;EAzBoE,QD8gC3D,aAAA;ECp/BI;;;AAwBb;;;EAxBa,QDkgCJ,iBAAA;EC1+BoC;;;EDq/BnC,IAAA,iBAAqB,cAAA,CAAA,CAAgB,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,cAAA,CAAe,CAAA;EAIvE,EAAA,iBAAmB,cAAA,CAAA,CAC3B,KAAA,EAAO,CAAA,EACP,QAAA,GAAW,OAAA,EAAS,cAAA,CAAe,CAAA;EAK3B,IAAA,iBAAqB,cAAA,CAAA,CAC7B,KAAA,EAAO,CAAA,EACP,QAAA,GAAW,OAAA,EAAS,cAAA,CAAe,CAAA;EAK3B,GAAA,iBAAoB,cAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,QAAA,GAAW,OAAA,EAAS,cAAA,CAAe,CAAA;AAAA;;;;;;AL7sCrC;;;;;;;;;;;cMHa,WAAA,SAAoB,KAAA;cACpB,OAAA;AAAA;;;AN4Cb;;;;;;;;;;;;cMnBa,gBAAA,SAAyB,WAAA;EAAA,SAEpB,UAAA;cAAA,UAAA,UAChB,OAAA;AAAA;;;;;;;;;;;;;;;cAyBW,eAAA,SAAwB,WAAA;cACxB,OAAA,UAAiB,OAAA;IAAY,KAAA,GAAQ,KAAA;EAAA;AAAA;;;;;ANsDlD;;;;;;;;;;;cM1Ba,oBAAA,SAA6B,WAAA;EAAA,SAGxB,cAAA,EAAgB,GAAA;cADhC,OAAA,UACgB,cAAA,EAAgB,GAAA;AAAA;ANoClC;;;;;;;;;AAuBA;;;;;AA6BA;;;;;AApDA,cMNa,uBAAA,SAAgC,WAAA;EAAA,SAG3B,OAAA;cADhB,OAAA,UACgB,OAAA;AAAA;;;;ANiFlB;;;;;;;;;;;cMxDa,aAAA,SAAsB,WAAA;EAAA,SAGjB,KAAA;EAAA,SACA,aAAA;EAAA,SACA,eAAA;cAHhB,OAAA,UACgB,KAAA,UACA,aAAA,UACA,eAAA;AAAA;;;;ANkElB;;;;;AAgBA;;;;;;cMzDa,kBAAA,SAA2B,WAAA;cAC3B,OAAA;AAAA;;;;;;;;;;;AN2Eb;;;;cMnDa,uBAAA,SAAgC,WAAA;cAChC,OAAA;AAAA;;;;;;;cCpNA,qBAAA;;;;;;;;cASA,yBAAA;;;APsBb;;;;;AA0BA;;;;;;;;;;;;;;;;;;iBOrBgB,gBAAA,CACf,SAAA,UACA,YAAA,WACA,QAAA,YACE,IAAA;;;;;;;;;iBAmBa,qBAAA,CACf,SAAA,UACA,YAAA,WACA,QAAA;;;;;;;AP/CD;;;;;;;;;;;AAgBA;;;;;AA0BA;;;iBQlCgB,eAAA,CAAgB,UAAA,UAAoB,WAAA,GAAc,IAAA,GAAO,IAAA;;;;;;;;;;;;iBAsBzD,sBAAA,CAAuB,UAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/jobs/types.ts","../src/jobs/guards.ts","../src/events/types.ts","../src/workers/types.ts","../src/scheduler/types.ts","../src/scheduler/monque.ts","../src/shared/errors.ts","../src/shared/utils/backoff.ts","../src/shared/utils/cron.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -578,16 +578,16 @@ interface MonqueEventMap {
   };
   /**
    * Emitted when multiple jobs are cancelled in bulk.
+   * Contains only the count of affected jobs (no individual IDs for O(1) performance).
    */
   'jobs:cancelled': {
-    jobIds: string[];
     count: number;
   };
   /**
    * Emitted when multiple jobs are retried in bulk.
+   * Contains only the count of affected jobs (no individual IDs for O(1) performance).
    */
   'jobs:retried': {
-    jobIds: string[];
     count: number;
   };
   /**
@@ -780,6 +780,27 @@ interface MonqueOptions {
    * @default false
    */
   skipIndexCreation?: boolean;
+  /**
+   * Maximum allowed BSON byte size for job data payloads.
+   *
+   * When set, `enqueue()`, `now()`, and `schedule()` validate the payload size
+   * using `BSON.calculateObjectSize()` before insertion. Jobs exceeding this limit
+   * throw `PayloadTooLargeError`.
+   *
+   * When undefined, no size validation occurs.
+   */
+  maxPayloadSize?: number | undefined;
+  /**
+   * TTL in milliseconds for getQueueStats() result caching.
+   *
+   * When set to a positive value, repeated getQueueStats() calls with the same
+   * filter return cached results instead of re-executing the aggregation pipeline.
+   * Each unique filter (job name) maintains its own cache entry.
+   *
+   * Set to 0 to disable caching entirely.
+   * @default 5000
+   */
+  statsCacheTtlMs?: number;
 }
 //#endregion
 //#region src/scheduler/monque.d.ts
@@ -852,9 +873,6 @@ declare class Monque extends EventEmitter {
   private readonly options;
   private collection;
   private workers;
-  private pollIntervalId;
-  private heartbeatIntervalId;
-  private cleanupIntervalId;
   private isRunning;
   private isInitialized;
   private _scheduler;
@@ -862,6 +880,7 @@ declare class Monque extends EventEmitter {
   private _query;
   private _processor;
   private _changeStreamHandler;
+  private _lifecycleManager;
   constructor(db: Db, options?: MonqueOptions);
   /**
    * Initialize the scheduler by setting up the MongoDB collection and indexes.
@@ -880,6 +899,8 @@ declare class Monque extends EventEmitter {
   private get processor();
   /** @throws {ConnectionError} if not initialized */
   private get changeStreamHandler();
+  /** @throws {ConnectionError} if not initialized */
+  private get lifecycleManager();
   /**
    * Build the shared context for internal services.
    */
@@ -904,16 +925,15 @@ declare class Monque extends EventEmitter {
    */
   private recoverStaleJobs;
   /**
-   * Clean up old completed and failed jobs based on retention policy.
-   *
-   * - Removes completed jobs older than `jobRetention.completed`
-   * - Removes failed jobs older than `jobRetention.failed`
+   * Check if another active instance is using the same schedulerInstanceId.
+   * Uses heartbeat staleness to distinguish active instances from crashed ones.
    *
-   * The cleanup runs concurrently for both statuses if configured.
+   * Called after stale recovery to avoid false positives: stale recovery resets
+   * jobs with old `lockedAt`, so only jobs with recent heartbeats remain.
    *
-   * @returns Promise resolving when all deletion operations complete
+   * @throws {ConnectionError} If an active instance with the same ID is detected
    */
-  private cleanupJobs;
+  private checkInstanceCollision;
   /**
    * Enqueue a job for processing.
    *
@@ -932,6 +952,7 @@ declare class Monque extends EventEmitter {
    * @param options - Scheduling and deduplication options
    * @returns Promise resolving to the created or existing job document
    * @throws {ConnectionError} If database operation fails or scheduler not initialized
+   * @throws {PayloadTooLargeError} If payload exceeds configured `maxPayloadSize`
    *
    * @example Basic job enqueueing
    * ```typescript
@@ -957,6 +978,8 @@ declare class Monque extends EventEmitter {
    * });
    * // Subsequent enqueues with same uniqueKey return existing pending/processing job
    * ```
+   *
+   * @see {@link JobScheduler.enqueue}
    */
   enqueue<T>(name: string, data: T, options?: EnqueueOptions): Promise<PersistedJob<T>>;
   /**
@@ -986,6 +1009,8 @@ declare class Monque extends EventEmitter {
    * await monque.now('process-order', { orderId: order.id });
    * return order; // Return immediately, processing happens async
    * ```
+   *
+   * @see {@link JobScheduler.now}
    */
   now<T>(name: string, data: T): Promise<PersistedJob<T>>;
   /**
@@ -1008,6 +1033,7 @@ declare class Monque extends EventEmitter {
    * @returns Promise resolving to the created job document with `repeatInterval` set
    * @throws {InvalidCronError} If cron expression is invalid
    * @throws {ConnectionError} If database operation fails or scheduler not initialized
+   * @throws {PayloadTooLargeError} If payload exceeds configured `maxPayloadSize`
    *
    * @example Hourly cleanup job
    * ```typescript
@@ -1031,6 +1057,8 @@ declare class Monque extends EventEmitter {
    *   recipients: ['analytics@example.com']
    * });
    * ```
+   *
+   * @see {@link JobScheduler.schedule}
    */
   schedule<T>(cron: string, name: string, data: T, options?: ScheduleOptions): Promise<PersistedJob<T>>;
   /**
@@ -1049,6 +1077,8 @@ declare class Monque extends EventEmitter {
    * const job = await monque.enqueue('report', { type: 'daily' });
    * await monque.cancelJob(job._id.toString());
    * ```
+   *
+   * @see {@link JobManager.cancelJob}
    */
   cancelJob(jobId: string): Promise<PersistedJob<unknown> | null>;
   /**
@@ -1068,6 +1098,8 @@ declare class Monque extends EventEmitter {
    *   await monque.retryJob(job._id.toString());
    * });
    * ```
+   *
+   * @see {@link JobManager.retryJob}
    */
   retryJob(jobId: string): Promise<PersistedJob<unknown> | null>;
   /**
@@ -1085,6 +1117,8 @@ declare class Monque extends EventEmitter {
    * const nextHour = new Date(Date.now() + 60 * 60 * 1000);
    * await monque.rescheduleJob(jobId, nextHour);
    * ```
+   *
+   * @see {@link JobManager.rescheduleJob}
    */
   rescheduleJob(jobId: string, runAt: Date): Promise<PersistedJob<unknown> | null>;
   /**
@@ -1103,17 +1137,20 @@ declare class Monque extends EventEmitter {
    *   console.log('Job permanently removed');
    * }
    * ```
+   *
+   * @see {@link JobManager.deleteJob}
    */
   deleteJob(jobId: string): Promise<boolean>;
   /**
-   * Cancel multiple jobs matching the given filter.
+   * Cancel multiple jobs matching the given filter via a single updateMany call.
    *
-   * Only cancels jobs in 'pending' status. Jobs in other states are collected
-   * as errors in the result. Emits a 'jobs:cancelled' event with the IDs of
+   * Only cancels jobs in 'pending' status — the status guard is applied regardless
+   * of what the filter specifies. Jobs in other states are silently skipped (not
+   * matched by the query). Emits a 'jobs:cancelled' event with the count of
    * successfully cancelled jobs.
    *
    * @param filter - Selector for which jobs to cancel (name, status, date range)
-   * @returns Result with count of cancelled jobs and any errors encountered
+   * @returns Result with count of cancelled jobs (errors array always empty for bulk ops)
    *
    * @example Cancel all pending jobs for a queue
    * ```typescript
@@ -1123,17 +1160,20 @@ declare class Monque extends EventEmitter {
    * });
    * console.log(`Cancelled ${result.count} jobs`);
    * ```
+   *
+   * @see {@link JobManager.cancelJobs}
    */
   cancelJobs(filter: JobSelector): Promise<BulkOperationResult>;
   /**
-   * Retry multiple jobs matching the given filter.
+   * Retry multiple jobs matching the given filter via a single pipeline-style updateMany call.
    *
-   * Only retries jobs in 'failed' or 'cancelled' status. Jobs in other states
-   * are collected as errors in the result. Emits a 'jobs:retried' event with
-   * the IDs of successfully retried jobs.
+   * Only retries jobs in 'failed' or 'cancelled' status — the status guard is applied
+   * regardless of what the filter specifies. Jobs in other states are silently skipped.
+   * Uses `$rand` for per-document staggered `nextRunAt` to avoid thundering herd on retry.
+   * Emits a 'jobs:retried' event with the count of successfully retried jobs.
    *
    * @param filter - Selector for which jobs to retry (name, status, date range)
-   * @returns Result with count of retried jobs and any errors encountered
+   * @returns Result with count of retried jobs (errors array always empty for bulk ops)
    *
    * @example Retry all failed jobs
    * ```typescript
@@ -1142,12 +1182,15 @@ declare class Monque extends EventEmitter {
    * });
    * console.log(`Retried ${result.count} jobs`);
    * ```
+   *
+   * @see {@link JobManager.retryJobs}
    */
   retryJobs(filter: JobSelector): Promise<BulkOperationResult>;
   /**
    * Delete multiple jobs matching the given filter.
    *
    * Deletes jobs in any status. Uses a batch delete for efficiency.
+   * Emits a 'jobs:deleted' event with the count of deleted jobs.
    * Does not emit individual 'job:deleted' events to avoid noise.
    *
    * @param filter - Selector for which jobs to delete (name, status, date range)
@@ -1162,6 +1205,8 @@ declare class Monque extends EventEmitter {
    * });
    * console.log(`Deleted ${result.count} jobs`);
    * ```
+   *
+   * @see {@link JobManager.deleteJobs}
    */
   deleteJobs(filter: JobSelector): Promise<BulkOperationResult>;
   /**
@@ -1194,6 +1239,8 @@ declare class Monque extends EventEmitter {
    *   res.json(job);
    * });
    * ```
+   *
+   * @see {@link JobQueryService.getJob}
    */
   getJob<T = unknown>(id: ObjectId): Promise<PersistedJob<T> | null>;
   /**
@@ -1237,6 +1284,8 @@ declare class Monque extends EventEmitter {
    * const jobs = await monque.getJobs();
    * const pendingRecurring = jobs.filter(job => isPendingJob(job) && isRecurringJob(job));
    * ```
+   *
+   * @see {@link JobQueryService.getJobs}
    */
   getJobs<T = unknown>(filter?: GetJobsFilter): Promise<PersistedJob<T>[]>;
   /**
@@ -1267,6 +1316,8 @@ declare class Monque extends EventEmitter {
    *   });
    * }
    * ```
+   *
+   * @see {@link JobQueryService.getJobsWithCursor}
    */
   getJobsWithCursor<T = unknown>(options?: CursorOptions): Promise<CursorPage<T>>;
   /**
@@ -1275,6 +1326,9 @@ declare class Monque extends EventEmitter {
    * Uses MongoDB aggregation pipeline for efficient server-side calculation.
    * Returns counts per status and optional average processing duration for completed jobs.
    *
+   * Results are cached per unique filter with a configurable TTL (default 5s).
+   * Set `statsCacheTtlMs: 0` to disable caching.
+   *
    * @param filter - Optional filter to scope statistics by job name
    * @returns Promise resolving to queue statistics
    * @throws {AggregationTimeoutError} If aggregation exceeds 30 second timeout
@@ -1291,6 +1345,8 @@ declare class Monque extends EventEmitter {
    * const emailStats = await monque.getQueueStats({ name: 'send-email' });
    * console.log(`${emailStats.total} email jobs in queue`);
    * ```
+   *
+   * @see {@link JobQueryService.getQueueStats}
    */
   getQueueStats(filter?: Pick<JobSelector, 'name'>): Promise<QueueStats>;
   /**
@@ -1664,6 +1720,27 @@ declare class InvalidCursorError extends MonqueError {
 declare class AggregationTimeoutError extends MonqueError {
   constructor(message?: string);
 }
+/**
+ * Error thrown when a job payload exceeds the configured maximum BSON byte size.
+ *
+ * @example
+ * ```typescript
+ * const monque = new Monque(db, { maxPayloadSize: 1_000_000 }); // 1 MB
+ *
+ * try {
+ *   await monque.enqueue('job', hugePayload);
+ * } catch (error) {
+ *   if (error instanceof PayloadTooLargeError) {
+ *     console.error(`Payload ${error.actualSize} bytes exceeds limit ${error.maxSize} bytes`);
+ *   }
+ * }
+ * ```
+ */
+declare class PayloadTooLargeError extends MonqueError {
+  readonly actualSize: number;
+  readonly maxSize: number;
+  constructor(message: string, actualSize: number, maxSize: number);
+}
 //#endregion
 //#region src/shared/utils/backoff.d.ts
 /**
@@ -1753,5 +1830,5 @@ declare function getNextCronDate(expression: string, currentDate?: Date): Date;
  */
 declare function validateCronExpression(expression: string): void;
 //#endregion
-export { AggregationTimeoutError, type BulkOperationResult, ConnectionError, CursorDirection, type CursorOptions, type CursorPage, DEFAULT_BASE_INTERVAL, DEFAULT_MAX_BACKOFF_DELAY, type EnqueueOptions, type GetJobsFilter, InvalidCronError, InvalidCursorError, type Job, type JobHandler, type JobSelector, JobStateError, JobStatus, type JobStatusType, Monque, MonqueError, type MonqueEventMap, type MonqueOptions, type PersistedJob, type QueueStats, type ScheduleOptions, ShutdownTimeoutError, type WorkerOptions, WorkerRegistrationError, calculateBackoff, calculateBackoffDelay, getNextCronDate, isCancelledJob, isCompletedJob, isFailedJob, isPendingJob, isPersistedJob, isProcessingJob, isRecurringJob, isValidJobStatus, validateCronExpression };
+export { AggregationTimeoutError, type BulkOperationResult, ConnectionError, CursorDirection, type CursorOptions, type CursorPage, DEFAULT_BASE_INTERVAL, DEFAULT_MAX_BACKOFF_DELAY, type EnqueueOptions, type GetJobsFilter, InvalidCronError, InvalidCursorError, type Job, type JobHandler, type JobSelector, JobStateError, JobStatus, type JobStatusType, Monque, MonqueError, type MonqueEventMap, type MonqueOptions, PayloadTooLargeError, type PersistedJob, type QueueStats, type ScheduleOptions, ShutdownTimeoutError, type WorkerOptions, WorkerRegistrationError, calculateBackoff, calculateBackoffDelay, getNextCronDate, isCancelledJob, isCompletedJob, isFailedJob, isPendingJob, isPersistedJob, isProcessingJob, isRecurringJob, isValidJobStatus, validateCronExpression };
 //# sourceMappingURL=index.d.mts.map