@reventlessdev/reventless-core 3.0.0-alpha.309 → 3.0.0-alpha.311
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.
- package/CHANGELOG.md +28 -0
- package/package.json +6 -6
- package/src/Message.res +9 -2
- package/src/Message.res.mjs +8 -1
- package/src/adapter/Auth/Auth_Adapter.res +1 -1
- package/src/admin/Platform_Admin.res.mjs +0 -2
- package/src/components/Aggregate/Aggregate_Callback.res +111 -48
- package/src/components/Aggregate/Aggregate_Callback.res.mjs +107 -49
- package/src/components/Builder_Helpers.res +0 -17
- package/src/components/Builder_Helpers.res.mjs +0 -15
- package/src/components/EventLog/EventLog.res +7 -0
- package/src/components/EventLog/EventLog_Builder.res +2 -0
- package/src/components/EventLog/EventLog_Builder.res.mjs +1 -0
- package/src/components/EventLog/EventLog_Operations.res +30 -0
- package/src/components/EventLog/EventLog_Operations.res.mjs +18 -0
- package/src/components/Extension/Extension.res +0 -2
- package/src/components/Extension/Extension_Builder.res +2 -20
- package/src/components/Extension/Extension_Builder.res.mjs +1 -3
- package/src/components/Extension/Extension_Operations.res +0 -19
- package/src/components/Extension/Extension_Operations.res.mjs +1 -7
- package/src/components/ReadModel/ReadModel_Builder.res +12 -2
- package/src/components/ReadModel/ReadModel_Builder.res.mjs +2 -1
- package/src/components/StateChangeSlice/StateChangeSlice_Callback.res +72 -35
- package/src/components/StateChangeSlice/StateChangeSlice_Callback.res.mjs +45 -31
- package/src/plugin/component/Plugin_Builder.res +1 -26
- package/src/plugin/component/Plugin_Builder.res.mjs +6 -20
- package/src/plugin/component/Plugin_Helpers.res +0 -37
- package/src/plugin/component/Plugin_Helpers.res.mjs +8 -21
- package/tests/aggregate/AggregateCacheTest.res +6 -0
- package/tests/aggregate/AggregateCacheTest.res.mjs +5 -0
- package/tests/aggregate/AggregateConflictTest.res +6 -0
- package/tests/aggregate/AggregateConflictTest.res.mjs +5 -0
- package/tests/aggregate/AggregateFixtures.res +6 -0
- package/tests/aggregate/AggregateFixtures.res.mjs +5 -0
- package/tests/aggregate/AggregateRepeatTest.res +186 -0
- package/tests/aggregate/AggregateRepeatTest.res.mjs +332 -0
- package/tests/aggregate/AggregateSnapshotTest.res +6 -0
- package/tests/aggregate/AggregateSnapshotTest.res.mjs +12 -0
- package/tests/commandgenerator/OwnerActingTest.res +6 -0
- package/tests/commandgenerator/OwnerActingTest.res.mjs +5 -0
- package/tests/extensionpoint/DerivedMessageIdTest.res +217 -0
- package/tests/extensionpoint/DerivedMessageIdTest.res.mjs +361 -0
- package/tests/logger/LogFormatTest.res +1 -2
- package/tests/logger/LogFormatTest.res.mjs +2 -3
- package/tests/message/MessageTest.res +48 -1
- package/tests/message/MessageTest.res.mjs +56 -2
- package/tests/plugin/pluginDefinitionRequiredScalars.txt +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,34 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
# 3.0.0-alpha.311 (2026-10-29)
|
|
7
|
+
|
|
8
|
+
* refactor!: drop `dcbSources`, the cross-plugin DCB subscription nobody declared ([cf3b66d](https://github.com/ReventlessDev/reventless-core/commit/cf3b66d8c1b5d87673197b64eaee174598bb8253))
|
|
9
|
+
* refactor!: a read model hears another plugin only through an Extension and a slice ([15c7cae](https://github.com/ReventlessDev/reventless-core/commit/15c7cae214d5aa04404779fcd87a8429aad1965c))
|
|
10
|
+
### Features
|
|
11
|
+
|
|
12
|
+
* **core:** a handler drops a command it has already handled ([605862b](https://github.com/ReventlessDev/reventless-core/commit/605862bba765b1501eb19d08f3924bf619159e21))
|
|
13
|
+
* **infra:** a message a mapping derives gets a stable id and names its parent ([a72a08f](https://github.com/ReventlessDev/reventless-core/commit/a72a08f9af4440eff5fa36e9a364a426bc70918c))
|
|
14
|
+
|
|
15
|
+
### BREAKING CHANGES
|
|
16
|
+
|
|
17
|
+
* `Reventless.Plugin.extensionDefinition` has no `dcbSources`
|
|
18
|
+
field, and `Platform_PluginExtensions.dcbSources` is gone from the GraphQL
|
|
19
|
+
schema. A query that selects it fails as a whole; drop the selection.
|
|
20
|
+
* `ReventlessInfra.Extension.T.make` and the core
|
|
21
|
+
`Extension_Builder.make` no longer take `~readModelNamesForSourceName` and
|
|
22
|
+
`~publishToReadModels`. Both arguments did nothing; drop them at the call site.
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
# 3.0.0-alpha.310 (2026-10-25)
|
|
27
|
+
|
|
28
|
+
**Note:** Version bump only for package @reventlessdev/reventless-core
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
|
|
6
34
|
# 3.0.0-alpha.309 (2026-10-25)
|
|
7
35
|
|
|
8
36
|
### Features
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@reventlessdev/reventless-core",
|
|
3
|
-
"version": "3.0.0-alpha.
|
|
3
|
+
"version": "3.0.0-alpha.311",
|
|
4
4
|
"description": "Core package for Reventless framework",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"jest": {
|
|
@@ -28,17 +28,17 @@
|
|
|
28
28
|
"dependencies": {
|
|
29
29
|
"sury": "11.0.0",
|
|
30
30
|
"uuid": "^13.0.0",
|
|
31
|
+
"@reventlessdev/rescript-effect": "1.0.0-alpha.1",
|
|
31
32
|
"@reventlessdev/rescript-fast-csv": "2.0.0-alpha.23",
|
|
33
|
+
"@reventlessdev/rescript-hash-object": "1.2.0-alpha.15",
|
|
32
34
|
"@reventlessdev/rescript-jest": "1.0.0-alpha.13",
|
|
33
35
|
"@reventlessdev/rescript-node": "2.0.0-alpha.23",
|
|
34
|
-
"@reventlessdev/rescript-hash-object": "1.2.0-alpha.15",
|
|
35
|
-
"@reventlessdev/rescript-effect": "1.0.0-alpha.1",
|
|
36
36
|
"@reventlessdev/rescript-pulumi-pulumi": "3.0.0-alpha.0",
|
|
37
37
|
"@reventlessdev/rescript-ssh2": "2.0.0-alpha.24",
|
|
38
|
+
"@reventlessdev/reventless-infra": "3.0.0-alpha.208",
|
|
38
39
|
"@reventlessdev/rescript-uuid": "2.0.0-alpha.1",
|
|
39
|
-
"@reventlessdev/reventless-
|
|
40
|
-
"@reventlessdev/reventless-
|
|
41
|
-
"@reventlessdev/reventless-spec": "3.0.0-alpha.177"
|
|
40
|
+
"@reventlessdev/reventless-spec": "3.0.0-alpha.179",
|
|
41
|
+
"@reventlessdev/reventless-interop": "3.0.0-alpha.42"
|
|
42
42
|
},
|
|
43
43
|
"devDependencies": {
|
|
44
44
|
"rescript": "12.3.1",
|
package/src/Message.res
CHANGED
|
@@ -238,7 +238,8 @@ let generateMeta = (
|
|
|
238
238
|
// - fresh `msgId` and `time`
|
|
239
239
|
// - `correlationId` inherited (so the chain root id stays stable)
|
|
240
240
|
// - `causationId` = parent.msgId (the *direct* parent)
|
|
241
|
-
// - `ip`, `user`, `traceparent`, `schemaVersion`, `headers` inherited as-is
|
|
241
|
+
// - `ip`, `user`, `traceparent`, `schemaVersion`, `headers` inherited as-is,
|
|
242
|
+
// except the stable-id mark: this id is fresh, so the child must not carry it
|
|
242
243
|
// - `service` overridable; defaults to parent's service
|
|
243
244
|
let deriveMeta = (~parent: meta, ~service=?) => {
|
|
244
245
|
service: service->Option.getOr(parent.service),
|
|
@@ -250,9 +251,15 @@ let deriveMeta = (~parent: meta, ~service=?) => {
|
|
|
250
251
|
user: ?parent.user,
|
|
251
252
|
traceparent: ?parent.traceparent,
|
|
252
253
|
schemaVersion: ?parent.schemaVersion,
|
|
253
|
-
headers: ?parent.headers,
|
|
254
|
+
headers: ?ReventlessInfra.Message.withoutStableIdHeader(parent.headers),
|
|
254
255
|
}
|
|
255
256
|
|
|
257
|
+
// The same envelope with a `msgId` that is a function of its input, for a message
|
|
258
|
+
// a mapping derives from another; defined beside the mappings in infra. A handler
|
|
259
|
+
// asks `hasStableMsgId` whether a repeat of the command can be recognized.
|
|
260
|
+
let deriveStableMeta = ReventlessInfra.Message.deriveStableMeta
|
|
261
|
+
let hasStableMsgId = ReventlessInfra.Message.hasStableMsgId
|
|
262
|
+
|
|
256
263
|
let decomposeMeta = meta =>
|
|
257
264
|
meta
|
|
258
265
|
->Reventless.Util_Sury.toJson(metaSchema)
|
package/src/Message.res.mjs
CHANGED
|
@@ -10,6 +10,7 @@ import * as Message$Reventless from "@reventlessdev/reventless-spec/src/types/Me
|
|
|
10
10
|
import * as Primitive_exceptions from "@rescript/runtime/lib/es6/Primitive_exceptions.js";
|
|
11
11
|
import * as Util_Sury$Reventless from "@reventlessdev/reventless-spec/src/util/Util_Sury.res.mjs";
|
|
12
12
|
import * as Logger$ReventlessCore from "./util/Logger.res.mjs";
|
|
13
|
+
import * as Message$ReventlessInfra from "@reventlessdev/reventless-infra/src/types/Message.res.mjs";
|
|
13
14
|
|
|
14
15
|
let logger = Logger$ReventlessCore.fromEnv();
|
|
15
16
|
|
|
@@ -196,7 +197,7 @@ function deriveMeta(parent, service) {
|
|
|
196
197
|
causationId: parent.msgId,
|
|
197
198
|
traceparent: parent.traceparent,
|
|
198
199
|
schemaVersion: parent.schemaVersion,
|
|
199
|
-
headers: parent.headers
|
|
200
|
+
headers: Message$ReventlessInfra.withoutStableIdHeader(parent.headers)
|
|
200
201
|
};
|
|
201
202
|
}
|
|
202
203
|
|
|
@@ -401,6 +402,10 @@ let encode = Message$Reventless.encode;
|
|
|
401
402
|
|
|
402
403
|
let InvalidEvent = Message$Reventless.InvalidEvent;
|
|
403
404
|
|
|
405
|
+
let deriveStableMeta = Message$ReventlessInfra.deriveStableMeta;
|
|
406
|
+
|
|
407
|
+
let hasStableMsgId = Message$ReventlessInfra.hasStableMsgId;
|
|
408
|
+
|
|
404
409
|
export {
|
|
405
410
|
logger,
|
|
406
411
|
serviceSchema,
|
|
@@ -436,6 +441,8 @@ export {
|
|
|
436
441
|
hrtimeToString,
|
|
437
442
|
generateMeta,
|
|
438
443
|
deriveMeta,
|
|
444
|
+
deriveStableMeta,
|
|
445
|
+
hasStableMsgId,
|
|
439
446
|
decomposeMeta,
|
|
440
447
|
composeEventJson$p,
|
|
441
448
|
composeMeta,
|
|
@@ -23,7 +23,7 @@ type requestContext = {
|
|
|
23
23
|
|
|
24
24
|
module type Provider = {
|
|
25
25
|
/** Provider-specific deploy-time output (e.g. `{userPoolId, clientId}`
|
|
26
|
-
for Cognito, `{
|
|
26
|
+
for Cognito, `{accountsFilePath}` for in-memory). Consumed by the platform
|
|
27
27
|
stack to wire downstream resources such as the AppSync auth config. */
|
|
28
28
|
type authConfig
|
|
29
29
|
|
|
@@ -228,8 +228,6 @@ function Make(RuntimeEnvironment) {
|
|
|
228
228
|
taskSideEffectFinishFns: Builder_Helpers$ReventlessCore.taskSideEffectFinishFns,
|
|
229
229
|
registerTaskSideEffectHandler: Builder_Helpers$ReventlessCore.registerTaskSideEffectHandler,
|
|
230
230
|
finishTasks: Builder_Helpers$ReventlessCore.finishTasks,
|
|
231
|
-
readModelNamesForSourceName: Builder_Helpers$ReventlessCore.readModelNamesForSourceName,
|
|
232
|
-
publishToReadModels: Builder_Helpers$ReventlessCore.publishToReadModels,
|
|
233
231
|
finishReadModels: Builder_Helpers$ReventlessCore.finishReadModels,
|
|
234
232
|
extractReadModelsOutputs: Builder_Helpers$ReventlessCore.extractReadModelsOutputs,
|
|
235
233
|
createReadModels: Builder_Helpers$ReventlessCore.createReadModels,
|
|
@@ -80,26 +80,31 @@ module Make = (
|
|
|
80
80
|
| CmdOk(array<Spec.event>)
|
|
81
81
|
| CmdRejected({errorCode: string, errorDetail: string})
|
|
82
82
|
| CmdRefused(CommandTopic_Helpers.ownershipRefusal)
|
|
83
|
+
// A command the stream already holds events for: delivered again, accepted
|
|
84
|
+
// again, nothing new.
|
|
85
|
+
| CmdRepeated
|
|
86
|
+
|
|
87
|
+
// What the fold carries from command to command: the state decided on, the
|
|
88
|
+
// distinct owners the stream records, and the `msgId`s of the commands that
|
|
89
|
+
// caused its events — the second only for a batch that can be asked about a
|
|
90
|
+
// repeat, the third only when a batch holds a command with a stable id.
|
|
91
|
+
type fold = {
|
|
92
|
+
state: Decision.state,
|
|
93
|
+
owners: array<string>,
|
|
94
|
+
causes: array<string>,
|
|
95
|
+
outcomes: array<(string, cmdOutcome, Message.meta)>,
|
|
96
|
+
}
|
|
83
97
|
|
|
84
|
-
// Folds a single command into the running accumulator
|
|
85
|
-
//
|
|
86
|
-
//
|
|
98
|
+
// Folds a single command into the running accumulator. A domain rejection from
|
|
99
|
+
// Decision.decide is recorded as `CmdRejected` (no state change, surviving
|
|
100
|
+
// commands in the batch continue); a successful decide records `CmdOk(events)`
|
|
87
101
|
// and advances state via `Decision.evolve`.
|
|
88
102
|
//
|
|
89
103
|
// `~seq` is the replayed sequence number the batch decides from, carried in so
|
|
90
104
|
// the line below can name the state rather than serialise it.
|
|
91
|
-
//
|
|
92
|
-
// `owners` are the distinct owners the stream records so far, including any a
|
|
93
|
-
// command earlier in the same batch just recorded.
|
|
94
105
|
let processCommand = (~seq: int) =>
|
|
95
|
-
(
|
|
96
|
-
|
|
97
|
-
Decision.state,
|
|
98
|
-
array<string>,
|
|
99
|
-
array<(string, cmdOutcome, Message.meta)>,
|
|
100
|
-
),
|
|
101
|
-
topicItem: CommandTopic.topicItem<Message.command'<Spec.Id.t, Spec.command>>,
|
|
102
|
-
) => {
|
|
106
|
+
(acc: fold, topicItem: CommandTopic.topicItem<Message.command'<Spec.Id.t, Spec.command>>) => {
|
|
107
|
+
let {state, owners, causes, outcomes} = acc
|
|
103
108
|
let {reference, command: command'} = topicItem
|
|
104
109
|
let meta = command'->updateMeta
|
|
105
110
|
let id = command'.id->Spec.Id.toString
|
|
@@ -114,31 +119,46 @@ module Make = (
|
|
|
114
119
|
~comp,
|
|
115
120
|
`deciding: id=${id} seq=${seq->Int.toString} cmd=${cmdName}`,
|
|
116
121
|
)->Effect.runSync
|
|
117
|
-
// Before `decide
|
|
118
|
-
//
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
122
|
+
// Before `decide`, first: a command with a stable id that the stream already
|
|
123
|
+
// holds events for was delivered a second time. Accepted, nothing new — the
|
|
124
|
+
// decision has run once and must not count the fact twice.
|
|
125
|
+
let repeated =
|
|
126
|
+
Message.hasStableMsgId(command'.meta) && causes->Array.includes(command'.meta.msgId)
|
|
127
|
+
// Before `decide`, second: an owner-marked aggregate refuses a caller who
|
|
128
|
+
// does not own the stream.
|
|
129
|
+
let refusal =
|
|
130
|
+
repeated || !actsOnOwned
|
|
131
|
+
? None
|
|
132
|
+
: Reventless.OwnerScope.decideActing(
|
|
133
|
+
~claim=command'.meta.callerClaim,
|
|
134
|
+
~recordedOwners=Some(owners),
|
|
135
|
+
)->CommandTopic_Helpers.ownershipRefusal(~component=Spec.name, ~command=cmdVariant)
|
|
125
136
|
switch refusal {
|
|
137
|
+
| _ if repeated =>
|
|
138
|
+
EffectLogger.logInfo(
|
|
139
|
+
~comp,
|
|
140
|
+
`repeat dropped: ${cmdName}(${id}) msgId=${command'.meta.msgId} already caused events`,
|
|
141
|
+
)->Effect.runSync
|
|
142
|
+
{...acc, outcomes: Array.concat(outcomes, [(reference, CmdRepeated, meta)])}
|
|
126
143
|
| Some(refused) =>
|
|
127
144
|
let line = `refused: ${refused.rejected.errorDetail} id=${id}`
|
|
128
145
|
|
|
129
146
|
(
|
|
130
147
|
refused.isDefect ? EffectLogger.logError(~comp, line) : EffectLogger.logWarn(~comp, line)
|
|
131
148
|
)->Effect.runSync
|
|
132
|
-
|
|
149
|
+
{...acc, outcomes: Array.concat(outcomes, [(reference, CmdRefused(refused), meta)])}
|
|
133
150
|
| None =>
|
|
134
151
|
switch Decision.decide(state, command'.command) {
|
|
135
152
|
| Ok(generatedEvents) =>
|
|
136
153
|
let newState = generatedEvents->Array.reduce(state, Decision.evolve)
|
|
137
|
-
|
|
138
|
-
newState,
|
|
139
|
-
generatedEvents->Array.reduce(owners, recordEventOwners),
|
|
140
|
-
Array.
|
|
141
|
-
|
|
154
|
+
{
|
|
155
|
+
state: newState,
|
|
156
|
+
owners: generatedEvents->Array.reduce(owners, recordEventOwners),
|
|
157
|
+
causes: generatedEvents->Array.length == 0
|
|
158
|
+
? causes
|
|
159
|
+
: causes->Array.concat([command'.meta.msgId]),
|
|
160
|
+
outcomes: Array.concat(outcomes, [(reference, CmdOk(generatedEvents), meta)]),
|
|
161
|
+
}
|
|
142
162
|
| Error(error) =>
|
|
143
163
|
let errorJson = error->Message.encode(Spec.errorSchema)
|
|
144
164
|
let errorCode = errorJson->Message.variantNameOfJson
|
|
@@ -152,11 +172,13 @@ module Make = (
|
|
|
152
172
|
~comp,
|
|
153
173
|
`decide rejected: ${errorCode} ${errorDetail} id=${id}`,
|
|
154
174
|
)->Effect.runSync
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
175
|
+
{
|
|
176
|
+
...acc,
|
|
177
|
+
outcomes: Array.concat(
|
|
178
|
+
outcomes,
|
|
179
|
+
[(reference, CmdRejected({errorCode, errorDetail}), meta)],
|
|
180
|
+
),
|
|
181
|
+
}
|
|
160
182
|
}
|
|
161
183
|
}
|
|
162
184
|
}
|
|
@@ -297,6 +319,31 @@ module Make = (
|
|
|
297
319
|
)
|
|
298
320
|
}
|
|
299
321
|
|
|
322
|
+
// The read for a batch holding a command with a stable id: the whole stream, as
|
|
323
|
+
// envelopes, so the `causationId`s say which commands already produced events.
|
|
324
|
+
// Neither the in-process cache nor a snapshot carries those, so this read skips
|
|
325
|
+
// both — a command an Extension derived pays a full replay for the guarantee
|
|
326
|
+
// that a second delivery of it changes nothing.
|
|
327
|
+
let coldReadCauses = id => {
|
|
328
|
+
let idStr = id->Spec.Id.toString
|
|
329
|
+
Ops.eventLog.replayStream'(id, ~fromSeq=0)
|
|
330
|
+
->Stream.runFold((Decision.initialState, 0, [], []), ((st, n, owners, causes), ev') => (
|
|
331
|
+
Decision.evolve(st, ev'.event),
|
|
332
|
+
n + 1,
|
|
333
|
+
owners->recordEventOwners(ev'.event),
|
|
334
|
+
switch ev'.meta.causationId {
|
|
335
|
+
| Some(c) if !(causes->Array.includes(c)) => causes->Array.concat([c])
|
|
336
|
+
| _ => causes
|
|
337
|
+
},
|
|
338
|
+
))
|
|
339
|
+
->Effect.tap(((_, n, _, _)) =>
|
|
340
|
+
EffectLogger.logInfo(
|
|
341
|
+
~comp,
|
|
342
|
+
`replay (with causes, for a stable-id command): id=${idStr}, ${n->Int.toString} event(s)`,
|
|
343
|
+
)
|
|
344
|
+
)
|
|
345
|
+
}
|
|
346
|
+
|
|
300
347
|
// Fire-and-forget snapshot write — never awaited, never fails the command. A
|
|
301
348
|
// failed write just means the next cold replay reads a longer delta.
|
|
302
349
|
let fireSnapshotWrite = (id, idStr, snap: EventLog.snapshot) => {
|
|
@@ -386,6 +433,13 @@ module Make = (
|
|
|
386
433
|
{entityId, eventCount: appendedEventCount},
|
|
387
434
|
)
|
|
388
435
|
Ok(reference)
|
|
436
|
+
| CmdRepeated =>
|
|
437
|
+
CommandTopic_Helpers.reportAccepted(
|
|
438
|
+
~component=Spec.name,
|
|
439
|
+
reference,
|
|
440
|
+
{entityId, eventCount: 0},
|
|
441
|
+
)
|
|
442
|
+
Ok(reference)
|
|
389
443
|
| CmdOk(_) =>
|
|
390
444
|
// The decision succeeded and the append did not — infrastructure, not the model.
|
|
391
445
|
CommandTopic_Helpers.reportRejected(
|
|
@@ -408,23 +462,32 @@ module Make = (
|
|
|
408
462
|
) => {
|
|
409
463
|
let idStr = id->Spec.Id.toString
|
|
410
464
|
|
|
411
|
-
//
|
|
412
|
-
//
|
|
413
|
-
// path
|
|
414
|
-
//
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
465
|
+
// A batch with a command whose id is stable reads the stream with its causes
|
|
466
|
+
// (`coldReadCauses`): the cache and the snapshot cannot say what already
|
|
467
|
+
// happened for that command. Otherwise, warm path: seed from the in-process
|
|
468
|
+
// cache and skip both the snapshot read and the event-log replay; the OCC
|
|
469
|
+
// append below fences any staleness. Cold path (`coldReadState`): seed from
|
|
470
|
+
// the persisted snapshot when enabled, else full replay.
|
|
471
|
+
let asksForRepeats =
|
|
472
|
+
topicItemsForId->Array.some(item => Message.hasStableMsgId(item.command.meta))
|
|
473
|
+
let readState = if asksForRepeats {
|
|
474
|
+
coldReadCauses(id)
|
|
475
|
+
} else {
|
|
476
|
+
switch replayCache->Lru.get(idStr) {
|
|
477
|
+
| Some((state, seqNr, owners)) =>
|
|
478
|
+
EffectLogger.logInfo(
|
|
479
|
+
~comp,
|
|
480
|
+
`replay skipped (cached): id=${idStr}, seq=${seqNr->Int.toString}`,
|
|
481
|
+
)->Effect.map(_ => (state, seqNr, owners, []))
|
|
482
|
+
| None =>
|
|
483
|
+
coldReadState(id)->Effect.map(((state, seqNr, owners)) => (state, seqNr, owners, []))
|
|
484
|
+
}
|
|
422
485
|
}
|
|
423
486
|
|
|
424
|
-
readState->Effect.flatMap(((initialState, sequenceNr, initialOwners)) => {
|
|
425
|
-
let
|
|
487
|
+
readState->Effect.flatMap(((initialState, sequenceNr, initialOwners, causes)) => {
|
|
488
|
+
let {state: finalState, owners: finalOwners, outcomes} =
|
|
426
489
|
topicItemsForId->Array.reduce(
|
|
427
|
-
|
|
490
|
+
{state: initialState, owners: initialOwners, causes, outcomes: []},
|
|
428
491
|
processCommand(~seq=sequenceNr),
|
|
429
492
|
)
|
|
430
493
|
|
|
@@ -433,7 +496,7 @@ module Make = (
|
|
|
433
496
|
->Array.map(((_reference, outcome, meta)) =>
|
|
434
497
|
switch outcome {
|
|
435
498
|
| CmdOk(events) => events->Array.map(event => {Message.id, meta, event})
|
|
436
|
-
| CmdRejected(_) | CmdRefused(_) => []
|
|
499
|
+
| CmdRejected(_) | CmdRefused(_) | CmdRepeated => []
|
|
437
500
|
}
|
|
438
501
|
)
|
|
439
502
|
->Array.flat
|
|
@@ -46,25 +46,41 @@ function Make(Spec) {
|
|
|
46
46
|
return owners;
|
|
47
47
|
}
|
|
48
48
|
};
|
|
49
|
-
let processCommand = seq => ((
|
|
49
|
+
let processCommand = seq => ((acc, topicItem) => {
|
|
50
50
|
let reference = topicItem.reference;
|
|
51
51
|
let command$p = topicItem.command;
|
|
52
|
-
let outcomes =
|
|
53
|
-
let
|
|
54
|
-
let
|
|
52
|
+
let outcomes = acc.outcomes;
|
|
53
|
+
let causes = acc.causes;
|
|
54
|
+
let owners = acc.owners;
|
|
55
|
+
let state = acc.state;
|
|
55
56
|
let meta = Message$ReventlessCore.deriveMeta(command$p.meta, undefined);
|
|
56
57
|
let id = Spec.Id.toString(command$p.id);
|
|
57
58
|
let cmdVariant = Message$ReventlessCore.variantNameOfJson(Message$ReventlessCore.encode(command$p.command, Spec.commandSchema));
|
|
58
59
|
let cmdName = LogFormat$ReventlessCore.bold(cmdVariant);
|
|
59
60
|
Effect.runSync(EffectLogger$ReventlessCore.logDebug(comp, undefined, `deciding: id=` + id + ` seq=` + seq.toString() + ` cmd=` + cmdName));
|
|
60
|
-
let
|
|
61
|
+
let repeated = Message$ReventlessCore.hasStableMsgId(command$p.meta) && causes.includes(command$p.meta.msgId);
|
|
62
|
+
let refusal = repeated || !actsOnOwned ? undefined : CommandTopic_Helpers$ReventlessCore.ownershipRefusal(OwnerScope$Reventless.decideActing(command$p.meta.callerClaim, owners), Spec.name, cmdVariant);
|
|
63
|
+
if (repeated) {
|
|
64
|
+
Effect.runSync(EffectLogger$ReventlessCore.logInfo(comp, undefined, `repeat dropped: ` + cmdName + `(` + id + `) msgId=` + command$p.meta.msgId + ` already caused events`));
|
|
65
|
+
return {
|
|
66
|
+
state: acc.state,
|
|
67
|
+
owners: acc.owners,
|
|
68
|
+
causes: acc.causes,
|
|
69
|
+
outcomes: outcomes.concat([[
|
|
70
|
+
reference,
|
|
71
|
+
"CmdRepeated",
|
|
72
|
+
meta
|
|
73
|
+
]])
|
|
74
|
+
};
|
|
75
|
+
}
|
|
61
76
|
if (refusal !== undefined) {
|
|
62
77
|
let line = `refused: ` + refusal.rejected.errorDetail + ` id=` + id;
|
|
63
78
|
Effect.runSync(refusal.isDefect ? EffectLogger$ReventlessCore.logError(comp, undefined, line) : EffectLogger$ReventlessCore.logWarn(comp, undefined, line));
|
|
64
|
-
return
|
|
65
|
-
state,
|
|
66
|
-
owners,
|
|
67
|
-
|
|
79
|
+
return {
|
|
80
|
+
state: acc.state,
|
|
81
|
+
owners: acc.owners,
|
|
82
|
+
causes: acc.causes,
|
|
83
|
+
outcomes: outcomes.concat([[
|
|
68
84
|
reference,
|
|
69
85
|
{
|
|
70
86
|
TAG: "CmdRefused",
|
|
@@ -72,16 +88,17 @@ function Make(Spec) {
|
|
|
72
88
|
},
|
|
73
89
|
meta
|
|
74
90
|
]])
|
|
75
|
-
|
|
91
|
+
};
|
|
76
92
|
}
|
|
77
93
|
let generatedEvents = Decision.decide(state, command$p.command);
|
|
78
94
|
if (generatedEvents.TAG === "Ok") {
|
|
79
95
|
let generatedEvents$1 = generatedEvents._0;
|
|
80
96
|
let newState = Stdlib_Array.reduce(generatedEvents$1, state, Decision.evolve);
|
|
81
|
-
return
|
|
82
|
-
newState,
|
|
83
|
-
Stdlib_Array.reduce(generatedEvents$1, owners, recordEventOwners),
|
|
84
|
-
|
|
97
|
+
return {
|
|
98
|
+
state: newState,
|
|
99
|
+
owners: Stdlib_Array.reduce(generatedEvents$1, owners, recordEventOwners),
|
|
100
|
+
causes: generatedEvents$1.length === 0 ? causes : causes.concat([command$p.meta.msgId]),
|
|
101
|
+
outcomes: outcomes.concat([[
|
|
85
102
|
reference,
|
|
86
103
|
{
|
|
87
104
|
TAG: "CmdOk",
|
|
@@ -89,7 +106,7 @@ function Make(Spec) {
|
|
|
89
106
|
},
|
|
90
107
|
meta
|
|
91
108
|
]])
|
|
92
|
-
|
|
109
|
+
};
|
|
93
110
|
}
|
|
94
111
|
let errorJson = Message$ReventlessCore.encode(generatedEvents._0, Spec.errorSchema);
|
|
95
112
|
let errorCode = Message$ReventlessCore.variantNameOfJson(errorJson);
|
|
@@ -97,10 +114,11 @@ function Make(Spec) {
|
|
|
97
114
|
let payloadDict = match[1];
|
|
98
115
|
let errorDetail = Object.entries(payloadDict).length === 0 ? "" : JSON.stringify(payloadDict);
|
|
99
116
|
Effect.runSync(EffectLogger$ReventlessCore.logError(comp, undefined, `decide rejected: ` + errorCode + ` ` + errorDetail + ` id=` + id));
|
|
100
|
-
return
|
|
101
|
-
state,
|
|
102
|
-
owners,
|
|
103
|
-
|
|
117
|
+
return {
|
|
118
|
+
state: acc.state,
|
|
119
|
+
owners: acc.owners,
|
|
120
|
+
causes: acc.causes,
|
|
121
|
+
outcomes: outcomes.concat([[
|
|
104
122
|
reference,
|
|
105
123
|
{
|
|
106
124
|
TAG: "CmdRejected",
|
|
@@ -109,7 +127,7 @@ function Make(Spec) {
|
|
|
109
127
|
},
|
|
110
128
|
meta
|
|
111
129
|
]])
|
|
112
|
-
|
|
130
|
+
};
|
|
113
131
|
});
|
|
114
132
|
let replayCache = Lru$ReventlessCore.make(100);
|
|
115
133
|
let resetCache = () => Lru$ReventlessCore.clear(replayCache);
|
|
@@ -205,6 +223,24 @@ function Make(Spec) {
|
|
|
205
223
|
});
|
|
206
224
|
});
|
|
207
225
|
};
|
|
226
|
+
let coldReadCauses = id => {
|
|
227
|
+
let idStr = Spec.Id.toString(id);
|
|
228
|
+
return Effect.tap(Stream.runFold(Ops.eventLog["replayStream'"](id, 0), [
|
|
229
|
+
Decision.initialState,
|
|
230
|
+
0,
|
|
231
|
+
[],
|
|
232
|
+
[]
|
|
233
|
+
], (param, ev$p) => {
|
|
234
|
+
let causes = param[3];
|
|
235
|
+
let c = ev$p.meta.causationId;
|
|
236
|
+
return [
|
|
237
|
+
Decision.evolve(param[0], ev$p.event),
|
|
238
|
+
param[1] + 1 | 0,
|
|
239
|
+
recordEventOwners(param[2], ev$p.event),
|
|
240
|
+
c !== undefined && !causes.includes(c) ? causes.concat([c]) : causes
|
|
241
|
+
];
|
|
242
|
+
}), param => EffectLogger$ReventlessCore.logInfo(comp, undefined, `replay (with causes, for a stable-id command): id=` + idStr + `, ` + param[1].toString() + ` event(s)`));
|
|
243
|
+
};
|
|
208
244
|
let maybeWriteSnapshot = (id, idStr, oldSeq, newSeq, state) => {
|
|
209
245
|
if (snapshotConfig === undefined) {
|
|
210
246
|
return;
|
|
@@ -242,6 +278,16 @@ function Make(Spec) {
|
|
|
242
278
|
return outcomes.map(param => {
|
|
243
279
|
let outcome = param[1];
|
|
244
280
|
let reference = param[0];
|
|
281
|
+
if (typeof outcome !== "object") {
|
|
282
|
+
CommandTopic_Helpers$ReventlessCore.reportAccepted(Spec.name, reference, {
|
|
283
|
+
entityId: entityId,
|
|
284
|
+
eventCount: 0
|
|
285
|
+
});
|
|
286
|
+
return {
|
|
287
|
+
TAG: "Ok",
|
|
288
|
+
_0: reference
|
|
289
|
+
};
|
|
290
|
+
}
|
|
245
291
|
switch (outcome.TAG) {
|
|
246
292
|
case "CmdOk" :
|
|
247
293
|
if (appendSucceeded) {
|
|
@@ -283,45 +329,57 @@ function Make(Spec) {
|
|
|
283
329
|
};
|
|
284
330
|
let replayProcessAppend = (id, topicItemsForId) => {
|
|
285
331
|
let idStr = Spec.Id.toString(id);
|
|
286
|
-
let
|
|
332
|
+
let asksForRepeats = topicItemsForId.some(item => Message$ReventlessCore.hasStableMsgId(item.command.meta));
|
|
287
333
|
let readState;
|
|
288
|
-
if (
|
|
289
|
-
|
|
290
|
-
let seqNr = match[1];
|
|
291
|
-
let state = match[0];
|
|
292
|
-
readState = Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, `replay skipped (cached): id=` + idStr + `, seq=` + seqNr.toString()), () => [
|
|
293
|
-
state,
|
|
294
|
-
seqNr,
|
|
295
|
-
owners
|
|
296
|
-
]);
|
|
334
|
+
if (asksForRepeats) {
|
|
335
|
+
readState = coldReadCauses(id);
|
|
297
336
|
} else {
|
|
298
|
-
|
|
337
|
+
let match = Lru$ReventlessCore.get(replayCache, idStr);
|
|
338
|
+
if (match !== undefined) {
|
|
339
|
+
let owners = match[2];
|
|
340
|
+
let seqNr = match[1];
|
|
341
|
+
let state = match[0];
|
|
342
|
+
readState = Effect.map(EffectLogger$ReventlessCore.logInfo(comp, undefined, `replay skipped (cached): id=` + idStr + `, seq=` + seqNr.toString()), () => [
|
|
343
|
+
state,
|
|
344
|
+
seqNr,
|
|
345
|
+
owners,
|
|
346
|
+
[]
|
|
347
|
+
]);
|
|
348
|
+
} else {
|
|
349
|
+
readState = Effect.map(coldReadState(id), param => [
|
|
350
|
+
param[0],
|
|
351
|
+
param[1],
|
|
352
|
+
param[2],
|
|
353
|
+
[]
|
|
354
|
+
]);
|
|
355
|
+
}
|
|
299
356
|
}
|
|
300
357
|
return Effect.flatMap(readState, param => {
|
|
301
358
|
let initialOwners = param[2];
|
|
302
359
|
let sequenceNr = param[1];
|
|
303
360
|
let initialState = param[0];
|
|
304
|
-
let match = Stdlib_Array.reduce(topicItemsForId,
|
|
305
|
-
initialState,
|
|
306
|
-
initialOwners,
|
|
307
|
-
[]
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
let
|
|
311
|
-
let
|
|
361
|
+
let match = Stdlib_Array.reduce(topicItemsForId, {
|
|
362
|
+
state: initialState,
|
|
363
|
+
owners: initialOwners,
|
|
364
|
+
causes: param[3],
|
|
365
|
+
outcomes: []
|
|
366
|
+
}, processCommand(sequenceNr));
|
|
367
|
+
let outcomes = match.outcomes;
|
|
368
|
+
let finalOwners = match.owners;
|
|
369
|
+
let finalState = match.state;
|
|
312
370
|
let eventsToAppend = outcomes.map(param => {
|
|
313
371
|
let meta = param[2];
|
|
314
372
|
let outcome = param[1];
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
373
|
+
if (typeof outcome !== "object") {
|
|
374
|
+
return [];
|
|
375
|
+
} else if (outcome.TAG === "CmdOk") {
|
|
376
|
+
return outcome._0.map(event => ({
|
|
377
|
+
id: id,
|
|
378
|
+
meta: meta,
|
|
379
|
+
event: event
|
|
380
|
+
}));
|
|
381
|
+
} else {
|
|
382
|
+
return [];
|
|
325
383
|
}
|
|
326
384
|
}).flat();
|
|
327
385
|
if (eventsToAppend.length !== 0) {
|
|
@@ -118,9 +118,6 @@ let finishTasks = () =>
|
|
|
118
118
|
->Pulumi.Output.apply(_ => taskSideEffectFinishFns->Array.forEach(finishFn => finishFn()))
|
|
119
119
|
}
|
|
120
120
|
|
|
121
|
-
let readModelNamesForSourceName = Dict.make()
|
|
122
|
-
let publishToReadModels = Dict.make()
|
|
123
|
-
|
|
124
121
|
let finishReadModels = readModels => {
|
|
125
122
|
let _ =
|
|
126
123
|
readModels
|
|
@@ -161,20 +158,6 @@ let createReadModels = (
|
|
|
161
158
|
)
|
|
162
159
|
let rmOutputs = SpecificReadModel.outputs(readModel)
|
|
163
160
|
let rmOperations = SpecificReadModel.operations(readModel)
|
|
164
|
-
rmOutputs.sourceNames->Array.forEach(sourceName =>
|
|
165
|
-
switch readModelNamesForSourceName->Dict.get(sourceName) {
|
|
166
|
-
| Some(readModelNames) =>
|
|
167
|
-
readModelNamesForSourceName->Dict.set(
|
|
168
|
-
sourceName,
|
|
169
|
-
readModelNames->Array.concat([SpecificReadModel.Spec.name]),
|
|
170
|
-
)
|
|
171
|
-
| None => Dict.set(readModelNamesForSourceName, sourceName, [SpecificReadModel.Spec.name])
|
|
172
|
-
}
|
|
173
|
-
)
|
|
174
|
-
publishToReadModels->Dict.set(
|
|
175
|
-
SpecificReadModel.Spec.name,
|
|
176
|
-
rmOperations->Pulumi.Output.apply(({enqueueEvent}) => enqueueEvent),
|
|
177
|
-
)
|
|
178
161
|
|
|
179
162
|
// Deferred to `finishReadModels`, which runs it from an apply — wrap it here
|
|
180
163
|
// so the read model's runtime is attributed to the plugin building it.
|