node-cqrs 1.0.0 → 1.1.0-alpha.1

package/CHANGELOG.md

@@ -1,4 +1,23 @@
-# [1.0.0](https://github.com/snatalenko/node-cqrs/compare/v0.17.0...v1.0.0) (2026-03-21)
+# [1.1.0-alpha.1](https://github.com/snatalenko/node-cqrs/compare/v1.1.0-alpha.0...v1.1.0-alpha.1) (2026-03-24)
+
+
+### Features
+
+* MongoDb-backed view model (`MongoObjectView`, `AbstractMongoObjectProjection`) ([4995bfe](https://github.com/snatalenko/node-cqrs/commit/4995bfe2daf53372d3e7e36d59ee103219ad6a35))
+
+### Changes
+
+* Use `Identifier` as id type in redis and sqlite views ([dfbe964](https://github.com/snatalenko/node-cqrs/commit/dfbe9648a8ea8e7e5550aa40e0094ca8af1758ef))
+* Add default queueName for RabbitMqCommandBus ([ee4b5a1](https://github.com/snatalenko/node-cqrs/commit/ee4b5a170e44db6227e76d2ffb1695b6dfaef6e4))
+* Add error handling and drain functionality to event publishing process ([d23ea62](https://github.com/snatalenko/node-cqrs/commit/d23ea621c8a71e2cda4baaf091166534c4f5af2e))
+
+### Documentation
+
+* Add detailed documentation for redis and mongodb modules ([72e66f5](https://github.com/snatalenko/node-cqrs/commit/72e66f5508a6df6c0a4a341e752cfab76830478a))
+* Detailed sqlite and rabbitmq instructions ([dd242fd](https://github.com/snatalenko/node-cqrs/commit/dd242fd73018bcfa0583ab1ddd12518c4f3a4777))
+
+
+# [1.1.0-alpha.0](https://github.com/snatalenko/node-cqrs/compare/v0.17.0...v1.1.0-alpha.0) (2026-03-21)
 
 
 ### Features
@@ -8,7 +27,12 @@
 * Support selective restore event loading ([3a74da6](https://github.com/snatalenko/node-cqrs/commit/3a74da6807a0250bff0e05ae57f922922d8847be))
 * Multi-saga correlation via `message.sagaOrigins` + simplified ISaga (mutate/handle) with AbstractSaga state support ([ae67594](https://github.com/snatalenko/node-cqrs/commit/ae675944faa2b01aefed23d7c0e456e2581f066f))
 * Re-process commands on concurrency errors in EventStorage ([8a60560](https://github.com/snatalenko/node-cqrs/commit/8a60560b1e3dc7bff85217851a12c503730a9e19))
+* Integrate OpenTelemetry for command and event tracing ([b03997f](https://github.com/snatalenko/node-cqrs/commit/b03997f17b0e88cccaeca6ca599ad5d43457390a))
+* RabbitMQ trace context propagation via W3C TraceContext AMQP headers ([1db354a](https://github.com/snatalenko/node-cqrs/commit/1db354af099cfe9c3884d0ea46087da1610e73da))
 * Add RabbitMQ command bus implementation and enhance MQ configuration options ([a565c59](https://github.com/snatalenko/node-cqrs/commit/a565c59f87fa46f2279781329ebacf55b1245805))
+* Redis-backed projection views with distributed locking (experimental) ([8ff0f1e](https://github.com/snatalenko/node-cqrs/commit/8ff0f1e14a6fdcd676d549a9d4c7ad2d2ce7cd4c))
+* SqliteEventStorage ([ffaf766](https://github.com/snatalenko/node-cqrs/commit/ffaf7669139e797488c50332cac94a234738cc62))
+* MongoDB-backed event storage ([53fb5e1](https://github.com/snatalenko/node-cqrs/commit/53fb5e1c0d7a027f9afebf88f8d3d516d06c3c48))
 
 ### Changes
 
@@ -31,6 +55,8 @@
 * Add option for queue expiration ([7073832](https://github.com/snatalenko/node-cqrs/commit/7073832aa5287f5786d6f8f06d4ad67698ac3f19))
 * Add option to disable handler timeout on rabbitmq subscription ([dd76d5e](https://github.com/snatalenko/node-cqrs/commit/dd76d5e9c728739620ba7d4399108db97293772f))
 * Pass event meta through projection chain, allow skipping last event update for internal-origin events ([dd36395](https://github.com/snatalenko/node-cqrs/commit/dd36395a2ad4be712df0a81e60514701ec7e03b8))
+* Remove "md5" from peer dependencies ([87600bc](https://github.com/snatalenko/node-cqrs/commit/87600bc5a857b0e251ceed37d99cc5cf66f61ee5))
+* Expose `restorePromises` on DI container for tracking async projection restoring processes ([ebdaa2c](https://github.com/snatalenko/node-cqrs/commit/ebdaa2ca4ff6d1088deba5d4069d7a027be65107))
 
 ### Fixes
 
@@ -40,6 +66,7 @@
 * Failing synchronous event handler may prevent execution of other handlers ([fb026e5](https://github.com/snatalenko/node-cqrs/commit/fb026e5263f13c05e8e6999ff0162700551f587c))
 * All errors being ignored with concurrency resolution set to 'ignore' ([0cb10bc](https://github.com/snatalenko/node-cqrs/commit/0cb10bcaef5ec76050b14caf6d5ad710a005b6d0))
 * Avoid finalization of already finalized MQ messages ([a9a1ea6](https://github.com/snatalenko/node-cqrs/commit/a9a1ea63fc85ba8cd6b09e2c2330636e22639b2c))
+* Defer aggregate cache pre-warm to avoid orphaned async operations on command error ([677ed29](https://github.com/snatalenko/node-cqrs/commit/677ed29cd6dab5f80b021ee90ad1dd8c3586fcd3))
 
 ### Documentation
 
@@ -47,6 +74,8 @@
 * Add CONTRIBUTING.md symlinks for coding agents ([878f25f](https://github.com/snatalenko/node-cqrs/commit/878f25fd99ff4884045ea4d8b2cb739f3e2bf5ff))
 * Update package description and keywords ([15ef847](https://github.com/snatalenko/node-cqrs/commit/15ef847b4b7dc7007f38423580704604901fc588))
 * Add AbstractWorkerProjection description to readme.md ([dd3952c](https://github.com/snatalenko/node-cqrs/commit/dd3952cc79d8a5762cd5b5bc320429ac9d0e7403))
+* Remove readme code samples in favor of runnable ./examples/ ([73417c3](https://github.com/snatalenko/node-cqrs/commit/73417c3b997f2d838b02dd0b91f05e0a6001e556))
+* Rearrange examples to use same aggregate and projection implementation ([5325901](https://github.com/snatalenko/node-cqrs/commit/532590143fd29a205b6eb3fd4d6c686b17956835))
 
 ### Tests
 

package/README.md

@@ -12,7 +12,7 @@ node-cqrs
 Infrastructure-agnostic building blocks for CQRS/ES, inspired by Lokad.CQRS.
 
 CQRS/ES can be simple in a single process - minimal code, no framework:
-[examples/user-domain/framework-free](examples/user-domain/framework-free/index.ts).
+[examples/user-domain-framework-free](examples/user-domain-framework-free/index.ts).
 This library handles the "boring but hard" parts required in distributed environments:
 
 - safer async command + event handling (per-aggregate FIFO, shared restore, fewer footguns)
@@ -33,20 +33,21 @@ Built around ES6/TypeScript classes and dependency injection - swap implementati
 - [Installation](#installation)
 - [ContainerBuilder](#containerbuilder)
 - [Commands](#commands)
-- [Aggregates (write model)](#aggregates-write-model)
+- [Write Model (Aggregates)](#write-model-aggregates)
   - [AbstractAggregate](#abstractaggregate)
   - [Aggregate State](#aggregate-state)
   - [External Dependencies](#external-dependencies)
-- [Projections and Views (read model)](#projections-and-views-read-model)
+- [Read Model (Projections and Views)](#read-model-projections-and-views)
   - [AbstractProjection](#abstractprojection)
   - [View restoring on start](#view-restoring-on-start)
   - [Accessing views](#accessing-views)
 - [Sagas](#sagas)
-- [Infrastructure modules](#infrastructure-modules)
-  - [In-memory](#in-memory)
-  - [SQLite](#sqlite)
-  - [RabbitMQ](#rabbitmq)
-  - [Workers](#workers)
+- [Infrastructure Modules](#infrastructure-modules)
+  - [Event Storage](#event-storage)
+  - [Read Model](#read-model)
+  - [Message Buses](#message-buses)
+  - [Other](#other)
+- [OpenTelemetry](#opentelemetry)
 - [Examples](#examples)
 
 
@@ -72,15 +73,15 @@ interface IMessage<TPayload = any> {
 
 Domain logic lives in three building blocks:
 
-- **[Aggregates](#aggregates-write-model)** - handle commands and emit events
-- **[Projections](#projections-and-views-read-model)** - consume events and update views
+- **[Aggregates](#write-model-aggregates)** - handle commands and emit events
+- **[Projections](#read-model-projections-and-views)** - consume events and update views
 - **[Sagas](#sagas)** - manage processes by reacting to events and enqueueing follow-up commands
 
 Message delivery is handled by the following components, in order:
 
 - **[Command Bus](src/in-memory/InMemoryMessageBus.ts)** - routes commands to handlers
 - **[Aggregate Command Handler](src/AggregateCommandHandler.ts)** - restores aggregate state and executes commands
-- **[Event Store](src/EventStore.ts)** — runs the event dispatch pipeline (e.g. encoding, persistence), then publishes events to the event bus for delivery to all subscribers
+- **[Event Store](src/EventStore.ts)** - runs the event dispatch pipeline (e.g. encoding, persistence), then publishes events to the event bus for delivery to all subscribers
 - **[Saga Event Handler](src/SagaEventHandler.ts)** - restores saga state and applies events
 
 > `src/`, `tests/`, and `examples/` are good entry points - the codebase is intentionally small and readable.
@@ -94,13 +95,6 @@ npm install node-cqrs
 
 Node.js 16+ and browsers are supported.
 
-Optional peer dependencies:
-
-| Module | Packages |
-|--------|----------|
-| SQLite | `better-sqlite3`, `md5` |
-| RabbitMQ | `amqplib` |
-| Worker threads | `comlink` |
 
 
 ## ContainerBuilder
@@ -154,10 +148,10 @@ commandBus.send('signupUser', undefined, { payload: { profile, password } });
 commandBus.send({ type: 'signupUser', payload: { profile, password } });
 ```
 
-Commands are handled by [Aggregates](#aggregates-write-model) and may also be enqueued by [Sagas](#sagas).
+Commands are handled by [Aggregates](#write-model-aggregates) and may also be enqueued by [Sagas](#sagas).
 
 
-## Aggregates (write model)
+## Write Model (Aggregates)
 
 Aggregates handle commands, validate business rules, and emit events.
 Minimal contract ([IAggregate](src/interfaces/IAggregate.ts)):
@@ -249,7 +243,7 @@ builder.registerAggregate(UserAggregate);
 ```
 
 
-## Projections and Views (read model)
+## Read Model (Projections and Views)
 
 Projections listen to events and update views.
 Minimal contract ([IProjection](src/interfaces/IProjection.ts)):
@@ -274,14 +268,18 @@ interface IProjection<TView> extends IObserver {
 Same name-matching rule as AbstractAggregate - `userCreated()` handles the `userCreated` event:
 
 ```ts
-class UsersProjection extends AbstractProjection<Map<string, { username: string }>> {
+class UsersProjection extends AbstractProjection<Map<string, { 
+	username: string
+}>> {
 	constructor() {
 		super();
 		this.view = new Map();
 	}
 
 	userCreated(event: IEvent<UserCreatedEventPayload>) {
-		this.view.set(event.aggregateId as string, { username: event.payload.username });
+		this.view.set(event.aggregateId, {
+			username: event.payload.username
+		});
 	}
 }
 ```
@@ -295,7 +293,8 @@ For persistent views and safe restarts, implement [IViewLocker](src/interfaces/I
 ### Accessing views
 
 ```ts
-interface IMyContainer extends IContainer { // optional interface for container typing
+// optional interface for container typing
+interface IMyContainer extends IContainer {
 	usersView: UsersView;
 }
 
@@ -321,7 +320,9 @@ Sagas coordinate multi-step processes by reacting to events and enqueueing follo
 ```ts
 class WelcomeEmailSaga extends AbstractSaga {
 	userSignedUp(event) {
-		this.enqueue('sendWelcomeEmail', undefined, { email: event.payload.email });
+		this.enqueue('sendWelcomeEmail', undefined, {
+			email: event.payload.email
+		});
 	}
 }
 
@@ -391,114 +392,127 @@ interface ISaga {
 ```
 
 
-## Infrastructure modules
+## Infrastructure Modules
 
-| Module | Import | Use case |
-|--------|--------|----------|
-| In-memory | `node-cqrs` | Tests and local development |
-| SQLite | `node-cqrs/sqlite` | Persistent views with catch-up |
-| RabbitMQ | `node-cqrs/rabbitmq` | Cross-process event distribution |
-| Workers | `node-cqrs/workers` | CPU-heavy projections in worker threads |
+Swap implementations by registering different classes in the DI container.
+All modules below implement the same interfaces - pick what fits your deployment.
 
-### In-memory
+### Event Storage
 
-- [InMemoryEventStorage](src/in-memory/InMemoryEventStorage.ts) - event storage + identifier provider
-- [InMemoryMessageBus](src/in-memory/InMemoryMessageBus.ts) - event/command bus
-- [InMemoryView](src/in-memory/InMemoryView.ts) - in-memory view with locking support
+Where aggregate events are persisted and replayed from.
 
-### SQLite
+| Implementation         | Import              | Peer deps        | Notes                                                                             |
+| ---------------------- | ------------------- | ---------------- | --------------------------------------------------------------------------------- |
+| `InMemoryEventStorage` | `node-cqrs`         | -                | Dev/test only; data lost on restart ([example](examples/user-domain-ts/index.ts)) |
+| `SqliteEventStorage`   | `node-cqrs/sqlite`  | `better-sqlite3` | Embedded, single-process ([example](examples/sqlite/index.ts))                    |
+| `MongoEventStorage`    | `node-cqrs/mongodb` | `mongodb`        | Distributed, multi-process ([example](examples/mongodb-eventstore/index.ts))      |
 
-```ts
-import { AbstractSqliteView, SqliteObjectView } from 'node-cqrs/sqlite';
-```
+### Read Model
 
-- [AbstractSqliteView](src/sqlite/AbstractSqliteView.ts) - SQLite view with restore locking and checkpoint tracking
-- [SqliteObjectView](src/sqlite/SqliteObjectView.ts) - SQLite-backed object view
+Where projections store and query their read-side state.
+Each persistent backend provides the same layered set of building blocks:
 
-### RabbitMQ
+| Layer               | Purpose                                                                                          |
+| ------------------- | ------------------------------------------------------------------------------------------------ |
+| **Object storage**  | Key/value CRUD with optimistic concurrency                                                       |
+| **View locker**     | Prevents concurrent schema-migration rebuilds - only one process rebuilds at a time; others wait |
+| **Event locker**    | Per-event deduplication and last-projected checkpoint                                            |
+| **Composite view**  | Combines the above into a single view object                                                     |
+| **Base projection** | Wires locking, checkpointing, and error handling automatically                                   |
 
-```ts
-import { RabbitMqEventBus, RabbitMqCommandBus, RabbitMqGateway } from 'node-cqrs/rabbitmq';
-```
+#### In-memory
 
-- [RabbitMqGateway](src/rabbitmq/RabbitMqGateway.ts) - publish/subscribe gateway with durable and transient queue support
-- [RabbitMqEventBus](src/rabbitmq/RabbitMqEventBus.ts) - RabbitMQ-backed `IEventBus` (fanout delivery to all subscribers)
-- [RabbitMqCommandBus](src/rabbitmq/RabbitMqCommandBus.ts) - RabbitMQ-backed `ICommandBus` (point-to-point delivery via durable queue)
+| Class          | Notes                                                          |
+| -------------- | -------------------------------------------------------------- |
+| `InMemoryLock` | Simple in-process lock                                         |
+| `InMemoryView` | Simple `Map`-backed view; restores from events on each restart |
 
-### Workers
+#### SQLite (`node-cqrs/sqlite`, peer dep: `better-sqlite3`)
 
-```ts
-import { AbstractWorkerProjection } from 'node-cqrs/workers';
-```
+| Class                            | Role                                                                                   |
+| -------------------------------- | -------------------------------------------------------------------------------------- |
+| `SqliteObjectStorage`            | Key/value object storage with version-based concurrency                                |
+| `SqliteViewLocker`               | Prevents concurrent schema-migration rebuilds via SQLite row lock                      |
+| `SqliteEventLocker`              | Event deduplication and last-event checkpoint                                          |
+| `AbstractSqliteView`             | Base class for relational (non-object) SQLite views with view and event locks embedded |
+| `SqliteObjectView`               | Composite view combining the above                                                     |
+| `AbstractSqliteObjectProjection` | Base projection wired to `SqliteObjectView`                                            |
 
-Workers are an execution mode for projections.
+See [src/sqlite](src/sqlite) for additional documentation, and [examples/sqlite](examples/sqlite/index.ts) for runnable project examples
 
-You still define one projection class, but it runs as:
-1. A real projection inside a worker thread (handles events, mutates the view).
-2. A proxy projection in the main thread (forwards calls to the worker and exposes the remote view).
+#### MongoDB (`node-cqrs/mongodb`, peer dep: `mongodb`)
 
-This lets you keep your projection code unchanged while moving heavy work off the main thread.
+> **Experimental** - not yet validated in production. APIs may change in minor versions.
 
-Quickstart:
-1. Create your projection by extending `AbstractWorkerProjection`.
-2. In the worker module, call `YourProjection.createInstanceInWorkerThread()`.
-3. In your app container, register `YourProjection.workerProxyFactory` and use it like a normal projection.
+| Class                           | Role                                                                              |
+| ------------------------------- | --------------------------------------------------------------------------------- |
+| `MongoObjectStorage`            | Document storage with version-based optimistic concurrency                        |
+| `MongoViewLocker`               | Prevents concurrent schema-migration rebuilds; auto-prolongs lock via token + TTL |
+| `MongoEventLocker`              | Event deduplication and last-event checkpoint                                     |
+| `AbstractMongoView`             | Base class combining `MongoViewLocker` + `MongoEventLocker`                       |
+| `MongoObjectView`               | Composite view combining the above                                                |
+| `AbstractMongoObjectProjection` | Base projection wired to `MongoObjectView`                                        |
 
-Worker module example (CJS):
+See [src/mongodb](src/mongodb) for additional documentation, and [examples/mongodb-views](examples/mongodb-views/index.ts) for runnable projection examples.
 
-```js
-const { AbstractWorkerProjection } = require('node-cqrs/workers');
+#### Redis (`node-cqrs/redis`, peer dep: `ioredis`)
 
-class CounterView {
-	counter = 0;
-	increment() { this.counter += 1; }
-	getCounter() { return this.counter; }
-}
+> **Experimental** - not yet validated in production. APIs may change in minor versions.
 
-class CounterProjection extends AbstractWorkerProjection {
-	static get workerModulePath() {
-		return __filename;
-	}
+| Class                     | Role                                                                          |
+| ------------------------- | ----------------------------------------------------------------------------- |
+| `RedisObjectStorage`      | Key/value object storage backed by Redis hashes                               |
+| `RedisViewLocker`         | Prevents concurrent schema-migration rebuilds; auto-prolongs lock via PEXPIRE |
+| `RedisEventLocker`        | Event deduplication and last-event checkpoint                                 |
+| `RedisView`               | Composite view combining the above                                            |
+| `AbstractRedisProjection` | Base projection wired to `RedisView`                                          |
 
-	constructor() {
-		super({ view: new CounterView() });
-	}
+See [src/redis](src/redis) for additional documentation, and [examples/redis](examples/redis/index.ts) for runnable projection examples.
 
-	somethingHappened() {
-		this.view.increment();
-	}
-}
+### Message Buses
 
-CounterProjection.createInstanceInWorkerThread();
-module.exports = CounterProjection;
-```
+How commands and events move between producers and consumers.
 
-Main thread usage (DI):
+| Implementation       | Import               | Peer deps | Notes                                                                                            |
+| -------------------- | -------------------- | --------- | ------------------------------------------------------------------------------------------------ |
+| `InMemoryMessageBus` | `node-cqrs`          | -         | Single-process; used as both command and event bus ([example](examples/user-domain-ts/index.ts)) |
+| `RabbitMqEventBus`   | `node-cqrs/rabbitmq` | `amqplib` | Fanout delivery to all subscribers ([instructions](src/rabbitmq))                                |
+| `RabbitMqCommandBus` | `node-cqrs/rabbitmq` | `amqplib` | Point-to-point via durable queue ([instructions](src/rabbitmq))                                  |
 
-```js
-const CounterProjection = require('./CounterProjection.cjs');
-const { ContainerBuilder } = require('node-cqrs');
+### Other
 
-const builder = new ContainerBuilder();
-builder.registerProjection(CounterProjection.workerProxyFactory, 'counterView');
+| Implementation             | Import              | Notes                                                         |
+| -------------------------- | ------------------- | ------------------------------------------------------------- |
+| `InMemorySnapshotStorage`  | `node-cqrs`         | Aggregate snapshot cache in memory, resets on process restart |
+| `AbstractWorkerProjection` | `node-cqrs/workers` | Run projections in worker threads ([instructions](src/workers), [example](examples/workers-projection/index.cjs)) |
+
+> **Experimental** — the Workers module is new and has not been validated in production. APIs may change in minor versions.
+
+## OpenTelemetry
+
+Optional distributed tracing via [OpenTelemetry](https://opentelemetry.io/). Requires `@opentelemetry/api` peer dependency. Register a `tracerFactory` in the container to enable automatic span creation across CQRS components:
+
+```ts
+import { trace } from '@opentelemetry/api';
 
-const { eventStore, counterView } = builder.container();
-await eventStore.dispatch([{ id: '1', type: 'somethingHappened', payload: {} }]);
-const counter = await counterView.getCounter();
+builder.register(() => (name: string) => trace.getTracer(`cqrs.${name}`)).as('tracerFactory');
 ```
 
-`workerModulePath` should point to executable JavaScript (`__filename` in CJS, `fileURLToPath(import.meta.url)` in ESM).
-If you need a custom proxy projection, you can still use `workerProxyFactory(...)` directly (advanced usage).
+See [examples/telemetry/index.ts](examples/telemetry/index.ts) for a full working example.
 
 
 ## Examples
 
-- [examples/user-domain/framework-free](examples/user-domain/framework-free/index.ts) - minimal, no-framework CQRS/ES in one file
-- [examples/user-domain/ts](examples/user-domain/ts) - TypeScript with DI container
-- [examples/user-domain/cjs](examples/user-domain/cjs) - CommonJS
-- [examples/sagas/simple](examples/sagas/simple/index.ts) - simple saga
-- [examples/sagas/overlaps](examples/sagas/overlaps/index.ts) - overlapping sagas, multi-step flow
+- [examples/user-domain-framework-free](examples/user-domain-framework-free/index.ts) - minimal, no-framework CQRS/ES in one file
+- [examples/user-domain-ts](examples/user-domain-ts) - TypeScript with DI container
+- [examples/user-domain-cjs](examples/user-domain-cjs) - CommonJS
+- [examples/redis](examples/redis/index.ts) - Redis-backed persistent projection
+- [examples/sagas-simple](examples/sagas-simple/index.ts) - simple saga
+- [examples/sagas-overlaps](examples/sagas-overlaps/index.ts) - overlapping sagas, multi-step flow
 - [examples/browser](examples/browser) - browser smoke test
-- [examples/workers/worker-projection](examples/workers/worker-projection) - worker thread projection
+- [examples/workers-projection](examples/workers-projection) - worker thread projection
+- [examples/mongodb-eventstore](examples/mongodb-eventstore/index.ts) - MongoDB event storage with DI container and manual wiring
+- [examples/mongodb-views](examples/mongodb-views/index.ts) - MongoDB-backed projection views with object storage and locking
+- [examples/telemetry](examples/telemetry/index.ts) - OpenTelemetry tracing with multiple exporters
 
 TS examples can be run with NodeJS 24+ without transpiling.

package/dist/cjs/AbstractProjection.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractProjection = void 0;
 const Event_ts_1 = require("./Event.js");
 const InMemoryView_ts_1 = require("./in-memory/InMemoryView.js");
-const index_ts_1 = require("./interfaces/index.js");
-const index_ts_2 = require("./utils/index.js");
+const index_ts_1 = require("./telemetry/index.js");
+const index_ts_2 = require("./interfaces/index.js");
+const index_ts_3 = require("./utils/index.js");
 /**
  * Base class for Projection definition
  */
@@ -14,12 +15,14 @@ class AbstractProjection {
      * If not overridden, event types will be inferred from handler methods defined on the Projection class.
      */
     static get handles() {
-        return (0, index_ts_2.getMessageHandlerNames)(this);
+        return (0, index_ts_3.getMessageHandlerNames)(this);
     }
     #view;
     #viewLocker;
     #eventLocker;
     _logger;
+    #serviceName;
+    #tracer;
     /**
      * The default view associated with the projection.
      * Can optionally implement IViewLocker and/or IEventLocker.
@@ -36,7 +39,7 @@ class AbstractProjection {
      */
     get _viewLocker() {
         if (this.#viewLocker === undefined)
-            this.#viewLocker = (0, index_ts_1.isViewLocker)(this.view) ? this.view : null;
+            this.#viewLocker = (0, index_ts_2.isViewLocker)(this.view) ? this.view : null;
         return this.#viewLocker;
     }
     set _viewLocker(value) {
@@ -47,19 +50,21 @@ class AbstractProjection {
      */
     get _eventLocker() {
         if (this.#eventLocker === undefined)
-            this.#eventLocker = (0, index_ts_1.isEventLocker)(this.view) ? this.view : null;
+            this.#eventLocker = (0, index_ts_2.isEventLocker)(this.view) ? this.view : null;
         return this.#eventLocker;
     }
     set _eventLocker(value) {
         this.#eventLocker = value;
     }
-    constructor({ view, viewLocker, eventLocker, logger } = {}) {
-        (0, index_ts_2.validateHandlers)(this);
+    constructor({ view, viewLocker, eventLocker, tracerFactory, logger } = {}) {
+        (0, index_ts_3.validateHandlers)(this);
         this.#view = view;
         this.#viewLocker = viewLocker;
         this.#eventLocker = eventLocker;
+        this.#serviceName = (0, index_ts_3.getClassName)(this);
+        this.#tracer = tracerFactory?.(this.#serviceName);
         this._logger = logger && 'child' in logger ?
-            logger.child({ service: (0, index_ts_2.getClassName)(this) }) :
+            logger.child({ service: (0, index_ts_3.getClassName)(this) }) :
             logger;
     }
     /**
@@ -67,7 +72,7 @@ class AbstractProjection {
      * and restore view state from not yet projected events
      */
     subscribe(eventStore) {
-        (0, index_ts_2.subscribe)(eventStore, this, {
+        (0, index_ts_3.subscribe)(eventStore, this, {
             masterHandler: this.project
         });
     }
@@ -78,7 +83,17 @@ class AbstractProjection {
             await this._viewLocker.once('ready');
             this._logger?.debug(`view is ready, processing ${(0, Event_ts_1.describe)(event)}`);
         }
-        return this._project(event, meta);
+        const span = this.#tracer?.startSpan(`${this.#serviceName}.project ${event.type}`, (0, index_ts_1.spanAttributes)('projection', event, ['type', 'aggregateId']), (0, index_ts_1.spanContext)(meta));
+        try {
+            await this._project(event, meta);
+        }
+        catch (error) {
+            (0, index_ts_1.recordSpanError)(span, error);
+            throw error;
+        }
+        finally {
+            span?.end();
+        }
     }
     /**
      * Determines whether an event should be recorded as the last projected event (restore checkpoint).
@@ -90,7 +105,7 @@ class AbstractProjection {
     }
     /** Pass event to projection event handler, without awaiting for restore operation to complete */
     async _project(event, meta) {
-        const handler = (0, index_ts_2.getHandler)(this, event.type);
+        const handler = (0, index_ts_3.getHandler)(this, event.type);
         if (!handler)
             throw new Error(`'${event.type}' handler is not defined or not a function`);
         if (this._eventLocker) {
@@ -112,15 +127,25 @@ class AbstractProjection {
      * won't be performed by another projection instance.
      * */
     async restore(eventStore) {
-        if (this._viewLocker)
-            await this._viewLocker.lock();
-        await this._restore(eventStore);
-        if (this._viewLocker)
-            this._viewLocker.unlock();
+        const span = this.#tracer?.startSpan(`${this.#serviceName}.restore`);
+        try {
+            if (this._viewLocker)
+                await this._viewLocker.lock();
+            await this._restore(eventStore);
+            if (this._viewLocker)
+                this._viewLocker.unlock();
+        }
+        catch (error) {
+            (0, index_ts_1.recordSpanError)(span, error);
+            throw error;
+        }
+        finally {
+            span?.end();
+        }
     }
     /** Restore view state from not-yet-projected events */
     async _restore(eventStore) {
-        (0, index_ts_2.assertFunction)(eventStore?.getEventsByTypes, 'eventStore.getEventsByTypes');
+        (0, index_ts_3.assertFunction)(eventStore?.getEventsByTypes, 'eventStore.getEventsByTypes');
         let lastEvent;
         if (this._eventLocker) {
             this._logger?.debug('retrieving last event projected');
@@ -154,7 +179,7 @@ class AbstractProjection {
     _onRestoringError(error, event) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         this._logger?.error(`view restoring has failed (view remains locked): ${errorMessage}`, {
-            service: (0, index_ts_2.getClassName)(this),
+            service: (0, index_ts_3.getClassName)(this),
             event,
             error
         });

package/dist/cjs/AbstractProjection.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractProjection.js","sourceRoot":"","sources":["../../src/AbstractProjection.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AACtC,iEAA2D;AAC3D,oDAW+B;AAE/B,+CAO0B;AAwB1B;;GAEG;AACH,MAAsB,kBAAkB;IAEvC;;;OAGG;IACH,MAAM,KAAK,OAAO;QACjB,OAAO,IAAA,iCAAsB,EAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAS;IACd,WAAW,CAAsB;IACjC,YAAY,CAAuB;IACzB,OAAO,CAAW;IAE5B;;;OAGG;IACH,IAAW,IAAI;QACd,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,8BAAY,EAAW,CAAC,CAAC;IACjE,CAAC;IAED,IAAc,IAAI,CAAC,KAAY;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,IAAc,WAAW;QACxB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YACjC,IAAI,CAAC,WAAW,GAAG,IAAA,uBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAE/D,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,IAAc,WAAW,CAAC,KAAqC;QAC9D,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAc,YAAY;QACzB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,IAAI,CAAC,YAAY,GAAG,IAAA,wBAAa,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAEjE,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,IAAc,YAAY,CAAC,KAAsC;QAChE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,YAAY,EACX,IAAI,EACJ,UAAU,EACV,WAAW,EACX,MAAM,KAC8B,EAAE;QACtC,IAAA,2BAAgB,EAAC,IAAI,CAAC,CAAC;QAEvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAEhC,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAA,uBAAY,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/C,MAAM,CAAC;IACT,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,UAAuB;QAChC,IAAA,oBAAS,EAAC,UAAU,EAAE,IAAI,EAAE;YAC3B,aAAa,EAAE,IAAI,CAAC,OAAO;SAC3B,CAAC,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,IAA0B;QACtD,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YACjD,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,yDAAyD,IAAA,mBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,6BAA6B,IAAA,mBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,kDAAkD;IACxC,qBAAqB,CAAC,MAAc,EAAE,KAA2B;QAC1E,OAAO,IAAI,CAAC;IACb,CAAC;IAED,iGAAiG;IACvF,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,IAA0B;QACjE,MAAM,OAAO,GAAG,IAAA,qBAAU,EAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YACX,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,4CAA4C,CAAC,CAAC;QAE7E,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC7E,IAAI,CAAC,iBAAiB;gBACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC;gBAC1C,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;IAED;;;;;SAKK;IACL,KAAK,CAAC,OAAO,CAAC,UAA+B;QAC5C,IAAI,IAAI,CAAC,WAAW;YACnB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAE/B,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,WAAW;YACnB,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,uDAAuD;IAC7C,KAAK,CAAC,QAAQ,CAAC,UAA+B;QACvD,IAAA,yBAAc,EAAC,UAAU,EAAE,gBAAgB,EAAE,6BAA6B,CAAC,CAAC;QAE5E,IAAI,SAA6B,CAAC;QAElC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACvD,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,SAAS,CAAC,CAAC,CAAC,gBAAgB,IAAA,mBAAQ,EAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC;QAEzG,MAAM,YAAY,GAAI,IAAI,CAAC,WAAyC,CAAC,OAAO,CAAC;QAC7E,MAAM,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QAE5F,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,iBAAqC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC3B,iBAAiB,GAAG,KAAK,CAAC;gBAC1B,WAAW,IAAI,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,GAAY,EAAE,CAAC;gBACrB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,IAAI,iBAAiB;YACzC,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAE5D,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,sBAAsB,WAAW,gBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,KAAK,CAAC,CAAC;IAChG,CAAC;IAED;;;;OAIG;IACO,iBAAiB,CAAC,KAAc,EAAE,KAAa;QACxD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,oDAAoD,YAAY,EAAE,EAAE;YACvF,OAAO,EAAE,IAAA,uBAAY,EAAC,IAAI,CAAC;YAC3B,KAAK;YACL,KAAK;SACL,CAAC,CAAC;QAEH,MAAM,KAAK,CAAC;IACb,CAAC;CACD;AAhMD,gDAgMC"}
+{"version":3,"file":"AbstractProjection.js","sourceRoot":"","sources":["../../src/AbstractProjection.ts"],"names":[],"mappings":"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"}