@warlock.js/queue 5.13.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog — @warlock.js/queue
+
+All notable changes to `@warlock.js/queue` are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
+
+## 5.13.0 - 2026-09-17
+
+### Added
+
+- New package: durable background jobs on BullMQ + Redis. Redis is required.
+- `defineJob({ name, queue, attempts, backoff, removeOnComplete, removeOnFail, handle(payload, ctx) })` returns a typed job with `dispatch(payload, { delay, priority, jobId, attempts, backoff })` and `find(id)`.
+- Job context: `id`, `name`, `queue`, `attempt`, `maxAttempts`, `progress(value)`, `log(line)`.
+- `failedJobs({ queue, start, end })` and `retryFailedJob(id, { queue })`.
+- `queueConnector()` for `warlock.config.ts > connectors`: reads the `queue` config key, starts workers in the app process (turn off with `workers.enabled: false`), and on shutdown waits for active jobs up to `workers.shutdownTimeout` before closing.
+- `setQueueConfig`, `startWorkers`, `closeQueue` for scripts, tests and worker-only processes.
+- `@warlock.js/queue/notifications`: `queueNotificationDispatcher()` sends `@warlock.js/notifications` `.queue()` deliveries through BullMQ, with retries and `delay` support.
+- `queueDashboard(server, { basePath })`: mounts bull-board on Warlock's Fastify server. `@bull-board/api` and `@bull-board/fastify` are optional peers, loaded only when it is called; a missing one throws `QueueDashboardDependencyError`.
+
+### Fixed
+
+- Portable `typecheck` script: runs against this package's own `typescript` devDependency instead of relying on a hoisted binary from elsewhere in the workspace.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Hassan Zohdy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# @warlock.js/queue
+
+Durable background jobs for Warlock.js, built on [BullMQ](https://docs.bullmq.io).
+
+- `defineJob({ name, handle, attempts, backoff })` → a typed job with `.dispatch(payload, { delay, priority, jobId })`
+- Retries with fixed or exponential backoff, delays, priorities, progress
+- Failed-job listing and retry (`failedJobs()`, `retryFailedJob()`)
+- Workers run inside the app process by default and shut down gracefully (active jobs finish first, with a time limit)
+- A BullMQ backend for `@warlock.js/notifications` `.queue()`
+- An optional bull-board dashboard
+
+## Requirements
+
+**Redis is required.** BullMQ stores every job in Redis (5.0 or newer; any Redis-compatible server BullMQ supports, such as Valkey or Dragonfly, also works). This package does not start or bundle Redis.
+
+## Not the same as core's `Queue`
+
+`@warlock.js/core` exports a `Queue` class (`core/src/utils/queue.ts`). That one is an **in-memory batcher inside one process**: it collects items and flushes them when a size or time limit is reached. Nothing is stored; items are lost when the process exits; there are no retries.
+
+`@warlock.js/queue` is for **durable jobs**: they are stored in Redis, survive restarts, retry on failure, and can be processed by another process.
+
+## Install
+
+```sh
+npm install @warlock.js/queue
+```
+
+## Configure
+
+```ts title="src/config/queue.ts"
+import type { QueueConfig } from "@warlock.js/queue";
+
+const queueConfig: QueueConfig = {
+  connection: { host: "127.0.0.1", port: 6379 },
+  prefix: "my-app",
+  defaultJobOptions: { attempts: 3, backoff: { type: "exponential", delay: 1000 } },
+  workers: { enabled: true, concurrency: 5, shutdownTimeout: 30_000 },
+};
+
+export default queueConfig;
+```
+
+```ts title="warlock.config.ts"
+import { defineConfig } from "@warlock.js/core";
+import { queueConnector } from "@warlock.js/queue";
+
+export default defineConfig({
+  connectors: [queueConnector()],
+});
+```
+
+The connector starts after your app code is loaded, so every `defineJob` is registered before workers start. On shutdown (SIGINT/SIGTERM) it stops the workers, waits up to `shutdownTimeout` ms for running jobs, then closes the Redis connections.
+
+Set `workers.enabled: false` in a process that should only dispatch jobs.
+
+## Define and dispatch
+
+```ts
+import { defineJob } from "@warlock.js/queue";
+
+export const sendInvoice = defineJob({
+  name: "invoices.send",
+  attempts: 5,
+  backoff: { type: "exponential", delay: 2000 },
+  async handle(payload: { invoiceId: string }, ctx) {
+    await ctx.progress(10);
+    // ... work ...
+    await ctx.progress(100);
+    return { sent: true };
+  },
+});
+
+await sendInvoice.dispatch({ invoiceId: "42" });
+await sendInvoice.dispatch({ invoiceId: "43" }, { delay: "10m", priority: 1, jobId: "invoice:43" });
+
+const snapshot = await sendInvoice.find("invoice:43"); // state, progress, result, failedReason
+```
+
+## Failed jobs
+
+```ts
+import { failedJobs, retryFailedJob } from "@warlock.js/queue";
+
+for (const job of await failedJobs()) {
+  console.log(job.name, job.failedReason, job.attemptsMade);
+}
+
+await retryFailedJob("invoice:43");
+```
+
+## Notifications
+
+```ts title="src/config/notifications.ts"
+import { queueNotificationDispatcher } from "@warlock.js/queue/notifications";
+
+const config: NotificationConfig = {
+  channels: { mail: mailChannel() },
+  queue: queueNotificationDispatcher({ attempts: 3 }),
+};
+```
+
+`.queue()` notifications now go through BullMQ. `SendOptions.delay` is honoured.
+
+## Dashboard (optional)
+
+```sh
+npm install @bull-board/api @bull-board/fastify
+```
+
+```ts
+import { getHttpServer } from "@warlock.js/core";
+import { queueDashboard } from "@warlock.js/queue";
+
+await queueDashboard(getHttpServer(), { basePath: "/admin/queues" });
+```
+
+The bull-board packages are loaded only when `queueDashboard` is called. If they are missing it throws `QueueDashboardDependencyError` with the install command. Protect the route yourself; the dashboard can retry and delete jobs.
+
+## License
+
+MIT

package/cjs/define-job-DideGKQK.cjs

@@ -0,0 +1,468 @@
+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

@@ -0,0 +1 @@
+{"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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"}