@monque/core 1.0.0 → 1.1.1

package/src/shared/utils/backoff.ts

@@ -0,0 +1,77 @@
+/**
+ * Default base interval for exponential backoff in milliseconds.
+ * @default 1000
+ */
+export const DEFAULT_BASE_INTERVAL = 1000;
+
+/**
+ * Default maximum delay cap for exponential backoff in milliseconds.
+ *
+ * This prevents unbounded delays (e.g. failCount=20 is >11 days at 1s base)
+ * and avoids precision/overflow issues for very large fail counts.
+ * @default 86400000 (24 hours)
+ */
+export const DEFAULT_MAX_BACKOFF_DELAY = 24 * 60 * 60 * 1_000;
+
+/**
+ * Calculate the next run time using exponential backoff.
+ *
+ * Formula: nextRunAt = now + (2^failCount × baseInterval)
+ *
+ * @param failCount - Number of previous failed attempts
+ * @param baseInterval - Base interval in milliseconds (default: 1000ms)
+ * @param maxDelay - Maximum delay in milliseconds (optional)
+ * @returns The next run date
+ *
+ * @example
+ * ```typescript
+ * // First retry (failCount=1): 2^1 * 1000 = 2000ms delay
+ * const nextRun = calculateBackoff(1);
+ *
+ * // Second retry (failCount=2): 2^2 * 1000 = 4000ms delay
+ * const nextRun = calculateBackoff(2);
+ *
+ * // With custom base interval
+ * const nextRun = calculateBackoff(3, 500); // 2^3 * 500 = 4000ms delay
+ *
+ * // With max delay
+ * const nextRun = calculateBackoff(10, 1000, 60000); // capped at 60000ms
+ * ```
+ */
+export function calculateBackoff(
+	failCount: number,
+	baseInterval: number = DEFAULT_BASE_INTERVAL,
+	maxDelay?: number,
+): Date {
+	const effectiveMaxDelay = maxDelay ?? DEFAULT_MAX_BACKOFF_DELAY;
+	let delay = 2 ** failCount * baseInterval;
+
+	if (delay > effectiveMaxDelay) {
+		delay = effectiveMaxDelay;
+	}
+
+	return new Date(Date.now() + delay);
+}
+
+/**
+ * Calculate just the delay in milliseconds for a given fail count.
+ *
+ * @param failCount - Number of previous failed attempts
+ * @param baseInterval - Base interval in milliseconds (default: 1000ms)
+ * @param maxDelay - Maximum delay in milliseconds (optional)
+ * @returns The delay in milliseconds
+ */
+export function calculateBackoffDelay(
+	failCount: number,
+	baseInterval: number = DEFAULT_BASE_INTERVAL,
+	maxDelay?: number,
+): number {
+	const effectiveMaxDelay = maxDelay ?? DEFAULT_MAX_BACKOFF_DELAY;
+	let delay = 2 ** failCount * baseInterval;
+
+	if (delay > effectiveMaxDelay) {
+		delay = effectiveMaxDelay;
+	}
+
+	return delay;
+}

package/src/shared/utils/cron.ts

@@ -0,0 +1,67 @@
+import { CronExpressionParser } from 'cron-parser';
+
+import { InvalidCronError } from '../errors.js';
+
+/**
+ * Parse a cron expression and return the next scheduled run date.
+ *
+ * @param expression - A 5-field cron expression (minute hour day-of-month month day-of-week) or a predefined expression
+ * @param currentDate - The reference date for calculating next run (default: now)
+ * @returns The next scheduled run date
+ * @throws {InvalidCronError} If the cron expression is invalid
+ *
+ * @example
+ * ```typescript
+ * // Every minute
+ * const nextRun = getNextCronDate('* * * * *');
+ *
+ * // Every day at midnight
+ * const nextRun = getNextCronDate('0 0 * * *');
+ *
+ * // Using predefined expression
+ * const nextRun = getNextCronDate('@daily');
+ *
+ * // Every Monday at 9am
+ * const nextRun = getNextCronDate('0 9 * * 1');
+ * ```
+ */
+export function getNextCronDate(expression: string, currentDate?: Date): Date {
+	try {
+		const interval = CronExpressionParser.parse(expression, {
+			currentDate: currentDate ?? new Date(),
+		});
+		return interval.next().toDate();
+	} catch (error) {
+		handleCronParseError(expression, error);
+	}
+}
+
+/**
+ * Validate a cron expression without calculating the next run date.
+ *
+ * @param expression - A 5-field cron expression
+ * @throws {InvalidCronError} If the cron expression is invalid
+ *
+ * @example
+ * ```typescript
+ * validateCronExpression('0 9 * * 1'); // Throws if invalid
+ * ```
+ */
+export function validateCronExpression(expression: string): void {
+	try {
+		CronExpressionParser.parse(expression);
+	} catch (error) {
+		handleCronParseError(expression, error);
+	}
+}
+
+function handleCronParseError(expression: string, error: unknown): never {
+	/* istanbul ignore next -- @preserve cron-parser always throws Error objects */
+	const errorMessage = error instanceof Error ? error.message : 'Unknown parsing error';
+	throw new InvalidCronError(
+		expression,
+		`Invalid cron expression "${expression}": ${errorMessage}. ` +
+			'Expected 5-field format: "minute hour day-of-month month day-of-week" or predefined expression (e.g. @daily). ' +
+			'Example: "0 9 * * 1" (every Monday at 9am)',
+	);
+}

package/src/shared/utils/index.ts

@@ -0,0 +1,7 @@
+export {
+	calculateBackoff,
+	calculateBackoffDelay,
+	DEFAULT_BASE_INTERVAL,
+	DEFAULT_MAX_BACKOFF_DELAY,
+} from './backoff.js';
+export { getNextCronDate, validateCronExpression } from './cron.js';

package/src/workers/index.ts

@@ -0,0 +1 @@
+export type { WorkerOptions, WorkerRegistration } from './types.js';

package/src/workers/types.ts

@@ -0,0 +1,39 @@
+import type { JobHandler, PersistedJob } from '@/jobs';
+
+/**
+ * Options for registering a worker.
+ *
+ * @example
+ * ```typescript
+ * monque.register('send-email', emailHandler, {
+ *   concurrency: 3,
+ * });
+ * ```
+ */
+export interface WorkerOptions {
+	/**
+	 * Number of concurrent jobs this worker can process.
+	 * @default 5 (uses defaultConcurrency from MonqueOptions)
+	 */
+	concurrency?: number;
+
+	/**
+	 * Allow replacing an existing worker for the same job name.
+	 * If false (default) and a worker already exists, throws WorkerRegistrationError.
+	 * @default false
+	 */
+	replace?: boolean;
+}
+
+/**
+ * Internal worker registration with handler and options.
+ * Tracks the handler, concurrency limit, and currently active jobs.
+ */
+export interface WorkerRegistration<T = unknown> {
+	/** The job handler function */
+	handler: JobHandler<T>;
+	/** Maximum concurrent jobs for this worker */
+	concurrency: number;
+	/** Map of active job IDs to their job data */
+	activeJobs: Map<string, PersistedJob<T>>;
+}

package/dist/errors-D5ZGG2uI.cjs

@@ -1,155 +0,0 @@
-
-//#region src/shared/errors.ts
-/**
-* Base error class for all Monque-related errors.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.enqueue('job', data);
-* } catch (error) {
-*   if (error instanceof MonqueError) {
-*     console.error('Monque error:', error.message);
-*   }
-* }
-* ```
-*/
-var MonqueError = class MonqueError extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "MonqueError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, MonqueError);
-	}
-};
-/**
-* Error thrown when an invalid cron expression is provided.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.schedule('invalid cron', 'job', data);
-* } catch (error) {
-*   if (error instanceof InvalidCronError) {
-*     console.error('Invalid expression:', error.expression);
-*   }
-* }
-* ```
-*/
-var InvalidCronError = class InvalidCronError extends MonqueError {
-	constructor(expression, message) {
-		super(message);
-		this.expression = expression;
-		this.name = "InvalidCronError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, InvalidCronError);
-	}
-};
-/**
-* Error thrown when there's a database connection issue.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.enqueue('job', data);
-* } catch (error) {
-*   if (error instanceof ConnectionError) {
-*     console.error('Database connection lost');
-*   }
-* }
-* ```
-*/
-var ConnectionError = class ConnectionError extends MonqueError {
-	constructor(message, options) {
-		super(message);
-		this.name = "ConnectionError";
-		if (options?.cause) this.cause = options.cause;
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, ConnectionError);
-	}
-};
-/**
-* Error thrown when graceful shutdown times out.
-* Includes information about jobs that were still in progress.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.stop();
-* } catch (error) {
-*   if (error instanceof ShutdownTimeoutError) {
-*     console.error('Incomplete jobs:', error.incompleteJobs.length);
-*   }
-* }
-* ```
-*/
-var ShutdownTimeoutError = class ShutdownTimeoutError extends MonqueError {
-	constructor(message, incompleteJobs) {
-		super(message);
-		this.incompleteJobs = incompleteJobs;
-		this.name = "ShutdownTimeoutError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, ShutdownTimeoutError);
-	}
-};
-/**
-* Error thrown when attempting to register a worker for a job name
-* that already has a registered worker, without explicitly allowing replacement.
-*
-* @example
-* ```typescript
-* try {
-*   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);
-*   }
-* }
-*
-* // To intentionally replace a worker:
-* monque.register('send-email', handler2, { replace: true });
-* ```
-*/
-var WorkerRegistrationError = class WorkerRegistrationError extends MonqueError {
-	constructor(message, jobName) {
-		super(message);
-		this.jobName = jobName;
-		this.name = "WorkerRegistrationError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, WorkerRegistrationError);
-	}
-};
-
-//#endregion
-Object.defineProperty(exports, 'ConnectionError', {
-  enumerable: true,
-  get: function () {
-    return ConnectionError;
-  }
-});
-Object.defineProperty(exports, 'InvalidCronError', {
-  enumerable: true,
-  get: function () {
-    return InvalidCronError;
-  }
-});
-Object.defineProperty(exports, 'MonqueError', {
-  enumerable: true,
-  get: function () {
-    return MonqueError;
-  }
-});
-Object.defineProperty(exports, 'ShutdownTimeoutError', {
-  enumerable: true,
-  get: function () {
-    return ShutdownTimeoutError;
-  }
-});
-Object.defineProperty(exports, 'WorkerRegistrationError', {
-  enumerable: true,
-  get: function () {
-    return WorkerRegistrationError;
-  }
-});
-//# sourceMappingURL=errors-D5ZGG2uI.cjs.map

package/dist/errors-D5ZGG2uI.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-D5ZGG2uI.cjs","names":[],"sources":["../src/shared/errors.ts"],"sourcesContent":["import type { Job } from '@/jobs';\n\n/**\n * Base error class for all Monque-related errors.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.enqueue('job', data);\n * } catch (error) {\n *   if (error instanceof MonqueError) {\n *     console.error('Monque error:', error.message);\n *   }\n * }\n * ```\n */\nexport class MonqueError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = 'MonqueError';\n\t\t// Maintains proper stack trace for where our error was thrown (only available on V8)\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, MonqueError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when an invalid cron expression is provided.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.schedule('invalid cron', 'job', data);\n * } catch (error) {\n *   if (error instanceof InvalidCronError) {\n *     console.error('Invalid expression:', error.expression);\n *   }\n * }\n * ```\n */\nexport class InvalidCronError extends MonqueError {\n\tconstructor(\n\t\tpublic readonly expression: string,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'InvalidCronError';\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, InvalidCronError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when there's a database connection issue.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.enqueue('job', data);\n * } catch (error) {\n *   if (error instanceof ConnectionError) {\n *     console.error('Database connection lost');\n *   }\n * }\n * ```\n */\nexport class ConnectionError extends MonqueError {\n\tconstructor(message: string, options?: { cause?: Error }) {\n\t\tsuper(message);\n\t\tthis.name = 'ConnectionError';\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, ConnectionError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when graceful shutdown times out.\n * Includes information about jobs that were still in progress.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.stop();\n * } catch (error) {\n *   if (error instanceof ShutdownTimeoutError) {\n *     console.error('Incomplete jobs:', error.incompleteJobs.length);\n *   }\n * }\n * ```\n */\nexport class ShutdownTimeoutError extends MonqueError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly incompleteJobs: Job[],\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'ShutdownTimeoutError';\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, ShutdownTimeoutError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when attempting to register a worker for a job name\n * that already has a registered worker, without explicitly allowing replacement.\n *\n * @example\n * ```typescript\n * try {\n *   monque.register('send-email', handler1);\n *   monque.register('send-email', handler2); // throws\n * } catch (error) {\n *   if (error instanceof WorkerRegistrationError) {\n *     console.error('Worker already registered for:', error.jobName);\n *   }\n * }\n *\n * // To intentionally replace a worker:\n * monque.register('send-email', handler2, { replace: true });\n * ```\n */\nexport class WorkerRegistrationError extends MonqueError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly jobName: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'WorkerRegistrationError';\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, WorkerRegistrationError);\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,IAAa,cAAb,MAAa,oBAAoB,MAAM;CACtC,YAAY,SAAiB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO;;AAGZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,YAAY;;;;;;;;;;;;;;;;;AAmB7C,IAAa,mBAAb,MAAa,yBAAyB,YAAY;CACjD,YACC,AAAgB,YAChB,SACC;AACD,QAAM,QAAQ;EAHE;AAIhB,OAAK,OAAO;;AAEZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,iBAAiB;;;;;;;;;;;;;;;;;AAmBlD,IAAa,kBAAb,MAAa,wBAAwB,YAAY;CAChD,YAAY,SAAiB,SAA6B;AACzD,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,MAAI,SAAS,MACZ,MAAK,QAAQ,QAAQ;;AAGtB,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;AAoBjD,IAAa,uBAAb,MAAa,6BAA6B,YAAY;CACrD,YACC,SACA,AAAgB,gBACf;AACD,QAAM,QAAQ;EAFE;AAGhB,OAAK,OAAO;;AAEZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;AAwBtD,IAAa,0BAAb,MAAa,gCAAgC,YAAY;CACxD,YACC,SACA,AAAgB,SACf;AACD,QAAM,QAAQ;EAFE;AAGhB,OAAK,OAAO;;AAEZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,wBAAwB"}

package/dist/errors-DEvnqoOC.mjs

@@ -1,3 +0,0 @@
-import { a as WorkerRegistrationError, i as ShutdownTimeoutError, n as InvalidCronError, r as MonqueError, t as ConnectionError } from "./errors-DQ2_gprw.mjs";
-
-export { ShutdownTimeoutError };

package/dist/errors-DQ2_gprw.mjs

@@ -1,125 +0,0 @@
-//#region src/shared/errors.ts
-/**
-* Base error class for all Monque-related errors.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.enqueue('job', data);
-* } catch (error) {
-*   if (error instanceof MonqueError) {
-*     console.error('Monque error:', error.message);
-*   }
-* }
-* ```
-*/
-var MonqueError = class MonqueError extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "MonqueError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, MonqueError);
-	}
-};
-/**
-* Error thrown when an invalid cron expression is provided.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.schedule('invalid cron', 'job', data);
-* } catch (error) {
-*   if (error instanceof InvalidCronError) {
-*     console.error('Invalid expression:', error.expression);
-*   }
-* }
-* ```
-*/
-var InvalidCronError = class InvalidCronError extends MonqueError {
-	constructor(expression, message) {
-		super(message);
-		this.expression = expression;
-		this.name = "InvalidCronError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, InvalidCronError);
-	}
-};
-/**
-* Error thrown when there's a database connection issue.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.enqueue('job', data);
-* } catch (error) {
-*   if (error instanceof ConnectionError) {
-*     console.error('Database connection lost');
-*   }
-* }
-* ```
-*/
-var ConnectionError = class ConnectionError extends MonqueError {
-	constructor(message, options) {
-		super(message);
-		this.name = "ConnectionError";
-		if (options?.cause) this.cause = options.cause;
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, ConnectionError);
-	}
-};
-/**
-* Error thrown when graceful shutdown times out.
-* Includes information about jobs that were still in progress.
-*
-* @example
-* ```typescript
-* try {
-*   await monque.stop();
-* } catch (error) {
-*   if (error instanceof ShutdownTimeoutError) {
-*     console.error('Incomplete jobs:', error.incompleteJobs.length);
-*   }
-* }
-* ```
-*/
-var ShutdownTimeoutError = class ShutdownTimeoutError extends MonqueError {
-	constructor(message, incompleteJobs) {
-		super(message);
-		this.incompleteJobs = incompleteJobs;
-		this.name = "ShutdownTimeoutError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, ShutdownTimeoutError);
-	}
-};
-/**
-* Error thrown when attempting to register a worker for a job name
-* that already has a registered worker, without explicitly allowing replacement.
-*
-* @example
-* ```typescript
-* try {
-*   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);
-*   }
-* }
-*
-* // To intentionally replace a worker:
-* monque.register('send-email', handler2, { replace: true });
-* ```
-*/
-var WorkerRegistrationError = class WorkerRegistrationError extends MonqueError {
-	constructor(message, jobName) {
-		super(message);
-		this.jobName = jobName;
-		this.name = "WorkerRegistrationError";
-		/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */
-		if (Error.captureStackTrace) Error.captureStackTrace(this, WorkerRegistrationError);
-	}
-};
-
-//#endregion
-export { WorkerRegistrationError as a, ShutdownTimeoutError as i, InvalidCronError as n, MonqueError as r, ConnectionError as t };
-//# sourceMappingURL=errors-DQ2_gprw.mjs.map

package/dist/errors-DQ2_gprw.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-DQ2_gprw.mjs","names":[],"sources":["../src/shared/errors.ts"],"sourcesContent":["import type { Job } from '@/jobs';\n\n/**\n * Base error class for all Monque-related errors.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.enqueue('job', data);\n * } catch (error) {\n *   if (error instanceof MonqueError) {\n *     console.error('Monque error:', error.message);\n *   }\n * }\n * ```\n */\nexport class MonqueError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = 'MonqueError';\n\t\t// Maintains proper stack trace for where our error was thrown (only available on V8)\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, MonqueError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when an invalid cron expression is provided.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.schedule('invalid cron', 'job', data);\n * } catch (error) {\n *   if (error instanceof InvalidCronError) {\n *     console.error('Invalid expression:', error.expression);\n *   }\n * }\n * ```\n */\nexport class InvalidCronError extends MonqueError {\n\tconstructor(\n\t\tpublic readonly expression: string,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'InvalidCronError';\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, InvalidCronError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when there's a database connection issue.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.enqueue('job', data);\n * } catch (error) {\n *   if (error instanceof ConnectionError) {\n *     console.error('Database connection lost');\n *   }\n * }\n * ```\n */\nexport class ConnectionError extends MonqueError {\n\tconstructor(message: string, options?: { cause?: Error }) {\n\t\tsuper(message);\n\t\tthis.name = 'ConnectionError';\n\t\tif (options?.cause) {\n\t\t\tthis.cause = options.cause;\n\t\t}\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, ConnectionError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when graceful shutdown times out.\n * Includes information about jobs that were still in progress.\n *\n * @example\n * ```typescript\n * try {\n *   await monque.stop();\n * } catch (error) {\n *   if (error instanceof ShutdownTimeoutError) {\n *     console.error('Incomplete jobs:', error.incompleteJobs.length);\n *   }\n * }\n * ```\n */\nexport class ShutdownTimeoutError extends MonqueError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly incompleteJobs: Job[],\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'ShutdownTimeoutError';\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, ShutdownTimeoutError);\n\t\t}\n\t}\n}\n\n/**\n * Error thrown when attempting to register a worker for a job name\n * that already has a registered worker, without explicitly allowing replacement.\n *\n * @example\n * ```typescript\n * try {\n *   monque.register('send-email', handler1);\n *   monque.register('send-email', handler2); // throws\n * } catch (error) {\n *   if (error instanceof WorkerRegistrationError) {\n *     console.error('Worker already registered for:', error.jobName);\n *   }\n * }\n *\n * // To intentionally replace a worker:\n * monque.register('send-email', handler2, { replace: true });\n * ```\n */\nexport class WorkerRegistrationError extends MonqueError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly jobName: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'WorkerRegistrationError';\n\t\t/* istanbul ignore next -- @preserve captureStackTrace is always available in Node.js */\n\t\tif (Error.captureStackTrace) {\n\t\t\tError.captureStackTrace(this, WorkerRegistrationError);\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,IAAa,cAAb,MAAa,oBAAoB,MAAM;CACtC,YAAY,SAAiB;AAC5B,QAAM,QAAQ;AACd,OAAK,OAAO;;AAGZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,YAAY;;;;;;;;;;;;;;;;;AAmB7C,IAAa,mBAAb,MAAa,yBAAyB,YAAY;CACjD,YACC,AAAgB,YAChB,SACC;AACD,QAAM,QAAQ;EAHE;AAIhB,OAAK,OAAO;;AAEZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,iBAAiB;;;;;;;;;;;;;;;;;AAmBlD,IAAa,kBAAb,MAAa,wBAAwB,YAAY;CAChD,YAAY,SAAiB,SAA6B;AACzD,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,MAAI,SAAS,MACZ,MAAK,QAAQ,QAAQ;;AAGtB,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;AAoBjD,IAAa,uBAAb,MAAa,6BAA6B,YAAY;CACrD,YACC,SACA,AAAgB,gBACf;AACD,QAAM,QAAQ;EAFE;AAGhB,OAAK,OAAO;;AAEZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;AAwBtD,IAAa,0BAAb,MAAa,gCAAgC,YAAY;CACxD,YACC,SACA,AAAgB,SACf;AACD,QAAM,QAAQ;EAFE;AAGhB,OAAK,OAAO;;AAEZ,MAAI,MAAM,kBACT,OAAM,kBAAkB,MAAM,wBAAwB"}

package/dist/errors-Dfli-u59.cjs

@@ -1,3 +0,0 @@
-const require_errors = require('./errors-D5ZGG2uI.cjs');
-
-exports.ShutdownTimeoutError = require_errors.ShutdownTimeoutError;