node-cqrs 1.2.0-beta.0 → 1.3.0-alpha.0

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+# [1.3.0-alpha.0](https://github.com/snatalenko/node-cqrs/compare/v1.2.0-beta.0...v1.3.0-alpha.0) (2026-06-17)
+
+
+### Features
+
+* PostgreSQL event storage ([a567da2](https://github.com/snatalenko/node-cqrs/commit/a567da2597f30013c201d9c2e7c22e94b5abf429))
+* PostgreSQL projection views ([6ac7301](https://github.com/snatalenko/node-cqrs/commit/6ac73012a187de5755b5f9a646d2e816397e143d))
+
+### Performance Improvements
+
+* Aggregate SQLite saga origins in event queries ([491310e](https://github.com/snatalenko/node-cqrs/commit/491310ecc7263a1f6833ad08fc9b8340f8d434a1))
+
+
 # [1.2.0-beta.0](https://github.com/snatalenko/node-cqrs/compare/v1.1.0...v1.2.0-beta.0) (2026-06-17)
 
 

package/README.md

@@ -34,6 +34,7 @@ The core is infrastructure-agnostic, but the heavy lifting for common stacks is
 - `node-cqrs/mongodb` – Distributed event storage and persistent projection views for multi-process deployments.
 - `node-cqrs/rabbitmq` – Robust, distributed command and event bus.
 - `node-cqrs/redis` – Redis-backed persistent projection views for distributed deployments.
+- `node-cqrs/postgresql` – PostgreSQL-backed event storage and persistent views for custom relational read models.
 
 ## Table of Contents
 
@@ -417,14 +418,15 @@ All modules below implement the same interfaces - pick what fits your deployment
 
 ### Capability Matrix
 
-| Module              | Event storage                                      | Object view storage                                                                 | Projection wiring / execution                    | Message buses                                      |
-| ------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------- |
-| `node-cqrs`         | `InMemoryEventStorage`, `InMemorySnapshotStorage` | `InMemoryView`, `InMemoryLock`                                                      | `AbstractProjection`                             | `InMemoryMessageBus`                              |
-| `node-cqrs/sqlite`  | `SqliteEventStorage`                              | `SqliteObjectView`, `SqliteObjectStorage`, `SqliteViewLocker`, `SqliteEventLocker`  | `AbstractSqliteObjectProjection`, `AbstractSqliteView` | -                                                 |
-| `node-cqrs/mongodb` | `MongoEventStorage`                               | `MongoObjectView`, `MongoObjectStorage`, `MongoViewLocker`, `MongoEventLocker`      | `AbstractMongoObjectProjection`, `AbstractMongoView` | -                                                 |
-| `node-cqrs/redis`   | -                                                  | `RedisView`, `RedisObjectStorage`, `RedisViewLocker`, `RedisEventLocker`            | `AbstractRedisProjection`                        | -                                                 |
-| `node-cqrs/rabbitmq` | -                                                 | -                                                                                   | -                                                | `RabbitMqGateway`, `RabbitMqCommandBus`, `RabbitMqEventBus` |
-| `node-cqrs/workers` | -                                                  | -                                                                                   | `AbstractWorkerProjection`, `WorkerProxyProjection` | -                                                 |
+| Module              | Event storage                                      | Object view storage                                                                 | Projection wiring / lifecycle                                             | Message buses                                      |
+| ------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------- |
+| `node-cqrs`         | `InMemoryEventStorage`, `InMemorySnapshotStorage` | `InMemoryView`                                                                      | `AbstractProjection`, `InMemoryLock`                                      | `InMemoryMessageBus`                              |
+| `node-cqrs/sqlite`  | `SqliteEventStorage`                              | `SqliteObjectView`, `SqliteObjectStorage`, `AbstractSqliteObjectProjection`         | `AbstractSqliteView`, `SqliteViewLocker`, `SqliteEventLocker`             | -                                                 |
+| `node-cqrs/mongodb` | `MongoEventStorage`                               | `MongoObjectView`, `MongoObjectStorage`, `AbstractMongoObjectProjection`            | `AbstractMongoView`, `MongoViewLocker`, `MongoEventLocker`                | -                                                 |
+| `node-cqrs/redis`   | -                                                  | `RedisView`, `RedisObjectStorage`, `AbstractRedisProjection`                        | `RedisViewLocker`, `RedisEventLocker`                                     | -                                                 |
+| `node-cqrs/postgresql` | `PostgresqlEventStorage`                       | `PostgresqlObjectView`, `PostgresqlObjectStorage`, `AbstractPostgresqlObjectProjection` | `AbstractPostgresqlView`, `PostgresqlViewLocker`, `PostgresqlEventLocker` | -                                                 |
+| `node-cqrs/rabbitmq` | -                                                 | -                                                                                   | -                                                                         | `RabbitMqGateway`, `RabbitMqCommandBus`, `RabbitMqEventBus` |
+| `node-cqrs/workers` | -                                                  | -                                                                                   | `AbstractWorkerProjection`, `WorkerProxyProjection`                       | -                                                 |
 
 ### Event Storage
 
@@ -435,11 +437,12 @@ Where aggregate events are persisted and replayed from.
 | `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))      |
+| `PostgresqlEventStorage` | `node-cqrs/postgresql` | `pg`          | Distributed, multi-process ([example](examples/postgresql/index.ts))              |
 
 ### Read Model
 
 Where projections store and query their read-side state.
-Each persistent backend provides the same layered set of building blocks:
+Persistent view backends are built from the following layers. Not every backend implements every layer.
 
 | Layer               | Purpose                                                                                          |
 | ------------------- | ------------------------------------------------------------------------------------------------ |
@@ -498,6 +501,22 @@ See [src/mongodb](src/mongodb) for additional documentation, and [examples/mongo
 
 See [src/redis](src/redis) for additional documentation, and [examples/redis](examples/redis/index.ts) for runnable projection examples.
 
+#### PostgreSQL (`node-cqrs/postgresql`, peer dep: `pg`)
+
+> **Experimental** - not yet validated in production. APIs may change in minor versions.
+
+| Class                     | Role                                                                                  |
+| ------------------------- | ------------------------------------------------------------------------------------- |
+| `PostgresqlEventStorage`  | Transactional PostgreSQL event storage with saga refs and optimistic concurrency      |
+| `PostgresqlObjectStorage` | Key/value object storage backed by PostgreSQL `jsonb` rows                            |
+| `PostgresqlViewLocker`    | Prevents concurrent schema-migration rebuilds; auto-prolongs lock via token + TTL row |
+| `PostgresqlEventLocker`   | Event deduplication and last-event checkpoint                                         |
+| `PostgresqlObjectView`    | Composite view combining object storage, view locking, and event checkpointing        |
+| `AbstractPostgresqlObjectProjection` | Base projection wired to `PostgresqlObjectView`                            |
+| `AbstractPostgresqlView`  | Base class for custom relational PostgreSQL views with view and event locks embedded  |
+
+See [src/postgresql](src/postgresql) for additional documentation, and [examples/postgresql](examples/postgresql/index.ts) for a runnable projection example.
+
 ### Message Buses
 
 How commands and events move between producers and consumers.
@@ -543,6 +562,7 @@ See [examples/telemetry/index.ts](examples/telemetry/index.ts) for a full workin
 - [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/postgresql](examples/postgresql/index.ts) - PostgreSQL-backed event storage and projection view
 - [examples/telemetry](examples/telemetry/index.ts) - OpenTelemetry tracing with multiple exporters
 
 TS examples can be run with NodeJS 24+ without transpiling.

package/dist/cjs/postgresql/AbstractPostgresqlAccessor.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractPostgresqlAccessor = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const index_ts_1 = require("../utils/index.js");
+const transactionConnectionStorage = new node_async_hooks_1.AsyncLocalStorage();
+/**
+ * Abstract base class for accessing a PostgreSQL connection.
+ *
+ * Manages the connection lifecycle, ensuring initialization via `assertConnection`.
+ * Supports providing a query-capable connection directly or a factory function for lazy initialization.
+ *
+ * Subclasses must implement the `initialize` method for specific setup tasks.
+ */
+class AbstractPostgresqlAccessor {
+    db;
+    #dbFactory;
+    #initLocker = new index_ts_1.Lock();
+    #initialized = false;
+    constructor(c) {
+        if (!c.viewModelPostgresqlDb && !c.viewModelPostgresqlDbFactory)
+            throw new TypeError('either viewModelPostgresqlDb or viewModelPostgresqlDbFactory argument required');
+        this.db = c.viewModelPostgresqlDb;
+        this.#dbFactory = c.viewModelPostgresqlDbFactory;
+    }
+    get connection() {
+        return transactionConnectionStorage.getStore() ?? this.db;
+    }
+    /**
+     * Ensures that the PostgreSQL connection is initialized.
+     * Uses a lock to prevent race conditions during concurrent initialization attempts.
+     * If the connection is not already set, it creates one using the provided factory
+     * and then calls the `initialize` method.
+     *
+     * This method is idempotent and safe to call multiple times.
+     */
+    async assertConnection() {
+        if (this.#initialized)
+            return;
+        try {
+            await this.#initLocker.acquire();
+            if (this.#initialized)
+                return;
+            if (!this.db)
+                this.db = await this.#dbFactory();
+            await this.initialize(this.db);
+            this.#initialized = true;
+        }
+        finally {
+            this.#initLocker.release();
+        }
+    }
+    async runInTransaction(callback) {
+        await this.assertConnection();
+        if (transactionConnectionStorage.getStore())
+            return callback();
+        const transactionConnection = await this.getTransactionConnection();
+        await transactionConnection.query('BEGIN');
+        try {
+            const result = await transactionConnectionStorage.run(transactionConnection, callback);
+            await transactionConnection.query('COMMIT');
+            return result;
+        }
+        catch (error) {
+            await transactionConnection.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            if ('release' in transactionConnection)
+                transactionConnection.release();
+        }
+    }
+    async getTransactionConnection() {
+        if (AbstractPostgresqlAccessor.isConnectionPool(this.db))
+            return this.db.connect();
+        return this.db;
+    }
+    static isConnectionPool(db) {
+        return typeof db?.connect === 'function';
+    }
+}
+exports.AbstractPostgresqlAccessor = AbstractPostgresqlAccessor;
+//# sourceMappingURL=AbstractPostgresqlAccessor.js.map

package/dist/cjs/postgresql/AbstractPostgresqlAccessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractPostgresqlAccessor.js","sourceRoot":"","sources":["../../../src/postgresql/AbstractPostgresqlAccessor.ts"],"names":[],"mappings":";;;AACA,uDAAqD;AACrD,gDAAyC;AAWzC,MAAM,4BAA4B,GAAG,IAAI,oCAAiB,EAAwB,CAAC;AAEnF;;;;;;;GAOG;AACH,MAAsB,0BAA0B;IAErC,EAAE,CAAmC;IACtC,UAAU,CAA2E;IACrF,WAAW,GAAG,IAAI,eAAI,EAAE,CAAC;IAClC,YAAY,GAAG,KAAK,CAAC;IAErB,YAAY,CAAsF;QACjG,IAAI,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,4BAA4B;YAC9D,MAAM,IAAI,SAAS,CAAC,gFAAgF,CAAC,CAAC;QAEvG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,4BAA4B,CAAC;IAClD,CAAC;IAID,IAAc,UAAU;QACvB,OAAO,4BAA4B,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAG,CAAC;IAC5D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,gBAAgB;QACrB,IAAI,IAAI,CAAC,YAAY;YACpB,OAAO;QAER,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,YAAY;gBACpB,OAAO;YAER,IAAI,CAAC,IAAI,CAAC,EAAE;gBACX,IAAI,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,UAAW,EAAE,CAAC;YAEpC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAE/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC1B,CAAC;gBACO,CAAC;YACR,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC;IACF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAI,QAA8B;QACvD,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9B,IAAI,4BAA4B,CAAC,QAAQ,EAAE;YAC1C,OAAO,QAAQ,EAAE,CAAC;QAEnB,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAEpE,MAAM,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAAC,GAAG,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;YACvF,MAAM,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC;QACf,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACd,MAAM,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9C,MAAM,KAAK,CAAC;QACb,CAAC;gBACO,CAAC;YACR,IAAI,SAAS,IAAI,qBAAqB;gBACrC,qBAAqB,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,wBAAwB;QACrC,IAAI,0BAA0B,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAE1B,OAAO,IAAI,CAAC,EAAG,CAAC;IACjB,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,EAAoC;QACnE,OAAO,OAAQ,EAA2C,EAAE,OAAO,KAAK,UAAU,CAAC;IACpF,CAAC;CACD;AApFD,gEAoFC"}

package/dist/cjs/postgresql/AbstractPostgresqlObjectProjection.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractPostgresqlObjectProjection = void 0;
+const AbstractProjection_ts_1 = require("../AbstractProjection.js");
+const PostgresqlObjectView_ts_1 = require("./PostgresqlObjectView.js");
+class AbstractPostgresqlObjectProjection extends AbstractProjection_ts_1.AbstractProjection {
+    static get tableName() {
+        throw new Error('tableName is not defined');
+    }
+    static get schemaVersion() {
+        throw new Error('schemaVersion is not defined');
+    }
+    constructor({ eventLockTableName, eventLockTtl, logger, postgresqlObjectStorageMaxRetries, viewLockTableName, viewLockTtl, viewModelPostgresqlDb, viewModelPostgresqlDbFactory }) {
+        super({ logger });
+        this.view = new PostgresqlObjectView_ts_1.PostgresqlObjectView({
+            schemaVersion: new.target.schemaVersion,
+            projectionName: new.target.name,
+            viewModelPostgresqlDb,
+            viewModelPostgresqlDbFactory,
+            tableNamePrefix: new.target.tableName,
+            eventLockTableName,
+            eventLockTtl,
+            postgresqlObjectStorageMaxRetries,
+            viewLockTableName,
+            viewLockTtl,
+            logger
+        });
+    }
+    async project(event, meta) {
+        if (this._viewLocker && !this._viewLocker.ready)
+            await this._viewLocker.once('ready');
+        await this.view.runInTransaction(() => super.project(event, meta));
+    }
+}
+exports.AbstractPostgresqlObjectProjection = AbstractPostgresqlObjectProjection;
+//# sourceMappingURL=AbstractPostgresqlObjectProjection.js.map

package/dist/cjs/postgresql/AbstractPostgresqlObjectProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractPostgresqlObjectProjection.js","sourceRoot":"","sources":["../../../src/postgresql/AbstractPostgresqlObjectProjection.ts"],"names":[],"mappings":";;;AACA,oEAA8D;AAE9D,uEAAiE;AAkBjE,MAAsB,kCAAsC,SAAQ,0CAA2C;IAE9G,MAAM,KAAK,SAAS;QACnB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,aAAa;QACvB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACjD,CAAC;IAED,YAAY,EACX,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,iCAAiC,EACjC,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,4BAA4B,EACM;QAClC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAElB,IAAI,CAAC,IAAI,GAAG,IAAI,8CAAoB,CAAC;YACpC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa;YACvC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;YAC/B,qBAAqB;YACrB,4BAA4B;YAC5B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;YACrC,kBAAkB;YAClB,YAAY;YACZ,iCAAiC;YACjC,iBAAiB;YACjB,WAAW;YACX,MAAM;SACN,CAAC,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,IAA0B;QAC/D,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK;YAC9C,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;CACD;AA3CD,gFA2CC"}

package/dist/cjs/postgresql/AbstractPostgresqlView.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractPostgresqlView = void 0;
+const assert_ts_1 = require("../utils/assert.js");
+const AbstractPostgresqlAccessor_ts_1 = require("./AbstractPostgresqlAccessor.js");
+const PostgresqlEventLocker_ts_1 = require("./PostgresqlEventLocker.js");
+const PostgresqlViewLocker_ts_1 = require("./PostgresqlViewLocker.js");
+/**
+ * Base class for PostgreSQL-backed projection views with restore locking and last-processed-event tracking.
+ */
+class AbstractPostgresqlView extends AbstractPostgresqlAccessor_ts_1.AbstractPostgresqlAccessor {
+    schemaVersion;
+    viewLocker;
+    eventLocker;
+    logger;
+    get ready() {
+        return this.viewLocker.ready;
+    }
+    constructor(options) {
+        (0, assert_ts_1.assertString)(options.projectionName, 'projectionName');
+        (0, assert_ts_1.assertString)(options.schemaVersion, 'schemaVersion');
+        super(options);
+        this.schemaVersion = options.schemaVersion;
+        this.viewLocker = new PostgresqlViewLocker_ts_1.PostgresqlViewLocker(options);
+        this.eventLocker = new PostgresqlEventLocker_ts_1.PostgresqlEventLocker(options);
+        this.logger = options.logger && 'child' in options.logger ?
+            options.logger.child({ serviceName: new.target.name }) :
+            options.logger;
+    }
+    async lock() {
+        return this.viewLocker.lock();
+    }
+    async unlock() {
+        await this.viewLocker.unlock();
+    }
+    once(event) {
+        return this.viewLocker.once(event);
+    }
+    getLastEvent() {
+        return this.eventLocker.getLastEvent();
+    }
+    tryMarkAsProjecting(event) {
+        return this.eventLocker.tryMarkAsProjecting(event);
+    }
+    markAsProjected(event) {
+        return this.eventLocker.markAsProjected(event);
+    }
+    markAsLastEvent(event) {
+        return this.eventLocker.markAsLastEvent(event);
+    }
+}
+exports.AbstractPostgresqlView = AbstractPostgresqlView;
+//# sourceMappingURL=AbstractPostgresqlView.js.map

package/dist/cjs/postgresql/AbstractPostgresqlView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractPostgresqlView.js","sourceRoot":"","sources":["../../../src/postgresql/AbstractPostgresqlView.ts"],"names":[],"mappings":";;;AAEA,kDAAkD;AAClD,mFAA6E;AAC7E,yEAAqG;AACrG,uEAAkG;AAElG;;GAEG;AACH,MAAsB,sBAAuB,SAAQ,0DAA0B;IAE3D,aAAa,CAAS;IACtB,UAAU,CAAuB;IACjC,WAAW,CAAwB;IAC5C,MAAM,CAAsB;IAEtC,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,YAAY,OAEiB;QAC5B,IAAA,wBAAY,EAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;QACvD,IAAA,wBAAY,EAAC,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;QAErD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,8CAAoB,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,IAAI,gDAAqB,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,MAAM,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM;QACX,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,KAAc;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,YAAY;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;IACxC,CAAC;IAED,mBAAmB,CAAC,KAAa;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,eAAe,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,eAAe,CAAC,KAAa;QAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;CACD;AAtDD,wDAsDC"}

package/dist/cjs/postgresql/IContainer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IContainer.js.map

package/dist/cjs/postgresql/IContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IContainer.js","sourceRoot":"","sources":["../../../src/postgresql/IContainer.ts"],"names":[],"mappings":""}

package/dist/cjs/postgresql/PostgresqlConnection.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PostgresqlConnection.js.map

package/dist/cjs/postgresql/PostgresqlConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresqlConnection.js","sourceRoot":"","sources":["../../../src/postgresql/PostgresqlConnection.ts"],"names":[],"mappings":""}

package/dist/cjs/postgresql/PostgresqlEventLocker.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresqlEventLocker = void 0;
+const assert_ts_1 = require("../utils/assert.js");
+const AbstractPostgresqlAccessor_ts_1 = require("./AbstractPostgresqlAccessor.js");
+const index_ts_1 = require("./utils/index.js");
+/**
+ * PostgreSQL-backed implementation of IEventLocker.
+ *
+ * Uses one table for per-event processing locks and the view lock table for the
+ * last processed event checkpoint.
+ */
+class PostgresqlEventLocker extends AbstractPostgresqlAccessor_ts_1.AbstractPostgresqlAccessor {
+    static DEFAULT_EVENT_LOCK_TTL = 15_000;
+    static DEFAULT_EVENT_LOCK_TABLE = 'ncqrs_event_locks';
+    static DEFAULT_VIEW_LOCK_TABLE = 'ncqrs_view_locks';
+    #projectionName;
+    #schemaVersion;
+    #viewLockTableName;
+    #eventLockTableName;
+    #eventLockTtl;
+    constructor(o) {
+        super(o);
+        (0, assert_ts_1.assertString)(o.projectionName, 'o.projectionName');
+        (0, assert_ts_1.assertString)(o.schemaVersion, 'o.schemaVersion');
+        if (o.viewLockTableName !== undefined)
+            (0, assert_ts_1.assertString)(o.viewLockTableName, 'o.viewLockTableName');
+        if (o.eventLockTableName !== undefined)
+            (0, assert_ts_1.assertString)(o.eventLockTableName, 'o.eventLockTableName');
+        if (o.eventLockTtl !== undefined)
+            (0, assert_ts_1.assertNonNegativeInteger)(o.eventLockTtl, 'o.eventLockTtl');
+        this.#projectionName = o.projectionName;
+        this.#schemaVersion = o.schemaVersion;
+        this.#viewLockTableName = (0, index_ts_1.quoteIdentifier)(o.viewLockTableName ?? PostgresqlEventLocker.DEFAULT_VIEW_LOCK_TABLE);
+        this.#eventLockTableName = (0, index_ts_1.quoteIdentifier)(o.eventLockTableName ?? PostgresqlEventLocker.DEFAULT_EVENT_LOCK_TABLE);
+        this.#eventLockTtl = o.eventLockTtl ?? PostgresqlEventLocker.DEFAULT_EVENT_LOCK_TTL;
+    }
+    async initialize(db) {
+        await db.query(`
+			CREATE TABLE IF NOT EXISTS ${this.#viewLockTableName} (
+				projection_name text NOT NULL,
+				schema_version text NOT NULL,
+				locked_till timestamptz NULL,
+				lock_token text NULL,
+				last_event text NULL,
+				PRIMARY KEY (projection_name, schema_version)
+			)
+		`);
+        await db.query(`
+			CREATE TABLE IF NOT EXISTS ${this.#eventLockTableName} (
+				projection_name text NOT NULL,
+				schema_version text NOT NULL,
+				event_id text NOT NULL,
+				processing_at timestamptz NOT NULL DEFAULT NOW(),
+				processed_at timestamptz NULL,
+				PRIMARY KEY (projection_name, schema_version, event_id)
+			)
+		`);
+        await db.query(`
+			CREATE INDEX IF NOT EXISTS ${(0, index_ts_1.quoteIdentifier)(`${this.#tableNameForIndex()}_processing_at_idx`)}
+			ON ${this.#eventLockTableName} (processing_at)
+		`);
+    }
+    async tryMarkAsProjecting(event) {
+        await this.assertConnection();
+        const eventId = (0, index_ts_1.getEventId)(event);
+        const r = await this.connection.query(`
+			INSERT INTO ${this.#eventLockTableName} AS event_lock
+				(projection_name, schema_version, event_id, processing_at, processed_at)
+			VALUES ($1, $2, $3, NOW(), NULL)
+			ON CONFLICT (projection_name, schema_version, event_id)
+			DO UPDATE SET
+				processing_at = NOW(),
+				processed_at = NULL
+			WHERE
+				event_lock.processed_at IS NULL
+				AND event_lock.processing_at <= NOW() - ($4::double precision * INTERVAL '1 millisecond')
+		`, [this.#projectionName, this.#schemaVersion, eventId, this.#eventLockTtl]);
+        return r.rowCount !== 0;
+    }
+    async markAsProjected(event) {
+        await this.assertConnection();
+        const eventId = (0, index_ts_1.getEventId)(event);
+        const result = await this.connection.query(`
+			UPDATE ${this.#eventLockTableName}
+			SET
+				processed_at = NOW()
+			WHERE
+				projection_name = $1
+				AND schema_version = $2
+				AND event_id = $3
+				AND processed_at IS NULL
+		`, [this.#projectionName, this.#schemaVersion, eventId]);
+        if (result.rowCount !== 1)
+            throw new Error(`Event ${event.id} could not be marked as processed`);
+    }
+    async markAsLastEvent(event) {
+        await this.assertConnection();
+        await this.connection.query(`
+			INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, last_event)
+			VALUES ($1, $2, $3)
+			ON CONFLICT (projection_name, schema_version)
+			DO UPDATE SET
+				last_event = excluded.last_event
+		`, [this.#projectionName, this.#schemaVersion, JSON.stringify(event)]);
+    }
+    async getLastEvent() {
+        await this.assertConnection();
+        const viewInfoRecord = await this.connection.query(`
+			SELECT
+				last_event
+			FROM ${this.#viewLockTableName}
+			WHERE
+				projection_name = $1
+				AND schema_version = $2
+		`, [this.#projectionName, this.#schemaVersion]);
+        const lastEvent = viewInfoRecord.rows[0]?.last_event;
+        if (!lastEvent)
+            return undefined;
+        return JSON.parse(lastEvent);
+    }
+    #tableNameForIndex() {
+        return this.#eventLockTableName.replaceAll('"', '').replaceAll('.', '_');
+    }
+}
+exports.PostgresqlEventLocker = PostgresqlEventLocker;
+//# sourceMappingURL=PostgresqlEventLocker.js.map

package/dist/cjs/postgresql/PostgresqlEventLocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresqlEventLocker.js","sourceRoot":"","sources":["../../../src/postgresql/PostgresqlEventLocker.ts"],"names":[],"mappings":"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"}