@meridianjs/event-bus-redis 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,43 @@
+import { IEventBus, EventMessage, SubscriberFn, ModuleDefinition } from '@meridianjs/types';
+
+interface RedisEventBusOptions {
+    url: string;
+    /** BullMQ queue name — defaults to "meridian:events" */
+    queueName?: string;
+    /** Worker concurrency — defaults to 5 */
+    concurrency?: number;
+}
+/**
+ * Production event bus backed by BullMQ + Redis.
+ *
+ * All events go into a single persistent BullMQ queue.
+ * A Worker processes jobs and fans out to all registered handlers for
+ * the event name — providing durable, async, at-least-once delivery.
+ *
+ * For local development use @meridianjs/event-bus-local instead.
+ */
+declare class RedisEventBus implements IEventBus {
+    private queue;
+    private worker;
+    private connection;
+    /** event name → set of registered handlers */
+    private handlers;
+    constructor(options: RedisEventBusOptions);
+    emit<T>(event: EventMessage<T> | EventMessage<T>[]): Promise<void>;
+    subscribe(eventName: string, handler: SubscriberFn): void;
+    unsubscribe(eventName: string, handler: SubscriberFn): void;
+    close(): Promise<void>;
+}
+declare const EVENT_BUS_MODULE = "eventBus";
+/**
+ * Meridian module definition for the Redis event bus.
+ *
+ * Register in meridian.config.ts:
+ * @example
+ * modules: [
+ *   { resolve: "@meridianjs/event-bus-redis", options: { url: process.env.REDIS_URL } }
+ * ]
+ */
+declare const RedisEventBusModule: ModuleDefinition;
+
+export { EVENT_BUS_MODULE, RedisEventBus, type RedisEventBusOptions, RedisEventBusModule as default };

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { IEventBus, EventMessage, SubscriberFn, ModuleDefinition } from '@meridianjs/types';
+
+interface RedisEventBusOptions {
+    url: string;
+    /** BullMQ queue name — defaults to "meridian:events" */
+    queueName?: string;
+    /** Worker concurrency — defaults to 5 */
+    concurrency?: number;
+}
+/**
+ * Production event bus backed by BullMQ + Redis.
+ *
+ * All events go into a single persistent BullMQ queue.
+ * A Worker processes jobs and fans out to all registered handlers for
+ * the event name — providing durable, async, at-least-once delivery.
+ *
+ * For local development use @meridianjs/event-bus-local instead.
+ */
+declare class RedisEventBus implements IEventBus {
+    private queue;
+    private worker;
+    private connection;
+    /** event name → set of registered handlers */
+    private handlers;
+    constructor(options: RedisEventBusOptions);
+    emit<T>(event: EventMessage<T> | EventMessage<T>[]): Promise<void>;
+    subscribe(eventName: string, handler: SubscriberFn): void;
+    unsubscribe(eventName: string, handler: SubscriberFn): void;
+    close(): Promise<void>;
+}
+declare const EVENT_BUS_MODULE = "eventBus";
+/**
+ * Meridian module definition for the Redis event bus.
+ *
+ * Register in meridian.config.ts:
+ * @example
+ * modules: [
+ *   { resolve: "@meridianjs/event-bus-redis", options: { url: process.env.REDIS_URL } }
+ * ]
+ */
+declare const RedisEventBusModule: ModuleDefinition;
+
+export { EVENT_BUS_MODULE, RedisEventBus, type RedisEventBusOptions, RedisEventBusModule as default };

package/dist/index.js

@@ -0,0 +1,117 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EVENT_BUS_MODULE: () => EVENT_BUS_MODULE,
+  RedisEventBus: () => RedisEventBus,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_bullmq = require("bullmq");
+var import_ioredis = __toESM(require("ioredis"));
+var RedisEventBus = class {
+  queue;
+  worker;
+  connection;
+  /** event name → set of registered handlers */
+  handlers = /* @__PURE__ */ new Map();
+  constructor(options) {
+    const queueName = options.queueName ?? "meridian:events";
+    this.connection = new import_ioredis.default(options.url, {
+      maxRetriesPerRequest: null
+    });
+    this.queue = new import_bullmq.Queue(queueName, {
+      connection: this.connection,
+      defaultJobOptions: {
+        attempts: 3,
+        backoff: { type: "exponential", delay: 1e3 },
+        removeOnComplete: { count: 1e3 },
+        removeOnFail: { count: 500 }
+      }
+    });
+    this.worker = new import_bullmq.Worker(
+      queueName,
+      async (job) => {
+        const eventMsg = job.data;
+        const handlers = this.handlers.get(eventMsg.name);
+        if (!handlers || handlers.size === 0) return;
+        await Promise.all(
+          [...handlers].map(
+            (handler) => handler({ event: eventMsg, container: null }).catch((err) => {
+              console.error(
+                `[RedisEventBus] Unhandled error in subscriber for "${eventMsg.name}":`,
+                err
+              );
+            })
+          )
+        );
+      },
+      {
+        connection: this.connection,
+        concurrency: options.concurrency ?? 5
+      }
+    );
+    this.worker.on("error", (err) => {
+      console.error("[RedisEventBus] Worker error:", err);
+    });
+  }
+  async emit(event) {
+    const events = Array.isArray(event) ? event : [event];
+    await Promise.all(
+      events.map((e) => this.queue.add(e.name, e))
+    );
+  }
+  subscribe(eventName, handler) {
+    if (!this.handlers.has(eventName)) {
+      this.handlers.set(eventName, /* @__PURE__ */ new Set());
+    }
+    this.handlers.get(eventName).add(handler);
+  }
+  unsubscribe(eventName, handler) {
+    this.handlers.get(eventName)?.delete(handler);
+  }
+  async close() {
+    await this.worker.close();
+    await this.queue.close();
+    await this.connection.quit();
+  }
+};
+var EVENT_BUS_MODULE = "eventBus";
+var RedisEventBusModule = {
+  key: EVENT_BUS_MODULE,
+  service: RedisEventBus
+};
+var index_default = RedisEventBusModule;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EVENT_BUS_MODULE,
+  RedisEventBus
+});

package/dist/index.mjs

@@ -0,0 +1,81 @@
+// src/index.ts
+import { Queue, Worker } from "bullmq";
+import IORedis from "ioredis";
+var RedisEventBus = class {
+  queue;
+  worker;
+  connection;
+  /** event name → set of registered handlers */
+  handlers = /* @__PURE__ */ new Map();
+  constructor(options) {
+    const queueName = options.queueName ?? "meridian:events";
+    this.connection = new IORedis(options.url, {
+      maxRetriesPerRequest: null
+    });
+    this.queue = new Queue(queueName, {
+      connection: this.connection,
+      defaultJobOptions: {
+        attempts: 3,
+        backoff: { type: "exponential", delay: 1e3 },
+        removeOnComplete: { count: 1e3 },
+        removeOnFail: { count: 500 }
+      }
+    });
+    this.worker = new Worker(
+      queueName,
+      async (job) => {
+        const eventMsg = job.data;
+        const handlers = this.handlers.get(eventMsg.name);
+        if (!handlers || handlers.size === 0) return;
+        await Promise.all(
+          [...handlers].map(
+            (handler) => handler({ event: eventMsg, container: null }).catch((err) => {
+              console.error(
+                `[RedisEventBus] Unhandled error in subscriber for "${eventMsg.name}":`,
+                err
+              );
+            })
+          )
+        );
+      },
+      {
+        connection: this.connection,
+        concurrency: options.concurrency ?? 5
+      }
+    );
+    this.worker.on("error", (err) => {
+      console.error("[RedisEventBus] Worker error:", err);
+    });
+  }
+  async emit(event) {
+    const events = Array.isArray(event) ? event : [event];
+    await Promise.all(
+      events.map((e) => this.queue.add(e.name, e))
+    );
+  }
+  subscribe(eventName, handler) {
+    if (!this.handlers.has(eventName)) {
+      this.handlers.set(eventName, /* @__PURE__ */ new Set());
+    }
+    this.handlers.get(eventName).add(handler);
+  }
+  unsubscribe(eventName, handler) {
+    this.handlers.get(eventName)?.delete(handler);
+  }
+  async close() {
+    await this.worker.close();
+    await this.queue.close();
+    await this.connection.quit();
+  }
+};
+var EVENT_BUS_MODULE = "eventBus";
+var RedisEventBusModule = {
+  key: EVENT_BUS_MODULE,
+  service: RedisEventBus
+};
+var index_default = RedisEventBusModule;
+export {
+  EVENT_BUS_MODULE,
+  RedisEventBus,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@meridianjs/event-bus-redis",
+  "version": "0.1.0",
+  "description": "Meridian Redis event bus — BullMQ-backed IEventBus for production",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@meridianjs/types": "^0.1.0",
+    "bullmq": "^5.0.0",
+    "ioredis": "^5.3.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "*"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}