bonescript-compiler 0.5.2 → 0.5.4

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 (187) hide show
  1. package/LICENSE +21 -21
  2. package/dist/algorithm_catalog.js +166 -166
  3. package/dist/cli.d.ts +1 -2
  4. package/dist/cli.js +543 -75
  5. package/dist/cli.js.map +1 -1
  6. package/dist/emit_capability.d.ts +0 -13
  7. package/dist/emit_capability.js +128 -292
  8. package/dist/emit_capability.js.map +1 -1
  9. package/dist/emit_composition.js +3 -37
  10. package/dist/emit_composition.js.map +1 -1
  11. package/dist/emit_deploy.js +162 -162
  12. package/dist/emit_events.d.ts +0 -1
  13. package/dist/emit_events.js +275 -342
  14. package/dist/emit_events.js.map +1 -1
  15. package/dist/emit_full.js +106 -268
  16. package/dist/emit_full.js.map +1 -1
  17. package/dist/emit_maintenance.js +249 -249
  18. package/dist/emit_runtime.d.ts +11 -17
  19. package/dist/emit_runtime.js +688 -29
  20. package/dist/emit_runtime.js.map +1 -1
  21. package/dist/emit_sourcemap.js +66 -66
  22. package/dist/emit_tests.js +0 -37
  23. package/dist/emit_tests.js.map +1 -1
  24. package/dist/emitter.js +16 -82
  25. package/dist/emitter.js.map +1 -1
  26. package/dist/extension_manager.d.ts +2 -2
  27. package/dist/extension_manager.js +3 -6
  28. package/dist/extension_manager.js.map +1 -1
  29. package/dist/ir.d.ts +0 -4
  30. package/dist/lowering.d.ts +14 -5
  31. package/dist/lowering.js +417 -66
  32. package/dist/lowering.js.map +1 -1
  33. package/dist/module_loader.d.ts +2 -2
  34. package/dist/module_loader.js +23 -20
  35. package/dist/module_loader.js.map +1 -1
  36. package/dist/optimizer.js +1 -1
  37. package/dist/optimizer.js.map +1 -1
  38. package/dist/scaffold.d.ts +2 -2
  39. package/dist/scaffold.js +319 -315
  40. package/dist/scaffold.js.map +1 -1
  41. package/dist/source_map.js.map +1 -0
  42. package/dist/test.js.map +1 -0
  43. package/dist/test_typechecker.d.ts +5 -0
  44. package/dist/test_typechecker.js +126 -0
  45. package/dist/test_typechecker.js.map +1 -0
  46. package/dist/typechecker.d.ts +0 -5
  47. package/dist/typechecker.js +13 -68
  48. package/dist/typechecker.js.map +1 -1
  49. package/dist/verifier.d.ts +1 -5
  50. package/dist/verifier.js +35 -140
  51. package/dist/verifier.js.map +1 -1
  52. package/package.json +52 -62
  53. package/src/algorithm_catalog.ts +345 -345
  54. package/src/ast.d.ts +244 -0
  55. package/src/ast.ts +334 -334
  56. package/src/cli.ts +624 -98
  57. package/src/emit_batch.ts +140 -140
  58. package/src/emit_capability.ts +436 -617
  59. package/src/emit_composition.ts +196 -229
  60. package/src/emit_deploy.ts +190 -190
  61. package/src/emit_events.ts +307 -377
  62. package/src/emit_extras.ts +240 -240
  63. package/src/emit_full.ts +309 -475
  64. package/src/emit_maintenance.ts +459 -459
  65. package/src/emit_runtime.ts +730 -17
  66. package/src/emit_sourcemap.ts +140 -140
  67. package/src/emit_tests.ts +205 -246
  68. package/src/emit_websocket.ts +229 -229
  69. package/src/emitter.ts +578 -642
  70. package/src/extension_manager.ts +187 -189
  71. package/src/formatter.ts +297 -297
  72. package/src/index.ts +88 -88
  73. package/src/ir.ts +215 -216
  74. package/src/lexer.d.ts +195 -0
  75. package/src/lexer.ts +630 -630
  76. package/src/lowering.ts +556 -168
  77. package/src/module_loader.ts +114 -112
  78. package/src/optimizer.ts +196 -196
  79. package/src/parse_decls.d.ts +13 -0
  80. package/src/parse_decls.ts +409 -409
  81. package/src/parse_decls2.d.ts +13 -0
  82. package/src/parse_decls2.ts +244 -244
  83. package/src/parse_expr.d.ts +7 -0
  84. package/src/parse_expr.ts +197 -197
  85. package/src/parse_types.d.ts +6 -0
  86. package/src/parse_types.ts +54 -54
  87. package/src/parser.d.ts +10 -0
  88. package/src/parser.ts +1 -1
  89. package/src/parser_base.d.ts +19 -0
  90. package/src/parser_base.ts +57 -57
  91. package/src/parser_recovery.ts +153 -153
  92. package/src/scaffold.ts +375 -371
  93. package/src/solver.ts +330 -330
  94. package/src/typechecker.d.ts +52 -0
  95. package/src/typechecker.ts +591 -657
  96. package/src/types.d.ts +38 -0
  97. package/src/types.ts +122 -122
  98. package/src/verifier.ts +46 -152
  99. package/README.md +0 -382
  100. package/dist/commands/check.d.ts +0 -5
  101. package/dist/commands/check.js +0 -34
  102. package/dist/commands/check.js.map +0 -1
  103. package/dist/commands/compile.d.ts +0 -5
  104. package/dist/commands/compile.js +0 -215
  105. package/dist/commands/compile.js.map +0 -1
  106. package/dist/commands/debug.d.ts +0 -5
  107. package/dist/commands/debug.js +0 -59
  108. package/dist/commands/debug.js.map +0 -1
  109. package/dist/commands/diff.d.ts +0 -5
  110. package/dist/commands/diff.js +0 -125
  111. package/dist/commands/diff.js.map +0 -1
  112. package/dist/commands/fmt.d.ts +0 -5
  113. package/dist/commands/fmt.js +0 -49
  114. package/dist/commands/fmt.js.map +0 -1
  115. package/dist/commands/init.d.ts +0 -5
  116. package/dist/commands/init.js +0 -96
  117. package/dist/commands/init.js.map +0 -1
  118. package/dist/commands/ir.d.ts +0 -5
  119. package/dist/commands/ir.js +0 -27
  120. package/dist/commands/ir.js.map +0 -1
  121. package/dist/commands/lex.d.ts +0 -5
  122. package/dist/commands/lex.js +0 -21
  123. package/dist/commands/lex.js.map +0 -1
  124. package/dist/commands/parse.d.ts +0 -5
  125. package/dist/commands/parse.js +0 -30
  126. package/dist/commands/parse.js.map +0 -1
  127. package/dist/commands/test.d.ts +0 -5
  128. package/dist/commands/test.js +0 -61
  129. package/dist/commands/test.js.map +0 -1
  130. package/dist/commands/verify_determinism.d.ts +0 -5
  131. package/dist/commands/verify_determinism.js +0 -64
  132. package/dist/commands/verify_determinism.js.map +0 -1
  133. package/dist/commands/watch.d.ts +0 -5
  134. package/dist/commands/watch.js +0 -50
  135. package/dist/commands/watch.js.map +0 -1
  136. package/dist/emit_auth.d.ts +0 -18
  137. package/dist/emit_auth.js +0 -507
  138. package/dist/emit_auth.js.map +0 -1
  139. package/dist/emit_database.d.ts +0 -7
  140. package/dist/emit_database.js +0 -74
  141. package/dist/emit_database.js.map +0 -1
  142. package/dist/emit_index.d.ts +0 -6
  143. package/dist/emit_index.js +0 -202
  144. package/dist/emit_index.js.map +0 -1
  145. package/dist/emit_models.d.ts +0 -12
  146. package/dist/emit_models.js +0 -171
  147. package/dist/emit_models.js.map +0 -1
  148. package/dist/emit_openapi.d.ts +0 -9
  149. package/dist/emit_openapi.js +0 -308
  150. package/dist/emit_openapi.js.map +0 -1
  151. package/dist/emit_package.d.ts +0 -7
  152. package/dist/emit_package.js +0 -70
  153. package/dist/emit_package.js.map +0 -1
  154. package/dist/emit_router.d.ts +0 -12
  155. package/dist/emit_router.js +0 -390
  156. package/dist/emit_router.js.map +0 -1
  157. package/dist/lowering_channels.d.ts +0 -11
  158. package/dist/lowering_channels.js +0 -103
  159. package/dist/lowering_channels.js.map +0 -1
  160. package/dist/lowering_entities.d.ts +0 -11
  161. package/dist/lowering_entities.js +0 -232
  162. package/dist/lowering_entities.js.map +0 -1
  163. package/dist/lowering_helpers.d.ts +0 -13
  164. package/dist/lowering_helpers.js +0 -76
  165. package/dist/lowering_helpers.js.map +0 -1
  166. package/src/commands/check.ts +0 -33
  167. package/src/commands/compile.ts +0 -191
  168. package/src/commands/debug.ts +0 -33
  169. package/src/commands/diff.ts +0 -108
  170. package/src/commands/fmt.ts +0 -22
  171. package/src/commands/init.ts +0 -72
  172. package/src/commands/ir.ts +0 -23
  173. package/src/commands/lex.ts +0 -17
  174. package/src/commands/parse.ts +0 -24
  175. package/src/commands/test.ts +0 -36
  176. package/src/commands/verify_determinism.ts +0 -66
  177. package/src/commands/watch.ts +0 -25
  178. package/src/emit_auth.ts +0 -513
  179. package/src/emit_database.ts +0 -75
  180. package/src/emit_index.ts +0 -210
  181. package/src/emit_models.ts +0 -176
  182. package/src/emit_openapi.ts +0 -318
  183. package/src/emit_package.ts +0 -69
  184. package/src/emit_router.ts +0 -409
  185. package/src/lowering_channels.ts +0 -108
  186. package/src/lowering_entities.ts +0 -258
  187. package/src/lowering_helpers.ts +0 -75
@@ -11,40 +11,40 @@
11
11
  * exactly_once — deduplicated via event_id table
12
12
  */
13
13
  Object.defineProperty(exports, "__esModule", { value: true });
14
- exports.emitTypedEventPublishers = exports.emitDurableEventBus = exports.emitOutboxSchema = void 0;
14
+ exports.emitDurableEventBus = exports.emitOutboxSchema = void 0;
15
15
  // ─── Outbox SQL Schema ────────────────────────────────────────────────────────
16
16
  function emitOutboxSchema() {
17
- return `-- BoneScript: Transactional Outbox Schema
18
- -- Generated by BoneScript compiler. DO NOT EDIT.
19
-
20
- CREATE TABLE IF NOT EXISTS event_outbox (
21
- id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
22
- event_type VARCHAR NOT NULL,
23
- payload JSONB NOT NULL,
24
- source VARCHAR NOT NULL,
25
- correlation_id UUID,
26
- created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
27
- scheduled_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
28
- delivered_at TIMESTAMPTZ,
29
- attempts INT NOT NULL DEFAULT 0,
30
- last_error TEXT,
31
- status VARCHAR NOT NULL DEFAULT 'pending'
32
- CHECK (status IN ('pending', 'delivered', 'failed', 'dead_letter'))
33
- );
34
-
35
- CREATE INDEX IF NOT EXISTS idx_event_outbox_status ON event_outbox (status, scheduled_at)
36
- WHERE status = 'pending';
37
-
38
- CREATE INDEX IF NOT EXISTS idx_event_outbox_created ON event_outbox (created_at);
39
-
40
- -- Deduplication table for exactly_once delivery
41
- CREATE TABLE IF NOT EXISTS event_processed (
42
- event_id UUID PRIMARY KEY,
43
- event_type VARCHAR NOT NULL,
44
- processed_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
45
- );
46
-
47
- CREATE INDEX IF NOT EXISTS idx_event_processed_type ON event_processed (event_type, processed_at);
17
+ return `-- BoneScript: Transactional Outbox Schema
18
+ -- Generated by BoneScript compiler. DO NOT EDIT.
19
+
20
+ CREATE TABLE IF NOT EXISTS event_outbox (
21
+ id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
22
+ event_type VARCHAR NOT NULL,
23
+ payload JSONB NOT NULL,
24
+ source VARCHAR NOT NULL,
25
+ correlation_id UUID,
26
+ created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
27
+ scheduled_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
28
+ delivered_at TIMESTAMPTZ,
29
+ attempts INT NOT NULL DEFAULT 0,
30
+ last_error TEXT,
31
+ status VARCHAR NOT NULL DEFAULT 'pending'
32
+ CHECK (status IN ('pending', 'delivered', 'failed', 'dead_letter'))
33
+ );
34
+
35
+ CREATE INDEX IF NOT EXISTS idx_event_outbox_status ON event_outbox (status, scheduled_at)
36
+ WHERE status = 'pending';
37
+
38
+ CREATE INDEX IF NOT EXISTS idx_event_outbox_created ON event_outbox (created_at);
39
+
40
+ -- Deduplication table for exactly_once delivery
41
+ CREATE TABLE IF NOT EXISTS event_processed (
42
+ event_id UUID PRIMARY KEY,
43
+ event_type VARCHAR NOT NULL,
44
+ processed_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
45
+ );
46
+
47
+ CREATE INDEX IF NOT EXISTS idx_event_processed_type ON event_processed (event_type, processed_at);
48
48
  `;
49
49
  }
50
50
  exports.emitOutboxSchema = emitOutboxSchema;
@@ -56,317 +56,250 @@ function emitDurableEventBus(system) {
56
56
  const atLeastOnceEvents = system.events
57
57
  .filter(e => e.delivery === "at_least_once")
58
58
  .map(e => `"${e.name}"`);
59
- return `// Generated by BoneScript compiler. DO NOT EDIT.
60
- // Durable event bus with transactional outbox pattern.
61
- // Set EVENT_MODE=durable in .env to enable.
62
-
63
- import { Pool, PoolClient } from "pg";
64
- import { v4 as uuid } from "uuid";
65
- import { pool } from "./db";
66
- import { logger } from "./logger";
67
- import { counter } from "./metrics";
68
-
69
- export type EventDeliveryMode = "in_process" | "durable";
70
-
71
- const MODE: EventDeliveryMode =
72
- (process.env.EVENT_MODE as EventDeliveryMode) || "in_process";
73
-
74
- // Events requiring exactly_once delivery (deduplicated)
75
- const EXACTLY_ONCE_EVENTS = new Set([${exactlyOnceEvents.join(", ")}]);
76
-
77
- // Events requiring at_least_once delivery (retried until ack)
78
- const AT_LEAST_ONCE_EVENTS = new Set([${atLeastOnceEvents.join(", ")}]);
79
-
80
- export interface EventMetadata {
81
- source: string;
82
- timestamp: Date;
83
- correlation_id: string;
84
- causation_id: string;
85
- }
86
-
87
- export interface SystemEvent {
88
- type: string;
89
- payload: Record<string, unknown>;
90
- metadata: EventMetadata;
91
- }
92
-
93
- type Handler = (event: SystemEvent) => Promise<void>;
94
-
95
- // ─── In-Process Bus ──────────────────────────────────────────────────────────
96
-
97
- class InProcessBus {
98
- private handlers: Map<string, Handler[]> = new Map();
99
-
100
- subscribe(type: string, handler: Handler): void {
101
- const existing = this.handlers.get(type) || [];
102
- existing.push(handler);
103
- this.handlers.set(type, existing);
104
- }
105
-
106
- async publish(type: string, payload: Record<string, unknown>, source: string, correlationId?: string): Promise<void> {
107
- const event: SystemEvent = {
108
- type,
109
- payload,
110
- metadata: {
111
- source,
112
- timestamp: new Date(),
113
- correlation_id: correlationId || uuid(),
114
- causation_id: uuid(),
115
- },
116
- };
117
- counter("event.published", { type, mode: "in_process" });
118
- const handlers = this.handlers.get(type) || [];
119
- for (const handler of handlers) {
120
- try {
121
- await handler(event);
122
- counter("event.delivered", { type, mode: "in_process" });
123
- } catch (e: any) {
124
- counter("event.delivery_failed", { type, mode: "in_process" });
125
- logger.error("event_handler_failed", { event: type, metadata: { error: e.message } });
126
- }
127
- }
128
- }
129
- }
130
-
131
- // ─── Durable Bus (Transactional Outbox) ──────────────────────────────────────
132
-
133
- class DurableBus {
134
- private handlers: Map<string, Handler[]> = new Map();
135
-
136
- subscribe(type: string, handler: Handler): void {
137
- const existing = this.handlers.get(type) || [];
138
- existing.push(handler);
139
- this.handlers.set(type, existing);
140
- }
141
-
142
- // Write event to outbox within the current transaction (or a new one)
143
- async publish(
144
- type: string,
145
- payload: Record<string, unknown>,
146
- source: string,
147
- correlationId?: string,
148
- client?: PoolClient
149
- ): Promise<void> {
150
- const eventId = uuid();
151
- const corrId = correlationId || uuid();
152
- const sql = \`
153
- INSERT INTO event_outbox (id, event_type, payload, source, correlation_id)
154
- VALUES ($1, $2, $3, $4, $5)
155
- \`;
156
- const params = [eventId, type, JSON.stringify({ ...payload, _event_id: eventId }), source, corrId];
157
-
158
- if (client) {
159
- // Write within caller's transaction — atomicity guaranteed
160
- await client.query(sql, params);
161
- } else {
162
- await pool.query(sql, params);
163
- }
164
- counter("event.outboxed", { type });
165
- }
166
-
167
- // Called by the background worker
168
- async flush(): Promise<void> {
169
- const client = await pool.connect();
170
- try {
171
- await client.query("BEGIN");
172
-
173
- // Fetch pending events (lock rows to prevent concurrent processing)
174
- const { rows } = await client.query(\`
175
- SELECT id, event_type, payload, source, correlation_id, attempts
176
- FROM event_outbox
177
- WHERE status = 'pending' AND scheduled_at <= NOW()
178
- ORDER BY scheduled_at ASC
179
- LIMIT 50
180
- FOR UPDATE SKIP LOCKED
181
- \`);
182
-
183
- for (const row of rows) {
184
- try {
185
- // exactly_once: check deduplication table
186
- if (EXACTLY_ONCE_EVENTS.has(row.event_type)) {
187
- const { rows: dup } = await client.query(
188
- "SELECT 1 FROM event_processed WHERE event_id = $1",
189
- [row.payload._event_id || row.id]
190
- );
191
- if (dup.length > 0) {
192
- await client.query(
193
- "UPDATE event_outbox SET status = 'delivered', delivered_at = NOW() WHERE id = $1",
194
- [row.id]
195
- );
196
- continue;
197
- }
198
- }
199
-
200
- const event: SystemEvent = {
201
- type: row.event_type,
202
- payload: row.payload,
203
- metadata: {
204
- source: row.source,
205
- timestamp: new Date(),
206
- correlation_id: row.correlation_id,
207
- causation_id: uuid(),
208
- },
209
- };
210
-
211
- const handlers = this.handlers.get(row.event_type) || [];
212
- for (const handler of handlers) {
213
- await handler(event);
214
- }
215
-
216
- // Mark delivered
217
- await client.query(
218
- "UPDATE event_outbox SET status = 'delivered', delivered_at = NOW(), attempts = attempts + 1 WHERE id = $1",
219
- [row.id]
220
- );
221
-
222
- // Record for exactly_once deduplication
223
- if (EXACTLY_ONCE_EVENTS.has(row.event_type)) {
224
- await client.query(
225
- "INSERT INTO event_processed (event_id, event_type) VALUES ($1, $2) ON CONFLICT DO NOTHING",
226
- [row.payload._event_id || row.id, row.event_type]
227
- );
228
- }
229
-
230
- counter("event.delivered", { type: row.event_type, mode: "durable" });
231
- } catch (e: any) {
232
- const maxAttempts = AT_LEAST_ONCE_EVENTS.has(row.event_type) ? 10 : 3;
233
- const newAttempts = row.attempts + 1;
234
- const status = newAttempts >= maxAttempts ? "dead_letter" : "pending";
235
- const backoffMs = Math.min(1000 * Math.pow(2, newAttempts), 300000);
236
- await client.query(
237
- \`UPDATE event_outbox
238
- SET attempts = $1, last_error = $2, status = $3,
239
- scheduled_at = NOW() + ($4 || ' milliseconds')::interval
240
- WHERE id = $5\`,
241
- [newAttempts, e.message, status, backoffMs, row.id]
242
- );
243
- counter("event.delivery_failed", { type: row.event_type, mode: "durable" });
244
- logger.error("event_delivery_failed", { event: row.event_type, metadata: { error: e.message, attempts: newAttempts } });
245
- }
246
- }
247
-
248
- await client.query("COMMIT");
249
- } catch (e) {
250
- await client.query("ROLLBACK");
251
- throw e;
252
- } finally {
253
- client.release();
254
- }
255
- }
256
-
257
- // Start background worker
258
- startWorker(intervalMs: number = 1000): NodeJS.Timeout {
259
- logger.info("event_worker_started", { event: "startup", metadata: { interval_ms: intervalMs } });
260
- return setInterval(async () => {
261
- try {
262
- await this.flush();
263
- } catch (e: any) {
264
- logger.error("event_worker_error", { event: "flush_failed", metadata: { error: e.message } });
265
- }
266
- }, intervalMs);
267
- }
268
- }
269
-
270
- // ─── Unified Interface ────────────────────────────────────────────────────────
271
-
272
- const inProcess = new InProcessBus();
273
- const durable = new DurableBus();
274
-
275
- export const eventBus = {
276
- subscribe(type: string, handler: Handler): void {
277
- inProcess.subscribe(type, handler);
278
- durable.subscribe(type, handler);
279
- },
280
-
281
- async publish(
282
- type: string,
283
- payload: Record<string, unknown>,
284
- source: string,
285
- correlationId?: string,
286
- client?: PoolClient
287
- ): Promise<void> {
288
- if (MODE === "durable") {
289
- await durable.publish(type, payload, source, correlationId, client);
290
- } else {
291
- await inProcess.publish(type, payload, source, correlationId);
292
- }
293
- },
294
-
295
- startWorker(intervalMs?: number): NodeJS.Timeout | null {
296
- if (MODE === "durable") {
297
- return durable.startWorker(intervalMs);
298
- }
299
- return null;
300
- },
301
- };
59
+ return `// Generated by BoneScript compiler. DO NOT EDIT.
60
+ // Durable event bus with transactional outbox pattern.
61
+ // Set EVENT_MODE=durable in .env to enable.
62
+
63
+ import { Pool, PoolClient } from "pg";
64
+ import { v4 as uuid } from "uuid";
65
+ import { pool } from "./db";
66
+ import { logger } from "./logger";
67
+ import { counter } from "./metrics";
68
+
69
+ export type EventDeliveryMode = "in_process" | "durable";
70
+
71
+ const MODE: EventDeliveryMode =
72
+ (process.env.EVENT_MODE as EventDeliveryMode) || "in_process";
73
+
74
+ // Events requiring exactly_once delivery (deduplicated)
75
+ const EXACTLY_ONCE_EVENTS = new Set<string>([${exactlyOnceEvents.join(", ")}]);
76
+
77
+ // Events requiring at_least_once delivery (retried until ack)
78
+ const AT_LEAST_ONCE_EVENTS = new Set<string>([${atLeastOnceEvents.join(", ")}]);
79
+
80
+ export interface EventMetadata {
81
+ source: string;
82
+ timestamp: Date;
83
+ correlation_id: string;
84
+ causation_id: string;
85
+ }
86
+
87
+ export interface SystemEvent {
88
+ type: string;
89
+ payload: Record<string, unknown>;
90
+ metadata: EventMetadata;
91
+ }
92
+
93
+ type Handler = (event: SystemEvent) => Promise<void>;
94
+
95
+ // ─── In-Process Bus ──────────────────────────────────────────────────────────
96
+
97
+ class InProcessBus {
98
+ private handlers: Map<string, Handler[]> = new Map();
99
+
100
+ subscribe(type: string, handler: Handler): void {
101
+ const existing = this.handlers.get(type) || [];
102
+ existing.push(handler);
103
+ this.handlers.set(type, existing);
104
+ }
105
+
106
+ async publish(type: string, payload: Record<string, unknown>, source: string, correlationId?: string): Promise<void> {
107
+ const event: SystemEvent = {
108
+ type,
109
+ payload,
110
+ metadata: {
111
+ source,
112
+ timestamp: new Date(),
113
+ correlation_id: correlationId || uuid(),
114
+ causation_id: uuid(),
115
+ },
116
+ };
117
+ counter("event.published", { type, mode: "in_process" });
118
+ const handlers = this.handlers.get(type) || [];
119
+ for (const handler of handlers) {
120
+ try {
121
+ await handler(event);
122
+ counter("event.delivered", { type, mode: "in_process" });
123
+ } catch (e: any) {
124
+ counter("event.delivery_failed", { type, mode: "in_process" });
125
+ logger.error("event_handler_failed", { event: type, metadata: { error: e.message } });
126
+ }
127
+ }
128
+ }
129
+ }
130
+
131
+ // ─── Durable Bus (Transactional Outbox) ──────────────────────────────────────
132
+
133
+ class DurableBus {
134
+ private handlers: Map<string, Handler[]> = new Map();
135
+
136
+ subscribe(type: string, handler: Handler): void {
137
+ const existing = this.handlers.get(type) || [];
138
+ existing.push(handler);
139
+ this.handlers.set(type, existing);
140
+ }
141
+
142
+ // Write event to outbox within the current transaction (or a new one)
143
+ async publish(
144
+ type: string,
145
+ payload: Record<string, unknown>,
146
+ source: string,
147
+ correlationId?: string,
148
+ client?: PoolClient
149
+ ): Promise<void> {
150
+ const eventId = uuid();
151
+ const corrId = correlationId || uuid();
152
+ const sql = \`
153
+ INSERT INTO event_outbox (id, event_type, payload, source, correlation_id)
154
+ VALUES ($1, $2, $3, $4, $5)
155
+ \`;
156
+ const params = [eventId, type, JSON.stringify({ ...payload, _event_id: eventId }), source, corrId];
157
+
158
+ if (client) {
159
+ // Write within caller's transaction — atomicity guaranteed
160
+ await client.query(sql, params);
161
+ } else {
162
+ await pool.query(sql, params);
163
+ }
164
+ counter("event.outboxed", { type });
165
+ }
166
+
167
+ // Called by the background worker
168
+ async flush(): Promise<void> {
169
+ const client = await pool.connect();
170
+ try {
171
+ await client.query("BEGIN");
172
+
173
+ // Fetch pending events (lock rows to prevent concurrent processing)
174
+ const { rows } = await client.query(\`
175
+ SELECT id, event_type, payload, source, correlation_id, attempts
176
+ FROM event_outbox
177
+ WHERE status = 'pending' AND scheduled_at <= NOW()
178
+ ORDER BY scheduled_at ASC
179
+ LIMIT 50
180
+ FOR UPDATE SKIP LOCKED
181
+ \`);
182
+
183
+ for (const row of rows) {
184
+ try {
185
+ // exactly_once: check deduplication table
186
+ if (EXACTLY_ONCE_EVENTS.has(row.event_type)) {
187
+ const { rows: dup } = await client.query(
188
+ "SELECT 1 FROM event_processed WHERE event_id = $1",
189
+ [row.payload._event_id || row.id]
190
+ );
191
+ if (dup.length > 0) {
192
+ await client.query(
193
+ "UPDATE event_outbox SET status = 'delivered', delivered_at = NOW() WHERE id = $1",
194
+ [row.id]
195
+ );
196
+ continue;
197
+ }
198
+ }
199
+
200
+ const event: SystemEvent = {
201
+ type: row.event_type,
202
+ payload: row.payload,
203
+ metadata: {
204
+ source: row.source,
205
+ timestamp: new Date(),
206
+ correlation_id: row.correlation_id,
207
+ causation_id: uuid(),
208
+ },
209
+ };
210
+
211
+ const handlers = this.handlers.get(row.event_type) || [];
212
+ for (const handler of handlers) {
213
+ await handler(event);
214
+ }
215
+
216
+ // Mark delivered
217
+ await client.query(
218
+ "UPDATE event_outbox SET status = 'delivered', delivered_at = NOW(), attempts = attempts + 1 WHERE id = $1",
219
+ [row.id]
220
+ );
221
+
222
+ // Record for exactly_once deduplication
223
+ if (EXACTLY_ONCE_EVENTS.has(row.event_type)) {
224
+ await client.query(
225
+ "INSERT INTO event_processed (event_id, event_type) VALUES ($1, $2) ON CONFLICT DO NOTHING",
226
+ [row.payload._event_id || row.id, row.event_type]
227
+ );
228
+ }
229
+
230
+ counter("event.delivered", { type: row.event_type, mode: "durable" });
231
+ } catch (e: any) {
232
+ const maxAttempts = AT_LEAST_ONCE_EVENTS.has(row.event_type) ? 10 : 3;
233
+ const newAttempts = row.attempts + 1;
234
+ const status = newAttempts >= maxAttempts ? "dead_letter" : "pending";
235
+ const backoffMs = Math.min(1000 * Math.pow(2, newAttempts), 300000);
236
+ await client.query(
237
+ \`UPDATE event_outbox
238
+ SET attempts = $1, last_error = $2, status = $3,
239
+ scheduled_at = NOW() + ($4 || ' milliseconds')::interval
240
+ WHERE id = $5\`,
241
+ [newAttempts, e.message, status, backoffMs, row.id]
242
+ );
243
+ counter("event.delivery_failed", { type: row.event_type, mode: "durable" });
244
+ logger.error("event_delivery_failed", { event: row.event_type, metadata: { error: e.message, attempts: newAttempts } });
245
+ }
246
+ }
247
+
248
+ await client.query("COMMIT");
249
+ } catch (e) {
250
+ await client.query("ROLLBACK");
251
+ throw e;
252
+ } finally {
253
+ client.release();
254
+ }
255
+ }
256
+
257
+ // Start background worker
258
+ startWorker(intervalMs: number = 1000): NodeJS.Timeout {
259
+ logger.info("event_worker_started", { event: "startup", metadata: { interval_ms: intervalMs } });
260
+ return setInterval(async () => {
261
+ try {
262
+ await this.flush();
263
+ } catch (e: any) {
264
+ logger.error("event_worker_error", { event: "flush_failed", metadata: { error: e.message } });
265
+ }
266
+ }, intervalMs);
267
+ }
268
+ }
269
+
270
+ // ─── Unified Interface ────────────────────────────────────────────────────────
271
+
272
+ const inProcess = new InProcessBus();
273
+ const durable = new DurableBus();
274
+
275
+ export const eventBus = {
276
+ subscribe(type: string, handler: Handler): void {
277
+ inProcess.subscribe(type, handler);
278
+ durable.subscribe(type, handler);
279
+ },
280
+
281
+ async publish(
282
+ type: string,
283
+ payload: Record<string, unknown>,
284
+ source: string,
285
+ correlationId?: string,
286
+ client?: PoolClient
287
+ ): Promise<void> {
288
+ if (MODE === "durable") {
289
+ await durable.publish(type, payload, source, correlationId, client);
290
+ } else {
291
+ await inProcess.publish(type, payload, source, correlationId);
292
+ }
293
+ },
294
+
295
+ startWorker(intervalMs?: number): NodeJS.Timeout | null {
296
+ if (MODE === "durable") {
297
+ return durable.startWorker(intervalMs);
298
+ }
299
+ return null;
300
+ },
301
+ };
302
302
  `;
303
303
  }
304
304
  exports.emitDurableEventBus = emitDurableEventBus;
305
- // ─── Typed Event Publishers ───────────────────────────────────────────────────
306
- // Generates per-event emitXxx() typed publisher functions as specified in
307
- // spec/09_CODEGEN.md §5.4. These wrap eventBus.publish with a typed payload
308
- // interface so callers get compile-time safety instead of raw Record<string,unknown>.
309
- const TS_TYPE_MAP = {
310
- string: "string", uint: "number", int: "number", float: "number",
311
- bool: "boolean", timestamp: "Date", uuid: "string", bytes: "Buffer", json: "unknown",
312
- };
313
- function toTsType(irType) {
314
- if (TS_TYPE_MAP[irType])
315
- return TS_TYPE_MAP[irType];
316
- const listMatch = irType.match(/^list<(.+)>$/);
317
- if (listMatch)
318
- return `${toTsType(listMatch[1])}[]`;
319
- const setMatch = irType.match(/^set<(.+)>$/);
320
- if (setMatch)
321
- return `${toTsType(setMatch[1])}[]`;
322
- const optMatch = irType.match(/^optional<(.+)>$/);
323
- if (optMatch)
324
- return `${toTsType(optMatch[1])} | null`;
325
- return irType;
326
- }
327
- function emitTypedEventPublishers(system) {
328
- if (system.events.length === 0)
329
- return "";
330
- const lines = [];
331
- lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
332
- lines.push(`// Typed event publisher functions — one per declared event.`);
333
- lines.push(`// Import these instead of calling eventBus.publish() directly.`);
334
- lines.push(``);
335
- lines.push(`import { eventBus } from "./events";`);
336
- lines.push(`import type { PoolClient } from "pg";`);
337
- lines.push(``);
338
- for (const ev of system.events) {
339
- const ifaceName = `${ev.name}Payload`;
340
- // Payload interface
341
- lines.push(`export interface ${ifaceName} {`);
342
- for (const field of ev.payload) {
343
- const nullable = field.nullable ? " | null" : "";
344
- lines.push(` ${field.name}: ${toTsType(field.type)}${nullable};`);
345
- }
346
- lines.push(`}`);
347
- lines.push(``);
348
- // Publisher function
349
- const sourceId = ev.source && ev.source !== "unknown" ? ev.source : system.name;
350
- lines.push(`/**`);
351
- lines.push(` * Publish a ${ev.name} event.`);
352
- lines.push(` * Delivery: ${ev.delivery}${ev.ttl_ms ? ` | TTL: ${ev.ttl_ms}ms` : ""}`);
353
- lines.push(` */`);
354
- lines.push(`export async function emit${ev.name}(`);
355
- lines.push(` payload: ${ifaceName},`);
356
- lines.push(` correlationId?: string,`);
357
- lines.push(` client?: PoolClient,`);
358
- lines.push(`): Promise<void> {`);
359
- lines.push(` await eventBus.publish(`);
360
- lines.push(` "${ev.name}",`);
361
- lines.push(` payload as unknown as Record<string, unknown>,`);
362
- lines.push(` "${sourceId}",`);
363
- lines.push(` correlationId,`);
364
- lines.push(` client,`);
365
- lines.push(` );`);
366
- lines.push(`}`);
367
- lines.push(``);
368
- }
369
- return lines.join("\n");
370
- }
371
- exports.emitTypedEventPublishers = emitTypedEventPublishers;
372
305
  //# sourceMappingURL=emit_events.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"emit_events.js","sourceRoot":"","sources":["../src/emit_events.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"emit_events.js","sourceRoot":"","sources":["../src/emit_events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAIH,iFAAiF;AAEjF,SAAgB,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BR,CAAC;AACF,CAAC;AAjCD,4CAiCC;AAED,iFAAiF;AAEjF,SAAgB,mBAAmB,CAAC,MAAmB;IACrD,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,cAAc,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAE3B,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,eAAe,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAE3B,OAAO;;;;;;;;;;;;;;;;+CAgBsC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;;;gDAG3B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgO3E,CAAC;AACF,CAAC;AA7PD,kDA6PC"}