@rikalabs/akter 0.1.0-alpha.0 → 0.1.0-alpha.3
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 +46 -3
- package/README.md +2 -2
- package/dist/actor/definition.d.ts +13 -9
- package/dist/actor/descriptor.d.ts +2 -2
- package/dist/actor/descriptor.js +4 -4
- package/dist/client/calls.js +1 -1
- package/dist/client/index.d.ts +1 -1
- package/dist/client/index.js +1 -1
- package/dist/errors/actor.d.ts +12 -42
- package/dist/errors/actor.js +13 -42
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/members/payload.d.ts +1 -1
- package/dist/protocol/inspection.d.ts +221 -1
- package/dist/protocol/inspection.js +151 -2
- package/dist/protocol/wire.d.ts +6 -49
- package/dist/protocol/wire.js +1 -10
- package/dist/runtime/actors.d.ts +3 -0
- package/dist/runtime/adoption/backfill.js +1 -1
- package/dist/runtime/adoption/enforce.js +2 -2
- package/dist/runtime/adoption/observe.js +1 -1
- package/dist/runtime/adoption/plan.d.ts +1 -1
- package/dist/runtime/adoption/startup.js +1 -1
- package/dist/runtime/adoption/status.d.ts +1 -1
- package/dist/runtime/app.d.ts +65 -0
- package/dist/runtime/app.js +38 -0
- package/dist/runtime/connections/holder.d.ts +11 -1
- package/dist/runtime/connections/holder.js +8 -4
- package/dist/runtime/connections/streams.d.ts +4 -4
- package/dist/runtime/content/store.js +15 -11
- package/dist/runtime/database/bounded.d.ts +4 -18
- package/dist/runtime/database/bounded.js +36 -22
- package/dist/runtime/database/coordination.d.ts +12 -3
- package/dist/runtime/database/coordination.js +29 -36
- package/dist/runtime/database/migrations.d.ts +61 -29
- package/dist/runtime/database/migrations.js +375 -139
- package/dist/runtime/database/replica.d.ts +4 -1
- package/dist/runtime/database/replica.js +4 -1
- package/dist/runtime/database/schema.d.ts +13 -0
- package/dist/runtime/database/schema.js +13 -0
- package/dist/runtime/database/shards.d.ts +31 -13
- package/dist/runtime/database/shards.js +38 -26
- package/dist/runtime/entity/register.d.ts +8 -1
- package/dist/runtime/entity/register.js +58 -7
- package/dist/runtime/fleet/checks.js +4 -4
- package/dist/runtime/fleet/maintainer.d.ts +1 -1
- package/dist/runtime/fleet/maintainer.js +1 -1
- package/dist/runtime/index.d.ts +2 -0
- package/dist/runtime/index.js +1 -0
- package/dist/runtime/inspector/layer.d.ts +20 -0
- package/dist/runtime/inspector/layer.js +224 -5
- package/dist/runtime/inspector/queries.d.ts +54 -8
- package/dist/runtime/inspector/queries.js +84 -15
- package/dist/runtime/layer.d.ts +48 -39
- package/dist/runtime/layer.js +124 -56
- package/dist/runtime/operators/audit.d.ts +3 -0
- package/dist/runtime/operators/audit.js +6 -2
- package/dist/runtime/operators/repair.js +30 -10
- package/dist/runtime/operators/seed.js +4 -2
- package/dist/runtime/payloads/versions.d.ts +4 -4
- package/dist/runtime/payloads/versions.js +24 -15
- package/dist/runtime/queries.js +4 -2
- package/dist/runtime/registration.d.ts +5 -2
- package/dist/runtime/registration.js +3 -3
- package/dist/runtime/runner.d.ts +12 -0
- package/dist/runtime/runner.js +12 -0
- package/dist/runtime/storage/codec.d.ts +19 -7
- package/dist/runtime/storage/codec.js +23 -7
- package/dist/runtime/storage/placements.d.ts +6 -1
- package/dist/runtime/storage/placements.js +98 -6
- package/dist/runtime/storage/retention.d.ts +6 -0
- package/dist/runtime/storage/retention.js +25 -13
- package/dist/runtime/subscriptions/relay.js +47 -44
- package/dist/runtime/subscriptions/storage.d.ts +3 -2
- package/dist/runtime/subscriptions/storage.js +9 -6
- package/dist/runtime/telemetry/live.d.ts +255 -0
- package/dist/runtime/telemetry/live.js +540 -0
- package/dist/runtime/telemetry/metrics.d.ts +2 -0
- package/dist/runtime/telemetry/metrics.js +4 -1
- package/dist/runtime/telemetry/sampler.js +33 -13
- package/dist/runtime/telemetry/spans.d.ts +1 -1
- package/dist/runtime/telemetry/spans.js +1 -1
- package/dist/runtime/topology/locks.d.ts +6 -3
- package/dist/runtime/topology/locks.js +27 -4
- package/dist/runtime/turn/execute.d.ts +2 -0
- package/dist/runtime/turn/execute.js +5 -2
- package/dist/runtime/turn/pipeline.d.ts +5 -12
- package/dist/runtime/turn/pipeline.js +11 -11
- package/dist/runtime/turn/relay.d.ts +13 -3
- package/dist/runtime/turn/relay.js +27 -14
- package/dist/runtime/turn/rows.js +4 -4
- package/dist/runtime/workflows/compatibility.d.ts +1 -1
- package/dist/runtime/workflows/compatibility.js +85 -31
- package/dist/runtime/workflows/engine.js +20 -17
- package/dist/serve/layer.js +3 -2
- package/dist/tables/owned.d.ts +1 -1
- package/dist/tables/owned.js +1 -1
- package/dist/testing/actor-test.d.ts +2 -24
- package/dist/testing/actor-test.js +1 -27
- package/dist/testing/index.d.ts +0 -12
- package/dist/testing/index.js +0 -6
- package/package.json +1 -1
- package/dist/runtime/database/neki/migrations.d.ts +0 -31
- package/dist/runtime/database/neki/migrations.js +0 -276
- package/dist/runtime/database/neki/session.d.ts +0 -23
- package/dist/runtime/database/neki/session.js +0 -31
- package/dist/testing/cluster.d.ts +0 -93
- package/dist/testing/cluster.js +0 -296
- package/dist/testing/conformance/access.d.ts +0 -5
- package/dist/testing/conformance/access.js +0 -531
- package/dist/testing/conformance/admission.d.ts +0 -11
- package/dist/testing/conformance/admission.js +0 -182
- package/dist/testing/conformance/adoption.d.ts +0 -2
- package/dist/testing/conformance/adoption.js +0 -1019
- package/dist/testing/conformance/assertions.d.ts +0 -202
- package/dist/testing/conformance/assertions.js +0 -849
- package/dist/testing/conformance/batches.d.ts +0 -41
- package/dist/testing/conformance/batches.js +0 -388
- package/dist/testing/conformance/blobs.d.ts +0 -14
- package/dist/testing/conformance/blobs.js +0 -405
- package/dist/testing/conformance/capacity.d.ts +0 -8
- package/dist/testing/conformance/capacity.js +0 -433
- package/dist/testing/conformance/client.d.ts +0 -5
- package/dist/testing/conformance/client.js +0 -719
- package/dist/testing/conformance/cold-serve.d.ts +0 -16
- package/dist/testing/conformance/cold-serve.js +0 -254
- package/dist/testing/conformance/connections/actors.d.ts +0 -1143
- package/dist/testing/conformance/connections/actors.js +0 -180
- package/dist/testing/conformance/connections/harness.d.ts +0 -1754
- package/dist/testing/conformance/connections/harness.js +0 -142
- package/dist/testing/conformance/connections/holders.d.ts +0 -4
- package/dist/testing/conformance/connections/holders.js +0 -165
- package/dist/testing/conformance/connections/lifecycle.d.ts +0 -4
- package/dist/testing/conformance/connections/lifecycle.js +0 -113
- package/dist/testing/conformance/connections/limits.d.ts +0 -4
- package/dist/testing/conformance/connections/limits.js +0 -127
- package/dist/testing/conformance/connections/reauthorization.d.ts +0 -4
- package/dist/testing/conformance/connections/reauthorization.js +0 -170
- package/dist/testing/conformance/connections/resync.d.ts +0 -4
- package/dist/testing/conformance/connections/resync.js +0 -360
- package/dist/testing/conformance/connections/takeover.d.ts +0 -4
- package/dist/testing/conformance/connections/takeover.js +0 -287
- package/dist/testing/conformance/connections.d.ts +0 -4
- package/dist/testing/conformance/connections.js +0 -15
- package/dist/testing/conformance/content-blobs.d.ts +0 -16
- package/dist/testing/conformance/content-blobs.js +0 -534
- package/dist/testing/conformance/counter.d.ts +0 -16
- package/dist/testing/conformance/counter.js +0 -813
- package/dist/testing/conformance/cron.d.ts +0 -5
- package/dist/testing/conformance/cron.js +0 -665
- package/dist/testing/conformance/drain.d.ts +0 -26
- package/dist/testing/conformance/drain.js +0 -540
- package/dist/testing/conformance/effect-control.d.ts +0 -38
- package/dist/testing/conformance/effect-control.js +0 -1059
- package/dist/testing/conformance/effects.d.ts +0 -23
- package/dist/testing/conformance/effects.js +0 -432
- package/dist/testing/conformance/events.d.ts +0 -28
- package/dist/testing/conformance/events.js +0 -335
- package/dist/testing/conformance/export.d.ts +0 -2
- package/dist/testing/conformance/export.js +0 -368
- package/dist/testing/conformance/fleet.d.ts +0 -444
- package/dist/testing/conformance/fleet.js +0 -1009
- package/dist/testing/conformance/groups.d.ts +0 -7
- package/dist/testing/conformance/groups.js +0 -353
- package/dist/testing/conformance/heap.d.ts +0 -3
- package/dist/testing/conformance/heap.js +0 -149
- package/dist/testing/conformance/http.d.ts +0 -2809
- package/dist/testing/conformance/http.js +0 -1234
- package/dist/testing/conformance/inspection-views.d.ts +0 -8
- package/dist/testing/conformance/inspection-views.js +0 -272
- package/dist/testing/conformance/inspector.d.ts +0 -7
- package/dist/testing/conformance/inspector.js +0 -650
- package/dist/testing/conformance/mint.d.ts +0 -58
- package/dist/testing/conformance/mint.js +0 -692
- package/dist/testing/conformance/multi-runner.d.ts +0 -8
- package/dist/testing/conformance/multi-runner.js +0 -403
- package/dist/testing/conformance/neki/plan.d.ts +0 -19
- package/dist/testing/conformance/neki/plan.js +0 -30
- package/dist/testing/conformance/observability.d.ts +0 -3
- package/dist/testing/conformance/observability.js +0 -343
- package/dist/testing/conformance/offline.d.ts +0 -4
- package/dist/testing/conformance/offline.js +0 -474
- package/dist/testing/conformance/operator-harness.d.ts +0 -57
- package/dist/testing/conformance/operator-harness.js +0 -78
- package/dist/testing/conformance/operator.d.ts +0 -3
- package/dist/testing/conformance/operator.js +0 -379
- package/dist/testing/conformance/outbox-cross-shard.d.ts +0 -14
- package/dist/testing/conformance/outbox-cross-shard.js +0 -160
- package/dist/testing/conformance/outbox.d.ts +0 -36
- package/dist/testing/conformance/outbox.js +0 -437
- package/dist/testing/conformance/payload-migrations.d.ts +0 -3
- package/dist/testing/conformance/payload-migrations.js +0 -612
- package/dist/testing/conformance/pipeline.d.ts +0 -3
- package/dist/testing/conformance/pipeline.js +0 -1040
- package/dist/testing/conformance/placement.d.ts +0 -22
- package/dist/testing/conformance/placement.js +0 -539
- package/dist/testing/conformance/platform.d.ts +0 -40
- package/dist/testing/conformance/platform.js +0 -101
- package/dist/testing/conformance/progress.d.ts +0 -39
- package/dist/testing/conformance/progress.js +0 -666
- package/dist/testing/conformance/properties.d.ts +0 -6
- package/dist/testing/conformance/properties.js +0 -295
- package/dist/testing/conformance/protocols.d.ts +0 -4
- package/dist/testing/conformance/protocols.js +0 -618
- package/dist/testing/conformance/provider/advertise.d.ts +0 -21
- package/dist/testing/conformance/provider/advertise.js +0 -44
- package/dist/testing/conformance/read-your-writes.d.ts +0 -20
- package/dist/testing/conformance/read-your-writes.js +0 -192
- package/dist/testing/conformance/reducers.d.ts +0 -8
- package/dist/testing/conformance/reducers.js +0 -258
- package/dist/testing/conformance/relay.d.ts +0 -42
- package/dist/testing/conformance/relay.js +0 -1115
- package/dist/testing/conformance/restore.d.ts +0 -43
- package/dist/testing/conformance/restore.js +0 -341
- package/dist/testing/conformance/retention.d.ts +0 -14
- package/dist/testing/conformance/retention.js +0 -463
- package/dist/testing/conformance/rls.d.ts +0 -24
- package/dist/testing/conformance/rls.js +0 -576
- package/dist/testing/conformance/simulation.d.ts +0 -31
- package/dist/testing/conformance/simulation.js +0 -167
- package/dist/testing/conformance/single-shard.d.ts +0 -2
- package/dist/testing/conformance/single-shard.js +0 -125
- package/dist/testing/conformance/singleton.d.ts +0 -3
- package/dist/testing/conformance/singleton.js +0 -293
- package/dist/testing/conformance/statements.d.ts +0 -60
- package/dist/testing/conformance/statements.js +0 -108
- package/dist/testing/conformance/streams.d.ts +0 -7
- package/dist/testing/conformance/streams.js +0 -280
- package/dist/testing/conformance/subscriptions/access.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/access.js +0 -98
- package/dist/testing/conformance/subscriptions/actors.d.ts +0 -4910
- package/dist/testing/conformance/subscriptions/actors.js +0 -372
- package/dist/testing/conformance/subscriptions/cluster.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/cluster.js +0 -89
- package/dist/testing/conformance/subscriptions/delivery.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/delivery.js +0 -253
- package/dist/testing/conformance/subscriptions/deploys.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/deploys.js +0 -162
- package/dist/testing/conformance/subscriptions/epochs.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/epochs.js +0 -169
- package/dist/testing/conformance/subscriptions/failures.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/failures.js +0 -108
- package/dist/testing/conformance/subscriptions/feeds.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/feeds.js +0 -218
- package/dist/testing/conformance/subscriptions/harness.d.ts +0 -124
- package/dist/testing/conformance/subscriptions/harness.js +0 -143
- package/dist/testing/conformance/subscriptions/operator.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/operator.js +0 -128
- package/dist/testing/conformance/subscriptions/retention.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/retention.js +0 -288
- package/dist/testing/conformance/subscriptions/routing.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/routing.js +0 -179
- package/dist/testing/conformance/subscriptions.d.ts +0 -4
- package/dist/testing/conformance/subscriptions.js +0 -19
- package/dist/testing/conformance/tables.d.ts +0 -125
- package/dist/testing/conformance/tables.js +0 -664
- package/dist/testing/conformance/transports/actors.d.ts +0 -1907
- package/dist/testing/conformance/transports/actors.js +0 -163
- package/dist/testing/conformance/transports/client.d.ts +0 -3
- package/dist/testing/conformance/transports/client.js +0 -237
- package/dist/testing/conformance/transports/feeds.d.ts +0 -3
- package/dist/testing/conformance/transports/feeds.js +0 -232
- package/dist/testing/conformance/transports/harness.d.ts +0 -93
- package/dist/testing/conformance/transports/harness.js +0 -84
- package/dist/testing/conformance/transports/streams.d.ts +0 -3
- package/dist/testing/conformance/transports/streams.js +0 -96
- package/dist/testing/conformance/transports/websocket.d.ts +0 -3
- package/dist/testing/conformance/transports/websocket.js +0 -384
- package/dist/testing/conformance/transports/wire.d.ts +0 -141
- package/dist/testing/conformance/transports/wire.js +0 -204
- package/dist/testing/conformance/transports.d.ts +0 -3
- package/dist/testing/conformance/transports.js +0 -11
- package/dist/testing/conformance/watch.d.ts +0 -59
- package/dist/testing/conformance/watch.js +0 -879
- package/dist/testing/conformance/workflow-engine.d.ts +0 -97
- package/dist/testing/conformance/workflow-engine.js +0 -253
- package/dist/testing/conformance/workflow-versions.d.ts +0 -3
- package/dist/testing/conformance/workflow-versions.js +0 -545
- package/dist/testing/conformance/workflows/access.d.ts +0 -4
- package/dist/testing/conformance/workflows/access.js +0 -147
- package/dist/testing/conformance/workflows/actors.d.ts +0 -2317
- package/dist/testing/conformance/workflows/actors.js +0 -305
- package/dist/testing/conformance/workflows/basics.d.ts +0 -4
- package/dist/testing/conformance/workflows/basics.js +0 -144
- package/dist/testing/conformance/workflows/engine.d.ts +0 -4
- package/dist/testing/conformance/workflows/engine.js +0 -80
- package/dist/testing/conformance/workflows/guards.d.ts +0 -4
- package/dist/testing/conformance/workflows/guards.js +0 -172
- package/dist/testing/conformance/workflows/harness.d.ts +0 -14
- package/dist/testing/conformance/workflows/harness.js +0 -44
- package/dist/testing/conformance/workflows/recovery.d.ts +0 -4
- package/dist/testing/conformance/workflows/recovery.js +0 -181
- package/dist/testing/conformance/workflows/starts.d.ts +0 -4
- package/dist/testing/conformance/workflows/starts.js +0 -57
- package/dist/testing/conformance/workflows/suspension.d.ts +0 -4
- package/dist/testing/conformance/workflows/suspension.js +0 -106
- package/dist/testing/conformance/workflows/waits.d.ts +0 -4
- package/dist/testing/conformance/workflows/waits.js +0 -284
- package/dist/testing/conformance/workflows.d.ts +0 -4
- package/dist/testing/conformance/workflows.js +0 -19
- package/dist/testing/conformance.d.ts +0 -330
- package/dist/testing/conformance.js +0 -364
- package/dist/testing/foundation.d.ts +0 -41
- package/dist/testing/foundation.js +0 -517
- package/dist/testing/simulate-cluster.d.ts +0 -112
- package/dist/testing/simulate-cluster.js +0 -257
- package/dist/testing/simulate.d.ts +0 -90
- package/dist/testing/simulate.js +0 -127
|
@@ -1,343 +0,0 @@
|
|
|
1
|
-
import { Cause, Crypto, Effect, Exit, Layer, Match, Metric, Option, Predicate, Schedule, Schema, Tracer, } from "effect";
|
|
2
|
-
import { PrometheusMetrics } from "effect/observability";
|
|
3
|
-
import { SqlClient } from "effect/sql";
|
|
4
|
-
import { Actor, Actors } from "../../index.js";
|
|
5
|
-
import { DefectLog } from "../../runtime/telemetry/defects.js";
|
|
6
|
-
import { Metrics } from "../../runtime/telemetry/metrics.js";
|
|
7
|
-
import { TelemetrySampler } from "../../runtime/telemetry/sampler.js";
|
|
8
|
-
import { SpanNames } from "../../runtime/telemetry/spans.js";
|
|
9
|
-
import { ActorTest } from "../actor-test.js";
|
|
10
|
-
const Ticked = Actor.event("ObsTicked", { n: Schema.Int });
|
|
11
|
-
const Ping = Actor.job("ObsPing", { payload: { body: Schema.String } });
|
|
12
|
-
const Orphan = Actor.job("ObsOrphan", { payload: { body: Schema.String } });
|
|
13
|
-
const Bump = Actor.command("Bump", { payload: Schema.Int, success: Schema.Int });
|
|
14
|
-
const Break = Actor.command("Break");
|
|
15
|
-
const Send = Actor.command("Send", { payload: Schema.String });
|
|
16
|
-
const Perform = Actor.command("Perform", { payload: Schema.String });
|
|
17
|
-
const Strand = Actor.command("Strand", { payload: Schema.String });
|
|
18
|
-
const Orphanage = Actor.make("ObsOrphanage", {
|
|
19
|
-
key: Schema.String,
|
|
20
|
-
jobs: { ObsOrphan: { job: Orphan, retry: { times: 0 } } },
|
|
21
|
-
api: { Strand },
|
|
22
|
-
});
|
|
23
|
-
const Receive = Actor.command("Receive", { payload: Schema.String });
|
|
24
|
-
const Author = Actor.make("ObsAuthor", {
|
|
25
|
-
key: Schema.String,
|
|
26
|
-
state: Actor.state({ n: Schema.Int.pipe(Schema.withDecodingDefault(Effect.succeed(0))) }),
|
|
27
|
-
events: [Ticked],
|
|
28
|
-
jobs: { ObsPing: { job: Ping, retry: { times: 0 } } },
|
|
29
|
-
api: { Bump, Break, Send, Perform },
|
|
30
|
-
policy: {
|
|
31
|
-
keepEvents: "1 hour",
|
|
32
|
-
holdEventsForSubscribers: "1 hour",
|
|
33
|
-
},
|
|
34
|
-
});
|
|
35
|
-
const TickDelivery = Actor.Delivery({ source: Author, events: [Ticked] });
|
|
36
|
-
const OnTick = Actor.command("OnTick", { payload: TickDelivery });
|
|
37
|
-
const Watch = Actor.subscription("ObsWatch", {
|
|
38
|
-
delivery: TickDelivery,
|
|
39
|
-
handler: OnTick,
|
|
40
|
-
route: () => "w1",
|
|
41
|
-
});
|
|
42
|
-
const Watcher = Actor.make("ObsWatcher", {
|
|
43
|
-
key: Schema.String,
|
|
44
|
-
api: {},
|
|
45
|
-
internal: { OnTick },
|
|
46
|
-
subscriptions: [Watch],
|
|
47
|
-
});
|
|
48
|
-
const Inbox = Actor.make("ObsInbox", { key: Schema.String, api: { Receive } });
|
|
49
|
-
/** Receives die while this holds, so their intent stays in the outbox. */
|
|
50
|
-
const failing = { receive: false };
|
|
51
|
-
const live = Layer.mergeAll(Author.toLayer(Effect.succeed({
|
|
52
|
-
Bump: Effect.fnUntraced(function* (by) {
|
|
53
|
-
const turn = yield* Author.Turn;
|
|
54
|
-
yield* turn.state.set({ n: turn.state.n + by });
|
|
55
|
-
yield* turn.emit(Ticked.make({ n: turn.state.n }));
|
|
56
|
-
return turn.state.n;
|
|
57
|
-
}),
|
|
58
|
-
Break: () => Effect.die(new Error("gauge snapped")),
|
|
59
|
-
Send: Effect.fnUntraced(function* (to) {
|
|
60
|
-
yield* Author.Turn;
|
|
61
|
-
yield* (yield* Inbox.intents(to)).Receive("hello");
|
|
62
|
-
}),
|
|
63
|
-
Perform: Effect.fnUntraced(function* (body) {
|
|
64
|
-
yield* (yield* Author.Turn).enqueue(Ping.make({ body }));
|
|
65
|
-
}),
|
|
66
|
-
})), Author.toJobLayer(Effect.succeed({ ObsPing: () => Effect.void })), Orphanage.toLayer(Effect.succeed({
|
|
67
|
-
Strand: Effect.fnUntraced(function* (body) {
|
|
68
|
-
yield* (yield* Orphanage.Turn).enqueue(Orphan.make({ body }));
|
|
69
|
-
}),
|
|
70
|
-
})), Watcher.toLayer(Effect.succeed({ OnTick: () => Effect.die(new Error("watcher cannot keep up")) })), Inbox.toLayer(Effect.succeed({
|
|
71
|
-
Receive: () => Effect.suspend(() => (failing.receive ? Effect.die(new Error("inbox full")) : Effect.void)),
|
|
72
|
-
})));
|
|
73
|
-
/** Every span the runtime started, read after it ended. */
|
|
74
|
-
const recordingTracer = () => {
|
|
75
|
-
const spans = [];
|
|
76
|
-
const tracer = Tracer.make({
|
|
77
|
-
span: (options) => {
|
|
78
|
-
const span = Tracer.nativeTracer.span(options);
|
|
79
|
-
spans.push(span);
|
|
80
|
-
return span;
|
|
81
|
-
},
|
|
82
|
-
});
|
|
83
|
-
return { tracer, spans };
|
|
84
|
-
};
|
|
85
|
-
/**
|
|
86
|
-
* A runtime of its own on a fresh database, with a recording tracer and a
|
|
87
|
-
* metric registry no other case writes, so every span and value is this case's.
|
|
88
|
-
*/
|
|
89
|
-
const withTelemetry = (environment, body) => environment.run(Effect.gen(function* () {
|
|
90
|
-
const crypto = yield* Crypto.Crypto;
|
|
91
|
-
const database = yield* environment.freshDatabase;
|
|
92
|
-
const recorder = recordingTracer();
|
|
93
|
-
const registry = new Map();
|
|
94
|
-
failing.receive = false;
|
|
95
|
-
const services = yield* Layer.buildWithMemoMap(live.pipe(Layer.provideMerge(ActorTest.layer({
|
|
96
|
-
database,
|
|
97
|
-
observability: { sampleEvery: "1 hour" },
|
|
98
|
-
})), Layer.provide(Layer.succeed(Crypto.Crypto, crypto)), Layer.provide(Layer.succeed(Tracer.Tracer, recorder.tracer)), Layer.provide(Layer.succeed(Metric.MetricRegistry, registry)), Layer.orDie), yield* Layer.makeMemoMap, yield* Effect.scope);
|
|
99
|
-
return yield* body({ spans: recorder.spans }).pipe(Effect.provideContext(services), Effect.provideService(Tracer.Tracer, recorder.tracer), Effect.provideService(Metric.MetricRegistry, registry));
|
|
100
|
-
}));
|
|
101
|
-
const ended = (span) => Predicate.isTagged(span.status, "Ended");
|
|
102
|
-
/** The pretty cause a span ended with, when it ended in failure. */
|
|
103
|
-
const failureOf = (span) => Match.value(span.status).pipe(Match.tag("Ended", ({ exit }) => Exit.isFailure(exit) ? Option.some(Cause.pretty(exit.cause)) : Option.none()), Match.orElse(() => Option.none()));
|
|
104
|
-
const parentId = (span) => Option.match(span.parent, { onNone: () => undefined, onSome: (parent) => parent.spanId });
|
|
105
|
-
const named = (spans, name) => spans.filter((span) => span.name === name && ended(span));
|
|
106
|
-
const withAttribute = (spans, name, key, value) => named(spans, name).filter((span) => span.attributes.get(key) === value);
|
|
107
|
-
/** Whether `ancestor` is on `span`'s parent chain among the recorded spans. */
|
|
108
|
-
const descends = (spans, span, ancestor) => {
|
|
109
|
-
const parent = parentId(span);
|
|
110
|
-
if (parent === undefined)
|
|
111
|
-
return false;
|
|
112
|
-
if (parent === ancestor.spanId)
|
|
113
|
-
return true;
|
|
114
|
-
const next = spans.find((candidate) => candidate.spanId === parent);
|
|
115
|
-
return next !== undefined && descends(spans, next, ancestor);
|
|
116
|
-
};
|
|
117
|
-
/** The value of one series: a counter's count, a gauge's value, or a histogram's count. */
|
|
118
|
-
const valueOf = (name, attributes) => Effect.map(Metric.snapshot, (snapshots) => {
|
|
119
|
-
const found = snapshots.find((snapshot) => snapshot.id === name &&
|
|
120
|
-
Object.entries(attributes).every(([key, value]) => snapshot.attributes?.[key] === value));
|
|
121
|
-
if (found === undefined)
|
|
122
|
-
return undefined;
|
|
123
|
-
const state = found.state;
|
|
124
|
-
return state.value ?? state.count;
|
|
125
|
-
});
|
|
126
|
-
const sample = Effect.gen(function* () {
|
|
127
|
-
yield* (yield* TelemetrySampler).sample;
|
|
128
|
-
});
|
|
129
|
-
const execute = (sql, statement) => sql.unsafe(statement).pipe(Effect.asVoid, Effect.orDie);
|
|
130
|
-
/** Observability cases: turn and admission spans, defect logs, and metrics correlate with the command id. */
|
|
131
|
-
export const observabilityConformance = [
|
|
132
|
-
{
|
|
133
|
-
name: "names the turn span akter.<Actor>/<Command> and correlates it with the command id (O1)",
|
|
134
|
-
run: ({ expect, environment }) => withTelemetry(environment, ({ spans }) => Effect.gen(function* () {
|
|
135
|
-
const author = yield* Author.get("a1");
|
|
136
|
-
const commandId = yield* (yield* Actors).mintCommandId;
|
|
137
|
-
expect(yield* author.Bump(2).pipe(Actor.commandId(commandId))).toBe(2);
|
|
138
|
-
yield* Effect.sync(() => withAttribute(spans, SpanNames.turn("ObsAuthor", "Bump"), "command.id", commandId)).pipe(Effect.repeat({
|
|
139
|
-
until: (finished) => finished.length === 1,
|
|
140
|
-
schedule: Schedule.spaced("10 millis"),
|
|
141
|
-
times: 200,
|
|
142
|
-
}));
|
|
143
|
-
const [turn] = withAttribute(spans, SpanNames.turn("ObsAuthor", "Bump"), "command.id", commandId);
|
|
144
|
-
expect(turn).not.toBe(undefined);
|
|
145
|
-
expect(turn.name).toBe("akter.ObsAuthor/Bump");
|
|
146
|
-
expect(turn.kind).toBe("server");
|
|
147
|
-
expect(Object.fromEntries(turn.attributes)).toMatchObject({
|
|
148
|
-
"actor.type": "ObsAuthor",
|
|
149
|
-
"actor.id": "a1",
|
|
150
|
-
"command.name": "Bump",
|
|
151
|
-
"command.id": commandId,
|
|
152
|
-
"caller.kind": "System",
|
|
153
|
-
"turn.trigger": "command",
|
|
154
|
-
"turn.outcome": "success",
|
|
155
|
-
"turn.replayed": false,
|
|
156
|
-
"actor.generation": "1",
|
|
157
|
-
});
|
|
158
|
-
expect(Option.isNone(failureOf(turn))).toBe(true);
|
|
159
|
-
const [admission] = withAttribute(spans, SpanNames.admission, "command.id", commandId);
|
|
160
|
-
expect(admission?.traceId).toBe(turn.traceId);
|
|
161
|
-
expect(descends(spans, turn, admission)).toBe(true);
|
|
162
|
-
const commits = named(spans, SpanNames.commit).filter((span) => descends(spans, span, turn));
|
|
163
|
-
expect(commits.length).toBe(1);
|
|
164
|
-
for (const span of [admission, turn, commits[0]])
|
|
165
|
-
for (const value of span.attributes.values())
|
|
166
|
-
expect(value).not.toBe("alice");
|
|
167
|
-
})),
|
|
168
|
-
},
|
|
169
|
-
{
|
|
170
|
-
name: "answers a retried command id from its receipt in a turn span marked replayed, without running the handler again",
|
|
171
|
-
run: ({ expect, environment }) => withTelemetry(environment, ({ spans }) => Effect.gen(function* () {
|
|
172
|
-
const author = yield* Author.get("a2");
|
|
173
|
-
const commandId = yield* (yield* Actors).mintCommandId;
|
|
174
|
-
yield* author.Bump(1).pipe(Actor.commandId(commandId));
|
|
175
|
-
expect(yield* author.Bump(1).pipe(Actor.commandId(commandId))).toBe(1);
|
|
176
|
-
expect(yield* author.Bump(1)).toBe(2);
|
|
177
|
-
const turns = withAttribute(spans, SpanNames.turn("ObsAuthor", "Bump"), "command.id", commandId);
|
|
178
|
-
expect(turns.map((span) => [
|
|
179
|
-
span.attributes.get("turn.replayed"),
|
|
180
|
-
span.attributes.get("turn.outcome"),
|
|
181
|
-
])).toEqual([
|
|
182
|
-
[false, "success"],
|
|
183
|
-
[true, "replay"],
|
|
184
|
-
]);
|
|
185
|
-
expect(yield* valueOf("akter.receipts.written", { actor_type: "ObsAuthor" })).toBe(2);
|
|
186
|
-
expect(yield* valueOf("akter.receipts.replayed", { actor_type: "ObsAuthor" })).toBe(1);
|
|
187
|
-
})),
|
|
188
|
-
},
|
|
189
|
-
{
|
|
190
|
-
name: "fails a defect's turn span with its cause, keeps it in the defect log, and counts it",
|
|
191
|
-
run: ({ expect, environment }) => withTelemetry(environment, ({ spans }) => Effect.gen(function* () {
|
|
192
|
-
const author = yield* Author.get("a3");
|
|
193
|
-
const commandId = yield* (yield* Actors).mintCommandId;
|
|
194
|
-
expect(Exit.isFailure(yield* author.Break().pipe(Actor.commandId(commandId), Effect.exit))).toBe(true);
|
|
195
|
-
const [turn] = withAttribute(spans, SpanNames.turn("ObsAuthor", "Break"), "command.id", commandId);
|
|
196
|
-
expect(turn.attributes.get("turn.outcome")).toBe("defect");
|
|
197
|
-
expect(Option.getOrElse(failureOf(turn), () => "")).toContain("gauge snapped");
|
|
198
|
-
const defects = yield* (yield* DefectLog).list({ actorType: "ObsAuthor" });
|
|
199
|
-
expect(defects).toMatchObject([
|
|
200
|
-
{
|
|
201
|
-
span: "akter.ObsAuthor/Break",
|
|
202
|
-
traceId: turn.traceId,
|
|
203
|
-
spanId: turn.spanId,
|
|
204
|
-
actorType: "ObsAuthor",
|
|
205
|
-
actorId: "a3",
|
|
206
|
-
command: "Break",
|
|
207
|
-
commandId,
|
|
208
|
-
trigger: "command",
|
|
209
|
-
},
|
|
210
|
-
]);
|
|
211
|
-
expect(defects[0].cause).toContain("gauge snapped");
|
|
212
|
-
expect(yield* (yield* DefectLog).list({ actorType: "ObsInbox" })).toEqual([]);
|
|
213
|
-
expect(yield* (yield* DefectLog).list({
|
|
214
|
-
actorType: "ObsAuthor",
|
|
215
|
-
sinceMs: defects[0].atMs + 1,
|
|
216
|
-
})).toEqual([]);
|
|
217
|
-
expect(yield* valueOf("akter.turns", { actor_type: "ObsAuthor", outcome: "defect" })).toBe(1);
|
|
218
|
-
})),
|
|
219
|
-
},
|
|
220
|
-
{
|
|
221
|
-
name: "names the relay's intent delivery, the receiver's turn, and the effect attempt",
|
|
222
|
-
run: ({ expect, environment }) => withTelemetry(environment, ({ spans }) => Effect.gen(function* () {
|
|
223
|
-
const test = yield* ActorTest;
|
|
224
|
-
const author = yield* Author.get("a4");
|
|
225
|
-
yield* author.Send("i1");
|
|
226
|
-
yield* author.Perform("p");
|
|
227
|
-
yield* test.advance(0);
|
|
228
|
-
const [delivery] = withAttribute(spans, SpanNames.relayIntent, "actor.id", "i1");
|
|
229
|
-
expect(delivery?.kind).toBe("producer");
|
|
230
|
-
expect(delivery.attributes.get("command.name")).toBe("Receive");
|
|
231
|
-
expect(delivery.attributes.get("relay.attempt")).toBe(1);
|
|
232
|
-
const [received] = named(spans, SpanNames.turn("ObsInbox", "Receive"));
|
|
233
|
-
expect(received.attributes.get("turn.trigger")).toBe("actor");
|
|
234
|
-
expect(received.attributes.get("caller.kind")).toBe("System");
|
|
235
|
-
expect(received.attributes.get("command.id")).toBe(delivery.attributes.get("command.id"));
|
|
236
|
-
expect(descends(spans, received, delivery)).toBe(true);
|
|
237
|
-
const [attempt] = named(spans, SpanNames.job("ObsAuthor", "ObsPing"));
|
|
238
|
-
expect(Object.fromEntries(attempt.attributes)).toMatchObject({
|
|
239
|
-
"actor.type": "ObsAuthor",
|
|
240
|
-
"actor.id": "a4",
|
|
241
|
-
"job.name": "ObsPing",
|
|
242
|
-
"job.attempt": 1,
|
|
243
|
-
});
|
|
244
|
-
expect(yield* valueOf("akter.relay.delivered", { kind: "intent" })).toBe(1);
|
|
245
|
-
expect(yield* valueOf("akter.relay.delivered", { kind: "job" })).toBe(1);
|
|
246
|
-
expect(yield* valueOf("akter.outbox.staged", { kind: "intent" })).toBe(1);
|
|
247
|
-
expect(yield* valueOf("akter.outbox.staged", { kind: "job" })).toBe(1);
|
|
248
|
-
})),
|
|
249
|
-
},
|
|
250
|
-
{
|
|
251
|
-
name: "counts turns, receipts, events, and activations, records mailbox age, and exposes them to Prometheus",
|
|
252
|
-
run: ({ expect, environment }) => withTelemetry(environment, () => Effect.gen(function* () {
|
|
253
|
-
yield* (yield* Author.get("a5")).Bump(1);
|
|
254
|
-
yield* (yield* Author.get("a5")).Bump(1);
|
|
255
|
-
yield* (yield* Author.get("a6")).Bump(1);
|
|
256
|
-
const author = { actor_type: "ObsAuthor" };
|
|
257
|
-
yield* valueOf("akter.turn.duration_ms", author).pipe(Effect.repeat({
|
|
258
|
-
until: (recorded) => recorded === 3,
|
|
259
|
-
schedule: Schedule.spaced("10 millis"),
|
|
260
|
-
times: 200,
|
|
261
|
-
}));
|
|
262
|
-
expect(yield* valueOf("akter.turns", { ...author, outcome: "success" })).toBe(3);
|
|
263
|
-
expect(yield* valueOf("akter.receipts.written", author)).toBe(3);
|
|
264
|
-
expect(yield* valueOf("akter.events.appended", author)).toBe(3);
|
|
265
|
-
expect(yield* valueOf("akter.activations", author)).toBe(2);
|
|
266
|
-
expect(yield* valueOf("akter.activations.started", author)).toBe(2);
|
|
267
|
-
expect(yield* valueOf("akter.mailbox.age_ms", author)).toBe(3);
|
|
268
|
-
expect(yield* valueOf("akter.turn.duration_ms", author)).toBe(3);
|
|
269
|
-
const text = yield* PrometheusMetrics.format();
|
|
270
|
-
expect(text).toContain("# TYPE akter_turns counter");
|
|
271
|
-
expect(text).toContain('akter_turns{actor_type="ObsAuthor",outcome="success"} 3');
|
|
272
|
-
expect(text).toContain('akter_activations{actor_type="ObsAuthor"} 2');
|
|
273
|
-
expect(text).toContain("akter_mailbox_age_ms_bucket{");
|
|
274
|
-
expect(text).not.toContain("a5");
|
|
275
|
-
expect(text).not.toContain("tenant");
|
|
276
|
-
})),
|
|
277
|
-
},
|
|
278
|
-
{
|
|
279
|
-
name: "samples outbox rows, the lag of an effect no runner executes, and intents claimed 8 times",
|
|
280
|
-
run: ({ expect, environment }) => withTelemetry(environment, () => Effect.gen(function* () {
|
|
281
|
-
const sql = yield* SqlClient.SqlClient;
|
|
282
|
-
const test = yield* ActorTest;
|
|
283
|
-
const author = yield* Author.get("a7");
|
|
284
|
-
failing.receive = true;
|
|
285
|
-
yield* author.Send("stuck");
|
|
286
|
-
yield* (yield* Orphanage.get("o1")).Strand("waits");
|
|
287
|
-
yield* test.advance(0);
|
|
288
|
-
yield* execute(sql, `UPDATE actor_outbox SET attempts = 8 WHERE kind = 'intent'`);
|
|
289
|
-
yield* execute(sql, `UPDATE actor_outbox SET due_at_ms = due_at_ms - 5000 WHERE command = 'ObsOrphan'`);
|
|
290
|
-
yield* sample;
|
|
291
|
-
expect(yield* valueOf(Metrics.outboxRows.id, { kind: "intent" })).toBe(1);
|
|
292
|
-
expect(yield* valueOf(Metrics.outboxRows.id, { kind: "job" })).toBe(1);
|
|
293
|
-
expect(yield* valueOf(Metrics.stuckRows.id, { kind: "intent" })).toBe(1);
|
|
294
|
-
expect(((yield* valueOf(Metrics.relayLag.id, { kind: "job" })) ?? -1) >= 5000).toBe(true);
|
|
295
|
-
expect(yield* valueOf(Metrics.relayLag.id, { kind: "intent" })).toBe(0);
|
|
296
|
-
expect(yield* valueOf("akter.relay.retried", { kind: "intent" })).toBe(1);
|
|
297
|
-
failing.receive = false;
|
|
298
|
-
yield* execute(sql, `UPDATE actor_outbox SET due_at_ms = 0 WHERE kind = 'intent'`);
|
|
299
|
-
yield* test.advance(0);
|
|
300
|
-
yield* sample;
|
|
301
|
-
expect(yield* valueOf(Metrics.outboxRows.id, { kind: "intent" })).toBe(0);
|
|
302
|
-
expect(yield* valueOf(Metrics.stuckRows.id, { kind: "intent" })).toBe(0);
|
|
303
|
-
})),
|
|
304
|
-
},
|
|
305
|
-
{
|
|
306
|
-
name: "samples subscription lag, stuck rows, and pinned events, and counts a gap without a recipient",
|
|
307
|
-
timeoutMs: 30_000,
|
|
308
|
-
run: ({ expect, environment }) => withTelemetry(environment, () => Effect.gen(function* () {
|
|
309
|
-
const sql = yield* SqlClient.SqlClient;
|
|
310
|
-
const test = yield* ActorTest;
|
|
311
|
-
const author = yield* Author.get("a8");
|
|
312
|
-
yield* author.Bump(1);
|
|
313
|
-
yield* author.Bump(1);
|
|
314
|
-
yield* author.Bump(1);
|
|
315
|
-
yield* test.advance(0);
|
|
316
|
-
yield* sql `SELECT attempts FROM actor_subscriptions
|
|
317
|
-
WHERE subscription = 'ObsWatch'`.pipe(Effect.repeat({ until: (rows) => (rows[0]?.attempts ?? 0) > 0 }), Effect.orDie);
|
|
318
|
-
yield* execute(sql, `UPDATE actor_subscriptions SET attempts = 8`);
|
|
319
|
-
yield* sample;
|
|
320
|
-
const watch = { subscriber_type: "ObsWatcher", subscription: "ObsWatch" };
|
|
321
|
-
expect(yield* valueOf(Metrics.subscriptionLagEvents.id, watch)).toBe(3);
|
|
322
|
-
expect(((yield* valueOf(Metrics.subscriptionLag.id, watch)) ?? -1) >= 0).toBe(true);
|
|
323
|
-
expect(yield* valueOf(Metrics.stuckRows.id, { kind: "subscription" })).toBe(1);
|
|
324
|
-
expect(yield* valueOf(Metrics.subscriptionPinned.id, { actor_type: "ObsAuthor" })).toBe(0);
|
|
325
|
-
expect(((yield* valueOf("akter.relay.retried", { kind: "subscription" })) ?? 0) >= 1).toBe(true);
|
|
326
|
-
yield* test.advance("90 minutes");
|
|
327
|
-
yield* sample;
|
|
328
|
-
expect(yield* valueOf(Metrics.subscriptionPinned.id, { actor_type: "ObsAuthor" })).toBe(3);
|
|
329
|
-
expect(yield* valueOf(Metrics.workflowPinned.id, { actor_type: "ObsAuthor" })).toBe(0);
|
|
330
|
-
yield* test.advance("1 hour");
|
|
331
|
-
yield* test.cleanup;
|
|
332
|
-
yield* execute(sql, `UPDATE actor_subscriptions SET due_at_ms = 0 WHERE subscription = 'ObsWatch'`);
|
|
333
|
-
yield* test.advance(0);
|
|
334
|
-
yield* sql `SELECT gaps::text AS gaps FROM actor_subscriptions
|
|
335
|
-
WHERE subscription = 'ObsWatch'`.pipe(Effect.repeat({ until: (rows) => rows[0]?.gaps === "1" }), Effect.orDie);
|
|
336
|
-
yield* sample;
|
|
337
|
-
expect(yield* valueOf(Metrics.undeliverableGaps.id, watch)).toBe(1);
|
|
338
|
-
expect(yield* valueOf("akter.events.pruned", { actor_type: "ObsAuthor" })).toBe(3);
|
|
339
|
-
expect(yield* valueOf(Metrics.subscriptionPinned.id, { actor_type: "ObsAuthor" })).toBe(0);
|
|
340
|
-
expect(yield* valueOf(Metrics.subscriptionLagEvents.id, watch)).toBe(0);
|
|
341
|
-
})),
|
|
342
|
-
},
|
|
343
|
-
];
|