@tulipes/bullmq 0.1.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TulipesJS contributors
+
+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,64 @@
+<div align="center">
+
+<img src="https://cdn.jsdelivr.net/npm/@tulipes/core@0.7.1/assets/tulipesjs-logo.png" alt="TulipesJs" width="340">
+
+</div>
+
+# @tulipes/bullmq
+
+The BullMQ **queues provider** for [Tulipes](https://www.npmjs.com/package/@tulipes/core)
+apps. Every module's `queues/*.queues.ts` runs in every process: producers exist
+everywhere, processors are registered everywhere, and the worker process turns
+them into consumers. Core itself no longer installs BullMQ or ioredis; an app
+without background work declares no provider and never pays for one.
+
+Requires Node 24.x and a core that ships the provider contract with `serve`/`drain`
+hooks. `bullmq` and `ioredis` are this package's own dependencies — the app never
+imports BullMQ, and the provider's connections are never shared with the app's
+own Redis clients.
+
+## Select it
+
+```jsonc
+{ "tulipes": { "providers": { "queues": "@tulipes/bullmq" } } }
+```
+
+plus `REDIS_URL` declared by the app's sys `core` module and set. A `queues/`
+directory requires the provider automatically; a module that only produces
+declares `"tulipes": { "requires": ["queues"] }`. Installing this package
+without the declaration selects nothing; a `REDIS_URL` on its own starts nothing.
+
+## Use it
+
+```ts
+// modules/billing/queues/invoices.queues.ts
+import type { Ctx } from "@tulipes/core/boot";
+import type { QueueRegistry } from "@tulipes/bullmq";
+
+export default function invoiceQueues(ctx: Ctx, queues: QueueRegistry): void {
+  queues.define("billing.send-invoice");
+  queues.process("billing.send-invoice", async (job) => ({ sent: true }));
+}
+
+// anywhere after acquisition
+await requireQueues(ctx).add("billing.send-invoice", "send", { invoiceId });
+```
+
+## Behavior
+
+- One ioredis connection per queue and one blocking connection per worker,
+  `maxRetriesPerRequest: null`; owned by core before the first queue file runs.
+- Worker mode: `serve()` starts one `Worker` per registered processor; core
+  refuses a worker that serves nothing.
+- Shutdown: `drain()` closes workers (finishing active jobs) concurrently with
+  the HTTP drain and module `onDrain` hooks while producers stay usable — a
+  module's `onShutdown` may still enqueue; then queues and connections close in
+  reverse provider order, with forced `disconnect()` under the shared deadline.
+- Queue names use `.`; duplicates and processors for undefined queues are
+  aggregate boot errors naming the modules.
+
+## Versions
+
+`0.1.0-rc.1` requires core `^0.10.0-rc.2`, the candidate that added the `serve`/`drain`
+hooks; install both with `@next`. See core's
+[MIGRATING.md](https://github.com/kemora13conf/bp-backend-express/blob/v0.10.0-rc.2/packages/core/MIGRATING.md#0100-rc2--declare-the-queues-provider).

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { QueueManager, QueueRegistry } from "./queue-manager.js";
+export { initQueues, type QueuesFn } from "./load-queues.js";
+export { provider } from "./provider.js";
+export { provider as default } from "./provider.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { QueueManager, QueueRegistry } from "./queue-manager.js";
+export { initQueues } from "./load-queues.js";
+export { provider } from "./provider.js";
+export { provider as default } from "./provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/load-queues.d.ts

@@ -0,0 +1,13 @@
+import { type Ctx } from "@tulipes/core/boot";
+import type { BootReport } from "@tulipes/core/errors";
+import type { ModuleFiles } from "@tulipes/core/modules";
+import { QueueManager, type QueueRegistry } from "./queue-manager.js";
+/** Default export of `queues/*.queues.ts`. */
+export type QueuesFn = (ctx: Ctx, queues: QueueRegistry) => void | Promise<void>;
+/**
+ * Phase 8, run by the provider: run every `*.queues.ts` in load order so
+ * producers exist in every process and processors are registered for the
+ * worker to start. Reached only when the app declared the provider, so a
+ * missing connection string is a contradiction the boot must refuse.
+ */
+export declare function initQueues(explored: readonly ModuleFiles[], ctx: Ctx, report: BootReport, onManager?: (manager: QueueManager) => void): Promise<QueueManager | undefined>;

package/dist/load-queues.js

@@ -0,0 +1,53 @@
+import { importFile } from "@tulipes/core/boot";
+import { QueueManager } from "./queue-manager.js";
+/** Well-known infra variable, declared by the app's sys core module. */
+const REDIS_URL = "REDIS_URL";
+/**
+ * Phase 8, run by the provider: run every `*.queues.ts` in load order so
+ * producers exist in every process and processors are registered for the
+ * worker to start. Reached only when the app declared the provider, so a
+ * missing connection string is a contradiction the boot must refuse.
+ */
+export async function initQueues(explored, ctx, report, onManager) {
+    const url = ctx.Environment.store.has(REDIS_URL)
+        ? String(ctx.Environment.get(REDIS_URL))
+        : undefined;
+    if (!url) {
+        report.add({
+            scope: "providers",
+            message: `provider "bullmq" is selected but "${REDIS_URL}" is not declared/set — declare it in a sys module's meta.variables.json and set it`,
+        });
+        return undefined;
+    }
+    const manager = new QueueManager(url);
+    // Owned before any queue file runs: a define() opens a connection.
+    onManager?.(manager);
+    ctx.queues = manager;
+    for (const { module, queueFiles } of explored) {
+        for (const file of queueFiles) {
+            const exported = await importFile(file, "boot", module.name, report);
+            if (!exported)
+                continue;
+            if (typeof exported.default !== "function") {
+                report.add({
+                    scope: "boot",
+                    module: module.name,
+                    message: `${file} must default-export a queues function (ctx, queues) => void`,
+                });
+                continue;
+            }
+            try {
+                await exported.default(ctx, manager.forModule(module.name, report));
+            }
+            catch (error) {
+                report.add({
+                    scope: "boot",
+                    module: module.name,
+                    message: `queues function threw: ${error.message}`,
+                });
+            }
+        }
+    }
+    return manager;
+}
+//# sourceMappingURL=load-queues.js.map

package/dist/load-queues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-queues.js","sourceRoot":"","sources":["../src/load-queues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAY,MAAM,oBAAoB,CAAC;AAI1D,OAAO,EAAE,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAKtE,wEAAwE;AACxE,MAAM,SAAS,GAAG,WAAW,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgC,EAChC,GAAQ,EACR,MAAkB,EAClB,SAA2C;IAE3C,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,CAAC;YACT,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,sCAAsC,SAAS,qFAAqF;SAC9I,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;IACtC,mEAAmE;IACnE,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC;IACrB,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC;IAErB,KAAK,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,UAAU,CAC/B,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAClC,CAAC;YACF,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,CAAC;oBACT,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,OAAO,EAAE,GAAG,IAAI,8DAA8D;iBAC/E,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAO,QAAQ,CAAC,OAAoB,CAClC,GAAG,EACH,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CACvC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,CAAC;oBACT,KAAK,EAAE,MAAM;oBACb,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,OAAO,EAAE,0BAA2B,KAAe,CAAC,OAAO,EAAE;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,11 @@
+import type { Provider } from "@tulipes/core/boot";
+/**
+ * The "queues" provider an app selects with
+ * `"tulipes": { "providers": { "queues": "@tulipes/bullmq" } }`.
+ *
+ * Core owns the phase order, the worker refusal and the shutdown deadline;
+ * this package owns the Redis connections BullMQ needs — one per queue and
+ * one blocking connection per worker, never shared with the application's
+ * own cache or rate-limiter clients — and their drain/close/force order.
+ */
+export declare const provider: Provider<"queues">;

package/dist/provider.js

@@ -0,0 +1,36 @@
+import { initQueues } from "./load-queues.js";
+/**
+ * The "queues" provider an app selects with
+ * `"tulipes": { "providers": { "queues": "@tulipes/bullmq" } }`.
+ *
+ * Core owns the phase order, the worker refusal and the shutdown deadline;
+ * this package owns the Redis connections BullMQ needs — one per queue and
+ * one blocking connection per worker, never shared with the application's
+ * own cache or rate-limiter clients — and their drain/close/force order.
+ */
+export const provider = {
+    contract: 1,
+    capability: "queues",
+    name: "bullmq",
+    async acquire({ ctx, files }, report, own) {
+        let manager;
+        const acquired = await initQueues(files, ctx, report, (created) => {
+            manager = created;
+            own({
+                // Consumers stop while producers stay usable by draining requests,
+                // jobs and module onShutdown hooks; those close at dispose.
+                drain: () => created.drain(),
+                dispose: () => created.close(),
+                forceDispose: () => created.disconnect(),
+                serve: (workerReport) => created.startWorkers(workerReport),
+                status: () => ({
+                    label: `redis (${created.names().length} queue(s))`,
+                    ready: true,
+                    detail: `${created.processorCount} processor(s) registered${created.workerCount ? `, ${created.workerCount} consuming` : ""}`,
+                }),
+            });
+        });
+        return acquired && manager ? manager : undefined;
+    },
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,QAAQ;IACpB,IAAI,EAAE,QAAQ;IACd,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG;QACvC,IAAI,OAAiC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;YAChE,OAAO,GAAG,OAAO,CAAC;YAClB,GAAG,CAAC;gBACF,mEAAmE;gBACnE,4DAA4D;gBAC5D,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;gBAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;gBAC9B,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE;gBACxC,KAAK,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;gBAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;oBACb,KAAK,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,YAAY;oBACnD,KAAK,EAAE,IAAI;oBACX,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,2BAA2B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE;iBAC9H,CAAC;aACH,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,CAAC;CACF,CAAC"}

package/dist/queue-manager.d.ts

@@ -0,0 +1,64 @@
+import { Queue, type JobsOptions, type Processor, type QueueOptions, type WorkerOptions } from "bullmq";
+import type { QueuesCapability } from "@tulipes/core/boot";
+import type { BootReport } from "@tulipes/core/errors";
+/**
+ * What `ctx.queues` is once this provider is in the compilation. Core's
+ * QueuesCapability is empty; an app that imports anything from this package
+ * (its queue files do, for QueueRegistry) sees these members typed.
+ */
+declare module "@tulipes/core/boot" {
+    interface QueuesCapability {
+        /** Produce a job. The queue must have been defined by some module. */
+        add(queueName: string, jobName: string, data: unknown, options?: JobsOptions): Promise<void>;
+        queue(name: string): Queue;
+        names(): string[];
+        readonly processorCount: number;
+        readonly workerCount: number;
+    }
+}
+/**
+ * One manager owns every queue in the process. The same `*.queues.ts` files
+ * run in BOTH modes — definitions and processors are always registered — and
+ * the mode decides what happens with them:
+ *
+ *   backend    → queues produce; processors are registered but never started
+ *   worker → `startWorkers()` turns every registered processor into a
+ *            consuming BullMQ Worker
+ *
+ * That symmetry is what lets a module describe its background work once.
+ */
+export declare class QueueManager implements QueuesCapability {
+    #private;
+    constructor(redisUrl: string);
+    /** @internal Module-scoped facade for the loader. */
+    forModule(moduleName: string, report: BootReport): QueueRegistry;
+    /** @internal QueueRegistry only. */
+    define_(name: string, owner: string, options?: Partial<QueueOptions>): string | undefined;
+    /** @internal QueueRegistry only. */
+    process_(name: string, handler: Processor, owner: string, options?: Partial<WorkerOptions>): string | undefined;
+    /** Introspection for the startup banner and tooling. */
+    names(): string[];
+    get processorCount(): number;
+    get workerCount(): number;
+    /** Produce a job. The queue must have been defined by some module. */
+    add(queueName: string, jobName: string, data: unknown, options?: JobsOptions): Promise<void>;
+    queue(name: string): Queue;
+    /** Worker mode only — called by the provider's serve() hook, never by modules. */
+    startWorkers(report: BootReport): number;
+    /** Stop consumers and finish active jobs while producers remain available. */
+    drain(): Promise<void>;
+    /** Emergency connection teardown after the graceful shutdown deadline. */
+    disconnect(): void;
+    /** Drain order: stop consuming, then producers, then raw connections. */
+    close(): Promise<void>;
+}
+/**
+ * Module-scoped facade handed to `*.queues.ts` — mirrors AclBuilder: every
+ * registration records its module so conflicts crash with both names.
+ */
+export declare class QueueRegistry {
+    #private;
+    constructor(manager: QueueManager, moduleName: string, report: BootReport);
+    define(name: string, options?: Partial<QueueOptions>): this;
+    process(name: string, handler: Processor, options?: Partial<WorkerOptions>): this;
+}

package/dist/queue-manager.js

@@ -0,0 +1,183 @@
+import { Queue, Worker, } from "bullmq";
+import { Redis } from "ioredis";
+/**
+ * One manager owns every queue in the process. The same `*.queues.ts` files
+ * run in BOTH modes — definitions and processors are always registered — and
+ * the mode decides what happens with them:
+ *
+ *   backend    → queues produce; processors are registered but never started
+ *   worker → `startWorkers()` turns every registered processor into a
+ *            consuming BullMQ Worker
+ *
+ * That symmetry is what lets a module describe its background work once.
+ */
+export class QueueManager {
+    #url;
+    #queues = new Map();
+    #processors = new Map();
+    #workers = [];
+    #connections = [];
+    #closing = false;
+    constructor(redisUrl) {
+        this.#url = redisUrl;
+    }
+    /**
+     * BullMQ re-emits every driver error on its Queue and Worker instances and
+     * Node turns an unhandled "error" event into a crash — including the reply
+     * that a QUIT cuts short during shutdown. Producers and consumers therefore
+     * always carry a listener: during shutdown the error is expected and dropped,
+     * otherwise it is surfaced on stderr, since a lost job is a job BullMQ will
+     * retry and a dead process would lose the whole queue.
+     */
+    #observe(name, emitter) {
+        emitter.on("error", (error) => {
+            if (this.#closing)
+                return;
+            console.error(`[tulipes/bullmq] queue "${name}": ${error.message}`);
+        });
+    }
+    /**
+     * Every BullMQ client gets its own connection: workers need dedicated
+     * blocking connections anyway, and never sharing keeps close() reasoning
+     * trivial. maxRetriesPerRequest: null is a BullMQ requirement.
+     */
+    #connect() {
+        const connection = new Redis(this.#url, { maxRetriesPerRequest: null });
+        this.#connections.push(connection);
+        return connection;
+    }
+    /** @internal Module-scoped facade for the loader. */
+    forModule(moduleName, report) {
+        return new QueueRegistry(this, moduleName, report);
+    }
+    /** @internal QueueRegistry only. */
+    define_(name, owner, options) {
+        const existing = this.#queues.get(name);
+        if (existing)
+            return existing.owner;
+        const queue = new Queue(name, { ...options, connection: this.#connect() });
+        this.#observe(name, queue);
+        this.#queues.set(name, { queue, owner });
+        return undefined;
+    }
+    /** @internal QueueRegistry only. */
+    process_(name, handler, owner, options) {
+        const existing = this.#processors.get(name);
+        if (existing)
+            return existing.owner;
+        this.#processors.set(name, { handler, owner, options });
+        return undefined;
+    }
+    /** Introspection for the startup banner and tooling. */
+    names() {
+        return [...this.#queues.keys()];
+    }
+    get processorCount() {
+        return this.#processors.size;
+    }
+    get workerCount() {
+        return this.#workers.length;
+    }
+    /** Produce a job. The queue must have been defined by some module. */
+    async add(queueName, jobName, data, options) {
+        await this.queue(queueName).add(jobName, data, options);
+    }
+    queue(name) {
+        const stored = this.#queues.get(name);
+        if (!stored) {
+            throw new Error(`Queue "${name}" was never defined by any module (known: ${[...this.#queues.keys()].join(", ") || "none"})`);
+        }
+        return stored.queue;
+    }
+    /** Worker mode only — called by the provider's serve() hook, never by modules. */
+    startWorkers(report) {
+        for (const [name, { handler, owner, options }] of this.#processors) {
+            if (!this.#queues.has(name)) {
+                report.add({
+                    scope: "boot",
+                    module: owner,
+                    message: `processor registered for undefined queue "${name}" — call define() first`,
+                });
+                continue;
+            }
+            const worker = new Worker(name, handler, { ...options, connection: this.#connect() });
+            this.#observe(name, worker);
+            this.#workers.push(worker);
+        }
+        return this.#workers.length;
+    }
+    /** Stop consumers and finish active jobs while producers remain available. */
+    async drain() {
+        // The first shutdown signal this manager receives; errors are expected from here on.
+        this.#closing = true;
+        const results = await Promise.allSettled(this.#workers.map((worker) => worker.close()));
+        throwFailures(results);
+    }
+    /** Emergency connection teardown after the graceful shutdown deadline. */
+    disconnect() {
+        this.#closing = true;
+        for (const worker of this.#workers)
+            void worker.disconnect().catch(() => { });
+        for (const connection of this.#connections)
+            connection.disconnect();
+    }
+    /** Drain order: stop consuming, then producers, then raw connections. */
+    async close() {
+        this.#closing = true;
+        const results = await Promise.allSettled([this.drain()]);
+        // A queue still initializing (its meta write is issued once the client is
+        // ready) must finish before its connection is quit, or that reply is lost.
+        results.push(...await Promise.allSettled([...this.#queues.values()].map(async ({ queue }) => { await queue.waitUntilReady().catch(() => { }); await queue.close(); })));
+        results.push(...await Promise.allSettled(this.#connections.map(async (connection) => {
+            try {
+                await connection.quit();
+            }
+            finally {
+                connection.disconnect();
+            }
+        })));
+        throwFailures(results);
+    }
+}
+// BullMQ reserves ":" (its redis key separator), so module namespacing in
+// queue names uses "." instead: "users.welcome".
+const QUEUE_NAME = /^[a-z0-9-]+(\.[a-z0-9-]+)?$/;
+/**
+ * Module-scoped facade handed to `*.queues.ts` — mirrors AclBuilder: every
+ * registration records its module so conflicts crash with both names.
+ */
+export class QueueRegistry {
+    #manager;
+    #module;
+    #report;
+    constructor(manager, moduleName, report) {
+        this.#manager = manager;
+        this.#module = moduleName;
+        this.#report = report;
+    }
+    define(name, options) {
+        if (!QUEUE_NAME.test(name)) {
+            this.#issue(`queue name "${name}" is invalid — lowercase kebab-case, optional "." namespace`);
+            return this;
+        }
+        const owner = this.#manager.define_(name, this.#module, options);
+        if (owner)
+            this.#issue(`queue "${name}" is already defined by module "${owner}"`);
+        return this;
+    }
+    process(name, handler, options) {
+        const owner = this.#manager.process_(name, handler, this.#module, options);
+        if (owner)
+            this.#issue(`queue "${name}" already has a processor from module "${owner}"`);
+        return this;
+    }
+    #issue(message) {
+        this.#report.add({ scope: "boot", module: this.#module, message });
+    }
+}
+function throwFailures(results) {
+    const errors = results.flatMap(result => result.status === "rejected" ? [result.reason] : []);
+    if (errors.length)
+        throw new AggregateError(errors, `Queue cleanup failed — ${errors.map(error => error instanceof Error ? error.message : String(error)).join("; ")}`);
+}
+//# sourceMappingURL=queue-manager.js.map

package/dist/queue-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-manager.js","sourceRoot":"","sources":["../src/queue-manager.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@tulipes/bullmq",
+  "version": "0.1.0-rc.1",
+  "description": "BullMQ queues provider for Tulipes apps: producers in every process, consumers in the worker, behind core's queues capability",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "prepack": "yarn build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "bullmq": "^5",
+    "ioredis": "^5"
+  },
+  "peerDependencies": {
+    "@tulipes/core": "^0.10.0-rc.2"
+  },
+  "devDependencies": {
+    "@tulipes/core": "0.10.0-rc.2",
+    "@types/node": "^24.2.0",
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kemora13conf/bp-backend-express.git",
+    "directory": "packages/bullmq"
+  },
+  "keywords": [
+    "tulipes",
+    "bullmq",
+    "redis",
+    "queues",
+    "express"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0 <25"
+  },
+  "homepage": "https://github.com/kemora13conf/bp-backend-express/tree/master/packages/bullmq#readme",
+  "bugs": {
+    "url": "https://github.com/kemora13conf/bp-backend-express/issues"
+  }
+}