@flusys/nestjs-shared 6.4.0 → 7.0.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +437 -0
- package/cjs/classes/api-service.class.js +71 -8
- package/cjs/classes/api-service.class.spec.js +220 -0
- package/cjs/classes/disabled-event-bus.class.js +15 -0
- package/cjs/classes/disabled-event-bus.class.spec.js +40 -0
- package/cjs/classes/domain-event.publisher.js +76 -0
- package/cjs/classes/domain-event.publisher.spec.js +234 -0
- package/cjs/classes/event-bus.registry.js +69 -0
- package/cjs/classes/event-bus.registry.spec.js +116 -0
- package/cjs/classes/event-transports/event-transport.registry.js +41 -0
- package/cjs/classes/event-transports/event-transport.registry.spec.js +31 -0
- package/cjs/classes/event-transports/index.js +23 -0
- package/cjs/classes/event-transports/kafka-transport.optional.js +151 -0
- package/cjs/classes/event-transports/kafka-transport.optional.spec.js +199 -0
- package/cjs/classes/event-transports/memory-transport.js +54 -0
- package/cjs/classes/event-transports/memory-transport.spec.js +58 -0
- package/cjs/classes/event-transports/rabbitmq-transport.optional.js +184 -0
- package/cjs/classes/event-transports/rabbitmq-transport.optional.spec.js +256 -0
- package/cjs/classes/hybrid-event-bus.class.js +261 -0
- package/cjs/classes/hybrid-event-bus.class.spec.js +189 -0
- package/cjs/classes/index.js +5 -0
- package/cjs/constants/index.js +24 -0
- package/cjs/decorators/index.js +1 -0
- package/cjs/decorators/on-domain-event.decorator.js +13 -0
- package/cjs/decorators/on-domain-event.decorator.spec.js +50 -0
- package/cjs/entities/user-root.js +2 -2
- package/cjs/enums/event-action.enum.js +18 -0
- package/cjs/enums/index.js +1 -0
- package/cjs/interfaces/event-bus.interface.js +4 -0
- package/cjs/interfaces/index.js +1 -0
- package/cjs/modules/event-bus/event-bus.explorer.js +124 -0
- package/cjs/modules/event-bus/event-bus.explorer.spec.js +189 -0
- package/cjs/modules/event-bus/event-bus.integration.spec.js +254 -0
- package/cjs/modules/event-bus/event-bus.module.js +94 -0
- package/cjs/modules/event-bus/event-bus.module.spec.js +149 -0
- package/cjs/modules/event-bus/module-events.provider.js +39 -0
- package/cjs/modules/event-bus/module-events.provider.spec.js +56 -0
- package/cjs/modules/index.js +3 -0
- package/cjs/utils/event-pattern.util.js +98 -0
- package/cjs/utils/event-pattern.util.spec.js +234 -0
- package/cjs/utils/index.js +2 -0
- package/cjs/utils/optional-module.util.js +35 -0
- package/cjs/utils/optional-module.util.spec.js +14 -0
- package/classes/api-service.class.d.ts +11 -1
- package/classes/disabled-event-bus.class.d.ts +6 -0
- package/classes/domain-event.publisher.d.ts +14 -0
- package/classes/event-bus.registry.d.ts +14 -0
- package/classes/event-transports/event-transport.registry.d.ts +10 -0
- package/classes/event-transports/index.d.ts +2 -0
- package/classes/event-transports/kafka-transport.optional.d.ts +21 -0
- package/classes/event-transports/memory-transport.d.ts +13 -0
- package/classes/event-transports/rabbitmq-transport.optional.d.ts +27 -0
- package/classes/hybrid-event-bus.class.d.ts +32 -0
- package/classes/index.d.ts +5 -0
- package/constants/index.d.ts +6 -0
- package/decorators/index.d.ts +1 -0
- package/decorators/on-domain-event.decorator.d.ts +1 -0
- package/enums/event-action.enum.d.ts +7 -0
- package/enums/index.d.ts +1 -0
- package/fesm/classes/api-service.class.js +71 -8
- package/fesm/classes/api-service.class.spec.js +220 -0
- package/fesm/classes/disabled-event-bus.class.js +11 -0
- package/fesm/classes/disabled-event-bus.class.spec.js +36 -0
- package/fesm/classes/domain-event.publisher.js +63 -0
- package/fesm/classes/domain-event.publisher.spec.js +230 -0
- package/fesm/classes/event-bus.registry.js +65 -0
- package/fesm/classes/event-bus.registry.spec.js +112 -0
- package/fesm/classes/event-transports/event-transport.registry.js +35 -0
- package/fesm/classes/event-transports/event-transport.registry.spec.js +27 -0
- package/fesm/classes/event-transports/index.js +6 -0
- package/fesm/classes/event-transports/kafka-transport.optional.js +144 -0
- package/fesm/classes/event-transports/kafka-transport.optional.spec.js +195 -0
- package/fesm/classes/event-transports/memory-transport.js +46 -0
- package/fesm/classes/event-transports/memory-transport.spec.js +54 -0
- package/fesm/classes/event-transports/rabbitmq-transport.optional.js +174 -0
- package/fesm/classes/event-transports/rabbitmq-transport.optional.spec.js +252 -0
- package/fesm/classes/hybrid-event-bus.class.js +217 -0
- package/fesm/classes/hybrid-event-bus.class.spec.js +185 -0
- package/fesm/classes/index.js +5 -0
- package/fesm/constants/index.js +7 -0
- package/fesm/decorators/index.js +1 -0
- package/fesm/decorators/on-domain-event.decorator.js +10 -0
- package/fesm/decorators/on-domain-event.decorator.spec.js +46 -0
- package/fesm/entities/user-root.js +1 -1
- package/fesm/enums/event-action.enum.js +8 -0
- package/fesm/enums/index.js +1 -0
- package/fesm/interfaces/event-bus.interface.js +1 -0
- package/fesm/interfaces/index.js +1 -0
- package/fesm/modules/event-bus/event-bus.explorer.js +114 -0
- package/fesm/modules/event-bus/event-bus.explorer.spec.js +185 -0
- package/fesm/modules/event-bus/event-bus.integration.spec.js +250 -0
- package/fesm/modules/event-bus/event-bus.module.js +84 -0
- package/fesm/modules/event-bus/event-bus.module.spec.js +145 -0
- package/fesm/modules/event-bus/module-events.provider.js +26 -0
- package/fesm/modules/event-bus/module-events.provider.spec.js +52 -0
- package/fesm/modules/index.js +3 -0
- package/fesm/utils/event-pattern.util.js +86 -0
- package/fesm/utils/event-pattern.util.spec.js +230 -0
- package/fesm/utils/index.js +2 -0
- package/fesm/utils/optional-module.util.js +25 -0
- package/fesm/utils/optional-module.util.spec.js +10 -0
- package/interfaces/event-bus.interface.d.ts +74 -0
- package/interfaces/index.d.ts +1 -0
- package/modules/event-bus/event-bus.explorer.d.ts +14 -0
- package/modules/event-bus/event-bus.module.d.ts +8 -0
- package/modules/event-bus/module-events.provider.d.ts +3 -0
- package/modules/index.d.ts +3 -0
- package/package.json +2 -2
- package/utils/event-pattern.util.d.ts +3 -0
- package/utils/index.d.ts +2 -0
- package/utils/optional-module.util.d.ts +1 -0
|
@@ -0,0 +1,261 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", {
|
|
3
|
+
value: true
|
|
4
|
+
});
|
|
5
|
+
Object.defineProperty(exports, "HybridEventBus", {
|
|
6
|
+
enumerable: true,
|
|
7
|
+
get: function() {
|
|
8
|
+
return HybridEventBus;
|
|
9
|
+
}
|
|
10
|
+
});
|
|
11
|
+
const _config = require("@flusys/nestjs-core/config");
|
|
12
|
+
const _common = require("@nestjs/common");
|
|
13
|
+
const _eventpatternutil = require("../utils/event-pattern.util");
|
|
14
|
+
const _eventtransportregistry = require("./event-transports/event-transport.registry");
|
|
15
|
+
const _memorytransport = require("./event-transports/memory-transport");
|
|
16
|
+
function _define_property(obj, key, value) {
|
|
17
|
+
if (key in obj) {
|
|
18
|
+
Object.defineProperty(obj, key, {
|
|
19
|
+
value: value,
|
|
20
|
+
enumerable: true,
|
|
21
|
+
configurable: true,
|
|
22
|
+
writable: true
|
|
23
|
+
});
|
|
24
|
+
} else {
|
|
25
|
+
obj[key] = value;
|
|
26
|
+
}
|
|
27
|
+
return obj;
|
|
28
|
+
}
|
|
29
|
+
function _getRequireWildcardCache(nodeInterop) {
|
|
30
|
+
if (typeof WeakMap !== "function") return null;
|
|
31
|
+
var cacheBabelInterop = new WeakMap();
|
|
32
|
+
var cacheNodeInterop = new WeakMap();
|
|
33
|
+
return (_getRequireWildcardCache = function(nodeInterop) {
|
|
34
|
+
return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
|
|
35
|
+
})(nodeInterop);
|
|
36
|
+
}
|
|
37
|
+
function _interop_require_wildcard(obj, nodeInterop) {
|
|
38
|
+
if (!nodeInterop && obj && obj.__esModule) {
|
|
39
|
+
return obj;
|
|
40
|
+
}
|
|
41
|
+
if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
|
|
42
|
+
return {
|
|
43
|
+
default: obj
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
var cache = _getRequireWildcardCache(nodeInterop);
|
|
47
|
+
if (cache && cache.has(obj)) {
|
|
48
|
+
return cache.get(obj);
|
|
49
|
+
}
|
|
50
|
+
var newObj = {
|
|
51
|
+
__proto__: null
|
|
52
|
+
};
|
|
53
|
+
var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
|
|
54
|
+
for(var key in obj){
|
|
55
|
+
if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
|
|
56
|
+
var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
|
|
57
|
+
if (desc && (desc.get || desc.set)) {
|
|
58
|
+
Object.defineProperty(newObj, key, desc);
|
|
59
|
+
} else {
|
|
60
|
+
newObj[key] = obj[key];
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
newObj.default = obj;
|
|
65
|
+
if (cache) {
|
|
66
|
+
cache.set(obj, newObj);
|
|
67
|
+
}
|
|
68
|
+
return newObj;
|
|
69
|
+
}
|
|
70
|
+
const DEFAULT_DEDUPE_SIZE = 5000;
|
|
71
|
+
let HybridEventBus = class HybridEventBus {
|
|
72
|
+
getTransportLabel() {
|
|
73
|
+
return this.label;
|
|
74
|
+
}
|
|
75
|
+
getActiveTransports() {
|
|
76
|
+
return this.transports.map((transport)=>transport.name);
|
|
77
|
+
}
|
|
78
|
+
async connect() {
|
|
79
|
+
if (this.connected) return;
|
|
80
|
+
if (!this.connecting) {
|
|
81
|
+
this.connecting = this.buildTransports().catch((error)=>{
|
|
82
|
+
// A cached rejection would leave the bus dead for the process lifetime
|
|
83
|
+
this.connecting = undefined;
|
|
84
|
+
throw error;
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
await this.connecting;
|
|
88
|
+
this.connected = true;
|
|
89
|
+
}
|
|
90
|
+
async publish(event) {
|
|
91
|
+
if (!await this.ensureConnected()) return;
|
|
92
|
+
await Promise.all(this.transports.map((transport)=>transport.publish(event).catch((error)=>{
|
|
93
|
+
this.logger.warn(`Publish failed on ${transport.name}: ${error.message}`);
|
|
94
|
+
})));
|
|
95
|
+
}
|
|
96
|
+
async subscribe(pattern, handler) {
|
|
97
|
+
this.subscriptions.push({
|
|
98
|
+
pattern,
|
|
99
|
+
handler: handler
|
|
100
|
+
});
|
|
101
|
+
if (!await this.ensureConnected()) return;
|
|
102
|
+
await Promise.all(this.transports.map((transport)=>transport.bind(pattern).catch((error)=>{
|
|
103
|
+
this.logger.warn(`Bind failed on ${transport.name}: ${error.message}`);
|
|
104
|
+
})));
|
|
105
|
+
}
|
|
106
|
+
async close() {
|
|
107
|
+
await Promise.allSettled(this.transports.map((transport)=>transport.close()));
|
|
108
|
+
this.transports.length = 0;
|
|
109
|
+
this.subscriptions.length = 0;
|
|
110
|
+
this.seenIds.clear();
|
|
111
|
+
this.seenOrder.length = 0;
|
|
112
|
+
this.memory = undefined;
|
|
113
|
+
this.connecting = undefined;
|
|
114
|
+
this.connected = false;
|
|
115
|
+
}
|
|
116
|
+
// ─── Private Helpers ────────────────────────────────────────────────────────
|
|
117
|
+
/**
|
|
118
|
+
* Connecting must never throw at the call site - a bus that cannot start is
|
|
119
|
+
* a degraded system, not a failed request. The next call retries.
|
|
120
|
+
*/ async ensureConnected() {
|
|
121
|
+
try {
|
|
122
|
+
await this.connect();
|
|
123
|
+
return true;
|
|
124
|
+
} catch (error) {
|
|
125
|
+
const message = error instanceof Error ? error.message : 'Unknown error';
|
|
126
|
+
this.logger.error(`Event bus is not available: ${message}`);
|
|
127
|
+
return false;
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
resolveLabelFromEnv() {
|
|
131
|
+
const value = _config.envConfig.tryGetValue('USE_EVENT_LABEL', false) || 'memory';
|
|
132
|
+
return value;
|
|
133
|
+
}
|
|
134
|
+
async buildTransports() {
|
|
135
|
+
if (this.label === 'memory' || this.label === 'hybrid') {
|
|
136
|
+
this.memory = new _memorytransport.MemoryTransport();
|
|
137
|
+
await this.memory.connect();
|
|
138
|
+
this.registerTransport(this.memory);
|
|
139
|
+
}
|
|
140
|
+
if (this.label !== 'memory') {
|
|
141
|
+
const broker = await this.createBrokerTransport(this.label);
|
|
142
|
+
if (broker) {
|
|
143
|
+
this.registerTransport(broker);
|
|
144
|
+
} else {
|
|
145
|
+
this.logger.error(`Event transport '${this.label}' was requested but is unavailable - delivering ` + `in-process only, so no event will reach another service. Check the broker URL ` + `and that its driver is installed.`);
|
|
146
|
+
if (!this.memory) {
|
|
147
|
+
this.memory = new _memorytransport.MemoryTransport();
|
|
148
|
+
await this.memory.connect();
|
|
149
|
+
this.registerTransport(this.memory);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
async createBrokerTransport(label) {
|
|
155
|
+
const name = label === 'hybrid' ? this.resolveHybridBrokerName() : label;
|
|
156
|
+
try {
|
|
157
|
+
await this.loadOptionalTransport(name);
|
|
158
|
+
const factory = _eventtransportregistry.EventTransportRegistry.get(name);
|
|
159
|
+
if (!factory) {
|
|
160
|
+
this.logger.error(`Event transport '${name}' is not registered. Available: ${_eventtransportregistry.EventTransportRegistry.getAll().join(', ')}`);
|
|
161
|
+
return undefined;
|
|
162
|
+
}
|
|
163
|
+
const transport = factory(this.getTransportConfig(name));
|
|
164
|
+
await transport.connect();
|
|
165
|
+
return transport;
|
|
166
|
+
} catch (error) {
|
|
167
|
+
const message = error instanceof Error ? error.message : 'Unknown error';
|
|
168
|
+
this.logger.error(`Failed to start the '${name}' event transport: ${message}`);
|
|
169
|
+
return undefined;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
resolveHybridBrokerName() {
|
|
173
|
+
return _config.envConfig.tryGetValue('EVENT_BROKER', false) || 'rabbitmq';
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* Registers explicitly rather than relying on the transport file's own
|
|
177
|
+
* side effect, which a tree shaking bundler is free to drop.
|
|
178
|
+
*/ async loadOptionalTransport(name) {
|
|
179
|
+
if (_eventtransportregistry.EventTransportRegistry.has(name)) return;
|
|
180
|
+
if (name === 'rabbitmq') {
|
|
181
|
+
const { RabbitMqTransport } = await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("./event-transports/rabbitmq-transport.optional")));
|
|
182
|
+
_eventtransportregistry.EventTransportRegistry.register('rabbitmq', (config)=>new RabbitMqTransport(config));
|
|
183
|
+
return;
|
|
184
|
+
}
|
|
185
|
+
if (name === 'kafka') {
|
|
186
|
+
const { KafkaTransport } = await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("./event-transports/kafka-transport.optional")));
|
|
187
|
+
_eventtransportregistry.EventTransportRegistry.register('kafka', (config)=>new KafkaTransport(config));
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
getTransportConfig(name) {
|
|
191
|
+
if (name === 'rabbitmq') {
|
|
192
|
+
return {
|
|
193
|
+
url: _config.envConfig.tryGetValue('RABBITMQ_URL', false) || undefined,
|
|
194
|
+
queue: this.options.serviceName ? `${this.options.serviceName}.events` : undefined,
|
|
195
|
+
...this.options.rabbitmq ?? {}
|
|
196
|
+
};
|
|
197
|
+
}
|
|
198
|
+
if (name === 'kafka') {
|
|
199
|
+
return {
|
|
200
|
+
brokers: this.parseBrokers(_config.envConfig.tryGetValue('KAFKA_BROKERS', false)),
|
|
201
|
+
clientId: this.options.serviceName,
|
|
202
|
+
groupId: this.options.serviceName ? `${this.options.serviceName}-events` : undefined,
|
|
203
|
+
...this.options.kafka ?? {}
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
return {};
|
|
207
|
+
}
|
|
208
|
+
parseBrokers(value) {
|
|
209
|
+
if (!value) return undefined;
|
|
210
|
+
return value.split(',').map((broker)=>broker.trim()).filter(Boolean);
|
|
211
|
+
}
|
|
212
|
+
registerTransport(transport) {
|
|
213
|
+
transport.onMessage((event)=>this.dispatch(event));
|
|
214
|
+
this.transports.push(transport);
|
|
215
|
+
}
|
|
216
|
+
async dispatch(event) {
|
|
217
|
+
if (this.isDuplicate(event.id)) return;
|
|
218
|
+
const matched = this.subscriptions.filter((subscription)=>(0, _eventpatternutil.matchEventPattern)(subscription.pattern, event.name));
|
|
219
|
+
await Promise.all(matched.map(async (subscription)=>{
|
|
220
|
+
try {
|
|
221
|
+
await subscription.handler(event);
|
|
222
|
+
} catch (error) {
|
|
223
|
+
const message = error instanceof Error ? error.message : 'Unknown error';
|
|
224
|
+
this.logger.error(`Handler for '${subscription.pattern}' failed: ${message}`);
|
|
225
|
+
}
|
|
226
|
+
}));
|
|
227
|
+
}
|
|
228
|
+
isDuplicate(eventId) {
|
|
229
|
+
if (!eventId) return false;
|
|
230
|
+
if (this.seenIds.has(eventId)) return true;
|
|
231
|
+
this.seenIds.add(eventId);
|
|
232
|
+
this.seenOrder.push(eventId);
|
|
233
|
+
if (this.seenOrder.length > this.dedupeSize) {
|
|
234
|
+
const evicted = this.seenOrder.shift();
|
|
235
|
+
if (evicted) this.seenIds.delete(evicted);
|
|
236
|
+
}
|
|
237
|
+
return false;
|
|
238
|
+
}
|
|
239
|
+
constructor(options = {}){
|
|
240
|
+
_define_property(this, "options", void 0);
|
|
241
|
+
_define_property(this, "logger", void 0);
|
|
242
|
+
_define_property(this, "subscriptions", void 0);
|
|
243
|
+
_define_property(this, "transports", void 0);
|
|
244
|
+
_define_property(this, "seenIds", void 0);
|
|
245
|
+
_define_property(this, "seenOrder", void 0);
|
|
246
|
+
_define_property(this, "label", void 0);
|
|
247
|
+
_define_property(this, "dedupeSize", void 0);
|
|
248
|
+
_define_property(this, "memory", void 0);
|
|
249
|
+
_define_property(this, "connecting", void 0);
|
|
250
|
+
_define_property(this, "connected", void 0);
|
|
251
|
+
this.options = options;
|
|
252
|
+
this.logger = new _common.Logger(HybridEventBus.name);
|
|
253
|
+
this.subscriptions = [];
|
|
254
|
+
this.transports = [];
|
|
255
|
+
this.seenIds = new Set();
|
|
256
|
+
this.seenOrder = [];
|
|
257
|
+
this.connected = false;
|
|
258
|
+
this.label = options.transport ?? this.resolveLabelFromEnv();
|
|
259
|
+
this.dedupeSize = options.dedupeSize ?? DEFAULT_DEDUPE_SIZE;
|
|
260
|
+
}
|
|
261
|
+
};
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", {
|
|
3
|
+
value: true
|
|
4
|
+
});
|
|
5
|
+
const _eventactionenum = require("../enums/event-action.enum");
|
|
6
|
+
const _eventtransportregistry = require("./event-transports/event-transport.registry");
|
|
7
|
+
const _memorytransport = require("./event-transports/memory-transport");
|
|
8
|
+
const _hybrideventbusclass = require("./hybrid-event-bus.class");
|
|
9
|
+
function buildEvent(name = 'storage.folder.created', id = 'event-1') {
|
|
10
|
+
return {
|
|
11
|
+
id,
|
|
12
|
+
name,
|
|
13
|
+
module: 'storage',
|
|
14
|
+
entity: 'folder',
|
|
15
|
+
action: _eventactionenum.EventAction.CREATED,
|
|
16
|
+
payload: {
|
|
17
|
+
ids: [
|
|
18
|
+
'1'
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
actor: {},
|
|
22
|
+
occurredAt: new Date().toISOString(),
|
|
23
|
+
version: 1
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
function createFakeTransport(name) {
|
|
27
|
+
const handlers = [];
|
|
28
|
+
const transport = {
|
|
29
|
+
name,
|
|
30
|
+
connect: jest.fn().mockResolvedValue(undefined),
|
|
31
|
+
publish: jest.fn().mockResolvedValue(undefined),
|
|
32
|
+
bind: jest.fn().mockResolvedValue(undefined),
|
|
33
|
+
onMessage: (handler)=>handlers.push(handler),
|
|
34
|
+
close: jest.fn().mockResolvedValue(undefined),
|
|
35
|
+
isReady: ()=>true,
|
|
36
|
+
emit: (event)=>handlers.forEach((handler)=>handler(event))
|
|
37
|
+
};
|
|
38
|
+
return transport;
|
|
39
|
+
}
|
|
40
|
+
describe('HybridEventBus', ()=>{
|
|
41
|
+
const originalLabel = process.env.USE_EVENT_LABEL;
|
|
42
|
+
afterEach(async ()=>{
|
|
43
|
+
_eventtransportregistry.EventTransportRegistry.clear();
|
|
44
|
+
if (originalLabel === undefined) delete process.env.USE_EVENT_LABEL;
|
|
45
|
+
else process.env.USE_EVENT_LABEL = originalLabel;
|
|
46
|
+
});
|
|
47
|
+
it('should default to the memory transport', async ()=>{
|
|
48
|
+
const bus = new _hybrideventbusclass.HybridEventBus();
|
|
49
|
+
await bus.connect();
|
|
50
|
+
expect(bus.getTransportLabel()).toBe('memory');
|
|
51
|
+
expect(bus.getActiveTransports()).toEqual([
|
|
52
|
+
'memory'
|
|
53
|
+
]);
|
|
54
|
+
await bus.close();
|
|
55
|
+
});
|
|
56
|
+
it('should read the transport label from USE_EVENT_LABEL when not given explicitly', ()=>{
|
|
57
|
+
process.env.USE_EVENT_LABEL = 'kafka';
|
|
58
|
+
expect(new _hybrideventbusclass.HybridEventBus().getTransportLabel()).toBe('kafka');
|
|
59
|
+
});
|
|
60
|
+
it('should prefer an explicit transport option over the env value', ()=>{
|
|
61
|
+
process.env.USE_EVENT_LABEL = 'kafka';
|
|
62
|
+
expect(new _hybrideventbusclass.HybridEventBus({
|
|
63
|
+
transport: 'memory'
|
|
64
|
+
}).getTransportLabel()).toBe('memory');
|
|
65
|
+
});
|
|
66
|
+
it('should deliver a published event to a matching subscriber', async ()=>{
|
|
67
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
68
|
+
transport: 'memory'
|
|
69
|
+
});
|
|
70
|
+
const handler = jest.fn();
|
|
71
|
+
await bus.subscribe('storage.*.created', handler);
|
|
72
|
+
await bus.publish(buildEvent());
|
|
73
|
+
expect(handler).toHaveBeenCalledWith(expect.objectContaining({
|
|
74
|
+
name: 'storage.folder.created'
|
|
75
|
+
}));
|
|
76
|
+
await bus.close();
|
|
77
|
+
});
|
|
78
|
+
it('should not deliver an event to a non matching subscriber', async ()=>{
|
|
79
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
80
|
+
transport: 'memory'
|
|
81
|
+
});
|
|
82
|
+
const handler = jest.fn();
|
|
83
|
+
await bus.subscribe('auth.#', handler);
|
|
84
|
+
await bus.publish(buildEvent());
|
|
85
|
+
expect(handler).not.toHaveBeenCalled();
|
|
86
|
+
await bus.close();
|
|
87
|
+
});
|
|
88
|
+
it('should keep publishing when a handler throws', async ()=>{
|
|
89
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
90
|
+
transport: 'memory'
|
|
91
|
+
});
|
|
92
|
+
const failing = jest.fn().mockRejectedValue(new Error('boom'));
|
|
93
|
+
const healthy = jest.fn();
|
|
94
|
+
await bus.subscribe('**', failing);
|
|
95
|
+
await bus.subscribe('**', healthy);
|
|
96
|
+
await expect(bus.publish(buildEvent())).resolves.toBeUndefined();
|
|
97
|
+
expect(healthy).toHaveBeenCalled();
|
|
98
|
+
await bus.close();
|
|
99
|
+
});
|
|
100
|
+
it('should publish to both layers in hybrid mode and deliver each event once', async ()=>{
|
|
101
|
+
const broker = createFakeTransport('rabbitmq');
|
|
102
|
+
_eventtransportregistry.EventTransportRegistry.register('rabbitmq', ()=>broker);
|
|
103
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
104
|
+
transport: 'hybrid'
|
|
105
|
+
});
|
|
106
|
+
const handler = jest.fn();
|
|
107
|
+
await bus.subscribe('**', handler);
|
|
108
|
+
expect(bus.getActiveTransports()).toEqual([
|
|
109
|
+
'memory',
|
|
110
|
+
'rabbitmq'
|
|
111
|
+
]);
|
|
112
|
+
const event = buildEvent();
|
|
113
|
+
await bus.publish(event);
|
|
114
|
+
// the broker loops the same event back to this process
|
|
115
|
+
broker.emit(event);
|
|
116
|
+
expect(broker.publish).toHaveBeenCalledWith(event);
|
|
117
|
+
expect(handler).toHaveBeenCalledTimes(1);
|
|
118
|
+
await bus.close();
|
|
119
|
+
});
|
|
120
|
+
it('should fall back to memory when the broker cannot start', async ()=>{
|
|
121
|
+
_eventtransportregistry.EventTransportRegistry.register('kafka', ()=>{
|
|
122
|
+
throw new Error('kafkajs not installed');
|
|
123
|
+
});
|
|
124
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
125
|
+
transport: 'kafka'
|
|
126
|
+
});
|
|
127
|
+
await bus.connect();
|
|
128
|
+
expect(bus.getActiveTransports()).toEqual([
|
|
129
|
+
'memory'
|
|
130
|
+
]);
|
|
131
|
+
await bus.close();
|
|
132
|
+
});
|
|
133
|
+
it('should survive a transport that fails to publish', async ()=>{
|
|
134
|
+
const broker = createFakeTransport('rabbitmq');
|
|
135
|
+
broker.publish.mockRejectedValue(new Error('channel closed'));
|
|
136
|
+
_eventtransportregistry.EventTransportRegistry.register('rabbitmq', ()=>broker);
|
|
137
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
138
|
+
transport: 'rabbitmq'
|
|
139
|
+
});
|
|
140
|
+
await expect(bus.publish(buildEvent())).resolves.toBeUndefined();
|
|
141
|
+
await bus.close();
|
|
142
|
+
});
|
|
143
|
+
it('should not publish or throw while it has no working transport', async ()=>{
|
|
144
|
+
const connectSpy = jest.spyOn(_memorytransport.MemoryTransport.prototype, 'connect').mockRejectedValueOnce(new Error('boot failure'));
|
|
145
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
146
|
+
transport: 'memory'
|
|
147
|
+
});
|
|
148
|
+
await expect(bus.publish(buildEvent())).resolves.toBeUndefined();
|
|
149
|
+
expect(bus.getActiveTransports()).toEqual([]);
|
|
150
|
+
connectSpy.mockRestore();
|
|
151
|
+
await bus.close();
|
|
152
|
+
});
|
|
153
|
+
it('should retry connecting after a failed attempt instead of staying dead', async ()=>{
|
|
154
|
+
const connectSpy = jest.spyOn(_memorytransport.MemoryTransport.prototype, 'connect').mockRejectedValueOnce(new Error('boot failure'));
|
|
155
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
156
|
+
transport: 'memory'
|
|
157
|
+
});
|
|
158
|
+
const handler = jest.fn();
|
|
159
|
+
await bus.publish(buildEvent());
|
|
160
|
+
connectSpy.mockRestore();
|
|
161
|
+
await bus.subscribe('**', handler);
|
|
162
|
+
await bus.publish(buildEvent('storage.folder.created', 'event-2'));
|
|
163
|
+
expect(bus.getActiveTransports()).toEqual([
|
|
164
|
+
'memory'
|
|
165
|
+
]);
|
|
166
|
+
expect(handler).toHaveBeenCalledTimes(1);
|
|
167
|
+
await bus.close();
|
|
168
|
+
});
|
|
169
|
+
it('should keep a subscription made while disconnected so a later connect binds it', async ()=>{
|
|
170
|
+
const connectSpy = jest.spyOn(_memorytransport.MemoryTransport.prototype, 'connect').mockRejectedValueOnce(new Error('boot failure'));
|
|
171
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
172
|
+
transport: 'memory'
|
|
173
|
+
});
|
|
174
|
+
const handler = jest.fn();
|
|
175
|
+
await expect(bus.subscribe('**', handler)).resolves.toBeUndefined();
|
|
176
|
+
connectSpy.mockRestore();
|
|
177
|
+
await bus.publish(buildEvent());
|
|
178
|
+
expect(handler).toHaveBeenCalledTimes(1);
|
|
179
|
+
await bus.close();
|
|
180
|
+
});
|
|
181
|
+
it('should forget its transports after close', async ()=>{
|
|
182
|
+
const bus = new _hybrideventbusclass.HybridEventBus({
|
|
183
|
+
transport: 'memory'
|
|
184
|
+
});
|
|
185
|
+
await bus.connect();
|
|
186
|
+
await bus.close();
|
|
187
|
+
expect(bus.getActiveTransports()).toEqual([]);
|
|
188
|
+
});
|
|
189
|
+
});
|
package/cjs/classes/index.js
CHANGED
|
@@ -4,8 +4,13 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
4
4
|
});
|
|
5
5
|
_export_star(require("./api-controller.class"), exports);
|
|
6
6
|
_export_star(require("./api-service.class"), exports);
|
|
7
|
+
_export_star(require("./disabled-event-bus.class"), exports);
|
|
8
|
+
_export_star(require("./domain-event.publisher"), exports);
|
|
9
|
+
_export_star(require("./event-bus.registry"), exports);
|
|
10
|
+
_export_star(require("./event-transports"), exports);
|
|
7
11
|
_export_star(require("./handle-custome-db"), exports);
|
|
8
12
|
_export_star(require("./hybrid-cache.class"), exports);
|
|
13
|
+
_export_star(require("./hybrid-event-bus.class"), exports);
|
|
9
14
|
_export_star(require("./winston.logger.class"), exports);
|
|
10
15
|
_export_star(require("../constants/permissions"), exports);
|
|
11
16
|
function _export_star(from, to) {
|
package/cjs/constants/index.js
CHANGED
|
@@ -16,6 +16,24 @@ _export(exports, {
|
|
|
16
16
|
get CLIENT_TYPE_HEADER () {
|
|
17
17
|
return CLIENT_TYPE_HEADER;
|
|
18
18
|
},
|
|
19
|
+
get DEFAULT_EVENT_EXCHANGE () {
|
|
20
|
+
return DEFAULT_EVENT_EXCHANGE;
|
|
21
|
+
},
|
|
22
|
+
get DEFAULT_EVENT_SERVICE_NAME () {
|
|
23
|
+
return DEFAULT_EVENT_SERVICE_NAME;
|
|
24
|
+
},
|
|
25
|
+
get DEFAULT_EVENT_TOPIC () {
|
|
26
|
+
return DEFAULT_EVENT_TOPIC;
|
|
27
|
+
},
|
|
28
|
+
get DOMAIN_EVENT_HANDLER_KEY () {
|
|
29
|
+
return DOMAIN_EVENT_HANDLER_KEY;
|
|
30
|
+
},
|
|
31
|
+
get EVENT_BUS_INSTANCE () {
|
|
32
|
+
return EVENT_BUS_INSTANCE;
|
|
33
|
+
},
|
|
34
|
+
get EVENT_BUS_MODULE_OPTIONS () {
|
|
35
|
+
return EVENT_BUS_MODULE_OPTIONS;
|
|
36
|
+
},
|
|
19
37
|
get IDEMPOTENCY_CACHE_PREFIX () {
|
|
20
38
|
return IDEMPOTENCY_CACHE_PREFIX;
|
|
21
39
|
},
|
|
@@ -55,10 +73,16 @@ function _export_star(from, to) {
|
|
|
55
73
|
}
|
|
56
74
|
const IS_PUBLIC_KEY = 'isPublic';
|
|
57
75
|
const PERMISSIONS_KEY = 'permissions';
|
|
76
|
+
const DOMAIN_EVENT_HANDLER_KEY = 'domainEventHandler';
|
|
58
77
|
const CACHE_INSTANCE = 'CACHE_INSTANCE';
|
|
59
78
|
const PERMISSION_GUARD_CONFIG = 'PERMISSION_GUARD_CONFIG';
|
|
79
|
+
const EVENT_BUS_INSTANCE = 'EVENT_BUS_INSTANCE';
|
|
80
|
+
const EVENT_BUS_MODULE_OPTIONS = 'EVENT_BUS_MODULE_OPTIONS';
|
|
60
81
|
const IDEMPOTENCY_KEY_HEADER = 'x-idempotency-key';
|
|
61
82
|
const REQUEST_ID_HEADER = 'x-request-id';
|
|
62
83
|
const CLIENT_TYPE_HEADER = 'x-client-type';
|
|
63
84
|
const PERMISSIONS_CACHE_PREFIX = 'my-permissions';
|
|
64
85
|
const IDEMPOTENCY_CACHE_PREFIX = 'idempotency';
|
|
86
|
+
const DEFAULT_EVENT_EXCHANGE = 'flusys.events';
|
|
87
|
+
const DEFAULT_EVENT_TOPIC = 'flusys.domain-events';
|
|
88
|
+
const DEFAULT_EVENT_SERVICE_NAME = 'flusys';
|
package/cjs/decorators/index.js
CHANGED
|
@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
5
5
|
_export_star(require("./api-response.decorator"), exports);
|
|
6
6
|
_export_star(require("./current-user.decorator"), exports);
|
|
7
7
|
_export_star(require("./log-action.decorator"), exports);
|
|
8
|
+
_export_star(require("./on-domain-event.decorator"), exports);
|
|
8
9
|
_export_star(require("./public.decorator"), exports);
|
|
9
10
|
_export_star(require("./require-permission.decorator"), exports);
|
|
10
11
|
function _export_star(from, to) {
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", {
|
|
3
|
+
value: true
|
|
4
|
+
});
|
|
5
|
+
Object.defineProperty(exports, "OnDomainEvent", {
|
|
6
|
+
enumerable: true,
|
|
7
|
+
get: function() {
|
|
8
|
+
return OnDomainEvent;
|
|
9
|
+
}
|
|
10
|
+
});
|
|
11
|
+
const _common = require("@nestjs/common");
|
|
12
|
+
const _constants = require("../constants");
|
|
13
|
+
const OnDomainEvent = (...patterns)=>(0, _common.SetMetadata)(_constants.DOMAIN_EVENT_HANDLER_KEY, patterns);
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", {
|
|
3
|
+
value: true
|
|
4
|
+
});
|
|
5
|
+
const _constants = require("../constants");
|
|
6
|
+
const _ondomaineventdecorator = require("./on-domain-event.decorator");
|
|
7
|
+
function _ts_decorate(decorators, target, key, desc) {
|
|
8
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
9
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
10
|
+
else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
11
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
12
|
+
}
|
|
13
|
+
function _ts_metadata(k, v) {
|
|
14
|
+
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
15
|
+
}
|
|
16
|
+
let TestConsumer = class TestConsumer {
|
|
17
|
+
handleCreated() {}
|
|
18
|
+
handleDeleted() {}
|
|
19
|
+
handlePlain() {}
|
|
20
|
+
};
|
|
21
|
+
_ts_decorate([
|
|
22
|
+
(0, _ondomaineventdecorator.OnDomainEvent)('storage.folder.created'),
|
|
23
|
+
_ts_metadata("design:type", Function),
|
|
24
|
+
_ts_metadata("design:paramtypes", []),
|
|
25
|
+
_ts_metadata("design:returntype", void 0)
|
|
26
|
+
], TestConsumer.prototype, "handleCreated", null);
|
|
27
|
+
_ts_decorate([
|
|
28
|
+
(0, _ondomaineventdecorator.OnDomainEvent)('auth.*.deleted', 'iam.*.deleted'),
|
|
29
|
+
_ts_metadata("design:type", Function),
|
|
30
|
+
_ts_metadata("design:paramtypes", []),
|
|
31
|
+
_ts_metadata("design:returntype", void 0)
|
|
32
|
+
], TestConsumer.prototype, "handleDeleted", null);
|
|
33
|
+
describe('OnDomainEvent', ()=>{
|
|
34
|
+
it('should attach a single pattern as metadata', ()=>{
|
|
35
|
+
const patterns = Reflect.getMetadata(_constants.DOMAIN_EVENT_HANDLER_KEY, TestConsumer.prototype.handleCreated);
|
|
36
|
+
expect(patterns).toEqual([
|
|
37
|
+
'storage.folder.created'
|
|
38
|
+
]);
|
|
39
|
+
});
|
|
40
|
+
it('should attach every pattern passed to the decorator', ()=>{
|
|
41
|
+
const patterns = Reflect.getMetadata(_constants.DOMAIN_EVENT_HANDLER_KEY, TestConsumer.prototype.handleDeleted);
|
|
42
|
+
expect(patterns).toEqual([
|
|
43
|
+
'auth.*.deleted',
|
|
44
|
+
'iam.*.deleted'
|
|
45
|
+
]);
|
|
46
|
+
});
|
|
47
|
+
it('should leave undecorated methods without metadata', ()=>{
|
|
48
|
+
expect(Reflect.getMetadata(_constants.DOMAIN_EVENT_HANDLER_KEY, TestConsumer.prototype.handlePlain)).toBeUndefined();
|
|
49
|
+
});
|
|
50
|
+
});
|
|
@@ -8,7 +8,7 @@ Object.defineProperty(exports, "UserRoot", {
|
|
|
8
8
|
return UserRoot;
|
|
9
9
|
}
|
|
10
10
|
});
|
|
11
|
-
const
|
|
11
|
+
const _handlecustomedb = require("../classes/handle-custome-db");
|
|
12
12
|
const _typeorm = require("typeorm");
|
|
13
13
|
function _define_property(obj, key, value) {
|
|
14
14
|
if (key in obj) {
|
|
@@ -135,7 +135,7 @@ _ts_decorate([
|
|
|
135
135
|
], UserRoot.prototype, "lastLoginAt", void 0);
|
|
136
136
|
_ts_decorate([
|
|
137
137
|
(0, _typeorm.Column)({
|
|
138
|
-
type: (0,
|
|
138
|
+
type: (0, _handlecustomedb.getJsonColumnType)(),
|
|
139
139
|
nullable: true,
|
|
140
140
|
name: 'additional_fields'
|
|
141
141
|
}),
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", {
|
|
3
|
+
value: true
|
|
4
|
+
});
|
|
5
|
+
Object.defineProperty(exports, "EventAction", {
|
|
6
|
+
enumerable: true,
|
|
7
|
+
get: function() {
|
|
8
|
+
return EventAction;
|
|
9
|
+
}
|
|
10
|
+
});
|
|
11
|
+
var EventAction = /*#__PURE__*/ function(EventAction) {
|
|
12
|
+
EventAction["CREATED"] = "created";
|
|
13
|
+
EventAction["UPDATED"] = "updated";
|
|
14
|
+
EventAction["DELETED"] = "deleted";
|
|
15
|
+
EventAction["RESTORED"] = "restored";
|
|
16
|
+
EventAction["PURGED"] = "purged";
|
|
17
|
+
return EventAction;
|
|
18
|
+
}({});
|
package/cjs/enums/index.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", {
|
|
3
3
|
value: true
|
|
4
4
|
});
|
|
5
|
+
_export_star(require("./event-action.enum"), exports);
|
|
5
6
|
_export_star(require("./notification-type.enum"), exports);
|
|
6
7
|
_export_star(require("./participant-status.enum"), exports);
|
|
7
8
|
_export_star(require("./recurrence-type.enum"), exports);
|
package/cjs/interfaces/index.js
CHANGED
|
@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
5
5
|
_export_star(require("./ai-assistant-adapter.interface"), exports);
|
|
6
6
|
_export_star(require("./api.interface"), exports);
|
|
7
7
|
_export_star(require("./datasource.interface"), exports);
|
|
8
|
+
_export_star(require("./event-bus.interface"), exports);
|
|
8
9
|
_export_star(require("./event-manager-adapter.interface"), exports);
|
|
9
10
|
_export_star(require("./identity.interface"), exports);
|
|
10
11
|
_export_star(require("./logged-user-info.interface"), exports);
|