@monque/core 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -438,7 +438,7 @@ interface MonqueEventMap {
  *
  * @example
  * ```typescript
- * monque.worker('send-email', emailHandler, {
+ * monque.register('send-email', emailHandler, {
  *   concurrency: 3,
  * });
  * ```
@@ -612,7 +612,7 @@ type EmailJob = {};
 *   body: string
 * }
  *
- * monque.worker<EmailJob>('send-email', async (job) =>
+ * monque.register<EmailJob>('send-email', async (job) =>
 {
     *   await emailService.send(job.data.to, job.data.subject, job.data.body)
     *
@@ -878,7 +878,7 @@ declare class Monque extends EventEmitter {
    *   body: string;
    * }
    *
-   * monque.worker<EmailJob>('send-email', async (job) => {
+   * monque.register<EmailJob>('send-email', async (job) => {
    *   await emailService.send(job.data.to, job.data.subject, job.data.body);
    * });
    * ```
@@ -886,7 +886,7 @@ declare class Monque extends EventEmitter {
    * @example Worker with custom concurrency
    * ```typescript
    * // Limit to 2 concurrent video processing jobs (resource-intensive)
-   * monque.worker('process-video', async (job) => {
+   * monque.register('process-video', async (job) => {
    *   await videoProcessor.transcode(job.data.videoId);
    * }, { concurrency: 2 });
    * ```
@@ -894,12 +894,12 @@ declare class Monque extends EventEmitter {
    * @example Replacing an existing worker
    * ```typescript
    * // Replace the existing handler for 'send-email'
-   * monque.worker('send-email', newEmailHandler, { replace: true });
+   * monque.register('send-email', newEmailHandler, { replace: true });
    * ```
    *
    * @example Worker with error handling
    * ```typescript
-   * monque.worker('sync-user', async (job) => {
+   * monque.register('sync-user', async (job) => {
    *   try {
    *     await externalApi.syncUser(job.data.userId);
    *   } catch (error) {
@@ -910,7 +910,7 @@ declare class Monque extends EventEmitter {
    * });
    * ```
    */
-  worker<T>(name: string, handler: JobHandler<T>, options?: WorkerOptions): void;
+  register<T>(name: string, handler: JobHandler<T>, options?: WorkerOptions): void;
   /**
    * Start polling for and processing jobs.
    *
@@ -926,8 +926,8 @@ declare class Monque extends EventEmitter {
    * const monque = new Monque(db);
    * await monque.initialize();
    *
-   * monque.worker('send-email', emailHandler);
-   * monque.worker('process-order', orderHandler);
+   * monque.register('send-email', emailHandler);
+   * monque.register('process-order', orderHandler);
    *
    * monque.start(); // Begin processing jobs
    * ```
@@ -1116,6 +1116,7 @@ declare class Monque extends EventEmitter {
    *
    * Called at regular intervals (configured by `pollInterval`). For each registered worker,
    * attempts to acquire jobs up to the worker's available concurrency slots.
+   * Aborts early if the scheduler is stopping (`isRunning` is false).
    *
    * @private
    */
@@ -1129,6 +1130,8 @@ declare class Monque extends EventEmitter {
    * - Has nextRunAt <= now
    * - Is not claimed by another instance (claimedBy is null/undefined)
    *
+   * Returns `null` immediately if scheduler is stopping (`isRunning` is false).
+   *
    * @private
    * @param name - The job type to acquire
    * @returns The acquired job with updated status, claimedBy, and heartbeat info, or `null` if no jobs available
@@ -1351,8 +1354,8 @@ declare class ShutdownTimeoutError extends MonqueError {
  * @example
  * ```typescript
  * try {
- *   monque.worker('send-email', handler1);
- *   monque.worker('send-email', handler2); // throws
+ *   monque.register('send-email', handler1);
+ *   monque.register('send-email', handler2); // throws
  * } catch (error) {
  *   if (error instanceof WorkerRegistrationError) {
  *     console.error('Worker already registered for:', error.jobName);
@@ -1360,7 +1363,7 @@ declare class ShutdownTimeoutError extends MonqueError {
  * }
  *
  * // To intentionally replace a worker:
- * monque.worker('send-email', handler2, { replace: true });
+ * monque.register('send-email', handler2, { replace: true });
  * ```
  */
 declare class WorkerRegistrationError extends MonqueError {

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","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"],"sourcesContent":[],"mappings":";;;;;;;;AAkBA;AAcA;AA0BA;;;;;;;;;;AAgEA;AAA4C,cAxG/B,SAwG+B,EAAA;EAAJ;EAAgB,SAAA,OAAA,EAAA,SAAA;EAAQ;EAa/C,SAAA,UAAc,EAAA,YAUlB;EAaI;EA6BA,SAAA,SAAa,EAAA,WAKpB;EAqBE;EAAoC,SAAA,MAAA,EAAA,QAAA;CAAJ;;;;KArLhC,aAAA,WAAwB,wBAAwB;;ACI5D;;;;;;AAoCA;AA4BA;AAqBA;AAqBA;AAyBA;AA6BA;;;;AC/LA;;;;;;;;AAiDc,UFIG,GEJH,CAAA,IAAA,OAAA,CAAA,CAAA;;QFMP;;EGhDU,IAAA,EAAA,MAAA;;QHsDV;;EInDU,MAAA,EJsDR,aItDqB;;aJyDlB;;EK+DC,QAAA,CAAO,EL5DR,IK4DQ,GAAA,IAAA;EA8CH;;;;;EA2O4E,SAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAb;;;;;EA8F1C,aAAA,CAAA,ELrarB,IKqaqB,GAAA,IAAA;EAmD9B;;;;EAEJ,iBAAA,CAAA,EAAA,MAAA;EAwIyC;EAAX,SAAA,EAAA,MAAA;EAAwB;EAgJ3C,UAAA,CAAA,EAAA,MAAA;EA+KqB;EAA0C,cAAA,CAAA,EAAA,MAAA;EAAb;EAAR,SAAA,CAAA,EAAA,MAAA;EAqE1B;EAAgC,SAAA,ELj9BnD,IKi9BmD;EAAb;EAAR,SAAA,EL98B9B,IK88B8B;;;;;;;;AAkkBL,KLvgDzB,YKugDyB,CAAA,IAAA,OAAA,CAAA,GLvgDG,GKugDH,CLvgDO,CKugDP,CAAA,GAAA;EAKN,GAAA,EL5gDyB,QK4gDzB;CACtB;;;;;;;;;;;;ACvnDI,UNuHI,cAAA,CMvHgB;EA0BpB;AA4Bb;AA6BA;;EAGkC,SAAA,CAAA,EAAA,MAAA;EAHQ;;AAiC1C;UNaS;;;AO7IT;AASA;AA2BA;AAuBA;;;;ACpCA;AAsBA;UR6GiB,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA6BA,aAAA;;;;WAKP,gBAAgB;;;;;;;;;;;;;;;;;;KAqBd,gCAAgC,IAAI,OAAO;;;;;;AAnMvD;AAcA;AA0BA;;;;;;;;;;AAgEA;;;;;AAaA;AAuBA;AA6BA;AA0BA;;;;;;;;ACjLA;;AAAuC,iBAAvB,cAAuB,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,GAAA,CAAI,CAAJ,CAAA,CAAA,EAAA,GAAA,IAAgB,YAAhB,CAA6B,CAA7B,CAAA;;;;AAoCvC;AA4BA;AAqBA;AAqBA;AAyBA;AA6BA;;;;AC/LA;;;;;;;;;;;;ACOA;;;;ACGA;;;;ACwHa,iBJ/DG,gBAAA,CI+DI,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IJ/DuC,aI+DvC;;;;;;;;;;;;;;;;;;;;;;;;;AAm3BqC,iBJt5BzC,YIs5ByC,CAAA,CAAA,CAAA,CAAA,GAAA,EJt5BpB,GIs5BoB,CJt5BhB,CIs5BgB,CAAA,CAAA,EAAA,OAAA;;;;;;;;;;;;;;;;;;AAopBhD,iBJrhDO,eIqhDP,CAAA,CAAA,CAAA,CAAA,GAAA,EJrhD+B,GIqhD/B,CJrhDmC,CIqhDnC,CAAA,CAAA,EAAA,OAAA;;;;;;;;AC9nDT;AA0BA;AA4BA;AA6BA;;;;;AAiCA;;iBLUgB,uBAAuB,IAAI;;AM1I3C;AASA;AA2BA;AAuBA;;;;ACpCA;AAsBA;;;;;;;;;;;;iBPsHgB,oBAAoB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BxB,uBAAuB,IAAI;;;;;;ADlL9B,UEbI,cAAA,CFsBP;EAKE;AA0BZ;;EAQO,WAAA,EEzDO,GFyDP;EAGE;;;EAoBQ,cAAA,EAAA;IAqBL,GAAA,EE/FL,GF+FK;IAGA;IAAI,QAAA,EAAA,MAAA;EASJ,CAAA;EAAgC;;;EAAoB,UAAA,EAAA;IAa/C,GAAA,EE/GV,GF+GU;IAuBA,KAAA,EErIR,KFqIQ;IA6BA;IA0BL,SAAU,EAAA,OAAA;EAA0B,CAAA;EAAJ;;;;WEnLnC;UACD;EDCQ,CAAA;EAA2B;;;EAAY,iBAAA,EAAA;IAAY,KAAA,EAAA,MAAA;EAoCnD,CAAA;EA4BA;AAqBhB;AAqBA;EAyBgB,wBAAW,EAAA,SAAY;EA6BvB;;;;IC/LC,KAAA,EAiDR,KAjDQ;EAIH,CAAA;EAMP;;;EAmBE,qBAAA,EAAA,SAAA;EACD;;;;;;ACvBR;;;;;;AHMA;AAcA;AA0BA;;;;;AAiBY,UG/DK,aAAA,CH+DL;EAcK;;;;EAiCL,WAAA,CAAA,EAAA,MAAY;EAAoB;;;;AAa5C;EAuBiB,OAAA,CAAA,EAAA,OAAA;AA6BjB;;;;;;;AAzKA;AAcA;AA0BA;;;;;;;;;AAuDgB,UIlGC,aAAA,CJkGD;EASJ;;;;EAAoD,cAAA,CAAA,EAAA,MAAA;EAa/C;AAuBjB;AA6BA;AA0BA;EAAgD,YAAA,CAAA,EAAA,MAAA;EAAJ;;;;;;ACjL5C;;;;EAAuD,iBAAA,CAAA,EAAA,MAAA;EAAY;AAoCnE;AA4BA;AAqBA;AAqBA;AAyBA;AA6BA;;;;AC/LA;;EAUO,eAAA,CAAA,EAAA,MAAA;EASA;;;;EA8BE,kBAAA,CAAA,EAAA,MAAA;EAAK;;;;AC1Cd;;;;ECGiB,WAAA,CAAA,EAAA,MAAa;;;;ACwH9B;;;EAuEqB,mBAAA,CAAA,EAAA,MAAA;EAkNiB;;;;;;;;EA8FA,iBAAA,CAAA,EAAA,MAAA;EAmD9B;;;;;EA0IqC,gBAAA,CAAA,EAAA,OAAA;EAAX;;;;EA+T4C,YAAA,CAAA,EAAA;IAAb;;;;IAqEf,SAAA,CAAA,EAAA,MAAA;IAAR;;;;IA4jBuC,MAAA,CAAA,EAAA,MAAA;IAIpD;;;;IAOE,QAAA,CAAA,EAAA,MAAA;EACtB,CAAA,GAAA,SAAA;;;;AL7kDT;;;;;;;;;;AAgEA;;;;;AAaA;AAuBA;AA6BA;AA0BA;;;;;;;;ACjLA;;;;;;AAoCA;AA4BA;AAqBA;AAqBA;AAyBA;AA6BA;;;;AC/LA;;;;;;;;;;;;ACOA;;;;ACGA;;;;ACwHA;;;;;;;;;;;;;;;;;;;;;;AAm3BoC,cAn3BvB,MAAA,SAAe,YAAA,CAm3BQ;EAA0C,iBAAA,EAAA;EAAb,iBAAA,OAAA;EAAR,QAAA,UAAA;EAqE1B,QAAA,OAAA;EAAgC,QAAA,cAAA;EAAb,QAAA,mBAAA;EAAR,QAAA,iBAAA;EA4jBX,QAAA,SAAA;EAAuB,QAAA,aAAA;EAAY;;;;EAM5C,QAAA,YAAA;EAAe;;;;EAOA,QAAA,6BAAA;EAKP;;;EAEO,iBAAA,gCAAA;EAxgDT;;;;;ECvHf;AA0Bb;AA4BA;EA6Ba,QAAA,kBAAqB;EAGA;;;;EA8BrB,QAAA,0BAAwB;kBDiDpB,cAAa;;;AEjL9B;AASA;AA2BA;AAuBA;gBF+IqB;;;AGnLrB;AAsBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCH+WsC,aAAY,iBAAsB,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA8F3D,IAAI,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAmDnD,aACG,kBACP,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAwIS,WAAW,cAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAgJ3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA+KqB,gBAAqB,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAqE/C,WAAW,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA4jBhC,uBAAuB,YAAY,eAAe;qBAIpD,uBACpB,uBACa,eAAe;uBAKN,uBACtB,uBACa,eAAe;sBAKP,uBACrB,uBACa,eAAe;;;;;;;AL7nDrC;AAcA;AA0BA;;;;;;;;;AAuDgB,cMjGH,WAAA,SAAoB,KAAA,CNiGjB;EASJ,WAAA,CAAA,OAAY,EAAA,MAAA;;;;;AAaxB;AAuBA;AA6BA;AA0BA;;;;;;;;ACjLgB,cKMH,gBAAA,SAAyB,WAAA,CLNR;EAAa,SAAA,UAAA,EAAA,MAAA;EAAJ,WAAA,CAAA,UAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA;;;;AAoCvC;AA4BA;AAqBA;AAqBA;AAyBA;AA6BA;;;;AC/LA;;;AAmBO,cI8CM,eAAA,SAAwB,WAAA,CJ9C9B;EACE,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAUD,CAVC,EAAA;IASA,KAAA,CAAA,EIqCyC,KJrCzC;EACD,CAAA;;;;;;ACvBR;;;;ACGA;;;;ACwHA;;;AAuEqB,cC3GR,oBAAA,SAA6B,WAAA,CD2GrB;EAkNiB,SAAA,cAAA,EC1TJ,GD0TI,EAAA;EAAY,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,cAAA,EC1ThB,GD0TgB,EAAA;;;;;;;;;;;;;;;;;;;;;AA+pBnB,cC37BlB,uBAAA,SAAgC,WAAA,CD27Bd;EAAgC,SAAA,OAAA,EAAA,MAAA;EAAb,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA;;;;;;;;AL7iCrC,cOdA,qBAAA,GPuBH,IAAA;AAKV;AA0BA;;;;;;AA+BiB,cO5EJ,yBP4EI,EAAA,MAAA;;;;AAiCjB;;;;;AAaA;AAuBA;AA6BA;AA0BA;;;;;;;;ACjLA;;;;;;AAoCgB,iBMhCA,gBAAA,CNgC2C,SAAa,EAAA,MAAA,EAAA,YAAA,CAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EM5BrE,IN4BqE;AA4BxE;AAqBA;AAqBA;AAyBA;AA6BA;;;;AC/LiB,iBK0DD,qBAAA,CL1De,SAAA,EAAA,MAAA,EAAA,YAAA,CAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;;;;;AFa/B;AAcA;AA0BA;;;;;;;;;;AAgEA;;;;;AAaA;AAuBA;AA6BiB,iBQhKD,eAAA,CRqKN,UAAgB,EAAA,MAAA,EAAa,WAAA,CAAA,EQrK2B,IRqK3B,CAAA,EQrKkC,IRqKlC;AAqBvC;;;;;;;;ACjLA;;;AAAoE,iBOapD,sBAAA,CPboD,UAAA,EAAA,MAAA,CAAA,EAAA,IAAA"}
+{"version":3,"file":"index.d.mts","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"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as WorkerRegistrationError, i as ShutdownTimeoutError, n as InvalidCronError, r as MonqueError, t as ConnectionError } from "./errors-DW20rHWR.mjs";
+import { a as WorkerRegistrationError, i as ShutdownTimeoutError, n as InvalidCronError, r as MonqueError, t as ConnectionError } from "./errors-DQ2_gprw.mjs";
 import { randomUUID } from "node:crypto";
 import { EventEmitter } from "node:events";
 import { CronExpressionParser } from "cron-parser";
@@ -396,7 +396,7 @@ type EmailJob = {};
 *   body: string
 * }
 *
-* monque.worker<EmailJob>('send-email', async (job) =>
+* monque.register<EmailJob>('send-email', async (job) =>
 {
 *   await emailService.send(job.data.to, job.data.subject, job.data.body)
 *
@@ -845,7 +845,7 @@ var Monque = class extends EventEmitter {
 	*   body: string;
 	* }
 	*
-	* monque.worker<EmailJob>('send-email', async (job) => {
+	* monque.register<EmailJob>('send-email', async (job) => {
 	*   await emailService.send(job.data.to, job.data.subject, job.data.body);
 	* });
 	* ```
@@ -853,7 +853,7 @@ var Monque = class extends EventEmitter {
 	* @example Worker with custom concurrency
 	* ```typescript
 	* // Limit to 2 concurrent video processing jobs (resource-intensive)
-	* monque.worker('process-video', async (job) => {
+	* monque.register('process-video', async (job) => {
 	*   await videoProcessor.transcode(job.data.videoId);
 	* }, { concurrency: 2 });
 	* ```
@@ -861,12 +861,12 @@ var Monque = class extends EventEmitter {
 	* @example Replacing an existing worker
 	* ```typescript
 	* // Replace the existing handler for 'send-email'
-	* monque.worker('send-email', newEmailHandler, { replace: true });
+	* monque.register('send-email', newEmailHandler, { replace: true });
 	* ```
 	*
 	* @example Worker with error handling
 	* ```typescript
-	* monque.worker('sync-user', async (job) => {
+	* monque.register('sync-user', async (job) => {
 	*   try {
 	*     await externalApi.syncUser(job.data.userId);
 	*   } catch (error) {
@@ -877,7 +877,7 @@ var Monque = class extends EventEmitter {
 	* });
 	* ```
 	*/
-	worker(name, handler, options = {}) {
+	register(name, handler, options = {}) {
 		const concurrency = options.concurrency ?? this.options.defaultConcurrency;
 		if (this.workers.has(name) && options.replace !== true) throw new WorkerRegistrationError(`Worker already registered for job name "${name}". Use { replace: true } to replace.`, name);
 		this.workers.set(name, {
@@ -901,8 +901,8 @@ var Monque = class extends EventEmitter {
 	* const monque = new Monque(db);
 	* await monque.initialize();
 	*
-	* monque.worker('send-email', emailHandler);
-	* monque.worker('process-order', orderHandler);
+	* monque.register('send-email', emailHandler);
+	* monque.register('process-order', orderHandler);
 	*
 	* monque.start(); // Begin processing jobs
 	* ```
@@ -1037,7 +1037,7 @@ var Monque = class extends EventEmitter {
 		}
 		if (result === "timeout") {
 			const incompleteJobs = this.getActiveJobsList();
-			const { ShutdownTimeoutError: ShutdownTimeoutError$1 } = await import("./errors-DWkXsP3R.mjs");
+			const { ShutdownTimeoutError: ShutdownTimeoutError$1 } = await import("./errors-DEvnqoOC.mjs");
 			const error = new ShutdownTimeoutError$1(`Shutdown timed out after ${this.options.shutdownTimeout}ms with ${incompleteJobs.length} incomplete jobs`, incompleteJobs);
 			this.emit("job:error", { error });
 		}
@@ -1195,6 +1195,7 @@ var Monque = class extends EventEmitter {
 	*
 	* Called at regular intervals (configured by `pollInterval`). For each registered worker,
 	* attempts to acquire jobs up to the worker's available concurrency slots.
+	* Aborts early if the scheduler is stopping (`isRunning` is false).
 	*
 	* @private
 	*/
@@ -1204,6 +1205,7 @@ var Monque = class extends EventEmitter {
 			const availableSlots = worker.concurrency - worker.activeJobs.size;
 			if (availableSlots <= 0) continue;
 			for (let i = 0; i < availableSlots; i++) {
+				if (!this.isRunning) return;
 				const job = await this.acquireJob(name);
 				if (job) this.processJob(job, worker).catch((error) => {
 					this.emit("job:error", {
@@ -1224,12 +1226,14 @@ var Monque = class extends EventEmitter {
 	* - Has nextRunAt <= now
 	* - Is not claimed by another instance (claimedBy is null/undefined)
 	*
+	* Returns `null` immediately if scheduler is stopping (`isRunning` is false).
+	*
 	* @private
 	* @param name - The job type to acquire
 	* @returns The acquired job with updated status, claimedBy, and heartbeat info, or `null` if no jobs available
 	*/
 	async acquireJob(name) {
-		if (!this.collection) return null;
+		if (!this.collection || !this.isRunning) return null;
 		const now = /* @__PURE__ */ new Date();
 		const result = await this.collection.findOneAndUpdate({
 			name,