@lazyapps/eventbus-mqemitter-redis 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Oliver Sturm
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @lazyapps/eventbus-mqemitter-redis
+
+MQEmitter-based event bus with Redis backing. Provides distributed event bus capability using MQEmitter with Redis for persistence and cross-process communication.
+
+## Installation
+
+```bash
+pnpm add @lazyapps/eventbus-mqemitter-redis
+```
+
+## Part of LazyApps
+
+This package is part of the [LazyApps](https://github.com/oliversturm/lazyapps-libs) event-sourcing and CQRS framework.

package/command-receiver/index.js

@@ -0,0 +1,68 @@
+import pRetry from 'p-retry';
+
+import { getLogger } from '@lazyapps/logger';
+import { connect } from '../connect.js';
+
+// NOTE NOTE OLD COMMENT -- may not need this anymore with
+// different other mq systems.
+//
+// For all kinds of reasons (http://zguide.zeromq.org/page:all),
+// zeromq pub/sub subscribers can be running behind the publisher
+// a bit. This can happen when the subscriber is already running
+// before the publisher, but even if it is started shortly after
+// the publisher. Of course there are ways to resolve this and
+// sync things up "properly", but using zeromq in this sample
+// solution is only a suggestion and the issues and solutions
+// would be very different with other messaging systems, so I'm
+// choosing the simple workaround of a small built-in startup
+// delay for now.
+const waitSubscribers =
+  (log, millis) =>
+  (...args) =>
+    new Promise((resolve) => {
+      log.debug('Waiting for subscribers to catch up');
+      setTimeout(() => resolve(...args), millis);
+    });
+
+export const mqEmitterRedis =
+  ({ host = '127.0.0.1', port = 6379 } = {}) =>
+  () => {
+    const initLog = getLogger('CP/EB/Redis', 'INIT');
+
+    return pRetry(() => connect({ host, port }), {
+      onFailedAttempt: (error) => {
+        initLog.error(
+          `Attempt ${error.attemptNumber} failed connecting to Redis on port ${port}: '${error}'. Will retry another ${error.retriesLeft} times.`,
+        );
+      },
+      retries: 10,
+    })
+      .catch((err) => {
+        initLog.error(`Failed to connect to Redis on port ${port}: ${err}`);
+      })
+      .then(waitSubscribers(initLog, 1000))
+      .then((mq) => {
+        initLog.info(`Event bus publishing to port ${port}`);
+        return mq;
+      })
+      .then((mq) => ({
+        publishEvent: (correlationId) => (event) => {
+          const log = getLogger('CP/EB/Redis', correlationId);
+          log.debug(`Publishing event timestamp ${event.timestamp}`);
+          mq.emit({ topic: 'events', payload: { correlationId, event } });
+          return event;
+        },
+        publishReplayState: (correlationId) => (state) => {
+          const log = getLogger('CP/EB/Redis', correlationId);
+          log.debug(`Publishing replay state ${state}`);
+          mq.emit({
+            topic: '__system',
+            payload: {
+              correlationId,
+              event: { type: 'SET_REPLAY_STATE', state },
+            },
+          });
+          return state;
+        },
+      }));
+  };

package/connect.js

@@ -0,0 +1,7 @@
+import mqRedis from 'mqemitter-redis';
+
+// we're doing this in case the connection throws
+export const connect = (params) =>
+  new Promise((res) => {
+    res(mqRedis(params));
+  });

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@lazyapps/eventbus-mqemitter-redis",
+  "version": "0.1.0",
+  "description": "MQEmitter-based event bus with Redis backing for LazyApps",
+  "main": "index.js",
+  "exports": {
+    "./command-receiver": "./command-receiver/index.js",
+    "./command-receiver/index.js": "./command-receiver/index.js",
+    "./readmodels": "./readmodels/index.js",
+    "./readmodels/index.js": "./readmodels/index.js"
+  },
+  "files": [
+    "*.js",
+    "command-receiver/",
+    "readmodels/"
+  ],
+  "keywords": [
+    "event-sourcing",
+    "cqrs",
+    "lazyapps",
+    "event-bus",
+    "mqemitter",
+    "redis"
+  ],
+  "author": "Oliver Sturm",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oliversturm/lazyapps-libs.git",
+    "directory": "packages/eventbus-mqemitter-redis"
+  },
+  "bugs": {
+    "url": "https://github.com/oliversturm/lazyapps-libs/issues"
+  },
+  "homepage": "https://github.com/oliversturm/lazyapps-libs/tree/main/packages/eventbus-mqemitter-redis#readme",
+  "engines": {
+    "node": ">=18.20.3 || >=20.18.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.46.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "mqemitter-redis": "^5.0.0",
+    "p-retry": "^6.1.0",
+    "@lazyapps/logger": "^0.1.0"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "vitest"
+  }
+}

package/readmodels/index.js

@@ -0,0 +1,56 @@
+import pRetry from 'p-retry';
+
+import { getLogger } from '@lazyapps/logger';
+import { connect } from '../connect.js';
+
+export const mqEmitterRedis =
+  ({ host = '127.0.0.1', port = 6379 } = {}) =>
+  (context) => {
+    const initLog = getLogger('RM/EB/Redis', 'INIT');
+
+    let inReplay = false;
+
+    const handleSysMessage = (msg) => {
+      switch (msg.type) {
+        case 'SET_REPLAY_STATE':
+          inReplay = msg.state;
+          break;
+      }
+    };
+
+    return pRetry(() => connect({ host, port }), {
+      onFailedAttempt: (error) => {
+        initLog.error(
+          `Attempt ${error.attemptNumber} failed connecting to Redis on port ${port}: '${error}'. Will retry another ${error.retriesLeft} times.`,
+        );
+      },
+      retries: 10,
+    })
+      .catch((err) => {
+        initLog.error(`Failed to connect to Redis on port ${port}: ${err}`);
+      })
+      .then((mq) => {
+        mq.on('events', ({ payload }, cb) => {
+          const { correlationId, event } = payload;
+          const log = getLogger('RM/EB/Redis', correlationId);
+          log.debug(`Received event: ${JSON.stringify(event)}`);
+          context.projectionHandler.projectEvent(correlationId)(
+            event,
+            inReplay,
+          );
+
+          cb();
+        });
+        mq.on('__system', ({ payload }, cb) => {
+          const { correlationId, event } = payload;
+          const log = getLogger('RM/EB/Redis', correlationId);
+          log.debug(`Received '__system' event: ${JSON.stringify(event)}`);
+
+          handleSysMessage(event);
+          cb();
+        });
+      })
+      .then(() => {
+        initLog.info(`Event bus connected at ${host}:${port}`);
+      });
+  };