From 34836c899c791bf9540e4719c26bec4b8ba9d81e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 1 Oct 2024 20:27:09 +0100 Subject: [PATCH 001/169] WIP on SQLite infrastructure --- examples/user-domain-tests/index.test.js | 2 +- package-lock.json | 1445 ++++++++++++++--- package.json | 16 +- src/AbstractAggregate.ts | 5 +- src/AbstractProjection.ts | 64 +- src/AbstractSaga.ts | 8 +- src/AggregateCommandHandler.ts | 3 +- src/CqrsContainerBuilder.ts | 2 +- src/EventStore.ts | 19 +- src/index.ts | 12 +- .../{ => memory}/InMemoryEventStorage.ts | 35 +- .../{ => memory}/InMemoryLock.ts | 25 +- .../{ => memory}/InMemoryMessageBus.ts | 2 +- .../{ => memory}/InMemorySnapshotStorage.ts | 7 +- .../{ => memory}/InMemoryView.ts | 27 +- src/infrastructure/memory/index.ts | 5 + .../{ => memory}/utils/Deferred.ts | 0 .../{ => memory}/utils/index.ts | 0 .../{ => memory}/utils/nextCycle.ts | 0 .../sqlite/AbstractSqliteView.ts | 202 +++ src/infrastructure/sqlite/ObjectSqliteView.ts | 124 ++ src/infrastructure/sqlite/index.ts | 2 + src/interfaces.ts | 328 ---- src/interfaces/IAggregate.ts | 55 + src/interfaces/IAggregateSnapshotStorage.ts | 7 + src/interfaces/ICommand.ts | 3 + src/interfaces/ICommandBus.ts | 18 + src/interfaces/IEvent.ts | 6 + src/interfaces/IEventReceptor.ts | 6 + src/interfaces/IEventSet.ts | 6 + src/interfaces/IEventStorage.ts | 31 + src/interfaces/IEventStore.ts | 27 + src/interfaces/IEventStream.ts | 3 + src/interfaces/ILogger.ts | 11 + src/interfaces/IMessage.ts | 13 + src/interfaces/IMessageBus.ts | 8 + src/interfaces/IObjectView.ts | 11 + src/interfaces/IObservable.ts | 11 + src/interfaces/IObserver.ts | 5 + src/interfaces/IPersistentView.ts | 24 + src/interfaces/IProjection.ts | 20 + src/interfaces/IProjectionView.ts | 22 + src/interfaces/ISaga.ts | 36 + src/interfaces/index.ts | 20 + tests/integration/SqliteView.test.ts | 134 ++ tests/unit/AbstractProjection.test.ts | 19 +- tests/unit/CommandBus.test.ts | 3 +- tests/unit/EventStore.test.ts | 8 +- tests/unit/InMemoryView.test.ts | 4 +- 49 files changed, 2152 insertions(+), 692 deletions(-) rename src/infrastructure/{ => memory}/InMemoryEventStorage.ts (59%) rename src/infrastructure/{ => memory}/InMemoryLock.ts (61%) rename src/infrastructure/{ => memory}/InMemoryMessageBus.ts (99%) rename src/infrastructure/{ => memory}/InMemorySnapshotStorage.ts (66%) rename src/infrastructure/{ => memory}/InMemoryView.ts (85%) create mode 100644 src/infrastructure/memory/index.ts rename src/infrastructure/{ => memory}/utils/Deferred.ts (100%) rename src/infrastructure/{ => memory}/utils/index.ts (100%) rename src/infrastructure/{ => memory}/utils/nextCycle.ts (100%) create mode 100644 src/infrastructure/sqlite/AbstractSqliteView.ts create mode 100644 src/infrastructure/sqlite/ObjectSqliteView.ts create mode 100644 src/infrastructure/sqlite/index.ts delete mode 100644 src/interfaces.ts create mode 100644 src/interfaces/IAggregate.ts create mode 100644 src/interfaces/IAggregateSnapshotStorage.ts create mode 100644 src/interfaces/ICommand.ts create mode 100644 src/interfaces/ICommandBus.ts create mode 100644 src/interfaces/IEvent.ts create mode 100644 src/interfaces/IEventReceptor.ts create mode 100644 src/interfaces/IEventSet.ts create mode 100644 src/interfaces/IEventStorage.ts create mode 100644 src/interfaces/IEventStore.ts create mode 100644 src/interfaces/IEventStream.ts create mode 100644 src/interfaces/ILogger.ts create mode 100644 src/interfaces/IMessage.ts create mode 100644 src/interfaces/IMessageBus.ts create mode 100644 src/interfaces/IObjectView.ts create mode 100644 src/interfaces/IObservable.ts create mode 100644 src/interfaces/IObserver.ts create mode 100644 src/interfaces/IPersistentView.ts create mode 100644 src/interfaces/IProjection.ts create mode 100644 src/interfaces/IProjectionView.ts create mode 100644 src/interfaces/ISaga.ts create mode 100644 src/interfaces/index.ts create mode 100644 tests/integration/SqliteView.test.ts diff --git a/examples/user-domain-tests/index.test.js b/examples/user-domain-tests/index.test.js index 4dcb988..6d9bb19 100644 --- a/examples/user-domain-tests/index.test.js +++ b/examples/user-domain-tests/index.test.js @@ -2,7 +2,7 @@ const { expect } = require('chai'); const { createContainer, createBaseInstances } = require('../user-domain'); -const { nextCycle } = require('../../src/infrastructure/utils'); +const { nextCycle } = require('../../src/infrastructure/memory/utils'); describe('user-domain example', () => { diff --git a/package-lock.json b/package-lock.json index 1a03e5f..510d5fd 100644 --- a/package-lock.json +++ b/package-lock.json @@ -12,21 +12,27 @@ "di0": "^1.0.0" }, "devDependencies": { - "@types/chai": "^4.3.17", - "@types/jest": "^29.5.12", - "@types/node": "^20.14.14", + "@types/better-sqlite3": "^7.6.11", + "@types/chai": "^4.3.20", + "@types/jest": "^29.5.13", + "@types/node": "^20.16.9", "@types/sinon": "^10.0.20", + "@types/uuid": "^10.0.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "coveralls": "^3.1.1", "jest": "^29.7.0", "sinon": "^15.2.0", - "ts-jest": "^29.2.4", + "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.5.4" + "typescript": "^5.6.2", + "uuid": "^10.0.0" }, "engines": { "node": ">=10.3.0" + }, + "peerDependencies": { + "better-sqlite3": "^11.3.0" } }, "node_modules/@ampproject/remapping": { @@ -34,6 +40,7 @@ "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==", "dev": true, + "license": "Apache-2.0", "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" @@ -47,6 +54,7 @@ "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.24.7.tgz", "integrity": "sha512-BcYH1CVJBO9tvyIZ2jVeXgSIMvGZ2FDRvDdOIVQyuklNKSsx+eppDEBq/g47Ayw+RqNFE+URvOShmf+f/qwAlA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/highlight": "^7.24.7", "picocolors": "^1.0.0" @@ -56,10 +64,11 @@ } }, "node_modules/@babel/compat-data": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.25.2.tgz", - "integrity": "sha512-bYcppcpKBvX4znYaPEeFau03bp89ShqNMLs+rmdptMw+heSZh9+z84d2YG+K7cYLbWwzdjtDoW/uqZmPjulClQ==", + "version": "7.25.4", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.25.4.tgz", + "integrity": "sha512-+LGRog6RAsCJrrrg/IO6LGmpphNe5DiK30dGjCoxxeGv49B10/3XYGxPsAwrDlMFcFEvdAUavDT8r9k/hSyQqQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -69,6 +78,7 @@ "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.25.2.tgz", "integrity": "sha512-BBt3opiCOxUr9euZ5/ro/Xv8/V7yJ5bjYMqG/C1YAo8MIKAnumZalCN+msbci3Pigy4lIQfPUpfMM27HMGaYEA==", "dev": true, + "license": "MIT", "dependencies": { "@ampproject/remapping": "^2.2.0", "@babel/code-frame": "^7.24.7", @@ -95,12 +105,13 @@ } }, "node_modules/@babel/generator": { - "version": "7.25.0", - "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.25.0.tgz", - "integrity": "sha512-3LEEcj3PVW8pW2R1SR1M89g/qrYk/m/mB/tLqn7dn4sbBUQyTqnlod+II2U4dqiGtUmkcnAmkMDralTFZttRiw==", + "version": "7.25.6", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.25.6.tgz", + "integrity": "sha512-VPC82gr1seXOpkjAAKoLhP50vx4vGNlF4msF64dSFq1P8RfB+QAuJWGHPXXPc8QyfVWwwB/TNNU4+ayZmHNbZw==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/types": "^7.25.0", + "@babel/types": "^7.25.6", "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.25", "jsesc": "^2.5.1" @@ -114,6 +125,7 @@ "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.25.2.tgz", "integrity": "sha512-U2U5LsSaZ7TAt3cfaymQ8WHh0pxvdHoEk6HVpaexxixjyEquMh0L0YNJNM6CTGKMXV1iksi0iZkGw4AcFkPaaw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/compat-data": "^7.25.2", "@babel/helper-validator-option": "^7.24.8", @@ -130,6 +142,7 @@ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", "dev": true, + "license": "ISC", "dependencies": { "yallist": "^3.0.2" } @@ -138,13 +151,15 @@ "version": "3.1.1", "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/@babel/helper-module-imports": { "version": "7.24.7", "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.24.7.tgz", "integrity": "sha512-8AyH3C+74cgCVVXow/myrynrAGv+nTVg5vKu2nZph9x7RcRwzmh0VFallJuFTZ9mx6u4eSdXZfcOzSqTUm0HCA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/traverse": "^7.24.7", "@babel/types": "^7.24.7" @@ -158,6 +173,7 @@ "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.25.2.tgz", "integrity": "sha512-BjyRAbix6j/wv83ftcVJmBt72QtHI56C7JXZoG2xATiLpmoC7dpd8WnkikExHDVPpi/3qCmO6WY1EaXOluiecQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-module-imports": "^7.24.7", "@babel/helper-simple-access": "^7.24.7", @@ -176,6 +192,7 @@ "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.24.8.tgz", "integrity": "sha512-FFWx5142D8h2Mgr/iPVGH5G7w6jDn4jUSpZTyDnQO0Yn7Ks2Kuz6Pci8H6MPCoUJegd/UZQ3tAvfLCxQSnWWwg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -185,6 +202,7 @@ "resolved": "https://registry.npmjs.org/@babel/helper-simple-access/-/helper-simple-access-7.24.7.tgz", "integrity": "sha512-zBAIvbCMh5Ts+b86r/CjU+4XGYIs+R1j951gxI3KmmxBMhCg4oQMsv6ZXQ64XOm/cvzfU1FmoCyt6+owc5QMYg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/traverse": "^7.24.7", "@babel/types": "^7.24.7" @@ -198,6 +216,7 @@ "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.24.8.tgz", "integrity": "sha512-pO9KhhRcuUyGnJWwyEgnRJTSIZHiT+vMD0kPeD+so0l7mxkMT19g3pjY9GTnHySck/hDzq+dtW/4VgnMkippsQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -207,6 +226,7 @@ "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.24.7.tgz", "integrity": "sha512-rR+PBcQ1SMQDDyF6X0wxtG8QyLCgUB0eRAGguqRLfkCA87l7yAP7ehq8SNj96OOGTO8OBV70KhuFYcIkHXOg0w==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -216,18 +236,20 @@ "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.24.8.tgz", "integrity": "sha512-xb8t9tD1MHLungh/AIoWYN+gVHaB9kwlu8gffXGSt3FFEIT7RjS+xWbc2vUD1UTZdIpKj/ab3rdqJ7ufngyi2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/helpers": { - "version": "7.25.0", - "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.25.0.tgz", - "integrity": "sha512-MjgLZ42aCm0oGjJj8CtSM3DB8NOOf8h2l7DCTePJs29u+v7yO/RBX9nShlKMgFnRks/Q4tBAe7Hxnov9VkGwLw==", + "version": "7.25.6", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.25.6.tgz", + "integrity": "sha512-Xg0tn4HcfTijTwfDwYlvVCl43V6h4KyVVX2aEm4qdO/PC6L2YvzLHFdmxhoeSA3eslcE6+ZVXHgWwopXYLNq4Q==", "dev": true, + "license": "MIT", "dependencies": { "@babel/template": "^7.25.0", - "@babel/types": "^7.25.0" + "@babel/types": "^7.25.6" }, "engines": { "node": ">=6.9.0" @@ -238,6 +260,7 @@ "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.24.7.tgz", "integrity": "sha512-EStJpq4OuY8xYfhGVXngigBJRWxftKX9ksiGDnmlY3o7B/V7KIAc9X4oiK87uPJSc/vs5L869bem5fhZa8caZw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-validator-identifier": "^7.24.7", "chalk": "^2.4.2", @@ -253,6 +276,7 @@ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", "dev": true, + "license": "MIT", "dependencies": { "color-convert": "^1.9.0" }, @@ -265,6 +289,7 @@ "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^3.2.1", "escape-string-regexp": "^1.0.5", @@ -279,6 +304,7 @@ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", "dev": true, + "license": "MIT", "dependencies": { "color-name": "1.1.3" } @@ -287,13 +313,15 @@ "version": "1.1.3", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@babel/highlight/node_modules/escape-string-regexp": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.8.0" } @@ -303,6 +331,7 @@ "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -312,6 +341,7 @@ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", "dev": true, + "license": "MIT", "dependencies": { "has-flag": "^3.0.0" }, @@ -320,12 +350,13 @@ } }, "node_modules/@babel/parser": { - "version": "7.25.3", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.25.3.tgz", - "integrity": "sha512-iLTJKDbJ4hMvFPgQwwsVoxtHyWpKKPBrxkANrSYewDPaPpT5py5yeVkgPIJ7XYXhndxJpaA3PyALSXQ7u8e/Dw==", + "version": "7.25.6", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.25.6.tgz", + "integrity": "sha512-trGdfBdbD0l1ZPmcJ83eNxB9rbEax4ALFTF7fN386TMYbeCQbyme5cOEXQhbGXKebwGaB/J52w1mrklMcbgy6Q==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/types": "^7.25.2" + "@babel/types": "^7.25.6" }, "bin": { "parser": "bin/babel-parser.js" @@ -339,6 +370,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz", "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -351,6 +383,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz", "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -363,6 +396,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz", "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.12.13" }, @@ -370,11 +404,44 @@ "@babel/core": "^7.0.0-0" } }, + "node_modules/@babel/plugin-syntax-class-static-block": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz", + "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-attributes": { + "version": "7.25.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.25.6.tgz", + "integrity": "sha512-sXaDXaJN9SNLymBdlWFA+bjzBhFD617ZaFiY13dGt7TVslVvVgA6fkZOP7Ki3IGElC45lwHdOTrCtKZGVAWeLQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.24.8" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, "node_modules/@babel/plugin-syntax-import-meta": { "version": "7.10.4", "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz", "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, @@ -387,6 +454,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz", "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -399,6 +467,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.24.7.tgz", "integrity": "sha512-6ddciUPe/mpMnOKv/U+RSd2vvVy+Yw/JfBB0ZHYjEZt9NLHmCUylNYlsbqCCS1Bffjlb0fCwC9Vqz+sBz6PsiQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.24.7" }, @@ -414,6 +483,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz", "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, @@ -426,6 +496,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz", "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -438,6 +509,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz", "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, @@ -450,6 +522,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz", "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -462,6 +535,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz", "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -474,6 +548,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz", "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -481,11 +556,28 @@ "@babel/core": "^7.0.0-0" } }, + "node_modules/@babel/plugin-syntax-private-property-in-object": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz", + "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, "node_modules/@babel/plugin-syntax-top-level-await": { "version": "7.14.5", "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz", "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.14.5" }, @@ -497,12 +589,13 @@ } }, "node_modules/@babel/plugin-syntax-typescript": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.24.7.tgz", - "integrity": "sha512-c/+fVeJBB0FeKsFvwytYiUD+LBvhHjGSI0g446PRGdSVGZLRNArBUno2PETbAly3tpiNAQR5XaZ+JslxkotsbA==", + "version": "7.25.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.25.4.tgz", + "integrity": "sha512-uMOCoHVU52BsSWxPOMVv5qKRdeSlPuImUCB2dlPuBSU+W2/ROE7/Zg8F2Kepbk+8yBa68LlRKxO+xgEVWorsDg==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.24.7" + "@babel/helper-plugin-utils": "^7.24.8" }, "engines": { "node": ">=6.9.0" @@ -516,6 +609,7 @@ "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.25.0.tgz", "integrity": "sha512-aOOgh1/5XzKvg1jvVz7AVrx2piJ2XBi227DHmbY6y+bM9H2FlN+IfecYu4Xl0cNiiVejlsCri89LUsbj8vJD9Q==", "dev": true, + "license": "MIT", "dependencies": { "@babel/code-frame": "^7.24.7", "@babel/parser": "^7.25.0", @@ -526,16 +620,17 @@ } }, "node_modules/@babel/traverse": { - "version": "7.25.3", - "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.25.3.tgz", - "integrity": "sha512-HefgyP1x754oGCsKmV5reSmtV7IXj/kpaE1XYY+D9G5PvKKoFfSbiS4M77MdjuwlZKDIKFCffq9rPU+H/s3ZdQ==", + "version": "7.25.6", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.25.6.tgz", + "integrity": "sha512-9Vrcx5ZW6UwK5tvqsj0nGpp/XzqthkT0dqIc9g1AdtygFToNtTF67XzYS//dm+SAK9cp3B9R4ZO/46p63SCjlQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/code-frame": "^7.24.7", - "@babel/generator": "^7.25.0", - "@babel/parser": "^7.25.3", + "@babel/generator": "^7.25.6", + "@babel/parser": "^7.25.6", "@babel/template": "^7.25.0", - "@babel/types": "^7.25.2", + "@babel/types": "^7.25.6", "debug": "^4.3.1", "globals": "^11.1.0" }, @@ -544,10 +639,11 @@ } }, "node_modules/@babel/types": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.25.2.tgz", - "integrity": "sha512-YTnYtra7W9e6/oAZEHj0bJehPRUlLH9/fbpT5LfB0NhQXyALCRkRs3zH9v07IYhkgpqX6Z78FnuccZr/l4Fs4Q==", + "version": "7.25.6", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.25.6.tgz", + "integrity": "sha512-/l42B1qxpG6RdfYf343Uw1vmDjeNhneUXtzhojE7pDgfpEypmRhI6j1kr17XCVv4Cgl9HdAiQY2x0GwKm7rWCw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-string-parser": "^7.24.8", "@babel/helper-validator-identifier": "^7.24.7", @@ -561,13 +657,15 @@ "version": "0.2.3", "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz", "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@cspotcode/source-map-support": { "version": "0.8.1", "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz", "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/trace-mapping": "0.3.9" }, @@ -580,6 +678,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz", "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/resolve-uri": "^3.0.3", "@jridgewell/sourcemap-codec": "^1.4.10" @@ -590,6 +689,7 @@ "resolved": "https://registry.npmjs.org/@hutson/parse-repository-url/-/parse-repository-url-3.0.2.tgz", "integrity": "sha512-H9XAx3hc0BQHY6l+IFSWHDySypcXsvsuLhgYLUGywmJ5pswRVQJUHpOsobnLYp2ZUaUlKiKDrgWWhosOwAEM8Q==", "dev": true, + "license": "Apache-2.0", "engines": { "node": ">=6.9.0" } @@ -599,6 +699,7 @@ "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz", "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==", "dev": true, + "license": "ISC", "dependencies": { "camelcase": "^5.3.1", "find-up": "^4.1.0", @@ -615,6 +716,7 @@ "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz", "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -624,6 +726,7 @@ "resolved": "https://registry.npmjs.org/@jest/console/-/console-29.7.0.tgz", "integrity": "sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/node": "*", @@ -641,6 +744,7 @@ "resolved": "https://registry.npmjs.org/@jest/core/-/core-29.7.0.tgz", "integrity": "sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/console": "^29.7.0", "@jest/reporters": "^29.7.0", @@ -688,6 +792,7 @@ "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-29.7.0.tgz", "integrity": "sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/fake-timers": "^29.7.0", "@jest/types": "^29.6.3", @@ -703,6 +808,7 @@ "resolved": "https://registry.npmjs.org/@jest/expect/-/expect-29.7.0.tgz", "integrity": "sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==", "dev": true, + "license": "MIT", "dependencies": { "expect": "^29.7.0", "jest-snapshot": "^29.7.0" @@ -716,6 +822,7 @@ "resolved": "https://registry.npmjs.org/@jest/expect-utils/-/expect-utils-29.7.0.tgz", "integrity": "sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==", "dev": true, + "license": "MIT", "dependencies": { "jest-get-type": "^29.6.3" }, @@ -728,6 +835,7 @@ "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-29.7.0.tgz", "integrity": "sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@sinonjs/fake-timers": "^10.0.2", @@ -745,6 +853,7 @@ "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-29.7.0.tgz", "integrity": "sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/expect": "^29.7.0", @@ -760,6 +869,7 @@ "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-29.7.0.tgz", "integrity": "sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==", "dev": true, + "license": "MIT", "dependencies": { "@bcoe/v8-coverage": "^0.2.3", "@jest/console": "^29.7.0", @@ -803,6 +913,7 @@ "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", "dev": true, + "license": "MIT", "dependencies": { "@sinclair/typebox": "^0.27.8" }, @@ -815,6 +926,7 @@ "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-29.6.3.tgz", "integrity": "sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/trace-mapping": "^0.3.18", "callsites": "^3.0.0", @@ -829,6 +941,7 @@ "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-29.7.0.tgz", "integrity": "sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==", "dev": true, + "license": "MIT", "dependencies": { "@jest/console": "^29.7.0", "@jest/types": "^29.6.3", @@ -844,6 +957,7 @@ "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz", "integrity": "sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/test-result": "^29.7.0", "graceful-fs": "^4.2.9", @@ -859,6 +973,7 @@ "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-29.7.0.tgz", "integrity": "sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/core": "^7.11.6", "@jest/types": "^29.6.3", @@ -885,6 +1000,7 @@ "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz", "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/schemas": "^29.6.3", "@types/istanbul-lib-coverage": "^2.0.0", @@ -902,6 +1018,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz", "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/set-array": "^1.2.1", "@jridgewell/sourcemap-codec": "^1.4.10", @@ -916,6 +1033,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.0.0" } @@ -925,6 +1043,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz", "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.0.0" } @@ -933,13 +1052,15 @@ "version": "1.5.0", "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz", "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@jridgewell/trace-mapping": { "version": "0.3.25", "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz", "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" @@ -949,13 +1070,15 @@ "version": "0.27.8", "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@sinonjs/commons": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-3.0.1.tgz", "integrity": "sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "type-detect": "4.0.8" } @@ -965,6 +1088,7 @@ "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -974,74 +1098,64 @@ "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-10.3.0.tgz", "integrity": "sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@sinonjs/commons": "^3.0.0" } }, "node_modules/@sinonjs/samsam": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-8.0.0.tgz", - "integrity": "sha512-Bp8KUVlLp8ibJZrnvq2foVhP0IVX2CIprMJPK0vqGqgrDa0OHVKeZyBykqskkrdxV6yKBPmGasO8LVjAKR3Gew==", + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-8.0.2.tgz", + "integrity": "sha512-v46t/fwnhejRSFTGqbpn9u+LQ9xJDse10gNnPgAcxgdoCDMXj/G2asWAC/8Qs+BAZDicX+MNZouXT1A7c83kVw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^2.0.0", + "@sinonjs/commons": "^3.0.1", "lodash.get": "^4.4.2", - "type-detect": "^4.0.8" - } - }, - "node_modules/@sinonjs/samsam/node_modules/@sinonjs/commons": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-2.0.0.tgz", - "integrity": "sha512-uLa0j859mMrg2slwQYdO/AkrOfmH+X6LTVmNTS9CqexuE2IvVORIkSpJLqePAbEnKJ77aMmCwr1NUZ57120Xcg==", - "dev": true, - "dependencies": { - "type-detect": "4.0.8" - } - }, - "node_modules/@sinonjs/samsam/node_modules/type-detect": { - "version": "4.0.8", - "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", - "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", - "dev": true, - "engines": { - "node": ">=4" + "type-detect": "^4.1.0" } }, "node_modules/@sinonjs/text-encoding": { - "version": "0.7.2", - "resolved": "https://registry.npmjs.org/@sinonjs/text-encoding/-/text-encoding-0.7.2.tgz", - "integrity": "sha512-sXXKG+uL9IrKqViTtao2Ws6dy0znu9sOaP1di/jKGW1M6VssO8vlpXCQcpZ+jisQ1tTFAC5Jo/EOzFbggBagFQ==", - "dev": true + "version": "0.7.3", + "resolved": "https://registry.npmjs.org/@sinonjs/text-encoding/-/text-encoding-0.7.3.tgz", + "integrity": "sha512-DE427ROAphMQzU4ENbliGYrBSYPXF+TtLg9S8vzeA+OF4ZKzoDdzfL8sxuMUGS/lgRhM6j1URSk9ghf7Xo1tyA==", + "dev": true, + "license": "(Unlicense OR Apache-2.0)" }, "node_modules/@tsconfig/node10": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz", "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@tsconfig/node12": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz", "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@tsconfig/node14": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz", "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@tsconfig/node16": { "version": "1.0.4", "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz", "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/babel__core": { "version": "7.20.5", "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/parser": "^7.20.7", "@babel/types": "^7.20.7", @@ -1055,6 +1169,7 @@ "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.8.tgz", "integrity": "sha512-ASsj+tpEDsEiFr1arWrlN6V3mdfjRMZt6LtK/Vp/kreFLnr5QH5+DhvD5nINYZXzwJvXeGq+05iUXcAzVrqWtw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/types": "^7.0.0" } @@ -1064,6 +1179,7 @@ "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", "dev": true, + "license": "MIT", "dependencies": { "@babel/parser": "^7.1.0", "@babel/types": "^7.0.0" @@ -1074,21 +1190,34 @@ "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.20.6.tgz", "integrity": "sha512-r1bzfrm0tomOI8g1SzvCaQHo6Lcv6zu0EA+W2kHrt8dyrHQxGzBBL4kdkzIS+jBMV+EYcMAEAqXqYaLJq5rOZg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/types": "^7.20.7" } }, + "node_modules/@types/better-sqlite3": { + "version": "7.6.11", + "resolved": "https://registry.npmjs.org/@types/better-sqlite3/-/better-sqlite3-7.6.11.tgz", + "integrity": "sha512-i8KcD3PgGtGBLl3+mMYA8PdKkButvPyARxA7IQAd6qeslht13qxb1zzO8dRCtE7U3IoJS782zDBAeoKiM695kg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, "node_modules/@types/chai": { - "version": "4.3.17", - "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.17.tgz", - "integrity": "sha512-zmZ21EWzR71B4Sscphjief5djsLre50M6lI622OSySTmn9DB3j+C3kWroHfBQWXbOBwbgg/M8CG/hUxDLIloow==", - "dev": true + "version": "4.3.20", + "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.20.tgz", + "integrity": "sha512-/pC9HAB5I/xMlc5FP77qjCnI16ChlJfW0tGa0IUcFn38VJrTV6DeZ60NU5KZBtaOZqjdpwTWohz5HU1RrhiYxQ==", + "dev": true, + "license": "MIT" }, "node_modules/@types/graceful-fs": { "version": "4.1.9", "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz", "integrity": "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==", "dev": true, + "license": "MIT", "dependencies": { "@types/node": "*" } @@ -1097,13 +1226,15 @@ "version": "2.0.6", "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz", "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/istanbul-lib-report": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz", "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==", "dev": true, + "license": "MIT", "dependencies": { "@types/istanbul-lib-coverage": "*" } @@ -1113,15 +1244,17 @@ "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz", "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==", "dev": true, + "license": "MIT", "dependencies": { "@types/istanbul-lib-report": "*" } }, "node_modules/@types/jest": { - "version": "29.5.12", - "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.12.tgz", - "integrity": "sha512-eDC8bTvT/QhYdxJAulQikueigY5AsdBRH2yDKW3yveW7svY3+DzN84/2NUgkw10RTiJbWqZrTtoGVdYlvFJdLw==", + "version": "29.5.13", + "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.13.tgz", + "integrity": "sha512-wd+MVEZCHt23V0/L642O5APvspWply/rGY5BcW4SUETo2UzPU3Z26qr8jC2qxpimI2jjx9h7+2cj2FwIr01bXg==", "dev": true, + "license": "MIT", "dependencies": { "expect": "^29.0.0", "pretty-format": "^29.0.0" @@ -1131,28 +1264,32 @@ "version": "1.2.5", "resolved": "https://registry.npmjs.org/@types/minimist/-/minimist-1.2.5.tgz", "integrity": "sha512-hov8bUuiLiyFPGyFPE1lwWhmzYbirOXQNNo40+y3zow8aFVTeyn3VWL0VFFfdNddA8S4Vf0Tc062rzyNr7Paag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/node": { - "version": "20.14.14", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.14.14.tgz", - "integrity": "sha512-d64f00982fS9YoOgJkAMolK7MN8Iq3TDdVjchbYHdEmjth/DHowx82GnoA+tVUAN+7vxfYUgAzi+JXbKNd2SDQ==", + "version": "20.16.9", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.16.9.tgz", + "integrity": "sha512-rkvIVJxsOfBejxK7I0FO5sa2WxFmJCzoDwcd88+fq/CUfynNywTo/1/T6hyFz22CyztsnLS9nVlHOnTI36RH5w==", "dev": true, + "license": "MIT", "dependencies": { - "undici-types": "~5.26.4" + "undici-types": "~6.19.2" } }, "node_modules/@types/normalize-package-data": { "version": "2.4.4", "resolved": "https://registry.npmjs.org/@types/normalize-package-data/-/normalize-package-data-2.4.4.tgz", "integrity": "sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/sinon": { "version": "10.0.20", "resolved": "https://registry.npmjs.org/@types/sinon/-/sinon-10.0.20.tgz", "integrity": "sha512-2APKKruFNCAZgx3daAyACGzWuJ028VVCUDk6o2rw/Z4PXT0ogwdV4KUegW0MwVs0Zu59auPXbbuBJHF12Sx1Eg==", "dev": true, + "license": "MIT", "dependencies": { "@types/sinonjs__fake-timers": "*" } @@ -1161,19 +1298,29 @@ "version": "8.1.5", "resolved": "https://registry.npmjs.org/@types/sinonjs__fake-timers/-/sinonjs__fake-timers-8.1.5.tgz", "integrity": "sha512-mQkU2jY8jJEF7YHjHvsQO8+3ughTL1mcnn96igfhONmR+fUPSKIkefQYpSe8bsly2Ep7oQbn/6VG5/9/0qcArQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/stack-utils": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.3.tgz", "integrity": "sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/@types/uuid": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-10.0.0.tgz", + "integrity": "sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==", + "dev": true, + "license": "MIT" }, "node_modules/@types/yargs": { - "version": "17.0.32", - "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.32.tgz", - "integrity": "sha512-xQ67Yc/laOG5uMfX/093MRlGGCIBzZMarVa+gfNKJxWAIgykYpVGkBdbqEzGDDfCrVUj6Hiff4mTZ5BA6TmAog==", + "version": "17.0.33", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz", + "integrity": "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==", "dev": true, + "license": "MIT", "dependencies": { "@types/yargs-parser": "*" } @@ -1182,13 +1329,15 @@ "version": "21.0.3", "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz", "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/acorn": { "version": "8.12.1", "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.12.1.tgz", "integrity": "sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==", "dev": true, + "license": "MIT", "bin": { "acorn": "bin/acorn" }, @@ -1197,10 +1346,11 @@ } }, "node_modules/acorn-walk": { - "version": "8.3.3", - "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.3.tgz", - "integrity": "sha512-MxXdReSRhGO7VlFe1bRG/oI7/mdLV9B9JJT0N8vZOhF7gFRR5l3M8W9G8JxmKV+JC5mGqJ0QvqfSOLsCPa4nUw==", + "version": "8.3.4", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz", + "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==", "dev": true, + "license": "MIT", "dependencies": { "acorn": "^8.11.0" }, @@ -1212,13 +1362,15 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/add-stream/-/add-stream-1.0.0.tgz", "integrity": "sha512-qQLMr+8o0WC4FZGQTcJiKBVC59JylcPSrTtk6usvmIDFUOCKegapy1VHQwRbFMOFyb/inzUVqHs+eMYKDM1YeQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/ajv": { "version": "6.12.6", "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", "dev": true, + "license": "MIT", "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", @@ -1235,6 +1387,7 @@ "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==", "dev": true, + "license": "MIT", "dependencies": { "type-fest": "^0.21.3" }, @@ -1250,6 +1403,7 @@ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1259,6 +1413,7 @@ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", "dev": true, + "license": "MIT", "dependencies": { "color-convert": "^2.0.1" }, @@ -1274,6 +1429,7 @@ "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", "dev": true, + "license": "ISC", "dependencies": { "normalize-path": "^3.0.0", "picomatch": "^2.0.4" @@ -1286,13 +1442,15 @@ "version": "4.1.3", "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz", "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/argparse": { "version": "1.0.10", "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", "dev": true, + "license": "MIT", "dependencies": { "sprintf-js": "~1.0.2" } @@ -1301,13 +1459,15 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/array-ify/-/array-ify-1.0.0.tgz", "integrity": "sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/arrify": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz", "integrity": "sha512-3CYzex9M9FGQjCGMGyi6/31c8GJbgb0qGyrx5HWxPd0aCwh4cB2YjMb2Xf9UuoogrMrlO9cTqnB5rI5GHZTcUA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1317,6 +1477,7 @@ "resolved": "https://registry.npmjs.org/asn1/-/asn1-0.2.6.tgz", "integrity": "sha512-ix/FxPn0MDjeyJ7i/yoHGFt/EX6LyNbxSEhPPXODPL+KB0VPk86UYfL0lMdy+KCnv+fmvIzySwaK5COwqVbWTQ==", "dev": true, + "license": "MIT", "dependencies": { "safer-buffer": "~2.1.0" } @@ -1326,6 +1487,7 @@ "resolved": "https://registry.npmjs.org/assert-plus/-/assert-plus-1.0.0.tgz", "integrity": "sha512-NfJ4UzBCcQGLDlQq7nHxH+tv3kyZ0hHQqF5BO6J7tNJeP5do1llPr8dZ8zHonfhAu0PHAdMkSo+8o0wxg9lZWw==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.8" } @@ -1335,42 +1497,48 @@ "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz", "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==", "dev": true, + "license": "MIT", "engines": { "node": "*" } }, "node_modules/async": { - "version": "3.2.5", - "resolved": "https://registry.npmjs.org/async/-/async-3.2.5.tgz", - "integrity": "sha512-baNZyqaaLhyLVKm/DlvdW051MSgO6b8eVfIezl9E5PqWxFgzLm/wQntEW4zOytVburDEr0JlALEpdOFwvErLsg==", - "dev": true + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" }, "node_modules/asynckit": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/aws-sign2": { "version": "0.7.0", "resolved": "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.7.0.tgz", "integrity": "sha512-08kcGqnYf/YmjoRhfxyu+CLxBjUtHLXLXX/vUfx9l2LYzG3c1m61nrpyFUZI6zeS+Li/wWMMidD9KgrqtGq3mA==", "dev": true, + "license": "Apache-2.0", "engines": { "node": "*" } }, "node_modules/aws4": { - "version": "1.13.0", - "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.13.0.tgz", - "integrity": "sha512-3AungXC4I8kKsS9PuS4JH2nc+0bVY/mjgrephHTIi8fpEeGsTHBUJeosp0Wc1myYMElmD0B3Oc4XL/HVJ4PV2g==", - "dev": true + "version": "1.13.2", + "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.13.2.tgz", + "integrity": "sha512-lHe62zvbTB5eEABUVi/AwVh0ZKY9rMMDhmm+eeyuuUQbQ3+J+fONVQOZyj+DdrvD4BY33uYniyRJ4UJIaSKAfw==", + "dev": true, + "license": "MIT" }, "node_modules/babel-jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz", "integrity": "sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/transform": "^29.7.0", "@types/babel__core": "^7.1.14", @@ -1392,6 +1560,7 @@ "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz", "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@babel/helper-plugin-utils": "^7.0.0", "@istanbuljs/load-nyc-config": "^1.0.0", @@ -1408,6 +1577,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz", "integrity": "sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@babel/core": "^7.12.3", "@babel/parser": "^7.14.7", @@ -1424,6 +1594,7 @@ "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz", "integrity": "sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/template": "^7.3.3", "@babel/types": "^7.3.3", @@ -1435,23 +1606,27 @@ } }, "node_modules/babel-preset-current-node-syntax": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.0.1.tgz", - "integrity": "sha512-M7LQ0bxarkxQoN+vz5aJPsLBn77n8QgTFmo8WK0/44auK2xlCXrYcUxHFxgU7qW5Yzw/CjmLRK2uJzaCd7LvqQ==", + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.1.0.tgz", + "integrity": "sha512-ldYss8SbBlWva1bs28q78Ju5Zq1F+8BrqBZZ0VFhLBvhh6lCpC2o3gDJi/5DRLs9FgYZCnmPYIVFU4lRXCkyUw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/plugin-syntax-async-generators": "^7.8.4", "@babel/plugin-syntax-bigint": "^7.8.3", - "@babel/plugin-syntax-class-properties": "^7.8.3", - "@babel/plugin-syntax-import-meta": "^7.8.3", + "@babel/plugin-syntax-class-properties": "^7.12.13", + "@babel/plugin-syntax-class-static-block": "^7.14.5", + "@babel/plugin-syntax-import-attributes": "^7.24.7", + "@babel/plugin-syntax-import-meta": "^7.10.4", "@babel/plugin-syntax-json-strings": "^7.8.3", - "@babel/plugin-syntax-logical-assignment-operators": "^7.8.3", + "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4", "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3", - "@babel/plugin-syntax-numeric-separator": "^7.8.3", + "@babel/plugin-syntax-numeric-separator": "^7.10.4", "@babel/plugin-syntax-object-rest-spread": "^7.8.3", "@babel/plugin-syntax-optional-catch-binding": "^7.8.3", "@babel/plugin-syntax-optional-chaining": "^7.8.3", - "@babel/plugin-syntax-top-level-await": "^7.8.3" + "@babel/plugin-syntax-private-property-in-object": "^7.14.5", + "@babel/plugin-syntax-top-level-await": "^7.14.5" }, "peerDependencies": { "@babel/core": "^7.0.0" @@ -1462,6 +1637,7 @@ "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz", "integrity": "sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==", "dev": true, + "license": "MIT", "dependencies": { "babel-plugin-jest-hoist": "^29.6.3", "babel-preset-current-node-syntax": "^1.0.0" @@ -1477,22 +1653,80 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true }, "node_modules/bcrypt-pbkdf": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/bcrypt-pbkdf/-/bcrypt-pbkdf-1.0.2.tgz", "integrity": "sha512-qeFIXtP4MSoi6NLqO12WfqARWWuCKi2Rn/9hJLEmtB5yTNr9DqFWkJRCf2qShWzPeAMRnOgCrq0sg/KLv5ES9w==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "tweetnacl": "^0.14.3" } }, + "node_modules/better-sqlite3": { + "version": "11.3.0", + "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.3.0.tgz", + "integrity": "sha512-iHt9j8NPYF3oKCNOO5ZI4JwThjt3Z6J6XrcwG85VNMVzv1ByqrHWv5VILEbCMFWDsoHhXvQ7oC8vgRXFAKgl9w==", + "hasInstallScript": true, + "license": "MIT", + "peer": true, + "dependencies": { + "bindings": "^1.5.0", + "prebuild-install": "^7.1.1" + } + }, + "node_modules/bindings": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", + "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "file-uri-to-path": "1.0.0" + } + }, + "node_modules/bl": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", + "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", + "license": "MIT", + "peer": true, + "dependencies": { + "buffer": "^5.5.0", + "inherits": "^2.0.4", + "readable-stream": "^3.4.0" + } + }, "node_modules/brace-expansion": { "version": "1.1.11", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", "dev": true, + "license": "MIT", "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" @@ -1503,6 +1737,7 @@ "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", "dev": true, + "license": "MIT", "dependencies": { "fill-range": "^7.1.1" }, @@ -1511,9 +1746,9 @@ } }, "node_modules/browserslist": { - "version": "4.23.3", - "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.23.3.tgz", - "integrity": "sha512-btwCFJVjI4YWDNfau8RhZ+B1Q/VLoUITrm3RlP6y1tYGWIOa+InuYiRGXUBXo8nA1qKmHMyLB/iVQg5TT4eFoA==", + "version": "4.24.0", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.0.tgz", + "integrity": "sha512-Rmb62sR1Zpjql25eSanFGEhAxcFwfA1K0GuQcLoaJBAcENegrQut3hYdhXFF1obQfiDyqIW/cLM5HSJ/9k884A==", "dev": true, "funding": [ { @@ -1529,9 +1764,10 @@ "url": "https://github.com/sponsors/ai" } ], + "license": "MIT", "dependencies": { - "caniuse-lite": "^1.0.30001646", - "electron-to-chromium": "^1.5.4", + "caniuse-lite": "^1.0.30001663", + "electron-to-chromium": "^1.5.28", "node-releases": "^2.0.18", "update-browserslist-db": "^1.1.0" }, @@ -1547,6 +1783,7 @@ "resolved": "https://registry.npmjs.org/bs-logger/-/bs-logger-0.2.6.tgz", "integrity": "sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==", "dev": true, + "license": "MIT", "dependencies": { "fast-json-stable-stringify": "2.x" }, @@ -1559,21 +1796,49 @@ "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz", "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==", "dev": true, + "license": "Apache-2.0", "dependencies": { "node-int64": "^0.4.0" } }, + "node_modules/buffer": { + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", + "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.1.13" + } + }, "node_modules/buffer-from": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/callsites": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -1583,6 +1848,7 @@ "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz", "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -1592,6 +1858,7 @@ "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-6.2.2.tgz", "integrity": "sha512-YrwaA0vEKazPBkn0ipTiMpSajYDSe+KjQfrjhcBMxJt/znbvlHd8Pw/Vamaz5EB4Wfhs3SUR3Z9mwRu/P3s3Yg==", "dev": true, + "license": "MIT", "dependencies": { "camelcase": "^5.3.1", "map-obj": "^4.0.0", @@ -1605,9 +1872,9 @@ } }, "node_modules/caniuse-lite": { - "version": "1.0.30001646", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001646.tgz", - "integrity": "sha512-dRg00gudiBDDTmUhClSdv3hqRfpbOnU28IpI1T6PBTLWa+kOj0681C8uML3PifYfREuBrVjDGhL3adYpBT6spw==", + "version": "1.0.30001664", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001664.tgz", + "integrity": "sha512-AmE7k4dXiNKQipgn7a2xg558IRqPN3jMQY/rOsbxDhrd0tyChwbITBfiwtnqz8bi2M5mIWbxAYBvk7W7QBUS2g==", "dev": true, "funding": [ { @@ -1622,19 +1889,22 @@ "type": "github", "url": "https://github.com/sponsors/ai" } - ] + ], + "license": "CC-BY-4.0" }, "node_modules/caseless": { "version": "0.12.0", "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz", "integrity": "sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==", - "dev": true + "dev": true, + "license": "Apache-2.0" }, "node_modules/chai": { "version": "4.5.0", "resolved": "https://registry.npmjs.org/chai/-/chai-4.5.0.tgz", "integrity": "sha512-RITGBfijLkBddZvnn8jdqoTypxvqbOLYQkGGxXzeFjVHvudaPw0HNFD9x928/eUwYWd2dPCugVqspGALTZZQKw==", "dev": true, + "license": "MIT", "dependencies": { "assertion-error": "^1.1.0", "check-error": "^1.0.3", @@ -1653,6 +1923,7 @@ "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -1669,6 +1940,7 @@ "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz", "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" } @@ -1678,6 +1950,7 @@ "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.3.tgz", "integrity": "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg==", "dev": true, + "license": "MIT", "dependencies": { "get-func-name": "^2.0.2" }, @@ -1685,6 +1958,13 @@ "node": "*" } }, + "node_modules/chownr": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", + "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", + "license": "ISC", + "peer": true + }, "node_modules/ci-info": { "version": "3.9.0", "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz", @@ -1696,21 +1976,24 @@ "url": "https://github.com/sponsors/sibiraj-s" } ], + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/cjs-module-lexer": { - "version": "1.3.1", - "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.3.1.tgz", - "integrity": "sha512-a3KdPAANPbNE4ZUv9h6LckSl9zLsYOP4MBmhIPkRaeyybt+r4UghLvq+xw/YwUcC1gqylCkL4rdVs3Lwupjm4Q==", - "dev": true + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.1.tgz", + "integrity": "sha512-cuSVIHi9/9E/+821Qjdvngor+xpnlwnuwIyZOaLmHBVdXL+gP+I6QQB9VkO7RI77YIcTV+S1W9AreJ5eN63JBA==", + "dev": true, + "license": "MIT" }, "node_modules/cliui": { "version": "7.0.4", "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz", "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==", "dev": true, + "license": "ISC", "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.0", @@ -1722,6 +2005,7 @@ "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz", "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==", "dev": true, + "license": "MIT", "engines": { "iojs": ">= 1.0.0", "node": ">= 0.12.0" @@ -1731,13 +2015,15 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz", "integrity": "sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/color-convert": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", "dev": true, + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -1749,13 +2035,15 @@ "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/combined-stream": { "version": "1.0.8", "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", "dev": true, + "license": "MIT", "dependencies": { "delayed-stream": "~1.0.0" }, @@ -1768,6 +2056,7 @@ "resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz", "integrity": "sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==", "dev": true, + "license": "MIT", "dependencies": { "array-ify": "^1.0.0", "dot-prop": "^5.1.0" @@ -1777,13 +2066,15 @@ "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/conventional-changelog": { "version": "3.1.25", "resolved": "https://registry.npmjs.org/conventional-changelog/-/conventional-changelog-3.1.25.tgz", "integrity": "sha512-ryhi3fd1mKf3fSjbLXOfK2D06YwKNic1nC9mWqybBHdObPd8KJ2vjaXZfYj1U23t+V8T8n0d7gwnc9XbIdFbyQ==", "dev": true, + "license": "MIT", "dependencies": { "conventional-changelog-angular": "^5.0.12", "conventional-changelog-atom": "^2.0.8", @@ -1806,6 +2097,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-5.0.13.tgz", "integrity": "sha512-i/gipMxs7s8L/QeuavPF2hLnJgH6pEZAttySB6aiQLWcX3puWDL3ACVmvBhJGxnAy52Qc15ua26BufY6KpmrVA==", "dev": true, + "license": "ISC", "dependencies": { "compare-func": "^2.0.0", "q": "^1.5.1" @@ -1819,6 +2111,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-atom/-/conventional-changelog-atom-2.0.8.tgz", "integrity": "sha512-xo6v46icsFTK3bb7dY/8m2qvc8sZemRgdqLb/bjpBsH2UyOS8rKNTgcb5025Hri6IpANPApbXMg15QLb1LJpBw==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1831,6 +2124,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-codemirror/-/conventional-changelog-codemirror-2.0.8.tgz", "integrity": "sha512-z5DAsn3uj1Vfp7po3gpt2Boc+Bdwmw2++ZHa5Ak9k0UKsYAO5mH1UBTN0qSCuJZREIhX6WU4E1p3IW2oRCNzQw==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1843,6 +2137,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-conventionalcommits/-/conventional-changelog-conventionalcommits-4.6.3.tgz", "integrity": "sha512-LTTQV4fwOM4oLPad317V/QNQ1FY4Hju5qeBIM1uTHbrnCE+Eg4CdRZ3gO2pUeR+tzWdp80M2j3qFFEDWVqOV4g==", "dev": true, + "license": "ISC", "dependencies": { "compare-func": "^2.0.0", "lodash": "^4.17.15", @@ -1857,6 +2152,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-core/-/conventional-changelog-core-4.2.4.tgz", "integrity": "sha512-gDVS+zVJHE2v4SLc6B0sLsPiloR0ygU7HaDW14aNJE1v4SlqJPILPl/aJC7YdtRE4CybBf8gDwObBvKha8Xlyg==", "dev": true, + "license": "MIT", "dependencies": { "add-stream": "^1.0.0", "conventional-changelog-writer": "^5.0.0", @@ -1882,6 +2178,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-ember/-/conventional-changelog-ember-2.0.9.tgz", "integrity": "sha512-ulzIReoZEvZCBDhcNYfDIsLTHzYHc7awh+eI44ZtV5cx6LVxLlVtEmcO+2/kGIHGtw+qVabJYjdI5cJOQgXh1A==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1894,6 +2191,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-eslint/-/conventional-changelog-eslint-3.0.9.tgz", "integrity": "sha512-6NpUCMgU8qmWmyAMSZO5NrRd7rTgErjrm4VASam2u5jrZS0n38V7Y9CzTtLT2qwz5xEChDR4BduoWIr8TfwvXA==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1906,6 +2204,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-express/-/conventional-changelog-express-2.0.6.tgz", "integrity": "sha512-SDez2f3iVJw6V563O3pRtNwXtQaSmEfTCaTBPCqn0oG0mfkq0rX4hHBq5P7De2MncoRixrALj3u3oQsNK+Q0pQ==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1918,6 +2217,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-jquery/-/conventional-changelog-jquery-3.0.11.tgz", "integrity": "sha512-x8AWz5/Td55F7+o/9LQ6cQIPwrCjfJQ5Zmfqi8thwUEKHstEn4kTIofXub7plf1xvFA2TqhZlq7fy5OmV6BOMw==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1930,6 +2230,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-jshint/-/conventional-changelog-jshint-2.0.9.tgz", "integrity": "sha512-wMLdaIzq6TNnMHMy31hql02OEQ8nCQfExw1SE0hYL5KvU+JCTuPaDO+7JiogGT2gJAxiUGATdtYYfh+nT+6riA==", "dev": true, + "license": "ISC", "dependencies": { "compare-func": "^2.0.0", "q": "^1.5.1" @@ -1943,6 +2244,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-preset-loader/-/conventional-changelog-preset-loader-2.3.4.tgz", "integrity": "sha512-GEKRWkrSAZeTq5+YjUZOYxdHq+ci4dNwHvpaBC3+ENalzFWuCWa9EZXSuZBpkr72sMdKB+1fyDV4takK1Lf58g==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" } @@ -1952,6 +2254,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-writer/-/conventional-changelog-writer-5.0.1.tgz", "integrity": "sha512-5WsuKUfxW7suLblAbFnxAcrvf6r+0b7GvNaWUwUIk0bXMnENP/PEieGKVUQrjPqwPT4o3EPAASBXiY6iHooLOQ==", "dev": true, + "license": "MIT", "dependencies": { "conventional-commits-filter": "^2.0.7", "dateformat": "^3.0.0", @@ -1975,6 +2278,7 @@ "resolved": "https://registry.npmjs.org/conventional-commits-filter/-/conventional-commits-filter-2.0.7.tgz", "integrity": "sha512-ASS9SamOP4TbCClsRHxIHXRfcGCnIoQqkvAzCSbZzTFLfcTqJVugB0agRgsEELsqaeWgsXv513eS116wnlSSPA==", "dev": true, + "license": "MIT", "dependencies": { "lodash.ismatch": "^4.4.0", "modify-values": "^1.0.0" @@ -1988,6 +2292,7 @@ "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-3.2.4.tgz", "integrity": "sha512-nK7sAtfi+QXbxHCYfhpZsfRtaitZLIA6889kFIouLvz6repszQDgxBu7wf2WbU+Dco7sAnNCJYERCwt54WPC2Q==", "dev": true, + "license": "MIT", "dependencies": { "is-text-path": "^1.0.1", "JSONStream": "^1.0.4", @@ -2007,19 +2312,22 @@ "version": "2.0.0", "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/core-util-is": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz", "integrity": "sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/coveralls": { "version": "3.1.1", "resolved": "https://registry.npmjs.org/coveralls/-/coveralls-3.1.1.tgz", "integrity": "sha512-+dxnG2NHncSD1NrqbSM3dn/lE57O6Qf/koe9+I7c+wzkqRmEvcp0kgJdxKInzYzkICKkFMZsX3Vct3++tsF9ww==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "js-yaml": "^3.13.1", "lcov-parse": "^1.0.0", @@ -2039,6 +2347,7 @@ "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz", "integrity": "sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "chalk": "^4.0.0", @@ -2059,13 +2368,15 @@ "version": "1.1.1", "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz", "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/cross-spawn": { "version": "7.0.3", "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", @@ -2080,6 +2391,7 @@ "resolved": "https://registry.npmjs.org/dargs/-/dargs-7.0.0.tgz", "integrity": "sha512-2iy1EkLdlBzQGvbweYRFxmFath8+K7+AKB0TlhHWkNuH+TmovaMH/Wp7V7R4u7f4SnX3OgLsU9t1NI9ioDnUpg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2089,6 +2401,7 @@ "resolved": "https://registry.npmjs.org/dashdash/-/dashdash-1.14.1.tgz", "integrity": "sha512-jRFi8UDGo6j+odZiEpjazZaWqEal3w/basFjQHQEwVtZJGDpxbH1MeYluwCS8Xq5wmLJooDlMgvVarmWfGM44g==", "dev": true, + "license": "MIT", "dependencies": { "assert-plus": "^1.0.0" }, @@ -2101,17 +2414,19 @@ "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-3.0.3.tgz", "integrity": "sha512-jyCETtSl3VMZMWeRo7iY1FL19ges1t55hMo5yaam4Jrsm5EPL89UQkoQRyiI+Yf4k8r2ZpdngkV8hr1lIdjb3Q==", "dev": true, + "license": "MIT", "engines": { "node": "*" } }, "node_modules/debug": { - "version": "4.3.6", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.6.tgz", - "integrity": "sha512-O/09Bd4Z1fBrU4VzkhFqVgpPzaGbw6Sm9FEkBT1A/YBXQFGuuSxa1dN2nxgxS34JmKXqYx8CZAwEVoJFImUXIg==", + "version": "4.3.7", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.7.tgz", + "integrity": "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ==", "dev": true, + "license": "MIT", "dependencies": { - "ms": "2.1.2" + "ms": "^2.1.3" }, "engines": { "node": ">=6.0" @@ -2127,6 +2442,7 @@ "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz", "integrity": "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -2136,6 +2452,7 @@ "resolved": "https://registry.npmjs.org/decamelize-keys/-/decamelize-keys-1.1.1.tgz", "integrity": "sha512-WiPxgEirIV0/eIOMcnFBA3/IJZAZqKnwAwWyvvdi4lsr1WCN22nhdf/3db3DoZcUjTV2SqfzIwNyp6y2xs3nmg==", "dev": true, + "license": "MIT", "dependencies": { "decamelize": "^1.1.0", "map-obj": "^1.0.0" @@ -2152,15 +2469,33 @@ "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz", "integrity": "sha512-7N/q3lyZ+LVCp7PzuxrJr4KMbBE2hW7BT7YNia330OFxIf4d3r5zVpicP2650l7CPN6RM9zOJRl3NGpqSiw3Eg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } }, + "node_modules/decompress-response": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", + "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "mimic-response": "^3.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/dedent": { "version": "1.5.3", "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.5.3.tgz", "integrity": "sha512-NHQtfOOW68WD8lgypbLA5oT+Bt0xXJhiYvoR6SmmNXZfpzOGXwdKWmcwG8N7PwVVWV3eF/68nmD9BaJSsTBhyQ==", "dev": true, + "license": "MIT", "peerDependencies": { "babel-plugin-macros": "^3.1.0" }, @@ -2175,6 +2510,7 @@ "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-4.1.4.tgz", "integrity": "sha512-SUwdGfqdKOwxCPeVYjwSyRpJ7Z+fhpwIAtmCUdZIWZ/YP5R9WAsyuSgpLVDi9bjWoN2LXHNss/dk3urXtdQxGg==", "dev": true, + "license": "MIT", "dependencies": { "type-detect": "^4.0.0" }, @@ -2182,11 +2518,22 @@ "node": ">=6" } }, + "node_modules/deep-extend": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", + "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=4.0.0" + } + }, "node_modules/deepmerge": { "version": "4.3.1", "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -2196,15 +2543,27 @@ "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.4.0" } }, + "node_modules/detect-libc": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.3.tgz", + "integrity": "sha512-bwy0MGW55bG41VqxxypOsdSdGqLwXPI/focwgTYCFMbdUiBAxLg9CFzG08sz2aqzknwiX7Hkl0bQENjg8iLByw==", + "license": "Apache-2.0", + "peer": true, + "engines": { + "node": ">=8" + } + }, "node_modules/detect-newline": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz", "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2212,13 +2571,15 @@ "node_modules/di0": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/di0/-/di0-1.0.0.tgz", - "integrity": "sha512-RRZsfbOmxiB0ZI+4ABfw/O7GUOnqmgFJGEPFzj7IX+mpm73Hkd38akjaTagaFmwzzRAqIIVR3uB3zSzwnt8ZFw==" + "integrity": "sha512-RRZsfbOmxiB0ZI+4ABfw/O7GUOnqmgFJGEPFzj7IX+mpm73Hkd38akjaTagaFmwzzRAqIIVR3uB3zSzwnt8ZFw==", + "license": "MIT" }, "node_modules/diff": { "version": "5.2.0", "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.0.tgz", "integrity": "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.3.1" } @@ -2228,6 +2589,7 @@ "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==", "dev": true, + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -2237,6 +2599,7 @@ "resolved": "https://registry.npmjs.org/dot-prop/-/dot-prop-5.3.0.tgz", "integrity": "sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==", "dev": true, + "license": "MIT", "dependencies": { "is-obj": "^2.0.0" }, @@ -2249,6 +2612,7 @@ "resolved": "https://registry.npmjs.org/ecc-jsbn/-/ecc-jsbn-0.1.2.tgz", "integrity": "sha512-eh9O+hwRHNbG4BLTjEl3nw044CkGm5X6LoaCf7LPp7UU8Qrt47JYNi6nPX8xjW97TKGKm1ouctg0QSpZe9qrnw==", "dev": true, + "license": "MIT", "dependencies": { "jsbn": "~0.1.0", "safer-buffer": "^2.1.0" @@ -2259,6 +2623,7 @@ "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "jake": "^10.8.5" }, @@ -2270,16 +2635,18 @@ } }, "node_modules/electron-to-chromium": { - "version": "1.5.4", - "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.4.tgz", - "integrity": "sha512-orzA81VqLyIGUEA77YkVA1D+N+nNfl2isJVjjmOyrlxuooZ19ynb+dOlaDTqd/idKRS9lDCSBmtzM+kyCsMnkA==", - "dev": true + "version": "1.5.29", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.29.tgz", + "integrity": "sha512-PF8n2AlIhCKXQ+gTpiJi0VhcHDb69kYX4MtCiivctc2QD3XuNZ/XIOlbGzt7WAjjEev0TtaH6Cu3arZExm5DOw==", + "dev": true, + "license": "ISC" }, "node_modules/emittery": { "version": "0.13.1", "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.13.1.tgz", "integrity": "sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=12" }, @@ -2291,22 +2658,35 @@ "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/end-of-stream": { + "version": "1.4.4", + "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.4.tgz", + "integrity": "sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==", + "license": "MIT", + "peer": true, + "dependencies": { + "once": "^1.4.0" + } }, "node_modules/error-ex": { "version": "1.3.2", "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz", "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==", "dev": true, + "license": "MIT", "dependencies": { "is-arrayish": "^0.2.1" } }, "node_modules/escalade": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.2.tgz", - "integrity": "sha512-ErCHMCae19vR8vQGe50xIsVomy19rg6gFu3+r3jkEO46suLMWBksvVyoGgQV+jOfl84ZSOSlmv6Gxa89PmTGmA==", + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -2316,6 +2696,7 @@ "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2325,6 +2706,7 @@ "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", "dev": true, + "license": "BSD-2-Clause", "bin": { "esparse": "bin/esparse.js", "esvalidate": "bin/esvalidate.js" @@ -2338,6 +2720,7 @@ "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", "dev": true, + "license": "MIT", "dependencies": { "cross-spawn": "^7.0.3", "get-stream": "^6.0.0", @@ -2365,11 +2748,22 @@ "node": ">= 0.8.0" } }, + "node_modules/expand-template": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", + "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", + "license": "(MIT OR WTFPL)", + "peer": true, + "engines": { + "node": ">=6" + } + }, "node_modules/expect": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/expect/-/expect-29.7.0.tgz", "integrity": "sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/expect-utils": "^29.7.0", "jest-get-type": "^29.6.3", @@ -2385,7 +2779,8 @@ "version": "3.0.2", "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/extsprintf": { "version": "1.3.0", @@ -2394,34 +2789,46 @@ "dev": true, "engines": [ "node >=0.6.0" - ] + ], + "license": "MIT" }, "node_modules/fast-deep-equal": { "version": "3.1.3", "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/fast-json-stable-stringify": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/fb-watchman": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz", "integrity": "sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "bser": "2.1.1" } }, + "node_modules/file-uri-to-path": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", + "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==", + "license": "MIT", + "peer": true + }, "node_modules/filelist": { "version": "1.0.4", "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", "dev": true, + "license": "Apache-2.0", "dependencies": { "minimatch": "^5.0.1" } @@ -2431,6 +2838,7 @@ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", "dev": true, + "license": "MIT", "dependencies": { "balanced-match": "^1.0.0" } @@ -2440,6 +2848,7 @@ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==", "dev": true, + "license": "ISC", "dependencies": { "brace-expansion": "^2.0.1" }, @@ -2452,6 +2861,7 @@ "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", "dev": true, + "license": "MIT", "dependencies": { "to-regex-range": "^5.0.1" }, @@ -2464,6 +2874,7 @@ "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", "dev": true, + "license": "MIT", "dependencies": { "locate-path": "^5.0.0", "path-exists": "^4.0.0" @@ -2477,6 +2888,7 @@ "resolved": "https://registry.npmjs.org/forever-agent/-/forever-agent-0.6.1.tgz", "integrity": "sha512-j0KLYPhm6zeac4lz3oJ3o65qvgQCcPubiyotZrXqEaG4hNagNYO8qdlUrX5vwqv9ohqeT/Z3j6+yW067yWWdUw==", "dev": true, + "license": "Apache-2.0", "engines": { "node": "*" } @@ -2486,6 +2898,7 @@ "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.3.tgz", "integrity": "sha512-1lLKB2Mu3aGP1Q/2eCOx0fNbRMe7XdwktwOruhfqqd0rIJWwN4Dh+E3hrPSlDCXnSR7UtZ1N38rVXm+6+MEhJQ==", "dev": true, + "license": "MIT", "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.6", @@ -2495,11 +2908,19 @@ "node": ">= 0.12" } }, + "node_modules/fs-constants": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", + "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", + "license": "MIT", + "peer": true + }, "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/fsevents": { "version": "2.3.3", @@ -2507,6 +2928,7 @@ "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", "dev": true, "hasInstallScript": true, + "license": "MIT", "optional": true, "os": [ "darwin" @@ -2520,6 +2942,7 @@ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", "dev": true, + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -2529,6 +2952,7 @@ "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -2538,6 +2962,7 @@ "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", "dev": true, + "license": "ISC", "engines": { "node": "6.* || 8.* || >= 10.*" } @@ -2547,6 +2972,7 @@ "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.2.tgz", "integrity": "sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ==", "dev": true, + "license": "MIT", "engines": { "node": "*" } @@ -2556,6 +2982,7 @@ "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz", "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8.0.0" } @@ -2565,6 +2992,7 @@ "resolved": "https://registry.npmjs.org/get-pkg-repo/-/get-pkg-repo-4.2.1.tgz", "integrity": "sha512-2+QbHjFRfGB74v/pYWjd5OhU3TDIC2Gv/YKUTk/tCvAz0pkn/Mz6P3uByuBimLOcPvN2jYdScl3xGFSrx0jEcA==", "dev": true, + "license": "MIT", "dependencies": { "@hutson/parse-repository-url": "^3.0.0", "hosted-git-info": "^4.0.0", @@ -2583,6 +3011,7 @@ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", "dev": true, + "license": "MIT", "dependencies": { "core-util-is": "~1.0.0", "inherits": "~2.0.3", @@ -2597,13 +3026,15 @@ "version": "5.1.2", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/get-pkg-repo/node_modules/string_decoder": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", "dev": true, + "license": "MIT", "dependencies": { "safe-buffer": "~5.1.0" } @@ -2613,6 +3044,7 @@ "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.5.tgz", "integrity": "sha512-/mrRod8xqpA+IHSLyGCQ2s8SPHiCDEeQJSep1jqLYeEUClOFG2Qsh+4FU6G9VeqpZnGW/Su8LQGc4YKni5rYSQ==", "dev": true, + "license": "MIT", "dependencies": { "readable-stream": "~2.3.6", "xtend": "~4.0.1" @@ -2623,6 +3055,7 @@ "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -2635,6 +3068,7 @@ "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz", "integrity": "sha512-0fzj9JxOLfJ+XGLhR8ze3unN0KZCgZwiSSDz168VERjK8Wl8kVSdcu2kspd4s4wtAa1y/qrVRiAA0WclVsu0ng==", "dev": true, + "license": "MIT", "dependencies": { "assert-plus": "^1.0.0" } @@ -2644,6 +3078,7 @@ "resolved": "https://registry.npmjs.org/git-raw-commits/-/git-raw-commits-2.0.11.tgz", "integrity": "sha512-VnctFhw+xfj8Va1xtfEqCUD2XDrbAPSJx+hSrE5K7fGdjZruW7XV+QOrN7LF/RJyvspRiD2I0asWsxFp0ya26A==", "dev": true, + "license": "MIT", "dependencies": { "dargs": "^7.0.0", "lodash": "^4.17.15", @@ -2663,6 +3098,7 @@ "resolved": "https://registry.npmjs.org/git-remote-origin-url/-/git-remote-origin-url-2.0.0.tgz", "integrity": "sha512-eU+GGrZgccNJcsDH5LkXR3PB9M958hxc7sbA8DFJjrv9j4L2P/eZfKhM+QD6wyzpiv+b1BpK0XrYCxkovtjSLw==", "dev": true, + "license": "MIT", "dependencies": { "gitconfiglocal": "^1.0.0", "pify": "^2.3.0" @@ -2676,6 +3112,7 @@ "resolved": "https://registry.npmjs.org/git-semver-tags/-/git-semver-tags-4.1.1.tgz", "integrity": "sha512-OWyMt5zBe7xFs8vglMmhM9lRQzCWL3WjHtxNNfJTMngGym7pC1kh8sP6jevfydJ6LP3ZvGxfb6ABYgPUM0mtsA==", "dev": true, + "license": "MIT", "dependencies": { "meow": "^8.0.0", "semver": "^6.0.0" @@ -2692,16 +3129,25 @@ "resolved": "https://registry.npmjs.org/gitconfiglocal/-/gitconfiglocal-1.0.0.tgz", "integrity": "sha512-spLUXeTAVHxDtKsJc8FkFVgFtMdEN9qPGpL23VfSHx4fP4+Ds097IXLvymbnDH8FnmxX5Nr9bPw3A+AQ6mWEaQ==", "dev": true, + "license": "BSD", "dependencies": { "ini": "^1.3.2" } }, + "node_modules/github-from-package": { + "version": "0.0.0", + "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", + "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", + "license": "MIT", + "peer": true + }, "node_modules/glob": { "version": "7.2.3", "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", "deprecated": "Glob versions prior to v9 are no longer supported", "dev": true, + "license": "ISC", "dependencies": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", @@ -2722,6 +3168,7 @@ "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -2730,13 +3177,15 @@ "version": "4.2.11", "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/handlebars": { "version": "4.7.8", "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==", "dev": true, + "license": "MIT", "dependencies": { "minimist": "^1.2.5", "neo-async": "^2.6.2", @@ -2758,6 +3207,7 @@ "resolved": "https://registry.npmjs.org/har-schema/-/har-schema-2.0.0.tgz", "integrity": "sha512-Oqluz6zhGX8cyRaTQlFMPw80bSJVG2x/cFb8ZPhUILGgHka9SsokCCOQgpveePerqidZOrT14ipqfJb7ILcW5Q==", "dev": true, + "license": "ISC", "engines": { "node": ">=4" } @@ -2768,6 +3218,7 @@ "integrity": "sha512-nmT2T0lljbxdQZfspsno9hgrG3Uir6Ks5afism62poxqBM6sDnMEuPmzTq8XN0OEwqKLLdh1jQI3qyE66Nzb3w==", "deprecated": "this library is no longer supported", "dev": true, + "license": "MIT", "dependencies": { "ajv": "^6.12.3", "har-schema": "^2.0.0" @@ -2781,6 +3232,7 @@ "resolved": "https://registry.npmjs.org/hard-rejection/-/hard-rejection-2.1.0.tgz", "integrity": "sha512-VIZB+ibDhx7ObhAe7OVtoEbuP4h/MuOTHJ+J8h/eBXotJYl0fBgR72xDFCKgIh22OJZIOVNxBMWuhAr10r8HdA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -2790,6 +3242,7 @@ "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2799,6 +3252,7 @@ "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", "dev": true, + "license": "MIT", "dependencies": { "function-bind": "^1.1.2" }, @@ -2811,6 +3265,7 @@ "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-4.1.0.tgz", "integrity": "sha512-kyCuEOWjJqZuDbRHzL8V93NzQhwIB71oFWSyzVo+KPZI+pnQPPxucdkrOZvkLRnrf5URsQM+IJ09Dw29cRALIA==", "dev": true, + "license": "ISC", "dependencies": { "lru-cache": "^6.0.0" }, @@ -2822,13 +3277,15 @@ "version": "2.0.2", "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz", "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/http-signature": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.2.0.tgz", "integrity": "sha512-CAbnr6Rz4CYQkLYUtSNXxQPUH2gK8f3iWexVlsnMeD+GjlsQ0Xsy1cOX+mN3dtxYomRy21CiOzU8Uhw6OwncEQ==", "dev": true, + "license": "MIT", "dependencies": { "assert-plus": "^1.0.0", "jsprim": "^1.2.2", @@ -2844,15 +3301,38 @@ "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", "dev": true, + "license": "Apache-2.0", "engines": { "node": ">=10.17.0" } }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause", + "peer": true + }, "node_modules/import-local": { "version": "3.2.0", "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz", "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==", "dev": true, + "license": "MIT", "dependencies": { "pkg-dir": "^4.2.0", "resolve-cwd": "^3.0.0" @@ -2872,6 +3352,7 @@ "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.8.19" } @@ -2881,6 +3362,7 @@ "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz", "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2891,6 +3373,7 @@ "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", "dev": true, + "license": "ISC", "dependencies": { "once": "^1.3.0", "wrappy": "1" @@ -2900,25 +3383,27 @@ "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", - "dev": true + "license": "ISC" }, "node_modules/ini": { "version": "1.3.8", "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", - "dev": true + "license": "ISC" }, "node_modules/is-arrayish": { "version": "0.2.1", "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/is-core-module": { - "version": "2.15.0", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.15.0.tgz", - "integrity": "sha512-Dd+Lb2/zvk9SKy1TGCt1wFJFo/MWBPMX5x7KcvLajWTGuomczdQX61PvY5yK6SVACwpoexWo81IfFyoKY2QnTA==", + "version": "2.15.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.15.1.tgz", + "integrity": "sha512-z0vtXSwucUJtANQWldhbtbt7BnL0vxiFjIdDLAatwhDYty2bad6s+rijD6Ri4YuYJubLzIJLUidCh09e1djEVQ==", "dev": true, + "license": "MIT", "dependencies": { "hasown": "^2.0.2" }, @@ -2934,6 +3419,7 @@ "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2943,6 +3429,7 @@ "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz", "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -2952,6 +3439,7 @@ "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.12.0" } @@ -2961,6 +3449,7 @@ "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-2.0.0.tgz", "integrity": "sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2970,6 +3459,7 @@ "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz", "integrity": "sha512-yvkRyxmFKEOQ4pNXCmJG5AEQNlXJS5LaONXo5/cLdTZdWvsZ1ioJEonLGAosKlMWE8lwUy/bJzMjcw8az73+Fg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -2979,6 +3469,7 @@ "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz", "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" }, @@ -2991,6 +3482,7 @@ "resolved": "https://registry.npmjs.org/is-text-path/-/is-text-path-1.0.1.tgz", "integrity": "sha512-xFuJpne9oFz5qDaodwmmG08e3CawH/2ZV8Qqza1Ko7Sk8POWbkRdwIoAWVhqvq0XeUzANEhKo2n0IXUGBm7A/w==", "dev": true, + "license": "MIT", "dependencies": { "text-extensions": "^1.0.0" }, @@ -3002,31 +3494,36 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-typedarray/-/is-typedarray-1.0.0.tgz", "integrity": "sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/isarray": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/isexe": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/isstream": { "version": "0.1.2", "resolved": "https://registry.npmjs.org/isstream/-/isstream-0.1.2.tgz", "integrity": "sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/istanbul-lib-coverage": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=8" } @@ -3036,6 +3533,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz", "integrity": "sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@babel/core": "^7.23.9", "@babel/parser": "^7.23.9", @@ -3052,6 +3550,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -3064,6 +3563,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz", "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "istanbul-lib-coverage": "^3.0.0", "make-dir": "^4.0.0", @@ -3078,6 +3578,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz", "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "debug": "^4.1.1", "istanbul-lib-coverage": "^3.0.0", @@ -3092,6 +3593,7 @@ "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.1.7.tgz", "integrity": "sha512-BewmUXImeuRk2YY0PVbxgKAysvhRPUQE0h5QRM++nVWyubKGV0l8qQ5op8+B2DOmwSe63Jivj0BjkPQVf8fP5g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "html-escaper": "^2.0.0", "istanbul-lib-report": "^3.0.0" @@ -3105,6 +3607,7 @@ "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.2.tgz", "integrity": "sha512-2P4SQ0HrLQ+fw6llpLnOaGAvN2Zu6778SJMrCUwns4fOoG9ayrTiZk3VV8sCPkVZF8ab0zksVpS8FDY5pRCNBA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "async": "^3.2.3", "chalk": "^4.0.2", @@ -3123,6 +3626,7 @@ "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz", "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/core": "^29.7.0", "@jest/types": "^29.6.3", @@ -3149,6 +3653,7 @@ "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-29.7.0.tgz", "integrity": "sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==", "dev": true, + "license": "MIT", "dependencies": { "execa": "^5.0.0", "jest-util": "^29.7.0", @@ -3163,6 +3668,7 @@ "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-29.7.0.tgz", "integrity": "sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/expect": "^29.7.0", @@ -3194,6 +3700,7 @@ "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-29.7.0.tgz", "integrity": "sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/core": "^29.7.0", "@jest/test-result": "^29.7.0", @@ -3227,6 +3734,7 @@ "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", "dev": true, + "license": "ISC", "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", @@ -3241,6 +3749,7 @@ "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz", "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==", "dev": true, + "license": "MIT", "dependencies": { "cliui": "^8.0.1", "escalade": "^3.1.1", @@ -3259,6 +3768,7 @@ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", "dev": true, + "license": "ISC", "engines": { "node": ">=12" } @@ -3268,6 +3778,7 @@ "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-29.7.0.tgz", "integrity": "sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/core": "^7.11.6", "@jest/test-sequencer": "^29.7.0", @@ -3313,6 +3824,7 @@ "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", "dev": true, + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "diff-sequences": "^29.6.3", @@ -3328,6 +3840,7 @@ "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-29.7.0.tgz", "integrity": "sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==", "dev": true, + "license": "MIT", "dependencies": { "detect-newline": "^3.0.0" }, @@ -3340,6 +3853,7 @@ "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-29.7.0.tgz", "integrity": "sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "chalk": "^4.0.0", @@ -3356,6 +3870,7 @@ "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-29.7.0.tgz", "integrity": "sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/fake-timers": "^29.7.0", @@ -3373,6 +3888,7 @@ "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==", "dev": true, + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -3382,6 +3898,7 @@ "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-29.7.0.tgz", "integrity": "sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/graceful-fs": "^4.1.3", @@ -3407,6 +3924,7 @@ "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz", "integrity": "sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==", "dev": true, + "license": "MIT", "dependencies": { "jest-get-type": "^29.6.3", "pretty-format": "^29.7.0" @@ -3420,6 +3938,7 @@ "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", "dev": true, + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "jest-diff": "^29.7.0", @@ -3435,6 +3954,7 @@ "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-29.7.0.tgz", "integrity": "sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==", "dev": true, + "license": "MIT", "dependencies": { "@babel/code-frame": "^7.12.13", "@jest/types": "^29.6.3", @@ -3455,6 +3975,7 @@ "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-29.7.0.tgz", "integrity": "sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/node": "*", @@ -3469,6 +3990,7 @@ "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz", "integrity": "sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" }, @@ -3486,6 +4008,7 @@ "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-29.6.3.tgz", "integrity": "sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==", "dev": true, + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -3495,6 +4018,7 @@ "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-29.7.0.tgz", "integrity": "sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==", "dev": true, + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "graceful-fs": "^4.2.9", @@ -3515,6 +4039,7 @@ "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz", "integrity": "sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==", "dev": true, + "license": "MIT", "dependencies": { "jest-regex-util": "^29.6.3", "jest-snapshot": "^29.7.0" @@ -3528,6 +4053,7 @@ "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-29.7.0.tgz", "integrity": "sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/console": "^29.7.0", "@jest/environment": "^29.7.0", @@ -3560,6 +4086,7 @@ "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-29.7.0.tgz", "integrity": "sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/fake-timers": "^29.7.0", @@ -3593,6 +4120,7 @@ "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-29.7.0.tgz", "integrity": "sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/core": "^7.11.6", "@babel/generator": "^7.7.2", @@ -3624,6 +4152,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -3636,6 +4165,7 @@ "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz", "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/node": "*", @@ -3653,6 +4183,7 @@ "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-29.7.0.tgz", "integrity": "sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "camelcase": "^6.2.0", @@ -3670,6 +4201,7 @@ "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz", "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -3682,6 +4214,7 @@ "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-29.7.0.tgz", "integrity": "sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==", "dev": true, + "license": "MIT", "dependencies": { "@jest/test-result": "^29.7.0", "@jest/types": "^29.6.3", @@ -3701,6 +4234,7 @@ "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz", "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==", "dev": true, + "license": "MIT", "dependencies": { "@types/node": "*", "jest-util": "^29.7.0", @@ -3716,6 +4250,7 @@ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", "dev": true, + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -3730,13 +4265,15 @@ "version": "4.0.0", "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/js-yaml": { "version": "3.14.1", "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", "dev": true, + "license": "MIT", "dependencies": { "argparse": "^1.0.7", "esprima": "^4.0.0" @@ -3749,13 +4286,15 @@ "version": "0.1.1", "resolved": "https://registry.npmjs.org/jsbn/-/jsbn-0.1.1.tgz", "integrity": "sha512-UVU9dibq2JcFWxQPA6KCqj5O42VOmAY3zQUfEKxU0KpTGXwNoCjkX1e13eHNvw/xPynt6pU0rZ1htjWTNTSXsg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/jsesc": { "version": "2.5.2", "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz", "integrity": "sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==", "dev": true, + "license": "MIT", "bin": { "jsesc": "bin/jsesc" }, @@ -3767,37 +4306,43 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz", "integrity": "sha512-mrqyZKfX5EhL7hvqcV6WG1yYjnjeuYDzDhhcAAUrq8Po85NBQBJP+ZDUT75qZQ98IkUoBqdkExkukOU7Ts2wrw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/json-parse-even-better-errors": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/json-schema": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz", "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==", - "dev": true + "dev": true, + "license": "(AFL-2.1 OR BSD-3-Clause)" }, "node_modules/json-schema-traverse": { "version": "0.4.1", "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/json-stringify-safe": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/json5": { "version": "2.2.3", "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", "dev": true, + "license": "MIT", "bin": { "json5": "lib/cli.js" }, @@ -3812,13 +4357,15 @@ "dev": true, "engines": [ "node >= 0.2.0" - ] + ], + "license": "MIT" }, "node_modules/JSONStream": { "version": "1.3.5", "resolved": "https://registry.npmjs.org/JSONStream/-/JSONStream-1.3.5.tgz", "integrity": "sha512-E+iruNOY8VV9s4JEbe1aNEm6MiszPRr/UfcHMz0TQh1BXSxHK+ASV1R6W4HpjBhSeS+54PIsAMCBmwD06LLsqQ==", "dev": true, + "license": "(MIT OR Apache-2.0)", "dependencies": { "jsonparse": "^1.2.0", "through": ">=2.2.7 <3" @@ -3835,6 +4382,7 @@ "resolved": "https://registry.npmjs.org/jsprim/-/jsprim-1.4.2.tgz", "integrity": "sha512-P2bSOMAc/ciLz6DzgjVlGJP9+BrJWu5UDGK70C2iweC5QBIeFf0ZXRvGjEj2uYgrY2MkAAhsSWHDWlFtEroZWw==", "dev": true, + "license": "MIT", "dependencies": { "assert-plus": "1.0.0", "extsprintf": "1.3.0", @@ -3849,13 +4397,15 @@ "version": "6.2.0", "resolved": "https://registry.npmjs.org/just-extend/-/just-extend-6.2.0.tgz", "integrity": "sha512-cYofQu2Xpom82S6qD778jBDpwvvy39s1l/hrYij2u9AMdQcGRpaBu6kY4mVhuno5kJVi1DAz4aiphA2WI1/OAw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/kind-of": { "version": "6.0.3", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz", "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -3865,6 +4415,7 @@ "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -3874,6 +4425,7 @@ "resolved": "https://registry.npmjs.org/lcov-parse/-/lcov-parse-1.0.0.tgz", "integrity": "sha512-aprLII/vPzuQvYZnDRU78Fns9I2Ag3gi4Ipga/hxnVMCZC8DnR2nI7XBqrPoywGfxqIx/DgarGvDJZAD3YBTgQ==", "dev": true, + "license": "BSD-3-Clause", "bin": { "lcov-parse": "bin/cli.js" } @@ -3883,6 +4435,7 @@ "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -3891,13 +4444,15 @@ "version": "1.2.4", "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/load-json-file": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-4.0.0.tgz", "integrity": "sha512-Kx8hMakjX03tiGTLAIdJ+lL0htKnXjEZN6hk/tozf/WOuYGdZBJrZ+rCJRbVCugsjB3jMLn9746NsQIf5VjBMw==", "dev": true, + "license": "MIT", "dependencies": { "graceful-fs": "^4.1.2", "parse-json": "^4.0.0", @@ -3913,6 +4468,7 @@ "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-4.0.0.tgz", "integrity": "sha512-aOIos8bujGN93/8Ox/jPLh7RwVnPEysynVFE+fQZyg6jKELEHwzgKdLRFHUgXJL6kylijVSBC4BvN9OmsB48Rw==", "dev": true, + "license": "MIT", "dependencies": { "error-ex": "^1.3.1", "json-parse-better-errors": "^1.0.1" @@ -3926,6 +4482,7 @@ "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz", "integrity": "sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -3935,6 +4492,7 @@ "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -3944,6 +4502,7 @@ "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", "dev": true, + "license": "MIT", "dependencies": { "p-locate": "^4.1.0" }, @@ -3955,31 +4514,36 @@ "version": "4.17.21", "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/lodash.get": { "version": "4.4.2", "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz", "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/lodash.ismatch": { "version": "4.4.0", "resolved": "https://registry.npmjs.org/lodash.ismatch/-/lodash.ismatch-4.4.0.tgz", "integrity": "sha512-fPMfXjGQEV9Xsq/8MTSgUf255gawYRbjwMyDbcvDhXgV7enSZA0hynz6vMPnpAb5iONEzBHBPsT+0zes5Z301g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/lodash.memoize": { "version": "4.1.2", "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz", "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/log-driver": { "version": "1.2.7", "resolved": "https://registry.npmjs.org/log-driver/-/log-driver-1.2.7.tgz", "integrity": "sha512-U7KCmLdqsGHBLeWqYlFA0V0Sl6P08EE1ZrmA9cxjUE0WVqT9qnyVDPz1kzpFEP0jdJuFnasWIfSd7fsaNXkpbg==", "dev": true, + "license": "ISC", "engines": { "node": ">=0.8.6" } @@ -3989,6 +4553,7 @@ "resolved": "https://registry.npmjs.org/loupe/-/loupe-2.3.7.tgz", "integrity": "sha512-zSMINGVYkdpYSOBmLi0D1Uo7JU9nVdQKrHxC8eYlV+9YKK9WePqAlL7lSlorG/U2Fw1w0hTBmaa/jrQ3UbPHtA==", "dev": true, + "license": "MIT", "dependencies": { "get-func-name": "^2.0.1" } @@ -3998,6 +4563,7 @@ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", "dev": true, + "license": "ISC", "dependencies": { "yallist": "^4.0.0" }, @@ -4010,6 +4576,7 @@ "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz", "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==", "dev": true, + "license": "MIT", "dependencies": { "semver": "^7.5.3" }, @@ -4025,6 +4592,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -4036,13 +4604,15 @@ "version": "1.3.6", "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz", "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/makeerror": { "version": "1.0.12", "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz", "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "tmpl": "1.0.5" } @@ -4052,6 +4622,7 @@ "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-4.3.0.tgz", "integrity": "sha512-hdN1wVrZbb29eBGiGjJbeP8JbKjq1urkHJ/LIP/NY48MZ1QVXUsQBV1G1zvYFHn1XE06cwjBsOI2K3Ulnj1YXQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" }, @@ -4064,6 +4635,7 @@ "resolved": "https://registry.npmjs.org/meow/-/meow-8.1.2.tgz", "integrity": "sha512-r85E3NdZ+mpYk1C6RjPFEMSE+s1iZMuHtsHAqY0DT3jZczl0diWUZ8g6oU7h0M9cD2EL+PzaYghhCLzR0ZNn5Q==", "dev": true, + "license": "MIT", "dependencies": { "@types/minimist": "^1.2.0", "camelcase-keys": "^6.2.2", @@ -4088,13 +4660,15 @@ "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/meow/node_modules/read-pkg": { "version": "5.2.0", "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-5.2.0.tgz", "integrity": "sha512-Ug69mNOpfvKDAc2Q8DRpMjjzdtrnv9HcSMX+4VsZxD1aZ6ZzrIE7rlzXBtWTyhULSMKg076AW6WR5iZpD0JiOg==", "dev": true, + "license": "MIT", "dependencies": { "@types/normalize-package-data": "^2.4.0", "normalize-package-data": "^2.5.0", @@ -4110,6 +4684,7 @@ "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-7.0.1.tgz", "integrity": "sha512-zK0TB7Xd6JpCLmlLmufqykGE+/TlOePD6qKClNW7hHDKFh/J7/7gCWGR7joEQEW1bKq3a3yUZSObOoWLFQ4ohg==", "dev": true, + "license": "MIT", "dependencies": { "find-up": "^4.1.0", "read-pkg": "^5.2.0", @@ -4127,6 +4702,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.8.1.tgz", "integrity": "sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=8" } @@ -4136,6 +4712,7 @@ "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz", "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^2.1.4", "resolve": "^1.10.0", @@ -4148,6 +4725,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.6.0.tgz", "integrity": "sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=8" } @@ -4157,6 +4735,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver" } @@ -4166,6 +4745,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.18.1.tgz", "integrity": "sha512-OIAYXk8+ISY+qTOwkHtKqzAuxchoMiD9Udx+FSGQDuiRR+PJKJHc2NJAXlbhkGwTt/4/nKZxELY1w3ReWOL8mw==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=10" }, @@ -4177,13 +4757,15 @@ "version": "2.0.0", "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/micromatch": { - "version": "4.0.7", - "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.7.tgz", - "integrity": "sha512-LPP/3KorzCwBxfeUuZmaR6bG2kdeHSbe0P2tY3FLRU4vYrjYz5hI4QZwV0njUx3jeuKe67YukQ1LSPZBKDqO/Q==", + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", "dev": true, + "license": "MIT", "dependencies": { "braces": "^3.0.3", "picomatch": "^2.3.1" @@ -4197,6 +4779,7 @@ "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.6" } @@ -4206,6 +4789,7 @@ "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", "dev": true, + "license": "MIT", "dependencies": { "mime-db": "1.52.0" }, @@ -4218,15 +4802,30 @@ "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } }, + "node_modules/mimic-response": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", + "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/min-indent": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/min-indent/-/min-indent-1.0.1.tgz", "integrity": "sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4236,6 +4835,7 @@ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", "dev": true, + "license": "ISC", "dependencies": { "brace-expansion": "^1.1.7" }, @@ -4247,7 +4847,7 @@ "version": "1.2.8", "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", - "dev": true, + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -4257,6 +4857,7 @@ "resolved": "https://registry.npmjs.org/minimist-options/-/minimist-options-4.1.0.tgz", "integrity": "sha512-Q4r8ghd80yhO/0j1O3B2BjweX3fiHg9cdOwjJd2J76Q135c+NDxGCqdYKQ1SKBuFfgWbAUzBfvYjPUEeNgqN1A==", "dev": true, + "license": "MIT", "dependencies": { "arrify": "^1.0.1", "is-plain-obj": "^1.1.0", @@ -4266,38 +4867,57 @@ "node": ">= 6" } }, + "node_modules/mkdirp-classic": { + "version": "0.5.3", + "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", + "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", + "license": "MIT", + "peer": true + }, "node_modules/modify-values": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/modify-values/-/modify-values-1.0.1.tgz", "integrity": "sha512-xV2bxeN6F7oYjZWTe/YPAy6MN2M+sL4u/Rlm2AHCIVGfo2p1yGmBHQ6vHehl4bRTZBdHu3TSkWdYgkwpYzAGSw==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } }, "node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", - "dev": true + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/napi-build-utils": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-1.0.2.tgz", + "integrity": "sha512-ONmRUqK7zj7DWX0D9ADe03wbwOBZxNAfF20PlGfCWQcD3+/MakShIHrMqx9YwPTfxDdF1zLeL+RGZiR9kGMLdg==", + "license": "MIT", + "peer": true }, "node_modules/natural-compare": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/neo-async": { "version": "2.6.2", "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/nise": { "version": "5.1.9", "resolved": "https://registry.npmjs.org/nise/-/nise-5.1.9.tgz", "integrity": "sha512-qOnoujW4SV6e40dYxJOb3uvuoPHtmLzIk4TFo+j0jPJoC+5Z9xja5qH5JZobEPsa8+YYphMrOSwnrshEhG2qww==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@sinonjs/commons": "^3.0.0", "@sinonjs/fake-timers": "^11.2.2", @@ -4307,31 +4927,61 @@ } }, "node_modules/nise/node_modules/@sinonjs/fake-timers": { - "version": "11.2.2", - "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-11.2.2.tgz", - "integrity": "sha512-G2piCSxQ7oWOxwGSAyFHfPIsyeJGXYtc6mFbnFA+kRXkiEnTl8c/8jul2S329iFBnDI9HGoeWWAZvuvOkZccgw==", + "version": "11.3.1", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-11.3.1.tgz", + "integrity": "sha512-EVJO7nW5M/F5Tur0Rf2z/QoMo+1Ia963RiMtapiQrEWvY0iBUvADo8Beegwjpnle5BHkyHuoxSTW3jF43H1XRA==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^3.0.0" + "@sinonjs/commons": "^3.0.1" + } + }, + "node_modules/node-abi": { + "version": "3.68.0", + "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.68.0.tgz", + "integrity": "sha512-7vbj10trelExNjFSBm5kTvZXXa7pZyKWx9RCKIyqe6I9Ev3IzGpQoqBP3a+cOdxY+pWj6VkP28n/2wWysBHD/A==", + "license": "MIT", + "peer": true, + "dependencies": { + "semver": "^7.3.5" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/node-abi/node_modules/semver": { + "version": "7.6.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", + "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "license": "ISC", + "peer": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" } }, "node_modules/node-int64": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz", "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/node-releases": { "version": "2.0.18", "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.18.tgz", "integrity": "sha512-d9VeXT4SJ7ZeOqGX6R5EM022wpL+eWPooLI+5UpWn2jCT1aosUQEhQP214x33Wkwx3JQMvIm+tIoVOdodFS40g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/normalize-package-data": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-3.0.3.tgz", "integrity": "sha512-p2W1sgqij3zMMyRC067Dg16bfzVH+w7hyegmpIvZ4JNjqtGOVAIvLmjBx3yP7YTe9vKJgkoNOPjwQGogDoMXFA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^4.0.1", "is-core-module": "^2.5.0", @@ -4347,6 +4997,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -4359,6 +5010,7 @@ "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -4368,6 +5020,7 @@ "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz", "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.0.0" }, @@ -4380,6 +5033,7 @@ "resolved": "https://registry.npmjs.org/oauth-sign/-/oauth-sign-0.9.0.tgz", "integrity": "sha512-fexhUFFPTGV8ybAtSIGbV6gOkSv8UtRbDBnAyLQw4QPKkgNlsH2ByPGtMUqdWkos6YCRmAqViwgZrJc/mRDzZQ==", "dev": true, + "license": "Apache-2.0", "engines": { "node": "*" } @@ -4388,7 +5042,7 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", - "dev": true, + "license": "ISC", "dependencies": { "wrappy": "1" } @@ -4398,6 +5052,7 @@ "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", "dev": true, + "license": "MIT", "dependencies": { "mimic-fn": "^2.1.0" }, @@ -4413,6 +5068,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", "dev": true, + "license": "MIT", "dependencies": { "yocto-queue": "^0.1.0" }, @@ -4428,6 +5084,7 @@ "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", "dev": true, + "license": "MIT", "dependencies": { "p-limit": "^2.2.0" }, @@ -4440,6 +5097,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", "dev": true, + "license": "MIT", "dependencies": { "p-try": "^2.0.0" }, @@ -4455,6 +5113,7 @@ "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz", "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -4464,6 +5123,7 @@ "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/code-frame": "^7.0.0", "error-ex": "^1.3.1", @@ -4482,6 +5142,7 @@ "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4491,6 +5152,7 @@ "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -4500,6 +5162,7 @@ "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4508,19 +5171,22 @@ "version": "1.0.7", "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/path-to-regexp": { - "version": "6.2.2", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.2.2.tgz", - "integrity": "sha512-GQX3SSMokngb36+whdpRXE+3f9V8UzyAorlYvOGx87ufGHehNTn5lCxrKtLyZ4Yl/wEKnNnr98ZzOwwDZV5ogw==", - "dev": true + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.3.0.tgz", + "integrity": "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==", + "dev": true, + "license": "MIT" }, "node_modules/path-type": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/path-type/-/path-type-3.0.0.tgz", "integrity": "sha512-T2ZUsdZFHgA3u4e5PfPbjd7HDDpxPnQb5jN0SrDsjNSuVXHJqtwTnWqG0B1jZrgmJ/7lj1EmVIByWt1gxGkWvg==", "dev": true, + "license": "MIT", "dependencies": { "pify": "^3.0.0" }, @@ -4533,6 +5199,7 @@ "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz", "integrity": "sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4542,6 +5209,7 @@ "resolved": "https://registry.npmjs.org/pathval/-/pathval-1.1.1.tgz", "integrity": "sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==", "dev": true, + "license": "MIT", "engines": { "node": "*" } @@ -4550,19 +5218,22 @@ "version": "2.1.0", "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz", "integrity": "sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/picocolors": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.0.1.tgz", - "integrity": "sha512-anP1Z8qwhkbmu7MFP5iTt+wQKXgwzf7zTyGlcdzabySa9vd0Xt392U0rVmz9poOaBj0uHJKyyo9/upk0HrEQew==", - "dev": true + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.0.tgz", + "integrity": "sha512-TQ92mBOW0l3LeMeyLV6mzy/kWr8lkd/hp3mTg7wYK7zJhuBStmGMBG0BdeDZS/dZx1IukaX6Bk11zcln25o1Aw==", + "dev": true, + "license": "ISC" }, "node_modules/picomatch": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", "dev": true, + "license": "MIT", "engines": { "node": ">=8.6" }, @@ -4575,6 +5246,7 @@ "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -4584,6 +5256,7 @@ "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.6.tgz", "integrity": "sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 6" } @@ -4593,6 +5266,7 @@ "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", "dev": true, + "license": "MIT", "dependencies": { "find-up": "^4.0.0" }, @@ -4600,11 +5274,39 @@ "node": ">=8" } }, + "node_modules/prebuild-install": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.2.tgz", + "integrity": "sha512-UnNke3IQb6sgarcZIDU3gbMeTp/9SSU1DAIkil7PrqG1vZlBtY5msYccSKSHDqa3hNg436IXK+SNImReuA1wEQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "detect-libc": "^2.0.0", + "expand-template": "^2.0.3", + "github-from-package": "0.0.0", + "minimist": "^1.2.3", + "mkdirp-classic": "^0.5.3", + "napi-build-utils": "^1.0.1", + "node-abi": "^3.3.0", + "pump": "^3.0.0", + "rc": "^1.2.7", + "simple-get": "^4.0.0", + "tar-fs": "^2.0.0", + "tunnel-agent": "^0.6.0" + }, + "bin": { + "prebuild-install": "bin.js" + }, + "engines": { + "node": ">=10" + } + }, "node_modules/pretty-format": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/schemas": "^29.6.3", "ansi-styles": "^5.0.0", @@ -4619,6 +5321,7 @@ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -4630,13 +5333,15 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/prompts": { "version": "2.4.2", "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", "dev": true, + "license": "MIT", "dependencies": { "kleur": "^3.0.3", "sisteransi": "^1.0.5" @@ -4649,13 +5354,26 @@ "version": "1.9.0", "resolved": "https://registry.npmjs.org/psl/-/psl-1.9.0.tgz", "integrity": "sha512-E/ZsdU4HLs/68gYzgGTkMicWTLPdAftJLfJFlLUAAKZGkStNU72sZjT66SnMDVOfOWY/YAoiD7Jxa9iHvngcag==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/pump": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.2.tgz", + "integrity": "sha512-tUPXtzlGM8FE3P0ZL6DVs/3P58k9nk8/jZeQCurTJylQA8qFYzHFfhBJkuqyE0FifOsQ0uKWekiZ5g8wtr28cw==", + "license": "MIT", + "peer": true, + "dependencies": { + "end-of-stream": "^1.1.0", + "once": "^1.3.1" + } }, "node_modules/punycode": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -4674,7 +5392,8 @@ "type": "opencollective", "url": "https://opencollective.com/fast-check" } - ] + ], + "license": "MIT" }, "node_modules/q": { "version": "1.5.1", @@ -4682,6 +5401,7 @@ "integrity": "sha512-kV/CThkXo6xyFEZUugw/+pIOywXcDbFYgSct5cT3gqlbkBE1SJdwy6UQoZvodiWF/ckQLZyDE/Bu1M6gVu5lVw==", "deprecated": "You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other.\n\n(For a CapTP with native promises, see @endo/eventual-send and @endo/captp)", "dev": true, + "license": "MIT", "engines": { "node": ">=0.6.0", "teleport": ">=0.2.0" @@ -4692,6 +5412,7 @@ "resolved": "https://registry.npmjs.org/qs/-/qs-6.5.3.tgz", "integrity": "sha512-qxXIEh4pCGfHICj1mAJQ2/2XVZkjCDTcEgfoSQxc/fYivUZxTkk7L3bDBJSoNrEzXI17oUO5Dp07ktqE5KzczA==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.6" } @@ -4701,21 +5422,50 @@ "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-4.0.1.tgz", "integrity": "sha512-ARhCpm70fzdcvNQfPoy49IaanKkTlRWF2JMzqhcJbhSFRZv7nPTvZJdcY7301IPmvW+/p0RgIWnQDLJxifsQ7g==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, + "node_modules/rc": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", + "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", + "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", + "peer": true, + "dependencies": { + "deep-extend": "^0.6.0", + "ini": "~1.3.0", + "minimist": "^1.2.0", + "strip-json-comments": "~2.0.1" + }, + "bin": { + "rc": "cli.js" + } + }, + "node_modules/rc/node_modules/strip-json-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", + "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/react-is": { "version": "18.3.1", "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/read-pkg": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-3.0.0.tgz", "integrity": "sha512-BLq/cCO9two+lBgiTYNqD6GdtK8s4NpaWrl6/rCO9w0TUS8oJl7cmToOZfRYllKTISY6nt1U7jQ53brmKqY6BA==", "dev": true, + "license": "MIT", "dependencies": { "load-json-file": "^4.0.0", "normalize-package-data": "^2.3.2", @@ -4730,6 +5480,7 @@ "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-3.0.0.tgz", "integrity": "sha512-YFzFrVvpC6frF1sz8psoHDBGF7fLPc+llq/8NB43oagqWkx8ar5zYtsTORtOjw9W2RHLpWP+zTWwBvf1bCmcSw==", "dev": true, + "license": "MIT", "dependencies": { "find-up": "^2.0.0", "read-pkg": "^3.0.0" @@ -4743,6 +5494,7 @@ "resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz", "integrity": "sha512-NWzkk0jSJtTt08+FBFMvXoeZnOJD+jTtsRmBYbAIzJdX6l7dLgR7CTubCM5/eDdPUBvLCeVasP1brfVR/9/EZQ==", "dev": true, + "license": "MIT", "dependencies": { "locate-path": "^2.0.0" }, @@ -4755,6 +5507,7 @@ "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-2.0.0.tgz", "integrity": "sha512-NCI2kiDkyR7VeEKm27Kda/iQHyKJe1Bu0FlTbYp3CqJu+9IFe9bLyAjMxf5ZDDbEg+iMPzB5zYyUTSm8wVTKmA==", "dev": true, + "license": "MIT", "dependencies": { "p-locate": "^2.0.0", "path-exists": "^3.0.0" @@ -4768,6 +5521,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-1.3.0.tgz", "integrity": "sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==", "dev": true, + "license": "MIT", "dependencies": { "p-try": "^1.0.0" }, @@ -4780,6 +5534,7 @@ "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-2.0.0.tgz", "integrity": "sha512-nQja7m7gSKuewoVRen45CtVfODR3crN3goVQ0DDZ9N3yHxgpkuBhZqsaiotSQRrADUrne346peY7kT3TSACykg==", "dev": true, + "license": "MIT", "dependencies": { "p-limit": "^1.1.0" }, @@ -4792,6 +5547,7 @@ "resolved": "https://registry.npmjs.org/p-try/-/p-try-1.0.0.tgz", "integrity": "sha512-U1etNYuMJoIz3ZXSrrySFjsXQTWOx2/jdi86L+2pRvph/qMKL6sbcCYdH23fqsbm8TH2Gn0OybpT4eSFlCVHww==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4801,6 +5557,7 @@ "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", "integrity": "sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4809,13 +5566,15 @@ "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/read-pkg/node_modules/normalize-package-data": { "version": "2.5.0", "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz", "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^2.1.4", "resolve": "^1.10.0", @@ -4828,6 +5587,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver" } @@ -4836,7 +5596,7 @@ "version": "3.6.2", "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "dev": true, + "license": "MIT", "dependencies": { "inherits": "^2.0.3", "string_decoder": "^1.1.1", @@ -4851,6 +5611,7 @@ "resolved": "https://registry.npmjs.org/redent/-/redent-3.0.0.tgz", "integrity": "sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg==", "dev": true, + "license": "MIT", "dependencies": { "indent-string": "^4.0.0", "strip-indent": "^3.0.0" @@ -4865,6 +5626,7 @@ "integrity": "sha512-MsvtOrfG9ZcrOwAW+Qi+F6HbD0CWXEh9ou77uOb7FM2WPhwT7smM833PzanhJLsgXjN89Ir6V2PczXNnMpwKhw==", "deprecated": "request has been deprecated, see https://github.com/request/request/issues/3142", "dev": true, + "license": "Apache-2.0", "dependencies": { "aws-sign2": "~0.7.0", "aws4": "^1.8.0", @@ -4891,11 +5653,23 @@ "node": ">= 6" } }, + "node_modules/request/node_modules/uuid": { + "version": "3.4.0", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.4.0.tgz", + "integrity": "sha512-HjSDRw6gZE5JMggctHBcjVak08+KEVhSIiDzFnT9S9aegmp85S/bReBVTb4QTFaRNptJ9kuYaNhnbNEOkbKb/A==", + "deprecated": "Please upgrade to version 7 or higher. Older versions may use Math.random() in certain circumstances, which is known to be problematic. See https://v8.dev/blog/math-random for details.", + "dev": true, + "license": "MIT", + "bin": { + "uuid": "bin/uuid" + } + }, "node_modules/require-directory": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -4905,6 +5679,7 @@ "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz", "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==", "dev": true, + "license": "MIT", "dependencies": { "is-core-module": "^2.13.0", "path-parse": "^1.0.7", @@ -4922,6 +5697,7 @@ "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz", "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==", "dev": true, + "license": "MIT", "dependencies": { "resolve-from": "^5.0.0" }, @@ -4934,6 +5710,7 @@ "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4943,6 +5720,7 @@ "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.2.tgz", "integrity": "sha512-X2UW6Nw3n/aMgDVy+0rSqgHlv39WZAlZrXCdnbyEiKm17DSqHX4MmQMaST3FbeWR5FTuRcUwYAziZajji0Y7mg==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" } @@ -4951,7 +5729,6 @@ "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", - "dev": true, "funding": [ { "type": "github", @@ -4965,19 +5742,22 @@ "type": "consulting", "url": "https://feross.org/support" } - ] + ], + "license": "MIT" }, "node_modules/safer-buffer": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/semver": { "version": "6.3.1", "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" } @@ -4987,6 +5767,7 @@ "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", "dev": true, + "license": "MIT", "dependencies": { "shebang-regex": "^3.0.0" }, @@ -4999,6 +5780,7 @@ "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -5007,7 +5789,55 @@ "version": "3.0.7", "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", - "dev": true + "dev": true, + "license": "ISC" + }, + "node_modules/simple-concat": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz", + "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true + }, + "node_modules/simple-get": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz", + "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "decompress-response": "^6.0.0", + "once": "^1.3.1", + "simple-concat": "^1.0.0" + } }, "node_modules/sinon": { "version": "15.2.0", @@ -5015,6 +5845,7 @@ "integrity": "sha512-nPS85arNqwBXaIsFCkolHjGIkFo+Oxu9vbgmBJizLAhqe6P2o3Qmj3KCUoRkfhHtvgDhZdWD3risLHAUJ8npjw==", "deprecated": "16.1.1", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@sinonjs/commons": "^3.0.0", "@sinonjs/fake-timers": "^10.3.0", @@ -5032,13 +5863,15 @@ "version": "1.0.5", "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/slash": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -5048,6 +5881,7 @@ "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.10.0" } @@ -5057,6 +5891,7 @@ "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.13.tgz", "integrity": "sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==", "dev": true, + "license": "MIT", "dependencies": { "buffer-from": "^1.0.0", "source-map": "^0.6.0" @@ -5067,6 +5902,7 @@ "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.2.0.tgz", "integrity": "sha512-kN9dJbvnySHULIluDHy32WHRUu3Og7B9sbY7tsFLctQkIqnMh3hErYgdMjTYuqmcXX+lK5T1lnUt3G7zNswmZA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "spdx-expression-parse": "^3.0.0", "spdx-license-ids": "^3.0.0" @@ -5076,29 +5912,33 @@ "version": "2.5.0", "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.5.0.tgz", "integrity": "sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==", - "dev": true + "dev": true, + "license": "CC-BY-3.0" }, "node_modules/spdx-expression-parse": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.1.tgz", "integrity": "sha512-cbqHunsQWnJNE6KhVSMsMeH5H/L9EpymbzqTQ3uLwNCLZ1Q481oWaofqH7nO6V07xlXwY6PhQdQ2IedWx/ZK4Q==", "dev": true, + "license": "MIT", "dependencies": { "spdx-exceptions": "^2.1.0", "spdx-license-ids": "^3.0.0" } }, "node_modules/spdx-license-ids": { - "version": "3.0.18", - "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.18.tgz", - "integrity": "sha512-xxRs31BqRYHwiMzudOrpSiHtZ8i/GeionCBDSilhYRj+9gIcI8wCZTlXZKu9vZIVqViP3dcp9qE5G6AlIaD+TQ==", - "dev": true + "version": "3.0.20", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.20.tgz", + "integrity": "sha512-jg25NiDV/1fLtSgEgyvVyDunvaNHbuwF9lfNV17gSmPFAlYzdfNBlLtLzXTevwkPj7DhGbmN9VnmJIgLnhvaBw==", + "dev": true, + "license": "CC0-1.0" }, "node_modules/split": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/split/-/split-1.0.1.tgz", "integrity": "sha512-mTyOoPbrivtXnwnIxZRFYRrPNtEFKlpB2fvjSnCQUiAA6qAZzqwna5envK4uk6OIeP17CsdF3rSBGYVBsU0Tkg==", "dev": true, + "license": "MIT", "dependencies": { "through": "2" }, @@ -5111,6 +5951,7 @@ "resolved": "https://registry.npmjs.org/split2/-/split2-3.2.2.tgz", "integrity": "sha512-9NThjpgZnifTkJpzTZ7Eue85S49QwpNhZTq6GRJwObb6jnLFNGB7Qm73V5HewTROPyxD0C29xqmaI68bQtV+hg==", "dev": true, + "license": "ISC", "dependencies": { "readable-stream": "^3.0.0" } @@ -5119,13 +5960,15 @@ "version": "1.0.3", "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", - "dev": true + "dev": true, + "license": "BSD-3-Clause" }, "node_modules/sshpk": { "version": "1.18.0", "resolved": "https://registry.npmjs.org/sshpk/-/sshpk-1.18.0.tgz", "integrity": "sha512-2p2KJZTSqQ/I3+HX42EpYOa2l3f8Erv8MWKsy2I9uf4wA7yFIkXRffYdsx86y6z4vHtV8u7g+pPlr8/4ouAxsQ==", "dev": true, + "license": "MIT", "dependencies": { "asn1": "~0.2.3", "assert-plus": "^1.0.0", @@ -5151,6 +5994,7 @@ "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz", "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==", "dev": true, + "license": "MIT", "dependencies": { "escape-string-regexp": "^2.0.0" }, @@ -5162,7 +6006,7 @@ "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", - "dev": true, + "license": "MIT", "dependencies": { "safe-buffer": "~5.2.0" } @@ -5172,6 +6016,7 @@ "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz", "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==", "dev": true, + "license": "MIT", "dependencies": { "char-regex": "^1.0.2", "strip-ansi": "^6.0.0" @@ -5185,6 +6030,7 @@ "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", "dev": true, + "license": "MIT", "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", @@ -5199,6 +6045,7 @@ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", "dev": true, + "license": "MIT", "dependencies": { "ansi-regex": "^5.0.1" }, @@ -5211,6 +6058,7 @@ "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz", "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -5220,6 +6068,7 @@ "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz", "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -5229,6 +6078,7 @@ "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-3.0.0.tgz", "integrity": "sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==", "dev": true, + "license": "MIT", "dependencies": { "min-indent": "^1.0.0" }, @@ -5241,6 +6091,7 @@ "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" }, @@ -5253,6 +6104,7 @@ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", "dev": true, + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -5265,6 +6117,7 @@ "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -5272,11 +6125,42 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/tar-fs": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.1.tgz", + "integrity": "sha512-V0r2Y9scmbDRLCNex/+hYzvp/zyYjvFbHPNgVTKfQvVrb6guiE/fxP+XblDNR011utopbkex2nM4dHNV6GDsng==", + "license": "MIT", + "peer": true, + "dependencies": { + "chownr": "^1.1.1", + "mkdirp-classic": "^0.5.2", + "pump": "^3.0.0", + "tar-stream": "^2.1.4" + } + }, + "node_modules/tar-stream": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz", + "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "bl": "^4.0.3", + "end-of-stream": "^1.4.1", + "fs-constants": "^1.0.0", + "inherits": "^2.0.3", + "readable-stream": "^3.1.1" + }, + "engines": { + "node": ">=6" + } + }, "node_modules/test-exclude": { "version": "6.0.0", "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz", "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==", "dev": true, + "license": "ISC", "dependencies": { "@istanbuljs/schema": "^0.1.2", "glob": "^7.1.4", @@ -5291,6 +6175,7 @@ "resolved": "https://registry.npmjs.org/text-extensions/-/text-extensions-1.9.0.tgz", "integrity": "sha512-wiBrwC1EhBelW12Zy26JeOUkQ5mRu+5o8rpsJk5+2t+Y5vE7e842qtZDQ2g1NpX/29HdyFeJ4nSIhI47ENSxlQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10" } @@ -5299,13 +6184,15 @@ "version": "2.3.8", "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz", "integrity": "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/through2": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz", "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==", "dev": true, + "license": "MIT", "dependencies": { "readable-stream": "3" } @@ -5314,13 +6201,15 @@ "version": "1.0.5", "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz", "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==", - "dev": true + "dev": true, + "license": "BSD-3-Clause" }, "node_modules/to-fast-properties": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz", "integrity": "sha512-/OaKK0xYrs3DmxRYqL/yDc+FxFUVYhDlXMhRmv3z915w2HF1tnN1omB354j8VUGO/hbRzyD6Y3sA7v7GS/ceog==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -5330,6 +6219,7 @@ "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", "dev": true, + "license": "MIT", "dependencies": { "is-number": "^7.0.0" }, @@ -5342,6 +6232,7 @@ "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.5.0.tgz", "integrity": "sha512-nlLsUzgm1kfLXSXfRZMc1KLAugd4hqJHDTvc2hDIwS3mZAfMEuMbc03SujMF+GEcpaX/qboeycw6iO8JwVv2+g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "psl": "^1.1.28", "punycode": "^2.1.1" @@ -5355,25 +6246,27 @@ "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-3.0.1.tgz", "integrity": "sha512-c1PTsA3tYrIsLGkJkzHF+w9F2EyxfXGo4UyJc4pFL++FMjnq0HJS69T3M7d//gKrFKwy429bouPescbjecU+Zw==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/ts-jest": { - "version": "29.2.4", - "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.2.4.tgz", - "integrity": "sha512-3d6tgDyhCI29HlpwIq87sNuI+3Q6GLTTCeYRHCs7vDz+/3GCMwEtV9jezLyl4ZtnBgx00I7hm8PCP8cTksMGrw==", + "version": "29.2.5", + "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.2.5.tgz", + "integrity": "sha512-KD8zB2aAZrcKIdGk4OwpJggeLcH1FgrICqDSROWqlnJXGCXK4Mn6FcdK2B6670Xr73lHMG1kHw8R87A0ecZ+vA==", "dev": true, + "license": "MIT", "dependencies": { - "bs-logger": "0.x", + "bs-logger": "^0.2.6", "ejs": "^3.1.10", - "fast-json-stable-stringify": "2.x", + "fast-json-stable-stringify": "^2.1.0", "jest-util": "^29.0.0", "json5": "^2.2.3", - "lodash.memoize": "4.x", - "make-error": "1.x", - "semver": "^7.5.3", - "yargs-parser": "^21.0.1" + "lodash.memoize": "^4.1.2", + "make-error": "^1.3.6", + "semver": "^7.6.3", + "yargs-parser": "^21.1.1" }, "bin": { "ts-jest": "cli.js" @@ -5412,6 +6305,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -5424,6 +6318,7 @@ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", "dev": true, + "license": "ISC", "engines": { "node": ">=12" } @@ -5433,6 +6328,7 @@ "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz", "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==", "dev": true, + "license": "MIT", "dependencies": { "@cspotcode/source-map-support": "^0.8.0", "@tsconfig/node10": "^1.0.7", @@ -5476,6 +6372,7 @@ "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz", "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.3.1" } @@ -5484,7 +6381,7 @@ "version": "0.6.0", "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", - "dev": true, + "license": "Apache-2.0", "dependencies": { "safe-buffer": "^5.0.1" }, @@ -5496,13 +6393,15 @@ "version": "0.14.5", "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz", "integrity": "sha512-KXXFFdAbFXY4geFIwoyNK+f5Z1b7swfXABfL7HXCmoIWMKU3dmS26672A4EeQtDzLKy7SXmfBu51JolvEKwtGA==", - "dev": true + "dev": true, + "license": "Unlicense" }, "node_modules/type-detect": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.1.0.tgz", "integrity": "sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -5512,6 +6411,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz", "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=10" }, @@ -5520,10 +6420,11 @@ } }, "node_modules/typescript": { - "version": "5.5.4", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.5.4.tgz", - "integrity": "sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==", + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.6.2.tgz", + "integrity": "sha512-NW8ByodCSNCwZeghjN3o+JX5OFH0Ojg6sadjEKY4huZ52TqbJTJnDo5+Tw98lSy63NZvi4n+ez5m2u5d4PkZyw==", "dev": true, + "license": "Apache-2.0", "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" @@ -5533,10 +6434,11 @@ } }, "node_modules/uglify-js": { - "version": "3.19.1", - "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.1.tgz", - "integrity": "sha512-y/2wiW+ceTYR2TSSptAhfnEtpLaQ4Ups5zrjB2d3kuVxHj16j/QJwPl5PvuGy9uARb39J0+iKxcRPvtpsx4A4A==", + "version": "3.19.3", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", + "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", "dev": true, + "license": "BSD-2-Clause", "optional": true, "bin": { "uglifyjs": "bin/uglifyjs" @@ -5546,10 +6448,11 @@ } }, "node_modules/undici-types": { - "version": "5.26.5", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-5.26.5.tgz", - "integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==", - "dev": true + "version": "6.19.8", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz", + "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==", + "dev": true, + "license": "MIT" }, "node_modules/update-browserslist-db": { "version": "1.1.0", @@ -5570,6 +6473,7 @@ "url": "https://github.com/sponsors/ai" } ], + "license": "MIT", "dependencies": { "escalade": "^3.1.2", "picocolors": "^1.0.1" @@ -5586,6 +6490,7 @@ "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "punycode": "^2.1.0" } @@ -5594,29 +6499,35 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", - "dev": true + "license": "MIT" }, "node_modules/uuid": { - "version": "3.4.0", - "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.4.0.tgz", - "integrity": "sha512-HjSDRw6gZE5JMggctHBcjVak08+KEVhSIiDzFnT9S9aegmp85S/bReBVTb4QTFaRNptJ9kuYaNhnbNEOkbKb/A==", - "deprecated": "Please upgrade to version 7 or higher. Older versions may use Math.random() in certain circumstances, which is known to be problematic. See https://v8.dev/blog/math-random for details.", + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz", + "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==", "dev": true, + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", "bin": { - "uuid": "bin/uuid" + "uuid": "dist/bin/uuid" } }, "node_modules/v8-compile-cache-lib": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz", "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/v8-to-istanbul": { "version": "9.3.0", "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz", "integrity": "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==", "dev": true, + "license": "ISC", "dependencies": { "@jridgewell/trace-mapping": "^0.3.12", "@types/istanbul-lib-coverage": "^2.0.1", @@ -5631,6 +6542,7 @@ "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz", "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==", "dev": true, + "license": "Apache-2.0", "dependencies": { "spdx-correct": "^3.0.0", "spdx-expression-parse": "^3.0.0" @@ -5644,6 +6556,7 @@ "engines": [ "node >=0.6.0" ], + "license": "MIT", "dependencies": { "assert-plus": "^1.0.0", "core-util-is": "1.0.2", @@ -5655,6 +6568,7 @@ "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz", "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==", "dev": true, + "license": "Apache-2.0", "dependencies": { "makeerror": "1.0.12" } @@ -5664,6 +6578,7 @@ "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", "dev": true, + "license": "ISC", "dependencies": { "isexe": "^2.0.0" }, @@ -5678,13 +6593,15 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/wrap-ansi": { "version": "7.0.0", "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", @@ -5701,13 +6618,14 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", - "dev": true + "license": "ISC" }, "node_modules/write-file-atomic": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-4.0.2.tgz", "integrity": "sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==", "dev": true, + "license": "ISC", "dependencies": { "imurmurhash": "^0.1.4", "signal-exit": "^3.0.7" @@ -5721,6 +6639,7 @@ "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.4" } @@ -5730,6 +6649,7 @@ "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", "dev": true, + "license": "ISC", "engines": { "node": ">=10" } @@ -5738,13 +6658,15 @@ "version": "4.0.0", "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/yargs": { "version": "16.2.0", "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz", "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==", "dev": true, + "license": "MIT", "dependencies": { "cliui": "^7.0.2", "escalade": "^3.1.1", @@ -5763,6 +6685,7 @@ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz", "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==", "dev": true, + "license": "ISC", "engines": { "node": ">=10" } @@ -5772,6 +6695,7 @@ "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz", "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -5781,6 +6705,7 @@ "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, diff --git a/package.json b/package.json index d975a05..c741803 100644 --- a/package.json +++ b/package.json @@ -46,17 +46,23 @@ "di0": "^1.0.0" }, "devDependencies": { - "@types/chai": "^4.3.17", - "@types/jest": "^29.5.12", - "@types/node": "^20.14.14", + "@types/better-sqlite3": "^7.6.11", + "@types/chai": "^4.3.20", + "@types/jest": "^29.5.13", + "@types/node": "^20.16.9", "@types/sinon": "^10.0.20", + "@types/uuid": "^10.0.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "coveralls": "^3.1.1", "jest": "^29.7.0", "sinon": "^15.2.0", - "ts-jest": "^29.2.4", + "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.5.4" + "typescript": "^5.6.2", + "uuid": "^10.0.0" + }, + "peerDependencies": { + "better-sqlite3": "^11.3.0" } } diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index a7da6ae..8587a77 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -2,7 +2,6 @@ import { IAggregate, IMutableAggregateState, ICommand, - Identifier, IEvent, IEventSet, IAggregateConstructorParams @@ -37,7 +36,7 @@ export abstract class AbstractAggregate const asProjectionView = (view: any): IProjectionView | undefined => (isProjectionView(view) ? view : undefined); +const isPersistentView = (view: any): view is IPersistentView => + 'getLastEvent' in view && + 'tryMarkAsProjecting' in view && + 'markAsProjected' in view; + /** * Base class for Projection definition */ @@ -42,12 +47,14 @@ export abstract class AbstractProjection { - return (this.view instanceof Map) - || (this.view instanceof InMemoryView); + throw new Error('shouldRestoreView is deprecated'); } constructor({ @@ -81,9 +89,8 @@ export abstract class AbstractProjection view : - viewFactory; + this.#view = view; + this.#viewFactory = viewFactory; this._logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : @@ -114,7 +121,17 @@ export abstract class AbstractProjection { + async #restoreAggregate(id: string): Promise { if (!id) throw new TypeError('id argument required'); diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 4886c43..5ff5740 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -4,7 +4,7 @@ import { AggregateCommandHandler } from './AggregateCommandHandler'; import { CommandBus } from './CommandBus'; import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; -import { InMemoryMessageBus } from './infrastructure/InMemoryMessageBus'; +import { InMemoryMessageBus } from './infrastructure/memory/InMemoryMessageBus'; import { getHandledMessageTypes, diff --git a/src/EventStore.ts b/src/EventStore.ts index e69de0f..ff448d0 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -1,8 +1,6 @@ import { IAggregateSnapshotStorage, - Identifier, IEvent, - IEventQueryFilter, IEventStorage, IEventSet, IExtendableLogger, @@ -11,7 +9,9 @@ import { IMessageHandler, IObservable, IEventStream, - IEventStore + IEventStore, + EventQueryAfter, + EventQueryBefore } from "./interfaces"; import { getClassName, setupOneTimeEmitterSubscription } from "./utils"; import * as Event from './Event'; @@ -83,8 +83,9 @@ export class EventStore implements IEventStore { this.#messageBus = messageBus; } + /** Retrieve new ID from the storage */ - async getNewId(): Promise { + async getNewId(): Promise { return this.#storage.getNewId(); } @@ -102,8 +103,14 @@ export class EventStore implements IEventStore { this.#logger?.debug(`${eventTypes ? eventTypes.join(', ') : 'all'} events retrieved`); } + async* getEventsByTypes(eventTypes: Readonly, options: EventQueryAfter): IEventStream { + const eventsIterable = await this.#storage.getEventsByTypes(eventTypes, options); + + yield* eventsIterable; + } + /** Retrieve all events of specific Aggregate */ - async getAggregateEvents(aggregateId: Identifier): Promise { + async getAggregateEvents(aggregateId: string): Promise { if (!aggregateId) throw new TypeError('aggregateId argument required'); @@ -127,7 +134,7 @@ export class EventStore implements IEventStore { } /** Retrieve events of specific Saga */ - async getSagaEvents(sagaId: Identifier, filter: Pick) { + async getSagaEvents(sagaId: string, filter: EventQueryBefore) { if (!sagaId) throw new TypeError('sagaId argument required'); if (!filter) diff --git a/src/index.ts b/src/index.ts index 94b96da..9bbea12 100644 --- a/src/index.ts +++ b/src/index.ts @@ -9,12 +9,12 @@ export * from './AbstractSaga'; export * from './SagaEventHandler'; export * from './AbstractProjection'; -export * from './infrastructure/InMemoryMessageBus'; -export * from './infrastructure/InMemoryEventStorage'; -export * from './infrastructure/InMemorySnapshotStorage'; -export * from './infrastructure/InMemoryView'; -export * from './infrastructure/InMemoryLock'; -export * from './infrastructure/utils/Deferred'; +export * from './infrastructure/memory/InMemoryMessageBus'; +export * from './infrastructure/memory/InMemoryEventStorage'; +export * from './infrastructure/memory/InMemorySnapshotStorage'; +export * from './infrastructure/memory/InMemoryView'; +export * from './infrastructure/memory/InMemoryLock'; +export * from './infrastructure/memory/utils/Deferred'; export * as Event from './Event'; export { diff --git a/src/infrastructure/InMemoryEventStorage.ts b/src/infrastructure/memory/InMemoryEventStorage.ts similarity index 59% rename from src/infrastructure/InMemoryEventStorage.ts rename to src/infrastructure/memory/InMemoryEventStorage.ts index 3fa6d95..4ddce9b 100644 --- a/src/infrastructure/InMemoryEventStorage.ts +++ b/src/infrastructure/memory/InMemoryEventStorage.ts @@ -1,4 +1,7 @@ -import { IEvent, IEventStorage, IEventSet, IEventStream } from "../interfaces"; +import { IEvent } from "../../interfaces/IEvent"; +import { IEventSet } from "../../interfaces/IEventSet"; +import { EventQueryAfter, IEventStorage } from "../../interfaces/IEventStorage"; +import { IEventStream } from "../../interfaces/IEventStream"; import { nextCycle } from "./utils"; /** @@ -9,7 +12,6 @@ import { nextCycle } from "./utils"; * @implements {IEventStorage} */ export class InMemoryEventStorage implements IEventStorage { - #nextId: number = 0; #events: IEventSet = []; @@ -61,8 +63,33 @@ export class InMemoryEventStorage implements IEventStorage { } } - getNewId(): number { + async* getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream { + await nextCycle(); + + let newEvents: IEventSet; + if (options?.afterEvent) { + const lastEventId = options.afterEvent.id; + if (!lastEventId) + throw new TypeError('options.afterEvent.id is required'); + + const lastEventIndex = this.#events.findIndex(e => e.id === lastEventId); + if (!lastEventIndex) + throw new TypeError(`Event "${lastEventId}" could not be found`); + + newEvents = this.#events.slice(lastEventIndex + 1); + } + else { + newEvents = this.#events; + } + + for await (const event of newEvents) { + if (!eventTypes || eventTypes.includes(event.type)) + yield event; + } + } + + getNewId(): string { this.#nextId += 1; - return this.#nextId; + return String(this.#nextId); } } diff --git a/src/infrastructure/InMemoryLock.ts b/src/infrastructure/memory/InMemoryLock.ts similarity index 61% rename from src/infrastructure/InMemoryLock.ts rename to src/infrastructure/memory/InMemoryLock.ts index dee6195..7203884 100644 --- a/src/infrastructure/InMemoryLock.ts +++ b/src/infrastructure/memory/InMemoryLock.ts @@ -1,10 +1,8 @@ -import { ILockable, ILockableWithIndication } from "../interfaces"; import { Deferred } from "./utils"; -export class InMemoryLock implements ILockableWithIndication { +export class InMemoryLock { #lockMarker: Deferred | undefined; - #innerLock: ILockable | undefined; /** * Indicates if lock is acquired @@ -13,15 +11,6 @@ export class InMemoryLock implements ILockableWithIndication { return !!this.#lockMarker; } - /** - * Creates an instance of InMemoryLock - * - * @param innerLock ILockable instance that can persist lock state outside of the current process - */ - constructor(innerLock?: ILockable) { - this.#innerLock = innerLock; - } - /** * Acquire the lock on the current instance. * Resolves when the lock is successfully acquired @@ -32,8 +21,6 @@ export class InMemoryLock implements ILockableWithIndication { try { this.#lockMarker = new Deferred(); - if (this.#innerLock) - await this.#innerLock.lock(); } catch (err: any) { try { @@ -50,14 +37,8 @@ export class InMemoryLock implements ILockableWithIndication { * Release the lock acquired earlier */ async unlock(): Promise { - try { - if (this.#innerLock) - await this.#innerLock.unlock(); - } - finally { - this.#lockMarker?.resolve(); - this.#lockMarker = undefined; - } + this.#lockMarker?.resolve(); + this.#lockMarker = undefined; } /** diff --git a/src/infrastructure/InMemoryMessageBus.ts b/src/infrastructure/memory/InMemoryMessageBus.ts similarity index 99% rename from src/infrastructure/InMemoryMessageBus.ts rename to src/infrastructure/memory/InMemoryMessageBus.ts index c8f43f3..b14548e 100644 --- a/src/infrastructure/InMemoryMessageBus.ts +++ b/src/infrastructure/memory/InMemoryMessageBus.ts @@ -4,7 +4,7 @@ import { IMessageBus, IMessageHandler, IObservable -} from "../interfaces"; +} from "../../interfaces"; /** * Default implementation of the message bus. diff --git a/src/infrastructure/InMemorySnapshotStorage.ts b/src/infrastructure/memory/InMemorySnapshotStorage.ts similarity index 66% rename from src/infrastructure/InMemorySnapshotStorage.ts rename to src/infrastructure/memory/InMemorySnapshotStorage.ts index d3fd377..a306535 100644 --- a/src/infrastructure/InMemorySnapshotStorage.ts +++ b/src/infrastructure/memory/InMemorySnapshotStorage.ts @@ -1,4 +1,5 @@ -import { IAggregateSnapshotStorage, Identifier, IEvent } from "../interfaces"; +import { IAggregateSnapshotStorage } from "../../interfaces/IAggregateSnapshotStorage"; +import { IEvent } from "../../interfaces/IEvent"; /** * In-memory storage for aggregate snapshots. @@ -6,12 +7,12 @@ import { IAggregateSnapshotStorage, Identifier, IEvent } from "../interfaces"; */ export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { - #snapshots: Map = new Map(); + #snapshots: Map = new Map(); /** * Get latest aggregate snapshot */ - async getAggregateSnapshot(aggregateId: Identifier): Promise { + async getAggregateSnapshot(aggregateId: string): Promise { return this.#snapshots.get(aggregateId); } diff --git a/src/infrastructure/InMemoryView.ts b/src/infrastructure/memory/InMemoryView.ts similarity index 85% rename from src/infrastructure/InMemoryView.ts rename to src/infrastructure/memory/InMemoryView.ts index bd678bb..a58cba7 100644 --- a/src/infrastructure/InMemoryView.ts +++ b/src/infrastructure/memory/InMemoryView.ts @@ -1,6 +1,7 @@ import { InMemoryLock } from './InMemoryLock'; -import { IProjectionView, Identifier } from "../interfaces"; import { nextCycle } from './utils'; +import { IObjectView } from '../../interfaces/IObjectView'; +import { IProjectionView } from '../../interfaces/IProjectionView'; /** * Update given value with an update Cb and return updated value. @@ -16,13 +17,13 @@ function applyUpdate(view: T | undefined, update: (r?: T) => T | undefined): /** * In-memory Projection View, which suspends get()'s until it is ready */ -export class InMemoryView implements IProjectionView { +export class InMemoryView implements IProjectionView, IObjectView { static factory(): TView { return (new InMemoryView() as unknown) as TView; } - protected _map: Map = new Map(); + protected _map: Map = new Map(); #lock: InMemoryLock; @@ -77,12 +78,12 @@ export class InMemoryView implements IProjectionView { * * @deprecated Use `async get()` instead */ - has(key: Identifier): boolean { + has(key: string): boolean { return this._map.has(key); } /** Get record with a given key; await until the view is restored */ - async get(key: Identifier, options?: { nowait?: boolean }): Promise { + async get(key: string, options?: { nowait?: boolean }): Promise { if (!key) throw new TypeError('key argument required'); @@ -95,8 +96,8 @@ export class InMemoryView implements IProjectionView { } /** Get all records matching an optional filter */ - async getAll(filter?: (r: TRecord | undefined, i: Identifier) => boolean): - Promise> { + async getAll(filter?: (r: TRecord | undefined, i: string) => boolean): + Promise> { if (filter && typeof filter !== 'function') throw new TypeError('filter argument, when defined, must be a Function'); @@ -105,7 +106,7 @@ export class InMemoryView implements IProjectionView { await nextCycle(); - const r: Array<[Identifier, TRecord | undefined]> = []; + const r: Array<[string, TRecord | undefined]> = []; for (const entry of this._map.entries()) { if (!filter || filter(entry[1], entry[0])) r.push(entry); @@ -115,7 +116,7 @@ export class InMemoryView implements IProjectionView { } /** Create record with a given key and value */ - async create(key: Identifier, value: TRecord = {} as TRecord) { + async create(key: string, value: TRecord = {} as TRecord) { if (!key) throw new TypeError('key argument required'); if (typeof value === 'function') @@ -131,7 +132,7 @@ export class InMemoryView implements IProjectionView { } /** Update existing view record */ - async update(key: Identifier, update: (r?: TRecord) => TRecord) { + async update(key: string, update: (r: TRecord) => TRecord) { if (!key) throw new TypeError('key argument required'); if (typeof update !== 'function') @@ -144,7 +145,7 @@ export class InMemoryView implements IProjectionView { } /** Update existing view record or create new */ - async updateEnforcingNew(key: Identifier, update: (r?: TRecord) => TRecord) { + async updateEnforcingNew(key: string, update: (r?: TRecord) => TRecord) { if (!key) throw new TypeError('key argument required'); if (typeof update !== 'function') @@ -170,7 +171,7 @@ export class InMemoryView implements IProjectionView { } /** Update existing record */ - private async _update(key: Identifier, update: (r?: TRecord) => TRecord) { + private async _update(key: string, update: (r?: TRecord) => TRecord) { const value = this._map.get(key); const updatedValue = applyUpdate(value, update); @@ -181,7 +182,7 @@ export class InMemoryView implements IProjectionView { } /** Delete record */ - async delete(key: Identifier) { + async delete(key: string) { if (!key) throw new TypeError('key argument required'); diff --git a/src/infrastructure/memory/index.ts b/src/infrastructure/memory/index.ts new file mode 100644 index 0000000..3ef457a --- /dev/null +++ b/src/infrastructure/memory/index.ts @@ -0,0 +1,5 @@ +export * from './InMemoryEventStorage'; +export * from './InMemoryLock'; +export * from './InMemoryMessageBus'; +export * from './InMemorySnapshotStorage'; +export * from './InMemoryView'; diff --git a/src/infrastructure/utils/Deferred.ts b/src/infrastructure/memory/utils/Deferred.ts similarity index 100% rename from src/infrastructure/utils/Deferred.ts rename to src/infrastructure/memory/utils/Deferred.ts diff --git a/src/infrastructure/utils/index.ts b/src/infrastructure/memory/utils/index.ts similarity index 100% rename from src/infrastructure/utils/index.ts rename to src/infrastructure/memory/utils/index.ts diff --git a/src/infrastructure/utils/nextCycle.ts b/src/infrastructure/memory/utils/nextCycle.ts similarity index 100% rename from src/infrastructure/utils/nextCycle.ts rename to src/infrastructure/memory/utils/nextCycle.ts diff --git a/src/infrastructure/sqlite/AbstractSqliteView.ts b/src/infrastructure/sqlite/AbstractSqliteView.ts new file mode 100644 index 0000000..8d62c79 --- /dev/null +++ b/src/infrastructure/sqlite/AbstractSqliteView.ts @@ -0,0 +1,202 @@ +import { IEvent } from '../../interfaces/IEvent'; +import { IExtendableLogger, ILogger } from '../../interfaces/ILogger'; +import { IPersistentView } from '../../interfaces/IPersistentView'; + +const guid = (str: string) => Buffer.from(str.replaceAll('-', ''), 'hex'); + +const EVENT_PROCESSING_LOCK_TTL = 15; // sec + +export type AbstractSqliteViewOptions = { + schemaVersion: string; + sqliteDb: import('better-sqlite3').Database; + viewLockTableName?: string; + logger?: IExtendableLogger | ILogger; +} + +export abstract class AbstractSqliteView implements IPersistentView { + + /** + * Version of the the schema representing the structure of the data stored in the view + */ + readonly schemaVersion: string; + + /** + * Shared table where view locks and last projected events are tracked + */ + readonly viewLockTableName: string; + + /** + * Main table where the view data is stored + * + * @example `tbl_users_${this.schemaVersion}` + */ + abstract get tableName(): string; + + /** + * Table where events are being tracked as projecting/projected + * + * @example `tbl_users_${this.schemaVersion}_event_lock` + */ + abstract get eventLockTableName(): string; + + protected db: import('better-sqlite3').Database; + protected logger: ILogger | undefined; + + #getLastEventQuery: import('better-sqlite3').Statement; + #lockEventQuery: import('better-sqlite3').Statement<[Buffer], void>; + #finalizeEventLockQuery: import('better-sqlite3').Statement<[Buffer], void>; + #recordLastEventQuery: import('better-sqlite3').Statement<[string, string, string], void>; + #upsertTableLockQuery: import('better-sqlite3').Statement<[string, string], void>; + #removeTableLockQuery: import('better-sqlite3').Statement<[string, string], void>; + + + constructor(options: AbstractSqliteViewOptions) { + this.schemaVersion = options.schemaVersion; + this.viewLockTableName = options.viewLockTableName ?? 'tbl_view_lock'; + this.db = options.sqliteDb; + this.logger = options.logger && 'child' in options.logger ? + options.logger.child({ service: this.constructor.name }) : + options.logger; + } + + /** + * SQLite tables initialization. + * Must be called in the derived class before getting to work. + */ + protected initialize(): void { + this.db.exec(` + CREATE TABLE IF NOT EXISTS ${this.viewLockTableName} ( + table_name TEXT, + schema_version TEXT, + locked_at DATETIME DEFAULT (strftime('%s', 'now')), + last_event TEXT, + PRIMARY KEY (table_name, schema_version) + ); + + CREATE TABLE IF NOT EXISTS ${this.eventLockTableName} ( + event_id BLOB PRIMARY KEY, + processing_at DATETIME DEFAULT (strftime('%s', 'now')), + processed_at DATETIME + ); + `); + + this.#getLastEventQuery = this.db.prepare(` + SELECT + last_event + FROM ${this.viewLockTableName} + WHERE + table_name = ? + AND schema_version =? + `); + + this.#lockEventQuery = this.db.prepare(` + INSERT INTO ${this.eventLockTableName} (event_id) + VALUES (?) + ON CONFLICT (event_id) + DO UPDATE SET + processing_at = strftime('%s', 'now') + WHERE + processed_at IS NULL + AND processing_at <= strftime('%s', 'now') - ${EVENT_PROCESSING_LOCK_TTL} + `); + + this.#finalizeEventLockQuery = this.db.prepare(` + UPDATE ${this.eventLockTableName} + SET + processed_at = strftime('%s', 'now') + WHERE + event_id = ? + AND processed_at IS NULL + `); + + this.#recordLastEventQuery = this.db.prepare(` + UPDATE ${this.viewLockTableName} + SET + last_event = ? + WHERE + table_name = ? + AND schema_version = ? + `); + + this.#upsertTableLockQuery = this.db.prepare(` + INSERT INTO ${this.viewLockTableName} (table_name, schema_version, locked_at) + VALUES (?, ?, strftime('%s', 'now')) + ON CONFLICT (table_name, schema_version) + DO UPDATE SET + locked_at = excluded.locked_at + WHERE + locked_at IS NULL + `); + + this.#removeTableLockQuery = this.db.prepare(` + UPDATE ${this.viewLockTableName} + SET + locked_at = NULL + WHERE + table_name = ? + AND schema_version = ? + AND locked_at IS NOT NULL + `); + } + + getLastEvent() { + const tableInfoRecord = this.#getLastEventQuery.get(this.tableName, this.schemaVersion); + if (!tableInfoRecord?.last_event) + return undefined; + + return JSON.parse(tableInfoRecord.last_event); + } + + tryMarkAsProjecting(event: IEvent) { + if (!event.id) + throw new TypeError('event.id is required'); + + const r = this.#lockEventQuery.run(guid(event.id)); + + return r.changes !== 0; + } + + markAsProjected(event: IEvent) { + if (!event.id) + throw new TypeError('event.id is required'); + + const updateResult = this.#finalizeEventLockQuery.run(guid(event.id)); + if (updateResult.changes === 0) + throw new Error(`Event ${event.id} could not be marked as processed`); + + this.#recordLastEventQuery.run(JSON.stringify(event), this.tableName, this.schemaVersion); + } + + ready: boolean = false; + + lock() { + this.ready = false; + + const upsertResult = this.#upsertTableLockQuery.run(this.tableName, this.schemaVersion); + if (upsertResult.changes === 1) + this.logger?.debug(`Table "${this.tableName}" lock obtained`); + else + this.logger?.debug(`Table "${this.tableName}" is already locked`); + + // TODO: automatic lock prolongation + + return upsertResult.changes === 1; + } + + async unlock(): Promise { + const updateResult = this.#removeTableLockQuery.run(this.tableName, this.schemaVersion); + if (updateResult.changes === 1) + this.logger?.debug(`Table "${this.tableName}" lock released`); + else + this.logger?.debug(`Table "${this.tableName}" lock didn't exist`); + + this.ready = true; + } + + async once(eventType: 'ready'): Promise { + + // TODO: periodically check until unlocked + + throw new Error('Method not implemented'); + } +} diff --git a/src/infrastructure/sqlite/ObjectSqliteView.ts b/src/infrastructure/sqlite/ObjectSqliteView.ts new file mode 100644 index 0000000..bf244e6 --- /dev/null +++ b/src/infrastructure/sqlite/ObjectSqliteView.ts @@ -0,0 +1,124 @@ +import * as BetterSqlite3 from 'better-sqlite3'; +import { AbstractSqliteView, AbstractSqliteViewOptions } from "./AbstractSqliteView"; +import { IObjectView, IPersistentView } from '../../interfaces'; + +const guid = (str: string) => Buffer.from(str.replaceAll('-', ''), 'hex'); + +export class ObjectSqliteView extends AbstractSqliteView implements IObjectView, IPersistentView { + + #tableNamePrefix: string; + #getQuery: BetterSqlite3.Statement<[Buffer], { data: string, version: number }>; + #insertQuery: BetterSqlite3.Statement<[Buffer, string], void>; + #updateByIdAndVersionQuery: BetterSqlite3.Statement<[string, Buffer, number], void>; + #deleteQuery: BetterSqlite3.Statement<[Buffer], void>; + + get tableName(): string { + return `${this.#tableNamePrefix}_${this.schemaVersion}`; + } + + get eventLockTableName(): string { + return `${this.#tableNamePrefix}_${this.schemaVersion}_event_lock`; + } + + constructor(options: AbstractSqliteViewOptions & { tableNamePrefix: string }) { + if (typeof options.tableNamePrefix !== 'string' || !options.tableNamePrefix.length) + throw new TypeError('options.tableNamePrefix argument must be a non-empty String'); + + super(options); + + this.#tableNamePrefix = options.tableNamePrefix; + + this.initialize(); + } + + protected initialize(): void { + super.initialize(); + + this.db.exec(`CREATE TABLE IF NOT EXISTS ${this.tableName} ( + id BLOB PRIMARY KEY, + version INTEGER DEFAULT 1, + data TEXT NOT NULL + );`); + + this.#getQuery = this.db.prepare(` + SELECT data, version + FROM ${this.tableName} + WHERE id = ? + `); + + this.#insertQuery = this.db.prepare(` + INSERT INTO ${this.tableName} (id, data) + VALUES (?, ?) + `); + + this.#updateByIdAndVersionQuery = this.db.prepare(` + UPDATE ${this.tableName} + SET + data = ?, + version = version + 1 + WHERE + id = ? + AND version = ? + `); + + this.#deleteQuery = this.db.prepare(` + DELETE FROM ${this.tableName} + WHERE id = ? + `); + } + + get(id: string): TRecord | undefined { + const r = this.#getQuery.get(guid(id)); + if (!r) + return undefined; + + return JSON.parse(r.data); + } + + create(id: string, data: TRecord) { + const r = this.#insertQuery.run(guid(id), JSON.stringify(data)); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be created`); + } + + update(id: string, update: (r: TRecord) => TRecord) { + const gid = guid(id); + const record = this.#getQuery.get(gid); + if (!record) + throw new Error(`Record '${id}' does not exist`); + + const data = JSON.parse(record.data); + const updatedData = update(data); + const updatedJson = JSON.stringify(updatedData); + + const r = this.#updateByIdAndVersionQuery.run(updatedJson, gid, record.version); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be updated`); + } + + updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + const gid = guid(id); + const record = this.#getQuery.get(gid); + if (record) { + const data = JSON.parse(record.data); + const updatedData = update(data); + const updatedJson = JSON.stringify(updatedData); + + const r = this.#updateByIdAndVersionQuery.run(updatedJson, gid, record.version); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be updated`); + } + else { + const newData = update(); + + const r = this.#insertQuery.run(guid(id), JSON.stringify(newData)); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be created`); + } + } + + delete(id: string): boolean { + const r = this.#deleteQuery.run(guid(id)); + return r.changes === 1; + } +} diff --git a/src/infrastructure/sqlite/index.ts b/src/infrastructure/sqlite/index.ts new file mode 100644 index 0000000..e6c6429 --- /dev/null +++ b/src/infrastructure/sqlite/index.ts @@ -0,0 +1,2 @@ +export * from './AbstractSqliteView'; +export * from './ObjectSqliteView'; diff --git a/src/interfaces.ts b/src/interfaces.ts deleted file mode 100644 index b55d4a9..0000000 --- a/src/interfaces.ts +++ /dev/null @@ -1,328 +0,0 @@ -export type Identifier = string | number; - -export interface IMessage { - /** Event or command type */ - type: string; - - aggregateId?: Identifier; - aggregateVersion?: number; - - sagaId?: Identifier; - sagaVersion?: number; - - payload?: TPayload; - context?: any; -} - -export type ICommand = IMessage; - -export type IEvent = IMessage & { - /** Unique event identifier */ - id?: string; -}; - -/** - * @deprecated Try to use `IEventStream` instead - */ -export type IEventSet = ReadonlyArray>; - -export type IEventStream = AsyncIterableIterator>; - - -/** - * Minimum aggregate interface, as it's used by default `AggregateCommandHandler` - */ -export interface IAggregate { - - /** Unique aggregate identifier */ - readonly id: Identifier; - - /** Main entry point for aggregate commands */ - handle(command: ICommand): void | Promise; - - /** List of events emitted by Aggregate as a result of handling command(s) */ - readonly changes: IEventSet; - - /** An indicator if aggregate snapshot should be taken */ - readonly shouldTakeSnapshot?: boolean; - - /** Take an aggregate state snapshot and add it to the changes queue */ - takeSnapshot(): void; -} - -export interface IMutableAggregateState { - // schemaVersion?: number; - // constructor: IAggregateStateConstructor; - mutate(event: IEvent): void; -} - -// export interface IAggregateStateConstructor extends Function { -// schemaVersion?: number; -// new(): IAggregateState; -// } - -export type IAggregateConstructorParams = { - /** Unique aggregate identifier */ - id: Identifier, - - /** Aggregate events, logged after latest snapshot */ - events?: IEventSet, - - /** Aggregate state instance */ - state?: TState -}; - -export interface IAggregateConstructor { - readonly handles?: string[]; - new(options: IAggregateConstructorParams): IAggregate; -} - -export type IAggregateFactory = - (options: IAggregateConstructorParams) => IAggregate; - -export interface ISaga { - /** Unique Saga ID */ - readonly id: Identifier; - - /** List of commands emitted by Saga */ - readonly uncommittedMessages: ICommand[]; - - /** Main entry point for Saga events */ - apply(event: IEvent): void | Promise; - - /** Reset emitted commands when they are not longer needed */ - resetUncommittedMessages(): void; - - onError?(error: Error, options: { event: IEvent, command: ICommand }): void; -} - -export type ISagaConstructorParams = { - id: Identifier, - events?: IEventSet -}; - -export type ISagaFactory = (options: ISagaConstructorParams) => ISaga; - -export interface ISagaConstructor { - new(options: ISagaConstructorParams): ISaga; - - /** List of event types that trigger new saga start */ - readonly startsWith: string[]; - - /** List of events being handled by Saga */ - readonly handles: string[]; -} - -export interface IMessageHandler { - (...args: any[]): any | Promise -}; - -export interface IObservable { - on(type: string, handler: IMessageHandler): void; - - off(type: string, handler: IMessageHandler): void; - - queue?(name: string): IObservable; -} - -export interface IObserver { - subscribe(observable: IObservable): void; -} - -/** Commands */ - -export interface ICommandBus extends IObservable { - send(commandType: string, aggregateId: Identifier, options: { payload?: object, context?: object }): - Promise; - - sendRaw(command: ICommand): - Promise; - - on(type: string, handler: IMessageHandler): void; -} - -export interface ICommandHandler extends IObserver { - subscribe(commandBus: ICommandBus): void; -} - -/** Events */ - -export type IEventQueryFilter = { - /** Get events emitted after this specific event */ - afterEvent?: IEvent; - - /** Get events emitted before this specific event */ - beforeEvent?: IEvent; -} - -export interface IEventStorage { - /** - * Create unique identifier - */ - getNewId(): Identifier | Promise; - - commitEvents(events: IEventSet): Promise; - - getEvents(eventTypes?: Readonly): IEventStream; - - getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise; - - getSagaEvents(sagaId: Identifier, options: Pick): Promise; -} - -export interface IEventStore extends IObservable { - readonly snapshotsSupported?: boolean; - - getNewId(): Identifier | Promise; - - commit(events: IEventSet): Promise; - - getAllEvents(eventTypes?: Readonly): IEventStream; - - getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise; - - getSagaEvents(sagaId: Identifier, options: Pick): Promise; - - once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; - - queue(name: string): IObservable; - - registerSagaStarters(startsWith: string[] | undefined): void; -} - -export interface IEventReceptor extends IObserver { - subscribe(eventStore: IEventStore): void; -} - -export interface IMessageBus extends IObservable { - send(command: ICommand): Promise; - publish(event: IEvent): Promise; -} - - -/** Projection */ - -export interface IProjection extends IObserver { - readonly view: TView; - - subscribe(eventStore: IEventStore): Promise; - - project(event: IEvent): Promise; -} - -export interface IProjectionConstructor { - new(c?: any): IProjection; - readonly handles?: string[]; -} - -// export type ProjectionViewFactoryParams = { -// schemaVersion: string, -// collectionName: string -// } - -export interface IViewFactory { - (): TView; -} - -export interface ILockable { - lock(): Promise; - unlock(): Promise; -} - -export interface ILockableWithIndication extends ILockable { - locked: Readonly; - once(event: 'unlocked'): Promise; -} - -export interface IProjectionView extends ILockable { - - /** - * Indicates if view is ready for new events projecting - */ - ready: boolean; - - /** - * Lock the view for external reads/writes - */ - lock(): Promise; - - /** - * Unlock external read/write operations - */ - unlock(): Promise; - - /** - * Wait till the view is ready to accept new events - */ - once(eventType: "ready"): Promise; -} - -export interface IPersistentView extends IProjectionView { - - /** - * Get last projected event - */ - getLastEvent(): Promise; - - /** - * Mark event as projecting to prevent its handling by another - * projection instance working with the same storage. - * - * @returns False value if event is already processing or processed - */ - tryMarkAsProjecting(event: IEvent): Promise; - - /** - * Mark event as projected - */ - markAsProjected(event: IEvent): Promise; -} - - -/** Snapshots */ - -type TSnapshot = { - /** - * Schema version of the data stored in `state` property. - * Snapshots with older schema versions must be passed thru a data migration before applying for a newer schema - */ - schemaVersion: string | number; - - /** - * Last event that was processed before making a snapshot - */ - lastEvent: IEvent; - - /** - * Snapshot data - */ - data: TPayload; -} - -interface ISnapshotStorage { - getSnapshot(id: Identifier): Promise; - saveSnapshot(id: Identifier, snapshot: TSnapshot): Promise; -} - -type ISnapshotEvent = IEvent>; - -export interface IAggregateSnapshotStorage { - getAggregateSnapshot(aggregateId: Identifier): Promise | undefined> | IEvent | undefined; - - saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; -} - - -/** Interfaces */ - -export interface ILogger { - log(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: { [key: string]: any }): void; - debug(message: string, meta?: { [key: string]: any }): void; - info(message: string, meta?: { [key: string]: any }): void; - warn(message: string, meta?: { [key: string]: any }): void; - error(message: string, meta?: { [key: string]: any }): void; -} - -export interface IExtendableLogger extends ILogger { - child(meta?: { [key: string]: any }): IExtendableLogger; -} diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts new file mode 100644 index 0000000..50f20dd --- /dev/null +++ b/src/interfaces/IAggregate.ts @@ -0,0 +1,55 @@ +import { ICommand } from "./ICommand"; +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; + +/** + * Minimum aggregate interface, as it's used by default `AggregateCommandHandler` + */ +export interface IAggregate { + + /** Unique aggregate identifier */ + readonly id: string; + + /** Main entry point for aggregate commands */ + handle(command: ICommand): void | Promise; + + /** List of events emitted by Aggregate as a result of handling command(s) */ + readonly changes: IEventSet; + + /** An indicator if aggregate snapshot should be taken */ + readonly shouldTakeSnapshot?: boolean; + + /** Take an aggregate state snapshot and add it to the changes queue */ + takeSnapshot(): void; +} + +export interface IMutableAggregateState { + // schemaVersion?: number; + // constructor: IAggregateStateConstructor; + mutate(event: IEvent): void; +} + +// export interface IAggregateStateConstructor extends Function { +// schemaVersion?: number; +// new(): IAggregateState; +// } + +export type IAggregateConstructorParams = { + /** Unique aggregate identifier */ + id: string, + + /** Aggregate events, logged after latest snapshot */ + events?: IEventSet, + + /** Aggregate state instance */ + state?: TState +}; + +export interface IAggregateConstructor { + readonly handles?: string[]; + new(options: IAggregateConstructorParams): IAggregate; +} + +export type IAggregateFactory = + (options: IAggregateConstructorParams) => IAggregate; + diff --git a/src/interfaces/IAggregateSnapshotStorage.ts b/src/interfaces/IAggregateSnapshotStorage.ts new file mode 100644 index 0000000..10064e0 --- /dev/null +++ b/src/interfaces/IAggregateSnapshotStorage.ts @@ -0,0 +1,7 @@ +import { IEvent } from "./IEvent"; + +export interface IAggregateSnapshotStorage { + getAggregateSnapshot(aggregateId: string): Promise | undefined> | IEvent | undefined; + + saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; +} diff --git a/src/interfaces/ICommand.ts b/src/interfaces/ICommand.ts new file mode 100644 index 0000000..95b5a2b --- /dev/null +++ b/src/interfaces/ICommand.ts @@ -0,0 +1,3 @@ +import { IMessage } from "./IMessage"; + +export type ICommand = IMessage; diff --git a/src/interfaces/ICommandBus.ts b/src/interfaces/ICommandBus.ts new file mode 100644 index 0000000..87e2f59 --- /dev/null +++ b/src/interfaces/ICommandBus.ts @@ -0,0 +1,18 @@ +import { ICommand } from "./ICommand"; +import { IEventSet } from "./IEventSet"; +import { IMessageHandler, IObservable } from "./IObservable"; +import { IObserver } from "./IObserver"; + +export interface ICommandBus extends IObservable { + send(commandType: string, aggregateId: string, options: { payload?: object, context?: object }): + Promise; + + sendRaw(command: ICommand): + Promise; + + on(type: string, handler: IMessageHandler): void; +} + +export interface ICommandHandler extends IObserver { + subscribe(commandBus: ICommandBus): void; +} diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts new file mode 100644 index 0000000..4d54f07 --- /dev/null +++ b/src/interfaces/IEvent.ts @@ -0,0 +1,6 @@ +import { IMessage } from "./IMessage"; + +export type IEvent = IMessage & { + /** Unique event identifier */ + id?: string; +}; diff --git a/src/interfaces/IEventReceptor.ts b/src/interfaces/IEventReceptor.ts new file mode 100644 index 0000000..6059e78 --- /dev/null +++ b/src/interfaces/IEventReceptor.ts @@ -0,0 +1,6 @@ +import { IEventStore } from "./IEventStore"; +import { IObserver } from "./IObserver"; + +export interface IEventReceptor extends IObserver { + subscribe(eventStore: IEventStore): void; +} diff --git a/src/interfaces/IEventSet.ts b/src/interfaces/IEventSet.ts new file mode 100644 index 0000000..fcde354 --- /dev/null +++ b/src/interfaces/IEventSet.ts @@ -0,0 +1,6 @@ +import { IEvent } from "./IEvent"; + +/** + * @deprecated Try to use `IEventStream` instead + */ +export type IEventSet = ReadonlyArray>; diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorage.ts new file mode 100644 index 0000000..d99d113 --- /dev/null +++ b/src/interfaces/IEventStorage.ts @@ -0,0 +1,31 @@ +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; +import { IEventStream } from "./IEventStream"; + +export type EventQueryAfter = { + /** Get events emitted after this specific event */ + afterEvent?: IEvent; +} + +export type EventQueryBefore = { + /** Get events emitted before this specific event */ + beforeEvent?: IEvent; +} + +export interface IEventStorage { + /** + * Create unique identifier + */ + getNewId(): string | Promise; + + commitEvents(events: IEventSet): Promise; + + getEvents(eventTypes?: Readonly): IEventStream; + + getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): + IEventStream; + + getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): Promise; + + getSagaEvents(sagaId: string, options: EventQueryBefore): Promise; +} diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts new file mode 100644 index 0000000..6ca763d --- /dev/null +++ b/src/interfaces/IEventStore.ts @@ -0,0 +1,27 @@ +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; +import { EventQueryAfter, EventQueryBefore } from "./IEventStorage"; +import { IEventStream } from "./IEventStream"; +import { IMessageHandler, IObservable } from "./IObservable"; + +export interface IEventStore extends IObservable { + readonly snapshotsSupported?: boolean; + + getNewId(): string | Promise; + + commit(events: IEventSet): Promise; + + getAllEvents(eventTypes?: Readonly): IEventStream; + + getEventsByTypes(eventTypes: Readonly, options: EventQueryAfter): IEventStream; + + getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): Promise; + + getSagaEvents(sagaId: string, options: EventQueryBefore): Promise; + + once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; + + queue(name: string): IObservable; + + registerSagaStarters(startsWith: string[] | undefined): void; +} diff --git a/src/interfaces/IEventStream.ts b/src/interfaces/IEventStream.ts new file mode 100644 index 0000000..f8c9337 --- /dev/null +++ b/src/interfaces/IEventStream.ts @@ -0,0 +1,3 @@ +import { IEvent } from "./IEvent"; + +export type IEventStream = AsyncIterableIterator>; diff --git a/src/interfaces/ILogger.ts b/src/interfaces/ILogger.ts new file mode 100644 index 0000000..329e738 --- /dev/null +++ b/src/interfaces/ILogger.ts @@ -0,0 +1,11 @@ +export interface ILogger { + log(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: { [key: string]: any }): void; + debug(message: string, meta?: { [key: string]: any }): void; + info(message: string, meta?: { [key: string]: any }): void; + warn(message: string, meta?: { [key: string]: any }): void; + error(message: string, meta?: { [key: string]: any }): void; +} + +export interface IExtendableLogger extends ILogger { + child(meta?: { [key: string]: any }): IExtendableLogger; +} diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts new file mode 100644 index 0000000..448e8aa --- /dev/null +++ b/src/interfaces/IMessage.ts @@ -0,0 +1,13 @@ +export interface IMessage { + /** Event or command type */ + type: string; + + aggregateId?: string; + aggregateVersion?: number; + + sagaId?: string; + sagaVersion?: number; + + payload?: TPayload; + context?: any; +} diff --git a/src/interfaces/IMessageBus.ts b/src/interfaces/IMessageBus.ts new file mode 100644 index 0000000..c20af13 --- /dev/null +++ b/src/interfaces/IMessageBus.ts @@ -0,0 +1,8 @@ +import { ICommand } from "./ICommand"; +import { IEvent } from "./IEvent"; +import { IObservable } from "./IObservable"; + +export interface IMessageBus extends IObservable { + send(command: ICommand): Promise; + publish(event: IEvent): Promise; +} diff --git a/src/interfaces/IObjectView.ts b/src/interfaces/IObjectView.ts new file mode 100644 index 0000000..de324c8 --- /dev/null +++ b/src/interfaces/IObjectView.ts @@ -0,0 +1,11 @@ +export interface IObjectView { + get(id: string): Promise | TRecord | undefined; + + create(id: string, r: TRecord): Promise | any; + + update(id: string, cb: (r: TRecord) => TRecord): Promise | any; + + updateEnforcingNew(id: string, cb: (r?: TRecord) => TRecord): Promise | any; + + delete(id: string): Promise | any; +} diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts new file mode 100644 index 0000000..0fc311d --- /dev/null +++ b/src/interfaces/IObservable.ts @@ -0,0 +1,11 @@ +export interface IMessageHandler { + (...args: any[]): any | Promise +}; + +export interface IObservable { + on(type: string, handler: IMessageHandler): void; + + off(type: string, handler: IMessageHandler): void; + + queue?(name: string): IObservable; +} diff --git a/src/interfaces/IObserver.ts b/src/interfaces/IObserver.ts new file mode 100644 index 0000000..6f1365f --- /dev/null +++ b/src/interfaces/IObserver.ts @@ -0,0 +1,5 @@ +import { IObservable } from "./IObservable"; + +export interface IObserver { + subscribe(observable: IObservable): void; +} diff --git a/src/interfaces/IPersistentView.ts b/src/interfaces/IPersistentView.ts new file mode 100644 index 0000000..2832c0f --- /dev/null +++ b/src/interfaces/IPersistentView.ts @@ -0,0 +1,24 @@ +import { IEvent } from "./IEvent"; +import { IProjectionView } from "./IProjectionView"; + +export interface IPersistentView extends IProjectionView { + + /** + * Get last projected event, + * so that projection state can be restored from following events + */ + getLastEvent(): Promise | IEvent | undefined; + + /** + * Mark event as projecting to prevent its handling by another + * projection instance working with the same storage. + * + * @returns False value if event is already processing or processed + */ + tryMarkAsProjecting(event: IEvent): Promise | boolean; + + /** + * Mark event as projected + */ + markAsProjected(event: IEvent): Promise | void; +} diff --git a/src/interfaces/IProjection.ts b/src/interfaces/IProjection.ts new file mode 100644 index 0000000..52819eb --- /dev/null +++ b/src/interfaces/IProjection.ts @@ -0,0 +1,20 @@ +import { IEvent } from "./IEvent"; +import { IEventStore } from "./IEventStore"; +import { IObserver } from "./IObserver"; + +export interface IProjection extends IObserver { + readonly view: TView; + + subscribe(eventStore: IEventStore): Promise; + + project(event: IEvent): Promise; +} + +export interface IProjectionConstructor { + new(c?: any): IProjection; + readonly handles?: string[]; +} + +export interface IViewFactory { + (options: { schemaVersion: string }): TView; +} diff --git a/src/interfaces/IProjectionView.ts b/src/interfaces/IProjectionView.ts new file mode 100644 index 0000000..469666a --- /dev/null +++ b/src/interfaces/IProjectionView.ts @@ -0,0 +1,22 @@ +export interface IProjectionView { + + /** + * Indicates if view is ready for new events projecting + */ + ready: boolean; + + /** + * Lock the view for external reads/writes + */ + lock(): Promise | boolean; + + /** + * Unlock external read/write operations + */ + unlock(): Promise | void; + + /** + * Wait till the view is ready to accept new events + */ + once(eventType: "ready"): Promise; +} diff --git a/src/interfaces/ISaga.ts b/src/interfaces/ISaga.ts new file mode 100644 index 0000000..a4e585c --- /dev/null +++ b/src/interfaces/ISaga.ts @@ -0,0 +1,36 @@ +import { ICommand } from "./ICommand"; +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; + +export interface ISaga { + /** Unique Saga ID */ + readonly id: string; + + /** List of commands emitted by Saga */ + readonly uncommittedMessages: ICommand[]; + + /** Main entry point for Saga events */ + apply(event: IEvent): void | Promise; + + /** Reset emitted commands when they are not longer needed */ + resetUncommittedMessages(): void; + + onError?(error: Error, options: { event: IEvent, command: ICommand }): void; +} + +export type ISagaConstructorParams = { + id: string, + events?: IEventSet +}; + +export type ISagaFactory = (options: ISagaConstructorParams) => ISaga; + +export interface ISagaConstructor { + new(options: ISagaConstructorParams): ISaga; + + /** List of event types that trigger new saga start */ + readonly startsWith: string[]; + + /** List of events being handled by Saga */ + readonly handles: string[]; +} diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts new file mode 100644 index 0000000..67b8da1 --- /dev/null +++ b/src/interfaces/index.ts @@ -0,0 +1,20 @@ +export * from './IAggregate'; +export * from './IAggregateSnapshotStorage'; +export * from './ICommand'; +export * from './ICommandBus'; +export * from './IEvent'; +export * from './IEventReceptor'; +export * from './IEventSet'; +export * from './IEventStorage'; +export * from './IEventStore'; +export * from './IEventStream'; +export * from './ILogger'; +export * from './IMessage'; +export * from './IMessageBus'; +export * from './IObjectView'; +export * from './IObservable'; +export * from './IObserver'; +export * from './IPersistentView'; +export * from './IProjection'; +export * from './IProjectionView'; +export * from './ISaga'; diff --git a/tests/integration/SqliteView.test.ts b/tests/integration/SqliteView.test.ts new file mode 100644 index 0000000..b2ee415 --- /dev/null +++ b/tests/integration/SqliteView.test.ts @@ -0,0 +1,134 @@ + +import { existsSync, unlinkSync } from 'fs'; +import { AbstractProjection, IEvent } from '../../src'; +import { ObjectSqliteView } from '../../src/infrastructure/sqlite/ObjectSqliteView'; +import * as createDb from 'better-sqlite3'; +import { v7 } from 'uuid'; + +type UserPayload = { + name: string; +} + +class MyDumbProjection extends AbstractProjection> { + + get schemaVersion() { + return '1'; + } + + constructor({ myDumbViewFactory }) { + super({ viewFactory: myDumbViewFactory }); + } + + async userCreated(e: IEvent) { + if (typeof e.aggregateId !== 'string') + throw new TypeError('e.aggregateId is required'); + if (!e.payload) + throw new TypeError('e.payload is required'); + + await this.view.create(e.aggregateId, e.payload); + } + + async userModified(e: IEvent) { + if (typeof e.aggregateId !== 'string') + throw new TypeError('e.aggregateId is required'); + if (!e.payload) + throw new TypeError('e.payload is required'); + + await this.view.update(e.aggregateId, u => e.payload); + } +} + + +describe.only('SqliteView', () => { + + let sqliteInMemoryDb: import('better-sqlite3').Database; + + const logState = () => { + console.log({ + tbl_view_lock: sqliteInMemoryDb.prepare(`SELECT * FROM tbl_view_lock`).all(), + tbl_test_1_event_lock: sqliteInMemoryDb.prepare(`SELECT * FROM tbl_test_1_event_lock`).all(), + tbl_test_1: sqliteInMemoryDb.prepare(`SELECT * FROM tbl_test_1`).all() + }); + } + + const fileName = './test.sqlite'; + + beforeEach(() => { + sqliteInMemoryDb = createDb(fileName); + + // Write-Ahead Logging (WAL) mode allows reads and writes to happen concurrently and reduces contention + // on the database. It keeps changes in a separate log file before they are flushed to the main database file + sqliteInMemoryDb.pragma('journal_mode = WAL'); + + // The synchronous pragma controls how often SQLite synchronizes writes to the filesystem. Lowering this can + // boost performance but increases the risk of data loss in the event of a crash. + sqliteInMemoryDb.pragma('synchronous = NORMAL'); + + // Limit WAL journal size to 5MB to manage disk usage in high-write scenarios. + // With WAL mode and NORMAL sync, this helps prevent excessive file growth during transactions. + sqliteInMemoryDb.pragma(`journal_size_limit = ${5 * 1024 * 1024}`); + }); + + afterEach(() => { + sqliteInMemoryDb.close(); + if (existsSync(fileName)) + unlinkSync(fileName); + }); + + // project 10_000 events (5_000 create new, 5_000 read, update, put back) + // in memory - 113 ms (88_500 events/second) + // on file system - 44_396 ms (225 events/second) + // on file system with WAL and NORMAL sync - 551 ms (18_148 events/second) + + it('handles 10_000 events within 0.5 seconds', async () => { + + const p = new MyDumbProjection({ + myDumbViewFactory: ({ schemaVersion }) => new ObjectSqliteView({ + schemaVersion, + sqliteDb: sqliteInMemoryDb, + tableNamePrefix: 'tbl_test' + }) + }); + + await p.view.lock(); + await p.view.unlock(); + + const aggregateIds = Array.from({ length: 5_000 }, () => ({ + id1: v7(), + id2: v7(), + id3: v7() + })); + + console.time(); + + for (const { id1: aggregateId, id2, id3 } of aggregateIds) { + await p.project({ + type: 'userCreated', + id: id2, + aggregateId, + payload: { + name: 'Jon' + } + }); + + await p.project({ + type: 'userModified', + id: id3, + aggregateId, + payload: { + name: 'Jon Doe' + } + }); + } + + console.timeEnd(); + + // logState(); + + // const user = await p.view.get(aggregateId); + + // expect(user).toEqual({ + // name: 'Jon Doe' + // }); + }); +}); diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index f5cff80..04ef51d 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -2,11 +2,15 @@ import { expect, assert, AssertionError } from 'chai'; import * as sinon from 'sinon'; import { AbstractProjection, InMemoryView, InMemoryEventStorage, EventStore, InMemoryMessageBus } from '../../src'; -class MyProjection extends AbstractProjection { +class MyProjection extends AbstractProjection> { static get handles() { return ['somethingHappened']; } + get schemaVersion(): string { + return 'v1'; + } + async _somethingHappened({ aggregateId, payload, context }) { return this.view.updateEnforcingNew(aggregateId, (v = {}) => { if (v.somethingHappenedCnt) @@ -31,7 +35,7 @@ describe('AbstractProjection', function () { it('returns a view storage associated with projection', () => { - const view = new InMemoryView(); + const view = new InMemoryView(); const proj = new MyProjection({ view }); expect(proj.view).to.equal(view); @@ -54,7 +58,10 @@ describe('AbstractProjection', function () { it('subscribes to all handlers defined', () => { - class ProjectionWithoutHandles extends AbstractProjection { + class ProjectionWithoutHandles extends AbstractProjection { + get schemaVersion(): string { + return 'v1'; + } somethingHappened() { } somethingHappened2() { } } @@ -68,7 +75,11 @@ describe('AbstractProjection', function () { it('ignores overridden projection methods', () => { - class ProjectionWithoutHandles extends AbstractProjection { + class ProjectionWithoutHandles extends AbstractProjection { + get schemaVersion(): string { + return 'v1'; + } + somethingHappened() { } /** overridden projection method */ diff --git a/tests/unit/CommandBus.test.ts b/tests/unit/CommandBus.test.ts index d763a40..3181ec3 100644 --- a/tests/unit/CommandBus.test.ts +++ b/tests/unit/CommandBus.test.ts @@ -1,7 +1,6 @@ import { expect } from 'chai'; import * as sinon from 'sinon'; -import { InMemoryMessageBus } from '../../src/infrastructure/InMemoryMessageBus'; -import { CommandBus } from '../../src/CommandBus'; +import { InMemoryMessageBus, CommandBus } from '../../src'; describe('CommandBus', function () { diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index b0a2ef5..1983d57 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -1,10 +1,8 @@ import { expect } from 'chai'; import * as sinon from 'sinon'; import { EventStore } from '../../src/EventStore'; -import { InMemoryEventStorage } from '../../src/infrastructure/InMemoryEventStorage'; -import { InMemorySnapshotStorage } from '../../src/infrastructure/InMemorySnapshotStorage'; -import { InMemoryMessageBus } from '../../src/infrastructure/InMemoryMessageBus'; -import { IAggregateSnapshotStorage, IEvent, IEventStorage, IEventStore, IEventSet, IMessageBus } from '../../src/interfaces'; +import { InMemoryEventStorage, InMemorySnapshotStorage, InMemoryMessageBus } from '../../src'; +import { IAggregateSnapshotStorage, IEvent, IEventStorage, IEventStore, IMessageBus } from '../../src/interfaces'; const goodContext = { uid: '1', @@ -189,7 +187,7 @@ describe('EventStore', function () { describe('getNewId', () => { it('retrieves a unique ID for new aggregate from storage', () => Promise.resolve(es.getNewId()).then(id => { - expect(id).to.equal(1); + expect(id).to.equal('1'); })); }); diff --git a/tests/unit/InMemoryView.test.ts b/tests/unit/InMemoryView.test.ts index 7bdb6e7..d2b6e26 100644 --- a/tests/unit/InMemoryView.test.ts +++ b/tests/unit/InMemoryView.test.ts @@ -1,6 +1,6 @@ -import { InMemoryView } from '../../src/infrastructure/InMemoryView'; +import { InMemoryView } from '../../src'; import { expect, assert } from 'chai'; -import { nextCycle } from '../../src/infrastructure/utils'; +import { nextCycle } from '../../src/infrastructure/memory/utils'; describe('InMemoryView', function () { From bb489d99085da04398d630f864aa94757247e130 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Oct 2024 17:05:13 +0100 Subject: [PATCH 002/169] Fix merge --- src/CommandBus.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/CommandBus.ts b/src/CommandBus.ts index 56b08f2..e7cfbbf 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -1,4 +1,4 @@ -import { InMemoryMessageBus } from "./infrastructure/InMemoryMessageBus"; +import { InMemoryMessageBus } from "./infrastructure/memory"; import { ICommand, ICommandBus, From 79257e59d322df5dd8e41bedf5273c97ae77b609 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Oct 2024 18:14:56 +0100 Subject: [PATCH 003/169] Change: Remove `publishAsync` setting, simplify publishing sequence --- src/EventStore.ts | 94 +++++++++++------------------------ src/interfaces/IObservable.ts | 9 ++++ src/utils/CompoundEmitter.ts | 45 +++++++++++++++++ src/utils/index.ts | 8 +-- src/utils/isIObservable.ts | 7 +++ tests/unit/EventStore.test.ts | 23 +-------- 6 files changed, 95 insertions(+), 91 deletions(-) create mode 100644 src/utils/CompoundEmitter.ts create mode 100644 src/utils/isIObservable.ts diff --git a/src/EventStore.ts b/src/EventStore.ts index 4840523..80d4965 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -13,7 +13,12 @@ import { EventQueryAfter, EventQueryBefore } from "./interfaces"; -import { getClassName, setupOneTimeEmitterSubscription } from "./utils"; +import { + getClassName, + setupOneTimeEmitterSubscription, + isIObservable, + CompoundEmitter +} from "./utils"; import * as Event from './Event'; const isIEventStorage = (storage: IEventStorage): storage is IEventStorage => @@ -24,13 +29,6 @@ const isIEventStorage = (storage: IEventStorage): storage is IEventStorage => && typeof storage.getAggregateEvents === 'function' && typeof storage.getSagaEvents === 'function'; -const isIObservable = (obj: IObservable | any): obj is IObservable => - obj - && 'on' in obj - && typeof obj.on === 'function' - && 'off' in obj - && typeof obj.off === 'function'; - const isIMessageBus = (bus: IMessageBus | any): bus is IMessageBus => bus && isIObservable(bus) @@ -43,14 +41,13 @@ const SNAPSHOT_EVENT_TYPE = 'snapshot'; export class EventStore implements IEventStore { - #publishAsync: boolean; #validator: (event: IEvent) => void; #logger?: ILogger; #storage: IEventStorage; #messageBus?: IMessageBus; #snapshotStorage: IAggregateSnapshotStorage | undefined; #sagaStarters: string[] = []; - #defaultEventEmitter: IObservable; + #compoundEmitter: CompoundEmitter; /** Whether storage supports aggregate snapshots */ get snapshotsSupported(): boolean { @@ -62,16 +59,12 @@ export class EventStore implements IEventStore { messageBus, snapshotStorage, eventValidator = Event.validate, - eventStoreConfig, logger }: { storage: IEventStorage, messageBus?: IMessageBus, snapshotStorage?: IAggregateSnapshotStorage, eventValidator?: IMessageHandler, - eventStoreConfig?: { - publishAsync?: boolean - }, logger?: ILogger | IExtendableLogger }) { if (!storage) @@ -80,14 +73,7 @@ export class EventStore implements IEventStore { throw new TypeError('storage does not implement IEventStorage interface'); if (messageBus && !isIMessageBus(messageBus)) throw new TypeError('messageBus does not implement IMessageBus interface'); - if (messageBus && isIObservable(storage)) - throw new TypeError('both storage and messageBus implement IObservable interface, it is not yet supported'); - const defaultEventEmitter = isIObservable(storage) ? storage : messageBus; - if (!defaultEventEmitter) - throw new TypeError('storage must implement IObservable if messageBus is not injected'); - - this.#publishAsync = eventStoreConfig?.publishAsync ?? true; this.#validator = eventValidator; this.#logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : @@ -95,7 +81,7 @@ export class EventStore implements IEventStore { this.#storage = storage; this.#snapshotStorage = snapshotStorage; this.#messageBus = messageBus; - this.#defaultEventEmitter = defaultEventEmitter; + this.#compoundEmitter = new CompoundEmitter(messageBus, storage); } @@ -183,10 +169,10 @@ export class EventStore implements IEventStore { /** * Validate events, commit to storage and publish to messageBus, if needed * - * @param {IEventSet} events - a set of events to commit - * @returns {Promise} - resolves to signed and committed events + * @param events - a set of events to commit + * @returns Signed and committed events */ - async commit(events) { + async commit(events: IEventSet): Promise { if (!Array.isArray(events)) throw new TypeError('events argument must be an Array'); @@ -195,12 +181,12 @@ export class EventStore implements IEventStore { await this.#attachSagaIdToSagaStarterEvents(events) : events; - const eventStreamWithoutSnapshots = await this.save(augmentedEvents); + const eventStreamWithoutSnapshots = await this.persistEventsAndSnapshots(augmentedEvents); // after events are saved to the persistent storage, // publish them to the event bus (i.e. RabbitMq) if (this.#messageBus) - await this.#publish(eventStreamWithoutSnapshots); + await this.publishEvents(eventStreamWithoutSnapshots); return eventStreamWithoutSnapshots; } @@ -225,8 +211,12 @@ export class EventStore implements IEventStore { return augmentedEvents; } - /** Save events to the persistent storage(s) */ - async save(events: IEventSet): Promise { + /** + * Save events and snapshots to the persistent storages + * + * @returns Event set without "snapshot" events + */ + protected async persistEventsAndSnapshots(events: IEventSet): Promise { if (!Array.isArray(events)) throw new TypeError('events argument must be an Array'); @@ -253,20 +243,11 @@ export class EventStore implements IEventStore { return eventsWithoutSnapshot; } - async #publish(events: IEventSet) { - if (this.#publishAsync) { - this.#logger?.debug(`publishing ${Event.describeMultiple(events)} asynchronously...`); - setImmediate(() => this.#publishEvents(events)); - } - else { - this.#logger?.debug(`publishing ${Event.describeMultiple(events)} synchronously...`); - await this.#publishEvents(events); - } - } - - async #publishEvents(events: IEventSet) { + protected async publishEvents(events: IEventSet) { if (!this.#messageBus) - return; + throw new Error('No messageBus injected, events cannot be published'); + + this.#logger?.debug(`publishing ${Event.describeMultiple(events)}...`); try { await Promise.all(events.map(event => @@ -282,41 +263,22 @@ export class EventStore implements IEventStore { } } - /** Setup a listener for a specific event type */ on(messageType: string, handler: IMessageHandler) { - if (typeof messageType !== 'string' || !messageType.length) - throw new TypeError('messageType argument must be a non-empty String'); - if (typeof handler !== 'function') - throw new TypeError('handler argument must be a Function'); - if (arguments.length !== 2) - throw new TypeError(`2 arguments are expected, but ${arguments.length} received`); - - if (isIObservable(this.#storage)) - this.#storage.on(messageType, handler); - - this.#messageBus?.on(messageType, handler); + this.#compoundEmitter.on(messageType, handler); } - /** Remove previously installed listener */ off(messageType: string, handler: IMessageHandler) { - if (isIObservable(this.#storage)) - this.#storage.off(messageType, handler); - - this.#messageBus?.off(messageType, handler); + this.#compoundEmitter.off(messageType, handler); } - /** Get or create a named queue, which delivers events to a single handler only */ queue(name: string): IObservable { - if (!this.#defaultEventEmitter.queue) - throw new Error('Named queues are not supported by the underlying message bus'); - - return this.#defaultEventEmitter.queue(name); + return this.#compoundEmitter.queue(name); } /** Creates one-time subscription for one or multiple events that match a filter */ - once(messageTypes: string | string[], handler: IMessageHandler, filter: (e: IEvent) => boolean): Promise { + once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise { const subscribeTo = Array.isArray(messageTypes) ? messageTypes : [messageTypes]; - return setupOneTimeEmitterSubscription(this.#defaultEventEmitter, subscribeTo, filter, handler, this.#logger); + return setupOneTimeEmitterSubscription(this.#compoundEmitter, subscribeTo, filter, handler, this.#logger); } } diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts index 0fc311d..dc824fd 100644 --- a/src/interfaces/IObservable.ts +++ b/src/interfaces/IObservable.ts @@ -3,9 +3,18 @@ export interface IMessageHandler { }; export interface IObservable { + /** + * Setup a listener for a specific event type + */ on(type: string, handler: IMessageHandler): void; + /** + * Remove previously installed listener + */ off(type: string, handler: IMessageHandler): void; + /** + * Get or create a named queue, which delivers events to a single handler only + */ queue?(name: string): IObservable; } diff --git a/src/utils/CompoundEmitter.ts b/src/utils/CompoundEmitter.ts new file mode 100644 index 0000000..3e2c2a5 --- /dev/null +++ b/src/utils/CompoundEmitter.ts @@ -0,0 +1,45 @@ +import { IObservable, IMessageHandler } from "../interfaces"; +import { isIObservable } from "./isIObservable"; + +interface IObservableQueueProvider extends Required> { } + +const isObservableQueueProvider = (obj: any): obj is IObservableQueueProvider => + obj + && 'queue' in obj + && typeof obj.queue === 'function'; + +export class CompoundEmitter implements IObservable { + + #emitters: IObservable[]; + #queueProvider?: IObservableQueueProvider; + + constructor(...emitters: any[]) { + const observableEmitters = emitters.filter(isIObservable); + if (!observableEmitters.length) + throw new TypeError('none of the arguments implement IObservable interface'); + + const queueProviders = emitters.filter(isObservableQueueProvider); + if (queueProviders.length > 1) + throw new TypeError('more than one argument implements IObservable `queue` method'); + + this.#emitters = observableEmitters; + this.#queueProvider = queueProviders[0]; + } + + on(type: string, handler: IMessageHandler): void { + for (const emitter of this.#emitters) + emitter.on(type, handler); + } + + off(type: string, handler: IMessageHandler): void { + for (const emitter of this.#emitters) + emitter.off(type, handler); + } + + queue(name: string): IObservable { + if (!this.#queueProvider) + throw new Error('none of the emitters support named queues'); + + return this.#queueProvider.queue(name); + } +} diff --git a/src/utils/index.ts b/src/utils/index.ts index d95765f..ccd8c88 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,8 +1,10 @@ +export * from './CompoundEmitter'; export * from './getClassName'; +export * from './getHandledMessageTypes'; export * from './getHandler'; -export * from './validateHandlers'; export * from './getMessageHandlerNames'; -export * from './getHandledMessageTypes'; +export * from './isClass'; +export * from './isIObservable'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; -export * from './isClass'; +export * from './validateHandlers'; diff --git a/src/utils/isIObservable.ts b/src/utils/isIObservable.ts new file mode 100644 index 0000000..191627c --- /dev/null +++ b/src/utils/isIObservable.ts @@ -0,0 +1,7 @@ +import { IObservable } from "../interfaces"; + +export const isIObservable = (obj: IObservable | any): obj is IObservable => obj + && 'on' in obj + && typeof obj.on === 'function' + && 'off' in obj + && typeof obj.off === 'function'; diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index 1983d57..9816fe3 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -161,27 +161,6 @@ describe('EventStore', function () { expect(err).to.have.property('message', 'storage commit failure'); }); }); - - it('emits events asynchronously after processing is done', function (done) { - - let committed = 0; - let emitted = 0; - - es.on('somethingHappened', function (event) { - - expect(committed).to.not.equal(0); - expect(emitted).to.equal(0); - emitted++; - - expect(event).to.have.property('type', 'somethingHappened'); - expect(event).to.have.property('context'); - expect(event.context).to.have.property('ip', goodContext.ip); - - done(); - }); - - es.commit([goodEvent]).then(() => committed++).catch(done); - }); }); describe('getNewId', () => { @@ -288,7 +267,7 @@ describe('EventStore', function () { it('sets up multiple handlers for same messageType, when queue name is not defined (Projections)', () => { - es = new EventStore({ storage, eventStoreConfig: { publishAsync: false }, messageBus }); + es = new EventStore({ storage, messageBus }); const projection1Handler = sinon.spy(); const projection2Handler = sinon.spy(); From 0a3bd6fdb090a427896d1d607ec314915e93c188 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Oct 2024 18:34:44 +0100 Subject: [PATCH 004/169] Fix tests --- examples/user-domain-tests/index.test.js | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/examples/user-domain-tests/index.test.js b/examples/user-domain-tests/index.test.js index 6d9bb19..2b87755 100644 --- a/examples/user-domain-tests/index.test.js +++ b/examples/user-domain-tests/index.test.js @@ -55,8 +55,7 @@ describe('user-domain example', () => { const { commandBus, eventStore, users } = container; - // HACK: let projection restoring to start before emitting new events - await nextCycle(); + const userCreatedPromise = eventStore.once('userCreated'); await commandBus.send('createUser', undefined, { payload: { @@ -65,7 +64,7 @@ describe('user-domain example', () => { } }); - const userCreated = await eventStore.once('userCreated'); + const userCreated = await userCreatedPromise; const viewRecord = await users.get(userCreated.aggregateId); From c7a0c090f802a7e066766f0257619537eac68c53 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 17 Oct 2024 21:51:53 +0100 Subject: [PATCH 005/169] Make local events publishing sequential --- src/EventStore.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/EventStore.ts b/src/EventStore.ts index 80d4965..4c30ca8 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -250,8 +250,8 @@ export class EventStore implements IEventStore { this.#logger?.debug(`publishing ${Event.describeMultiple(events)}...`); try { - await Promise.all(events.map(event => - this.#messageBus?.publish(event))); + for (const event of events) + this.#messageBus.publish(event); this.#logger?.debug(`${Event.describeMultiple(events)} published`); } From 412fd4775c624da2f2ba282d06d8bed732757c45 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 17 Oct 2024 21:52:43 +0100 Subject: [PATCH 006/169] Include tests/integration in "test:integration" npm script --- .editorconfig | 1 + package.json | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/.editorconfig b/.editorconfig index e81eb91..55cf59a 100644 --- a/.editorconfig +++ b/.editorconfig @@ -35,6 +35,7 @@ indent_size = 2 [*.json] indent_style = space indent_size = 4 +insert_final_newline = false [*.yml] indent_style = space diff --git a/package.json b/package.json index add9116..eb6178f 100644 --- a/package.json +++ b/package.json @@ -28,7 +28,7 @@ "test": "jest --verbose tests/unit", "test:coverage": "jest --collect-coverage tests/unit", "pretest:integration": "npm run build", - "test:integration": "jest --verbose examples/user-domain-tests", + "test:integration": "jest --verbose tests/integration examples/user-domain-tests", "pretest:coveralls": "npm run test:coverage", "test:coveralls": "cat ./coverage/lcov.info | coveralls", "posttest:coveralls": "rm -rf ./coverage", @@ -65,4 +65,4 @@ "peerDependencies": { "better-sqlite3": "^11.3.0" } -} +} \ No newline at end of file From 80e9bd5007225db0149b89dceea59e7ba70ee3c9 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 24 Feb 2025 20:14:44 +0000 Subject: [PATCH 007/169] Fix merge --- src/infrastructure/memory/InMemoryView.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/infrastructure/memory/InMemoryView.ts b/src/infrastructure/memory/InMemoryView.ts index f851c46..8ed5a91 100644 --- a/src/infrastructure/memory/InMemoryView.ts +++ b/src/infrastructure/memory/InMemoryView.ts @@ -23,7 +23,7 @@ export class InMemoryView implements IProjectionView, IObjectView = new Map(); + protected _map: Map = new Map(); #lock: InMemoryLock; @@ -98,7 +98,7 @@ export class InMemoryView implements IProjectionView, IObjectView Date: Mon, 24 Feb 2025 21:27:06 +0000 Subject: [PATCH 008/169] Fix failed test error reporting --- tests/integration/SqliteView.test.ts | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tests/integration/SqliteView.test.ts b/tests/integration/SqliteView.test.ts index b2ee415..1c73b05 100644 --- a/tests/integration/SqliteView.test.ts +++ b/tests/integration/SqliteView.test.ts @@ -70,7 +70,8 @@ describe.only('SqliteView', () => { }); afterEach(() => { - sqliteInMemoryDb.close(); + if (sqliteInMemoryDb) + sqliteInMemoryDb.close(); if (existsSync(fileName)) unlinkSync(fileName); }); From 5976ca309dbd1693af2d4dbcc2041c2e8f2e4749 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 6 Mar 2025 01:53:03 +0000 Subject: [PATCH 009/169] Refactoring --- src/AbstractProjection.ts | 8 +- src/AggregateCommandHandler.ts | 5 +- src/EventStore.ts | 84 ++++-------- src/SagaEventHandler.ts | 6 +- .../memory/InMemoryEventStorage.ts | 47 ++----- src/infrastructure/memory/InMemoryView.ts | 18 +-- src/interfaces/IEventStorage.ts | 9 +- src/interfaces/IEventStore.ts | 8 +- src/utils/index.ts | 3 + src/utils/isIEventStorage.ts | 8 ++ src/utils/isIMessageBus.ts | 9 ++ src/utils/iteratorToArray.ts | 6 + tests/unit/AbstractProjection.test.ts | 20 +-- tests/unit/AggregateCommandHandler.test.ts | 6 +- tests/unit/CqrsContainerBuilder.test.ts | 4 +- tests/unit/EventStore.test.ts | 58 ++++---- tests/unit/InMemoryEventStorage.test.ts | 127 ++++++++++++++++++ tests/unit/SagaEventHandler.test.ts | 8 +- 18 files changed, 262 insertions(+), 172 deletions(-) create mode 100644 src/utils/isIEventStorage.ts create mode 100644 src/utils/isIMessageBus.ts create mode 100644 src/utils/iteratorToArray.ts create mode 100644 tests/unit/InMemoryEventStorage.test.ts diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index de88f77..a05d3f5 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -152,8 +152,8 @@ export abstract class AbstractProjection { if (!eventStore) throw new TypeError('eventStore argument required'); - if (typeof eventStore.getAllEvents !== 'function') - throw new TypeError('eventStore.getAllEvents must be a Function'); + if (typeof eventStore.getEventsByTypes !== 'function') + throw new TypeError('eventStore.getEventsByTypes must be a Function'); this._logger?.debug('retrieving last event projected'); @@ -164,9 +164,7 @@ export abstract class AbstractProjection - storage - && typeof storage.getNewId === 'function' - && typeof storage.commitEvents === 'function' - && typeof storage.getEvents === 'function' - && typeof storage.getAggregateEvents === 'function' - && typeof storage.getSagaEvents === 'function'; - -const isIMessageBus = (bus: IMessageBus | any): bus is IMessageBus => - bus - && isIObservable(bus) - && 'send' in bus - && typeof bus.send === 'function' - && 'publish' in bus - && typeof bus.publish === 'function'; - const SNAPSHOT_EVENT_TYPE = 'snapshot'; export class EventStore implements IEventStore { @@ -44,7 +29,7 @@ export class EventStore implements IEventStore { #validator: (event: IEvent) => void; #logger?: ILogger; #storage: IEventStorage; - #messageBus?: IMessageBus; + #supplementaryEventBus?: IMessageBus; #snapshotStorage: IAggregateSnapshotStorage | undefined; #sagaStarters: string[] = []; #compoundEmitter: CompoundEmitter; @@ -56,13 +41,15 @@ export class EventStore implements IEventStore { constructor({ storage, - messageBus, + supplementaryEventBus, snapshotStorage, eventValidator = Event.validate, logger }: { storage: IEventStorage, - messageBus?: IMessageBus, + + /** Optional event dispatcher for publishing persisted events externally */ + supplementaryEventBus?: IMessageBus, snapshotStorage?: IAggregateSnapshotStorage, eventValidator?: IMessageHandler, logger?: ILogger | IExtendableLogger @@ -71,8 +58,8 @@ export class EventStore implements IEventStore { throw new TypeError('storage argument required'); if (!isIEventStorage(storage)) throw new TypeError('storage does not implement IEventStorage interface'); - if (messageBus && !isIMessageBus(messageBus)) - throw new TypeError('messageBus does not implement IMessageBus interface'); + if (supplementaryEventBus && !isIMessageBus(supplementaryEventBus)) + throw new TypeError('supplementaryEventBus does not implement IMessageBus interface'); this.#validator = eventValidator; this.#logger = logger && 'child' in logger ? @@ -80,8 +67,8 @@ export class EventStore implements IEventStore { logger; this.#storage = storage; this.#snapshotStorage = snapshotStorage; - this.#messageBus = messageBus; - this.#compoundEmitter = new CompoundEmitter(messageBus, storage); + this.#supplementaryEventBus = supplementaryEventBus; + this.#compoundEmitter = new CompoundEmitter(supplementaryEventBus, storage); } @@ -90,28 +77,21 @@ export class EventStore implements IEventStore { return this.#storage.getNewId(); } - /** Retrieve all events of specific types */ - async* getAllEvents(eventTypes?: string[]): IEventStream { - if (eventTypes && !Array.isArray(eventTypes)) - throw new TypeError('eventTypes, if specified, must be an Array'); - - this.#logger?.debug(`retrieving ${eventTypes ? eventTypes.join(', ') : 'all'} events...`); - - const eventsIterable = await this.#storage.getEvents(eventTypes); - - yield* eventsIterable; + async* getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream { + if (!Array.isArray(eventTypes)) + throw new TypeError('eventTypes argument must be an Array'); - this.#logger?.debug(`${eventTypes ? eventTypes.join(', ') : 'all'} events retrieved`); - } + this.#logger?.debug(`retrieving ${eventTypes.join(', ')} events...`); - async* getEventsByTypes(eventTypes: Readonly, options: EventQueryAfter): IEventStream { const eventsIterable = await this.#storage.getEventsByTypes(eventTypes, options); yield* eventsIterable; + + this.#logger?.debug(`${eventTypes.join(', ')} events retrieved`); } /** Retrieve all events of specific Aggregate */ - async getAggregateEvents(aggregateId: string): Promise { + async* getAggregateEvents(aggregateId: string): IEventStream { if (!aggregateId) throw new TypeError('aggregateId argument required'); @@ -121,21 +101,18 @@ export class EventStore implements IEventStore { await this.#snapshotStorage.getAggregateSnapshot(aggregateId) : undefined; - const events: IEvent[] = []; if (snapshot) - events.push(snapshot); + yield snapshot; const eventsIterable = await this.#storage.getAggregateEvents(aggregateId, { snapshot }); - for await (const event of eventsIterable) - events.push(event); - this.#logger?.debug(`${Event.describeMultiple(events)} retrieved`); + yield* eventsIterable; - return events; + this.#logger?.debug(`all events for aggregate ${aggregateId} retrieved`); } /** Retrieve events of specific Saga */ - async getSagaEvents(sagaId: string, filter: EventQueryBefore) { + async* getSagaEvents(sagaId: string, filter: EventQueryBefore) { if (!sagaId) throw new TypeError('sagaId argument required'); if (!filter) @@ -147,14 +124,11 @@ export class EventStore implements IEventStore { this.#logger?.debug(`retrieving event stream for saga ${sagaId}, v${filter.beforeEvent.sagaVersion}...`); - const events: IEvent[] = []; const eventsIterable = await this.#storage.getSagaEvents(sagaId, filter); - for await (const event of eventsIterable) - events.push(event); - this.#logger?.debug(`${Event.describeMultiple(events)} retrieved`); + yield* eventsIterable; - return events; + this.#logger?.debug(`all events for saga ${sagaId} retrieved`); } /** @@ -185,7 +159,7 @@ export class EventStore implements IEventStore { // after events are saved to the persistent storage, // publish them to the event bus (i.e. RabbitMq) - if (this.#messageBus) + if (this.#supplementaryEventBus) await this.publishEvents(eventStreamWithoutSnapshots); return eventStreamWithoutSnapshots; @@ -244,14 +218,14 @@ export class EventStore implements IEventStore { } protected async publishEvents(events: IEventSet) { - if (!this.#messageBus) - throw new Error('No messageBus injected, events cannot be published'); + if (!this.#supplementaryEventBus) + throw new Error('No supplementaryEventBus injected, events cannot be published'); this.#logger?.debug(`publishing ${Event.describeMultiple(events)}...`); try { for (const event of events) - this.#messageBus.publish(event); + this.#supplementaryEventBus.publish(event); this.#logger?.debug(`${Event.describeMultiple(events)} published`); } diff --git a/src/SagaEventHandler.ts b/src/SagaEventHandler.ts index b66c639..6b538b3 100644 --- a/src/SagaEventHandler.ts +++ b/src/SagaEventHandler.ts @@ -14,7 +14,8 @@ import { import { subscribe, - getClassName + getClassName, + iteratorToArray } from './utils'; /** @@ -151,7 +152,8 @@ export class SagaEventHandler implements IEventReceptor { if (!event.sagaId) throw new TypeError(`${Event.describe(event)} does not contain sagaId`); - const events = await this.#eventStore.getSagaEvents(event.sagaId, { beforeEvent: event }); + const eventsIterable = this.#eventStore.getSagaEvents(event.sagaId, { beforeEvent: event }); + const events = await iteratorToArray(eventsIterable); const saga = this.#sagaFactory.call(null, { id: event.sagaId, events }); this.#logger?.info(`Saga state restored from ${events.length} event(s)`); diff --git a/src/infrastructure/memory/InMemoryEventStorage.ts b/src/infrastructure/memory/InMemoryEventStorage.ts index 4ddce9b..c78dc36 100644 --- a/src/infrastructure/memory/InMemoryEventStorage.ts +++ b/src/infrastructure/memory/InMemoryEventStorage.ts @@ -7,9 +7,6 @@ import { nextCycle } from "./utils"; /** * A simple event storage implementation intended to use for tests only. * Storage content resets on each app restart. - * - * @class InMemoryEventStorage - * @implements {IEventStorage} */ export class InMemoryEventStorage implements IEventStorage { #nextId: number = 0; @@ -25,11 +22,11 @@ export class InMemoryEventStorage implements IEventStorage { return events; } - async getAggregateEvents(aggregateId, options?: { snapshot: IEvent }): Promise { + async *getAggregateEvents(aggregateId, options?: { snapshot: IEvent }): IEventStream { await nextCycle(); const afterVersion = options?.snapshot?.aggregateVersion; - const result = !afterVersion ? + const results = !afterVersion ? this.#events.filter(e => e.aggregateId == aggregateId) : this.#events.filter(e => e.aggregateId == aggregateId && @@ -38,10 +35,10 @@ export class InMemoryEventStorage implements IEventStorage { await nextCycle(); - return result; + yield* results; } - async getSagaEvents(sagaId, { beforeEvent }): Promise { + async *getSagaEvents(sagaId, { beforeEvent }): IEventStream { await nextCycle(); const results = this.#events.filter(e => @@ -51,39 +48,21 @@ export class InMemoryEventStorage implements IEventStorage { await nextCycle(); - return results; - } - - async* getEvents(eventTypes): IEventStream { - await nextCycle(); - - for await (const event of this.#events) { - if (!eventTypes || eventTypes.includes(event.type)) - yield event; - } + yield* results; } async* getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream { await nextCycle(); - let newEvents: IEventSet; - if (options?.afterEvent) { - const lastEventId = options.afterEvent.id; - if (!lastEventId) - throw new TypeError('options.afterEvent.id is required'); - - const lastEventIndex = this.#events.findIndex(e => e.id === lastEventId); - if (!lastEventIndex) - throw new TypeError(`Event "${lastEventId}" could not be found`); - - newEvents = this.#events.slice(lastEventIndex + 1); - } - else { - newEvents = this.#events; - } + const lastEventId = options?.afterEvent?.id; + if (options?.afterEvent && !lastEventId) + throw new TypeError('options.afterEvent.id is required'); - for await (const event of newEvents) { - if (!eventTypes || eventTypes.includes(event.type)) + let offsetFound = !lastEventId; + for (const event of this.#events) { + if (!offsetFound) + offsetFound = event.id === lastEventId; + else if (!eventTypes || eventTypes.includes(event.type)) yield event; } } diff --git a/src/infrastructure/memory/InMemoryView.ts b/src/infrastructure/memory/InMemoryView.ts index 8ed5a91..47ede46 100644 --- a/src/infrastructure/memory/InMemoryView.ts +++ b/src/infrastructure/memory/InMemoryView.ts @@ -27,8 +27,6 @@ export class InMemoryView implements IProjectionView, IObjectView implements IProjectionView, IObjectView implements IProjectionView, IObjectView implements IProjectionView, IObjectView implements IProjectionView, IObjectView; - getEvents(eventTypes?: Readonly): IEventStream; + getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; - getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): - IEventStream; + getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): Promise | IEventStream; - getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): Promise; - - getSagaEvents(sagaId: string, options: EventQueryBefore): Promise; + getSagaEvents(sagaId: string, options: EventQueryBefore): Promise | IEventStream; } diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index 6ca763d..bba8c38 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -11,13 +11,11 @@ export interface IEventStore extends IObservable { commit(events: IEventSet): Promise; - getAllEvents(eventTypes?: Readonly): IEventStream; + getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; - getEventsByTypes(eventTypes: Readonly, options: EventQueryAfter): IEventStream; + getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): IEventStream; - getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): Promise; - - getSagaEvents(sagaId: string, options: EventQueryBefore): Promise; + getSagaEvents(sagaId: string, options: EventQueryBefore): IEventStream; once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; diff --git a/src/utils/index.ts b/src/utils/index.ts index ccd8c88..848eb58 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -4,7 +4,10 @@ export * from './getHandledMessageTypes'; export * from './getHandler'; export * from './getMessageHandlerNames'; export * from './isClass'; +export * from './isIEventStorage'; +export * from './isIMessageBus'; export * from './isIObservable'; +export * from './iteratorToArray'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; export * from './validateHandlers'; diff --git a/src/utils/isIEventStorage.ts b/src/utils/isIEventStorage.ts new file mode 100644 index 0000000..bbe7cf2 --- /dev/null +++ b/src/utils/isIEventStorage.ts @@ -0,0 +1,8 @@ +import { IEventStorage } from "../interfaces"; + +export const isIEventStorage = (storage: IEventStorage): storage is IEventStorage => storage + && typeof storage.getNewId === 'function' + && typeof storage.commitEvents === 'function' + && typeof storage.getEventsByTypes === 'function' + && typeof storage.getAggregateEvents === 'function' + && typeof storage.getSagaEvents === 'function'; diff --git a/src/utils/isIMessageBus.ts b/src/utils/isIMessageBus.ts new file mode 100644 index 0000000..4a47228 --- /dev/null +++ b/src/utils/isIMessageBus.ts @@ -0,0 +1,9 @@ +import { IMessageBus } from "../interfaces"; +import { isIObservable } from "."; + +export const isIMessageBus = (bus: IMessageBus | any): bus is IMessageBus => bus + && isIObservable(bus) + && 'send' in bus + && typeof bus.send === 'function' + && 'publish' in bus + && typeof bus.publish === 'function'; diff --git a/src/utils/iteratorToArray.ts b/src/utils/iteratorToArray.ts new file mode 100644 index 0000000..9530201 --- /dev/null +++ b/src/utils/iteratorToArray.ts @@ -0,0 +1,6 @@ +export async function iteratorToArray(input: AsyncIterable | Iterable): Promise { + const result: T[] = []; + for await (const item of input) + result.push(item); + return result; +} diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index 04ef51d..a4945c5 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -48,7 +48,7 @@ describe('AbstractProjection', function () { beforeEach(() => { observable = { - getAllEvents() { + getEventsByTypes() { return []; }, on() { } @@ -96,7 +96,7 @@ describe('AbstractProjection', function () { it('subscribes projection to all events returned by "handles"', () => { - class ProjectionWithHandles extends AbstractProjection { + class ProjectionWithHandles extends AbstractProjection { static get handles() { return ['somethingHappened2']; } @@ -117,24 +117,24 @@ describe('AbstractProjection', function () { beforeEach(() => { es = { - async* getAllEvents() { + async* getEventsByTypes() { yield { type: 'somethingHappened', aggregateId: 1, aggregateVersion: 1 }; yield { type: 'somethingHappened', aggregateId: 1, aggregateVersion: 2 }; yield { type: 'somethingHappened', aggregateId: 2, aggregateVersion: 1 }; } }; - sinon.spy(es, 'getAllEvents'); + sinon.spy(es, 'getEventsByTypes'); return projection.restore(es); }); it('queries events of specific types from event store', () => { - assert(es.getAllEvents.calledOnce, 'es.getAllEvents was not called'); + assert(es.getEventsByTypes.calledOnce, 'es.getEventsByTypes was not called'); - const { args } = es.getAllEvents.lastCall; + const { args } = es.getEventsByTypes.lastCall; - expect(args).to.have.length(1); + expect(args).to.have.length(2); expect(args[0]).to.deep.eq(MyProjection.handles); }); @@ -154,7 +154,7 @@ describe('AbstractProjection', function () { it('throws, if projection error encountered', () => { es = { - async* getAllEvents() { + async* getEventsByTypes() { yield { type: 'unexpectedEvent' }; } }; @@ -174,8 +174,8 @@ describe('AbstractProjection', function () { it('waits until the restoring process is done', async () => { const storage = new InMemoryEventStorage(); - const messageBus = new InMemoryMessageBus(); - const es = new EventStore({ storage, messageBus }); + const supplementaryEventBus = new InMemoryMessageBus(); + const es = new EventStore({ storage, supplementaryEventBus }); let restored = false; let projected = false; diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index 28698e0..e057c44 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -48,18 +48,18 @@ describe('AggregateCommandHandler', function () { let snapshotStorage: InMemorySnapshotStorage; let eventStore: IEventStore; let commandBus: ICommandBus; - let messageBus: IMessageBus; + let supplementaryEventBus: IMessageBus; let onSpy; let getNewIdSpy; let getAggregateEventsSpy; let commitSpy; beforeEach(() => { - messageBus = new InMemoryMessageBus(); + supplementaryEventBus = new InMemoryMessageBus(); storage = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); - eventStore = new EventStore({ storage, snapshotStorage, messageBus }); + eventStore = new EventStore({ storage, snapshotStorage, supplementaryEventBus }); getNewIdSpy = sinon.spy(eventStore, 'getNewId'); getAggregateEventsSpy = sinon.spy(eventStore, 'getAggregateEvents'); commitSpy = sinon.spy(eventStore, 'commit'); diff --git a/tests/unit/CqrsContainerBuilder.test.ts b/tests/unit/CqrsContainerBuilder.test.ts index ca3b63b..02d2047 100644 --- a/tests/unit/CqrsContainerBuilder.test.ts +++ b/tests/unit/CqrsContainerBuilder.test.ts @@ -16,7 +16,7 @@ describe('CqrsContainerBuilder', function () { beforeEach(() => { builder = new ContainerBuilder(); builder.register(InMemoryEventStorage).as('storage'); - builder.register(InMemoryMessageBus).as('messageBus'); + builder.register(InMemoryMessageBus).as('supplementaryEventBus'); }); describe('registerAggregate(aggregateType) extension', () => { @@ -87,7 +87,7 @@ describe('CqrsContainerBuilder', function () { describe('registerProjection(typeOrFactory, exposedViewName) extension', () => { - class MyProjection extends AbstractProjection { + class MyProjection extends AbstractProjection { static get handles() { return ['somethingHappened']; } diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index 9816fe3..5113df0 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -3,6 +3,7 @@ import * as sinon from 'sinon'; import { EventStore } from '../../src/EventStore'; import { InMemoryEventStorage, InMemorySnapshotStorage, InMemoryMessageBus } from '../../src'; import { IAggregateSnapshotStorage, IEvent, IEventStorage, IEventStore, IMessageBus } from '../../src/interfaces'; +import { iteratorToArray } from '../../src/utils'; const goodContext = { uid: '1', @@ -38,13 +39,13 @@ describe('EventStore', function () { let es: IEventStore; let storage: IEventStorage; let snapshotStorage: IAggregateSnapshotStorage; - let messageBus: IMessageBus; + let supplementaryEventBus: IMessageBus; beforeEach(() => { storage = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); - messageBus = new InMemoryMessageBus(); - es = new EventStore({ storage, snapshotStorage, messageBus }); + supplementaryEventBus = new InMemoryMessageBus(); + es = new EventStore({ storage, snapshotStorage, supplementaryEventBus }); }); describe('validator', () => { @@ -52,7 +53,7 @@ describe('EventStore', function () { it('allows to validate events before they are committed', () => { const events = [ - { type: 'somethingHappened', aggregateId: 1 } + { type: 'somethingHappened', aggregateId: '1' } ]; return es.commit(events).then(() => { @@ -62,7 +63,7 @@ describe('EventStore', function () { eventValidator: event => { throw new Error('test validation error'); }, - messageBus + supplementaryEventBus }); return es.commit(events).then(() => { @@ -97,7 +98,7 @@ describe('EventStore', function () { await es.commit([goodEvent]); const events: IEvent[] = []; - for await (const e of es.getAllEvents()) + for await (const e of es.getEventsByTypes(['somethingHappened'], {})) events.push(e); expect(events[0]).to.have.property('type', 'somethingHappened'); @@ -152,7 +153,7 @@ describe('EventStore', function () { } }); - es = new EventStore({ storage, messageBus }); + es = new EventStore({ storage, supplementaryEventBus }); return es.commit([goodEvent, goodEvent2]).then(() => { throw new Error('should fail'); @@ -176,11 +177,12 @@ describe('EventStore', function () { await es.commit([goodEvent, goodEvent2]); - const events = await es.getAggregateEvents(goodEvent.aggregateId); + const events = es.getAggregateEvents(goodEvent.aggregateId); - expect(events).to.be.an('Array'); - expect(events).to.have.length(1); - expect(events).to.have.nested.property('[0].type', 'somethingHappened'); + expect(events).to.be.have.property(Symbol.asyncIterator); + + const event = (await events.next()).value; + expect(event).to.have.nested.property('type', 'somethingHappened'); }); it('tries to retrieve aggregate snapshot', async () => { @@ -192,7 +194,7 @@ describe('EventStore', function () { expect(es).to.have.property('snapshotsSupported', true); - const events = await es.getAggregateEvents(goodEvent2.aggregateId); + const events = await iteratorToArray(es.getAggregateEvents(goodEvent2.aggregateId)); expect(snapshotStorage).to.have.nested.property('getAggregateSnapshot.calledOnce', true); expect(storage).to.have.nested.property('getAggregateEvents.calledOnce', true); @@ -208,33 +210,33 @@ describe('EventStore', function () { describe('getSagaEvents(sagaId, options)', () => { - it('returns events committed by saga prior to event that triggered saga execution', () => { + it('returns events committed by saga prior to event that triggered saga execution', async () => { const events = [ - { sagaId: 1, sagaVersion: 1, type: 'somethingHappened' }, - { sagaId: 1, sagaVersion: 2, type: 'anotherHappened' }, - { sagaId: 2, sagaVersion: 1, type: 'somethingHappened' } + { sagaId: '1', sagaVersion: 1, type: 'somethingHappened' }, + { sagaId: '1', sagaVersion: 2, type: 'anotherHappened' }, + { sagaId: '2', sagaVersion: 1, type: 'somethingHappened' } ]; const triggeredBy = events[1]; - return es.commit(events).then(() => es.getSagaEvents(1, { beforeEvent: triggeredBy }).then(events => { + await es.commit(events); - expect(events).to.be.an('Array'); - expect(events).to.have.length(1); - expect(events).to.have.nested.property('[0].type', 'somethingHappened'); - })); + const ii = es.getSagaEvents('1', { beforeEvent: triggeredBy }); + const retrievedEvents = await iteratorToArray(ii); + + expect(retrievedEvents).to.be.an('Array'); + expect(retrievedEvents).to.have.length(1); + expect(retrievedEvents).to.have.nested.property('[0].type', 'somethingHappened'); }); }); - describe('getAllEvents(eventTypes)', () => { + describe('getEventsByTypes(eventTypes)', () => { it('returns a promise that resolves to all committed events of specific types', async () => { await es.commit([goodEvent, goodEvent2]); - const events: IEvent[] = []; - for await (const e of es.getAllEvents(['somethingHappened'])) - events.push(e); + const events = await iteratorToArray(es.getEventsByTypes(['somethingHappened'], {})); expect(events).to.have.length(2); expect(events).to.have.nested.property('[0].aggregateId', '1'); @@ -250,7 +252,7 @@ describe('EventStore', function () { it('fails, when trying to set up second messageType handler within the same node and named queue (Receptors)', () => { - es = new EventStore({ storage, messageBus }); + es = new EventStore({ storage, supplementaryEventBus }); expect(() => { es.queue('namedQueue').on('somethingHappened', () => { }); @@ -267,7 +269,7 @@ describe('EventStore', function () { it('sets up multiple handlers for same messageType, when queue name is not defined (Projections)', () => { - es = new EventStore({ storage, messageBus }); + es = new EventStore({ storage, supplementaryEventBus }); const projection1Handler = sinon.spy(); const projection2Handler = sinon.spy(); @@ -276,7 +278,7 @@ describe('EventStore', function () { es.on('somethingHappened', projection2Handler); return es.commit([ - { type: 'somethingHappened', aggregateId: 1, aggregateVersion: 0 } + { type: 'somethingHappened', aggregateId: '1', aggregateVersion: 0 } ]).then(() => { expect(projection1Handler).to.have.property('calledOnce', true); expect(projection2Handler).to.have.property('calledOnce', true); diff --git a/tests/unit/InMemoryEventStorage.test.ts b/tests/unit/InMemoryEventStorage.test.ts new file mode 100644 index 0000000..fe25589 --- /dev/null +++ b/tests/unit/InMemoryEventStorage.test.ts @@ -0,0 +1,127 @@ +import { expect } from 'chai'; +import { InMemoryEventStorage } from '../../src'; + +describe('InMemoryEventStorage', () => { + let storage; + + beforeEach(() => { + storage = new InMemoryEventStorage(); + }); + + describe('commitEvents', () => { + it('commits events and returns them', async () => { + const events = [ + { id: '1', aggregateId: 'agg1', aggregateVersion: 1, type: 'TestEvent' } + ]; + const result = await storage.commitEvents(events); + expect(result).to.deep.equal(events); + }); + }); + + describe('getAggregateEvents', () => { + + it('yields events with matching aggregateId', async () => { + + const event1 = { id: '1', aggregateId: 'agg1', aggregateVersion: 1, type: 'TestEvent' }; + const event2 = { id: '2', aggregateId: 'agg2', aggregateVersion: 1, type: 'TestEvent' }; + await storage.commitEvents([event1, event2]); + + const results = []; + for await (const event of storage.getAggregateEvents('agg1')) { + results.push(event); + } + expect(results).to.deep.equal([event1]); + }); + + it('yields events with aggregateVersion greater than snapshot.aggregateVersion', async () => { + + const event1 = { id: '1', aggregateId: 'agg1', aggregateVersion: 1, type: 'TestEvent' }; + const event2 = { id: '2', aggregateId: 'agg1', aggregateVersion: 2, type: 'TestEvent' }; + await storage.commitEvents([event1, event2]); + + const snapshot = { aggregateVersion: 1 }; + const results = []; + for await (const event of storage.getAggregateEvents('agg1', { snapshot })) { + results.push(event); + } + expect(results).to.deep.equal([event2]); + }); + }); + + describe('getSagaEvents', () => { + + it('yields saga events with sagaVersion less than beforeEvent.sagaVersion', async () => { + + const event1 = { id: '1', sagaId: 'saga1', sagaVersion: 1, type: 'SagaEvent' }; + const event2 = { id: '2', sagaId: 'saga1', sagaVersion: 2, type: 'SagaEvent' }; + const event3 = { id: '3', sagaId: 'saga1', sagaVersion: 3, type: 'SagaEvent' }; + await storage.commitEvents([event1, event2, event3]); + + const beforeEvent = { sagaVersion: 3 }; + const results = []; + for await (const event of storage.getSagaEvents('saga1', { beforeEvent })) { + results.push(event); + } + expect(results).to.deep.equal([event1, event2]); + }); + }); + + describe('getEventsByTypes', () => { + + it('yields events matching the provided types', async () => { + + const event1 = { id: '1', type: 'A' }; + const event2 = { id: '2', type: 'B' }; + const event3 = { id: '3', type: 'A' }; + await storage.commitEvents([event1, event2, event3]); + + const results = []; + for await (const event of storage.getEventsByTypes(['A'])) { + results.push(event); + } + expect(results).to.deep.equal([event1, event3]); + }); + + it('yields events only after the given afterEvent id', async () => { + + const event1 = { id: '1', type: 'A' }; + const event2 = { id: '2', type: 'A' }; + const event3 = { id: '3', type: 'A' }; + await storage.commitEvents([event1, event2, event3]); + + const options = { afterEvent: { id: '1' } }; + const results = []; + for await (const event of storage.getEventsByTypes(['A'], options)) { + results.push(event); + } + expect(results).to.deep.equal([event2, event3]); + }); + + it('throws error if afterEvent is provided without id', async () => { + + const event1 = { id: '1', type: 'A' }; + await storage.commitEvents([event1]); + const options = { afterEvent: {} }; + + const gen = storage.getEventsByTypes(['A'], options); + try { + await gen.next(); + throw new Error('Expected error was not thrown'); + } catch (err) { + expect(err).to.be.instanceOf(TypeError); + expect(err.message).to.equal('options.afterEvent.id is required'); + } + }); + }); + + describe('getNewId', () => { + + it('returns sequential string ids', () => { + + const id1 = storage.getNewId(); + const id2 = storage.getNewId(); + expect(id1).to.equal('1'); + expect(id2).to.equal('2'); + }); + }); +}); diff --git a/tests/unit/SagaEventHandler.test.ts b/tests/unit/SagaEventHandler.test.ts index 83c0f02..5e13ece 100644 --- a/tests/unit/SagaEventHandler.test.ts +++ b/tests/unit/SagaEventHandler.test.ts @@ -22,7 +22,7 @@ class Saga extends AbstractSaga { } followingHappened() { super.enqueue('complete', undefined, { foo: 'bar' }); - } + } onError(error, { command, event }) { super.enqueue('fixError', undefined, { error, command, event }); } @@ -42,9 +42,9 @@ describe('SagaEventHandler', function () { let sagaEventHandler: SagaEventHandler; beforeEach(() => { - const messageBus = new InMemoryMessageBus(); - commandBus = new CommandBus({ messageBus }); - eventStore = new EventStore({ storage: new InMemoryEventStorage(), messageBus }); + const supplementaryEventBus = new InMemoryMessageBus(); + commandBus = new CommandBus({}); + eventStore = new EventStore({ storage: new InMemoryEventStorage(), supplementaryEventBus }); sagaEventHandler = new SagaEventHandler({ sagaType: Saga, eventStore, commandBus }); }); From e45f6ff588e467fb3c37b9fac1579a873a951209 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 14 Mar 2025 00:16:12 +0000 Subject: [PATCH 010/169] Minor refactoring --- src/AbstractProjection.ts | 9 +++++---- src/CqrsContainerBuilder.ts | 1 - 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index a05d3f5..157dad8 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -155,11 +155,12 @@ export abstract class AbstractProjection Date: Fri, 14 Mar 2025 01:08:06 +0000 Subject: [PATCH 011/169] Revert removal of Identifier type --- src/AbstractAggregate.ts | 5 +++-- src/AbstractSaga.ts | 8 ++++---- src/AggregateCommandHandler.ts | 3 ++- src/EventStore.ts | 9 +++++---- .../memory/InMemorySnapshotStorage.ts | 5 ++--- src/infrastructure/memory/InMemoryView.ts | 18 +++++++++--------- src/interfaces/IAggregate.ts | 5 +++-- src/interfaces/IAggregateSnapshotStorage.ts | 3 ++- src/interfaces/IEventStorage.ts | 7 ++++--- src/interfaces/IEventStore.ts | 7 ++++--- src/interfaces/IMessage.ts | 6 ++++-- src/interfaces/ISaga.ts | 5 +++-- src/interfaces/Identifier.ts | 1 + src/interfaces/index.ts | 1 + 14 files changed, 47 insertions(+), 36 deletions(-) create mode 100644 src/interfaces/Identifier.ts diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 8587a77..a7da6ae 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -2,6 +2,7 @@ import { IAggregate, IMutableAggregateState, ICommand, + Identifier, IEvent, IEventSet, IAggregateConstructorParams @@ -36,7 +37,7 @@ export abstract class AbstractAggregate { + async #restoreAggregate(id: Identifier): Promise { if (!id) throw new TypeError('id argument required'); diff --git a/src/EventStore.ts b/src/EventStore.ts index f8c2b98..99d596a 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -11,7 +11,8 @@ import { IEventStream, IEventStore, EventQueryAfter, - EventQueryBefore + EventQueryBefore, + Identifier } from "./interfaces"; import { getClassName, @@ -73,7 +74,7 @@ export class EventStore implements IEventStore { /** Retrieve new ID from the storage */ - async getNewId(): Promise { + async getNewId(): Promise { return this.#storage.getNewId(); } @@ -91,7 +92,7 @@ export class EventStore implements IEventStore { } /** Retrieve all events of specific Aggregate */ - async* getAggregateEvents(aggregateId: string): IEventStream { + async* getAggregateEvents(aggregateId: Identifier): IEventStream { if (!aggregateId) throw new TypeError('aggregateId argument required'); @@ -112,7 +113,7 @@ export class EventStore implements IEventStore { } /** Retrieve events of specific Saga */ - async* getSagaEvents(sagaId: string, filter: EventQueryBefore) { + async* getSagaEvents(sagaId: Identifier, filter: EventQueryBefore) { if (!sagaId) throw new TypeError('sagaId argument required'); if (!filter) diff --git a/src/infrastructure/memory/InMemorySnapshotStorage.ts b/src/infrastructure/memory/InMemorySnapshotStorage.ts index a306535..7943217 100644 --- a/src/infrastructure/memory/InMemorySnapshotStorage.ts +++ b/src/infrastructure/memory/InMemorySnapshotStorage.ts @@ -1,5 +1,4 @@ -import { IAggregateSnapshotStorage } from "../../interfaces/IAggregateSnapshotStorage"; -import { IEvent } from "../../interfaces/IEvent"; +import { IAggregateSnapshotStorage, Identifier, IEvent } from "../../interfaces"; /** * In-memory storage for aggregate snapshots. @@ -7,7 +6,7 @@ import { IEvent } from "../../interfaces/IEvent"; */ export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { - #snapshots: Map = new Map(); + #snapshots: Map = new Map(); /** * Get latest aggregate snapshot diff --git a/src/infrastructure/memory/InMemoryView.ts b/src/infrastructure/memory/InMemoryView.ts index 47ede46..42a8ff5 100644 --- a/src/infrastructure/memory/InMemoryView.ts +++ b/src/infrastructure/memory/InMemoryView.ts @@ -1,7 +1,7 @@ import { InMemoryLock } from './InMemoryLock'; +import { IProjectionView, Identifier } from "../../interfaces"; import { nextCycle } from './utils'; import { IObjectView } from '../../interfaces/IObjectView'; -import { IProjectionView } from '../../interfaces/IProjectionView'; /** * Update given value with an update Cb and return updated value. @@ -23,7 +23,7 @@ export class InMemoryView implements IProjectionView, IObjectView = new Map(); + protected _map: Map = new Map(); #lock: InMemoryLock; @@ -76,7 +76,7 @@ export class InMemoryView implements IProjectionView, IObjectView { + async get(key: Identifier, options?: { nowait?: boolean }): Promise { if (!key) throw new TypeError('key argument required'); @@ -91,7 +91,7 @@ export class InMemoryView implements IProjectionView, IObjectView implements IProjectionView, IObjectView boolean): - Promise> { + async getAll(filter?: (r: TRecord | undefined, i: Identifier) => boolean): + Promise> { if (filter && typeof filter !== 'function') throw new TypeError('filter argument, when defined, must be a Function'); @@ -109,7 +109,7 @@ export class InMemoryView implements IProjectionView, IObjectView = []; + const r: Array<[Identifier, TRecord | undefined]> = []; for (const entry of this._map.entries()) { if (!filter || filter(entry[1], entry[0])) r.push(entry); @@ -171,7 +171,7 @@ export class InMemoryView implements IProjectionView, IObjectView TRecord) { + private async _update(key: Identifier, update: (r?: TRecord) => TRecord) { const value = this._map.get(key); const updatedValue = applyUpdate(value, update); if (updatedValue === undefined) @@ -181,7 +181,7 @@ export class InMemoryView implements IProjectionView, IObjectView; @@ -36,7 +37,7 @@ export interface IMutableAggregateState { export type IAggregateConstructorParams = { /** Unique aggregate identifier */ - id: string, + id: Identifier, /** Aggregate events, logged after latest snapshot */ events?: IEventSet, diff --git a/src/interfaces/IAggregateSnapshotStorage.ts b/src/interfaces/IAggregateSnapshotStorage.ts index 10064e0..41c293d 100644 --- a/src/interfaces/IAggregateSnapshotStorage.ts +++ b/src/interfaces/IAggregateSnapshotStorage.ts @@ -1,7 +1,8 @@ +import { Identifier } from "./Identifier"; import { IEvent } from "./IEvent"; export interface IAggregateSnapshotStorage { - getAggregateSnapshot(aggregateId: string): Promise | undefined> | IEvent | undefined; + getAggregateSnapshot(aggregateId: Identifier): Promise | undefined> | IEvent | undefined; saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; } diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorage.ts index 5bafb34..cbd1cfe 100644 --- a/src/interfaces/IEventStorage.ts +++ b/src/interfaces/IEventStorage.ts @@ -1,3 +1,4 @@ +import { Identifier } from "./Identifier"; import { IEvent } from "./IEvent"; import { IEventSet } from "./IEventSet"; import { IEventStream } from "./IEventStream"; @@ -16,13 +17,13 @@ export interface IEventStorage { /** * Create unique identifier */ - getNewId(): string | Promise; + getNewId(): Identifier | Promise; commitEvents(events: IEventSet): Promise; getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; - getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): Promise | IEventStream; + getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise | IEventStream; - getSagaEvents(sagaId: string, options: EventQueryBefore): Promise | IEventStream; + getSagaEvents(sagaId: Identifier, options: EventQueryBefore): Promise | IEventStream; } diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index bba8c38..21954f6 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,3 +1,4 @@ +import { Identifier } from "./Identifier"; import { IEvent } from "./IEvent"; import { IEventSet } from "./IEventSet"; import { EventQueryAfter, EventQueryBefore } from "./IEventStorage"; @@ -7,15 +8,15 @@ import { IMessageHandler, IObservable } from "./IObservable"; export interface IEventStore extends IObservable { readonly snapshotsSupported?: boolean; - getNewId(): string | Promise; + getNewId(): Identifier | Promise; commit(events: IEventSet): Promise; getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; - getAggregateEvents(aggregateId: string, options?: { snapshot?: IEvent }): IEventStream; + getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): IEventStream; - getSagaEvents(sagaId: string, options: EventQueryBefore): IEventStream; + getSagaEvents(sagaId: Identifier, options: EventQueryBefore): IEventStream; once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index 448e8aa..c40dc95 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -1,11 +1,13 @@ +import { Identifier } from "./Identifier"; + export interface IMessage { /** Event or command type */ type: string; - aggregateId?: string; + aggregateId?: Identifier; aggregateVersion?: number; - sagaId?: string; + sagaId?: Identifier; sagaVersion?: number; payload?: TPayload; diff --git a/src/interfaces/ISaga.ts b/src/interfaces/ISaga.ts index a4e585c..8507ac1 100644 --- a/src/interfaces/ISaga.ts +++ b/src/interfaces/ISaga.ts @@ -1,10 +1,11 @@ import { ICommand } from "./ICommand"; +import { Identifier } from "./Identifier"; import { IEvent } from "./IEvent"; import { IEventSet } from "./IEventSet"; export interface ISaga { /** Unique Saga ID */ - readonly id: string; + readonly id: Identifier; /** List of commands emitted by Saga */ readonly uncommittedMessages: ICommand[]; @@ -19,7 +20,7 @@ export interface ISaga { } export type ISagaConstructorParams = { - id: string, + id: Identifier, events?: IEventSet }; diff --git a/src/interfaces/Identifier.ts b/src/interfaces/Identifier.ts new file mode 100644 index 0000000..f31f1fb --- /dev/null +++ b/src/interfaces/Identifier.ts @@ -0,0 +1 @@ +export type Identifier = string | number; diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index 67b8da1..ab97393 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -2,6 +2,7 @@ export * from './IAggregate'; export * from './IAggregateSnapshotStorage'; export * from './ICommand'; export * from './ICommandBus'; +export * from './Identifier'; export * from './IEvent'; export * from './IEventReceptor'; export * from './IEventSet'; From 72b6304dbb50909e385dede7d91307d76f725486 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 14 Mar 2025 01:11:24 +0000 Subject: [PATCH 012/169] Fix vulnerabilities in dev dependencies --- package-lock.json | 664 ++++------------------------------------------ package.json | 4 - 2 files changed, 53 insertions(+), 615 deletions(-) diff --git a/package-lock.json b/package-lock.json index 3371379..603dbe4 100644 --- a/package-lock.json +++ b/package-lock.json @@ -18,7 +18,6 @@ "@types/sinon": "^10.0.20", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "coveralls": "^3.1.1", "jest": "^29.7.0", "sinon": "^15.2.0", "ts-jest": "^29.2.4", @@ -43,12 +42,14 @@ } }, "node_modules/@babel/code-frame": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.24.7.tgz", - "integrity": "sha512-BcYH1CVJBO9tvyIZ2jVeXgSIMvGZ2FDRvDdOIVQyuklNKSsx+eppDEBq/g47Ayw+RqNFE+URvOShmf+f/qwAlA==", + "version": "7.26.2", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.26.2.tgz", + "integrity": "sha512-RJlIHRueQgwWitWgF8OdFYGZX328Ax5BCemNGlqHfplnRT9ESi8JkFlvaVYbS+UubVY6dpv87Fs2u5M29iNFVQ==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/highlight": "^7.24.7", + "@babel/helper-validator-identifier": "^7.25.9", + "js-tokens": "^4.0.0", "picocolors": "^1.0.0" }, "engines": { @@ -194,19 +195,21 @@ } }, "node_modules/@babel/helper-string-parser": { - "version": "7.24.8", - "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.24.8.tgz", - "integrity": "sha512-pO9KhhRcuUyGnJWwyEgnRJTSIZHiT+vMD0kPeD+so0l7mxkMT19g3pjY9GTnHySck/hDzq+dtW/4VgnMkippsQ==", + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz", + "integrity": "sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/helper-validator-identifier": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.24.7.tgz", - "integrity": "sha512-rR+PBcQ1SMQDDyF6X0wxtG8QyLCgUB0eRAGguqRLfkCA87l7yAP7ehq8SNj96OOGTO8OBV70KhuFYcIkHXOg0w==", + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz", + "integrity": "sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -221,111 +224,27 @@ } }, "node_modules/@babel/helpers": { - "version": "7.25.0", - "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.25.0.tgz", - "integrity": "sha512-MjgLZ42aCm0oGjJj8CtSM3DB8NOOf8h2l7DCTePJs29u+v7yO/RBX9nShlKMgFnRks/Q4tBAe7Hxnov9VkGwLw==", + "version": "7.26.10", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.26.10.tgz", + "integrity": "sha512-UPYc3SauzZ3JGgj87GgZ89JVdC5dj0AoetR5Bw6wj4niittNyFh6+eOGonYvJ1ao6B8lEa3Q3klS7ADZ53bc5g==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/template": "^7.25.0", - "@babel/types": "^7.25.0" + "@babel/template": "^7.26.9", + "@babel/types": "^7.26.10" }, "engines": { "node": ">=6.9.0" } }, - "node_modules/@babel/highlight": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.24.7.tgz", - "integrity": "sha512-EStJpq4OuY8xYfhGVXngigBJRWxftKX9ksiGDnmlY3o7B/V7KIAc9X4oiK87uPJSc/vs5L869bem5fhZa8caZw==", - "dev": true, - "dependencies": { - "@babel/helper-validator-identifier": "^7.24.7", - "chalk": "^2.4.2", - "js-tokens": "^4.0.0", - "picocolors": "^1.0.0" - }, - "engines": { - "node": ">=6.9.0" - } - }, - "node_modules/@babel/highlight/node_modules/ansi-styles": { - "version": "3.2.1", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", - "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", - "dev": true, - "dependencies": { - "color-convert": "^1.9.0" - }, - "engines": { - "node": ">=4" - } - }, - "node_modules/@babel/highlight/node_modules/chalk": { - "version": "2.4.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", - "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", - "dev": true, - "dependencies": { - "ansi-styles": "^3.2.1", - "escape-string-regexp": "^1.0.5", - "supports-color": "^5.3.0" - }, - "engines": { - "node": ">=4" - } - }, - "node_modules/@babel/highlight/node_modules/color-convert": { - "version": "1.9.3", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", - "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", - "dev": true, - "dependencies": { - "color-name": "1.1.3" - } - }, - "node_modules/@babel/highlight/node_modules/color-name": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", - "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==", - "dev": true - }, - "node_modules/@babel/highlight/node_modules/escape-string-regexp": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", - "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", - "dev": true, - "engines": { - "node": ">=0.8.0" - } - }, - "node_modules/@babel/highlight/node_modules/has-flag": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", - "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", - "dev": true, - "engines": { - "node": ">=4" - } - }, - "node_modules/@babel/highlight/node_modules/supports-color": { - "version": "5.5.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", - "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", - "dev": true, - "dependencies": { - "has-flag": "^3.0.0" - }, - "engines": { - "node": ">=4" - } - }, "node_modules/@babel/parser": { - "version": "7.25.3", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.25.3.tgz", - "integrity": "sha512-iLTJKDbJ4hMvFPgQwwsVoxtHyWpKKPBrxkANrSYewDPaPpT5py5yeVkgPIJ7XYXhndxJpaA3PyALSXQ7u8e/Dw==", + "version": "7.26.10", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.26.10.tgz", + "integrity": "sha512-6aQR2zGE/QFi8JpDLjUZEPYOs7+mhKXm86VaKFiLP35JQwQb6bwUE+XbvkH0EptsYhbNBSUGaUBLKqxH1xSgsA==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/types": "^7.25.2" + "@babel/types": "^7.26.10" }, "bin": { "parser": "bin/babel-parser.js" @@ -512,14 +431,15 @@ } }, "node_modules/@babel/template": { - "version": "7.25.0", - "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.25.0.tgz", - "integrity": "sha512-aOOgh1/5XzKvg1jvVz7AVrx2piJ2XBi227DHmbY6y+bM9H2FlN+IfecYu4Xl0cNiiVejlsCri89LUsbj8vJD9Q==", + "version": "7.26.9", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.26.9.tgz", + "integrity": "sha512-qyRplbeIpNZhmzOysF/wFMuP9sctmh2cFzRAZOn1YapxBsE1i9bJIY586R/WBLfLcmcBlM8ROBiQURnnNy+zfA==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.24.7", - "@babel/parser": "^7.25.0", - "@babel/types": "^7.25.0" + "@babel/code-frame": "^7.26.2", + "@babel/parser": "^7.26.9", + "@babel/types": "^7.26.9" }, "engines": { "node": ">=6.9.0" @@ -544,14 +464,14 @@ } }, "node_modules/@babel/types": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.25.2.tgz", - "integrity": "sha512-YTnYtra7W9e6/oAZEHj0bJehPRUlLH9/fbpT5LfB0NhQXyALCRkRs3zH9v07IYhkgpqX6Z78FnuccZr/l4Fs4Q==", + "version": "7.26.10", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.26.10.tgz", + "integrity": "sha512-emqcG3vHrpxUKTrxcblR36dcrcoRDvKmnL/dCL6ZsHaShW80qxCAcNhzQZrpeM765VzEos+xOi4s+r4IXzTwdQ==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/helper-string-parser": "^7.24.8", - "@babel/helper-validator-identifier": "^7.24.7", - "to-fast-properties": "^2.0.0" + "@babel/helper-string-parser": "^7.25.9", + "@babel/helper-validator-identifier": "^7.25.9" }, "engines": { "node": ">=6.9.0" @@ -1214,22 +1134,6 @@ "integrity": "sha512-qQLMr+8o0WC4FZGQTcJiKBVC59JylcPSrTtk6usvmIDFUOCKegapy1VHQwRbFMOFyb/inzUVqHs+eMYKDM1YeQ==", "dev": true }, - "node_modules/ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", - "dev": true, - "dependencies": { - "fast-deep-equal": "^3.1.1", - "fast-json-stable-stringify": "^2.0.0", - "json-schema-traverse": "^0.4.1", - "uri-js": "^4.2.2" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/epoberezkin" - } - }, "node_modules/ansi-escapes": { "version": "4.3.2", "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", @@ -1312,24 +1216,6 @@ "node": ">=0.10.0" } }, - "node_modules/asn1": { - "version": "0.2.6", - "resolved": "https://registry.npmjs.org/asn1/-/asn1-0.2.6.tgz", - "integrity": "sha512-ix/FxPn0MDjeyJ7i/yoHGFt/EX6LyNbxSEhPPXODPL+KB0VPk86UYfL0lMdy+KCnv+fmvIzySwaK5COwqVbWTQ==", - "dev": true, - "dependencies": { - "safer-buffer": "~2.1.0" - } - }, - "node_modules/assert-plus": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/assert-plus/-/assert-plus-1.0.0.tgz", - "integrity": "sha512-NfJ4UzBCcQGLDlQq7nHxH+tv3kyZ0hHQqF5BO6J7tNJeP5do1llPr8dZ8zHonfhAu0PHAdMkSo+8o0wxg9lZWw==", - "dev": true, - "engines": { - "node": ">=0.8" - } - }, "node_modules/assertion-error": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz", @@ -1345,27 +1231,6 @@ "integrity": "sha512-baNZyqaaLhyLVKm/DlvdW051MSgO6b8eVfIezl9E5PqWxFgzLm/wQntEW4zOytVburDEr0JlALEpdOFwvErLsg==", "dev": true }, - "node_modules/asynckit": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", - "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", - "dev": true - }, - "node_modules/aws-sign2": { - "version": "0.7.0", - "resolved": "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.7.0.tgz", - "integrity": "sha512-08kcGqnYf/YmjoRhfxyu+CLxBjUtHLXLXX/vUfx9l2LYzG3c1m61nrpyFUZI6zeS+Li/wWMMidD9KgrqtGq3mA==", - "dev": true, - "engines": { - "node": "*" - } - }, - "node_modules/aws4": { - "version": "1.13.0", - "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.13.0.tgz", - "integrity": "sha512-3AungXC4I8kKsS9PuS4JH2nc+0bVY/mjgrephHTIi8fpEeGsTHBUJeosp0Wc1myYMElmD0B3Oc4XL/HVJ4PV2g==", - "dev": true - }, "node_modules/babel-jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz", @@ -1479,15 +1344,6 @@ "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", "dev": true }, - "node_modules/bcrypt-pbkdf": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/bcrypt-pbkdf/-/bcrypt-pbkdf-1.0.2.tgz", - "integrity": "sha512-qeFIXtP4MSoi6NLqO12WfqARWWuCKi2Rn/9hJLEmtB5yTNr9DqFWkJRCf2qShWzPeAMRnOgCrq0sg/KLv5ES9w==", - "dev": true, - "dependencies": { - "tweetnacl": "^0.14.3" - } - }, "node_modules/brace-expansion": { "version": "1.1.11", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", @@ -1624,12 +1480,6 @@ } ] }, - "node_modules/caseless": { - "version": "0.12.0", - "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz", - "integrity": "sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==", - "dev": true - }, "node_modules/chai": { "version": "4.5.0", "resolved": "https://registry.npmjs.org/chai/-/chai-4.5.0.tgz", @@ -1751,18 +1601,6 @@ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", "dev": true }, - "node_modules/combined-stream": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", - "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", - "dev": true, - "dependencies": { - "delayed-stream": "~1.0.0" - }, - "engines": { - "node": ">= 0.8" - } - }, "node_modules/compare-func": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz", @@ -2015,25 +1853,6 @@ "integrity": "sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==", "dev": true }, - "node_modules/coveralls": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/coveralls/-/coveralls-3.1.1.tgz", - "integrity": "sha512-+dxnG2NHncSD1NrqbSM3dn/lE57O6Qf/koe9+I7c+wzkqRmEvcp0kgJdxKInzYzkICKkFMZsX3Vct3++tsF9ww==", - "dev": true, - "dependencies": { - "js-yaml": "^3.13.1", - "lcov-parse": "^1.0.0", - "log-driver": "^1.2.7", - "minimist": "^1.2.5", - "request": "^2.88.2" - }, - "bin": { - "coveralls": "bin/coveralls.js" - }, - "engines": { - "node": ">=6" - } - }, "node_modules/create-jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz", @@ -2062,10 +1881,11 @@ "dev": true }, "node_modules/cross-spawn": { - "version": "7.0.3", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz", - "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==", + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", @@ -2084,18 +1904,6 @@ "node": ">=8" } }, - "node_modules/dashdash": { - "version": "1.14.1", - "resolved": "https://registry.npmjs.org/dashdash/-/dashdash-1.14.1.tgz", - "integrity": "sha512-jRFi8UDGo6j+odZiEpjazZaWqEal3w/basFjQHQEwVtZJGDpxbH1MeYluwCS8Xq5wmLJooDlMgvVarmWfGM44g==", - "dev": true, - "dependencies": { - "assert-plus": "^1.0.0" - }, - "engines": { - "node": ">=0.10" - } - }, "node_modules/dateformat": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-3.0.3.tgz", @@ -2191,15 +1999,6 @@ "node": ">=0.10.0" } }, - "node_modules/delayed-stream": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", - "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", - "dev": true, - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/detect-newline": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz", @@ -2244,16 +2043,6 @@ "node": ">=8" } }, - "node_modules/ecc-jsbn": { - "version": "0.1.2", - "resolved": "https://registry.npmjs.org/ecc-jsbn/-/ecc-jsbn-0.1.2.tgz", - "integrity": "sha512-eh9O+hwRHNbG4BLTjEl3nw044CkGm5X6LoaCf7LPp7UU8Qrt47JYNi6nPX8xjW97TKGKm1ouctg0QSpZe9qrnw==", - "dev": true, - "dependencies": { - "jsbn": "~0.1.0", - "safer-buffer": "^2.1.0" - } - }, "node_modules/ejs": { "version": "3.1.10", "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", @@ -2381,27 +2170,6 @@ "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } }, - "node_modules/extend": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", - "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", - "dev": true - }, - "node_modules/extsprintf": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/extsprintf/-/extsprintf-1.3.0.tgz", - "integrity": "sha512-11Ndz7Nv+mvAC1j0ktTa7fAb0vLyGGX+rMHNBYQviQDGU0Hw7lhctJANqbPhu9nV9/izT/IntTgZ7Im/9LJs9g==", - "dev": true, - "engines": [ - "node >=0.6.0" - ] - }, - "node_modules/fast-deep-equal": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", - "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", - "dev": true - }, "node_modules/fast-json-stable-stringify": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", @@ -2472,29 +2240,6 @@ "node": ">=8" } }, - "node_modules/forever-agent": { - "version": "0.6.1", - "resolved": "https://registry.npmjs.org/forever-agent/-/forever-agent-0.6.1.tgz", - "integrity": "sha512-j0KLYPhm6zeac4lz3oJ3o65qvgQCcPubiyotZrXqEaG4hNagNYO8qdlUrX5vwqv9ohqeT/Z3j6+yW067yWWdUw==", - "dev": true, - "engines": { - "node": "*" - } - }, - "node_modules/form-data": { - "version": "2.3.3", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.3.tgz", - "integrity": "sha512-1lLKB2Mu3aGP1Q/2eCOx0fNbRMe7XdwktwOruhfqqd0rIJWwN4Dh+E3hrPSlDCXnSR7UtZ1N38rVXm+6+MEhJQ==", - "dev": true, - "dependencies": { - "asynckit": "^0.4.0", - "combined-stream": "^1.0.6", - "mime-types": "^2.1.12" - }, - "engines": { - "node": ">= 0.12" - } - }, "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", @@ -2630,15 +2375,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/getpass": { - "version": "0.1.7", - "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz", - "integrity": "sha512-0fzj9JxOLfJ+XGLhR8ze3unN0KZCgZwiSSDz168VERjK8Wl8kVSdcu2kspd4s4wtAa1y/qrVRiAA0WclVsu0ng==", - "dev": true, - "dependencies": { - "assert-plus": "^1.0.0" - } - }, "node_modules/git-raw-commits": { "version": "2.0.11", "resolved": "https://registry.npmjs.org/git-raw-commits/-/git-raw-commits-2.0.11.tgz", @@ -2753,29 +2489,6 @@ "uglify-js": "^3.1.4" } }, - "node_modules/har-schema": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/har-schema/-/har-schema-2.0.0.tgz", - "integrity": "sha512-Oqluz6zhGX8cyRaTQlFMPw80bSJVG2x/cFb8ZPhUILGgHka9SsokCCOQgpveePerqidZOrT14ipqfJb7ILcW5Q==", - "dev": true, - "engines": { - "node": ">=4" - } - }, - "node_modules/har-validator": { - "version": "5.1.5", - "resolved": "https://registry.npmjs.org/har-validator/-/har-validator-5.1.5.tgz", - "integrity": "sha512-nmT2T0lljbxdQZfspsno9hgrG3Uir6Ks5afism62poxqBM6sDnMEuPmzTq8XN0OEwqKLLdh1jQI3qyE66Nzb3w==", - "deprecated": "this library is no longer supported", - "dev": true, - "dependencies": { - "ajv": "^6.12.3", - "har-schema": "^2.0.0" - }, - "engines": { - "node": ">=6" - } - }, "node_modules/hard-rejection": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/hard-rejection/-/hard-rejection-2.1.0.tgz", @@ -2824,21 +2537,6 @@ "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", "dev": true }, - "node_modules/http-signature": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.2.0.tgz", - "integrity": "sha512-CAbnr6Rz4CYQkLYUtSNXxQPUH2gK8f3iWexVlsnMeD+GjlsQ0Xsy1cOX+mN3dtxYomRy21CiOzU8Uhw6OwncEQ==", - "dev": true, - "dependencies": { - "assert-plus": "^1.0.0", - "jsprim": "^1.2.2", - "sshpk": "^1.7.0" - }, - "engines": { - "node": ">=0.8", - "npm": ">=1.3.7" - } - }, "node_modules/human-signals": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", @@ -2998,12 +2696,6 @@ "node": ">=0.10.0" } }, - "node_modules/is-typedarray": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/is-typedarray/-/is-typedarray-1.0.0.tgz", - "integrity": "sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA==", - "dev": true - }, "node_modules/isarray": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", @@ -3016,12 +2708,6 @@ "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", "dev": true }, - "node_modules/isstream": { - "version": "0.1.2", - "resolved": "https://registry.npmjs.org/isstream/-/isstream-0.1.2.tgz", - "integrity": "sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g==", - "dev": true - }, "node_modules/istanbul-lib-coverage": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", @@ -3730,7 +3416,8 @@ "version": "4.0.0", "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/js-yaml": { "version": "3.14.1", @@ -3745,12 +3432,6 @@ "js-yaml": "bin/js-yaml.js" } }, - "node_modules/jsbn": { - "version": "0.1.1", - "resolved": "https://registry.npmjs.org/jsbn/-/jsbn-0.1.1.tgz", - "integrity": "sha512-UVU9dibq2JcFWxQPA6KCqj5O42VOmAY3zQUfEKxU0KpTGXwNoCjkX1e13eHNvw/xPynt6pU0rZ1htjWTNTSXsg==", - "dev": true - }, "node_modules/jsesc": { "version": "2.5.2", "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz", @@ -3775,18 +3456,6 @@ "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", "dev": true }, - "node_modules/json-schema": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.4.0.tgz", - "integrity": "sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==", - "dev": true - }, - "node_modules/json-schema-traverse": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", - "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", - "dev": true - }, "node_modules/json-stringify-safe": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", @@ -3830,21 +3499,6 @@ "node": "*" } }, - "node_modules/jsprim": { - "version": "1.4.2", - "resolved": "https://registry.npmjs.org/jsprim/-/jsprim-1.4.2.tgz", - "integrity": "sha512-P2bSOMAc/ciLz6DzgjVlGJP9+BrJWu5UDGK70C2iweC5QBIeFf0ZXRvGjEj2uYgrY2MkAAhsSWHDWlFtEroZWw==", - "dev": true, - "dependencies": { - "assert-plus": "1.0.0", - "extsprintf": "1.3.0", - "json-schema": "0.4.0", - "verror": "1.10.0" - }, - "engines": { - "node": ">=0.6.0" - } - }, "node_modules/just-extend": { "version": "6.2.0", "resolved": "https://registry.npmjs.org/just-extend/-/just-extend-6.2.0.tgz", @@ -3869,15 +3523,6 @@ "node": ">=6" } }, - "node_modules/lcov-parse": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/lcov-parse/-/lcov-parse-1.0.0.tgz", - "integrity": "sha512-aprLII/vPzuQvYZnDRU78Fns9I2Ag3gi4Ipga/hxnVMCZC8DnR2nI7XBqrPoywGfxqIx/DgarGvDJZAD3YBTgQ==", - "dev": true, - "bin": { - "lcov-parse": "bin/cli.js" - } - }, "node_modules/leven": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", @@ -3975,15 +3620,6 @@ "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==", "dev": true }, - "node_modules/log-driver": { - "version": "1.2.7", - "resolved": "https://registry.npmjs.org/log-driver/-/log-driver-1.2.7.tgz", - "integrity": "sha512-U7KCmLdqsGHBLeWqYlFA0V0Sl6P08EE1ZrmA9cxjUE0WVqT9qnyVDPz1kzpFEP0jdJuFnasWIfSd7fsaNXkpbg==", - "dev": true, - "engines": { - "node": ">=0.8.6" - } - }, "node_modules/loupe": { "version": "2.3.7", "resolved": "https://registry.npmjs.org/loupe/-/loupe-2.3.7.tgz", @@ -4180,10 +3816,11 @@ "dev": true }, "node_modules/micromatch": { - "version": "4.0.7", - "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.7.tgz", - "integrity": "sha512-LPP/3KorzCwBxfeUuZmaR6bG2kdeHSbe0P2tY3FLRU4vYrjYz5hI4QZwV0njUx3jeuKe67YukQ1LSPZBKDqO/Q==", + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", "dev": true, + "license": "MIT", "dependencies": { "braces": "^3.0.3", "picomatch": "^2.3.1" @@ -4192,27 +3829,6 @@ "node": ">=8.6" } }, - "node_modules/mime-db": { - "version": "1.52.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", - "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", - "dev": true, - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/mime-types": { - "version": "2.1.35", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", - "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", - "dev": true, - "dependencies": { - "mime-db": "1.52.0" - }, - "engines": { - "node": ">= 0.6" - } - }, "node_modules/mimic-fn": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", @@ -4375,15 +3991,6 @@ "node": ">=8" } }, - "node_modules/oauth-sign": { - "version": "0.9.0", - "resolved": "https://registry.npmjs.org/oauth-sign/-/oauth-sign-0.9.0.tgz", - "integrity": "sha512-fexhUFFPTGV8ybAtSIGbV6gOkSv8UtRbDBnAyLQw4QPKkgNlsH2ByPGtMUqdWkos6YCRmAqViwgZrJc/mRDzZQ==", - "dev": true, - "engines": { - "node": "*" - } - }, "node_modules/once": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", @@ -4511,10 +4118,11 @@ "dev": true }, "node_modules/path-to-regexp": { - "version": "6.2.2", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.2.2.tgz", - "integrity": "sha512-GQX3SSMokngb36+whdpRXE+3f9V8UzyAorlYvOGx87ufGHehNTn5lCxrKtLyZ4Yl/wEKnNnr98ZzOwwDZV5ogw==", - "dev": true + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.3.0.tgz", + "integrity": "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==", + "dev": true, + "license": "MIT" }, "node_modules/path-type": { "version": "3.0.0", @@ -4546,12 +4154,6 @@ "node": "*" } }, - "node_modules/performance-now": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz", - "integrity": "sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==", - "dev": true - }, "node_modules/picocolors": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.0.1.tgz", @@ -4645,21 +4247,6 @@ "node": ">= 6" } }, - "node_modules/psl": { - "version": "1.9.0", - "resolved": "https://registry.npmjs.org/psl/-/psl-1.9.0.tgz", - "integrity": "sha512-E/ZsdU4HLs/68gYzgGTkMicWTLPdAftJLfJFlLUAAKZGkStNU72sZjT66SnMDVOfOWY/YAoiD7Jxa9iHvngcag==", - "dev": true - }, - "node_modules/punycode": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", - "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", - "dev": true, - "engines": { - "node": ">=6" - } - }, "node_modules/pure-rand": { "version": "6.1.0", "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz", @@ -4687,15 +4274,6 @@ "teleport": ">=0.2.0" } }, - "node_modules/qs": { - "version": "6.5.3", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.5.3.tgz", - "integrity": "sha512-qxXIEh4pCGfHICj1mAJQ2/2XVZkjCDTcEgfoSQxc/fYivUZxTkk7L3bDBJSoNrEzXI17oUO5Dp07ktqE5KzczA==", - "dev": true, - "engines": { - "node": ">=0.6" - } - }, "node_modules/quick-lru": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-4.0.1.tgz", @@ -4859,38 +4437,6 @@ "node": ">=8" } }, - "node_modules/request": { - "version": "2.88.2", - "resolved": "https://registry.npmjs.org/request/-/request-2.88.2.tgz", - "integrity": "sha512-MsvtOrfG9ZcrOwAW+Qi+F6HbD0CWXEh9ou77uOb7FM2WPhwT7smM833PzanhJLsgXjN89Ir6V2PczXNnMpwKhw==", - "deprecated": "request has been deprecated, see https://github.com/request/request/issues/3142", - "dev": true, - "dependencies": { - "aws-sign2": "~0.7.0", - "aws4": "^1.8.0", - "caseless": "~0.12.0", - "combined-stream": "~1.0.6", - "extend": "~3.0.2", - "forever-agent": "~0.6.1", - "form-data": "~2.3.2", - "har-validator": "~5.1.3", - "http-signature": "~1.2.0", - "is-typedarray": "~1.0.0", - "isstream": "~0.1.2", - "json-stringify-safe": "~5.0.1", - "mime-types": "~2.1.19", - "oauth-sign": "~0.9.0", - "performance-now": "^2.1.0", - "qs": "~6.5.2", - "safe-buffer": "^5.1.2", - "tough-cookie": "~2.5.0", - "tunnel-agent": "^0.6.0", - "uuid": "^3.3.2" - }, - "engines": { - "node": ">= 6" - } - }, "node_modules/require-directory": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", @@ -4967,12 +4513,6 @@ } ] }, - "node_modules/safer-buffer": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", - "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", - "dev": true - }, "node_modules/semver": { "version": "6.3.1", "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", @@ -5121,31 +4661,6 @@ "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", "dev": true }, - "node_modules/sshpk": { - "version": "1.18.0", - "resolved": "https://registry.npmjs.org/sshpk/-/sshpk-1.18.0.tgz", - "integrity": "sha512-2p2KJZTSqQ/I3+HX42EpYOa2l3f8Erv8MWKsy2I9uf4wA7yFIkXRffYdsx86y6z4vHtV8u7g+pPlr8/4ouAxsQ==", - "dev": true, - "dependencies": { - "asn1": "~0.2.3", - "assert-plus": "^1.0.0", - "bcrypt-pbkdf": "^1.0.0", - "dashdash": "^1.12.0", - "ecc-jsbn": "~0.1.1", - "getpass": "^0.1.1", - "jsbn": "~0.1.0", - "safer-buffer": "^2.0.2", - "tweetnacl": "~0.14.0" - }, - "bin": { - "sshpk-conv": "bin/sshpk-conv", - "sshpk-sign": "bin/sshpk-sign", - "sshpk-verify": "bin/sshpk-verify" - }, - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/stack-utils": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz", @@ -5316,15 +4831,6 @@ "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==", "dev": true }, - "node_modules/to-fast-properties": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz", - "integrity": "sha512-/OaKK0xYrs3DmxRYqL/yDc+FxFUVYhDlXMhRmv3z915w2HF1tnN1omB354j8VUGO/hbRzyD6Y3sA7v7GS/ceog==", - "dev": true, - "engines": { - "node": ">=4" - } - }, "node_modules/to-regex-range": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", @@ -5337,19 +4843,6 @@ "node": ">=8.0" } }, - "node_modules/tough-cookie": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.5.0.tgz", - "integrity": "sha512-nlLsUzgm1kfLXSXfRZMc1KLAugd4hqJHDTvc2hDIwS3mZAfMEuMbc03SujMF+GEcpaX/qboeycw6iO8JwVv2+g==", - "dev": true, - "dependencies": { - "psl": "^1.1.28", - "punycode": "^2.1.1" - }, - "engines": { - "node": ">=0.8" - } - }, "node_modules/trim-newlines": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-3.0.1.tgz", @@ -5480,24 +4973,6 @@ "node": ">=0.3.1" } }, - "node_modules/tunnel-agent": { - "version": "0.6.0", - "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", - "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", - "dev": true, - "dependencies": { - "safe-buffer": "^5.0.1" - }, - "engines": { - "node": "*" - } - }, - "node_modules/tweetnacl": { - "version": "0.14.5", - "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz", - "integrity": "sha512-KXXFFdAbFXY4geFIwoyNK+f5Z1b7swfXABfL7HXCmoIWMKU3dmS26672A4EeQtDzLKy7SXmfBu51JolvEKwtGA==", - "dev": true - }, "node_modules/type-detect": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.1.0.tgz", @@ -5581,31 +5056,12 @@ "browserslist": ">= 4.21.0" } }, - "node_modules/uri-js": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", - "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", - "dev": true, - "dependencies": { - "punycode": "^2.1.0" - } - }, "node_modules/util-deprecate": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", "dev": true }, - "node_modules/uuid": { - "version": "3.4.0", - "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.4.0.tgz", - "integrity": "sha512-HjSDRw6gZE5JMggctHBcjVak08+KEVhSIiDzFnT9S9aegmp85S/bReBVTb4QTFaRNptJ9kuYaNhnbNEOkbKb/A==", - "deprecated": "Please upgrade to version 7 or higher. Older versions may use Math.random() in certain circumstances, which is known to be problematic. See https://v8.dev/blog/math-random for details.", - "dev": true, - "bin": { - "uuid": "bin/uuid" - } - }, "node_modules/v8-compile-cache-lib": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz", @@ -5636,20 +5092,6 @@ "spdx-expression-parse": "^3.0.0" } }, - "node_modules/verror": { - "version": "1.10.0", - "resolved": "https://registry.npmjs.org/verror/-/verror-1.10.0.tgz", - "integrity": "sha512-ZZKSmDAEFOijERBLkmYfJ+vmk3w+7hOLYDNkRCuRuMJGEmqYNCNLyBBFwWKVMhfwaEF3WOd0Zlw86U/WC/+nYw==", - "dev": true, - "engines": [ - "node >=0.6.0" - ], - "dependencies": { - "assert-plus": "^1.0.0", - "core-util-is": "1.0.2", - "extsprintf": "^1.2.0" - } - }, "node_modules/walker": { "version": "1.0.8", "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz", diff --git a/package.json b/package.json index fa40998..3247729 100644 --- a/package.json +++ b/package.json @@ -29,9 +29,6 @@ "test:coverage": "jest --collect-coverage tests/unit", "pretest:integration": "npm run build", "test:integration": "jest --verbose examples/user-domain-tests", - "pretest:coveralls": "npm run test:coverage", - "test:coveralls": "cat ./coverage/lcov.info | coveralls", - "posttest:coveralls": "rm -rf ./coverage", "changelog": "conventional-changelog -n ./scripts/changelog -i CHANGELOG.md -s", "clean": "tsc --build --clean", "build": "tsc --build", @@ -52,7 +49,6 @@ "@types/sinon": "^10.0.20", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "coveralls": "^3.1.1", "jest": "^29.7.0", "sinon": "^15.2.0", "ts-jest": "^29.2.4", From 7babd038f068b280e674d42a3f54bed29b056613 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 14 Mar 2025 01:12:18 +0000 Subject: [PATCH 013/169] Update github actions --- .github/workflows/audit.yml | 6 +++--- .github/workflows/coveralls.yml | 6 +++--- .github/workflows/publish.yml | 6 +++--- .github/workflows/tests.yml | 4 ++-- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/.github/workflows/audit.yml b/.github/workflows/audit.yml index 3df82f2..9ad2354 100644 --- a/.github/workflows/audit.yml +++ b/.github/workflows/audit.yml @@ -11,11 +11,11 @@ jobs: runs-on: ubuntu-latest strategy: matrix: - node-version: [20.x] + node-version: [22.x] steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v3 + uses: actions/setup-node@v4 with: node-version: ${{ matrix.node-version }} - run: npm audit --parseable --production --audit-level=moderate diff --git a/.github/workflows/coveralls.yml b/.github/workflows/coveralls.yml index f092473..413b288 100644 --- a/.github/workflows/coveralls.yml +++ b/.github/workflows/coveralls.yml @@ -10,11 +10,11 @@ jobs: runs-on: ubuntu-latest strategy: matrix: - node-version: [20.x] + node-version: [22.x] steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v3 + uses: actions/setup-node@v4 with: node-version: ${{ matrix.node-version }} - run: npm ci --no-optional diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index 058a839..2cee9cd 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -11,12 +11,12 @@ jobs: steps: - name: Checkout code - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Set up Node.js - uses: actions/setup-node@v3 + uses: actions/setup-node@v4 with: - node-version: '20' + node-version: '22' registry-url: 'https://registry.npmjs.org' - name: Install dependencies diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 3b35bb3..2fe7111 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -13,9 +13,9 @@ jobs: matrix: node-version: [18.x, 20.x, 22.x] steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v3 + uses: actions/setup-node@v4 with: node-version: ${{ matrix.node-version }} - run: npm ci --no-optional From 9878c3acd2484c34d43b831ed40954559eec4971 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 16 Mar 2025 02:24:13 +0000 Subject: [PATCH 014/169] Refactoring --- package-lock.json | 42 +++++++- package.json | 5 +- src/index.ts | 8 +- src/infrastructure/memory/index.ts | 1 + .../sqlite/AbstractSqliteView.ts | 101 +++++++++++------- src/infrastructure/sqlite/ObjectSqliteView.ts | 10 +- src/infrastructure/sqlite/index.ts | 1 + src/infrastructure/sqlite/utils/getEventId.ts | 8 ++ src/infrastructure/sqlite/utils/guid.ts | 4 + src/infrastructure/sqlite/utils/index.ts | 2 + 10 files changed, 129 insertions(+), 53 deletions(-) create mode 100644 src/infrastructure/sqlite/utils/getEventId.ts create mode 100644 src/infrastructure/sqlite/utils/guid.ts create mode 100644 src/infrastructure/sqlite/utils/index.ts diff --git a/package-lock.json b/package-lock.json index ce0c394..b445f61 100644 --- a/package-lock.json +++ b/package-lock.json @@ -32,7 +32,8 @@ "node": ">=10.3.0" }, "peerDependencies": { - "better-sqlite3": "^11.3.0" + "better-sqlite3": "^11.3.0", + "md5": "^2.3.0" } }, "node_modules/@ampproject/remapping": { @@ -1945,6 +1946,16 @@ "node": ">=10" } }, + "node_modules/charenc": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz", + "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==", + "license": "BSD-3-Clause", + "peer": true, + "engines": { + "node": "*" + } + }, "node_modules/check-error": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.3.tgz", @@ -2386,6 +2397,16 @@ "node": ">= 8" } }, + "node_modules/crypt": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz", + "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==", + "license": "BSD-3-Clause", + "peer": true, + "engines": { + "node": "*" + } + }, "node_modules/dargs": { "version": "7.0.0", "resolved": "https://registry.npmjs.org/dargs/-/dargs-7.0.0.tgz", @@ -3398,6 +3419,13 @@ "dev": true, "license": "MIT" }, + "node_modules/is-buffer": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", + "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==", + "license": "MIT", + "peer": true + }, "node_modules/is-core-module": { "version": "2.15.1", "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.15.1.tgz", @@ -4630,6 +4658,18 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/md5": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/md5/-/md5-2.3.0.tgz", + "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==", + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "charenc": "0.0.2", + "crypt": "0.0.2", + "is-buffer": "~1.1.6" + } + }, "node_modules/meow": { "version": "8.1.2", "resolved": "https://registry.npmjs.org/meow/-/meow-8.1.2.tgz", diff --git a/package.json b/package.json index 5f8d411..e190ace 100644 --- a/package.json +++ b/package.json @@ -63,6 +63,7 @@ "uuid": "^10.0.0" }, "peerDependencies": { - "better-sqlite3": "^11.3.0" + "better-sqlite3": "^11.3.0", + "md5": "^2.3.0" } -} \ No newline at end of file +} diff --git a/src/index.ts b/src/index.ts index 9bbea12..31360d3 100644 --- a/src/index.ts +++ b/src/index.ts @@ -9,12 +9,8 @@ export * from './AbstractSaga'; export * from './SagaEventHandler'; export * from './AbstractProjection'; -export * from './infrastructure/memory/InMemoryMessageBus'; -export * from './infrastructure/memory/InMemoryEventStorage'; -export * from './infrastructure/memory/InMemorySnapshotStorage'; -export * from './infrastructure/memory/InMemoryView'; -export * from './infrastructure/memory/InMemoryLock'; -export * from './infrastructure/memory/utils/Deferred'; +export * from './infrastructure/memory'; +export * as SQLite from './infrastructure/sqlite'; export * as Event from './Event'; export { diff --git a/src/infrastructure/memory/index.ts b/src/infrastructure/memory/index.ts index 3ef457a..3f6f779 100644 --- a/src/infrastructure/memory/index.ts +++ b/src/infrastructure/memory/index.ts @@ -3,3 +3,4 @@ export * from './InMemoryLock'; export * from './InMemoryMessageBus'; export * from './InMemorySnapshotStorage'; export * from './InMemoryView'; +export * from './utils/Deferred'; diff --git a/src/infrastructure/sqlite/AbstractSqliteView.ts b/src/infrastructure/sqlite/AbstractSqliteView.ts index 8d62c79..ff2f022 100644 --- a/src/infrastructure/sqlite/AbstractSqliteView.ts +++ b/src/infrastructure/sqlite/AbstractSqliteView.ts @@ -1,58 +1,73 @@ import { IEvent } from '../../interfaces/IEvent'; import { IExtendableLogger, ILogger } from '../../interfaces/ILogger'; import { IPersistentView } from '../../interfaces/IPersistentView'; - -const guid = (str: string) => Buffer.from(str.replaceAll('-', ''), 'hex'); - -const EVENT_PROCESSING_LOCK_TTL = 15; // sec +import { getEventId } from './utils'; +import { Database, Statement } from 'better-sqlite3'; export type AbstractSqliteViewOptions = { - schemaVersion: string; - sqliteDb: import('better-sqlite3').Database; + schemaVersion?: string; + sqliteDb: Database; viewLockTableName?: string; logger?: IExtendableLogger | ILogger; + eventProcessingLockTtl?: number; + viewRestoringLockTtl?: number; } export abstract class AbstractSqliteView implements IPersistentView { - /** - * Version of the the schema representing the structure of the data stored in the view - */ - readonly schemaVersion: string; + #schemaVersion: string | undefined; + #viewLockTableName: string | undefined; + #getLastEventQuery: Statement; + #lockEventQuery: Statement<[Buffer], void>; + #finalizeEventLockQuery: Statement<[Buffer], void>; + #recordLastEventQuery: Statement<[string, string, string], void>; + #upsertTableLockQuery: Statement<[string, string], void>; + #removeTableLockQuery: Statement<[string, string], void>; + #eventProcessingLockTtl: number; + #viewRestoringLockTtl: number; + + protected db: Database; + protected logger: ILogger | undefined; /** - * Shared table where view locks and last projected events are tracked + * Shared table tracking view locks and last projected events. + * Defaults to "tbl_view_lock" if not provided or overridden. */ - readonly viewLockTableName: string; + get viewLockTableName(): string { + return this.#viewLockTableName ?? 'tbl_view_lock'; + } /** - * Main table where the view data is stored - * - * @example `tbl_users_${this.schemaVersion}` + * Version of the schema representing the structure of data stored in the view */ - abstract get tableName(): string; + get schemaVersion(): string { + if (!this.#schemaVersion) + throw new Error(`schemaVersion is not defined. Either pass it to constructor, or override the getter`); + + return this.#schemaVersion; + } /** * Table where events are being tracked as projecting/projected * * @example `tbl_users_${this.schemaVersion}_event_lock` */ - abstract get eventLockTableName(): string; - - protected db: import('better-sqlite3').Database; - protected logger: ILogger | undefined; - - #getLastEventQuery: import('better-sqlite3').Statement; - #lockEventQuery: import('better-sqlite3').Statement<[Buffer], void>; - #finalizeEventLockQuery: import('better-sqlite3').Statement<[Buffer], void>; - #recordLastEventQuery: import('better-sqlite3').Statement<[string, string, string], void>; - #upsertTableLockQuery: import('better-sqlite3').Statement<[string, string], void>; - #removeTableLockQuery: import('better-sqlite3').Statement<[string, string], void>; + get eventLockTableName(): string { + return `${this.tableName}_event_lock`; + } + /** + * Main table where the view data is stored + * + * @example `tbl_users_${this.schemaVersion}` + */ + abstract get tableName(): string; constructor(options: AbstractSqliteViewOptions) { - this.schemaVersion = options.schemaVersion; - this.viewLockTableName = options.viewLockTableName ?? 'tbl_view_lock'; + this.#schemaVersion = options.schemaVersion; + this.#viewLockTableName = options.viewLockTableName; + this.#eventProcessingLockTtl = options.eventProcessingLockTtl ?? 15; + this.#viewRestoringLockTtl = options.viewRestoringLockTtl ?? 120; this.db = options.sqliteDb; this.logger = options.logger && 'child' in options.logger ? options.logger.child({ service: this.constructor.name }) : @@ -97,7 +112,7 @@ export abstract class AbstractSqliteView implements IPersistentView { processing_at = strftime('%s', 'now') WHERE processed_at IS NULL - AND processing_at <= strftime('%s', 'now') - ${EVENT_PROCESSING_LOCK_TTL} + AND processing_at <= strftime('%s', 'now') - ${this.#eventProcessingLockTtl} `); this.#finalizeEventLockQuery = this.db.prepare(` @@ -137,6 +152,8 @@ export abstract class AbstractSqliteView implements IPersistentView { AND schema_version = ? AND locked_at IS NOT NULL `); + + this.logger?.info(`View "${this.constructor.name}" lock tables initialized`); } getLastEvent() { @@ -148,19 +165,17 @@ export abstract class AbstractSqliteView implements IPersistentView { } tryMarkAsProjecting(event: IEvent) { - if (!event.id) - throw new TypeError('event.id is required'); + const eventId = getEventId(event); - const r = this.#lockEventQuery.run(guid(event.id)); + const r = this.#lockEventQuery.run(eventId); return r.changes !== 0; } markAsProjected(event: IEvent) { - if (!event.id) - throw new TypeError('event.id is required'); + const eventId = getEventId(event); - const updateResult = this.#finalizeEventLockQuery.run(guid(event.id)); + const updateResult = this.#finalizeEventLockQuery.run(eventId); if (updateResult.changes === 0) throw new Error(`Event ${event.id} could not be marked as processed`); @@ -173,14 +188,18 @@ export abstract class AbstractSqliteView implements IPersistentView { this.ready = false; const upsertResult = this.#upsertTableLockQuery.run(this.tableName, this.schemaVersion); - if (upsertResult.changes === 1) + + if (upsertResult.changes === 1) { this.logger?.debug(`Table "${this.tableName}" lock obtained`); - else - this.logger?.debug(`Table "${this.tableName}" is already locked`); - // TODO: automatic lock prolongation + // TODO: automatic lock prolongation - return upsertResult.changes === 1; + return true; + } + else { + this.logger?.debug(`Table "${this.tableName}" is already locked`); + return false; + } } async unlock(): Promise { diff --git a/src/infrastructure/sqlite/ObjectSqliteView.ts b/src/infrastructure/sqlite/ObjectSqliteView.ts index bf244e6..c919e05 100644 --- a/src/infrastructure/sqlite/ObjectSqliteView.ts +++ b/src/infrastructure/sqlite/ObjectSqliteView.ts @@ -1,8 +1,7 @@ import * as BetterSqlite3 from 'better-sqlite3'; import { AbstractSqliteView, AbstractSqliteViewOptions } from "./AbstractSqliteView"; import { IObjectView, IPersistentView } from '../../interfaces'; - -const guid = (str: string) => Buffer.from(str.replaceAll('-', ''), 'hex'); +import { guid } from './utils'; export class ObjectSqliteView extends AbstractSqliteView implements IObjectView, IPersistentView { @@ -20,7 +19,10 @@ export class ObjectSqliteView extends AbstractSqliteView implements IOb return `${this.#tableNamePrefix}_${this.schemaVersion}_event_lock`; } - constructor(options: AbstractSqliteViewOptions & { tableNamePrefix: string }) { + constructor(options: AbstractSqliteViewOptions & { + tableNamePrefix: string, + schemaVersion: string + }) { if (typeof options.tableNamePrefix !== 'string' || !options.tableNamePrefix.length) throw new TypeError('options.tableNamePrefix argument must be a non-empty String'); @@ -65,6 +67,8 @@ export class ObjectSqliteView extends AbstractSqliteView implements IOb DELETE FROM ${this.tableName} WHERE id = ? `); + + this.logger?.info(`Table "${this.tableName}" initialized`); } get(id: string): TRecord | undefined { diff --git a/src/infrastructure/sqlite/index.ts b/src/infrastructure/sqlite/index.ts index e6c6429..113bcfa 100644 --- a/src/infrastructure/sqlite/index.ts +++ b/src/infrastructure/sqlite/index.ts @@ -1,2 +1,3 @@ export * from './AbstractSqliteView'; export * from './ObjectSqliteView'; +export * from './utils'; diff --git a/src/infrastructure/sqlite/utils/getEventId.ts b/src/infrastructure/sqlite/utils/getEventId.ts new file mode 100644 index 0000000..62fc2ac --- /dev/null +++ b/src/infrastructure/sqlite/utils/getEventId.ts @@ -0,0 +1,8 @@ +import { IEvent } from "../../../interfaces"; +import * as md5 from 'md5'; +import { guid } from './guid'; + +/** + * Get assigned or generate new event ID from event content + */ +export const getEventId = (event: IEvent): Buffer => guid(event.id ?? md5(JSON.stringify(event))); diff --git a/src/infrastructure/sqlite/utils/guid.ts b/src/infrastructure/sqlite/utils/guid.ts new file mode 100644 index 0000000..e8ce86c --- /dev/null +++ b/src/infrastructure/sqlite/utils/guid.ts @@ -0,0 +1,4 @@ +/** + * Convert Guid to Buffer for storing in Sqlite BLOB + */ +export const guid = (str: string) => Buffer.from(str.replaceAll('-', ''), 'hex'); diff --git a/src/infrastructure/sqlite/utils/index.ts b/src/infrastructure/sqlite/utils/index.ts new file mode 100644 index 0000000..f27b49b --- /dev/null +++ b/src/infrastructure/sqlite/utils/index.ts @@ -0,0 +1,2 @@ +export * from './guid'; +export * from './getEventId'; From 8c5ec26b69f9f98bc3f3ebfc568da4793d8f9e76 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 20 Mar 2025 01:24:59 +0000 Subject: [PATCH 015/169] Refactoring and tests --- examples/user-domain/index.js | 4 +- package-lock.json | 75 +++--- package.json | 4 +- src/AbstractProjection.ts | 119 +++++---- src/infrastructure/memory/InMemoryView.ts | 5 +- .../sqlite/AbstractSqliteObjectProjection.ts | 27 ++ .../sqlite/AbstractSqliteView.ts | 231 +++--------------- src/infrastructure/sqlite/ObjectSqliteView.ts | 128 ---------- .../sqlite/SqliteEventLocker.ts | 131 ++++++++++ .../sqlite/SqliteObjectStorage.ts | 110 +++++++++ src/infrastructure/sqlite/SqliteObjectView.ts | 44 ++++ src/infrastructure/sqlite/SqliteViewLocker.ts | 173 +++++++++++++ src/infrastructure/sqlite/commonParams.ts | 22 ++ src/infrastructure/sqlite/index.ts | 5 +- .../sqlite/queries/eventLockTableInit.ts | 10 + src/infrastructure/sqlite/queries/index.ts | 2 + .../sqlite/queries/viewLockTableInit.ts | 9 + src/interfaces/IEventLocker.ts | 34 +++ .../{IObjectView.ts => IObjectStorage.ts} | 2 +- src/interfaces/IPersistentView.ts | 24 -- src/interfaces/IProjection.ts | 2 +- src/interfaces/IProjectionView.ts | 22 -- src/interfaces/IViewLocker.ts | 46 ++++ src/interfaces/index.ts | 6 +- src/interfaces/isObject.ts | 5 + tests/integration/SqliteView.test.ts | 39 ++- tests/unit/AbstractProjection.test.ts | 22 +- .../{ => memory}/InMemoryEventStorage.test.ts | 2 +- .../{ => memory}/InMemoryMessageBus.test.ts | 4 +- tests/unit/{ => memory}/InMemoryView.test.ts | 4 +- tests/unit/sqlite/SqliteEventLocker.test.ts | 97 ++++++++ tests/unit/sqlite/SqliteObjectStorage.test.ts | 86 +++++++ tests/unit/sqlite/SqliteViewLocker.test.ts | 109 +++++++++ 33 files changed, 1078 insertions(+), 525 deletions(-) create mode 100644 src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts delete mode 100644 src/infrastructure/sqlite/ObjectSqliteView.ts create mode 100644 src/infrastructure/sqlite/SqliteEventLocker.ts create mode 100644 src/infrastructure/sqlite/SqliteObjectStorage.ts create mode 100644 src/infrastructure/sqlite/SqliteObjectView.ts create mode 100644 src/infrastructure/sqlite/SqliteViewLocker.ts create mode 100644 src/infrastructure/sqlite/commonParams.ts create mode 100644 src/infrastructure/sqlite/queries/eventLockTableInit.ts create mode 100644 src/infrastructure/sqlite/queries/index.ts create mode 100644 src/infrastructure/sqlite/queries/viewLockTableInit.ts create mode 100644 src/interfaces/IEventLocker.ts rename src/interfaces/{IObjectView.ts => IObjectStorage.ts} (88%) delete mode 100644 src/interfaces/IPersistentView.ts delete mode 100644 src/interfaces/IProjectionView.ts create mode 100644 src/interfaces/IViewLocker.ts create mode 100644 src/interfaces/isObject.ts rename tests/unit/{ => memory}/InMemoryEventStorage.test.ts (98%) rename tests/unit/{ => memory}/InMemoryMessageBus.test.ts (95%) rename tests/unit/{ => memory}/InMemoryView.test.ts (98%) create mode 100644 tests/unit/sqlite/SqliteEventLocker.test.ts create mode 100644 tests/unit/sqlite/SqliteObjectStorage.test.ts create mode 100644 tests/unit/sqlite/SqliteViewLocker.test.ts diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index 11e2bee..75d239c 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -19,7 +19,7 @@ exports.createContainer = () => { // register infrastructure services builder.register(InMemoryEventStorage).as('storage'); - builder.register(InMemoryMessageBus).as('messageBus'); + builder.register(InMemoryMessageBus).as('supplementaryEventBus'); // register domain entities builder.registerAggregate(UserAggregate); @@ -36,7 +36,7 @@ exports.createBaseInstances = () => { // create infrastructure services const messageBus = new InMemoryMessageBus(); const storage = new InMemoryEventStorage(); - const eventStore = new EventStore({ storage, messageBus }); + const eventStore = new EventStore({ storage, supplementaryEventBus: messageBus }); const commandBus = new CommandBus({ messageBus }); /** @type {IAggregateConstructor} */ diff --git a/package-lock.json b/package-lock.json index b445f61..68b2cc8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -16,13 +16,13 @@ "@types/chai": "^4.3.20", "@types/jest": "^29.5.13", "@types/node": "^20.16.9", - "@types/sinon": "^10.0.20", + "@types/sinon": "^17.0.4", "@types/uuid": "^10.0.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "coveralls": "^3.1.1", "jest": "^29.7.0", - "sinon": "^15.2.0", + "sinon": "^19.0.2", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", "typescript": "^5.6.2", @@ -1286,9 +1286,9 @@ "license": "MIT" }, "node_modules/@types/sinon": { - "version": "10.0.20", - "resolved": "https://registry.npmjs.org/@types/sinon/-/sinon-10.0.20.tgz", - "integrity": "sha512-2APKKruFNCAZgx3daAyACGzWuJ028VVCUDk6o2rw/Z4PXT0ogwdV4KUegW0MwVs0Zu59auPXbbuBJHF12Sx1Eg==", + "version": "17.0.4", + "resolved": "https://registry.npmjs.org/@types/sinon/-/sinon-17.0.4.tgz", + "integrity": "sha512-RHnIrhfPO3+tJT0s7cFaXGZvsL4bbR3/k7z3P312qMS4JaS2Tk+KiwiLx1S0rQ56ERj00u1/BtdyVd0FY+Pdew==", "dev": true, "license": "MIT", "dependencies": { @@ -2596,9 +2596,9 @@ "license": "MIT" }, "node_modules/diff": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.0.tgz", - "integrity": "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A==", + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/diff/-/diff-7.0.0.tgz", + "integrity": "sha512-PJWHUb1RFevKCwaFA9RlG5tCd+FO5iRh9A8HEtkmBH2Li03iJriB6m6JIN4rGz3K3JLawI7/veA1xzRKP6ISBw==", "dev": true, "license": "BSD-3-Clause", "engines": { @@ -4549,6 +4549,7 @@ "version": "4.4.2", "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz", "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==", + "deprecated": "This package is deprecated. Use the optional chaining (?.) operator instead.", "dev": true, "license": "MIT" }, @@ -4953,23 +4954,23 @@ "license": "MIT" }, "node_modules/nise": { - "version": "5.1.9", - "resolved": "https://registry.npmjs.org/nise/-/nise-5.1.9.tgz", - "integrity": "sha512-qOnoujW4SV6e40dYxJOb3uvuoPHtmLzIk4TFo+j0jPJoC+5Z9xja5qH5JZobEPsa8+YYphMrOSwnrshEhG2qww==", + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/nise/-/nise-6.1.1.tgz", + "integrity": "sha512-aMSAzLVY7LyeM60gvBS423nBmIPP+Wy7St7hsb+8/fc1HmeoHJfLO8CKse4u3BtOZvQLJghYPI2i/1WZrEj5/g==", "dev": true, "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^3.0.0", - "@sinonjs/fake-timers": "^11.2.2", - "@sinonjs/text-encoding": "^0.7.2", + "@sinonjs/commons": "^3.0.1", + "@sinonjs/fake-timers": "^13.0.1", + "@sinonjs/text-encoding": "^0.7.3", "just-extend": "^6.2.0", - "path-to-regexp": "^6.2.1" + "path-to-regexp": "^8.1.0" } }, "node_modules/nise/node_modules/@sinonjs/fake-timers": { - "version": "11.3.1", - "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-11.3.1.tgz", - "integrity": "sha512-EVJO7nW5M/F5Tur0Rf2z/QoMo+1Ia963RiMtapiQrEWvY0iBUvADo8Beegwjpnle5BHkyHuoxSTW3jF43H1XRA==", + "version": "13.0.5", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-13.0.5.tgz", + "integrity": "sha512-36/hTbH2uaWuGVERyC6da9YwGWnzUZXuPro/F2LfsdOsLnCojz/iSH8MxUt/FD2S5XBSVPhmArFUXcpCQ2Hkiw==", "dev": true, "license": "BSD-3-Clause", "dependencies": { @@ -5215,11 +5216,14 @@ "license": "MIT" }, "node_modules/path-to-regexp": { - "version": "6.3.0", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.3.0.tgz", - "integrity": "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==", + "version": "8.2.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.2.0.tgz", + "integrity": "sha512-TdrF7fW9Rphjq4RjrW0Kp2AW0Ahwu9sRGTkS6bvDi0SCwZlEZYmcfDbEsTz8RVk0EHIS/Vd1bv3JhG+1xZuAyQ==", "dev": true, - "license": "MIT" + "license": "MIT", + "engines": { + "node": ">=16" + } }, "node_modules/path-type": { "version": "3.0.0", @@ -5880,18 +5884,17 @@ } }, "node_modules/sinon": { - "version": "15.2.0", - "resolved": "https://registry.npmjs.org/sinon/-/sinon-15.2.0.tgz", - "integrity": "sha512-nPS85arNqwBXaIsFCkolHjGIkFo+Oxu9vbgmBJizLAhqe6P2o3Qmj3KCUoRkfhHtvgDhZdWD3risLHAUJ8npjw==", - "deprecated": "16.1.1", + "version": "19.0.2", + "resolved": "https://registry.npmjs.org/sinon/-/sinon-19.0.2.tgz", + "integrity": "sha512-euuToqM+PjO4UgXeLETsfQiuoyPXlqFezr6YZDFwHR3t4qaX0fZUe1MfPMznTL5f8BWrVS89KduLdMUsxFCO6g==", "dev": true, "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^3.0.0", - "@sinonjs/fake-timers": "^10.3.0", - "@sinonjs/samsam": "^8.0.0", - "diff": "^5.1.0", - "nise": "^5.1.4", + "@sinonjs/commons": "^3.0.1", + "@sinonjs/fake-timers": "^13.0.2", + "@sinonjs/samsam": "^8.0.1", + "diff": "^7.0.0", + "nise": "^6.1.1", "supports-color": "^7.2.0" }, "funding": { @@ -5899,6 +5902,16 @@ "url": "https://opencollective.com/sinon" } }, + "node_modules/sinon/node_modules/@sinonjs/fake-timers": { + "version": "13.0.5", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-13.0.5.tgz", + "integrity": "sha512-36/hTbH2uaWuGVERyC6da9YwGWnzUZXuPro/F2LfsdOsLnCojz/iSH8MxUt/FD2S5XBSVPhmArFUXcpCQ2Hkiw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@sinonjs/commons": "^3.0.1" + } + }, "node_modules/sisteransi": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", diff --git a/package.json b/package.json index e190ace..19141af 100644 --- a/package.json +++ b/package.json @@ -50,13 +50,13 @@ "@types/chai": "^4.3.20", "@types/jest": "^29.5.13", "@types/node": "^20.16.9", - "@types/sinon": "^10.0.20", + "@types/sinon": "^17.0.4", "@types/uuid": "^10.0.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "coveralls": "^3.1.1", "jest": "^29.7.0", - "sinon": "^15.2.0", + "sinon": "^19.0.2", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", "typescript": "^5.6.2", diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 157dad8..87aaef7 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -1,14 +1,16 @@ import { describe } from './Event'; import { InMemoryView } from './infrastructure/memory/InMemoryView'; import { - IProjectionView, - IPersistentView, + IViewLocker, + IEventLocker, IProjection, - IViewFactory, ILogger, IExtendableLogger, IEventStore, - IEvent + IEvent, + isViewLocker, + isEventLocker, + IViewFactory } from './interfaces'; import { @@ -19,24 +21,30 @@ import { subscribe } from './utils'; -const isProjectionView = (view: IProjectionView): view is IProjectionView => - 'ready' in view && - 'lock' in view && - 'unlock' in view && - 'once' in view; +export type AbstractProjectionParams = { + /** + * (Optional) Default view associated with the projection + */ + view?: T, -const asProjectionView = (view: any): IProjectionView | undefined => - (isProjectionView(view) ? view : undefined); + /** + * Instance for managing view restoration state to prevent early access to an inconsistent view + * or conflicts caused by concurrent restoration by another process. + */ + viewLocker?: IViewLocker, -const isPersistentView = (view: any): view is IPersistentView => - 'getLastEvent' in view && - 'tryMarkAsProjecting' in view && - 'markAsProjected' in view; + /** + * Instance for tracking event processing state to prevent concurrent processing by multiple processes. + */ + eventLocker?: IEventLocker, + + logger?: ILogger | IExtendableLogger +} /** * Base class for Projection definition */ -export abstract class AbstractProjection implements IProjection { +export abstract class AbstractProjection> implements IProjection { /** * Optional list of event types being handled by projection. @@ -47,50 +55,38 @@ export abstract class AbstractProjection; - #view?: TView; - - protected _logger?: ILogger; + protected set view(value: TView) { + this.#view = value; + } - get collectionName(): string { - return getClassName(this); + protected get _viewLocker(): IViewLocker | undefined { + return this.#viewLocker ?? (isViewLocker(this.view) ? this.view : undefined); } - /** - * Indicates if view should be restored from EventStore on start. - * Override for custom behavior. - * - * @deprecated View must implement `getLastEvent()` instead - */ - get shouldRestoreView(): boolean | Promise { - throw new Error('shouldRestoreView is deprecated'); + protected get _eventLocker(): IEventLocker | undefined { + return this.#eventLocker ?? (isEventLocker(this.view) ? this.view : undefined); } constructor({ view, - viewFactory = InMemoryView.factory, + viewLocker, + eventLocker, logger - }: { - view?: TView, - viewFactory?: IViewFactory, - logger?: ILogger | IExtendableLogger - } = {}) { + }: AbstractProjectionParams = {}) { validateHandlers(this); - this.#view = view; - this.#viewFactory = viewFactory; + this.#view = view ?? new InMemoryView() as any; + this.#viewLocker = viewLocker; + this.#eventLocker = eventLocker; this._logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : @@ -108,9 +104,10 @@ export abstract class AbstractProjection { - const concurrentView = asProjectionView(this.view); - if (concurrentView && !concurrentView.ready) - await concurrentView.once('ready'); + if (this._viewLocker && !this._viewLocker?.ready) { + this._logger?.debug('view is locked, awaiting until it is ready'); + await this._viewLocker.once('ready'); + } return this._project(event); } @@ -121,31 +118,29 @@ export abstract class AbstractProjection { // lock the view to ensure same restoring procedure // won't be performed by another projection instance - const concurrentView = asProjectionView(this.view); - if (concurrentView) - await concurrentView.lock(); + if (this._viewLocker) + await this._viewLocker.lock(); await this._restore(eventStore); - if (concurrentView) - concurrentView.unlock(); + if (this._viewLocker) + this._viewLocker.unlock(); } /** Restore projection view from event store */ @@ -157,9 +152,9 @@ export abstract class AbstractProjection(view: T | undefined, update: (r?: T) => T | undefined): /** * In-memory Projection View, which suspends get()'s until it is ready */ -export class InMemoryView implements IProjectionView, IObjectView { +export class InMemoryView implements IViewLocker, IObjectStorage { static factory(): TView { return (new InMemoryView() as unknown) as TView; diff --git a/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts b/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts new file mode 100644 index 0000000..5c13f9a --- /dev/null +++ b/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts @@ -0,0 +1,27 @@ +import { AbstractProjection } from "../../AbstractProjection"; +import { IExtendableLogger } from "../../interfaces"; +import { SqliteDbParams } from "./commonParams"; +import { SqliteObjectView } from "./SqliteObjectView"; + +export abstract class AbstractSqliteObjectProjection extends AbstractProjection> { + + static get tableName(): string { + throw new Error('tableName is not defined'); + } + + static get schemaVersion(): string { + throw new Error('schemaVersion is not defined'); + } + + constructor({ viewModelSqliteDb, logger }: SqliteDbParams & { logger?: IExtendableLogger }) { + super({ logger }); + + this.view = new SqliteObjectView({ + schemaVersion: new.target.schemaVersion, + projectionName: new.target.name, + viewModelSqliteDb, + tableNamePrefix: new.target.tableName, + logger + }); + } +} diff --git a/src/infrastructure/sqlite/AbstractSqliteView.ts b/src/infrastructure/sqlite/AbstractSqliteView.ts index ff2f022..224aa97 100644 --- a/src/infrastructure/sqlite/AbstractSqliteView.ts +++ b/src/infrastructure/sqlite/AbstractSqliteView.ts @@ -1,221 +1,52 @@ -import { IEvent } from '../../interfaces/IEvent'; -import { IExtendableLogger, ILogger } from '../../interfaces/ILogger'; -import { IPersistentView } from '../../interfaces/IPersistentView'; -import { getEventId } from './utils'; -import { Database, Statement } from 'better-sqlite3'; - -export type AbstractSqliteViewOptions = { - schemaVersion?: string; - sqliteDb: Database; - viewLockTableName?: string; - logger?: IExtendableLogger | ILogger; - eventProcessingLockTtl?: number; - viewRestoringLockTtl?: number; -} - -export abstract class AbstractSqliteView implements IPersistentView { - - #schemaVersion: string | undefined; - #viewLockTableName: string | undefined; - #getLastEventQuery: Statement; - #lockEventQuery: Statement<[Buffer], void>; - #finalizeEventLockQuery: Statement<[Buffer], void>; - #recordLastEventQuery: Statement<[string, string, string], void>; - #upsertTableLockQuery: Statement<[string, string], void>; - #removeTableLockQuery: Statement<[string, string], void>; - #eventProcessingLockTtl: number; - #viewRestoringLockTtl: number; - - protected db: Database; +import { IEvent, IEventLocker, ILogger } from '../../interfaces'; +import { Database } from 'better-sqlite3'; +import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; +import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; +import { IViewLocker } from '../../interfaces'; + +export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { + + protected readonly db: Database; + protected readonly schemaVersion: string; + protected readonly viewLocker: SqliteViewLocker; + protected readonly eventLocker: SqliteEventLocker; protected logger: ILogger | undefined; - /** - * Shared table tracking view locks and last projected events. - * Defaults to "tbl_view_lock" if not provided or overridden. - */ - get viewLockTableName(): string { - return this.#viewLockTableName ?? 'tbl_view_lock'; + get ready(): boolean { + return this.viewLocker.ready; } - /** - * Version of the schema representing the structure of data stored in the view - */ - get schemaVersion(): string { - if (!this.#schemaVersion) - throw new Error(`schemaVersion is not defined. Either pass it to constructor, or override the getter`); - - return this.#schemaVersion; + constructor(options: SqliteEventLockerParams & SqliteViewLockerParams) { + this.db = options.viewModelSqliteDb; + this.schemaVersion = options.schemaVersion; + this.viewLocker = new SqliteViewLocker(options); + this.eventLocker = new SqliteEventLocker(options); + this.logger = options.logger && 'child' in options.logger ? + options.logger.child({ serviceName: new.target.name }) : + options.logger; } - /** - * Table where events are being tracked as projecting/projected - * - * @example `tbl_users_${this.schemaVersion}_event_lock` - */ - get eventLockTableName(): string { - return `${this.tableName}_event_lock`; + async lock() { + return this.viewLocker.lock(); } - /** - * Main table where the view data is stored - * - * @example `tbl_users_${this.schemaVersion}` - */ - abstract get tableName(): string; - - constructor(options: AbstractSqliteViewOptions) { - this.#schemaVersion = options.schemaVersion; - this.#viewLockTableName = options.viewLockTableName; - this.#eventProcessingLockTtl = options.eventProcessingLockTtl ?? 15; - this.#viewRestoringLockTtl = options.viewRestoringLockTtl ?? 120; - this.db = options.sqliteDb; - this.logger = options.logger && 'child' in options.logger ? - options.logger.child({ service: this.constructor.name }) : - options.logger; + unlock(): void { + this.viewLocker.unlock(); } - /** - * SQLite tables initialization. - * Must be called in the derived class before getting to work. - */ - protected initialize(): void { - this.db.exec(` - CREATE TABLE IF NOT EXISTS ${this.viewLockTableName} ( - table_name TEXT, - schema_version TEXT, - locked_at DATETIME DEFAULT (strftime('%s', 'now')), - last_event TEXT, - PRIMARY KEY (table_name, schema_version) - ); - - CREATE TABLE IF NOT EXISTS ${this.eventLockTableName} ( - event_id BLOB PRIMARY KEY, - processing_at DATETIME DEFAULT (strftime('%s', 'now')), - processed_at DATETIME - ); - `); - - this.#getLastEventQuery = this.db.prepare(` - SELECT - last_event - FROM ${this.viewLockTableName} - WHERE - table_name = ? - AND schema_version =? - `); - - this.#lockEventQuery = this.db.prepare(` - INSERT INTO ${this.eventLockTableName} (event_id) - VALUES (?) - ON CONFLICT (event_id) - DO UPDATE SET - processing_at = strftime('%s', 'now') - WHERE - processed_at IS NULL - AND processing_at <= strftime('%s', 'now') - ${this.#eventProcessingLockTtl} - `); - - this.#finalizeEventLockQuery = this.db.prepare(` - UPDATE ${this.eventLockTableName} - SET - processed_at = strftime('%s', 'now') - WHERE - event_id = ? - AND processed_at IS NULL - `); - - this.#recordLastEventQuery = this.db.prepare(` - UPDATE ${this.viewLockTableName} - SET - last_event = ? - WHERE - table_name = ? - AND schema_version = ? - `); - - this.#upsertTableLockQuery = this.db.prepare(` - INSERT INTO ${this.viewLockTableName} (table_name, schema_version, locked_at) - VALUES (?, ?, strftime('%s', 'now')) - ON CONFLICT (table_name, schema_version) - DO UPDATE SET - locked_at = excluded.locked_at - WHERE - locked_at IS NULL - `); - - this.#removeTableLockQuery = this.db.prepare(` - UPDATE ${this.viewLockTableName} - SET - locked_at = NULL - WHERE - table_name = ? - AND schema_version = ? - AND locked_at IS NOT NULL - `); - - this.logger?.info(`View "${this.constructor.name}" lock tables initialized`); + once(event: 'ready') { + return this.viewLocker.once(event); } getLastEvent() { - const tableInfoRecord = this.#getLastEventQuery.get(this.tableName, this.schemaVersion); - if (!tableInfoRecord?.last_event) - return undefined; - - return JSON.parse(tableInfoRecord.last_event); + return this.eventLocker.getLastEvent(); } tryMarkAsProjecting(event: IEvent) { - const eventId = getEventId(event); - - const r = this.#lockEventQuery.run(eventId); - - return r.changes !== 0; + return this.eventLocker.tryMarkAsProjecting(event); } markAsProjected(event: IEvent) { - const eventId = getEventId(event); - - const updateResult = this.#finalizeEventLockQuery.run(eventId); - if (updateResult.changes === 0) - throw new Error(`Event ${event.id} could not be marked as processed`); - - this.#recordLastEventQuery.run(JSON.stringify(event), this.tableName, this.schemaVersion); - } - - ready: boolean = false; - - lock() { - this.ready = false; - - const upsertResult = this.#upsertTableLockQuery.run(this.tableName, this.schemaVersion); - - if (upsertResult.changes === 1) { - this.logger?.debug(`Table "${this.tableName}" lock obtained`); - - // TODO: automatic lock prolongation - - return true; - } - else { - this.logger?.debug(`Table "${this.tableName}" is already locked`); - return false; - } - } - - async unlock(): Promise { - const updateResult = this.#removeTableLockQuery.run(this.tableName, this.schemaVersion); - if (updateResult.changes === 1) - this.logger?.debug(`Table "${this.tableName}" lock released`); - else - this.logger?.debug(`Table "${this.tableName}" lock didn't exist`); - - this.ready = true; - } - - async once(eventType: 'ready'): Promise { - - // TODO: periodically check until unlocked - - throw new Error('Method not implemented'); + return this.eventLocker.markAsProjected(event); } } diff --git a/src/infrastructure/sqlite/ObjectSqliteView.ts b/src/infrastructure/sqlite/ObjectSqliteView.ts deleted file mode 100644 index c919e05..0000000 --- a/src/infrastructure/sqlite/ObjectSqliteView.ts +++ /dev/null @@ -1,128 +0,0 @@ -import * as BetterSqlite3 from 'better-sqlite3'; -import { AbstractSqliteView, AbstractSqliteViewOptions } from "./AbstractSqliteView"; -import { IObjectView, IPersistentView } from '../../interfaces'; -import { guid } from './utils'; - -export class ObjectSqliteView extends AbstractSqliteView implements IObjectView, IPersistentView { - - #tableNamePrefix: string; - #getQuery: BetterSqlite3.Statement<[Buffer], { data: string, version: number }>; - #insertQuery: BetterSqlite3.Statement<[Buffer, string], void>; - #updateByIdAndVersionQuery: BetterSqlite3.Statement<[string, Buffer, number], void>; - #deleteQuery: BetterSqlite3.Statement<[Buffer], void>; - - get tableName(): string { - return `${this.#tableNamePrefix}_${this.schemaVersion}`; - } - - get eventLockTableName(): string { - return `${this.#tableNamePrefix}_${this.schemaVersion}_event_lock`; - } - - constructor(options: AbstractSqliteViewOptions & { - tableNamePrefix: string, - schemaVersion: string - }) { - if (typeof options.tableNamePrefix !== 'string' || !options.tableNamePrefix.length) - throw new TypeError('options.tableNamePrefix argument must be a non-empty String'); - - super(options); - - this.#tableNamePrefix = options.tableNamePrefix; - - this.initialize(); - } - - protected initialize(): void { - super.initialize(); - - this.db.exec(`CREATE TABLE IF NOT EXISTS ${this.tableName} ( - id BLOB PRIMARY KEY, - version INTEGER DEFAULT 1, - data TEXT NOT NULL - );`); - - this.#getQuery = this.db.prepare(` - SELECT data, version - FROM ${this.tableName} - WHERE id = ? - `); - - this.#insertQuery = this.db.prepare(` - INSERT INTO ${this.tableName} (id, data) - VALUES (?, ?) - `); - - this.#updateByIdAndVersionQuery = this.db.prepare(` - UPDATE ${this.tableName} - SET - data = ?, - version = version + 1 - WHERE - id = ? - AND version = ? - `); - - this.#deleteQuery = this.db.prepare(` - DELETE FROM ${this.tableName} - WHERE id = ? - `); - - this.logger?.info(`Table "${this.tableName}" initialized`); - } - - get(id: string): TRecord | undefined { - const r = this.#getQuery.get(guid(id)); - if (!r) - return undefined; - - return JSON.parse(r.data); - } - - create(id: string, data: TRecord) { - const r = this.#insertQuery.run(guid(id), JSON.stringify(data)); - if (r.changes !== 1) - throw new Error(`Record '${id}' could not be created`); - } - - update(id: string, update: (r: TRecord) => TRecord) { - const gid = guid(id); - const record = this.#getQuery.get(gid); - if (!record) - throw new Error(`Record '${id}' does not exist`); - - const data = JSON.parse(record.data); - const updatedData = update(data); - const updatedJson = JSON.stringify(updatedData); - - const r = this.#updateByIdAndVersionQuery.run(updatedJson, gid, record.version); - if (r.changes !== 1) - throw new Error(`Record '${id}' could not be updated`); - } - - updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { - const gid = guid(id); - const record = this.#getQuery.get(gid); - if (record) { - const data = JSON.parse(record.data); - const updatedData = update(data); - const updatedJson = JSON.stringify(updatedData); - - const r = this.#updateByIdAndVersionQuery.run(updatedJson, gid, record.version); - if (r.changes !== 1) - throw new Error(`Record '${id}' could not be updated`); - } - else { - const newData = update(); - - const r = this.#insertQuery.run(guid(id), JSON.stringify(newData)); - if (r.changes !== 1) - throw new Error(`Record '${id}' could not be created`); - } - } - - delete(id: string): boolean { - const r = this.#deleteQuery.run(guid(id)); - return r.changes === 1; - } -} diff --git a/src/infrastructure/sqlite/SqliteEventLocker.ts b/src/infrastructure/sqlite/SqliteEventLocker.ts new file mode 100644 index 0000000..f99edcc --- /dev/null +++ b/src/infrastructure/sqlite/SqliteEventLocker.ts @@ -0,0 +1,131 @@ +import { Database, Statement } from 'better-sqlite3'; +import { IEvent, IEventLocker } from '../../interfaces'; +import { getEventId } from './utils'; +import { viewLockTableInit, eventLockTableInit } from './queries'; +import { SqliteViewLockerParams } from './SqliteViewLocker'; +import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; + +export type SqliteEventLockerParams = SqliteDbParams & SqliteProjectionDataParams & { + /** + * (Optional) SQLite table name where event locks are stored + * + * @default "tbl_event_lock" + */ + eventLockTableName?: string; + + /** + * (Optional) Time-to-live (TTL) duration in milliseconds + * for which an event remains in the "processing" state until released. + * + * @default 15_000 + */ + eventLockTtl?: number; +} + & Pick; + +export class SqliteEventLocker implements IEventLocker { + + #db: Database; + #projectionName: string; + #schemaVersion: string; + #viewLockTableName: string; + #eventLockTableName: string; + #eventLockTtl: number; + + #upsertLastEventQuery: Statement<[string, string, string], void>; + #getLastEventQuery: Statement<[string, string], { last_event: string }>; + #lockEventQuery: Statement<[string, string, Buffer], void>; + #finalizeEventLockQuery: Statement<[string, string, Buffer], void>; + + constructor(o: SqliteEventLockerParams) { + if (!o.viewModelSqliteDb) + throw new TypeError('viewModelSqliteDb argument required'); + if (!o.projectionName) + throw new TypeError('projectionName argument required'); + if (!o.schemaVersion) + throw new TypeError('schemaVersion argument required'); + + this.#db = o.viewModelSqliteDb; + this.#projectionName = o.projectionName; + this.#schemaVersion = o.schemaVersion; + this.#viewLockTableName = o.viewLockTableName ?? 'tbl_view_lock'; + this.#eventLockTableName = o.eventLockTableName ?? 'tbl_event_lock'; + this.#eventLockTtl = o.eventLockTtl ?? 15_000; + + this.#initialize(); + } + + #initialize() { + this.#db.exec(viewLockTableInit(this.#viewLockTableName)); + this.#db.exec(eventLockTableInit(this.#eventLockTableName)); + + this.#upsertLastEventQuery = this.#db.prepare(` + INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, last_event) + VALUES (?, ?, ?) + ON CONFLICT (projection_name, schema_version) + DO UPDATE SET + last_event = excluded.last_event + `); + + this.#getLastEventQuery = this.#db.prepare(` + SELECT + last_event + FROM ${this.#viewLockTableName} + WHERE + projection_name = ? + AND schema_version =? + `); + + this.#lockEventQuery = this.#db.prepare(` + INSERT INTO ${this.#eventLockTableName} (projection_name, schema_version, event_id) + VALUES (?, ?, ?) + ON CONFLICT (projection_name, schema_version, event_id) + DO UPDATE SET + processing_at = cast(strftime('%f', 'now') * 1000 as INTEGER) + WHERE + processed_at IS NULL + AND processing_at <= cast(strftime('%f', 'now') * 1000 as INTEGER) - ${this.#eventLockTtl} + `); + + this.#finalizeEventLockQuery = this.#db.prepare(` + UPDATE ${this.#eventLockTableName} + SET + processed_at = (cast(strftime('%f', 'now') * 1000 as INTEGER)) + WHERE + projection_name = ? + AND schema_version = ? + AND event_id = ? + AND processed_at IS NULL + `); + } + + tryMarkAsProjecting(event: IEvent) { + const eventId = getEventId(event); + + const r = this.#lockEventQuery.run(this.#projectionName, this.#schemaVersion, eventId); + + return r.changes !== 0; + } + + markAsProjected(event: IEvent) { + const eventId = getEventId(event); + + const transaction = this.#db.transaction(() => { + const updateResult = this.#finalizeEventLockQuery.run(this.#projectionName, this.#schemaVersion, eventId); + if (updateResult.changes === 0) + throw new Error(`Event ${event.id} could not be marked as processed`); + + this.#upsertLastEventQuery.run(this.#projectionName, this.#schemaVersion, JSON.stringify(event)); + }); + + transaction(); + } + + getLastEvent(): IEvent | undefined { + const viewInfoRecord = this.#getLastEventQuery.get(this.#projectionName, this.#schemaVersion); + if (!viewInfoRecord?.last_event) + return undefined; + + return JSON.parse(viewInfoRecord.last_event); + } +} diff --git a/src/infrastructure/sqlite/SqliteObjectStorage.ts b/src/infrastructure/sqlite/SqliteObjectStorage.ts new file mode 100644 index 0000000..83a7347 --- /dev/null +++ b/src/infrastructure/sqlite/SqliteObjectStorage.ts @@ -0,0 +1,110 @@ +import { Statement, Database } from 'better-sqlite3'; +import { guid } from './utils'; +import { IObjectStorage } from '../../interfaces'; + +export class SqliteObjectStorage implements IObjectStorage { + + #db: Database; + #tableName: string; + #getQuery: Statement<[Buffer], { data: string, version: number }>; + #insertQuery: Statement<[Buffer, string], void>; + #updateByIdAndVersionQuery: Statement<[string, Buffer, number], void>; + #deleteQuery: Statement<[Buffer], void>; + + constructor(o: { + viewModelSqliteDb: Database, + tableName: string + }) { + if (!o.viewModelSqliteDb) + throw new TypeError('viewModelSqliteDb argument required'); + if (!o.tableName) + throw new TypeError('tableName argument required'); + + this.#db = o.viewModelSqliteDb; + this.#tableName = o.tableName; + + this.#initialize(); + } + + #initialize(): void { + this.#db.exec(`CREATE TABLE IF NOT EXISTS ${this.#tableName} ( + id BLOB PRIMARY KEY, + version INTEGER DEFAULT 1, + data TEXT NOT NULL + );`); + + this.#getQuery = this.#db.prepare(` + SELECT data, version + FROM ${this.#tableName} + WHERE id = ? + `); + + this.#insertQuery = this.#db.prepare(` + INSERT INTO ${this.#tableName} (id, data) + VALUES (?, ?) + `); + + this.#updateByIdAndVersionQuery = this.#db.prepare(` + UPDATE ${this.#tableName} + SET + data = ?, + version = version + 1 + WHERE + id = ? + AND version = ? + `); + + this.#deleteQuery = this.#db.prepare(` + DELETE FROM ${this.#tableName} + WHERE id = ? + `); + } + + get(id: string): TRecord | undefined { + const r = this.#getQuery.get(guid(id)); + if (!r) + return undefined; + + return JSON.parse(r.data); + } + + create(id: string, data: TRecord) { + const r = this.#insertQuery.run(guid(id), JSON.stringify(data)); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be created`); + + } + + update(id: string, update: (r: TRecord) => TRecord) { + const gid = guid(id); + const record = this.#getQuery.get(gid); + if (!record) + throw new Error(`Record '${id}' does not exist`); + + const data = JSON.parse(record.data); + const updatedData = update(data); + const updatedJson = JSON.stringify(updatedData); + + // Version check is implemented to ensure the record isn't modified by another process. + // A conflict resolution strategy could potentially be passed as an option to this method, + // but for now, conflict resolution should happen outside this class. + const r = this.#updateByIdAndVersionQuery.run(updatedJson, gid, record.version); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be updated`); + } + + updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + // Due to better-sqlite3 sync nature, + // it's safe to get then modify within this process + const record = this.#getQuery.get(guid(id)); + if (record) + this.update(id, update); + else + this.create(id, update()); + } + + delete(id: string): boolean { + const r = this.#deleteQuery.run(guid(id)); + return r.changes === 1; + } +} diff --git a/src/infrastructure/sqlite/SqliteObjectView.ts b/src/infrastructure/sqlite/SqliteObjectView.ts new file mode 100644 index 0000000..8a6d005 --- /dev/null +++ b/src/infrastructure/sqlite/SqliteObjectView.ts @@ -0,0 +1,44 @@ +import { AbstractSqliteView } from "./AbstractSqliteView"; +import { IObjectStorage, IEventLocker } from '../../interfaces'; +import { SqliteObjectStorage } from './SqliteObjectStorage'; + +export class SqliteObjectView extends AbstractSqliteView implements IObjectStorage, IEventLocker { + + #sqliteObjectStorage: SqliteObjectStorage; + + constructor(options: ConstructorParameters[0] & { + tableNamePrefix: string + }) { + if (typeof options.tableNamePrefix !== 'string' || !options.tableNamePrefix.length) + throw new TypeError('tableNamePrefix argument must be a non-empty String'); + if (typeof options.schemaVersion !== 'string' || !options.schemaVersion.length) + throw new TypeError('schemaVersion argument must be a non-empty String'); + + super(options); + + this.#sqliteObjectStorage = new SqliteObjectStorage({ + viewModelSqliteDb: options.viewModelSqliteDb, + tableName: `${options.tableNamePrefix}_${options.schemaVersion}` + }); + } + + get(id: string): TRecord | undefined { + return this.#sqliteObjectStorage.get(id); + } + + create(id: string, data: TRecord) { + this.#sqliteObjectStorage.create(id, data); + } + + update(id: string, update: (r: TRecord) => TRecord) { + this.#sqliteObjectStorage.update(id, update); + } + + updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + this.#sqliteObjectStorage.updateEnforcingNew(id, update); + } + + delete(id: string): boolean { + return this.#sqliteObjectStorage.delete(id); + } +} diff --git a/src/infrastructure/sqlite/SqliteViewLocker.ts b/src/infrastructure/sqlite/SqliteViewLocker.ts new file mode 100644 index 0000000..b29b5b1 --- /dev/null +++ b/src/infrastructure/sqlite/SqliteViewLocker.ts @@ -0,0 +1,173 @@ +import { Database, Statement } from 'better-sqlite3'; +import { IExtendableLogger, ILogger, IViewLocker } from '../../interfaces'; +import { Deferred } from '../memory'; +import { promisify } from 'util'; +import { viewLockTableInit } from './queries'; +import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; +const delay = promisify(setTimeout); + +export type SqliteViewLockerParams = SqliteDbParams & SqliteProjectionDataParams & { + /** + * (Optional) SQLite table name where event locks along with the latest event are stored + * + * @default "tbl_view_lock" + */ + viewLockTableName?: string; + + /** + * (Optional) Time-to-live (TTL) duration (in milliseconds) for which a view remains locked + * + * @default 120_000 + */ + viewLockTtl?: number; + + /** + * (Optional) Logger instance for logging operations, + * can be an IExtendableLogger (Winston) + * or ILogger (Console) + */ + logger?: IExtendableLogger | ILogger; +}; + +export class SqliteViewLocker implements IViewLocker { + + #db: Database; + #projectionName: string; + #schemaVersion: string; + + #viewLockTableName: string; + #viewLockTtl: number; + #logger: ILogger | undefined; + + #upsertTableLockQuery: Statement<[string, string, number], void>; + #updateTableLockQuery: Statement<[number, string, string], void>; + #removeTableLockQuery: Statement<[string, string], void>; + + #lockMarker: Deferred | undefined; + #lockProlongationTimeout: NodeJS.Timeout | undefined; + + constructor(o: SqliteViewLockerParams) { + if (!o.viewModelSqliteDb) + throw new TypeError('viewModelSqliteDb argument required'); + if (!o.projectionName) + throw new TypeError('projectionName argument required'); + if (!o.schemaVersion) + throw new TypeError('schemaVersion argument required'); + + this.#db = o.viewModelSqliteDb; + this.#projectionName = o.projectionName; + this.#schemaVersion = o.schemaVersion; + + this.#viewLockTableName = o.viewLockTableName ?? 'tbl_view_lock'; + this.#viewLockTtl = o.viewLockTtl ?? 120_000; + this.#logger = o.logger && 'child' in o.logger ? + o.logger.child({ service: this.constructor.name }) : + o.logger; + + this.#initialize(); + } + + #initialize() { + this.#db.exec(viewLockTableInit(this.#viewLockTableName)); + + this.#upsertTableLockQuery = this.#db.prepare(` + INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, locked_till) + VALUES (?, ?, ?) + ON CONFLICT (projection_name, schema_version) + DO UPDATE SET + locked_till = excluded.locked_till + WHERE + locked_till IS NULL + OR locked_till < excluded.locked_till + `); + + this.#updateTableLockQuery = this.#db.prepare(` + UPDATE ${this.#viewLockTableName} + SET + locked_till = ? + WHERE + projection_name = ? + AND schema_version = ? + AND locked_till IS NOT NULL + `); + + this.#removeTableLockQuery = this.#db.prepare(` + UPDATE ${this.#viewLockTableName} + SET + locked_till = NULL + WHERE + projection_name = ? + AND schema_version = ? + AND locked_till IS NOT NULL + `); + } + + get ready(): boolean { + return !!this.#lockMarker; + } + + async lock() { + this.#lockMarker = new Deferred(); + + let lockAcquired = false; + while (!lockAcquired) { + const lockedTill = Date.now() + this.#viewLockTtl; + const upsertResult = this.#upsertTableLockQuery.run(this.#projectionName, this.#schemaVersion, lockedTill); + + lockAcquired = upsertResult.changes === 1; + if (!lockAcquired) { + this.#logger?.debug(`"${this.#projectionName}" is locked by another process`); + await delay(this.#viewLockTtl / 2); + } + } + + this.#logger?.debug(`"${this.#projectionName}" lock obtained for ${this.#viewLockTtl}s`); + + this.scheduleLockProlongation(); + + return true; + } + + private 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`); + } + + private cancelLockProlongation() { + clearTimeout(this.#lockProlongationTimeout); + this.#logger?.debug(`"${this.#projectionName}" lock refresh canceled`); + } + + private prolongLock() { + const lockedTill = Date.now() + this.#viewLockTtl; + const r = this.#updateTableLockQuery.run(lockedTill, this.#projectionName, this.#schemaVersion); + if (r.changes !== 1) + throw new Error(`"${this.#projectionName}" lock could not be prolonged`); + + this.#logger?.debug(`"${this.#projectionName}" lock prolonged for ${this.#viewLockTtl}s`); + } + + unlock() { + this.#lockMarker?.resolve(); + this.#lockMarker = undefined; + + this.cancelLockProlongation(); + + const updateResult = this.#removeTableLockQuery.run(this.#projectionName, this.#schemaVersion); + if (updateResult.changes === 1) + this.#logger?.debug(`"${this.#projectionName}" lock released`); + else + this.#logger?.warn(`"${this.#projectionName}" lock didn't exist`); + } + + once(event: 'ready'): Promise { + if (event !== 'ready') + throw new TypeError(`Unexpected event: ${event}`); + + return this.#lockMarker?.promise ?? Promise.resolve(); + } +} diff --git a/src/infrastructure/sqlite/commonParams.ts b/src/infrastructure/sqlite/commonParams.ts new file mode 100644 index 0000000..9b51c7a --- /dev/null +++ b/src/infrastructure/sqlite/commonParams.ts @@ -0,0 +1,22 @@ +import { Database } from 'better-sqlite3'; + +export type SqliteDbParams = { + /** Configured instance of better-sqlite3.Database */ + viewModelSqliteDb: Database; +}; + +export type SqliteProjectionDataParams = { + /** + * Unique identifier for the projection, used with the schema version to distinguish data ownership. + */ + projectionName: string; + + /** + * The version of the schema used for data produced by the projection. + * When the projection's output format changes, this version should be incremented. + * A version change indicates that previously stored data is obsolete and must be rebuilt. + * + * @example "20250519", "1.0.0" + */ + schemaVersion: string; +} diff --git a/src/infrastructure/sqlite/index.ts b/src/infrastructure/sqlite/index.ts index 113bcfa..3eaf404 100644 --- a/src/infrastructure/sqlite/index.ts +++ b/src/infrastructure/sqlite/index.ts @@ -1,3 +1,6 @@ export * from './AbstractSqliteView'; -export * from './ObjectSqliteView'; +export * from './SqliteEventLocker'; +export * from './SqliteObjectStorage'; +export * from './SqliteObjectView'; +export * from './SqliteViewLocker'; export * from './utils'; diff --git a/src/infrastructure/sqlite/queries/eventLockTableInit.ts b/src/infrastructure/sqlite/queries/eventLockTableInit.ts new file mode 100644 index 0000000..31a6b95 --- /dev/null +++ b/src/infrastructure/sqlite/queries/eventLockTableInit.ts @@ -0,0 +1,10 @@ +export const eventLockTableInit = (eventLockTableName: string) => ` + CREATE TABLE IF NOT EXISTS ${eventLockTableName} ( + projection_name TEXT NOT NULL, + schema_version TEXT NOT NULL, + event_id BLOB NOT NULL, + processing_at INTEGER NOT NULL DEFAULT (cast(strftime('%f', 'now') * 1000 as INTEGER)), + processed_at INTEGER, + PRIMARY KEY (projection_name, schema_version, event_id) + ); +`; diff --git a/src/infrastructure/sqlite/queries/index.ts b/src/infrastructure/sqlite/queries/index.ts new file mode 100644 index 0000000..7edbb02 --- /dev/null +++ b/src/infrastructure/sqlite/queries/index.ts @@ -0,0 +1,2 @@ +export * from './eventLockTableInit'; +export * from './viewLockTableInit'; diff --git a/src/infrastructure/sqlite/queries/viewLockTableInit.ts b/src/infrastructure/sqlite/queries/viewLockTableInit.ts new file mode 100644 index 0000000..b3e707f --- /dev/null +++ b/src/infrastructure/sqlite/queries/viewLockTableInit.ts @@ -0,0 +1,9 @@ +export const viewLockTableInit = (viewLockTableName: string): string => ` + CREATE TABLE IF NOT EXISTS ${viewLockTableName} ( + projection_name TEXT NOT NULL, + schema_version TEXT NOT NULL, + locked_till INTEGER, + last_event TEXT, + PRIMARY KEY (projection_name, schema_version) + ); +`; diff --git a/src/interfaces/IEventLocker.ts b/src/interfaces/IEventLocker.ts new file mode 100644 index 0000000..0d6c5a4 --- /dev/null +++ b/src/interfaces/IEventLocker.ts @@ -0,0 +1,34 @@ +import { IEvent } from "./IEvent"; +import { isObject } from "./isObject"; + +/** + * Interface for tracking event processing state to prevent concurrent processing + * by multiple processes. + */ +export interface IEventLocker { + + /** + * Retrieves the last projected event, + * allowing the projection state to be restored from subsequent events. + */ + getLastEvent(): Promise | IEvent | undefined; + + /** + * Marks an event as projecting to prevent it from being processed + * by another projection instance using the same storage. + * + * @returns `false` if the event is already being processed or has been processed. + */ + tryMarkAsProjecting(event: IEvent): Promise | boolean; + + /** + * Marks an event as projected. + */ + markAsProjected(event: IEvent): Promise | void; +} + +export const isEventLocker = (view: unknown): view is IEventLocker => + isObject(view) + && 'getLastEvent' in view + && 'tryMarkAsProjecting' in view + && 'markAsProjected' in view; diff --git a/src/interfaces/IObjectView.ts b/src/interfaces/IObjectStorage.ts similarity index 88% rename from src/interfaces/IObjectView.ts rename to src/interfaces/IObjectStorage.ts index de324c8..53c4a76 100644 --- a/src/interfaces/IObjectView.ts +++ b/src/interfaces/IObjectStorage.ts @@ -1,4 +1,4 @@ -export interface IObjectView { +export interface IObjectStorage { get(id: string): Promise | TRecord | undefined; create(id: string, r: TRecord): Promise | any; diff --git a/src/interfaces/IPersistentView.ts b/src/interfaces/IPersistentView.ts deleted file mode 100644 index 2832c0f..0000000 --- a/src/interfaces/IPersistentView.ts +++ /dev/null @@ -1,24 +0,0 @@ -import { IEvent } from "./IEvent"; -import { IProjectionView } from "./IProjectionView"; - -export interface IPersistentView extends IProjectionView { - - /** - * Get last projected event, - * so that projection state can be restored from following events - */ - getLastEvent(): Promise | IEvent | undefined; - - /** - * Mark event as projecting to prevent its handling by another - * projection instance working with the same storage. - * - * @returns False value if event is already processing or processed - */ - tryMarkAsProjecting(event: IEvent): Promise | boolean; - - /** - * Mark event as projected - */ - markAsProjected(event: IEvent): Promise | void; -} diff --git a/src/interfaces/IProjection.ts b/src/interfaces/IProjection.ts index 52819eb..aaa6721 100644 --- a/src/interfaces/IProjection.ts +++ b/src/interfaces/IProjection.ts @@ -2,7 +2,7 @@ import { IEvent } from "./IEvent"; import { IEventStore } from "./IEventStore"; import { IObserver } from "./IObserver"; -export interface IProjection extends IObserver { +export interface IProjection extends IObserver { readonly view: TView; subscribe(eventStore: IEventStore): Promise; diff --git a/src/interfaces/IProjectionView.ts b/src/interfaces/IProjectionView.ts deleted file mode 100644 index 469666a..0000000 --- a/src/interfaces/IProjectionView.ts +++ /dev/null @@ -1,22 +0,0 @@ -export interface IProjectionView { - - /** - * Indicates if view is ready for new events projecting - */ - ready: boolean; - - /** - * Lock the view for external reads/writes - */ - lock(): Promise | boolean; - - /** - * Unlock external read/write operations - */ - unlock(): Promise | void; - - /** - * Wait till the view is ready to accept new events - */ - once(eventType: "ready"): Promise; -} diff --git a/src/interfaces/IViewLocker.ts b/src/interfaces/IViewLocker.ts new file mode 100644 index 0000000..238479d --- /dev/null +++ b/src/interfaces/IViewLocker.ts @@ -0,0 +1,46 @@ +import { isObject } from "./isObject"; + +/** + * Interface for managing view restoration state to prevent early access to an inconsistent view + * or concurrent restoration by another process. + */ +export interface IViewLocker { + + /** + * Indicates whether the view is fully restored and ready to accept new event projections. + */ + ready: boolean; + + /** + * Locks the view to prevent external read/write operations. + * + * @returns `true` if the lock is successfully acquired, `false` otherwise. + */ + lock(): Promise | boolean; + + /** + * Unlocks the view, allowing external read/write operations to resume. + */ + unlock(): Promise | void; + + /** + * Waits until the view is fully restored and ready to accept new events. + * + * @param eventType The event type to listen for (`"ready"`). + * @returns A promise that resolves when the view is ready. + */ + once(eventType: "ready"): Promise; +} + +/** + * Checks if a given object conforms to the `IViewLocker` interface. + * + * @param view The object to check. + * @returns `true` if the object implements `IViewLocker`, `false` otherwise. + */ +export const isViewLocker = (view: unknown): view is IViewLocker => + isObject(view) + && 'ready' in view + && 'lock' in view + && 'unlock' in view + && 'once' in view; diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index ab97393..b81c515 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -4,6 +4,7 @@ export * from './ICommand'; export * from './ICommandBus'; export * from './Identifier'; export * from './IEvent'; +export * from './IEventLocker'; export * from './IEventReceptor'; export * from './IEventSet'; export * from './IEventStorage'; @@ -12,10 +13,9 @@ export * from './IEventStream'; export * from './ILogger'; export * from './IMessage'; export * from './IMessageBus'; -export * from './IObjectView'; +export * from './IObjectStorage'; export * from './IObservable'; export * from './IObserver'; -export * from './IPersistentView'; export * from './IProjection'; -export * from './IProjectionView'; export * from './ISaga'; +export * from './IViewLocker'; diff --git a/src/interfaces/isObject.ts b/src/interfaces/isObject.ts new file mode 100644 index 0000000..8c26dac --- /dev/null +++ b/src/interfaces/isObject.ts @@ -0,0 +1,5 @@ +export const isObject = (obj: unknown): obj is {} => + typeof obj === 'object' + && obj !== null + && !(obj instanceof Date) + && !Array.isArray(obj); diff --git a/tests/integration/SqliteView.test.ts b/tests/integration/SqliteView.test.ts index 1c73b05..b09e72d 100644 --- a/tests/integration/SqliteView.test.ts +++ b/tests/integration/SqliteView.test.ts @@ -1,7 +1,7 @@ import { existsSync, unlinkSync } from 'fs'; import { AbstractProjection, IEvent } from '../../src'; -import { ObjectSqliteView } from '../../src/infrastructure/sqlite/ObjectSqliteView'; +import { SqliteObjectView } from '../../src/infrastructure/sqlite'; import * as createDb from 'better-sqlite3'; import { v7 } from 'uuid'; @@ -9,15 +9,7 @@ type UserPayload = { name: string; } -class MyDumbProjection extends AbstractProjection> { - - get schemaVersion() { - return '1'; - } - - constructor({ myDumbViewFactory }) { - super({ viewFactory: myDumbViewFactory }); - } +class MyDumbProjection extends AbstractProjection> { async userCreated(e: IEvent) { if (typeof e.aggregateId !== 'string') @@ -41,37 +33,37 @@ class MyDumbProjection extends AbstractProjection> { describe.only('SqliteView', () => { - let sqliteInMemoryDb: import('better-sqlite3').Database; + let viewModelSqliteDb: import('better-sqlite3').Database; const logState = () => { console.log({ - tbl_view_lock: sqliteInMemoryDb.prepare(`SELECT * FROM tbl_view_lock`).all(), - tbl_test_1_event_lock: sqliteInMemoryDb.prepare(`SELECT * FROM tbl_test_1_event_lock`).all(), - tbl_test_1: sqliteInMemoryDb.prepare(`SELECT * FROM tbl_test_1`).all() + tbl_view_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock`).all(), + tbl_test_1_event_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1_event_lock`).all(), + tbl_test_1: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1`).all() }); } const fileName = './test.sqlite'; beforeEach(() => { - sqliteInMemoryDb = createDb(fileName); + viewModelSqliteDb = createDb(fileName); // Write-Ahead Logging (WAL) mode allows reads and writes to happen concurrently and reduces contention // on the database. It keeps changes in a separate log file before they are flushed to the main database file - sqliteInMemoryDb.pragma('journal_mode = WAL'); + viewModelSqliteDb.pragma('journal_mode = WAL'); // The synchronous pragma controls how often SQLite synchronizes writes to the filesystem. Lowering this can // boost performance but increases the risk of data loss in the event of a crash. - sqliteInMemoryDb.pragma('synchronous = NORMAL'); + viewModelSqliteDb.pragma('synchronous = NORMAL'); // Limit WAL journal size to 5MB to manage disk usage in high-write scenarios. // With WAL mode and NORMAL sync, this helps prevent excessive file growth during transactions. - sqliteInMemoryDb.pragma(`journal_size_limit = ${5 * 1024 * 1024}`); + viewModelSqliteDb.pragma(`journal_size_limit = ${5 * 1024 * 1024}`); }); afterEach(() => { - if (sqliteInMemoryDb) - sqliteInMemoryDb.close(); + if (viewModelSqliteDb) + viewModelSqliteDb.close(); if (existsSync(fileName)) unlinkSync(fileName); }); @@ -84,9 +76,10 @@ describe.only('SqliteView', () => { it('handles 10_000 events within 0.5 seconds', async () => { const p = new MyDumbProjection({ - myDumbViewFactory: ({ schemaVersion }) => new ObjectSqliteView({ - schemaVersion, - sqliteDb: sqliteInMemoryDb, + view: new SqliteObjectView({ + schemaVersion: '1', + viewModelSqliteDb, + projectionName: 'tbl_test', tableNamePrefix: 'tbl_test' }) }); diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index a4945c5..4abada0 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -7,10 +7,6 @@ class MyProjection extends AbstractProjection { if (v.somethingHappenedCnt) @@ -25,20 +21,19 @@ class MyProjection extends AbstractProjection; beforeEach(() => { - projection = new MyProjection(); + view = new InMemoryView(); + projection = new MyProjection({ view }); }); describe('view', () => { it('returns a view storage associated with projection', () => { - const view = new InMemoryView(); - const proj = new MyProjection({ view }); - - expect(proj.view).to.equal(view); + expect(projection).to.have.property('view').that.is.equal(view); }); }); @@ -59,9 +54,6 @@ describe('AbstractProjection', function () { it('subscribes to all handlers defined', () => { class ProjectionWithoutHandles extends AbstractProjection { - get schemaVersion(): string { - return 'v1'; - } somethingHappened() { } somethingHappened2() { } } @@ -76,10 +68,6 @@ describe('AbstractProjection', function () { it('ignores overridden projection methods', () => { class ProjectionWithoutHandles extends AbstractProjection { - get schemaVersion(): string { - return 'v1'; - } - somethingHappened() { } /** overridden projection method */ diff --git a/tests/unit/InMemoryEventStorage.test.ts b/tests/unit/memory/InMemoryEventStorage.test.ts similarity index 98% rename from tests/unit/InMemoryEventStorage.test.ts rename to tests/unit/memory/InMemoryEventStorage.test.ts index fe25589..bd8079c 100644 --- a/tests/unit/InMemoryEventStorage.test.ts +++ b/tests/unit/memory/InMemoryEventStorage.test.ts @@ -1,5 +1,5 @@ import { expect } from 'chai'; -import { InMemoryEventStorage } from '../../src'; +import { InMemoryEventStorage } from '../../../src'; describe('InMemoryEventStorage', () => { let storage; diff --git a/tests/unit/InMemoryMessageBus.test.ts b/tests/unit/memory/InMemoryMessageBus.test.ts similarity index 95% rename from tests/unit/InMemoryMessageBus.test.ts rename to tests/unit/memory/InMemoryMessageBus.test.ts index 511d5f5..fef5b23 100644 --- a/tests/unit/InMemoryMessageBus.test.ts +++ b/tests/unit/memory/InMemoryMessageBus.test.ts @@ -1,5 +1,5 @@ -import { IMessageBus, InMemoryMessageBus } from '../..'; -import { expect, assert, AssertionError } from 'chai'; +import { IMessageBus, InMemoryMessageBus } from '../../../src'; +import { expect, AssertionError } from 'chai'; import { spy } from 'sinon'; describe('InMemoryMessageBus', function () { diff --git a/tests/unit/InMemoryView.test.ts b/tests/unit/memory/InMemoryView.test.ts similarity index 98% rename from tests/unit/InMemoryView.test.ts rename to tests/unit/memory/InMemoryView.test.ts index d2b6e26..617b931 100644 --- a/tests/unit/InMemoryView.test.ts +++ b/tests/unit/memory/InMemoryView.test.ts @@ -1,6 +1,6 @@ -import { InMemoryView } from '../../src'; +import { InMemoryView } from '../../../src'; import { expect, assert } from 'chai'; -import { nextCycle } from '../../src/infrastructure/memory/utils'; +import { nextCycle } from '../../../src/infrastructure/memory/utils'; describe('InMemoryView', function () { diff --git a/tests/unit/sqlite/SqliteEventLocker.test.ts b/tests/unit/sqlite/SqliteEventLocker.test.ts new file mode 100644 index 0000000..ee26dd4 --- /dev/null +++ b/tests/unit/sqlite/SqliteEventLocker.test.ts @@ -0,0 +1,97 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { SqliteEventLocker } from '../../../src/infrastructure/sqlite/SqliteEventLocker'; +import { IEvent } from '../../../src/interfaces'; +import { guid } from '../../../src/infrastructure/sqlite'; +import { promisify } from 'util'; +const delay = promisify(setTimeout); + +describe('SqliteEventLocker', function () { + + let db: import('better-sqlite3').Database; + let locker: SqliteEventLocker; + const testEvent: IEvent = { id: 'event1', type: 'TEST_EVENT', payload: {} }; + + beforeEach(() => { + db = createDb(':memory:'); + locker = new SqliteEventLocker({ + viewModelSqliteDb: db, + projectionName: 'test', + schemaVersion: '1.0', + eventLockTableName: 'test_event_lock', + viewLockTableName: 'test_view_lock', + eventLockTtl: 50 // ms + }); + jest.useFakeTimers(); + }); + + afterEach(() => { + db.close(); + jest.useRealTimers(); + }); + + it('allows marking an event as projecting', function () { + const result = locker.tryMarkAsProjecting(testEvent); + expect(result).to.be.true; + }); + + it('prevents re-locking an already locked event', function () { + locker.tryMarkAsProjecting(testEvent); + const result = locker.tryMarkAsProjecting(testEvent); + expect(result).to.be.false; + }); + + it('marks an event as projected', function () { + locker.tryMarkAsProjecting(testEvent); + locker.markAsProjected(testEvent); + + const row = db.prepare(`SELECT processed_at FROM test_event_lock WHERE event_id = ?`) + .get(guid(testEvent.id)) as any; + + expect(row).to.exist; + expect(row.processed_at).to.not.be.null; + }); + + it('retrieves the last projected event', function () { + + locker.tryMarkAsProjecting(testEvent); + locker.markAsProjected(testEvent); + + const lastEvent = locker.getLastEvent(); + + expect(lastEvent).to.deep.equal(testEvent); + }); + + it('returns undefined if no event has been projected', function () { + const lastEvent = locker.getLastEvent(); + expect(lastEvent).to.be.undefined; + }); + + it('fails to mark an event as projected if it was never locked', function () { + expect(() => locker.markAsProjected(testEvent)) + .to.throw(Error, `Event ${testEvent.id} could not be marked as processed`); + }); + + it('allows re-locking after TTL expires', async function () { + + locker.tryMarkAsProjecting(testEvent); + + await delay(51); + + const result = locker.tryMarkAsProjecting(testEvent); + expect(result).to.be.true; + }); + + it('fails to update an event if its version is modified in DB', function () { + + locker.tryMarkAsProjecting(testEvent); + + // Modify the event in DB to simulate an external change + db.prepare('UPDATE test_event_lock SET processed_at = ? WHERE event_id = ?') + .run(Date.now(), guid(testEvent.id)); + + // Attempt to finalize the event processing + expect(() => locker.markAsProjected(testEvent)) + .to.throw(Error, `Event ${testEvent.id} could not be marked as processed`); + }); +}); diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts new file mode 100644 index 0000000..ce2aca7 --- /dev/null +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -0,0 +1,86 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { guid, SqliteObjectStorage } from '../../../src/infrastructure/sqlite'; + +describe('SqliteObjectStorage', function () { + let db: import('better-sqlite3').Database; + let storage: SqliteObjectStorage<{ name: string; value: number }>; + + beforeEach(() => { + db = createDb(':memory:'); + storage = new SqliteObjectStorage<{ name: string; value: number }>({ + viewModelSqliteDb: db, + tableName: 'test_objects', + }); + }); + + afterEach(() => { + db.close(); + }); + + it('stores and retrieves an object', async function () { + + const obj = { name: 'Test Object', value: 42 }; + storage.create('0001', obj); + + const retrieved = storage.get('0001'); + expect(retrieved).to.deep.equal(obj); + }); + + it('returns undefined for a non-existent object', async function () { + const retrieved = storage.get('nonexistent'); + expect(retrieved).to.be.undefined; + }); + + it('updates an existing object', async function () { + + storage.create('0002', { name: 'Old Data', value: 5 }); + + storage.update('0002', (r) => ({ ...r, value: 99 })); + + const updated = storage.get('0002'); + expect(updated).to.deep.equal({ name: 'Old Data', value: 99 }); + }); + + it('throws an error when updating a non-existent object', async function () { + + expect(() => storage.update('nonexistent', (r) => ({ ...r, value: 99 }))) + .to.throw(Error, "Record 'nonexistent' does not exist"); + }); + + it('deletes an object', async function () { + + storage.create('0003', { name: 'To be deleted', value: 10 }); + const deleted = storage.delete('0003'); + expect(deleted).to.be.true; + + const retrieved = storage.get('0003'); + expect(retrieved).to.be.undefined; + }); + + it('returns false when deleting a non-existent object', async function () { + + const deleted = storage.delete('0000'); + expect(deleted).to.be.false; + }); + + it('enforces updating or creating a new object', async function () { + + storage.updateEnforcingNew('0004', () => ({ name: 'Created', value: 1 })); + + let retrieved = storage.get('0004'); + expect(retrieved).to.deep.equal({ name: 'Created', value: 1 }); + + storage.updateEnforcingNew('0004', (r) => ({ ...r!, value: 100 })); + + retrieved = storage.get('0004'); + expect(retrieved).to.deep.equal({ name: 'Created', value: 100 }); + }); + + it('fails if invalid JSON is recorded', async function () { + db.prepare('INSERT INTO test_objects (id, data) VALUES (?, ?)') + .run(guid('0005'), 'INVALID_JSON'); + + expect(() => storage.get('0005')).to.throw(); + }); +}); diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts new file mode 100644 index 0000000..43573a2 --- /dev/null +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -0,0 +1,109 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { SqliteViewLocker } from '../../../src/infrastructure/sqlite'; + +describe('SqliteViewLocker', function () { + + const viewLockTtl = 1_000; // 1sec + let viewModelSqliteDb: import('better-sqlite3').Database; + let firstLock: SqliteViewLocker; + let secondLock: SqliteViewLocker; + + beforeEach(() => { + viewModelSqliteDb = createDb(':memory:'); + firstLock = new SqliteViewLocker({ + viewModelSqliteDb, + projectionName: 'test', + schemaVersion: '1.0', + viewLockTtl + }); + secondLock = new SqliteViewLocker({ + viewModelSqliteDb, + projectionName: 'test', + schemaVersion: '1.0', + viewLockTtl + }); + + jest.useFakeTimers(); + }); + + afterEach(() => { + viewModelSqliteDb.close(); + }); + + it('locks a view successfully', async function () { + const result = await firstLock.lock(); + expect(result).to.be.true; + }); + + it('unlocks a view successfully', async function () { + await firstLock.lock(); + firstLock.unlock(); + + const lockResult = await secondLock.lock(); + expect(lockResult).to.be.true; + }); + + it('waits for the lock to be released if already locked', async function () { + await firstLock.lock(); + + let secondLockAcquired = false; + + // Try locking, but it should wait + const secondLockAcquiring = secondLock.lock().then(() => { + secondLockAcquired = true; + }); + + // Wait briefly to check if it resolves too soon + await jest.advanceTimersByTimeAsync(viewLockTtl); + expect(secondLockAcquired).to.be.false; + + firstLock.unlock(); + + await secondLockAcquiring; + expect(secondLockAcquired).to.be.true; + }); + + + it('prolongs the lock while active', async function () { + await firstLock.lock(); + + const initial = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + .get('test', '1.0') as any; + + expect(initial).to.have.property('locked_till').that.is.gt(Date.now()); + + await jest.advanceTimersByTimeAsync(viewLockTtl); + + const updated = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + .get('test', '1.0') as any; + + expect(updated).to.have.property('locked_till').that.is.gt(initial.locked_till); + }); + + it('should release the lock upon unlock()', async function () { + await firstLock.lock(); + firstLock.unlock(); + + const row = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + .get('test', '1.0') as any; + + expect(row.locked_till).to.be.null; + }); + + it('should fail to prolong the lock if already released', async function () { + await firstLock.lock(); + firstLock.unlock(); + + let error; + try { + await (firstLock as any).prolongLock(); + } + catch (err) { + error = err; + } + + expect(error).to.exist; + expect(error).to.have.property('message', '"test" lock could not be prolonged'); + }); +}); From 5d816bc45eada5d79d54bc16951f0f37fe67b0bb Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 20 Mar 2025 12:41:28 +0000 Subject: [PATCH 016/169] Make SqliteObjectView.get to wait until view is unlocked --- src/infrastructure/sqlite/SqliteObjectView.ts | 31 +++++++- src/infrastructure/sqlite/SqliteViewLocker.ts | 2 +- src/interfaces/IObjectStorage.ts | 12 +-- tests/unit/sqlite/SqliteObjectView.test.ts | 73 +++++++++++++++++++ tests/unit/sqlite/SqliteViewLocker.test.ts | 13 ++++ 5 files changed, 124 insertions(+), 7 deletions(-) create mode 100644 tests/unit/sqlite/SqliteObjectView.test.ts diff --git a/src/infrastructure/sqlite/SqliteObjectView.ts b/src/infrastructure/sqlite/SqliteObjectView.ts index 8a6d005..e7956a3 100644 --- a/src/infrastructure/sqlite/SqliteObjectView.ts +++ b/src/infrastructure/sqlite/SqliteObjectView.ts @@ -22,23 +22,52 @@ export class SqliteObjectView extends AbstractSqliteView implements IOb }); } - get(id: string): TRecord | undefined { + async get(id: string): Promise { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + if (!this.ready) + await this.once('ready'); + + return this.#sqliteObjectStorage.get(id); + } + + getSync(id: string) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + return this.#sqliteObjectStorage.get(id); } create(id: string, data: TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + this.#sqliteObjectStorage.create(id, data); } update(id: string, update: (r: TRecord) => TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + if (typeof update !== 'function') + throw new TypeError('update argument must be a Function'); + this.#sqliteObjectStorage.update(id, update); } updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + if (typeof update !== 'function') + throw new TypeError('update argument must be a Function'); + this.#sqliteObjectStorage.updateEnforcingNew(id, update); } delete(id: string): boolean { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + return this.#sqliteObjectStorage.delete(id); } } diff --git a/src/infrastructure/sqlite/SqliteViewLocker.ts b/src/infrastructure/sqlite/SqliteViewLocker.ts index b29b5b1..a6a09af 100644 --- a/src/infrastructure/sqlite/SqliteViewLocker.ts +++ b/src/infrastructure/sqlite/SqliteViewLocker.ts @@ -103,7 +103,7 @@ export class SqliteViewLocker implements IViewLocker { } get ready(): boolean { - return !!this.#lockMarker; + return !this.#lockMarker; } async lock() { diff --git a/src/interfaces/IObjectStorage.ts b/src/interfaces/IObjectStorage.ts index 53c4a76..1207c37 100644 --- a/src/interfaces/IObjectStorage.ts +++ b/src/interfaces/IObjectStorage.ts @@ -1,11 +1,13 @@ +import { Identifier } from "./Identifier"; + export interface IObjectStorage { - get(id: string): Promise | TRecord | undefined; + get(id: Identifier): Promise | TRecord | undefined; - create(id: string, r: TRecord): Promise | any; + create(id: Identifier, r: TRecord): Promise | any; - update(id: string, cb: (r: TRecord) => TRecord): Promise | any; + update(id: Identifier, cb: (r: TRecord) => TRecord): Promise | any; - updateEnforcingNew(id: string, cb: (r?: TRecord) => TRecord): Promise | any; + updateEnforcingNew(id: Identifier, cb: (r?: TRecord) => TRecord): Promise | any; - delete(id: string): Promise | any; + delete(id: Identifier): Promise | any; } diff --git a/tests/unit/sqlite/SqliteObjectView.test.ts b/tests/unit/sqlite/SqliteObjectView.test.ts new file mode 100644 index 0000000..103b4c9 --- /dev/null +++ b/tests/unit/sqlite/SqliteObjectView.test.ts @@ -0,0 +1,73 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { SqliteObjectView } from '../../../src/infrastructure/sqlite'; +import { promisify } from 'util'; +const delay = promisify(setTimeout); + +describe('SqliteObjectView', function () { + let viewModelSqliteDb: import('better-sqlite3').Database; + let sqliteObjectView: SqliteObjectView; + + beforeEach(() => { + viewModelSqliteDb = createDb(':memory:'); + sqliteObjectView = new SqliteObjectView({ + viewModelSqliteDb, + projectionName: 'test', + tableNamePrefix: 'tbl_test', + schemaVersion: '1' + }) + }); + + describe('get', () => { + + it('throws an error if id is not a non-empty string', async () => { + + let error; + try { + error = null; + await sqliteObjectView.get(''); + } + catch (err) { + error = err; + } + expect(error).to.exist; + expect(error).to.have.property('message', 'id argument must be a non-empty String'); + + }); + + it('waits for readiness before returning data', async () => { + + await sqliteObjectView.lock(); + + expect(sqliteObjectView).to.have.property('ready', false); + + let resultObtained = false; + const resultPromise = sqliteObjectView.get('test').then(() => { + resultObtained = true; + }); + + await delay(5); + expect(resultObtained).to.eq(false); + + sqliteObjectView.unlock(); + + + await resultPromise; + expect(resultObtained).to.eq(true); + }); + + it('returns stored record if ready', async () => { + + sqliteObjectView.create('1', { foo: 'bar' }); + + const r = await sqliteObjectView.get('1'); + expect(r).to.eql({ foo: 'bar' }); + }); + + it('returns undefined if record does not exist', async () => { + + const r = await sqliteObjectView.get('1'); + expect(r).to.eql(undefined); + }); + }); +}); diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts index 43573a2..c7fecef 100644 --- a/tests/unit/sqlite/SqliteViewLocker.test.ts +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -44,6 +44,19 @@ describe('SqliteViewLocker', function () { expect(lockResult).to.be.true; }); + it('sets ready flag to `false` when locked', async () => { + + await firstLock.lock(); + expect(firstLock).to.have.property('ready', false); + }); + + it('sets ready flag to `true` when unlocked', async () => { + + await firstLock.lock(); + await firstLock.unlock(); + expect(firstLock).to.have.property('ready', true); + }); + it('waits for the lock to be released if already locked', async function () { await firstLock.lock(); From cb57919f0ddb4e9bf1c80fcfa5480724010b6682 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 20 Mar 2025 13:19:49 +0000 Subject: [PATCH 017/169] Tests --- jest.config.ts | 173 +--------------------- src/AbstractProjection.ts | 3 +- src/infrastructure/memory/InMemoryLock.ts | 13 +- tests/unit/memory/InMemoryLock.test.ts | 91 ++++++++++++ 4 files changed, 100 insertions(+), 180 deletions(-) create mode 100644 tests/unit/memory/InMemoryLock.test.ts diff --git a/jest.config.ts b/jest.config.ts index 0a40888..45e753a 100644 --- a/jest.config.ts +++ b/jest.config.ts @@ -4,23 +4,14 @@ */ export default { - // All imported modules in your tests should be mocked automatically - // automock: false, - - // Stop running tests after `n` failures - // bail: 0, - - // The directory where Jest should store its cached dependency information - // cacheDirectory: "/private/var/folders/02/h951kmmd00v199hff5fx0mzh0000gn/T/jest_dx", - - // Automatically clear mock calls and instances between every test - // clearMocks: false, - // Indicates whether the coverage information should be collected while executing the test - // collectCoverage: false, + collectCoverage: false, // An array of glob patterns indicating a set of files for which coverage information should be collected - // collectCoverageFrom: undefined, + collectCoverageFrom: [ + "src/**/*.ts", // Only collect coverage from TypeScript source + "!src/**/*.d.ts", // Ignore TypeScript type declaration files + ], // The directory where Jest should output its coverage files coverageDirectory: "coverage", @@ -31,147 +22,15 @@ export default { // ], // Indicates which provider should be used to instrument code for coverage - coverageProvider: "v8", - - // A list of reporter names that Jest uses when writing coverage reports - // coverageReporters: [ - // "json", - // "text", - // "lcov", - // "clover" - // ], - - // An object that configures minimum threshold enforcement for coverage results - // coverageThreshold: undefined, - - // A path to a custom dependency extractor - // dependencyExtractor: undefined, - - // Make calling deprecated APIs throw helpful error messages - // errorOnDeprecated: false, - - // Force coverage collection from ignored files using an array of glob patterns - // forceCoverageMatch: [], - - // A path to a module which exports an async function that is triggered once before all test suites - // globalSetup: undefined, - - // A path to a module which exports an async function that is triggered once after all test suites - // globalTeardown: undefined, + // coverageProvider: "v8", // A set of global variables that need to be available in all test environments globals: { }, - // The maximum amount of workers used to run your tests. Can be specified as % or a number. E.g. maxWorkers: 10% will use 10% of your CPU amount + 1 as the maximum worker number. maxWorkers: 2 will use a maximum of 2 workers. - // maxWorkers: "50%", - - // An array of directory names to be searched recursively up from the requiring module's location - // moduleDirectories: [ - // "node_modules" - // ], - - // An array of file extensions your modules use - // moduleFileExtensions: [ - // "js", - // "json", - // "jsx", - // "ts", - // "tsx", - // "node" - // ], - - // A map from regular expressions to module names or to arrays of module names that allow to stub out resources with a single module - // moduleNameMapper: {}, - - // An array of regexp pattern strings, matched against all module paths before considered 'visible' to the module loader - // modulePathIgnorePatterns: [], - - // Activates notifications for test results - // notify: false, - - // An enum that specifies notification mode. Requires { notify: true } - // notifyMode: "failure-change", - - // A preset that is used as a base for Jest's configuration - // preset: undefined, - - // Run tests from one or more projects - // projects: undefined, - - // Use this configuration option to add custom reporters to Jest - // reporters: undefined, - - // Automatically reset mock state between every test - // resetMocks: false, - - // Reset the module registry before running each individual test - // resetModules: false, - - // A path to a custom resolver - // resolver: undefined, - - // Automatically restore mock state between every test - // restoreMocks: false, - - // The root directory that Jest should scan for tests and modules within - // rootDir: undefined, - - // A list of paths to directories that Jest should use to search for files in - // roots: [ - // "" - // ], - - // Allows you to use a custom runner instead of Jest's default test runner - // runner: "jest-runner", - - // The paths to modules that run some code to configure or set up the testing environment before each test - // setupFiles: [], - - // A list of paths to modules that run some code to configure or set up the testing framework before each test - // setupFilesAfterEnv: [], - - // The number of seconds after which a test is considered as slow and reported as such in the results. - // slowTestThreshold: 5, - - // A list of paths to snapshot serializer modules Jest should use for snapshot testing - // snapshotSerializers: [], - // The test environment that will be used for testing testEnvironment: "node", - // Options that will be passed to the testEnvironment - // testEnvironmentOptions: {}, - - // Adds a location field to test results - // testLocationInResults: false, - - // The glob patterns Jest uses to detect test files - // testMatch: [ - // "**/__tests__/**/*.[jt]s?(x)", - // "**/?(*.)+(spec|test).[tj]s?(x)" - // ], - - // An array of regexp pattern strings that are matched against all test paths, matched tests are skipped - // testPathIgnorePatterns: [ - // "/node_modules/" - // ], - - // The regexp pattern or array of patterns that Jest uses to detect test files - // testRegex: [], - - // This option allows the use of a custom results processor - // testResultsProcessor: undefined, - - // This option allows use of a custom test runner - // testRunner: "jasmine2", - - // This option sets the URL for the jsdom environment. It is reflected in properties such as location.href - // testURL: "http://localhost", - - // Setting this value to "fake" allows the use of fake timers for functions such as "setTimeout" - // timers: "real", - // A map from regular expressions to paths to transformers transform: { '^.+\\.tsx?$': [ @@ -180,23 +39,5 @@ export default { isolatedModules: true } ] - }, - - // An array of regexp pattern strings that are matched against all source file paths, matched files will skip transformation - // transformIgnorePatterns: [ - // "/node_modules/", - // "\\.pnp\\.[^\\/]+$" - // ], - - // An array of regexp pattern strings that are matched against all modules before the module loader will automatically return a mock for them - // unmockedModulePathPatterns: undefined, - - // Indicates whether each individual test should be reported during the run - // verbose: undefined, - - // An array of regexp patterns that are matched against all source file paths before re-running tests in watch mode - // watchPathIgnorePatterns: [], - - // Whether to use watchman for file crawling - // watchman: true, + } }; diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 87aaef7..ecb1cb7 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -9,8 +9,7 @@ import { IEventStore, IEvent, isViewLocker, - isEventLocker, - IViewFactory + isEventLocker } from './interfaces'; import { diff --git a/src/infrastructure/memory/InMemoryLock.ts b/src/infrastructure/memory/InMemoryLock.ts index 7203884..a8f2192 100644 --- a/src/infrastructure/memory/InMemoryLock.ts +++ b/src/infrastructure/memory/InMemoryLock.ts @@ -19,18 +19,7 @@ export class InMemoryLock { while (this.locked) await this.once('unlocked'); - try { - this.#lockMarker = new Deferred(); - } - catch (err: any) { - try { - await this.unlock(); - } - catch (unlockErr: any) { - // unlocking errors are ignored - } - throw err; - } + this.#lockMarker = new Deferred(); } /** diff --git a/tests/unit/memory/InMemoryLock.test.ts b/tests/unit/memory/InMemoryLock.test.ts new file mode 100644 index 0000000..63974e4 --- /dev/null +++ b/tests/unit/memory/InMemoryLock.test.ts @@ -0,0 +1,91 @@ +import { expect } from 'chai'; +import { InMemoryLock } from '../../../src'; + +describe('InMemoryLock', () => { + let lock: InMemoryLock; + + beforeEach(() => { + lock = new InMemoryLock(); + }); + + it('should call each method explicitly to satisfy coverage', async () => { + await lock.lock(); + await lock.unlock(); + await lock.once('unlocked'); // Even if tested elsewhere, call it directly + }); + + it('starts unlocked', () => { + expect(lock.locked).to.be.false; + }); + + it('acquires a lock', async () => { + await lock.lock(); + expect(lock.locked).to.be.true; + }); + + it('blocks second lock() call until unlocked', async () => { + await lock.lock(); + let secondLockAcquired = false; + + // Try acquiring the lock again, but in a separate async operation + const secondLock = lock.lock().then(() => { + secondLockAcquired = true; + }); + + // Ensure second lock() is still waiting + await new Promise((resolve) => setTimeout(resolve, 100)); + expect(secondLockAcquired).to.be.false; + + // Unlock and allow second lock to proceed + await lock.unlock(); + await secondLock; + expect(secondLockAcquired).to.be.true; + }); + + it('unlocks the lock', async () => { + await lock.lock(); + expect(lock.locked).to.be.true; + + await lock.unlock(); + expect(lock.locked).to.be.false; + }); + + it('resolves once() immediately if not locked', async () => { + let resolved = false; + + await lock.once('unlocked').then(() => { + resolved = true; + }); + + expect(resolved).to.be.true; + }); + + it('resolves once() only after unlocking', async () => { + await lock.lock(); + let resolved = false; + + const waitForUnlock = lock.once('unlocked').then(() => { + resolved = true; + }); + + // Ensure it's still waiting + await new Promise((resolve) => setTimeout(resolve, 100)); + expect(resolved).to.be.false; + + // Unlock and verify resolution + await lock.unlock(); + await waitForUnlock; + expect(resolved).to.be.true; + }); + + it('handles multiple unlock() calls gracefully', async () => { + await lock.lock(); + await lock.unlock(); + await lock.unlock(); // Should not throw or change state + expect(lock.locked).to.be.false; + }); + + it('throws an error for unexpected event types in once()', () => { + expect(() => lock.once('invalid_event')).to.throw(TypeError); + }); +}); From 405ade3461b0f0ef31f37bbbeacede661943d146 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 21 Mar 2025 18:25:35 +0000 Subject: [PATCH 018/169] Refactoring --- src/AbstractAggregate.ts | 17 ++++---- src/AbstractProjection.ts | 51 +++++++++++++++------- src/AggregateCommandHandler.ts | 3 +- src/CqrsContainerBuilder.ts | 3 +- src/index.ts | 1 - src/interfaces/IAggregate.ts | 2 +- src/utils/getHandledMessageTypes.ts | 20 --------- src/utils/getMessageHandlerNames.ts | 10 +---- src/utils/index.ts | 1 - src/utils/subscribe.ts | 20 +++++++-- tests/unit/AggregateCommandHandler.test.ts | 5 +-- tests/unit/CqrsContainerBuilder.test.ts | 2 +- 12 files changed, 68 insertions(+), 67 deletions(-) delete mode 100644 src/utils/getHandledMessageTypes.ts diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index a7da6ae..fd69a79 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -8,7 +8,7 @@ import { IAggregateConstructorParams } from "./interfaces"; -import { getClassName, validateHandlers, getHandler } from './utils'; +import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils'; /** * Deep-clone simple JS object @@ -25,16 +25,15 @@ const SNAPSHOT_EVENT_TYPE = 'snapshot'; export abstract class AbstractAggregate implements IAggregate { /** - * Optional list of commands handled by Aggregate. - * - * If not overridden in Aggregate implementation, - * `AggregateCommandHandler` will treat all public methods as command handlers + * List of command names handled by the Aggregate. * - * @example - * return ['createUser', 'changePassword']; + * Can be overridden in the Aggregate implementation to explicitly define supported commands. + * If not overridden, all public methods will be treated as command handlers by default. + * + * @example ['createUser', 'changePassword']; */ - static get handles(): string[] | undefined { - return undefined; + static get handles(): string[] { + return getMessageHandlerNames(this); } #id: Identifier; diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index ecb1cb7..a999f50 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -16,24 +16,25 @@ import { getClassName, validateHandlers, getHandler, - getHandledMessageTypes, - subscribe + subscribe, + getMessageHandlerNames } from './utils'; export type AbstractProjectionParams = { /** - * (Optional) Default view associated with the projection + * The default view associated with the projection. + * Can optionally implement IViewLocker and/or IEventLocker. */ view?: T, /** - * Instance for managing view restoration state to prevent early access to an inconsistent view - * or conflicts caused by concurrent restoration by another process. + * Manages view restoration state to prevent early access to an inconsistent view + * or conflicts from concurrent restoration by other processes. */ viewLocker?: IViewLocker, /** - * Instance for tracking event processing state to prevent concurrent processing by multiple processes. + * Tracks event processing state to prevent concurrent handling by multiple processes. */ eventLocker?: IEventLocker, @@ -46,35 +47,53 @@ export type AbstractProjectionParams = { export abstract class AbstractProjection> implements IProjection { /** - * Optional list of event types being handled by projection. - * Can be overridden in projection implementation. - * If not overridden, will detect event types from event handlers declared on the Projection class + * List of event types handled by the projection. Can be overridden in the projection implementation. + * If not overridden, event types will be inferred from handler methods defined on the Projection class. */ - static get handles(): string[] | undefined { - return undefined; + static get handles(): string[] { + return getMessageHandlerNames(this); } - #view: TView; + #view?: TView; #viewLocker?: IViewLocker; #eventLocker?: IEventLocker; protected _logger?: ILogger; + /** + * The default view associated with the projection. + * Can optionally implement IViewLocker and/or IEventLocker. + */ public get view(): TView { - return this.#view; + return this.#view ?? (this.#view = new InMemoryView() as TView); } protected set view(value: TView) { this.#view = value; } + /** + * Manages view restoration state to prevent early access to an inconsistent view + * or conflicts from concurrent restoration by other processes. + */ protected get _viewLocker(): IViewLocker | undefined { return this.#viewLocker ?? (isViewLocker(this.view) ? this.view : undefined); } + protected set _viewLocker(value: IViewLocker | undefined) { + this.#viewLocker = value; + } + + /** + * Tracks event processing state to prevent concurrent handling by multiple processes. + */ protected get _eventLocker(): IEventLocker | undefined { return this.#eventLocker ?? (isEventLocker(this.view) ? this.view : undefined); } + protected set _eventLocker(value: IEventLocker | undefined) { + this.#eventLocker = value; + } + constructor({ view, viewLocker, @@ -83,7 +102,7 @@ export abstract class AbstractProjection> implements I }: AbstractProjectionParams = {}) { validateHandlers(this); - this.#view = view ?? new InMemoryView() as any; + this.#view = view; this.#viewLocker = viewLocker; this.#eventLocker = eventLocker; @@ -158,7 +177,7 @@ export abstract class AbstractProjection> implements I this._logger?.debug(`retrieving ${lastEvent ? `events after ${describe(lastEvent)}` : 'all events'}...`); - const messageTypes = getHandledMessageTypes(this); + const messageTypes = (this.constructor as typeof AbstractProjection).handles; const eventsIterable = eventStore.getEventsByTypes(messageTypes, { afterEvent: lastEvent }); let eventsCount = 0; @@ -174,7 +193,7 @@ export abstract class AbstractProjection> implements I } } - this._logger?.info(`view restored (${this.#view}) from ${eventsCount} event(s) in ${Date.now() - startTs} ms`); + this._logger?.info(`view restored from ${eventsCount} event(s) in ${Date.now() - startTs} ms`); } /** Handle error on restoring. Logs and throws error by default */ diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index bf469c3..af886d7 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -15,7 +15,6 @@ import { import { iteratorToArray, getClassName, - getHandledMessageTypes, subscribe } from './utils'; @@ -58,7 +57,7 @@ export class AggregateCommandHandler implements ICommandHandler { if (aggregateType) { const AggregateType = aggregateType; this.#aggregateFactory = params => new AggregateType(params); - this.#handles = getHandledMessageTypes(AggregateType); + this.#handles = AggregateType.handles; } else if (aggregateFactory) { if (!Array.isArray(handles) || !handles.length) diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index a2ef76d..9aaecf8 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -6,7 +6,6 @@ import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; import { - getHandledMessageTypes, isClass } from './utils'; @@ -94,7 +93,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { container.createInstance(AggregateCommandHandler, { aggregateFactory: (options: any) => container.createInstance(AggregateType, options), - handles: getHandledMessageTypes(AggregateType) + handles: AggregateType.handles }); return this.registerCommandHandler(commandHandlerFactory); diff --git a/src/index.ts b/src/index.ts index 31360d3..bd3b6bd 100644 --- a/src/index.ts +++ b/src/index.ts @@ -15,7 +15,6 @@ export * as SQLite from './infrastructure/sqlite'; export * as Event from './Event'; export { getMessageHandlerNames, - getHandledMessageTypes, subscribe } from './utils'; diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts index d5e924c..97aef7d 100644 --- a/src/interfaces/IAggregate.ts +++ b/src/interfaces/IAggregate.ts @@ -47,7 +47,7 @@ export type IAggregateConstructorParams { - readonly handles?: string[]; + readonly handles: string[]; new(options: IAggregateConstructorParams): IAggregate; } diff --git a/src/utils/getHandledMessageTypes.ts b/src/utils/getHandledMessageTypes.ts deleted file mode 100644 index 8d910ec..0000000 --- a/src/utils/getHandledMessageTypes.ts +++ /dev/null @@ -1,20 +0,0 @@ -import { getMessageHandlerNames } from './getMessageHandlerNames'; - -/** - * Get a list of message types handled by observer - */ -export function getHandledMessageTypes( - observerInstanceOrClass: (object | Function) & { handles?: string[] } -): string[] { - if (!observerInstanceOrClass) - throw new TypeError('observerInstanceOrClass argument required'); - - if (observerInstanceOrClass.handles) - return observerInstanceOrClass.handles; - - const prototype = Object.getPrototypeOf(observerInstanceOrClass); - if (prototype && prototype.constructor && prototype.constructor.handles) - return prototype.constructor.handles; - - return getMessageHandlerNames(observerInstanceOrClass); -} diff --git a/src/utils/getMessageHandlerNames.ts b/src/utils/getMessageHandlerNames.ts index 1c8eb1a..a9342ce 100644 --- a/src/utils/getMessageHandlerNames.ts +++ b/src/utils/getMessageHandlerNames.ts @@ -1,7 +1,3 @@ -const KNOWN_METHOD_NAMES = new Set([ - 'subscribe' -]); - function getInheritedPropertyNames(prototype: object): string[] { const parentPrototype = prototype && Object.getPrototypeOf(prototype); if (!parentPrototype) @@ -31,14 +27,12 @@ export function getMessageHandlerNames(observerInstanceOrClass: (object | Functi if (!prototype) throw new TypeError('prototype cannot be resolved'); - const inheritedProperties = new Set(getInheritedPropertyNames(prototype)); - + const inheritedProperties = getInheritedPropertyNames(prototype); const propDescriptors = Object.getOwnPropertyDescriptors(prototype); const propNames = Object.keys(propDescriptors); return propNames.filter(key => !key.startsWith('_') && - !inheritedProperties.has(key) && - !KNOWN_METHOD_NAMES.has(key) && + !inheritedProperties.includes(key) && typeof propDescriptors[key].value === 'function'); } diff --git a/src/utils/index.ts b/src/utils/index.ts index 848eb58..560c457 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,6 +1,5 @@ export * from './CompoundEmitter'; export * from './getClassName'; -export * from './getHandledMessageTypes'; export * from './getHandler'; export * from './getMessageHandlerNames'; export * from './isClass'; diff --git a/src/utils/subscribe.ts b/src/utils/subscribe.ts index af09aca..28982b9 100644 --- a/src/utils/subscribe.ts +++ b/src/utils/subscribe.ts @@ -1,9 +1,23 @@ import { IMessageHandler, IObservable } from "../interfaces"; import { getHandler } from './getHandler'; -import { getHandledMessageTypes } from './getHandledMessageTypes'; +import { getMessageHandlerNames } from "./getMessageHandlerNames"; const unique = (arr: T[]): T[] => [...new Set(arr)]; +/** + * Get a list of message types handled by observer + */ +export function getHandledMessageTypes(observerInstanceOrClass: (object | Function)): string[] { + if (!observerInstanceOrClass) + throw new TypeError('observerInstanceOrClass argument required'); + + const prototype = Object.getPrototypeOf(observerInstanceOrClass); + if (prototype && prototype.constructor && prototype.constructor.handles) + return prototype.constructor.handles; + + return getMessageHandlerNames(observerInstanceOrClass); +} + /** * Subscribe observer to observable */ @@ -35,11 +49,11 @@ export function subscribe( for (const messageType of unique(subscribeTo)) { const handler = masterHandler || getHandler(observer, messageType); - if (!handler) + if (!handler) throw new Error(`'${messageType}' handler is not defined or not a function`); if (queueName) { - if(!observable.queue) + if (!observable.queue) throw new TypeError('Observer does not support named queues'); observable.queue(queueName).on(messageType, handler); diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index e057c44..76bd7ec 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -9,7 +9,6 @@ import { EventStore, InMemorySnapshotStorage } from '../../src'; -import { getHandledMessageTypes } from '../../src/utils'; function delay(ms) { return new Promise(resolve => setTimeout(resolve, ms)); @@ -123,7 +122,7 @@ describe('AggregateCommandHandler', function () { const handler = new AggregateCommandHandler({ eventStore, aggregateFactory: () => aggregate, - handles: getHandledMessageTypes(aggregate) + handles: MyAggregate.handles }); await handler.execute({ type: 'doSomething', payload: 'test' }); @@ -191,7 +190,7 @@ describe('AggregateCommandHandler', function () { const handler = new AggregateCommandHandler({ eventStore, aggregateFactory: () => aggregate, - handles: getHandledMessageTypes(aggregate) + handles: MyAggregate.handles }); // test diff --git a/tests/unit/CqrsContainerBuilder.test.ts b/tests/unit/CqrsContainerBuilder.test.ts index 02d2047..2a83b92 100644 --- a/tests/unit/CqrsContainerBuilder.test.ts +++ b/tests/unit/CqrsContainerBuilder.test.ts @@ -11,7 +11,7 @@ import { describe('CqrsContainerBuilder', function () { - let builder; + let builder: ContainerBuilder; beforeEach(() => { builder = new ContainerBuilder(); From cb6e9a64d3f6c6144d066fc8f4223de9450fc6c5 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 21 Mar 2025 21:30:56 +0000 Subject: [PATCH 019/169] Fix merge --- package-lock.json | 25 +------------------------ package.json | 6 ++---- tests/integration/SqliteView.test.ts | 9 ++++----- 3 files changed, 7 insertions(+), 33 deletions(-) diff --git a/package-lock.json b/package-lock.json index 84415be..c9330af 100644 --- a/package-lock.json +++ b/package-lock.json @@ -17,15 +17,13 @@ "@types/jest": "^29.5.13", "@types/node": "^20.16.9", "@types/sinon": "^17.0.4", - "@types/uuid": "^10.0.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "jest": "^29.7.0", "sinon": "^19.0.2", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.6.2", - "uuid": "^10.0.0" + "typescript": "^5.6.2" }, "engines": { "node": ">=10.3.0" @@ -1200,13 +1198,6 @@ "dev": true, "license": "MIT" }, - "node_modules/@types/uuid": { - "version": "10.0.0", - "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-10.0.0.tgz", - "integrity": "sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==", - "dev": true, - "license": "MIT" - }, "node_modules/@types/yargs": { "version": "17.0.33", "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz", @@ -5948,20 +5939,6 @@ "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", "license": "MIT" }, - "node_modules/uuid": { - "version": "10.0.0", - "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz", - "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==", - "dev": true, - "funding": [ - "https://github.com/sponsors/broofa", - "https://github.com/sponsors/ctavan" - ], - "license": "MIT", - "bin": { - "uuid": "dist/bin/uuid" - } - }, "node_modules/v8-compile-cache-lib": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz", diff --git a/package.json b/package.json index c3d17aa..70fcfdd 100644 --- a/package.json +++ b/package.json @@ -28,7 +28,7 @@ "test": "jest --verbose tests/unit", "test:coverage": "jest --collect-coverage tests/unit", "pretest:integration": "npm run build", - "test:integration": "jest --verbose examples/user-domain-tests", + "test:integration": "jest --verbose examples/user-domain-tests tests/integration", "changelog": "conventional-changelog -n ./scripts/changelog -i CHANGELOG.md -s", "clean": "tsc --build --clean", "build": "tsc --build", @@ -48,15 +48,13 @@ "@types/jest": "^29.5.13", "@types/node": "^20.16.9", "@types/sinon": "^17.0.4", - "@types/uuid": "^10.0.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "jest": "^29.7.0", "sinon": "^19.0.2", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.6.2", - "uuid": "^10.0.0" + "typescript": "^5.6.2" }, "peerDependencies": { "better-sqlite3": "^11.3.0", diff --git a/tests/integration/SqliteView.test.ts b/tests/integration/SqliteView.test.ts index b09e72d..c84797d 100644 --- a/tests/integration/SqliteView.test.ts +++ b/tests/integration/SqliteView.test.ts @@ -3,7 +3,6 @@ import { existsSync, unlinkSync } from 'fs'; import { AbstractProjection, IEvent } from '../../src'; import { SqliteObjectView } from '../../src/infrastructure/sqlite'; import * as createDb from 'better-sqlite3'; -import { v7 } from 'uuid'; type UserPayload = { name: string; @@ -87,10 +86,10 @@ describe.only('SqliteView', () => { await p.view.lock(); await p.view.unlock(); - const aggregateIds = Array.from({ length: 5_000 }, () => ({ - id1: v7(), - id2: v7(), - id3: v7() + const aggregateIds = Array.from({ length: 5_000 }, (v, i) => ({ + id1: `${i}A`, + id2: `${i}B`, + id3: `${i}C` })); console.time(); From b7cca4e1fa5e195819ba3dc31b90fcd89c59f41f Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 21 Mar 2025 21:54:14 +0000 Subject: [PATCH 020/169] Fix key types on InMemoryView --- src/infrastructure/memory/InMemoryView.ts | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/infrastructure/memory/InMemoryView.ts b/src/infrastructure/memory/InMemoryView.ts index 34aae0b..9fc90f7 100644 --- a/src/infrastructure/memory/InMemoryView.ts +++ b/src/infrastructure/memory/InMemoryView.ts @@ -70,7 +70,7 @@ export class InMemoryView implements IViewLocker, IObjectStorage implements IViewLocker, IObjectStorage implements IViewLocker, IObjectStorage TRecord) { + async update(key: Identifier, update: (r: TRecord) => TRecord) { if (!key) throw new TypeError('key argument required'); if (typeof update !== 'function') @@ -144,7 +144,7 @@ export class InMemoryView implements IViewLocker, IObjectStorage TRecord) { + async updateEnforcingNew(key: Identifier, update: (r?: TRecord) => TRecord) { if (!key) throw new TypeError('key argument required'); if (typeof update !== 'function') From c235573678be349d031d1a696cab3993224979a2 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 21 Mar 2025 23:14:43 +0000 Subject: [PATCH 021/169] Change: Support persistent views; Add SQLite infrastructure --- .editorconfig | 1 + examples/user-domain-tests/index.test.js | 7 +- examples/user-domain/index.js | 4 +- jest.config.ts | 173 +- package-lock.json | 1582 +++++++++++++---- package.json | 21 +- src/AbstractAggregate.ts | 17 +- src/AbstractProjection.ts | 172 +- src/AggregateCommandHandler.ts | 8 +- src/CommandBus.ts | 2 +- src/CqrsContainerBuilder.ts | 4 +- src/EventStore.ts | 172 +- src/SagaEventHandler.ts | 6 +- src/index.ts | 9 +- src/infrastructure/InMemoryLock.ts | 73 - .../{ => memory}/InMemoryEventStorage.ts | 36 +- src/infrastructure/memory/InMemoryLock.ts | 43 + .../{ => memory}/InMemoryMessageBus.ts | 2 +- .../{ => memory}/InMemorySnapshotStorage.ts | 4 +- .../{ => memory}/InMemoryView.ts | 22 +- src/infrastructure/memory/index.ts | 6 + .../{ => memory}/utils/Deferred.ts | 0 .../{ => memory}/utils/index.ts | 0 .../{ => memory}/utils/nextCycle.ts | 0 .../sqlite/AbstractSqliteObjectProjection.ts | 27 + .../sqlite/AbstractSqliteView.ts | 52 + .../sqlite/SqliteEventLocker.ts | 131 ++ .../sqlite/SqliteObjectStorage.ts | 110 ++ src/infrastructure/sqlite/SqliteObjectView.ts | 73 + src/infrastructure/sqlite/SqliteViewLocker.ts | 173 ++ src/infrastructure/sqlite/commonParams.ts | 22 + src/infrastructure/sqlite/index.ts | 6 + .../sqlite/queries/eventLockTableInit.ts | 10 + src/infrastructure/sqlite/queries/index.ts | 2 + .../sqlite/queries/viewLockTableInit.ts | 9 + src/infrastructure/sqlite/utils/getEventId.ts | 8 + src/infrastructure/sqlite/utils/guid.ts | 4 + src/infrastructure/sqlite/utils/index.ts | 2 + src/interfaces.ts | 328 ---- src/interfaces/IAggregate.ts | 56 + src/interfaces/IAggregateSnapshotStorage.ts | 8 + src/interfaces/ICommand.ts | 3 + src/interfaces/ICommandBus.ts | 18 + src/interfaces/IEvent.ts | 6 + src/interfaces/IEventLocker.ts | 34 + src/interfaces/IEventReceptor.ts | 6 + src/interfaces/IEventSet.ts | 6 + src/interfaces/IEventStorage.ts | 29 + src/interfaces/IEventStore.ts | 26 + src/interfaces/IEventStream.ts | 3 + src/interfaces/ILogger.ts | 11 + src/interfaces/IMessage.ts | 15 + src/interfaces/IMessageBus.ts | 8 + src/interfaces/IObjectStorage.ts | 13 + src/interfaces/IObservable.ts | 20 + src/interfaces/IObserver.ts | 5 + src/interfaces/IProjection.ts | 20 + src/interfaces/ISaga.ts | 37 + src/interfaces/IViewLocker.ts | 46 + src/interfaces/Identifier.ts | 1 + src/interfaces/index.ts | 21 + src/interfaces/isObject.ts | 5 + src/utils/CompoundEmitter.ts | 45 + src/utils/getHandledMessageTypes.ts | 20 - src/utils/getMessageHandlerNames.ts | 10 +- src/utils/index.ts | 10 +- src/utils/isIEventStorage.ts | 8 + src/utils/isIMessageBus.ts | 9 + src/utils/isIObservable.ts | 7 + src/utils/iteratorToArray.ts | 6 + src/utils/subscribe.ts | 20 +- tests/integration/SqliteView.test.ts | 127 ++ tests/unit/AbstractProjection.test.ts | 37 +- tests/unit/AggregateCommandHandler.test.ts | 11 +- tests/unit/CommandBus.test.ts | 3 +- tests/unit/CqrsContainerBuilder.test.ts | 6 +- tests/unit/EventStore.test.ts | 87 +- tests/unit/SagaEventHandler.test.ts | 8 +- .../unit/memory/InMemoryEventStorage.test.ts | 127 ++ tests/unit/memory/InMemoryLock.test.ts | 91 + .../{ => memory}/InMemoryMessageBus.test.ts | 4 +- tests/unit/{ => memory}/InMemoryView.test.ts | 4 +- tests/unit/sqlite/SqliteEventLocker.test.ts | 97 + tests/unit/sqlite/SqliteObjectStorage.test.ts | 86 + tests/unit/sqlite/SqliteObjectView.test.ts | 73 + tests/unit/sqlite/SqliteViewLocker.test.ts | 122 ++ 86 files changed, 3440 insertions(+), 1296 deletions(-) delete mode 100644 src/infrastructure/InMemoryLock.ts rename src/infrastructure/{ => memory}/InMemoryEventStorage.ts (51%) create mode 100644 src/infrastructure/memory/InMemoryLock.ts rename src/infrastructure/{ => memory}/InMemoryMessageBus.ts (99%) rename src/infrastructure/{ => memory}/InMemorySnapshotStorage.ts (86%) rename src/infrastructure/{ => memory}/InMemoryView.ts (92%) create mode 100644 src/infrastructure/memory/index.ts rename src/infrastructure/{ => memory}/utils/Deferred.ts (100%) rename src/infrastructure/{ => memory}/utils/index.ts (100%) rename src/infrastructure/{ => memory}/utils/nextCycle.ts (100%) create mode 100644 src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts create mode 100644 src/infrastructure/sqlite/AbstractSqliteView.ts create mode 100644 src/infrastructure/sqlite/SqliteEventLocker.ts create mode 100644 src/infrastructure/sqlite/SqliteObjectStorage.ts create mode 100644 src/infrastructure/sqlite/SqliteObjectView.ts create mode 100644 src/infrastructure/sqlite/SqliteViewLocker.ts create mode 100644 src/infrastructure/sqlite/commonParams.ts create mode 100644 src/infrastructure/sqlite/index.ts create mode 100644 src/infrastructure/sqlite/queries/eventLockTableInit.ts create mode 100644 src/infrastructure/sqlite/queries/index.ts create mode 100644 src/infrastructure/sqlite/queries/viewLockTableInit.ts create mode 100644 src/infrastructure/sqlite/utils/getEventId.ts create mode 100644 src/infrastructure/sqlite/utils/guid.ts create mode 100644 src/infrastructure/sqlite/utils/index.ts delete mode 100644 src/interfaces.ts create mode 100644 src/interfaces/IAggregate.ts create mode 100644 src/interfaces/IAggregateSnapshotStorage.ts create mode 100644 src/interfaces/ICommand.ts create mode 100644 src/interfaces/ICommandBus.ts create mode 100644 src/interfaces/IEvent.ts create mode 100644 src/interfaces/IEventLocker.ts create mode 100644 src/interfaces/IEventReceptor.ts create mode 100644 src/interfaces/IEventSet.ts create mode 100644 src/interfaces/IEventStorage.ts create mode 100644 src/interfaces/IEventStore.ts create mode 100644 src/interfaces/IEventStream.ts create mode 100644 src/interfaces/ILogger.ts create mode 100644 src/interfaces/IMessage.ts create mode 100644 src/interfaces/IMessageBus.ts create mode 100644 src/interfaces/IObjectStorage.ts create mode 100644 src/interfaces/IObservable.ts create mode 100644 src/interfaces/IObserver.ts create mode 100644 src/interfaces/IProjection.ts create mode 100644 src/interfaces/ISaga.ts create mode 100644 src/interfaces/IViewLocker.ts create mode 100644 src/interfaces/Identifier.ts create mode 100644 src/interfaces/index.ts create mode 100644 src/interfaces/isObject.ts create mode 100644 src/utils/CompoundEmitter.ts delete mode 100644 src/utils/getHandledMessageTypes.ts create mode 100644 src/utils/isIEventStorage.ts create mode 100644 src/utils/isIMessageBus.ts create mode 100644 src/utils/isIObservable.ts create mode 100644 src/utils/iteratorToArray.ts create mode 100644 tests/integration/SqliteView.test.ts create mode 100644 tests/unit/memory/InMemoryEventStorage.test.ts create mode 100644 tests/unit/memory/InMemoryLock.test.ts rename tests/unit/{ => memory}/InMemoryMessageBus.test.ts (95%) rename tests/unit/{ => memory}/InMemoryView.test.ts (97%) create mode 100644 tests/unit/sqlite/SqliteEventLocker.test.ts create mode 100644 tests/unit/sqlite/SqliteObjectStorage.test.ts create mode 100644 tests/unit/sqlite/SqliteObjectView.test.ts create mode 100644 tests/unit/sqlite/SqliteViewLocker.test.ts diff --git a/.editorconfig b/.editorconfig index e81eb91..55cf59a 100644 --- a/.editorconfig +++ b/.editorconfig @@ -35,6 +35,7 @@ indent_size = 2 [*.json] indent_style = space indent_size = 4 +insert_final_newline = false [*.yml] indent_style = space diff --git a/examples/user-domain-tests/index.test.js b/examples/user-domain-tests/index.test.js index 4dcb988..2b87755 100644 --- a/examples/user-domain-tests/index.test.js +++ b/examples/user-domain-tests/index.test.js @@ -2,7 +2,7 @@ const { expect } = require('chai'); const { createContainer, createBaseInstances } = require('../user-domain'); -const { nextCycle } = require('../../src/infrastructure/utils'); +const { nextCycle } = require('../../src/infrastructure/memory/utils'); describe('user-domain example', () => { @@ -55,8 +55,7 @@ describe('user-domain example', () => { const { commandBus, eventStore, users } = container; - // HACK: let projection restoring to start before emitting new events - await nextCycle(); + const userCreatedPromise = eventStore.once('userCreated'); await commandBus.send('createUser', undefined, { payload: { @@ -65,7 +64,7 @@ describe('user-domain example', () => { } }); - const userCreated = await eventStore.once('userCreated'); + const userCreated = await userCreatedPromise; const viewRecord = await users.get(userCreated.aggregateId); diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index 11e2bee..75d239c 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -19,7 +19,7 @@ exports.createContainer = () => { // register infrastructure services builder.register(InMemoryEventStorage).as('storage'); - builder.register(InMemoryMessageBus).as('messageBus'); + builder.register(InMemoryMessageBus).as('supplementaryEventBus'); // register domain entities builder.registerAggregate(UserAggregate); @@ -36,7 +36,7 @@ exports.createBaseInstances = () => { // create infrastructure services const messageBus = new InMemoryMessageBus(); const storage = new InMemoryEventStorage(); - const eventStore = new EventStore({ storage, messageBus }); + const eventStore = new EventStore({ storage, supplementaryEventBus: messageBus }); const commandBus = new CommandBus({ messageBus }); /** @type {IAggregateConstructor} */ diff --git a/jest.config.ts b/jest.config.ts index 0a40888..45e753a 100644 --- a/jest.config.ts +++ b/jest.config.ts @@ -4,23 +4,14 @@ */ export default { - // All imported modules in your tests should be mocked automatically - // automock: false, - - // Stop running tests after `n` failures - // bail: 0, - - // The directory where Jest should store its cached dependency information - // cacheDirectory: "/private/var/folders/02/h951kmmd00v199hff5fx0mzh0000gn/T/jest_dx", - - // Automatically clear mock calls and instances between every test - // clearMocks: false, - // Indicates whether the coverage information should be collected while executing the test - // collectCoverage: false, + collectCoverage: false, // An array of glob patterns indicating a set of files for which coverage information should be collected - // collectCoverageFrom: undefined, + collectCoverageFrom: [ + "src/**/*.ts", // Only collect coverage from TypeScript source + "!src/**/*.d.ts", // Ignore TypeScript type declaration files + ], // The directory where Jest should output its coverage files coverageDirectory: "coverage", @@ -31,147 +22,15 @@ export default { // ], // Indicates which provider should be used to instrument code for coverage - coverageProvider: "v8", - - // A list of reporter names that Jest uses when writing coverage reports - // coverageReporters: [ - // "json", - // "text", - // "lcov", - // "clover" - // ], - - // An object that configures minimum threshold enforcement for coverage results - // coverageThreshold: undefined, - - // A path to a custom dependency extractor - // dependencyExtractor: undefined, - - // Make calling deprecated APIs throw helpful error messages - // errorOnDeprecated: false, - - // Force coverage collection from ignored files using an array of glob patterns - // forceCoverageMatch: [], - - // A path to a module which exports an async function that is triggered once before all test suites - // globalSetup: undefined, - - // A path to a module which exports an async function that is triggered once after all test suites - // globalTeardown: undefined, + // coverageProvider: "v8", // A set of global variables that need to be available in all test environments globals: { }, - // The maximum amount of workers used to run your tests. Can be specified as % or a number. E.g. maxWorkers: 10% will use 10% of your CPU amount + 1 as the maximum worker number. maxWorkers: 2 will use a maximum of 2 workers. - // maxWorkers: "50%", - - // An array of directory names to be searched recursively up from the requiring module's location - // moduleDirectories: [ - // "node_modules" - // ], - - // An array of file extensions your modules use - // moduleFileExtensions: [ - // "js", - // "json", - // "jsx", - // "ts", - // "tsx", - // "node" - // ], - - // A map from regular expressions to module names or to arrays of module names that allow to stub out resources with a single module - // moduleNameMapper: {}, - - // An array of regexp pattern strings, matched against all module paths before considered 'visible' to the module loader - // modulePathIgnorePatterns: [], - - // Activates notifications for test results - // notify: false, - - // An enum that specifies notification mode. Requires { notify: true } - // notifyMode: "failure-change", - - // A preset that is used as a base for Jest's configuration - // preset: undefined, - - // Run tests from one or more projects - // projects: undefined, - - // Use this configuration option to add custom reporters to Jest - // reporters: undefined, - - // Automatically reset mock state between every test - // resetMocks: false, - - // Reset the module registry before running each individual test - // resetModules: false, - - // A path to a custom resolver - // resolver: undefined, - - // Automatically restore mock state between every test - // restoreMocks: false, - - // The root directory that Jest should scan for tests and modules within - // rootDir: undefined, - - // A list of paths to directories that Jest should use to search for files in - // roots: [ - // "" - // ], - - // Allows you to use a custom runner instead of Jest's default test runner - // runner: "jest-runner", - - // The paths to modules that run some code to configure or set up the testing environment before each test - // setupFiles: [], - - // A list of paths to modules that run some code to configure or set up the testing framework before each test - // setupFilesAfterEnv: [], - - // The number of seconds after which a test is considered as slow and reported as such in the results. - // slowTestThreshold: 5, - - // A list of paths to snapshot serializer modules Jest should use for snapshot testing - // snapshotSerializers: [], - // The test environment that will be used for testing testEnvironment: "node", - // Options that will be passed to the testEnvironment - // testEnvironmentOptions: {}, - - // Adds a location field to test results - // testLocationInResults: false, - - // The glob patterns Jest uses to detect test files - // testMatch: [ - // "**/__tests__/**/*.[jt]s?(x)", - // "**/?(*.)+(spec|test).[tj]s?(x)" - // ], - - // An array of regexp pattern strings that are matched against all test paths, matched tests are skipped - // testPathIgnorePatterns: [ - // "/node_modules/" - // ], - - // The regexp pattern or array of patterns that Jest uses to detect test files - // testRegex: [], - - // This option allows the use of a custom results processor - // testResultsProcessor: undefined, - - // This option allows use of a custom test runner - // testRunner: "jasmine2", - - // This option sets the URL for the jsdom environment. It is reflected in properties such as location.href - // testURL: "http://localhost", - - // Setting this value to "fake" allows the use of fake timers for functions such as "setTimeout" - // timers: "real", - // A map from regular expressions to paths to transformers transform: { '^.+\\.tsx?$': [ @@ -180,23 +39,5 @@ export default { isolatedModules: true } ] - }, - - // An array of regexp pattern strings that are matched against all source file paths, matched files will skip transformation - // transformIgnorePatterns: [ - // "/node_modules/", - // "\\.pnp\\.[^\\/]+$" - // ], - - // An array of regexp pattern strings that are matched against all modules before the module loader will automatically return a mock for them - // unmockedModulePathPatterns: undefined, - - // Indicates whether each individual test should be reported during the run - // verbose: undefined, - - // An array of regexp patterns that are matched against all source file paths before re-running tests in watch mode - // watchPathIgnorePatterns: [], - - // Whether to use watchman for file crawling - // watchman: true, + } }; diff --git a/package-lock.json b/package-lock.json index 603dbe4..c9330af 100644 --- a/package-lock.json +++ b/package-lock.json @@ -12,20 +12,25 @@ "di0": "^1.0.0" }, "devDependencies": { - "@types/chai": "^4.3.17", - "@types/jest": "^29.5.12", - "@types/node": "^20.14.14", - "@types/sinon": "^10.0.20", + "@types/better-sqlite3": "^7.6.11", + "@types/chai": "^4.3.20", + "@types/jest": "^29.5.13", + "@types/node": "^20.16.9", + "@types/sinon": "^17.0.4", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "jest": "^29.7.0", - "sinon": "^15.2.0", - "ts-jest": "^29.2.4", + "sinon": "^19.0.2", + "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.5.4" + "typescript": "^5.6.2" }, "engines": { "node": ">=10.3.0" + }, + "peerDependencies": { + "better-sqlite3": "^11.3.0", + "md5": "^2.3.0" } }, "node_modules/@ampproject/remapping": { @@ -33,6 +38,7 @@ "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==", "dev": true, + "license": "Apache-2.0", "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" @@ -57,30 +63,32 @@ } }, "node_modules/@babel/compat-data": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.25.2.tgz", - "integrity": "sha512-bYcppcpKBvX4znYaPEeFau03bp89ShqNMLs+rmdptMw+heSZh9+z84d2YG+K7cYLbWwzdjtDoW/uqZmPjulClQ==", + "version": "7.26.8", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.26.8.tgz", + "integrity": "sha512-oH5UPLMWR3L2wEFLnFJ1TZXqHufiTKAiLfqw5zkhS4dKXLJ10yVztfil/twG8EDTA4F/tvVNw9nOl4ZMslB8rQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/core": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.25.2.tgz", - "integrity": "sha512-BBt3opiCOxUr9euZ5/ro/Xv8/V7yJ5bjYMqG/C1YAo8MIKAnumZalCN+msbci3Pigy4lIQfPUpfMM27HMGaYEA==", + "version": "7.26.10", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.26.10.tgz", + "integrity": "sha512-vMqyb7XCDMPvJFFOaT9kxtiRh42GwlZEg1/uIgtZshS5a/8OaduUfCi7kynKgc3Tw/6Uo2D+db9qBttghhmxwQ==", "dev": true, + "license": "MIT", "dependencies": { "@ampproject/remapping": "^2.2.0", - "@babel/code-frame": "^7.24.7", - "@babel/generator": "^7.25.0", - "@babel/helper-compilation-targets": "^7.25.2", - "@babel/helper-module-transforms": "^7.25.2", - "@babel/helpers": "^7.25.0", - "@babel/parser": "^7.25.0", - "@babel/template": "^7.25.0", - "@babel/traverse": "^7.25.2", - "@babel/types": "^7.25.2", + "@babel/code-frame": "^7.26.2", + "@babel/generator": "^7.26.10", + "@babel/helper-compilation-targets": "^7.26.5", + "@babel/helper-module-transforms": "^7.26.0", + "@babel/helpers": "^7.26.10", + "@babel/parser": "^7.26.10", + "@babel/template": "^7.26.9", + "@babel/traverse": "^7.26.10", + "@babel/types": "^7.26.10", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", @@ -96,29 +104,32 @@ } }, "node_modules/@babel/generator": { - "version": "7.25.0", - "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.25.0.tgz", - "integrity": "sha512-3LEEcj3PVW8pW2R1SR1M89g/qrYk/m/mB/tLqn7dn4sbBUQyTqnlod+II2U4dqiGtUmkcnAmkMDralTFZttRiw==", + "version": "7.26.10", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.26.10.tgz", + "integrity": "sha512-rRHT8siFIXQrAYOYqZQVsAr8vJ+cBNqcVAY6m5V8/4QqzaPl+zDBe6cLEPRDuNOUf3ww8RfJVlOyQMoSI+5Ang==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/types": "^7.25.0", + "@babel/parser": "^7.26.10", + "@babel/types": "^7.26.10", "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.25", - "jsesc": "^2.5.1" + "jsesc": "^3.0.2" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/helper-compilation-targets": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.25.2.tgz", - "integrity": "sha512-U2U5LsSaZ7TAt3cfaymQ8WHh0pxvdHoEk6HVpaexxixjyEquMh0L0YNJNM6CTGKMXV1iksi0iZkGw4AcFkPaaw==", + "version": "7.26.5", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.26.5.tgz", + "integrity": "sha512-IXuyn5EkouFJscIDuFF5EsiSolseme1s0CZB+QxVugqJLYmKdxI1VfIBOst0SUu4rnk2Z7kqTwmoO1lp3HIfnA==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/compat-data": "^7.25.2", - "@babel/helper-validator-option": "^7.24.8", - "browserslist": "^4.23.1", + "@babel/compat-data": "^7.26.5", + "@babel/helper-validator-option": "^7.25.9", + "browserslist": "^4.24.0", "lru-cache": "^5.1.1", "semver": "^6.3.1" }, @@ -131,6 +142,7 @@ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", "dev": true, + "license": "ISC", "dependencies": { "yallist": "^3.0.2" } @@ -139,31 +151,33 @@ "version": "3.1.1", "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/@babel/helper-module-imports": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.24.7.tgz", - "integrity": "sha512-8AyH3C+74cgCVVXow/myrynrAGv+nTVg5vKu2nZph9x7RcRwzmh0VFallJuFTZ9mx6u4eSdXZfcOzSqTUm0HCA==", + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.25.9.tgz", + "integrity": "sha512-tnUA4RsrmflIM6W6RFTLFSXITtl0wKjgpnLgXyowocVPrbYrLUXSBXDgTs8BlbmIzIdlBySRQjINYs2BAkiLtw==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/traverse": "^7.24.7", - "@babel/types": "^7.24.7" + "@babel/traverse": "^7.25.9", + "@babel/types": "^7.25.9" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/helper-module-transforms": { - "version": "7.25.2", - "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.25.2.tgz", - "integrity": "sha512-BjyRAbix6j/wv83ftcVJmBt72QtHI56C7JXZoG2xATiLpmoC7dpd8WnkikExHDVPpi/3qCmO6WY1EaXOluiecQ==", + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.26.0.tgz", + "integrity": "sha512-xO+xu6B5K2czEnQye6BHA7DolFFmS3LB7stHZFaOLb1pAwO1HWLS8fXA+eh0A2yIvltPVmx3eNNDBJA2SLHXFw==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/helper-module-imports": "^7.24.7", - "@babel/helper-simple-access": "^7.24.7", - "@babel/helper-validator-identifier": "^7.24.7", - "@babel/traverse": "^7.25.2" + "@babel/helper-module-imports": "^7.25.9", + "@babel/helper-validator-identifier": "^7.25.9", + "@babel/traverse": "^7.25.9" }, "engines": { "node": ">=6.9.0" @@ -173,23 +187,11 @@ } }, "node_modules/@babel/helper-plugin-utils": { - "version": "7.24.8", - "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.24.8.tgz", - "integrity": "sha512-FFWx5142D8h2Mgr/iPVGH5G7w6jDn4jUSpZTyDnQO0Yn7Ks2Kuz6Pci8H6MPCoUJegd/UZQ3tAvfLCxQSnWWwg==", + "version": "7.26.5", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.26.5.tgz", + "integrity": "sha512-RS+jZcRdZdRFzMyr+wcsaqOmld1/EqTghfaBGQQd/WnRdzdlvSZ//kF7U8VQTxf1ynZ4cjUcYgjVGx13ewNPMg==", "dev": true, - "engines": { - "node": ">=6.9.0" - } - }, - "node_modules/@babel/helper-simple-access": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/helper-simple-access/-/helper-simple-access-7.24.7.tgz", - "integrity": "sha512-zBAIvbCMh5Ts+b86r/CjU+4XGYIs+R1j951gxI3KmmxBMhCg4oQMsv6ZXQ64XOm/cvzfU1FmoCyt6+owc5QMYg==", - "dev": true, - "dependencies": { - "@babel/traverse": "^7.24.7", - "@babel/types": "^7.24.7" - }, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -215,10 +217,11 @@ } }, "node_modules/@babel/helper-validator-option": { - "version": "7.24.8", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.24.8.tgz", - "integrity": "sha512-xb8t9tD1MHLungh/AIoWYN+gVHaB9kwlu8gffXGSt3FFEIT7RjS+xWbc2vUD1UTZdIpKj/ab3rdqJ7ufngyi2Q==", + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.25.9.tgz", + "integrity": "sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -258,6 +261,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz", "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -270,6 +274,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz", "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -282,6 +287,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz", "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.12.13" }, @@ -289,11 +295,44 @@ "@babel/core": "^7.0.0-0" } }, + "node_modules/@babel/plugin-syntax-class-static-block": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz", + "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-attributes": { + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.26.0.tgz", + "integrity": "sha512-e2dttdsJ1ZTpi3B9UYGLw41hifAubg19AtCu/2I/F1QNVclOBr1dYpTdmdyZ84Xiz43BS/tCUkMAZNLv12Pi+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, "node_modules/@babel/plugin-syntax-import-meta": { "version": "7.10.4", "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz", "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, @@ -306,6 +345,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz", "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -314,12 +354,13 @@ } }, "node_modules/@babel/plugin-syntax-jsx": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.24.7.tgz", - "integrity": "sha512-6ddciUPe/mpMnOKv/U+RSd2vvVy+Yw/JfBB0ZHYjEZt9NLHmCUylNYlsbqCCS1Bffjlb0fCwC9Vqz+sBz6PsiQ==", + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.25.9.tgz", + "integrity": "sha512-ld6oezHQMZsZfp6pWtbjaNDF2tiiCYYDqQszHt5VV437lewP9aSi2Of99CK0D0XB21k7FLgnLcmQKyKzynfeAA==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.24.7" + "@babel/helper-plugin-utils": "^7.25.9" }, "engines": { "node": ">=6.9.0" @@ -333,6 +374,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz", "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, @@ -345,6 +387,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz", "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -357,6 +400,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz", "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, @@ -369,6 +413,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz", "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -381,6 +426,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz", "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -393,6 +439,7 @@ "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz", "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.8.0" }, @@ -400,11 +447,28 @@ "@babel/core": "^7.0.0-0" } }, + "node_modules/@babel/plugin-syntax-private-property-in-object": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz", + "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, "node_modules/@babel/plugin-syntax-top-level-await": { "version": "7.14.5", "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz", "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/helper-plugin-utils": "^7.14.5" }, @@ -416,12 +480,13 @@ } }, "node_modules/@babel/plugin-syntax-typescript": { - "version": "7.24.7", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.24.7.tgz", - "integrity": "sha512-c/+fVeJBB0FeKsFvwytYiUD+LBvhHjGSI0g446PRGdSVGZLRNArBUno2PETbAly3tpiNAQR5XaZ+JslxkotsbA==", + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.25.9.tgz", + "integrity": "sha512-hjMgRy5hb8uJJjUcdWunWVcoi9bGpJp8p5Ol1229PoN6aytsLwNMgmdftO23wnCLMfVmTwZDWMPNq/D1SY60JQ==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.24.7" + "@babel/helper-plugin-utils": "^7.25.9" }, "engines": { "node": ">=6.9.0" @@ -446,16 +511,17 @@ } }, "node_modules/@babel/traverse": { - "version": "7.25.3", - "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.25.3.tgz", - "integrity": "sha512-HefgyP1x754oGCsKmV5reSmtV7IXj/kpaE1XYY+D9G5PvKKoFfSbiS4M77MdjuwlZKDIKFCffq9rPU+H/s3ZdQ==", + "version": "7.26.10", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.26.10.tgz", + "integrity": "sha512-k8NuDrxr0WrPH5Aupqb2LCVURP/S0vBEn5mK6iH+GIYob66U5EtoZvcdudR2jQ4cmTwhEwW1DLB+Yyas9zjF6A==", "dev": true, + "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.24.7", - "@babel/generator": "^7.25.0", - "@babel/parser": "^7.25.3", - "@babel/template": "^7.25.0", - "@babel/types": "^7.25.2", + "@babel/code-frame": "^7.26.2", + "@babel/generator": "^7.26.10", + "@babel/parser": "^7.26.10", + "@babel/template": "^7.26.9", + "@babel/types": "^7.26.10", "debug": "^4.3.1", "globals": "^11.1.0" }, @@ -481,13 +547,15 @@ "version": "0.2.3", "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz", "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@cspotcode/source-map-support": { "version": "0.8.1", "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz", "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/trace-mapping": "0.3.9" }, @@ -500,6 +568,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz", "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/resolve-uri": "^3.0.3", "@jridgewell/sourcemap-codec": "^1.4.10" @@ -510,6 +579,7 @@ "resolved": "https://registry.npmjs.org/@hutson/parse-repository-url/-/parse-repository-url-3.0.2.tgz", "integrity": "sha512-H9XAx3hc0BQHY6l+IFSWHDySypcXsvsuLhgYLUGywmJ5pswRVQJUHpOsobnLYp2ZUaUlKiKDrgWWhosOwAEM8Q==", "dev": true, + "license": "Apache-2.0", "engines": { "node": ">=6.9.0" } @@ -519,6 +589,7 @@ "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz", "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==", "dev": true, + "license": "ISC", "dependencies": { "camelcase": "^5.3.1", "find-up": "^4.1.0", @@ -535,6 +606,7 @@ "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz", "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -544,6 +616,7 @@ "resolved": "https://registry.npmjs.org/@jest/console/-/console-29.7.0.tgz", "integrity": "sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/node": "*", @@ -561,6 +634,7 @@ "resolved": "https://registry.npmjs.org/@jest/core/-/core-29.7.0.tgz", "integrity": "sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/console": "^29.7.0", "@jest/reporters": "^29.7.0", @@ -608,6 +682,7 @@ "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-29.7.0.tgz", "integrity": "sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/fake-timers": "^29.7.0", "@jest/types": "^29.6.3", @@ -623,6 +698,7 @@ "resolved": "https://registry.npmjs.org/@jest/expect/-/expect-29.7.0.tgz", "integrity": "sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==", "dev": true, + "license": "MIT", "dependencies": { "expect": "^29.7.0", "jest-snapshot": "^29.7.0" @@ -636,6 +712,7 @@ "resolved": "https://registry.npmjs.org/@jest/expect-utils/-/expect-utils-29.7.0.tgz", "integrity": "sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==", "dev": true, + "license": "MIT", "dependencies": { "jest-get-type": "^29.6.3" }, @@ -648,6 +725,7 @@ "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-29.7.0.tgz", "integrity": "sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@sinonjs/fake-timers": "^10.0.2", @@ -665,6 +743,7 @@ "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-29.7.0.tgz", "integrity": "sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/expect": "^29.7.0", @@ -680,6 +759,7 @@ "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-29.7.0.tgz", "integrity": "sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==", "dev": true, + "license": "MIT", "dependencies": { "@bcoe/v8-coverage": "^0.2.3", "@jest/console": "^29.7.0", @@ -723,6 +803,7 @@ "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", "dev": true, + "license": "MIT", "dependencies": { "@sinclair/typebox": "^0.27.8" }, @@ -735,6 +816,7 @@ "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-29.6.3.tgz", "integrity": "sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/trace-mapping": "^0.3.18", "callsites": "^3.0.0", @@ -749,6 +831,7 @@ "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-29.7.0.tgz", "integrity": "sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==", "dev": true, + "license": "MIT", "dependencies": { "@jest/console": "^29.7.0", "@jest/types": "^29.6.3", @@ -764,6 +847,7 @@ "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz", "integrity": "sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/test-result": "^29.7.0", "graceful-fs": "^4.2.9", @@ -779,6 +863,7 @@ "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-29.7.0.tgz", "integrity": "sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/core": "^7.11.6", "@jest/types": "^29.6.3", @@ -805,6 +890,7 @@ "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz", "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/schemas": "^29.6.3", "@types/istanbul-lib-coverage": "^2.0.0", @@ -818,10 +904,11 @@ } }, "node_modules/@jridgewell/gen-mapping": { - "version": "0.3.5", - "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz", - "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==", + "version": "0.3.8", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.8.tgz", + "integrity": "sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/set-array": "^1.2.1", "@jridgewell/sourcemap-codec": "^1.4.10", @@ -836,6 +923,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.0.0" } @@ -845,6 +933,7 @@ "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz", "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.0.0" } @@ -853,13 +942,15 @@ "version": "1.5.0", "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz", "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@jridgewell/trace-mapping": { "version": "0.3.25", "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz", "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==", "dev": true, + "license": "MIT", "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" @@ -869,13 +960,15 @@ "version": "0.27.8", "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@sinonjs/commons": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-3.0.1.tgz", "integrity": "sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "type-detect": "4.0.8" } @@ -885,6 +978,7 @@ "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -894,74 +988,64 @@ "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-10.3.0.tgz", "integrity": "sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@sinonjs/commons": "^3.0.0" } }, "node_modules/@sinonjs/samsam": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-8.0.0.tgz", - "integrity": "sha512-Bp8KUVlLp8ibJZrnvq2foVhP0IVX2CIprMJPK0vqGqgrDa0OHVKeZyBykqskkrdxV6yKBPmGasO8LVjAKR3Gew==", + "version": "8.0.2", + "resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-8.0.2.tgz", + "integrity": "sha512-v46t/fwnhejRSFTGqbpn9u+LQ9xJDse10gNnPgAcxgdoCDMXj/G2asWAC/8Qs+BAZDicX+MNZouXT1A7c83kVw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^2.0.0", + "@sinonjs/commons": "^3.0.1", "lodash.get": "^4.4.2", - "type-detect": "^4.0.8" - } - }, - "node_modules/@sinonjs/samsam/node_modules/@sinonjs/commons": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-2.0.0.tgz", - "integrity": "sha512-uLa0j859mMrg2slwQYdO/AkrOfmH+X6LTVmNTS9CqexuE2IvVORIkSpJLqePAbEnKJ77aMmCwr1NUZ57120Xcg==", - "dev": true, - "dependencies": { - "type-detect": "4.0.8" - } - }, - "node_modules/@sinonjs/samsam/node_modules/type-detect": { - "version": "4.0.8", - "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", - "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", - "dev": true, - "engines": { - "node": ">=4" + "type-detect": "^4.1.0" } }, "node_modules/@sinonjs/text-encoding": { - "version": "0.7.2", - "resolved": "https://registry.npmjs.org/@sinonjs/text-encoding/-/text-encoding-0.7.2.tgz", - "integrity": "sha512-sXXKG+uL9IrKqViTtao2Ws6dy0znu9sOaP1di/jKGW1M6VssO8vlpXCQcpZ+jisQ1tTFAC5Jo/EOzFbggBagFQ==", - "dev": true + "version": "0.7.3", + "resolved": "https://registry.npmjs.org/@sinonjs/text-encoding/-/text-encoding-0.7.3.tgz", + "integrity": "sha512-DE427ROAphMQzU4ENbliGYrBSYPXF+TtLg9S8vzeA+OF4ZKzoDdzfL8sxuMUGS/lgRhM6j1URSk9ghf7Xo1tyA==", + "dev": true, + "license": "(Unlicense OR Apache-2.0)" }, "node_modules/@tsconfig/node10": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz", "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@tsconfig/node12": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz", "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@tsconfig/node14": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz", "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@tsconfig/node16": { "version": "1.0.4", "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz", "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/babel__core": { "version": "7.20.5", "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", "dev": true, + "license": "MIT", "dependencies": { "@babel/parser": "^7.20.7", "@babel/types": "^7.20.7", @@ -975,6 +1059,7 @@ "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.8.tgz", "integrity": "sha512-ASsj+tpEDsEiFr1arWrlN6V3mdfjRMZt6LtK/Vp/kreFLnr5QH5+DhvD5nINYZXzwJvXeGq+05iUXcAzVrqWtw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/types": "^7.0.0" } @@ -984,6 +1069,7 @@ "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", "dev": true, + "license": "MIT", "dependencies": { "@babel/parser": "^7.1.0", "@babel/types": "^7.0.0" @@ -994,21 +1080,34 @@ "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.20.6.tgz", "integrity": "sha512-r1bzfrm0tomOI8g1SzvCaQHo6Lcv6zu0EA+W2kHrt8dyrHQxGzBBL4kdkzIS+jBMV+EYcMAEAqXqYaLJq5rOZg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/types": "^7.20.7" } }, + "node_modules/@types/better-sqlite3": { + "version": "7.6.12", + "resolved": "https://registry.npmjs.org/@types/better-sqlite3/-/better-sqlite3-7.6.12.tgz", + "integrity": "sha512-fnQmj8lELIj7BSrZQAdBMHEHX8OZLYIHXqAKT1O7tDfLxaINzf00PMjw22r3N/xXh0w/sGHlO6SVaCQ2mj78lg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, "node_modules/@types/chai": { - "version": "4.3.17", - "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.17.tgz", - "integrity": "sha512-zmZ21EWzR71B4Sscphjief5djsLre50M6lI622OSySTmn9DB3j+C3kWroHfBQWXbOBwbgg/M8CG/hUxDLIloow==", - "dev": true + "version": "4.3.20", + "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.20.tgz", + "integrity": "sha512-/pC9HAB5I/xMlc5FP77qjCnI16ChlJfW0tGa0IUcFn38VJrTV6DeZ60NU5KZBtaOZqjdpwTWohz5HU1RrhiYxQ==", + "dev": true, + "license": "MIT" }, "node_modules/@types/graceful-fs": { "version": "4.1.9", "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz", "integrity": "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==", "dev": true, + "license": "MIT", "dependencies": { "@types/node": "*" } @@ -1017,13 +1116,15 @@ "version": "2.0.6", "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz", "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/istanbul-lib-report": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz", "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==", "dev": true, + "license": "MIT", "dependencies": { "@types/istanbul-lib-coverage": "*" } @@ -1033,15 +1134,17 @@ "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz", "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==", "dev": true, + "license": "MIT", "dependencies": { "@types/istanbul-lib-report": "*" } }, "node_modules/@types/jest": { - "version": "29.5.12", - "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.12.tgz", - "integrity": "sha512-eDC8bTvT/QhYdxJAulQikueigY5AsdBRH2yDKW3yveW7svY3+DzN84/2NUgkw10RTiJbWqZrTtoGVdYlvFJdLw==", + "version": "29.5.14", + "resolved": "https://registry.npmjs.org/@types/jest/-/jest-29.5.14.tgz", + "integrity": "sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==", "dev": true, + "license": "MIT", "dependencies": { "expect": "^29.0.0", "pretty-format": "^29.0.0" @@ -1051,28 +1154,32 @@ "version": "1.2.5", "resolved": "https://registry.npmjs.org/@types/minimist/-/minimist-1.2.5.tgz", "integrity": "sha512-hov8bUuiLiyFPGyFPE1lwWhmzYbirOXQNNo40+y3zow8aFVTeyn3VWL0VFFfdNddA8S4Vf0Tc062rzyNr7Paag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/node": { - "version": "20.14.14", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.14.14.tgz", - "integrity": "sha512-d64f00982fS9YoOgJkAMolK7MN8Iq3TDdVjchbYHdEmjth/DHowx82GnoA+tVUAN+7vxfYUgAzi+JXbKNd2SDQ==", + "version": "20.17.25", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.25.tgz", + "integrity": "sha512-bT+r2haIlplJUYtlZrEanFHdPIZTeiMeh/fSOEbOOfWf9uTn+lg8g0KU6Q3iMgjd9FLuuMAgfCNSkjUbxL6E3Q==", "dev": true, + "license": "MIT", "dependencies": { - "undici-types": "~5.26.4" + "undici-types": "~6.19.2" } }, "node_modules/@types/normalize-package-data": { "version": "2.4.4", "resolved": "https://registry.npmjs.org/@types/normalize-package-data/-/normalize-package-data-2.4.4.tgz", "integrity": "sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/sinon": { - "version": "10.0.20", - "resolved": "https://registry.npmjs.org/@types/sinon/-/sinon-10.0.20.tgz", - "integrity": "sha512-2APKKruFNCAZgx3daAyACGzWuJ028VVCUDk6o2rw/Z4PXT0ogwdV4KUegW0MwVs0Zu59auPXbbuBJHF12Sx1Eg==", + "version": "17.0.4", + "resolved": "https://registry.npmjs.org/@types/sinon/-/sinon-17.0.4.tgz", + "integrity": "sha512-RHnIrhfPO3+tJT0s7cFaXGZvsL4bbR3/k7z3P312qMS4JaS2Tk+KiwiLx1S0rQ56ERj00u1/BtdyVd0FY+Pdew==", "dev": true, + "license": "MIT", "dependencies": { "@types/sinonjs__fake-timers": "*" } @@ -1081,19 +1188,22 @@ "version": "8.1.5", "resolved": "https://registry.npmjs.org/@types/sinonjs__fake-timers/-/sinonjs__fake-timers-8.1.5.tgz", "integrity": "sha512-mQkU2jY8jJEF7YHjHvsQO8+3ughTL1mcnn96igfhONmR+fUPSKIkefQYpSe8bsly2Ep7oQbn/6VG5/9/0qcArQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/stack-utils": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.3.tgz", "integrity": "sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/@types/yargs": { - "version": "17.0.32", - "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.32.tgz", - "integrity": "sha512-xQ67Yc/laOG5uMfX/093MRlGGCIBzZMarVa+gfNKJxWAIgykYpVGkBdbqEzGDDfCrVUj6Hiff4mTZ5BA6TmAog==", + "version": "17.0.33", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz", + "integrity": "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==", "dev": true, + "license": "MIT", "dependencies": { "@types/yargs-parser": "*" } @@ -1102,13 +1212,15 @@ "version": "21.0.3", "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz", "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/acorn": { - "version": "8.12.1", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.12.1.tgz", - "integrity": "sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==", + "version": "8.14.1", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.1.tgz", + "integrity": "sha512-OvQ/2pUDKmgfCg++xsTX1wGxfTaszcHVcTctW4UJB4hibJx2HXxxO5UmVgyjMa+ZDsiaf5wWLXYpRWMmBI0QHg==", "dev": true, + "license": "MIT", "bin": { "acorn": "bin/acorn" }, @@ -1117,10 +1229,11 @@ } }, "node_modules/acorn-walk": { - "version": "8.3.3", - "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.3.tgz", - "integrity": "sha512-MxXdReSRhGO7VlFe1bRG/oI7/mdLV9B9JJT0N8vZOhF7gFRR5l3M8W9G8JxmKV+JC5mGqJ0QvqfSOLsCPa4nUw==", + "version": "8.3.4", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz", + "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==", "dev": true, + "license": "MIT", "dependencies": { "acorn": "^8.11.0" }, @@ -1132,13 +1245,15 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/add-stream/-/add-stream-1.0.0.tgz", "integrity": "sha512-qQLMr+8o0WC4FZGQTcJiKBVC59JylcPSrTtk6usvmIDFUOCKegapy1VHQwRbFMOFyb/inzUVqHs+eMYKDM1YeQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/ansi-escapes": { "version": "4.3.2", "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==", "dev": true, + "license": "MIT", "dependencies": { "type-fest": "^0.21.3" }, @@ -1154,6 +1269,7 @@ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1163,6 +1279,7 @@ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", "dev": true, + "license": "MIT", "dependencies": { "color-convert": "^2.0.1" }, @@ -1178,6 +1295,7 @@ "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", "dev": true, + "license": "ISC", "dependencies": { "normalize-path": "^3.0.0", "picomatch": "^2.0.4" @@ -1190,13 +1308,15 @@ "version": "4.1.3", "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz", "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/argparse": { "version": "1.0.10", "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", "dev": true, + "license": "MIT", "dependencies": { "sprintf-js": "~1.0.2" } @@ -1205,13 +1325,15 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/array-ify/-/array-ify-1.0.0.tgz", "integrity": "sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/arrify": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz", "integrity": "sha512-3CYzex9M9FGQjCGMGyi6/31c8GJbgb0qGyrx5HWxPd0aCwh4cB2YjMb2Xf9UuoogrMrlO9cTqnB5rI5GHZTcUA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1221,21 +1343,24 @@ "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz", "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==", "dev": true, + "license": "MIT", "engines": { "node": "*" } }, "node_modules/async": { - "version": "3.2.5", - "resolved": "https://registry.npmjs.org/async/-/async-3.2.5.tgz", - "integrity": "sha512-baNZyqaaLhyLVKm/DlvdW051MSgO6b8eVfIezl9E5PqWxFgzLm/wQntEW4zOytVburDEr0JlALEpdOFwvErLsg==", - "dev": true + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" }, "node_modules/babel-jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz", "integrity": "sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/transform": "^29.7.0", "@types/babel__core": "^7.1.14", @@ -1257,6 +1382,7 @@ "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz", "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@babel/helper-plugin-utils": "^7.0.0", "@istanbuljs/load-nyc-config": "^1.0.0", @@ -1273,6 +1399,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz", "integrity": "sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@babel/core": "^7.12.3", "@babel/parser": "^7.14.7", @@ -1289,6 +1416,7 @@ "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz", "integrity": "sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/template": "^7.3.3", "@babel/types": "^7.3.3", @@ -1300,23 +1428,27 @@ } }, "node_modules/babel-preset-current-node-syntax": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.0.1.tgz", - "integrity": "sha512-M7LQ0bxarkxQoN+vz5aJPsLBn77n8QgTFmo8WK0/44auK2xlCXrYcUxHFxgU7qW5Yzw/CjmLRK2uJzaCd7LvqQ==", + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.1.0.tgz", + "integrity": "sha512-ldYss8SbBlWva1bs28q78Ju5Zq1F+8BrqBZZ0VFhLBvhh6lCpC2o3gDJi/5DRLs9FgYZCnmPYIVFU4lRXCkyUw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/plugin-syntax-async-generators": "^7.8.4", "@babel/plugin-syntax-bigint": "^7.8.3", - "@babel/plugin-syntax-class-properties": "^7.8.3", - "@babel/plugin-syntax-import-meta": "^7.8.3", + "@babel/plugin-syntax-class-properties": "^7.12.13", + "@babel/plugin-syntax-class-static-block": "^7.14.5", + "@babel/plugin-syntax-import-attributes": "^7.24.7", + "@babel/plugin-syntax-import-meta": "^7.10.4", "@babel/plugin-syntax-json-strings": "^7.8.3", - "@babel/plugin-syntax-logical-assignment-operators": "^7.8.3", + "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4", "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3", - "@babel/plugin-syntax-numeric-separator": "^7.8.3", + "@babel/plugin-syntax-numeric-separator": "^7.10.4", "@babel/plugin-syntax-object-rest-spread": "^7.8.3", "@babel/plugin-syntax-optional-catch-binding": "^7.8.3", "@babel/plugin-syntax-optional-chaining": "^7.8.3", - "@babel/plugin-syntax-top-level-await": "^7.8.3" + "@babel/plugin-syntax-private-property-in-object": "^7.14.5", + "@babel/plugin-syntax-top-level-await": "^7.14.5" }, "peerDependencies": { "@babel/core": "^7.0.0" @@ -1327,6 +1459,7 @@ "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz", "integrity": "sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==", "dev": true, + "license": "MIT", "dependencies": { "babel-plugin-jest-hoist": "^29.6.3", "babel-preset-current-node-syntax": "^1.0.0" @@ -1342,13 +1475,70 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true + }, + "node_modules/better-sqlite3": { + "version": "11.9.1", + "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.9.1.tgz", + "integrity": "sha512-Ba0KR+Fzxh2jDRhdg6TSH0SJGzb8C0aBY4hR8w8madIdIzzC6Y1+kx5qR6eS1Z+Gy20h6ZU28aeyg0z1VIrShQ==", + "hasInstallScript": true, + "license": "MIT", + "peer": true, + "dependencies": { + "bindings": "^1.5.0", + "prebuild-install": "^7.1.1" + } + }, + "node_modules/bindings": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", + "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "file-uri-to-path": "1.0.0" + } + }, + "node_modules/bl": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", + "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", + "license": "MIT", + "peer": true, + "dependencies": { + "buffer": "^5.5.0", + "inherits": "^2.0.4", + "readable-stream": "^3.4.0" + } }, "node_modules/brace-expansion": { "version": "1.1.11", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", "dev": true, + "license": "MIT", "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" @@ -1359,6 +1549,7 @@ "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", "dev": true, + "license": "MIT", "dependencies": { "fill-range": "^7.1.1" }, @@ -1367,9 +1558,9 @@ } }, "node_modules/browserslist": { - "version": "4.23.3", - "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.23.3.tgz", - "integrity": "sha512-btwCFJVjI4YWDNfau8RhZ+B1Q/VLoUITrm3RlP6y1tYGWIOa+InuYiRGXUBXo8nA1qKmHMyLB/iVQg5TT4eFoA==", + "version": "4.24.4", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.4.tgz", + "integrity": "sha512-KDi1Ny1gSePi1vm0q4oxSF8b4DR44GF4BbmS2YdhPLOEqd8pDviZOGH/GsmRwoWJ2+5Lr085X7naowMwKHDG1A==", "dev": true, "funding": [ { @@ -1385,11 +1576,12 @@ "url": "https://github.com/sponsors/ai" } ], + "license": "MIT", "dependencies": { - "caniuse-lite": "^1.0.30001646", - "electron-to-chromium": "^1.5.4", - "node-releases": "^2.0.18", - "update-browserslist-db": "^1.1.0" + "caniuse-lite": "^1.0.30001688", + "electron-to-chromium": "^1.5.73", + "node-releases": "^2.0.19", + "update-browserslist-db": "^1.1.1" }, "bin": { "browserslist": "cli.js" @@ -1403,6 +1595,7 @@ "resolved": "https://registry.npmjs.org/bs-logger/-/bs-logger-0.2.6.tgz", "integrity": "sha512-pd8DCoxmbgc7hyPKOvxtqNcjYoOsABPQdcCUjGp3d42VR2CX1ORhk2A87oqqu5R1kk+76nsxZupkmyd+MVtCog==", "dev": true, + "license": "MIT", "dependencies": { "fast-json-stable-stringify": "2.x" }, @@ -1415,21 +1608,49 @@ "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz", "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==", "dev": true, + "license": "Apache-2.0", "dependencies": { "node-int64": "^0.4.0" } }, + "node_modules/buffer": { + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", + "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.1.13" + } + }, "node_modules/buffer-from": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/callsites": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -1439,6 +1660,7 @@ "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz", "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -1448,6 +1670,7 @@ "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-6.2.2.tgz", "integrity": "sha512-YrwaA0vEKazPBkn0ipTiMpSajYDSe+KjQfrjhcBMxJt/znbvlHd8Pw/Vamaz5EB4Wfhs3SUR3Z9mwRu/P3s3Yg==", "dev": true, + "license": "MIT", "dependencies": { "camelcase": "^5.3.1", "map-obj": "^4.0.0", @@ -1461,9 +1684,9 @@ } }, "node_modules/caniuse-lite": { - "version": "1.0.30001646", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001646.tgz", - "integrity": "sha512-dRg00gudiBDDTmUhClSdv3hqRfpbOnU28IpI1T6PBTLWa+kOj0681C8uML3PifYfREuBrVjDGhL3adYpBT6spw==", + "version": "1.0.30001706", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001706.tgz", + "integrity": "sha512-3ZczoTApMAZwPKYWmwVbQMFpXBDds3/0VciVoUwPUbldlYyVLmRVuRs/PcUZtHpbLRpzzDvrvnFuREsGt6lUug==", "dev": true, "funding": [ { @@ -1478,13 +1701,15 @@ "type": "github", "url": "https://github.com/sponsors/ai" } - ] + ], + "license": "CC-BY-4.0" }, "node_modules/chai": { "version": "4.5.0", "resolved": "https://registry.npmjs.org/chai/-/chai-4.5.0.tgz", "integrity": "sha512-RITGBfijLkBddZvnn8jdqoTypxvqbOLYQkGGxXzeFjVHvudaPw0HNFD9x928/eUwYWd2dPCugVqspGALTZZQKw==", "dev": true, + "license": "MIT", "dependencies": { "assertion-error": "^1.1.0", "check-error": "^1.0.3", @@ -1503,6 +1728,7 @@ "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -1519,15 +1745,27 @@ "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz", "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" } }, + "node_modules/charenc": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz", + "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==", + "license": "BSD-3-Clause", + "peer": true, + "engines": { + "node": "*" + } + }, "node_modules/check-error": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.3.tgz", "integrity": "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg==", "dev": true, + "license": "MIT", "dependencies": { "get-func-name": "^2.0.2" }, @@ -1535,6 +1773,13 @@ "node": "*" } }, + "node_modules/chownr": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", + "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", + "license": "ISC", + "peer": true + }, "node_modules/ci-info": { "version": "3.9.0", "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz", @@ -1546,21 +1791,24 @@ "url": "https://github.com/sponsors/sibiraj-s" } ], + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/cjs-module-lexer": { - "version": "1.3.1", - "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.3.1.tgz", - "integrity": "sha512-a3KdPAANPbNE4ZUv9h6LckSl9zLsYOP4MBmhIPkRaeyybt+r4UghLvq+xw/YwUcC1gqylCkL4rdVs3Lwupjm4Q==", - "dev": true + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.3.tgz", + "integrity": "sha512-9z8TZaGM1pfswYeXrUpzPrkx8UnWYdhJclsiYMm6x/w5+nN+8Tf/LnAgfLGQCm59qAOxU8WwHEq2vNwF6i4j+Q==", + "dev": true, + "license": "MIT" }, "node_modules/cliui": { "version": "7.0.4", "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz", "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==", "dev": true, + "license": "ISC", "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.0", @@ -1572,6 +1820,7 @@ "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz", "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==", "dev": true, + "license": "MIT", "engines": { "iojs": ">= 1.0.0", "node": ">= 0.12.0" @@ -1581,13 +1830,15 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz", "integrity": "sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/color-convert": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", "dev": true, + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -1599,13 +1850,15 @@ "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/compare-func": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz", "integrity": "sha512-zHig5N+tPWARooBnb0Zx1MFcdfpyJrfTJ3Y5L+IFvUm8rM74hHz66z0gw0x4tijh5CorKkKUCnW82R2vmpeCRA==", "dev": true, + "license": "MIT", "dependencies": { "array-ify": "^1.0.0", "dot-prop": "^5.1.0" @@ -1615,13 +1868,15 @@ "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/conventional-changelog": { "version": "3.1.25", "resolved": "https://registry.npmjs.org/conventional-changelog/-/conventional-changelog-3.1.25.tgz", "integrity": "sha512-ryhi3fd1mKf3fSjbLXOfK2D06YwKNic1nC9mWqybBHdObPd8KJ2vjaXZfYj1U23t+V8T8n0d7gwnc9XbIdFbyQ==", "dev": true, + "license": "MIT", "dependencies": { "conventional-changelog-angular": "^5.0.12", "conventional-changelog-atom": "^2.0.8", @@ -1644,6 +1899,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-5.0.13.tgz", "integrity": "sha512-i/gipMxs7s8L/QeuavPF2hLnJgH6pEZAttySB6aiQLWcX3puWDL3ACVmvBhJGxnAy52Qc15ua26BufY6KpmrVA==", "dev": true, + "license": "ISC", "dependencies": { "compare-func": "^2.0.0", "q": "^1.5.1" @@ -1657,6 +1913,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-atom/-/conventional-changelog-atom-2.0.8.tgz", "integrity": "sha512-xo6v46icsFTK3bb7dY/8m2qvc8sZemRgdqLb/bjpBsH2UyOS8rKNTgcb5025Hri6IpANPApbXMg15QLb1LJpBw==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1669,6 +1926,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-codemirror/-/conventional-changelog-codemirror-2.0.8.tgz", "integrity": "sha512-z5DAsn3uj1Vfp7po3gpt2Boc+Bdwmw2++ZHa5Ak9k0UKsYAO5mH1UBTN0qSCuJZREIhX6WU4E1p3IW2oRCNzQw==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1681,6 +1939,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-conventionalcommits/-/conventional-changelog-conventionalcommits-4.6.3.tgz", "integrity": "sha512-LTTQV4fwOM4oLPad317V/QNQ1FY4Hju5qeBIM1uTHbrnCE+Eg4CdRZ3gO2pUeR+tzWdp80M2j3qFFEDWVqOV4g==", "dev": true, + "license": "ISC", "dependencies": { "compare-func": "^2.0.0", "lodash": "^4.17.15", @@ -1695,6 +1954,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-core/-/conventional-changelog-core-4.2.4.tgz", "integrity": "sha512-gDVS+zVJHE2v4SLc6B0sLsPiloR0ygU7HaDW14aNJE1v4SlqJPILPl/aJC7YdtRE4CybBf8gDwObBvKha8Xlyg==", "dev": true, + "license": "MIT", "dependencies": { "add-stream": "^1.0.0", "conventional-changelog-writer": "^5.0.0", @@ -1720,6 +1980,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-ember/-/conventional-changelog-ember-2.0.9.tgz", "integrity": "sha512-ulzIReoZEvZCBDhcNYfDIsLTHzYHc7awh+eI44ZtV5cx6LVxLlVtEmcO+2/kGIHGtw+qVabJYjdI5cJOQgXh1A==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1732,6 +1993,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-eslint/-/conventional-changelog-eslint-3.0.9.tgz", "integrity": "sha512-6NpUCMgU8qmWmyAMSZO5NrRd7rTgErjrm4VASam2u5jrZS0n38V7Y9CzTtLT2qwz5xEChDR4BduoWIr8TfwvXA==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1744,6 +2006,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-express/-/conventional-changelog-express-2.0.6.tgz", "integrity": "sha512-SDez2f3iVJw6V563O3pRtNwXtQaSmEfTCaTBPCqn0oG0mfkq0rX4hHBq5P7De2MncoRixrALj3u3oQsNK+Q0pQ==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1756,6 +2019,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-jquery/-/conventional-changelog-jquery-3.0.11.tgz", "integrity": "sha512-x8AWz5/Td55F7+o/9LQ6cQIPwrCjfJQ5Zmfqi8thwUEKHstEn4kTIofXub7plf1xvFA2TqhZlq7fy5OmV6BOMw==", "dev": true, + "license": "ISC", "dependencies": { "q": "^1.5.1" }, @@ -1768,6 +2032,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-jshint/-/conventional-changelog-jshint-2.0.9.tgz", "integrity": "sha512-wMLdaIzq6TNnMHMy31hql02OEQ8nCQfExw1SE0hYL5KvU+JCTuPaDO+7JiogGT2gJAxiUGATdtYYfh+nT+6riA==", "dev": true, + "license": "ISC", "dependencies": { "compare-func": "^2.0.0", "q": "^1.5.1" @@ -1781,6 +2046,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-preset-loader/-/conventional-changelog-preset-loader-2.3.4.tgz", "integrity": "sha512-GEKRWkrSAZeTq5+YjUZOYxdHq+ci4dNwHvpaBC3+ENalzFWuCWa9EZXSuZBpkr72sMdKB+1fyDV4takK1Lf58g==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" } @@ -1790,6 +2056,7 @@ "resolved": "https://registry.npmjs.org/conventional-changelog-writer/-/conventional-changelog-writer-5.0.1.tgz", "integrity": "sha512-5WsuKUfxW7suLblAbFnxAcrvf6r+0b7GvNaWUwUIk0bXMnENP/PEieGKVUQrjPqwPT4o3EPAASBXiY6iHooLOQ==", "dev": true, + "license": "MIT", "dependencies": { "conventional-commits-filter": "^2.0.7", "dateformat": "^3.0.0", @@ -1813,6 +2080,7 @@ "resolved": "https://registry.npmjs.org/conventional-commits-filter/-/conventional-commits-filter-2.0.7.tgz", "integrity": "sha512-ASS9SamOP4TbCClsRHxIHXRfcGCnIoQqkvAzCSbZzTFLfcTqJVugB0agRgsEELsqaeWgsXv513eS116wnlSSPA==", "dev": true, + "license": "MIT", "dependencies": { "lodash.ismatch": "^4.4.0", "modify-values": "^1.0.0" @@ -1826,6 +2094,7 @@ "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-3.2.4.tgz", "integrity": "sha512-nK7sAtfi+QXbxHCYfhpZsfRtaitZLIA6889kFIouLvz6repszQDgxBu7wf2WbU+Dco7sAnNCJYERCwt54WPC2Q==", "dev": true, + "license": "MIT", "dependencies": { "is-text-path": "^1.0.1", "JSONStream": "^1.0.4", @@ -1845,19 +2114,22 @@ "version": "2.0.0", "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/core-util-is": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz", - "integrity": "sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==", - "dev": true + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz", + "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==", + "dev": true, + "license": "MIT" }, "node_modules/create-jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz", "integrity": "sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "chalk": "^4.0.0", @@ -1878,7 +2150,8 @@ "version": "1.1.1", "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz", "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/cross-spawn": { "version": "7.0.6", @@ -1895,11 +2168,22 @@ "node": ">= 8" } }, + "node_modules/crypt": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz", + "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==", + "license": "BSD-3-Clause", + "peer": true, + "engines": { + "node": "*" + } + }, "node_modules/dargs": { "version": "7.0.0", "resolved": "https://registry.npmjs.org/dargs/-/dargs-7.0.0.tgz", "integrity": "sha512-2iy1EkLdlBzQGvbweYRFxmFath8+K7+AKB0TlhHWkNuH+TmovaMH/Wp7V7R4u7f4SnX3OgLsU9t1NI9ioDnUpg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1909,17 +2193,19 @@ "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-3.0.3.tgz", "integrity": "sha512-jyCETtSl3VMZMWeRo7iY1FL19ges1t55hMo5yaam4Jrsm5EPL89UQkoQRyiI+Yf4k8r2ZpdngkV8hr1lIdjb3Q==", "dev": true, + "license": "MIT", "engines": { "node": "*" } }, "node_modules/debug": { - "version": "4.3.6", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.6.tgz", - "integrity": "sha512-O/09Bd4Z1fBrU4VzkhFqVgpPzaGbw6Sm9FEkBT1A/YBXQFGuuSxa1dN2nxgxS34JmKXqYx8CZAwEVoJFImUXIg==", + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", "dev": true, + "license": "MIT", "dependencies": { - "ms": "2.1.2" + "ms": "^2.1.3" }, "engines": { "node": ">=6.0" @@ -1935,6 +2221,7 @@ "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz", "integrity": "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1944,6 +2231,7 @@ "resolved": "https://registry.npmjs.org/decamelize-keys/-/decamelize-keys-1.1.1.tgz", "integrity": "sha512-WiPxgEirIV0/eIOMcnFBA3/IJZAZqKnwAwWyvvdi4lsr1WCN22nhdf/3db3DoZcUjTV2SqfzIwNyp6y2xs3nmg==", "dev": true, + "license": "MIT", "dependencies": { "decamelize": "^1.1.0", "map-obj": "^1.0.0" @@ -1960,15 +2248,33 @@ "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz", "integrity": "sha512-7N/q3lyZ+LVCp7PzuxrJr4KMbBE2hW7BT7YNia330OFxIf4d3r5zVpicP2650l7CPN6RM9zOJRl3NGpqSiw3Eg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } }, + "node_modules/decompress-response": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", + "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "mimic-response": "^3.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/dedent": { "version": "1.5.3", "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.5.3.tgz", "integrity": "sha512-NHQtfOOW68WD8lgypbLA5oT+Bt0xXJhiYvoR6SmmNXZfpzOGXwdKWmcwG8N7PwVVWV3eF/68nmD9BaJSsTBhyQ==", "dev": true, + "license": "MIT", "peerDependencies": { "babel-plugin-macros": "^3.1.0" }, @@ -1983,6 +2289,7 @@ "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-4.1.4.tgz", "integrity": "sha512-SUwdGfqdKOwxCPeVYjwSyRpJ7Z+fhpwIAtmCUdZIWZ/YP5R9WAsyuSgpLVDi9bjWoN2LXHNss/dk3urXtdQxGg==", "dev": true, + "license": "MIT", "dependencies": { "type-detect": "^4.0.0" }, @@ -1990,20 +2297,42 @@ "node": ">=6" } }, + "node_modules/deep-extend": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", + "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=4.0.0" + } + }, "node_modules/deepmerge": { "version": "4.3.1", "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } }, + "node_modules/detect-libc": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.3.tgz", + "integrity": "sha512-bwy0MGW55bG41VqxxypOsdSdGqLwXPI/focwgTYCFMbdUiBAxLg9CFzG08sz2aqzknwiX7Hkl0bQENjg8iLByw==", + "license": "Apache-2.0", + "peer": true, + "engines": { + "node": ">=8" + } + }, "node_modules/detect-newline": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz", "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2011,13 +2340,15 @@ "node_modules/di0": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/di0/-/di0-1.0.0.tgz", - "integrity": "sha512-RRZsfbOmxiB0ZI+4ABfw/O7GUOnqmgFJGEPFzj7IX+mpm73Hkd38akjaTagaFmwzzRAqIIVR3uB3zSzwnt8ZFw==" + "integrity": "sha512-RRZsfbOmxiB0ZI+4ABfw/O7GUOnqmgFJGEPFzj7IX+mpm73Hkd38akjaTagaFmwzzRAqIIVR3uB3zSzwnt8ZFw==", + "license": "MIT" }, "node_modules/diff": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.0.tgz", - "integrity": "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A==", + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/diff/-/diff-7.0.0.tgz", + "integrity": "sha512-PJWHUb1RFevKCwaFA9RlG5tCd+FO5iRh9A8HEtkmBH2Li03iJriB6m6JIN4rGz3K3JLawI7/veA1xzRKP6ISBw==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.3.1" } @@ -2027,6 +2358,7 @@ "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==", "dev": true, + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -2036,6 +2368,7 @@ "resolved": "https://registry.npmjs.org/dot-prop/-/dot-prop-5.3.0.tgz", "integrity": "sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==", "dev": true, + "license": "MIT", "dependencies": { "is-obj": "^2.0.0" }, @@ -2048,6 +2381,7 @@ "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "jake": "^10.8.5" }, @@ -2059,16 +2393,18 @@ } }, "node_modules/electron-to-chromium": { - "version": "1.5.4", - "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.4.tgz", - "integrity": "sha512-orzA81VqLyIGUEA77YkVA1D+N+nNfl2isJVjjmOyrlxuooZ19ynb+dOlaDTqd/idKRS9lDCSBmtzM+kyCsMnkA==", - "dev": true + "version": "1.5.123", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.123.tgz", + "integrity": "sha512-refir3NlutEZqlKaBLK0tzlVLe5P2wDKS7UQt/3SpibizgsRAPOsqQC3ffw1nlv3ze5gjRQZYHoPymgVZkplFA==", + "dev": true, + "license": "ISC" }, "node_modules/emittery": { "version": "0.13.1", "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.13.1.tgz", "integrity": "sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=12" }, @@ -2080,22 +2416,35 @@ "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/end-of-stream": { + "version": "1.4.4", + "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.4.tgz", + "integrity": "sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==", + "license": "MIT", + "peer": true, + "dependencies": { + "once": "^1.4.0" + } }, "node_modules/error-ex": { "version": "1.3.2", "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz", "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==", "dev": true, + "license": "MIT", "dependencies": { "is-arrayish": "^0.2.1" } }, "node_modules/escalade": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.2.tgz", - "integrity": "sha512-ErCHMCae19vR8vQGe50xIsVomy19rg6gFu3+r3jkEO46suLMWBksvVyoGgQV+jOfl84ZSOSlmv6Gxa89PmTGmA==", + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -2105,6 +2454,7 @@ "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2114,6 +2464,7 @@ "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", "dev": true, + "license": "BSD-2-Clause", "bin": { "esparse": "bin/esparse.js", "esvalidate": "bin/esvalidate.js" @@ -2127,6 +2478,7 @@ "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", "dev": true, + "license": "MIT", "dependencies": { "cross-spawn": "^7.0.3", "get-stream": "^6.0.0", @@ -2154,11 +2506,22 @@ "node": ">= 0.8.0" } }, + "node_modules/expand-template": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", + "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", + "license": "(MIT OR WTFPL)", + "peer": true, + "engines": { + "node": ">=6" + } + }, "node_modules/expect": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/expect/-/expect-29.7.0.tgz", "integrity": "sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/expect-utils": "^29.7.0", "jest-get-type": "^29.6.3", @@ -2174,22 +2537,32 @@ "version": "2.1.0", "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/fb-watchman": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz", "integrity": "sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "bser": "2.1.1" } }, + "node_modules/file-uri-to-path": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", + "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==", + "license": "MIT", + "peer": true + }, "node_modules/filelist": { "version": "1.0.4", "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", "dev": true, + "license": "Apache-2.0", "dependencies": { "minimatch": "^5.0.1" } @@ -2199,6 +2572,7 @@ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", "dev": true, + "license": "MIT", "dependencies": { "balanced-match": "^1.0.0" } @@ -2208,6 +2582,7 @@ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==", "dev": true, + "license": "ISC", "dependencies": { "brace-expansion": "^2.0.1" }, @@ -2220,6 +2595,7 @@ "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", "dev": true, + "license": "MIT", "dependencies": { "to-regex-range": "^5.0.1" }, @@ -2232,6 +2608,7 @@ "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", "dev": true, + "license": "MIT", "dependencies": { "locate-path": "^5.0.0", "path-exists": "^4.0.0" @@ -2240,11 +2617,19 @@ "node": ">=8" } }, + "node_modules/fs-constants": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", + "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", + "license": "MIT", + "peer": true + }, "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/fsevents": { "version": "2.3.3", @@ -2252,6 +2637,7 @@ "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", "dev": true, "hasInstallScript": true, + "license": "MIT", "optional": true, "os": [ "darwin" @@ -2265,6 +2651,7 @@ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", "dev": true, + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -2274,6 +2661,7 @@ "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -2283,6 +2671,7 @@ "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", "dev": true, + "license": "ISC", "engines": { "node": "6.* || 8.* || >= 10.*" } @@ -2292,6 +2681,7 @@ "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.2.tgz", "integrity": "sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ==", "dev": true, + "license": "MIT", "engines": { "node": "*" } @@ -2301,6 +2691,7 @@ "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz", "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8.0.0" } @@ -2310,6 +2701,7 @@ "resolved": "https://registry.npmjs.org/get-pkg-repo/-/get-pkg-repo-4.2.1.tgz", "integrity": "sha512-2+QbHjFRfGB74v/pYWjd5OhU3TDIC2Gv/YKUTk/tCvAz0pkn/Mz6P3uByuBimLOcPvN2jYdScl3xGFSrx0jEcA==", "dev": true, + "license": "MIT", "dependencies": { "@hutson/parse-repository-url": "^3.0.0", "hosted-git-info": "^4.0.0", @@ -2328,6 +2720,7 @@ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz", "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==", "dev": true, + "license": "MIT", "dependencies": { "core-util-is": "~1.0.0", "inherits": "~2.0.3", @@ -2342,13 +2735,15 @@ "version": "5.1.2", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/get-pkg-repo/node_modules/string_decoder": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz", "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==", "dev": true, + "license": "MIT", "dependencies": { "safe-buffer": "~5.1.0" } @@ -2358,6 +2753,7 @@ "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.5.tgz", "integrity": "sha512-/mrRod8xqpA+IHSLyGCQ2s8SPHiCDEeQJSep1jqLYeEUClOFG2Qsh+4FU6G9VeqpZnGW/Su8LQGc4YKni5rYSQ==", "dev": true, + "license": "MIT", "dependencies": { "readable-stream": "~2.3.6", "xtend": "~4.0.1" @@ -2368,6 +2764,7 @@ "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -2380,6 +2777,7 @@ "resolved": "https://registry.npmjs.org/git-raw-commits/-/git-raw-commits-2.0.11.tgz", "integrity": "sha512-VnctFhw+xfj8Va1xtfEqCUD2XDrbAPSJx+hSrE5K7fGdjZruW7XV+QOrN7LF/RJyvspRiD2I0asWsxFp0ya26A==", "dev": true, + "license": "MIT", "dependencies": { "dargs": "^7.0.0", "lodash": "^4.17.15", @@ -2399,6 +2797,7 @@ "resolved": "https://registry.npmjs.org/git-remote-origin-url/-/git-remote-origin-url-2.0.0.tgz", "integrity": "sha512-eU+GGrZgccNJcsDH5LkXR3PB9M958hxc7sbA8DFJjrv9j4L2P/eZfKhM+QD6wyzpiv+b1BpK0XrYCxkovtjSLw==", "dev": true, + "license": "MIT", "dependencies": { "gitconfiglocal": "^1.0.0", "pify": "^2.3.0" @@ -2412,6 +2811,7 @@ "resolved": "https://registry.npmjs.org/git-semver-tags/-/git-semver-tags-4.1.1.tgz", "integrity": "sha512-OWyMt5zBe7xFs8vglMmhM9lRQzCWL3WjHtxNNfJTMngGym7pC1kh8sP6jevfydJ6LP3ZvGxfb6ABYgPUM0mtsA==", "dev": true, + "license": "MIT", "dependencies": { "meow": "^8.0.0", "semver": "^6.0.0" @@ -2428,16 +2828,25 @@ "resolved": "https://registry.npmjs.org/gitconfiglocal/-/gitconfiglocal-1.0.0.tgz", "integrity": "sha512-spLUXeTAVHxDtKsJc8FkFVgFtMdEN9qPGpL23VfSHx4fP4+Ds097IXLvymbnDH8FnmxX5Nr9bPw3A+AQ6mWEaQ==", "dev": true, + "license": "BSD", "dependencies": { "ini": "^1.3.2" } }, + "node_modules/github-from-package": { + "version": "0.0.0", + "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", + "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", + "license": "MIT", + "peer": true + }, "node_modules/glob": { "version": "7.2.3", "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", "deprecated": "Glob versions prior to v9 are no longer supported", "dev": true, + "license": "ISC", "dependencies": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", @@ -2458,6 +2867,7 @@ "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -2466,13 +2876,15 @@ "version": "4.2.11", "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/handlebars": { "version": "4.7.8", "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==", "dev": true, + "license": "MIT", "dependencies": { "minimist": "^1.2.5", "neo-async": "^2.6.2", @@ -2494,6 +2906,7 @@ "resolved": "https://registry.npmjs.org/hard-rejection/-/hard-rejection-2.1.0.tgz", "integrity": "sha512-VIZB+ibDhx7ObhAe7OVtoEbuP4h/MuOTHJ+J8h/eBXotJYl0fBgR72xDFCKgIh22OJZIOVNxBMWuhAr10r8HdA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -2503,6 +2916,7 @@ "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2512,6 +2926,7 @@ "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", "dev": true, + "license": "MIT", "dependencies": { "function-bind": "^1.1.2" }, @@ -2524,6 +2939,7 @@ "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-4.1.0.tgz", "integrity": "sha512-kyCuEOWjJqZuDbRHzL8V93NzQhwIB71oFWSyzVo+KPZI+pnQPPxucdkrOZvkLRnrf5URsQM+IJ09Dw29cRALIA==", "dev": true, + "license": "ISC", "dependencies": { "lru-cache": "^6.0.0" }, @@ -2535,22 +2951,46 @@ "version": "2.0.2", "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz", "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/human-signals": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", "dev": true, + "license": "Apache-2.0", "engines": { "node": ">=10.17.0" } }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause", + "peer": true + }, "node_modules/import-local": { "version": "3.2.0", "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz", "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==", "dev": true, + "license": "MIT", "dependencies": { "pkg-dir": "^4.2.0", "resolve-cwd": "^3.0.0" @@ -2570,6 +3010,7 @@ "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.8.19" } @@ -2579,6 +3020,7 @@ "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz", "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2589,6 +3031,7 @@ "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", "dev": true, + "license": "ISC", "dependencies": { "once": "^1.3.0", "wrappy": "1" @@ -2598,25 +3041,34 @@ "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", - "dev": true + "license": "ISC" }, "node_modules/ini": { "version": "1.3.8", "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", - "dev": true + "license": "ISC" }, "node_modules/is-arrayish": { "version": "0.2.1", "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/is-buffer": { + "version": "1.1.6", + "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", + "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==", + "license": "MIT", + "peer": true }, "node_modules/is-core-module": { - "version": "2.15.0", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.15.0.tgz", - "integrity": "sha512-Dd+Lb2/zvk9SKy1TGCt1wFJFo/MWBPMX5x7KcvLajWTGuomczdQX61PvY5yK6SVACwpoexWo81IfFyoKY2QnTA==", + "version": "2.16.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", + "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", "dev": true, + "license": "MIT", "dependencies": { "hasown": "^2.0.2" }, @@ -2632,6 +3084,7 @@ "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2641,6 +3094,7 @@ "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz", "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -2650,6 +3104,7 @@ "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.12.0" } @@ -2659,6 +3114,7 @@ "resolved": "https://registry.npmjs.org/is-obj/-/is-obj-2.0.0.tgz", "integrity": "sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -2668,6 +3124,7 @@ "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz", "integrity": "sha512-yvkRyxmFKEOQ4pNXCmJG5AEQNlXJS5LaONXo5/cLdTZdWvsZ1ioJEonLGAosKlMWE8lwUy/bJzMjcw8az73+Fg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -2677,6 +3134,7 @@ "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz", "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" }, @@ -2689,6 +3147,7 @@ "resolved": "https://registry.npmjs.org/is-text-path/-/is-text-path-1.0.1.tgz", "integrity": "sha512-xFuJpne9oFz5qDaodwmmG08e3CawH/2ZV8Qqza1Ko7Sk8POWbkRdwIoAWVhqvq0XeUzANEhKo2n0IXUGBm7A/w==", "dev": true, + "license": "MIT", "dependencies": { "text-extensions": "^1.0.0" }, @@ -2700,19 +3159,22 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz", "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/isexe": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/istanbul-lib-coverage": { "version": "3.2.2", "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=8" } @@ -2722,6 +3184,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz", "integrity": "sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "@babel/core": "^7.23.9", "@babel/parser": "^7.23.9", @@ -2734,10 +3197,11 @@ } }, "node_modules/istanbul-lib-instrument/node_modules/semver": { - "version": "7.6.3", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", - "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -2750,6 +3214,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz", "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "istanbul-lib-coverage": "^3.0.0", "make-dir": "^4.0.0", @@ -2764,6 +3229,7 @@ "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz", "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "debug": "^4.1.1", "istanbul-lib-coverage": "^3.0.0", @@ -2778,6 +3244,7 @@ "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.1.7.tgz", "integrity": "sha512-BewmUXImeuRk2YY0PVbxgKAysvhRPUQE0h5QRM++nVWyubKGV0l8qQ5op8+B2DOmwSe63Jivj0BjkPQVf8fP5g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "html-escaper": "^2.0.0", "istanbul-lib-report": "^3.0.0" @@ -2791,6 +3258,7 @@ "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.2.tgz", "integrity": "sha512-2P4SQ0HrLQ+fw6llpLnOaGAvN2Zu6778SJMrCUwns4fOoG9ayrTiZk3VV8sCPkVZF8ab0zksVpS8FDY5pRCNBA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "async": "^3.2.3", "chalk": "^4.0.2", @@ -2809,6 +3277,7 @@ "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz", "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/core": "^29.7.0", "@jest/types": "^29.6.3", @@ -2835,6 +3304,7 @@ "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-29.7.0.tgz", "integrity": "sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==", "dev": true, + "license": "MIT", "dependencies": { "execa": "^5.0.0", "jest-util": "^29.7.0", @@ -2849,6 +3319,7 @@ "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-29.7.0.tgz", "integrity": "sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/expect": "^29.7.0", @@ -2880,6 +3351,7 @@ "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-29.7.0.tgz", "integrity": "sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==", "dev": true, + "license": "MIT", "dependencies": { "@jest/core": "^29.7.0", "@jest/test-result": "^29.7.0", @@ -2913,6 +3385,7 @@ "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", "dev": true, + "license": "ISC", "dependencies": { "string-width": "^4.2.0", "strip-ansi": "^6.0.1", @@ -2927,6 +3400,7 @@ "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz", "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==", "dev": true, + "license": "MIT", "dependencies": { "cliui": "^8.0.1", "escalade": "^3.1.1", @@ -2945,6 +3419,7 @@ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", "dev": true, + "license": "ISC", "engines": { "node": ">=12" } @@ -2954,6 +3429,7 @@ "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-29.7.0.tgz", "integrity": "sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==", "dev": true, + "license": "MIT", "dependencies": { "@babel/core": "^7.11.6", "@jest/test-sequencer": "^29.7.0", @@ -2999,6 +3475,7 @@ "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", "dev": true, + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "diff-sequences": "^29.6.3", @@ -3014,6 +3491,7 @@ "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-29.7.0.tgz", "integrity": "sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==", "dev": true, + "license": "MIT", "dependencies": { "detect-newline": "^3.0.0" }, @@ -3026,6 +3504,7 @@ "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-29.7.0.tgz", "integrity": "sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "chalk": "^4.0.0", @@ -3042,6 +3521,7 @@ "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-29.7.0.tgz", "integrity": "sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/fake-timers": "^29.7.0", @@ -3059,6 +3539,7 @@ "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==", "dev": true, + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -3068,6 +3549,7 @@ "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-29.7.0.tgz", "integrity": "sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/graceful-fs": "^4.1.3", @@ -3093,6 +3575,7 @@ "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz", "integrity": "sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==", "dev": true, + "license": "MIT", "dependencies": { "jest-get-type": "^29.6.3", "pretty-format": "^29.7.0" @@ -3106,6 +3589,7 @@ "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", "dev": true, + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "jest-diff": "^29.7.0", @@ -3121,6 +3605,7 @@ "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-29.7.0.tgz", "integrity": "sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==", "dev": true, + "license": "MIT", "dependencies": { "@babel/code-frame": "^7.12.13", "@jest/types": "^29.6.3", @@ -3141,6 +3626,7 @@ "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-29.7.0.tgz", "integrity": "sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/node": "*", @@ -3155,6 +3641,7 @@ "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz", "integrity": "sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" }, @@ -3172,6 +3659,7 @@ "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-29.6.3.tgz", "integrity": "sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==", "dev": true, + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -3181,6 +3669,7 @@ "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-29.7.0.tgz", "integrity": "sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==", "dev": true, + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "graceful-fs": "^4.2.9", @@ -3201,6 +3690,7 @@ "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz", "integrity": "sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==", "dev": true, + "license": "MIT", "dependencies": { "jest-regex-util": "^29.6.3", "jest-snapshot": "^29.7.0" @@ -3214,6 +3704,7 @@ "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-29.7.0.tgz", "integrity": "sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/console": "^29.7.0", "@jest/environment": "^29.7.0", @@ -3246,6 +3737,7 @@ "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-29.7.0.tgz", "integrity": "sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/environment": "^29.7.0", "@jest/fake-timers": "^29.7.0", @@ -3279,6 +3771,7 @@ "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-29.7.0.tgz", "integrity": "sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==", "dev": true, + "license": "MIT", "dependencies": { "@babel/core": "^7.11.6", "@babel/generator": "^7.7.2", @@ -3306,10 +3799,11 @@ } }, "node_modules/jest-snapshot/node_modules/semver": { - "version": "7.6.3", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", - "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -3322,6 +3816,7 @@ "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz", "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "@types/node": "*", @@ -3339,6 +3834,7 @@ "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-29.7.0.tgz", "integrity": "sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==", "dev": true, + "license": "MIT", "dependencies": { "@jest/types": "^29.6.3", "camelcase": "^6.2.0", @@ -3356,6 +3852,7 @@ "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz", "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -3368,6 +3865,7 @@ "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-29.7.0.tgz", "integrity": "sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==", "dev": true, + "license": "MIT", "dependencies": { "@jest/test-result": "^29.7.0", "@jest/types": "^29.6.3", @@ -3387,6 +3885,7 @@ "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz", "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==", "dev": true, + "license": "MIT", "dependencies": { "@types/node": "*", "jest-util": "^29.7.0", @@ -3402,6 +3901,7 @@ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", "dev": true, + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -3424,6 +3924,7 @@ "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", "dev": true, + "license": "MIT", "dependencies": { "argparse": "^1.0.7", "esprima": "^4.0.0" @@ -3433,40 +3934,45 @@ } }, "node_modules/jsesc": { - "version": "2.5.2", - "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz", - "integrity": "sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==", + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz", + "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==", "dev": true, + "license": "MIT", "bin": { "jsesc": "bin/jsesc" }, "engines": { - "node": ">=4" + "node": ">=6" } }, "node_modules/json-parse-better-errors": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz", "integrity": "sha512-mrqyZKfX5EhL7hvqcV6WG1yYjnjeuYDzDhhcAAUrq8Po85NBQBJP+ZDUT75qZQ98IkUoBqdkExkukOU7Ts2wrw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/json-parse-even-better-errors": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/json-stringify-safe": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/json5": { "version": "2.2.3", "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", "dev": true, + "license": "MIT", "bin": { "json5": "lib/cli.js" }, @@ -3481,13 +3987,15 @@ "dev": true, "engines": [ "node >= 0.2.0" - ] + ], + "license": "MIT" }, "node_modules/JSONStream": { "version": "1.3.5", "resolved": "https://registry.npmjs.org/JSONStream/-/JSONStream-1.3.5.tgz", "integrity": "sha512-E+iruNOY8VV9s4JEbe1aNEm6MiszPRr/UfcHMz0TQh1BXSxHK+ASV1R6W4HpjBhSeS+54PIsAMCBmwD06LLsqQ==", "dev": true, + "license": "(MIT OR Apache-2.0)", "dependencies": { "jsonparse": "^1.2.0", "through": ">=2.2.7 <3" @@ -3503,13 +4011,15 @@ "version": "6.2.0", "resolved": "https://registry.npmjs.org/just-extend/-/just-extend-6.2.0.tgz", "integrity": "sha512-cYofQu2Xpom82S6qD778jBDpwvvy39s1l/hrYij2u9AMdQcGRpaBu6kY4mVhuno5kJVi1DAz4aiphA2WI1/OAw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/kind-of": { "version": "6.0.3", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz", "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -3519,6 +4029,7 @@ "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -3528,6 +4039,7 @@ "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -3536,13 +4048,15 @@ "version": "1.2.4", "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/load-json-file": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-4.0.0.tgz", "integrity": "sha512-Kx8hMakjX03tiGTLAIdJ+lL0htKnXjEZN6hk/tozf/WOuYGdZBJrZ+rCJRbVCugsjB3jMLn9746NsQIf5VjBMw==", "dev": true, + "license": "MIT", "dependencies": { "graceful-fs": "^4.1.2", "parse-json": "^4.0.0", @@ -3558,6 +4072,7 @@ "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-4.0.0.tgz", "integrity": "sha512-aOIos8bujGN93/8Ox/jPLh7RwVnPEysynVFE+fQZyg6jKELEHwzgKdLRFHUgXJL6kylijVSBC4BvN9OmsB48Rw==", "dev": true, + "license": "MIT", "dependencies": { "error-ex": "^1.3.1", "json-parse-better-errors": "^1.0.1" @@ -3571,6 +4086,7 @@ "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz", "integrity": "sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -3580,6 +4096,7 @@ "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz", "integrity": "sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -3589,6 +4106,7 @@ "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", "dev": true, + "license": "MIT", "dependencies": { "p-locate": "^4.1.0" }, @@ -3600,31 +4118,37 @@ "version": "4.17.21", "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/lodash.get": { "version": "4.4.2", "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz", "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==", - "dev": true + "deprecated": "This package is deprecated. Use the optional chaining (?.) operator instead.", + "dev": true, + "license": "MIT" }, "node_modules/lodash.ismatch": { "version": "4.4.0", "resolved": "https://registry.npmjs.org/lodash.ismatch/-/lodash.ismatch-4.4.0.tgz", "integrity": "sha512-fPMfXjGQEV9Xsq/8MTSgUf255gawYRbjwMyDbcvDhXgV7enSZA0hynz6vMPnpAb5iONEzBHBPsT+0zes5Z301g==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/lodash.memoize": { "version": "4.1.2", "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz", "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/loupe": { "version": "2.3.7", "resolved": "https://registry.npmjs.org/loupe/-/loupe-2.3.7.tgz", "integrity": "sha512-zSMINGVYkdpYSOBmLi0D1Uo7JU9nVdQKrHxC8eYlV+9YKK9WePqAlL7lSlorG/U2Fw1w0hTBmaa/jrQ3UbPHtA==", "dev": true, + "license": "MIT", "dependencies": { "get-func-name": "^2.0.1" } @@ -3634,6 +4158,7 @@ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", "dev": true, + "license": "ISC", "dependencies": { "yallist": "^4.0.0" }, @@ -3646,6 +4171,7 @@ "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz", "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==", "dev": true, + "license": "MIT", "dependencies": { "semver": "^7.5.3" }, @@ -3657,10 +4183,11 @@ } }, "node_modules/make-dir/node_modules/semver": { - "version": "7.6.3", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", - "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -3672,13 +4199,15 @@ "version": "1.3.6", "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz", "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/makeerror": { "version": "1.0.12", "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz", "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "tmpl": "1.0.5" } @@ -3688,6 +4217,7 @@ "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-4.3.0.tgz", "integrity": "sha512-hdN1wVrZbb29eBGiGjJbeP8JbKjq1urkHJ/LIP/NY48MZ1QVXUsQBV1G1zvYFHn1XE06cwjBsOI2K3Ulnj1YXQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" }, @@ -3695,11 +4225,24 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/md5": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/md5/-/md5-2.3.0.tgz", + "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==", + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "charenc": "0.0.2", + "crypt": "0.0.2", + "is-buffer": "~1.1.6" + } + }, "node_modules/meow": { "version": "8.1.2", "resolved": "https://registry.npmjs.org/meow/-/meow-8.1.2.tgz", "integrity": "sha512-r85E3NdZ+mpYk1C6RjPFEMSE+s1iZMuHtsHAqY0DT3jZczl0diWUZ8g6oU7h0M9cD2EL+PzaYghhCLzR0ZNn5Q==", "dev": true, + "license": "MIT", "dependencies": { "@types/minimist": "^1.2.0", "camelcase-keys": "^6.2.2", @@ -3724,13 +4267,15 @@ "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/meow/node_modules/read-pkg": { "version": "5.2.0", "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-5.2.0.tgz", "integrity": "sha512-Ug69mNOpfvKDAc2Q8DRpMjjzdtrnv9HcSMX+4VsZxD1aZ6ZzrIE7rlzXBtWTyhULSMKg076AW6WR5iZpD0JiOg==", "dev": true, + "license": "MIT", "dependencies": { "@types/normalize-package-data": "^2.4.0", "normalize-package-data": "^2.5.0", @@ -3746,6 +4291,7 @@ "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-7.0.1.tgz", "integrity": "sha512-zK0TB7Xd6JpCLmlLmufqykGE+/TlOePD6qKClNW7hHDKFh/J7/7gCWGR7joEQEW1bKq3a3yUZSObOoWLFQ4ohg==", "dev": true, + "license": "MIT", "dependencies": { "find-up": "^4.1.0", "read-pkg": "^5.2.0", @@ -3763,6 +4309,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.8.1.tgz", "integrity": "sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=8" } @@ -3772,6 +4319,7 @@ "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz", "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^2.1.4", "resolve": "^1.10.0", @@ -3784,6 +4332,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.6.0.tgz", "integrity": "sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=8" } @@ -3793,6 +4342,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver" } @@ -3802,6 +4352,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.18.1.tgz", "integrity": "sha512-OIAYXk8+ISY+qTOwkHtKqzAuxchoMiD9Udx+FSGQDuiRR+PJKJHc2NJAXlbhkGwTt/4/nKZxELY1w3ReWOL8mw==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=10" }, @@ -3813,7 +4364,8 @@ "version": "2.0.0", "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/micromatch": { "version": "4.0.8", @@ -3834,15 +4386,30 @@ "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } }, + "node_modules/mimic-response": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", + "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/min-indent": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/min-indent/-/min-indent-1.0.1.tgz", "integrity": "sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -3852,6 +4419,7 @@ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", "dev": true, + "license": "ISC", "dependencies": { "brace-expansion": "^1.1.7" }, @@ -3863,7 +4431,7 @@ "version": "1.2.8", "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", - "dev": true, + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -3873,6 +4441,7 @@ "resolved": "https://registry.npmjs.org/minimist-options/-/minimist-options-4.1.0.tgz", "integrity": "sha512-Q4r8ghd80yhO/0j1O3B2BjweX3fiHg9cdOwjJd2J76Q135c+NDxGCqdYKQ1SKBuFfgWbAUzBfvYjPUEeNgqN1A==", "dev": true, + "license": "MIT", "dependencies": { "arrify": "^1.0.1", "is-plain-obj": "^1.1.0", @@ -3882,72 +4451,121 @@ "node": ">= 6" } }, + "node_modules/mkdirp-classic": { + "version": "0.5.3", + "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", + "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", + "license": "MIT", + "peer": true + }, "node_modules/modify-values": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/modify-values/-/modify-values-1.0.1.tgz", "integrity": "sha512-xV2bxeN6F7oYjZWTe/YPAy6MN2M+sL4u/Rlm2AHCIVGfo2p1yGmBHQ6vHehl4bRTZBdHu3TSkWdYgkwpYzAGSw==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } }, "node_modules/ms": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz", - "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==", - "dev": true + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/napi-build-utils": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz", + "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==", + "license": "MIT", + "peer": true }, "node_modules/natural-compare": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/neo-async": { "version": "2.6.2", "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/nise": { - "version": "5.1.9", - "resolved": "https://registry.npmjs.org/nise/-/nise-5.1.9.tgz", - "integrity": "sha512-qOnoujW4SV6e40dYxJOb3uvuoPHtmLzIk4TFo+j0jPJoC+5Z9xja5qH5JZobEPsa8+YYphMrOSwnrshEhG2qww==", + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/nise/-/nise-6.1.1.tgz", + "integrity": "sha512-aMSAzLVY7LyeM60gvBS423nBmIPP+Wy7St7hsb+8/fc1HmeoHJfLO8CKse4u3BtOZvQLJghYPI2i/1WZrEj5/g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^3.0.0", - "@sinonjs/fake-timers": "^11.2.2", - "@sinonjs/text-encoding": "^0.7.2", + "@sinonjs/commons": "^3.0.1", + "@sinonjs/fake-timers": "^13.0.1", + "@sinonjs/text-encoding": "^0.7.3", "just-extend": "^6.2.0", - "path-to-regexp": "^6.2.1" + "path-to-regexp": "^8.1.0" } }, "node_modules/nise/node_modules/@sinonjs/fake-timers": { - "version": "11.2.2", - "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-11.2.2.tgz", - "integrity": "sha512-G2piCSxQ7oWOxwGSAyFHfPIsyeJGXYtc6mFbnFA+kRXkiEnTl8c/8jul2S329iFBnDI9HGoeWWAZvuvOkZccgw==", + "version": "13.0.5", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-13.0.5.tgz", + "integrity": "sha512-36/hTbH2uaWuGVERyC6da9YwGWnzUZXuPro/F2LfsdOsLnCojz/iSH8MxUt/FD2S5XBSVPhmArFUXcpCQ2Hkiw==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^3.0.0" + "@sinonjs/commons": "^3.0.1" + } + }, + "node_modules/node-abi": { + "version": "3.74.0", + "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.74.0.tgz", + "integrity": "sha512-c5XK0MjkGBrQPGYG24GBADZud0NCbznxNx0ZkS+ebUTrmV1qTDxPxSL8zEAPURXSbLRWVexxmP4986BziahL5w==", + "license": "MIT", + "peer": true, + "dependencies": { + "semver": "^7.3.5" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/node-abi/node_modules/semver": { + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", + "license": "ISC", + "peer": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" } }, "node_modules/node-int64": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz", "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/node-releases": { - "version": "2.0.18", - "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.18.tgz", - "integrity": "sha512-d9VeXT4SJ7ZeOqGX6R5EM022wpL+eWPooLI+5UpWn2jCT1aosUQEhQP214x33Wkwx3JQMvIm+tIoVOdodFS40g==", - "dev": true + "version": "2.0.19", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz", + "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==", + "dev": true, + "license": "MIT" }, "node_modules/normalize-package-data": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-3.0.3.tgz", "integrity": "sha512-p2W1sgqij3zMMyRC067Dg16bfzVH+w7hyegmpIvZ4JNjqtGOVAIvLmjBx3yP7YTe9vKJgkoNOPjwQGogDoMXFA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^4.0.1", "is-core-module": "^2.5.0", @@ -3959,10 +4577,11 @@ } }, "node_modules/normalize-package-data/node_modules/semver": { - "version": "7.6.3", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", - "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -3975,6 +4594,7 @@ "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -3984,6 +4604,7 @@ "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz", "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.0.0" }, @@ -3995,7 +4616,7 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", - "dev": true, + "license": "ISC", "dependencies": { "wrappy": "1" } @@ -4005,6 +4626,7 @@ "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", "dev": true, + "license": "MIT", "dependencies": { "mimic-fn": "^2.1.0" }, @@ -4020,6 +4642,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", "dev": true, + "license": "MIT", "dependencies": { "yocto-queue": "^0.1.0" }, @@ -4035,6 +4658,7 @@ "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", "dev": true, + "license": "MIT", "dependencies": { "p-limit": "^2.2.0" }, @@ -4047,6 +4671,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", "dev": true, + "license": "MIT", "dependencies": { "p-try": "^2.0.0" }, @@ -4062,6 +4687,7 @@ "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz", "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -4071,6 +4697,7 @@ "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", "dev": true, + "license": "MIT", "dependencies": { "@babel/code-frame": "^7.0.0", "error-ex": "^1.3.1", @@ -4089,6 +4716,7 @@ "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4098,6 +4726,7 @@ "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -4107,6 +4736,7 @@ "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4115,20 +4745,25 @@ "version": "1.0.7", "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/path-to-regexp": { - "version": "6.3.0", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.3.0.tgz", - "integrity": "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==", + "version": "8.2.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.2.0.tgz", + "integrity": "sha512-TdrF7fW9Rphjq4RjrW0Kp2AW0Ahwu9sRGTkS6bvDi0SCwZlEZYmcfDbEsTz8RVk0EHIS/Vd1bv3JhG+1xZuAyQ==", "dev": true, - "license": "MIT" + "license": "MIT", + "engines": { + "node": ">=16" + } }, "node_modules/path-type": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/path-type/-/path-type-3.0.0.tgz", "integrity": "sha512-T2ZUsdZFHgA3u4e5PfPbjd7HDDpxPnQb5jN0SrDsjNSuVXHJqtwTnWqG0B1jZrgmJ/7lj1EmVIByWt1gxGkWvg==", "dev": true, + "license": "MIT", "dependencies": { "pify": "^3.0.0" }, @@ -4141,6 +4776,7 @@ "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz", "integrity": "sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4150,21 +4786,24 @@ "resolved": "https://registry.npmjs.org/pathval/-/pathval-1.1.1.tgz", "integrity": "sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==", "dev": true, + "license": "MIT", "engines": { "node": "*" } }, "node_modules/picocolors": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.0.1.tgz", - "integrity": "sha512-anP1Z8qwhkbmu7MFP5iTt+wQKXgwzf7zTyGlcdzabySa9vd0Xt392U0rVmz9poOaBj0uHJKyyo9/upk0HrEQew==", - "dev": true + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" }, "node_modules/picomatch": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", "dev": true, + "license": "MIT", "engines": { "node": ">=8.6" }, @@ -4177,6 +4816,7 @@ "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz", "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -4186,6 +4826,7 @@ "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.6.tgz", "integrity": "sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==", "dev": true, + "license": "MIT", "engines": { "node": ">= 6" } @@ -4195,6 +4836,7 @@ "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", "dev": true, + "license": "MIT", "dependencies": { "find-up": "^4.0.0" }, @@ -4202,11 +4844,39 @@ "node": ">=8" } }, + "node_modules/prebuild-install": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", + "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==", + "license": "MIT", + "peer": true, + "dependencies": { + "detect-libc": "^2.0.0", + "expand-template": "^2.0.3", + "github-from-package": "0.0.0", + "minimist": "^1.2.3", + "mkdirp-classic": "^0.5.3", + "napi-build-utils": "^2.0.0", + "node-abi": "^3.3.0", + "pump": "^3.0.0", + "rc": "^1.2.7", + "simple-get": "^4.0.0", + "tar-fs": "^2.0.0", + "tunnel-agent": "^0.6.0" + }, + "bin": { + "prebuild-install": "bin.js" + }, + "engines": { + "node": ">=10" + } + }, "node_modules/pretty-format": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", "dev": true, + "license": "MIT", "dependencies": { "@jest/schemas": "^29.6.3", "ansi-styles": "^5.0.0", @@ -4221,6 +4891,7 @@ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -4232,13 +4903,15 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/prompts": { "version": "2.4.2", "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", "dev": true, + "license": "MIT", "dependencies": { "kleur": "^3.0.3", "sisteransi": "^1.0.5" @@ -4247,6 +4920,17 @@ "node": ">= 6" } }, + "node_modules/pump": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.2.tgz", + "integrity": "sha512-tUPXtzlGM8FE3P0ZL6DVs/3P58k9nk8/jZeQCurTJylQA8qFYzHFfhBJkuqyE0FifOsQ0uKWekiZ5g8wtr28cw==", + "license": "MIT", + "peer": true, + "dependencies": { + "end-of-stream": "^1.1.0", + "once": "^1.3.1" + } + }, "node_modules/pure-rand": { "version": "6.1.0", "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz", @@ -4261,7 +4945,8 @@ "type": "opencollective", "url": "https://opencollective.com/fast-check" } - ] + ], + "license": "MIT" }, "node_modules/q": { "version": "1.5.1", @@ -4269,6 +4954,7 @@ "integrity": "sha512-kV/CThkXo6xyFEZUugw/+pIOywXcDbFYgSct5cT3gqlbkBE1SJdwy6UQoZvodiWF/ckQLZyDE/Bu1M6gVu5lVw==", "deprecated": "You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other.\n\n(For a CapTP with native promises, see @endo/eventual-send and @endo/captp)", "dev": true, + "license": "MIT", "engines": { "node": ">=0.6.0", "teleport": ">=0.2.0" @@ -4279,21 +4965,50 @@ "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-4.0.1.tgz", "integrity": "sha512-ARhCpm70fzdcvNQfPoy49IaanKkTlRWF2JMzqhcJbhSFRZv7nPTvZJdcY7301IPmvW+/p0RgIWnQDLJxifsQ7g==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, + "node_modules/rc": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", + "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", + "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", + "peer": true, + "dependencies": { + "deep-extend": "^0.6.0", + "ini": "~1.3.0", + "minimist": "^1.2.0", + "strip-json-comments": "~2.0.1" + }, + "bin": { + "rc": "cli.js" + } + }, + "node_modules/rc/node_modules/strip-json-comments": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", + "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/react-is": { "version": "18.3.1", "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/read-pkg": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-3.0.0.tgz", "integrity": "sha512-BLq/cCO9two+lBgiTYNqD6GdtK8s4NpaWrl6/rCO9w0TUS8oJl7cmToOZfRYllKTISY6nt1U7jQ53brmKqY6BA==", "dev": true, + "license": "MIT", "dependencies": { "load-json-file": "^4.0.0", "normalize-package-data": "^2.3.2", @@ -4308,6 +5023,7 @@ "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-3.0.0.tgz", "integrity": "sha512-YFzFrVvpC6frF1sz8psoHDBGF7fLPc+llq/8NB43oagqWkx8ar5zYtsTORtOjw9W2RHLpWP+zTWwBvf1bCmcSw==", "dev": true, + "license": "MIT", "dependencies": { "find-up": "^2.0.0", "read-pkg": "^3.0.0" @@ -4321,6 +5037,7 @@ "resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz", "integrity": "sha512-NWzkk0jSJtTt08+FBFMvXoeZnOJD+jTtsRmBYbAIzJdX6l7dLgR7CTubCM5/eDdPUBvLCeVasP1brfVR/9/EZQ==", "dev": true, + "license": "MIT", "dependencies": { "locate-path": "^2.0.0" }, @@ -4333,6 +5050,7 @@ "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-2.0.0.tgz", "integrity": "sha512-NCI2kiDkyR7VeEKm27Kda/iQHyKJe1Bu0FlTbYp3CqJu+9IFe9bLyAjMxf5ZDDbEg+iMPzB5zYyUTSm8wVTKmA==", "dev": true, + "license": "MIT", "dependencies": { "p-locate": "^2.0.0", "path-exists": "^3.0.0" @@ -4346,6 +5064,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-1.3.0.tgz", "integrity": "sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==", "dev": true, + "license": "MIT", "dependencies": { "p-try": "^1.0.0" }, @@ -4358,6 +5077,7 @@ "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-2.0.0.tgz", "integrity": "sha512-nQja7m7gSKuewoVRen45CtVfODR3crN3goVQ0DDZ9N3yHxgpkuBhZqsaiotSQRrADUrne346peY7kT3TSACykg==", "dev": true, + "license": "MIT", "dependencies": { "p-limit": "^1.1.0" }, @@ -4370,6 +5090,7 @@ "resolved": "https://registry.npmjs.org/p-try/-/p-try-1.0.0.tgz", "integrity": "sha512-U1etNYuMJoIz3ZXSrrySFjsXQTWOx2/jdi86L+2pRvph/qMKL6sbcCYdH23fqsbm8TH2Gn0OybpT4eSFlCVHww==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4379,6 +5100,7 @@ "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz", "integrity": "sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4387,13 +5109,15 @@ "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/read-pkg/node_modules/normalize-package-data": { "version": "2.5.0", "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz", "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^2.1.4", "resolve": "^1.10.0", @@ -4406,6 +5130,7 @@ "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver" } @@ -4414,7 +5139,7 @@ "version": "3.6.2", "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "dev": true, + "license": "MIT", "dependencies": { "inherits": "^2.0.3", "string_decoder": "^1.1.1", @@ -4429,6 +5154,7 @@ "resolved": "https://registry.npmjs.org/redent/-/redent-3.0.0.tgz", "integrity": "sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg==", "dev": true, + "license": "MIT", "dependencies": { "indent-string": "^4.0.0", "strip-indent": "^3.0.0" @@ -4442,23 +5168,28 @@ "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } }, "node_modules/resolve": { - "version": "1.22.8", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz", - "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==", + "version": "1.22.10", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.10.tgz", + "integrity": "sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==", "dev": true, + "license": "MIT", "dependencies": { - "is-core-module": "^2.13.0", + "is-core-module": "^2.16.0", "path-parse": "^1.0.7", "supports-preserve-symlinks-flag": "^1.0.0" }, "bin": { "resolve": "bin/resolve" }, + "engines": { + "node": ">= 0.4" + }, "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -4468,6 +5199,7 @@ "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz", "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==", "dev": true, + "license": "MIT", "dependencies": { "resolve-from": "^5.0.0" }, @@ -4480,15 +5212,17 @@ "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/resolve.exports": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.2.tgz", - "integrity": "sha512-X2UW6Nw3n/aMgDVy+0rSqgHlv39WZAlZrXCdnbyEiKm17DSqHX4MmQMaST3FbeWR5FTuRcUwYAziZajji0Y7mg==", + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.3.tgz", + "integrity": "sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" } @@ -4497,7 +5231,6 @@ "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", - "dev": true, "funding": [ { "type": "github", @@ -4511,13 +5244,15 @@ "type": "consulting", "url": "https://feross.org/support" } - ] + ], + "license": "MIT" }, "node_modules/semver": { "version": "6.3.1", "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" } @@ -4527,6 +5262,7 @@ "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", "dev": true, + "license": "MIT", "dependencies": { "shebang-regex": "^3.0.0" }, @@ -4539,6 +5275,7 @@ "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4547,20 +5284,68 @@ "version": "3.0.7", "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", - "dev": true + "dev": true, + "license": "ISC" + }, + "node_modules/simple-concat": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz", + "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true + }, + "node_modules/simple-get": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz", + "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "decompress-response": "^6.0.0", + "once": "^1.3.1", + "simple-concat": "^1.0.0" + } }, "node_modules/sinon": { - "version": "15.2.0", - "resolved": "https://registry.npmjs.org/sinon/-/sinon-15.2.0.tgz", - "integrity": "sha512-nPS85arNqwBXaIsFCkolHjGIkFo+Oxu9vbgmBJizLAhqe6P2o3Qmj3KCUoRkfhHtvgDhZdWD3risLHAUJ8npjw==", - "deprecated": "16.1.1", + "version": "19.0.4", + "resolved": "https://registry.npmjs.org/sinon/-/sinon-19.0.4.tgz", + "integrity": "sha512-myidFob7fjmYHJb+CHNLtAYScxn3sngGq4t75L2rCGGpE/k4OQVkN3KE5FsN+XkO2+fcDZ65PGvq3KHrlLAm7g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { - "@sinonjs/commons": "^3.0.0", - "@sinonjs/fake-timers": "^10.3.0", - "@sinonjs/samsam": "^8.0.0", - "diff": "^5.1.0", - "nise": "^5.1.4", + "@sinonjs/commons": "^3.0.1", + "@sinonjs/fake-timers": "^13.0.5", + "@sinonjs/samsam": "^8.0.1", + "diff": "^7.0.0", + "nise": "^6.1.1", "supports-color": "^7.2.0" }, "funding": { @@ -4568,17 +5353,29 @@ "url": "https://opencollective.com/sinon" } }, + "node_modules/sinon/node_modules/@sinonjs/fake-timers": { + "version": "13.0.5", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-13.0.5.tgz", + "integrity": "sha512-36/hTbH2uaWuGVERyC6da9YwGWnzUZXuPro/F2LfsdOsLnCojz/iSH8MxUt/FD2S5XBSVPhmArFUXcpCQ2Hkiw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@sinonjs/commons": "^3.0.1" + } + }, "node_modules/sisteransi": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/slash": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4588,6 +5385,7 @@ "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.10.0" } @@ -4597,6 +5395,7 @@ "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.13.tgz", "integrity": "sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==", "dev": true, + "license": "MIT", "dependencies": { "buffer-from": "^1.0.0", "source-map": "^0.6.0" @@ -4607,6 +5406,7 @@ "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.2.0.tgz", "integrity": "sha512-kN9dJbvnySHULIluDHy32WHRUu3Og7B9sbY7tsFLctQkIqnMh3hErYgdMjTYuqmcXX+lK5T1lnUt3G7zNswmZA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "spdx-expression-parse": "^3.0.0", "spdx-license-ids": "^3.0.0" @@ -4616,29 +5416,33 @@ "version": "2.5.0", "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.5.0.tgz", "integrity": "sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==", - "dev": true + "dev": true, + "license": "CC-BY-3.0" }, "node_modules/spdx-expression-parse": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.1.tgz", "integrity": "sha512-cbqHunsQWnJNE6KhVSMsMeH5H/L9EpymbzqTQ3uLwNCLZ1Q481oWaofqH7nO6V07xlXwY6PhQdQ2IedWx/ZK4Q==", "dev": true, + "license": "MIT", "dependencies": { "spdx-exceptions": "^2.1.0", "spdx-license-ids": "^3.0.0" } }, "node_modules/spdx-license-ids": { - "version": "3.0.18", - "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.18.tgz", - "integrity": "sha512-xxRs31BqRYHwiMzudOrpSiHtZ8i/GeionCBDSilhYRj+9gIcI8wCZTlXZKu9vZIVqViP3dcp9qE5G6AlIaD+TQ==", - "dev": true + "version": "3.0.21", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.21.tgz", + "integrity": "sha512-Bvg/8F5XephndSK3JffaRqdT+gyhfqIPwDHpX80tJrF8QQRYMo8sNMeaZ2Dp5+jhwKnUmIOyFFQfHRkjJm5nXg==", + "dev": true, + "license": "CC0-1.0" }, "node_modules/split": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/split/-/split-1.0.1.tgz", "integrity": "sha512-mTyOoPbrivtXnwnIxZRFYRrPNtEFKlpB2fvjSnCQUiAA6qAZzqwna5envK4uk6OIeP17CsdF3rSBGYVBsU0Tkg==", "dev": true, + "license": "MIT", "dependencies": { "through": "2" }, @@ -4651,6 +5455,7 @@ "resolved": "https://registry.npmjs.org/split2/-/split2-3.2.2.tgz", "integrity": "sha512-9NThjpgZnifTkJpzTZ7Eue85S49QwpNhZTq6GRJwObb6jnLFNGB7Qm73V5HewTROPyxD0C29xqmaI68bQtV+hg==", "dev": true, + "license": "ISC", "dependencies": { "readable-stream": "^3.0.0" } @@ -4659,13 +5464,15 @@ "version": "1.0.3", "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", - "dev": true + "dev": true, + "license": "BSD-3-Clause" }, "node_modules/stack-utils": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz", "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==", "dev": true, + "license": "MIT", "dependencies": { "escape-string-regexp": "^2.0.0" }, @@ -4677,7 +5484,7 @@ "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", - "dev": true, + "license": "MIT", "dependencies": { "safe-buffer": "~5.2.0" } @@ -4687,6 +5494,7 @@ "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz", "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==", "dev": true, + "license": "MIT", "dependencies": { "char-regex": "^1.0.2", "strip-ansi": "^6.0.0" @@ -4700,6 +5508,7 @@ "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", "dev": true, + "license": "MIT", "dependencies": { "emoji-regex": "^8.0.0", "is-fullwidth-code-point": "^3.0.0", @@ -4714,6 +5523,7 @@ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", "dev": true, + "license": "MIT", "dependencies": { "ansi-regex": "^5.0.1" }, @@ -4726,6 +5536,7 @@ "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz", "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -4735,6 +5546,7 @@ "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz", "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -4744,6 +5556,7 @@ "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-3.0.0.tgz", "integrity": "sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==", "dev": true, + "license": "MIT", "dependencies": { "min-indent": "^1.0.0" }, @@ -4756,6 +5569,7 @@ "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" }, @@ -4768,6 +5582,7 @@ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", "dev": true, + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -4780,6 +5595,7 @@ "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -4787,11 +5603,42 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/tar-fs": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.2.tgz", + "integrity": "sha512-EsaAXwxmx8UB7FRKqeozqEPop69DXcmYwTQwXvyAPF352HJsPdkVhvTaDPYqfNgruveJIJy3TA2l+2zj8LJIJA==", + "license": "MIT", + "peer": true, + "dependencies": { + "chownr": "^1.1.1", + "mkdirp-classic": "^0.5.2", + "pump": "^3.0.0", + "tar-stream": "^2.1.4" + } + }, + "node_modules/tar-stream": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz", + "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "bl": "^4.0.3", + "end-of-stream": "^1.4.1", + "fs-constants": "^1.0.0", + "inherits": "^2.0.3", + "readable-stream": "^3.1.1" + }, + "engines": { + "node": ">=6" + } + }, "node_modules/test-exclude": { "version": "6.0.0", "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz", "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==", "dev": true, + "license": "ISC", "dependencies": { "@istanbuljs/schema": "^0.1.2", "glob": "^7.1.4", @@ -4806,6 +5653,7 @@ "resolved": "https://registry.npmjs.org/text-extensions/-/text-extensions-1.9.0.tgz", "integrity": "sha512-wiBrwC1EhBelW12Zy26JeOUkQ5mRu+5o8rpsJk5+2t+Y5vE7e842qtZDQ2g1NpX/29HdyFeJ4nSIhI47ENSxlQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10" } @@ -4814,13 +5662,15 @@ "version": "2.3.8", "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz", "integrity": "sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/through2": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz", "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==", "dev": true, + "license": "MIT", "dependencies": { "readable-stream": "3" } @@ -4829,13 +5679,15 @@ "version": "1.0.5", "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz", "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==", - "dev": true + "dev": true, + "license": "BSD-3-Clause" }, "node_modules/to-regex-range": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", "dev": true, + "license": "MIT", "dependencies": { "is-number": "^7.0.0" }, @@ -4848,25 +5700,27 @@ "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-3.0.1.tgz", "integrity": "sha512-c1PTsA3tYrIsLGkJkzHF+w9F2EyxfXGo4UyJc4pFL++FMjnq0HJS69T3M7d//gKrFKwy429bouPescbjecU+Zw==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } }, "node_modules/ts-jest": { - "version": "29.2.4", - "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.2.4.tgz", - "integrity": "sha512-3d6tgDyhCI29HlpwIq87sNuI+3Q6GLTTCeYRHCs7vDz+/3GCMwEtV9jezLyl4ZtnBgx00I7hm8PCP8cTksMGrw==", + "version": "29.2.6", + "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.2.6.tgz", + "integrity": "sha512-yTNZVZqc8lSixm+QGVFcPe6+yj7+TWZwIesuOWvfcn4B9bz5x4NDzVCQQjOs7Hfouu36aEqfEbo9Qpo+gq8dDg==", "dev": true, + "license": "MIT", "dependencies": { - "bs-logger": "0.x", + "bs-logger": "^0.2.6", "ejs": "^3.1.10", - "fast-json-stable-stringify": "2.x", + "fast-json-stable-stringify": "^2.1.0", "jest-util": "^29.0.0", "json5": "^2.2.3", - "lodash.memoize": "4.x", - "make-error": "1.x", - "semver": "^7.5.3", - "yargs-parser": "^21.0.1" + "lodash.memoize": "^4.1.2", + "make-error": "^1.3.6", + "semver": "^7.7.1", + "yargs-parser": "^21.1.1" }, "bin": { "ts-jest": "cli.js" @@ -4901,10 +5755,11 @@ } }, "node_modules/ts-jest/node_modules/semver": { - "version": "7.6.3", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", - "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", "dev": true, + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -4917,6 +5772,7 @@ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", "dev": true, + "license": "ISC", "engines": { "node": ">=12" } @@ -4926,6 +5782,7 @@ "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz", "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==", "dev": true, + "license": "MIT", "dependencies": { "@cspotcode/source-map-support": "^0.8.0", "@tsconfig/node10": "^1.0.7", @@ -4969,15 +5826,30 @@ "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz", "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==", "dev": true, + "license": "BSD-3-Clause", "engines": { "node": ">=0.3.1" } }, + "node_modules/tunnel-agent": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", + "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", + "license": "Apache-2.0", + "peer": true, + "dependencies": { + "safe-buffer": "^5.0.1" + }, + "engines": { + "node": "*" + } + }, "node_modules/type-detect": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.1.0.tgz", "integrity": "sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw==", "dev": true, + "license": "MIT", "engines": { "node": ">=4" } @@ -4987,6 +5859,7 @@ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz", "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==", "dev": true, + "license": "(MIT OR CC0-1.0)", "engines": { "node": ">=10" }, @@ -4995,10 +5868,11 @@ } }, "node_modules/typescript": { - "version": "5.5.4", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.5.4.tgz", - "integrity": "sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==", + "version": "5.8.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.8.2.tgz", + "integrity": "sha512-aJn6wq13/afZp/jT9QZmwEjDqqvSGp1VT5GVg+f/t6/oVyrgXM6BY1h9BRh/O5p3PlUPAe+WuiEZOmb/49RqoQ==", "dev": true, + "license": "Apache-2.0", "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" @@ -5008,10 +5882,11 @@ } }, "node_modules/uglify-js": { - "version": "3.19.1", - "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.1.tgz", - "integrity": "sha512-y/2wiW+ceTYR2TSSptAhfnEtpLaQ4Ups5zrjB2d3kuVxHj16j/QJwPl5PvuGy9uARb39J0+iKxcRPvtpsx4A4A==", + "version": "3.19.3", + "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", + "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", "dev": true, + "license": "BSD-2-Clause", "optional": true, "bin": { "uglifyjs": "bin/uglifyjs" @@ -5021,15 +5896,16 @@ } }, "node_modules/undici-types": { - "version": "5.26.5", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-5.26.5.tgz", - "integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==", - "dev": true + "version": "6.19.8", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz", + "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==", + "dev": true, + "license": "MIT" }, "node_modules/update-browserslist-db": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.0.tgz", - "integrity": "sha512-EdRAaAyk2cUE1wOf2DkEhzxqOQvFOoRJFNS6NeyJ01Gp2beMRpBAINjM2iDXE3KCuKhwnvHIQCJm6ThL2Z+HzQ==", + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz", + "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==", "dev": true, "funding": [ { @@ -5045,9 +5921,10 @@ "url": "https://github.com/sponsors/ai" } ], + "license": "MIT", "dependencies": { - "escalade": "^3.1.2", - "picocolors": "^1.0.1" + "escalade": "^3.2.0", + "picocolors": "^1.1.1" }, "bin": { "update-browserslist-db": "cli.js" @@ -5060,19 +5937,21 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", - "dev": true + "license": "MIT" }, "node_modules/v8-compile-cache-lib": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz", "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/v8-to-istanbul": { "version": "9.3.0", "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz", "integrity": "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==", "dev": true, + "license": "ISC", "dependencies": { "@jridgewell/trace-mapping": "^0.3.12", "@types/istanbul-lib-coverage": "^2.0.1", @@ -5087,6 +5966,7 @@ "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz", "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==", "dev": true, + "license": "Apache-2.0", "dependencies": { "spdx-correct": "^3.0.0", "spdx-expression-parse": "^3.0.0" @@ -5097,6 +5977,7 @@ "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz", "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==", "dev": true, + "license": "Apache-2.0", "dependencies": { "makeerror": "1.0.12" } @@ -5106,6 +5987,7 @@ "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", "dev": true, + "license": "ISC", "dependencies": { "isexe": "^2.0.0" }, @@ -5120,13 +6002,15 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/wrap-ansi": { "version": "7.0.0", "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^4.0.0", "string-width": "^4.1.0", @@ -5143,13 +6027,14 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", - "dev": true + "license": "ISC" }, "node_modules/write-file-atomic": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-4.0.2.tgz", "integrity": "sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==", "dev": true, + "license": "ISC", "dependencies": { "imurmurhash": "^0.1.4", "signal-exit": "^3.0.7" @@ -5163,6 +6048,7 @@ "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz", "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.4" } @@ -5172,6 +6058,7 @@ "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", "dev": true, + "license": "ISC", "engines": { "node": ">=10" } @@ -5180,13 +6067,15 @@ "version": "4.0.0", "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/yargs": { "version": "16.2.0", "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz", "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==", "dev": true, + "license": "MIT", "dependencies": { "cliui": "^7.0.2", "escalade": "^3.1.1", @@ -5205,6 +6094,7 @@ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz", "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==", "dev": true, + "license": "ISC", "engines": { "node": ">=10" } @@ -5214,6 +6104,7 @@ "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz", "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=6" } @@ -5223,6 +6114,7 @@ "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, diff --git a/package.json b/package.json index 3247729..70fcfdd 100644 --- a/package.json +++ b/package.json @@ -28,7 +28,7 @@ "test": "jest --verbose tests/unit", "test:coverage": "jest --collect-coverage tests/unit", "pretest:integration": "npm run build", - "test:integration": "jest --verbose examples/user-domain-tests", + "test:integration": "jest --verbose examples/user-domain-tests tests/integration", "changelog": "conventional-changelog -n ./scripts/changelog -i CHANGELOG.md -s", "clean": "tsc --build --clean", "build": "tsc --build", @@ -43,16 +43,21 @@ "di0": "^1.0.0" }, "devDependencies": { - "@types/chai": "^4.3.17", - "@types/jest": "^29.5.12", - "@types/node": "^20.14.14", - "@types/sinon": "^10.0.20", + "@types/better-sqlite3": "^7.6.11", + "@types/chai": "^4.3.20", + "@types/jest": "^29.5.13", + "@types/node": "^20.16.9", + "@types/sinon": "^17.0.4", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", "jest": "^29.7.0", - "sinon": "^15.2.0", - "ts-jest": "^29.2.4", + "sinon": "^19.0.2", + "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.5.4" + "typescript": "^5.6.2" + }, + "peerDependencies": { + "better-sqlite3": "^11.3.0", + "md5": "^2.3.0" } } diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index a7da6ae..fd69a79 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -8,7 +8,7 @@ import { IAggregateConstructorParams } from "./interfaces"; -import { getClassName, validateHandlers, getHandler } from './utils'; +import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils'; /** * Deep-clone simple JS object @@ -25,16 +25,15 @@ const SNAPSHOT_EVENT_TYPE = 'snapshot'; export abstract class AbstractAggregate implements IAggregate { /** - * Optional list of commands handled by Aggregate. - * - * If not overridden in Aggregate implementation, - * `AggregateCommandHandler` will treat all public methods as command handlers + * List of command names handled by the Aggregate. * - * @example - * return ['createUser', 'changePassword']; + * Can be overridden in the Aggregate implementation to explicitly define supported commands. + * If not overridden, all public methods will be treated as command handlers by default. + * + * @example ['createUser', 'changePassword']; */ - static get handles(): string[] | undefined { - return undefined; + static get handles(): string[] { + return getMessageHandlerNames(this); } #id: Identifier; diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 54b52b4..a999f50 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -1,89 +1,110 @@ -import { InMemoryView } from './infrastructure/InMemoryView'; - +import { describe } from './Event'; +import { InMemoryView } from './infrastructure/memory/InMemoryView'; import { - IProjectionView, - IEvent, - IPersistentView, - IEventStore, - IExtendableLogger, - ILogger, + IViewLocker, + IEventLocker, IProjection, - IViewFactory -} from "./interfaces"; + ILogger, + IExtendableLogger, + IEventStore, + IEvent, + isViewLocker, + isEventLocker +} from './interfaces'; import { getClassName, validateHandlers, getHandler, - getHandledMessageTypes, - subscribe + subscribe, + getMessageHandlerNames } from './utils'; -const isProjectionView = (view: IProjectionView): view is IProjectionView => - 'ready' in view && - 'lock' in view && - 'unlock' in view && - 'once' in view; +export type AbstractProjectionParams = { + /** + * The default view associated with the projection. + * Can optionally implement IViewLocker and/or IEventLocker. + */ + view?: T, -const asProjectionView = (view: any): IProjectionView | undefined => - (isProjectionView(view) ? view : undefined); + /** + * Manages view restoration state to prevent early access to an inconsistent view + * or conflicts from concurrent restoration by other processes. + */ + viewLocker?: IViewLocker, + + /** + * Tracks event processing state to prevent concurrent handling by multiple processes. + */ + eventLocker?: IEventLocker, + + logger?: ILogger | IExtendableLogger +} /** * Base class for Projection definition */ -export abstract class AbstractProjection implements IProjection { +export abstract class AbstractProjection> implements IProjection { /** - * Optional list of event types being handled by projection. - * Can be overridden in projection implementation. - * If not overridden, will detect event types from event handlers declared on the Projection class + * List of event types handled by the projection. Can be overridden in the projection implementation. + * If not overridden, event types will be inferred from handler methods defined on the Projection class. */ - static get handles(): string[] | undefined { - return undefined; + static get handles(): string[] { + return getMessageHandlerNames(this); } + #view?: TView; + #viewLocker?: IViewLocker; + #eventLocker?: IEventLocker; + protected _logger?: ILogger; + /** - * Default view associated with projection + * The default view associated with the projection. + * Can optionally implement IViewLocker and/or IEventLocker. */ - get view(): TView { - if (!this.#view) - this.#view = this.#viewFactory(); - - return this.#view; + public get view(): TView { + return this.#view ?? (this.#view = new InMemoryView() as TView); } - #viewFactory: IViewFactory; - #view?: TView; + protected set view(value: TView) { + this.#view = value; + } - protected _logger?: ILogger; + /** + * Manages view restoration state to prevent early access to an inconsistent view + * or conflicts from concurrent restoration by other processes. + */ + protected get _viewLocker(): IViewLocker | undefined { + return this.#viewLocker ?? (isViewLocker(this.view) ? this.view : undefined); + } - get collectionName(): string { - return getClassName(this); + protected set _viewLocker(value: IViewLocker | undefined) { + this.#viewLocker = value; } /** - * Indicates if view should be restored from EventStore on start. - * Override for custom behavior. + * Tracks event processing state to prevent concurrent handling by multiple processes. */ - get shouldRestoreView(): boolean | Promise { - return (this.view instanceof Map) - || (this.view instanceof InMemoryView); + protected get _eventLocker(): IEventLocker | undefined { + return this.#eventLocker ?? (isEventLocker(this.view) ? this.view : undefined); + } + + protected set _eventLocker(value: IEventLocker | undefined) { + this.#eventLocker = value; } constructor({ view, - viewFactory = InMemoryView.factory, + viewLocker, + eventLocker, logger - }: { - view?: TView, - viewFactory?: IViewFactory, - logger?: ILogger | IExtendableLogger - } = {}) { + }: AbstractProjectionParams = {}) { validateHandlers(this); - this.#viewFactory = view ? - () => view : - viewFactory; + this.#view = view; + this.#viewLocker = viewLocker; + this.#eventLocker = eventLocker; this._logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : @@ -101,9 +122,10 @@ export abstract class AbstractProjection { - const concurrentView = asProjectionView(this.view); - if (concurrentView && !concurrentView.ready) - await concurrentView.once('ready'); + if (this._viewLocker && !this._viewLocker?.ready) { + this._logger?.debug('view is locked, awaiting until it is ready'); + await this._viewLocker.once('ready'); + } return this._project(event); } @@ -114,36 +136,50 @@ export abstract class AbstractProjection { // lock the view to ensure same restoring procedure // won't be performed by another projection instance - const concurrentView = asProjectionView(this.view); - if (concurrentView) - await concurrentView.lock(); + if (this._viewLocker) + await this._viewLocker.lock(); - const shouldRestore = await this.shouldRestoreView; - if (shouldRestore) - await this._restore(eventStore); + await this._restore(eventStore); - if (concurrentView) - concurrentView.unlock(); + if (this._viewLocker) + this._viewLocker.unlock(); } /** Restore projection view from event store */ protected async _restore(eventStore: IEventStore): Promise { if (!eventStore) throw new TypeError('eventStore argument required'); - if (typeof eventStore.getAllEvents !== 'function') - throw new TypeError('eventStore.getAllEvents must be a Function'); + if (typeof eventStore.getEventsByTypes !== 'function') + throw new TypeError('eventStore.getEventsByTypes must be a Function'); + + let lastEvent: IEvent | undefined; + + if (this._eventLocker) { + this._logger?.debug('retrieving last event projected'); + lastEvent = await this._eventLocker.getLastEvent(); + } + + this._logger?.debug(`retrieving ${lastEvent ? `events after ${describe(lastEvent)}` : 'all events'}...`); - this._logger?.debug('retrieving events and restoring projection...'); + const messageTypes = (this.constructor as typeof AbstractProjection).handles; + const eventsIterable = eventStore.getEventsByTypes(messageTypes, { afterEvent: lastEvent }); - const messageTypes = getHandledMessageTypes(this); - const eventsIterable = eventStore.getAllEvents(messageTypes); let eventsCount = 0; const startTs = Date.now(); @@ -157,7 +193,7 @@ export abstract class AbstractProjection new AggregateType(params); - this.#handles = getHandledMessageTypes(AggregateType); + this.#handles = AggregateType.handles; } else if (aggregateFactory) { if (!Array.isArray(handles) || !handles.length) @@ -84,7 +84,9 @@ export class AggregateCommandHandler implements ICommandHandler { if (!id) throw new TypeError('id argument required'); - const events = await this.#eventStore.getAggregateEvents(id); + const eventsIterable = this.#eventStore.getAggregateEvents(id); + const events = await iteratorToArray(eventsIterable); + const aggregate = this.#aggregateFactory({ id, events }); this.#logger?.info(`${aggregate} state restored from ${events.length} event(s)`); diff --git a/src/CommandBus.ts b/src/CommandBus.ts index 56b08f2..e7cfbbf 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -1,4 +1,4 @@ -import { InMemoryMessageBus } from "./infrastructure/InMemoryMessageBus"; +import { InMemoryMessageBus } from "./infrastructure/memory"; import { ICommand, ICommandBus, diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index e2c8e0d..9aaecf8 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -4,10 +4,8 @@ import { AggregateCommandHandler } from './AggregateCommandHandler'; import { CommandBus } from './CommandBus'; import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; -import { InMemoryMessageBus } from './infrastructure/InMemoryMessageBus'; import { - getHandledMessageTypes, isClass } from './utils'; @@ -95,7 +93,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { container.createInstance(AggregateCommandHandler, { aggregateFactory: (options: any) => container.createInstance(AggregateType, options), - handles: getHandledMessageTypes(AggregateType) + handles: AggregateType.handles }); return this.registerCommandHandler(commandHandlerFactory); diff --git a/src/EventStore.ts b/src/EventStore.ts index 3a0c076..99d596a 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -1,8 +1,6 @@ import { IAggregateSnapshotStorage, - Identifier, IEvent, - IEventQueryFilter, IEventStorage, IEventSet, IExtendableLogger, @@ -11,46 +9,31 @@ import { IMessageHandler, IObservable, IEventStream, - IEventStore + IEventStore, + EventQueryAfter, + EventQueryBefore, + Identifier } from "./interfaces"; -import { getClassName, setupOneTimeEmitterSubscription } from "./utils"; +import { + getClassName, + setupOneTimeEmitterSubscription, + CompoundEmitter, + isIEventStorage, + isIMessageBus +} from "./utils"; import * as Event from './Event'; -const isIEventStorage = (storage: IEventStorage): storage is IEventStorage => - storage - && typeof storage.getNewId === 'function' - && typeof storage.commitEvents === 'function' - && typeof storage.getEvents === 'function' - && typeof storage.getAggregateEvents === 'function' - && typeof storage.getSagaEvents === 'function'; - -const isIObservable = (obj: IObservable | any): obj is IObservable => - obj - && 'on' in obj - && typeof obj.on === 'function' - && 'off' in obj - && typeof obj.off === 'function'; - -const isIMessageBus = (bus: IMessageBus | any): bus is IMessageBus => - bus - && isIObservable(bus) - && 'send' in bus - && typeof bus.send === 'function' - && 'publish' in bus - && typeof bus.publish === 'function'; - const SNAPSHOT_EVENT_TYPE = 'snapshot'; export class EventStore implements IEventStore { - #publishAsync: boolean; #validator: (event: IEvent) => void; #logger?: ILogger; #storage: IEventStorage; - #messageBus?: IMessageBus; + #supplementaryEventBus?: IMessageBus; #snapshotStorage: IAggregateSnapshotStorage | undefined; #sagaStarters: string[] = []; - #defaultEventEmitter: IObservable; + #compoundEmitter: CompoundEmitter; /** Whether storage supports aggregate snapshots */ get snapshotsSupported(): boolean { @@ -59,66 +42,57 @@ export class EventStore implements IEventStore { constructor({ storage, - messageBus, + supplementaryEventBus, snapshotStorage, eventValidator = Event.validate, - eventStoreConfig, logger }: { storage: IEventStorage, - messageBus?: IMessageBus, + + /** Optional event dispatcher for publishing persisted events externally */ + supplementaryEventBus?: IMessageBus, snapshotStorage?: IAggregateSnapshotStorage, eventValidator?: IMessageHandler, - eventStoreConfig?: { - publishAsync?: boolean - }, logger?: ILogger | IExtendableLogger }) { if (!storage) throw new TypeError('storage argument required'); if (!isIEventStorage(storage)) throw new TypeError('storage does not implement IEventStorage interface'); - if (messageBus && !isIMessageBus(messageBus)) - throw new TypeError('messageBus does not implement IMessageBus interface'); - if (messageBus && isIObservable(storage)) - throw new TypeError('both storage and messageBus implement IObservable interface, it is not yet supported'); - - const defaultEventEmitter = isIObservable(storage) ? storage : messageBus; - if (!defaultEventEmitter) - throw new TypeError('storage must implement IObservable if messageBus is not injected'); + if (supplementaryEventBus && !isIMessageBus(supplementaryEventBus)) + throw new TypeError('supplementaryEventBus does not implement IMessageBus interface'); - this.#publishAsync = eventStoreConfig?.publishAsync ?? true; this.#validator = eventValidator; this.#logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : logger; this.#storage = storage; this.#snapshotStorage = snapshotStorage; - this.#messageBus = messageBus; - this.#defaultEventEmitter = defaultEventEmitter; + this.#supplementaryEventBus = supplementaryEventBus; + this.#compoundEmitter = new CompoundEmitter(supplementaryEventBus, storage); } + /** Retrieve new ID from the storage */ async getNewId(): Promise { return this.#storage.getNewId(); } - /** Retrieve all events of specific types */ - async* getAllEvents(eventTypes?: string[]): IEventStream { - if (eventTypes && !Array.isArray(eventTypes)) - throw new TypeError('eventTypes, if specified, must be an Array'); + async* getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream { + if (!Array.isArray(eventTypes)) + throw new TypeError('eventTypes argument must be an Array'); - this.#logger?.debug(`retrieving ${eventTypes ? eventTypes.join(', ') : 'all'} events...`); + this.#logger?.debug(`retrieving ${eventTypes.join(', ')} events...`); - const eventsIterable = await this.#storage.getEvents(eventTypes); + const eventsIterable = await this.#storage.getEventsByTypes(eventTypes, options); yield* eventsIterable; - this.#logger?.debug(`${eventTypes ? eventTypes.join(', ') : 'all'} events retrieved`); + this.#logger?.debug(`${eventTypes.join(', ')} events retrieved`); } /** Retrieve all events of specific Aggregate */ - async getAggregateEvents(aggregateId: Identifier): Promise { + async* getAggregateEvents(aggregateId: Identifier): IEventStream { if (!aggregateId) throw new TypeError('aggregateId argument required'); @@ -128,21 +102,18 @@ export class EventStore implements IEventStore { await this.#snapshotStorage.getAggregateSnapshot(aggregateId) : undefined; - const events: IEvent[] = []; if (snapshot) - events.push(snapshot); + yield snapshot; const eventsIterable = await this.#storage.getAggregateEvents(aggregateId, { snapshot }); - for await (const event of eventsIterable) - events.push(event); - this.#logger?.debug(`${Event.describeMultiple(events)} retrieved`); + yield* eventsIterable; - return events; + this.#logger?.debug(`all events for aggregate ${aggregateId} retrieved`); } /** Retrieve events of specific Saga */ - async getSagaEvents(sagaId: Identifier, filter: Pick) { + async* getSagaEvents(sagaId: Identifier, filter: EventQueryBefore) { if (!sagaId) throw new TypeError('sagaId argument required'); if (!filter) @@ -154,14 +125,11 @@ export class EventStore implements IEventStore { this.#logger?.debug(`retrieving event stream for saga ${sagaId}, v${filter.beforeEvent.sagaVersion}...`); - const events: IEvent[] = []; const eventsIterable = await this.#storage.getSagaEvents(sagaId, filter); - for await (const event of eventsIterable) - events.push(event); - this.#logger?.debug(`${Event.describeMultiple(events)} retrieved`); + yield* eventsIterable; - return events; + this.#logger?.debug(`all events for saga ${sagaId} retrieved`); } /** @@ -176,10 +144,10 @@ export class EventStore implements IEventStore { /** * Validate events, commit to storage and publish to messageBus, if needed * - * @param {IEventSet} events - a set of events to commit - * @returns {Promise} - resolves to signed and committed events + * @param events - a set of events to commit + * @returns Signed and committed events */ - async commit(events) { + async commit(events: IEventSet): Promise { if (!Array.isArray(events)) throw new TypeError('events argument must be an Array'); @@ -188,12 +156,12 @@ export class EventStore implements IEventStore { await this.#attachSagaIdToSagaStarterEvents(events) : events; - const eventStreamWithoutSnapshots = await this.save(augmentedEvents); + const eventStreamWithoutSnapshots = await this.persistEventsAndSnapshots(augmentedEvents); // after events are saved to the persistent storage, // publish them to the event bus (i.e. RabbitMq) - if (this.#messageBus) - await this.#publish(eventStreamWithoutSnapshots); + if (this.#supplementaryEventBus) + await this.publishEvents(eventStreamWithoutSnapshots); return eventStreamWithoutSnapshots; } @@ -218,8 +186,12 @@ export class EventStore implements IEventStore { return augmentedEvents; } - /** Save events to the persistent storage(s) */ - async save(events: IEventSet): Promise { + /** + * Save events and snapshots to the persistent storages + * + * @returns Event set without "snapshot" events + */ + protected async persistEventsAndSnapshots(events: IEventSet): Promise { if (!Array.isArray(events)) throw new TypeError('events argument must be an Array'); @@ -246,24 +218,15 @@ export class EventStore implements IEventStore { return eventsWithoutSnapshot; } - async #publish(events: IEventSet) { - if (this.#publishAsync) { - this.#logger?.debug(`publishing ${Event.describeMultiple(events)} asynchronously...`); - setImmediate(() => this.#publishEvents(events)); - } - else { - this.#logger?.debug(`publishing ${Event.describeMultiple(events)} synchronously...`); - await this.#publishEvents(events); - } - } + protected async publishEvents(events: IEventSet) { + if (!this.#supplementaryEventBus) + throw new Error('No supplementaryEventBus injected, events cannot be published'); - async #publishEvents(events: IEventSet) { - if (!this.#messageBus) - return; + this.#logger?.debug(`publishing ${Event.describeMultiple(events)}...`); try { - await Promise.all(events.map(event => - this.#messageBus?.publish(event))); + for (const event of events) + this.#supplementaryEventBus.publish(event); this.#logger?.debug(`${Event.describeMultiple(events)} published`); } @@ -275,41 +238,22 @@ export class EventStore implements IEventStore { } } - /** Setup a listener for a specific event type */ on(messageType: string, handler: IMessageHandler) { - if (typeof messageType !== 'string' || !messageType.length) - throw new TypeError('messageType argument must be a non-empty String'); - if (typeof handler !== 'function') - throw new TypeError('handler argument must be a Function'); - if (arguments.length !== 2) - throw new TypeError(`2 arguments are expected, but ${arguments.length} received`); - - if (isIObservable(this.#storage)) - this.#storage.on(messageType, handler); - - this.#messageBus?.on(messageType, handler); + this.#compoundEmitter.on(messageType, handler); } - /** Remove previously installed listener */ off(messageType: string, handler: IMessageHandler) { - if (isIObservable(this.#storage)) - this.#storage.off(messageType, handler); - - this.#messageBus?.off(messageType, handler); + this.#compoundEmitter.off(messageType, handler); } - /** Get or create a named queue, which delivers events to a single handler only */ queue(name: string): IObservable { - if (!this.#defaultEventEmitter.queue) - throw new Error('Named queues are not supported by the underlying message bus'); - - return this.#defaultEventEmitter.queue(name); + return this.#compoundEmitter.queue(name); } /** Creates one-time subscription for one or multiple events that match a filter */ - once(messageTypes: string | string[], handler: IMessageHandler, filter: (e: IEvent) => boolean): Promise { + once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise { const subscribeTo = Array.isArray(messageTypes) ? messageTypes : [messageTypes]; - return setupOneTimeEmitterSubscription(this.#defaultEventEmitter, subscribeTo, filter, handler, this.#logger); + return setupOneTimeEmitterSubscription(this.#compoundEmitter, subscribeTo, filter, handler, this.#logger); } } diff --git a/src/SagaEventHandler.ts b/src/SagaEventHandler.ts index b66c639..6b538b3 100644 --- a/src/SagaEventHandler.ts +++ b/src/SagaEventHandler.ts @@ -14,7 +14,8 @@ import { import { subscribe, - getClassName + getClassName, + iteratorToArray } from './utils'; /** @@ -151,7 +152,8 @@ export class SagaEventHandler implements IEventReceptor { if (!event.sagaId) throw new TypeError(`${Event.describe(event)} does not contain sagaId`); - const events = await this.#eventStore.getSagaEvents(event.sagaId, { beforeEvent: event }); + const eventsIterable = this.#eventStore.getSagaEvents(event.sagaId, { beforeEvent: event }); + const events = await iteratorToArray(eventsIterable); const saga = this.#sagaFactory.call(null, { id: event.sagaId, events }); this.#logger?.info(`Saga state restored from ${events.length} event(s)`); diff --git a/src/index.ts b/src/index.ts index 94b96da..bd3b6bd 100644 --- a/src/index.ts +++ b/src/index.ts @@ -9,17 +9,12 @@ export * from './AbstractSaga'; export * from './SagaEventHandler'; export * from './AbstractProjection'; -export * from './infrastructure/InMemoryMessageBus'; -export * from './infrastructure/InMemoryEventStorage'; -export * from './infrastructure/InMemorySnapshotStorage'; -export * from './infrastructure/InMemoryView'; -export * from './infrastructure/InMemoryLock'; -export * from './infrastructure/utils/Deferred'; +export * from './infrastructure/memory'; +export * as SQLite from './infrastructure/sqlite'; export * as Event from './Event'; export { getMessageHandlerNames, - getHandledMessageTypes, subscribe } from './utils'; diff --git a/src/infrastructure/InMemoryLock.ts b/src/infrastructure/InMemoryLock.ts deleted file mode 100644 index dee6195..0000000 --- a/src/infrastructure/InMemoryLock.ts +++ /dev/null @@ -1,73 +0,0 @@ -import { ILockable, ILockableWithIndication } from "../interfaces"; -import { Deferred } from "./utils"; - -export class InMemoryLock implements ILockableWithIndication { - - #lockMarker: Deferred | undefined; - #innerLock: ILockable | undefined; - - /** - * Indicates if lock is acquired - */ - get locked(): boolean { - return !!this.#lockMarker; - } - - /** - * Creates an instance of InMemoryLock - * - * @param innerLock ILockable instance that can persist lock state outside of the current process - */ - constructor(innerLock?: ILockable) { - this.#innerLock = innerLock; - } - - /** - * Acquire the lock on the current instance. - * Resolves when the lock is successfully acquired - */ - async lock(): Promise { - while (this.locked) - await this.once('unlocked'); - - try { - this.#lockMarker = new Deferred(); - if (this.#innerLock) - await this.#innerLock.lock(); - } - catch (err: any) { - try { - await this.unlock(); - } - catch (unlockErr: any) { - // unlocking errors are ignored - } - throw err; - } - } - - /** - * Release the lock acquired earlier - */ - async unlock(): Promise { - try { - if (this.#innerLock) - await this.#innerLock.unlock(); - } - finally { - this.#lockMarker?.resolve(); - this.#lockMarker = undefined; - } - } - - /** - * Wait until the lock is released. - * Resolves immediately if the lock is not acquired - */ - once(event: 'unlocked'): Promise { - if (event !== 'unlocked') - throw new TypeError(`Unexpected event type: ${event}`); - - return this.#lockMarker?.promise ?? Promise.resolve(); - } -} diff --git a/src/infrastructure/InMemoryEventStorage.ts b/src/infrastructure/memory/InMemoryEventStorage.ts similarity index 51% rename from src/infrastructure/InMemoryEventStorage.ts rename to src/infrastructure/memory/InMemoryEventStorage.ts index 3fa6d95..c78dc36 100644 --- a/src/infrastructure/InMemoryEventStorage.ts +++ b/src/infrastructure/memory/InMemoryEventStorage.ts @@ -1,15 +1,14 @@ -import { IEvent, IEventStorage, IEventSet, IEventStream } from "../interfaces"; +import { IEvent } from "../../interfaces/IEvent"; +import { IEventSet } from "../../interfaces/IEventSet"; +import { EventQueryAfter, IEventStorage } from "../../interfaces/IEventStorage"; +import { IEventStream } from "../../interfaces/IEventStream"; import { nextCycle } from "./utils"; /** * A simple event storage implementation intended to use for tests only. * Storage content resets on each app restart. - * - * @class InMemoryEventStorage - * @implements {IEventStorage} */ export class InMemoryEventStorage implements IEventStorage { - #nextId: number = 0; #events: IEventSet = []; @@ -23,11 +22,11 @@ export class InMemoryEventStorage implements IEventStorage { return events; } - async getAggregateEvents(aggregateId, options?: { snapshot: IEvent }): Promise { + async *getAggregateEvents(aggregateId, options?: { snapshot: IEvent }): IEventStream { await nextCycle(); const afterVersion = options?.snapshot?.aggregateVersion; - const result = !afterVersion ? + const results = !afterVersion ? this.#events.filter(e => e.aggregateId == aggregateId) : this.#events.filter(e => e.aggregateId == aggregateId && @@ -36,10 +35,10 @@ export class InMemoryEventStorage implements IEventStorage { await nextCycle(); - return result; + yield* results; } - async getSagaEvents(sagaId, { beforeEvent }): Promise { + async *getSagaEvents(sagaId, { beforeEvent }): IEventStream { await nextCycle(); const results = this.#events.filter(e => @@ -49,20 +48,27 @@ export class InMemoryEventStorage implements IEventStorage { await nextCycle(); - return results; + yield* results; } - async* getEvents(eventTypes): IEventStream { + async* getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream { await nextCycle(); - for await (const event of this.#events) { - if (!eventTypes || eventTypes.includes(event.type)) + const lastEventId = options?.afterEvent?.id; + if (options?.afterEvent && !lastEventId) + throw new TypeError('options.afterEvent.id is required'); + + let offsetFound = !lastEventId; + for (const event of this.#events) { + if (!offsetFound) + offsetFound = event.id === lastEventId; + else if (!eventTypes || eventTypes.includes(event.type)) yield event; } } - getNewId(): number { + getNewId(): string { this.#nextId += 1; - return this.#nextId; + return String(this.#nextId); } } diff --git a/src/infrastructure/memory/InMemoryLock.ts b/src/infrastructure/memory/InMemoryLock.ts new file mode 100644 index 0000000..a8f2192 --- /dev/null +++ b/src/infrastructure/memory/InMemoryLock.ts @@ -0,0 +1,43 @@ +import { Deferred } from "./utils"; + +export class InMemoryLock { + + #lockMarker: Deferred | undefined; + + /** + * Indicates if lock is acquired + */ + get locked(): boolean { + return !!this.#lockMarker; + } + + /** + * Acquire the lock on the current instance. + * Resolves when the lock is successfully acquired + */ + async lock(): Promise { + while (this.locked) + await this.once('unlocked'); + + this.#lockMarker = new Deferred(); + } + + /** + * Release the lock acquired earlier + */ + async unlock(): Promise { + this.#lockMarker?.resolve(); + this.#lockMarker = undefined; + } + + /** + * Wait until the lock is released. + * Resolves immediately if the lock is not acquired + */ + once(event: 'unlocked'): Promise { + if (event !== 'unlocked') + throw new TypeError(`Unexpected event type: ${event}`); + + return this.#lockMarker?.promise ?? Promise.resolve(); + } +} diff --git a/src/infrastructure/InMemoryMessageBus.ts b/src/infrastructure/memory/InMemoryMessageBus.ts similarity index 99% rename from src/infrastructure/InMemoryMessageBus.ts rename to src/infrastructure/memory/InMemoryMessageBus.ts index c8f43f3..b14548e 100644 --- a/src/infrastructure/InMemoryMessageBus.ts +++ b/src/infrastructure/memory/InMemoryMessageBus.ts @@ -4,7 +4,7 @@ import { IMessageBus, IMessageHandler, IObservable -} from "../interfaces"; +} from "../../interfaces"; /** * Default implementation of the message bus. diff --git a/src/infrastructure/InMemorySnapshotStorage.ts b/src/infrastructure/memory/InMemorySnapshotStorage.ts similarity index 86% rename from src/infrastructure/InMemorySnapshotStorage.ts rename to src/infrastructure/memory/InMemorySnapshotStorage.ts index d3fd377..7943217 100644 --- a/src/infrastructure/InMemorySnapshotStorage.ts +++ b/src/infrastructure/memory/InMemorySnapshotStorage.ts @@ -1,4 +1,4 @@ -import { IAggregateSnapshotStorage, Identifier, IEvent } from "../interfaces"; +import { IAggregateSnapshotStorage, Identifier, IEvent } from "../../interfaces"; /** * In-memory storage for aggregate snapshots. @@ -11,7 +11,7 @@ export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { /** * Get latest aggregate snapshot */ - async getAggregateSnapshot(aggregateId: Identifier): Promise { + async getAggregateSnapshot(aggregateId: string): Promise { return this.#snapshots.get(aggregateId); } diff --git a/src/infrastructure/InMemoryView.ts b/src/infrastructure/memory/InMemoryView.ts similarity index 92% rename from src/infrastructure/InMemoryView.ts rename to src/infrastructure/memory/InMemoryView.ts index 20f528a..9fc90f7 100644 --- a/src/infrastructure/InMemoryView.ts +++ b/src/infrastructure/memory/InMemoryView.ts @@ -1,5 +1,5 @@ import { InMemoryLock } from './InMemoryLock'; -import { IProjectionView, Identifier } from "../interfaces"; +import { IViewLocker, Identifier, IObjectStorage } from "../../interfaces"; import { nextCycle } from './utils'; /** @@ -16,7 +16,7 @@ function applyUpdate(view: T | undefined, update: (r?: T) => T | undefined): /** * In-memory Projection View, which suspends get()'s until it is ready */ -export class InMemoryView implements IProjectionView { +export class InMemoryView implements IViewLocker, IObjectStorage { static factory(): TView { return (new InMemoryView() as unknown) as TView; @@ -26,8 +26,6 @@ export class InMemoryView implements IProjectionView { #lock: InMemoryLock; - #asyncWrites: boolean; - /** Whether the view is restored */ get ready(): boolean { return !this.#lock.locked; @@ -38,12 +36,7 @@ export class InMemoryView implements IProjectionView { return this._map.size; } - constructor(options?: { - /** Indicates if writes should be submitted asynchronously */ - asyncWrites?: boolean - }) { - this.#asyncWrites = options?.asyncWrites ?? false; - + constructor() { this.#lock = new InMemoryLock(); // explicitly bind the `get` method to this object for easier using in Promises @@ -131,9 +124,6 @@ export class InMemoryView implements IProjectionView { if (typeof value === 'function') throw new TypeError('value argument must be an instance of an Object'); - if (this.#asyncWrites) - await nextCycle(); - if (this._map.has(key)) throw new Error(`Key '${key}' already exists`); @@ -186,9 +176,6 @@ export class InMemoryView implements IProjectionView { if (updatedValue === undefined) return; - if (this.#asyncWrites) - await nextCycle(); - this._map.set(key, updatedValue); } @@ -197,9 +184,6 @@ export class InMemoryView implements IProjectionView { if (!key) throw new TypeError('key argument required'); - if (this.#asyncWrites) - await nextCycle(); - this._map.delete(key); } diff --git a/src/infrastructure/memory/index.ts b/src/infrastructure/memory/index.ts new file mode 100644 index 0000000..3f6f779 --- /dev/null +++ b/src/infrastructure/memory/index.ts @@ -0,0 +1,6 @@ +export * from './InMemoryEventStorage'; +export * from './InMemoryLock'; +export * from './InMemoryMessageBus'; +export * from './InMemorySnapshotStorage'; +export * from './InMemoryView'; +export * from './utils/Deferred'; diff --git a/src/infrastructure/utils/Deferred.ts b/src/infrastructure/memory/utils/Deferred.ts similarity index 100% rename from src/infrastructure/utils/Deferred.ts rename to src/infrastructure/memory/utils/Deferred.ts diff --git a/src/infrastructure/utils/index.ts b/src/infrastructure/memory/utils/index.ts similarity index 100% rename from src/infrastructure/utils/index.ts rename to src/infrastructure/memory/utils/index.ts diff --git a/src/infrastructure/utils/nextCycle.ts b/src/infrastructure/memory/utils/nextCycle.ts similarity index 100% rename from src/infrastructure/utils/nextCycle.ts rename to src/infrastructure/memory/utils/nextCycle.ts diff --git a/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts b/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts new file mode 100644 index 0000000..5c13f9a --- /dev/null +++ b/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts @@ -0,0 +1,27 @@ +import { AbstractProjection } from "../../AbstractProjection"; +import { IExtendableLogger } from "../../interfaces"; +import { SqliteDbParams } from "./commonParams"; +import { SqliteObjectView } from "./SqliteObjectView"; + +export abstract class AbstractSqliteObjectProjection extends AbstractProjection> { + + static get tableName(): string { + throw new Error('tableName is not defined'); + } + + static get schemaVersion(): string { + throw new Error('schemaVersion is not defined'); + } + + constructor({ viewModelSqliteDb, logger }: SqliteDbParams & { logger?: IExtendableLogger }) { + super({ logger }); + + this.view = new SqliteObjectView({ + schemaVersion: new.target.schemaVersion, + projectionName: new.target.name, + viewModelSqliteDb, + tableNamePrefix: new.target.tableName, + logger + }); + } +} diff --git a/src/infrastructure/sqlite/AbstractSqliteView.ts b/src/infrastructure/sqlite/AbstractSqliteView.ts new file mode 100644 index 0000000..224aa97 --- /dev/null +++ b/src/infrastructure/sqlite/AbstractSqliteView.ts @@ -0,0 +1,52 @@ +import { IEvent, IEventLocker, ILogger } from '../../interfaces'; +import { Database } from 'better-sqlite3'; +import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; +import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; +import { IViewLocker } from '../../interfaces'; + +export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { + + protected readonly db: Database; + protected readonly schemaVersion: string; + protected readonly viewLocker: SqliteViewLocker; + protected readonly eventLocker: SqliteEventLocker; + protected logger: ILogger | undefined; + + get ready(): boolean { + return this.viewLocker.ready; + } + + constructor(options: SqliteEventLockerParams & SqliteViewLockerParams) { + this.db = options.viewModelSqliteDb; + this.schemaVersion = options.schemaVersion; + this.viewLocker = new SqliteViewLocker(options); + this.eventLocker = new SqliteEventLocker(options); + this.logger = options.logger && 'child' in options.logger ? + options.logger.child({ serviceName: new.target.name }) : + options.logger; + } + + async lock() { + return this.viewLocker.lock(); + } + + unlock(): void { + this.viewLocker.unlock(); + } + + once(event: 'ready') { + return this.viewLocker.once(event); + } + + getLastEvent() { + return this.eventLocker.getLastEvent(); + } + + tryMarkAsProjecting(event: IEvent) { + return this.eventLocker.tryMarkAsProjecting(event); + } + + markAsProjected(event: IEvent) { + return this.eventLocker.markAsProjected(event); + } +} diff --git a/src/infrastructure/sqlite/SqliteEventLocker.ts b/src/infrastructure/sqlite/SqliteEventLocker.ts new file mode 100644 index 0000000..f99edcc --- /dev/null +++ b/src/infrastructure/sqlite/SqliteEventLocker.ts @@ -0,0 +1,131 @@ +import { Database, Statement } from 'better-sqlite3'; +import { IEvent, IEventLocker } from '../../interfaces'; +import { getEventId } from './utils'; +import { viewLockTableInit, eventLockTableInit } from './queries'; +import { SqliteViewLockerParams } from './SqliteViewLocker'; +import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; + +export type SqliteEventLockerParams = SqliteDbParams & SqliteProjectionDataParams & { + /** + * (Optional) SQLite table name where event locks are stored + * + * @default "tbl_event_lock" + */ + eventLockTableName?: string; + + /** + * (Optional) Time-to-live (TTL) duration in milliseconds + * for which an event remains in the "processing" state until released. + * + * @default 15_000 + */ + eventLockTtl?: number; +} + & Pick; + +export class SqliteEventLocker implements IEventLocker { + + #db: Database; + #projectionName: string; + #schemaVersion: string; + #viewLockTableName: string; + #eventLockTableName: string; + #eventLockTtl: number; + + #upsertLastEventQuery: Statement<[string, string, string], void>; + #getLastEventQuery: Statement<[string, string], { last_event: string }>; + #lockEventQuery: Statement<[string, string, Buffer], void>; + #finalizeEventLockQuery: Statement<[string, string, Buffer], void>; + + constructor(o: SqliteEventLockerParams) { + if (!o.viewModelSqliteDb) + throw new TypeError('viewModelSqliteDb argument required'); + if (!o.projectionName) + throw new TypeError('projectionName argument required'); + if (!o.schemaVersion) + throw new TypeError('schemaVersion argument required'); + + this.#db = o.viewModelSqliteDb; + this.#projectionName = o.projectionName; + this.#schemaVersion = o.schemaVersion; + this.#viewLockTableName = o.viewLockTableName ?? 'tbl_view_lock'; + this.#eventLockTableName = o.eventLockTableName ?? 'tbl_event_lock'; + this.#eventLockTtl = o.eventLockTtl ?? 15_000; + + this.#initialize(); + } + + #initialize() { + this.#db.exec(viewLockTableInit(this.#viewLockTableName)); + this.#db.exec(eventLockTableInit(this.#eventLockTableName)); + + this.#upsertLastEventQuery = this.#db.prepare(` + INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, last_event) + VALUES (?, ?, ?) + ON CONFLICT (projection_name, schema_version) + DO UPDATE SET + last_event = excluded.last_event + `); + + this.#getLastEventQuery = this.#db.prepare(` + SELECT + last_event + FROM ${this.#viewLockTableName} + WHERE + projection_name = ? + AND schema_version =? + `); + + this.#lockEventQuery = this.#db.prepare(` + INSERT INTO ${this.#eventLockTableName} (projection_name, schema_version, event_id) + VALUES (?, ?, ?) + ON CONFLICT (projection_name, schema_version, event_id) + DO UPDATE SET + processing_at = cast(strftime('%f', 'now') * 1000 as INTEGER) + WHERE + processed_at IS NULL + AND processing_at <= cast(strftime('%f', 'now') * 1000 as INTEGER) - ${this.#eventLockTtl} + `); + + this.#finalizeEventLockQuery = this.#db.prepare(` + UPDATE ${this.#eventLockTableName} + SET + processed_at = (cast(strftime('%f', 'now') * 1000 as INTEGER)) + WHERE + projection_name = ? + AND schema_version = ? + AND event_id = ? + AND processed_at IS NULL + `); + } + + tryMarkAsProjecting(event: IEvent) { + const eventId = getEventId(event); + + const r = this.#lockEventQuery.run(this.#projectionName, this.#schemaVersion, eventId); + + return r.changes !== 0; + } + + markAsProjected(event: IEvent) { + const eventId = getEventId(event); + + const transaction = this.#db.transaction(() => { + const updateResult = this.#finalizeEventLockQuery.run(this.#projectionName, this.#schemaVersion, eventId); + if (updateResult.changes === 0) + throw new Error(`Event ${event.id} could not be marked as processed`); + + this.#upsertLastEventQuery.run(this.#projectionName, this.#schemaVersion, JSON.stringify(event)); + }); + + transaction(); + } + + getLastEvent(): IEvent | undefined { + const viewInfoRecord = this.#getLastEventQuery.get(this.#projectionName, this.#schemaVersion); + if (!viewInfoRecord?.last_event) + return undefined; + + return JSON.parse(viewInfoRecord.last_event); + } +} diff --git a/src/infrastructure/sqlite/SqliteObjectStorage.ts b/src/infrastructure/sqlite/SqliteObjectStorage.ts new file mode 100644 index 0000000..83a7347 --- /dev/null +++ b/src/infrastructure/sqlite/SqliteObjectStorage.ts @@ -0,0 +1,110 @@ +import { Statement, Database } from 'better-sqlite3'; +import { guid } from './utils'; +import { IObjectStorage } from '../../interfaces'; + +export class SqliteObjectStorage implements IObjectStorage { + + #db: Database; + #tableName: string; + #getQuery: Statement<[Buffer], { data: string, version: number }>; + #insertQuery: Statement<[Buffer, string], void>; + #updateByIdAndVersionQuery: Statement<[string, Buffer, number], void>; + #deleteQuery: Statement<[Buffer], void>; + + constructor(o: { + viewModelSqliteDb: Database, + tableName: string + }) { + if (!o.viewModelSqliteDb) + throw new TypeError('viewModelSqliteDb argument required'); + if (!o.tableName) + throw new TypeError('tableName argument required'); + + this.#db = o.viewModelSqliteDb; + this.#tableName = o.tableName; + + this.#initialize(); + } + + #initialize(): void { + this.#db.exec(`CREATE TABLE IF NOT EXISTS ${this.#tableName} ( + id BLOB PRIMARY KEY, + version INTEGER DEFAULT 1, + data TEXT NOT NULL + );`); + + this.#getQuery = this.#db.prepare(` + SELECT data, version + FROM ${this.#tableName} + WHERE id = ? + `); + + this.#insertQuery = this.#db.prepare(` + INSERT INTO ${this.#tableName} (id, data) + VALUES (?, ?) + `); + + this.#updateByIdAndVersionQuery = this.#db.prepare(` + UPDATE ${this.#tableName} + SET + data = ?, + version = version + 1 + WHERE + id = ? + AND version = ? + `); + + this.#deleteQuery = this.#db.prepare(` + DELETE FROM ${this.#tableName} + WHERE id = ? + `); + } + + get(id: string): TRecord | undefined { + const r = this.#getQuery.get(guid(id)); + if (!r) + return undefined; + + return JSON.parse(r.data); + } + + create(id: string, data: TRecord) { + const r = this.#insertQuery.run(guid(id), JSON.stringify(data)); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be created`); + + } + + update(id: string, update: (r: TRecord) => TRecord) { + const gid = guid(id); + const record = this.#getQuery.get(gid); + if (!record) + throw new Error(`Record '${id}' does not exist`); + + const data = JSON.parse(record.data); + const updatedData = update(data); + const updatedJson = JSON.stringify(updatedData); + + // Version check is implemented to ensure the record isn't modified by another process. + // A conflict resolution strategy could potentially be passed as an option to this method, + // but for now, conflict resolution should happen outside this class. + const r = this.#updateByIdAndVersionQuery.run(updatedJson, gid, record.version); + if (r.changes !== 1) + throw new Error(`Record '${id}' could not be updated`); + } + + updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + // Due to better-sqlite3 sync nature, + // it's safe to get then modify within this process + const record = this.#getQuery.get(guid(id)); + if (record) + this.update(id, update); + else + this.create(id, update()); + } + + delete(id: string): boolean { + const r = this.#deleteQuery.run(guid(id)); + return r.changes === 1; + } +} diff --git a/src/infrastructure/sqlite/SqliteObjectView.ts b/src/infrastructure/sqlite/SqliteObjectView.ts new file mode 100644 index 0000000..e7956a3 --- /dev/null +++ b/src/infrastructure/sqlite/SqliteObjectView.ts @@ -0,0 +1,73 @@ +import { AbstractSqliteView } from "./AbstractSqliteView"; +import { IObjectStorage, IEventLocker } from '../../interfaces'; +import { SqliteObjectStorage } from './SqliteObjectStorage'; + +export class SqliteObjectView extends AbstractSqliteView implements IObjectStorage, IEventLocker { + + #sqliteObjectStorage: SqliteObjectStorage; + + constructor(options: ConstructorParameters[0] & { + tableNamePrefix: string + }) { + if (typeof options.tableNamePrefix !== 'string' || !options.tableNamePrefix.length) + throw new TypeError('tableNamePrefix argument must be a non-empty String'); + if (typeof options.schemaVersion !== 'string' || !options.schemaVersion.length) + throw new TypeError('schemaVersion argument must be a non-empty String'); + + super(options); + + this.#sqliteObjectStorage = new SqliteObjectStorage({ + viewModelSqliteDb: options.viewModelSqliteDb, + tableName: `${options.tableNamePrefix}_${options.schemaVersion}` + }); + } + + async get(id: string): Promise { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + if (!this.ready) + await this.once('ready'); + + return this.#sqliteObjectStorage.get(id); + } + + getSync(id: string) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + return this.#sqliteObjectStorage.get(id); + } + + create(id: string, data: TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + this.#sqliteObjectStorage.create(id, data); + } + + update(id: string, update: (r: TRecord) => TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + if (typeof update !== 'function') + throw new TypeError('update argument must be a Function'); + + this.#sqliteObjectStorage.update(id, update); + } + + updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + if (typeof update !== 'function') + throw new TypeError('update argument must be a Function'); + + this.#sqliteObjectStorage.updateEnforcingNew(id, update); + } + + delete(id: string): boolean { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + return this.#sqliteObjectStorage.delete(id); + } +} diff --git a/src/infrastructure/sqlite/SqliteViewLocker.ts b/src/infrastructure/sqlite/SqliteViewLocker.ts new file mode 100644 index 0000000..a6a09af --- /dev/null +++ b/src/infrastructure/sqlite/SqliteViewLocker.ts @@ -0,0 +1,173 @@ +import { Database, Statement } from 'better-sqlite3'; +import { IExtendableLogger, ILogger, IViewLocker } from '../../interfaces'; +import { Deferred } from '../memory'; +import { promisify } from 'util'; +import { viewLockTableInit } from './queries'; +import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; +const delay = promisify(setTimeout); + +export type SqliteViewLockerParams = SqliteDbParams & SqliteProjectionDataParams & { + /** + * (Optional) SQLite table name where event locks along with the latest event are stored + * + * @default "tbl_view_lock" + */ + viewLockTableName?: string; + + /** + * (Optional) Time-to-live (TTL) duration (in milliseconds) for which a view remains locked + * + * @default 120_000 + */ + viewLockTtl?: number; + + /** + * (Optional) Logger instance for logging operations, + * can be an IExtendableLogger (Winston) + * or ILogger (Console) + */ + logger?: IExtendableLogger | ILogger; +}; + +export class SqliteViewLocker implements IViewLocker { + + #db: Database; + #projectionName: string; + #schemaVersion: string; + + #viewLockTableName: string; + #viewLockTtl: number; + #logger: ILogger | undefined; + + #upsertTableLockQuery: Statement<[string, string, number], void>; + #updateTableLockQuery: Statement<[number, string, string], void>; + #removeTableLockQuery: Statement<[string, string], void>; + + #lockMarker: Deferred | undefined; + #lockProlongationTimeout: NodeJS.Timeout | undefined; + + constructor(o: SqliteViewLockerParams) { + if (!o.viewModelSqliteDb) + throw new TypeError('viewModelSqliteDb argument required'); + if (!o.projectionName) + throw new TypeError('projectionName argument required'); + if (!o.schemaVersion) + throw new TypeError('schemaVersion argument required'); + + this.#db = o.viewModelSqliteDb; + this.#projectionName = o.projectionName; + this.#schemaVersion = o.schemaVersion; + + this.#viewLockTableName = o.viewLockTableName ?? 'tbl_view_lock'; + this.#viewLockTtl = o.viewLockTtl ?? 120_000; + this.#logger = o.logger && 'child' in o.logger ? + o.logger.child({ service: this.constructor.name }) : + o.logger; + + this.#initialize(); + } + + #initialize() { + this.#db.exec(viewLockTableInit(this.#viewLockTableName)); + + this.#upsertTableLockQuery = this.#db.prepare(` + INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, locked_till) + VALUES (?, ?, ?) + ON CONFLICT (projection_name, schema_version) + DO UPDATE SET + locked_till = excluded.locked_till + WHERE + locked_till IS NULL + OR locked_till < excluded.locked_till + `); + + this.#updateTableLockQuery = this.#db.prepare(` + UPDATE ${this.#viewLockTableName} + SET + locked_till = ? + WHERE + projection_name = ? + AND schema_version = ? + AND locked_till IS NOT NULL + `); + + this.#removeTableLockQuery = this.#db.prepare(` + UPDATE ${this.#viewLockTableName} + SET + locked_till = NULL + WHERE + projection_name = ? + AND schema_version = ? + AND locked_till IS NOT NULL + `); + } + + get ready(): boolean { + return !this.#lockMarker; + } + + async lock() { + this.#lockMarker = new Deferred(); + + let lockAcquired = false; + while (!lockAcquired) { + const lockedTill = Date.now() + this.#viewLockTtl; + const upsertResult = this.#upsertTableLockQuery.run(this.#projectionName, this.#schemaVersion, lockedTill); + + lockAcquired = upsertResult.changes === 1; + if (!lockAcquired) { + this.#logger?.debug(`"${this.#projectionName}" is locked by another process`); + await delay(this.#viewLockTtl / 2); + } + } + + this.#logger?.debug(`"${this.#projectionName}" lock obtained for ${this.#viewLockTtl}s`); + + this.scheduleLockProlongation(); + + return true; + } + + private 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`); + } + + private cancelLockProlongation() { + clearTimeout(this.#lockProlongationTimeout); + this.#logger?.debug(`"${this.#projectionName}" lock refresh canceled`); + } + + private prolongLock() { + const lockedTill = Date.now() + this.#viewLockTtl; + const r = this.#updateTableLockQuery.run(lockedTill, this.#projectionName, this.#schemaVersion); + if (r.changes !== 1) + throw new Error(`"${this.#projectionName}" lock could not be prolonged`); + + this.#logger?.debug(`"${this.#projectionName}" lock prolonged for ${this.#viewLockTtl}s`); + } + + unlock() { + this.#lockMarker?.resolve(); + this.#lockMarker = undefined; + + this.cancelLockProlongation(); + + const updateResult = this.#removeTableLockQuery.run(this.#projectionName, this.#schemaVersion); + if (updateResult.changes === 1) + this.#logger?.debug(`"${this.#projectionName}" lock released`); + else + this.#logger?.warn(`"${this.#projectionName}" lock didn't exist`); + } + + once(event: 'ready'): Promise { + if (event !== 'ready') + throw new TypeError(`Unexpected event: ${event}`); + + return this.#lockMarker?.promise ?? Promise.resolve(); + } +} diff --git a/src/infrastructure/sqlite/commonParams.ts b/src/infrastructure/sqlite/commonParams.ts new file mode 100644 index 0000000..9b51c7a --- /dev/null +++ b/src/infrastructure/sqlite/commonParams.ts @@ -0,0 +1,22 @@ +import { Database } from 'better-sqlite3'; + +export type SqliteDbParams = { + /** Configured instance of better-sqlite3.Database */ + viewModelSqliteDb: Database; +}; + +export type SqliteProjectionDataParams = { + /** + * Unique identifier for the projection, used with the schema version to distinguish data ownership. + */ + projectionName: string; + + /** + * The version of the schema used for data produced by the projection. + * When the projection's output format changes, this version should be incremented. + * A version change indicates that previously stored data is obsolete and must be rebuilt. + * + * @example "20250519", "1.0.0" + */ + schemaVersion: string; +} diff --git a/src/infrastructure/sqlite/index.ts b/src/infrastructure/sqlite/index.ts new file mode 100644 index 0000000..3eaf404 --- /dev/null +++ b/src/infrastructure/sqlite/index.ts @@ -0,0 +1,6 @@ +export * from './AbstractSqliteView'; +export * from './SqliteEventLocker'; +export * from './SqliteObjectStorage'; +export * from './SqliteObjectView'; +export * from './SqliteViewLocker'; +export * from './utils'; diff --git a/src/infrastructure/sqlite/queries/eventLockTableInit.ts b/src/infrastructure/sqlite/queries/eventLockTableInit.ts new file mode 100644 index 0000000..31a6b95 --- /dev/null +++ b/src/infrastructure/sqlite/queries/eventLockTableInit.ts @@ -0,0 +1,10 @@ +export const eventLockTableInit = (eventLockTableName: string) => ` + CREATE TABLE IF NOT EXISTS ${eventLockTableName} ( + projection_name TEXT NOT NULL, + schema_version TEXT NOT NULL, + event_id BLOB NOT NULL, + processing_at INTEGER NOT NULL DEFAULT (cast(strftime('%f', 'now') * 1000 as INTEGER)), + processed_at INTEGER, + PRIMARY KEY (projection_name, schema_version, event_id) + ); +`; diff --git a/src/infrastructure/sqlite/queries/index.ts b/src/infrastructure/sqlite/queries/index.ts new file mode 100644 index 0000000..7edbb02 --- /dev/null +++ b/src/infrastructure/sqlite/queries/index.ts @@ -0,0 +1,2 @@ +export * from './eventLockTableInit'; +export * from './viewLockTableInit'; diff --git a/src/infrastructure/sqlite/queries/viewLockTableInit.ts b/src/infrastructure/sqlite/queries/viewLockTableInit.ts new file mode 100644 index 0000000..b3e707f --- /dev/null +++ b/src/infrastructure/sqlite/queries/viewLockTableInit.ts @@ -0,0 +1,9 @@ +export const viewLockTableInit = (viewLockTableName: string): string => ` + CREATE TABLE IF NOT EXISTS ${viewLockTableName} ( + projection_name TEXT NOT NULL, + schema_version TEXT NOT NULL, + locked_till INTEGER, + last_event TEXT, + PRIMARY KEY (projection_name, schema_version) + ); +`; diff --git a/src/infrastructure/sqlite/utils/getEventId.ts b/src/infrastructure/sqlite/utils/getEventId.ts new file mode 100644 index 0000000..62fc2ac --- /dev/null +++ b/src/infrastructure/sqlite/utils/getEventId.ts @@ -0,0 +1,8 @@ +import { IEvent } from "../../../interfaces"; +import * as md5 from 'md5'; +import { guid } from './guid'; + +/** + * Get assigned or generate new event ID from event content + */ +export const getEventId = (event: IEvent): Buffer => guid(event.id ?? md5(JSON.stringify(event))); diff --git a/src/infrastructure/sqlite/utils/guid.ts b/src/infrastructure/sqlite/utils/guid.ts new file mode 100644 index 0000000..e8ce86c --- /dev/null +++ b/src/infrastructure/sqlite/utils/guid.ts @@ -0,0 +1,4 @@ +/** + * Convert Guid to Buffer for storing in Sqlite BLOB + */ +export const guid = (str: string) => Buffer.from(str.replaceAll('-', ''), 'hex'); diff --git a/src/infrastructure/sqlite/utils/index.ts b/src/infrastructure/sqlite/utils/index.ts new file mode 100644 index 0000000..f27b49b --- /dev/null +++ b/src/infrastructure/sqlite/utils/index.ts @@ -0,0 +1,2 @@ +export * from './guid'; +export * from './getEventId'; diff --git a/src/interfaces.ts b/src/interfaces.ts deleted file mode 100644 index b55d4a9..0000000 --- a/src/interfaces.ts +++ /dev/null @@ -1,328 +0,0 @@ -export type Identifier = string | number; - -export interface IMessage { - /** Event or command type */ - type: string; - - aggregateId?: Identifier; - aggregateVersion?: number; - - sagaId?: Identifier; - sagaVersion?: number; - - payload?: TPayload; - context?: any; -} - -export type ICommand = IMessage; - -export type IEvent = IMessage & { - /** Unique event identifier */ - id?: string; -}; - -/** - * @deprecated Try to use `IEventStream` instead - */ -export type IEventSet = ReadonlyArray>; - -export type IEventStream = AsyncIterableIterator>; - - -/** - * Minimum aggregate interface, as it's used by default `AggregateCommandHandler` - */ -export interface IAggregate { - - /** Unique aggregate identifier */ - readonly id: Identifier; - - /** Main entry point for aggregate commands */ - handle(command: ICommand): void | Promise; - - /** List of events emitted by Aggregate as a result of handling command(s) */ - readonly changes: IEventSet; - - /** An indicator if aggregate snapshot should be taken */ - readonly shouldTakeSnapshot?: boolean; - - /** Take an aggregate state snapshot and add it to the changes queue */ - takeSnapshot(): void; -} - -export interface IMutableAggregateState { - // schemaVersion?: number; - // constructor: IAggregateStateConstructor; - mutate(event: IEvent): void; -} - -// export interface IAggregateStateConstructor extends Function { -// schemaVersion?: number; -// new(): IAggregateState; -// } - -export type IAggregateConstructorParams = { - /** Unique aggregate identifier */ - id: Identifier, - - /** Aggregate events, logged after latest snapshot */ - events?: IEventSet, - - /** Aggregate state instance */ - state?: TState -}; - -export interface IAggregateConstructor { - readonly handles?: string[]; - new(options: IAggregateConstructorParams): IAggregate; -} - -export type IAggregateFactory = - (options: IAggregateConstructorParams) => IAggregate; - -export interface ISaga { - /** Unique Saga ID */ - readonly id: Identifier; - - /** List of commands emitted by Saga */ - readonly uncommittedMessages: ICommand[]; - - /** Main entry point for Saga events */ - apply(event: IEvent): void | Promise; - - /** Reset emitted commands when they are not longer needed */ - resetUncommittedMessages(): void; - - onError?(error: Error, options: { event: IEvent, command: ICommand }): void; -} - -export type ISagaConstructorParams = { - id: Identifier, - events?: IEventSet -}; - -export type ISagaFactory = (options: ISagaConstructorParams) => ISaga; - -export interface ISagaConstructor { - new(options: ISagaConstructorParams): ISaga; - - /** List of event types that trigger new saga start */ - readonly startsWith: string[]; - - /** List of events being handled by Saga */ - readonly handles: string[]; -} - -export interface IMessageHandler { - (...args: any[]): any | Promise -}; - -export interface IObservable { - on(type: string, handler: IMessageHandler): void; - - off(type: string, handler: IMessageHandler): void; - - queue?(name: string): IObservable; -} - -export interface IObserver { - subscribe(observable: IObservable): void; -} - -/** Commands */ - -export interface ICommandBus extends IObservable { - send(commandType: string, aggregateId: Identifier, options: { payload?: object, context?: object }): - Promise; - - sendRaw(command: ICommand): - Promise; - - on(type: string, handler: IMessageHandler): void; -} - -export interface ICommandHandler extends IObserver { - subscribe(commandBus: ICommandBus): void; -} - -/** Events */ - -export type IEventQueryFilter = { - /** Get events emitted after this specific event */ - afterEvent?: IEvent; - - /** Get events emitted before this specific event */ - beforeEvent?: IEvent; -} - -export interface IEventStorage { - /** - * Create unique identifier - */ - getNewId(): Identifier | Promise; - - commitEvents(events: IEventSet): Promise; - - getEvents(eventTypes?: Readonly): IEventStream; - - getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise; - - getSagaEvents(sagaId: Identifier, options: Pick): Promise; -} - -export interface IEventStore extends IObservable { - readonly snapshotsSupported?: boolean; - - getNewId(): Identifier | Promise; - - commit(events: IEventSet): Promise; - - getAllEvents(eventTypes?: Readonly): IEventStream; - - getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise; - - getSagaEvents(sagaId: Identifier, options: Pick): Promise; - - once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; - - queue(name: string): IObservable; - - registerSagaStarters(startsWith: string[] | undefined): void; -} - -export interface IEventReceptor extends IObserver { - subscribe(eventStore: IEventStore): void; -} - -export interface IMessageBus extends IObservable { - send(command: ICommand): Promise; - publish(event: IEvent): Promise; -} - - -/** Projection */ - -export interface IProjection extends IObserver { - readonly view: TView; - - subscribe(eventStore: IEventStore): Promise; - - project(event: IEvent): Promise; -} - -export interface IProjectionConstructor { - new(c?: any): IProjection; - readonly handles?: string[]; -} - -// export type ProjectionViewFactoryParams = { -// schemaVersion: string, -// collectionName: string -// } - -export interface IViewFactory { - (): TView; -} - -export interface ILockable { - lock(): Promise; - unlock(): Promise; -} - -export interface ILockableWithIndication extends ILockable { - locked: Readonly; - once(event: 'unlocked'): Promise; -} - -export interface IProjectionView extends ILockable { - - /** - * Indicates if view is ready for new events projecting - */ - ready: boolean; - - /** - * Lock the view for external reads/writes - */ - lock(): Promise; - - /** - * Unlock external read/write operations - */ - unlock(): Promise; - - /** - * Wait till the view is ready to accept new events - */ - once(eventType: "ready"): Promise; -} - -export interface IPersistentView extends IProjectionView { - - /** - * Get last projected event - */ - getLastEvent(): Promise; - - /** - * Mark event as projecting to prevent its handling by another - * projection instance working with the same storage. - * - * @returns False value if event is already processing or processed - */ - tryMarkAsProjecting(event: IEvent): Promise; - - /** - * Mark event as projected - */ - markAsProjected(event: IEvent): Promise; -} - - -/** Snapshots */ - -type TSnapshot = { - /** - * Schema version of the data stored in `state` property. - * Snapshots with older schema versions must be passed thru a data migration before applying for a newer schema - */ - schemaVersion: string | number; - - /** - * Last event that was processed before making a snapshot - */ - lastEvent: IEvent; - - /** - * Snapshot data - */ - data: TPayload; -} - -interface ISnapshotStorage { - getSnapshot(id: Identifier): Promise; - saveSnapshot(id: Identifier, snapshot: TSnapshot): Promise; -} - -type ISnapshotEvent = IEvent>; - -export interface IAggregateSnapshotStorage { - getAggregateSnapshot(aggregateId: Identifier): Promise | undefined> | IEvent | undefined; - - saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; -} - - -/** Interfaces */ - -export interface ILogger { - log(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: { [key: string]: any }): void; - debug(message: string, meta?: { [key: string]: any }): void; - info(message: string, meta?: { [key: string]: any }): void; - warn(message: string, meta?: { [key: string]: any }): void; - error(message: string, meta?: { [key: string]: any }): void; -} - -export interface IExtendableLogger extends ILogger { - child(meta?: { [key: string]: any }): IExtendableLogger; -} diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts new file mode 100644 index 0000000..97aef7d --- /dev/null +++ b/src/interfaces/IAggregate.ts @@ -0,0 +1,56 @@ +import { ICommand } from "./ICommand"; +import { Identifier } from "./Identifier"; +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; + +/** + * Minimum aggregate interface, as it's used by default `AggregateCommandHandler` + */ +export interface IAggregate { + + /** Unique aggregate identifier */ + readonly id: Identifier; + + /** Main entry point for aggregate commands */ + handle(command: ICommand): void | Promise; + + /** List of events emitted by Aggregate as a result of handling command(s) */ + readonly changes: IEventSet; + + /** An indicator if aggregate snapshot should be taken */ + readonly shouldTakeSnapshot?: boolean; + + /** Take an aggregate state snapshot and add it to the changes queue */ + takeSnapshot(): void; +} + +export interface IMutableAggregateState { + // schemaVersion?: number; + // constructor: IAggregateStateConstructor; + mutate(event: IEvent): void; +} + +// export interface IAggregateStateConstructor extends Function { +// schemaVersion?: number; +// new(): IAggregateState; +// } + +export type IAggregateConstructorParams = { + /** Unique aggregate identifier */ + id: Identifier, + + /** Aggregate events, logged after latest snapshot */ + events?: IEventSet, + + /** Aggregate state instance */ + state?: TState +}; + +export interface IAggregateConstructor { + readonly handles: string[]; + new(options: IAggregateConstructorParams): IAggregate; +} + +export type IAggregateFactory = + (options: IAggregateConstructorParams) => IAggregate; + diff --git a/src/interfaces/IAggregateSnapshotStorage.ts b/src/interfaces/IAggregateSnapshotStorage.ts new file mode 100644 index 0000000..41c293d --- /dev/null +++ b/src/interfaces/IAggregateSnapshotStorage.ts @@ -0,0 +1,8 @@ +import { Identifier } from "./Identifier"; +import { IEvent } from "./IEvent"; + +export interface IAggregateSnapshotStorage { + getAggregateSnapshot(aggregateId: Identifier): Promise | undefined> | IEvent | undefined; + + saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; +} diff --git a/src/interfaces/ICommand.ts b/src/interfaces/ICommand.ts new file mode 100644 index 0000000..95b5a2b --- /dev/null +++ b/src/interfaces/ICommand.ts @@ -0,0 +1,3 @@ +import { IMessage } from "./IMessage"; + +export type ICommand = IMessage; diff --git a/src/interfaces/ICommandBus.ts b/src/interfaces/ICommandBus.ts new file mode 100644 index 0000000..87e2f59 --- /dev/null +++ b/src/interfaces/ICommandBus.ts @@ -0,0 +1,18 @@ +import { ICommand } from "./ICommand"; +import { IEventSet } from "./IEventSet"; +import { IMessageHandler, IObservable } from "./IObservable"; +import { IObserver } from "./IObserver"; + +export interface ICommandBus extends IObservable { + send(commandType: string, aggregateId: string, options: { payload?: object, context?: object }): + Promise; + + sendRaw(command: ICommand): + Promise; + + on(type: string, handler: IMessageHandler): void; +} + +export interface ICommandHandler extends IObserver { + subscribe(commandBus: ICommandBus): void; +} diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts new file mode 100644 index 0000000..4d54f07 --- /dev/null +++ b/src/interfaces/IEvent.ts @@ -0,0 +1,6 @@ +import { IMessage } from "./IMessage"; + +export type IEvent = IMessage & { + /** Unique event identifier */ + id?: string; +}; diff --git a/src/interfaces/IEventLocker.ts b/src/interfaces/IEventLocker.ts new file mode 100644 index 0000000..0d6c5a4 --- /dev/null +++ b/src/interfaces/IEventLocker.ts @@ -0,0 +1,34 @@ +import { IEvent } from "./IEvent"; +import { isObject } from "./isObject"; + +/** + * Interface for tracking event processing state to prevent concurrent processing + * by multiple processes. + */ +export interface IEventLocker { + + /** + * Retrieves the last projected event, + * allowing the projection state to be restored from subsequent events. + */ + getLastEvent(): Promise | IEvent | undefined; + + /** + * Marks an event as projecting to prevent it from being processed + * by another projection instance using the same storage. + * + * @returns `false` if the event is already being processed or has been processed. + */ + tryMarkAsProjecting(event: IEvent): Promise | boolean; + + /** + * Marks an event as projected. + */ + markAsProjected(event: IEvent): Promise | void; +} + +export const isEventLocker = (view: unknown): view is IEventLocker => + isObject(view) + && 'getLastEvent' in view + && 'tryMarkAsProjecting' in view + && 'markAsProjected' in view; diff --git a/src/interfaces/IEventReceptor.ts b/src/interfaces/IEventReceptor.ts new file mode 100644 index 0000000..6059e78 --- /dev/null +++ b/src/interfaces/IEventReceptor.ts @@ -0,0 +1,6 @@ +import { IEventStore } from "./IEventStore"; +import { IObserver } from "./IObserver"; + +export interface IEventReceptor extends IObserver { + subscribe(eventStore: IEventStore): void; +} diff --git a/src/interfaces/IEventSet.ts b/src/interfaces/IEventSet.ts new file mode 100644 index 0000000..fcde354 --- /dev/null +++ b/src/interfaces/IEventSet.ts @@ -0,0 +1,6 @@ +import { IEvent } from "./IEvent"; + +/** + * @deprecated Try to use `IEventStream` instead + */ +export type IEventSet = ReadonlyArray>; diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorage.ts new file mode 100644 index 0000000..cbd1cfe --- /dev/null +++ b/src/interfaces/IEventStorage.ts @@ -0,0 +1,29 @@ +import { Identifier } from "./Identifier"; +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; +import { IEventStream } from "./IEventStream"; + +export type EventQueryAfter = { + /** Get events emitted after this specific event */ + afterEvent?: IEvent; +} + +export type EventQueryBefore = { + /** Get events emitted before this specific event */ + beforeEvent?: IEvent; +} + +export interface IEventStorage { + /** + * Create unique identifier + */ + getNewId(): Identifier | Promise; + + commitEvents(events: IEventSet): Promise; + + getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; + + getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise | IEventStream; + + getSagaEvents(sagaId: Identifier, options: EventQueryBefore): Promise | IEventStream; +} diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts new file mode 100644 index 0000000..21954f6 --- /dev/null +++ b/src/interfaces/IEventStore.ts @@ -0,0 +1,26 @@ +import { Identifier } from "./Identifier"; +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; +import { EventQueryAfter, EventQueryBefore } from "./IEventStorage"; +import { IEventStream } from "./IEventStream"; +import { IMessageHandler, IObservable } from "./IObservable"; + +export interface IEventStore extends IObservable { + readonly snapshotsSupported?: boolean; + + getNewId(): Identifier | Promise; + + commit(events: IEventSet): Promise; + + getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; + + getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): IEventStream; + + getSagaEvents(sagaId: Identifier, options: EventQueryBefore): IEventStream; + + once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; + + queue(name: string): IObservable; + + registerSagaStarters(startsWith: string[] | undefined): void; +} diff --git a/src/interfaces/IEventStream.ts b/src/interfaces/IEventStream.ts new file mode 100644 index 0000000..f8c9337 --- /dev/null +++ b/src/interfaces/IEventStream.ts @@ -0,0 +1,3 @@ +import { IEvent } from "./IEvent"; + +export type IEventStream = AsyncIterableIterator>; diff --git a/src/interfaces/ILogger.ts b/src/interfaces/ILogger.ts new file mode 100644 index 0000000..329e738 --- /dev/null +++ b/src/interfaces/ILogger.ts @@ -0,0 +1,11 @@ +export interface ILogger { + log(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: { [key: string]: any }): void; + debug(message: string, meta?: { [key: string]: any }): void; + info(message: string, meta?: { [key: string]: any }): void; + warn(message: string, meta?: { [key: string]: any }): void; + error(message: string, meta?: { [key: string]: any }): void; +} + +export interface IExtendableLogger extends ILogger { + child(meta?: { [key: string]: any }): IExtendableLogger; +} diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts new file mode 100644 index 0000000..c40dc95 --- /dev/null +++ b/src/interfaces/IMessage.ts @@ -0,0 +1,15 @@ +import { Identifier } from "./Identifier"; + +export interface IMessage { + /** Event or command type */ + type: string; + + aggregateId?: Identifier; + aggregateVersion?: number; + + sagaId?: Identifier; + sagaVersion?: number; + + payload?: TPayload; + context?: any; +} diff --git a/src/interfaces/IMessageBus.ts b/src/interfaces/IMessageBus.ts new file mode 100644 index 0000000..c20af13 --- /dev/null +++ b/src/interfaces/IMessageBus.ts @@ -0,0 +1,8 @@ +import { ICommand } from "./ICommand"; +import { IEvent } from "./IEvent"; +import { IObservable } from "./IObservable"; + +export interface IMessageBus extends IObservable { + send(command: ICommand): Promise; + publish(event: IEvent): Promise; +} diff --git a/src/interfaces/IObjectStorage.ts b/src/interfaces/IObjectStorage.ts new file mode 100644 index 0000000..1207c37 --- /dev/null +++ b/src/interfaces/IObjectStorage.ts @@ -0,0 +1,13 @@ +import { Identifier } from "./Identifier"; + +export interface IObjectStorage { + get(id: Identifier): Promise | TRecord | undefined; + + create(id: Identifier, r: TRecord): Promise | any; + + update(id: Identifier, cb: (r: TRecord) => TRecord): Promise | any; + + updateEnforcingNew(id: Identifier, cb: (r?: TRecord) => TRecord): Promise | any; + + delete(id: Identifier): Promise | any; +} diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts new file mode 100644 index 0000000..dc824fd --- /dev/null +++ b/src/interfaces/IObservable.ts @@ -0,0 +1,20 @@ +export interface IMessageHandler { + (...args: any[]): any | Promise +}; + +export interface IObservable { + /** + * Setup a listener for a specific event type + */ + on(type: string, handler: IMessageHandler): void; + + /** + * Remove previously installed listener + */ + off(type: string, handler: IMessageHandler): void; + + /** + * Get or create a named queue, which delivers events to a single handler only + */ + queue?(name: string): IObservable; +} diff --git a/src/interfaces/IObserver.ts b/src/interfaces/IObserver.ts new file mode 100644 index 0000000..6f1365f --- /dev/null +++ b/src/interfaces/IObserver.ts @@ -0,0 +1,5 @@ +import { IObservable } from "./IObservable"; + +export interface IObserver { + subscribe(observable: IObservable): void; +} diff --git a/src/interfaces/IProjection.ts b/src/interfaces/IProjection.ts new file mode 100644 index 0000000..aaa6721 --- /dev/null +++ b/src/interfaces/IProjection.ts @@ -0,0 +1,20 @@ +import { IEvent } from "./IEvent"; +import { IEventStore } from "./IEventStore"; +import { IObserver } from "./IObserver"; + +export interface IProjection extends IObserver { + readonly view: TView; + + subscribe(eventStore: IEventStore): Promise; + + project(event: IEvent): Promise; +} + +export interface IProjectionConstructor { + new(c?: any): IProjection; + readonly handles?: string[]; +} + +export interface IViewFactory { + (options: { schemaVersion: string }): TView; +} diff --git a/src/interfaces/ISaga.ts b/src/interfaces/ISaga.ts new file mode 100644 index 0000000..8507ac1 --- /dev/null +++ b/src/interfaces/ISaga.ts @@ -0,0 +1,37 @@ +import { ICommand } from "./ICommand"; +import { Identifier } from "./Identifier"; +import { IEvent } from "./IEvent"; +import { IEventSet } from "./IEventSet"; + +export interface ISaga { + /** Unique Saga ID */ + readonly id: Identifier; + + /** List of commands emitted by Saga */ + readonly uncommittedMessages: ICommand[]; + + /** Main entry point for Saga events */ + apply(event: IEvent): void | Promise; + + /** Reset emitted commands when they are not longer needed */ + resetUncommittedMessages(): void; + + onError?(error: Error, options: { event: IEvent, command: ICommand }): void; +} + +export type ISagaConstructorParams = { + id: Identifier, + events?: IEventSet +}; + +export type ISagaFactory = (options: ISagaConstructorParams) => ISaga; + +export interface ISagaConstructor { + new(options: ISagaConstructorParams): ISaga; + + /** List of event types that trigger new saga start */ + readonly startsWith: string[]; + + /** List of events being handled by Saga */ + readonly handles: string[]; +} diff --git a/src/interfaces/IViewLocker.ts b/src/interfaces/IViewLocker.ts new file mode 100644 index 0000000..238479d --- /dev/null +++ b/src/interfaces/IViewLocker.ts @@ -0,0 +1,46 @@ +import { isObject } from "./isObject"; + +/** + * Interface for managing view restoration state to prevent early access to an inconsistent view + * or concurrent restoration by another process. + */ +export interface IViewLocker { + + /** + * Indicates whether the view is fully restored and ready to accept new event projections. + */ + ready: boolean; + + /** + * Locks the view to prevent external read/write operations. + * + * @returns `true` if the lock is successfully acquired, `false` otherwise. + */ + lock(): Promise | boolean; + + /** + * Unlocks the view, allowing external read/write operations to resume. + */ + unlock(): Promise | void; + + /** + * Waits until the view is fully restored and ready to accept new events. + * + * @param eventType The event type to listen for (`"ready"`). + * @returns A promise that resolves when the view is ready. + */ + once(eventType: "ready"): Promise; +} + +/** + * Checks if a given object conforms to the `IViewLocker` interface. + * + * @param view The object to check. + * @returns `true` if the object implements `IViewLocker`, `false` otherwise. + */ +export const isViewLocker = (view: unknown): view is IViewLocker => + isObject(view) + && 'ready' in view + && 'lock' in view + && 'unlock' in view + && 'once' in view; diff --git a/src/interfaces/Identifier.ts b/src/interfaces/Identifier.ts new file mode 100644 index 0000000..f31f1fb --- /dev/null +++ b/src/interfaces/Identifier.ts @@ -0,0 +1 @@ +export type Identifier = string | number; diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts new file mode 100644 index 0000000..b81c515 --- /dev/null +++ b/src/interfaces/index.ts @@ -0,0 +1,21 @@ +export * from './IAggregate'; +export * from './IAggregateSnapshotStorage'; +export * from './ICommand'; +export * from './ICommandBus'; +export * from './Identifier'; +export * from './IEvent'; +export * from './IEventLocker'; +export * from './IEventReceptor'; +export * from './IEventSet'; +export * from './IEventStorage'; +export * from './IEventStore'; +export * from './IEventStream'; +export * from './ILogger'; +export * from './IMessage'; +export * from './IMessageBus'; +export * from './IObjectStorage'; +export * from './IObservable'; +export * from './IObserver'; +export * from './IProjection'; +export * from './ISaga'; +export * from './IViewLocker'; diff --git a/src/interfaces/isObject.ts b/src/interfaces/isObject.ts new file mode 100644 index 0000000..8c26dac --- /dev/null +++ b/src/interfaces/isObject.ts @@ -0,0 +1,5 @@ +export const isObject = (obj: unknown): obj is {} => + typeof obj === 'object' + && obj !== null + && !(obj instanceof Date) + && !Array.isArray(obj); diff --git a/src/utils/CompoundEmitter.ts b/src/utils/CompoundEmitter.ts new file mode 100644 index 0000000..3e2c2a5 --- /dev/null +++ b/src/utils/CompoundEmitter.ts @@ -0,0 +1,45 @@ +import { IObservable, IMessageHandler } from "../interfaces"; +import { isIObservable } from "./isIObservable"; + +interface IObservableQueueProvider extends Required> { } + +const isObservableQueueProvider = (obj: any): obj is IObservableQueueProvider => + obj + && 'queue' in obj + && typeof obj.queue === 'function'; + +export class CompoundEmitter implements IObservable { + + #emitters: IObservable[]; + #queueProvider?: IObservableQueueProvider; + + constructor(...emitters: any[]) { + const observableEmitters = emitters.filter(isIObservable); + if (!observableEmitters.length) + throw new TypeError('none of the arguments implement IObservable interface'); + + const queueProviders = emitters.filter(isObservableQueueProvider); + if (queueProviders.length > 1) + throw new TypeError('more than one argument implements IObservable `queue` method'); + + this.#emitters = observableEmitters; + this.#queueProvider = queueProviders[0]; + } + + on(type: string, handler: IMessageHandler): void { + for (const emitter of this.#emitters) + emitter.on(type, handler); + } + + off(type: string, handler: IMessageHandler): void { + for (const emitter of this.#emitters) + emitter.off(type, handler); + } + + queue(name: string): IObservable { + if (!this.#queueProvider) + throw new Error('none of the emitters support named queues'); + + return this.#queueProvider.queue(name); + } +} diff --git a/src/utils/getHandledMessageTypes.ts b/src/utils/getHandledMessageTypes.ts deleted file mode 100644 index 8d910ec..0000000 --- a/src/utils/getHandledMessageTypes.ts +++ /dev/null @@ -1,20 +0,0 @@ -import { getMessageHandlerNames } from './getMessageHandlerNames'; - -/** - * Get a list of message types handled by observer - */ -export function getHandledMessageTypes( - observerInstanceOrClass: (object | Function) & { handles?: string[] } -): string[] { - if (!observerInstanceOrClass) - throw new TypeError('observerInstanceOrClass argument required'); - - if (observerInstanceOrClass.handles) - return observerInstanceOrClass.handles; - - const prototype = Object.getPrototypeOf(observerInstanceOrClass); - if (prototype && prototype.constructor && prototype.constructor.handles) - return prototype.constructor.handles; - - return getMessageHandlerNames(observerInstanceOrClass); -} diff --git a/src/utils/getMessageHandlerNames.ts b/src/utils/getMessageHandlerNames.ts index 1c8eb1a..a9342ce 100644 --- a/src/utils/getMessageHandlerNames.ts +++ b/src/utils/getMessageHandlerNames.ts @@ -1,7 +1,3 @@ -const KNOWN_METHOD_NAMES = new Set([ - 'subscribe' -]); - function getInheritedPropertyNames(prototype: object): string[] { const parentPrototype = prototype && Object.getPrototypeOf(prototype); if (!parentPrototype) @@ -31,14 +27,12 @@ export function getMessageHandlerNames(observerInstanceOrClass: (object | Functi if (!prototype) throw new TypeError('prototype cannot be resolved'); - const inheritedProperties = new Set(getInheritedPropertyNames(prototype)); - + const inheritedProperties = getInheritedPropertyNames(prototype); const propDescriptors = Object.getOwnPropertyDescriptors(prototype); const propNames = Object.keys(propDescriptors); return propNames.filter(key => !key.startsWith('_') && - !inheritedProperties.has(key) && - !KNOWN_METHOD_NAMES.has(key) && + !inheritedProperties.includes(key) && typeof propDescriptors[key].value === 'function'); } diff --git a/src/utils/index.ts b/src/utils/index.ts index d95765f..560c457 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,8 +1,12 @@ +export * from './CompoundEmitter'; export * from './getClassName'; export * from './getHandler'; -export * from './validateHandlers'; export * from './getMessageHandlerNames'; -export * from './getHandledMessageTypes'; +export * from './isClass'; +export * from './isIEventStorage'; +export * from './isIMessageBus'; +export * from './isIObservable'; +export * from './iteratorToArray'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; -export * from './isClass'; +export * from './validateHandlers'; diff --git a/src/utils/isIEventStorage.ts b/src/utils/isIEventStorage.ts new file mode 100644 index 0000000..bbe7cf2 --- /dev/null +++ b/src/utils/isIEventStorage.ts @@ -0,0 +1,8 @@ +import { IEventStorage } from "../interfaces"; + +export const isIEventStorage = (storage: IEventStorage): storage is IEventStorage => storage + && typeof storage.getNewId === 'function' + && typeof storage.commitEvents === 'function' + && typeof storage.getEventsByTypes === 'function' + && typeof storage.getAggregateEvents === 'function' + && typeof storage.getSagaEvents === 'function'; diff --git a/src/utils/isIMessageBus.ts b/src/utils/isIMessageBus.ts new file mode 100644 index 0000000..4a47228 --- /dev/null +++ b/src/utils/isIMessageBus.ts @@ -0,0 +1,9 @@ +import { IMessageBus } from "../interfaces"; +import { isIObservable } from "."; + +export const isIMessageBus = (bus: IMessageBus | any): bus is IMessageBus => bus + && isIObservable(bus) + && 'send' in bus + && typeof bus.send === 'function' + && 'publish' in bus + && typeof bus.publish === 'function'; diff --git a/src/utils/isIObservable.ts b/src/utils/isIObservable.ts new file mode 100644 index 0000000..191627c --- /dev/null +++ b/src/utils/isIObservable.ts @@ -0,0 +1,7 @@ +import { IObservable } from "../interfaces"; + +export const isIObservable = (obj: IObservable | any): obj is IObservable => obj + && 'on' in obj + && typeof obj.on === 'function' + && 'off' in obj + && typeof obj.off === 'function'; diff --git a/src/utils/iteratorToArray.ts b/src/utils/iteratorToArray.ts new file mode 100644 index 0000000..9530201 --- /dev/null +++ b/src/utils/iteratorToArray.ts @@ -0,0 +1,6 @@ +export async function iteratorToArray(input: AsyncIterable | Iterable): Promise { + const result: T[] = []; + for await (const item of input) + result.push(item); + return result; +} diff --git a/src/utils/subscribe.ts b/src/utils/subscribe.ts index af09aca..28982b9 100644 --- a/src/utils/subscribe.ts +++ b/src/utils/subscribe.ts @@ -1,9 +1,23 @@ import { IMessageHandler, IObservable } from "../interfaces"; import { getHandler } from './getHandler'; -import { getHandledMessageTypes } from './getHandledMessageTypes'; +import { getMessageHandlerNames } from "./getMessageHandlerNames"; const unique = (arr: T[]): T[] => [...new Set(arr)]; +/** + * Get a list of message types handled by observer + */ +export function getHandledMessageTypes(observerInstanceOrClass: (object | Function)): string[] { + if (!observerInstanceOrClass) + throw new TypeError('observerInstanceOrClass argument required'); + + const prototype = Object.getPrototypeOf(observerInstanceOrClass); + if (prototype && prototype.constructor && prototype.constructor.handles) + return prototype.constructor.handles; + + return getMessageHandlerNames(observerInstanceOrClass); +} + /** * Subscribe observer to observable */ @@ -35,11 +49,11 @@ export function subscribe( for (const messageType of unique(subscribeTo)) { const handler = masterHandler || getHandler(observer, messageType); - if (!handler) + if (!handler) throw new Error(`'${messageType}' handler is not defined or not a function`); if (queueName) { - if(!observable.queue) + if (!observable.queue) throw new TypeError('Observer does not support named queues'); observable.queue(queueName).on(messageType, handler); diff --git a/tests/integration/SqliteView.test.ts b/tests/integration/SqliteView.test.ts new file mode 100644 index 0000000..c84797d --- /dev/null +++ b/tests/integration/SqliteView.test.ts @@ -0,0 +1,127 @@ + +import { existsSync, unlinkSync } from 'fs'; +import { AbstractProjection, IEvent } from '../../src'; +import { SqliteObjectView } from '../../src/infrastructure/sqlite'; +import * as createDb from 'better-sqlite3'; + +type UserPayload = { + name: string; +} + +class MyDumbProjection extends AbstractProjection> { + + async userCreated(e: IEvent) { + if (typeof e.aggregateId !== 'string') + throw new TypeError('e.aggregateId is required'); + if (!e.payload) + throw new TypeError('e.payload is required'); + + await this.view.create(e.aggregateId, e.payload); + } + + async userModified(e: IEvent) { + if (typeof e.aggregateId !== 'string') + throw new TypeError('e.aggregateId is required'); + if (!e.payload) + throw new TypeError('e.payload is required'); + + await this.view.update(e.aggregateId, u => e.payload); + } +} + + +describe.only('SqliteView', () => { + + let viewModelSqliteDb: import('better-sqlite3').Database; + + const logState = () => { + console.log({ + tbl_view_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock`).all(), + tbl_test_1_event_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1_event_lock`).all(), + tbl_test_1: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1`).all() + }); + } + + const fileName = './test.sqlite'; + + beforeEach(() => { + viewModelSqliteDb = createDb(fileName); + + // Write-Ahead Logging (WAL) mode allows reads and writes to happen concurrently and reduces contention + // on the database. It keeps changes in a separate log file before they are flushed to the main database file + viewModelSqliteDb.pragma('journal_mode = WAL'); + + // The synchronous pragma controls how often SQLite synchronizes writes to the filesystem. Lowering this can + // boost performance but increases the risk of data loss in the event of a crash. + viewModelSqliteDb.pragma('synchronous = NORMAL'); + + // Limit WAL journal size to 5MB to manage disk usage in high-write scenarios. + // With WAL mode and NORMAL sync, this helps prevent excessive file growth during transactions. + viewModelSqliteDb.pragma(`journal_size_limit = ${5 * 1024 * 1024}`); + }); + + afterEach(() => { + if (viewModelSqliteDb) + viewModelSqliteDb.close(); + if (existsSync(fileName)) + unlinkSync(fileName); + }); + + // project 10_000 events (5_000 create new, 5_000 read, update, put back) + // in memory - 113 ms (88_500 events/second) + // on file system - 44_396 ms (225 events/second) + // on file system with WAL and NORMAL sync - 551 ms (18_148 events/second) + + it('handles 10_000 events within 0.5 seconds', async () => { + + const p = new MyDumbProjection({ + view: new SqliteObjectView({ + schemaVersion: '1', + viewModelSqliteDb, + projectionName: 'tbl_test', + tableNamePrefix: 'tbl_test' + }) + }); + + await p.view.lock(); + await p.view.unlock(); + + const aggregateIds = Array.from({ length: 5_000 }, (v, i) => ({ + id1: `${i}A`, + id2: `${i}B`, + id3: `${i}C` + })); + + console.time(); + + for (const { id1: aggregateId, id2, id3 } of aggregateIds) { + await p.project({ + type: 'userCreated', + id: id2, + aggregateId, + payload: { + name: 'Jon' + } + }); + + await p.project({ + type: 'userModified', + id: id3, + aggregateId, + payload: { + name: 'Jon Doe' + } + }); + } + + console.timeEnd(); + + // logState(); + + // const user = await p.view.get(aggregateId); + + // expect(user).toEqual({ + // name: 'Jon Doe' + // }); + }); +}); diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index f5cff80..4abada0 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -2,7 +2,7 @@ import { expect, assert, AssertionError } from 'chai'; import * as sinon from 'sinon'; import { AbstractProjection, InMemoryView, InMemoryEventStorage, EventStore, InMemoryMessageBus } from '../../src'; -class MyProjection extends AbstractProjection { +class MyProjection extends AbstractProjection> { static get handles() { return ['somethingHappened']; } @@ -21,20 +21,19 @@ class MyProjection extends AbstractProjection { describe('AbstractProjection', function () { - let projection; + let projection: MyProjection; + let view: InMemoryView; beforeEach(() => { - projection = new MyProjection(); + view = new InMemoryView(); + projection = new MyProjection({ view }); }); describe('view', () => { it('returns a view storage associated with projection', () => { - const view = new InMemoryView(); - const proj = new MyProjection({ view }); - - expect(proj.view).to.equal(view); + expect(projection).to.have.property('view').that.is.equal(view); }); }); @@ -44,7 +43,7 @@ describe('AbstractProjection', function () { beforeEach(() => { observable = { - getAllEvents() { + getEventsByTypes() { return []; }, on() { } @@ -54,7 +53,7 @@ describe('AbstractProjection', function () { it('subscribes to all handlers defined', () => { - class ProjectionWithoutHandles extends AbstractProjection { + class ProjectionWithoutHandles extends AbstractProjection { somethingHappened() { } somethingHappened2() { } } @@ -68,7 +67,7 @@ describe('AbstractProjection', function () { it('ignores overridden projection methods', () => { - class ProjectionWithoutHandles extends AbstractProjection { + class ProjectionWithoutHandles extends AbstractProjection { somethingHappened() { } /** overridden projection method */ @@ -85,7 +84,7 @@ describe('AbstractProjection', function () { it('subscribes projection to all events returned by "handles"', () => { - class ProjectionWithHandles extends AbstractProjection { + class ProjectionWithHandles extends AbstractProjection { static get handles() { return ['somethingHappened2']; } @@ -106,24 +105,24 @@ describe('AbstractProjection', function () { beforeEach(() => { es = { - async* getAllEvents() { + async* getEventsByTypes() { yield { type: 'somethingHappened', aggregateId: 1, aggregateVersion: 1 }; yield { type: 'somethingHappened', aggregateId: 1, aggregateVersion: 2 }; yield { type: 'somethingHappened', aggregateId: 2, aggregateVersion: 1 }; } }; - sinon.spy(es, 'getAllEvents'); + sinon.spy(es, 'getEventsByTypes'); return projection.restore(es); }); it('queries events of specific types from event store', () => { - assert(es.getAllEvents.calledOnce, 'es.getAllEvents was not called'); + assert(es.getEventsByTypes.calledOnce, 'es.getEventsByTypes was not called'); - const { args } = es.getAllEvents.lastCall; + const { args } = es.getEventsByTypes.lastCall; - expect(args).to.have.length(1); + expect(args).to.have.length(2); expect(args[0]).to.deep.eq(MyProjection.handles); }); @@ -143,7 +142,7 @@ describe('AbstractProjection', function () { it('throws, if projection error encountered', () => { es = { - async* getAllEvents() { + async* getEventsByTypes() { yield { type: 'unexpectedEvent' }; } }; @@ -163,8 +162,8 @@ describe('AbstractProjection', function () { it('waits until the restoring process is done', async () => { const storage = new InMemoryEventStorage(); - const messageBus = new InMemoryMessageBus(); - const es = new EventStore({ storage, messageBus }); + const supplementaryEventBus = new InMemoryMessageBus(); + const es = new EventStore({ storage, supplementaryEventBus }); let restored = false; let projected = false; diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index 28698e0..76bd7ec 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -9,7 +9,6 @@ import { EventStore, InMemorySnapshotStorage } from '../../src'; -import { getHandledMessageTypes } from '../../src/utils'; function delay(ms) { return new Promise(resolve => setTimeout(resolve, ms)); @@ -48,18 +47,18 @@ describe('AggregateCommandHandler', function () { let snapshotStorage: InMemorySnapshotStorage; let eventStore: IEventStore; let commandBus: ICommandBus; - let messageBus: IMessageBus; + let supplementaryEventBus: IMessageBus; let onSpy; let getNewIdSpy; let getAggregateEventsSpy; let commitSpy; beforeEach(() => { - messageBus = new InMemoryMessageBus(); + supplementaryEventBus = new InMemoryMessageBus(); storage = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); - eventStore = new EventStore({ storage, snapshotStorage, messageBus }); + eventStore = new EventStore({ storage, snapshotStorage, supplementaryEventBus }); getNewIdSpy = sinon.spy(eventStore, 'getNewId'); getAggregateEventsSpy = sinon.spy(eventStore, 'getAggregateEvents'); commitSpy = sinon.spy(eventStore, 'commit'); @@ -123,7 +122,7 @@ describe('AggregateCommandHandler', function () { const handler = new AggregateCommandHandler({ eventStore, aggregateFactory: () => aggregate, - handles: getHandledMessageTypes(aggregate) + handles: MyAggregate.handles }); await handler.execute({ type: 'doSomething', payload: 'test' }); @@ -191,7 +190,7 @@ describe('AggregateCommandHandler', function () { const handler = new AggregateCommandHandler({ eventStore, aggregateFactory: () => aggregate, - handles: getHandledMessageTypes(aggregate) + handles: MyAggregate.handles }); // test diff --git a/tests/unit/CommandBus.test.ts b/tests/unit/CommandBus.test.ts index d763a40..3181ec3 100644 --- a/tests/unit/CommandBus.test.ts +++ b/tests/unit/CommandBus.test.ts @@ -1,7 +1,6 @@ import { expect } from 'chai'; import * as sinon from 'sinon'; -import { InMemoryMessageBus } from '../../src/infrastructure/InMemoryMessageBus'; -import { CommandBus } from '../../src/CommandBus'; +import { InMemoryMessageBus, CommandBus } from '../../src'; describe('CommandBus', function () { diff --git a/tests/unit/CqrsContainerBuilder.test.ts b/tests/unit/CqrsContainerBuilder.test.ts index ca3b63b..2a83b92 100644 --- a/tests/unit/CqrsContainerBuilder.test.ts +++ b/tests/unit/CqrsContainerBuilder.test.ts @@ -11,12 +11,12 @@ import { describe('CqrsContainerBuilder', function () { - let builder; + let builder: ContainerBuilder; beforeEach(() => { builder = new ContainerBuilder(); builder.register(InMemoryEventStorage).as('storage'); - builder.register(InMemoryMessageBus).as('messageBus'); + builder.register(InMemoryMessageBus).as('supplementaryEventBus'); }); describe('registerAggregate(aggregateType) extension', () => { @@ -87,7 +87,7 @@ describe('CqrsContainerBuilder', function () { describe('registerProjection(typeOrFactory, exposedViewName) extension', () => { - class MyProjection extends AbstractProjection { + class MyProjection extends AbstractProjection { static get handles() { return ['somethingHappened']; } diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index b0a2ef5..5113df0 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -1,10 +1,9 @@ import { expect } from 'chai'; import * as sinon from 'sinon'; import { EventStore } from '../../src/EventStore'; -import { InMemoryEventStorage } from '../../src/infrastructure/InMemoryEventStorage'; -import { InMemorySnapshotStorage } from '../../src/infrastructure/InMemorySnapshotStorage'; -import { InMemoryMessageBus } from '../../src/infrastructure/InMemoryMessageBus'; -import { IAggregateSnapshotStorage, IEvent, IEventStorage, IEventStore, IEventSet, IMessageBus } from '../../src/interfaces'; +import { InMemoryEventStorage, InMemorySnapshotStorage, InMemoryMessageBus } from '../../src'; +import { IAggregateSnapshotStorage, IEvent, IEventStorage, IEventStore, IMessageBus } from '../../src/interfaces'; +import { iteratorToArray } from '../../src/utils'; const goodContext = { uid: '1', @@ -40,13 +39,13 @@ describe('EventStore', function () { let es: IEventStore; let storage: IEventStorage; let snapshotStorage: IAggregateSnapshotStorage; - let messageBus: IMessageBus; + let supplementaryEventBus: IMessageBus; beforeEach(() => { storage = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); - messageBus = new InMemoryMessageBus(); - es = new EventStore({ storage, snapshotStorage, messageBus }); + supplementaryEventBus = new InMemoryMessageBus(); + es = new EventStore({ storage, snapshotStorage, supplementaryEventBus }); }); describe('validator', () => { @@ -54,7 +53,7 @@ describe('EventStore', function () { it('allows to validate events before they are committed', () => { const events = [ - { type: 'somethingHappened', aggregateId: 1 } + { type: 'somethingHappened', aggregateId: '1' } ]; return es.commit(events).then(() => { @@ -64,7 +63,7 @@ describe('EventStore', function () { eventValidator: event => { throw new Error('test validation error'); }, - messageBus + supplementaryEventBus }); return es.commit(events).then(() => { @@ -99,7 +98,7 @@ describe('EventStore', function () { await es.commit([goodEvent]); const events: IEvent[] = []; - for await (const e of es.getAllEvents()) + for await (const e of es.getEventsByTypes(['somethingHappened'], {})) events.push(e); expect(events[0]).to.have.property('type', 'somethingHappened'); @@ -154,7 +153,7 @@ describe('EventStore', function () { } }); - es = new EventStore({ storage, messageBus }); + es = new EventStore({ storage, supplementaryEventBus }); return es.commit([goodEvent, goodEvent2]).then(() => { throw new Error('should fail'); @@ -163,33 +162,12 @@ describe('EventStore', function () { expect(err).to.have.property('message', 'storage commit failure'); }); }); - - it('emits events asynchronously after processing is done', function (done) { - - let committed = 0; - let emitted = 0; - - es.on('somethingHappened', function (event) { - - expect(committed).to.not.equal(0); - expect(emitted).to.equal(0); - emitted++; - - expect(event).to.have.property('type', 'somethingHappened'); - expect(event).to.have.property('context'); - expect(event.context).to.have.property('ip', goodContext.ip); - - done(); - }); - - es.commit([goodEvent]).then(() => committed++).catch(done); - }); }); describe('getNewId', () => { it('retrieves a unique ID for new aggregate from storage', () => Promise.resolve(es.getNewId()).then(id => { - expect(id).to.equal(1); + expect(id).to.equal('1'); })); }); @@ -199,11 +177,12 @@ describe('EventStore', function () { await es.commit([goodEvent, goodEvent2]); - const events = await es.getAggregateEvents(goodEvent.aggregateId); + const events = es.getAggregateEvents(goodEvent.aggregateId); - expect(events).to.be.an('Array'); - expect(events).to.have.length(1); - expect(events).to.have.nested.property('[0].type', 'somethingHappened'); + expect(events).to.be.have.property(Symbol.asyncIterator); + + const event = (await events.next()).value; + expect(event).to.have.nested.property('type', 'somethingHappened'); }); it('tries to retrieve aggregate snapshot', async () => { @@ -215,7 +194,7 @@ describe('EventStore', function () { expect(es).to.have.property('snapshotsSupported', true); - const events = await es.getAggregateEvents(goodEvent2.aggregateId); + const events = await iteratorToArray(es.getAggregateEvents(goodEvent2.aggregateId)); expect(snapshotStorage).to.have.nested.property('getAggregateSnapshot.calledOnce', true); expect(storage).to.have.nested.property('getAggregateEvents.calledOnce', true); @@ -231,33 +210,33 @@ describe('EventStore', function () { describe('getSagaEvents(sagaId, options)', () => { - it('returns events committed by saga prior to event that triggered saga execution', () => { + it('returns events committed by saga prior to event that triggered saga execution', async () => { const events = [ - { sagaId: 1, sagaVersion: 1, type: 'somethingHappened' }, - { sagaId: 1, sagaVersion: 2, type: 'anotherHappened' }, - { sagaId: 2, sagaVersion: 1, type: 'somethingHappened' } + { sagaId: '1', sagaVersion: 1, type: 'somethingHappened' }, + { sagaId: '1', sagaVersion: 2, type: 'anotherHappened' }, + { sagaId: '2', sagaVersion: 1, type: 'somethingHappened' } ]; const triggeredBy = events[1]; - return es.commit(events).then(() => es.getSagaEvents(1, { beforeEvent: triggeredBy }).then(events => { + await es.commit(events); - expect(events).to.be.an('Array'); - expect(events).to.have.length(1); - expect(events).to.have.nested.property('[0].type', 'somethingHappened'); - })); + const ii = es.getSagaEvents('1', { beforeEvent: triggeredBy }); + const retrievedEvents = await iteratorToArray(ii); + + expect(retrievedEvents).to.be.an('Array'); + expect(retrievedEvents).to.have.length(1); + expect(retrievedEvents).to.have.nested.property('[0].type', 'somethingHappened'); }); }); - describe('getAllEvents(eventTypes)', () => { + describe('getEventsByTypes(eventTypes)', () => { it('returns a promise that resolves to all committed events of specific types', async () => { await es.commit([goodEvent, goodEvent2]); - const events: IEvent[] = []; - for await (const e of es.getAllEvents(['somethingHappened'])) - events.push(e); + const events = await iteratorToArray(es.getEventsByTypes(['somethingHappened'], {})); expect(events).to.have.length(2); expect(events).to.have.nested.property('[0].aggregateId', '1'); @@ -273,7 +252,7 @@ describe('EventStore', function () { it('fails, when trying to set up second messageType handler within the same node and named queue (Receptors)', () => { - es = new EventStore({ storage, messageBus }); + es = new EventStore({ storage, supplementaryEventBus }); expect(() => { es.queue('namedQueue').on('somethingHappened', () => { }); @@ -290,7 +269,7 @@ describe('EventStore', function () { it('sets up multiple handlers for same messageType, when queue name is not defined (Projections)', () => { - es = new EventStore({ storage, eventStoreConfig: { publishAsync: false }, messageBus }); + es = new EventStore({ storage, supplementaryEventBus }); const projection1Handler = sinon.spy(); const projection2Handler = sinon.spy(); @@ -299,7 +278,7 @@ describe('EventStore', function () { es.on('somethingHappened', projection2Handler); return es.commit([ - { type: 'somethingHappened', aggregateId: 1, aggregateVersion: 0 } + { type: 'somethingHappened', aggregateId: '1', aggregateVersion: 0 } ]).then(() => { expect(projection1Handler).to.have.property('calledOnce', true); expect(projection2Handler).to.have.property('calledOnce', true); diff --git a/tests/unit/SagaEventHandler.test.ts b/tests/unit/SagaEventHandler.test.ts index 83c0f02..5e13ece 100644 --- a/tests/unit/SagaEventHandler.test.ts +++ b/tests/unit/SagaEventHandler.test.ts @@ -22,7 +22,7 @@ class Saga extends AbstractSaga { } followingHappened() { super.enqueue('complete', undefined, { foo: 'bar' }); - } + } onError(error, { command, event }) { super.enqueue('fixError', undefined, { error, command, event }); } @@ -42,9 +42,9 @@ describe('SagaEventHandler', function () { let sagaEventHandler: SagaEventHandler; beforeEach(() => { - const messageBus = new InMemoryMessageBus(); - commandBus = new CommandBus({ messageBus }); - eventStore = new EventStore({ storage: new InMemoryEventStorage(), messageBus }); + const supplementaryEventBus = new InMemoryMessageBus(); + commandBus = new CommandBus({}); + eventStore = new EventStore({ storage: new InMemoryEventStorage(), supplementaryEventBus }); sagaEventHandler = new SagaEventHandler({ sagaType: Saga, eventStore, commandBus }); }); diff --git a/tests/unit/memory/InMemoryEventStorage.test.ts b/tests/unit/memory/InMemoryEventStorage.test.ts new file mode 100644 index 0000000..bd8079c --- /dev/null +++ b/tests/unit/memory/InMemoryEventStorage.test.ts @@ -0,0 +1,127 @@ +import { expect } from 'chai'; +import { InMemoryEventStorage } from '../../../src'; + +describe('InMemoryEventStorage', () => { + let storage; + + beforeEach(() => { + storage = new InMemoryEventStorage(); + }); + + describe('commitEvents', () => { + it('commits events and returns them', async () => { + const events = [ + { id: '1', aggregateId: 'agg1', aggregateVersion: 1, type: 'TestEvent' } + ]; + const result = await storage.commitEvents(events); + expect(result).to.deep.equal(events); + }); + }); + + describe('getAggregateEvents', () => { + + it('yields events with matching aggregateId', async () => { + + const event1 = { id: '1', aggregateId: 'agg1', aggregateVersion: 1, type: 'TestEvent' }; + const event2 = { id: '2', aggregateId: 'agg2', aggregateVersion: 1, type: 'TestEvent' }; + await storage.commitEvents([event1, event2]); + + const results = []; + for await (const event of storage.getAggregateEvents('agg1')) { + results.push(event); + } + expect(results).to.deep.equal([event1]); + }); + + it('yields events with aggregateVersion greater than snapshot.aggregateVersion', async () => { + + const event1 = { id: '1', aggregateId: 'agg1', aggregateVersion: 1, type: 'TestEvent' }; + const event2 = { id: '2', aggregateId: 'agg1', aggregateVersion: 2, type: 'TestEvent' }; + await storage.commitEvents([event1, event2]); + + const snapshot = { aggregateVersion: 1 }; + const results = []; + for await (const event of storage.getAggregateEvents('agg1', { snapshot })) { + results.push(event); + } + expect(results).to.deep.equal([event2]); + }); + }); + + describe('getSagaEvents', () => { + + it('yields saga events with sagaVersion less than beforeEvent.sagaVersion', async () => { + + const event1 = { id: '1', sagaId: 'saga1', sagaVersion: 1, type: 'SagaEvent' }; + const event2 = { id: '2', sagaId: 'saga1', sagaVersion: 2, type: 'SagaEvent' }; + const event3 = { id: '3', sagaId: 'saga1', sagaVersion: 3, type: 'SagaEvent' }; + await storage.commitEvents([event1, event2, event3]); + + const beforeEvent = { sagaVersion: 3 }; + const results = []; + for await (const event of storage.getSagaEvents('saga1', { beforeEvent })) { + results.push(event); + } + expect(results).to.deep.equal([event1, event2]); + }); + }); + + describe('getEventsByTypes', () => { + + it('yields events matching the provided types', async () => { + + const event1 = { id: '1', type: 'A' }; + const event2 = { id: '2', type: 'B' }; + const event3 = { id: '3', type: 'A' }; + await storage.commitEvents([event1, event2, event3]); + + const results = []; + for await (const event of storage.getEventsByTypes(['A'])) { + results.push(event); + } + expect(results).to.deep.equal([event1, event3]); + }); + + it('yields events only after the given afterEvent id', async () => { + + const event1 = { id: '1', type: 'A' }; + const event2 = { id: '2', type: 'A' }; + const event3 = { id: '3', type: 'A' }; + await storage.commitEvents([event1, event2, event3]); + + const options = { afterEvent: { id: '1' } }; + const results = []; + for await (const event of storage.getEventsByTypes(['A'], options)) { + results.push(event); + } + expect(results).to.deep.equal([event2, event3]); + }); + + it('throws error if afterEvent is provided without id', async () => { + + const event1 = { id: '1', type: 'A' }; + await storage.commitEvents([event1]); + const options = { afterEvent: {} }; + + const gen = storage.getEventsByTypes(['A'], options); + try { + await gen.next(); + throw new Error('Expected error was not thrown'); + } catch (err) { + expect(err).to.be.instanceOf(TypeError); + expect(err.message).to.equal('options.afterEvent.id is required'); + } + }); + }); + + describe('getNewId', () => { + + it('returns sequential string ids', () => { + + const id1 = storage.getNewId(); + const id2 = storage.getNewId(); + expect(id1).to.equal('1'); + expect(id2).to.equal('2'); + }); + }); +}); diff --git a/tests/unit/memory/InMemoryLock.test.ts b/tests/unit/memory/InMemoryLock.test.ts new file mode 100644 index 0000000..63974e4 --- /dev/null +++ b/tests/unit/memory/InMemoryLock.test.ts @@ -0,0 +1,91 @@ +import { expect } from 'chai'; +import { InMemoryLock } from '../../../src'; + +describe('InMemoryLock', () => { + let lock: InMemoryLock; + + beforeEach(() => { + lock = new InMemoryLock(); + }); + + it('should call each method explicitly to satisfy coverage', async () => { + await lock.lock(); + await lock.unlock(); + await lock.once('unlocked'); // Even if tested elsewhere, call it directly + }); + + it('starts unlocked', () => { + expect(lock.locked).to.be.false; + }); + + it('acquires a lock', async () => { + await lock.lock(); + expect(lock.locked).to.be.true; + }); + + it('blocks second lock() call until unlocked', async () => { + await lock.lock(); + let secondLockAcquired = false; + + // Try acquiring the lock again, but in a separate async operation + const secondLock = lock.lock().then(() => { + secondLockAcquired = true; + }); + + // Ensure second lock() is still waiting + await new Promise((resolve) => setTimeout(resolve, 100)); + expect(secondLockAcquired).to.be.false; + + // Unlock and allow second lock to proceed + await lock.unlock(); + await secondLock; + expect(secondLockAcquired).to.be.true; + }); + + it('unlocks the lock', async () => { + await lock.lock(); + expect(lock.locked).to.be.true; + + await lock.unlock(); + expect(lock.locked).to.be.false; + }); + + it('resolves once() immediately if not locked', async () => { + let resolved = false; + + await lock.once('unlocked').then(() => { + resolved = true; + }); + + expect(resolved).to.be.true; + }); + + it('resolves once() only after unlocking', async () => { + await lock.lock(); + let resolved = false; + + const waitForUnlock = lock.once('unlocked').then(() => { + resolved = true; + }); + + // Ensure it's still waiting + await new Promise((resolve) => setTimeout(resolve, 100)); + expect(resolved).to.be.false; + + // Unlock and verify resolution + await lock.unlock(); + await waitForUnlock; + expect(resolved).to.be.true; + }); + + it('handles multiple unlock() calls gracefully', async () => { + await lock.lock(); + await lock.unlock(); + await lock.unlock(); // Should not throw or change state + expect(lock.locked).to.be.false; + }); + + it('throws an error for unexpected event types in once()', () => { + expect(() => lock.once('invalid_event')).to.throw(TypeError); + }); +}); diff --git a/tests/unit/InMemoryMessageBus.test.ts b/tests/unit/memory/InMemoryMessageBus.test.ts similarity index 95% rename from tests/unit/InMemoryMessageBus.test.ts rename to tests/unit/memory/InMemoryMessageBus.test.ts index 511d5f5..fef5b23 100644 --- a/tests/unit/InMemoryMessageBus.test.ts +++ b/tests/unit/memory/InMemoryMessageBus.test.ts @@ -1,5 +1,5 @@ -import { IMessageBus, InMemoryMessageBus } from '../..'; -import { expect, assert, AssertionError } from 'chai'; +import { IMessageBus, InMemoryMessageBus } from '../../../src'; +import { expect, AssertionError } from 'chai'; import { spy } from 'sinon'; describe('InMemoryMessageBus', function () { diff --git a/tests/unit/InMemoryView.test.ts b/tests/unit/memory/InMemoryView.test.ts similarity index 97% rename from tests/unit/InMemoryView.test.ts rename to tests/unit/memory/InMemoryView.test.ts index 7bdb6e7..617b931 100644 --- a/tests/unit/InMemoryView.test.ts +++ b/tests/unit/memory/InMemoryView.test.ts @@ -1,6 +1,6 @@ -import { InMemoryView } from '../../src/infrastructure/InMemoryView'; +import { InMemoryView } from '../../../src'; import { expect, assert } from 'chai'; -import { nextCycle } from '../../src/infrastructure/utils'; +import { nextCycle } from '../../../src/infrastructure/memory/utils'; describe('InMemoryView', function () { diff --git a/tests/unit/sqlite/SqliteEventLocker.test.ts b/tests/unit/sqlite/SqliteEventLocker.test.ts new file mode 100644 index 0000000..ee26dd4 --- /dev/null +++ b/tests/unit/sqlite/SqliteEventLocker.test.ts @@ -0,0 +1,97 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { SqliteEventLocker } from '../../../src/infrastructure/sqlite/SqliteEventLocker'; +import { IEvent } from '../../../src/interfaces'; +import { guid } from '../../../src/infrastructure/sqlite'; +import { promisify } from 'util'; +const delay = promisify(setTimeout); + +describe('SqliteEventLocker', function () { + + let db: import('better-sqlite3').Database; + let locker: SqliteEventLocker; + const testEvent: IEvent = { id: 'event1', type: 'TEST_EVENT', payload: {} }; + + beforeEach(() => { + db = createDb(':memory:'); + locker = new SqliteEventLocker({ + viewModelSqliteDb: db, + projectionName: 'test', + schemaVersion: '1.0', + eventLockTableName: 'test_event_lock', + viewLockTableName: 'test_view_lock', + eventLockTtl: 50 // ms + }); + jest.useFakeTimers(); + }); + + afterEach(() => { + db.close(); + jest.useRealTimers(); + }); + + it('allows marking an event as projecting', function () { + const result = locker.tryMarkAsProjecting(testEvent); + expect(result).to.be.true; + }); + + it('prevents re-locking an already locked event', function () { + locker.tryMarkAsProjecting(testEvent); + const result = locker.tryMarkAsProjecting(testEvent); + expect(result).to.be.false; + }); + + it('marks an event as projected', function () { + locker.tryMarkAsProjecting(testEvent); + locker.markAsProjected(testEvent); + + const row = db.prepare(`SELECT processed_at FROM test_event_lock WHERE event_id = ?`) + .get(guid(testEvent.id)) as any; + + expect(row).to.exist; + expect(row.processed_at).to.not.be.null; + }); + + it('retrieves the last projected event', function () { + + locker.tryMarkAsProjecting(testEvent); + locker.markAsProjected(testEvent); + + const lastEvent = locker.getLastEvent(); + + expect(lastEvent).to.deep.equal(testEvent); + }); + + it('returns undefined if no event has been projected', function () { + const lastEvent = locker.getLastEvent(); + expect(lastEvent).to.be.undefined; + }); + + it('fails to mark an event as projected if it was never locked', function () { + expect(() => locker.markAsProjected(testEvent)) + .to.throw(Error, `Event ${testEvent.id} could not be marked as processed`); + }); + + it('allows re-locking after TTL expires', async function () { + + locker.tryMarkAsProjecting(testEvent); + + await delay(51); + + const result = locker.tryMarkAsProjecting(testEvent); + expect(result).to.be.true; + }); + + it('fails to update an event if its version is modified in DB', function () { + + locker.tryMarkAsProjecting(testEvent); + + // Modify the event in DB to simulate an external change + db.prepare('UPDATE test_event_lock SET processed_at = ? WHERE event_id = ?') + .run(Date.now(), guid(testEvent.id)); + + // Attempt to finalize the event processing + expect(() => locker.markAsProjected(testEvent)) + .to.throw(Error, `Event ${testEvent.id} could not be marked as processed`); + }); +}); diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts new file mode 100644 index 0000000..ce2aca7 --- /dev/null +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -0,0 +1,86 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { guid, SqliteObjectStorage } from '../../../src/infrastructure/sqlite'; + +describe('SqliteObjectStorage', function () { + let db: import('better-sqlite3').Database; + let storage: SqliteObjectStorage<{ name: string; value: number }>; + + beforeEach(() => { + db = createDb(':memory:'); + storage = new SqliteObjectStorage<{ name: string; value: number }>({ + viewModelSqliteDb: db, + tableName: 'test_objects', + }); + }); + + afterEach(() => { + db.close(); + }); + + it('stores and retrieves an object', async function () { + + const obj = { name: 'Test Object', value: 42 }; + storage.create('0001', obj); + + const retrieved = storage.get('0001'); + expect(retrieved).to.deep.equal(obj); + }); + + it('returns undefined for a non-existent object', async function () { + const retrieved = storage.get('nonexistent'); + expect(retrieved).to.be.undefined; + }); + + it('updates an existing object', async function () { + + storage.create('0002', { name: 'Old Data', value: 5 }); + + storage.update('0002', (r) => ({ ...r, value: 99 })); + + const updated = storage.get('0002'); + expect(updated).to.deep.equal({ name: 'Old Data', value: 99 }); + }); + + it('throws an error when updating a non-existent object', async function () { + + expect(() => storage.update('nonexistent', (r) => ({ ...r, value: 99 }))) + .to.throw(Error, "Record 'nonexistent' does not exist"); + }); + + it('deletes an object', async function () { + + storage.create('0003', { name: 'To be deleted', value: 10 }); + const deleted = storage.delete('0003'); + expect(deleted).to.be.true; + + const retrieved = storage.get('0003'); + expect(retrieved).to.be.undefined; + }); + + it('returns false when deleting a non-existent object', async function () { + + const deleted = storage.delete('0000'); + expect(deleted).to.be.false; + }); + + it('enforces updating or creating a new object', async function () { + + storage.updateEnforcingNew('0004', () => ({ name: 'Created', value: 1 })); + + let retrieved = storage.get('0004'); + expect(retrieved).to.deep.equal({ name: 'Created', value: 1 }); + + storage.updateEnforcingNew('0004', (r) => ({ ...r!, value: 100 })); + + retrieved = storage.get('0004'); + expect(retrieved).to.deep.equal({ name: 'Created', value: 100 }); + }); + + it('fails if invalid JSON is recorded', async function () { + db.prepare('INSERT INTO test_objects (id, data) VALUES (?, ?)') + .run(guid('0005'), 'INVALID_JSON'); + + expect(() => storage.get('0005')).to.throw(); + }); +}); diff --git a/tests/unit/sqlite/SqliteObjectView.test.ts b/tests/unit/sqlite/SqliteObjectView.test.ts new file mode 100644 index 0000000..103b4c9 --- /dev/null +++ b/tests/unit/sqlite/SqliteObjectView.test.ts @@ -0,0 +1,73 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { SqliteObjectView } from '../../../src/infrastructure/sqlite'; +import { promisify } from 'util'; +const delay = promisify(setTimeout); + +describe('SqliteObjectView', function () { + let viewModelSqliteDb: import('better-sqlite3').Database; + let sqliteObjectView: SqliteObjectView; + + beforeEach(() => { + viewModelSqliteDb = createDb(':memory:'); + sqliteObjectView = new SqliteObjectView({ + viewModelSqliteDb, + projectionName: 'test', + tableNamePrefix: 'tbl_test', + schemaVersion: '1' + }) + }); + + describe('get', () => { + + it('throws an error if id is not a non-empty string', async () => { + + let error; + try { + error = null; + await sqliteObjectView.get(''); + } + catch (err) { + error = err; + } + expect(error).to.exist; + expect(error).to.have.property('message', 'id argument must be a non-empty String'); + + }); + + it('waits for readiness before returning data', async () => { + + await sqliteObjectView.lock(); + + expect(sqliteObjectView).to.have.property('ready', false); + + let resultObtained = false; + const resultPromise = sqliteObjectView.get('test').then(() => { + resultObtained = true; + }); + + await delay(5); + expect(resultObtained).to.eq(false); + + sqliteObjectView.unlock(); + + + await resultPromise; + expect(resultObtained).to.eq(true); + }); + + it('returns stored record if ready', async () => { + + sqliteObjectView.create('1', { foo: 'bar' }); + + const r = await sqliteObjectView.get('1'); + expect(r).to.eql({ foo: 'bar' }); + }); + + it('returns undefined if record does not exist', async () => { + + const r = await sqliteObjectView.get('1'); + expect(r).to.eql(undefined); + }); + }); +}); diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts new file mode 100644 index 0000000..c7fecef --- /dev/null +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -0,0 +1,122 @@ +import { expect } from 'chai'; +import * as createDb from 'better-sqlite3'; +import { SqliteViewLocker } from '../../../src/infrastructure/sqlite'; + +describe('SqliteViewLocker', function () { + + const viewLockTtl = 1_000; // 1sec + let viewModelSqliteDb: import('better-sqlite3').Database; + let firstLock: SqliteViewLocker; + let secondLock: SqliteViewLocker; + + beforeEach(() => { + viewModelSqliteDb = createDb(':memory:'); + firstLock = new SqliteViewLocker({ + viewModelSqliteDb, + projectionName: 'test', + schemaVersion: '1.0', + viewLockTtl + }); + secondLock = new SqliteViewLocker({ + viewModelSqliteDb, + projectionName: 'test', + schemaVersion: '1.0', + viewLockTtl + }); + + jest.useFakeTimers(); + }); + + afterEach(() => { + viewModelSqliteDb.close(); + }); + + it('locks a view successfully', async function () { + const result = await firstLock.lock(); + expect(result).to.be.true; + }); + + it('unlocks a view successfully', async function () { + await firstLock.lock(); + firstLock.unlock(); + + const lockResult = await secondLock.lock(); + expect(lockResult).to.be.true; + }); + + it('sets ready flag to `false` when locked', async () => { + + await firstLock.lock(); + expect(firstLock).to.have.property('ready', false); + }); + + it('sets ready flag to `true` when unlocked', async () => { + + await firstLock.lock(); + await firstLock.unlock(); + expect(firstLock).to.have.property('ready', true); + }); + + it('waits for the lock to be released if already locked', async function () { + await firstLock.lock(); + + let secondLockAcquired = false; + + // Try locking, but it should wait + const secondLockAcquiring = secondLock.lock().then(() => { + secondLockAcquired = true; + }); + + // Wait briefly to check if it resolves too soon + await jest.advanceTimersByTimeAsync(viewLockTtl); + expect(secondLockAcquired).to.be.false; + + firstLock.unlock(); + + await secondLockAcquiring; + expect(secondLockAcquired).to.be.true; + }); + + + it('prolongs the lock while active', async function () { + await firstLock.lock(); + + const initial = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + .get('test', '1.0') as any; + + expect(initial).to.have.property('locked_till').that.is.gt(Date.now()); + + await jest.advanceTimersByTimeAsync(viewLockTtl); + + const updated = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + .get('test', '1.0') as any; + + expect(updated).to.have.property('locked_till').that.is.gt(initial.locked_till); + }); + + it('should release the lock upon unlock()', async function () { + await firstLock.lock(); + firstLock.unlock(); + + const row = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + .get('test', '1.0') as any; + + expect(row.locked_till).to.be.null; + }); + + it('should fail to prolong the lock if already released', async function () { + await firstLock.lock(); + firstLock.unlock(); + + let error; + try { + await (firstLock as any).prolongLock(); + } + catch (err) { + error = err; + } + + expect(error).to.exist; + expect(error).to.have.property('message', '"test" lock could not be prolonged'); + }); +}); From 9c8b4c79bd941cf9614ca8c3dc7019d2dbde6ca0 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 21 Mar 2025 23:15:15 +0000 Subject: [PATCH 022/169] 1.0.0-rc.6 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9c5d1af..57c2567 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.6](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.5...v1.0.0-rc.6) (2025-03-21) + + +### Changes + +* Support persistent views; Add SQLite infrastructure ([c235573](https://github.com/snatalenko/node-cqrs/commit/c235573678be349d031d1a696cab3993224979a2)) + + # [1.0.0-rc.5](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.4...v1.0.0-rc.5) (2024-10-27) diff --git a/package-lock.json b/package-lock.json index c9330af..b547e2d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.5", + "version": "1.0.0-rc.6", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.5", + "version": "1.0.0-rc.6", "license": "MIT", "dependencies": { "di0": "^1.0.0" diff --git a/package.json b/package.json index 70fcfdd..56f0886 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.5", + "version": "1.0.0-rc.6", "description": "Basic ES6 backbone for CQRS app development", "repository": { "type": "git", From e781f7c6c2e4f7c9f8c4615b170d0d29d3e8f133 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 30 Mar 2025 02:15:41 +0100 Subject: [PATCH 023/169] Change: Move validation, snapshot and event persistence to EventDispatcher pipeline --- docs/entities/Projection/README.md | 2 +- docs/infrastructure/README.md | 6 +- examples/user-domain-tests/index.test.js | 4 - examples/user-domain/index.js | 21 +- package-lock.json | 14 + package.json | 10 +- src/AbstractProjection.ts | 2 +- src/AggregateCommandHandler.ts | 4 +- src/CommandBus.ts | 15 +- src/CqrsContainerBuilder.ts | 17 + src/Event.ts | 11 - src/EventDispatcher.ts | 141 ++++++ src/EventStore.ts | 174 +++----- .../EventPersistenceProcessor.ts | 34 ++ .../EventValidationProcessor.ts | 27 ++ .../SnapshotPersistenceProcessor.ts | 66 +++ src/dispatch-pipeline/index.ts | 3 + .../InMemoryEventStorage.ts | 25 +- .../memory => in-memory}/InMemoryLock.ts | 0 .../InMemoryMessageBus.ts | 2 +- .../InMemorySnapshotStorage.ts | 12 +- .../memory => in-memory}/InMemoryView.ts | 2 +- .../memory => in-memory}/index.ts | 0 .../memory => in-memory}/utils/Deferred.ts | 0 .../memory => in-memory}/utils/index.ts | 0 .../memory => in-memory}/utils/nextCycle.ts | 0 src/index.ts | 4 +- src/interfaces/IAggregateSnapshotStorage.ts | 2 + src/interfaces/ICommandBus.ts | 6 +- src/interfaces/IEvent.ts | 1 + src/interfaces/IEventBus.ts | 11 + src/interfaces/IEventDispatcher.ts | 7 + src/interfaces/IEventProcessor.ts | 24 ++ src/interfaces/IEventSet.ts | 3 - src/interfaces/IEventStorage.ts | 34 +- src/interfaces/IEventStore.ts | 25 +- src/interfaces/IIdentifierProvider.ts | 16 + src/interfaces/IMessage.ts | 6 + src/interfaces/IObservable.ts | 12 +- src/interfaces/index.ts | 4 + .../sqlite/AbstractSqliteObjectProjection.ts | 4 +- .../sqlite/AbstractSqliteView.ts | 4 +- .../sqlite/SqliteEventLocker.ts | 2 +- .../sqlite/SqliteObjectStorage.ts | 2 +- .../sqlite/SqliteObjectView.ts | 2 +- .../sqlite/SqliteViewLocker.ts | 4 +- .../sqlite/commonParams.ts | 0 src/{infrastructure => }/sqlite/index.ts | 0 .../sqlite/queries/eventLockTableInit.ts | 0 .../sqlite/queries/index.ts | 0 .../sqlite/queries/viewLockTableInit.ts | 0 .../sqlite/utils/getEventId.ts | 4 +- src/{infrastructure => }/sqlite/utils/guid.ts | 0 .../sqlite/utils/index.ts | 0 src/utils/CompoundEmitter.ts | 45 -- src/utils/delay.ts | 8 + src/utils/index.ts | 6 +- src/utils/isIEventStorage.ts | 8 - src/utils/isIMessageBus.ts | 9 - src/utils/isIObservable.ts | 7 - src/utils/notEmpty.ts | 1 + .../{ => sqlite}/SqliteView.test.ts | 45 +- tests/unit/AbstractProjection.test.ts | 14 +- tests/unit/AggregateCommandHandler.test.ts | 11 +- tests/unit/CqrsContainerBuilder.test.ts | 6 +- tests/unit/EventDispatcher.test.ts | 100 +++++ tests/unit/EventStore.test.ts | 401 ++++++------------ tests/unit/SagaEventHandler.test.ts | 9 +- tests/unit/memory/InMemoryMessageBus.test.ts | 1 - tests/unit/memory/InMemoryView.test.ts | 2 +- tests/unit/sqlite/SqliteEventLocker.test.ts | 4 +- tests/unit/sqlite/SqliteObjectStorage.test.ts | 2 +- tests/unit/sqlite/SqliteObjectView.test.ts | 2 +- tests/unit/sqlite/SqliteViewLocker.test.ts | 2 +- 74 files changed, 840 insertions(+), 612 deletions(-) create mode 100644 src/EventDispatcher.ts create mode 100644 src/dispatch-pipeline/EventPersistenceProcessor.ts create mode 100644 src/dispatch-pipeline/EventValidationProcessor.ts create mode 100644 src/dispatch-pipeline/SnapshotPersistenceProcessor.ts create mode 100644 src/dispatch-pipeline/index.ts rename src/{infrastructure/memory => in-memory}/InMemoryEventStorage.ts (84%) rename src/{infrastructure/memory => in-memory}/InMemoryLock.ts (100%) rename src/{infrastructure/memory => in-memory}/InMemoryMessageBus.ts (99%) rename src/{infrastructure/memory => in-memory}/InMemorySnapshotStorage.ts (70%) rename src/{infrastructure/memory => in-memory}/InMemoryView.ts (98%) rename src/{infrastructure/memory => in-memory}/index.ts (100%) rename src/{infrastructure/memory => in-memory}/utils/Deferred.ts (100%) rename src/{infrastructure/memory => in-memory}/utils/index.ts (100%) rename src/{infrastructure/memory => in-memory}/utils/nextCycle.ts (100%) create mode 100644 src/interfaces/IEventBus.ts create mode 100644 src/interfaces/IEventDispatcher.ts create mode 100644 src/interfaces/IEventProcessor.ts create mode 100644 src/interfaces/IIdentifierProvider.ts rename src/{infrastructure => }/sqlite/AbstractSqliteObjectProjection.ts (85%) rename src/{infrastructure => }/sqlite/AbstractSqliteView.ts (92%) rename src/{infrastructure => }/sqlite/SqliteEventLocker.ts (98%) rename src/{infrastructure => }/sqlite/SqliteObjectStorage.ts (98%) rename src/{infrastructure => }/sqlite/SqliteObjectView.ts (97%) rename src/{infrastructure => }/sqlite/SqliteViewLocker.ts (97%) rename src/{infrastructure => }/sqlite/commonParams.ts (100%) rename src/{infrastructure => }/sqlite/index.ts (100%) rename src/{infrastructure => }/sqlite/queries/eventLockTableInit.ts (100%) rename src/{infrastructure => }/sqlite/queries/index.ts (100%) rename src/{infrastructure => }/sqlite/queries/viewLockTableInit.ts (100%) rename src/{infrastructure => }/sqlite/utils/getEventId.ts (83%) rename src/{infrastructure => }/sqlite/utils/guid.ts (100%) rename src/{infrastructure => }/sqlite/utils/index.ts (100%) delete mode 100644 src/utils/CompoundEmitter.ts create mode 100644 src/utils/delay.ts delete mode 100644 src/utils/isIEventStorage.ts delete mode 100644 src/utils/isIMessageBus.ts delete mode 100644 src/utils/isIObservable.ts create mode 100644 src/utils/notEmpty.ts rename tests/integration/{ => sqlite}/SqliteView.test.ts (73%) create mode 100644 tests/unit/EventDispatcher.test.ts diff --git a/docs/entities/Projection/README.md b/docs/entities/Projection/README.md index 3e797c7..0a94cf6 100644 --- a/docs/entities/Projection/README.md +++ b/docs/entities/Projection/README.md @@ -4,7 +4,7 @@ Projection is an Observer, that listens to events and updates an associated View ## Projection View Restoring -By default, an [InMemoryView](https://github.com/snatalenko/node-cqrs/blob/master/src/infrastructure/InMemoryViewStorage.js) is used. That means that upon application start, Projection queries all known events from the EventStore and projects them to the view. Once this process is complete, the view's `ready` property gets switched from *false* to *true*. +By default, an [InMemoryView](https://github.com/snatalenko/node-cqrs/blob/master/src/in-memory/InMemoryViewStorage.js) is used. That means that upon application start, Projection queries all known events from the EventStore and projects them to the view. Once this process is complete, the view's `ready` property gets switched from *false* to *true*. ## Projection Event Handlers diff --git a/docs/infrastructure/README.md b/docs/infrastructure/README.md index 762deaf..93a194c 100644 --- a/docs/infrastructure/README.md +++ b/docs/infrastructure/README.md @@ -2,9 +2,9 @@ node-cqrs comes with a set of In-Memory infrastructure service implementations. They are suitable for test purposes, since all data is persisted in process memory only: -* [InMemoryEventStorage](https://github.com/snatalenko/node-cqrs/blob/master/src/infrastructure/InMemoryEventStorage.js) -* [InMemoryMessageBus](https://github.com/snatalenko/node-cqrs/blob/master/src/infrastructure/InMemoryMessageBus.js) -* [InMemoryView](https://github.com/snatalenko/node-cqrs/blob/master/src/infrastructure/InMemoryView.js) +* [InMemoryEventStorage](https://github.com/snatalenko/node-cqrs/blob/master/src/in-memory/InMemoryEventStorage.js) +* [InMemoryMessageBus](https://github.com/snatalenko/node-cqrs/blob/master/src/in-memory/InMemoryMessageBus.js) +* [InMemoryView](https://github.com/snatalenko/node-cqrs/blob/master/src/in-memory/InMemoryView.js) The following storage/bus implementations persist data in external storages and can be used in production: diff --git a/examples/user-domain-tests/index.test.js b/examples/user-domain-tests/index.test.js index 2b87755..e5f4378 100644 --- a/examples/user-domain-tests/index.test.js +++ b/examples/user-domain-tests/index.test.js @@ -2,7 +2,6 @@ const { expect } = require('chai'); const { createContainer, createBaseInstances } = require('../user-domain'); -const { nextCycle } = require('../../src/infrastructure/memory/utils'); describe('user-domain example', () => { @@ -10,9 +9,6 @@ describe('user-domain example', () => { const { commandBus, eventStore } = container; - // HACK: let projection restoring to start before emitting new events - await nextCycle(); - // we send a command to an aggregate that does not exist yet (userAggregateId = undefined), // a new instance will be created automatically let userAggregateId; diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index 75d239c..6a66706 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -6,8 +6,10 @@ const { CommandBus, EventStore, AggregateCommandHandler, - InMemoryMessageBus + InMemoryMessageBus, + EventDispatcher } = require('../..'); // node-cqrs +const { EventPersistenceProcessor } = require('../../src/dispatch-pipeline'); const UserAggregate = require('./UserAggregate'); const UsersProjection = require('./UsersProjection'); @@ -19,7 +21,7 @@ exports.createContainer = () => { // register infrastructure services builder.register(InMemoryEventStorage).as('storage'); - builder.register(InMemoryMessageBus).as('supplementaryEventBus'); + builder.register(InMemoryMessageBus).as('eventBus'); // register domain entities builder.registerAggregate(UserAggregate); @@ -34,19 +36,22 @@ exports.createContainer = () => { */ exports.createBaseInstances = () => { // create infrastructure services - const messageBus = new InMemoryMessageBus(); + const eventBus = new InMemoryMessageBus(); const storage = new InMemoryEventStorage(); - const eventStore = new EventStore({ storage, supplementaryEventBus: messageBus }); - const commandBus = new CommandBus({ messageBus }); + const eventDispatcher = new EventDispatcher({ eventBus }) + eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor({ storage })); - /** @type {IAggregateConstructor} */ + const eventStore = new EventStore({ storage, eventBus, eventDispatcher }); + const commandBus = new CommandBus(); + + /** @type {import('../..').IAggregateConstructor} */ const aggregateType = UserAggregate; - /** @type {ICommandHandler} */ + /** @type {import('../..').ICommandHandler} */ const userCommandHandler = new AggregateCommandHandler({ eventStore, aggregateType }); userCommandHandler.subscribe(commandBus); - /** @type {IProjection} */ + /** @type {import('../..').IProjection} */ const usersProjection = new UsersProjection(); usersProjection.subscribe(eventStore); diff --git a/package-lock.json b/package-lock.json index b547e2d..6a360a4 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,6 +9,8 @@ "version": "1.0.0-rc.6", "license": "MIT", "dependencies": { + "async-iterable-buffer": "^1.0.0", + "async-parallel-pipe": "^1.0.1", "di0": "^1.0.0" }, "devDependencies": { @@ -1355,6 +1357,18 @@ "dev": true, "license": "MIT" }, + "node_modules/async-iterable-buffer": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/async-iterable-buffer/-/async-iterable-buffer-1.0.0.tgz", + "integrity": "sha512-pZn6MjtoJFyr+RVy3O0BSRb8ibjSX9BlEh8trEqdtpV4DdnH7oM28Ke14r4QZuzQnSGj3tg1CrEToIxuvsfqsw==", + "license": "MIT" + }, + "node_modules/async-parallel-pipe": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/async-parallel-pipe/-/async-parallel-pipe-1.0.1.tgz", + "integrity": "sha512-LnZtmPVzwMMvFywrQ2VKSsFlIWXuQogqkOfS5mxKoU3u0O9Di5zvVHMYW0HW/FdjTTz11l9a0pKw/mQ7DQgCww==", + "license": "MIT" + }, "node_modules/babel-jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz", diff --git a/package.json b/package.json index 56f0886..fd05acc 100644 --- a/package.json +++ b/package.json @@ -20,12 +20,16 @@ ], "main": "./dist/index.js", "types": "./src/index.ts", + "exports": { + ".": "./dist/index.js", + "./sqlite": "./dist/sqlite/index.js" + }, "engines": { "node": ">=10.3.0" }, "scripts": { "pretest": "npm run build", - "test": "jest --verbose tests/unit", + "test": "jest tests/unit", "test:coverage": "jest --collect-coverage tests/unit", "pretest:integration": "npm run build", "test:integration": "jest --verbose examples/user-domain-tests tests/integration", @@ -40,6 +44,8 @@ "license": "MIT", "homepage": "https://github.com/snatalenko/node-cqrs#readme", "dependencies": { + "async-iterable-buffer": "^1.0.0", + "async-parallel-pipe": "^1.0.1", "di0": "^1.0.0" }, "devDependencies": { @@ -60,4 +66,4 @@ "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } -} +} \ No newline at end of file diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index a999f50..764b589 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -1,5 +1,5 @@ import { describe } from './Event'; -import { InMemoryView } from './infrastructure/memory/InMemoryView'; +import { InMemoryView } from './in-memory/InMemoryView'; import { IViewLocker, IEventLocker, diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index af886d7..7339890 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -119,12 +119,12 @@ export class AggregateCommandHandler implements ICommandHandler { if (!events.length) return events; - if (aggregate.shouldTakeSnapshot && this.#eventStore.snapshotsSupported) { + if (aggregate.shouldTakeSnapshot) { aggregate.takeSnapshot(); events = aggregate.changes; } - await this.#eventStore.commit(events); + await this.#eventStore.dispatch(events); return events; } diff --git a/src/CommandBus.ts b/src/CommandBus.ts index e7cfbbf..cf212b0 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -1,4 +1,4 @@ -import { InMemoryMessageBus } from "./infrastructure/memory"; +import { InMemoryMessageBus } from "./in-memory"; import { ICommand, ICommandBus, @@ -14,18 +14,15 @@ export class CommandBus implements ICommandBus { #logger?: ILogger; #bus: IMessageBus; - /** - * Creates an instance of CommandBus. - */ - constructor({ messageBus, logger }: { + constructor(o?: { messageBus?: IMessageBus, logger?: ILogger | IExtendableLogger }) { - this.#bus = messageBus ?? new InMemoryMessageBus(); + this.#bus = o?.messageBus ?? new InMemoryMessageBus(); - this.#logger = logger && 'child' in logger ? - logger.child({ service: 'CommandBus' }) : - logger; + this.#logger = o?.logger && 'child' in o.logger ? + o.logger.child({ service: 'CommandBus' }) : + o?.logger; } /** diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 9aaecf8..cefc476 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -4,6 +4,13 @@ import { AggregateCommandHandler } from './AggregateCommandHandler'; import { CommandBus } from './CommandBus'; import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; +import { EventDispatcher } from './EventDispatcher'; +import { InMemoryMessageBus } from './in-memory'; +import { + EventValidationProcessor, + SnapshotPersistenceProcessor, + EventPersistenceProcessor +} from './dispatch-pipeline'; import { isClass @@ -32,8 +39,18 @@ export class CqrsContainerBuilder extends ContainerBuilder { singletones: object }) { super(options); + super.register(InMemoryMessageBus).as('eventBus'); super.register(EventStore).as('eventStore'); super.register(CommandBus).as('commandBus'); + + super.register(container => { + const eventDispatcher = new EventDispatcher(container); + eventDispatcher.addPipelineProcessor(new EventValidationProcessor(container)); + eventDispatcher.addPipelineProcessor(new SnapshotPersistenceProcessor(container)); + eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor(container)); + + return eventDispatcher; + }).as('eventDispatcher'); } /** Register command handler, which will be subscribed to commandBus upon instance creation */ diff --git a/src/Event.ts b/src/Event.ts index 83b2043..0dea892 100644 --- a/src/Event.ts +++ b/src/Event.ts @@ -1,11 +1,4 @@ import { IEvent } from "./interfaces"; -import * as crypto from 'crypto'; - -const md5 = (data: object): string => crypto - .createHash('md5') - .update(JSON.stringify(data)) - .digest('hex') - .replace(/==$/, ''); /** * Get text description of an event for logging purposes @@ -37,7 +30,3 @@ export function validate(event: IEvent) { if (event.sagaId && typeof event.sagaVersion === 'undefined') throw new TypeError('event.sagaVersion is required, when event.sagaId is defined'); } - -export function getId(event: IEvent): string { - return event.id ?? md5(event); -} diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts new file mode 100644 index 0000000..2a29fc3 --- /dev/null +++ b/src/EventDispatcher.ts @@ -0,0 +1,141 @@ +import { + EventBatch, + IEvent, + IEventDispatcher, + IEventProcessor, + IEventSet, + IEventBus +} from "./interfaces"; +import { parallelPipe } from 'async-parallel-pipe'; +import { AsyncIterableBuffer } from 'async-iterable-buffer'; +import { notEmpty } from "./utils"; +import { InMemoryMessageBus } from "./in-memory"; + +type EventBatchEnvelope = { + data: EventBatch<{ event?: IEvent }>; + error?: Error; + resolve: (event: IEvent[]) => void; + reject: (error: Error) => void; +} + +export class EventDispatcher implements IEventDispatcher { + + #pipelineInput = new AsyncIterableBuffer(); + #processors: Array = []; + #pipeline: AsyncIterableIterator | IterableIterator = this.#pipelineInput; + + /** + * Event bus where dispatched messages are delivered after processing. + * + * If not provided in the constructor, defaults to an instance of `InMemoryMessageBus`. + */ + eventBus: IEventBus; + + /** + * Maximum number of event batches that each pipeline processor can handle in parallel. + */ + concurrentLimit: number; + + constructor(o?: { + eventBus?: IEventBus, + eventDispatcherConfig?: { + concurrentLimit?: number + } + }) { + this.eventBus = o?.eventBus ?? new InMemoryMessageBus(); + this.concurrentLimit = o?.eventDispatcherConfig?.concurrentLimit ?? 100; + } + + /** + * Adds a preprocessor to the event dispatch pipeline. + * + * Preprocessors run in order they are added but process separate batches in parallel, maintaining FIFO order. + */ + addPipelineProcessor(preprocessor: IEventProcessor) { + if (this.#pipelineProcessing) + throw new Error('pipeline processing already started'); + + this.#processors.push(preprocessor); + + // Build a processing pipeline that runs preprocessors concurrently + // while preserving first-in-first-out ordering. + this.#pipeline = parallelPipe(this.#pipeline, this.concurrentLimit, async envelope => { + if (envelope.error) + return envelope; + + try { + return { + ...envelope, + data: await preprocessor.process(envelope.data) + }; + } + catch (error) { + return { ...envelope, error }; + } + }); + } + + #pipelineProcessing = false; + + /** + * Consume the pipeline, publish events, and resolve/reject each batch + */ + async #startPipelineProcessing() { + if (this.#pipelineProcessing) // should never happen + throw new Error('pipeline processing already started'); + + this.#pipelineProcessing = true; + + for await (const { error, reject, data, resolve } of this.#pipeline) { + if (error) { // some of the preprocessors failed + await this.#revert(data); + reject(error); + continue; + } + + const events = data.map(e => e.event).filter(notEmpty); + + try { + for (const event of events) { + this.eventBus.publish(event); + } + resolve(events); + } + catch (publishError) { + reject(publishError); + } + } + } + + /** + * Revert side effects made by pipeline processors in case of a batch processing failure + */ + async #revert(batch: EventBatch) { + for (const processor of this.#processors) + await processor.revert?.(batch); + } + + /** + * Dispatch a set of events through the processing pipeline. + * + * Returns a promise that resolves after all events are processed and published. + */ + async dispatch(events: IEventSet) { + if (!Array.isArray(events) || events.length === 0) + throw new Error('dispatch requires a non-empty array of events'); + + const { promise, resolve, reject } = Promise.withResolvers(); + const envelope: EventBatchEnvelope = { + data: events.map(event => ({ event })), + resolve, + reject + }; + + if (!this.#pipelineProcessing) + this.#startPipelineProcessing(); + + this.#pipelineInput.push(envelope); + + return promise; + } +} diff --git a/src/EventStore.ts b/src/EventStore.ts index 99d596a..b1cdc28 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -1,81 +1,81 @@ import { IAggregateSnapshotStorage, IEvent, - IEventStorage, + IEventStoreReader, IEventSet, IExtendableLogger, ILogger, - IMessageBus, IMessageHandler, IObservable, IEventStream, IEventStore, EventQueryAfter, EventQueryBefore, - Identifier + Identifier, + IIdentifierProvider, + isIdentifierProvider, + IEventDispatcher, + IEventBus, + isIEventBus, + isIEventStoreReader } from "./interfaces"; import { getClassName, - setupOneTimeEmitterSubscription, - CompoundEmitter, - isIEventStorage, - isIMessageBus + setupOneTimeEmitterSubscription } from "./utils"; -import * as Event from './Event'; - -const SNAPSHOT_EVENT_TYPE = 'snapshot'; +import { EventDispatcher } from "./EventDispatcher"; export class EventStore implements IEventStore { - #validator: (event: IEvent) => void; - #logger?: ILogger; - #storage: IEventStorage; - #supplementaryEventBus?: IMessageBus; + #identifierProvider: IIdentifierProvider; + #storage: IEventStoreReader; #snapshotStorage: IAggregateSnapshotStorage | undefined; - #sagaStarters: string[] = []; - #compoundEmitter: CompoundEmitter; - - /** Whether storage supports aggregate snapshots */ - get snapshotsSupported(): boolean { - return Boolean(this.#snapshotStorage); - } + eventBus: IEventBus; + #eventDispatcher: IEventDispatcher; + #sagaStarters: Set = new Set(); + #logger?: ILogger; constructor({ storage, - supplementaryEventBus, + identifierProvider = isIdentifierProvider(storage) ? storage : undefined, snapshotStorage, - eventValidator = Event.validate, - logger + eventBus, + eventDispatcher, + logger, }: { - storage: IEventStorage, - - /** Optional event dispatcher for publishing persisted events externally */ - supplementaryEventBus?: IMessageBus, + storage: IEventStoreReader, + identifierProvider?: IIdentifierProvider, snapshotStorage?: IAggregateSnapshotStorage, - eventValidator?: IMessageHandler, - logger?: ILogger | IExtendableLogger + eventBus?: IEventBus, + eventDispatcher?: IEventDispatcher, + logger?: ILogger | IExtendableLogger, }) { if (!storage) throw new TypeError('storage argument required'); - if (!isIEventStorage(storage)) + if (!identifierProvider) + throw new TypeError('identifierProvider argument required'); + if (!isIEventStoreReader(storage)) throw new TypeError('storage does not implement IEventStorage interface'); - if (supplementaryEventBus && !isIMessageBus(supplementaryEventBus)) - throw new TypeError('supplementaryEventBus does not implement IMessageBus interface'); + if (eventBus && !isIEventBus(eventBus)) + throw new TypeError('eventBus does not implement IMessageBus interface'); - this.#validator = eventValidator; + this.#storage = storage; + this.#identifierProvider = identifierProvider; + this.#snapshotStorage = snapshotStorage; + this.#eventDispatcher = eventDispatcher ?? new EventDispatcher({ eventBus }); + this.eventBus = eventBus ?? this.#eventDispatcher.eventBus; this.#logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : logger; - this.#storage = storage; - this.#snapshotStorage = snapshotStorage; - this.#supplementaryEventBus = supplementaryEventBus; - this.#compoundEmitter = new CompoundEmitter(supplementaryEventBus, storage); } - - /** Retrieve new ID from the storage */ + /** + * Generates and returns a new unique identifier using the configured identifier provider. + * + * @returns A promise resolving to a unique identifier suitable for aggregates, sagas, and events. + */ async getNewId(): Promise { - return this.#storage.getNewId(); + return this.#identifierProvider.getNewId(); } async* getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream { @@ -137,8 +137,8 @@ export class EventStore implements IEventStore { * Upon such event commit a new sagaId will be assigned */ registerSagaStarters(eventTypes: string[] = []) { - const uniqueEventTypes = eventTypes.filter(e => !this.#sagaStarters.includes(e)); - this.#sagaStarters.push(...uniqueEventTypes); + for (const eventType of eventTypes) + this.#sagaStarters.add(eventType); } /** @@ -147,30 +147,25 @@ export class EventStore implements IEventStore { * @param events - a set of events to commit * @returns Signed and committed events */ - async commit(events: IEventSet): Promise { + async dispatch(events: IEventSet): Promise { if (!Array.isArray(events)) throw new TypeError('events argument must be an Array'); - const containsSagaStarters = this.#sagaStarters.length && events.some(e => this.#sagaStarters.includes(e.type)); - const augmentedEvents = containsSagaStarters ? - await this.#attachSagaIdToSagaStarterEvents(events) : - events; - - const eventStreamWithoutSnapshots = await this.persistEventsAndSnapshots(augmentedEvents); + const augmentedEvents = await this.#attachSagaIdToSagaStarterEvents(events); - // after events are saved to the persistent storage, - // publish them to the event bus (i.e. RabbitMq) - if (this.#supplementaryEventBus) - await this.publishEvents(eventStreamWithoutSnapshots); - - return eventStreamWithoutSnapshots; + return this.#eventDispatcher.dispatch(augmentedEvents); } - /** Generate and attach sagaId to events that start new sagas */ + /** + * Generate and attach sagaId to events that start new sagas + */ async #attachSagaIdToSagaStarterEvents(events: IEventSet): Promise { + if (!this.#sagaStarters.size) + return events; + const augmentedEvents: IEvent[] = []; for (const event of events) { - if (this.#sagaStarters.includes(event.type)) { + if (this.#sagaStarters.has(event.type)) { if (event.sagaId) throw new Error(`Event "${event.type}" already contains sagaId. Multiple sagas with same event type are not supported`); @@ -186,74 +181,25 @@ export class EventStore implements IEventStore { return augmentedEvents; } - /** - * Save events and snapshots to the persistent storages - * - * @returns Event set without "snapshot" events - */ - protected async persistEventsAndSnapshots(events: IEventSet): Promise { - if (!Array.isArray(events)) - throw new TypeError('events argument must be an Array'); - - const snapshotEvents = events.filter(e => e.type === SNAPSHOT_EVENT_TYPE); - if (snapshotEvents.length > 1) - throw new Error(`cannot commit a stream with more than 1 ${SNAPSHOT_EVENT_TYPE} event`); - if (snapshotEvents.length && !this.snapshotsSupported) - throw new Error(`${SNAPSHOT_EVENT_TYPE} event type is not supported by the storage`); - - const snapshot = snapshotEvents[0]; - const eventsWithoutSnapshot = events.filter(e => e !== snapshot); - - this.#logger?.debug(`validating ${Event.describeMultiple(eventsWithoutSnapshot)}...`); - eventsWithoutSnapshot.forEach(this.#validator); - - this.#logger?.debug(`saving ${Event.describeMultiple(eventsWithoutSnapshot)}...`); - await Promise.all([ - this.#storage.commitEvents(eventsWithoutSnapshot), - snapshot ? - this.#snapshotStorage?.saveAggregateSnapshot(snapshot) : - undefined - ]); - - return eventsWithoutSnapshot; - } - - protected async publishEvents(events: IEventSet) { - if (!this.#supplementaryEventBus) - throw new Error('No supplementaryEventBus injected, events cannot be published'); - - this.#logger?.debug(`publishing ${Event.describeMultiple(events)}...`); - - try { - for (const event of events) - this.#supplementaryEventBus.publish(event); - - this.#logger?.debug(`${Event.describeMultiple(events)} published`); - } - catch (error: any) { - this.#logger?.error(`${Event.describeMultiple(events)} publishing failed: ${error.message}`, { - stack: error.stack - }); - throw error; - } - } - on(messageType: string, handler: IMessageHandler) { - this.#compoundEmitter.on(messageType, handler); + this.eventBus.on(messageType, handler); } off(messageType: string, handler: IMessageHandler) { - this.#compoundEmitter.off(messageType, handler); + this.eventBus.off(messageType, handler); } queue(name: string): IObservable { - return this.#compoundEmitter.queue(name); + if (!this.eventBus.queue) + throw new Error('Injected eventBus does not support named queues'); + + return this.eventBus.queue(name); } /** Creates one-time subscription for one or multiple events that match a filter */ once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise { const subscribeTo = Array.isArray(messageTypes) ? messageTypes : [messageTypes]; - return setupOneTimeEmitterSubscription(this.#compoundEmitter, subscribeTo, filter, handler, this.#logger); + return setupOneTimeEmitterSubscription(this.eventBus, subscribeTo, filter, handler, this.#logger); } } diff --git a/src/dispatch-pipeline/EventPersistenceProcessor.ts b/src/dispatch-pipeline/EventPersistenceProcessor.ts new file mode 100644 index 0000000..aea2ff3 --- /dev/null +++ b/src/dispatch-pipeline/EventPersistenceProcessor.ts @@ -0,0 +1,34 @@ +import { EventBatch, IEvent, IEventProcessor, IEventStoreWriter } from '../interfaces'; + +/** + * Processor responsible for persisting events using an in-memory event storage. + * Typically used for testing or ephemeral scenarios where durability isn't required. + */ +export class EventPersistenceProcessor implements IEventProcessor { + + #storage: IEventStoreWriter; + + constructor(options: { storage: IEventStoreWriter }) { + if (!options.storage) + throw new TypeError('storage argument required'); + + this.#storage = options.storage; + } + + async process(batch: EventBatch): Promise { + if(!this.#storage) + return batch; + + const events: IEvent[] = []; + for(const { event } of batch) { + if(!event) + throw new Error('Event batch does not contain event'); + + events.push(event); + } + + await this.#storage.commitEvents(events); + + return batch; + } +} diff --git a/src/dispatch-pipeline/EventValidationProcessor.ts b/src/dispatch-pipeline/EventValidationProcessor.ts new file mode 100644 index 0000000..72090c6 --- /dev/null +++ b/src/dispatch-pipeline/EventValidationProcessor.ts @@ -0,0 +1,27 @@ +import { EventBatch, IEvent, IEventProcessor } from '../interfaces'; +import { validate as defaultValidator } from '../Event'; + +export type EventValidator = (event: IEvent) => void; + +/** + * Processor that validates the format of events. + * Rejects the batch if any event fails validation. + */ +export class EventValidationProcessor implements IEventProcessor { + + #validate: EventValidator; + + constructor(o?: { + eventFormatValidator: EventValidator + }) { + this.#validate = o?.eventFormatValidator ?? defaultValidator; + } + + async process(batch: EventBatch): Promise { + for (const { event } of batch) { + if (event) + this.#validate(event); + } + return batch; + } +} diff --git a/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts b/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts new file mode 100644 index 0000000..dc6088f --- /dev/null +++ b/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts @@ -0,0 +1,66 @@ +import { + EventBatch, + IAggregateSnapshotStorage, + IEvent, + IEventProcessor, + IExtendableLogger, + ILogger +} from "../interfaces"; +import * as Event from '../Event'; + +const SNAPSHOT_EVENT_TYPE = 'snapshot'; + +export class SnapshotPersistenceProcessor implements IEventProcessor { + + #snapshotStorage?: IAggregateSnapshotStorage; + #logger?: ILogger; + + constructor(options: { + snapshotStorage?: IAggregateSnapshotStorage; + logger?: ILogger | IExtendableLogger; + }) { + this.#snapshotStorage = options.snapshotStorage; + this.#logger = options.logger && 'child' in options.logger ? + options.logger.child({ service: new.target.name }) : + options.logger; + } + + #extractSnapshotEvent(batch: EventBatch): IEvent | undefined { + if (!Array.isArray(batch)) + throw new TypeError('batch argument must be an Array'); + + const snapshotEvents = batch.filter(({ event }) => event?.type === SNAPSHOT_EVENT_TYPE); + if (snapshotEvents.length > 1) + throw new Error(`Cannot process more than one "${SNAPSHOT_EVENT_TYPE}" event per batch`); + + return snapshotEvents[0].event; + } + + async process(batch: EventBatch): Promise { + if (!this.#snapshotStorage) + return batch; + + const snapshotEvent = this.#extractSnapshotEvent(batch); + if (!snapshotEvent) + return batch; + + this.#logger?.debug(`Persisting ${Event.describe(snapshotEvent)}`); + + await this.#snapshotStorage.saveAggregateSnapshot(snapshotEvent); + + return batch.filter(e => e !== snapshotEvent); + } + + async revert(batch: EventBatch): Promise { + if (!this.#snapshotStorage) + return; + + const snapshotEvent = this.#extractSnapshotEvent(batch); + if (!snapshotEvent) + return; + + this.#logger?.debug(`Removing ${Event.describe(snapshotEvent)}`); + + await this.#snapshotStorage?.deleteAggregateSnapshot(snapshotEvent); + } +} diff --git a/src/dispatch-pipeline/index.ts b/src/dispatch-pipeline/index.ts new file mode 100644 index 0000000..43ec39a --- /dev/null +++ b/src/dispatch-pipeline/index.ts @@ -0,0 +1,3 @@ +export * from './EventPersistenceProcessor'; +export * from './EventValidationProcessor'; +export * from './SnapshotPersistenceProcessor'; diff --git a/src/infrastructure/memory/InMemoryEventStorage.ts b/src/in-memory/InMemoryEventStorage.ts similarity index 84% rename from src/infrastructure/memory/InMemoryEventStorage.ts rename to src/in-memory/InMemoryEventStorage.ts index c78dc36..a77def8 100644 --- a/src/infrastructure/memory/InMemoryEventStorage.ts +++ b/src/in-memory/InMemoryEventStorage.ts @@ -1,17 +1,27 @@ -import { IEvent } from "../../interfaces/IEvent"; -import { IEventSet } from "../../interfaces/IEventSet"; -import { EventQueryAfter, IEventStorage } from "../../interfaces/IEventStorage"; -import { IEventStream } from "../../interfaces/IEventStream"; +import { + IIdentifierProvider, + IEvent, + IEventSet, + EventQueryAfter, + IEventStoreReader, + IEventStream, + IEventStoreWriter +} from "../interfaces"; import { nextCycle } from "./utils"; /** * A simple event storage implementation intended to use for tests only. * Storage content resets on each app restart. */ -export class InMemoryEventStorage implements IEventStorage { +export class InMemoryEventStorage implements IEventStoreReader, IEventStoreWriter, IIdentifierProvider { #nextId: number = 0; #events: IEventSet = []; + getNewId(): string { + this.#nextId += 1; + return String(this.#nextId); + } + async commitEvents(events: IEventSet): Promise { await nextCycle(); @@ -66,9 +76,4 @@ export class InMemoryEventStorage implements IEventStorage { yield event; } } - - getNewId(): string { - this.#nextId += 1; - return String(this.#nextId); - } } diff --git a/src/infrastructure/memory/InMemoryLock.ts b/src/in-memory/InMemoryLock.ts similarity index 100% rename from src/infrastructure/memory/InMemoryLock.ts rename to src/in-memory/InMemoryLock.ts diff --git a/src/infrastructure/memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts similarity index 99% rename from src/infrastructure/memory/InMemoryMessageBus.ts rename to src/in-memory/InMemoryMessageBus.ts index b14548e..c8f43f3 100644 --- a/src/infrastructure/memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -4,7 +4,7 @@ import { IMessageBus, IMessageHandler, IObservable -} from "../../interfaces"; +} from "../interfaces"; /** * Default implementation of the message bus. diff --git a/src/infrastructure/memory/InMemorySnapshotStorage.ts b/src/in-memory/InMemorySnapshotStorage.ts similarity index 70% rename from src/infrastructure/memory/InMemorySnapshotStorage.ts rename to src/in-memory/InMemorySnapshotStorage.ts index 7943217..5ac8183 100644 --- a/src/infrastructure/memory/InMemorySnapshotStorage.ts +++ b/src/in-memory/InMemorySnapshotStorage.ts @@ -1,4 +1,4 @@ -import { IAggregateSnapshotStorage, Identifier, IEvent } from "../../interfaces"; +import { IAggregateSnapshotStorage, Identifier, IEvent } from "../interfaces"; /** * In-memory storage for aggregate snapshots. @@ -24,4 +24,14 @@ export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { this.#snapshots.set(snapshotEvent.aggregateId, snapshotEvent); } + + /** + * Delete aggregate snapshot + */ + deleteAggregateSnapshot(snapshotEvent: IEvent): Promise | void { + if (!snapshotEvent.aggregateId) + throw new TypeError('snapshotEvent.aggregateId argument required'); + + this.#snapshots.delete(snapshotEvent.aggregateId); + } } diff --git a/src/infrastructure/memory/InMemoryView.ts b/src/in-memory/InMemoryView.ts similarity index 98% rename from src/infrastructure/memory/InMemoryView.ts rename to src/in-memory/InMemoryView.ts index 9fc90f7..abd6e1b 100644 --- a/src/infrastructure/memory/InMemoryView.ts +++ b/src/in-memory/InMemoryView.ts @@ -1,5 +1,5 @@ import { InMemoryLock } from './InMemoryLock'; -import { IViewLocker, Identifier, IObjectStorage } from "../../interfaces"; +import { IViewLocker, Identifier, IObjectStorage } from "../interfaces"; import { nextCycle } from './utils'; /** diff --git a/src/infrastructure/memory/index.ts b/src/in-memory/index.ts similarity index 100% rename from src/infrastructure/memory/index.ts rename to src/in-memory/index.ts diff --git a/src/infrastructure/memory/utils/Deferred.ts b/src/in-memory/utils/Deferred.ts similarity index 100% rename from src/infrastructure/memory/utils/Deferred.ts rename to src/in-memory/utils/Deferred.ts diff --git a/src/infrastructure/memory/utils/index.ts b/src/in-memory/utils/index.ts similarity index 100% rename from src/infrastructure/memory/utils/index.ts rename to src/in-memory/utils/index.ts diff --git a/src/infrastructure/memory/utils/nextCycle.ts b/src/in-memory/utils/nextCycle.ts similarity index 100% rename from src/infrastructure/memory/utils/nextCycle.ts rename to src/in-memory/utils/nextCycle.ts diff --git a/src/index.ts b/src/index.ts index bd3b6bd..27d5d0b 100644 --- a/src/index.ts +++ b/src/index.ts @@ -8,9 +8,9 @@ export * from './AggregateCommandHandler'; export * from './AbstractSaga'; export * from './SagaEventHandler'; export * from './AbstractProjection'; +export * from './EventDispatcher'; -export * from './infrastructure/memory'; -export * as SQLite from './infrastructure/sqlite'; +export * from './in-memory'; export * as Event from './Event'; export { diff --git a/src/interfaces/IAggregateSnapshotStorage.ts b/src/interfaces/IAggregateSnapshotStorage.ts index 41c293d..e938b4c 100644 --- a/src/interfaces/IAggregateSnapshotStorage.ts +++ b/src/interfaces/IAggregateSnapshotStorage.ts @@ -5,4 +5,6 @@ export interface IAggregateSnapshotStorage { getAggregateSnapshot(aggregateId: Identifier): Promise | undefined> | IEvent | undefined; saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; + + deleteAggregateSnapshot(snapshotEvent: IEvent): Promise | void; } diff --git a/src/interfaces/ICommandBus.ts b/src/interfaces/ICommandBus.ts index 87e2f59..38907f8 100644 --- a/src/interfaces/ICommandBus.ts +++ b/src/interfaces/ICommandBus.ts @@ -1,16 +1,14 @@ import { ICommand } from "./ICommand"; import { IEventSet } from "./IEventSet"; -import { IMessageHandler, IObservable } from "./IObservable"; +import { IObservable } from "./IObservable"; import { IObserver } from "./IObserver"; export interface ICommandBus extends IObservable { - send(commandType: string, aggregateId: string, options: { payload?: object, context?: object }): + send(commandType: string, aggregateId: string | undefined, options: { payload?: object, context?: object }): Promise; sendRaw(command: ICommand): Promise; - - on(type: string, handler: IMessageHandler): void; } export interface ICommandHandler extends IObserver { diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts index 4d54f07..70af6ee 100644 --- a/src/interfaces/IEvent.ts +++ b/src/interfaces/IEvent.ts @@ -1,4 +1,5 @@ import { IMessage } from "./IMessage"; +import { isObject } from "./isObject"; export type IEvent = IMessage & { /** Unique event identifier */ diff --git a/src/interfaces/IEventBus.ts b/src/interfaces/IEventBus.ts new file mode 100644 index 0000000..c358a06 --- /dev/null +++ b/src/interfaces/IEventBus.ts @@ -0,0 +1,11 @@ +import { IEvent } from "./IEvent"; +import { IObservable, isIObservable } from "./IObservable"; + +export interface IEventBus extends IObservable { + publish(event: IEvent): Promise; +} + +export const isIEventBus = (obj: unknown) => + isIObservable(obj) + && 'publish' in obj + && typeof obj.publish === 'function'; diff --git a/src/interfaces/IEventDispatcher.ts b/src/interfaces/IEventDispatcher.ts new file mode 100644 index 0000000..9acfda5 --- /dev/null +++ b/src/interfaces/IEventDispatcher.ts @@ -0,0 +1,7 @@ +import { IEventSet } from "./IEventSet"; +import { IEventBus } from "./IEventBus"; + +export interface IEventDispatcher { + readonly eventBus: IEventBus; + dispatch(events: IEventSet): Promise; +} diff --git a/src/interfaces/IEventProcessor.ts b/src/interfaces/IEventProcessor.ts new file mode 100644 index 0000000..ee7c28b --- /dev/null +++ b/src/interfaces/IEventProcessor.ts @@ -0,0 +1,24 @@ +import { IEvent } from "./IEvent"; + +/** + * Represents a wrapper for an event that can optionally contain additional metadata. + * Used to extend event processing with context-specific data required by processors. + */ +type EventEnvelope = { + event?: IEvent; +} + +/** + * A batch of event envelopes. Can contain custom envelope types extending EventEnvelope. + */ +export type EventBatch = Readonly>; + +/** + * Defines a processor that operates on a batch of event envelopes. + * Allows transformations, side-effects, or filtering of events during dispatch. + */ +export interface IEventProcessor { + process(batch: EventBatch): Promise>; + revert?(batch: EventBatch): Promise; +} + diff --git a/src/interfaces/IEventSet.ts b/src/interfaces/IEventSet.ts index fcde354..e54caf5 100644 --- a/src/interfaces/IEventSet.ts +++ b/src/interfaces/IEventSet.ts @@ -1,6 +1,3 @@ import { IEvent } from "./IEvent"; -/** - * @deprecated Try to use `IEventStream` instead - */ export type IEventSet = ReadonlyArray>; diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorage.ts index cbd1cfe..9fa0dca 100644 --- a/src/interfaces/IEventStorage.ts +++ b/src/interfaces/IEventStorage.ts @@ -2,6 +2,7 @@ import { Identifier } from "./Identifier"; import { IEvent } from "./IEvent"; import { IEventSet } from "./IEventSet"; import { IEventStream } from "./IEventStream"; +import { isObject } from "./isObject"; export type EventQueryAfter = { /** Get events emitted after this specific event */ @@ -13,17 +14,36 @@ export type EventQueryBefore = { beforeEvent?: IEvent; } -export interface IEventStorage { +export interface IEventStoreReader { /** - * Create unique identifier + * Retrieves events of specified types that were emitted after a given event. */ - getNewId(): Identifier | Promise; + getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; - commitEvents(events: IEventSet): Promise; + /** + * Retrieves all events (and optionally a snapshot) associated with a specific aggregate. + */ + getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): IEventStream; - getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; + /** + * Retrieves events associated with a saga, with optional filtering by version or timestamp. + */ + getSagaEvents(sagaId: Identifier, options: EventQueryBefore): IEventStream; +} - getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): Promise | IEventStream; +export const isIEventStoreReader = (storage: unknown): storage is IEventStoreReader => + isObject(storage) + && 'getEventsByTypes' in storage + && typeof storage.getEventsByTypes === 'function' + && 'getAggregateEvents' in storage + && typeof storage.getAggregateEvents === 'function' + && 'getSagaEvents' in storage + && typeof storage.getSagaEvents === 'function'; - getSagaEvents(sagaId: Identifier, options: EventQueryBefore): Promise | IEventStream; +export interface IEventStoreWriter { + /** + * Persists a set of events to the event store. + * Returns the persisted event set (potentially enriched or normalized). + */ + commitEvents(events: IEventSet): Promise; } diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index 21954f6..67ace1e 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,26 +1,13 @@ -import { Identifier } from "./Identifier"; +import { IEventDispatcher } from "./IEventDispatcher"; import { IEvent } from "./IEvent"; -import { IEventSet } from "./IEventSet"; -import { EventQueryAfter, EventQueryBefore } from "./IEventStorage"; -import { IEventStream } from "./IEventStream"; +import { IEventStoreReader } from "./IEventStorage"; +import { IIdentifierProvider } from "./IIdentifierProvider"; import { IMessageHandler, IObservable } from "./IObservable"; -export interface IEventStore extends IObservable { - readonly snapshotsSupported?: boolean; +export interface IEventStore + extends IObservable, IEventDispatcher, IEventStoreReader, IIdentifierProvider { - getNewId(): Identifier | Promise; - - commit(events: IEventSet): Promise; - - getEventsByTypes(eventTypes: Readonly, options?: EventQueryAfter): IEventStream; - - getAggregateEvents(aggregateId: Identifier, options?: { snapshot?: IEvent }): IEventStream; - - getSagaEvents(sagaId: Identifier, options: EventQueryBefore): IEventStream; + registerSagaStarters(startsWith: string[] | undefined): void; once(messageTypes: string | string[], handler?: IMessageHandler, filter?: (e: IEvent) => boolean): Promise; - - queue(name: string): IObservable; - - registerSagaStarters(startsWith: string[] | undefined): void; } diff --git a/src/interfaces/IIdentifierProvider.ts b/src/interfaces/IIdentifierProvider.ts new file mode 100644 index 0000000..30b8be9 --- /dev/null +++ b/src/interfaces/IIdentifierProvider.ts @@ -0,0 +1,16 @@ +import { Identifier } from "./Identifier"; +import { isObject } from "./isObject"; + +export interface IIdentifierProvider { + /** + * Generates and returns a new unique identifier suitable for aggregates, sagas, and events. + * + * @returns A promise resolving to an identifier or an identifier itself. + */ + getNewId(): Identifier | Promise; +} + +export const isIdentifierProvider = (obj: any): obj is IIdentifierProvider => + isObject(obj) + && 'getNewId' in obj + && typeof obj.getNewId === 'function'; diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index c40dc95..c474e3b 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -1,4 +1,5 @@ import { Identifier } from "./Identifier"; +import { isObject } from "./isObject"; export interface IMessage { /** Event or command type */ @@ -13,3 +14,8 @@ export interface IMessage { payload?: TPayload; context?: any; } + +export const isMessage = (obj: unknown): obj is IMessage => + isObject(obj) + && 'type' in obj + && typeof obj.type === 'string'; diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts index dc824fd..076b85b 100644 --- a/src/interfaces/IObservable.ts +++ b/src/interfaces/IObservable.ts @@ -1,5 +1,8 @@ +import { IMessage } from "./IMessage"; +import { isObject } from "./isObject"; + export interface IMessageHandler { - (...args: any[]): any | Promise + (message: IMessage): any | Promise }; export interface IObservable { @@ -18,3 +21,10 @@ export interface IObservable { */ queue?(name: string): IObservable; } + +export const isIObservable = (obj: unknown): obj is IObservable => + isObject(obj) + && 'on' in obj + && typeof obj.on === 'function' + && 'off' in obj + && typeof obj.off === 'function'; diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index b81c515..a78ae56 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -4,12 +4,16 @@ export * from './ICommand'; export * from './ICommandBus'; export * from './Identifier'; export * from './IEvent'; +export * from './IEventBus'; +export * from './IEventDispatcher'; export * from './IEventLocker'; +export * from './IEventProcessor'; export * from './IEventReceptor'; export * from './IEventSet'; export * from './IEventStorage'; export * from './IEventStore'; export * from './IEventStream'; +export * from './IIdentifierProvider'; export * from './ILogger'; export * from './IMessage'; export * from './IMessageBus'; diff --git a/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts b/src/sqlite/AbstractSqliteObjectProjection.ts similarity index 85% rename from src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts rename to src/sqlite/AbstractSqliteObjectProjection.ts index 5c13f9a..59efb63 100644 --- a/src/infrastructure/sqlite/AbstractSqliteObjectProjection.ts +++ b/src/sqlite/AbstractSqliteObjectProjection.ts @@ -1,5 +1,5 @@ -import { AbstractProjection } from "../../AbstractProjection"; -import { IExtendableLogger } from "../../interfaces"; +import { AbstractProjection } from "../AbstractProjection"; +import { IExtendableLogger } from "../interfaces"; import { SqliteDbParams } from "./commonParams"; import { SqliteObjectView } from "./SqliteObjectView"; diff --git a/src/infrastructure/sqlite/AbstractSqliteView.ts b/src/sqlite/AbstractSqliteView.ts similarity index 92% rename from src/infrastructure/sqlite/AbstractSqliteView.ts rename to src/sqlite/AbstractSqliteView.ts index 224aa97..e4a01e4 100644 --- a/src/infrastructure/sqlite/AbstractSqliteView.ts +++ b/src/sqlite/AbstractSqliteView.ts @@ -1,8 +1,8 @@ -import { IEvent, IEventLocker, ILogger } from '../../interfaces'; +import { IEvent, IEventLocker, ILogger } from '../interfaces'; import { Database } from 'better-sqlite3'; import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; -import { IViewLocker } from '../../interfaces'; +import { IViewLocker } from '../interfaces'; export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { diff --git a/src/infrastructure/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts similarity index 98% rename from src/infrastructure/sqlite/SqliteEventLocker.ts rename to src/sqlite/SqliteEventLocker.ts index f99edcc..95cb6b1 100644 --- a/src/infrastructure/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -1,5 +1,5 @@ import { Database, Statement } from 'better-sqlite3'; -import { IEvent, IEventLocker } from '../../interfaces'; +import { IEvent, IEventLocker } from '../interfaces'; import { getEventId } from './utils'; import { viewLockTableInit, eventLockTableInit } from './queries'; import { SqliteViewLockerParams } from './SqliteViewLocker'; diff --git a/src/infrastructure/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts similarity index 98% rename from src/infrastructure/sqlite/SqliteObjectStorage.ts rename to src/sqlite/SqliteObjectStorage.ts index 83a7347..ea0fc49 100644 --- a/src/infrastructure/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -1,6 +1,6 @@ import { Statement, Database } from 'better-sqlite3'; import { guid } from './utils'; -import { IObjectStorage } from '../../interfaces'; +import { IObjectStorage } from '../interfaces'; export class SqliteObjectStorage implements IObjectStorage { diff --git a/src/infrastructure/sqlite/SqliteObjectView.ts b/src/sqlite/SqliteObjectView.ts similarity index 97% rename from src/infrastructure/sqlite/SqliteObjectView.ts rename to src/sqlite/SqliteObjectView.ts index e7956a3..9a99f6a 100644 --- a/src/infrastructure/sqlite/SqliteObjectView.ts +++ b/src/sqlite/SqliteObjectView.ts @@ -1,5 +1,5 @@ import { AbstractSqliteView } from "./AbstractSqliteView"; -import { IObjectStorage, IEventLocker } from '../../interfaces'; +import { IObjectStorage, IEventLocker } from '../interfaces'; import { SqliteObjectStorage } from './SqliteObjectStorage'; export class SqliteObjectView extends AbstractSqliteView implements IObjectStorage, IEventLocker { diff --git a/src/infrastructure/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts similarity index 97% rename from src/infrastructure/sqlite/SqliteViewLocker.ts rename to src/sqlite/SqliteViewLocker.ts index a6a09af..2073698 100644 --- a/src/infrastructure/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -1,6 +1,6 @@ import { Database, Statement } from 'better-sqlite3'; -import { IExtendableLogger, ILogger, IViewLocker } from '../../interfaces'; -import { Deferred } from '../memory'; +import { IExtendableLogger, ILogger, IViewLocker } from '../interfaces'; +import { Deferred } from '../in-memory'; import { promisify } from 'util'; import { viewLockTableInit } from './queries'; import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; diff --git a/src/infrastructure/sqlite/commonParams.ts b/src/sqlite/commonParams.ts similarity index 100% rename from src/infrastructure/sqlite/commonParams.ts rename to src/sqlite/commonParams.ts diff --git a/src/infrastructure/sqlite/index.ts b/src/sqlite/index.ts similarity index 100% rename from src/infrastructure/sqlite/index.ts rename to src/sqlite/index.ts diff --git a/src/infrastructure/sqlite/queries/eventLockTableInit.ts b/src/sqlite/queries/eventLockTableInit.ts similarity index 100% rename from src/infrastructure/sqlite/queries/eventLockTableInit.ts rename to src/sqlite/queries/eventLockTableInit.ts diff --git a/src/infrastructure/sqlite/queries/index.ts b/src/sqlite/queries/index.ts similarity index 100% rename from src/infrastructure/sqlite/queries/index.ts rename to src/sqlite/queries/index.ts diff --git a/src/infrastructure/sqlite/queries/viewLockTableInit.ts b/src/sqlite/queries/viewLockTableInit.ts similarity index 100% rename from src/infrastructure/sqlite/queries/viewLockTableInit.ts rename to src/sqlite/queries/viewLockTableInit.ts diff --git a/src/infrastructure/sqlite/utils/getEventId.ts b/src/sqlite/utils/getEventId.ts similarity index 83% rename from src/infrastructure/sqlite/utils/getEventId.ts rename to src/sqlite/utils/getEventId.ts index 62fc2ac..6d86ec3 100644 --- a/src/infrastructure/sqlite/utils/getEventId.ts +++ b/src/sqlite/utils/getEventId.ts @@ -1,6 +1,6 @@ -import { IEvent } from "../../../interfaces"; -import * as md5 from 'md5'; +import { IEvent } from "../../interfaces"; import { guid } from './guid'; +import * as md5 from 'md5'; /** * Get assigned or generate new event ID from event content diff --git a/src/infrastructure/sqlite/utils/guid.ts b/src/sqlite/utils/guid.ts similarity index 100% rename from src/infrastructure/sqlite/utils/guid.ts rename to src/sqlite/utils/guid.ts diff --git a/src/infrastructure/sqlite/utils/index.ts b/src/sqlite/utils/index.ts similarity index 100% rename from src/infrastructure/sqlite/utils/index.ts rename to src/sqlite/utils/index.ts diff --git a/src/utils/CompoundEmitter.ts b/src/utils/CompoundEmitter.ts deleted file mode 100644 index 3e2c2a5..0000000 --- a/src/utils/CompoundEmitter.ts +++ /dev/null @@ -1,45 +0,0 @@ -import { IObservable, IMessageHandler } from "../interfaces"; -import { isIObservable } from "./isIObservable"; - -interface IObservableQueueProvider extends Required> { } - -const isObservableQueueProvider = (obj: any): obj is IObservableQueueProvider => - obj - && 'queue' in obj - && typeof obj.queue === 'function'; - -export class CompoundEmitter implements IObservable { - - #emitters: IObservable[]; - #queueProvider?: IObservableQueueProvider; - - constructor(...emitters: any[]) { - const observableEmitters = emitters.filter(isIObservable); - if (!observableEmitters.length) - throw new TypeError('none of the arguments implement IObservable interface'); - - const queueProviders = emitters.filter(isObservableQueueProvider); - if (queueProviders.length > 1) - throw new TypeError('more than one argument implements IObservable `queue` method'); - - this.#emitters = observableEmitters; - this.#queueProvider = queueProviders[0]; - } - - on(type: string, handler: IMessageHandler): void { - for (const emitter of this.#emitters) - emitter.on(type, handler); - } - - off(type: string, handler: IMessageHandler): void { - for (const emitter of this.#emitters) - emitter.off(type, handler); - } - - queue(name: string): IObservable { - if (!this.#queueProvider) - throw new Error('none of the emitters support named queues'); - - return this.#queueProvider.queue(name); - } -} diff --git a/src/utils/delay.ts b/src/utils/delay.ts new file mode 100644 index 0000000..8663de4 --- /dev/null +++ b/src/utils/delay.ts @@ -0,0 +1,8 @@ +/** + * Returns a promise that resolves after the specified number of milliseconds. + * The internal timeout is unref'd to avoid blocking Node.js process termination. + */ +export const delay = (ms: number) => new Promise(resolve => { + const t = setTimeout(resolve, ms); + t.unref(); +}); diff --git a/src/utils/index.ts b/src/utils/index.ts index 560c457..0ec92ea 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,12 +1,10 @@ -export * from './CompoundEmitter'; +export * from './delay'; export * from './getClassName'; export * from './getHandler'; export * from './getMessageHandlerNames'; export * from './isClass'; -export * from './isIEventStorage'; -export * from './isIMessageBus'; -export * from './isIObservable'; export * from './iteratorToArray'; +export * from './notEmpty'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; export * from './validateHandlers'; diff --git a/src/utils/isIEventStorage.ts b/src/utils/isIEventStorage.ts deleted file mode 100644 index bbe7cf2..0000000 --- a/src/utils/isIEventStorage.ts +++ /dev/null @@ -1,8 +0,0 @@ -import { IEventStorage } from "../interfaces"; - -export const isIEventStorage = (storage: IEventStorage): storage is IEventStorage => storage - && typeof storage.getNewId === 'function' - && typeof storage.commitEvents === 'function' - && typeof storage.getEventsByTypes === 'function' - && typeof storage.getAggregateEvents === 'function' - && typeof storage.getSagaEvents === 'function'; diff --git a/src/utils/isIMessageBus.ts b/src/utils/isIMessageBus.ts deleted file mode 100644 index 4a47228..0000000 --- a/src/utils/isIMessageBus.ts +++ /dev/null @@ -1,9 +0,0 @@ -import { IMessageBus } from "../interfaces"; -import { isIObservable } from "."; - -export const isIMessageBus = (bus: IMessageBus | any): bus is IMessageBus => bus - && isIObservable(bus) - && 'send' in bus - && typeof bus.send === 'function' - && 'publish' in bus - && typeof bus.publish === 'function'; diff --git a/src/utils/isIObservable.ts b/src/utils/isIObservable.ts deleted file mode 100644 index 191627c..0000000 --- a/src/utils/isIObservable.ts +++ /dev/null @@ -1,7 +0,0 @@ -import { IObservable } from "../interfaces"; - -export const isIObservable = (obj: IObservable | any): obj is IObservable => obj - && 'on' in obj - && typeof obj.on === 'function' - && 'off' in obj - && typeof obj.off === 'function'; diff --git a/src/utils/notEmpty.ts b/src/utils/notEmpty.ts new file mode 100644 index 0000000..0573fdd --- /dev/null +++ b/src/utils/notEmpty.ts @@ -0,0 +1 @@ +export const notEmpty = (t: T): t is Exclude => t !== undefined && t !== null; diff --git a/tests/integration/SqliteView.test.ts b/tests/integration/sqlite/SqliteView.test.ts similarity index 73% rename from tests/integration/SqliteView.test.ts rename to tests/integration/sqlite/SqliteView.test.ts index c84797d..c50916e 100644 --- a/tests/integration/SqliteView.test.ts +++ b/tests/integration/sqlite/SqliteView.test.ts @@ -1,7 +1,6 @@ - import { existsSync, unlinkSync } from 'fs'; -import { AbstractProjection, IEvent } from '../../src'; -import { SqliteObjectView } from '../../src/infrastructure/sqlite'; +import { AbstractProjection, IEvent } from '../../../src'; +import { SqliteObjectView } from '../../../src/sqlite'; import * as createDb from 'better-sqlite3'; type UserPayload = { @@ -34,14 +33,6 @@ describe.only('SqliteView', () => { let viewModelSqliteDb: import('better-sqlite3').Database; - const logState = () => { - console.log({ - tbl_view_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock`).all(), - tbl_test_1_event_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1_event_lock`).all(), - tbl_test_1: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1`).all() - }); - } - const fileName = './test.sqlite'; beforeEach(() => { @@ -72,7 +63,7 @@ describe.only('SqliteView', () => { // on file system - 44_396 ms (225 events/second) // on file system with WAL and NORMAL sync - 551 ms (18_148 events/second) - it('handles 10_000 events within 0.5 seconds', async () => { + it('handles 1_000 events within 0.5 seconds', async () => { const p = new MyDumbProjection({ view: new SqliteObjectView({ @@ -86,18 +77,17 @@ describe.only('SqliteView', () => { await p.view.lock(); await p.view.unlock(); - const aggregateIds = Array.from({ length: 5_000 }, (v, i) => ({ - id1: `${i}A`, - id2: `${i}B`, - id3: `${i}C` + const aggregateIds = Array.from({ length: 1_000 }, (v, i) => ({ + aggregateId: `${i}A`.padStart(32, '0'), + eventId: `${i}B`.padStart(32, '0') })); - console.time(); + const startTs = Date.now(); - for (const { id1: aggregateId, id2, id3 } of aggregateIds) { + for (const { aggregateId, eventId } of aggregateIds) { await p.project({ type: 'userCreated', - id: id2, + id: eventId, aggregateId, payload: { name: 'Jon' @@ -106,7 +96,6 @@ describe.only('SqliteView', () => { await p.project({ type: 'userModified', - id: id3, aggregateId, payload: { name: 'Jon Doe' @@ -114,14 +103,18 @@ describe.only('SqliteView', () => { }); } - console.timeEnd(); - - // logState(); + const totalMs = Date.now() - startTs; + expect(totalMs).toBeLessThan(500); - // const user = await p.view.get(aggregateId); + const user = await p.view.get('0000000000000000000000000000999A'); + expect(user).toEqual({ + name: 'Jon Doe' + }); - // expect(user).toEqual({ - // name: 'Jon Doe' + // console.log({ + // tbl_view_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock LIMIT 3`).all(), + // tbl_test_1_event_lock: viewModelSqliteDb.prepare(`SELECT * FROM tbl_event_lock LIMIT 3`).all(), + // tbl_test_1: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1 LIMIT 3`).all() // }); }); }); diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index 4abada0..818ee8f 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -1,6 +1,13 @@ import { expect, assert, AssertionError } from 'chai'; import * as sinon from 'sinon'; -import { AbstractProjection, InMemoryView, InMemoryEventStorage, EventStore, InMemoryMessageBus } from '../../src'; +import { + AbstractProjection, + InMemoryView, + InMemoryEventStorage, + EventStore, + InMemoryMessageBus, + EventDispatcher +} from '../../src'; class MyProjection extends AbstractProjection> { static get handles() { @@ -162,8 +169,9 @@ describe('AbstractProjection', function () { it('waits until the restoring process is done', async () => { const storage = new InMemoryEventStorage(); - const supplementaryEventBus = new InMemoryMessageBus(); - const es = new EventStore({ storage, supplementaryEventBus }); + const eventBus = new InMemoryMessageBus(); + const eventDispatcher = new EventDispatcher({ eventBus }); + const es = new EventStore({ storage, eventBus, eventDispatcher, identifierProvider: storage }); let restored = false; let projected = false; diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index 76bd7ec..c19f82f 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -1,6 +1,6 @@ import { expect, assert } from 'chai'; import * as sinon from 'sinon'; -import { ICommandBus, Identifier, IEventSet, IEventStore, IMessageBus, InMemoryMessageBus } from '../../src'; +import { EventDispatcher, ICommandBus, Identifier, IEventBus, IEventSet, IEventStore, InMemoryMessageBus } from '../../src'; import { AggregateCommandHandler, @@ -47,21 +47,22 @@ describe('AggregateCommandHandler', function () { let snapshotStorage: InMemorySnapshotStorage; let eventStore: IEventStore; let commandBus: ICommandBus; - let supplementaryEventBus: IMessageBus; + let eventBus: IEventBus; let onSpy; let getNewIdSpy; let getAggregateEventsSpy; let commitSpy; beforeEach(() => { - supplementaryEventBus = new InMemoryMessageBus(); + eventBus = new InMemoryMessageBus(); storage = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); + const eventDispatcher = new EventDispatcher({ eventBus }); - eventStore = new EventStore({ storage, snapshotStorage, supplementaryEventBus }); + eventStore = new EventStore({ storage, snapshotStorage, eventBus, eventDispatcher, identifierProvider: storage }); getNewIdSpy = sinon.spy(eventStore, 'getNewId'); getAggregateEventsSpy = sinon.spy(eventStore, 'getAggregateEvents'); - commitSpy = sinon.spy(eventStore, 'commit'); + commitSpy = sinon.spy(eventStore, 'dispatch'); commandBus = new CommandBus() as any; onSpy = sinon.spy(commandBus, 'on'); diff --git a/tests/unit/CqrsContainerBuilder.test.ts b/tests/unit/CqrsContainerBuilder.test.ts index 2a83b92..37fe640 100644 --- a/tests/unit/CqrsContainerBuilder.test.ts +++ b/tests/unit/CqrsContainerBuilder.test.ts @@ -15,8 +15,8 @@ describe('CqrsContainerBuilder', function () { beforeEach(() => { builder = new ContainerBuilder(); - builder.register(InMemoryEventStorage).as('storage'); - builder.register(InMemoryMessageBus).as('supplementaryEventBus'); + builder.register(InMemoryEventStorage).as('storage').as('identifierProvider'); + builder.register(InMemoryMessageBus).as('eventBus'); }); describe('registerAggregate(aggregateType) extension', () => { @@ -81,7 +81,7 @@ describe('CqrsContainerBuilder', function () { { type: 'somethingHappened', aggregateId: 1 } ]; - container.eventStore.commit(events).catch(done); + container.eventStore.dispatch(events).catch(done); }); }); diff --git a/tests/unit/EventDispatcher.test.ts b/tests/unit/EventDispatcher.test.ts new file mode 100644 index 0000000..45bde3f --- /dev/null +++ b/tests/unit/EventDispatcher.test.ts @@ -0,0 +1,100 @@ +import { IEvent, IEventBus, IEventProcessor } from '../../src'; +import { EventDispatcher } from '../../src/EventDispatcher'; + +describe('EventDispatcher', () => { + let dispatcher: EventDispatcher; + let eventBus: jest.Mocked; + + beforeEach(() => { + eventBus = { publish: jest.fn() }; + dispatcher = new EventDispatcher({ eventBus }); + }); + + it('dispatches events through processors and dispatches', async () => { + + const event1: IEvent = { type: 'test-event-1' }; + const event2: IEvent = { type: 'test-event-2' }; + + const processorMock: IEventProcessor = { + process: jest.fn(batch => Promise.resolve(batch)), + }; + + dispatcher.addPipelineProcessor(processorMock); + const result = await dispatcher.dispatch([event1, event2]); + + expect(processorMock.process).toHaveBeenCalledTimes(1); + expect(eventBus.publish).toHaveBeenCalledTimes(2); + expect(eventBus.publish).toHaveBeenCalledWith(event1); + expect(eventBus.publish).toHaveBeenCalledWith(event2); + expect(result).toEqual([event1, event2]); + }); + + it('handles processor errors and invokes revert', async () => { + + const event: IEvent = { type: 'failing-event' }; + const error = new Error('processor error'); + + const processorMock: IEventProcessor = { + process: jest.fn().mockRejectedValue(error), + revert: jest.fn().mockResolvedValue(undefined), + }; + + dispatcher.addPipelineProcessor(processorMock); + + await expect(dispatcher.dispatch([event])).rejects.toThrow('processor error'); + + expect(processorMock.process).toHaveBeenCalledTimes(1); + expect(processorMock.revert).toHaveBeenCalledTimes(1); + expect(eventBus.publish).not.toHaveBeenCalled(); + }); + + it('throws if dispatch called with empty event array', async () => { + + await expect(dispatcher.dispatch([])).rejects.toThrow('dispatch requires a non-empty array of events'); + }); + + it('runs multiple processors sequentially while processing batches in parallel', async () => { + + const executionOrder: string[] = []; + + const processorA: IEventProcessor = { + process: jest.fn(async batch => { + executionOrder.push(`A-start-${batch[0].event.type}`); + await new Promise(res => setTimeout(res, 5)); + executionOrder.push(`A-end-${batch[0].event.type}`); + return batch; + }), + }; + + const processorB: IEventProcessor = { + process: jest.fn(async batch => { + executionOrder.push(`B-start-${batch[0].event.type}`); + await new Promise(res => setTimeout(res, 5)); + executionOrder.push(`B-end-${batch[0].event.type}`); + return batch; + }), + }; + + dispatcher.addPipelineProcessor(processorA); + dispatcher.addPipelineProcessor(processorB); + + const event1: IEvent = { type: 'event-1' }; + const event2: IEvent = { type: 'event-2' }; + + await Promise.all([ + dispatcher.dispatch([event1]), + dispatcher.dispatch([event2]), + ]); + + expect(executionOrder).toEqual([ + 'A-start-event-1', + 'A-start-event-2', + 'A-end-event-1', + 'B-start-event-1', + 'A-end-event-2', + 'B-start-event-2', + 'B-end-event-1', + 'B-end-event-2', + ]); + }); +}); diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index 5113df0..16c89a4 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -1,331 +1,178 @@ -import { expect } from 'chai'; -import * as sinon from 'sinon'; +import { EventDispatcher } from '../../dist/EventDispatcher'; +import { IEventDispatcher, InMemoryMessageBus } from '../../src'; import { EventStore } from '../../src/EventStore'; -import { InMemoryEventStorage, InMemorySnapshotStorage, InMemoryMessageBus } from '../../src'; -import { IAggregateSnapshotStorage, IEvent, IEventStorage, IEventStore, IMessageBus } from '../../src/interfaces'; -import { iteratorToArray } from '../../src/utils'; - -const goodContext = { - uid: '1', - ip: '127.0.0.1', - browser: 'test', - serverTime: Date.now() -}; - -const goodEvent = { - aggregateId: '1', - aggregateVersion: 0, - type: 'somethingHappened', - context: goodContext -}; - -const goodEvent2 = { - aggregateId: '2', - aggregateVersion: 0, - type: 'somethingHappened', - context: goodContext -}; - -const snapshotEvent = { - aggregateId: '2', - aggregateVersion: 1, - type: 'snapshot', - payload: { foo: 'bar' } -}; - - -describe('EventStore', function () { - - let es: IEventStore; - let storage: IEventStorage; - let snapshotStorage: IAggregateSnapshotStorage; - let supplementaryEventBus: IMessageBus; +import { + IEvent, + IEventBus, + IEventStoreReader, + IAggregateSnapshotStorage, + IIdentifierProvider +} from '../../src/interfaces'; + +describe('EventStore', () => { + + let store: EventStore; + let eventBus: IEventBus; + let eventDispatcher: IEventDispatcher; + let mockStorage: jest.Mocked; + let mockSnapshotStorage: jest.Mocked; + let mockIdentifierProvider: jest.Mocked; + const mockId = 'test-id'; beforeEach(() => { - storage = new InMemoryEventStorage(); - snapshotStorage = new InMemorySnapshotStorage(); - supplementaryEventBus = new InMemoryMessageBus(); - es = new EventStore({ storage, snapshotStorage, supplementaryEventBus }); - }); - - describe('validator', () => { - - it('allows to validate events before they are committed', () => { - - const events = [ - { type: 'somethingHappened', aggregateId: '1' } - ]; - - return es.commit(events).then(() => { - - es = new EventStore({ - storage, - eventValidator: event => { - throw new Error('test validation error'); - }, - supplementaryEventBus - }); - - return es.commit(events).then(() => { - throw new Error('must fail'); - }, err => { - expect(err).to.have.property('message', 'test validation error'); - }); - }); + eventBus = new InMemoryMessageBus(); + eventDispatcher = new EventDispatcher({ eventBus }); + + mockStorage = { + getAggregateEvents: jest.fn().mockResolvedValue([]), + getSagaEvents: jest.fn().mockResolvedValue([]), + getEventsByTypes: jest.fn().mockResolvedValue([]) + } as any; + + mockSnapshotStorage = { + getAggregateSnapshot: jest.fn().mockResolvedValue(undefined) + } as any; + + mockIdentifierProvider = { + getNewId: jest.fn().mockResolvedValue(mockId) + } as any; + + store = new EventStore({ + eventBus, + eventDispatcher, + storage: mockStorage, + identifierProvider: mockIdentifierProvider, + snapshotStorage: mockSnapshotStorage, + logger: undefined }); }); - describe('commit', () => { + describe('dispatch', () => { - it('validates event format', () => { + it('throws error when called with non-array argument', async () => { - const badEvent = { - type: 'somethingHappened', - context: goodContext - }; - - return es.commit([badEvent]).then(() => { - throw new Error('must fail'); - }, err => { - expect(err).exist; - expect(err).to.be.an.instanceof(TypeError); - expect(err.message).to.equal('either event.aggregateId or event.sagaId is required'); - }); - }); - - it('commits events to storage', async () => { - - await es.commit([goodEvent]); - - const events: IEvent[] = []; - for await (const e of es.getEventsByTypes(['somethingHappened'], {})) - events.push(e); - - expect(events[0]).to.have.property('type', 'somethingHappened'); - expect(events[0]).to.have.property('context'); - expect(events[0].context).to.have.property('ip', goodContext.ip); + await expect(store.dispatch(null as any)).rejects.toThrow(TypeError); }); - it('submits aggregate snapshot to storage.saveAggregateSnapshot, when provided', async () => { - - snapshotStorage.getAggregateSnapshot = () => snapshotEvent as IEvent; + it('augments saga starter events with new sagaId and version', async () => { - // storage.saveAggregateSnapshot = () => { }; - const saveAggregateSnapshotSpy = sinon.spy(snapshotStorage, 'saveAggregateSnapshot'); - const commitEventsSpy = sinon.spy(storage, 'commitEvents'); + store.registerSagaStarters(['StartSaga']); + const event: IEvent = { type: 'StartSaga' } as IEvent; + const dispatchSpy = jest.spyOn(eventDispatcher, 'dispatch'); - expect(es).to.have.property('snapshotsSupported', true); + await store.dispatch([event]); - es.commit([goodEvent]); - expect(snapshotStorage).to.have.nested.property('saveAggregateSnapshot.called', false); - - es.commit([goodEvent2, snapshotEvent]); - expect(snapshotStorage).to.have.nested.property('saveAggregateSnapshot.calledOnce', true); - - { - const { args } = saveAggregateSnapshotSpy.lastCall; - expect(args).to.have.length(1); - expect(args[0]).to.eq(snapshotEvent); - } - - { - const { args } = commitEventsSpy.lastCall; - expect(args).to.have.length(1); - expect(args[0]).to.have.length(1); - expect(args[0][0]).to.have.property('type', goodEvent2.type); - } + expect(event.sagaId).toBe(mockId); + expect(event.sagaVersion).toBe(0); + expect(dispatchSpy).toHaveBeenCalledWith([event]); }); - it('returns a promise that resolves to events committed', () => es.commit([goodEvent, goodEvent2]).then(events => { - - expect(events).to.be.an('Array'); - expect(events).to.have.length(2); - expect(events).to.have.nested.property('[0].type', 'somethingHappened'); - })); + it('does not modify non-saga starter events', async () => { - it('returns a promise that rejects, when commit doesn\'t succeed', () => { - - const storage = Object.create(InMemoryEventStorage.prototype, { - commitEvents: { - value: () => { - throw new Error('storage commit failure'); - } - } - }); + const event: IEvent = { type: 'RegularEvent' } as IEvent; + const dispatchSpy = jest.spyOn(eventDispatcher, 'dispatch'); - es = new EventStore({ storage, supplementaryEventBus }); + await store.dispatch([event]); - return es.commit([goodEvent, goodEvent2]).then(() => { - throw new Error('should fail'); - }, err => { - expect(err).to.be.an('Error'); - expect(err).to.have.property('message', 'storage commit failure'); - }); + expect(event.sagaId).toBeUndefined(); + expect(event.sagaVersion).toBeUndefined(); + expect(dispatchSpy).toHaveBeenCalledWith([event]); }); }); - describe('getNewId', () => { - - it('retrieves a unique ID for new aggregate from storage', () => Promise.resolve(es.getNewId()).then(id => { - expect(id).to.equal('1'); - })); - }); - - describe('getAggregateEvents(aggregateId)', () => { - - it('returns all events committed for a specific aggregate', async () => { - - await es.commit([goodEvent, goodEvent2]); - - const events = es.getAggregateEvents(goodEvent.aggregateId); + describe('getAggregateEvents', () => { - expect(events).to.be.have.property(Symbol.asyncIterator); + it('retrieves aggregate events including snapshot if available', async () => { + const snapshotEvent = { type: 'SnapshotEvent' } as IEvent; + const storedEvents = [{ type: 'Event1' }, { type: 'Event2' }] as IEvent[]; + mockSnapshotStorage.getAggregateSnapshot.mockResolvedValueOnce(snapshotEvent); + mockStorage.getAggregateEvents.mockResolvedValueOnce(storedEvents); - const event = (await events.next()).value; - expect(event).to.have.nested.property('type', 'somethingHappened'); - }); - - it('tries to retrieve aggregate snapshot', async () => { - - snapshotStorage.getAggregateSnapshot = () => snapshotEvent as IEvent; - snapshotStorage.saveAggregateSnapshot = () => { }; - sinon.spy(snapshotStorage, 'getAggregateSnapshot'); - const getAggregateEventsSpy = sinon.spy(storage, 'getAggregateEvents'); - - expect(es).to.have.property('snapshotsSupported', true); - - const events = await iteratorToArray(es.getAggregateEvents(goodEvent2.aggregateId)); - - expect(snapshotStorage).to.have.nested.property('getAggregateSnapshot.calledOnce', true); - expect(storage).to.have.nested.property('getAggregateEvents.calledOnce', true); - - const [, eventFilter] = getAggregateEventsSpy.lastCall.args; + const result: IEvent[] = []; + for await (const event of store.getAggregateEvents('aggregate-1')) { + result.push(event); + } - expect(eventFilter).to.have.property('snapshot'); - expect(eventFilter).to.have.nested.property('snapshot.type'); - expect(eventFilter).to.have.nested.property('snapshot.aggregateId'); - expect(eventFilter).to.have.nested.property('snapshot.aggregateVersion'); + expect(result).toEqual([snapshotEvent, ...storedEvents]); + expect(mockSnapshotStorage.getAggregateSnapshot).toHaveBeenCalledWith('aggregate-1'); + expect(mockStorage.getAggregateEvents).toHaveBeenCalledWith('aggregate-1', { snapshot: snapshotEvent }); }); }); - describe('getSagaEvents(sagaId, options)', () => { + describe('getSagaEvents', () => { - it('returns events committed by saga prior to event that triggered saga execution', async () => { + it('retrieves saga events with provided filter', async () => { + const sagaEvents = [{ type: 'SagaEvent1' }] as IEvent[]; + mockStorage.getSagaEvents.mockResolvedValueOnce(sagaEvents); + const filter = { beforeEvent: { sagaVersion: 1 } }; - const events = [ - { sagaId: '1', sagaVersion: 1, type: 'somethingHappened' }, - { sagaId: '1', sagaVersion: 2, type: 'anotherHappened' }, - { sagaId: '2', sagaVersion: 1, type: 'somethingHappened' } - ]; - - const triggeredBy = events[1]; - - await es.commit(events); - - const ii = es.getSagaEvents('1', { beforeEvent: triggeredBy }); - const retrievedEvents = await iteratorToArray(ii); + const result: IEvent[] = []; + for await (const event of store.getSagaEvents('saga-1', filter)) { + result.push(event); + } - expect(retrievedEvents).to.be.an('Array'); - expect(retrievedEvents).to.have.length(1); - expect(retrievedEvents).to.have.nested.property('[0].type', 'somethingHappened'); + expect(result).toEqual(sagaEvents); + expect(mockStorage.getSagaEvents).toHaveBeenCalledWith('saga-1', filter); }); }); - describe('getEventsByTypes(eventTypes)', () => { - - it('returns a promise that resolves to all committed events of specific types', async () => { - await es.commit([goodEvent, goodEvent2]); - - const events = await iteratorToArray(es.getEventsByTypes(['somethingHappened'], {})); + describe('getNewId', () => { - expect(events).to.have.length(2); - expect(events).to.have.nested.property('[0].aggregateId', '1'); - expect(events).to.have.nested.property('[1].aggregateId', '2'); + it('delegates to the identifierProvider', async () => { + const id = await store.getNewId(); + expect(id).toBe(mockId); + expect(mockIdentifierProvider.getNewId).toHaveBeenCalled(); }); }); - describe('on(eventType, handler)', () => { - - it('exists', () => { - expect(es).to.respondTo('on'); - }); - - it('fails, when trying to set up second messageType handler within the same node and named queue (Receptors)', () => { - - es = new EventStore({ storage, supplementaryEventBus }); - - expect(() => { - es.queue('namedQueue').on('somethingHappened', () => { }); - }).to.not.throw(); - - expect(() => { - es.queue('anotherNamedQueue').on('somethingHappened', () => { }); - }).to.not.throw(); - - expect(() => { - es.queue('namedQueue').on('somethingHappened', () => { }); - }).to.throw('"somethingHappened" handler is already set up on the "namedQueue" queue'); - }); - - it('sets up multiple handlers for same messageType, when queue name is not defined (Projections)', () => { + describe('on/off/queue', () => { - es = new EventStore({ storage, supplementaryEventBus }); + it('delegates on, off, and queue calls to eventBus', () => { + const handler = jest.fn(); + const onSpy = jest.spyOn(eventBus, 'on'); + const offSpy = jest.spyOn(eventBus, 'off'); + const queueSpy = jest.spyOn(eventBus, 'queue'); - const projection1Handler = sinon.spy(); - const projection2Handler = sinon.spy(); + store.on('testEvent', handler); + expect(onSpy).toHaveBeenCalledWith('testEvent', handler); - es.on('somethingHappened', projection1Handler); - es.on('somethingHappened', projection2Handler); + store.off('testEvent', handler); + expect(offSpy).toHaveBeenCalledWith('testEvent', handler); - return es.commit([ - { type: 'somethingHappened', aggregateId: '1', aggregateVersion: 0 } - ]).then(() => { - expect(projection1Handler).to.have.property('calledOnce', true); - expect(projection2Handler).to.have.property('calledOnce', true); - }); + const queueResult = store.queue('testQueue'); + expect(queueResult).toBeInstanceOf(InMemoryMessageBus); + expect(queueSpy).toHaveBeenCalledWith('testQueue'); }); }); - describe('once(eventType, handler, filter)', () => { - - it('executes handler only once, when event matches filter', done => { - let firstAggregateCounter = 0; - let secondAggregateCounter = 0; - - es.once('somethingHappened', - event => ++firstAggregateCounter, - event => event.aggregateId === '1'); - - es.once('somethingHappened', - event => ++secondAggregateCounter, - event => event.aggregateId === '2'); + describe('once', () => { - es.commit([goodEvent, goodEvent, goodEvent, goodEvent2]); - es.commit([goodEvent2, goodEvent2]); + it('sets up a one-time subscription and resolves with an event', async () => { + let callCount = 0; + const testEvent = { type: 'onceEvent' } as IEvent; + const promise = store.once('onceEvent', (e: IEvent) => { + callCount++; + }); - setTimeout(() => { - try { - expect(firstAggregateCounter).to.equal(1); - expect(secondAggregateCounter).to.equal(1); + await store.dispatch([testEvent]); - done(); - } - catch (err) { - done(err); - } - }, 100); + expect(promise).resolves.toBe(testEvent); + expect(callCount).toBe(1); }); - it('returns a promise', () => { - - setImmediate(() => { - es.commit([goodEvent]); + it('works only once', async () => { + let callCount = 0; + const testEvent = { type: 'onceEvent' } as IEvent; + const testEvent2 = { type: 'onceEvent' } as IEvent; + const promise = store.once('onceEvent', (e: IEvent) => { + callCount++; }); - return es.once('somethingHappened').then(e => { - expect(e).to.exist; - expect(e).to.have.property('type', goodEvent.type); - }); + await store.dispatch([testEvent, testEvent2]); + await store.dispatch([testEvent2]); + + expect(promise).resolves.toBe(testEvent); + expect(callCount).toBe(1); }); }); }); diff --git a/tests/unit/SagaEventHandler.test.ts b/tests/unit/SagaEventHandler.test.ts index 5e13ece..f84f167 100644 --- a/tests/unit/SagaEventHandler.test.ts +++ b/tests/unit/SagaEventHandler.test.ts @@ -7,7 +7,8 @@ import { CommandBus, AbstractSaga, InMemoryMessageBus, - Deferred + Deferred, + EventDispatcher } from '../../src'; class Saga extends AbstractSaga { @@ -42,9 +43,11 @@ describe('SagaEventHandler', function () { let sagaEventHandler: SagaEventHandler; beforeEach(() => { - const supplementaryEventBus = new InMemoryMessageBus(); + const eventBus = new InMemoryMessageBus(); + const eventDispatcher = new EventDispatcher({ eventBus }); + const storage = new InMemoryEventStorage(); commandBus = new CommandBus({}); - eventStore = new EventStore({ storage: new InMemoryEventStorage(), supplementaryEventBus }); + eventStore = new EventStore({ storage, identifierProvider: storage, eventBus, eventDispatcher }); sagaEventHandler = new SagaEventHandler({ sagaType: Saga, eventStore, commandBus }); }); diff --git a/tests/unit/memory/InMemoryMessageBus.test.ts b/tests/unit/memory/InMemoryMessageBus.test.ts index fef5b23..e80c385 100644 --- a/tests/unit/memory/InMemoryMessageBus.test.ts +++ b/tests/unit/memory/InMemoryMessageBus.test.ts @@ -13,7 +13,6 @@ describe('InMemoryMessageBus', function () { bus.on('doSomething', cmd => { try { - // console.log(cmd); expect(cmd).to.have.nested.property('payload.message', 'test'); done(); } diff --git a/tests/unit/memory/InMemoryView.test.ts b/tests/unit/memory/InMemoryView.test.ts index 617b931..3c0e7eb 100644 --- a/tests/unit/memory/InMemoryView.test.ts +++ b/tests/unit/memory/InMemoryView.test.ts @@ -1,6 +1,6 @@ import { InMemoryView } from '../../../src'; import { expect, assert } from 'chai'; -import { nextCycle } from '../../../src/infrastructure/memory/utils'; +import { nextCycle } from '../../../src/in-memory/utils'; describe('InMemoryView', function () { diff --git a/tests/unit/sqlite/SqliteEventLocker.test.ts b/tests/unit/sqlite/SqliteEventLocker.test.ts index ee26dd4..e894fdd 100644 --- a/tests/unit/sqlite/SqliteEventLocker.test.ts +++ b/tests/unit/sqlite/SqliteEventLocker.test.ts @@ -1,8 +1,8 @@ import { expect } from 'chai'; import * as createDb from 'better-sqlite3'; -import { SqliteEventLocker } from '../../../src/infrastructure/sqlite/SqliteEventLocker'; +import { SqliteEventLocker } from '../../../src/sqlite/SqliteEventLocker'; import { IEvent } from '../../../src/interfaces'; -import { guid } from '../../../src/infrastructure/sqlite'; +import { guid } from '../../../src/sqlite'; import { promisify } from 'util'; const delay = promisify(setTimeout); diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts index ce2aca7..6da8010 100644 --- a/tests/unit/sqlite/SqliteObjectStorage.test.ts +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -1,6 +1,6 @@ import { expect } from 'chai'; import * as createDb from 'better-sqlite3'; -import { guid, SqliteObjectStorage } from '../../../src/infrastructure/sqlite'; +import { guid, SqliteObjectStorage } from '../../../src/sqlite'; describe('SqliteObjectStorage', function () { let db: import('better-sqlite3').Database; diff --git a/tests/unit/sqlite/SqliteObjectView.test.ts b/tests/unit/sqlite/SqliteObjectView.test.ts index 103b4c9..694b0fe 100644 --- a/tests/unit/sqlite/SqliteObjectView.test.ts +++ b/tests/unit/sqlite/SqliteObjectView.test.ts @@ -1,6 +1,6 @@ import { expect } from 'chai'; import * as createDb from 'better-sqlite3'; -import { SqliteObjectView } from '../../../src/infrastructure/sqlite'; +import { SqliteObjectView } from '../../../src/sqlite'; import { promisify } from 'util'; const delay = promisify(setTimeout); diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts index c7fecef..4ce335f 100644 --- a/tests/unit/sqlite/SqliteViewLocker.test.ts +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -1,6 +1,6 @@ import { expect } from 'chai'; import * as createDb from 'better-sqlite3'; -import { SqliteViewLocker } from '../../../src/infrastructure/sqlite'; +import { SqliteViewLocker } from '../../../src/sqlite'; describe('SqliteViewLocker', function () { From 991c2233185d3610a2b8930f6930a03c0cdea01d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 2 Apr 2025 02:40:34 +0100 Subject: [PATCH 024/169] New: RabbitMQ integration classes to support event publishing and subscription --- jest.config.ts | 10 +- package-lock.json | 83 ++++- package.json | 24 +- src/CqrsContainerBuilder.ts | 4 +- .../ExternalEventPublishingProcessor.ts | 29 ++ src/rabbitmq/RabbitMqEventBus.ts | 82 +++++ src/rabbitmq/RabbitMqGateway.ts | 339 ++++++++++++++++++ src/rabbitmq/index.ts | 2 + .../rabbitmq/RabbitMqEventBus.test.ts | 190 ++++++++++ .../rabbitmq/RabbitMqGateway.test.ts | 273 ++++++++++++++ tests/integration/rabbitmq/docker-compose.yml | 17 + 11 files changed, 1035 insertions(+), 18 deletions(-) create mode 100644 src/dispatch-pipeline/ExternalEventPublishingProcessor.ts create mode 100644 src/rabbitmq/RabbitMqEventBus.ts create mode 100644 src/rabbitmq/RabbitMqGateway.ts create mode 100644 src/rabbitmq/index.ts create mode 100644 tests/integration/rabbitmq/RabbitMqEventBus.test.ts create mode 100644 tests/integration/rabbitmq/RabbitMqGateway.test.ts create mode 100644 tests/integration/rabbitmq/docker-compose.yml diff --git a/jest.config.ts b/jest.config.ts index 45e753a..5b1e81b 100644 --- a/jest.config.ts +++ b/jest.config.ts @@ -17,9 +17,13 @@ export default { coverageDirectory: "coverage", // An array of regexp pattern strings used to skip coverage collection - // coveragePathIgnorePatterns: [ - // "/node_modules/" - // ], + coveragePathIgnorePatterns: [ + "/dist/", + "/examples/", + "/node_modules/", + "/src/rabbitmq/", + "/tests/" + ], // Indicates which provider should be used to instrument code for coverage // coverageProvider: "v8", diff --git a/package-lock.json b/package-lock.json index 6a360a4..e7b4b0e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,6 +14,7 @@ "di0": "^1.0.0" }, "devDependencies": { + "@types/amqplib": "^0.10.7", "@types/better-sqlite3": "^7.6.11", "@types/chai": "^4.3.20", "@types/jest": "^29.5.13", @@ -31,10 +32,33 @@ "node": ">=10.3.0" }, "peerDependencies": { + "amqplib": "^0.10.5", "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } }, + "node_modules/@acuminous/bitsyntax": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/@acuminous/bitsyntax/-/bitsyntax-0.1.2.tgz", + "integrity": "sha512-29lUK80d1muEQqiUsSo+3A0yP6CdspgC95EnKBMi22Xlwt79i/En4Vr67+cXhU+cZjbti3TgGGC5wy1stIywVQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "buffer-more-ints": "~1.0.0", + "debug": "^4.3.4", + "safe-buffer": "~5.1.2" + }, + "engines": { + "node": ">=0.8" + } + }, + "node_modules/@acuminous/bitsyntax/node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "license": "MIT", + "peer": true + }, "node_modules/@ampproject/remapping": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", @@ -1042,6 +1066,16 @@ "dev": true, "license": "MIT" }, + "node_modules/@types/amqplib": { + "version": "0.10.7", + "resolved": "https://registry.npmjs.org/@types/amqplib/-/amqplib-0.10.7.tgz", + "integrity": "sha512-IVj3avf9AQd2nXCx0PGk/OYq7VmHiyNxWFSb5HhU9ATh+i+gHWvVcljFTcTWQ/dyHJCTrzCixde+r/asL2ErDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, "node_modules/@types/babel__core": { "version": "7.20.5", "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", @@ -1250,6 +1284,21 @@ "dev": true, "license": "MIT" }, + "node_modules/amqplib": { + "version": "0.10.5", + "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.5.tgz", + "integrity": "sha512-Dx5zmy0Ur+Q7LPPdhz+jx5IzmJBoHd15tOeAfQ8SuvEtyPJ20hBemhOBA4b1WeORCRa0ENM/kHCzmem1w/zHvQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "@acuminous/bitsyntax": "^0.1.2", + "buffer-more-ints": "~1.0.0", + "url-parse": "~1.5.10" + }, + "engines": { + "node": ">=10" + } + }, "node_modules/ansi-escapes": { "version": "4.3.2", "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", @@ -1659,6 +1708,13 @@ "dev": true, "license": "MIT" }, + "node_modules/buffer-more-ints": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/buffer-more-ints/-/buffer-more-ints-1.0.0.tgz", + "integrity": "sha512-EMetuGFz5SLsT0QTnXzINh4Ksr+oo4i+UGTXEshiGCQWnsgSs7ZhJ8fzlwQ+OzEMs0MpDAMr1hxnblp5a4vcHg==", + "license": "MIT", + "peer": true + }, "node_modules/callsites": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", @@ -2216,7 +2272,6 @@ "version": "4.4.0", "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", - "dev": true, "license": "MIT", "dependencies": { "ms": "^2.1.3" @@ -4486,7 +4541,6 @@ "version": "2.1.3", "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", - "dev": true, "license": "MIT" }, "node_modules/napi-build-utils": { @@ -4974,6 +5028,13 @@ "teleport": ">=0.2.0" } }, + "node_modules/querystringify": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/querystringify/-/querystringify-2.2.0.tgz", + "integrity": "sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ==", + "license": "MIT", + "peer": true + }, "node_modules/quick-lru": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-4.0.1.tgz", @@ -5187,6 +5248,13 @@ "node": ">=0.10.0" } }, + "node_modules/requires-port": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", + "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", + "license": "MIT", + "peer": true + }, "node_modules/resolve": { "version": "1.22.10", "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.10.tgz", @@ -5947,6 +6015,17 @@ "browserslist": ">= 4.21.0" } }, + "node_modules/url-parse": { + "version": "1.5.10", + "resolved": "https://registry.npmjs.org/url-parse/-/url-parse-1.5.10.tgz", + "integrity": "sha512-WypcfiRhfeUP9vvF0j6rw0J3hrWrw6iZv3+22h6iRMJ/8z1Tj6XfLP4DsUix5MhMPnXpiHDoKyoZ/bdCkwBCiQ==", + "license": "MIT", + "peer": true, + "dependencies": { + "querystringify": "^2.1.1", + "requires-port": "^1.0.0" + } + }, "node_modules/util-deprecate": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", diff --git a/package.json b/package.json index fd05acc..0cb2672 100644 --- a/package.json +++ b/package.json @@ -2,28 +2,26 @@ "name": "node-cqrs", "version": "1.0.0-rc.6", "description": "Basic ES6 backbone for CQRS app development", + "keywords": [ + "cqrs", + "eventsourcing" + ], "repository": { "type": "git", "url": "https://github.com/snatalenko/node-cqrs.git" }, - "directories": { - "doc": "docs", - "example": "examples", - "test": "tests" - }, - "keywords": [ - "cqrs", - "eventsourcing", - "ddd", - "domain", - "eventstore" - ], "main": "./dist/index.js", "types": "./src/index.ts", "exports": { ".": "./dist/index.js", + "./rabbitmq": "./dist/rabbitmq/index.js", "./sqlite": "./dist/sqlite/index.js" }, + "directories": { + "doc": "docs", + "example": "examples", + "test": "tests" + }, "engines": { "node": ">=10.3.0" }, @@ -49,6 +47,7 @@ "di0": "^1.0.0" }, "devDependencies": { + "@types/amqplib": "^0.10.7", "@types/better-sqlite3": "^7.6.11", "@types/chai": "^4.3.20", "@types/jest": "^29.5.13", @@ -63,6 +62,7 @@ "typescript": "^5.6.2" }, "peerDependencies": { + "amqplib": "^0.10.5", "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index cefc476..57c337f 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -26,6 +26,7 @@ import { IProjectionConstructor, ISagaConstructor } from './interfaces'; +import { ExternalEventPublishingProcessor } from './dispatch-pipeline/ExternalEventPublishingProcessor'; interface CqrsContainer extends Container { eventStore: IEventStore; @@ -46,8 +47,9 @@ export class CqrsContainerBuilder extends ContainerBuilder { super.register(container => { const eventDispatcher = new EventDispatcher(container); eventDispatcher.addPipelineProcessor(new EventValidationProcessor(container)); - eventDispatcher.addPipelineProcessor(new SnapshotPersistenceProcessor(container)); + eventDispatcher.addPipelineProcessor(new ExternalEventPublishingProcessor(container)); eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor(container)); + eventDispatcher.addPipelineProcessor(new SnapshotPersistenceProcessor(container)); return eventDispatcher; }).as('eventDispatcher'); diff --git a/src/dispatch-pipeline/ExternalEventPublishingProcessor.ts b/src/dispatch-pipeline/ExternalEventPublishingProcessor.ts new file mode 100644 index 0000000..8cfbad3 --- /dev/null +++ b/src/dispatch-pipeline/ExternalEventPublishingProcessor.ts @@ -0,0 +1,29 @@ +import { IEventProcessor, IEventBus, EventBatch } from '../interfaces'; + +/** + * Event dispatcher processor that publishes events to an external RabbitMQ event bus if provided. + */ +export class ExternalEventPublishingProcessor implements IEventProcessor { + + #externalEventBus?: IEventBus; + + constructor(options: { externalEventBus?: IEventBus }) { + this.#externalEventBus = options.externalEventBus; + } + + async process(batch: EventBatch): Promise { + if (!this.#externalEventBus) + return batch; + + // TODO: ignore external events + + for (const { event } of batch) { + if (!event) + throw new Error('Event batch does not contain `event`'); + + await this.#externalEventBus.publish(event); + } + + return batch; + } +} diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts new file mode 100644 index 0000000..1946e67 --- /dev/null +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -0,0 +1,82 @@ +import { IEvent, IEventBus, IMessage, IMessageHandler, IObservable } from "../interfaces"; +import { RabbitMqGateway } from "./RabbitMqGateway"; + +const ALL_EVENTS_WILDCARD = '*'; + +export class RabbitMqEventBus implements IEventBus { + + static get allEventsWildcard(): '*' { + return ALL_EVENTS_WILDCARD; + } + + #gateway: RabbitMqGateway; + #queues = new Map(); + #exchange: string; + #queueName: string | undefined; + + constructor(o: { + rabbitMqGateway: RabbitMqGateway, + exchange?: string, + queueName?: string + }) { + this.#gateway = o.rabbitMqGateway; + this.#exchange = o.exchange ?? 'node-cqrs.events'; + this.#queueName = o.queueName; + } + + + /** + * Publishes an event to the fanout exchange. + * The event will be delivered to all subscribers, except this instance's own consumer. + */ + async publish(event: IEvent): Promise { + await this.#gateway.publish(this.#exchange, event); + } + + /** + * Registers a message handler for a specific event type. + * + * @param eventType The event type to listen for. + * @param handler The function to handle incoming messages of the specified type. + */ + async on(eventType: string, handler: IMessageHandler): Promise { + await this.#gateway.subscribe({ + exchange: this.#exchange, + queueName: this.#queueName, + eventType, + handler + }); + } + + /** + * Removes a previously registered message handler for a specific event type. + */ + off(eventType: string, handler: IMessageHandler): void { + this.#gateway.unsubscribe({ + exchange: this.#exchange, + queueName: this.#queueName, + eventType, + handler + }); + } + + /** + * Returns a new instance of RabbitMqGateway that uses a durable queue with the given name. + * This ensures that all messages published to the fanout exchange are also delivered to this queue. + * + * @param name The name of the durable queue. + * @returns A new RabbitMqGateway instance configured to use the specified queue. + */ + queue(name: string): IObservable { + let queue = this.#queues.get(name); + if (!queue) { + queue = new RabbitMqEventBus({ + rabbitMqGateway: this.#gateway, + exchange: this.#exchange, + queueName: name + }); + this.#queues.set(name, queue); + } + return queue; + } +} diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts new file mode 100644 index 0000000..455c83e --- /dev/null +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -0,0 +1,339 @@ +import amqp, { Channel, ChannelModel, ConfirmChannel, ConsumeMessage, Message } from 'amqplib'; +import { + IExtendableLogger, + ILogger, + IMessage, + isMessage +} from '../interfaces'; +import * as Event from '../Event'; +import { delay } from '../utils'; + +/** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ +const getRandomAppId = () => + `${Date.now().toString(36).slice(-4)}.${Math.random().toString(36).slice(2, 6)}`.toUpperCase(); + +type MessageHandler = (m: IMessage) => Promise | unknown; +type Subscription = { + exchange: string, + queueName?: string, + eventType?: string, + handler: MessageHandler, + ignoreOwn?: boolean +}; + +const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); + +/** + * RabbitMqGateway implements the IObservable interface using RabbitMQ. + * + * It uses a fanout exchange to broadcast messages to all connected subscribers. + * The `on` and `off` methods allow you to register and remove handlers for specific event types. + * The `queue(name)` method creates or returns a durable queue with the given name, ensuring that + * all messages delivered to the fanout exchange are also routed to this queue. + */ +export class RabbitMqGateway { + + #connectionFactory: () => Promise; + #appId: string; + #logger: ILogger | undefined; + + #connecting = false; + #connection: ChannelModel | undefined; + #pubChannel: ConfirmChannel | undefined; + #exclusiveQueueName: string = ''; + #queueChannels = new Map(); + #queueConsumers = new Map(); + + #subscriptions: Array = []; + #handlers: Map>> = new Map(); + + get connection() { + return this.#connection; + } + + get channel() { + return this.#pubChannel; + } + + constructor(o: { + rabbitMqConnectionFactory?: () => Promise, + logger?: ILogger | IExtendableLogger + }) { + if (!o.rabbitMqConnectionFactory) + throw new TypeError('rabbitMqConnectionFactory argument required'); + + this.#connectionFactory = o.rabbitMqConnectionFactory; + this.#appId = getRandomAppId(); + this.#logger = o.logger && 'child' in o.logger ? + o.logger.child({ service: new.target.name }) : + o.logger; + } + + async connect(): Promise { + while (this.#connecting) + await delay(1_000); + + this.#connecting = true; + + while (!this.#connection) { + try { + this.#connection = await this.#connectionFactory(); + this.#connection.on('error', err => this.#onConnectionError(err)); + this.#connection.on('close', () => this.#onConnectionClosed()); + this.#logger?.info(`${this.#appId}: Connection established`); + + this.#handlers.clear(); + const subscriptionsToRestore = this.#subscriptions.splice(0); + for (const subscription of subscriptionsToRestore) + await this.subscribe(subscription); + } + catch (err) { + this.#logger?.warn(`${this.#appId}: Connection attempt failed: ${err.message}`); + await delay(5_000); + } + } + + this.#connecting = false; + + return this.#connection; + } + + async disconnect() { + await this.#connection?.close(); + if (this.#connection) // clean up in case 'close' event was not triggered + this.#onConnectionClosed(); + } + + #onConnectionError(err: Error) { + this.#logger?.warn(`${this.#appId}: Connection error: ${err.message}`); + } + + #onConnectionClosed() { + this.#logger?.warn('Connection closed'); + this.#connection = undefined; + this.#pubChannel = undefined; + this.#exclusiveQueueName = ''; + this.#queueChannels.clear(); + this.#queueConsumers.clear(); + } + + #getHandlers(queueGivenName: string = '', eventType: string = '*') { + return this.#subscriptions + .filter(s => + s.queueGivenName === queueGivenName && ( + !s.eventType + || s.eventType === '*' + || s.eventType === eventType)) + .map(s => s.handler); + } + + async subscribeToQueue(exchange: string, queueName: string, handler: MessageHandler) { + return this.subscribe({ exchange, queueName, handler }); + } + + /** + * Subscribes to a non-durable, exclusive queue without requiring acknowledgments. + * The queue is deleted when the connection closes. + * Messages are considered "delivered" upon receipt. + * Failed message processing does not result in redelivery or dead-lettering. + */ + async subscribeToFanout(exchange: string, handler: MessageHandler) { + return this.subscribe({ exchange, handler }); + } + + async subscribe(subscription: Subscription) { + let { queueName } = subscription; + const { + exchange, + eventType, + ignoreOwn = !queueName + } = subscription; + + const channel = await this.#assertChannel(queueName); + + if (!queueName) { + if (!this.#exclusiveQueueName) { + // Assert temporary "exclusive" queue that will be destroyed on connection termination + const queueGivenName = await this.#assetQueue(channel, exchange, '', eventType, { + exclusive: true, + durable: false + }); + + this.#exclusiveQueueName = queueGivenName; + } + else { + this.#assertBinding(channel, exchange, this.#exclusiveQueueName, eventType); + } + + queueName = this.#exclusiveQueueName; + } + else { + const deadLetterExchangeName = `${exchange}.failed`; + + // Assert dead letter queue for rejected or timed out messages + await this.#assetQueue(channel, deadLetterExchangeName, `${queueName}.failed`); + + // Assert durable queue that will survive broker restart + await this.#assetQueue(channel, exchange, queueName, eventType, { deadLetterExchangeName }); + } + + await this.#assertConsumer(queueName, ignoreOwn, channel); + + this.#subscriptions.push({ ...subscription, queueGivenName: queueName }); + } + + async unsubscribe(d: Subscription) { + this.#subscriptions = this.#subscriptions.filter(s => !( + s.exchange === d.exchange && + s.queueName === d.queueName && + s.eventType === d.eventType && + s.handler === d.handler)); + } + + async #assertConnection() { + return this.#connection ?? await this.connect(); + } + + /** Get existing or open a new channel for a given queue name */ + async #assertChannel(queueName: string = ''): Promise { + const connection = await this.#assertConnection(); + let channel = this.#queueChannels.get(queueName); + if (!channel) { + channel = await connection.createChannel(); + this.#queueChannels.set(queueName, channel); + } + return channel; + } + + /** + * Ensure queue, exchange, and binding exist + */ + async #assetQueue(channel: Channel, exchange: string, queueName: string, eventType?: string, options?: { + /** The queue will survive a broker restart */ + durable?: boolean, + + /** Used by only one connection and the queue will be deleted when that connection closes */ + exclusive?: boolean, + + /** Exchange where rejected or timed out messages will be delivered */ + deadLetterExchangeName?: string, + }) { + const { + durable = true, + exclusive = false, + deadLetterExchangeName + } = options ?? {}; + + await channel.assertExchange(exchange, 'topic', { durable: true }); + const { queue: queueGivenName } = await channel.assertQueue(queueName, { + exclusive, + durable, + ...deadLetterExchangeName && { + arguments: { + 'x-dead-letter-exchange': deadLetterExchangeName + } + } + }); + + await this.#assertBinding(channel, exchange, queueGivenName, eventType); + + return queueGivenName; + } + + async #assertBinding(channel: Channel, exchange: string, queueGivenName: string, eventType?: string) { + if (!eventType || eventType === '*') + eventType = '#'; + + await channel.bindQueue(queueGivenName, exchange, eventType); + + this.#logger?.debug(`${this.#appId}: Queue "${queueGivenName}" bound to exchange "${exchange}" with pattern "${eventType}"`); + } + + async #assertConsumer(queueGivenName: string, ignoreOwn: boolean, channel: Channel) { + if (this.#queueConsumers.has(queueGivenName)) + return; + + const c = await channel.consume(queueGivenName, async (msg: ConsumeMessage | null) => { + if (!msg) + return; + + const { consumerTag, routingKey } = msg.fields; + const { appId, messageId, correlationId } = msg.properties; + + this.#logger?.debug(`${this.#appId}: Message received`, { + queueName: queueGivenName, + consumerTag, + routingKey, + messageId, + correlationId, + appId + }); + + if (ignoreOwn && appId === this.#appId) + return; + + try { + const jsonContent = msg.content.toString(); + const message: IMessage = JSON.parse(jsonContent); + + const handlers = this.#getHandlers(queueGivenName, message.type); + if (!handlers.length && !isSystemQueue(queueGivenName)) + throw new Error(`Message from queue "${queueGivenName}" was delivered to a consumer that does not handle type "${message.type}"`); + + for (const handler of handlers) + await handler(message); + + channel?.ack(msg); + } + catch (err) { + this.#logger?.error(`${this.#appId}: Message processing failed: ${err.message}`); + + // Redirect message to dead letter queue, if `{ noAck: true }` was not set on consumption + channel?.nack(msg, false, false); + } + }); + + this.#logger?.debug(`${this.#appId}: Consumer "${c.consumerTag}" registered on queue "${queueGivenName}"`); + + this.#queueConsumers.set(queueGivenName, c.consumerTag); + } + + /** + * Publishes an event to the fanout exchange. + * The event will be delivered to all subscribers, except this instance's own consumer. + */ + async publish(exchange: string, message: IMessage): Promise { + if (typeof exchange !== 'string' || !exchange.length) + throw new TypeError('exchange argument must be a non-empty String'); + if (!isMessage(message)) + throw new TypeError('valid message argument is required'); + + if (!this.#pubChannel) { + const connection = await this.#assertConnection(); + this.#pubChannel = await connection.createConfirmChannel(); + + await this.#pubChannel.assertExchange(exchange, 'topic', { durable: true }); + } + + const content = Buffer.from(JSON.stringify(message), 'utf8'); + const properties = { + contentType: 'application/json', + contentEncoding: 'utf8', + persistent: true, + timestamp: message.context?.ts ?? Date.now(), + appId: this.#appId, + type: message.type, + messageId: 'id' in message && typeof message.id === 'string' ? + message.id : + undefined, + correlationId: message.sagaId?.toString() + }; + + return new Promise((resolve, reject) => { + const published = this.#pubChannel!.publish(exchange, message.type, content, properties, err => + err ? reject(err) : resolve()); + if (!published) + throw new Error(`${this.#appId}: Failed to send event ${Event.describe(message)}, channel buffer is full`); + }); + } +} diff --git a/src/rabbitmq/index.ts b/src/rabbitmq/index.ts new file mode 100644 index 0000000..79404df --- /dev/null +++ b/src/rabbitmq/index.ts @@ -0,0 +1,2 @@ +export * from './RabbitMqEventBus'; +export * from './RabbitMqGateway'; diff --git a/tests/integration/rabbitmq/RabbitMqEventBus.test.ts b/tests/integration/rabbitmq/RabbitMqEventBus.test.ts new file mode 100644 index 0000000..ee99a10 --- /dev/null +++ b/tests/integration/rabbitmq/RabbitMqEventBus.test.ts @@ -0,0 +1,190 @@ +import * as amqplib from 'amqplib'; +import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; +import { RabbitMqEventBus } from '../../../src/rabbitmq/RabbitMqEventBus'; +import { IMessage, IEvent } from '../../../src/interfaces'; + +const delay = (ms: number) => new Promise(res => { + const t = setTimeout(res, ms); + t.unref(); +}); + +describe('RabbitMqEventBus', () => { + + let gateway1: RabbitMqGateway; + let gateway2: RabbitMqGateway; + let gateway3: RabbitMqGateway; + let eventBus1: RabbitMqEventBus; + let eventBus2: RabbitMqEventBus; + let eventBus3: RabbitMqEventBus; + + const queueName = 'test-bus-queue'; + const exchangeName = 'test-bus-exchange'; + const eventType = 'test-bus-event'; + + beforeEach(async () => { + const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); + gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory }); + gateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory }); + gateway3 = new RabbitMqGateway({ rabbitMqConnectionFactory }); + eventBus1 = new RabbitMqEventBus({ rabbitMqGateway: gateway1, exchange: exchangeName }); + eventBus2 = new RabbitMqEventBus({ rabbitMqGateway: gateway2, exchange: exchangeName }); + eventBus3 = new RabbitMqEventBus({ rabbitMqGateway: gateway3, exchange: exchangeName }); + }); + + afterEach(async () => { + const ch = await gateway1.connection.createChannel(); + await ch.deleteQueue(queueName); + await ch.deleteQueue(`${queueName}.failed`); + await ch.deleteExchange(exchangeName); + await gateway1.disconnect(); + await gateway2.disconnect(); + await gateway3.disconnect(); + }); + + describe('publish()', () => { + + it('publishes without throwing', async () => { + + await eventBus1.publish({ type: eventType }); + }); + }); + + describe('on()', () => { + + it('subscribes to events so that they are delivered to every subscriber except sender', async () => { + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + const received3: IMessage[] = []; + + await eventBus1.on(eventType, e => { + received1.push(e); + }); + + await eventBus2.on(eventType, e => { + received2.push(e); + }); + + await eventBus3.on(eventType, e => { + received3.push(e); + }); + + const event: IEvent = { + type: eventType, + payload: { ok: true } + }; + + await eventBus2.publish(event); + await delay(50); + + expect(received1).toEqual([event]); + expect(received2).toEqual([]); + expect(received3).toEqual([event]); + }); + + it('allows to subscribe to all events', async () => { + + const received1: IMessage[] = []; + + await eventBus1.on(RabbitMqEventBus.allEventsWildcard, e => { + received1.push(e); + }); + + const event1: IEvent = { type: `${eventType}1` }; + const event2: IEvent = { type: `${eventType}2` }; + + await eventBus2.publish(event1); + await eventBus3.publish(event2); + + await delay(50); + + expect(received1).toEqual([event1, event2]); + }); + }); + + describe('queue()', () => { + + it('creates an isolated queue where published messages delivered to only one recipient', async () => { + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + + await eventBus1.queue(queueName).on(eventType, (msg) => { + received1.push(msg); + }); + + await eventBus2.queue(queueName).on(eventType, (msg) => { + received2.push(msg); + }); + + const event: IEvent = { + type: eventType, + payload: { ok: true } + }; + + await eventBus1.publish(event); + await delay(50); + + expect([...received1, ...received2]).toEqual([ + event + ]); + }); + + it('allows to subscribe to all events in the queue', async () => { + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + + await eventBus1.queue(queueName).on(RabbitMqEventBus.allEventsWildcard, (msg) => { + received1.push(msg); + }); + + await eventBus2.queue(queueName).on(RabbitMqEventBus.allEventsWildcard, (msg) => { + received2.push(msg); + }); + + const event1: IEvent = { + type: `${eventType}1` + }; + + const event2: IEvent = { + type: `${eventType}2` + }; + + await eventBus1.publish(event1); + await eventBus1.publish(event2); + + await delay(50); + + expect([...received1, ...received2]).toEqual([ + event1, + event2 + ]); + }); + + }); + + describe('off()', () => { + + it('removes previously added handler', async () => { + + const received1: IMessage[] = []; + const handler1 = (msg: IMessage) => received1.push(msg); + await eventBus1.on(eventType, handler1); + + const received2: IMessage[] = []; + const handler2 = (msg: IMessage) => received2.push(msg); + await eventBus2.on(eventType, handler2); + + eventBus2.off(eventType, handler2); + + const event = { type: eventType, payload: { removed: true } }; + await eventBus3.publish(event); + + await delay(50); + + expect(received1).toEqual([event]); + expect(received2).toEqual([]); + }); + }); +}); diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts new file mode 100644 index 0000000..5bf6ccd --- /dev/null +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -0,0 +1,273 @@ +import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; +import { IEvent, IMessage } from '../../../src/interfaces'; +import * as amqplib from 'amqplib'; +import { delay } from '../../../src/utils'; + +describe('RabbitMqGateway', () => { + + let gateway1: RabbitMqGateway; + let gateway2: RabbitMqGateway | undefined; + let gateway3: RabbitMqGateway | undefined; + const exchange = 'test-exchange'; + const queueName = 'test-queue'; + + beforeEach(async () => { + const logger = undefined; + // const logger = console; + const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); + gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); + gateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); + gateway3 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); + }); + + afterEach(async () => { + if (gateway1.connection) { + const ch = await gateway1.connection.createChannel(); + await ch.deleteQueue(queueName); + await ch.deleteQueue(`${queueName}.failed`); + await ch.deleteExchange(exchange); + await gateway1.disconnect() + } + await gateway2?.disconnect(); + await gateway3?.disconnect(); + }); + + describe('publish()', () => { + + it('publishes without throwing', async () => { + + const message: IMessage = { + type: 'test.confirm', + payload: { msg: 'confirmed' }, + }; + + await gateway1.publish(exchange, message); + }); + }); + + + describe('subscribeToFanout', () => { + + it('ignores self-published messages', async () => { + const received: IMessage[] = []; + + await gateway1.subscribeToFanout(exchange, msg => { + received.push(msg); + }); + + const message: IMessage = { + type: 'test.event', + payload: { msg: 'self-test' }, + }; + + // publish from the same instance — should be ignored + await gateway1.publish(exchange, message); + + await delay(50); // wait briefly + + expect(received).toHaveLength(0); + }); + + it('receives messages sent from external source', async () => { + const received: IMessage[] = []; + + await gateway1.subscribeToFanout(exchange, msg => { + received.push(msg); + }); + + gateway3 = new RabbitMqGateway({ + rabbitMqConnectionFactory: () => amqplib.connect('amqp://localhost') + }); + + const message: IMessage = { + type: 'test.event', + payload: { from: 'external' }, + }; + + gateway3.publish(exchange, message); + await delay(50); // allow time for delivery + + expect(received).toHaveLength(1); + expect(received[0].payload.from).toBe('external'); + + await gateway3.connection.close(); + }); + + it('delivers fanout messages to multiple non-queue subscribers', async () => { + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + + await gateway2.subscribeToFanout(exchange, msg => received1.push(msg)); + await gateway3.subscribeToFanout(exchange, msg => received2.push(msg)); + + const message: IMessage = { + type: 'test.event', + payload: { test: 'multi' } + }; + + await gateway1.publish(exchange, message); + await delay(50); + + expect(received1).toHaveLength(1); + expect(received2).toHaveLength(1); + }); + + }); + + describe('subscribeToQueue', () => { + + it('delivers locally published messages to durable queue subscription', async () => { + const received: IMessage[] = []; + await gateway1.subscribeToQueue(exchange, queueName, msg => received.push(msg)); + + const message: IMessage = { + type: 'queue.event', + payload: { local: true } + }; + + await gateway1.publish(exchange, message); + await delay(50); + + expect(received).toHaveLength(1); + expect(received[0].payload.local).toBe(true); + }); + + it('delivers queue messages to one consumer only', async () => { + const received1: IMessage[] = []; + const received2: IMessage[] = []; + + await gateway1.subscribeToQueue(exchange, queueName, msg => received1.push(msg)); + + gateway3 = new RabbitMqGateway({ + rabbitMqConnectionFactory: () => amqplib.connect('amqp://localhost') + }); + await gateway3.subscribeToQueue(exchange, queueName, msg => received2.push(msg)); + + const message: IMessage = { + type: 'queue.once', + payload: { value: 1 } + }; + + await gateway1.publish(exchange, message); + await new Promise(res => setTimeout(res, 100)); + + const totalReceived = received1.length + received2.length; + expect(totalReceived).toBe(1); + }); + + it('sends failed queue messages to DLQ', async () => { + const dlqReceived: IMessage[] = []; + + await gateway1.subscribeToQueue(exchange, queueName, _msg => { + throw new Error('intentional failure'); + }); + + const cn2 = await amqplib.connect('amqp://localhost'); + const ch2 = await cn2.createChannel(); + await ch2.consume(`${queueName}.failed`, msg => { + dlqReceived.push(JSON.parse(msg.content.toString())); + }); + + const message: IMessage = { + type: 'dlq.test', + payload: { shouldFail: true } + }; + + await gateway1.publish(exchange, message); + await delay(50); + + expect(dlqReceived).toHaveLength(1); + expect(dlqReceived[0].payload.shouldFail).toBe(true); + + await cn2.close(); + }); + }); + + describe('subscribe', () => { + + it('subscribes to specific event type broadcast when eventType is defined', async () => { + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + + const event1 = { type: 'event1' }; + const event2 = { type: 'event2' }; + const event3 = { type: 'event3' }; + + await gateway1.subscribe({ exchange, eventType: event1.type, handler: e => received1.push(e) }); + await gateway1.subscribe({ exchange, eventType: event2.type, handler: e => received1.push(e) }); + await gateway2.subscribe({ exchange, eventType: event2.type, handler: e => received2.push(e) }); + await gateway2.subscribe({ exchange, eventType: event3.type, handler: e => received2.push(e) }); + + await gateway3.publish(exchange, event1); + await gateway3.publish(exchange, event2); + await gateway3.publish(exchange, event3); + + await delay(50); + + expect(received1).toEqual([ event1, event2 ]); + expect(received2).toEqual([ event2, event3 ]); + }); + + it('subscribe queue to given event types, when specified', async () => { + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + const received3: IMessage[] = []; + + const event1 = { type: 'event1' }; + const event2 = { type: 'event2' }; + const event3 = { type: 'event3' }; + + await gateway1.subscribe({ exchange, queueName, eventType: event1.type, handler: m => received1.push(m) }); + await gateway1.subscribe({ exchange, queueName, eventType: event2.type, handler: m => received2.push(m) }); + await gateway1.subscribe({ exchange, queueName, eventType: event3.type, handler: m => received3.push(m) }); + + await gateway3.publish(exchange, event1); + await gateway3.publish(exchange, event2); + await gateway3.publish(exchange, event3); + + await delay(50); + + expect(received1).toEqual([ event1 ]); + expect(received2).toEqual([ event2 ]); + }); + }); + + describe('connect()', () => { + + it('retains subscriptions after reconnect', async () => { + + const fanoutReceived: IMessage[] = []; + const queueReceived: IMessage[] = []; + + await gateway1.subscribeToFanout(exchange, msg => { + fanoutReceived.push(msg); + }); + + await gateway1.subscribeToQueue(exchange, queueName, msg => { + queueReceived.push(msg); + }); + + // Force disconnect to simulate dropped connection + await gateway1.disconnect(); + await gateway1.connect(); + + const message: IMessage = { + type: 'test.reconnect', + payload: { check: true } + }; + + gateway3 = new RabbitMqGateway({ + rabbitMqConnectionFactory: () => amqplib.connect('amqp://localhost') + }); + + await gateway3.publish(exchange, message); + await delay(50); + + expect(fanoutReceived).toEqual([message]); + expect(queueReceived).toEqual([message]); + }); + }); +}); diff --git a/tests/integration/rabbitmq/docker-compose.yml b/tests/integration/rabbitmq/docker-compose.yml new file mode 100644 index 0000000..ebc000d --- /dev/null +++ b/tests/integration/rabbitmq/docker-compose.yml @@ -0,0 +1,17 @@ +version: '3.8' + +services: + rabbitmq: + image: rabbitmq:3-management + container_name: rabbitmq + ports: + - "5672:5672" # AMQP + - "15672:15672" # Management UI + environment: + RABBITMQ_DEFAULT_USER: guest + RABBITMQ_DEFAULT_PASS: guest + volumes: + - rabbitmq_data:/var/lib/rabbitmq + +volumes: + rabbitmq_data: From d680d9589d24bd72a7a995ee70523ec605779772 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 2 Apr 2025 18:06:38 +0100 Subject: [PATCH 025/169] Fix `ignoreOwn` resolving per rabbitmq message handler --- src/rabbitmq/RabbitMqEventBus.ts | 3 ++- src/rabbitmq/RabbitMqGateway.ts | 36 +++++++++++++++----------------- 2 files changed, 19 insertions(+), 20 deletions(-) diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 1946e67..6b5c813 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -44,7 +44,8 @@ export class RabbitMqEventBus implements IEventBus { exchange: this.#exchange, queueName: this.#queueName, eventType, - handler + handler, + ignoreOwn: !this.#queueName }); } diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 455c83e..275efc1 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -118,13 +118,14 @@ export class RabbitMqGateway { } #getHandlers(queueGivenName: string = '', eventType: string = '*') { - return this.#subscriptions - .filter(s => - s.queueGivenName === queueGivenName && ( - !s.eventType - || s.eventType === '*' - || s.eventType === eventType)) - .map(s => s.handler); + return this.#subscriptions.filter(s => + s.queueGivenName === queueGivenName + && ( + !s.eventType + || s.eventType === '*' + || s.eventType === eventType + ) + ); } async subscribeToQueue(exchange: string, queueName: string, handler: MessageHandler) { @@ -138,16 +139,12 @@ export class RabbitMqGateway { * Failed message processing does not result in redelivery or dead-lettering. */ async subscribeToFanout(exchange: string, handler: MessageHandler) { - return this.subscribe({ exchange, handler }); + return this.subscribe({ exchange, handler, ignoreOwn: true }); } async subscribe(subscription: Subscription) { let { queueName } = subscription; - const { - exchange, - eventType, - ignoreOwn = !queueName - } = subscription; + const { exchange, eventType } = subscription; const channel = await this.#assertChannel(queueName); @@ -177,7 +174,7 @@ export class RabbitMqGateway { await this.#assetQueue(channel, exchange, queueName, eventType, { deadLetterExchangeName }); } - await this.#assertConsumer(queueName, ignoreOwn, channel); + await this.#assertConsumer(queueName, channel); this.#subscriptions.push({ ...subscription, queueGivenName: queueName }); } @@ -249,7 +246,7 @@ export class RabbitMqGateway { this.#logger?.debug(`${this.#appId}: Queue "${queueGivenName}" bound to exchange "${exchange}" with pattern "${eventType}"`); } - async #assertConsumer(queueGivenName: string, ignoreOwn: boolean, channel: Channel) { + async #assertConsumer(queueGivenName: string, channel: Channel) { if (this.#queueConsumers.has(queueGivenName)) return; @@ -269,9 +266,6 @@ export class RabbitMqGateway { appId }); - if (ignoreOwn && appId === this.#appId) - return; - try { const jsonContent = msg.content.toString(); const message: IMessage = JSON.parse(jsonContent); @@ -280,8 +274,12 @@ export class RabbitMqGateway { if (!handlers.length && !isSystemQueue(queueGivenName)) throw new Error(`Message from queue "${queueGivenName}" was delivered to a consumer that does not handle type "${message.type}"`); - for (const handler of handlers) + for (const { handler, ignoreOwn } of handlers) { + if (ignoreOwn && appId === this.#appId) + continue; + await handler(message); + } channel?.ack(msg); } From 8109ae958c9de1f2162ef8d8daaaa8e31137737d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 2 Apr 2025 19:02:20 +0100 Subject: [PATCH 026/169] Add `concurrentLimit` to rabbitmq subscriptions --- src/rabbitmq/RabbitMqGateway.ts | 45 +++++++++++-------- .../rabbitmq/RabbitMqGateway.test.ts | 43 +++++++++++++++--- 2 files changed, 65 insertions(+), 23 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 275efc1..4969fcc 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,4 +1,4 @@ -import amqp, { Channel, ChannelModel, ConfirmChannel, ConsumeMessage, Message } from 'amqplib'; +import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; import { IExtendableLogger, ILogger, @@ -18,7 +18,8 @@ type Subscription = { queueName?: string, eventType?: string, handler: MessageHandler, - ignoreOwn?: boolean + ignoreOwn?: boolean, + concurrentLimit?: number }; const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); @@ -40,7 +41,7 @@ export class RabbitMqGateway { #connecting = false; #connection: ChannelModel | undefined; #pubChannel: ConfirmChannel | undefined; - #exclusiveQueueName: string = ''; + #exclusiveQueueName: string | undefined; #queueChannels = new Map(); #queueConsumers = new Map(); @@ -112,7 +113,7 @@ export class RabbitMqGateway { this.#logger?.warn('Connection closed'); this.#connection = undefined; this.#pubChannel = undefined; - this.#exclusiveQueueName = ''; + this.#exclusiveQueueName = undefined; this.#queueChannels.clear(); this.#queueConsumers.clear(); } @@ -143,40 +144,45 @@ export class RabbitMqGateway { } async subscribe(subscription: Subscription) { - let { queueName } = subscription; - const { exchange, eventType } = subscription; + const { + exchange, + queueName, + eventType, + concurrentLimit + } = subscription; const channel = await this.#assertChannel(queueName); - if (!queueName) { + let queueGivenName = queueName; + if (!queueGivenName) { + // Handle temporary (exclusive) queue case if (!this.#exclusiveQueueName) { // Assert temporary "exclusive" queue that will be destroyed on connection termination - const queueGivenName = await this.#assetQueue(channel, exchange, '', eventType, { + this.#exclusiveQueueName = await this.#assetQueue(channel, exchange, '', eventType, { exclusive: true, durable: false }); - - this.#exclusiveQueueName = queueGivenName; } else { - this.#assertBinding(channel, exchange, this.#exclusiveQueueName, eventType); + // If exclusive queue already exists, ensure it is bound with the current event type + await this.#assertBinding(channel, exchange, this.#exclusiveQueueName, eventType); } - - queueName = this.#exclusiveQueueName; + queueGivenName = this.#exclusiveQueueName; } else { + // Handle durable queue case const deadLetterExchangeName = `${exchange}.failed`; // Assert dead letter queue for rejected or timed out messages - await this.#assetQueue(channel, deadLetterExchangeName, `${queueName}.failed`); + await this.#assetQueue(channel, deadLetterExchangeName, `${queueGivenName}.failed`); // Assert durable queue that will survive broker restart - await this.#assetQueue(channel, exchange, queueName, eventType, { deadLetterExchangeName }); + await this.#assetQueue(channel, exchange, queueGivenName, eventType, { deadLetterExchangeName }); } - await this.#assertConsumer(queueName, channel); + await this.#assertConsumer(queueGivenName, channel, concurrentLimit); - this.#subscriptions.push({ ...subscription, queueGivenName: queueName }); + this.#subscriptions.push({ ...subscription, queueGivenName }); } async unsubscribe(d: Subscription) { @@ -246,10 +252,13 @@ export class RabbitMqGateway { this.#logger?.debug(`${this.#appId}: Queue "${queueGivenName}" bound to exchange "${exchange}" with pattern "${eventType}"`); } - async #assertConsumer(queueGivenName: string, channel: Channel) { + async #assertConsumer(queueGivenName: string, channel: Channel, concurrentLimit?: number) { if (this.#queueConsumers.has(queueGivenName)) return; + if (concurrentLimit) + await channel.prefetch(concurrentLimit); + const c = await channel.consume(queueGivenName, async (msg: ConsumeMessage | null) => { if (!msg) return; diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index 5bf6ccd..6999fda 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -1,5 +1,5 @@ import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; -import { IEvent, IMessage } from '../../../src/interfaces'; +import { IMessage } from '../../../src/interfaces'; import * as amqplib from 'amqplib'; import { delay } from '../../../src/utils'; @@ -206,8 +206,8 @@ describe('RabbitMqGateway', () => { await delay(50); - expect(received1).toEqual([ event1, event2 ]); - expect(received2).toEqual([ event2, event3 ]); + expect(received1).toEqual([event1, event2]); + expect(received2).toEqual([event2, event3]); }); it('subscribe queue to given event types, when specified', async () => { @@ -230,8 +230,41 @@ describe('RabbitMqGateway', () => { await delay(50); - expect(received1).toEqual([ event1 ]); - expect(received2).toEqual([ event2 ]); + expect(received1).toEqual([event1]); + expect(received2).toEqual([event2]); + }); + + it('allows to limit number of concurrently running message processors', async () => { + + // @ts-ignore + const { promise: blocker, resolve: releaseBlocker } = Promise.withResolvers(); + + const received1: IMessage[] = []; + const event1 = { type: 'event1' }; + + await gateway1.subscribe({ + exchange, + queueName, + eventType: event1.type, + handler: async m => { + received1.push(m); + await blocker; + }, + concurrentLimit: 2 + }); + + await gateway3.publish(exchange, event1); + await gateway3.publish(exchange, event1); + await gateway3.publish(exchange, event1); + + await delay(50); + + expect(received1).toEqual([event1, event1]); + + releaseBlocker(); + await delay(50); + + expect(received1).toEqual([event1, event1, event1]); }); }); From f6616f590ccb7f62241e2ba8bc012efc3ebabdfc Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 2 Apr 2025 20:53:07 +0100 Subject: [PATCH 027/169] Fix package exports --- package.json | 10 ++++++++++ src/dispatch-pipeline/EventPersistenceProcessor.ts | 3 +-- src/dispatch-pipeline/index.ts | 1 + src/index.ts | 1 + 4 files changed, 13 insertions(+), 2 deletions(-) diff --git a/package.json b/package.json index 0cb2672..cb8cef6 100644 --- a/package.json +++ b/package.json @@ -17,6 +17,16 @@ "./rabbitmq": "./dist/rabbitmq/index.js", "./sqlite": "./dist/sqlite/index.js" }, + "typesVersions": { + "*": { + "rabbitmq": [ + "src/rabbitmq/index.ts" + ], + "sqlite": [ + "src/sqlite/index.ts" + ] + } + }, "directories": { "doc": "docs", "example": "examples", diff --git a/src/dispatch-pipeline/EventPersistenceProcessor.ts b/src/dispatch-pipeline/EventPersistenceProcessor.ts index aea2ff3..cfd93a1 100644 --- a/src/dispatch-pipeline/EventPersistenceProcessor.ts +++ b/src/dispatch-pipeline/EventPersistenceProcessor.ts @@ -1,8 +1,7 @@ import { EventBatch, IEvent, IEventProcessor, IEventStoreWriter } from '../interfaces'; /** - * Processor responsible for persisting events using an in-memory event storage. - * Typically used for testing or ephemeral scenarios where durability isn't required. + * Processor responsible for persisting events to IEventStoreWriter. */ export class EventPersistenceProcessor implements IEventProcessor { diff --git a/src/dispatch-pipeline/index.ts b/src/dispatch-pipeline/index.ts index 43ec39a..c536281 100644 --- a/src/dispatch-pipeline/index.ts +++ b/src/dispatch-pipeline/index.ts @@ -1,3 +1,4 @@ export * from './EventPersistenceProcessor'; export * from './EventValidationProcessor'; +export * from './ExternalEventPublishingProcessor'; export * from './SnapshotPersistenceProcessor'; diff --git a/src/index.ts b/src/index.ts index 27d5d0b..a1e1c55 100644 --- a/src/index.ts +++ b/src/index.ts @@ -11,6 +11,7 @@ export * from './AbstractProjection'; export * from './EventDispatcher'; export * from './in-memory'; +export * from './dispatch-pipeline'; export * as Event from './Event'; export { From 4f2281b043a5a41436f0acdb965764d8004c69b7 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 4 Apr 2025 01:22:01 +0100 Subject: [PATCH 028/169] Fix typings when installed in project with "Node" moduleResolution --- package.json | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/package.json b/package.json index cb8cef6..d19af1c 100644 --- a/package.json +++ b/package.json @@ -12,11 +12,6 @@ }, "main": "./dist/index.js", "types": "./src/index.ts", - "exports": { - ".": "./dist/index.js", - "./rabbitmq": "./dist/rabbitmq/index.js", - "./sqlite": "./dist/sqlite/index.js" - }, "typesVersions": { "*": { "rabbitmq": [ @@ -27,6 +22,20 @@ ] } }, + "exports": { + ".": { + "import": "./dist/index.js", + "types": "./src/index.ts" + }, + "./rabbitmq": { + "import": "./dist/rabbitmq/index.js", + "types": "./src/rabbitmq/index.ts" + }, + "./sqlite": { + "import": "./dist/sqlite/index.js", + "types": "./src/sqlite/index.ts" + } + }, "directories": { "doc": "docs", "example": "examples", From e955eff465196003390e4f5fa1f5e1150747ae1c Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 4 Apr 2025 01:24:44 +0100 Subject: [PATCH 029/169] Fix internal typings --- src/AbstractProjection.ts | 2 +- src/EventDispatcher.ts | 3 +- src/EventStore.ts | 10 ++--- .../EventPersistenceProcessor.ts | 12 +++--- .../EventValidationProcessor.ts | 2 +- .../SnapshotPersistenceProcessor.ts | 41 +++++++------------ src/in-memory/InMemoryEventStorage.ts | 6 +-- src/interfaces/IEvent.ts | 9 ++++ src/interfaces/IEventSet.ts | 6 ++- src/interfaces/IEventStorage.ts | 20 ++++----- src/interfaces/IEventStore.ts | 4 +- 11 files changed, 58 insertions(+), 57 deletions(-) diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 764b589..c0fb2f0 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -44,7 +44,7 @@ export type AbstractProjectionParams = { /** * Base class for Projection definition */ -export abstract class AbstractProjection> implements IProjection { +export abstract class AbstractProjection implements IProjection { /** * List of event types handled by the projection. Can be overridden in the projection implementation. diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 2a29fc3..ac10bfa 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -4,7 +4,8 @@ import { IEventDispatcher, IEventProcessor, IEventSet, - IEventBus + IEventBus, + isEventSet } from "./interfaces"; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; diff --git a/src/EventStore.ts b/src/EventStore.ts index b1cdc28..d54c988 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -1,7 +1,7 @@ import { IAggregateSnapshotStorage, IEvent, - IEventStoreReader, + IEventStorageReader, IEventSet, IExtendableLogger, ILogger, @@ -17,7 +17,7 @@ import { IEventDispatcher, IEventBus, isIEventBus, - isIEventStoreReader + isIEventStorageReader } from "./interfaces"; import { getClassName, @@ -28,7 +28,7 @@ import { EventDispatcher } from "./EventDispatcher"; export class EventStore implements IEventStore { #identifierProvider: IIdentifierProvider; - #storage: IEventStoreReader; + #storage: IEventStorageReader; #snapshotStorage: IAggregateSnapshotStorage | undefined; eventBus: IEventBus; #eventDispatcher: IEventDispatcher; @@ -43,7 +43,7 @@ export class EventStore implements IEventStore { eventDispatcher, logger, }: { - storage: IEventStoreReader, + storage: IEventStorageReader, identifierProvider?: IIdentifierProvider, snapshotStorage?: IAggregateSnapshotStorage, eventBus?: IEventBus, @@ -54,7 +54,7 @@ export class EventStore implements IEventStore { throw new TypeError('storage argument required'); if (!identifierProvider) throw new TypeError('identifierProvider argument required'); - if (!isIEventStoreReader(storage)) + if (!isIEventStorageReader(storage)) throw new TypeError('storage does not implement IEventStorage interface'); if (eventBus && !isIEventBus(eventBus)) throw new TypeError('eventBus does not implement IMessageBus interface'); diff --git a/src/dispatch-pipeline/EventPersistenceProcessor.ts b/src/dispatch-pipeline/EventPersistenceProcessor.ts index cfd93a1..eb63599 100644 --- a/src/dispatch-pipeline/EventPersistenceProcessor.ts +++ b/src/dispatch-pipeline/EventPersistenceProcessor.ts @@ -1,13 +1,13 @@ -import { EventBatch, IEvent, IEventProcessor, IEventStoreWriter } from '../interfaces'; +import { EventBatch, IEvent, IEventProcessor, IEventStorageWriter } from '../interfaces'; /** * Processor responsible for persisting events to IEventStoreWriter. */ export class EventPersistenceProcessor implements IEventProcessor { - #storage: IEventStoreWriter; + #storage: IEventStorageWriter; - constructor(options: { storage: IEventStoreWriter }) { + constructor(options: { storage: IEventStorageWriter }) { if (!options.storage) throw new TypeError('storage argument required'); @@ -15,12 +15,12 @@ export class EventPersistenceProcessor implements IEventProcessor { } async process(batch: EventBatch): Promise { - if(!this.#storage) + if (!this.#storage) return batch; const events: IEvent[] = []; - for(const { event } of batch) { - if(!event) + for (const { event } of batch) { + if (!event) throw new Error('Event batch does not contain event'); events.push(event); diff --git a/src/dispatch-pipeline/EventValidationProcessor.ts b/src/dispatch-pipeline/EventValidationProcessor.ts index 72090c6..7f24245 100644 --- a/src/dispatch-pipeline/EventValidationProcessor.ts +++ b/src/dispatch-pipeline/EventValidationProcessor.ts @@ -12,7 +12,7 @@ export class EventValidationProcessor implements IEventProcessor { #validate: EventValidator; constructor(o?: { - eventFormatValidator: EventValidator + eventFormatValidator?: EventValidator }) { this.#validate = o?.eventFormatValidator ?? defaultValidator; } diff --git a/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts b/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts index dc6088f..eeab2ce 100644 --- a/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts +++ b/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts @@ -9,8 +9,10 @@ import { import * as Event from '../Event'; const SNAPSHOT_EVENT_TYPE = 'snapshot'; +const isSnapshotEvent = (event?: IEvent): event is IEvent & { type: 'snapshot' } => + (!!event && event.type === SNAPSHOT_EVENT_TYPE); -export class SnapshotPersistenceProcessor implements IEventProcessor { +export class SnapshotPersistenceProcessor implements IEventProcessor<{ event?: IEvent }> { #snapshotStorage?: IAggregateSnapshotStorage; #logger?: ILogger; @@ -25,42 +27,27 @@ export class SnapshotPersistenceProcessor implements IEventProcessor { options.logger; } - #extractSnapshotEvent(batch: EventBatch): IEvent | undefined { - if (!Array.isArray(batch)) - throw new TypeError('batch argument must be an Array'); - - const snapshotEvents = batch.filter(({ event }) => event?.type === SNAPSHOT_EVENT_TYPE); - if (snapshotEvents.length > 1) - throw new Error(`Cannot process more than one "${SNAPSHOT_EVENT_TYPE}" event per batch`); - - return snapshotEvents[0].event; - } - async process(batch: EventBatch): Promise { if (!this.#snapshotStorage) return batch; - const snapshotEvent = this.#extractSnapshotEvent(batch); - if (!snapshotEvent) - return batch; - - this.#logger?.debug(`Persisting ${Event.describe(snapshotEvent)}`); - - await this.#snapshotStorage.saveAggregateSnapshot(snapshotEvent); + const snapshotEvents = batch.map(e => e.event).filter(isSnapshotEvent); + for (const event of snapshotEvents) { + this.#logger?.debug(`Persisting ${Event.describe(event)}`); + await this.#snapshotStorage.saveAggregateSnapshot(event); + } - return batch.filter(e => e !== snapshotEvent); + return batch.filter(e => !isSnapshotEvent(e.event)); } async revert(batch: EventBatch): Promise { if (!this.#snapshotStorage) return; - const snapshotEvent = this.#extractSnapshotEvent(batch); - if (!snapshotEvent) - return; - - this.#logger?.debug(`Removing ${Event.describe(snapshotEvent)}`); - - await this.#snapshotStorage?.deleteAggregateSnapshot(snapshotEvent); + const snapshotEvents = batch.map(e => e.event).filter(isSnapshotEvent); + for (const snapshotEvent of snapshotEvents) { + this.#logger?.debug(`Removing ${Event.describe(snapshotEvent)}`); + await this.#snapshotStorage.deleteAggregateSnapshot(snapshotEvent); + } } } diff --git a/src/in-memory/InMemoryEventStorage.ts b/src/in-memory/InMemoryEventStorage.ts index a77def8..bd3b3ed 100644 --- a/src/in-memory/InMemoryEventStorage.ts +++ b/src/in-memory/InMemoryEventStorage.ts @@ -3,9 +3,9 @@ import { IEvent, IEventSet, EventQueryAfter, - IEventStoreReader, + IEventStorageReader, IEventStream, - IEventStoreWriter + IEventStorageWriter } from "../interfaces"; import { nextCycle } from "./utils"; @@ -13,7 +13,7 @@ import { nextCycle } from "./utils"; * A simple event storage implementation intended to use for tests only. * Storage content resets on each app restart. */ -export class InMemoryEventStorage implements IEventStoreReader, IEventStoreWriter, IIdentifierProvider { +export class InMemoryEventStorage implements IEventStorageReader, IEventStorageWriter, IIdentifierProvider { #nextId: number = 0; #events: IEventSet = []; diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts index 70af6ee..16f3118 100644 --- a/src/interfaces/IEvent.ts +++ b/src/interfaces/IEvent.ts @@ -5,3 +5,12 @@ export type IEvent = IMessage & { /** Unique event identifier */ id?: string; }; + +export const isEvent = (event: unknown): event is IEvent => + isObject(event) + && 'type' in event + && typeof event.type === 'string' + && ( + 'aggregateId' in event + || 'sagaId' in event + ); diff --git a/src/interfaces/IEventSet.ts b/src/interfaces/IEventSet.ts index e54caf5..b65cc0a 100644 --- a/src/interfaces/IEventSet.ts +++ b/src/interfaces/IEventSet.ts @@ -1,3 +1,7 @@ -import { IEvent } from "./IEvent"; +import { IEvent, isEvent } from "./IEvent"; export type IEventSet = ReadonlyArray>; + +export const isEventSet = (arr: unknown): arr is IEventSet => + Array.isArray(arr) + && arr.every(isEvent); diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorage.ts index 9fa0dca..cd55ade 100644 --- a/src/interfaces/IEventStorage.ts +++ b/src/interfaces/IEventStorage.ts @@ -14,7 +14,7 @@ export type EventQueryBefore = { beforeEvent?: IEvent; } -export interface IEventStoreReader { +export interface IEventStorageReader { /** * Retrieves events of specified types that were emitted after a given event. */ @@ -31,7 +31,15 @@ export interface IEventStoreReader { getSagaEvents(sagaId: Identifier, options: EventQueryBefore): IEventStream; } -export const isIEventStoreReader = (storage: unknown): storage is IEventStoreReader => +export interface IEventStorageWriter { + /** + * Persists a set of events to the event store. + * Returns the persisted event set (potentially enriched or normalized). + */ + commitEvents(events: IEventSet): Promise; +} + +export const isIEventStorageReader = (storage: unknown): storage is IEventStorageReader => isObject(storage) && 'getEventsByTypes' in storage && typeof storage.getEventsByTypes === 'function' @@ -39,11 +47,3 @@ export const isIEventStoreReader = (storage: unknown): storage is IEventStoreRea && typeof storage.getAggregateEvents === 'function' && 'getSagaEvents' in storage && typeof storage.getSagaEvents === 'function'; - -export interface IEventStoreWriter { - /** - * Persists a set of events to the event store. - * Returns the persisted event set (potentially enriched or normalized). - */ - commitEvents(events: IEventSet): Promise; -} diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index 67ace1e..c647010 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,11 +1,11 @@ import { IEventDispatcher } from "./IEventDispatcher"; import { IEvent } from "./IEvent"; -import { IEventStoreReader } from "./IEventStorage"; +import { IEventStorageReader } from "./IEventStorage"; import { IIdentifierProvider } from "./IIdentifierProvider"; import { IMessageHandler, IObservable } from "./IObservable"; export interface IEventStore - extends IObservable, IEventDispatcher, IEventStoreReader, IIdentifierProvider { + extends IObservable, IEventDispatcher, IEventStorageReader, IIdentifierProvider { registerSagaStarters(startsWith: string[] | undefined): void; From f37ad5e488b272a84e1b9e94eea54758f9f9cb90 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 4 Apr 2025 01:26:38 +0100 Subject: [PATCH 030/169] Add support for event metadata in event dispatcher --- src/EventDispatcher.ts | 9 ++++++--- src/in-memory/InMemoryMessageBus.ts | 6 +++--- src/interfaces/IObservable.ts | 2 +- 3 files changed, 10 insertions(+), 7 deletions(-) diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index ac10bfa..bd1bba8 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -121,13 +121,16 @@ export class EventDispatcher implements IEventDispatcher { * * Returns a promise that resolves after all events are processed and published. */ - async dispatch(events: IEventSet) { - if (!Array.isArray(events) || events.length === 0) + async dispatch(events: IEventSet, meta?: Record) { + if (!isEventSet(events) || events.length === 0) throw new Error('dispatch requires a non-empty array of events'); const { promise, resolve, reject } = Promise.withResolvers(); const envelope: EventBatchEnvelope = { - data: events.map(event => ({ event })), + data: events.map(event => ({ + event, + ...meta + })), resolve, reject }; diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index c8f43f3..31eab51 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -101,7 +101,7 @@ export class InMemoryMessageBus implements IMessageBus { /** * Publish event to all subscribers (if any) */ - async publish(event: IEvent): Promise { + async publish(event: IEvent, meta?: Record): Promise { if (typeof event !== 'object' || !event) throw new TypeError('event argument must be an Object'); if (typeof event.type !== 'string' || !event.type.length) @@ -110,9 +110,9 @@ export class InMemoryMessageBus implements IMessageBus { const handlers = [ ...this.#handlers.get(event.type) || [], ...Array.from(this.#queues.values()).map(namedQueue => - (e: IEvent) => namedQueue.publish(e)) + (e: IEvent, m?: Record) => namedQueue.publish(e, m)) ]; - return Promise.all(handlers.map(handler => handler(event))); + return Promise.all(handlers.map(handler => handler(event, meta))); } } diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts index 076b85b..79774ba 100644 --- a/src/interfaces/IObservable.ts +++ b/src/interfaces/IObservable.ts @@ -2,7 +2,7 @@ import { IMessage } from "./IMessage"; import { isObject } from "./isObject"; export interface IMessageHandler { - (message: IMessage): any | Promise + (message: IMessage, meta?: Record): any | Promise }; export interface IObservable { From 8945398e688c425c32913ed5f36919867b0007a4 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 5 Apr 2025 00:33:02 +0100 Subject: [PATCH 031/169] Enforce strict types --- package-lock.json | 16 ++++++++++++---- package.json | 5 +++-- src/AbstractAggregate.ts | 4 ++-- src/AbstractProjection.ts | 2 +- src/EventDispatcher.ts | 9 ++++++--- src/in-memory/InMemoryEventStorage.ts | 8 +++++--- src/in-memory/InMemoryMessageBus.ts | 2 +- src/in-memory/InMemoryView.ts | 7 +++++-- src/interfaces/IEventDispatcher.ts | 2 +- src/rabbitmq/RabbitMqGateway.ts | 4 ++-- src/sqlite/SqliteEventLocker.ts | 3 --- src/sqlite/SqliteObjectStorage.ts | 3 --- src/sqlite/SqliteViewLocker.ts | 3 --- tsconfig.json | 10 +++++++--- 14 files changed, 45 insertions(+), 33 deletions(-) diff --git a/package-lock.json b/package-lock.json index e7b4b0e..723858f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10,7 +10,7 @@ "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.0.0", - "async-parallel-pipe": "^1.0.1", + "async-parallel-pipe": "^1.0.2", "di0": "^1.0.0" }, "devDependencies": { @@ -18,6 +18,7 @@ "@types/better-sqlite3": "^7.6.11", "@types/chai": "^4.3.20", "@types/jest": "^29.5.13", + "@types/md5": "^2.3.5", "@types/node": "^20.16.9", "@types/sinon": "^17.0.4", "chai": "^4.5.0", @@ -1186,6 +1187,13 @@ "pretty-format": "^29.0.0" } }, + "node_modules/@types/md5": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@types/md5/-/md5-2.3.5.tgz", + "integrity": "sha512-/i42wjYNgE6wf0j2bcTX6kuowmdL/6PE4IVitMpm2eYKBUuYCprdcWVK+xEF0gcV6ufMCRhtxmReGfc6hIK7Jw==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/minimist": { "version": "1.2.5", "resolved": "https://registry.npmjs.org/@types/minimist/-/minimist-1.2.5.tgz", @@ -1413,9 +1421,9 @@ "license": "MIT" }, "node_modules/async-parallel-pipe": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/async-parallel-pipe/-/async-parallel-pipe-1.0.1.tgz", - "integrity": "sha512-LnZtmPVzwMMvFywrQ2VKSsFlIWXuQogqkOfS5mxKoU3u0O9Di5zvVHMYW0HW/FdjTTz11l9a0pKw/mQ7DQgCww==", + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/async-parallel-pipe/-/async-parallel-pipe-1.0.2.tgz", + "integrity": "sha512-Ks0JUQJMYNAB4OOmGQJZIYSAuGCU60K2ldhbpDiF8JX8O0MbCWn4mqBM3vMM5i/AkJ5Zh1T+9jcetFKrq9T6lg==", "license": "MIT" }, "node_modules/babel-jest": { diff --git a/package.json b/package.json index d19af1c..5bcb35f 100644 --- a/package.json +++ b/package.json @@ -62,7 +62,7 @@ "homepage": "https://github.com/snatalenko/node-cqrs#readme", "dependencies": { "async-iterable-buffer": "^1.0.0", - "async-parallel-pipe": "^1.0.1", + "async-parallel-pipe": "^1.0.2", "di0": "^1.0.0" }, "devDependencies": { @@ -70,6 +70,7 @@ "@types/better-sqlite3": "^7.6.11", "@types/chai": "^4.3.20", "@types/jest": "^29.5.13", + "@types/md5": "^2.3.5", "@types/node": "^20.16.9", "@types/sinon": "^17.0.4", "chai": "^4.5.0", @@ -85,4 +86,4 @@ "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } -} \ No newline at end of file +} diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index fd69a79..3d87b08 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -42,7 +42,7 @@ export abstract class AbstractAggregate implements IProjection e.sagaId == sagaId && e.sagaVersion !== undefined && + beforeEvent.sagaVersion !== undefined && e.sagaVersion < beforeEvent.sagaVersion); await nextCycle(); diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index 31eab51..3a0bc54 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -95,7 +95,7 @@ export class InMemoryMessageBus implements IMessageBus { const commandHandler = handlers.values().next().value; - return commandHandler(command); + return commandHandler!(command); } /** diff --git a/src/in-memory/InMemoryView.ts b/src/in-memory/InMemoryView.ts index abd6e1b..4ef35ae 100644 --- a/src/in-memory/InMemoryView.ts +++ b/src/in-memory/InMemoryView.ts @@ -6,7 +6,7 @@ import { nextCycle } from './utils'; * Update given value with an update Cb and return updated value. * Wrapper is needed for backward compatibility with update methods that were modifying the passed in objects directly */ -function applyUpdate(view: T | undefined, update: (r?: T) => T | undefined): T | undefined { +function applyUpdate(view: T, update: (r: T) => T): T { const valueReturnedByUpdate = update(view); return valueReturnedByUpdate === undefined ? view : @@ -170,8 +170,11 @@ export class InMemoryView implements IViewLocker, IObjectStorage TRecord) { + private async _update(key: Identifier, update: (r: TRecord) => TRecord) { const value = this._map.get(key); + if (!value) + throw new Error(`Key '${key}' does not exist`); + const updatedValue = applyUpdate(value, update); if (updatedValue === undefined) return; diff --git a/src/interfaces/IEventDispatcher.ts b/src/interfaces/IEventDispatcher.ts index 9acfda5..bb5a0ba 100644 --- a/src/interfaces/IEventDispatcher.ts +++ b/src/interfaces/IEventDispatcher.ts @@ -3,5 +3,5 @@ import { IEventBus } from "./IEventBus"; export interface IEventDispatcher { readonly eventBus: IEventBus; - dispatch(events: IEventSet): Promise; + dispatch(events: IEventSet, meta?: Record): Promise; } diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 4969fcc..3fffd23 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -88,7 +88,7 @@ export class RabbitMqGateway { for (const subscription of subscriptionsToRestore) await this.subscribe(subscription); } - catch (err) { + catch (err: any) { this.#logger?.warn(`${this.#appId}: Connection attempt failed: ${err.message}`); await delay(5_000); } @@ -292,7 +292,7 @@ export class RabbitMqGateway { channel?.ack(msg); } - catch (err) { + catch (err: any) { this.#logger?.error(`${this.#appId}: Message processing failed: ${err.message}`); // Redirect message to dead letter queue, if `{ noAck: true }` was not set on consumption diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index 95cb6b1..81db266 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -52,10 +52,7 @@ export class SqliteEventLocker implements IEventLocker { this.#eventLockTableName = o.eventLockTableName ?? 'tbl_event_lock'; this.#eventLockTtl = o.eventLockTtl ?? 15_000; - this.#initialize(); - } - #initialize() { this.#db.exec(viewLockTableInit(this.#viewLockTableName)); this.#db.exec(eventLockTableInit(this.#eventLockTableName)); diff --git a/src/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts index ea0fc49..b780f2c 100644 --- a/src/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -23,10 +23,7 @@ export class SqliteObjectStorage implements IObjectStorage { this.#db = o.viewModelSqliteDb; this.#tableName = o.tableName; - this.#initialize(); - } - #initialize(): void { this.#db.exec(`CREATE TABLE IF NOT EXISTS ${this.#tableName} ( id BLOB PRIMARY KEY, version INTEGER DEFAULT 1, diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index 2073698..9320adf 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -64,10 +64,7 @@ export class SqliteViewLocker implements IViewLocker { o.logger.child({ service: this.constructor.name }) : o.logger; - this.#initialize(); - } - #initialize() { this.#db.exec(viewLockTableInit(this.#viewLockTableName)); this.#upsertTableLockQuery = this.#db.prepare(` diff --git a/tsconfig.json b/tsconfig.json index 6f3a80f..b0180a9 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -8,9 +8,13 @@ "outDir": "./dist", "target": "ESNext", "declaration": false, - "strictNullChecks": true, "allowSyntheticDefaultImports": true, - "resolveJsonModule": true + "resolveJsonModule": true, + "strict": true, + "strictNullChecks": true, + "strictFunctionTypes": true, + "strictBindCallApply": true, + "strictPropertyInitialization": true, }, "include": [ "src/**/*" @@ -19,4 +23,4 @@ "node_modules", "**/*.spec.ts" ] -} +} \ No newline at end of file From 922be7b75ea57d42f95587e9d624c82def37bc21 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 5 Apr 2025 00:50:48 +0100 Subject: [PATCH 032/169] Fix tests --- src/interfaces/IEvent.ts | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts index 16f3118..ec08092 100644 --- a/src/interfaces/IEvent.ts +++ b/src/interfaces/IEvent.ts @@ -9,8 +9,4 @@ export type IEvent = IMessage & { export const isEvent = (event: unknown): event is IEvent => isObject(event) && 'type' in event - && typeof event.type === 'string' - && ( - 'aggregateId' in event - || 'sagaId' in event - ); + && typeof event.type === 'string'; From 892366d027234673dd012b26cb355b5c6a455449 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 5 Apr 2025 01:17:58 +0100 Subject: [PATCH 033/169] Fix typing error --- src/sqlite/utils/getEventId.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/sqlite/utils/getEventId.ts b/src/sqlite/utils/getEventId.ts index 6d86ec3..309d49f 100644 --- a/src/sqlite/utils/getEventId.ts +++ b/src/sqlite/utils/getEventId.ts @@ -1,6 +1,6 @@ import { IEvent } from "../../interfaces"; import { guid } from './guid'; -import * as md5 from 'md5'; +import md5 = require('md5'); /** * Get assigned or generate new event ID from event content From aa5ea950023a62a758ee3562fe3fe8a27beaeb07 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 5 Apr 2025 18:05:02 +0100 Subject: [PATCH 034/169] Split `storage` onto separate dependencies: `eventStorageReader`, `eventStorageWriter` --- src/EventStore.ts | 22 +++++++++---------- .../EventPersistenceProcessor.ts | 14 ++++++------ tests/unit/AbstractProjection.test.ts | 9 ++++++-- tests/unit/AggregateCommandHandler.test.ts | 12 +++++++--- tests/unit/CqrsContainerBuilder.test.ts | 2 +- tests/unit/EventStore.test.ts | 6 ++--- tests/unit/SagaEventHandler.test.ts | 9 ++++++-- 7 files changed, 45 insertions(+), 29 deletions(-) diff --git a/src/EventStore.ts b/src/EventStore.ts index d54c988..44daf80 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -28,7 +28,7 @@ import { EventDispatcher } from "./EventDispatcher"; export class EventStore implements IEventStore { #identifierProvider: IIdentifierProvider; - #storage: IEventStorageReader; + #eventStorageReader: IEventStorageReader; #snapshotStorage: IAggregateSnapshotStorage | undefined; eventBus: IEventBus; #eventDispatcher: IEventDispatcher; @@ -36,30 +36,30 @@ export class EventStore implements IEventStore { #logger?: ILogger; constructor({ - storage, - identifierProvider = isIdentifierProvider(storage) ? storage : undefined, + eventStorageReader, + identifierProvider = isIdentifierProvider(eventStorageReader) ? eventStorageReader : undefined, snapshotStorage, eventBus, eventDispatcher, logger, }: { - storage: IEventStorageReader, + eventStorageReader: IEventStorageReader, identifierProvider?: IIdentifierProvider, snapshotStorage?: IAggregateSnapshotStorage, eventBus?: IEventBus, eventDispatcher?: IEventDispatcher, logger?: ILogger | IExtendableLogger, }) { - if (!storage) - throw new TypeError('storage argument required'); + if (!eventStorageReader) + throw new TypeError('eventStorageReader argument required'); if (!identifierProvider) throw new TypeError('identifierProvider argument required'); - if (!isIEventStorageReader(storage)) + if (!isIEventStorageReader(eventStorageReader)) throw new TypeError('storage does not implement IEventStorage interface'); if (eventBus && !isIEventBus(eventBus)) throw new TypeError('eventBus does not implement IMessageBus interface'); - this.#storage = storage; + this.#eventStorageReader = eventStorageReader; this.#identifierProvider = identifierProvider; this.#snapshotStorage = snapshotStorage; this.#eventDispatcher = eventDispatcher ?? new EventDispatcher({ eventBus }); @@ -84,7 +84,7 @@ export class EventStore implements IEventStore { this.#logger?.debug(`retrieving ${eventTypes.join(', ')} events...`); - const eventsIterable = await this.#storage.getEventsByTypes(eventTypes, options); + const eventsIterable = await this.#eventStorageReader.getEventsByTypes(eventTypes, options); yield* eventsIterable; @@ -105,7 +105,7 @@ export class EventStore implements IEventStore { if (snapshot) yield snapshot; - const eventsIterable = await this.#storage.getAggregateEvents(aggregateId, { snapshot }); + const eventsIterable = await this.#eventStorageReader.getAggregateEvents(aggregateId, { snapshot }); yield* eventsIterable; @@ -125,7 +125,7 @@ export class EventStore implements IEventStore { this.#logger?.debug(`retrieving event stream for saga ${sagaId}, v${filter.beforeEvent.sagaVersion}...`); - const eventsIterable = await this.#storage.getSagaEvents(sagaId, filter); + const eventsIterable = await this.#eventStorageReader.getSagaEvents(sagaId, filter); yield* eventsIterable; diff --git a/src/dispatch-pipeline/EventPersistenceProcessor.ts b/src/dispatch-pipeline/EventPersistenceProcessor.ts index eb63599..d91e89f 100644 --- a/src/dispatch-pipeline/EventPersistenceProcessor.ts +++ b/src/dispatch-pipeline/EventPersistenceProcessor.ts @@ -5,17 +5,17 @@ import { EventBatch, IEvent, IEventProcessor, IEventStorageWriter } from '../int */ export class EventPersistenceProcessor implements IEventProcessor { - #storage: IEventStorageWriter; + #storageWriter: IEventStorageWriter; - constructor(options: { storage: IEventStorageWriter }) { - if (!options.storage) - throw new TypeError('storage argument required'); + constructor(options: { eventStorageWriter: IEventStorageWriter }) { + if (!options.eventStorageWriter) + throw new TypeError('eventStorageWriter argument required'); - this.#storage = options.storage; + this.#storageWriter = options.eventStorageWriter; } async process(batch: EventBatch): Promise { - if (!this.#storage) + if (!this.#storageWriter) return batch; const events: IEvent[] = []; @@ -26,7 +26,7 @@ export class EventPersistenceProcessor implements IEventProcessor { events.push(event); } - await this.#storage.commitEvents(events); + await this.#storageWriter.commitEvents(events); return batch; } diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index 818ee8f..af37fba 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -168,10 +168,15 @@ describe('AbstractProjection', function () { it('waits until the restoring process is done', async () => { - const storage = new InMemoryEventStorage(); + const eventStorageReader = new InMemoryEventStorage(); const eventBus = new InMemoryMessageBus(); const eventDispatcher = new EventDispatcher({ eventBus }); - const es = new EventStore({ storage, eventBus, eventDispatcher, identifierProvider: storage }); + const es = new EventStore({ + eventStorageReader, + eventBus, + eventDispatcher, + identifierProvider: eventStorageReader + }); let restored = false; let projected = false; diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index c19f82f..0e5ead3 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -43,7 +43,7 @@ describe('AggregateCommandHandler', function () { // this.timeout(500); // this.slow(300); - let storage: InMemoryEventStorage; + let eventStorageReader: InMemoryEventStorage; let snapshotStorage: InMemorySnapshotStorage; let eventStore: IEventStore; let commandBus: ICommandBus; @@ -55,11 +55,17 @@ describe('AggregateCommandHandler', function () { beforeEach(() => { eventBus = new InMemoryMessageBus(); - storage = new InMemoryEventStorage(); + eventStorageReader = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); const eventDispatcher = new EventDispatcher({ eventBus }); - eventStore = new EventStore({ storage, snapshotStorage, eventBus, eventDispatcher, identifierProvider: storage }); + eventStore = new EventStore({ + eventStorageReader, + snapshotStorage, + eventBus, + eventDispatcher, + identifierProvider: eventStorageReader + }); getNewIdSpy = sinon.spy(eventStore, 'getNewId'); getAggregateEventsSpy = sinon.spy(eventStore, 'getAggregateEvents'); commitSpy = sinon.spy(eventStore, 'dispatch'); diff --git a/tests/unit/CqrsContainerBuilder.test.ts b/tests/unit/CqrsContainerBuilder.test.ts index 37fe640..844af3f 100644 --- a/tests/unit/CqrsContainerBuilder.test.ts +++ b/tests/unit/CqrsContainerBuilder.test.ts @@ -15,7 +15,7 @@ describe('CqrsContainerBuilder', function () { beforeEach(() => { builder = new ContainerBuilder(); - builder.register(InMemoryEventStorage).as('storage').as('identifierProvider'); + builder.register(InMemoryEventStorage).as('eventStorageWriter').as('eventStorageReader').as('identifierProvider'); builder.register(InMemoryMessageBus).as('eventBus'); }); diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index 16c89a4..dcd1048 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -4,7 +4,7 @@ import { EventStore } from '../../src/EventStore'; import { IEvent, IEventBus, - IEventStoreReader, + IEventStorageReader, IAggregateSnapshotStorage, IIdentifierProvider } from '../../src/interfaces'; @@ -14,7 +14,7 @@ describe('EventStore', () => { let store: EventStore; let eventBus: IEventBus; let eventDispatcher: IEventDispatcher; - let mockStorage: jest.Mocked; + let mockStorage: jest.Mocked; let mockSnapshotStorage: jest.Mocked; let mockIdentifierProvider: jest.Mocked; const mockId = 'test-id'; @@ -40,7 +40,7 @@ describe('EventStore', () => { store = new EventStore({ eventBus, eventDispatcher, - storage: mockStorage, + eventStorageReader: mockStorage, identifierProvider: mockIdentifierProvider, snapshotStorage: mockSnapshotStorage, logger: undefined diff --git a/tests/unit/SagaEventHandler.test.ts b/tests/unit/SagaEventHandler.test.ts index f84f167..1556bc2 100644 --- a/tests/unit/SagaEventHandler.test.ts +++ b/tests/unit/SagaEventHandler.test.ts @@ -45,9 +45,14 @@ describe('SagaEventHandler', function () { beforeEach(() => { const eventBus = new InMemoryMessageBus(); const eventDispatcher = new EventDispatcher({ eventBus }); - const storage = new InMemoryEventStorage(); + const eventStorageReader = new InMemoryEventStorage(); commandBus = new CommandBus({}); - eventStore = new EventStore({ storage, identifierProvider: storage, eventBus, eventDispatcher }); + eventStore = new EventStore({ + eventStorageReader, + identifierProvider: eventStorageReader, + eventBus, + eventDispatcher + }); sagaEventHandler = new SagaEventHandler({ sagaType: Saga, eventStore, commandBus }); }); From 4f3b8b797fb37f37c86db026dcf0ffb14988bfd4 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 5 Apr 2025 18:47:47 +0100 Subject: [PATCH 035/169] Add missing export instructions for CJS loader --- package.json | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/package.json b/package.json index 5bcb35f..07a4600 100644 --- a/package.json +++ b/package.json @@ -24,14 +24,17 @@ }, "exports": { ".": { + "require": "./dist/index.js", "import": "./dist/index.js", "types": "./src/index.ts" }, "./rabbitmq": { + "require": "./dist/rabbitmq/index.js", "import": "./dist/rabbitmq/index.js", "types": "./src/rabbitmq/index.ts" }, "./sqlite": { + "require": "./dist/sqlite/index.js", "import": "./dist/sqlite/index.js", "types": "./src/sqlite/index.ts" } @@ -86,4 +89,4 @@ "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } -} +} \ No newline at end of file From 1e98a9e550521bc7991afc8b773bc248d1727c10 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 6 Apr 2025 01:58:46 +0100 Subject: [PATCH 036/169] Export `IContainer` interface --- src/AggregateCommandHandler.ts | 7 ++-- src/CqrsContainerBuilder.ts | 37 +++++++------------ src/EventDispatcher.ts | 11 ++++-- src/EventStore.ts | 20 +++++----- src/SagaEventHandler.ts | 6 +-- .../EventPersistenceProcessor.ts | 9 ++--- src/interfaces/IContainer.ts | 25 +++++++++++++ src/interfaces/index.ts | 1 + 8 files changed, 66 insertions(+), 50 deletions(-) create mode 100644 src/interfaces/IContainer.ts diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index 7339890..f15d402 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -5,6 +5,7 @@ import { ICommand, ICommandBus, ICommandHandler, + IContainer, Identifier, IEventSet, IEventStore, @@ -39,12 +40,10 @@ export class AggregateCommandHandler implements ICommandHandler { aggregateFactory, handles, logger - }: { - eventStore: IEventStore, + }: Pick & { aggregateType?: IAggregateConstructor, aggregateFactory?: IAggregateFactory, - handles?: string[], - logger?: ILogger | IExtendableLogger + handles?: string[] }) { if (!eventStore) throw new TypeError('eventStore argument required'); diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 57c337f..4ed14fe 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -1,4 +1,4 @@ -import { ContainerBuilder, Container, TypeConfig, TClassOrFactory } from 'di0'; +import { ContainerBuilder, TypeConfig, TClassOrFactory } from 'di0'; import { AggregateCommandHandler } from './AggregateCommandHandler'; import { CommandBus } from './CommandBus'; @@ -18,21 +18,15 @@ import { import { IAggregateConstructor, - ICommandBus, ICommandHandler, + IContainer, IEventReceptor, - IEventStore, IProjection, IProjectionConstructor, ISagaConstructor } from './interfaces'; import { ExternalEventPublishingProcessor } from './dispatch-pipeline/ExternalEventPublishingProcessor'; -interface CqrsContainer extends Container { - eventStore: IEventStore; - commandBus: ICommandBus; -} - export class CqrsContainerBuilder extends ContainerBuilder { constructor(options?: { @@ -43,22 +37,19 @@ export class CqrsContainerBuilder extends ContainerBuilder { super.register(InMemoryMessageBus).as('eventBus'); super.register(EventStore).as('eventStore'); super.register(CommandBus).as('commandBus'); - - super.register(container => { - const eventDispatcher = new EventDispatcher(container); - eventDispatcher.addPipelineProcessor(new EventValidationProcessor(container)); - eventDispatcher.addPipelineProcessor(new ExternalEventPublishingProcessor(container)); - eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor(container)); - eventDispatcher.addPipelineProcessor(new SnapshotPersistenceProcessor(container)); - - return eventDispatcher; - }).as('eventDispatcher'); + super.register(EventDispatcher).as('eventDispatcher'); + super.register(container => [ + new EventValidationProcessor(container), + new ExternalEventPublishingProcessor(container), + new EventPersistenceProcessor(container), + new SnapshotPersistenceProcessor(container) + ]).as('eventDispatchProcessors'); } /** Register command handler, which will be subscribed to commandBus upon instance creation */ registerCommandHandler(typeOrFactory: TClassOrFactory) { return super.register( - (container: CqrsContainer) => { + (container: IContainer) => { const handler = container.createInstance(typeOrFactory); handler.subscribe(container.commandBus); return handler; @@ -69,7 +60,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { /** Register event receptor, which will be subscribed to eventStore upon instance creation */ registerEventReceptor(typeOrFactory: TClassOrFactory) { return super.register( - (container: CqrsContainer) => { + (container: IContainer) => { const receptor = container.createInstance(typeOrFactory); receptor.subscribe(container.eventStore); return receptor; @@ -85,7 +76,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { if (!isClass(ProjectionType)) throw new TypeError('ProjectionType argument must be a constructor function'); - const projectionFactory = (container: CqrsContainer): IProjection => { + const projectionFactory = (container: IContainer): IProjection => { const projection = container.createInstance(ProjectionType); projection.subscribe(container.eventStore); @@ -108,7 +99,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { if (!isClass(AggregateType)) throw new TypeError('AggregateType argument must be a constructor function'); - const commandHandlerFactory = (container: CqrsContainer): ICommandHandler => + const commandHandlerFactory = (container: IContainer): ICommandHandler => container.createInstance(AggregateCommandHandler, { aggregateFactory: (options: any) => container.createInstance(AggregateType, options), @@ -124,7 +115,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { if (!isClass(SagaType)) throw new TypeError('SagaType argument must be a constructor function'); - const eventReceptorFactory = (container: CqrsContainer): IEventReceptor => + const eventReceptorFactory = (container: IContainer): IEventReceptor => container.createInstance(SagaEventHandler, { sagaFactory: (options: any) => container.createInstance(SagaType, options), handles: SagaType.handles, diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 82444d7..10c1fdb 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -5,7 +5,8 @@ import { IEventProcessor, IEventSet, IEventBus, - isEventSet + isEventSet, + IContainer } from "./interfaces"; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; @@ -37,14 +38,18 @@ export class EventDispatcher implements IEventDispatcher { */ concurrentLimit: number; - constructor(o?: { - eventBus?: IEventBus, + constructor(o?: Pick & { eventDispatcherConfig?: { concurrentLimit?: number } }) { this.eventBus = o?.eventBus ?? new InMemoryMessageBus(); this.concurrentLimit = o?.eventDispatcherConfig?.concurrentLimit ?? 100; + + if (o?.eventDispatchProcessors) { + for (const processor of o.eventDispatchProcessors) + this.addPipelineProcessor(processor); + } } /** diff --git a/src/EventStore.ts b/src/EventStore.ts index 44daf80..7f269a1 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -3,7 +3,6 @@ import { IEvent, IEventStorageReader, IEventSet, - IExtendableLogger, ILogger, IMessageHandler, IObservable, @@ -17,7 +16,8 @@ import { IEventDispatcher, IEventBus, isIEventBus, - isIEventStorageReader + isIEventStorageReader, + IContainer } from "./interfaces"; import { getClassName, @@ -42,14 +42,14 @@ export class EventStore implements IEventStore { eventBus, eventDispatcher, logger, - }: { - eventStorageReader: IEventStorageReader, - identifierProvider?: IIdentifierProvider, - snapshotStorage?: IAggregateSnapshotStorage, - eventBus?: IEventBus, - eventDispatcher?: IEventDispatcher, - logger?: ILogger | IExtendableLogger, - }) { + }: Pick) { if (!eventStorageReader) throw new TypeError('eventStorageReader argument required'); if (!identifierProvider) diff --git a/src/SagaEventHandler.ts b/src/SagaEventHandler.ts index 6b538b3..a367a7f 100644 --- a/src/SagaEventHandler.ts +++ b/src/SagaEventHandler.ts @@ -1,6 +1,7 @@ import * as Event from './Event'; import { ICommandBus, + IContainer, IEvent, IEventReceptor, IEventStore, @@ -34,12 +35,9 @@ export class SagaEventHandler implements IEventReceptor { #startsWith: string[]; #handles: string[]; - constructor(options: { + constructor(options: Pick & { sagaType?: ISagaConstructor, sagaFactory?: ISagaFactory, - eventStore: IEventStore, - commandBus: ICommandBus, - logger?: ILogger | IExtendableLogger, queueName?: string, startsWith?: string[], handles?: string[] diff --git a/src/dispatch-pipeline/EventPersistenceProcessor.ts b/src/dispatch-pipeline/EventPersistenceProcessor.ts index d91e89f..d5ed7b6 100644 --- a/src/dispatch-pipeline/EventPersistenceProcessor.ts +++ b/src/dispatch-pipeline/EventPersistenceProcessor.ts @@ -1,16 +1,13 @@ -import { EventBatch, IEvent, IEventProcessor, IEventStorageWriter } from '../interfaces'; +import { EventBatch, IContainer, IEvent, IEventProcessor, IEventStorageWriter } from '../interfaces'; /** * Processor responsible for persisting events to IEventStoreWriter. */ export class EventPersistenceProcessor implements IEventProcessor { - #storageWriter: IEventStorageWriter; - - constructor(options: { eventStorageWriter: IEventStorageWriter }) { - if (!options.eventStorageWriter) - throw new TypeError('eventStorageWriter argument required'); + #storageWriter: IEventStorageWriter | undefined; + constructor(options: Pick) { this.#storageWriter = options.eventStorageWriter; } diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts new file mode 100644 index 0000000..0d657a0 --- /dev/null +++ b/src/interfaces/IContainer.ts @@ -0,0 +1,25 @@ +import { Container } from "di0"; +import { ICommandBus } from "./ICommandBus"; +import { IEventDispatcher } from "./IEventDispatcher"; +import { IEventStore } from "./IEventStore"; +import { IEventBus } from "./IEventBus"; +import { IEventProcessor } from "./IEventProcessor"; +import { IEventStorageReader, IEventStorageWriter } from "./IEventStorage"; +import { IAggregateSnapshotStorage } from "./IAggregateSnapshotStorage"; +import { IIdentifierProvider } from "./IIdentifierProvider"; +import { IExtendableLogger, ILogger } from "./ILogger"; + +export interface IContainer extends Container { + eventBus: IEventBus; + eventStore: IEventStore + eventStorageReader: IEventStorageReader; + eventStorageWriter?: IEventStorageWriter; + identifierProvider?: IIdentifierProvider; + snapshotStorage?: IAggregateSnapshotStorage; + + commandBus: ICommandBus; + eventDispatcher: IEventDispatcher; + eventDispatchProcessors?: IEventProcessor[]; + + logger?: ILogger | IExtendableLogger; +} diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index a78ae56..bb70131 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -2,6 +2,7 @@ export * from './IAggregate'; export * from './IAggregateSnapshotStorage'; export * from './ICommand'; export * from './ICommandBus'; +export * from './IContainer'; export * from './Identifier'; export * from './IEvent'; export * from './IEventBus'; From 2d4265de6740eb254df97db52d440cafb877b424 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Apr 2025 00:59:53 +0100 Subject: [PATCH 037/169] Add RabbitMqEventInjector --- src/rabbitmq/IContainer.ts | 10 ++ src/rabbitmq/RabbitMqEventInjector.ts | 65 +++++++++++++ src/rabbitmq/index.ts | 1 + .../rabbitmq/RabbitMqEventInjector.test.ts | 91 +++++++++++++++++++ 4 files changed, 167 insertions(+) create mode 100644 src/rabbitmq/IContainer.ts create mode 100644 src/rabbitmq/RabbitMqEventInjector.ts create mode 100644 tests/integration/rabbitmq/RabbitMqEventInjector.test.ts diff --git a/src/rabbitmq/IContainer.ts b/src/rabbitmq/IContainer.ts new file mode 100644 index 0000000..18da704 --- /dev/null +++ b/src/rabbitmq/IContainer.ts @@ -0,0 +1,10 @@ +import { RabbitMqEventInjector } from "./RabbitMqEventInjector"; +import { RabbitMqGateway } from "./RabbitMqGateway"; + +declare module '../interfaces/IContainer' { + interface IContainer { + rabbitMqGateway?: RabbitMqGateway; + rabbitMqEventInjector?: RabbitMqEventInjector; + rabbitMqEventBus?: RabbitMqEventInjector; + } +} diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts new file mode 100644 index 0000000..f6ae456 --- /dev/null +++ b/src/rabbitmq/RabbitMqEventInjector.ts @@ -0,0 +1,65 @@ +import { IContainer } from "../interfaces/IContainer"; +import { IMessage } from "../interfaces/IMessage"; +import { RabbitMqGateway } from "./RabbitMqGateway"; +import { IEventDispatcher, isEvent } from "../interfaces"; +import * as Event from '../Event'; + +export class RabbitMqEventInjector { + #rabbitMqGateway: RabbitMqGateway; + #eventDispatcher: IEventDispatcher; + #logger: IContainer['logger']; + + #exchangeName: string; + #queueName: string; + #messageHandler: (message: IMessage) => Promise; + + constructor(container: Partial> & { + exchange?: string; + queueName?: string; + }) { + if (!container.eventDispatcher) + throw new Error("eventDispatcher is required in the container."); + if (!container.rabbitMqGateway) + throw new Error("rabbitMqGateway is required in the container."); + + this.#rabbitMqGateway = container.rabbitMqGateway; + this.#eventDispatcher = container.eventDispatcher; + + this.#logger = container.logger && 'child' in container.logger ? + container.logger.child({ service: new.target.name }) : + container.logger; + + this.#exchangeName = container.exchange ?? 'node-cqrs.events'; + this.#queueName = container.queueName ?? 'node-cqrs.persistence'; + this.#messageHandler = this.#handleMessage.bind(this); + + this.start(); + } + + async start(): Promise { + this.#logger?.info(`Starting event injection from queue "${this.#queueName}"`); + + await this.#rabbitMqGateway.subscribeToQueue( + this.#exchangeName, + this.#queueName, + this.#messageHandler + ); + + this.#logger?.info(`Subscribed to queue "${this.#queueName}" on exchange "${this.#exchangeName}"`); + } + + async #handleMessage(message: IMessage): Promise { + this.#logger?.debug(`Received message from queue "${this.#queueName}": ${message.type}`); + try { + // EventDispatcher expects an array of events (IEventSet) + // Assuming IMessage is compatible with IEvent or needs transformation + await this.#eventDispatcher.dispatch([message]); + this.#logger?.debug(`Event ${Event.describe(message)} dispatched successfully`); + } + catch (error: any) { + this.#logger?.error(`Failed to dispatch event ${message.type}: ${error.message}`, { stack: error.stack }); + + throw error; // Re-throw to ensure message is nack'd by the gateway + } + } +} diff --git a/src/rabbitmq/index.ts b/src/rabbitmq/index.ts index 79404df..26b4d04 100644 --- a/src/rabbitmq/index.ts +++ b/src/rabbitmq/index.ts @@ -1,2 +1,3 @@ export * from './RabbitMqEventBus'; +export * from './RabbitMqEventInjector'; export * from './RabbitMqGateway'; diff --git a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts new file mode 100644 index 0000000..b733d98 --- /dev/null +++ b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts @@ -0,0 +1,91 @@ +import * as amqplib from 'amqplib'; +import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; +import { RabbitMqEventInjector } from '../../../src/rabbitmq/RabbitMqEventInjector'; +import { IEvent, IEventDispatcher, IMessage } from '../../../src/interfaces'; +import { jest } from '@jest/globals'; +import { delay } from '../../../src/utils'; + +describe('RabbitMqEventInjector', () => { + let rabbitMqGateway: RabbitMqGateway; + let eventDispatcher: jest.Mocked; + let injector: RabbitMqEventInjector; + + const exchange = 'node-cqrs.events'; + const queueName = 'test-injector-queue'; + const deadLetterQueueName = `${queueName}.failed`; + const eventType = 'test-injector-event'; + + beforeEach(async () => { + const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); + rabbitMqGateway = new RabbitMqGateway({ rabbitMqConnectionFactory }); + + eventDispatcher = { + dispatch: jest.fn().mockResolvedValue(undefined), + } as unknown as jest.Mocked; + + injector = new RabbitMqEventInjector({ + rabbitMqGateway, + eventDispatcher, + queueName, + exchange + }); + + await delay(50); // Allow time for subscription setup + }); + + afterEach(async () => { + try { + const ch = await rabbitMqGateway.connection?.createChannel(); + if (ch) { + await ch.deleteQueue(queueName); + await ch.deleteQueue(`${queueName}.failed`); + await ch.deleteExchange(exchange); + await ch.close(); + } + } + catch (error) { + console.warn('Error during RabbitMQ cleanup:', error); + } + finally { + await rabbitMqGateway.disconnect(); + } + }); + + it('receives a message from the queue and dispatch it via EventDispatcher', async () => { + const testEvent: IEvent = { + type: eventType, + payload: { data: 'test-payload' }, + id: 'test-id-123', + }; + + await rabbitMqGateway.publish(exchange, testEvent); + + await delay(50); + + expect(eventDispatcher.dispatch).toHaveBeenCalledTimes(1); + expect(eventDispatcher.dispatch).toHaveBeenCalledWith([testEvent]); + }); + + it('handles errors during event dispatch and nack the message', async () => { + const testEvent: IEvent = { + type: 'error-event', + payload: { data: 'trigger-error' }, + id: 'error-id-456', + }; + const dispatchError = new Error('Dispatch failed'); + eventDispatcher.dispatch.mockRejectedValueOnce(dispatchError); + + // Publish the event + await rabbitMqGateway.publish(exchange, testEvent); + + await delay(100); + + const ch = await rabbitMqGateway.connection!.createChannel(); + const deadLetterMessage = await ch.get(deadLetterQueueName, { noAck: true }); + if (!deadLetterMessage) + throw new Error('Dead letter message not found'); + + const messageContent = JSON.parse(deadLetterMessage.content.toString()); + expect(messageContent).toEqual(testEvent); + }); +}); From 252bba6175b64421c06ee2a7113fe63707cdffa3 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Apr 2025 01:45:47 +0100 Subject: [PATCH 038/169] Fix integration tests --- examples/user-domain/index.js | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index 6a66706..32126eb 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -20,7 +20,7 @@ exports.createContainer = () => { const builder = new ContainerBuilder(); // register infrastructure services - builder.register(InMemoryEventStorage).as('storage'); + builder.register(InMemoryEventStorage).as('eventStorageReader').as('eventStorageWriter'); builder.register(InMemoryMessageBus).as('eventBus'); // register domain entities @@ -39,9 +39,9 @@ exports.createBaseInstances = () => { const eventBus = new InMemoryMessageBus(); const storage = new InMemoryEventStorage(); const eventDispatcher = new EventDispatcher({ eventBus }) - eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor({ storage })); + eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor({ eventStorageWriter: storage })); - const eventStore = new EventStore({ storage, eventBus, eventDispatcher }); + const eventStore = new EventStore({ eventStorageReader: storage, eventBus, eventDispatcher }); const commandBus = new CommandBus(); /** @type {import('../..').IAggregateConstructor} */ From 4d1c63d440061593bf817e73435596109c15c5a4 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Apr 2025 01:46:20 +0100 Subject: [PATCH 039/169] Enhance RabbitMqGateway to handle SIGINT for graceful shutdown and update IContainer interface --- src/interfaces/IContainer.ts | 1 + src/rabbitmq/RabbitMqGateway.ts | 54 +++++++++++++++---- .../rabbitmq/RabbitMqGateway.test.ts | 39 +++++++++++++- 3 files changed, 84 insertions(+), 10 deletions(-) diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index 0d657a0..c2e0c3f 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -22,4 +22,5 @@ export interface IContainer extends Container { eventDispatchProcessors?: IEventProcessor[]; logger?: ILogger | IExtendableLogger; + process?: NodeJS.Process } diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 3fffd23..ab00b06 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,6 +1,6 @@ import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; import { - IExtendableLogger, + IContainer, ILogger, IMessage, isMessage @@ -43,7 +43,7 @@ export class RabbitMqGateway { #pubChannel: ConfirmChannel | undefined; #exclusiveQueueName: string | undefined; #queueChannels = new Map(); - #queueConsumers = new Map(); + #queueConsumers = new Map(); #subscriptions: Array = []; #handlers: Map>> = new Map(); @@ -56,9 +56,8 @@ export class RabbitMqGateway { return this.#pubChannel; } - constructor(o: { - rabbitMqConnectionFactory?: () => Promise, - logger?: ILogger | IExtendableLogger + constructor(o: Partial> & { + rabbitMqConnectionFactory?: () => Promise }) { if (!o.rabbitMqConnectionFactory) throw new TypeError('rabbitMqConnectionFactory argument required'); @@ -68,6 +67,9 @@ export class RabbitMqGateway { this.#logger = o.logger && 'child' in o.logger ? o.logger.child({ service: new.target.name }) : o.logger; + + if (o.process) + o.process.on('SIGINT', () => this.#stopConsuming()); } async connect(): Promise { @@ -100,9 +102,40 @@ export class RabbitMqGateway { } async disconnect() { - await this.#connection?.close(); - if (this.#connection) // clean up in case 'close' event was not triggered - this.#onConnectionClosed(); + try { + this.#logger?.debug(`${this.#appId}: Disconnecting from RabbitMQ...`); + + await this.#stopConsuming(); + await this.#connection?.close(); + if (this.#connection) // clean up in case 'close' event was not triggered + this.#onConnectionClosed(); + + this.#logger?.debug(`${this.#appId}: Disconnected from RabbitMQ`); + } + catch (err: any) { + this.#logger?.error(`${this.#appId}: Failed to disconnect from RabbitMQ: ${err.message}`, { + stack: err.stack + }); + } + } + + async #stopConsuming() { + this.#logger?.info(`${this.#appId}: Stopping all consumers...`); + + const cancellations = this.#queueConsumers.entries().map(async ([queueName, { channel, consumerTag }]) => { + this.#logger?.debug(`${this.#appId}: Cancelling consumer "${consumerTag}" for queue "${queueName}"`); + try { + await channel.cancel(consumerTag); + this.#logger?.debug(`${this.#appId}: Consumer "${consumerTag}" on queue "${queueName}" cancelled successfully`); + this.#queueConsumers.delete(queueName); + } + catch (err: any) { + this.#logger?.error(`${this.#appId}: Failed to cancel consumer "${consumerTag}" for queue "${queueName}": ${err.message}`); + } + }); + + await Promise.all(cancellations); + this.#logger?.info(`${this.#appId}: All consumers stopped.`); } #onConnectionError(err: Error) { @@ -302,7 +335,10 @@ export class RabbitMqGateway { this.#logger?.debug(`${this.#appId}: Consumer "${c.consumerTag}" registered on queue "${queueGivenName}"`); - this.#queueConsumers.set(queueGivenName, c.consumerTag); + this.#queueConsumers.set(queueGivenName, { + channel, + consumerTag: c.consumerTag + }); } /** diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index 6999fda..271d90d 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -2,6 +2,8 @@ import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; import { IMessage } from '../../../src/interfaces'; import * as amqplib from 'amqplib'; import { delay } from '../../../src/utils'; +import { Deferred } from '../../../dist/in-memory/utils/Deferred'; +import { EventEmitter } from 'stream'; describe('RabbitMqGateway', () => { @@ -10,11 +12,11 @@ describe('RabbitMqGateway', () => { let gateway3: RabbitMqGateway | undefined; const exchange = 'test-exchange'; const queueName = 'test-queue'; + const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); beforeEach(async () => { const logger = undefined; // const logger = console; - const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); gateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); gateway3 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); @@ -302,5 +304,40 @@ describe('RabbitMqGateway', () => { expect(fanoutReceived).toEqual([message]); expect(queueReceived).toEqual([message]); }); + + it('stops receiving messages on SIGINT', async () => { + + const received: IMessage[] = []; + const process = new EventEmitter(); + const handlerBlocker = new Deferred(); + const message: IMessage = { + type: 'test.sigint', + payload: { check: true } + }; + + gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory, process: process as any }); + + await gateway1.subscribeToFanout(exchange, async msg => { + await handlerBlocker.promise; + received.push(msg); + }); + + gateway3 = new RabbitMqGateway({ rabbitMqConnectionFactory }); + + await gateway3.publish(exchange, message); + await delay(50); + + expect(received).toHaveLength(0); + + process.emit('SIGINT'); + await delay(10); + + expect(received).toHaveLength(0); + + handlerBlocker.resolve(); + await delay(10); + + expect(received).toHaveLength(1); + }); }); }); From 46c4a97ac451cbb8057b5db9a4b5c7de9175c9e7 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Apr 2025 03:28:02 +0100 Subject: [PATCH 040/169] Add eslint --- eslint.config.mjs | 837 +++++++++++ jest.config.ts | 18 +- package-lock.json | 1240 ++++++++++++++++- package.json | 13 +- scripts/changelog/index.js | 2 +- src/AbstractAggregate.ts | 3 +- src/AbstractProjection.ts | 1 + src/AbstractSaga.ts | 6 +- src/AggregateCommandHandler.ts | 9 +- src/CommandBus.ts | 11 +- src/Event.ts | 2 +- src/EventDispatcher.ts | 12 +- src/EventStore.ts | 8 +- src/SagaEventHandler.ts | 1 - .../SnapshotPersistenceProcessor.ts | 2 +- src/in-memory/InMemoryEventStorage.ts | 14 +- src/in-memory/InMemoryLock.ts | 2 +- src/in-memory/InMemoryMessageBus.ts | 7 +- src/in-memory/InMemorySnapshotStorage.ts | 2 +- src/in-memory/InMemoryView.ts | 2 +- src/interfaces/IAggregate.ts | 10 +- src/interfaces/IAggregateSnapshotStorage.ts | 7 +- src/interfaces/ICommand.ts | 2 +- src/interfaces/ICommandBus.ts | 8 +- src/interfaces/IContainer.ts | 22 +- src/interfaces/IEvent.ts | 5 +- src/interfaces/IEventBus.ts | 4 +- src/interfaces/IEventDispatcher.ts | 4 +- src/interfaces/IEventLocker.ts | 4 +- src/interfaces/IEventProcessor.ts | 2 +- src/interfaces/IEventReceptor.ts | 4 +- src/interfaces/IEventSet.ts | 2 +- src/interfaces/IEventStorage.ts | 14 +- src/interfaces/IEventStore.ts | 10 +- src/interfaces/IEventStream.ts | 2 +- src/interfaces/IIdentifierProvider.ts | 5 +- src/interfaces/IMessage.ts | 5 +- src/interfaces/IMessageBus.ts | 6 +- src/interfaces/IObjectStorage.ts | 2 +- src/interfaces/IObservable.ts | 7 +- src/interfaces/IObserver.ts | 2 +- src/interfaces/IProjection.ts | 6 +- src/interfaces/ISaga.ts | 9 +- src/interfaces/IViewLocker.ts | 10 +- src/rabbitmq/IContainer.ts | 4 +- src/rabbitmq/RabbitMqEventBus.ts | 4 +- src/rabbitmq/RabbitMqEventInjector.ts | 12 +- src/rabbitmq/RabbitMqGateway.ts | 5 +- src/sqlite/AbstractSqliteObjectProjection.ts | 8 +- src/sqlite/AbstractSqliteView.ts | 5 +- src/sqlite/SqliteEventLocker.ts | 3 +- src/sqlite/SqliteObjectView.ts | 2 +- src/sqlite/SqliteViewLocker.ts | 6 +- src/sqlite/commonParams.ts | 2 + src/sqlite/utils/getEventId.ts | 2 +- src/utils/getHandler.ts | 4 +- src/utils/setupOneTimeEmitterSubscription.ts | 8 +- src/utils/subscribe.ts | 4 +- src/utils/validateHandlers.ts | 3 +- .../rabbitmq/RabbitMqEventBus.test.ts | 8 +- .../rabbitmq/RabbitMqEventInjector.test.ts | 12 +- .../rabbitmq/RabbitMqGateway.test.ts | 9 +- tests/integration/sqlite/SqliteView.test.ts | 5 +- tests/unit/AbstractAggregate.test.ts | 18 +- tests/unit/AbstractProjection.test.ts | 9 +- tests/unit/AbstractSaga.test.ts | 2 +- tests/unit/AggregateCommandHandler.test.ts | 54 +- tests/unit/EventDispatcher.test.ts | 12 +- tests/unit/EventStore.test.ts | 16 +- tests/unit/SagaEventHandler.test.ts | 6 +- .../unit/memory/InMemoryEventStorage.test.ts | 23 +- tests/unit/memory/InMemoryLock.test.ts | 4 +- tests/unit/memory/InMemoryMessageBus.test.ts | 4 +- tests/unit/memory/InMemoryView.test.ts | 59 +- tests/unit/sqlite/SqliteEventLocker.test.ts | 6 +- tests/unit/sqlite/SqliteObjectStorage.test.ts | 8 +- tests/unit/sqlite/SqliteObjectView.test.ts | 2 +- tests/unit/sqlite/SqliteViewLocker.test.ts | 6 +- 78 files changed, 2375 insertions(+), 304 deletions(-) create mode 100644 eslint.config.mjs diff --git a/eslint.config.mjs b/eslint.config.mjs new file mode 100644 index 0000000..b000df0 --- /dev/null +++ b/eslint.config.mjs @@ -0,0 +1,837 @@ +import { defineConfig, globalIgnores } from "eslint/config"; +import tsParser from "@typescript-eslint/parser"; +import tsPlugin from "@typescript-eslint/eslint-plugin"; +import jestPlugin from 'eslint-plugin-jest'; +import globals from "globals"; + +export default defineConfig([ + globalIgnores([ + "coverage/*", + "dist/*" + ]), + { + files: [ + "**/*.ts" + ], + languageOptions: { + parser: tsParser, + globals: { + ...globals.node + } + }, + plugins: { + "@typescript-eslint": tsPlugin, + }, + "rules": { + "no-explicit-any": "off", + "no-unused-vars": "off", + "no-use-before-define": "warn", + "strict": "off", + "@typescript-eslint/no-unused-vars": [ + "warn", + { + "vars": "local", + "args": "after-used", + "ignoreRestSiblings": true, + "argsIgnorePattern": "^(_|err)" + } + ], + "@typescript-eslint/no-explicit-any": "off", + "@typescript-eslint/no-require-imports": "off", + "@typescript-eslint/no-empty-object-type": "off", + "padding-line-between-statements": [ + "warn", + { + "blankLine": "always", + "prev": "if", + "next": "return" + }, + { + "blankLine": "any", + "prev": "block-like", + "next": "return" + }, + { + "blankLine": "always", + "prev": "if", + "next": "const" + }, + { + "blankLine": "any", + "prev": "block-like", + "next": "const" + } + ], + "nonblock-statement-body-position": [ + "error", + "below" + ], + "accessor-pairs": "off", + "array-callback-return": "error", + "block-scoped-var": "error", + "complexity": [ + "off", + 11 + ], + "class-methods-use-this": "warn", + "consistent-return": "error", + "curly": [ + "error", + "multi-or-nest", + "consistent" + ], + "default-case": [ + "error", + { + "commentPattern": "^no default$" + } + ], + "dot-notation": [ + "error", + { + "allowKeywords": true + } + ], + "dot-location": [ + "error", + "property" + ], + "eqeqeq": [ + "error", + "allow-null" + ], + "guard-for-in": "error", + "no-alert": "error", + "no-caller": "error", + "no-case-declarations": "error", + "no-div-regex": "off", + "no-else-return": "off", + "no-empty-function": [ + "error", + { + "allow": [ + "arrowFunctions", + "methods", + "getters" + ] + } + ], + "no-empty-pattern": "error", + "no-eq-null": "off", + "no-eval": "error", + "no-extend-native": "error", + "no-extra-bind": "error", + "no-extra-label": "error", + "no-fallthrough": "error", + "no-floating-decimal": "error", + "no-global-assign": [ + "error", + { + "exceptions": [] + } + ], + "no-native-reassign": "off", + "no-implicit-coercion": [ + "off", + { + "boolean": false, + "number": true, + "string": true, + "allow": [] + } + ], + "no-implicit-globals": "off", + "no-implied-eval": "error", + "no-invalid-this": "off", + "no-iterator": "error", + "no-labels": [ + "error", + { + "allowLoop": false, + "allowSwitch": false + } + ], + "no-lone-blocks": "error", + "no-loop-func": "error", + "no-magic-numbers": [ + "off", + { + "ignore": [], + "ignoreArrayIndexes": true, + "enforceConst": true, + "detectObjects": false + } + ], + "no-multi-spaces": "error", + "no-multi-str": "error", + "no-new": "error", + "no-new-func": "error", + "no-new-wrappers": "error", + "no-octal": "error", + "no-octal-escape": "error", + "no-param-reassign": [ + "off", + { + "props": true + } + ], + "no-proto": "error", + "no-redeclare": "error", + "no-restricted-properties": [ + "error", + { + "object": "arguments", + "property": "callee", + "message": "arguments.callee is deprecated" + }, + { + "property": "__defineGetter__", + "message": "Please use Object.defineProperty instead." + }, + { + "property": "__defineSetter__", + "message": "Please use Object.defineProperty instead." + }, + { + "object": "Math", + "property": "pow", + "message": "Use the exponentiation operator (**) instead." + } + ], + "no-return-assign": "error", + "no-return-await": "error", + "no-script-url": "error", + "no-self-assign": "error", + "no-self-compare": "error", + "no-sequences": "error", + "no-throw-literal": "error", + "no-unmodified-loop-condition": "off", + "no-unused-expressions": "off", + "no-unused-labels": "error", + "no-useless-call": "off", + "no-useless-concat": "error", + "no-useless-escape": "error", + "no-useless-return": "error", + "no-void": "error", + "no-warning-comments": [ + "off", + { + "terms": [ + "todo", + "fixme", + "xxx" + ], + "location": "start" + } + ], + "no-with": "error", + "radix": "error", + "vars-on-top": "error", + "wrap-iife": [ + "error", + "outside", + { + "functionPrototypeMethods": false + } + ], + "yoda": "error", + "no-mixed-requires": "error", + "callback-return": "off", + "global-require": "error", + "handle-callback-err": "off", + "no-new-require": "error", + "no-path-concat": "error", + "no-process-env": "off", + "no-process-exit": "off", + "no-restricted-modules": "off", + "no-sync": "off", + "arrow-body-style": [ + "error", + "as-needed" + ], + "arrow-parens": [ + "error", + "as-needed" + ], + "arrow-spacing": [ + "error", + { + "before": true, + "after": true + } + ], + "constructor-super": "error", + "generator-star-spacing": [ + "error", + { + "before": false, + "after": true + } + ], + "no-class-assign": "error", + "no-confusing-arrow": [ + "error", + { + "allowParens": true + } + ], + "no-const-assign": "error", + "no-dupe-class-members": "error", + "no-duplicate-imports": "error", + "no-new-symbol": "error", + "no-restricted-imports": "off", + "no-this-before-super": "error", + "no-useless-computed-key": "error", + "no-useless-constructor": "error", + "no-useless-rename": [ + "error", + { + "ignoreDestructuring": false, + "ignoreImport": false, + "ignoreExport": false + } + ], + "no-var": "error", + "object-shorthand": [ + "error", + "always", + { + "ignoreConstructors": false, + "avoidQuotes": true + } + ], + "prefer-arrow-callback": "off", + "prefer-const": [ + "error", + { + "destructuring": "any", + "ignoreReadBeforeAssign": true + } + ], + "prefer-numeric-literals": "error", + "prefer-reflect": "off", + "prefer-rest-params": "error", + "prefer-spread": "error", + "prefer-template": "error", + "require-yield": "error", + "rest-spread-spacing": [ + "error", + "never" + ], + "sort-imports": [ + "off", + { + "ignoreCase": false, + "ignoreMemberSort": false, + "memberSyntaxSortOrder": [ + "none", + "all", + "multiple", + "single" + ] + } + ], + "symbol-description": "error", + "template-curly-spacing": "error", + "yield-star-spacing": [ + "error", + "after" + ], + "comma-dangle": [ + "error", + "never" + ], + "no-cond-assign": [ + "error", + "always" + ], + "no-console": "error", + "no-constant-condition": "error", + "no-control-regex": "error", + "no-debugger": "error", + "no-dupe-args": "error", + "no-dupe-keys": "error", + "no-duplicate-case": "error", + "no-empty": "error", + "no-empty-character-class": "error", + "no-ex-assign": "error", + "no-extra-boolean-cast": "error", + "no-extra-parens": [ + "off", + "all", + { + "conditionalAssign": true, + "nestedBinaryExpressions": false, + "returnAssign": false + } + ], + "no-extra-semi": "error", + "no-func-assign": "error", + "no-inner-declarations": "error", + "no-invalid-regexp": "error", + "no-irregular-whitespace": "error", + "no-obj-calls": "error", + "no-prototype-builtins": "error", + "no-regex-spaces": "error", + "no-sparse-arrays": "error", + "no-template-curly-in-string": "error", + "no-unexpected-multiline": "error", + "no-unsafe-finally": "error", + "no-unsafe-negation": "error", + "no-negated-in-lhs": "off", + "use-isnan": "error", + "valid-jsdoc": "off", + "valid-typeof": [ + "error", + { + "requireStringLiterals": true + } + ], + "array-bracket-spacing": [ + "error", + "never" + ], + "block-spacing": [ + "error", + "always" + ], + "brace-style": [ + "error", + "stroustrup", + { + "allowSingleLine": false + } + ], + "camelcase": [ + "error", + { + "properties": "never" + } + ], + "comma-spacing": [ + "error", + { + "before": false, + "after": true + } + ], + "comma-style": [ + "error", + "last" + ], + "computed-property-spacing": [ + "error", + "never" + ], + "consistent-this": "off", + "eol-last": [ + "error", + "always" + ], + "func-call-spacing": [ + "error", + "never" + ], + "func-name-matching": [ + "off", + "always", + { + "includeCommonJSModuleExports": false + } + ], + "func-style": [ + "off", + "expression" + ], + "id-blacklist": "off", + "id-length": "off", + "id-match": "off", + "indent": [ + "error", + "tab", + { + "SwitchCase": 1, + "VariableDeclarator": 1, + "outerIIFEBody": 1, + "FunctionDeclaration": { + "parameters": 1, + "body": 1 + }, + "FunctionExpression": { + "parameters": 1, + "body": 1 + } + } + ], + "jsx-quotes": [ + "off", + "prefer-double" + ], + "key-spacing": [ + "error", + { + "beforeColon": false, + "afterColon": true + } + ], + "keyword-spacing": [ + "error", + { + "before": true, + "after": true, + "overrides": { + "return": { + "after": true + }, + "throw": { + "after": true + }, + "case": { + "after": true + } + } + } + ], + "line-comment-position": [ + "off", + { + "position": "above", + "ignorePattern": "", + "applyDefaultPatterns": true + } + ], + "linebreak-style": [ + "error", + "unix" + ], + "lines-around-comment": [ + "error", + { + "beforeBlockComment": true, + "afterBlockComment": false, + "beforeLineComment": true, + "afterLineComment": false, + "allowBlockStart": true, + "allowObjectStart": true, + "allowArrayStart": true + } + ], + "lines-around-directive": [ + "error", + { + "before": "never", + "after": "always" + } + ], + "max-depth": [ + "off", + 4 + ], + "max-len": [ + "warn", + 120, + 4, + { + "ignoreUrls": true, + "ignoreComments": false, + "ignoreRegExpLiterals": true, + "ignoreStrings": true, + "ignoreTemplateLiterals": true + } + ], + "max-lines": [ + "off", + { + "max": 300, + "skipBlankLines": true, + "skipComments": true + } + ], + "max-nested-callbacks": "off", + "max-params": [ + "warn", + 5 + ], + "max-statements": [ + "off", + 10 + ], + "max-statements-per-line": [ + "off", + { + "max": 1 + } + ], + "multiline-ternary": [ + "off", + "never" + ], + "new-cap": [ + "error", + { + "newIsCap": true, + "newIsCapExceptions": [], + "capIsNew": false, + "capIsNewExceptions": [ + "Immutable.Map", + "Immutable.Set", + "Immutable.List" + ] + } + ], + "new-parens": "error", + "newline-after-var": "off", + "newline-before-return": "off", + "newline-per-chained-call": [ + "error", + { + "ignoreChainWithDepth": 4 + } + ], + "no-array-constructor": "error", + "no-bitwise": "error", + "no-continue": "off", + "no-inline-comments": "off", + "no-lonely-if": "error", + "no-mixed-operators": [ + "error", + { + "groups": [ + [ + "+", + "-", + "*", + "/", + "%", + "**" + ], + [ + "&", + "|", + "^", + "~", + "<<", + ">>", + ">>>" + ], + [ + "==", + "!=", + "===", + "!==", + ">", + ">=", + "<", + "<=" + ], + [ + "&&", + "||" + ], + [ + "in", + "instanceof" + ] + ], + "allowSamePrecedence": true + } + ], + "no-mixed-spaces-and-tabs": "error", + "no-multiple-empty-lines": [ + "error", + { + "max": 2, + "maxEOF": 1 + } + ], + "no-negated-condition": "off", + "no-nested-ternary": "error", + "no-new-object": "error", + "no-restricted-syntax": [ + "error", + "ForInStatement", + "LabeledStatement", + "WithStatement" + ], + "no-spaced-func": "error", + "no-ternary": "off", + "no-trailing-spaces": "error", + "no-underscore-dangle": [ + "off", + { + "allowAfterThis": true + } + ], + "no-unneeded-ternary": [ + "error", + { + "defaultAssignment": false + } + ], + "no-whitespace-before-property": "error", + "object-curly-spacing": [ + "error", + "always" + ], + "object-curly-newline": [ + "off", + { + "ObjectExpression": { + "minProperties": 0, + "multiline": true + }, + "ObjectPattern": { + "minProperties": 0, + "multiline": true + } + } + ], + "object-property-newline": [ + "error", + { + "allowMultiplePropertiesPerLine": true + } + ], + "one-var": [ + "error", + "never" + ], + "one-var-declaration-per-line": [ + "error", + "always" + ], + "operator-assignment": [ + "error", + "always" + ], + "operator-linebreak": "off", + "padded-blocks": [ + "off", + "never" + ], + "quote-props": [ + "error", + "as-needed", + { + "keywords": false, + "unnecessary": true, + "numbers": false + } + ], + "quotes": [ + "error", + "single", + { + "avoidEscape": true + } + ], + "require-jsdoc": "off", + "semi": [ + "error", + "always" + ], + "semi-spacing": [ + "error", + { + "before": false, + "after": true + } + ], + "sort-keys": [ + "off", + "asc", + { + "caseSensitive": false, + "natural": true + } + ], + "sort-vars": "off", + "space-before-blocks": "error", + "space-before-function-paren": [ + "error", + { + "anonymous": "always", + "named": "never", + "asyncArrow": "always" + } + ], + "space-in-parens": [ + "error", + "never" + ], + "space-infix-ops": "error", + "space-unary-ops": [ + "error", + { + "words": true, + "nonwords": false, + "overrides": {} + } + ], + "spaced-comment": [ + "error", + "always", + { + "line": { + "exceptions": [ + "-", + "+" + ], + "markers": [ + "/", + "=", + "!" + ] + }, + "block": { + "exceptions": [ + "-", + "+" + ], + "markers": [ + "=", + "!" + ], + "balanced": false + } + } + ], + "unicode-bom": [ + "error", + "never" + ], + "wrap-regex": "off", + "init-declarations": "off", + "no-catch-shadow": "off", + "no-delete-var": "error", + "no-label-var": "error", + "no-restricted-globals": "off", + "no-shadow": "error", + "no-shadow-restricted-names": "error", + "no-undef": "error", + "no-undef-init": "error", + "no-undefined": "off" + } + }, { + files: [ + 'tests/**/*.ts' + ], + plugins: { + jest: jestPlugin, + }, + languageOptions: { + globals: jestPlugin.environments.globals.globals, + }, + rules: { + 'jest/no-disabled-tests': 'warn', + 'jest/no-focused-tests': 'error', + 'jest/no-identical-title': 'error', + 'jest/prefer-to-have-length': 'warn', + 'jest/valid-expect': 'error', + 'class-methods-use-this': 'off', + 'no-loop-func': 'off', + 'no-return-assign': 'off', + 'no-console': 'off' + } + } +]); diff --git a/jest.config.ts b/jest.config.ts index 5b1e81b..469c8e1 100644 --- a/jest.config.ts +++ b/jest.config.ts @@ -9,20 +9,20 @@ export default { // An array of glob patterns indicating a set of files for which coverage information should be collected collectCoverageFrom: [ - "src/**/*.ts", // Only collect coverage from TypeScript source - "!src/**/*.d.ts", // Ignore TypeScript type declaration files + 'src/**/*.ts', // Only collect coverage from TypeScript source + '!src/**/*.d.ts' // Ignore TypeScript type declaration files ], // The directory where Jest should output its coverage files - coverageDirectory: "coverage", + coverageDirectory: 'coverage', // An array of regexp pattern strings used to skip coverage collection coveragePathIgnorePatterns: [ - "/dist/", - "/examples/", - "/node_modules/", - "/src/rabbitmq/", - "/tests/" + '/dist/', + '/examples/', + '/node_modules/', + '/src/rabbitmq/', + '/tests/' ], // Indicates which provider should be used to instrument code for coverage @@ -33,7 +33,7 @@ export default { }, // The test environment that will be used for testing - testEnvironment: "node", + testEnvironment: 'node', // A map from regular expressions to paths to transformers transform: { diff --git a/package-lock.json b/package-lock.json index 723858f..dcbe83c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,6 +14,7 @@ "di0": "^1.0.0" }, "devDependencies": { + "@stylistic/eslint-plugin-ts": "^4.2.0", "@types/amqplib": "^0.10.7", "@types/better-sqlite3": "^7.6.11", "@types/chai": "^4.3.20", @@ -21,13 +22,18 @@ "@types/md5": "^2.3.5", "@types/node": "^20.16.9", "@types/sinon": "^17.0.4", + "@typescript-eslint/eslint-plugin": "^8.29.0", + "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", + "eslint": "^9.24.0", + "eslint-plugin-jest": "^28.11.0", "jest": "^29.7.0", "sinon": "^19.0.2", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.6.2" + "typescript": "^5.6.2", + "typescript-eslint": "^8.29.0" }, "engines": { "node": ">=10.3.0" @@ -601,6 +607,256 @@ "@jridgewell/sourcemap-codec": "^1.4.10" } }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.5.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.5.1.tgz", + "integrity": "sha512-soEIOALTfTK6EjmKMMoLugwaP0rzkad90iIWd1hMO9ARkSAyjfMfkRRhLvD5qH7vvM0Cg72pieUfR6yh6XxC4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.1", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.1.tgz", + "integrity": "sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/config-array": { + "version": "0.20.0", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.20.0.tgz", + "integrity": "sha512-fxlS1kkIjx8+vy2SjuCB94q3htSNrufYTXubwiBFeaQHbH6Ipi43gFJq2zCMt6PHhImH3Xmr0NksKDvchWlpQQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/object-schema": "^2.1.6", + "debug": "^4.3.1", + "minimatch": "^3.1.2" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/config-helpers": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.2.1.tgz", + "integrity": "sha512-RI17tsD2frtDu/3dmI7QRrD4bedNKPM08ziRYaC5AhkGrzIAJelm9kJU1TznK+apx6V+cqRz8tfpEeG3oIyjxw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/core": { + "version": "0.12.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.12.0.tgz", + "integrity": "sha512-cmrR6pytBuSMTaBweKoGMwu3EiHiEC+DoyupPmlZ0HxBJBtIxwe+j/E4XPIKNx+Q74c8lXKPwYawBf5glsTkHg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz", + "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^10.0.1", + "globals": "^14.0.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.0", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/eslintrc/node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/@eslint/eslintrc/node_modules/globals": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", + "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@eslint/eslintrc/node_modules/js-yaml": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", + "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/@eslint/js": { + "version": "9.24.0", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.24.0.tgz", + "integrity": "sha512-uIY/y3z0uvOGX8cp1C2fiC4+ZmBhp6yZWkojtHL1YEMnRt1Y63HB9TM17proGEmeG7HeUY+UP36F0aknKYTpYA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/object-schema": { + "version": "2.1.6", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.6.tgz", + "integrity": "sha512-RBMg5FRL0I0gs51M/guSAj5/e14VQ4tpZnQNWwuDT66P14I43ItmPfIZRhO9fUVIPOAQXU47atlywZ/czoqFPA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/plugin-kit": { + "version": "0.2.8", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.2.8.tgz", + "integrity": "sha512-ZAoA40rNMPwSm+AeHpCq8STiNAwzWLJuP8Xv4CHIc9wv/PSuExjMrmjfYNj682vW0OOiZ1HKxzvjQr9XZIisQA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.13.0", + "levn": "^0.4.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@eslint/plugin-kit/node_modules/@eslint/core": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.13.0.tgz", + "integrity": "sha512-yfkgDw1KR66rkT5A8ci4irzDysN7FRpq3ttJolR88OqQikAWqwA8j5VZyas+vjyBNFIJ7MfybJ9plMILI2UrCw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + } + }, + "node_modules/@humanfs/core": { + "version": "0.19.1", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", + "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node": { + "version": "0.16.6", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.6.tgz", + "integrity": "sha512-YuI2ZHQL78Q5HbhDiBA1X4LmYdXCKCMQIfw0pw7piHJwyREFebJUvrQN4cMssyES6x+vfUbx1CIpaQUKYdQZOw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/core": "^0.19.1", + "@humanwhocodes/retry": "^0.3.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node/node_modules/@humanwhocodes/retry": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.3.1.tgz", + "integrity": "sha512-JBxkERygn7Bv/GbN5Rv8Ul6LVknS+5Bp6RgDC/O8gEBU/yeH5Ui5C/OlWrTb6qct7LjjfT6Re2NxB0ln0yYybA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/retry": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.2.tgz", + "integrity": "sha512-xeO57FpIu4p1Ri3Jq/EXq4ClRm86dVF2z/+kvFnyqVYRavTZmaFaUBbWCOuuTh0o/g7DSsk6kc2vrS4Vl5oPOQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, "node_modules/@hutson/parse-repository-url": { "version": "3.0.2", "resolved": "https://registry.npmjs.org/@hutson/parse-repository-url/-/parse-repository-url-3.0.2.tgz", @@ -983,6 +1239,44 @@ "@jridgewell/sourcemap-codec": "^1.4.14" } }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, "node_modules/@sinclair/typebox": { "version": "0.27.8", "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", @@ -1039,6 +1333,24 @@ "dev": true, "license": "(Unlicense OR Apache-2.0)" }, + "node_modules/@stylistic/eslint-plugin-ts": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin-ts/-/eslint-plugin-ts-4.2.0.tgz", + "integrity": "sha512-j2o2GvOx9v66x8hmp/HJ+0T+nOppiO5ycGsCkifh7JPGgjxEhpkGmIGx3RWsoxpWbad3VCX8e8/T8n3+7ze1Zg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/utils": "^8.23.0", + "eslint-visitor-keys": "^4.2.0", + "espree": "^10.3.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "peerDependencies": { + "eslint": ">=9.0.0" + } + }, "node_modules/@tsconfig/node10": { "version": "1.0.11", "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz", @@ -1139,6 +1451,13 @@ "dev": true, "license": "MIT" }, + "node_modules/@types/estree": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz", + "integrity": "sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/graceful-fs": { "version": "4.1.9", "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz", @@ -1187,6 +1506,13 @@ "pretty-format": "^29.0.0" } }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/md5": { "version": "2.3.5", "resolved": "https://registry.npmjs.org/@types/md5/-/md5-2.3.5.tgz", @@ -1259,6 +1585,225 @@ "dev": true, "license": "MIT" }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.29.0.tgz", + "integrity": "sha512-PAIpk/U7NIS6H7TEtN45SPGLQaHNgB7wSjsQV/8+KYokAb2T/gloOA/Bee2yd4/yKVhPKe5LlaUGhAZk5zmSaQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.10.0", + "@typescript-eslint/scope-manager": "8.29.0", + "@typescript-eslint/type-utils": "8.29.0", + "@typescript-eslint/utils": "8.29.0", + "@typescript-eslint/visitor-keys": "8.29.0", + "graphemer": "^1.4.0", + "ignore": "^5.3.1", + "natural-compare": "^1.4.0", + "ts-api-utils": "^2.0.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^8.0.0 || ^8.0.0-alpha.0", + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <5.9.0" + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.29.0.tgz", + "integrity": "sha512-8C0+jlNJOwQso2GapCVWWfW/rzaq7Lbme+vGUFKE31djwNncIpgXD7Cd4weEsDdkoZDjH0lwwr3QDQFuyrMg9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/scope-manager": "8.29.0", + "@typescript-eslint/types": "8.29.0", + "@typescript-eslint/typescript-estree": "8.29.0", + "@typescript-eslint/visitor-keys": "8.29.0", + "debug": "^4.3.4" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <5.9.0" + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.29.0.tgz", + "integrity": "sha512-aO1PVsq7Gm+tcghabUpzEnVSFMCU4/nYIgC2GOatJcllvWfnhrgW0ZEbnTxm36QsikmCN1K/6ZgM7fok2I7xNw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.29.0", + "@typescript-eslint/visitor-keys": "8.29.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.29.0.tgz", + "integrity": "sha512-ahaWQ42JAOx+NKEf5++WC/ua17q5l+j1GFrbbpVKzFL/tKVc0aYY8rVSYUpUvt2hUP1YBr7mwXzx+E/DfUWI9Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/typescript-estree": "8.29.0", + "@typescript-eslint/utils": "8.29.0", + "debug": "^4.3.4", + "ts-api-utils": "^2.0.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <5.9.0" + } + }, + "node_modules/@typescript-eslint/types": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.29.0.tgz", + "integrity": "sha512-wcJL/+cOXV+RE3gjCyl/V2G877+2faqvlgtso/ZRbTCnZazh0gXhe+7gbAnfubzN2bNsBtZjDvlh7ero8uIbzg==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.29.0.tgz", + "integrity": "sha512-yOfen3jE9ISZR/hHpU/bmNvTtBW1NjRbkSFdZOksL1N+ybPEE7UVGMwqvS6CP022Rp00Sb0tdiIkhSCe6NI8ow==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.29.0", + "@typescript-eslint/visitor-keys": "8.29.0", + "debug": "^4.3.4", + "fast-glob": "^3.3.2", + "is-glob": "^4.0.3", + "minimatch": "^9.0.4", + "semver": "^7.6.0", + "ts-api-utils": "^2.0.1" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <5.9.0" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", + "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": { + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.29.0.tgz", + "integrity": "sha512-gX/A0Mz9Bskm8avSWFcK0gP7cZpbY4AIo6B0hWYFCaIsz750oaiWR4Jr2CI+PQhfW1CpcQr9OlfPS+kMFegjXA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.4.0", + "@typescript-eslint/scope-manager": "8.29.0", + "@typescript-eslint/types": "8.29.0", + "@typescript-eslint/typescript-estree": "8.29.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <5.9.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.29.0.tgz", + "integrity": "sha512-Sne/pVz8ryR03NFK21VpN88dZ2FdQXOlq3VIklbrTYEt8yXtRFr9tvUhqvCeKjqYk5FSim37sHbooT6vzBTZcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "8.29.0", + "eslint-visitor-keys": "^4.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, "node_modules/acorn": { "version": "8.14.1", "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.1.tgz", @@ -1272,6 +1817,16 @@ "node": ">=0.4.0" } }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, "node_modules/acorn-walk": { "version": "8.3.4", "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz", @@ -1292,6 +1847,23 @@ "dev": true, "license": "MIT" }, + "node_modules/ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, "node_modules/amqplib": { "version": "0.10.5", "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.5.tgz", @@ -2384,6 +2956,13 @@ "node": ">=4.0.0" } }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, "node_modules/deepmerge": { "version": "4.3.1", "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", @@ -2536,18 +3115,261 @@ "node": ">=8" } }, + "node_modules/eslint": { + "version": "9.24.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.24.0.tgz", + "integrity": "sha512-eh/jxIEJyZrvbWRe4XuVclLPDYSYYYgLy5zXGGxD6j8zjSAxFEzI2fL/8xNq6O2yKqVt+eF2YhV+hxjV6UKXwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.2.0", + "@eslint-community/regexpp": "^4.12.1", + "@eslint/config-array": "^0.20.0", + "@eslint/config-helpers": "^0.2.0", + "@eslint/core": "^0.12.0", + "@eslint/eslintrc": "^3.3.1", + "@eslint/js": "9.24.0", + "@eslint/plugin-kit": "^0.2.7", + "@humanfs/node": "^0.16.6", + "@humanwhocodes/module-importer": "^1.0.1", + "@humanwhocodes/retry": "^0.4.2", + "@types/estree": "^1.0.6", + "@types/json-schema": "^7.0.15", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.6", + "debug": "^4.3.2", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^8.3.0", + "eslint-visitor-keys": "^4.2.0", + "espree": "^10.3.0", + "esquery": "^1.5.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^8.0.0", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" + }, + "peerDependencies": { + "jiti": "*" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + } + } + }, + "node_modules/eslint-plugin-jest": { + "version": "28.11.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-jest/-/eslint-plugin-jest-28.11.0.tgz", + "integrity": "sha512-QAfipLcNCWLVocVbZW8GimKn5p5iiMcgGbRzz8z/P5q7xw+cNEpYqyzFMtIF/ZgF2HLOyy+dYBut+DoYolvqig==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/utils": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "engines": { + "node": "^16.10.0 || ^18.12.0 || >=20.0.0" + }, + "peerDependencies": { + "@typescript-eslint/eslint-plugin": "^6.0.0 || ^7.0.0 || ^8.0.0", + "eslint": "^7.0.0 || ^8.0.0 || ^9.0.0", + "jest": "*" + }, + "peerDependenciesMeta": { + "@typescript-eslint/eslint-plugin": { + "optional": true + }, + "jest": { + "optional": true + } + } + }, + "node_modules/eslint-scope": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.3.0.tgz", + "integrity": "sha512-pUNxi75F8MJ/GdeKtVLSbYg4ZI34J6C0C7sbL4YOp2exGwen7ZsuBqKzUhXd0qMQ362yET3z+uPwKeg/0C2XCQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.0.tgz", + "integrity": "sha512-UyLnSehNt62FFhSwjZlHmeokpRK59rcz29j+F1/aDgbkbRTk7wIc9XzdoasMUbRNKDM0qQt/+BJ4BrpFeABemw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint/node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint/node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint/node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint/node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/espree": { + "version": "10.3.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.3.0.tgz", + "integrity": "sha512-0QYC8b24HWY8zjRnDTL6RiHfDbAWn63qb4LMj1Z4b076A4une81+z03Kg7l7mn/48PUTqoLptSXez8oknU8Clg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.14.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^4.2.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, "node_modules/esprima": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", "dev": true, "license": "BSD-2-Clause", - "bin": { - "esparse": "bin/esparse.js", - "esvalidate": "bin/esvalidate.js" - }, + "bin": { + "esparse": "bin/esparse.js", + "esvalidate": "bin/esvalidate.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", "engines": { - "node": ">=4" + "node": ">=0.10.0" } }, "node_modules/execa": { @@ -2610,6 +3432,43 @@ "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-glob/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, "node_modules/fast-json-stable-stringify": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", @@ -2617,6 +3476,23 @@ "dev": true, "license": "MIT" }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fastq": { + "version": "1.19.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz", + "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, "node_modules/fb-watchman": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz", @@ -2627,6 +3503,19 @@ "bser": "2.1.1" } }, + "node_modules/file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^4.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, "node_modules/file-uri-to-path": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", @@ -2694,6 +3583,27 @@ "node": ">=8" } }, + "node_modules/flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.4" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "dev": true, + "license": "ISC" + }, "node_modules/fs-constants": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", @@ -2939,6 +3849,19 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, "node_modules/globals": { "version": "11.12.0", "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", @@ -2956,6 +3879,13 @@ "dev": true, "license": "ISC" }, + "node_modules/graphemer": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz", + "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", + "dev": true, + "license": "MIT" + }, "node_modules/handlebars": { "version": "4.7.8", "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", @@ -3062,6 +3992,43 @@ "license": "BSD-3-Clause", "peer": true }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-fresh/node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, "node_modules/import-local": { "version": "3.2.0", "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz", @@ -3156,6 +4123,16 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/is-fullwidth-code-point": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", @@ -3176,6 +4153,19 @@ "node": ">=6" } }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/is-number": { "version": "7.0.0", "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", @@ -4023,6 +5013,13 @@ "node": ">=6" } }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, "node_modules/json-parse-better-errors": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz", @@ -4037,6 +5034,20 @@ "dev": true, "license": "MIT" }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, "node_modules/json-stringify-safe": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz", @@ -4091,6 +5102,16 @@ "dev": true, "license": "MIT" }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, "node_modules/kind-of": { "version": "6.0.3", "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz", @@ -4121,6 +5142,20 @@ "node": ">=6" } }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, "node_modules/lines-and-columns": { "version": "1.2.4", "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", @@ -4220,6 +5255,13 @@ "dev": true, "license": "MIT" }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, "node_modules/loupe": { "version": "2.3.7", "resolved": "https://registry.npmjs.org/loupe/-/loupe-2.3.7.tgz", @@ -4444,6 +5486,16 @@ "dev": true, "license": "MIT" }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, "node_modules/micromatch": { "version": "4.0.8", "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", @@ -4713,6 +5765,24 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, "node_modules/p-limit": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", @@ -4768,6 +5838,19 @@ "node": ">=6" } }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, "node_modules/parse-json": { "version": "5.2.0", "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", @@ -4947,6 +6030,16 @@ "node": ">=10" } }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, "node_modules/pretty-format": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", @@ -5007,6 +6100,16 @@ "once": "^1.3.1" } }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/pure-rand": { "version": "6.1.0", "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz", @@ -5043,6 +6146,27 @@ "license": "MIT", "peer": true }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, "node_modules/quick-lru": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/quick-lru/-/quick-lru-4.0.1.tgz", @@ -5317,6 +6441,41 @@ "node": ">=10" } }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, "node_modules/safe-buffer": { "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", @@ -5795,6 +6954,19 @@ "node": ">=8" } }, + "node_modules/ts-api-utils": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.1.0.tgz", + "integrity": "sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18.12" + }, + "peerDependencies": { + "typescript": ">=4.8.4" + } + }, "node_modules/ts-jest": { "version": "29.2.6", "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.2.6.tgz", @@ -5934,6 +7106,19 @@ "node": "*" } }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, "node_modules/type-detect": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.1.0.tgz", @@ -5971,6 +7156,29 @@ "node": ">=14.17" } }, + "node_modules/typescript-eslint": { + "version": "8.29.0", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.29.0.tgz", + "integrity": "sha512-ep9rVd9B4kQsZ7ZnWCVxUE/xDLUUUsRzE0poAeNu+4CkFErLfuvPt/qtm2EpnSyfvsR0S6QzDFSrPCFBwf64fg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/eslint-plugin": "8.29.0", + "@typescript-eslint/parser": "8.29.0", + "@typescript-eslint/utils": "8.29.0" + }, + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <5.9.0" + } + }, "node_modules/uglify-js": { "version": "3.19.3", "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", @@ -6023,6 +7231,16 @@ "browserslist": ">= 4.21.0" } }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, "node_modules/url-parse": { "version": "1.5.10", "resolved": "https://registry.npmjs.org/url-parse/-/url-parse-1.5.10.tgz", @@ -6099,6 +7317,16 @@ "node": ">= 8" } }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/wordwrap": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", diff --git a/package.json b/package.json index 07a4600..dbb6319 100644 --- a/package.json +++ b/package.json @@ -58,7 +58,8 @@ "build": "tsc --build", "prepare": "npm run build", "preversion": "npm test", - "version": "npm run changelog && git add CHANGELOG.md" + "version": "npm run changelog && git add CHANGELOG.md", + "lint": "eslint" }, "author": "@snatalenko", "license": "MIT", @@ -69,6 +70,7 @@ "di0": "^1.0.0" }, "devDependencies": { + "@stylistic/eslint-plugin-ts": "^4.2.0", "@types/amqplib": "^0.10.7", "@types/better-sqlite3": "^7.6.11", "@types/chai": "^4.3.20", @@ -76,17 +78,22 @@ "@types/md5": "^2.3.5", "@types/node": "^20.16.9", "@types/sinon": "^17.0.4", + "@typescript-eslint/eslint-plugin": "^8.29.0", + "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", + "eslint": "^9.24.0", + "eslint-plugin-jest": "^28.11.0", "jest": "^29.7.0", "sinon": "^19.0.2", "ts-jest": "^29.2.5", "ts-node": "^10.9.2", - "typescript": "^5.6.2" + "typescript": "^5.6.2", + "typescript-eslint": "^8.29.0" }, "peerDependencies": { "amqplib": "^0.10.5", "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } -} \ No newline at end of file +} diff --git a/scripts/changelog/index.js b/scripts/changelog/index.js index 887d0f0..1028fe2 100644 --- a/scripts/changelog/index.js +++ b/scripts/changelog/index.js @@ -19,7 +19,7 @@ const TITLES = [ function transform(commit) { if (known[commit.hash]) - // eslint-disable-next-line no-param-reassign + commit = { ...commit, ...known[commit.hash] }; if (!commit.tag) return undefined; diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 3d87b08..1c3fdff 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -6,7 +6,7 @@ import { IEvent, IEventSet, IAggregateConstructorParams -} from "./interfaces"; +} from './interfaces'; import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils'; @@ -74,6 +74,7 @@ export abstract class AbstractAggregate = { + /** * The default view associated with the projection. * Can optionally implement IViewLocker and/or IEventLocker. diff --git a/src/AbstractSaga.ts b/src/AbstractSaga.ts index 972516d..fa08b72 100644 --- a/src/AbstractSaga.ts +++ b/src/AbstractSaga.ts @@ -1,4 +1,4 @@ -import { ICommand, Identifier, IEvent, ISaga, ISagaConstructorParams } from "./interfaces"; +import { ICommand, Identifier, IEvent, ISaga, ISagaConstructorParams } from './interfaces'; import { getClassName, validateHandlers, getHandler } from './utils'; @@ -97,7 +97,7 @@ export abstract class AbstractSaga implements ISaga { } /** Put a command to the execution queue */ - protected enqueueRaw(command: ICommand) { + protected enqueueRaw(command: ICommand) { if (typeof command !== 'object' || !command) throw new TypeError('command argument must be an Object'); if (typeof command.type !== 'string' || !command.type.length) @@ -107,7 +107,7 @@ export abstract class AbstractSaga implements ISaga { } /** Clear the execution queue */ - resetUncommittedMessages() { + resetUncommittedMessages() { this.#messages.length = 0; } diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index f15d402..e404a52 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -9,9 +9,8 @@ import { Identifier, IEventSet, IEventStore, - IExtendableLogger, ILogger -} from "./interfaces"; +} from './interfaces'; import { iteratorToArray, @@ -104,8 +103,10 @@ export class AggregateCommandHandler implements ICommandHandler { /** Pass a command to corresponding aggregate */ async execute(cmd: ICommand): Promise { - if (!cmd) throw new TypeError('cmd argument required'); - if (!cmd.type) throw new TypeError('cmd.type argument required'); + if (!cmd) + throw new TypeError('cmd argument required'); + if (!cmd.type) + throw new TypeError('cmd.type argument required'); const aggregate = cmd.aggregateId ? await this.#restoreAggregate(cmd.aggregateId) : diff --git a/src/CommandBus.ts b/src/CommandBus.ts index cf212b0..0a2104d 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -1,4 +1,4 @@ -import { InMemoryMessageBus } from "./in-memory"; +import { InMemoryMessageBus } from './in-memory'; import { ICommand, ICommandBus, @@ -7,7 +7,7 @@ import { ILogger, IMessageBus, IMessageHandler -} from "./interfaces"; +} from './interfaces'; export class CommandBus implements ICommandBus { @@ -52,7 +52,12 @@ export class CommandBus implements ICommandBus { /** * Format and send a command for execution */ - send(type: string, aggregateId: string, options: { payload: TPayload, context: object }, ...otherArgs: object[]): Promise { + send( + type: string, + aggregateId: string, + options: { payload: TPayload, context: object }, + ...otherArgs: object[] + ): Promise { if (typeof type !== 'string' || !type.length) throw new TypeError('type argument must be a non-empty String'); if (options && typeof options !== 'object') diff --git a/src/Event.ts b/src/Event.ts index 0dea892..ab2abc8 100644 --- a/src/Event.ts +++ b/src/Event.ts @@ -1,4 +1,4 @@ -import { IEvent } from "./interfaces"; +import { IEvent } from './interfaces'; /** * Get text description of an event for logging purposes diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 10c1fdb..ceeb6b2 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -7,11 +7,11 @@ import { IEventBus, isEventSet, IContainer -} from "./interfaces"; +} from './interfaces'; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; -import { notEmpty } from "./utils"; -import { InMemoryMessageBus } from "./in-memory"; +import { notEmpty } from './utils'; +import { InMemoryMessageBus } from './in-memory'; type EventBatchEnvelope = { data: EventBatch<{ event?: IEvent }>; @@ -28,7 +28,7 @@ export class EventDispatcher implements IEventDispatcher { /** * Event bus where dispatched messages are delivered after processing. - * + * * If not provided in the constructor, defaults to an instance of `InMemoryMessageBus`. */ eventBus: IEventBus; @@ -105,9 +105,9 @@ export class EventDispatcher implements IEventDispatcher { const events = data.map(e => e.event).filter(notEmpty); try { - for (const event of events) { + for (const event of events) this.eventBus.publish(event); - } + resolve(events); } catch (publishError: any) { diff --git a/src/EventStore.ts b/src/EventStore.ts index 7f269a1..5a1e1e5 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -18,12 +18,12 @@ import { isIEventBus, isIEventStorageReader, IContainer -} from "./interfaces"; +} from './interfaces'; import { getClassName, setupOneTimeEmitterSubscription -} from "./utils"; -import { EventDispatcher } from "./EventDispatcher"; +} from './utils'; +import { EventDispatcher } from './EventDispatcher'; export class EventStore implements IEventStore { @@ -41,7 +41,7 @@ export class EventStore implements IEventStore { snapshotStorage, eventBus, eventDispatcher, - logger, + logger }: Pick e.aggregateId == aggregateId) : + this.#events.filter(e => e.aggregateId === aggregateId) : this.#events.filter(e => - e.aggregateId == aggregateId && + e.aggregateId === aggregateId && e.aggregateVersion !== undefined && e.aggregateVersion > afterVersion); @@ -49,11 +49,11 @@ export class InMemoryEventStorage implements IEventStorageReader, IEventStorageW yield* results; } - async *getSagaEvents(sagaId: Identifier, { beforeEvent }: { beforeEvent: IEvent }): IEventStream { + async* getSagaEvents(sagaId: Identifier, { beforeEvent }: { beforeEvent: IEvent }): IEventStream { await nextCycle(); const results = this.#events.filter(e => - e.sagaId == sagaId && + e.sagaId === sagaId && e.sagaVersion !== undefined && beforeEvent.sagaVersion !== undefined && e.sagaVersion < beforeEvent.sagaVersion); diff --git a/src/in-memory/InMemoryLock.ts b/src/in-memory/InMemoryLock.ts index a8f2192..84456bd 100644 --- a/src/in-memory/InMemoryLock.ts +++ b/src/in-memory/InMemoryLock.ts @@ -1,4 +1,4 @@ -import { Deferred } from "./utils"; +import { Deferred } from './utils'; export class InMemoryLock { diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index 3a0bc54..69b8af6 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -4,7 +4,7 @@ import { IMessageBus, IMessageHandler, IObservable -} from "../interfaces"; +} from '../interfaces'; /** * Default implementation of the message bus. @@ -15,6 +15,7 @@ export class InMemoryMessageBus implements IMessageBus { #handlers: Map> = new Map(); #name: string | undefined; #uniqueEventHandlers: boolean; + // eslint-disable-next-line no-use-before-define #queues: Map = new Map(); constructor({ name, uniqueEventHandlers = !!name }: { @@ -38,8 +39,8 @@ export class InMemoryMessageBus implements IMessageBus { // Events published to a named queue must be consumed only once. // For example, for sending a welcome email, NotificationReceptor will subscribe to "notifications:userCreated". - // Since we use an in-memory bus, there is no need to track message handling by multiple distributed subscribers, - // and we only need to make sure that no more than 1 such subscriber will be created + // Since we use an in-memory bus, there is no need to track message handling by multiple distributed + // subscribers, and we only need to make sure that no more than 1 such subscriber will be created if (!this.#handlers.has(messageType)) this.#handlers.set(messageType, new Set()); else if (this.#uniqueEventHandlers) diff --git a/src/in-memory/InMemorySnapshotStorage.ts b/src/in-memory/InMemorySnapshotStorage.ts index 5ac8183..3fb4947 100644 --- a/src/in-memory/InMemorySnapshotStorage.ts +++ b/src/in-memory/InMemorySnapshotStorage.ts @@ -1,4 +1,4 @@ -import { IAggregateSnapshotStorage, Identifier, IEvent } from "../interfaces"; +import { IAggregateSnapshotStorage, Identifier, IEvent } from '../interfaces'; /** * In-memory storage for aggregate snapshots. diff --git a/src/in-memory/InMemoryView.ts b/src/in-memory/InMemoryView.ts index 4ef35ae..6e2f429 100644 --- a/src/in-memory/InMemoryView.ts +++ b/src/in-memory/InMemoryView.ts @@ -1,5 +1,5 @@ import { InMemoryLock } from './InMemoryLock'; -import { IViewLocker, Identifier, IObjectStorage } from "../interfaces"; +import { IViewLocker, Identifier, IObjectStorage } from '../interfaces'; import { nextCycle } from './utils'; /** diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts index 97aef7d..8dcc883 100644 --- a/src/interfaces/IAggregate.ts +++ b/src/interfaces/IAggregate.ts @@ -1,7 +1,7 @@ -import { ICommand } from "./ICommand"; -import { Identifier } from "./Identifier"; -import { IEvent } from "./IEvent"; -import { IEventSet } from "./IEventSet"; +import { ICommand } from './ICommand'; +import { Identifier } from './Identifier'; +import { IEvent } from './IEvent'; +import { IEventSet } from './IEventSet'; /** * Minimum aggregate interface, as it's used by default `AggregateCommandHandler` @@ -25,6 +25,7 @@ export interface IAggregate { } export interface IMutableAggregateState { + // schemaVersion?: number; // constructor: IAggregateStateConstructor; mutate(event: IEvent): void; @@ -36,6 +37,7 @@ export interface IMutableAggregateState { // } export type IAggregateConstructorParams = { + /** Unique aggregate identifier */ id: Identifier, diff --git a/src/interfaces/IAggregateSnapshotStorage.ts b/src/interfaces/IAggregateSnapshotStorage.ts index e938b4c..1fb937a 100644 --- a/src/interfaces/IAggregateSnapshotStorage.ts +++ b/src/interfaces/IAggregateSnapshotStorage.ts @@ -1,8 +1,9 @@ -import { Identifier } from "./Identifier"; -import { IEvent } from "./IEvent"; +import { Identifier } from './Identifier'; +import { IEvent } from './IEvent'; export interface IAggregateSnapshotStorage { - getAggregateSnapshot(aggregateId: Identifier): Promise | undefined> | IEvent | undefined; + getAggregateSnapshot(aggregateId: Identifier): + Promise | undefined> | IEvent | undefined; saveAggregateSnapshot(snapshotEvent: IEvent): Promise | void; diff --git a/src/interfaces/ICommand.ts b/src/interfaces/ICommand.ts index 95b5a2b..94efa95 100644 --- a/src/interfaces/ICommand.ts +++ b/src/interfaces/ICommand.ts @@ -1,3 +1,3 @@ -import { IMessage } from "./IMessage"; +import { IMessage } from './IMessage'; export type ICommand = IMessage; diff --git a/src/interfaces/ICommandBus.ts b/src/interfaces/ICommandBus.ts index 38907f8..53c4a7d 100644 --- a/src/interfaces/ICommandBus.ts +++ b/src/interfaces/ICommandBus.ts @@ -1,7 +1,7 @@ -import { ICommand } from "./ICommand"; -import { IEventSet } from "./IEventSet"; -import { IObservable } from "./IObservable"; -import { IObserver } from "./IObserver"; +import { ICommand } from './ICommand'; +import { IEventSet } from './IEventSet'; +import { IObservable } from './IObservable'; +import { IObserver } from './IObserver'; export interface ICommandBus extends IObservable { send(commandType: string, aggregateId: string | undefined, options: { payload?: object, context?: object }): diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index c2e0c3f..7110fa6 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -1,13 +1,13 @@ -import { Container } from "di0"; -import { ICommandBus } from "./ICommandBus"; -import { IEventDispatcher } from "./IEventDispatcher"; -import { IEventStore } from "./IEventStore"; -import { IEventBus } from "./IEventBus"; -import { IEventProcessor } from "./IEventProcessor"; -import { IEventStorageReader, IEventStorageWriter } from "./IEventStorage"; -import { IAggregateSnapshotStorage } from "./IAggregateSnapshotStorage"; -import { IIdentifierProvider } from "./IIdentifierProvider"; -import { IExtendableLogger, ILogger } from "./ILogger"; +import { Container } from 'di0'; +import { ICommandBus } from './ICommandBus'; +import { IEventDispatcher } from './IEventDispatcher'; +import { IEventStore } from './IEventStore'; +import { IEventBus } from './IEventBus'; +import { IEventProcessor } from './IEventProcessor'; +import { IEventStorageReader, IEventStorageWriter } from './IEventStorage'; +import { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage'; +import { IIdentifierProvider } from './IIdentifierProvider'; +import { IExtendableLogger, ILogger } from './ILogger'; export interface IContainer extends Container { eventBus: IEventBus; @@ -22,5 +22,7 @@ export interface IContainer extends Container { eventDispatchProcessors?: IEventProcessor[]; logger?: ILogger | IExtendableLogger; + + // eslint-disable-next-line no-undef process?: NodeJS.Process } diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts index ec08092..0afe504 100644 --- a/src/interfaces/IEvent.ts +++ b/src/interfaces/IEvent.ts @@ -1,7 +1,8 @@ -import { IMessage } from "./IMessage"; -import { isObject } from "./isObject"; +import { IMessage } from './IMessage'; +import { isObject } from './isObject'; export type IEvent = IMessage & { + /** Unique event identifier */ id?: string; }; diff --git a/src/interfaces/IEventBus.ts b/src/interfaces/IEventBus.ts index c358a06..f36c593 100644 --- a/src/interfaces/IEventBus.ts +++ b/src/interfaces/IEventBus.ts @@ -1,5 +1,5 @@ -import { IEvent } from "./IEvent"; -import { IObservable, isIObservable } from "./IObservable"; +import { IEvent } from './IEvent'; +import { IObservable, isIObservable } from './IObservable'; export interface IEventBus extends IObservable { publish(event: IEvent): Promise; diff --git a/src/interfaces/IEventDispatcher.ts b/src/interfaces/IEventDispatcher.ts index bb5a0ba..60a1ce8 100644 --- a/src/interfaces/IEventDispatcher.ts +++ b/src/interfaces/IEventDispatcher.ts @@ -1,5 +1,5 @@ -import { IEventSet } from "./IEventSet"; -import { IEventBus } from "./IEventBus"; +import { IEventSet } from './IEventSet'; +import { IEventBus } from './IEventBus'; export interface IEventDispatcher { readonly eventBus: IEventBus; diff --git a/src/interfaces/IEventLocker.ts b/src/interfaces/IEventLocker.ts index 0d6c5a4..d3388b1 100644 --- a/src/interfaces/IEventLocker.ts +++ b/src/interfaces/IEventLocker.ts @@ -1,5 +1,5 @@ -import { IEvent } from "./IEvent"; -import { isObject } from "./isObject"; +import { IEvent } from './IEvent'; +import { isObject } from './isObject'; /** * Interface for tracking event processing state to prevent concurrent processing diff --git a/src/interfaces/IEventProcessor.ts b/src/interfaces/IEventProcessor.ts index ee7c28b..7bd448c 100644 --- a/src/interfaces/IEventProcessor.ts +++ b/src/interfaces/IEventProcessor.ts @@ -1,4 +1,4 @@ -import { IEvent } from "./IEvent"; +import { IEvent } from './IEvent'; /** * Represents a wrapper for an event that can optionally contain additional metadata. diff --git a/src/interfaces/IEventReceptor.ts b/src/interfaces/IEventReceptor.ts index 6059e78..722cbde 100644 --- a/src/interfaces/IEventReceptor.ts +++ b/src/interfaces/IEventReceptor.ts @@ -1,5 +1,5 @@ -import { IEventStore } from "./IEventStore"; -import { IObserver } from "./IObserver"; +import { IEventStore } from './IEventStore'; +import { IObserver } from './IObserver'; export interface IEventReceptor extends IObserver { subscribe(eventStore: IEventStore): void; diff --git a/src/interfaces/IEventSet.ts b/src/interfaces/IEventSet.ts index b65cc0a..c06ac83 100644 --- a/src/interfaces/IEventSet.ts +++ b/src/interfaces/IEventSet.ts @@ -1,4 +1,4 @@ -import { IEvent, isEvent } from "./IEvent"; +import { IEvent, isEvent } from './IEvent'; export type IEventSet = ReadonlyArray>; diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorage.ts index cd55ade..bc7dbdb 100644 --- a/src/interfaces/IEventStorage.ts +++ b/src/interfaces/IEventStorage.ts @@ -1,20 +1,23 @@ -import { Identifier } from "./Identifier"; -import { IEvent } from "./IEvent"; -import { IEventSet } from "./IEventSet"; -import { IEventStream } from "./IEventStream"; -import { isObject } from "./isObject"; +import { Identifier } from './Identifier'; +import { IEvent } from './IEvent'; +import { IEventSet } from './IEventSet'; +import { IEventStream } from './IEventStream'; +import { isObject } from './isObject'; export type EventQueryAfter = { + /** Get events emitted after this specific event */ afterEvent?: IEvent; } export type EventQueryBefore = { + /** Get events emitted before this specific event */ beforeEvent?: IEvent; } export interface IEventStorageReader { + /** * Retrieves events of specified types that were emitted after a given event. */ @@ -32,6 +35,7 @@ export interface IEventStorageReader { } export interface IEventStorageWriter { + /** * Persists a set of events to the event store. * Returns the persisted event set (potentially enriched or normalized). diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index c647010..1320e0d 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,8 +1,8 @@ -import { IEventDispatcher } from "./IEventDispatcher"; -import { IEvent } from "./IEvent"; -import { IEventStorageReader } from "./IEventStorage"; -import { IIdentifierProvider } from "./IIdentifierProvider"; -import { IMessageHandler, IObservable } from "./IObservable"; +import { IEventDispatcher } from './IEventDispatcher'; +import { IEvent } from './IEvent'; +import { IEventStorageReader } from './IEventStorage'; +import { IIdentifierProvider } from './IIdentifierProvider'; +import { IMessageHandler, IObservable } from './IObservable'; export interface IEventStore extends IObservable, IEventDispatcher, IEventStorageReader, IIdentifierProvider { diff --git a/src/interfaces/IEventStream.ts b/src/interfaces/IEventStream.ts index f8c9337..1f11e35 100644 --- a/src/interfaces/IEventStream.ts +++ b/src/interfaces/IEventStream.ts @@ -1,3 +1,3 @@ -import { IEvent } from "./IEvent"; +import { IEvent } from './IEvent'; export type IEventStream = AsyncIterableIterator>; diff --git a/src/interfaces/IIdentifierProvider.ts b/src/interfaces/IIdentifierProvider.ts index 30b8be9..2c73090 100644 --- a/src/interfaces/IIdentifierProvider.ts +++ b/src/interfaces/IIdentifierProvider.ts @@ -1,7 +1,8 @@ -import { Identifier } from "./Identifier"; -import { isObject } from "./isObject"; +import { Identifier } from './Identifier'; +import { isObject } from './isObject'; export interface IIdentifierProvider { + /** * Generates and returns a new unique identifier suitable for aggregates, sagas, and events. * diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index c474e3b..40c78f0 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -1,7 +1,8 @@ -import { Identifier } from "./Identifier"; -import { isObject } from "./isObject"; +import { Identifier } from './Identifier'; +import { isObject } from './isObject'; export interface IMessage { + /** Event or command type */ type: string; diff --git a/src/interfaces/IMessageBus.ts b/src/interfaces/IMessageBus.ts index c20af13..d986b20 100644 --- a/src/interfaces/IMessageBus.ts +++ b/src/interfaces/IMessageBus.ts @@ -1,6 +1,6 @@ -import { ICommand } from "./ICommand"; -import { IEvent } from "./IEvent"; -import { IObservable } from "./IObservable"; +import { ICommand } from './ICommand'; +import { IEvent } from './IEvent'; +import { IObservable } from './IObservable'; export interface IMessageBus extends IObservable { send(command: ICommand): Promise; diff --git a/src/interfaces/IObjectStorage.ts b/src/interfaces/IObjectStorage.ts index 1207c37..e4b651a 100644 --- a/src/interfaces/IObjectStorage.ts +++ b/src/interfaces/IObjectStorage.ts @@ -1,4 +1,4 @@ -import { Identifier } from "./Identifier"; +import { Identifier } from './Identifier'; export interface IObjectStorage { get(id: Identifier): Promise | TRecord | undefined; diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts index 79774ba..a04387a 100644 --- a/src/interfaces/IObservable.ts +++ b/src/interfaces/IObservable.ts @@ -1,11 +1,12 @@ -import { IMessage } from "./IMessage"; -import { isObject } from "./isObject"; +import { IMessage } from './IMessage'; +import { isObject } from './isObject'; export interface IMessageHandler { (message: IMessage, meta?: Record): any | Promise -}; +} export interface IObservable { + /** * Setup a listener for a specific event type */ diff --git a/src/interfaces/IObserver.ts b/src/interfaces/IObserver.ts index 6f1365f..d822cea 100644 --- a/src/interfaces/IObserver.ts +++ b/src/interfaces/IObserver.ts @@ -1,4 +1,4 @@ -import { IObservable } from "./IObservable"; +import { IObservable } from './IObservable'; export interface IObserver { subscribe(observable: IObservable): void; diff --git a/src/interfaces/IProjection.ts b/src/interfaces/IProjection.ts index aaa6721..4c260d7 100644 --- a/src/interfaces/IProjection.ts +++ b/src/interfaces/IProjection.ts @@ -1,6 +1,6 @@ -import { IEvent } from "./IEvent"; -import { IEventStore } from "./IEventStore"; -import { IObserver } from "./IObserver"; +import { IEvent } from './IEvent'; +import { IEventStore } from './IEventStore'; +import { IObserver } from './IObserver'; export interface IProjection extends IObserver { readonly view: TView; diff --git a/src/interfaces/ISaga.ts b/src/interfaces/ISaga.ts index 8507ac1..f4920ba 100644 --- a/src/interfaces/ISaga.ts +++ b/src/interfaces/ISaga.ts @@ -1,9 +1,10 @@ -import { ICommand } from "./ICommand"; -import { Identifier } from "./Identifier"; -import { IEvent } from "./IEvent"; -import { IEventSet } from "./IEventSet"; +import { ICommand } from './ICommand'; +import { Identifier } from './Identifier'; +import { IEvent } from './IEvent'; +import { IEventSet } from './IEventSet'; export interface ISaga { + /** Unique Saga ID */ readonly id: Identifier; diff --git a/src/interfaces/IViewLocker.ts b/src/interfaces/IViewLocker.ts index 238479d..fefcd2d 100644 --- a/src/interfaces/IViewLocker.ts +++ b/src/interfaces/IViewLocker.ts @@ -1,4 +1,4 @@ -import { isObject } from "./isObject"; +import { isObject } from './isObject'; /** * Interface for managing view restoration state to prevent early access to an inconsistent view @@ -13,7 +13,7 @@ export interface IViewLocker { /** * Locks the view to prevent external read/write operations. - * + * * @returns `true` if the lock is successfully acquired, `false` otherwise. */ lock(): Promise | boolean; @@ -25,16 +25,16 @@ export interface IViewLocker { /** * Waits until the view is fully restored and ready to accept new events. - * + * * @param eventType The event type to listen for (`"ready"`). * @returns A promise that resolves when the view is ready. */ - once(eventType: "ready"): Promise; + once(eventType: 'ready'): Promise; } /** * Checks if a given object conforms to the `IViewLocker` interface. - * + * * @param view The object to check. * @returns `true` if the object implements `IViewLocker`, `false` otherwise. */ diff --git a/src/rabbitmq/IContainer.ts b/src/rabbitmq/IContainer.ts index 18da704..6c43fb0 100644 --- a/src/rabbitmq/IContainer.ts +++ b/src/rabbitmq/IContainer.ts @@ -1,5 +1,5 @@ -import { RabbitMqEventInjector } from "./RabbitMqEventInjector"; -import { RabbitMqGateway } from "./RabbitMqGateway"; +import { RabbitMqEventInjector } from './RabbitMqEventInjector'; +import { RabbitMqGateway } from './RabbitMqGateway'; declare module '../interfaces/IContainer' { interface IContainer { diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 6b5c813..130c43f 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,5 +1,5 @@ -import { IEvent, IEventBus, IMessage, IMessageHandler, IObservable } from "../interfaces"; -import { RabbitMqGateway } from "./RabbitMqGateway"; +import { IEvent, IEventBus, IMessageHandler, IObservable } from '../interfaces'; +import { RabbitMqGateway } from './RabbitMqGateway'; const ALL_EVENTS_WILDCARD = '*'; diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts index f6ae456..f8e4850 100644 --- a/src/rabbitmq/RabbitMqEventInjector.ts +++ b/src/rabbitmq/RabbitMqEventInjector.ts @@ -1,7 +1,7 @@ -import { IContainer } from "../interfaces/IContainer"; -import { IMessage } from "../interfaces/IMessage"; -import { RabbitMqGateway } from "./RabbitMqGateway"; -import { IEventDispatcher, isEvent } from "../interfaces"; +import { IContainer } from '../interfaces/IContainer'; +import { IMessage } from '../interfaces/IMessage'; +import { RabbitMqGateway } from './RabbitMqGateway'; +import { IEventDispatcher } from '../interfaces'; import * as Event from '../Event'; export class RabbitMqEventInjector { @@ -18,9 +18,9 @@ export class RabbitMqEventInjector { queueName?: string; }) { if (!container.eventDispatcher) - throw new Error("eventDispatcher is required in the container."); + throw new Error('eventDispatcher is required in the container.'); if (!container.rabbitMqGateway) - throw new Error("rabbitMqGateway is required in the container."); + throw new Error('rabbitMqGateway is required in the container.'); this.#rabbitMqGateway = container.rabbitMqGateway; this.#eventDispatcher = container.eventDispatcher; diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index ab00b06..fad8d2f 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -227,7 +227,7 @@ export class RabbitMqGateway { } async #assertConnection() { - return this.#connection ?? await this.connect(); + return this.#connection ?? this.connect(); } /** Get existing or open a new channel for a given queue name */ @@ -245,6 +245,7 @@ export class RabbitMqGateway { * Ensure queue, exchange, and binding exist */ async #assetQueue(channel: Channel, exchange: string, queueName: string, eventType?: string, options?: { + /** The queue will survive a broker restart */ durable?: boolean, @@ -374,7 +375,7 @@ export class RabbitMqGateway { return new Promise((resolve, reject) => { const published = this.#pubChannel!.publish(exchange, message.type, content, properties, err => - err ? reject(err) : resolve()); + (err ? reject(err) : resolve())); if (!published) throw new Error(`${this.#appId}: Failed to send event ${Event.describe(message)}, channel buffer is full`); }); diff --git a/src/sqlite/AbstractSqliteObjectProjection.ts b/src/sqlite/AbstractSqliteObjectProjection.ts index 59efb63..3cb996c 100644 --- a/src/sqlite/AbstractSqliteObjectProjection.ts +++ b/src/sqlite/AbstractSqliteObjectProjection.ts @@ -1,7 +1,7 @@ -import { AbstractProjection } from "../AbstractProjection"; -import { IExtendableLogger } from "../interfaces"; -import { SqliteDbParams } from "./commonParams"; -import { SqliteObjectView } from "./SqliteObjectView"; +import { AbstractProjection } from '../AbstractProjection'; +import { IExtendableLogger } from '../interfaces'; +import { SqliteDbParams } from './commonParams'; +import { SqliteObjectView } from './SqliteObjectView'; export abstract class AbstractSqliteObjectProjection extends AbstractProjection> { diff --git a/src/sqlite/AbstractSqliteView.ts b/src/sqlite/AbstractSqliteView.ts index e4a01e4..697ec15 100644 --- a/src/sqlite/AbstractSqliteView.ts +++ b/src/sqlite/AbstractSqliteView.ts @@ -1,8 +1,7 @@ -import { IEvent, IEventLocker, ILogger } from '../interfaces'; +import { IEvent, IEventLocker, ILogger, IViewLocker } from '../interfaces'; import { Database } from 'better-sqlite3'; import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; -import { IViewLocker } from '../interfaces'; export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { @@ -21,7 +20,7 @@ export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { this.schemaVersion = options.schemaVersion; this.viewLocker = new SqliteViewLocker(options); this.eventLocker = new SqliteEventLocker(options); - this.logger = options.logger && 'child' in options.logger ? + this.logger = options.logger && 'child' in options.logger ? options.logger.child({ serviceName: new.target.name }) : options.logger; } diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index 81db266..3d26171 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -6,9 +6,10 @@ import { SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; export type SqliteEventLockerParams = SqliteDbParams & SqliteProjectionDataParams & { + /** * (Optional) SQLite table name where event locks are stored - * + * * @default "tbl_event_lock" */ eventLockTableName?: string; diff --git a/src/sqlite/SqliteObjectView.ts b/src/sqlite/SqliteObjectView.ts index 9a99f6a..31165f4 100644 --- a/src/sqlite/SqliteObjectView.ts +++ b/src/sqlite/SqliteObjectView.ts @@ -1,4 +1,4 @@ -import { AbstractSqliteView } from "./AbstractSqliteView"; +import { AbstractSqliteView } from './AbstractSqliteView'; import { IObjectStorage, IEventLocker } from '../interfaces'; import { SqliteObjectStorage } from './SqliteObjectStorage'; diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index 9320adf..9907aee 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -7,16 +7,17 @@ import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; const delay = promisify(setTimeout); export type SqliteViewLockerParams = SqliteDbParams & SqliteProjectionDataParams & { + /** * (Optional) SQLite table name where event locks along with the latest event are stored - * + * * @default "tbl_view_lock" */ viewLockTableName?: string; /** * (Optional) Time-to-live (TTL) duration (in milliseconds) for which a view remains locked - * + * * @default 120_000 */ viewLockTtl?: number; @@ -44,6 +45,7 @@ export class SqliteViewLocker implements IViewLocker { #removeTableLockQuery: Statement<[string, string], void>; #lockMarker: Deferred | undefined; + // eslint-disable-next-line no-undef #lockProlongationTimeout: NodeJS.Timeout | undefined; constructor(o: SqliteViewLockerParams) { diff --git a/src/sqlite/commonParams.ts b/src/sqlite/commonParams.ts index 9b51c7a..f26118e 100644 --- a/src/sqlite/commonParams.ts +++ b/src/sqlite/commonParams.ts @@ -1,11 +1,13 @@ import { Database } from 'better-sqlite3'; export type SqliteDbParams = { + /** Configured instance of better-sqlite3.Database */ viewModelSqliteDb: Database; }; export type SqliteProjectionDataParams = { + /** * Unique identifier for the projection, used with the schema version to distinguish data ownership. */ diff --git a/src/sqlite/utils/getEventId.ts b/src/sqlite/utils/getEventId.ts index 309d49f..2a99f75 100644 --- a/src/sqlite/utils/getEventId.ts +++ b/src/sqlite/utils/getEventId.ts @@ -1,4 +1,4 @@ -import { IEvent } from "../../interfaces"; +import { IEvent } from '../../interfaces'; import { guid } from './guid'; import md5 = require('md5'); diff --git a/src/utils/getHandler.ts b/src/utils/getHandler.ts index 957bbaf..8df01a1 100644 --- a/src/utils/getHandler.ts +++ b/src/utils/getHandler.ts @@ -1,4 +1,4 @@ -import { IMessageHandler } from "../interfaces"; +import { IMessageHandler } from '../interfaces'; /** * Gets a handler for a specific message type, prefers a public (w\o _ prefix) method, if available @@ -17,4 +17,4 @@ export function getHandler(context: { [key: string]: any }, messageType: string) return context[privateHandlerName].bind(context); return null; -}; +} diff --git a/src/utils/setupOneTimeEmitterSubscription.ts b/src/utils/setupOneTimeEmitterSubscription.ts index 4fe28a0..554d8bf 100644 --- a/src/utils/setupOneTimeEmitterSubscription.ts +++ b/src/utils/setupOneTimeEmitterSubscription.ts @@ -1,4 +1,4 @@ -import { IEvent, ILogger, IObservable } from "../interfaces"; +import { IEvent, ILogger, IObservable } from '../interfaces'; /** * Create one-time eventEmitter subscription for one or multiple events that match a filter @@ -34,8 +34,10 @@ export function setupOneTimeEmitterSubscription( let handled = false; function filteredHandler(event: IEvent) { - if (filter && !filter(event)) return; - if (handled) return; + if (filter && !filter(event)) + return; + if (handled) + return; handled = true; for (const messageType of messageTypes) diff --git a/src/utils/subscribe.ts b/src/utils/subscribe.ts index 28982b9..dcb3965 100644 --- a/src/utils/subscribe.ts +++ b/src/utils/subscribe.ts @@ -1,6 +1,6 @@ -import { IMessageHandler, IObservable } from "../interfaces"; +import { IMessageHandler, IObservable } from '../interfaces'; import { getHandler } from './getHandler'; -import { getMessageHandlerNames } from "./getMessageHandlerNames"; +import { getMessageHandlerNames } from './getMessageHandlerNames'; const unique = (arr: T[]): T[] => [...new Set(arr)]; diff --git a/src/utils/validateHandlers.ts b/src/utils/validateHandlers.ts index e6d5c96..7061c34 100644 --- a/src/utils/validateHandlers.ts +++ b/src/utils/validateHandlers.ts @@ -4,7 +4,8 @@ import { getHandler } from './getHandler'; * Ensure instance has handlers declared for all handled message types */ export function validateHandlers(instance: object, handlesFieldName = 'handles') { - if (!instance) throw new TypeError('instance argument required'); + if (!instance) + throw new TypeError('instance argument required'); const messageTypes = Object.getPrototypeOf(instance).constructor[handlesFieldName]; if (messageTypes === undefined) diff --git a/tests/integration/rabbitmq/RabbitMqEventBus.test.ts b/tests/integration/rabbitmq/RabbitMqEventBus.test.ts index ee99a10..10c31ad 100644 --- a/tests/integration/rabbitmq/RabbitMqEventBus.test.ts +++ b/tests/integration/rabbitmq/RabbitMqEventBus.test.ts @@ -109,11 +109,11 @@ describe('RabbitMqEventBus', () => { const received1: IMessage[] = []; const received2: IMessage[] = []; - await eventBus1.queue(queueName).on(eventType, (msg) => { + await eventBus1.queue(queueName).on(eventType, msg => { received1.push(msg); }); - await eventBus2.queue(queueName).on(eventType, (msg) => { + await eventBus2.queue(queueName).on(eventType, msg => { received2.push(msg); }); @@ -135,11 +135,11 @@ describe('RabbitMqEventBus', () => { const received1: IMessage[] = []; const received2: IMessage[] = []; - await eventBus1.queue(queueName).on(RabbitMqEventBus.allEventsWildcard, (msg) => { + await eventBus1.queue(queueName).on(RabbitMqEventBus.allEventsWildcard, msg => { received1.push(msg); }); - await eventBus2.queue(queueName).on(RabbitMqEventBus.allEventsWildcard, (msg) => { + await eventBus2.queue(queueName).on(RabbitMqEventBus.allEventsWildcard, msg => { received2.push(msg); }); diff --git a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts index b733d98..f111718 100644 --- a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts +++ b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts @@ -1,14 +1,13 @@ import * as amqplib from 'amqplib'; import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; import { RabbitMqEventInjector } from '../../../src/rabbitmq/RabbitMqEventInjector'; -import { IEvent, IEventDispatcher, IMessage } from '../../../src/interfaces'; +import { IEvent, IEventDispatcher } from '../../../src/interfaces'; import { jest } from '@jest/globals'; import { delay } from '../../../src/utils'; describe('RabbitMqEventInjector', () => { let rabbitMqGateway: RabbitMqGateway; let eventDispatcher: jest.Mocked; - let injector: RabbitMqEventInjector; const exchange = 'node-cqrs.events'; const queueName = 'test-injector-queue'; @@ -20,10 +19,11 @@ describe('RabbitMqEventInjector', () => { rabbitMqGateway = new RabbitMqGateway({ rabbitMqConnectionFactory }); eventDispatcher = { - dispatch: jest.fn().mockResolvedValue(undefined), + dispatch: jest.fn().mockResolvedValue(undefined) } as unknown as jest.Mocked; - injector = new RabbitMqEventInjector({ + // eslint-disable-next-line @typescript-eslint/no-unused-vars + const injector = new RabbitMqEventInjector({ rabbitMqGateway, eventDispatcher, queueName, @@ -55,7 +55,7 @@ describe('RabbitMqEventInjector', () => { const testEvent: IEvent = { type: eventType, payload: { data: 'test-payload' }, - id: 'test-id-123', + id: 'test-id-123' }; await rabbitMqGateway.publish(exchange, testEvent); @@ -70,7 +70,7 @@ describe('RabbitMqEventInjector', () => { const testEvent: IEvent = { type: 'error-event', payload: { data: 'trigger-error' }, - id: 'error-id-456', + id: 'error-id-456' }; const dispatchError = new Error('Dispatch failed'); eventDispatcher.dispatch.mockRejectedValueOnce(dispatchError); diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index 271d90d..12ec6fa 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -16,6 +16,7 @@ describe('RabbitMqGateway', () => { beforeEach(async () => { const logger = undefined; + // const logger = console; gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); gateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); @@ -28,7 +29,7 @@ describe('RabbitMqGateway', () => { await ch.deleteQueue(queueName); await ch.deleteQueue(`${queueName}.failed`); await ch.deleteExchange(exchange); - await gateway1.disconnect() + await gateway1.disconnect(); } await gateway2?.disconnect(); await gateway3?.disconnect(); @@ -40,7 +41,7 @@ describe('RabbitMqGateway', () => { const message: IMessage = { type: 'test.confirm', - payload: { msg: 'confirmed' }, + payload: { msg: 'confirmed' } }; await gateway1.publish(exchange, message); @@ -59,7 +60,7 @@ describe('RabbitMqGateway', () => { const message: IMessage = { type: 'test.event', - payload: { msg: 'self-test' }, + payload: { msg: 'self-test' } }; // publish from the same instance — should be ignored @@ -83,7 +84,7 @@ describe('RabbitMqGateway', () => { const message: IMessage = { type: 'test.event', - payload: { from: 'external' }, + payload: { from: 'external' } }; gateway3.publish(exchange, message); diff --git a/tests/integration/sqlite/SqliteView.test.ts b/tests/integration/sqlite/SqliteView.test.ts index c50916e..eaf116c 100644 --- a/tests/integration/sqlite/SqliteView.test.ts +++ b/tests/integration/sqlite/SqliteView.test.ts @@ -24,12 +24,11 @@ class MyDumbProjection extends AbstractProjection> { if (!e.payload) throw new TypeError('e.payload is required'); - await this.view.update(e.aggregateId, u => e.payload); + await this.view.update(e.aggregateId, _u => e.payload); } } - -describe.only('SqliteView', () => { +describe('SqliteView', () => { let viewModelSqliteDb: import('better-sqlite3').Database; diff --git a/tests/unit/AbstractAggregate.test.ts b/tests/unit/AbstractAggregate.test.ts index a74ac4e..7cfcf73 100644 --- a/tests/unit/AbstractAggregate.test.ts +++ b/tests/unit/AbstractAggregate.test.ts @@ -81,7 +81,9 @@ describe('AbstractAggregate', function () { it('returns immutable aggregate id', () => { expect(agg.id).to.equal(1); - expect(() => (agg as any).id = 2).to.throw(TypeError); + expect(() => { + (agg as any).id = 2; + }).to.throw(TypeError); }); }); @@ -94,7 +96,9 @@ describe('AbstractAggregate', function () { expect(changes).to.be.an('Array'); expect(changes).to.be.empty; expect(changes).to.not.equal(agg.changes); - expect(() => (agg as any).changes = []).to.throw(TypeError); + expect(() => { + (agg as any).changes = []; + }).to.throw(TypeError); return agg.doSomething({}).then(() => { @@ -110,7 +114,9 @@ describe('AbstractAggregate', function () { it('is a read-only auto-incrementing aggregate version, starting from 0', () => { expect(agg.version).to.equal(0); - expect(() => (agg as any).version = 1).to.throw(TypeError); + expect(() => { + (agg as any).version = 1; + }).to.throw(TypeError); }); it('restores, when aggregate is restored from event stream', () => { @@ -227,7 +233,7 @@ describe('AbstractAggregate', function () { it('does not mutate state if state event handler is not defined', () => { - const state = new class AggregateState { + const state = new class AnotherAggregateState { somethingHappened() { } }(); const somethingHappenedSpy = sinon.spy(state, 'somethingHappened'); @@ -303,7 +309,9 @@ describe('AbstractAggregate', function () { const keysToCopy = Object.keys(snapshotEvent).filter(k => k !== keyToMiss); const brokenEvent = JSON.parse(JSON.stringify(snapshotEvent, keysToCopy)); - expect(() => (agg as any).restoreSnapshot(brokenEvent)).to.throw(TypeError); + expect(() => { + (agg as any).restoreSnapshot(brokenEvent); + }).to.throw(TypeError); } expect(() => (agg as any).restoreSnapshot({ aggregateVersion: 1, type: 'somethingHappened', payload: {} })).to.throw('snapshot event type expected'); diff --git a/tests/unit/AbstractProjection.test.ts b/tests/unit/AbstractProjection.test.ts index af37fba..5701e5f 100644 --- a/tests/unit/AbstractProjection.test.ts +++ b/tests/unit/AbstractProjection.test.ts @@ -14,12 +14,13 @@ class MyProjection extends AbstractProjection { if (v.somethingHappenedCnt) v.somethingHappenedCnt += 1; else v.somethingHappenedCnt = 1; + return v; }); } @@ -210,14 +211,14 @@ describe('AbstractProjection', function () { projection.view.unlock(); sinon.spy(projection, '_somethingHappened'); - const event = { type: 'somethingHappened', aggregateId: 1 }; + const event2 = { type: 'somethingHappened', aggregateId: 1 }; expect(projection._somethingHappened).to.have.property('called', false); - await projection.project(event); + await projection.project(event2); expect(projection._somethingHappened).to.have.property('calledOnce', true); - expect(projection._somethingHappened.lastCall.args).to.eql([event]); + expect(projection._somethingHappened.lastCall.args).to.eql([event2]); }); }); }); diff --git a/tests/unit/AbstractSaga.test.ts b/tests/unit/AbstractSaga.test.ts index 86a08cd..f28bd5b 100644 --- a/tests/unit/AbstractSaga.test.ts +++ b/tests/unit/AbstractSaga.test.ts @@ -5,7 +5,7 @@ class Saga extends AbstractSaga { static get startsWith() { return ['somethingHappened']; } - _somethingHappened(event) { + _somethingHappened(_event) { super.enqueue('doSomething', undefined, { foo: 'bar' }); } } diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index 0e5ead3..837d9b1 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -1,8 +1,13 @@ import { expect, assert } from 'chai'; import * as sinon from 'sinon'; -import { EventDispatcher, ICommandBus, Identifier, IEventBus, IEventSet, IEventStore, InMemoryMessageBus } from '../../src'; - import { + EventDispatcher, + ICommandBus, + Identifier, + IEventBus, + IEventSet, + IEventStore, + InMemoryMessageBus, AggregateCommandHandler, AbstractAggregate, InMemoryEventStorage, @@ -141,8 +146,6 @@ describe('AggregateCommandHandler', function () { it('attaches command context, sagaId, sagaVersion to produced events', async () => { - const aggregate = new MyAggregate({ id: 1 }); - const handler = new AggregateCommandHandler({ eventStore, aggregateType: MyAggregate @@ -222,47 +225,4 @@ describe('AggregateCommandHandler', function () { expect(eventStream[2]).to.have.property('aggregateVersion', 2); expect(eventStream[2]).to.have.property('payload'); }); - - it.skip('executes concurrent commands on same aggregate instance', async () => { - - // setup - - class PersistedAggregate extends MyAggregate { - get shouldTakeSnapshot() { - return this.version > 2; - } - } - - const handler = new AggregateCommandHandler({ eventStore, aggregateType: PersistedAggregate }); - - const getAggregateEventsSpy = sinon.spy(storage, 'getAggregateEvents'); - const commitEventsSpy = sinon.spy(storage, 'commitEvents'); - - // test - - const cmd0 = { type: 'createAggregate' }; - - const [{ aggregateId }] = await handler.execute(cmd0); - - expect(storage).to.have.nested.property('getAggregateEvents.callCount', 0); - expect(storage).to.have.nested.property('commitEvents.callCount', 1); - - const cmd1 = { aggregateId, type: 'doSomething' }; - const cmd2 = { aggregateId, type: 'doSomething' }; - const cmd3 = { aggregateId, type: 'doSomething' }; - - await Promise.all([cmd1, cmd2, cmd3].map(c => handler.execute(c))); - - // expect(storage).to.have.nested.property('getAggregateEvents.callCount', 1); - // expect(storage).to.have.nested.property('commitEvents.callCount', 2); - - const events = await eventStore.getAggregateEvents(aggregateId as Identifier); - - expect(events).to.have.length(4); - expect(events[0]).to.have.property('type', 'snapshot'); - expect(events[0]).to.have.property('aggregateVersion', 1); - expect(events[1]).to.have.property('aggregateVersion', 2); - expect(events[2]).to.have.property('aggregateVersion', 3); - expect(events[3]).to.have.property('aggregateVersion', 4); - }); }); diff --git a/tests/unit/EventDispatcher.test.ts b/tests/unit/EventDispatcher.test.ts index 45bde3f..53f3107 100644 --- a/tests/unit/EventDispatcher.test.ts +++ b/tests/unit/EventDispatcher.test.ts @@ -16,7 +16,7 @@ describe('EventDispatcher', () => { const event2: IEvent = { type: 'test-event-2' }; const processorMock: IEventProcessor = { - process: jest.fn(batch => Promise.resolve(batch)), + process: jest.fn(batch => Promise.resolve(batch)) }; dispatcher.addPipelineProcessor(processorMock); @@ -36,7 +36,7 @@ describe('EventDispatcher', () => { const processorMock: IEventProcessor = { process: jest.fn().mockRejectedValue(error), - revert: jest.fn().mockResolvedValue(undefined), + revert: jest.fn().mockResolvedValue(undefined) }; dispatcher.addPipelineProcessor(processorMock); @@ -63,7 +63,7 @@ describe('EventDispatcher', () => { await new Promise(res => setTimeout(res, 5)); executionOrder.push(`A-end-${batch[0].event.type}`); return batch; - }), + }) }; const processorB: IEventProcessor = { @@ -72,7 +72,7 @@ describe('EventDispatcher', () => { await new Promise(res => setTimeout(res, 5)); executionOrder.push(`B-end-${batch[0].event.type}`); return batch; - }), + }) }; dispatcher.addPipelineProcessor(processorA); @@ -83,7 +83,7 @@ describe('EventDispatcher', () => { await Promise.all([ dispatcher.dispatch([event1]), - dispatcher.dispatch([event2]), + dispatcher.dispatch([event2]) ]); expect(executionOrder).toEqual([ @@ -94,7 +94,7 @@ describe('EventDispatcher', () => { 'A-end-event-2', 'B-start-event-2', 'B-end-event-1', - 'B-end-event-2', + 'B-end-event-2' ]); }); }); diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index dcd1048..8cb1bb1 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -89,9 +89,9 @@ describe('EventStore', () => { mockStorage.getAggregateEvents.mockResolvedValueOnce(storedEvents); const result: IEvent[] = []; - for await (const event of store.getAggregateEvents('aggregate-1')) { + for await (const event of store.getAggregateEvents('aggregate-1')) result.push(event); - } + expect(result).toEqual([snapshotEvent, ...storedEvents]); expect(mockSnapshotStorage.getAggregateSnapshot).toHaveBeenCalledWith('aggregate-1'); @@ -107,9 +107,9 @@ describe('EventStore', () => { const filter = { beforeEvent: { sagaVersion: 1 } }; const result: IEvent[] = []; - for await (const event of store.getSagaEvents('saga-1', filter)) { + for await (const event of store.getSagaEvents('saga-1', filter)) result.push(event); - } + expect(result).toEqual(sagaEvents); expect(mockStorage.getSagaEvents).toHaveBeenCalledWith('saga-1', filter); @@ -150,13 +150,13 @@ describe('EventStore', () => { it('sets up a one-time subscription and resolves with an event', async () => { let callCount = 0; const testEvent = { type: 'onceEvent' } as IEvent; - const promise = store.once('onceEvent', (e: IEvent) => { + const promise = store.once('onceEvent', (_e: IEvent) => { callCount++; }); await store.dispatch([testEvent]); - expect(promise).resolves.toBe(testEvent); + await expect(promise).resolves.toBe(testEvent); expect(callCount).toBe(1); }); @@ -164,14 +164,14 @@ describe('EventStore', () => { let callCount = 0; const testEvent = { type: 'onceEvent' } as IEvent; const testEvent2 = { type: 'onceEvent' } as IEvent; - const promise = store.once('onceEvent', (e: IEvent) => { + const promise = store.once('onceEvent', (_e: IEvent) => { callCount++; }); await store.dispatch([testEvent, testEvent2]); await store.dispatch([testEvent2]); - expect(promise).resolves.toBe(testEvent); + await expect(promise).resolves.toBe(testEvent); expect(callCount).toBe(1); }); }); diff --git a/tests/unit/SagaEventHandler.test.ts b/tests/unit/SagaEventHandler.test.ts index 1556bc2..0aac4e9 100644 --- a/tests/unit/SagaEventHandler.test.ts +++ b/tests/unit/SagaEventHandler.test.ts @@ -18,7 +18,7 @@ class Saga extends AbstractSaga { static get handles(): string[] { return ['followingHappened']; } - somethingHappened(event) { + somethingHappened(_event) { super.enqueue('doSomething', undefined, { foo: 'bar' }); } followingHappened() { @@ -66,7 +66,7 @@ describe('SagaEventHandler', function () { commandBus.on('complete', () => { deferred.resolve(undefined); - }) + }); sinon.spy(eventStore, 'getSagaEvents'); @@ -94,7 +94,7 @@ describe('SagaEventHandler', function () { commandBus.on('fixError', command => { resolvePromise(command); }); - commandBus.on('doSomething', command => { + commandBus.on('doSomething', _command => { throw new Error('command execution failed'); }); diff --git a/tests/unit/memory/InMemoryEventStorage.test.ts b/tests/unit/memory/InMemoryEventStorage.test.ts index bd8079c..ca47e57 100644 --- a/tests/unit/memory/InMemoryEventStorage.test.ts +++ b/tests/unit/memory/InMemoryEventStorage.test.ts @@ -27,9 +27,9 @@ describe('InMemoryEventStorage', () => { await storage.commitEvents([event1, event2]); const results = []; - for await (const event of storage.getAggregateEvents('agg1')) { + for await (const event of storage.getAggregateEvents('agg1')) results.push(event); - } + expect(results).to.deep.equal([event1]); }); @@ -41,9 +41,9 @@ describe('InMemoryEventStorage', () => { const snapshot = { aggregateVersion: 1 }; const results = []; - for await (const event of storage.getAggregateEvents('agg1', { snapshot })) { + for await (const event of storage.getAggregateEvents('agg1', { snapshot })) results.push(event); - } + expect(results).to.deep.equal([event2]); }); }); @@ -59,9 +59,9 @@ describe('InMemoryEventStorage', () => { const beforeEvent = { sagaVersion: 3 }; const results = []; - for await (const event of storage.getSagaEvents('saga1', { beforeEvent })) { + for await (const event of storage.getSagaEvents('saga1', { beforeEvent })) results.push(event); - } + expect(results).to.deep.equal([event1, event2]); }); }); @@ -76,9 +76,9 @@ describe('InMemoryEventStorage', () => { await storage.commitEvents([event1, event2, event3]); const results = []; - for await (const event of storage.getEventsByTypes(['A'])) { + for await (const event of storage.getEventsByTypes(['A'])) results.push(event); - } + expect(results).to.deep.equal([event1, event3]); }); @@ -91,9 +91,9 @@ describe('InMemoryEventStorage', () => { const options = { afterEvent: { id: '1' } }; const results = []; - for await (const event of storage.getEventsByTypes(['A'], options)) { + for await (const event of storage.getEventsByTypes(['A'], options)) results.push(event); - } + expect(results).to.deep.equal([event2, event3]); }); @@ -107,7 +107,8 @@ describe('InMemoryEventStorage', () => { try { await gen.next(); throw new Error('Expected error was not thrown'); - } catch (err) { + } + catch (err) { expect(err).to.be.instanceOf(TypeError); expect(err.message).to.equal('options.afterEvent.id is required'); } diff --git a/tests/unit/memory/InMemoryLock.test.ts b/tests/unit/memory/InMemoryLock.test.ts index 63974e4..ce9cd91 100644 --- a/tests/unit/memory/InMemoryLock.test.ts +++ b/tests/unit/memory/InMemoryLock.test.ts @@ -33,7 +33,7 @@ describe('InMemoryLock', () => { }); // Ensure second lock() is still waiting - await new Promise((resolve) => setTimeout(resolve, 100)); + await new Promise(resolve => setTimeout(resolve, 100)); expect(secondLockAcquired).to.be.false; // Unlock and allow second lock to proceed @@ -69,7 +69,7 @@ describe('InMemoryLock', () => { }); // Ensure it's still waiting - await new Promise((resolve) => setTimeout(resolve, 100)); + await new Promise(resolve => setTimeout(resolve, 100)); expect(resolved).to.be.false; // Unlock and verify resolution diff --git a/tests/unit/memory/InMemoryMessageBus.test.ts b/tests/unit/memory/InMemoryMessageBus.test.ts index e80c385..f260a82 100644 --- a/tests/unit/memory/InMemoryMessageBus.test.ts +++ b/tests/unit/memory/InMemoryMessageBus.test.ts @@ -5,7 +5,9 @@ import { spy } from 'sinon'; describe('InMemoryMessageBus', function () { let bus: IMessageBus; - beforeEach(() => bus = new InMemoryMessageBus()); + beforeEach(() => { + bus = new InMemoryMessageBus(); + }); describe('send(command)', function () { diff --git a/tests/unit/memory/InMemoryView.test.ts b/tests/unit/memory/InMemoryView.test.ts index 3c0e7eb..a233997 100644 --- a/tests/unit/memory/InMemoryView.test.ts +++ b/tests/unit/memory/InMemoryView.test.ts @@ -12,6 +12,8 @@ describe('InMemoryView', function () { describe('create', () => { + beforeEach(() => v.unlock()); + it('creates a record', async () => { await v.create('foo', 'bar'); @@ -23,14 +25,31 @@ describe('InMemoryView', function () { await v.create('foo', 'bar'); - try{ + try { await v.create('foo', 'bar'); assert(false, 'did not throw'); } - catch(e: any) { + catch (e: any) { expect(e).to.have.property('message', 'Key \'foo\' already exists'); } }); + + it('creates new record, as passed in value', async () => { + + await v.create('foo', 'bar'); + expect(await v.get('foo')).to.eq('bar'); + }); + + it('fails, when trying to pass a function as a value', async () => { + try { + await v.create('foo', () => 'bar'); + assert(false, 'did not throw'); + } + catch (err) { + if (!(err instanceof TypeError)) + throw err; + } + }); }); describe('size', () => { @@ -148,28 +167,6 @@ describe('InMemoryView', function () { }); }); - describe('create', () => { - - beforeEach(() => v.unlock()); - - it('creates new record, as passed in value', async () => { - - await v.create('foo', 'bar'); - expect(await v.get('foo')).to.eq('bar'); - }); - - it('fails, when trying to pass a function as a value', async () => { - try { - await v.create('foo', () => 'bar'); - assert(false, 'did not throw'); - } - catch (err) { - if (!(err instanceof TypeError)) - throw err; - } - }); - }); - describe('update', () => { beforeEach(() => v.unlock()); @@ -180,7 +177,7 @@ describe('InMemoryView', function () { await v.update('foo', () => null); assert(false, 'did not throw'); } - catch(e: any) { + catch (e: any) { expect(e).to.have.property('message', 'Key \'foo\' does not exist'); } }); @@ -191,7 +188,7 @@ describe('InMemoryView', function () { expect(await v.get('foo')).to.eq('bar'); - await v.updateEnforcingNew('foo', v => `${v}-upd`); + await v.updateEnforcingNew('foo', val => `${val}-upd`); expect(await v.get('foo')).to.eq('bar-upd'); }); @@ -202,8 +199,8 @@ describe('InMemoryView', function () { expect(await v.get('foo')).to.deep.eq({ x: 'bar' }); - await v.updateEnforcingNew('foo', v => { - v.x += '-upd'; + await v.updateEnforcingNew('foo', val => { + val.x += '-upd'; }); expect(await v.get('foo')).to.deep.eq({ x: 'bar-upd' }); @@ -229,7 +226,7 @@ describe('InMemoryView', function () { expect(await v.get('foo')).to.eq('bar'); - await v.updateEnforcingNew('foo', v => `${v}-upd`); + await v.updateEnforcingNew('foo', val => `${val}-upd`); expect(await v.get('foo')).to.eq('bar-upd'); }); @@ -243,7 +240,7 @@ describe('InMemoryView', function () { await v.create('x', { v: 'y' }); await v.unlock(); - await v.updateAll(v => typeof v === 'string', v => `${v}-updated`); + await v.updateAll(val => typeof val === 'string', val => `${val}-updated`); expect(await v.get('foo')).to.eq('bar-updated'); expect(await v.get('x')).to.eql({ v: 'y' }); @@ -279,7 +276,7 @@ describe('InMemoryView', function () { await v.create('x', { v: 'y' }); await v.unlock(); - await v.deleteAll(v => typeof v === 'object'); + await v.deleteAll(val => typeof val === 'object'); expect(await v.get('foo')).to.eq('bar'); expect(await v.get('x')).to.eq(undefined); diff --git a/tests/unit/sqlite/SqliteEventLocker.test.ts b/tests/unit/sqlite/SqliteEventLocker.test.ts index e894fdd..99bb6e2 100644 --- a/tests/unit/sqlite/SqliteEventLocker.test.ts +++ b/tests/unit/sqlite/SqliteEventLocker.test.ts @@ -45,7 +45,7 @@ describe('SqliteEventLocker', function () { locker.tryMarkAsProjecting(testEvent); locker.markAsProjected(testEvent); - const row = db.prepare(`SELECT processed_at FROM test_event_lock WHERE event_id = ?`) + const row = db.prepare('SELECT processed_at FROM test_event_lock WHERE event_id = ?') .get(guid(testEvent.id)) as any; expect(row).to.exist; @@ -53,7 +53,7 @@ describe('SqliteEventLocker', function () { }); it('retrieves the last projected event', function () { - + locker.tryMarkAsProjecting(testEvent); locker.markAsProjected(testEvent); @@ -83,7 +83,7 @@ describe('SqliteEventLocker', function () { }); it('fails to update an event if its version is modified in DB', function () { - + locker.tryMarkAsProjecting(testEvent); // Modify the event in DB to simulate an external change diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts index 6da8010..56bc72f 100644 --- a/tests/unit/sqlite/SqliteObjectStorage.test.ts +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -10,7 +10,7 @@ describe('SqliteObjectStorage', function () { db = createDb(':memory:'); storage = new SqliteObjectStorage<{ name: string; value: number }>({ viewModelSqliteDb: db, - tableName: 'test_objects', + tableName: 'test_objects' }); }); @@ -36,7 +36,7 @@ describe('SqliteObjectStorage', function () { storage.create('0002', { name: 'Old Data', value: 5 }); - storage.update('0002', (r) => ({ ...r, value: 99 })); + storage.update('0002', r => ({ ...r, value: 99 })); const updated = storage.get('0002'); expect(updated).to.deep.equal({ name: 'Old Data', value: 99 }); @@ -44,7 +44,7 @@ describe('SqliteObjectStorage', function () { it('throws an error when updating a non-existent object', async function () { - expect(() => storage.update('nonexistent', (r) => ({ ...r, value: 99 }))) + expect(() => storage.update('nonexistent', r => ({ ...r, value: 99 }))) .to.throw(Error, "Record 'nonexistent' does not exist"); }); @@ -71,7 +71,7 @@ describe('SqliteObjectStorage', function () { let retrieved = storage.get('0004'); expect(retrieved).to.deep.equal({ name: 'Created', value: 1 }); - storage.updateEnforcingNew('0004', (r) => ({ ...r!, value: 100 })); + storage.updateEnforcingNew('0004', r => ({ ...r!, value: 100 })); retrieved = storage.get('0004'); expect(retrieved).to.deep.equal({ name: 'Created', value: 100 }); diff --git a/tests/unit/sqlite/SqliteObjectView.test.ts b/tests/unit/sqlite/SqliteObjectView.test.ts index 694b0fe..3aa5de4 100644 --- a/tests/unit/sqlite/SqliteObjectView.test.ts +++ b/tests/unit/sqlite/SqliteObjectView.test.ts @@ -15,7 +15,7 @@ describe('SqliteObjectView', function () { projectionName: 'test', tableNamePrefix: 'tbl_test', schemaVersion: '1' - }) + }); }); describe('get', () => { diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts index 4ce335f..9c868ca 100644 --- a/tests/unit/sqlite/SqliteViewLocker.test.ts +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -81,14 +81,14 @@ describe('SqliteViewLocker', function () { it('prolongs the lock while active', async function () { await firstLock.lock(); - const initial = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + const initial = viewModelSqliteDb.prepare('SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?') .get('test', '1.0') as any; expect(initial).to.have.property('locked_till').that.is.gt(Date.now()); await jest.advanceTimersByTimeAsync(viewLockTtl); - const updated = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + const updated = viewModelSqliteDb.prepare('SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?') .get('test', '1.0') as any; expect(updated).to.have.property('locked_till').that.is.gt(initial.locked_till); @@ -98,7 +98,7 @@ describe('SqliteViewLocker', function () { await firstLock.lock(); firstLock.unlock(); - const row = viewModelSqliteDb.prepare(`SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?`) + const row = viewModelSqliteDb.prepare('SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?') .get('test', '1.0') as any; expect(row.locked_till).to.be.null; From 109c022d0cdfad934ac2b0edbf24503eb85d41df Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 7 Apr 2025 20:49:24 +0100 Subject: [PATCH 041/169] Change RabbitMqEventInjector to subscribe to fanout messages instead of a named queue --- src/rabbitmq/RabbitMqEventBus.ts | 3 +- src/rabbitmq/RabbitMqEventInjector.ts | 22 +++++--------- src/rabbitmq/constants.ts | 1 + .../rabbitmq/RabbitMqEventInjector.test.ts | 30 +------------------ 4 files changed, 12 insertions(+), 44 deletions(-) create mode 100644 src/rabbitmq/constants.ts diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 130c43f..a707779 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,4 +1,5 @@ import { IEvent, IEventBus, IMessageHandler, IObservable } from '../interfaces'; +import { DEFAULT_EXCHANGE } from './constants'; import { RabbitMqGateway } from './RabbitMqGateway'; const ALL_EVENTS_WILDCARD = '*'; @@ -20,7 +21,7 @@ export class RabbitMqEventBus implements IEventBus { queueName?: string }) { this.#gateway = o.rabbitMqGateway; - this.#exchange = o.exchange ?? 'node-cqrs.events'; + this.#exchange = o.exchange ?? DEFAULT_EXCHANGE; this.#queueName = o.queueName; } diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts index f8e4850..9bae093 100644 --- a/src/rabbitmq/RabbitMqEventInjector.ts +++ b/src/rabbitmq/RabbitMqEventInjector.ts @@ -3,6 +3,7 @@ import { IMessage } from '../interfaces/IMessage'; import { RabbitMqGateway } from './RabbitMqGateway'; import { IEventDispatcher } from '../interfaces'; import * as Event from '../Event'; +import { DEFAULT_EXCHANGE } from './constants'; export class RabbitMqEventInjector { #rabbitMqGateway: RabbitMqGateway; @@ -10,7 +11,6 @@ export class RabbitMqEventInjector { #logger: IContainer['logger']; #exchangeName: string; - #queueName: string; #messageHandler: (message: IMessage) => Promise; constructor(container: Partial> & { @@ -29,32 +29,26 @@ export class RabbitMqEventInjector { container.logger.child({ service: new.target.name }) : container.logger; - this.#exchangeName = container.exchange ?? 'node-cqrs.events'; - this.#queueName = container.queueName ?? 'node-cqrs.persistence'; + this.#exchangeName = container.exchange ?? DEFAULT_EXCHANGE; this.#messageHandler = this.#handleMessage.bind(this); this.start(); } async start(): Promise { - this.#logger?.info(`Starting event injection from queue "${this.#queueName}"`); + this.#logger?.debug(`Subscribing to messages from exchange "${this.#exchangeName}"...`); - await this.#rabbitMqGateway.subscribeToQueue( - this.#exchangeName, - this.#queueName, - this.#messageHandler - ); + await this.#rabbitMqGateway.subscribeToFanout(this.#exchangeName, this.#messageHandler); - this.#logger?.info(`Subscribed to queue "${this.#queueName}" on exchange "${this.#exchangeName}"`); + this.#logger?.debug(`Listening to messages from exchange "${this.#exchangeName}"`); } async #handleMessage(message: IMessage): Promise { - this.#logger?.debug(`Received message from queue "${this.#queueName}": ${message.type}`); + this.#logger?.debug(`Received "${Event.describe(message)}" message from exchange "${this.#exchangeName}"`); try { - // EventDispatcher expects an array of events (IEventSet) - // Assuming IMessage is compatible with IEvent or needs transformation await this.#eventDispatcher.dispatch([message]); - this.#logger?.debug(`Event ${Event.describe(message)} dispatched successfully`); + + this.#logger?.debug(`${Event.describe(message)} dispatched successfully`); } catch (error: any) { this.#logger?.error(`Failed to dispatch event ${message.type}: ${error.message}`, { stack: error.stack }); diff --git a/src/rabbitmq/constants.ts b/src/rabbitmq/constants.ts new file mode 100644 index 0000000..d303442 --- /dev/null +++ b/src/rabbitmq/constants.ts @@ -0,0 +1 @@ +export const DEFAULT_EXCHANGE = 'node-cqrs.events'; diff --git a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts index f111718..28da91b 100644 --- a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts +++ b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts @@ -10,8 +10,6 @@ describe('RabbitMqEventInjector', () => { let eventDispatcher: jest.Mocked; const exchange = 'node-cqrs.events'; - const queueName = 'test-injector-queue'; - const deadLetterQueueName = `${queueName}.failed`; const eventType = 'test-injector-event'; beforeEach(async () => { @@ -26,7 +24,6 @@ describe('RabbitMqEventInjector', () => { const injector = new RabbitMqEventInjector({ rabbitMqGateway, eventDispatcher, - queueName, exchange }); @@ -37,8 +34,6 @@ describe('RabbitMqEventInjector', () => { try { const ch = await rabbitMqGateway.connection?.createChannel(); if (ch) { - await ch.deleteQueue(queueName); - await ch.deleteQueue(`${queueName}.failed`); await ch.deleteExchange(exchange); await ch.close(); } @@ -51,7 +46,7 @@ describe('RabbitMqEventInjector', () => { } }); - it('receives a message from the queue and dispatch it via EventDispatcher', async () => { + it('receives messages and dispatches them via EventDispatcher', async () => { const testEvent: IEvent = { type: eventType, payload: { data: 'test-payload' }, @@ -65,27 +60,4 @@ describe('RabbitMqEventInjector', () => { expect(eventDispatcher.dispatch).toHaveBeenCalledTimes(1); expect(eventDispatcher.dispatch).toHaveBeenCalledWith([testEvent]); }); - - it('handles errors during event dispatch and nack the message', async () => { - const testEvent: IEvent = { - type: 'error-event', - payload: { data: 'trigger-error' }, - id: 'error-id-456' - }; - const dispatchError = new Error('Dispatch failed'); - eventDispatcher.dispatch.mockRejectedValueOnce(dispatchError); - - // Publish the event - await rabbitMqGateway.publish(exchange, testEvent); - - await delay(100); - - const ch = await rabbitMqGateway.connection!.createChannel(); - const deadLetterMessage = await ch.get(deadLetterQueueName, { noAck: true }); - if (!deadLetterMessage) - throw new Error('Dead letter message not found'); - - const messageContent = JSON.parse(deadLetterMessage.content.toString()); - expect(messageContent).toEqual(testEvent); - }); }); From ea5682a18afb6e08bc835c6f3e0f89453f1b02ef Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 8 Apr 2025 16:34:47 +0100 Subject: [PATCH 042/169] Fix eslint --- eslint.config.mjs | 3 ++- src/interfaces/IContainer.ts | 1 - 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/eslint.config.mjs b/eslint.config.mjs index b000df0..fe2f193 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -16,7 +16,8 @@ export default defineConfig([ languageOptions: { parser: tsParser, globals: { - ...globals.node + ...globals.node, + NodeJS: true } }, plugins: { diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index 7110fa6..770b8af 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -23,6 +23,5 @@ export interface IContainer extends Container { logger?: ILogger | IExtendableLogger; - // eslint-disable-next-line no-undef process?: NodeJS.Process } From 948bb977153566442d0acf433706c91793d781c5 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 8 Apr 2025 16:39:50 +0100 Subject: [PATCH 043/169] Enhance RabbitMqGateway with detailed subscription management and error handling --- src/rabbitmq/RabbitMqGateway.ts | 69 +++++++++++++++++++++++++++------ 1 file changed, 57 insertions(+), 12 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index fad8d2f..f231883 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -13,13 +13,29 @@ const getRandomAppId = () => `${Date.now().toString(36).slice(-4)}.${Math.random().toString(36).slice(2, 6)}`.toUpperCase(); type MessageHandler = (m: IMessage) => Promise | unknown; + +/** + * Represents a subscription to events from a RabbitMQ exchange. + */ type Subscription = { - exchange: string, - queueName?: string, - eventType?: string, - handler: MessageHandler, - ignoreOwn?: boolean, - concurrentLimit?: number + + /** Name of the exchange to subscribe to */ + exchange: string; + + /** Optional durable queue name; if omitted, an exclusive temporary queue is used */ + queueName?: string; + + /** Specific event type (routing key) for filtering, defaults to all if omitted */ + eventType?: string; + + /** Callback function to process received messages */ + handler: MessageHandler; + + /** If true, messages originating from this instance are ignored */ + ignoreOwn?: boolean; + + /** Optional limit for concurrent message handling */ + concurrentLimit?: number; }; const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); @@ -176,7 +192,26 @@ export class RabbitMqGateway { return this.subscribe({ exchange, handler, ignoreOwn: true }); } + /** + * Subscribes to events from a specified exchange. + * + * This method sets up the necessary RabbitMQ topology (exchange, queue, bindings) based on the provided details. + * If a `queueName` is provided, it asserts a durable queue with a dead-letter queue for failed messages. + * If `queueName` is omitted, it uses or creates a temporary, exclusive queue for the connection. + * Then it starts consuming messages from the queue with the specified concurrency limit, if specified. + * + * @param subscription - The subscription details. + * @param subscription.exchange - The name of the exchange to subscribe to. + * @param subscription.queueName - Optional. The name of the durable queue. If omitted, an exclusive queue is used. + * @param subscription.eventType - The routing key or pattern to bind the queue with. + * @param subscription.concurrentLimit - Optional. The maximum number of concurrent messages to process. + * @returns A promise that resolves when the subscription is successfully set up. + */ async subscribe(subscription: Subscription) { + const subscriptionExists = !!this.#findSubscription(subscription); + if (subscriptionExists) + throw new Error('Subscription already exists'); + const { exchange, queueName, @@ -218,12 +253,22 @@ export class RabbitMqGateway { this.#subscriptions.push({ ...subscription, queueGivenName }); } - async unsubscribe(d: Subscription) { - this.#subscriptions = this.#subscriptions.filter(s => !( - s.exchange === d.exchange && - s.queueName === d.queueName && - s.eventType === d.eventType && - s.handler === d.handler)); + #findSubscription(subscription: Pick) { + return this.#subscriptions.find(s => + s.exchange === subscription.exchange && + s.queueName === subscription.queueName && + s.eventType === subscription.eventType && + s.handler === subscription.handler); + } + + async unsubscribe(subscription: Pick) { + const subscriptionToRemove = this.#findSubscription(subscription); + if (!subscriptionToRemove) + throw new Error('Such subscription does not exist'); + + this.#subscriptions = this.#subscriptions.filter(s => s !== subscriptionToRemove); + + await this.#tryDropConsumer(subscriptionToRemove.queueGivenName); } async #assertConnection() { From e523cf276b5202b78104e1a816350fc701b7bf3f Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 8 Apr 2025 16:41:41 +0100 Subject: [PATCH 044/169] Implement graceful shutdown handling in RabbitMqGateway --- src/rabbitmq/RabbitMqGateway.ts | 89 +++++++++---- src/rabbitmq/TerminationHandler.ts | 29 +++++ src/rabbitmq/constants.ts | 1 + .../rabbitmq/RabbitMqGateway.test.ts | 121 +++++++++++++++++- 4 files changed, 213 insertions(+), 27 deletions(-) create mode 100644 src/rabbitmq/TerminationHandler.ts diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index f231883..48121b6 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,12 +1,9 @@ import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; -import { - IContainer, - ILogger, - IMessage, - isMessage -} from '../interfaces'; +import { IContainer, ILogger, IMessage, isMessage } from '../interfaces'; import * as Event from '../Event'; import { delay } from '../utils'; +import { HANDLER_PROCESS_TIMEOUT } from './constants'; +import { TerminationHandler } from './TerminationHandler'; /** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ const getRandomAppId = () => @@ -64,14 +61,13 @@ export class RabbitMqGateway { #subscriptions: Array = []; #handlers: Map>> = new Map(); + /** Handles termination signals for graceful shutdown */ + #terminationHandler: TerminationHandler | undefined; + get connection() { return this.#connection; } - get channel() { - return this.#pubChannel; - } - constructor(o: Partial> & { rabbitMqConnectionFactory?: () => Promise }) { @@ -85,9 +81,19 @@ export class RabbitMqGateway { o.logger; if (o.process) - o.process.on('SIGINT', () => this.#stopConsuming()); + this.#terminationHandler = new TerminationHandler(o.process, () => this.#stopConsuming()); } + /** + * Establishes a connection to RabbitMQ. + * If a connection attempt is already in progress, it waits for it to complete. + * If the connection is lost, it attempts to reconnect automatically. + * Upon successful connection, it restores any previously active subscriptions. + * + * This method is called automatically by other methods if a connection is required but not yet established. + * + * @returns A promise that resolves with the ChannelModel representing the established connection. + */ async connect(): Promise { while (this.#connecting) await delay(1_000); @@ -342,19 +348,31 @@ export class RabbitMqGateway { if (!msg) return; - const { consumerTag, routingKey } = msg.fields; - const { appId, messageId, correlationId } = msg.properties; + const { consumerTag, routingKey } = msg.fields ?? {}; + const { messageId, correlationId, appId } = msg.properties ?? {}; - this.#logger?.debug(`${this.#appId}: Message received`, { - queueName: queueGivenName, - consumerTag, - routingKey, - messageId, - correlationId, - appId - }); + // Keep the process alive while waiting for the handler to finish + const keepAliveTimeout = setTimeout(() => { + this.#logger?.warn(`${this.#appId}: Message processing timed out`, { + queueName: queueGivenName, + consumerTag, + routingKey, + messageId + }); + channel.nack(msg, false, false); + }, HANDLER_PROCESS_TIMEOUT); try { + + this.#logger?.debug(`${this.#appId}: Message received`, { + queueName: queueGivenName, + consumerTag, + routingKey, + messageId, + correlationId, + appId + }); + const jsonContent = msg.content.toString(); const message: IMessage = JSON.parse(jsonContent); @@ -377,6 +395,9 @@ export class RabbitMqGateway { // Redirect message to dead letter queue, if `{ noAck: true }` was not set on consumption channel?.nack(msg, false, false); } + finally { + clearTimeout(keepAliveTimeout); + } }); this.#logger?.debug(`${this.#appId}: Consumer "${c.consumerTag}" registered on queue "${queueGivenName}"`); @@ -385,6 +406,25 @@ export class RabbitMqGateway { channel, consumerTag: c.consumerTag }); + + this.#terminationHandler?.on(); + } + + async #tryDropConsumer(queueGivenName: string) { + const queueStillUsed = this.#subscriptions.some(s => s.queueGivenName === queueGivenName); + if (queueStillUsed) + return; + + const consumer = this.#queueConsumers.get(queueGivenName); + if (!consumer) + return; + + this.#queueConsumers.delete(queueGivenName); + await consumer.channel.cancel(consumer.consumerTag); + + // If no consumers are active anymore, disable the termination handler + if (!this.#queueConsumers.size) + this.#terminationHandler?.off(); } /** @@ -419,7 +459,12 @@ export class RabbitMqGateway { }; return new Promise((resolve, reject) => { - const published = this.#pubChannel!.publish(exchange, message.type, content, properties, err => + if (!this.#pubChannel) + throw new Error(`${this.#appId}: No channel available for publishing`); + + this.#logger?.debug(`${this.#appId}: Publishing message "${Event.describe(message)}" to exchange "${exchange}"`); + + const published = this.#pubChannel.publish(exchange, message.type, content, properties, err => (err ? reject(err) : resolve())); if (!published) throw new Error(`${this.#appId}: Failed to send event ${Event.describe(message)}, channel buffer is full`); diff --git a/src/rabbitmq/TerminationHandler.ts b/src/rabbitmq/TerminationHandler.ts new file mode 100644 index 0000000..5ba3e64 --- /dev/null +++ b/src/rabbitmq/TerminationHandler.ts @@ -0,0 +1,29 @@ +/** + * Handles graceful termination of a Node.js process. + * Listens for SIGINT and executes a cleanup routine before allowing the process to exit. + */ +export class TerminationHandler { + + #process: NodeJS.Process; + #cleanupHandler: () => Promise; + #terminationHandler: () => Promise; + + constructor(process: NodeJS.Process, cleanupHandler: () => Promise) { + this.#process = process; + this.#cleanupHandler = cleanupHandler; + this.#terminationHandler = this.#onProcessTermination.bind(this); + } + + on() { + this.#process.on('SIGINT', this.#terminationHandler); + } + + off() { + this.#process.off('SIGINT', this.#terminationHandler); + } + + async #onProcessTermination() { + await this.#cleanupHandler(); + this.off(); + } +} diff --git a/src/rabbitmq/constants.ts b/src/rabbitmq/constants.ts index d303442..2f3a455 100644 --- a/src/rabbitmq/constants.ts +++ b/src/rabbitmq/constants.ts @@ -1 +1,2 @@ export const DEFAULT_EXCHANGE = 'node-cqrs.events'; +export const HANDLER_PROCESS_TIMEOUT = 60 * 60 * 1000; // 1 hour diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index 12ec6fa..51c5dc5 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -14,13 +14,16 @@ describe('RabbitMqGateway', () => { const queueName = 'test-queue'; const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); + let process: EventEmitter; + beforeEach(async () => { + // const logger = console; const logger = undefined; - // const logger = console; - gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); - gateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); - gateway3 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger }); + process = new EventEmitter(); + gateway1 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger, process: process as NodeJS.Process }); + gateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger, process: process as NodeJS.Process }); + gateway3 = new RabbitMqGateway({ rabbitMqConnectionFactory, logger, process: process as NodeJS.Process }); }); afterEach(async () => { @@ -115,7 +118,6 @@ describe('RabbitMqGateway', () => { expect(received1).toHaveLength(1); expect(received2).toHaveLength(1); }); - }); describe('subscribeToQueue', () => { @@ -271,6 +273,115 @@ describe('RabbitMqGateway', () => { }); }); + describe('unsubscribe', () => { + + it('removes subscription so handler does not receive further events', async () => { + + const received: IMessage[] = []; + const handler = (msg: IMessage) => { + received.push(msg); + }; + const event1 = { + type: 'test.unsubscribe', + payload: { info: 'first event' }, + context: { ts: Date.now() } + }; + + // Subscribe to a durable queue + await gateway1.subscribeToQueue(exchange, queueName, handler); + + // Publish an event and verify handler is invoked + await gateway1.publish(exchange, event1); + await delay(50); + + expect(received).toEqual([event1]); + + await gateway1.unsubscribe({ exchange, queueName, handler }); + + // Clear received messages + received.length = 0; + expect(received).toEqual([]); + + // Publish a second event; handler should not be invoked + await gateway1.publish(exchange, event1); + await delay(50); + + expect(received).toEqual([]); + }); + + it('cancels consumer when unsubscribing the last subscription on a queue', async () => { + + const processOnSpy = jest.spyOn(process, 'on'); + const processOffSpy = jest.spyOn(process, 'off'); + + const received1: IMessage[] = []; + const received2: IMessage[] = []; + + const handler1 = (msg: IMessage) => { + received1.push(msg); + }; + const handler2 = (msg: IMessage) => { + received2.push(msg); + }; + + const event1 = { + type: 'test.unsubscribe', + payload: { info: 'event for handler2' }, + context: { ts: Date.now() } + }; + + // Subscribe both handlers to the same durable queue + await gateway1.subscribe({ + exchange, + eventType: event1.type, + handler: handler1 + }); + await gateway1.subscribe({ + exchange, + eventType: event1.type, + handler: handler2 + }); + + expect(processOnSpy).toHaveBeenCalledWith('SIGINT', expect.any(Function)); + expect(processOnSpy).toHaveBeenCalledTimes(1); + expect(processOffSpy).not.toHaveBeenCalled(); + + // Unsubscribe one handler; the queue should still be active + await gateway1.unsubscribe({ + exchange, + eventType: event1.type, + handler: handler1 + }); + + expect(processOffSpy).not.toHaveBeenCalled(); + + // Publish an event; only handler2 should receive it + + await gateway1.publish(exchange, event1); + await delay(50); + + expect(received1).toEqual([]); + expect(received2).toEqual([event1]); + + // Now unsubscribe the last handler; this should cancel the consumer for the queue + await gateway1.unsubscribe({ + exchange, + eventType: event1.type, + handler: handler2 + }); + + expect(processOffSpy).toHaveBeenCalledWith('SIGINT', expect.any(Function)); + + // Publish a second event; no handler should receive it because the consumer is cancelled + received2.length = 0; + + await gateway1.publish(exchange, event1); + await delay(50); + + expect(received1).toEqual([]); + }); + }); + describe('connect()', () => { it('retains subscriptions after reconnect', async () => { From dea0f4b889bb7931f3147ac2e10072dd9ebdc853 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 8 Apr 2025 17:08:23 +0100 Subject: [PATCH 045/169] Refactor RabbitMqEventInjector to improve message handling and logging --- src/rabbitmq/RabbitMqEventInjector.ts | 39 +++++++++------- .../rabbitmq/RabbitMqEventInjector.test.ts | 45 ++++++++++--------- 2 files changed, 47 insertions(+), 37 deletions(-) diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts index 9bae093..ddeb713 100644 --- a/src/rabbitmq/RabbitMqEventInjector.ts +++ b/src/rabbitmq/RabbitMqEventInjector.ts @@ -5,46 +5,53 @@ import { IEventDispatcher } from '../interfaces'; import * as Event from '../Event'; import { DEFAULT_EXCHANGE } from './constants'; +/** + * Injects events received from a RabbitMQ exchange into the local event dispatcher. + * + * It subscribes to a specified fanout exchange on RabbitMQ and dispatches + * any received messages as events using the provided event dispatcher. + */ export class RabbitMqEventInjector { #rabbitMqGateway: RabbitMqGateway; + #messageHandler: (message: IMessage) => Promise; #eventDispatcher: IEventDispatcher; #logger: IContainer['logger']; - #exchangeName: string; - #messageHandler: (message: IMessage) => Promise; - - constructor(container: Partial> & { - exchange?: string; - queueName?: string; - }) { + constructor(container: Partial>) { if (!container.eventDispatcher) throw new Error('eventDispatcher is required in the container.'); if (!container.rabbitMqGateway) throw new Error('rabbitMqGateway is required in the container.'); this.#rabbitMqGateway = container.rabbitMqGateway; + this.#messageHandler = (msg: IMessage) => this.#handleMessage(msg); this.#eventDispatcher = container.eventDispatcher; - this.#logger = container.logger && 'child' in container.logger ? container.logger.child({ service: new.target.name }) : container.logger; + } + + async start(exchange: string = DEFAULT_EXCHANGE): Promise { + this.#logger?.debug(`Subscribing to messages from exchange "${exchange}"...`); - this.#exchangeName = container.exchange ?? DEFAULT_EXCHANGE; - this.#messageHandler = this.#handleMessage.bind(this); + await this.#rabbitMqGateway.subscribeToFanout(exchange, this.#messageHandler); - this.start(); + this.#logger?.debug(`Listening to messages from exchange "${exchange}"`); } - async start(): Promise { - this.#logger?.debug(`Subscribing to messages from exchange "${this.#exchangeName}"...`); + async stop(exchange: string = DEFAULT_EXCHANGE): Promise { + this.#logger?.debug(`Unsubscribing from messages from exchange "${exchange}"...`); - await this.#rabbitMqGateway.subscribeToFanout(this.#exchangeName, this.#messageHandler); + await this.#rabbitMqGateway.unsubscribe({ + exchange, + handler: this.#messageHandler + }); - this.#logger?.debug(`Listening to messages from exchange "${this.#exchangeName}"`); + this.#logger?.debug(`Stopped listening to messages from exchange "${exchange}"`); } async #handleMessage(message: IMessage): Promise { - this.#logger?.debug(`Received "${Event.describe(message)}" message from exchange "${this.#exchangeName}"`); + this.#logger?.debug(`"${Event.describe(message)}" received`); try { await this.#eventDispatcher.dispatch([message]); diff --git a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts index 28da91b..1946dad 100644 --- a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts +++ b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts @@ -7,6 +7,7 @@ import { delay } from '../../../src/utils'; describe('RabbitMqEventInjector', () => { let rabbitMqGateway: RabbitMqGateway; + let rabbitMqGateway2: RabbitMqGateway; let eventDispatcher: jest.Mocked; const exchange = 'node-cqrs.events'; @@ -15,38 +16,26 @@ describe('RabbitMqEventInjector', () => { beforeEach(async () => { const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); rabbitMqGateway = new RabbitMqGateway({ rabbitMqConnectionFactory }); + rabbitMqGateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory }); eventDispatcher = { dispatch: jest.fn().mockResolvedValue(undefined) } as unknown as jest.Mocked; - // eslint-disable-next-line @typescript-eslint/no-unused-vars - const injector = new RabbitMqEventInjector({ - rabbitMqGateway, - eventDispatcher, - exchange - }); + const injector = new RabbitMqEventInjector({ rabbitMqGateway, eventDispatcher }); - await delay(50); // Allow time for subscription setup + await injector.start(exchange); }); afterEach(async () => { - try { - const ch = await rabbitMqGateway.connection?.createChannel(); - if (ch) { - await ch.deleteExchange(exchange); - await ch.close(); - } - } - catch (error) { - console.warn('Error during RabbitMQ cleanup:', error); - } - finally { - await rabbitMqGateway.disconnect(); - } + const ch = await rabbitMqGateway.connection?.createChannel(); + await ch.deleteExchange(exchange); + await ch.close(); + await rabbitMqGateway.disconnect(); + await rabbitMqGateway2.disconnect(); }); - it('receives messages and dispatches them via EventDispatcher', async () => { + it('does not receive messages published to own gateway', async () => { const testEvent: IEvent = { type: eventType, payload: { data: 'test-payload' }, @@ -57,6 +46,20 @@ describe('RabbitMqEventInjector', () => { await delay(50); + expect(eventDispatcher.dispatch).not.toHaveBeenCalled(); + }); + + it('receives messages published to other gateway, dispatches to eventDispatcher', async () => { + const testEvent: IEvent = { + type: eventType, + payload: { data: 'test-payload' }, + id: 'test-id-123' + }; + + await rabbitMqGateway2.publish(exchange, testEvent); + + await delay(50); + expect(eventDispatcher.dispatch).toHaveBeenCalledTimes(1); expect(eventDispatcher.dispatch).toHaveBeenCalledWith([testEvent]); }); From cae8e8140fe31cd24df6c650e7e377767f945a43 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 8 Apr 2025 17:47:38 +0100 Subject: [PATCH 046/169] Refactor TerminationHandler to use 'once' for signal handling and ensure cleanup occurs after deregistration --- src/rabbitmq/TerminationHandler.ts | 6 ++++-- tests/integration/rabbitmq/RabbitMqGateway.test.ts | 5 +++-- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/src/rabbitmq/TerminationHandler.ts b/src/rabbitmq/TerminationHandler.ts index 5ba3e64..f5e63f3 100644 --- a/src/rabbitmq/TerminationHandler.ts +++ b/src/rabbitmq/TerminationHandler.ts @@ -15,15 +15,17 @@ export class TerminationHandler { } on() { - this.#process.on('SIGINT', this.#terminationHandler); + this.#process.once('SIGINT', this.#terminationHandler); + this.#process.once('SIGTERM', this.#terminationHandler); } off() { this.#process.off('SIGINT', this.#terminationHandler); + this.#process.off('SIGTERM', this.#terminationHandler); } async #onProcessTermination() { - await this.#cleanupHandler(); this.off(); + await this.#cleanupHandler(); } } diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index 51c5dc5..c1f15bb 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -311,7 +311,7 @@ describe('RabbitMqGateway', () => { it('cancels consumer when unsubscribing the last subscription on a queue', async () => { - const processOnSpy = jest.spyOn(process, 'on'); + const processOnSpy = jest.spyOn(process, 'once'); const processOffSpy = jest.spyOn(process, 'off'); const received1: IMessage[] = []; @@ -343,7 +343,8 @@ describe('RabbitMqGateway', () => { }); expect(processOnSpy).toHaveBeenCalledWith('SIGINT', expect.any(Function)); - expect(processOnSpy).toHaveBeenCalledTimes(1); + expect(processOnSpy).toHaveBeenCalledWith('SIGTERM', expect.any(Function)); + expect(processOnSpy).toHaveBeenCalledTimes(2); expect(processOffSpy).not.toHaveBeenCalled(); // Unsubscribe one handler; the queue should still be active From 34659dfce032e6962181e6ba6cf8a76345e92094 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 10 Apr 2025 20:22:56 +0100 Subject: [PATCH 047/169] Make SQLite locker and storage classes async to support async DB initialization --- src/in-memory/InMemoryLock.ts | 2 +- src/in-memory/index.ts | 1 - src/in-memory/utils/index.ts | 1 - src/sqlite/AbstractSqliteAccessor.ts | 55 ++++++ src/sqlite/AbstractSqliteObjectProjection.ts | 10 +- src/sqlite/AbstractSqliteView.ts | 10 +- src/sqlite/IContainer.ts | 8 + src/sqlite/SqliteEventLocker.ts | 54 ++--- src/sqlite/SqliteObjectStorage.ts | 87 +++++--- src/sqlite/SqliteObjectView.ts | 41 +--- ...arams.ts => SqliteProjectionDataParams.ts} | 8 - src/sqlite/SqliteViewLocker.ts | 18 +- src/sqlite/index.ts | 2 + src/{in-memory => }/utils/Deferred.ts | 0 src/utils/Lock.ts | 53 +++++ src/utils/index.ts | 2 + tests/unit/Lock.test.ts | 185 ++++++++++++++++++ tests/unit/SagaEventHandler.test.ts | 2 +- tests/unit/sqlite/SqliteEventLocker.test.ts | 75 ++++--- tests/unit/sqlite/SqliteObjectStorage.test.ts | 48 ++--- 20 files changed, 483 insertions(+), 179 deletions(-) create mode 100644 src/sqlite/AbstractSqliteAccessor.ts create mode 100644 src/sqlite/IContainer.ts rename src/sqlite/{commonParams.ts => SqliteProjectionDataParams.ts} (75%) rename src/{in-memory => }/utils/Deferred.ts (100%) create mode 100644 src/utils/Lock.ts create mode 100644 tests/unit/Lock.test.ts diff --git a/src/in-memory/InMemoryLock.ts b/src/in-memory/InMemoryLock.ts index 84456bd..8b853d1 100644 --- a/src/in-memory/InMemoryLock.ts +++ b/src/in-memory/InMemoryLock.ts @@ -1,4 +1,4 @@ -import { Deferred } from './utils'; +import { Deferred } from '../utils'; export class InMemoryLock { diff --git a/src/in-memory/index.ts b/src/in-memory/index.ts index 3f6f779..3ef457a 100644 --- a/src/in-memory/index.ts +++ b/src/in-memory/index.ts @@ -3,4 +3,3 @@ export * from './InMemoryLock'; export * from './InMemoryMessageBus'; export * from './InMemorySnapshotStorage'; export * from './InMemoryView'; -export * from './utils/Deferred'; diff --git a/src/in-memory/utils/index.ts b/src/in-memory/utils/index.ts index 3622022..d504dca 100644 --- a/src/in-memory/utils/index.ts +++ b/src/in-memory/utils/index.ts @@ -1,2 +1 @@ -export * from './Deferred'; export * from './nextCycle'; diff --git a/src/sqlite/AbstractSqliteAccessor.ts b/src/sqlite/AbstractSqliteAccessor.ts new file mode 100644 index 0000000..23c009c --- /dev/null +++ b/src/sqlite/AbstractSqliteAccessor.ts @@ -0,0 +1,55 @@ +import { IContainer } from '../interfaces'; +import { Lock } from '../utils'; +import { Database } from 'better-sqlite3'; + +/** + * Abstract base class for accessing a SQLite database. + * + * Manages the database connection lifecycle, ensuring initialization via `assertDb`. + * Supports providing a database instance directly or a factory function for lazy initialization. + * + * Subclasses must implement the `initialize` method for specific setup tasks. + */ +export abstract class AbstractSqliteAccessor { + + protected db: Database | undefined; + #dbFactory: (() => Promise | Database) | undefined; + #initLocker = new Lock(); + #initialized = false; + + constructor(c: Pick) { + if (!c.viewModelSqliteDb && !c.viewModelSqliteDbFactory) + throw new TypeError('either viewModelSqliteDb or viewModelSqliteDbFactory argument required'); + + this.db = c.viewModelSqliteDb; + this.#dbFactory = c.viewModelSqliteDbFactory; + } + + protected abstract initialize(db: Database): Promise | void; + + /** + * Ensures that the database connection is initialized. + * Uses a lock to prevent race conditions during concurrent initialization attempts. + * If the database is not already initialized, it creates the database connection + * using the provided factory and calls the `initialize` method. + * + * This method is idempotent and safe to call multiple times. + */ + async assertConnection() { + try { + 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(); + } + } +} diff --git a/src/sqlite/AbstractSqliteObjectProjection.ts b/src/sqlite/AbstractSqliteObjectProjection.ts index 3cb996c..acc3c2b 100644 --- a/src/sqlite/AbstractSqliteObjectProjection.ts +++ b/src/sqlite/AbstractSqliteObjectProjection.ts @@ -1,6 +1,5 @@ import { AbstractProjection } from '../AbstractProjection'; -import { IExtendableLogger } from '../interfaces'; -import { SqliteDbParams } from './commonParams'; +import { IContainer } from '../interfaces'; import { SqliteObjectView } from './SqliteObjectView'; export abstract class AbstractSqliteObjectProjection extends AbstractProjection> { @@ -13,13 +12,18 @@ export abstract class AbstractSqliteObjectProjection extends AbstractProjecti throw new Error('schemaVersion is not defined'); } - constructor({ viewModelSqliteDb, logger }: SqliteDbParams & { logger?: IExtendableLogger }) { + constructor({ viewModelSqliteDb, viewModelSqliteDbFactory, logger }: Pick) { super({ logger }); this.view = new SqliteObjectView({ schemaVersion: new.target.schemaVersion, projectionName: new.target.name, viewModelSqliteDb, + viewModelSqliteDbFactory, tableNamePrefix: new.target.tableName, logger }); diff --git a/src/sqlite/AbstractSqliteView.ts b/src/sqlite/AbstractSqliteView.ts index 697ec15..63b26dd 100644 --- a/src/sqlite/AbstractSqliteView.ts +++ b/src/sqlite/AbstractSqliteView.ts @@ -1,11 +1,9 @@ -import { IEvent, IEventLocker, ILogger, IViewLocker } from '../interfaces'; -import { Database } from 'better-sqlite3'; +import { IContainer, IEvent, IEventLocker, ILogger, IViewLocker } from '../interfaces'; import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { - protected readonly db: Database; protected readonly schemaVersion: string; protected readonly viewLocker: SqliteViewLocker; protected readonly eventLocker: SqliteEventLocker; @@ -15,8 +13,10 @@ export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { return this.viewLocker.ready; } - constructor(options: SqliteEventLockerParams & SqliteViewLockerParams) { - this.db = options.viewModelSqliteDb; + constructor(options: Pick + & SqliteEventLockerParams + & SqliteViewLockerParams) { + this.schemaVersion = options.schemaVersion; this.viewLocker = new SqliteViewLocker(options); this.eventLocker = new SqliteEventLocker(options); diff --git a/src/sqlite/IContainer.ts b/src/sqlite/IContainer.ts new file mode 100644 index 0000000..f24f6d6 --- /dev/null +++ b/src/sqlite/IContainer.ts @@ -0,0 +1,8 @@ +import { Database } from 'better-sqlite3'; + +declare module '../interfaces/IContainer' { + interface IContainer { + viewModelSqliteDbFactory?: () => Promise | Database; + viewModelSqliteDb?: Database; + } +} diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index 3d26171..4322cec 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -1,11 +1,12 @@ import { Database, Statement } from 'better-sqlite3'; -import { IEvent, IEventLocker } from '../interfaces'; +import { IContainer, IEvent, IEventLocker } from '../interfaces'; import { getEventId } from './utils'; import { viewLockTableInit, eventLockTableInit } from './queries'; import { SqliteViewLockerParams } from './SqliteViewLocker'; -import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; +import { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; -export type SqliteEventLockerParams = SqliteDbParams & SqliteProjectionDataParams & { +export type SqliteEventLockerParams = SqliteProjectionDataParams & { /** * (Optional) SQLite table name where event locks are stored @@ -24,40 +25,39 @@ export type SqliteEventLockerParams = SqliteDbParams & SqliteProjectionDataParam } & Pick; -export class SqliteEventLocker implements IEventLocker { +export class SqliteEventLocker extends AbstractSqliteAccessor implements IEventLocker { - #db: Database; #projectionName: string; #schemaVersion: string; #viewLockTableName: string; #eventLockTableName: string; #eventLockTtl: number; - #upsertLastEventQuery: Statement<[string, string, string], void>; - #getLastEventQuery: Statement<[string, string], { last_event: string }>; - #lockEventQuery: Statement<[string, string, Buffer], void>; - #finalizeEventLockQuery: Statement<[string, string, Buffer], void>; + #upsertLastEventQuery!: Statement<[string, string, string], void>; + #getLastEventQuery!: Statement<[string, string], { last_event: string }>; + #lockEventQuery!: Statement<[string, string, Buffer], void>; + #finalizeEventLockQuery!: Statement<[string, string, Buffer], void>; + + constructor(o: Pick & SqliteEventLockerParams) { + super(o); - constructor(o: SqliteEventLockerParams) { - if (!o.viewModelSqliteDb) - throw new TypeError('viewModelSqliteDb argument required'); if (!o.projectionName) throw new TypeError('projectionName argument required'); if (!o.schemaVersion) throw new TypeError('schemaVersion argument required'); - this.#db = o.viewModelSqliteDb; this.#projectionName = o.projectionName; this.#schemaVersion = o.schemaVersion; this.#viewLockTableName = o.viewLockTableName ?? 'tbl_view_lock'; this.#eventLockTableName = o.eventLockTableName ?? 'tbl_event_lock'; this.#eventLockTtl = o.eventLockTtl ?? 15_000; + } + protected initialize(db: Database) { + db.exec(viewLockTableInit(this.#viewLockTableName)); + db.exec(eventLockTableInit(this.#eventLockTableName)); - this.#db.exec(viewLockTableInit(this.#viewLockTableName)); - this.#db.exec(eventLockTableInit(this.#eventLockTableName)); - - this.#upsertLastEventQuery = this.#db.prepare(` + this.#upsertLastEventQuery = db.prepare(` INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, last_event) VALUES (?, ?, ?) ON CONFLICT (projection_name, schema_version) @@ -65,7 +65,7 @@ export class SqliteEventLocker implements IEventLocker { last_event = excluded.last_event `); - this.#getLastEventQuery = this.#db.prepare(` + this.#getLastEventQuery = db.prepare(` SELECT last_event FROM ${this.#viewLockTableName} @@ -74,7 +74,7 @@ export class SqliteEventLocker implements IEventLocker { AND schema_version =? `); - this.#lockEventQuery = this.#db.prepare(` + this.#lockEventQuery = db.prepare(` INSERT INTO ${this.#eventLockTableName} (projection_name, schema_version, event_id) VALUES (?, ?, ?) ON CONFLICT (projection_name, schema_version, event_id) @@ -85,7 +85,7 @@ export class SqliteEventLocker implements IEventLocker { AND processing_at <= cast(strftime('%f', 'now') * 1000 as INTEGER) - ${this.#eventLockTtl} `); - this.#finalizeEventLockQuery = this.#db.prepare(` + this.#finalizeEventLockQuery = db.prepare(` UPDATE ${this.#eventLockTableName} SET processed_at = (cast(strftime('%f', 'now') * 1000 as INTEGER)) @@ -97,7 +97,9 @@ export class SqliteEventLocker implements IEventLocker { `); } - tryMarkAsProjecting(event: IEvent) { + async tryMarkAsProjecting(event: IEvent) { + await this.assertConnection(); + const eventId = getEventId(event); const r = this.#lockEventQuery.run(this.#projectionName, this.#schemaVersion, eventId); @@ -105,10 +107,12 @@ export class SqliteEventLocker implements IEventLocker { return r.changes !== 0; } - markAsProjected(event: IEvent) { + async markAsProjected(event: IEvent) { + await this.assertConnection(); + const eventId = getEventId(event); - const transaction = this.#db.transaction(() => { + const transaction = this.db!.transaction(() => { const updateResult = this.#finalizeEventLockQuery.run(this.#projectionName, this.#schemaVersion, eventId); if (updateResult.changes === 0) throw new Error(`Event ${event.id} could not be marked as processed`); @@ -119,7 +123,9 @@ export class SqliteEventLocker implements IEventLocker { transaction(); } - getLastEvent(): IEvent | undefined { + async getLastEvent(): Promise | undefined> { + await this.assertConnection(); + const viewInfoRecord = this.#getLastEventQuery.get(this.#projectionName, this.#schemaVersion); if (!viewInfoRecord?.last_event) return undefined; diff --git a/src/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts index b780f2c..9babd4f 100644 --- a/src/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -1,47 +1,43 @@ import { Statement, Database } from 'better-sqlite3'; import { guid } from './utils'; -import { IObjectStorage } from '../interfaces'; +import { IContainer, IObjectStorage } from '../interfaces'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; -export class SqliteObjectStorage implements IObjectStorage { +export class SqliteObjectStorage extends AbstractSqliteAccessor implements IObjectStorage { - #db: Database; #tableName: string; - #getQuery: Statement<[Buffer], { data: string, version: number }>; - #insertQuery: Statement<[Buffer, string], void>; - #updateByIdAndVersionQuery: Statement<[string, Buffer, number], void>; - #deleteQuery: Statement<[Buffer], void>; + #getQuery!: Statement<[Buffer], { data: string, version: number }>; + #insertQuery!: Statement<[Buffer, string], void>; + #updateByIdAndVersionQuery!: Statement<[string, Buffer, number], void>; + #deleteQuery!: Statement<[Buffer], void>; - constructor(o: { - viewModelSqliteDb: Database, + constructor(o: Pick & { tableName: string }) { - if (!o.viewModelSqliteDb) - throw new TypeError('viewModelSqliteDb argument required'); - if (!o.tableName) - throw new TypeError('tableName argument required'); + super(o); - this.#db = o.viewModelSqliteDb; this.#tableName = o.tableName; + } - - this.#db.exec(`CREATE TABLE IF NOT EXISTS ${this.#tableName} ( + protected initialize(db: Database) { + db.exec(`CREATE TABLE IF NOT EXISTS ${this.#tableName} ( id BLOB PRIMARY KEY, version INTEGER DEFAULT 1, data TEXT NOT NULL );`); - this.#getQuery = this.#db.prepare(` + this.#getQuery = db.prepare(` SELECT data, version FROM ${this.#tableName} WHERE id = ? `); - this.#insertQuery = this.#db.prepare(` + this.#insertQuery = db.prepare(` INSERT INTO ${this.#tableName} (id, data) VALUES (?, ?) `); - this.#updateByIdAndVersionQuery = this.#db.prepare(` + this.#updateByIdAndVersionQuery = db.prepare(` UPDATE ${this.#tableName} SET data = ?, @@ -51,13 +47,18 @@ export class SqliteObjectStorage implements IObjectStorage { AND version = ? `); - this.#deleteQuery = this.#db.prepare(` + this.#deleteQuery = db.prepare(` DELETE FROM ${this.#tableName} WHERE id = ? `); } - get(id: string): TRecord | undefined { + async get(id: string): Promise { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + await this.assertConnection(); + const r = this.#getQuery.get(guid(id)); if (!r) return undefined; @@ -65,14 +66,36 @@ export class SqliteObjectStorage implements IObjectStorage { return JSON.parse(r.data); } - create(id: string, data: TRecord) { + getSync(id: string): TRecord | undefined { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + const r = this.#getQuery.get(guid(id)); + if (!r) + return undefined; + + return JSON.parse(r.data); + } + + async create(id: string, data: TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + await this.assertConnection(); + const r = this.#insertQuery.run(guid(id), JSON.stringify(data)); if (r.changes !== 1) throw new Error(`Record '${id}' could not be created`); - } - update(id: string, update: (r: TRecord) => TRecord) { + async update(id: string, update: (r: TRecord) => TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + if (typeof update !== 'function') + throw new TypeError('update argument must be a Function'); + + await this.assertConnection(); + const gid = guid(id); const record = this.#getQuery.get(gid); if (!record) @@ -90,7 +113,14 @@ export class SqliteObjectStorage implements IObjectStorage { throw new Error(`Record '${id}' could not be updated`); } - updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + async updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + if (typeof update !== 'function') + throw new TypeError('update argument must be a Function'); + + await this.assertConnection(); + // Due to better-sqlite3 sync nature, // it's safe to get then modify within this process const record = this.#getQuery.get(guid(id)); @@ -100,7 +130,12 @@ export class SqliteObjectStorage implements IObjectStorage { this.create(id, update()); } - delete(id: string): boolean { + async delete(id: string): Promise { + if (typeof id !== 'string' || !id.length) + throw new TypeError('id argument must be a non-empty String'); + + await this.assertConnection(); + const r = this.#deleteQuery.run(guid(id)); return r.changes === 1; } diff --git a/src/sqlite/SqliteObjectView.ts b/src/sqlite/SqliteObjectView.ts index 31165f4..fee1add 100644 --- a/src/sqlite/SqliteObjectView.ts +++ b/src/sqlite/SqliteObjectView.ts @@ -16,16 +16,14 @@ export class SqliteObjectView extends AbstractSqliteView implements IOb super(options); - this.#sqliteObjectStorage = new SqliteObjectStorage({ + this.#sqliteObjectStorage = new SqliteObjectStorage({ viewModelSqliteDb: options.viewModelSqliteDb, + viewModelSqliteDbFactory: options.viewModelSqliteDbFactory, tableName: `${options.tableNamePrefix}_${options.schemaVersion}` }); } async get(id: string): Promise { - if (typeof id !== 'string' || !id.length) - throw new TypeError('id argument must be a non-empty String'); - if (!this.ready) await this.once('ready'); @@ -33,41 +31,22 @@ export class SqliteObjectView extends AbstractSqliteView implements IOb } getSync(id: string) { - if (typeof id !== 'string' || !id.length) - throw new TypeError('id argument must be a non-empty String'); - - return this.#sqliteObjectStorage.get(id); + return this.#sqliteObjectStorage.getSync(id); } - create(id: string, data: TRecord) { - if (typeof id !== 'string' || !id.length) - throw new TypeError('id argument must be a non-empty String'); - - this.#sqliteObjectStorage.create(id, data); + async create(id: string, data: TRecord) { + await this.#sqliteObjectStorage.create(id, data); } - update(id: string, update: (r: TRecord) => TRecord) { - if (typeof id !== 'string' || !id.length) - throw new TypeError('id argument must be a non-empty String'); - if (typeof update !== 'function') - throw new TypeError('update argument must be a Function'); - - this.#sqliteObjectStorage.update(id, update); + async update(id: string, update: (r: TRecord) => TRecord) { + await this.#sqliteObjectStorage.update(id, update); } - updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { - if (typeof id !== 'string' || !id.length) - throw new TypeError('id argument must be a non-empty String'); - if (typeof update !== 'function') - throw new TypeError('update argument must be a Function'); - - this.#sqliteObjectStorage.updateEnforcingNew(id, update); + async updateEnforcingNew(id: string, update: (r?: TRecord) => TRecord) { + await this.#sqliteObjectStorage.updateEnforcingNew(id, update); } - delete(id: string): boolean { - if (typeof id !== 'string' || !id.length) - throw new TypeError('id argument must be a non-empty String'); - + async delete(id: string): Promise { return this.#sqliteObjectStorage.delete(id); } } diff --git a/src/sqlite/commonParams.ts b/src/sqlite/SqliteProjectionDataParams.ts similarity index 75% rename from src/sqlite/commonParams.ts rename to src/sqlite/SqliteProjectionDataParams.ts index f26118e..24c721e 100644 --- a/src/sqlite/commonParams.ts +++ b/src/sqlite/SqliteProjectionDataParams.ts @@ -1,11 +1,3 @@ -import { Database } from 'better-sqlite3'; - -export type SqliteDbParams = { - - /** Configured instance of better-sqlite3.Database */ - viewModelSqliteDb: Database; -}; - export type SqliteProjectionDataParams = { /** diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index 9907aee..12efe5d 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -1,12 +1,12 @@ import { Database, Statement } from 'better-sqlite3'; -import { IExtendableLogger, ILogger, IViewLocker } from '../interfaces'; -import { Deferred } from '../in-memory'; +import { IContainer, ILogger, IViewLocker } from '../interfaces'; +import { Deferred } from '../utils'; import { promisify } from 'util'; import { viewLockTableInit } from './queries'; -import { SqliteDbParams, SqliteProjectionDataParams } from './commonParams'; +import { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; const delay = promisify(setTimeout); -export type SqliteViewLockerParams = SqliteDbParams & SqliteProjectionDataParams & { +export type SqliteViewLockerParams = SqliteProjectionDataParams & { /** * (Optional) SQLite table name where event locks along with the latest event are stored @@ -21,13 +21,6 @@ export type SqliteViewLockerParams = SqliteDbParams & SqliteProjectionDataParams * @default 120_000 */ viewLockTtl?: number; - - /** - * (Optional) Logger instance for logging operations, - * can be an IExtendableLogger (Winston) - * or ILogger (Console) - */ - logger?: IExtendableLogger | ILogger; }; export class SqliteViewLocker implements IViewLocker { @@ -45,10 +38,9 @@ export class SqliteViewLocker implements IViewLocker { #removeTableLockQuery: Statement<[string, string], void>; #lockMarker: Deferred | undefined; - // eslint-disable-next-line no-undef #lockProlongationTimeout: NodeJS.Timeout | undefined; - constructor(o: SqliteViewLockerParams) { + constructor(o: Pick & SqliteViewLockerParams) { if (!o.viewModelSqliteDb) throw new TypeError('viewModelSqliteDb argument required'); if (!o.projectionName) diff --git a/src/sqlite/index.ts b/src/sqlite/index.ts index 3eaf404..068463a 100644 --- a/src/sqlite/index.ts +++ b/src/sqlite/index.ts @@ -1,3 +1,5 @@ +export * from './AbstractSqliteAccessor'; +export * from './AbstractSqliteObjectProjection'; export * from './AbstractSqliteView'; export * from './SqliteEventLocker'; export * from './SqliteObjectStorage'; diff --git a/src/in-memory/utils/Deferred.ts b/src/utils/Deferred.ts similarity index 100% rename from src/in-memory/utils/Deferred.ts rename to src/utils/Deferred.ts diff --git a/src/utils/Lock.ts b/src/utils/Lock.ts new file mode 100644 index 0000000..de00359 --- /dev/null +++ b/src/utils/Lock.ts @@ -0,0 +1,53 @@ +import { Deferred } from './Deferred'; + +/** + * Provides a simple asynchronous lock mechanism. + * Useful for ensuring that only one asynchronous operation proceeds at a time + * for a specific resource or section of code. + */ +export class Lock { + + #deferred?: Deferred; + + get isLocked(): boolean { + return !(this.#deferred?.settled ?? true); + } + + /** + * Wait until lock is released, then acquire it + */ + async acquire(): Promise { + // the below code cannot be replaced with `await this.unblocked()` + // since check of `isLocked` and `this.#deferred` assignment should happen within 1 callback + while (this.isLocked) + await this.#deferred?.promise; + + this.#deferred = new Deferred(); + } + + /** + * Returns a promise that is resolved once lock is released + */ + async unblocked(): Promise { + while (this.isLocked) + await this.#deferred?.promise; + } + + release(): void { + this.#deferred?.resolve(); + this.#deferred = undefined; + } + + /** + * Execute callback with lock acquired, then release lock + */ + async runLocked(callback: () => Promise) { + try { + await this.acquire(); + await callback(); + } + finally { + this.release(); + } + } +} diff --git a/src/utils/index.ts b/src/utils/index.ts index 0ec92ea..c9bfc05 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,9 +1,11 @@ +export * from './Deferred'; export * from './delay'; export * from './getClassName'; export * from './getHandler'; export * from './getMessageHandlerNames'; export * from './isClass'; export * from './iteratorToArray'; +export * from './Lock'; export * from './notEmpty'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; diff --git a/tests/unit/Lock.test.ts b/tests/unit/Lock.test.ts new file mode 100644 index 0000000..d75270a --- /dev/null +++ b/tests/unit/Lock.test.ts @@ -0,0 +1,185 @@ +import { Lock } from '../../src/utils'; +import { promisify } from 'util'; +const delay = promisify(setTimeout); + +const isResolved = async (p?: Promise) => { + const unique = Symbol('pending'); + const result = await Promise.race([p, Promise.resolve(unique)]); + return result !== unique; +}; + +describe('Lock', () => { + + let lock: Lock; + beforeEach(() => { + lock = new Lock(); + }); + + describe('acquire', () => { + + it('acquires lock if it is not taken by another process', async () => { + // Check if acquire() resolves quickly + await expect(isResolved(lock.acquire())).resolves.toBe(true); + }); + + it('waits until previously acquired lock is released', async () => { + + await lock.acquire(); + + const l2 = lock.acquire(); + const l3 = lock.acquire(); + + // Check that l2 and l3 are pending + await expect(isResolved(l3)).resolves.toBe(false); + await expect(isResolved(l2)).resolves.toBe(false); + + await lock.release(); + + // Check that l3 is still pending, but l2 is now resolved + await expect(isResolved(l3)).resolves.toBe(false); + await expect(isResolved(l2)).resolves.toBe(true); + await l2; // Wait for l2 to fully complete if it had async operations + + await lock.release(); + + // Check that l3 is now resolved + await expect(isResolved(l3)).resolves.toBe(true); + await l3; // Wait for l3 to fully complete + + // Ensure both promises associated with acquire calls are resolved + await expect(l2).resolves.toBeUndefined(); + await expect(l3).resolves.toBeUndefined(); + }); + }); + + describe('isLocked', () => { + + it('returns `false` when lock is not acquired', async () => { + expect(lock).toHaveProperty('isLocked', false); + }); + + it('returns `true` when lock is acquired', async () => { + await lock.acquire(); + expect(lock).toHaveProperty('isLocked', true); + }); + + it('returns `false` when lock is released', async () => { + await lock.acquire(); + await lock.release(); + expect(lock).toHaveProperty('isLocked', false); + }); + }); + + describe('runLocked', () => { + + it('executes callback with lock acquired', async () => { + + let p1status = 'not-started'; + let p2status = 'not-started'; + + const p1 = lock.runLocked(async () => { + p1status = 'started'; + await delay(10); + p1status = 'processed'; + }); + + const p2 = lock.runLocked(async () => { + p2status = 'started'; + await delay(5); + p2status = 'processed'; + }); + + // Check initial state: p1 started, p2 not started, both promises pending + await expect(isResolved(p1)).resolves.toBe(false); + expect(p1status).toBe('started'); + await expect(isResolved(p2)).resolves.toBe(false); + expect(p2status).toBe('not-started'); + + await p1; + + // Check state after p1 finishes: p1 processed, p2 started, p1 resolved, p2 pending + await expect(isResolved(p1)).resolves.toBe(true); + expect(p1status).toBe('processed'); + await expect(isResolved(p2)).resolves.toBe(false); + expect(p2status).toBe('started'); + + + await p2; + + // Check final state: both processed and resolved + await expect(isResolved(p1)).resolves.toBe(true); + expect(p1status).toBe('processed'); + await expect(isResolved(p2)).resolves.toBe(true); + expect(p2status).toBe('processed'); + }); + }); + + describe('unblocked', () => { + + it('returns Promise', () => { + expect(lock).toHaveProperty('unblocked'); + expect(lock.unblocked()).toBeInstanceOf(Promise); + }); + + it('returns resolved promise when lock is not acquired', async () => { + await expect(isResolved(lock.unblocked())).resolves.toBe(true); + }); + + it('returns pending promise when lock is acquired', async () => { + await lock.acquire(); + await expect(isResolved(lock.unblocked())).resolves.toBe(false); + }); + + it('returns resolved promise when lock is released', async () => { + await lock.acquire(); + await lock.release(); + await expect(isResolved(lock.unblocked())).resolves.toBe(true); + }); + + it('can be used to suspend non-blocking processes until lock is released', async () => { + + await lock.acquire(); // blocking process (i.e. update_by_query) + + const p2 = lock.unblocked(); + const p3 = lock.unblocked(); + const l4 = lock.acquire(); // blocking process (i.e. update_by_query) + const p5 = lock.unblocked(); + const l6 = lock.acquire(); // blocking process (i.e. update_by_query) + + // Check all are pending initially + await expect(isResolved(p2)).resolves.toBe(false); + await expect(isResolved(p3)).resolves.toBe(false); + await expect(isResolved(l4)).resolves.toBe(false); + await expect(isResolved(p5)).resolves.toBe(false); + await expect(isResolved(l6)).resolves.toBe(false); + + await lock.release(); + + // Check p2, p3 resolve immediately, l4 acquires lock, p5, l6 still pending + await expect(isResolved(p2)).resolves.toBe(true); + await expect(isResolved(p3)).resolves.toBe(true); + await expect(isResolved(l4)).resolves.toBe(true); // l4 should resolve as it acquires the lock + await l4; // Wait for l4 acquire to complete + await expect(isResolved(p5)).resolves.toBe(false); // p5 waits for l4 + await expect(isResolved(l6)).resolves.toBe(false); // l6 waits for l4 + + // Release l4's lock + await lock.release(); + + // Check p5 resolves, l6 acquires lock + await expect(isResolved(p5)).resolves.toBe(true); + await expect(isResolved(l6)).resolves.toBe(true); // l6 should resolve as it acquires the lock + await l6; // Wait for l6 acquire to complete + + // Release l6's lock + await lock.release(); + + // Ensure all original promises eventually resolve + await expect(p2).resolves.toBeUndefined(); + await expect(p3).resolves.toBeUndefined(); + await expect(l4).resolves.toBeUndefined(); + await expect(p5).resolves.toBeUndefined(); + await expect(l6).resolves.toBeUndefined(); + }); + }); +}); diff --git a/tests/unit/SagaEventHandler.test.ts b/tests/unit/SagaEventHandler.test.ts index 0aac4e9..ac0d064 100644 --- a/tests/unit/SagaEventHandler.test.ts +++ b/tests/unit/SagaEventHandler.test.ts @@ -7,9 +7,9 @@ import { CommandBus, AbstractSaga, InMemoryMessageBus, - Deferred, EventDispatcher } from '../../src'; +import { Deferred } from '../../src/utils'; class Saga extends AbstractSaga { static get startsWith() { diff --git a/tests/unit/sqlite/SqliteEventLocker.test.ts b/tests/unit/sqlite/SqliteEventLocker.test.ts index 99bb6e2..243e773 100644 --- a/tests/unit/sqlite/SqliteEventLocker.test.ts +++ b/tests/unit/sqlite/SqliteEventLocker.test.ts @@ -1,4 +1,3 @@ -import { expect } from 'chai'; import * as createDb from 'better-sqlite3'; import { SqliteEventLocker } from '../../../src/sqlite/SqliteEventLocker'; import { IEvent } from '../../../src/interfaces'; @@ -6,7 +5,7 @@ import { guid } from '../../../src/sqlite'; import { promisify } from 'util'; const delay = promisify(setTimeout); -describe('SqliteEventLocker', function () { +describe('SqliteEventLocker', () => { let db: import('better-sqlite3').Database; let locker: SqliteEventLocker; @@ -22,76 +21,70 @@ describe('SqliteEventLocker', function () { viewLockTableName: 'test_view_lock', eventLockTtl: 50 // ms }); - jest.useFakeTimers(); }); afterEach(() => { db.close(); - jest.useRealTimers(); }); - it('allows marking an event as projecting', function () { - const result = locker.tryMarkAsProjecting(testEvent); - expect(result).to.be.true; + it('allows marking an event as projecting', async () => { + const result = await locker.tryMarkAsProjecting(testEvent); + expect(result).toBe(true); }); - it('prevents re-locking an already locked event', function () { - locker.tryMarkAsProjecting(testEvent); - const result = locker.tryMarkAsProjecting(testEvent); - expect(result).to.be.false; + it('prevents re-locking an already locked event', async () => { + await locker.tryMarkAsProjecting(testEvent); + const result = await locker.tryMarkAsProjecting(testEvent); + expect(result).toBe(false); }); - it('marks an event as projected', function () { - locker.tryMarkAsProjecting(testEvent); - locker.markAsProjected(testEvent); + it('marks an event as projected', async () => { + await locker.tryMarkAsProjecting(testEvent); + await locker.markAsProjected(testEvent); // Assuming markAsProjected might become async + // DB query remains synchronous with better-sqlite3 const row = db.prepare('SELECT processed_at FROM test_event_lock WHERE event_id = ?') .get(guid(testEvent.id)) as any; - expect(row).to.exist; - expect(row.processed_at).to.not.be.null; + expect(row).toBeDefined(); + expect(row.processed_at).not.toBeNull(); }); - it('retrieves the last projected event', function () { + it('retrieves the last projected event', async () => { + await locker.tryMarkAsProjecting(testEvent); + await locker.markAsProjected(testEvent); - locker.tryMarkAsProjecting(testEvent); - locker.markAsProjected(testEvent); + const lastEvent = await locker.getLastEvent(); // Assuming getLastEvent might become async - const lastEvent = locker.getLastEvent(); - - expect(lastEvent).to.deep.equal(testEvent); + expect(lastEvent).toEqual(testEvent); }); - it('returns undefined if no event has been projected', function () { - const lastEvent = locker.getLastEvent(); - expect(lastEvent).to.be.undefined; + it('returns undefined if no event has been projected', async () => { + const lastEvent = await locker.getLastEvent(); + expect(lastEvent).toBeUndefined(); }); - it('fails to mark an event as projected if it was never locked', function () { - expect(() => locker.markAsProjected(testEvent)) - .to.throw(Error, `Event ${testEvent.id} could not be marked as processed`); + it('fails to mark an event as projected if it was never locked', async () => { + await expect(() => locker.markAsProjected(testEvent)) + .rejects.toThrow(`Event ${testEvent.id} could not be marked as processed`); }); - it('allows re-locking after TTL expires', async function () { - - locker.tryMarkAsProjecting(testEvent); + it('allows re-locking after TTL expires', async () => { + await locker.tryMarkAsProjecting(testEvent); - await delay(51); + await delay(51); // Wait for TTL to expire - const result = locker.tryMarkAsProjecting(testEvent); - expect(result).to.be.true; + const result = await locker.tryMarkAsProjecting(testEvent); + expect(result).toBe(true); }); - it('fails to update an event if its version is modified in DB', function () { - - locker.tryMarkAsProjecting(testEvent); + it('fails to update an event if its version is modified in DB', async () => { + await locker.tryMarkAsProjecting(testEvent); - // Modify the event in DB to simulate an external change db.prepare('UPDATE test_event_lock SET processed_at = ? WHERE event_id = ?') .run(Date.now(), guid(testEvent.id)); - // Attempt to finalize the event processing - expect(() => locker.markAsProjected(testEvent)) - .to.throw(Error, `Event ${testEvent.id} could not be marked as processed`); + await expect(() => locker.markAsProjected(testEvent)) + .rejects.toThrow(`Event ${testEvent.id} could not be marked as processed`); }); }); diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts index 56bc72f..dd6d9f7 100644 --- a/tests/unit/sqlite/SqliteObjectStorage.test.ts +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -1,4 +1,3 @@ -import { expect } from 'chai'; import * as createDb from 'better-sqlite3'; import { guid, SqliteObjectStorage } from '../../../src/sqlite'; @@ -6,12 +5,13 @@ describe('SqliteObjectStorage', function () { let db: import('better-sqlite3').Database; let storage: SqliteObjectStorage<{ name: string; value: number }>; - beforeEach(() => { + beforeEach(async () => { db = createDb(':memory:'); storage = new SqliteObjectStorage<{ name: string; value: number }>({ viewModelSqliteDb: db, tableName: 'test_objects' }); + await storage.assertConnection(); }); afterEach(() => { @@ -21,66 +21,66 @@ describe('SqliteObjectStorage', function () { it('stores and retrieves an object', async function () { const obj = { name: 'Test Object', value: 42 }; - storage.create('0001', obj); + await storage.create('0001', obj); - const retrieved = storage.get('0001'); - expect(retrieved).to.deep.equal(obj); + const retrieved = await storage.get('0001'); + expect(retrieved).toEqual(obj); }); it('returns undefined for a non-existent object', async function () { - const retrieved = storage.get('nonexistent'); - expect(retrieved).to.be.undefined; + const retrieved = await storage.get('nonexistent'); + expect(retrieved).not.toBeDefined(); }); it('updates an existing object', async function () { - storage.create('0002', { name: 'Old Data', value: 5 }); + await storage.create('0002', { name: 'Old Data', value: 5 }); - storage.update('0002', r => ({ ...r, value: 99 })); + await storage.update('0002', r => ({ ...r, value: 99 })); - const updated = storage.get('0002'); - expect(updated).to.deep.equal({ name: 'Old Data', value: 99 }); + const updated = await storage.get('0002'); + expect(updated).toEqual({ name: 'Old Data', value: 99 }); }); it('throws an error when updating a non-existent object', async function () { - expect(() => storage.update('nonexistent', r => ({ ...r, value: 99 }))) - .to.throw(Error, "Record 'nonexistent' does not exist"); + await expect(() => storage.update('nonexistent', r => ({ ...r, value: 99 }))) + .rejects.toThrow("Record 'nonexistent' does not exist"); }); it('deletes an object', async function () { storage.create('0003', { name: 'To be deleted', value: 10 }); const deleted = storage.delete('0003'); - expect(deleted).to.be.true; + expect(deleted).toBeTruthy(); const retrieved = storage.get('0003'); - expect(retrieved).to.be.undefined; + expect(retrieved).toBeDefined(); }); it('returns false when deleting a non-existent object', async function () { - const deleted = storage.delete('0000'); - expect(deleted).to.be.false; + const deleted = await storage.delete('0000'); + expect(deleted).toBeFalsy(); }); it('enforces updating or creating a new object', async function () { - storage.updateEnforcingNew('0004', () => ({ name: 'Created', value: 1 })); + await storage.updateEnforcingNew('0004', () => ({ name: 'Created', value: 1 })); - let retrieved = storage.get('0004'); - expect(retrieved).to.deep.equal({ name: 'Created', value: 1 }); + let retrieved = await storage.get('0004'); + expect(retrieved).toEqual({ name: 'Created', value: 1 }); - storage.updateEnforcingNew('0004', r => ({ ...r!, value: 100 })); + await storage.updateEnforcingNew('0004', r => ({ ...r!, value: 100 })); - retrieved = storage.get('0004'); - expect(retrieved).to.deep.equal({ name: 'Created', value: 100 }); + retrieved = await storage.get('0004'); + expect(retrieved).toEqual({ name: 'Created', value: 100 }); }); it('fails if invalid JSON is recorded', async function () { db.prepare('INSERT INTO test_objects (id, data) VALUES (?, ?)') .run(guid('0005'), 'INVALID_JSON'); - expect(() => storage.get('0005')).to.throw(); + await expect(() => storage.get('0005')).rejects.toThrow(); }); }); From bee4be08a943cc5b80a40e8c5c6d968a458e0ac0 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 11 Apr 2025 01:35:50 +0100 Subject: [PATCH 048/169] Refactor event dispatching to support origin tracking and streamline event processing pipeline --- examples/user-domain/index.js | 3 +- src/CqrsContainerBuilder.ts | 34 ++++---- src/EventDispatcher.ts | 34 +++++--- src/EventStore.ts | 2 +- src/EventValidationProcessor.ts | 33 +++++++ .../EventPersistenceProcessor.ts | 30 ------- .../EventValidationProcessor.ts | 27 ------ .../ExternalEventPublishingProcessor.ts | 29 ------- .../SnapshotPersistenceProcessor.ts | 53 ------------ src/dispatch-pipeline/index.ts | 4 - src/in-memory/InMemoryEventStorage.ts | 31 ++++++- src/in-memory/InMemoryMessageBus.ts | 24 +++++- src/in-memory/InMemorySnapshotStorage.ts | 56 +++++++++++- src/index.ts | 2 +- src/interfaces/IContainer.ts | 4 +- src/interfaces/IDispatchPipelineProcessor.ts | 35 ++++++++ src/interfaces/IEventProcessor.ts | 24 ------ src/interfaces/index.ts | 2 +- src/rabbitmq/IContainer.ts | 6 ++ src/rabbitmq/RabbitMqEventBus.ts | 24 +++++- src/rabbitmq/RabbitMqEventInjector.ts | 2 +- .../rabbitmq/RabbitMqEventInjector.test.ts | 2 +- tests/unit/EventDispatcher.test.ts | 10 +-- tests/unit/EventStore.test.ts | 4 +- tests/unit/dispatch-pipeline.test.ts | 85 +++++++++++++++++++ 25 files changed, 339 insertions(+), 221 deletions(-) create mode 100644 src/EventValidationProcessor.ts delete mode 100644 src/dispatch-pipeline/EventPersistenceProcessor.ts delete mode 100644 src/dispatch-pipeline/EventValidationProcessor.ts delete mode 100644 src/dispatch-pipeline/ExternalEventPublishingProcessor.ts delete mode 100644 src/dispatch-pipeline/SnapshotPersistenceProcessor.ts delete mode 100644 src/dispatch-pipeline/index.ts create mode 100644 src/interfaces/IDispatchPipelineProcessor.ts delete mode 100644 src/interfaces/IEventProcessor.ts create mode 100644 tests/unit/dispatch-pipeline.test.ts diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index 32126eb..b11ef0a 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -9,7 +9,6 @@ const { InMemoryMessageBus, EventDispatcher } = require('../..'); // node-cqrs -const { EventPersistenceProcessor } = require('../../src/dispatch-pipeline'); const UserAggregate = require('./UserAggregate'); const UsersProjection = require('./UsersProjection'); @@ -39,7 +38,7 @@ exports.createBaseInstances = () => { const eventBus = new InMemoryMessageBus(); const storage = new InMemoryEventStorage(); const eventDispatcher = new EventDispatcher({ eventBus }) - eventDispatcher.addPipelineProcessor(new EventPersistenceProcessor({ eventStorageWriter: storage })); + eventDispatcher.addPipelineProcessor(storage); const eventStore = new EventStore({ eventStorageReader: storage, eventBus, eventDispatcher }); const commandBus = new CommandBus(); diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 4ed14fe..95eba03 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -1,21 +1,12 @@ import { ContainerBuilder, TypeConfig, TClassOrFactory } from 'di0'; - import { AggregateCommandHandler } from './AggregateCommandHandler'; import { CommandBus } from './CommandBus'; import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; import { EventDispatcher } from './EventDispatcher'; -import { InMemoryMessageBus } from './in-memory'; -import { - EventValidationProcessor, - SnapshotPersistenceProcessor, - EventPersistenceProcessor -} from './dispatch-pipeline'; - -import { - isClass -} from './utils'; - +import { InMemoryEventStorage, InMemoryMessageBus, InMemorySnapshotStorage } from './in-memory'; +import { EventValidationProcessor } from './EventValidationProcessor'; +import { isClass } from './utils'; import { IAggregateConstructor, ICommandHandler, @@ -25,7 +16,6 @@ import { IProjectionConstructor, ISagaConstructor } from './interfaces'; -import { ExternalEventPublishingProcessor } from './dispatch-pipeline/ExternalEventPublishingProcessor'; export class CqrsContainerBuilder extends ContainerBuilder { @@ -38,12 +28,18 @@ export class CqrsContainerBuilder extends ContainerBuilder { super.register(EventStore).as('eventStore'); super.register(CommandBus).as('commandBus'); super.register(EventDispatcher).as('eventDispatcher'); - super.register(container => [ - new EventValidationProcessor(container), - new ExternalEventPublishingProcessor(container), - new EventPersistenceProcessor(container), - new SnapshotPersistenceProcessor(container) - ]).as('eventDispatchProcessors'); + + super.register(InMemoryEventStorage).as('eventStorageWriter'); + super.register(InMemorySnapshotStorage).as('snapshotStorage'); + + // Register default event dispatch pipeline: + // validate events, write to event storage, write to snapshot storage. + // If any of the processors is not defined, it will be skipped. + super.register((container: IContainer) => [ + new EventValidationProcessor(), + container.eventStorageWriter, + container.snapshotStorage + ]).as('eventDispatchPipeline'); } /** Register command handler, which will be subscribed to commandBus upon instance creation */ diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index ceeb6b2..d9568f7 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -1,12 +1,13 @@ import { - EventBatch, + DispatchPipelineBatch, IEvent, IEventDispatcher, - IEventProcessor, + IDispatchPipelineProcessor, IEventSet, IEventBus, isEventSet, - IContainer + IContainer, + isDispatchPipelineProcessor } from './interfaces'; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; @@ -14,7 +15,7 @@ import { notEmpty } from './utils'; import { InMemoryMessageBus } from './in-memory'; type EventBatchEnvelope = { - data: EventBatch<{ event?: IEvent }>; + data: DispatchPipelineBatch<{ event?: IEvent }>; error?: Error; resolve: (event: IEvent[]) => void; reject: (error: Error) => void; @@ -23,7 +24,7 @@ type EventBatchEnvelope = { export class EventDispatcher implements IEventDispatcher { #pipelineInput = new AsyncIterableBuffer(); - #processors: Array = []; + #processors: Array = []; #pipeline: AsyncIterableIterator | IterableIterator = this.#pipelineInput; /** @@ -38,7 +39,7 @@ export class EventDispatcher implements IEventDispatcher { */ concurrentLimit: number; - constructor(o?: Pick & { + constructor(o?: Pick & { eventDispatcherConfig?: { concurrentLimit?: number } @@ -46,8 +47,16 @@ export class EventDispatcher implements IEventDispatcher { this.eventBus = o?.eventBus ?? new InMemoryMessageBus(); this.concurrentLimit = o?.eventDispatcherConfig?.concurrentLimit ?? 100; - if (o?.eventDispatchProcessors) { - for (const processor of o.eventDispatchProcessors) + if (o?.eventDispatchPipeline) + this.addPipelineProcessors(o.eventDispatchPipeline); + } + + addPipelineProcessors(eventDispatchPipeline: IDispatchPipelineProcessor[]) { + if (!Array.isArray(eventDispatchPipeline)) + throw new TypeError('eventDispatchPipeline argument must be an Array'); + + for (const processor of eventDispatchPipeline) { + if (processor) this.addPipelineProcessor(processor); } } @@ -57,14 +66,15 @@ export class EventDispatcher implements IEventDispatcher { * * Preprocessors run in order they are added but process separate batches in parallel, maintaining FIFO order. */ - addPipelineProcessor(preprocessor: IEventProcessor) { + addPipelineProcessor(preprocessor: IDispatchPipelineProcessor) { + if (!isDispatchPipelineProcessor(preprocessor)) + throw new TypeError('preprocessor must implement IDispatchPipelineProcessor'); if (this.#pipelineProcessing) throw new Error('pipeline processing already started'); this.#processors.push(preprocessor); - // Build a processing pipeline that runs preprocessors concurrently - // while preserving first-in-first-out ordering. + // Build a processing pipeline that runs preprocessors concurrently, preserving FIFO ordering this.#pipeline = parallelPipe(this.#pipeline, this.concurrentLimit, async envelope => { if (envelope.error) return envelope; @@ -119,7 +129,7 @@ export class EventDispatcher implements IEventDispatcher { /** * Revert side effects made by pipeline processors in case of a batch processing failure */ - async #revert(batch: EventBatch) { + async #revert(batch: DispatchPipelineBatch) { for (const processor of this.#processors) await processor.revert?.(batch); } diff --git a/src/EventStore.ts b/src/EventStore.ts index 5a1e1e5..9fc91d1 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -153,7 +153,7 @@ export class EventStore implements IEventStore { const augmentedEvents = await this.#attachSagaIdToSagaStarterEvents(events); - return this.#eventDispatcher.dispatch(augmentedEvents); + return this.#eventDispatcher.dispatch(augmentedEvents, { origin: 'internal' }); } /** diff --git a/src/EventValidationProcessor.ts b/src/EventValidationProcessor.ts new file mode 100644 index 0000000..da5d0b2 --- /dev/null +++ b/src/EventValidationProcessor.ts @@ -0,0 +1,33 @@ +import { DispatchPipelineBatch, IEvent, IDispatchPipelineProcessor } from './interfaces'; +import { validate as defaultValidator } from './Event'; + +export type EventValidator = (event: IEvent) => void; + +/** + * Processor that validates the format of events. + * Rejects the batch if any event fails validation. + */ +export class EventValidationProcessor implements IDispatchPipelineProcessor { + + #validate: EventValidator; + + constructor(o?: { + eventFormatValidator?: EventValidator + }) { + this.#validate = o?.eventFormatValidator ?? defaultValidator; + } + + /** + * Processes a batch of dispatch pipeline items by validating each event within the batch. + * It iterates through the batch and calls the private `#validate` method for each event found. + * + * This method is part of the `IDispatchPipelineProcessor` interface. + */ + async process(batch: DispatchPipelineBatch): Promise { + for (const { event } of batch) { + if (event) + this.#validate(event); + } + return batch; + } +} diff --git a/src/dispatch-pipeline/EventPersistenceProcessor.ts b/src/dispatch-pipeline/EventPersistenceProcessor.ts deleted file mode 100644 index d5ed7b6..0000000 --- a/src/dispatch-pipeline/EventPersistenceProcessor.ts +++ /dev/null @@ -1,30 +0,0 @@ -import { EventBatch, IContainer, IEvent, IEventProcessor, IEventStorageWriter } from '../interfaces'; - -/** - * Processor responsible for persisting events to IEventStoreWriter. - */ -export class EventPersistenceProcessor implements IEventProcessor { - - #storageWriter: IEventStorageWriter | undefined; - - constructor(options: Pick) { - this.#storageWriter = options.eventStorageWriter; - } - - async process(batch: EventBatch): Promise { - if (!this.#storageWriter) - return batch; - - const events: IEvent[] = []; - for (const { event } of batch) { - if (!event) - throw new Error('Event batch does not contain event'); - - events.push(event); - } - - await this.#storageWriter.commitEvents(events); - - return batch; - } -} diff --git a/src/dispatch-pipeline/EventValidationProcessor.ts b/src/dispatch-pipeline/EventValidationProcessor.ts deleted file mode 100644 index 7f24245..0000000 --- a/src/dispatch-pipeline/EventValidationProcessor.ts +++ /dev/null @@ -1,27 +0,0 @@ -import { EventBatch, IEvent, IEventProcessor } from '../interfaces'; -import { validate as defaultValidator } from '../Event'; - -export type EventValidator = (event: IEvent) => void; - -/** - * Processor that validates the format of events. - * Rejects the batch if any event fails validation. - */ -export class EventValidationProcessor implements IEventProcessor { - - #validate: EventValidator; - - constructor(o?: { - eventFormatValidator?: EventValidator - }) { - this.#validate = o?.eventFormatValidator ?? defaultValidator; - } - - async process(batch: EventBatch): Promise { - for (const { event } of batch) { - if (event) - this.#validate(event); - } - return batch; - } -} diff --git a/src/dispatch-pipeline/ExternalEventPublishingProcessor.ts b/src/dispatch-pipeline/ExternalEventPublishingProcessor.ts deleted file mode 100644 index 8cfbad3..0000000 --- a/src/dispatch-pipeline/ExternalEventPublishingProcessor.ts +++ /dev/null @@ -1,29 +0,0 @@ -import { IEventProcessor, IEventBus, EventBatch } from '../interfaces'; - -/** - * Event dispatcher processor that publishes events to an external RabbitMQ event bus if provided. - */ -export class ExternalEventPublishingProcessor implements IEventProcessor { - - #externalEventBus?: IEventBus; - - constructor(options: { externalEventBus?: IEventBus }) { - this.#externalEventBus = options.externalEventBus; - } - - async process(batch: EventBatch): Promise { - if (!this.#externalEventBus) - return batch; - - // TODO: ignore external events - - for (const { event } of batch) { - if (!event) - throw new Error('Event batch does not contain `event`'); - - await this.#externalEventBus.publish(event); - } - - return batch; - } -} diff --git a/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts b/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts deleted file mode 100644 index 855a857..0000000 --- a/src/dispatch-pipeline/SnapshotPersistenceProcessor.ts +++ /dev/null @@ -1,53 +0,0 @@ -import { - EventBatch, - IAggregateSnapshotStorage, - IEvent, - IEventProcessor, - IExtendableLogger, - ILogger -} from '../interfaces'; -import * as Event from '../Event'; - -const SNAPSHOT_EVENT_TYPE = 'snapshot'; -const isSnapshotEvent = (event?: IEvent): event is IEvent & { type: 'snapshot' } => - (!!event && event.type === SNAPSHOT_EVENT_TYPE); - -export class SnapshotPersistenceProcessor implements IEventProcessor<{ event?: IEvent }> { - - #snapshotStorage?: IAggregateSnapshotStorage; - #logger?: ILogger; - - constructor(options: { - snapshotStorage?: IAggregateSnapshotStorage; - logger?: ILogger | IExtendableLogger; - }) { - this.#snapshotStorage = options.snapshotStorage; - this.#logger = options.logger && 'child' in options.logger ? - options.logger.child({ service: new.target.name }) : - options.logger; - } - - async process(batch: EventBatch): Promise { - if (!this.#snapshotStorage) - return batch; - - const snapshotEvents = batch.map(e => e.event).filter(isSnapshotEvent); - for (const event of snapshotEvents) { - this.#logger?.debug(`Persisting ${Event.describe(event)}`); - await this.#snapshotStorage.saveAggregateSnapshot(event); - } - - return batch.filter(e => !isSnapshotEvent(e.event)); - } - - async revert(batch: EventBatch): Promise { - if (!this.#snapshotStorage) - return; - - const snapshotEvents = batch.map(e => e.event).filter(isSnapshotEvent); - for (const snapshotEvent of snapshotEvents) { - this.#logger?.debug(`Removing ${Event.describe(snapshotEvent)}`); - await this.#snapshotStorage.deleteAggregateSnapshot(snapshotEvent); - } - } -} diff --git a/src/dispatch-pipeline/index.ts b/src/dispatch-pipeline/index.ts deleted file mode 100644 index c536281..0000000 --- a/src/dispatch-pipeline/index.ts +++ /dev/null @@ -1,4 +0,0 @@ -export * from './EventPersistenceProcessor'; -export * from './EventValidationProcessor'; -export * from './ExternalEventPublishingProcessor'; -export * from './SnapshotPersistenceProcessor'; diff --git a/src/in-memory/InMemoryEventStorage.ts b/src/in-memory/InMemoryEventStorage.ts index 3b1cb69..d0b8d95 100644 --- a/src/in-memory/InMemoryEventStorage.ts +++ b/src/in-memory/InMemoryEventStorage.ts @@ -6,7 +6,9 @@ import { IEventStorageReader, IEventStream, IEventStorageWriter, - Identifier + Identifier, + IDispatchPipelineProcessor, + DispatchPipelineBatch } from '../interfaces'; import { nextCycle } from './utils'; @@ -14,7 +16,12 @@ import { nextCycle } from './utils'; * A simple event storage implementation intended to use for tests only. * Storage content resets on each app restart. */ -export class InMemoryEventStorage implements IEventStorageReader, IEventStorageWriter, IIdentifierProvider { +export class InMemoryEventStorage implements + IEventStorageReader, + IEventStorageWriter, + IIdentifierProvider, + IDispatchPipelineProcessor { + #nextId: number = 0; #events: IEventSet = []; @@ -78,4 +85,24 @@ export class InMemoryEventStorage implements IEventStorageReader, IEventStorageW yield event; } } + + /** + * Processes a batch of dispatch pipeline items, extracts the events, + * commits them to the in-memory storage, and returns the original batch. + * + * This method is part of the `IDispatchPipelineProcessor` interface. + */ + async process(batch: DispatchPipelineBatch): Promise { + const events: IEvent[] = []; + for (const { event } of batch) { + if (!event) + throw new Error('Event batch does not contain `event`'); + + events.push(event); + } + + await this.commitEvents(events); + + return batch; + } } diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index 69b8af6..261e1c5 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -1,5 +1,7 @@ import { + DispatchPipelineBatch, ICommand, + IDispatchPipelineProcessor, IEvent, IMessageBus, IMessageHandler, @@ -10,7 +12,7 @@ import { * Default implementation of the message bus. * Keeps all subscriptions and messages in memory. */ -export class InMemoryMessageBus implements IMessageBus { +export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcessor { #handlers: Map> = new Map(); #name: string | undefined; @@ -116,4 +118,24 @@ export class InMemoryMessageBus implements IMessageBus { return Promise.all(handlers.map(handler => handler(event, meta))); } + + /** + * Processes a batch of events and publishes them to the fanout exchange. + * + * This method is part of the `IDispatchPipelineProcessor` interface. + */ + async process(batch: DispatchPipelineBatch): Promise { + for (const { event, origin } of batch) { + // Skip publishing if the event was dispatched from external source + if (origin === 'external') + continue; + + if (!event) + throw new Error('Event batch does not contain `event`'); + + await this.publish(event); + } + + return batch; + } } diff --git a/src/in-memory/InMemorySnapshotStorage.ts b/src/in-memory/InMemorySnapshotStorage.ts index 3fb4947..ae3bbcf 100644 --- a/src/in-memory/InMemorySnapshotStorage.ts +++ b/src/in-memory/InMemorySnapshotStorage.ts @@ -1,12 +1,32 @@ -import { IAggregateSnapshotStorage, Identifier, IEvent } from '../interfaces'; +import { + DispatchPipelineBatch, + IAggregateSnapshotStorage, + IContainer, + Identifier, + IDispatchPipelineProcessor, + IEvent, + ILogger +} from '../interfaces'; +import * as Event from '../Event'; + +const SNAPSHOT_EVENT_TYPE = 'snapshot'; +const isSnapshotEvent = (event?: IEvent): event is IEvent & { type: 'snapshot' } => + (!!event && event.type === SNAPSHOT_EVENT_TYPE); /** * In-memory storage for aggregate snapshots. * Storage content resets on app restart */ -export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { +export class InMemorySnapshotStorage implements IAggregateSnapshotStorage, IDispatchPipelineProcessor { #snapshots: Map = new Map(); + #logger: ILogger | undefined; + + constructor(c?: Partial>) { + this.#logger = c?.logger && 'child' in c?.logger ? + c?.logger.child({ service: new.target.name }) : + c?.logger; + } /** * Get latest aggregate snapshot @@ -22,6 +42,8 @@ export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { if (!snapshotEvent.aggregateId) throw new TypeError('event.aggregateId is required'); + this.#logger?.debug(`Persisting ${Event.describe(snapshotEvent)}`); + this.#snapshots.set(snapshotEvent.aggregateId, snapshotEvent); } @@ -32,6 +54,36 @@ export class InMemorySnapshotStorage implements IAggregateSnapshotStorage { if (!snapshotEvent.aggregateId) throw new TypeError('snapshotEvent.aggregateId argument required'); + this.#logger?.debug(`Removing ${Event.describe(snapshotEvent)}`); + this.#snapshots.delete(snapshotEvent.aggregateId); } + + /** + * Processes a batch of events, saves any snapshot events found, and returns the batch + * without the snapshot events. + * + * This method is part of the `IDispatchPipelineProcessor` interface. + */ + async process(batch: DispatchPipelineBatch): Promise { + const snapshotEvents = batch.map(e => e.event).filter(isSnapshotEvent); + for (const event of snapshotEvents) + await this.saveAggregateSnapshot(event); + + return batch.filter(e => !isSnapshotEvent(e.event)); + } + + /** + * Reverts the snapshots associated with the events in the given batch. + * It filters the batch for snapshot events and deletes the corresponding aggregate snapshots. + * + * This method is part of the `IDispatchPipelineProcessor` interface. + * + * @param batch The batch of events to revert snapshots for. + */ + async revert(batch: DispatchPipelineBatch): Promise { + const snapshotEvents = batch.map(e => e.event).filter(isSnapshotEvent); + for (const snapshotEvent of snapshotEvents) + await this.deleteAggregateSnapshot(snapshotEvent); + } } diff --git a/src/index.ts b/src/index.ts index a1e1c55..6db623e 100644 --- a/src/index.ts +++ b/src/index.ts @@ -9,9 +9,9 @@ export * from './AbstractSaga'; export * from './SagaEventHandler'; export * from './AbstractProjection'; export * from './EventDispatcher'; +export * from './EventValidationProcessor'; export * from './in-memory'; -export * from './dispatch-pipeline'; export * as Event from './Event'; export { diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index 770b8af..6cf5e73 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -3,7 +3,7 @@ import { ICommandBus } from './ICommandBus'; import { IEventDispatcher } from './IEventDispatcher'; import { IEventStore } from './IEventStore'; import { IEventBus } from './IEventBus'; -import { IEventProcessor } from './IEventProcessor'; +import { IDispatchPipelineProcessor } from './IDispatchPipelineProcessor'; import { IEventStorageReader, IEventStorageWriter } from './IEventStorage'; import { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage'; import { IIdentifierProvider } from './IIdentifierProvider'; @@ -19,7 +19,7 @@ export interface IContainer extends Container { commandBus: ICommandBus; eventDispatcher: IEventDispatcher; - eventDispatchProcessors?: IEventProcessor[]; + eventDispatchPipeline?: IDispatchPipelineProcessor[]; logger?: ILogger | IExtendableLogger; diff --git a/src/interfaces/IDispatchPipelineProcessor.ts b/src/interfaces/IDispatchPipelineProcessor.ts new file mode 100644 index 0000000..f263490 --- /dev/null +++ b/src/interfaces/IDispatchPipelineProcessor.ts @@ -0,0 +1,35 @@ +import { IEvent } from './IEvent'; +import { isObject } from './isObject'; + +/** + * Represents a wrapper for an event that can optionally contain additional metadata. + * Used to extend event processing with context-specific data required by processors. + */ +export type DispatchPipelineEnvelope = { + + /** + * Origin of the event. Can be used to distinguish between events coming from different sources. + */ + origin?: 'external' | 'internal'; + + event?: IEvent; +} + +/** + * A batch of event envelopes. Can contain custom envelope types extending EventEnvelope. + */ +export type DispatchPipelineBatch = Readonly>; + +/** + * Defines a processor that operates on a batch of event envelopes. + * Allows transformations, side-effects, or filtering of events during dispatch. + */ +export interface IDispatchPipelineProcessor { + process(batch: DispatchPipelineBatch): Promise>; + revert?(batch: DispatchPipelineBatch): Promise; +} + +export const isDispatchPipelineProcessor = (obj: unknown): obj is IDispatchPipelineProcessor => + isObject(obj) + && 'process' in obj + && typeof (obj as IDispatchPipelineProcessor).process === 'function'; diff --git a/src/interfaces/IEventProcessor.ts b/src/interfaces/IEventProcessor.ts deleted file mode 100644 index 7bd448c..0000000 --- a/src/interfaces/IEventProcessor.ts +++ /dev/null @@ -1,24 +0,0 @@ -import { IEvent } from './IEvent'; - -/** - * Represents a wrapper for an event that can optionally contain additional metadata. - * Used to extend event processing with context-specific data required by processors. - */ -type EventEnvelope = { - event?: IEvent; -} - -/** - * A batch of event envelopes. Can contain custom envelope types extending EventEnvelope. - */ -export type EventBatch = Readonly>; - -/** - * Defines a processor that operates on a batch of event envelopes. - * Allows transformations, side-effects, or filtering of events during dispatch. - */ -export interface IEventProcessor { - process(batch: EventBatch): Promise>; - revert?(batch: EventBatch): Promise; -} - diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index bb70131..e736e0a 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -4,11 +4,11 @@ export * from './ICommand'; export * from './ICommandBus'; export * from './IContainer'; export * from './Identifier'; +export * from './IDispatchPipelineProcessor'; export * from './IEvent'; export * from './IEventBus'; export * from './IEventDispatcher'; export * from './IEventLocker'; -export * from './IEventProcessor'; export * from './IEventReceptor'; export * from './IEventSet'; export * from './IEventStorage'; diff --git a/src/rabbitmq/IContainer.ts b/src/rabbitmq/IContainer.ts index 6c43fb0..9a66a29 100644 --- a/src/rabbitmq/IContainer.ts +++ b/src/rabbitmq/IContainer.ts @@ -1,3 +1,4 @@ +import { IEventBus } from '../interfaces'; import { RabbitMqEventInjector } from './RabbitMqEventInjector'; import { RabbitMqGateway } from './RabbitMqGateway'; @@ -6,5 +7,10 @@ declare module '../interfaces/IContainer' { rabbitMqGateway?: RabbitMqGateway; rabbitMqEventInjector?: RabbitMqEventInjector; rabbitMqEventBus?: RabbitMqEventInjector; + + /** + * Optional external event bus for publishing events to an external system. + */ + externalEventBus?: IEventBus; } } diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index a707779..b47115b 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,10 +1,10 @@ -import { IEvent, IEventBus, IMessageHandler, IObservable } from '../interfaces'; +import { IEvent, IEventBus, IDispatchPipelineProcessor, IMessageHandler, IObservable, DispatchPipelineBatch } from '../interfaces'; import { DEFAULT_EXCHANGE } from './constants'; import { RabbitMqGateway } from './RabbitMqGateway'; const ALL_EVENTS_WILDCARD = '*'; -export class RabbitMqEventBus implements IEventBus { +export class RabbitMqEventBus implements IEventBus, IDispatchPipelineProcessor { static get allEventsWildcard(): '*' { return ALL_EVENTS_WILDCARD; @@ -81,4 +81,24 @@ export class RabbitMqEventBus implements IEventBus { } return queue; } + + /** + * Processes a batch of events and publishes them to the fanout exchange. + * + * This method is part of the `IDispatchPipelineProcessor` interface. + */ + async process(batch: DispatchPipelineBatch): Promise { + for (const { event, origin } of batch) { + // Skip publishing if the event was dispatched from external source + if (origin === 'external') + continue; + + if (!event) + throw new Error('Event batch does not contain `event`'); + + await this.publish(event); + } + + return batch; + } } diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts index ddeb713..b68de0c 100644 --- a/src/rabbitmq/RabbitMqEventInjector.ts +++ b/src/rabbitmq/RabbitMqEventInjector.ts @@ -53,7 +53,7 @@ export class RabbitMqEventInjector { async #handleMessage(message: IMessage): Promise { this.#logger?.debug(`"${Event.describe(message)}" received`); try { - await this.#eventDispatcher.dispatch([message]); + await this.#eventDispatcher.dispatch([message], { origin: 'external' }); this.#logger?.debug(`${Event.describe(message)} dispatched successfully`); } diff --git a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts index 1946dad..08eba71 100644 --- a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts +++ b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts @@ -61,6 +61,6 @@ describe('RabbitMqEventInjector', () => { await delay(50); expect(eventDispatcher.dispatch).toHaveBeenCalledTimes(1); - expect(eventDispatcher.dispatch).toHaveBeenCalledWith([testEvent]); + expect(eventDispatcher.dispatch).toHaveBeenCalledWith([testEvent], { origin: 'external' }); }); }); diff --git a/tests/unit/EventDispatcher.test.ts b/tests/unit/EventDispatcher.test.ts index 53f3107..f88048f 100644 --- a/tests/unit/EventDispatcher.test.ts +++ b/tests/unit/EventDispatcher.test.ts @@ -1,4 +1,4 @@ -import { IEvent, IEventBus, IEventProcessor } from '../../src'; +import { IEvent, IEventBus, IDispatchPipelineProcessor } from '../../src'; import { EventDispatcher } from '../../src/EventDispatcher'; describe('EventDispatcher', () => { @@ -15,7 +15,7 @@ describe('EventDispatcher', () => { const event1: IEvent = { type: 'test-event-1' }; const event2: IEvent = { type: 'test-event-2' }; - const processorMock: IEventProcessor = { + const processorMock: IDispatchPipelineProcessor = { process: jest.fn(batch => Promise.resolve(batch)) }; @@ -34,7 +34,7 @@ describe('EventDispatcher', () => { const event: IEvent = { type: 'failing-event' }; const error = new Error('processor error'); - const processorMock: IEventProcessor = { + const processorMock: IDispatchPipelineProcessor = { process: jest.fn().mockRejectedValue(error), revert: jest.fn().mockResolvedValue(undefined) }; @@ -57,7 +57,7 @@ describe('EventDispatcher', () => { const executionOrder: string[] = []; - const processorA: IEventProcessor = { + const processorA: IDispatchPipelineProcessor = { process: jest.fn(async batch => { executionOrder.push(`A-start-${batch[0].event.type}`); await new Promise(res => setTimeout(res, 5)); @@ -66,7 +66,7 @@ describe('EventDispatcher', () => { }) }; - const processorB: IEventProcessor = { + const processorB: IDispatchPipelineProcessor = { process: jest.fn(async batch => { executionOrder.push(`B-start-${batch[0].event.type}`); await new Promise(res => setTimeout(res, 5)); diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index 8cb1bb1..59f65a0 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -64,7 +64,7 @@ describe('EventStore', () => { expect(event.sagaId).toBe(mockId); expect(event.sagaVersion).toBe(0); - expect(dispatchSpy).toHaveBeenCalledWith([event]); + expect(dispatchSpy).toHaveBeenCalledWith([event], { origin: 'internal' }); }); it('does not modify non-saga starter events', async () => { @@ -76,7 +76,7 @@ describe('EventStore', () => { expect(event.sagaId).toBeUndefined(); expect(event.sagaVersion).toBeUndefined(); - expect(dispatchSpy).toHaveBeenCalledWith([event]); + expect(dispatchSpy).toHaveBeenCalledWith([event], { origin: 'internal' }); }); }); diff --git a/tests/unit/dispatch-pipeline.test.ts b/tests/unit/dispatch-pipeline.test.ts new file mode 100644 index 0000000..0fc7569 --- /dev/null +++ b/tests/unit/dispatch-pipeline.test.ts @@ -0,0 +1,85 @@ +import { + ContainerBuilder, + EventValidationProcessor, + IContainer, + InMemoryEventStorage, + InMemoryMessageBus +} from '../../src'; + +describe('eventDispatchPipeline', () => { + + let container: IContainer; + + const testEvent = { + type: 'test-event', + aggregateId: '123', + payload: { data: 'test-payload' }, + id: 'test-id-123' + }; + + beforeEach(() => { + const builder = new ContainerBuilder(); + + builder.register(InMemoryMessageBus).as('externalEventBus'); + builder.register(InMemoryEventStorage).as('eventStorageWriter'); + builder.register((c: IContainer) => [ + new EventValidationProcessor(), + c.externalEventBus, + c.eventStorageWriter, + c.snapshotStorage + ]).as('eventDispatchPipeline'); + + container = builder.container() as IContainer; + }); + + it('delivers locally dispatched events to externalEventBus', async () => { + + const { eventDispatcher, externalEventBus } = container; + + jest.spyOn(externalEventBus, 'publish'); + + await eventDispatcher.dispatch([testEvent], { origin: 'internal' }); + + expect(externalEventBus.publish).toHaveBeenCalledTimes(1); + }); + + it('does not deliver externally dispatched events to externalEventBus', async () => { + + const { eventDispatcher, externalEventBus } = container; + + jest.spyOn(externalEventBus, 'publish'); + + await eventDispatcher.dispatch([testEvent], { origin: 'external' }); + + expect(externalEventBus.publish).toHaveBeenCalledTimes(0); + }); + + it('delivers all events to eventStorageWriter', async () => { + + const { eventDispatcher, eventStorageWriter } = container; + + jest.spyOn(eventStorageWriter, 'commitEvents'); + + await eventDispatcher.dispatch([testEvent], { origin: 'internal' }); + await eventDispatcher.dispatch([testEvent], { origin: 'external' }); + + expect(eventStorageWriter.commitEvents).toHaveBeenCalledTimes(2); + expect(eventStorageWriter.commitEvents).toHaveBeenNthCalledWith(1, [testEvent]); + expect(eventStorageWriter.commitEvents).toHaveBeenNthCalledWith(2, [testEvent]); + }); + + + it('delivers all events to eventBus', async () => { + + const { eventDispatcher, eventBus } = container; + + jest.spyOn(eventBus, 'publish'); + + await eventDispatcher.dispatch([testEvent], { origin: 'internal' }); + await eventDispatcher.dispatch([testEvent], { origin: 'external' }); + + expect(eventBus.publish).toHaveBeenCalledTimes(2); + expect(eventBus.publish).toHaveBeenNthCalledWith(1, testEvent); + expect(eventBus.publish).toHaveBeenNthCalledWith(2, testEvent); + }); +}); From 85fdf79a19beafedef97d7e2e47dd4b66026747e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 15:42:25 +0100 Subject: [PATCH 049/169] Enhance error message for invalid preprocessor in EventDispatcher --- src/EventDispatcher.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index d9568f7..1521846 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -11,7 +11,7 @@ import { } from './interfaces'; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; -import { notEmpty } from './utils'; +import { getClassName, notEmpty } from './utils'; import { InMemoryMessageBus } from './in-memory'; type EventBatchEnvelope = { @@ -68,7 +68,7 @@ export class EventDispatcher implements IEventDispatcher { */ addPipelineProcessor(preprocessor: IDispatchPipelineProcessor) { if (!isDispatchPipelineProcessor(preprocessor)) - throw new TypeError('preprocessor must implement IDispatchPipelineProcessor'); + throw new TypeError(`preprocessor ${getClassName(preprocessor)} does not implement IDispatchPipelineProcessor`); if (this.#pipelineProcessing) throw new Error('pipeline processing already started'); From 04993efe33d14574c708e8605becd4cc2e2350a2 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 15:42:38 +0100 Subject: [PATCH 050/169] Fix import path for Deferred utility in RabbitMqGateway tests --- tests/integration/rabbitmq/RabbitMqGateway.test.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index c1f15bb..f43c653 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -2,7 +2,7 @@ import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; import { IMessage } from '../../../src/interfaces'; import * as amqplib from 'amqplib'; import { delay } from '../../../src/utils'; -import { Deferred } from '../../../dist/in-memory/utils/Deferred'; +import { Deferred } from '../../../src/utils/Deferred'; import { EventEmitter } from 'stream'; describe('RabbitMqGateway', () => { From 309004c75a0a8f911287196cd827411f591eb4b9 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 15:42:56 +0100 Subject: [PATCH 051/169] Optimize assertConnection method to return early if already initialized --- src/sqlite/AbstractSqliteAccessor.ts | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/sqlite/AbstractSqliteAccessor.ts b/src/sqlite/AbstractSqliteAccessor.ts index 23c009c..3d07f33 100644 --- a/src/sqlite/AbstractSqliteAccessor.ts +++ b/src/sqlite/AbstractSqliteAccessor.ts @@ -36,6 +36,9 @@ export abstract class AbstractSqliteAccessor { * This method is idempotent and safe to call multiple times. */ async assertConnection() { + if (this.#initialized) + return; + try { this.#initLocker.acquire(); if (this.#initialized) From 5b8aae447a25c0c614fef175373e912dbdb6871d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 15:43:34 +0100 Subject: [PATCH 052/169] Refactor constructor parameters in AbstractSqliteAccessor and AbstractSqliteView --- src/sqlite/AbstractSqliteAccessor.ts | 2 +- src/sqlite/AbstractSqliteView.ts | 6 +++-- src/sqlite/SqliteEventLocker.ts | 38 +++++++++++++++------------- 3 files changed, 25 insertions(+), 21 deletions(-) diff --git a/src/sqlite/AbstractSqliteAccessor.ts b/src/sqlite/AbstractSqliteAccessor.ts index 3d07f33..dc5d249 100644 --- a/src/sqlite/AbstractSqliteAccessor.ts +++ b/src/sqlite/AbstractSqliteAccessor.ts @@ -17,7 +17,7 @@ export abstract class AbstractSqliteAccessor { #initLocker = new Lock(); #initialized = false; - constructor(c: Pick) { + constructor(c: Partial>) { if (!c.viewModelSqliteDb && !c.viewModelSqliteDbFactory) throw new TypeError('either viewModelSqliteDb or viewModelSqliteDbFactory argument required'); diff --git a/src/sqlite/AbstractSqliteView.ts b/src/sqlite/AbstractSqliteView.ts index 63b26dd..52aa020 100644 --- a/src/sqlite/AbstractSqliteView.ts +++ b/src/sqlite/AbstractSqliteView.ts @@ -1,8 +1,9 @@ import { IContainer, IEvent, IEventLocker, ILogger, IViewLocker } from '../interfaces'; import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; -export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { +export abstract class AbstractSqliteView extends AbstractSqliteAccessor implements IViewLocker, IEventLocker { protected readonly schemaVersion: string; protected readonly viewLocker: SqliteViewLocker; @@ -13,9 +14,10 @@ export abstract class AbstractSqliteView implements IViewLocker, IEventLocker { return this.viewLocker.ready; } - constructor(options: Pick + constructor(options: Partial> & SqliteEventLockerParams & SqliteViewLockerParams) { + super(options); this.schemaVersion = options.schemaVersion; this.viewLocker = new SqliteViewLocker(options); diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index 4322cec..9beedda 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -6,24 +6,26 @@ import { SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; -export type SqliteEventLockerParams = SqliteProjectionDataParams & { - - /** - * (Optional) SQLite table name where event locks are stored - * - * @default "tbl_event_lock" - */ - eventLockTableName?: string; - - /** - * (Optional) Time-to-live (TTL) duration in milliseconds - * for which an event remains in the "processing" state until released. - * - * @default 15_000 - */ - eventLockTtl?: number; -} - & Pick; +export type SqliteEventLockerParams = + SqliteProjectionDataParams + & Pick + & { + + /** + * (Optional) SQLite table name where event locks are stored + * + * @default "tbl_event_lock" + */ + eventLockTableName?: string; + + /** + * (Optional) Time-to-live (TTL) duration in milliseconds + * for which an event remains in the "processing" state until released. + * + * @default 15_000 + */ + eventLockTtl?: number; + }; export class SqliteEventLocker extends AbstractSqliteAccessor implements IEventLocker { From 83198caf9e053d758a9ba10c3e68962c4cd3c417 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 15:43:57 +0100 Subject: [PATCH 053/169] Refactor SqliteViewLocker to extend AbstractSqliteAccessor and streamline database interactions --- src/sqlite/SqliteViewLocker.ts | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index 12efe5d..0c3d113 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -4,6 +4,7 @@ import { Deferred } from '../utils'; import { promisify } from 'util'; import { viewLockTableInit } from './queries'; import { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; const delay = promisify(setTimeout); export type SqliteViewLockerParams = SqliteProjectionDataParams & { @@ -23,9 +24,8 @@ export type SqliteViewLockerParams = SqliteProjectionDataParams & { viewLockTtl?: number; }; -export class SqliteViewLocker implements IViewLocker { +export class SqliteViewLocker extends AbstractSqliteAccessor implements IViewLocker { - #db: Database; #projectionName: string; #schemaVersion: string; @@ -33,22 +33,22 @@ export class SqliteViewLocker implements IViewLocker { #viewLockTtl: number; #logger: ILogger | undefined; - #upsertTableLockQuery: Statement<[string, string, number], void>; - #updateTableLockQuery: Statement<[number, string, string], void>; - #removeTableLockQuery: Statement<[string, string], void>; + #upsertTableLockQuery!: Statement<[string, string, number], void>; + #updateTableLockQuery!: Statement<[number, string, string], void>; + #removeTableLockQuery!: Statement<[string, string], void>; #lockMarker: Deferred | undefined; #lockProlongationTimeout: NodeJS.Timeout | undefined; - constructor(o: Pick & SqliteViewLockerParams) { - if (!o.viewModelSqliteDb) - throw new TypeError('viewModelSqliteDb argument required'); + constructor(o: Partial> + & SqliteViewLockerParams) { + super(o); + if (!o.projectionName) throw new TypeError('projectionName argument required'); if (!o.schemaVersion) throw new TypeError('schemaVersion argument required'); - this.#db = o.viewModelSqliteDb; this.#projectionName = o.projectionName; this.#schemaVersion = o.schemaVersion; @@ -57,11 +57,12 @@ export class SqliteViewLocker implements IViewLocker { this.#logger = o.logger && 'child' in o.logger ? o.logger.child({ service: this.constructor.name }) : o.logger; + } + protected initialize(db: Database) { + db.exec(viewLockTableInit(this.#viewLockTableName)); - this.#db.exec(viewLockTableInit(this.#viewLockTableName)); - - this.#upsertTableLockQuery = this.#db.prepare(` + this.#upsertTableLockQuery = db.prepare(` INSERT INTO ${this.#viewLockTableName} (projection_name, schema_version, locked_till) VALUES (?, ?, ?) ON CONFLICT (projection_name, schema_version) @@ -72,7 +73,7 @@ export class SqliteViewLocker implements IViewLocker { OR locked_till < excluded.locked_till `); - this.#updateTableLockQuery = this.#db.prepare(` + this.#updateTableLockQuery = db.prepare(` UPDATE ${this.#viewLockTableName} SET locked_till = ? @@ -82,7 +83,7 @@ export class SqliteViewLocker implements IViewLocker { AND locked_till IS NOT NULL `); - this.#removeTableLockQuery = this.#db.prepare(` + this.#removeTableLockQuery = db.prepare(` UPDATE ${this.#viewLockTableName} SET locked_till = NULL @@ -100,6 +101,8 @@ export class SqliteViewLocker implements IViewLocker { async lock() { this.#lockMarker = new Deferred(); + await this.assertConnection(); + let lockAcquired = false; while (!lockAcquired) { const lockedTill = Date.now() + this.#viewLockTtl; From 6eea5cbca891d7d6c1434551542f76056c6940d4 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 15:44:13 +0100 Subject: [PATCH 054/169] Update type definitions settings in package.json and tsconfig.json --- .gitignore | 1 + package.json | 12 ++++++------ tsconfig.json | 3 ++- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/.gitignore b/.gitignore index ea0b7b1..041d411 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,7 @@ app/tests/coverage/ coverage/ .nyc_output/ dist/ +types/ *.tgz # IDE's diff --git a/package.json b/package.json index dbb6319..3493658 100644 --- a/package.json +++ b/package.json @@ -11,14 +11,14 @@ "url": "https://github.com/snatalenko/node-cqrs.git" }, "main": "./dist/index.js", - "types": "./src/index.ts", + "types": "./types/index.d.ts", "typesVersions": { "*": { "rabbitmq": [ - "src/rabbitmq/index.ts" + "types/rabbitmq/index.d.ts" ], "sqlite": [ - "src/sqlite/index.ts" + "types/sqlite/index.d.ts" ] } }, @@ -26,17 +26,17 @@ ".": { "require": "./dist/index.js", "import": "./dist/index.js", - "types": "./src/index.ts" + "types": "./types/index.d.ts" }, "./rabbitmq": { "require": "./dist/rabbitmq/index.js", "import": "./dist/rabbitmq/index.js", - "types": "./src/rabbitmq/index.ts" + "types": "./types/rabbitmq/index.d.ts" }, "./sqlite": { "require": "./dist/sqlite/index.js", "import": "./dist/sqlite/index.js", - "types": "./src/sqlite/index.ts" + "types": "./types/sqlite/index.d.ts" } }, "directories": { diff --git a/tsconfig.json b/tsconfig.json index b0180a9..28efcd5 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -7,7 +7,8 @@ "alwaysStrict": false, "outDir": "./dist", "target": "ESNext", - "declaration": false, + "declaration": true, + "declarationDir": "./types", "allowSyntheticDefaultImports": true, "resolveJsonModule": true, "strict": true, From 0fd858a60ab149e60580e94836f4fac616eb3437 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 16:05:35 +0100 Subject: [PATCH 055/169] Add missing initialize method in SqliteObjectView --- src/sqlite/SqliteObjectView.ts | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/sqlite/SqliteObjectView.ts b/src/sqlite/SqliteObjectView.ts index fee1add..ac99aed 100644 --- a/src/sqlite/SqliteObjectView.ts +++ b/src/sqlite/SqliteObjectView.ts @@ -1,6 +1,7 @@ import { AbstractSqliteView } from './AbstractSqliteView'; import { IObjectStorage, IEventLocker } from '../interfaces'; import { SqliteObjectStorage } from './SqliteObjectStorage'; +import { Database } from 'better-sqlite3'; export class SqliteObjectView extends AbstractSqliteView implements IObjectStorage, IEventLocker { @@ -23,6 +24,11 @@ export class SqliteObjectView extends AbstractSqliteView implements IOb }); } + // eslint-disable-next-line class-methods-use-this, @typescript-eslint/no-unused-vars + protected initialize(db: Database): Promise | void { + // No need to initialize the table here, it's done in SqliteObjectStorage + } + async get(id: string): Promise { if (!this.ready) await this.once('ready'); From 9e187b8ccda78aaf073ad0afb64815b393478820 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 16:56:04 +0100 Subject: [PATCH 056/169] 1.0.0-rc.7 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 57c2567..a2f74d9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.7](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.6...v1.0.0-rc.7) (2025-04-13) + + +### Changes + +* Remove `publishAsync` setting, simplify publishing sequence ([79257e5](https://github.com/snatalenko/node-cqrs/commit/79257e59d322df5dd8e41bedf5273c97ae77b609)) + + # [1.0.0-rc.6](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.5...v1.0.0-rc.6) (2025-03-21) diff --git a/package-lock.json b/package-lock.json index b547e2d..8a41ef6 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.6", + "version": "1.0.0-rc.7", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.6", + "version": "1.0.0-rc.7", "license": "MIT", "dependencies": { "di0": "^1.0.0" diff --git a/package.json b/package.json index 56f0886..da7d9d2 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.6", + "version": "1.0.0-rc.7", "description": "Basic ES6 backbone for CQRS app development", "repository": { "type": "git", From 5ae3d2ba78a5d124452f57dfd43a41b493a8ed28 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 16:58:44 +0100 Subject: [PATCH 057/169] Add optional metadata to event publishing methods --- src/EventDispatcher.ts | 7 +++-- src/in-memory/InMemoryMessageBus.ts | 47 ++++++++++++++-------------- src/interfaces/IEventBus.ts | 2 +- src/interfaces/IMessageBus.ts | 2 +- tests/unit/EventDispatcher.test.ts | 4 +-- tests/unit/dispatch-pipeline.test.ts | 4 +-- 6 files changed, 34 insertions(+), 32 deletions(-) diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 1521846..7efca47 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -115,8 +115,11 @@ export class EventDispatcher implements IEventDispatcher { const events = data.map(e => e.event).filter(notEmpty); try { - for (const event of events) - this.eventBus.publish(event); + for (const batch of data) { + const { event, ...meta } = batch; + if (event) + this.eventBus.publish(event, meta); + } resolve(events); } diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index 261e1c5..b678096 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -14,18 +14,17 @@ import { */ export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcessor { - #handlers: Map> = new Map(); - #name: string | undefined; - #uniqueEventHandlers: boolean; - // eslint-disable-next-line no-use-before-define - #queues: Map = new Map(); - - constructor({ name, uniqueEventHandlers = !!name }: { - name?: string, + protected handlers: Map> = new Map(); + protected uniqueEventHandlers: boolean; + protected queueName: string | undefined; + protected queues: Map = new Map(); + + constructor({ queueName, uniqueEventHandlers = !!queueName }: { + queueName?: string, uniqueEventHandlers?: boolean } = {}) { - this.#name = name; - this.#uniqueEventHandlers = uniqueEventHandlers; + this.queueName = queueName; + this.uniqueEventHandlers = uniqueEventHandlers; } /** @@ -43,23 +42,23 @@ export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcess // For example, for sending a welcome email, NotificationReceptor will subscribe to "notifications:userCreated". // Since we use an in-memory bus, there is no need to track message handling by multiple distributed // subscribers, and we only need to make sure that no more than 1 such subscriber will be created - if (!this.#handlers.has(messageType)) - this.#handlers.set(messageType, new Set()); - else if (this.#uniqueEventHandlers) - throw new Error(`"${messageType}" handler is already set up on the "${this.#name}" queue`); + if (!this.handlers.has(messageType)) + this.handlers.set(messageType, new Set()); + else if (this.uniqueEventHandlers) + throw new Error(`"${messageType}" handler is already set up on the "${this.queueName}" queue`); - this.#handlers.get(messageType)?.add(handler); + this.handlers.get(messageType)?.add(handler); } /** * Get or create a named queue. * Named queues support only one handler per event type. */ - queue(name: string): IObservable { - let queue = this.#queues.get(name); + queue(queueName: string): IObservable { + let queue = this.queues.get(queueName); if (!queue) { - queue = new InMemoryMessageBus({ name, uniqueEventHandlers: true }); - this.#queues.set(name, queue); + queue = new InMemoryMessageBus({ queueName, uniqueEventHandlers: true }); + this.queues.set(queueName, queue); } return queue; @@ -75,10 +74,10 @@ export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcess throw new TypeError('handler argument must be a Function'); if (arguments.length !== 2) throw new TypeError(`2 arguments are expected, but ${arguments.length} received`); - if (!this.#handlers.has(messageType)) + if (!this.handlers.has(messageType)) throw new Error(`No ${messageType} subscribers found`); - this.#handlers.get(messageType)?.delete(handler); + this.handlers.get(messageType)?.delete(handler); } /** @@ -90,7 +89,7 @@ export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcess if (typeof command.type !== 'string' || !command.type.length) throw new TypeError('command.type argument must be a non-empty String'); - const handlers = this.#handlers.get(command.type); + const handlers = this.handlers.get(command.type); if (!handlers || !handlers.size) throw new Error(`No '${command.type}' subscribers found`); if (handlers.size > 1) @@ -111,8 +110,8 @@ export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcess throw new TypeError('event.type argument must be a non-empty String'); const handlers = [ - ...this.#handlers.get(event.type) || [], - ...Array.from(this.#queues.values()).map(namedQueue => + ...this.handlers.get(event.type) || [], + ...Array.from(this.queues.values()).map(namedQueue => (e: IEvent, m?: Record) => namedQueue.publish(e, m)) ]; diff --git a/src/interfaces/IEventBus.ts b/src/interfaces/IEventBus.ts index f36c593..0e37e07 100644 --- a/src/interfaces/IEventBus.ts +++ b/src/interfaces/IEventBus.ts @@ -2,7 +2,7 @@ import { IEvent } from './IEvent'; import { IObservable, isIObservable } from './IObservable'; export interface IEventBus extends IObservable { - publish(event: IEvent): Promise; + publish(event: IEvent, meta?: Record): Promise; } export const isIEventBus = (obj: unknown) => diff --git a/src/interfaces/IMessageBus.ts b/src/interfaces/IMessageBus.ts index d986b20..5b626a3 100644 --- a/src/interfaces/IMessageBus.ts +++ b/src/interfaces/IMessageBus.ts @@ -4,5 +4,5 @@ import { IObservable } from './IObservable'; export interface IMessageBus extends IObservable { send(command: ICommand): Promise; - publish(event: IEvent): Promise; + publish(event: IEvent, meta?: Record): Promise; } diff --git a/tests/unit/EventDispatcher.test.ts b/tests/unit/EventDispatcher.test.ts index f88048f..686082c 100644 --- a/tests/unit/EventDispatcher.test.ts +++ b/tests/unit/EventDispatcher.test.ts @@ -24,8 +24,8 @@ describe('EventDispatcher', () => { expect(processorMock.process).toHaveBeenCalledTimes(1); expect(eventBus.publish).toHaveBeenCalledTimes(2); - expect(eventBus.publish).toHaveBeenCalledWith(event1); - expect(eventBus.publish).toHaveBeenCalledWith(event2); + expect(eventBus.publish).toHaveBeenCalledWith(event1, {}); + expect(eventBus.publish).toHaveBeenCalledWith(event2, {}); expect(result).toEqual([event1, event2]); }); diff --git a/tests/unit/dispatch-pipeline.test.ts b/tests/unit/dispatch-pipeline.test.ts index 0fc7569..5797e74 100644 --- a/tests/unit/dispatch-pipeline.test.ts +++ b/tests/unit/dispatch-pipeline.test.ts @@ -79,7 +79,7 @@ describe('eventDispatchPipeline', () => { await eventDispatcher.dispatch([testEvent], { origin: 'external' }); expect(eventBus.publish).toHaveBeenCalledTimes(2); - expect(eventBus.publish).toHaveBeenNthCalledWith(1, testEvent); - expect(eventBus.publish).toHaveBeenNthCalledWith(2, testEvent); + expect(eventBus.publish).toHaveBeenNthCalledWith(1, testEvent, { origin: 'internal' }); + expect(eventBus.publish).toHaveBeenNthCalledWith(2, testEvent, { origin: 'external' }); }); }); From 0a5cfb1c4d2bbddc39eb9ff7b9f1b59fb2552129 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 16:59:32 +0100 Subject: [PATCH 058/169] 1.0.0-rc.8 --- CHANGELOG.md | 12 ++++++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 15 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a2f74d9..c07877c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,15 @@ +# [1.0.0-rc.8](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.7...v1.0.0-rc.8) (2025-04-13) + + +### Features + +* RabbitMQ integration classes to support event publishing and subscription ([991c223](https://github.com/snatalenko/node-cqrs/commit/991c2233185d3610a2b8930f6930a03c0cdea01d)) + +### Changes + +* Move validation, snapshot and event persistence to EventDispatcher pipeline ([e781f7c](https://github.com/snatalenko/node-cqrs/commit/e781f7c6c2e4f7c9f8c4615b170d0d29d3e8f133)) + + # [1.0.0-rc.7](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.6...v1.0.0-rc.7) (2025-04-13) diff --git a/package-lock.json b/package-lock.json index e902bed..30f5fd9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.7", + "version": "1.0.0-rc.8", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.7", + "version": "1.0.0-rc.8", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.0.0", diff --git a/package.json b/package.json index 7d30fcf..b0afa83 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.7", + "version": "1.0.0-rc.8", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 7299aba3881204e573da95a4e40ea56b5a3bf214 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 21:06:25 +0100 Subject: [PATCH 059/169] Remove integration test step from CI workflow --- .github/workflows/tests.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 2fe7111..4003a5b 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -22,4 +22,3 @@ jobs: env: CI: true - run: npm run test - - run: npm run test:integration From 4549c7eb85f189198bcd38437e5220a5bcc59d19 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 21:07:13 +0100 Subject: [PATCH 060/169] Make code ES2022-compatible --- package.json | 4 ++-- src/EventDispatcher.ts | 9 ++++++++- src/rabbitmq/RabbitMqGateway.ts | 2 +- tsconfig.json | 2 +- 4 files changed, 12 insertions(+), 5 deletions(-) diff --git a/package.json b/package.json index b0afa83..7f3ad1f 100644 --- a/package.json +++ b/package.json @@ -45,7 +45,7 @@ "test": "tests" }, "engines": { - "node": ">=10.3.0" + "node": ">=18.0.0" }, "scripts": { "pretest": "npm run build", @@ -96,4 +96,4 @@ "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } -} +} \ No newline at end of file diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 7efca47..437d97e 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -146,7 +146,14 @@ export class EventDispatcher implements IEventDispatcher { if (!isEventSet(events) || events.length === 0) throw new Error('dispatch requires a non-empty array of events'); - const { promise, resolve, reject } = Promise.withResolvers(); + // const { promise, resolve, reject } = Promise.withResolvers(); + let resolve!: (value: IEventSet | PromiseLike) => void; + let reject!: (reason?: any) => void; + const promise = new Promise((res, rej) => { + resolve = res; + reject = rej; + }); + const envelope: EventBatchEnvelope = { data: events.map(event => ({ event, diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 48121b6..f43b6e6 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -144,7 +144,7 @@ export class RabbitMqGateway { async #stopConsuming() { this.#logger?.info(`${this.#appId}: Stopping all consumers...`); - const cancellations = this.#queueConsumers.entries().map(async ([queueName, { channel, consumerTag }]) => { + const cancellations = [...this.#queueConsumers.entries()].map(async ([queueName, { channel, consumerTag }]) => { this.#logger?.debug(`${this.#appId}: Cancelling consumer "${consumerTag}" for queue "${queueName}"`); try { await channel.cancel(consumerTag); diff --git a/tsconfig.json b/tsconfig.json index 28efcd5..5e99f1f 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -6,7 +6,7 @@ "sourceMap": true, "alwaysStrict": false, "outDir": "./dist", - "target": "ESNext", + "target": "ES2022", "declaration": true, "declarationDir": "./types", "allowSyntheticDefaultImports": true, From b90ccd878b22eb33655b67805e3b53b2bce50079 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 13 Apr 2025 21:07:25 +0100 Subject: [PATCH 061/169] 1.0.0-rc.9 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 4 ++-- 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c07877c..355bdf3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.9](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.8...v1.0.0-rc.9) (2025-04-13) + + + # [1.0.0-rc.8](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.7...v1.0.0-rc.8) (2025-04-13) diff --git a/package-lock.json b/package-lock.json index 30f5fd9..834f5aa 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.8", + "version": "1.0.0-rc.9", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.8", + "version": "1.0.0-rc.9", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.0.0", diff --git a/package.json b/package.json index 7f3ad1f..7f91d08 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.8", + "version": "1.0.0-rc.9", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", @@ -96,4 +96,4 @@ "better-sqlite3": "^11.3.0", "md5": "^2.3.0" } -} \ No newline at end of file +} From b2724739b3ff483b13c0cfeea30c73c7d8ab8b94 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 14 Apr 2025 00:29:44 +0100 Subject: [PATCH 062/169] Fix: asserting db connection in prolongLock and unlock methods --- src/sqlite/SqliteViewLocker.ts | 8 ++++++-- tests/unit/sqlite/SqliteViewLocker.test.ts | 4 ++-- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index 0c3d113..b5f8e49 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -136,7 +136,9 @@ export class SqliteViewLocker extends AbstractSqliteAccessor implements IViewLoc this.#logger?.debug(`"${this.#projectionName}" lock refresh canceled`); } - private prolongLock() { + private async prolongLock() { + await this.assertConnection(); + const lockedTill = Date.now() + this.#viewLockTtl; const r = this.#updateTableLockQuery.run(lockedTill, this.#projectionName, this.#schemaVersion); if (r.changes !== 1) @@ -145,12 +147,14 @@ export class SqliteViewLocker extends AbstractSqliteAccessor implements IViewLoc this.#logger?.debug(`"${this.#projectionName}" lock prolonged for ${this.#viewLockTtl}s`); } - unlock() { + async unlock() { this.#lockMarker?.resolve(); this.#lockMarker = undefined; this.cancelLockProlongation(); + await this.assertConnection(); + const updateResult = this.#removeTableLockQuery.run(this.#projectionName, this.#schemaVersion); if (updateResult.changes === 1) this.#logger?.debug(`"${this.#projectionName}" lock released`); diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts index 9c868ca..fd0f8c5 100644 --- a/tests/unit/sqlite/SqliteViewLocker.test.ts +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -96,7 +96,7 @@ describe('SqliteViewLocker', function () { it('should release the lock upon unlock()', async function () { await firstLock.lock(); - firstLock.unlock(); + await firstLock.unlock(); const row = viewModelSqliteDb.prepare('SELECT * FROM tbl_view_lock WHERE projection_name = ? AND schema_version = ?') .get('test', '1.0') as any; @@ -106,7 +106,7 @@ describe('SqliteViewLocker', function () { it('should fail to prolong the lock if already released', async function () { await firstLock.lock(); - firstLock.unlock(); + await firstLock.unlock(); let error; try { From 54348aca4e751a0dd987c9c7e6e7c2bb5bfa2bd0 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 14 Apr 2025 00:29:56 +0100 Subject: [PATCH 063/169] 1.0.0-rc.10 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 355bdf3..79cf36d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.10](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.9...v1.0.0-rc.10) (2025-04-13) + + +### Fixes + +* Asserting db connection in prolongLock and unlock methods ([b272473](https://github.com/snatalenko/node-cqrs/commit/b2724739b3ff483b13c0cfeea30c73c7d8ab8b94)) + + # [1.0.0-rc.9](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.8...v1.0.0-rc.9) (2025-04-13) diff --git a/package-lock.json b/package-lock.json index 834f5aa..151260d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.9", + "version": "1.0.0-rc.10", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.9", + "version": "1.0.0-rc.10", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.0.0", diff --git a/package.json b/package.json index 7f91d08..a688324 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.9", + "version": "1.0.0-rc.10", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 1d0e827da71c760739588a37ae6afe63a4fa8d34 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 8 May 2025 23:35:26 +0100 Subject: [PATCH 064/169] Chore: use `structuredClone` for snapshot creation --- .eslintrc.json | 799 --------------------------------------- package-lock.json | 24 +- package.json | 1 + src/AbstractAggregate.ts | 13 +- 4 files changed, 23 insertions(+), 814 deletions(-) delete mode 100644 .eslintrc.json diff --git a/.eslintrc.json b/.eslintrc.json deleted file mode 100644 index bacc24f..0000000 --- a/.eslintrc.json +++ /dev/null @@ -1,799 +0,0 @@ -{ - "env": { - "es6": true, - "node": true - }, - "parserOptions": { - "sourceType": "script", - "ecmaVersion": 2018 - }, - "rules": { - "accessor-pairs": "off", - "array-callback-return": "error", - "block-scoped-var": "error", - "complexity": [ - "off", - 11 - ], - "class-methods-use-this": [ - "warn" - ], - "consistent-return": "warn", - "curly": [ - "warn", - "multi-or-nest", - "consistent" - ], - "default-case": [ - "error", - { - "commentPattern": "^no default$" - } - ], - "dot-notation": [ - "error", - { - "allowKeywords": true - } - ], - "dot-location": [ - "error", - "property" - ], - "eqeqeq": [ - "warn", - "allow-null" - ], - "guard-for-in": "error", - "no-alert": "warn", - "no-caller": "error", - "no-case-declarations": "error", - "no-div-regex": "off", - "no-else-return": "warn", - "no-empty-function": [ - "warn", - { - "allow": [ - "arrowFunctions", - "methods", - "getters" - ] - } - ], - "no-empty-pattern": "error", - "no-eq-null": "off", - "no-eval": "error", - "no-extend-native": "error", - "no-extra-bind": "error", - "no-extra-label": "error", - "no-fallthrough": "error", - "no-floating-decimal": "error", - "no-global-assign": [ - "error", - { - "exceptions": [] - } - ], - "no-native-reassign": "off", - "no-implicit-coercion": [ - "off", - { - "boolean": false, - "number": true, - "string": true, - "allow": [] - } - ], - "no-implicit-globals": "off", - "no-implied-eval": "error", - "no-invalid-this": "off", - "no-iterator": "error", - "no-labels": [ - "error", - { - "allowLoop": false, - "allowSwitch": false - } - ], - "no-lone-blocks": "error", - "no-loop-func": "error", - "no-magic-numbers": [ - "off", - { - "ignore": [], - "ignoreArrayIndexes": true, - "enforceConst": true, - "detectObjects": false - } - ], - "no-multi-spaces": "warn", - "no-multi-str": "error", - "no-new": "error", - "no-new-func": "error", - "no-new-wrappers": "error", - "no-octal": "error", - "no-octal-escape": "error", - "no-param-reassign": [ - "warn", - { - "props": false - } - ], - "no-proto": "error", - "no-redeclare": "error", - "no-restricted-properties": [ - "error", - { - "object": "arguments", - "property": "callee", - "message": "arguments.callee is deprecated" - }, - { - "property": "__defineGetter__", - "message": "Please use Object.defineProperty instead." - }, - { - "property": "__defineSetter__", - "message": "Please use Object.defineProperty instead." - }, - { - "object": "Math", - "property": "pow", - "message": "Use the exponentiation operator (**) instead." - } - ], - "no-return-assign": "error", - "no-return-await": "error", - "no-script-url": "error", - "no-self-assign": "error", - "no-self-compare": "error", - "no-sequences": "error", - "no-throw-literal": "error", - "no-unmodified-loop-condition": "off", - "no-unused-expressions": [ - "error", - { - "allowShortCircuit": false, - "allowTernary": false - } - ], - "no-unused-labels": "error", - "no-useless-call": "off", - "no-useless-concat": "error", - "no-useless-escape": "error", - "no-useless-return": "error", - "no-void": "error", - "no-warning-comments": [ - "off", - { - "terms": [ - "todo", - "fixme", - "xxx" - ], - "location": "start" - } - ], - "no-with": "error", - "radix": "error", - "vars-on-top": "error", - "wrap-iife": [ - "error", - "outside", - { - "functionPrototypeMethods": false - } - ], - "yoda": "error", - "no-mixed-requires": "warn", - "callback-return": "off", - "global-require": "error", - "handle-callback-err": "off", - "no-new-require": "error", - "no-path-concat": "error", - "no-process-env": "off", - "no-process-exit": "off", - "no-restricted-modules": "off", - "no-sync": "off", - "arrow-body-style": [ - "warn", - "as-needed" - ], - "arrow-parens": [ - "error", - "as-needed" - ], - "arrow-spacing": [ - "error", - { - "before": true, - "after": true - } - ], - "constructor-super": "error", - "generator-star-spacing": [ - "error", - { - "before": false, - "after": true - } - ], - "no-class-assign": "error", - "no-confusing-arrow": [ - "error", - { - "allowParens": true - } - ], - "no-const-assign": "error", - "no-dupe-class-members": "error", - "no-duplicate-imports": "error", - "no-new-symbol": "error", - "no-restricted-imports": "off", - "no-this-before-super": "error", - "no-useless-computed-key": "error", - "no-useless-constructor": "error", - "no-useless-rename": [ - "error", - { - "ignoreDestructuring": false, - "ignoreImport": false, - "ignoreExport": false - } - ], - "no-var": "error", - "object-shorthand": [ - "warn", - "always", - { - "ignoreConstructors": false, - "avoidQuotes": true - } - ], - "prefer-arrow-callback": [ - "warn", - { - "allowNamedFunctions": false, - "allowUnboundThis": true - } - ], - "prefer-const": [ - "error", - { - "destructuring": "any", - "ignoreReadBeforeAssign": true - } - ], - "prefer-numeric-literals": "error", - "prefer-reflect": "off", - "prefer-rest-params": "warn", - "prefer-spread": "error", - "prefer-template": "warn", - "require-yield": "error", - "rest-spread-spacing": [ - "error", - "never" - ], - "sort-imports": [ - "off", - { - "ignoreCase": false, - "ignoreMemberSort": false, - "memberSyntaxSortOrder": [ - "none", - "all", - "multiple", - "single" - ] - } - ], - "symbol-description": "warn", - "template-curly-spacing": "error", - "yield-star-spacing": [ - "error", - "after" - ], - "comma-dangle": [ - "warn", - "never" - ], - "no-cond-assign": [ - "error", - "always" - ], - "no-console": "warn", - "no-constant-condition": "warn", - "no-control-regex": "error", - "no-debugger": "error", - "no-dupe-args": "error", - "no-dupe-keys": "error", - "no-duplicate-case": "error", - "no-empty": "warn", - "no-empty-character-class": "error", - "no-ex-assign": "error", - "no-extra-boolean-cast": "error", - "no-extra-parens": [ - "off", - "all", - { - "conditionalAssign": true, - "nestedBinaryExpressions": false, - "returnAssign": false - } - ], - "no-extra-semi": "error", - "no-func-assign": "error", - "no-inner-declarations": "error", - "no-invalid-regexp": "error", - "no-irregular-whitespace": "error", - "no-obj-calls": "error", - "no-prototype-builtins": "error", - "no-regex-spaces": "error", - "no-sparse-arrays": "error", - "no-template-curly-in-string": "error", - "no-unexpected-multiline": "error", - "no-unsafe-finally": "error", - "no-unsafe-negation": "error", - "no-negated-in-lhs": "off", - "use-isnan": "error", - "valid-jsdoc": "off", - "valid-typeof": [ - "error", - { - "requireStringLiterals": true - } - ], - "array-bracket-spacing": [ - "error", - "never" - ], - "block-spacing": [ - "error", - "always" - ], - "brace-style": [ - "warn", - "stroustrup", - { - "allowSingleLine": false - } - ], - "camelcase": [ - "warn", - { - "properties": "never" - } - ], - "comma-spacing": [ - "error", - { - "before": false, - "after": true - } - ], - "comma-style": [ - "error", - "last" - ], - "computed-property-spacing": [ - "error", - "never" - ], - "consistent-this": "off", - "eol-last": [ - "error", - "always" - ], - "func-call-spacing": [ - "error", - "never" - ], - "func-name-matching": [ - "off", - "always", - { - "includeCommonJSModuleExports": false - } - ], - "func-names": "warn", - "func-style": [ - "off", - "expression" - ], - "id-blacklist": "off", - "id-length": "off", - "id-match": "off", - "indent": [ - "warn", - "tab", - { - "SwitchCase": 1, - "VariableDeclarator": 1, - "outerIIFEBody": 1, - "FunctionDeclaration": { - "parameters": 1, - "body": 1 - }, - "FunctionExpression": { - "parameters": 1, - "body": 1 - } - } - ], - "jsx-quotes": [ - "off", - "prefer-double" - ], - "key-spacing": [ - "error", - { - "beforeColon": false, - "afterColon": true - } - ], - "keyword-spacing": [ - "error", - { - "before": true, - "after": true, - "overrides": { - "return": { - "after": true - }, - "throw": { - "after": true - }, - "case": { - "after": true - } - } - } - ], - "line-comment-position": [ - "off", - { - "position": "above", - "ignorePattern": "", - "applyDefaultPatterns": true - } - ], - "linebreak-style": [ - "error", - "unix" - ], - "lines-around-comment": [ - "warn", - { - "beforeBlockComment": true, - "afterBlockComment": false, - "beforeLineComment": true, - "afterLineComment": false, - "allowBlockStart": true, - "allowObjectStart": true, - "allowArrayStart": true - } - ], - "lines-around-directive": [ - "warn", - { - "before": "never", - "after": "always" - } - ], - "max-depth": [ - "off", - 4 - ], - "max-len": [ - "warn", - 120, - 2, - { - "ignoreUrls": true, - "ignoreComments": false, - "ignoreRegExpLiterals": true, - "ignoreStrings": true, - "ignoreTemplateLiterals": true - } - ], - "max-lines": [ - "off", - { - "max": 300, - "skipBlankLines": true, - "skipComments": true - } - ], - "max-nested-callbacks": "off", - "max-params": [ - "off", - 3 - ], - "max-statements": [ - "off", - 10 - ], - "max-statements-per-line": [ - "off", - { - "max": 1 - } - ], - "multiline-ternary": [ - "off", - "never" - ], - "new-cap": [ - "error", - { - "newIsCap": true, - "newIsCapExceptions": [], - "capIsNew": false, - "capIsNewExceptions": [ - "Immutable.Map", - "Immutable.Set", - "Immutable.List" - ] - } - ], - "new-parens": "error", - "newline-after-var": "off", - "newline-before-return": "off", - "newline-per-chained-call": [ - "error", - { - "ignoreChainWithDepth": 4 - } - ], - "no-array-constructor": "error", - "no-bitwise": "error", - "no-continue": "off", - "no-inline-comments": "off", - "no-lonely-if": "error", - "no-mixed-operators": [ - "warn", - { - "groups": [ - [ - "+", - "-", - "*", - "/", - "%", - "**" - ], - [ - "&", - "|", - "^", - "~", - "<<", - ">>", - ">>>" - ], - [ - "==", - "!=", - "===", - "!==", - ">", - ">=", - "<", - "<=" - ], - [ - "&&", - "||" - ], - [ - "in", - "instanceof" - ] - ], - "allowSamePrecedence": false - } - ], - "no-mixed-spaces-and-tabs": "warn", - "no-multiple-empty-lines": [ - "warn", - { - "max": 2, - "maxEOF": 1 - } - ], - "no-negated-condition": "off", - "no-nested-ternary": "warn", - "no-new-object": "error", - "no-plusplus": [ - "warn", - { - "allowForLoopAfterthoughts": true - } - ], - "no-restricted-syntax": [ - "error", - "ForInStatement", - "LabeledStatement", - "WithStatement" - ], - "no-spaced-func": "error", - "no-ternary": "off", - "no-trailing-spaces": "warn", - "no-underscore-dangle": [ - "off", - { - "allowAfterThis": true - } - ], - "no-unneeded-ternary": [ - "error", - { - "defaultAssignment": false - } - ], - "no-whitespace-before-property": "error", - "object-curly-spacing": [ - "warn", - "always" - ], - "object-curly-newline": [ - "off", - { - "ObjectExpression": { - "minProperties": 0, - "multiline": true - }, - "ObjectPattern": { - "minProperties": 0, - "multiline": true - } - } - ], - "object-property-newline": [ - "error", - { - "allowMultiplePropertiesPerLine": true - } - ], - "one-var": [ - "error", - "never" - ], - "one-var-declaration-per-line": [ - "error", - "always" - ], - "operator-assignment": [ - "error", - "always" - ], - "operator-linebreak": "off", - "padded-blocks": [ - "off", - "never" - ], - "quote-props": [ - "error", - "as-needed", - { - "keywords": false, - "unnecessary": true, - "numbers": false - } - ], - "quotes": [ - "warn", - "single", - { - "avoidEscape": true - } - ], - "require-jsdoc": [ - "warn", - { - "require": { - "FunctionDeclaration": false, - "MethodDefinition": true, - "ClassDeclaration": false, - "ArrowFunctionExpression": false - } - } - ], - "semi": [ - "error", - "always" - ], - "semi-spacing": [ - "error", - { - "before": false, - "after": true - } - ], - "sort-keys": [ - "off", - "asc", - { - "caseSensitive": false, - "natural": true - } - ], - "sort-vars": "off", - "space-before-blocks": "error", - "space-before-function-paren": [ - "error", - { - "anonymous": "always", - "named": "never", - "asyncArrow": "always" - } - ], - "space-in-parens": [ - "error", - "never" - ], - "space-infix-ops": "error", - "space-unary-ops": [ - "error", - { - "words": true, - "nonwords": false, - "overrides": {} - } - ], - "spaced-comment": [ - "error", - "always", - { - "line": { - "exceptions": [ - "-", - "+" - ], - "markers": [ - "=", - "!" - ] - }, - "block": { - "exceptions": [ - "-", - "+" - ], - "markers": [ - "=", - "!" - ], - "balanced": false - } - } - ], - "unicode-bom": [ - "error", - "never" - ], - "wrap-regex": "off", - "init-declarations": "off", - "no-catch-shadow": "off", - "no-delete-var": "error", - "no-label-var": "error", - "no-restricted-globals": "off", - "no-shadow": "error", - "no-shadow-restricted-names": "error", - "no-undef": "error", - "no-undef-init": "error", - "no-undefined": "off", - "no-unused-vars": [ - "warn", - { - "vars": "local", - "args": "after-used" - } - ], - "no-use-before-define": "error", - "strict": [ - "error", - "global" - ] - } -} diff --git a/package-lock.json b/package-lock.json index 151260d..9218683 100644 --- a/package-lock.json +++ b/package-lock.json @@ -28,6 +28,7 @@ "conventional-changelog": "^3.1.25", "eslint": "^9.24.0", "eslint-plugin-jest": "^28.11.0", + "globals": "^16.1.0", "jest": "^29.7.0", "sinon": "^19.0.2", "ts-jest": "^29.2.5", @@ -36,7 +37,7 @@ "typescript-eslint": "^8.29.0" }, "engines": { - "node": ">=10.3.0" + "node": ">=18.0.0" }, "peerDependencies": { "amqplib": "^0.10.5", @@ -562,6 +563,16 @@ "node": ">=6.9.0" } }, + "node_modules/@babel/traverse/node_modules/globals": { + "version": "11.12.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", + "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, "node_modules/@babel/types": { "version": "7.26.10", "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.26.10.tgz", @@ -3863,13 +3874,16 @@ } }, "node_modules/globals": { - "version": "11.12.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", - "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", + "version": "16.1.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.1.0.tgz", + "integrity": "sha512-aibexHNbb/jiUSObBgpHLj+sIuUmJnYcgXBlrfsiDZ9rt4aF2TFRbyLgZ2iFQuVZ1K5Mx3FVkbKRSgKrbK3K2g==", "dev": true, "license": "MIT", "engines": { - "node": ">=4" + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/graceful-fs": { diff --git a/package.json b/package.json index a688324..70bcdec 100644 --- a/package.json +++ b/package.json @@ -84,6 +84,7 @@ "conventional-changelog": "^3.1.25", "eslint": "^9.24.0", "eslint-plugin-jest": "^28.11.0", + "globals": "^16.1.0", "jest": "^29.7.0", "sinon": "^19.0.2", "ts-jest": "^29.2.5", diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 1c3fdff..57253d0 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -10,13 +10,6 @@ import { import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils'; -/** - * Deep-clone simple JS object - */ -function clone(obj: T): T { - return JSON.parse(JSON.stringify(obj)); -} - const SNAPSHOT_EVENT_TYPE = 'snapshot'; /** @@ -192,11 +185,11 @@ export abstract class AbstractAggregate Date: Thu, 8 May 2025 23:44:47 +0100 Subject: [PATCH 065/169] Change: Cache immediate aggregates to handle concurrent commands --- src/AbstractAggregate.ts | 10 ++- src/AggregateCommandHandler.ts | 96 +++++++++++++-------- src/CqrsContainerBuilder.ts | 2 +- src/interfaces/IAggregate.ts | 32 +++++-- src/utils/Lock.ts | 96 +++++++++++++++------ src/utils/MapAssertable.ts | 30 +++++++ src/utils/index.ts | 1 + tests/unit/AggregateCommandHandler.test.ts | 99 ++++++++++++++++++++-- tests/unit/Lock.test.ts | 33 ++++---- 9 files changed, 303 insertions(+), 96 deletions(-) create mode 100644 src/utils/MapAssertable.ts diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 57253d0..12f7eee 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -55,7 +55,10 @@ export abstract class AbstractAggregate(type: string, payload?: TPayload) { if (typeof type !== 'string' || !type.length) diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index e404a52..1ed7ecc 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -1,23 +1,19 @@ +import { getClassName, Lock, MapAssertable } from './utils'; import { IAggregate, IAggregateConstructor, IAggregateFactory, ICommand, - ICommandBus, ICommandHandler, IContainer, Identifier, IEventSet, IEventStore, - ILogger + ILogger, + IObservable, + isIObservable } from './interfaces'; -import { - iteratorToArray, - getClassName, - subscribe -} from './utils'; - /** * Aggregate command handler. * @@ -25,14 +21,19 @@ import { * Upon command receiving creates an instance of aggregate, * restores its state, passes command and commits emitted events to event store. */ -export class AggregateCommandHandler implements ICommandHandler { +export class AggregateCommandHandler implements ICommandHandler { #eventStore: IEventStore; #logger?: ILogger; - - #aggregateFactory: IAggregateFactory; + #aggregateFactory: IAggregateFactory; #handles: string[]; + /** Aggregate instances cache for concurrent command handling */ + #aggregatesCache: MapAssertable> = new MapAssertable(); + + /** Lock for sequential aggregate command execution */ + #executionLock = new Lock(); + constructor({ eventStore, aggregateType, @@ -40,8 +41,8 @@ export class AggregateCommandHandler implements ICommandHandler { handles, logger }: Pick & { - aggregateType?: IAggregateConstructor, - aggregateFactory?: IAggregateFactory, + aggregateType?: IAggregateConstructor, + aggregateFactory?: IAggregateFactory, handles?: string[] }) { if (!eventStore) @@ -70,30 +71,37 @@ export class AggregateCommandHandler implements ICommandHandler { } /** Subscribe to all command types handled by aggregateType */ - subscribe(commandBus: ICommandBus) { - subscribe(commandBus, this, { - messageTypes: this.#handles, - masterHandler: (c: ICommand) => this.execute(c) - }); + subscribe(commandBus: IObservable) { + if (!commandBus) + throw new TypeError('commandBus argument required'); + if (!isIObservable(commandBus)) + throw new TypeError('commandBus argument must implement IObservable interface'); + + for (const commandType of this.#handles) + commandBus.on(commandType, (cmd: ICommand) => this.execute(cmd)); } /** Restore aggregate from event store events */ - async #restoreAggregate(id: Identifier): Promise { + async #restoreAggregate(id: Identifier): Promise { if (!id) throw new TypeError('id argument required'); const eventsIterable = this.#eventStore.getAggregateEvents(id); - const events = await iteratorToArray(eventsIterable); + const aggregate = this.#aggregateFactory({ id }); - const aggregate = this.#aggregateFactory({ id, events }); + let eventCount = 0; + for await (const event of eventsIterable) { + aggregate.mutate(event); + eventCount += 1; + } - this.#logger?.info(`${aggregate} state restored from ${events.length} event(s)`); + this.#logger?.info(`${aggregate} state restored from ${eventCount} event(s)`); return aggregate; } /** Create new aggregate with new Id generated by event store */ - async #createAggregate(): Promise { + async #createAggregate(): Promise { const id = await this.#eventStore.getNewId(); const aggregate = this.#aggregateFactory({ id }); this.#logger?.info(`${aggregate} created`); @@ -101,6 +109,13 @@ export class AggregateCommandHandler implements ICommandHandler { return aggregate; } + async #getAggregateInstance(aggregateId?: Identifier) { + if (!aggregateId) + return this.#createAggregate(); + else + return this.#aggregatesCache.assert(aggregateId, () => this.#restoreAggregate(aggregateId)); + } + /** Pass a command to corresponding aggregate */ async execute(cmd: ICommand): Promise { if (!cmd) @@ -108,24 +123,31 @@ export class AggregateCommandHandler implements ICommandHandler { if (!cmd.type) throw new TypeError('cmd.type argument required'); - const aggregate = cmd.aggregateId ? - await this.#restoreAggregate(cmd.aggregateId) : - await this.#createAggregate(); + // create new or get cached aggregate instance promise + // multiple concurrent calls to #getAggregateInstance will return the same promise + const aggregate = await this.#getAggregateInstance(cmd.aggregateId); - await aggregate.handle(cmd); + try { + // pass command to aggregate instance + // multiple concurrent calls will execute sequentially + const events = await this.#executionLock.runExclusively(String(aggregate.id), async () => { + await aggregate.handle(cmd); - let events = aggregate.changes; - this.#logger?.info(`${aggregate} "${cmd.type}" command processed, ${events.length} event(s) produced`); - if (!events.length) - return events; + if (aggregate.shouldTakeSnapshot) + aggregate.takeSnapshot?.(); - if (aggregate.shouldTakeSnapshot) { - aggregate.takeSnapshot(); - events = aggregate.changes; - } + return aggregate.popChanges(); + }); + + this.#logger?.info(`${aggregate} "${cmd.type}" command processed, ${events.length} event(s) produced`); - await this.#eventStore.dispatch(events); + if (events.length) + await this.#eventStore.dispatch(events); - return events; + return events; + } + finally { + this.#aggregatesCache.release(aggregate.id); + } } } diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 95eba03..342bd96 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -91,7 +91,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { } /** Register aggregate type in the container */ - registerAggregate(AggregateType: IAggregateConstructor) { + registerAggregate(AggregateType: IAggregateConstructor) { if (!isClass(AggregateType)) throw new TypeError('AggregateType argument must be a constructor function'); diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts index 8dcc883..00ff865 100644 --- a/src/interfaces/IAggregate.ts +++ b/src/interfaces/IAggregate.ts @@ -11,17 +11,26 @@ export interface IAggregate { /** Unique aggregate identifier */ readonly id: Identifier; + /** Update aggregate state with event */ + mutate(event: IEvent): void; + /** Main entry point for aggregate commands */ handle(command: ICommand): void | Promise; - /** List of events emitted by Aggregate as a result of handling command(s) */ + /** Get events emitted during command(s) handling and reset the `changes` collection */ + popChanges(): IEventSet; + + /** + * List of events emitted by Aggregate as a result of handling command(s) + * @deprecated use `popChanges()` instead + */ readonly changes: IEventSet; /** An indicator if aggregate snapshot should be taken */ readonly shouldTakeSnapshot?: boolean; /** Take an aggregate state snapshot and add it to the changes queue */ - takeSnapshot(): void; + takeSnapshot?(): void; } export interface IMutableAggregateState { @@ -41,18 +50,25 @@ export type IAggregateConstructorParams { +export interface IAggregateConstructor< + TAggregate extends IAggregate, + TState extends IMutableAggregateState | object | void +> { readonly handles: string[]; - new(options: IAggregateConstructorParams): IAggregate; + new(options: IAggregateConstructorParams): TAggregate; } -export type IAggregateFactory = - (options: IAggregateConstructorParams) => IAggregate; - +export type IAggregateFactory< + TAggregate extends IAggregate, + TState extends IMutableAggregateState | object | void +> = (options: IAggregateConstructorParams) => TAggregate; diff --git a/src/utils/Lock.ts b/src/utils/Lock.ts index de00359..8134643 100644 --- a/src/utils/Lock.ts +++ b/src/utils/Lock.ts @@ -1,53 +1,99 @@ import { Deferred } from './Deferred'; -/** - * Provides a simple asynchronous lock mechanism. - * Useful for ensuring that only one asynchronous operation proceeds at a time - * for a specific resource or section of code. - */ export class Lock { - #deferred?: Deferred; + /** + * 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?: Deferred; + + /** + * Indicates that global lock is acquired, all others should wait + */ + #globalLock?: Deferred; + + /** + * Hash of named locks. Each named lock block locks with same name and the global one + */ + #namedLocks: Map> = new Map(); + + #getAnyBlockingLock(id?: string): Deferred | undefined { + return this.#globalLock ?? ( + id ? + this.#namedLocks.get(id) : + this.#namedLocks.values().next().value + ); + } - get isLocked(): boolean { - return !(this.#deferred?.settled ?? true); + + isLocked(name?: string): boolean { + return !!this.#getAnyBlockingLock(name); } /** - * Wait until lock is released, then acquire it + * Acquire named or global lock + * + * @returns Promise that resolves once lock is acquired */ - async acquire(): Promise { - // the below code cannot be replaced with `await this.unblocked()` + async acquire(name?: string): Promise { + + 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 (this.isLocked) - await this.#deferred?.promise; + // 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(); - this.#deferred = new Deferred(); + if (isGlobal) { + this.#globalLockAcquiringLock?.resolve(); + this.#globalLockAcquiringLock = undefined; + } } /** - * Returns a promise that is resolved once lock is released + * @returns Promise that resolves once lock is released */ - async unblocked(): Promise { - while (this.isLocked) - await this.#deferred?.promise; + async waitForUnlock(name?: string): Promise { + while (this.isLocked(name)) + await this.#getAnyBlockingLock(name)?.promise; } - release(): void { - this.#deferred?.resolve(); - this.#deferred = undefined; + /** + * Release named or global lock + */ + release(name?: string): void { + 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 runLocked(callback: () => Promise) { + async runExclusively(name: string | undefined, callback: () => Promise): Promise { try { - await this.acquire(); - await callback(); + await this.acquire(name); + return await callback(); } finally { - this.release(); + this.release(name); } } } diff --git a/src/utils/MapAssertable.ts b/src/utils/MapAssertable.ts new file mode 100644 index 0000000..546cf7a --- /dev/null +++ b/src/utils/MapAssertable.ts @@ -0,0 +1,30 @@ +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: K, factory: () => V): V { + 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: K) { + const count = (this.#usageCounter.get(key) ?? 0) - 1; + if (count > 0) { + this.#usageCounter.set(key, count); + } + else { + this.#usageCounter.delete(key); + this.delete(key); + } + } +} diff --git a/src/utils/index.ts b/src/utils/index.ts index c9bfc05..ada7ab1 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -6,6 +6,7 @@ export * from './getMessageHandlerNames'; export * from './isClass'; export * from './iteratorToArray'; export * from './Lock'; +export * from './MapAssertable'; export * from './notEmpty'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index 837d9b1..d59246c 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -41,6 +41,7 @@ class CommandBus { on(messageType, listener) { this.handlers[messageType] = listener; } + off() { } } describe('AggregateCommandHandler', function () { @@ -48,7 +49,7 @@ describe('AggregateCommandHandler', function () { // this.timeout(500); // this.slow(300); - let eventStorageReader: InMemoryEventStorage; + let eventStorage: InMemoryEventStorage; let snapshotStorage: InMemorySnapshotStorage; let eventStore: IEventStore; let commandBus: ICommandBus; @@ -60,16 +61,21 @@ describe('AggregateCommandHandler', function () { beforeEach(() => { eventBus = new InMemoryMessageBus(); - eventStorageReader = new InMemoryEventStorage(); + eventStorage = new InMemoryEventStorage(); snapshotStorage = new InMemorySnapshotStorage(); - const eventDispatcher = new EventDispatcher({ eventBus }); + const eventDispatcher = new EventDispatcher({ + eventDispatchPipeline: [ + eventStorage + ], + eventBus + }); eventStore = new EventStore({ - eventStorageReader, + eventStorageReader: eventStorage, snapshotStorage, eventBus, eventDispatcher, - identifierProvider: eventStorageReader + identifierProvider: eventStorage }); getNewIdSpy = sinon.spy(eventStore, 'getNewId'); getAggregateEventsSpy = sinon.spy(eventStore, 'getAggregateEvents'); @@ -220,9 +226,84 @@ describe('AggregateCommandHandler', function () { const [eventStream] = commitSpy.lastCall.args; - expect(eventStream).to.have.length(3); - expect(eventStream[2]).to.have.property('type', 'snapshot'); - expect(eventStream[2]).to.have.property('aggregateVersion', 2); - expect(eventStream[2]).to.have.property('payload'); + expect(eventStream).to.have.length(2); + expect(eventStream[1]).to.have.property('type', 'snapshot'); + expect(eventStream[1]).to.have.property('aggregateVersion', 2); + expect(eventStream[1]).to.have.property('payload'); + }); + + it('produces events with sequential versions for concurrent commands to the same aggregate', async () => { + + const handler = new AggregateCommandHandler({ eventStore, aggregateType: MyAggregate }); + const aggregateId = 'concurrent-test-id'; + + // Ensure aggregate exists + await handler.execute({ type: 'createAggregate', aggregateId }); + + const command1 = { type: 'doSomething', aggregateId }; + const command2 = { type: 'doSomething', aggregateId }; + + // Execute commands concurrently + await Promise.all([ + handler.execute(command1), + handler.execute(command2) + ]); + + // Retrieve all events for the aggregate + const eventsIterable = eventStore.getAggregateEvents(aggregateId); + const allEvents = []; + for await (const event of eventsIterable) + allEvents.push(event); + + const emittedEventVersions = allEvents.map(e => e.aggregateVersion); + expect(emittedEventVersions).to.deep.equal([0, 1, 2]); + }); + + it('uses cached aggregate instance for concurrent commands and restores for subsequent commands', async () => { + + const aggregateId = 'cache-test-id'; + let factoryCallCount = 0; + const aggregateFactory = params => { + factoryCallCount++; + return new MyAggregate(params); + }; + + const handler = new AggregateCommandHandler({ + eventStore, + aggregateFactory, + handles: MyAggregate.handles + }); + + // Ensure aggregate exists + await handler.execute({ type: 'createAggregate', aggregateId }); + + // Reset spies/counters before the main test part + getAggregateEventsSpy.resetHistory(); + factoryCallCount = 0; + + const command1 = { type: 'doSomething', aggregateId }; + const command2 = { type: 'doSomething', aggregateId }; + + // Execute commands concurrently + await Promise.all([ + handler.execute(command1), + handler.execute(command2) + ]); + + // Check that restore and factory were called only once for the concurrent pair + assert(getAggregateEventsSpy.calledOnce, 'getAggregateEvents should be called once for concurrent commands'); + expect(factoryCallCount).to.equal(1, 'Aggregate factory should be called once for concurrent commands'); + + + getAggregateEventsSpy.resetHistory(); + factoryCallCount = 0; + + // Execute a third command after the first two completed + const command3 = { type: 'doSomething', aggregateId }; + await handler.execute(command3); + + // Check that restore and factory were called again for the subsequent command + assert(getAggregateEventsSpy.calledOnce, 'getAggregateEvents should be called again for the subsequent command'); + expect(factoryCallCount).to.equal(1, 'Aggregate factory should be called again for the subsequent command'); }); }); diff --git a/tests/unit/Lock.test.ts b/tests/unit/Lock.test.ts index d75270a..1b56315 100644 --- a/tests/unit/Lock.test.ts +++ b/tests/unit/Lock.test.ts @@ -55,35 +55,38 @@ describe('Lock', () => { describe('isLocked', () => { it('returns `false` when lock is not acquired', async () => { - expect(lock).toHaveProperty('isLocked', false); + expect(lock).toHaveProperty('isLocked'); + expect(lock.isLocked()).toBe(false); }); it('returns `true` when lock is acquired', async () => { await lock.acquire(); - expect(lock).toHaveProperty('isLocked', true); + expect(lock).toHaveProperty('isLocked'); + expect(lock.isLocked()).toBe(true); }); it('returns `false` when lock is released', async () => { await lock.acquire(); await lock.release(); - expect(lock).toHaveProperty('isLocked', false); + expect(lock).toHaveProperty('isLocked'); + expect(lock.isLocked()).toBe(false); }); }); - describe('runLocked', () => { + describe('runExclusively', () => { it('executes callback with lock acquired', async () => { let p1status = 'not-started'; let p2status = 'not-started'; - const p1 = lock.runLocked(async () => { + const p1 = lock.runExclusively(undefined, async () => { p1status = 'started'; await delay(10); p1status = 'processed'; }); - const p2 = lock.runLocked(async () => { + const p2 = lock.runExclusively(undefined, async () => { p2status = 'started'; await delay(5); p2status = 'processed'; @@ -114,36 +117,36 @@ describe('Lock', () => { }); }); - describe('unblocked', () => { + describe('waitForUnlock', () => { it('returns Promise', () => { - expect(lock).toHaveProperty('unblocked'); - expect(lock.unblocked()).toBeInstanceOf(Promise); + expect(lock).toHaveProperty('waitForUnlock'); + expect(lock.waitForUnlock()).toBeInstanceOf(Promise); }); it('returns resolved promise when lock is not acquired', async () => { - await expect(isResolved(lock.unblocked())).resolves.toBe(true); + await expect(isResolved(lock.waitForUnlock())).resolves.toBe(true); }); it('returns pending promise when lock is acquired', async () => { await lock.acquire(); - await expect(isResolved(lock.unblocked())).resolves.toBe(false); + await expect(isResolved(lock.waitForUnlock())).resolves.toBe(false); }); it('returns resolved promise when lock is released', async () => { await lock.acquire(); await lock.release(); - await expect(isResolved(lock.unblocked())).resolves.toBe(true); + await expect(isResolved(lock.waitForUnlock())).resolves.toBe(true); }); it('can be used to suspend non-blocking processes until lock is released', async () => { await lock.acquire(); // blocking process (i.e. update_by_query) - const p2 = lock.unblocked(); - const p3 = lock.unblocked(); + const p2 = lock.waitForUnlock(); + const p3 = lock.waitForUnlock(); const l4 = lock.acquire(); // blocking process (i.e. update_by_query) - const p5 = lock.unblocked(); + const p5 = lock.waitForUnlock(); const l6 = lock.acquire(); // blocking process (i.e. update_by_query) // Check all are pending initially From ddaf7a8e057e90f2f0a4d1795154a466cab51228 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 8 May 2025 23:47:08 +0100 Subject: [PATCH 066/169] Fix eslint --- eslint.config.mjs | 3 ++- tests/integration/rabbitmq/RabbitMqGateway.test.ts | 1 - 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/eslint.config.mjs b/eslint.config.mjs index fe2f193..4e2dec9 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -7,7 +7,8 @@ import globals from "globals"; export default defineConfig([ globalIgnores([ "coverage/*", - "dist/*" + "dist/*", + "types/*" ]), { files: [ diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index f43c653..f04872f 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -421,7 +421,6 @@ describe('RabbitMqGateway', () => { it('stops receiving messages on SIGINT', async () => { const received: IMessage[] = []; - const process = new EventEmitter(); const handlerBlocker = new Deferred(); const message: IMessage = { type: 'test.sigint', From 3e141fd217c4a094a57fefe8788816d474020ffe Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 9 May 2025 22:50:58 +0100 Subject: [PATCH 067/169] Refactor: Simplify aggregate interface --- src/AbstractAggregate.ts | 56 +++++++++------------- src/AggregateCommandHandler.ts | 19 ++++---- src/interfaces/IAggregate.ts | 38 +++++---------- src/utils/Lock.ts | 2 +- tests/unit/AbstractAggregate.test.ts | 46 +++++++++--------- tests/unit/AggregateCommandHandler.test.ts | 10 ++-- 6 files changed, 74 insertions(+), 97 deletions(-) diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 12f7eee..1975d24 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -55,14 +55,6 @@ export abstract class AbstractAggregate this.mutate(event)); } - /** Pass command to command handler */ - handle(command: ICommand) { - if (!command) - throw new TypeError('command argument required'); - if (!command.type) - throw new TypeError('command.type argument required'); - - const handler = getHandler(this, command.type); - if (!handler) - throw new Error(`'${command.type}' handler is not defined or not a function`); - - this.command = command; - - return handler.call(this, command.payload, command.context); - } - /** Mutate aggregate state and increment aggregate version */ mutate(event: IEvent) { if (event.aggregateVersion !== undefined) @@ -131,8 +107,29 @@ export abstract class AbstractAggregate implements I const aggregate = await this.#getAggregateInstance(cmd.aggregateId); try { - // pass command to aggregate instance - // multiple concurrent calls will execute sequentially - const events = await this.#executionLock.runExclusively(String(aggregate.id), async () => { - await aggregate.handle(cmd); - - if (aggregate.shouldTakeSnapshot) - aggregate.takeSnapshot?.(); + // multiple concurrent commands to a same aggregateId will execute sequentially + if (cmd.aggregateId) + this.#executionLock.acquire(String(cmd.aggregateId)); - return aggregate.popChanges(); - }); + // pass command to aggregate instance + const events = await aggregate.handle(cmd); this.#logger?.info(`${aggregate} "${cmd.type}" command processed, ${events.length} event(s) produced`); @@ -147,7 +143,10 @@ export class AggregateCommandHandler implements I return events; } finally { - this.#aggregatesCache.release(aggregate.id); + if (cmd.aggregateId) { + this.#executionLock.release(String(cmd.aggregateId)); + this.#aggregatesCache.release(cmd.aggregateId); + } } } } diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts index 00ff865..633f7cb 100644 --- a/src/interfaces/IAggregate.ts +++ b/src/interfaces/IAggregate.ts @@ -8,43 +8,29 @@ import { IEventSet } from './IEventSet'; */ export interface IAggregate { - /** Unique aggregate identifier */ - readonly id: Identifier; - - /** Update aggregate state with event */ + /** + * Apply a single event to mutate the aggregate's state. + * + * Used by `AggregateCommandHandler` when restoring the aggregate state from the event store. + */ mutate(event: IEvent): void; - /** Main entry point for aggregate commands */ - handle(command: ICommand): void | Promise; - - /** Get events emitted during command(s) handling and reset the `changes` collection */ - popChanges(): IEventSet; - /** - * List of events emitted by Aggregate as a result of handling command(s) - * @deprecated use `popChanges()` instead + * Process a command sent to the aggregate. + * + * This is the main entry point for handling aggregate commands. */ - readonly changes: IEventSet; - - /** An indicator if aggregate snapshot should be taken */ - readonly shouldTakeSnapshot?: boolean; - - /** Take an aggregate state snapshot and add it to the changes queue */ - takeSnapshot?(): void; + handle(command: ICommand): IEventSet | Promise; } export interface IMutableAggregateState { - // schemaVersion?: number; - // constructor: IAggregateStateConstructor; + /** + * Apply a single event to mutate the aggregate's state. + */ mutate(event: IEvent): void; } -// export interface IAggregateStateConstructor extends Function { -// schemaVersion?: number; -// new(): IAggregateState; -// } - export type IAggregateConstructorParams = { /** Unique aggregate identifier */ diff --git a/src/utils/Lock.ts b/src/utils/Lock.ts index 8134643..eafeedc 100644 --- a/src/utils/Lock.ts +++ b/src/utils/Lock.ts @@ -87,7 +87,7 @@ export class Lock { /** * Execute callback with lock acquired, then release lock */ - async runExclusively(name: string | undefined, callback: () => Promise): Promise { + async runExclusively(name: string | undefined, callback: () => Promise | T): Promise { try { await this.acquire(name); return await callback(); diff --git a/tests/unit/AbstractAggregate.test.ts b/tests/unit/AbstractAggregate.test.ts index 7cfcf73..9de2c7b 100644 --- a/tests/unit/AbstractAggregate.test.ts +++ b/tests/unit/AbstractAggregate.test.ts @@ -87,25 +87,21 @@ describe('AbstractAggregate', function () { }); }); - describe('changes', () => { + describe('popChanges', () => { - it('contains an EventStream of changes happened in aggregate', () => { + it('contains an EventStream of changes happened in aggregate', async () => { - const { changes } = agg; + const changes0 = agg.popChanges(); - expect(changes).to.be.an('Array'); - expect(changes).to.be.empty; - expect(changes).to.not.equal(agg.changes); - expect(() => { - (agg as any).changes = []; - }).to.throw(TypeError); + expect(changes0).to.be.an('Array'); + expect(changes0).to.be.empty; - return agg.doSomething({}).then(() => { + const changes = await agg.handle({ type: 'doSomething' }); - expect(agg).to.have.nested.property('changes[0].type', 'somethingDone'); - expect(agg).to.have.nested.property('changes[0].aggregateId', 1); - expect(agg).to.have.nested.property('changes[0].aggregateVersion', 0); - }); + expect(changes).to.not.equal(changes0); + expect(changes).to.have.nested.property('[0].type', 'somethingDone'); + expect(changes).to.have.nested.property('[0].aggregateId', 1); + expect(changes).to.have.nested.property('[0].aggregateVersion', 0); }); }); @@ -155,9 +151,9 @@ describe('AbstractAggregate', function () { it('passes command to a handler declared within aggregate, returns a Promise', async () => { - await agg.handle({ type: 'doSomething' }); + const changes = await agg.handle({ type: 'doSomething' }); - expect(agg).to.have.nested.property('changes[0].type', 'somethingDone'); + expect(changes).to.have.nested.property('[0].type', 'somethingDone'); }); it('throws error, if command handler is not defined', async () => { @@ -186,7 +182,9 @@ describe('AbstractAggregate', function () { it('pushes new event to #changes', () => { (agg as any).emit('eventType', {}); - expect(agg).to.have.nested.property('changes[0].type', 'eventType'); + + const changes = agg.popChanges(); + expect(changes).to.have.nested.property('[0].type', 'eventType'); }); it('increments aggregate #version', () => { @@ -271,19 +269,23 @@ describe('AbstractAggregate', function () { }); }); - describe('takeSnapshot()', () => { + describe('makeSnapshot()', () => { it('exists', () => { - expect(agg).to.respondTo('takeSnapshot'); + expect(agg).to.respondTo('makeSnapshot'); }); it('adds aggregate state snapshot to the changes queue', async () => { - await agg.handle({ type: 'doSomething' }); + class AggregateWithSnapshot extends Aggregate { + protected get shouldTakeSnapshot(): boolean { + return true; + } + } - agg.takeSnapshot(); + agg = new AggregateWithSnapshot({ id: 1 }); - const { changes } = agg; + const changes = await agg.handle({ type: 'doSomething' }); expect(changes).to.have.length(2); diff --git a/tests/unit/AggregateCommandHandler.test.ts b/tests/unit/AggregateCommandHandler.test.ts index d59246c..319247a 100644 --- a/tests/unit/AggregateCommandHandler.test.ts +++ b/tests/unit/AggregateCommandHandler.test.ts @@ -190,7 +190,7 @@ describe('AggregateCommandHandler', function () { expect(args[0]).to.be.an('Array'); }); - it('invokes aggregate.takeSnapshot before committing event stream, when get shouldTakeSnapshot equals true', async () => { + it('invokes aggregate.makeSnapshot before committing event stream, when get shouldTakeSnapshot equals true', async () => { // setup @@ -201,7 +201,7 @@ describe('AggregateCommandHandler', function () { return this.version !== 0 && this.version % 2 === 0; } }); - sinon.spy(aggregate, 'takeSnapshot'); + sinon.spy(aggregate, 'makeSnapshot'); const handler = new AggregateCommandHandler({ eventStore, @@ -211,17 +211,17 @@ describe('AggregateCommandHandler', function () { // test - expect(aggregate).to.have.nested.property('takeSnapshot.called', false); + expect(aggregate).to.have.nested.property('makeSnapshot.called', false); expect(aggregate).to.have.property('version', 0); await handler.execute({ type: 'doSomething', payload: 'test' }); - expect(aggregate).to.have.nested.property('takeSnapshot.called', false); + expect(aggregate).to.have.nested.property('makeSnapshot.called', false); expect(aggregate).to.have.property('version', 1); // 1st event await handler.execute({ type: 'doSomething', payload: 'test' }); - expect(aggregate).to.have.nested.property('takeSnapshot.called', true); + expect(aggregate).to.have.nested.property('makeSnapshot.called', true); expect(aggregate).to.have.property('version', 3); // 2nd event and snapshot const [eventStream] = commitSpy.lastCall.args; From efc980cc0f7f7fc021a8fcadd913806fb5af2707 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 9 May 2025 22:51:34 +0100 Subject: [PATCH 068/169] 1.0.0-rc.11 --- CHANGELOG.md | 13 +++++++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 16 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 79cf36d..2d02243 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,16 @@ +# [1.0.0-rc.11](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.10...v1.0.0-rc.11) (2025-05-09) + + +### Changes + +* Cache immediate aggregates to handle concurrent commands ([e193c4c](https://github.com/snatalenko/node-cqrs/commit/e193c4c8dc7b91de6cbc84e2ac668170ddb48bc0)) +* Use `structuredClone` for snapshot creation ([1d0e827](https://github.com/snatalenko/node-cqrs/commit/1d0e827da71c760739588a37ae6afe63a4fa8d34)) + +### Refactoring + +* Simplify aggregate interface ([3e141fd](https://github.com/snatalenko/node-cqrs/commit/3e141fd217c4a094a57fefe8788816d474020ffe)) + + # [1.0.0-rc.10](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.9...v1.0.0-rc.10) (2025-04-13) diff --git a/package-lock.json b/package-lock.json index 9218683..25100d5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.10", + "version": "1.0.0-rc.11", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.10", + "version": "1.0.0-rc.11", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.0.0", diff --git a/package.json b/package.json index 70bcdec..09fb402 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.10", + "version": "1.0.0-rc.11", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 8e38606fadee78fb93107d6190ebc75a28a7d785 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 11 Aug 2025 16:34:14 +0100 Subject: [PATCH 069/169] Fix missing awaits --- src/AggregateCommandHandler.ts | 2 +- src/EventDispatcher.ts | 10 ++++++---- src/rabbitmq/RabbitMqEventBus.ts | 4 ++-- src/sqlite/AbstractSqliteAccessor.ts | 2 +- src/sqlite/SqliteObjectStorage.ts | 4 ++-- 5 files changed, 12 insertions(+), 10 deletions(-) diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index c2a107d..9c8c415 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -130,7 +130,7 @@ export class AggregateCommandHandler implements I try { // multiple concurrent commands to a same aggregateId will execute sequentially if (cmd.aggregateId) - this.#executionLock.acquire(String(cmd.aggregateId)); + await this.#executionLock.acquire(String(cmd.aggregateId)); // pass command to aggregate instance const events = await aggregate.handle(cmd); diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 437d97e..968415e 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -112,13 +112,15 @@ export class EventDispatcher implements IEventDispatcher { continue; } - const events = data.map(e => e.event).filter(notEmpty); - try { + const events: IEvent[] = []; + for (const batch of data) { const { event, ...meta } = batch; - if (event) - this.eventBus.publish(event, meta); + if (event) { + await this.eventBus.publish(event, meta); + events.push(event); + } } resolve(events); diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index b47115b..46553b4 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -53,8 +53,8 @@ export class RabbitMqEventBus implements IEventBus, IDispatchPipelineProcessor { /** * Removes a previously registered message handler for a specific event type. */ - off(eventType: string, handler: IMessageHandler): void { - this.#gateway.unsubscribe({ + async off(eventType: string, handler: IMessageHandler): Promise { + await this.#gateway.unsubscribe({ exchange: this.#exchange, queueName: this.#queueName, eventType, diff --git a/src/sqlite/AbstractSqliteAccessor.ts b/src/sqlite/AbstractSqliteAccessor.ts index dc5d249..27d3c08 100644 --- a/src/sqlite/AbstractSqliteAccessor.ts +++ b/src/sqlite/AbstractSqliteAccessor.ts @@ -40,7 +40,7 @@ export abstract class AbstractSqliteAccessor { return; try { - this.#initLocker.acquire(); + await this.#initLocker.acquire(); if (this.#initialized) return; diff --git a/src/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts index 9babd4f..fb043f1 100644 --- a/src/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -125,9 +125,9 @@ export class SqliteObjectStorage extends AbstractSqliteAccessor impleme // it's safe to get then modify within this process const record = this.#getQuery.get(guid(id)); if (record) - this.update(id, update); + await this.update(id, update); else - this.create(id, update()); + await this.create(id, update()); } async delete(id: string): Promise { From 79d5cb259baa68b70ee4eeb037d133caba52cdf6 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 11 Aug 2025 16:42:29 +0100 Subject: [PATCH 070/169] Update dependencies --- package-lock.json | 1566 ++++++++++++++++++++++++--------------------- package.json | 28 +- 2 files changed, 862 insertions(+), 732 deletions(-) diff --git a/package-lock.json b/package-lock.json index 25100d5..063550d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,64 +9,42 @@ "version": "1.0.0-rc.11", "license": "MIT", "dependencies": { - "async-iterable-buffer": "^1.0.0", + "async-iterable-buffer": "^1.1.0", "async-parallel-pipe": "^1.0.2", "di0": "^1.0.0" }, "devDependencies": { - "@stylistic/eslint-plugin-ts": "^4.2.0", + "@stylistic/eslint-plugin-ts": "^4.4.1", "@types/amqplib": "^0.10.7", - "@types/better-sqlite3": "^7.6.11", + "@types/better-sqlite3": "^7.6.13", "@types/chai": "^4.3.20", - "@types/jest": "^29.5.13", + "@types/jest": "^29.5.14", "@types/md5": "^2.3.5", - "@types/node": "^20.16.9", + "@types/node": "^20.19.10", "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "eslint": "^9.24.0", - "eslint-plugin-jest": "^28.11.0", - "globals": "^16.1.0", + "eslint": "^9.33.0", + "eslint-plugin-jest": "^28.14.0", + "globals": "^16.3.0", "jest": "^29.7.0", - "sinon": "^19.0.2", - "ts-jest": "^29.2.5", + "sinon": "^19.0.5", + "ts-jest": "^29.4.1", "ts-node": "^10.9.2", - "typescript": "^5.6.2", - "typescript-eslint": "^8.29.0" + "typescript": "^5.9.2", + "typescript-eslint": "^8.39.0" }, "engines": { "node": ">=18.0.0" }, "peerDependencies": { - "amqplib": "^0.10.5", - "better-sqlite3": "^11.3.0", + "amqplib": "^0.10.8", + "better-sqlite3": "^11.10.0", "md5": "^2.3.0" } }, - "node_modules/@acuminous/bitsyntax": { - "version": "0.1.2", - "resolved": "https://registry.npmjs.org/@acuminous/bitsyntax/-/bitsyntax-0.1.2.tgz", - "integrity": "sha512-29lUK80d1muEQqiUsSo+3A0yP6CdspgC95EnKBMi22Xlwt79i/En4Vr67+cXhU+cZjbti3TgGGC5wy1stIywVQ==", - "license": "MIT", - "peer": true, - "dependencies": { - "buffer-more-ints": "~1.0.0", - "debug": "^4.3.4", - "safe-buffer": "~5.1.2" - }, - "engines": { - "node": ">=0.8" - } - }, - "node_modules/@acuminous/bitsyntax/node_modules/safe-buffer": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", - "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", - "license": "MIT", - "peer": true - }, "node_modules/@ampproject/remapping": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", @@ -82,24 +60,24 @@ } }, "node_modules/@babel/code-frame": { - "version": "7.26.2", - "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.26.2.tgz", - "integrity": "sha512-RJlIHRueQgwWitWgF8OdFYGZX328Ax5BCemNGlqHfplnRT9ESi8JkFlvaVYbS+UubVY6dpv87Fs2u5M29iNFVQ==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", + "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-validator-identifier": "^7.25.9", + "@babel/helper-validator-identifier": "^7.27.1", "js-tokens": "^4.0.0", - "picocolors": "^1.0.0" + "picocolors": "^1.1.1" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/compat-data": { - "version": "7.26.8", - "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.26.8.tgz", - "integrity": "sha512-oH5UPLMWR3L2wEFLnFJ1TZXqHufiTKAiLfqw5zkhS4dKXLJ10yVztfil/twG8EDTA4F/tvVNw9nOl4ZMslB8rQ==", + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.0.tgz", + "integrity": "sha512-60X7qkglvrap8mn1lh2ebxXdZYtUcpd7gsmy9kLaBJ4i/WdY8PqTSdxyA8qraikqKQK5C1KRBKXqznrVapyNaw==", "dev": true, "license": "MIT", "engines": { @@ -107,22 +85,22 @@ } }, "node_modules/@babel/core": { - "version": "7.26.10", - "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.26.10.tgz", - "integrity": "sha512-vMqyb7XCDMPvJFFOaT9kxtiRh42GwlZEg1/uIgtZshS5a/8OaduUfCi7kynKgc3Tw/6Uo2D+db9qBttghhmxwQ==", + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.0.tgz", + "integrity": "sha512-UlLAnTPrFdNGoFtbSXwcGFQBtQZJCNjaN6hQNP3UPvuNXT1i82N26KL3dZeIpNalWywr9IuQuncaAfUaS1g6sQ==", "dev": true, "license": "MIT", "dependencies": { "@ampproject/remapping": "^2.2.0", - "@babel/code-frame": "^7.26.2", - "@babel/generator": "^7.26.10", - "@babel/helper-compilation-targets": "^7.26.5", - "@babel/helper-module-transforms": "^7.26.0", - "@babel/helpers": "^7.26.10", - "@babel/parser": "^7.26.10", - "@babel/template": "^7.26.9", - "@babel/traverse": "^7.26.10", - "@babel/types": "^7.26.10", + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.0", + "@babel/helper-compilation-targets": "^7.27.2", + "@babel/helper-module-transforms": "^7.27.3", + "@babel/helpers": "^7.27.6", + "@babel/parser": "^7.28.0", + "@babel/template": "^7.27.2", + "@babel/traverse": "^7.28.0", + "@babel/types": "^7.28.0", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", @@ -137,17 +115,27 @@ "url": "https://opencollective.com/babel" } }, + "node_modules/@babel/core/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, "node_modules/@babel/generator": { - "version": "7.26.10", - "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.26.10.tgz", - "integrity": "sha512-rRHT8siFIXQrAYOYqZQVsAr8vJ+cBNqcVAY6m5V8/4QqzaPl+zDBe6cLEPRDuNOUf3ww8RfJVlOyQMoSI+5Ang==", + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.0.tgz", + "integrity": "sha512-lJjzvrbEeWrhB4P3QBsH7tey117PjLZnDbLiQEKjQ/fNJTjuq4HSqgFA+UNSwZT8D7dxxbnuSBMsa1lrWzKlQg==", "dev": true, "license": "MIT", "dependencies": { - "@babel/parser": "^7.26.10", - "@babel/types": "^7.26.10", - "@jridgewell/gen-mapping": "^0.3.5", - "@jridgewell/trace-mapping": "^0.3.25", + "@babel/parser": "^7.28.0", + "@babel/types": "^7.28.0", + "@jridgewell/gen-mapping": "^0.3.12", + "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" }, "engines": { @@ -155,14 +143,14 @@ } }, "node_modules/@babel/helper-compilation-targets": { - "version": "7.26.5", - "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.26.5.tgz", - "integrity": "sha512-IXuyn5EkouFJscIDuFF5EsiSolseme1s0CZB+QxVugqJLYmKdxI1VfIBOst0SUu4rnk2Z7kqTwmoO1lp3HIfnA==", + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz", + "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==", "dev": true, "license": "MIT", "dependencies": { - "@babel/compat-data": "^7.26.5", - "@babel/helper-validator-option": "^7.25.9", + "@babel/compat-data": "^7.27.2", + "@babel/helper-validator-option": "^7.27.1", "browserslist": "^4.24.0", "lru-cache": "^5.1.1", "semver": "^6.3.1" @@ -181,6 +169,16 @@ "yallist": "^3.0.2" } }, + "node_modules/@babel/helper-compilation-targets/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, "node_modules/@babel/helper-compilation-targets/node_modules/yallist": { "version": "3.1.1", "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", @@ -188,30 +186,40 @@ "dev": true, "license": "ISC" }, + "node_modules/@babel/helper-globals": { + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz", + "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, "node_modules/@babel/helper-module-imports": { - "version": "7.25.9", - "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.25.9.tgz", - "integrity": "sha512-tnUA4RsrmflIM6W6RFTLFSXITtl0wKjgpnLgXyowocVPrbYrLUXSBXDgTs8BlbmIzIdlBySRQjINYs2BAkiLtw==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz", + "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==", "dev": true, "license": "MIT", "dependencies": { - "@babel/traverse": "^7.25.9", - "@babel/types": "^7.25.9" + "@babel/traverse": "^7.27.1", + "@babel/types": "^7.27.1" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/helper-module-transforms": { - "version": "7.26.0", - "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.26.0.tgz", - "integrity": "sha512-xO+xu6B5K2czEnQye6BHA7DolFFmS3LB7stHZFaOLb1pAwO1HWLS8fXA+eh0A2yIvltPVmx3eNNDBJA2SLHXFw==", + "version": "7.27.3", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.27.3.tgz", + "integrity": "sha512-dSOvYwvyLsWBeIRyOeHXp5vPj5l1I011r52FM1+r1jCERv+aFXYk4whgQccYEGYxK2H3ZAIA8nuPkQ0HaUo3qg==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-module-imports": "^7.25.9", - "@babel/helper-validator-identifier": "^7.25.9", - "@babel/traverse": "^7.25.9" + "@babel/helper-module-imports": "^7.27.1", + "@babel/helper-validator-identifier": "^7.27.1", + "@babel/traverse": "^7.27.3" }, "engines": { "node": ">=6.9.0" @@ -221,9 +229,9 @@ } }, "node_modules/@babel/helper-plugin-utils": { - "version": "7.26.5", - "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.26.5.tgz", - "integrity": "sha512-RS+jZcRdZdRFzMyr+wcsaqOmld1/EqTghfaBGQQd/WnRdzdlvSZ//kF7U8VQTxf1ynZ4cjUcYgjVGx13ewNPMg==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz", + "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==", "dev": true, "license": "MIT", "engines": { @@ -231,9 +239,9 @@ } }, "node_modules/@babel/helper-string-parser": { - "version": "7.25.9", - "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz", - "integrity": "sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", + "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==", "dev": true, "license": "MIT", "engines": { @@ -241,9 +249,9 @@ } }, "node_modules/@babel/helper-validator-identifier": { - "version": "7.25.9", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz", - "integrity": "sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz", + "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==", "dev": true, "license": "MIT", "engines": { @@ -251,9 +259,9 @@ } }, "node_modules/@babel/helper-validator-option": { - "version": "7.25.9", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.25.9.tgz", - "integrity": "sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz", + "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==", "dev": true, "license": "MIT", "engines": { @@ -261,27 +269,27 @@ } }, "node_modules/@babel/helpers": { - "version": "7.26.10", - "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.26.10.tgz", - "integrity": "sha512-UPYc3SauzZ3JGgj87GgZ89JVdC5dj0AoetR5Bw6wj4niittNyFh6+eOGonYvJ1ao6B8lEa3Q3klS7ADZ53bc5g==", + "version": "7.28.2", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.2.tgz", + "integrity": "sha512-/V9771t+EgXz62aCcyofnQhGM8DQACbRhvzKFsXKC9QM+5MadF8ZmIm0crDMaz3+o0h0zXfJnd4EhbYbxsrcFw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/template": "^7.26.9", - "@babel/types": "^7.26.10" + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.2" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/parser": { - "version": "7.26.10", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.26.10.tgz", - "integrity": "sha512-6aQR2zGE/QFi8JpDLjUZEPYOs7+mhKXm86VaKFiLP35JQwQb6bwUE+XbvkH0EptsYhbNBSUGaUBLKqxH1xSgsA==", + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.0.tgz", + "integrity": "sha512-jVZGvOxOuNSsuQuLRTh13nU0AogFlw32w/MT+LV6D3sP5WdbW61E77RnkbaO2dUvmPAYrBDJXGn5gGS6tH4j8g==", "dev": true, "license": "MIT", "dependencies": { - "@babel/types": "^7.26.10" + "@babel/types": "^7.28.0" }, "bin": { "parser": "bin/babel-parser.js" @@ -346,13 +354,13 @@ } }, "node_modules/@babel/plugin-syntax-import-attributes": { - "version": "7.26.0", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.26.0.tgz", - "integrity": "sha512-e2dttdsJ1ZTpi3B9UYGLw41hifAubg19AtCu/2I/F1QNVclOBr1dYpTdmdyZ84Xiz43BS/tCUkMAZNLv12Pi+A==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.27.1.tgz", + "integrity": "sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.25.9" + "@babel/helper-plugin-utils": "^7.27.1" }, "engines": { "node": ">=6.9.0" @@ -388,13 +396,13 @@ } }, "node_modules/@babel/plugin-syntax-jsx": { - "version": "7.25.9", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.25.9.tgz", - "integrity": "sha512-ld6oezHQMZsZfp6pWtbjaNDF2tiiCYYDqQszHt5VV437lewP9aSi2Of99CK0D0XB21k7FLgnLcmQKyKzynfeAA==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.27.1.tgz", + "integrity": "sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.25.9" + "@babel/helper-plugin-utils": "^7.27.1" }, "engines": { "node": ">=6.9.0" @@ -514,13 +522,13 @@ } }, "node_modules/@babel/plugin-syntax-typescript": { - "version": "7.25.9", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.25.9.tgz", - "integrity": "sha512-hjMgRy5hb8uJJjUcdWunWVcoi9bGpJp8p5Ol1229PoN6aytsLwNMgmdftO23wnCLMfVmTwZDWMPNq/D1SY60JQ==", + "version": "7.27.1", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.27.1.tgz", + "integrity": "sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.25.9" + "@babel/helper-plugin-utils": "^7.27.1" }, "engines": { "node": ">=6.9.0" @@ -530,58 +538,48 @@ } }, "node_modules/@babel/template": { - "version": "7.26.9", - "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.26.9.tgz", - "integrity": "sha512-qyRplbeIpNZhmzOysF/wFMuP9sctmh2cFzRAZOn1YapxBsE1i9bJIY586R/WBLfLcmcBlM8ROBiQURnnNy+zfA==", + "version": "7.27.2", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz", + "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.26.2", - "@babel/parser": "^7.26.9", - "@babel/types": "^7.26.9" + "@babel/code-frame": "^7.27.1", + "@babel/parser": "^7.27.2", + "@babel/types": "^7.27.1" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/traverse": { - "version": "7.26.10", - "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.26.10.tgz", - "integrity": "sha512-k8NuDrxr0WrPH5Aupqb2LCVURP/S0vBEn5mK6iH+GIYob66U5EtoZvcdudR2jQ4cmTwhEwW1DLB+Yyas9zjF6A==", + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.0.tgz", + "integrity": "sha512-mGe7UK5wWyh0bKRfupsUchrQGqvDbZDbKJw+kcRGSmdHVYrv+ltd0pnpDTVpiTqnaBru9iEvA8pz8W46v0Amwg==", "dev": true, "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.26.2", - "@babel/generator": "^7.26.10", - "@babel/parser": "^7.26.10", - "@babel/template": "^7.26.9", - "@babel/types": "^7.26.10", - "debug": "^4.3.1", - "globals": "^11.1.0" + "@babel/code-frame": "^7.27.1", + "@babel/generator": "^7.28.0", + "@babel/helper-globals": "^7.28.0", + "@babel/parser": "^7.28.0", + "@babel/template": "^7.27.2", + "@babel/types": "^7.28.0", + "debug": "^4.3.1" }, "engines": { "node": ">=6.9.0" } }, - "node_modules/@babel/traverse/node_modules/globals": { - "version": "11.12.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", - "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=4" - } - }, "node_modules/@babel/types": { - "version": "7.26.10", - "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.26.10.tgz", - "integrity": "sha512-emqcG3vHrpxUKTrxcblR36dcrcoRDvKmnL/dCL6ZsHaShW80qxCAcNhzQZrpeM765VzEos+xOi4s+r4IXzTwdQ==", + "version": "7.28.2", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.2.tgz", + "integrity": "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-string-parser": "^7.25.9", - "@babel/helper-validator-identifier": "^7.25.9" + "@babel/helper-string-parser": "^7.27.1", + "@babel/helper-validator-identifier": "^7.27.1" }, "engines": { "node": ">=6.9.0" @@ -619,9 +617,9 @@ } }, "node_modules/@eslint-community/eslint-utils": { - "version": "4.5.1", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.5.1.tgz", - "integrity": "sha512-soEIOALTfTK6EjmKMMoLugwaP0rzkad90iIWd1hMO9ARkSAyjfMfkRRhLvD5qH7vvM0Cg72pieUfR6yh6XxC4w==", + "version": "4.7.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.7.0.tgz", + "integrity": "sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw==", "dev": true, "license": "MIT", "dependencies": { @@ -661,9 +659,9 @@ } }, "node_modules/@eslint/config-array": { - "version": "0.20.0", - "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.20.0.tgz", - "integrity": "sha512-fxlS1kkIjx8+vy2SjuCB94q3htSNrufYTXubwiBFeaQHbH6Ipi43gFJq2zCMt6PHhImH3Xmr0NksKDvchWlpQQ==", + "version": "0.21.0", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.0.tgz", + "integrity": "sha512-ENIdc4iLu0d93HeYirvKmrzshzofPw6VkZRKQGe9Nv46ZnWUzcF1xV01dcvEg/1wXUR61OmmlSfyeyO7EvjLxQ==", "dev": true, "license": "Apache-2.0", "dependencies": { @@ -675,10 +673,34 @@ "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, + "node_modules/@eslint/config-array/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@eslint/config-array/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, "node_modules/@eslint/config-helpers": { - "version": "0.2.1", - "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.2.1.tgz", - "integrity": "sha512-RI17tsD2frtDu/3dmI7QRrD4bedNKPM08ziRYaC5AhkGrzIAJelm9kJU1TznK+apx6V+cqRz8tfpEeG3oIyjxw==", + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.3.1.tgz", + "integrity": "sha512-xR93k9WhrDYpXHORXpxVL5oHj3Era7wo6k/Wd8/IsQNnZUTzkGS29lyn3nAT05v6ltUuTFVCCYDEGfy2Or/sPA==", "dev": true, "license": "Apache-2.0", "engines": { @@ -686,9 +708,9 @@ } }, "node_modules/@eslint/core": { - "version": "0.12.0", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.12.0.tgz", - "integrity": "sha512-cmrR6pytBuSMTaBweKoGMwu3EiHiEC+DoyupPmlZ0HxBJBtIxwe+j/E4XPIKNx+Q74c8lXKPwYawBf5glsTkHg==", + "version": "0.15.2", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.15.2.tgz", + "integrity": "sha512-78Md3/Rrxh83gCxoUc0EiciuOHsIITzLy53m3d9UyiW8y9Dj2D29FeETqyKA+BRK76tnTp6RXWb3pCay8Oyomg==", "dev": true, "license": "Apache-2.0", "dependencies": { @@ -722,12 +744,16 @@ "url": "https://opencollective.com/eslint" } }, - "node_modules/@eslint/eslintrc/node_modules/argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "node_modules/@eslint/eslintrc/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", "dev": true, - "license": "Python-2.0" + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } }, "node_modules/@eslint/eslintrc/node_modules/globals": { "version": "14.0.0", @@ -742,27 +768,40 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/@eslint/eslintrc/node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "node_modules/@eslint/eslintrc/node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", "dev": true, "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/@eslint/eslintrc/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", "dependencies": { - "argparse": "^2.0.1" + "brace-expansion": "^1.1.7" }, - "bin": { - "js-yaml": "bin/js-yaml.js" + "engines": { + "node": "*" } }, "node_modules/@eslint/js": { - "version": "9.24.0", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.24.0.tgz", - "integrity": "sha512-uIY/y3z0uvOGX8cp1C2fiC4+ZmBhp6yZWkojtHL1YEMnRt1Y63HB9TM17proGEmeG7HeUY+UP36F0aknKYTpYA==", + "version": "9.33.0", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.33.0.tgz", + "integrity": "sha512-5K1/mKhWaMfreBGJTwval43JJmkip0RmM+3+IuqupeSKNC/Th2Kc7ucaq5ovTSra/OOKB9c58CGSz3QMVbWt0A==", "dev": true, "license": "MIT", "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" } }, "node_modules/@eslint/object-schema": { @@ -776,32 +815,19 @@ } }, "node_modules/@eslint/plugin-kit": { - "version": "0.2.8", - "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.2.8.tgz", - "integrity": "sha512-ZAoA40rNMPwSm+AeHpCq8STiNAwzWLJuP8Xv4CHIc9wv/PSuExjMrmjfYNj682vW0OOiZ1HKxzvjQr9XZIisQA==", + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.3.5.tgz", + "integrity": "sha512-Z5kJ+wU3oA7MMIqVR9tyZRtjYPr4OC004Q4Rw7pgOKUOKkJfZ3O24nz3WYfGRpMDNmcOi3TwQOmgm7B7Tpii0w==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/core": "^0.13.0", + "@eslint/core": "^0.15.2", "levn": "^0.4.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, - "node_modules/@eslint/plugin-kit/node_modules/@eslint/core": { - "version": "0.13.0", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.13.0.tgz", - "integrity": "sha512-yfkgDw1KR66rkT5A8ci4irzDysN7FRpq3ttJolR88OqQikAWqwA8j5VZyas+vjyBNFIJ7MfybJ9plMILI2UrCw==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@types/json-schema": "^7.0.15" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - } - }, "node_modules/@humanfs/core": { "version": "0.19.1", "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", @@ -855,9 +881,9 @@ } }, "node_modules/@humanwhocodes/retry": { - "version": "0.4.2", - "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.2.tgz", - "integrity": "sha512-xeO57FpIu4p1Ri3Jq/EXq4ClRm86dVF2z/+kvFnyqVYRavTZmaFaUBbWCOuuTh0o/g7DSsk6kc2vrS4Vl5oPOQ==", + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", "dev": true, "license": "Apache-2.0", "engines": { @@ -895,6 +921,96 @@ "node": ">=8" } }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/argparse": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", + "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "dev": true, + "license": "MIT", + "dependencies": { + "sprintf-js": "~1.0.2" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": { + "version": "3.14.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", + "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/load-nyc-config/node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, "node_modules/@istanbuljs/schema": { "version": "0.1.3", "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz", @@ -1198,18 +1314,14 @@ } }, "node_modules/@jridgewell/gen-mapping": { - "version": "0.3.8", - "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.8.tgz", - "integrity": "sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA==", + "version": "0.3.12", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.12.tgz", + "integrity": "sha512-OuLGC46TjB5BbN1dH8JULVVZY4WTdkF7tV9Ys6wLL1rubZnCMstOhNHueU5bLCrnRuDhKPDM4g6sw4Bel5Gzqg==", "dev": true, "license": "MIT", "dependencies": { - "@jridgewell/set-array": "^1.2.1", - "@jridgewell/sourcemap-codec": "^1.4.10", + "@jridgewell/sourcemap-codec": "^1.5.0", "@jridgewell/trace-mapping": "^0.3.24" - }, - "engines": { - "node": ">=6.0.0" } }, "node_modules/@jridgewell/resolve-uri": { @@ -1222,27 +1334,17 @@ "node": ">=6.0.0" } }, - "node_modules/@jridgewell/set-array": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz", - "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=6.0.0" - } - }, "node_modules/@jridgewell/sourcemap-codec": { - "version": "1.5.0", - "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz", - "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==", + "version": "1.5.4", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.4.tgz", + "integrity": "sha512-VT2+G1VQs/9oz078bLrYbecdZKs912zQlkelYpuf+SXF+QvZDYJlbx/LSx+meSAwdDFnF8FVXW92AVjjkVmgFw==", "dev": true, "license": "MIT" }, "node_modules/@jridgewell/trace-mapping": { - "version": "0.3.25", - "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz", - "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==", + "version": "0.3.29", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.29.tgz", + "integrity": "sha512-uw6guiW/gcAGPDhLmd77/6lW8QLeiV5RUTsAX46Db6oLhGaVj4lhnPwb184s1bkc8kdVg/+h988dro8GRDpmYQ==", "dev": true, "license": "MIT", "dependencies": { @@ -1326,14 +1428,13 @@ } }, "node_modules/@sinonjs/samsam": { - "version": "8.0.2", - "resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-8.0.2.tgz", - "integrity": "sha512-v46t/fwnhejRSFTGqbpn9u+LQ9xJDse10gNnPgAcxgdoCDMXj/G2asWAC/8Qs+BAZDicX+MNZouXT1A7c83kVw==", + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-8.0.3.tgz", + "integrity": "sha512-hw6HbX+GyVZzmaYNh82Ecj1vdGZrqVIn/keDTg63IgAwiQPO+xCz99uG6Woqgb4tM0mUiFENKZ4cqd7IX94AXQ==", "dev": true, "license": "BSD-3-Clause", "dependencies": { "@sinonjs/commons": "^3.0.1", - "lodash.get": "^4.4.2", "type-detect": "^4.1.0" } }, @@ -1345,13 +1446,13 @@ "license": "(Unlicense OR Apache-2.0)" }, "node_modules/@stylistic/eslint-plugin-ts": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin-ts/-/eslint-plugin-ts-4.2.0.tgz", - "integrity": "sha512-j2o2GvOx9v66x8hmp/HJ+0T+nOppiO5ycGsCkifh7JPGgjxEhpkGmIGx3RWsoxpWbad3VCX8e8/T8n3+7ze1Zg==", + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin-ts/-/eslint-plugin-ts-4.4.1.tgz", + "integrity": "sha512-2r6cLcmdF6til66lx8esBYvBvsn7xCmLT50gw/n1rGGlTq/OxeNjBIh4c3VEaDGMa/5TybrZTia6sQUHdIWx1w==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/utils": "^8.23.0", + "@typescript-eslint/utils": "^8.32.1", "eslint-visitor-keys": "^4.2.0", "espree": "^10.3.0" }, @@ -1415,9 +1516,9 @@ } }, "node_modules/@types/babel__generator": { - "version": "7.6.8", - "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.8.tgz", - "integrity": "sha512-ASsj+tpEDsEiFr1arWrlN6V3mdfjRMZt6LtK/Vp/kreFLnr5QH5+DhvD5nINYZXzwJvXeGq+05iUXcAzVrqWtw==", + "version": "7.27.0", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz", + "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==", "dev": true, "license": "MIT", "dependencies": { @@ -1436,19 +1537,19 @@ } }, "node_modules/@types/babel__traverse": { - "version": "7.20.6", - "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.20.6.tgz", - "integrity": "sha512-r1bzfrm0tomOI8g1SzvCaQHo6Lcv6zu0EA+W2kHrt8dyrHQxGzBBL4kdkzIS+jBMV+EYcMAEAqXqYaLJq5rOZg==", + "version": "7.28.0", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz", + "integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==", "dev": true, "license": "MIT", "dependencies": { - "@babel/types": "^7.20.7" + "@babel/types": "^7.28.2" } }, "node_modules/@types/better-sqlite3": { - "version": "7.6.12", - "resolved": "https://registry.npmjs.org/@types/better-sqlite3/-/better-sqlite3-7.6.12.tgz", - "integrity": "sha512-fnQmj8lELIj7BSrZQAdBMHEHX8OZLYIHXqAKT1O7tDfLxaINzf00PMjw22r3N/xXh0w/sGHlO6SVaCQ2mj78lg==", + "version": "7.6.13", + "resolved": "https://registry.npmjs.org/@types/better-sqlite3/-/better-sqlite3-7.6.13.tgz", + "integrity": "sha512-NMv9ASNARoKksWtsq/SHakpYAYnhBrQgGD8zkLYk/jaK8jUGn08CfEdTRgYhMypUQAfzSP8W6gNLe0q19/t4VA==", "dev": true, "license": "MIT", "dependencies": { @@ -1463,9 +1564,9 @@ "license": "MIT" }, "node_modules/@types/estree": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz", - "integrity": "sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==", + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", "dev": true, "license": "MIT" }, @@ -1539,13 +1640,13 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "20.17.25", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.25.tgz", - "integrity": "sha512-bT+r2haIlplJUYtlZrEanFHdPIZTeiMeh/fSOEbOOfWf9uTn+lg8g0KU6Q3iMgjd9FLuuMAgfCNSkjUbxL6E3Q==", + "version": "20.19.10", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.10.tgz", + "integrity": "sha512-iAFpG6DokED3roLSP0K+ybeDdIX6Bc0Vd3mLW5uDqThPWtNos3E+EqOM11mPQHKzfWHqEBuLjIlsBQQ8CsISmQ==", "dev": true, "license": "MIT", "dependencies": { - "undici-types": "~6.19.2" + "undici-types": "~6.21.0" } }, "node_modules/@types/normalize-package-data": { @@ -1597,21 +1698,21 @@ "license": "MIT" }, "node_modules/@typescript-eslint/eslint-plugin": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.29.0.tgz", - "integrity": "sha512-PAIpk/U7NIS6H7TEtN45SPGLQaHNgB7wSjsQV/8+KYokAb2T/gloOA/Bee2yd4/yKVhPKe5LlaUGhAZk5zmSaQ==", + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.39.0.tgz", + "integrity": "sha512-bhEz6OZeUR+O/6yx9Jk6ohX6H9JSFTaiY0v9/PuKT3oGK0rn0jNplLmyFUGV+a9gfYnVNwGDwS/UkLIuXNb2Rw==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/regexpp": "^4.10.0", - "@typescript-eslint/scope-manager": "8.29.0", - "@typescript-eslint/type-utils": "8.29.0", - "@typescript-eslint/utils": "8.29.0", - "@typescript-eslint/visitor-keys": "8.29.0", + "@typescript-eslint/scope-manager": "8.39.0", + "@typescript-eslint/type-utils": "8.39.0", + "@typescript-eslint/utils": "8.39.0", + "@typescript-eslint/visitor-keys": "8.39.0", "graphemer": "^1.4.0", - "ignore": "^5.3.1", + "ignore": "^7.0.0", "natural-compare": "^1.4.0", - "ts-api-utils": "^2.0.1" + "ts-api-utils": "^2.1.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1621,22 +1722,22 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "@typescript-eslint/parser": "^8.0.0 || ^8.0.0-alpha.0", + "@typescript-eslint/parser": "^8.39.0", "eslint": "^8.57.0 || ^9.0.0", - "typescript": ">=4.8.4 <5.9.0" + "typescript": ">=4.8.4 <6.0.0" } }, "node_modules/@typescript-eslint/parser": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.29.0.tgz", - "integrity": "sha512-8C0+jlNJOwQso2GapCVWWfW/rzaq7Lbme+vGUFKE31djwNncIpgXD7Cd4weEsDdkoZDjH0lwwr3QDQFuyrMg9g==", + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.39.0.tgz", + "integrity": "sha512-g3WpVQHngx0aLXn6kfIYCZxM6rRJlWzEkVpqEFLT3SgEDsp9cpCbxxgwnE504q4H+ruSDh/VGS6nqZIDynP+vg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/scope-manager": "8.29.0", - "@typescript-eslint/types": "8.29.0", - "@typescript-eslint/typescript-estree": "8.29.0", - "@typescript-eslint/visitor-keys": "8.29.0", + "@typescript-eslint/scope-manager": "8.39.0", + "@typescript-eslint/types": "8.39.0", + "@typescript-eslint/typescript-estree": "8.39.0", + "@typescript-eslint/visitor-keys": "8.39.0", "debug": "^4.3.4" }, "engines": { @@ -1648,18 +1749,19 @@ }, "peerDependencies": { "eslint": "^8.57.0 || ^9.0.0", - "typescript": ">=4.8.4 <5.9.0" + "typescript": ">=4.8.4 <6.0.0" } }, - "node_modules/@typescript-eslint/scope-manager": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.29.0.tgz", - "integrity": "sha512-aO1PVsq7Gm+tcghabUpzEnVSFMCU4/nYIgC2GOatJcllvWfnhrgW0ZEbnTxm36QsikmCN1K/6ZgM7fok2I7xNw==", + "node_modules/@typescript-eslint/project-service": { + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.39.0.tgz", + "integrity": "sha512-CTzJqaSq30V/Z2Og9jogzZt8lJRR5TKlAdXmWgdu4hgcC9Kww5flQ+xFvMxIBWVNdxJO7OifgdOK4PokMIWPew==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.29.0", - "@typescript-eslint/visitor-keys": "8.29.0" + "@typescript-eslint/tsconfig-utils": "^8.39.0", + "@typescript-eslint/types": "^8.39.0", + "debug": "^4.3.4" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1667,19 +1769,20 @@ "funding": { "type": "opencollective", "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.0.0" } }, - "node_modules/@typescript-eslint/type-utils": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.29.0.tgz", - "integrity": "sha512-ahaWQ42JAOx+NKEf5++WC/ua17q5l+j1GFrbbpVKzFL/tKVc0aYY8rVSYUpUvt2hUP1YBr7mwXzx+E/DfUWI9Q==", + "node_modules/@typescript-eslint/scope-manager": { + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.39.0.tgz", + "integrity": "sha512-8QOzff9UKxOh6npZQ/4FQu4mjdOCGSdO3p44ww0hk8Vu+IGbg0tB/H1LcTARRDzGCC8pDGbh2rissBuuoPgH8A==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/typescript-estree": "8.29.0", - "@typescript-eslint/utils": "8.29.0", - "debug": "^4.3.4", - "ts-api-utils": "^2.0.1" + "@typescript-eslint/types": "8.39.0", + "@typescript-eslint/visitor-keys": "8.39.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1687,16 +1790,12 @@ "funding": { "type": "opencollective", "url": "https://opencollective.com/typescript-eslint" - }, - "peerDependencies": { - "eslint": "^8.57.0 || ^9.0.0", - "typescript": ">=4.8.4 <5.9.0" } }, - "node_modules/@typescript-eslint/types": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.29.0.tgz", - "integrity": "sha512-wcJL/+cOXV+RE3gjCyl/V2G877+2faqvlgtso/ZRbTCnZazh0gXhe+7gbAnfubzN2bNsBtZjDvlh7ero8uIbzg==", + "node_modules/@typescript-eslint/tsconfig-utils": { + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.39.0.tgz", + "integrity": "sha512-Fd3/QjmFV2sKmvv3Mrj8r6N8CryYiCS8Wdb/6/rgOXAWGcFuc+VkQuG28uk/4kVNVZBQuuDHEDUpo/pQ32zsIQ==", "dev": true, "license": "MIT", "engines": { @@ -1705,23 +1804,23 @@ "funding": { "type": "opencollective", "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "typescript": ">=4.8.4 <6.0.0" } }, - "node_modules/@typescript-eslint/typescript-estree": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.29.0.tgz", - "integrity": "sha512-yOfen3jE9ISZR/hHpU/bmNvTtBW1NjRbkSFdZOksL1N+ybPEE7UVGMwqvS6CP022Rp00Sb0tdiIkhSCe6NI8ow==", + "node_modules/@typescript-eslint/type-utils": { + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.39.0.tgz", + "integrity": "sha512-6B3z0c1DXVT2vYA9+z9axjtc09rqKUPRmijD5m9iv8iQpHBRYRMBcgxSiKTZKm6FwWw1/cI4v6em35OsKCiN5Q==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.29.0", - "@typescript-eslint/visitor-keys": "8.29.0", + "@typescript-eslint/types": "8.39.0", + "@typescript-eslint/typescript-estree": "8.39.0", + "@typescript-eslint/utils": "8.39.0", "debug": "^4.3.4", - "fast-glob": "^3.3.2", - "is-glob": "^4.0.3", - "minimatch": "^9.0.4", - "semver": "^7.6.0", - "ts-api-utils": "^2.0.1" + "ts-api-utils": "^2.1.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1731,59 +1830,64 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "typescript": ">=4.8.4 <5.9.0" + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.8.4 <6.0.0" } }, - "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", + "node_modules/@typescript-eslint/types": { + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.39.0.tgz", + "integrity": "sha512-ArDdaOllnCj3yn/lzKn9s0pBQYmmyme/v1HbGIGB0GB/knFI3fWMHloC+oYTJW46tVbYnGKTMDK4ah1sC2v0Kg==", "dev": true, "license": "MIT", - "dependencies": { - "balanced-match": "^1.0.0" + "engines": { + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" } }, - "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": { - "version": "9.0.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", - "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", + "node_modules/@typescript-eslint/typescript-estree": { + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.39.0.tgz", + "integrity": "sha512-ndWdiflRMvfIgQRpckQQLiB5qAKQ7w++V4LlCHwp62eym1HLB/kw7D9f2e8ytONls/jt89TEasgvb+VwnRprsw==", "dev": true, - "license": "ISC", + "license": "MIT", "dependencies": { - "brace-expansion": "^2.0.1" + "@typescript-eslint/project-service": "8.39.0", + "@typescript-eslint/tsconfig-utils": "8.39.0", + "@typescript-eslint/types": "8.39.0", + "@typescript-eslint/visitor-keys": "8.39.0", + "debug": "^4.3.4", + "fast-glob": "^3.3.2", + "is-glob": "^4.0.3", + "minimatch": "^9.0.4", + "semver": "^7.6.0", + "ts-api-utils": "^2.1.0" }, "engines": { - "node": ">=16 || 14 >=14.17" + "node": "^18.18.0 || ^20.9.0 || >=21.1.0" }, "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/@typescript-eslint/typescript-estree/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" }, - "engines": { - "node": ">=10" + "peerDependencies": { + "typescript": ">=4.8.4 <6.0.0" } }, "node_modules/@typescript-eslint/utils": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.29.0.tgz", - "integrity": "sha512-gX/A0Mz9Bskm8avSWFcK0gP7cZpbY4AIo6B0hWYFCaIsz750oaiWR4Jr2CI+PQhfW1CpcQr9OlfPS+kMFegjXA==", + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.39.0.tgz", + "integrity": "sha512-4GVSvNA0Vx1Ktwvf4sFE+exxJ3QGUorQG1/A5mRfRNZtkBT2xrA/BCO2H0eALx/PnvCS6/vmYwRdDA41EoffkQ==", "dev": true, "license": "MIT", "dependencies": { - "@eslint-community/eslint-utils": "^4.4.0", - "@typescript-eslint/scope-manager": "8.29.0", - "@typescript-eslint/types": "8.29.0", - "@typescript-eslint/typescript-estree": "8.29.0" + "@eslint-community/eslint-utils": "^4.7.0", + "@typescript-eslint/scope-manager": "8.39.0", + "@typescript-eslint/types": "8.39.0", + "@typescript-eslint/typescript-estree": "8.39.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1794,18 +1898,18 @@ }, "peerDependencies": { "eslint": "^8.57.0 || ^9.0.0", - "typescript": ">=4.8.4 <5.9.0" + "typescript": ">=4.8.4 <6.0.0" } }, "node_modules/@typescript-eslint/visitor-keys": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.29.0.tgz", - "integrity": "sha512-Sne/pVz8ryR03NFK21VpN88dZ2FdQXOlq3VIklbrTYEt8yXtRFr9tvUhqvCeKjqYk5FSim37sHbooT6vzBTZcg==", + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.39.0.tgz", + "integrity": "sha512-ldgiJ+VAhQCfIjeOgu8Kj5nSxds0ktPOSO9p4+0VDH2R2pLvQraaM5Oen2d7NxzMCm+Sn/vJT+mv2H5u6b/3fA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.29.0", - "eslint-visitor-keys": "^4.2.0" + "@typescript-eslint/types": "8.39.0", + "eslint-visitor-keys": "^4.2.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1816,9 +1920,9 @@ } }, "node_modules/acorn": { - "version": "8.14.1", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.1.tgz", - "integrity": "sha512-OvQ/2pUDKmgfCg++xsTX1wGxfTaszcHVcTctW4UJB4hibJx2HXxxO5UmVgyjMa+ZDsiaf5wWLXYpRWMmBI0QHg==", + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", "dev": true, "license": "MIT", "bin": { @@ -1876,13 +1980,12 @@ } }, "node_modules/amqplib": { - "version": "0.10.5", - "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.5.tgz", - "integrity": "sha512-Dx5zmy0Ur+Q7LPPdhz+jx5IzmJBoHd15tOeAfQ8SuvEtyPJ20hBemhOBA4b1WeORCRa0ENM/kHCzmem1w/zHvQ==", + "version": "0.10.8", + "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.8.tgz", + "integrity": "sha512-Tfn1O9sFgAP8DqeMEpt2IacsVTENBpblB3SqLdn0jK2AeX8iyCvbptBc8lyATT9bQ31MsjVwUSQ1g8f4jHOUfw==", "license": "MIT", "peer": true, "dependencies": { - "@acuminous/bitsyntax": "^0.1.2", "buffer-more-ints": "~1.0.0", "url-parse": "~1.5.10" }, @@ -1954,14 +2057,11 @@ "license": "MIT" }, "node_modules/argparse": { - "version": "1.0.10", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", - "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", "dev": true, - "license": "MIT", - "dependencies": { - "sprintf-js": "~1.0.2" - } + "license": "Python-2.0" }, "node_modules/array-ify": { "version": "1.0.0", @@ -1990,17 +2090,10 @@ "node": "*" } }, - "node_modules/async": { - "version": "3.2.6", - "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", - "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", - "dev": true, - "license": "MIT" - }, "node_modules/async-iterable-buffer": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/async-iterable-buffer/-/async-iterable-buffer-1.0.0.tgz", - "integrity": "sha512-pZn6MjtoJFyr+RVy3O0BSRb8ibjSX9BlEh8trEqdtpV4DdnH7oM28Ke14r4QZuzQnSGj3tg1CrEToIxuvsfqsw==", + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/async-iterable-buffer/-/async-iterable-buffer-1.1.0.tgz", + "integrity": "sha512-Dg+1qcSvVG72bofflqi0MXUKStuJDU034r8pxWdDZIF17ohU1VcuTp9dPB/Q7b8ZNLhJtOmLgIODP/32a0ygYQ==", "license": "MIT" }, "node_modules/async-parallel-pipe": { @@ -2065,6 +2158,16 @@ "node": ">=8" } }, + "node_modules/babel-plugin-istanbul/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, "node_modules/babel-plugin-jest-hoist": { "version": "29.6.3", "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz", @@ -2082,9 +2185,9 @@ } }, "node_modules/babel-preset-current-node-syntax": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.1.0.tgz", - "integrity": "sha512-ldYss8SbBlWva1bs28q78Ju5Zq1F+8BrqBZZ0VFhLBvhh6lCpC2o3gDJi/5DRLs9FgYZCnmPYIVFU4lRXCkyUw==", + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.2.0.tgz", + "integrity": "sha512-E/VlAEzRrsLEb2+dv8yp3bo4scof3l9nR4lrld+Iy5NyVqgVYUJnDAmunkhPMisRI32Qc4iRiz425d8vM++2fg==", "dev": true, "license": "MIT", "dependencies": { @@ -2105,7 +2208,7 @@ "@babel/plugin-syntax-top-level-await": "^7.14.5" }, "peerDependencies": { - "@babel/core": "^7.0.0" + "@babel/core": "^7.0.0 || ^8.0.0-0" } }, "node_modules/babel-preset-jest": { @@ -2154,9 +2257,9 @@ "peer": true }, "node_modules/better-sqlite3": { - "version": "11.9.1", - "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.9.1.tgz", - "integrity": "sha512-Ba0KR+Fzxh2jDRhdg6TSH0SJGzb8C0aBY4hR8w8madIdIzzC6Y1+kx5qR6eS1Z+Gy20h6ZU28aeyg0z1VIrShQ==", + "version": "11.10.0", + "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.10.0.tgz", + "integrity": "sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==", "hasInstallScript": true, "license": "MIT", "peer": true, @@ -2188,14 +2291,13 @@ } }, "node_modules/brace-expansion": { - "version": "1.1.11", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", - "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", + "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", "dev": true, "license": "MIT", "dependencies": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" + "balanced-match": "^1.0.0" } }, "node_modules/braces": { @@ -2212,9 +2314,9 @@ } }, "node_modules/browserslist": { - "version": "4.24.4", - "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.4.tgz", - "integrity": "sha512-KDi1Ny1gSePi1vm0q4oxSF8b4DR44GF4BbmS2YdhPLOEqd8pDviZOGH/GsmRwoWJ2+5Lr085X7naowMwKHDG1A==", + "version": "4.25.2", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.25.2.tgz", + "integrity": "sha512-0si2SJK3ooGzIawRu61ZdPCO1IncZwS8IzuX73sPZsXW6EQ/w/DAfPyKI8l1ETTCr2MnvqWitmlCUxgdul45jA==", "dev": true, "funding": [ { @@ -2232,10 +2334,10 @@ ], "license": "MIT", "dependencies": { - "caniuse-lite": "^1.0.30001688", - "electron-to-chromium": "^1.5.73", + "caniuse-lite": "^1.0.30001733", + "electron-to-chromium": "^1.5.199", "node-releases": "^2.0.19", - "update-browserslist-db": "^1.1.1" + "update-browserslist-db": "^1.1.3" }, "bin": { "browserslist": "cli.js" @@ -2345,9 +2447,9 @@ } }, "node_modules/caniuse-lite": { - "version": "1.0.30001706", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001706.tgz", - "integrity": "sha512-3ZczoTApMAZwPKYWmwVbQMFpXBDds3/0VciVoUwPUbldlYyVLmRVuRs/PcUZtHpbLRpzzDvrvnFuREsGt6lUug==", + "version": "1.0.30001734", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001734.tgz", + "integrity": "sha512-uhE1Ye5vgqju6OI71HTQqcBCZrvHugk0MjLak7Q+HfoBgoq5Bi+5YnwjP4fjDgrtYr/l8MVRBvzz9dPD4KyK0A==", "dev": true, "funding": [ { @@ -2736,6 +2838,16 @@ "node": ">=10" } }, + "node_modules/conventional-changelog-writer/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, "node_modules/conventional-commits-filter": { "version": "2.0.7", "resolved": "https://registry.npmjs.org/conventional-commits-filter/-/conventional-commits-filter-2.0.7.tgz", @@ -2860,9 +2972,10 @@ } }, "node_modules/debug": { - "version": "4.4.0", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", - "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", + "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", + "dev": true, "license": "MIT", "dependencies": { "ms": "^2.1.3" @@ -2930,9 +3043,9 @@ } }, "node_modules/dedent": { - "version": "1.5.3", - "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.5.3.tgz", - "integrity": "sha512-NHQtfOOW68WD8lgypbLA5oT+Bt0xXJhiYvoR6SmmNXZfpzOGXwdKWmcwG8N7PwVVWV3eF/68nmD9BaJSsTBhyQ==", + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.6.0.tgz", + "integrity": "sha512-F1Z+5UCFpmQUzJa11agbyPVMbpgT/qA3/SKyJ1jyBgm7dUcUEa8v9JwDkerSQXfakBwFljIxhOJqGkjUwZ9FSA==", "dev": true, "license": "MIT", "peerDependencies": { @@ -2985,9 +3098,9 @@ } }, "node_modules/detect-libc": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.3.tgz", - "integrity": "sha512-bwy0MGW55bG41VqxxypOsdSdGqLwXPI/focwgTYCFMbdUiBAxLg9CFzG08sz2aqzknwiX7Hkl0bQENjg8iLByw==", + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.4.tgz", + "integrity": "sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==", "license": "Apache-2.0", "peer": true, "engines": { @@ -3043,26 +3156,10 @@ "node": ">=8" } }, - "node_modules/ejs": { - "version": "3.1.10", - "resolved": "https://registry.npmjs.org/ejs/-/ejs-3.1.10.tgz", - "integrity": "sha512-UeJmFfOrAQS8OJWPZ4qtgHyWExa088/MtK5UEyoJGFH67cDEXkZSviOiKRCZ4Xij0zxI3JECgYs3oKx+AizQBA==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "jake": "^10.8.5" - }, - "bin": { - "ejs": "bin/cli.js" - }, - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/electron-to-chromium": { - "version": "1.5.123", - "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.123.tgz", - "integrity": "sha512-refir3NlutEZqlKaBLK0tzlVLe5P2wDKS7UQt/3SpibizgsRAPOsqQC3ffw1nlv3ze5gjRQZYHoPymgVZkplFA==", + "version": "1.5.199", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.199.tgz", + "integrity": "sha512-3gl0S7zQd88kCAZRO/DnxtBKuhMO4h0EaQIN3YgZfV6+pW+5+bf2AdQeHNESCoaQqo/gjGVYEf2YM4O5HJQqpQ==", "dev": true, "license": "ISC" }, @@ -3087,9 +3184,9 @@ "license": "MIT" }, "node_modules/end-of-stream": { - "version": "1.4.4", - "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.4.tgz", - "integrity": "sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==", + "version": "1.4.5", + "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz", + "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==", "license": "MIT", "peer": true, "dependencies": { @@ -3117,30 +3214,33 @@ } }, "node_modules/escape-string-regexp": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", - "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", "dev": true, "license": "MIT", "engines": { - "node": ">=8" + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/eslint": { - "version": "9.24.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.24.0.tgz", - "integrity": "sha512-eh/jxIEJyZrvbWRe4XuVclLPDYSYYYgLy5zXGGxD6j8zjSAxFEzI2fL/8xNq6O2yKqVt+eF2YhV+hxjV6UKXwQ==", + "version": "9.33.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.33.0.tgz", + "integrity": "sha512-TS9bTNIryDzStCpJN93aC5VRSW3uTx9sClUn4B87pwiCaJh220otoI0X8mJKr+VcPtniMdN8GKjlwgWGUv5ZKA==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/eslint-utils": "^4.2.0", "@eslint-community/regexpp": "^4.12.1", - "@eslint/config-array": "^0.20.0", - "@eslint/config-helpers": "^0.2.0", - "@eslint/core": "^0.12.0", + "@eslint/config-array": "^0.21.0", + "@eslint/config-helpers": "^0.3.1", + "@eslint/core": "^0.15.2", "@eslint/eslintrc": "^3.3.1", - "@eslint/js": "9.24.0", - "@eslint/plugin-kit": "^0.2.7", + "@eslint/js": "9.33.0", + "@eslint/plugin-kit": "^0.3.5", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", @@ -3151,9 +3251,9 @@ "cross-spawn": "^7.0.6", "debug": "^4.3.2", "escape-string-regexp": "^4.0.0", - "eslint-scope": "^8.3.0", - "eslint-visitor-keys": "^4.2.0", - "espree": "^10.3.0", + "eslint-scope": "^8.4.0", + "eslint-visitor-keys": "^4.2.1", + "espree": "^10.4.0", "esquery": "^1.5.0", "esutils": "^2.0.2", "fast-deep-equal": "^3.1.3", @@ -3188,9 +3288,9 @@ } }, "node_modules/eslint-plugin-jest": { - "version": "28.11.0", - "resolved": "https://registry.npmjs.org/eslint-plugin-jest/-/eslint-plugin-jest-28.11.0.tgz", - "integrity": "sha512-QAfipLcNCWLVocVbZW8GimKn5p5iiMcgGbRzz8z/P5q7xw+cNEpYqyzFMtIF/ZgF2HLOyy+dYBut+DoYolvqig==", + "version": "28.14.0", + "resolved": "https://registry.npmjs.org/eslint-plugin-jest/-/eslint-plugin-jest-28.14.0.tgz", + "integrity": "sha512-P9s/qXSMTpRTerE2FQ0qJet2gKbcGyFTPAJipoKxmWqR6uuFqIqk8FuEfg5yBieOezVrEfAMZrEwJ6yEp+1MFQ==", "dev": true, "license": "MIT", "dependencies": { @@ -3214,9 +3314,9 @@ } }, "node_modules/eslint-scope": { - "version": "8.3.0", - "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.3.0.tgz", - "integrity": "sha512-pUNxi75F8MJ/GdeKtVLSbYg4ZI34J6C0C7sbL4YOp2exGwen7ZsuBqKzUhXd0qMQ362yET3z+uPwKeg/0C2XCQ==", + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", + "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", "dev": true, "license": "BSD-2-Clause", "dependencies": { @@ -3231,9 +3331,9 @@ } }, "node_modules/eslint-visitor-keys": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.0.tgz", - "integrity": "sha512-UyLnSehNt62FFhSwjZlHmeokpRK59rcz29j+F1/aDgbkbRTk7wIc9XzdoasMUbRNKDM0qQt/+BJ4BrpFeABemw==", + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", "dev": true, "license": "Apache-2.0", "engines": { @@ -3243,78 +3343,50 @@ "url": "https://opencollective.com/eslint" } }, - "node_modules/eslint/node_modules/escape-string-regexp": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", - "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/eslint/node_modules/find-up": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", - "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "node_modules/eslint/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", "dev": true, "license": "MIT", "dependencies": { - "locate-path": "^6.0.0", - "path-exists": "^4.0.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" } }, - "node_modules/eslint/node_modules/locate-path": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", - "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "node_modules/eslint/node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", "dev": true, "license": "MIT", - "dependencies": { - "p-locate": "^5.0.0" - }, "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" + "node": ">= 4" } }, - "node_modules/eslint/node_modules/p-locate": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", - "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "node_modules/eslint/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", "dev": true, - "license": "MIT", + "license": "ISC", "dependencies": { - "p-limit": "^3.0.2" + "brace-expansion": "^1.1.7" }, "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" + "node": "*" } }, "node_modules/espree": { - "version": "10.3.0", - "resolved": "https://registry.npmjs.org/espree/-/espree-10.3.0.tgz", - "integrity": "sha512-0QYC8b24HWY8zjRnDTL6RiHfDbAWn63qb4LMj1Z4b076A4une81+z03Kg7l7mn/48PUTqoLptSXez8oknU8Clg==", + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", + "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", "dev": true, "license": "BSD-2-Clause", "dependencies": { - "acorn": "^8.14.0", + "acorn": "^8.15.0", "acorn-jsx": "^5.3.2", - "eslint-visitor-keys": "^4.2.0" + "eslint-visitor-keys": "^4.2.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -3534,39 +3606,6 @@ "license": "MIT", "peer": true }, - "node_modules/filelist": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/filelist/-/filelist-1.0.4.tgz", - "integrity": "sha512-w1cEuf3S+DrLCQL7ET6kz+gmlJdbq9J7yXCSjK/OZCPA+qEN1WyF4ZAf0YYJa4/shHJra2t/d/r8SV4Ji+x+8Q==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "minimatch": "^5.0.1" - } - }, - "node_modules/filelist/node_modules/brace-expansion": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz", - "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==", - "dev": true, - "license": "MIT", - "dependencies": { - "balanced-match": "^1.0.0" - } - }, - "node_modules/filelist/node_modules/minimatch": { - "version": "5.1.6", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", - "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==", - "dev": true, - "license": "ISC", - "dependencies": { - "brace-expansion": "^2.0.1" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/fill-range": { "version": "7.1.1", "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", @@ -3581,17 +3620,20 @@ } }, "node_modules/find-up": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", - "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", "dev": true, "license": "MIT", "dependencies": { - "locate-path": "^5.0.0", + "locate-path": "^6.0.0", "path-exists": "^4.0.0" }, "engines": { - "node": ">=8" + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/flat-cache": { @@ -3821,6 +3863,16 @@ "node": ">=10" } }, + "node_modules/git-semver-tags/node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + } + }, "node_modules/gitconfiglocal": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/gitconfiglocal/-/gitconfiglocal-1.0.0.tgz", @@ -3873,10 +3925,34 @@ "node": ">=10.13.0" } }, + "node_modules/glob/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/glob/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, "node_modules/globals": { - "version": "16.1.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-16.1.0.tgz", - "integrity": "sha512-aibexHNbb/jiUSObBgpHLj+sIuUmJnYcgXBlrfsiDZ9rt4aF2TFRbyLgZ2iFQuVZ1K5Mx3FVkbKRSgKrbK3K2g==", + "version": "16.3.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.3.0.tgz", + "integrity": "sha512-bqWEnJ1Nt3neqx2q5SFfGS8r/ahumIakg3HcwtNlrVlwXIeNumWn/c7Pn/wKzGhf6SaW6H6uWXLqC30STCMchQ==", "dev": true, "license": "MIT", "engines": { @@ -4007,9 +4083,9 @@ "peer": true }, "node_modules/ignore": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", - "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "version": "7.0.5", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz", + "integrity": "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==", "dev": true, "license": "MIT", "engines": { @@ -4033,16 +4109,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/import-fresh/node_modules/resolve-from": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", - "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">=4" - } - }, "node_modules/import-local": { "version": "3.2.0", "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz", @@ -4277,19 +4343,6 @@ "node": ">=10" } }, - "node_modules/istanbul-lib-instrument/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/istanbul-lib-report": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz", @@ -4334,25 +4387,6 @@ "node": ">=8" } }, - "node_modules/jake": { - "version": "10.9.2", - "resolved": "https://registry.npmjs.org/jake/-/jake-10.9.2.tgz", - "integrity": "sha512-2P4SQ0HrLQ+fw6llpLnOaGAvN2Zu6778SJMrCUwns4fOoG9ayrTiZk3VV8sCPkVZF8ab0zksVpS8FDY5pRCNBA==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "async": "^3.2.3", - "chalk": "^4.0.2", - "filelist": "^1.0.4", - "minimatch": "^3.1.2" - }, - "bin": { - "jake": "bin/cli.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/jest": { "version": "29.7.0", "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz", @@ -4873,23 +4907,10 @@ "jest-util": "^29.7.0", "natural-compare": "^1.4.0", "pretty-format": "^29.7.0", - "semver": "^7.5.3" - }, - "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" - } - }, - "node_modules/jest-snapshot/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" + "semver": "^7.5.3" }, "engines": { - "node": ">=10" + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } }, "node_modules/jest-util": { @@ -5001,14 +5022,13 @@ "license": "MIT" }, "node_modules/js-yaml": { - "version": "3.14.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", - "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", + "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", "dev": true, "license": "MIT", "dependencies": { - "argparse": "^1.0.7", - "esprima": "^4.0.0" + "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" @@ -5228,16 +5248,19 @@ } }, "node_modules/locate-path": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", - "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", "dev": true, "license": "MIT", "dependencies": { - "p-locate": "^4.1.0" + "p-locate": "^5.0.0" }, "engines": { - "node": ">=8" + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/lodash": { @@ -5247,14 +5270,6 @@ "dev": true, "license": "MIT" }, - "node_modules/lodash.get": { - "version": "4.4.2", - "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz", - "integrity": "sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==", - "deprecated": "This package is deprecated. Use the optional chaining (?.) operator instead.", - "dev": true, - "license": "MIT" - }, "node_modules/lodash.ismatch": { "version": "4.4.0", "resolved": "https://registry.npmjs.org/lodash.ismatch/-/lodash.ismatch-4.4.0.tgz", @@ -5315,19 +5330,6 @@ "url": "https://github.com/sponsors/sindresorhus" } }, - "node_modules/make-dir/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/make-error": { "version": "1.3.6", "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz", @@ -5396,6 +5398,20 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/meow/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/meow/node_modules/hosted-git-info": { "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", @@ -5403,6 +5419,48 @@ "dev": true, "license": "ISC" }, + "node_modules/meow/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/meow/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/meow/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/meow/node_modules/read-pkg": { "version": "5.2.0", "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-5.2.0.tgz", @@ -5558,16 +5616,19 @@ } }, "node_modules/minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz", + "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==", "dev": true, "license": "ISC", "dependencies": { - "brace-expansion": "^1.1.7" + "brace-expansion": "^2.0.1" }, "engines": { - "node": "*" + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" } }, "node_modules/minimist": { @@ -5615,6 +5676,7 @@ "version": "2.1.3", "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, "license": "MIT" }, "node_modules/napi-build-utils": { @@ -5663,9 +5725,9 @@ } }, "node_modules/node-abi": { - "version": "3.74.0", - "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.74.0.tgz", - "integrity": "sha512-c5XK0MjkGBrQPGYG24GBADZud0NCbznxNx0ZkS+ebUTrmV1qTDxPxSL8zEAPURXSbLRWVexxmP4986BziahL5w==", + "version": "3.75.0", + "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.75.0.tgz", + "integrity": "sha512-OhYaY5sDsIka7H7AtijtI9jwGYLyl29eQn/W623DiN/MIv5sUqc4g7BIDThX+gb7di9f6xK02nkp8sdfFWZLTg==", "license": "MIT", "peer": true, "dependencies": { @@ -5675,19 +5737,6 @@ "node": ">=10" } }, - "node_modules/node-abi/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "license": "ISC", - "peer": true, - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/node-int64": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz", @@ -5718,19 +5767,6 @@ "node": ">=10" } }, - "node_modules/normalize-package-data/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/normalize-path": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", @@ -5814,29 +5850,16 @@ } }, "node_modules/p-locate": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", - "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", - "dev": true, - "license": "MIT", - "dependencies": { - "p-limit": "^2.2.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/p-locate/node_modules/p-limit": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", - "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", "dev": true, "license": "MIT", "dependencies": { - "p-try": "^2.0.0" + "p-limit": "^3.0.2" }, "engines": { - "node": ">=6" + "node": ">=10" }, "funding": { "url": "https://github.com/sponsors/sindresorhus" @@ -5995,9 +6018,9 @@ } }, "node_modules/pirates": { - "version": "4.0.6", - "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.6.tgz", - "integrity": "sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==", + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz", + "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==", "dev": true, "license": "MIT", "engines": { @@ -6017,6 +6040,62 @@ "node": ">=8" } }, + "node_modules/pkg-dir/node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pkg-dir/node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pkg-dir/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/pkg-dir/node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/prebuild-install": { "version": "7.1.3", "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", @@ -6104,9 +6183,9 @@ } }, "node_modules/pump": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.2.tgz", - "integrity": "sha512-tUPXtzlGM8FE3P0ZL6DVs/3P58k9nk8/jZeQCurTJylQA8qFYzHFfhBJkuqyE0FifOsQ0uKWekiZ5g8wtr28cw==", + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz", + "integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==", "license": "MIT", "peer": true, "dependencies": { @@ -6435,7 +6514,7 @@ "node": ">=8" } }, - "node_modules/resolve-from": { + "node_modules/resolve-cwd/node_modules/resolve-from": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", @@ -6445,6 +6524,16 @@ "node": ">=8" } }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, "node_modules/resolve.exports": { "version": "2.0.3", "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.3.tgz", @@ -6511,13 +6600,15 @@ "license": "MIT" }, "node_modules/semver": { - "version": "6.3.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", - "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", - "dev": true, + "version": "7.7.2", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz", + "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==", "license": "ISC", "bin": { "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" } }, "node_modules/shebang-command": { @@ -6598,9 +6689,9 @@ } }, "node_modules/sinon": { - "version": "19.0.4", - "resolved": "https://registry.npmjs.org/sinon/-/sinon-19.0.4.tgz", - "integrity": "sha512-myidFob7fjmYHJb+CHNLtAYScxn3sngGq4t75L2rCGGpE/k4OQVkN3KE5FsN+XkO2+fcDZ65PGvq3KHrlLAm7g==", + "version": "19.0.5", + "resolved": "https://registry.npmjs.org/sinon/-/sinon-19.0.5.tgz", + "integrity": "sha512-r15s9/s+ub/d4bxNXqIUmwp6imVSdTorIRaxoecYjqTVLZ8RuoXr/4EDGwIBo6Waxn7f2gnURX9zuhAfCwaF6Q==", "dev": true, "license": "BSD-3-Clause", "dependencies": { @@ -6694,9 +6785,9 @@ } }, "node_modules/spdx-license-ids": { - "version": "3.0.21", - "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.21.tgz", - "integrity": "sha512-Bvg/8F5XephndSK3JffaRqdT+gyhfqIPwDHpX80tJrF8QQRYMo8sNMeaZ2Dp5+jhwKnUmIOyFFQfHRkjJm5nXg==", + "version": "3.0.22", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.22.tgz", + "integrity": "sha512-4PRT4nh1EImPbt2jASOKHX7PB7I+e4IWNLvkKFDxNhJlfjbYlleYQh285Z/3mPTHSAK/AvdMmw5BNNuYH8ShgQ==", "dev": true, "license": "CC0-1.0" }, @@ -6743,6 +6834,16 @@ "node": ">=10" } }, + "node_modules/stack-utils/node_modules/escape-string-regexp": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", + "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, "node_modules/string_decoder": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", @@ -6867,9 +6968,9 @@ } }, "node_modules/tar-fs": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.2.tgz", - "integrity": "sha512-EsaAXwxmx8UB7FRKqeozqEPop69DXcmYwTQwXvyAPF352HJsPdkVhvTaDPYqfNgruveJIJy3TA2l+2zj8LJIJA==", + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.3.tgz", + "integrity": "sha512-090nwYJDmlhwFwEW3QQl+vaNnxsO2yVsd45eTKRBzSzu+hlb1w2K9inVq5b0ngXuLVqQ4ApvsUHHnu/zQNkWAg==", "license": "MIT", "peer": true, "dependencies": { @@ -6911,6 +7012,30 @@ "node": ">=8" } }, + "node_modules/test-exclude/node_modules/brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/test-exclude/node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, "node_modules/text-extensions": { "version": "1.9.0", "resolved": "https://registry.npmjs.org/text-extensions/-/text-extensions-1.9.0.tgz", @@ -6982,20 +7107,20 @@ } }, "node_modules/ts-jest": { - "version": "29.2.6", - "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.2.6.tgz", - "integrity": "sha512-yTNZVZqc8lSixm+QGVFcPe6+yj7+TWZwIesuOWvfcn4B9bz5x4NDzVCQQjOs7Hfouu36aEqfEbo9Qpo+gq8dDg==", + "version": "29.4.1", + "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.1.tgz", + "integrity": "sha512-SaeUtjfpg9Uqu8IbeDKtdaS0g8lS6FT6OzM3ezrDfErPJPHNDo/Ey+VFGP1bQIDfagYDLyRpd7O15XpG1Es2Uw==", "dev": true, "license": "MIT", "dependencies": { "bs-logger": "^0.2.6", - "ejs": "^3.1.10", "fast-json-stable-stringify": "^2.1.0", - "jest-util": "^29.0.0", + "handlebars": "^4.7.8", "json5": "^2.2.3", "lodash.memoize": "^4.1.2", "make-error": "^1.3.6", - "semver": "^7.7.1", + "semver": "^7.7.2", + "type-fest": "^4.41.0", "yargs-parser": "^21.1.1" }, "bin": { @@ -7006,10 +7131,11 @@ }, "peerDependencies": { "@babel/core": ">=7.0.0-beta.0 <8", - "@jest/transform": "^29.0.0", - "@jest/types": "^29.0.0", - "babel-jest": "^29.0.0", - "jest": "^29.0.0", + "@jest/transform": "^29.0.0 || ^30.0.0", + "@jest/types": "^29.0.0 || ^30.0.0", + "babel-jest": "^29.0.0 || ^30.0.0", + "jest": "^29.0.0 || ^30.0.0", + "jest-util": "^29.0.0 || ^30.0.0", "typescript": ">=4.3 <6" }, "peerDependenciesMeta": { @@ -7027,20 +7153,23 @@ }, "esbuild": { "optional": true + }, + "jest-util": { + "optional": true } } }, - "node_modules/ts-jest/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", + "node_modules/ts-jest/node_modules/type-fest": { + "version": "4.41.0", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz", + "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==", "dev": true, - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, + "license": "(MIT OR CC0-1.0)", "engines": { - "node": ">=10" + "node": ">=16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" } }, "node_modules/ts-jest/node_modules/yargs-parser": { @@ -7157,9 +7286,9 @@ } }, "node_modules/typescript": { - "version": "5.8.2", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.8.2.tgz", - "integrity": "sha512-aJn6wq13/afZp/jT9QZmwEjDqqvSGp1VT5GVg+f/t6/oVyrgXM6BY1h9BRh/O5p3PlUPAe+WuiEZOmb/49RqoQ==", + "version": "5.9.2", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.2.tgz", + "integrity": "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==", "dev": true, "license": "Apache-2.0", "bin": { @@ -7171,15 +7300,16 @@ } }, "node_modules/typescript-eslint": { - "version": "8.29.0", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.29.0.tgz", - "integrity": "sha512-ep9rVd9B4kQsZ7ZnWCVxUE/xDLUUUsRzE0poAeNu+4CkFErLfuvPt/qtm2EpnSyfvsR0S6QzDFSrPCFBwf64fg==", + "version": "8.39.0", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.39.0.tgz", + "integrity": "sha512-lH8FvtdtzcHJCkMOKnN73LIn6SLTpoojgJqDAxPm1jCR14eWSGPX8ul/gggBdPMk/d5+u9V854vTYQ8T5jF/1Q==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/eslint-plugin": "8.29.0", - "@typescript-eslint/parser": "8.29.0", - "@typescript-eslint/utils": "8.29.0" + "@typescript-eslint/eslint-plugin": "8.39.0", + "@typescript-eslint/parser": "8.39.0", + "@typescript-eslint/typescript-estree": "8.39.0", + "@typescript-eslint/utils": "8.39.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -7190,7 +7320,7 @@ }, "peerDependencies": { "eslint": "^8.57.0 || ^9.0.0", - "typescript": ">=4.8.4 <5.9.0" + "typescript": ">=4.8.4 <6.0.0" } }, "node_modules/uglify-js": { @@ -7208,9 +7338,9 @@ } }, "node_modules/undici-types": { - "version": "6.19.8", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz", - "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==", + "version": "6.21.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz", + "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==", "dev": true, "license": "MIT" }, diff --git a/package.json b/package.json index 09fb402..e99998c 100644 --- a/package.json +++ b/package.json @@ -65,36 +65,36 @@ "license": "MIT", "homepage": "https://github.com/snatalenko/node-cqrs#readme", "dependencies": { - "async-iterable-buffer": "^1.0.0", + "async-iterable-buffer": "^1.1.0", "async-parallel-pipe": "^1.0.2", "di0": "^1.0.0" }, "devDependencies": { - "@stylistic/eslint-plugin-ts": "^4.2.0", + "@stylistic/eslint-plugin-ts": "^4.4.1", "@types/amqplib": "^0.10.7", - "@types/better-sqlite3": "^7.6.11", + "@types/better-sqlite3": "^7.6.13", "@types/chai": "^4.3.20", - "@types/jest": "^29.5.13", + "@types/jest": "^29.5.14", "@types/md5": "^2.3.5", - "@types/node": "^20.16.9", + "@types/node": "^20.19.10", "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "eslint": "^9.24.0", - "eslint-plugin-jest": "^28.11.0", - "globals": "^16.1.0", + "eslint": "^9.33.0", + "eslint-plugin-jest": "^28.14.0", + "globals": "^16.3.0", "jest": "^29.7.0", - "sinon": "^19.0.2", - "ts-jest": "^29.2.5", + "sinon": "^19.0.5", + "ts-jest": "^29.4.1", "ts-node": "^10.9.2", - "typescript": "^5.6.2", - "typescript-eslint": "^8.29.0" + "typescript": "^5.9.2", + "typescript-eslint": "^8.39.0" }, "peerDependencies": { - "amqplib": "^0.10.5", - "better-sqlite3": "^11.3.0", + "amqplib": "^0.10.8", + "better-sqlite3": "^11.10.0", "md5": "^2.3.0" } } From bd0e0f5f04d7d2b7eb259470e66ae8f4c621b283 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 11 Aug 2025 16:43:02 +0100 Subject: [PATCH 071/169] 1.0.0-rc.12 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2d02243..e2e6b58 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.12](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.11...v1.0.0-rc.12) (2025-08-11) + + + # [1.0.0-rc.11](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.10...v1.0.0-rc.11) (2025-05-09) diff --git a/package-lock.json b/package-lock.json index 063550d..825f729 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.11", + "version": "1.0.0-rc.12", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.11", + "version": "1.0.0-rc.12", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index e99998c..e01312e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.11", + "version": "1.0.0-rc.12", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 2297da0c8a2eed76d2814ea7f2773022607e1e97 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 00:18:02 +0100 Subject: [PATCH 072/169] Refactor command handling to support synchronous and asynchronous execution --- src/AbstractAggregate.ts | 51 +++++++++++++++++++++++++++++++++------- 1 file changed, 42 insertions(+), 9 deletions(-) diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 1975d24..8325718 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -108,7 +108,7 @@ export abstract class AbstractAggregate this.getUncommittedEvents(eventsOffset)) + .finally(() => { + this.command = undefined; + }); + } + else { // handle synchronous result + const events = this.getUncommittedEvents(eventsOffset); + this.command = undefined; + return events; + } + } + catch (err) { + this.command = undefined; + throw err; + } } - /** Get events emitted during command(s) handling and reset the `changes` collection */ - protected popChanges(): IEventSet { + /** + * Get the events emitted during commands processing. + * If a snapshot should be taken, the snapshot event is added to the end. + */ + protected getUncommittedEvents(offset?: number): IEventSet { if (this.shouldTakeSnapshot) - this.emit(SNAPSHOT_EVENT_TYPE, this.makeSnapshot()); + this.takeSnapshot(); - return this.#changes.splice(0); + return this.changes.slice(offset); } /** Format and register aggregate event and mutate aggregate state */ - protected emit(type: string, payload?: TPayload) { + protected emit(type: string, payload?: TPayload): IEvent { if (typeof type !== 'string' || !type.length) throw new TypeError('type argument must be a non-empty string'); const event = this.makeEvent(type, payload, this.command); this.emitRaw(event); + + return event; } /** Format event based on a current aggregate state and a command being executed */ @@ -190,6 +217,12 @@ export abstract class AbstractAggregate) { if (!snapshotEvent) From c896ee6731e184c892708088467949ec64d990fc Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 00:19:50 +0100 Subject: [PATCH 073/169] Refactor event handling to use protected changes array --- src/AbstractAggregate.ts | 11 ++-- src/interfaces/IAggregate.ts | 18 ++++-- tests/unit/AbstractAggregate.test.ts | 91 +++++++++++++++++++++++----- 3 files changed, 95 insertions(+), 25 deletions(-) diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 8325718..b92715e 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -30,10 +30,12 @@ export abstract class AbstractAggregate 50; */ // eslint-disable-next-line class-methods-use-this protected get shouldTakeSnapshot(): boolean { @@ -206,7 +209,7 @@ export abstract class AbstractAggregate; } diff --git a/tests/unit/AbstractAggregate.test.ts b/tests/unit/AbstractAggregate.test.ts index 9de2c7b..2ccdbe1 100644 --- a/tests/unit/AbstractAggregate.test.ts +++ b/tests/unit/AbstractAggregate.test.ts @@ -87,21 +87,18 @@ describe('AbstractAggregate', function () { }); }); - describe('popChanges', () => { + describe('protected changes', () => { it('contains an EventStream of changes happened in aggregate', async () => { - const changes0 = agg.popChanges(); + expect(agg).to.haveOwnProperty('changes').that.has.length(0); - expect(changes0).to.be.an('Array'); - expect(changes0).to.be.empty; - - const changes = await agg.handle({ type: 'doSomething' }); + await agg.handle({ type: 'doSomething' }); - expect(changes).to.not.equal(changes0); - expect(changes).to.have.nested.property('[0].type', 'somethingDone'); - expect(changes).to.have.nested.property('[0].aggregateId', 1); - expect(changes).to.have.nested.property('[0].aggregateVersion', 0); + expect(agg).to.haveOwnProperty('changes').that.has.length(1); + expect(agg).to.have.nested.property('changes.[0].type', 'somethingDone'); + expect(agg).to.have.nested.property('changes.[0].aggregateId', 1); + expect(agg).to.have.nested.property('changes.[0].aggregateVersion', 0); }); }); @@ -129,7 +126,7 @@ describe('AbstractAggregate', function () { }); }); - describe('state', () => { + describe('protected state', () => { it('is an inner aggregate state', () => { @@ -175,16 +172,78 @@ describe('AbstractAggregate', function () { assert(emitSpy.calledOnce, 'emit was not called once'); }); + + it('throws error if another command is being processed', async () => { + try { + const p1 = agg.handle({ type: 'doSomething' }); + const p2 = agg.handle({ type: 'doSomething' }); + + await Promise.all([p1, p2]); + + throw new AssertionError('did not fail'); + } + catch (err) { + expect(err).to.have.property('message', 'Another command is being processed'); + } + }); + + it('appends snapshot event if shouldTakeSnapshot is true', async () => { + + class AggregateWithSnapshot extends Aggregate { + protected get shouldTakeSnapshot(): boolean { + return true; + } + } + + agg = new AggregateWithSnapshot({ id: 1 }); + + const events = await agg.handle({ type: 'doSomething' }); + + expect(events).to.have.length(2); + + expect(events[0]).to.have.property('type', 'somethingDone'); + expect(events[1]).to.have.property('type', 'snapshot'); + expect(events[1]).to.have.property('payload').that.deep.equals((agg as any).state); + }); + + it('increments snapshotVersion to avoid unnecessary snapshots on following commands', async () => { + + class AggregateWithSnapshot extends Aggregate { + protected get shouldTakeSnapshot(): boolean { + return this.version - (this.snapshotVersion || 0) >= 3; + } + } + + agg = new AggregateWithSnapshot({ id: 1 }); + + const r: Array<{ events: number, version: number, snapshotVersion: number | undefined }> = []; + + for (let i = 0; i < 5; i++) { + const events = await agg.handle({ type: 'doSomething' }); + r.push({ + events: events.length, + version: agg.version, + snapshotVersion: agg.snapshotVersion + }); + } + + expect(r).to.eql([ + { events: 1, version: 1, snapshotVersion: undefined }, + { events: 1, version: 2, snapshotVersion: undefined }, + { events: 2, version: 4, snapshotVersion: 3 }, // 2 events on 3rd command: regular + snapshot + { events: 1, version: 5, snapshotVersion: 3 }, // no snapshot on 4th command + { events: 2, version: 7, snapshotVersion: 6 } // 2 events on 5th command: regular + snapshot + ]); + }); }); - describe('emit(eventType, eventPayload)', () => { + describe('protected emit(eventType, eventPayload)', () => { it('pushes new event to #changes', () => { (agg as any).emit('eventType', {}); - const changes = agg.popChanges(); - expect(changes).to.have.nested.property('[0].type', 'eventType'); + expect(agg).to.have.nested.property('changes[0].type', 'eventType'); }); it('increments aggregate #version', () => { @@ -269,7 +328,7 @@ describe('AbstractAggregate', function () { }); }); - describe('makeSnapshot()', () => { + describe('protected makeSnapshot()', () => { it('exists', () => { expect(agg).to.respondTo('makeSnapshot'); @@ -295,7 +354,7 @@ describe('AbstractAggregate', function () { }); }); - describe('restoreSnapshot(snapshotEvent)', () => { + describe('protected restoreSnapshot(snapshotEvent)', () => { const snapshotEvent = { type: 'snapshot', payload: { somethingDone: 1 } }; From 8ef62c85441a4abea6299cae3ba6d2373cffd66f Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 00:20:13 +0100 Subject: [PATCH 074/169] 1.0.0-rc.13 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e2e6b58..3c0b6b8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.13](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.12...v1.0.0-rc.13) (2025-08-14) + + + # [1.0.0-rc.12](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.11...v1.0.0-rc.12) (2025-08-11) diff --git a/package-lock.json b/package-lock.json index 825f729..bfcf54e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.12", + "version": "1.0.0-rc.13", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.12", + "version": "1.0.0-rc.13", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index e01312e..b445f5e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.12", + "version": "1.0.0-rc.13", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 7b000496069a647178632f89e9200027d2f1b781 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 15:02:30 +0100 Subject: [PATCH 075/169] Move jest-deprecated setting to tsconfig --- jest.config.ts | 7 +------ tsconfig.json | 1 + 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/jest.config.ts b/jest.config.ts index 469c8e1..478bb43 100644 --- a/jest.config.ts +++ b/jest.config.ts @@ -37,11 +37,6 @@ export default { // A map from regular expressions to paths to transformers transform: { - '^.+\\.tsx?$': [ - 'ts-jest', - { - isolatedModules: true - } - ] + '^.+\\.tsx?$': ['ts-jest'] } }; diff --git a/tsconfig.json b/tsconfig.json index 5e99f1f..2ac6347 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -16,6 +16,7 @@ "strictFunctionTypes": true, "strictBindCallApply": true, "strictPropertyInitialization": true, + "isolatedModules": true }, "include": [ "src/**/*" From 7603e25abd8ca5104c8b2e9cf9a4566da7c87c11 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 15:03:28 +0100 Subject: [PATCH 076/169] Remove unused import --- src/EventDispatcher.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 968415e..975cc26 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -11,7 +11,7 @@ import { } from './interfaces'; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; -import { getClassName, notEmpty } from './utils'; +import { getClassName } from './utils'; import { InMemoryMessageBus } from './in-memory'; type EventBatchEnvelope = { From 10308681f73b63486752b33ff1ce9e8053643658 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 15:04:04 +0100 Subject: [PATCH 077/169] Remove eventStorageWrite from default container as it's implementation-specific --- examples/user-domain/index.js | 2 ++ src/CqrsContainerBuilder.ts | 16 +++++----------- src/interfaces/IContainer.ts | 3 +-- tests/unit/dispatch-pipeline.test.ts | 2 ++ 4 files changed, 10 insertions(+), 13 deletions(-) diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index b11ef0a..698160a 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -9,6 +9,7 @@ const { InMemoryMessageBus, EventDispatcher } = require('../..'); // node-cqrs +const { InMemorySnapshotStorage } = require('../../dist/in-memory/InMemorySnapshotStorage'); const UserAggregate = require('./UserAggregate'); const UsersProjection = require('./UsersProjection'); @@ -20,6 +21,7 @@ exports.createContainer = () => { // register infrastructure services builder.register(InMemoryEventStorage).as('eventStorageReader').as('eventStorageWriter'); + builder.register(InMemorySnapshotStorage).as('snapshotStorage'); builder.register(InMemoryMessageBus).as('eventBus'); // register domain entities diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 342bd96..7574f43 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -4,7 +4,7 @@ import { CommandBus } from './CommandBus'; import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; import { EventDispatcher } from './EventDispatcher'; -import { InMemoryEventStorage, InMemoryMessageBus, InMemorySnapshotStorage } from './in-memory'; +import { InMemoryMessageBus } from './in-memory'; import { EventValidationProcessor } from './EventValidationProcessor'; import { isClass } from './utils'; import { @@ -29,16 +29,10 @@ export class CqrsContainerBuilder extends ContainerBuilder { super.register(CommandBus).as('commandBus'); super.register(EventDispatcher).as('eventDispatcher'); - super.register(InMemoryEventStorage).as('eventStorageWriter'); - super.register(InMemorySnapshotStorage).as('snapshotStorage'); - - // Register default event dispatch pipeline: - // validate events, write to event storage, write to snapshot storage. - // If any of the processors is not defined, it will be skipped. - super.register((container: IContainer) => [ - new EventValidationProcessor(), - container.eventStorageWriter, - container.snapshotStorage + // Register default event dispatch pipeline with event validation only; + // No storage processors added by default + super.register(() => [ + new EventValidationProcessor() ]).as('eventDispatchPipeline'); } diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index 6cf5e73..b327856 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -4,7 +4,7 @@ import { IEventDispatcher } from './IEventDispatcher'; import { IEventStore } from './IEventStore'; import { IEventBus } from './IEventBus'; import { IDispatchPipelineProcessor } from './IDispatchPipelineProcessor'; -import { IEventStorageReader, IEventStorageWriter } from './IEventStorage'; +import { IEventStorageReader } from './IEventStorage'; import { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage'; import { IIdentifierProvider } from './IIdentifierProvider'; import { IExtendableLogger, ILogger } from './ILogger'; @@ -13,7 +13,6 @@ export interface IContainer extends Container { eventBus: IEventBus; eventStore: IEventStore eventStorageReader: IEventStorageReader; - eventStorageWriter?: IEventStorageWriter; identifierProvider?: IIdentifierProvider; snapshotStorage?: IAggregateSnapshotStorage; diff --git a/tests/unit/dispatch-pipeline.test.ts b/tests/unit/dispatch-pipeline.test.ts index 5797e74..119af15 100644 --- a/tests/unit/dispatch-pipeline.test.ts +++ b/tests/unit/dispatch-pipeline.test.ts @@ -1,3 +1,4 @@ +import { InMemorySnapshotStorage } from '../../dist/in-memory/InMemorySnapshotStorage'; import { ContainerBuilder, EventValidationProcessor, @@ -22,6 +23,7 @@ describe('eventDispatchPipeline', () => { builder.register(InMemoryMessageBus).as('externalEventBus'); builder.register(InMemoryEventStorage).as('eventStorageWriter'); + builder.register(InMemorySnapshotStorage).as('snapshotStorage'); builder.register((c: IContainer) => [ new EventValidationProcessor(), c.externalEventBus, From ea828ff77ee774bc8df9e384e8b9ae8ce66de491 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 15 Aug 2025 15:22:40 +0100 Subject: [PATCH 078/169] 1.0.0-rc.14 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3c0b6b8..07e3aab 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.14](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.13...v1.0.0-rc.14) (2025-08-15) + + + # [1.0.0-rc.13](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.12...v1.0.0-rc.13) (2025-08-14) diff --git a/package-lock.json b/package-lock.json index bfcf54e..9e04af7 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.13", + "version": "1.0.0-rc.14", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.13", + "version": "1.0.0-rc.14", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index b445f5e..625d7e7 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.13", + "version": "1.0.0-rc.14", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 233046c597fd13c096fa8a12c48e5b8fafcd9359 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 16 Aug 2025 20:59:51 +0100 Subject: [PATCH 079/169] Add eventStorageWriter and snapshotStorage to event dispatch pipeline if they implement IDispatchPipelineProcessor interface --- examples/user-domain/index.js | 6 ++++-- src/CqrsContainerBuilder.ts | 15 ++++++++++----- 2 files changed, 14 insertions(+), 7 deletions(-) diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index 698160a..e276a54 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -9,7 +9,7 @@ const { InMemoryMessageBus, EventDispatcher } = require('../..'); // node-cqrs -const { InMemorySnapshotStorage } = require('../../dist/in-memory/InMemorySnapshotStorage'); +const { InMemorySnapshotStorage } = require('../..'); const UserAggregate = require('./UserAggregate'); const UsersProjection = require('./UsersProjection'); @@ -19,7 +19,9 @@ const UsersProjection = require('./UsersProjection'); exports.createContainer = () => { const builder = new ContainerBuilder(); - // register infrastructure services + // register infrastructure services; + // eventStorageWriter and snapshotStorage are automatically added to the event dispatch pipeline + // if they implement IDispatchPipelineProcessor interface (see src/CqrsContainerBuilder.ts) builder.register(InMemoryEventStorage).as('eventStorageReader').as('eventStorageWriter'); builder.register(InMemorySnapshotStorage).as('snapshotStorage'); builder.register(InMemoryMessageBus).as('eventBus'); diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 7574f43..617dbfa 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -14,7 +14,8 @@ import { IEventReceptor, IProjection, IProjectionConstructor, - ISagaConstructor + ISagaConstructor, + isDispatchPipelineProcessor } from './interfaces'; export class CqrsContainerBuilder extends ContainerBuilder { @@ -29,10 +30,14 @@ export class CqrsContainerBuilder extends ContainerBuilder { super.register(CommandBus).as('commandBus'); super.register(EventDispatcher).as('eventDispatcher'); - // Register default event dispatch pipeline with event validation only; - // No storage processors added by default - super.register(() => [ - new EventValidationProcessor() + // Register default event dispatch pipeline with event validation only + super.register(c => [ + new EventValidationProcessor(), + + // automatically add `eventStorageWrite` and `snapshotStorage` to the default dispatch pipeline + // if they're registered in the DI container and implement `IDispatchPipelineProcessor` interface + ...isDispatchPipelineProcessor(c.eventStorageWriter) ? [c.eventStorageWriter] : [], + ...isDispatchPipelineProcessor(c.snapshotStorage) ? [c.snapshotStorage] : [] ]).as('eventDispatchPipeline'); } From ad51b0aef199d5535ad67cc052dc7653fba9cad2 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 24 Aug 2025 01:41:50 +0100 Subject: [PATCH 080/169] Remove EventValidationProcessor implementation --- src/CqrsContainerBuilder.ts | 4 ---- src/Event.ts | 14 ------------ src/EventValidationProcessor.ts | 33 ---------------------------- src/index.ts | 1 - src/interfaces/IEvent.ts | 3 ++- tests/unit/dispatch-pipeline.test.ts | 2 -- 6 files changed, 2 insertions(+), 55 deletions(-) delete mode 100644 src/EventValidationProcessor.ts diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 617dbfa..072ef23 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -5,7 +5,6 @@ import { EventStore } from './EventStore'; import { SagaEventHandler } from './SagaEventHandler'; import { EventDispatcher } from './EventDispatcher'; import { InMemoryMessageBus } from './in-memory'; -import { EventValidationProcessor } from './EventValidationProcessor'; import { isClass } from './utils'; import { IAggregateConstructor, @@ -30,10 +29,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { super.register(CommandBus).as('commandBus'); super.register(EventDispatcher).as('eventDispatcher'); - // Register default event dispatch pipeline with event validation only super.register(c => [ - new EventValidationProcessor(), - // automatically add `eventStorageWrite` and `snapshotStorage` to the default dispatch pipeline // if they're registered in the DI container and implement `IDispatchPipelineProcessor` interface ...isDispatchPipelineProcessor(c.eventStorageWriter) ? [c.eventStorageWriter] : [], diff --git a/src/Event.ts b/src/Event.ts index ab2abc8..fecaf16 100644 --- a/src/Event.ts +++ b/src/Event.ts @@ -16,17 +16,3 @@ export function describeMultiple(events: ReadonlyArray): string { return `${events.length} events`; } - -/** - * Validate event structure - */ -export function validate(event: IEvent) { - if (typeof event !== 'object' || !event) - throw new TypeError('event must be an Object'); - if (typeof event.type !== 'string' || !event.type.length) - throw new TypeError('event.type must be a non-empty String'); - if (!event.aggregateId && !event.sagaId) - throw new TypeError('either event.aggregateId or event.sagaId is required'); - if (event.sagaId && typeof event.sagaVersion === 'undefined') - throw new TypeError('event.sagaVersion is required, when event.sagaId is defined'); -} diff --git a/src/EventValidationProcessor.ts b/src/EventValidationProcessor.ts deleted file mode 100644 index da5d0b2..0000000 --- a/src/EventValidationProcessor.ts +++ /dev/null @@ -1,33 +0,0 @@ -import { DispatchPipelineBatch, IEvent, IDispatchPipelineProcessor } from './interfaces'; -import { validate as defaultValidator } from './Event'; - -export type EventValidator = (event: IEvent) => void; - -/** - * Processor that validates the format of events. - * Rejects the batch if any event fails validation. - */ -export class EventValidationProcessor implements IDispatchPipelineProcessor { - - #validate: EventValidator; - - constructor(o?: { - eventFormatValidator?: EventValidator - }) { - this.#validate = o?.eventFormatValidator ?? defaultValidator; - } - - /** - * Processes a batch of dispatch pipeline items by validating each event within the batch. - * It iterates through the batch and calls the private `#validate` method for each event found. - * - * This method is part of the `IDispatchPipelineProcessor` interface. - */ - async process(batch: DispatchPipelineBatch): Promise { - for (const { event } of batch) { - if (event) - this.#validate(event); - } - return batch; - } -} diff --git a/src/index.ts b/src/index.ts index 6db623e..27d5d0b 100644 --- a/src/index.ts +++ b/src/index.ts @@ -9,7 +9,6 @@ export * from './AbstractSaga'; export * from './SagaEventHandler'; export * from './AbstractProjection'; export * from './EventDispatcher'; -export * from './EventValidationProcessor'; export * from './in-memory'; diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts index 0afe504..0b007c9 100644 --- a/src/interfaces/IEvent.ts +++ b/src/interfaces/IEvent.ts @@ -10,4 +10,5 @@ export type IEvent = IMessage & { export const isEvent = (event: unknown): event is IEvent => isObject(event) && 'type' in event - && typeof event.type === 'string'; + && typeof event.type === 'string' + && event.type.length > 0; diff --git a/tests/unit/dispatch-pipeline.test.ts b/tests/unit/dispatch-pipeline.test.ts index 119af15..bf1f134 100644 --- a/tests/unit/dispatch-pipeline.test.ts +++ b/tests/unit/dispatch-pipeline.test.ts @@ -1,7 +1,6 @@ import { InMemorySnapshotStorage } from '../../dist/in-memory/InMemorySnapshotStorage'; import { ContainerBuilder, - EventValidationProcessor, IContainer, InMemoryEventStorage, InMemoryMessageBus @@ -25,7 +24,6 @@ describe('eventDispatchPipeline', () => { builder.register(InMemoryEventStorage).as('eventStorageWriter'); builder.register(InMemorySnapshotStorage).as('snapshotStorage'); builder.register((c: IContainer) => [ - new EventValidationProcessor(), c.externalEventBus, c.eventStorageWriter, c.snapshotStorage From 2c574655cb8c46965164d1f08fcbafba55118ff5 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 24 Aug 2025 01:48:38 +0100 Subject: [PATCH 081/169] Make changelog script to regenerate full changelog --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 625d7e7..98f09e1 100644 --- a/package.json +++ b/package.json @@ -53,7 +53,7 @@ "test:coverage": "jest --collect-coverage tests/unit", "pretest:integration": "npm run build", "test:integration": "jest --verbose examples/user-domain-tests tests/integration", - "changelog": "conventional-changelog -n ./scripts/changelog -i CHANGELOG.md -s", + "changelog": "conventional-changelog -n ./scripts/changelog -r 0 > CHANGELOG.md", "clean": "tsc --build --clean", "build": "tsc --build", "prepare": "npm run build", From f7d0c004699cf39f271214a95544dd1d0aec995e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 24 Aug 2025 01:55:13 +0100 Subject: [PATCH 082/169] Add script of obsolete tags cleanup --- package.json | 2 +- scripts/cleanup_obsolete_tags.sh | 49 ++++++++++++++++++++++++++++++++ 2 files changed, 50 insertions(+), 1 deletion(-) create mode 100755 scripts/cleanup_obsolete_tags.sh diff --git a/package.json b/package.json index 98f09e1..3f9bd98 100644 --- a/package.json +++ b/package.json @@ -58,7 +58,7 @@ "build": "tsc --build", "prepare": "npm run build", "preversion": "npm test", - "version": "npm run changelog && git add CHANGELOG.md", + "version": "./scripts/cleanup_obsolete_tags.sh v$npm_package_version && npm run changelog && git add CHANGELOG.md", "lint": "eslint" }, "author": "@snatalenko", diff --git a/scripts/cleanup_obsolete_tags.sh b/scripts/cleanup_obsolete_tags.sh new file mode 100755 index 0000000..56c4f30 --- /dev/null +++ b/scripts/cleanup_obsolete_tags.sh @@ -0,0 +1,49 @@ +#!/bin/bash + +set -e + +comingTag=$1 # can be empty +intermediaryTags=$(git tag -l "v*-*") +tagsToDelete=() + +if [[ ! -z "$comingTag" ]]; then + echo "Creating $comingTag" +fi + +# Check all intemediary tags (containing "-") +# and drop ones that have successor tags created (i.e. "1.80.0" for "1.80.0-0", or "" +for intermediaryTag in $intermediaryTags +do + releaseTag=${intermediaryTag%%-*} + + if [ $(git tag -l "$releaseTag") ]; then + echo "Release tag $releaseTag exists, $intermediaryTag can be removed" + tagsToDelete+=($intermediaryTag) + + elif [[ "$comingTag" = "$releaseTag" ]]; then + echo "Release tag $comingTag is about to be created, $intermediaryTag can be removed" + tagsToDelete+=($intermediaryTag) + + elif [[ "$intermediaryTag" == *"-rc"* ]]; then + echo "No release tag for $intermediaryTag found" + + elif [ $(git tag -l "$releaseTag-rc.*") ]; then + echo "Pre-release tag $releaseTag-rc.* exists, $intermediaryTag can be removed" + tagsToDelete+=($intermediaryTag) + + elif [[ "$comingTag" == "$releaseTag-rc."* ]]; then + echo "Pre-release tag $comingTag is about to be created, $intermediaryTag can be removed" + tagsToDelete+=($intermediaryTag) + + else + echo "No successors for $intermediaryTag found" + fi +done + +if (( ${#tagsToDelete[@]} )); then + echo "Removing tags from remote..." + git push --no-verify --delete origin ${tagsToDelete[@]} || true + + echo "Removing tags locally..." + git tag -d ${tagsToDelete[@]} +fi From 069ca423afcc675f13e88a16880c7a253db3d363 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 24 Aug 2025 01:56:11 +0100 Subject: [PATCH 083/169] 1.0.0-rc.15 --- CHANGELOG.md | 276 ++++++++++++++++++++++++++++------------------ package-lock.json | 4 +- package.json | 2 +- 3 files changed, 169 insertions(+), 113 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 07e3aab..f4ec584 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.15](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.14...v1.0.0-rc.15) (2025-08-24) + + + # [1.0.0-rc.14](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.13...v1.0.0-rc.14) (2025-08-15) @@ -55,36 +59,21 @@ * Remove `publishAsync` setting, simplify publishing sequence ([79257e5](https://github.com/snatalenko/node-cqrs/commit/79257e59d322df5dd8e41bedf5273c97ae77b609)) -# [1.0.0-rc.6](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.5...v1.0.0-rc.6) (2025-03-21) - - -### Changes - -* Support persistent views; Add SQLite infrastructure ([c235573](https://github.com/snatalenko/node-cqrs/commit/c235573678be349d031d1a696cab3993224979a2)) +# [1.0.0-rc.6](https://github.com/snatalenko/node-cqrs/compare/v0.16.4...v1.0.0-rc.6) (2025-03-21) -# [1.0.0-rc.5](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.4...v1.0.0-rc.5) (2024-10-27) +### Fixes +* Vulnerability in minimist dependency ([07b8c68](https://github.com/snatalenko/node-cqrs/commit/07b8c682fae4278965aa13a06caa994c037934e9)) ### Changes * Add `InMemoryView.prototype.getSync` method ([5d4adb9](https://github.com/snatalenko/node-cqrs/commit/5d4adb9109c4c85edae2b0f3dfd995e8c51aef06)) +* Support persistent views; Add SQLite infrastructure ([c235573](https://github.com/snatalenko/node-cqrs/commit/c235573678be349d031d1a696cab3993224979a2)) +### Refactoring -# [1.0.0-rc.4](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.3...v1.0.0-rc.4) (2024-10-02) - - - -# [1.0.0-rc.3](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.2...v1.0.0-rc.3) (2024-09-23) - - - -# [1.0.0-rc.2](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.1...v1.0.0-rc.2) (2024-08-03) - - - -# [1.0.0-rc.1](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.0...v1.0.0-rc.1) (2024-08-03) - +* Migrate to TS and Jest ([6737d55](https://github.com/snatalenko/node-cqrs/commit/6737d5566a9dc6314df0b20a65d32414fc503e54)) ### Build System @@ -92,18 +81,6 @@ * Suppress audit and test for tags ([574a00c](https://github.com/snatalenko/node-cqrs/commit/574a00cc53af009994ca4dd3278cb764743b4ad6)) -# [1.0.0-rc.0](https://github.com/snatalenko/node-cqrs/compare/v0.16.4...v1.0.0-rc.0) (2024-08-02) - - -### Fixes - -* Vulnerability in minimist dependency ([07b8c68](https://github.com/snatalenko/node-cqrs/commit/07b8c682fae4278965aa13a06caa994c037934e9)) - -### Refactoring - -* Migrate to TS and Jest ([6737d55](https://github.com/snatalenko/node-cqrs/commit/6737d5566a9dc6314df0b20a65d32414fc503e54)) - - ## [0.16.4](https://github.com/snatalenko/node-cqrs/compare/v0.16.3...v0.16.4) (2022-08-28) @@ -141,36 +118,24 @@ * Postpone view.get responses to next loop iteration ([950c2e4](https://github.com/snatalenko/node-cqrs/commit/950c2e42f62d7388b0cc668e81fb4f6718656fca)) -# [0.16.0](https://github.com/snatalenko/node-cqrs/compare/v0.16.0-5...v0.16.0) (2020-03-18) - - -### Fixes - -* Moderate security issue in "minimist" dev dependency ([579d523](https://github.com/snatalenko/node-cqrs/commit/579d523745a6d33902a5245bc7e9f3fe843abc2b)) - - -# [0.16.0-5](https://github.com/snatalenko/node-cqrs/compare/v0.16.0-4...v0.16.0-5) (2020-02-19) - - - -# [0.16.0-4](https://github.com/snatalenko/node-cqrs/compare/v0.16.0-3...v0.16.0-4) (2020-02-19) - - - -# [0.16.0-3](https://github.com/snatalenko/node-cqrs/compare/v0.16.0-2...v0.16.0-3) (2020-01-28) +# [0.16.0](https://github.com/snatalenko/node-cqrs/compare/v0.15.1...v0.16.0) (2020-03-18) ### Features +* Accept logger as an optional dependency ([65fe5ad](https://github.com/snatalenko/node-cqrs/commit/65fe5ad8a9de48d548715a2bd651f6d9c4cb0af1)) * Detect circular dependencies in DI container ([1490b51](https://github.com/snatalenko/node-cqrs/commit/1490b519c7581b1de6cd084d91f61875751d773b)) ### Fixes +* Debug output not using toString in Node 12 ([ca0d32f](https://github.com/snatalenko/node-cqrs/commit/ca0d32f78a676faf45a342f4198ef4a93a3d0702)) * Debug output on one time subscriptions ([2fd7601](https://github.com/snatalenko/node-cqrs/commit/2fd7601b6b8e8059f0b777af6c1294cc78cb787b)) * Correctly set type of the extended container builder created from container ([1f2f632](https://github.com/snatalenko/node-cqrs/commit/1f2f6325ceab65c4c81494d145261668125d03b1)) +* Moderate security issue in "minimist" dev dependency ([579d523](https://github.com/snatalenko/node-cqrs/commit/579d523745a6d33902a5245bc7e9f3fe843abc2b)) ### Changes +* Debug, mocha, sinon ([ac80c27](https://github.com/snatalenko/node-cqrs/commit/ac80c27653828904cf7b80d37b0ecade860b7490)) * Move DI container to a separate package ([350f3f4](https://github.com/snatalenko/node-cqrs/commit/350f3f405a98fea2c7a85ea92f2b0f1aa945c75c)) * Do not bind masterHandler to observer automatically ([d2ec79d](https://github.com/snatalenko/node-cqrs/commit/d2ec79dced5460f619cf9bed5f34df1bbb8e0132)) * Remove deprecated InMemoryView..markAsReady method ([23015ec](https://github.com/snatalenko/node-cqrs/commit/23015ec3f5bc69f843cf6815caa1f4cda9fea27c)) @@ -184,122 +149,213 @@ ### Tests +* Fix tests in Node 12 ([beeb471](https://github.com/snatalenko/node-cqrs/commit/beeb471faee9e1259f11b4c1c65877cd27309637)) * Run example domain tests with unit tests ([5ffdb43](https://github.com/snatalenko/node-cqrs/commit/5ffdb43c0398fc6650a7a1d62a5f07870ee20bfd)) * Run eslint for entire project folder ([d9055a1](https://github.com/snatalenko/node-cqrs/commit/d9055a158faa67dc9ece4f77b01517a5480b0a18)) ### Build System +* Prevent git push on version ([3ea9e38](https://github.com/snatalenko/node-cqrs/commit/3ea9e38babf440ab384235e69d248fd92a2dfdff)) +* Add conventional-changelog script ([da26a1c](https://github.com/snatalenko/node-cqrs/commit/da26a1cf6db0a609fcb3f1ba3a29ce6db6d0ab95)) +* Run tests in NodeJS 12 env ([1d4239c](https://github.com/snatalenko/node-cqrs/commit/1d4239cf0f48e64105bfd6b28ab9a22f3fd23e7e)) +* Replace changelog eslint preset with custom one ([8507262](https://github.com/snatalenko/node-cqrs/commit/8507262eeb7c367bbb8bd52b74e04c678bfcf956)) * Exclude unnecessary files from package ([47b6797](https://github.com/snatalenko/node-cqrs/commit/47b679750780c0d7840d4d45a1296dc9bef7d674)) * Do not install global dependencies ([158783c](https://github.com/snatalenko/node-cqrs/commit/158783c299720e709b8a34f3ef74fba1390d03ad)) -# [0.16.0-2](https://github.com/snatalenko/node-cqrs/compare/v0.16.0-1...v0.16.0-2) (2019-12-18) +## [0.15.1](https://github.com/snatalenko/node-cqrs/compare/v0.15.0...v0.15.1) (2019-08-26) -### Features +### Changes -* Accept logger as an optional dependency ([65fe5ad](https://github.com/snatalenko/node-cqrs/commit/65fe5ad8a9de48d548715a2bd651f6d9c4cb0af1)) +* Upgrade dev dependencies to fix audit script ([ef01cc3](https://github.com/snatalenko/node-cqrs/commit/ef01cc33b63a95a8783a83b34c4fcb3f4830fe52)) -### Build System -* Replace changelog eslint preset with custom one ([8507262](https://github.com/snatalenko/node-cqrs/commit/8507262eeb7c367bbb8bd52b74e04c678bfcf956)) +# [0.15.0](https://github.com/snatalenko/node-cqrs/compare/v0.14.2...v0.15.0) (2019-08-25) -## [0.15.1](https://github.com/snatalenko/node-cqrs/compare/v0.15.0...v0.15.1) (2019-08-26) +## [0.14.2](https://github.com/snatalenko/node-cqrs/compare/v0.14.1...v0.14.2) (2018-07-29) -### Changes -* Upgrade dev dependencies to fix audit script ([ef01cc3](https://github.com/snatalenko/node-cqrs/commit/ef01cc33b63a95a8783a83b34c4fcb3f4830fe52)) +## [0.14.1](https://github.com/snatalenko/node-cqrs/compare/v0.14.0...v0.14.1) (2018-07-14) -# [0.16.0-1](https://github.com/snatalenko/node-cqrs/compare/v0.16.0-0...v0.16.0-1) (2019-11-28) -### Changes -* EventStore to return async event generators (requires NodeJS version 10+) +# [0.14.0](https://github.com/snatalenko/node-cqrs/compare/v0.13.0...v0.14.0) (2018-05-17) -### Build -* Add conventional-changelog script ([da26a1c](https://github.com/snatalenko/node-cqrs/commit/da26a1cf6db0a609fcb3f1ba3a29ce6db6d0ab95)) -* Prevent git push on version ([3ea9e38](https://github.com/snatalenko/node-cqrs/commit/3ea9e38babf440ab384235e69d248fd92a2dfdff)) -* Run tests in NodeJS 12 env ([1d4239c](https://github.com/snatalenko/node-cqrs/commit/1d4239cf0f48e64105bfd6b28ab9a22f3fd23e7e)) -### Fix +# [0.13.0](https://github.com/snatalenko/node-cqrs/compare/v0.12.6...v0.13.0) (2017-10-04) -* Debug output not using toString in Node 12 ([ca0d32f](https://github.com/snatalenko/node-cqrs/commit/ca0d32f78a676faf45a342f4198ef4a93a3d0702)) -### Tests -* Fix tests in Node 12 ([beeb471](https://github.com/snatalenko/node-cqrs/commit/beeb471faee9e1259f11b4c1c65877cd27309637)) +## [0.12.6](https://github.com/snatalenko/node-cqrs/compare/v0.12.5...v0.12.6) (2017-08-23) -### Upgrade -* debug, mocha, sinon ([ac80c27](https://github.com/snatalenko/node-cqrs/commit/ac80c27653828904cf7b80d37b0ecade860b7490)) -## 0.15.0 - 2018-08-25 +## [0.12.5](https://github.com/snatalenko/node-cqrs/compare/v0.12.4...v0.12.5) (2017-06-23) -### Features -* `InMemoryView.prototype.getAll` as an alternative to the deprecated `state` property +## [0.12.4](https://github.com/snatalenko/node-cqrs/compare/v0.12.3...v0.12.4) (2017-04-25) -### Changes -* `InMemoryView.prototype.create` 2nd parameter must be an instance of an Object, not a factory function -* `InMemoryView.prototype.updateEnforcingNew` does not pass an empty object as a parameter when record does not exist -* Observable `on(,,{queueName})` replaced with `queue(name).on(,)`; -* separated IProjectionView and IConcurrentView interfaces -* `IProjectionView.prototype.shouldRestore` can return Promise -* Projection `restore` process flow to support async concurrent views -### Fixes +## [0.12.3](https://github.com/snatalenko/node-cqrs/compare/v0.12.1...v0.12.3) (2017-04-24) -* Typings -* Call stack overflow in EventStream constructor on large number of events -## 0.14.2 (2018-07-29) +## [0.12.1](https://github.com/snatalenko/node-cqrs/compare/v0.12.0...v0.12.1) (2017-04-24) -### Fixes -* `Container.prototype.registerInstance` requires an Object as first parameter -## 0.14.1 (2018-07-14) +# [0.12.0](https://github.com/snatalenko/node-cqrs/compare/v0.11.1...v0.12.0) (2017-04-22) -### Features -* `Aggregate.prototype.makeEvent` as a separate method for testing purposes -### Fixes +## [0.11.1](https://github.com/snatalenko/node-cqrs/compare/v0.11.0...v0.11.1) (2017-03-01) -* Aggregate snapshot modification thru Aggregate state -* Tests with NodeJS@^10 -## 0.14.0 (2018-05-17) +# [0.11.0](https://github.com/snatalenko/node-cqrs/compare/v0.10.0...v0.11.0) (2017-01-18) -### Features -* examples/user-domain -* typings -* changelog -### Changes +# [0.10.0](https://github.com/snatalenko/node-cqrs/compare/v0.9.3...v0.10.0) (2017-01-16) -* snapshotStorage moved to a separate interface/entity -* named queues handling moved out of EventStore to InMemoryMessageBus implementation -* command-to-event context copying moved out of EventStore to AbstractAggregate.prototype.emit, which frees up road for a concurrent operations on same aggregate implementation -* EventStream is immutable -* `AbstractProjection.prototype.shouldRestoreView` can be overriden in projection for own view implementations -## 0.13.0 (2017-10-04) -### Documentation +## [0.9.3](https://github.com/snatalenko/node-cqrs/compare/v0.9.2...v0.9.3) (2017-01-06) + + + +## [0.9.2](https://github.com/snatalenko/node-cqrs/compare/v0.9.1...v0.9.2) (2016-12-19) + + + +## [0.9.1](https://github.com/snatalenko/node-cqrs/compare/v0.9.0...v0.9.1) (2016-12-17) + + + +# [0.9.0](https://github.com/snatalenko/node-cqrs/compare/v0.8.0...v0.9.0) (2016-12-17) + + + +# [0.8.0](https://github.com/snatalenko/node-cqrs/compare/v0.7.8...v0.8.0) (2016-12-07) + + + +## [0.7.8](https://github.com/snatalenko/node-cqrs/compare/v0.7.7...v0.7.8) (2016-12-05) + + + +## [0.7.7](https://github.com/snatalenko/node-cqrs/compare/v0.7.6...v0.7.7) (2016-12-04) + + + +## [0.7.6](https://github.com/snatalenko/node-cqrs/compare/v0.7.5...v0.7.6) (2016-12-01) + + + +## [0.7.5](https://github.com/snatalenko/node-cqrs/compare/v0.7.4...v0.7.5) (2016-12-01) + + + +## [0.7.4](https://github.com/snatalenko/node-cqrs/compare/v0.7.3...v0.7.4) (2016-11-30) + + + +## [0.7.3](https://github.com/snatalenko/node-cqrs/compare/v0.7.2...v0.7.3) (2016-11-29) + + + +## [0.7.2](https://github.com/snatalenko/node-cqrs/compare/v0.7.1...v0.7.2) (2016-11-25) + + + +## [0.7.1](https://github.com/snatalenko/node-cqrs/compare/v0.7.0...v0.7.1) (2016-11-20) + + + +# [0.7.0](https://github.com/snatalenko/node-cqrs/compare/v0.6.10...v0.7.0) (2016-11-18) + + + +## [0.6.10](https://github.com/snatalenko/node-cqrs/compare/v0.6.9...v0.6.10) (2016-10-24) + + + +## [0.6.9](https://github.com/snatalenko/node-cqrs/compare/v0.6.8...v0.6.9) (2016-10-24) + + + +## [0.6.8](https://github.com/snatalenko/node-cqrs/compare/v0.6.7...v0.6.8) (2016-10-23) + + + +## [0.6.7](https://github.com/snatalenko/node-cqrs/compare/v0.6.6...v0.6.7) (2016-10-23) + + + +## [0.6.6](https://github.com/snatalenko/node-cqrs/compare/v0.6.5...v0.6.6) (2016-08-23) + + + +## [0.6.5](https://github.com/snatalenko/node-cqrs/compare/v0.6.4...v0.6.5) (2016-08-23) + + + +## [0.6.4](https://github.com/snatalenko/node-cqrs/compare/v0.6.3...v0.6.4) (2016-07-24) + + + +## [0.6.3](https://github.com/snatalenko/node-cqrs/compare/v0.6.2...v0.6.3) (2016-07-06) + + + +## [0.6.2](https://github.com/snatalenko/node-cqrs/compare/v0.6.1...v0.6.2) (2016-07-02) + + + +## [0.6.1](https://github.com/snatalenko/node-cqrs/compare/v0.6.0...v0.6.1) (2016-05-31) + + + +# [0.6.0](https://github.com/snatalenko/node-cqrs/compare/v0.5.0...v0.6.0) (2016-03-06) + + + +# [0.5.0](https://github.com/snatalenko/node-cqrs/compare/v0.4.0...v0.5.0) (2016-03-03) + + + +# [0.4.0](https://github.com/snatalenko/node-cqrs/compare/v0.3.2...v0.4.0) (2016-03-03) + + + +## [0.3.2](https://github.com/snatalenko/node-cqrs/compare/v0.3.1...v0.3.2) (2016-02-29) + + + +## [0.3.1](https://github.com/snatalenko/node-cqrs/compare/v0.3.0...v0.3.1) (2016-02-29) + + + +# [0.3.0](https://github.com/snatalenko/node-cqrs/compare/v0.2.2...v0.3.0) (2016-02-29) + + + +## [0.2.2](https://github.com/snatalenko/node-cqrs/compare/v0.2.1...v0.2.2) (2015-12-23) + + + +## [0.2.1](https://github.com/snatalenko/node-cqrs/compare/v0.2.0...v0.2.1) (2015-12-22) + + + +# 0.2.0 (2015-12-22) -* docs publishing to [node-cqrs.org](https://www.node-cqrs.org) -### Changes -* In-Memory views do not respond to get(..) requests until they are restored -* In-Memory views restoring is handled by AbstractProjection diff --git a/package-lock.json b/package-lock.json index 9e04af7..78c9c57 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.14", + "version": "1.0.0-rc.15", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.14", + "version": "1.0.0-rc.15", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 3f9bd98..f2be78d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.14", + "version": "1.0.0-rc.15", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From edd888465c44abe40c6d659fd406ce627a6c2ad5 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 28 Aug 2025 20:37:41 +0100 Subject: [PATCH 084/169] Separate IEventStorage interfaces --- src/interfaces/IContainer.ts | 2 +- .../{IEventStorage.ts => IEventStorageReader.ts} | 9 --------- src/interfaces/IEventStorageWriter.ts | 10 ++++++++++ src/interfaces/IEventStore.ts | 2 +- src/interfaces/index.ts | 3 ++- 5 files changed, 14 insertions(+), 12 deletions(-) rename src/interfaces/{IEventStorage.ts => IEventStorageReader.ts} (83%) create mode 100644 src/interfaces/IEventStorageWriter.ts diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index b327856..7ed1440 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -4,7 +4,7 @@ import { IEventDispatcher } from './IEventDispatcher'; import { IEventStore } from './IEventStore'; import { IEventBus } from './IEventBus'; import { IDispatchPipelineProcessor } from './IDispatchPipelineProcessor'; -import { IEventStorageReader } from './IEventStorage'; +import { IEventStorageReader } from './IEventStorageReader'; import { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage'; import { IIdentifierProvider } from './IIdentifierProvider'; import { IExtendableLogger, ILogger } from './ILogger'; diff --git a/src/interfaces/IEventStorage.ts b/src/interfaces/IEventStorageReader.ts similarity index 83% rename from src/interfaces/IEventStorage.ts rename to src/interfaces/IEventStorageReader.ts index bc7dbdb..ba124b3 100644 --- a/src/interfaces/IEventStorage.ts +++ b/src/interfaces/IEventStorageReader.ts @@ -1,6 +1,5 @@ import { Identifier } from './Identifier'; import { IEvent } from './IEvent'; -import { IEventSet } from './IEventSet'; import { IEventStream } from './IEventStream'; import { isObject } from './isObject'; @@ -34,14 +33,6 @@ export interface IEventStorageReader { getSagaEvents(sagaId: Identifier, options: EventQueryBefore): IEventStream; } -export interface IEventStorageWriter { - - /** - * Persists a set of events to the event store. - * Returns the persisted event set (potentially enriched or normalized). - */ - commitEvents(events: IEventSet): Promise; -} export const isIEventStorageReader = (storage: unknown): storage is IEventStorageReader => isObject(storage) diff --git a/src/interfaces/IEventStorageWriter.ts b/src/interfaces/IEventStorageWriter.ts new file mode 100644 index 0000000..03521bc --- /dev/null +++ b/src/interfaces/IEventStorageWriter.ts @@ -0,0 +1,10 @@ +import { IEventSet } from './IEventSet'; + +export interface IEventStorageWriter { + + /** + * Persists a set of events to the event store. + * Returns the persisted event set (potentially enriched or normalized). + */ + commitEvents(events: IEventSet): Promise; +} diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index 1320e0d..0ded850 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,6 +1,6 @@ import { IEventDispatcher } from './IEventDispatcher'; import { IEvent } from './IEvent'; -import { IEventStorageReader } from './IEventStorage'; +import { IEventStorageReader } from './IEventStorageReader'; import { IIdentifierProvider } from './IIdentifierProvider'; import { IMessageHandler, IObservable } from './IObservable'; diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index e736e0a..6829a48 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -11,7 +11,8 @@ export * from './IEventDispatcher'; export * from './IEventLocker'; export * from './IEventReceptor'; export * from './IEventSet'; -export * from './IEventStorage'; +export * from './IEventStorageReader'; +export * from './IEventStorageWriter'; export * from './IEventStore'; export * from './IEventStream'; export * from './IIdentifierProvider'; From 5a7803c3da0f335c0e3c90560bf2d8e87f7d602e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 28 Aug 2025 20:40:45 +0100 Subject: [PATCH 085/169] Remove InMemoryMessageBus implementation of IDispatchPipelineProcessor --- src/in-memory/InMemoryMessageBus.ts | 24 +----------------------- tests/unit/dispatch-pipeline.test.ts | 27 +-------------------------- 2 files changed, 2 insertions(+), 49 deletions(-) diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index b678096..13c10e3 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -1,7 +1,5 @@ import { - DispatchPipelineBatch, ICommand, - IDispatchPipelineProcessor, IEvent, IMessageBus, IMessageHandler, @@ -12,7 +10,7 @@ import { * Default implementation of the message bus. * Keeps all subscriptions and messages in memory. */ -export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcessor { +export class InMemoryMessageBus implements IMessageBus { protected handlers: Map> = new Map(); protected uniqueEventHandlers: boolean; @@ -117,24 +115,4 @@ export class InMemoryMessageBus implements IMessageBus, IDispatchPipelineProcess return Promise.all(handlers.map(handler => handler(event, meta))); } - - /** - * Processes a batch of events and publishes them to the fanout exchange. - * - * This method is part of the `IDispatchPipelineProcessor` interface. - */ - async process(batch: DispatchPipelineBatch): Promise { - for (const { event, origin } of batch) { - // Skip publishing if the event was dispatched from external source - if (origin === 'external') - continue; - - if (!event) - throw new Error('Event batch does not contain `event`'); - - await this.publish(event); - } - - return batch; - } } diff --git a/tests/unit/dispatch-pipeline.test.ts b/tests/unit/dispatch-pipeline.test.ts index bf1f134..05dc35b 100644 --- a/tests/unit/dispatch-pipeline.test.ts +++ b/tests/unit/dispatch-pipeline.test.ts @@ -2,8 +2,7 @@ import { InMemorySnapshotStorage } from '../../dist/in-memory/InMemorySnapshotSt import { ContainerBuilder, IContainer, - InMemoryEventStorage, - InMemoryMessageBus + InMemoryEventStorage } from '../../src'; describe('eventDispatchPipeline', () => { @@ -20,11 +19,9 @@ describe('eventDispatchPipeline', () => { beforeEach(() => { const builder = new ContainerBuilder(); - builder.register(InMemoryMessageBus).as('externalEventBus'); builder.register(InMemoryEventStorage).as('eventStorageWriter'); builder.register(InMemorySnapshotStorage).as('snapshotStorage'); builder.register((c: IContainer) => [ - c.externalEventBus, c.eventStorageWriter, c.snapshotStorage ]).as('eventDispatchPipeline'); @@ -32,28 +29,6 @@ describe('eventDispatchPipeline', () => { container = builder.container() as IContainer; }); - it('delivers locally dispatched events to externalEventBus', async () => { - - const { eventDispatcher, externalEventBus } = container; - - jest.spyOn(externalEventBus, 'publish'); - - await eventDispatcher.dispatch([testEvent], { origin: 'internal' }); - - expect(externalEventBus.publish).toHaveBeenCalledTimes(1); - }); - - it('does not deliver externally dispatched events to externalEventBus', async () => { - - const { eventDispatcher, externalEventBus } = container; - - jest.spyOn(externalEventBus, 'publish'); - - await eventDispatcher.dispatch([testEvent], { origin: 'external' }); - - expect(externalEventBus.publish).toHaveBeenCalledTimes(0); - }); - it('delivers all events to eventStorageWriter', async () => { const { eventDispatcher, eventStorageWriter } = container; From 023ac6323edc5f7366fd776a08ef83fcec808a52 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 28 Aug 2025 20:43:27 +0100 Subject: [PATCH 086/169] Refactor `publish` method to remove unnecessary arrays --- src/in-memory/InMemoryMessageBus.ts | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index 13c10e3..c2b94a6 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -107,12 +107,14 @@ export class InMemoryMessageBus implements IMessageBus { if (typeof event.type !== 'string' || !event.type.length) throw new TypeError('event.type argument must be a non-empty String'); - const handlers = [ - ...this.handlers.get(event.type) || [], - ...Array.from(this.queues.values()).map(namedQueue => - (e: IEvent, m?: Record) => namedQueue.publish(e, m)) - ]; + const promises: Promise[] = []; - return Promise.all(handlers.map(handler => handler(event, meta))); + for (const handler of this.handlers.get(event.type) ?? []) + promises.push(handler(event, meta)); + + for (const namedQueue of this.queues.values()) + promises.push(namedQueue.publish(event, meta)); + + return Promise.all(promises); } } From 4a9262a4ace6cd5c5de543a79af5dff5f8882e6d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 29 Aug 2025 22:28:11 +0100 Subject: [PATCH 087/169] 1.0.0-rc.16 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f4ec584..66de549 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.16](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.15...v1.0.0-rc.16) (2025-08-29) + + + # [1.0.0-rc.15](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.14...v1.0.0-rc.15) (2025-08-24) diff --git a/package-lock.json b/package-lock.json index 78c9c57..c06f641 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.15", + "version": "1.0.0-rc.16", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.15", + "version": "1.0.0-rc.16", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index f2be78d..a4dd258 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.15", + "version": "1.0.0-rc.16", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 237ab3bdc847f17be6afc4de7d4a3bbe0ff8af2b Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 30 Aug 2025 00:12:24 +0100 Subject: [PATCH 088/169] Implement event dispatch pipelines with routing based on meta.origin --- src/EventDispatchPipeline.ts | 99 ++++++++++++++++ src/EventDispatcher.ts | 182 +++++++++++------------------ src/interfaces/IContainer.ts | 5 + tests/unit/EventDispatcher.test.ts | 91 +++++++++++++++ 4 files changed, 260 insertions(+), 117 deletions(-) create mode 100644 src/EventDispatchPipeline.ts diff --git a/src/EventDispatchPipeline.ts b/src/EventDispatchPipeline.ts new file mode 100644 index 0000000..0d1d95c --- /dev/null +++ b/src/EventDispatchPipeline.ts @@ -0,0 +1,99 @@ +import { + DispatchPipelineBatch, + IEvent, + IDispatchPipelineProcessor, + IEventBus, + isDispatchPipelineProcessor +} from './interfaces'; + +import { parallelPipe } from 'async-parallel-pipe'; +import { AsyncIterableBuffer } from 'async-iterable-buffer'; +import { getClassName } from './utils'; + +export type EventBatchEnvelope = { + data: DispatchPipelineBatch<{ event?: IEvent }>; + error?: Error; + resolve: (event: IEvent[]) => void; + reject: (error: Error) => void; +}; + +export class EventDispatchPipeline { + + #pipelineInput = new AsyncIterableBuffer(); + #processors: Array = []; + #pipeline: AsyncIterableIterator | IterableIterator = this.#pipelineInput; + #processing = false; + + constructor(private readonly eventBus: IEventBus, private readonly concurrentLimit: number) { + } + + addProcessor(preprocessor: IDispatchPipelineProcessor) { + if (!isDispatchPipelineProcessor(preprocessor)) + throw new TypeError(`preprocessor ${getClassName(preprocessor)} does not implement IDispatchPipelineProcessor`); + if (this.#processing) + throw new Error('pipeline processing already started'); + + this.#processors.push(preprocessor); + + // Build a processing pipeline that runs preprocessors concurrently, preserving FIFO ordering + this.#pipeline = parallelPipe(this.#pipeline, this.concurrentLimit, async envelope => { + if (envelope.error) + return envelope; + + try { + return { + ...envelope, + data: await preprocessor.process(envelope.data) + }; + } + catch (error: any) { + return { + ...envelope, + error + }; + } + }); + } + + #ensureProcessingStarted() { + if (this.#processing) + return; + + this.#processing = true; + + (async () => { + for await (const { error, reject, data, resolve } of this.#pipeline) { + try { + if (error) { + await this.revert(data); + reject(error); + continue; + } + + const events: IEvent[] = []; + for (const batch of data) { + const { event, ...meta } = batch as any; + if (event) { + await this.eventBus.publish(event, meta); + events.push(event); + } + } + resolve(events); + } + catch (publishError: any) { + reject(publishError); + } + } + })(); + } + + async revert(batch: DispatchPipelineBatch) { + for (const processor of this.#processors) + await processor.revert?.(batch); + } + + push(envelope: EventBatchEnvelope) { + this.#ensureProcessingStarted(); + this.#pipelineInput.push(envelope); + } +} diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 975cc26..890fa3b 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -1,174 +1,122 @@ import { - DispatchPipelineBatch, - IEvent, IEventDispatcher, IDispatchPipelineProcessor, IEventSet, IEventBus, isEventSet, - IContainer, - isDispatchPipelineProcessor + IContainer } from './interfaces'; -import { parallelPipe } from 'async-parallel-pipe'; -import { AsyncIterableBuffer } from 'async-iterable-buffer'; -import { getClassName } from './utils'; import { InMemoryMessageBus } from './in-memory'; - -type EventBatchEnvelope = { - data: DispatchPipelineBatch<{ event?: IEvent }>; - error?: Error; - resolve: (event: IEvent[]) => void; - reject: (error: Error) => void; -} +import { EventBatchEnvelope, EventDispatchPipeline } from './EventDispatchPipeline'; export class EventDispatcher implements IEventDispatcher { - #pipelineInput = new AsyncIterableBuffer(); - #processors: Array = []; - #pipeline: AsyncIterableIterator | IterableIterator = this.#pipelineInput; + /** Default pipeline name */ + static DEFAULT_PIPELINE = 'default'; + + /** Default maximum number of parallel batches for newly created pipelines */ + static DEFAULT_CONCURRENT_LIMIT = 100; + + /** Default router that uses `meta.origin` as the pipeline name */ + static DEFAULT_ROUTER = (_e: IEventSet, meta?: Record) => meta?.origin; /** * Event bus where dispatched messages are delivered after processing. - * * If not provided in the constructor, defaults to an instance of `InMemoryMessageBus`. */ eventBus: IEventBus; /** - * Maximum number of event batches that each pipeline processor can handle in parallel. + * Default maximum number of parallel batches for newly created pipelines. */ concurrentLimit: number; + /** Router that selects a pipeline name given events and meta */ + eventDispatchRouter?: (events: IEventSet, meta?: Record) => string | undefined; + + #pipelines = new Map(); + constructor(o?: Pick & { eventDispatcherConfig?: { concurrentLimit?: number - } + }, + eventDispatchPipelines?: Record, + eventDispatchRouter?: (events: IEventSet, meta?: Record) => string | undefined }) { this.eventBus = o?.eventBus ?? new InMemoryMessageBus(); - this.concurrentLimit = o?.eventDispatcherConfig?.concurrentLimit ?? 100; + this.concurrentLimit = o?.eventDispatcherConfig?.concurrentLimit ?? EventDispatcher.DEFAULT_CONCURRENT_LIMIT; + this.eventDispatchRouter = o?.eventDispatchRouter ?? EventDispatcher.DEFAULT_ROUTER; - if (o?.eventDispatchPipeline) - this.addPipelineProcessors(o.eventDispatchPipeline); + if (o?.eventDispatchPipelines) { + // Initialize pipelines if provided + for (const [name, processors] of Object.entries(o.eventDispatchPipelines)) + this.addPipeline(name, processors); + } + else if (o?.eventDispatchPipeline) { + // Single pipeline provided becomes the default pipeline + this.addPipeline(EventDispatcher.DEFAULT_PIPELINE, o.eventDispatchPipeline); + } + else { + // Ensure default pipeline exists at minimum + this.addPipeline(EventDispatcher.DEFAULT_PIPELINE, []); + } } - addPipelineProcessors(eventDispatchPipeline: IDispatchPipelineProcessor[]) { + /** Add or create the default pipeline processors */ + addPipelineProcessors(eventDispatchPipeline: IDispatchPipelineProcessor[], pipelineName?: string) { if (!Array.isArray(eventDispatchPipeline)) throw new TypeError('eventDispatchPipeline argument must be an Array'); - for (const processor of eventDispatchPipeline) { - if (processor) - this.addPipelineProcessor(processor); - } + for (const processor of eventDispatchPipeline) + this.addPipelineProcessor(processor, pipelineName); } - /** - * Adds a preprocessor to the event dispatch pipeline. - * - * Preprocessors run in order they are added but process separate batches in parallel, maintaining FIFO order. - */ - addPipelineProcessor(preprocessor: IDispatchPipelineProcessor) { - if (!isDispatchPipelineProcessor(preprocessor)) - throw new TypeError(`preprocessor ${getClassName(preprocessor)} does not implement IDispatchPipelineProcessor`); - if (this.#pipelineProcessing) - throw new Error('pipeline processing already started'); - - this.#processors.push(preprocessor); - - // Build a processing pipeline that runs preprocessors concurrently, preserving FIFO ordering - this.#pipeline = parallelPipe(this.#pipeline, this.concurrentLimit, async envelope => { - if (envelope.error) - return envelope; - - try { - return { - ...envelope, - data: await preprocessor.process(envelope.data) - }; - } - catch (error: any) { - return { - ...envelope, - error - }; - } - }); + /** Adds a single processor to the default pipeline */ + addPipelineProcessor(preprocessor: IDispatchPipelineProcessor, pipelineName?: string) { + const pipeline = this.#pipelines.get(pipelineName ?? EventDispatcher.DEFAULT_PIPELINE); + if (!pipeline) + throw new Error(`Pipeline "${pipelineName ?? EventDispatcher.DEFAULT_PIPELINE}" does not exist`); + + pipeline.addProcessor(preprocessor); } - #pipelineProcessing = false; + /** Create a named pipeline with processors and optional concurrency limit */ + addPipeline(name: string, processors: IDispatchPipelineProcessor[] = [], options?: { concurrentLimit?: number }) { + if (!name) + throw new TypeError('pipeline name required'); + if (this.#pipelines.has(name)) + throw new Error(`pipeline "${name}" already exists`); - /** - * Consume the pipeline, publish events, and resolve/reject each batch - */ - async #startPipelineProcessing() { - if (this.#pipelineProcessing) // should never happen - throw new Error('pipeline processing already started'); - - this.#pipelineProcessing = true; - - for await (const { error, reject, data, resolve } of this.#pipeline) { - if (error) { // some of the preprocessors failed - await this.#revert(data); - reject(error); - continue; - } - - try { - const events: IEvent[] = []; - - for (const batch of data) { - const { event, ...meta } = batch; - if (event) { - await this.eventBus.publish(event, meta); - events.push(event); - } - } - - resolve(events); - } - catch (publishError: any) { - reject(publishError); - } - } - } + const pipeline = new EventDispatchPipeline(this.eventBus, options?.concurrentLimit ?? this.concurrentLimit); + for (const p of processors) + pipeline.addProcessor(p); - /** - * Revert side effects made by pipeline processors in case of a batch processing failure - */ - async #revert(batch: DispatchPipelineBatch) { - for (const processor of this.#processors) - await processor.revert?.(batch); + this.#pipelines.set(name, pipeline); + + return pipeline; } - /** - * Dispatch a set of events through the processing pipeline. - * - * Returns a promise that resolves after all events are processed and published. - */ + /** Dispatch events through a routed pipeline and publish to the shared eventBus */ async dispatch(events: IEventSet, meta?: Record) { if (!isEventSet(events) || events.length === 0) throw new Error('dispatch requires a non-empty array of events'); - // const { promise, resolve, reject } = Promise.withResolvers(); let resolve!: (value: IEventSet | PromiseLike) => void; let reject!: (reason?: any) => void; - const promise = new Promise((res, rej) => { - resolve = res; - reject = rej; - }); + const promise = new Promise((res, rej) => { resolve = res; reject = rej; }); const envelope: EventBatchEnvelope = { - data: events.map(event => ({ - event, - ...meta - })), + data: events.map(event => ({ event, ...meta })), resolve, reject }; - if (!this.#pipelineProcessing) - this.#startPipelineProcessing(); + const desired = this.eventDispatchRouter?.(events, meta) ?? EventDispatcher.DEFAULT_PIPELINE; + const pipeline = this.#pipelines.get(desired) ?? this.#pipelines.get(EventDispatcher.DEFAULT_PIPELINE); + if (!pipeline) + throw new Error(`No "${desired}" pipeline configured`); - this.#pipelineInput.push(envelope); + pipeline.push(envelope); return promise; } diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index 7ed1440..f8a2fb5 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -18,8 +18,13 @@ export interface IContainer extends Container { commandBus: ICommandBus; eventDispatcher: IEventDispatcher; + + /** Default event dispatch pipeline */ eventDispatchPipeline?: IDispatchPipelineProcessor[]; + /** Multiple event dispatch pipelines per origin */ + eventDispatchPipelines?: Record; + logger?: ILogger | IExtendableLogger; process?: NodeJS.Process diff --git a/tests/unit/EventDispatcher.test.ts b/tests/unit/EventDispatcher.test.ts index 686082c..a079000 100644 --- a/tests/unit/EventDispatcher.test.ts +++ b/tests/unit/EventDispatcher.test.ts @@ -97,4 +97,95 @@ describe('EventDispatcher', () => { 'B-end-event-2' ]); }); + + it('routes events to pipelines based on meta.origin', async () => { + + const internalProcessor: IDispatchPipelineProcessor = { process: jest.fn(async b => b) }; + const externalProcessor: IDispatchPipelineProcessor = { process: jest.fn(async b => b) }; + + dispatcher = new EventDispatcher({ + eventBus, + eventDispatchPipelines: { + internal: [internalProcessor], + external: [externalProcessor] + } + }); + + const internalEvent: IEvent = { type: 'int' }; + const externalEvent: IEvent = { type: 'ext' }; + + await dispatcher.dispatch([internalEvent], { origin: 'internal' }); + await dispatcher.dispatch([externalEvent], { origin: 'external' }); + + expect(internalProcessor.process).toHaveBeenCalledTimes(1); + expect(externalProcessor.process).toHaveBeenCalledTimes(1); + expect(eventBus.publish).toHaveBeenCalledWith(internalEvent, { origin: 'internal' }); + expect(eventBus.publish).toHaveBeenCalledWith(externalEvent, { origin: 'external' }); + }); + + it('routes events according to eventDispatchRouter if provided', async () => { + const p1: IDispatchPipelineProcessor = { process: jest.fn(async b => b) }; + const p2: IDispatchPipelineProcessor = { process: jest.fn(async b => b) }; + + dispatcher = new EventDispatcher({ + eventBus, + eventDispatchPipelines: { + p1: [p1], + p2: [p2] + }, + eventDispatchRouter: (_events, meta) => meta?.route + }); + + const e1: IEvent = { type: 'r1' }; + const e2: IEvent = { type: 'r2' }; + + await dispatcher.dispatch([e1], { route: 'p1' } as any); + await dispatcher.dispatch([e2], { route: 'p2' } as any); + + expect(p1.process).toHaveBeenCalledTimes(1); + expect(p2.process).toHaveBeenCalledTimes(1); + expect(eventBus.publish).toHaveBeenCalledWith(e1, { route: 'p1' }); + expect(eventBus.publish).toHaveBeenCalledWith(e2, { route: 'p2' }); + }); + + it('routes events to default pipeline when no router is defined', async () => { + const pDefault: IDispatchPipelineProcessor = { process: jest.fn(async b => b) }; + const pOther: IDispatchPipelineProcessor = { process: jest.fn(async b => b) }; + + dispatcher = new EventDispatcher({ + eventBus, + eventDispatchPipelines: { + [EventDispatcher.DEFAULT_PIPELINE]: [pDefault], + other: [pOther] + } + }); + + const e: IEvent = { type: 'go-default' }; + await dispatcher.dispatch([e]); + + expect(pDefault.process).toHaveBeenCalledTimes(1); + expect(pOther.process).not.toHaveBeenCalled(); + expect(eventBus.publish).toHaveBeenCalledWith(e, {}); + }); + + it('throws when targeted pipeline is missing (router or default)', async () => { + const e: IEvent = { type: 'missing' }; + + // Case 1: router selects a non-existent pipeline + let d = new EventDispatcher({ + eventBus, + eventDispatchPipelines: { + foo: [] + }, + eventDispatchRouter: () => 'missing-pipe' + }); + await expect(d.dispatch([e], {})).rejects.toThrow('No "missing-pipe" pipeline configured'); + + // Case 2: no router/meta, default pipeline not provided + d = new EventDispatcher({ + eventBus, + eventDispatchPipelines: { other: [] } + }); + await expect(d.dispatch([e])).rejects.toThrow('No "default" pipeline configured'); + }); }); From 92b2789a47e99657a819acb77418f0f98eaad1ab Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sat, 30 Aug 2025 00:12:37 +0100 Subject: [PATCH 089/169] 1.0.0-rc.17 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 66de549..46d5f57 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.17](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.16...v1.0.0-rc.17) (2025-08-29) + + + # [1.0.0-rc.16](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.15...v1.0.0-rc.16) (2025-08-29) diff --git a/package-lock.json b/package-lock.json index c06f641..0b58be6 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.16", + "version": "1.0.0-rc.17", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.16", + "version": "1.0.0-rc.17", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index a4dd258..6002c01 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.16", + "version": "1.0.0-rc.17", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 4c3f37409d400b199c16c07fcb0d65019020290c Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 11 Sep 2025 14:37:46 +0100 Subject: [PATCH 090/169] Remove unnecessary handler binding --- src/utils/getHandler.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/utils/getHandler.ts b/src/utils/getHandler.ts index 8df01a1..f2de2be 100644 --- a/src/utils/getHandler.ts +++ b/src/utils/getHandler.ts @@ -10,11 +10,11 @@ export function getHandler(context: { [key: string]: any }, messageType: string) throw new TypeError('messageType argument must be a non-empty string'); if (messageType in context && typeof context[messageType] === 'function') - return context[messageType].bind(context); + return context[messageType]; const privateHandlerName = `_${messageType}`; if (privateHandlerName in context && typeof context[privateHandlerName] === 'function') - return context[privateHandlerName].bind(context); + return context[privateHandlerName]; return null; } From a68490aaed2dfc6bd4dcad0e7179a9146779dc29 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 11 Sep 2025 14:41:37 +0100 Subject: [PATCH 091/169] Refactor dispatch argument validations to keep consistent between EventStore and EventDispatcher --- src/EventDispatcher.ts | 7 +++++-- src/EventStore.ts | 7 ++++--- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index 890fa3b..ab11cbe 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -99,11 +99,14 @@ export class EventDispatcher implements IEventDispatcher { /** Dispatch events through a routed pipeline and publish to the shared eventBus */ async dispatch(events: IEventSet, meta?: Record) { if (!isEventSet(events) || events.length === 0) - throw new Error('dispatch requires a non-empty array of events'); + throw new TypeError('dispatch requires a non-empty array of events'); let resolve!: (value: IEventSet | PromiseLike) => void; let reject!: (reason?: any) => void; - const promise = new Promise((res, rej) => { resolve = res; reject = rej; }); + const promise = new Promise((res, rej) => { + resolve = res; + reject = rej; + }); const envelope: EventBatchEnvelope = { data: events.map(event => ({ event, ...meta })), diff --git a/src/EventStore.ts b/src/EventStore.ts index 9fc91d1..09ba489 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -17,7 +17,8 @@ import { IEventBus, isIEventBus, isIEventStorageReader, - IContainer + IContainer, + isEventSet } from './interfaces'; import { getClassName, @@ -148,8 +149,8 @@ export class EventStore implements IEventStore { * @returns Signed and committed events */ async dispatch(events: IEventSet): Promise { - if (!Array.isArray(events)) - throw new TypeError('events argument must be an Array'); + if (!isEventSet(events) || events.length === 0) + throw new TypeError('dispatch requires a non-empty array of events'); const augmentedEvents = await this.#attachSagaIdToSagaStarterEvents(events); From 25012815335ae18d04e1670d25cf0120b1a8f0b3 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 11 Sep 2025 14:44:20 +0100 Subject: [PATCH 092/169] Change "clean" script to cleanup abandoned files --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 6002c01..3d8b8e3 100644 --- a/package.json +++ b/package.json @@ -54,7 +54,7 @@ "pretest:integration": "npm run build", "test:integration": "jest --verbose examples/user-domain-tests tests/integration", "changelog": "conventional-changelog -n ./scripts/changelog -r 0 > CHANGELOG.md", - "clean": "tsc --build --clean", + "clean": "rm -rf ./dist ./types ./coverage && tsc --build --clean", "build": "tsc --build", "prepare": "npm run build", "preversion": "npm test", From 09718d87427f338dfa7c1147a8e295896f3c1c7b Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 11 Sep 2025 15:00:52 +0100 Subject: [PATCH 093/169] 1.0.0-rc.18 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 46d5f57..9d38ce1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.18](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.17...v1.0.0-rc.18) (2025-09-11) + + + # [1.0.0-rc.17](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.16...v1.0.0-rc.17) (2025-08-29) diff --git a/package-lock.json b/package-lock.json index 0b58be6..a172e25 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.17", + "version": "1.0.0-rc.18", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.17", + "version": "1.0.0-rc.18", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 3d8b8e3..f30fefb 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.17", + "version": "1.0.0-rc.18", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From cb7f22b36c66d8fc16c4ce546906c024531bd6ad Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 24 Sep 2025 20:26:54 +0100 Subject: [PATCH 094/169] Fix handler context binding without masterHandler defined --- src/AbstractProjection.ts | 2 +- src/SagaEventHandler.ts | 2 +- src/utils/subscribe.ts | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 6a6a625..c7652ed 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -115,7 +115,7 @@ export abstract class AbstractProjection implements IProjection { subscribe(eventStore, this, { - masterHandler: (e: IEvent) => this.project(e) + masterHandler: this.project }); await this.restore(eventStore); diff --git a/src/SagaEventHandler.ts b/src/SagaEventHandler.ts index 5fe163d..6e784ff 100644 --- a/src/SagaEventHandler.ts +++ b/src/SagaEventHandler.ts @@ -83,7 +83,7 @@ export class SagaEventHandler implements IEventReceptor { subscribe(eventStore: IObservable) { subscribe(eventStore, this, { messageTypes: [...this.#startsWith, ...this.#handles], - masterHandler: e => this.handle(e), + masterHandler: this.handle, queueName: this.#queueName }); } diff --git a/src/utils/subscribe.ts b/src/utils/subscribe.ts index dcb3965..3f5b157 100644 --- a/src/utils/subscribe.ts +++ b/src/utils/subscribe.ts @@ -56,10 +56,10 @@ export function subscribe( if (!observable.queue) throw new TypeError('Observer does not support named queues'); - observable.queue(queueName).on(messageType, handler); + observable.queue(queueName).on(messageType, (event, meta) => handler.call(observer, event, meta)); } else { - observable.on(messageType, handler); + observable.on(messageType, (event, meta) => handler.call(observer, event, meta)); } } } From 2a1478caf62aacc48de67c6700700e461e5976e3 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 24 Sep 2025 20:27:40 +0100 Subject: [PATCH 095/169] Rearrange scripts to separate rabbitmq integration tests --- package.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/package.json b/package.json index f30fefb..4f58e7c 100644 --- a/package.json +++ b/package.json @@ -48,13 +48,13 @@ "node": ">=18.0.0" }, "scripts": { + "cleanup": "rm -rf ./dist ./types ./coverage && tsc --build --clean", "pretest": "npm run build", - "test": "jest tests/unit", - "test:coverage": "jest --collect-coverage tests/unit", - "pretest:integration": "npm run build", - "test:integration": "jest --verbose examples/user-domain-tests tests/integration", + "test": "jest tests/unit examples/user-domain-tests", + "test:coverage": "npm t -- --collect-coverage", + "test:rabbitmq": "jest --verbose tests/integration/rabbitmq", + "test:sqlite": "jest --verbose tests/integration/sqlite", "changelog": "conventional-changelog -n ./scripts/changelog -r 0 > CHANGELOG.md", - "clean": "rm -rf ./dist ./types ./coverage && tsc --build --clean", "build": "tsc --build", "prepare": "npm run build", "preversion": "npm test", From 9f638c61555ddfff6ab96cf5fb3f9c12c4de8b36 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 24 Sep 2025 20:27:51 +0100 Subject: [PATCH 096/169] 1.0.0-rc.19 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9d38ce1..95ea06c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.19](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.18...v1.0.0-rc.19) (2025-09-24) + + + # [1.0.0-rc.18](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.17...v1.0.0-rc.18) (2025-09-11) diff --git a/package-lock.json b/package-lock.json index a172e25..3b766eb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.18", + "version": "1.0.0-rc.19", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.18", + "version": "1.0.0-rc.19", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 4f58e7c..134ab2a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.18", + "version": "1.0.0-rc.19", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 025765cc31eec5a004142dff5cafd8264af10ea9 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 14 Oct 2025 00:54:52 +0100 Subject: [PATCH 097/169] Change: Enhance type safety in CqrsContainerBuilder with generics --- package-lock.json | 470 +++++++++++++++++------------------ package.json | 16 +- src/CqrsContainerBuilder.ts | 19 +- src/interfaces/IContainer.ts | 2 + 4 files changed, 254 insertions(+), 253 deletions(-) diff --git a/package-lock.json b/package-lock.json index 3b766eb..5546dad 100644 --- a/package-lock.json +++ b/package-lock.json @@ -11,7 +11,7 @@ "dependencies": { "async-iterable-buffer": "^1.1.0", "async-parallel-pipe": "^1.0.2", - "di0": "^1.0.0" + "di0": "^1.2.0" }, "devDependencies": { "@stylistic/eslint-plugin-ts": "^4.4.1", @@ -20,45 +20,31 @@ "@types/chai": "^4.3.20", "@types/jest": "^29.5.14", "@types/md5": "^2.3.5", - "@types/node": "^20.19.10", + "@types/node": "^20.19.21", "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "eslint": "^9.33.0", + "eslint": "^9.37.0", "eslint-plugin-jest": "^28.14.0", - "globals": "^16.3.0", + "globals": "^16.4.0", "jest": "^29.7.0", "sinon": "^19.0.5", - "ts-jest": "^29.4.1", + "ts-jest": "^29.4.5", "ts-node": "^10.9.2", - "typescript": "^5.9.2", - "typescript-eslint": "^8.39.0" + "typescript": "^5.9.3", + "typescript-eslint": "^8.46.1" }, "engines": { "node": ">=18.0.0" }, "peerDependencies": { - "amqplib": "^0.10.8", + "amqplib": "^0.10.9", "better-sqlite3": "^11.10.0", "md5": "^2.3.0" } }, - "node_modules/@ampproject/remapping": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", - "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==", - "dev": true, - "license": "Apache-2.0", - "dependencies": { - "@jridgewell/gen-mapping": "^0.3.5", - "@jridgewell/trace-mapping": "^0.3.24" - }, - "engines": { - "node": ">=6.0.0" - } - }, "node_modules/@babel/code-frame": { "version": "7.27.1", "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", @@ -75,9 +61,9 @@ } }, "node_modules/@babel/compat-data": { - "version": "7.28.0", - "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.0.tgz", - "integrity": "sha512-60X7qkglvrap8mn1lh2ebxXdZYtUcpd7gsmy9kLaBJ4i/WdY8PqTSdxyA8qraikqKQK5C1KRBKXqznrVapyNaw==", + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.4.tgz", + "integrity": "sha512-YsmSKC29MJwf0gF8Rjjrg5LQCmyh+j/nD8/eP7f+BeoQTKYqs9RoWbjGOdy0+1Ekr68RJZMUOPVQaQisnIo4Rw==", "dev": true, "license": "MIT", "engines": { @@ -85,22 +71,22 @@ } }, "node_modules/@babel/core": { - "version": "7.28.0", - "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.0.tgz", - "integrity": "sha512-UlLAnTPrFdNGoFtbSXwcGFQBtQZJCNjaN6hQNP3UPvuNXT1i82N26KL3dZeIpNalWywr9IuQuncaAfUaS1g6sQ==", + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.4.tgz", + "integrity": "sha512-2BCOP7TN8M+gVDj7/ht3hsaO/B/n5oDbiAyyvnRlNOs+u1o+JWNYTQrmpuNp1/Wq2gcFrI01JAW+paEKDMx/CA==", "dev": true, "license": "MIT", "dependencies": { - "@ampproject/remapping": "^2.2.0", "@babel/code-frame": "^7.27.1", - "@babel/generator": "^7.28.0", + "@babel/generator": "^7.28.3", "@babel/helper-compilation-targets": "^7.27.2", - "@babel/helper-module-transforms": "^7.27.3", - "@babel/helpers": "^7.27.6", - "@babel/parser": "^7.28.0", + "@babel/helper-module-transforms": "^7.28.3", + "@babel/helpers": "^7.28.4", + "@babel/parser": "^7.28.4", "@babel/template": "^7.27.2", - "@babel/traverse": "^7.28.0", - "@babel/types": "^7.28.0", + "@babel/traverse": "^7.28.4", + "@babel/types": "^7.28.4", + "@jridgewell/remapping": "^2.3.5", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", @@ -126,14 +112,14 @@ } }, "node_modules/@babel/generator": { - "version": "7.28.0", - "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.0.tgz", - "integrity": "sha512-lJjzvrbEeWrhB4P3QBsH7tey117PjLZnDbLiQEKjQ/fNJTjuq4HSqgFA+UNSwZT8D7dxxbnuSBMsa1lrWzKlQg==", + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz", + "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/parser": "^7.28.0", - "@babel/types": "^7.28.0", + "@babel/parser": "^7.28.3", + "@babel/types": "^7.28.2", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" @@ -211,15 +197,15 @@ } }, "node_modules/@babel/helper-module-transforms": { - "version": "7.27.3", - "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.27.3.tgz", - "integrity": "sha512-dSOvYwvyLsWBeIRyOeHXp5vPj5l1I011r52FM1+r1jCERv+aFXYk4whgQccYEGYxK2H3ZAIA8nuPkQ0HaUo3qg==", + "version": "7.28.3", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz", + "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==", "dev": true, "license": "MIT", "dependencies": { "@babel/helper-module-imports": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1", - "@babel/traverse": "^7.27.3" + "@babel/traverse": "^7.28.3" }, "engines": { "node": ">=6.9.0" @@ -269,27 +255,27 @@ } }, "node_modules/@babel/helpers": { - "version": "7.28.2", - "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.2.tgz", - "integrity": "sha512-/V9771t+EgXz62aCcyofnQhGM8DQACbRhvzKFsXKC9QM+5MadF8ZmIm0crDMaz3+o0h0zXfJnd4EhbYbxsrcFw==", + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz", + "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==", "dev": true, "license": "MIT", "dependencies": { "@babel/template": "^7.27.2", - "@babel/types": "^7.28.2" + "@babel/types": "^7.28.4" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/parser": { - "version": "7.28.0", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.0.tgz", - "integrity": "sha512-jVZGvOxOuNSsuQuLRTh13nU0AogFlw32w/MT+LV6D3sP5WdbW61E77RnkbaO2dUvmPAYrBDJXGn5gGS6tH4j8g==", + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.4.tgz", + "integrity": "sha512-yZbBqeM6TkpP9du/I2pUZnJsRMGGvOuIrhjzC1AwHwW+6he4mni6Bp/m8ijn0iOuZuPI2BfkCoSRunpyjnrQKg==", "dev": true, "license": "MIT", "dependencies": { - "@babel/types": "^7.28.0" + "@babel/types": "^7.28.4" }, "bin": { "parser": "bin/babel-parser.js" @@ -553,18 +539,18 @@ } }, "node_modules/@babel/traverse": { - "version": "7.28.0", - "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.0.tgz", - "integrity": "sha512-mGe7UK5wWyh0bKRfupsUchrQGqvDbZDbKJw+kcRGSmdHVYrv+ltd0pnpDTVpiTqnaBru9iEvA8pz8W46v0Amwg==", + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.4.tgz", + "integrity": "sha512-YEzuboP2qvQavAcjgQNVgsvHIDv6ZpwXvcvjmyySP2DIMuByS/6ioU5G9pYrWHM6T2YDfc7xga9iNzYOs12CFQ==", "dev": true, "license": "MIT", "dependencies": { "@babel/code-frame": "^7.27.1", - "@babel/generator": "^7.28.0", + "@babel/generator": "^7.28.3", "@babel/helper-globals": "^7.28.0", - "@babel/parser": "^7.28.0", + "@babel/parser": "^7.28.4", "@babel/template": "^7.27.2", - "@babel/types": "^7.28.0", + "@babel/types": "^7.28.4", "debug": "^4.3.1" }, "engines": { @@ -572,9 +558,9 @@ } }, "node_modules/@babel/types": { - "version": "7.28.2", - "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.2.tgz", - "integrity": "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ==", + "version": "7.28.4", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.4.tgz", + "integrity": "sha512-bkFqkLhh3pMBUQQkpVgWDWq/lqzc2678eUyDlTBhRqhCHFguYYGM0Efga7tYk4TogG/3x0EEl66/OQ+WGbWB/Q==", "dev": true, "license": "MIT", "dependencies": { @@ -617,9 +603,9 @@ } }, "node_modules/@eslint-community/eslint-utils": { - "version": "4.7.0", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.7.0.tgz", - "integrity": "sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw==", + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", "dev": true, "license": "MIT", "dependencies": { @@ -698,19 +684,22 @@ } }, "node_modules/@eslint/config-helpers": { - "version": "0.3.1", - "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.3.1.tgz", - "integrity": "sha512-xR93k9WhrDYpXHORXpxVL5oHj3Era7wo6k/Wd8/IsQNnZUTzkGS29lyn3nAT05v6ltUuTFVCCYDEGfy2Or/sPA==", + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.0.tgz", + "integrity": "sha512-WUFvV4WoIwW8Bv0KeKCIIEgdSiFOsulyN0xrMu+7z43q/hkOLXjvb5u7UC9jDxvRzcrbEmuZBX5yJZz1741jog==", "dev": true, "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.16.0" + }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, "node_modules/@eslint/core": { - "version": "0.15.2", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.15.2.tgz", - "integrity": "sha512-78Md3/Rrxh83gCxoUc0EiciuOHsIITzLy53m3d9UyiW8y9Dj2D29FeETqyKA+BRK76tnTp6RXWb3pCay8Oyomg==", + "version": "0.16.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.16.0.tgz", + "integrity": "sha512-nmC8/totwobIiFcGkDza3GIKfAw1+hLiYVrh3I1nIomQ8PEr5cxg34jnkmGawul/ep52wGRAcyeDCNtWKSOj4Q==", "dev": true, "license": "Apache-2.0", "dependencies": { @@ -792,9 +781,9 @@ } }, "node_modules/@eslint/js": { - "version": "9.33.0", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.33.0.tgz", - "integrity": "sha512-5K1/mKhWaMfreBGJTwval43JJmkip0RmM+3+IuqupeSKNC/Th2Kc7ucaq5ovTSra/OOKB9c58CGSz3QMVbWt0A==", + "version": "9.37.0", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.37.0.tgz", + "integrity": "sha512-jaS+NJ+hximswBG6pjNX0uEJZkrT0zwpVi3BA3vX22aFGjJjmgSTSmPpZCRKmoBL5VY/M6p0xsSJx7rk7sy5gg==", "dev": true, "license": "MIT", "engines": { @@ -815,13 +804,13 @@ } }, "node_modules/@eslint/plugin-kit": { - "version": "0.3.5", - "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.3.5.tgz", - "integrity": "sha512-Z5kJ+wU3oA7MMIqVR9tyZRtjYPr4OC004Q4Rw7pgOKUOKkJfZ3O24nz3WYfGRpMDNmcOi3TwQOmgm7B7Tpii0w==", + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.0.tgz", + "integrity": "sha512-sB5uyeq+dwCWyPi31B2gQlVlo+j5brPlWx4yZBrEaRo/nhdDE8Xke1gsGgtiBdaBTxuTkceLVuVt/pclrasb0A==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/core": "^0.15.2", + "@eslint/core": "^0.16.0", "levn": "^0.4.1" }, "engines": { @@ -839,33 +828,19 @@ } }, "node_modules/@humanfs/node": { - "version": "0.16.6", - "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.6.tgz", - "integrity": "sha512-YuI2ZHQL78Q5HbhDiBA1X4LmYdXCKCMQIfw0pw7piHJwyREFebJUvrQN4cMssyES6x+vfUbx1CIpaQUKYdQZOw==", + "version": "0.16.7", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", + "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", "dev": true, "license": "Apache-2.0", "dependencies": { "@humanfs/core": "^0.19.1", - "@humanwhocodes/retry": "^0.3.0" + "@humanwhocodes/retry": "^0.4.0" }, "engines": { "node": ">=18.18.0" } }, - "node_modules/@humanfs/node/node_modules/@humanwhocodes/retry": { - "version": "0.3.1", - "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.3.1.tgz", - "integrity": "sha512-JBxkERygn7Bv/GbN5Rv8Ul6LVknS+5Bp6RgDC/O8gEBU/yeH5Ui5C/OlWrTb6qct7LjjfT6Re2NxB0ln0yYybA==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": ">=18.18" - }, - "funding": { - "type": "github", - "url": "https://github.com/sponsors/nzakas" - } - }, "node_modules/@humanwhocodes/module-importer": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", @@ -1314,9 +1289,9 @@ } }, "node_modules/@jridgewell/gen-mapping": { - "version": "0.3.12", - "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.12.tgz", - "integrity": "sha512-OuLGC46TjB5BbN1dH8JULVVZY4WTdkF7tV9Ys6wLL1rubZnCMstOhNHueU5bLCrnRuDhKPDM4g6sw4Bel5Gzqg==", + "version": "0.3.13", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", + "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==", "dev": true, "license": "MIT", "dependencies": { @@ -1324,6 +1299,17 @@ "@jridgewell/trace-mapping": "^0.3.24" } }, + "node_modules/@jridgewell/remapping": { + "version": "2.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz", + "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + } + }, "node_modules/@jridgewell/resolve-uri": { "version": "3.1.2", "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", @@ -1335,16 +1321,16 @@ } }, "node_modules/@jridgewell/sourcemap-codec": { - "version": "1.5.4", - "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.4.tgz", - "integrity": "sha512-VT2+G1VQs/9oz078bLrYbecdZKs912zQlkelYpuf+SXF+QvZDYJlbx/LSx+meSAwdDFnF8FVXW92AVjjkVmgFw==", + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", "dev": true, "license": "MIT" }, "node_modules/@jridgewell/trace-mapping": { - "version": "0.3.29", - "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.29.tgz", - "integrity": "sha512-uw6guiW/gcAGPDhLmd77/6lW8QLeiV5RUTsAX46Db6oLhGaVj4lhnPwb184s1bkc8kdVg/+h988dro8GRDpmYQ==", + "version": "0.3.31", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz", + "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==", "dev": true, "license": "MIT", "dependencies": { @@ -1640,9 +1626,9 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "20.19.10", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.10.tgz", - "integrity": "sha512-iAFpG6DokED3roLSP0K+ybeDdIX6Bc0Vd3mLW5uDqThPWtNos3E+EqOM11mPQHKzfWHqEBuLjIlsBQQ8CsISmQ==", + "version": "20.19.21", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.21.tgz", + "integrity": "sha512-CsGG2P3I5y48RPMfprQGfy4JPRZ6csfC3ltBZSRItG3ngggmNY/qs2uZKp4p9VbrpqNNSMzUZNFZKzgOGnd/VA==", "dev": true, "license": "MIT", "dependencies": { @@ -1698,17 +1684,17 @@ "license": "MIT" }, "node_modules/@typescript-eslint/eslint-plugin": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.39.0.tgz", - "integrity": "sha512-bhEz6OZeUR+O/6yx9Jk6ohX6H9JSFTaiY0v9/PuKT3oGK0rn0jNplLmyFUGV+a9gfYnVNwGDwS/UkLIuXNb2Rw==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.1.tgz", + "integrity": "sha512-rUsLh8PXmBjdiPY+Emjz9NX2yHvhS11v0SR6xNJkm5GM1MO9ea/1GoDKlHHZGrOJclL/cZ2i/vRUYVtjRhrHVQ==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/regexpp": "^4.10.0", - "@typescript-eslint/scope-manager": "8.39.0", - "@typescript-eslint/type-utils": "8.39.0", - "@typescript-eslint/utils": "8.39.0", - "@typescript-eslint/visitor-keys": "8.39.0", + "@typescript-eslint/scope-manager": "8.46.1", + "@typescript-eslint/type-utils": "8.46.1", + "@typescript-eslint/utils": "8.46.1", + "@typescript-eslint/visitor-keys": "8.46.1", "graphemer": "^1.4.0", "ignore": "^7.0.0", "natural-compare": "^1.4.0", @@ -1722,22 +1708,22 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "@typescript-eslint/parser": "^8.39.0", + "@typescript-eslint/parser": "^8.46.1", "eslint": "^8.57.0 || ^9.0.0", "typescript": ">=4.8.4 <6.0.0" } }, "node_modules/@typescript-eslint/parser": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.39.0.tgz", - "integrity": "sha512-g3WpVQHngx0aLXn6kfIYCZxM6rRJlWzEkVpqEFLT3SgEDsp9cpCbxxgwnE504q4H+ruSDh/VGS6nqZIDynP+vg==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.1.tgz", + "integrity": "sha512-6JSSaBZmsKvEkbRUkf7Zj7dru/8ZCrJxAqArcLaVMee5907JdtEbKGsZ7zNiIm/UAkpGUkaSMZEXShnN2D1HZA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/scope-manager": "8.39.0", - "@typescript-eslint/types": "8.39.0", - "@typescript-eslint/typescript-estree": "8.39.0", - "@typescript-eslint/visitor-keys": "8.39.0", + "@typescript-eslint/scope-manager": "8.46.1", + "@typescript-eslint/types": "8.46.1", + "@typescript-eslint/typescript-estree": "8.46.1", + "@typescript-eslint/visitor-keys": "8.46.1", "debug": "^4.3.4" }, "engines": { @@ -1753,14 +1739,14 @@ } }, "node_modules/@typescript-eslint/project-service": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.39.0.tgz", - "integrity": "sha512-CTzJqaSq30V/Z2Og9jogzZt8lJRR5TKlAdXmWgdu4hgcC9Kww5flQ+xFvMxIBWVNdxJO7OifgdOK4PokMIWPew==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.1.tgz", + "integrity": "sha512-FOIaFVMHzRskXr5J4Jp8lFVV0gz5ngv3RHmn+E4HYxSJ3DgDzU7fVI1/M7Ijh1zf6S7HIoaIOtln1H5y8V+9Zg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/tsconfig-utils": "^8.39.0", - "@typescript-eslint/types": "^8.39.0", + "@typescript-eslint/tsconfig-utils": "^8.46.1", + "@typescript-eslint/types": "^8.46.1", "debug": "^4.3.4" }, "engines": { @@ -1775,14 +1761,14 @@ } }, "node_modules/@typescript-eslint/scope-manager": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.39.0.tgz", - "integrity": "sha512-8QOzff9UKxOh6npZQ/4FQu4mjdOCGSdO3p44ww0hk8Vu+IGbg0tB/H1LcTARRDzGCC8pDGbh2rissBuuoPgH8A==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.1.tgz", + "integrity": "sha512-weL9Gg3/5F0pVQKiF8eOXFZp8emqWzZsOJuWRUNtHT+UNV2xSJegmpCNQHy37aEQIbToTq7RHKhWvOsmbM680A==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.39.0", - "@typescript-eslint/visitor-keys": "8.39.0" + "@typescript-eslint/types": "8.46.1", + "@typescript-eslint/visitor-keys": "8.46.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1793,9 +1779,9 @@ } }, "node_modules/@typescript-eslint/tsconfig-utils": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.39.0.tgz", - "integrity": "sha512-Fd3/QjmFV2sKmvv3Mrj8r6N8CryYiCS8Wdb/6/rgOXAWGcFuc+VkQuG28uk/4kVNVZBQuuDHEDUpo/pQ32zsIQ==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.1.tgz", + "integrity": "sha512-X88+J/CwFvlJB+mK09VFqx5FE4H5cXD+H/Bdza2aEWkSb8hnWIQorNcscRl4IEo1Cz9VI/+/r/jnGWkbWPx54g==", "dev": true, "license": "MIT", "engines": { @@ -1810,15 +1796,15 @@ } }, "node_modules/@typescript-eslint/type-utils": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.39.0.tgz", - "integrity": "sha512-6B3z0c1DXVT2vYA9+z9axjtc09rqKUPRmijD5m9iv8iQpHBRYRMBcgxSiKTZKm6FwWw1/cI4v6em35OsKCiN5Q==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.1.tgz", + "integrity": "sha512-+BlmiHIiqufBxkVnOtFwjah/vrkF4MtKKvpXrKSPLCkCtAp8H01/VV43sfqA98Od7nJpDcFnkwgyfQbOG0AMvw==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.39.0", - "@typescript-eslint/typescript-estree": "8.39.0", - "@typescript-eslint/utils": "8.39.0", + "@typescript-eslint/types": "8.46.1", + "@typescript-eslint/typescript-estree": "8.46.1", + "@typescript-eslint/utils": "8.46.1", "debug": "^4.3.4", "ts-api-utils": "^2.1.0" }, @@ -1835,9 +1821,9 @@ } }, "node_modules/@typescript-eslint/types": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.39.0.tgz", - "integrity": "sha512-ArDdaOllnCj3yn/lzKn9s0pBQYmmyme/v1HbGIGB0GB/knFI3fWMHloC+oYTJW46tVbYnGKTMDK4ah1sC2v0Kg==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.1.tgz", + "integrity": "sha512-C+soprGBHwWBdkDpbaRC4paGBrkIXxVlNohadL5o0kfhsXqOC6GYH2S/Obmig+I0HTDl8wMaRySwrfrXVP8/pQ==", "dev": true, "license": "MIT", "engines": { @@ -1849,16 +1835,16 @@ } }, "node_modules/@typescript-eslint/typescript-estree": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.39.0.tgz", - "integrity": "sha512-ndWdiflRMvfIgQRpckQQLiB5qAKQ7w++V4LlCHwp62eym1HLB/kw7D9f2e8ytONls/jt89TEasgvb+VwnRprsw==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.1.tgz", + "integrity": "sha512-uIifjT4s8cQKFQ8ZBXXyoUODtRoAd7F7+G8MKmtzj17+1UbdzFl52AzRyZRyKqPHhgzvXunnSckVu36flGy8cg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/project-service": "8.39.0", - "@typescript-eslint/tsconfig-utils": "8.39.0", - "@typescript-eslint/types": "8.39.0", - "@typescript-eslint/visitor-keys": "8.39.0", + "@typescript-eslint/project-service": "8.46.1", + "@typescript-eslint/tsconfig-utils": "8.46.1", + "@typescript-eslint/types": "8.46.1", + "@typescript-eslint/visitor-keys": "8.46.1", "debug": "^4.3.4", "fast-glob": "^3.3.2", "is-glob": "^4.0.3", @@ -1878,16 +1864,16 @@ } }, "node_modules/@typescript-eslint/utils": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.39.0.tgz", - "integrity": "sha512-4GVSvNA0Vx1Ktwvf4sFE+exxJ3QGUorQG1/A5mRfRNZtkBT2xrA/BCO2H0eALx/PnvCS6/vmYwRdDA41EoffkQ==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.1.tgz", + "integrity": "sha512-vkYUy6LdZS7q1v/Gxb2Zs7zziuXN0wxqsetJdeZdRe/f5dwJFglmuvZBfTUivCtjH725C1jWCDfpadadD95EDQ==", "dev": true, "license": "MIT", "dependencies": { "@eslint-community/eslint-utils": "^4.7.0", - "@typescript-eslint/scope-manager": "8.39.0", - "@typescript-eslint/types": "8.39.0", - "@typescript-eslint/typescript-estree": "8.39.0" + "@typescript-eslint/scope-manager": "8.46.1", + "@typescript-eslint/types": "8.46.1", + "@typescript-eslint/typescript-estree": "8.46.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1902,13 +1888,13 @@ } }, "node_modules/@typescript-eslint/visitor-keys": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.39.0.tgz", - "integrity": "sha512-ldgiJ+VAhQCfIjeOgu8Kj5nSxds0ktPOSO9p4+0VDH2R2pLvQraaM5Oen2d7NxzMCm+Sn/vJT+mv2H5u6b/3fA==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.1.tgz", + "integrity": "sha512-ptkmIf2iDkNUjdeu2bQqhFPV1m6qTnFFjg7PPDjxKWaMaP0Z6I9l30Jr3g5QqbZGdw8YdYvLp+XnqnWWZOg/NA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.39.0", + "@typescript-eslint/types": "8.46.1", "eslint-visitor-keys": "^4.2.1" }, "engines": { @@ -1980,9 +1966,9 @@ } }, "node_modules/amqplib": { - "version": "0.10.8", - "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.8.tgz", - "integrity": "sha512-Tfn1O9sFgAP8DqeMEpt2IacsVTENBpblB3SqLdn0jK2AeX8iyCvbptBc8lyATT9bQ31MsjVwUSQ1g8f4jHOUfw==", + "version": "0.10.9", + "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.9.tgz", + "integrity": "sha512-jwSftI4QjS3mizvnSnOrPGYiUnm1vI2OP1iXeOUz5pb74Ua0nbf6nPyyTzuiCLEE3fMpaJORXh2K/TQ08H5xGA==", "license": "MIT", "peer": true, "dependencies": { @@ -2256,6 +2242,16 @@ "license": "MIT", "peer": true }, + "node_modules/baseline-browser-mapping": { + "version": "2.8.16", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.16.tgz", + "integrity": "sha512-OMu3BGQ4E7P1ErFsIPpbJh0qvDudM/UuJeHgkAvfWe+0HFJCXh+t/l8L6fVLR55RI/UbKrVLnAXZSVwd9ysWYw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "baseline-browser-mapping": "dist/cli.js" + } + }, "node_modules/better-sqlite3": { "version": "11.10.0", "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.10.0.tgz", @@ -2314,9 +2310,9 @@ } }, "node_modules/browserslist": { - "version": "4.25.2", - "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.25.2.tgz", - "integrity": "sha512-0si2SJK3ooGzIawRu61ZdPCO1IncZwS8IzuX73sPZsXW6EQ/w/DAfPyKI8l1ETTCr2MnvqWitmlCUxgdul45jA==", + "version": "4.26.3", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.26.3.tgz", + "integrity": "sha512-lAUU+02RFBuCKQPj/P6NgjlbCnLBMp4UtgTx7vNHd3XSIJF87s9a5rA3aH2yw3GS9DqZAUbOtZdCCiZeVRqt0w==", "dev": true, "funding": [ { @@ -2334,9 +2330,10 @@ ], "license": "MIT", "dependencies": { - "caniuse-lite": "^1.0.30001733", - "electron-to-chromium": "^1.5.199", - "node-releases": "^2.0.19", + "baseline-browser-mapping": "^2.8.9", + "caniuse-lite": "^1.0.30001746", + "electron-to-chromium": "^1.5.227", + "node-releases": "^2.0.21", "update-browserslist-db": "^1.1.3" }, "bin": { @@ -2447,9 +2444,9 @@ } }, "node_modules/caniuse-lite": { - "version": "1.0.30001734", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001734.tgz", - "integrity": "sha512-uhE1Ye5vgqju6OI71HTQqcBCZrvHugk0MjLak7Q+HfoBgoq5Bi+5YnwjP4fjDgrtYr/l8MVRBvzz9dPD4KyK0A==", + "version": "1.0.30001750", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001750.tgz", + "integrity": "sha512-cuom0g5sdX6rw00qOoLNSFCJ9/mYIsuSOA+yzpDw8eopiFqcVwQvZHqov0vmEighRxX++cfC0Vg1G+1Iy/mSpQ==", "dev": true, "funding": [ { @@ -2972,9 +2969,9 @@ } }, "node_modules/debug": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.1.tgz", - "integrity": "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ==", + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", "dev": true, "license": "MIT", "dependencies": { @@ -3043,9 +3040,9 @@ } }, "node_modules/dedent": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.6.0.tgz", - "integrity": "sha512-F1Z+5UCFpmQUzJa11agbyPVMbpgT/qA3/SKyJ1jyBgm7dUcUEa8v9JwDkerSQXfakBwFljIxhOJqGkjUwZ9FSA==", + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.0.tgz", + "integrity": "sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==", "dev": true, "license": "MIT", "peerDependencies": { @@ -3098,9 +3095,9 @@ } }, "node_modules/detect-libc": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.4.tgz", - "integrity": "sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==", + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", "license": "Apache-2.0", "peer": true, "engines": { @@ -3118,9 +3115,9 @@ } }, "node_modules/di0": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/di0/-/di0-1.0.0.tgz", - "integrity": "sha512-RRZsfbOmxiB0ZI+4ABfw/O7GUOnqmgFJGEPFzj7IX+mpm73Hkd38akjaTagaFmwzzRAqIIVR3uB3zSzwnt8ZFw==", + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/di0/-/di0-1.2.0.tgz", + "integrity": "sha512-9IeKa1bEuwqwZMcAHuCI+YHFS5dHfcmb7/CB8A7GzH6EKIrpz/Du7y5GYrUoC6jEGG4eo9cdVi6gUiY0khWJLQ==", "license": "MIT" }, "node_modules/diff": { @@ -3157,9 +3154,9 @@ } }, "node_modules/electron-to-chromium": { - "version": "1.5.199", - "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.199.tgz", - "integrity": "sha512-3gl0S7zQd88kCAZRO/DnxtBKuhMO4h0EaQIN3YgZfV6+pW+5+bf2AdQeHNESCoaQqo/gjGVYEf2YM4O5HJQqpQ==", + "version": "1.5.235", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.235.tgz", + "integrity": "sha512-i/7ntLFwOdoHY7sgjlTIDo4Sl8EdoTjWIaKinYOVfC6bOp71bmwenyZthWHcasxgHDNWbWxvG9M3Ia116zIaYQ==", "dev": true, "license": "ISC" }, @@ -3194,9 +3191,9 @@ } }, "node_modules/error-ex": { - "version": "1.3.2", - "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz", - "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==", + "version": "1.3.4", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.4.tgz", + "integrity": "sha512-sqQamAnR14VgCr1A618A3sGrygcpK+HEbenA/HiEAkkUwcZIIB/tgWqHFxWgOyDh4nB4JCRimh79dR5Ywc9MDQ==", "dev": true, "license": "MIT", "dependencies": { @@ -3227,20 +3224,20 @@ } }, "node_modules/eslint": { - "version": "9.33.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.33.0.tgz", - "integrity": "sha512-TS9bTNIryDzStCpJN93aC5VRSW3uTx9sClUn4B87pwiCaJh220otoI0X8mJKr+VcPtniMdN8GKjlwgWGUv5ZKA==", + "version": "9.37.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.37.0.tgz", + "integrity": "sha512-XyLmROnACWqSxiGYArdef1fItQd47weqB7iwtfr9JHwRrqIXZdcFMvvEcL9xHCmL0SNsOvF0c42lWyM1U5dgig==", "dev": true, "license": "MIT", "dependencies": { - "@eslint-community/eslint-utils": "^4.2.0", + "@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/regexpp": "^4.12.1", "@eslint/config-array": "^0.21.0", - "@eslint/config-helpers": "^0.3.1", - "@eslint/core": "^0.15.2", + "@eslint/config-helpers": "^0.4.0", + "@eslint/core": "^0.16.0", "@eslint/eslintrc": "^3.3.1", - "@eslint/js": "9.33.0", - "@eslint/plugin-kit": "^0.3.5", + "@eslint/js": "9.37.0", + "@eslint/plugin-kit": "^0.4.0", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", @@ -3950,9 +3947,9 @@ } }, "node_modules/globals": { - "version": "16.3.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-16.3.0.tgz", - "integrity": "sha512-bqWEnJ1Nt3neqx2q5SFfGS8r/ahumIakg3HcwtNlrVlwXIeNumWn/c7Pn/wKzGhf6SaW6H6uWXLqC30STCMchQ==", + "version": "16.4.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.4.0.tgz", + "integrity": "sha512-ob/2LcVVaVGCYN+r14cnwnoDPUufjiYgSqRhiFD0Q1iI4Odora5RE8Iv1D24hAz5oMophRGkGz+yuvQmmUMnMw==", "dev": true, "license": "MIT", "engines": { @@ -4374,9 +4371,9 @@ } }, "node_modules/istanbul-reports": { - "version": "3.1.7", - "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.1.7.tgz", - "integrity": "sha512-BewmUXImeuRk2YY0PVbxgKAysvhRPUQE0h5QRM++nVWyubKGV0l8qQ5op8+B2DOmwSe63Jivj0BjkPQVf8fP5g==", + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.2.0.tgz", + "integrity": "sha512-HGYWWS/ehqTV3xN10i23tkPkpH46MLCIMFNCaaKNavAXTF1RkqxawEPtnjnGZ6XKSInBKkiOA5BKS+aZiY3AvA==", "dev": true, "license": "BSD-3-Clause", "dependencies": { @@ -5725,9 +5722,9 @@ } }, "node_modules/node-abi": { - "version": "3.75.0", - "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.75.0.tgz", - "integrity": "sha512-OhYaY5sDsIka7H7AtijtI9jwGYLyl29eQn/W623DiN/MIv5sUqc4g7BIDThX+gb7di9f6xK02nkp8sdfFWZLTg==", + "version": "3.78.0", + "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.78.0.tgz", + "integrity": "sha512-E2wEyrgX/CqvicaQYU3Ze1PFGjc4QYPGsjUrlYkqAE0WjHEZwgOsGMPMzkMse4LjJbDmaEuDX3CM036j5K2DSQ==", "license": "MIT", "peer": true, "dependencies": { @@ -5745,9 +5742,9 @@ "license": "MIT" }, "node_modules/node-releases": { - "version": "2.0.19", - "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz", - "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==", + "version": "2.0.23", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.23.tgz", + "integrity": "sha512-cCmFDMSm26S6tQSDpBCg/NR8NENrVPhAJSf+XbxBG4rPFaaonlEoE9wHQmun+cls499TQGSb7ZyPBRlzgKfpeg==", "dev": true, "license": "MIT" }, @@ -5945,13 +5942,14 @@ "license": "MIT" }, "node_modules/path-to-regexp": { - "version": "8.2.0", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.2.0.tgz", - "integrity": "sha512-TdrF7fW9Rphjq4RjrW0Kp2AW0Ahwu9sRGTkS6bvDi0SCwZlEZYmcfDbEsTz8RVk0EHIS/Vd1bv3JhG+1xZuAyQ==", + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz", + "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==", "dev": true, "license": "MIT", - "engines": { - "node": ">=16" + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" } }, "node_modules/path-type": { @@ -6600,9 +6598,9 @@ "license": "MIT" }, "node_modules/semver": { - "version": "7.7.2", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.2.tgz", - "integrity": "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA==", + "version": "7.7.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz", + "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==", "license": "ISC", "bin": { "semver": "bin/semver.js" @@ -6968,9 +6966,9 @@ } }, "node_modules/tar-fs": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.3.tgz", - "integrity": "sha512-090nwYJDmlhwFwEW3QQl+vaNnxsO2yVsd45eTKRBzSzu+hlb1w2K9inVq5b0ngXuLVqQ4ApvsUHHnu/zQNkWAg==", + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.4.tgz", + "integrity": "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==", "license": "MIT", "peer": true, "dependencies": { @@ -7107,9 +7105,9 @@ } }, "node_modules/ts-jest": { - "version": "29.4.1", - "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.1.tgz", - "integrity": "sha512-SaeUtjfpg9Uqu8IbeDKtdaS0g8lS6FT6OzM3ezrDfErPJPHNDo/Ey+VFGP1bQIDfagYDLyRpd7O15XpG1Es2Uw==", + "version": "29.4.5", + "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.5.tgz", + "integrity": "sha512-HO3GyiWn2qvTQA4kTgjDcXiMwYQt68a1Y8+JuLRVpdIzm+UOLSHgl/XqR4c6nzJkq5rOkjc02O2I7P7l/Yof0Q==", "dev": true, "license": "MIT", "dependencies": { @@ -7119,7 +7117,7 @@ "json5": "^2.2.3", "lodash.memoize": "^4.1.2", "make-error": "^1.3.6", - "semver": "^7.7.2", + "semver": "^7.7.3", "type-fest": "^4.41.0", "yargs-parser": "^21.1.1" }, @@ -7286,9 +7284,9 @@ } }, "node_modules/typescript": { - "version": "5.9.2", - "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.2.tgz", - "integrity": "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==", + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", "dev": true, "license": "Apache-2.0", "bin": { @@ -7300,16 +7298,16 @@ } }, "node_modules/typescript-eslint": { - "version": "8.39.0", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.39.0.tgz", - "integrity": "sha512-lH8FvtdtzcHJCkMOKnN73LIn6SLTpoojgJqDAxPm1jCR14eWSGPX8ul/gggBdPMk/d5+u9V854vTYQ8T5jF/1Q==", + "version": "8.46.1", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.46.1.tgz", + "integrity": "sha512-VHgijW803JafdSsDO8I761r3SHrgk4T00IdyQ+/UsthtgPRsBWQLqoSxOolxTpxRKi1kGXK0bSz4CoAc9ObqJA==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/eslint-plugin": "8.39.0", - "@typescript-eslint/parser": "8.39.0", - "@typescript-eslint/typescript-estree": "8.39.0", - "@typescript-eslint/utils": "8.39.0" + "@typescript-eslint/eslint-plugin": "8.46.1", + "@typescript-eslint/parser": "8.46.1", + "@typescript-eslint/typescript-estree": "8.46.1", + "@typescript-eslint/utils": "8.46.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" diff --git a/package.json b/package.json index 134ab2a..ecd1e92 100644 --- a/package.json +++ b/package.json @@ -67,7 +67,7 @@ "dependencies": { "async-iterable-buffer": "^1.1.0", "async-parallel-pipe": "^1.0.2", - "di0": "^1.0.0" + "di0": "^1.2.0" }, "devDependencies": { "@stylistic/eslint-plugin-ts": "^4.4.1", @@ -76,24 +76,24 @@ "@types/chai": "^4.3.20", "@types/jest": "^29.5.14", "@types/md5": "^2.3.5", - "@types/node": "^20.19.10", + "@types/node": "^20.19.21", "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "eslint": "^9.33.0", + "eslint": "^9.37.0", "eslint-plugin-jest": "^28.14.0", - "globals": "^16.3.0", + "globals": "^16.4.0", "jest": "^29.7.0", "sinon": "^19.0.5", - "ts-jest": "^29.4.1", + "ts-jest": "^29.4.5", "ts-node": "^10.9.2", - "typescript": "^5.9.2", - "typescript-eslint": "^8.39.0" + "typescript": "^5.9.3", + "typescript-eslint": "^8.46.1" }, "peerDependencies": { - "amqplib": "^0.10.8", + "amqplib": "^0.10.9", "better-sqlite3": "^11.10.0", "md5": "^2.3.0" } diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 072ef23..8d7f0c7 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -17,7 +17,8 @@ import { isDispatchPipelineProcessor } from './interfaces'; -export class CqrsContainerBuilder extends ContainerBuilder { +export class CqrsContainerBuilder + extends ContainerBuilder { constructor(options?: { types: Readonly[]>, @@ -38,9 +39,9 @@ export class CqrsContainerBuilder extends ContainerBuilder { } /** Register command handler, which will be subscribed to commandBus upon instance creation */ - registerCommandHandler(typeOrFactory: TClassOrFactory) { + registerCommandHandler(typeOrFactory: TClassOrFactory) { return super.register( - (container: IContainer) => { + (container: TContainerInterface) => { const handler = container.createInstance(typeOrFactory); handler.subscribe(container.commandBus); return handler; @@ -49,9 +50,9 @@ export class CqrsContainerBuilder extends ContainerBuilder { } /** Register event receptor, which will be subscribed to eventStore upon instance creation */ - registerEventReceptor(typeOrFactory: TClassOrFactory) { + registerEventReceptor(typeOrFactory: TClassOrFactory) { return super.register( - (container: IContainer) => { + (container: TContainerInterface) => { const receptor = container.createInstance(typeOrFactory); receptor.subscribe(container.eventStore); return receptor; @@ -63,11 +64,11 @@ export class CqrsContainerBuilder extends ContainerBuilder { * Register projection, which will expose view and will be subscribed * to eventStore and will restore its state upon instance creation */ - registerProjection(ProjectionType: IProjectionConstructor, exposedViewAlias?: string) { + registerProjection(ProjectionType: IProjectionConstructor, exposedViewAlias?: keyof TContainerInterface) { if (!isClass(ProjectionType)) throw new TypeError('ProjectionType argument must be a constructor function'); - const projectionFactory = (container: IContainer): IProjection => { + const projectionFactory = (container: TContainerInterface): IProjection => { const projection = container.createInstance(ProjectionType); projection.subscribe(container.eventStore); @@ -90,7 +91,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { if (!isClass(AggregateType)) throw new TypeError('AggregateType argument must be a constructor function'); - const commandHandlerFactory = (container: IContainer): ICommandHandler => + const commandHandlerFactory = (container: TContainerInterface): ICommandHandler => container.createInstance(AggregateCommandHandler, { aggregateFactory: (options: any) => container.createInstance(AggregateType, options), @@ -106,7 +107,7 @@ export class CqrsContainerBuilder extends ContainerBuilder { if (!isClass(SagaType)) throw new TypeError('SagaType argument must be a constructor function'); - const eventReceptorFactory = (container: IContainer): IEventReceptor => + const eventReceptorFactory = (container: TContainerInterface): IEventReceptor => container.createInstance(SagaEventHandler, { sagaFactory: (options: any) => container.createInstance(SagaType, options), handles: SagaType.handles, diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index f8a2fb5..1d6bebb 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -8,11 +8,13 @@ import { IEventStorageReader } from './IEventStorageReader'; import { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage'; import { IIdentifierProvider } from './IIdentifierProvider'; import { IExtendableLogger, ILogger } from './ILogger'; +import { IEventStorageWriter } from './IEventStorageWriter'; export interface IContainer extends Container { eventBus: IEventBus; eventStore: IEventStore eventStorageReader: IEventStorageReader; + eventStorageWriter?: IEventStorageWriter; identifierProvider?: IIdentifierProvider; snapshotStorage?: IAggregateSnapshotStorage; From 9e0edd38fac9156df0fea87fde3f7e8a8eb5f471 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 14 Oct 2025 00:56:03 +0100 Subject: [PATCH 098/169] Expose MQ defaults as static properties instead of inner constants --- src/rabbitmq/RabbitMqEventBus.ts | 5 +++-- src/rabbitmq/RabbitMqEventInjector.ts | 6 +++--- src/rabbitmq/RabbitMqGateway.ts | 5 +++-- src/rabbitmq/constants.ts | 2 -- 4 files changed, 9 insertions(+), 9 deletions(-) delete mode 100644 src/rabbitmq/constants.ts diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 46553b4..894a672 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,5 +1,4 @@ import { IEvent, IEventBus, IDispatchPipelineProcessor, IMessageHandler, IObservable, DispatchPipelineBatch } from '../interfaces'; -import { DEFAULT_EXCHANGE } from './constants'; import { RabbitMqGateway } from './RabbitMqGateway'; const ALL_EVENTS_WILDCARD = '*'; @@ -10,6 +9,8 @@ export class RabbitMqEventBus implements IEventBus, IDispatchPipelineProcessor { return ALL_EVENTS_WILDCARD; } + static DEFAULT_EXCHANGE = 'node-cqrs.events'; + #gateway: RabbitMqGateway; #queues = new Map(); #exchange: string; @@ -21,7 +22,7 @@ export class RabbitMqEventBus implements IEventBus, IDispatchPipelineProcessor { queueName?: string }) { this.#gateway = o.rabbitMqGateway; - this.#exchange = o.exchange ?? DEFAULT_EXCHANGE; + this.#exchange = o.exchange ?? RabbitMqEventBus.DEFAULT_EXCHANGE; this.#queueName = o.queueName; } diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts index b68de0c..c973177 100644 --- a/src/rabbitmq/RabbitMqEventInjector.ts +++ b/src/rabbitmq/RabbitMqEventInjector.ts @@ -3,7 +3,7 @@ import { IMessage } from '../interfaces/IMessage'; import { RabbitMqGateway } from './RabbitMqGateway'; import { IEventDispatcher } from '../interfaces'; import * as Event from '../Event'; -import { DEFAULT_EXCHANGE } from './constants'; +import { RabbitMqEventBus } from './RabbitMqEventBus'; /** * Injects events received from a RabbitMQ exchange into the local event dispatcher. @@ -31,7 +31,7 @@ export class RabbitMqEventInjector { container.logger; } - async start(exchange: string = DEFAULT_EXCHANGE): Promise { + async start(exchange: string = RabbitMqEventBus.DEFAULT_EXCHANGE): Promise { this.#logger?.debug(`Subscribing to messages from exchange "${exchange}"...`); await this.#rabbitMqGateway.subscribeToFanout(exchange, this.#messageHandler); @@ -39,7 +39,7 @@ export class RabbitMqEventInjector { this.#logger?.debug(`Listening to messages from exchange "${exchange}"`); } - async stop(exchange: string = DEFAULT_EXCHANGE): Promise { + async stop(exchange: string = RabbitMqEventBus.DEFAULT_EXCHANGE): Promise { this.#logger?.debug(`Unsubscribing from messages from exchange "${exchange}"...`); await this.#rabbitMqGateway.unsubscribe({ diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index f43b6e6..72317a7 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -2,7 +2,6 @@ import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; import { IContainer, ILogger, IMessage, isMessage } from '../interfaces'; import * as Event from '../Event'; import { delay } from '../utils'; -import { HANDLER_PROCESS_TIMEOUT } from './constants'; import { TerminationHandler } from './TerminationHandler'; /** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ @@ -47,6 +46,8 @@ const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); */ export class RabbitMqGateway { + static HANDLER_PROCESS_TIMEOUT = 60 * 60 * 1000; // 1 hour + #connectionFactory: () => Promise; #appId: string; #logger: ILogger | undefined; @@ -360,7 +361,7 @@ export class RabbitMqGateway { messageId }); channel.nack(msg, false, false); - }, HANDLER_PROCESS_TIMEOUT); + }, RabbitMqGateway.HANDLER_PROCESS_TIMEOUT); try { diff --git a/src/rabbitmq/constants.ts b/src/rabbitmq/constants.ts deleted file mode 100644 index 2f3a455..0000000 --- a/src/rabbitmq/constants.ts +++ /dev/null @@ -1,2 +0,0 @@ -export const DEFAULT_EXCHANGE = 'node-cqrs.events'; -export const HANDLER_PROCESS_TIMEOUT = 60 * 60 * 1000; // 1 hour From 3dd57a100766b164a8dfebbb946a62e22e5d7dce Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 14 Oct 2025 00:56:22 +0100 Subject: [PATCH 099/169] 1.0.0-rc.20 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 95ea06c..53aa750 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.20](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.19...v1.0.0-rc.20) (2025-10-13) + + +### Changes + +* Enhance type safety in CqrsContainerBuilder with generics ([025765c](https://github.com/snatalenko/node-cqrs/commit/025765cc31eec5a004142dff5cafd8264af10ea9)) + + # [1.0.0-rc.19](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.18...v1.0.0-rc.19) (2025-09-24) diff --git a/package-lock.json b/package-lock.json index 5546dad..79de12f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.19", + "version": "1.0.0-rc.20", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.19", + "version": "1.0.0-rc.20", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index ecd1e92..b95dfe4 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.19", + "version": "1.0.0-rc.20", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From ca4016a486a7b2a010f86174140bd21e0a1c0d08 Mon Sep 17 00:00:00 2001 From: Anton Korotkov Date: Tue, 14 Oct 2025 11:22:46 +0200 Subject: [PATCH 100/169] fix: Proper milliseconds calculation for Event Locker --- src/sqlite/SqliteEventLocker.ts | 6 +++--- src/sqlite/queries/eventLockTableInit.ts | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index 9beedda..316f028 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -81,16 +81,16 @@ export class SqliteEventLocker extends AbstractSqliteAccessor implements IEventL VALUES (?, ?, ?) ON CONFLICT (projection_name, schema_version, event_id) DO UPDATE SET - processing_at = cast(strftime('%f', 'now') * 1000 as INTEGER) + processing_at = cast(unixepoch('subsec') * 1000 as INTEGER) WHERE processed_at IS NULL - AND processing_at <= cast(strftime('%f', 'now') * 1000 as INTEGER) - ${this.#eventLockTtl} + AND processing_at <= cast(unixepoch('subsec') * 1000 as INTEGER) - ${this.#eventLockTtl} `); this.#finalizeEventLockQuery = db.prepare(` UPDATE ${this.#eventLockTableName} SET - processed_at = (cast(strftime('%f', 'now') * 1000 as INTEGER)) + processed_at = cast(unixepoch('subsec') * 1000 as INTEGER) WHERE projection_name = ? AND schema_version = ? diff --git a/src/sqlite/queries/eventLockTableInit.ts b/src/sqlite/queries/eventLockTableInit.ts index 31a6b95..5480654 100644 --- a/src/sqlite/queries/eventLockTableInit.ts +++ b/src/sqlite/queries/eventLockTableInit.ts @@ -3,7 +3,7 @@ export const eventLockTableInit = (eventLockTableName: string) => ` projection_name TEXT NOT NULL, schema_version TEXT NOT NULL, event_id BLOB NOT NULL, - processing_at INTEGER NOT NULL DEFAULT (cast(strftime('%f', 'now') * 1000 as INTEGER)), + processing_at INTEGER NOT NULL DEFAULT (cast(unixepoch('subsec') * 1000 as INTEGER)), processed_at INTEGER, PRIMARY KEY (projection_name, schema_version, event_id) ); From f3850315cdc07528db14abe123781ea7f24c0937 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 14 Oct 2025 12:50:57 +0100 Subject: [PATCH 101/169] Improve rabbitmq error logging --- src/rabbitmq/RabbitMqGateway.ts | 35 ++++++++++++++++++++++----------- 1 file changed, 24 insertions(+), 11 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 72317a7..54a9d4a 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -36,6 +36,19 @@ type Subscription = { const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); +function extractErrorMessage(err: Error | AggregateError | unknown): string { + if (!err || typeof err !== 'object') + return String(err); + + if (err instanceof AggregateError) + return err.errors?.map(e => (e && 'message' in e ? e.message : String(e))).join('; '); + + if (err instanceof Error && err.message) + return err.message; + + return String(err); +} + /** * RabbitMqGateway implements the IObservable interface using RabbitMQ. * @@ -113,8 +126,8 @@ export class RabbitMqGateway { for (const subscription of subscriptionsToRestore) await this.subscribe(subscription); } - catch (err: any) { - this.#logger?.warn(`${this.#appId}: Connection attempt failed: ${err.message}`); + catch (err: unknown) { + this.#logger?.warn(`${this.#appId}: Connection attempt failed: ${extractErrorMessage(err)}`); await delay(5_000); } } @@ -135,9 +148,9 @@ export class RabbitMqGateway { this.#logger?.debug(`${this.#appId}: Disconnected from RabbitMQ`); } - catch (err: any) { - this.#logger?.error(`${this.#appId}: Failed to disconnect from RabbitMQ: ${err.message}`, { - stack: err.stack + catch (err: unknown) { + this.#logger?.error(`${this.#appId}: Failed to disconnect from RabbitMQ: ${extractErrorMessage(err)}`, { + stack: (err as Error)?.stack }); } } @@ -152,8 +165,8 @@ export class RabbitMqGateway { this.#logger?.debug(`${this.#appId}: Consumer "${consumerTag}" on queue "${queueName}" cancelled successfully`); this.#queueConsumers.delete(queueName); } - catch (err: any) { - this.#logger?.error(`${this.#appId}: Failed to cancel consumer "${consumerTag}" for queue "${queueName}": ${err.message}`); + catch (err: unknown) { + this.#logger?.error(`${this.#appId}: Failed to cancel consumer "${consumerTag}" for queue "${queueName}": ${extractErrorMessage(err)}`); } }); @@ -161,8 +174,8 @@ export class RabbitMqGateway { this.#logger?.info(`${this.#appId}: All consumers stopped.`); } - #onConnectionError(err: Error) { - this.#logger?.warn(`${this.#appId}: Connection error: ${err.message}`); + #onConnectionError(err: unknown) { + this.#logger?.warn(`${this.#appId}: Connection error: ${extractErrorMessage(err)}`); } #onConnectionClosed() { @@ -390,8 +403,8 @@ export class RabbitMqGateway { channel?.ack(msg); } - catch (err: any) { - this.#logger?.error(`${this.#appId}: Message processing failed: ${err.message}`); + catch (err: unknown) { + this.#logger?.error(`${this.#appId}: Message processing failed: ${extractErrorMessage(err)}`); // Redirect message to dead letter queue, if `{ noAck: true }` was not set on consumption channel?.nack(msg, false, false); From 984cbd515578b40a8d05738ece8adc8d06f3f6ca Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 14 Oct 2025 12:51:33 +0100 Subject: [PATCH 102/169] 1.0.0-rc.21 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 53aa750..3a5c16e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.21](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.20...v1.0.0-rc.21) (2025-10-14) + + +### Fixes + +* Proper milliseconds calculation for Event Locker ([ca4016a](https://github.com/snatalenko/node-cqrs/commit/ca4016a486a7b2a010f86174140bd21e0a1c0d08)) + + # [1.0.0-rc.20](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.19...v1.0.0-rc.20) (2025-10-13) diff --git a/package-lock.json b/package-lock.json index 79de12f..5565b22 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.20", + "version": "1.0.0-rc.21", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.20", + "version": "1.0.0-rc.21", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index b95dfe4..228082a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.20", + "version": "1.0.0-rc.21", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From b38cfb0489173d463565eeb353cf2994ed72a79e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 24 Oct 2025 00:40:12 +0100 Subject: [PATCH 103/169] Remove RabbitMqEventInjector and related tests; simplify RabbitMqGateway and EventBus --- src/rabbitmq/IContainer.ts | 9 --- src/rabbitmq/RabbitMqEventBus.ts | 30 ++------- src/rabbitmq/RabbitMqEventInjector.ts | 66 ------------------- src/rabbitmq/RabbitMqGateway.ts | 7 +- src/rabbitmq/index.ts | 1 - .../rabbitmq/RabbitMqEventInjector.test.ts | 66 ------------------- 6 files changed, 9 insertions(+), 170 deletions(-) delete mode 100644 src/rabbitmq/RabbitMqEventInjector.ts delete mode 100644 tests/integration/rabbitmq/RabbitMqEventInjector.test.ts diff --git a/src/rabbitmq/IContainer.ts b/src/rabbitmq/IContainer.ts index 9a66a29..ceac5c4 100644 --- a/src/rabbitmq/IContainer.ts +++ b/src/rabbitmq/IContainer.ts @@ -1,16 +1,7 @@ -import { IEventBus } from '../interfaces'; -import { RabbitMqEventInjector } from './RabbitMqEventInjector'; import { RabbitMqGateway } from './RabbitMqGateway'; declare module '../interfaces/IContainer' { interface IContainer { rabbitMqGateway?: RabbitMqGateway; - rabbitMqEventInjector?: RabbitMqEventInjector; - rabbitMqEventBus?: RabbitMqEventInjector; - - /** - * Optional external event bus for publishing events to an external system. - */ - externalEventBus?: IEventBus; } } diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 894a672..50e2e01 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,12 +1,10 @@ -import { IEvent, IEventBus, IDispatchPipelineProcessor, IMessageHandler, IObservable, DispatchPipelineBatch } from '../interfaces'; +import { IEvent, IEventBus, IMessageHandler, IObservable } from '../interfaces'; import { RabbitMqGateway } from './RabbitMqGateway'; -const ALL_EVENTS_WILDCARD = '*'; +export class RabbitMqEventBus implements IEventBus { -export class RabbitMqEventBus implements IEventBus, IDispatchPipelineProcessor { - - static get allEventsWildcard(): '*' { - return ALL_EVENTS_WILDCARD; + static get allEventsWildcard(): string { + return RabbitMqGateway.ALL_EVENTS_WILDCARD; } static DEFAULT_EXCHANGE = 'node-cqrs.events'; @@ -82,24 +80,4 @@ export class RabbitMqEventBus implements IEventBus, IDispatchPipelineProcessor { } return queue; } - - /** - * Processes a batch of events and publishes them to the fanout exchange. - * - * This method is part of the `IDispatchPipelineProcessor` interface. - */ - async process(batch: DispatchPipelineBatch): Promise { - for (const { event, origin } of batch) { - // Skip publishing if the event was dispatched from external source - if (origin === 'external') - continue; - - if (!event) - throw new Error('Event batch does not contain `event`'); - - await this.publish(event); - } - - return batch; - } } diff --git a/src/rabbitmq/RabbitMqEventInjector.ts b/src/rabbitmq/RabbitMqEventInjector.ts deleted file mode 100644 index c973177..0000000 --- a/src/rabbitmq/RabbitMqEventInjector.ts +++ /dev/null @@ -1,66 +0,0 @@ -import { IContainer } from '../interfaces/IContainer'; -import { IMessage } from '../interfaces/IMessage'; -import { RabbitMqGateway } from './RabbitMqGateway'; -import { IEventDispatcher } from '../interfaces'; -import * as Event from '../Event'; -import { RabbitMqEventBus } from './RabbitMqEventBus'; - -/** - * Injects events received from a RabbitMQ exchange into the local event dispatcher. - * - * It subscribes to a specified fanout exchange on RabbitMQ and dispatches - * any received messages as events using the provided event dispatcher. - */ -export class RabbitMqEventInjector { - #rabbitMqGateway: RabbitMqGateway; - #messageHandler: (message: IMessage) => Promise; - #eventDispatcher: IEventDispatcher; - #logger: IContainer['logger']; - - constructor(container: Partial>) { - if (!container.eventDispatcher) - throw new Error('eventDispatcher is required in the container.'); - if (!container.rabbitMqGateway) - throw new Error('rabbitMqGateway is required in the container.'); - - this.#rabbitMqGateway = container.rabbitMqGateway; - this.#messageHandler = (msg: IMessage) => this.#handleMessage(msg); - this.#eventDispatcher = container.eventDispatcher; - this.#logger = container.logger && 'child' in container.logger ? - container.logger.child({ service: new.target.name }) : - container.logger; - } - - async start(exchange: string = RabbitMqEventBus.DEFAULT_EXCHANGE): Promise { - this.#logger?.debug(`Subscribing to messages from exchange "${exchange}"...`); - - await this.#rabbitMqGateway.subscribeToFanout(exchange, this.#messageHandler); - - this.#logger?.debug(`Listening to messages from exchange "${exchange}"`); - } - - async stop(exchange: string = RabbitMqEventBus.DEFAULT_EXCHANGE): Promise { - this.#logger?.debug(`Unsubscribing from messages from exchange "${exchange}"...`); - - await this.#rabbitMqGateway.unsubscribe({ - exchange, - handler: this.#messageHandler - }); - - this.#logger?.debug(`Stopped listening to messages from exchange "${exchange}"`); - } - - async #handleMessage(message: IMessage): Promise { - this.#logger?.debug(`"${Event.describe(message)}" received`); - try { - await this.#eventDispatcher.dispatch([message], { origin: 'external' }); - - this.#logger?.debug(`${Event.describe(message)} dispatched successfully`); - } - catch (error: any) { - this.#logger?.error(`Failed to dispatch event ${message.type}: ${error.message}`, { stack: error.stack }); - - throw error; // Re-throw to ensure message is nack'd by the gateway - } - } -} diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 54a9d4a..84e0d58 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -60,6 +60,7 @@ function extractErrorMessage(err: Error | AggregateError | unknown): string { export class RabbitMqGateway { static HANDLER_PROCESS_TIMEOUT = 60 * 60 * 1000; // 1 hour + static ALL_EVENTS_WILDCARD = '*'; #connectionFactory: () => Promise; #appId: string; @@ -175,7 +176,9 @@ export class RabbitMqGateway { } #onConnectionError(err: unknown) { - this.#logger?.warn(`${this.#appId}: Connection error: ${extractErrorMessage(err)}`); + this.#logger?.error(`${this.#appId}: Connection error: ${extractErrorMessage(err)}`, { + stack: err instanceof Error ? err.stack : undefined + }); } #onConnectionClosed() { @@ -192,7 +195,7 @@ export class RabbitMqGateway { s.queueGivenName === queueGivenName && ( !s.eventType - || s.eventType === '*' + || s.eventType === RabbitMqGateway.ALL_EVENTS_WILDCARD || s.eventType === eventType ) ); diff --git a/src/rabbitmq/index.ts b/src/rabbitmq/index.ts index 26b4d04..79404df 100644 --- a/src/rabbitmq/index.ts +++ b/src/rabbitmq/index.ts @@ -1,3 +1,2 @@ export * from './RabbitMqEventBus'; -export * from './RabbitMqEventInjector'; export * from './RabbitMqGateway'; diff --git a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts b/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts deleted file mode 100644 index 08eba71..0000000 --- a/tests/integration/rabbitmq/RabbitMqEventInjector.test.ts +++ /dev/null @@ -1,66 +0,0 @@ -import * as amqplib from 'amqplib'; -import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; -import { RabbitMqEventInjector } from '../../../src/rabbitmq/RabbitMqEventInjector'; -import { IEvent, IEventDispatcher } from '../../../src/interfaces'; -import { jest } from '@jest/globals'; -import { delay } from '../../../src/utils'; - -describe('RabbitMqEventInjector', () => { - let rabbitMqGateway: RabbitMqGateway; - let rabbitMqGateway2: RabbitMqGateway; - let eventDispatcher: jest.Mocked; - - const exchange = 'node-cqrs.events'; - const eventType = 'test-injector-event'; - - beforeEach(async () => { - const rabbitMqConnectionFactory = () => amqplib.connect('amqp://localhost'); - rabbitMqGateway = new RabbitMqGateway({ rabbitMqConnectionFactory }); - rabbitMqGateway2 = new RabbitMqGateway({ rabbitMqConnectionFactory }); - - eventDispatcher = { - dispatch: jest.fn().mockResolvedValue(undefined) - } as unknown as jest.Mocked; - - const injector = new RabbitMqEventInjector({ rabbitMqGateway, eventDispatcher }); - - await injector.start(exchange); - }); - - afterEach(async () => { - const ch = await rabbitMqGateway.connection?.createChannel(); - await ch.deleteExchange(exchange); - await ch.close(); - await rabbitMqGateway.disconnect(); - await rabbitMqGateway2.disconnect(); - }); - - it('does not receive messages published to own gateway', async () => { - const testEvent: IEvent = { - type: eventType, - payload: { data: 'test-payload' }, - id: 'test-id-123' - }; - - await rabbitMqGateway.publish(exchange, testEvent); - - await delay(50); - - expect(eventDispatcher.dispatch).not.toHaveBeenCalled(); - }); - - it('receives messages published to other gateway, dispatches to eventDispatcher', async () => { - const testEvent: IEvent = { - type: eventType, - payload: { data: 'test-payload' }, - id: 'test-id-123' - }; - - await rabbitMqGateway2.publish(exchange, testEvent); - - await delay(50); - - expect(eventDispatcher.dispatch).toHaveBeenCalledTimes(1); - expect(eventDispatcher.dispatch).toHaveBeenCalledWith([testEvent], { origin: 'external' }); - }); -}); From 149414cc0292a76a11cc61dd911cf0c2ab967bc7 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 24 Oct 2025 00:40:27 +0100 Subject: [PATCH 104/169] 1.0.0-rc.22 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3a5c16e..2751a68 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.22](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.21...v1.0.0-rc.22) (2025-10-23) + + + # [1.0.0-rc.21](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.20...v1.0.0-rc.21) (2025-10-14) diff --git a/package-lock.json b/package-lock.json index 5565b22..253c333 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.21", + "version": "1.0.0-rc.22", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.21", + "version": "1.0.0-rc.22", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 228082a..1cc0050 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.21", + "version": "1.0.0-rc.22", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 1d6767a391ad2cd755e0cf0557fee028215521c0 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 24 Oct 2025 16:37:15 +0100 Subject: [PATCH 105/169] Refactor event type handling in RabbitMqGateway to use constant for wildcard --- src/rabbitmq/RabbitMqGateway.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 84e0d58..b704e9c 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -190,7 +190,7 @@ export class RabbitMqGateway { this.#queueConsumers.clear(); } - #getHandlers(queueGivenName: string = '', eventType: string = '*') { + #getHandlers(queueGivenName: string = '', eventType: string = RabbitMqGateway.ALL_EVENTS_WILDCARD) { return this.#subscriptions.filter(s => s.queueGivenName === queueGivenName && ( @@ -346,7 +346,7 @@ export class RabbitMqGateway { } async #assertBinding(channel: Channel, exchange: string, queueGivenName: string, eventType?: string) { - if (!eventType || eventType === '*') + if (!eventType || eventType === RabbitMqGateway.ALL_EVENTS_WILDCARD) eventType = '#'; await channel.bindQueue(queueGivenName, exchange, eventType); From 5c1166a0388062f3b23dbdc5f3d0bdf811f3ddfc Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 26 Oct 2025 23:21:33 +0000 Subject: [PATCH 106/169] Update DispatchPipelineEnvelope to allow flexible origin types --- src/interfaces/IDispatchPipelineProcessor.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/interfaces/IDispatchPipelineProcessor.ts b/src/interfaces/IDispatchPipelineProcessor.ts index f263490..958412f 100644 --- a/src/interfaces/IDispatchPipelineProcessor.ts +++ b/src/interfaces/IDispatchPipelineProcessor.ts @@ -10,7 +10,7 @@ export type DispatchPipelineEnvelope = { /** * Origin of the event. Can be used to distinguish between events coming from different sources. */ - origin?: 'external' | 'internal'; + origin?: string; event?: IEvent; } From 5799d18398600da9d988b8d8eb8c16a794be46ab Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 26 Oct 2025 23:21:44 +0000 Subject: [PATCH 107/169] 1.0.0-rc.23 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2751a68..a36db8d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.23](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.22...v1.0.0-rc.23) (2025-10-26) + + + # [1.0.0-rc.22](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.21...v1.0.0-rc.22) (2025-10-23) diff --git a/package-lock.json b/package-lock.json index 253c333..a0d6283 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.22", + "version": "1.0.0-rc.23", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.22", + "version": "1.0.0-rc.23", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 1cc0050..870f407 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.22", + "version": "1.0.0-rc.23", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 0425c9d6335e6c1d685713ef7beca307b0e81726 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 30 Oct 2025 12:34:51 +0000 Subject: [PATCH 108/169] Enhance RabbitMqGateway subscription options with `noAck` and `handlerProcessTimeout`; expose all options on `subscribeToQueue` and `subscribeToFanout` --- src/rabbitmq/RabbitMqGateway.ts | 47 ++++++++++++++++++++++++--------- 1 file changed, 35 insertions(+), 12 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index b704e9c..1280629 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -32,6 +32,22 @@ type Subscription = { /** Optional limit for concurrent message handling */ concurrentLimit?: number; + + /** + * If true, the broker won't expect an acknowledgement of messages delivered to this consumer; + * i.e., it will dequeue messages as soon as they've been sent down the wire. + * + * Defaults to `false` - messages are acknowledged after successful handler completion or rejected on exception. + */ + noAck?: boolean; + + /** + * Handler timeout in milliseconds; if the handler does not complete within this time, + * the message is considered failed and is rejected. + * + * Defaults to 1h (`RabbitMqGateway.HANDLER_PROCESS_TIMEOUT`) + */ + handlerProcessTimeout?: number; }; const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); @@ -201,8 +217,9 @@ export class RabbitMqGateway { ); } - async subscribeToQueue(exchange: string, queueName: string, handler: MessageHandler) { - return this.subscribe({ exchange, queueName, handler }); + async subscribeToQueue(exchange: string, queueName: string, handler: MessageHandler, + options?: Omit) { + return this.subscribe({ exchange, queueName, handler, ...options }); } /** @@ -211,8 +228,9 @@ export class RabbitMqGateway { * Messages are considered "delivered" upon receipt. * Failed message processing does not result in redelivery or dead-lettering. */ - async subscribeToFanout(exchange: string, handler: MessageHandler) { - return this.subscribe({ exchange, handler, ignoreOwn: true }); + async subscribeToFanout(exchange: string, handler: MessageHandler, + options?: Omit) { + return this.subscribe({ exchange, handler, ignoreOwn: true, ...options }); } /** @@ -238,8 +256,7 @@ export class RabbitMqGateway { const { exchange, queueName, - eventType, - concurrentLimit + eventType } = subscription; const channel = await this.#assertChannel(queueName); @@ -271,7 +288,7 @@ export class RabbitMqGateway { await this.#assetQueue(channel, exchange, queueGivenName, eventType, { deadLetterExchangeName }); } - await this.#assertConsumer(queueGivenName, channel, concurrentLimit); + await this.#assertConsumer(queueGivenName, channel, subscription); this.#subscriptions.push({ ...subscription, queueGivenName }); } @@ -354,12 +371,16 @@ export class RabbitMqGateway { this.#logger?.debug(`${this.#appId}: Queue "${queueGivenName}" bound to exchange "${exchange}" with pattern "${eventType}"`); } - async #assertConsumer(queueGivenName: string, channel: Channel, concurrentLimit?: number) { + async #assertConsumer( + queueGivenName: string, + channel: Channel, + options?: Pick + ) { if (this.#queueConsumers.has(queueGivenName)) return; - if (concurrentLimit) - await channel.prefetch(concurrentLimit); + if (options?.concurrentLimit !== undefined) + await channel.prefetch(options.concurrentLimit); const c = await channel.consume(queueGivenName, async (msg: ConsumeMessage | null) => { if (!msg) @@ -369,6 +390,7 @@ export class RabbitMqGateway { const { messageId, correlationId, appId } = msg.properties ?? {}; // Keep the process alive while waiting for the handler to finish + const handlerProcessTimeout = options?.handlerProcessTimeout ?? RabbitMqGateway.HANDLER_PROCESS_TIMEOUT; const keepAliveTimeout = setTimeout(() => { this.#logger?.warn(`${this.#appId}: Message processing timed out`, { queueName: queueGivenName, @@ -377,10 +399,9 @@ export class RabbitMqGateway { messageId }); channel.nack(msg, false, false); - }, RabbitMqGateway.HANDLER_PROCESS_TIMEOUT); + }, handlerProcessTimeout); try { - this.#logger?.debug(`${this.#appId}: Message received`, { queueName: queueGivenName, consumerTag, @@ -415,6 +436,8 @@ export class RabbitMqGateway { finally { clearTimeout(keepAliveTimeout); } + }, { + noAck: options?.noAck }); this.#logger?.debug(`${this.#appId}: Consumer "${c.consumerTag}" registered on queue "${queueGivenName}"`); From d779c7e37659c043b17c7c9146b4057c1f4b2f56 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 30 Oct 2025 15:03:57 +0000 Subject: [PATCH 109/169] 1.0.0-rc.24 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a36db8d..9608d2e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.24](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.23...v1.0.0-rc.24) (2025-10-30) + + + # [1.0.0-rc.23](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.22...v1.0.0-rc.23) (2025-10-26) diff --git a/package-lock.json b/package-lock.json index a0d6283..3942654 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.23", + "version": "1.0.0-rc.24", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.23", + "version": "1.0.0-rc.24", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 870f407..b65ada9 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.23", + "version": "1.0.0-rc.24", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From d54c54370c0e2110eec7bad27e9a2b44c2690261 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 31 Oct 2025 18:01:17 +0000 Subject: [PATCH 110/169] Avoid publishing "snapshot" events to eventBus --- src/AbstractAggregate.ts | 5 ++--- src/EventDispatchPipeline.ts | 15 ++++++++++----- src/in-memory/InMemorySnapshotStorage.ts | 7 ++----- src/interfaces/ISnapshotEvent.ts | 10 ++++++++++ src/interfaces/index.ts | 1 + 5 files changed, 25 insertions(+), 13 deletions(-) create mode 100644 src/interfaces/ISnapshotEvent.ts diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index b92715e..4243173 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -5,13 +5,12 @@ import { Identifier, IEvent, IEventSet, - IAggregateConstructorParams + IAggregateConstructorParams, + SNAPSHOT_EVENT_TYPE } from './interfaces'; import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils'; -const SNAPSHOT_EVENT_TYPE = 'snapshot'; - /** * Base class for Aggregate definition */ diff --git a/src/EventDispatchPipeline.ts b/src/EventDispatchPipeline.ts index 0d1d95c..340612d 100644 --- a/src/EventDispatchPipeline.ts +++ b/src/EventDispatchPipeline.ts @@ -3,7 +3,8 @@ import { IEvent, IDispatchPipelineProcessor, IEventBus, - isDispatchPipelineProcessor + isDispatchPipelineProcessor, + isSnapshotEvent } from './interfaces'; import { parallelPipe } from 'async-parallel-pipe'; @@ -73,10 +74,14 @@ export class EventDispatchPipeline { const events: IEvent[] = []; for (const batch of data) { const { event, ...meta } = batch as any; - if (event) { - await this.eventBus.publish(event, meta); - events.push(event); - } + if (!event) + continue; + if (isSnapshotEvent(event)) + continue; + + await this.eventBus.publish(event, meta); + + events.push(event); } resolve(events); } diff --git a/src/in-memory/InMemorySnapshotStorage.ts b/src/in-memory/InMemorySnapshotStorage.ts index ae3bbcf..879dcb2 100644 --- a/src/in-memory/InMemorySnapshotStorage.ts +++ b/src/in-memory/InMemorySnapshotStorage.ts @@ -5,14 +5,11 @@ import { Identifier, IDispatchPipelineProcessor, IEvent, - ILogger + ILogger, + isSnapshotEvent } from '../interfaces'; import * as Event from '../Event'; -const SNAPSHOT_EVENT_TYPE = 'snapshot'; -const isSnapshotEvent = (event?: IEvent): event is IEvent & { type: 'snapshot' } => - (!!event && event.type === SNAPSHOT_EVENT_TYPE); - /** * In-memory storage for aggregate snapshots. * Storage content resets on app restart diff --git a/src/interfaces/ISnapshotEvent.ts b/src/interfaces/ISnapshotEvent.ts new file mode 100644 index 0000000..81b61e6 --- /dev/null +++ b/src/interfaces/ISnapshotEvent.ts @@ -0,0 +1,10 @@ +import { IEvent, isEvent } from './IEvent'; + +export const SNAPSHOT_EVENT_TYPE: 'snapshot' = 'snapshot'; + +export interface ISnapshotEvent extends IEvent { + type: typeof SNAPSHOT_EVENT_TYPE +} + +export const isSnapshotEvent = (event?: unknown): event is ISnapshotEvent => + isEvent(event) && event.type === SNAPSHOT_EVENT_TYPE; diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index 6829a48..9b9539f 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -24,4 +24,5 @@ export * from './IObservable'; export * from './IObserver'; export * from './IProjection'; export * from './ISaga'; +export * from './ISnapshotEvent'; export * from './IViewLocker'; From 4697db1348b57a8d59062a4a5ee6ad62fba066ce Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 31 Oct 2025 18:01:26 +0000 Subject: [PATCH 111/169] 1.0.0-rc.25 --- CHANGELOG.md | 4 ++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9608d2e..da34cfb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +# [1.0.0-rc.25](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.24...v1.0.0-rc.25) (2025-10-31) + + + # [1.0.0-rc.24](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.23...v1.0.0-rc.24) (2025-10-30) diff --git a/package-lock.json b/package-lock.json index 3942654..6687ebc 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.24", + "version": "1.0.0-rc.25", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.24", + "version": "1.0.0-rc.25", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index b65ada9..4834a21 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.24", + "version": "1.0.0-rc.25", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From f6171498db544d820e876d550421eef75c66088f Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 2 Dec 2025 20:35:02 +0000 Subject: [PATCH 112/169] Internal Fix: Use "quorum" type for durable queues --- src/rabbitmq/RabbitMqGateway.ts | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 1280629..e129685 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -350,9 +350,13 @@ export class RabbitMqGateway { const { queue: queueGivenName } = await channel.assertQueue(queueName, { exclusive, durable, - ...deadLetterExchangeName && { - arguments: { + arguments: { + ...deadLetterExchangeName && { 'x-dead-letter-exchange': deadLetterExchangeName + }, + ...durable && { + // Use quorum queues (Raft-replicated, HA alternative to classic queues) for durable workloads + 'x-queue-type': 'quorum' } } }); From 0e9b25edd0a81581fb084256638c9ab56afb4115 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 3 Dec 2025 00:49:43 +0000 Subject: [PATCH 113/169] Internal Fix: Vulnerability in js-yaml dev dependency --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 6687ebc..d61ce55 100644 --- a/package-lock.json +++ b/package-lock.json @@ -921,9 +921,9 @@ } }, "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": { - "version": "3.14.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", - "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "version": "3.14.2", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz", + "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==", "dev": true, "license": "MIT", "dependencies": { @@ -5019,9 +5019,9 @@ "license": "MIT" }, "node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", "dev": true, "license": "MIT", "dependencies": { From 506acc2dde02dd4d83cb8e8d6079dc63fa992651 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 5 Dec 2025 00:44:36 +0000 Subject: [PATCH 114/169] Internal Fix: Ensure proper subscription management in TerminationHandler --- src/rabbitmq/TerminationHandler.ts | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/rabbitmq/TerminationHandler.ts b/src/rabbitmq/TerminationHandler.ts index f5e63f3..693fe5a 100644 --- a/src/rabbitmq/TerminationHandler.ts +++ b/src/rabbitmq/TerminationHandler.ts @@ -7,6 +7,7 @@ export class TerminationHandler { #process: NodeJS.Process; #cleanupHandler: () => Promise; #terminationHandler: () => Promise; + #subscribed = false; constructor(process: NodeJS.Process, cleanupHandler: () => Promise) { this.#process = process; @@ -15,13 +16,18 @@ export class TerminationHandler { } on() { + if (this.#subscribed) + return; + this.#process.once('SIGINT', this.#terminationHandler); this.#process.once('SIGTERM', this.#terminationHandler); + this.#subscribed = true; } off() { this.#process.off('SIGINT', this.#terminationHandler); this.#process.off('SIGTERM', this.#terminationHandler); + this.#subscribed = false; } async #onProcessTermination() { From a42d138fc93bc767ae5d7fac75f5582cb3936103 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 5 Dec 2025 00:46:12 +0000 Subject: [PATCH 115/169] Change: Move reconnect logic to rabbitMqConnectionFactory; re-establish subscriptions on reconnect --- src/rabbitmq/RabbitMqGateway.ts | 96 ++++++++++++++++++++++++--------- 1 file changed, 72 insertions(+), 24 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index e129685..79142ce 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -65,6 +65,8 @@ function extractErrorMessage(err: Error | AggregateError | unknown): string { return String(err); } +const describeSub = (s: Subscription) => `to${s.queueName ? ` queue "${s.queueName}" of` : ''} exchange "${s.exchange}"`; + /** * RabbitMqGateway implements the IObservable interface using RabbitMQ. * @@ -89,11 +91,19 @@ export class RabbitMqGateway { #queueChannels = new Map(); #queueConsumers = new Map(); - #subscriptions: Array = []; - #handlers: Map>> = new Map(); + #subscriptions: Array = []; /** Handles termination signals for graceful shutdown */ #terminationHandler: TerminationHandler | undefined; + #restoringSubscriptions: boolean = false; get connection() { return this.#connection; @@ -127,31 +137,53 @@ export class RabbitMqGateway { */ async connect(): Promise { while (this.#connecting) - await delay(1_000); + await delay(100); + + if (this.#connection) { + this.#logger?.debug(`${this.#appId}: Connection is already established`); + return this.#connection; + } this.#connecting = true; - while (!this.#connection) { - try { - this.#connection = await this.#connectionFactory(); - this.#connection.on('error', err => this.#onConnectionError(err)); - this.#connection.on('close', () => this.#onConnectionClosed()); - this.#logger?.info(`${this.#appId}: Connection established`); - - this.#handlers.clear(); - const subscriptionsToRestore = this.#subscriptions.splice(0); - for (const subscription of subscriptionsToRestore) - await this.subscribe(subscription); - } - catch (err: unknown) { - this.#logger?.warn(`${this.#appId}: Connection attempt failed: ${extractErrorMessage(err)}`); - await delay(5_000); - } + try { + this.#connection = await this.#connectionFactory(); + this.#connection.on('error', err => this.#onConnectionError(err)); + this.#connection.on('close', () => this.#onConnectionClosed()); + + this.#logger?.info(`${this.#appId}: Connection established`); + + await this.#restoreSubscriptions(); + + return this.#connection; } + catch (err: unknown) { + this.#logger?.error(`${this.#appId}: Connection attempt failed: ${extractErrorMessage(err)}`, { + stack: (err as Error)?.stack + }); + throw err; + } + finally { + this.#connecting = false; + } + } - this.#connecting = false; + async #restoreSubscriptions() { + this.#restoringSubscriptions = true; + try { + for (let i = 0; i < this.#subscriptions.length; i++) { + const subscriptionToRestore = this.#subscriptions.shift(); + if (!subscriptionToRestore) // should never happen; check is for type consistency + continue; - return this.#connection; + await this.#subscribe(subscriptionToRestore); + } + + this.#logger?.debug(`${this.#appId}: ${this.#subscriptions.length} subscription(s) restored`); + } + finally { + this.#restoringSubscriptions = false; + } } async disconnect() { @@ -249,9 +281,20 @@ export class RabbitMqGateway { * @returns A promise that resolves when the subscription is successfully set up. */ async subscribe(subscription: Subscription) { + while (this.#restoringSubscriptions) + await delay(100); + + return this.#subscribe(subscription); + } + + async #subscribe(subscription: Subscription) { const subscriptionExists = !!this.#findSubscription(subscription); if (subscriptionExists) - throw new Error('Subscription already exists'); + throw new Error(`Subscription ${describeSub(subscription)} already exists`); + + // record subscription details to restore it if connection attempt fails or on reconnect + this.#subscriptions.push(subscription); + this.#logger?.debug(`${this.#appId}: Subscription ${describeSub(subscription)} recorded`); const { exchange, @@ -290,7 +333,11 @@ export class RabbitMqGateway { await this.#assertConsumer(queueGivenName, channel, subscription); - this.#subscriptions.push({ ...subscription, queueGivenName }); + const subscriptionRecord = this.#findSubscription(subscription); + if (subscriptionRecord) + subscriptionRecord.queueGivenName = queueGivenName; + + this.#logger?.debug(`${this.#appId}: Subscription ${describeSub(subscription)} established`); } #findSubscription(subscription: Pick) { @@ -308,7 +355,8 @@ export class RabbitMqGateway { this.#subscriptions = this.#subscriptions.filter(s => s !== subscriptionToRemove); - await this.#tryDropConsumer(subscriptionToRemove.queueGivenName); + if (subscriptionToRemove.queueGivenName) + await this.#tryDropConsumer(subscriptionToRemove.queueGivenName); } async #assertConnection() { From 8c6ead0a9b4f3feba7bbfba539082eeb0b09b9f9 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 5 Dec 2025 00:53:50 +0000 Subject: [PATCH 116/169] Build: Update changelog titles and commit message prefixes --- scripts/changelog/index.js | 36 ++++++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 14 deletions(-) diff --git a/scripts/changelog/index.js b/scripts/changelog/index.js index 1028fe2..01eab65 100644 --- a/scripts/changelog/index.js +++ b/scripts/changelog/index.js @@ -6,20 +6,23 @@ const { resolve } = require('path'); const known = require('./commits.json'); const TITLES = [ - { title: 'Features', tags: ['+', 'new', 'feature'] }, - { title: 'Fixes', tags: ['-', 'fix', 'fixes'] }, + { title: 'Features', tags: ['+', 'new', 'feature', 'feat'] }, { title: 'Changes', tags: ['*', 'change'] }, + { title: 'Fixes', tags: ['-', 'fix', 'fixes'] }, { title: 'Performance Improvements', tags: ['perf', 'performance'] }, - { title: 'Refactoring', tags: ['!', 'refactor', 'refactoring'] }, + { title: 'Security', tags: ['security'] }, { title: 'Documentation', tags: ['doc', 'docs'] }, { title: 'Tests', tags: ['test', 'tests'] }, { title: 'Build System', tags: ['build', 'ci'] }, - { title: 'Reverts', tags: ['reverts'] } + { title: 'Reverts', tags: ['reverts', 'revert'] }, + { title: 'Internal Fixes', tags: ['!', 'refactor', 'refactoring', 'internal fix', 'release fix', 'housekeeping', 'chore', 'revert'] } ]; +/** + * @param {Record} commit + */ function transform(commit) { if (known[commit.hash]) - commit = { ...commit, ...known[commit.hash] }; if (!commit.tag) return undefined; @@ -27,34 +30,39 @@ function transform(commit) { let { tag, message } = commit; if (commit.revert) - tag = 'Revert'; + tag = 'revert'; + + const changelogSection = TITLES.find(t => t.tags.includes(tag.toLowerCase())); + if (!changelogSection) + return undefined; if (message) message = message[0].toUpperCase() + message.substr(1); - const matchingTitle = TITLES.find(t => t.tags.includes(tag.toLowerCase())); - if (matchingTitle) - tag = matchingTitle.title; - else - tag = 'Changes'; - return { ...commit, - tag, + tag: changelogSection.title, message, shortHash: commit.hash.substring(0, 7) }; } +/** + * @param {{ title: string}} a + * @param {{ title: string}} b + */ function commitGroupsSort(a, b) { const gRankA = TITLES.findIndex(t => t.title === a.title); const gRankB = TITLES.findIndex(t => t.title === b.title); return gRankA - gRankB; } +/** + * @param {Function} cb + */ async function presetOpts(cb) { const parserOpts = { - headerPattern: /^(\w*):\s*(.*)$/, // /^(\w*:|[+\-*!])\s*(.*)$/, + headerPattern: /^([^:]*):\s*(.*)$/, // /^(\w*:|[+\-*!])\s*(.*)$/, headerCorrespondence: [ 'tag', 'message' From 96a0bff08556d10e902dfa41267ac90c88b6ecf1 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 5 Dec 2025 00:54:01 +0000 Subject: [PATCH 117/169] 1.0.0-rc.26 --- CHANGELOG.md | 60 ++++++++++++++++++++++++++++++----------------- package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 42 insertions(+), 24 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index da34cfb..3f1d452 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,21 @@ +# [1.0.0-rc.26](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.25...v1.0.0-rc.26) (2025-12-05) + + +### Changes + +* Move reconnect logic to rabbitMqConnectionFactory; re-establish subscriptions on reconnect ([a42d138](https://github.com/snatalenko/node-cqrs/commit/a42d138fc93bc767ae5d7fac75f5582cb3936103)) + +### Build System + +* Update changelog titles and commit message prefixes ([8c6ead0](https://github.com/snatalenko/node-cqrs/commit/8c6ead0a9b4f3feba7bbfba539082eeb0b09b9f9)) + +### Internal Fixes + +* Use "quorum" type for durable queues ([f617149](https://github.com/snatalenko/node-cqrs/commit/f6171498db544d820e876d550421eef75c66088f)) +* Vulnerability in js-yaml dev dependency ([0e9b25e](https://github.com/snatalenko/node-cqrs/commit/0e9b25edd0a81581fb084256638c9ab56afb4115)) +* Ensure proper subscription management in TerminationHandler ([506acc2](https://github.com/snatalenko/node-cqrs/commit/506acc2dde02dd4d83cb8e8d6079dc63fa992651)) + + # [1.0.0-rc.25](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.24...v1.0.0-rc.25) (2025-10-31) @@ -68,10 +86,10 @@ ### Changes * Cache immediate aggregates to handle concurrent commands ([e193c4c](https://github.com/snatalenko/node-cqrs/commit/e193c4c8dc7b91de6cbc84e2ac668170ddb48bc0)) -* Use `structuredClone` for snapshot creation ([1d0e827](https://github.com/snatalenko/node-cqrs/commit/1d0e827da71c760739588a37ae6afe63a4fa8d34)) -### Refactoring +### Internal Fixes +* Use `structuredClone` for snapshot creation ([1d0e827](https://github.com/snatalenko/node-cqrs/commit/1d0e827da71c760739588a37ae6afe63a4fa8d34)) * Simplify aggregate interface ([3e141fd](https://github.com/snatalenko/node-cqrs/commit/3e141fd217c4a094a57fefe8788816d474020ffe)) @@ -110,29 +128,30 @@ # [1.0.0-rc.6](https://github.com/snatalenko/node-cqrs/compare/v0.16.4...v1.0.0-rc.6) (2025-03-21) -### Fixes - -* Vulnerability in minimist dependency ([07b8c68](https://github.com/snatalenko/node-cqrs/commit/07b8c682fae4278965aa13a06caa994c037934e9)) - ### Changes * Add `InMemoryView.prototype.getSync` method ([5d4adb9](https://github.com/snatalenko/node-cqrs/commit/5d4adb9109c4c85edae2b0f3dfd995e8c51aef06)) * Support persistent views; Add SQLite infrastructure ([c235573](https://github.com/snatalenko/node-cqrs/commit/c235573678be349d031d1a696cab3993224979a2)) -### Refactoring +### Fixes -* Migrate to TS and Jest ([6737d55](https://github.com/snatalenko/node-cqrs/commit/6737d5566a9dc6314df0b20a65d32414fc503e54)) +* Vulnerability in minimist dependency ([07b8c68](https://github.com/snatalenko/node-cqrs/commit/07b8c682fae4278965aa13a06caa994c037934e9)) ### Build System * Add NPM publishing script ([3372990](https://github.com/snatalenko/node-cqrs/commit/3372990ba2549695398e0949e35009396e660005)) * Suppress audit and test for tags ([574a00c](https://github.com/snatalenko/node-cqrs/commit/574a00cc53af009994ca4dd3278cb764743b4ad6)) +### Internal Fixes + +* Migrate to TS and Jest ([6737d55](https://github.com/snatalenko/node-cqrs/commit/6737d5566a9dc6314df0b20a65d32414fc503e54)) +* EventStore not subscribing to events emitted by `storage` ([84eaea1](https://github.com/snatalenko/node-cqrs/commit/84eaea17650589717af1720921716246762fec86)) + ## [0.16.4](https://github.com/snatalenko/node-cqrs/compare/v0.16.3...v0.16.4) (2022-08-28) -### Refactoring +### Internal Fixes * Use di package from npm ([0e8db91](https://github.com/snatalenko/node-cqrs/commit/0e8db91636541e95f804e2c266e2d8bbf0f49a8b)) @@ -157,14 +176,14 @@ ## [0.16.1](https://github.com/snatalenko/node-cqrs/compare/v0.16.0...v0.16.1) (2021-05-28) -### Fixes - -* Mark aggregateId optional on command send ([f496ecf](https://github.com/snatalenko/node-cqrs/commit/f496ecfbd5413e8e2a4c69af7848ecc3f1a5365a)) - ### Changes * Postpone view.get responses to next loop iteration ([950c2e4](https://github.com/snatalenko/node-cqrs/commit/950c2e42f62d7388b0cc668e81fb4f6718656fca)) +### Fixes + +* Mark aggregateId optional on command send ([f496ecf](https://github.com/snatalenko/node-cqrs/commit/f496ecfbd5413e8e2a4c69af7848ecc3f1a5365a)) + # [0.16.0](https://github.com/snatalenko/node-cqrs/compare/v0.15.1...v0.16.0) (2020-03-18) @@ -174,16 +193,8 @@ * Accept logger as an optional dependency ([65fe5ad](https://github.com/snatalenko/node-cqrs/commit/65fe5ad8a9de48d548715a2bd651f6d9c4cb0af1)) * Detect circular dependencies in DI container ([1490b51](https://github.com/snatalenko/node-cqrs/commit/1490b519c7581b1de6cd084d91f61875751d773b)) -### Fixes - -* Debug output not using toString in Node 12 ([ca0d32f](https://github.com/snatalenko/node-cqrs/commit/ca0d32f78a676faf45a342f4198ef4a93a3d0702)) -* Debug output on one time subscriptions ([2fd7601](https://github.com/snatalenko/node-cqrs/commit/2fd7601b6b8e8059f0b777af6c1294cc78cb787b)) -* Correctly set type of the extended container builder created from container ([1f2f632](https://github.com/snatalenko/node-cqrs/commit/1f2f6325ceab65c4c81494d145261668125d03b1)) -* Moderate security issue in "minimist" dev dependency ([579d523](https://github.com/snatalenko/node-cqrs/commit/579d523745a6d33902a5245bc7e9f3fe843abc2b)) - ### Changes -* Debug, mocha, sinon ([ac80c27](https://github.com/snatalenko/node-cqrs/commit/ac80c27653828904cf7b80d37b0ecade860b7490)) * Move DI container to a separate package ([350f3f4](https://github.com/snatalenko/node-cqrs/commit/350f3f405a98fea2c7a85ea92f2b0f1aa945c75c)) * Do not bind masterHandler to observer automatically ([d2ec79d](https://github.com/snatalenko/node-cqrs/commit/d2ec79dced5460f619cf9bed5f34df1bbb8e0132)) * Remove deprecated InMemoryView..markAsReady method ([23015ec](https://github.com/snatalenko/node-cqrs/commit/23015ec3f5bc69f843cf6815caa1f4cda9fea27c)) @@ -191,6 +202,13 @@ * Remove dependency to nodejs EventEmitter ([3fd7cd8](https://github.com/snatalenko/node-cqrs/commit/3fd7cd84bb3c20ec4189bd0083ef83bc07dc62d5)) * Wrap types in NodeCqrs namespace ([74e9b67](https://github.com/snatalenko/node-cqrs/commit/74e9b67833592c030d67fe605f160f99664d9b6c)) +### Fixes + +* Debug output not using toString in Node 12 ([ca0d32f](https://github.com/snatalenko/node-cqrs/commit/ca0d32f78a676faf45a342f4198ef4a93a3d0702)) +* Debug output on one time subscriptions ([2fd7601](https://github.com/snatalenko/node-cqrs/commit/2fd7601b6b8e8059f0b777af6c1294cc78cb787b)) +* Correctly set type of the extended container builder created from container ([1f2f632](https://github.com/snatalenko/node-cqrs/commit/1f2f6325ceab65c4c81494d145261668125d03b1)) +* Moderate security issue in "minimist" dev dependency ([579d523](https://github.com/snatalenko/node-cqrs/commit/579d523745a6d33902a5245bc7e9f3fe843abc2b)) + ### Documentation * Add saga documentation ([e27d1e3](https://github.com/snatalenko/node-cqrs/commit/e27d1e34a0792bec7098535ebec20c97c0f01ed4)) diff --git a/package-lock.json b/package-lock.json index d61ce55..c5944b8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.25", + "version": "1.0.0-rc.26", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.25", + "version": "1.0.0-rc.26", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 4834a21..efca09e 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.25", + "version": "1.0.0-rc.26", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 21686bebb6a0ca5901263f3d382ffe369d62ef85 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 17 Dec 2025 00:14:07 +0000 Subject: [PATCH 118/169] Internal Fix: close rabbitmq connection on SIGINT/SIGTERM --- src/rabbitmq/RabbitMqGateway.ts | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 79142ce..5835b77 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -122,7 +122,7 @@ export class RabbitMqGateway { o.logger; if (o.process) - this.#terminationHandler = new TerminationHandler(o.process, () => this.#stopConsuming()); + this.#terminationHandler = new TerminationHandler(o.process, () => this.disconnect()); } /** @@ -193,7 +193,7 @@ export class RabbitMqGateway { await this.#stopConsuming(); await this.#connection?.close(); if (this.#connection) // clean up in case 'close' event was not triggered - this.#onConnectionClosed(); + this.#cleanup(); this.#logger?.debug(`${this.#appId}: Disconnected from RabbitMQ`); } @@ -230,7 +230,11 @@ export class RabbitMqGateway { } #onConnectionClosed() { - this.#logger?.warn('Connection closed'); + this.#logger?.warn(`${this.#appId}: Connection closed`); + this.#cleanup(); + } + + #cleanup() { this.#connection = undefined; this.#pubChannel = undefined; this.#exclusiveQueueName = undefined; From 78b563783d5d236f77a578ac733f2207a215e7cc Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 17 Dec 2025 00:15:34 +0000 Subject: [PATCH 119/169] 1.0.0-rc.27 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3f1d452..1ded456 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.27](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.26...v1.0.0-rc.27) (2025-12-17) + + +### Internal Fixes + +* Close rabbitmq connection on SIGINT/SIGTERM ([21686be](https://github.com/snatalenko/node-cqrs/commit/21686bebb6a0ca5901263f3d382ffe369d62ef85)) + + # [1.0.0-rc.26](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.25...v1.0.0-rc.26) (2025-12-05) diff --git a/package-lock.json b/package-lock.json index c5944b8..63f2d90 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.26", + "version": "1.0.0-rc.27", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.26", + "version": "1.0.0-rc.27", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index efca09e..5c6ca21 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.26", + "version": "1.0.0-rc.27", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 72c537092c435fe68e343c33ad46d99a1f474b06 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 17 Dec 2025 03:30:21 +0000 Subject: [PATCH 120/169] Chore: Refactor subscription handling, improve logging on subscription removing --- src/rabbitmq/RabbitMqGateway.ts | 54 +++++++++++++++++++-------------- 1 file changed, 31 insertions(+), 23 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 5835b77..dc6914f 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -50,6 +50,16 @@ type Subscription = { handlerProcessTimeout?: number; }; +type EstablishedSubscription = Subscription & { + + /** + * Either a durable queue name or an autogenerated exclusive queue name. + * + * Stays empty until a queue is asserted and a subscription is set up successfully. + */ + queueGivenName?: string; +} + const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); function extractErrorMessage(err: Error | AggregateError | unknown): string { @@ -65,7 +75,8 @@ function extractErrorMessage(err: Error | AggregateError | unknown): string { return String(err); } -const describeSub = (s: Subscription) => `to${s.queueName ? ` queue "${s.queueName}" of` : ''} exchange "${s.exchange}"`; +const describeSub = (s: EstablishedSubscription) => + `to${s.queueName ?? s.queueGivenName ? ` queue "${s.queueName ?? s.queueGivenName}" of` : ''} exchange "${s.exchange}"`; /** * RabbitMqGateway implements the IObservable interface using RabbitMQ. @@ -91,15 +102,7 @@ export class RabbitMqGateway { #queueChannels = new Map(); #queueConsumers = new Map(); - #subscriptions: Array = []; + #subscriptions: Array = []; /** Handles termination signals for graceful shutdown */ #terminationHandler: TerminationHandler | undefined; @@ -359,8 +362,9 @@ export class RabbitMqGateway { this.#subscriptions = this.#subscriptions.filter(s => s !== subscriptionToRemove); - if (subscriptionToRemove.queueGivenName) - await this.#tryDropConsumer(subscriptionToRemove.queueGivenName); + await this.#tryDropConsumer(subscriptionToRemove); + + this.#logger?.debug(`${this.#appId}: Subscription ${describeSub(subscriptionToRemove)} removed`); } async #assertConnection() { @@ -502,25 +506,29 @@ export class RabbitMqGateway { channel, consumerTag: c.consumerTag }); - - this.#terminationHandler?.on(); } - async #tryDropConsumer(queueGivenName: string) { - const queueStillUsed = this.#subscriptions.some(s => s.queueGivenName === queueGivenName); - if (queueStillUsed) + async #tryDropConsumer(subscription: EstablishedSubscription) { + if (!subscription.queueGivenName) { + this.#logger?.warn(`${this.#appId}: Subscription ${describeSub(subscription)} is not bound to a queue`); + return; + } + const queueStillUsed = this.#subscriptions.some(s => s.queueGivenName === subscription.queueGivenName); + if (queueStillUsed) { + this.#logger?.warn(`${this.#appId}: Queue "${subscription.queueGivenName}" has other consumers in this process`); return; + } - const consumer = this.#queueConsumers.get(queueGivenName); - if (!consumer) + const consumer = this.#queueConsumers.get(subscription.queueGivenName); + if (!consumer) { + this.#logger?.warn(`${this.#appId}: Queue "${subscription.queueGivenName}" does not have consumers`); return; + } - this.#queueConsumers.delete(queueGivenName); + this.#queueConsumers.delete(subscription.queueGivenName); await consumer.channel.cancel(consumer.consumerTag); - // If no consumers are active anymore, disable the termination handler - if (!this.#queueConsumers.size) - this.#terminationHandler?.off(); + this.#logger?.warn(`${this.#appId}: Consumer "${consumer.consumerTag}" removed from subscription ${describeSub(subscription)}`); } /** From 8c5dc0c5976d1f3538e81ff284f2bde9ece1fe4d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 17 Dec 2025 03:30:43 +0000 Subject: [PATCH 121/169] 1.0.0-rc.28 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1ded456..f960127 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.28](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.27...v1.0.0-rc.28) (2025-12-17) + + +### Internal Fixes + +* Refactor subscription handling, improve logging on subscription removing ([72c5370](https://github.com/snatalenko/node-cqrs/commit/72c537092c435fe68e343c33ad46d99a1f474b06)) + + # [1.0.0-rc.27](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.26...v1.0.0-rc.27) (2025-12-17) diff --git a/package-lock.json b/package-lock.json index 63f2d90..177c11f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.27", + "version": "1.0.0-rc.28", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.27", + "version": "1.0.0-rc.28", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 5c6ca21..fee5a31 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.27", + "version": "1.0.0-rc.28", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 57d3f3099cc52c19963279a2b4a66c79e5fbd3ee Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 21 Dec 2025 01:24:02 +0000 Subject: [PATCH 122/169] Chore: Enhance logging in RabbitMqGateway and AbstractProjection for better traceability --- src/AbstractProjection.ts | 3 +- src/rabbitmq/RabbitMqGateway.ts | 130 ++++++++++++++++--------------- src/utils/extractErrorDetails.ts | 48 ++++++++++++ src/utils/index.ts | 1 + 4 files changed, 118 insertions(+), 64 deletions(-) create mode 100644 src/utils/extractErrorDetails.ts diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index c7652ed..8b106c4 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -124,8 +124,9 @@ export abstract class AbstractProjection implements IProjection { if (this._viewLocker && !this._viewLocker?.ready) { - this._logger?.debug('view is locked, awaiting until it is ready'); + this._logger?.debug(`view is locked, awaiting until it is ready to process ${describe(event)}`); await this._viewLocker.once('ready'); + this._logger?.debug(`view is ready, processing ${describe(event)}`); } return this._project(event); diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index dc6914f..934b8de 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,7 +1,7 @@ import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; import { IContainer, ILogger, IMessage, isMessage } from '../interfaces'; import * as Event from '../Event'; -import { delay } from '../utils'; +import { delay, extractErrorDetails } from '../utils'; import { TerminationHandler } from './TerminationHandler'; /** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ @@ -62,22 +62,17 @@ type EstablishedSubscription = Subscription & { const isSystemQueue = (queueName: string) => queueName.startsWith('amq.'); -function extractErrorMessage(err: Error | AggregateError | unknown): string { - if (!err || typeof err !== 'object') - return String(err); - - if (err instanceof AggregateError) - return err.errors?.map(e => (e && 'message' in e ? e.message : String(e))).join('; '); - - if (err instanceof Error && err.message) - return err.message; - - return String(err); -} - const describeSub = (s: EstablishedSubscription) => `to${s.queueName ?? s.queueGivenName ? ` queue "${s.queueName ?? s.queueGivenName}" of` : ''} exchange "${s.exchange}"`; +const extractMessageMeta = (msg: ConsumeMessage) => ({ + consumerTag: msg.fields?.consumerTag, + routingKey: msg.fields?.routingKey, + messageId: msg.properties?.messageId, + correlationId: msg.properties?.correlationId, + appId: msg.properties?.appId +}); + /** * RabbitMqGateway implements the IObservable interface using RabbitMQ. * @@ -121,7 +116,7 @@ export class RabbitMqGateway { this.#connectionFactory = o.rabbitMqConnectionFactory; this.#appId = getRandomAppId(); this.#logger = o.logger && 'child' in o.logger ? - o.logger.child({ service: new.target.name }) : + o.logger.child({ service: new.target.name, appId: this.#appId }) : o.logger; if (o.process) @@ -143,7 +138,7 @@ export class RabbitMqGateway { await delay(100); if (this.#connection) { - this.#logger?.debug(`${this.#appId}: Connection is already established`); + this.#logger?.debug('Connection is already established'); return this.#connection; } @@ -154,15 +149,15 @@ export class RabbitMqGateway { this.#connection.on('error', err => this.#onConnectionError(err)); this.#connection.on('close', () => this.#onConnectionClosed()); - this.#logger?.info(`${this.#appId}: Connection established`); + this.#logger?.info('Connection established'); await this.#restoreSubscriptions(); return this.#connection; } catch (err: unknown) { - this.#logger?.error(`${this.#appId}: Connection attempt failed: ${extractErrorMessage(err)}`, { - stack: (err as Error)?.stack + this.#logger?.error('Connection attempt failed', { + error: extractErrorDetails(err) }); throw err; } @@ -182,7 +177,7 @@ export class RabbitMqGateway { await this.#subscribe(subscriptionToRestore); } - this.#logger?.debug(`${this.#appId}: ${this.#subscriptions.length} subscription(s) restored`); + this.#logger?.debug(`${this.#subscriptions.length} subscription(s) restored`); } finally { this.#restoringSubscriptions = false; @@ -191,49 +186,51 @@ export class RabbitMqGateway { async disconnect() { try { - this.#logger?.debug(`${this.#appId}: Disconnecting from RabbitMQ...`); + this.#logger?.debug('Disconnecting from RabbitMQ...'); await this.#stopConsuming(); await this.#connection?.close(); if (this.#connection) // clean up in case 'close' event was not triggered this.#cleanup(); - this.#logger?.debug(`${this.#appId}: Disconnected from RabbitMQ`); + this.#logger?.debug('Disconnected from RabbitMQ'); } catch (err: unknown) { - this.#logger?.error(`${this.#appId}: Failed to disconnect from RabbitMQ: ${extractErrorMessage(err)}`, { - stack: (err as Error)?.stack + this.#logger?.error('Failed to disconnect from RabbitMQ', { + error: extractErrorDetails(err) }); } } async #stopConsuming() { - this.#logger?.info(`${this.#appId}: Stopping all consumers...`); + this.#logger?.info('Stopping all consumers...'); const cancellations = [...this.#queueConsumers.entries()].map(async ([queueName, { channel, consumerTag }]) => { - this.#logger?.debug(`${this.#appId}: Cancelling consumer "${consumerTag}" for queue "${queueName}"`); + this.#logger?.debug(`Cancelling consumer "${consumerTag}" for queue "${queueName}"`); try { await channel.cancel(consumerTag); - this.#logger?.debug(`${this.#appId}: Consumer "${consumerTag}" on queue "${queueName}" cancelled successfully`); + this.#logger?.debug(`Consumer "${consumerTag}" on queue "${queueName}" cancelled successfully`); this.#queueConsumers.delete(queueName); } catch (err: unknown) { - this.#logger?.error(`${this.#appId}: Failed to cancel consumer "${consumerTag}" for queue "${queueName}": ${extractErrorMessage(err)}`); + this.#logger?.error(`Failed to cancel consumer "${consumerTag}" for queue "${queueName}"`, { + error: extractErrorDetails(err) + }); } }); await Promise.all(cancellations); - this.#logger?.info(`${this.#appId}: All consumers stopped.`); + this.#logger?.info('All consumers stopped'); } #onConnectionError(err: unknown) { - this.#logger?.error(`${this.#appId}: Connection error: ${extractErrorMessage(err)}`, { - stack: err instanceof Error ? err.stack : undefined + this.#logger?.error('Connection error', { + error: extractErrorDetails(err) }); } #onConnectionClosed() { - this.#logger?.warn(`${this.#appId}: Connection closed`); + this.#logger?.warn('Connection closed'); this.#cleanup(); } @@ -301,7 +298,7 @@ export class RabbitMqGateway { // record subscription details to restore it if connection attempt fails or on reconnect this.#subscriptions.push(subscription); - this.#logger?.debug(`${this.#appId}: Subscription ${describeSub(subscription)} recorded`); + this.#logger?.debug(`Subscription ${describeSub(subscription)} recorded`); const { exchange, @@ -344,7 +341,7 @@ export class RabbitMqGateway { if (subscriptionRecord) subscriptionRecord.queueGivenName = queueGivenName; - this.#logger?.debug(`${this.#appId}: Subscription ${describeSub(subscription)} established`); + this.#logger?.debug(`Subscription ${describeSub(subscription)} established`); } #findSubscription(subscription: Pick) { @@ -364,7 +361,7 @@ export class RabbitMqGateway { await this.#tryDropConsumer(subscriptionToRemove); - this.#logger?.debug(`${this.#appId}: Subscription ${describeSub(subscriptionToRemove)} removed`); + this.#logger?.debug(`Subscription ${describeSub(subscriptionToRemove)} removed`); } async #assertConnection() { @@ -428,7 +425,7 @@ export class RabbitMqGateway { await channel.bindQueue(queueGivenName, exchange, eventType); - this.#logger?.debug(`${this.#appId}: Queue "${queueGivenName}" bound to exchange "${exchange}" with pattern "${eventType}"`); + this.#logger?.debug(`Queue "${queueGivenName}" bound to exchange "${exchange}" with pattern "${eventType}"`); } async #assertConsumer( @@ -446,29 +443,20 @@ export class RabbitMqGateway { if (!msg) return; - const { consumerTag, routingKey } = msg.fields ?? {}; - const { messageId, correlationId, appId } = msg.properties ?? {}; - // Keep the process alive while waiting for the handler to finish const handlerProcessTimeout = options?.handlerProcessTimeout ?? RabbitMqGateway.HANDLER_PROCESS_TIMEOUT; const keepAliveTimeout = setTimeout(() => { - this.#logger?.warn(`${this.#appId}: Message processing timed out`, { + this.#logger?.error('Message processing timed out', { queueName: queueGivenName, - consumerTag, - routingKey, - messageId + msg: extractMessageMeta(msg) }); - channel.nack(msg, false, false); + this.#rejectMessage(channel, msg); }, handlerProcessTimeout); try { - this.#logger?.debug(`${this.#appId}: Message received`, { + this.#logger?.debug('Message received', { queueName: queueGivenName, - consumerTag, - routingKey, - messageId, - correlationId, - appId + msg: extractMessageMeta(msg) }); const jsonContent = msg.content.toString(); @@ -479,19 +467,22 @@ export class RabbitMqGateway { throw new Error(`Message from queue "${queueGivenName}" was delivered to a consumer that does not handle type "${message.type}"`); for (const { handler, ignoreOwn } of handlers) { - if (ignoreOwn && appId === this.#appId) + if (ignoreOwn && msg.properties.appId === this.#appId) continue; await handler(message); } - channel?.ack(msg); + channel.ack(msg); } catch (err: unknown) { - this.#logger?.error(`${this.#appId}: Message processing failed: ${extractErrorMessage(err)}`); + this.#logger?.error('Message processing failed', { + error: extractErrorDetails(err), + queueName: queueGivenName, + msg: extractMessageMeta(msg) + }); - // Redirect message to dead letter queue, if `{ noAck: true }` was not set on consumption - channel?.nack(msg, false, false); + this.#rejectMessage(channel, msg); } finally { clearTimeout(keepAliveTimeout); @@ -500,7 +491,7 @@ export class RabbitMqGateway { noAck: options?.noAck }); - this.#logger?.debug(`${this.#appId}: Consumer "${c.consumerTag}" registered on queue "${queueGivenName}"`); + this.#logger?.debug(`Consumer "${c.consumerTag}" registered on queue "${queueGivenName}"`); this.#queueConsumers.set(queueGivenName, { channel, @@ -508,27 +499,40 @@ export class RabbitMqGateway { }); } + /** Reject a message, causing it to be dead-lettered or discarded */ + #rejectMessage(channel: Channel, msg: ConsumeMessage) { + try { + channel.nack(msg, false, false); + } + catch (err: unknown) { + this.#logger?.warn('Failed to reject message', { + error: extractErrorDetails(err), + msg: extractMessageMeta(msg) + }); + } + } + async #tryDropConsumer(subscription: EstablishedSubscription) { if (!subscription.queueGivenName) { - this.#logger?.warn(`${this.#appId}: Subscription ${describeSub(subscription)} is not bound to a queue`); + this.#logger?.warn(`Subscription ${describeSub(subscription)} is not bound to a queue`); return; } const queueStillUsed = this.#subscriptions.some(s => s.queueGivenName === subscription.queueGivenName); if (queueStillUsed) { - this.#logger?.warn(`${this.#appId}: Queue "${subscription.queueGivenName}" has other consumers in this process`); + this.#logger?.warn(`Queue "${subscription.queueGivenName}" has other consumers in this process`); return; } const consumer = this.#queueConsumers.get(subscription.queueGivenName); if (!consumer) { - this.#logger?.warn(`${this.#appId}: Queue "${subscription.queueGivenName}" does not have consumers`); + this.#logger?.warn(`Queue "${subscription.queueGivenName}" does not have consumers`); return; } this.#queueConsumers.delete(subscription.queueGivenName); await consumer.channel.cancel(consumer.consumerTag); - this.#logger?.warn(`${this.#appId}: Consumer "${consumer.consumerTag}" removed from subscription ${describeSub(subscription)}`); + this.#logger?.info(`Consumer "${consumer.consumerTag}" removed from subscription ${describeSub(subscription)}`); } /** @@ -564,14 +568,14 @@ export class RabbitMqGateway { return new Promise((resolve, reject) => { if (!this.#pubChannel) - throw new Error(`${this.#appId}: No channel available for publishing`); + throw new Error('No channel available for publishing'); - this.#logger?.debug(`${this.#appId}: Publishing message "${Event.describe(message)}" to exchange "${exchange}"`); + this.#logger?.debug(`Publishing message "${Event.describe(message)}" to exchange "${exchange}"`); const published = this.#pubChannel.publish(exchange, message.type, content, properties, err => (err ? reject(err) : resolve())); if (!published) - throw new Error(`${this.#appId}: Failed to send event ${Event.describe(message)}, channel buffer is full`); + throw new Error(`Failed to send event ${Event.describe(message)}, channel buffer is full`); }); } } diff --git a/src/utils/extractErrorDetails.ts b/src/utils/extractErrorDetails.ts new file mode 100644 index 0000000..bbe90c6 --- /dev/null +++ b/src/utils/extractErrorDetails.ts @@ -0,0 +1,48 @@ +const extractErrorName = (err: unknown): string | undefined => { + 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: unknown): string => { + 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 type ErrorDetails = { + name?: string, + message: string, + code?: any, + stack?: string, + cause?: ErrorDetails +}; + +export const extractErrorDetails = (err: unknown): ErrorDetails => ({ + 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) + } +}); diff --git a/src/utils/index.ts b/src/utils/index.ts index ada7ab1..b987ba6 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -11,3 +11,4 @@ export * from './notEmpty'; export * from './setupOneTimeEmitterSubscription'; export * from './subscribe'; export * from './validateHandlers'; +export * from './extractErrorDetails'; From 1fd59923a820d0f1f0b111b335c021ebf3e0c0fe Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 21 Dec 2025 01:24:14 +0000 Subject: [PATCH 123/169] 1.0.0-rc.29 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f960127..6010574 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.29](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.28...v1.0.0-rc.29) (2025-12-21) + + +### Internal Fixes + +* Enhance logging in RabbitMqGateway and AbstractProjection for better traceability ([57d3f30](https://github.com/snatalenko/node-cqrs/commit/57d3f3099cc52c19963279a2b4a66c79e5fbd3ee)) + + # [1.0.0-rc.28](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.27...v1.0.0-rc.28) (2025-12-17) diff --git a/package-lock.json b/package-lock.json index 177c11f..aa73592 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.28", + "version": "1.0.0-rc.29", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.28", + "version": "1.0.0-rc.29", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index fee5a31..525163b 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.28", + "version": "1.0.0-rc.29", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 35a974b15ab650728768d1efd655b45a6df052fb Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 21 Dec 2025 23:12:26 +0000 Subject: [PATCH 124/169] Internal Fix: MQ consumption starts before handler is properly recorded --- src/rabbitmq/RabbitMqGateway.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 934b8de..ed32aa7 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -335,12 +335,12 @@ export class RabbitMqGateway { await this.#assetQueue(channel, exchange, queueGivenName, eventType, { deadLetterExchangeName }); } - await this.#assertConsumer(queueGivenName, channel, subscription); - const subscriptionRecord = this.#findSubscription(subscription); if (subscriptionRecord) subscriptionRecord.queueGivenName = queueGivenName; + await this.#assertConsumer(queueGivenName, channel, subscription); + this.#logger?.debug(`Subscription ${describeSub(subscription)} established`); } From 63b4f48f1abc6936472db66e821de2543dbc874b Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 22 Dec 2025 00:01:19 +0000 Subject: [PATCH 125/169] Internal Fix: RabbitMQ connection not auto-closing on SIGTERM --- src/rabbitmq/RabbitMqGateway.ts | 7 ++--- src/rabbitmq/TerminationHandler.ts | 37 ----------------------- src/rabbitmq/utils/index.ts | 1 + src/rabbitmq/utils/registerExitCleanup.ts | 29 ++++++++++++++++++ 4 files changed, 32 insertions(+), 42 deletions(-) delete mode 100644 src/rabbitmq/TerminationHandler.ts create mode 100644 src/rabbitmq/utils/index.ts create mode 100644 src/rabbitmq/utils/registerExitCleanup.ts diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index ed32aa7..614e246 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -2,7 +2,7 @@ import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; import { IContainer, ILogger, IMessage, isMessage } from '../interfaces'; import * as Event from '../Event'; import { delay, extractErrorDetails } from '../utils'; -import { TerminationHandler } from './TerminationHandler'; +import { registerExitCleanup } from './utils'; /** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ const getRandomAppId = () => @@ -99,8 +99,6 @@ export class RabbitMqGateway { #subscriptions: Array = []; - /** Handles termination signals for graceful shutdown */ - #terminationHandler: TerminationHandler | undefined; #restoringSubscriptions: boolean = false; get connection() { @@ -119,8 +117,7 @@ export class RabbitMqGateway { o.logger.child({ service: new.target.name, appId: this.#appId }) : o.logger; - if (o.process) - this.#terminationHandler = new TerminationHandler(o.process, () => this.disconnect()); + registerExitCleanup(o.process, () => this.disconnect()); } /** diff --git a/src/rabbitmq/TerminationHandler.ts b/src/rabbitmq/TerminationHandler.ts deleted file mode 100644 index 693fe5a..0000000 --- a/src/rabbitmq/TerminationHandler.ts +++ /dev/null @@ -1,37 +0,0 @@ -/** - * Handles graceful termination of a Node.js process. - * Listens for SIGINT and executes a cleanup routine before allowing the process to exit. - */ -export class TerminationHandler { - - #process: NodeJS.Process; - #cleanupHandler: () => Promise; - #terminationHandler: () => Promise; - #subscribed = false; - - constructor(process: NodeJS.Process, cleanupHandler: () => Promise) { - this.#process = process; - this.#cleanupHandler = cleanupHandler; - this.#terminationHandler = this.#onProcessTermination.bind(this); - } - - on() { - if (this.#subscribed) - return; - - this.#process.once('SIGINT', this.#terminationHandler); - this.#process.once('SIGTERM', this.#terminationHandler); - this.#subscribed = true; - } - - off() { - this.#process.off('SIGINT', this.#terminationHandler); - this.#process.off('SIGTERM', this.#terminationHandler); - this.#subscribed = false; - } - - async #onProcessTermination() { - this.off(); - await this.#cleanupHandler(); - } -} diff --git a/src/rabbitmq/utils/index.ts b/src/rabbitmq/utils/index.ts new file mode 100644 index 0000000..807ea15 --- /dev/null +++ b/src/rabbitmq/utils/index.ts @@ -0,0 +1 @@ +export * from './registerExitCleanup'; diff --git a/src/rabbitmq/utils/registerExitCleanup.ts b/src/rabbitmq/utils/registerExitCleanup.ts new file mode 100644 index 0000000..7f3982d --- /dev/null +++ b/src/rabbitmq/utils/registerExitCleanup.ts @@ -0,0 +1,29 @@ +/** + * 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. + */ +export const registerExitCleanup = ( + process: NodeJS.Process | undefined, + cleanupProcedure: () => Promise | unknown +) => { + 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); + } + }; +}; From 1e3a548278670d0ae7e20bf6460f66ba082f4aee Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 22 Dec 2025 00:01:33 +0000 Subject: [PATCH 126/169] 1.0.0-rc.30 --- CHANGELOG.md | 9 +++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6010574..9c309ca 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,12 @@ +# [1.0.0-rc.30](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.29...v1.0.0-rc.30) (2025-12-22) + + +### Internal Fixes + +* MQ consumption starts before handler is properly recorded ([35a974b](https://github.com/snatalenko/node-cqrs/commit/35a974b15ab650728768d1efd655b45a6df052fb)) +* RabbitMQ connection not auto-closing on SIGTERM ([63b4f48](https://github.com/snatalenko/node-cqrs/commit/63b4f48f1abc6936472db66e821de2543dbc874b)) + + # [1.0.0-rc.29](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.28...v1.0.0-rc.29) (2025-12-21) diff --git a/package-lock.json b/package-lock.json index aa73592..01a10eb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.29", + "version": "1.0.0-rc.30", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.29", + "version": "1.0.0-rc.30", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 525163b..a3d9a14 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.29", + "version": "1.0.0-rc.30", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From ba8053697fb271a57fde7fc236d0f15c7d497c8e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 22 Dec 2025 22:31:56 +0000 Subject: [PATCH 127/169] Change: Auto-reconnect to RabbitMQ --- src/rabbitmq/RabbitMqGateway.ts | 72 +++++++++++++++++++++++++++++++-- 1 file changed, 68 insertions(+), 4 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 614e246..512d63f 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -73,6 +73,10 @@ const extractMessageMeta = (msg: ConsumeMessage) => ({ appId: msg.properties?.appId }); +interface RabbitMqGatewayConnected { + get connection(): ChannelModel; +} + /** * RabbitMqGateway implements the IObservable interface using RabbitMQ. * @@ -85,12 +89,19 @@ export class RabbitMqGateway { static HANDLER_PROCESS_TIMEOUT = 60 * 60 * 1000; // 1 hour static ALL_EVENTS_WILDCARD = '*'; + static RECONNECT_DELAY = 30_000; // 30 sec #connectionFactory: () => Promise; #appId: string; #logger: ILogger | undefined; #connecting = false; + #desiredState: 'connected' | 'disconnected' = 'disconnected'; + + /** + * Established connection to RabbitMQ. + * If empty, the gateway is not connected. + */ #connection: ChannelModel | undefined; #pubChannel: ConfirmChannel | undefined; #exclusiveQueueName: string | undefined; @@ -101,10 +112,14 @@ export class RabbitMqGateway { #restoringSubscriptions: boolean = false; - get connection() { + get connection(): ChannelModel | undefined { return this.#connection; } + isConnected(): this is this & RabbitMqGatewayConnected { + return !!this.#connection; + } + constructor(o: Partial> & { rabbitMqConnectionFactory?: () => Promise }) { @@ -131,6 +146,9 @@ export class RabbitMqGateway { * @returns A promise that resolves with the ChannelModel representing the established connection. */ async connect(): Promise { + this.#desiredState = 'connected'; + this.#clearReconnectTimer(); + while (this.#connecting) await delay(100); @@ -156,6 +174,10 @@ export class RabbitMqGateway { this.#logger?.error('Connection attempt failed', { error: extractErrorDetails(err) }); + + if (this.#desiredState === 'connected') + this.#scheduleReconnect(); + throw err; } finally { @@ -163,6 +185,33 @@ export class RabbitMqGateway { } } + #reconnectTimeout: NodeJS.Timeout | undefined; + + #clearReconnectTimer() { + if (!this.#reconnectTimeout) + return; + + clearTimeout(this.#reconnectTimeout); + this.#reconnectTimeout = undefined; + } + + #scheduleReconnect() { + if (this.#desiredState !== 'connected') + return; + + this.#clearReconnectTimer(); + + this.#logger?.debug(`Scheduling reconnect in ${RabbitMqGateway.RECONNECT_DELAY / 1000} seconds`); + this.#reconnectTimeout = setTimeout(() => this.#reconnect(), RabbitMqGateway.RECONNECT_DELAY).unref(); + } + + #reconnect() { + if (this.#desiredState !== 'connected' || this.isConnected() || this.#connecting) + return; + + this.connect().catch(() => undefined); + } + async #restoreSubscriptions() { this.#restoringSubscriptions = true; try { @@ -182,11 +231,23 @@ export class RabbitMqGateway { } async disconnect() { + this.#desiredState = 'disconnected'; + this.#clearReconnectTimer(); + + while (this.#connecting) + await delay(100); + + if (!this.#connection) { + this.#logger?.debug('Connection is not established'); + return; + } + try { this.#logger?.debug('Disconnecting from RabbitMQ...'); await this.#stopConsuming(); - await this.#connection?.close(); + await this.#connection.close(); + if (this.#connection) // clean up in case 'close' event was not triggered this.#cleanup(); @@ -200,7 +261,7 @@ export class RabbitMqGateway { } async #stopConsuming() { - this.#logger?.info('Stopping all consumers...'); + this.#logger?.debug('Stopping all consumers...'); const cancellations = [...this.#queueConsumers.entries()].map(async ([queueName, { channel, consumerTag }]) => { this.#logger?.debug(`Cancelling consumer "${consumerTag}" for queue "${queueName}"`); @@ -227,8 +288,11 @@ export class RabbitMqGateway { } #onConnectionClosed() { - this.#logger?.warn('Connection closed'); + this.#logger?.info('Connection closed'); this.#cleanup(); + + if (this.#desiredState === 'connected') + this.#reconnect(); } #cleanup() { From d591e565d27c70a74ae401b10bb84742b13a922b Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 22 Dec 2025 22:32:09 +0000 Subject: [PATCH 128/169] 1.0.0-rc.31 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9c309ca..0c6ec6c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.31](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.30...v1.0.0-rc.31) (2025-12-22) + + +### Changes + +* Auto-reconnect to RabbitMQ ([ba80536](https://github.com/snatalenko/node-cqrs/commit/ba8053697fb271a57fde7fc236d0f15c7d497c8e)) + + # [1.0.0-rc.30](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.29...v1.0.0-rc.30) (2025-12-22) diff --git a/package-lock.json b/package-lock.json index 01a10eb..28f2ed5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.30", + "version": "1.0.0-rc.31", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.30", + "version": "1.0.0-rc.31", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index a3d9a14..5a5aea6 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.30", + "version": "1.0.0-rc.31", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 196332e1f382880161e0f7192966e2fb4f222be7 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 1 Jan 2026 17:16:20 +0000 Subject: [PATCH 129/169] Chore: Update Lock interface to support resource management with `using` keyword --- src/utils/Lock.ts | 19 ++++++++++++++++++- tests/unit/Lock.test.ts | 14 +++++++------- 2 files changed, 25 insertions(+), 8 deletions(-) diff --git a/src/utils/Lock.ts b/src/utils/Lock.ts index eafeedc..2db3489 100644 --- a/src/utils/Lock.ts +++ b/src/utils/Lock.ts @@ -1,5 +1,20 @@ import { Deferred } from './Deferred'; +export class LockLease { + constructor( + readonly lock: Lock, + readonly name?: string + ) { } + + release() { + this.lock.release(this.name); + } + + [Symbol.dispose]() { + this.release(); + } +} + export class Lock { /** @@ -36,7 +51,7 @@ export class Lock { * * @returns Promise that resolves once lock is acquired */ - async acquire(name?: string): Promise { + async acquire(name?: string): Promise { while (this.#globalLockAcquiringLock) await this.#globalLockAcquiringLock.promise; @@ -60,6 +75,8 @@ export class Lock { this.#globalLockAcquiringLock?.resolve(); this.#globalLockAcquiringLock = undefined; } + + return new LockLease(this, name); } /** diff --git a/tests/unit/Lock.test.ts b/tests/unit/Lock.test.ts index 1b56315..0efeb91 100644 --- a/tests/unit/Lock.test.ts +++ b/tests/unit/Lock.test.ts @@ -47,8 +47,8 @@ describe('Lock', () => { await l3; // Wait for l3 to fully complete // Ensure both promises associated with acquire calls are resolved - await expect(l2).resolves.toBeUndefined(); - await expect(l3).resolves.toBeUndefined(); + await expect(l2).resolves.not.toThrow(); + await expect(l3).resolves.not.toThrow(); }); }); @@ -178,11 +178,11 @@ describe('Lock', () => { await lock.release(); // Ensure all original promises eventually resolve - await expect(p2).resolves.toBeUndefined(); - await expect(p3).resolves.toBeUndefined(); - await expect(l4).resolves.toBeUndefined(); - await expect(p5).resolves.toBeUndefined(); - await expect(l6).resolves.toBeUndefined(); + await expect(p2).resolves.not.toThrow(); + await expect(p3).resolves.not.toThrow(); + await expect(l4).resolves.not.toThrow(); + await expect(p5).resolves.not.toThrow(); + await expect(l6).resolves.not.toThrow(); }); }); }); From cbfd0bf39c12419f5b15a6c0e15554ae70f52609 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 1 Jan 2026 17:16:43 +0000 Subject: [PATCH 130/169] Fix rabbitmq consumer cancellation test --- .../rabbitmq/RabbitMqGateway.test.ts | 44 +++++++++++++------ 1 file changed, 30 insertions(+), 14 deletions(-) diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index f04872f..bc717b2 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -311,8 +311,20 @@ describe('RabbitMqGateway', () => { it('cancels consumer when unsubscribing the last subscription on a queue', async () => { - const processOnSpy = jest.spyOn(process, 'once'); - const processOffSpy = jest.spyOn(process, 'off'); + await gateway1.connect(); + + const cancelledConsumerTags: string[] = []; + const connection = gateway1.connection!; + const originalCreateChannel = connection.createChannel.bind(connection); + (connection as any).createChannel = async () => { + const ch = await originalCreateChannel(); + const originalCancel = ch.cancel.bind(ch); + (ch as any).cancel = async (consumerTag: string) => { + cancelledConsumerTags.push(consumerTag); + return originalCancel(consumerTag); + }; + return ch; + }; const received1: IMessage[] = []; const received2: IMessage[] = []; @@ -326,37 +338,40 @@ describe('RabbitMqGateway', () => { const event1 = { type: 'test.unsubscribe', - payload: { info: 'event for handler2' }, + payload: { info: 'event for handlers' }, context: { ts: Date.now() } }; - // Subscribe both handlers to the same durable queue await gateway1.subscribe({ exchange, + queueName, eventType: event1.type, handler: handler1 }); await gateway1.subscribe({ exchange, + queueName, eventType: event1.type, handler: handler2 }); - expect(processOnSpy).toHaveBeenCalledWith('SIGINT', expect.any(Function)); - expect(processOnSpy).toHaveBeenCalledWith('SIGTERM', expect.any(Function)); - expect(processOnSpy).toHaveBeenCalledTimes(2); - expect(processOffSpy).not.toHaveBeenCalled(); + await gateway1.publish(exchange, event1); + await delay(50); + + expect(received1).toEqual([event1]); + expect(received2).toEqual([event1]); - // Unsubscribe one handler; the queue should still be active await gateway1.unsubscribe({ exchange, + queueName, eventType: event1.type, handler: handler1 }); - expect(processOffSpy).not.toHaveBeenCalled(); + expect(cancelledConsumerTags).toHaveLength(0); - // Publish an event; only handler2 should receive it + received1.length = 0; + received2.length = 0; await gateway1.publish(exchange, event1); await delay(50); @@ -364,22 +379,23 @@ describe('RabbitMqGateway', () => { expect(received1).toEqual([]); expect(received2).toEqual([event1]); - // Now unsubscribe the last handler; this should cancel the consumer for the queue await gateway1.unsubscribe({ exchange, + queueName, eventType: event1.type, handler: handler2 }); - expect(processOffSpy).toHaveBeenCalledWith('SIGINT', expect.any(Function)); + expect(cancelledConsumerTags).toHaveLength(1); - // Publish a second event; no handler should receive it because the consumer is cancelled + received1.length = 0; received2.length = 0; await gateway1.publish(exchange, event1); await delay(50); expect(received1).toEqual([]); + expect(received2).toEqual([]); }); }); From 42fe3497ce886bc4e20efa6008b97104380a8ba5 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 9 Jan 2026 02:36:01 +0000 Subject: [PATCH 131/169] Chore: Expose connection state events on RabbitMqGateway --- src/rabbitmq/RabbitMqGateway.ts | 137 +++++++++++++++++++++----------- 1 file changed, 89 insertions(+), 48 deletions(-) diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 512d63f..78b49ce 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,8 +1,9 @@ import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; import { IContainer, ILogger, IMessage, isMessage } from '../interfaces'; import * as Event from '../Event'; -import { delay, extractErrorDetails } from '../utils'; +import { extractErrorDetails, Lock } from '../utils'; import { registerExitCleanup } from './utils'; +import { EventEmitter } from 'events'; /** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ const getRandomAppId = () => @@ -77,6 +78,11 @@ interface RabbitMqGatewayConnected { get connection(): ChannelModel; } +type GatewayEvents = { + connected: []; + disconnected: [reason?: string]; +}; + /** * RabbitMqGateway implements the IObservable interface using RabbitMQ. * @@ -94,9 +100,10 @@ export class RabbitMqGateway { #connectionFactory: () => Promise; #appId: string; #logger: ILogger | undefined; + #emitter: EventEmitter; - #connecting = false; #desiredState: 'connected' | 'disconnected' = 'disconnected'; + #stateChangeLock = new Lock(); /** * Established connection to RabbitMQ. @@ -110,8 +117,6 @@ export class RabbitMqGateway { #subscriptions: Array = []; - #restoringSubscriptions: boolean = false; - get connection(): ChannelModel | undefined { return this.#connection; } @@ -121,11 +126,13 @@ export class RabbitMqGateway { } constructor(o: Partial> & { - rabbitMqConnectionFactory?: () => Promise + rabbitMqConnectionFactory?: () => Promise, + eventEmitterFactory?: () => EventEmitter }) { if (!o.rabbitMqConnectionFactory) throw new TypeError('rabbitMqConnectionFactory argument required'); + this.#emitter = o?.eventEmitterFactory?.() ?? new EventEmitter(); this.#connectionFactory = o.rabbitMqConnectionFactory; this.#appId = getRandomAppId(); this.#logger = o.logger && 'child' in o.logger ? @@ -149,25 +156,34 @@ export class RabbitMqGateway { this.#desiredState = 'connected'; this.#clearReconnectTimer(); - while (this.#connecting) - await delay(100); + const lease = await this.#stateChangeLock.acquire(); + try { + if (this.#connection) { + this.#logger?.debug('Connection is already established'); + return this.#connection; + } - if (this.#connection) { - this.#logger?.debug('Connection is already established'); - return this.#connection; + return await this.#connect(); } + finally { + lease.release(); + } + } - this.#connecting = true; - + async #connect(): Promise { try { - this.#connection = await this.#connectionFactory(); - this.#connection.on('error', err => this.#onConnectionError(err)); - this.#connection.on('close', () => this.#onConnectionClosed()); + const connection = await this.#connectionFactory(); + connection.on('error', err => this.#onConnectionError(err)); + connection.on('close', () => this.#onConnectionClosed(connection)); + + this.#connection = connection; this.#logger?.info('Connection established'); await this.#restoreSubscriptions(); + this.#emitter.emit('connected'); + return this.#connection; } catch (err: unknown) { @@ -180,9 +196,6 @@ export class RabbitMqGateway { throw err; } - finally { - this.#connecting = false; - } } #reconnectTimeout: NodeJS.Timeout | undefined; @@ -206,43 +219,36 @@ export class RabbitMqGateway { } #reconnect() { - if (this.#desiredState !== 'connected' || this.isConnected() || this.#connecting) + if (this.#desiredState !== 'connected' || this.isConnected()) return; this.connect().catch(() => undefined); } async #restoreSubscriptions() { - this.#restoringSubscriptions = true; - try { - for (let i = 0; i < this.#subscriptions.length; i++) { - const subscriptionToRestore = this.#subscriptions.shift(); - if (!subscriptionToRestore) // should never happen; check is for type consistency - continue; + for (let i = 0; i < this.#subscriptions.length; i++) { + const subscriptionToRestore = this.#subscriptions.shift(); + if (!subscriptionToRestore) // should never happen; check is for type consistency + continue; - await this.#subscribe(subscriptionToRestore); - } - - this.#logger?.debug(`${this.#subscriptions.length} subscription(s) restored`); - } - finally { - this.#restoringSubscriptions = false; + await this.#subscribe(subscriptionToRestore); } + + this.#logger?.debug(`${this.#subscriptions.length} subscription(s) restored`); } async disconnect() { this.#desiredState = 'disconnected'; this.#clearReconnectTimer(); - while (this.#connecting) - await delay(100); - - if (!this.#connection) { - this.#logger?.debug('Connection is not established'); - return; - } + const lease = await this.#stateChangeLock.acquire(); try { + if (!this.#connection) { + this.#logger?.debug('Connection is not established'); + return; + } + this.#logger?.debug('Disconnecting from RabbitMQ...'); await this.#stopConsuming(); @@ -252,12 +258,16 @@ export class RabbitMqGateway { this.#cleanup(); this.#logger?.debug('Disconnected from RabbitMQ'); + this.#emitter.emit('disconnected', 'Disconnected by request'); } catch (err: unknown) { this.#logger?.error('Failed to disconnect from RabbitMQ', { error: extractErrorDetails(err) }); } + finally { + lease.release(); + } } async #stopConsuming() { @@ -287,12 +297,17 @@ export class RabbitMqGateway { }); } - #onConnectionClosed() { + #onConnectionClosed(connection: ChannelModel) { + if (connection !== this.#connection) + return; + this.#logger?.info('Connection closed'); this.#cleanup(); - if (this.#desiredState === 'connected') + if (this.#desiredState === 'connected') { + this.#emitter.emit('disconnected', 'Connection closed'); this.#reconnect(); + } } #cleanup() { @@ -346,10 +361,19 @@ export class RabbitMqGateway { * @returns A promise that resolves when the subscription is successfully set up. */ async subscribe(subscription: Subscription) { - while (this.#restoringSubscriptions) - await delay(100); + this.#desiredState = 'connected'; + this.#clearReconnectTimer(); + + const lease = await this.#stateChangeLock.acquire(); + try { + if (!this.#connection) + await this.#connect(); - return this.#subscribe(subscription); + await this.#subscribe(subscription); + } + finally { + lease.release(); + } } async #subscribe(subscription: Subscription) { @@ -367,7 +391,7 @@ export class RabbitMqGateway { eventType } = subscription; - const channel = await this.#assertChannel(queueName); + const channel = await this.#assertQueueChannel(queueName); let queueGivenName = queueName; if (!queueGivenName) { @@ -430,11 +454,13 @@ export class RabbitMqGateway { } /** Get existing or open a new channel for a given queue name */ - async #assertChannel(queueName: string = ''): Promise { - const connection = await this.#assertConnection(); + async #assertQueueChannel(queueName: string = ''): Promise { let channel = this.#queueChannels.get(queueName); if (!channel) { - channel = await connection.createChannel(); + if (!this.#connection) + throw new Error('No connection established to create channel'); + + channel = await this.#connection.createChannel(); this.#queueChannels.set(queueName, channel); } return channel; @@ -639,4 +665,19 @@ export class RabbitMqGateway { throw new Error(`Failed to send event ${Event.describe(message)}, channel buffer is full`); }); } + + on(event: K, fn: (...args: GatewayEvents[K]) => void) { + this.#emitter.on(event, fn as any); + return this; + } + + once(event: K, fn: (...args: GatewayEvents[K]) => void) { + this.#emitter.once(event, fn as any); + return this; + } + + off(event: K, fn: (...args: GatewayEvents[K]) => void) { + this.#emitter.off(event, fn as any); + return this; + } } From 1e2e992fb9462dfd50b0b5188380106d21609a0a Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Fri, 9 Jan 2026 05:07:59 +0000 Subject: [PATCH 132/169] 1.0.0-rc.32 --- CHANGELOG.md | 9 +++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0c6ec6c..6bcebb1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,12 @@ +# [1.0.0-rc.32](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.31...v1.0.0-rc.32) (2026-01-09) + + +### Internal Fixes + +* Update Lock interface to support resource management with `using` keyword ([196332e](https://github.com/snatalenko/node-cqrs/commit/196332e1f382880161e0f7192966e2fb4f222be7)) +* Expose connection state events on RabbitMqGateway ([42fe349](https://github.com/snatalenko/node-cqrs/commit/42fe3497ce886bc4e20efa6008b97104380a8ba5)) + + # [1.0.0-rc.31](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.30...v1.0.0-rc.31) (2025-12-22) diff --git a/package-lock.json b/package-lock.json index 28f2ed5..12fb1ea 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.31", + "version": "1.0.0-rc.32", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.31", + "version": "1.0.0-rc.32", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 5a5aea6..87fc2a1 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.31", + "version": "1.0.0-rc.32", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From 1e0d55b645290eb4c375c12d5370a6fa57fe9c4f Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 15 Jan 2026 00:01:35 +0000 Subject: [PATCH 133/169] WIP on AbstractWorkerProjection that spawns worker process --- package.json | 8 ++ src/workers/AbstractWorkerProjection.ts | 135 ++++++++++++++++++ src/workers/exposeWorkerProjection.ts | 53 +++++++ src/workers/index.ts | 3 + src/workers/protocol.ts | 26 ++++ .../AbstractWorkerProjectionBootstrap.test.ts | 40 ++++++ .../workers/fixtures/ProjectionFixture.cjs | 30 ++++ 7 files changed, 295 insertions(+) create mode 100644 src/workers/AbstractWorkerProjection.ts create mode 100644 src/workers/exposeWorkerProjection.ts create mode 100644 src/workers/index.ts create mode 100644 src/workers/protocol.ts create mode 100644 tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts create mode 100644 tests/unit/workers/fixtures/ProjectionFixture.cjs diff --git a/package.json b/package.json index 87fc2a1..efa4bdc 100644 --- a/package.json +++ b/package.json @@ -14,6 +14,9 @@ "types": "./types/index.d.ts", "typesVersions": { "*": { + "workers": [ + "types/workers/index.d.ts" + ], "rabbitmq": [ "types/rabbitmq/index.d.ts" ], @@ -28,6 +31,11 @@ "import": "./dist/index.js", "types": "./types/index.d.ts" }, + "./workers": { + "require": "./dist/workers/index.js", + "import": "./dist/workers/index.js", + "types": "./types/workers/index.d.ts" + }, "./rabbitmq": { "require": "./dist/rabbitmq/index.js", "import": "./dist/rabbitmq/index.js", diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts new file mode 100644 index 0000000..b8473ed --- /dev/null +++ b/src/workers/AbstractWorkerProjection.ts @@ -0,0 +1,135 @@ +import * as path from 'node:path'; +import { isMainThread, Worker } from 'node:worker_threads'; + +import { AbstractProjection, type AbstractProjectionParams } from '../AbstractProjection'; +import type { WorkerInitMessage, WorkerOutboundMessage } from './protocol'; + +export type AbstractWorkerProjectionParams = AbstractProjectionParams & { + + /** + * Required in the main thread to spawn a worker (derived projection module path). + * Not used in the worker thread. + */ + workerModulePath?: string; +}; + +export abstract class AbstractWorkerProjection extends AbstractProjection { + + readonly #workerModulePath?: string; + + #worker?: Worker; + #workerReady?: Promise; + + protected get _worker(): Worker | undefined { + return this.#worker; + } + + constructor({ + workerModulePath, + view, + viewLocker, + eventLocker, + logger + }: AbstractWorkerProjectionParams = {}) { + if (isMainThread && (typeof workerModulePath !== 'string' || !workerModulePath.length)) + throw new TypeError('workerModulePath parameter is required in the main thread'); + + super({ + view, + viewLocker, + eventLocker, + logger + }); + + this.#workerModulePath = workerModulePath; + + if (isMainThread) + this.ensureWorkerReady().catch(() => {}); + + } + + async ensureWorkerReady(): Promise { + if (!isMainThread) + throw new Error('_ensureWorkerReady can only be called from the main thread'); + + this.#workerReady ??= this._startWorkerAndHandshake(); + + return this.#workerReady; + } + + async dispose(): Promise { + const worker = this.#worker; + this.#worker = undefined; + this.#workerReady = undefined; + + if (worker) + await worker.terminate(); + } + + protected _getWorkerEntrypoint(): string { + const workerModulePath = this.#workerModulePath; + if (typeof workerModulePath !== 'string' || !workerModulePath.length) + throw new Error('workerModulePath is required to start worker'); + + return path.isAbsolute(workerModulePath) ? + workerModulePath : + path.resolve(process.cwd(), workerModulePath); + } + + protected _createWorker(): Worker { + const workerEntrypoint = this._getWorkerEntrypoint(); + return new Worker(workerEntrypoint); + } + + private async _startWorkerAndHandshake(): Promise { + const worker = this._createWorker(); + this.#worker = worker; + + const initResult = await new Promise>((resolve, reject) => { + const cleanup = () => { + // eslint-disable-next-line no-use-before-define + worker.off('message', onMessage); + // eslint-disable-next-line no-use-before-define + worker.off('error', onError); + // eslint-disable-next-line no-use-before-define + worker.off('exit', onExit); + }; + + const onMessage = (message: WorkerOutboundMessage) => { + if (message.kind !== 'ready' && message.kind !== 'init.error') + return; + cleanup(); + resolve(message); + }; + + const onError = (err: Error) => { + cleanup(); + reject(err); + }; + const onExit = (code: number) => { + cleanup(); + reject(new Error(`Worker exited before ready (code=${code})`)); + }; + + worker.on('message', onMessage); + worker.once('error', onError); + worker.once('exit', onExit); + + worker.postMessage({ kind: 'init' } satisfies WorkerInitMessage); + }); + + if (initResult.kind === 'init.error') { + await worker.terminate(); + this.#worker = undefined; + + const err = new Error(initResult.error.message); + err.name = initResult.error.name; + if (initResult.error.stack) + err.stack = initResult.error.stack; + + throw err; + } + + return worker; + } +} diff --git a/src/workers/exposeWorkerProjection.ts b/src/workers/exposeWorkerProjection.ts new file mode 100644 index 0000000..75c0cb3 --- /dev/null +++ b/src/workers/exposeWorkerProjection.ts @@ -0,0 +1,53 @@ +import { isMainThread, parentPort } from 'node:worker_threads'; + +import type { SerializedError, WorkerInitMessage, WorkerOutboundMessage } from './protocol'; + +function serializeError(err: unknown): SerializedError { + if (err instanceof Error) { + return { + name: err.name, + message: err.message, + stack: err.stack + }; + } + + return { + name: 'Error', + message: typeof err === 'string' ? err : 'Unknown error', + details: err + }; +} + +/** + * Exposes the given projection constructor as a worker projection. + * + * Intended usage: call this at the bottom of the derived projection module so that + * the projection implementation file can be used as the Worker entrypoint. + */ +export function exposeWorkerProjection(ProjectionCtor: new (...args: any[]) => T) { + if (isMainThread) + return; + if (!parentPort) + throw new Error('exposeWorkerProjection must be called inside a Worker thread'); + + let projectionInstance: T; + + parentPort.on('message', async (message: WorkerInitMessage) => { + if (message?.kind !== 'init') + return; + if (projectionInstance) + return; + + try { + projectionInstance = new ProjectionCtor(); + + const outbound: WorkerOutboundMessage = { kind: 'ready' }; + parentPort!.postMessage(outbound); + } + catch (err) { + const outbound: WorkerOutboundMessage = { kind: 'init.error', error: serializeError(err) }; + parentPort!.postMessage(outbound); + setImmediate(() => process.exit(1)); + } + }); +} diff --git a/src/workers/index.ts b/src/workers/index.ts new file mode 100644 index 0000000..ab6f8f2 --- /dev/null +++ b/src/workers/index.ts @@ -0,0 +1,3 @@ +export * from './protocol'; +export * from './AbstractWorkerProjection'; +export * from './exposeWorkerProjection'; diff --git a/src/workers/protocol.ts b/src/workers/protocol.ts new file mode 100644 index 0000000..89355b8 --- /dev/null +++ b/src/workers/protocol.ts @@ -0,0 +1,26 @@ +export type SerializedError = { + name: string; + message: string; + stack?: string; + details?: any; +}; + +export type WorkerInitMessage = { + kind: 'init'; +}; + +export type WorkerReadyMessage = { + kind: 'ready'; +}; + +export type WorkerInitErrorMessage = { + kind: 'init.error'; + error: SerializedError; +}; + +export type WorkerInboundMessage = + | WorkerInitMessage; + +export type WorkerOutboundMessage = + | WorkerReadyMessage + | WorkerInitErrorMessage; diff --git a/tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts b/tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts new file mode 100644 index 0000000..08d0eee --- /dev/null +++ b/tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts @@ -0,0 +1,40 @@ +import { expect } from 'chai'; +import * as path from 'node:path'; + +type ProjectionFixtureCtor = typeof import('./fixtures/ProjectionFixture.cjs'); +// eslint-disable-next-line global-require +const ProjectionFixture = require('./fixtures/ProjectionFixture.cjs') as ProjectionFixtureCtor; + +describe('workers/AbstractWorkerProjection bootstrap', () => { + + it('spawns worker and completes handshake', async () => { + const fixturePath = path.resolve(process.cwd(), 'tests/unit/workers/fixtures/ProjectionFixture.cjs'); + const projection = new ProjectionFixture({ workerModulePath: fixturePath }); + try { + await projection.ensureWorkerReady(); + } + finally { + await projection.dispose(); + } + }); + + it('fails deterministically when worker module is missing', async () => { + const missingPath = path.resolve(process.cwd(), 'tests/unit/workers/fixtures/DOES_NOT_EXIST.cjs'); + const projection = new ProjectionFixture({ workerModulePath: missingPath }); + try { + let error: any; + try { + await projection.ensureWorkerReady(); + } + catch (err) { + error = err; + } + + expect(error).to.be.ok; + expect(error).to.have.property('message').that.includes('DOES_NOT_EXIST'); + } + finally { + await projection.dispose(); + } + }); +}); diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs new file mode 100644 index 0000000..28c56b7 --- /dev/null +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -0,0 +1,30 @@ +/** @type {typeof import('../../../../src/workers')} */ +// @ts-ignore +const workers = require('../../../../dist/workers'); + +const { AbstractWorkerProjection, exposeWorkerProjection } = workers; + +class ProjectionFixture extends AbstractWorkerProjection { + /** + * @param {any} container + */ + constructor({ + workerModulePath = __filename, + view, + viewLocker, + eventLocker, + logger + } = {}) { + super({ + workerModulePath, + view, + viewLocker, + eventLocker, + logger + }); + } +} + +exposeWorkerProjection(ProjectionFixture); + +module.exports = ProjectionFixture; From 3d4c56ac978f0ee11e98c8575befa2796755dc74 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 00:56:04 +0000 Subject: [PATCH 134/169] Feat: Run projections derived from AbstractWorkerProjection in worker threads with remote view access --- package-lock.json | 830 ++++++++---------- package.json | 15 +- src/AbstractProjection.ts | 2 +- src/workers/AbstractWorkerProjection.ts | 254 ++++-- src/workers/exposeWorkerProjection.ts | 53 -- src/workers/index.ts | 2 - src/workers/protocol.ts | 26 - src/workers/utils/index.ts | 1 + src/workers/utils/nodeEndpoint.ts | 7 + .../workers/AbstractWorkerProjection.test.ts | 53 ++ .../AbstractWorkerProjectionBootstrap.test.ts | 40 - .../workers/fixtures/ProjectionFixture.cjs | 37 +- .../workers/fixtures/ProjectionFixture.ts | 39 + 13 files changed, 683 insertions(+), 676 deletions(-) delete mode 100644 src/workers/exposeWorkerProjection.ts delete mode 100644 src/workers/protocol.ts create mode 100644 src/workers/utils/index.ts create mode 100644 src/workers/utils/nodeEndpoint.ts create mode 100644 tests/unit/workers/AbstractWorkerProjection.test.ts delete mode 100644 tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts create mode 100644 tests/unit/workers/fixtures/ProjectionFixture.ts diff --git a/package-lock.json b/package-lock.json index 12fb1ea..958ae37 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15,26 +15,26 @@ }, "devDependencies": { "@stylistic/eslint-plugin-ts": "^4.4.1", - "@types/amqplib": "^0.10.7", + "@types/amqplib": "^0.10.8", "@types/better-sqlite3": "^7.6.13", "@types/chai": "^4.3.20", "@types/jest": "^29.5.14", - "@types/md5": "^2.3.5", - "@types/node": "^20.19.21", + "@types/md5": "^2.3.6", + "@types/node": "^20.19.30", "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "eslint": "^9.37.0", + "eslint": "^9.39.2", "eslint-plugin-jest": "^28.14.0", - "globals": "^16.4.0", + "globals": "^16.5.0", "jest": "^29.7.0", "sinon": "^19.0.5", - "ts-jest": "^29.4.5", + "ts-jest": "^29.4.6", "ts-node": "^10.9.2", "typescript": "^5.9.3", - "typescript-eslint": "^8.46.1" + "typescript-eslint": "^8.53.1" }, "engines": { "node": ">=18.0.0" @@ -42,17 +42,18 @@ "peerDependencies": { "amqplib": "^0.10.9", "better-sqlite3": "^11.10.0", + "comlink": "^4.4.2", "md5": "^2.3.0" } }, "node_modules/@babel/code-frame": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", - "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.28.6.tgz", + "integrity": "sha512-JYgintcMjRiCvS8mMECzaEn+m3PfoQiyqukOMCCVQtoJGYJw8j/8LBJEiqkHLkfwCcs74E3pbAUFNg7d9VNJ+Q==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-validator-identifier": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5", "js-tokens": "^4.0.0", "picocolors": "^1.1.1" }, @@ -61,9 +62,9 @@ } }, "node_modules/@babel/compat-data": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.4.tgz", - "integrity": "sha512-YsmSKC29MJwf0gF8Rjjrg5LQCmyh+j/nD8/eP7f+BeoQTKYqs9RoWbjGOdy0+1Ekr68RJZMUOPVQaQisnIo4Rw==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.28.6.tgz", + "integrity": "sha512-2lfu57JtzctfIrcGMz992hyLlByuzgIk58+hhGCxjKZ3rWI82NnVLjXcaTqkI2NvlcvOskZaiZ5kjUALo3Lpxg==", "dev": true, "license": "MIT", "engines": { @@ -71,21 +72,21 @@ } }, "node_modules/@babel/core": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.4.tgz", - "integrity": "sha512-2BCOP7TN8M+gVDj7/ht3hsaO/B/n5oDbiAyyvnRlNOs+u1o+JWNYTQrmpuNp1/Wq2gcFrI01JAW+paEKDMx/CA==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.6.tgz", + "integrity": "sha512-H3mcG6ZDLTlYfaSNi0iOKkigqMFvkTKlGUYlD8GW7nNOYRrevuA46iTypPyv+06V3fEmvvazfntkBU34L0azAw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.27.1", - "@babel/generator": "^7.28.3", - "@babel/helper-compilation-targets": "^7.27.2", - "@babel/helper-module-transforms": "^7.28.3", - "@babel/helpers": "^7.28.4", - "@babel/parser": "^7.28.4", - "@babel/template": "^7.27.2", - "@babel/traverse": "^7.28.4", - "@babel/types": "^7.28.4", + "@babel/code-frame": "^7.28.6", + "@babel/generator": "^7.28.6", + "@babel/helper-compilation-targets": "^7.28.6", + "@babel/helper-module-transforms": "^7.28.6", + "@babel/helpers": "^7.28.6", + "@babel/parser": "^7.28.6", + "@babel/template": "^7.28.6", + "@babel/traverse": "^7.28.6", + "@babel/types": "^7.28.6", "@jridgewell/remapping": "^2.3.5", "convert-source-map": "^2.0.0", "debug": "^4.1.0", @@ -112,14 +113,14 @@ } }, "node_modules/@babel/generator": { - "version": "7.28.3", - "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.3.tgz", - "integrity": "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.28.6.tgz", + "integrity": "sha512-lOoVRwADj8hjf7al89tvQ2a1lf53Z+7tiXMgpZJL3maQPDxh0DgLMN62B2MKUOFcoodBHLMbDM6WAbKgNy5Suw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/parser": "^7.28.3", - "@babel/types": "^7.28.2", + "@babel/parser": "^7.28.6", + "@babel/types": "^7.28.6", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" @@ -129,13 +130,13 @@ } }, "node_modules/@babel/helper-compilation-targets": { - "version": "7.27.2", - "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.2.tgz", - "integrity": "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz", + "integrity": "sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==", "dev": true, "license": "MIT", "dependencies": { - "@babel/compat-data": "^7.27.2", + "@babel/compat-data": "^7.28.6", "@babel/helper-validator-option": "^7.27.1", "browserslist": "^4.24.0", "lru-cache": "^5.1.1", @@ -183,29 +184,29 @@ } }, "node_modules/@babel/helper-module-imports": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.27.1.tgz", - "integrity": "sha512-0gSFWUPNXNopqtIPQvlD5WgXYI5GY2kP2cCvoT8kczjbfcfuIljTbcWrulD1CIPIX2gt1wghbDy08yE1p+/r3w==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz", + "integrity": "sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/traverse": "^7.27.1", - "@babel/types": "^7.27.1" + "@babel/traverse": "^7.28.6", + "@babel/types": "^7.28.6" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/helper-module-transforms": { - "version": "7.28.3", - "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.3.tgz", - "integrity": "sha512-gytXUbs8k2sXS9PnQptz5o0QnpLL51SwASIORY6XaBKF88nsOT0Zw9szLqlSGQDP/4TljBAD5y98p2U1fqkdsw==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz", + "integrity": "sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-module-imports": "^7.27.1", - "@babel/helper-validator-identifier": "^7.27.1", - "@babel/traverse": "^7.28.3" + "@babel/helper-module-imports": "^7.28.6", + "@babel/helper-validator-identifier": "^7.28.5", + "@babel/traverse": "^7.28.6" }, "engines": { "node": ">=6.9.0" @@ -215,9 +216,9 @@ } }, "node_modules/@babel/helper-plugin-utils": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.27.1.tgz", - "integrity": "sha512-1gn1Up5YXka3YYAHGKpbideQ5Yjf1tDa9qYcgysz+cNCXukyLl6DjPXhD3VRwSb8c0J9tA4b2+rHEZtc6R0tlw==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.28.6.tgz", + "integrity": "sha512-S9gzZ/bz83GRysI7gAD4wPT/AI3uCnY+9xn+Mx/KPs2JwHJIz1W8PZkg2cqyt3RNOBM8ejcXhV6y8Og7ly/Dug==", "dev": true, "license": "MIT", "engines": { @@ -235,9 +236,9 @@ } }, "node_modules/@babel/helper-validator-identifier": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz", - "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==", + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", "dev": true, "license": "MIT", "engines": { @@ -255,27 +256,27 @@ } }, "node_modules/@babel/helpers": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.4.tgz", - "integrity": "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.6.tgz", + "integrity": "sha512-xOBvwq86HHdB7WUDTfKfT/Vuxh7gElQ+Sfti2Cy6yIWNW05P8iUslOVcZ4/sKbE+/jQaukQAdz/gf3724kYdqw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/template": "^7.27.2", - "@babel/types": "^7.28.4" + "@babel/template": "^7.28.6", + "@babel/types": "^7.28.6" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/parser": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.4.tgz", - "integrity": "sha512-yZbBqeM6TkpP9du/I2pUZnJsRMGGvOuIrhjzC1AwHwW+6he4mni6Bp/m8ijn0iOuZuPI2BfkCoSRunpyjnrQKg==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.28.6.tgz", + "integrity": "sha512-TeR9zWR18BvbfPmGbLampPMW+uW1NZnJlRuuHso8i87QZNq2JRF9i6RgxRqtEq+wQGsS19NNTWr2duhnE49mfQ==", "dev": true, "license": "MIT", "dependencies": { - "@babel/types": "^7.28.4" + "@babel/types": "^7.28.6" }, "bin": { "parser": "bin/babel-parser.js" @@ -340,13 +341,13 @@ } }, "node_modules/@babel/plugin-syntax-import-attributes": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.27.1.tgz", - "integrity": "sha512-oFT0FrKHgF53f4vOsZGi2Hh3I35PfSmVs4IBFLFj4dnafP+hIWDLg3VyKmUHfLoLHlyxY4C7DGtmHuJgn+IGww==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.28.6.tgz", + "integrity": "sha512-jiLC0ma9XkQT3TKJ9uYvlakm66Pamywo+qwL+oL8HJOvc6TWdZXVfhqJr8CCzbSGUAbDOzlGHJC1U+vRfLQDvw==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.27.1" + "@babel/helper-plugin-utils": "^7.28.6" }, "engines": { "node": ">=6.9.0" @@ -382,13 +383,13 @@ } }, "node_modules/@babel/plugin-syntax-jsx": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.27.1.tgz", - "integrity": "sha512-y8YTNIeKoyhGd9O0Jiyzyyqk8gdjnumGTQPsz0xOZOQ2RmkVJeZ1vmmfIvFEKqucBG6axJGBZDE/7iI5suUI/w==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.28.6.tgz", + "integrity": "sha512-wgEmr06G6sIpqr8YDwA2dSRTE3bJ+V0IfpzfSY3Lfgd7YWOaAdlykvJi13ZKBt8cZHfgH1IXN+CL656W3uUa4w==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.27.1" + "@babel/helper-plugin-utils": "^7.28.6" }, "engines": { "node": ">=6.9.0" @@ -508,13 +509,13 @@ } }, "node_modules/@babel/plugin-syntax-typescript": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.27.1.tgz", - "integrity": "sha512-xfYCBMxveHrRMnAWl1ZlPXOZjzkN82THFvLhQhFXFt81Z5HnN+EtUkZhv/zcKpmT3fzmWZB0ywiBrbC3vogbwQ==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.28.6.tgz", + "integrity": "sha512-+nDNmQye7nlnuuHDboPbGm00Vqg3oO8niRRL27/4LYHUsHYh0zJ1xWOz0uRwNFmM1Avzk8wZbc6rdiYhomzv/A==", "dev": true, "license": "MIT", "dependencies": { - "@babel/helper-plugin-utils": "^7.27.1" + "@babel/helper-plugin-utils": "^7.28.6" }, "engines": { "node": ">=6.9.0" @@ -524,33 +525,33 @@ } }, "node_modules/@babel/template": { - "version": "7.27.2", - "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.2.tgz", - "integrity": "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz", + "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==", "dev": true, "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.27.1", - "@babel/parser": "^7.27.2", - "@babel/types": "^7.27.1" + "@babel/code-frame": "^7.28.6", + "@babel/parser": "^7.28.6", + "@babel/types": "^7.28.6" }, "engines": { "node": ">=6.9.0" } }, "node_modules/@babel/traverse": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.4.tgz", - "integrity": "sha512-YEzuboP2qvQavAcjgQNVgsvHIDv6ZpwXvcvjmyySP2DIMuByS/6ioU5G9pYrWHM6T2YDfc7xga9iNzYOs12CFQ==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.28.6.tgz", + "integrity": "sha512-fgWX62k02qtjqdSNTAGxmKYY/7FSL9WAS1o2Hu5+I5m9T0yxZzr4cnrfXQ/MX0rIifthCSs6FKTlzYbJcPtMNg==", "dev": true, "license": "MIT", "dependencies": { - "@babel/code-frame": "^7.27.1", - "@babel/generator": "^7.28.3", + "@babel/code-frame": "^7.28.6", + "@babel/generator": "^7.28.6", "@babel/helper-globals": "^7.28.0", - "@babel/parser": "^7.28.4", - "@babel/template": "^7.27.2", - "@babel/types": "^7.28.4", + "@babel/parser": "^7.28.6", + "@babel/template": "^7.28.6", + "@babel/types": "^7.28.6", "debug": "^4.3.1" }, "engines": { @@ -558,14 +559,14 @@ } }, "node_modules/@babel/types": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.4.tgz", - "integrity": "sha512-bkFqkLhh3pMBUQQkpVgWDWq/lqzc2678eUyDlTBhRqhCHFguYYGM0Efga7tYk4TogG/3x0EEl66/OQ+WGbWB/Q==", + "version": "7.28.6", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.28.6.tgz", + "integrity": "sha512-0ZrskXVEHSWIqZM/sQZ4EV3jZJXRkio/WCxaqKZP1g//CEWEPSfeZFcms4XeKBCHU0ZKnIkdJeU/kF+eRp5lBg==", "dev": true, "license": "MIT", "dependencies": { "@babel/helper-string-parser": "^7.27.1", - "@babel/helper-validator-identifier": "^7.27.1" + "@babel/helper-validator-identifier": "^7.28.5" }, "engines": { "node": ">=6.9.0" @@ -603,9 +604,9 @@ } }, "node_modules/@eslint-community/eslint-utils": { - "version": "4.9.0", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", - "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "version": "4.9.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", "dev": true, "license": "MIT", "dependencies": { @@ -635,9 +636,9 @@ } }, "node_modules/@eslint-community/regexpp": { - "version": "4.12.1", - "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.1.tgz", - "integrity": "sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ==", + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", "dev": true, "license": "MIT", "engines": { @@ -645,13 +646,13 @@ } }, "node_modules/@eslint/config-array": { - "version": "0.21.0", - "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.0.tgz", - "integrity": "sha512-ENIdc4iLu0d93HeYirvKmrzshzofPw6VkZRKQGe9Nv46ZnWUzcF1xV01dcvEg/1wXUR61OmmlSfyeyO7EvjLxQ==", + "version": "0.21.1", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.1.tgz", + "integrity": "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/object-schema": "^2.1.6", + "@eslint/object-schema": "^2.1.7", "debug": "^4.3.1", "minimatch": "^3.1.2" }, @@ -684,22 +685,22 @@ } }, "node_modules/@eslint/config-helpers": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.0.tgz", - "integrity": "sha512-WUFvV4WoIwW8Bv0KeKCIIEgdSiFOsulyN0xrMu+7z43q/hkOLXjvb5u7UC9jDxvRzcrbEmuZBX5yJZz1741jog==", + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", + "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/core": "^0.16.0" + "@eslint/core": "^0.17.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, "node_modules/@eslint/core": { - "version": "0.16.0", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.16.0.tgz", - "integrity": "sha512-nmC8/totwobIiFcGkDza3GIKfAw1+hLiYVrh3I1nIomQ8PEr5cxg34jnkmGawul/ep52wGRAcyeDCNtWKSOj4Q==", + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", + "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", "dev": true, "license": "Apache-2.0", "dependencies": { @@ -710,9 +711,9 @@ } }, "node_modules/@eslint/eslintrc": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz", - "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==", + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", + "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", "dev": true, "license": "MIT", "dependencies": { @@ -722,7 +723,7 @@ "globals": "^14.0.0", "ignore": "^5.2.0", "import-fresh": "^3.2.1", - "js-yaml": "^4.1.0", + "js-yaml": "^4.1.1", "minimatch": "^3.1.2", "strip-json-comments": "^3.1.1" }, @@ -781,9 +782,9 @@ } }, "node_modules/@eslint/js": { - "version": "9.37.0", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.37.0.tgz", - "integrity": "sha512-jaS+NJ+hximswBG6pjNX0uEJZkrT0zwpVi3BA3vX22aFGjJjmgSTSmPpZCRKmoBL5VY/M6p0xsSJx7rk7sy5gg==", + "version": "9.39.2", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.2.tgz", + "integrity": "sha512-q1mjIoW1VX4IvSocvM/vbTiveKC4k9eLrajNEuSsmjymSDEbpGddtpfOoN7YGAqBK3NG+uqo8ia4PDTt8buCYA==", "dev": true, "license": "MIT", "engines": { @@ -794,9 +795,9 @@ } }, "node_modules/@eslint/object-schema": { - "version": "2.1.6", - "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.6.tgz", - "integrity": "sha512-RBMg5FRL0I0gs51M/guSAj5/e14VQ4tpZnQNWwuDT66P14I43ItmPfIZRhO9fUVIPOAQXU47atlywZ/czoqFPA==", + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", + "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", "dev": true, "license": "Apache-2.0", "engines": { @@ -804,13 +805,13 @@ } }, "node_modules/@eslint/plugin-kit": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.0.tgz", - "integrity": "sha512-sB5uyeq+dwCWyPi31B2gQlVlo+j5brPlWx4yZBrEaRo/nhdDE8Xke1gsGgtiBdaBTxuTkceLVuVt/pclrasb0A==", + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", + "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/core": "^0.16.0", + "@eslint/core": "^0.17.0", "levn": "^0.4.1" }, "engines": { @@ -1338,44 +1339,6 @@ "@jridgewell/sourcemap-codec": "^1.4.14" } }, - "node_modules/@nodelib/fs.scandir": { - "version": "2.1.5", - "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", - "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", - "dev": true, - "license": "MIT", - "dependencies": { - "@nodelib/fs.stat": "2.0.5", - "run-parallel": "^1.1.9" - }, - "engines": { - "node": ">= 8" - } - }, - "node_modules/@nodelib/fs.stat": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", - "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">= 8" - } - }, - "node_modules/@nodelib/fs.walk": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", - "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", - "dev": true, - "license": "MIT", - "dependencies": { - "@nodelib/fs.scandir": "2.1.5", - "fastq": "^1.6.0" - }, - "engines": { - "node": ">= 8" - } - }, "node_modules/@sinclair/typebox": { "version": "0.27.8", "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", @@ -1450,9 +1413,9 @@ } }, "node_modules/@tsconfig/node10": { - "version": "1.0.11", - "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz", - "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==", + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.12.tgz", + "integrity": "sha512-UCYBaeFvM11aU2y3YPZ//O5Rhj+xKyzy7mvcIoAjASbigy8mHMryP5cK7dgjlz2hWxh1g5pLw084E0a/wlUSFQ==", "dev": true, "license": "MIT" }, @@ -1478,9 +1441,9 @@ "license": "MIT" }, "node_modules/@types/amqplib": { - "version": "0.10.7", - "resolved": "https://registry.npmjs.org/@types/amqplib/-/amqplib-0.10.7.tgz", - "integrity": "sha512-IVj3avf9AQd2nXCx0PGk/OYq7VmHiyNxWFSb5HhU9ATh+i+gHWvVcljFTcTWQ/dyHJCTrzCixde+r/asL2ErDA==", + "version": "0.10.8", + "resolved": "https://registry.npmjs.org/@types/amqplib/-/amqplib-0.10.8.tgz", + "integrity": "sha512-vtDp8Pk1wsE/AuQ8/Rgtm6KUZYqcnTgNvEHwzCkX8rL7AGsC6zqAfKAAJhUZXFhM/Pp++tbnUHiam/8vVpPztA==", "dev": true, "license": "MIT", "dependencies": { @@ -1612,9 +1575,9 @@ "license": "MIT" }, "node_modules/@types/md5": { - "version": "2.3.5", - "resolved": "https://registry.npmjs.org/@types/md5/-/md5-2.3.5.tgz", - "integrity": "sha512-/i42wjYNgE6wf0j2bcTX6kuowmdL/6PE4IVitMpm2eYKBUuYCprdcWVK+xEF0gcV6ufMCRhtxmReGfc6hIK7Jw==", + "version": "2.3.6", + "resolved": "https://registry.npmjs.org/@types/md5/-/md5-2.3.6.tgz", + "integrity": "sha512-WD69gNXtRBnpknfZcb4TRQ0XJQbUPZcai/Qdhmka3sxUR3Et8NrXoeAoknG/LghYHTf4ve795rInVYHBTQdNVA==", "dev": true, "license": "MIT" }, @@ -1626,11 +1589,12 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "20.19.21", - "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.21.tgz", - "integrity": "sha512-CsGG2P3I5y48RPMfprQGfy4JPRZ6csfC3ltBZSRItG3ngggmNY/qs2uZKp4p9VbrpqNNSMzUZNFZKzgOGnd/VA==", + "version": "20.19.30", + "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.30.tgz", + "integrity": "sha512-WJtwWJu7UdlvzEAUm484QNg5eAoq5QR08KDNx7g45Usrs2NtOPiX8ugDqmKdXkyL03rBqU5dYNYVQetEpBHq2g==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "undici-types": "~6.21.0" } @@ -1653,9 +1617,9 @@ } }, "node_modules/@types/sinonjs__fake-timers": { - "version": "8.1.5", - "resolved": "https://registry.npmjs.org/@types/sinonjs__fake-timers/-/sinonjs__fake-timers-8.1.5.tgz", - "integrity": "sha512-mQkU2jY8jJEF7YHjHvsQO8+3ughTL1mcnn96igfhONmR+fUPSKIkefQYpSe8bsly2Ep7oQbn/6VG5/9/0qcArQ==", + "version": "15.0.1", + "resolved": "https://registry.npmjs.org/@types/sinonjs__fake-timers/-/sinonjs__fake-timers-15.0.1.tgz", + "integrity": "sha512-Ko2tjWJq8oozHzHV+reuvS5KYIRAokHnGbDwGh/J64LntgpbuylF74ipEL24HCyRjf9FOlBiBHWBR1RlVKsI1w==", "dev": true, "license": "MIT" }, @@ -1667,9 +1631,9 @@ "license": "MIT" }, "node_modules/@types/yargs": { - "version": "17.0.33", - "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz", - "integrity": "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==", + "version": "17.0.35", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.35.tgz", + "integrity": "sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==", "dev": true, "license": "MIT", "dependencies": { @@ -1684,21 +1648,21 @@ "license": "MIT" }, "node_modules/@typescript-eslint/eslint-plugin": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.46.1.tgz", - "integrity": "sha512-rUsLh8PXmBjdiPY+Emjz9NX2yHvhS11v0SR6xNJkm5GM1MO9ea/1GoDKlHHZGrOJclL/cZ2i/vRUYVtjRhrHVQ==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.53.1.tgz", + "integrity": "sha512-cFYYFZ+oQFi6hUnBTbLRXfTJiaQtYE3t4O692agbBl+2Zy+eqSKWtPjhPXJu1G7j4RLjKgeJPDdq3EqOwmX5Ag==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { - "@eslint-community/regexpp": "^4.10.0", - "@typescript-eslint/scope-manager": "8.46.1", - "@typescript-eslint/type-utils": "8.46.1", - "@typescript-eslint/utils": "8.46.1", - "@typescript-eslint/visitor-keys": "8.46.1", - "graphemer": "^1.4.0", - "ignore": "^7.0.0", + "@eslint-community/regexpp": "^4.12.2", + "@typescript-eslint/scope-manager": "8.53.1", + "@typescript-eslint/type-utils": "8.53.1", + "@typescript-eslint/utils": "8.53.1", + "@typescript-eslint/visitor-keys": "8.53.1", + "ignore": "^7.0.5", "natural-compare": "^1.4.0", - "ts-api-utils": "^2.1.0" + "ts-api-utils": "^2.4.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1708,23 +1672,24 @@ "url": "https://opencollective.com/typescript-eslint" }, "peerDependencies": { - "@typescript-eslint/parser": "^8.46.1", + "@typescript-eslint/parser": "^8.53.1", "eslint": "^8.57.0 || ^9.0.0", "typescript": ">=4.8.4 <6.0.0" } }, "node_modules/@typescript-eslint/parser": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.46.1.tgz", - "integrity": "sha512-6JSSaBZmsKvEkbRUkf7Zj7dru/8ZCrJxAqArcLaVMee5907JdtEbKGsZ7zNiIm/UAkpGUkaSMZEXShnN2D1HZA==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-8.53.1.tgz", + "integrity": "sha512-nm3cvFN9SqZGXjmw5bZ6cGmvJSyJPn0wU9gHAZZHDnZl2wF9PhHv78Xf06E0MaNk4zLVHL8hb2/c32XvyJOLQg==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { - "@typescript-eslint/scope-manager": "8.46.1", - "@typescript-eslint/types": "8.46.1", - "@typescript-eslint/typescript-estree": "8.46.1", - "@typescript-eslint/visitor-keys": "8.46.1", - "debug": "^4.3.4" + "@typescript-eslint/scope-manager": "8.53.1", + "@typescript-eslint/types": "8.53.1", + "@typescript-eslint/typescript-estree": "8.53.1", + "@typescript-eslint/visitor-keys": "8.53.1", + "debug": "^4.4.3" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1739,15 +1704,15 @@ } }, "node_modules/@typescript-eslint/project-service": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.46.1.tgz", - "integrity": "sha512-FOIaFVMHzRskXr5J4Jp8lFVV0gz5ngv3RHmn+E4HYxSJ3DgDzU7fVI1/M7Ijh1zf6S7HIoaIOtln1H5y8V+9Zg==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/project-service/-/project-service-8.53.1.tgz", + "integrity": "sha512-WYC4FB5Ra0xidsmlPb+1SsnaSKPmS3gsjIARwbEkHkoWloQmuzcfypljaJcR78uyLA1h8sHdWWPHSLDI+MtNog==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/tsconfig-utils": "^8.46.1", - "@typescript-eslint/types": "^8.46.1", - "debug": "^4.3.4" + "@typescript-eslint/tsconfig-utils": "^8.53.1", + "@typescript-eslint/types": "^8.53.1", + "debug": "^4.4.3" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1761,14 +1726,14 @@ } }, "node_modules/@typescript-eslint/scope-manager": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.46.1.tgz", - "integrity": "sha512-weL9Gg3/5F0pVQKiF8eOXFZp8emqWzZsOJuWRUNtHT+UNV2xSJegmpCNQHy37aEQIbToTq7RHKhWvOsmbM680A==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-8.53.1.tgz", + "integrity": "sha512-Lu23yw1uJMFY8cUeq7JlrizAgeQvWugNQzJp8C3x8Eo5Jw5Q2ykMdiiTB9vBVOOUBysMzmRRmUfwFrZuI2C4SQ==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.46.1", - "@typescript-eslint/visitor-keys": "8.46.1" + "@typescript-eslint/types": "8.53.1", + "@typescript-eslint/visitor-keys": "8.53.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1779,9 +1744,9 @@ } }, "node_modules/@typescript-eslint/tsconfig-utils": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.46.1.tgz", - "integrity": "sha512-X88+J/CwFvlJB+mK09VFqx5FE4H5cXD+H/Bdza2aEWkSb8hnWIQorNcscRl4IEo1Cz9VI/+/r/jnGWkbWPx54g==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.53.1.tgz", + "integrity": "sha512-qfvLXS6F6b1y43pnf0pPbXJ+YoXIC7HKg0UGZ27uMIemKMKA6XH2DTxsEDdpdN29D+vHV07x/pnlPNVLhdhWiA==", "dev": true, "license": "MIT", "engines": { @@ -1796,17 +1761,17 @@ } }, "node_modules/@typescript-eslint/type-utils": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.46.1.tgz", - "integrity": "sha512-+BlmiHIiqufBxkVnOtFwjah/vrkF4MtKKvpXrKSPLCkCtAp8H01/VV43sfqA98Od7nJpDcFnkwgyfQbOG0AMvw==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-8.53.1.tgz", + "integrity": "sha512-MOrdtNvyhy0rHyv0ENzub1d4wQYKb2NmIqG7qEqPWFW7Mpy2jzFC3pQ2yKDvirZB7jypm5uGjF2Qqs6OIqu47w==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.46.1", - "@typescript-eslint/typescript-estree": "8.46.1", - "@typescript-eslint/utils": "8.46.1", - "debug": "^4.3.4", - "ts-api-utils": "^2.1.0" + "@typescript-eslint/types": "8.53.1", + "@typescript-eslint/typescript-estree": "8.53.1", + "@typescript-eslint/utils": "8.53.1", + "debug": "^4.4.3", + "ts-api-utils": "^2.4.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1821,9 +1786,9 @@ } }, "node_modules/@typescript-eslint/types": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.46.1.tgz", - "integrity": "sha512-C+soprGBHwWBdkDpbaRC4paGBrkIXxVlNohadL5o0kfhsXqOC6GYH2S/Obmig+I0HTDl8wMaRySwrfrXVP8/pQ==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-8.53.1.tgz", + "integrity": "sha512-jr/swrr2aRmUAUjW5/zQHbMaui//vQlsZcJKijZf3M26bnmLj8LyZUpj8/Rd6uzaek06OWsqdofN/Thenm5O8A==", "dev": true, "license": "MIT", "engines": { @@ -1835,22 +1800,21 @@ } }, "node_modules/@typescript-eslint/typescript-estree": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.46.1.tgz", - "integrity": "sha512-uIifjT4s8cQKFQ8ZBXXyoUODtRoAd7F7+G8MKmtzj17+1UbdzFl52AzRyZRyKqPHhgzvXunnSckVu36flGy8cg==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-8.53.1.tgz", + "integrity": "sha512-RGlVipGhQAG4GxV1s34O91cxQ/vWiHJTDHbXRr0li2q/BGg3RR/7NM8QDWgkEgrwQYCvmJV9ichIwyoKCQ+DTg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/project-service": "8.46.1", - "@typescript-eslint/tsconfig-utils": "8.46.1", - "@typescript-eslint/types": "8.46.1", - "@typescript-eslint/visitor-keys": "8.46.1", - "debug": "^4.3.4", - "fast-glob": "^3.3.2", - "is-glob": "^4.0.3", - "minimatch": "^9.0.4", - "semver": "^7.6.0", - "ts-api-utils": "^2.1.0" + "@typescript-eslint/project-service": "8.53.1", + "@typescript-eslint/tsconfig-utils": "8.53.1", + "@typescript-eslint/types": "8.53.1", + "@typescript-eslint/visitor-keys": "8.53.1", + "debug": "^4.4.3", + "minimatch": "^9.0.5", + "semver": "^7.7.3", + "tinyglobby": "^0.2.15", + "ts-api-utils": "^2.4.0" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1864,16 +1828,16 @@ } }, "node_modules/@typescript-eslint/utils": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.46.1.tgz", - "integrity": "sha512-vkYUy6LdZS7q1v/Gxb2Zs7zziuXN0wxqsetJdeZdRe/f5dwJFglmuvZBfTUivCtjH725C1jWCDfpadadD95EDQ==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-8.53.1.tgz", + "integrity": "sha512-c4bMvGVWW4hv6JmDUEG7fSYlWOl3II2I4ylt0NM+seinYQlZMQIaKaXIIVJWt9Ofh6whrpM+EdDQXKXjNovvrg==", "dev": true, "license": "MIT", "dependencies": { - "@eslint-community/eslint-utils": "^4.7.0", - "@typescript-eslint/scope-manager": "8.46.1", - "@typescript-eslint/types": "8.46.1", - "@typescript-eslint/typescript-estree": "8.46.1" + "@eslint-community/eslint-utils": "^4.9.1", + "@typescript-eslint/scope-manager": "8.53.1", + "@typescript-eslint/types": "8.53.1", + "@typescript-eslint/typescript-estree": "8.53.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -1888,13 +1852,13 @@ } }, "node_modules/@typescript-eslint/visitor-keys": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.46.1.tgz", - "integrity": "sha512-ptkmIf2iDkNUjdeu2bQqhFPV1m6qTnFFjg7PPDjxKWaMaP0Z6I9l30Jr3g5QqbZGdw8YdYvLp+XnqnWWZOg/NA==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-8.53.1.tgz", + "integrity": "sha512-oy+wV7xDKFPRyNggmXuZQSBzvoLnpmJs+GhzRhPjrxl2b/jIlyjVokzm47CZCDUdXKr2zd7ZLodPfOBpOPyPlg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/types": "8.46.1", + "@typescript-eslint/types": "8.53.1", "eslint-visitor-keys": "^4.2.1" }, "engines": { @@ -1911,6 +1875,7 @@ "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", "dev": true, "license": "MIT", + "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -2239,13 +2204,12 @@ "url": "https://feross.org/support" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/baseline-browser-mapping": { - "version": "2.8.16", - "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.16.tgz", - "integrity": "sha512-OMu3BGQ4E7P1ErFsIPpbJh0qvDudM/UuJeHgkAvfWe+0HFJCXh+t/l8L6fVLR55RI/UbKrVLnAXZSVwd9ysWYw==", + "version": "2.9.18", + "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.18.tgz", + "integrity": "sha512-e23vBV1ZLfjb9apvfPk4rHVu2ry6RIr2Wfs+O324okSidrX7pTAnEJPCh/O5BtRlr7QtZI7ktOP3vsqr7Z5XoA==", "dev": true, "license": "Apache-2.0", "bin": { @@ -2269,7 +2233,6 @@ "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", "license": "MIT", - "peer": true, "dependencies": { "file-uri-to-path": "1.0.0" } @@ -2279,7 +2242,6 @@ "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", "license": "MIT", - "peer": true, "dependencies": { "buffer": "^5.5.0", "inherits": "^2.0.4", @@ -2310,9 +2272,9 @@ } }, "node_modules/browserslist": { - "version": "4.26.3", - "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.26.3.tgz", - "integrity": "sha512-lAUU+02RFBuCKQPj/P6NgjlbCnLBMp4UtgTx7vNHd3XSIJF87s9a5rA3aH2yw3GS9DqZAUbOtZdCCiZeVRqt0w==", + "version": "4.28.1", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz", + "integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==", "dev": true, "funding": [ { @@ -2329,12 +2291,13 @@ } ], "license": "MIT", + "peer": true, "dependencies": { - "baseline-browser-mapping": "^2.8.9", - "caniuse-lite": "^1.0.30001746", - "electron-to-chromium": "^1.5.227", - "node-releases": "^2.0.21", - "update-browserslist-db": "^1.1.3" + "baseline-browser-mapping": "^2.9.0", + "caniuse-lite": "^1.0.30001759", + "electron-to-chromium": "^1.5.263", + "node-releases": "^2.0.27", + "update-browserslist-db": "^1.2.0" }, "bin": { "browserslist": "cli.js" @@ -2385,7 +2348,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.1.13" @@ -2402,8 +2364,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/buffer-more-ints/-/buffer-more-ints-1.0.0.tgz", "integrity": "sha512-EMetuGFz5SLsT0QTnXzINh4Ksr+oo4i+UGTXEshiGCQWnsgSs7ZhJ8fzlwQ+OzEMs0MpDAMr1hxnblp5a4vcHg==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/callsites": { "version": "3.1.0", @@ -2444,9 +2405,9 @@ } }, "node_modules/caniuse-lite": { - "version": "1.0.30001750", - "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001750.tgz", - "integrity": "sha512-cuom0g5sdX6rw00qOoLNSFCJ9/mYIsuSOA+yzpDw8eopiFqcVwQvZHqov0vmEighRxX++cfC0Vg1G+1Iy/mSpQ==", + "version": "1.0.30001766", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001766.tgz", + "integrity": "sha512-4C0lfJ0/YPjJQHagaE9x2Elb69CIqEPZeG0anQt9SIvIoOH4a4uaRl73IavyO+0qZh6MDLH//DrXThEYKHkmYA==", "dev": true, "funding": [ { @@ -2515,7 +2476,6 @@ "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz", "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==", "license": "BSD-3-Clause", - "peer": true, "engines": { "node": "*" } @@ -2537,8 +2497,7 @@ "version": "1.1.4", "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", - "license": "ISC", - "peer": true + "license": "ISC" }, "node_modules/ci-info": { "version": "3.9.0", @@ -2587,9 +2546,9 @@ } }, "node_modules/collect-v8-coverage": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz", - "integrity": "sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==", + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.3.tgz", + "integrity": "sha512-1L5aqIkwPfiodaMgQunkF1zRhNqifHBmtbbbxcr6yVxxBnliw4TDOW6NxpO8DJLgJ16OT+Y4ztZqP6p/FtXnAw==", "dev": true, "license": "MIT" }, @@ -2613,6 +2572,13 @@ "dev": true, "license": "MIT" }, + "node_modules/comlink": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/comlink/-/comlink-4.4.2.tgz", + "integrity": "sha512-OxGdvBmJuNKSCMO4NTl1L47VRp6xn2wG4F/2hYzB6tiCb709otOxtEYCSvK80PtjODfXXZu8ds+Nw5kVCjqd2g==", + "license": "Apache-2.0", + "peer": true + }, "node_modules/compare-func": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/compare-func/-/compare-func-2.0.0.tgz", @@ -2943,7 +2909,6 @@ "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz", "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==", "license": "BSD-3-Clause", - "peer": true, "engines": { "node": "*" } @@ -3028,7 +2993,6 @@ "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", "license": "MIT", - "peer": true, "dependencies": { "mimic-response": "^3.1.0" }, @@ -3040,9 +3004,9 @@ } }, "node_modules/dedent": { - "version": "1.7.0", - "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.0.tgz", - "integrity": "sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==", + "version": "1.7.1", + "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.1.tgz", + "integrity": "sha512-9JmrhGZpOlEgOLdQgSm0zxFaYoQon408V1v49aqTWuXENVlnCuY9JBZcXZiCsZQWDjTm5Qf/nIvAy77mXDAjEg==", "dev": true, "license": "MIT", "peerDependencies": { @@ -3072,7 +3036,6 @@ "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", "license": "MIT", - "peer": true, "engines": { "node": ">=4.0.0" } @@ -3099,7 +3062,6 @@ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", "license": "Apache-2.0", - "peer": true, "engines": { "node": ">=8" } @@ -3154,9 +3116,9 @@ } }, "node_modules/electron-to-chromium": { - "version": "1.5.235", - "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.235.tgz", - "integrity": "sha512-i/7ntLFwOdoHY7sgjlTIDo4Sl8EdoTjWIaKinYOVfC6bOp71bmwenyZthWHcasxgHDNWbWxvG9M3Ia116zIaYQ==", + "version": "1.5.278", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.278.tgz", + "integrity": "sha512-dQ0tM1svDRQOwxnXxm+twlGTjr9Upvt8UFWAgmLsxEzFQxhbti4VwxmMjsDxVC51Zo84swW7FVCXEV+VAkhuPw==", "dev": true, "license": "ISC" }, @@ -3185,7 +3147,6 @@ "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz", "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==", "license": "MIT", - "peer": true, "dependencies": { "once": "^1.4.0" } @@ -3224,25 +3185,25 @@ } }, "node_modules/eslint": { - "version": "9.37.0", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.37.0.tgz", - "integrity": "sha512-XyLmROnACWqSxiGYArdef1fItQd47weqB7iwtfr9JHwRrqIXZdcFMvvEcL9xHCmL0SNsOvF0c42lWyM1U5dgig==", + "version": "9.39.2", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.2.tgz", + "integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/regexpp": "^4.12.1", - "@eslint/config-array": "^0.21.0", - "@eslint/config-helpers": "^0.4.0", - "@eslint/core": "^0.16.0", + "@eslint/config-array": "^0.21.1", + "@eslint/config-helpers": "^0.4.2", + "@eslint/core": "^0.17.0", "@eslint/eslintrc": "^3.3.1", - "@eslint/js": "9.37.0", - "@eslint/plugin-kit": "^0.4.0", + "@eslint/js": "9.39.2", + "@eslint/plugin-kit": "^0.4.1", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", "@types/estree": "^1.0.6", - "@types/json-schema": "^7.0.15", "ajv": "^6.12.4", "chalk": "^4.0.0", "cross-spawn": "^7.0.6", @@ -3407,9 +3368,9 @@ } }, "node_modules/esquery": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", - "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", "dev": true, "license": "BSD-3-Clause", "dependencies": { @@ -3490,7 +3451,6 @@ "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", "license": "(MIT OR WTFPL)", - "peer": true, "engines": { "node": ">=6" } @@ -3519,36 +3479,6 @@ "dev": true, "license": "MIT" }, - "node_modules/fast-glob": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", - "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", - "dev": true, - "license": "MIT", - "dependencies": { - "@nodelib/fs.stat": "^2.0.2", - "@nodelib/fs.walk": "^1.2.3", - "glob-parent": "^5.1.2", - "merge2": "^1.3.0", - "micromatch": "^4.0.8" - }, - "engines": { - "node": ">=8.6.0" - } - }, - "node_modules/fast-glob/node_modules/glob-parent": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", - "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", - "dev": true, - "license": "ISC", - "dependencies": { - "is-glob": "^4.0.1" - }, - "engines": { - "node": ">= 6" - } - }, "node_modules/fast-json-stable-stringify": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", @@ -3563,16 +3493,6 @@ "dev": true, "license": "MIT" }, - "node_modules/fastq": { - "version": "1.19.1", - "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz", - "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==", - "dev": true, - "license": "ISC", - "dependencies": { - "reusify": "^1.0.4" - } - }, "node_modules/fb-watchman": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz", @@ -3600,8 +3520,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/fill-range": { "version": "7.1.1", @@ -3658,8 +3577,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/fs.realpath": { "version": "1.0.0", @@ -3884,8 +3802,7 @@ "version": "0.0.0", "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/glob": { "version": "7.2.3", @@ -3947,9 +3864,9 @@ } }, "node_modules/globals": { - "version": "16.4.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-16.4.0.tgz", - "integrity": "sha512-ob/2LcVVaVGCYN+r14cnwnoDPUufjiYgSqRhiFD0Q1iI4Odora5RE8Iv1D24hAz5oMophRGkGz+yuvQmmUMnMw==", + "version": "16.5.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz", + "integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==", "dev": true, "license": "MIT", "engines": { @@ -3966,13 +3883,6 @@ "dev": true, "license": "ISC" }, - "node_modules/graphemer": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz", - "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", - "dev": true, - "license": "MIT" - }, "node_modules/handlebars": { "version": "4.7.8", "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", @@ -4076,8 +3986,7 @@ "url": "https://feross.org/support" } ], - "license": "BSD-3-Clause", - "peer": true + "license": "BSD-3-Clause" }, "node_modules/ignore": { "version": "7.0.5", @@ -4181,8 +4090,7 @@ "version": "1.1.6", "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/is-core-module": { "version": "2.16.1", @@ -4390,6 +4298,7 @@ "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "@jest/core": "^29.7.0", "@jest/types": "^29.6.3", @@ -5261,9 +5170,9 @@ } }, "node_modules/lodash": { - "version": "4.17.21", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", - "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", + "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==", "dev": true, "license": "MIT" }, @@ -5555,16 +5464,6 @@ "dev": true, "license": "MIT" }, - "node_modules/merge2": { - "version": "1.4.1", - "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", - "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", - "dev": true, - "license": "MIT", - "engines": { - "node": ">= 8" - } - }, "node_modules/micromatch": { "version": "4.0.8", "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", @@ -5594,7 +5493,6 @@ "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", "license": "MIT", - "peer": true, "engines": { "node": ">=10" }, @@ -5656,8 +5554,7 @@ "version": "0.5.3", "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/modify-values": { "version": "1.0.1", @@ -5680,8 +5577,7 @@ "version": "2.0.0", "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz", "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/natural-compare": { "version": "1.4.0", @@ -5722,11 +5618,10 @@ } }, "node_modules/node-abi": { - "version": "3.78.0", - "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.78.0.tgz", - "integrity": "sha512-E2wEyrgX/CqvicaQYU3Ze1PFGjc4QYPGsjUrlYkqAE0WjHEZwgOsGMPMzkMse4LjJbDmaEuDX3CM036j5K2DSQ==", + "version": "3.87.0", + "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.87.0.tgz", + "integrity": "sha512-+CGM1L1CgmtheLcBuleyYOn7NWPVu0s0EJH2C4puxgEZb9h8QpR9G2dBfZJOAUhi7VQxuBPMd0hiISWcTyiYyQ==", "license": "MIT", - "peer": true, "dependencies": { "semver": "^7.3.5" }, @@ -5742,9 +5637,9 @@ "license": "MIT" }, "node_modules/node-releases": { - "version": "2.0.23", - "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.23.tgz", - "integrity": "sha512-cCmFDMSm26S6tQSDpBCg/NR8NENrVPhAJSf+XbxBG4rPFaaonlEoE9wHQmun+cls499TQGSb7ZyPBRlzgKfpeg==", + "version": "2.0.27", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.27.tgz", + "integrity": "sha512-nmh3lCkYZ3grZvqcCH+fjmQ7X+H0OeZgP40OierEaAptX4XofMh5kwNbWh7lBduUzCcV/8kZ+NDLCwm2iorIlA==", "dev": true, "license": "MIT" }, @@ -6099,7 +5994,6 @@ "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==", "license": "MIT", - "peer": true, "dependencies": { "detect-libc": "^2.0.0", "expand-template": "^2.0.3", @@ -6185,7 +6079,6 @@ "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz", "integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==", "license": "MIT", - "peer": true, "dependencies": { "end-of-stream": "^1.1.0", "once": "^1.3.1" @@ -6234,28 +6127,6 @@ "version": "2.2.0", "resolved": "https://registry.npmjs.org/querystringify/-/querystringify-2.2.0.tgz", "integrity": "sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ==", - "license": "MIT", - "peer": true - }, - "node_modules/queue-microtask": { - "version": "1.2.3", - "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", - "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", - "dev": true, - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ], "license": "MIT" }, "node_modules/quick-lru": { @@ -6273,7 +6144,6 @@ "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", - "peer": true, "dependencies": { "deep-extend": "^0.6.0", "ini": "~1.3.0", @@ -6289,7 +6159,6 @@ "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", "license": "MIT", - "peer": true, "engines": { "node": ">=0.10.0" } @@ -6475,17 +6344,16 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/resolve": { - "version": "1.22.10", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.10.tgz", - "integrity": "sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==", + "version": "1.22.11", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz", + "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==", "dev": true, "license": "MIT", "dependencies": { - "is-core-module": "^2.16.0", + "is-core-module": "^2.16.1", "path-parse": "^1.0.7", "supports-preserve-symlinks-flag": "^1.0.0" }, @@ -6542,41 +6410,6 @@ "node": ">=10" } }, - "node_modules/reusify": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", - "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", - "dev": true, - "license": "MIT", - "engines": { - "iojs": ">=1.0.0", - "node": ">=0.10.0" - } - }, - "node_modules/run-parallel": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", - "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", - "dev": true, - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ], - "license": "MIT", - "dependencies": { - "queue-microtask": "^1.2.2" - } - }, "node_modules/safe-buffer": { "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", @@ -6657,8 +6490,7 @@ "url": "https://feross.org/support" } ], - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/simple-get": { "version": "4.0.1", @@ -6679,7 +6511,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "decompress-response": "^6.0.0", "once": "^1.3.1", @@ -6970,7 +6801,6 @@ "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.4.tgz", "integrity": "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==", "license": "MIT", - "peer": true, "dependencies": { "chownr": "^1.1.1", "mkdirp-classic": "^0.5.2", @@ -6983,7 +6813,6 @@ "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz", "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", "license": "MIT", - "peer": true, "dependencies": { "bl": "^4.0.3", "end-of-stream": "^1.4.1", @@ -7061,6 +6890,55 @@ "readable-stream": "3" } }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyglobby/node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/tinyglobby/node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, "node_modules/tmpl": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz", @@ -7092,9 +6970,9 @@ } }, "node_modules/ts-api-utils": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.1.0.tgz", - "integrity": "sha512-CUgTZL1irw8u29bzrOD/nH85jqyc74D6SshFgujOIA7osm2Rz7dYH77agkx7H4FBNxDq7Cjf+IjaX/8zwFW+ZQ==", + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.4.0.tgz", + "integrity": "sha512-3TaVTaAv2gTiMB35i3FiGJaRfwb3Pyn/j3m/bfAvGe8FB7CF6u+LMYqYlDh7reQf7UNvoTvdfAqHGmPGOSsPmA==", "dev": true, "license": "MIT", "engines": { @@ -7105,9 +6983,9 @@ } }, "node_modules/ts-jest": { - "version": "29.4.5", - "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.5.tgz", - "integrity": "sha512-HO3GyiWn2qvTQA4kTgjDcXiMwYQt68a1Y8+JuLRVpdIzm+UOLSHgl/XqR4c6nzJkq5rOkjc02O2I7P7l/Yof0Q==", + "version": "29.4.6", + "resolved": "https://registry.npmjs.org/ts-jest/-/ts-jest-29.4.6.tgz", + "integrity": "sha512-fSpWtOO/1AjSNQguk43hb/JCo16oJDnMJf3CdEGNkqsEX3t0KX96xvyX1D7PfLCpVoKu4MfVrqUkFyblYoY4lA==", "dev": true, "license": "MIT", "dependencies": { @@ -7186,6 +7064,7 @@ "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "@cspotcode/source-map-support": "^0.8.0", "@tsconfig/node10": "^1.0.7", @@ -7225,9 +7104,9 @@ } }, "node_modules/ts-node/node_modules/diff": { - "version": "4.0.2", - "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz", - "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==", + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.4.tgz", + "integrity": "sha512-X07nttJQkwkfKfvTPG/KSnE2OMdcUCao6+eXF3wmnIQRn2aPAHH3VxDbDOdegkd6JbPsXqShpvEOHfAT+nCNwQ==", "dev": true, "license": "BSD-3-Clause", "engines": { @@ -7239,7 +7118,6 @@ "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", "license": "Apache-2.0", - "peer": true, "dependencies": { "safe-buffer": "^5.0.1" }, @@ -7289,6 +7167,7 @@ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", "dev": true, "license": "Apache-2.0", + "peer": true, "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" @@ -7298,16 +7177,16 @@ } }, "node_modules/typescript-eslint": { - "version": "8.46.1", - "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.46.1.tgz", - "integrity": "sha512-VHgijW803JafdSsDO8I761r3SHrgk4T00IdyQ+/UsthtgPRsBWQLqoSxOolxTpxRKi1kGXK0bSz4CoAc9ObqJA==", + "version": "8.53.1", + "resolved": "https://registry.npmjs.org/typescript-eslint/-/typescript-eslint-8.53.1.tgz", + "integrity": "sha512-gB+EVQfP5RDElh9ittfXlhZJdjSU4jUSTyE2+ia8CYyNvet4ElfaLlAIqDvQV9JPknKx0jQH1racTYe/4LaLSg==", "dev": true, "license": "MIT", "dependencies": { - "@typescript-eslint/eslint-plugin": "8.46.1", - "@typescript-eslint/parser": "8.46.1", - "@typescript-eslint/typescript-estree": "8.46.1", - "@typescript-eslint/utils": "8.46.1" + "@typescript-eslint/eslint-plugin": "8.53.1", + "@typescript-eslint/parser": "8.53.1", + "@typescript-eslint/typescript-estree": "8.53.1", + "@typescript-eslint/utils": "8.53.1" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" @@ -7343,9 +7222,9 @@ "license": "MIT" }, "node_modules/update-browserslist-db": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz", - "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==", + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz", + "integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==", "dev": true, "funding": [ { @@ -7388,7 +7267,6 @@ "resolved": "https://registry.npmjs.org/url-parse/-/url-parse-1.5.10.tgz", "integrity": "sha512-WypcfiRhfeUP9vvF0j6rw0J3hrWrw6iZv3+22h6iRMJ/8z1Tj6XfLP4DsUix5MhMPnXpiHDoKyoZ/bdCkwBCiQ==", "license": "MIT", - "peer": true, "dependencies": { "querystringify": "^2.1.1", "requires-port": "^1.0.0" diff --git a/package.json b/package.json index efa4bdc..e7b0cbe 100644 --- a/package.json +++ b/package.json @@ -79,30 +79,31 @@ }, "devDependencies": { "@stylistic/eslint-plugin-ts": "^4.4.1", - "@types/amqplib": "^0.10.7", + "@types/amqplib": "^0.10.8", "@types/better-sqlite3": "^7.6.13", "@types/chai": "^4.3.20", "@types/jest": "^29.5.14", - "@types/md5": "^2.3.5", - "@types/node": "^20.19.21", + "@types/md5": "^2.3.6", + "@types/node": "^20.19.30", "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", "chai": "^4.5.0", "conventional-changelog": "^3.1.25", - "eslint": "^9.37.0", + "eslint": "^9.39.2", "eslint-plugin-jest": "^28.14.0", - "globals": "^16.4.0", + "globals": "^16.5.0", "jest": "^29.7.0", "sinon": "^19.0.5", - "ts-jest": "^29.4.5", + "ts-jest": "^29.4.6", "ts-node": "^10.9.2", "typescript": "^5.9.3", - "typescript-eslint": "^8.46.1" + "typescript-eslint": "^8.53.1" }, "peerDependencies": { "amqplib": "^0.10.9", "better-sqlite3": "^11.10.0", + "comlink": "^4.4.2", "md5": "^2.3.0" } } diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 8b106c4..7434042 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -123,7 +123,7 @@ export abstract class AbstractProjection implements IProjection { - if (this._viewLocker && !this._viewLocker?.ready) { + if (this._viewLocker && !this._viewLocker.ready) { this._logger?.debug(`view is locked, awaiting until it is ready to process ${describe(event)}`); await this._viewLocker.once('ready'); this._logger?.debug(`view is ready, processing ${describe(event)}`); diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index b8473ed..193e6ad 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -1,8 +1,10 @@ import * as path from 'node:path'; -import { isMainThread, Worker } from 'node:worker_threads'; - +import { isMainThread, Worker, MessageChannel, parentPort, type MessagePort, workerData } from 'node:worker_threads'; import { AbstractProjection, type AbstractProjectionParams } from '../AbstractProjection'; -import type { WorkerInitMessage, WorkerOutboundMessage } from './protocol'; +import type { IEvent } from '../interfaces'; +import * as Comlink from 'comlink'; +import { nodeEndpoint } from './utils'; +import { extractErrorDetails } from '../utils'; export type AbstractWorkerProjectionParams = AbstractProjectionParams & { @@ -13,15 +15,102 @@ export type AbstractWorkerProjectionParams = AbstractProjectionParams extends AbstractProjection { +interface IRemoteProjectionApi { + project(event: IEvent): Promise | void; + ping(): true; +} + +interface IMainThreadProjection { + get remoteProjection(): Comlink.Remote; + get remoteView(): Comlink.Remote; +} + +interface IWorkerData { + projectionPort: MessagePort, + viewPort: MessagePort +} + +const isWorkerData = (obj: unknown): obj is IWorkerData => + typeof obj === 'object' + && obj !== null + && 'projectionPort' in obj + && !!obj.projectionPort + && 'viewPort' in obj + && !!obj.viewPort; + +type WorkerInitMessage = { type: 'ready' }; + +const isWorkerInitMessage = (msg: unknown): msg is WorkerInitMessage => + typeof msg === 'object' + && msg !== null + && 'type' in msg + && msg.type === 'ready'; - readonly #workerModulePath?: string; +export abstract class AbstractWorkerProjection extends AbstractProjection { #worker?: Worker; - #workerReady?: Promise; + readonly #workerInit?: Promise; + readonly #remoteProjection?: Comlink.Remote; + readonly #remoteView?: Comlink.Remote; + + /** + * Creates an instance of a class derived from AbstractWorkerProjection in a Worker thread + * + * @param factory - Optional factory function to create the projection instance + */ + static createWorkerInstance>( + this: new (...args: any[]) => T, + factory?: () => T + ): T { + if (!parentPort) + throw new Error('createWorkerInstance can only be called from a Worker thread'); + if (!isWorkerData(workerData)) + throw new Error('workerData does not contain projectionPort and viewPort'); + + const workerProjectionInstance = factory?.() ?? new this(); + const workerProjectionInstanceApi: IRemoteProjectionApi = { + project: event => workerProjectionInstance._project(event), + ping: () => workerProjectionInstance._pong() + }; + + Comlink.expose(workerProjectionInstanceApi, nodeEndpoint(workerData.projectionPort)); + Comlink.expose(workerProjectionInstance.view, nodeEndpoint(workerData.viewPort)); + + parentPort.postMessage({ type: 'ready' } satisfies WorkerInitMessage); + + return workerProjectionInstance; + } - protected get _worker(): Worker | undefined { - return this.#worker; + /** + * Proxy to the projection instance in the worker thread + */ + get remoteProjection(): Comlink.Remote { + this.assertMainThread(); + return this.#remoteProjection!; + } + + /** + * Proxy to the projection instance in the worker thread (awaits worker init) + */ + get remoteProjectionInitializer(): Promise> { + this.assertMainThread(); + return this.ensureWorkerReady().then(() => this.remoteProjection); + } + + /** + * Proxy to the view instance in the worker thread + */ + get remoteView(): Comlink.Remote { + this.assertMainThread(); + return this.#remoteView!; + } + + /** + * Proxy to the view instance in the worker thread (awaits worker init) + */ + get remoteViewInitializer(): Promise> { + this.assertMainThread(); + return this.ensureWorkerReady().then(() => this.remoteView); } constructor({ @@ -31,9 +120,6 @@ export abstract class AbstractWorkerProjection extends AbstractProj eventLocker, logger }: AbstractWorkerProjectionParams = {}) { - if (isMainThread && (typeof workerModulePath !== 'string' || !workerModulePath.length)) - throw new TypeError('workerModulePath parameter is required in the main thread'); - super({ view, viewLocker, @@ -41,95 +127,137 @@ export abstract class AbstractWorkerProjection extends AbstractProj logger }); - this.#workerModulePath = workerModulePath; + if (isMainThread) { + if (!workerModulePath) + throw new TypeError('workerModulePath parameter is required in the main thread'); - if (isMainThread) - this.ensureWorkerReady().catch(() => {}); + const { port1: projectionPortMain, port2: projectionPort } = new MessageChannel(); + const { port1: viewPortMain, port2: viewPort } = new MessageChannel(); - } + this.#workerInit = this._createWorker(workerModulePath, { + projectionPort, + viewPort + }).then(worker => { + this.#worker = worker; + worker.once('error', this._onWorkerError); + worker.once('exit', this._onWorkerExit); + return worker; + }); - async ensureWorkerReady(): Promise { - if (!isMainThread) - throw new Error('_ensureWorkerReady can only be called from the main thread'); + this.#workerInit.catch(() => { }); - this.#workerReady ??= this._startWorkerAndHandshake(); - - return this.#workerReady; - } - - async dispose(): Promise { - const worker = this.#worker; - this.#worker = undefined; - this.#workerReady = undefined; - - if (worker) - await worker.terminate(); + this.#remoteProjection = Comlink.wrap(nodeEndpoint(projectionPortMain)); + this.#remoteView = Comlink.wrap(nodeEndpoint(viewPortMain)); + } } - protected _getWorkerEntrypoint(): string { - const workerModulePath = this.#workerModulePath; - if (typeof workerModulePath !== 'string' || !workerModulePath.length) - throw new Error('workerModulePath is required to start worker'); - - return path.isAbsolute(workerModulePath) ? + // eslint-disable-next-line class-methods-use-this + protected async _createWorker(workerModulePath: string, workerData: IWorkerData): Promise { + const workerEntrypoint = path.isAbsolute(workerModulePath) ? workerModulePath : path.resolve(process.cwd(), workerModulePath); - } - protected _createWorker(): Worker { - const workerEntrypoint = this._getWorkerEntrypoint(); - return new Worker(workerEntrypoint); - } + const worker = new Worker(workerEntrypoint, { + workerData, + transferList: [ + workerData.projectionPort, + workerData.viewPort + ] + }); - private async _startWorkerAndHandshake(): Promise { - const worker = this._createWorker(); - this.#worker = worker; + await new Promise((resolve, reject) => { - const initResult = await new Promise>((resolve, reject) => { const cleanup = () => { - // eslint-disable-next-line no-use-before-define - worker.off('message', onMessage); // eslint-disable-next-line no-use-before-define worker.off('error', onError); // eslint-disable-next-line no-use-before-define + worker.off('message', onMessage); + // eslint-disable-next-line no-use-before-define worker.off('exit', onExit); }; - const onMessage = (message: WorkerOutboundMessage) => { - if (message.kind !== 'ready' && message.kind !== 'init.error') + const onMessage = (msg: unknown) => { + if (!isWorkerInitMessage(msg)) return; + cleanup(); - resolve(message); + resolve(undefined); }; - const onError = (err: Error) => { + const onError = (err: unknown) => { cleanup(); reject(err); }; - const onExit = (code: number) => { + + const onExit = (exitCode: number) => { cleanup(); - reject(new Error(`Worker exited before ready (code=${code})`)); + reject(new Error(`Worker exited prematurely with exit code ${exitCode}`)); }; worker.on('message', onMessage); worker.once('error', onError); worker.once('exit', onExit); + }); - worker.postMessage({ kind: 'init' } satisfies WorkerInitMessage); + return worker; + } + + protected _onWorkerError = (error: unknown) => { + this._logger?.error('worker error', { + error: extractErrorDetails(error) }); + }; + + protected _onWorkerExit = (exitCode: number) => { + if (exitCode !== 0) + this._logger?.error(`worker exited with code ${exitCode}`); + }; + + protected _pong(): true { + this.assertWorkerThread(); + return true; + } + + protected assertMainThread(): asserts this is this & IMainThreadProjection { + if (!isMainThread) + throw new Error('This method can only be called from the main thread'); + if (!this.#workerInit) + throw new Error('Worker instance is not initialized'); + if (!this.#remoteProjection) + throw new Error('Remote projection instance is not initialized'); + if (!this.#remoteView) + throw new Error('Remote view instance is not initialized'); + } - if (initResult.kind === 'init.error') { - await worker.terminate(); - this.#worker = undefined; + // eslint-disable-next-line class-methods-use-this + protected assertWorkerThread() { + if (!parentPort) + throw new Error('This method can only be called from a Worker thread'); + } + + async ensureWorkerReady(): Promise { + this.assertMainThread(); + await this.#workerInit; + } + + protected async _project(event: IEvent): Promise { + if (isMainThread) { + this.assertMainThread(); - const err = new Error(initResult.error.message); - err.name = initResult.error.name; - if (initResult.error.stack) - err.stack = initResult.error.stack; + if (!this.#worker) + await this.#workerInit; - throw err; + return this.remoteProjection.project(event); } - return worker; + return super._project(event); + } + + dispose() { + if (isMainThread) { + this.#remoteProjection?.[Comlink.releaseProxy](); + this.#remoteView?.[Comlink.releaseProxy](); + this.#worker?.terminate(); + } } } diff --git a/src/workers/exposeWorkerProjection.ts b/src/workers/exposeWorkerProjection.ts deleted file mode 100644 index 75c0cb3..0000000 --- a/src/workers/exposeWorkerProjection.ts +++ /dev/null @@ -1,53 +0,0 @@ -import { isMainThread, parentPort } from 'node:worker_threads'; - -import type { SerializedError, WorkerInitMessage, WorkerOutboundMessage } from './protocol'; - -function serializeError(err: unknown): SerializedError { - if (err instanceof Error) { - return { - name: err.name, - message: err.message, - stack: err.stack - }; - } - - return { - name: 'Error', - message: typeof err === 'string' ? err : 'Unknown error', - details: err - }; -} - -/** - * Exposes the given projection constructor as a worker projection. - * - * Intended usage: call this at the bottom of the derived projection module so that - * the projection implementation file can be used as the Worker entrypoint. - */ -export function exposeWorkerProjection(ProjectionCtor: new (...args: any[]) => T) { - if (isMainThread) - return; - if (!parentPort) - throw new Error('exposeWorkerProjection must be called inside a Worker thread'); - - let projectionInstance: T; - - parentPort.on('message', async (message: WorkerInitMessage) => { - if (message?.kind !== 'init') - return; - if (projectionInstance) - return; - - try { - projectionInstance = new ProjectionCtor(); - - const outbound: WorkerOutboundMessage = { kind: 'ready' }; - parentPort!.postMessage(outbound); - } - catch (err) { - const outbound: WorkerOutboundMessage = { kind: 'init.error', error: serializeError(err) }; - parentPort!.postMessage(outbound); - setImmediate(() => process.exit(1)); - } - }); -} diff --git a/src/workers/index.ts b/src/workers/index.ts index ab6f8f2..f5e88b1 100644 --- a/src/workers/index.ts +++ b/src/workers/index.ts @@ -1,3 +1 @@ -export * from './protocol'; export * from './AbstractWorkerProjection'; -export * from './exposeWorkerProjection'; diff --git a/src/workers/protocol.ts b/src/workers/protocol.ts deleted file mode 100644 index 89355b8..0000000 --- a/src/workers/protocol.ts +++ /dev/null @@ -1,26 +0,0 @@ -export type SerializedError = { - name: string; - message: string; - stack?: string; - details?: any; -}; - -export type WorkerInitMessage = { - kind: 'init'; -}; - -export type WorkerReadyMessage = { - kind: 'ready'; -}; - -export type WorkerInitErrorMessage = { - kind: 'init.error'; - error: SerializedError; -}; - -export type WorkerInboundMessage = - | WorkerInitMessage; - -export type WorkerOutboundMessage = - | WorkerReadyMessage - | WorkerInitErrorMessage; diff --git a/src/workers/utils/index.ts b/src/workers/utils/index.ts new file mode 100644 index 0000000..9a5a966 --- /dev/null +++ b/src/workers/utils/index.ts @@ -0,0 +1 @@ +export * from './nodeEndpoint'; diff --git a/src/workers/utils/nodeEndpoint.ts b/src/workers/utils/nodeEndpoint.ts new file mode 100644 index 0000000..13869bd --- /dev/null +++ b/src/workers/utils/nodeEndpoint.ts @@ -0,0 +1,7 @@ +import * as Comlink from 'comlink'; + +// Jest (CJS) cannot import the ESM adapter; +// the UMD build is CJS/UMD but the default export shape varies by loader +const nodeEndpointModule = require('comlink/dist/umd/node-adapter'); +export const nodeEndpoint: (arg: any) => Comlink.Endpoint = + (nodeEndpointModule?.default ?? nodeEndpointModule) as any; diff --git a/tests/unit/workers/AbstractWorkerProjection.test.ts b/tests/unit/workers/AbstractWorkerProjection.test.ts new file mode 100644 index 0000000..db962b4 --- /dev/null +++ b/tests/unit/workers/AbstractWorkerProjection.test.ts @@ -0,0 +1,53 @@ +import { expect } from 'chai'; +import * as path from 'node:path'; + +type ProjectionFixtureCtor = typeof import('./fixtures/ProjectionFixture.cjs'); +// eslint-disable-next-line global-require +const ProjectionFixture = require('./fixtures/ProjectionFixture.cjs') as ProjectionFixtureCtor; + +describe('AbstractWorkerProjection', () => { + + it('handles missing worker module error', async () => { + const workerModulePath = path.resolve(process.cwd(), 'tests/unit/workers/fixtures/DOES_NOT_EXIST.cjs'); + const projection = new ProjectionFixture({ workerModulePath }); + try { + let error: any; + try { + await projection.ensureWorkerReady(); + } + catch (err) { + error = err; + } + + expect(error).to.be.ok; + expect(error).to.have.property('message').that.includes('DOES_NOT_EXIST'); + } + finally { + projection.dispose(); + } + }); + + it('spawns worker with an instance of projection', async () => { + const projection = new ProjectionFixture(); + try { + await projection.ensureWorkerReady(); + const pong = await projection.remoteProjection.ping(); + expect(pong).to.be.ok; + } + finally { + projection.dispose(); + } + }); + + it('exposes remote view', async () => { + const projection = new ProjectionFixture(); + try { + await projection.ensureWorkerReady(); + const counter = await projection.remoteView.getCounter(); + expect(counter).to.eq(0); + } + finally { + projection.dispose(); + } + }); +}); diff --git a/tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts b/tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts deleted file mode 100644 index 08d0eee..0000000 --- a/tests/unit/workers/AbstractWorkerProjectionBootstrap.test.ts +++ /dev/null @@ -1,40 +0,0 @@ -import { expect } from 'chai'; -import * as path from 'node:path'; - -type ProjectionFixtureCtor = typeof import('./fixtures/ProjectionFixture.cjs'); -// eslint-disable-next-line global-require -const ProjectionFixture = require('./fixtures/ProjectionFixture.cjs') as ProjectionFixtureCtor; - -describe('workers/AbstractWorkerProjection bootstrap', () => { - - it('spawns worker and completes handshake', async () => { - const fixturePath = path.resolve(process.cwd(), 'tests/unit/workers/fixtures/ProjectionFixture.cjs'); - const projection = new ProjectionFixture({ workerModulePath: fixturePath }); - try { - await projection.ensureWorkerReady(); - } - finally { - await projection.dispose(); - } - }); - - it('fails deterministically when worker module is missing', async () => { - const missingPath = path.resolve(process.cwd(), 'tests/unit/workers/fixtures/DOES_NOT_EXIST.cjs'); - const projection = new ProjectionFixture({ workerModulePath: missingPath }); - try { - let error: any; - try { - await projection.ensureWorkerReady(); - } - catch (err) { - error = err; - } - - expect(error).to.be.ok; - expect(error).to.have.property('message').that.includes('DOES_NOT_EXIST'); - } - finally { - await projection.dispose(); - } - }); -}); diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index 28c56b7..bdbb964 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -1,30 +1,51 @@ /** @type {typeof import('../../../../src/workers')} */ // @ts-ignore const workers = require('../../../../dist/workers'); +const { isMainThread } = require('node:worker_threads'); -const { AbstractWorkerProjection, exposeWorkerProjection } = workers; +const { AbstractWorkerProjection } = workers; +class ViewFixture { + counter = 0; + + increment() { + this.counter += 1; + } + + getCounter() { + return this.counter; + } +} + +/** + * @extends {AbstractWorkerProjection} + */ class ProjectionFixture extends AbstractWorkerProjection { + /** * @param {any} container */ constructor({ workerModulePath = __filename, - view, - viewLocker, - eventLocker, logger } = {}) { super({ workerModulePath, - view, - viewLocker, - eventLocker, + view: new ViewFixture(), logger }); } + + async somethingHappened() { + this.view.increment(); + } + + async somethingBadHappened() { + throw new Error('boom'); + } } -exposeWorkerProjection(ProjectionFixture); +if (!isMainThread) + ProjectionFixture.createWorkerInstance(); module.exports = ProjectionFixture; diff --git a/tests/unit/workers/fixtures/ProjectionFixture.ts b/tests/unit/workers/fixtures/ProjectionFixture.ts new file mode 100644 index 0000000..59db75d --- /dev/null +++ b/tests/unit/workers/fixtures/ProjectionFixture.ts @@ -0,0 +1,39 @@ +import { AbstractWorkerProjection } from '../../../../src/workers'; +const { isMainThread } = require('node:worker_threads'); + +class ViewFixture { + counter = 0; + + increment() { + this.counter += 1; + } + + getCounter() { + return this.counter; + } +} + +export class ProjectionFixture extends AbstractWorkerProjection { + + get view() { + return super.view; + } + + constructor({ workerModulePath = __filename } = {}) { + super({ + workerModulePath, + view: new ViewFixture() + }); + } + + async somethingHappened() { + this.view.increment(); + } + + async somethingBadHappened() { + throw new Error('boom'); + } +} + +if (!isMainThread) + ProjectionFixture.createWorkerInstance(); From 73ff45192e380af47dd3c7fe57d38e8e14ea5890 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 02:11:39 +0000 Subject: [PATCH 135/169] Handle worker projections restoring --- src/interfaces/IEventLocker.ts | 15 ++- src/interfaces/IViewLocker.ts | 18 ++- src/workers/AbstractWorkerProjection.ts | 26 +++- .../workers/AbstractWorkerProjection.test.ts | 117 +++++++++++++++++- .../workers/fixtures/ProjectionFixture.cjs | 61 +++++++++ 5 files changed, 225 insertions(+), 12 deletions(-) diff --git a/src/interfaces/IEventLocker.ts b/src/interfaces/IEventLocker.ts index d3388b1..c2d0541 100644 --- a/src/interfaces/IEventLocker.ts +++ b/src/interfaces/IEventLocker.ts @@ -28,7 +28,14 @@ export interface IEventLocker { } export const isEventLocker = (view: unknown): view is IEventLocker => - isObject(view) - && 'getLastEvent' in view - && 'tryMarkAsProjecting' in view - && 'markAsProjected' in view; + ( + isObject(view) + && 'getLastEvent' in view + && 'tryMarkAsProjecting' in view + && 'markAsProjected' in view + ) || ( + typeof view === 'function' + && typeof (view as any).getLastEvent === 'function' + && typeof (view as any).tryMarkAsProjecting === 'function' + && typeof (view as any).markAsProjected === 'function' + ); diff --git a/src/interfaces/IViewLocker.ts b/src/interfaces/IViewLocker.ts index fefcd2d..1dd517c 100644 --- a/src/interfaces/IViewLocker.ts +++ b/src/interfaces/IViewLocker.ts @@ -39,8 +39,16 @@ export interface IViewLocker { * @returns `true` if the object implements `IViewLocker`, `false` otherwise. */ export const isViewLocker = (view: unknown): view is IViewLocker => - isObject(view) - && 'ready' in view - && 'lock' in view - && 'unlock' in view - && 'once' in view; + ( + isObject(view) + && 'ready' in view + && 'lock' in view + && 'unlock' in view + && 'once' in view + ) || ( + typeof view === 'function' + && typeof (view as any).lock === 'function' + && typeof (view as any).unlock === 'function' + && typeof (view as any).once === 'function' + && (view as any).ready !== undefined + ); diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index 193e6ad..d1ceaaa 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -17,6 +17,7 @@ export type AbstractWorkerProjectionParams = AbstractProjectionParams | void; + _project(event: IEvent): Promise | void; ping(): true; } @@ -69,7 +70,8 @@ export abstract class AbstractWorkerProjection extends AbstractProjection const workerProjectionInstance = factory?.() ?? new this(); const workerProjectionInstanceApi: IRemoteProjectionApi = { - project: event => workerProjectionInstance._project(event), + project: event => workerProjectionInstance.project(event), + _project: event => workerProjectionInstance._project(event), ping: () => workerProjectionInstance._pong() }; @@ -81,6 +83,19 @@ export abstract class AbstractWorkerProjection extends AbstractProjection return workerProjectionInstance; } + async project(event: IEvent): Promise { + if (isMainThread) { + this.assertMainThread(); + + if (!this.#worker) + await this.#workerInit; + + return this.remoteProjection.project(event); + } + + return super.project(event); + } + /** * Proxy to the projection instance in the worker thread */ @@ -105,6 +120,13 @@ export abstract class AbstractWorkerProjection extends AbstractProjection return this.#remoteView!; } + get view(): TView { + if (isMainThread) + return this.remoteView as unknown as TView; + + return super.view; + } + /** * Proxy to the view instance in the worker thread (awaits worker init) */ @@ -247,7 +269,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection if (!this.#worker) await this.#workerInit; - return this.remoteProjection.project(event); + return this.remoteProjection._project(event); } return super._project(event); diff --git a/tests/unit/workers/AbstractWorkerProjection.test.ts b/tests/unit/workers/AbstractWorkerProjection.test.ts index db962b4..45068c6 100644 --- a/tests/unit/workers/AbstractWorkerProjection.test.ts +++ b/tests/unit/workers/AbstractWorkerProjection.test.ts @@ -1,10 +1,24 @@ import { expect } from 'chai'; import * as path from 'node:path'; +import type { IEvent } from '../../../src/interfaces'; type ProjectionFixtureCtor = typeof import('./fixtures/ProjectionFixture.cjs'); // eslint-disable-next-line global-require const ProjectionFixture = require('./fixtures/ProjectionFixture.cjs') as ProjectionFixtureCtor; +function createEventStore(events: IEvent[]) { + return { + getEventsByTypes: (types: string[], options?: { afterEvent?: IEvent }) => (async function* () { + const afterId = options?.afterEvent?.id; + const startIndex = afterId ? Math.max(0, events.findIndex(e => e.id === afterId) + 1) : 0; + for (const event of events.slice(startIndex)) { + if (types.includes(event.type)) + yield event; + } + }()) + } as any; +} + describe('AbstractWorkerProjection', () => { it('handles missing worker module error', async () => { @@ -43,11 +57,112 @@ describe('AbstractWorkerProjection', () => { const projection = new ProjectionFixture(); try { await projection.ensureWorkerReady(); - const counter = await projection.remoteView.getCounter(); + const counter = await projection.view.getCounter(); expect(counter).to.eq(0); } finally { projection.dispose(); } }); + + it('locks view during restore and unlocks on success', async () => { + const projection = new ProjectionFixture(); + try { + const eventStore = createEventStore([ + { id: '1', type: 'somethingHappened' }, + { id: '2', type: 'somethingHappened' } + ]); + + await projection.restore(eventStore); + + await projection.ensureWorkerReady(); + expect(await projection.view.getLockCalls()).to.equal(1); + expect(await projection.view.getUnlockCalls()).to.equal(1); + expect(await projection.view.isReady()).to.equal(true); + expect((await projection.view.getLastEvent())?.id).to.equal('2'); + expect(await projection.view.getCounter()).to.equal(2); + } + finally { + projection.dispose(); + } + }); + + it('restores only events after getLastEvent', async () => { + const projection = new ProjectionFixture(); + try { + await projection.restore(createEventStore([ + { id: '1', type: 'somethingHappened' }, + { id: '2', type: 'somethingHappened' } + ])); + + await projection.restore(createEventStore([ + { id: '1', type: 'somethingBadHappened' }, + { id: '2', type: 'somethingBadHappened' }, + { id: '3', type: 'somethingHappened' } + ])); + + await projection.ensureWorkerReady(); + expect(await projection.view.getLockCalls()).to.equal(2); + expect(await projection.view.getUnlockCalls()).to.equal(2); + expect((await projection.view.getLastEvent())?.id).to.equal('3'); + expect(await projection.view.getCounter()).to.equal(3); + } + finally { + projection.dispose(); + } + }); + + it('halts restore on handler error and keeps view locked', async () => { + const projection = new ProjectionFixture(); + try { + const eventStore = createEventStore([ + { id: '1', type: 'somethingHappened' }, + { id: '2', type: 'somethingBadHappened' }, + { id: '3', type: 'somethingHappened' } + ]); + + let error: any; + try { + await projection.restore(eventStore); + } + catch (err) { + error = err; + } + + expect(error).to.be.instanceOf(Error); + expect(error).to.have.property('message', 'boom'); + + await projection.ensureWorkerReady(); + expect(await projection.view.getLockCalls()).to.equal(1); + expect(await projection.view.getUnlockCalls()).to.equal(0); + expect(await projection.view.isReady()).to.equal(false); + expect((await projection.view.getLastEvent())?.id).to.equal('1'); + expect(await projection.view.getCounter()).to.equal(1); + } + finally { + projection.dispose(); + } + }); + + it('does not project events when event lock is not obtained', async () => { + const projection = new ProjectionFixture(); + try { + await projection.ensureWorkerReady(); + await projection.view.setSkipIds(['1']); + + const eventStore = createEventStore([ + { id: '1', type: 'somethingHappened' }, + { id: '2', type: 'somethingHappened' } + ]); + + await projection.restore(eventStore); + + await projection.ensureWorkerReady(); + expect((await projection.view.getLastEvent())?.id).to.equal('2'); + expect(await projection.view.getCounter()).to.equal(1); + } + finally { + projection.dispose(); + } + }); }); diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index bdbb964..fc68b2e 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -7,6 +7,14 @@ const { AbstractWorkerProjection } = workers; class ViewFixture { counter = 0; + ready = true; + + #lockCalls = 0; + #unlockCalls = 0; + #lastEvent = null; + #skipIds = new Set(); + #readyPromise = Promise.resolve(); + #resolveReady = null; increment() { this.counter += 1; @@ -15,6 +23,59 @@ class ViewFixture { getCounter() { return this.counter; } + + setSkipIds(ids = []) { + this.#skipIds = new Set(ids); + } + + getLockCalls() { + return this.#lockCalls; + } + + getUnlockCalls() { + return this.#unlockCalls; + } + + isReady() { + return this.ready; + } + + async lock() { + this.#lockCalls += 1; + this.ready = false; + this.#readyPromise = new Promise(resolve => { + this.#resolveReady = resolve; + }); + return true; + } + + async unlock() { + this.#unlockCalls += 1; + this.ready = true; + if (this.#resolveReady) + this.#resolveReady(); + this.#resolveReady = null; + } + + once(event) { + if (event !== 'ready') + throw new Error(`Unexpected event: ${event}`); + return this.#readyPromise; + } + + getLastEvent() { + return this.#lastEvent; + } + + tryMarkAsProjecting(event) { + if (event?.id && this.#skipIds.has(event.id)) + return false; + return true; + } + + markAsProjected(event) { + this.#lastEvent = event; + } } /** From 0bc9bda5029c2a91a97b7108d5d4058785767101 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 11:57:37 +0000 Subject: [PATCH 136/169] Update tests for view locking during restoration behavior --- .../workers/AbstractWorkerProjection.test.ts | 40 +++++++++++++++---- .../workers/fixtures/ProjectionFixture.cjs | 31 +++++++++----- 2 files changed, 53 insertions(+), 18 deletions(-) diff --git a/tests/unit/workers/AbstractWorkerProjection.test.ts b/tests/unit/workers/AbstractWorkerProjection.test.ts index 45068c6..73991c2 100644 --- a/tests/unit/workers/AbstractWorkerProjection.test.ts +++ b/tests/unit/workers/AbstractWorkerProjection.test.ts @@ -41,6 +41,35 @@ describe('AbstractWorkerProjection', () => { } }); + it('awaits view method calls while restoring', async () => { + const projection = new ProjectionFixture(); + try { + const eventStore = createEventStore([ + { id: '1', type: 'slowHappened' } + ]); + + const restorePromise = projection.restore(eventStore); + + await new Promise(resolve => setTimeout(resolve, 10)); + + const counterPromise = projection.view.getCounter(); + + const resolvedEarly = await Promise.race([ + counterPromise.then(() => true), + new Promise(resolve => setTimeout(() => resolve(false), 20)) + ]); + + expect(resolvedEarly).to.equal(false); + + await restorePromise; + + expect(await counterPromise).to.equal(1); + } + finally { + projection.dispose(); + } + }); + it('spawns worker with an instance of projection', async () => { const projection = new ProjectionFixture(); try { @@ -76,8 +105,7 @@ describe('AbstractWorkerProjection', () => { await projection.restore(eventStore); await projection.ensureWorkerReady(); - expect(await projection.view.getLockCalls()).to.equal(1); - expect(await projection.view.getUnlockCalls()).to.equal(1); + expect(await projection.view.getCalls()).to.deep.equal({ lock: 1, unlock: 1 }); expect(await projection.view.isReady()).to.equal(true); expect((await projection.view.getLastEvent())?.id).to.equal('2'); expect(await projection.view.getCounter()).to.equal(2); @@ -102,8 +130,7 @@ describe('AbstractWorkerProjection', () => { ])); await projection.ensureWorkerReady(); - expect(await projection.view.getLockCalls()).to.equal(2); - expect(await projection.view.getUnlockCalls()).to.equal(2); + expect(await projection.view.getCalls()).to.deep.equal({ lock: 2, unlock: 2 }); expect((await projection.view.getLastEvent())?.id).to.equal('3'); expect(await projection.view.getCounter()).to.equal(3); } @@ -133,11 +160,10 @@ describe('AbstractWorkerProjection', () => { expect(error).to.have.property('message', 'boom'); await projection.ensureWorkerReady(); - expect(await projection.view.getLockCalls()).to.equal(1); - expect(await projection.view.getUnlockCalls()).to.equal(0); + expect(await projection.view.getCalls()).to.deep.equal({ lock: 1, unlock: 0 }); expect(await projection.view.isReady()).to.equal(false); expect((await projection.view.getLastEvent())?.id).to.equal('1'); - expect(await projection.view.getCounter()).to.equal(1); + expect(await projection.view.getCounterNowait()).to.equal(1); } finally { projection.dispose(); diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index fc68b2e..7186114 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -9,8 +9,10 @@ class ViewFixture { counter = 0; ready = true; - #lockCalls = 0; - #unlockCalls = 0; + #calls = { + lock: 0, + unlock: 0 + }; #lastEvent = null; #skipIds = new Set(); #readyPromise = Promise.resolve(); @@ -20,20 +22,22 @@ class ViewFixture { this.counter += 1; } - getCounter() { + async getCounter() { + if (!this.ready) + await this.once('ready'); return this.counter; } - setSkipIds(ids = []) { - this.#skipIds = new Set(ids); + getCounterNowait() { + return this.counter; } - getLockCalls() { - return this.#lockCalls; + setSkipIds(ids = []) { + this.#skipIds = new Set(ids); } - getUnlockCalls() { - return this.#unlockCalls; + getCalls() { + return { ...this.#calls }; } isReady() { @@ -41,7 +45,7 @@ class ViewFixture { } async lock() { - this.#lockCalls += 1; + this.#calls.lock += 1; this.ready = false; this.#readyPromise = new Promise(resolve => { this.#resolveReady = resolve; @@ -50,7 +54,7 @@ class ViewFixture { } async unlock() { - this.#unlockCalls += 1; + this.#calls.unlock += 1; this.ready = true; if (this.#resolveReady) this.#resolveReady(); @@ -101,6 +105,11 @@ class ProjectionFixture extends AbstractWorkerProjection { this.view.increment(); } + async slowHappened() { + await new Promise(resolve => setTimeout(resolve, 50)); + this.view.increment(); + } + async somethingBadHappened() { throw new Error('boom'); } From c7e076a1ead63df20e213857479ff34d541ed833 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 16:33:38 +0000 Subject: [PATCH 137/169] Add `useWorkerThreads` configuration parameter --- src/workers/AbstractWorkerProjection.ts | 109 ++++-------------- src/workers/protocol.ts | 23 ++++ src/workers/utils/createWorker.ts | 61 ++++++++++ src/workers/utils/index.ts | 1 + .../workers/AbstractWorkerProjection.test.ts | 28 +++++ .../workers/fixtures/ProjectionFixture.cjs | 2 + 6 files changed, 140 insertions(+), 84 deletions(-) create mode 100644 src/workers/protocol.ts create mode 100644 src/workers/utils/createWorker.ts diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index d1ceaaa..84669d7 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -1,10 +1,10 @@ -import * as path from 'node:path'; -import { isMainThread, Worker, MessageChannel, parentPort, type MessagePort, workerData } from 'node:worker_threads'; +import { isMainThread, Worker, MessageChannel, parentPort, workerData } from 'node:worker_threads'; import { AbstractProjection, type AbstractProjectionParams } from '../AbstractProjection'; import type { IEvent } from '../interfaces'; import * as Comlink from 'comlink'; -import { nodeEndpoint } from './utils'; +import { nodeEndpoint, createWorker } from './utils'; import { extractErrorDetails } from '../utils'; +import { isWorkerData, type IWorkerData, type WorkerInitMessage } from './protocol'; export type AbstractWorkerProjectionParams = AbstractProjectionParams & { @@ -13,6 +13,12 @@ export type AbstractWorkerProjectionParams = AbstractProjectionParams { get remoteView(): Comlink.Remote; } -interface IWorkerData { - projectionPort: MessagePort, - viewPort: MessagePort -} - -const isWorkerData = (obj: unknown): obj is IWorkerData => - typeof obj === 'object' - && obj !== null - && 'projectionPort' in obj - && !!obj.projectionPort - && 'viewPort' in obj - && !!obj.viewPort; - -type WorkerInitMessage = { type: 'ready' }; - -const isWorkerInitMessage = (msg: unknown): msg is WorkerInitMessage => - typeof msg === 'object' - && msg !== null - && 'type' in msg - && msg.type === 'ready'; - export abstract class AbstractWorkerProjection extends AbstractProjection { #worker?: Worker; readonly #workerInit?: Promise; readonly #remoteProjection?: Comlink.Remote; readonly #remoteView?: Comlink.Remote; + readonly #useWorkerThreads: boolean; /** * Creates an instance of a class derived from AbstractWorkerProjection in a Worker thread @@ -84,9 +70,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection } async project(event: IEvent): Promise { - if (isMainThread) { - this.assertMainThread(); - + if (this.#useWorkerThreads && isMainThread) { if (!this.#worker) await this.#workerInit; @@ -121,7 +105,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection } get view(): TView { - if (isMainThread) + if (this.#useWorkerThreads && isMainThread) return this.remoteView as unknown as TView; return super.view; @@ -137,6 +121,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection constructor({ workerModulePath, + useWorkerThreads = true, view, viewLocker, eventLocker, @@ -149,9 +134,11 @@ export abstract class AbstractWorkerProjection extends AbstractProjection logger }); - if (isMainThread) { + this.#useWorkerThreads = useWorkerThreads; + + if (this.#useWorkerThreads && isMainThread) { if (!workerModulePath) - throw new TypeError('workerModulePath parameter is required in the main thread'); + throw new TypeError('workerModulePath parameter is required in the main thread when useWorkerThreads=true'); const { port1: projectionPortMain, port2: projectionPort } = new MessageChannel(); const { port1: viewPortMain, port2: viewPort } = new MessageChannel(); @@ -174,54 +161,8 @@ export abstract class AbstractWorkerProjection extends AbstractProjection } // eslint-disable-next-line class-methods-use-this - protected async _createWorker(workerModulePath: string, workerData: IWorkerData): Promise { - const workerEntrypoint = path.isAbsolute(workerModulePath) ? - workerModulePath : - path.resolve(process.cwd(), workerModulePath); - - const worker = new Worker(workerEntrypoint, { - workerData, - transferList: [ - workerData.projectionPort, - workerData.viewPort - ] - }); - - await new Promise((resolve, reject) => { - - const cleanup = () => { - // eslint-disable-next-line no-use-before-define - worker.off('error', onError); - // eslint-disable-next-line no-use-before-define - worker.off('message', onMessage); - // eslint-disable-next-line no-use-before-define - worker.off('exit', onExit); - }; - - const onMessage = (msg: unknown) => { - if (!isWorkerInitMessage(msg)) - return; - - cleanup(); - resolve(undefined); - }; - - const onError = (err: unknown) => { - cleanup(); - reject(err); - }; - - const onExit = (exitCode: number) => { - cleanup(); - reject(new Error(`Worker exited prematurely with exit code ${exitCode}`)); - }; - - worker.on('message', onMessage); - worker.once('error', onError); - worker.once('exit', onExit); - }); - - return worker; + protected async _createWorker(workerModulePath: string, data: IWorkerData): Promise { + return createWorker(workerModulePath, data); } protected _onWorkerError = (error: unknown) => { @@ -243,6 +184,8 @@ export abstract class AbstractWorkerProjection extends AbstractProjection protected assertMainThread(): asserts this is this & IMainThreadProjection { if (!isMainThread) throw new Error('This method can only be called from the main thread'); + if (!this.#useWorkerThreads) + throw new Error('Worker threads are disabled for this projection instance'); if (!this.#workerInit) throw new Error('Worker instance is not initialized'); if (!this.#remoteProjection) @@ -258,14 +201,12 @@ export abstract class AbstractWorkerProjection extends AbstractProjection } async ensureWorkerReady(): Promise { - this.assertMainThread(); - await this.#workerInit; + if (this.#useWorkerThreads && isMainThread) + await this.#workerInit; } protected async _project(event: IEvent): Promise { - if (isMainThread) { - this.assertMainThread(); - + if (this.#useWorkerThreads && isMainThread) { if (!this.#worker) await this.#workerInit; @@ -276,7 +217,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection } dispose() { - if (isMainThread) { + if (this.#useWorkerThreads && isMainThread) { this.#remoteProjection?.[Comlink.releaseProxy](); this.#remoteView?.[Comlink.releaseProxy](); this.#worker?.terminate(); diff --git a/src/workers/protocol.ts b/src/workers/protocol.ts new file mode 100644 index 0000000..5c9cd14 --- /dev/null +++ b/src/workers/protocol.ts @@ -0,0 +1,23 @@ +import type { MessagePort } from 'node:worker_threads'; + +export interface IWorkerData { + projectionPort: MessagePort, + viewPort: MessagePort +} + +export const isWorkerData = (obj: unknown): obj is IWorkerData => + typeof obj === 'object' + && obj !== null + && 'projectionPort' in obj + && !!obj.projectionPort + && 'viewPort' in obj + && !!obj.viewPort; + +export type WorkerInitMessage = { type: 'ready' }; + +export const isWorkerInitMessage = (msg: unknown): msg is WorkerInitMessage => + typeof msg === 'object' + && msg !== null + && 'type' in msg + && msg.type === 'ready'; + diff --git a/src/workers/utils/createWorker.ts b/src/workers/utils/createWorker.ts new file mode 100644 index 0000000..a31c8d8 --- /dev/null +++ b/src/workers/utils/createWorker.ts @@ -0,0 +1,61 @@ +import { Worker } from 'node:worker_threads'; +import * as path from 'node:path'; +import { isWorkerInitMessage, type IWorkerData } from '../protocol'; + +/** + * Create a worker instance, await a handshake or a failure + * + * @param workerModulePath - Path to worker module + * @param ports - Container with MessagePorts for communication with worker projection and view instances + * @returns Worker instance + */ +export async function createWorker(workerModulePath: string, ports: IWorkerData) { + + const workerEntrypoint = path.isAbsolute(workerModulePath) ? + workerModulePath : + path.resolve(process.cwd(), workerModulePath); + + const worker = new Worker(workerEntrypoint, { + workerData: ports, + transferList: [ + ports.projectionPort, + ports.viewPort + ] + }); + + await new Promise((resolve, reject) => { + + const cleanup = () => { + // eslint-disable-next-line no-use-before-define + worker.off('error', onError); + // eslint-disable-next-line no-use-before-define + worker.off('message', onMessage); + // eslint-disable-next-line no-use-before-define + worker.off('exit', onExit); + }; + + const onMessage = (msg: unknown) => { + if (!isWorkerInitMessage(msg)) + return; + + cleanup(); + resolve(undefined); + }; + + const onError = (err: unknown) => { + cleanup(); + reject(err); + }; + + const onExit = (exitCode: number) => { + cleanup(); + reject(new Error(`Worker exited prematurely with exit code ${exitCode}`)); + }; + + worker.on('message', onMessage); + worker.once('error', onError); + worker.once('exit', onExit); + }); + + return worker; +} diff --git a/src/workers/utils/index.ts b/src/workers/utils/index.ts index 9a5a966..d336324 100644 --- a/src/workers/utils/index.ts +++ b/src/workers/utils/index.ts @@ -1 +1,2 @@ +export * from './createWorker'; export * from './nodeEndpoint'; diff --git a/tests/unit/workers/AbstractWorkerProjection.test.ts b/tests/unit/workers/AbstractWorkerProjection.test.ts index 73991c2..3570c69 100644 --- a/tests/unit/workers/AbstractWorkerProjection.test.ts +++ b/tests/unit/workers/AbstractWorkerProjection.test.ts @@ -41,6 +41,34 @@ describe('AbstractWorkerProjection', () => { } }); + it('runs in-thread when workers are disabled', async () => { + const projection = new ProjectionFixture({ + useWorkerThreads: false, + workerModulePath: 'tests/unit/workers/fixtures/DOES_NOT_EXIST.cjs' + }); + try { + await projection.ensureWorkerReady(); + + await projection.project({ id: '1', type: 'somethingHappened' }); + expect(await projection.view.getCounter()).to.equal(1); + + let error: any; + try { + // accessing remote API should fail when workers are disabled + projection.remoteProjection; + } + catch (err) { + error = err; + } + + expect(error).to.be.instanceOf(Error); + expect((error as Error).message).to.include('Worker threads are disabled'); + } + finally { + projection.dispose(); + } + }); + it('awaits view method calls while restoring', async () => { const projection = new ProjectionFixture(); try { diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index 7186114..f8d7148 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -92,10 +92,12 @@ class ProjectionFixture extends AbstractWorkerProjection { */ constructor({ workerModulePath = __filename, + useWorkerThreads, logger } = {}) { super({ workerModulePath, + useWorkerThreads, view: new ViewFixture(), logger }); From 0282053c73d6b35665093af7ebaef422ddfef3ac Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 16:47:09 +0000 Subject: [PATCH 138/169] Add docs and example for AbstractWorkerProjection --- .../worker-projection/CounterProjection.cjs | 32 +++++++ examples/worker-projection/index.cjs | 18 ++++ src/workers/readme.md | 91 +++++++++++++++++++ 3 files changed, 141 insertions(+) create mode 100644 examples/worker-projection/CounterProjection.cjs create mode 100644 examples/worker-projection/index.cjs create mode 100644 src/workers/readme.md diff --git a/examples/worker-projection/CounterProjection.cjs b/examples/worker-projection/CounterProjection.cjs new file mode 100644 index 0000000..4d9c515 --- /dev/null +++ b/examples/worker-projection/CounterProjection.cjs @@ -0,0 +1,32 @@ +const { isMainThread } = require('node:worker_threads'); +const { AbstractWorkerProjection } = require('../../dist/workers'); + +class CounterView { + counter = 0; + + increment() { + this.counter += 1; + } + + getCounter() { + return this.counter; + } +} + +class CounterProjection extends AbstractWorkerProjection { + constructor() { + super({ + workerModulePath: __filename, + view: new CounterView() + }); + } + + somethingHappened() { + this.view.increment(); + } +} + +if (!isMainThread) + CounterProjection.createWorkerInstance(); + +module.exports = CounterProjection; diff --git a/examples/worker-projection/index.cjs b/examples/worker-projection/index.cjs new file mode 100644 index 0000000..230b185 --- /dev/null +++ b/examples/worker-projection/index.cjs @@ -0,0 +1,18 @@ +const CounterProjection = require('./CounterProjection.cjs'); + +async function main() { + const projection = new CounterProjection(); + + await projection.project({ id: '1', type: 'somethingHappened' }); + await projection.project({ id: '2', type: 'somethingHappened' }); + + const counter = await projection.view.getCounter(); + console.log('counter =', counter); + + projection.dispose(); +} + +main().catch(err => { + console.error(err); + process.exitCode = 1; +}); diff --git a/src/workers/readme.md b/src/workers/readme.md new file mode 100644 index 0000000..58d0d37 --- /dev/null +++ b/src/workers/readme.md @@ -0,0 +1,91 @@ +# Workers (Worker Projections) + +This module provides `AbstractWorkerProjection`, which lets you run projection handlers and view +computations inside a Node.js `worker_threads` Worker while keeping an `AbstractProjection`-like +API in the main thread. + +## Import + +CommonJS: + +```js +const { AbstractWorkerProjection } = require('node-cqrs/workers'); +``` + +ESM: + +```js +import { AbstractWorkerProjection } from 'node-cqrs/workers'; +``` + +## Defining a worker projection + +Key points: + +- The same projection module is used as the **worker entry point**. +- In the worker thread, the module must create the worker-side singleton via `YourProjection.createWorkerInstance()`. +- In the main thread, `project()` automatically waits for worker startup (so `ensureWorkerReady()` is optional). + +Example (CommonJS): + +```js +const { isMainThread } = require('node:worker_threads'); +const { AbstractWorkerProjection } = require('node-cqrs/workers'); + +class CounterView { + counter = 0; + increment() { this.counter += 1; } + getCounter() { return this.counter; } +} + +class CounterProjection extends AbstractWorkerProjection { + constructor() { + super({ + workerModulePath: __filename, + view: new CounterView() + }); + } + + somethingHappened() { + this.view.increment(); + } +} + +if (!isMainThread) + CounterProjection.createWorkerInstance(); + +module.exports = CounterProjection; +``` + +## Using it (main thread) + +```js +const CounterProjection = require('./CounterProjection.cjs'); + +const projection = new CounterProjection(); +await projection.project({ id: '1', type: 'somethingHappened' }); + +// `projection.view` is a remote proxy (methods-only) +const counter = await projection.view.getCounter(); + +projection.dispose(); +``` + +## `workerModulePath` patterns + +- **CommonJS**: `__filename` (inside the projection module). +- **ESM**: `fileURLToPath(import.meta.url)` inside the projection module. + +Note: `workerModulePath` must point to the **JavaScript file that Node can execute** +(e.g. `dist/...` in TS projects), not a TypeScript source file. + +Tip: call `await projection.ensureWorkerReady()` if you want to fail fast on worker startup +before processing events. + +## Disabling workers (tests) + +To run everything in-thread (no Worker, no RPC): + +```js +const projection = new CounterProjection({ useWorkerThreads: false }); +``` From 07d53102e9ca8852338e2483da0cdb09b3a27abe Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 17:11:47 +0000 Subject: [PATCH 139/169] Add `createInstanceIfWorkerThread` static helper to simplify api --- examples/worker-projection/CounterProjection.cjs | 4 +--- src/workers/AbstractWorkerProjection.ts | 16 ++++++++++++++++ src/workers/readme.md | 7 +++---- .../unit/workers/fixtures/ProjectionFixture.cjs | 4 +--- tests/unit/workers/fixtures/ProjectionFixture.ts | 4 +--- 5 files changed, 22 insertions(+), 13 deletions(-) diff --git a/examples/worker-projection/CounterProjection.cjs b/examples/worker-projection/CounterProjection.cjs index 4d9c515..f2aadd0 100644 --- a/examples/worker-projection/CounterProjection.cjs +++ b/examples/worker-projection/CounterProjection.cjs @@ -1,4 +1,3 @@ -const { isMainThread } = require('node:worker_threads'); const { AbstractWorkerProjection } = require('../../dist/workers'); class CounterView { @@ -26,7 +25,6 @@ class CounterProjection extends AbstractWorkerProjection { } } -if (!isMainThread) - CounterProjection.createWorkerInstance(); +CounterProjection.createInstanceIfWorkerThread(); module.exports = CounterProjection; diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index 84669d7..fee6cc9 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -69,6 +69,22 @@ export abstract class AbstractWorkerProjection extends AbstractProjection return workerProjectionInstance; } + /** + * Convenience wrapper for module-level bootstrapping. + * + * In the main thread, does nothing. + * In a worker thread, creates and exposes the projection singleton (same as createWorkerInstance). + */ + static createInstanceIfWorkerThread>( + this: (new (...args: any[]) => T) & { createWorkerInstance: (factory?: () => T) => T }, + factory?: () => T + ): T | undefined { + if (isMainThread) + return undefined; + + return this.createWorkerInstance(factory); + } + async project(event: IEvent): Promise { if (this.#useWorkerThreads && isMainThread) { if (!this.#worker) diff --git a/src/workers/readme.md b/src/workers/readme.md index 58d0d37..efa0942 100644 --- a/src/workers/readme.md +++ b/src/workers/readme.md @@ -23,13 +23,13 @@ import { AbstractWorkerProjection } from 'node-cqrs/workers'; Key points: - The same projection module is used as the **worker entry point**. -- In the worker thread, the module must create the worker-side singleton via `YourProjection.createWorkerInstance()`. +- The module should bootstrap the worker-side singleton via + `YourProjection.createInstanceIfWorkerThread()`. - In the main thread, `project()` automatically waits for worker startup (so `ensureWorkerReady()` is optional). Example (CommonJS): ```js -const { isMainThread } = require('node:worker_threads'); const { AbstractWorkerProjection } = require('node-cqrs/workers'); class CounterView { @@ -51,8 +51,7 @@ class CounterProjection extends AbstractWorkerProjection { } } -if (!isMainThread) - CounterProjection.createWorkerInstance(); +CounterProjection.createInstanceIfWorkerThread(); module.exports = CounterProjection; ``` diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index f8d7148..28e8e48 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -1,7 +1,6 @@ /** @type {typeof import('../../../../src/workers')} */ // @ts-ignore const workers = require('../../../../dist/workers'); -const { isMainThread } = require('node:worker_threads'); const { AbstractWorkerProjection } = workers; @@ -117,7 +116,6 @@ class ProjectionFixture extends AbstractWorkerProjection { } } -if (!isMainThread) - ProjectionFixture.createWorkerInstance(); +ProjectionFixture.createInstanceIfWorkerThread(); module.exports = ProjectionFixture; diff --git a/tests/unit/workers/fixtures/ProjectionFixture.ts b/tests/unit/workers/fixtures/ProjectionFixture.ts index 59db75d..1cebcfe 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.ts +++ b/tests/unit/workers/fixtures/ProjectionFixture.ts @@ -1,5 +1,4 @@ import { AbstractWorkerProjection } from '../../../../src/workers'; -const { isMainThread } = require('node:worker_threads'); class ViewFixture { counter = 0; @@ -35,5 +34,4 @@ export class ProjectionFixture extends AbstractWorkerProjection { } } -if (!isMainThread) - ProjectionFixture.createWorkerInstance(); +ProjectionFixture.createInstanceIfWorkerThread(); From bab78078de52bd88bb86c293adb87eeb974241d5 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 21:08:29 +0000 Subject: [PATCH 140/169] Fix: Concurrent operations handling in SqliteObjectStorage updateEnforcingNew --- src/sqlite/SqliteObjectStorage.ts | 19 ++++++++++--- tests/integration/sqlite/SqliteView.test.ts | 30 ++++++++++++++++++++- 2 files changed, 44 insertions(+), 5 deletions(-) diff --git a/src/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts index fb043f1..8f16142 100644 --- a/src/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -83,6 +83,10 @@ export class SqliteObjectStorage extends AbstractSqliteAccessor impleme await this.assertConnection(); + this.#createSync(id, data); + } + + #createSync(id: string, data: TRecord) { const r = this.#insertQuery.run(guid(id), JSON.stringify(data)); if (r.changes !== 1) throw new Error(`Record '${id}' could not be created`); @@ -96,11 +100,20 @@ export class SqliteObjectStorage extends AbstractSqliteAccessor impleme await this.assertConnection(); + this.#updateSync(id, update); + } + + #updateSync(id: string, update: (r: TRecord) => TRecord) { const gid = guid(id); const record = this.#getQuery.get(gid); if (!record) throw new Error(`Record '${id}' does not exist`); + this.#updateExistingSync(id, record, update); + } + + #updateExistingSync(id: string, record: { data: string, version: number }, update: (r: TRecord) => TRecord) { + const gid = guid(id); const data = JSON.parse(record.data); const updatedData = update(data); const updatedJson = JSON.stringify(updatedData); @@ -121,13 +134,11 @@ export class SqliteObjectStorage extends AbstractSqliteAccessor impleme await this.assertConnection(); - // Due to better-sqlite3 sync nature, - // it's safe to get then modify within this process const record = this.#getQuery.get(guid(id)); if (record) - await this.update(id, update); + this.#updateExistingSync(id, record, update as (r: TRecord) => TRecord); else - await this.create(id, update()); + this.#createSync(id, update()); } async delete(id: string): Promise { diff --git a/tests/integration/sqlite/SqliteView.test.ts b/tests/integration/sqlite/SqliteView.test.ts index eaf116c..6cdc644 100644 --- a/tests/integration/sqlite/SqliteView.test.ts +++ b/tests/integration/sqlite/SqliteView.test.ts @@ -1,6 +1,6 @@ import { existsSync, unlinkSync } from 'fs'; import { AbstractProjection, IEvent } from '../../../src'; -import { SqliteObjectView } from '../../../src/sqlite'; +import { SqliteObjectStorage, SqliteObjectView, guid } from '../../../src/sqlite'; import * as createDb from 'better-sqlite3'; type UserPayload = { @@ -116,4 +116,32 @@ describe('SqliteView', () => { // tbl_test_1: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1 LIMIT 3`).all() // }); }); + + it('updateEnforcingNew is safe under same-process concurrency', async () => { + const storage = new SqliteObjectStorage<{ n: number }>({ + viewModelSqliteDb, + tableName: 'tbl_concurrency' + }); + + const id = '00000000000000000000000000000001'; + + await storage.assertConnection(); + + + const p1 = storage.updateEnforcingNew(id, r => ({ n: (r?.n ?? 0) + 1 })); + const p2 = storage.updateEnforcingNew(id, r => ({ n: (r?.n ?? 0) + 1 })); + + await Promise.all([p1, p2]); + + const record = await storage.get(id); + expect(record).toEqual({ n: 2 }); + + const row = viewModelSqliteDb.prepare(` + SELECT version + FROM tbl_concurrency + WHERE id = ? + `).get(guid(id)); + + expect(row?.version).toBe(2); + }); }); From 165654b85da0861f7faf3046ba865c4a9aff4138 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 21:08:47 +0000 Subject: [PATCH 141/169] 1.0.0-rc.33 --- CHANGELOG.md | 8 ++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6bcebb1..26db4ca 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,11 @@ +# [1.0.0-rc.33](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.32...v1.0.0-rc.33) (2026-01-26) + + +### Fixes + +* Concurrent operations handling in SqliteObjectStorage updateEnforcingNew ([bab7807](https://github.com/snatalenko/node-cqrs/commit/bab78078de52bd88bb86c293adb87eeb974241d5)) + + # [1.0.0-rc.32](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.31...v1.0.0-rc.32) (2026-01-09) diff --git a/package-lock.json b/package-lock.json index 12fb1ea..6a9bade 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.32", + "version": "1.0.0-rc.33", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "node-cqrs", - "version": "1.0.0-rc.32", + "version": "1.0.0-rc.33", "license": "MIT", "dependencies": { "async-iterable-buffer": "^1.1.0", diff --git a/package.json b/package.json index 87fc2a1..8e4a29d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "node-cqrs", - "version": "1.0.0-rc.32", + "version": "1.0.0-rc.33", "description": "Basic ES6 backbone for CQRS app development", "keywords": [ "cqrs", From d953bfca17cabc00a3c6d422cb7f5d318733f6d3 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 26 Jan 2026 21:47:28 +0000 Subject: [PATCH 142/169] Move SqliteObjectStorage test to correct location --- tests/integration/sqlite/SqliteView.test.ts | 30 +------------------ tests/unit/sqlite/SqliteObjectStorage.test.ts | 26 ++++++++++++++++ 2 files changed, 27 insertions(+), 29 deletions(-) diff --git a/tests/integration/sqlite/SqliteView.test.ts b/tests/integration/sqlite/SqliteView.test.ts index 6cdc644..eaf116c 100644 --- a/tests/integration/sqlite/SqliteView.test.ts +++ b/tests/integration/sqlite/SqliteView.test.ts @@ -1,6 +1,6 @@ import { existsSync, unlinkSync } from 'fs'; import { AbstractProjection, IEvent } from '../../../src'; -import { SqliteObjectStorage, SqliteObjectView, guid } from '../../../src/sqlite'; +import { SqliteObjectView } from '../../../src/sqlite'; import * as createDb from 'better-sqlite3'; type UserPayload = { @@ -116,32 +116,4 @@ describe('SqliteView', () => { // tbl_test_1: viewModelSqliteDb.prepare(`SELECT * FROM tbl_test_1 LIMIT 3`).all() // }); }); - - it('updateEnforcingNew is safe under same-process concurrency', async () => { - const storage = new SqliteObjectStorage<{ n: number }>({ - viewModelSqliteDb, - tableName: 'tbl_concurrency' - }); - - const id = '00000000000000000000000000000001'; - - await storage.assertConnection(); - - - const p1 = storage.updateEnforcingNew(id, r => ({ n: (r?.n ?? 0) + 1 })); - const p2 = storage.updateEnforcingNew(id, r => ({ n: (r?.n ?? 0) + 1 })); - - await Promise.all([p1, p2]); - - const record = await storage.get(id); - expect(record).toEqual({ n: 2 }); - - const row = viewModelSqliteDb.prepare(` - SELECT version - FROM tbl_concurrency - WHERE id = ? - `).get(guid(id)); - - expect(row?.version).toBe(2); - }); }); diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts index dd6d9f7..cd4bcff 100644 --- a/tests/unit/sqlite/SqliteObjectStorage.test.ts +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -83,4 +83,30 @@ describe('SqliteObjectStorage', function () { await expect(() => storage.get('0005')).rejects.toThrow(); }); + + it('updateEnforcingNew is safe under same-process concurrency', async function () { + const id = '00000000000000000000000000000001'; + const concurrency = 50; + + const results = await Promise.allSettled( + Array.from({ length: concurrency }, () => storage.updateEnforcingNew(id, r => ({ + name: 'counter', + value: (r?.value ?? 0) + 1 + }))) + ); + + const rejected = results.filter(r => r.status === 'rejected'); + expect(rejected).toEqual([]); + + const record = await storage.get(id); + expect(record).toEqual({ name: 'counter', value: concurrency }); + + const row = db.prepare(` + SELECT version + FROM test_objects + WHERE id = ? + `).get(guid(id)) as { version: number } | undefined; + + expect(row?.version).toBe(concurrency); + }); }); From 425dc7a9f742d0b7c38977a60f6d90d7bf8711ac Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 27 Jan 2026 21:28:08 +0000 Subject: [PATCH 143/169] Minor performance optimization --- src/AbstractProjection.ts | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 7434042..01e3684 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -56,8 +56,8 @@ export abstract class AbstractProjection implements IProjection implements IProjection Date: Tue, 27 Jan 2026 21:29:08 +0000 Subject: [PATCH 144/169] Minor refactoring of error handling in view restoration process --- src/AbstractProjection.ts | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 01e3684..5d0d5f1 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -196,7 +196,7 @@ this.#eventLocker = isEventLocker(this.view) ? this.view : null; await this._project(event); eventsCount += 1; } - catch (err: any) { + catch (err: unknown) { this._onRestoringError(err, event); } } @@ -204,13 +204,19 @@ this.#eventLocker = isEventLocker(this.view) ? this.view : null; this._logger?.info(`view restored from ${eventsCount} event(s) in ${Date.now() - startTs} ms`); } - /** Handle error on restoring. Logs and throws error by default */ - protected _onRestoringError(error: Error, event: IEvent) { - this._logger?.error(`view restoring has failed (view will remain locked): ${error.message}`, { + /** +* Handle error on restoring. + * + * Logs and throws error by default +*/ + protected _onRestoringError(error: unknown, event: IEvent) { +const errorMessage = error instanceof Error ? error.message : String(error); + this._logger?.error(`view restoring has failed (view remains locked): ${errorMessage}`, { service: getClassName(this), event, - stack: error.stack + error }); + throw error; } } From fcc0b8101f269702cc657f600f0389f06c920266 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 27 Jan 2026 21:32:28 +0000 Subject: [PATCH 145/169] Refactor IObservable and IProjection interfaces --- src/AbstractProjection.ts | 47 +++++++++++++--------- src/EventStore.ts | 5 ++- src/in-memory/InMemoryMessageBus.ts | 7 ++-- src/interfaces/IEventBus.ts | 4 +- src/interfaces/IEventStore.ts | 13 +++--- src/interfaces/IMessageBus.ts | 6 +-- src/interfaces/IObservable.ts | 5 --- src/interfaces/IObservableQueueProvider.ts | 15 +++++++ src/interfaces/IProjection.ts | 20 ++++----- src/interfaces/index.ts | 1 + src/rabbitmq/RabbitMqEventBus.ts | 4 +- src/utils/subscribe.ts | 6 +-- 12 files changed, 77 insertions(+), 56 deletions(-) create mode 100644 src/interfaces/IObservableQueueProvider.ts diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index 5d0d5f1..b48b780 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -1,13 +1,14 @@ import { describe } from './Event'; import { InMemoryView } from './in-memory/InMemoryView'; import { - IViewLocker, - IEventLocker, - IProjection, - ILogger, - IExtendableLogger, - IEventStore, - IEvent, + type IViewLocker, + type IEventLocker, + type IProjection, + type ILogger, + type IExtendableLogger, + type IEvent, + type IObservable, + type IEventStorageReader, isViewLocker, isEventLocker } from './interfaces'; @@ -78,7 +79,7 @@ export abstract class AbstractProjection implements IProjection { + /** + * Subscribe to event store + * and restore view state from not yet projected events + */ + async subscribe(eventStore: IObservable & IEventStorageReader): Promise { subscribe(eventStore, this, { masterHandler: this.project }); @@ -156,10 +160,13 @@ this.#eventLocker = isEventLocker(this.view) ? this.view : null; await this._eventLocker.markAsProjected(event); } - /** Restore projection view from event store */ - async restore(eventStore: IEventStore): Promise { - // lock the view to ensure same restoring procedure - // won't be performed by another projection instance + /** + * Restore view state from not-yet-projected events. + * + * Lock the view to ensure same restoring procedure + * won't be performed by another projection instance. + * */ + async restore(eventStore: IEventStorageReader): Promise { if (this._viewLocker) await this._viewLocker.lock(); @@ -169,8 +176,8 @@ this.#eventLocker = isEventLocker(this.view) ? this.view : null; this._viewLocker.unlock(); } - /** Restore projection view from event store */ - protected async _restore(eventStore: IEventStore): Promise { + /** Restore view state from not-yet-projected events */ + protected async _restore(eventStore: IEventStorageReader): Promise { if (!eventStore) throw new TypeError('eventStore argument required'); if (typeof eventStore.getEventsByTypes !== 'function') @@ -205,12 +212,12 @@ this.#eventLocker = isEventLocker(this.view) ? this.view : null; } /** -* Handle error on restoring. + * Handle error on restoring. * * Logs and throws error by default -*/ + */ protected _onRestoringError(error: unknown, event: IEvent) { -const errorMessage = error instanceof Error ? error.message : String(error); + const errorMessage = error instanceof Error ? error.message : String(error); this._logger?.error(`view restoring has failed (view remains locked): ${errorMessage}`, { service: getClassName(this), event, diff --git a/src/EventStore.ts b/src/EventStore.ts index 09ba489..deedc0d 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -18,7 +18,8 @@ import { isIEventBus, isIEventStorageReader, IContainer, - isEventSet + isEventSet, + isIObservableQueueProvider } from './interfaces'; import { getClassName, @@ -191,7 +192,7 @@ export class EventStore implements IEventStore { } queue(name: string): IObservable { - if (!this.eventBus.queue) + if (!isIObservableQueueProvider(this.eventBus)) throw new Error('Injected eventBus does not support named queues'); return this.eventBus.queue(name); diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index c2b94a6..e424abf 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -1,16 +1,17 @@ -import { +import type { ICommand, IEvent, IMessageBus, IMessageHandler, - IObservable + IObservable, + IObservableQueueProvider } from '../interfaces'; /** * Default implementation of the message bus. * Keeps all subscriptions and messages in memory. */ -export class InMemoryMessageBus implements IMessageBus { +export class InMemoryMessageBus implements IMessageBus, IObservableQueueProvider { protected handlers: Map> = new Map(); protected uniqueEventHandlers: boolean; diff --git a/src/interfaces/IEventBus.ts b/src/interfaces/IEventBus.ts index 0e37e07..69406fb 100644 --- a/src/interfaces/IEventBus.ts +++ b/src/interfaces/IEventBus.ts @@ -1,5 +1,5 @@ -import { IEvent } from './IEvent'; -import { IObservable, isIObservable } from './IObservable'; +import type { IEvent } from './IEvent'; +import { type IObservable, isIObservable } from './IObservable'; export interface IEventBus extends IObservable { publish(event: IEvent, meta?: Record): Promise; diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index 0ded850..fae2816 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,11 +1,12 @@ -import { IEventDispatcher } from './IEventDispatcher'; -import { IEvent } from './IEvent'; -import { IEventStorageReader } from './IEventStorageReader'; -import { IIdentifierProvider } from './IIdentifierProvider'; -import { IMessageHandler, IObservable } from './IObservable'; +import type { IEventDispatcher } from './IEventDispatcher'; +import type { IEvent } from './IEvent'; +import type { IEventStorageReader } from './IEventStorageReader'; +import type { IIdentifierProvider } from './IIdentifierProvider'; +import type { IMessageHandler, IObservable } from './IObservable'; +import type { IObservableQueueProvider } from './IObservableQueueProvider'; export interface IEventStore - extends IObservable, IEventDispatcher, IEventStorageReader, IIdentifierProvider { + extends IObservable, IObservableQueueProvider, IEventDispatcher, IEventStorageReader, IIdentifierProvider { registerSagaStarters(startsWith: string[] | undefined): void; diff --git a/src/interfaces/IMessageBus.ts b/src/interfaces/IMessageBus.ts index 5b626a3..44a7ea2 100644 --- a/src/interfaces/IMessageBus.ts +++ b/src/interfaces/IMessageBus.ts @@ -1,6 +1,6 @@ -import { ICommand } from './ICommand'; -import { IEvent } from './IEvent'; -import { IObservable } from './IObservable'; +import type { ICommand } from './ICommand'; +import type { IEvent } from './IEvent'; +import type { IObservable } from './IObservable'; export interface IMessageBus extends IObservable { send(command: ICommand): Promise; diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts index a04387a..f7bdab9 100644 --- a/src/interfaces/IObservable.ts +++ b/src/interfaces/IObservable.ts @@ -16,11 +16,6 @@ export interface IObservable { * Remove previously installed listener */ off(type: string, handler: IMessageHandler): void; - - /** - * Get or create a named queue, which delivers events to a single handler only - */ - queue?(name: string): IObservable; } export const isIObservable = (obj: unknown): obj is IObservable => diff --git a/src/interfaces/IObservableQueueProvider.ts b/src/interfaces/IObservableQueueProvider.ts new file mode 100644 index 0000000..2b32573 --- /dev/null +++ b/src/interfaces/IObservableQueueProvider.ts @@ -0,0 +1,15 @@ +import type { IObservable } from './IObservable'; +import { isObject } from './isObject'; + +export interface IObservableQueueProvider { + + /** + * Get or create a named queue, which delivers events to a single handler only + */ + queue(name: string): IObservable; +} + +export const isIObservableQueueProvider = (obj: unknown): obj is IObservableQueueProvider => + isObject(obj) + && 'queue' in obj + && typeof obj.queue === 'function'; diff --git a/src/interfaces/IProjection.ts b/src/interfaces/IProjection.ts index 4c260d7..a5d17bb 100644 --- a/src/interfaces/IProjection.ts +++ b/src/interfaces/IProjection.ts @@ -1,20 +1,22 @@ -import { IEvent } from './IEvent'; -import { IEventStore } from './IEventStore'; -import { IObserver } from './IObserver'; +import type { IObserver } from './IObserver'; +import type { IObservable } from './IObservable'; +import type { IEventStorageReader } from './IEventStorageReader'; +import type { IEvent } from './IEvent'; export interface IProjection extends IObserver { readonly view: TView; - subscribe(eventStore: IEventStore): Promise; + /** Subscribe to new events */ + subscribe(eventStore: IObservable): Promise | void; - project(event: IEvent): Promise; + /** Restore view state from not-yet-projected events */ + restore(eventStore: IEventStorageReader): Promise | void; + + /** Project new event */ + project(event: IEvent): Promise | void; } export interface IProjectionConstructor { new(c?: any): IProjection; readonly handles?: string[]; } - -export interface IViewFactory { - (options: { schemaVersion: string }): TView; -} diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index 9b9539f..424070c 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -21,6 +21,7 @@ export * from './IMessage'; export * from './IMessageBus'; export * from './IObjectStorage'; export * from './IObservable'; +export * from './IObservableQueueProvider'; export * from './IObserver'; export * from './IProjection'; export * from './ISaga'; diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 50e2e01..95fda5c 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,7 +1,7 @@ -import { IEvent, IEventBus, IMessageHandler, IObservable } from '../interfaces'; +import type { IEvent, IEventBus, IMessageHandler, IObservable, IObservableQueueProvider } from '../interfaces'; import { RabbitMqGateway } from './RabbitMqGateway'; -export class RabbitMqEventBus implements IEventBus { +export class RabbitMqEventBus implements IEventBus, IObservableQueueProvider { static get allEventsWildcard(): string { return RabbitMqGateway.ALL_EVENTS_WILDCARD; diff --git a/src/utils/subscribe.ts b/src/utils/subscribe.ts index 3f5b157..9c21664 100644 --- a/src/utils/subscribe.ts +++ b/src/utils/subscribe.ts @@ -1,4 +1,4 @@ -import { IMessageHandler, IObservable } from '../interfaces'; +import { type IMessageHandler, type IObservable, isIObservableQueueProvider } from '../interfaces'; import { getHandler } from './getHandler'; import { getMessageHandlerNames } from './getMessageHandlerNames'; @@ -40,8 +40,6 @@ export function subscribe( const { masterHandler, messageTypes, queueName } = options; if (masterHandler && typeof masterHandler !== 'function') throw new TypeError('masterHandler parameter, when provided, must be a Function'); - if (queueName && typeof observable.queue !== 'function') - throw new TypeError('observable.queue, when queueName is specified, must be a Function'); const subscribeTo = messageTypes || getHandledMessageTypes(observer); if (!Array.isArray(subscribeTo)) @@ -53,7 +51,7 @@ export function subscribe( throw new Error(`'${messageType}' handler is not defined or not a function`); if (queueName) { - if (!observable.queue) + if (!isIObservableQueueProvider(observable)) throw new TypeError('Observer does not support named queues'); observable.queue(queueName).on(messageType, (event, meta) => handler.call(observer, event, meta)); From 8333a896e35f84f05a0c71881bef671983391b1d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 28 Jan 2026 02:29:49 +0000 Subject: [PATCH 146/169] Make aggregate state type an optional parameter --- src/AbstractAggregate.ts | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 4243173..4c672d6 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -1,11 +1,11 @@ import { - IAggregate, - IMutableAggregateState, - ICommand, - Identifier, - IEvent, - IEventSet, - IAggregateConstructorParams, + type IAggregate, + type IMutableAggregateState, + type ICommand, + type Identifier, + type IEvent, + type IEventSet, + type IAggregateConstructorParams, SNAPSHOT_EVENT_TYPE } from './interfaces'; @@ -14,7 +14,8 @@ import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } fr /** * Base class for Aggregate definition */ -export abstract class AbstractAggregate implements IAggregate { +export abstract class AbstractAggregate implements + IAggregate { /** * List of command names handled by the Aggregate. From 18a4c144d6f8e90079de9bde29f2c7e93ae0400c Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 28 Jan 2026 22:10:14 +0000 Subject: [PATCH 147/169] List comlink, better-sqlite3, amqplib as optional peer and dev dependencies --- package-lock.json | 70 +++++++++++++++++++++++-- package.json | 20 ++++++- src/EventStore.ts | 32 +++++------ src/interfaces/IMessage.ts | 15 ++++++ src/rabbitmq/RabbitMqEventBus.ts | 3 ++ src/rabbitmq/RabbitMqGateway.ts | 4 +- src/sqlite/AbstractSqliteAccessor.ts | 4 +- src/sqlite/AbstractSqliteView.ts | 3 ++ src/sqlite/IContainer.ts | 2 +- src/sqlite/SqliteEventLocker.ts | 8 +-- src/sqlite/SqliteObjectStorage.ts | 4 +- src/sqlite/SqliteObjectView.ts | 7 ++- src/sqlite/SqliteViewLocker.ts | 6 +-- src/workers/AbstractWorkerProjection.ts | 4 ++ 14 files changed, 144 insertions(+), 38 deletions(-) diff --git a/package-lock.json b/package-lock.json index 7e032c2..7e5f71f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -24,12 +24,16 @@ "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", + "amqplib": "^0.10.9", + "better-sqlite3": "^11.10.0", "chai": "^4.5.0", + "comlink": "^4.4.2", "conventional-changelog": "^3.1.25", "eslint": "^9.39.2", "eslint-plugin-jest": "^28.14.0", "globals": "^16.5.0", "jest": "^29.7.0", + "md5": "^2.3.0", "sinon": "^19.0.5", "ts-jest": "^29.4.6", "ts-node": "^10.9.2", @@ -44,6 +48,17 @@ "better-sqlite3": "^11.10.0", "comlink": "^4.4.2", "md5": "^2.3.0" + }, + "peerDependenciesMeta": { + "amqplib": { + "optional": true + }, + "better-sqlite3": { + "optional": true + }, + "comlink": { + "optional": true + } } }, "node_modules/@babel/code-frame": { @@ -77,6 +92,7 @@ "integrity": "sha512-H3mcG6ZDLTlYfaSNi0iOKkigqMFvkTKlGUYlD8GW7nNOYRrevuA46iTypPyv+06V3fEmvvazfntkBU34L0azAw==", "dev": true, "license": "MIT", + "peer": true, "dependencies": { "@babel/code-frame": "^7.28.6", "@babel/generator": "^7.28.6", @@ -1934,8 +1950,8 @@ "version": "0.10.9", "resolved": "https://registry.npmjs.org/amqplib/-/amqplib-0.10.9.tgz", "integrity": "sha512-jwSftI4QjS3mizvnSnOrPGYiUnm1vI2OP1iXeOUz5pb74Ua0nbf6nPyyTzuiCLEE3fMpaJORXh2K/TQ08H5xGA==", + "dev": true, "license": "MIT", - "peer": true, "dependencies": { "buffer-more-ints": "~1.0.0", "url-parse": "~1.5.10" @@ -2190,6 +2206,7 @@ "version": "1.5.1", "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "dev": true, "funding": [ { "type": "github", @@ -2220,9 +2237,9 @@ "version": "11.10.0", "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-11.10.0.tgz", "integrity": "sha512-EwhOpyXiOEL/lKzHz9AW1msWFNzGc/z+LzeB3/jnFJpxu+th2yqvzsSWas1v9jgs9+xiXJcD5A8CJxAG2TaghQ==", + "dev": true, "hasInstallScript": true, "license": "MIT", - "peer": true, "dependencies": { "bindings": "^1.5.0", "prebuild-install": "^7.1.1" @@ -2232,6 +2249,7 @@ "version": "1.5.0", "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz", "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==", + "dev": true, "license": "MIT", "dependencies": { "file-uri-to-path": "1.0.0" @@ -2241,6 +2259,7 @@ "version": "4.1.0", "resolved": "https://registry.npmjs.org/bl/-/bl-4.1.0.tgz", "integrity": "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==", + "dev": true, "license": "MIT", "dependencies": { "buffer": "^5.5.0", @@ -2333,6 +2352,7 @@ "version": "5.7.1", "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", "integrity": "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==", + "dev": true, "funding": [ { "type": "github", @@ -2364,6 +2384,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/buffer-more-ints/-/buffer-more-ints-1.0.0.tgz", "integrity": "sha512-EMetuGFz5SLsT0QTnXzINh4Ksr+oo4i+UGTXEshiGCQWnsgSs7ZhJ8fzlwQ+OzEMs0MpDAMr1hxnblp5a4vcHg==", + "dev": true, "license": "MIT" }, "node_modules/callsites": { @@ -2475,6 +2496,7 @@ "version": "0.0.2", "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz", "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==", + "dev": true, "license": "BSD-3-Clause", "engines": { "node": "*" @@ -2497,6 +2519,7 @@ "version": "1.1.4", "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.1.4.tgz", "integrity": "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==", + "dev": true, "license": "ISC" }, "node_modules/ci-info": { @@ -2576,8 +2599,8 @@ "version": "4.4.2", "resolved": "https://registry.npmjs.org/comlink/-/comlink-4.4.2.tgz", "integrity": "sha512-OxGdvBmJuNKSCMO4NTl1L47VRp6xn2wG4F/2hYzB6tiCb709otOxtEYCSvK80PtjODfXXZu8ds+Nw5kVCjqd2g==", - "license": "Apache-2.0", - "peer": true + "dev": true, + "license": "Apache-2.0" }, "node_modules/compare-func": { "version": "2.0.0", @@ -2908,6 +2931,7 @@ "version": "0.0.2", "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz", "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==", + "dev": true, "license": "BSD-3-Clause", "engines": { "node": "*" @@ -2992,6 +3016,7 @@ "version": "6.0.0", "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz", "integrity": "sha512-aW35yZM6Bb/4oJlZncMH2LCoZtJXTRxES17vE3hoRiowU2kWHaJKFkSBDnDR+cm9J+9QhXmREyIfv0pji9ejCQ==", + "dev": true, "license": "MIT", "dependencies": { "mimic-response": "^3.1.0" @@ -3035,6 +3060,7 @@ "version": "0.6.0", "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz", "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==", + "dev": true, "license": "MIT", "engines": { "node": ">=4.0.0" @@ -3061,6 +3087,7 @@ "version": "2.1.2", "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "dev": true, "license": "Apache-2.0", "engines": { "node": ">=8" @@ -3146,6 +3173,7 @@ "version": "1.4.5", "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz", "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==", + "dev": true, "license": "MIT", "dependencies": { "once": "^1.4.0" @@ -3450,6 +3478,7 @@ "version": "2.0.3", "resolved": "https://registry.npmjs.org/expand-template/-/expand-template-2.0.3.tgz", "integrity": "sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==", + "dev": true, "license": "(MIT OR WTFPL)", "engines": { "node": ">=6" @@ -3520,6 +3549,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz", "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==", + "dev": true, "license": "MIT" }, "node_modules/fill-range": { @@ -3577,6 +3607,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz", "integrity": "sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==", + "dev": true, "license": "MIT" }, "node_modules/fs.realpath": { @@ -3802,6 +3833,7 @@ "version": "0.0.0", "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz", "integrity": "sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==", + "dev": true, "license": "MIT" }, "node_modules/glob": { @@ -3972,6 +4004,7 @@ "version": "1.2.1", "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "dev": true, "funding": [ { "type": "github", @@ -4071,12 +4104,14 @@ "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "dev": true, "license": "ISC" }, "node_modules/ini": { "version": "1.3.8", "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz", "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==", + "dev": true, "license": "ISC" }, "node_modules/is-arrayish": { @@ -4090,6 +4125,7 @@ "version": "1.1.6", "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz", "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==", + "dev": true, "license": "MIT" }, "node_modules/is-core-module": { @@ -5270,8 +5306,8 @@ "version": "2.3.0", "resolved": "https://registry.npmjs.org/md5/-/md5-2.3.0.tgz", "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==", + "dev": true, "license": "BSD-3-Clause", - "peer": true, "dependencies": { "charenc": "0.0.2", "crypt": "0.0.2", @@ -5492,6 +5528,7 @@ "version": "3.1.0", "resolved": "https://registry.npmjs.org/mimic-response/-/mimic-response-3.1.0.tgz", "integrity": "sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==", + "dev": true, "license": "MIT", "engines": { "node": ">=10" @@ -5530,6 +5567,7 @@ "version": "1.2.8", "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" @@ -5554,6 +5592,7 @@ "version": "0.5.3", "resolved": "https://registry.npmjs.org/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz", "integrity": "sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==", + "dev": true, "license": "MIT" }, "node_modules/modify-values": { @@ -5577,6 +5616,7 @@ "version": "2.0.0", "resolved": "https://registry.npmjs.org/napi-build-utils/-/napi-build-utils-2.0.0.tgz", "integrity": "sha512-GEbrYkbfF7MoNaoh2iGG84Mnf/WZfB0GdGEsM8wz7Expx/LlWf5U8t9nvJKXSp3qr5IsEbK04cBGhol/KwOsWA==", + "dev": true, "license": "MIT" }, "node_modules/natural-compare": { @@ -5621,6 +5661,7 @@ "version": "3.87.0", "resolved": "https://registry.npmjs.org/node-abi/-/node-abi-3.87.0.tgz", "integrity": "sha512-+CGM1L1CgmtheLcBuleyYOn7NWPVu0s0EJH2C4puxgEZb9h8QpR9G2dBfZJOAUhi7VQxuBPMd0hiISWcTyiYyQ==", + "dev": true, "license": "MIT", "dependencies": { "semver": "^7.3.5" @@ -5686,6 +5727,7 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "dev": true, "license": "ISC", "dependencies": { "wrappy": "1" @@ -5993,6 +6035,7 @@ "version": "7.1.3", "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz", "integrity": "sha512-8Mf2cbV7x1cXPUILADGI3wuhfqWvtiLA1iclTDbFRZkgRQS0NqsPZphna9V+HyTEadheuPmjaJMsbzKQFOzLug==", + "dev": true, "license": "MIT", "dependencies": { "detect-libc": "^2.0.0", @@ -6078,6 +6121,7 @@ "version": "3.0.3", "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.3.tgz", "integrity": "sha512-todwxLMY7/heScKmntwQG8CXVkWUOdYxIvY2s0VWAAMh/nd8SoYiRaKjlr7+iCs984f2P8zvrfWcDDYVb73NfA==", + "dev": true, "license": "MIT", "dependencies": { "end-of-stream": "^1.1.0", @@ -6127,6 +6171,7 @@ "version": "2.2.0", "resolved": "https://registry.npmjs.org/querystringify/-/querystringify-2.2.0.tgz", "integrity": "sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ==", + "dev": true, "license": "MIT" }, "node_modules/quick-lru": { @@ -6143,6 +6188,7 @@ "version": "1.2.8", "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==", + "dev": true, "license": "(BSD-2-Clause OR MIT OR Apache-2.0)", "dependencies": { "deep-extend": "^0.6.0", @@ -6158,6 +6204,7 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz", "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==", + "dev": true, "license": "MIT", "engines": { "node": ">=0.10.0" @@ -6306,6 +6353,7 @@ "version": "3.6.2", "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", + "dev": true, "license": "MIT", "dependencies": { "inherits": "^2.0.3", @@ -6344,6 +6392,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", + "dev": true, "license": "MIT" }, "node_modules/resolve": { @@ -6414,6 +6463,7 @@ "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "dev": true, "funding": [ { "type": "github", @@ -6434,6 +6484,7 @@ "version": "7.7.3", "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.3.tgz", "integrity": "sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==", + "dev": true, "license": "ISC", "bin": { "semver": "bin/semver.js" @@ -6476,6 +6527,7 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/simple-concat/-/simple-concat-1.0.1.tgz", "integrity": "sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==", + "dev": true, "funding": [ { "type": "github", @@ -6496,6 +6548,7 @@ "version": "4.0.1", "resolved": "https://registry.npmjs.org/simple-get/-/simple-get-4.0.1.tgz", "integrity": "sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==", + "dev": true, "funding": [ { "type": "github", @@ -6677,6 +6730,7 @@ "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "dev": true, "license": "MIT", "dependencies": { "safe-buffer": "~5.2.0" @@ -6800,6 +6854,7 @@ "version": "2.1.4", "resolved": "https://registry.npmjs.org/tar-fs/-/tar-fs-2.1.4.tgz", "integrity": "sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==", + "dev": true, "license": "MIT", "dependencies": { "chownr": "^1.1.1", @@ -6812,6 +6867,7 @@ "version": "2.2.0", "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-2.2.0.tgz", "integrity": "sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==", + "dev": true, "license": "MIT", "dependencies": { "bl": "^4.0.3", @@ -7117,6 +7173,7 @@ "version": "0.6.0", "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz", "integrity": "sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==", + "dev": true, "license": "Apache-2.0", "dependencies": { "safe-buffer": "^5.0.1" @@ -7266,6 +7323,7 @@ "version": "1.5.10", "resolved": "https://registry.npmjs.org/url-parse/-/url-parse-1.5.10.tgz", "integrity": "sha512-WypcfiRhfeUP9vvF0j6rw0J3hrWrw6iZv3+22h6iRMJ/8z1Tj6XfLP4DsUix5MhMPnXpiHDoKyoZ/bdCkwBCiQ==", + "dev": true, "license": "MIT", "dependencies": { "querystringify": "^2.1.1", @@ -7276,6 +7334,7 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "dev": true, "license": "MIT" }, "node_modules/v8-compile-cache-lib": { @@ -7376,6 +7435,7 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "dev": true, "license": "ISC" }, "node_modules/write-file-atomic": { diff --git a/package.json b/package.json index 4f7b782..15b407c 100644 --- a/package.json +++ b/package.json @@ -58,7 +58,7 @@ "scripts": { "cleanup": "rm -rf ./dist ./types ./coverage && tsc --build --clean", "pretest": "npm run build", - "test": "jest tests/unit examples/user-domain-tests", + "test": "jest tests/unit examples/user-domain/tests", "test:coverage": "npm t -- --collect-coverage", "test:rabbitmq": "jest --verbose tests/integration/rabbitmq", "test:sqlite": "jest --verbose tests/integration/sqlite", @@ -88,12 +88,16 @@ "@types/sinon": "^17.0.4", "@typescript-eslint/eslint-plugin": "^8.29.0", "@typescript-eslint/parser": "^8.29.0", + "amqplib": "^0.10.9", + "better-sqlite3": "^11.10.0", "chai": "^4.5.0", + "comlink": "^4.4.2", "conventional-changelog": "^3.1.25", "eslint": "^9.39.2", "eslint-plugin-jest": "^28.14.0", "globals": "^16.5.0", "jest": "^29.7.0", + "md5": "^2.3.0", "sinon": "^19.0.5", "ts-jest": "^29.4.6", "ts-node": "^10.9.2", @@ -105,5 +109,19 @@ "better-sqlite3": "^11.10.0", "comlink": "^4.4.2", "md5": "^2.3.0" + }, + "peerDependenciesMeta": { + "better-sqlite3": { + "optional": true + }, + "amqplib": { + "optional": true + }, + "comlink": { + "optional": true + }, + "md5": { + "optional": true + } } } diff --git a/src/EventStore.ts b/src/EventStore.ts index deedc0d..d98efc6 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -1,23 +1,23 @@ import { - IAggregateSnapshotStorage, - IEvent, - IEventStorageReader, - IEventSet, - ILogger, - IMessageHandler, - IObservable, - IEventStream, - IEventStore, - EventQueryAfter, - EventQueryBefore, - Identifier, - IIdentifierProvider, + type IAggregateSnapshotStorage, + type IEvent, + type IEventStorageReader, + type IEventSet, + type ILogger, + type IMessageHandler, + type IObservable, + type IEventStream, + type IEventStore, + type EventQueryAfter, + type EventQueryBefore, + type Identifier, + type IIdentifierProvider, + type IEventDispatcher, + type IEventBus, + type IContainer, isIdentifierProvider, - IEventDispatcher, - IEventBus, isIEventBus, isIEventStorageReader, - IContainer, isEventSet, isIObservableQueueProvider } from './interfaces'; diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index 40c78f0..e5fda28 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -6,13 +6,28 @@ export interface IMessage { /** Event or command type */ type: string; + /** + * Target aggregate identifier for commands, + * originating aggregate identifier for events + */ aggregateId?: Identifier; + + /** Aggregate version at the time of the message (usually set on events, optional on commands) */ aggregateVersion?: number; + /** Saga identifier (used when a saga coordinates multiple steps/commands) */ sagaId?: Identifier; + + /** Saga version for ordering saga events */ sagaVersion?: number; + /** Business data */ payload?: TPayload; + + /** + * Optional metadata/context (e.g. auth info, request id); + * Commonly set on commands, then copied to emitted events + */ context?: any; } diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 95fda5c..290febb 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,6 +1,9 @@ import type { IEvent, IEventBus, IMessageHandler, IObservable, IObservableQueueProvider } from '../interfaces'; import { RabbitMqGateway } from './RabbitMqGateway'; +/** + * RabbitMQ-backed `IEventBus` with named queues support + */ export class RabbitMqEventBus implements IEventBus, IObservableQueueProvider { static get allEventsWildcard(): string { diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index 78b49ce..eb3dea5 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,5 +1,5 @@ -import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; -import { IContainer, ILogger, IMessage, isMessage } from '../interfaces'; +import type { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; +import { type IContainer, type ILogger, type IMessage, isMessage } from '../interfaces'; import * as Event from '../Event'; import { extractErrorDetails, Lock } from '../utils'; import { registerExitCleanup } from './utils'; diff --git a/src/sqlite/AbstractSqliteAccessor.ts b/src/sqlite/AbstractSqliteAccessor.ts index 27d3c08..9a474cc 100644 --- a/src/sqlite/AbstractSqliteAccessor.ts +++ b/src/sqlite/AbstractSqliteAccessor.ts @@ -1,6 +1,6 @@ -import { IContainer } from '../interfaces'; +import type { IContainer } from '../interfaces'; import { Lock } from '../utils'; -import { Database } from 'better-sqlite3'; +import type { Database } from 'better-sqlite3'; /** * Abstract base class for accessing a SQLite database. diff --git a/src/sqlite/AbstractSqliteView.ts b/src/sqlite/AbstractSqliteView.ts index 52aa020..55927ba 100644 --- a/src/sqlite/AbstractSqliteView.ts +++ b/src/sqlite/AbstractSqliteView.ts @@ -3,6 +3,9 @@ import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; +/** + * Base class for SQLite-backed projection views with restore locking and last-processed-event tracking + */ export abstract class AbstractSqliteView extends AbstractSqliteAccessor implements IViewLocker, IEventLocker { protected readonly schemaVersion: string; diff --git a/src/sqlite/IContainer.ts b/src/sqlite/IContainer.ts index f24f6d6..a3d8145 100644 --- a/src/sqlite/IContainer.ts +++ b/src/sqlite/IContainer.ts @@ -1,4 +1,4 @@ -import { Database } from 'better-sqlite3'; +import type { Database } from 'better-sqlite3'; declare module '../interfaces/IContainer' { interface IContainer { diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index 316f028..a202060 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -1,9 +1,9 @@ -import { Database, Statement } from 'better-sqlite3'; -import { IContainer, IEvent, IEventLocker } from '../interfaces'; +import type { Database, Statement } from 'better-sqlite3'; +import type { IContainer, IEvent, IEventLocker } from '../interfaces'; import { getEventId } from './utils'; import { viewLockTableInit, eventLockTableInit } from './queries'; -import { SqliteViewLockerParams } from './SqliteViewLocker'; -import { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; +import type { SqliteViewLockerParams } from './SqliteViewLocker'; +import type { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; export type SqliteEventLockerParams = diff --git a/src/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts index 8f16142..9ab3149 100644 --- a/src/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -1,6 +1,6 @@ -import { Statement, Database } from 'better-sqlite3'; +import type { Statement, Database } from 'better-sqlite3'; import { guid } from './utils'; -import { IContainer, IObjectStorage } from '../interfaces'; +import type { IContainer, IObjectStorage } from '../interfaces'; import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; export class SqliteObjectStorage extends AbstractSqliteAccessor implements IObjectStorage { diff --git a/src/sqlite/SqliteObjectView.ts b/src/sqlite/SqliteObjectView.ts index ac99aed..a110701 100644 --- a/src/sqlite/SqliteObjectView.ts +++ b/src/sqlite/SqliteObjectView.ts @@ -1,8 +1,11 @@ import { AbstractSqliteView } from './AbstractSqliteView'; -import { IObjectStorage, IEventLocker } from '../interfaces'; +import type { IObjectStorage, IEventLocker } from '../interfaces'; import { SqliteObjectStorage } from './SqliteObjectStorage'; -import { Database } from 'better-sqlite3'; +import type { Database } from 'better-sqlite3'; +/** + * SQLite-backed object view with restore locking and last-processed-event tracking + */ export class SqliteObjectView extends AbstractSqliteView implements IObjectStorage, IEventLocker { #sqliteObjectStorage: SqliteObjectStorage; diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index b5f8e49..43fd5f1 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -1,9 +1,9 @@ -import { Database, Statement } from 'better-sqlite3'; -import { IContainer, ILogger, IViewLocker } from '../interfaces'; +import type { Database, Statement } from 'better-sqlite3'; +import type { IContainer, ILogger, IViewLocker } from '../interfaces'; import { Deferred } from '../utils'; import { promisify } from 'util'; import { viewLockTableInit } from './queries'; -import { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; +import type { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; const delay = promisify(setTimeout); diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index fee6cc9..c7f66af 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -32,6 +32,10 @@ interface IMainThreadProjection { get remoteView(): Comlink.Remote; } +/** + * 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 abstract class AbstractWorkerProjection extends AbstractProjection { #worker?: Worker; From aa3fc76d28fff9566baf03fad4a26b1ef3f81ab2 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 28 Jan 2026 22:20:38 +0000 Subject: [PATCH 148/169] Remove obsolete docs; update README.MD --- .gitignore | 1 + README.md | 451 ++++++++++++++---- docs/README.md | 18 - docs/entities/Aggregate/CommandHandlers.md | 76 --- docs/entities/Aggregate/Dependencies.md | 20 - docs/entities/Aggregate/README.md | 21 - docs/entities/Aggregate/Snapshots.md | 35 -- docs/entities/Aggregate/State.md | 50 -- docs/entities/EventReceptor/README.md | 38 -- docs/entities/Messages/README.md | 76 --- docs/entities/Projection/InMemoryView.md | 48 -- docs/entities/Projection/README.md | 48 -- docs/entities/README.md | 7 - docs/entities/Saga/README.md | 94 ---- docs/images/README.md | 0 docs/images/node-cqrs-components.png | Bin 50824 -> 0 bytes docs/images/node-cqrs-flow.png | Bin 0 -> 890922 bytes docs/infrastructure/README.md | 13 - docs/middleware/AggregateCommandHandler.md | 24 - docs/middleware/DIContainer.md | 109 ----- docs/middleware/README.md | 15 - .../user-domain-own-implementation/index.ts | 198 ++++++++ .../package.json | 7 + examples/user-domain-ts/index.ts | 95 ++++ .../tests}/.eslintrc.json | 0 .../tests}/index.test.js | 2 +- 26 files changed, 653 insertions(+), 793 deletions(-) delete mode 100644 docs/README.md delete mode 100644 docs/entities/Aggregate/CommandHandlers.md delete mode 100644 docs/entities/Aggregate/Dependencies.md delete mode 100644 docs/entities/Aggregate/README.md delete mode 100644 docs/entities/Aggregate/Snapshots.md delete mode 100644 docs/entities/Aggregate/State.md delete mode 100644 docs/entities/EventReceptor/README.md delete mode 100644 docs/entities/Messages/README.md delete mode 100644 docs/entities/Projection/InMemoryView.md delete mode 100644 docs/entities/Projection/README.md delete mode 100644 docs/entities/README.md delete mode 100644 docs/entities/Saga/README.md delete mode 100644 docs/images/README.md delete mode 100644 docs/images/node-cqrs-components.png create mode 100644 docs/images/node-cqrs-flow.png delete mode 100644 docs/infrastructure/README.md delete mode 100644 docs/middleware/AggregateCommandHandler.md delete mode 100644 docs/middleware/DIContainer.md delete mode 100644 docs/middleware/README.md create mode 100644 examples/user-domain-own-implementation/index.ts create mode 100644 examples/user-domain-own-implementation/package.json create mode 100644 examples/user-domain-ts/index.ts rename examples/{user-domain-tests => user-domain/tests}/.eslintrc.json (100%) rename examples/{user-domain-tests => user-domain/tests}/index.test.js (97%) diff --git a/.gitignore b/.gitignore index 041d411..98badc4 100644 --- a/.gitignore +++ b/.gitignore @@ -30,6 +30,7 @@ data/ mongod *.sublime-project *.sublime-workspace +.obsidian/ # OS-specific # =========== diff --git a/README.md b/README.md index 7750413..2984504 100644 --- a/README.md +++ b/README.md @@ -9,179 +9,430 @@ node-cqrs ## Overview -The package provides building blocks for making a CQRS-ES application. It was inspired by Lokad.CQRS, but not tied to a specific storage implementation or infrastructure. It favors ES6 classes and dependency injection, so any components can be modified or replaced with your own implementations without hacks to the package codebase. +This package provides building blocks for CQRS/ES applications. It was inspired by Lokad.CQRS, +but it isn’t tied to any specific storage implementation or infrastructure. +It favors ES6/TS classes and dependency injection, so you can modify or replace components with your own implementations without patching the library. -[Documentation at node-cqrs.org](https://www.node-cqrs.org) +CQRS/ES itself can be implemented with surprisingly little code in a single process. +For a minimal, framework-free example, see [examples/user-domain-own-implementation/index.ts](examples/user-domain-own-implementation/index.ts). +This library exists to cover the "boring but hard" parts that are usually missing from a plain implementation, including: +- async command/event processing and safer wiring/subscriptions +- persistent views and catch-up on restart (checkpointing, view readiness/locking) +- aggregate snapshots +- extensible event dispatching pipelines (encoding, persistence, distribution, etc.) -Your app is expected to operate with loosely typed commands and events that match the following interface: +Commands and events are loosely typed objects that implement the [IMessage](src/interfaces/IMessage.ts) interface: ```ts -declare interface IMessage { - type: string, +interface IMessage { + type: string; - aggregateId?: string|number, - aggregateVersion?: number, + aggregateId?: string | number; + aggregateVersion?: number; - sagaId?: string|number, - sagaVersion?: number, + sagaId?: string | number; + sagaVersion?: number; - payload?: any, - context?: any + payload?: TPayload; + context?: any; } ``` -Domain business logic should be placed in Aggregate, Saga and Projection classes: +Domain business logic typically lives in aggregates, sagas, and projections: -- [Aggregates](entities/Aggregate/README.MD) handle commands and emit events -- [Sagas](entities/Saga/README.MD) handle events and enqueue commands -- [Projections](entities/Projection/README.md) listen to events and update views +- **[Aggregates](#aggregates-write-model)** handle commands and emit events +- **[Projections](#projections-and-views-read-model)** listen to events and update views +- **Sagas** handle events and enqueue commands - -Message delivery is being handled by the following services (in order of appearance): +Message delivery is handled by the following components (in order of appearance): - **Command Bus** delivers commands to command handlers -- [Aggregate Command Handler](middleware/AggregateCommandHandler.md) restores an aggregate state, executes a command -- **Event Store** persists events and deliver them to event handlers (saga event handlers, projections or any other custom services) -- **Saga Event Handler** restores saga state and applies event +- **Aggregate Command Handler** restores aggregate state and executes the command +- **Event Store** runs the event dispatching process: + - persists events (via the configured dispatch pipeline) + - then delivers them to event handlers (saga handlers, projections, custom services) +- **Saga Event Handler** restores saga state and applies events +At a high level, the command/event flow looks like: -From a high level, this is how the command/event flow looks like: +![Overview](docs/images/node-cqrs-flow.png) -![Overview](docs/images/node-cqrs-components.png) +**Tip**: the codebase is intentionally small and readable - `src/`, `tests/`, `examples/` are a good reference if you want to explore behavior in more detail. +- [examples/user-domain](examples/user-domain) basic CJS implementation +- [examples/user-domain-ts](examples/user-domain-ts) similar implementation in TS +- [examples/worker-projection](examples/worker-projection) projection in a worker thread +- [examples/user-domain-own-implementation](examples/user-domain-own-implementation) minimal, framework-free, CQRS/ES example -## Getting Started +## Installation -You can find sample code of a User domain in the **/examples** folder. +```bash +npm i node-cqrs +``` +If you want to use SQLite, RabbitMQ, or worker threads, the following peer dependencies may be needed: + +- [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) +- [amqplib](https://github.com/amqp-node/amqplib) +- [comlink](https://github.com/GoogleChromeLabs/comlink) + +## Commands + +* sent to CommandBus manually +* being handled by [Aggregates](#aggregates-write-model) +* may be enqueued by Sagas + +Command example: + +```json +{ + "type": "signupUser", + "aggregateId": null, + "payload": { + "profile": { + "name": "John Doe", + "email": "john@example.com" + }, + "password": "test" + }, + "context": { + "ip": "127.0.0.1", + "ts": 1503509747154 + } +} +``` -### Your App → Command → Aggregate +## Events + +* produced by [Aggregates](#aggregates-write-model) +* persisted to EventStore +* may be handled by [Projections](#projections-and-views-read-model), Sagas and Event Receptors + +Event example: + +```json +{ + "type": "userSignedUp", + "aggregateId": 1, + "aggregateVersion": 0, + "payload": { + "profile": { + "name": "John Doe", + "email": "john@example.com" + }, + "passwordHash": "098f6bcd4621d373cade4e832627b4f6" + }, + "context": { + "ip": "127.0.0.1", + "ts": 1503509747154 + } +} +``` -Describe an aggregate that handles a command: +## ContainerBuilder -```js -const { AbstractAggregate } = require('node-cqrs'); +The "happy path" is to use `ContainerBuilder` to wire buses, the event store, and your aggregates/projections/sagas. -class UserAggregate extends AbstractAggregate { - static get handles() { - return ['createUser']; - } - - createUser(commandPayload) { - // ... - } +All named component instances are exposed on container through getters and get created upon accessing a getter. +Default `EventStore` and `CommandBus` components are registered upon container instance creation: + +```ts +import { ContainerBuilder, InMemoryEventStorage, type IContainer } from 'node-cqrs'; + +interface MyDiContainer extends IContainer { + /* Any custom services or projection view for typing purposes */ } + +const builder = new ContainerBuilder(); + +// In-memory implementations for local dev/tests +builder.register(InMemoryEventStorage) + .as('eventStorageReader') + .as('eventStorageWriter'); + +const container = builder.container(); + +container.eventStore; // instance of EventStore +container.commandBus; // instance of CommandBus ``` -Then register aggregate in the [DI container](middleware/DIContainer.md). -All the wiring can be done manually, without a DI container (you can find it in samples), but with container it’s just easier: +Other components can be registered either as classes or as factories: -```js -const { ContainerBuilder, InMemoryEventStorage } = require('node-cqrs'); +```ts +// class with automatic dependency injection +builder.register(SomeService).as('someService'); -const builder = new ContainerBuilder(); -builder.register(InMemoryEventStorage).as('storage'); -builder.registerAggregate(UserAggregate); +// OR factory with more precise control +builder.register(container => new SomeService(container.commandBus)).as('someService'); +``` + +Components that aren't going to be accessed directly by name can also be registered in the builder. +Their instances will be created after invoking `container()` method: + +```js +builder.register(SomeEventObserver); +// at this point the registered observer does not exist const container = builder.container(); +// now it exists and got all its constructor dependencies ``` -Then send a command: +DI container has a set of methods for CQRS components registration: -```js -const userAggregateId = undefined; -const payload = { - username: 'john', - password: 'test' -}; +* `registerAggregate(AggregateType)` - registers aggregateCommandHandler, subscribes it to commandBus and wires Aggregate dependencies +* `registerSaga(SagaType)` - registers sagaEventHandler, subscribes it to eventStore and wires Saga dependencies +* `registerProjection(ProjectionType, exposedViewName)` - registers projection, subscribes it to eventStore and exposes associated projection view on the container +* `registerCommandHandler(typeOrFactory)` - registers command handler and subscribes it to commandBus +* `registerEventReceptor(typeOrFactory)` - registers event receptor and subscribes it to eventStore -container.commandBus.send('createUser', userAggregateId, { payload }); +## Aggregates (write model) + +### IAggregate + +Aggregates handle commands and emit events. The minimal aggregate contract is [IAggregate](src/interfaces/IAggregate.ts): + +```ts +export interface IAggregate { + + /** + * Applies a single event to update the aggregate's internal state. + * + * This method is used primarily when rehydrating the aggregate + * from the persisted sequence of events + * + * @param event - The event to be applied + */ + mutate(event: IEvent): void; + + /** + * Processes a command by executing the aggregate's business logic, + * resulting in new events that capture the state changes. + * It serves as the primary entry point for invoking aggregate behavior + * + * @param command - The command to be processed + * @returns A set of events produced by the command + */ + handle(command: ICommand): IEventSet | Promise; +} ``` -Behind the scene, an AggregateCommandHandler will catch the command, -try to load an aggregate event stream and project it to aggregate state, -then it will pass the command payload to the `createUser` handler we’ve defined earlier. +### AbstractAggregate -The `createUser` implementation can look like this: +[AbstractAggregate](src/AbstractAggregate.ts) is optional but recommended base class that provides the CQRS/ES wiring and covers common edge cases: state restoring, command routing, validation, snapshots. -```js -createUser(commandPayload) { - const { username, password } = commandPayload; +Without an internal state it can be as simple as this: + +```ts +import { AbstractAggregate } from 'node-cqrs'; + +type CreateUserCommandPayload = { username: string }; +type UserCreatedEventPayload = { username: string }; - this.emit('userCreated', { - username, - passwordHash: md5Hash(password) - }); -} +class UserAggregate extends AbstractAggregate { + createUser(payload: CreateUserCommandPayload) { + this.emit('userCreated', { username: payload.username }); + } +} ``` -Once the above method is executed, the emitted userCreated event will be persisted and delivered to event handlers (sagas, projections or any other custom event receptors). +By default, `node-cqrs` infers handled message types from public method names (so `createUser()` handles the `createUser` command). +### Aggregate State -### Aggregate → Event → Projection → View +Typically, it's simplest to keep aggregate state separate from command handlers and derive it by projecting the aggregate's emitted events. -Now it’s time to work on a read model. We’ll need a projection that will handle our events. Projection must implement 2 methods: `subscribe(eventStore)` and `project(event)` . -To make it easier, you can extend an `AbstractProjection`: +User aggregate state implementation could look like this: ```js -const { AbstractProjection } = require('node-cqrs'); +class UserAggregateState { + passwordHash: string; -class UsersProjection extends AbstractProjection { - static get handles() { - return ['userCreated']; - } - - userCreated(event) { - // ... - } + passwordChanged(event: IEvent) { + this.passwordHash = event.payload.passwordHash; + } } ``` -By default, projection uses async `InMemoryView` for inner view, but we’ll use `Map` to make it more familiar: +Each event handler is defined as a separate method, which modifies the state. Alternatively, a common `mutate(event)` handler can be defined, which will handle all aggregate events instead. + +Aggregate state **should NOT throw any exceptions**, all type and business logic validations should be performed in the Aggregate during the command processing. + +Pass the state instance as a property to the AbstractAggregate constructor, or define it as a read-only stateful property in your aggregate class. State will be restored from past events upon new command delivery and will be ready for the business logic validations: ```js -class UsersProjection extends AbstractProjection { - get view() { - return this._view || (this._view = new Map()); - } +class UserAggregate extends AbstractAggregate { + + protected readonly state = new UserAggregateState(); - // ... + changePassword(payload: ChangePasswordCommandPayload) { + if (md5(payload.oldPassword) !== this.state.passwordHash) + throw new Error('Invalid password'); + + this.emit('passwordChanged', { + passwordHash: md5(payload.newPassword) + }); + } } ``` -With `Map` view, our event handler can look this way: +### External Dependencies + +If you are going to use a built-in [DI container](#containerbuilder), your aggregate constructor can accept instances of the services it depends on, they will be injected automatically upon each aggregate instance creation: ```js -class UsersProjection extends AbstractProjection { - // ... +import { ContainerBuilder, AbstractAggregate } from 'node-cqrs'; + +class UserAggregate extends AbstractAggregate { + + constructor({ id, authService }) { + super({ id }); - userCreated(event) { - this.view.set(event.aggregateId, { - username: event.payload.username - }); + // save injected service for use in command handlers + this._authService = authService; + } + + async signupUser(payload) { + // use the injected service + await this._authService.registerUser(payload); } } + +const builder = new ContainerBuilder(); +builder.register(AuthService).as('authService'); +builder.registerAggregate(UserAggregate); ``` -Once the projection is ready, it can be registered in the DI container: +## Projections and Views (read model) -```js -builder.registerProjection(UsersProjection, 'users'); +Projection is an Observer, that listens to events and updates an associated View. + +### IProjection (minimal contract) + +The minimal projection contract is [IProjection](src/interfaces/IProjection.ts): + +```ts +interface IProjection extends IObserver { + readonly view: TView; + + /** Subscribe to new events */ + subscribe(eventStore: IObservable): Promise | void; + + /** Restore view state from not-yet-projected events */ + restore(eventStore: IEventStorageReader): Promise | void; + + /** Project new event */ + project(event: IEvent): Promise | void; +} ``` -And accessed from anywhere in your app: +### AbstractProjection -```js -container.users -// Map { 1 => { username: 'John' } } +[AbstractProjection](src/AbstractProjection.ts) is the recommended base class for implementing projections with handler methods and built-in subscribe/restore behavior: + +```ts +import { AbstractProjection, type IEvent } from 'node-cqrs'; + +type UsersView = Map; + +class UsersProjection extends AbstractProjection { + + constructor() { + super(); + this.view = new Map(); + } + + userCreated(event: IEvent) { + this.view.set(event.aggregateId as string, { + username: event.payload!.username + }); + } +} +``` + +Same rule applies as for AbstractAggregate: `userCreated()` handles the `userCreated` event unless you override `handles`. + +### View restoring on start + +For persistent views and safe restarts, a default projection `view` can implement [IViewLocker](src/interfaces/IViewLocker.ts) and [IEventLocker](src/interfaces/IEventLocker.ts) to support catch-up and last-processed checkpoints. + +### Accessing views + +When projection is being registered in the [DI container](#containerbuilder), the default `view` can be automatically exposed with a given name: + +```ts +import { ContainerBuilder, IContainer } from 'node-cqrs'; + +interface MyDiContainer extends IContainer { + usersView: UsersView; +} + +const builder = new ContainerBuilder(); +builder.registerProjection(UsersProjection, 'usersView'); + +const container = builder.container(); +const userRecord = container.usersView.get('1'); ``` -## Contribution +In case projection manages multiple views, those views can be exposed to container instance manually: + +```ts +builder.registerProjection(UsersProjection).as('usersProjection'); +builder.register(c => c.usersProjection.users).as('usersView'); +builder.register(c => c.usersProjection.connections).as('connectionsView'); +``` + +## Infrastructure modules + +### In-memory + +In-memory implementations intended for tests and local development. + +* [InMemoryEventStorage](src/in-memory/InMemoryEventStorage.ts) +* [InMemoryMessageBus](src/in-memory/InMemoryMessageBus.ts) +* [InMemoryView](src/in-memory/InMemoryView.ts) + +### SQLite + +Persistent views + catch-up/checkpoint tooling. + +```ts +import { AbstractSqliteView, SqliteObjectView } from 'node-cqrs/sqlite'; +``` + +- [AbstractSqliteView](src/sqlite/AbstractSqliteView.ts) - Base class for SQLite-backed projection views with restore locking and last-processed-event tracking +- [SqliteObjectView]() - SQLite-backed object view with restore locking and last-processed-event tracking + +### RabbitMQ + +Cross-process event distribution. + +```ts +import { RabbitMqEventBus, RabbitMqGateway } from 'node-cqrs/rabbitmq'; +``` + +- [RabbitMqGateway](src/rabbitmq/RabbitMqGateway.ts) - implements the IObservable interface using RabbitMQ +- [RabbitMqEventBus](src/rabbitmq/RabbitMqEventBus.ts) - RabbitMQ-backed `IEventBus` with named queues support + +### Workers + +Run projections and corresponding views in `worker_threads` to isolate CPU-heavy work and keep the main thread responsive. + +```ts +import { AbstractWorkerProjection } from 'node-cqrs/workers'; +``` + +- [AbstractWorkerProjection](src/workers/AbstractWorkerProjection.ts) - Projection base class that can run projection handlers and the associated view in a worker thread. + +## Testing and Contribution + +```bash +npm test +npm run lint +``` -* [editorconfig](http://editorconfig.org) -* [eslint](http://eslint.org) -* `npm test -- --watch` +- [editorconfig](http://editorconfig.org) +- [eslint](http://eslint.org) ## License diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index f1bcfed..0000000 --- a/docs/README.md +++ /dev/null @@ -1,18 +0,0 @@ -# Table of Contents - -* [ReadMe](/README.md) -* [Entities](/docs/entities/README.md) - * [Messages](/docs/entities/Messages/README.md) - * [Aggregate](/docs/entities/Aggregate/README.md) - * [State](/docs/entities/Aggregate/State.md) - * [Command Handlers](/docs/entities/Aggregate/CommandHandlers.md) - * [External Dependencies](/docs/entities/Aggregate/Dependencies.md) - * [Snapshots](/docs/entities/Aggregate/Snapshots.md) - * [Projection](/docs/entities/Projection/README.md) - * [InMemoryView](/docs/entities/Projection/InMemoryView.md) - * [Saga](/docs/entities/Saga/README.md) - * [Event Receptor](/docs/entities/EventReceptor/README.md) -* [Middleware](/docs/middleware/README.md) - * [DI Container](/docs/middleware/DIContainer.md) - * [AggregateCommandHandler](/docs/middleware/AggregateCommandHandler.md) -* [Infrastructure](/docs/infrastructure/README.md) diff --git a/docs/entities/Aggregate/CommandHandlers.md b/docs/entities/Aggregate/CommandHandlers.md deleted file mode 100644 index d10db40..0000000 --- a/docs/entities/Aggregate/CommandHandlers.md +++ /dev/null @@ -1,76 +0,0 @@ -# Aggregate Command Handlers - -At minimum Aggregates are expected to implement the following interface: - -```ts -declare interface IAggregate { - /** Main entry point for aggregate commands */ - handle(command: ICommand): void | Promise; - - /** List of events emitted by Aggregate as a result of handling command(s) */ - readonly changes: IEventStream; -} -``` - -In a such aggregate all commands will be passed to the `handle` method and emitted events will be read from the `changes` property. - -Note that the event state restoring need to be handled separately and corresponding event stream will be passed either to Aggregate constructor or Aggregate factory. - -Most of this boilerplate code is already implemented in the AbstractAggregate class: - -## AbstractAggregate - -`AbstractAggregate` class implements `IAggregate` interface and separates command handling and state mutations (see [Aggregate State](./State.md)). - -After AbstractAggregate is inherited, a separate command handler method needs to be declared for each command. Method name should match the `command.type`. Events can be produced using either `emit` or `emitRaw` methods. - - -```js -const { AbstractAggregate } = require('node-cqrs'); - -class UserAggregate extends AbstractAggregate { - - get state() { - return this._state || (this._state = new UserAggregateState()); - } - - /** - * "signupUser" command handler. - * Being invoked by the AggregateCommandHandler service. - * Should emit events. Must not modify the state directly. - * - * @param {any} payload - command payload - * @param {any} context - command context - */ - signupUser(payload, context) { - if (this.version !== 0) - throw new Error('command executed on existing aggregate'); - - const { profile, password } = payload; - - // emitted event will mutate the state and will be committed to the EventStore - this.emit('userSignedUp', { - profile, - passwordHash: hash(password) - }); - } - - /** - * "changePassword" command handler - */ - changePassword(payload, context) { - if (this.version === 0) - throw new Error('command executed on non-existing aggregate'); - - const { oldPassword, newPassword } = payload; - - // all business logic validations should happen in the command handlers - if (!compareHash(this.state.passwordHash, oldPassword)) - throw new Error('old password does not match'); - - this.emit('userPasswordChanged', { - passwordHash: hash(newPassword) - }); - } -} -``` diff --git a/docs/entities/Aggregate/Dependencies.md b/docs/entities/Aggregate/Dependencies.md deleted file mode 100644 index f66adeb..0000000 --- a/docs/entities/Aggregate/Dependencies.md +++ /dev/null @@ -1,20 +0,0 @@ -# External Dependencies - -If you are going to use a built-in [DI container](../../middleware/DIContainer.md), your aggregate constructor can accept instances of the services it depends on, they will be injected automatically upon each aggregate instance creation: - -```js -class UserAggregate extends AbstractAggregate { - - constructor({ id, events, authService }) { - super({ id, events, state: new UserAggregateState() }); - - // save injected service for use in command handlers - this._authService = authService; - } - - async signupUser(payload, context) { - // use the injected service - await this._authService.registerUser(payload); - } -} -``` diff --git a/docs/entities/Aggregate/README.md b/docs/entities/Aggregate/README.md deleted file mode 100644 index 80341cf..0000000 --- a/docs/entities/Aggregate/README.md +++ /dev/null @@ -1,21 +0,0 @@ -# Aggregate - -At minimum Aggregates are expected to implement the following interface: - -```ts -declare interface IAggregate { - /** Main entry point for aggregate commands */ - handle(command: ICommand): void | Promise; - - /** List of events emitted by Aggregate as a result of handling command(s) */ - readonly changes: IEventStream; -} -``` - -In a such aggregate all commands will be passed to the `handle` method and emitted events will be read from the `changes` property. - -Note that the event state restoring need to be handled separately and corresponding event stream will be passed either to Aggregate constructor or Aggregate factory. - -Most of this boilerplate code is already implemented in the [AbstractAggregate class](https://github.com/snatalenko/node-cqrs/blob/master/types/classes/AbstractAggregate.d.ts). - -It separates [command handling](./CommandHandlers.md), internal [state mutation](./State.md), and handles aggregate state restoring from event stream. It also provides a boilerplate code to simplify work with [Aggregate Snapshots](Snapshots.md) diff --git a/docs/entities/Aggregate/Snapshots.md b/docs/entities/Aggregate/Snapshots.md deleted file mode 100644 index 75a545f..0000000 --- a/docs/entities/Aggregate/Snapshots.md +++ /dev/null @@ -1,35 +0,0 @@ -# Aggregate Snapshots - -Snapshotting functionality involves the following methods: - -* `get snapshotVersion(): number` - `version` of the latest snapshot -* `get shouldTakeSnapshot(): boolean` - defines whether a snapshot should be taken -* `takeSnapshot(): void` - adds state snapshot to the `changes` collection, being invoked automatically by the [AggregateCommandHandler](#aggregatecommandhandler) -* `makeSnapshot(): object` - protected method used to snapshot an aggregate state -* `restoreSnapshot(snapshotEvent): void` - protected method used to restore state from a snapshot - -If you are going to use aggregate snapshots, you either need to keep the state structure simple (it should be possible to clone it using `JSON.parse(JSON.stringify(state))`) or override `makeSnapshots` and `restoreSnapshot` methods with your own serialization mechanisms. - -In the following sample a state snapshot will be taken every 50 events and added to the aggregate `changes` queue: - -```js -class UserAggregate extends AbstractAggregate { - get shouldTakeSnapshot() { - return this.version - this.snapshotVersion > 50; - } -} -``` - -If your state is too complex and cannot be restored with `JSON.parse` or you have data stored outside of aggregate `state`, you should define your own serialization and restoring functions: - -```js -class UserAggregate extends AbstractAggregate { - makeSnapshot() { - // return a field, stored outside of this.state - return { trickyField: this.trickyField }; - } - restoreSnapshot({ payload }) { - this.trickyField = payload.trickyField; - } -} -``` diff --git a/docs/entities/Aggregate/State.md b/docs/entities/Aggregate/State.md deleted file mode 100644 index 88da3b4..0000000 --- a/docs/entities/Aggregate/State.md +++ /dev/null @@ -1,50 +0,0 @@ -# Aggregate State - -[EventStore]: ../../middleware/README.md -[AbstractAggregate.js]: https://github.com/snatalenko/node-cqrs/blob/master/src/AbstractAggregate.js - - -Aggregate state is an internal aggregate property, which is used for domain logic validations in [Aggregate Command Handlers](CommandHandlers.md). - -## Implementation - -Typically aggregate state is expected to be managed separately from the aggregate command handlers and should be a projection of events emitted by the aggregate. - -User aggregate state implementation could look like this: - -```js -class UserAggregateState { - userSignedUp({ payload }) { - this.profile = payload.profile; - this.passwordHash = payload.passwordHash; - } - - userPasswordChanged({ payload }) { - this.passwordHash = payload.passwordHash; - } -} -``` - -Each event handler is defined as a separate method, which modifies the state. Alternatively, a common `mutate(event)` handler can be defined, which will handle all aggregate events instead. - -Aggregate state **should NOT throw any exceptions**, all type and business logic validations should be performed in the [aggregate command handlers](CommandHandlers.md). - -## Using in Aggregate - -`AbstractAggregate` restores aggregate state automatically in [its constructor][AbstractAggregate.js] from events, retrieved from the [EventStore][EventStore]. - -In order to make Aggregate use your state implementation, pass its instance as a property to the AbstractAggregate constructor, or define it as a read-only stateful property in your aggregate class: - -```js -class UserAggregate extends AbstractAggregate { - // option 1 - get state() { - return this._state || (this._state = new UserAggregateState()); - } - - constructor(props) { - // option 2 - super({ state: new UserAggregateState(), ...props }); - } -} -``` diff --git a/docs/entities/EventReceptor/README.md b/docs/entities/EventReceptor/README.md deleted file mode 100644 index d502fb0..0000000 --- a/docs/entities/EventReceptor/README.md +++ /dev/null @@ -1,38 +0,0 @@ -# Event Receptor - -Event receptor is an Observer that subscribes to events and performs operations non-related to core domain logic (i.e. send welcome email to a new user upon signup). - -```js -const { subscribe } = require('node-cqrs'); - -class MyReceptor { - static get handles() { - return [ - 'userSignedUp' - ]; - } - - subscribe(observable) { - subscribe(observable, this); - } - - userSignedUp({ payload }) { - // send welcome email to payload.email - } -} -``` - -If you are creating/registering a receptor manually: - -```js -const receptor = new MyReceptor(); -receptor.subscribe(eventStore); -``` - - -To register a receptor in the [DI Container](../../middleware/DIContainer.md): - -```js -container.registerEventReceptor(MyReceptor); -container.createUnexposedInstances(); -``` diff --git a/docs/entities/Messages/README.md b/docs/entities/Messages/README.md deleted file mode 100644 index 9b698ae..0000000 --- a/docs/entities/Messages/README.md +++ /dev/null @@ -1,76 +0,0 @@ -# Messages - -[Middleware]: ../../middleware/README.md "Middleware" -[Aggregate]: ../Aggregate/README.md "Aggregate" -[Saga]: ../Saga/README.md -[Projection]: ../Projection/README.md -[Receptor]: ../EventReceptor/README.md - -All messages flowing thru the system are loosely typed objects with a minimal set of required fields: - -* `type: string` - command or event type. for commands it's recommended to name it as a call to action (i.e. "createUser"), while for events it should describe what happened in a past tense (i.e. "userCreated"). -* `payload: any` - command or event data -* `context: object` - key-value object with information on context (i.e. logged in user ID). context must be specified when a command is being triggered by a user action and then it's being copied to events, sagas and subsequent commands - -Other fields are used for message routing and their usage depends on the flow: - -* `aggregateId: string|number|undefined` - unique aggregate identifier -* `aggregateVersion: number` -* `sagaId: string|number|undefined` -* `sagaVersion: number` - - -## Commands - -* sent to [CommandBus][Middleware] manually -* being handled by [Aggregates][Aggregate] -* may be enqueued by [Sagas][Saga] - - -Command example: - -```json -{ - "type": "signupUser", - "aggregateId": null, - "payload": { - "profile": { - "name": "John Doe", - "email": "john@example.com" - }, - "password": "test" - }, - "context": { - "ip": "127.0.0.1", - "ts": 1503509747154 - } -} -``` - - -## Events - -* produced by [Aggregates][Aggregate] -* persisted to [EventStore][Middleware] -* may be handled by [Projections][Projection], [Sagas][Saga] and [Event Receptors][Receptor] - -Event example: - -```json -{ - "type": "userSignedUp", - "aggregateId": 1, - "aggregateVersion": 0, - "payload": { - "profile": { - "name": "John Doe", - "email": "john@example.com" - }, - "passwordHash": "098f6bcd4621d373cade4e832627b4f6" - }, - "context": { - "ip": "127.0.0.1", - "ts": 1503509747154 - } -} -``` diff --git a/docs/entities/Projection/InMemoryView.md b/docs/entities/Projection/InMemoryView.md deleted file mode 100644 index 86707a6..0000000 --- a/docs/entities/Projection/InMemoryView.md +++ /dev/null @@ -1,48 +0,0 @@ -InMemoryView -============ - -By default, AbstractProjection instances get created with an instance of InMemoryView associated. - -The associted view can be accessed thru the `view` property and provides a set of methods for view manipulation: - -* `get ready(): boolean` - indicates if the view state is restored -* `once('ready'): Promise` - allows to await until the view is restored -* operations with data - * `get(key: string, options?: object): Promise` - * `create(key: string, record: any)` - * `update(key: string, callback: any => any)` - * `updateEnforcingNew(key: string, callback: any => any)` - * `delete(key: string)` - - -In case you are using the [DI container](../middleware/DIContainer.md), projection view will be exposed on the container automatically: - -```js -container.registerProjection(MyProjection, 'myView'); - -// @type {InMemoryView} -const view = container.myView; - -// @type {{ profile: object, passwordHash: string }} -const aggregateRecord = await view.get('my-aggregate-id'); -``` - -Since the view keeps state in memory, upon creation it needs to be restored from the EventStore. -This is [handled by the AbstractProjection](./README.md) automatically. - -All queries to the `view.get(..)` get suspended, until the view state is restored. Alternatively, you can either check the `ready` flag or subscribe to the "ready" event manually: - -```js -// wait until the view state is restored -await view.once('ready'); - -// query data -const record = await view.get('my-key'); -``` - -In case you need to access the view from a projection event handler (which also happens during the view restoring), to prevent the deadlock, invoke the `get` method with a `nowait` flag: - -```js -// accessing view record from a projection event handler -const record = await this.view.get('my-key', { nowait: true }); -``` diff --git a/docs/entities/Projection/README.md b/docs/entities/Projection/README.md deleted file mode 100644 index 0a94cf6..0000000 --- a/docs/entities/Projection/README.md +++ /dev/null @@ -1,48 +0,0 @@ -# Projection - -Projection is an Observer, that listens to events and updates an associated View. - -## Projection View Restoring - -By default, an [InMemoryView](https://github.com/snatalenko/node-cqrs/blob/master/src/in-memory/InMemoryViewStorage.js) is used. That means that upon application start, Projection queries all known events from the EventStore and projects them to the view. Once this process is complete, the view's `ready` property gets switched from *false* to *true*. - -## Projection Event Handlers - -All projection event types must be listed in the static `handles` getter and event type must have a handler defined: - -```js - -const { AbstractProjection } = require('node-cqrs'); - -class MyProjection extends AbstractProjection { - static get handles() { - return [ - 'userSignedUp', - 'userPasswordChanged' - ]; - } - - async userSignedUp({ aggregateId, payload }) { - const { profile, passwordHash } = payload; - - await this.view.create(aggregateId, { - profile, - passwordHash - }); - } - - async userPasswordChanged({ aggregateId, payload }) { - const { passwordHash } = payload; - await this.view.update(aggregateId, view => { - view.passwordHash = passwordHash; - }); - } -} - -``` - -## Accessing Projection View - -Associated view is exposed on a projection instance as `view` property. - -By default, AbstractProjection instances get created with an instance of [InMemoryView](./InMemoryView.md) associated. diff --git a/docs/entities/README.md b/docs/entities/README.md deleted file mode 100644 index 4fc89d3..0000000 --- a/docs/entities/README.md +++ /dev/null @@ -1,7 +0,0 @@ -# Entities - -* [Messages](Messages/README.md) -* [Aggregate](Aggregate/README.md) -* [Projection](Projection/README.md) -* [Saga](Saga/README.md) -* [Event Receptor](EventReceptor/README.md) \ No newline at end of file diff --git a/docs/entities/Saga/README.md b/docs/entities/Saga/README.md deleted file mode 100644 index 2dc3759..0000000 --- a/docs/entities/Saga/README.md +++ /dev/null @@ -1,94 +0,0 @@ -# Saga - -[AbstractSaga.d.ts]: https://github.com/snatalenko/node-cqrs/blob/master/types/classes/AbstractSaga.d.ts - - -Saga can be used to control operations where multiple aggregates are involved. - -## SagaEventReceptor - -`SagaEventReceptor` instance is needed for each Saga type, it - -1. Subscribes to event store and awaits events handled by Saga -2. Instantiates Saga with corresponding event stream -3. Passes events to saga -4. Sends enqueued commands to the CommandBus - -Saga event receptor can be created manually: - -```js -const sagaEventReceptor = new SagaEventReceptor({ - sagaType: MySaga, - eventStore, - commandBus -}); - -sagaEventReceptor.subscribe(eventStore); -``` - -or using the [DI container](../../middleware/DIContainer.md) : - -```js -builder.registerSaga(MySaga); -``` - -## Saga Interface - -At minimum Sagas should implement the following interface: - -```ts -declare interface ISaga { - /** List of event types that trigger new Saga start */ - static readonly startsWith: string[]; - - /** List of event types being handled by Saga */ - static readonly handles?: string[]; - - /** List of commands emitted by Saga */ - readonly uncommittedMessages: ICommand[]; - - /** Main entry point for Saga events */ - apply(event: IEvent): void | Promise; - - /** Reset emitted commands when they are not longer needed */ - resetUncommittedMessages(): void; -} -``` - -Also, it needs to handle saga internal state restoring from the `events` property passed either to the Saga constructor or as a Saga factory attribute. - - -## AbstractSaga - -Most of the above logic is implemented in the [AbstractSaga class][AbstractSaga.d.ts] and it can be extended with saga business logic only. - -Event handles should be defined as a separate methods, where method name correspond to `event.type`. Commands can be sent using the `enqueue` (or `enqueueRaw`) method - -```ts -const { AbstractSaga } = require('node-cqrs'); - -class SupportNotificationSaga extends AbstractSaga { - - static get startsWith() { - return ['userLockedOut']; - } - - /** - * "userLockedOut" event handler which also starts the Saga - */ - userLockedOut({ aggregateId }) { - - // We use empty aggregate ID as we target a new aggregate here - const targetAggregateId = undefined; - - const commandPayload = { - subject: 'Account locked out', - message: `User account ${aggregateId} is locked out for 15min because of multiple unsuccessful login attempts` - }; - - // Enqueue command, which will be sent to the CommandBus - // after method execution is complete - this.enqueue('createTicket', targetAggregateId, commandPayload); - } -} -``` diff --git a/docs/images/README.md b/docs/images/README.md deleted file mode 100644 index e69de29..0000000 diff --git a/docs/images/node-cqrs-components.png b/docs/images/node-cqrs-components.png deleted file mode 100644 index 3cb7bb8e708e6f6ca82c9efed7cecef6b303cd1d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 50824 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 MR+cJ}Fn;xa08uFeaR2}S diff --git a/docs/images/node-cqrs-flow.png b/docs/images/node-cqrs-flow.png new file mode 100644 index 0000000000000000000000000000000000000000..2d1cd07de0ccd9363f088ba88bc00f8bf1c9d644 GIT binary patch literal 890922 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 z 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 z zqIx79vJvB476gdf$_`n$3>;~WKQfMStdEqv$y3@HL91))U7X@)#{Y+|Z5Q%R>sr6| z`)~1dmzgq^R^6UoZ64BIM)29vLVxK5wFX`Mj7g9@rUmn{$DdH{zyIN~!TM{V>_LWL zKD%)7;_|>l?2w!@2Mg1ASfKVHPoN+~W^z8Y^;TPzJ@)vQvf9+C;m71{E&y)xmj|6U zyAWynN`F9<79Yb~T2)>*u=X#4GGZ-5{ji9p)z3V9w&gKK`))kjSlWOInz%`8ye41s zlzGIIr)@BUcHPG5a>V%hiDR;#?6?qe~7-NpQB{gEN_1OtIPE1(;9rO z-Tz%FREFxP8ssO&40kDEVQ;;zr2lgP#|v%cS&yeNOu4FW00k?G{~naN>Q0s{MrmvP z(N7IveJ<^nBS6KHyMy!KQKCk9N_HBN^>I9qXTKXyYxU?w$Wytz2g4E5y2HHAKeY%) z2f@5g!>|D+7LJ*@$By|WTCiVz=^Z{ zhjS)(glic;K-nBG>F`;2=_?(~YgVnqavY2MsS_rp>>Y)<20Id5AW#>!6y>|TtAg1% zZ$FEXD=ACndEn|L$gG710j%)V19*>#ZBQJ%DA~3%x)XY0jlaqT7{(AU%(X6D zeDT0ng?4-i92F!_h&?eqAVLJWs#swMYw%JJ3nEm^6mPi2gn-@}Z>$ zRg30(H$rXuE=D-k*;f0YsfKjpCb&buJK~@dI~r8BI|u7u$gYB^lm)yOvvZ^ixIUFL z)DMkd99;p;tV@rm)UYu0rY;>5y(l>6_q!;-;)+KWEe03o(aQ4X?jyATkXWSD}piw0~ zQP4Afe=P;vrj^#*Fr=MQ>txC}$BgE+4Rf$*U4#cb^lArI-xU%Zq!ozXyz{Q*;tMY> zYj3bYnfu5iG_3Bj%g#HOjW^yH1?0H$$IJg%e)-E^l73a0Icw&ikYGL;nCU3%mT^65 z1FATf(~xWZhU4BgtX9ZLoPcQu{@R%dxQ(M=(|()(3d|ggi3gCLnaAe%lFn1U>Q= zgM30La}w?5ct5$qJjBPeg_EQYfUklt#Wwg+cI0$ zr<)V6)Eh`kOIN7fF6Koxom}uUVZuZdp}pmti!LkYTySyO>5Z=`uX^Q6!{=>Tgz;p~ z5b5DlD&KYYedVru?gj4nOeoe~d+jo7*7OJ;Rlu#Vf)nwz0LTOsrBhbR@ynzis4BtD zTDDU`Mbk^Y%3G`GHRV&srZ^%geDsd(EOY11FCY5IN6Oh}os#W!6Q`_(-yF6-^q1AA zO~;CSLb>~%yBH`Jmub_dm-`>MuYB>qFO{GD^ye(nISB^`gaC15oKM~=$;89ISYVK^ zxT#!K@X|ux@)=(tTOmL`Qv_-0U5u^pYX~ZJ} zJu&3*RBMPCgs=_4Y0H>3;78VzGuvsSvFj6 zflsp_tyQeY4L4k$aPJA= z=%EP{%GK9ijlkcRBfSRumSFx5^h23@S?KJYFs@8SX)%Z6%6|3Rlh_e;cG>kUZz|7! z{&Op#28&edX7KYby;%4BQ>YJ(sAPqAoozzeu3|!ibUs)&)}3*e!ME~G`UB#dtUX@J z`joF7n+>n+-+H!>GS6D)@`IBgeVS&9GOzNBux$rXc<_;(LM>l}4=U`o&-W=0$~U~` zPZ;8q4>KiD%QKx5&FTco8{Xk(CKx{B^lzMW^1t}lujNP=zisZ|Y5I)olqYS2yy;rv z#K*KwY@*N?zPRv6nzqj(jzfE7kth*`U6EKakYNvyUnlh zt0B#=egs%E!KH~*@iI|`zq~SR$_aag;Np-5WS+`rC+%Baz0HgmuhzrphVFR>HeICh;&hPne_ zXvh2GsbJjU&hLuH5H{Cd`{(km_j~}w);x|poFY>rA8}SWWB-aA?O|Ma#lFz`RX~7Y ze|y~V<))i%z|igR;9~e=8Z4=@DovYE=T|LXJyOhJtvF!Mzw92*6~Gr z~~quDk7)dCssB1XRi!JchuVpZL_VzQo|gxj^JW3|)rPd??k^ z!9u-{IDLhCgv+QLeadCKE0>f7?0Qi5 zrm>_wx;p`sHC<>AuS0WHbz}#vLDl&^f~*$tE|9ErafG<0Rrx)@f{9~8b}cx5^)PqA zI79iE+#$oNAv-{YyJ=%dtc#$2*xkkK;~-rSgdW;N%6#;@HE2?PB@^ z7jlHVf(p&uUM^N>@CEN_nZI}e7Z8)1_Xy-ne+O*_aPOMXxXhCYyl;YLoCSbR>Nyt{ zGk=S6US3R@>mrs5OXIU(0^d;9>=dUA&g;f;1QB~b$_kFd?SR%@@S}@T)iRIzbI!@9 z_gz>97iLm%)Q|NM2OVvP?nX%crV?toLi-2a*a>G0@Sn}%K$Dolh_Xbf{Q z=g?qTgHrQ;_^6>o+me;)EmF3F^f2mAE zU})X$yY9^DW>+}`L1ODIUqDB0r%vPKDJ-oCbeRCq3)VrJ;lWuE`4WY=;%a9`#0HlP zAb1Yq)A+Y|rtt-`iEwQ?(lo`a{ss-wq7Jrg`IC%vH4i)NfElDu1yKEsQ}Yz3CZvVS zQvqZsPK7C5>rM!tZTgxvaVa-Z;+zPya2qees?g+j@^12N9!)yF_}}KQ=kRyGRrHyW zb+Cwg848+AS{~R>U%R$;s*N!tQ%$&W~I+dZ-iAh_6HuV4a8FFaR#o#oq zr`-SG+)PYt9||(lQGzOj{Op($$_1DFvF!2oU1M<}*3w@dsAaNj|J_L|1*q$9ygrv; zPn$Ze%$xgQdG;ooF)*^_jg@dm53Rivnw>1h`V3*hb7JfH^VLc@meL3WjBmkBrI)nL zzzx4F$C_Kkuzaut#g;P)&k({KR4ckc0?viq*P zVevaF77;hGF{bTVO3zg{FL^-RZMG`KT?Nlp zMT9x652Dl~UAs^bK867$OD3!^efUS%cnU{1r07#$d?1HQ!73NsHa=|-eH!m6})%r>rqk??i)n_0wAIKoSzaZpIAU6mj+QP*W`O~-TrAOc0kneTwa#Of335hNLwV~W1dXhY+H3ALKwB`BuFPOxl?6@m;K5M{EZ}k zo%PSKMB5S`oFKE}!h^^kwiYJDXJO z3$@}`+qwNPMp)2_Jk6KzEYfLVWOn$qI~-INRcEX^_S=4qXI}R60&`0>hv)!fNCZ1`Gn4Nn~e=ck>w6K=g`cd8r zy^W8P2D*v^c>1r&(=v;wxP&52nn7MMDS=Kb#nE_XsO-}^>qR^gCLG`OYiJ_eq$Quc z@R2eLiu}bzaN=owk8)yW0{$y&YH@2{B5&1ryf^$)`)A5c+Nx|Yp7)L*4XaOB-QJklnesk;z<-vy@DI0FEUYX3DSkK*jQ{?Kkz}1Sbb@tccN}*+t#(8i%whW3&3|XP_|i+umRmiS?oVc~xC_?))iRPT^d~_4XaHxPc~;qF z*LR@!9aYA#%X;a;1z52!sO2D#nsdoN90%8uBwqN^oq6t!M@ z>TZ9P&>r71fGq67fyNH@h3QG!usfTC#J#d~atr7Zxv$0$gi;7id=@0}eok74+>( zD6=wOAJ*e5Ss+-*ZhsZU^SKLP0gD0}P&tlzN68qi*EK+i9)NbEVGKB^koVkv&!CqV zwN6*AT!NLoacxh1w8N3e=pIX|p{B?2xDc?M9S82N$hq`%r7mEMTEXH0G;k+W=CjD6 z(IGII>Ogt#Maj-_9rIkIvD@^hAL+jcy4ijvPo9uPpSh3D=VXX6+>=)C1Mp&E`O9i7nJ(h zAz@$8O+LP>e0L{OF7@St<>e^+N0Q#T^HSz$@|j9}>&rVICX?>~buovdP1%bsWX>=Twzm(KGBT-@cmqk{zwCy$0%zdT3!jnFEu+iw`Ji+Iv9 z#?|&|IP1?pWzO{3GW#>`DNz6lKjZ$_6rgcBxl*w{3I?^c+E6`%EiMhB6`qH3bMS3l z-kR@0CI+tWHW-=vCqMs1Irdk_lntN#?DD|9_mwyA_@?r$Zyk~qVjE2w0&zWyYyZ!D zvTVM|=4Jbry*OD^fng{=kc@vjSxcU_+_*ZR8Rp0_93Ru!0qI9E9r^;wyjy2j{xa;; zI1Uz%akapM0!Y9B!+*)ow6uDKME@Gnq@xU2va{2&!;n6)DDb<M2u7g}0B9_^Mc*K_ZM z^`Mou))QMidvl@^O7Wf4)prI8CZZ!4T-*w-kfM^3WDKUv3?aJ5Tj+9TA?X#ER6MI+ zvdz{>bKOpEJT2L}5llYu@z0kl{&-QD&hbtT-V-=7=8*3kRbKU)Z4ek%aiJ-LVBe~; z>1G?1U;OmPW&eNsVmbQPzbdbL_3JnTaYR|%Z`)F^Z|aMu+xeVWo3Bc&OtQ(-LD5}2 zQMQ4vtxLYC?M!+hWcv?Lmb|tj237I*TkAO9{Sc<_9bI?9{G?RE~U|XS> zxJnll+2$*CgyYll8E&~VQGzB~3y>o43{$WbwvnxK5UdJux4Ej2%s;$UEYRhtq}Epj zxJpqVCx-kn8s1t)`_tJ!hJ?VgeBzSy@Pc$zfiN0@yIyo?oKmK6p>1kLnuF_jtihK+ zcX>_P2}HQv2w1P!;U(qU-(5Y&0BP~o%~|nLazKZ+Jvi>DKv5u+*5Z%_Az#2+x&Sf$ z{*0j0Q^9XPR>Lcu!$%aR_E*-mr3Mz|k`A_kszfCp{ta+UPb@h=c`;jG$4~5r=h+zn zX}l=ddjP7XHj@;TyXGZEOF3Rf!Be^kmj{A0dCmLYub)Z>Vk-{LHJbYLau#erN3>r4Y!Z3cZV?f zpuMbcF$kP8t~sugxI_M@ZB^c~o#K~%wkq!fn>^DFNn$(HPnNfhSDuyc#J%!iTU-@` zGLP-kzE@))`vv0Hv8zvl6wPmrq zy81ojuN7MBU(-mN%6DR9N%eQU8y+umC?3L-&cZQ9;PYZ%t1`Hz5kCX*2abH9v%Y;d zOkQup#d|Q0@re*Th#+nO6@V32U&X<&8c$gIROhqeR{b9TZmc#xVc8!HI$r&1d7vTV zV6ZQSTO^;Yvrn+Df*U{HgXW?fQdXiUKZ!>hCsuyKz%zFr@je<0L+R3@Q`>OO#oxAW ztXtuI||N$I~|H!ntjAc=`SCcp;IOI&_tBk-ZvTvuqyyBY~|`+w>>|Luoch zZ{Vb?AQH=TK3blu5dE!K4}JgteH)(JYK$`rP|z*H67|;Gt}N$bIJVLH>y?*m`$A;U z4P!AWHnm?c<&(Ri&{}?Ds_c^<(ygzruO@CQjxS%OyKa~_?-iQqB1aNFjvaoTTHA6w zhgMGOti2Y>KxA}y$crDl$xAEf@r;vR9;xN9_gzd|Z8|${KWG-grG;${Hea)9<%z+% z8HP;7#CWwWiSh9G`nNF6!}7G>fj10R!o!zM|Id3(ZwP7m*6HWlaJq|!yTBJgN0nqM z-Moap|p7%)k&__RBPC5B^)Js(mrx3(#@galY8UXy5 zUmI4(Ny6cm$RVLjAeHfudhr5X`?ocoHJiKK7L}j=`nYn=c^8-0 zzhQ^6#U>j^SuO6v>+~;`MLMV`cO3DV@rALPSx@K`*^m6~f3&{#NEHoyTv&~TI(?FL zkz-hyPmLWvmfgaf!_FeYn3Y|TH&oEtUkR%V8Cu!FPSbYlS@4vu;jb!N$f6$MXs0Yc z#$e1C@;PbrQwi?ergAaHKPbQzLR>g7TF#uOY>T}h99C79RO!78CAIkVu(0B>FDlNx zh}QP4^1K`Rc46(|9II>PXbkJ>g|Y6oM)E9U#*ay#&WyN>!V2GV^esd2+{e*i3kG7{ z&P<287{&3VV_8H*fxfaM#!$Jh1UXw;v}ftFHbS}R*I{{2Rp{q27(g>nYqfVS8lxA?+u}v4X0{40WR0b7#Q_GW62ov0j>toaX|@)QMAB zh(LMY32vjPr&Y!Sc^!{Qjl%t?225`%%clpzKTPJvonZR8L>U$9Q zyL&ydh>MC@NP+m_RgY?tkDM2IglQZArKR_w$TKpSG;}+AtPdhuur)V~fo|+C_;X_3?0~t!r zwboguTyn)VVG-cX+6256Q4M||%GTw1zWx%ZyF)S2}qpU-`Cp!A?5 zJ>U!f&W?e1l^GoW(vR{Kk|y!B zfCGdqv0y%D36f^~IIJ|HEMmo<1&@9#ueF3Qjl#f$@ih<2u9Bh;i}n6K#VMjlLteUj z5Y$jK%ZqNe6NVPtV;Rg!roPr;4=22$IXFDyamIj@3)sR@;U9%| zl%HD0yUkTg7X%-oD-hZr)V5psQMmRQQG!*p5Xd^pHP_xyZoBiYOoYvM#`GD`qmCO< zl#sD?C%qIBRUoQJm0&7t9TLW}Gers2JO-$jl#c}BU_|+4G<+dk6^hljDsTHy*7rjz z>8nMJG!(A=ayR&SPlbKd7=+LTbC*V_11Od=ymKs2l$fCpcp^O8R#eKEckbVSX9z~{ zbsI549yDD7{Bc;XNULdB#Aq#l>urzZ!YeP!y6Wm{LjM%f%>Kcg^mWn4ExQZZ`89d+ zq|}Xcl>etNo;n`=`h-);nOK^=^PT?`%T0@EyR#ns`%6xRRP7t(S^ESteC z7e3%y`Hi?*?8Z8bI&XQ5ZUblEppv}tPx}!E{qRIlq(xb*jEUVUlPqcwY#xpU={HFd zxR%c{^Rz#v8;P?Gh@a)L-}1d(n2=`r2}@U%|2%CQ5=_7JJ@i?$!K9_lh>Lw(7M+`S z`(bHkeW%Z%PPFE;tf3{Dxq~C^k+3K-Ed%MLzj;dky6C_w@9jdSbsf15zgp)t+ytgK zu4yCV_$@!+l`!6YN=K(siI;S|>yntKk&;SJ`@fp5(xUQROBcgT=AWs=P1?JQEMSC0 zpyjr&PoCg07>JiHFbK4ttm!IT-wo5X<8v|!-ti6m8gAU$hRi59HR%W8n6>rRJjFTV zap2dy{f;sweujg)<${q!#WdD!+t=0dser4+lK-un)VF014>|VK@thdFKci#=5{aK zrfl{6%^CkuV&NQLo(w-r(NHhtFn-bj*K#f5;z?b2%6^grwY)8#$P0-Q|CZ+xkpM6F z%+5+GTr20j-tkcs`yW6-g#1dl7RutLa;eh0!fJobuXXJ>>9=XyZ{Ni!f4rM_{EU~l zNs(~d40{x;K#&C?4h5;9 zY;^<9o%Y%9BW1y(4`ca1C6@mOe({S{`7d1JwzvwbrAPV;z8{-|F{*p(PH!w1ynmna ztwRq*(b-$hKj-Z7gC87OKJfm3&A2Om_UF=w98y+O*6$|IggFLk5lzEuGP8di9ycFP zqaV?Bhl>hf<+QOqV>2eJjCKw*WzuTp(fJF@kv~4VOyF*}SHE(*vfYb3ZNYha<*O$z zPUQpVs{Wm*Kh7k7`5z3r&GgLCX%WJ8YkxER(AV$JW4gHag9 z^>%uUkh%q-a^C*p`DvRT!K&guGA4b7a*y(?R`K3JFh*rRiwoXgU`czqSHK+%BbTEb zhn^$3$IST4$!FZeak=|osr@#6doRc2%v-#m%;Wea&!F!?A-$YA=1BSnkE4m@I|~c8 zmBr|1=77^ejs{}3N7+}Ei73;TF#m}4JZ0-*Cv?XMl>6Z8Ir)wS%XxR48pUcc5RtR! zb1-OfKB(cS3Tn@wS7ubEaGvX~01Kmay<@GoYP{pw^xj|QZUB!sR-W_@0q2v>$8yhu z^;10FsVelBu!F$kb~O4N!NSd|c4q#?o3$0JbBW@@rff%yO}R`u^q!*81j}zVDsR&IoyZ06uPOn7xz&Nvg%G; zFz_CNF77~-Zr)j-Uewxh0m_BldEn7!-yknC7E43n^r1&_jxd&Ef<_X)kX<3Uj{;qV zV|e5cWksBFow~v>TzsDSc`6iediRX`8&N<3OD42Ku|v-47O?9OJd{ZWV|&I-B;;8? zs#8vQ%mCW>AN8XjmAmh{tE|2L`YZsfk?= zhY|H(#04r}`{rTg=wBXP?zsIfl%aJSrycuvEH7XA>Q|J{e{O#+Wm=!c>x8=^^ND}| zeEI%ihnMv?*nl$!k1K1eF}qxJ$))A)yYFR{aV*;wpT`jfQ!+3}4_B;@{q0HRjMGmq z_uYSAgq)2w+@O5$L;IDr*IFwb1L%~ae{*d4{(9?`b1u9z$3CoN z;M;7I4a>GK+LlhymF#+U-SH=#RDS>aQ_2GmJP3X($`0FaSN1_b8AB%t0YJEx`_I?k zSk67~f^y+S7naK|xuo37V#gA;t&U+}cXfRR7cL$6#RIsE_6?z(CH?9*zFofb`2$&? z>@J6X{ou0aUhgco-f??5{fx8A6_;NL{T7wkvuASu!kf$UDYG41TX(5*^0zJ=aUXc_ z!E)n`w?LC+WzA=;5&S*=A=dm1X3Ob3bz(atgjeCp`m)pk^|7q)fk8G2g(d&JVLHD)A! zZ4Z?ODqN7c>I9O(MN0}@l&`+~ADYsvV%2KgWM{$o?@dZk)0(M~my%eSA3MQdztu;G}wOky@fUPBgf>AF6 zu!`Ahue+sOeDNjl&;1O@3uBeC-n#3SZLs26XU&-iD^9+!u&2%Ta2DTHSKm+${npo^ zVSjnuYj&aNpZ}r?Q%a+gGoTH=^%-srzpw4Bq zS6_W|`Oj~CtvvG3-R157^p3K}9=oQ!-2cGba{5_U(l^}zr$AW0L*C1H9 zZ7S`TdZbc^lxJj29eW(Xgz;Lb*BvSx^&cg~gh}Ho&)Hegu9u;;g9WJDuu$sGwxRN( zRd&i>F4QPQyQtTh?WI*gQIAn+1ZHuQFxw_$+35M!&48;-ixVlw*E(O8MPM$ChoL_x!Tg zUVE_pmK{gb>9~oUM+x3nTzzA?=;BLreAfLB+)I9J>6|pRY`g7t>_FI|thvTy>W#^! zMn0Aeo*99l8s()zB?WcC#|16h$r5%ljNu$f+oK9hm7UoMP+30;OocoZEKVHURiThB zt}9n^^pC+|<{);#OjI}-)Wop(LRJs{J{DC)Sy$DKVYR@UEOeJ(zn%Xz@xD$m(`6 z^42n&Baw9We?w!$6X9O-2pM3`D9eead=e$40gx;Gz5X&WPI{?CllK0FuVEy^qjYaC z3Z|az^8!I7ypuOzTi?MAKDS+&-bqEONrkWNgeE3D^RmoY&;nG>3{A{o_=p#YjT2aY z>jnN!F4}j`Bh|_Cy80mB^wD<9HGQSWP=9W?%9-k10AtcZ`Nd7w;_0eE?Yr?L`VbuH zT;uEKcwl;IqoO|X@YgSn_bf6{Ufa5TLukUcaYG9t+KybPF_nr=U8Pqon{+eZK|YtR zxZpro^5t82!~KK29(W7Se1tQYpbevcvp_L>{!;fKu`89l$^bHK(b>d+9z@mQ_htLZc)t@JH zXU({J7V?+$O&FQ9eX}_DCyj+9-{?Z026QmA@Qr`-3JejZ z45YQZ8oU_h?k|_?YrjAoJOj`4&0l>>a>3U6<=LP<3=fkx^=w4p`$$H45qw~3s9je@bu3ZZ#X!q7_mUMQC%ztN$(<@R*lL#%Am?F^0c(}Up)g%Sd@{!&_&?5 z=8^X&`U#Ft6!8DiZ^q0SQN%fS%lv@xb{vb(<59-Ud30Vm^1qHQr=0PJ@^W^Gzi^wa z*oEpD*8HQqPc*(5W)=9S>)}`w<5|~B5R#-s>MzfxUK&3hHGJ5&el1;G*hxPRaOX&i zf#*E06D8&2UCSF1UEWEa)U*85&U>97w(Tky%LgqW@~C`E8q@1fxXw7jcahC!;1K3N z=XWkrR9EBsZoIa1zE!Ro21ovZPU2h3OIq>aTN%hdk?2P`wz%0z0R}*V$8c#UT7`=T z@ysr88Wetc^fBeEGyhP=PMKEvkd=4ixY3V%bl;Rqd}^M;QJE~n_zsr6;y)D67_Iy4 z{{L1^J@wRb>#es@&z;OIzEgJEX=mnVt0#RMufnZg<~Inl?b~?T&dl4~qfclP=P6=_ zJbj!zvL+V)mtAokMobgH4(nbW6L``iV{*5O*bwdlK`)B&o`MB8ig52G zTg-E*2dC2!j^)x;H`gIC@zYUm{_}(7zT4)+Vth39(S<_Z%U_k}wNw`$EzyO$@KKby zE+pVLdxL3Z%k9=dac?_wo}|2|A{ncH6#7v%)1P`|k!4xw+=#x|V~)go%;=sniCsQp zQ0Ti`sIRfcr%n*8*vX}50!RE%PmB5&(9)~LyKua8SDxwNy?69P@ZtC#l=Le{ zQ1%h?p=~|#asoRXs00>tx>$hXi6Y&_C;MWL5L>~*jeUq?p~ob3(^q?kf^&Xp0r^RK#jqIIi`&19h1($LE3V3(XpI#(kbQKGtOghJF2|wrQ4?r zk8&x_Ip?2;(qccOE+-y;3>O#o(mAdwhaK_#a_=p7miunGqa6FYlgMvG zIqMg;i|brm2#|)!QS#_oMQ~gFav0_ujoJKHWKGF%Rov?t%s7v+UeB z_BY3{MT`!dL2>Mu-m=+d8`ln-4p-s4Rnk<%nz{l>$Qf8d6s|Iqi#~4q8%;+@pNRD& z!hwY_rp)v|xF-@ysz{c^;gkCF#IORsVc0=fW+|>bA?Y9vu>ht$=x-Ex-mPjIY`A{8 z`l{=qq!)(g&Pgkeit!wASE;j2jGZVOZL$fAI}eo49{6=EmY!es-eb3%IVX(51z}}lH6G?|KpA2kAJ!hOZc(W@j?`*uPJYO^Xtn)kI1*SCzU}ehS-*eGRVB5 z?16t4EkIDB9?e6gkY_qho;-#!&nX9e`M`3*3CCjb&KZFbXh0x&b9Bt4DQxB5zI^82 zKU3CTi^Y-!3XdJ-@FTucPWa8y2qj(R&sSfE_3*~!(C>Vw9CP%q5nkvYI09xSio~Oi z{6X1>-56gvY;r$-qBj<{IVTLk=mgdF{*DvA_{8Sae@_$%W;N zlTXa{%6X5>rTyPqe*T+ZmBYS$7-gd`LIBia`(q#aaM^3`w=-$DzkKF%pDm}Ic2a~z z1+WwVI&8h|i^}&7`yq<>X$aK_Kvzde%)$BE_gt1d4O-G4t-#5uw&h}f@M zkKOcDTW;}OCODreFWLTuv`wu1QP`i#rOPKC_nRpD#&?Y^@A&7pQ0~La5l0+Z<}fL; zeMPvU`ex0XT|R%nL1o7`zZ%PRgu=)i1kji!p?voY{gY0)pqzZt2`u>C%<%-vne2|I zu04XMDr@BvEsv85ycBS>Omsm;3u%unQP_#%bQ%2+f*X2XG^Z;1`Gc93dWI!1lzBR^ z)b9p{mhs1*aCZ69e;iP5zw;IrXvUX^@4B!2%RAp&p0nkqSZz?xY$ZMV*FPNW zyHg^tf9Xq~&fNvV6)P=L7tZVBewYKwZP#B{PCDk8G7ceeuf5&@KNfbSJVc*$U^(UY zC#OFf0nT_Qoo&N~-9u;0E}#D7zn8bX`88z`*59@jl`d&d$c8p{1u@%#y8)z0?odDg zw4ajKZF5m}f=``XAmmX_r8XA}?4ymhgnCqoY`gGCF1LG*A3v&0;}UHxc2=^5wu`#I z_n!NhJg~S#e=i>9DIU7P{)l(|wF=QC4$p)S`!?+F?WCb?ePb5YufF;wELz<8#l>#& zIJ6wekCV)mqp@b9|8jx)hFk9{AN}MP%Wk{8vF!NzS3{$^3&(P`WoyeJ{F(=}hi|oN z%GtZ*p}#-M2`)xiFV=}Jq@r4CeW?g%5(l3y(|VnH8Nd>V;X5=};J438e??o#S=qo< zP;c8o3)`*p=4n3Ox8mGZtABR^xtMAlnzs`bpS8xI131NMmjxu_XrbFy^>Xs;=mBp* z6Bf%t;;Yxw`LI+zEwfMNqrpGpfF4O~zQU1@;BEV1GG-ozP8IhcO=iZ|nN}MC@$@hBQ(0+$-QcA^ z(DQBmfLid=*FH|1Y8-uxDf|#4nOaAVO_e{uF93u={=uv9Bb`|pPdfN+9ARhSB6ye| z$T$6k;o{K7^XVVIDI-)2e&*BqCp2-$%V!M;&f+S5U{L!k!_1#N+c0?}%H5%)wVcGW z-0e8*GjbG973$JFeHVP5?1}G@cz#$$voeo_8X-ZIM-0kHtYs{cMR8z117F)u z$g|bDUpN7oaYVf80wZ!VjZVcW{U+7OwPlbe5@{9S1Y<6h? zOP4W9f8y%z;(%lE$Q%=Bd#=U+mN7L5z5)*YeI^qj8RLmvXl9W3JbAPyPW)H-)_R^j zb7qc|QGT>tC|7r51-lISPGg2~6MJ*_%uj!QY&q+^3(K}!Kd-!WyKPardFHfbs(d~? zYf*2@s>N}5gWlR>?DV%-m2W7b{KmI_Ej$@F--LvYrXikVTH-@zGp2Qt%2#U4#xTqc z(vftPr_DuNhvE$?>q#p=1aJE*`4;!^Ty}P&1oRlA;HIYq#u=aAygN7R&tgPpjD*J!>;|Z5cmR~2_7JmD5j5JO^R@?GQ`e#(F!;id8 z;vr6{pa0jt(iwU^kK>llJ^wQ9>EnERWKR1VEt-4AbJ;Ezmo8k`he6Jm@~jDKl}8_a zq#SV2p=J9Qzo6{C%Z?oF;{0=nF2jptEmo>Qcj%&0JxAV*^s-<2Ao@q^%X8eVL#C$j z^DK8S_$5h{wi#ELLo7itt5HPHXbc)zL>P@SbP4lQ?*{OGEf?$VxpRIw^7Fqdi>{xO zBV53&_KU>RWk+~k_z^ksh@3+_cSEl_=w;;vuiBVCgCk(zJ$DaCCNIOS$Gf86LFetl zfEMD`JyX&cCdtbh`*?3!&ge(6>-e<@SUt%0(sTq9Aq^XsfzO1VaTz;QoKM6U)uV0Z zp-bsowm6G$-bJvIvWck5V}7ZRzR03u+4bE|U*}Hz(c?Wrxbmp;OUDu0{X_RJ;x5fA z%EE^R%0?T{D%)+hDZIIaV`&ChG)2Ay-vKSzHRfQ9P#>XHy=ButNAl!yU~rC=KV@~^ z(#v`K<0p(Qa~~NfSDbrYx%n#eSr~II#>zd5M$DtfP3kEdZM|N3;SO7rwboq?#r!S`O4HD z9kv)HxjW+eSs>|TKJBh7mFT%^f`yzp^X8R>#Pf1rd1Qb&o5nNa*}*cFxz$ov0;nVB ze~Y=0SpHuO437jF&+$@Ln7gy2qYDEHWtqdNfv4WxIbxmnVEE_x{!1}@>!Q3%h`(?? zyJ(<|;U3L2hPxmaVdpt>t$@-Flme4goAJ|6 zIX<2;KJ1+VRps1mciw?wP;1Nuz7S7+a$uq4L9CcuDSB+C?7nZ{(~R#}n3MVFQbP!RSq$V%rfMw)K7e=Y7V|Am0E`>wl|7rk)nl>XM+Z$~-& zFtl=gb3~anYi2H2T64{HxJah2oOJ9-tY~^B*`o4=gAOVuzVLXIaje8UdeO0UGZ@`? z+im5yC!UzR#0_zHEziO*3plaOE0|)zbUD|)*3=SupaAwp4J(Ie>yup9lR1o#oMvBf^CgM&-z4; z#Ni2<1=k9FPZV{K5o^>ZkJ~WpAS~nKC%@|KnB(Bb$2bNa-OFCOUAf`HGjUg{Oh~kS+?2w`879bM0O6K zt`d8ep9Ae`(^hA|@sfnt@_a*Hx8kiN+~ZfI zsW3;QggN8fGZ~Z?mPwPRQ}Pd@pWa@`GAl>hq4ugZGsuaU{a zGK82O&Ja}DI}+SJiIx7v7o1xrPoF}0C~w;51La^A$h5>h`IRN*I`b@c2HaeaMPiXh!J^BZIneTwi_T#?@%PI?2mKq$PqsDoqQpP-va-*6 z-p*FfZt{axY#;2!TFrK*K+w;5kDUl+m;LFI^1glcED;PD7I+;|5UU|&{F{ryShybI2ueUHSVWl|<}Z{F#x<)a__aFit8TjGR%?%apV z6zD#W-5VZN7R8I>4vG(%OiK_Klf-B8jA;mTi`Y$aEpSKVIJv#yugfmIpiHC>QeacS za?+tNDbIR@&jSzKUOxS)kCYd0vo+TEQ^<#kYudIJ`&v5NUL9vtpm?@_Q|#bxdugpS z75ro(VW*t|M`2%!k@22tVMrIpOI?c2kNsLos)yu| zEbz1SD2b$d8#kA5;wN9&j~S+N%%{4F5llE#II1x9?036-6&m*ED)W*B@BDB2KKnx^ zSio=r-S`ac!4sWE;#D5Ae{K3=krGF7C;kZe0}pW)|I~e3KAy(a30tMN$&Ck^c@Iwh z2$MK2&WfMW#KE%a(EI2 z1_$AIw?WEmxf-X^zm~C<$8@G?>%$C%-Imqz)G`U6)>nAWe8@vsrt#sAu(F_InP_u5 zaS-QLX&l_}_j?ckiCens-G(F&f#Bq6U7Jk$>y>s+MDeOt-$tsm6lVNEr=^!L%)3=& zN&oyoU-Q#iQJ(fa-4jpgZ>92@I>C@fYVDc?g~KPx+*Qz;LxbfJ8i<4?~QnGg{^AnqFB&xcU$7 zw1l^;e;24Lz9u3L-|1fnZ@`DI{SapG@daSEOUE(s2~Wh^OlrQ?wb= zZ-em$!yo_B#IJ}wJ}_kz|0yU}rZVq%1Y?aU?ELKR^{y(EZOaw~Zw*)`U|=u_`A#MG z&wlmWasj&mci!>!W%FlmnsSMYuH}LHkzeMASa3=&#&9i#jpNvse+J-&N+pc?J-mD^ zTxByAZ44n)6g*M|hT7*a=M?5}T!dRO8^Uew+_~jX?95(!?X}7}>#W_xuY8@%Nn?Iz zo_S7r-@YGaXZt$kn}>V_*?GOd5}rKij`ibDJh_~9##!u)znvpm=SA_f_L^&ycfS3f z%gbM}L*TeuaummV{Pu+3VNCHAL;0rh z)63YQzRkAVCZB!;-(!ArT=Do_7iLtp-Fx?4={HBB*!$Tpeo=0^?G|Lf1=-O)WA&LB zw!Dq`>#Wd4Ql0vTKQO<(in%Wran74l_IUgIDgW%+E+jaGYUKmrpMSym<%~a^g>lZU z$lXgYsOc_iJ!_5f`q#a>Z2!`i!{0)!uC1H5u*3a(hkuXVm$y^bUFCPbJF)EhfqyOI zd&dseLEA=5*{1WEu@b+P3}orEX`{+HgSwHLRr5Poqp7a8z8@3i@AzT*L3bT5LU(dGf3Mi?#pO+JdMyh_b^a#L4mx04 zFYa=2u`5-@{I92DY>staF>-lXVZTUq*bn7MGLEcK=5<`Peb8&uS1Es?$OT>(M{$nn zU4U6ZW~)zu_g5}q zUbB$-e>YbD_#^mDB#$0wGQdvpWhk-LS2<{Oa?$WR-0MhPD|$OO_9me(JN2KF2wP+>o6ir1x%x(aT*Nw5}Qd7;l|7FX&&C zvD;&o%xC4YPUhX*b77rXW^hA2!0r(YGT9xVah>Tk4(ngW!T~h!NGumQysyopTjg8h zEaT1r?@;jQr+VCw41Uagj47a2%C}#{Da}@EQJ;aWrO?-yKtP z9FX1&;Ocdh6%Fg89q=FhTn{=&T)2tVWgItn~PvA>R9PZ+!H*tM#ICDU0t$Z2tr z_Ro)lpTck}q${}U90ash(BDqh^bVX=AXhjYQT}}0pRvGWo6{t%$H$g+*Ihesla2;a zCz-+mhO;bjFoyXhobG{l2lw;NJrCs=tNAF}-SWN$76S(zcwl+ScH2aWE>3O_ay#38 z@86Hc-;JdRp1q zA$0e0sR@nv9lO1i6~rawxZj>o%LuOLU3gIz04%>}(ybtT<%;fd_Z@cx$9_7vky=C0 z;kfEMa>O`x4V;uMNh;OJo%I?07%De5xBN`!Pezr zjxc%8yY?<`fBWtnTQn;;NT&l4tPc9}SJ=)pu3UTdpL6WUW*cu(x)JVHA`EuY>EC?A zO(@8qDRng&p?T}AURZ8Hxp@PN6uqpj&tZ4LkAM1$vgLC&Pp9`NO8#Bmx*L}>-CCy4 zUW08}3%I;;o3i<)&*qqwf%1p5&(1vrDiyUV{%;oiR%0C8MH&2;2^#~nasBJ$GRFv8 z@LE<(n-tcy4wB}_I2phZV%(LYf~i_&q0pv0DrB^DQOV@sR<{^dMU8^mBI;717!Jz- zpt8{T;VC<6_{9Yeo%J}E`zlICiltK%iBTH)ae;PBzW!Co(;v^3lW*lS+nrnd zqBu`8tCLG%YdNNKAgM<__*A(oU5#wptCK~`C+)mUQL8hN($9%%JukN^#V)=0BHEdk zc`o57saa)7Z@bLy|}#SB|DTi?zj_^xoPF$M;f1a^W}&i9FCyrc6+v5 zLWh;3*}};=idVDv*2zHYw#6P6*4$z|o^+R7`lkr36Q`_}i9ioR)~jB*1MxX7=l;7; zbWdX9a&tMwZLNFnmb2MAX!qeI1V(qWxHDt?gvnS0^kHeju}icccN2M!$j^WNb9iB7 znLKR<=hF|A7d&qpXwg|Nz3h?*1l?mN&<4)HYUV?+PGK$uo>*3}Z4z;?thd(s<#n%r zUD=97wO$241h`YrI<@@#7e6i&CvwEl`~~IY-=EBpU|T{#971^}8PwNRS6vIA%tiS> zojP4sHrZgKGGq3$P6L+`J zrr!t7?Afyc2ahWtA?(Sc=Bc%n3$iPKL*qip&yEzb{_&5Gq8=_}QPu^>4laCqPI>+d zUYJX`yQzb#uf4MT^rt^0-O^a6EaWW6sjE$i0BCwABlQRvia}$s{9WD&0MEAyOf5cr zH=gJFJE!nMGUt~b8Dx9N&L_ghu-MSSft0n}`qCE> zhXqe~F>=MQGD!yoc4`ayLHy*92mVl#{#KmY`m_Iy)xLca>jn04QJR92i#X|;Nv>b& z1G%Nn6`kC<(17d%JnsoeeA7F5z|Vd!nAnFx(r)=d9tADqw1R%}Bb{;d*GRy-E#x=4 z4*E4}4G@Og{@l{;Gw*m?y}FjxvPE0I+Hci%Y1_~lUi)arN8Tk9K%BIwc$Y(L$I>HW z6>&l{p5o9tKsCHtI?L0x)5^oPZ2_Nl1{27$&Mj}I|9io< zn-RCdAA(zRwj9oR%*%AbN;&wB#hy4)9>d$RNTbBzX?z{UO}WIwJfvCt2(zA~opO{8 zN&ydiNh8llhuZ$YBjJ{}_L1gkxbZBz>0AgE-XJXm(ct1UI5d7H5AFeE-qNcUvb6vg z7EL8MN51AGd>q^=uEr5=Z6kJt6~B6EdaWb#vfhQIlLqpmWs@(QxJvI<)&^Bzs{C}J zZh86KXAcUEKJwvxP|&e!i8hyVO8EvxeKloumN$eL{>{6nr%s!4x8*VK+D>Z%`%+=H z?OAY^$+j)*&^Vq$b!eEhXwXV|j2pPtPb##QGkg$OZQo$Nyc178sq#|gFGKXV@A6qQ zu>V(1l%CSvSP2O|twZyWPKH}tzZJu5H}Ol|O6#`lHE-*rts|8))>HZ$GvGbDI(SWg zWm^4{fq3iR=2!j2c(BeWT>3xSmgTHR)>VAONfOxr(%+C*?bB;z)nCGgxwZ|NP+AN* zKZMH@V2LNaLqCJ$c#C7W|10zs-s7La%SvzR(7E468*ohP$$wy+sP`Z(;+*lxD$JM% zxBy@oMs=*nZrM#Y*{Ixi?*rxQ-~0i_Ok0#UFvdJ<_AKC8xAgJg792zyHwxyj@=ymd z)S|)qR|X&MhU59z^4GFi|Jgkcbd5wTzimqwg>;i&^%?rD)ZiPSih~%^~ zdyU!UC&)N2+V%y_*eDZ0U!uyJ-}uhqBIJHG7qfe(}~eBtwq4YizqxZwP9IkM#l=8M1l)o;q~yYF6( zIP%EyhVBA}+2E-zt<1^K zBQ-An)8*wd<`&@t7;yy#Fbn1^C_CL;o<8!8uyU@ z_zLp=#B$^H*Ox#2@rv^Dm%W5~QqHSmzmVEG8D8hYaj`*pBz*@==g!wBcTGEK>MZf( zYrdPu6DCdGL`dGm2tGAg6TiXG3aya?uSRS^CZPSu4iV?{r=D>xJJx%V;kyzxun6mL z#{$qh-u70GRNZnAW__vhtQbiX>q0rB1M}=v z$XwVf)p3WOD~2@e-nLxJsB6bLdDW-Z*(;H~y1U25BE7qZU7PTm#!}U=j`;!?fsa5| z()8PO8WACBqT4}k|9|YgcYxkivG6~so6Tm^NJ1dABm@Y(gMc&@rS}e^BBChv-W5ge z#R3Y5fGEfXL_j*yOX!4>1V{)Wz4uMB$?hh*`+h!io^Oc0_x-*1{_guH2R6_1e7~p6 znKNh3%$zxM2uWkS79ED{jTh~@$>C-~8e93U?l^cv-`H)x(dlTXV-Y2Co@z@_X7AFC zKWJ3lM4LfRHng0}t1oDqR32j8( za58Ko#8D6CLkHzoayp+$9o-rlqXYSR@%-l4cq?sUoE!iqJ<&Cadm3DRq~Y5&$52DU z-W{8iFdLr86T7|Z`=S5$jNkwC)|mLvn>faZTs9oAn{)zyPU@sPcoF>3OLW_ou8Z3* zxgUdikNDsbJEGGrWg`~DIb*SMd0Q-)P3%?dZxZQ>g=`2x6x}K7X<;u4?@j0*Kuevm zj?E3n!IKMa3OFx~rr^ekC%)8FyTilkDd)JjzNPV>K{w2A2OBJI60O6@&;ID>+s3%p zLGN8@&&>q!p^@ECzw-WW4c`4g2qEz2Jp>AX>MVvg*6FPk9n~;G%2oc?N;}H_y`c?V zaT^$CPmXK*P!4yImfs7n%dGUP4Pgy;I%peEAD4!D4xlv7qK-w%aJ4nL;>Q$yKm8Xm z04sPu{f{wFTQgD+^gDlPScMVhtJ?b%p7J#hYR_z2#YD!OsrH$_{m#6YI(2Gc=KSu9 z2kwB4Y8TS-+eJa)UEX4{oL_52*FVdN#6Vu`7+Z}%$fJT( z^7wQTAAii@v3TkC<4br-sF6JN^z-2cfIGA9?xuGa;B|+gtmabPQ6ophu}2?I_=>w? z?t(=yfI1c{n5Tw;&UJ(c`Xz?Y_nLtcwzjM zdlNo$!KYy0a5>ULk3AM=oOLb>7{6g;?mXuhI&daGsxe(ZzC7f;JFDqA%Xfuxlk~P> zs_0avyf^HFCz8B2QDG9DK6SyNhk?IuF%W#_g_kL}@|!yKf^KH9Gj_Vi zLp89D9=!u`y*a64Xden|1m%1~;@ttJdz9r5Bf8%mJ#mG2$8p&)ZgTi^O|+;a1uGS=YZc=3;U>iIbG$b+&%RUJu3 zf!mWReeu@6_-7a6A+a%zAQtqxh z$6t8)<@n^MP8CRmC^rBApT4&%48SKm%DdmbABg?;KbTF!`(x6iw=&MWmyp}Rbr`w7 z{Kn7bJn8l_e%K3Ku(XisiD$y<{4+O@iI8^b^kve zj7u-QBrn}^%rtbFiqV@fg&d(#;woba*OW4B%7)|+qVl)`t8K4z8CgdewBZn zGx89V?a41pu8Tgm-dy*p_e$RsEpTWguPNM$ue{0)4*01XrgKl9=- zzF3c8z!E3?PQ#?n>>q8KRHmc{d6VN^P7Uy$JUM?D`vjrJA9J&fx|~n{!ID z273ZxowVaRmAIlA`;h&xC4LJxWWx7?m-p5_TjY89$o|`|w4Ki^$2;e3Ri7_vZ)@#U zrO9a7WIp18lDsM#8T{s__4r))#kH_i^;WQFgX`hh;C;eXe%oTs6TVn)!GEdGM(tnH z8Sh2AeJFFFR5>hpuWqeCNg{h+dG{9O14}GrjKg(L4F9|m-K&n3A6x_?K(Z3*X zdrY7HZrpn7pHud*-{!TB%$b$c@MKBe<$F8C7vVR(m%n_sAL2D>)p9kwh*O`NUqv|K zcW&37XWcazt+!<6UtiRI=7-hWe(lp|N)U-ZA2Rpk_qLPcm~**?2cDOCQ_56j{ghW$ zyfQPRJLvf)X24$S|QoZJ7S^j>`$9>dZO0(Y*hDd&P$iIS?IcNUnoS_6qFWoYv9JO=>;d)nSwmat)$hu_GiE zy;Yyh0wc;AoQdh2XcL)i)(e4cym#pq#tbmDs-bm$Q=0=-muMSZ`*l4O@8vu@8wYI!RbydAJ(6b%Z1?VKl8~9Ql<@tY>#DQ&=KXM3$X+7K(Wo`J$+~a5A z*;Rp3%nC|BYgJfx?Ui#sQ>|?E!uRSAl!)CJr&q_lnX&2hB6q$AUeO3`*`KA0mSYI* z84bjB2XsOWuVkJzGFBrApSp|ee~xjP2f zb_}W=$fP|7*T;8$`Gpv=WnDV@$ZUJi5B27rI9#rE0}Mwp^?RKHSFK*227XVy0KHfkW;Ok+CwN|-OY002M$Nkl&p|MqvBhj+01F<`|7ecRb(a zLA`-(P2No)-5F+!Q{b#)t^r+`hh4D`IO#gIQ9(HE%(I@HHt@pWJb(_o>XBZutdmWh z^|6uSywg6Woyt1^97j*@bnn^_m;L1CnD`*4tdY?(+%2c^2ko{+jNEYxY<6reAlENh zusq%!KQmTNUq<7M8*MCIyfQZu+)Qxs$`E&qg`1in734vM&|G&6=H0sXg2%Yl(>8tf zqGac}Yl~?1(p^th7zM%m5wzF1zS5m&V60rrn%xMYJ~y4#!oOSDBymP$znlkjN*&K| zo^-di!DanYW1y2Xr*o$In+_f7!QCk{fCwHCapM_$NzL;v$N@c7$t5GT&{^)LAL ze)|8$0JG-(^#2M2x#+@7TvQ}jJsu@T|4CsMLM;nUS&&?)orEp`)qAs73t%p06rMYG zF7pb;PMtopoyuF<`dl2GFqJ2elhjF|aOPi5P?*;3crT29V^W5WXh(p$>hj;E@!xu7 znleXcQo;o@I%xj`^70Tps;9jBE^*ddbCPB_9{SdkqeLwTA-nIkTm13b>o`(592T(- zFM=!Z+~k-KjC1Akg>l}e&x#a6VTx~wATnH;>7A;yFGv~|!uk&LzxV`g^+kur^>0x>b{j2d{HYqfS zTk)~7X*mMVhw!xi1AQ|Vczf)!^9~&8{2-nlH)DwH!wG|hgc52^uj{}4{l3_E(_yiY z`oHsyuM-mK(+P*3>K+Lkit*YL4Z?1!j5K~P0zwg>eP0PfNe}!^n1GdSXfiv_z^U}J zLD{+U7sd5|xg}o18`^Ogh!L}{ci&tLQ)p-X(=hMOYPL;Z+d2AW{5l5qq`MZ58GA~>n2X&p;NEuU-FZP~UyScAcp8DLg{{nif=iE; zX>fNF!wnAw3YB-J5#!C#NiH_B&q;qZT&ldLF_-?k5K04H{;NW083m872rW%4hRdN1 zcji~q&taQxp5vi+mE&A_+v)M|g~9eu?+}e7j-zd6tXc5W%+t6KK+KxEGH(3yjfD4^lX!AoH}>fpmos1Y-fMeKWvt_J-a}&KR$Ioj=~Kaf zub4b(5{ibG{UGFkJC|6IrGTS?a?y`|&PLYBX+U<|Uw`dY!ge))F9b#|$^PtlpO3G8 z>AYA*9sQ}}z=IFrE`jHnFZC!As|n+^Aa>Y!B=-)KG5_W_&qIJLqbEPB1NZ((-@Oq8 zMs72T5J0b_BI0J9GzGDORt8XB>QFKkEo@4jf8OWfCqMWGI|z!S}wEA%Q-2*#0qhmX}r$2T}SVfA5+wTYxC*0pd`Ozh3;( zS;bSNdE<9V!2&*G>eQGx@m)5qwx+KLpJeD{Tu(mnC^nQ1&rK&!vuGeGYfz0JQC?$> z1{@744udqUfM#4sg|QCar-6_$ar4ZWq%BCJxuFUjdmgwB;ZJX>-27t<)4QCyOb)4W zhUIYz>nY@ds}<0V{c+7RO+z_j^Puc{0$*oqWa5BV6vlb9e z;bK}Ou6?HBqnA|HL^;PW?=0Yv@1%E|v(8$x7Rz>h@0gj)XA;l3zR;FQ7{spzazC9P zJ~|;zOi&HKfss7X~?| z;HsYanFvjI3;by~2Cyve7?7osO{7ELi)WK+ZCa;w`P?-|9--HZMPz7L{{p^kPEcI79SB(AAabu`1@V=;x$@uVL8`T zlQ^)x_H~4$1ov0`_SZ3(jf>HvwuxsJ6vwg`UwApDOqmwjZ@YD_i-Ihjt-yI;IVT8{ zp3s3mc)-D&f**?P-4dVq>=$C%ly`a8JqEMk@$YOR9C_5C&~AG?@%Yp6jqiRp7R;YV z|2Rc?%dK(d*=MHSEGz(*^KRzsSvaXope-*E?HQ-Cp>WUv`^62n-iDLT(}W~J?nS@6 z6^FC~_WwX!_N!mUUvK5kE@U`2B3{5T&U=B@ve9uWm-(J`&NgNi~q;ZQe|X6^EYMbYfG!Q?GTCK!-Fv@B6ah*3h_J+;Q(e(ujM?Nyp_FSxQ+@ zdy#MO;wg9*%mikOL6H28!m)DAi zbqub~UEP3NomidSIQmFmHl2%vGI4LNDd^o79-uA3o}h@W!6~Ped&{&7cyFAJoZ@FK zhJJaM!dOonRP_2*ch{LpFK)v@_Qt_4FV)2x-L=va#okBU4e$Jpwchi_i2(F1?*dqj z9N%96b3ly0Lom2&BiyA9L-K$5RAAh9kBSqP- z9X;O=LOLl)cRDx93)HK76Pj9`-iv+v5wHJ=`^U$`hnX9M!uIZ)?%WM{(uK#y0Y~l# zpTxkH68N9=XLF5q%CV+{_~8No*U# zdmFLx>Hj)peD9^`$*FQfDXW`Fcg@&Stt-Ki7CPYQfw1f4&z|Mz z3VmyDSR;_#gKw&nDFdWqD6l0zV4#wQ31cUH zTw$x~84q^4dJGa-Y>2QRsCsb)X-{n@msa zl^7>ZJ@I%#m5k1|tt(TlTy6yTfZw(&(`!b+({r&80*nin#vc3Ghq!mY`1#Lc+iiwt z6~`ZUTwH(SO*vWX$ft08)X_&}zw|nHCwj}_Tf#t?=osAX^j22!oHW zf8}dw{I}x6*+JiOi!EXSp?>;d#L)|K2V!^&gA74odH20`k4GMVoJFTT>zy`jT5bRo zrHx~dyu0rD8#r3|S}ep^zm{_AGIk{w!w?q5{)#IX?@TaK4LcfW>R8ym`OR;n@n7!~ zlb6BlgixGbq2yIq@Oa!k_utR1>N*TnO&MqM!Y^Ks`TeId@+k17@KK`$8KS9-cz(^k zF_1ZwD(cb&Ao9m2-;+*!K%Qz0HC8Ppl*rF6y)5R!Ei-A3g+k|DX1uXG$Y`y zMoH`W1)e%{?(mznI0sx| zwHKGbzVZ4S@dkGs)Ppm_oE&}B@v+6`eeoz^N1cVx-gPBZQ8R+dpur8X&t7}uAvFmh ztQRrlCm|qn#Ey9&!AKRJ+&J&N3*xYk?i&jhw{nj{ZU5=V^<@7|B;~5~qK^!SqXkwaj~ssz)4tWPIY2r^VtW7)Kks z#IC#Uo{CHgw7}2j|ULe`$M;@Vn4#+eCf+y291QXT8bA2*lZSFc)D}G zl~{+?rx0Qi4yG6bTmZ^TZfkU-QBgrr0-|Wn0fjMUHSl(gAOG-2vFk2-d;2o+Rkb zcj;eY$?w~4vt8Ur+}e5!&|{t(6DOWM`nw%d)4QKLq{lksSSW)(#1 zQc;q$pe^diKk7@PDR{De>8=eSvCI?Z4ZI-RRpH`&dCq#mb1@~Hy_g&85NI{Vh*Q^q z{LXu-D?EcSvYu>%lE%X{E#QRA-Ney<<(2V?Pd#?YacGczY=*!=LohVVrv44Je=QiC|m|`*>LqIzjw9{^=Q1 zhhPn!H10G~xARqnNFL!aaYLD@Fv(M;KfRAsZp4Ki?ViX`XgA)ho_0M{{Fo1Q;7ESh ziL&9QXs-JxK${Q-Y2NHP@d!uFx7}vz6rwfkX96g3pwd%qE{op;w&akkvu)P^$1{)N zQp#+;aJ8aOCf>L@V!UARkfj@G_W zMEqJX^YC2d%5~K|$v1hw9#^$7p*n{r6KEibHw^@Qqa3B*%aCtv-)F!lZc3pnpa0ad z^D5i&SyjK^vwc2&FP#4QzM>85U{@$-Ama^T5vs@_$VT1O3r3ZBG0_4wQG_NCya zAS*XR_*$OvNu5@abm)&-D&tii*xW)+)(MR;<;lz(S2Od{j*z6|s$MhZ?`*-BnI-vi z&QX4vx5A;X#ktFkblQPoq#7?vCLQuwjg8OpyY0|{oY#C$UQHc|Tk=$Gx}TgtKFFJ=~5h%CcHH%4VNpB!`&!u#gHOA>Np^(}WG2 zn3X2;-YDd0jYbXqIE@Pp30HqSmD8{SoEjRPf2#=j=SHs134;d>Vbgh8{Ku_##KsuK zhk6n~av-_3iC$ydH?Lft>sQw<7~ptT(XRO_Iuk!hQe{Z|wf>#?J^5jU^2HSxrp@2b zm(2>+aAjmS-0hpXwYayk1vomH3`?=^etXBWW5yseU`$`WD8`N*%Lc$G@-mJ|84>Ti zI|T#WB4}J72oHO}zBJh-{&@YL;+Zi|W5mRh8~yT*oBztYJ+rK|a>~iaa|&Q)eCyla zgdTfvPuHB>xKSTYqawB0&t~LD;Zx7P^4GtOvp#WJKHr~Bfc+0WjE#Mqg^+&@C$t&^ z?P;f+lz;YN{*onx-`R_>E?$`1&gR5Harj3LDey~pB>Up}ulzD`(nN65hG+G_SOtNO z-hLZ_D7fcSc;*qNbJ9DLp+n>eWR8C))a@y!o{;adLjGAz*pE|AJtZEz_W>?}{!r|= z%l6q$p5UPlH=(=}&py2J>T4kGH&Qkp!s)aei>kH)qiyp)m~#|e50#bPGdJ0f z4O5O01@tr@^X%AobK;~}u+Y;P7`4?Ad1t?sv(lhXVK=jc%{=Pp>8Xt&Q+t4IrUM(a zWS)Yzz*yTaWhz5p={TTHsyZrc&Oz~N{^VP>qfP_j>Xiil-lhVxiB5 z@a)Bj1N+~JJT6Leg9rGO@4BJ#btN3I^F!Es6K1CqN6B@a@*m657;RJV4OEN?`X2CVhmemU(&GHZMhiw}^?muG#{Gc(x#6h{-$2-B zs3evXjiCd>y8Y6wq4C##dul@G9`9>$%;o9pkkfl~ts&UG4O57UDrcTV6?MYVklNOlAN#Yjw2_#mAOrwJ>i4wtgmH5(Xhsy zw3ngw;H~ZS*}KBTlRA{J$S*vTwGM|V$40(d8~~Uf;5qNZfOd0Ziec*N#tPkc!^9KJ zb>3Nsk;99F{p~Q+5Lh$tPSZ zM2JKPe93EoSDJl4{r52N9!LJ~m3u$;e}VxCQ36!}a-s0Zi&M|FE``+m;=)+Vm+xS@ zG9vz5Bo*@9MA$HGgtxeiL1y5wKaWEW#zP|w0c3Qtx)>IPvMdx-m&{cIMNf`wd6a23 zUhgvSCU#Eu*sT_mt_D-KS8G=$CExKB+= zz5Qt7+;1Px68o+m;nSm!xyTA<3SBJ1#1YgB)eb4#HX$gRG%zdJDR{#c^7y6CU8ubn z*yF5!{p%gX;3sA>9aLB~B@^d!%dNJ`vUbC`$+Kq7&i8uV|M;grkE^b@Dw%Lm3^YE~ z6K8!;#u#5h41WzU?HKnohMUsBM>pN^9XVn+8zwvDa~GRxj2c;#G!*Kc*^P^PmLcGI z!LN8;$@k;WKQAv$DMAHCgc{5l3W)D26^`9%yc@Dj7+_&!i~^aHxdDU1eI@u=mqw*b z;K4f0XY%u{N$+IHpFQ{3Cz+%>smY|1p@MUcfHi2Sc2R<^tj}X?g0|Lpc7)!sPK~_Q zr*X>70Tqrulrz6x2wqlG&u*`tOl(J_Fkt8$nSTSue+}LmYTX3Lqi6~MED$c5;!lIo zI$WcBdy)i!%pSOdyc$8O2ZD-taksbuc-FAHkGPPyRG~E%{y>B|Lt>cROi@rt!OXhp zmu;}s0sYuB1!KN5PST6GRcKS0?!}J33r{MVEH3L<@cmwP-BqfJ@yFlJV}+{rR>#A+ zt4D(EGG6@l?gLvB4n4i?YYX@m*JSknY&VTytg3oeC}<5pDR}4Ii5P!Zqyl0r{r&gb zzrYU8G}>et74w=B--t($IIKh1@pABHJy_^(3dpqIjpK}a?Y=LtfOde=b7j;vqoe)q zJ0v{va=L?4A)?3c0;e%=FkxRDyRN;VVZ5oEFh+OTg4l})d*aUi8s1{W@a^~xJhVw~ zW0PT<3wQH-LDgdcw6K$${Sd<4p>E{K`4vd_3jE(+J(ufHxCD8iIx4 zz=XZNzA?utjhoPjg8u8TzsANQhBxR?gZIg&oCXdW*qlIclTXoZ(gtH~U-FN}%SC3i z2?EoIK!;oL^4AbSwcxUpYr*K8UX99zO88kvfpz!Y_QI&Y6DNo43}q;1zogwW&pI~t z+LI7yKlvW>r!K}%d^0A#^%niw2m^IXpGR`RS*e z9#0U{^!0HsLi-%aWy5aFbI-)%k3W|4w4Nj7Bevc;PCntRIOX(Hphq@KR>|L(<0v)q zIxBMQor@`K(>{Bt(0lQo5wCjpD-d?T6U-~E`dp#jdjQf~h3CD!KY&fP;yqsa5167O z|NO_frD0j`8okM<&0E4z{L6R_y`qGA_l&12R9e@ccwo-S2bQy5y4l=-qNbOP3P(}+ z%0{}zTKPeGr|{`mJLZVH*=`zHK&pmxH=4PkBKc`o)+;?@MIrO_0s1r0O!1!1VMrWUUp4*}%oQEjPOd=|6<@An zWdEmBl}$9}%Yvg^%c#7z75l!{$HY4irGYXIrSHOPUU`I>9S@2m zp7NcqeO4Pczh{!}YIXZ8>o*_I3%!+fI)7&wYc*eK*F1hV6+Dr@R$hWm`4c<~Q*NkH z+%ncz{(R$iE78jq&qQ;B7{@>5LjcS*8``mT%bBWnHvC=S_if3ObVB=9FZdSCXEnH4 zeoIcX`<=EDvjya&6X&PnB%*3qV?H}43%(NXluB8`IHd%6w;FAlZI%w8V5UMn`u~Kov=OopLpj}_?&a*v$xqd zKBZ&j(%g8-I*`}kA;vE@72L|NYV(CQ#i{k$7r&dFzdh>UJ@73=78)^AY1a);`I4TD zuC2&tQczdf`x|XNMG3$$KocZMQ%D@Poz*N@3YCY^gMyJ|zV34ot zMeQj$L(D0EyG|MV*^LZ;ix^MJt-=Fe!`d9=w71@#k{bYkmZ=Yh@*EfQ0+R+i(OIZN z+!b8cvfKT{chVYV%6kiUnP z7%SHJpM3vEoKoLwJ#1Bf)`G7b7$A3pUYXXE{o#fEaD5l%fB(fLarP%q_a#3&2+cDB z$CAC`p1bbB>$*RuP-n48v>+YS)P2;Emn>M6`f&D}x^&*KZt0*r6Mu{=^(l)@n>L*X z>MmfCKKJK7F5639k;rDekyn&`c?^AUr_(AnMT@9 zS|X!s5y-=NXy=sKb+Bu~Daey5xdD*tI%Bm#vV4v&da8Nf_rv z@e#kt%y{RKvDZBzq(fv2eQs#P$luX3 zPiyw+*E<@!;V?s8&Q-(YxEAPvEx%LWUbJ9NZdMFLhcUSkC~dfby7sXT&CPWQ(EGk z{Z5*(J%_NHp?ztOG8$-wJwtfHGx7vI^w&UmRl{Q$zNW36IPbulj)TxKXi2%x`LT9Q zx0vwi+!)k%U~D~dSaj)y4i7D_#uL34dV=$}TbEujW6Gjf!O4nN^w&){8xn(XcG!4G z|L6_RT}dcJ?F-(C=ADzTygn^faoO+4ksA>jv4KsvwiwX3aXOBzT(Kr`-i-@sd-uh2 zAHBPkwYk1KV~lxa@{DDimc|Ke82Y0o9`MmgU%O!2XeO%Y{Ap~?BHQ<5GqIr`JQy$h zHtZbfTnU<1r5>;Gnhi!yFUXHk;G<;)@%ra2W%CgJfz4#t{v+eikM7EyZ8He510O>V zbPjm0fDR$j$eM+73IBx?=xR1QS1wJb)!yjNz1oXY(u(Ea6Qx9wQWr} z7UGzMF6qGaBb00%dQvNWXl-Ld0$IBr{?VON4Q^yh7oHZ7zSeN!2uV6=*pmW=C-M?x z@9=9`#^xH)65M3*4uQVVXGixo@UevMKvS?2Wi0V0PPOmJFUtH@cPJ-JR090Zd6%03 z&L?oET|zxT`5^lF<-<;F63>7lp|6GrOn&`Iv_xoS|Cm4{I!c>ZaQ3OQE zZ$knsWFI zF-a7FipMrg6VFjSI2-U(@CchiOHP#9dhNt>2Y18df@}MaJn}e`lSLN>w)tkmFq9kP zjyUgpswipnRlu+ETUT!cnLYR3onwX1!Hj8(RV6P_-Jk)5I2T@%!bLL-$K(+!7bJHF zjTa~*1`ys9VPemH_RI|cnSlb4hNY6q=fD9lFpST(Crn=E>6>2=-~965Tn;nha!qi! zCq}i?PCE@R*HN+g7Q@)x?2HpnI+ZX-(?mBO>>NQOxi-4+n+6OVfZ+cNo20?7q{EF?HHIETkK!5+WmA%VvvZT{!e8UfIM^Gs{xS zerTx1;#m|778*A~-0@Y>ZAC!vh~zp9uPO@ScWo117t7qORskuWX*}bdIMJiqdKLIo zNHl)-Vj*`!K;e>XNkhhj>y=|&`Xa3>92r+pI@4pp(4q4IGRD*e3wE3JC&Drn3m|~l zhGWN4mDZvt~}GJ;sA)0|)l!a@NrZJ1RhAtd&ip5WjPt`I!D!r*<^>OB1F# zE@r}!!lBRcvR#ehdc)g)z035RQNWj9E+^d3D#8Sr8n5#s6kKXOUkjW=f~ zwpr7sBE+-F16&#p)*>yxJ?V}3@lU_TJqa(wPkwT7j+@3`;d1^+bAH!o?*>-!(gF?` zN*ctO>%R9?jTip9;p><=R-TA(+|r-}&@J>|UhbSysIxDbz?b;5jJT2Jx*}w|Haz*{ zGtg#R^4B)JCG}zibA)EqqmoG@P4X#U)}SFj^<;&7M?6tu;#%X4$E5X!Y-9767s;c{ zrxC&Uy@;~Z2WqGb>?WO9hy78A}Grd?%(o!0w92;<@lCF2VeMpZ>K2@l)!&w*e z#b(4UdF7vJq=BB@{Bb^MAY)%VjYPSIquDK8vM`Q1?8CW1o;a0;Y}4`Pi!fIw0EA22 zR%?mhr3q=t{%It(GmfwCQbEi*?4bs;GDlp)x`Uq_EAp1UmN{Tu@&eFWgQIlOdYykF zT^tCbfAV)oCEHCrkx$xk+(n34eCco7k@vN8(#C%I($D-(F6Yy~CfmqMbvD$zy<7`Zva_ypODz%wN^v1Ha363Jg}5|7RTuN3ETF z&N~~e>N2OWX$+AzD!i6@OWjregw^7;(*E{qI*ycq<$-vYfNiE^$ol#17*xr1So#xo z(406jf7jZkm|zNfzGs5?J5$nSZM=C})&cS82_QW4_>(5(57s9>Et{a!J`27IeK6yj7biQwS6I63#UGSMp8L z4|!{}U2u~vmiiOHwo#rbOJ;-lS<6youRRn0@(q*4eC#vVPaQ2x)%g2q+puAHWx-XJ z6*uI251v9Zj+KUV$2$1}?c`_H`d+>Mlsx1|EKA5@)XjG{w$rl^pmOuG)^9iRZ8z(Z zP8`>Yjzl>Bi_g~yw>e|_ER0j5l85TSnl2?l0K}%&8Bo15}CH+IBK}$Q{z^5j6NEn%8csZG;42&C$N&!9`UEgw=ztG=fD_r<$N2FR=v!Sp zhZ9;8Ykr;(CWpqthaY?dJYw8KC)s81eYqrgWZZM#{W1MryyV#-88mcg?7qh?IIz7$ zc-T3yV9BDGK7D3PerI|-`^?ku=LQUmt1#$~OdUiJlpSqf9Jk|9{jtN3igVBVgs)P+ z^3#5fpe+amoO0J3&KYZJdS+P%kQ3^^(1-nE@(+3 zG%uke4Az;aGdA61C}C1}iYFg?j1t}A>)-rVJoNA*Y3SdH)4-#)+lCF61}<0KD8BId z&)P!LspU=nTj{`?ZN544qc}7uze;E3*pR1Y8Os8{a2DOC@Iou|mFq+mw$J)awzrJa zDX(MO7&3G)dc;8H22L(aJo76%*-vFM=eanMR-Bl&FMi7UQ`)fJvLS#T%DggJ-sk1y zjG=4Lai~`s7uGVT%Q#wJH*d)$;mVogXuckLRC8C8m9^p#?}nxKcTpU?6Cx75)Y+a! zOPVcCjh*o>C#v_~YcGt?!?I2xu?+`Qr#ahBoKTPJMw`Y@_)fr^dZ0fjLmRHeGCet! z>O9uBNB&~GeK!rY|E$20?TLtHLd6J_^F^H=*YA|GH0nbJ$zPPod*IyJg|SSV3;0y- zY$yJHhIVwbm$JQj5K;#nu#-&)rVV2>H>SKXCwAIxMC`W5aBNICeDPoEeAKN6eLwWk zS0~Sk8@_T!o+{Yk!=vM~UpS8Wj10la@VcIj@!VsR;?diljcF6+q^&^S*M+|J#CShy z*Aa2_8HdDy2kaEA*8wSV{qn+RPw(f&%j@c8&xI0w56 zT~&4;HgeyxRPsD+(_t-p6|M)>Tv>~q}XB)cIy0u++51H$P^IkSo#~kd1lOibKPp2a{SUI(? z;d^aU@ZR~y3?K^-5PtcA+oM}JoUueG4`QxG4HMUxu$hs zhtVe1jSZFlTlS0X_TM)4Ic%rs-y6rGwpG}~*fd++h0wb1Mki!5YMY_lT?t>oQs3U% zBi?vvD2a3#_;V1a=|k+0nPRAGl2H%W85RtV$u^6qiODPY>muQ z)}NjOa0VUP5c{6ITWq!KrmTG{7;Dxu_?34Yc%OmmqRvfi*p*C%h?UNj&*Wv@p*v;R zba-JdYr{<2Oy-u%K`wYNQbFzE`j6zA>wmrf<)1N7IO9J*d;iz}PYlQeH8fPpc?w;% zx>ERa_L5w{q}g0#`DCrEJueEB&lL(&poMAdxyPOz(agcf(C_^)=UU+jcLEJ%1tu!l0NmWoj~?d+xa}PUG00o{HwRP0JU! zy2gYz-;S%Vzn;Z~<863|9&^l5EH*MLcMAJaMxn>!se0lTiC$wq>j~bYBf&$>Lzn(l zc~fekjNTkFK#fNV5o@U5)W8mQwIj|KZ4w1Ja!&x;a?7oFfbj@r!2k4MDT()_M!X?q z7%~p=Vhq3u6DGx#S6-XDo-VLQeB>i>)z!a?!5Ay6v~*ch%wu;_0ox;gOSw=g6V;~o z14i$>Y*OUZ#%lf8@=T9_4$6v$70a7o=B$$B6VBw=RA#^IgN8EGTazcJK}7>o8=)a) zOrMj_sU*k2g((Fee!H+IldHWmkBS=~EZ&7yN@4!xp_j3I{i|P&zuxw@(he7_C@i@! zdW*V8B<+fZy7bP6#=0;Ly->ise5VBgLZeI%XewjD(I2`O-C1}VSpb{aUUp}<3yYcY zMAI{X1tz_LVcw2L8paq0>(>jajzxdi=9_W8=JGy09NK*w@ECcH(-l=P5U828Q?GH7FP z;xW}?gv|?{!9kKIp91UAZv}06f}T2gCkD@LE4`lhE-Yzi;Jalt4tu$9|Go$V;N2sz z&Yku1gnWA3HT3F@V68#C@C}a#s&l?Mab|q_ymN?aK8?9rPxzUQ;_S1}<{0z`W9ZOL zIA>!r3P-{QQOS?DNm&AnKtbzjbUpNhD7YKSKr~3=ix#H#d2_cV-^v7Z9Zv`oQ^0-|)K z*K;@GPI?-_vIRHL6au+N-xYX-5t4*gbmqoTFT6$mgQMv4h&!7w>1ma_?P#i%mD(EWZD}Z^IXu8*GAQsD?C_6#7)SOwSfPR#eQqu-Q2)&+>T- z8_;%JLyBJd&bMB~0Y$Y*e$>!_*9mheJwG4@jT0JRgx6!KCh5qr&atDfyYIPoy!8Bw z83MIlO8*I(mQw4(5|44;aVfOn-TdA*m4t6BL{RYoUOdqV53s#Wr&%d->DEe z2dPhbaq~)#GQ*Swj=u{38b|cNbfZ$mz|&DGS;qBjCj5}|p%-(b8LuJf#5wI{=>7p( z!kr48cmiM2iznDr`b3*J7}cH^3|4E%HR$w2!&&IH&SCN+$CT7fDh|6`QEvl z_42;`HSz)iLyx#PH0Q7=#?0h3?1NnHFSxmCu~>Ti!)Iu z+|~H6;FMuA4mNHk8|uptC;i!su?y=1mR}5Z4SVAk~#pDCM{8~FgkatB>k4Y&@TD>ZeGV+ zS{G*J44CU?SEvv8&)P($W^V6;gn{B#QxvpEcbmjA;x4gKq$YkcTk7@X( z>~`C1L)e+uxR7>n8U>Ym9pluCXuKPfRlZfvnjwF-U&e%QZN;F$d)Kh^lm@7Dpiw_! z&^5Z64B6O$w`WDadJHSmi%WTlxYkJNx@X;n<8U6?rYFXX;hbv|cCA88LdhkqJlgJMh>SXAW^@8_J0~7*)yV;@Xt( z@}v5!J`|K0OWd(&jpI%_1wC#Fv|MO6 z={ei7Q(bWe8ysKx$``YLLbq07&jk4DS!bVpW^U*xhiePacqJ}0{QC^b&NW%*nk-gB zlzCxZ^u-zDUqN8)b>c#N`Dap|aE$ZPPxx{g&}z7Wz!G)pI6wROMe)&>$KvI@6h5;w zZomDuxZ{q$(O*y5Z_2%8Tf|P>p?C0s2glLJpMW>AGBWc@h9(T9xs;u4yYK@;Yu4~X zu4+yTn(#U%_SJEbH!E8?51d2dQ=Vt4wUGS1A15>qBjnLTk311GW^fXkOO<=`EP0_c z#-x>At_y>eJpVqKub#@lHN%%Uj7vyFc#g*5}{DlR=8|_z~fKhIt z9qYD?27G02SQ}-Lr-_rEr~80MFzj0wjO)ga@6`a_(51aQ%K0Pz(ZOo&tU2+KLk@~F zPd`54vMuMVydmeOD;D*&Gxwx@d8qFlPs8!J!L0L&8(=zMt>JD0qsNcv2aj$YB@#06Ka}l(5VKVjOy9Q^VmJTDh}Nmze(M zg6LRG->@mXardN{eeBZMb@V3Dj=cV-tL}?OuXzG^97EOxXeAMf=lGfx?J<7VxR~(B z_*inunQ`<92d2S$)iRYTHhyrDSo-#|82`%Rc<`a8;+b2Xf(e0;OaKmkXFWG9UcT?u zX#dseaTFnNm&^ud=ydHEx|h5?A6(HUQ4Eyl;uA@6L*&j@gq_ z2He@frOut;K6Mh;4#$Z9@?<}X}6 zof>C<ccd-cD$6$wE%LY~+X70!Q8^vQSJ_|1@dFpjjlF^0*f7<2i{`{}=jf%hc# z|6aNGbN_D`Kq!SdYtYe%AcJu6H7O=b#8q-}^w0QiK6XLS)1xe!5Hi1gp28!9K6s=4 zar)_J#-*438y7ll9@A$|k5f)NBQE;k4`L6z?L9tdeiw=b3m3#APdu4N`d)rvEFoGN zV#U(MTy%RUhSS~S(MKMQp_>lF+xFS``6ZXcx4!XpjB@N=l58Jn;;Cn!kI#Po3mN{S zgNbSAn!yKWd`v3IdE}m!G-wD%)o6Yv zkDlZ*bNQ^B4l2bOdpZ}ZM6eq>=BYU8grkcP0nVn*m=RZAeNEhS)2%7E^u@!4E^?9O zRIo+$_BHWko#GcIg$2jwGF1M}@phx5Tv4Gb&}raG8sk&v4xfABt})${ zL?~zfYQvG=(|87)kXsyk%t>+2-M2eD2s9ia{_%I>_rJeBwjQxDmw~cyv)Jh!*g%~B zJ_w1HnL3A1H`o4=SnRjwxLk47Ra|7fea;I#%$m7B!b?84+G3Mf#O1t6?ZUwVJb)Ok zmt6A)jsQi z${Y5vcaAkUp`5~`JNDwxO*`qOj3u5Z(h$$f{72{{l#8ApHtzF01w*4%`?jNZs~*`+ zTrQLsZzCYv%#DBf3m2Nb8v_OpLCDOd4|W_xR$%`OD)CJk#~MY1KfC zbcnoEdH?`G07*naR8S~@Ci$NHmQQK59%WFOQrM&;@h4yLd7gq|5R!kzJ}<%BBgOWf4%d300YHHaI_xNQx*453Eq7Y7$p+S7?JU0&E&91gcnA&X8BL=P%3q zTn6^9Cj`+B#CP41{+`C28Y|;v6zH38{xg?MKS#{Q-rT$JJUkR70=@^uER zk8yrmw-3dgw3hMDA*wor!piWj!qiiOAf+NjpYy0On~6D2yf;aQCXaI$e(nQ!D)j7; z^_{lfB#-yMOt`iA+zYb`<6=6<@mGTw(_AoOrWd@mD1`x-`hi*NVZvytiwPo#7TBiA2l>swhqi@ob<6}yGSN+jexkIsSEf7}s8RZG7;+y|b?D5C2r_ZmGDmAYM#!2`BO3KOSQaKhI^D zli^!UH9P@3^ncig4~y^r==*pqLZ9mqt1{&};5{2_;^D`h;BJ(M&&zuy}VKKLN?K9kMa zjpE!-of}6TTa?e-B!Gt~yZ-5>zoF1S!iLE7oUe^IgzSPx@0py|H2!o&H})?<<}=5V z&slTk$KUR}D_(i|Re0D!F2y8t9gZCyZ*O7a;_#1sjLYtS4ewx%gLUyPFIvtf!DA0U z5f48651d8D=f+xwlVF_~h(p1_AKWj_I{V`>dfRPF`;`0UcfJ#kKKuy$cvI$beZ2J+ zYZ7aggFK(j+CvZfuuKwOiP4M6^W`sI80UZHGld4E4;pvv@t&U>{&Gv)d(S;FecDtE zN2~GT?GwYd8Xlke#3wnGdP2^#oL7{QubC{%5GXolUD=uZUNSg7rgU83)3rx>HMFrw zV|UUn`OIr>Wlib8=S6NSxb!5 zXVxMA;bpGdJOG6C^F)~aoz5BXgzOXZG3QdPuQ{viEC0(kGCUD%zqDN|!@Hy#YEGJ| z;Vk)_{L3~$WHIuaSG>v}t&<-l@oybP2jBsZmBU=;#9K48=E=iRBesaoocoD*^zkQB z&R@9<<0I{Ra?15cexhubMo^fYMiApDYe@BE?%IVIM(}zThYhT|ZM;{X)Tk-HH7Rqs zUTGNgb1eoX1?Jq424;;S-XW#2S=q3K4Mh$84wE=lCQKtgFr`5eqn#Vf@=nD(H=wL{ zMN?BOhKGzAIU>$D?F2T^inEO{RO^iQaHS`#j2qs07g<~ z?a7*F-<>ndxOc!h)qSLQ%Se}51w~Rv%97p*tF5WA4v6=9nY0&KZQ#G5n9l`)2rLyD}+@Pj$D0hI0ElY_rW`{|_7x zpFQ^zvE2^aLL=(F$kh;wz0io;gYY=pkKU&Irv3a<{y~y15U3c9R z%drPory+r+Po18B&pkUP^^wy~y+3|?#wzoETYUQ9Z7TY&wOv592mdk zqw){W96M8)gSC7-Qc5;)gzanSzz#ungt>?^P1R5cAb$;(k;Tx4_}b;XIM;$Lo- zIlprK;xkXCQ?E3m{Dt_I@{5IgF&Chs0y~9-Jsqtq@A%QjuFN@YH#$IhuSGXD7ChDb zCKq8FDvO1aci`N4&;0X*jVO|T_2%w0`(&?j!;W!Tj+`be7oPvA*lVv{vcK>38Q7T9 zg{Gxz=^j0w4C>YutQyZ#@1|XOjg%p;SclBxCW`BEr`Bc0zdQO@Z)`ca2@8Mneh8f- z+>B6elmE&;<#{e3>zZ2QCtti013w%4;IfU2bA`79<16ZFu3_eLjXvhP2gkuD;iTq0 zXE?F3s~u}+5IPi(?~_j6n~j6{iI*9?i20l1g8$e z7~`07$#<`emE7M3!k7&7j}6RDjNvl7E_H-TWBtGTmS@;}**A9IXPbEX)~BLlC47a% zOynQRIe$4@kxv-YUVX8p4elMg9ykg;%#C=QfS?KE>C0n1sce`g*MeTyZp3R_`~B@iebAAi(#WSiEVe@1LdKuvrl3@mgjxE=WaD6SbO)}CZ~;6zHtc=i_TZE7QqXO4EBBcE>fV_4 z(A%7B=#}H#f$U>gA`Ds4iBY|i4PclL)pw0WPfU+{HyINreeM9f_puA1yJmP=cwO^b z%i?dBKORfxEsIst7blLGIE4>8Z|1IvDHG?$4*L#|$rG2v&EL8s+NKe~LIMLnT{*$g zb6{hxcWW1|07sloS=thh-|#}5^TQ*ez7d-U>ztd?bTTJyau1}dsG0X=yDWtnte`qJm)@h2YR0^3)({BIZ+08Nf#PdqiY z*=9IlUWR5H#`vF)(6(d|M*~q{`e9J_!rw-A7Z5@-Gt(?G`*Fty6T#E zddxE{x(CJ9+lukMB&G5@TO}1rMP`)Qw>YI9yOv3dZ80(S-16h!pX(o{iC7Wo*}LTA^K!9`W8& z!9|9gumP7q=f6c*7B9V60D2+J{qISxX)2}4cm9<)v!m;u{2#w$ixjs=GGObfe)FZ& z3_Sy%g71PwT-tfhKNw$>9q_!C*yz?qW>a1o}LMSG!E6S&#}!~QvEof>=Y zwgWgt&;mZkqY^ID!v+90;rOnCjBTl0FC`q%kii2IU%BCwcmto%kK-pERix6>l=2#A zHPmNpSn%qc&6wAcFk{}zNs68r#MZ24qX+ox;Nm467#9wTJ@-0*F&x8*fQ@6y_cuVx%s1NW#i@bYZofaSx%P^@XQ7$<61LfP$2jP~gNY;0hK)fC z1&sfbX6YwnMt>EcG3c?tOM43N8VJRgM-F|jK-t;JCXa#{wW#>Y%RJ@d5T{WQoFwg2 zuS>F|lKJ>8AsB};cj9f|F{Z3_TTgnVFsH0X!BoAag-}#$@H%*X+^Yzx^b;fJ?z`-X zC(r>o&bH-6vBn?#=6AmrvuDnR{|!L^e?Wl0>Bbu(g=QM!e~|-ZIkz(;%vv^0IKnG@ zf~FzClp9Zc8umKb z7R&uC%bVlY+a8MR|8xzfA|@bb6QdttsS{rIz3=`28t+f+)ir6jUdhIor1|0tWAM;B zjm@1pHYHjx{JjuY{r(D$tUnHopwJ`KgBaSB5IW-E5L;A%rM}G*Rur;23>Pcw6c+QJmlRVkj{(5UlHyRv0ftF*-{B>P${52eF7)~Au zpA=_FHwdieNo7ul=}`hL=(VF^$4xBfwQG#?NzY^9DheU|02pjbkZstLOf;JPbQFsh zF?2>F{-xmz-1=$0^@?sO&c7vD-G=F z`DnY+mvgU-i*=Xw9232LYj%>PM>pq8W!=oL`*TD?2LfwAX;I*V_HFN!X)^T_h z2>#sXzDO9wvN`|pv(Aohetj%`?-6%$Kfw1VeLJ=ry>*T!sH;H-ZmG}ztb6g2^kmhxHo1_=eRrT zy#4CI`XTP*dwK&;c=Z+9u(Yzzy14XLm&eD?`9v`u(SP~N^Dn*}7hG^*Oc?h{w%3(4 zQJHtaq6IPKop*55c{o1x@TcRqSN%5c6mdROyd`;0ZSzPhrC}L@kPf8LY`aDu#kel* zO0R-j=0Vb~-=SmYyU&GRoH_^n%(=sJ%T?{Q1!Vf(NihCJSkll)q~H z6Gx7Zc#`g1d)#=I=Q`fXy57Im0ClSj8#x z1#{;?b9HgbNyo-P2e9c#{nCdtvtjZCjJkxuPl=p^~DLR7V0?je@CgGuIemYjAeaGg# zzBy+c+k~C&I##BfW2{@^R6I!IBUqRGTSMPGU6b`wnR%&^vhp2dM&60vE;Trmb1Ghz z^Mm^IkXPm}&PvsI&@Mo_>18;VY?nH$OIpwQ#HW3khYtDLs}mC5t~f??;vu#UL#km| zOojnsPa?xFbulhE&sGtdb=jY)b?&vgrV1ALS|XW5a0X zX)0_AsTVV6o!g!)=wL&jm5t?;Q(=nIZ$0utPcCom#;58$a&I)b;Y zT20`7@^owL86W%jM`Q0pM#p4A<=k=2gV8ddST@L1Ghdh<F8r$zP zA`blMF4&0%!SkDmYS0ve*=#rqkNhbU7ZTUMA9_6Zm0bU5v@TdlpF3ig4R@xc9KW7=cyL>Epz!9eI&OYCy|?y=7?J7svHw~uksX}!r%u#`4T703yh}bhN7gz{F$_TOTt0nCv@9+g zVcHfKE$xWE{qlimn~J^6jRgvCe(3gb#A*9SKQ=3taYE^_+g^-m54=eqxKHqv`LS?z zQ*1hl(`T$lYq6(vLd!kTX}X~^xSkoILK{!&=I}^QoVpR3C$W7GErEQ>F>mCb(gS}q zo_*rWza(dx@83`V83x|p0Qk?a^51?2qf9a`gt>Yt$aTNJCidTd zuUw>D9PL+c-j_*-FpJ_;dEVuF+8Bi3q&KpHOb0uadQ_PzJZ!|Sy53!L*34%SZ;5GB zXC?kLh80Yd#a_?N_2s~g8wcXfjRS8#U&T@D@?M1dzAuYmT^h(#sPtMpa-R?6W{9w? zWk>Xa3one}2t!MVsr}C6DbYk6MHRmWLWa1b*bQNL+_(uaM1*D*T=5}Hj)TUZ93d9D zl;rsk@5b4biM8Uv)r)aD@}oz_V~;$>Q8gGD2KYNs7!{o4Lkf6yVk2UWZ@&5FF$G0Z zuiy#e#>b3lvl*uyQYa{bltL7Z)RNxU{%q)jP>NwF-w8^-=Zjg(kIYw*MoSzCyOf z{w@e?Dk07nl@hf%6`WOgTP$EBYtv0Ojx$d@CO)wDZrNwy6sGmC)GBwb*zT5FY>_Z% z2=Nk|`CQ62di01iGA6u8YUu$%UP;;S=?UgO9d%@g5`gJJEI^NzvLT&tTXzvG%WsYU z!kqEW>4P2uKmX~)anfnW5tDl{n`;9QWERH1{qpB=^>tS;)`RG;#+fB}=`2GKHoQu2 z6otn0+NmdI%mD{{Ft*-mNF0CMiFh#mHu`TgD4u-!kvNA?N2i{0R&2cSP!{`@@ywW~ z{@;Y-#j<|zx1|-3!035?tK?3 ziqa{fFPY1D_h1~l>tO^Qn%OKf85SW!J84W%U>5HroAJBT!@C?bCVQOH(;Qw_n=~QL zX`g?|53UhfyW>&5XvrexE6OQz-S7xKF|03`H!q%kb}Zw$IR@a>x!HLW#-v9dc@U+n zZ+bs?+`own&6eZoH6UZ3LVLA-y2+?Qq}L%+TCyrM!~1&ho*w&rFQ;D+S~lA%`K|bI zY=8H=%Q$K9CMOjd(|h)%mtJ80Dwq()1>wG-k&Ec?)SNSSDtu%GUabSzv{D%?_(1j( zZP`y@%9+N4R2I`ak5EeFcSCRTJCnE|Yj})@=e#&}EFQa0!_Oxo0Cs~%_JKY$@^^`! zU;Jwf^B?78z*;tZH;NI%hsR4VzXUI?k1@|a319mHn+1Kq)mwP%zM1f(%_E=kpf+wNB};|a#FkSSiU=M zVp1HgAcT$tY<=l*2cK*o1JoH~)8u21qa3n%8^`zY_L=hf%>Qvb&<(vtO+ zwVJQwtkyc4aBVONpX-8#0h_PbYU0b^JXeYEX!>3EJ&-41da#+YmdnlLrDen0jWRqx zsZ(WGp<0^rvh4jouxFfj+z~No@SxIO@V&9g3QtfP$dZSEX@3)R39Eh0qa(6(ewImR?2Jbdts za(t)BG(^d7JIE)D#n@NY9P^5odXFud6xBxbR5**iE=g^d?Gvb63 zPl`9jzs7q8L%{wQd+!0RcTpv9pWL*Y-V-1|dJiF#5IO`xM|u_MiUk$yVy|n(wXNc! z>k5K`C@LU|(tGa^AUz==J-Mm(<|g@mzccUu=7Q+A?7H9jJRg(1_uppDoH=u5=FFKh zXNaazg#4gEgi3}wWSosmS|7asF%|%dBFlPMw0K#({hjZMKi+Ud!W0X6r^tk*FVQ{V z76{>FaTyEx^1Ai9YPE+;(x;_If|7W_0XPi zap;i2vHiB&0Ylhp?asp0g8WT(*;aFWmRFG(s`e>J`)7mcv(L7@ zfNjFgJb2EJe9ux4xyrc8t9BKf`Ba}#DHNE#18)A~3doMOzdtw?FgqN)Gv)KxL7Vbqd^i*upjh(iyKsR!?y zvV}POH6A5X-J^KuYL0unD)Y6i_!d6!8N9hv^NEsL($u~ggM56pJvpvBJ{f%Pvmt3F zJu?fhd6VC)v)YGv_dDLfZlK?#!gLufB_DX;L0pygjpv?v5@lEq`mZ*e0e4EaMP)_L z7cj^d_3VK7^rt_W3gdkFI)5}Cv+Nz{Qw>^+gE;@|X!q{^D+>ax(93vb-hy?vOho;- z>oak#)roj??amyRc41kUGUgi!T}T5REvN0&ccaISM3&VuH)F*!&pwxNTIXBtZF6P3 z^ZdO-rXCoF9DG2Iopa{Qjoa?HGye6`Z(xux%YBV;*B$rf0)Tl`KXX`sTyFl#FwS#z z}hT4)!a`SMGXlhe6V2tfq8j zBM;@`Ei^T~^Rae}C631)mhJp651^&*YQ#0C*4BYMo^jDv!0ZTm6oUBPZ)RN2K%daY z1qF5uxI>{0{YE`Il6Rgo3cNT|Vo>)Ocfg3a?;))8nIo>9wk)20Vs`Al?{=|lqdQP& zPo2AQrpAoevxNvBhfG~2Ir;I3%TQCZ8O%ZD8~5gD#`{NnQ4V*Y(I*^L07 zfM?P`zGvZR@qP37&565yc7IGbdZ#$?yeSv~_Kh{oYht&3N5rH9Mnd}z?9$mBf4uIF z2-aETjlP3>GS9_*(K2=obZ`Mm16W)DF`rzGCyo1VdJIN_F7VHm%`9-f7nf7#?~hge z+E}@^AqI`=9TWF{OI*Ps#1mIM3Qo|Eg^Fh$n-@pzJP8yn6B*G5%1gSIMF@*=r%i|{ z=kJM((jM18v*Y$(J{;Ta&LYN?QSp}>aVz!^2-NgzoNd0Db0~Dav-wgj43edSaaMMX>acJi)Q)h6nZ~&&E6ydC} zsjeSVu}CB>6jf#z9DJ&0W7_#??LKty4r~|xO?>lP-;G~g_p5ki!GeToqfl6N8}$Z! zJ}aCI8nk1)^Za+A>_06n1+};~@4fceJ^u2io8xQW_y&r^KgKF1IJ)Vv<h7(HqSFmW86+&7YkpWAAJW5NI$cbzBFp! z4j(o&j(E#aaob<+h(SXK#~!O-_(Qljq~6B zj`-1KKcutn77I}<&zw0cvCYXX9n92256K-7zr5xbj0w%L62VJB*~6DN;EKgIy*fJg?Z*NGi!Mxx-~NvCQ0%=BS6}lh77^(9z%7-HbYNXj*d2cC zv2pPSFQQI2;OF-(vEr2_F&Uq~9)4t~kvVTta3kL$2rH;aN_dNSPNJP~rV^y$wS@5M zKgKs*siCZjS4Hr|Oj+laIO1p( zt#z`ccH3XxgF;%fk+*!ZV#P-4Z**Mw(_h5J7hf2&W;~A|-yMZ4hmW$=ZyxTQ6pR#{ z^^@O>C55{i9Bg;pb@%w_M?V$&955L;&GGR|KAD2}Uv9fGy5TD8QI*2?+>>oOCtBd+ z;k#NQxJ~mzAHD>a3x^|kHX)?qx0vmJ@>_cq6Z9`B$P%wuav)PdLoLtNv69}5wdazB zOPMIGCoil3SW(x?qn^Wr8W9LL(#G{sIDhtnq;W?UD(vHQWg_j($KbA~oZv%`Zk@WJ z3~xYqMA3=hyotfx#O5!}y0Spf1*`TsFVD&TYUYgDiQ~~n9*cj;N76V!Hwx#RbvBD6 z-8p=zF;=ihpl{{&OtiYuhPAlph>-gvw7CbR&hWEQno(9QL)suHsI1SvmwZ7f^A`u3 zNIUvC+p+lR+jboXTkp-`al7t1IUalBf!vYd;?Z^2Udx0Q0TaITJOlk&%6Yr(x+m@? zs81ATv!=fkcieVcoPE}bY_nI%4Sy0z-CGmBEbZ@I3~0jA!FG`R3XDpbZJ+S%Z(SPS z`|fvYyFRe4M>*$WuS()29QZqY#Mt=kXTL}vwI9|iEVe?{!);#2j zF~l8goxAjmx4-=Yc%L?mqFM!ho_T-}?1WkCaRp&_07z^nD^566`pbKsdts<&d-8g$ zJ2qo|0{MB54{c!RS5pOq3&tBr*M)ko@X&o)^3bXR;us~`JFgk ztG+CW&9~AgnZB@rz)KwCTNn0qWGM2PPl;F35!Zj@lVf{J-;-~NE&%_R{yFjC*?Jc> z`#ED~-rQGi&F*>dAzY=bjFH2KFbAVOQ4gLUpyFSb5MryqyPUDA@s;(AkAvdfZ$C3e zjT)A)syu(bi%xurpt7Xr6=ABAnVWu@Q zJg&^)q)eZkD$#sz=c*VZ?1T?oX(8#X>r`HFZ+`%&dFF-nY5NmBpB=ZITyLNaeEZv%CULgV&%OU$AHaQL&m8Ln zJ8+u;vEM-l$E`P9FGIu?KmP?X*@qZc*wthHz_iXBN0+l`e$vUOU`78J%09+e`hvao z-7ntzp7+Ffj6XCyXjs({7hd?DcnJP8xOiwNN{}|}GW`I`^y^XLV{J$J?kLMHU_s#M zV~%El4WkZt@_XO?ZhZfH-^+9wcT}NApWazGD4dp}fBC~71RSHr;6Cy#Z=tX0h|GFb z%w>_{z3=}hZpZeB7oMLMr{c=8S$AkK$dtp5jBkDY>+E_PmhLg1e(L!+@15tz^DK^9 zf7kuyH@N^%+UAyc*Sp^zH~;oJta`gzA@~iS6z_f4g)tGgSUp)3)P2L{Klw>~=;9B7 zru~-w(-X~}`w_JI8BCgvEtC}gKC!EC2cSITdy@)FhLwkWZ-3S7J@0Mv34@rK4}UU_ z?}?isHRk1e!KLuObtPPP)m7&iDI+-EW#2*j5`Nw%KHx^%7O8AUj48QWk+v=lwjFV{ zjrv^mQQuFNP)wYx3zHcw=l zTs$Ff%c|j0H5OG0zoY?q=qi4O#@-?Nxg1ISr;Z`>1jJUg*4}VLZ!w)+M>-i};M=?vSw5{{xlULzT@^IX; zPVI}VZx6Qp>ri17f6T$PW2YaOD*(s#NccVTn&o8z7aLt25l8(oWNU0C*K zuBbr`+>-Hj*>z$Zb<|<;%d36~UUkfMzl9PHAS_mFWWJ_B(bPkxCOyP|)R>X+=Re&- zUiC3=_G}D5z84?3_~IgeU=3Vcb6!eZa;847FBxWx9WS<25cuS>B`5%%l@khX%JU?C~=F-){$74a9RDi+f?-83`I?BpM$e+u&S#aM zZEEmE*&J<6_EYIUokU31D2e;z;oQ2fT!HIjcN^KyHe>Z) zr|TZ>bFM^Z+6Lp39VU&AZHD#Z(AQqLuB^w>zCU9lb61qm&6}8`qhN>aQdhAOgDb2F zP}pxD_iw>Oxg(l~SAfbEbX_ZHqow~?v8XJrF<>yR zY)UT;9qM&~L?1(4D1R$AHxXa!f9I}s)PZNXHM7$qjgPoTi=BDc7dD_v8#k_heE!li zSd4o)9=LlNzV>It%4c42n*jKLIPs|1*u1J4Mf}4t?}hns@t59;kyU-}9H~b+z8-@g zKqWs^yxW%gbG)zXTIm4ShaXztipg! znS0HuB^Ysaio?#C9M9b~J(^}*|kzXBSnFCP37;*H-IO$UdVC=wd zHrxqS6*PsV3)|SO{KYuu3$h&>_8XRZ6^GFE32Hr%^Ro|02abv8Whrx(- zWxY9GP@m2Zo$IxyO|9`dKM?SOOH&OPD z=x!2jt$k&C`WtPH+}{kZLjh|2&G3(*fQq8_IXScMX{Qe}1~7v>S%jS0m6qqAQ@Inc z6;;9kQE7)hqg3GD0Yt`j_1r~)Ubqwa^5;Jt7vmD>_S^1?yY9Ou=FXavf|!1R$Bi8q zd!huN$U&+4gEOc+RVeW1LcoqYY>)re@5E<5wHS+|7h}%sxy4eKxZC2wWbC*xOiYG? zVM$wrK*TE$vg6xn+_?A)+qhRPUm1f~l<42DPr;LphNjK}LYMgI<(I{C&rVAVlhG|6#JaTuJjE1_C9M3;U4yTE-u zw!u1FUx5Y%Drx1a;#a?bOABbA;CJHj$K>SU>tFp+Oc*^TuKn$AnPAP1EeO9_(f8@q z4@L7yarSv<#kA+1k9qUwrB%j9F1k4DjPq^x0TuACq~dzyM)VFd@@X!$-v^ zaD93H%h7+}w$wjXv~*(My7ZgzwlmI%XQxfW|L&SREVm02^IaxP$Ze_uvu^Lc^Gp;@Zf7 zqw=&KOEk|1&>fJ6<_b%9Cd#2Ibvt%Jaf90zl|1HO6hC#i-fF@}^Dc4AEw{u^e)9A9 z-SyXEIXIKD7Ui35SYgaTtrJ#~d+ohHymw|UKB>50xsur^nYki<`Hz1bmtOj94srek zc`iwT*uzkZ0F5FR_bd}9?iv@q`{Fp_sDqI$z#aNnUptRww?vm->1L`&kA69Mu9)y8`2u6m&lJ zp-;pmpZW+cnij`iyH8Hs-}TP(n3!&i%m3p?D5;lWI@yE|T9hmz56!mOcE|YG$3Gea z2W%T}JNs=25v!p+iWLMV!ydct&4ll2U@nOvgGZzALP#f6{z~)Q02J|iPTD6fufHr_ zo;N?nkK2U~E|^qx%QFYQ@a50PZMWVE%@On|usl+SfY@eJ+c@ITW8%FRy)RwPT=4b_ zUoQ0Tf(7IdlfxJLBl>Fko{3Bl}uUm9^(D$8L0O{XTHQ1b*sRmjr83#GiEhvFsXpI(~7@&zX>|LDnr3 zXkcAv`BBpTM9+yX2`1rFO**;Ri zN}+9=(o%)LPr2X*zH2xK!b83l^7K*ZnE-U1@RZ7C;K4VqzynS?wfOZg;cf`ATFM&i z177c%FI)X-i6WxOp3@YnH)xe9y@%x0V4g*$1k?cM(82!m@hMvhlKSA&&73 z!gH)riI?*V>NEQQ>eO%cV}3WQDvfTk3@Qrqo{y=BV=^MTD*tTD*=Lio8VjX~aKyC8 zTjj}TGxMK$Sa<3l#0PQ^vlX> zI9W!s7k+-^lFxjQ#%3YxYkq%2%y|*3O_cj8%0KwwcO;&bENHSr4?BbffZw8&uaAZE zrpIr8_xm{O%+o1DDW~xGkA?id#8ZzyLOjoe*%%y)&|u>M&h{{L zWin-OA@EPP-5J;a`Z^9^@5;jPhS+iNkhuQ3-^I=oM-oGt6x@$H{)E~BfaNdr^}FZp z)InU|cuvJ;lm~|$aV!g|SJOw914WNJ?kL=n-5(de=YmXo=6UDCBPu8{!Z`d$#+$2< z0a$znf9rV<&JoyWuf5~BC!P>ZCdf=CDT@5}yBq!xzhr!>!}q?s;Ep}^I9w_Hn8V*$ z)X3r%e78Y4XmE_OZ%bNGoF2%3zy8&=@$}=*;)-b37=ZDG$`!w>Nb#(IqYgVbem`Xj z?)iS2FcvPxYLL*AMb%#X4C2!V7Z2$^h>Qmf8cP3Ej2z@S>&7_B^oH;L;0H17*=O>8 ze*KOxjNPeq52*-0QlBU7|Ir}Ewls3yaqH#** zTmIx&s4+&i1I7sRaIAHVv|Xl>pZDTqyVFR@@hBHiX#Zv5ja23>UZl;k@tnI#foQrE zH=u=WHWw~4UM(H>CQVmnwYcIVEU#N#7|}0)hhw;b&q)tN0{SR-n;;udUi)>g833HH z%G0a=3V@KL@S0Cs|Gf5j>zBWER{@|wpUA2xd5utNMk6S1vW)Rm+I>0 zmU|*gLgl2kZ92wHH{KkJP^>nxLv}KM+b{&eO^*L9(nzpY} zI{R`6eE!*I$F;xU3?!6o_v6N^4tJ0pahcJ~PNg$WKZC{3`rNsr75|CH9UuRG+2zoW zc{1~o&;QF;;^}9f<=l}2(gJwN(q-%xe<^Oi{f?NuZ(&)%)uD+H@7Qt7{eSZ(U1z z>WzQZcy8RPKYQ@e$DJM^`>2#%pK`6cY@1cYA}qK&Z1wzx7_$Aqc-zTmGdI{d>qt4I z$T)wi{S=JK!eP;?BrbGT8fe)j+u<^$sSO5Mj9JRr%FGQI8g5|+KoeWjOP?bb6xqdj zwCC4(HdPb+*{sz%c-V$DuBk`H?mM76ZkAENF6WS5=6-!fZ4+Pn;d`S)SLY8{y)*yP zNX0|#+v5I4j|Q8YU3gac>>LyMtxY5RGa&j+8W>CNd)ZDjUc7&LEM2%JI&wB$TPAF) zIZI&1lXJ68kT8bqHZ1yX+dcmHo7-ZOhJPsc>zTXVck^TM=Ns>hRT#spT)ZMy&R>pl zw{*yDn2T;KibTkX`7vPKzD=jTf?I0sHGLOYlr)uJ}A@c zSTsnZH{La}Fp>SWvLuTpx@FTfYIZmbKDHAVc(753%`B8^K&ye5K_#}z>K=NRpwCd3 zqxS{2|08EHz|e_lxt{GG>-F_6o-vS3m@ptF?zSVYZZA!jF|Hfiyccj z2pAfe;j)Jo#4m7(bkQeIiRO;NlNUK}06m0#N#aNubd6kx-+OEVvd)dCF^s$8o_}_3 z@$cV>_J?btqfbA8g@QF{U{a4BvXQx5d*&A&K-`@j4ckr_7;~nxm;*7_bLg?V0(0j+ z^hr0^^d0SSJAByr`^4(ytKcWSPG+#h%DcZ_rn zY2QQjQ1`?`)>sF9JMq4~3sCwH&T6WSG4!o}9egL`H^b{u0Csva{39qJ!#c>hO65eu zP9^=<$=VS#Y!$;YE0I4;>+ zHqYQq4Y+t{dE8p@?&PvM{AQc}{jr*7g0z1vZG|Y03V{X%ZC?wgTy1k(V%+GFiJQ1o z1E#q8PaL~5Q0_T-_m(&btoFzF3SJ5$(yfBwAiV$n`v74dsg@I-*02*Ulh!@i#b9ut zwWuXuXv6ci1Nz4YFMe<0VOrBDq@MqdbKn2$k;fBS8J z7A$ECEZuONe(I?_kxTyHD&Uk!)D}AWo#Otx?o5kr7ioI9rItJeviokkA{6YFRND>&i^&ARXo#G;mN0-$pNX~HVnLc(DHu?E6cCoZbZf33CAB5Z$a_ALv8D{WitPq zP?B#eP=I`WM0P+B8@S!TSd7(hJ&F(&(F!i&BR>_(WwtCcplxE%bL`S0LjUk8fK*sD zGq7vvug`tyui&L3sts+_d;Pe#V{lHoV+pnefk)UXHy6Fqn7$xC`H6R7d3jzu^2n3% z{7cWrTo%|G)~#k>$A{v`Q88(^Jz}SwM?Ko^uf#jKBEhOXAG4 z&xt2F1ai)-S!|JP$itlb^y(WE#!iU6_uCU*VFd`V74p*(i%4XL=^eg`LQ^l{+$!4JQi!zmAm8(0LK|H{kM$3}#|F0uVKJH(NP zAI`yRgHV2NjIVy}TWQU?)A)%jbncw_o`^!cdyn26V0$0*-4p)mNL`h3%R|z3g9`xr zOpJg1=J#@k&OTVkY8BCdHO3Buw~5RD{on9S{X{(W_~Tek;F1Em>;QffP|oc>c`Sku zyu#e?V;}zn3a8`o`#2;gO>itQ?bv~(Lt|L#H3|GiM~Zr!N_M-%`6KmbWZK~#~6v&FIgY{%A5zLVD68&a_h zFZlgcaeeSRKkq6Ycx`(73g0=_Joo$yC@|JzRn`r<;Qtan)tX1wRJy^MHEVXdGy2p= zK7b|k&;%@9%2-fxG0(proYcTCiNDrD_^m}2C^CfOzf@PSwye;e=X8Ss(6q{x2HfX@ zW3BDjRa!{jS?^j(315tK0p;Z02coAu1G!SBvCSLL^$2-LYAM^K(4TbimE%}mvfXHL z>!O0_>jT%&f&Nt*FjUj7w$_n&NMAGeerw9bz>UKFtQ@#5pp{-}(f(nYuo_gU_w z0kp9{R5mlNIf$omrI~3RGmK*{UaaG+Cnw6FVxB3-0mCsQcUM5Gvbd#X=2tSUb#?49 zZ=vp4B*)FdYIYqiS+ayaYEImC=dDbbJ6n{5|E+)hew=#hNys!>N|nWzxpNodbkfNu$2Y$Dm7K6=9g;Y4p>kGoHck$F;MUm01g;h?yX;4_F%}s&;bN<2pZL`; zf0fGrLR;D;c)LKnfQ4OyJdiGhpt%#mj>vO$CuNZ$1yCdQ1HgCW-+W|*oy2iNl z+ux=RkP%p%9WiobeD^!wVUmvj?38(}AL-m4cSOp2)Dt-7PMEBzoOqYD8o}`SMzJ82|+wDwPUnNN*wrUR+m$!2+ZcHFY9w#N$AG|Gw6SpLYqCJ9D5;``T7 zD{6W8|LkwcJ?jw!<@I?e_gCVcun+Sb=Nq~#T#L(8=cJ1l&C3OqBM+a-4(a{bwYk+$ zOc?UpeR(*wyf?vA_exHHR$Iv@(|PYTWees__RAU^`Of}x1G@+^K-VgMc~Sl* z%+@dd7w;>)vB%3>Oc{09`(#`oLe=a*th@kj2~qbLoc^vG?J_(aE;sthD*D zZkiVMl!fNI+W`|;yx`#2XXjHG_=Wt}v76$a>u)EHxIin~nQhD6$`pij=(u*-Ax?Wc zR^{vv+yq?t#OS7gpydRWoyIwA9oA<1YM`WpwZ&zxBA7ZDQUoJ(2i; zLmx*w%)yPkrCaV$hcDaG2Hp9M-Clu1T#d=Pv8ca%*=pK0&%I~^xMt1872q_nv)LU3 zWqje;^070p8UOyC2{&eJzu0LPjOEUlgpOcM{Nbv5H3(Eb%9n)jR$%|sh z=pN7o_hK3YB`xgxk|}d{)h2~hN}%Px?#0!itYw}(`z2%?2T}T|uAFBubXZ>u02gE% z#Jnuqbz0I>cWv9NbSGbFN!fMfs2*KeskCHX(^k7~(>uCR&SmTrch|gCq&ry4j5rtb zpIc00A+G%geE-PL?~I4V&v*U|X2IvY(uO7;zcV`nI2^lya~0^nH>{<*5_W~lVAf>aiX=0E9C7`pe`W%p2|=gEsfV- zDt>d|Epf7g^gBY0ac!(QsM+CrQ-hxZ9*-_Gr1FOE84s8~+c%WedXf;&XOd=zVm$Ln zr9{RrlN@5SgfjR$7}_X{U{ICaNEHmrm}TNcNdsJP%5v1+iBD#p>FnU?$m!S}q!r*u znRN4NNOw5E5T3BjUtCqnd63pn+$mJS$w?|Nh*!$P7r+R~wAP1P;l)RRQ&_D-p*I${ zz^(7i7I=cBs)B-!z)F44X@Q4Av$$3C$T}oJ;+tiazCQB<2Sdr%da-9^0K)HJHx#33 zQ4U_ZmdSig_`eWpXuV;`RUJ4OK5+k|STgrTdB?#uSoF-EJ_Dg;6V~QTLJruMT@gDb z4JvvhkJfUO&WS?}k=Np5KE~<7K)o~D|NnRszTy#5X3S*8eeQg$)_1`DoR$>w1GS2v zkft5BJJZ$xIw{n0n`&Y}#3G(8m^K|Jnx#VIIpq_D2!v_|B9kg-s3_{dvo3<>V*$|x zVQt?7C&j^2Cnbz39^)WF7y<&@*H*7+OqUiX66J-|Hlu>CXN)jVr$r*Pc6Z;#l2${x_b2_Fe%Iev9DWw&@!5Cllz z^I-$!6gTr%uCp9#STyL%;mmb)y=Z^-W2N6&v3ygE8b3TH?0&Hzvb@No316D6SZcr8 zHqJlq^n~LMjdl3a&n=tK@TemXjN^_uFqQOcS!k$LYu1^rd=!AuP2sC?N*vo^N($Ev zl+Au*9g23tKKt*6`?B3KtvCP{0eDL;bTpz6uy5XO;J_F@e21)~Miy*rlm4sv2lGi~ zALVl5tg*{gjV=OizW|sR?u}}qzT%4?_?1&rgcbr+TN;HHgGWg zawgm?8Uny^Ro8Y}jpRhFWch~vR{d_3sCu?N%Lj(i-+)Lmw{5=F`w}DTJ8$`8%qnDG z^Y57J3VW{YTm_8w(bm&sM^P=`z?Qc32-!oVeW$<*!@IqXM7UViqus$1K$aODGW7LF6qs?W^H3UDm9 z?$+!l{h3Ec`YGGKdFeLFZNX(6*J=yMMysJDp7IUEDg730$Ztu{S{(5(SXc6bc_`0h zsKqG>c*C==EOM2HxR@+yVIuO+S!{ZFiJ7cQEQb=vHB>7|!q_H6tJBST9| z!#?}$$KN*WTAdb;KK^7{(P_ze{@LfU@ZTr-K;Fram9iz~&vSBIUbX%!$m;dH`3q8k zc>lu>u$y*P`Vd}=^`XsR4GZt>m@qe?{CB~_P~~BpmN$eXt>jSqW`lH5hRplSsSW4a z+>O-$azKs0^&EJ+KKgPF(#%;i;&FC2yo?dV{CV@^CCW8_{(Q!omDDB59?tyPnZMaqbsQLGH*&AwG^^eX-DFpZNA`SAEY6M-_6gqnB^p4 zx?_;E2@?47IQZuH%T;+zzRT~#bJ3*WK#KvcJB(aF$Twv7IWAgu(4OK2GDxc4d6;@*iN4J1^5nTl1{u@Y2oSt{9(u{cGPy z-}MO{+^aJF`;RV90}=HaI}RC)>)OMBRq8g|3<-$d@~-+;b~_Z_%Kp%*}!-wn`=bV0GOvaT|C&q^4 z6UNh|Yc>A-T^uc){b|_+@3<)On$?Fe9(o3V3y-PTr+sW}rkz1|7rd1@><^{2<3aM4 zZHP{;JyzxRzs+c`VJG4g-a~iJ!WIkmTh?cM&uH7?OXG0gehZ6U$mKSN_AI`sa5b$v zdg_>efDmN_H~V9FYy&P*ciC%j+&z%p5X+Py>f(`yakqOEE}7{MZu`TNtd`qeIWKZp z?--3DfBBka%*&{A0XQjT8W z%p6>$dZ#|Pne2o-&G?-zJ}IZ}Ni_ua9E!#@EM5vjAdIzJ*gYaYW#GN%NWiqwjk5=~ z9ojEO?Y(1++-)H9z6PQr*IH*(fgsk)XVAOOF`jztj1h$f6Px`}MNQTpG@vCBk5%zkpQQb(E7gR<(oG(3Q$XLhJO?VWK!5N2UbO(4OjzYfCpv6T64)) z-up}6W;99%e>38 z$&KTrqX^r=Q1~l&R_U_bW=G_VXF{G+u&cfImGKf^%2#kM5zBxLeaWZ7!{Su;0uxrr zhY#c=m?iQ*fyw@+B>8+~~BSyqEE3Zk{EK4~A``-H>$pru>cMjMaP=LBfm%N2?stl^) zR|c6)wQuI)Kf zSNcUP@8m^!l{S&Ipl<`NiyG2O80PJyT7|DWA5t?1eDPS1GI;e$BJoh_A9&DGI{GZm zOHqs$YPw)UrGSStU9}V;96G>mC5>#@w~ z7-Pqe0WN|$>Ew~s4b2FP)~EG`z?J-AeF0v+;4046jWDI(YIcygFrYx?chlL!xKJSO z>sV}QSOz@_xrkYSgL}kk+zPF)%BcVbOwYb>qQNcYm%h}We1a^hA5jdD5Cq#|O{fol z6#!byY~?K%hH{~k`m7e0Ok6+>NIrB&!*YDbdZ_VRPdy=apEw?Vsf{<}S;5JhH~7Z| zgsM!9ScO$(vmOk^GTbq`lpBm&aD zzIc`Y1nz=FsZ@9Tg%Ip4a*n1U>;GC>R9haP-5PB`WWq88q4Nn<(^DyN-t+F7_nJAvmdF=O_u zXhJ!zGNL0pE~gxHK*p^8B;J(Q`g#8O=P9S-J$!^#-htc|TP0r2u=jYds1WvK5!A$dw#8R>q?sTE&)CjHBB z^YyL^-cEWdqIDq8Bo${u^uhP^1@C%CeiZ^}*XX!4fq7V_s=x8svB8X0^!vU_C|wc+ z-zz!7@9I<&Fdr>OQ3Mm$c>G+<)qtkRnk8?b5?6SR7d{EWv8ROO3-C(%@XD)lpnXT_ zgG!pJA1LoB2l*MdT0m4j$uc?y(bmkse7!mrIi|{=98*kU|K#{m z#>>JB&HBZz;g==gds_R`Pw9rr{yeA3T7PHgVvK)fEeenMK#z5Ssif+=8YtENy&&dy2rm8@Hy8wA3vzpKyl3`|`U!#XtJ7i#go=+_?ANd*j*Xo(*>-ug0B>mfjsuNP2eKp$AW4fpzax zc#1dRGau{si6@?lYp=aNI(P4mOOO>TI=l^cwY|%@K;&XTRZEl@mOn`!Z;9is8SA9t z6_v}TD7^C5X$yq^i@ybz7pG6p^QU?-j_Etz#j^qZd&he&IGY_Kd*C9jV#I!4(wgZV5Zk-m(-?4d_Z^S zB`ltsaPzZ~KE7>7b{P|oDoNhn#Jr}SxyeR$q3YJq`Iz4tR^WaXx~p*31z9KD?9|tH z&-SKEyp`FK|bdW+UqqgysJ z=YiG;eEEIVaunzAL=&>2Bv1+OxnX^KwvQfty2UHWQ_QVauEjE*{()pEpMj4?KO3>0 z?@GV9FS-TU=a%Z<}Ud-P&=b05x>=)qYMeRjlUPxAm26R&I@+{cvc~u3}Os(0$eaRve@7_EN;9lXn>A$EYp^8t@gfr zee>_%pun380Dprp|DD$=)GJ|1p)hv<2nb%R*s;16_;wi^^t>U#Ru$U$M8ZH^7 z2EQt^3kn8()VURN6+&E2_MoW(fFbFhcmMZ)s^TfQe&C{aao)lGDY%ax$GHikh9zIS z8mv(0YP&QrROPL%6`bl?V!irrMdLjuO^SL}?H%70SZ~FJ!r5mWp8|y`v_7tsI*i}h zHgcke5^Eh>`JCi-#-Dl7X%&91kv3_opyb5C398G}<|ALV>i}oVAG|P?d{K{ob3ZTF`GqaFbRYI8aq&jGxxj2rp)> zvex>q1Fy6|XOK+%fS0UG_9~NfO(RQ_itl8?$D-h;E*NN?XlMQosC@Tcz7>{AKo=@h z61eDLrCEN3dn0Ci;FbIp%!ojlRid~{Kq1JyQ_0{YOnl9Qf4(;#C*9&8ZL}(_V>@ed zN0mSCOs|k^->3qkg2`jjM!Xb&6r8Oq^HBIrWdTj4ElO!4N>79I>4*T7-Hy`oNMIGL!^)v4aZT(gzo4V3aI9#K!neSZSK)57L zTX0B)4gj+(Wa{FSH0g+N$ihM#qj=%j@8VZ@#C*$l<5*4$0Tu;@WvKCdo(n)3T(n3YBX07I z@*vSSAn;k9&Q5rkOxZT4z4#(R9=jmeO(K1z)tJ#ENKo(*z5huT`9!wha?bn+fPzU3#V9#`WB9CPsQj-6V z{+5M5>kDBTYrC}ir5y5u)XTc$KKouGNneHPoCst+7hbPbWyW*-kq;|=FL^LgpkH!g zC@-aA(TV|{%6_e}+SpF1PoICa&z3QR{Sp6Mq_vJxfhi4)RQuV6#KT}Z%WQY$XYUQ! zw{f4}dG@vayt11S<8Gdc@ycX*s+rA%pmpD*2 zPd)uiESNiwg#-?w$Iow$PvEtl#rgDq&DkMs+4`^B9z(5|ncn_Zw{8zU^e_trSmQDA z&hlF@f|Fy*t^Qxxw>2NvqKHcJM+2@%R&t zFOSZ9c>(9EoDz>de1GQY`);^C8;^hOVMB)EFS$Rv3I@d=P}tpZ>+L{iJi;h|zHQJQkb%#Ie#(FF5=^srG3S|}jPb+94Qq(R*o0-V6Y6@d9s+8e4;eNj zcHeyx3d19C!!$N&nf(z!rEAii)be5VEKb$?l&N@5hUSC)wK!NtjC$06Lfd=inEC?|0l2P*Vp4-futK+9R zB_4i5p38BKNCj`NHJG&v$^K75(w3Z$KH^Xs#Fm&jdtMxJ@cwb+VIJ;_TnwJMXiA(G zoNJg?&(-zs6~H>yH@cR|(#8cJ-3zr2tw~Xlr}g*O-g{2lk68eyc5nE-s;d@Qc~j~~ z{_{~>sxjL%i9fvO`;o(j$HzYW5npGhcvBv#_}4M1!0`OKt}*rCgY#E?H(`|zAagvj zKXm-dbmlX3D0vO5GD+AK9laXQ_y-?wV6-`)upBST`x>JOv*58gw!uhX+X34Yoc&8& zWyYK*fsFW9ef(!Gxg`F4%PqNc$=ymn_~B)74vPrA*ik4g#ohBAjyd|M{F#Sk^P2P} zf)vfXd1qbaH}KM>%=<3>Kq>=mD!uylj0@iJcJ4~3=3SYndfD<#nAJ=2g3cl%?llTz zz7?ISnE#j83YVQ(?Ac{!&h}fdIM0VUY|6=TAaYta7N88$$GBDeH-fX&mjdo4cHCt2 zrCx29C|99T%2G^fbiJYXbpF7!B|ie9avcF&aT3ZZLsD>p3;qwR`}xAfjLFGU&QacE@#%G3|_-H-NYFH z&M%uWub;Tzu$Xq;vor|iH7hp6L-$UP7oVTYLA3M(p(0G=+Yy3lHAHgNy!GYgsftdGG%`-2-eIp+pb1yk(pR@h zDf2>aSyvfa?UHrWfp+HDk@|xAuJQXD9*XHt&x*s3IUq)l-!axSHN+aWn>RJFlaR6~ z*SHWcpl9EdYw!Ql!&XV+?m~N)F1TDGj)q&-c_(%$bVIqnit;(ZU9)s`bZW<9DD|R0 z{yNIv*oHDQHy$#2+jwC!3o+;$*0Ymf_KS;R#P}YugtHYl(r0LN&;=J@^&HH5%g=6! z=Eduy4LECjFl^U>lo9zI{Y6{nwBRD$Y^%;QIc_j_ODKaY|F*;6P5$e_PJ;%CqD+A9 z;+PK}5q*btrJv9#mHiq!OmX|#1fR5FF{5G8x|oTpqQQgvMtyhWPZm_#FgLfa>B@Nw zYds7Y-cv@?*MGW6gWkGH({MmTJ$E%2zau#04h{3?fAy;jntAhP_%Bkx>HC}EA3y;I zI$g2Y-J~*%XIHcwC=B_RKQeH6vo%u(atC4;0lcr`duxZ7ulQE1t?0a~PKpn{a}cs| zDiGT_+JUEVVB-Lv9L)W0eBadaNvkM?5`zL%4rrwJzICVuyG##^Ob;Y+_FWace>7fU$4XwW-926ocAS9o)SpG&-7(raxkvyw?rw32(uEND)<#WT9-|v z5(mM9m(QsbL7ACX271eA2mQ|+MhqPk!`M1$StOl&Tj?w5M~-CTz8#bQCHPhE9(UhyH*N)%B2f2bwH}2l^`Rn)noNkPkY*rh!vQ|Bf|Esm zIRMf$^q-#tHTP-Zt#Fa=5d=_%iFD=i#d{}*3Qlh0Q*m#dnV*V!2gDRwD2WyaEo}}k zDw`ll##O*zY)-nA{y>Y`qzZ8KIfx>NL04tI*6ENmaZw>&XsPg4tWBl2*0i}$pduNe zM?p&pn6Bi@wDasjyR!Q)o)%Jon-u zFyC8dC)36^ZVGIC^9@`o;mY*CeU6ipN{cgziTLa<3fJ%4ULU}J=NIzq$Q1e>o>Ef!*!nl6V{so}M z&qX6*%2Nr?zL9vzCq!0xUWixHncnuEeF_iKQn#tLH?6M?jv+~FzWue_BK^gz#1puE zyzffASZ4FGuPax}my39$kv0ZtQt~Njg<*RWaMDY73CA(LhKDmqLiXiEk`A^3eenM4 zrT<)yX^<0(#jpNRj4Ir8+}(^0h794y=)oo zgC1isWJoGhjGJ5Jx&G+K{~mK@;tItBbelP(5EluR%=*=@ehuaS159Y~%S|~>f9u<@ zn!T8_X@+MUnMCS8`~-`2Fo=0;)n{K&EbB|zt?!P|qiXLB__xhK0%>i0c_jJ5#ZI4j zzsKag;@IPk<50Y9V>{eT3>eTadi3bQ?x0?YXW7nP10?_v0HM-GOIs^1OPo~nB^#I{ z`GLR5EJN}V&+@QoeCIfnJj_!mPbSWGk-SbE+lcX`gjJnwn>LZ?5Zz~iId++;@ufr6 z4&`}&24Tua_9fLgU$rCq2FGu@|CD=je1onzzL7i^bog#Nb^NjfZkB2JZvTXWsq|B& zZ?ZqD+AnD3_$%I7Hv0hJ``)1IyOeeK?)YP0U|i#9grKNsACv|J#LZolNtY~kj!V+} zpCMFO?8sSK?|$dmu^Lxa-B>{My>;WS^nL$*Y)x+++vc4^dG9=`Is~}F;k7wbd3((O zoYrxbx%`ql()nUtr~F%spK+ygtqcVY&;D;k|0 zl0vVFrz`lvsQN?UW;-K|J7h9nz9(;4z@(G(&fDZ;Ii|wTd|PlMQuW^JtMMr1%iXxZ zZ<+IxFRUNKh7F2ueC_LTE=vElSp3hPIX%Acxi4}K%vZq`8J4yuylnHO_yr;I$qids z^wQp{&(*y3;tzf}9%koKJv*VA)-=SweC7M>f*71TDw5}Gc$eaq)LYBpTT5JMS#HX6 z>5KRvasG)yRo?@*=^r2e=tVJe#vB#^`bXbhJrc{RY!yHJcTk7y87lrx9;Y3pT!ykY zjj-w8@<3j#)#=-$n)8RkGo?>-4q>oAav`n>-|5YqpS6j};)YH5RHq;Fe4h3A-*1P4 znGrhWvMtElDwP{?K|ALq+`)9%7^^wcUdH9deFxJ&xiG24e^WG2-lrd$9e3UQXgvSO492ES zarVa!i^&J?n)8Deoef2BT*x2%to;ToFuJwH#mNhbnKzosmp9{i#Lq)E&5Vd}v1OckZN^c-SCt;(P@DnP(%u{&Ob^ zd2Pffu2V-`7U>Gpp;sY=y4!+`KxW{&K6-H|bRB0uX+Y^bBV9W4)djUT!yBW(n-qIv z^!mH8-3Fb5H2t;g+5{7O&CbYcZLE9kke7o_4RR$&nr`cT5gLS4b_SHl2`8oaBGjt@ z%0Nc7yV|2&nE7wb*}InbwQm(3MIfRKbe>h3>Y9bf_X#=+wH0c4mvCC8EpYr+VpjRo zApG4+rl{dv;gDAgRES&XOT-pBBe?s`&nhDofXrHY`mc~FA#bGt_*%An>!0erhFy78 zr77`*U&?Bvt+X;9%bc{T#W6;Of62r*TSI|do--aW48l=BaI%wwKl!LgP+4nG*z|oK zs_BbF%A0?-AdiAv`44i?5GIw96{#v3l%l_ehyP!SBh3_Y`}Xb;d+)PnTzlR1(XVI! znDx@k`17A{i?iN#3Un)ZNz>F-fQxnIK%>9eEeH>cC!h!>Ug4Yi&MHRDoVLeU?0bVs zqMTs*3=H9IR2j`A#=+8{Kxg4RAlNc>^k5}=+znW9%a`Wu#B=Ke+DUn7xeCaZNxYnt zsxWhbQ9e-lpGqp;S^t*DNj|bn!gEj---4G)v%)JXTc!C%=wuL<z|LH_d!I+lCW z`#P<+`H%{6(lvSb4hm}V7lz7jgOg+^kP2!Av$~vwyC7gK3r9LRVa%*Djd!L~A*m}6 z%aw4XtAYq|-HPg@%Uu%E#N7~^3DhRS(5N5xkuqu6R^LNPfSIa88(jTa?lWj#wdBU*c&xaWa^vWmEB;)`7g!ny@oMw|IJRbhcA_ zWoeRhu-;7Xf>E)cRw3?Ul2^A?R|`%Z;G0xLfRhS$-B^i7(oMqhlU&6mmGqXE#f2hU z_7s%8FT7@bYTePu`4Hl5V&h6*gY=U3bxmYBO{Y~-73$rALXbBtd!f%75Eu<@2??1yeHsR*O=h_94-&-Df{< zG=lGiW54f8Xwo2Y6KBT*+m7wi1ce7oXIX0?%&r8kMibv`E5tFq<*V>9Z#ULkmf!yF z29ydfvOBE@?%meLCqDnhxai#%084;1%2J+Olz}%?&U)bQJKp~Gxa#Vw8K3MUJH&Or z`Zb3=ehgPT-DAQ|BEma9-sf>*El=iw&>6m zYxyh}bNQM}30+u-&wB8YF#rDJ%j2Mfr^Jo}`%#9?F=N*J_|Eq)%Y%mNuzZuZB%-^s zl9=GG!dk_93G`jA@)26d#EtZkHa&28<>B-%;jY369!hui+fL8EA}L;LcZL3m=F{Z#z?s%zqg-~Aq*Va%-Y zt3H>-VL9%1{=h-=($R&nlQ}f`hnIa1i%66(l-Gj~J0Q!?nZFPNf_o^Z@o<;MA$qc! zWs>(DA9TUcv$wv~;Z-NQo?8G67yB|mr|d^~7{AlF`0aJq=J&QtkT1IE!t^0+yyPqE zMc`aaGi&y|JOgFo&O5=Ej0w_(e_l&O{#Niwm)yg%1`Am)t>BR;+mR5wFG^PGF{7HP z^;0M%jSS|Kaz#Ek24vF2)s(^_NrsYTNoN+B4cDr-Fp{rxys&-IJ|w1Wl4B6xTrhVr zP=%K9a(ri@uj(suJmGtev+^H#Qw6!W?bu)96+Tmjp&Ec=&LwXVH;yV6lIKr;w9V)E zY~_j<|5a$)FS&4@JNkf;<1MsN&dS2@$A4Q7TsNnGo*_kco+gyQPE30XV zTz&=5^0&Ygj(1sBcu~U~eV?Cx+KDj(w?$w6@)waW+sBU>0|pHm92Z}FAtMhw&LF2t z5tC!+5leVXI;(xpq|OJDg~Tz&O5(GJ%k>sWOD#78cPbIv~_)3>&^6+i2$ z3N3Wym2ah)?{v|@O+I_wnxabi&v7mI;|Co@_P8-45~|q(b#@{?m(yquRRVK6Sq8sOBr16tY5%lg0-rAz_$ZW!lhI%-mjORH^pxIkBP@{ z6|`o?azM9>JFmDS9=Yr3=+V0yi~k%ZjIw>z%7$1mYbi`x;}him*)x{Jl*2l*^Bt>u z%2>yk-Ue&%w0j^&CYsDgLDqiU{@(cp@pNeuO~rS;baT#8WKz!8!$nP}9lOQ4>Btc9 z<*zQgIUc+BX?6;(izUk%Vw*Aj;}c&x8|(CrwH>s&v1y;)1=i#CNB4vJ*=dj4r5B%? z&EQ3eSis-NV!}OF+#mP<{?X{MeedYMeV?39Y(@@S`pSw}F?V@vLgB9R-`xkU8ti=R zWX?O-0X@SC#=ipB9j`lbpzm{SpQ7F{j9S$g-+KQ~W7|P}W990#v1ZZgIO^T|#i{R@ z5~GH17vm1!DW19dv0$55tax;OeD$I$V*I|NiQg;MEL#^(-Gz&$rx!+>&d7gOZ(Vat zK7CU3+_n=3@UA9b=Ed+y6LUj%qBuU=S84ID0-jsiFMSug6}QxFia`_m$KxY=M&mSm z;UXWsa`)``)$*J2aA@hN(ctoV%VRmaFju^^G#4tiP?yu6dO3DFXb}7i4^mI=d^fL7 ztVFJER6YbbSf~>&a@Vsfyeq~PYgu?fQs6!9fH|kQIA6#~HgSEH&()8-8QvHLAl;kc zA4P%my9@U^;5lHVpF1B6wX5%68>)9+{puCIF85q>@PxrD0p0WpAHL6c=I2X7iX;h# zJFm50>->3@X{)?4A%Id)5{4086BKT${K~Z^Sk>Yu&LZP;4Vx-&-!`I`AeHxJ_$lP@$){do%|}i>Q@^mtLMbG`eq`cx8PC`D!BWt z_FUj^g;~K!x=9h@Rxpyz;N#Wz#?@M-wrNST&thVP|E-M$Y#9P|Ma?VEB>9d#~vt2@rB1A)DEk^>u>x+(!Ns2q#_(V z(&9o^sL4G7b>Lc$60=tAd_*ycyGJdYT@BX{fBL>ALL)vEa}vOPldJp)TsNR>CQAl24nge7Kt<21!pyXRLqgiJQVtboz}7p&Mq*h$Td$Vr5>o7 zlVxyr5^Fq_!`@5NoM;0-{p*pPu-w@oo~ElNv(h*<16)*es}z%t4ysOorIGNeGFv8L zy9Lkq!c_sUvf9aYDi4V7PK8v8fw$$%ZTRG&vfFsV5Ps5+G8or|3h{CWMOqF*d+C@~ z9|&;Pjo-w_y2x@?bONq{Px)SjdDVu@$2_&TmCkNytqwLyg#fU$a5r)8-pH~8PhgZ! z5~WKL(+Z34uyV$=?xdlM2OeCjG9h<8kfz`(4^md}F>mB26z2MxEbvqDpulW=gh*kL zWtLxB+GjMvJLWGWVa#EW-+SAk+3<#x#$KJr`Ai0tb*(ARp< z#ZYCbS@1$8rhetOgh$;LJ|%zXWPPu%UFD0^ms13B%W^$d_!UNo5%IcBmc-_*0DS#@5(ohW%f4)d9}31 z(&qf;;!@$w(s${Fr6}b}dA5$Bg;3T_d85PJF)n-KE{q47Z+Z5 zL4t4xpK0@fROaVoRYkIGXZPJF#6eRJW$|?#V?)Q7KX*o4aphISY!fHGps6p~^d`5L5!`xie*OFPjklh5TDs!# z@YzQmxGxSn;)pomt!Kx8AM9r#>AEQ82ih(VypGy|QRo{OPtk@q>SH9Dn=?apsw4 za%$|e-+?iCuYKZ#V~>yPuDOanb{*w)ccgtg z{a{u&K78p*R<2n?zsv$H_)OS&Vsunt4}L1Pv?P1{>F46)Q%{YBbLYZus@d8^LqkKl z#K;{6)Jav=!Gi~9S(P;&dH9jI4&#HB$RE$YFg@%U|+n z@>#7swWP!^{AF50<}1$pq(o~te$V{)IO?PXLm}KkTJx= zx}vcNPq+r}eGq1a$D@xw7C*WCC&+Xgu+VLYbKiD$eCqR;BtE7QKZAXUeT`{f8!T%A zCT^jnF{BNBUCmuof%4jv{|wKCI#oI4jek_AkuLcyYk?QSPkEb(AtPyQ#L`+r6kW|| zb*;bmj+{HtfiX*ZYh3EWPoC?=D(42~MUCvbTh-thd(I1*bIzGQ*CFy6ET=c2G4F!1 zeKU$!7#Tjm<%`B#Id^4uT!+q4*QHz3b?qK)F$k!`SfH)HE*Pw^$neUXmEh>S59@6D z)pfYInY`bK=rd^`%tL>T<+kHFon>sh$DkNFVLQgl)!FfHU}xcWL%YWXZu?>R6!48V<&W#(*)wewfUf=A}Yi+8*bv+kb}%U@iEK??1J4qIjZ$V11+{s-;_ zkHXIyFDP<2Xiz3yYLV?y@dFtKM4ZDCPl3*}GVqRlCbY(d_vW?{fX&Ksef^Ek&5=jp3( zM|jW?lcVp%ZDJD!3hu6G!)}MoYcVvy@_pJ(&&IPiJQ>gb@%dQt^kQ7*WgYFW$AU)*Y3NIitgk4QWh2rkQ((dRH)+8?NNz(z#dS${iZjgR#;`BT`=ieJJey~03rpTQT9?rbWX%nJNU+UYw zi=9U+o?8_6{P^y;`vvO6_g02hV@K5U#+c>1dD*}WRXXnzgBCoio6@i<{BnXyjtW!`_?7Y^VG4vGY@aQVO6{s~`YqpQ zoEie&=X?GbNZb;KN3qBOIKdTM5K(G*RQd2R3uI0V0DKol!l?=>Yy(k?TBMe*uM$^t zD*5?rp81}46{eEAs;`P}IRP>q^vIB4GGcl5TgwOQrS??I!%tN{Ubk9XZOz{@6-7eE z&iGECbMg&1A(~cN|Nku{Z`8_f*(W zMo7|H%}HwKuI)+ZjsmtSqEK}}^WONj<#t%-Z(s|jR`#xni65rhvX53)3(LN+bG zX-Oxp7FY{%Cox%e<58|WTfvDu`M0kr|Ak}z!ji70Y1_Ui0kz&pxZu-Nvl`C{zOZVR z=$6xiK%IQsw<^*ZM?u7Va#ut?16Kt(va);d|PMaxw2DEjvzln-Awr@ zhoq-S1gOK{`55* z19pD<>7V+^_K8n?vVHaTFT;yz`tN<@?MuP!_}N8@%^ce>g9X`6tO_l#SXlxwiK2cI znVWYEi?aWJz3UI#eeQpscGAi07`*AG_TKk@u)Y7i?`gZXGiipOUO>18xX*w7v+WC? zyRJR-As5j`(%ubudF-RFfM-sn%wTJ;`o34S6Hh*=eVI$Y_wL%!p8MPvwBPw3ztt|j z_@ee5DD>a+-gm>R&F#0|{G09lTvB@a$)~lW*cCL7lH~T=?|_Dzvv^T$OlvoM;l|*W zb0r^sDusSmz0}{@sJs|2^&SwaSNse&N-u-dT;wRy6Ct#F@(k@;R{qKt=7+Za=JEU$!RYy~+EaVsoXXctQQ z%fFZxqY@W@JtgyXF{r1nm0qdvjsA*Mlm5v`hk1I6% zpZ_N3m9#Dk3WAqpkGt_=k-w3v@U)=D`6jI4y6)ef1-;^5K;3u6zr%}X{9VXM2#MHV zR2f#8r;ZI}X#Zin9yetUybEK->GO*oUi1n-MhmazVjQM;)Fo+}%-WRCRmY4f(-89`E_l$?Ow_pkGu{Q`1sqv${_hURT z2uo$t!2v;9((Bf8N$&-hox{Q}hG+DJ+=QJzaAx{Id)iAbZ~x<#ceedsW`_c4t>JwA zD_{I*#`umG8CXFFSzzb+Y`f?YC%2=2?rH7azx}cH4_DvDF)_^QT&Ny7jF+~~v+yWfuWhrH&3(Y0e9F=7 z{*O7kUGx6y5Hyb3Jb|hgmr2KCOH&rimAr4t{$(%9^wYK--G2CWFKmDG=BwJZe|bY& zx`UmRR<;lZaj9FBEdAPnS<-=}6DMwNkNWP*+P{6}leq+$1s)U-&WpUy?ZAE}ca+yz z+m30^{lP2STYu>TZ7&NW9H?(aYHOKGZR9wmCp`T!3>Z+(vv_dYshiqs{?qf@+kfLj z?S?Vsy%>(pY^YPSo_rf`ujHj`R&QGyNq0vAtH-7l)YnD z@Luq3=eCDG?ZS5a@l$R4-krp^UBx&9;yhw%4x=!~2llb)gHmPh6c3z9*kO zl>xXfpoDkQz|VJA{_9wWnk4Dpt+&MWzl$5s|F=T(>iB+J)~BC(a=YS+E808W{`>9p zv(9S&_{Ce=|K#X}*L?pg)9Gkgq0+~*U-x5ez-Qz#a*80S;Gg4Il1*FaP?T57#fyRW z@5OSP6=}B|dVI<>7nVk8igL^%Tf~yW$*Oof_9e8Fm58lZFEm z6}2i*a~8b9LqF?8R~d`!@$K2^9?01}9 zQ7>I8t+Q%xI|3=5?Kg=fx{DI>#vKz~@oufda3HuwI~;&R+`(f$p%Xk#@?BJ!qCED4 zFAFrJucDe^F@uE~gt;R`x}s1h@`C_*K!(3Vg!00L2lKfPTn^G~HEe5Dstcoz2QbRn zGZ71x5lj{-EYt9X0aw~c{2i1|klqptLCTwaQQpii<4N*{yihK&o;DxA#sVH5*k%ZC zxZ}uq7Kc2aU$Wi7pu$PHRMF*@UakMN%6C!8-71ot-6-T4%*dh(M_RhMxS@CSQKR~AgNP$TY=ANj6= z-vu$pp?lfJ>H^jzdCFi9o<>ffRXLmo&osFA&K_ug_Gf>Q`lFaFF(CA8^l$&RM+0e5 zth9ykxQBnt)4k#BQ@$Q9tM9#&%D;@#Y_}H$dA8nLmvpdh;C;!m##E7c1j0N;(MP>8 zkCs`7Ph9?3@06Fd$ctsE%$H(fP@o}K)I@T6Ch||hGGDqx>R-t; z3!%@5;Q(|o>9Mc6@(Gu>Cq3;M?S1e3Jr?3NwQH~WyY{J%|6RNM(U-PYyzIp}$MwH( ziRR5Wev!6=i6&>YS~jPga$0-YE5EN@_K=I))1Llxk}Q6hR}+?pCmefpd)FVmv;F9g z{doKMUw^#q*nSr@qeNg*wE;`gM_%^G_A{@2ZF|#ydt>|J_1A)z%Ws*aS*Buh5ocMe zHjlle!Q8n6rTgIIiM&%J%%{A#&-v$YM)e!oD_;337JxYq77McLq5C>6?JZsoG8Epd z;X>du+w-6M{C36T9vwUvUvyFXz@qGYe%=dS*xvHy-=v?Ofewx@`@(gU zB|?U<96VtEL*0RwuYKLmwa?ygeY^Sk&(m&CWs%^vTW&?hluruXX9SF+lDH)Lm9O}| z_5-hZb>c_a&zorno~Q4+Au7+R$NE}>BC>qQ_j360WnJ;kF=3*l!Osb_@s%0zj?yuc zATTNGVa6uZ4^wafxZ^giUke>BAh5(eIV;$>+X=vP_!GT3k z?F4afwqK4dvIqh_rlIrAd>@XkIAA%K%=J3}DZ0TduQ5FD2lbr zo^(!ya(4RY4OsAR#tMEH#}6^@bRI~1xQEMb&%gh%?R#JMo$czsxSnLzx6`?l_U!v? zW|zWVXm)E|EU?t9U; zcFy@HaU{?pa|?C^*j967&C$ngZZG-aC%0?==7x6W{kO4m?<{s9a9;tuSY^ZXbKpHC*Jou3h?&`#}dgCbZnAW|cfLk#2MCg)hIdJ>lCfW0&5Y=|9dm z?f7=$8C#gMtZ6&9?_e&%od(SJjXBGO*v_kG7{6%|@3?FOyuWkDo$bWaHnms%#53DJ zeDU`787%W}x$d@h+f8>c|KTVm=BX1bJWO#s&xxlW*Umck=BmO1Ns^1i!0D>~XK`s~d(6`x)NVQVxEM~H!h*tj+JpuASj$ht!Hj3&amEj{ z`OC=V{U3EkJLCKl+YO(*wcYlaJKDmXp1g3NZ8~mK+sZDBZI_(dwq0;SJN^_FwAdkW z*RH#`X967L4+1cHWM=^@5FUB7u$QByDC_AB)AaMq9rr9!w(Jl`-lp00YOTqg42;V> za>}`a?Qw4{txo}>T#mSV#sNy0NI;*Q!F;KWt z;Q;C#{Rridp(3dU6^4z&jlUbV+L)_^2OJ3BbwTOV> zDrr5FQw2^<5FPkamc-RUOl~rdr?UqZKPQ<}to##$0hWqt2W~1^-5%!zi2j>NsiIOl z1?t_joXAR(a+tI4R0=aFP${c|tB#Lh!pi{A!JwVLXQ$iY+QF$@jY6J5m+valwHQ$e zjTl3x)&r&RxATpX-MG-A0@(?-my}7QeWY=;u2->ZUGA5(dNh(?QOY`*9&pT|e3pI{ z+F3Yp?1W3bqRq1-7Ke&zO%BU~j{4@Le^8VQ%EVXZ<=8swAs zbvgfD)X=QFtAIGjz^;_zmV_{A9MEN}KX_fdD1HOSz{hxLuL)B*ksTDo z_lO-ABwWnUDp5F77S_5ri5y6qXQwMC@?6EH`1v2Dw~B1b)q%YER4)?CXyE5i)T=Oa zu|~Y|%X~?6m6yD9=Rt*={tWjCSdP*-!)_9*yZ%lFRCb8RayQ4~Q^670W}sxbORxU& z*Ldb_EsF)ESgjof3oL3aA*-JIsJthAWPs>Is{Bt;E=wNMgY3EsKzWj<)&phKyk_Bu zD3-r6B}|k?)VGb~Vc1SRZfR!uDg*+r!0T4|>1_ z?Sco~r{F+neyenO`B&o1LtGg4|1VLwpb-+Rx0!5@lLq6I2W3I0a?A1!*@pQ7ylsPR zkaFF#CVa|F`A3dykHD1ju$Dv#N8I2Z(y?9OHLlW4A|-pKL%q^f8>50)Vymr+AMw!- z$C0dn_2acGOZ6JvgHxcQC?_~?%AwA>Q+cm8&aqXe(YD)i6sC`J?60ft4>&-E7xWKg zh*tv0fBiL;^2(Smb!bid;UDvXLD{|m?7e5~zZA|1vPPi6NEm;Ii1{`u{xS3ae^=zCw#&fa!ra4KhV z`oR}n(BAy(zuFeCjQl68?eF3UAt#b2pK>yH0UeWk%`jP1nh*}?-5fu8{gXfQGr27J zT_5;Bn@6#qMPDIFcZ!RaFTeb9j#B#BcHsl>$8klEXrJK{=8c<~(4Jj1IQI3YtoZ!p zH@*=|zRm5e?|56AW#@p#Ko4Y*;(MO+!uIkXczMz_&kwlZKJ6nP`cQivJ2w6&ymBXq z!bDKqIwr#>FkZQmBba{Z`@g?kc;WrxZ#s}2UPfQ-2d;QKw9$OaUwLh4pEDGs&?Q5m znfQSvVd0|uPa2k&Bo$6&&gy775kme(>BqPCA4qoOmuDqB&`DSp_g_9_T~=bh#Lh()|KSKuM|Px#Frm4G9k3k|osL&TEGRGVUv| zQT@6*Tm#C;N%D(Fr%P16_js${Q;$R-+`yx8e7=W;tN0}zz3lI0yk%2qRcymnXc!_7 ze$pbmuG8cD3CADrBW2wA;H9;_q2q}$(8KDr`bPQZV1qU$ zjhAC$=RuYoZ4zZNL%*v9_8ivZ%W88eCfnQ^yF2e-940Ji7FbN5TbkoH+a?aMJAm=o zdhU{SEWTsU&b9$uPk!#j?c1LHK-$W+9OW`a`phYu=raGUxg$CeaL&5$Kx4d@V`WsH z&o6LxzhiyobRN&6yf`k}ySTHRao?GC)&nk~&7Ne8fkJs<7c#>!qa0o1TU2)#8aNmcV*e-d@nH=$g@saa#+EI64&!Pn1%~-&B)%4U%l<&^h_s;KV7d+(T zcFDuHF&>;?@ngQtv)JMJ|LZ46Y~bS#`txa&<5#lVVJ&U7M-_P*fJgqtIGy>O?fESJ z_C=?jwWXbR0rwqoroVR~+<7NE_vW0xnpfssjIp9$VfXq078>SN3}}*0+yn6GAiS7g zW}$$^kTcKQ+RnPqrSK0!racSLOqrn{aQC@+*m}%HijTQJeB8D3j;i;A~@4H+NQHnXi$Y^H6>^7yAy(x9P2G+C!gl-*)kLoDct4gdvBUwr-;An9~z) z7Gsd@ckUs73-EKgO)__%C!Z7E?*`q=(6S%C%4_A_9s3i?|IAcdq)c;{1w1~0Jh&sk zx}uSqWk><0E~H&MwAneV+LCWIv#|AuySF&tb}k3f%B9YZxMb1+Y)uvtfY9ncJ}{_G zbbuauRMEtTKf=~`4SH+fWz{SvT0Jg>U(quKD-UTiBF1lPJ@rUwR#o&2wI3wL+u~ z%@W~4kY$$15Z~Pr(l8g3MC5?lvRvz69C}oST25YATw8jJjw$%z&myyXR`xyy@{}irezaM#5_H3gT*?D4_EMRRk z%`OBbN}Y%0Pzw?+c9;kF;(!w#o0jKzdx@6HwFS;G-L!>E%_#pYm;mdJ1^dNKo28$3 z+jHoC|5YDpdw1N0CGW$7ZCeb_@T;n)t~m|Vo#se}+({`ENP(Z3eAa!DWMNja3F zyr|2<9%US*93)#_mZi@qI0!Q*Sr|lil>z=oF0|;fjwvJJ@uF|D?IgoFg}bSoAXtwq zOB;Z+JJxyXnQ5l|QMQP`pGdYb!s#E!!(o*4C{oH{>b~ug^@R2=5%_B#Xk4hEt{AxD zq}hDvLN8yoi76(Y`lWr94(f-CTB*=Pln;jcOneAQ+ir6FGRzYfw2QBJWP-&H}{S0NdYw+4||H zoX9S^lR}ad_~Q7*cJJmJZlZnLfK}TZw49avnO7IB-}XEIor?nRL_XGYDeuw2Ee&$e zeCkq1c-2pQkA2J|Ioj(HEI8c84uI>irrS3UkWN7sJlv(W4LxeFW%cvjMNLV4&$l1gD!68odc{y;y(P5KWSgO>E?Fa@h7!YxxBciTcIV#TQ<$)o`j$Li63vb z+6Inz!y{KH483r|0-Zz`JXkCXuyrF%Ks9$2o{ zX~)eO)96Q>>VH8TJjz8+3;ggrI~fReXF*?-6PH!VzD-_8N7@|X8pm;g{X+UmAbR@d z%Qi#4*&Z0rI=jzt6XP)nwC!` z&R==NYZUIw7z@Y4J50ytcX#9I=yymwKf2@9auSC>;~8AC<{}(2!uU&noe#z47rWy~1^3)ul&36+s{Eft5vz5+ZK~ru$33&m52mIz(+;j{Tc@_PiRE=| zFMZwuid+la`vpDjZi!ui^Sk!8DUJhTC;-e7Pj>8aEDJ3y;{f_A+US`LQz)>pF30lT zvNA2l2Wg8b%tdw;sJvazZUy^}1B~%KPDhzYxvQvVjwhY!X6E*|J8$qKoqg;`aF^f` zi-wcjPP{xhowNDZpk!CcJ+XdTDQQdl7ogj`^1cscKRCUpSBrXgI#05b-tofHZWQOv zmza~!gL4gv`Q2Zg%f-PiDBH(4NAqrkW#DP~)3+_5-2dwKJKN0CblNX>HLk}GPvLuuCTDOA+#L56(fxe_N{B% z?p?DSN9fK>4fdE9(N7&9KaL?6-0eVmn;1u!zj-`oxGT!}srg&j#Xm{9hb&#XLK+sH$ zJOoXDs#o3zEWMK*o)s$Wq2WWMA?=m$4xdh^fAH+_yO$GzBH+-l9xwUpY4%9Nb2To# zSNn~B``-Dn;$H)l;$t;X@~7y6zx*@D1ABtM@X(0Spt{aE!ev(YXM@t61Hp_@y2p?g zKRZ1=et#M^%D->}tp2(V7aGfJTrrQa!LbjzE>+h65+7? zV;R!fqg?sUXMJb8>Q6sRN3qn7KK_{YYrppYaQ5)iGf1kz(@@?p(@xll<$7j(T02;m z?Vw!{@M0mY|5ezkz@0+zyR4Fy3l}3V#CKq{28#h@NSI!0En~~d^i(jZIQ852C6vU* zGhHuGRrzmOyOq&JgB)=~Iv$fjmJ%`6vBWo?0}^*9c;LO?D&9;_8pLVeD9zRgC%lzs zVDah;6^=8FOYneO{)Gnfk_mlTk{d4Nu?XyN<`GY6mB%gyNT20hc#7}l!SF@-E4`#= z-lbcf5#2FE!pumld-1m>saR175vyp*-HDTfH{raGAozxIHcgTTFWKiMd4nG*7xd&R z6$D7S;5JVgcOvo?$507}V+;S`d11HPLvRGa&I@Vd8{7`cp%fgKcT>*W1Sg9Qkty2XaoUqNqHi@mL8C|KPWEqPG>6 zqcb8)-?k$a#6rP2C&*$~+7jdqoK6b7U^B8qp;})|#-Dwib=gHe{Vi|nig=ZqgQ*uF zCK=N;>C{8ZlvithPs67!3PRdWyF%N}oHJ?wi2Wy`ey*_II&tR-a^FK=fhN7=6aVzh zjD%er)VaV>v{k%(gkOczyoWW4`H+V3LNoMcVZ^6?W8w1g6coJQ`Sd3xOxjD9ZF>it zAT)WM3y&q|Ll`jPI0q~AAL6`!U9STs6W;Qy-8RBXpuDU_>UY2E-QadnkqPWk$Fd9I z(u6x1)eXapw0TZ)9aG2~+e9bE*L?oE_StK%r7mL?hDF`O9`=Z2P#VpUb@}8IPYfGB>$T!%9ZAj|M7E)c%< z8jdTXuqL=C;Nh1((x@Yvr1wD=J|MpYjQug)@D}=y;YgulFS&T2-*nA(QIZFL%$M$z zlTOIb_Yn?123N5P_?TmkYR4S&;2w0yGuEJ~pMx+EYVH#gB>IZ0(_!Sut$ayH@kM`~ z<6I}+RaW)1jI9*%SEl75Ec^;?-hB>PL*re5T&e zrwS)d74W8z{*Le(gXlwE(ry?rAR!{O6W1}2ch)$*5V16g-!f3NLYL8a_a_ehbjnTT zVFk`{o_(hMQQDitvmW~5n1Ba)k-v^Brm;-yi~3@;e~YXng~R0!JeMbolY2dJaelmB zro0Ar^mog>mqp5k@5odC7-Qevc#VbD>p0 ^?7zb+SjgTfadrgpn@)^*r?S^%qy< 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 z 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�n+f6!EzQz>>zL=0zACR2SLV5@8ZC9 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 }$?q>9K<@pP&wb9M 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

Cty~ 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

ctXCht}vdfsJ0{ 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 D1o($TC^!DqEUYMup>j5P^GJaLW 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�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⋘z*`rawY`U?tpLF_u2e+jyNw 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≧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 i{quW3z}z$d9 new SomeService(container.commandBus)).as('someService'); -``` - -Container scans class constructors (or constructor functions) for dependencies and injects them, where possible: - -```js -class SomeRepository { /* ... */ } - -class ServiceA { - // dependency definition, as a parameter object property - constructor(options) { - this._repository = options.repository; - } -} - -class ServiceB { - // dependency defined thru parameter object destructuring - constructor({ repository, a }) { /* ... */ } -} - -class ServiceC { - constructor(repository, a, b) { /* ... */ } -} - -// dependencies passed thru factory -const serviceFactory = ({ repository, a, b }) => new ServiceC(repository, a, b); - -container.register(SomeRepository, 'repository'); -container.register(ServiceA, 'a'); -container.register(ServiceB, 'b'); -container.register(serviceFactory, 'c'); -``` - -Components that aren't going to be accessed directly by name can also be registered in the builder. Their instances will be created after invoking `container()` method: - -```js -builder.register(SomeEventObserver); -// at this point the registered observer does not exist - -const container = builder.container(); -// now it exists and got all its constructor dependencies -``` - - -DI container has a set of methods for CQRS components registration: - -* __registerAggregate(AggregateType)__ - registers aggregateCommandHandler, subscribes it to commandBus and wires Aggregate dependencies -* __registerSaga(SagaType)__ - registers sagaEventHandler, subscribes it to eventStore and wires Saga dependencies -* __registerProjection(ProjectionType, exposedViewName)__ - registers projection, subscribes it to eventStore and exposes associated projection view on the container -* __registerCommandHandler(typeOrFactory)__ - registers command handler and subscribes it to commandBus -* __registerEventReceptor(typeOrFactory)__ - registers event receptor and subscribes it to eventStore - - -Altogether: - -```js -const { ContainerBuilder, InMemoryEventStorage } = require('node-cqrs'); -const builder = new ContainerBuilder(); - -builder.registerAggregate(UserAggregate); - -// we are using non-persistent in-memory event storage, -// for a permanent storage you can look at https://www.npmjs.com/package/node-cqrs-mongo -builder.register(InMemoryEventStorage) - .as('storage'); - -// as an example of UserAggregate dependency -builder.register(AuthService) - .as('authService'); - -// setup command and event handler listeners -const container = builder.container(); - -// send a command -const aggregateId = undefined; -const payload = { profile: {}, password: '...' }; -const context = {}; -container.commandBus.send('signupUser', aggregateId, { payload, context }); - -container.eventStore.once('userSignedUp', event => { - console.log(`user aggregate created with ID ${event.aggregateId}`); -}); -``` - -In the above example, the command will be passed to an aggregate command handler, which will either restore an aggregate, or create a new one, and will invoke a corresponding method on the aggregate. - -After command processing is done, produced events will be committed to the eventStore, and emitted to subscribed projections and/or event receptors. diff --git a/docs/middleware/README.md b/docs/middleware/README.md deleted file mode 100644 index 5b49487..0000000 --- a/docs/middleware/README.md +++ /dev/null @@ -1,15 +0,0 @@ -# Middleware - -for wiring components together - -* [DI Container](DIContainer.md) - -for delivering messages to corresponding domain objects - -* [AggregateCommandHandler](AggregateCommandHandler.md) -* SagaEventHandler - -Messaging API to interact with: - -* EventStore -* CommandBus diff --git a/examples/user-domain-own-implementation/index.ts b/examples/user-domain-own-implementation/index.ts new file mode 100644 index 0000000..57bfe51 --- /dev/null +++ b/examples/user-domain-own-implementation/index.ts @@ -0,0 +1,198 @@ +/** + * Plain user domain implementation example without using the framework classes. + * + * - `UserAggregate` implementing write model + * - `UserProjection` implementing read model + * - In-memory `EventStore` + * - `CommandHandler` + * - Main function wiring everything together and sending test commands + */ + +import EventEmitter from 'events'; +import crypto from 'crypto'; +import type { + IAggregate, ICommand, ICommandHandler, Identifier, IEvent, IEventSet, IEventStorageReader, IEventStorageWriter, + IObservable, IProjection +} from '../../types'; + +const md5 = (v: string): string => crypto.createHash('md5').update(v).digest('hex'); + +/** + * Sample aggregate (write interface) + */ +class UserAggregate implements IAggregate { + + readonly id: any; + + /* inner aggregate state used for write operation validation */ + #state: { passwordHash?: string } = {}; + + constructor(id) { + this.id = id; + } + + /** Restore aggregate state from past events */ + mutate(event: IEvent): void { + if (event.type === 'userCreated' || event.type === 'userPasswordChanged') + this.#state.passwordHash = event.payload.passwordHash; + } + + /** Redirect command execution to a command handler */ + handle(command: ICommand): IEventSet { + return this[command.type](command.payload); + } + + createUser({ username, password }): IEventSet { + return [{ + type: 'userCreated', + aggregateId: this.id, + payload: { + username, + passwordHash: md5(password) + } + }]; + } + + changePassword({ oldPassword, newPassword }): IEventSet { + if (md5(oldPassword) !== this.#state.passwordHash) + throw new Error('Old password is incorrect'); + + return [{ + type: 'userPasswordChanged', + aggregateId: this.id, + payload: { + passwordHash: md5(newPassword) + } + }]; + } +} + +/** + * Sample projection (read model) + */ +class UserProjection implements IProjection> { + + /** View model */ + readonly view: Map = new Map(); + + /** Subscribe only to the event types that affect the read model */ + subscribe(eventStore: IObservable) { + eventStore.on('userCreated', e => this.userCreated(e.aggregateId, e.payload)); + } + + /** If the view is not persistent, restore it from past events */ + async restore(eventStore: IEventStorageReader) { + for await (const oldEvent of eventStore.getEventsByTypes(['userCreated'])) + this.project(oldEvent); + } + + /** Pass data to corresponding event handler */ + project(event: IEvent): void { + this[event.type](event.aggregateId, event.payload); + } + + userCreated(userId, { username }) { + this.view.set(userId, { username }); + } +} + +/** + * Dumb event store that keeps all events in memory + * and re-distributes them to all subscribers + */ +class EventStore extends EventEmitter implements IObservable, IEventStorageReader, IEventStorageWriter { + + #events: IEvent[] = []; + + async commitEvents(events: Readonly) { + this.#events.push(...events); + + for (const e of events) + this.emit(e.type, e); + + return events; + } + + async* getEventsByTypes(eventTypes: string[]) { + yield* this.#events.filter(e => eventTypes.includes(e.type)); + } + + async* getAggregateEvents(aggregateId: Identifier) { + yield* this.#events.filter(e => e.aggregateId === aggregateId); + } + + async* getSagaEvents(sagaId: Identifier) { + yield* this.#events.filter(e => e.sagaId === sagaId); + } +} + +/** + * Sample command handler that routes commands to corresponding aggregates + */ +class CommandHandler implements ICommandHandler { + + #eventStore: IEventStorageReader & IEventStorageWriter; + + constructor(eventStore) { + this.#eventStore = eventStore; + } + + subscribe(commandBus: IObservable): void { + commandBus.on('createUser', cmd => this.passCommandToAggregate(cmd)); + commandBus.on('changePassword', cmd => this.passCommandToAggregate(cmd)); + } + + async passCommandToAggregate(cmd) { + const userAggregate = new UserAggregate(cmd.aggregateId); + + // restore aggregate state from past events + const oldEvents = this.#eventStore.getAggregateEvents(cmd.aggregateId); + for await (const event of oldEvents) + userAggregate.mutate(event); + + // store new events + const newEvents = userAggregate.handle(cmd); + this.#eventStore.commitEvents(newEvents); + } +} + +/** + * Run the test + */ +(async function main() { + + // create and wire all instances together + + const commandBus = new EventEmitter(); + const eventStore = new EventStore(); + + const commandHandler = new CommandHandler(eventStore); + commandHandler.subscribe(commandBus); + + const projection = new UserProjection(); + projection.subscribe(eventStore); + projection.restore(eventStore); + + // send test commands + + commandBus.emit('createUser', { + aggregateId: '1', + type: 'createUser', + payload: { username: 'John', password: 'magic' } + }); + + commandBus.emit('changeUserPassword', { + aggregateId: '1', + type: 'changeUserPassword', + payload: { oldPassword: 'magic', newPassword: 'no magic' } + }); + + // wait for the command bus to finish processing + await new Promise(setImmediate); + + const userRecord = projection.view.get('1'); + + // eslint-disable-next-line no-console + console.log(userRecord); // { username: 'John' } + +}()); diff --git a/examples/user-domain-own-implementation/package.json b/examples/user-domain-own-implementation/package.json new file mode 100644 index 0000000..f938c85 --- /dev/null +++ b/examples/user-domain-own-implementation/package.json @@ -0,0 +1,7 @@ +{ + "type": "module", + "scripts": { + "start": "node index.ts", + "test": "node index.ts" + } +} \ No newline at end of file diff --git a/examples/user-domain-ts/index.ts b/examples/user-domain-ts/index.ts new file mode 100644 index 0000000..bc1beff --- /dev/null +++ b/examples/user-domain-ts/index.ts @@ -0,0 +1,95 @@ +import { + AbstractAggregate, + AbstractProjection, + ContainerBuilder, + IContainer, + IEvent, + InMemoryEventStorage +} from '../..'; +import * as crypto from 'crypto'; +const md5 = (v: string): string => crypto.createHash('md5').update(v).digest('hex'); + +type CreateUserCommandPayload = { username: string, password: string }; +type UserCreatedEventPayload = { username: string, passwordHash: string }; + +type ChangePasswordCommandPayload = { oldPassword: string, newPassword: string }; +type PasswordChangedEventPayload = { passwordHash: string }; + +class UserAggregateState { + passwordHash!: string; + + passwordChanged(event: IEvent) { + this.passwordHash = event.payload!.passwordHash; + } +} + +class UserAggregate extends AbstractAggregate { + + protected readonly state = new UserAggregateState(); + + createUser(payload: CreateUserCommandPayload) { + this.emit('userCreated', { + username: payload.username, + passwordHash: md5(payload.password) + }); + } + + changePassword(payload: ChangePasswordCommandPayload) { + if (md5(payload.oldPassword) !== this.state.passwordHash) + throw new Error('Invalid password'); + + this.emit('passwordChanged', { + passwordHash: md5(payload.newPassword) + }); + } +} + +type UsersView = Map; + +class UsersProjection extends AbstractProjection { + + constructor() { + super(); + this.view = new Map(); + } + + userCreated(event: IEvent) { + this.view.set(event.aggregateId as string, { + username: event.payload!.username + }); + } +} + +interface MyDiContainer extends IContainer { + users: UsersView; +} + +const builder = new ContainerBuilder(); + +// In-memory implementations for local dev/tests +builder.register(InMemoryEventStorage) + .as('eventStorageReader') + .as('eventStorageWriter'); +builder.register(() => console, 'logger'); +builder.registerAggregate(UserAggregate); +builder.registerProjection(UsersProjection, 'users'); + +const container = builder.container(); + + +(async function main() { + + const { users, commandBus } = container; + + const payload: CreateUserCommandPayload = { + username: 'john', + password: 'magic' + }; + + const [userCreated] = await commandBus.send('createUser', undefined, { payload }); + + const user = users.get(userCreated.aggregateId as string); + + // eslint-disable-next-line no-console + console.log(user); // { username: 'john' } +}()); diff --git a/examples/user-domain-tests/.eslintrc.json b/examples/user-domain/tests/.eslintrc.json similarity index 100% rename from examples/user-domain-tests/.eslintrc.json rename to examples/user-domain/tests/.eslintrc.json diff --git a/examples/user-domain-tests/index.test.js b/examples/user-domain/tests/index.test.js similarity index 97% rename from examples/user-domain-tests/index.test.js rename to examples/user-domain/tests/index.test.js index e5f4378..00f293e 100644 --- a/examples/user-domain-tests/index.test.js +++ b/examples/user-domain/tests/index.test.js @@ -1,7 +1,7 @@ 'use strict'; const { expect } = require('chai'); -const { createContainer, createBaseInstances } = require('../user-domain'); +const { createContainer, createBaseInstances } = require('..'); describe('user-domain example', () => { From cc172cddcae700aa77f61698548ae867ac89f553 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 28 Jan 2026 22:42:24 +0000 Subject: [PATCH 149/169] Remove obsolete files --- SUMMARY.md | 1 - book.json | 23 ----------------------- 2 files changed, 24 deletions(-) delete mode 120000 SUMMARY.md delete mode 100644 book.json diff --git a/SUMMARY.md b/SUMMARY.md deleted file mode 120000 index 0b731df..0000000 --- a/SUMMARY.md +++ /dev/null @@ -1 +0,0 @@ -./docs/README.md \ No newline at end of file diff --git a/book.json b/book.json deleted file mode 100644 index 0622b56..0000000 --- a/book.json +++ /dev/null @@ -1,23 +0,0 @@ -{ - "title": "node-cqrs", - "gitbook": "3.2.2", - "plugins": [ - "edit-link", - "github", - "anchorjs" - ], - "pluginsConfig": { - "edit-link": { - "base": "https://github.com/snatalenko/node-cqrs/tree/master", - "label": "Edit This Page" - }, - "github": { - "url": "https://github.com/snatalenko/node-cqrs/" - }, - "theme-default": { - "styles": { - "website": "build/gitbook.css" - } - } - } -} From 51999cc353b2d4e22f8576110e4ef981862f46a2 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 28 Jan 2026 23:17:24 +0000 Subject: [PATCH 150/169] Cleanup TS example --- examples/user-domain-ts/UserAggregate.ts | 36 +++++++++ examples/user-domain-ts/UsersProjection.ts | 18 +++++ examples/user-domain-ts/index.ts | 93 +++++----------------- examples/user-domain-ts/messages.ts | 10 +++ examples/user-domain-ts/utils.ts | 3 + 5 files changed, 86 insertions(+), 74 deletions(-) create mode 100644 examples/user-domain-ts/UserAggregate.ts create mode 100644 examples/user-domain-ts/UsersProjection.ts create mode 100644 examples/user-domain-ts/messages.ts create mode 100644 examples/user-domain-ts/utils.ts diff --git a/examples/user-domain-ts/UserAggregate.ts b/examples/user-domain-ts/UserAggregate.ts new file mode 100644 index 0000000..328b15e --- /dev/null +++ b/examples/user-domain-ts/UserAggregate.ts @@ -0,0 +1,36 @@ +import type { ChangePasswordCommandPayload, CreateUserCommandPayload, PasswordChangedEvent, UserCreatedEvent } from './messages'; +import { AbstractAggregate } from '../..'; +import { md5 } from './utils'; + +class UserAggregateState { + passwordHash!: string; + + userCreated(event: UserCreatedEvent) { + this.passwordHash = event.payload!.passwordHash; + } + + passwordChanged(event: PasswordChangedEvent) { + this.passwordHash = event.payload!.passwordHash; + } +} + +export class UserAggregate extends AbstractAggregate { + + protected readonly state = new UserAggregateState(); + + createUser(payload: CreateUserCommandPayload) { + this.emit('userCreated', { + username: payload.username, + passwordHash: md5(payload.password) + }); + } + + changePassword(payload: ChangePasswordCommandPayload) { + if (md5(payload.oldPassword) !== this.state.passwordHash) + throw new Error('Invalid password'); + + this.emit('passwordChanged', { + passwordHash: md5(payload.newPassword) + }); + } +} diff --git a/examples/user-domain-ts/UsersProjection.ts b/examples/user-domain-ts/UsersProjection.ts new file mode 100644 index 0000000..49aeb21 --- /dev/null +++ b/examples/user-domain-ts/UsersProjection.ts @@ -0,0 +1,18 @@ +import type { UserCreatedEvent } from './messages'; +import { AbstractProjection } from '../..'; + +export type UsersView = Map; + +export class UsersProjection extends AbstractProjection { + + constructor() { + super(); + this.view = new Map(); + } + + userCreated(event: UserCreatedEvent) { + this.view.set(event.aggregateId as string, { + username: event.payload!.username + }); + } +} diff --git a/examples/user-domain-ts/index.ts b/examples/user-domain-ts/index.ts index bc1beff..9166bcb 100644 --- a/examples/user-domain-ts/index.ts +++ b/examples/user-domain-ts/index.ts @@ -1,92 +1,37 @@ -import { - AbstractAggregate, - AbstractProjection, - ContainerBuilder, - IContainer, - IEvent, - InMemoryEventStorage -} from '../..'; -import * as crypto from 'crypto'; -const md5 = (v: string): string => crypto.createHash('md5').update(v).digest('hex'); - -type CreateUserCommandPayload = { username: string, password: string }; -type UserCreatedEventPayload = { username: string, passwordHash: string }; - -type ChangePasswordCommandPayload = { oldPassword: string, newPassword: string }; -type PasswordChangedEventPayload = { passwordHash: string }; - -class UserAggregateState { - passwordHash!: string; - - passwordChanged(event: IEvent) { - this.passwordHash = event.payload!.passwordHash; - } -} - -class UserAggregate extends AbstractAggregate { - - protected readonly state = new UserAggregateState(); - - createUser(payload: CreateUserCommandPayload) { - this.emit('userCreated', { - username: payload.username, - passwordHash: md5(payload.password) - }); - } - - changePassword(payload: ChangePasswordCommandPayload) { - if (md5(payload.oldPassword) !== this.state.passwordHash) - throw new Error('Invalid password'); - - this.emit('passwordChanged', { - passwordHash: md5(payload.newPassword) - }); - } -} - -type UsersView = Map; - -class UsersProjection extends AbstractProjection { - - constructor() { - super(); - this.view = new Map(); - } - - userCreated(event: IEvent) { - this.view.set(event.aggregateId as string, { - username: event.payload!.username - }); - } -} +import { ContainerBuilder, IContainer, InMemoryEventStorage } from '../..'; +import type { ChangePasswordCommandPayload, CreateUserCommandPayload } from './messages'; +import { UserAggregate } from './UserAggregate'; +import { UsersProjection, UsersView } from './UsersProjection'; interface MyDiContainer extends IContainer { users: UsersView; } const builder = new ContainerBuilder(); - -// In-memory implementations for local dev/tests -builder.register(InMemoryEventStorage) +builder.register(InMemoryEventStorage) // In-memory implementations for local dev/tests .as('eventStorageReader') .as('eventStorageWriter'); -builder.register(() => console, 'logger'); builder.registerAggregate(UserAggregate); builder.registerProjection(UsersProjection, 'users'); -const container = builder.container(); - (async function main() { - + const container = builder.container(); const { users, commandBus } = container; - const payload: CreateUserCommandPayload = { - username: 'john', - password: 'magic' - }; - - const [userCreated] = await commandBus.send('createUser', undefined, { payload }); + const [userCreated] = await commandBus.send('createUser', undefined, { + payload: { + username: 'john', + password: 'magic' + } satisfies CreateUserCommandPayload + }); + + await commandBus.send('changePassword', userCreated.aggregateId as string, { + payload: { + oldPassword: 'magic', + newPassword: 'no magic' + } satisfies ChangePasswordCommandPayload + }); const user = users.get(userCreated.aggregateId as string); diff --git a/examples/user-domain-ts/messages.ts b/examples/user-domain-ts/messages.ts new file mode 100644 index 0000000..8084058 --- /dev/null +++ b/examples/user-domain-ts/messages.ts @@ -0,0 +1,10 @@ +import type { IEvent } from '../../types'; + +export type CreateUserCommandPayload = { username: string, password: string }; +export type UserCreatedEventPayload = { username: string, passwordHash: string }; +export type UserCreatedEvent = IEvent; + +export type ChangePasswordCommandPayload = { oldPassword: string, newPassword: string }; +export type PasswordChangedEventPayload = { passwordHash: string }; +export type PasswordChangedEvent = IEvent; + diff --git a/examples/user-domain-ts/utils.ts b/examples/user-domain-ts/utils.ts new file mode 100644 index 0000000..7f60531 --- /dev/null +++ b/examples/user-domain-ts/utils.ts @@ -0,0 +1,3 @@ +import * as crypto from 'crypto'; + +export const md5 = (v: string): string => crypto.createHash('md5').update(v).digest('hex'); From 13f20a0b622deca506cc59381f67532259d60519 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 29 Jan 2026 14:39:46 +0000 Subject: [PATCH 151/169] Move node-specific delay utility to integration tests --- src/utils/index.ts | 1 - tests/integration/rabbitmq/RabbitMqEventBus.test.ts | 6 +----- tests/integration/rabbitmq/RabbitMqGateway.test.ts | 2 +- {src => tests/integration/rabbitmq}/utils/delay.ts | 0 tests/integration/rabbitmq/utils/index.ts | 1 + 5 files changed, 3 insertions(+), 7 deletions(-) rename {src => tests/integration/rabbitmq}/utils/delay.ts (100%) create mode 100644 tests/integration/rabbitmq/utils/index.ts diff --git a/src/utils/index.ts b/src/utils/index.ts index b987ba6..8e8a8da 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,5 +1,4 @@ export * from './Deferred'; -export * from './delay'; export * from './getClassName'; export * from './getHandler'; export * from './getMessageHandlerNames'; diff --git a/tests/integration/rabbitmq/RabbitMqEventBus.test.ts b/tests/integration/rabbitmq/RabbitMqEventBus.test.ts index 10c31ad..0c262ba 100644 --- a/tests/integration/rabbitmq/RabbitMqEventBus.test.ts +++ b/tests/integration/rabbitmq/RabbitMqEventBus.test.ts @@ -2,11 +2,7 @@ import * as amqplib from 'amqplib'; import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; import { RabbitMqEventBus } from '../../../src/rabbitmq/RabbitMqEventBus'; import { IMessage, IEvent } from '../../../src/interfaces'; - -const delay = (ms: number) => new Promise(res => { - const t = setTimeout(res, ms); - t.unref(); -}); +import { delay } from './utils'; describe('RabbitMqEventBus', () => { diff --git a/tests/integration/rabbitmq/RabbitMqGateway.test.ts b/tests/integration/rabbitmq/RabbitMqGateway.test.ts index bc717b2..31fa52a 100644 --- a/tests/integration/rabbitmq/RabbitMqGateway.test.ts +++ b/tests/integration/rabbitmq/RabbitMqGateway.test.ts @@ -1,7 +1,7 @@ import { RabbitMqGateway } from '../../../src/rabbitmq/RabbitMqGateway'; import { IMessage } from '../../../src/interfaces'; import * as amqplib from 'amqplib'; -import { delay } from '../../../src/utils'; +import { delay } from './utils'; import { Deferred } from '../../../src/utils/Deferred'; import { EventEmitter } from 'stream'; diff --git a/src/utils/delay.ts b/tests/integration/rabbitmq/utils/delay.ts similarity index 100% rename from src/utils/delay.ts rename to tests/integration/rabbitmq/utils/delay.ts diff --git a/tests/integration/rabbitmq/utils/index.ts b/tests/integration/rabbitmq/utils/index.ts new file mode 100644 index 0000000..1e0db20 --- /dev/null +++ b/tests/integration/rabbitmq/utils/index.ts @@ -0,0 +1 @@ +export * from './delay'; From 3bdd37d5b123fdeb60e98d5152814f6808f424f8 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 29 Jan 2026 14:40:05 +0000 Subject: [PATCH 152/169] Update readme.md --- README.md | 31 +++++++++++++++++++++---------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 2984504..e8b19eb 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ It favors ES6/TS classes and dependency injection, so you can modify or replace CQRS/ES itself can be implemented with surprisingly little code in a single process. For a minimal, framework-free example, see [examples/user-domain-own-implementation/index.ts](examples/user-domain-own-implementation/index.ts). + This library exists to cover the "boring but hard" parts that are usually missing from a plain implementation, including: - async command/event processing and safer wiring/subscriptions @@ -22,6 +23,11 @@ This library exists to cover the "boring but hard" parts that are usually missin - aggregate snapshots - extensible event dispatching pipelines (encoding, persistence, distribution, etc.) +At a high level, the command/event flow looks like: + +![Overview](docs/images/node-cqrs-flow.png) + + Commands and events are loosely typed objects that implement the [IMessage](src/interfaces/IMessage.ts) interface: ```ts @@ -47,23 +53,21 @@ Domain business logic typically lives in aggregates, sagas, and projections: Message delivery is handled by the following components (in order of appearance): -- **Command Bus** delivers commands to command handlers -- **Aggregate Command Handler** restores aggregate state and executes the command -- **Event Store** runs the event dispatching process: +- **[Command Bus](src/CommandBus.ts)** delivers commands to command handlers +- **[Aggregate Command Handler](src/AggregateCommandHandler.ts)** restores aggregate state and executes the command +- **[Event Store](src/EventStore.ts)** runs the event dispatching process: - persists events (via the configured dispatch pipeline) - - then delivers them to event handlers (saga handlers, projections, custom services) -- **Saga Event Handler** restores saga state and applies events - -At a high level, the command/event flow looks like: - -![Overview](docs/images/node-cqrs-flow.png) + - then delivers them to event handlers (sagas, projections, custom services) +- **[Saga Event Handler](src/SagaEventHandler.ts)** restores saga state and applies events **Tip**: the codebase is intentionally small and readable - `src/`, `tests/`, `examples/` are a good reference if you want to explore behavior in more detail. +### Examples + - [examples/user-domain](examples/user-domain) basic CJS implementation - [examples/user-domain-ts](examples/user-domain-ts) similar implementation in TS - [examples/worker-projection](examples/worker-projection) projection in a worker thread -- [examples/user-domain-own-implementation](examples/user-domain-own-implementation) minimal, framework-free, CQRS/ES example +- [examples/user-domain-own-implementation](examples/user-domain-own-implementation/index.ts) minimal, framework-free CQRS/ES example in 1 file ## Installation @@ -71,6 +75,13 @@ At a high level, the command/event flow looks like: npm i node-cqrs ``` +Tested under +- Node 18 +- Node 20 +- Node 22 + +### Peer Dependencies + If you want to use SQLite, RabbitMQ, or worker threads, the following peer dependencies may be needed: - [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) From ac45221aa3317c711527d1670e13a82740964a7a Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 29 Jan 2026 18:52:25 +0000 Subject: [PATCH 153/169] Fix package-lock --- package-lock.json | 3 +++ 1 file changed, 3 insertions(+) diff --git a/package-lock.json b/package-lock.json index 7e5f71f..2242ae1 100644 --- a/package-lock.json +++ b/package-lock.json @@ -58,6 +58,9 @@ }, "comlink": { "optional": true + }, + "md5": { + "optional": true } } }, From e83018f3a9eb247db31ca447c2157bcf2ff71497 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 29 Jan 2026 18:56:47 +0000 Subject: [PATCH 154/169] Build: Add ESM, CJS, and Browser builds --- README.md | 4 + examples/browser-smoke-test/README.md | 17 +++ examples/browser-smoke-test/index.html | 40 +++++++ examples/browser-smoke-test/main.js | 111 ++++++++++++++++++ examples/jsconfig.json | 32 +++++ examples/tsconfig.json | 13 ++ examples/user-domain-ts/UserAggregate.ts | 11 +- examples/user-domain-ts/UsersProjection.ts | 4 +- examples/user-domain-ts/index.ts | 8 +- examples/user-domain-ts/messages.ts | 3 +- examples/user-domain/UserAggregate.js | 2 +- examples/user-domain/UsersProjection.js | 4 +- examples/user-domain/index.js | 12 +- examples/user-domain/tests/index.test.js | 2 +- .../worker-projection/CounterProjection.cjs | 2 +- jsconfig.json | 20 +++- package.json | 26 ++-- scripts/etc/cjs-package.json | 3 + src/AbstractAggregate.ts | 4 +- src/AbstractProjection.ts | 8 +- src/AbstractSaga.ts | 4 +- src/AggregateCommandHandler.ts | 26 ++-- src/CommandBus.ts | 6 +- src/CqrsContainerBuilder.ts | 32 ++--- src/Event.ts | 2 +- src/EventDispatchPipeline.ts | 23 ++-- src/EventDispatcher.ts | 18 +-- src/EventStore.ts | 6 +- src/SagaEventHandler.ts | 8 +- src/in-memory/InMemoryEventStorage.ts | 6 +- src/in-memory/InMemoryLock.ts | 2 +- src/in-memory/InMemoryMessageBus.ts | 2 +- src/in-memory/InMemorySnapshotStorage.ts | 18 +-- src/in-memory/InMemoryView.ts | 6 +- src/in-memory/index.ts | 10 +- src/in-memory/utils/index.ts | 2 +- src/in-memory/utils/nextCycle.ts | 2 +- src/index.ts | 26 ++-- src/interfaces/IAggregate.ts | 8 +- src/interfaces/IAggregateSnapshotStorage.ts | 4 +- src/interfaces/ICommand.ts | 2 +- src/interfaces/ICommandBus.ts | 8 +- src/interfaces/IContainer.ts | 20 ++-- src/interfaces/IDispatchPipelineProcessor.ts | 4 +- src/interfaces/IEvent.ts | 4 +- src/interfaces/IEventBus.ts | 4 +- src/interfaces/IEventDispatcher.ts | 4 +- src/interfaces/IEventLocker.ts | 4 +- src/interfaces/IEventReceptor.ts | 4 +- src/interfaces/IEventSet.ts | 2 +- src/interfaces/IEventStorageReader.ts | 8 +- src/interfaces/IEventStorageWriter.ts | 2 +- src/interfaces/IEventStore.ts | 12 +- src/interfaces/IEventStream.ts | 2 +- src/interfaces/IIdentifierProvider.ts | 4 +- src/interfaces/IMessage.ts | 4 +- src/interfaces/IMessageBus.ts | 6 +- src/interfaces/IObjectStorage.ts | 2 +- src/interfaces/IObservable.ts | 4 +- src/interfaces/IObservableQueueProvider.ts | 4 +- src/interfaces/IObserver.ts | 2 +- src/interfaces/IProjection.ts | 8 +- src/interfaces/ISaga.ts | 8 +- src/interfaces/ISnapshotEvent.ts | 2 +- src/interfaces/IViewLocker.ts | 2 +- src/interfaces/index.ts | 58 ++++----- src/rabbitmq/IContainer.ts | 2 +- src/rabbitmq/RabbitMqEventBus.ts | 4 +- src/rabbitmq/RabbitMqGateway.ts | 8 +- src/rabbitmq/index.ts | 4 +- src/rabbitmq/utils/index.ts | 2 +- src/sqlite/AbstractSqliteAccessor.ts | 4 +- src/sqlite/AbstractSqliteObjectProjection.ts | 6 +- src/sqlite/AbstractSqliteView.ts | 8 +- src/sqlite/SqliteEventLocker.ts | 12 +- src/sqlite/SqliteObjectStorage.ts | 6 +- src/sqlite/SqliteObjectView.ts | 6 +- src/sqlite/SqliteViewLocker.ts | 10 +- src/sqlite/index.ts | 16 +-- src/sqlite/queries/index.ts | 4 +- src/sqlite/utils/getEventId.ts | 6 +- src/sqlite/utils/index.ts | 4 +- src/utils/Lock.ts | 14 ++- src/utils/getHandler.ts | 2 +- src/utils/index.ts | 26 ++-- src/utils/setupOneTimeEmitterSubscription.ts | 2 +- src/utils/subscribe.ts | 6 +- src/utils/validateHandlers.ts | 2 +- src/workers/AbstractWorkerProjection.ts | 10 +- src/workers/index.ts | 2 +- src/workers/utils/createWorker.ts | 2 +- src/workers/utils/index.ts | 4 +- tests/integration/sqlite/SqliteView.test.ts | 2 +- tests/unit/EventStore.test.ts | 2 +- tests/unit/dispatch-pipeline.test.ts | 2 +- tests/unit/sqlite/SqliteEventLocker.test.ts | 2 +- tests/unit/sqlite/SqliteObjectStorage.test.ts | 2 +- tests/unit/sqlite/SqliteObjectView.test.ts | 2 +- tests/unit/sqlite/SqliteViewLocker.test.ts | 2 +- .../workers/fixtures/ProjectionFixture.cjs | 4 +- .../workers/fixtures/ProjectionFixture.ts | 37 ------ tests/unit/workers/fixtures/jsconfig.json | 32 +++++ tsconfig.browser.json | 11 ++ tsconfig.cjs.json | 10 ++ tsconfig.esm.json | 13 ++ tsconfig.json | 57 +++++---- 106 files changed, 677 insertions(+), 394 deletions(-) create mode 100644 examples/browser-smoke-test/README.md create mode 100644 examples/browser-smoke-test/index.html create mode 100644 examples/browser-smoke-test/main.js create mode 100644 examples/jsconfig.json create mode 100644 examples/tsconfig.json create mode 100644 scripts/etc/cjs-package.json delete mode 100644 tests/unit/workers/fixtures/ProjectionFixture.ts create mode 100644 tests/unit/workers/fixtures/jsconfig.json create mode 100644 tsconfig.browser.json create mode 100644 tsconfig.cjs.json create mode 100644 tsconfig.esm.json diff --git a/README.md b/README.md index e8b19eb..384bec7 100644 --- a/README.md +++ b/README.md @@ -69,6 +69,8 @@ Message delivery is handled by the following components (in order of appearance) - [examples/worker-projection](examples/worker-projection) projection in a worker thread - [examples/user-domain-own-implementation](examples/user-domain-own-implementation/index.ts) minimal, framework-free CQRS/ES example in 1 file +TS examples can be run with `node` without transpiling + ## Installation ```bash @@ -76,9 +78,11 @@ npm i node-cqrs ``` Tested under + - Node 18 - Node 20 - Node 22 +- Browser (through [browserify](https://browserify.org)) ### Peer Dependencies diff --git a/examples/browser-smoke-test/README.md b/examples/browser-smoke-test/README.md new file mode 100644 index 0000000..c488ff0 --- /dev/null +++ b/examples/browser-smoke-test/README.md @@ -0,0 +1,17 @@ +# Browser smoke test + +This example is meant to quickly verify that the core `node-cqrs` APIs work in a browser environment. + +## Run + +From the repo root: + +```bash +npm run build:browser +``` + +Then open `examples/browser-smoke-test/index.html` directly (e.g. double-click it). + +Notes: +- The bundle is written to `dist/browser/node-cqrs.iife.js`. +- If you don’t have Browserify installed locally, run `npm i -D browserify`. diff --git a/examples/browser-smoke-test/index.html b/examples/browser-smoke-test/index.html new file mode 100644 index 0000000..231e1cf --- /dev/null +++ b/examples/browser-smoke-test/index.html @@ -0,0 +1,40 @@ + + + + + + + node-cqrs browser smoke test + + + + +

node-cqrs browser smoke test

+

Open DevTools console for details.

+ 
Running…
+ + + + + diff --git a/examples/browser-smoke-test/main.js b/examples/browser-smoke-test/main.js new file mode 100644 index 0000000..9bd93c6 --- /dev/null +++ b/examples/browser-smoke-test/main.js @@ -0,0 +1,111 @@ +(function () { + const out = document.getElementById('out'); + + function write(line) { + out.textContent = `${out.textContent}\n${line}`; + } + + function setStatusOk() { + out.classList.remove('fail'); + out.classList.add('ok'); + } + + function setStatusFail() { + out.classList.remove('ok'); + out.classList.add('fail'); + } + + if (!globalThis.Cqrs) + throw new Error('Cqrs bundle is not loaded. Run `npm run build:browser` first.'); + + const { + AbstractAggregate, + AbstractProjection, + ContainerBuilder, + InMemoryEventStorage + } = globalThis.Cqrs; + + class UserAggregateState { + userCreated(event) { + this.password = event.payload.password; + } + + passwordChanged(event) { + this.password = event.payload.newPassword; + } + } + + class UserAggregate extends AbstractAggregate { + constructor(params) { + super(params); + this.state = new UserAggregateState(); + } + + createUser(payload) { + this.emit('userCreated', { + username: payload.username, + password: payload.password + }); + } + + changePassword(payload) { + if (payload.oldPassword !== this.state.password) + throw new Error('Invalid password'); + + this.emit('passwordChanged', { + newPassword: payload.newPassword + }); + } + } + + class UsersProjection extends AbstractProjection { + constructor() { + super(); + this.view = new Map(); + } + + userCreated(event) { + this.view.set(event.aggregateId, { username: event.payload.username }); + } + } + + async function main() { + out.textContent = ''; + write('Building container…'); + + const builder = new ContainerBuilder(); + builder.register(InMemoryEventStorage) + .as('eventStorageReader') + .as('eventStorageWriter'); + builder.registerAggregate(UserAggregate); + builder.registerProjection(UsersProjection, 'users'); + + const container = builder.container(); + const { users, commandBus } = container; + + write('Sending commands…'); + const [userCreated] = await commandBus.send('createUser', undefined, { + payload: { username: 'john', password: 'magic' }, + context: {} + }); + + await commandBus.send('changePassword', userCreated.aggregateId, { + payload: { oldPassword: 'magic', newPassword: 'no magic' }, + context: {} + }); + + const user = users.get(userCreated.aggregateId); + if (!user || user.username !== 'john') + throw new Error(`Unexpected user view value: ${JSON.stringify(user)}`); + + write(`OK: ${JSON.stringify(user)}`); + setStatusOk(); + } + + main().catch(err => { + console.error(err); + out.textContent = `FAILED: ${err?.message ?? String(err)}`; + setStatusFail(); + }); +}()); + diff --git a/examples/jsconfig.json b/examples/jsconfig.json new file mode 100644 index 0000000..6653e49 --- /dev/null +++ b/examples/jsconfig.json @@ -0,0 +1,32 @@ +{ + "compilerOptions": { + "target": "es2022", + "module": "commonjs", + "moduleResolution": "node", + "checkJs": true, + "allowSyntheticDefaultImports": true, + "resolveJsonModule": true, + "lib": [ + "es2022", + "dom" + ], + "baseUrl": "..", + "paths": { + "node-cqrs": [ + "types/index.d.ts" + ], + "node-cqrs/*": [ + "types/*/index.d.ts" + ] + } + }, + "include": [ + "**/*" + ], + "exclude": [ + "../node_modules", + "../dist", + "**/bundle.js", + "browser-smoke-test/**" + ] +} diff --git a/examples/tsconfig.json b/examples/tsconfig.json new file mode 100644 index 0000000..875f1f5 --- /dev/null +++ b/examples/tsconfig.json @@ -0,0 +1,13 @@ +{ + "compilerOptions": { + "target": "ES2022", + "module": "NodeNext", + "moduleResolution": "NodeNext", + "lib": [ + "ES2022" + ], + "strict": true, + "noEmit": true, + "allowImportingTsExtensions": true + } +} diff --git a/examples/user-domain-ts/UserAggregate.ts b/examples/user-domain-ts/UserAggregate.ts index 328b15e..b0b9f9d 100644 --- a/examples/user-domain-ts/UserAggregate.ts +++ b/examples/user-domain-ts/UserAggregate.ts @@ -1,6 +1,11 @@ -import type { ChangePasswordCommandPayload, CreateUserCommandPayload, PasswordChangedEvent, UserCreatedEvent } from './messages'; -import { AbstractAggregate } from '../..'; -import { md5 } from './utils'; +import { AbstractAggregate } from 'node-cqrs'; +import { md5 } from './utils.ts'; +import type { + ChangePasswordCommandPayload, + CreateUserCommandPayload, + PasswordChangedEvent, + UserCreatedEvent +} from './messages.ts'; class UserAggregateState { passwordHash!: string; diff --git a/examples/user-domain-ts/UsersProjection.ts b/examples/user-domain-ts/UsersProjection.ts index 49aeb21..4f9755a 100644 --- a/examples/user-domain-ts/UsersProjection.ts +++ b/examples/user-domain-ts/UsersProjection.ts @@ -1,5 +1,5 @@ -import type { UserCreatedEvent } from './messages'; -import { AbstractProjection } from '../..'; +import { AbstractProjection } from 'node-cqrs'; +import type { UserCreatedEvent } from './messages.ts'; export type UsersView = Map; diff --git a/examples/user-domain-ts/index.ts b/examples/user-domain-ts/index.ts index 9166bcb..c6545e7 100644 --- a/examples/user-domain-ts/index.ts +++ b/examples/user-domain-ts/index.ts @@ -1,7 +1,7 @@ -import { ContainerBuilder, IContainer, InMemoryEventStorage } from '../..'; -import type { ChangePasswordCommandPayload, CreateUserCommandPayload } from './messages'; -import { UserAggregate } from './UserAggregate'; -import { UsersProjection, UsersView } from './UsersProjection'; +import { ContainerBuilder, type IContainer, InMemoryEventStorage } from 'node-cqrs'; +import type { ChangePasswordCommandPayload, CreateUserCommandPayload } from './messages.ts'; +import { UserAggregate } from './UserAggregate.ts'; +import { UsersProjection, type UsersView } from './UsersProjection.ts'; interface MyDiContainer extends IContainer { users: UsersView; diff --git a/examples/user-domain-ts/messages.ts b/examples/user-domain-ts/messages.ts index 8084058..f721677 100644 --- a/examples/user-domain-ts/messages.ts +++ b/examples/user-domain-ts/messages.ts @@ -1,4 +1,4 @@ -import type { IEvent } from '../../types'; +import type { IEvent } from 'node-cqrs'; export type CreateUserCommandPayload = { username: string, password: string }; export type UserCreatedEventPayload = { username: string, passwordHash: string }; @@ -7,4 +7,3 @@ export type UserCreatedEvent = IEvent; export type ChangePasswordCommandPayload = { oldPassword: string, newPassword: string }; export type PasswordChangedEventPayload = { passwordHash: string }; export type PasswordChangedEvent = IEvent; - diff --git a/examples/user-domain/UserAggregate.js b/examples/user-domain/UserAggregate.js index 13d2299..abe0bb1 100644 --- a/examples/user-domain/UserAggregate.js +++ b/examples/user-domain/UserAggregate.js @@ -1,7 +1,7 @@ // @ts-check 'use strict'; -const { AbstractAggregate } = require('../..'); // node-cqrs +const { AbstractAggregate } = require('node-cqrs'); const crypto = require('crypto'); diff --git a/examples/user-domain/UsersProjection.js b/examples/user-domain/UsersProjection.js index 6e21124..3c1cf1b 100644 --- a/examples/user-domain/UsersProjection.js +++ b/examples/user-domain/UsersProjection.js @@ -1,7 +1,7 @@ // @ts-check 'use strict'; -const { AbstractProjection } = require('../..'); // node-cqrs +const { AbstractProjection } = require('node-cqrs'); /** * Users projection listens to events and updates associated view (read model) @@ -29,7 +29,7 @@ class UsersProjection extends AbstractProjection { * userCreated event handler * * @param {object} event - * @param {import('../../src').Identifier} event.aggregateId + * @param {import('node-cqrs').Identifier} event.aggregateId * @param {object} event.payload * @param {string} event.payload.username * @param {string} event.payload.passwordHash diff --git a/examples/user-domain/index.js b/examples/user-domain/index.js index e276a54..f0b02ea 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.js @@ -7,9 +7,9 @@ const { EventStore, AggregateCommandHandler, InMemoryMessageBus, - EventDispatcher -} = require('../..'); // node-cqrs -const { InMemorySnapshotStorage } = require('../..'); + EventDispatcher, + InMemorySnapshotStorage +} = require('node-cqrs'); const UserAggregate = require('./UserAggregate'); const UsersProjection = require('./UsersProjection'); @@ -47,14 +47,14 @@ exports.createBaseInstances = () => { const eventStore = new EventStore({ eventStorageReader: storage, eventBus, eventDispatcher }); const commandBus = new CommandBus(); - /** @type {import('../..').IAggregateConstructor} */ + /** @type {import('node-cqrs').IAggregateConstructor} */ const aggregateType = UserAggregate; - /** @type {import('../..').ICommandHandler} */ + /** @type {import('node-cqrs').ICommandHandler} */ const userCommandHandler = new AggregateCommandHandler({ eventStore, aggregateType }); userCommandHandler.subscribe(commandBus); - /** @type {import('../..').IProjection} */ + /** @type {import('node-cqrs').IProjection} */ const usersProjection = new UsersProjection(); usersProjection.subscribe(eventStore); diff --git a/examples/user-domain/tests/index.test.js b/examples/user-domain/tests/index.test.js index 00f293e..a5367ac 100644 --- a/examples/user-domain/tests/index.test.js +++ b/examples/user-domain/tests/index.test.js @@ -1,7 +1,7 @@ 'use strict'; const { expect } = require('chai'); -const { createContainer, createBaseInstances } = require('..'); +const { createContainer, createBaseInstances } = require('../index.js'); describe('user-domain example', () => { diff --git a/examples/worker-projection/CounterProjection.cjs b/examples/worker-projection/CounterProjection.cjs index f2aadd0..3247bcf 100644 --- a/examples/worker-projection/CounterProjection.cjs +++ b/examples/worker-projection/CounterProjection.cjs @@ -1,4 +1,4 @@ -const { AbstractWorkerProjection } = require('../../dist/workers'); +const { AbstractWorkerProjection } = require('node-cqrs/workers'); class CounterView { counter = 0; diff --git a/jsconfig.json b/jsconfig.json index 1d876e5..b15664f 100644 --- a/jsconfig.json +++ b/jsconfig.json @@ -1,15 +1,29 @@ { "compilerOptions": { - "target": "es6", + "target": "es2022", "module": "commonjs", + "moduleResolution": "node", + "baseUrl": ".", + "paths": { + "node-cqrs": [ + "./types/index.d.ts" + ], + "node-cqrs/*": [ + "./types/*/index.d.ts" + ] + }, "allowSyntheticDefaultImports": true, "checkJs": true, "resolveJsonModule": true, "lib": [ - "es2018" + "es2022", + "dom" ] }, "exclude": [ - "node_modules" + "node_modules", + "dist", + "dist/**", + "examples/**/bundle.js" ] } diff --git a/package.json b/package.json index 15b407c..0fab651 100644 --- a/package.json +++ b/package.json @@ -2,6 +2,7 @@ "name": "node-cqrs", "version": "1.0.0-rc.33", "description": "Basic ES6 backbone for CQRS app development", + "type": "module", "keywords": [ "cqrs", "eventsourcing" @@ -10,7 +11,7 @@ "type": "git", "url": "https://github.com/snatalenko/node-cqrs.git" }, - "main": "./dist/index.js", + "main": "./dist/cjs/index.js", "types": "./types/index.d.ts", "typesVersions": { "*": { @@ -27,23 +28,23 @@ }, "exports": { ".": { - "require": "./dist/index.js", - "import": "./dist/index.js", + "require": "./dist/cjs/index.js", + "import": "./dist/esm/index.js", "types": "./types/index.d.ts" }, "./workers": { - "require": "./dist/workers/index.js", - "import": "./dist/workers/index.js", + "require": "./dist/cjs/workers/index.js", + "import": "./dist/esm/workers/index.js", "types": "./types/workers/index.d.ts" }, "./rabbitmq": { - "require": "./dist/rabbitmq/index.js", - "import": "./dist/rabbitmq/index.js", + "require": "./dist/cjs/rabbitmq/index.js", + "import": "./dist/esm/rabbitmq/index.js", "types": "./types/rabbitmq/index.d.ts" }, "./sqlite": { - "require": "./dist/sqlite/index.js", - "import": "./dist/sqlite/index.js", + "require": "./dist/cjs/sqlite/index.js", + "import": "./dist/esm/sqlite/index.js", "types": "./types/sqlite/index.d.ts" } }, @@ -56,14 +57,17 @@ "node": ">=18.0.0" }, "scripts": { - "cleanup": "rm -rf ./dist ./types ./coverage && tsc --build --clean", + "cleanup": "rm -rf ./dist ./types ./coverage", "pretest": "npm run build", "test": "jest tests/unit examples/user-domain/tests", "test:coverage": "npm t -- --collect-coverage", "test:rabbitmq": "jest --verbose tests/integration/rabbitmq", "test:sqlite": "jest --verbose tests/integration/sqlite", "changelog": "conventional-changelog -n ./scripts/changelog -r 0 > CHANGELOG.md", - "build": "tsc --build", + "build:cjs": "tsc -p ./tsconfig.cjs.json && cp ./scripts/etc/cjs-package.json ./dist/cjs/package.json", + "build:esm": "tsc -p ./tsconfig.esm.json", + "build:browser": "tsc -p ./tsconfig.browser.json && npx browserify dist/browser/cjs/index.js --standalone Cqrs --outfile ./dist/browser/bundle.iife.js", + "build": "npm run build:esm && npm run build:cjs", "prepare": "npm run build", "preversion": "npm test", "version": "./scripts/cleanup_obsolete_tags.sh v$npm_package_version && npm run changelog && git add CHANGELOG.md", diff --git a/scripts/etc/cjs-package.json b/scripts/etc/cjs-package.json new file mode 100644 index 0000000..5bbefff --- /dev/null +++ b/scripts/etc/cjs-package.json @@ -0,0 +1,3 @@ +{ + "type": "commonjs" +} diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 4c672d6..1b8d450 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -7,9 +7,9 @@ import { type IEventSet, type IAggregateConstructorParams, SNAPSHOT_EVENT_TYPE -} from './interfaces'; +} from './interfaces/index.ts'; -import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils'; +import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils/index.ts'; /** * Base class for Aggregate definition diff --git a/src/AbstractProjection.ts b/src/AbstractProjection.ts index b48b780..d6c98ec 100644 --- a/src/AbstractProjection.ts +++ b/src/AbstractProjection.ts @@ -1,5 +1,5 @@ -import { describe } from './Event'; -import { InMemoryView } from './in-memory/InMemoryView'; +import { describe } from './Event.ts'; +import { InMemoryView } from './in-memory/InMemoryView.ts'; import { type IViewLocker, type IEventLocker, @@ -11,7 +11,7 @@ import { type IEventStorageReader, isViewLocker, isEventLocker -} from './interfaces'; +} from './interfaces/index.ts'; import { getClassName, @@ -19,7 +19,7 @@ import { getHandler, subscribe, getMessageHandlerNames -} from './utils'; +} from './utils/index.ts'; export type AbstractProjectionParams = { diff --git a/src/AbstractSaga.ts b/src/AbstractSaga.ts index fa08b72..484f50e 100644 --- a/src/AbstractSaga.ts +++ b/src/AbstractSaga.ts @@ -1,6 +1,6 @@ -import { ICommand, Identifier, IEvent, ISaga, ISagaConstructorParams } from './interfaces'; +import type { ICommand, Identifier, IEvent, ISaga, ISagaConstructorParams } from './interfaces/index.ts'; -import { getClassName, validateHandlers, getHandler } from './utils'; +import { getClassName, validateHandlers, getHandler } from './utils/index.ts'; /** * Base class for Saga definition diff --git a/src/AggregateCommandHandler.ts b/src/AggregateCommandHandler.ts index 9c8c415..c8d86c8 100644 --- a/src/AggregateCommandHandler.ts +++ b/src/AggregateCommandHandler.ts @@ -1,18 +1,18 @@ -import { getClassName, Lock, MapAssertable } from './utils'; +import { getClassName, Lock, MapAssertable } from './utils/index.ts'; import { - IAggregate, - IAggregateConstructor, - IAggregateFactory, - ICommand, - ICommandHandler, - IContainer, - Identifier, - IEventSet, - IEventStore, - ILogger, - IObservable, + type IAggregate, + type IAggregateConstructor, + type IAggregateFactory, + type ICommand, + type ICommandHandler, + type IContainer, + type Identifier, + type IEventSet, + type IEventStore, + type ILogger, + type IObservable, isIObservable -} from './interfaces'; +} from './interfaces/index.ts'; /** * Aggregate command handler. diff --git a/src/CommandBus.ts b/src/CommandBus.ts index 0a2104d..57a86eb 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -1,5 +1,5 @@ -import { InMemoryMessageBus } from './in-memory'; -import { +import { InMemoryMessageBus } from './in-memory/index.ts'; +import type { ICommand, ICommandBus, IEventSet, @@ -7,7 +7,7 @@ import { ILogger, IMessageBus, IMessageHandler -} from './interfaces'; +} from './interfaces/index.ts'; export class CommandBus implements ICommandBus { diff --git a/src/CqrsContainerBuilder.ts b/src/CqrsContainerBuilder.ts index 8d7f0c7..158ba88 100644 --- a/src/CqrsContainerBuilder.ts +++ b/src/CqrsContainerBuilder.ts @@ -1,21 +1,21 @@ -import { ContainerBuilder, TypeConfig, TClassOrFactory } from 'di0'; -import { AggregateCommandHandler } from './AggregateCommandHandler'; -import { CommandBus } from './CommandBus'; -import { EventStore } from './EventStore'; -import { SagaEventHandler } from './SagaEventHandler'; -import { EventDispatcher } from './EventDispatcher'; -import { InMemoryMessageBus } from './in-memory'; -import { isClass } from './utils'; +import { ContainerBuilder, type TypeConfig, type TClassOrFactory } from 'di0'; +import { AggregateCommandHandler } from './AggregateCommandHandler.ts'; +import { CommandBus } from './CommandBus.ts'; +import { EventStore } from './EventStore.ts'; +import { SagaEventHandler } from './SagaEventHandler.ts'; +import { EventDispatcher } from './EventDispatcher.ts'; +import { InMemoryMessageBus } from './in-memory/index.ts'; +import { isClass } from './utils/isClass.ts'; import { - IAggregateConstructor, - ICommandHandler, - IContainer, - IEventReceptor, - IProjection, - IProjectionConstructor, - ISagaConstructor, + type IAggregateConstructor, + type ICommandHandler, + type IContainer, + type IEventReceptor, + type IProjection, + type IProjectionConstructor, + type ISagaConstructor, isDispatchPipelineProcessor -} from './interfaces'; +} from './interfaces/index.ts'; export class CqrsContainerBuilder extends ContainerBuilder { diff --git a/src/Event.ts b/src/Event.ts index fecaf16..86318e7 100644 --- a/src/Event.ts +++ b/src/Event.ts @@ -1,4 +1,4 @@ -import { IEvent } from './interfaces'; +import type { IEvent } from './interfaces/IEvent.ts'; /** * Get text description of an event for logging purposes diff --git a/src/EventDispatchPipeline.ts b/src/EventDispatchPipeline.ts index 340612d..bd32315 100644 --- a/src/EventDispatchPipeline.ts +++ b/src/EventDispatchPipeline.ts @@ -1,15 +1,15 @@ import { - DispatchPipelineBatch, - IEvent, - IDispatchPipelineProcessor, - IEventBus, + type DispatchPipelineBatch, + type IEvent, + type IDispatchPipelineProcessor, + type IEventBus, isDispatchPipelineProcessor, isSnapshotEvent -} from './interfaces'; +} from './interfaces/index.ts'; import { parallelPipe } from 'async-parallel-pipe'; import { AsyncIterableBuffer } from 'async-iterable-buffer'; -import { getClassName } from './utils'; +import { getClassName } from './utils/index.ts'; export type EventBatchEnvelope = { data: DispatchPipelineBatch<{ event?: IEvent }>; @@ -25,7 +25,12 @@ export class EventDispatchPipeline { #pipeline: AsyncIterableIterator | IterableIterator = this.#pipelineInput; #processing = false; - constructor(private readonly eventBus: IEventBus, private readonly concurrentLimit: number) { + readonly #eventBus; + readonly #concurrentLimit: number; + + constructor(eventBus: IEventBus, concurrentLimit: number) { + this.#eventBus = eventBus; + this.#concurrentLimit = concurrentLimit; } addProcessor(preprocessor: IDispatchPipelineProcessor) { @@ -37,7 +42,7 @@ export class EventDispatchPipeline { this.#processors.push(preprocessor); // Build a processing pipeline that runs preprocessors concurrently, preserving FIFO ordering - this.#pipeline = parallelPipe(this.#pipeline, this.concurrentLimit, async envelope => { + this.#pipeline = parallelPipe(this.#pipeline, this.#concurrentLimit, async envelope => { if (envelope.error) return envelope; @@ -79,7 +84,7 @@ export class EventDispatchPipeline { if (isSnapshotEvent(event)) continue; - await this.eventBus.publish(event, meta); + await this.#eventBus.publish(event, meta); events.push(event); } diff --git a/src/EventDispatcher.ts b/src/EventDispatcher.ts index ab11cbe..f8de8a1 100644 --- a/src/EventDispatcher.ts +++ b/src/EventDispatcher.ts @@ -1,13 +1,13 @@ import { - IEventDispatcher, - IDispatchPipelineProcessor, - IEventSet, - IEventBus, - isEventSet, - IContainer -} from './interfaces'; -import { InMemoryMessageBus } from './in-memory'; -import { EventBatchEnvelope, EventDispatchPipeline } from './EventDispatchPipeline'; + type IEventDispatcher, + type IDispatchPipelineProcessor, + type IEventSet, + type IEventBus, + type IContainer, + isEventSet +} from './interfaces/index.ts'; +import { InMemoryMessageBus } from './in-memory/index.ts'; +import { type EventBatchEnvelope, EventDispatchPipeline } from './EventDispatchPipeline.ts'; export class EventDispatcher implements IEventDispatcher { diff --git a/src/EventStore.ts b/src/EventStore.ts index d98efc6..a086fd1 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -20,12 +20,12 @@ import { isIEventStorageReader, isEventSet, isIObservableQueueProvider -} from './interfaces'; +} from './interfaces/index.ts'; import { getClassName, setupOneTimeEmitterSubscription -} from './utils'; -import { EventDispatcher } from './EventDispatcher'; +} from './utils/index.ts'; +import { EventDispatcher } from './EventDispatcher.ts'; export class EventStore implements IEventStore { diff --git a/src/SagaEventHandler.ts b/src/SagaEventHandler.ts index 6e784ff..b758191 100644 --- a/src/SagaEventHandler.ts +++ b/src/SagaEventHandler.ts @@ -1,5 +1,5 @@ -import * as Event from './Event'; -import { +import * as Event from './Event.ts'; +import type { ICommandBus, IContainer, IEvent, @@ -10,13 +10,13 @@ import { ISaga, ISagaConstructor, ISagaFactory -} from './interfaces'; +} from './interfaces/index.ts'; import { subscribe, getClassName, iteratorToArray -} from './utils'; +} from './utils/index.ts'; /** * Listens to Saga events, diff --git a/src/in-memory/InMemoryEventStorage.ts b/src/in-memory/InMemoryEventStorage.ts index d0b8d95..d3071d1 100644 --- a/src/in-memory/InMemoryEventStorage.ts +++ b/src/in-memory/InMemoryEventStorage.ts @@ -1,4 +1,4 @@ -import { +import type { IIdentifierProvider, IEvent, IEventSet, @@ -9,8 +9,8 @@ import { Identifier, IDispatchPipelineProcessor, DispatchPipelineBatch -} from '../interfaces'; -import { nextCycle } from './utils'; +} from '../interfaces/index.ts'; +import { nextCycle } from './utils/index.ts'; /** * A simple event storage implementation intended to use for tests only. diff --git a/src/in-memory/InMemoryLock.ts b/src/in-memory/InMemoryLock.ts index 8b853d1..ce6ac25 100644 --- a/src/in-memory/InMemoryLock.ts +++ b/src/in-memory/InMemoryLock.ts @@ -1,4 +1,4 @@ -import { Deferred } from '../utils'; +import { Deferred } from '../utils/index.ts'; export class InMemoryLock { diff --git a/src/in-memory/InMemoryMessageBus.ts b/src/in-memory/InMemoryMessageBus.ts index e424abf..73b02dd 100644 --- a/src/in-memory/InMemoryMessageBus.ts +++ b/src/in-memory/InMemoryMessageBus.ts @@ -5,7 +5,7 @@ import type { IMessageHandler, IObservable, IObservableQueueProvider -} from '../interfaces'; +} from '../interfaces/index.ts'; /** * Default implementation of the message bus. diff --git a/src/in-memory/InMemorySnapshotStorage.ts b/src/in-memory/InMemorySnapshotStorage.ts index 879dcb2..51ebaaa 100644 --- a/src/in-memory/InMemorySnapshotStorage.ts +++ b/src/in-memory/InMemorySnapshotStorage.ts @@ -1,14 +1,14 @@ import { - DispatchPipelineBatch, - IAggregateSnapshotStorage, - IContainer, - Identifier, - IDispatchPipelineProcessor, - IEvent, - ILogger, + type DispatchPipelineBatch, + type IAggregateSnapshotStorage, + type IContainer, + type Identifier, + type IDispatchPipelineProcessor, + type IEvent, + type ILogger, isSnapshotEvent -} from '../interfaces'; -import * as Event from '../Event'; +} from '../interfaces/index.ts'; +import * as Event from '../Event.ts'; /** * In-memory storage for aggregate snapshots. diff --git a/src/in-memory/InMemoryView.ts b/src/in-memory/InMemoryView.ts index 6e2f429..b76e49f 100644 --- a/src/in-memory/InMemoryView.ts +++ b/src/in-memory/InMemoryView.ts @@ -1,6 +1,6 @@ -import { InMemoryLock } from './InMemoryLock'; -import { IViewLocker, Identifier, IObjectStorage } from '../interfaces'; -import { nextCycle } from './utils'; +import { InMemoryLock } from './InMemoryLock.ts'; +import type { IViewLocker, Identifier, IObjectStorage } from '../interfaces/index.ts'; +import { nextCycle } from './utils/index.ts'; /** * Update given value with an update Cb and return updated value. diff --git a/src/in-memory/index.ts b/src/in-memory/index.ts index 3ef457a..74b00c7 100644 --- a/src/in-memory/index.ts +++ b/src/in-memory/index.ts @@ -1,5 +1,5 @@ -export * from './InMemoryEventStorage'; -export * from './InMemoryLock'; -export * from './InMemoryMessageBus'; -export * from './InMemorySnapshotStorage'; -export * from './InMemoryView'; +export * from './InMemoryEventStorage.ts'; +export * from './InMemoryLock.ts'; +export * from './InMemoryMessageBus.ts'; +export * from './InMemorySnapshotStorage.ts'; +export * from './InMemoryView.ts'; diff --git a/src/in-memory/utils/index.ts b/src/in-memory/utils/index.ts index d504dca..408a24b 100644 --- a/src/in-memory/utils/index.ts +++ b/src/in-memory/utils/index.ts @@ -1 +1 @@ -export * from './nextCycle'; +export * from './nextCycle.ts'; diff --git a/src/in-memory/utils/nextCycle.ts b/src/in-memory/utils/nextCycle.ts index 69c01a4..346ac96 100644 --- a/src/in-memory/utils/nextCycle.ts +++ b/src/in-memory/utils/nextCycle.ts @@ -1,4 +1,4 @@ /** * @returns Promise that resolves on next event loop cycle */ -export const nextCycle = (): Promise => new Promise(rs => setImmediate(rs)); +export const nextCycle = (): Promise => new Promise(rs => setTimeout(rs, 0)); diff --git a/src/index.ts b/src/index.ts index 27d5d0b..a802aff 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1,21 +1,21 @@ -export { CqrsContainerBuilder as ContainerBuilder } from './CqrsContainerBuilder'; +export { CqrsContainerBuilder as ContainerBuilder } from './CqrsContainerBuilder.ts'; -export * from './CommandBus'; -export * from './EventStore'; +export * from './CommandBus.ts'; +export * from './EventStore.ts'; -export * from './AbstractAggregate'; -export * from './AggregateCommandHandler'; -export * from './AbstractSaga'; -export * from './SagaEventHandler'; -export * from './AbstractProjection'; -export * from './EventDispatcher'; +export * from './AbstractAggregate.ts'; +export * from './AggregateCommandHandler.ts'; +export * from './AbstractSaga.ts'; +export * from './SagaEventHandler.ts'; +export * from './AbstractProjection.ts'; +export * from './EventDispatcher.ts'; -export * from './in-memory'; +export * from './in-memory/index.ts'; -export * as Event from './Event'; +export * as Event from './Event.ts'; export { getMessageHandlerNames, subscribe -} from './utils'; +} from './utils/index.ts'; -export * from './interfaces'; +export * from './interfaces/index.ts'; diff --git a/src/interfaces/IAggregate.ts b/src/interfaces/IAggregate.ts index 5316773..528ee9c 100644 --- a/src/interfaces/IAggregate.ts +++ b/src/interfaces/IAggregate.ts @@ -1,7 +1,7 @@ -import { ICommand } from './ICommand'; -import { Identifier } from './Identifier'; -import { IEvent } from './IEvent'; -import { IEventSet } from './IEventSet'; +import type { ICommand } from './ICommand.ts'; +import type { Identifier } from './Identifier.ts'; +import type { IEvent } from './IEvent.ts'; +import type { IEventSet } from './IEventSet.ts'; /** * Core interface representing an Aggregate in a CQRS architecture. diff --git a/src/interfaces/IAggregateSnapshotStorage.ts b/src/interfaces/IAggregateSnapshotStorage.ts index 1fb937a..9dae771 100644 --- a/src/interfaces/IAggregateSnapshotStorage.ts +++ b/src/interfaces/IAggregateSnapshotStorage.ts @@ -1,5 +1,5 @@ -import { Identifier } from './Identifier'; -import { IEvent } from './IEvent'; +import type { Identifier } from './Identifier.ts'; +import type { IEvent } from './IEvent.ts'; export interface IAggregateSnapshotStorage { getAggregateSnapshot(aggregateId: Identifier): diff --git a/src/interfaces/ICommand.ts b/src/interfaces/ICommand.ts index 94efa95..ca36031 100644 --- a/src/interfaces/ICommand.ts +++ b/src/interfaces/ICommand.ts @@ -1,3 +1,3 @@ -import { IMessage } from './IMessage'; +import type { IMessage } from './IMessage.ts'; export type ICommand = IMessage; diff --git a/src/interfaces/ICommandBus.ts b/src/interfaces/ICommandBus.ts index 53c4a7d..2a5e6a6 100644 --- a/src/interfaces/ICommandBus.ts +++ b/src/interfaces/ICommandBus.ts @@ -1,7 +1,7 @@ -import { ICommand } from './ICommand'; -import { IEventSet } from './IEventSet'; -import { IObservable } from './IObservable'; -import { IObserver } from './IObserver'; +import type { ICommand } from './ICommand.ts'; +import type { IEventSet } from './IEventSet.ts'; +import type { IObservable } from './IObservable.ts'; +import type { IObserver } from './IObserver.ts'; export interface ICommandBus extends IObservable { send(commandType: string, aggregateId: string | undefined, options: { payload?: object, context?: object }): diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index 1d6bebb..f7ecfa7 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -1,14 +1,14 @@ import { Container } from 'di0'; -import { ICommandBus } from './ICommandBus'; -import { IEventDispatcher } from './IEventDispatcher'; -import { IEventStore } from './IEventStore'; -import { IEventBus } from './IEventBus'; -import { IDispatchPipelineProcessor } from './IDispatchPipelineProcessor'; -import { IEventStorageReader } from './IEventStorageReader'; -import { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage'; -import { IIdentifierProvider } from './IIdentifierProvider'; -import { IExtendableLogger, ILogger } from './ILogger'; -import { IEventStorageWriter } from './IEventStorageWriter'; +import type { ICommandBus } from './ICommandBus.ts'; +import type { IEventDispatcher } from './IEventDispatcher.ts'; +import type { IEventStore } from './IEventStore.ts'; +import type { IEventBus } from './IEventBus.ts'; +import type { IDispatchPipelineProcessor } from './IDispatchPipelineProcessor.ts'; +import type { IEventStorageReader } from './IEventStorageReader.ts'; +import type { IAggregateSnapshotStorage } from './IAggregateSnapshotStorage.ts'; +import type { IIdentifierProvider } from './IIdentifierProvider.ts'; +import type { IExtendableLogger, ILogger } from './ILogger.ts'; +import type { IEventStorageWriter } from './IEventStorageWriter.ts'; export interface IContainer extends Container { eventBus: IEventBus; diff --git a/src/interfaces/IDispatchPipelineProcessor.ts b/src/interfaces/IDispatchPipelineProcessor.ts index 958412f..924313c 100644 --- a/src/interfaces/IDispatchPipelineProcessor.ts +++ b/src/interfaces/IDispatchPipelineProcessor.ts @@ -1,5 +1,5 @@ -import { IEvent } from './IEvent'; -import { isObject } from './isObject'; +import type { IEvent } from './IEvent.ts'; +import { isObject } from './isObject.ts'; /** * Represents a wrapper for an event that can optionally contain additional metadata. diff --git a/src/interfaces/IEvent.ts b/src/interfaces/IEvent.ts index 0b007c9..eabc728 100644 --- a/src/interfaces/IEvent.ts +++ b/src/interfaces/IEvent.ts @@ -1,5 +1,5 @@ -import { IMessage } from './IMessage'; -import { isObject } from './isObject'; +import type { IMessage } from './IMessage.ts'; +import { isObject } from './isObject.ts'; export type IEvent = IMessage & { diff --git a/src/interfaces/IEventBus.ts b/src/interfaces/IEventBus.ts index 69406fb..10bd236 100644 --- a/src/interfaces/IEventBus.ts +++ b/src/interfaces/IEventBus.ts @@ -1,5 +1,5 @@ -import type { IEvent } from './IEvent'; -import { type IObservable, isIObservable } from './IObservable'; +import type { IEvent } from './IEvent.ts'; +import { type IObservable, isIObservable } from './IObservable.ts'; export interface IEventBus extends IObservable { publish(event: IEvent, meta?: Record): Promise; diff --git a/src/interfaces/IEventDispatcher.ts b/src/interfaces/IEventDispatcher.ts index 60a1ce8..a8c3d1d 100644 --- a/src/interfaces/IEventDispatcher.ts +++ b/src/interfaces/IEventDispatcher.ts @@ -1,5 +1,5 @@ -import { IEventSet } from './IEventSet'; -import { IEventBus } from './IEventBus'; +import type { IEventSet } from './IEventSet.ts'; +import type { IEventBus } from './IEventBus.ts'; export interface IEventDispatcher { readonly eventBus: IEventBus; diff --git a/src/interfaces/IEventLocker.ts b/src/interfaces/IEventLocker.ts index c2d0541..0731d7a 100644 --- a/src/interfaces/IEventLocker.ts +++ b/src/interfaces/IEventLocker.ts @@ -1,5 +1,5 @@ -import { IEvent } from './IEvent'; -import { isObject } from './isObject'; +import type { IEvent } from './IEvent.ts'; +import { isObject } from './isObject.ts'; /** * Interface for tracking event processing state to prevent concurrent processing diff --git a/src/interfaces/IEventReceptor.ts b/src/interfaces/IEventReceptor.ts index 722cbde..af34913 100644 --- a/src/interfaces/IEventReceptor.ts +++ b/src/interfaces/IEventReceptor.ts @@ -1,5 +1,5 @@ -import { IEventStore } from './IEventStore'; -import { IObserver } from './IObserver'; +import type { IEventStore } from './IEventStore.ts'; +import type { IObserver } from './IObserver.ts'; export interface IEventReceptor extends IObserver { subscribe(eventStore: IEventStore): void; diff --git a/src/interfaces/IEventSet.ts b/src/interfaces/IEventSet.ts index c06ac83..3d95808 100644 --- a/src/interfaces/IEventSet.ts +++ b/src/interfaces/IEventSet.ts @@ -1,4 +1,4 @@ -import { IEvent, isEvent } from './IEvent'; +import { type IEvent, isEvent } from './IEvent.ts'; export type IEventSet = ReadonlyArray>; diff --git a/src/interfaces/IEventStorageReader.ts b/src/interfaces/IEventStorageReader.ts index ba124b3..9329ae7 100644 --- a/src/interfaces/IEventStorageReader.ts +++ b/src/interfaces/IEventStorageReader.ts @@ -1,7 +1,7 @@ -import { Identifier } from './Identifier'; -import { IEvent } from './IEvent'; -import { IEventStream } from './IEventStream'; -import { isObject } from './isObject'; +import type { Identifier } from './Identifier.ts'; +import type { IEvent } from './IEvent.ts'; +import type { IEventStream } from './IEventStream.ts'; +import { isObject } from './isObject.ts'; export type EventQueryAfter = { diff --git a/src/interfaces/IEventStorageWriter.ts b/src/interfaces/IEventStorageWriter.ts index 03521bc..f5330b5 100644 --- a/src/interfaces/IEventStorageWriter.ts +++ b/src/interfaces/IEventStorageWriter.ts @@ -1,4 +1,4 @@ -import { IEventSet } from './IEventSet'; +import type { IEventSet } from './IEventSet.ts'; export interface IEventStorageWriter { diff --git a/src/interfaces/IEventStore.ts b/src/interfaces/IEventStore.ts index fae2816..07a7b2a 100644 --- a/src/interfaces/IEventStore.ts +++ b/src/interfaces/IEventStore.ts @@ -1,9 +1,9 @@ -import type { IEventDispatcher } from './IEventDispatcher'; -import type { IEvent } from './IEvent'; -import type { IEventStorageReader } from './IEventStorageReader'; -import type { IIdentifierProvider } from './IIdentifierProvider'; -import type { IMessageHandler, IObservable } from './IObservable'; -import type { IObservableQueueProvider } from './IObservableQueueProvider'; +import type { IEventDispatcher } from './IEventDispatcher.ts'; +import type { IEvent } from './IEvent.ts'; +import type { IEventStorageReader } from './IEventStorageReader.ts'; +import type { IIdentifierProvider } from './IIdentifierProvider.ts'; +import type { IMessageHandler, IObservable } from './IObservable.ts'; +import type { IObservableQueueProvider } from './IObservableQueueProvider.ts'; export interface IEventStore extends IObservable, IObservableQueueProvider, IEventDispatcher, IEventStorageReader, IIdentifierProvider { diff --git a/src/interfaces/IEventStream.ts b/src/interfaces/IEventStream.ts index 1f11e35..0739242 100644 --- a/src/interfaces/IEventStream.ts +++ b/src/interfaces/IEventStream.ts @@ -1,3 +1,3 @@ -import { IEvent } from './IEvent'; +import type { IEvent } from './IEvent.ts'; export type IEventStream = AsyncIterableIterator>; diff --git a/src/interfaces/IIdentifierProvider.ts b/src/interfaces/IIdentifierProvider.ts index 2c73090..b168580 100644 --- a/src/interfaces/IIdentifierProvider.ts +++ b/src/interfaces/IIdentifierProvider.ts @@ -1,5 +1,5 @@ -import { Identifier } from './Identifier'; -import { isObject } from './isObject'; +import type { Identifier } from './Identifier.ts'; +import { isObject } from './isObject.ts'; export interface IIdentifierProvider { diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index e5fda28..0fbb4c3 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -1,5 +1,5 @@ -import { Identifier } from './Identifier'; -import { isObject } from './isObject'; +import type { Identifier } from './Identifier.ts'; +import { isObject } from './isObject.ts'; export interface IMessage { diff --git a/src/interfaces/IMessageBus.ts b/src/interfaces/IMessageBus.ts index 44a7ea2..a42e343 100644 --- a/src/interfaces/IMessageBus.ts +++ b/src/interfaces/IMessageBus.ts @@ -1,6 +1,6 @@ -import type { ICommand } from './ICommand'; -import type { IEvent } from './IEvent'; -import type { IObservable } from './IObservable'; +import type { ICommand } from './ICommand.ts'; +import type { IEvent } from './IEvent.ts'; +import type { IObservable } from './IObservable.ts'; export interface IMessageBus extends IObservable { send(command: ICommand): Promise; diff --git a/src/interfaces/IObjectStorage.ts b/src/interfaces/IObjectStorage.ts index e4b651a..3b28bca 100644 --- a/src/interfaces/IObjectStorage.ts +++ b/src/interfaces/IObjectStorage.ts @@ -1,4 +1,4 @@ -import { Identifier } from './Identifier'; +import type { Identifier } from './Identifier.ts'; export interface IObjectStorage { get(id: Identifier): Promise | TRecord | undefined; diff --git a/src/interfaces/IObservable.ts b/src/interfaces/IObservable.ts index f7bdab9..4c62d00 100644 --- a/src/interfaces/IObservable.ts +++ b/src/interfaces/IObservable.ts @@ -1,5 +1,5 @@ -import { IMessage } from './IMessage'; -import { isObject } from './isObject'; +import type { IMessage } from './IMessage.ts'; +import { isObject } from './isObject.ts'; export interface IMessageHandler { (message: IMessage, meta?: Record): any | Promise diff --git a/src/interfaces/IObservableQueueProvider.ts b/src/interfaces/IObservableQueueProvider.ts index 2b32573..437d301 100644 --- a/src/interfaces/IObservableQueueProvider.ts +++ b/src/interfaces/IObservableQueueProvider.ts @@ -1,5 +1,5 @@ -import type { IObservable } from './IObservable'; -import { isObject } from './isObject'; +import type { IObservable } from './IObservable.ts'; +import { isObject } from './isObject.ts'; export interface IObservableQueueProvider { diff --git a/src/interfaces/IObserver.ts b/src/interfaces/IObserver.ts index d822cea..f94bc5e 100644 --- a/src/interfaces/IObserver.ts +++ b/src/interfaces/IObserver.ts @@ -1,4 +1,4 @@ -import { IObservable } from './IObservable'; +import type { IObservable } from './IObservable.ts'; export interface IObserver { subscribe(observable: IObservable): void; diff --git a/src/interfaces/IProjection.ts b/src/interfaces/IProjection.ts index a5d17bb..b6a749d 100644 --- a/src/interfaces/IProjection.ts +++ b/src/interfaces/IProjection.ts @@ -1,7 +1,7 @@ -import type { IObserver } from './IObserver'; -import type { IObservable } from './IObservable'; -import type { IEventStorageReader } from './IEventStorageReader'; -import type { IEvent } from './IEvent'; +import type { IObserver } from './IObserver.ts'; +import type { IObservable } from './IObservable.ts'; +import type { IEventStorageReader } from './IEventStorageReader.ts'; +import type { IEvent } from './IEvent.ts'; export interface IProjection extends IObserver { readonly view: TView; diff --git a/src/interfaces/ISaga.ts b/src/interfaces/ISaga.ts index f4920ba..104f7b3 100644 --- a/src/interfaces/ISaga.ts +++ b/src/interfaces/ISaga.ts @@ -1,7 +1,7 @@ -import { ICommand } from './ICommand'; -import { Identifier } from './Identifier'; -import { IEvent } from './IEvent'; -import { IEventSet } from './IEventSet'; +import type { ICommand } from './ICommand.ts'; +import type { Identifier } from './Identifier.ts'; +import type { IEvent } from './IEvent.ts'; +import type { IEventSet } from './IEventSet.ts'; export interface ISaga { diff --git a/src/interfaces/ISnapshotEvent.ts b/src/interfaces/ISnapshotEvent.ts index 81b61e6..8ca2afe 100644 --- a/src/interfaces/ISnapshotEvent.ts +++ b/src/interfaces/ISnapshotEvent.ts @@ -1,4 +1,4 @@ -import { IEvent, isEvent } from './IEvent'; +import { type IEvent, isEvent } from './IEvent.ts'; export const SNAPSHOT_EVENT_TYPE: 'snapshot' = 'snapshot'; diff --git a/src/interfaces/IViewLocker.ts b/src/interfaces/IViewLocker.ts index 1dd517c..90b3e1b 100644 --- a/src/interfaces/IViewLocker.ts +++ b/src/interfaces/IViewLocker.ts @@ -1,4 +1,4 @@ -import { isObject } from './isObject'; +import { isObject } from './isObject.ts'; /** * Interface for managing view restoration state to prevent early access to an inconsistent view diff --git a/src/interfaces/index.ts b/src/interfaces/index.ts index 424070c..05b5e7a 100644 --- a/src/interfaces/index.ts +++ b/src/interfaces/index.ts @@ -1,29 +1,29 @@ -export * from './IAggregate'; -export * from './IAggregateSnapshotStorage'; -export * from './ICommand'; -export * from './ICommandBus'; -export * from './IContainer'; -export * from './Identifier'; -export * from './IDispatchPipelineProcessor'; -export * from './IEvent'; -export * from './IEventBus'; -export * from './IEventDispatcher'; -export * from './IEventLocker'; -export * from './IEventReceptor'; -export * from './IEventSet'; -export * from './IEventStorageReader'; -export * from './IEventStorageWriter'; -export * from './IEventStore'; -export * from './IEventStream'; -export * from './IIdentifierProvider'; -export * from './ILogger'; -export * from './IMessage'; -export * from './IMessageBus'; -export * from './IObjectStorage'; -export * from './IObservable'; -export * from './IObservableQueueProvider'; -export * from './IObserver'; -export * from './IProjection'; -export * from './ISaga'; -export * from './ISnapshotEvent'; -export * from './IViewLocker'; +export * from './IAggregate.ts'; +export * from './IAggregateSnapshotStorage.ts'; +export * from './ICommand.ts'; +export * from './ICommandBus.ts'; +export * from './IContainer.ts'; +export * from './Identifier.ts'; +export * from './IDispatchPipelineProcessor.ts'; +export * from './IEvent.ts'; +export * from './IEventBus.ts'; +export * from './IEventDispatcher.ts'; +export * from './IEventLocker.ts'; +export * from './IEventReceptor.ts'; +export * from './IEventSet.ts'; +export * from './IEventStorageReader.ts'; +export * from './IEventStorageWriter.ts'; +export * from './IEventStore.ts'; +export * from './IEventStream.ts'; +export * from './IIdentifierProvider.ts'; +export * from './ILogger.ts'; +export * from './IMessage.ts'; +export * from './IMessageBus.ts'; +export * from './IObjectStorage.ts'; +export * from './IObservable.ts'; +export * from './IObservableQueueProvider.ts'; +export * from './IObserver.ts'; +export * from './IProjection.ts'; +export * from './ISaga.ts'; +export * from './ISnapshotEvent.ts'; +export * from './IViewLocker.ts'; diff --git a/src/rabbitmq/IContainer.ts b/src/rabbitmq/IContainer.ts index ceac5c4..936850d 100644 --- a/src/rabbitmq/IContainer.ts +++ b/src/rabbitmq/IContainer.ts @@ -1,4 +1,4 @@ -import { RabbitMqGateway } from './RabbitMqGateway'; +import { RabbitMqGateway } from './RabbitMqGateway.ts'; declare module '../interfaces/IContainer' { interface IContainer { diff --git a/src/rabbitmq/RabbitMqEventBus.ts b/src/rabbitmq/RabbitMqEventBus.ts index 290febb..7a40ce1 100644 --- a/src/rabbitmq/RabbitMqEventBus.ts +++ b/src/rabbitmq/RabbitMqEventBus.ts @@ -1,5 +1,5 @@ -import type { IEvent, IEventBus, IMessageHandler, IObservable, IObservableQueueProvider } from '../interfaces'; -import { RabbitMqGateway } from './RabbitMqGateway'; +import type { IEvent, IEventBus, IMessageHandler, IObservable, IObservableQueueProvider } from '../interfaces/index.ts'; +import { RabbitMqGateway } from './RabbitMqGateway.ts'; /** * RabbitMQ-backed `IEventBus` with named queues support diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index eb3dea5..cbaa6b1 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -1,8 +1,8 @@ import type { Channel, ChannelModel, ConfirmChannel, ConsumeMessage } from 'amqplib'; -import { type IContainer, type ILogger, type IMessage, isMessage } from '../interfaces'; -import * as Event from '../Event'; -import { extractErrorDetails, Lock } from '../utils'; -import { registerExitCleanup } from './utils'; +import { type IContainer, type ILogger, type IMessage, isMessage } from '../interfaces/index.ts'; +import * as Event from '../Event.ts'; +import { extractErrorDetails, Lock } from '../utils/index.ts'; +import { registerExitCleanup } from './utils/index.ts'; import { EventEmitter } from 'events'; /** Generate a short pseudo-unique identifier using a truncated timestamp and random component */ diff --git a/src/rabbitmq/index.ts b/src/rabbitmq/index.ts index 79404df..20d12c6 100644 --- a/src/rabbitmq/index.ts +++ b/src/rabbitmq/index.ts @@ -1,2 +1,2 @@ -export * from './RabbitMqEventBus'; -export * from './RabbitMqGateway'; +export * from './RabbitMqEventBus.ts'; +export * from './RabbitMqGateway.ts'; diff --git a/src/rabbitmq/utils/index.ts b/src/rabbitmq/utils/index.ts index 807ea15..61dbe19 100644 --- a/src/rabbitmq/utils/index.ts +++ b/src/rabbitmq/utils/index.ts @@ -1 +1 @@ -export * from './registerExitCleanup'; +export * from './registerExitCleanup.ts'; diff --git a/src/sqlite/AbstractSqliteAccessor.ts b/src/sqlite/AbstractSqliteAccessor.ts index 9a474cc..8bb0b1f 100644 --- a/src/sqlite/AbstractSqliteAccessor.ts +++ b/src/sqlite/AbstractSqliteAccessor.ts @@ -1,5 +1,5 @@ -import type { IContainer } from '../interfaces'; -import { Lock } from '../utils'; +import type { IContainer } from '../interfaces/index.ts'; +import { Lock } from '../utils/index.ts'; import type { Database } from 'better-sqlite3'; /** diff --git a/src/sqlite/AbstractSqliteObjectProjection.ts b/src/sqlite/AbstractSqliteObjectProjection.ts index acc3c2b..12ef42a 100644 --- a/src/sqlite/AbstractSqliteObjectProjection.ts +++ b/src/sqlite/AbstractSqliteObjectProjection.ts @@ -1,6 +1,6 @@ -import { AbstractProjection } from '../AbstractProjection'; -import { IContainer } from '../interfaces'; -import { SqliteObjectView } from './SqliteObjectView'; +import { AbstractProjection } from '../AbstractProjection.ts'; +import { IContainer } from '../interfaces/index.ts'; +import { SqliteObjectView } from './SqliteObjectView.ts'; export abstract class AbstractSqliteObjectProjection extends AbstractProjection> { diff --git a/src/sqlite/AbstractSqliteView.ts b/src/sqlite/AbstractSqliteView.ts index 55927ba..350abe3 100644 --- a/src/sqlite/AbstractSqliteView.ts +++ b/src/sqlite/AbstractSqliteView.ts @@ -1,7 +1,7 @@ -import { IContainer, IEvent, IEventLocker, ILogger, IViewLocker } from '../interfaces'; -import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker'; -import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker'; -import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; +import { IContainer, IEvent, IEventLocker, ILogger, IViewLocker } from '../interfaces/index.ts'; +import { SqliteViewLocker, SqliteViewLockerParams } from './SqliteViewLocker.ts'; +import { SqliteEventLocker, SqliteEventLockerParams } from './SqliteEventLocker.ts'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor.ts'; /** * Base class for SQLite-backed projection views with restore locking and last-processed-event tracking diff --git a/src/sqlite/SqliteEventLocker.ts b/src/sqlite/SqliteEventLocker.ts index a202060..8df600e 100644 --- a/src/sqlite/SqliteEventLocker.ts +++ b/src/sqlite/SqliteEventLocker.ts @@ -1,10 +1,10 @@ import type { Database, Statement } from 'better-sqlite3'; -import type { IContainer, IEvent, IEventLocker } from '../interfaces'; -import { getEventId } from './utils'; -import { viewLockTableInit, eventLockTableInit } from './queries'; -import type { SqliteViewLockerParams } from './SqliteViewLocker'; -import type { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; -import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; +import type { IContainer, IEvent, IEventLocker } from '../interfaces/index.ts'; +import { getEventId } from './utils/index.ts'; +import { viewLockTableInit, eventLockTableInit } from './queries/index.ts'; +import type { SqliteViewLockerParams } from './SqliteViewLocker.ts'; +import type { SqliteProjectionDataParams } from './SqliteProjectionDataParams.ts'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor.ts'; export type SqliteEventLockerParams = SqliteProjectionDataParams diff --git a/src/sqlite/SqliteObjectStorage.ts b/src/sqlite/SqliteObjectStorage.ts index 9ab3149..262aa97 100644 --- a/src/sqlite/SqliteObjectStorage.ts +++ b/src/sqlite/SqliteObjectStorage.ts @@ -1,7 +1,7 @@ import type { Statement, Database } from 'better-sqlite3'; -import { guid } from './utils'; -import type { IContainer, IObjectStorage } from '../interfaces'; -import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; +import { guid } from './utils/index.ts'; +import type { IContainer, IObjectStorage } from '../interfaces/index.ts'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor.ts'; export class SqliteObjectStorage extends AbstractSqliteAccessor implements IObjectStorage { diff --git a/src/sqlite/SqliteObjectView.ts b/src/sqlite/SqliteObjectView.ts index a110701..47f0c93 100644 --- a/src/sqlite/SqliteObjectView.ts +++ b/src/sqlite/SqliteObjectView.ts @@ -1,6 +1,6 @@ -import { AbstractSqliteView } from './AbstractSqliteView'; -import type { IObjectStorage, IEventLocker } from '../interfaces'; -import { SqliteObjectStorage } from './SqliteObjectStorage'; +import { AbstractSqliteView } from './AbstractSqliteView.ts'; +import type { IObjectStorage, IEventLocker } from '../interfaces/index.ts'; +import { SqliteObjectStorage } from './SqliteObjectStorage.ts'; import type { Database } from 'better-sqlite3'; /** diff --git a/src/sqlite/SqliteViewLocker.ts b/src/sqlite/SqliteViewLocker.ts index 43fd5f1..ad3dee7 100644 --- a/src/sqlite/SqliteViewLocker.ts +++ b/src/sqlite/SqliteViewLocker.ts @@ -1,10 +1,10 @@ import type { Database, Statement } from 'better-sqlite3'; -import type { IContainer, ILogger, IViewLocker } from '../interfaces'; -import { Deferred } from '../utils'; +import type { IContainer, ILogger, IViewLocker } from '../interfaces/index.ts'; +import { Deferred } from '../utils/index.ts'; import { promisify } from 'util'; -import { viewLockTableInit } from './queries'; -import type { SqliteProjectionDataParams } from './SqliteProjectionDataParams'; -import { AbstractSqliteAccessor } from './AbstractSqliteAccessor'; +import { viewLockTableInit } from './queries/index.ts'; +import type { SqliteProjectionDataParams } from './SqliteProjectionDataParams.ts'; +import { AbstractSqliteAccessor } from './AbstractSqliteAccessor.ts'; const delay = promisify(setTimeout); export type SqliteViewLockerParams = SqliteProjectionDataParams & { diff --git a/src/sqlite/index.ts b/src/sqlite/index.ts index 068463a..d90c4c8 100644 --- a/src/sqlite/index.ts +++ b/src/sqlite/index.ts @@ -1,8 +1,8 @@ -export * from './AbstractSqliteAccessor'; -export * from './AbstractSqliteObjectProjection'; -export * from './AbstractSqliteView'; -export * from './SqliteEventLocker'; -export * from './SqliteObjectStorage'; -export * from './SqliteObjectView'; -export * from './SqliteViewLocker'; -export * from './utils'; +export * from './AbstractSqliteAccessor.ts'; +export * from './AbstractSqliteObjectProjection.ts'; +export * from './AbstractSqliteView.ts'; +export * from './SqliteEventLocker.ts'; +export * from './SqliteObjectStorage.ts'; +export * from './SqliteObjectView.ts'; +export * from './SqliteViewLocker.ts'; +export * from './utils/index.ts'; diff --git a/src/sqlite/queries/index.ts b/src/sqlite/queries/index.ts index 7edbb02..93f0de6 100644 --- a/src/sqlite/queries/index.ts +++ b/src/sqlite/queries/index.ts @@ -1,2 +1,2 @@ -export * from './eventLockTableInit'; -export * from './viewLockTableInit'; +export * from './eventLockTableInit.ts'; +export * from './viewLockTableInit.ts'; diff --git a/src/sqlite/utils/getEventId.ts b/src/sqlite/utils/getEventId.ts index 2a99f75..2860279 100644 --- a/src/sqlite/utils/getEventId.ts +++ b/src/sqlite/utils/getEventId.ts @@ -1,6 +1,6 @@ -import { IEvent } from '../../interfaces'; -import { guid } from './guid'; -import md5 = require('md5'); +import { IEvent } from '../../interfaces/index.ts'; +import { guid } from './guid.ts'; +import md5 from 'md5'; /** * Get assigned or generate new event ID from event content diff --git a/src/sqlite/utils/index.ts b/src/sqlite/utils/index.ts index f27b49b..989235a 100644 --- a/src/sqlite/utils/index.ts +++ b/src/sqlite/utils/index.ts @@ -1,2 +1,2 @@ -export * from './guid'; -export * from './getEventId'; +export * from './guid.ts'; +export * from './getEventId.ts'; diff --git a/src/utils/Lock.ts b/src/utils/Lock.ts index 2db3489..5fdf105 100644 --- a/src/utils/Lock.ts +++ b/src/utils/Lock.ts @@ -1,10 +1,14 @@ -import { Deferred } from './Deferred'; +import { Deferred } from './Deferred.ts'; export class LockLease { - constructor( - readonly lock: Lock, - readonly name?: string - ) { } + + readonly lock: Lock; + readonly name?: string; + + constructor(lock: Lock, name?: string) { + this.lock = lock; + this.name = name; + } release() { this.lock.release(this.name); diff --git a/src/utils/getHandler.ts b/src/utils/getHandler.ts index f2de2be..c46b7f0 100644 --- a/src/utils/getHandler.ts +++ b/src/utils/getHandler.ts @@ -1,4 +1,4 @@ -import { IMessageHandler } from '../interfaces'; +import type { IMessageHandler } from '../interfaces/index.ts'; /** * Gets a handler for a specific message type, prefers a public (w\o _ prefix) method, if available diff --git a/src/utils/index.ts b/src/utils/index.ts index 8e8a8da..0ea5231 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,13 +1,13 @@ -export * from './Deferred'; -export * from './getClassName'; -export * from './getHandler'; -export * from './getMessageHandlerNames'; -export * from './isClass'; -export * from './iteratorToArray'; -export * from './Lock'; -export * from './MapAssertable'; -export * from './notEmpty'; -export * from './setupOneTimeEmitterSubscription'; -export * from './subscribe'; -export * from './validateHandlers'; -export * from './extractErrorDetails'; +export * from './Deferred.ts'; +export * from './getClassName.ts'; +export * from './getHandler.ts'; +export * from './getMessageHandlerNames.ts'; +export * from './isClass.ts'; +export * from './iteratorToArray.ts'; +export * from './Lock.ts'; +export * from './MapAssertable.ts'; +export * from './notEmpty.ts'; +export * from './setupOneTimeEmitterSubscription.ts'; +export * from './subscribe.ts'; +export * from './validateHandlers.ts'; +export * from './extractErrorDetails.ts'; diff --git a/src/utils/setupOneTimeEmitterSubscription.ts b/src/utils/setupOneTimeEmitterSubscription.ts index 554d8bf..e39566e 100644 --- a/src/utils/setupOneTimeEmitterSubscription.ts +++ b/src/utils/setupOneTimeEmitterSubscription.ts @@ -1,4 +1,4 @@ -import { IEvent, ILogger, IObservable } from '../interfaces'; +import type { IEvent, ILogger, IObservable } from '../interfaces/index.ts'; /** * Create one-time eventEmitter subscription for one or multiple events that match a filter diff --git a/src/utils/subscribe.ts b/src/utils/subscribe.ts index 9c21664..331b752 100644 --- a/src/utils/subscribe.ts +++ b/src/utils/subscribe.ts @@ -1,6 +1,6 @@ -import { type IMessageHandler, type IObservable, isIObservableQueueProvider } from '../interfaces'; -import { getHandler } from './getHandler'; -import { getMessageHandlerNames } from './getMessageHandlerNames'; +import { type IMessageHandler, type IObservable, isIObservableQueueProvider } from '../interfaces/index.ts'; +import { getHandler } from './getHandler.ts'; +import { getMessageHandlerNames } from './getMessageHandlerNames.ts'; const unique = (arr: T[]): T[] => [...new Set(arr)]; diff --git a/src/utils/validateHandlers.ts b/src/utils/validateHandlers.ts index 7061c34..96ec344 100644 --- a/src/utils/validateHandlers.ts +++ b/src/utils/validateHandlers.ts @@ -1,4 +1,4 @@ -import { getHandler } from './getHandler'; +import { getHandler } from './getHandler.ts'; /** * Ensure instance has handlers declared for all handled message types diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index c7f66af..ae39bd1 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -1,10 +1,10 @@ import { isMainThread, Worker, MessageChannel, parentPort, workerData } from 'node:worker_threads'; -import { AbstractProjection, type AbstractProjectionParams } from '../AbstractProjection'; -import type { IEvent } from '../interfaces'; +import { AbstractProjection, type AbstractProjectionParams } from '../AbstractProjection.ts'; +import type { IEvent } from '../interfaces/index.ts'; import * as Comlink from 'comlink'; -import { nodeEndpoint, createWorker } from './utils'; -import { extractErrorDetails } from '../utils'; -import { isWorkerData, type IWorkerData, type WorkerInitMessage } from './protocol'; +import { nodeEndpoint, createWorker } from './utils/index.ts'; +import { extractErrorDetails } from '../utils/index.ts'; +import { isWorkerData, type IWorkerData, type WorkerInitMessage } from './protocol.ts'; export type AbstractWorkerProjectionParams = AbstractProjectionParams & { diff --git a/src/workers/index.ts b/src/workers/index.ts index f5e88b1..e646338 100644 --- a/src/workers/index.ts +++ b/src/workers/index.ts @@ -1 +1 @@ -export * from './AbstractWorkerProjection'; +export * from './AbstractWorkerProjection.ts'; diff --git a/src/workers/utils/createWorker.ts b/src/workers/utils/createWorker.ts index a31c8d8..7e90eda 100644 --- a/src/workers/utils/createWorker.ts +++ b/src/workers/utils/createWorker.ts @@ -1,6 +1,6 @@ import { Worker } from 'node:worker_threads'; import * as path from 'node:path'; -import { isWorkerInitMessage, type IWorkerData } from '../protocol'; +import { isWorkerInitMessage, type IWorkerData } from '../protocol.ts'; /** * Create a worker instance, await a handshake or a failure diff --git a/src/workers/utils/index.ts b/src/workers/utils/index.ts index d336324..f4cec7a 100644 --- a/src/workers/utils/index.ts +++ b/src/workers/utils/index.ts @@ -1,2 +1,2 @@ -export * from './createWorker'; -export * from './nodeEndpoint'; +export * from './createWorker.ts'; +export * from './nodeEndpoint.ts'; diff --git a/tests/integration/sqlite/SqliteView.test.ts b/tests/integration/sqlite/SqliteView.test.ts index eaf116c..841b709 100644 --- a/tests/integration/sqlite/SqliteView.test.ts +++ b/tests/integration/sqlite/SqliteView.test.ts @@ -1,7 +1,7 @@ import { existsSync, unlinkSync } from 'fs'; import { AbstractProjection, IEvent } from '../../../src'; import { SqliteObjectView } from '../../../src/sqlite'; -import * as createDb from 'better-sqlite3'; +import createDb from 'better-sqlite3'; type UserPayload = { name: string; diff --git a/tests/unit/EventStore.test.ts b/tests/unit/EventStore.test.ts index 59f65a0..2f60713 100644 --- a/tests/unit/EventStore.test.ts +++ b/tests/unit/EventStore.test.ts @@ -1,4 +1,4 @@ -import { EventDispatcher } from '../../dist/EventDispatcher'; +import { EventDispatcher } from '../../dist/cjs/EventDispatcher'; import { IEventDispatcher, InMemoryMessageBus } from '../../src'; import { EventStore } from '../../src/EventStore'; import { diff --git a/tests/unit/dispatch-pipeline.test.ts b/tests/unit/dispatch-pipeline.test.ts index 05dc35b..faa821e 100644 --- a/tests/unit/dispatch-pipeline.test.ts +++ b/tests/unit/dispatch-pipeline.test.ts @@ -1,4 +1,4 @@ -import { InMemorySnapshotStorage } from '../../dist/in-memory/InMemorySnapshotStorage'; +import { InMemorySnapshotStorage } from '../../dist/cjs/in-memory/InMemorySnapshotStorage'; import { ContainerBuilder, IContainer, diff --git a/tests/unit/sqlite/SqliteEventLocker.test.ts b/tests/unit/sqlite/SqliteEventLocker.test.ts index 243e773..7ee7f47 100644 --- a/tests/unit/sqlite/SqliteEventLocker.test.ts +++ b/tests/unit/sqlite/SqliteEventLocker.test.ts @@ -1,4 +1,4 @@ -import * as createDb from 'better-sqlite3'; +import createDb from 'better-sqlite3'; import { SqliteEventLocker } from '../../../src/sqlite/SqliteEventLocker'; import { IEvent } from '../../../src/interfaces'; import { guid } from '../../../src/sqlite'; diff --git a/tests/unit/sqlite/SqliteObjectStorage.test.ts b/tests/unit/sqlite/SqliteObjectStorage.test.ts index cd4bcff..2f6691b 100644 --- a/tests/unit/sqlite/SqliteObjectStorage.test.ts +++ b/tests/unit/sqlite/SqliteObjectStorage.test.ts @@ -1,4 +1,4 @@ -import * as createDb from 'better-sqlite3'; +import createDb from 'better-sqlite3'; import { guid, SqliteObjectStorage } from '../../../src/sqlite'; describe('SqliteObjectStorage', function () { diff --git a/tests/unit/sqlite/SqliteObjectView.test.ts b/tests/unit/sqlite/SqliteObjectView.test.ts index 3aa5de4..685b69f 100644 --- a/tests/unit/sqlite/SqliteObjectView.test.ts +++ b/tests/unit/sqlite/SqliteObjectView.test.ts @@ -1,5 +1,5 @@ import { expect } from 'chai'; -import * as createDb from 'better-sqlite3'; +import createDb from 'better-sqlite3'; import { SqliteObjectView } from '../../../src/sqlite'; import { promisify } from 'util'; const delay = promisify(setTimeout); diff --git a/tests/unit/sqlite/SqliteViewLocker.test.ts b/tests/unit/sqlite/SqliteViewLocker.test.ts index fd0f8c5..107c4bd 100644 --- a/tests/unit/sqlite/SqliteViewLocker.test.ts +++ b/tests/unit/sqlite/SqliteViewLocker.test.ts @@ -1,5 +1,5 @@ import { expect } from 'chai'; -import * as createDb from 'better-sqlite3'; +import createDb from 'better-sqlite3'; import { SqliteViewLocker } from '../../../src/sqlite'; describe('SqliteViewLocker', function () { diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index 28e8e48..2b690f4 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -1,6 +1,4 @@ -/** @type {typeof import('../../../../src/workers')} */ -// @ts-ignore -const workers = require('../../../../dist/workers'); +const workers = require('node-cqrs/workers'); const { AbstractWorkerProjection } = workers; diff --git a/tests/unit/workers/fixtures/ProjectionFixture.ts b/tests/unit/workers/fixtures/ProjectionFixture.ts deleted file mode 100644 index 1cebcfe..0000000 --- a/tests/unit/workers/fixtures/ProjectionFixture.ts +++ /dev/null @@ -1,37 +0,0 @@ -import { AbstractWorkerProjection } from '../../../../src/workers'; - -class ViewFixture { - counter = 0; - - increment() { - this.counter += 1; - } - - getCounter() { - return this.counter; - } -} - -export class ProjectionFixture extends AbstractWorkerProjection { - - get view() { - return super.view; - } - - constructor({ workerModulePath = __filename } = {}) { - super({ - workerModulePath, - view: new ViewFixture() - }); - } - - async somethingHappened() { - this.view.increment(); - } - - async somethingBadHappened() { - throw new Error('boom'); - } -} - -ProjectionFixture.createInstanceIfWorkerThread(); diff --git a/tests/unit/workers/fixtures/jsconfig.json b/tests/unit/workers/fixtures/jsconfig.json new file mode 100644 index 0000000..6653e49 --- /dev/null +++ b/tests/unit/workers/fixtures/jsconfig.json @@ -0,0 +1,32 @@ +{ + "compilerOptions": { + "target": "es2022", + "module": "commonjs", + "moduleResolution": "node", + "checkJs": true, + "allowSyntheticDefaultImports": true, + "resolveJsonModule": true, + "lib": [ + "es2022", + "dom" + ], + "baseUrl": "..", + "paths": { + "node-cqrs": [ + "types/index.d.ts" + ], + "node-cqrs/*": [ + "types/*/index.d.ts" + ] + } + }, + "include": [ + "**/*" + ], + "exclude": [ + "../node_modules", + "../dist", + "**/bundle.js", + "browser-smoke-test/**" + ] +} diff --git a/tsconfig.browser.json b/tsconfig.browser.json new file mode 100644 index 0000000..b36159d --- /dev/null +++ b/tsconfig.browser.json @@ -0,0 +1,11 @@ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "module": "CommonJS", + "target": "ES2019", + "outDir": "./dist/browser/cjs", + "noEmit": false, + "declaration": false + } +} + diff --git a/tsconfig.cjs.json b/tsconfig.cjs.json new file mode 100644 index 0000000..62ca15a --- /dev/null +++ b/tsconfig.cjs.json @@ -0,0 +1,10 @@ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "module": "CommonJS", + "target": "ES2022", + "outDir": "./dist/cjs", + "noEmit": false, + "declaration": false + } +} diff --git a/tsconfig.esm.json b/tsconfig.esm.json new file mode 100644 index 0000000..23392f1 --- /dev/null +++ b/tsconfig.esm.json @@ -0,0 +1,13 @@ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "module": "ES2022", + "target": "ES2022", + "declaration": true, + "declarationDir": "./types", + "declarationMap": false, + "outDir": "./dist/esm", + "noEmit": false, + "noEmitOnError": true + } +} diff --git a/tsconfig.json b/tsconfig.json index 2ac6347..b7330f7 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -1,28 +1,33 @@ { - "compileOnSave": true, - "compilerOptions": { - "module": "CommonJS", - "removeComments": false, - "sourceMap": true, - "alwaysStrict": false, - "outDir": "./dist", - "target": "ES2022", - "declaration": true, - "declarationDir": "./types", - "allowSyntheticDefaultImports": true, - "resolveJsonModule": true, - "strict": true, - "strictNullChecks": true, - "strictFunctionTypes": true, - "strictBindCallApply": true, - "strictPropertyInitialization": true, - "isolatedModules": true - }, - "include": [ - "src/**/*" + "compilerOptions": { + "module": "CommonJS", + "target": "ES2022", + "lib": [ + "ES2022", + "WebWorker" ], - "exclude": [ - "node_modules", - "**/*.spec.ts" - ] -} \ No newline at end of file + "moduleResolution": "node", + "esModuleInterop": true, + "allowSyntheticDefaultImports": true, + "resolveJsonModule": true, + "strict": true, + "strictNullChecks": true, + "strictFunctionTypes": true, + "strictBindCallApply": true, + "strictPropertyInitialization": true, + "isolatedModules": true, + "removeComments": false, + "sourceMap": true, + "alwaysStrict": false, + "noEmit": true, + "allowImportingTsExtensions": true, + "rewriteRelativeImportExtensions": true + }, + "include": [ + "src/**/*" + ], + "exclude": [ + "node_modules", + "**/*.spec.ts" + ] +} From f5a492e55f7e00863182b31b096e735704c0822e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 29 Jan 2026 22:06:03 +0000 Subject: [PATCH 155/169] Fix user-domain file extensions --- examples/user-domain/{UserAggregate.js => UserAggregate.cjs} | 0 .../user-domain/{UsersProjection.js => UsersProjection.cjs} | 0 examples/user-domain/{index.js => index.cjs} | 4 ++-- examples/user-domain/tests/{index.test.js => index.test.cjs} | 2 +- 4 files changed, 3 insertions(+), 3 deletions(-) rename examples/user-domain/{UserAggregate.js => UserAggregate.cjs} (100%) rename examples/user-domain/{UsersProjection.js => UsersProjection.cjs} (100%) rename examples/user-domain/{index.js => index.cjs} (94%) rename examples/user-domain/tests/{index.test.js => index.test.cjs} (99%) diff --git a/examples/user-domain/UserAggregate.js b/examples/user-domain/UserAggregate.cjs similarity index 100% rename from examples/user-domain/UserAggregate.js rename to examples/user-domain/UserAggregate.cjs diff --git a/examples/user-domain/UsersProjection.js b/examples/user-domain/UsersProjection.cjs similarity index 100% rename from examples/user-domain/UsersProjection.js rename to examples/user-domain/UsersProjection.cjs diff --git a/examples/user-domain/index.js b/examples/user-domain/index.cjs similarity index 94% rename from examples/user-domain/index.js rename to examples/user-domain/index.cjs index f0b02ea..2e9f4f4 100644 --- a/examples/user-domain/index.js +++ b/examples/user-domain/index.cjs @@ -10,8 +10,8 @@ const { EventDispatcher, InMemorySnapshotStorage } = require('node-cqrs'); -const UserAggregate = require('./UserAggregate'); -const UsersProjection = require('./UsersProjection'); +const UserAggregate = require('./UserAggregate.cjs'); +const UsersProjection = require('./UsersProjection.cjs'); /** * DI container factory diff --git a/examples/user-domain/tests/index.test.js b/examples/user-domain/tests/index.test.cjs similarity index 99% rename from examples/user-domain/tests/index.test.js rename to examples/user-domain/tests/index.test.cjs index a5367ac..482e6e7 100644 --- a/examples/user-domain/tests/index.test.js +++ b/examples/user-domain/tests/index.test.cjs @@ -1,7 +1,7 @@ 'use strict'; const { expect } = require('chai'); -const { createContainer, createBaseInstances } = require('../index.js'); +const { createContainer, createBaseInstances } = require('../index.cjs'); describe('user-domain example', () => { From 576869bb6cc567745cc7a61f4c80bbf4428362e3 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Sun, 1 Feb 2026 23:52:58 +0000 Subject: [PATCH 156/169] Change: Apache-2.0 License --- LICENSE | 223 ++++++++++++++++++++++++++++++++++++++++++++++----- NOTICE | 15 ++++ README.md | 2 +- package.json | 2 +- 4 files changed, 219 insertions(+), 23 deletions(-) create mode 100644 NOTICE diff --git a/LICENSE b/LICENSE index e02a6fa..d645695 100644 --- a/LICENSE +++ b/LICENSE @@ -1,21 +1,202 @@ -(The MIT License) - -Copyright (c) 2017 Stanislav Natalenko - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..3c2a56c --- /dev/null +++ b/NOTICE @@ -0,0 +1,15 @@ +node-cqrs + +Copyright (c) 2015-2026 Stanislav Natalenko + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/README.md b/README.md index 384bec7..a311c9a 100644 --- a/README.md +++ b/README.md @@ -451,4 +451,4 @@ npm run lint ## License -* [MIT License](https://github.com/snatalenko/node-cqrs/blob/master/LICENSE) +* [Apache-2.0](LICENSE) diff --git a/package.json b/package.json index 0fab651..4fd358f 100644 --- a/package.json +++ b/package.json @@ -74,7 +74,7 @@ "lint": "eslint" }, "author": "@snatalenko", - "license": "MIT", + "license": "Apache-2.0", "homepage": "https://github.com/snatalenko/node-cqrs#readme", "dependencies": { "async-iterable-buffer": "^1.1.0", From e2c4143a7a037b945f82b4203e199981b09ab250 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 2 Feb 2026 00:30:22 +0000 Subject: [PATCH 157/169] Cleanup documentation and interfaces --- README.md | 233 +++++++++++++++++-------------- examples/user-domain-ts/index.ts | 79 +++++++++-- src/CommandBus.ts | 42 ++++-- src/EventStore.ts | 12 +- src/interfaces/ICommand.ts | 2 +- src/interfaces/ICommandBus.ts | 2 +- src/interfaces/IContainer.ts | 2 +- src/interfaces/IMessage.ts | 2 +- src/rabbitmq/RabbitMqGateway.ts | 2 +- tests/unit/CommandBus.test.ts | 1 - 10 files changed, 242 insertions(+), 135 deletions(-) diff --git a/README.md b/README.md index a311c9a..b5f24a1 100644 --- a/README.md +++ b/README.md @@ -7,28 +7,29 @@ node-cqrs [![Coverage Status](https://coveralls.io/repos/github/snatalenko/node-cqrs/badge.svg?branch=master)](https://coveralls.io/github/snatalenko/node-cqrs?branch=master) [![NPM Downloads](https://img.shields.io/npm/dm/node-cqrs.svg)](https://www.npmjs.com/package/node-cqrs) -## Overview +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-own-implementation/index.ts](examples/user-domain-own-implementation/index.ts) -This package provides building blocks for CQRS/ES applications. It was inspired by Lokad.CQRS, -but it isn’t tied to any specific storage implementation or infrastructure. -It favors ES6/TS classes and dependency injection, so you can modify or replace components with your own implementations without patching the library. +This library focuses on the "boring but hard" parts often missing from plain CQRS/ES implementations, but required in distributed environments: -CQRS/ES itself can be implemented with surprisingly little code in a single process. -For a minimal, framework-free example, see [examples/user-domain-own-implementation/index.ts](examples/user-domain-own-implementation/index.ts). +- asynchronous command and event processing with safer wiring +- persistent views with restart catch-up (checkpointing, readiness, locking) +- aggregate snapshots +- extensible event dispatching pipelines (encoding, persistence, distribution) -This library exists to cover the "boring but hard" parts that are usually missing from a plain implementation, including: +It is built around ES6/TypeScript classes and dependency injection, making components easy to replace or customize without patching the library. -- async command/event processing and safer wiring/subscriptions -- persistent views and catch-up on restart (checkpointing, view readiness/locking) -- aggregate snapshots -- extensible event dispatching pipelines (encoding, persistence, distribution, etc.) -At a high level, the command/event flow looks like: +## Overview + +At a high level, the command and event flow looks like this: ![Overview](docs/images/node-cqrs-flow.png) -Commands and events are loosely typed objects that implement the [IMessage](src/interfaces/IMessage.ts) interface: +Commands and events are loosely typed objects implementing the [`IMessage`](src/interfaces/IMessage.ts) interface: ```ts interface IMessage { @@ -45,65 +46,118 @@ interface IMessage { } ``` -Domain business logic typically lives in aggregates, sagas, and projections: +Domain logic is split across three core building blocks: -- **[Aggregates](#aggregates-write-model)** handle commands and emit events -- **[Projections](#projections-and-views-read-model)** listen to events and update views -- **Sagas** handle events and enqueue commands +- **[Aggregates](#aggregates-write-model)** - handle commands and emit events +- **[Projections](#projections-and-views-read-model)** - consume events and update views +- **Sagas** - manage processes by reacting to events and enqueueing follow-up commands -Message delivery is handled by the following components (in order of appearance): +Message delivery is handled by the following components, in order: -- **[Command Bus](src/CommandBus.ts)** delivers commands to command handlers -- **[Aggregate Command Handler](src/AggregateCommandHandler.ts)** restores aggregate state and executes the command -- **[Event Store](src/EventStore.ts)** runs the event dispatching process: - - persists events (via the configured dispatch pipeline) - - then delivers them to event handlers (sagas, projections, custom services) -- **[Saga Event Handler](src/SagaEventHandler.ts)** restores saga state and applies events +- **[Command Bus](src/CommandBus.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 +- **[Saga Event Handler](src/SagaEventHandler.ts)** - restores saga state and applies events -**Tip**: the codebase is intentionally small and readable - `src/`, `tests/`, `examples/` are a good reference if you want to explore behavior in more detail. +**Tip**: the codebase is intentionally small and readable. `src/`, `tests/`, and `examples/` are good entry points for exploring behavior. ### Examples -- [examples/user-domain](examples/user-domain) basic CJS implementation -- [examples/user-domain-ts](examples/user-domain-ts) similar implementation in TS -- [examples/worker-projection](examples/worker-projection) projection in a worker thread +- [examples/browser-smoke-test](examples/browser-smoke-test) - browser smoke test with in-memory storage and buses +- [examples/user-domain](examples/user-domain) - basic CJS implementation - [examples/user-domain-own-implementation](examples/user-domain-own-implementation/index.ts) minimal, framework-free CQRS/ES example in 1 file +- [examples/user-domain-ts](examples/user-domain-ts) - basic TypeScript implementation +- [examples/worker-projection](examples/worker-projection) - projection in a worker thread + +TS examples can be run with `node` without transpiling. -TS examples can be run with `node` without transpiling ## Installation ```bash -npm i node-cqrs +npm install node-cqrs +``` + +### Supported environments + +- Node.js 18+ +- Browser (via [browserify](https://browserify.org)) + +### Optional peer dependencies + +Required only if you use the corresponding infrastructure modules: + +- SQLite: [better-sqlite3](https://www.npmjs.com/package/better-sqlite3), [md5](https://www.npmjs.com/package/md5) +- RabbitMQ: [amqplib](https://www.npmjs.com/package/amqplib) +- Worker threads: [comlink](https://www.npmjs.com/package/comlink) + + +## ContainerBuilder + +The recommended approach is to use dependency injection to wire buses, the event store, +and your aggregates, projections, and sagas: + +```ts +const builder = new ContainerBuilder(); + +// In-memory implementations for local dev/tests +builder.register(InMemoryEventStorage) + .as('identifierProvider') // EventStore dependency to generate new aggregate and saga ID's + .as('eventStorageReader') // EventStore dependency to read events from + .as('eventStorageWriter'); // eventStorageWriter, when provided, is automatically added to the dispatch pipeline + +builder.registerAggregate(UserAggregate); +builder.registerProjection(UsersProjection, 'users'); + +const container = builder.container(); ``` -Tested under +Once created, the container exposes `commandBus` for sending commands and the `users` view managed by the projection. -- Node 18 -- Node 20 -- Node 22 -- Browser (through [browserify](https://browserify.org)) +If you prefer not to use the DI container, the same wiring can be done manually: -### Peer Dependencies +
+Manual setup (without DI container) -If you want to use SQLite, RabbitMQ, or worker threads, the following peer dependencies may be needed: +```ts +const inMemoryMessageBus = new InMemoryMessageBus(); +const eventStorage = new InMemoryEventStorage(); +const eventStore = new EventStore({ + eventStorageReader: eventStorage, + identifierProvider: eventStorage, + eventDispatchPipeline: [eventStorage], + eventBus: inMemoryMessageBus +}); + +const commandBus = new CommandBus(); + +const aggregateCommandHandler = new AggregateCommandHandler({ + eventStore, + aggregateType: UserAggregate +}); +aggregateCommandHandler.subscribe(commandBus); + +const projection = new UsersProjection(); +await projection.subscribe(eventStore); + +const users = projection.view; +``` -- [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) -- [amqplib](https://github.com/amqp-node/amqplib) -- [comlink](https://github.com/GoogleChromeLabs/comlink) +
## Commands -* sent to CommandBus manually -* being handled by [Aggregates](#aggregates-write-model) -* may be enqueued by Sagas +Commands represent intent and are sent to the `CommandBus`: + +- sent to the CommandBus explicitly +- handled by [Aggregates](#aggregates-write-model) +- may be enqueued by Sagas -Command example: +Command example (raw form): ```json { "type": "signupUser", - "aggregateId": null, "payload": { "profile": { "name": "John Doe", @@ -118,11 +172,27 @@ Command example: } ``` +The `commandBus` exposed by the container is an instance of [CommandBus](src/CommandBus.ts) and provides two methods: + +- `sendRaw(command)` - sends a fully constructed command object +- `send(type, aggregateId, { payload, context })` - a shorthand helper for common cases + +Example: + +```ts +commandBus.send('signupUser', undefined, { + payload: { profile, password } +}); +``` + + ## Events -* produced by [Aggregates](#aggregates-write-model) -* persisted to EventStore -* may be handled by [Projections](#projections-and-views-read-model), Sagas and Event Receptors +Events represent facts that have already happened: + +- produced by [Aggregates](#aggregates-write-model) +- persisted by the Event Store +- delivered to [Projections](#projections-and-views-read-model), Sagas, and Event Receptors Event example: @@ -135,7 +205,7 @@ Event example: "profile": { "name": "John Doe", "email": "john@example.com" - }, + }, "passwordHash": "098f6bcd4621d373cade4e832627b4f6" }, "context": { @@ -145,61 +215,6 @@ Event example: } ``` -## ContainerBuilder - -The "happy path" is to use `ContainerBuilder` to wire buses, the event store, and your aggregates/projections/sagas. - -All named component instances are exposed on container through getters and get created upon accessing a getter. -Default `EventStore` and `CommandBus` components are registered upon container instance creation: - -```ts -import { ContainerBuilder, InMemoryEventStorage, type IContainer } from 'node-cqrs'; - -interface MyDiContainer extends IContainer { - /* Any custom services or projection view for typing purposes */ -} - -const builder = new ContainerBuilder(); - -// In-memory implementations for local dev/tests -builder.register(InMemoryEventStorage) - .as('eventStorageReader') - .as('eventStorageWriter'); - -const container = builder.container(); - -container.eventStore; // instance of EventStore -container.commandBus; // instance of CommandBus -``` - -Other components can be registered either as classes or as factories: - -```ts -// class with automatic dependency injection -builder.register(SomeService).as('someService'); - -// OR factory with more precise control -builder.register(container => new SomeService(container.commandBus)).as('someService'); -``` - -Components that aren't going to be accessed directly by name can also be registered in the builder. -Their instances will be created after invoking `container()` method: - -```js -builder.register(SomeEventObserver); -// at this point the registered observer does not exist - -const container = builder.container(); -// now it exists and got all its constructor dependencies -``` - -DI container has a set of methods for CQRS components registration: - -* `registerAggregate(AggregateType)` - registers aggregateCommandHandler, subscribes it to commandBus and wires Aggregate dependencies -* `registerSaga(SagaType)` - registers sagaEventHandler, subscribes it to eventStore and wires Saga dependencies -* `registerProjection(ProjectionType, exposedViewName)` - registers projection, subscribes it to eventStore and exposes associated projection view on the container -* `registerCommandHandler(typeOrFactory)` - registers command handler and subscribes it to commandBus -* `registerEventReceptor(typeOrFactory)` - registers event receptor and subscribes it to eventStore ## Aggregates (write model) @@ -234,7 +249,8 @@ export interface IAggregate { ### AbstractAggregate -[AbstractAggregate](src/AbstractAggregate.ts) is optional but recommended base class that provides the CQRS/ES wiring and covers common edge cases: state restoring, command routing, validation, snapshots. +[AbstractAggregate](src/AbstractAggregate.ts) is optional but recommended base class that provides the CQRS/ES wiring +and covers common edge cases: state restoring, command routing, validation, snapshots. Without an internal state it can be as simple as this: @@ -426,7 +442,7 @@ Cross-process event distribution. import { RabbitMqEventBus, RabbitMqGateway } from 'node-cqrs/rabbitmq'; ``` -- [RabbitMqGateway](src/rabbitmq/RabbitMqGateway.ts) - implements the IObservable interface using RabbitMQ +- [RabbitMqGateway](src/rabbitmq/RabbitMqGateway.ts) — RabbitMQ-based publish/subscribe gateway for commands and events, with durable and transient queue support - [RabbitMqEventBus](src/rabbitmq/RabbitMqEventBus.ts) - RabbitMQ-backed `IEventBus` with named queues support ### Workers @@ -442,10 +458,15 @@ import { AbstractWorkerProjection } from 'node-cqrs/workers'; ## Testing and Contribution ```bash +git clone git@github.com:snatalenko/node-cqrs.git +cd node-cqrs +npm install npm test npm run lint ``` +Code style and formatting are enforced via: + - [editorconfig](http://editorconfig.org) - [eslint](http://eslint.org) diff --git a/examples/user-domain-ts/index.ts b/examples/user-domain-ts/index.ts index c6545e7..492471a 100644 --- a/examples/user-domain-ts/index.ts +++ b/examples/user-domain-ts/index.ts @@ -1,21 +1,32 @@ -import { ContainerBuilder, type IContainer, InMemoryEventStorage } from 'node-cqrs'; +import { + type IContainer, + AggregateCommandHandler, + CommandBus, + ContainerBuilder, + EventStore, + InMemoryEventStorage, + InMemoryMessageBus +} from 'node-cqrs'; import type { ChangePasswordCommandPayload, CreateUserCommandPayload } from './messages.ts'; import { UserAggregate } from './UserAggregate.ts'; import { UsersProjection, type UsersView } from './UsersProjection.ts'; -interface MyDiContainer extends IContainer { - users: UsersView; -} +// Test with DI container +{ + interface MyDiContainer extends IContainer { + users: UsersView; + } + + const builder = new ContainerBuilder(); -const builder = new ContainerBuilder(); -builder.register(InMemoryEventStorage) // In-memory implementations for local dev/tests - .as('eventStorageReader') - .as('eventStorageWriter'); -builder.registerAggregate(UserAggregate); -builder.registerProjection(UsersProjection, 'users'); + builder.register(InMemoryEventStorage) // In-memory implementations for local dev/tests + .as('identifierProvider') // EventStore dependency to generate new aggregate and saga ID's + .as('eventStorageReader') // EventStore dependency to read events from + .as('eventStorageWriter'); // eventStorageWriter, when provided, is automatically added to the dispatch pipeline + builder.registerAggregate(UserAggregate); + builder.registerProjection(UsersProjection, 'users'); -(async function main() { const container = builder.container(); const { users, commandBus } = container; @@ -37,4 +48,48 @@ builder.registerProjection(UsersProjection, 'users'); // eslint-disable-next-line no-console console.log(user); // { username: 'john' } -}()); +} + + +// Same test without DI container +{ + const inMemoryMessageBus = new InMemoryMessageBus(); + const eventStorage = new InMemoryEventStorage(); + const eventStore = new EventStore({ + eventStorageReader: eventStorage, + identifierProvider: eventStorage, + eventDispatchPipeline: [eventStorage], + eventBus: inMemoryMessageBus + }); + + const commandBus = new CommandBus(); + const aggregateCommandHandler = new AggregateCommandHandler({ + eventStore, + aggregateType: UserAggregate + }); + aggregateCommandHandler.subscribe(commandBus); + + const projection = new UsersProjection(); + await projection.subscribe(eventStore); + const users = projection.view; + + + const [userCreatedEvent] = await commandBus.send('createUser', undefined, { + payload: { + username: 'john', + password: 'magic' + } satisfies CreateUserCommandPayload + }); + + await commandBus.send('changePassword', userCreatedEvent.aggregateId as string, { + payload: { + oldPassword: 'magic', + newPassword: 'no magic' + } satisfies ChangePasswordCommandPayload + }); + + const user = await users.get(userCreatedEvent.aggregateId as string); + + // eslint-disable-next-line no-console + console.log(user); +} diff --git a/src/CommandBus.ts b/src/CommandBus.ts index 57a86eb..10fe9d4 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -54,25 +54,49 @@ export class CommandBus implements ICommandBus { */ send( type: string, - aggregateId: string, - options: { payload: TPayload, context: object }, - ...otherArgs: object[] + aggregateId?: string, + options?: { + payload?: TPayload, + context?: object + } + ): Promise; + + /** + * Format and send a command for execution (obsolete signature) + * + * @deprecated Use `send(type, aggregateId, { context, payload })` + */ + send( + type: string, + aggregateId?: string, + context?: object, + payload?: TPayload + ): Promise; + + send( + type: string, + aggregateId?: string, + options?: { + payload?: TPayload, + context?: object + } | object, + payload?: TPayload ): Promise { if (typeof type !== 'string' || !type.length) throw new TypeError('type argument must be a non-empty String'); - if (options && typeof options !== 'object') + if (options !== undefined && (options === null || typeof options !== 'object')) throw new TypeError('options argument, when defined, must be an Object'); - if (otherArgs.length > 1) - throw new TypeError('more than expected arguments supplied'); // obsolete. left for backward compatibility - const optionsContainContext = options && !('context' in options) && !('payload' in options); - if (otherArgs.length || optionsContainContext) { + const isOptionsObject = !!options && ('context' in options || 'payload' in options); + if (!isOptionsObject) { const context = options; - const payload = otherArgs.length ? otherArgs[0] : undefined; return this.sendRaw({ type, aggregateId, context, payload }); } + if (payload !== undefined) + throw new TypeError('more than expected arguments supplied'); + return this.sendRaw({ type, aggregateId, ...options }); } diff --git a/src/EventStore.ts b/src/EventStore.ts index a086fd1..c6d7cf3 100644 --- a/src/EventStore.ts +++ b/src/EventStore.ts @@ -43,6 +43,8 @@ export class EventStore implements IEventStore { snapshotStorage, eventBus, eventDispatcher, + eventDispatchPipeline, + eventDispatchPipelines, logger }: Pick) { if (!eventStorageReader) throw new TypeError('eventStorageReader argument required'); @@ -64,7 +68,11 @@ export class EventStore implements IEventStore { this.#eventStorageReader = eventStorageReader; this.#identifierProvider = identifierProvider; this.#snapshotStorage = snapshotStorage; - this.#eventDispatcher = eventDispatcher ?? new EventDispatcher({ eventBus }); + this.#eventDispatcher = eventDispatcher ?? new EventDispatcher({ + eventBus, + eventDispatchPipeline, + eventDispatchPipelines + }); this.eventBus = eventBus ?? this.#eventDispatcher.eventBus; this.#logger = logger && 'child' in logger ? logger.child({ service: getClassName(this) }) : diff --git a/src/interfaces/ICommand.ts b/src/interfaces/ICommand.ts index ca36031..e674513 100644 --- a/src/interfaces/ICommand.ts +++ b/src/interfaces/ICommand.ts @@ -1,3 +1,3 @@ import type { IMessage } from './IMessage.ts'; -export type ICommand = IMessage; +export type ICommand = Omit, 'aggregateVersion'>; diff --git a/src/interfaces/ICommandBus.ts b/src/interfaces/ICommandBus.ts index 2a5e6a6..edea416 100644 --- a/src/interfaces/ICommandBus.ts +++ b/src/interfaces/ICommandBus.ts @@ -4,7 +4,7 @@ import type { IObservable } from './IObservable.ts'; import type { IObserver } from './IObserver.ts'; export interface ICommandBus extends IObservable { - send(commandType: string, aggregateId: string | undefined, options: { payload?: object, context?: object }): + send(commandType: string, aggregateId?: string, options?: { payload?: object, context?: object }): Promise; sendRaw(command: ICommand): diff --git a/src/interfaces/IContainer.ts b/src/interfaces/IContainer.ts index f7ecfa7..27642d7 100644 --- a/src/interfaces/IContainer.ts +++ b/src/interfaces/IContainer.ts @@ -19,7 +19,7 @@ export interface IContainer extends Container { snapshotStorage?: IAggregateSnapshotStorage; commandBus: ICommandBus; - eventDispatcher: IEventDispatcher; + eventDispatcher?: IEventDispatcher; /** Default event dispatch pipeline */ eventDispatchPipeline?: IDispatchPipelineProcessor[]; diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index 0fbb4c3..aac70db 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -12,7 +12,7 @@ export interface IMessage { */ aggregateId?: Identifier; - /** Aggregate version at the time of the message (usually set on events, optional on commands) */ + /** Aggregate version at the time of the message */ aggregateVersion?: number; /** Saga identifier (used when a saga coordinates multiple steps/commands) */ diff --git a/src/rabbitmq/RabbitMqGateway.ts b/src/rabbitmq/RabbitMqGateway.ts index cbaa6b1..4fbe805 100644 --- a/src/rabbitmq/RabbitMqGateway.ts +++ b/src/rabbitmq/RabbitMqGateway.ts @@ -84,7 +84,7 @@ type GatewayEvents = { }; /** - * RabbitMqGateway implements the IObservable interface using RabbitMQ. + * RabbitMqGateway provides RabbitMQ-based publish/subscribe for ICommand/IEvent-style messages. * * It uses a fanout exchange to broadcast messages to all connected subscribers. * The `on` and `off` methods allow you to register and remove handlers for specific event types. diff --git a/tests/unit/CommandBus.test.ts b/tests/unit/CommandBus.test.ts index 3181ec3..2d20f21 100644 --- a/tests/unit/CommandBus.test.ts +++ b/tests/unit/CommandBus.test.ts @@ -70,7 +70,6 @@ describe('CommandBus', function () { it('validates parameters', () => { expect(() => bus.send(undefined)).to.throw('type argument must be a non-empty String'); - expect(() => bus.send('test', 1, {}, {}, {})).to.throw('more than expected arguments supplied'); }); it('formats a command and passes it to sendRaw', async () => { From fa1f44b7f19f667d83c6bc96b1ebce406ee0071e Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 2 Feb 2026 17:56:21 +0000 Subject: [PATCH 158/169] Remove unused dev dependency; update package-lock --- package-lock.json | 21 +-------------------- package.json | 1 - 2 files changed, 1 insertion(+), 21 deletions(-) diff --git a/package-lock.json b/package-lock.json index 2242ae1..04757fb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -7,14 +7,13 @@ "": { "name": "node-cqrs", "version": "1.0.0-rc.33", - "license": "MIT", + "license": "Apache-2.0", "dependencies": { "async-iterable-buffer": "^1.1.0", "async-parallel-pipe": "^1.0.2", "di0": "^1.2.0" }, "devDependencies": { - "@stylistic/eslint-plugin-ts": "^4.4.1", "@types/amqplib": "^0.10.8", "@types/better-sqlite3": "^7.6.13", "@types/chai": "^4.3.20", @@ -1413,24 +1412,6 @@ "dev": true, "license": "(Unlicense OR Apache-2.0)" }, - "node_modules/@stylistic/eslint-plugin-ts": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/@stylistic/eslint-plugin-ts/-/eslint-plugin-ts-4.4.1.tgz", - "integrity": "sha512-2r6cLcmdF6til66lx8esBYvBvsn7xCmLT50gw/n1rGGlTq/OxeNjBIh4c3VEaDGMa/5TybrZTia6sQUHdIWx1w==", - "dev": true, - "license": "MIT", - "dependencies": { - "@typescript-eslint/utils": "^8.32.1", - "eslint-visitor-keys": "^4.2.0", - "espree": "^10.3.0" - }, - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "peerDependencies": { - "eslint": ">=9.0.0" - } - }, "node_modules/@tsconfig/node10": { "version": "1.0.12", "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.12.tgz", diff --git a/package.json b/package.json index 4fd358f..521dc58 100644 --- a/package.json +++ b/package.json @@ -82,7 +82,6 @@ "di0": "^1.2.0" }, "devDependencies": { - "@stylistic/eslint-plugin-ts": "^4.4.1", "@types/amqplib": "^0.10.8", "@types/better-sqlite3": "^7.6.13", "@types/chai": "^4.3.20", From 45c2132357e5302ec0bb3cd60d2f81c4ddacea3f Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Mon, 2 Feb 2026 20:19:16 +0000 Subject: [PATCH 159/169] Expand Node.js version matrix in CI workflow --- .github/workflows/tests.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 4003a5b..ef44ebb 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -11,7 +11,7 @@ jobs: runs-on: ubuntu-latest strategy: matrix: - node-version: [18.x, 20.x, 22.x] + node-version: [16.x, 24.x, 25.x] steps: - uses: actions/checkout@v4 - name: Use Node.js ${{ matrix.node-version }} From 03c2925b79e2b57e9451ee39d0ad3357ab7a0c9a Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 3 Feb 2026 13:34:09 +0000 Subject: [PATCH 160/169] Fallback to JSON serialization in environments where structuredClone is not available --- src/AbstractAggregate.ts | 6 +++--- src/utils/clone.ts | 11 +++++++++++ src/utils/index.ts | 3 ++- 3 files changed, 16 insertions(+), 4 deletions(-) create mode 100644 src/utils/clone.ts diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 1b8d450..9ee32f5 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -9,7 +9,7 @@ import { SNAPSHOT_EVENT_TYPE } from './interfaces/index.ts'; -import { getClassName, validateHandlers, getHandler, getMessageHandlerNames } from './utils/index.ts'; +import { getClassName, validateHandlers, getHandler, getMessageHandlerNames, clone } from './utils/index.ts'; /** * Base class for Aggregate definition @@ -217,7 +217,7 @@ export abstract class AbstractAggregate(value: T): T { + const sc = (globalThis as any).structuredClone as undefined | ((v: U) => U); + 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) as T; +} diff --git a/src/utils/index.ts b/src/utils/index.ts index 0ea5231..03bc5e9 100644 --- a/src/utils/index.ts +++ b/src/utils/index.ts @@ -1,4 +1,6 @@ +export * from './clone.ts'; export * from './Deferred.ts'; +export * from './extractErrorDetails.ts'; export * from './getClassName.ts'; export * from './getHandler.ts'; export * from './getMessageHandlerNames.ts'; @@ -10,4 +12,3 @@ export * from './notEmpty.ts'; export * from './setupOneTimeEmitterSubscription.ts'; export * from './subscribe.ts'; export * from './validateHandlers.ts'; -export * from './extractErrorDetails.ts'; From 0bca676aabf57dbf06f387ef580b2fac18acd8bf Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 3 Feb 2026 13:49:15 +0000 Subject: [PATCH 161/169] Update Node.js version requirement to 16+ --- README.md | 2 +- package.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b5f24a1..a2800f4 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,7 @@ npm install node-cqrs ### Supported environments -- Node.js 18+ +- Node.js 16+ - Browser (via [browserify](https://browserify.org)) ### Optional peer dependencies diff --git a/package.json b/package.json index 521dc58..a850bda 100644 --- a/package.json +++ b/package.json @@ -54,7 +54,7 @@ "test": "tests" }, "engines": { - "node": ">=18.0.0" + "node": ">=16.0.0" }, "scripts": { "cleanup": "rm -rf ./dist ./types ./coverage", From 4acbd25d207e266a3148f08d6d5ef6047088f37d Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 3 Feb 2026 18:41:24 +0000 Subject: [PATCH 162/169] Fix type definition for createWorkerInstance methods in AbstractWorkerProjection --- src/workers/AbstractWorkerProjection.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/workers/AbstractWorkerProjection.ts b/src/workers/AbstractWorkerProjection.ts index ae39bd1..3a4cfaa 100644 --- a/src/workers/AbstractWorkerProjection.ts +++ b/src/workers/AbstractWorkerProjection.ts @@ -50,7 +50,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection * @param factory - Optional factory function to create the projection instance */ static createWorkerInstance>( - this: new (...args: any[]) => T, + this: new () => T, factory?: () => T ): T { if (!parentPort) @@ -80,7 +80,7 @@ export abstract class AbstractWorkerProjection extends AbstractProjection * In a worker thread, creates and exposes the projection singleton (same as createWorkerInstance). */ static createInstanceIfWorkerThread>( - this: (new (...args: any[]) => T) & { createWorkerInstance: (factory?: () => T) => T }, + this: (new () => T) & { createWorkerInstance: (factory?: () => T) => T }, factory?: () => T ): T | undefined { if (isMainThread) From 8c7b95a7fbdf68858841de5d89721d13f0d84c9b Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 3 Feb 2026 18:52:37 +0000 Subject: [PATCH 163/169] Build: Add pull_request trigger to Coveralls workflow --- .github/workflows/coveralls.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/coveralls.yml b/.github/workflows/coveralls.yml index 413b288..0e3644e 100644 --- a/.github/workflows/coveralls.yml +++ b/.github/workflows/coveralls.yml @@ -4,6 +4,7 @@ on: push: branches: - master + pull_request: jobs: test: From 2650d0e58ee791c9ce7fdf8635af421c2c4080ea Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Tue, 3 Feb 2026 19:52:40 +0000 Subject: [PATCH 164/169] Add missing tests --- .../memory/InMemorySnapshotStorage.test.ts | 59 +++++++++++++++++++ tests/unit/utils/Deferred.test.ts | 30 ++++++++++ tests/unit/utils/clone.test.ts | 54 +++++++++++++++++ tests/unit/utils/extractErrorDetails.test.ts | 49 +++++++++++++++ .../workers/fixtures/ProjectionFixture.cjs | 8 ++- 5 files changed, 199 insertions(+), 1 deletion(-) create mode 100644 tests/unit/memory/InMemorySnapshotStorage.test.ts create mode 100644 tests/unit/utils/Deferred.test.ts create mode 100644 tests/unit/utils/clone.test.ts create mode 100644 tests/unit/utils/extractErrorDetails.test.ts diff --git a/tests/unit/memory/InMemorySnapshotStorage.test.ts b/tests/unit/memory/InMemorySnapshotStorage.test.ts new file mode 100644 index 0000000..a9a422a --- /dev/null +++ b/tests/unit/memory/InMemorySnapshotStorage.test.ts @@ -0,0 +1,59 @@ +import { InMemorySnapshotStorage } from '../../../src/in-memory/InMemorySnapshotStorage.ts'; + +describe('InMemorySnapshotStorage', () => { + + it('saves and retrieves snapshots', async () => { + const storage = new InMemorySnapshotStorage(); + await storage.saveAggregateSnapshot({ + type: 'snapshot', + aggregateId: 'a1', + aggregateVersion: 1 + }); + + const snapshot = await storage.getAggregateSnapshot('a1'); + expect(snapshot).toMatchObject({ type: 'snapshot', aggregateId: 'a1', aggregateVersion: 1 }); + }); + + it('throws on saving snapshot without aggregateId', async () => { + const storage = new InMemorySnapshotStorage(); + await expect(storage.saveAggregateSnapshot({ type: 'snapshot' } as any)).rejects.toThrow('event.aggregateId is required'); + }); + + it('throws on deleting snapshot without aggregateId', async () => { + const storage = new InMemorySnapshotStorage(); + expect(() => storage.deleteAggregateSnapshot({ type: 'snapshot' } as any)).toThrow('snapshotEvent.aggregateId argument required'); + }); + + it('process() persists snapshot events and filters them out from the batch', async () => { + const storage = new InMemorySnapshotStorage(); + + const snapshot1 = { type: 'snapshot', aggregateId: 'a1', aggregateVersion: 1 }; + const event = { type: 'somethingHappened', aggregateId: 'a1', aggregateVersion: 2 }; + const snapshot2 = { type: 'snapshot', aggregateId: 'a2', aggregateVersion: 1 }; + + const batch = [ + { event: snapshot1, origin: 'internal' }, + { event, origin: 'internal' }, + { event: snapshot2, origin: 'internal' } + ]; + + const result = await storage.process(batch as any); + + expect(result).toHaveLength(1); + expect(result[0].event).toEqual(event); + + expect(await storage.getAggregateSnapshot('a1')).toEqual(snapshot1); + expect(await storage.getAggregateSnapshot('a2')).toEqual(snapshot2); + }); + + it('revert() removes snapshots for snapshot events', async () => { + const storage = new InMemorySnapshotStorage(); + + const snapshot = { type: 'snapshot', aggregateId: 'a1', aggregateVersion: 1 }; + await storage.saveAggregateSnapshot(snapshot as any); + expect(await storage.getAggregateSnapshot('a1')).toBeDefined(); + + await storage.revert([{ event: snapshot }] as any); + expect(await storage.getAggregateSnapshot('a1')).toBeUndefined(); + }); +}); diff --git a/tests/unit/utils/Deferred.test.ts b/tests/unit/utils/Deferred.test.ts new file mode 100644 index 0000000..438dacc --- /dev/null +++ b/tests/unit/utils/Deferred.test.ts @@ -0,0 +1,30 @@ +import { Deferred } from '../../../src/utils/Deferred.ts'; + +describe('Deferred', () => { + + it('tracks resolve state', async () => { + const d = new Deferred(); + expect(d.settled).toBe(false); + expect(d.resolved).toBe(false); + expect(d.rejected).toBe(false); + + d.resolve(42); + + expect(d.resolved).toBe(true); + expect(d.rejected).toBe(false); + expect(d.settled).toBe(true); + await expect(d.promise).resolves.toBe(42); + }); + + it('tracks reject state', async () => { + const d = new Deferred(); + + d.reject(new Error('nope')); + + expect(d.resolved).toBe(false); + expect(d.rejected).toBe(true); + expect(d.settled).toBe(true); + await expect(d.promise).rejects.toThrow('nope'); + }); +}); + diff --git a/tests/unit/utils/clone.test.ts b/tests/unit/utils/clone.test.ts new file mode 100644 index 0000000..7274589 --- /dev/null +++ b/tests/unit/utils/clone.test.ts @@ -0,0 +1,54 @@ +import { clone } from '../../../src/utils/clone.ts'; + +describe('clone', () => { + + it('uses structuredClone when available', () => { + const originalStructuredClone = (globalThis as any).structuredClone; + + const structuredCloneMock = jest.fn((v: unknown) => ({ wrapped: v })); + (globalThis as any).structuredClone = structuredCloneMock; + + try { + const value = { a: 1 }; + const result = clone(value); + + expect(structuredCloneMock).toHaveBeenCalledTimes(1); + expect(structuredCloneMock).toHaveBeenCalledWith(value); + expect(result).toEqual({ wrapped: value }); + } + finally { + (globalThis as any).structuredClone = originalStructuredClone; + } + }); + + it('falls back to JSON clone when structuredClone is not available', () => { + const originalStructuredClone = (globalThis as any).structuredClone; + (globalThis as any).structuredClone = undefined; + + try { + const value = { a: 1, nested: { b: 2 } }; + const result = clone(value); + + expect(result).toEqual(value); + expect(result).not.toBe(value); + expect(result.nested).not.toBe(value.nested); + } + finally { + (globalThis as any).structuredClone = originalStructuredClone; + } + }); + + it('throws when JSON serialization fails', () => { + const originalStructuredClone = (globalThis as any).structuredClone; + (globalThis as any).structuredClone = undefined; + + try { + expect(() => clone(() => undefined as any)).toThrow(TypeError); + expect(() => clone(() => undefined as any)).toThrow('Object payload must be JSON-serializable'); + } + finally { + (globalThis as any).structuredClone = originalStructuredClone; + } + }); +}); + diff --git a/tests/unit/utils/extractErrorDetails.test.ts b/tests/unit/utils/extractErrorDetails.test.ts new file mode 100644 index 0000000..727ce56 --- /dev/null +++ b/tests/unit/utils/extractErrorDetails.test.ts @@ -0,0 +1,49 @@ +import { extractErrorDetails } from '../../../src/utils/extractErrorDetails.ts'; + +describe('extractErrorDetails', () => { + + it('extracts name/message/stack for Error instances', () => { + const err = new Error('boom'); + err.name = 'CustomError'; + + const details = extractErrorDetails(err); + expect(details).toMatchObject({ + name: 'CustomError', + message: 'boom' + }); + expect(typeof details.stack === 'string' || details.stack === undefined).toBe(true); + }); + + it('extracts message/name/code from plain objects', () => { + const err = { name: 'PlainError', message: 'bad', code: 'E_BAD' }; + + expect(extractErrorDetails(err)).toEqual({ + name: 'PlainError', + message: 'bad', + code: 'E_BAD' + }); + }); + + it('extracts cause recursively', () => { + const cause = new Error('root'); + const err = new Error('top', { cause }); + + const details = extractErrorDetails(err); + expect(details.message).toBe('top'); + expect(details.cause).toBeDefined(); + expect(details.cause?.message).toBe('root'); + }); + + it('flattens AggregateError messages', () => { + const aggregate = new AggregateError([new Error('a'), { message: 'b' }], 'top'); + const details = extractErrorDetails(aggregate); + + expect(details.message).toBe('top; a; b'); + }); + + it('stringifies non-objects', () => { + expect(extractErrorDetails('x')).toEqual({ name: undefined, message: 'x' }); + expect(extractErrorDetails(123)).toEqual({ name: undefined, message: '123' }); + }); +}); + diff --git a/tests/unit/workers/fixtures/ProjectionFixture.cjs b/tests/unit/workers/fixtures/ProjectionFixture.cjs index 2b690f4..0d64e53 100644 --- a/tests/unit/workers/fixtures/ProjectionFixture.cjs +++ b/tests/unit/workers/fixtures/ProjectionFixture.cjs @@ -1,4 +1,10 @@ -const workers = require('node-cqrs/workers'); +const { isMainThread } = require('node:worker_threads'); + +// In Jest (main thread), import from src/ so coverage is collected from instrumented sources. +// In worker threads, use the built CJS entrypoint because Node can't execute TS without a loader. +const workers = isMainThread ? + require('../../../../src/workers/index.ts') : + require('node-cqrs/workers'); const { AbstractWorkerProjection } = workers; From 03f4bdba1a68e32d630f5b09829e0ed452fde4c7 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 4 Feb 2026 14:23:08 +0000 Subject: [PATCH 165/169] Update emit and makeEvent methods to enforce payload type --- src/AbstractAggregate.ts | 6 ++++-- src/CommandBus.ts | 2 +- src/interfaces/IMessage.ts | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/src/AbstractAggregate.ts b/src/AbstractAggregate.ts index 9ee32f5..6c950bc 100644 --- a/src/AbstractAggregate.ts +++ b/src/AbstractAggregate.ts @@ -162,11 +162,13 @@ export abstract class AbstractAggregate; + protected emit(type: string, payload: TPayload): IEvent; protected emit(type: string, payload?: TPayload): IEvent { if (typeof type !== 'string' || !type.length) throw new TypeError('type argument must be a non-empty string'); - const event = this.makeEvent(type, payload, this.command); + const event = this.makeEvent(type, payload as TPayload, this.command); this.emitRaw(event); @@ -174,7 +176,7 @@ export abstract class AbstractAggregate(type: string, payload?: TPayload, sourceCommand?: ICommand): IEvent { + protected makeEvent(type: string, payload: TPayload, sourceCommand?: ICommand): IEvent { const event: IEvent = { aggregateId: this.id, aggregateVersion: this.version, diff --git a/src/CommandBus.ts b/src/CommandBus.ts index 10fe9d4..d6c49d6 100644 --- a/src/CommandBus.ts +++ b/src/CommandBus.ts @@ -97,7 +97,7 @@ export class CommandBus implements ICommandBus { if (payload !== undefined) throw new TypeError('more than expected arguments supplied'); - return this.sendRaw({ type, aggregateId, ...options }); + return this.sendRaw({ type, aggregateId, ...options } as ICommand); } /** diff --git a/src/interfaces/IMessage.ts b/src/interfaces/IMessage.ts index aac70db..4ebaa13 100644 --- a/src/interfaces/IMessage.ts +++ b/src/interfaces/IMessage.ts @@ -22,7 +22,7 @@ export interface IMessage { sagaVersion?: number; /** Business data */ - payload?: TPayload; + payload: TPayload; /** * Optional metadata/context (e.g. auth info, request id); From e583b12991b710b111e34082540524fbf979ac48 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 4 Feb 2026 22:37:30 +0000 Subject: [PATCH 166/169] Update diagram --- README.md | 2 +- docs/images/node-cqrs-flow.png | Bin 890922 -> 0 bytes docs/images/node-cqrs-flow.svg | 4 ++++ 3 files changed, 5 insertions(+), 1 deletion(-) delete mode 100644 docs/images/node-cqrs-flow.png create mode 100644 docs/images/node-cqrs-flow.svg diff --git a/README.md b/README.md index a2800f4..909097d 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ It is built around ES6/TypeScript classes and dependency injection, making compo At a high level, the command and event flow looks like this: -![Overview](docs/images/node-cqrs-flow.png) +![Overview](docs/images/node-cqrs-flow.svg) Commands and events are loosely typed objects implementing the [`IMessage`](src/interfaces/IMessage.ts) interface: diff --git a/docs/images/node-cqrs-flow.png b/docs/images/node-cqrs-flow.png deleted file mode 100644 index 2d1cd07de0ccd9363f088ba88bc00f8bf1c9d644..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 890922 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

Cty~ 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

ctXCht}vdfsJ0{ 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 D1o($TC^!DqEUYMup>j5P^GJaLW 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�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⋘z*`rawY`U?tpLF_u2e+jyNw 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≧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 i{quW3z}z$d9 + + +
Aggregate Command Handler
Saga Event Handler
"Edit Profile"
Command
Write
API
"Profile Modified"
Event
Aggregate
Saga
Projection
Query Results
View
Command
Bus
Read
API
Past Events
Event Store
 \ No newline at end of file From 13eb0e2b2fc327eef6a990bb15d07ce81d66ea74 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Wed, 4 Feb 2026 22:41:08 +0000 Subject: [PATCH 167/169] Update package-lock --- package-lock.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package-lock.json b/package-lock.json index 04757fb..78fe4a5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -40,7 +40,7 @@ "typescript-eslint": "^8.53.1" }, "engines": { - "node": ">=18.0.0" + "node": ">=16.0.0" }, "peerDependencies": { "amqplib": "^0.10.9", From 405efb06bdceeed723d8f30f3fd98e398cf7a6ec Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 5 Feb 2026 15:03:11 +0000 Subject: [PATCH 168/169] Build: Add eslint to github actions; cleanup eslint rules --- .github/workflows/audit.yml | 21 --- .github/workflows/tests.yml | 31 +++- eslint.config.mjs | 182 +--------------------- examples/user-domain/tests/.eslintrc.json | 8 - 4 files changed, 36 insertions(+), 206 deletions(-) delete mode 100644 .github/workflows/audit.yml delete mode 100644 examples/user-domain/tests/.eslintrc.json diff --git a/.github/workflows/audit.yml b/.github/workflows/audit.yml deleted file mode 100644 index 9ad2354..0000000 --- a/.github/workflows/audit.yml +++ /dev/null @@ -1,21 +0,0 @@ -name: Audit - -on: - push: - branches: - - master - pull_request: - -jobs: - audit: - runs-on: ubuntu-latest - strategy: - matrix: - node-version: [22.x] - steps: - - uses: actions/checkout@v4 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v4 - with: - node-version: ${{ matrix.node-version }} - - run: npm audit --parseable --production --audit-level=moderate diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index ef44ebb..95aaefb 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -7,6 +7,19 @@ on: pull_request: jobs: + audit: + runs-on: ubuntu-latest + strategy: + matrix: + node-version: [24.x] + steps: + - uses: actions/checkout@v4 + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v4 + with: + node-version: ${{ matrix.node-version }} + - run: npm audit --parseable --production --audit-level=moderate + test: runs-on: ubuntu-latest strategy: @@ -18,7 +31,23 @@ jobs: uses: actions/setup-node@v4 with: node-version: ${{ matrix.node-version }} - - run: npm ci --no-optional + - run: npm ci --omit=optional env: CI: true - run: npm run test + + lint: + runs-on: ubuntu-latest + strategy: + matrix: + node-version: [24.x] + steps: + - uses: actions/checkout@v4 + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v4 + with: + node-version: ${{ matrix.node-version }} + - run: npm ci --omit=optional + env: + CI: true + - run: npm run lint diff --git a/eslint.config.mjs b/eslint.config.mjs index 4e2dec9..4f4b779 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -25,8 +25,6 @@ export default defineConfig([ "@typescript-eslint": tsPlugin, }, "rules": { - "no-explicit-any": "off", - "no-unused-vars": "off", "no-use-before-define": "warn", "strict": "off", "@typescript-eslint/no-unused-vars": [ @@ -38,9 +36,6 @@ export default defineConfig([ "argsIgnorePattern": "^(_|err)" } ], - "@typescript-eslint/no-explicit-any": "off", - "@typescript-eslint/no-require-imports": "off", - "@typescript-eslint/no-empty-object-type": "off", "padding-line-between-statements": [ "warn", { @@ -68,13 +63,8 @@ export default defineConfig([ "error", "below" ], - "accessor-pairs": "off", "array-callback-return": "error", "block-scoped-var": "error", - "complexity": [ - "off", - 11 - ], "class-methods-use-this": "warn", "consistent-return": "error", "curly": [ @@ -106,8 +96,6 @@ export default defineConfig([ "no-alert": "error", "no-caller": "error", "no-case-declarations": "error", - "no-div-regex": "off", - "no-else-return": "off", "no-empty-function": [ "error", { @@ -119,7 +107,6 @@ export default defineConfig([ } ], "no-empty-pattern": "error", - "no-eq-null": "off", "no-eval": "error", "no-extend-native": "error", "no-extra-bind": "error", @@ -132,19 +119,7 @@ export default defineConfig([ "exceptions": [] } ], - "no-native-reassign": "off", - "no-implicit-coercion": [ - "off", - { - "boolean": false, - "number": true, - "string": true, - "allow": [] - } - ], - "no-implicit-globals": "off", "no-implied-eval": "error", - "no-invalid-this": "off", "no-iterator": "error", "no-labels": [ "error", @@ -155,15 +130,6 @@ export default defineConfig([ ], "no-lone-blocks": "error", "no-loop-func": "error", - "no-magic-numbers": [ - "off", - { - "ignore": [], - "ignoreArrayIndexes": true, - "enforceConst": true, - "detectObjects": false - } - ], "no-multi-spaces": "error", "no-multi-str": "error", "no-new": "error", @@ -171,12 +137,6 @@ export default defineConfig([ "no-new-wrappers": "error", "no-octal": "error", "no-octal-escape": "error", - "no-param-reassign": [ - "off", - { - "props": true - } - ], "no-proto": "error", "no-redeclare": "error", "no-restricted-properties": [ @@ -207,22 +167,18 @@ export default defineConfig([ "no-self-compare": "error", "no-sequences": "error", "no-throw-literal": "error", - "no-unmodified-loop-condition": "off", - "no-unused-expressions": "off", "no-unused-labels": "error", - "no-useless-call": "off", "no-useless-concat": "error", "no-useless-escape": "error", "no-useless-return": "error", - "no-void": "error", + "no-void": [ + "warn", + { "allowAsStatement": true } + ], "no-warning-comments": [ - "off", + "warn", { - "terms": [ - "todo", - "fixme", - "xxx" - ], + "terms": ["todo", "fixme", "hack"], "location": "start" } ], @@ -238,15 +194,9 @@ export default defineConfig([ ], "yoda": "error", "no-mixed-requires": "error", - "callback-return": "off", "global-require": "error", - "handle-callback-err": "off", "no-new-require": "error", "no-path-concat": "error", - "no-process-env": "off", - "no-process-exit": "off", - "no-restricted-modules": "off", - "no-sync": "off", "arrow-body-style": [ "error", "as-needed" @@ -281,7 +231,6 @@ export default defineConfig([ "no-dupe-class-members": "error", "no-duplicate-imports": "error", "no-new-symbol": "error", - "no-restricted-imports": "off", "no-this-before-super": "error", "no-useless-computed-key": "error", "no-useless-constructor": "error", @@ -302,7 +251,6 @@ export default defineConfig([ "avoidQuotes": true } ], - "prefer-arrow-callback": "off", "prefer-const": [ "error", { @@ -311,7 +259,6 @@ export default defineConfig([ } ], "prefer-numeric-literals": "error", - "prefer-reflect": "off", "prefer-rest-params": "error", "prefer-spread": "error", "prefer-template": "error", @@ -320,19 +267,6 @@ export default defineConfig([ "error", "never" ], - "sort-imports": [ - "off", - { - "ignoreCase": false, - "ignoreMemberSort": false, - "memberSyntaxSortOrder": [ - "none", - "all", - "multiple", - "single" - ] - } - ], "symbol-description": "error", "template-curly-spacing": "error", "yield-star-spacing": [ @@ -358,15 +292,6 @@ export default defineConfig([ "no-empty-character-class": "error", "no-ex-assign": "error", "no-extra-boolean-cast": "error", - "no-extra-parens": [ - "off", - "all", - { - "conditionalAssign": true, - "nestedBinaryExpressions": false, - "returnAssign": false - } - ], "no-extra-semi": "error", "no-func-assign": "error", "no-inner-declarations": "error", @@ -380,9 +305,7 @@ export default defineConfig([ "no-unexpected-multiline": "error", "no-unsafe-finally": "error", "no-unsafe-negation": "error", - "no-negated-in-lhs": "off", "use-isnan": "error", - "valid-jsdoc": "off", "valid-typeof": [ "error", { @@ -425,7 +348,6 @@ export default defineConfig([ "error", "never" ], - "consistent-this": "off", "eol-last": [ "error", "always" @@ -434,20 +356,6 @@ export default defineConfig([ "error", "never" ], - "func-name-matching": [ - "off", - "always", - { - "includeCommonJSModuleExports": false - } - ], - "func-style": [ - "off", - "expression" - ], - "id-blacklist": "off", - "id-length": "off", - "id-match": "off", "indent": [ "error", "tab", @@ -465,10 +373,6 @@ export default defineConfig([ } } ], - "jsx-quotes": [ - "off", - "prefer-double" - ], "key-spacing": [ "error", { @@ -494,14 +398,6 @@ export default defineConfig([ } } ], - "line-comment-position": [ - "off", - { - "position": "above", - "ignorePattern": "", - "applyDefaultPatterns": true - } - ], "linebreak-style": [ "error", "unix" @@ -525,10 +421,6 @@ export default defineConfig([ "after": "always" } ], - "max-depth": [ - "off", - 4 - ], "max-len": [ "warn", 120, @@ -541,33 +433,10 @@ export default defineConfig([ "ignoreTemplateLiterals": true } ], - "max-lines": [ - "off", - { - "max": 300, - "skipBlankLines": true, - "skipComments": true - } - ], - "max-nested-callbacks": "off", "max-params": [ "warn", 5 ], - "max-statements": [ - "off", - 10 - ], - "max-statements-per-line": [ - "off", - { - "max": 1 - } - ], - "multiline-ternary": [ - "off", - "never" - ], "new-cap": [ "error", { @@ -582,8 +451,6 @@ export default defineConfig([ } ], "new-parens": "error", - "newline-after-var": "off", - "newline-before-return": "off", "newline-per-chained-call": [ "error", { @@ -592,8 +459,6 @@ export default defineConfig([ ], "no-array-constructor": "error", "no-bitwise": "error", - "no-continue": "off", - "no-inline-comments": "off", "no-lonely-if": "error", "no-mixed-operators": [ "error", @@ -646,7 +511,6 @@ export default defineConfig([ "maxEOF": 1 } ], - "no-negated-condition": "off", "no-nested-ternary": "error", "no-new-object": "error", "no-restricted-syntax": [ @@ -656,14 +520,7 @@ export default defineConfig([ "WithStatement" ], "no-spaced-func": "error", - "no-ternary": "off", "no-trailing-spaces": "error", - "no-underscore-dangle": [ - "off", - { - "allowAfterThis": true - } - ], "no-unneeded-ternary": [ "error", { @@ -675,19 +532,6 @@ export default defineConfig([ "error", "always" ], - "object-curly-newline": [ - "off", - { - "ObjectExpression": { - "minProperties": 0, - "multiline": true - }, - "ObjectPattern": { - "minProperties": 0, - "multiline": true - } - } - ], "object-property-newline": [ "error", { @@ -706,11 +550,6 @@ export default defineConfig([ "error", "always" ], - "operator-linebreak": "off", - "padded-blocks": [ - "off", - "never" - ], "quote-props": [ "error", "as-needed", @@ -727,7 +566,6 @@ export default defineConfig([ "avoidEscape": true } ], - "require-jsdoc": "off", "semi": [ "error", "always" @@ -739,14 +577,6 @@ export default defineConfig([ "after": true } ], - "sort-keys": [ - "off", - "asc", - { - "caseSensitive": false, - "natural": true - } - ], "sort-vars": "off", "space-before-blocks": "error", "space-before-function-paren": [ diff --git a/examples/user-domain/tests/.eslintrc.json b/examples/user-domain/tests/.eslintrc.json deleted file mode 100644 index bbd5fb1..0000000 --- a/examples/user-domain/tests/.eslintrc.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "env": { - "mocha": true - }, - "rules": { - "no-unused-expressions": "off" - } -} From 025edb8833d65ea07760ac7b8a1a416df5972955 Mon Sep 17 00:00:00 2001 From: Stanislav Natalenko Date: Thu, 5 Feb 2026 15:04:15 +0000 Subject: [PATCH 169/169] Change: publish events asynchronously without awaiting for subscribers to complete --- src/EventDispatchPipeline.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/EventDispatchPipeline.ts b/src/EventDispatchPipeline.ts index bd32315..7f6cc68 100644 --- a/src/EventDispatchPipeline.ts +++ b/src/EventDispatchPipeline.ts @@ -84,7 +84,7 @@ export class EventDispatchPipeline { if (isSnapshotEvent(event)) continue; - await this.#eventBus.publish(event, meta); + void this.#eventBus.publish(event, meta); events.push(event); }

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 z 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 z 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 ^?7zb+SjgTfadrgpn@)^*r?S^%qy< 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 z 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�n+f6!EzQz>>zL=0zACR2SLV5@8ZC9 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 }$?q>9K<@pP&wb9M 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