@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
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Argos-JS Team
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,157 @@
1
- # Temporary Holding Version
1
+ # @argos-js/events
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ High-performance, runtime-agnostic event-driven messaging suite for **Argos-JS**, featuring first-class support for native CDC engine **ArgosDB Pulse** (port 8788, binary Bincode 1.x Little-Endian framing) and interchangeable broker drivers.
4
+
5
+ ---
6
+
7
+ ## Features
8
+
9
+ - **Runtime-Agnostic Binary Serialization:** 100% pure TypeScript Bincode 1.x Little-Endian encoder/decoder built on standard Web APIs (`Uint8Array`, `DataView`, `TextEncoder`, `TextDecoder`), with zero native C/C++ dependencies. Fully portable across Node.js 18+, Bun, and Deno.
10
+ - **Pluggable Event Drivers:**
11
+ - `pulse`: Native CDC/WAL stream consumer for ArgosDB Pulse (`argosdb-pulse`, port 8788).
12
+ - `memory`: High-performance, zero-dependency in-memory pub/sub broker for unit testing and CI.
13
+ - `rabbitmq`: Enterprise AMQP topic exchanges with competing consumer queues.
14
+ - `redis`: Redis Streams consumer groups and Pub/Sub.
15
+ - `kafka`: Apache Kafka cluster consumer groups and partitioned topics.
16
+ - **ArgosDB Pulse Protocol:**
17
+ - Sub-millisecond binary TCP framing (`[4-byte LE payload length][bincode payload]`).
18
+ - Native client OpCodes: `Subscribe` (0x00), `JoinGroup` (0x01), `Ack` (0x02), `Nack` (0x03), `SeekHlc` (0x04).
19
+ - High-resilience `PulseStreamParser` with cumulative buffer for seamless TCP packet chunking and backpressure handling.
20
+ - Automatic reconnection with exponential backoff and transparent consumer group re-registration.
21
+ - **Consumer Groups & CDC Records:** Competing consumers with automatic or manual `ctx.ack()` and `ctx.nack()`, plus `event.jsonPayload<T>()` helper.
22
+ - **Transactional Outbox Pattern:** Atomic domain event emission within database transactions, guaranteed at-least-once delivery with background polling relay.
23
+
24
+ ---
25
+
26
+ ## Installation
27
+
28
+ ```bash
29
+ pnpm add @argos-js/events
30
+ ```
31
+
32
+ ---
33
+
34
+ ## Configuration & Drivers
35
+
36
+ Configure the active driver via code or environment variables:
37
+
38
+ ```bash
39
+ # Select active driver: pulse | memory | rabbitmq | redis | kafka
40
+ EVENTS_DRIVER=pulse
41
+
42
+ # ArgosDB Pulse CDC connection
43
+ ARGOS_PULSE_HOST=127.0.0.1
44
+ ARGOS_PULSE_PORT=8788
45
+ ```
46
+
47
+ ### Initializing the Events Manager
48
+
49
+ ```typescript
50
+ import { createEventsManager } from '@argos-js/events';
51
+
52
+ export const events = createEventsManager({
53
+ driver: (process.env.EVENTS_DRIVER as any) || 'pulse',
54
+ pulse: {
55
+ host: process.env.ARGOS_PULSE_HOST || '127.0.0.1',
56
+ port: Number(process.env.ARGOS_PULSE_PORT) || 8788,
57
+ autoAck: false, // Manual acknowledgement via ctx.ack() / ctx.nack()
58
+ },
59
+ outbox: {
60
+ enabled: true,
61
+ tableName: 'events_outbox',
62
+ pollIntervalMs: 1000,
63
+ },
64
+ });
65
+ ```
66
+
67
+ ---
68
+
69
+ ## Usage: Consumer Groups (CDC Mutations)
70
+
71
+ ArgosDB Pulse automatically publishes mutation events from write-ahead logs (`INSERT`, `UPDATE`, `DELETE`) on channels such as `cdc.auth_users.*`.
72
+
73
+ ```typescript
74
+ import { events, MutationOp } from '@argos-js/events';
75
+
76
+ await events.connect();
77
+
78
+ // Join consumer group 'email_workers'
79
+ await events.subscribeGroup({
80
+ group: 'email_workers',
81
+ workerId: `worker-${process.pid}`,
82
+ pattern: 'cdc.auth_users.*',
83
+ handler: async (record, ctx) => {
84
+ // Check mutation operation
85
+ if (record.event.op === MutationOp.Insert) {
86
+ // Decode JSON from afterPayload
87
+ const user = record.event.jsonPayload<{ id: string; name: string; email: string }>();
88
+ if (user?.email) {
89
+ console.log(`[EmailWorker] ✉️ Sending welcome email to: ${user.name} <${user.email}>`);
90
+ await sendWelcomeEmail(user);
91
+ }
92
+ }
93
+
94
+ // Acknowledge processing
95
+ await ctx.ack();
96
+ },
97
+ });
98
+ ```
99
+
100
+ ---
101
+
102
+ ## Binary Protocol Specification (ArgosDB Pulse)
103
+
104
+ ### Frame Layout
105
+
106
+ ```text
107
+ 0 1 2 3
108
+ 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
109
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
110
+ | Payload Length (4 bytes, Little-Endian) |
111
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
112
+ | Bincode 1.x Serialized Payload (Little-Endian) |
113
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
114
+ ```
115
+
116
+ ### Supported OpCodes (Client -> Server)
117
+
118
+ | Tag (u32 LE) | Variant | Fields |
119
+ | :--- | :--- | :--- |
120
+ | `0x00` | `Subscribe` | `pattern: String` |
121
+ | `0x01` | `JoinGroup` | `group_name: String, consumer_id: String, pattern: String` |
122
+ | `0x02` | `Ack` | `group_name: String, message_id: u128` |
123
+ | `0x03` | `Nack` | `group_name: String, message_id: u128` |
124
+ | `0x04` | `SeekHlc` | `hlc: u128` |
125
+
126
+ ### Server Frames (Server -> Client)
127
+
128
+ | Tag (u32 LE) | Variant | Structure |
129
+ | :--- | :--- | :--- |
130
+ | `0` | `Subscribed` | `pattern: String` |
131
+ | `1` | `JoinedGroup` | `group_name: String, consumer_id: String` |
132
+ | `2` | `Record` | `topic: String, event: MutationEvent` |
133
+ | `3` | `GroupRecord` | `group_name: String, consumer_id: String, message_id: u128, topic: String, event: MutationEvent` |
134
+ | `4` | `AckResult` | `ok: bool, message_id: u128` |
135
+ | `5` | `NackResult` | `ok: bool, message_id: u128` |
136
+ | `6` | `Error` | `message: String` |
137
+
138
+ ---
139
+
140
+ ## Transactional Outbox Pattern
141
+
142
+ Emit events safely within ACID database transactions:
143
+
144
+ ```typescript
145
+ await db.transaction(async (trx) => {
146
+ const user = await trx.from('users').insert({ name: 'Alice' }).returning('*');
147
+
148
+ // Automatically writes to events_outbox in the same transaction
149
+ await trx.events.emit('user.created', { id: user.id, name: user.name });
150
+ });
151
+ ```
152
+
153
+ ---
154
+
155
+ ## License
156
+
157
+ MIT © Argos-JS Team
@@ -0,0 +1,3 @@
1
+ import type { EventsConfig } from '../types/driver.types.js';
2
+ export declare function defineEventsConfig(config?: Partial<EventsConfig>): EventsConfig;
3
+ //# sourceMappingURL=define-events-config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-events-config.d.ts","sourceRoot":"","sources":["../../src/config/define-events-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAcnF"}
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.defineEventsConfig = defineEventsConfig;
4
+ function defineEventsConfig(config = {}) {
5
+ return {
6
+ defaultDriver: config.defaultDriver || 'memory',
7
+ drivers: {
8
+ memory: {},
9
+ ...config.drivers,
10
+ },
11
+ outbox: {
12
+ enabled: false,
13
+ tableName: 'events_outbox',
14
+ pollIntervalMs: 1000,
15
+ ...config.outbox,
16
+ },
17
+ };
18
+ }
19
+ //# sourceMappingURL=define-events-config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-events-config.js","sourceRoot":"","sources":["../../src/config/define-events-config.ts"],"names":[],"mappings":";;AAEA,gDAcC;AAdD,SAAgB,kBAAkB,CAAC,SAAgC,EAAE;IACnE,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,QAAQ;QAC/C,OAAO,EAAE;YACP,MAAM,EAAE,EAAE;YACV,GAAG,MAAM,CAAC,OAAO;SAClB;QACD,MAAM,EAAE;YACN,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,eAAe;YAC1B,cAAc,EAAE,IAAI;YACpB,GAAG,MAAM,CAAC,MAAM;SACjB;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,49 @@
1
+ import type { EventHandler, EventMessage, SubscribeOptions, Subscription } from '../types/event.types.js';
2
+ import type { ConsumerGroupOptions, GroupEventHandler } from './pulse/types.js';
3
+ /**
4
+ * Standard interface that all Argos event broker drivers must satisfy.
5
+ */
6
+ export interface EventDriver {
7
+ /**
8
+ * Driver identifier (e.g. 'pulse', 'memory', 'redis', 'rabbitmq', 'kafka').
9
+ */
10
+ readonly name: string;
11
+ /**
12
+ * Initializes connections, client pools, or event loops with the broker.
13
+ */
14
+ connect(): Promise<void>;
15
+ /**
16
+ * Publishes a single event message to the target topic or exchange.
17
+ * Optional as CDC/WAL engines (like ArgosDB Pulse) generate events from database mutations.
18
+ */
19
+ publish?(event: EventMessage): Promise<void>;
20
+ /**
21
+ * Alias for publish providing EventEmitter naming parity.
22
+ */
23
+ emit?(event: EventMessage): Promise<void>;
24
+ /**
25
+ * Publishes multiple event messages atomically or in a batch where supported.
26
+ */
27
+ publishBatch?(events: EventMessage[]): Promise<void>;
28
+ /**
29
+ * Registers a subscriber for a topic pattern, optionally joining a consumer group.
30
+ */
31
+ subscribe(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
32
+ /**
33
+ * Alias for subscribe providing EventEmitter naming parity and simplified handler overload.
34
+ */
35
+ on?(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
36
+ /**
37
+ * Registers a subscriber on a Consumer Group for load-balanced processing and message acknowledgements.
38
+ */
39
+ subscribeGroup?(options: ConsumerGroupOptions, handler: GroupEventHandler): Promise<Subscription>;
40
+ /**
41
+ * Gracefully drains inflight consumers, disconnects sockets, and closes connections.
42
+ */
43
+ disconnect(): Promise<void>;
44
+ /**
45
+ * Returns whether the driver is currently connected and operational.
46
+ */
47
+ isConnected?(): boolean;
48
+ }
49
+ //# sourceMappingURL=driver.interface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.interface.d.ts","sourceRoot":"","sources":["../../src/drivers/driver.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;OAEG;IACH,EAAE,CAAC,CACD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,CACb,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC;CACzB"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=driver.interface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.interface.js","sourceRoot":"","sources":["../../src/drivers/driver.interface.ts"],"names":[],"mappings":""}
@@ -0,0 +1,27 @@
1
+ import type { EventDriver } from './driver.interface.js';
2
+ import type { EventHandler, EventMessage, SubscribeOptions, Subscription } from '../types/event.types.js';
3
+ import type { KafkaDriverConfig } from '../types/driver.types.js';
4
+ /**
5
+ * Enterprise Apache Kafka event driver.
6
+ * High-throughput, distributed partitioned log with consumer groups and offset management.
7
+ */
8
+ export declare class KafkaDriver implements EventDriver {
9
+ readonly name = "kafka";
10
+ private config;
11
+ private kafka;
12
+ private producer;
13
+ private consumers;
14
+ private connected;
15
+ constructor(config: KafkaDriverConfig);
16
+ private loadKafkaPackage;
17
+ connect(): Promise<void>;
18
+ isConnected(): boolean;
19
+ emit(event: EventMessage): Promise<void>;
20
+ publish(event: EventMessage): Promise<void>;
21
+ publishBatch(events: EventMessage[]): Promise<void>;
22
+ on(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
23
+ subscribe(eventName: string, options: SubscribeOptions, handler: EventHandler): Promise<Subscription>;
24
+ disconnect(): Promise<void>;
25
+ }
26
+ export { KafkaDriver as KafkaEventDriver };
27
+ //# sourceMappingURL=kafka.driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kafka.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/kafka.driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;GAGG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,SAAgB,IAAI,WAAW;IAC/B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,iBAAiB;IAIrC,OAAO,CAAC,gBAAgB;IAeX,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,WAAW,IAAI,OAAO;IAIhB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3C,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BnD,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC;IAOX,SAAS,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,CAAC;IA4FX,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAqBzC;AAED,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,CAAC"}
@@ -0,0 +1,214 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.KafkaEventDriver = exports.KafkaDriver = void 0;
4
+ const node_crypto_1 = require("node:crypto");
5
+ /**
6
+ * Enterprise Apache Kafka event driver.
7
+ * High-throughput, distributed partitioned log with consumer groups and offset management.
8
+ */
9
+ class KafkaDriver {
10
+ name = 'kafka';
11
+ config;
12
+ kafka = null;
13
+ producer = null;
14
+ consumers = new Map();
15
+ connected = false;
16
+ constructor(config) {
17
+ this.config = config;
18
+ }
19
+ loadKafkaPackage() {
20
+ try {
21
+ // Dynamic require avoids bundling kafkajs into core
22
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
23
+ const { Kafka } = require('kafkajs');
24
+ return Kafka;
25
+ }
26
+ catch {
27
+ throw new Error('[Argos Events] The "kafkajs" package is required to use the Kafka event driver.\n' +
28
+ 'Please install it in your project via:\n' +
29
+ ' pnpm add kafkajs');
30
+ }
31
+ }
32
+ async connect() {
33
+ if (this.connected)
34
+ return;
35
+ const KafkaClass = this.loadKafkaPackage();
36
+ this.kafka = new KafkaClass({
37
+ clientId: this.config.clientId || 'argos-events',
38
+ brokers: this.config.brokers,
39
+ ssl: this.config.ssl,
40
+ sasl: this.config.sasl,
41
+ connectionTimeout: this.config.connectionTimeout,
42
+ requestTimeout: this.config.requestTimeout,
43
+ retry: this.config.retry,
44
+ });
45
+ this.producer = this.kafka.producer();
46
+ await this.producer.connect();
47
+ this.connected = true;
48
+ }
49
+ isConnected() {
50
+ return this.connected;
51
+ }
52
+ async emit(event) {
53
+ return await this.publish(event);
54
+ }
55
+ async publish(event) {
56
+ if (!this.connected) {
57
+ await this.connect();
58
+ }
59
+ const topicName = event.topic || event.name || '';
60
+ const headers = {
61
+ 'x-event-id': event.id,
62
+ 'x-event-timestamp': String(event.timestamp || Date.now()),
63
+ ...(event.headers || {}),
64
+ };
65
+ await this.producer.send({
66
+ topic: topicName,
67
+ messages: [
68
+ {
69
+ key: event.key,
70
+ value: JSON.stringify(event.payload),
71
+ headers,
72
+ },
73
+ ],
74
+ });
75
+ }
76
+ async publishBatch(events) {
77
+ if (!this.connected) {
78
+ await this.connect();
79
+ }
80
+ const topicGroups = new Map();
81
+ for (const event of events) {
82
+ const topicName = event.topic || event.name || '';
83
+ const list = topicGroups.get(topicName) || [];
84
+ list.push({
85
+ key: event.key,
86
+ value: JSON.stringify(event.payload),
87
+ headers: {
88
+ 'x-event-id': event.id,
89
+ 'x-event-timestamp': String(event.timestamp || Date.now()),
90
+ ...(event.headers || {}),
91
+ },
92
+ });
93
+ topicGroups.set(topicName, list);
94
+ }
95
+ const topicMessages = Array.from(topicGroups.entries()).map(([topic, messages]) => ({
96
+ topic,
97
+ messages,
98
+ }));
99
+ await this.producer.sendBatch({ topicMessages });
100
+ }
101
+ async on(eventName, optionsOrHandler, maybeHandler) {
102
+ if (typeof optionsOrHandler === 'function') {
103
+ return await this.subscribe(eventName, {}, optionsOrHandler);
104
+ }
105
+ return await this.subscribe(eventName, optionsOrHandler, maybeHandler);
106
+ }
107
+ async subscribe(eventName, options, handler) {
108
+ if (!this.connected) {
109
+ await this.connect();
110
+ }
111
+ const subId = `kafka_sub_${(0, node_crypto_1.randomUUID)()}`;
112
+ const groupId = options.group || `argos-group-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
113
+ const consumer = this.kafka.consumer({ groupId });
114
+ await consumer.connect();
115
+ await consumer.subscribe({ topic: eventName, fromBeginning: false });
116
+ await consumer.run({
117
+ autoCommit: false,
118
+ eachMessage: async ({ topic, partition, message }) => {
119
+ let payload;
120
+ try {
121
+ payload = JSON.parse(message.value.toString());
122
+ }
123
+ catch {
124
+ payload = message.value?.toString();
125
+ }
126
+ const headers = {};
127
+ if (message.headers) {
128
+ for (const [k, v] of Object.entries(message.headers)) {
129
+ headers[k] = v ? v.toString() : '';
130
+ }
131
+ }
132
+ const event = {
133
+ id: headers['x-event-id'] || (0, node_crypto_1.randomUUID)(),
134
+ topic,
135
+ name: topic,
136
+ payload,
137
+ headers,
138
+ key: message.key ? message.key.toString() : undefined,
139
+ timestamp: Number(headers['x-event-timestamp']) || Number(message.timestamp) || Date.now(),
140
+ };
141
+ if (options.filter && !options.filter(event)) {
142
+ return;
143
+ }
144
+ let acked = false;
145
+ const ctx = {
146
+ topic,
147
+ partition,
148
+ offset: message.offset,
149
+ group: groupId,
150
+ attempt: 1,
151
+ ack: async () => {
152
+ acked = true;
153
+ await consumer.commitOffsets([
154
+ {
155
+ topic,
156
+ partition,
157
+ offset: (BigInt(message.offset) + 1n).toString(),
158
+ },
159
+ ]);
160
+ },
161
+ nack: async (_optionsOrRequeue = true) => {
162
+ // Kafka offsets not committed, will re-read on partition rebalance or restart
163
+ },
164
+ };
165
+ try {
166
+ await handler(event, ctx);
167
+ if (!acked && options.autoAck !== false) {
168
+ await ctx.ack();
169
+ }
170
+ }
171
+ catch {
172
+ // Offsets left uncommitted
173
+ }
174
+ },
175
+ });
176
+ this.consumers.set(subId, consumer);
177
+ return {
178
+ id: subId,
179
+ topic: eventName,
180
+ group: options.group,
181
+ unsubscribe: async () => {
182
+ const c = this.consumers.get(subId);
183
+ if (c) {
184
+ await c.disconnect();
185
+ this.consumers.delete(subId);
186
+ }
187
+ },
188
+ };
189
+ }
190
+ async disconnect() {
191
+ this.connected = false;
192
+ for (const [, consumer] of this.consumers) {
193
+ try {
194
+ await consumer.disconnect();
195
+ }
196
+ catch {
197
+ // ignore
198
+ }
199
+ }
200
+ this.consumers.clear();
201
+ if (this.producer) {
202
+ try {
203
+ await this.producer.disconnect();
204
+ }
205
+ catch {
206
+ // ignore
207
+ }
208
+ this.producer = null;
209
+ }
210
+ }
211
+ }
212
+ exports.KafkaDriver = KafkaDriver;
213
+ exports.KafkaEventDriver = KafkaDriver;
214
+ //# sourceMappingURL=kafka.driver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kafka.driver.js","sourceRoot":"","sources":["../../src/drivers/kafka.driver.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAWzC;;;GAGG;AACH,MAAa,WAAW;IACN,IAAI,GAAG,OAAO,CAAC;IACvB,MAAM,CAAoB;IAC1B,KAAK,GAAQ,IAAI,CAAC;IAClB,QAAQ,GAAQ,IAAI,CAAC;IACrB,SAAS,GAAqB,IAAI,GAAG,EAAE,CAAC;IACxC,SAAS,GAAY,KAAK,CAAC;IAEnC,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC;YACH,oDAAoD;YACpD,iEAAiE;YACjE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,mFAAmF;gBACnF,0CAA0C;gBAC1C,oBAAoB,CACrB,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,cAAc;YAChD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;YACpB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;YAChD,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAE9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,KAAmB;QACnC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,KAAmB;QACtC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAClD,MAAM,OAAO,GAA2B;YACtC,YAAY,EAAE,KAAK,CAAC,EAAE;YACtB,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1D,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;SACzB,CAAC;QAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACvB,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;oBACpC,OAAO;iBACR;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,MAAsB;QAC9C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmF,CAAC;QAE/G,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC;gBACR,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;gBACpC,OAAO,EAAE;oBACP,YAAY,EAAE,KAAK,CAAC,EAAE;oBACtB,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC1D,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;iBACzB;aACF,CAAC,CAAC;YACH,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;YAClF,KAAK;YACL,QAAQ;SACT,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,EAAE,CACb,SAAiB,EACjB,gBAAiD,EACjD,YAA2B;QAE3B,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,gBAAgB,EAAE,YAAa,CAAC,CAAC;IAC1E,CAAC;IAEM,KAAK,CAAC,SAAS,CACpB,SAAiB,EACjB,OAAyB,EACzB,OAAqB;QAErB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,IAAA,wBAAU,GAAE,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,eAAe,IAAA,wBAAU,GAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAElD,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;QAErE,MAAM,QAAQ,CAAC,GAAG,CAAC;YACjB,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAO,EAAE,EAAE;gBACxD,IAAI,OAAY,CAAC;gBACjB,IAAI,CAAC;oBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;gBACtC,CAAC;gBAED,MAAM,OAAO,GAA2B,EAAE,CAAC;gBAC3C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;wBACrD,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrC,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,GAAiB;oBAC1B,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,IAAA,wBAAU,GAAE;oBACzC,KAAK;oBACL,IAAI,EAAE,KAAK;oBACX,OAAO;oBACP,OAAO;oBACP,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;oBACrD,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;iBAC3F,CAAC;gBAEF,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7C,OAAO;gBACT,CAAC;gBAED,IAAI,KAAK,GAAG,KAAK,CAAC;gBAClB,MAAM,GAAG,GAAiB;oBACxB,KAAK;oBACL,SAAS;oBACT,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,CAAC;oBACV,GAAG,EAAE,KAAK,IAAI,EAAE;wBACd,KAAK,GAAG,IAAI,CAAC;wBACb,MAAM,QAAQ,CAAC,aAAa,CAAC;4BAC3B;gCACE,KAAK;gCACL,SAAS;gCACT,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;6BACjD;yBACF,CAAC,CAAC;oBACL,CAAC;oBACD,IAAI,EAAE,KAAK,EAAE,oBAAqD,IAAI,EAAE,EAAE;wBACxE,8EAA8E;oBAChF,CAAC;iBACF,CAAC;gBAEF,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC1B,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;wBACxC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;oBAClB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEpC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,KAAK,IAAI,EAAE;gBACtB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACpC,IAAI,CAAC,EAAE,CAAC;oBACN,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;oBACrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,KAAK,MAAM,CAAC,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAEvB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AA7OD,kCA6OC;AAEuB,uCAAgB"}
@@ -0,0 +1,37 @@
1
+ import type { EventDriver } from './driver.interface.js';
2
+ import type { EventHandler, EventMessage, SubscribeOptions, Subscription } from '../types/event.types.js';
3
+ import type { MemoryDriverConfig } from '../types/driver.types.js';
4
+ import { type ConsumerGroupOptions, type GroupEventHandler } from './pulse/types.js';
5
+ /**
6
+ * Matches AMQP / MQTT-style topic patterns with single-word (*) and multi-word (#) wildcards.
7
+ *
8
+ * Example:
9
+ * - 'order.*' matches 'order.created' and 'order.updated', but not 'order.item.created'
10
+ * - 'order.#' matches 'order.created' and 'order.item.created'
11
+ * - '*' or '#' matches everything
12
+ */
13
+ export declare function matchTopic(pattern: string, topic: string): boolean;
14
+ /**
15
+ * High-performance, in-memory event driver with zero external dependencies.
16
+ * Implements full pub/sub, wildcard topic matching, and simulated consumer group load-balancing.
17
+ */
18
+ export declare class MemoryDriver implements EventDriver {
19
+ readonly name = "memory";
20
+ private subscriptions;
21
+ private groupPointers;
22
+ private connected;
23
+ constructor(_config?: MemoryDriverConfig);
24
+ connect(): Promise<void>;
25
+ isConnected(): boolean;
26
+ emit(event: EventMessage): Promise<void>;
27
+ publish(event: EventMessage): Promise<void>;
28
+ publishBatch(events: EventMessage[]): Promise<void>;
29
+ subscribe(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
30
+ subscribeGroup(options: ConsumerGroupOptions, handler: GroupEventHandler): Promise<Subscription>;
31
+ on(eventName: string, optionsOrHandler: SubscribeOptions | EventHandler, maybeHandler?: EventHandler): Promise<Subscription>;
32
+ private deliver;
33
+ disconnect(): Promise<void>;
34
+ clear(): void;
35
+ }
36
+ export { MemoryDriver as MemoryEventDriver };
37
+ //# sourceMappingURL=memory.driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.driver.d.ts","sourceRoot":"","sources":["../../src/drivers/memory.driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAGvB,MAAM,kBAAkB,CAAC;AAS1B;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CASlE;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,kBAAuB;IAE/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,WAAW,IAAI,OAAO;IAIhB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6D3C,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnD,SAAS,CACpB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC;IA+CX,cAAc,CACzB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC;IA8CX,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GAAG,YAAY,EACjD,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,YAAY,CAAC;YAIV,OAAO;IAkER,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,KAAK,IAAI,IAAI;CAIrB;AAED,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,CAAC"}