@flusys/nestjs-shared 6.4.1 → 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.
Files changed (111) hide show
  1. package/README.md +437 -0
  2. package/cjs/classes/api-service.class.js +71 -8
  3. package/cjs/classes/api-service.class.spec.js +220 -0
  4. package/cjs/classes/disabled-event-bus.class.js +15 -0
  5. package/cjs/classes/disabled-event-bus.class.spec.js +40 -0
  6. package/cjs/classes/domain-event.publisher.js +76 -0
  7. package/cjs/classes/domain-event.publisher.spec.js +234 -0
  8. package/cjs/classes/event-bus.registry.js +69 -0
  9. package/cjs/classes/event-bus.registry.spec.js +116 -0
  10. package/cjs/classes/event-transports/event-transport.registry.js +41 -0
  11. package/cjs/classes/event-transports/event-transport.registry.spec.js +31 -0
  12. package/cjs/classes/event-transports/index.js +23 -0
  13. package/cjs/classes/event-transports/kafka-transport.optional.js +151 -0
  14. package/cjs/classes/event-transports/kafka-transport.optional.spec.js +199 -0
  15. package/cjs/classes/event-transports/memory-transport.js +54 -0
  16. package/cjs/classes/event-transports/memory-transport.spec.js +58 -0
  17. package/cjs/classes/event-transports/rabbitmq-transport.optional.js +184 -0
  18. package/cjs/classes/event-transports/rabbitmq-transport.optional.spec.js +256 -0
  19. package/cjs/classes/hybrid-event-bus.class.js +261 -0
  20. package/cjs/classes/hybrid-event-bus.class.spec.js +189 -0
  21. package/cjs/classes/index.js +5 -0
  22. package/cjs/constants/index.js +24 -0
  23. package/cjs/decorators/index.js +1 -0
  24. package/cjs/decorators/on-domain-event.decorator.js +13 -0
  25. package/cjs/decorators/on-domain-event.decorator.spec.js +50 -0
  26. package/cjs/entities/user-root.js +2 -2
  27. package/cjs/enums/event-action.enum.js +18 -0
  28. package/cjs/enums/index.js +1 -0
  29. package/cjs/interfaces/event-bus.interface.js +4 -0
  30. package/cjs/interfaces/index.js +1 -0
  31. package/cjs/modules/event-bus/event-bus.explorer.js +124 -0
  32. package/cjs/modules/event-bus/event-bus.explorer.spec.js +189 -0
  33. package/cjs/modules/event-bus/event-bus.integration.spec.js +254 -0
  34. package/cjs/modules/event-bus/event-bus.module.js +94 -0
  35. package/cjs/modules/event-bus/event-bus.module.spec.js +149 -0
  36. package/cjs/modules/event-bus/module-events.provider.js +39 -0
  37. package/cjs/modules/event-bus/module-events.provider.spec.js +56 -0
  38. package/cjs/modules/index.js +3 -0
  39. package/cjs/utils/event-pattern.util.js +98 -0
  40. package/cjs/utils/event-pattern.util.spec.js +234 -0
  41. package/cjs/utils/index.js +2 -0
  42. package/cjs/utils/optional-module.util.js +35 -0
  43. package/cjs/utils/optional-module.util.spec.js +14 -0
  44. package/classes/api-service.class.d.ts +11 -1
  45. package/classes/disabled-event-bus.class.d.ts +6 -0
  46. package/classes/domain-event.publisher.d.ts +14 -0
  47. package/classes/event-bus.registry.d.ts +14 -0
  48. package/classes/event-transports/event-transport.registry.d.ts +10 -0
  49. package/classes/event-transports/index.d.ts +2 -0
  50. package/classes/event-transports/kafka-transport.optional.d.ts +21 -0
  51. package/classes/event-transports/memory-transport.d.ts +13 -0
  52. package/classes/event-transports/rabbitmq-transport.optional.d.ts +27 -0
  53. package/classes/hybrid-event-bus.class.d.ts +32 -0
  54. package/classes/index.d.ts +5 -0
  55. package/constants/index.d.ts +6 -0
  56. package/decorators/index.d.ts +1 -0
  57. package/decorators/on-domain-event.decorator.d.ts +1 -0
  58. package/enums/event-action.enum.d.ts +7 -0
  59. package/enums/index.d.ts +1 -0
  60. package/fesm/classes/api-service.class.js +71 -8
  61. package/fesm/classes/api-service.class.spec.js +220 -0
  62. package/fesm/classes/disabled-event-bus.class.js +11 -0
  63. package/fesm/classes/disabled-event-bus.class.spec.js +36 -0
  64. package/fesm/classes/domain-event.publisher.js +63 -0
  65. package/fesm/classes/domain-event.publisher.spec.js +230 -0
  66. package/fesm/classes/event-bus.registry.js +65 -0
  67. package/fesm/classes/event-bus.registry.spec.js +112 -0
  68. package/fesm/classes/event-transports/event-transport.registry.js +35 -0
  69. package/fesm/classes/event-transports/event-transport.registry.spec.js +27 -0
  70. package/fesm/classes/event-transports/index.js +6 -0
  71. package/fesm/classes/event-transports/kafka-transport.optional.js +144 -0
  72. package/fesm/classes/event-transports/kafka-transport.optional.spec.js +195 -0
  73. package/fesm/classes/event-transports/memory-transport.js +46 -0
  74. package/fesm/classes/event-transports/memory-transport.spec.js +54 -0
  75. package/fesm/classes/event-transports/rabbitmq-transport.optional.js +174 -0
  76. package/fesm/classes/event-transports/rabbitmq-transport.optional.spec.js +252 -0
  77. package/fesm/classes/hybrid-event-bus.class.js +217 -0
  78. package/fesm/classes/hybrid-event-bus.class.spec.js +185 -0
  79. package/fesm/classes/index.js +5 -0
  80. package/fesm/constants/index.js +7 -0
  81. package/fesm/decorators/index.js +1 -0
  82. package/fesm/decorators/on-domain-event.decorator.js +10 -0
  83. package/fesm/decorators/on-domain-event.decorator.spec.js +46 -0
  84. package/fesm/entities/user-root.js +1 -1
  85. package/fesm/enums/event-action.enum.js +8 -0
  86. package/fesm/enums/index.js +1 -0
  87. package/fesm/interfaces/event-bus.interface.js +1 -0
  88. package/fesm/interfaces/index.js +1 -0
  89. package/fesm/modules/event-bus/event-bus.explorer.js +114 -0
  90. package/fesm/modules/event-bus/event-bus.explorer.spec.js +185 -0
  91. package/fesm/modules/event-bus/event-bus.integration.spec.js +250 -0
  92. package/fesm/modules/event-bus/event-bus.module.js +84 -0
  93. package/fesm/modules/event-bus/event-bus.module.spec.js +145 -0
  94. package/fesm/modules/event-bus/module-events.provider.js +26 -0
  95. package/fesm/modules/event-bus/module-events.provider.spec.js +52 -0
  96. package/fesm/modules/index.js +3 -0
  97. package/fesm/utils/event-pattern.util.js +86 -0
  98. package/fesm/utils/event-pattern.util.spec.js +230 -0
  99. package/fesm/utils/index.js +2 -0
  100. package/fesm/utils/optional-module.util.js +25 -0
  101. package/fesm/utils/optional-module.util.spec.js +10 -0
  102. package/interfaces/event-bus.interface.d.ts +74 -0
  103. package/interfaces/index.d.ts +1 -0
  104. package/modules/event-bus/event-bus.explorer.d.ts +14 -0
  105. package/modules/event-bus/event-bus.module.d.ts +8 -0
  106. package/modules/event-bus/module-events.provider.d.ts +3 -0
  107. package/modules/index.d.ts +3 -0
  108. package/package.json +2 -2
  109. package/utils/event-pattern.util.d.ts +3 -0
  110. package/utils/index.d.ts +2 -0
  111. package/utils/optional-module.util.d.ts +1 -0
@@ -0,0 +1,116 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ const _eventactionenum = require("../enums/event-action.enum");
6
+ const _eventbusregistry = require("./event-bus.registry");
7
+ const bus = {
8
+ publish: jest.fn(),
9
+ subscribe: jest.fn(),
10
+ close: jest.fn()
11
+ };
12
+ describe('EventBusRegistry', ()=>{
13
+ beforeEach(()=>{
14
+ _eventbusregistry.EventBusRegistry.reset();
15
+ _eventbusregistry.EventBusRegistry.setBus(bus);
16
+ });
17
+ afterEach(()=>{
18
+ _eventbusregistry.EventBusRegistry.reset();
19
+ });
20
+ it('should expose the registered bus', ()=>{
21
+ expect(_eventbusregistry.EventBusRegistry.getBus()).toBe(bus);
22
+ });
23
+ it('should answer from the module config alone, independent of any registered bus', ()=>{
24
+ _eventbusregistry.EventBusRegistry.reset();
25
+ _eventbusregistry.EventBusRegistry.configureModule('storage', {
26
+ enabled: true
27
+ });
28
+ expect(_eventbusregistry.EventBusRegistry.getBus()).toBeUndefined();
29
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.CREATED)).toBe(true);
30
+ });
31
+ it('should report disabled for a module that never registered a config', ()=>{
32
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.CREATED)).toBe(false);
33
+ });
34
+ it('should enable every action of an enabled module by default', ()=>{
35
+ _eventbusregistry.EventBusRegistry.configureModule('storage', {
36
+ enabled: true
37
+ });
38
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.CREATED)).toBe(true);
39
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.DELETED)).toBe(true);
40
+ });
41
+ it('should honour an action allowlist', ()=>{
42
+ _eventbusregistry.EventBusRegistry.configureModule('storage', {
43
+ enabled: true,
44
+ actions: [
45
+ _eventactionenum.EventAction.CREATED
46
+ ]
47
+ });
48
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.CREATED)).toBe(true);
49
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.UPDATED)).toBe(false);
50
+ });
51
+ it('should honour an allowlist that mixes CRUD lifecycle and domain actions', ()=>{
52
+ _eventbusregistry.EventBusRegistry.configureModule('auth', {
53
+ enabled: true,
54
+ actions: [
55
+ _eventactionenum.EventAction.CREATED,
56
+ 'logged-in'
57
+ ]
58
+ });
59
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('auth', 'appuser', _eventactionenum.EventAction.CREATED)).toBe(true);
60
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('auth', 'session', 'logged-in')).toBe(true);
61
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('auth', 'appuser', _eventactionenum.EventAction.UPDATED)).toBe(false);
62
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('auth', 'session', 'logged-out')).toBe(false);
63
+ });
64
+ it('should silence CRUD when the allowlist names only domain actions', ()=>{
65
+ _eventbusregistry.EventBusRegistry.configureModule('auth', {
66
+ enabled: true,
67
+ actions: [
68
+ 'logged-in'
69
+ ]
70
+ });
71
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('auth', 'session', 'logged-in')).toBe(true);
72
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('auth', 'appuser', _eventactionenum.EventAction.CREATED)).toBe(false);
73
+ });
74
+ it('should honour an entity allowlist and exclusion list', ()=>{
75
+ _eventbusregistry.EventBusRegistry.configureModule('storage', {
76
+ enabled: true,
77
+ entities: [
78
+ 'folder',
79
+ 'file_manager'
80
+ ],
81
+ excludeEntities: [
82
+ 'file_manager'
83
+ ]
84
+ });
85
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'folder', _eventactionenum.EventAction.CREATED)).toBe(true);
86
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'file_manager', _eventactionenum.EventAction.CREATED)).toBe(false);
87
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('storage', 'storageConfig', _eventactionenum.EventAction.CREATED)).toBe(false);
88
+ });
89
+ it('should fall back to the default config for unregistered modules', ()=>{
90
+ _eventbusregistry.EventBusRegistry.setDefaultModuleEvents({
91
+ enabled: true
92
+ });
93
+ expect(_eventbusregistry.EventBusRegistry.isEnabled('unknown-module', 'thing', _eventactionenum.EventAction.CREATED)).toBe(true);
94
+ });
95
+ it('should include the payload unless a module opts out', ()=>{
96
+ _eventbusregistry.EventBusRegistry.configureModule('storage', {
97
+ enabled: true
98
+ });
99
+ _eventbusregistry.EventBusRegistry.configureModule('auth', {
100
+ enabled: true,
101
+ includePayload: false
102
+ });
103
+ expect(_eventbusregistry.EventBusRegistry.shouldIncludePayload('storage')).toBe(true);
104
+ expect(_eventbusregistry.EventBusRegistry.shouldIncludePayload('auth')).toBe(false);
105
+ });
106
+ it('should clear everything on reset', ()=>{
107
+ _eventbusregistry.EventBusRegistry.configureModule('storage', {
108
+ enabled: true
109
+ });
110
+ _eventbusregistry.EventBusRegistry.reset();
111
+ expect(_eventbusregistry.EventBusRegistry.getBus()).toBeUndefined();
112
+ expect(_eventbusregistry.EventBusRegistry.getModuleConfig('storage')).toEqual({
113
+ enabled: false
114
+ });
115
+ });
116
+ });
@@ -0,0 +1,41 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ Object.defineProperty(exports, "EventTransportRegistry", {
6
+ enumerable: true,
7
+ get: function() {
8
+ return EventTransportRegistry;
9
+ }
10
+ });
11
+ function _define_property(obj, key, value) {
12
+ if (key in obj) {
13
+ Object.defineProperty(obj, key, {
14
+ value: value,
15
+ enumerable: true,
16
+ configurable: true,
17
+ writable: true
18
+ });
19
+ } else {
20
+ obj[key] = value;
21
+ }
22
+ return obj;
23
+ }
24
+ let EventTransportRegistry = class EventTransportRegistry {
25
+ static register(name, factory) {
26
+ this.transports.set(name.toLowerCase(), factory);
27
+ }
28
+ static get(name) {
29
+ return this.transports.get(name.toLowerCase());
30
+ }
31
+ static has(name) {
32
+ return this.transports.has(name.toLowerCase());
33
+ }
34
+ static getAll() {
35
+ return Array.from(this.transports.keys());
36
+ }
37
+ static clear() {
38
+ this.transports.clear();
39
+ }
40
+ };
41
+ _define_property(EventTransportRegistry, "transports", new Map());
@@ -0,0 +1,31 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ const _eventtransportregistry = require("./event-transport.registry");
6
+ const stubTransport = {};
7
+ describe('EventTransportRegistry', ()=>{
8
+ afterEach(()=>{
9
+ _eventtransportregistry.EventTransportRegistry.clear();
10
+ });
11
+ it('should register and resolve a transport factory', ()=>{
12
+ _eventtransportregistry.EventTransportRegistry.register('rabbitmq', ()=>stubTransport);
13
+ expect(_eventtransportregistry.EventTransportRegistry.get('rabbitmq')({})).toBe(stubTransport);
14
+ });
15
+ it('should resolve case insensitively', ()=>{
16
+ _eventtransportregistry.EventTransportRegistry.register('Kafka', ()=>stubTransport);
17
+ expect(_eventtransportregistry.EventTransportRegistry.has('kafka')).toBe(true);
18
+ });
19
+ it('should return undefined for an unknown transport', ()=>{
20
+ expect(_eventtransportregistry.EventTransportRegistry.get('nats')).toBeUndefined();
21
+ expect(_eventtransportregistry.EventTransportRegistry.has('nats')).toBe(false);
22
+ });
23
+ it('should list every registered transport', ()=>{
24
+ _eventtransportregistry.EventTransportRegistry.register('memory', ()=>stubTransport);
25
+ _eventtransportregistry.EventTransportRegistry.register('kafka', ()=>stubTransport);
26
+ expect(_eventtransportregistry.EventTransportRegistry.getAll().sort()).toEqual([
27
+ 'kafka',
28
+ 'memory'
29
+ ]);
30
+ });
31
+ });
@@ -0,0 +1,23 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ _export_star(require("./event-transport.registry"), exports);
6
+ _export_star(require("./memory-transport"), exports);
7
+ function _export_star(from, to) {
8
+ Object.keys(from).forEach(function(k) {
9
+ if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
10
+ Object.defineProperty(to, k, {
11
+ enumerable: true,
12
+ get: function() {
13
+ return from[k];
14
+ }
15
+ });
16
+ }
17
+ });
18
+ return from;
19
+ }
20
+ // Note: Broker transports are loaded dynamically by HybridEventBus.
21
+ // Import them directly when registering manually:
22
+ // - import { RabbitMqTransport } from '@flusys/nestjs-shared/classes/event-transports/rabbitmq-transport.optional';
23
+ // - import { KafkaTransport } from '@flusys/nestjs-shared/classes/event-transports/kafka-transport.optional';
@@ -0,0 +1,151 @@
1
+ /**
2
+ * Optional Kafka event transport
3
+ * Requires: npm install kafkajs
4
+ */ "use strict";
5
+ Object.defineProperty(exports, "__esModule", {
6
+ value: true
7
+ });
8
+ Object.defineProperty(exports, "KafkaTransport", {
9
+ enumerable: true,
10
+ get: function() {
11
+ return KafkaTransport;
12
+ }
13
+ });
14
+ const _common = require("@nestjs/common");
15
+ const _constants = require("../../constants");
16
+ const _optionalmoduleutil = require("../../utils/optional-module.util");
17
+ const _eventtransportregistry = require("./event-transport.registry");
18
+ function _define_property(obj, key, value) {
19
+ if (key in obj) {
20
+ Object.defineProperty(obj, key, {
21
+ value: value,
22
+ enumerable: true,
23
+ configurable: true,
24
+ writable: true
25
+ });
26
+ } else {
27
+ obj[key] = value;
28
+ }
29
+ return obj;
30
+ }
31
+ const DEFAULT_BROKERS = [
32
+ 'localhost:9092'
33
+ ];
34
+ let KafkaTransport = class KafkaTransport {
35
+ async connect() {
36
+ let kafkajs;
37
+ try {
38
+ kafkajs = await (0, _optionalmoduleutil.loadOptionalModule)('kafkajs');
39
+ } catch {
40
+ throw new _common.InternalServerErrorException({
41
+ message: 'kafkajs not found',
42
+ messageKey: _constants.SYSTEM_MESSAGES.SDK_NOT_INSTALLED,
43
+ messageVariables: {
44
+ sdk: 'kafkajs'
45
+ }
46
+ });
47
+ }
48
+ const Kafka = kafkajs.Kafka ?? kafkajs.default.Kafka;
49
+ this.client = new Kafka({
50
+ clientId: this.config.clientId ?? _constants.DEFAULT_EVENT_SERVICE_NAME,
51
+ brokers: this.config.brokers ?? DEFAULT_BROKERS,
52
+ ssl: this.config.ssl,
53
+ sasl: this.config.sasl
54
+ });
55
+ this.producer = this.client.producer();
56
+ await this.producer.connect();
57
+ // The consumer is built on the first bind, never here: subscribing to a
58
+ // topic that does not exist yet, or a coordinator that is not ready, would
59
+ // otherwise fail the whole transport and take publishing down with it - and
60
+ // a service that only publishes would join a consumer group for nothing.
61
+ if (this.boundPatterns.size) await this.startConsuming();
62
+ }
63
+ async publish(event) {
64
+ if (!this.producer) return;
65
+ await this.producer.send({
66
+ topic: this.topic,
67
+ messages: [
68
+ {
69
+ key: event.name,
70
+ value: JSON.stringify(event),
71
+ headers: {
72
+ eventId: event.id,
73
+ module: event.module,
74
+ action: String(event.action)
75
+ }
76
+ }
77
+ ]
78
+ });
79
+ }
80
+ async bind(pattern) {
81
+ if (this.boundPatterns.has(pattern)) return;
82
+ this.boundPatterns.add(pattern);
83
+ await this.startConsuming();
84
+ }
85
+ onMessage(handler) {
86
+ this.handlers.push(handler);
87
+ }
88
+ async close() {
89
+ await this.consumer?.disconnect().catch(()=>{});
90
+ await this.producer?.disconnect().catch(()=>{});
91
+ this.consumer = undefined;
92
+ this.producer = undefined;
93
+ this.client = undefined;
94
+ this.running = false;
95
+ }
96
+ isReady() {
97
+ return Boolean(this.producer);
98
+ }
99
+ get topic() {
100
+ return this.config.topic ?? _constants.DEFAULT_EVENT_TOPIC;
101
+ }
102
+ async startConsuming() {
103
+ if (this.running || !this.client) return;
104
+ this.running = true;
105
+ try {
106
+ this.consumer = this.client.consumer({
107
+ groupId: this.config.groupId ?? `${_constants.DEFAULT_EVENT_SERVICE_NAME}-events`
108
+ });
109
+ await this.consumer.connect();
110
+ await this.consumer.subscribe({
111
+ topic: this.topic,
112
+ fromBeginning: false
113
+ });
114
+ await this.consumer.run({
115
+ eachMessage: async ({ message })=>{
116
+ // A compacted topic delivers tombstones with no value at all
117
+ if (!message?.value) return;
118
+ try {
119
+ const event = JSON.parse(message.value.toString());
120
+ await Promise.all(this.handlers.map((handler)=>handler(event)));
121
+ } catch (error) {
122
+ this.logger.error(error instanceof Error ? error.message : 'Failed to handle event');
123
+ }
124
+ }
125
+ });
126
+ } catch (error) {
127
+ // Released so a later bind can try again; the producer stays usable
128
+ this.running = false;
129
+ this.consumer = undefined;
130
+ throw error;
131
+ }
132
+ }
133
+ constructor(config = {}){
134
+ _define_property(this, "config", void 0);
135
+ _define_property(this, "name", void 0);
136
+ _define_property(this, "logger", void 0);
137
+ _define_property(this, "handlers", void 0);
138
+ _define_property(this, "boundPatterns", void 0);
139
+ _define_property(this, "client", void 0);
140
+ _define_property(this, "producer", void 0);
141
+ _define_property(this, "consumer", void 0);
142
+ _define_property(this, "running", void 0);
143
+ this.config = config;
144
+ this.name = 'kafka';
145
+ this.logger = new _common.Logger(KafkaTransport.name);
146
+ this.handlers = [];
147
+ this.boundPatterns = new Set();
148
+ this.running = false;
149
+ }
150
+ };
151
+ _eventtransportregistry.EventTransportRegistry.register('kafka', (config)=>new KafkaTransport(config));
@@ -0,0 +1,199 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ const _common = require("@nestjs/common");
6
+ const _eventactionenum = require("../../enums/event-action.enum");
7
+ const _kafkatransportoptional = require("./kafka-transport.optional");
8
+ const mockLoadOptionalModule = jest.fn();
9
+ jest.mock('../../utils/optional-module.util', ()=>({
10
+ loadOptionalModule: (...args)=>mockLoadOptionalModule(...args)
11
+ }));
12
+ function buildEvent() {
13
+ return {
14
+ id: 'event-1',
15
+ name: 'storage.folder.created',
16
+ module: 'storage',
17
+ entity: 'folder',
18
+ action: _eventactionenum.EventAction.CREATED,
19
+ payload: {
20
+ ids: [
21
+ '1'
22
+ ]
23
+ },
24
+ actor: {},
25
+ occurredAt: '2026-01-01T00:00:00.000Z',
26
+ version: 1
27
+ };
28
+ }
29
+ function createKafkaMock() {
30
+ const producer = {
31
+ connect: jest.fn().mockResolvedValue(undefined),
32
+ send: jest.fn().mockResolvedValue(undefined),
33
+ disconnect: jest.fn().mockResolvedValue(undefined)
34
+ };
35
+ const consumer = {
36
+ connect: jest.fn().mockResolvedValue(undefined),
37
+ subscribe: jest.fn().mockResolvedValue(undefined),
38
+ run: jest.fn().mockResolvedValue(undefined),
39
+ disconnect: jest.fn().mockResolvedValue(undefined)
40
+ };
41
+ const Kafka = jest.fn().mockImplementation(()=>({
42
+ producer: ()=>producer,
43
+ consumer: ()=>consumer
44
+ }));
45
+ return {
46
+ producer,
47
+ consumer,
48
+ Kafka
49
+ };
50
+ }
51
+ describe('KafkaTransport', ()=>{
52
+ let kafka;
53
+ let errorSpy;
54
+ beforeEach(()=>{
55
+ kafka = createKafkaMock();
56
+ mockLoadOptionalModule.mockResolvedValue({
57
+ Kafka: kafka.Kafka
58
+ });
59
+ errorSpy = jest.spyOn(_common.Logger.prototype, 'error').mockImplementation(()=>undefined);
60
+ });
61
+ afterEach(()=>{
62
+ errorSpy.mockRestore();
63
+ jest.clearAllMocks();
64
+ });
65
+ it('should throw a descriptive error when kafkajs is not installed', async ()=>{
66
+ mockLoadOptionalModule.mockRejectedValue(new Error('Cannot find module'));
67
+ await expect(new _kafkatransportoptional.KafkaTransport().connect()).rejects.toThrow(_common.InternalServerErrorException);
68
+ });
69
+ it('should connect the producer and leave the consumer alone until a bind', async ()=>{
70
+ const transport = new _kafkatransportoptional.KafkaTransport({
71
+ topic: 'events',
72
+ groupId: 'svc'
73
+ });
74
+ await transport.connect();
75
+ expect(kafka.producer.connect).toHaveBeenCalled();
76
+ expect(kafka.consumer.connect).not.toHaveBeenCalled();
77
+ expect(transport.isReady()).toBe(true);
78
+ });
79
+ it('should connect and subscribe the consumer on the first bind', async ()=>{
80
+ const transport = new _kafkatransportoptional.KafkaTransport({
81
+ topic: 'events',
82
+ groupId: 'svc'
83
+ });
84
+ await transport.connect();
85
+ await transport.bind('storage.#');
86
+ expect(kafka.consumer.connect).toHaveBeenCalled();
87
+ expect(kafka.consumer.subscribe).toHaveBeenCalledWith({
88
+ topic: 'events',
89
+ fromBeginning: false
90
+ });
91
+ });
92
+ it('should pass the broker list and client id through to kafkajs', async ()=>{
93
+ await new _kafkatransportoptional.KafkaTransport({
94
+ brokers: [
95
+ 'b1:9092'
96
+ ],
97
+ clientId: 'svc'
98
+ }).connect();
99
+ expect(kafka.Kafka).toHaveBeenCalledWith(expect.objectContaining({
100
+ brokers: [
101
+ 'b1:9092'
102
+ ],
103
+ clientId: 'svc'
104
+ }));
105
+ });
106
+ it('should send the event keyed by its name', async ()=>{
107
+ const transport = new _kafkatransportoptional.KafkaTransport({
108
+ topic: 'events'
109
+ });
110
+ await transport.connect();
111
+ await transport.publish(buildEvent());
112
+ expect(kafka.producer.send).toHaveBeenCalledWith({
113
+ topic: 'events',
114
+ messages: [
115
+ expect.objectContaining({
116
+ key: 'storage.folder.created',
117
+ headers: expect.objectContaining({
118
+ eventId: 'event-1',
119
+ module: 'storage'
120
+ })
121
+ })
122
+ ]
123
+ });
124
+ });
125
+ it('should ignore publish before connect instead of throwing', async ()=>{
126
+ await expect(new _kafkatransportoptional.KafkaTransport().publish(buildEvent())).resolves.toBeUndefined();
127
+ });
128
+ it('should start the consumer only once across several binds', async ()=>{
129
+ const transport = new _kafkatransportoptional.KafkaTransport();
130
+ await transport.connect();
131
+ await transport.bind('storage.#');
132
+ await transport.bind('auth.#');
133
+ expect(kafka.consumer.run).toHaveBeenCalledTimes(1);
134
+ });
135
+ it('should hand a consumed message to its handlers', async ()=>{
136
+ const transport = new _kafkatransportoptional.KafkaTransport();
137
+ const handler = jest.fn();
138
+ transport.onMessage(handler);
139
+ await transport.connect();
140
+ await transport.bind('storage.#');
141
+ const event = buildEvent();
142
+ await kafka.consumer.run.mock.calls[0][0].eachMessage({
143
+ message: {
144
+ value: Buffer.from(JSON.stringify(event))
145
+ }
146
+ });
147
+ expect(handler).toHaveBeenCalledWith(event);
148
+ });
149
+ it('should swallow a message it cannot parse', async ()=>{
150
+ const transport = new _kafkatransportoptional.KafkaTransport();
151
+ await transport.connect();
152
+ await transport.bind('storage.#');
153
+ await expect(kafka.consumer.run.mock.calls[0][0].eachMessage({
154
+ message: {
155
+ value: Buffer.from('not json')
156
+ }
157
+ })).resolves.toBeUndefined();
158
+ });
159
+ it('should disconnect both clients on close', async ()=>{
160
+ const transport = new _kafkatransportoptional.KafkaTransport();
161
+ await transport.connect();
162
+ await transport.bind('storage.#');
163
+ await transport.close();
164
+ expect(kafka.producer.disconnect).toHaveBeenCalled();
165
+ expect(kafka.consumer.disconnect).toHaveBeenCalled();
166
+ expect(transport.isReady()).toBe(false);
167
+ });
168
+ it('should keep publishing when the consumer cannot subscribe', async ()=>{
169
+ kafka.consumer.subscribe.mockRejectedValueOnce(new Error('UNKNOWN_TOPIC_OR_PARTITION'));
170
+ const transport = new _kafkatransportoptional.KafkaTransport();
171
+ await transport.connect();
172
+ await expect(transport.bind('storage.#')).rejects.toThrow('UNKNOWN_TOPIC_OR_PARTITION');
173
+ expect(transport.isReady()).toBe(true);
174
+ await transport.publish(buildEvent());
175
+ expect(kafka.producer.send).toHaveBeenCalled();
176
+ });
177
+ it('should let a later bind retry after the consumer failed to start', async ()=>{
178
+ kafka.consumer.subscribe.mockRejectedValueOnce(new Error('COORDINATOR_NOT_AVAILABLE'));
179
+ const transport = new _kafkatransportoptional.KafkaTransport();
180
+ await transport.connect();
181
+ await expect(transport.bind('storage.#')).rejects.toThrow('COORDINATOR_NOT_AVAILABLE');
182
+ await transport.bind('auth.#');
183
+ expect(kafka.consumer.run).toHaveBeenCalledTimes(1);
184
+ });
185
+ it('should skip a message that carries no value', async ()=>{
186
+ const transport = new _kafkatransportoptional.KafkaTransport();
187
+ const handler = jest.fn();
188
+ transport.onMessage(handler);
189
+ await transport.connect();
190
+ await transport.bind('storage.#');
191
+ await kafka.consumer.run.mock.calls[0][0].eachMessage({
192
+ message: {
193
+ value: null
194
+ }
195
+ });
196
+ expect(handler).not.toHaveBeenCalled();
197
+ expect(errorSpy).not.toHaveBeenCalled();
198
+ });
199
+ });
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ Object.defineProperty(exports, "MemoryTransport", {
6
+ enumerable: true,
7
+ get: function() {
8
+ return MemoryTransport;
9
+ }
10
+ });
11
+ const _events = require("events");
12
+ const _eventtransportregistry = require("./event-transport.registry");
13
+ function _define_property(obj, key, value) {
14
+ if (key in obj) {
15
+ Object.defineProperty(obj, key, {
16
+ value: value,
17
+ enumerable: true,
18
+ configurable: true,
19
+ writable: true
20
+ });
21
+ } else {
22
+ obj[key] = value;
23
+ }
24
+ return obj;
25
+ }
26
+ const CHANNEL = 'domain-event';
27
+ let MemoryTransport = class MemoryTransport {
28
+ async connect() {
29
+ this.ready = true;
30
+ }
31
+ async publish(event) {
32
+ this.emitter.emit(CHANNEL, event);
33
+ }
34
+ async bind(_pattern) {}
35
+ onMessage(handler) {
36
+ this.emitter.on(CHANNEL, (event)=>{
37
+ void handler(event);
38
+ });
39
+ }
40
+ async close() {
41
+ this.emitter.removeAllListeners();
42
+ this.ready = false;
43
+ }
44
+ isReady() {
45
+ return this.ready;
46
+ }
47
+ constructor(maxListeners = 100){
48
+ _define_property(this, "name", 'memory');
49
+ _define_property(this, "emitter", new _events.EventEmitter());
50
+ _define_property(this, "ready", false);
51
+ this.emitter.setMaxListeners(maxListeners);
52
+ }
53
+ };
54
+ _eventtransportregistry.EventTransportRegistry.register('memory', (config)=>new MemoryTransport(config['maxListeners']));
@@ -0,0 +1,58 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", {
3
+ value: true
4
+ });
5
+ const _eventactionenum = require("../../enums/event-action.enum");
6
+ const _memorytransport = require("./memory-transport");
7
+ function buildEvent(name = 'storage.folder.created') {
8
+ return {
9
+ id: 'event-1',
10
+ name,
11
+ module: 'storage',
12
+ entity: 'folder',
13
+ action: _eventactionenum.EventAction.CREATED,
14
+ payload: {
15
+ ids: [
16
+ '1'
17
+ ]
18
+ },
19
+ actor: {},
20
+ occurredAt: new Date().toISOString(),
21
+ version: 1
22
+ };
23
+ }
24
+ describe('MemoryTransport', ()=>{
25
+ let transport;
26
+ beforeEach(()=>{
27
+ transport = new _memorytransport.MemoryTransport();
28
+ });
29
+ afterEach(async ()=>{
30
+ await transport.close();
31
+ });
32
+ it('should report ready only after connect', async ()=>{
33
+ expect(transport.isReady()).toBe(false);
34
+ await transport.connect();
35
+ expect(transport.isReady()).toBe(true);
36
+ });
37
+ it('should deliver a published event to every registered handler', async ()=>{
38
+ const first = jest.fn();
39
+ const second = jest.fn();
40
+ transport.onMessage(first);
41
+ transport.onMessage(second);
42
+ const event = buildEvent();
43
+ await transport.publish(event);
44
+ expect(first).toHaveBeenCalledWith(event);
45
+ expect(second).toHaveBeenCalledWith(event);
46
+ });
47
+ it('should not deliver anything once closed', async ()=>{
48
+ const handler = jest.fn();
49
+ transport.onMessage(handler);
50
+ await transport.close();
51
+ await transport.publish(buildEvent());
52
+ expect(handler).not.toHaveBeenCalled();
53
+ expect(transport.isReady()).toBe(false);
54
+ });
55
+ it('should accept bind calls without a broker', async ()=>{
56
+ await expect(transport.bind('storage.#')).resolves.toBeUndefined();
57
+ });
58
+ });