@lazyapps/aggregatestore-inmemory 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/aggregatestore-inmemory
+
+In-memory aggregate state cache for the LazyApps command processing pipeline. Caches aggregate state to avoid replaying all events on every command.
+
+## Installation
+
+```bash
+pnpm add @lazyapps/aggregatestore-inmemory
+```
+
+## 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,64 @@
+import { getLogger } from '@lazyapps/logger';
+
+const initLogger = getLogger('CmdProc/AS', 'INIT');
+
+export const inmemory = () => (aggregates) => {
+  const store = {};
+  let lastProjectedEventTimestamp = 0;
+  let inReplay = false;
+
+  const getAggregateState = (name, id) =>
+    (store[name] && store[name][id]) || aggregates[name].initial();
+
+  const setAggregateState = (name, id, state) => {
+    if (!store[name]) store[name] = {};
+    store[name][id] = state;
+  };
+
+  const applyAggregateProjection = (correlationId) => (event) => {
+    const { aggregateName, aggregateId, type, timestamp } = event;
+    const projection =
+      aggregates[aggregateName].projections &&
+      aggregates[aggregateName].projections[type];
+    const log = getLogger('CmdProc/AS', correlationId);
+    if (projection) {
+      const state = getAggregateState(aggregateName, aggregateId);
+      const projected = projection(state, event);
+      setAggregateState(aggregateName, aggregateId, projected);
+      log.debug(
+        `Applied aggregate projection for event timestamp ${timestamp}`,
+      );
+    } else {
+      log.debug(
+        `No aggregate projection for type in event ${JSON.stringify(event)}`,
+      );
+    }
+
+    if (!inReplay && timestamp < lastProjectedEventTimestamp)
+      log.debug(
+        `Noticing event out of sequence (lastPET=${lastProjectedEventTimestamp}, ts=${timestamp}): ${JSON.stringify(
+          event,
+        )}`,
+      );
+
+    lastProjectedEventTimestamp = timestamp;
+
+    return event;
+  };
+
+  const startReplay = () => {
+    initLogger.debug('Starting replay state for aggregate store');
+    inReplay = true;
+  };
+
+  const endReplay = () => {
+    initLogger.debug('Ending replay state for aggregate store');
+    inReplay = false;
+  };
+  return {
+    getAggregateState,
+    applyAggregateProjection,
+    startReplay,
+    endReplay,
+  };
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@lazyapps/aggregatestore-inmemory",
+  "version": "0.1.0",
+  "description": "In-memory aggregate state cache for the LazyApps command processing pipeline",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "event-sourcing",
+    "cqrs",
+    "lazyapps",
+    "aggregate-store"
+  ],
+  "author": "Oliver Sturm",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oliversturm/lazyapps-libs.git",
+    "directory": "packages/aggregatestore-inmemory"
+  },
+  "bugs": {
+    "url": "https://github.com/oliversturm/lazyapps-libs/issues"
+  },
+  "homepage": "https://github.com/oliversturm/lazyapps-libs/tree/main/packages/aggregatestore-inmemory#readme",
+  "engines": {
+    "node": ">=18.20.3 || >=20.18.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.46.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@lazyapps/logger": "^0.1.0"
+  },
+  "type": "module",
+  "scripts": {
+    "test": "vitest"
+  }
+}