node-cqrs 0.17.0 → 1.0.0-beta.1

package/dist/esm/utils/Deferred.js

@@ -0,0 +1,34 @@
+/**
+ * Deferred promise that must be resolved from outside
+ */
+export class Deferred {
+    promise;
+    get resolved() {
+        return this.#resolved;
+    }
+    get rejected() {
+        return this.#rejected;
+    }
+    get settled() {
+        return this.#resolved || this.#rejected;
+    }
+    #resolve;
+    #resolved = false;
+    #reject;
+    #rejected = false;
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.#resolve = resolve;
+            this.#reject = reject;
+        });
+    }
+    resolve(value) {
+        this.#resolve(value);
+        this.#resolved = true;
+    }
+    reject(reason) {
+        this.#reject(reason);
+        this.#rejected = true;
+    }
+}
+//# sourceMappingURL=Deferred.js.map

package/dist/esm/utils/Deferred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deferred.js","sourceRoot":"","sources":["../../../src/utils/Deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAQ;IAEX,OAAO,CAAiC;IAEjD,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;IACzC,CAAC;IAED,QAAQ,CAAkE;IAC1E,SAAS,GAAY,KAAK,CAAC;IAC3B,OAAO,CAA0B;IACjC,SAAS,GAAY,KAAK,CAAC;IAE3B;QACC,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACvB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,KAAsB;QAC7B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,MAAY;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;CACD"}

package/dist/esm/utils/Lock.js

@@ -0,0 +1,97 @@
+import { Deferred } from "./Deferred.js";
+export class LockLease {
+    lock;
+    name;
+    constructor(lock, name) {
+        this.lock = lock;
+        this.name = name;
+    }
+    release() {
+        this.lock.release(this.name);
+    }
+    [Symbol.dispose]() {
+        this.release();
+    }
+}
+export class Lock {
+    /**
+     * Indicates that global lock acquiring is started,
+     * so all other locks should wait to ensure that named lock raised after global don't squeeze before it
+     */
+    #globalLockAcquiringLock;
+    /**
+     * Indicates that global lock is acquired, all others should wait
+     */
+    #globalLock;
+    /**
+     * Hash of named locks. Each named lock block locks with same name and the global one
+     */
+    #namedLocks = new Map();
+    #getAnyBlockingLock(id) {
+        return this.#globalLock ?? (id ?
+            this.#namedLocks.get(id) :
+            this.#namedLocks.values().next().value);
+    }
+    isLocked(name) {
+        return !!this.#getAnyBlockingLock(name);
+    }
+    /**
+     * Acquire named or global lock
+     *
+     * @returns Promise that resolves once lock is acquired
+     */
+    async acquire(name) {
+        while (this.#globalLockAcquiringLock)
+            await this.#globalLockAcquiringLock.promise;
+        const isGlobal = !name;
+        if (isGlobal)
+            this.#globalLockAcquiringLock = new Deferred();
+        // the below code cannot be replaced with `await this.waitForUnlock()`
+        // since check of `isLocked` and `this.#deferred` assignment should happen within 1 callback
+        // while `async waitForUnlock(..) await..` creates one extra promise callback
+        while (this.isLocked(name))
+            await this.#getAnyBlockingLock(name)?.promise;
+        if (name)
+            this.#namedLocks.set(name, new Deferred());
+        else
+            this.#globalLock = new Deferred();
+        if (isGlobal) {
+            this.#globalLockAcquiringLock?.resolve();
+            this.#globalLockAcquiringLock = undefined;
+        }
+        return new LockLease(this, name);
+    }
+    /**
+     * @returns Promise that resolves once lock is released
+     */
+    async waitForUnlock(name) {
+        while (this.isLocked(name))
+            await this.#getAnyBlockingLock(name)?.promise;
+    }
+    /**
+     * Release named or global lock
+     */
+    release(name) {
+        if (name) {
+            this.#namedLocks.get(name)?.resolve();
+            this.#namedLocks.delete(name);
+        }
+        else {
+            this.#globalLock?.resolve();
+            this.#globalLock = undefined;
+        }
+    }
+    /**
+     * Execute callback with lock acquired, then release lock
+     */
+    async runExclusively(name, callback) {
+        try {
+            await this.acquire(name);
+            return await callback();
+        }
+        finally {
+            this.release(name);
+        }
+    }
+}
+//# sourceMappingURL=Lock.js.map

package/dist/esm/utils/Lock.js.map

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

package/dist/esm/utils/MapAssertable.js

@@ -0,0 +1,26 @@
+export class MapAssertable extends Map {
+    #usageCounter = new Map();
+    /**
+     * Ensures the key exists in the map, creating it with the factory if needed, and increments its usage counter.
+     */
+    assert(key, factory) {
+        if (!this.has(key))
+            this.set(key, factory());
+        this.#usageCounter.set(key, (this.#usageCounter.get(key) ?? 0) + 1);
+        return super.get(key);
+    }
+    /**
+     * Decrements the usage counter for the key and removes it from the map if no longer used.
+     */
+    release(key) {
+        const count = (this.#usageCounter.get(key) ?? 0) - 1;
+        if (count > 0) {
+            this.#usageCounter.set(key, count);
+        }
+        else {
+            this.#usageCounter.delete(key);
+            this.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=MapAssertable.js.map

package/dist/esm/utils/MapAssertable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapAssertable.js","sourceRoot":"","sources":["../../../src/utils/MapAssertable.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAoB,SAAQ,GAAS;IAEjD,aAAa,GAAG,IAAI,GAAG,EAAa,CAAC;IAErC;;OAEG;IACH,MAAM,CAAC,GAAM,EAAE,OAAgB;QAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAE1B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEpE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAM;QACb,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;aACI,CAAC;YACL,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACF,CAAC;CACD"}

package/dist/esm/utils/assert.js

@@ -0,0 +1,70 @@
+import { isMessage } from "../interfaces/IMessage.js";
+import { isEvent } from "../interfaces/IEvent.js";
+import { isSnapshotEvent } from "../interfaces/ISnapshotEvent.js";
+import { isObservable } from "../interfaces/IObservable.js";
+import { isClass } from "./isClass.js";
+export function assertDefined(value, argName) {
+    if (!value)
+        throw new TypeError(`${argName} is required`);
+}
+export function assertString(value, argName) {
+    if (typeof value !== 'string' || !value.length)
+        throw new TypeError(`${argName} must be a non-empty String`);
+}
+export function assertFunction(value, argName) {
+    if (typeof value !== 'function')
+        throw new TypeError(`${argName} must be a Function`);
+}
+export function assertObject(value, argName) {
+    if (typeof value !== 'object' || !value)
+        throw new TypeError(`${argName} must be an Object`);
+}
+export function assertArray(value, argName) {
+    if (!Array.isArray(value) || !value.length)
+        throw new TypeError(`${argName} must be a non-empty Array`);
+}
+export function assertStringArray(value, argName) {
+    if (!Array.isArray(value) || !value.length || value.some(item => typeof item !== 'string' || !item.length))
+        throw new TypeError(`${argName} must be a non-empty String[]`);
+}
+export function assertOptionalArray(value, argName) {
+    if (!Array.isArray(value))
+        throw new TypeError(`${argName} must be an Array`);
+}
+export function assertMessage(value, argName) {
+    if (!isMessage(value))
+        throw new TypeError(`${argName} must be a valid IMessage`);
+}
+export function assertEvent(value, argName) {
+    if (!isEvent(value))
+        throw new TypeError(`${argName} must be a valid IEvent`);
+}
+export function assertSnapshotEvent(value, argName) {
+    if (!isSnapshotEvent(value))
+        throw new TypeError(`${argName} must be a valid ISnapshotEvent`);
+}
+export function assertObservable(value, argName) {
+    if (!isObservable(value))
+        throw new TypeError(`${argName} must be an IObservable`);
+}
+export function assertNumber(value, argName) {
+    if (typeof value !== 'number')
+        throw new TypeError(`${argName} must be a Number`);
+}
+export function assertClass(value, argName) {
+    if (!isClass(value))
+        throw new TypeError(`${argName} must be a class`);
+}
+export function assertNonNegativeInteger(value, argName) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)
+        throw new TypeError(`${argName} must be a non-negative integer`);
+}
+export function assertBoolean(value, argName) {
+    if (typeof value !== 'boolean')
+        throw new TypeError(`${argName} must be a Boolean`);
+}
+export function assertNotDefined(value, argName) {
+    if (value !== undefined)
+        throw new TypeError(`${argName} must not be defined`);
+}
+//# sourceMappingURL=assert.js.map

package/dist/esm/utils/assert.js.map

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

package/dist/esm/utils/clone.js

@@ -0,0 +1,10 @@
+export function clone(value) {
+    const sc = globalThis.structuredClone;
+    if (typeof sc === 'function')
+        return sc(value);
+    const json = JSON.stringify(value);
+    if (json === undefined)
+        throw new TypeError('Object payload must be JSON-serializable');
+    return JSON.parse(json);
+}
+//# sourceMappingURL=clone.js.map

package/dist/esm/utils/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../../src/utils/clone.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAI,KAAQ;IAChC,MAAM,EAAE,GAAI,UAAkB,CAAC,eAA+C,CAAC;IAC/E,IAAI,OAAO,EAAE,KAAK,UAAU;QAC3B,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAElB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS;QACrB,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAEjE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC9B,CAAC"}

package/dist/esm/utils/extractErrorDetails.js

@@ -0,0 +1,33 @@
+const extractErrorName = (err) => {
+    if (err instanceof Error)
+        return err.name;
+    if (typeof err === 'object' && err) {
+        if ('name' in err && typeof err.name === 'string')
+            return err.name;
+        return Object.getPrototypeOf(err)?.constructor?.name;
+    }
+    return undefined;
+};
+const extractErrorMessage = (err) => {
+    if (err instanceof AggregateError && err.errors?.length)
+        return [err.message, ...err.errors.map(extractErrorMessage)].filter(m => !!m).join('; ');
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'object' && err && 'message' in err && typeof err.message === 'string')
+        return err.message;
+    return String(err);
+};
+export const extractErrorDetails = (err) => ({
+    name: extractErrorName(err),
+    message: extractErrorMessage(err),
+    ...typeof err === 'object' && err && 'code' in err && {
+        code: err.code
+    },
+    ...err instanceof Error && {
+        stack: err.stack
+    },
+    ...err instanceof Error && !!err.cause && {
+        cause: extractErrorDetails(err.cause)
+    }
+});
+//# sourceMappingURL=extractErrorDetails.js.map

package/dist/esm/utils/extractErrorDetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractErrorDetails.js","sourceRoot":"","sources":["../../../src/utils/extractErrorDetails.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,CAAC,GAAY,EAAsB,EAAE;IAC7D,IAAI,GAAG,YAAY,KAAK;QACvB,OAAO,GAAG,CAAC,IAAI,CAAC;IAEjB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,EAAE,CAAC;QACpC,IAAI,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAChD,OAAO,GAAG,CAAC,IAAI,CAAC;QAEjB,OAAO,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC;IACtD,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,GAAY,EAAU,EAAE;IACpD,IAAI,GAAG,YAAY,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM;QACtD,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1F,IAAI,GAAG,YAAY,KAAK;QACvB,OAAO,GAAG,CAAC,OAAO,CAAC;IAEpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QACxF,OAAO,GAAG,CAAC,OAAO,CAAC;IAEpB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC,CAAC;AAUF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAY,EAAgB,EAAE,CAAC,CAAC;IACnE,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC;IACjC,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI;QACrD,IAAI,EAAE,GAAG,CAAC,IAAI;KACd;IACD,GAAG,GAAG,YAAY,KAAK,IAAI;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;KAChB;IACD,GAAG,GAAG,YAAY,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI;QACzC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;KACrC;CACD,CAAC,CAAC"}

package/dist/esm/utils/getClassName.js

@@ -0,0 +1,7 @@
+/**
+ * Get instance class name
+ */
+export function getClassName(instance) {
+    return Object.getPrototypeOf(instance).constructor.name;
+}
+//# sourceMappingURL=getClassName.js.map

package/dist/esm/utils/getClassName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClassName.js","sourceRoot":"","sources":["../../../src/utils/getClassName.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC5C,OAAO,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;AACzD,CAAC"}

package/dist/esm/utils/getHandler.js

@@ -0,0 +1,15 @@
+import { assertObject, assertString } from "./assert.js";
+/**
+ * Gets a handler for a specific message type, prefers a public (w\o _ prefix) method, if available
+ */
+export function getHandler(context, messageType) {
+    assertObject(context, 'context');
+    assertString(messageType, 'messageType');
+    if (messageType in context && typeof context[messageType] === 'function')
+        return context[messageType];
+    const privateHandlerName = `_${messageType}`;
+    if (privateHandlerName in context && typeof context[privateHandlerName] === 'function')
+        return context[privateHandlerName];
+    return null;
+}
+//# sourceMappingURL=getHandler.js.map

package/dist/esm/utils/getHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHandler.js","sourceRoot":"","sources":["../../../src/utils/getHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAA+B,EAAE,WAAmB;IAC9E,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjC,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEzC,IAAI,WAAW,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,UAAU;QACvE,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7B,MAAM,kBAAkB,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7C,IAAI,kBAAkB,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,kBAAkB,CAAC,KAAK,UAAU;QACrF,OAAO,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEpC,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/esm/utils/getMessageHandlerNames.js

@@ -0,0 +1,27 @@
+function getInheritedPropertyNames(prototype) {
+    const parentPrototype = prototype && Object.getPrototypeOf(prototype);
+    if (!parentPrototype)
+        return [];
+    const propDescriptors = Object.getOwnPropertyDescriptors(parentPrototype);
+    const propNames = Object.keys(propDescriptors);
+    return [
+        ...propNames,
+        ...getInheritedPropertyNames(parentPrototype)
+    ];
+}
+export function getMessageHandlerNames(observerInstanceOrClass) {
+    if (!observerInstanceOrClass)
+        throw new TypeError('observerInstanceOrClass argument required');
+    const prototype = typeof observerInstanceOrClass === 'function' ?
+        observerInstanceOrClass.prototype :
+        Object.getPrototypeOf(observerInstanceOrClass);
+    if (!prototype)
+        throw new TypeError('prototype cannot be resolved');
+    const inheritedProperties = getInheritedPropertyNames(prototype);
+    const propDescriptors = Object.getOwnPropertyDescriptors(prototype);
+    const propNames = Object.keys(propDescriptors);
+    return propNames.filter(key => !key.startsWith('_') &&
+        !inheritedProperties.includes(key) &&
+        typeof propDescriptors[key].value === 'function');
+}
+//# sourceMappingURL=getMessageHandlerNames.js.map

package/dist/esm/utils/getMessageHandlerNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMessageHandlerNames.js","sourceRoot":"","sources":["../../../src/utils/getMessageHandlerNames.ts"],"names":[],"mappings":"AAAA,SAAS,yBAAyB,CAAC,SAAiB;IACnD,MAAM,eAAe,GAAG,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,CAAC,eAAe;QACnB,OAAO,EAAE,CAAC;IAEX,MAAM,eAAe,GAAG,MAAM,CAAC,yBAAyB,CAAC,eAAe,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE/C,OAAO;QACN,GAAG,SAAS;QACZ,GAAG,yBAAyB,CAAC,eAAe,CAAC;KAC7C,CAAC;AACH,CAAC;AAkBD,MAAM,UAAU,sBAAsB,CACrC,uBAAmD;IAEnD,IAAI,CAAC,uBAAuB;QAC3B,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;IAElE,MAAM,SAAS,GAAG,OAAO,uBAAuB,KAAK,UAAU,CAAC,CAAC;QAChE,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IAEhD,IAAI,CAAC,SAAS;QACb,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAErD,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,eAAe,GAAG,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE/C,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7B,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QACpB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC;QAClC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,UAAU,CAClB,CAAC;AACjC,CAAC"}

package/dist/esm/utils/index.js

@@ -0,0 +1,15 @@
+export * from "./assert.js";
+export * from "./clone.js";
+export * from "./Deferred.js";
+export * from "./extractErrorDetails.js";
+export * from "./getClassName.js";
+export * from "./getHandler.js";
+export * from "./getMessageHandlerNames.js";
+export * from "./isClass.js";
+export * from "./Lock.js";
+export * from "./MapAssertable.js";
+export * from "./setupOneTimeEmitterSubscription.js";
+export * from "./sagaId.js";
+export * from "./subscribe.js";
+export * from "./validateHandlers.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/esm/utils/isClass.js

@@ -0,0 +1,5 @@
+export function isClass(func) {
+    return typeof func === 'function'
+        && Function.prototype.toString.call(func).startsWith('class');
+}
+//# sourceMappingURL=isClass.js.map

package/dist/esm/utils/isClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isClass.js","sourceRoot":"","sources":["../../../src/utils/isClass.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,IAAa;IACpC,OAAO,OAAO,IAAI,KAAK,UAAU;WAC7B,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC"}

package/dist/esm/utils/sagaId.js

@@ -0,0 +1,18 @@
+import { assertString } from "./assert.js";
+export const makeSagaId = (sagaDescriptor, originEventId) => {
+    assertString(sagaDescriptor, 'sagaDescriptor');
+    assertString(originEventId, 'originEventId');
+    return `${sagaDescriptor}:${originEventId}`;
+};
+export const parseSagaId = (sagaId) => {
+    assertString(sagaId, 'sagaId');
+    // Use lastIndexOf so sagaDescriptor can contain ':' safely.
+    const separatorOffset = sagaId.lastIndexOf(':');
+    if (separatorOffset <= 0 || separatorOffset >= sagaId.length - 1)
+        throw new TypeError('sagaId argument must match "<sagaDescriptor>:<originEventId>" format');
+    return {
+        sagaDescriptor: sagaId.slice(0, separatorOffset),
+        originEventId: sagaId.slice(separatorOffset + 1)
+    };
+};
+//# sourceMappingURL=sagaId.js.map

package/dist/esm/utils/sagaId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sagaId.js","sourceRoot":"","sources":["../../../src/utils/sagaId.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,cAAsB,EAAE,aAAqB,EAAU,EAAE;IACnF,YAAY,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC/C,YAAY,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAE7C,OAAO,GAAG,cAAc,IAAI,aAAa,EAAE,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAqD,EAAE;IACpG,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE/B,4DAA4D;IAC5D,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,eAAe,IAAI,CAAC,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAC/D,MAAM,IAAI,SAAS,CAAC,sEAAsE,CAAC,CAAC;IAE7F,OAAO;QACN,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;QAChD,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;KAChD,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/utils/setupOneTimeEmitterSubscription.js

@@ -0,0 +1,42 @@
+import { assertStringArray, assertFunction, assertObservable } from "./assert.js";
+/**
+ * Create one-time eventEmitter subscription for one or multiple events that match a filter
+ *
+ * @param {IObservable} emitter
+ * @param {string[]} messageTypes Array of event type to subscribe to
+ * @param {function(IEvent):any} [handler] Optional handler to execute for a first event received
+ * @param {function(IEvent):boolean} [filter] Optional filter to apply before executing a handler
+ * @param {ILogger} logger
+ * @return {Promise<IEvent>} Resolves to first event that passes filter
+ */
+export function setupOneTimeEmitterSubscription(emitter, messageTypes, filter, handler, logger) {
+    assertObservable(emitter, 'emitter');
+    assertStringArray(messageTypes, 'messageTypes');
+    if (handler)
+        assertFunction(handler, 'handler');
+    if (filter)
+        assertFunction(filter, 'filter');
+    return new Promise(resolve => {
+        // handler will be invoked only once,
+        // even if multiple events have been emitted before subscription was destroyed
+        // https://nodejs.org/api/events.html#events_emitter_removelistener_eventname_listener
+        let handled = false;
+        function filteredHandler(event) {
+            if (filter && !filter(event))
+                return;
+            if (handled)
+                return;
+            handled = true;
+            for (const messageType of messageTypes)
+                emitter.off(messageType, filteredHandler);
+            logger?.debug(`'${event.type}' received, one-time subscription to '${messageTypes.join(',')}' removed`);
+            if (handler)
+                handler(event);
+            resolve(event);
+        }
+        for (const messageType of messageTypes)
+            emitter.on(messageType, filteredHandler);
+        logger?.debug(`set up one-time ${filter ? 'filtered subscription' : 'subscription'} to '${messageTypes.join(',')}'`);
+    });
+}
+//# sourceMappingURL=setupOneTimeEmitterSubscription.js.map

package/dist/esm/utils/setupOneTimeEmitterSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupOneTimeEmitterSubscription.js","sourceRoot":"","sources":["../../../src/utils/setupOneTimeEmitterSubscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B,CAC9C,OAAoB,EACpB,YAAsB,EACtB,MAA+B,EAC/B,OAA6B,EAC7B,MAAgB;IAEhB,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACrC,iBAAiB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAChD,IAAI,OAAO;QACV,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpC,IAAI,MAAM;QACT,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAElC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAE5B,qCAAqC;QACrC,8EAA8E;QAC9E,sFAAsF;QACtF,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,SAAS,eAAe,CAAC,KAAa;YACrC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC3B,OAAO;YACR,IAAI,OAAO;gBACV,OAAO;YACR,OAAO,GAAG,IAAI,CAAC;YAEf,KAAK,MAAM,WAAW,IAAI,YAAY;gBACrC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAE3C,MAAM,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,yCAAyC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAExG,IAAI,OAAO;gBACV,OAAO,CAAC,KAAK,CAAC,CAAC;YAEhB,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QAED,KAAK,MAAM,WAAW,IAAI,YAAY;YACrC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAE1C,MAAM,EAAE,KAAK,CAAC,mBAAmB,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,cAAc,QAAQ,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/utils/subscribe.js

@@ -0,0 +1,40 @@
+import { isObservableQueueProvider } from "../interfaces/index.js";
+import { assertStringArray, assertDefined, assertFunction, assertObject, assertObservable } from "./assert.js";
+import { getHandler } from "./getHandler.js";
+import { getMessageHandlerNames } from "./getMessageHandlerNames.js";
+const unique = (arr) => [...new Set(arr)];
+/**
+ * Get a list of message types handled by observer
+ */
+function getHandledMessageTypes(observerInstanceOrClass) {
+    assertDefined(observerInstanceOrClass, 'observerInstanceOrClass');
+    const prototype = Object.getPrototypeOf(observerInstanceOrClass);
+    if (prototype && prototype.constructor && prototype.constructor.handles)
+        return prototype.constructor.handles;
+    return getMessageHandlerNames(observerInstanceOrClass);
+}
+/**
+ * Subscribe observer to observable
+ */
+export function subscribe(observable, observer, options = {}) {
+    assertObservable(observable, 'observable');
+    assertObject(observer, 'observer');
+    const { masterHandler, messageTypes, queueName } = options;
+    if (masterHandler)
+        assertFunction(masterHandler, 'masterHandler');
+    const subscribeTo = messageTypes || getHandledMessageTypes(observer);
+    assertStringArray(subscribeTo, 'either options.messageTypes, observer.handles or ObserverType.handles');
+    for (const messageType of unique(subscribeTo)) {
+        const handler = masterHandler || getHandler(observer, messageType);
+        assertFunction(handler, `'${messageType}' handler`);
+        if (queueName) {
+            if (!isObservableQueueProvider(observable))
+                throw new TypeError('Observer does not support named queues');
+            observable.queue(queueName).on(messageType, (event, meta) => handler.call(observer, event, meta));
+        }
+        else {
+            observable.on(messageType, (event, meta) => handler.call(observer, event, meta));
+        }
+    }
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/esm/utils/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../../src/utils/subscribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,MAAM,GAAG,CAAI,GAAQ,EAAO,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAEvD;;GAEG;AACH,SAAS,sBAAsB,CAAC,uBAA4C;IAC3E,aAAa,CAAC,uBAAuB,EAAE,yBAAyB,CAAC,CAAC;IAElE,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IACjE,IAAI,SAAS,IAAI,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW,CAAC,OAAO;QACtE,OAAO,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC;IAEtC,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACxB,UAAuB,EACvB,QAAgB,EAChB,UAII,EAAE;IAEN,gBAAgB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC3C,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEnC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC3D,IAAI,aAAa;QAChB,cAAc,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAEhD,MAAM,WAAW,GAAG,YAAY,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACrE,iBAAiB,CAAC,WAAW,EAAE,uEAAuE,CAAC,CAAC;IAExG,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,aAAa,IAAI,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACnE,cAAc,CAAC,OAAO,EAAE,IAAI,WAAW,WAAW,CAAC,CAAC;QAEpD,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC;gBACzC,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;YAE/D,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACnG,CAAC;aACI,CAAC;YACL,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAClF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/esm/utils/validateHandlers.js

@@ -0,0 +1,18 @@
+import { assertObject, assertOptionalArray, assertString } from "./assert.js";
+import { getHandler } from "./getHandler.js";
+/**
+ * Ensure instance has handlers declared for all handled message types
+ */
+export function validateHandlers(instance, handlesFieldName = 'handles') {
+    assertObject(instance, 'instance');
+    const messageTypes = Object.getPrototypeOf(instance).constructor[handlesFieldName];
+    if (messageTypes === undefined)
+        return;
+    assertOptionalArray(messageTypes, handlesFieldName);
+    for (const type of messageTypes) {
+        assertString(type, 'type');
+        if (!getHandler(instance, type))
+            throw new Error(`'${type}' handler is not defined or not a function`);
+    }
+}
+//# sourceMappingURL=validateHandlers.js.map

package/dist/esm/utils/validateHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateHandlers.js","sourceRoot":"","sources":["../../../src/utils/validateHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,gBAAgB,GAAG,SAAS;IAC9E,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEnC,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IACnF,IAAI,YAAY,KAAK,SAAS;QAC7B,OAAO;IAER,mBAAmB,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAEpD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QACjC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE3B,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,4CAA4C,CAAC,CAAC;IACxE,CAAC;AACF,CAAC"}

package/dist/esm/workers/AbstractWorkerProjection.js

@@ -0,0 +1,52 @@
+import { isMainThread } from 'node:worker_threads';
+import { AbstractProjection } from "../AbstractProjection.js";
+import { workerProxyFactory as createWorkerProxyFactory, createWorkerInstance as createWorkerProjectionInstance } from "./utils/index.js";
+/**
+ * Projection base class that can run projection handlers and the associated view in a worker thread
+ * to isolate CPU-heavy work and keep the main thread responsive
+ */
+export class AbstractWorkerProjection extends AbstractProjection {
+    /**
+     * In a worker thread, creates and exposes the projection singleton.
+     */
+    static createInstanceInWorkerThread(factory) {
+        if (isMainThread)
+            return undefined;
+        const projectionMethodsToWire = [
+            'project',
+            '_project',
+            'ping',
+            'getLastProjectedEvent'
+        ];
+        if (factory)
+            return createWorkerProjectionInstance(factory, projectionMethodsToWire);
+        return createWorkerProjectionInstance(this, projectionMethodsToWire);
+    }
+    /**
+     * Creates a factory that returns a `WorkerProxyProjection` for this projection type.
+     * Use it in the main thread (for example, `builder.registerProjection(MyProjection.workerProxyFactory)`),
+     * so events are proxied to the worker instance while exposing the remote view API.
+     */
+    static workerProxyFactory(container) {
+        return createWorkerProxyFactory(this)(container);
+    }
+    static get workerModulePath() {
+        throw new Error('not implemented');
+    }
+    /** @internal Responds to a ping from the main thread to confirm the worker is alive */
+    // eslint-disable-next-line class-methods-use-this
+    ping() {
+        return true;
+    }
+    /** @internal Expose protected projection path for worker RPC wiring */
+    _project(event) {
+        return super._project(event);
+    }
+    /**
+     * Returns the last projected event if the view implements IEventLocker, otherwise undefined.
+     */
+    async getLastProjectedEvent() {
+        return this._eventLocker?.getLastEvent();
+    }
+}
+//# sourceMappingURL=AbstractWorkerProjection.js.map

package/dist/esm/workers/AbstractWorkerProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractWorkerProjection.js","sourceRoot":"","sources":["../../../src/workers/AbstractWorkerProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACN,kBAAkB,IAAI,wBAAwB,EAC9C,oBAAoB,IAAI,8BAA8B,EAEtD,MAAM,kBAAkB,CAAC;AAI1B;;;GAGG;AACH,MAAM,OAAgB,wBACrB,SAAQ,kBAAyB;IAGjC;;OAEG;IACH,MAAM,CAAC,4BAA4B,CAElC,OAAiB;QAEjB,IAAI,YAAY;YACf,OAAO,SAAS,CAAC;QAElB,MAAM,uBAAuB,GAAG;YAC/B,SAAS;YACT,UAAU;YACV,MAAM;YACN,uBAAuB;SACO,CAAC;QAEhC,IAAI,OAAO;YACV,OAAO,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QAEzE,OAAO,8BAA8B,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAI0B,SAAsB;QACxE,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,KAAK,gBAAgB;QAC1B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACpC,CAAC;IAED,uFAAuF;IACvF,kDAAkD;IAC3C,IAAI;QACV,OAAO,IAAI,CAAC;IACb,CAAC;IAED,uEAAuE;IACvD,QAAQ,CAAC,KAAa;QACrC,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,qBAAqB;QACjC,OAAO,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC;IAC1C,CAAC;CACD"}