@reventlessdev/reventless-core 3.0.0-alpha.326 → 3.0.0-alpha.328

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 (90) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/package.json +6 -6
  3. package/src/CommandSent.res +22 -0
  4. package/src/CommandSent.res.mjs +22 -0
  5. package/src/Projection.res +26 -1
  6. package/src/Projection.res.mjs +19 -1
  7. package/src/RowChange.res +37 -0
  8. package/src/RowChange.res.mjs +62 -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 +88 -18
  13. package/src/components/Aggregate/Aggregate_Callback.res.mjs +53 -32
  14. package/src/components/Api/GraphQL_FragmentGenerator.res +22 -0
  15. package/src/components/Api/GraphQL_FragmentGenerator.res.mjs +20 -4
  16. package/src/components/Api/GraphQL_SchemaInspector.res.mjs +2 -2
  17. package/src/components/AutomationSlice/AutomationSlice_Builder.res.mjs +1 -1
  18. package/src/components/AutomationSlice/AutomationSlice_Callback.res +9 -0
  19. package/src/components/AutomationSlice/AutomationSlice_Callback.res.mjs +20 -14
  20. package/src/components/CommandGenerator/CommandGenerator_Callback.res +47 -6
  21. package/src/components/CommandGenerator/CommandGenerator_Callback.res.mjs +41 -4
  22. package/src/components/CommandTopic/CommandTopic_Callback.res.mjs +1 -1
  23. package/src/components/CommandTopic/CommandTopic_Helpers.res +9 -1
  24. package/src/components/CommandTopic/CommandTopic_Helpers.res.mjs +7 -6
  25. package/src/components/CommandTopic/CommandTopic_Operations.res +2 -0
  26. package/src/components/CommandTopic/CommandTopic_Operations.res.mjs +2 -2
  27. package/src/components/Counter/Counter_Callback.res.mjs +3 -3
  28. package/src/components/Counter/Counter_Operations.res.mjs +4 -4
  29. package/src/components/DcbEventLog/DcbEventLog_Operations.res.mjs +3 -3
  30. package/src/components/EventLog/EventLog_Operations.res +1 -0
  31. package/src/components/EventLog/EventLog_Operations.res.mjs +3 -3
  32. package/src/components/EventMapper/EventMapper_Callback.res +12 -2
  33. package/src/components/EventMapper/EventMapper_Callback.res.mjs +16 -14
  34. package/src/components/EventTopic/EventTopic_Operations.res +2 -0
  35. package/src/components/EventTopic/EventTopic_Operations.res.mjs +2 -2
  36. package/src/components/Extension/Extension_Operations.res +4 -0
  37. package/src/components/Extension/Extension_Operations.res.mjs +8 -8
  38. package/src/components/ExtensionPoint/ExtensionPoint_Callback.res +5 -1
  39. package/src/components/ExtensionPoint/ExtensionPoint_Callback.res.mjs +4 -3
  40. package/src/components/ExtensionPoint/ExtensionPoint_Operations.res +2 -0
  41. package/src/components/ExtensionPoint/ExtensionPoint_Operations.res.mjs +9 -8
  42. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Callback.res +4 -0
  43. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Callback.res.mjs +4 -2
  44. package/src/components/InboundTranslationSlice/InboundTranslationSlice_Webhook.res.mjs +1 -1
  45. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Builder.res.mjs +1 -1
  46. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res +12 -0
  47. package/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res.mjs +14 -12
  48. package/src/components/QueryDb/QueryDb_Operations.res +2 -0
  49. package/src/components/QueryDb/QueryDb_Operations.res.mjs +3 -0
  50. package/src/components/ReadModel/ReadModel_Callback.res +1 -0
  51. package/src/components/ReadModel/ReadModel_Callback.res.mjs +1 -1
  52. package/src/components/SideEffectHandler/SideEffectHandler_Callback.res +2 -0
  53. package/src/components/SideEffectHandler/SideEffectHandler_Callback.res.mjs +6 -6
  54. package/src/components/StateChangeSlice/StateChangeSlice_Callback.res +36 -7
  55. package/src/components/StateChangeSlice/StateChangeSlice_Callback.res.mjs +38 -20
  56. package/src/components/StateViewSlice/StateViewSlice_Builder.res +2 -0
  57. package/src/components/StateViewSlice/StateViewSlice_Builder.res.mjs +2 -2
  58. package/src/components/StateViewSlice/StateViewSlice_Callback.res +6 -0
  59. package/src/components/StateViewSlice/StateViewSlice_Callback.res.mjs +3 -2
  60. package/src/components/Task/Task_Builder.res +5 -3
  61. package/src/components/Task/Task_Builder.res.mjs +2 -1
  62. package/src/plugin/component/Plugin_Callback.res +6 -2
  63. package/src/plugin/component/Plugin_Callback.res.mjs +3 -2
  64. package/src/plugin/connect/PluginExtensionPoint_Plugin.res.mjs +6 -6
  65. package/src/util/CommandPublisher.res.mjs +9 -9
  66. package/src/util/EffectLogger.res +85 -17
  67. package/src/util/EffectLogger.res.mjs +63 -12
  68. package/src/util/FTPHandler.res.mjs +6 -6
  69. package/src/util/Metrics.res +151 -16
  70. package/src/util/Metrics.res.mjs +123 -3
  71. package/src/util/ScheduleOps.res.mjs +4 -4
  72. package/src/util/Util_AdapterRuntime.res.mjs +2 -2
  73. package/src/util/Util_Promise.res.mjs +1 -1
  74. package/src/util/Util_QueryDbRuntime.res.mjs +1 -1
  75. package/src/util/Validation.res.mjs +1 -1
  76. package/tests/api/GraphQL_FragmentGeneratorTest.res.mjs +2 -2
  77. package/tests/api/IdentitySemanticTest.res.mjs +1 -1
  78. package/tests/commandgenerator/OwnerStampingTest.res +65 -0
  79. package/tests/commandgenerator/OwnerStampingTest.res.mjs +62 -0
  80. package/tests/commandtopic/CommandOutcomeHookTest.res +25 -0
  81. package/tests/commandtopic/CommandOutcomeHookTest.res.mjs +28 -0
  82. package/tests/commandtopic/CommandTopicHelpersRejectionTest.res.mjs +4 -4
  83. package/tests/logger/ComponentLineIdsTest.res +97 -0
  84. package/tests/logger/ComponentLineIdsTest.res.mjs +118 -0
  85. package/tests/logger/LogFormatTest.res.mjs +5 -5
  86. package/tests/logger/LoggerSinkTest.res.mjs +3 -3
  87. package/tests/querydb/RowChangeTest.res +87 -0
  88. package/tests/querydb/RowChangeTest.res.mjs +157 -0
  89. package/tests/util/MetricsTest.res +72 -0
  90. package/tests/util/MetricsTest.res.mjs +108 -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,18 +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: Message.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,
422
470
  ~correlationId=meta.correlationId,
471
+ ~causationId=?causedBy,
423
472
  ~cause=DomainRejection,
424
473
  reference,
425
474
  {errorCode, errorDetail},
@@ -429,6 +478,7 @@ module Make = (
429
478
  CommandTopic_Helpers.reportRejected(
430
479
  ~component=Spec.name,
431
480
  ~correlationId=meta.correlationId,
481
+ ~causationId=?causedBy,
432
482
  ~cause=AccessRefusal,
433
483
  reference,
434
484
  rejected,
@@ -438,6 +488,7 @@ module Make = (
438
488
  CommandTopic_Helpers.reportAccepted(
439
489
  ~component=Spec.name,
440
490
  ~correlationId=meta.correlationId,
491
+ ~causationId=?causedBy,
441
492
  reference,
442
493
  {entityId, eventCount: appendedEventCount},
443
494
  )
@@ -446,6 +497,7 @@ module Make = (
446
497
  CommandTopic_Helpers.reportAccepted(
447
498
  ~component=Spec.name,
448
499
  ~correlationId=meta.correlationId,
500
+ ~causationId=?causedBy,
449
501
  reference,
450
502
  {entityId, eventCount: 0},
451
503
  )
@@ -455,6 +507,7 @@ module Make = (
455
507
  CommandTopic_Helpers.reportRejected(
456
508
  ~component=Spec.name,
457
509
  ~correlationId=meta.correlationId,
510
+ ~causationId=?causedBy,
458
511
  ~cause=InfrastructureFailure,
459
512
  reference,
460
513
  {errorCode: Reventless.CommandOutcome.code(AppendFailed), errorDetail: appendErrorDetail},
@@ -488,6 +541,7 @@ module Make = (
488
541
  | Some((state, seqNr, owners)) =>
489
542
  EffectLogger.logInfo(
490
543
  ~comp,
544
+ ~ids=batchIds(idStr, topicItemsForId),
491
545
  `replay skipped (cached): id=${idStr}, seq=${seqNr->Int.toString}`,
492
546
  )->Effect.map(_ => (state, seqNr, owners, []))
493
547
  | None =>
@@ -504,7 +558,7 @@ module Make = (
504
558
 
505
559
  let eventsToAppend =
506
560
  outcomes
507
- ->Array.map(((_reference, outcome, meta)) =>
561
+ ->Array.map(((_reference, outcome, meta, _)) =>
508
562
  switch outcome {
509
563
  | CmdOk(events) => events->Array.map(event => {Message.id, meta, event})
510
564
  | CmdRejected(_) | CmdRefused(_) | CmdRepeated => []
@@ -523,7 +577,11 @@ module Make = (
523
577
  ~appendSucceeded=true,
524
578
  ~appendedEventCount=0,
525
579
  )
526
- 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))
527
585
  | generatedEvents' =>
528
586
  let eventCount = generatedEvents'->Array.length->Int.toString
529
587
  let eventDetails =
@@ -531,6 +589,7 @@ module Make = (
531
589
  let eventJsons = generatedEvents'->Array.map(event' => event'->eventJson)->JSON.Encode.array
532
590
  EffectLogger.logInfo(
533
591
  ~comp,
592
+ ~ids=batchIds(idStr, topicItemsForId),
534
593
  ~detail=eventJsons,
535
594
  `produced ${eventCount} event(s): [${eventDetails}]`,
536
595
  )
@@ -553,7 +612,11 @@ module Make = (
553
612
  ~appendSucceeded=true,
554
613
  ~appendedEventCount=generatedEvents'->Array.length,
555
614
  )
556
- 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))
557
620
  | Error(EventLog.Conflict) =>
558
621
  // Another writer advanced the stream past our (possibly cached)
559
622
  // sequenceNr — drop the entry so the retry replays cold.
@@ -561,9 +624,11 @@ module Make = (
561
624
  // Signal the outer replay+re-decide retry loop (which matches
562
625
  // Error(_)); the string is an internal marker, no longer a
563
626
  // cross-component substring sentinel.
564
- EffectLogger.logWarn(~comp, `conflict: id=${idStr}, will retry`)->Effect.map(
565
- _ => Error("conflict"),
566
- )
627
+ EffectLogger.logWarn(
628
+ ~comp,
629
+ ~ids=batchIds(idStr, topicItemsForId),
630
+ `conflict: id=${idStr}, will retry`,
631
+ )->Effect.map(_ => Error("conflict"))
567
632
  | Error(EventLog.StorageFailure(msg)) =>
568
633
  // Appends are atomic, so the read snapshot is likely still valid —
569
634
  // but a storage error means we can't be sure what committed;
@@ -576,9 +641,11 @@ module Make = (
576
641
  ~appendedEventCount=0,
577
642
  ~appendErrorDetail=msg,
578
643
  )
579
- EffectLogger.logError(~comp, `append failed: id=${idStr}: ${msg}`)->Effect.map(
580
- _ => Ok(perRef),
581
- )
644
+ EffectLogger.logError(
645
+ ~comp,
646
+ ~ids=batchIds(idStr, topicItemsForId),
647
+ `append failed: id=${idStr}: ${msg}`,
648
+ )->Effect.map(_ => Ok(perRef))
582
649
  }
583
650
  )
584
651
  }
@@ -617,6 +684,7 @@ module Make = (
617
684
  let idxStr = (idx + 1)->Int.toString
618
685
  EffectLogger.logInfo(
619
686
  ~comp,
687
+ ~ids=EffectLogger.idsOf(cmdJson.meta, ~entityId=idStr, ~entityType=Spec.name),
620
688
  ~detail=cmdJson.commandJson,
621
689
  `handling command ${idxStr}/${count}: ${LogFormat.cmdDetail(cmdJson)}`,
622
690
  )->Effect.runSync
@@ -635,6 +703,7 @@ module Make = (
635
703
  | Error(_) if retryCount < maxConflictRetries =>
636
704
  EffectLogger.logWarn(
637
705
  ~comp,
706
+ ~ids=batchIds(idStr, topicItemsForId),
638
707
  `conflict retry id=${idStr} ${(retryCount + 1)
639
708
  ->Int.toString}/${maxConflictRetries->Int.toString}`,
640
709
  )->Effect.flatMap(_ => attempt(retryCount + 1))
@@ -642,6 +711,7 @@ module Make = (
642
711
  let detail = `concurrent modification (${maxConflictRetries->Int.toString} retries exhausted): ${msg}`
643
712
  EffectLogger.logError(
644
713
  ~comp,
714
+ ~ids=batchIds(idStr, topicItemsForId),
645
715
  `max conflict retries exhausted id=${idStr}: ${msg}`,
646
716
  )->Effect.map(_ => references->Array.map(_ => Error(detail)))
647
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,29 +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];
280
301
  let meta = param[2];
281
302
  let outcome = param[1];
282
303
  let reference = param[0];
283
304
  if (typeof outcome !== "object") {
284
- CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, meta.correlationId, reference, {
305
+ CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, meta.correlationId, causedBy, reference, {
285
306
  entityId: entityId,
286
307
  eventCount: 0
287
308
  });
@@ -293,7 +314,7 @@ function Make(Spec) {
293
314
  switch (outcome.TAG) {
294
315
  case "CmdOk" :
295
316
  if (appendSucceeded) {
296
- CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, meta.correlationId, reference, {
317
+ CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, meta.correlationId, causedBy, reference, {
297
318
  entityId: entityId,
298
319
  eventCount: appendedEventCount
299
320
  });
@@ -302,7 +323,7 @@ function Make(Spec) {
302
323
  _0: reference
303
324
  };
304
325
  } else {
305
- CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "InfrastructureFailure", meta.correlationId, reference, {
326
+ CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "InfrastructureFailure", meta.correlationId, causedBy, reference, {
306
327
  errorCode: CommandOutcome$Reventless.code("AppendFailed"),
307
328
  errorDetail: appendErrorDetail
308
329
  });
@@ -312,7 +333,7 @@ function Make(Spec) {
312
333
  };
313
334
  }
314
335
  case "CmdRejected" :
315
- CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "DomainRejection", meta.correlationId, reference, {
336
+ CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "DomainRejection", meta.correlationId, causedBy, reference, {
316
337
  errorCode: outcome.errorCode,
317
338
  errorDetail: outcome.errorDetail
318
339
  });
@@ -321,7 +342,7 @@ function Make(Spec) {
321
342
  _0: reference
322
343
  };
323
344
  case "CmdRefused" :
324
- CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "AccessRefusal", meta.correlationId, reference, outcome._0.rejected);
345
+ CommandTopic_Helpers$ReventlessCore.reportRejected(Spec.name, "AccessRefusal", meta.correlationId, causedBy, reference, outcome._0.rejected);
325
346
  return {
326
347
  TAG: "Ok",
327
348
  _0: reference
@@ -341,7 +362,7 @@ function Make(Spec) {
341
362
  let owners = match[2];
342
363
  let seqNr = match[1];
343
364
  let state = match[0];
344
- 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()), () => [
345
366
  state,
346
367
  seqNr,
347
368
  owners,
@@ -393,7 +414,7 @@ function Make(Spec) {
393
414
  return name + `(` + id + LogFormat$ReventlessCore.variantFields(json) + `)`;
394
415
  }).join(", ");
395
416
  let eventJsons = eventsToAppend.map(event$p => Message$ReventlessCore.encode(event$p.event, Spec.eventSchema));
396
- 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 => {
397
418
  if (appendResult.TAG === "Ok") {
398
419
  let newSeq = sequenceNr + eventsToAppend.length | 0;
399
420
  Lru$ReventlessCore.put(replayCache, idStr, [
@@ -403,7 +424,7 @@ function Make(Spec) {
403
424
  ]);
404
425
  maybeWriteSnapshot(id, idStr, sequenceNr, newSeq, finalState);
405
426
  let perRef = reportFinalOutcomes(outcomes, idStr, true, eventsToAppend.length, undefined);
406
- 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), () => ({
407
428
  TAG: "Ok",
408
429
  _0: perRef
409
430
  }));
@@ -411,7 +432,7 @@ function Make(Spec) {
411
432
  let msg = appendResult._0;
412
433
  if (typeof msg !== "object") {
413
434
  Lru$ReventlessCore.invalidate(replayCache, idStr);
414
- 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`), () => ({
415
436
  TAG: "Error",
416
437
  _0: "conflict"
417
438
  }));
@@ -419,7 +440,7 @@ function Make(Spec) {
419
440
  let msg$1 = msg._0;
420
441
  Lru$ReventlessCore.invalidate(replayCache, idStr);
421
442
  let perRef$1 = reportFinalOutcomes(outcomes, idStr, false, 0, msg$1);
422
- 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), () => ({
423
444
  TAG: "Ok",
424
445
  _0: perRef$1
425
446
  }));
@@ -431,7 +452,7 @@ function Make(Spec) {
431
452
  initialOwners
432
453
  ]);
433
454
  let perRef = reportFinalOutcomes(outcomes, idStr, true, 0, undefined);
434
- 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), () => ({
435
456
  TAG: "Ok",
436
457
  _0: perRef
437
458
  }));
@@ -445,7 +466,7 @@ function Make(Spec) {
445
466
  let count = cmdJsons.length.toString();
446
467
  cmdJsons.forEach((cmdJson, idx) => {
447
468
  let idxStr = (idx + 1 | 0).toString();
448
- 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)));
449
470
  });
450
471
  let references = topicItemsForId.map(item => item.reference);
451
472
  let attempt = retryCount => Effect.flatMap(replayProcessAppend(id, topicItemsForId), result => {
@@ -454,10 +475,10 @@ function Make(Spec) {
454
475
  }
455
476
  let msg = result._0;
456
477
  if (retryCount < 3) {
457
- 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));
458
479
  }
459
480
  let detail = `concurrent modification (` + (3).toString() + ` retries exhausted): ` + msg;
460
- 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 => ({
461
482
  TAG: "Error",
462
483
  _0: detail
463
484
  })));