@nwire/bullmq 0.10.0 → 0.11.0

package/dist/bullmq-outbound.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `bullmqOutboundAdapter` — outbound endpoint adapter that drains the App's
+ * sink into BullMQ queues backed by Redis.
+ *
+ * At endpoint boot the adapter calls `installSinkStage` with a terminal
+ * stage of kind `"bullmq"`. Every time a handler calls `ctx.publish` for
+ * a public event, the sink chain reaches this terminal and pushes a
+ * BullMQ job onto a per-event-name queue. Downstream workers (the same
+ * `BullMQQueueTransport.subscribe`, or any independent BullMQ consumer)
+ * receive the event.
+ *
+ *   await endpoint("orders", { exitOnShutdown: false })
+ *     .use(bullmqOutboundAdapter({ connection: { host, port } }))
+ *     .mount(app)
+ *     .run();
+ */
+import type { ConnectionOptions } from "bullmq";
+import type { Adapter } from "@nwire/endpoint";
+export interface BullmqOutboundOptions {
+    readonly connection: ConnectionOptions;
+    /** Prefix applied to every queue. Default: `"nwire"`. */
+    readonly prefix?: string;
+    /**
+     * Map an event name to a BullMQ queue name. Default: pass-through —
+     * each event lands on a queue with the same name.
+     */
+    readonly queueFor?: (eventName: string) => string;
+}
+export declare function bullmqOutboundAdapter(opts: BullmqOutboundOptions): Adapter;

package/dist/bullmq-outbound.js

@@ -0,0 +1,67 @@
+/**
+ * `bullmqOutboundAdapter` — outbound endpoint adapter that drains the App's
+ * sink into BullMQ queues backed by Redis.
+ *
+ * At endpoint boot the adapter calls `installSinkStage` with a terminal
+ * stage of kind `"bullmq"`. Every time a handler calls `ctx.publish` for
+ * a public event, the sink chain reaches this terminal and pushes a
+ * BullMQ job onto a per-event-name queue. Downstream workers (the same
+ * `BullMQQueueTransport.subscribe`, or any independent BullMQ consumer)
+ * receive the event.
+ *
+ *   await endpoint("orders", { exitOnShutdown: false })
+ *     .use(bullmqOutboundAdapter({ connection: { host, port } }))
+ *     .mount(app)
+ *     .run();
+ */
+import { Queue } from "bullmq";
+export function bullmqOutboundAdapter(opts) {
+    const prefix = opts.prefix ?? "nwire";
+    const queueFor = opts.queueFor ?? ((eventName) => eventName);
+    const queues = new Map();
+    let stopped = false;
+    function getQueue(name) {
+        let q = queues.get(name);
+        if (!q) {
+            q = new Queue(name, { connection: opts.connection, prefix });
+            queues.set(name, q);
+        }
+        return q;
+    }
+    return {
+        $kind: "adapter",
+        kind: "bullmq",
+        direction: "outbound",
+        async boot(ctx) {
+            if (!ctx.installSinkStage) {
+                ctx.logger.warn("bullmqOutboundAdapter: endpoint did not provide installSinkStage; no outbound delivery will run.");
+                return;
+            }
+            const stage = {
+                name: "bullmq.terminal",
+                position: "terminal",
+                kind: "bullmq",
+                async run({ event, payload, envelope }) {
+                    if (stopped)
+                        return;
+                    const queueName = queueFor(event.name);
+                    const q = getQueue(queueName);
+                    await q.add(queueName, { eventName: event.name, payload, envelope }, { jobId: envelope.messageId });
+                },
+            };
+            ctx.installSinkStage(stage);
+        },
+        async shutdown() {
+            stopped = true;
+            for (const q of queues.values()) {
+                try {
+                    await q.close();
+                }
+                catch {
+                    // best-effort
+                }
+            }
+            queues.clear();
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { BullMQQueueTransport, type BullMQQueueOptions } from "./queue-bullmq.js";
+export { bullmqOutboundAdapter, type BullmqOutboundOptions } from "./bullmq-outbound.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { BullMQQueueTransport } from "./queue-bullmq.js";
+export { bullmqOutboundAdapter } from "./bullmq-outbound.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/bullmq",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Nwire — BullMQ-backed QueueTransport for production. Redis-backed durable queues + delayed jobs (timer scheduler) + failed-jobs board.",
   "keywords": [
     "adapter",
@@ -16,12 +16,12 @@
     "LICENSE"
   ],
   "type": "module",
-  "main": "./dist/queue-bullmq.js",
-  "types": "./dist/queue-bullmq.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/queue-bullmq.js",
-      "types": "./dist/queue-bullmq.d.ts"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     }
   },
   "publishConfig": {
@@ -29,12 +29,17 @@
   },
   "dependencies": {
     "bullmq": "^5.67.3",
-    "@nwire/queue": "0.10.0"
+    "@nwire/endpoint": "0.11.0",
+    "@nwire/runtime": "0.11.0",
+    "@nwire/queue": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",
     "typescript": "^5.9.3",
-    "@nwire/test-kit": "0.10.0"
+    "zod": "^4.1.12",
+    "@nwire/test-kit": "0.11.0",
+    "@nwire/app": "0.11.0",
+    "@nwire/messages": "0.11.0"
   },
   "scripts": {
     "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",