@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,22 @@
1
+ import type { OutboxRelayOptions } from './outbox.types.js';
2
+ export declare class OutboxRelay {
3
+ private readonly db;
4
+ private readonly driver;
5
+ private readonly tableName;
6
+ private readonly pollIntervalMs;
7
+ private readonly batchSize;
8
+ private readonly maxAttempts;
9
+ private readonly useSkipLocked;
10
+ private isRunning;
11
+ private pollTimer;
12
+ private isProcessing;
13
+ constructor(options: OutboxRelayOptions);
14
+ start(): void;
15
+ stop(): void;
16
+ dispatchOnce(): Promise<number>;
17
+ private fetchPendingRecords;
18
+ private markPublished;
19
+ private markFailed;
20
+ private executeQuery;
21
+ }
22
+ //# sourceMappingURL=outbox-relay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox-relay.d.ts","sourceRoot":"","sources":["../../src/outbox/outbox-relay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,mBAAmB,CAAC;AAI1E,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,kBAAkB;IAUhC,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,IAAI;IAQN,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;YAiE9B,mBAAmB;YAyCnB,aAAa;YA0Bb,UAAU;YA2BV,YAAY;CAkB3B"}
@@ -0,0 +1,217 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.OutboxRelay = void 0;
4
+ class OutboxRelay {
5
+ db;
6
+ driver;
7
+ tableName;
8
+ pollIntervalMs;
9
+ batchSize;
10
+ maxAttempts;
11
+ useSkipLocked;
12
+ isRunning = false;
13
+ pollTimer = null;
14
+ isProcessing = false;
15
+ constructor(options) {
16
+ this.db = options.db;
17
+ this.driver = options.driver;
18
+ this.tableName = options.tableName || 'events_outbox';
19
+ this.pollIntervalMs = options.pollIntervalMs || 1000;
20
+ this.batchSize = options.batchSize || 50;
21
+ this.maxAttempts = options.maxAttempts || 5;
22
+ this.useSkipLocked = options.useSkipLocked ?? true;
23
+ }
24
+ start() {
25
+ if (this.isRunning)
26
+ return;
27
+ this.isRunning = true;
28
+ this.pollTimer = setInterval(async () => {
29
+ if (this.isProcessing)
30
+ return;
31
+ try {
32
+ await this.dispatchOnce();
33
+ }
34
+ catch (err) {
35
+ // Log or handle unexpected loop error
36
+ }
37
+ }, this.pollIntervalMs);
38
+ // Unref timer so it doesn't keep node process alive in tests if unneeded
39
+ if (this.pollTimer && typeof this.pollTimer.unref === 'function') {
40
+ this.pollTimer.unref();
41
+ }
42
+ }
43
+ stop() {
44
+ this.isRunning = false;
45
+ if (this.pollTimer) {
46
+ clearInterval(this.pollTimer);
47
+ this.pollTimer = null;
48
+ }
49
+ }
50
+ async dispatchOnce() {
51
+ if (this.isProcessing)
52
+ return 0;
53
+ this.isProcessing = true;
54
+ try {
55
+ const records = await this.fetchPendingRecords();
56
+ if (!records || records.length === 0) {
57
+ return 0;
58
+ }
59
+ let dispatchedCount = 0;
60
+ for (const record of records) {
61
+ let payload = record.payload;
62
+ if (typeof payload === 'string') {
63
+ try {
64
+ payload = JSON.parse(payload);
65
+ }
66
+ catch {
67
+ // keep raw string if parsing fails
68
+ }
69
+ }
70
+ let headers;
71
+ if (record.headers) {
72
+ if (typeof record.headers === 'string') {
73
+ try {
74
+ headers = JSON.parse(record.headers);
75
+ }
76
+ catch {
77
+ headers = undefined;
78
+ }
79
+ }
80
+ else {
81
+ headers = record.headers;
82
+ }
83
+ }
84
+ const message = {
85
+ id: record.id,
86
+ topic: record.event_name,
87
+ name: record.event_name,
88
+ payload,
89
+ headers: headers || {},
90
+ key: record.key || undefined,
91
+ timestamp: typeof record.created_at === 'number'
92
+ ? record.created_at
93
+ : new Date(record.created_at).getTime(),
94
+ };
95
+ try {
96
+ if (typeof this.driver.publish !== 'function') {
97
+ throw new Error(`Driver "${this.driver.name}" does not support publishing events.`);
98
+ }
99
+ await this.driver.publish(message);
100
+ await this.markPublished(record.id);
101
+ dispatchedCount++;
102
+ }
103
+ catch (err) {
104
+ await this.markFailed(record.id, record.attempts + 1, err?.message || String(err));
105
+ }
106
+ }
107
+ return dispatchedCount;
108
+ }
109
+ finally {
110
+ this.isProcessing = false;
111
+ }
112
+ }
113
+ async fetchPendingRecords() {
114
+ const driverName = (this.db.driverName || this.db.config?.driver || 'sqlite').toLowerCase();
115
+ const isPostgres = driverName.includes('postgres') || driverName === 'pg';
116
+ const isMysql = driverName.includes('mysql');
117
+ let selectQuery;
118
+ if (isPostgres) {
119
+ const skipLockedClause = this.useSkipLocked ? 'FOR UPDATE SKIP LOCKED' : '';
120
+ selectQuery = `
121
+ SELECT id, event_name, payload, headers, key, status, attempts, created_at, published_at
122
+ FROM ${this.tableName}
123
+ WHERE status = 'pending' AND attempts < ${this.maxAttempts}
124
+ ORDER BY created_at ASC
125
+ LIMIT ${this.batchSize}
126
+ ${skipLockedClause}
127
+ `.trim();
128
+ }
129
+ else if (isMysql) {
130
+ const skipLockedClause = this.useSkipLocked ? 'FOR UPDATE SKIP LOCKED' : '';
131
+ selectQuery = `
132
+ SELECT id, event_name, payload, headers, \`key\`, status, attempts, created_at, published_at
133
+ FROM ${this.tableName}
134
+ WHERE status = 'pending' AND attempts < ${this.maxAttempts}
135
+ ORDER BY created_at ASC
136
+ LIMIT ${this.batchSize}
137
+ ${skipLockedClause}
138
+ `.trim();
139
+ }
140
+ else {
141
+ // SQLite
142
+ selectQuery = `
143
+ SELECT id, event_name, payload, headers, key, status, attempts, created_at, published_at
144
+ FROM ${this.tableName}
145
+ WHERE status = 'pending' AND attempts < ${this.maxAttempts}
146
+ ORDER BY created_at ASC
147
+ LIMIT ${this.batchSize}
148
+ `.trim();
149
+ }
150
+ const res = await this.executeQuery(selectQuery);
151
+ return res;
152
+ }
153
+ async markPublished(id) {
154
+ const driverName = (this.db.driverName || this.db.config?.driver || 'sqlite').toLowerCase();
155
+ const isPostgres = driverName.includes('postgres') || driverName === 'pg';
156
+ let updateQuery;
157
+ let params;
158
+ if (isPostgres) {
159
+ updateQuery = `
160
+ UPDATE ${this.tableName}
161
+ SET status = 'published', published_at = CURRENT_TIMESTAMP
162
+ WHERE id = $1
163
+ `;
164
+ params = [id];
165
+ }
166
+ else {
167
+ updateQuery = `
168
+ UPDATE ${this.tableName}
169
+ SET status = 'published', published_at = CURRENT_TIMESTAMP
170
+ WHERE id = ?
171
+ `;
172
+ params = [id];
173
+ }
174
+ await this.executeQuery(updateQuery, params);
175
+ }
176
+ async markFailed(id, attempts, errorMsg) {
177
+ const driverName = (this.db.driverName || this.db.config?.driver || 'sqlite').toLowerCase();
178
+ const isPostgres = driverName.includes('postgres') || driverName === 'pg';
179
+ const finalStatus = attempts >= this.maxAttempts ? 'failed' : 'pending';
180
+ let updateQuery;
181
+ let params;
182
+ if (isPostgres) {
183
+ updateQuery = `
184
+ UPDATE ${this.tableName}
185
+ SET status = $1, attempts = $2, last_error = $3
186
+ WHERE id = $4
187
+ `;
188
+ params = [finalStatus, attempts, errorMsg, id];
189
+ }
190
+ else {
191
+ updateQuery = `
192
+ UPDATE ${this.tableName}
193
+ SET status = ?, attempts = ?, last_error = ?
194
+ WHERE id = ?
195
+ `;
196
+ params = [finalStatus, attempts, errorMsg, id];
197
+ }
198
+ await this.executeQuery(updateQuery, params);
199
+ }
200
+ async executeQuery(query, params = []) {
201
+ if (typeof this.db.execute === 'function') {
202
+ const res = await this.db.execute(query, params);
203
+ return Array.isArray(res) ? res : res?.rows || [];
204
+ }
205
+ if (typeof this.db.query === 'function') {
206
+ const res = await this.db.query(query, params);
207
+ return Array.isArray(res) ? res : res?.rows || [];
208
+ }
209
+ if (typeof this.db.raw === 'function') {
210
+ const res = await this.db.raw(query, params);
211
+ return Array.isArray(res) ? res : res?.rows || [];
212
+ }
213
+ throw new Error('Database client does not provide execute, query, or raw method.');
214
+ }
215
+ }
216
+ exports.OutboxRelay = OutboxRelay;
217
+ //# sourceMappingURL=outbox-relay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox-relay.js","sourceRoot":"","sources":["../../src/outbox/outbox-relay.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { OutboxEmitOptions, OutboxRecord } from './outbox.types.js';
2
+ export declare function getOutboxTableSchema(tableName?: string, dialect?: 'postgres' | 'mysql' | 'sqlite' | 'argosdb'): string;
3
+ export declare function createOutboxTable(db: any, tableName?: string): Promise<void>;
4
+ export declare function insertOutboxEvent<T = unknown>(dbOrTrx: any, eventName: string, payload: T, options?: OutboxEmitOptions, tableName?: string): Promise<OutboxRecord<T>>;
5
+ //# sourceMappingURL=outbox-table.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox-table.d.ts","sourceRoot":"","sources":["../../src/outbox/outbox-table.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEzE,wBAAgB,oBAAoB,CAClC,SAAS,SAAkB,EAC3B,OAAO,GAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAsB,GAChE,MAAM,CAuER;AAED,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC3F;AAED,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACjD,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,iBAAiB,EAC3B,SAAS,SAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAyG1B"}
@@ -0,0 +1,213 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getOutboxTableSchema = getOutboxTableSchema;
4
+ exports.createOutboxTable = createOutboxTable;
5
+ exports.insertOutboxEvent = insertOutboxEvent;
6
+ const uuid_js_1 = require("../utils/uuid.js");
7
+ const sqid_js_1 = require("../utils/sqid.js");
8
+ function getOutboxTableSchema(tableName = 'events_outbox', dialect = 'postgres') {
9
+ if (dialect === 'argosdb') {
10
+ return `
11
+ CREATE TABLE IF NOT EXISTS ${tableName} (
12
+ id VARCHAR PRIMARY KEY DEFAULT SQID(),
13
+ event_name VARCHAR NOT NULL,
14
+ payload JSON NOT NULL,
15
+ headers JSON,
16
+ "key" VARCHAR,
17
+ status VARCHAR NOT NULL DEFAULT 'pending',
18
+ attempts INTEGER NOT NULL DEFAULT 0,
19
+ last_error TEXT,
20
+ created_at TIMESTAMP DEFAULT NOW(),
21
+ published_at TIMESTAMP
22
+ );
23
+ CREATE INDEX IF NOT EXISTS idx_${tableName}_status_created ON ${tableName} (status, created_at);
24
+ `.trim();
25
+ }
26
+ if (dialect === 'sqlite') {
27
+ return `
28
+ CREATE TABLE IF NOT EXISTS ${tableName} (
29
+ id TEXT PRIMARY KEY,
30
+ event_name TEXT NOT NULL,
31
+ payload TEXT NOT NULL,
32
+ headers TEXT,
33
+ key TEXT,
34
+ status TEXT NOT NULL DEFAULT 'pending',
35
+ attempts INTEGER NOT NULL DEFAULT 0,
36
+ last_error TEXT,
37
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
38
+ published_at DATETIME
39
+ );
40
+ CREATE INDEX IF NOT EXISTS idx_${tableName}_status_created ON ${tableName} (status, created_at);
41
+ `.trim();
42
+ }
43
+ if (dialect === 'mysql') {
44
+ return `
45
+ CREATE TABLE IF NOT EXISTS ${tableName} (
46
+ id VARCHAR(36) PRIMARY KEY,
47
+ event_name VARCHAR(255) NOT NULL,
48
+ payload JSON NOT NULL,
49
+ headers JSON,
50
+ \`key\` VARCHAR(255),
51
+ status VARCHAR(50) NOT NULL DEFAULT 'pending',
52
+ attempts INT NOT NULL DEFAULT 0,
53
+ last_error TEXT,
54
+ created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
55
+ published_at TIMESTAMP NULL
56
+ );
57
+ CREATE INDEX idx_${tableName}_status_created ON ${tableName} (status, created_at);
58
+ `.trim();
59
+ }
60
+ // Postgres default
61
+ return `
62
+ CREATE TABLE IF NOT EXISTS ${tableName} (
63
+ id VARCHAR(36) PRIMARY KEY,
64
+ event_name VARCHAR(255) NOT NULL,
65
+ payload JSONB NOT NULL,
66
+ headers JSONB,
67
+ key VARCHAR(255),
68
+ status VARCHAR(50) NOT NULL DEFAULT 'pending',
69
+ attempts INT NOT NULL DEFAULT 0,
70
+ last_error TEXT,
71
+ created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
72
+ published_at TIMESTAMP WITH TIME ZONE
73
+ );
74
+ CREATE INDEX IF NOT EXISTS idx_${tableName}_status_created ON ${tableName} (status, created_at);
75
+ `.trim();
76
+ }
77
+ async function createOutboxTable(db, tableName = 'events_outbox') {
78
+ const driverName = (db?.driverName ||
79
+ db?.config?.driver ||
80
+ db?.constructor?.name ||
81
+ 'sqlite').toLowerCase();
82
+ let dialect = 'sqlite';
83
+ if (driverName.includes('argos') ||
84
+ typeof db?.createTable === 'function' ||
85
+ Boolean(db?.config?.endpoint)) {
86
+ dialect = 'argosdb';
87
+ }
88
+ else if (driverName.includes('postgres') || driverName === 'pg') {
89
+ dialect = 'postgres';
90
+ }
91
+ else if (driverName.includes('mysql')) {
92
+ dialect = 'mysql';
93
+ }
94
+ const ddl = getOutboxTableSchema(tableName, dialect);
95
+ const statements = ddl.split(';').map(s => s.trim()).filter(s => s.length > 0);
96
+ for (const statement of statements) {
97
+ if (typeof db.execute === 'function') {
98
+ await db.execute(statement);
99
+ }
100
+ else if (typeof db.query === 'function') {
101
+ await db.query(statement);
102
+ }
103
+ else if (typeof db.raw === 'function') {
104
+ await db.raw(statement);
105
+ }
106
+ }
107
+ }
108
+ async function insertOutboxEvent(dbOrTrx, eventName, payload, options, tableName = 'events_outbox') {
109
+ const driverName = (dbOrTrx?.driverName ||
110
+ dbOrTrx?.config?.driver ||
111
+ dbOrTrx?.constructor?.name ||
112
+ 'sqlite').toLowerCase();
113
+ const isArgosDB = driverName.includes('argos') ||
114
+ typeof dbOrTrx?.createTable === 'function' ||
115
+ Boolean(dbOrTrx?.config?.endpoint);
116
+ const headers = options?.headers ? JSON.stringify(options.headers) : null;
117
+ const payloadStr = typeof payload === 'string' ? payload : JSON.stringify(payload);
118
+ const key = options?.key ?? null;
119
+ const now = new Date();
120
+ let id = options?.id;
121
+ let query;
122
+ let params;
123
+ if (isArgosDB) {
124
+ // For ArgosDB, respect native DEFAULT SQID() unless explicit ID is provided
125
+ if (id) {
126
+ query = `
127
+ INSERT INTO ${tableName} (id, event_name, payload, headers, "key", status, attempts, created_at)
128
+ VALUES (?, ?, ?, ?, ?, 'pending', 0, ?)
129
+ RETURNING *
130
+ `.trim();
131
+ params = [id, eventName, payloadStr, headers, key, now.toISOString()];
132
+ }
133
+ else {
134
+ query = `
135
+ INSERT INTO ${tableName} (event_name, payload, headers, "key", status, attempts, created_at)
136
+ VALUES (?, ?, ?, ?, 'pending', 0, ?)
137
+ RETURNING *
138
+ `.trim();
139
+ params = [eventName, payloadStr, headers, key, now.toISOString()];
140
+ }
141
+ }
142
+ else if (driverName.includes('postgres') || driverName === 'pg') {
143
+ id = id || (options?.idGenerator ? options.idGenerator() : options?.idStrategy === 'sqid' ? (0, sqid_js_1.generateSqid)() : (0, uuid_js_1.generateUuidV7)());
144
+ query = `
145
+ INSERT INTO ${tableName} (id, event_name, payload, headers, key, status, attempts, created_at)
146
+ VALUES ($1, $2, $3::jsonb, $4::jsonb, $5, 'pending', 0, $6)
147
+ RETURNING *
148
+ `.trim();
149
+ params = [id, eventName, payloadStr, headers, key, now];
150
+ }
151
+ else if (driverName.includes('mysql')) {
152
+ id = id || (options?.idGenerator ? options.idGenerator() : options?.idStrategy === 'sqid' ? (0, sqid_js_1.generateSqid)() : (0, uuid_js_1.generateUuidV7)());
153
+ query = `
154
+ INSERT INTO ${tableName} (id, event_name, payload, headers, \`key\`, status, attempts, created_at)
155
+ VALUES (?, ?, ?, ?, ?, 'pending', 0, ?)
156
+ `.trim();
157
+ params = [id, eventName, payloadStr, headers, key, now];
158
+ }
159
+ else {
160
+ // SQLite or generic
161
+ id = id || (options?.idGenerator ? options.idGenerator() : options?.idStrategy === 'sqid' ? (0, sqid_js_1.generateSqid)() : (0, uuid_js_1.generateUuidV7)());
162
+ query = `
163
+ INSERT INTO ${tableName} (id, event_name, payload, headers, "key", status, attempts, created_at)
164
+ VALUES (?, ?, ?, ?, ?, 'pending', 0, ?)
165
+ `.trim();
166
+ params = [id, eventName, payloadStr, headers, key, now.toISOString()];
167
+ }
168
+ let executionResult;
169
+ if (typeof dbOrTrx.execute === 'function') {
170
+ executionResult = await dbOrTrx.execute(query, params);
171
+ }
172
+ else if (typeof dbOrTrx.query === 'function') {
173
+ executionResult = await dbOrTrx.query(query, params);
174
+ }
175
+ else if (typeof dbOrTrx.raw === 'function') {
176
+ executionResult = await dbOrTrx.raw(query, params);
177
+ }
178
+ else {
179
+ throw new Error('Provided db/trx object does not support execute, query, or raw methods.');
180
+ }
181
+ // Extract ID if generated by the database engine (via RETURNING clause)
182
+ let finalId = id;
183
+ if (!finalId) {
184
+ const returnedRow = Array.isArray(executionResult)
185
+ ? executionResult[0]
186
+ : Array.isArray(executionResult?.rows)
187
+ ? executionResult.rows[0]
188
+ : null;
189
+ if (returnedRow?.id) {
190
+ finalId = String(returnedRow.id);
191
+ }
192
+ else if (options?.idGenerator) {
193
+ finalId = options.idGenerator();
194
+ }
195
+ else if (isArgosDB || options?.idStrategy === 'sqid') {
196
+ finalId = (0, sqid_js_1.generateSqid)();
197
+ }
198
+ else {
199
+ finalId = (0, uuid_js_1.generateUuidV7)();
200
+ }
201
+ }
202
+ return {
203
+ id: finalId,
204
+ event_name: eventName,
205
+ payload,
206
+ headers: options?.headers || null,
207
+ key: options?.key || null,
208
+ status: 'pending',
209
+ attempts: 0,
210
+ created_at: now,
211
+ };
212
+ }
213
+ //# sourceMappingURL=outbox-table.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox-table.js","sourceRoot":"","sources":["../../src/outbox/outbox-table.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ export type OutboxStatus = 'pending' | 'processing' | 'published' | 'failed';
2
+ export interface OutboxRecord<T = unknown> {
3
+ id: string;
4
+ event_name: string;
5
+ payload: T;
6
+ headers?: Record<string, string> | null;
7
+ key?: string | null;
8
+ status: OutboxStatus;
9
+ attempts: number;
10
+ last_error?: string | null;
11
+ created_at: Date | string | number;
12
+ published_at?: Date | string | number | null;
13
+ }
14
+ export type OutboxIdStrategy = 'db_default' | 'sqid' | 'uuidv7';
15
+ export interface OutboxEmitOptions {
16
+ headers?: Record<string, string>;
17
+ key?: string;
18
+ id?: string;
19
+ idStrategy?: OutboxIdStrategy;
20
+ idGenerator?: () => string;
21
+ }
22
+ export interface OutboxRelayOptions {
23
+ db: any;
24
+ driver: import('../drivers/driver.interface.js').EventDriver;
25
+ tableName?: string;
26
+ pollIntervalMs?: number;
27
+ batchSize?: number;
28
+ maxAttempts?: number;
29
+ useSkipLocked?: boolean;
30
+ }
31
+ //# sourceMappingURL=outbox.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox.types.d.ts","sourceRoot":"","sources":["../../src/outbox/outbox.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,GAAG,CAAC;IACR,MAAM,EAAE,OAAO,gCAAgC,EAAE,WAAW,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=outbox.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outbox.types.js","sourceRoot":"","sources":["../../src/outbox/outbox.types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,93 @@
1
+ export type SupportedDriverType = 'pulse' | 'memory' | 'redis' | 'rabbitmq' | 'kafka';
2
+ export interface MemoryDriverConfig {
3
+ maxListeners?: number;
4
+ }
5
+ export interface RedisDriverConfig {
6
+ /**
7
+ * Redis connection URL (e.g. 'redis://localhost:6379').
8
+ */
9
+ url?: string;
10
+ host?: string;
11
+ port?: number;
12
+ password?: string;
13
+ db?: number;
14
+ keyPrefix?: string;
15
+ blockTimeoutMs?: number;
16
+ }
17
+ export interface RabbitMQDriverConfig {
18
+ /**
19
+ * AMQP connection URL (e.g. 'amqp://guest:guest@localhost:5672').
20
+ */
21
+ url?: string;
22
+ exchange?: string;
23
+ exchangeType?: 'topic' | 'direct' | 'fanout' | 'headers';
24
+ prefetch?: number;
25
+ durable?: boolean;
26
+ }
27
+ export interface KafkaDriverConfig {
28
+ /**
29
+ * Initial list of broker seed addresses (e.g. ['localhost:9092']).
30
+ */
31
+ brokers: string[];
32
+ clientId?: string;
33
+ ssl?: boolean | Record<string, unknown>;
34
+ sasl?: Record<string, unknown>;
35
+ connectionTimeout?: number;
36
+ requestTimeout?: number;
37
+ retry?: Record<string, unknown>;
38
+ }
39
+ export interface OutboxConfig {
40
+ /**
41
+ * Whether the transactional outbox worker relay is enabled.
42
+ */
43
+ enabled?: boolean;
44
+ /**
45
+ * Database table name storing pending outbox events. Default: 'events_outbox'.
46
+ */
47
+ tableName?: string;
48
+ /**
49
+ * Polling interval in milliseconds for the outbox relay worker. Default: 1000.
50
+ */
51
+ pollIntervalMs?: number;
52
+ /**
53
+ * Maximum batch size to read per poll cycle. Default: 100.
54
+ */
55
+ batchSize?: number;
56
+ /**
57
+ * Maximum delivery attempts before marking event as failed. Default: 5.
58
+ */
59
+ maxAttempts?: number;
60
+ /**
61
+ * Strategy for generating outbox record IDs ('db_default', 'sqid', 'uuidv7').
62
+ * When 'db_default' or when using ArgosDB, ID is omitted so the database default (e.g. SQID()) generates it.
63
+ */
64
+ idStrategy?: 'db_default' | 'sqid' | 'uuidv7';
65
+ /**
66
+ * Custom ID generator function invoked when ID must be created in TypeScript runtime.
67
+ */
68
+ idGenerator?: () => string;
69
+ }
70
+ export type { PulseDriverConfig } from '../drivers/pulse/types.js';
71
+ import type { PulseDriverConfig } from '../drivers/pulse/types.js';
72
+ export interface EventsConfig {
73
+ /**
74
+ * Default event driver to use ('pulse', 'memory', 'redis', 'rabbitmq', 'kafka').
75
+ */
76
+ defaultDriver: SupportedDriverType | string;
77
+ /**
78
+ * Driver-specific configurations.
79
+ */
80
+ drivers: {
81
+ pulse?: PulseDriverConfig;
82
+ memory?: MemoryDriverConfig;
83
+ redis?: RedisDriverConfig;
84
+ rabbitmq?: RabbitMQDriverConfig;
85
+ kafka?: KafkaDriverConfig;
86
+ [key: string]: unknown;
87
+ };
88
+ /**
89
+ * Transactional Outbox pattern settings.
90
+ */
91
+ outbox?: OutboxConfig;
92
+ }
93
+ //# sourceMappingURL=driver.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.types.d.ts","sourceRoot":"","sources":["../../src/types/driver.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtF,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;IAE9C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,aAAa,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAE5C;;OAEG;IACH,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAC5B,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAC1B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;QAChC,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=driver.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.types.js","sourceRoot":"","sources":["../../src/types/driver.types.ts"],"names":[],"mappings":""}