@reventlessdev/reventless-core 3.0.0-alpha.325 → 3.0.0-alpha.327

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 (80) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/package.json +7 -7
  3. package/src/Message.res +46 -0
  4. package/src/Message.res.mjs +45 -0
  5. package/src/Projection.res +269 -131
  6. package/src/Projection.res.mjs +338 -224
  7. package/src/ViewChange.res +194 -0
  8. package/src/ViewChange.res.mjs +235 -0
  9. package/src/adapter/Runtime/AggregateRuntime_Builder_Common.res.mjs +5 -5
  10. package/src/adapter/Runtime/EventCollectorRuntime_Builder_Single.res.mjs +2 -2
  11. package/src/admin/Platform_Admin_Callback.res.mjs +1 -1
  12. package/src/components/Aggregate/Aggregate_Callback.res +93 -18
  13. package/src/components/Aggregate/Aggregate_Callback.res.mjs +54 -32
  14. package/src/components/AutomationSlice/AutomationSlice_Builder.res.mjs +1 -1
  15. package/src/components/AutomationSlice/AutomationSlice_Callback.res +29 -9
  16. package/src/components/AutomationSlice/AutomationSlice_Callback.res.mjs +35 -20
  17. package/src/components/CommandGenerator/CommandGenerator_Callback.res +47 -6
  18. package/src/components/CommandGenerator/CommandGenerator_Callback.res.mjs +41 -4
  19. package/src/components/CommandTopic/CommandTopic.res.mjs +5 -2
  20. package/src/components/CommandTopic/CommandTopic_Callback.res.mjs +1 -1
  21. package/src/components/CommandTopic/CommandTopic_Helpers.res +64 -26
  22. package/src/components/CommandTopic/CommandTopic_Helpers.res.mjs +37 -17
  23. package/src/components/CommandTopic/CommandTopic_Operations.res +2 -0
  24. package/src/components/CommandTopic/CommandTopic_Operations.res.mjs +2 -2
  25. package/src/components/Counter/Counter_Callback.res.mjs +3 -3
  26. package/src/components/Counter/Counter_Operations.res.mjs +4 -4
  27. package/src/components/DcbEventLog/DcbEventLog_Operations.res.mjs +3 -3
  28. package/src/components/EventLog/EventLog_Operations.res +1 -0
  29. package/src/components/EventLog/EventLog_Operations.res.mjs +3 -3
  30. package/src/components/EventMapper/EventMapper_Callback.res +4 -0
  31. package/src/components/EventMapper/EventMapper_Callback.res.mjs +13 -12
  32. package/src/components/EventTopic/EventTopic_Operations.res +2 -0
  33. package/src/components/EventTopic/EventTopic_Operations.res.mjs +2 -2
  34. package/src/components/Extension/Extension_Operations.res +4 -0
  35. package/src/components/Extension/Extension_Operations.res.mjs +8 -8
  36. package/src/components/ExtensionPoint/ExtensionPoint_Callback.res.mjs +2 -2
  37. package/src/components/ExtensionPoint/ExtensionPoint_Operations.res +2 -0
  38. package/src/components/ExtensionPoint/ExtensionPoint_Operations.res.mjs +9 -8
  39. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Callback.res.mjs +1 -1
  40. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Webhook.res.mjs +1 -1
  41. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Builder.res +6 -2
  42. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Builder.res.mjs +7 -3
  43. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res +33 -12
  44. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res.mjs +30 -17
  45. package/src/components/ReadModel/ReadModel_Callback.res +24 -3
  46. package/src/components/ReadModel/ReadModel_Callback.res.mjs +15 -3
  47. package/src/components/SideEffectHandler/SideEffectHandler_Callback.res +2 -0
  48. package/src/components/SideEffectHandler/SideEffectHandler_Callback.res.mjs +6 -6
  49. package/src/components/StateChangeSlice/StateChangeSlice_Callback.res +43 -7
  50. package/src/components/StateChangeSlice/StateChangeSlice_Callback.res.mjs +38 -20
  51. package/src/components/StateViewSlice/StateViewSlice_Builder.res +16 -2
  52. package/src/components/StateViewSlice/StateViewSlice_Builder.res.mjs +15 -4
  53. package/src/components/StateViewSlice/StateViewSlice_Callback.res +35 -4
  54. package/src/components/StateViewSlice/StateViewSlice_Callback.res.mjs +12 -4
  55. package/src/plugin/component/Plugin_Callback.res.mjs +2 -2
  56. package/src/plugin/connect/PluginExtensionPoint_Plugin.res.mjs +6 -6
  57. package/src/util/CommandPublisher.res.mjs +9 -9
  58. package/src/util/EffectLogger.res +111 -42
  59. package/src/util/EffectLogger.res.mjs +72 -30
  60. package/src/util/FTPHandler.res.mjs +6 -6
  61. package/src/util/Logger.res +231 -35
  62. package/src/util/Logger.res.mjs +263 -42
  63. package/src/util/ScheduleOps.res.mjs +4 -4
  64. package/src/util/Util_AdapterRuntime.res.mjs +2 -2
  65. package/src/util/Util_Promise.res.mjs +1 -1
  66. package/src/util/Util_QueryDbRuntime.res.mjs +1 -1
  67. package/src/util/Validation.res.mjs +1 -1
  68. package/tests/commandgenerator/OwnerActingTest.res +3 -1
  69. package/tests/commandgenerator/OwnerStampingTest.res +65 -0
  70. package/tests/commandgenerator/OwnerStampingTest.res.mjs +62 -0
  71. package/tests/commandtopic/CommandOutcomeHookTest.res +99 -2
  72. package/tests/commandtopic/CommandOutcomeHookTest.res.mjs +120 -0
  73. package/tests/commandtopic/CommandTopicHelpersRejectionTest.res.mjs +4 -4
  74. package/tests/logger/ComponentLineIdsTest.res +97 -0
  75. package/tests/logger/ComponentLineIdsTest.res.mjs +118 -0
  76. package/tests/logger/LogFormatTest.res.mjs +5 -5
  77. package/tests/logger/LoggerSinkTest.res +205 -0
  78. package/tests/logger/LoggerSinkTest.res.mjs +209 -0
  79. package/tests/projection/ViewChangeTest.res +173 -0
  80. package/tests/projection/ViewChangeTest.res.mjs +292 -0
@@ -95,7 +95,7 @@ module Make = (
95
95
  state: Decision.state,
96
96
  owners: array<string>,
97
97
  causes: array<string>,
98
- outcomes: array<(string, cmdOutcome, Message.meta)>,
98
+ outcomes: array<(string, cmdOutcome, Message.meta, option<string>)>,
99
99
  }
100
100
 
101
101
  // Folds a single command into the running accumulator. A domain rejection from
@@ -111,6 +111,7 @@ module Make = (
111
111
  let {reference, command: command'} = topicItem
112
112
  let meta = command'->updateMeta
113
113
  let id = command'.id->Spec.Id.toString
114
+ let ids = EffectLogger.idsOf(command'.meta, ~entityId=id, ~entityType=Spec.name)
114
115
  // Identity, not content: the folded state grows with the entity's whole
115
116
  // history, so serialising it here makes the line's size a function of how
116
117
  // long the system has been in use. The state at decision time is a
@@ -120,6 +121,7 @@ module Make = (
120
121
  let cmdName = cmdVariant->LogFormat.bold
121
122
  EffectLogger.logDebug(
122
123
  ~comp,
124
+ ~ids,
123
125
  `deciding: id=${id} seq=${seq->Int.toString} cmd=${cmdName}`,
124
126
  )->Effect.runSync
125
127
  // Before `decide`, first: a command with a stable id that the stream already
@@ -140,16 +142,31 @@ module Make = (
140
142
  | _ if repeated =>
141
143
  EffectLogger.logInfo(
142
144
  ~comp,
145
+ ~ids,
143
146
  `repeat dropped: ${cmdName}(${id}) msgId=${command'.meta.msgId} already caused events`,
144
147
  )->Effect.runSync
145
- {...acc, outcomes: Array.concat(outcomes, [(reference, CmdRepeated, meta)])}
148
+ {
149
+ ...acc,
150
+ outcomes: Array.concat(
151
+ outcomes,
152
+ [(reference, CmdRepeated, meta, command'.meta.causationId)],
153
+ ),
154
+ }
146
155
  | Some(refused) =>
147
156
  let line = `refused: ${refused.rejected.errorDetail} id=${id}`
148
157
 
149
158
  (
150
- refused.isDefect ? EffectLogger.logError(~comp, line) : EffectLogger.logWarn(~comp, line)
159
+ refused.isDefect
160
+ ? EffectLogger.logError(~comp, line)
161
+ : EffectLogger.logWarn(~comp, ~ids, line)
151
162
  )->Effect.runSync
152
- {...acc, outcomes: Array.concat(outcomes, [(reference, CmdRefused(refused), meta)])}
163
+ {
164
+ ...acc,
165
+ outcomes: Array.concat(
166
+ outcomes,
167
+ [(reference, CmdRefused(refused), meta, command'.meta.causationId)],
168
+ ),
169
+ }
153
170
  | None =>
154
171
  switch Decision.decide(state, command'.command) {
155
172
  | Ok(generatedEvents) =>
@@ -160,7 +177,10 @@ module Make = (
160
177
  causes: generatedEvents->Array.length == 0
161
178
  ? causes
162
179
  : causes->Array.concat([command'.meta.msgId]),
163
- outcomes: Array.concat(outcomes, [(reference, CmdOk(generatedEvents), meta)]),
180
+ outcomes: Array.concat(
181
+ outcomes,
182
+ [(reference, CmdOk(generatedEvents), meta, command'.meta.causationId)],
183
+ ),
164
184
  }
165
185
  | Error(error) =>
166
186
  let errorJson = error->Message.encode(Spec.errorSchema)
@@ -173,13 +193,14 @@ module Make = (
173
193
  : payloadDict->JSON.Encode.object->JSON.stringify
174
194
  EffectLogger.logError(
175
195
  ~comp,
196
+ ~ids,
176
197
  `decide rejected: ${errorCode} ${errorDetail} id=${id}`,
177
198
  )->Effect.runSync
178
199
  {
179
200
  ...acc,
180
201
  outcomes: Array.concat(
181
202
  outcomes,
182
- [(reference, CmdRejected({errorCode, errorDetail}), meta)],
203
+ [(reference, CmdRejected({errorCode, errorDetail}), meta, command'.meta.causationId)],
183
204
  ),
184
205
  }
185
206
  }
@@ -275,6 +296,25 @@ module Make = (
275
296
  // latest persisted snapshot (hash-gated) and replay only the events after it;
276
297
  // otherwise replay full history from seq 0. Returns `(state, sequenceNr, owners)`
277
298
  // where sequenceNr is the total event count (the OCC condition for the next append).
299
+ // The entity a line is about, and its flow when every command of the batch shares one.
300
+ let entityIds = (idStr): EffectLogger.ids => {entityId: idStr, entityType: Spec.name}
301
+ let batchIds = (
302
+ idStr,
303
+ items: array<CommandTopic.topicItem<Message.command'<Spec.Id.t, Spec.command>>>,
304
+ ): EffectLogger.ids => {
305
+ let flows = items->Array.map(i => i.command.meta.correlationId)
306
+ let one = switch flows[0] {
307
+ | Some(f) => flows->Array.every(x => x == f) ? Some(f) : None
308
+ | None => None
309
+ }
310
+ {
311
+ entityId: idStr,
312
+ entityType: Spec.name,
313
+ correlationId: ?one,
314
+ msgId: ?(items->Array.length == 1 ? items[0]->Option.map(i => i.command.meta.msgId) : None),
315
+ }
316
+ }
317
+
278
318
  let coldReadState = id => {
279
319
  let idStr = id->Spec.Id.toString
280
320
  let seedEffect = switch snapshotConfig {
@@ -288,6 +328,7 @@ module Make = (
288
328
  | None =>
289
329
  EffectLogger.logWarn(
290
330
  ~comp,
331
+ ~ids=entityIds(idStr),
291
332
  `snapshot ignored (undecodable): id=${idStr}, seq=${snap.seqNr->Int.toString} — full replay`,
292
333
  )->Effect.runSync
293
334
  (Decision.initialState, 0)
@@ -295,6 +336,7 @@ module Make = (
295
336
  | Ok(Some(snap)) =>
296
337
  EffectLogger.logWarn(
297
338
  ~comp,
339
+ ~ids=entityIds(idStr),
298
340
  `snapshot ignored (schema drift): id=${idStr}, seq=${snap.EventLog.seqNr->Int.toString} — full replay`,
299
341
  )->Effect.runSync
300
342
  (Decision.initialState, 0)
@@ -302,6 +344,7 @@ module Make = (
302
344
  | Error(msg) =>
303
345
  EffectLogger.logWarn(
304
346
  ~comp,
347
+ ~ids=entityIds(idStr),
305
348
  `snapshot read failed (ignored): id=${idStr}: ${msg} — full replay`,
306
349
  )->Effect.runSync
307
350
  (Decision.initialState, 0)
@@ -320,7 +363,7 @@ module Make = (
320
363
  seedSeq > 0
321
364
  ? `(snapshot@${seedSeq->Int.toString}, ${(n - seedSeq)->Int.toString} delta event(s))`
322
365
  : `${n->Int.toString} event(s)`
323
- EffectLogger.logInfo(~comp, `replay: id=${idStr}, ${detail}`)
366
+ EffectLogger.logInfo(~comp, ~ids=entityIds(idStr), `replay: id=${idStr}, ${detail}`)
324
367
  })
325
368
  )
326
369
  }
@@ -345,6 +388,7 @@ module Make = (
345
388
  ->Effect.tap(((_, n, _, _)) =>
346
389
  EffectLogger.logInfo(
347
390
  ~comp,
391
+ ~ids=entityIds(idStr),
348
392
  `replay (with causes, for a stable-id command): id=${idStr}, ${n->Int.toString} event(s)`,
349
393
  )
350
394
  )
@@ -360,11 +404,13 @@ module Make = (
360
404
  | Ok() =>
361
405
  EffectLogger.logDebug(
362
406
  ~comp,
407
+ ~ids=entityIds(idStr),
363
408
  `snapshot written: id=${idStr}, seq=${snap.seqNr->Int.toString}`,
364
409
  )->Effect.runSync
365
410
  | Error(msg) =>
366
411
  EffectLogger.logWarn(
367
412
  ~comp,
413
+ ~ids=entityIds(idStr),
368
414
  `snapshot write failed (ignored): id=${idStr}: ${msg}`,
369
415
  )->Effect.runSync
370
416
  }
@@ -374,6 +420,7 @@ module Make = (
374
420
  let msg = err->JsExn.fromException->Option.flatMap(JsExn.message)->Option.getOr("unknown")
375
421
  EffectLogger.logWarn(
376
422
  ~comp,
423
+ ~ids=entityIds(idStr),
377
424
  `snapshot write threw (ignored): id=${idStr}: ${msg}`,
378
425
  )->Effect.runSync
379
426
  Promise.resolve()
@@ -397,6 +444,7 @@ module Make = (
397
444
  | None =>
398
445
  EffectLogger.logWarn(
399
446
  ~comp,
447
+ ~ids=entityIds(idStr),
400
448
  `snapshot skipped (state not serializable): id=${idStr}, seq=${newSeq->Int.toString}`,
401
449
  )->Effect.runSync
402
450
  }
@@ -408,17 +456,19 @@ module Make = (
408
456
  // are always Ok(reference) — SQS deletes the message because retry would not help —
409
457
  // and the rich error code/detail flows to producers via reportRejected.
410
458
  let reportFinalOutcomes = (
411
- outcomes: array<(string, cmdOutcome, Message.meta)>,
459
+ outcomes: array<(string, cmdOutcome, Message.meta, option<string>)>,
412
460
  ~entityId: string,
413
461
  ~appendSucceeded: bool,
414
462
  ~appendedEventCount: int,
415
463
  ~appendErrorDetail: string="",
416
464
  ): array<result<string, string>> =>
417
- outcomes->Array.map(((reference, outcome, _meta)) =>
465
+ outcomes->Array.map(((reference, outcome, meta: Message.meta, causedBy)) =>
418
466
  switch outcome {
419
467
  | CmdRejected({errorCode, errorDetail}) =>
420
468
  CommandTopic_Helpers.reportRejected(
421
469
  ~component=Spec.name,
470
+ ~correlationId=meta.correlationId,
471
+ ~causationId=?causedBy,
422
472
  ~cause=DomainRejection,
423
473
  reference,
424
474
  {errorCode, errorDetail},
@@ -427,6 +477,8 @@ module Make = (
427
477
  | CmdRefused({rejected}) =>
428
478
  CommandTopic_Helpers.reportRejected(
429
479
  ~component=Spec.name,
480
+ ~correlationId=meta.correlationId,
481
+ ~causationId=?causedBy,
430
482
  ~cause=AccessRefusal,
431
483
  reference,
432
484
  rejected,
@@ -435,6 +487,8 @@ module Make = (
435
487
  | CmdOk(_) if appendSucceeded =>
436
488
  CommandTopic_Helpers.reportAccepted(
437
489
  ~component=Spec.name,
490
+ ~correlationId=meta.correlationId,
491
+ ~causationId=?causedBy,
438
492
  reference,
439
493
  {entityId, eventCount: appendedEventCount},
440
494
  )
@@ -442,6 +496,8 @@ module Make = (
442
496
  | CmdRepeated =>
443
497
  CommandTopic_Helpers.reportAccepted(
444
498
  ~component=Spec.name,
499
+ ~correlationId=meta.correlationId,
500
+ ~causationId=?causedBy,
445
501
  reference,
446
502
  {entityId, eventCount: 0},
447
503
  )
@@ -450,6 +506,8 @@ module Make = (
450
506
  // The decision succeeded and the append did not — infrastructure, not the model.
451
507
  CommandTopic_Helpers.reportRejected(
452
508
  ~component=Spec.name,
509
+ ~correlationId=meta.correlationId,
510
+ ~causationId=?causedBy,
453
511
  ~cause=InfrastructureFailure,
454
512
  reference,
455
513
  {errorCode: Reventless.CommandOutcome.code(AppendFailed), errorDetail: appendErrorDetail},
@@ -483,6 +541,7 @@ module Make = (
483
541
  | Some((state, seqNr, owners)) =>
484
542
  EffectLogger.logInfo(
485
543
  ~comp,
544
+ ~ids=batchIds(idStr, topicItemsForId),
486
545
  `replay skipped (cached): id=${idStr}, seq=${seqNr->Int.toString}`,
487
546
  )->Effect.map(_ => (state, seqNr, owners, []))
488
547
  | None =>
@@ -499,7 +558,7 @@ module Make = (
499
558
 
500
559
  let eventsToAppend =
501
560
  outcomes
502
- ->Array.map(((_reference, outcome, meta)) =>
561
+ ->Array.map(((_reference, outcome, meta, _)) =>
503
562
  switch outcome {
504
563
  | CmdOk(events) => events->Array.map(event => {Message.id, meta, event})
505
564
  | CmdRejected(_) | CmdRefused(_) | CmdRepeated => []
@@ -518,7 +577,11 @@ module Make = (
518
577
  ~appendSucceeded=true,
519
578
  ~appendedEventCount=0,
520
579
  )
521
- EffectLogger.logInfo(~comp, `no events produced: id=${idStr}`)->Effect.map(_ => Ok(perRef))
580
+ EffectLogger.logInfo(
581
+ ~comp,
582
+ ~ids=batchIds(idStr, topicItemsForId),
583
+ `no events produced: id=${idStr}`,
584
+ )->Effect.map(_ => Ok(perRef))
522
585
  | generatedEvents' =>
523
586
  let eventCount = generatedEvents'->Array.length->Int.toString
524
587
  let eventDetails =
@@ -526,6 +589,7 @@ module Make = (
526
589
  let eventJsons = generatedEvents'->Array.map(event' => event'->eventJson)->JSON.Encode.array
527
590
  EffectLogger.logInfo(
528
591
  ~comp,
592
+ ~ids=batchIds(idStr, topicItemsForId),
529
593
  ~detail=eventJsons,
530
594
  `produced ${eventCount} event(s): [${eventDetails}]`,
531
595
  )
@@ -548,7 +612,11 @@ module Make = (
548
612
  ~appendSucceeded=true,
549
613
  ~appendedEventCount=generatedEvents'->Array.length,
550
614
  )
551
- EffectLogger.logInfo(~comp, `append: id=${idStr}`)->Effect.map(_ => Ok(perRef))
615
+ EffectLogger.logInfo(
616
+ ~comp,
617
+ ~ids=batchIds(idStr, topicItemsForId),
618
+ `append: id=${idStr}`,
619
+ )->Effect.map(_ => Ok(perRef))
552
620
  | Error(EventLog.Conflict) =>
553
621
  // Another writer advanced the stream past our (possibly cached)
554
622
  // sequenceNr — drop the entry so the retry replays cold.
@@ -556,9 +624,11 @@ module Make = (
556
624
  // Signal the outer replay+re-decide retry loop (which matches
557
625
  // Error(_)); the string is an internal marker, no longer a
558
626
  // cross-component substring sentinel.
559
- EffectLogger.logWarn(~comp, `conflict: id=${idStr}, will retry`)->Effect.map(
560
- _ => Error("conflict"),
561
- )
627
+ EffectLogger.logWarn(
628
+ ~comp,
629
+ ~ids=batchIds(idStr, topicItemsForId),
630
+ `conflict: id=${idStr}, will retry`,
631
+ )->Effect.map(_ => Error("conflict"))
562
632
  | Error(EventLog.StorageFailure(msg)) =>
563
633
  // Appends are atomic, so the read snapshot is likely still valid —
564
634
  // but a storage error means we can't be sure what committed;
@@ -571,9 +641,11 @@ module Make = (
571
641
  ~appendedEventCount=0,
572
642
  ~appendErrorDetail=msg,
573
643
  )
574
- EffectLogger.logError(~comp, `append failed: id=${idStr}: ${msg}`)->Effect.map(
575
- _ => Ok(perRef),
576
- )
644
+ EffectLogger.logError(
645
+ ~comp,
646
+ ~ids=batchIds(idStr, topicItemsForId),
647
+ `append failed: id=${idStr}: ${msg}`,
648
+ )->Effect.map(_ => Ok(perRef))
577
649
  }
578
650
  )
579
651
  }
@@ -612,6 +684,7 @@ module Make = (
612
684
  let idxStr = (idx + 1)->Int.toString
613
685
  EffectLogger.logInfo(
614
686
  ~comp,
687
+ ~ids=EffectLogger.idsOf(cmdJson.meta, ~entityId=idStr, ~entityType=Spec.name),
615
688
  ~detail=cmdJson.commandJson,
616
689
  `handling command ${idxStr}/${count}: ${LogFormat.cmdDetail(cmdJson)}`,
617
690
  )->Effect.runSync
@@ -630,6 +703,7 @@ module Make = (
630
703
  | Error(_) if retryCount < maxConflictRetries =>
631
704
  EffectLogger.logWarn(
632
705
  ~comp,
706
+ ~ids=batchIds(idStr, topicItemsForId),
633
707
  `conflict retry id=${idStr} ${(retryCount + 1)
634
708
  ->Int.toString}/${maxConflictRetries->Int.toString}`,
635
709
  )->Effect.flatMap(_ => attempt(retryCount + 1))
@@ -637,6 +711,7 @@ module Make = (
637
711
  let detail = `concurrent modification (${maxConflictRetries->Int.toString} retries exhausted): ${msg}`
638
712
  EffectLogger.logError(
639
713
  ~comp,
714
+ ~ids=batchIds(idStr, topicItemsForId),
640
715
  `max conflict retries exhausted id=${idStr}: ${msg}`,
641
716
  )->Effect.map(_ => references->Array.map(_ => Error(detail)))
642
717
  },
@@ -56,13 +56,14 @@ function Make(Spec) {
56
56
  let state = acc.state;
57
57
  let meta = Message$ReventlessCore.deriveMeta(command$p.meta, undefined);
58
58
  let id = Spec.Id.toString(command$p.id);
59
+ let ids = EffectLogger$ReventlessCore.idsOf(id, Spec.name, command$p.meta);
59
60
  let cmdVariant = Message$ReventlessCore.variantNameOfJson(Message$ReventlessCore.encode(command$p.command, Spec.commandSchema));
60
61
  let cmdName = LogFormat$ReventlessCore.bold(cmdVariant);
61
- Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, `deciding: id=` + id + ` seq=` + seq.toString() + ` cmd=` + cmdName));
62
+ Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, ids, `deciding: id=` + id + ` seq=` + seq.toString() + ` cmd=` + cmdName));
62
63
  let repeated = Message$ReventlessCore.hasStableMsgId(command$p.meta) && causes.includes(command$p.meta.msgId);
63
64
  let refusal = repeated || !(actsOnOwned || ownedById) ? undefined : CommandTopic_Helpers$ReventlessCore.ownershipRefusal(OwnerScope$Reventless.decideActing(command$p.meta.callerClaim, Owner$Reventless.streamOwners(owners, ownedById, id)), Spec.name, cmdVariant);
64
65
  if (repeated) {
65
- Effect.runSync(EffectLogger$ReventlessCore.logInfo(comp, undefined, `repeat dropped: ` + cmdName + `(` + id + `) msgId=` + command$p.meta.msgId + ` already caused events`));
66
+ Effect.runSync(EffectLogger$ReventlessCore.logInfo(comp, undefined, ids, `repeat dropped: ` + cmdName + `(` + id + `) msgId=` + command$p.meta.msgId + ` already caused events`));
66
67
  return {
67
68
  state: acc.state,
68
69
  owners: acc.owners,
@@ -70,13 +71,14 @@ function Make(Spec) {
70
71
  outcomes: outcomes.concat([[
71
72
  reference,
72
73
  "CmdRepeated",
73
- meta
74
+ meta,
75
+ command$p.meta.causationId
74
76
  ]])
75
77
  };
76
78
  }
77
79
  if (refusal !== undefined) {
78
80
  let line = `refused: ` + refusal.rejected.errorDetail + ` id=` + id;
79
- Effect.runSync(refusal.isDefect ? EffectLogger$ReventlessCore.logError(comp, undefined, line) : EffectLogger$ReventlessCore.logWarn(comp, undefined, line));
81
+ Effect.runSync(refusal.isDefect ? EffectLogger$ReventlessCore.logError(comp, undefined, undefined, line) : EffectLogger$ReventlessCore.logWarn(comp, undefined, ids, line));
80
82
  return {
81
83
  state: acc.state,
82
84
  owners: acc.owners,
@@ -87,7 +89,8 @@ function Make(Spec) {
87
89
  TAG: "CmdRefused",
88
90
  _0: refusal
89
91
  },
90
- meta
92
+ meta,
93
+ command$p.meta.causationId
91
94
  ]])
92
95
  };
93
96
  }
@@ -105,7 +108,8 @@ function Make(Spec) {
105
108
  TAG: "CmdOk",
106
109
  _0: generatedEvents$1
107
110
  },
108
- meta
111
+ meta,
112
+ command$p.meta.causationId
109
113
  ]])
110
114
  };
111
115
  }
@@ -114,7 +118,7 @@ function Make(Spec) {
114
118
  let match = Message$ReventlessCore.splitMessage(errorJson);
115
119
  let payloadDict = match[1];
116
120
  let errorDetail = Object.entries(payloadDict).length === 0 ? "" : JSON.stringify(payloadDict);
117
- Effect.runSync(EffectLogger$ReventlessCore.logError(comp, undefined, `decide rejected: ` + errorCode + ` ` + errorDetail + ` id=` + id));
121
+ Effect.runSync(EffectLogger$ReventlessCore.logError(comp, undefined, ids, `decide rejected: ` + errorCode + ` ` + errorDetail + ` id=` + id));
118
122
  return {
119
123
  state: acc.state,
120
124
  owners: acc.owners,
@@ -126,7 +130,8 @@ function Make(Spec) {
126
130
  errorCode: errorCode,
127
131
  errorDetail: errorDetail
128
132
  },
129
- meta
133
+ meta,
134
+ command$p.meta.causationId
130
135
  ]])
131
136
  };
132
137
  });
@@ -134,7 +139,7 @@ function Make(Spec) {
134
139
  let resetCache = () => Lru$ReventlessCore.clear(replayCache);
135
140
  let snapshotConfig = actsOnOwned ? undefined : Decision.snapshot;
136
141
  if (actsOnOwned && Stdlib_Option.isSome(Decision.snapshot)) {
137
- Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, "snapshots disabled: this aggregate records an @owner, which a snapshot does not carry"));
142
+ Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, undefined, "snapshots disabled: this aggregate records an @owner, which a snapshot does not carry"));
138
143
  }
139
144
  let stateSchemaHash = snapshotConfig !== undefined ? HashObject(Object.fromEntries([[
140
145
  "state",
@@ -166,6 +171,21 @@ function Make(Spec) {
166
171
  }
167
172
  return Primitive_option.some(state);
168
173
  };
174
+ let entityIds = idStr => ({
175
+ entityId: idStr,
176
+ entityType: Spec.name
177
+ });
178
+ let batchIds = (idStr, items) => {
179
+ let flows = items.map(i => i.command.meta.correlationId);
180
+ let f = flows[0];
181
+ let one = f !== undefined && flows.every(x => x === f) ? f : undefined;
182
+ return {
183
+ msgId: items.length === 1 ? Stdlib_Option.map(items[0], i => i.command.meta.msgId) : undefined,
184
+ correlationId: one,
185
+ entityId: idStr,
186
+ entityType: Spec.name
187
+ };
188
+ };
169
189
  let coldReadState = id => {
170
190
  let idStr = Spec.Id.toString(id);
171
191
  let seedEffect = snapshotConfig !== undefined ? Effect.map(Effect.promise(() => Ops.eventLog.latestSnapshot(id)), snapResult => {
@@ -185,20 +205,20 @@ function Make(Spec) {
185
205
  snap.seqNr
186
206
  ];
187
207
  } else {
188
- Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `snapshot ignored (undecodable): id=` + idStr + `, seq=` + snap.seqNr.toString() + ` — full replay`));
208
+ Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, entityIds(idStr), `snapshot ignored (undecodable): id=` + idStr + `, seq=` + snap.seqNr.toString() + ` — full replay`));
189
209
  return [
190
210
  Decision.initialState,
191
211
  0
192
212
  ];
193
213
  }
194
214
  }
195
- Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `snapshot ignored (schema drift): id=` + idStr + `, seq=` + snap.seqNr.toString() + ` — full replay`));
215
+ Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, entityIds(idStr), `snapshot ignored (schema drift): id=` + idStr + `, seq=` + snap.seqNr.toString() + ` — full replay`));
196
216
  return [
197
217
  Decision.initialState,
198
218
  0
199
219
  ];
200
220
  }
201
- Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `snapshot read failed (ignored): id=` + idStr + `: ` + snapResult._0 + ` — full replay`));
221
+ Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, entityIds(idStr), `snapshot read failed (ignored): id=` + idStr + `: ` + snapResult._0 + ` — full replay`));
202
222
  return [
203
223
  Decision.initialState,
204
224
  0
@@ -220,7 +240,7 @@ function Make(Spec) {
220
240
  ]), param => {
221
241
  let n = param[1];
222
242
  let detail = seedSeq > 0 ? `(snapshot@` + seedSeq.toString() + `, ` + (n - seedSeq | 0).toString() + ` delta event(s))` : n.toString() + ` event(s)`;
223
- return EffectLogger$ReventlessCore.logInfo(comp, undefined, `replay: id=` + idStr + `, ` + detail);
243
+ return EffectLogger$ReventlessCore.logInfo(comp, undefined, entityIds(idStr), `replay: id=` + idStr + `, ` + detail);
224
244
  });
225
245
  });
226
246
  };
@@ -240,7 +260,7 @@ function Make(Spec) {
240
260
  recordEventOwners(param[2], ev$p.event),
241
261
  c !== undefined && !causes.includes(c) ? causes.concat([c]) : causes
242
262
  ];
243
- }), param => EffectLogger$ReventlessCore.logInfo(comp, undefined, `replay (with causes, for a stable-id command): id=` + idStr + `, ` + param[1].toString() + ` event(s)`));
263
+ }), param => EffectLogger$ReventlessCore.logInfo(comp, undefined, entityIds(idStr), `replay (with causes, for a stable-id command): id=` + idStr + `, ` + param[1].toString() + ` event(s)`));
244
264
  };
245
265
  let maybeWriteSnapshot = (id, idStr, oldSeq, newSeq, state) => {
246
266
  if (snapshotConfig === undefined) {
@@ -259,28 +279,30 @@ function Make(Spec) {
259
279
  };
260
280
  Stdlib_Promise.$$catch(Ops.eventLog.writeSnapshot(id, snap).then(result => {
261
281
  if (result.TAG === "Ok") {
262
- Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, `snapshot written: id=` + idStr + `, seq=` + snap.seqNr.toString()));
282
+ Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, entityIds(idStr), `snapshot written: id=` + idStr + `, seq=` + snap.seqNr.toString()));
263
283
  } else {
264
- Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `snapshot write failed (ignored): id=` + idStr + `: ` + result._0));
284
+ Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, entityIds(idStr), `snapshot write failed (ignored): id=` + idStr + `: ` + result._0));
265
285
  }
266
286
  return Promise.resolve();
267
287
  }), err => {
268
288
  let msg = Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_JsExn.fromException(err), Stdlib_JsExn.message), "unknown");
269
- Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `snapshot write threw (ignored): id=` + idStr + `: ` + msg));
289
+ Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, entityIds(idStr), `snapshot write threw (ignored): id=` + idStr + `: ` + msg));
270
290
  return Promise.resolve();
271
291
  });
272
292
  return;
273
293
  } else {
274
- return Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, `snapshot skipped (state not serializable): id=` + idStr + `, seq=` + newSeq.toString()));
294
+ return Effect.runSync(EffectLogger$ReventlessCore.logWarn(comp, undefined, entityIds(idStr), `snapshot skipped (state not serializable): id=` + idStr + `, seq=` + newSeq.toString()));
275
295
  }
276
296
  };
277
297
  let reportFinalOutcomes = (outcomes, entityId, appendSucceeded, appendedEventCount, appendErrorDetailOpt) => {
278
298
  let appendErrorDetail = appendErrorDetailOpt !== undefined ? appendErrorDetailOpt : "";
279
299
  return outcomes.map(param => {
300
+ let causedBy = param[3];
301
+ let meta = param[2];
280
302
  let outcome = param[1];
281
303
  let reference = param[0];
282
304
  if (typeof outcome !== "object") {
283
- CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, reference, {
305
+ CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, meta.correlationId, causedBy, reference, {
284
306
  entityId: entityId,
285
307
  eventCount: 0
286
308
  });
@@ -292,7 +314,7 @@ function Make(Spec) {
292
314
  switch (outcome.TAG) {
293
315
  case "CmdOk" :
294
316
  if (appendSucceeded) {
295
- CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, reference, {
317
+ CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, meta.correlationId, causedBy, reference, {
296
318
  entityId: entityId,
297
319
  eventCount: appendedEventCount
298
320
  });
@@ -301,7 +323,7 @@ function Make(Spec) {
301
323
  _0: reference
302
324
  };
303
325
  } else {
304
- CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "InfrastructureFailure", reference, {
326
+ CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "InfrastructureFailure", meta.correlationId, causedBy, reference, {
305
327
  errorCode: CommandOutcome$Reventless.code("AppendFailed"),
306
328
  errorDetail: appendErrorDetail
307
329
  });
@@ -311,7 +333,7 @@ function Make(Spec) {
311
333
  };
312
334
  }
313
335
  case "CmdRejected" :
314
- CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "DomainRejection", reference, {
336
+ CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "DomainRejection", meta.correlationId, causedBy, reference, {
315
337
  errorCode: outcome.errorCode,
316
338
  errorDetail: outcome.errorDetail
317
339
  });
@@ -320,7 +342,7 @@ function Make(Spec) {
320
342
  _0: reference
321
343
  };
322
344
  case "CmdRefused" :
323
- CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "AccessRefusal", reference, outcome._0.rejected);
345
+ CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "AccessRefusal", meta.correlationId, causedBy, reference, outcome._0.rejected);
324
346
  return {
325
347
  TAG: "Ok",
326
348
  _0: reference
@@ -340,7 +362,7 @@ function Make(Spec) {
340
362
  let owners = match[2];
341
363
  let seqNr = match[1];
342
364
  let state = match[0];
343
- readState = Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, `replay skipped (cached): id=` + idStr + `, seq=` + seqNr.toString()), () => [
365
+ readState = Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, batchIds(idStr, topicItemsForId), `replay skipped (cached): id=` + idStr + `, seq=` + seqNr.toString()), () => [
344
366
  state,
345
367
  seqNr,
346
368
  owners,
@@ -392,7 +414,7 @@ function Make(Spec) {
392
414
  return name + `(` + id + LogFormat$ReventlessCore.variantFields(json) + `)`;
393
415
  }).join(", ");
394
416
  let eventJsons = eventsToAppend.map(event$p => Message$ReventlessCore.encode(event$p.event, Spec.eventSchema));
395
- return Effect.flatMap(Effect.flatMap(EffectLogger$ReventlessCore.logInfo(comp, eventJsons, `produced ` + eventCount + ` event(s): [` + eventDetails + `]`), () => Effect.promise(() => Ops.eventLog.append(sequenceNr, id, eventsToAppend))), appendResult => {
417
+ return Effect.flatMap(Effect.flatMap(EffectLogger$ReventlessCore.logInfo(comp, eventJsons, batchIds(idStr, topicItemsForId), `produced ` + eventCount + ` event(s): [` + eventDetails + `]`), () => Effect.promise(() => Ops.eventLog.append(sequenceNr, id, eventsToAppend))), appendResult => {
396
418
  if (appendResult.TAG === "Ok") {
397
419
  let newSeq = sequenceNr + eventsToAppend.length | 0;
398
420
  Lru$ReventlessCore.put(replayCache, idStr, [
@@ -402,7 +424,7 @@ function Make(Spec) {
402
424
  ]);
403
425
  maybeWriteSnapshot(id, idStr, sequenceNr, newSeq, finalState);
404
426
  let perRef = reportFinalOutcomes(outcomes, idStr, true, eventsToAppend.length, undefined);
405
- return Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, `append: id=` + idStr), () => ({
427
+ return Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, batchIds(idStr, topicItemsForId), `append: id=` + idStr), () => ({
406
428
  TAG: "Ok",
407
429
  _0: perRef
408
430
  }));
@@ -410,7 +432,7 @@ function Make(Spec) {
410
432
  let msg = appendResult._0;
411
433
  if (typeof msg !== "object") {
412
434
  Lru$ReventlessCore.invalidate(replayCache, idStr);
413
- return Effect.map(EffectLogger$ReventlessCore.logWarn(comp, undefined, `conflict: id=` + idStr + `, will retry`), () => ({
435
+ return Effect.map(EffectLogger$ReventlessCore.logWarn(comp, undefined, batchIds(idStr, topicItemsForId), `conflict: id=` + idStr + `, will retry`), () => ({
414
436
  TAG: "Error",
415
437
  _0: "conflict"
416
438
  }));
@@ -418,7 +440,7 @@ function Make(Spec) {
418
440
  let msg$1 = msg._0;
419
441
  Lru$ReventlessCore.invalidate(replayCache, idStr);
420
442
  let perRef$1 = reportFinalOutcomes(outcomes, idStr, false, 0, msg$1);
421
- return Effect.map(EffectLogger$ReventlessCore.logError(comp, undefined, `append failed: id=` + idStr + `: ` + msg$1), () => ({
443
+ return Effect.map(EffectLogger$ReventlessCore.logError(comp, undefined, batchIds(idStr, topicItemsForId), `append failed: id=` + idStr + `: ` + msg$1), () => ({
422
444
  TAG: "Ok",
423
445
  _0: perRef$1
424
446
  }));
@@ -430,7 +452,7 @@ function Make(Spec) {
430
452
  initialOwners
431
453
  ]);
432
454
  let perRef = reportFinalOutcomes(outcomes, idStr, true, 0, undefined);
433
- return Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, `no events produced: id=` + idStr), () => ({
455
+ return Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, batchIds(idStr, topicItemsForId), `no events produced: id=` + idStr), () => ({
434
456
  TAG: "Ok",
435
457
  _0: perRef
436
458
  }));
@@ -444,7 +466,7 @@ function Make(Spec) {
444
466
  let count = cmdJsons.length.toString();
445
467
  cmdJsons.forEach((cmdJson, idx) => {
446
468
  let idxStr = (idx + 1 | 0).toString();
447
- Effect.runSync(EffectLogger$ReventlessCore.logInfo(comp, cmdJson.commandJson, `handling command ` + idxStr + `/` + count + `: ` + LogFormat$ReventlessCore.cmdDetail(cmdJson)));
469
+ Effect.runSync(EffectLogger$ReventlessCore.logInfo(comp, cmdJson.commandJson, EffectLogger$ReventlessCore.idsOf(idStr, Spec.name, cmdJson.meta), `handling command ` + idxStr + `/` + count + `: ` + LogFormat$ReventlessCore.cmdDetail(cmdJson)));
448
470
  });
449
471
  let references = topicItemsForId.map(item => item.reference);
450
472
  let attempt = retryCount => Effect.flatMap(replayProcessAppend(id, topicItemsForId), result => {
@@ -453,10 +475,10 @@ function Make(Spec) {
453
475
  }
454
476
  let msg = result._0;
455
477
  if (retryCount < 3) {
456
- return Effect.flatMap(EffectLogger$ReventlessCore.logWarn(comp, undefined, `conflict retry id=` + idStr + ` ` + (retryCount + 1 | 0).toString() + `/` + (3).toString()), () => attempt(retryCount + 1 | 0));
478
+ return Effect.flatMap(EffectLogger$ReventlessCore.logWarn(comp, undefined, batchIds(idStr, topicItemsForId), `conflict retry id=` + idStr + ` ` + (retryCount + 1 | 0).toString() + `/` + (3).toString()), () => attempt(retryCount + 1 | 0));
457
479
  }
458
480
  let detail = `concurrent modification (` + (3).toString() + ` retries exhausted): ` + msg;
459
- return Effect.map(EffectLogger$ReventlessCore.logError(comp, undefined, `max conflict retries exhausted id=` + idStr + `: ` + msg), () => references.map(param => ({
481
+ return Effect.map(EffectLogger$ReventlessCore.logError(comp, undefined, batchIds(idStr, topicItemsForId), `max conflict retries exhausted id=` + idStr + `: ` + msg), () => references.map(param => ({
460
482
  TAG: "Error",
461
483
  _0: detail
462
484
  })));
@@ -140,7 +140,7 @@ function Make(RuntimeEnvironment) {
140
140
  }
141
141
  Stdlib_Promise.$$catch(Callback.phase2(publishJsonsFn).then(() => syncToQueryDb(queryDbOps)), exn => {
142
142
  let errMsg = Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_JsExn.fromException(exn), Stdlib_JsExn.message), "unknown");
143
- Effect.runSync(EffectLogger$ReventlessCore.logError(`AutomationSlice(` + Spec.name + `)`, undefined, `detached phase 2 error: ` + errMsg));
143
+ Effect.runSync(EffectLogger$ReventlessCore.logError(`AutomationSlice(` + Spec.name + `)`, undefined, undefined, `detached phase 2 error: ` + errMsg));
144
144
  return Promise.resolve();
145
145
  });
146
146
  }));