node-cqrs 1.0.0 → 1.1.0-alpha.1

package/dist/cjs/mongodb/MongoEventStorage.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoEventStorage = void 0;
+const mongodb_1 = require("mongodb");
+const index_ts_1 = require("../utils/index.js");
+const index_ts_2 = require("../errors/index.js");
+const assert_ts_1 = require("../utils/assert.js");
+const registerExitCleanup_ts_1 = require("./registerExitCleanup.js");
+function toObjectId(id) {
+    return new mongodb_1.ObjectId(String(id));
+}
+function isHexObjectId(value) {
+    return typeof value === 'string' && value.length === 24 && /^[0-9a-f]{24}$/i.test(value);
+}
+function toObjectIdOrString(aggregateId) {
+    if (isHexObjectId(aggregateId))
+        return toObjectId(aggregateId);
+    return String(aggregateId);
+}
+function toEvent(doc) {
+    const { _id, aggregateId, ...rest } = doc;
+    return {
+        ...rest,
+        id: _id.toHexString(),
+        ...aggregateId && {
+            aggregateId: aggregateId instanceof mongodb_1.ObjectId ? aggregateId.toHexString() : aggregateId
+        }
+    };
+}
+function toEventDocument(event) {
+    const { id, aggregateId, ...rest } = event;
+    return {
+        ...rest,
+        _id: id !== undefined ? toObjectId(id) : new mongodb_1.ObjectId(),
+        ...aggregateId && {
+            aggregateId: toObjectIdOrString(aggregateId)
+        }
+    };
+}
+/**
+ * MongoDB-backed event storage for node-cqrs.
+ * Implements IEventStorageReader, IIdentifierProvider, and IDispatchPipelineProcessor.
+ */
+class MongoEventStorage {
+    static EVENTS_COLLECTION = 'events';
+    #initPromise;
+    constructor({ mongoDbFactory, mongoEventStorageConfig, process }) {
+        (0, assert_ts_1.assertFunction)(mongoDbFactory, 'mongoDbFactory');
+        const collectionName = mongoEventStorageConfig?.collection ?? MongoEventStorage.EVENTS_COLLECTION;
+        (0, assert_ts_1.assertString)(collectionName, 'mongoEventStorageConfig.collection');
+        this.#initPromise = MongoEventStorage.#init(mongoDbFactory, collectionName);
+        if (process) {
+            (0, registerExitCleanup_ts_1.registerExitCleanup)(process, async () => {
+                const { db } = await this.#initPromise;
+                await db.client.close();
+            });
+        }
+    }
+    static async #init(factory, collectionName) {
+        const db = await factory();
+        const collection = db.collection(collectionName);
+        await Promise.all([
+            collection.createIndex({ aggregateId: 1, aggregateVersion: 1 }, { unique: true, sparse: true }),
+            collection.createIndex({ 'sagaOrigins.$**': 1 }),
+            collection.createIndex({ type: 1, _id: 1 })
+        ]);
+        return { db, collection };
+    }
+    // eslint-disable-next-line class-methods-use-this
+    getNewId() {
+        return new mongodb_1.ObjectId().toHexString();
+    }
+    async commitEvents(events, options) {
+        if (options?.ignoreConcurrencyError)
+            throw new Error('ignoreConcurrencyError is not supported by MongoEventStorage');
+        const { collection } = await this.#initPromise;
+        const docs = events.map(toEventDocument);
+        const insertedIds = [];
+        try {
+            for (const doc of docs) {
+                await collection.insertOne(doc);
+                insertedIds.push(doc._id);
+            }
+        }
+        catch (err) {
+            if (insertedIds.length)
+                await collection.deleteMany({ _id: { $in: insertedIds } });
+            if (typeof err === 'object' && err !== null && 'code' in err && err.code === 11000)
+                throw new index_ts_2.ConcurrencyError('Concurrency conflict: duplicate event version');
+            throw err;
+        }
+        docs.forEach((doc, i) => {
+            events[i].id = doc._id.toHexString();
+        });
+        return events;
+    }
+    async *getAggregateEvents(aggregateId, options) {
+        const { collection } = await this.#initPromise;
+        const filter = {
+            aggregateId: toObjectIdOrString(aggregateId)
+        };
+        const snapshotVersion = options?.snapshot?.aggregateVersion;
+        if (snapshotVersion !== undefined)
+            filter.aggregateVersion = { $gt: snapshotVersion };
+        const hasTypeFilter = options?.eventTypes !== undefined && options.eventTypes.length > 0;
+        if (hasTypeFilter)
+            filter.type = { $in: options.eventTypes };
+        const cursor = collection.find(filter, {
+            sort: { aggregateVersion: 1 }
+        });
+        let lastDoc;
+        for await (const doc of cursor) {
+            lastDoc = doc;
+            yield toEvent(doc);
+        }
+        if (options?.tail === 'last' && hasTypeFilter) {
+            const tailFilter = {
+                aggregateId: toObjectIdOrString(aggregateId),
+                ...snapshotVersion && {
+                    aggregateVersion: { $gt: snapshotVersion }
+                }
+            };
+            const tailDoc = await collection.findOne(tailFilter, {
+                sort: { aggregateVersion: -1 }
+            });
+            if (tailDoc && (!lastDoc || tailDoc._id.toHexString() !== lastDoc._id.toHexString()))
+                yield toEvent(tailDoc);
+        }
+    }
+    async *getSagaEvents(sagaId, { beforeEvent }) {
+        if (typeof beforeEvent?.id !== 'string' || !beforeEvent.id.length)
+            throw new TypeError('beforeEvent.id must be a non-empty String');
+        const { sagaDescriptor, originEventId } = (0, index_ts_1.parseSagaId)(sagaId);
+        if (beforeEvent.sagaOrigins?.[sagaDescriptor] !== originEventId)
+            throw new TypeError('beforeEvent.sagaOrigins does not match sagaId');
+        const { collection } = await this.#initPromise;
+        const originObjectId = toObjectId(originEventId);
+        const beforeObjectId = toObjectId(beforeEvent.id);
+        const [originDoc, beforeDoc] = await Promise.all([
+            collection.findOne({ _id: originObjectId }),
+            collection.findOne({ _id: beforeObjectId })
+        ]);
+        if (!originDoc)
+            throw new Error(`origin event ${originEventId} not found`);
+        if (!beforeDoc)
+            throw new Error(`beforeEvent ${beforeEvent.id} not found`);
+        const filter = {
+            $or: [
+                { _id: originObjectId },
+                {
+                    [`sagaOrigins.${sagaDescriptor}`]: originEventId,
+                    _id: {
+                        $gt: originObjectId,
+                        $lt: beforeObjectId
+                    }
+                }
+            ]
+        };
+        const cursor = collection.find(filter, {
+            sort: { _id: 1 }
+        });
+        for await (const doc of cursor)
+            yield toEvent(doc);
+    }
+    async *getEventsByTypes(eventTypes, options) {
+        if (options?.afterEvent !== undefined && (typeof options.afterEvent.id !== 'string' || !options.afterEvent.id.length))
+            throw new TypeError('options.afterEvent.id must be a non-empty String');
+        const { collection } = await this.#initPromise;
+        const filter = {
+            type: { $in: eventTypes }
+        };
+        if (options?.afterEvent?.id)
+            filter._id = { $gt: toObjectId(options.afterEvent.id) };
+        const cursor = collection.find(filter, {
+            sort: { _id: 1 }
+        });
+        for await (const doc of cursor)
+            yield toEvent(doc);
+    }
+    /**
+     * Processes a batch of dispatch pipeline items, commits the events to MongoDB,
+     * and returns the original batch.
+     *
+     * This method is part of the `IDispatchPipelineProcessor` interface.
+     */
+    async process(batch) {
+        const events = [];
+        for (const { event } of batch) {
+            if (!event)
+                throw new Error('Event batch does not contain `event`');
+            events.push(event);
+        }
+        await this.commitEvents(events, {
+            ignoreConcurrencyError: batch[0]?.ignoreConcurrencyError
+        });
+        return batch;
+    }
+}
+exports.MongoEventStorage = MongoEventStorage;
+//# sourceMappingURL=MongoEventStorage.js.map

package/dist/cjs/mongodb/MongoEventStorage.js.map

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

package/dist/cjs/mongodb/MongoObjectStorage.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoObjectStorage = void 0;
+const assert_ts_1 = require("../utils/assert.js");
+const AbstractMongoAccessor_ts_1 = require("./AbstractMongoAccessor.js");
+/**
+ * MongoDB-backed implementation of IObjectStorage.
+ *
+ * Each record is stored as a document `{ _id, data, version }`.
+ * The version field enables optimistic concurrency control: `update` and
+ * `updateEnforcingNew` re-read the record after the user callback runs and
+ * atomically commit only when the version still matches.
+ * On mismatch the operation retries up to `maxRetries` times.
+ */
+class MongoObjectStorage extends AbstractMongoAccessor_ts_1.AbstractMongoAccessor {
+    #tableName;
+    #maxRetries;
+    #collection;
+    constructor(o) {
+        super(o);
+        (0, assert_ts_1.assertString)(o.tableName, 'tableName');
+        if (o.maxRetries !== undefined)
+            (0, assert_ts_1.assertNonNegativeInteger)(o.maxRetries, 'maxRetries');
+        this.#tableName = o.tableName;
+        this.#maxRetries = o.maxRetries ?? 100;
+    }
+    async initialize(db) {
+        this.#collection = db.collection(this.#tableName);
+    }
+    async get(id) {
+        (0, assert_ts_1.assertDefined)(id, 'id');
+        await this.assertConnection();
+        const doc = await this.#collection.findOne({ _id: String(id) });
+        if (!doc)
+            return undefined;
+        return doc.data;
+    }
+    async create(id, data) {
+        (0, assert_ts_1.assertDefined)(id, 'id');
+        await this.assertConnection();
+        try {
+            await this.#collection.insertOne({ _id: String(id), data, version: 1 });
+        }
+        catch (err) {
+            if (typeof err === 'object' && err !== null && 'code' in err && err.code === 11000)
+                throw new Error(`Record '${id}' could not be created`);
+            throw err;
+        }
+    }
+    async update(id, update) {
+        (0, assert_ts_1.assertDefined)(id, 'id');
+        (0, assert_ts_1.assertFunction)(update, 'update');
+        await this.assertConnection();
+        for (let attempt = 0; attempt <= this.#maxRetries; attempt++) {
+            const doc = await this.#collection.findOne({ _id: String(id) });
+            if (!doc)
+                throw new Error(`Record '${id}' does not exist`);
+            const updatedData = update(doc.data);
+            const result = await this.#collection.findOneAndUpdate({ _id: String(id), version: doc.version }, { $set: { data: updatedData, version: doc.version + 1 } });
+            if (result)
+                return;
+            // version mismatch — retry
+        }
+        throw new Error(`Record '${id}' could not be updated after ${this.#maxRetries} retries`);
+    }
+    async updateEnforcingNew(id, update) {
+        (0, assert_ts_1.assertDefined)(id, 'id');
+        (0, assert_ts_1.assertFunction)(update, 'update');
+        await this.assertConnection();
+        for (let attempt = 0; attempt <= this.#maxRetries; attempt++) {
+            const doc = await this.#collection.findOne({ _id: String(id) });
+            if (doc) {
+                const updatedData = update(doc.data);
+                const result = await this.#collection.findOneAndUpdate({ _id: String(id), version: doc.version }, { $set: { data: updatedData, version: doc.version + 1 } });
+                if (result)
+                    return;
+                // version mismatch — retry
+            }
+            else {
+                try {
+                    await this.#collection.insertOne({ _id: String(id), data: update(undefined), version: 1 });
+                    return;
+                }
+                catch (err) {
+                    if (typeof err === 'object' && err !== null && 'code' in err && err.code === 11000)
+                        continue; // Another process inserted first — retry
+                    throw err;
+                }
+            }
+        }
+        throw new Error(`Record '${id}' could not be upserted after ${this.#maxRetries} retries`);
+    }
+    async delete(id) {
+        (0, assert_ts_1.assertDefined)(id, 'id');
+        await this.assertConnection();
+        const result = await this.#collection.deleteOne({ _id: String(id) });
+        return result.deletedCount === 1;
+    }
+}
+exports.MongoObjectStorage = MongoObjectStorage;
+//# sourceMappingURL=MongoObjectStorage.js.map

package/dist/cjs/mongodb/MongoObjectStorage.js.map

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

package/dist/cjs/mongodb/MongoObjectView.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoObjectView = void 0;
+const AbstractMongoView_ts_1 = require("./AbstractMongoView.js");
+const MongoObjectStorage_ts_1 = require("./MongoObjectStorage.js");
+const assert_ts_1 = require("../utils/assert.js");
+/**
+ * MongoDB-backed object view with restore locking and last-processed-event tracking
+ */
+class MongoObjectView extends AbstractMongoView_ts_1.AbstractMongoView {
+    #mongoObjectStorage;
+    constructor(options) {
+        (0, assert_ts_1.assertString)(options?.tableNamePrefix, 'tableNamePrefix');
+        (0, assert_ts_1.assertString)(options?.schemaVersion, 'schemaVersion');
+        super(options);
+        this.#mongoObjectStorage = new MongoObjectStorage_ts_1.MongoObjectStorage({
+            viewModelMongoDb: options.viewModelMongoDb,
+            viewModelMongoDbFactory: options.viewModelMongoDbFactory,
+            tableName: `${options.tableNamePrefix}_${options.schemaVersion}`
+        });
+    }
+    async get(id) {
+        if (!this.ready)
+            await this.once('ready');
+        return this.#mongoObjectStorage.get(id);
+    }
+    async create(id, data) {
+        await this.#mongoObjectStorage.create(id, data);
+    }
+    async update(id, update) {
+        await this.#mongoObjectStorage.update(id, update);
+    }
+    async updateEnforcingNew(id, update) {
+        await this.#mongoObjectStorage.updateEnforcingNew(id, update);
+    }
+    async delete(id) {
+        return this.#mongoObjectStorage.delete(id);
+    }
+}
+exports.MongoObjectView = MongoObjectView;
+//# sourceMappingURL=MongoObjectView.js.map

package/dist/cjs/mongodb/MongoObjectView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoObjectView.js","sourceRoot":"","sources":["../../../src/mongodb/MongoObjectView.ts"],"names":[],"mappings":";;;AAAA,iEAA2D;AAE3D,mEAA6D;AAC7D,kDAAkD;AAElD;;GAEG;AACH,MAAa,eAAyB,SAAQ,wCAAiB;IAErD,mBAAmB,CAA8B;IAE1D,YAAY,OAEX;QACA,IAAA,wBAAY,EAAC,OAAO,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAC;QAC1D,IAAA,wBAAY,EAAC,OAAO,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QAEtD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,mBAAmB,GAAG,IAAI,0CAAkB,CAAU;YAC1D,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;YACxD,SAAS,EAAE,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,aAAa,EAAE;SAChE,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAc;QACvB,IAAI,CAAC,IAAI,CAAC,KAAK;YACd,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1B,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAc,EAAE,IAAa;QACzC,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAc,EAAE,MAA+B;QAC3D,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,EAAc,EAAE,MAAgC;QACxE,MAAM,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAc;QAC1B,OAAO,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;CACD;AAzCD,0CAyCC"}

package/dist/cjs/mongodb/MongoProjectionDataParams.js

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

package/dist/cjs/mongodb/MongoProjectionDataParams.js.map

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

package/dist/cjs/mongodb/MongoViewLocker.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoViewLocker = void 0;
+const index_ts_1 = require("../utils/index.js");
+const util_1 = require("util");
+const node_crypto_1 = require("node:crypto");
+const AbstractMongoAccessor_ts_1 = require("./AbstractMongoAccessor.js");
+const delay = (0, util_1.promisify)(setTimeout);
+/**
+ * MongoDB-backed implementation of IViewLocker.
+ *
+ * Uses a MongoDB document with token + lockedTill semantics to acquire a distributed view lock.
+ * The lock is automatically prolonged at half the TTL interval to prevent expiration
+ * while processing is in progress.
+ *
+ * Collection name: `ncqrs_view_locks`
+ */
+class MongoViewLocker extends AbstractMongoAccessor_ts_1.AbstractMongoAccessor {
+    static DEFAULT_VIEW_LOCK_TTL = 120_000;
+    static DEFAULT_COLLECTION = 'ncqrs_view_locks';
+    #projectionName;
+    #lockId;
+    #viewLockTtl;
+    #collectionName;
+    #logger;
+    #lockToken;
+    #lockMarker;
+    #lockProlongationTimeout;
+    #collection;
+    constructor(o) {
+        super(o);
+        (0, index_ts_1.assertString)(o.projectionName, 'projectionName');
+        (0, index_ts_1.assertString)(o.schemaVersion, 'schemaVersion');
+        if (o.viewLocksCollection !== undefined)
+            (0, index_ts_1.assertString)(o.viewLocksCollection, 'viewLocksCollection');
+        this.#projectionName = o.projectionName;
+        this.#collectionName = o.viewLocksCollection ?? MongoViewLocker.DEFAULT_COLLECTION;
+        this.#lockId = `${o.projectionName}:${o.schemaVersion}`;
+        this.#viewLockTtl = o.viewLockTtl ?? MongoViewLocker.DEFAULT_VIEW_LOCK_TTL;
+        this.#logger = o.logger && 'child' in o.logger ?
+            o.logger.child({ service: this.constructor.name }) :
+            o.logger;
+    }
+    async initialize(db) {
+        this.#collection = db.collection(this.#collectionName);
+        await this.#collection.createIndex({ lockedTill: 1 }, { sparse: true });
+    }
+    get ready() {
+        return !this.#lockMarker;
+    }
+    async lock() {
+        this.#lockMarker = new index_ts_1.Deferred();
+        this.#lockToken = (0, node_crypto_1.randomUUID)();
+        await this.assertConnection();
+        let lockAcquired = false;
+        while (!lockAcquired) {
+            const now = new Date();
+            const lockedTill = new Date(now.getTime() + this.#viewLockTtl);
+            // Claim an expired or released lock if one exists
+            const updateResult = await this.#collection.updateOne({
+                _id: this.#lockId,
+                $or: [
+                    { lockedTill: null },
+                    { lockedTill: { $exists: false } },
+                    { lockedTill: { $lt: now } }
+                ]
+            }, { $set: { lockedTill, token: this.#lockToken } });
+            if (updateResult.modifiedCount === 1) {
+                lockAcquired = true;
+            }
+            else {
+                // No existing document matched — try to insert a fresh lock
+                try {
+                    await this.#collection.insertOne({
+                        _id: this.#lockId,
+                        lockedTill,
+                        token: this.#lockToken,
+                        lastEvent: null
+                    });
+                    lockAcquired = true;
+                }
+                catch (err) {
+                    if (typeof err === 'object' && err !== null && 'code' in err && err.code === 11000) {
+                        // Document exists and is actively locked — wait and retry
+                        this.#logger?.debug(`"${this.#projectionName}" is locked by another process`);
+                        await delay(this.#viewLockTtl / 2);
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+            }
+        }
+        this.#logger?.debug(`"${this.#projectionName}" lock obtained for ${this.#viewLockTtl}ms`);
+        this.scheduleLockProlongation();
+        return true;
+    }
+    scheduleLockProlongation() {
+        const ms = this.#viewLockTtl / 2;
+        this.#lockProlongationTimeout = setTimeout(() => this.prolongLock(), ms);
+        this.#lockProlongationTimeout.unref();
+        this.#logger?.debug(`"${this.#projectionName}" lock refresh scheduled in ${ms}ms`);
+    }
+    cancelLockProlongation() {
+        clearTimeout(this.#lockProlongationTimeout);
+        this.#logger?.debug(`"${this.#projectionName}" lock refresh canceled`);
+    }
+    async prolongLock() {
+        await this.assertConnection();
+        const lockedTill = new Date(Date.now() + this.#viewLockTtl);
+        const result = await this.#collection.findOneAndUpdate({ _id: this.#lockId, token: this.#lockToken }, { $set: { lockedTill } });
+        if (!result)
+            throw new Error(`"${this.#projectionName}" lock could not be prolonged`);
+        this.#logger?.debug(`"${this.#projectionName}" lock prolonged for ${this.#viewLockTtl}ms`);
+        this.scheduleLockProlongation();
+    }
+    async unlock() {
+        this.#lockMarker?.resolve();
+        this.#lockMarker = undefined;
+        this.cancelLockProlongation();
+        await this.assertConnection();
+        const result = await this.#collection.findOneAndUpdate({ _id: this.#lockId, token: this.#lockToken }, { $set: { lockedTill: null, token: null } });
+        this.#lockToken = undefined;
+        if (result)
+            this.#logger?.debug(`"${this.#projectionName}" lock released`);
+        else
+            this.#logger?.warn(`"${this.#projectionName}" lock didn't exist`);
+    }
+    once(event) {
+        if (event !== 'ready')
+            throw new TypeError(`Unexpected event: ${event}`);
+        return this.#lockMarker?.promise ?? Promise.resolve();
+    }
+}
+exports.MongoViewLocker = MongoViewLocker;
+//# sourceMappingURL=MongoViewLocker.js.map

package/dist/cjs/mongodb/MongoViewLocker.js.map

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

package/dist/cjs/mongodb/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./IContainer.js");
+__exportStar(require("./AbstractMongoAccessor.js"), exports);
+__exportStar(require("./AbstractMongoObjectProjection.js"), exports);
+__exportStar(require("./AbstractMongoView.js"), exports);
+__exportStar(require("./MongoEventLocker.js"), exports);
+__exportStar(require("./MongoEventStorage.js"), exports);
+__exportStar(require("./MongoObjectStorage.js"), exports);
+__exportStar(require("./MongoObjectView.js"), exports);
+__exportStar(require("./MongoProjectionDataParams.js"), exports);
+__exportStar(require("./MongoViewLocker.js"), exports);
+__exportStar(require("./utils/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/mongodb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mongodb/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2BAAyB;AAEzB,6DAA2C;AAC3C,qEAAmD;AACnD,yDAAuC;AACvC,wDAAsC;AACtC,yDAAuC;AACvC,0DAAwC;AACxC,uDAAqC;AACrC,iEAA+C;AAC/C,uDAAqC;AACrC,mDAAiC"}

package/dist/cjs/mongodb/registerExitCleanup.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerExitCleanup = void 0;
+/**
+ * Registers cleanup handlers for SIGINT and SIGTERM signals on a Node.js process.
+ * Executes the provided cleanup procedure when one of these signals is received,
+ * then removes the listeners to allow the process to exit gracefully.
+ *
+ * @returns An object with a `dispose` method to manually remove the registered signal handlers.
+ */
+const registerExitCleanup = (process, cleanupProcedure) => {
+    const handler = async () => {
+        // remove listeners to allow the process to exit
+        process?.off('SIGINT', handler);
+        process?.off('SIGTERM', handler);
+        await cleanupProcedure();
+    };
+    process?.once('SIGINT', handler);
+    process?.once('SIGTERM', handler);
+    return {
+        dispose: () => {
+            process?.off('SIGINT', handler);
+            process?.off('SIGTERM', handler);
+        }
+    };
+};
+exports.registerExitCleanup = registerExitCleanup;
+//# sourceMappingURL=registerExitCleanup.js.map

package/dist/cjs/mongodb/registerExitCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerExitCleanup.js","sourceRoot":"","sources":["../../../src/mongodb/registerExitCleanup.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,mBAAmB,GAAG,CAClC,OAAmC,EACnC,gBAAkD,EACjD,EAAE;IACH,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QAC1B,gDAAgD;QAChD,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEjC,MAAM,gBAAgB,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAElC,OAAO;QACN,OAAO,EAAE,GAAG,EAAE;YACb,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;KACD,CAAC;AACH,CAAC,CAAC;AArBW,QAAA,mBAAmB,uBAqB9B"}

package/dist/cjs/mongodb/utils/getEventId.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEventId = void 0;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Get assigned or generate a deterministic event ID as a hex string
+ */
+const getEventId = (event) => {
+    if (typeof event.id === 'string')
+        return event.id;
+    return (0, node_crypto_1.createHash)('md5').update(JSON.stringify(event)).digest('hex');
+};
+exports.getEventId = getEventId;
+//# sourceMappingURL=getEventId.js.map

package/dist/cjs/mongodb/utils/getEventId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getEventId.js","sourceRoot":"","sources":["../../../../src/mongodb/utils/getEventId.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAGzC;;GAEG;AACI,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE;IACnD,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,EAAE,CAAC;IAEjB,OAAO,IAAA,wBAAU,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC,CAAC;AALW,QAAA,UAAU,cAKrB"}

package/dist/cjs/mongodb/utils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./getEventId.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/mongodb/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mongodb/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC"}