@warlock.js/queue 5.13.0 → 5.15.0

package/cjs/define-job-DideGKQK.cjs

@@ -1,468 +0,0 @@
-let _warlock_js_logger = require("@warlock.js/logger");
-let bullmq = require("bullmq");
-
-//#region ../queue/src/errors.ts
-/**
-* Thrown when the queue is used before `setQueueConfig` (or the queue
-* connector) supplied a configuration.
-*/
-var QueueNotConfiguredError = class extends Error {
-	constructor() {
-		super("@warlock.js/queue is not configured. Add src/config/queue.ts exporting a QueueConfig and register queueConnector() in warlock.config.ts > connectors, or call setQueueConfig() yourself.");
-		this.name = "QueueNotConfiguredError";
-	}
-};
-/**
-* Thrown for a malformed duration such as `"10 minutes"`.
-*/
-var InvalidDurationError = class extends Error {
-	constructor(value) {
-		super(`Invalid duration ${JSON.stringify(value)}: expected milliseconds as a non-negative number or a string like "500ms", "30s", "10m", "2h", "1d".`);
-		this.name = "InvalidDurationError";
-	}
-};
-/**
-* Thrown by `defineJob` for an invalid definition.
-*/
-var InvalidJobDefinitionError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "InvalidJobDefinitionError";
-	}
-};
-/**
-* Thrown by `retryFailedJob` when no failed job has the given id.
-*/
-var FailedJobNotFoundError = class extends Error {
-	constructor(id, queue) {
-		super(`No failed job with id "${id}" on queue "${queue}".`);
-		this.name = "FailedJobNotFoundError";
-	}
-};
-/**
-* Thrown by `queueDashboard` when an optional bull-board package is not
-* installed.
-*/
-var QueueDashboardDependencyError = class extends Error {
-	constructor(missing) {
-		super(`The queue dashboard needs the optional package "${missing}", which is not installed.\nInstall both bull-board packages:
-
-  npm install @bull-board/api @bull-board/fastify
-`);
-		this.name = "QueueDashboardDependencyError";
-	}
-};
-
-//#endregion
-//#region ../queue/src/config.ts
-let activeConfig;
-/**
-* Set the active queue configuration. In a Warlock app the queue connector
-* calls this at boot with `src/config/queue.ts`; scripts and tests may call
-* it directly. Replaces (does not merge) any previous configuration.
-*/
-function setQueueConfig(config) {
-	activeConfig = config;
-}
-/**
-* The active queue configuration. Throws {@link QueueNotConfiguredError}
-* when none was set.
-*/
-function getQueueConfig() {
-	if (!activeConfig) throw new QueueNotConfiguredError();
-	return activeConfig;
-}
-/** Forget the active configuration. */
-function resetQueueConfig() {
-	activeConfig = void 0;
-}
-/** The queue a job runs on when it names none. */
-function defaultQueueName() {
-	return activeConfig?.defaultQueue ?? "default";
-}
-
-//#endregion
-//#region ../queue/src/job-registry.ts
-const jobs = /* @__PURE__ */ new Map();
-const listeners = /* @__PURE__ */ new Set();
-/**
-* Register a definition under its name.
-*
-* Re-registering a name REPLACES the previous definition: in development a
-* job module is re-evaluated on every reload, and refusing the second
-* evaluation would break the reload. Job names must therefore be unique
-* across the app — two different modules using one name leave only the
-* later handler active.
-*/
-function registerJob(job) {
-	jobs.set(job.name, job);
-	for (const listener of listeners) listener(job);
-}
-/** The definition registered under `name`, if any. */
-function findRegisteredJob(name) {
-	return jobs.get(name);
-}
-/** Every registered definition. */
-function registeredJobs() {
-	return [...jobs.values()];
-}
-/** The queue a definition runs on, resolved against the active config. */
-function queueOf(job) {
-	return job.queue ?? defaultQueueName();
-}
-/** Be told whenever a job is registered. Returns an unsubscribe function. */
-function onJobRegistered(listener) {
-	listeners.add(listener);
-	return () => listeners.delete(listener);
-}
-
-//#endregion
-//#region ../queue/src/process-job.ts
-/**
-* The single BullMQ processor every worker runs: route the job to the
-* handler registered under its name.
-*
-* A name with no handler in this process fails with `UnrecoverableError` —
-* retrying cannot make a missing definition appear, so it must not burn
-* through its attempts.
-*/
-async function processJob(job) {
-	const definition = findRegisteredJob(job.name);
-	if (!definition) throw new bullmq.UnrecoverableError(`No job named "${job.name}" is defined in this process. Make sure the module that calls defineJob() is imported by the worker process.`);
-	const context = {
-		id: String(job.id),
-		name: job.name,
-		queue: job.queueName,
-		attempt: job.attemptsMade + 1,
-		maxAttempts: job.opts.attempts ?? 1,
-		progress: (value) => job.updateProgress(value),
-		log: async (line) => {
-			await job.log(line);
-		}
-	};
-	return definition.handle(job.data, context);
-}
-
-//#endregion
-//#region ../queue/src/queue-manager.ts
-const DEFAULT_SHUTDOWN_TIMEOUT = 3e4;
-const queues = /* @__PURE__ */ new Map();
-const workers = /* @__PURE__ */ new Map();
-let stopListening;
-/**
-* The BullMQ queue for `name`, created on first use with the configured
-* connection and prefix.
-*/
-function getQueue(name) {
-	let queue = queues.get(name);
-	if (!queue) {
-		const config = getQueueConfig();
-		queue = new bullmq.Queue(name, {
-			connection: config.connection,
-			prefix: config.prefix ?? "warlock"
-		});
-		queue.on("error", (error) => {
-			_warlock_js_logger.log.error("queue", "connection", error);
-		});
-		queues.set(name, queue);
-	}
-	return queue;
-}
-/**
-* Start one worker per queue that has a registered job, and keep starting
-* workers for queues whose first job is defined later.
-*
-* A no-op returning `[]` when `workers.enabled` is `false`. Calling it again
-* while workers run starts only the missing ones.
-*
-* @returns the queue names that now have a worker in this process.
-*/
-async function startWorkers() {
-	if (getQueueConfig().workers?.enabled === false) return [];
-	for (const job of registeredJobs()) ensureWorker(queueOf(job));
-	stopListening ??= onJobRegistered((job) => {
-		ensureWorker(queueOf(job));
-	});
-	await Promise.all([...workers.values()].map((worker) => worker.waitUntilReady()));
-	return [...workers.keys()];
-}
-/** The queue names with a running worker in this process. */
-function runningWorkers() {
-	return [...workers.keys()];
-}
-function ensureWorker(queueName) {
-	if (workers.has(queueName)) return;
-	const config = getQueueConfig();
-	const worker = new bullmq.Worker(queueName, processJob, {
-		connection: config.connection,
-		prefix: config.prefix ?? "warlock",
-		concurrency: config.workers?.concurrency ?? 1
-	});
-	worker.on("error", (error) => {
-		_warlock_js_logger.log.error("queue", "worker", error);
-	});
-	worker.on("failed", (job, error) => {
-		_warlock_js_logger.log.error("queue", "job.failed", `${job?.name ?? "unknown"} (${job?.id ?? "?"}): ${error.message}`);
-	});
-	workers.set(queueName, worker);
-}
-/**
-* Graceful shutdown: stop workers taking new jobs and wait for active ones
-* (bounded by `timeout`, then force-close), then close every queue
-* connection. Safe to call when nothing was started, and more than once.
-*/
-async function closeQueue(options = {}) {
-	stopListening?.();
-	stopListening = void 0;
-	const timeout = options.timeout ?? configuredShutdownTimeout();
-	const closingWorkers = [...workers.values()];
-	workers.clear();
-	await Promise.all(closingWorkers.map((worker) => closeWorker(worker, timeout)));
-	const closingQueues = [...queues.values()];
-	queues.clear();
-	await Promise.all(closingQueues.map((queue) => queue.close()));
-}
-function configuredShutdownTimeout() {
-	try {
-		return getQueueConfig().workers?.shutdownTimeout ?? DEFAULT_SHUTDOWN_TIMEOUT;
-	} catch {
-		return DEFAULT_SHUTDOWN_TIMEOUT;
-	}
-}
-async function closeWorker(worker, timeout) {
-	let timer;
-	const timedOut = new Promise((resolve) => {
-		timer = setTimeout(() => resolve("timeout"), timeout);
-	});
-	const closing = worker.close().then(() => "closed");
-	closing.catch(() => void 0);
-	const outcome = await Promise.race([closing, timedOut]);
-	clearTimeout(timer);
-	if (outcome === "timeout") {
-		_warlock_js_logger.log.warn("queue", "shutdown", `Worker for "${worker.name}" still had active jobs after ${timeout}ms; disconnecting. Those jobs are retried once their lock expires.`);
-		await worker.disconnect();
-	}
-}
-
-//#endregion
-//#region ../queue/src/duration.ts
-const UNIT_MILLISECONDS = {
-	ms: 1,
-	s: 1e3,
-	m: 6e4,
-	h: 36e5,
-	d: 864e5
-};
-const DURATION_PATTERN = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/;
-/**
-* Convert a {@link Duration} to milliseconds. Numbers are already
-* milliseconds. Anything else is rejected loudly rather than guessed at.
-*/
-function toMilliseconds(value) {
-	if (typeof value === "number") {
-		if (!Number.isFinite(value) || value < 0) throw new InvalidDurationError(value);
-		return Math.round(value);
-	}
-	const match = typeof value === "string" ? DURATION_PATTERN.exec(value.trim()) : null;
-	if (!match) throw new InvalidDurationError(value);
-	return Math.round(Number(match[1]) * UNIT_MILLISECONDS[match[2]]);
-}
-
-//#endregion
-//#region ../queue/src/define-job.ts
-/**
-* Define a background job.
-*
-* The definition is registered by name so any worker in the process can run
-* it; the returned object dispatches it with a typed payload.
-*
-* @example
-* export const sendInvoice = defineJob({
-*   name: "invoices.send",
-*   attempts: 5,
-*   backoff: { type: "exponential", delay: 2000 },
-*   async handle(payload: { invoiceId: string }, ctx) {
-*     await ctx.progress(50);
-*   },
-* });
-*
-* await sendInvoice.dispatch({ invoiceId: "42" }, { delay: "10m", priority: 1 });
-*/
-function defineJob(definition) {
-	assertValidDefinition(definition);
-	registerJob(definition);
-	return {
-		name: definition.name,
-		get queue() {
-			return queueOf(definition);
-		},
-		async dispatch(payload, options = {}) {
-			const queueName = queueOf(definition);
-			const job = await getQueue(queueName).add(definition.name, payload, toBullJobOptions(definition, options));
-			return {
-				id: String(job.id),
-				name: definition.name,
-				queue: queueName
-			};
-		},
-		async find(id) {
-			const job = await getQueue(queueOf(definition)).getJob(id);
-			if (!job || job.name !== definition.name) return;
-			return toSnapshot(job);
-		}
-	};
-}
-function assertValidDefinition(definition) {
-	if (typeof definition.name !== "string" || definition.name.trim() === "") throw new InvalidJobDefinitionError("defineJob() requires a non-empty `name`.");
-	if (typeof definition.handle !== "function") throw new InvalidJobDefinitionError(`defineJob("${definition.name}") requires a \`handle(payload, ctx)\` function.`);
-	if (definition.attempts !== void 0 && !(Number.isInteger(definition.attempts) && definition.attempts >= 1)) throw new InvalidJobDefinitionError(`defineJob("${definition.name}"): \`attempts\` must be an integer >= 1, got ${definition.attempts}.`);
-}
-/**
-* Merge app defaults < job definition < dispatch options into BullMQ's shape.
-*/
-function toBullJobOptions(definition, options) {
-	const defaults = getQueueConfig().defaultJobOptions ?? {};
-	const attempts = options.attempts ?? definition.attempts ?? defaults.attempts;
-	const backoff = options.backoff ?? definition.backoff ?? defaults.backoff;
-	const removeOnComplete = definition.removeOnComplete ?? defaults.removeOnComplete;
-	const removeOnFail = definition.removeOnFail ?? defaults.removeOnFail;
-	const bullOptions = {};
-	if (attempts !== void 0) bullOptions.attempts = attempts;
-	if (backoff !== void 0) bullOptions.backoff = toBullBackoff(backoff);
-	if (removeOnComplete !== void 0) bullOptions.removeOnComplete = removeOnComplete;
-	if (removeOnFail !== void 0) bullOptions.removeOnFail = removeOnFail;
-	if (options.delay !== void 0) bullOptions.delay = toMilliseconds(options.delay);
-	if (options.priority !== void 0) bullOptions.priority = options.priority;
-	if (options.jobId !== void 0) bullOptions.jobId = options.jobId;
-	return bullOptions;
-}
-function toBullBackoff(backoff) {
-	return typeof backoff === "number" ? {
-		type: "fixed",
-		delay: backoff
-	} : backoff;
-}
-/**
-* A plain view of a BullMQ job.
-*/
-async function toSnapshot(job) {
-	const state = await job.getState();
-	return {
-		id: String(job.id),
-		name: job.name,
-		queue: job.queueName,
-		state,
-		payload: job.data,
-		progress: job.progress,
-		attemptsMade: job.attemptsMade,
-		result: job.returnvalue,
-		failedReason: job.failedReason || void 0,
-		createdAt: new Date(job.timestamp),
-		finishedAt: job.finishedOn ? new Date(job.finishedOn) : void 0
-	};
-}
-
-//#endregion
-Object.defineProperty(exports, 'FailedJobNotFoundError', {
-  enumerable: true,
-  get: function () {
-    return FailedJobNotFoundError;
-  }
-});
-Object.defineProperty(exports, 'InvalidDurationError', {
-  enumerable: true,
-  get: function () {
-    return InvalidDurationError;
-  }
-});
-Object.defineProperty(exports, 'InvalidJobDefinitionError', {
-  enumerable: true,
-  get: function () {
-    return InvalidJobDefinitionError;
-  }
-});
-Object.defineProperty(exports, 'QueueDashboardDependencyError', {
-  enumerable: true,
-  get: function () {
-    return QueueDashboardDependencyError;
-  }
-});
-Object.defineProperty(exports, 'QueueNotConfiguredError', {
-  enumerable: true,
-  get: function () {
-    return QueueNotConfiguredError;
-  }
-});
-Object.defineProperty(exports, 'closeQueue', {
-  enumerable: true,
-  get: function () {
-    return closeQueue;
-  }
-});
-Object.defineProperty(exports, 'defaultQueueName', {
-  enumerable: true,
-  get: function () {
-    return defaultQueueName;
-  }
-});
-Object.defineProperty(exports, 'defineJob', {
-  enumerable: true,
-  get: function () {
-    return defineJob;
-  }
-});
-Object.defineProperty(exports, 'getQueue', {
-  enumerable: true,
-  get: function () {
-    return getQueue;
-  }
-});
-Object.defineProperty(exports, 'getQueueConfig', {
-  enumerable: true,
-  get: function () {
-    return getQueueConfig;
-  }
-});
-Object.defineProperty(exports, 'queueOf', {
-  enumerable: true,
-  get: function () {
-    return queueOf;
-  }
-});
-Object.defineProperty(exports, 'registeredJobs', {
-  enumerable: true,
-  get: function () {
-    return registeredJobs;
-  }
-});
-Object.defineProperty(exports, 'resetQueueConfig', {
-  enumerable: true,
-  get: function () {
-    return resetQueueConfig;
-  }
-});
-Object.defineProperty(exports, 'runningWorkers', {
-  enumerable: true,
-  get: function () {
-    return runningWorkers;
-  }
-});
-Object.defineProperty(exports, 'setQueueConfig', {
-  enumerable: true,
-  get: function () {
-    return setQueueConfig;
-  }
-});
-Object.defineProperty(exports, 'startWorkers', {
-  enumerable: true,
-  get: function () {
-    return startWorkers;
-  }
-});
-Object.defineProperty(exports, 'toMilliseconds', {
-  enumerable: true,
-  get: function () {
-    return toMilliseconds;
-  }
-});
-//# sourceMappingURL=define-job-DideGKQK.cjs.map

package/cjs/define-job-DideGKQK.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-job-DideGKQK.cjs","names":["UnrecoverableError","Queue","Worker"],"sources":["../../../../../../queue/src/errors.ts","../../../../../../queue/src/config.ts","../../../../../../queue/src/job-registry.ts","../../../../../../queue/src/process-job.ts","../../../../../../queue/src/queue-manager.ts","../../../../../../queue/src/duration.ts","../../../../../../queue/src/define-job.ts"],"sourcesContent":["/**\n * Thrown when the queue is used before `setQueueConfig` (or the queue\n * connector) supplied a configuration.\n */\nexport class QueueNotConfiguredError extends Error {\n  public constructor() {\n    super(\n      \"@warlock.js/queue is not configured. Add src/config/queue.ts exporting a QueueConfig \" +\n        \"and register queueConnector() in warlock.config.ts > connectors, \" +\n        \"or call setQueueConfig() yourself.\",\n    );\n    this.name = \"QueueNotConfiguredError\";\n  }\n}\n\n/**\n * Thrown for a malformed duration such as `\"10 minutes\"`.\n */\nexport class InvalidDurationError extends Error {\n  public constructor(value: unknown) {\n    super(\n      `Invalid duration ${JSON.stringify(value)}: expected milliseconds as a non-negative number ` +\n        `or a string like \"500ms\", \"30s\", \"10m\", \"2h\", \"1d\".`,\n    );\n    this.name = \"InvalidDurationError\";\n  }\n}\n\n/**\n * Thrown by `defineJob` for an invalid definition.\n */\nexport class InvalidJobDefinitionError extends Error {\n  public constructor(message: string) {\n    super(message);\n    this.name = \"InvalidJobDefinitionError\";\n  }\n}\n\n/**\n * Thrown by `retryFailedJob` when no failed job has the given id.\n */\nexport class FailedJobNotFoundError extends Error {\n  public constructor(id: string, queue: string) {\n    super(`No failed job with id \"${id}\" on queue \"${queue}\".`);\n    this.name = \"FailedJobNotFoundError\";\n  }\n}\n\n/**\n * Thrown by `queueDashboard` when an optional bull-board package is not\n * installed.\n */\nexport class QueueDashboardDependencyError extends Error {\n  public constructor(missing: string) {\n    super(\n      `The queue dashboard needs the optional package \"${missing}\", which is not installed.\\n` +\n        \"Install both bull-board packages:\\n\\n\" +\n        \"  npm install @bull-board/api @bull-board/fastify\\n\",\n    );\n    this.name = \"QueueDashboardDependencyError\";\n  }\n}\n","import { QueueNotConfiguredError } from \"./errors\";\nimport type { QueueConfig } from \"./types\";\n\nlet activeConfig: QueueConfig | undefined;\n\n/**\n * Set the active queue configuration. In a Warlock app the queue connector\n * calls this at boot with `src/config/queue.ts`; scripts and tests may call\n * it directly. Replaces (does not merge) any previous configuration.\n */\nexport function setQueueConfig(config: QueueConfig): void {\n  activeConfig = config;\n}\n\n/**\n * The active queue configuration. Throws {@link QueueNotConfiguredError}\n * when none was set.\n */\nexport function getQueueConfig(): QueueConfig {\n  if (!activeConfig) {\n    throw new QueueNotConfiguredError();\n  }\n\n  return activeConfig;\n}\n\n/** Forget the active configuration. */\nexport function resetQueueConfig(): void {\n  activeConfig = undefined;\n}\n\n/** The queue a job runs on when it names none. */\nexport function defaultQueueName(): string {\n  return activeConfig?.defaultQueue ?? \"default\";\n}\n","import { defaultQueueName } from \"./config\";\nimport type { JobDefinition } from \"./types\";\n\n/** A registered definition, payload/result erased for storage. */\nexport type RegisteredJob = JobDefinition<unknown, unknown>;\n\ntype RegistryListener = (job: RegisteredJob) => void;\n\nconst jobs = new Map<string, RegisteredJob>();\nconst listeners = new Set<RegistryListener>();\n\n/**\n * Register a definition under its name.\n *\n * Re-registering a name REPLACES the previous definition: in development a\n * job module is re-evaluated on every reload, and refusing the second\n * evaluation would break the reload. Job names must therefore be unique\n * across the app — two different modules using one name leave only the\n * later handler active.\n */\nexport function registerJob(job: RegisteredJob): void {\n  jobs.set(job.name, job);\n\n  for (const listener of listeners) {\n    listener(job);\n  }\n}\n\n/** The definition registered under `name`, if any. */\nexport function findRegisteredJob(name: string): RegisteredJob | undefined {\n  return jobs.get(name);\n}\n\n/** Every registered definition. */\nexport function registeredJobs(): RegisteredJob[] {\n  return [...jobs.values()];\n}\n\n/** The queue a definition runs on, resolved against the active config. */\nexport function queueOf(job: Pick<RegisteredJob, \"queue\">): string {\n  return job.queue ?? defaultQueueName();\n}\n\n/** Be told whenever a job is registered. Returns an unsubscribe function. */\nexport function onJobRegistered(listener: RegistryListener): () => void {\n  listeners.add(listener);\n\n  return () => listeners.delete(listener);\n}\n","import { type Job, UnrecoverableError } from \"bullmq\";\nimport { findRegisteredJob } from \"./job-registry\";\nimport type { JobContext } from \"./types\";\n\n/**\n * The single BullMQ processor every worker runs: route the job to the\n * handler registered under its name.\n *\n * A name with no handler in this process fails with `UnrecoverableError` —\n * retrying cannot make a missing definition appear, so it must not burn\n * through its attempts.\n */\nexport async function processJob(job: Job): Promise<unknown> {\n  const definition = findRegisteredJob(job.name);\n\n  if (!definition) {\n    throw new UnrecoverableError(\n      `No job named \"${job.name}\" is defined in this process. ` +\n        \"Make sure the module that calls defineJob() is imported by the worker process.\",\n    );\n  }\n\n  const context: JobContext = {\n    id: String(job.id),\n    name: job.name,\n    queue: job.queueName,\n    attempt: job.attemptsMade + 1,\n    maxAttempts: job.opts.attempts ?? 1,\n    progress: (value) => job.updateProgress(value),\n    log: async (line) => {\n      await job.log(line);\n    },\n  };\n\n  return definition.handle(job.data, context);\n}\n","import { log } from \"@warlock.js/logger\";\nimport { Queue, Worker } from \"bullmq\";\nimport { getQueueConfig } from \"./config\";\nimport { onJobRegistered, queueOf, registeredJobs } from \"./job-registry\";\nimport { processJob } from \"./process-job\";\n\nconst DEFAULT_SHUTDOWN_TIMEOUT = 30_000;\n\nconst queues = new Map<string, Queue>();\nconst workers = new Map<string, Worker>();\nlet stopListening: (() => void) | undefined;\n\n/**\n * The BullMQ queue for `name`, created on first use with the configured\n * connection and prefix.\n */\nexport function getQueue(name: string): Queue {\n  let queue = queues.get(name);\n\n  if (!queue) {\n    const config = getQueueConfig();\n\n    queue = new Queue(name, {\n      connection: config.connection,\n      prefix: config.prefix ?? \"warlock\",\n    });\n\n    queue.on(\"error\", (error) => {\n      log.error(\"queue\", \"connection\", error);\n    });\n\n    queues.set(name, queue);\n  }\n\n  return queue;\n}\n\n/**\n * Start one worker per queue that has a registered job, and keep starting\n * workers for queues whose first job is defined later.\n *\n * A no-op returning `[]` when `workers.enabled` is `false`. Calling it again\n * while workers run starts only the missing ones.\n *\n * @returns the queue names that now have a worker in this process.\n */\nexport async function startWorkers(): Promise<string[]> {\n  const config = getQueueConfig();\n\n  if (config.workers?.enabled === false) {\n    return [];\n  }\n\n  for (const job of registeredJobs()) {\n    ensureWorker(queueOf(job));\n  }\n\n  stopListening ??= onJobRegistered((job) => {\n    ensureWorker(queueOf(job));\n  });\n\n  await Promise.all([...workers.values()].map((worker) => worker.waitUntilReady()));\n\n  return [...workers.keys()];\n}\n\n/** The queue names with a running worker in this process. */\nexport function runningWorkers(): string[] {\n  return [...workers.keys()];\n}\n\nfunction ensureWorker(queueName: string): void {\n  if (workers.has(queueName)) {\n    return;\n  }\n\n  const config = getQueueConfig();\n\n  const worker = new Worker(queueName, processJob, {\n    connection: config.connection,\n    prefix: config.prefix ?? \"warlock\",\n    concurrency: config.workers?.concurrency ?? 1,\n  });\n\n  worker.on(\"error\", (error) => {\n    log.error(\"queue\", \"worker\", error);\n  });\n\n  worker.on(\"failed\", (job, error) => {\n    log.error(\"queue\", \"job.failed\", `${job?.name ?? \"unknown\"} (${job?.id ?? \"?\"}): ${error.message}`);\n  });\n\n  workers.set(queueName, worker);\n}\n\nexport type CloseQueueOptions = {\n  /**\n   * How long to wait for active jobs before force-closing workers, in\n   * milliseconds. Default: `workers.shutdownTimeout`, else `30000`.\n   */\n  timeout?: number;\n};\n\n/**\n * Graceful shutdown: stop workers taking new jobs and wait for active ones\n * (bounded by `timeout`, then force-close), then close every queue\n * connection. Safe to call when nothing was started, and more than once.\n */\nexport async function closeQueue(options: CloseQueueOptions = {}): Promise<void> {\n  stopListening?.();\n  stopListening = undefined;\n\n  const timeout = options.timeout ?? configuredShutdownTimeout();\n  const closingWorkers = [...workers.values()];\n  workers.clear();\n\n  await Promise.all(closingWorkers.map((worker) => closeWorker(worker, timeout)));\n\n  const closingQueues = [...queues.values()];\n  queues.clear();\n\n  await Promise.all(closingQueues.map((queue) => queue.close()));\n}\n\nfunction configuredShutdownTimeout(): number {\n  try {\n    return getQueueConfig().workers?.shutdownTimeout ?? DEFAULT_SHUTDOWN_TIMEOUT;\n  } catch {\n    return DEFAULT_SHUTDOWN_TIMEOUT;\n  }\n}\n\nasync function closeWorker(worker: Worker, timeout: number): Promise<void> {\n  let timer: NodeJS.Timeout | undefined;\n\n  const timedOut = new Promise<\"timeout\">((resolve) => {\n    timer = setTimeout(() => resolve(\"timeout\"), timeout);\n  });\n\n  // A close already in progress cannot be upgraded to a forced one (BullMQ\n  // returns the pending promise), so the timeout path drops the connections\n  // instead and lets the graceful close settle in the background.\n  const closing = worker.close().then(() => \"closed\" as const);\n  closing.catch(() => undefined);\n\n  const outcome = await Promise.race([closing, timedOut]);\n\n  clearTimeout(timer);\n\n  if (outcome === \"timeout\") {\n    log.warn(\n      \"queue\",\n      \"shutdown\",\n      `Worker for \"${worker.name}\" still had active jobs after ${timeout}ms; disconnecting. ` +\n        \"Those jobs are retried once their lock expires.\",\n    );\n\n    await worker.disconnect();\n  }\n}\n","import { InvalidDurationError } from \"./errors\";\nimport type { Duration } from \"./types\";\n\nconst UNIT_MILLISECONDS: Record<string, number> = {\n  ms: 1,\n  s: 1_000,\n  m: 60_000,\n  h: 3_600_000,\n  d: 86_400_000,\n};\n\nconst DURATION_PATTERN = /^(\\d+(?:\\.\\d+)?)(ms|s|m|h|d)$/;\n\n/**\n * Convert a {@link Duration} to milliseconds. Numbers are already\n * milliseconds. Anything else is rejected loudly rather than guessed at.\n */\nexport function toMilliseconds(value: Duration | string): number {\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value) || value < 0) {\n      throw new InvalidDurationError(value);\n    }\n\n    return Math.round(value);\n  }\n\n  const match = typeof value === \"string\" ? DURATION_PATTERN.exec(value.trim()) : null;\n\n  if (!match) {\n    throw new InvalidDurationError(value);\n  }\n\n  return Math.round(Number(match[1]) * UNIT_MILLISECONDS[match[2]!]!);\n}\n","import type { Job, JobsOptions } from \"bullmq\";\nimport { getQueueConfig } from \"./config\";\nimport { toMilliseconds } from \"./duration\";\nimport { InvalidJobDefinitionError } from \"./errors\";\nimport { queueOf, registerJob, type RegisteredJob } from \"./job-registry\";\nimport { getQueue } from \"./queue-manager\";\nimport type {\n  DispatchOptions,\n  JobBackoff,\n  JobDefinition,\n  JobOptions,\n  JobSnapshot,\n  JobState,\n  QueueJob,\n} from \"./types\";\n\n/**\n * Define a background job.\n *\n * The definition is registered by name so any worker in the process can run\n * it; the returned object dispatches it with a typed payload.\n *\n * @example\n * export const sendInvoice = defineJob({\n *   name: \"invoices.send\",\n *   attempts: 5,\n *   backoff: { type: \"exponential\", delay: 2000 },\n *   async handle(payload: { invoiceId: string }, ctx) {\n *     await ctx.progress(50);\n *   },\n * });\n *\n * await sendInvoice.dispatch({ invoiceId: \"42\" }, { delay: \"10m\", priority: 1 });\n */\nexport function defineJob<TPayload, TResult = unknown>(\n  definition: JobDefinition<TPayload, TResult>,\n): QueueJob<TPayload, TResult> {\n  assertValidDefinition(definition);\n  registerJob(definition as RegisteredJob);\n\n  return {\n    name: definition.name,\n    get queue() {\n      return queueOf(definition);\n    },\n    async dispatch(payload, options = {}) {\n      const queueName = queueOf(definition);\n      const job = await getQueue(queueName).add(\n        definition.name,\n        payload,\n        toBullJobOptions(definition, options),\n      );\n\n      return { id: String(job.id), name: definition.name, queue: queueName };\n    },\n    async find(id) {\n      const job = await getQueue(queueOf(definition)).getJob(id);\n\n      if (!job || job.name !== definition.name) {\n        return undefined;\n      }\n\n      return toSnapshot<TPayload, TResult>(job);\n    },\n  };\n}\n\nfunction assertValidDefinition(definition: JobDefinition<unknown, unknown>): void {\n  if (typeof definition.name !== \"string\" || definition.name.trim() === \"\") {\n    throw new InvalidJobDefinitionError(\"defineJob() requires a non-empty `name`.\");\n  }\n\n  if (typeof definition.handle !== \"function\") {\n    throw new InvalidJobDefinitionError(\n      `defineJob(\"${definition.name}\") requires a \\`handle(payload, ctx)\\` function.`,\n    );\n  }\n\n  if (definition.attempts !== undefined && !(Number.isInteger(definition.attempts) && definition.attempts >= 1)) {\n    throw new InvalidJobDefinitionError(\n      `defineJob(\"${definition.name}\"): \\`attempts\\` must be an integer >= 1, got ${definition.attempts}.`,\n    );\n  }\n}\n\n/**\n * Merge app defaults < job definition < dispatch options into BullMQ's shape.\n */\nfunction toBullJobOptions(definition: JobOptions, options: DispatchOptions): JobsOptions {\n  const defaults = getQueueConfig().defaultJobOptions ?? {};\n  const attempts = options.attempts ?? definition.attempts ?? defaults.attempts;\n  const backoff = options.backoff ?? definition.backoff ?? defaults.backoff;\n  const removeOnComplete = definition.removeOnComplete ?? defaults.removeOnComplete;\n  const removeOnFail = definition.removeOnFail ?? defaults.removeOnFail;\n\n  const bullOptions: JobsOptions = {};\n\n  if (attempts !== undefined) bullOptions.attempts = attempts;\n  if (backoff !== undefined) bullOptions.backoff = toBullBackoff(backoff);\n  if (removeOnComplete !== undefined) bullOptions.removeOnComplete = removeOnComplete;\n  if (removeOnFail !== undefined) bullOptions.removeOnFail = removeOnFail;\n  if (options.delay !== undefined) bullOptions.delay = toMilliseconds(options.delay);\n  if (options.priority !== undefined) bullOptions.priority = options.priority;\n  if (options.jobId !== undefined) bullOptions.jobId = options.jobId;\n\n  return bullOptions;\n}\n\nfunction toBullBackoff(backoff: JobBackoff): JobsOptions[\"backoff\"] {\n  return typeof backoff === \"number\" ? { type: \"fixed\", delay: backoff } : backoff;\n}\n\n/**\n * A plain view of a BullMQ job.\n */\nexport async function toSnapshot<TPayload, TResult>(\n  job: Job,\n): Promise<JobSnapshot<TPayload, TResult>> {\n  const state = (await job.getState()) as JobState;\n\n  return {\n    id: String(job.id),\n    name: job.name,\n    queue: job.queueName,\n    state,\n    payload: job.data as TPayload,\n    progress: job.progress as JobSnapshot[\"progress\"],\n    attemptsMade: job.attemptsMade,\n    result: job.returnvalue as TResult | undefined,\n    failedReason: job.failedReason || undefined,\n    createdAt: new Date(job.timestamp),\n    finishedAt: job.finishedOn ? new Date(job.finishedOn) : undefined,\n  };\n}\n"],"mappings":"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"}

package/cjs/notifications/index.cjs

@@ -1,68 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_define_job = require('../define-job-DideGKQK.cjs');
-let bullmq = require("bullmq");
-let _warlock_js_notifications = require("@warlock.js/notifications");
-
-//#region ../queue/src/notifications/queue-notification-dispatcher.ts
-/**
-* BullMQ-backed `QueueDispatcher` for `@warlock.js/notifications`.
-*
-* Notifications renders the payload and resolves the route BEFORE handing a
-* job to its dispatcher, so the job (`{ channel, route, payload, options }`)
-* is plain JSON. This adapter enqueues it as a queue job; the job's handler,
-* running in any worker process, looks the channel up by name in that
-* process's notifications config and calls `channel.send`.
-*
-* Notifications itself has no dependency on this package.
-*/
-/** The job name notification deliveries run under. */
-const NOTIFICATION_JOB_NAME = "warlock.notifications.deliver";
-/**
-* Create the dispatcher for `NotificationConfig.queue`.
-*
-* - `SendOptions.delay` is honoured: a number is SECONDS (notifications'
-*   convention), a string is a duration such as `"10m"`.
-* - A failing `channel.send` throws, so the delivery is retried per
-*   `attempts` / `backoff` and ends in `failedJobs()` when exhausted.
-* - A channel missing from the worker's notifications config fails at once,
-*   without retries.
-*
-* @example src/config/notifications.ts
-* import { queueNotificationDispatcher } from "@warlock.js/queue/notifications";
-*
-* const config: NotificationConfig = {
-*   channels: { mail: mailChannel() },
-*   queue: queueNotificationDispatcher({ attempts: 3, backoff: { type: "exponential", delay: 5000 } }),
-* };
-*/
-function queueNotificationDispatcher(options = {}) {
-	const deliver = defineNotificationJob(options);
-	return { async dispatch(job) {
-		await deliver.dispatch(job, { delay: job.options.delay === void 0 ? void 0 : notificationDelay(job.options.delay) });
-	} };
-}
-function defineNotificationJob(options) {
-	return require_define_job.defineJob({
-		name: NOTIFICATION_JOB_NAME,
-		queue: options.queue,
-		attempts: options.attempts,
-		backoff: options.backoff,
-		async handle(job) {
-			const channel = (0, _warlock_js_notifications.getNotificationConfig)().channels[job.channel];
-			if (!channel) throw new bullmq.UnrecoverableError(`Notification channel "${job.channel}" is not configured in this worker's notifications config.`);
-			await channel.send({
-				payload: job.payload,
-				route: job.route,
-				options: job.options
-			});
-		}
-	});
-}
-function notificationDelay(delay) {
-	return typeof delay === "number" ? delay * 1e3 : require_define_job.toMilliseconds(delay);
-}
-
-//#endregion
-exports.NOTIFICATION_JOB_NAME = NOTIFICATION_JOB_NAME;
-exports.queueNotificationDispatcher = queueNotificationDispatcher;
-//# sourceMappingURL=index.cjs.map

package/cjs/notifications/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["defineJob","UnrecoverableError","toMilliseconds"],"sources":["../../../../../../../queue/src/notifications/queue-notification-dispatcher.ts"],"sourcesContent":["/**\n * BullMQ-backed `QueueDispatcher` for `@warlock.js/notifications`.\n *\n * Notifications renders the payload and resolves the route BEFORE handing a\n * job to its dispatcher, so the job (`{ channel, route, payload, options }`)\n * is plain JSON. This adapter enqueues it as a queue job; the job's handler,\n * running in any worker process, looks the channel up by name in that\n * process's notifications config and calls `channel.send`.\n *\n * Notifications itself has no dependency on this package.\n */\nimport { getNotificationConfig, type QueueDispatcher } from \"@warlock.js/notifications\";\nimport { UnrecoverableError } from \"bullmq\";\nimport { defineJob } from \"../define-job\";\nimport { toMilliseconds } from \"../duration\";\nimport type { Duration, JobBackoff, QueueJob } from \"../types\";\n\n/** The job name notification deliveries run under. */\nexport const NOTIFICATION_JOB_NAME = \"warlock.notifications.deliver\";\n\nexport type NotificationJobPayload = Parameters<QueueDispatcher[\"dispatch\"]>[0];\n\nexport type QueueNotificationDispatcherOptions = {\n  /** Queue to deliver on. Default: the default queue. */\n  queue?: string;\n  /** Attempts per delivery. Default: `queue.defaultJobOptions.attempts`, else `1`. */\n  attempts?: number;\n  /** Backoff between attempts. */\n  backoff?: JobBackoff;\n};\n\n/**\n * Create the dispatcher for `NotificationConfig.queue`.\n *\n * - `SendOptions.delay` is honoured: a number is SECONDS (notifications'\n *   convention), a string is a duration such as `\"10m\"`.\n * - A failing `channel.send` throws, so the delivery is retried per\n *   `attempts` / `backoff` and ends in `failedJobs()` when exhausted.\n * - A channel missing from the worker's notifications config fails at once,\n *   without retries.\n *\n * @example src/config/notifications.ts\n * import { queueNotificationDispatcher } from \"@warlock.js/queue/notifications\";\n *\n * const config: NotificationConfig = {\n *   channels: { mail: mailChannel() },\n *   queue: queueNotificationDispatcher({ attempts: 3, backoff: { type: \"exponential\", delay: 5000 } }),\n * };\n */\nexport function queueNotificationDispatcher(\n  options: QueueNotificationDispatcherOptions = {},\n): QueueDispatcher {\n  const deliver = defineNotificationJob(options);\n\n  return {\n    async dispatch(job) {\n      await deliver.dispatch(job, {\n        delay: job.options.delay === undefined ? undefined : notificationDelay(job.options.delay),\n      });\n    },\n  };\n}\n\nfunction defineNotificationJob(\n  options: QueueNotificationDispatcherOptions,\n): QueueJob<NotificationJobPayload, void> {\n  return defineJob<NotificationJobPayload, void>({\n    name: NOTIFICATION_JOB_NAME,\n    queue: options.queue,\n    attempts: options.attempts,\n    backoff: options.backoff,\n    async handle(job) {\n      const channels = getNotificationConfig().channels as Record<\n        string,\n        { send(context: never): Promise<void> } | undefined\n      >;\n      const channel = channels[job.channel];\n\n      if (!channel) {\n        throw new UnrecoverableError(\n          `Notification channel \"${job.channel}\" is not configured in this worker's notifications config.`,\n        );\n      }\n\n      await channel.send({ payload: job.payload, route: job.route, options: job.options } as never);\n    },\n  });\n}\n\nfunction notificationDelay(delay: number | string): Duration {\n  return typeof delay === \"number\" ? delay * 1_000 : toMilliseconds(delay);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,MAAa,wBAAwB;;;;;;;;;;;;;;;;;;;AA+BrC,SAAgB,4BACd,UAA8C,CAAC,GAC9B;CACjB,MAAM,UAAU,sBAAsB,OAAO;CAE7C,OAAO,EACL,MAAM,SAAS,KAAK;EAClB,MAAM,QAAQ,SAAS,KAAK,EAC1B,OAAO,IAAI,QAAQ,UAAU,SAAY,SAAY,kBAAkB,IAAI,QAAQ,KAAK,EAC1F,CAAC;CACH,EACF;AACF;AAEA,SAAS,sBACP,SACwC;CACxC,OAAOA,6BAAwC;EAC7C,MAAM;EACN,OAAO,QAAQ;EACf,UAAU,QAAQ;EAClB,SAAS,QAAQ;EACjB,MAAM,OAAO,KAAK;GAKhB,MAAM,+DAJiC,CAAC,CAAC,SAIhB,IAAI;GAE7B,IAAI,CAAC,SACH,MAAM,IAAIC,0BACR,yBAAyB,IAAI,QAAQ,2DACvC;GAGF,MAAM,QAAQ,KAAK;IAAE,SAAS,IAAI;IAAS,OAAO,IAAI;IAAO,SAAS,IAAI;GAAQ,CAAU;EAC9F;CACF,CAAC;AACH;AAEA,SAAS,kBAAkB,OAAkC;CAC3D,OAAO,OAAO,UAAU,WAAW,QAAQ,MAAQC,kCAAe,KAAK;AACzE"}

package/esm/notifications/index.d.mts

@@ -1,2 +0,0 @@
-import { NOTIFICATION_JOB_NAME, NotificationJobPayload, QueueNotificationDispatcherOptions, queueNotificationDispatcher } from "./queue-notification-dispatcher.mjs";
-export { NOTIFICATION_JOB_NAME, NotificationJobPayload, QueueNotificationDispatcherOptions, queueNotificationDispatcher };

package/esm/notifications/index.mjs

@@ -1,3 +0,0 @@
-import { NOTIFICATION_JOB_NAME, queueNotificationDispatcher } from "./queue-notification-dispatcher.mjs";
-
-export { NOTIFICATION_JOB_NAME, queueNotificationDispatcher };

package/esm/notifications/queue-notification-dispatcher.d.mts

@@ -1,34 +0,0 @@
-import { JobBackoff } from "../types.mjs";
-import { QueueDispatcher } from "@warlock.js/notifications";
-
-//#region ../queue/src/notifications/queue-notification-dispatcher.d.ts
-/** The job name notification deliveries run under. */
-declare const NOTIFICATION_JOB_NAME = "warlock.notifications.deliver";
-type NotificationJobPayload = Parameters<QueueDispatcher["dispatch"]>[0];
-type QueueNotificationDispatcherOptions = {
-  /** Queue to deliver on. Default: the default queue. */queue?: string; /** Attempts per delivery. Default: `queue.defaultJobOptions.attempts`, else `1`. */
-  attempts?: number; /** Backoff between attempts. */
-  backoff?: JobBackoff;
-};
-/**
- * Create the dispatcher for `NotificationConfig.queue`.
- *
- * - `SendOptions.delay` is honoured: a number is SECONDS (notifications'
- *   convention), a string is a duration such as `"10m"`.
- * - A failing `channel.send` throws, so the delivery is retried per
- *   `attempts` / `backoff` and ends in `failedJobs()` when exhausted.
- * - A channel missing from the worker's notifications config fails at once,
- *   without retries.
- *
- * @example src/config/notifications.ts
- * import { queueNotificationDispatcher } from "@warlock.js/queue/notifications";
- *
- * const config: NotificationConfig = {
- *   channels: { mail: mailChannel() },
- *   queue: queueNotificationDispatcher({ attempts: 3, backoff: { type: "exponential", delay: 5000 } }),
- * };
- */
-declare function queueNotificationDispatcher(options?: QueueNotificationDispatcherOptions): QueueDispatcher;
-//#endregion
-export { NOTIFICATION_JOB_NAME, NotificationJobPayload, QueueNotificationDispatcherOptions, queueNotificationDispatcher };
-//# sourceMappingURL=queue-notification-dispatcher.d.mts.map

package/esm/notifications/queue-notification-dispatcher.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-notification-dispatcher.d.mts","names":[],"sources":["../../../../../../../queue/src/notifications/queue-notification-dispatcher.ts"],"mappings":";;;;AAoB+D;AAAA,cAFlD,qBAAA;AAAA,KAED,sBAAA,GAAyB,UAAU,CAAC,eAAA;AAAA,KAEpC,kCAAA;EAMU,uDAJpB,KAAA,WAEA;EAAA,QAAA,WAEU;EAAV,OAAA,GAAU,UAAU;AAAA;AAqBtB;;;;;;;;AAEkB;;;;;;;;;;AAFlB,iBAAgB,2BAAA,CACd,OAAA,GAAS,kCAAA,GACR,eAAe"}