@argos-js/events 0.0.0-stage → 0.1.0

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 (95) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +156 -2
  3. package/dist/config/define-events-config.d.ts +3 -0
  4. package/dist/config/define-events-config.d.ts.map +1 -0
  5. package/dist/config/define-events-config.js +19 -0
  6. package/dist/config/define-events-config.js.map +1 -0
  7. package/dist/drivers/driver.interface.d.ts +49 -0
  8. package/dist/drivers/driver.interface.d.ts.map +1 -0
  9. package/dist/drivers/driver.interface.js +3 -0
  10. package/dist/drivers/driver.interface.js.map +1 -0
  11. package/dist/drivers/kafka.driver.d.ts +27 -0
  12. package/dist/drivers/kafka.driver.d.ts.map +1 -0
  13. package/dist/drivers/kafka.driver.js +214 -0
  14. package/dist/drivers/kafka.driver.js.map +1 -0
  15. package/dist/drivers/memory.driver.d.ts +37 -0
  16. package/dist/drivers/memory.driver.d.ts.map +1 -0
  17. package/dist/drivers/memory.driver.js +261 -0
  18. package/dist/drivers/memory.driver.js.map +1 -0
  19. package/dist/drivers/pulse/bincode-reader.d.ts +25 -0
  20. package/dist/drivers/pulse/bincode-reader.d.ts.map +1 -0
  21. package/dist/drivers/pulse/bincode-reader.js +100 -0
  22. package/dist/drivers/pulse/bincode-reader.js.map +1 -0
  23. package/dist/drivers/pulse/bincode-writer.d.ts +25 -0
  24. package/dist/drivers/pulse/bincode-writer.d.ts.map +1 -0
  25. package/dist/drivers/pulse/bincode-writer.js +86 -0
  26. package/dist/drivers/pulse/bincode-writer.js.map +1 -0
  27. package/dist/drivers/pulse/index.d.ts +8 -0
  28. package/dist/drivers/pulse/index.d.ts.map +1 -0
  29. package/dist/drivers/pulse/index.js +24 -0
  30. package/dist/drivers/pulse/index.js.map +1 -0
  31. package/dist/drivers/pulse/protocol.d.ts +26 -0
  32. package/dist/drivers/pulse/protocol.d.ts.map +1 -0
  33. package/dist/drivers/pulse/protocol.js +98 -0
  34. package/dist/drivers/pulse/protocol.js.map +1 -0
  35. package/dist/drivers/pulse/pulse.driver.d.ts +58 -0
  36. package/dist/drivers/pulse/pulse.driver.d.ts.map +1 -0
  37. package/dist/drivers/pulse/pulse.driver.js +351 -0
  38. package/dist/drivers/pulse/pulse.driver.js.map +1 -0
  39. package/dist/drivers/pulse/socket-transport.d.ts +35 -0
  40. package/dist/drivers/pulse/socket-transport.d.ts.map +1 -0
  41. package/dist/drivers/pulse/socket-transport.js +128 -0
  42. package/dist/drivers/pulse/socket-transport.js.map +1 -0
  43. package/dist/drivers/pulse/stream-parser.d.ts +24 -0
  44. package/dist/drivers/pulse/stream-parser.d.ts.map +1 -0
  45. package/dist/drivers/pulse/stream-parser.js +57 -0
  46. package/dist/drivers/pulse/stream-parser.js.map +1 -0
  47. package/dist/drivers/pulse/types.d.ts +90 -0
  48. package/dist/drivers/pulse/types.d.ts.map +1 -0
  49. package/dist/drivers/pulse/types.js +28 -0
  50. package/dist/drivers/pulse/types.js.map +1 -0
  51. package/dist/drivers/rabbitmq.driver.d.ts +27 -0
  52. package/dist/drivers/rabbitmq.driver.d.ts.map +1 -0
  53. package/dist/drivers/rabbitmq.driver.js +198 -0
  54. package/dist/drivers/rabbitmq.driver.js.map +1 -0
  55. package/dist/drivers/redis.driver.d.ts +30 -0
  56. package/dist/drivers/redis.driver.d.ts.map +1 -0
  57. package/dist/drivers/redis.driver.js +206 -0
  58. package/dist/drivers/redis.driver.js.map +1 -0
  59. package/dist/index.d.ts +16 -0
  60. package/dist/index.d.ts.map +1 -0
  61. package/dist/index.js +32 -0
  62. package/dist/index.js.map +1 -0
  63. package/dist/manager/events-manager.d.ts +71 -0
  64. package/dist/manager/events-manager.d.ts.map +1 -0
  65. package/dist/manager/events-manager.js +272 -0
  66. package/dist/manager/events-manager.js.map +1 -0
  67. package/dist/outbox/outbox-relay.d.ts +22 -0
  68. package/dist/outbox/outbox-relay.d.ts.map +1 -0
  69. package/dist/outbox/outbox-relay.js +217 -0
  70. package/dist/outbox/outbox-relay.js.map +1 -0
  71. package/dist/outbox/outbox-table.d.ts +5 -0
  72. package/dist/outbox/outbox-table.d.ts.map +1 -0
  73. package/dist/outbox/outbox-table.js +213 -0
  74. package/dist/outbox/outbox-table.js.map +1 -0
  75. package/dist/outbox/outbox.types.d.ts +31 -0
  76. package/dist/outbox/outbox.types.d.ts.map +1 -0
  77. package/dist/outbox/outbox.types.js +3 -0
  78. package/dist/outbox/outbox.types.js.map +1 -0
  79. package/dist/types/driver.types.d.ts +93 -0
  80. package/dist/types/driver.types.d.ts.map +1 -0
  81. package/dist/types/driver.types.js +3 -0
  82. package/dist/types/driver.types.js.map +1 -0
  83. package/dist/types/event.types.d.ts +152 -0
  84. package/dist/types/event.types.d.ts.map +1 -0
  85. package/dist/types/event.types.js +3 -0
  86. package/dist/types/event.types.js.map +1 -0
  87. package/dist/utils/sqid.d.ts +5 -0
  88. package/dist/utils/sqid.d.ts.map +1 -0
  89. package/dist/utils/sqid.js +17 -0
  90. package/dist/utils/sqid.js.map +1 -0
  91. package/dist/utils/uuid.d.ts +5 -0
  92. package/dist/utils/uuid.d.ts.map +1 -0
  93. package/dist/utils/uuid.js +25 -0
  94. package/dist/utils/uuid.js.map +1 -0
  95. package/package.json +35 -3
@@ -0,0 +1,98 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.encodeSubscribe = encodeSubscribe;
4
+ exports.encodeJoinGroup = encodeJoinGroup;
5
+ exports.encodeAck = encodeAck;
6
+ exports.encodeNack = encodeNack;
7
+ exports.encodeSeekHlc = encodeSeekHlc;
8
+ exports.decodeServerFrame = decodeServerFrame;
9
+ const bincode_writer_js_1 = require("./bincode-writer.js");
10
+ const bincode_reader_js_1 = require("./bincode-reader.js");
11
+ // ==========================================
12
+ // OPCODES (CLIENT -> SERVER ENCODING)
13
+ // ==========================================
14
+ /**
15
+ * Encodes OpCode 0x00: Subscribe(pattern: String)
16
+ */
17
+ function encodeSubscribe(pattern) {
18
+ const w = new bincode_writer_js_1.BincodeWriter();
19
+ w.writeU32(0); // OpCode::Subscribe = 0
20
+ w.writeString(pattern);
21
+ return w.toFrame();
22
+ }
23
+ /**
24
+ * Encodes OpCode 0x01: JoinGroup(group_name: String, consumer_id: String, pattern: String)
25
+ */
26
+ function encodeJoinGroup(groupName, consumerId, pattern) {
27
+ const w = new bincode_writer_js_1.BincodeWriter();
28
+ w.writeU32(1); // OpCode::JoinGroup = 1
29
+ w.writeString(groupName);
30
+ w.writeString(consumerId);
31
+ w.writeString(pattern);
32
+ return w.toFrame();
33
+ }
34
+ /**
35
+ * Encodes OpCode 0x02: Ack(group_name: String, message_id: u128)
36
+ */
37
+ function encodeAck(groupName, messageId) {
38
+ const w = new bincode_writer_js_1.BincodeWriter();
39
+ w.writeU32(2); // OpCode::Ack = 2
40
+ w.writeString(groupName);
41
+ w.writeU128(messageId);
42
+ return w.toFrame();
43
+ }
44
+ /**
45
+ * Encodes OpCode 0x03: Nack(group_name: String, message_id: u128)
46
+ */
47
+ function encodeNack(groupName, messageId) {
48
+ const w = new bincode_writer_js_1.BincodeWriter();
49
+ w.writeU32(3); // OpCode::Nack = 3
50
+ w.writeString(groupName);
51
+ w.writeU128(messageId);
52
+ return w.toFrame();
53
+ }
54
+ /**
55
+ * Encodes OpCode 0x04: SeekHlc(hlc: u128)
56
+ */
57
+ function encodeSeekHlc(hlc) {
58
+ const w = new bincode_writer_js_1.BincodeWriter();
59
+ w.writeU32(4); // OpCode::SeekHlc = 4
60
+ w.writeU128(hlc);
61
+ return w.toFrame();
62
+ }
63
+ // ==========================================
64
+ // SERVER FRAMES (SERVER -> CLIENT DECODING)
65
+ // ==========================================
66
+ /**
67
+ * Decodes a Bincode 1.x serialized ServerFrame payload into a structured ServerFrame object.
68
+ */
69
+ function decodeServerFrame(payload) {
70
+ const r = new bincode_reader_js_1.BincodeReader(payload);
71
+ const tag = r.readU32();
72
+ switch (tag) {
73
+ case 0:
74
+ return { type: 'Subscribed', pattern: r.readString() };
75
+ case 1:
76
+ return { type: 'JoinedGroup', groupName: r.readString(), consumerId: r.readString() };
77
+ case 2:
78
+ return { type: 'Record', topic: r.readString(), event: r.readMutationEvent() };
79
+ case 3:
80
+ return {
81
+ type: 'GroupRecord',
82
+ groupName: r.readString(),
83
+ consumerId: r.readString(),
84
+ messageId: r.readU128(),
85
+ topic: r.readString(),
86
+ event: r.readMutationEvent(),
87
+ };
88
+ case 4:
89
+ return { type: 'AckResult', ok: r.readBool(), messageId: r.readU128() };
90
+ case 5:
91
+ return { type: 'NackResult', ok: r.readBool(), messageId: r.readU128() };
92
+ case 6:
93
+ return { type: 'Error', message: r.readString() };
94
+ default:
95
+ throw new Error(`Unknown ServerFrame opcode tag: ${tag}`);
96
+ }
97
+ }
98
+ //# sourceMappingURL=protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/drivers/pulse/protocol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ import type { EventDriver } from '../driver.interface.js';
2
+ import type { EventHandler, EventMessage, SubscribeOptions, Subscription } from '../../types/event.types.js';
3
+ import type { ConsumerGroupOptions, GroupEventHandler, PulseDriverConfig } from './types.js';
4
+ /**
5
+ * Official ArgosDB-Pulse CDC Event Driver.
6
+ * Connects over TCP to port 8788 using binary Bincode 1.x Little-Endian framing.
7
+ */
8
+ export declare class ArgosPulseDriver implements EventDriver {
9
+ readonly name = "pulse";
10
+ private host;
11
+ private port;
12
+ private autoAck;
13
+ private reconnectEnabled;
14
+ private initialDelayMs;
15
+ private maxDelayMs;
16
+ private maxRetries;
17
+ private transportFactory;
18
+ private transport;
19
+ private parser;
20
+ private subscriptions;
21
+ private groupSubscriptions;
22
+ private isConnectedFlag;
23
+ private isExplicitDisconnect;
24
+ private reconnectAttempts;
25
+ private reconnectTimer;
26
+ constructor(config?: PulseDriverConfig);
27
+ connect(): Promise<void>;
28
+ disconnect(): Promise<void>;
29
+ isConnected(): boolean;
30
+ /**
31
+ * Publishes an event. Note: ArgosDB Pulse is a CDC/WAL engine where events are
32
+ * generated automatically by database mutations. Direct publishing to Pulse is not supported.
33
+ */
34
+ publish(_event: EventMessage): Promise<void>;
35
+ emit(_event: EventMessage): Promise<void>;
36
+ /**
37
+ * Subscribes to CDC mutation events using topic pattern wildcard (e.g. 'cdc.auth_users.*').
38
+ */
39
+ subscribe(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
40
+ on(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
41
+ /**
42
+ * Subscribes to a Consumer Group with competing consumer load-balancing and manual/auto ack.
43
+ */
44
+ subscribeGroup(options: ConsumerGroupOptions, handler: GroupEventHandler): Promise<Subscription>;
45
+ /**
46
+ * Sends manual Ack for a consumer group message.
47
+ */
48
+ sendAck(groupName: string, messageId: bigint): Promise<void>;
49
+ /**
50
+ * Sends manual Nack for a consumer group message.
51
+ */
52
+ sendNack(groupName: string, messageId: bigint): Promise<void>;
53
+ private sendFrame;
54
+ private resubscribeAll;
55
+ private handleDisconnection;
56
+ private handleServerFrame;
57
+ }
58
+ //# sourceMappingURL=pulse.driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pulse.driver.d.ts","sourceRoot":"","sources":["../../../src/drivers/pulse/pulse.driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EAEjB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AA4CpB;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,SAAgB,IAAI,WAAW;IAE/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAU;IAEzB,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAA2B;IAEzC,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,kBAAkB,CAAkD;IAE5E,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAa;gBAEvB,MAAM,GAAE,iBAAsB;IAsB7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjC,WAAW,IAAI,OAAO;IAI7B;;;OAGG;IACU,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;OAEG;IACU,SAAS,CACpB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC;IAyCX,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC;IAIxB;;OAEG;IACU,cAAc,CACzB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC;IAoCxB;;OAEG;IACU,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE;;OAEG;IACU,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAO5D,SAAS;YAOT,cAAc;IAkB5B,OAAO,CAAC,mBAAmB;YA2Bb,iBAAiB;CAsGhC"}
@@ -0,0 +1,351 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ArgosPulseDriver = void 0;
4
+ const types_js_1 = require("./types.js");
5
+ const protocol_js_1 = require("./protocol.js");
6
+ const stream_parser_js_1 = require("./stream-parser.js");
7
+ const socket_transport_js_1 = require("./socket-transport.js");
8
+ /**
9
+ * Matches AMQP/MQTT style topic patterns (* single segment, # or * wildcards).
10
+ */
11
+ function matchTopic(pattern, topic) {
12
+ if (pattern === topic || pattern === '*' || pattern === '#') {
13
+ return true;
14
+ }
15
+ const regexStr = '^' +
16
+ pattern
17
+ .replace(/\./g, '\\.')
18
+ .replace(/\*/g, '[^.]+')
19
+ .replace(/#/g, '.*') +
20
+ '$';
21
+ return new RegExp(regexStr).test(topic);
22
+ }
23
+ /**
24
+ * Official ArgosDB-Pulse CDC Event Driver.
25
+ * Connects over TCP to port 8788 using binary Bincode 1.x Little-Endian framing.
26
+ */
27
+ class ArgosPulseDriver {
28
+ name = 'pulse';
29
+ host;
30
+ port;
31
+ autoAck;
32
+ reconnectEnabled;
33
+ initialDelayMs;
34
+ maxDelayMs;
35
+ maxRetries;
36
+ transportFactory;
37
+ transport = null;
38
+ parser = new stream_parser_js_1.PulseStreamParser();
39
+ subscriptions = new Map();
40
+ groupSubscriptions = new Map();
41
+ isConnectedFlag = false;
42
+ isExplicitDisconnect = false;
43
+ reconnectAttempts = 0;
44
+ reconnectTimer = null;
45
+ constructor(config = {}) {
46
+ this.host = config.host || process.env.ARGOS_PULSE_HOST || '127.0.0.1';
47
+ this.port = config.port || Number(process.env.ARGOS_PULSE_PORT) || 8788;
48
+ this.autoAck = config.autoAck ?? false;
49
+ this.reconnectEnabled = config.reconnect?.enabled ?? true;
50
+ this.initialDelayMs = config.reconnect?.initialDelayMs ?? 250;
51
+ this.maxDelayMs = config.reconnect?.maxDelayMs ?? 5000;
52
+ this.maxRetries = config.reconnect?.maxRetries ?? Infinity;
53
+ if (config.transport) {
54
+ if (typeof config.transport === 'function') {
55
+ this.transportFactory = config.transport;
56
+ }
57
+ else {
58
+ const instance = config.transport;
59
+ this.transportFactory = () => instance;
60
+ }
61
+ }
62
+ else {
63
+ this.transportFactory = () => new socket_transport_js_1.NodeNetSocketTransport();
64
+ }
65
+ }
66
+ async connect() {
67
+ this.isExplicitDisconnect = false;
68
+ if (this.isConnectedFlag) {
69
+ return;
70
+ }
71
+ if (this.reconnectTimer) {
72
+ clearTimeout(this.reconnectTimer);
73
+ this.reconnectTimer = null;
74
+ }
75
+ const transport = this.transportFactory();
76
+ this.transport = transport;
77
+ transport.onData((chunk) => {
78
+ this.parser.feed(chunk, (frame) => this.handleServerFrame(frame));
79
+ });
80
+ transport.onError((_err) => {
81
+ // In background, log or initiate reconnect
82
+ if (!this.isExplicitDisconnect && this.isConnectedFlag) {
83
+ this.handleDisconnection();
84
+ }
85
+ });
86
+ transport.onClose(() => {
87
+ if (!this.isExplicitDisconnect && this.isConnectedFlag) {
88
+ this.handleDisconnection();
89
+ }
90
+ });
91
+ await transport.connect({
92
+ host: this.host,
93
+ port: this.port,
94
+ });
95
+ this.isConnectedFlag = true;
96
+ this.reconnectAttempts = 0;
97
+ // Resubscribe all active subscriptions upon connection
98
+ await this.resubscribeAll();
99
+ }
100
+ async disconnect() {
101
+ this.isExplicitDisconnect = true;
102
+ this.isConnectedFlag = false;
103
+ if (this.reconnectTimer) {
104
+ clearTimeout(this.reconnectTimer);
105
+ this.reconnectTimer = null;
106
+ }
107
+ if (this.transport) {
108
+ await this.transport.close().catch(() => { });
109
+ this.transport = null;
110
+ }
111
+ this.parser.clear();
112
+ }
113
+ isConnected() {
114
+ return this.isConnectedFlag && (this.transport?.isConnected() ?? false);
115
+ }
116
+ /**
117
+ * Publishes an event. Note: ArgosDB Pulse is a CDC/WAL engine where events are
118
+ * generated automatically by database mutations. Direct publishing to Pulse is not supported.
119
+ */
120
+ async publish(_event) {
121
+ throw new Error('ArgosPulseDriver: Direct event publishing is not supported by argosdb-pulse CDC engine. Events are automatically generated from database mutations.');
122
+ }
123
+ async emit(_event) {
124
+ return await this.publish(_event);
125
+ }
126
+ /**
127
+ * Subscribes to CDC mutation events using topic pattern wildcard (e.g. 'cdc.auth_users.*').
128
+ */
129
+ async subscribe(eventName, optionsOrHandler, maybeHandler) {
130
+ let opts;
131
+ let handler;
132
+ if (typeof optionsOrHandler === 'function') {
133
+ opts = {};
134
+ handler = optionsOrHandler;
135
+ }
136
+ else {
137
+ opts = optionsOrHandler || {};
138
+ if (typeof maybeHandler === 'function') {
139
+ handler = maybeHandler;
140
+ }
141
+ else if (typeof opts.handle === 'function') {
142
+ handler = opts.handle.bind(opts);
143
+ }
144
+ else {
145
+ throw new Error('No EventHandler function provided to subscribe.');
146
+ }
147
+ }
148
+ const id = `pulse_sub_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
149
+ const subRecord = {
150
+ id,
151
+ pattern: eventName,
152
+ options: opts,
153
+ handler,
154
+ };
155
+ this.subscriptions.set(id, subRecord);
156
+ if (this.isConnected()) {
157
+ await this.sendFrame((0, protocol_js_1.encodeSubscribe)(eventName));
158
+ }
159
+ return {
160
+ id,
161
+ topic: eventName,
162
+ unsubscribe: async () => {
163
+ this.subscriptions.delete(id);
164
+ },
165
+ };
166
+ }
167
+ async on(eventName, optionsOrHandler, maybeHandler) {
168
+ return await this.subscribe(eventName, optionsOrHandler, maybeHandler);
169
+ }
170
+ /**
171
+ * Subscribes to a Consumer Group with competing consumer load-balancing and manual/auto ack.
172
+ */
173
+ async subscribeGroup(options, handler) {
174
+ const id = `pulse_group_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
175
+ const workerId = options.workerId || `worker-${process.pid || Math.random().toString(36).slice(2, 6)}`;
176
+ const groupRecord = {
177
+ id,
178
+ options: {
179
+ ...options,
180
+ workerId,
181
+ },
182
+ handler,
183
+ };
184
+ // Replace any existing subscription for the same group and worker to avoid duplicate callbacks
185
+ for (const [existingId, sub] of this.groupSubscriptions.entries()) {
186
+ if (sub.options.group === options.group && sub.options.workerId === workerId) {
187
+ this.groupSubscriptions.delete(existingId);
188
+ }
189
+ }
190
+ this.groupSubscriptions.set(id, groupRecord);
191
+ if (this.isConnected()) {
192
+ await this.sendFrame((0, protocol_js_1.encodeJoinGroup)(options.group, workerId, options.pattern));
193
+ }
194
+ return {
195
+ id,
196
+ topic: options.pattern,
197
+ group: options.group,
198
+ unsubscribe: async () => {
199
+ this.groupSubscriptions.delete(id);
200
+ },
201
+ };
202
+ }
203
+ /**
204
+ * Sends manual Ack for a consumer group message.
205
+ */
206
+ async sendAck(groupName, messageId) {
207
+ if (!this.isConnected()) {
208
+ throw new Error('Cannot send Ack: pulse driver is not connected');
209
+ }
210
+ await this.sendFrame((0, protocol_js_1.encodeAck)(groupName, messageId));
211
+ }
212
+ /**
213
+ * Sends manual Nack for a consumer group message.
214
+ */
215
+ async sendNack(groupName, messageId) {
216
+ if (!this.isConnected()) {
217
+ throw new Error('Cannot send Nack: pulse driver is not connected');
218
+ }
219
+ await this.sendFrame((0, protocol_js_1.encodeNack)(groupName, messageId));
220
+ }
221
+ async sendFrame(frame) {
222
+ if (!this.transport) {
223
+ throw new Error('Socket transport not initialized');
224
+ }
225
+ await this.transport.send(frame);
226
+ }
227
+ async resubscribeAll() {
228
+ // 1. Resubscribe broadcast patterns
229
+ for (const sub of this.subscriptions.values()) {
230
+ await this.sendFrame((0, protocol_js_1.encodeSubscribe)(sub.pattern)).catch(() => { });
231
+ }
232
+ // 2. Re-join all consumer groups
233
+ for (const groupSub of this.groupSubscriptions.values()) {
234
+ await this.sendFrame((0, protocol_js_1.encodeJoinGroup)(groupSub.options.group, groupSub.options.workerId, groupSub.options.pattern)).catch(() => { });
235
+ }
236
+ }
237
+ handleDisconnection() {
238
+ this.isConnectedFlag = false;
239
+ if (this.isExplicitDisconnect || !this.reconnectEnabled) {
240
+ return;
241
+ }
242
+ if (this.reconnectAttempts >= this.maxRetries) {
243
+ console.warn(`[ArgosPulseDriver] Max reconnect attempts (${this.maxRetries}) reached.`);
244
+ return;
245
+ }
246
+ const delay = Math.min(this.initialDelayMs * Math.pow(2, this.reconnectAttempts), this.maxDelayMs);
247
+ this.reconnectAttempts++;
248
+ this.reconnectTimer = setTimeout(async () => {
249
+ try {
250
+ await this.connect();
251
+ }
252
+ catch (err) {
253
+ this.handleDisconnection();
254
+ }
255
+ }, delay);
256
+ }
257
+ async handleServerFrame(frame) {
258
+ switch (frame.type) {
259
+ case 'Subscribed':
260
+ case 'JoinedGroup':
261
+ case 'AckResult':
262
+ case 'NackResult':
263
+ // Protocol confirmation frames
264
+ break;
265
+ case 'Record': {
266
+ const topic = frame.topic;
267
+ const event = frame.event;
268
+ const payload = event.jsonPayload() ?? event.afterPayload;
269
+ const eventMessage = {
270
+ id: event.hlc.toString(),
271
+ topic,
272
+ name: topic,
273
+ payload,
274
+ headers: {
275
+ 'x-table': event.tableName,
276
+ 'x-op': types_js_1.MutationOp[event.op],
277
+ 'x-hlc': event.hlc.toString(),
278
+ },
279
+ timestamp: Date.now(),
280
+ };
281
+ const ctx = {
282
+ topic,
283
+ attempt: 1,
284
+ ack: async () => { },
285
+ nack: async () => { },
286
+ };
287
+ for (const sub of this.subscriptions.values()) {
288
+ if (matchTopic(sub.pattern, topic)) {
289
+ try {
290
+ await sub.handler(eventMessage, ctx);
291
+ }
292
+ catch (err) {
293
+ console.error(`[ArgosPulseDriver] Error in subscriber handler for topic ${topic}:`, err);
294
+ }
295
+ }
296
+ }
297
+ break;
298
+ }
299
+ case 'GroupRecord': {
300
+ const groupName = frame.groupName;
301
+ const topic = frame.topic;
302
+ const messageId = frame.messageId;
303
+ const event = frame.event;
304
+ const payload = event.jsonPayload() ?? event.afterPayload;
305
+ const record = {
306
+ groupName,
307
+ consumerId: frame.consumerId,
308
+ messageId,
309
+ topic,
310
+ event,
311
+ payload,
312
+ };
313
+ const ctx = {
314
+ topic,
315
+ group: groupName,
316
+ attempt: 1,
317
+ ack: async () => {
318
+ await this.sendAck(groupName, messageId);
319
+ },
320
+ nack: async () => {
321
+ await this.sendNack(groupName, messageId);
322
+ },
323
+ };
324
+ for (const groupSub of this.groupSubscriptions.values()) {
325
+ if (groupSub.options.group === groupName) {
326
+ const autoAck = groupSub.options.autoAck ?? this.autoAck;
327
+ try {
328
+ await groupSub.handler(record, ctx);
329
+ if (autoAck) {
330
+ await ctx.ack().catch(() => { });
331
+ }
332
+ }
333
+ catch (err) {
334
+ if (autoAck) {
335
+ await ctx.nack().catch(() => { });
336
+ }
337
+ console.error(`[ArgosPulseDriver] Error in group subscriber handler [${groupName}]:`, err);
338
+ }
339
+ }
340
+ }
341
+ break;
342
+ }
343
+ case 'Error': {
344
+ console.error(`[ArgosPulseDriver] Server Error received from pulse: ${frame.message}`);
345
+ break;
346
+ }
347
+ }
348
+ }
349
+ }
350
+ exports.ArgosPulseDriver = ArgosPulseDriver;
351
+ //# sourceMappingURL=pulse.driver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pulse.driver.js","sourceRoot":"","sources":["../../../src/drivers/pulse/pulse.driver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ export interface SocketTransportOptions {
2
+ host: string;
3
+ port: number;
4
+ connectTimeoutMs?: number;
5
+ }
6
+ /**
7
+ * Portable socket abstraction interface decoupling transport from runtime environment.
8
+ */
9
+ export interface SocketTransport {
10
+ connect(options: SocketTransportOptions): Promise<void>;
11
+ send(data: Uint8Array): Promise<void>;
12
+ onData(handler: (data: Uint8Array) => void): void;
13
+ onError(handler: (error: Error) => void): void;
14
+ onClose(handler: () => void): void;
15
+ close(): Promise<void>;
16
+ isConnected(): boolean;
17
+ }
18
+ /**
19
+ * Standard TCP SocketTransport implementation using node:net (compatible with Node.js 18+, Bun, and Deno).
20
+ */
21
+ export declare class NodeNetSocketTransport implements SocketTransport {
22
+ private socket;
23
+ private dataHandlers;
24
+ private errorHandlers;
25
+ private closeHandlers;
26
+ private connected;
27
+ connect(options: SocketTransportOptions): Promise<void>;
28
+ send(data: Uint8Array): Promise<void>;
29
+ onData(handler: (data: Uint8Array) => void): void;
30
+ onError(handler: (error: Error) => void): void;
31
+ onClose(handler: () => void): void;
32
+ close(): Promise<void>;
33
+ isConnected(): boolean;
34
+ }
35
+ //# sourceMappingURL=socket-transport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"socket-transport.d.ts","sourceRoot":"","sources":["../../../src/drivers/pulse/socket-transport.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAClD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAkB;IAE7B,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDvD,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIjD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI9C,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAI5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,WAAW,IAAI,OAAO;CAGvB"}