@argos-js/events 0.0.0-stage → 0.1.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 (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,261 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.MemoryEventDriver = exports.MemoryDriver = void 0;
4
+ exports.matchTopic = matchTopic;
5
+ const node_crypto_1 = require("node:crypto");
6
+ const types_js_1 = require("./pulse/types.js");
7
+ /**
8
+ * Matches AMQP / MQTT-style topic patterns with single-word (*) and multi-word (#) wildcards.
9
+ *
10
+ * Example:
11
+ * - 'order.*' matches 'order.created' and 'order.updated', but not 'order.item.created'
12
+ * - 'order.#' matches 'order.created' and 'order.item.created'
13
+ * - '*' or '#' matches everything
14
+ */
15
+ function matchTopic(pattern, topic) {
16
+ if (pattern === topic || pattern === '*' || pattern === '#') {
17
+ return true;
18
+ }
19
+ const regexStr = '^' + pattern
20
+ .replace(/\./g, '\\.')
21
+ .replace(/\*/g, '[^.]+')
22
+ .replace(/#/g, '.*') + '$';
23
+ return new RegExp(regexStr).test(topic);
24
+ }
25
+ /**
26
+ * High-performance, in-memory event driver with zero external dependencies.
27
+ * Implements full pub/sub, wildcard topic matching, and simulated consumer group load-balancing.
28
+ */
29
+ class MemoryDriver {
30
+ name = 'memory';
31
+ subscriptions = [];
32
+ groupPointers = new Map();
33
+ connected = false;
34
+ constructor(_config = {}) { }
35
+ async connect() {
36
+ this.connected = true;
37
+ }
38
+ isConnected() {
39
+ return this.connected;
40
+ }
41
+ async emit(event) {
42
+ return await this.publish(event);
43
+ }
44
+ async publish(event) {
45
+ if (!this.connected) {
46
+ await this.connect();
47
+ }
48
+ const topicName = event.topic || event.name || '';
49
+ // Ensure both topic and name are populated on event
50
+ const normalizedEvent = {
51
+ ...event,
52
+ topic: topicName,
53
+ name: topicName,
54
+ headers: event.headers || {},
55
+ timestamp: event.timestamp || Date.now(),
56
+ };
57
+ // Find all matching subscriptions
58
+ const matches = this.subscriptions.filter((sub) => {
59
+ if (!matchTopic(sub.pattern, topicName)) {
60
+ return false;
61
+ }
62
+ if (sub.options.filter && !sub.options.filter(normalizedEvent)) {
63
+ return false;
64
+ }
65
+ return true;
66
+ });
67
+ if (matches.length === 0) {
68
+ return;
69
+ }
70
+ // Separate into broadcast (no group) and grouped (competing consumers)
71
+ const broadcastSubs = [];
72
+ const groupedSubs = new Map();
73
+ for (const sub of matches) {
74
+ if (!sub.options.group) {
75
+ broadcastSubs.push(sub);
76
+ }
77
+ else {
78
+ const group = sub.options.group;
79
+ const list = groupedSubs.get(group) || [];
80
+ list.push(sub);
81
+ groupedSubs.set(group, list);
82
+ }
83
+ }
84
+ // 1. Deliver to all broadcast subscribers
85
+ for (const sub of broadcastSubs) {
86
+ await this.deliver(sub, normalizedEvent, 1);
87
+ }
88
+ // 2. Deliver to ONE member of each consumer group (Round-Robin)
89
+ for (const [groupName, members] of groupedSubs.entries()) {
90
+ if (members.length === 0)
91
+ continue;
92
+ const currentIndex = this.groupPointers.get(groupName) || 0;
93
+ const selectedSub = members[currentIndex % members.length];
94
+ this.groupPointers.set(groupName, (currentIndex + 1) % members.length);
95
+ await this.deliver(selectedSub, normalizedEvent, 1);
96
+ }
97
+ }
98
+ async publishBatch(events) {
99
+ for (const event of events) {
100
+ await this.publish(event);
101
+ }
102
+ }
103
+ async subscribe(eventName, optionsOrHandler, maybeHandler) {
104
+ if (!this.connected) {
105
+ await this.connect();
106
+ }
107
+ let options;
108
+ let handler;
109
+ if (typeof optionsOrHandler === 'function') {
110
+ options = {};
111
+ handler = optionsOrHandler;
112
+ }
113
+ else {
114
+ options = optionsOrHandler || {};
115
+ if (typeof maybeHandler === 'function') {
116
+ handler = maybeHandler;
117
+ }
118
+ else if (typeof options.handle === 'function') {
119
+ handler = options.handle;
120
+ }
121
+ else {
122
+ throw new Error('No EventHandler provided to subscribe.');
123
+ }
124
+ }
125
+ const subId = `sub_${(0, node_crypto_1.randomUUID)()}`;
126
+ const subEntry = {
127
+ id: subId,
128
+ pattern: eventName,
129
+ options,
130
+ handler,
131
+ };
132
+ this.subscriptions.push(subEntry);
133
+ const subscription = {
134
+ id: subId,
135
+ topic: eventName,
136
+ group: options.group,
137
+ unsubscribe: async () => {
138
+ const index = this.subscriptions.findIndex((s) => s.id === subId);
139
+ if (index !== -1) {
140
+ this.subscriptions.splice(index, 1);
141
+ }
142
+ },
143
+ };
144
+ return subscription;
145
+ }
146
+ async subscribeGroup(options, handler) {
147
+ const group = options.group;
148
+ const pattern = options.pattern;
149
+ const autoAck = options.autoAck ?? false;
150
+ return await this.subscribe(pattern, { group, autoAck }, async (event, ctx) => {
151
+ const payload = event.payload;
152
+ const afterPayload = payload instanceof Uint8Array
153
+ ? payload
154
+ : typeof payload === 'string'
155
+ ? new TextEncoder().encode(payload)
156
+ : new TextEncoder().encode(JSON.stringify(payload));
157
+ const mutationEvent = (0, types_js_1.createMutationEvent)({
158
+ hlc: BigInt(event.timestamp || Date.now()),
159
+ tableName: event.topic.split('.')[1] || event.topic,
160
+ op: types_js_1.MutationOp.Insert,
161
+ primaryKey: new Uint8Array(0),
162
+ beforePayload: null,
163
+ afterPayload,
164
+ });
165
+ const record = {
166
+ groupName: group,
167
+ consumerId: options.workerId || 'memory-worker',
168
+ messageId: BigInt(Date.now()),
169
+ topic: event.topic,
170
+ event: mutationEvent,
171
+ payload,
172
+ };
173
+ if (autoAck) {
174
+ try {
175
+ await handler(record, ctx);
176
+ await ctx.ack();
177
+ }
178
+ catch (err) {
179
+ await ctx.nack();
180
+ throw err;
181
+ }
182
+ }
183
+ else {
184
+ await handler(record, ctx);
185
+ }
186
+ });
187
+ }
188
+ async on(eventName, optionsOrHandler, maybeHandler) {
189
+ return await this.subscribe(eventName, optionsOrHandler, maybeHandler);
190
+ }
191
+ async deliver(sub, event, attempt) {
192
+ let resolved = false;
193
+ const currentTopic = event.topic || event.name || '';
194
+ const ctx = {
195
+ topic: currentTopic,
196
+ attempt,
197
+ group: sub.options.group,
198
+ ack: async () => {
199
+ resolved = true;
200
+ },
201
+ nack: async (optionsOrRequeue = true) => {
202
+ resolved = true;
203
+ const requeue = typeof optionsOrRequeue === 'object'
204
+ ? (optionsOrRequeue.requeue !== false)
205
+ : Boolean(optionsOrRequeue);
206
+ if (!requeue)
207
+ return;
208
+ const retryPolicy = sub.options.retry || { maxAttempts: 3, backoffMs: 50 };
209
+ const maxAttempts = retryPolicy.maxAttempts ?? 3;
210
+ if (attempt < maxAttempts) {
211
+ const delay = retryPolicy.exponential
212
+ ? (retryPolicy.backoffMs ?? 50) * Math.pow(2, attempt - 1)
213
+ : (retryPolicy.backoffMs ?? 50);
214
+ setTimeout(() => {
215
+ void this.deliver(sub, event, attempt + 1);
216
+ }, delay);
217
+ }
218
+ else if (sub.options.dlq) {
219
+ // Route dead letters to DLQ topic
220
+ const dlqEvent = {
221
+ ...event,
222
+ id: `dlq_${event.id}`,
223
+ topic: sub.options.dlq,
224
+ name: sub.options.dlq,
225
+ headers: {
226
+ ...(event.headers || {}),
227
+ 'x-original-topic': currentTopic,
228
+ 'x-dead-letter-reason': 'Exceeded max retry attempts',
229
+ 'x-failed-group': sub.options.group || 'anonymous',
230
+ },
231
+ };
232
+ void this.publish(dlqEvent);
233
+ }
234
+ },
235
+ };
236
+ try {
237
+ await sub.handler(event, ctx);
238
+ // Auto-ack if enabled
239
+ if (!resolved && sub.options.autoAck) {
240
+ await ctx.ack();
241
+ }
242
+ }
243
+ catch (err) {
244
+ if (!resolved) {
245
+ await ctx.nack({ requeue: true });
246
+ }
247
+ }
248
+ }
249
+ async disconnect() {
250
+ this.subscriptions = [];
251
+ this.groupPointers.clear();
252
+ this.connected = false;
253
+ }
254
+ clear() {
255
+ this.subscriptions = [];
256
+ this.groupPointers.clear();
257
+ }
258
+ }
259
+ exports.MemoryDriver = MemoryDriver;
260
+ exports.MemoryEventDriver = MemoryDriver;
261
+ //# sourceMappingURL=memory.driver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.driver.js","sourceRoot":"","sources":["../../src/drivers/memory.driver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import { type MutationEvent } from './types.js';
2
+ /**
3
+ * Pure TypeScript runtime-agnostic Bincode 1.x (Little-Endian) binary reader.
4
+ * Built on standard Web API Uint8Array, DataView, and TextDecoder.
5
+ */
6
+ export declare class BincodeReader {
7
+ private buf;
8
+ private offset;
9
+ private view;
10
+ private textDecoder;
11
+ constructor(buf: Uint8Array, offset?: number);
12
+ get currentOffset(): number;
13
+ hasRemaining(): boolean;
14
+ readU8(): number;
15
+ readU32(): number;
16
+ readU64(): bigint;
17
+ readU128(): bigint;
18
+ readBool(): boolean;
19
+ readString(): string;
20
+ readBytes(): Uint8Array;
21
+ readOptionBytes(): Uint8Array | null;
22
+ readMutationEvent(): MutationEvent;
23
+ private assertAvailable;
24
+ }
25
+ //# sourceMappingURL=bincode-reader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bincode-reader.d.ts","sourceRoot":"","sources":["../../../src/drivers/pulse/bincode-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,aAAa,EAAuB,MAAM,YAAY,CAAC;AAEjF;;;GAGG;AACH,qBAAa,aAAa;IAKtB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,WAAW,CAAqB;gBAG9B,GAAG,EAAE,UAAU,EACf,MAAM,GAAE,MAAU;IAK5B,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,YAAY,IAAI,OAAO;IAIvB,MAAM,IAAI,MAAM;IAOhB,OAAO,IAAI,MAAM;IAOjB,OAAO,IAAI,MAAM;IAOjB,QAAQ,IAAI,MAAM;IAQlB,QAAQ,IAAI,OAAO;IAOnB,UAAU,IAAI,MAAM;IAQpB,SAAS,IAAI,UAAU;IAQvB,eAAe,IAAI,UAAU,GAAG,IAAI;IAQpC,iBAAiB,IAAI,aAAa;IAkBlC,OAAO,CAAC,eAAe;CAOxB"}
@@ -0,0 +1,100 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BincodeReader = void 0;
4
+ const types_js_1 = require("./types.js");
5
+ /**
6
+ * Pure TypeScript runtime-agnostic Bincode 1.x (Little-Endian) binary reader.
7
+ * Built on standard Web API Uint8Array, DataView, and TextDecoder.
8
+ */
9
+ class BincodeReader {
10
+ buf;
11
+ offset;
12
+ view;
13
+ textDecoder = new TextDecoder();
14
+ constructor(buf, offset = 0) {
15
+ this.buf = buf;
16
+ this.offset = offset;
17
+ this.view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
18
+ }
19
+ get currentOffset() {
20
+ return this.offset;
21
+ }
22
+ hasRemaining() {
23
+ return this.offset < this.buf.byteLength;
24
+ }
25
+ readU8() {
26
+ this.assertAvailable(1);
27
+ const val = this.buf[this.offset];
28
+ this.offset += 1;
29
+ return val;
30
+ }
31
+ readU32() {
32
+ this.assertAvailable(4);
33
+ const val = this.view.getUint32(this.offset, true);
34
+ this.offset += 4;
35
+ return val;
36
+ }
37
+ readU64() {
38
+ this.assertAvailable(8);
39
+ const val = this.view.getBigUint64(this.offset, true);
40
+ this.offset += 8;
41
+ return val;
42
+ }
43
+ readU128() {
44
+ this.assertAvailable(16);
45
+ const low = this.view.getBigUint64(this.offset, true);
46
+ const high = this.view.getBigUint64(this.offset + 8, true);
47
+ this.offset += 16;
48
+ return low | (high << 64n);
49
+ }
50
+ readBool() {
51
+ this.assertAvailable(1);
52
+ const val = this.buf[this.offset] !== 0;
53
+ this.offset += 1;
54
+ return val;
55
+ }
56
+ readString() {
57
+ const len = Number(this.readU64());
58
+ this.assertAvailable(len);
59
+ const slice = this.buf.subarray(this.offset, this.offset + len);
60
+ this.offset += len;
61
+ return this.textDecoder.decode(slice);
62
+ }
63
+ readBytes() {
64
+ const len = Number(this.readU64());
65
+ this.assertAvailable(len);
66
+ const slice = this.buf.subarray(this.offset, this.offset + len);
67
+ this.offset += len;
68
+ return slice;
69
+ }
70
+ readOptionBytes() {
71
+ const isSome = this.readU8();
72
+ if (isSome === 1) {
73
+ return this.readBytes();
74
+ }
75
+ return null;
76
+ }
77
+ readMutationEvent() {
78
+ const hlc = this.readU128();
79
+ const tableName = this.readString();
80
+ const op = this.readU32();
81
+ const primaryKey = this.readBytes();
82
+ const beforePayload = this.readOptionBytes();
83
+ const afterPayload = this.readOptionBytes();
84
+ return (0, types_js_1.createMutationEvent)({
85
+ hlc,
86
+ tableName,
87
+ op,
88
+ primaryKey,
89
+ beforePayload,
90
+ afterPayload,
91
+ });
92
+ }
93
+ assertAvailable(bytes) {
94
+ if (this.offset + bytes > this.buf.byteLength) {
95
+ throw new Error(`BincodeReader: Unexpected EOF. Attempted to read ${bytes} bytes at offset ${this.offset}, total length ${this.buf.byteLength}.`);
96
+ }
97
+ }
98
+ }
99
+ exports.BincodeReader = BincodeReader;
100
+ //# sourceMappingURL=bincode-reader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bincode-reader.js","sourceRoot":"","sources":["../../../src/drivers/pulse/bincode-reader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Pure TypeScript runtime-agnostic Bincode 1.x (Little-Endian) binary writer.
3
+ * Built on standard Web API Uint8Array, DataView, and TextEncoder.
4
+ */
5
+ export declare class BincodeWriter {
6
+ private chunks;
7
+ private totalLength;
8
+ private textEncoder;
9
+ writeU8(val: number): void;
10
+ writeU32(val: number): void;
11
+ writeU64(val: number | bigint): void;
12
+ writeU128(val: bigint): void;
13
+ writeBool(val: boolean): void;
14
+ writeString(str: string): void;
15
+ writeBytes(bytes: Uint8Array): void;
16
+ writeOptionBytes(bytes: Uint8Array | null | undefined): void;
17
+ private append;
18
+ toUint8Array(): Uint8Array;
19
+ /**
20
+ * Returns a complete Pulse frame prefixed by 4 bytes u32 Little-Endian payload length.
21
+ * [4 bytes u32 LE payload_length][bincode payload]
22
+ */
23
+ toFrame(): Uint8Array;
24
+ }
25
+ //# sourceMappingURL=bincode-writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bincode-writer.d.ts","sourceRoot":"","sources":["../../../src/drivers/pulse/bincode-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAqB;IAExC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM1B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO3B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOpC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAU5B,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAI7B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM9B,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKnC,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAS5D,OAAO,CAAC,MAAM;IAKd,YAAY,IAAI,UAAU;IAU1B;;;OAGG;IACH,OAAO,IAAI,UAAU;CAQtB"}
@@ -0,0 +1,86 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BincodeWriter = void 0;
4
+ /**
5
+ * Pure TypeScript runtime-agnostic Bincode 1.x (Little-Endian) binary writer.
6
+ * Built on standard Web API Uint8Array, DataView, and TextEncoder.
7
+ */
8
+ class BincodeWriter {
9
+ chunks = [];
10
+ totalLength = 0;
11
+ textEncoder = new TextEncoder();
12
+ writeU8(val) {
13
+ const buf = new Uint8Array(1);
14
+ buf[0] = val & 0xff;
15
+ this.append(buf);
16
+ }
17
+ writeU32(val) {
18
+ const buf = new Uint8Array(4);
19
+ const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
20
+ view.setUint32(0, val >>> 0, true);
21
+ this.append(buf);
22
+ }
23
+ writeU64(val) {
24
+ const buf = new Uint8Array(8);
25
+ const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
26
+ view.setBigUint64(0, BigInt(val), true);
27
+ this.append(buf);
28
+ }
29
+ writeU128(val) {
30
+ const buf = new Uint8Array(16);
31
+ const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
32
+ const low = val & 0xffffffffffffffffn;
33
+ const high = (val >> 64n) & 0xffffffffffffffffn;
34
+ view.setBigUint64(0, low, true);
35
+ view.setBigUint64(8, high, true);
36
+ this.append(buf);
37
+ }
38
+ writeBool(val) {
39
+ this.writeU8(val ? 1 : 0);
40
+ }
41
+ writeString(str) {
42
+ const encoded = this.textEncoder.encode(str);
43
+ this.writeU64(encoded.byteLength);
44
+ this.append(encoded);
45
+ }
46
+ writeBytes(bytes) {
47
+ this.writeU64(bytes.byteLength);
48
+ this.append(bytes);
49
+ }
50
+ writeOptionBytes(bytes) {
51
+ if (bytes == null) {
52
+ this.writeU8(0x00);
53
+ }
54
+ else {
55
+ this.writeU8(0x01);
56
+ this.writeBytes(bytes);
57
+ }
58
+ }
59
+ append(chunk) {
60
+ this.chunks.push(chunk);
61
+ this.totalLength += chunk.byteLength;
62
+ }
63
+ toUint8Array() {
64
+ const out = new Uint8Array(this.totalLength);
65
+ let offset = 0;
66
+ for (const chunk of this.chunks) {
67
+ out.set(chunk, offset);
68
+ offset += chunk.byteLength;
69
+ }
70
+ return out;
71
+ }
72
+ /**
73
+ * Returns a complete Pulse frame prefixed by 4 bytes u32 Little-Endian payload length.
74
+ * [4 bytes u32 LE payload_length][bincode payload]
75
+ */
76
+ toFrame() {
77
+ const payload = this.toUint8Array();
78
+ const frame = new Uint8Array(4 + payload.byteLength);
79
+ const view = new DataView(frame.buffer, frame.byteOffset, frame.byteLength);
80
+ view.setUint32(0, payload.byteLength, true);
81
+ frame.set(payload, 4);
82
+ return frame;
83
+ }
84
+ }
85
+ exports.BincodeWriter = BincodeWriter;
86
+ //# sourceMappingURL=bincode-writer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bincode-writer.js","sourceRoot":"","sources":["../../../src/drivers/pulse/bincode-writer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ export * from './types.js';
2
+ export * from './bincode-writer.js';
3
+ export * from './bincode-reader.js';
4
+ export * from './protocol.js';
5
+ export * from './stream-parser.js';
6
+ export * from './socket-transport.js';
7
+ export * from './pulse.driver.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/drivers/pulse/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
@@ -0,0 +1,24 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./types.js"), exports);
18
+ __exportStar(require("./bincode-writer.js"), exports);
19
+ __exportStar(require("./bincode-reader.js"), exports);
20
+ __exportStar(require("./protocol.js"), exports);
21
+ __exportStar(require("./stream-parser.js"), exports);
22
+ __exportStar(require("./socket-transport.js"), exports);
23
+ __exportStar(require("./pulse.driver.js"), exports);
24
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/pulse/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,sDAAoC;AACpC,sDAAoC;AACpC,gDAA8B;AAC9B,qDAAmC;AACnC,wDAAsC;AACtC,oDAAkC"}
@@ -0,0 +1,26 @@
1
+ import type { ServerFrame } from './types.js';
2
+ /**
3
+ * Encodes OpCode 0x00: Subscribe(pattern: String)
4
+ */
5
+ export declare function encodeSubscribe(pattern: string): Uint8Array;
6
+ /**
7
+ * Encodes OpCode 0x01: JoinGroup(group_name: String, consumer_id: String, pattern: String)
8
+ */
9
+ export declare function encodeJoinGroup(groupName: string, consumerId: string, pattern: string): Uint8Array;
10
+ /**
11
+ * Encodes OpCode 0x02: Ack(group_name: String, message_id: u128)
12
+ */
13
+ export declare function encodeAck(groupName: string, messageId: bigint): Uint8Array;
14
+ /**
15
+ * Encodes OpCode 0x03: Nack(group_name: String, message_id: u128)
16
+ */
17
+ export declare function encodeNack(groupName: string, messageId: bigint): Uint8Array;
18
+ /**
19
+ * Encodes OpCode 0x04: SeekHlc(hlc: u128)
20
+ */
21
+ export declare function encodeSeekHlc(hlc: bigint): Uint8Array;
22
+ /**
23
+ * Decodes a Bincode 1.x serialized ServerFrame payload into a structured ServerFrame object.
24
+ */
25
+ export declare function decodeServerFrame(payload: Uint8Array): ServerFrame;
26
+ //# sourceMappingURL=protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/drivers/pulse/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAK3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAOlG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAM1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAM3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAKrD;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,CA4BlE"}