@warlock.js/queue 5.13.0 → 5.14.0

package/esm/dashboard-boot.mjs

@@ -0,0 +1,38 @@
+import { queueDashboard } from "./dashboard.mjs";
+import { QueueDashboardUnguardedError } from "./queue-dashboard-unguarded.error.mjs";
+import { log } from "@warlock.js/logger";
+
+//#region ../queue/src/dashboard-boot.ts
+/** Default path the dashboard mounts on when `dashboard.path` is not set. */
+const DEFAULT_DASHBOARD_PATH = "/admin/queues";
+/**
+* Mount the bull-board dashboard for `queue.dashboard` in `config`, applying
+* the safety rule: `enabled` in production with no middleware throws
+* {@link QueueDashboardUnguardedError} instead of booting exposed; outside
+* production with no middleware it logs one warning and mounts anyway.
+*
+* Called by `queueConnector()` at boot, once the HTTP server exists but
+* before it starts listening — see `queue-connector.ts`. Exported so it can
+* be unit-tested without going through the whole connector lifecycle.
+*/
+async function mountQueueDashboard(server, config) {
+	const dashboard = config.dashboard;
+	if (!dashboard?.enabled) return;
+	const middlewareList = dashboard.middleware ?? [];
+	if (middlewareList.length === 0) {
+		if (process.env.NODE_ENV === "production") throw new QueueDashboardUnguardedError();
+		log.warn("queue", "dashboard", "queue.dashboard.enabled is true with no middleware. The dashboard can retry and delete jobs — add a guard middleware before this ships to production.");
+	}
+	if (!server) {
+		log.warn("queue", "dashboard", "queue.dashboard.enabled is true but no HTTP server was found; the dashboard was not mounted.");
+		return;
+	}
+	await queueDashboard(server, {
+		basePath: dashboard.path ?? "/admin/queues",
+		middleware: middlewareList
+	});
+}
+
+//#endregion
+export { DEFAULT_DASHBOARD_PATH, mountQueueDashboard };
+//# sourceMappingURL=dashboard-boot.mjs.map

package/esm/dashboard-boot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-boot.mjs","names":[],"sources":["../../../../../../queue/src/dashboard-boot.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\nimport { type DashboardServer, queueDashboard } from \"./dashboard\";\nimport { QueueDashboardUnguardedError } from \"./queue-dashboard-unguarded.error\";\nimport type { QueueConfig } from \"./types\";\n\n/** Default path the dashboard mounts on when `dashboard.path` is not set. */\nexport const DEFAULT_DASHBOARD_PATH = \"/admin/queues\";\n\n/**\n * Mount the bull-board dashboard for `queue.dashboard` in `config`, applying\n * the safety rule: `enabled` in production with no middleware throws\n * {@link QueueDashboardUnguardedError} instead of booting exposed; outside\n * production with no middleware it logs one warning and mounts anyway.\n *\n * Called by `queueConnector()` at boot, once the HTTP server exists but\n * before it starts listening — see `queue-connector.ts`. Exported so it can\n * be unit-tested without going through the whole connector lifecycle.\n */\nexport async function mountQueueDashboard(\n  server: DashboardServer | undefined,\n  config: QueueConfig,\n): Promise<void> {\n  const dashboard = config.dashboard;\n\n  if (!dashboard?.enabled) {\n    return;\n  }\n\n  const middlewareList = dashboard.middleware ?? [];\n\n  if (middlewareList.length === 0) {\n    if (process.env.NODE_ENV === \"production\") {\n      throw new QueueDashboardUnguardedError();\n    }\n\n    log.warn(\n      \"queue\",\n      \"dashboard\",\n      \"queue.dashboard.enabled is true with no middleware. The dashboard can retry and delete \" +\n        \"jobs — add a guard middleware before this ships to production.\",\n    );\n  }\n\n  if (!server) {\n    log.warn(\n      \"queue\",\n      \"dashboard\",\n      \"queue.dashboard.enabled is true but no HTTP server was found; the dashboard was not mounted.\",\n    );\n\n    return;\n  }\n\n  await queueDashboard(server, {\n    basePath: dashboard.path ?? DEFAULT_DASHBOARD_PATH,\n    middleware: middlewareList,\n  });\n}\n"],"mappings":";;;;;;AAMA,MAAa,yBAAyB;;;;;;;;;;;AAYtC,eAAsB,oBACpB,QACA,QACe;CACf,MAAM,YAAY,OAAO;CAEzB,IAAI,CAAC,WAAW,SACd;CAGF,MAAM,iBAAiB,UAAU,cAAc,CAAC;CAEhD,IAAI,eAAe,WAAW,GAAG;EAC/B,IAAI,QAAQ,IAAI,aAAa,cAC3B,MAAM,IAAI,6BAA6B;EAGzC,IAAI,KACF,SACA,aACA,uJAEF;CACF;CAEA,IAAI,CAAC,QAAQ;EACX,IAAI,KACF,SACA,aACA,8FACF;EAEA;CACF;CAEA,MAAM,eAAe,QAAQ;EAC3B,UAAU,UAAU;EACpB,YAAY;CACd,CAAC;AACH"}

package/esm/dashboard-guard-plugin.mjs

@@ -0,0 +1,28 @@
+import { runDashboardMiddleware } from "./dashboard-middleware-adapter.mjs";
+
+//#region ../queue/src/dashboard-guard-plugin.ts
+/**
+* Wrap bull-board's Fastify plugin in a scope that runs `middlewareList`
+* on every request before bull-board's own routes see it.
+*
+* Bull-board's `FastifyAdapter.registerPlugin()` returns a plain Fastify
+* plugin with no hook for Warlock middleware to run through, and Fastify
+* only lets an `onRequest` hook be added to a plugin scope — never spliced
+* into a plugin someone else wrote. So this builds ONE plugin that adds the
+* hook to its own scope and then registers bull-board's plugin as a child of
+* that scope; Fastify's encapsulation runs the hook for every route the
+* child registers, which is every dashboard route.
+*/
+function buildDashboardGuardPlugin(middlewareList, bullBoardPlugin) {
+	return function dashboardGuardPlugin(instance, _options, done) {
+		if (middlewareList.length > 0) instance.addHook("onRequest", async (request, reply) => {
+			await runDashboardMiddleware(middlewareList, request, reply);
+		});
+		instance.register(bullBoardPlugin);
+		done();
+	};
+}
+
+//#endregion
+export { buildDashboardGuardPlugin };
+//# sourceMappingURL=dashboard-guard-plugin.mjs.map

package/esm/dashboard-guard-plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-guard-plugin.mjs","names":[],"sources":["../../../../../../queue/src/dashboard-guard-plugin.ts"],"sourcesContent":["import type { Middleware } from \"@warlock.js/core\";\nimport type { FastifyInstance, FastifyPluginCallback } from \"fastify\";\nimport { runDashboardMiddleware } from \"./dashboard-middleware-adapter\";\n\n/**\n * Wrap bull-board's Fastify plugin in a scope that runs `middlewareList`\n * on every request before bull-board's own routes see it.\n *\n * Bull-board's `FastifyAdapter.registerPlugin()` returns a plain Fastify\n * plugin with no hook for Warlock middleware to run through, and Fastify\n * only lets an `onRequest` hook be added to a plugin scope — never spliced\n * into a plugin someone else wrote. So this builds ONE plugin that adds the\n * hook to its own scope and then registers bull-board's plugin as a child of\n * that scope; Fastify's encapsulation runs the hook for every route the\n * child registers, which is every dashboard route.\n */\nexport function buildDashboardGuardPlugin(\n  middlewareList: Middleware[],\n  bullBoardPlugin: unknown,\n): FastifyPluginCallback {\n  return function dashboardGuardPlugin(instance: FastifyInstance, _options, done) {\n    if (middlewareList.length > 0) {\n      instance.addHook(\"onRequest\", async (request, reply) => {\n        await runDashboardMiddleware(middlewareList, request, reply);\n      });\n    }\n\n    instance.register(bullBoardPlugin as never);\n    done();\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,0BACd,gBACA,iBACuB;CACvB,OAAO,SAAS,qBAAqB,UAA2B,UAAU,MAAM;EAC9E,IAAI,eAAe,SAAS,GAC1B,SAAS,QAAQ,aAAa,OAAO,SAAS,UAAU;GACtD,MAAM,uBAAuB,gBAAgB,SAAS,KAAK;EAC7D,CAAC;EAGH,SAAS,SAAS,eAAwB;EAC1C,KAAK;CACP;AACF"}

package/esm/dashboard-middleware-adapter.mjs

@@ -0,0 +1,39 @@
+//#region ../queue/src/dashboard-middleware-adapter.ts
+/**
+* Run a Warlock middleware list against a raw Fastify request/reply pair.
+*
+* Bull-board's `FastifyAdapter` hands back a plain Fastify plugin, not a
+* Warlock route — there is no `Route`, no validation pipeline, and none of
+* `createRequestStore`'s context wiring (CSP, tracing, `@warlock.js/context`
+* stores). Reusing that full pipeline here would pull the whole request
+* machinery into a place it was never meant to run. Instead this builds the
+* minimal `Request`/`Response` pair — enough for guard-style middleware
+* (`authMiddleware`, `ipFilterMiddleware`, a custom check) to read the
+* request and short-circuit with a response, which covers every one of
+* bull-board's routes because they all sit behind the same hook.
+*
+* `@warlock.js/core` is imported dynamically so this module never drags
+* core's runtime graph into a process that never mounts the dashboard.
+*
+* @returns `true` when a middleware sent a response and the caller must not
+* continue (bull-board's handler must not run); `false` to continue.
+*/
+async function runDashboardMiddleware(middlewareList, fastifyRequest, fastifyReply) {
+	if (middlewareList.length === 0) return false;
+	const { Request, Response } = await import("@warlock.js/core");
+	const request = new Request();
+	const response = new Response();
+	response.setResponse(fastifyReply);
+	request.response = response;
+	response.request = request;
+	request.setRequest(fastifyRequest);
+	for (const middlewareFunction of middlewareList) if (await middlewareFunction({
+		request,
+		response
+	})) return true;
+	return false;
+}
+
+//#endregion
+export { runDashboardMiddleware };
+//# sourceMappingURL=dashboard-middleware-adapter.mjs.map

package/esm/dashboard-middleware-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-middleware-adapter.mjs","names":[],"sources":["../../../../../../queue/src/dashboard-middleware-adapter.ts"],"sourcesContent":["import type { Middleware } from \"@warlock.js/core\";\nimport type { FastifyReply, FastifyRequest } from \"fastify\";\n\n/**\n * Run a Warlock middleware list against a raw Fastify request/reply pair.\n *\n * Bull-board's `FastifyAdapter` hands back a plain Fastify plugin, not a\n * Warlock route — there is no `Route`, no validation pipeline, and none of\n * `createRequestStore`'s context wiring (CSP, tracing, `@warlock.js/context`\n * stores). Reusing that full pipeline here would pull the whole request\n * machinery into a place it was never meant to run. Instead this builds the\n * minimal `Request`/`Response` pair — enough for guard-style middleware\n * (`authMiddleware`, `ipFilterMiddleware`, a custom check) to read the\n * request and short-circuit with a response, which covers every one of\n * bull-board's routes because they all sit behind the same hook.\n *\n * `@warlock.js/core` is imported dynamically so this module never drags\n * core's runtime graph into a process that never mounts the dashboard.\n *\n * @returns `true` when a middleware sent a response and the caller must not\n * continue (bull-board's handler must not run); `false` to continue.\n */\nexport async function runDashboardMiddleware(\n  middlewareList: Middleware[],\n  fastifyRequest: FastifyRequest,\n  fastifyReply: FastifyReply,\n): Promise<boolean> {\n  if (middlewareList.length === 0) {\n    return false;\n  }\n\n  const { Request, Response } = await import(\"@warlock.js/core\");\n\n  const request = new Request();\n  const response = new Response();\n\n  response.setResponse(fastifyReply);\n  request.response = response;\n  response.request = request;\n  request.setRequest(fastifyRequest);\n\n  for (const middlewareFunction of middlewareList) {\n    const result = await middlewareFunction({ request, response });\n\n    if (result) {\n      return true;\n    }\n  }\n\n  return false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,eAAsB,uBACpB,gBACA,gBACA,cACkB;CAClB,IAAI,eAAe,WAAW,GAC5B,OAAO;CAGT,MAAM,EAAE,SAAS,aAAa,MAAM,OAAO;CAE3C,MAAM,UAAU,IAAI,QAAQ;CAC5B,MAAM,WAAW,IAAI,SAAS;CAE9B,SAAS,YAAY,YAAY;CACjC,QAAQ,WAAW;CACnB,SAAS,UAAU;CACnB,QAAQ,WAAW,cAAc;CAEjC,KAAK,MAAM,sBAAsB,gBAG/B,IAAI,MAFiB,mBAAmB;EAAE;EAAS;CAAS,CAAC,GAG3D,OAAO;CAIX,OAAO;AACT"}

package/esm/dashboard.d.mts

@@ -1,3 +1,5 @@
+import { Middleware } from "@warlock.js/core";
+
 //#region ../queue/src/dashboard.d.ts
 /**
  * The part of a Fastify instance the dashboard needs. Warlock's HTTP server
@@ -11,6 +13,12 @@ type DashboardServer = {
 type QueueDashboardOptions = {
   /** URL prefix the dashboard is mounted on. Default `"/admin/queues"`. */basePath?: string; /** Queues to show. Default: every queue with a defined job, plus the default queue. */
   queues?: string[];
+  /**
+   * Run before every dashboard route. Applied via a wrapping Fastify plugin
+   * scope, since bull-board's own plugin has no hook to splice Warlock
+   * middleware into — see `dashboard-guard-plugin.ts`.
+   */
+  middleware?: Middleware[];
 };
 type BullBoardModules = {
   createBullBoard: (options: {

package/esm/dashboard.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.mts","names":[],"sources":["../../../../../../queue/src/dashboard.ts"],"mappings":";;AASA;;;KAAY,eAAA;EACV,QAAA,CAAS,MAAA,SAAe,OAAA;IAAW,MAAA;EAAA;AAAA;AAAA,KAGzB,qBAAA;EAHyC,yEAKnD,QAAA,WAF+B;EAI/B,MAAM;AAAA;AAAA,KAGH,gBAAA;EACH,eAAA,GAAkB,OAAA;IAAW,MAAA;IAAmB,aAAA;EAAA;EAChD,aAAA,OAAoB,KAAA;EACpB,cAAA;IACE,WAAA,CAAY,IAAA;IACZ,cAAA;EAAA;AAAA;;;;;;AAAc;AAiBlB;;;;;;;iBAAsB,cAAA,CACpB,MAAA,EAAQ,eAAA,EACR,OAAA,GAAS,qBAAA,GACR,OAAA;;;;;iBAqBmB,aAAA,CACpB,QAAA,IAAW,SAAA,aAAsB,OAAA,CAAQ,MAAA,qBACxC,OAAA,CAAQ,gBAAA"}
+{"version":3,"file":"dashboard.d.mts","names":[],"sources":["../../../../../../queue/src/dashboard.ts"],"mappings":";;;;;AAWA;;KAAY,eAAA;EACV,QAAA,CAAS,MAAA,SAAe,OAAA;IAAW,MAAA;EAAA;AAAA;AAAA,KAGzB,qBAAA;EAHyC,yEAKnD,QAAA,WAFU;EAIV,MAAA;;;;;;EAMA,UAAA,GAAa,UAAU;AAAA;AAAA,KAGpB,gBAAA;EACH,eAAA,GAAkB,OAAA;IAAW,MAAA;IAAmB,aAAA;EAAA;EAChD,aAAA,OAAoB,KAAA;EACpB,cAAA;IACE,WAAA,CAAY,IAAA;IACZ,cAAA;EAAA;AAAA;;;;;;AAAc;AAiBlB;;;;;;;iBAAsB,cAAA,CACpB,MAAA,EAAQ,eAAA,EACR,OAAA,GAAS,qBAAA,GACR,OAAA;;;;;iBAuBmB,aAAA,CACpB,QAAA,IAAW,SAAA,aAAsB,OAAA,CAAQ,MAAA,qBACxC,OAAA,CAAQ,gBAAA"}

package/esm/dashboard.mjs

@@ -1,5 +1,6 @@
 import { QueueDashboardDependencyError } from "./errors.mjs";
 import { defaultQueueName } from "./config.mjs";
+import { buildDashboardGuardPlugin } from "./dashboard-guard-plugin.mjs";
 import { queueOf, registeredJobs } from "./job-registry.mjs";
 import { getQueue } from "./queue-manager.mjs";
 
@@ -27,7 +28,8 @@ async function queueDashboard(server, options = {}) {
 		queues: queueNames.map((name) => new BullMQAdapter(getQueue(name))),
 		serverAdapter
 	});
-	await server.register(serverAdapter.registerPlugin(), { prefix: basePath });
+	const guardedPlugin = buildDashboardGuardPlugin(options.middleware ?? [], serverAdapter.registerPlugin());
+	await server.register(guardedPlugin, { prefix: basePath });
 }
 /**
 * Load the optional bull-board packages. Exported for tests of the missing

package/esm/dashboard.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.mjs","names":[],"sources":["../../../../../../queue/src/dashboard.ts"],"sourcesContent":["import { defaultQueueName } from \"./config\";\nimport { QueueDashboardDependencyError } from \"./errors\";\nimport { queueOf, registeredJobs } from \"./job-registry\";\nimport { getQueue } from \"./queue-manager\";\n\n/**\n * The part of a Fastify instance the dashboard needs. Warlock's HTTP server\n * (`getHttpServer()` from `@warlock.js/core`) satisfies it.\n */\nexport type DashboardServer = {\n  register(plugin: never, options: { prefix: string }): unknown;\n};\n\nexport type QueueDashboardOptions = {\n  /** URL prefix the dashboard is mounted on. Default `\"/admin/queues\"`. */\n  basePath?: string;\n  /** Queues to show. Default: every queue with a defined job, plus the default queue. */\n  queues?: string[];\n};\n\ntype BullBoardModules = {\n  createBullBoard: (options: { queues: unknown[]; serverAdapter: unknown }) => unknown;\n  BullMQAdapter: new (queue: unknown) => unknown;\n  FastifyAdapter: new () => {\n    setBasePath(path: string): unknown;\n    registerPlugin(): unknown;\n  };\n};\n\n/**\n * Mount the bull-board failed/active/delayed job UI on Warlock's Fastify\n * server. Requires the optional packages `@bull-board/api` and\n * `@bull-board/fastify`; they are loaded only when this is called, and a\n * missing one throws {@link QueueDashboardDependencyError}.\n *\n * Call it before the HTTP server starts listening, and put it behind your\n * own authentication — the dashboard can retry and delete jobs.\n *\n * @example\n * import { getHttpServer } from \"@warlock.js/core\";\n * await queueDashboard(getHttpServer(), { basePath: \"/admin/queues\" });\n */\nexport async function queueDashboard(\n  server: DashboardServer,\n  options: QueueDashboardOptions = {},\n): Promise<void> {\n  const basePath = options.basePath ?? \"/admin/queues\";\n  const { createBullBoard, BullMQAdapter, FastifyAdapter } = await loadBullBoard();\n  const queueNames =\n    options.queues ?? [...new Set([defaultQueueName(), ...registeredJobs().map((job) => queueOf(job))])];\n\n  const serverAdapter = new FastifyAdapter();\n  serverAdapter.setBasePath(basePath);\n\n  createBullBoard({\n    queues: queueNames.map((name) => new BullMQAdapter(getQueue(name))),\n    serverAdapter,\n  });\n\n  await server.register(serverAdapter.registerPlugin() as never, { prefix: basePath });\n}\n\n/**\n * Load the optional bull-board packages. Exported for tests of the missing\n * dependency path; `importer` defaults to a real dynamic import.\n */\nexport async function loadBullBoard(\n  importer: (specifier: string) => Promise<Record<string, unknown>> = (specifier) => import(specifier),\n): Promise<BullBoardModules> {\n  const api = await importOptional(importer, \"@bull-board/api\");\n  const adapter = await importOptional(importer, \"@bull-board/api/bullMQAdapter\");\n  const fastify = await importOptional(importer, \"@bull-board/fastify\");\n\n  return {\n    createBullBoard: api.createBullBoard as BullBoardModules[\"createBullBoard\"],\n    BullMQAdapter: adapter.BullMQAdapter as BullBoardModules[\"BullMQAdapter\"],\n    FastifyAdapter: fastify.FastifyAdapter as BullBoardModules[\"FastifyAdapter\"],\n  };\n}\n\nasync function importOptional(\n  importer: (specifier: string) => Promise<Record<string, unknown>>,\n  specifier: string,\n): Promise<Record<string, unknown>> {\n  try {\n    return await importer(specifier);\n  } catch (error) {\n    if (isModuleNotFound(error)) {\n      throw new QueueDashboardDependencyError(specifier.split(\"/\").slice(0, 2).join(\"/\"));\n    }\n\n    throw error;\n  }\n}\n\nfunction isModuleNotFound(error: unknown): boolean {\n  const code = (error as { code?: unknown } | undefined)?.code;\n\n  return code === \"ERR_MODULE_NOT_FOUND\" || code === \"MODULE_NOT_FOUND\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0CA,eAAsB,eACpB,QACA,UAAiC,CAAC,GACnB;CACf,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,EAAE,iBAAiB,eAAe,mBAAmB,MAAM,cAAc;CAC/E,MAAM,aACJ,QAAQ,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,iBAAiB,GAAG,GAAG,eAAe,CAAC,CAAC,KAAK,QAAQ,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;CAErG,MAAM,gBAAgB,IAAI,eAAe;CACzC,cAAc,YAAY,QAAQ;CAElC,gBAAgB;EACd,QAAQ,WAAW,KAAK,SAAS,IAAI,cAAc,SAAS,IAAI,CAAC,CAAC;EAClE;CACF,CAAC;CAED,MAAM,OAAO,SAAS,cAAc,eAAe,GAAY,EAAE,QAAQ,SAAS,CAAC;AACrF;;;;;AAMA,eAAsB,cACpB,YAAqE,cAAc,OAAO,YAC/D;CAC3B,MAAM,MAAM,MAAM,eAAe,UAAU,iBAAiB;CAC5D,MAAM,UAAU,MAAM,eAAe,UAAU,+BAA+B;CAC9E,MAAM,UAAU,MAAM,eAAe,UAAU,qBAAqB;CAEpE,OAAO;EACL,iBAAiB,IAAI;EACrB,eAAe,QAAQ;EACvB,gBAAgB,QAAQ;CAC1B;AACF;AAEA,eAAe,eACb,UACA,WACkC;CAClC,IAAI;EACF,OAAO,MAAM,SAAS,SAAS;CACjC,SAAS,OAAO;EACd,IAAI,iBAAiB,KAAK,GACxB,MAAM,IAAI,8BAA8B,UAAU,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;EAGpF,MAAM;CACR;AACF;AAEA,SAAS,iBAAiB,OAAyB;CACjD,MAAM,OAAQ,OAA0C;CAExD,OAAO,SAAS,0BAA0B,SAAS;AACrD"}
+{"version":3,"file":"dashboard.mjs","names":[],"sources":["../../../../../../queue/src/dashboard.ts"],"sourcesContent":["import type { Middleware } from \"@warlock.js/core\";\nimport { defaultQueueName } from \"./config\";\nimport { buildDashboardGuardPlugin } from \"./dashboard-guard-plugin\";\nimport { QueueDashboardDependencyError } from \"./errors\";\nimport { queueOf, registeredJobs } from \"./job-registry\";\nimport { getQueue } from \"./queue-manager\";\n\n/**\n * The part of a Fastify instance the dashboard needs. Warlock's HTTP server\n * (`getHttpServer()` from `@warlock.js/core`) satisfies it.\n */\nexport type DashboardServer = {\n  register(plugin: never, options: { prefix: string }): unknown;\n};\n\nexport type QueueDashboardOptions = {\n  /** URL prefix the dashboard is mounted on. Default `\"/admin/queues\"`. */\n  basePath?: string;\n  /** Queues to show. Default: every queue with a defined job, plus the default queue. */\n  queues?: string[];\n  /**\n   * Run before every dashboard route. Applied via a wrapping Fastify plugin\n   * scope, since bull-board's own plugin has no hook to splice Warlock\n   * middleware into — see `dashboard-guard-plugin.ts`.\n   */\n  middleware?: Middleware[];\n};\n\ntype BullBoardModules = {\n  createBullBoard: (options: { queues: unknown[]; serverAdapter: unknown }) => unknown;\n  BullMQAdapter: new (queue: unknown) => unknown;\n  FastifyAdapter: new () => {\n    setBasePath(path: string): unknown;\n    registerPlugin(): unknown;\n  };\n};\n\n/**\n * Mount the bull-board failed/active/delayed job UI on Warlock's Fastify\n * server. Requires the optional packages `@bull-board/api` and\n * `@bull-board/fastify`; they are loaded only when this is called, and a\n * missing one throws {@link QueueDashboardDependencyError}.\n *\n * Call it before the HTTP server starts listening, and put it behind your\n * own authentication — the dashboard can retry and delete jobs.\n *\n * @example\n * import { getHttpServer } from \"@warlock.js/core\";\n * await queueDashboard(getHttpServer(), { basePath: \"/admin/queues\" });\n */\nexport async function queueDashboard(\n  server: DashboardServer,\n  options: QueueDashboardOptions = {},\n): Promise<void> {\n  const basePath = options.basePath ?? \"/admin/queues\";\n  const { createBullBoard, BullMQAdapter, FastifyAdapter } = await loadBullBoard();\n  const queueNames =\n    options.queues ?? [...new Set([defaultQueueName(), ...registeredJobs().map((job) => queueOf(job))])];\n\n  const serverAdapter = new FastifyAdapter();\n  serverAdapter.setBasePath(basePath);\n\n  createBullBoard({\n    queues: queueNames.map((name) => new BullMQAdapter(getQueue(name))),\n    serverAdapter,\n  });\n\n  const guardedPlugin = buildDashboardGuardPlugin(options.middleware ?? [], serverAdapter.registerPlugin());\n\n  await server.register(guardedPlugin as never, { prefix: basePath });\n}\n\n/**\n * Load the optional bull-board packages. Exported for tests of the missing\n * dependency path; `importer` defaults to a real dynamic import.\n */\nexport async function loadBullBoard(\n  importer: (specifier: string) => Promise<Record<string, unknown>> = (specifier) => import(specifier),\n): Promise<BullBoardModules> {\n  const api = await importOptional(importer, \"@bull-board/api\");\n  const adapter = await importOptional(importer, \"@bull-board/api/bullMQAdapter\");\n  const fastify = await importOptional(importer, \"@bull-board/fastify\");\n\n  return {\n    createBullBoard: api.createBullBoard as BullBoardModules[\"createBullBoard\"],\n    BullMQAdapter: adapter.BullMQAdapter as BullBoardModules[\"BullMQAdapter\"],\n    FastifyAdapter: fastify.FastifyAdapter as BullBoardModules[\"FastifyAdapter\"],\n  };\n}\n\nasync function importOptional(\n  importer: (specifier: string) => Promise<Record<string, unknown>>,\n  specifier: string,\n): Promise<Record<string, unknown>> {\n  try {\n    return await importer(specifier);\n  } catch (error) {\n    if (isModuleNotFound(error)) {\n      throw new QueueDashboardDependencyError(specifier.split(\"/\").slice(0, 2).join(\"/\"));\n    }\n\n    throw error;\n  }\n}\n\nfunction isModuleNotFound(error: unknown): boolean {\n  const code = (error as { code?: unknown } | undefined)?.code;\n\n  return code === \"ERR_MODULE_NOT_FOUND\" || code === \"MODULE_NOT_FOUND\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkDA,eAAsB,eACpB,QACA,UAAiC,CAAC,GACnB;CACf,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,EAAE,iBAAiB,eAAe,mBAAmB,MAAM,cAAc;CAC/E,MAAM,aACJ,QAAQ,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,iBAAiB,GAAG,GAAG,eAAe,CAAC,CAAC,KAAK,QAAQ,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;CAErG,MAAM,gBAAgB,IAAI,eAAe;CACzC,cAAc,YAAY,QAAQ;CAElC,gBAAgB;EACd,QAAQ,WAAW,KAAK,SAAS,IAAI,cAAc,SAAS,IAAI,CAAC,CAAC;EAClE;CACF,CAAC;CAED,MAAM,gBAAgB,0BAA0B,QAAQ,cAAc,CAAC,GAAG,cAAc,eAAe,CAAC;CAExG,MAAM,OAAO,SAAS,eAAwB,EAAE,QAAQ,SAAS,CAAC;AACpE;;;;;AAMA,eAAsB,cACpB,YAAqE,cAAc,OAAO,YAC/D;CAC3B,MAAM,MAAM,MAAM,eAAe,UAAU,iBAAiB;CAC5D,MAAM,UAAU,MAAM,eAAe,UAAU,+BAA+B;CAC9E,MAAM,UAAU,MAAM,eAAe,UAAU,qBAAqB;CAEpE,OAAO;EACL,iBAAiB,IAAI;EACrB,eAAe,QAAQ;EACvB,gBAAgB,QAAQ;CAC1B;AACF;AAEA,eAAe,eACb,UACA,WACkC;CAClC,IAAI;EACF,OAAO,MAAM,SAAS,SAAS;CACjC,SAAS,OAAO;EACd,IAAI,iBAAiB,KAAK,GACxB,MAAM,IAAI,8BAA8B,UAAU,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;EAGpF,MAAM;CACR;AACF;AAEA,SAAS,iBAAiB,OAAyB;CACjD,MAAM,OAAQ,OAA0C;CAExD,OAAO,SAAS,0BAA0B,SAAS;AACrD"}

package/esm/define-job.mjs

@@ -41,9 +41,11 @@ function defineJob(definition) {
 			};
 		},
 		async find(id) {
-			const job = await getQueue(queueOf(definition)).getJob(id);
-			if (!job || job.name !== definition.name) return;
-			return toSnapshot(job);
+			const queue = getQueue(queueOf(definition));
+			const initialJob = await queue.getJob(id);
+			if (!initialJob || initialJob.name !== definition.name) return;
+			const state = await initialJob.getState();
+			return toSnapshot(await queue.getJob(id) ?? initialJob, state);
 		}
 	};
 }
@@ -79,14 +81,19 @@ function toBullBackoff(backoff) {
 }
 /**
 * A plain view of a BullMQ job.
+*
+* @param job The job to read fields from.
+* @param state The job's state; pass a state read *before* `job` was
+* fetched (or re-fetched) so the returned snapshot's fields are consistent
+* with it. If omitted, the state is read from `job` directly.
 */
-async function toSnapshot(job) {
-	const state = await job.getState();
+async function toSnapshot(job, state) {
+	const resolvedState = state ?? await job.getState();
 	return {
 		id: String(job.id),
 		name: job.name,
 		queue: job.queueName,
-		state,
+		state: resolvedState,
 		payload: job.data,
 		progress: job.progress,
 		attemptsMade: job.attemptsMade,

package/esm/define-job.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"define-job.mjs","names":[],"sources":["../../../../../../queue/src/define-job.ts"],"sourcesContent":["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":";;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,UACd,YAC6B;CAC7B,sBAAsB,UAAU;CAChC,YAAY,UAA2B;CAEvC,OAAO;EACL,MAAM,WAAW;EACjB,IAAI,QAAQ;GACV,OAAO,QAAQ,UAAU;EAC3B;EACA,MAAM,SAAS,SAAS,UAAU,CAAC,GAAG;GACpC,MAAM,YAAY,QAAQ,UAAU;GACpC,MAAM,MAAM,MAAM,SAAS,SAAS,CAAC,CAAC,IACpC,WAAW,MACX,SACA,iBAAiB,YAAY,OAAO,CACtC;GAEA,OAAO;IAAE,IAAI,OAAO,IAAI,EAAE;IAAG,MAAM,WAAW;IAAM,OAAO;GAAU;EACvE;EACA,MAAM,KAAK,IAAI;GACb,MAAM,MAAM,MAAM,SAAS,QAAQ,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE;GAEzD,IAAI,CAAC,OAAO,IAAI,SAAS,WAAW,MAClC;GAGF,OAAO,WAA8B,GAAG;EAC1C;CACF;AACF;AAEA,SAAS,sBAAsB,YAAmD;CAChF,IAAI,OAAO,WAAW,SAAS,YAAY,WAAW,KAAK,KAAK,MAAM,IACpE,MAAM,IAAI,0BAA0B,0CAA0C;CAGhF,IAAI,OAAO,WAAW,WAAW,YAC/B,MAAM,IAAI,0BACR,cAAc,WAAW,KAAK,iDAChC;CAGF,IAAI,WAAW,aAAa,UAAa,EAAE,OAAO,UAAU,WAAW,QAAQ,KAAK,WAAW,YAAY,IACzG,MAAM,IAAI,0BACR,cAAc,WAAW,KAAK,gDAAgD,WAAW,SAAS,EACpG;AAEJ;;;;AAKA,SAAS,iBAAiB,YAAwB,SAAuC;CACvF,MAAM,WAAW,eAAe,CAAC,CAAC,qBAAqB,CAAC;CACxD,MAAM,WAAW,QAAQ,YAAY,WAAW,YAAY,SAAS;CACrE,MAAM,UAAU,QAAQ,WAAW,WAAW,WAAW,SAAS;CAClE,MAAM,mBAAmB,WAAW,oBAAoB,SAAS;CACjE,MAAM,eAAe,WAAW,gBAAgB,SAAS;CAEzD,MAAM,cAA2B,CAAC;CAElC,IAAI,aAAa,QAAW,YAAY,WAAW;CACnD,IAAI,YAAY,QAAW,YAAY,UAAU,cAAc,OAAO;CACtE,IAAI,qBAAqB,QAAW,YAAY,mBAAmB;CACnE,IAAI,iBAAiB,QAAW,YAAY,eAAe;CAC3D,IAAI,QAAQ,UAAU,QAAW,YAAY,QAAQ,eAAe,QAAQ,KAAK;CACjF,IAAI,QAAQ,aAAa,QAAW,YAAY,WAAW,QAAQ;CACnE,IAAI,QAAQ,UAAU,QAAW,YAAY,QAAQ,QAAQ;CAE7D,OAAO;AACT;AAEA,SAAS,cAAc,SAA6C;CAClE,OAAO,OAAO,YAAY,WAAW;EAAE,MAAM;EAAS,OAAO;CAAQ,IAAI;AAC3E;;;;AAKA,eAAsB,WACpB,KACyC;CACzC,MAAM,QAAS,MAAM,IAAI,SAAS;CAElC,OAAO;EACL,IAAI,OAAO,IAAI,EAAE;EACjB,MAAM,IAAI;EACV,OAAO,IAAI;EACX;EACA,SAAS,IAAI;EACb,UAAU,IAAI;EACd,cAAc,IAAI;EAClB,QAAQ,IAAI;EACZ,cAAc,IAAI,gBAAgB;EAClC,WAAW,IAAI,KAAK,IAAI,SAAS;EACjC,YAAY,IAAI,aAAa,IAAI,KAAK,IAAI,UAAU,IAAI;CAC1D;AACF"}
+{"version":3,"file":"define-job.mjs","names":[],"sources":["../../../../../../queue/src/define-job.ts"],"sourcesContent":["import type { Job, JobsOptions } from \"bullmq\";\r\nimport { getQueueConfig } from \"./config\";\r\nimport { toMilliseconds } from \"./duration\";\r\nimport { InvalidJobDefinitionError } from \"./errors\";\r\nimport { queueOf, registerJob, type RegisteredJob } from \"./job-registry\";\r\nimport { getQueue } from \"./queue-manager\";\r\nimport type {\r\n  DispatchOptions,\r\n  JobBackoff,\r\n  JobDefinition,\r\n  JobOptions,\r\n  JobSnapshot,\r\n  JobState,\r\n  QueueJob,\r\n} from \"./types\";\r\n\r\n/**\r\n * Define a background job.\r\n *\r\n * The definition is registered by name so any worker in the process can run\r\n * it; the returned object dispatches it with a typed payload.\r\n *\r\n * @example\r\n * export const sendInvoice = defineJob({\r\n *   name: \"invoices.send\",\r\n *   attempts: 5,\r\n *   backoff: { type: \"exponential\", delay: 2000 },\r\n *   async handle(payload: { invoiceId: string }, ctx) {\r\n *     await ctx.progress(50);\r\n *   },\r\n * });\r\n *\r\n * await sendInvoice.dispatch({ invoiceId: \"42\" }, { delay: \"10m\", priority: 1 });\r\n */\r\nexport function defineJob<TPayload, TResult = unknown>(\r\n  definition: JobDefinition<TPayload, TResult>,\r\n): QueueJob<TPayload, TResult> {\r\n  assertValidDefinition(definition);\r\n  registerJob(definition as RegisteredJob);\r\n\r\n  return {\r\n    name: definition.name,\r\n    get queue() {\r\n      return queueOf(definition);\r\n    },\r\n    async dispatch(payload, options = {}) {\r\n      const queueName = queueOf(definition);\r\n      const job = await getQueue(queueName).add(\r\n        definition.name,\r\n        payload,\r\n        toBullJobOptions(definition, options),\r\n      );\r\n\r\n      return { id: String(job.id), name: definition.name, queue: queueName };\r\n    },\r\n    async find(id) {\r\n      const queue = getQueue(queueOf(definition));\r\n      const initialJob = await queue.getJob(id);\r\n\r\n      if (!initialJob || initialJob.name !== definition.name) {\r\n        return undefined;\r\n      }\r\n\r\n      // Read the state first, then (re)fetch the job. BullMQ writes a job's\r\n      // result/attemptsMade/finishedOn fields *before* it becomes visible\r\n      // under a new state, so re-reading the job after the state is known\r\n      // guarantees those fields are consistent with the reported state\r\n      // (rather than reflecting a moment before the job finished).\r\n      const state = (await initialJob.getState()) as JobState;\r\n      const job = (await queue.getJob(id)) ?? initialJob;\r\n\r\n      return toSnapshot<TPayload, TResult>(job, state);\r\n    },\r\n  };\r\n}\r\n\r\nfunction assertValidDefinition(definition: JobDefinition<unknown, unknown>): void {\r\n  if (typeof definition.name !== \"string\" || definition.name.trim() === \"\") {\r\n    throw new InvalidJobDefinitionError(\"defineJob() requires a non-empty `name`.\");\r\n  }\r\n\r\n  if (typeof definition.handle !== \"function\") {\r\n    throw new InvalidJobDefinitionError(\r\n      `defineJob(\"${definition.name}\") requires a \\`handle(payload, ctx)\\` function.`,\r\n    );\r\n  }\r\n\r\n  if (definition.attempts !== undefined && !(Number.isInteger(definition.attempts) && definition.attempts >= 1)) {\r\n    throw new InvalidJobDefinitionError(\r\n      `defineJob(\"${definition.name}\"): \\`attempts\\` must be an integer >= 1, got ${definition.attempts}.`,\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Merge app defaults < job definition < dispatch options into BullMQ's shape.\r\n */\r\nfunction toBullJobOptions(definition: JobOptions, options: DispatchOptions): JobsOptions {\r\n  const defaults = getQueueConfig().defaultJobOptions ?? {};\r\n  const attempts = options.attempts ?? definition.attempts ?? defaults.attempts;\r\n  const backoff = options.backoff ?? definition.backoff ?? defaults.backoff;\r\n  const removeOnComplete = definition.removeOnComplete ?? defaults.removeOnComplete;\r\n  const removeOnFail = definition.removeOnFail ?? defaults.removeOnFail;\r\n\r\n  const bullOptions: JobsOptions = {};\r\n\r\n  if (attempts !== undefined) bullOptions.attempts = attempts;\r\n  if (backoff !== undefined) bullOptions.backoff = toBullBackoff(backoff);\r\n  if (removeOnComplete !== undefined) bullOptions.removeOnComplete = removeOnComplete;\r\n  if (removeOnFail !== undefined) bullOptions.removeOnFail = removeOnFail;\r\n  if (options.delay !== undefined) bullOptions.delay = toMilliseconds(options.delay);\r\n  if (options.priority !== undefined) bullOptions.priority = options.priority;\r\n  if (options.jobId !== undefined) bullOptions.jobId = options.jobId;\r\n\r\n  return bullOptions;\r\n}\r\n\r\nfunction toBullBackoff(backoff: JobBackoff): JobsOptions[\"backoff\"] {\r\n  return typeof backoff === \"number\" ? { type: \"fixed\", delay: backoff } : backoff;\r\n}\r\n\r\n/**\r\n * A plain view of a BullMQ job.\r\n *\r\n * @param job The job to read fields from.\r\n * @param state The job's state; pass a state read *before* `job` was\r\n * fetched (or re-fetched) so the returned snapshot's fields are consistent\r\n * with it. If omitted, the state is read from `job` directly.\r\n */\r\nexport async function toSnapshot<TPayload, TResult>(\r\n  job: Job,\r\n  state?: JobState,\r\n): Promise<JobSnapshot<TPayload, TResult>> {\r\n  const resolvedState = state ?? ((await job.getState()) as JobState);\r\n\r\n  return {\r\n    id: String(job.id),\r\n    name: job.name,\r\n    queue: job.queueName,\r\n    state: resolvedState,\r\n    payload: job.data as TPayload,\r\n    progress: job.progress as JobSnapshot[\"progress\"],\r\n    attemptsMade: job.attemptsMade,\r\n    result: job.returnvalue as TResult | undefined,\r\n    failedReason: job.failedReason || undefined,\r\n    createdAt: new Date(job.timestamp),\r\n    finishedAt: job.finishedOn ? new Date(job.finishedOn) : undefined,\r\n  };\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,UACd,YAC6B;CAC7B,sBAAsB,UAAU;CAChC,YAAY,UAA2B;CAEvC,OAAO;EACL,MAAM,WAAW;EACjB,IAAI,QAAQ;GACV,OAAO,QAAQ,UAAU;EAC3B;EACA,MAAM,SAAS,SAAS,UAAU,CAAC,GAAG;GACpC,MAAM,YAAY,QAAQ,UAAU;GACpC,MAAM,MAAM,MAAM,SAAS,SAAS,CAAC,CAAC,IACpC,WAAW,MACX,SACA,iBAAiB,YAAY,OAAO,CACtC;GAEA,OAAO;IAAE,IAAI,OAAO,IAAI,EAAE;IAAG,MAAM,WAAW;IAAM,OAAO;GAAU;EACvE;EACA,MAAM,KAAK,IAAI;GACb,MAAM,QAAQ,SAAS,QAAQ,UAAU,CAAC;GAC1C,MAAM,aAAa,MAAM,MAAM,OAAO,EAAE;GAExC,IAAI,CAAC,cAAc,WAAW,SAAS,WAAW,MAChD;GAQF,MAAM,QAAS,MAAM,WAAW,SAAS;GAGzC,OAAO,WAFM,MAAM,MAAM,OAAO,EAAE,KAAM,YAEE,KAAK;EACjD;CACF;AACF;AAEA,SAAS,sBAAsB,YAAmD;CAChF,IAAI,OAAO,WAAW,SAAS,YAAY,WAAW,KAAK,KAAK,MAAM,IACpE,MAAM,IAAI,0BAA0B,0CAA0C;CAGhF,IAAI,OAAO,WAAW,WAAW,YAC/B,MAAM,IAAI,0BACR,cAAc,WAAW,KAAK,iDAChC;CAGF,IAAI,WAAW,aAAa,UAAa,EAAE,OAAO,UAAU,WAAW,QAAQ,KAAK,WAAW,YAAY,IACzG,MAAM,IAAI,0BACR,cAAc,WAAW,KAAK,gDAAgD,WAAW,SAAS,EACpG;AAEJ;;;;AAKA,SAAS,iBAAiB,YAAwB,SAAuC;CACvF,MAAM,WAAW,eAAe,CAAC,CAAC,qBAAqB,CAAC;CACxD,MAAM,WAAW,QAAQ,YAAY,WAAW,YAAY,SAAS;CACrE,MAAM,UAAU,QAAQ,WAAW,WAAW,WAAW,SAAS;CAClE,MAAM,mBAAmB,WAAW,oBAAoB,SAAS;CACjE,MAAM,eAAe,WAAW,gBAAgB,SAAS;CAEzD,MAAM,cAA2B,CAAC;CAElC,IAAI,aAAa,QAAW,YAAY,WAAW;CACnD,IAAI,YAAY,QAAW,YAAY,UAAU,cAAc,OAAO;CACtE,IAAI,qBAAqB,QAAW,YAAY,mBAAmB;CACnE,IAAI,iBAAiB,QAAW,YAAY,eAAe;CAC3D,IAAI,QAAQ,UAAU,QAAW,YAAY,QAAQ,eAAe,QAAQ,KAAK;CACjF,IAAI,QAAQ,aAAa,QAAW,YAAY,WAAW,QAAQ;CACnE,IAAI,QAAQ,UAAU,QAAW,YAAY,QAAQ,QAAQ;CAE7D,OAAO;AACT;AAEA,SAAS,cAAc,SAA6C;CAClE,OAAO,OAAO,YAAY,WAAW;EAAE,MAAM;EAAS,OAAO;CAAQ,IAAI;AAC3E;;;;;;;;;AAUA,eAAsB,WACpB,KACA,OACyC;CACzC,MAAM,gBAAgB,SAAW,MAAM,IAAI,SAAS;CAEpD,OAAO;EACL,IAAI,OAAO,IAAI,EAAE;EACjB,MAAM,IAAI;EACV,OAAO,IAAI;EACX,OAAO;EACP,SAAS,IAAI;EACb,UAAU,IAAI;EACd,cAAc,IAAI;EAClB,QAAQ,IAAI;EACZ,cAAc,IAAI,gBAAgB;EAClC,WAAW,IAAI,KAAK,IAAI,SAAS;EACjC,YAAY,IAAI,aAAa,IAAI,KAAK,IAAI,UAAU,IAAI;CAC1D;AACF"}

package/esm/index.d.mts

@@ -1,10 +1,12 @@
-import { DispatchOptions, DispatchedJob, Duration, DurationUnit, FailedJob, JobBackoff, JobContext, JobDefinition, JobOptions, JobProgress, JobRetention, JobSnapshot, JobState, QueueConfig, QueueJob, QueueWorkersConfig } from "./types.mjs";
+import { DispatchOptions, DispatchedJob, Duration, DurationUnit, FailedJob, JobBackoff, JobContext, JobDefinition, JobOptions, JobProgress, JobRetention, JobSnapshot, JobState, QueueConfig, QueueDashboardConfig, QueueJob, QueueWorkersConfig } from "./types.mjs";
 import { defaultQueueName, getQueueConfig, resetQueueConfig, setQueueConfig } from "./config.mjs";
 import { DashboardServer, QueueDashboardOptions, loadBullBoard, queueDashboard } from "./dashboard.mjs";
+import { DEFAULT_DASHBOARD_PATH, mountQueueDashboard } from "./dashboard-boot.mjs";
 import { defineJob } from "./define-job.mjs";
 import { toMilliseconds } from "./duration.mjs";
 import { FailedJobNotFoundError, InvalidDurationError, InvalidJobDefinitionError, QueueDashboardDependencyError, QueueNotConfiguredError } from "./errors.mjs";
 import { FailedJobsOptions, failedJobs, retryFailedJob } from "./failed-jobs.mjs";
 import { QUEUE_CONNECTOR_PRIORITY, QueueConnectorOptions, queueConnector } from "./queue-connector.mjs";
+import { QueueDashboardUnguardedError } from "./queue-dashboard-unguarded.error.mjs";
 import { CloseQueueOptions, closeQueue, getQueue, runningWorkers, startWorkers } from "./queue-manager.mjs";
-export { type CloseQueueOptions, DashboardServer, DispatchOptions, DispatchedJob, Duration, DurationUnit, FailedJob, FailedJobNotFoundError, FailedJobsOptions, InvalidDurationError, InvalidJobDefinitionError, JobBackoff, JobContext, JobDefinition, JobOptions, JobProgress, JobRetention, JobSnapshot, JobState, QUEUE_CONNECTOR_PRIORITY, QueueConfig, QueueConnectorOptions, QueueDashboardDependencyError, QueueDashboardOptions, QueueJob, QueueNotConfiguredError, QueueWorkersConfig, closeQueue, defaultQueueName, defineJob, failedJobs, getQueue, getQueueConfig, loadBullBoard, queueConnector, queueDashboard, resetQueueConfig, retryFailedJob, runningWorkers, setQueueConfig, startWorkers, toMilliseconds };
+export { type CloseQueueOptions, DEFAULT_DASHBOARD_PATH, DashboardServer, DispatchOptions, DispatchedJob, Duration, DurationUnit, FailedJob, FailedJobNotFoundError, FailedJobsOptions, InvalidDurationError, InvalidJobDefinitionError, JobBackoff, JobContext, JobDefinition, JobOptions, JobProgress, JobRetention, JobSnapshot, JobState, QUEUE_CONNECTOR_PRIORITY, QueueConfig, QueueConnectorOptions, QueueDashboardConfig, QueueDashboardDependencyError, QueueDashboardOptions, QueueDashboardUnguardedError, QueueJob, QueueNotConfiguredError, QueueWorkersConfig, closeQueue, defaultQueueName, defineJob, failedJobs, getQueue, getQueueConfig, loadBullBoard, mountQueueDashboard, queueConnector, queueDashboard, resetQueueConfig, retryFailedJob, runningWorkers, setQueueConfig, startWorkers, toMilliseconds };

package/esm/index.mjs

@@ -2,9 +2,11 @@ import { FailedJobNotFoundError, InvalidDurationError, InvalidJobDefinitionError
 import { defaultQueueName, getQueueConfig, resetQueueConfig, setQueueConfig } from "./config.mjs";
 import { closeQueue, getQueue, runningWorkers, startWorkers } from "./queue-manager.mjs";
 import { loadBullBoard, queueDashboard } from "./dashboard.mjs";
+import { QueueDashboardUnguardedError } from "./queue-dashboard-unguarded.error.mjs";
+import { DEFAULT_DASHBOARD_PATH, mountQueueDashboard } from "./dashboard-boot.mjs";
 import { toMilliseconds } from "./duration.mjs";
 import { defineJob } from "./define-job.mjs";
 import { failedJobs, retryFailedJob } from "./failed-jobs.mjs";
 import { QUEUE_CONNECTOR_PRIORITY, queueConnector } from "./queue-connector.mjs";
 
-export { FailedJobNotFoundError, InvalidDurationError, InvalidJobDefinitionError, QUEUE_CONNECTOR_PRIORITY, QueueDashboardDependencyError, QueueNotConfiguredError, closeQueue, defaultQueueName, defineJob, failedJobs, getQueue, getQueueConfig, loadBullBoard, queueConnector, queueDashboard, resetQueueConfig, retryFailedJob, runningWorkers, setQueueConfig, startWorkers, toMilliseconds };
+export { DEFAULT_DASHBOARD_PATH, FailedJobNotFoundError, InvalidDurationError, InvalidJobDefinitionError, QUEUE_CONNECTOR_PRIORITY, QueueDashboardDependencyError, QueueDashboardUnguardedError, QueueNotConfiguredError, closeQueue, defaultQueueName, defineJob, failedJobs, getQueue, getQueueConfig, loadBullBoard, mountQueueDashboard, queueConnector, queueDashboard, resetQueueConfig, retryFailedJob, runningWorkers, setQueueConfig, startWorkers, toMilliseconds };

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

@@ -20,6 +20,14 @@ type QueueNotificationDispatcherOptions = {
  * - A channel missing from the worker's notifications config fails at once,
  *   without retries.
  *
+ * @deprecated Import `bullmqQueue` from `@warlock.js/notifications` instead —
+ * vendor integrations now live as lazy drivers inside the feature package:
+ *
+ *   queue: bullmqQueue({ attempts: 3, backoff: { type: "exponential", delay: 5000 } })
+ *
+ * This subpath keeps working for one release and then goes away. See the
+ * queue CHANGELOG.
+ *
  * @example src/config/notifications.ts
  * import { queueNotificationDispatcher } from "@warlock.js/queue/notifications";
  *

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"queue-notification-dispatcher.d.mts","names":[],"sources":["../../../../../../../queue/src/notifications/queue-notification-dispatcher.ts"],"mappings":";;;;AAqB+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;AA6BtB;;;;;;;;AAEkB;;;;;;;;;;;;;;;;;;AAFlB,iBAAgB,2BAAA,CACd,OAAA,GAAS,kCAAA,GACR,eAAe"}

package/esm/notifications/queue-notification-dispatcher.mjs

@@ -1,5 +1,6 @@
 import { toMilliseconds } from "../duration.mjs";
 import { defineJob } from "../define-job.mjs";
+import { log } from "@warlock.js/logger";
 import { UnrecoverableError } from "bullmq";
 import { getNotificationConfig } from "@warlock.js/notifications";
 
@@ -27,6 +28,14 @@ const NOTIFICATION_JOB_NAME = "warlock.notifications.deliver";
 * - A channel missing from the worker's notifications config fails at once,
 *   without retries.
 *
+* @deprecated Import `bullmqQueue` from `@warlock.js/notifications` instead —
+* vendor integrations now live as lazy drivers inside the feature package:
+*
+*   queue: bullmqQueue({ attempts: 3, backoff: { type: "exponential", delay: 5000 } })
+*
+* This subpath keeps working for one release and then goes away. See the
+* queue CHANGELOG.
+*
 * @example src/config/notifications.ts
 * import { queueNotificationDispatcher } from "@warlock.js/queue/notifications";
 *
@@ -36,6 +45,7 @@ const NOTIFICATION_JOB_NAME = "warlock.notifications.deliver";
 * };
 */
 function queueNotificationDispatcher(options = {}) {
+	warnDeprecatedOnce();
 	const deliver = defineNotificationJob(options);
 	return { async dispatch(job) {
 		await deliver.dispatch(job, { delay: job.options.delay === void 0 ? void 0 : notificationDelay(job.options.delay) });
@@ -61,6 +71,20 @@ function defineNotificationJob(options) {
 function notificationDelay(delay) {
 	return typeof delay === "number" ? delay * 1e3 : toMilliseconds(delay);
 }
+let warnedDeprecated = false;
+/**
+* Warn once per process that `@warlock.js/queue/notifications` is deprecated
+* in favour of `bullmqQueue` from `@warlock.js/notifications`. Kept thin —
+* this file still owns the actual dispatch logic (delegating to notifications
+* would create a runtime import cycle: notifications' `bullmqQueue` lazily
+* imports `@warlock.js/queue`, which this file already statically imports
+* `@warlock.js/notifications` from).
+*/
+function warnDeprecatedOnce() {
+	if (warnedDeprecated) return;
+	warnedDeprecated = true;
+	log.warn("queue", "notifications.deprecated", "\"queueNotificationDispatcher\" from \"@warlock.js/queue/notifications\" is deprecated and will be removed in the next release. Use the notifications-owned driver instead: import { bullmqQueue } from \"@warlock.js/notifications\"; queue: bullmqQueue({ attempts, backoff })");
+}
 
 //#endregion
 export { NOTIFICATION_JOB_NAME, queueNotificationDispatcher };

package/esm/notifications/queue-notification-dispatcher.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"queue-notification-dispatcher.mjs","names":[],"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,OAAO,UAAwC;EAC7C,MAAM;EACN,OAAO,QAAQ;EACf,UAAU,QAAQ;EAClB,SAAS,QAAQ;EACjB,MAAM,OAAO,KAAK;GAKhB,MAAM,UAJW,sBAAsB,CAAC,CAAC,SAIhB,IAAI;GAE7B,IAAI,CAAC,SACH,MAAM,IAAI,mBACR,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,MAAQ,eAAe,KAAK;AACzE"}
+{"version":3,"file":"queue-notification-dispatcher.mjs","names":[],"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 { log } from \"@warlock.js/logger\";\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 * @deprecated Import `bullmqQueue` from `@warlock.js/notifications` instead —\n * vendor integrations now live as lazy drivers inside the feature package:\n *\n *   queue: bullmqQueue({ attempts: 3, backoff: { type: \"exponential\", delay: 5000 } })\n *\n * This subpath keeps working for one release and then goes away. See the\n * queue CHANGELOG.\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  warnDeprecatedOnce();\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\nlet warnedDeprecated = false;\n\n/**\n * Warn once per process that `@warlock.js/queue/notifications` is deprecated\n * in favour of `bullmqQueue` from `@warlock.js/notifications`. Kept thin —\n * this file still owns the actual dispatch logic (delegating to notifications\n * would create a runtime import cycle: notifications' `bullmqQueue` lazily\n * imports `@warlock.js/queue`, which this file already statically imports\n * `@warlock.js/notifications` from).\n */\nfunction warnDeprecatedOnce(): void {\n  if (warnedDeprecated) {\n    return;\n  }\n\n  warnedDeprecated = true;\n  log.warn(\n    \"queue\",\n    \"notifications.deprecated\",\n    '\"queueNotificationDispatcher\" from \"@warlock.js/queue/notifications\" is deprecated and will be ' +\n      \"removed in the next release. Use the notifications-owned driver instead: \" +\n      'import { bullmqQueue } from \"@warlock.js/notifications\"; ' +\n      'queue: bullmqQueue({ attempts, backoff })',\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCrC,SAAgB,4BACd,UAA8C,CAAC,GAC9B;CACjB,mBAAmB;CACnB,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,OAAO,UAAwC;EAC7C,MAAM;EACN,OAAO,QAAQ;EACf,UAAU,QAAQ;EAClB,SAAS,QAAQ;EACjB,MAAM,OAAO,KAAK;GAKhB,MAAM,UAJW,sBAAsB,CAAC,CAAC,SAIhB,IAAI;GAE7B,IAAI,CAAC,SACH,MAAM,IAAI,mBACR,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,MAAQ,eAAe,KAAK;AACzE;AAEA,IAAI,mBAAmB;;;;;;;;;AAUvB,SAAS,qBAA2B;CAClC,IAAI,kBACF;CAGF,mBAAmB;CACnB,IAAI,KACF,SACA,4BACA,kRAIF;AACF"}

package/esm/queue-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-connector.d.mts","names":[],"sources":["../../../../../../queue/src/queue-connector.ts"],"mappings":";;;;;;;AA4BsB;AAkBtB;cA3Ba,wBAAA;AAAA,KAID,qBAAA;EAuBkE;;;;EAlB5E,MAAA,GAAS,WAAW;AAAA;;;;;;;;;;;;;;;;iBAkBN,cAAA,CAAe,OAAA,GAAS,qBAAA,GAA6B,SAAS"}
+{"version":3,"file":"queue-connector.d.mts","names":[],"sources":["../../../../../../queue/src/queue-connector.ts"],"mappings":";;;;;;;AA6BsB;AAkBtB;cA3Ba,wBAAA;AAAA,KAID,qBAAA;EAuBkE;;;;EAlB5E,MAAA,GAAS,WAAW;AAAA;;;;;;;;;;;;;;;;iBAkBN,cAAA,CAAe,OAAA,GAAS,qBAAA,GAA6B,SAAS"}

package/esm/queue-connector.mjs

@@ -1,5 +1,6 @@
 import { resetQueueConfig, setQueueConfig } from "./config.mjs";
 import { closeQueue, startWorkers } from "./queue-manager.mjs";
+import { mountQueueDashboard } from "./dashboard-boot.mjs";
 import { log } from "@warlock.js/logger";
 
 //#region ../queue/src/queue-connector.ts
@@ -32,7 +33,22 @@ function queueConnector(options = {}) {
 		priority: 11,
 		lifecyclePhase: "late",
 		isActive: () => active,
-		boot: () => void 0,
+		/**
+		* Mounts the dashboard, when configured, here rather than in `start()`:
+		* `boot()` runs for every late-phase connector, in priority order, before
+		* any of them `start()`s — so by the time this runs, the HTTP connector
+		* (priority 5, before queue's 11) has already built its Fastify instance
+		* and registered its own plugins, but has not yet called `listen()`.
+		* Fastify refuses new plugin registrations after `listen()`, so this is
+		* the only point in the boot sequence where mounting is possible.
+		*/
+		async boot() {
+			const queueConfig = options.config ?? await readQueueConfig();
+			if (!queueConfig?.dashboard?.enabled) return;
+			setQueueConfig(queueConfig);
+			const { getHttpServer } = await import("@warlock.js/core");
+			await mountQueueDashboard(getHttpServer(), queueConfig);
+		},
 		async start() {
 			const queueConfig = options.config ?? await readQueueConfig();
 			if (!queueConfig) {

package/esm/queue-connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"queue-connector.mjs","names":[],"sources":["../../../../../../queue/src/queue-connector.ts"],"sourcesContent":["/**\n * The queue's connector for `warlock.config.ts > connectors`.\n *\n * Deliberately a plain object with TYPE-ONLY imports from core: the config\n * file that constructs it must not drag core's runtime graph (or BullMQ) in\n * at config-load time. Core is imported lazily inside `start()`, where the\n * app has already loaded it.\n */\nimport type { Connector, ConnectorLifecyclePhase } from \"@warlock.js/core\";\nimport { log } from \"@warlock.js/logger\";\nimport { resetQueueConfig, setQueueConfig } from \"./config\";\nimport { closeQueue, startWorkers } from \"./queue-manager\";\nimport type { QueueConfig } from \"./types\";\n\n/**\n * Boots after every built-in connector (`ConnectorPriority.AI` is `10`), so\n * the logger is up and anything a job handler needs is already connected;\n * shuts down before them for the same reason.\n */\nexport const QUEUE_CONNECTOR_PRIORITY = 11;\n\nconst WATCHED_FILES = [\"src/config/queue.ts\"];\n\nexport type QueueConnectorOptions = {\n  /**\n   * Supply the configuration directly instead of reading the `queue` config\n   * key (`src/config/queue.ts`).\n   */\n  config?: QueueConfig;\n};\n\n/**\n * Construct the queue connector.\n *\n * Runs in the `late` lifecycle phase — after app code is imported — so every\n * `defineJob` in the app has registered before workers start. At start it\n * reads the `queue` config and starts in-process workers unless\n * `workers.enabled` is `false`; at shutdown it closes workers (waiting for\n * active jobs, bounded by `workers.shutdownTimeout`) and then the queues.\n *\n * @example\n * // warlock.config.ts\n * import { queueConnector } from \"@warlock.js/queue\";\n *\n * export default defineConfig({ connectors: [queueConnector()] });\n */\nexport function queueConnector(options: QueueConnectorOptions = {}): Connector {\n  let active = false;\n\n  const connector: Connector = {\n    name: \"queue\",\n    priority: QUEUE_CONNECTOR_PRIORITY,\n    // Core's `ConnectorLifecyclePhase.Late`; the value is spelled out so this\n    // module stays free of a runtime import of core.\n    lifecyclePhase: \"late\" as ConnectorLifecyclePhase,\n    isActive: () => active,\n    boot: () => undefined,\n    async start() {\n      const queueConfig = options.config ?? (await readQueueConfig());\n\n      if (!queueConfig) {\n        log.warn(\n          \"queue\",\n          \"configured\",\n          \"queueConnector() is registered but no `queue` config was found (src/config/queue.ts); queue not started\",\n        );\n        return;\n      }\n\n      setQueueConfig(queueConfig);\n      const started = await startWorkers();\n      active = true;\n\n      log.info(\n        \"queue\",\n        \"configured\",\n        started.length > 0\n          ? `Queue workers running for: ${started.join(\", \")}`\n          : \"Queue configured (no in-process workers)\",\n      );\n    },\n    async restart() {\n      await connector.shutdown();\n      await connector.start();\n    },\n    async shutdown() {\n      if (!active) {\n        return;\n      }\n\n      await closeQueue();\n      resetQueueConfig();\n      active = false;\n    },\n    shouldRestart(changedFiles) {\n      return changedFiles.some((file) => {\n        const normalized = file.replace(/\\\\/g, \"/\");\n\n        return WATCHED_FILES.some((watched) => normalized === watched || normalized.endsWith(`/${watched}`));\n      });\n    },\n  };\n\n  return connector;\n}\n\nasync function readQueueConfig(): Promise<QueueConfig | undefined> {\n  const { config } = await import(\"@warlock.js/core\");\n\n  return config.get<QueueConfig | undefined>(\"queue\");\n}\n"],"mappings":";;;;;;;;;;AAmBA,MAAa,2BAA2B;AAExC,MAAM,gBAAgB,CAAC,qBAAqB;;;;;;;;;;;;;;;;AAyB5C,SAAgB,eAAe,UAAiC,CAAC,GAAc;CAC7E,IAAI,SAAS;CAEb,MAAM,YAAuB;EAC3B,MAAM;EACN;EAGA,gBAAgB;EAChB,gBAAgB;EAChB,YAAY;EACZ,MAAM,QAAQ;GACZ,MAAM,cAAc,QAAQ,UAAW,MAAM,gBAAgB;GAE7D,IAAI,CAAC,aAAa;IAChB,IAAI,KACF,SACA,cACA,yGACF;IACA;GACF;GAEA,eAAe,WAAW;GAC1B,MAAM,UAAU,MAAM,aAAa;GACnC,SAAS;GAET,IAAI,KACF,SACA,cACA,QAAQ,SAAS,IACb,8BAA8B,QAAQ,KAAK,IAAI,MAC/C,0CACN;EACF;EACA,MAAM,UAAU;GACd,MAAM,UAAU,SAAS;GACzB,MAAM,UAAU,MAAM;EACxB;EACA,MAAM,WAAW;GACf,IAAI,CAAC,QACH;GAGF,MAAM,WAAW;GACjB,iBAAiB;GACjB,SAAS;EACX;EACA,cAAc,cAAc;GAC1B,OAAO,aAAa,MAAM,SAAS;IACjC,MAAM,aAAa,KAAK,QAAQ,OAAO,GAAG;IAE1C,OAAO,cAAc,MAAM,YAAY,eAAe,WAAW,WAAW,SAAS,IAAI,SAAS,CAAC;GACrG,CAAC;EACH;CACF;CAEA,OAAO;AACT;AAEA,eAAe,kBAAoD;CACjE,MAAM,EAAE,WAAW,MAAM,OAAO;CAEhC,OAAO,OAAO,IAA6B,OAAO;AACpD"}
+{"version":3,"file":"queue-connector.mjs","names":[],"sources":["../../../../../../queue/src/queue-connector.ts"],"sourcesContent":["/**\r\n * The queue's connector for `warlock.config.ts > connectors`.\r\n *\r\n * Deliberately a plain object with TYPE-ONLY imports from core: the config\r\n * file that constructs it must not drag core's runtime graph (or BullMQ) in\r\n * at config-load time. Core is imported lazily inside `start()`, where the\r\n * app has already loaded it.\r\n */\r\nimport type { Connector, ConnectorLifecyclePhase } from \"@warlock.js/core\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { resetQueueConfig, setQueueConfig } from \"./config\";\r\nimport { mountQueueDashboard } from \"./dashboard-boot\";\r\nimport { closeQueue, startWorkers } from \"./queue-manager\";\r\nimport type { QueueConfig } from \"./types\";\r\n\r\n/**\r\n * Boots after every built-in connector (`ConnectorPriority.AI` is `10`), so\r\n * the logger is up and anything a job handler needs is already connected;\r\n * shuts down before them for the same reason.\r\n */\r\nexport const QUEUE_CONNECTOR_PRIORITY = 11;\r\n\r\nconst WATCHED_FILES = [\"src/config/queue.ts\"];\r\n\r\nexport type QueueConnectorOptions = {\r\n  /**\r\n   * Supply the configuration directly instead of reading the `queue` config\r\n   * key (`src/config/queue.ts`).\r\n   */\r\n  config?: QueueConfig;\r\n};\r\n\r\n/**\r\n * Construct the queue connector.\r\n *\r\n * Runs in the `late` lifecycle phase — after app code is imported — so every\r\n * `defineJob` in the app has registered before workers start. At start it\r\n * reads the `queue` config and starts in-process workers unless\r\n * `workers.enabled` is `false`; at shutdown it closes workers (waiting for\r\n * active jobs, bounded by `workers.shutdownTimeout`) and then the queues.\r\n *\r\n * @example\r\n * // warlock.config.ts\r\n * import { queueConnector } from \"@warlock.js/queue\";\r\n *\r\n * export default defineConfig({ connectors: [queueConnector()] });\r\n */\r\nexport function queueConnector(options: QueueConnectorOptions = {}): Connector {\r\n  let active = false;\r\n\r\n  const connector: Connector = {\r\n    name: \"queue\",\r\n    priority: QUEUE_CONNECTOR_PRIORITY,\r\n    // Core's `ConnectorLifecyclePhase.Late`; the value is spelled out so this\r\n    // module stays free of a runtime import of core.\r\n    lifecyclePhase: \"late\" as ConnectorLifecyclePhase,\r\n    isActive: () => active,\r\n    /**\r\n     * Mounts the dashboard, when configured, here rather than in `start()`:\r\n     * `boot()` runs for every late-phase connector, in priority order, before\r\n     * any of them `start()`s — so by the time this runs, the HTTP connector\r\n     * (priority 5, before queue's 11) has already built its Fastify instance\r\n     * and registered its own plugins, but has not yet called `listen()`.\r\n     * Fastify refuses new plugin registrations after `listen()`, so this is\r\n     * the only point in the boot sequence where mounting is possible.\r\n     */\r\n    async boot() {\r\n      const queueConfig = options.config ?? (await readQueueConfig());\r\n\r\n      if (!queueConfig?.dashboard?.enabled) {\r\n        return;\r\n      }\r\n\r\n      // The dashboard resolves queues through the active config, so it has to\r\n      // be registered here rather than only in `start()`, which runs after\r\n      // every late connector has booted. `start()` sets it again; the setter\r\n      // is idempotent for the same object.\r\n      setQueueConfig(queueConfig);\r\n\r\n      const { getHttpServer } = await import(\"@warlock.js/core\");\r\n\r\n      await mountQueueDashboard(getHttpServer(), queueConfig);\r\n    },\r\n    async start() {\r\n      const queueConfig = options.config ?? (await readQueueConfig());\r\n\r\n      if (!queueConfig) {\r\n        log.warn(\r\n          \"queue\",\r\n          \"configured\",\r\n          \"queueConnector() is registered but no `queue` config was found (src/config/queue.ts); queue not started\",\r\n        );\r\n        return;\r\n      }\r\n\r\n      setQueueConfig(queueConfig);\r\n      const started = await startWorkers();\r\n      active = true;\r\n\r\n      log.info(\r\n        \"queue\",\r\n        \"configured\",\r\n        started.length > 0\r\n          ? `Queue workers running for: ${started.join(\", \")}`\r\n          : \"Queue configured (no in-process workers)\",\r\n      );\r\n    },\r\n    async restart() {\r\n      await connector.shutdown();\r\n      await connector.start();\r\n    },\r\n    async shutdown() {\r\n      if (!active) {\r\n        return;\r\n      }\r\n\r\n      await closeQueue();\r\n      resetQueueConfig();\r\n      active = false;\r\n    },\r\n    shouldRestart(changedFiles) {\r\n      return changedFiles.some((file) => {\r\n        const normalized = file.replace(/\\\\/g, \"/\");\r\n\r\n        return WATCHED_FILES.some((watched) => normalized === watched || normalized.endsWith(`/${watched}`));\r\n      });\r\n    },\r\n  };\r\n\r\n  return connector;\r\n}\r\n\r\nasync function readQueueConfig(): Promise<QueueConfig | undefined> {\r\n  const { config } = await import(\"@warlock.js/core\");\r\n\r\n  return config.get<QueueConfig | undefined>(\"queue\");\r\n}\r\n"],"mappings":";;;;;;;;;;;AAoBA,MAAa,2BAA2B;AAExC,MAAM,gBAAgB,CAAC,qBAAqB;;;;;;;;;;;;;;;;AAyB5C,SAAgB,eAAe,UAAiC,CAAC,GAAc;CAC7E,IAAI,SAAS;CAEb,MAAM,YAAuB;EAC3B,MAAM;EACN;EAGA,gBAAgB;EAChB,gBAAgB;;;;;;;;;;EAUhB,MAAM,OAAO;GACX,MAAM,cAAc,QAAQ,UAAW,MAAM,gBAAgB;GAE7D,IAAI,CAAC,aAAa,WAAW,SAC3B;GAOF,eAAe,WAAW;GAE1B,MAAM,EAAE,kBAAkB,MAAM,OAAO;GAEvC,MAAM,oBAAoB,cAAc,GAAG,WAAW;EACxD;EACA,MAAM,QAAQ;GACZ,MAAM,cAAc,QAAQ,UAAW,MAAM,gBAAgB;GAE7D,IAAI,CAAC,aAAa;IAChB,IAAI,KACF,SACA,cACA,yGACF;IACA;GACF;GAEA,eAAe,WAAW;GAC1B,MAAM,UAAU,MAAM,aAAa;GACnC,SAAS;GAET,IAAI,KACF,SACA,cACA,QAAQ,SAAS,IACb,8BAA8B,QAAQ,KAAK,IAAI,MAC/C,0CACN;EACF;EACA,MAAM,UAAU;GACd,MAAM,UAAU,SAAS;GACzB,MAAM,UAAU,MAAM;EACxB;EACA,MAAM,WAAW;GACf,IAAI,CAAC,QACH;GAGF,MAAM,WAAW;GACjB,iBAAiB;GACjB,SAAS;EACX;EACA,cAAc,cAAc;GAC1B,OAAO,aAAa,MAAM,SAAS;IACjC,MAAM,aAAa,KAAK,QAAQ,OAAO,GAAG;IAE1C,OAAO,cAAc,MAAM,YAAY,eAAe,WAAW,WAAW,SAAS,IAAI,SAAS,CAAC;GACrG,CAAC;EACH;CACF;CAEA,OAAO;AACT;AAEA,eAAe,kBAAoD;CACjE,MAAM,EAAE,WAAW,MAAM,OAAO;CAEhC,OAAO,OAAO,IAA6B,OAAO;AACpD"}

package/esm/queue-dashboard-unguarded.error.d.mts

@@ -0,0 +1,13 @@
+//#region ../queue/src/queue-dashboard-unguarded.error.d.ts
+/**
+ * Thrown at boot when `queue.dashboard.enabled` is `true` in production with
+ * no guard middleware. The dashboard can retry and delete jobs; mounting it
+ * on the open internet without a guard is a production incident waiting to
+ * happen, so this fails the boot instead of shipping the hole.
+ */
+declare class QueueDashboardUnguardedError extends Error {
+  constructor();
+}
+//#endregion
+export { QueueDashboardUnguardedError };
+//# sourceMappingURL=queue-dashboard-unguarded.error.d.mts.map

package/esm/queue-dashboard-unguarded.error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-dashboard-unguarded.error.d.mts","names":[],"sources":["../../../../../../queue/src/queue-dashboard-unguarded.error.ts"],"mappings":";;AAMA;;;;;cAAa,4BAAA,SAAqC,KAAK;EAAL,WAAA;AAAA"}

package/esm/queue-dashboard-unguarded.error.mjs

@@ -0,0 +1,17 @@
+//#region ../queue/src/queue-dashboard-unguarded.error.ts
+/**
+* Thrown at boot when `queue.dashboard.enabled` is `true` in production with
+* no guard middleware. The dashboard can retry and delete jobs; mounting it
+* on the open internet without a guard is a production incident waiting to
+* happen, so this fails the boot instead of shipping the hole.
+*/
+var QueueDashboardUnguardedError = class extends Error {
+	constructor() {
+		super("queue.dashboard.enabled is true in production with no middleware. The dashboard can retry and delete jobs, so it must be guarded before it is exposed.\n\nAdd a guard middleware:\n\n  import { middleware } from \"@warlock.js/core\";\n  import { authMiddleware } from \"@warlock.js/auth\";\n\n  const queueConfig: QueueConfig = {\n    // ...\n    dashboard: {\n      enabled: true,\n      middleware: [authMiddleware(\"admin\")],\n    },\n  };\n");
+		this.name = "QueueDashboardUnguardedError";
+	}
+};
+
+//#endregion
+export { QueueDashboardUnguardedError };
+//# sourceMappingURL=queue-dashboard-unguarded.error.mjs.map

package/esm/queue-dashboard-unguarded.error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-dashboard-unguarded.error.mjs","names":[],"sources":["../../../../../../queue/src/queue-dashboard-unguarded.error.ts"],"sourcesContent":["/**\n * Thrown at boot when `queue.dashboard.enabled` is `true` in production with\n * no guard middleware. The dashboard can retry and delete jobs; mounting it\n * on the open internet without a guard is a production incident waiting to\n * happen, so this fails the boot instead of shipping the hole.\n */\nexport class QueueDashboardUnguardedError extends Error {\n  public constructor() {\n    super(\n      \"queue.dashboard.enabled is true in production with no middleware. The dashboard can \" +\n        \"retry and delete jobs, so it must be guarded before it is exposed.\\n\\n\" +\n        \"Add a guard middleware:\\n\\n\" +\n        \"  import { middleware } from \\\"@warlock.js/core\\\";\\n\" +\n        \"  import { authMiddleware } from \\\"@warlock.js/auth\\\";\\n\\n\" +\n        \"  const queueConfig: QueueConfig = {\\n\" +\n        \"    // ...\\n\" +\n        \"    dashboard: {\\n\" +\n        \"      enabled: true,\\n\" +\n        \"      middleware: [authMiddleware(\\\"admin\\\")],\\n\" +\n        \"    },\\n\" +\n        \"  };\\n\",\n    );\n    this.name = \"QueueDashboardUnguardedError\";\n  }\n}\n"],"mappings":";;;;;;;AAMA,IAAa,+BAAb,cAAkD,MAAM;CACtD,AAAO,cAAc;EACnB,MACE,6bAYF;EACA,KAAK,OAAO;CACd;AACF"}

package/esm/types.d.mts

@@ -1,4 +1,5 @@
 import { ConnectionOptions } from "bullmq";
+import { Middleware } from "@warlock.js/core";
 
 //#region ../queue/src/types.d.ts
 /** Units accepted in a {@link Duration} string. */
@@ -47,6 +48,21 @@ type QueueWorkersConfig = {
    */
   shutdownTimeout?: number;
 };
+/**
+ * The bull-board dashboard, mounted automatically by `queueConnector()` when
+ * `enabled` is `true`. Equivalent to calling `queueDashboard()` yourself at
+ * boot, driven by config instead — see `warlock add bull-board`.
+ */
+type QueueDashboardConfig = {
+  /** Mount the dashboard at boot. Default `false`. */enabled?: boolean; /** URL path the dashboard is mounted on. Default `"/admin/queues"`. */
+  path?: string;
+  /**
+   * Run before every dashboard route — this is how the dashboard is guarded.
+   * The dashboard can retry and delete jobs, so `NODE_ENV === "production"`
+   * with an empty list throws `QueueDashboardUnguardedError` at boot.
+   */
+  middleware?: Middleware[];
+};
 /**
  * The `queue` configuration key — `src/config/queue.ts`.
  */
@@ -59,7 +75,8 @@ type QueueConfig = {
   prefix?: string; /** Queue name used when a job does not name one. Default `"default"`. */
   defaultQueue?: string; /** Defaults merged under every job's own options. */
   defaultJobOptions?: JobOptions; /** In-process workers. */
-  workers?: QueueWorkersConfig;
+  workers?: QueueWorkersConfig; /** The bull-board job dashboard. */
+  dashboard?: QueueDashboardConfig;
 };
 /** A progress value: a number (e.g. a percentage) or a JSON object. */
 type JobProgress = number | Record<string, unknown>;
@@ -145,5 +162,5 @@ type QueueJob<TPayload, TResult = unknown> = {
   find(id: string): Promise<JobSnapshot<TPayload, TResult> | undefined>;
 };
 //#endregion
-export { DispatchOptions, DispatchedJob, Duration, DurationUnit, FailedJob, JobBackoff, JobContext, JobDefinition, JobOptions, JobProgress, JobRetention, JobSnapshot, JobState, QueueConfig, QueueJob, QueueWorkersConfig };
+export { DispatchOptions, DispatchedJob, Duration, DurationUnit, FailedJob, JobBackoff, JobContext, JobDefinition, JobOptions, JobProgress, JobRetention, JobSnapshot, JobState, QueueConfig, QueueDashboardConfig, QueueJob, QueueWorkersConfig };
 //# sourceMappingURL=types.d.mts.map

package/esm/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../queue/src/types.ts"],"mappings":";;;;KAGY,YAAA;AAAZ;;;;AAAA,KAMY,QAAA,wBAAgC,YAAY;AAAxD;;;;AAAA,KAMY,UAAA;EAAA,uFAIN,IAAA;EAEA,KAAK;AAAA;AAOX;;;;AAAA,KAAY,YAAA;AAMZ;;;;AAAA,KAAY,UAAA;EAQK,kEANf,QAAA,WAM2B;EAJ3B,OAAA,GAAU,UAAA,EAAV;EAEA,gBAAA,GAAmB,YAAA,EAAnB;EAEA,YAAA,GAAe,YAAA;AAAA;;;AAAY;KAMjB,kBAAA;EAAkB;;;;EAK5B,OAAA,YAOA;EALA,WAAA;EAKe;AAMjB;;;EANE,eAAA;AAAA;;;;KAMU,WAAA;EAKE;;;;EAAZ,UAAA,EAAY,iBAAA,EAQZ;EANA,MAAA,WAM4B;EAJ5B,YAAA,WAQU;EANV,iBAAA,GAAoB,UAAA;EAEpB,OAAA,GAAU,kBAAA;AAAA;AASZ;AAAA,KALY,WAAA,YAAuB,MAAM;;;;KAK7B,UAAA;EAcgB,kBAZ1B,EAAA;EAEA,IAAA,UAEA;EAAA,KAAA,UAIA;EAFA,OAAA,UAIgB;EAFhB,WAAA,UAE8B;EAA9B,QAAA,CAAS,KAAA,EAAO,WAAA,GAAc,OAAA,QAE1B;EAAJ,GAAA,CAAI,IAAA,WAAe,OAAA;AAAA;AAAO;AAM5B;;AAN4B,KAMhB,aAAA,sBAAmC,UAAA;EAAA,+CAE7C,IAAA,UAImC;EAFnC,KAAA,WAEgD;EAAhD,MAAA,CAAO,OAAA,EAAS,QAAA,EAAU,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,OAAA,IAAW,OAAA;AAAA;;;;KAMzD,eAAA;EAVV,6CAYA,KAAA,GAAQ,QAAA;EARR;;;;EAaA,QAAA;EAbgD;;;;EAkBhD,KAAA,WAZU;EAcV,QAAA;EAEA,OAAA,GAAU,UAAU;AAAA;;KAIV,aAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;AAAA;;KAIU,QAAA;AAPZ;AAAA,KAkBY,WAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;EACA,KAAA,EAAO,QAAA;EACP,OAAA,EAAS,QAAA;EACT,QAAA,EAAU,WAAA;EACV,YAAA;EACA,MAAA,GAAS,OAAA;EACT,YAAA;EACA,SAAA,EAAW,IAAA;EACX,UAAA,GAAa,IAAA;AAAA;AAXf;AAAA,KAeY,SAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;EACA,OAAA,EAAS,QAAA;EACT,YAAA;EACA,YAAA;EACA,UAAA;EACA,QAAA,GAAW,IAAA,EAZM;EAcjB,KAAA,IAAS,OAAA;AAAA;;;;KAMC,QAAA;EAAA,SACD,IAAA;EAAA,SACA,KAAA,UA5BA;EA8BT,QAAA,CAAS,OAAA,EAAS,QAAA,EAAU,OAAA,GAAU,eAAA,GAAkB,OAAA,CAAQ,aAAA,GA7BtD;EA+BV,IAAA,CAAK,EAAA,WAAa,OAAA,CAAQ,WAAA,CAAY,QAAA,EAAU,OAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../queue/src/types.ts"],"mappings":";;;;;KAIY,YAAA;AAAZ;;;;AAAA,KAMY,QAAA,wBAAgC,YAAY;AAAxD;;;;AAAA,KAMY,UAAA;EAAA,uFAIN,IAAA;EAEA,KAAK;AAAA;AAOX;;;;AAAA,KAAY,YAAA;AAMZ;;;;AAAA,KAAY,UAAA;EAQK,kEANf,QAAA,WAM2B;EAJ3B,OAAA,GAAU,UAAA,EAAV;EAEA,gBAAA,GAAmB,YAAA,EAAnB;EAEA,YAAA,GAAe,YAAA;AAAA;;;AAAY;KAMjB,kBAAA;EAAkB;;;;EAK5B,OAAA,YAOA;EALA,WAAA;EAKe;AAQjB;;;EARE,eAAA;AAAA;;;;;AAkBuB;KAVb,oBAAA;EAgBW,oDAdrB,OAAA,YAmBY;EAjBZ,IAAA;EAyBU;;;;;EAnBV,UAAA,GAAa,UAAU;AAAA;;;;KAMb,WAAA;EAaA;;;;EARV,UAAA,EAAY,iBAAA,EAcF;EAZV,MAAA;EAEA,YAAA,WAUuC;EARvC,iBAAA,GAAoB,UAAA,EAaA;EAXpB,OAAA,GAAU,kBAAA,EAuBM;EArBhB,SAAA,GAAY,oBAAA;AAAA;;KAIF,WAAA,YAAuB,MAAM;;;;KAK7B,UAAA;EAUV,kBARA,EAAA,UAUgB;EARhB,IAAA,UAQ8B;EAN9B,KAAA,UAQI;EANJ,OAAA,UAM0B;EAJ1B,WAAA,UAUU;EARV,QAAA,CAAS,KAAA,EAAO,WAAA,GAAc,OAAA,QAQP;EANvB,GAAA,CAAI,IAAA,WAAe,OAAA;AAAA;;;;KAMT,aAAA,sBAAmC,UAAA;EAM6B,+CAJ1E,IAAA,UAFwB;EAIxB,KAAA,WAJ6C;EAM7C,MAAA,CAAO,OAAA,EAAS,QAAA,EAAU,OAAA,EAAS,UAAA,GAAa,OAAA,CAAQ,OAAA,IAAW,OAAA;AAAA;;;;KAMzD,eAAA;EANgB,6CAQ1B,KAAA,GAAQ,QAAA;EARgD;;;AAAkB;EAa1E,QAAA;EAPyB;;;;EAYzB,KAAA,WALA;EAOA,QAAA;EAEA,OAAA,GAAU,UAAU;AAAA;;KAIV,aAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;AAAA;;KAIU,QAAA;;KAWA,WAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;EACA,KAAA,EAAO,QAAA;EACP,OAAA,EAAS,QAAA;EACT,QAAA,EAAU,WAAA;EACV,YAAA;EACA,MAAA,GAAS,OAAA;EACT,YAAA;EACA,SAAA,EAAW,IAAA;EACX,UAAA,GAAa,IAAA;AAAA;;KAIH,SAAA;EACV,EAAA;EACA,IAAA;EACA,KAAA;EACA,OAAA,EAAS,QAAA;EACT,YAAA;EACA,YAAA;EACA,UAAA;EACA,QAAA,GAAW,IAAA,EAnBX;EAqBA,KAAA,IAAS,OAAA;AAAA;;;;KAMC,QAAA;EAAA,SACD,IAAA;EAAA,SACA,KAAA,UAxBT;EA0BA,QAAA,CAAS,OAAA,EAAS,QAAA,EAAU,OAAA,GAAU,eAAA,GAAkB,OAAA,CAAQ,aAAA,GAzBrD;EA2BX,IAAA,CAAK,EAAA,WAAa,OAAA,CAAQ,WAAA,CAAY,QAAA,EAAU,OAAA;AAAA"}