@lazyapps/eventstore-mongodb 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/eventstore-mongodb
+
+MongoDB-backed persistent event store with replay capability. Stores domain events durably and supports event stream replay for aggregate reconstitution.
+
+## Installation
+
+```bash
+pnpm add @lazyapps/eventstore-mongodb
+```
+
+## Part of LazyApps
+
+This package is part of the [LazyApps](https://github.com/oliversturm/lazyapps-libs) event-sourcing and CQRS framework.

package/index.js

@@ -0,0 +1,101 @@
+import { MongoClient } from 'mongodb';
+import pRetry from 'p-retry';
+
+import { getLogger } from '@lazyapps/logger';
+
+const replay = (dbContext) => (correlationId) => (cmdProcContext) =>
+  Promise.all([
+    cmdProcContext.aggregateStore.startReplay(),
+    cmdProcContext.eventBus.publishReplayState(correlationId)(true),
+  ])
+    .then(() =>
+      dbContext.collection
+        .find({}, { sort: { timestamp: 1 } })
+        .forEach((event) => {
+          if (event) {
+            return Promise.all([
+              cmdProcContext.aggregateStore.applyAggregateProjection(
+                correlationId,
+              )(event),
+              // Implementation of event replay concept in these samples is currently
+              // incomplete, so don't do it.
+              // cmdProcContext.eventBus.publishEvent(event),
+            ]);
+          } else return false;
+        }),
+    )
+    .then(() =>
+      Promise.all([
+        cmdProcContext.aggregateStore.endReplay(),
+        cmdProcContext.eventBus.publishReplayState(correlationId)(false),
+      ]),
+    );
+
+export const mongodb =
+  ({
+    url,
+    user,
+    pwd,
+    scheme,
+    host,
+    urlPath,
+    database = 'events',
+    collection = 'events',
+  } = {}) =>
+  () => {
+    const connectUrl = url
+      ? url
+      : user && pwd && scheme && host
+        ? (url = `${scheme}://${user}:${pwd}@${host}/${urlPath}`)
+        : 'mongodb://127.0.0.1:27017';
+
+    // Keep location separate for logging, so that the password
+    // doesn't get into the log.
+    const logLocation = user ? host : connectUrl;
+
+    const initLog = getLogger('CmdProc/ES', 'INIT');
+
+    return pRetry(
+      () =>
+        MongoClient.connect(connectUrl, {
+          useNewUrlParser: true,
+          useUnifiedTopology: true,
+        }),
+      {
+        onFailedAttempt: (error) => {
+          initLog.error(
+            `Attempt ${error.attemptNumber} failed connecting to MongoDB at ${logLocation}: '${error}'. Will retry another ${error.retriesLeft} times.`,
+          );
+        },
+        retries: 10,
+      },
+    )
+      .catch((err) => {
+        initLog.error(`Can't connect to MongoDB at ${logLocation}: ${err}`);
+      })
+      .then((client) => ({ client, db: client.db(database) }))
+      .then((dbContext) => ({
+        ...dbContext,
+        collection: dbContext.db.collection(collection),
+      }))
+      .then((dbContext) => ({
+        addEvent: (correlationId) => (event) => {
+          const log = getLogger('ES/MongoDB', correlationId);
+          return dbContext.collection
+            .insertOne(event)
+            .catch((err) => {
+              log.error(`Can't insert event ${event}: ${err}`);
+            })
+            .then(() => {
+              // Questionable mongodb behavior: insertOne mutates
+              // the source object to add the mongodb _id property.
+              // We want to publish the event object later, so
+              // mongodb artefacts are not wanted here.
+              delete event._id;
+              return event;
+            });
+        },
+        close: () => dbContext.client.close(),
+        replay: replay(dbContext),
+      }));
+  };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@lazyapps/eventstore-mongodb",
+  "version": "0.1.0",
+  "description": "MongoDB-backed persistent event store with replay capability for LazyApps",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "event-sourcing",
+    "cqrs",
+    "lazyapps",
+    "event-store",
+    "mongodb"
+  ],
+  "author": "Oliver Sturm",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oliversturm/lazyapps-libs.git",
+    "directory": "packages/eventstore-mongodb"
+  },
+  "bugs": {
+    "url": "https://github.com/oliversturm/lazyapps-libs/issues"
+  },
+  "homepage": "https://github.com/oliversturm/lazyapps-libs/tree/main/packages/eventstore-mongodb#readme",
+  "engines": {
+    "node": ">=18.20.3 || >=20.18.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.46.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "mongodb": "^5.7.0",
+    "p-retry": "^6.1.0",
+    "@lazyapps/logger": "^0.1.0"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "vitest"
+  }
+}